layershift 0.3.0 → 0.4.1

package/dist/types/components/layershift/global.d.ts

@@ -1,5 +1,5 @@
 /**
- * JSX IntrinsicElements declaration for the <layershift-parallax> custom element.
+ * JSX IntrinsicElements declaration for the <layershift-effect> custom element.
  *
  * Reference this file in your tsconfig.json to get TypeScript support
  * for the custom element in React/JSX projects:
@@ -14,7 +14,7 @@ import type { LayershiftProps } from './types';
 declare global {
   namespace JSX {
     interface IntrinsicElements {
-      'layershift-parallax': React.DetailedHTMLProps<
+      'layershift-effect': React.DetailedHTMLProps<
         React.HTMLAttributes<HTMLElement> & {
           src?: string;
           'depth-src'?: string;

package/dist/types/components/layershift/index.d.ts

@@ -2,12 +2,16 @@
  * Entry point for Layershift Web Components.
  *
  * Importing this module registers all effect elements with the browser:
- * - <layershift-parallax> — Depth-aware parallax video effect
+ * - <layershift-effect> — Depth-aware video effect
  * - <layershift-portal> — Logo-shaped video portal with depth parallax
  */
 import { LayershiftElement } from './layershift-element';
 import { LayershiftPortalElement } from './portal-element';
 export { LayershiftElement };
+/**
+ * @deprecated Use `LayershiftElement` with a filter-config.json instead.
+ * The portal element will be removed in a future major version.
+ */
 export { LayershiftPortalElement };
 export type { LayershiftProps } from './types';
 export type { LayershiftEventMap, LayershiftReadyDetail, LayershiftPlayDetail, LayershiftPauseDetail, LayershiftLoopDetail, LayershiftFrameDetail, LayershiftErrorDetail, } from './types';

package/dist/types/components/layershift/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/layershift/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAU3D,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EACV,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/layershift/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAU3D,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACrD,YAAY,EACV,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,SAAS,CAAC"}

package/dist/types/components/layershift/layershift-element.d.ts

@@ -1,29 +1,38 @@
 /**
- * <layershift-parallax> Web Component
+ * <layershift-effect> Web Component
  *
- * A self-contained Custom Element that renders a depth-aware parallax
+ * A self-contained Custom Element that renders a depth-aware
  * video effect. Encapsulates the entire WebGL pipeline inside a
  * Shadow DOM — consumers just drop in the tag and provide asset URLs.
  *
  * Usage:
- *   <layershift-parallax
+ *   <layershift-effect
  *     src="video.mp4"
  *     depth-src="depth-data.bin"
  *     depth-meta="depth-meta.json"
- *   ></layershift-parallax>
+ *   ></layershift-effect>
  */
+import type { ChannelLayer } from '../../shared/filter-config';
 import type { ManagedElement } from './lifecycle';
 export declare class LayershiftElement extends HTMLElement implements ManagedElement {
-    static readonly TAG_NAME = "layershift-parallax";
+    static readonly TAG_NAME = "layershift-effect";
     static get observedAttributes(): string[];
     readonly reinitAttributes: string[];
+    canInit(): boolean;
     private shadow;
     private container;
     private renderer;
     private inputHandler;
-    private video;
+    private source;
+    private depthEstimator;
     private loopCount;
     private readonly lifecycle;
+    /**
+     * Depth-adaptive fallback values computed once during init from the
+     * depth analysis profile. Stored so that updateConfig() can pass them
+     * to channelsToRendererConfig() without re-running depth analysis.
+     */
+    private depthFallback;
     constructor();
     private getAttrFloat;
     private getAttrBool;
@@ -32,13 +41,16 @@ export declare class LayershiftElement extends HTMLElement implements ManagedEle
     private get parallaxMax();
     private get overscan();
     private get quality();
+    /** @deprecated WebGPU backend removed — always uses WebGL2 for render parity with the editor. */
     private get gpuBackend();
+    private get sourceType();
+    private get depthModel();
     private get shouldAutoplay();
     private get shouldLoop();
     private get shouldMute();
     /**
      * Dispatch a namespaced custom event that bubbles through Shadow DOM.
-     * All events use the `layershift-parallax:` prefix and are `composed`
+     * All events use the `layershift-effect:` prefix and are `composed`
      * so consumers can listen on the host element from the light DOM.
      */
     private emit;
@@ -46,13 +58,31 @@ export declare class LayershiftElement extends HTMLElement implements ManagedEle
      * Attach native video event listeners and re-dispatch them
      * as namespaced custom events on the host element.
      */
-    private attachVideoEventListeners;
+    private attachSourceEventListeners;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
     setupShadowDOM(): void;
+    /**
+     * Fetch and parse a FilterConfig JSON file.
+     * Returns null if the attribute is absent or the fetch fails.
+     */
+    private fetchFilterConfig;
+    /**
+     * Build renderer config from HTML attributes (legacy parallax-only path).
+     */
+    private buildLegacyConfig;
     doInit(signal: AbortSignal): Promise<void>;
-    private createVideoElement;
+    /**
+     * Push new channel parameters to the renderer at runtime.
+     *
+     * This is the primary API for external controls (overlays, drawers,
+     * host-page UIs) to drive effect parameters without reinitializing
+     * the WebGL pipeline. Safe to call on every slider change.
+     *
+     * @param channels - The updated ChannelLayer[] from the controls store.
+     */
+    updateConfig(channels: ChannelLayer[]): void;
     doDispose(): void;
 }
 //# sourceMappingURL=layershift-element.d.ts.map

