layershift 0.2.1 → 0.3.0

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

@@ -12,18 +12,18 @@
  *     depth-meta="depth-meta.json"
  *   ></layershift-parallax>
  */
-export declare class LayershiftElement extends HTMLElement {
+import type { ManagedElement } from './lifecycle';
+export declare class LayershiftElement extends HTMLElement implements ManagedElement {
     static readonly TAG_NAME = "layershift-parallax";
     static get observedAttributes(): string[];
+    readonly reinitAttributes: string[];
     private shadow;
     private container;
     private renderer;
     private inputHandler;
-    private depthWorker;
     private video;
-    private initialized;
-    private abortController;
     private loopCount;
+    private readonly lifecycle;
     constructor();
     private getAttrFloat;
     private getAttrBool;
@@ -31,6 +31,8 @@ export declare class LayershiftElement extends HTMLElement {
     private get parallaxY();
     private get parallaxMax();
     private get overscan();
+    private get quality();
+    private get gpuBackend();
     private get shouldAutoplay();
     private get shouldLoop();
     private get shouldMute();
@@ -47,10 +49,10 @@ export declare class LayershiftElement extends HTMLElement {
     private attachVideoEventListeners;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(_name: string, _oldVal: string | null, _newVal: string | null): void;
-    private setupShadowDOM;
-    private init;
+    attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    setupShadowDOM(): void;
+    doInit(signal: AbortSignal): Promise<void>;
     private createVideoElement;
-    private dispose;
+    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;AAoLH,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,MAAM,CAAC,QAAQ,CAAC,QAAQ,yBAAyB;IAEjD,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAOxC;IAED,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,SAAS,CAAK;;IAStB,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,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;IAKzB,oBAAoB,IAAI,IAAI;IAI5B,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAgB7F,OAAO,CAAC,cAAc;YAkCR,IAAI;YAsJJ,kBAAkB;IAuChC,OAAO,CAAC,OAAO;CAyBhB"}
+{"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"}

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

@@ -0,0 +1,77 @@
+/**
+ * Shared lifecycle management for Layershift Web Components.
+ *
+ * Solves the fundamental tension between Custom Element lifecycle callbacks
+ * (synchronous, DOM-driven) and React 19's rendering model (asynchronous
+ * attribute setting via useEffect, Strict Mode double-invoke).
+ *
+ * ## Problems solved:
+ *
+ * 1. **Premature init**: `connectedCallback` fires before React sets attrs
+ *    via `useEffect`. The element must NOT init until all required attrs exist.
+ *
+ * 2. **Concurrent inits**: Multiple `attributeChangedCallback` calls during
+ *    a single React render cycle can each trigger `init()`. Without a guard,
+ *    multiple async inits run concurrently, each creating WebGL contexts.
+ *
+ * 3. **Stale abort controller**: React Strict Mode unmount calls `dispose()`,
+ *    nulling the abort controller. But the first init's Promise.all is still
+ *    in flight. When it resumes, it checks `this.abortController` which now
+ *    points to a NEW controller from the second init — the check passes
+ *    incorrectly. Fix: per-invocation abort tokens.
+ *
+ * 4. **WebGL context leaks**: Renderers create WebGL contexts but `dispose()`
+ *    never explicitly releases them. Orphaned contexts accumulate until the
+ *    browser forcibly evicts the oldest, causing GL_INVALID_FRAMEBUFFER errors.
+ *    Fix: explicit `WEBGL_lose_context.loseContext()` + canvas removal.
+ *
+ * 5. **Duplicate init on same-value setAttribute**: React Strict Mode
+ *    remount sets the same attribute values, triggering `attributeChangedCallback`
+ *    even though nothing changed. Fix: early return when oldVal === newVal.
+ */
+/**
+ * Interface that Layershift elements must implement to use the lifecycle
+ * manager. The lifecycle manager calls these methods at the right time.
+ */
+export interface ManagedElement {
+    /** The attributes that trigger re-initialization when changed. */
+    readonly reinitAttributes: string[];
+    /** Set up the Shadow DOM structure (style + container). */
+    setupShadowDOM(): void;
+    /**
+     * The actual initialization logic. Receives a per-invocation AbortSignal
+     * that the element MUST check after every async operation. If the signal
+     * is aborted, clean up partial state and return.
+     */
+    doInit(signal: AbortSignal): Promise<void>;
+    /**
+     * Clean up all resources: renderers, workers, video elements, etc.
+     * Called by the lifecycle manager before re-init and on disconnect.
+     * Does NOT need to handle the abort controller — the manager owns that.
+     */
+    doDispose(): void;
+}
+/**
+ * Lifecycle state managed on behalf of the element. Attached as a private
+ * field on each element instance.
+ */
+export declare class LifecycleManager {
+    private abortController;
+    private initialized;
+    private initializing;
+    private element;
+    constructor(element: HTMLElement & ManagedElement);
+    onConnected(): void;
+    onDisconnected(): void;
+    onAttributeChanged(name: string, oldVal: string | null, newVal: string | null): void;
+    get isInitialized(): boolean;
+    markInitialized(): void;
+    private tryInit;
+    private cancelInit;
+}
+/**
+ * Release a WebGL context explicitly to free GPU resources.
+ * Call this in renderer dispose() methods.
+ */
+export declare function releaseWebGLContext(gl: WebGL2RenderingContext | WebGLRenderingContext | null): void;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +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"}

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

@@ -14,19 +14,19 @@
  *     logo-src="logo.svg"
  *   ></layershift-portal>
  */
-export declare class LayershiftPortalElement extends HTMLElement {
+import type { ManagedElement } from './lifecycle';
+export declare class LayershiftPortalElement extends HTMLElement implements ManagedElement {
     static readonly TAG_NAME = "layershift-portal";
     static get observedAttributes(): string[];
+    readonly reinitAttributes: string[];
     private shadow;
     private container;
     private renderer;
     private inputHandler;
-    private depthWorker;
     private video;
     private mesh;
-    private initialized;
-    private abortController;
     private loopCount;
+    private readonly lifecycle;
     constructor();
     private getAttrFloat;
     private getAttrBool;
@@ -37,6 +37,8 @@ export declare class LayershiftPortalElement extends HTMLElement {
     private get parallaxMax();
     private get overscan();
     private get pomSteps();
+    private get quality();
+    private get gpuBackend();
     private get rimIntensity();
     private get rimWidth();
     private get rimColor();
@@ -79,10 +81,10 @@ export declare class LayershiftPortalElement extends HTMLElement {
     private attachVideoEventListeners;
     connectedCallback(): void;
     disconnectedCallback(): void;
-    attributeChangedCallback(_name: string, _oldVal: string | null, _newVal: string | null): void;
-    private setupShadowDOM;
-    private init;
+    attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    setupShadowDOM(): void;
+    doInit(signal: AbortSignal): Promise<void>;
     private createVideoElement;
-    private dispose;
+    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":"AAAA;;;;;;;;;;;;;;;GAeG;AAqNH,qBAAa,uBAAwB,SAAQ,WAAW;IACtD,MAAM,CAAC,QAAQ,CAAC,QAAQ,uBAAuB;IAE/C,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAmBxC;IAED,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,SAAS,CAAK;;IAStB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;IAUnB,OAAO,KAAK,SAAS,GAA0E;IAC/F,OAAO,KAAK,SAAS,GAA0E;IAC/F,OAAO,KAAK,WAAW,GAA8E;IACrG,OAAO,KAAK,QAAQ,GAAuE;IAC3F,OAAO,KAAK,QAAQ,GAAwE;IAE5F,OAAO,KAAK,YAAY,GAAgF;IACxG,OAAO,KAAK,QAAQ,GAAwE;IAC5F,OAAO,KAAK,QAAQ,GAA0F;IAC9G,OAAO,KAAK,kBAAkB,GAA4F;IAC1H,OAAO,KAAK,iBAAiB,GAA0F;IACvH,OAAO,KAAK,kBAAkB,GAA4F;IAE1H,OAAO,KAAK,UAAU,GAA4E;IAClG,OAAO,KAAK,UAAU,GAA4E;IAClG,OAAO,KAAK,SAAS,GAA0E;IAE/F,OAAO,KAAK,UAAU,GAA4E;IAClG,OAAO,KAAK,QAAQ,GAA0F;IAC9G,OAAO,KAAK,UAAU,GAA4E;IAClG,OAAO,KAAK,cAAc,GAAoF;IAE9G,OAAO,KAAK,WAAW,GAA8E;IACrG,OAAO,KAAK,YAAY,GAAgF;IACxG,OAAO,KAAK,iBAAiB,GAA0F;IACvH,OAAO,KAAK,QAAQ,GAAwE;IAC5F,OAAO,KAAK,WAAW,GAA8E;IAErG,OAAO,KAAK,cAAc,GAAoF;IAC9G,OAAO,KAAK,UAAU,GAA4E;IAClG,OAAO,KAAK,cAAc,GAAoF;IAC9G,OAAO,KAAK,iBAAiB,GAA0F;IACvH,OAAO,KAAK,eAAe,GAAuF;IAElH,OAAO,KAAK,aAAa,GAAkF;IAC3G,OAAO,KAAK,YAAY,GAAgF;IACxG,OAAO,KAAK,SAAS,GAA4F;IAEjH,OAAO,KAAK,YAAY,GAAgF;IACxG,OAAO,KAAK,YAAY,GAAgF;IACxG,OAAO,KAAK,YAAY,GAAkG;IAC1H,OAAO,KAAK,cAAc,GAAoF;IAC9G,OAAO,KAAK,eAAe,GAAsF;IACjH,OAAO,KAAK,gBAAgB,GAAwF;IAEpH,OAAO,KAAK,kBAAkB,GAA6F;IAC3H,OAAO,KAAK,qBAAqB,GAAmG;IACpI,OAAO,KAAK,eAAe,GAAqG;IAChI,OAAO,KAAK,cAAc,GAAuE;IACjG,OAAO,KAAK,UAAU,GAA+D;IACrF,OAAO,KAAK,UAAU,GAAiE;IAIvF,OAAO,CAAC,IAAI;IAUZ,OAAO,CAAC,yBAAyB;IAyBjC,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAI5B,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAqB7F,OAAO,CAAC,cAAc;YAkCR,IAAI;YAiKJ,kBAAkB;IAsChC,OAAO,CAAC,OAAO;CA0BhB"}
+{"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

@@ -7,6 +7,10 @@ export interface LayershiftProps {
     parallaxMax?: number;
     layers?: number;
     overscan?: number;
+    /** Adaptive quality tier ('auto' | 'high' | 'medium' | 'low'). */
+    quality?: 'auto' | 'high' | 'medium' | 'low';
+    /** GPU backend preference ('auto' | 'webgpu' | 'webgl2'). Default: 'auto'. */
+    gpuBackend?: 'auto' | 'webgpu' | 'webgl2';
     autoplay?: boolean;
     loop?: boolean;
     muted?: boolean;
@@ -74,6 +78,10 @@ export interface LayershiftPortalProps {
     overscan?: number;
     /** POM ray-march step count for interior displacement. */
     pomSteps?: number;
+    /** Adaptive quality tier ('auto' | 'high' | 'medium' | 'low'). */
+    quality?: 'auto' | 'high' | 'medium' | 'low';
+    /** GPU backend preference ('auto' | 'webgpu' | 'webgl2'). Default: 'auto'. */
+    gpuBackend?: 'auto' | 'webgpu' | 'webgl2';
     rimIntensity?: number;
     rimColor?: string;
     rimWidth?: number;

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":"AAAA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAMD,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,sBAAsB,EAAE,YAAY,CAAC;IAC3D,qFAAqF;IACrF,aAAa,CAAC,EAAE,OAAO,sBAAsB,EAAE,qBAAqB,CAAC;CACtE;AAED,uCAAuC;AACvC,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+BAA+B;AAC/B,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oFAAoF;AACpF,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,2BAA2B,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAChE,0BAA0B,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAC9D,2BAA2B,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAChE,0BAA0B,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAC9D,2BAA2B,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;IAChE,2BAA2B,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC;CACjE;AAMD,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iCAAiC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAMD,qEAAqE;AACrE,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,sCAAsC;AACtC,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,mDAAmD;AACnD,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,6CAA6C;AAC7C,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,yBAAyB,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC;IACpE,wBAAwB,EAAE,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAClE,yBAAyB,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC;IACpE,wBAAwB,EAAE,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAClE,yBAAyB,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC;IACpE,yBAAyB,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC;CACrE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/layershift/types.ts"],"names":[],"mappings":"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"}

package/dist/types/gpu-backend.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GPU Backend Detection — WebGPU / WebGL2 feature detection and selection.
+ *
+ * Provides async detection with a timeout to gracefully fall back to WebGL2
+ * when WebGPU is unavailable or adapter request hangs.
+ *
+ * Default behavior: auto-detect. WebGPU is used when available, WebGL2 fallback.
+ * The `gpu-backend` attribute on Web Components is an optional escape hatch.
+ */
+export type GPUBackendType = 'webgpu' | 'webgl2';
+export interface GPUBackendInfo {
+    readonly type: GPUBackendType;
+    /** Present only when type === 'webgpu'. */
+    readonly adapter?: GPUAdapter;
+    /** Present only when type === 'webgpu'. */
+    readonly device?: GPUDevice;
+}
+/**
+ * Synchronous check for WebGPU API availability.
+ *
+ * Returns true if `navigator.gpu` exists. Does NOT request an adapter,
+ * so this cannot confirm actual WebGPU support — use `detectGPUBackend()`
+ * for a definitive answer.
+ */
+export declare function isWebGPUAvailable(): boolean;
+/**
+ * Detect the best available GPU backend.
+ *
+ * 1. If `preference` is 'webgl2', returns WebGL2 immediately.
+ * 2. If `preference` is 'webgpu', attempts WebGPU and throws on failure.
+ * 3. If `preference` is 'auto' (default), tries WebGPU with a timeout
+ *    and falls back to WebGL2 silently on any failure.
+ *
+ * @param preference - 'webgpu' | 'webgl2' | 'auto' (default: 'auto')
+ */
+export declare function detectGPUBackend(preference?: 'webgpu' | 'webgl2' | 'auto'): Promise<GPUBackendInfo>;
+//# sourceMappingURL=gpu-backend.d.ts.map

package/dist/types/gpu-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-backend.d.ts","sourceRoot":"","sources":["../../src/gpu-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC7B;AAaD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAMD;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,GAAE,QAAQ,GAAG,QAAQ,GAAG,MAAe,GAChD,OAAO,CAAC,cAAc,CAAC,CAqCzB"}

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/parallax-renderer-webgpu.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Parallax Renderer (WebGPU) — GPU-accelerated depth-aware video parallax.
+ *
+ * WebGPU counterpart to `parallax-renderer.ts` (WebGL2). Shares the same
+ * `RendererBase` abstract base class and `ParallaxRendererConfig` interface.
+ *
+ * ## Pipeline
+ *
+ * 1. **Bilateral filter pass** — edge-preserving depth smoothing.
+ *    Reads raw depth, writes filtered depth to offscreen r8unorm texture.
+ *    Runs at RVFC rate (~5fps, only when depth data changes).
+ *
+ * 2. **Parallax pass** — per-pixel depth-based displacement.
+ *    Reads video + filtered depth, renders to canvas swap chain texture.
+ *    Runs at RAF rate (60-120fps).
+ *
+ * ## Key differences from WebGL2 version
+ *
+ * - Pipeline state objects bake all config at creation time
+ * - Bind groups replace individual uniform calls
+ * - Override constants replace #define injection
+ * - `copyExternalImageToTexture` for zero-copy video frame import
+ * - `writeTexture` for depth data upload
+ */
+import { RendererBase } from './renderer-base';
+import type { ParallaxRendererConfig } from './parallax-renderer';
+export declare class ParallaxRendererWebGPU extends RendererBase {
+    private device;
+    private context;
+    private canvasFormat;
+    private readonly config;
+    private quadBuffer;
+    private linearSampler;
+    private bilateralPipeline;
+    private bilateralBindGroupLayout;
+    private bilateralUniformBuffer;
+    private bilateralBindGroup;
+    private rawDepthTexture;
+    private rawDepthView;
+    private filteredDepthTexture;
+    private filteredDepthView;
+    private parallaxPipeline;
+    private parallaxBindGroupLayout;
+    private vertexUniformBuffer;
+    private fragmentUniformBuffer;
+    private parallaxBindGroup;
+    private videoTexture;
+    private videoTextureView;
+    private readonly offsetData;
+    private depthFlipBuffer;
+    constructor(parent: HTMLElement, config: ParallaxRendererConfig, device: GPUDevice, adapterInfo: GPUAdapterInfo);
+    /**
+     * Set up textures, write static uniforms, and build bind groups.
+     *
+     * Call this once after the video element and depth data are loaded.
+     */
+    initialize(video: HTMLVideoElement, depthWidth: number, depthHeight: number): void;
+    private createBilateralPipeline;
+    private createParallaxPipeline;
+    private rebuildBilateralBindGroup;
+    private rebuildParallaxBindGroup;
+    /** Write all static (non per-frame) fragment uniforms. */
+    private writeStaticFragmentUniforms;
+    /**
+     * Flip depth data vertically to match video orientation.
+     *
+     * WebGPU `writeTexture` has no equivalent to WebGL's `UNPACK_FLIP_Y_WEBGL`.
+     * Video frames are imported with `flipY: true` via `copyExternalImageToTexture`,
+     * so depth data must also be flipped to maintain spatial alignment.
+     */
+    private flipDepthY;
+    /**
+     * Main render loop — called every animation frame at display refresh rate.
+     *
+     * 1. Upload current video frame to GPU texture.
+     * 2. Update parallax offset from input (buttery smooth at RAF rate).
+     * 3. Render fullscreen quad with parallax shader to canvas.
+     */
+    protected onRenderFrame(): void;
+    /**
+     * Upload raw depth data and run the bilateral filter pass.
+     *
+     * Runs at RVFC rate (~5fps) when supported, or every RAF frame otherwise.
+     */
+    protected onDepthUpdate(timeSec: number): void;
+    /**
+     * Recalculate canvas size and UV transform to match current container.
+     */
+    protected recalculateViewportLayout(): void;
+    /** Release all GPU resources. */
+    protected disposeRenderer(): 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;
+    /** Destroy all textures and clear bind groups that reference them. */
+    private disposeTextures;
+}
+//# sourceMappingURL=parallax-renderer-webgpu.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallax-renderer-webgpu.d.ts","sourceRoot":"","sources":["../../src/parallax-renderer-webgpu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAgFlE,qBAAa,sBAAuB,SAAQ,YAAY;IAEtD,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,YAAY,CAAmB;IAGvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAGxC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,aAAa,CAA2B;IAGhD,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,wBAAwB,CAAmC;IACnE,OAAO,CAAC,sBAAsB,CAA0B;IACxD,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,YAAY,CAA+B;IAGnD,OAAO,CAAC,oBAAoB,CAA2B;IACvD,OAAO,CAAC,iBAAiB,CAA+B;IAGxD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,uBAAuB,CAAmC;IAClE,OAAO,CAAC,mBAAmB,CAA0B;IACrD,OAAO,CAAC,qBAAqB,CAA0B;IACvD,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,YAAY,CAA2B;IAC/C,OAAO,CAAC,gBAAgB,CAA+B;IAGvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAGlD,OAAO,CAAC,eAAe,CAA2B;gBAGhD,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,sBAAsB,EAC9B,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,cAAc;IAwD7B;;;;OAIG;IACH,UAAU,CACR,KAAK,EAAE,gBAAgB,EACvB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,IAAI;IAgEP,OAAO,CAAC,uBAAuB;IAkC/B,OAAO,CAAC,sBAAsB;IA+C9B,OAAO,CAAC,yBAAyB;IAkBjC,OAAO,CAAC,wBAAwB;IA2BhC,0DAA0D;IAC1D,OAAO,CAAC,2BAA2B;IA2BnC;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IAgBlB;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,IAAI,IAAI;IAoD/B;;;;OAIG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA2C9C;;OAEG;IACH,SAAS,CAAC,yBAAyB,IAAI,IAAI;IA8B3C,iCAAiC;IACjC,SAAS,CAAC,eAAe,IAAI,IAAI;IAiCjC;;;;;;OAMG;IACH,SAAS,CAAC,iBAAiB,IAAI,IAAI;IAQnC,sEAAsE;IACtE,OAAO,CAAC,eAAe;CAiBxB"}