layershift 0.1.2 → 0.2.0

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

@@ -1,11 +1,16 @@
 /**
- * Entry point for the <layershift-parallax> Web Component.
+ * Entry point for Layershift Web Components.
  *
- * Importing this module registers the custom element with the browser.
- * After registration, <layershift-parallax> can be used in any HTML document.
+ * Importing this module registers all effect elements with the browser:
+ * - <layershift-parallax> — Depth-aware parallax video effect
+ * - <layershift-portal> — Logo-shaped video portal with depth parallax
  */
 import { LayershiftElement } from './layershift-element';
+import { LayershiftPortalElement } from './portal-element';
 export { LayershiftElement };
+export { LayershiftPortalElement };
 export type { LayershiftProps } from './types';
 export type { LayershiftEventMap, LayershiftReadyDetail, LayershiftPlayDetail, LayershiftPauseDetail, LayershiftLoopDetail, LayershiftFrameDetail, LayershiftErrorDetail, } from './types';
+export type { LayershiftPortalProps } from './types';
+export type { LayershiftPortalEventMap, LayershiftPortalReadyDetail, LayershiftPortalPlayDetail, LayershiftPortalPauseDetail, LayershiftPortalLoopDetail, LayershiftPortalFrameDetail, LayershiftPortalErrorDetail, } from './types';
 //# sourceMappingURL=index.d.ts.map

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;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAMzD,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAC7B,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"}
+{"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"}

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

@@ -0,0 +1,88 @@
+/**
+ * <layershift-portal> Web Component
+ *
+ * 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
+ * multi-pass WebGL 2 stencil + FBO pipeline inside a Shadow DOM.
+ *
+ * Usage:
+ *   <layershift-portal
+ *     src="video.mp4"
+ *     depth-src="depth-data.bin"
+ *     depth-meta="depth-meta.json"
+ *     logo-src="logo.svg"
+ *   ></layershift-portal>
+ */
+export declare class LayershiftPortalElement extends HTMLElement {
+    static readonly TAG_NAME = "layershift-portal";
+    static get observedAttributes(): string[];
+    private shadow;
+    private container;
+    private renderer;
+    private inputHandler;
+    private depthWorker;
+    private video;
+    private mesh;
+    private initialized;
+    private abortController;
+    private loopCount;
+    constructor();
+    private getAttrFloat;
+    private getAttrBool;
+    private getAttrColor;
+    private getAttrVec3;
+    private get parallaxX();
+    private get parallaxY();
+    private get parallaxMax();
+    private get overscan();
+    private get pomSteps();
+    private get rimIntensity();
+    private get rimWidth();
+    private get rimColor();
+    private get refractionStrength();
+    private get chromaticStrength();
+    private get occlusionIntensity();
+    private get depthPower();
+    private get depthScale();
+    private get depthBias();
+    private get fogDensity();
+    private get fogColor();
+    private get colorShift();
+    private get brightnessBias();
+    private get contrastLow();
+    private get contrastHigh();
+    private get verticalReduction();
+    private get dofStart();
+    private get dofStrength();
+    private get bevelIntensity();
+    private get bevelWidth();
+    private get bevelDarkening();
+    private get bevelDesaturation();
+    private get bevelLightAngle();
+    private get edgeThickness();
+    private get edgeSpecular();
+    private get edgeColor();
+    private get chamferWidth();
+    private get chamferAngle();
+    private get chamferColor();
+    private get chamferAmbient();
+    private get chamferSpecular();
+    private get chamferShininess();
+    private get edgeOcclusionWidth();
+    private get edgeOcclusionStrength();
+    private get lightDirection3();
+    private get shouldAutoplay();
+    private get shouldLoop();
+    private get shouldMute();
+    private emit;
+    private attachVideoEventListeners;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(_name: string, _oldVal: string | null, _newVal: string | null): void;
+    private setupShadowDOM;
+    private init;
+    private createVideoElement;
+    private dispose;
+}
+//# sourceMappingURL=portal-element.d.ts.map

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

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

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

@@ -62,4 +62,134 @@ export interface LayershiftEventMap {
     'layershift-parallax:frame': CustomEvent<LayershiftFrameDetail>;
     'layershift-parallax:error': CustomEvent<LayershiftErrorDetail>;
 }
