layershift 0.2.2 → 0.3.0

package/dist/types/portal-renderer-webgpu.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Portal Renderer (WebGPU) — GPU-accelerated multi-pass portal compositing.
+ *
+ * WebGPU counterpart to `portal-renderer.ts` (WebGL2). Shares the same
+ * `RendererBase` abstract base class and `PortalRendererConfig` interface.
+ *
+ * ## Pipeline (per frame, 6 draw calls)
+ *
+ * 1. **Interior pass** — POM ray-march + lens depth + DOF + fog + color grade.
+ *    MRT output: color (rgba8unorm) + depth (r8unorm) to offscreen textures.
+ *
+ * 2a. **Stencil mark** — triangulated SVG mesh into depth-stencil attachment.
+ *     Color writes disabled, stencil ref=1 written.
+ *
+ * 2b. **Composite** — emissive interior passthrough with edge occlusion ramp,
+ *     stencil-tested (only where stencil == 1).
+ *
+ * 2c. **Chamfer geometry** — Blinn-Phong lit ring with frosted-glass blur.
+ *
+ * 3. **Boundary effects** — rim lighting, refraction, chromatic fringe,
+ *    volumetric edge wall. Alpha blended onto backbuffer.
+ *
+ * ## JFA Distance Field (cached, recomputed on resize)
+ *
+ * mask render -> seed extraction -> flood iterations -> distance conversion.
+ * Uses rg16float ping-pong textures. Runs at reduced resolution (quality tier).
+ *
+ * ## Key WebGPU differences from WebGL2 version
+ *
+ * - Stencil via explicit `depth24plus-stencil8` texture attachment.
+ * - MRT via multiple color attachments in a single render pass.
+ * - Float render targets (rg16float) natively supported — no extension needed.
+ * - Pipeline state objects bake blend/stencil/depth config at creation time.
+ * - Bind groups replace individual uniform calls.
+ * - Override constants for POM loop bound.
+ * - `writeTexture` with manual Y-flip (no UNPACK_FLIP_Y_WEBGL equivalent).
+ * - `copyExternalImageToTexture` for zero-copy video frame import.
+ */
+import { RendererBase } from './renderer-base';
+import type { PortalRendererConfig } from './portal-renderer';
+import type { ShapeMesh } from './shape-generator';
+export declare class PortalRendererWebGPU extends RendererBase {
+    private device;
+    private context;
+    private canvasFormat;
+    private readonly config;
+    private quadBuffer;
+    private linearSampler;
+    private nearestSampler;
+    private interiorPipeline;
+    private interiorBindGroupLayout;
+    private stencilMarkPipeline;
+    private stencilMarkBindGroupLayout;
+    private compositePipeline;
+    private compositeBindGroupLayout;
+    private chamferPipeline;
+    private chamferBindGroupLayout;
+    private boundaryPipeline;
+    private boundaryBindGroupLayout;
+    private maskPipeline;
+    private maskBindGroupLayout;
+    private jfaSeedPipeline;
+    private jfaSeedBindGroupLayout;
+    private jfaFloodPipeline;
+    private jfaFloodBindGroupLayout;
+    private jfaDistPipeline;
+    private jfaDistBindGroupLayout;
+    private meshScaleUniformBuffer;
+    private interiorVertexUniformBuffer;
+    private interiorFragmentUniformBuffer;
+    private compositeUniformBuffer;
+    private boundaryUniformBuffer;
+    private chamferUniformBuffer;
+    private jfaSeedUniformBuffer;
+    private jfaFloodUniformBuffer;
+    private jfaDistUniformBuffer;
+    private interiorBindGroup;
+    private stencilMarkBindGroup;
+    private compositeBindGroup;
+    private chamferBindGroup;
+    private boundaryBindGroup;
+    private maskBindGroup;
+    private jfaSeedBindGroup;
+    private jfaDistBindGroup;
+    private videoTexture;
+    private videoTextureView;
+    private depthTexture;
+    private depthTextureView;
+    private interiorColorTexture;
+    private interiorColorView;
+    private interiorDepthTexture;
+    private interiorDepthView;
+    private fboWidth;
+    private fboHeight;
+    private depthStencilTexture;
+    private depthStencilView;
+    private dsWidth;
+    private dsHeight;
+    private jfaMaskTexture;
+    private jfaMaskView;
+    private jfaPingTexture;
+    private jfaPingView;
+    private jfaPongTexture;
+    private jfaPongView;
+    private jfaDistTexture;
+    private jfaDistView;
+    private jfaWidth;
+    private jfaHeight;
+    private jfaDirty;
+    private stencilVertexBuffer;
+    private stencilIndexBuffer;
+    private stencilIndexCount;
+    private boundaryVertexBuffer;
+    private boundaryVertexCount;
+    private chamferVertexBuffer;
+    private chamferVertexCount;
+    private meshAspect;
+    private meshScaleX;
+    private meshScaleY;
+    private lightDirX;
+    private lightDirY;
+    private lightDir3;
+    private depthFlipBuffer;
+    private readonly offsetData;
+    constructor(parent: HTMLElement, config: PortalRendererConfig, device: GPUDevice, adapterInfo: GPUAdapterInfo);
+    initialize(video: HTMLVideoElement, depthWidth: number, depthHeight: number, mesh: ShapeMesh): void;
+    private createInteriorPipeline;
+    private createStencilMarkPipeline;
+    private createCompositePipeline;
+    private createChamferPipeline;
+    private createBoundaryPipeline;
+    private createMaskPipeline;
+    private createJFASeedPipeline;
+    private createJFAFloodPipeline;
+    private createJFADistPipeline;
+    private uploadStencilMesh;
+    private uploadBoundaryMesh;
+    private uploadChamferMesh;
+    private writeStaticInteriorUniforms;
+    private writeStaticCompositeUniforms;
+    private writeStaticChamferUniforms;
+    private writeStaticBoundaryUniforms;
+    private rebuildInteriorBindGroup;
+    private rebuildStencilMarkBindGroup;
+    private rebuildCompositeBindGroup;
+    private rebuildChamferBindGroup;
+    private rebuildBoundaryBindGroup;
+    private rebuildMaskBindGroup;
+    private rebuildJFASeedBindGroup;
+    private rebuildJFADistBindGroup;
+    /** Rebuild all bind groups that reference textures (after resize or init). */
+    private rebuildBindGroups;
+    private createInteriorFBO;
+    private createDepthStencilTexture;
+    private createJFAResources;
+    private computeDistanceField;
+    /**
+     * Flip depth data vertically.
+     *
+     * WebGPU writeTexture has no UNPACK_FLIP_Y_WEBGL equivalent. Video frames
+     * are imported with flipY:true via copyExternalImageToTexture, so depth
+     * data must also be flipped to maintain spatial alignment.
+     */
+    private flipDepthY;
+    private fallbackTexture;
+    private createFallbackTextureView;
+    /**
+     * Main render loop -- 6 draw calls per frame.
+     *
+     * Pass 1: Interior -> MRT offscreen textures.
+     * Pass 2a: Stencil mark -> depth-stencil attachment.
+     * Pass 2b: Composite -> canvas (stencil-tested).
+     * Pass 2c: Chamfer geometry -> canvas.
+     * Pass 3: Boundary effects -> canvas (alpha blended).
+     * JFA: runs inside command encoder when dirty (cached on resize).
+     */
+    protected onRenderFrame(): void;
+    /**
+     * Upload depth data to the GPU texture.
+     * Called from the RVFC loop at video frame rate, or from RAF fallback.
+     */
+    protected onDepthUpdate(timeSec: number): void;
+    protected recalculateViewportLayout(): void;
+    /**
+     * WebGPU device loss recovery.
+     *
+     * Device loss is handled via the `device.lost` promise (set in constructor).
+     * Full recovery requires re-requesting adapter + device, which is managed
+     * at the Web Component level by re-creating the renderer.
+     */
+    protected onContextRestored(): void;
+    protected disposeRenderer(): void;
+    private disposeTextures;
+    private disposeInteriorFBO;
+    private disposeDepthStencilTexture;
+    private disposeJFAResources;
+    private disposeGeometryBuffers;
+}
+//# sourceMappingURL=portal-renderer-webgpu.d.ts.map

