layershift 0.2.2 → 0.4.0

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

@@ -0,0 +1,96 @@
+/**
+ * Browser-based monocular depth estimation using Depth Anything v2 via ONNX Runtime Web.
+ *
+ * Runs inference on the main thread:
+ * - **WebGPU EP** (preferred): GPU-accelerated, ~200ms/frame on modern hardware.
+ * - **WASM EP** (fallback): Uses onnxruntime's built-in proxy worker for off-thread execution.
+ *
+ * A double-buffer pattern bridges async inference (~5fps) with the synchronous
+ * `readDepth()` contract that the renderer expects every frame at 60fps.
+ *
+ * @see ADR-014 for the architectural decision and rationale.
+ */
+import type { TextureImageSource } from './media-source';
+/** Progress information emitted during model download. */
+export interface ModelDownloadProgress {
+    /** Bytes received so far. */
+    receivedBytes: number;
+    /** Total bytes (from Content-Length header), or null if unknown. */
+    totalBytes: number | null;
+    /** Download fraction 0–1 (0 if total is unknown). */
+    fraction: number;
+    /** Human-readable status label. */
+    label: string;
+}
+/** Callback invoked during model download with progress updates. */
+export type OnModelProgress = (progress: ModelDownloadProgress) => void;
+export declare class DepthEstimator {
+    private readonly depthWidth;
+    private readonly depthHeight;
+    private ort;
+    private session;
+    private inputName;
+    private outputName;
+    private frontBuffer;
+    private backBuffer;
+    private inferenceInFlight;
+    private readyResolve;
+    private readonly readyPromise;
+    private captureCanvas;
+    private captureCtx;
+    private disposed;
+    constructor(depthWidth: number, depthHeight: number);
+    /**
+     * Load the ONNX model and prepare the inference session.
+     *
+     * Downloads the model with progress tracking, then creates the ONNX
+     * session from the in-memory buffer. Tries WebGPU EP first
+     * (GPU-accelerated on main thread), falls back to WASM EP.
+     */
+    init(modelUrl: string, onProgress?: OnModelProgress): Promise<void>;
+    /** Wait for model loading and session creation to complete. */
+    waitUntilReady(): Promise<void>;
+    /**
+     * Submit a frame for depth estimation. Non-blocking.
+     *
+     * If a previous inference is still in-flight, the frame is silently
+     * dropped. This naturally throttles to the model's inference rate (~5fps),
+     * matching the precomputed depth cadence.
+     */
+    submitFrame(source: TextureImageSource): void;
+    /**
+     * Submit a single frame and wait for the result.
+     *
+     * Used for still images where we need depth before rendering starts.
+     */
+    submitFrameAndWait(source: TextureImageSource): Promise<Uint8Array>;
+    /** Return the latest available depth buffer. Always synchronous. */
+    getLatestDepth(): Uint8Array;
+    dispose(): void;
+    private runInference;
+    /**
+     * Convert RGBA ImageData → NCHW float32 tensor with ImageNet normalisation.
+     */
+    private preprocess;
+    /**
+     * Bilinear resize from model output dimensions → depth texture dimensions,
+     * normalise to full [0, 255] range, and write into `backBuffer`.
+     *
+     * Depth Anything v2 (like v1) outputs inverse depth (disparity-like):
+     * higher raw values = closer to camera. This matches the convention used
+     * by the precompute pipeline (`normalizeToUint8` in scripts/precompute-depth.ts),
+     * so no inversion is applied: 255 = nearest, 0 = farthest.
+     */
+    private postProcess;
+}
+/**
+ * Create and initialise a DepthEstimator.
+ *
+ * Returns a ready-to-use estimator. The front buffer starts as flat
+ * mid-gray (128) so the renderer can start immediately while the first
+ * real inference result arrives asynchronously.
+ *
+ * @param onProgress — Optional callback for download progress updates.
+ */
+export declare function createDepthEstimator(modelUrl: string, depthWidth: number, depthHeight: number, onProgress?: OnModelProgress): Promise<DepthEstimator>;
+//# sourceMappingURL=depth-estimator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"depth-estimator.d.ts","sourceRoot":"","sources":["../../src/depth-estimator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAMzD,0DAA0D;AAC1D,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAkCxE,qBAAa,cAAc;IA0BvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAzB9B,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,UAAU,CAAM;IAIxB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,UAAU,CAAa;IAG/B,OAAO,CAAC,iBAAiB,CAAS;IAGlC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;IAG7C,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,UAAU,CAAyC;IAE3D,OAAO,CAAC,QAAQ,CAAS;gBAGN,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM;IAiBtC;;;;;;OAMG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CzE,+DAA+D;IAC/D,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAM7C;;;;OAIG;IACG,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAYzE,oEAAoE;IACpE,cAAc,IAAI,UAAU;IAQ5B,OAAO,IAAI,IAAI;YAaD,YAAY;IA2C1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;CA6CpB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,eAAe,GAC3B,OAAO,CAAC,cAAc,CAAC,CAIzB"}