+/** Props for the <layershift-portal> Web Component. */
+export interface LayershiftPortalProps {
+    src: string;
+    depthSrc: string;
+    depthMeta: string;
+    logoSrc: string;
+    parallaxX?: number;
+    parallaxY?: number;
+    parallaxMax?: number;
+    overscan?: number;
+    /** POM ray-march step count for interior displacement. */
+    pomSteps?: number;
+    rimIntensity?: number;
+    rimColor?: string;
+    rimWidth?: number;
+    /** Refraction distortion strength. */
+    refractionStrength?: number;
+    /** Chromatic fringe strength. */
+    chromaticStrength?: number;
+    /** Volumetric occlusion intensity. */
+    occlusionIntensity?: number;
+    /** Lens depth power (< 1 = wide-angle). */
+    depthPower?: number;
+    /** Depth range scale factor. */
+    depthScale?: number;
+    /** Depth bias (negative = near bias). */
+    depthBias?: number;
+    /** Interior fog density. */
+    fogDensity?: number;
+    /** Interior fog color (hex string). */
+    fogColor?: string;
+    /** Color grading shift intensity. */
+    colorShift?: number;
+    /** Brightness bias adjustment. */
+    brightnessBias?: number;
+    /** Depth contrast remap low. */
+    contrastLow?: number;
+    /** Depth contrast remap high. */
+    contrastHigh?: number;
+    /** Vertical parallax reduction factor. */
+    verticalReduction?: number;
+    /** Depth-of-field start distance. */
+    dofStart?: number;
+    /** Depth-of-field blur strength. */
+    dofStrength?: number;
+    /** Bevel shading intensity. */
+    bevelIntensity?: number;
+    /** Bevel effect width in distance field space. */
+    bevelWidth?: number;
+    /** Bevel darkening at edge. */
+    bevelDarkening?: number;
+    /** Bevel desaturation at edge. */
+    bevelDesaturation?: number;
+    /** Bevel light direction in degrees. */
+    bevelLightAngle?: number;
+    /** Volumetric edge wall thickness. */
+    edgeThickness?: number;
+    /** Edge wall specular intensity. */
+    edgeSpecular?: number;
+    /** Edge wall base color (hex string). */
+    edgeColor?: string;
+    /** Chamfer width in normalized mesh coords (0 = no chamfer). */
+    chamferWidth?: number;
+    /** Chamfer angle in degrees (0 = face-forward, 90 = wall). */
+    chamferAngle?: number;
+    /** Chamfer base color (hex string). */
+    chamferColor?: string;
+    /** Chamfer ambient light level. */
+    chamferAmbient?: number;
+    /** Chamfer specular highlight intensity. */
+    chamferSpecular?: number;
+    /** Chamfer specular exponent (shininess). */
+    chamferShininess?: number;
+    /** Edge occlusion ramp width. */
+    edgeOcclusionWidth?: number;
+    /** Edge occlusion strength (0 = none, 1 = full). */
+    edgeOcclusionStrength?: number;
+    /** 3D light direction as "x,y,z" string. */
+    lightDirection?: string;
+    autoplay?: boolean;
+    loop?: boolean;
+    muted?: boolean;
+    className?: string;
+    style?: Record<string, string>;
+}
+/** Fired once after portal initialization completes successfully. */
+export interface LayershiftPortalReadyDetail {
+    videoWidth: number;
+    videoHeight: number;
+    duration: number;
+}
+/** Fired when portal video starts playing. */
+export interface LayershiftPortalPlayDetail {
+    currentTime: number;
+}
+/** Fired when portal video pauses. */
+export interface LayershiftPortalPauseDetail {
+    currentTime: number;
+}
+/** Fired when portal video loops back to start. */
+export interface LayershiftPortalLoopDetail {
+    loopCount: number;
+}
+/** Fired on each new portal video frame. */
+export interface LayershiftPortalFrameDetail {
+    currentTime: number;
+    frameNumber: number;
+}
+/** Fired on portal initialization errors. */
+export interface LayershiftPortalErrorDetail {
+    message: string;
+}
+/**
+ * Map of all custom events dispatched by `<layershift-portal>`.
+ *
+ * Usage with addEventListener:
+ * ```ts
+ * el.addEventListener('layershift-portal:ready', (e) => {
+ *   console.log(e.detail.videoWidth, e.detail.duration);
+ * });
+ * ```
+ */
+export interface LayershiftPortalEventMap {
+    'layershift-portal:ready': CustomEvent<LayershiftPortalReadyDetail>;
+    'layershift-portal:play': CustomEvent<LayershiftPortalPlayDetail>;
+    'layershift-portal:pause': CustomEvent<LayershiftPortalPauseDetail>;
+    'layershift-portal:loop': CustomEvent<LayershiftPortalLoopDetail>;
+    'layershift-portal:frame': CustomEvent<LayershiftPortalFrameDetail>;
+    'layershift-portal:error': CustomEvent<LayershiftPortalErrorDetail>;
+}
 //# 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":"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"}