package/dist/types/portal-renderer-webgpu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal-renderer-webgpu.d.ts","sourceRoot":"","sources":["../../src/portal-renderer-webgpu.ts"],"names":[],"mappings":"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"}

package/dist/types/portal-renderer.d.ts

@@ -29,13 +29,22 @@
  *    refraction, chromatic fringe, occlusion — all driven by distance field
  *    and interior depth texture.
  */
-import type { ParallaxInput } from './input-handler';
 import type { ShapeMesh } from './shape-generator';
+import type { QualityTier } from './quality';
+import { RendererBase } from './renderer-base';
 export interface PortalRendererConfig {
     parallaxStrength: number;
     overscanPadding: number;
     /** POM step count for interior (default: 16). */
     pomSteps: number;
+    /**
+     * Adaptive quality tier. Controls render resolution, JFA resolution,
+     * depth resolution, and sample counts.
+     * - 'auto' — probe device capabilities and classify automatically.
+     * - 'high' / 'medium' / 'low' — use the specified tier directly.
+     * - undefined — defaults to 'auto'.
+     */
+    quality?: 'auto' | QualityTier;
     rimLightIntensity: number;
     rimLightColor: [number, number, number];
     rimLightWidth: number;
@@ -66,7 +75,7 @@ export interface PortalRendererConfig {
     chamferWidth: number;
     /** Chamfer angle in degrees (0 = face-forward, 90 = wall). Default: 45 */
     chamferAngle: number;
-    /** Chamfer base color [r, g, b] in 0–1 range. Default: [0.15, 0.15, 0.18] */
+    /** Chamfer base color [r, g, b] in 0-1 range. Default: [0.15, 0.15, 0.18] */
     chamferColor: [number, number, number];
     /** Chamfer ambient light level. Default: 0.12 */
     chamferAmbient: number;
@@ -81,29 +90,36 @@ export interface PortalRendererConfig {
     /** 3D light direction [x, y, z] for chamfer lighting (will be normalized). */
     lightDirection: [number, number, number];
 }
-export declare class PortalRenderer {
-    private static readonly RESIZE_DEBOUNCE_MS;
-    private readonly canvas;
+export declare function buildEdgeMesh(edgeVertices: Float32Array): {
+    vertices: Float32Array;
+    count: number;
+};
+/**
+ * Build geometric chamfer ring around each contour with smooth per-vertex
+ * normals and inner/outer lerp parameter for progressive blur.
+ *
+ * Normals are averaged between adjacent segments at shared vertices so the
+ * chamfer surface appears smooth rather than faceted. The `lerpT` value is
+ * 0 at the inner (silhouette) edge and 1 at the outer edge, driving blur
+ * intensity in the fragment shader.
+ *
+ * Vertex format: [x, y, nx3, ny3, nz3, lerpT] — 6 floats per vertex.
+ */
+export declare function buildChamferMesh(edgeVertices: Float32Array, contourOffsets: number[], contourIsHole: boolean[], chamferWidth: number, chamferAngle: number): {
+    vertices: Float32Array;
+    count: number;
+};
+export declare class PortalRenderer extends RendererBase {
     private gl;
-    private readonly container;
-    private stencilProgram;
-    private maskProgram;
-    private jfaSeedProgram;
-    private jfaFloodProgram;
-    private jfaDistProgram;
-    private interiorProgram;
-    private compositeProgram;
-    private boundaryProgram;
-    private chamferProgram;
-    private stencilUniforms;
-    private maskUniforms;
-    private jfaSeedUniforms;
-    private jfaFloodUniforms;
-    private jfaDistUniforms;
-    private interiorUniforms;
-    private compositeUniforms;
-    private boundaryUniforms;
-    private chamferUniforms;
+    private stencilPass;
+    private maskPass;
+    private jfaSeedPass;
+    private jfaFloodPass;
+    private jfaDistPass;
+    private interiorPass;
+    private compositePass;
+    private boundaryPass;
+    private chamferPass;
     private quadVao;
     private stencilVao;
     private stencilIndexCount;
@@ -112,42 +128,19 @@ export declare class PortalRenderer {
     private boundaryVertexCount;
     private chamferVao;
     private chamferVertexCount;
-    private videoTexture;
-    private depthTexture;
+    private readonly textures;
+    private readonly videoSlot;
+    private readonly depthSlot;
     private interiorFbo;
     private interiorColorTex;
     private interiorDepthTex;
     private fboWidth;
     private fboHeight;
-    private maskFbo;
-    private maskTex;
-    private jfaPingFbo;
-    private jfaPingTex;
-    private jfaPongFbo;
-    private jfaPongTex;
-    private distFbo;
-    private distTex;
-    private jfaWidth;
-    private jfaHeight;
-    private distFieldDirty;
+    private jfa;
     private hasColorBufferFloat;
-    private depthWidth;
-    private depthHeight;
-    private videoAspect;
     private meshAspect;
     private meshScaleX;
     private meshScaleY;
-    private readDepth;
-    private readInput;
-    private playbackVideo;
-    private onVideoFrame;
-    private animationFrameHandle;
-    private rvfcHandle;
-    private rvfcSupported;
-    private resizeObserver;
-    private resizeTimer;
-    private uvOffset;
-    private uvScale;
     private lightDirX;
     private lightDirY;
     private lightDir3;
@@ -162,25 +155,30 @@ export declare class PortalRenderer {
     private createFBO;
     private createJFAResources;
     private computeDistanceField;
-    start(video: HTMLVideoElement, readDepth: (timeSec: number) => Uint8Array, readInput: () => ParallaxInput, onVideoFrame?: (currentTime: number, frameNumber: number) => void): void;
-    stop(): void;
-    dispose(): void;
     private initGPUResources;
-    private getUniforms;
-    private readonly videoFrameLoop;
-    private readonly renderLoop;
-    private updateDepthTexture;
-    private setupResizeHandling;
-    private readonly scheduleResizeRecalculate;
-    private recalculateViewportLayout;
-    private getViewportSize;
-    private readonly handleContextLost;
-    private readonly handleContextRestored;
+    /**
+     * Main render loop — called every animation frame at display refresh rate.
+     *
+     * Handles interior FBO rendering, stencil marking, emissive composite,
+     * chamfer geometry, and boundary effects in a multi-pass pipeline.
+     */
+    protected onRenderFrame(): void;
+    /**
+     * Upload depth data to the GPU texture.
+     * Called from the RVFC loop at video frame rate, or from RAF fallback.
+     */
+    protected onDepthUpdate(timeSec: number): void;
+    protected recalculateViewportLayout(): void;
+    /** Rebuild GPU state after context restoration. */
+    protected onContextRestored(): void;
+    /** Dispose source textures via the registry (video, depth). */
     private disposeTextures;
     private disposeFBO;
-    private disposeJFA;
     private disposeStencilGeometry;
     private disposeBoundaryGeometry;
+    /** Dispose all GPU resources — called by base class dispose(). */
+    protected disposeRenderer(): void;
+    /** Dispose all render passes and shared VAO. */
     private disposeGPUResources;
 }
 //# sourceMappingURL=portal-renderer.d.ts.map

package/dist/types/portal-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portal-renderer.d.ts","sourceRoot":"","sources":["../../src/portal-renderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"portal-renderer.d.ts","sourceRoot":"","sources":["../../src/portal-renderer.ts"],"names":[],"mappings":"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"}

package/dist/types/precomputed-depth.d.ts

@@ -15,66 +15,24 @@ export interface BinaryDownloadProgress {
     fraction: number;
 }
 /**
- * Worker-backed depth frame interpolator.
+ * Depth frame interpolator — synchronous keyframe blending.
  *
- * Offloads the bilateral filter, interpolation, and resize to a Web Worker
- * so the main thread stays free for smooth rendering. Uses double-buffering:
- * the main thread always has a ready-to-use depth frame while the worker
- * computes the next one in parallel.
+ * Interpolates between precomputed depth keyframes at ~5fps and returns
+ * raw Uint8 depth data for GPU upload. The bilateral filter runs on the
+ * GPU as a dedicated shader pass (see parallax-renderer.ts), so this
+ * class only handles temporal interpolation.
  *
- * ## Double-buffer strategy
- *
- * - `currentBuffer` — the latest completed depth frame, always available
- *   for synchronous reads via `sample()`.
- * - When the render loop calls `sample(timeSec)`, it returns `currentBuffer`
- *   immediately (zero main-thread work) and posts a request to the worker
- *   for the new time if it differs from the last requested time.
- * - When the worker responds, `currentBuffer` is swapped to the new result.
- * - During the 1-2 frames of latency, the previous depth frame is shown —
- *   this is imperceptible since depth only changes at ~5fps.
+ * Frame-change caching avoids redundant computation: depth only changes
+ * at ~5fps (keyframe transitions), but the render loop calls sample()
+ * at 60fps. Caching skips recomputation for ~12 identical frames.
  */
-export declare class WorkerDepthInterpolator {
-    private worker;
-    private currentBuffer;
-    private pendingTimeSec;
-    private workerBusy;
-    private disposed;
-    private constructor();
-    /**
-     * Create a WorkerDepthInterpolator, initializing the worker with frame data.
-     *
-     * The frame ArrayBuffers are transferred (zero-copy) to the worker.
-     * After this call, the original depthData.frames arrays are neutered
-     * and should not be accessed.
-     */
-    static create(depthData: PrecomputedDepthData, targetWidth: number, targetHeight: number): Promise<WorkerDepthInterpolator>;
-    /**
-     * Get the current depth frame — always synchronous, zero main-thread work.
-     *
-     * Returns the latest completed depth frame from the worker. If the worker
-     * hasn't finished processing the current time yet, returns the previous
-     * frame (1-2 frame latency is imperceptible at ~5fps depth changes).
-     *
-     * Automatically requests the worker to process the new time in the background.
-     */
-    sample(timeSec: number): Uint8Array;
-    /** Send a sample request to the worker if it's not busy. */
-    private requestSample;
-    /** Terminate the worker and release resources. */
-    dispose(): void;
-}
 export declare class DepthFrameInterpolator {
     private readonly depthData;
-    private readonly targetWidth;
-    private readonly targetHeight;
-    private readonly interpolatedDepth;
-    private readonly resizedDepth;
-    private readonly bilateralOutput;
     private readonly uint8Output;
     private lastFrameIndex;
     private lastNextFrameIndex;
     private lastLerpFactor;
-    constructor(depthData: PrecomputedDepthData, targetWidth: number, targetHeight: number);
+    constructor(depthData: PrecomputedDepthData);
     sample(timeSec: number): Uint8Array;
 }
 export declare function loadPrecomputedDepth(depthDataUrl: string, depthMetaUrl: string, onProgress?: (progress: BinaryDownloadProgress) => void): Promise<PrecomputedDepthData>;

package/dist/types/precomputed-depth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"precomputed-depth.d.ts","sourceRoot":"","sources":["../../src/precomputed-depth.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO;IAQP;;;;;;OAMG;WACU,MAAM,CACjB,SAAS,EAAE,oBAAoB,EAC/B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,uBAAuB,CAAC;IAqEnC;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAKnC,4DAA4D;IAC5D,OAAO,CAAC,aAAa;IAarB,kDAAkD;IAClD,OAAO,IAAI,IAAI;CAIhB;AAED,qBAAa,sBAAsB;IAe/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAhB/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAMzC,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,cAAc,CAAM;gBAGT,SAAS,EAAE,oBAAoB,EAC/B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM;IAUvC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;CA8DpC;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,GACtD,OAAO,CAAC,oBAAoB,CAAC,CAO/B"}
+{"version":3,"file":"precomputed-depth.d.ts","sourceRoot":"","sources":["../../src/precomputed-depth.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAsB;IAS/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAR5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAGzC,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,cAAc,CAAM;gBAGT,SAAS,EAAE,oBAAoB;IAMlD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;CA4BpC;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,GACtD,OAAO,CAAC,oBAAoB,CAAC,CAO/B"}

package/dist/types/quality.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Adaptive Quality Scaling — device capability probing and tier classification.
+ *
+ * Probes WebGL context + navigator APIs once at init time, classifies the
+ * device into a quality tier (high / medium / low), and resolves concrete
+ * parameters that both renderers and Web Components consume to adjust:
+ *
+ * - **Render resolution** — DPR cap (2.0 / 1.5 / 1.0)
+ * - **Depth resolution** — depth texture max dimension (512 / 512 / 256)
+ * - **Sample count** — POM steps (16 / 16 / 8), bilateral kernel (5×5 / 5×5 / 3×3)
+ * - **JFA resolution** — distance field divisor (2 / 2 / 4) for portal effect
+ *
+ * Override precedence (unchanged): explicit config > quality-derived > calibrated defaults.
+ *
+ * @see ADR-012 for the architectural decision and rationale.
+ */
+/** Device quality classification. */
+export type QualityTier = 'high' | 'medium' | 'low';
+/** Concrete rendering parameters resolved from a quality tier. */
+export interface QualityParams {
+    readonly tier: QualityTier;
+    /** Maximum device pixel ratio (2.0 / 1.5 / 1.0). */
+    readonly dprCap: number;
+    /** Maximum depth texture dimension — depth maps larger than this are downscaled (512 / 512 / 256). */
+    readonly depthMaxDim: number;
+    /** POM ray-march step count (16 / 16 / 8). */
+    readonly pomSteps: number;
+    /** Bilateral filter kernel radius in texels — kernel is (2r+1)×(2r+1) (2 / 2 / 1). */
+    readonly bilateralRadius: number;
+    /** JFA distance field resolution divisor (2 = half-res, 4 = quarter-res). */
+    readonly jfaDivisor: number;
+}
+/** Raw device capability probe results. */
+export interface DeviceCapabilities {
+    /** GPU renderer string from WEBGL_debug_renderer_info, or 'unknown'. */
+    readonly gpuRenderer: string;
+    /** GL_MAX_TEXTURE_SIZE. */
+    readonly maxTextureSize: number;
+    /** navigator.hardwareConcurrency (logical cores), or 0 if unavailable. */
+    readonly hardwareConcurrency: number;
+    /** navigator.deviceMemory in GB, or 0 if unavailable. */
+    readonly deviceMemory: number;
+    /** window.devicePixelRatio. */
+    readonly devicePixelRatio: number;
+    /** Total screen pixels (width × height). */
+    readonly screenPixels: number;
+    /** Whether the device appears to be mobile (touch + small screen). */
+    readonly isMobile: boolean;
+}
+/**
+ * Probe device capabilities from the WebGL context and navigator APIs.
+ *
+ * This is intentionally lightweight — it reads values that are already
+ * available (no async, no benchmarks). Called once at init time.
+ */
+export declare function probeCapabilities(gl: WebGL2RenderingContext): DeviceCapabilities;
+/**
+ * Classify device capabilities into a quality tier using a score-based heuristic.
+ *
+ * Weighted signals are summed to produce a score:
+ * - Score >= 0 → high
+ * - Score -25 to -1 → medium
+ * - Score < -25 → low
+ */
+export declare function classifyDevice(caps: DeviceCapabilities): QualityTier;
+/**
+ * Resolve quality parameters for a renderer.
+ *
+ * - If `quality` is a specific tier ('high' | 'medium' | 'low'), return
+ *   that tier's parameters directly (no probing).
+ * - If `quality` is 'auto' or undefined, probe device capabilities and
+ *   classify automatically.
+ *
+ * Called once per renderer at construction time. The returned params are
+ * stored as `private readonly qualityParams` and read during init and resize.
+ *
+ * @param gl - WebGL 2 rendering context (used for GPU probing).
+ * @param quality - Explicit tier, 'auto', or undefined (defaults to 'auto').
+ */
+export declare function resolveQuality(gl: WebGL2RenderingContext, quality?: 'auto' | QualityTier): QualityParams;
+/**
+ * Probe device capabilities from a WebGPU adapter.
+ *
+ * Extracts the same `DeviceCapabilities` shape as the WebGL2 probe,
+ * allowing the shared `classifyDevice()` scoring logic to work for both backends.
+ */
+export declare function probeCapabilitiesWebGPU(adapterInfo: GPUAdapterInfo): DeviceCapabilities;
+/**
+ * Resolve quality parameters for a WebGPU renderer.
+ *
+ * Same logic as `resolveQuality()` but accepts a `GPUAdapterInfo` instead
+ * of a WebGL context.
+ */
+export declare function resolveQualityWebGPU(adapterInfo: GPUAdapterInfo, quality?: 'auto' | QualityTier): QualityParams;
+//# sourceMappingURL=quality.d.ts.map

package/dist/types/quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality.d.ts","sourceRoot":"","sources":["../../src/quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpD,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sGAAsG;IACtG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sFAAsF;IACtF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,yDAAyD;IACzD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAkCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,sBAAsB,GAAG,kBAAkB,CA0ChF;AA2CD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,WAAW,CAmCpE;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,sBAAsB,EAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,GAC7B,aAAa,CAMf;AAMD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,cAAc,GAAG,kBAAkB,CAkCvF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,cAAc,EAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,GAC7B,aAAa,CAMf"}