package/dist/types/components/layershift/layershift-element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layershift-element.d.ts","sourceRoot":"","sources":["../../../../src/components/layershift/layershift-element.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkKlD,qBAAa,iBAAkB,SAAQ,WAAY,YAAW,cAAc;IAC1E,MAAM,CAAC,QAAQ,CAAC,QAAQ,yBAAyB;IAEjD,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAOxC;IAED,QAAQ,CAAC,gBAAgB,WAAsC;IAE/D,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,QAAQ,CAA0D;IAC1E,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;;IAU7C,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;IASnB,OAAO,KAAK,SAAS,GAA0E;IAC/F,OAAO,KAAK,SAAS,GAA0E;IAC/F,OAAO,KAAK,WAAW,GAA8E;IACrG,OAAO,KAAK,QAAQ,GAAuE;IAC3F,OAAO,KAAK,OAAO,GAIlB;IACD,OAAO,KAAK,UAAU,GAIrB;IACD,OAAO,KAAK,cAAc,GAAuE;IACjG,OAAO,KAAK,UAAU,GAA+D;IACrF,OAAO,KAAK,UAAU,GAAiE;IAIvF;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAUZ;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA2BjC,iBAAiB,IAAI,IAAI;IAIzB,oBAAoB,IAAI,IAAI;IAI5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAM1F,cAAc,IAAI,IAAI;IAkChB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YA6IlC,kBAAkB;IAuChC,SAAS,IAAI,IAAI;CAmBlB"}
+{"version":3,"file":"layershift-element.d.ts","sourceRoot":"","sources":["../../../../src/components/layershift/layershift-element.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,4BAA4B,CAAC;AAc7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAsKlD,qBAAa,iBAAkB,SAAQ,WAAY,YAAW,cAAc;IAC1E,MAAM,CAAC,QAAQ,CAAC,QAAQ,uBAAuB;IAE/C,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAQxC;IAED,QAAQ,CAAC,gBAAgB,WAA8E;IAEvG,OAAO,IAAI,OAAO;IAQlB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAE7C;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAIL;;IAUhB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;IASnB,OAAO,KAAK,SAAS,GAA0E;IAC/F,OAAO,KAAK,SAAS,GAA0E;IAC/F,OAAO,KAAK,WAAW,GAA8E;IACrG,OAAO,KAAK,QAAQ,GAAuE;IAC3F,OAAO,KAAK,OAAO,GAIlB;IACD,iGAAiG;IACjG,OAAO,KAAK,UAAU,GAErB;IACD,OAAO,KAAK,UAAU,GAKrB;IACD,OAAO,KAAK,UAAU,GAA8D;IACpF,OAAO,KAAK,cAAc,GAAuE;IACjG,OAAO,KAAK,UAAU,GAA+D;IACrF,OAAO,KAAK,UAAU,GAAiE;IAIvF;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAUZ;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAyBlC,iBAAiB,IAAI,IAAI;IAIzB,oBAAoB,IAAI,IAAI;IAI5B,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAM1F,cAAc,IAAI,IAAI;IAkCtB;;;OAGG;YACW,iBAAiB;IA+B/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BnB,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA4QhD;;;;;;;;OAQG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IA0B5C,SAAS,IAAI,IAAI;CAiBlB"}

package/dist/types/components/layershift/lifecycle.d.ts

@@ -50,6 +50,12 @@ export interface ManagedElement {
      * Does NOT need to handle the abort controller — the manager owns that.
      */
     doDispose(): void;
+    /**
+     * Optional custom readiness check. When provided, replaces the default
+     * gate (all reinitAttributes must be present) with element-specific
+     * logic — e.g. camera mode doesn't require src/depth-src/depth-meta.
+     */
+    canInit?(): boolean;
 }
 /**
  * Lifecycle state managed on behalf of the element. Attached as a private

package/dist/types/components/layershift/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/components/layershift/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAEpC,2DAA2D;IAC3D,cAAc,IAAI,IAAI,CAAC;IAEvB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;OAIG;IACH,SAAS,IAAI,IAAI,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAA+B;gBAElC,OAAO,EAAE,WAAW,GAAG,cAAc;IAMjD,WAAW,IAAI,IAAI;IAKnB,cAAc,IAAI,IAAI;IAMtB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAepF,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,eAAe,IAAI,IAAI;YAOT,OAAO;IA4BrB,OAAO,CAAC,UAAU;CAKnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,sBAAsB,GAAG,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAInG"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/components/layershift/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAEpC,2DAA2D;IAC3D,cAAc,IAAI,IAAI,CAAC;IAEvB;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;OAIG;IACH,SAAS,IAAI,IAAI,CAAC;IAElB;;;;OAIG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAA+B;gBAElC,OAAO,EAAE,WAAW,GAAG,cAAc;IAMjD,WAAW,IAAI,IAAI;IAKnB,cAAc,IAAI,IAAI;IAMtB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAepF,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,eAAe,IAAI,IAAI;YAOT,OAAO;IAgCrB,OAAO,CAAC,UAAU;CAKnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,sBAAsB,GAAG,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAInG"}

package/dist/types/components/layershift/portal-element.d.ts

@@ -1,6 +1,10 @@
 /**
  * <layershift-portal> Web Component
  *
+ * @deprecated Use `<layershift-effect>` with a filter-config.json instead.
+ * The portal element will be removed in a future major version.
+ * See https://layershift.io/docs/migration for details.
+ *
  * A self-contained Custom Element that renders video through a logo-shaped
  * portal with depth-aware parallax, emissive interior compositing, geometric
  * chamfer lighting, and dimensional boundary effects. Encapsulates the
@@ -19,11 +23,13 @@ export declare class LayershiftPortalElement extends HTMLElement implements Mana
     static readonly TAG_NAME = "layershift-portal";
     static get observedAttributes(): string[];
     readonly reinitAttributes: string[];
+    canInit(): boolean;
     private shadow;
     private container;
     private renderer;
     private inputHandler;
-    private video;
+    private source;
+    private depthEstimator;
     private mesh;
     private loopCount;
     private readonly lifecycle;
@@ -32,12 +38,14 @@ export declare class LayershiftPortalElement extends HTMLElement implements Mana
     private getAttrBool;
     private getAttrColor;
     private getAttrVec3;
+    private get sourceType();
     private get parallaxX();
     private get parallaxY();
     private get parallaxMax();
     private get overscan();
     private get pomSteps();
     private get quality();
+    /** @deprecated WebGPU backend removed — always uses WebGL2 for render parity with the editor. */
     private get gpuBackend();
     private get rimIntensity();
     private get rimWidth();
@@ -74,17 +82,17 @@ export declare class LayershiftPortalElement extends HTMLElement implements Mana
     private get edgeOcclusionWidth();
     private get edgeOcclusionStrength();
     private get lightDirection3();
+    private get depthModel();
     private get shouldAutoplay();
     private get shouldLoop();
     private get shouldMute();
     private emit;
-    private attachVideoEventListeners;
+    private attachSourceEventListeners;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
     setupShadowDOM(): void;
     doInit(signal: AbortSignal): Promise<void>;
-    private createVideoElement;
     doDispose(): void;
 }
 //# sourceMappingURL=portal-element.d.ts.map