+{"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"}

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

@@ -0,0 +1,185 @@
+/**
+ * Portal Renderer v4 — Emissive Interior + Geometric Chamfer
+ *
+ * Renders video through a logo-shaped portal using a multi-pass WebGL 2
+ * stencil + FBO compositing pipeline with screen-space distance field
+ * for dimensional glyph thickness.
+ *
+ * ## Render Pipeline
+ *
+ * 1. **Interior FBO**: Render depth-displaced video into off-screen framebuffer
+ *    with POM displacement, lens-transformed depth, DOF, fog, color grading.
+ *    Outputs color + depth textures via MRT.
+ *
+ * 2a. **Stencil mark**: Render triangulated SVG mesh into stencil buffer.
+ *
+ * 2b. **Emissive composite**: Draw interior FBO where stencil = 1 as an
+ *     emissive passthrough (source brightness preserved). Subtle edge
+ *     occlusion ramp at the chamfer seam driven by JFA distance field.
+ *
+ * 2c. **Chamfer geometry**: Render geometric chamfer ring around each contour
+ *     silhouette with Blinn-Phong lighting and frosted-glass video blur.
+ *     Smooth per-vertex normals, progressive blur via lerpT attribute.
+ *
+ * 3. **Distance field (JFA)**: Compute screen-space signed distance from every
+ *    interior pixel to the nearest letter edge. Runs once on resize, cached.
+ *    Uses Jump Flood Algorithm at half resolution (~10 passes).
+ *
+ * 4. **Boundary effects**: Depth-reactive volumetric edge wall, rim lighting,
+ *    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';
+export interface PortalRendererConfig {
+    parallaxStrength: number;
+    overscanPadding: number;
+    /** POM step count for interior (default: 16). */
+    pomSteps: number;
+    rimLightIntensity: number;
+    rimLightColor: [number, number, number];
+    rimLightWidth: number;
+    refractionStrength: number;
+    chromaticStrength: number;
+    occlusionIntensity: number;
+    depthPower: number;
+    depthScale: number;
+    depthBias: number;
+    fogDensity: number;
+    fogColor: [number, number, number];
+    colorShift: number;
+    brightnessBias: number;
+    contrastLow: number;
+    contrastHigh: number;
+    verticalReduction: number;
+    dofStart: number;
+    dofStrength: number;
+    bevelIntensity: number;
+    bevelWidth: number;
+    bevelDarkening: number;
+    bevelDesaturation: number;
+    bevelLightAngle: number;
+    edgeThickness: number;
+    edgeSpecular: number;
+    edgeColor: [number, number, number];
+    /** Chamfer width in normalized mesh coords (0 = no chamfer). Default: 0.008 */
+    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] */
+    chamferColor: [number, number, number];
+    /** Chamfer ambient light level. Default: 0.12 */
+    chamferAmbient: number;
+    /** Chamfer specular highlight intensity. Default: 0.3 */
+    chamferSpecular: number;
+    /** Chamfer specular exponent (shininess). Default: 24 */
+    chamferShininess: number;
+    /** Edge occlusion ramp width (UV space). Default: 0.03 */
+    edgeOcclusionWidth: number;
+    /** Edge occlusion strength (0=none, 1=full black at edge). Default: 0.2 */
+    edgeOcclusionStrength: number;
+    /** 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;
+    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 quadVao;
+    private stencilVao;
+    private stencilIndexCount;
+    private maskVao;
+    private boundaryVao;
+    private boundaryVertexCount;
+    private chamferVao;
+    private chamferVertexCount;
+    private videoTexture;
+    private depthTexture;
+    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 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;
+    private uploadStencilMesh;
+    private uploadMaskMesh;
+    private uploadBoundaryMesh;
+    private uploadChamferMesh;
+    private disposeChamferGeometry;
+    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;
+    private disposeTextures;
+    private disposeFBO;
+    private disposeJFA;
+    private disposeStencilGeometry;
+    private disposeBoundaryGeometry;
+    private disposeGPUResources;
+}
+//# sourceMappingURL=portal-renderer.d.ts.map

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

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

package/dist/types/shape-generator.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Shape Generator — SVG → GPU Mesh Pipeline
+ *
+ * Converts SVG path data into triangulated vertex buffers suitable for
+ * WebGL rendering. Used by the portal effect to transform logo SVGs
+ * into stencil-buffer geometry.
+ *
+ * Pipeline:
+ *   1. Fetch SVG file
+ *   2. Parse with DOMParser
+ *   3. Extract <path> elements (and basic shapes like <polygon>, <rect>, <circle>)
+ *   4. Parse SVG path commands (M, L, C, Q, A, Z, etc.)
+ *   5. Flatten Bezier curves to line segments (adaptive subdivision)
+ *   6. Apply SVG transforms if present
+ *   7. Normalize coordinates to [-1, 1] range (aspect-ratio preserving)
+ *   8. Triangulate polygon via earcut
+ *   9. Extract edge outline vertices for rim-light pass
+ *  10. Return ShapeMesh
+ *
+ * ## Zero dependencies
+ *
+ * Earcut triangulation is vendored inline (~120 LOC) to maintain
+ * the library's zero-runtime-dependency constraint.
+ */
+/** Triangulated mesh data ready for GPU upload. */
+export interface ShapeMesh {
+    /** Flattened vertex positions [x,y, x,y, ...] in normalized [-1,1] coords. */
+    vertices: Float32Array;
+    /** Triangle indices (from earcut) for gl.drawElements. */
+    indices: Uint16Array;
+    /** Outline vertices [x,y, x,y, ...] for rim-light edge pass (LINE_STRIP). */
+    edgeVertices: Float32Array;
+    /**
+     * Start index (in floats, not points) of each contour within edgeVertices.
+     * Each contour runs from edgeVertices[contourOffsets[i]] to
+     * edgeVertices[contourOffsets[i+1]-1] (or end of array for last contour).
+     * Each contour is closed: its last point repeats its first point.
+     */
+    contourOffsets: number[];
+    /**
+     * Whether each contour is a hole (inner cutout) vs an outer boundary.
+     * Parallel array to contourOffsets. Hole contours have opposite winding
+     * direction and their edge normals point inward.
+     */
+    contourIsHole: boolean[];
+    /** Bounding box in normalized coordinates. */
+    bounds: {
+        minX: number;
+        maxX: number;
+        minY: number;
+        maxY: number;
+    };
+    /** Original SVG width / height aspect ratio (for viewport correction). */
+    aspect: number;
+}
+/**
+ * Generate a GPU-ready mesh from an SVG file URL.
+ *
+ * Fetches the SVG, extracts all path data, flattens curves,
+ * triangulates, and returns normalized vertices + indices.
+ */
+export declare function generateMeshFromSVG(svgUrl: string): Promise<ShapeMesh>;
+/**
+ * Generate a GPU-ready mesh from an SVG string.
+ * Useful for inline SVGs or testing.
+ */
+export declare function generateMeshFromSVGString(svgText: string): ShapeMesh;
+/**
+ * Earcut polygon triangulation.
+ *
+ * Based on mapbox/earcut (ISC license).
+ * Minimal vendored implementation for polygon triangulation.
+ * Handles holes and complex polygons.
+ *
+ * @param data - Flat array of vertex coordinates [x0, y0, x1, y1, ...]
+ * @param holeIndices - Array of hole start indices (vertex indices, not coord indices)
+ * @param dim - Number of coordinates per vertex (default: 2)
+ * @returns Array of triangle indices
+ *
+ * @see https://github.com/mapbox/earcut
+ */
+export declare function earcut(data: number[], holeIndices?: number[], dim?: number): number[];
+//# sourceMappingURL=shape-generator.d.ts.map