package/dist/types/input-handler.d.ts

@@ -1,6 +1,12 @@
-export interface ParallaxInput {
+export interface EffectInput {
     x: number;
     y: number;
+    /** Depth offset for blur curve lookup. Used by rack focus focal band input. */
+    focalBandOffset?: number;
+    /** Tilted focal plane normal vector [nx, ny, nz] (Scheimpflug simulation). */
+    tiltPlaneNormal?: [number, number, number];
+    /** Tilted focal plane distance constant (dot(normal, focalPoint)). */
+    tiltPlaneD?: number;
 }
 export declare class InputHandler {
     private readonly motionLerpFactor;
@@ -16,7 +22,7 @@ export declare class InputHandler {
     get isMotionSupported(): boolean;
     get isMotionEnabled(): boolean;
     enableMotionControls(): Promise<boolean>;
-    update(): ParallaxInput;
+    update(): EffectInput;
     dispose(): void;
     private readonly handleMouseMove;
     private readonly resetPointerTarget;

package/dist/types/input-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-handler.d.ts","sourceRoot":"","sources":["../../src/input-handler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AASD,qBAAa,YAAY;IAUX,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAT7C,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;gBAEI,gBAAgB,EAAE,MAAM;IASrD,IAAI,iBAAiB,IAAI,OAAO,CAkB/B;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAEK,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;IAsB9C,MAAM,IAAI,aAAa;IAqBvB,OAAO,IAAI,IAAI;IAaf,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;IAEF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAGjC;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAQ/B;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAO9B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAI7B;IAEF,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAOtC;CACH"}
+{"version":3,"file":"input-handler.d.ts","sourceRoot":"","sources":["../../src/input-handler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD,qBAAa,YAAY;IAUX,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAT7C,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAAK;gBAEI,gBAAgB,EAAE,MAAM;IASrD,IAAI,iBAAiB,IAAI,OAAO,CAkB/B;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAEK,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;IAsB9C,MAAM,IAAI,WAAW;IAqBrB,OAAO,IAAI,IAAI;IAaf,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;IAEF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAGjC;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAQ/B;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAO9B;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAI7B;IAEF,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAOtC;CACH"}

package/dist/types/jfa-distance-field.d.ts

@@ -0,0 +1,78 @@
+/**
+ * JFA Distance Field — Jump Flood Algorithm for screen-space distance fields.
+ *
+ * Computes a distance field from a binary mask (e.g., logo silhouette) using:
+ * 1. Edge seed extraction from the mask
+ * 2. Jump Flood iterations to propagate nearest-seed info
+ * 3. Distance conversion to a normalized scalar field
+ *
+ * Extracted from PortalRenderer to share orchestration logic between
+ * WebGL2 and WebGPU backends.
+ */
+import type { RenderPass } from './render-pass';
+/** Parameters for computing the distance field each frame. */
+export interface JFAComputeParams {
+    /** Mask shader pass (renders logo mesh to binary mask). */
+    maskPass: RenderPass;
+    /** JFA seed extraction pass. */
+    seedPass: RenderPass;
+    /** JFA flood iteration pass. */
+    floodPass: RenderPass;
+    /** JFA distance conversion pass. */
+    distPass: RenderPass;
+    /** VAO for the logo mesh (used in mask rendering). */
+    maskVao: WebGLVertexArrayObject;
+    /** Fullscreen quad VAO (used for seed/flood/dist passes). */
+    quadVao: WebGLVertexArrayObject;
+    /** Mesh scale X in NDC. */
+    meshScaleX: number;
+    /** Mesh scale Y in NDC. */
+    meshScaleY: number;
+    /** Number of triangulated indices in the logo mesh. */
+    stencilIndexCount: number;
+    /** Maximum distance range for normalization (max of bevelWidth, edgeOcclusionWidth). */
+    distRange: number;
+}
+export declare class JFADistanceField {
+    private readonly gl;
+    private readonly hasColorBufferFloat;
+    private maskFbo;
+    private maskTex;
+    private pingFbo;
+    private pingTex;
+    private pongFbo;
+    private pongTex;
+    private distFbo;
+    private distTex;
+    private _width;
+    private _height;
+    private _dirty;
+    constructor(gl: WebGL2RenderingContext, hasColorBufferFloat: boolean);
+    get width(): number;
+    get height(): number;
+    get isDirty(): boolean;
+    get distanceTexture(): WebGLTexture | null;
+    get maskTexture(): WebGLTexture | null;
+    markDirty(): void;
+    /**
+     * Create (or recreate) all JFA FBO/texture resources at the given canvas
+     * dimensions, divided by the quality tier's JFA divisor.
+     */
+    createResources(canvasWidth: number, canvasHeight: number, jfaDivisor: number): void;
+    /**
+     * Compute the distance field from the logo mask.
+     *
+     * Pipeline: mask render → seed extraction → JFA flood → distance conversion.
+     * After completion, `distanceTexture` holds the result and `isDirty` is false.
+     *
+     * The caller is responsible for restoring the viewport after this call.
+     */
+    compute(params: JFAComputeParams): void;
+    /**
+     * Compute the sequence of JFA step sizes for the given resolution.
+     * Steps halve from ceil(maxDim/2) down to 1.
+     */
+    static computeFloodIterations(width: number, height: number): number[];
+    dispose(): void;
+}
+//# sourceMappingURL=jfa-distance-field.d.ts.map

package/dist/types/jfa-distance-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jfa-distance-field.d.ts","sourceRoot":"","sources":["../../src/jfa-distance-field.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAMhD,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,EAAE,UAAU,CAAC;IACrB,gCAAgC;IAChC,QAAQ,EAAE,UAAU,CAAC;IACrB,gCAAgC;IAChC,SAAS,EAAE,UAAU,CAAC;IACtB,oCAAoC;IACpC,QAAQ,EAAE,UAAU,CAAC;IACrB,sDAAsD;IACtD,OAAO,EAAE,sBAAsB,CAAC;IAChC,6DAA6D;IAC7D,OAAO,EAAE,sBAAsB,CAAC;IAChC,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAG9C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,OAAO,CAA6B;IAG5C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAQ;gBAEV,EAAE,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,OAAO;IAOpE,IAAI,KAAK,IAAI,MAAM,CAAwB;IAC3C,IAAI,MAAM,IAAI,MAAM,CAAyB;IAC7C,IAAI,OAAO,IAAI,OAAO,CAAwB;IAC9C,IAAI,eAAe,IAAI,YAAY,GAAG,IAAI,CAAyB;IACnE,IAAI,WAAW,IAAI,YAAY,GAAG,IAAI,CAAyB;IAE/D,SAAS,IAAI,IAAI;IAMjB;;;OAGG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IA6CpF;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAoGvC;;;OAGG;IACH,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAetE,OAAO,IAAI,IAAI;CAchB"}

package/dist/types/media-source.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Unified media source abstraction.
+ *
+ * Provides a common interface over HTMLVideoElement, HTMLImageElement,
+ * and MediaStream-backed video (camera) so that renderers and Web
+ * Components can consume any visual source without branching.
+ */
+export type MediaSourceType = 'video' | 'image' | 'camera';
+/**
+ * Texture-uploadable image source — the subset of CanvasImageSource that
+ * is accepted by both WebGL texImage2D and WebGPU copyExternalImageToTexture.
+ * Excludes SVGImageElement which neither API supports.
+ */
+export type TextureImageSource = HTMLCanvasElement | HTMLImageElement | HTMLVideoElement | ImageBitmap | OffscreenCanvas | VideoFrame;
+export interface MediaSource {
+    readonly type: MediaSourceType;
+    readonly width: number;
+    readonly height: number;
+    readonly currentTime: number;
+    /** Duration in seconds. Infinity for camera, 0 for images, finite for video. */
+    readonly duration: number;
+    /** Whether playback is currently paused. Always false for images. */
+    readonly paused: boolean;
+    /** True for video and camera (continuous frame stream). */
+    readonly isLive: boolean;
+    /** Return the underlying element suitable for texImage2D / copyExternalImageToTexture. */
+    getImageSource(): TextureImageSource | null;
+    requestVideoFrameCallback?(cb: (now: number, metadata: VideoFrameCallbackMetadata) => void): number;
+    cancelVideoFrameCallback?(handle: number): void;
+    play?(): Promise<void>;
+    pause?(): void;
+    addEventListener?(type: string, listener: EventListener): void;
+    removeEventListener?(type: string, listener: EventListener): void;
+    dispose(): void;
+}
+export interface VideoSourceOptions {
+    parent?: Node;
+    loop?: boolean;
+    muted?: boolean;
+    autoplay?: boolean;
+}
+/**
+ * Create a MediaSource backed by an HTMLVideoElement.
+ *
+ * The video is appended to `parent` (default: `document.body`) as a
+ * hidden element and metadata is loaded before the promise resolves.
+ */
+export declare function createVideoSource(url: string, options?: VideoSourceOptions): Promise<MediaSource>;
+export interface ImageSourceOptions {
+    parent?: Node;
+}
+/**
+ * Create a MediaSource backed by an HTMLImageElement.
+ *
+ * Static source — `currentTime` is always 0, `isLive` is false.
+ * RVFC is not available; renderers fall back to RAF-only.
+ */
+export declare function createImageSource(url: string, _options?: ImageSourceOptions): Promise<MediaSource>;
+export interface CameraSourceOptions {
+    parent?: Node;
+}
+/**
+ * Create a MediaSource backed by a camera stream (getUserMedia).
+ *
+ * Live source — `currentTime` ticks with the stream, `isLive` is true.
+ * RVFC is available on the underlying video element.
+ */
+export declare function createCameraSource(constraints?: MediaStreamConstraints, options?: CameraSourceOptions): Promise<MediaSource>;
+/**
+ * Convenience factory that dispatches to the correct source creator
+ * based on `sourceType`.
+ */
+export declare function createMediaSource(src: string, sourceType: MediaSourceType, options?: VideoSourceOptions & CameraSourceOptions & {
+    cameraConstraints?: MediaStreamConstraints;
+}): Promise<MediaSource>;
+//# sourceMappingURL=media-source.d.ts.map

package/dist/types/media-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-source.d.ts","sourceRoot":"","sources":["../../src/media-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,WAAW,GACX,eAAe,GACf,UAAU,CAAC;AAEf,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,0FAA0F;IAC1F,cAAc,IAAI,kBAAkB,GAAG,IAAI,CAAC;IAE5C,yBAAyB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,KAAK,IAAI,GAAG,MAAM,CAAC;IACpG,wBAAwB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,IAAI,CAAC;IAEf,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/D,mBAAmB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAElE,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,CAyBtB;AAkDD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,QAAQ,GAAE,kBAAuB,GAChC,OAAO,CAAC,WAAW,CAAC,CAYtB;AAyBD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,IAAI,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,GAAE,sBAAwC,EACrD,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAuDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,eAAe,EAC3B,OAAO,CAAC,EAAE,kBAAkB,GAAG,mBAAmB,GAAG;IAAE,iBAAiB,CAAC,EAAE,sBAAsB,CAAA;CAAE,GAClG,OAAO,CAAC,WAAW,CAAC,CAStB"}

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

@@ -29,13 +29,23 @@
  *    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';
+import type { MediaSource } from './media-source';
 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 +76,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 +91,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,48 +129,25 @@ 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;
     private readonly config;
     constructor(parent: HTMLElement, config: PortalRendererConfig);
-    initialize(video: HTMLVideoElement, depthWidth: number, depthHeight: number, mesh: ShapeMesh): void;
+    initialize(source: MediaSource, depthWidth: number, depthHeight: number, mesh: ShapeMesh): void;
     private uploadStencilMesh;
     private uploadMaskMesh;
     private uploadBoundaryMesh;
@@ -162,25 +156,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,67 +15,30 @@ 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>;
+/**
+ * Generate a single-frame flat depth map (mid-gray 128) for sources
+ * that lack precomputed depth data, such as live camera feeds.
+ */
+export declare function createFlatDepthData(width: number, height: number): PrecomputedDepthData;
 //# sourceMappingURL=precomputed-depth.d.ts.map

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;AA8ID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAOvF"}