package/dist/types/components/layershift/portal-element.d.ts.map

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

package/dist/types/components/layershift/types.d.ts

@@ -25,7 +25,7 @@ export interface LayershiftReadyDetail {
     /** Depth analysis profile (present when depth data was analyzed). */
     depthProfile?: import('../../depth-analysis').DepthProfile;
     /** Parameters derived from depth analysis (present when depth data was analyzed). */
-    derivedParams?: import('../../depth-analysis').DerivedParallaxParams;
+    derivedParams?: import('../../depth-analysis').DerivedEffectParams;
 }
 /** Fired when video starts playing. */
 export interface LayershiftPlayDetail {
@@ -48,23 +48,35 @@ export interface LayershiftFrameDetail {
 export interface LayershiftErrorDetail {
     message: string;
 }
+/** Fired during depth model download with progress updates. */
+export interface LayershiftModelProgressDetail {
+    /** 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 (e.g. "Downloading depth model…"). */
+    label: string;
+}
 /**
- * Map of all custom events dispatched by `<layershift-parallax>`.
+ * Map of all custom events dispatched by `<layershift-effect>`.
  *
  * Usage with addEventListener:
  * ```ts
- * el.addEventListener('layershift-parallax:ready', (e) => {
+ * el.addEventListener('layershift-effect:ready', (e) => {
  *   console.log(e.detail.videoWidth, e.detail.duration);
  * });
  * ```
  */
 export interface LayershiftEventMap {
-    'layershift-parallax:ready': CustomEvent<LayershiftReadyDetail>;
-    'layershift-parallax:play': CustomEvent<LayershiftPlayDetail>;
-    'layershift-parallax:pause': CustomEvent<LayershiftPauseDetail>;
-    'layershift-parallax:loop': CustomEvent<LayershiftLoopDetail>;
-    'layershift-parallax:frame': CustomEvent<LayershiftFrameDetail>;
-    'layershift-parallax:error': CustomEvent<LayershiftErrorDetail>;
+    'layershift-effect:ready': CustomEvent<LayershiftReadyDetail>;
+    'layershift-effect:play': CustomEvent<LayershiftPlayDetail>;
+    'layershift-effect:pause': CustomEvent<LayershiftPauseDetail>;
+    'layershift-effect:loop': CustomEvent<LayershiftLoopDetail>;
+    'layershift-effect:frame': CustomEvent<LayershiftFrameDetail>;
+    'layershift-effect:error': CustomEvent<LayershiftErrorDetail>;
+    'layershift-effect:model-progress': CustomEvent<LayershiftModelProgressDetail>;
 }
 /** Props for the <layershift-portal> Web Component. */
 export interface LayershiftPortalProps {
@@ -199,5 +211,6 @@ export interface LayershiftPortalEventMap {
     'layershift-portal:loop': CustomEvent<LayershiftPortalLoopDetail>;
     'layershift-portal:frame': CustomEvent<LayershiftPortalFrameDetail>;
     'layershift-portal:error': CustomEvent<LayershiftPortalErrorDetail>;
+    'layershift-portal:model-progress': CustomEvent<LayershiftModelProgressDetail>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types/components/layershift/types.d.ts.map

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

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

@@ -6,7 +6,7 @@
  * 1. `analyzeDepthFrames()` — computes a statistical DepthProfile from
  *    precomputed depth frames (histogram, percentiles, bimodality).
  *
- * 2. `deriveParallaxParams()` — maps a DepthProfile to concrete parallax
+ * 2. `deriveEffectParams()` — maps a DepthProfile to concrete effect
  *    renderer parameters using continuous functions with algebraic
  *    calibration guarantees.
  *
@@ -20,7 +20,7 @@
  *
  * Both functions run once at initialization. analyzeDepthFrames samples
  * up to 5 deterministically-chosen frames (~1.3M pixels at 512×512),
- * completing in <5ms. deriveParallaxParams is O(1) arithmetic.
+ * completing in <5ms. deriveEffectParams is O(1) arithmetic.
  *
  * ## Determinism
  *
@@ -62,7 +62,7 @@ export interface DepthProfile {
  * Parallax parameters derived from depth analysis.
  * All values are clamped to safe bounds.
  */
-export interface DerivedParallaxParams {
+export interface DerivedEffectParams {
     parallaxStrength: number;
     contrastLow: number;
     contrastHigh: number;
@@ -82,7 +82,7 @@ export interface DerivedParallaxParams {
  * @param width  - Frame width in pixels (e.g. 512).
  * @param height - Frame height in pixels (e.g. 512).
  * @returns DepthProfile with all statistics. If frames is empty, returns
- *   a degenerate profile that will trigger rejection in deriveParallaxParams.
+ *   a degenerate profile that will trigger rejection in deriveEffectParams.
  */
 export declare function analyzeDepthFrames(frames: Uint8Array[], width: number, height: number): DepthProfile;
 /**
@@ -98,7 +98,11 @@ export declare function analyzeDepthFrames(frames: Uint8Array[], width: number,
  * or stdDev < 0.02), returns the exact calibrated defaults.
  *
  * @param profile - DepthProfile from analyzeDepthFrames().
- * @returns DerivedParallaxParams with all values clamped to safe bounds.
+ * @returns DerivedEffectParams with all values clamped to safe bounds.
  */
-export declare function deriveParallaxParams(profile: DepthProfile): DerivedParallaxParams;
+export declare function deriveEffectParams(profile: DepthProfile): DerivedEffectParams;
+/** @deprecated Use DerivedEffectParams instead. */
+export type DerivedParallaxParams = DerivedEffectParams;
+/** @deprecated Use deriveEffectParams instead. */
+export declare const deriveParallaxParams: typeof deriveEffectParams;
 //# sourceMappingURL=depth-analysis.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"depth-analysis.d.ts","sourceRoot":"","sources":["../../src/depth-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IAEX,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IAEZ,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IAEZ,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IAEZ,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,SAAS,EAAE,YAAY,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAyBD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAAE,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,YAAY,CAgFd;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB,CAwDjF"}
+{"version":3,"file":"depth-analysis.d.ts","sourceRoot":"","sources":["../../src/depth-analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IAEb,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IAEX,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IAEZ,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IAEf,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IAEZ,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IAEZ,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IAEvB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,kDAAkD;IAClD,SAAS,EAAE,YAAY,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAyBD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAAE,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,YAAY,CAgFd;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,mBAAmB,CAwD7E;AAoKD,mDAAmD;AACnD,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AACxD,kDAAkD;AAClD,eAAO,MAAM,oBAAoB,2BAAqB,CAAC"}

package/dist/types/{parallax-renderer.d.ts → depth-effect-renderer.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Parallax Renderer — GPU-accelerated depth-aware video parallax.
+ * Depth Effect Renderer — GPU-accelerated depth-aware video effects.
  *
  * Renders a single fullscreen quad textured with the source video
  * and a precomputed depth map using pure WebGL 2. A custom fragment
@@ -17,7 +17,7 @@
  *    Reads raw depth (UNIT 2), writes filtered depth (UNIT 1) via FBO.
  *    Runs at RVFC rate (~5fps, only when depth data changes).
  *
- * 2. **Parallax pass** — per-pixel depth-based displacement.
+ * 2. **Effect pass** — per-pixel depth-based displacement, blur, glow, color-shift.
  *    Reads video (UNIT 0) + filtered depth (UNIT 1), renders to screen.
  *    Runs at RAF rate (60-120fps).
  *
@@ -27,14 +27,17 @@
  *
  * ## Texture memory
  *
- * 3 textures total: 1 video (RGBA), 1 raw depth (R8), 1 filtered depth (R8).
+ * 7 textures total: 1 video (RGBA), 1 raw depth (R8), 1 filtered depth (R8),
+ * 4 curve LUTs (R8, 256×1 each: displacement, blur, glow, color-shift).
  * The raw depth texture is uploaded from CPU when depth changes (~5fps).
  * The filtered depth texture is rendered via FBO bilateral filter pass.
+ * The curve LUT textures are uploaded when the curve editor changes.
  */
 import type { QualityTier } from './quality';
 import { RendererBase } from './renderer-base';
+import type { MediaSource } from './media-source';
 /** Configuration subset relevant to the parallax renderer. */
-export interface ParallaxRendererConfig {
+export interface DepthEffectConfig {
     parallaxStrength: number;
     pomEnabled: boolean;
     pomSteps: number;
@@ -57,39 +60,79 @@ export interface ParallaxRendererConfig {
     verticalReduction?: number;
     dofStart?: number;
     dofStrength?: number;
+    /** Maximum blur radius in UV space, from blur channel params. */
+    blurRadius?: number;
+    /** Glow color [r, g, b] each 0-1. */
+    glowColor?: [number, number, number];
+    /** Glow spread radius in UV space. */
+    glowRadius?: number;
+    /** Glow edge softness (0-1). */
+    glowSoftness?: number;
+    /** Enable tilted focal plane blur (Scheimpflug simulation). */
+    tiltEnabled?: boolean;
+    /** Precomputed tan(fov/2) for pseudo-world reconstruction. */
+    tiltHalfTanFov?: number;
+    /** Blur ramp width in pseudo-world-space units. */
+    tiltTransitionWidth?: number;
+    /** Maximum blur intensity for tilted plane DOF (0-1). */
+    tiltPeakIntensity?: number;
 }
-export declare class ParallaxRenderer extends RendererBase {
+export declare class DepthEffectRenderer extends RendererBase {
     private gl;
     private quadVao;
     private bilateralPass;
-    private parallaxPass;
+    private effectPass;
     private readonly textures;
     private readonly videoSlot;
     private readonly filteredDepthSlot;
     private readonly rawDepthSlot;
+    private readonly displacementLutSlot;
+    private readonly blurLutSlot;
+    private readonly glowLutSlot;
+    private readonly colorShiftLutSlot;
     /** Resolved config with all optional shader params filled from defaults. */
-    private readonly config;
+    private config;
     /**
      * Create the renderer and attach its canvas to the DOM.
      *
      * @param parent - The container element that the WebGL canvas is
      *   appended to. The renderer sizes itself to fill this element.
-     * @param config - Parallax-specific settings (strength, POM, overscan).
+     * @param config - Effect settings (strength, POM, overscan, glow, color-shift).
      *   Optional shader parameters are merged with calibrated defaults.
      */
-    constructor(parent: HTMLElement, config: ParallaxRendererConfig);
+    constructor(parent: HTMLElement, config: DepthEffectConfig);
     /**
      * Set up the scene: create video texture, depth textures + FBO, and
      * set static shader uniforms.
      *
-     * Call this once after the video element and depth data are loaded.
+     * Call this once after the media source and depth data are loaded.
      *
-     * @param video - The <video> element to sample color frames from.
-     *   Must already have metadata loaded (videoWidth/videoHeight set).
+     * @param source - The media source to sample color frames from.
+     *   Must already have dimensions available (width/height set).
      * @param depthWidth - Width of the precomputed depth map (e.g. 512).
      * @param depthHeight - Height of the precomputed depth map (e.g. 512).
      */
-    initialize(video: HTMLVideoElement, depthWidth: number, depthHeight: number): void;
+    initialize(source: MediaSource, depthWidth: number, depthHeight: number): void;
+    /**
+     * Update shader parameters at runtime without re-creating the renderer.
+     *
+     * Merges the provided partial config into the resolved config and
+     * re-uploads only the affected uniforms to the GPU. Safe to call
+     * from a store subscription on every slider change — no allocations,
+     * just a handful of `gl.uniform*` calls.
+     */
+    updateConfig(partial: Partial<DepthEffectConfig>): void;
+    /**
+     * Upload new curve LUT data to the GPU.
+     * Call this whenever the curve editor changes.
+     */
+    updateCurveLUTs(displacementLUT: Uint8Array | null, blurLUT: Uint8Array | null, glowLUT?: Uint8Array | null, colorShiftLUT?: Uint8Array | null, colorShiftParams?: {
+        hueShift: number;
+        saturation: number;
+        brightness: number;
+        tintStrength: number;
+        tintColor: [number, number, number];
+    }): void;
     /**
      * Create render passes and shared fullscreen quad VAO.
      *
@@ -97,6 +140,11 @@ export declare class ParallaxRenderer extends RendererBase {
      * cache. They share a single VAO for the fullscreen quad geometry.
      */
     private initGPUResources;
+    /**
+     * Upload a 256-entry curve LUT to a texture slot.
+     * Creates the texture on first call, updates via texSubImage2D thereafter.
+     */
+    private uploadLUT;
     /**
      * Main render loop — called every animation frame at display refresh rate.
      *
@@ -130,9 +178,9 @@ export declare class ParallaxRenderer extends RendererBase {
     protected disposeRenderer(): void;
     /** Rebuild GPU state after context restoration. */
     protected onContextRestored(): void;
-    /** Dispose all textures via the registry (video, rawDepth, filteredDepth). */
+    /** Dispose all textures via the registry (video, rawDepth, filteredDepth, LUTs). */
     private disposeTextures;
     /** Dispose render passes and shared VAO. */
     private disposeGPUResources;
 }
-//# sourceMappingURL=parallax-renderer.d.ts.map
+//# sourceMappingURL=depth-effect-renderer.d.ts.map

package/dist/types/depth-effect-renderer.d.ts.map

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

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"}