package/dist/types/shape-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-generator.d.ts","sourceRoot":"","sources":["../../src/shape-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,QAAQ,EAAE,YAAY,CAAC;IACvB,0DAA0D;IAC1D,OAAO,EAAE,WAAW,CAAC;IACrB,6EAA6E;IAC7E,YAAY,EAAE,YAAY,CAAC;IAC3B;;;;;OAKG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,8CAA8C;IAC9C,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAO5E;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAiHpE;AAsoBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,SAAI,GAAG,MAAM,EAAE,CA+BhF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "layershift",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Embeddable video effects as Web Components. Drop-in parallax, depth-aware motion, and more.",
   "type": "module",
   "main": "dist/components/layershift.js",
@@ -60,12 +60,13 @@
     "url": "https://github.com/jeremysykes/layershift/issues"
   },
   "homepage": "https://layershift.io",
-  "dependencies": {},
   "devDependencies": {
     "@playwright/test": "^1.58.2",
+    "@types/jsdom": "^27.0.0",
     "@vitest/browser": "^4.0.18",
     "@xenova/transformers": "^2.17.2",
     "happy-dom": "^20.6.1",
+    "jsdom": "^28.1.0",
     "playwright": "^1.58.2",
     "sharp": "^0.34.5",
     "tsx": "^4.21.0",