Skip to content

Releases: tonyblu331/threejs-debug-view

v0.2.12

Choose a tag to compare

@tonyblu331 tonyblu331 released this 09 Jun 00:14
  • README and docs: headless setup first, R3F setup second
  • Removed duplicated quick-start content on README
  • Quick Start guide covers install with and without React Three Fiber

v0.2.11

Choose a tag to compare

@tonyblu331 tonyblu331 released this 08 Jun 23:51

Headless viewport renderer split

  • Extract \createDebugViewportRenderer\ with GL state-restore tests

  • equiresViewportRuntime()\ on viewport planning layer
  • Viewport renderer caches pane rects, accepts \overlayOpacity\ / \dividerStyle, dev-warns on graph mismatches
  • E2e flow specs and demo ?e2e=*\ URL presets
  • Headless docs: compositor vs scissor viewport path
  • Published ESM gzip: 26 kB

v0.2.10

Choose a tag to compare

@tonyblu331 tonyblu331 released this 08 Jun 18:13

Highlights

  • Breakdown viewport labels align to compositor bands (WebGPU screenUV + canvas-centered HUD)
  • Built-in shader cost label renamed to Shader Complexity
  • Social capture preset (?capture=social) and pnpm capture:social script
  • Configurable pane divider styling (lineWidth, edgeColor, coreColor)
  • DebugViewLayer with showLeva={false} skips Leva for headless capture

See CHANGELOG for full details.

v0.2.9

Choose a tag to compare

@tonyblu331 tonyblu331 released this 08 Jun 12:32

Added

  • Headless WebGPU runtime on the root package: createDebugPipelineRuntime, createDebugViewportRenderer, createDebugPipelineRuntimeKey, and readHeatmapCostFromCanvas.
  • DebugViewsOptions, DebugViewsControlValues, and layout/pane helpers exported from the React-free entrypoint.
  • Starlight Headless Runtime guide and unit tests for control helpers and pipeline runtime keys.

Changed

  • /r3f is now a thin adapter over the canonical core runtime.
  • useDebugViewsControls imports types from core instead of the R3F module.
  • Removed the monolithic debug-views-post.tsx implementation file. Public R3F API unchanged for DebugViewLayer consumers.

v0.1.1

Choose a tag to compare

@tonyblu331 tonyblu331 released this 03 Jun 11:16

Published to npm as threejs-debug-compose@0.1.1.

Added

  • Composable TSL debug views for Three.js WebGPU render pipelines.
  • Production-ready, zero-overhead estimated shader complexity engine (shaderCost).
  • Declarative property evaluation for shader cost, including texture resolution/type weighting, pipeline breakers, and advanced optics.
  • Bounded LRU cache and aggressive early exits for render-loop safety.
  • Starlight documentation site with live built-in views demo.
  • Viewport render graph with stable pane assignments and scissor-based presentation.
  • Optimized material view pipeline for lighting-only, reflection-only, and wireframe views.

Changed

  • Replaced fragile regex/source parsing with robust declarative property evaluation.
  • Enforced strict TypeScript boundaries.
  • Packed material data into a single RGBA target for WebGPU color attachment limits.

Fixed

  • Resolved asset paths for Vite base path compatibility.
  • Corrected TSL imports and type issues for WebGPU-first renderer.
  • Switched to procedural environment for WebGPU compatibility.