Changelog

This project follows Keep a Changelog and Semantic Versioning.

View the full changelog on GitHub

[0.2.15] — 2026-06-09

Fixed

• Light overlap: one material + dirty uniform sync; no per-frame shader rebuild.
• Overlap and shader cost: cached mesh overrides; no per-frame scene traverse.

[0.2.14] — 2026-06-09

Added

• Light Overlap (lightComplexity): analytic counter for point, spot, and rect lights.
• Foliage and lights demo scenes for overlap diagnostics.

Changed

• Overlap (overdraw) restored to the additive contributor pass.
• Removed measured-overdraw experiment and internal planning artifacts from the published surface.

Fixed

• Overlap view renders in WebGPU (measured counter pass produced a blank framebuffer).

[0.2.13] — 2026-06-09

Added

• Measured Overlap (overdraw): contributor layer counts via depth prepass + blend counter; click-to-sample in R3F.
• Estimated Light Overlap (lightComplexity): analytic light counter for point/spot/rect lights.
• Optional overdrawVisual additive approx source; demo Lights tab (?scene=lights).
• Overlap & Light Diagnostics guide.

Changed

• Overlap label Measured Overlap; no scale: 2.5. Legend copy for overlap and light views.
• Published ESM gzip: 30 kB.

Fixed

• Premultiplied counter blend, readback Y-flip, renderer state restore, spotlight axis, alphaHash counter participation.

[0.2.12] — 2026-06-08

Changed

• README and docs: headless setup first, R3F setup second; removed duplicated quick-start content.
• Quick Start guide covers install and integration with and without React Three Fiber.

[0.2.11] — 2026-06-08

Added

• Headless viewport renderer for multi-pane scissor rendering.
• requiresViewportRuntime() helper to choose compositor vs viewport path.

Changed

• Split compose and viewport runtime; public API unchanged.
• Published ESM gzip: 26 kB.

[0.2.10] — 2026-06-08

Added

• Breakdown label region helpers and canvas-centered HUD positioning for DOM overlays.
• Configurable pane divider styling (lineWidth, edgeColor, coreColor).
• Repo social capture preset (?capture=social) and pnpm capture:social script.

Fixed

• Diagonal/breakdown viewport labels align with compositor bands on WebGPU screenUV.
• showLeva={false} on DebugViewLayer skips Leva for capture flows.

Changed

• Built-in Shader Complexity label and legend copy; breakdown tags center on band midpoints.

[0.2.9] — 2026-06-08

Added

• Headless WebGPU runtime: createDebugPipelineRuntime, createDebugViewportRenderer, createDebugPipelineRuntimeKey, and readHeatmapCostFromCanvas.
• DebugViewsOptions, layout/pane helpers, and Native Runtime guide.

Changed

• /r3f is a thin adapter over the canonical core runtime; public R3F API unchanged.

[0.2.8] — 2026-06-08

Added

• DebugViewLeva, mountDebugViewLeva, and DEBUG_VIEW_LEVA_THEME on threejs-debug-view/r3f.
• showLeva on DebugViewLayer (default true).
• Unit tests for the batteries-included R3F export surface.

Fixed

• DebugViewLayer mounts the Leva control panel as documented; no separate <Leva /> import on the default path.
• Leva portals to document.body so SVG UI never enters the R3F reconciler.

Changed

• Repo demo dogfoods threejs-debug-view/r3f; standalone DebugControls removed.
• Docs describe body-portal Leva, showLeva, and custom placement.
• Library build externalizes react-dom (~22 kB published gzip).

[0.2.7] — 2026-06-08

Added

• Package logo and Starlight R3F guide.

Changed

• README and docs homepage lead with batteries-included positioning.

[0.2.6] — 2026-06-08

Fixed

• Replaced broken Bundlephobia badge with a measured library gzip badge.

[0.2.5] — 2026-06-08

Added

• Click-to-sample shader cost inspector in the demo.
• showEnabledControl on DebugViewLayer.
• pack:check guard for npm tarball contents.

Changed

• Shader cost label shortened to Shader Cost.
• Separate overlap and shader-cost legend UI.
• Release workflow publishes to GitHub Packages.