# Changelog of Universal 3D, WebGL & Spatial Web Performance Auditor (`matrino/3d-spatial-performance-auditor`) Actor

- **URL**: https://apify.com/matrino/3d-spatial-performance-auditor/changelog.md
- **Full Actor documentation**: https://apify.com/matrino/3d-spatial-performance-auditor.md

## 📜 Changelog

All notable changes to the `3d-spatial-performance-auditor` Apify Actor will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

***

### \[0.0] - 2026-08-22

#### 🎉 Initial Release (MVP Core Engine)

##### Added

- **Zero-Copy CPU Binary GLB Parser (`VBotBinaryParser`):** Parses `.glb` binary headers and JSON chunk 0 directly in RAM to compute exact polygon counts, vertex counts, draw calls, and uncompressed texture VRAM footprints without initializing GPU graphics contexts.
- **Universal Hardware & Platform Evaluator:** Evaluates 3D assets against multiple performance profiles:
  - `UNIVERSAL_MOBILE_WEBGL` (Default: <100k tris, <256MB VRAM)
  - `UNIVERSAL_DESKTOP_WEBGL` (<300k tris, <512MB VRAM)
  - `HIGH_END_WEBXR` (<1M tris, <1024MB VRAM)
  - `PRESET_SHOPIFY` (<15MB, <100k tris, USDZ companion required)
  - `PRESET_AMAZON` (<200k tris, PBR material standards)
  - `PRESET_WORLD_PROTOCOL` (World Protocol v1.0 spatial specifications)
  - `CUSTOM_THRESHOLD` (User-defined triangle and VRAM caps)
- **Universal 3D Asset Discovery Engine:** Automatically discovers `<model-viewer>` web components, direct `.glb`/`.usdz` URLs, and e-commerce product media attachments.
- **Dual-Audience HTML Dashboard:** Generates an interactive, standalone HTML report saved directly to Apify Key-Value Store featuring:
  - Executive Mobile Crash Risk Meter & Conversion Loss Impact estimate.
  - 3D Artist & Developer Log with ready-to-copy `gltf-transform` CLI fix commands.
- **Competitor Benchmarking Engine:** Accepts optional `compareUrls` to generate a side-by-side performance matrix comparing store scores, polygon averages, and Draco adoption rates.
- **CI/CD Webhook Dispatcher:** Automatically POSTs JSON audit results to external webhooks (Zapier, GitHub Actions, or server endpoints) upon audit completion.
