pixi-effects 0.2.0 → 0.4.0

package/llms.txt

@@ -0,0 +1,30 @@
+# pixi-effects
+
+> Declarative motion graphics and video for the web. Describe a video as plain objects (text, shapes, images, video, audio, nested compositions, a 2.5D camera, optional three.js), play it in a canvas, export MP4 / WebM / MOV. Built on PixiJS v8, GSAP and mediabunny. Written to be authored by AI: no per-frame code.
+
+Rules that cause most failures (details in the skill and pitfalls):
+
+- Keyframe `at` is measured from the start of its own layer (negative = back from the layer's end). A layer's `at` and a transition's `at` are composition time.
+- Layers are hidden, not removed, after their lifespan; z-order is array order (later = on top).
+- Angles are degrees; +z is toward the viewer; any number can be an expression such as 'GW/2 - w/2'.
+- Anchors: rect/circle/ellipse are centred, text and image are top-left, compositions use pivotX/pivotY.
+- Verify by looking: seek with `await movie.gotoFrame(n, true)`, check at least 5 timestamps, and read `window.__logs` (library warnings are instructions).
+
+## Start here
+
+- [Skill: workflow and rules](https://raw.githubusercontent.com/yjmtmtk/pixi-effects/main/ai/SKILL.md): how to build, check and export a video; read first
+- [Cheatsheet](https://raw.githubusercontent.com/yjmtmtk/pixi-effects/main/ai/reference/cheatsheet.md): every layer type, prop, default and convention on one page
+- [Recipes](https://raw.githubusercontent.com/yjmtmtk/pixi-effects/main/ai/reference/recipes.md): tested building blocks (kinetic type, lower-third, count-up, bar chart, 2.5D title, camera orbit, slideshow with transitions, three.js)
+- [Pitfalls](https://raw.githubusercontent.com/yjmtmtk/pixi-effects/main/ai/reference/pitfalls.md): real mistakes made by AI authors, with fixes
+- [Starter template](https://raw.githubusercontent.com/yjmtmtk/pixi-effects/main/ai/template.html): copy this file to begin
+
+## Reference
+
+- [DSL reference](https://raw.githubusercontent.com/yjmtmtk/pixi-effects/main/docs/dsl.md): composition, sequences, 3D layers and camera, keyframes, expressions, filters, transitions, presets
+- [API reference](https://raw.githubusercontent.com/yjmtmtk/pixi-effects/main/docs/api.md): Movie, Controller, events, render options, pixi-effects/three
+- [README](https://raw.githubusercontent.com/yjmtmtk/pixi-effects/main/README.md): install, CDN import map, quickstart
+
+## Optional
+
+- [Everything above in one file](https://raw.githubusercontent.com/yjmtmtk/pixi-effects/main/llms-full.txt)
+- [Live demos and playground](https://yjmtmtk.github.io/pixi-effects/)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixi-effects",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Declarative composition and video rendering for the web. Built on PixiJS v8.",
   "type": "module",
   "exports": {
@@ -20,7 +20,7 @@
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": ["dist", "ai", "docs/dsl.md", "docs/api.md", "llms.txt", "llms-full.txt", "CHANGELOG.md", "README.md", "LICENSE"],
   "keywords": [
     "pixi", "pixijs", "video", "composition", "compositing", "rendering",
     "after-effects", "motion-graphics", "timeline", "webgl", "gsap", "keyframe", "typescript",
@@ -38,7 +38,9 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+    "build:ai": "node scripts/build-llms.mjs",
+    "build:gallery": "node scripts/build-gallery.mjs",
+    "prepublishOnly": "npm run build:ai && npm run typecheck && npm test && npm run build"
   },
   "dependencies": {
     "mediabunny": "^1.61.3"

package/dist/Composition-BI5HZJFL.cjs

@@ -1,13 +0,0 @@
-'use strict';
-
-var chunk64IHCYYN_cjs = require('./chunk-64IHCYYN.cjs');
-require('./chunk-7OIWYXGV.cjs');
-
-
-
-Object.defineProperty(exports, "CompositionSequence", {
-  enumerable: true,
-  get: function () { return chunk64IHCYYN_cjs.CompositionSequence; }
-});
-//# sourceMappingURL=Composition-BI5HZJFL.cjs.map
-//# sourceMappingURL=Composition-BI5HZJFL.cjs.map

package/dist/Composition-IO7ZN32J.js

@@ -1,4 +0,0 @@
-export { CompositionSequence } from './chunk-H55V3U56.js';
-import './chunk-VJCDG6YG.js';
-//# sourceMappingURL=Composition-IO7ZN32J.js.map
-//# sourceMappingURL=Composition-IO7ZN32J.js.map

package/dist/Movie-CcR6h2jO.d.cts

@@ -1,82 +0,0 @@
-import { Application } from 'pixi.js';
-import { gsap } from 'gsap';
-import { A as AssetSpec, g as CompositionSpec } from './types-CNBilhpz.cjs';
-
-interface MovieOptions {
-    width?: number;
-    height?: number;
-    duration?: number;
-    frameRate?: number;
-    background?: string;
-    canvas?: HTMLCanvasElement;
-    assets?: AssetSpec[];
-    composition?: CompositionSpec;
-}
-interface RenderOptions {
-    format?: 'mp4' | 'mov' | 'webm' | 'mkv';
-    video?: {
-        codec?: string;
-        bitrate?: 'very-low' | 'low' | 'medium' | 'high' | 'very-high';
-    };
-    audio?: {
-        codec?: string;
-        bitrate?: 'very-low' | 'low' | 'medium' | 'high' | 'very-high';
-    };
-}
-interface FrameEvent {
-    frame: number;
-    totalFrames: number;
-}
-interface ProgressEvent {
-    progress: number;
-    frame: number;
-    totalFrames: number;
-}
-type Listener = (...args: any[]) => void;
-declare class Movie {
-    private _events;
-    private _initState;
-    app: Application | null;
-    timeline: ReturnType<typeof gsap.timeline> | null;
-    audioBuffer: AudioBuffer | null;
-    audioSource: AudioBufferSourceNode | null;
-    gainNode: GainNode | null;
-    private _volume;
-    private _muted;
-    isPlaying: boolean;
-    currentFrame: number;
-    totalFrames: number;
-    width: number;
-    height: number;
-    duration: number;
-    frameRate: number;
-    background: string;
-    private _audioContext;
-    private _rootSequence;
-    private _rootContainer;
-    private _raf;
-    on(event: 'ready', fn: () => void): this;
-    on(event: 'frame', fn: (e: FrameEvent) => void): this;
-    on(event: 'progress', fn: (e: ProgressEvent) => void): this;
-    on(event: 'pause', fn: () => void): this;
-    off(event: string, fn: Listener): this;
-    emit(event: string, ...args: unknown[]): void;
-    get isReady(): boolean;
-    private _ensureAudioContext;
-    init(options?: MovieOptions): Promise<void>;
-    gotoFrame(frame: number, force?: boolean): Promise<void>;
-    private _awaitVideoFrames;
-    /** Projects every `threeD` layer for the current frame (see src/space). */
-    private _updateSpace;
-    play(): void;
-    pause(): void;
-    set volume(v: number);
-    get volume(): number;
-    set muted(v: boolean);
-    get muted(): boolean;
-    toggleMute(): boolean;
-    render(options?: RenderOptions): Promise<Blob>;
-    destroy(): Promise<void>;
-}
-
-export { type FrameEvent as F, Movie as M, type ProgressEvent as P, type RenderOptions as R, type MovieOptions as a };

package/dist/Movie-D-n8glA6.d.ts

@@ -1,82 +0,0 @@
-import { Application } from 'pixi.js';
-import { gsap } from 'gsap';
-import { A as AssetSpec, g as CompositionSpec } from './types-CNBilhpz.js';
-
-interface MovieOptions {
-    width?: number;
-    height?: number;
-    duration?: number;
-    frameRate?: number;
-    background?: string;
-    canvas?: HTMLCanvasElement;
-    assets?: AssetSpec[];
-    composition?: CompositionSpec;
-}
-interface RenderOptions {
-    format?: 'mp4' | 'mov' | 'webm' | 'mkv';
-    video?: {
-        codec?: string;
-        bitrate?: 'very-low' | 'low' | 'medium' | 'high' | 'very-high';
-    };
-    audio?: {
-        codec?: string;
-        bitrate?: 'very-low' | 'low' | 'medium' | 'high' | 'very-high';
-    };
-}
-interface FrameEvent {
-    frame: number;
-    totalFrames: number;
-}
-interface ProgressEvent {
-    progress: number;
-    frame: number;
-    totalFrames: number;
-}
-type Listener = (...args: any[]) => void;
-declare class Movie {
-    private _events;
-    private _initState;
-    app: Application | null;
-    timeline: ReturnType<typeof gsap.timeline> | null;
-    audioBuffer: AudioBuffer | null;
-    audioSource: AudioBufferSourceNode | null;
-    gainNode: GainNode | null;
-    private _volume;
-    private _muted;
-    isPlaying: boolean;
-    currentFrame: number;
-    totalFrames: number;
-    width: number;
-    height: number;
-    duration: number;
-    frameRate: number;
-    background: string;
-    private _audioContext;
-    private _rootSequence;
-    private _rootContainer;
-    private _raf;
-    on(event: 'ready', fn: () => void): this;
-    on(event: 'frame', fn: (e: FrameEvent) => void): this;
-    on(event: 'progress', fn: (e: ProgressEvent) => void): this;
-    on(event: 'pause', fn: () => void): this;
-    off(event: string, fn: Listener): this;
-    emit(event: string, ...args: unknown[]): void;
-    get isReady(): boolean;
-    private _ensureAudioContext;
-    init(options?: MovieOptions): Promise<void>;
-    gotoFrame(frame: number, force?: boolean): Promise<void>;
-    private _awaitVideoFrames;
-    /** Projects every `threeD` layer for the current frame (see src/space). */
-    private _updateSpace;
-    play(): void;
-    pause(): void;
-    set volume(v: number);
-    get volume(): number;
-    set muted(v: boolean);
-    get muted(): boolean;
-    toggleMute(): boolean;
-    render(options?: RenderOptions): Promise<Blob>;
-    destroy(): Promise<void>;
-}
-
-export { type FrameEvent as F, Movie as M, type ProgressEvent as P, type RenderOptions as R, type MovieOptions as a };

package/dist/chunk-64IHCYYN.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/space/camera.ts","../src/space/depth.ts","../src/space/Layer3D.ts","../src/space/lint.ts","../src/sequences/Composition.ts"],"names":["i","DEG","frameOf","PerspectiveMesh","Texture","projectLayer","Matrix","RenderTexture","collectPropKeys","Sequence","Container","Rectangle","buildSequenceTree","CameraSequence","cameraBasis","homeCamera"],"mappings":";;;;;;AAQO,SAAS,gBAAA,CACd,IAAA,EACA,CAAA,EACA,OAAA,EACU;AACV,EAAA,KAAA,IAAS,IAAI,IAAA,CAAK,MAAA,GAAS,CAAA,EAAG,CAAA,IAAK,GAAG,CAAA,EAAA,EAAK;AACzC,IAAA,MAAM,CAAA,GAAI,KAAK,CAAC,CAAA;AAChB,IAAA,MAAM,MAAA,GAAS,CAAA,IAAK,CAAA,CAAE,KAAA,KAAU,CAAA,GAAI,EAAE,GAAA,IAAQ,CAAA,CAAE,GAAA,IAAO,OAAA,IAAW,CAAA,IAAK,OAAA,CAAA;AACvE,IAAA,IAAI,QAAQ,OAAO,CAAA;AAAA,EACrB;AACA,EAAA,OAAO,IAAA;AACT;AAGO,SAAS,YAAY,IAAA,EAAwD;AAClF,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AACpC,IAAA,KAAA,IAAS,IAAI,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,IAAA,CAAK,QAAQ,CAAA,EAAA,EAAK;AACxC,MAAA,MAAM,CAAA,GAAI,KAAK,CAAC,CAAA;AAChB,MAAA,MAAM,CAAA,GAAI,KAAK,CAAC,CAAA;AAChB,MAAA,IAAI,CAAA,CAAE,KAAA,GAAQ,CAAA,CAAE,GAAA,IAAO,CAAA,CAAE,KAAA,GAAQ,CAAA,CAAE,GAAA,EAAK,OAAO,CAAC,CAAA,EAAG,CAAC,CAAA;AAAA,IACtD;AAAA,EACF;AACA,EAAA,OAAO,IAAA;AACT;;;ACvBA,IAAM,SAAS,CAAC,CAAA,KAAuB,OAAO,QAAA,CAAS,CAAC,IAAI,CAAA,GAAI,CAAA;AAOzD,SAAS,iBAAiB,KAAA,EAAuC;AACtE,EAAA,MAAM,MAAM,KAAA,CAAM,GAAA,CAAI,CAAAA,EAAAA,KAAKA,GAAE,UAAU,CAAA;AACvC,EAAA,IAAI,CAAA,GAAI,CAAA;AACR,EAAA,OAAO,CAAA,GAAI,MAAM,MAAA,EAAQ;AACvB,IAAA,IAAI,CAAC,KAAA,CAAM,CAAC,CAAA,CAAG,MAAA,EAAQ;AAAE,MAAA,CAAA,EAAA;AAAK,MAAA;AAAA,IAAU;AACxC,IAAA,IAAI,CAAA,GAAI,CAAA;AACR,IAAA,OAAO,CAAA,GAAI,IAAI,KAAA,CAAM,MAAA,IAAU,MAAM,CAAA,GAAI,CAAC,EAAG,MAAA,EAAQ,CAAA,EAAA;AACrD,IAAA,MAAM,MAAM,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,CAAA,GAAI,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,EAAA,EAAI,OAAO,EAAE,EAAA,EAAI,GAAA,EAAK,CAAA,GAAI,GAAE,CAAE,CAAA;AACrE,IAAA,MAAM,QAAQ,GAAA,CAAI,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,CAAE,GAAG,UAAU,CAAA;AAC1C,IAAA,MAAM,gBAAgB,CAAC,GAAG,GAAG,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA,EAAG,CAAA,KAAM,MAAA,CAAO,CAAA,CAAE,GAAG,KAAK,CAAA,GAAI,OAAO,CAAA,CAAE,EAAA,CAAG,KAAK,CAAC,CAAA;AACrF,IAAA,aAAA,CAAc,OAAA,CAAQ,CAAC,CAAA,EAAG,CAAA,KAAM;AAAE,MAAA,GAAA,CAAI,CAAA,CAAE,GAAG,CAAA,GAAI,KAAA,CAAM,CAAC,CAAA;AAAA,IAAI,CAAC,CAAA;AAC3D,IAAA,CAAA,GAAI,CAAA,GAAI,CAAA;AAAA,EACV;AACA,EAAA,OAAO,GAAA;AACT;ACxBO,IAAM,gBAAA,GAAmB,IAAA;AAMzB,IAAM,WAAA,GAAc,CAAA;AAEpB,IAAM,qBAAqB,IAAA,GAAO,IAAA;AAElC,IAAM,uBAAuB,IAAA,GAAO,IAAA;AAEpC,IAAM,SAAA,GAAY,EAAA;AAkBzB,SAAS,cAAc,MAAA,EAA2B;AAChD,EAAA,MAAM,UAAW,MAAA,CAA+E,OAAA;AAChG,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,GAAG,OAAO,CAAA;AACpC,EAAA,IAAI,GAAA,GAAM,CAAA;AACV,EAAA,KAAA,MAAW,CAAA,IAAK,OAAA,EAAS,GAAA,IAAO,CAAA,EAAG,OAAA,IAAW,CAAA;AAC9C,EAAA,OAAO,MAAA,CAAO,SAAS,GAAG,CAAA,IAAK,MAAM,CAAA,GAAI,IAAA,CAAK,IAAA,CAAK,GAAG,CAAA,GAAI,CAAA;AAC5D;AAEO,SAAS,mBAAmB,MAAA,EAAmC;AACpE,EAAA,MAAM,CAAA,GAAI,MAAA;AACV,EAAA,OAAO;AAAA,IACL,GAAG,CAAA,CAAE,CAAA;AAAA,IAAG,GAAG,CAAA,CAAE,CAAA;AAAA,IAAG,CAAA,EAAG,EAAE,CAAA,IAAK,CAAA;AAAA,IAC1B,SAAA,EAAA,CAAY,CAAA,CAAE,SAAA,IAAa,CAAA,IAAKC,qBAAA;AAAA,IAChC,SAAA,EAAA,CAAY,CAAA,CAAE,SAAA,IAAa,CAAA,IAAKA,qBAAA;AAAA,IAChC,WAAW,CAAA,CAAE,QAAA;AAAA,IACb,MAAA,EAAQ,EAAE,KAAA,CAAM,CAAA;AAAA,IAAG,MAAA,EAAQ,EAAE,KAAA,CAAM,CAAA;AAAA,IACnC,MAAA,EAAQ,EAAE,KAAA,CAAM,CAAA;AAAA,IAAG,MAAA,EAAQ,EAAE,KAAA,CAAM;AAAA,GACrC;AACF;AAYO,IAAM,UAAN,MAAc;AAAA,EAOnB,WAAA,CACmB,KACAC,QAAAA,EACjB;AAFiB,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AACA,IAAA,IAAA,CAAA,OAAA,GAAAA,QAAAA;AAEjB,IAAA,MAAM,SAAS,GAAA,CAAI,MAAA;AACnB,IAAA,MAAA,CAAO,CAAA,KAAM,CAAA;AACb,IAAA,MAAA,CAAO,SAAA,KAAc,CAAA;AACrB,IAAA,MAAA,CAAO,SAAA,KAAc,CAAA;AACrB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,uBAAA,CAAgB,EAAE,OAAA,EAASC,eAAA,CAAQ,KAAA,EAAO,SAAA,EAAW,SAAA,EAAW,SAAA,EAAW,SAAA,EAAW,CAAA;AACzG,IAAA,IAAI,IAAI,IAAA,CAAK,IAAA,OAAW,OAAA,CAAQ,KAAA,GAAQ,IAAI,IAAA,CAAK,IAAA;AACjD,IAAA,IAAA,CAAK,QAAQ,OAAA,GAAU,KAAA;AAAA,EACzB;AAAA,EAVmB,GAAA;AAAA,EACA,OAAA;AAAA,EARV,OAAA;AAAA;AAAA,EAET,KAAA,GAAQ,CAAA;AAAA,EACA,EAAA,GAA2B,IAAA;AAAA,EAC3B,IAAA,GAA2B,IAAA;AAAA,EAenC,MAAA,CAAO,MAAiB,KAAA,EAA0B;AAChD,IAAA,MAAM,MAAA,GAAS,KAAK,GAAA,CAAI,MAAA;AAGxB,IAAA,IAAI,CAAC,MAAA,IAAU,CAAC,MAAA,CAAO,UAAA,IAAc,CAAC,MAAA,CAAO,OAAA,EAAS,OAAO,IAAA,CAAK,IAAA,EAAK;AAEvE,IAAA,MAAM,MAAA,GAAS,KAAK,OAAA,EAAQ;AAC5B,IAAA,MAAM,GAAA,GAAM,cAAc,MAAM,CAAA;AAChC,IAAA,MAAM,QAAQ,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,KAAA,GAAQ,IAAI,GAAG,CAAA;AAC9C,IAAA,MAAM,QAAQ,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,MAAA,GAAS,IAAI,GAAG,CAAA;AAC/C,IAAA,IAAI,EAAE,KAAA,IAAS,CAAA,IAAK,SAAS,CAAA,CAAA,IAAM,CAAC,OAAO,QAAA,CAAS,MAAA,CAAO,CAAC,CAAA,IAAK,CAAC,OAAO,QAAA,CAAS,MAAA,CAAO,CAAC,CAAA,EAAG,OAAO,KAAK,IAAA,EAAK;AAE9G,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,OAAA,CAAQ,KAAA,EAAO,KAAK,CAAA;AAEtC,IAAA,MAAM,KAAA,GAAc,EAAE,CAAA,EAAG,MAAA,CAAO,IAAI,GAAA,EAAK,CAAA,EAAG,MAAA,CAAO,CAAA,GAAI,KAAK,KAAA,EAAO,IAAA,CAAK,CAAA,EAAG,MAAA,EAAQ,KAAK,CAAA,EAAE;AAC1F,IAAA,MAAM,YAAYC,8BAAA,CAAa,kBAAA,CAAmB,MAAM,CAAA,EAAG,OAAO,KAAK,CAAA;AACvE,IAAA,IAAA,CAAK,QAAQ,SAAA,CAAU,KAAA;AACvB,IAAA,IAAI,CAAC,SAAA,CAAU,OAAA,EAAS,OAAO,KAAK,IAAA,EAAK;AAEzC,IAAA,IAAA,CAAK,cAAc,IAAI,CAAA;AAIvB,IAAA,IAAA,CAAK,MAAA,CAAO;AAAA,MACV,SAAA,EAAW,MAAA;AAAA,MACX,QAAQ,IAAA,CAAK,EAAA;AAAA,MACb,SAAA,EAAW,IAAIC,cAAA,EAAO,CAAE,SAAA,CAAU,CAAC,KAAA,CAAM,CAAA,EAAG,CAAC,KAAA,CAAM,CAAC,CAAA;AAAA,MACpD,KAAA,EAAO,IAAA;AAAA,MACP,UAAA,EAAY,CAAC,CAAA,EAAG,CAAA,EAAG,GAAG,CAAC;AAAA,KACxB,CAAA;AACD,IAAA,IAAA,CAAK,OAAA,CAAQ,QAAA,CAAS,UAAA,CAAW,GAAG,UAAU,OAAO,CAAA;AACrD,IAAA,IAAA,CAAK,QAAQ,OAAA,GAAU,IAAA;AAAA,EACzB;AAAA,EAEA,OAAA,GAAgB;AACd,IAAA,IAAA,CAAK,QAAQ,OAAA,EAAQ;AACrB,IAAA,IAAA,CAAK,EAAA,EAAI,QAAQ,IAAI,CAAA;AACrB,IAAA,IAAA,CAAK,EAAA,GAAK,IAAA;AAAA,EACZ;AAAA,EAEQ,IAAA,GAAa;AACnB,IAAA,IAAA,CAAK,QAAQ,OAAA,GAAU,KAAA;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,OAAA,CAAQ,GAAW,CAAA,EAAwB;AACjD,IAAA,MAAM,MAAM,IAAA,CAAK,IAAA;AACjB,IAAA,IAAI,GAAA,IAAO,GAAA,CAAI,CAAA,IAAK,CAAA,IAAK,IAAI,CAAA,IAAK,CAAA,IAAK,GAAA,CAAI,CAAA,IAAK,IAAI,CAAA,IAAK,GAAA,CAAI,CAAA,IAAK,CAAA,GAAI,GAAG,OAAO,GAAA;AAChF,IAAA,MAAM,aAAa,IAAA,CAAK,GAAA;AAAA,MACtB,WAAA;AAAA,MACA,gBAAA,GAAmB,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,CAAC,CAAA;AAAA,MAChC,IAAA,CAAK,IAAA,CAAK,kBAAA,IAAsB,CAAA,GAAI,CAAA,CAAE;AAAA,KACxC;AACA,IAAA,MAAM,SAAA,GAAY,CAAA,GAAI,CAAA,GAAI,UAAA,GAAa,UAAA,IAAc,oBAAA;AACrD,IAAA,OAAO,EAAE,CAAA,EAAG,CAAA,EAAG,UAAA,EAAY,SAAA,EAAU;AAAA,EACvC;AAAA,EAEQ,cAAc,IAAA,EAAyB;AAC7C,IAAA,IAAI,IAAA,CAAK,EAAA,IAAM,IAAA,CAAK,IAAA,KAAS,IAAA,EAAM;AACnC,IAAA,MAAM,IAAA,GAAOC,sBAAc,MAAA,CAAO;AAAA,MAChC,OAAO,IAAA,CAAK,CAAA;AAAA,MAAG,QAAQ,IAAA,CAAK,CAAA;AAAA,MAAG,YAAY,IAAA,CAAK,UAAA;AAAA,MAAY,WAAW,IAAA,CAAK;AAAA,KAC7E,CAAA;AACD,IAAA,IAAA,CAAK,QAAQ,OAAA,GAAU,IAAA;AACvB,IAAA,IAAA,CAAK,EAAA,EAAI,QAAQ,IAAI,CAAA;AACrB,IAAA,IAAA,CAAK,EAAA,GAAK,IAAA;AACV,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AACF,CAAA;;;ACxJA,IAAM,WAAA,GAAoB,CAAA,CAAA,KAAK,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA;AAE7C,IAAM,QAAA,GAAW,CAAA,8GAAA,CAAA;AAGjB,IAAM,aAAA,GAAwC;AAAA,EAC5C,OAAA,EAAS,2BAAA;AAAA,EACT,OAAA,EAAS,2BAAA;AAAA,EACT,OAAA,EAAS,0BAAA;AAAA,EACT,SAAA,EAAW,iDAAA;AAAA,EACX,UAAA,EAAY,mBAAA;AAAA,EACZ,KAAA,EAAO,mBAAA;AAAA,EACP,IAAA,EAAM,mBAAA;AAAA,EACN,WAAA,EAAa,QAAA;AAAA,EACb,IAAA,EAAM;AACR,CAAA;AAGA,IAAM,cAAA,GAAyC;AAAA,EAC7C,eAAA,EAAiB,6CAAA;AAAA,EACjB,MAAA,EAAQ;AACV,CAAA;AAEA,IAAM,YAAA,GAAe,CAAC,GAAA,EAAK,GAAA,EAAK,KAAK,KAAA,EAAO,SAAA,EAAW,WAAW,SAAS,CAAA;AAC3E,IAAM,aAAA,GAAgB,CAAC,GAAA,EAAK,WAAA,EAAa,WAAW,CAAA;AACpD,IAAM,SAAA,GAAY,CAAC,MAAA,EAAQ,OAAA,EAAS,OAAO,CAAA;AAE3C,SAAS,MAAM,IAAA,EAA4B;AACzC,EAAA,OAAO,IAAA,CAAK,OAAO,CAAA,OAAA,EAAU,IAAA,CAAK,IAAI,CAAA,CAAA,CAAA,GAAM,CAAA,QAAA,EAAW,KAAK,IAAI,CAAA,MAAA,CAAA;AAClE;AAMO,SAAS,YAAA,CAAa,IAAA,EAAoB,IAAA,GAAa,WAAA,EAAmB;AAC/E,EAAA,MAAM,GAAA,GAAM,MAAM,IAAI,CAAA;AACtB,EAAA,MAAM,IAAA,GAAOC,kCAAgB,IAAI,CAAA;AACjC,EAAA,MAAM,SAAA,uBAAgB,GAAA,EAAY;AAElC,EAAA,KAAA,MAAW,KAAK,IAAA,EAAM;AACpB,IAAA,MAAM,IAAA,GAAO,cAAc,CAAC,CAAA,KAAM,KAAK,IAAA,KAAS,QAAA,GAAW,cAAA,CAAe,CAAC,CAAA,GAAI,MAAA,CAAA;AAC/E,IAAA,IAAI,IAAA,EAAM;AACR,MAAA,SAAA,CAAU,IAAI,CAAC,CAAA;AACf,MAAA,IAAA,CAAK,iBAAiB,GAAG,CAAA,GAAA,EAAM,CAAC,CAAA,2BAAA,EAAyB,IAAI,CAAA,CAAE,CAAA;AAAA,IACjE;AAAA,EACF;AAEA,EAAA,IAAI,IAAA,CAAK,SAAS,QAAA,EAAU;AAC1B,IAAA,MAAM,GAAA,GAAM,IAAA;AACZ,IAAA,KAAA,MAAW,KAAK,YAAA,EAAc;AAC5B,MAAA,IAAI,KAAK,GAAA,EAAK,IAAA,CAAK,iBAAiB,GAAG,CAAA,GAAA,EAAM,CAAC,CAAA,8DAAA,CAAgE,CAAA;AAAA,IAChH;AACA,IAAA,KAAA,MAAW,CAAA,IAAK,MAAA,CAAO,IAAA,CAAK,GAAG,CAAA,EAAG;AAChC,MAAA,MAAM,IAAA,GAAO,cAAA,CAAe,CAAC,CAAA,IAAK,cAAc,CAAC,CAAA;AACjD,MAAA,IAAI,IAAA,OAAW,CAAA,cAAA,EAAiB,GAAG,MAAM,CAAC,CAAA,2BAAA,EAAyB,IAAI,CAAA,iBAAA,CAAmB,CAAA;AAAA,IAC5F;AACA,IAAA,KAAA,MAAW,KAAK,IAAA,EAAM;AACpB,MAAA,IAAI,CAAC,UAAU,GAAA,CAAI,CAAC,KAAK,CAAC,YAAA,CAAa,QAAA,CAAS,CAAC,CAAA,EAAG;AAClD,QAAA,IAAA,CAAK,CAAA,cAAA,EAAiB,GAAG,CAAA,GAAA,EAAM,CAAC,oCAAoC,YAAA,CAAa,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,MAChG;AAAA,IACF;AACA,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,IAAA,CAAK,SAAS,OAAA,EAAS;AACzB,IAAA,IAAI,IAAA,CAAK,MAAA,EAAQ,IAAA,CAAK,CAAA,cAAA,EAAiB,GAAG,CAAA,+BAAA,CAAiC,CAAA;AAC3E,IAAA;AAAA,EACF;AAEA,EAAA,IAAI,CAAC,KAAK,MAAA,EAAQ;AAChB,IAAA,KAAA,MAAW,KAAK,aAAA,EAAe;AAC7B,MAAA,IAAI,IAAA,CAAK,IAAI,CAAC,CAAA,OAAQ,CAAA,cAAA,EAAiB,GAAG,CAAA,GAAA,EAAM,CAAC,CAAA,8CAAA,CAAgD,CAAA;AAAA,IACnG;AAAA,EACF,CAAA,MAAO;AACL,IAAA,KAAA,MAAW,KAAK,SAAA,EAAW;AACzB,MAAA,IAAI,IAAA,CAAK,IAAI,CAAC,CAAA,OAAQ,CAAA,cAAA,EAAiB,GAAG,CAAA,GAAA,EAAM,CAAC,CAAA,6BAAA,CAA+B,CAAA;AAAA,IAClF;AAAA,EACF;AACF;;;ACrEO,IAAM,mBAAA,GAAN,cAAkCC,0BAAA,CAAS;AAAA,EAExC,eAAA,GAAoC,IAAA;AAAA,EACpC,iBAAA,GAA6C,IAAA;AAAA,EACrD,YAAwB,EAAC;AAAA,EACjB,WAA6B,EAAC;AAAA,EAC9B,YAAuB,EAAC;AAAA;AAAA,EAExB,UAA2D,EAAC;AAAA,EAEpE,MAAM,KAAA,GAAuB;AAC3B,IAAA,MAAM,KAAA,GAAQ,KAAK,IAAA,CAAK,KAAA,IAAS,KAAK,MAAA,EAAQ,KAAA,IAAS,KAAK,IAAA,CAAK,KAAA;AACjE,IAAA,MAAM,MAAA,GAAS,KAAK,IAAA,CAAK,MAAA,IAAU,KAAK,MAAA,EAAQ,MAAA,IAAU,KAAK,IAAA,CAAK,MAAA;AACpE,IAAA,IAAI,IAAA,CAAK,aAAa,MAAA,EAAW;AAC/B,MAAA,IAAA,CAAK,QAAA,GAAW,KAAK,IAAA,CAAK,QAAA,IAAY,KAAK,MAAA,EAAQ,QAAA,IAAY,KAAK,IAAA,CAAK,QAAA;AAAA,IAC3E;AACA,IAAA,MAAM,OAAA,GAAU,IAAIC,iBAAAA,EAAU;AAC9B,IAAA,OAAA,CAAQ,QAAA,GAAW,IAAA;AACnB,IAAA,OAAA,CAAQ,gBAAA,GAAmB,IAAA;AAC3B,IAAA,OAAA,CAAQ,WAAW,IAAIC,iBAAA,CAAU,CAAA,EAAG,CAAA,EAAG,OAAO,MAAM,CAAA;AAEpD,IAAA,MAAM,KAAA,GAAQ,IAAID,iBAAAA,EAAU;AAC5B,IAAA,KAAA,CAAM,QAAA,GAAW,IAAA;AACjB,IAAA,KAAA,CAAM,gBAAA,GAAmB,IAAA;AACzB,IAAA,OAAA,CAAQ,SAAS,KAAK,CAAA;AAEtB,IAAA,IAAA,CAAK,MAAA,GAAS,OAAA;AACd,IAAA,IAAA,CAAK,cAAA,GAAiB,KAAA;AACtB,IAAA,IAAA,CAAK,eAAA,GAAkB,MAAA;AACvB,IAAA,IAAA,CAAK,eAAA,GAAkB,KAAA;AACvB,IAAA,IAAA,CAAK,oBAAoB,EAAE,KAAA,EAAO,MAAA,EAAQ,QAAA,EAAU,KAAK,QAAA,EAAS;AAElE,IAAA,KAAA,MAAW,KAAK,IAAA,CAAK,IAAA,CAAK,aAAa,EAAC,eAAgB,CAAC,CAAA;AAEzD,IAAA,IAAA,CAAK,YAAY,MAAME,mCAAA;AAAA,MACrB,IAAA,CAAK,IAAA,CAAK,SAAA,IAAa,EAAC;AAAA,MACxB,IAAA,CAAK,iBAAA;AAAA,MACL,IAAA,CAAK;AAAA,KACP;AACA,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,SAAA,EAAW;AAElC,MAAA,IAAI,iBAAiBC,gCAAA,EAAgB;AACnC,QAAA,IAAA,CAAK,QAAA,CAAS,KAAK,KAAK,CAAA;AACxB,QAAA;AAAA,MACF;AACA,MAAA,IAAI,CAAC,MAAM,MAAA,EAAQ;AAEnB,MAAA,MAAM,QAAA,GAAY,MAAM,IAAA,CAAiC,IAAA;AAIzD,MAAA,IAAI,KAAA,CAAM,KAAK,MAAA,EAAQ;AACrB,QAAA,MAAM,QAAQ,IAAI,OAAA,CAAQ,KAAA,EAAO,OAAA,CAAQ,KAAK,CAAC,CAAA;AAC/C,QAAA,KAAA,CAAM,QAAA,CAAS,MAAM,OAAO,CAAA;AAC5B,QAAA,IAAA,CAAK,SAAA,CAAU,KAAK,KAAK,CAAA;AACzB,QAAA,IAAA,CAAK,QAAQ,IAAA,CAAK,EAAE,GAAA,EAAK,KAAA,EAAO,OAAO,CAAA;AACvC,QAAA,IAAI,QAAA,EAAU;AACZ,UAAA,MAAM,GAAA,GAAM,KAAA,CAAM,IAAA,CAAK,IAAA,GAAO,CAAA,OAAA,EAAU,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA,CAAA,CAAA,GAAM,CAAA,QAAA,EAAW,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA,MAAA,CAAA;AACvF,UAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,cAAA,EAAiB,GAAG,CAAA,qDAAA,CAAuD,CAAA;AAAA,QAC1F;AACA,QAAA;AAAA,MACF;AAEA,MAAA,KAAA,CAAM,QAAA,CAAS,MAAM,MAAM,CAAA;AAC3B,MAAA,IAAA,CAAK,QAAQ,IAAA,CAAK,EAAE,KAAK,KAAA,EAAO,KAAA,EAAO,MAAM,CAAA;AAM7C,MAAA,IAAI,QAAA,EAAU;AACZ,QAAA,MAAM,KAAA,GAAQ,MAAMD,mCAAA,CAAkB,CAAC,QAAQ,CAAA,EAAG,IAAA,CAAK,iBAAA,EAAmB,IAAA,CAAK,IAAI,CAAA;AACnF,QAAA,MAAM,OAAA,GAAU,MAAM,CAAC,CAAA;AACvB,QAAA,IAAI,SAAS,MAAA,EAAQ;AACnB,UAAA,KAAA,CAAM,QAAA,CAAS,QAAQ,MAAM,CAAA;AAK7B,UAAA,MAAM,OAAA,GAAW,KAAA,CAAM,IAAA,CAAoC,YAAA,IAAgB,KAAA;AAC3E,UAAA,MAAM,IAAI,KAAA,CAAM,MAAA;AAIhB,UAAA,IAAI,OAAO,CAAA,CAAE,OAAA,KAAY,UAAA,EAAY;AACnC,YAAA,CAAA,CAAE,QAAQ,EAAE,IAAA,EAAM,OAAA,CAAQ,MAAA,EAAQ,SAAS,CAAA;AAAA,UAC7C,CAAA,MAAO;AACL,YAAA,CAAA,CAAE,OAAO,OAAA,CAAQ,MAAA;AAAA,UACnB;AACA,UAAA,KAAA,CAAM,YAAA,GAAe,OAAA;AAAA,QACvB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,IAAI,IAAA,CAAK,SAAA,CAAU,MAAA,GAAS,CAAA,EAAG;AAG7B,MAAA,KAAA,CAAM,gBAAA,GAAmB,IAAA;AACzB,MAAA,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAA,EAAG,CAAA,KAAM;AAC7B,QAAA,CAAC,EAAE,KAAA,EAAO,OAAA,IAAW,CAAA,CAAE,GAAA,CAAI,QAAS,MAAA,GAAS,CAAA;AAAA,MAC/C,CAAC,CAAA;AAAA,IACH,CAAA,MAAA,IAAW,IAAA,CAAK,QAAA,CAAS,MAAA,GAAS,CAAA,EAAG;AACnC,MAAA,OAAA,CAAQ,KAAK,2EAA2E,CAAA;AAAA,IAC1F;AAEA,IAAA,IAAA,CAAK,YAAA,EAAa;AAAA,EACpB;AAAA,EAES,YAAA,CAAa,QAAA,EAAoB,MAAA,GAAS,CAAA,EAAS;AAC1D,IAAA,KAAA,CAAM,YAAA,CAAa,UAAU,MAAM,CAAA;AAGnC,IAAA,MAAM,WAAA,GAAc,SAAS,IAAA,CAAK,EAAA;AAClC,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,SAAA,EAAW;AAClC,MAAA,KAAA,CAAM,YAAA,CAAa,UAAU,WAAW,CAAA;AAIxC,MAAA,KAAA,CAAM,YAAA,EAAc,YAAA,CAAa,QAAA,EAAU,WAAW,CAAA;AAAA,IACxD;AACA,IAAA,MAAM,OAAA,GAAU,YAAY,IAAA,CAAK,QAAA,CAAS,IAAI,CAAA,CAAA,KAAK,CAAA,CAAE,MAAA,EAAQ,CAAC,CAAA;AAC9D,IAAA,IAAI,OAAA,EAAS;AACX,MAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,uBAAA,EAA0B,OAAA,CAAQ,CAAC,CAAA,GAAI,CAAC,CAAA,MAAA,EAAS,OAAA,CAAQ,CAAC,CAAA,GAAI,CAAC,CAAA,uCAAA,CAAyC,CAAA;AAAA,IACvH;AAAA,EACF;AAAA,EAES,WAAA,CAAY,GAAW,IAAA,EAAuB;AAGrD,IAAA,KAAA,MAAW,SAAS,IAAA,CAAK,SAAA,EAAW,KAAA,CAAM,WAAA,CAAY,GAAG,IAAI,CAAA;AAC7D,IAAA,IAAI,KAAK,SAAA,CAAU,MAAA,KAAW,CAAA,IAAK,CAAC,KAAK,iBAAA,EAAmB;AAE5D,IAAA,MAAM,EAAE,KAAA,EAAO,MAAA,EAAO,GAAI,IAAA,CAAK,iBAAA;AAC/B,IAAA,MAAM,OAAA,GAAA,CAAW,IAAA,CAAK,aAAA,IAAiB,CAAA,KAAM,KAAK,QAAA,IAAY,CAAA,CAAA;AAC9D,IAAA,MAAM,MAAA,GAAS,gBAAA;AAAA,MACb,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,CAAA,GAAA,MAAQ,EAAE,KAAK,GAAG,GAAA,CAAI,MAAA,EAAO,EAAE,CAAE,CAAA;AAAA,MACnD,CAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,MAAM,KAAA,GAAQE,6BAAA,CAAY,MAAA,GAAS,MAAA,CAAO,GAAA,CAAI,KAAA,EAAM,GAAIC,4BAAA,CAAW,KAAA,EAAO,MAAM,CAAA,EAAG,KAAA,EAAO,MAAM,CAAA;AAEhG,IAAA,KAAA,MAAW,SAAS,IAAA,CAAK,SAAA,EAAW,KAAA,CAAM,MAAA,CAAO,MAAM,KAAK,CAAA;AAE5D,IAAA,MAAM,KAAA,GAAQ,gBAAA;AAAA,MACZ,KAAK,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,EAAG,CAAA,MAAO,EAAE,UAAA,EAAY,CAAA,EAAG,MAAA,EAAQ,CAAA,CAAE,UAAU,IAAA,EAAM,KAAA,EAAO,EAAE,KAAA,EAAO,KAAA,IAAS,GAAE,CAAE;AAAA,KACtG;AACA,IAAA,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,CAAC,CAAA,EAAG,CAAA,KAAM;AAC7B,MAAA,IAAI,EAAE,KAAA,EAAO,CAAA,CAAE,MAAM,OAAA,CAAQ,MAAA,GAAS,MAAM,CAAC,CAAA;AAAA,IAC/C,CAAC,CAAA;AAAA,EACH;AAAA,EAES,YAAA,CAAa,KAAwB,QAAA,EAAwB;AACpE,IAAA,KAAA,CAAM,YAAA,CAAa,KAAK,QAAQ,CAAA;AAChC,IAAA,MAAM,SAAA,GAAY,WAAW,IAAA,CAAK,EAAA;AAClC,IAAA,KAAA,MAAW,SAAS,IAAA,CAAK,SAAA,EAAW,KAAA,CAAM,YAAA,CAAa,KAAK,SAAS,CAAA;AAAA,EACvE;AAAA,EAES,OAAA,GAAgB;AACvB,IAAA,KAAA,MAAW,CAAA,IAAK,IAAA,CAAK,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ;AAC1C,IAAA,IAAA,CAAK,YAAY,EAAC;AAClB,IAAA,KAAA,MAAW,CAAA,IAAK,IAAA,CAAK,SAAA,EAAW,CAAA,CAAE,OAAA,EAAQ;AAC1C,IAAA,KAAA,CAAM,OAAA,EAAQ;AAAA,EAChB;AACF;AAGA,SAAS,QAAQ,KAAA,EAAgF;AAC/F,EAAA,IAAI,iBAAiB,mBAAA,EAAqB;AACxC,IAAA,OAAO,OAAO,EAAE,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,CAAA,EAAG,KAAA,EAAO,KAAA,CAAM,cAAA,EAAgB,MAAA,EAAQ,KAAA,CAAM,eAAA,EAAgB,CAAA;AAAA,EACzF;AACA,EAAA,OAAO,MAAM,KAAA,CAAM,MAAA,CAAQ,cAAA,EAAe;AAC5C","file":"chunk-64IHCYYN.cjs","sourcesContent":["/** A camera layer's lifespan on the global timeline, seconds. */\nexport interface CameraWindow { start: number; end: number }\n\n/**\n * The active camera at time `t`: the last-listed (top-most) camera whose\n * lifespan covers `t`. Windows are [start, end), except that a camera running\n * to the end of its composition also covers the final instant `t === compEnd`.\n */\nexport function pickActiveCamera<T extends CameraWindow>(\n  cams: readonly T[],\n  t: number,\n  compEnd: number,\n): T | null {\n  for (let i = cams.length - 1; i >= 0; i--) {\n    const c = cams[i]!;\n    const inside = t >= c.start && (t < c.end || (c.end >= compEnd && t <= compEnd));\n    if (inside) return c;\n  }\n  return null;\n}\n\n/** First pair of camera indices whose lifespans strictly overlap, or null. */\nexport function findOverlap(cams: readonly CameraWindow[]): [number, number] | null {\n  for (let i = 0; i < cams.length; i++) {\n    for (let j = i + 1; j < cams.length; j++) {\n      const a = cams[i]!;\n      const b = cams[j]!;\n      if (a.start < b.end && b.start < a.end) return [i, j];\n    }\n  }\n  return null;\n}\n","export interface DepthItem {\n  /** Position in the composition's stack (monotonic; gaps allowed). */\n  stackIndex: number;\n  threeD: boolean;\n  /** Camera-space depth (larger = farther). Only read for threeD items. */\n  depth: number;\n}\n\nconst finite = (n: number): number => (Number.isFinite(n) ? n : 0);\n\n/**\n * zIndex per item. Non-3D items keep their stack index. Each run of\n * consecutive threeD items is redistributed over the same index slots,\n * farthest first (drawn first), ties in stack order.\n */\nexport function assignDepthOrder(items: readonly DepthItem[]): number[] {\n  const out = items.map(i => i.stackIndex);\n  let i = 0;\n  while (i < items.length) {\n    if (!items[i]!.threeD) { i++; continue; }\n    let j = i;\n    while (j + 1 < items.length && items[j + 1]!.threeD) j++;\n    const run = items.slice(i, j + 1).map((it, k) => ({ it, pos: i + k }));\n    const slots = run.map(r => r.it.stackIndex);\n    const farthestFirst = [...run].sort((a, b) => finite(b.it.depth) - finite(a.it.depth));\n    farthestFirst.forEach((r, k) => { out[r.pos] = slots[k]!; });\n    i = j + 1;\n  }\n  return out;\n}\n","import { Container, Matrix, PerspectiveMesh, RenderTexture, Texture } from 'pixi.js';\nimport type { Sequence } from '../sequences/Base';\nimport { DEG, projectLayer, type CameraBasis, type LayerTransform, type Rect } from './math';\n\n/** Render textures are capped at this many pixels on the long side; larger layers are downscaled. */\nexport const MAX_TEXTURE_SIZE = 4096;\n/**\n * Render textures are drawn at this multiple of the layer size (until the caps),\n * so a layer enlarged by perspective (z > 0) stays sharp instead of showing\n * jagged edges and soft text.\n */\nexport const SUPERSAMPLE = 2;\n/** Total texture pixels per layer are capped here (≈ one 2048² target); resolution drops to fit. */\nexport const MAX_TEXTURE_PIXELS = 2048 * 2048;\n/** MSAA multiplies target memory ~4x, so only small textures get it (supersampling covers the rest). */\nexport const ANTIALIAS_MAX_PIXELS = 1024 * 1024;\n/** Mesh grid per side. 20 keeps steeply tilted planes free of visible affine warping. */\nexport const MESH_GRID = 20;\n\n/** The slice of a Pixi renderer Layer3D needs (also what tests fake). */\nexport interface SpaceHost {\n  render(options: {\n    container: Container;\n    target: RenderTexture;\n    transform: Matrix;\n    clear: boolean;\n    clearColor: number[];\n  }): void;\n}\n\ntype Carrier = Container & { z?: number; rotationX?: number; rotationY?: number };\n\ninterface TextureSize { w: number; h: number; resolution: number; antialias: boolean }\n\n/** Sum of the target's filter paddings: the texture must be this much larger on every side or filter output is clipped. */\nfunction filterPadding(target: Container): number {\n  const filters = (target as unknown as { filters?: ReadonlyArray<{ padding?: number }> | null }).filters;\n  if (!Array.isArray(filters)) return 0;\n  let pad = 0;\n  for (const f of filters) pad += f?.padding ?? 0;\n  return Number.isFinite(pad) && pad > 0 ? Math.ceil(pad) : 0;\n}\n\nexport function readLayerTransform(target: Container): LayerTransform {\n  const c = target as Carrier;\n  return {\n    x: c.x, y: c.y, z: c.z ?? 0,\n    rotationX: (c.rotationX ?? 0) * DEG,\n    rotationY: (c.rotationY ?? 0) * DEG,\n    rotationZ: c.rotation,\n    scaleX: c.scale.x, scaleY: c.scale.y,\n    pivotX: c.pivot.x, pivotY: c.pivot.y,\n  };\n}\n\n/**\n * Draws one `threeD` sequence: its display object is rendered into a\n * RenderTexture (with its own 2D transform replaced, so layer-local content\n * lands at the texture origin) and shown on a PerspectiveMesh whose four\n * corners come from projecting the layer through the active camera.\n *\n * The sequence's `target` is never in the scene graph; the composition adds\n * `display` instead. `z`, `rotationX`, `rotationY` live on `target` as plain\n * numeric props so GSAP tweens them like any other prop.\n */\nexport class Layer3D {\n  readonly display: PerspectiveMesh;\n  /** Camera-space depth from the last update (larger = farther). */\n  depth = 0;\n  private rt: RenderTexture | null = null;\n  private size: TextureSize | null = null;\n\n  constructor(\n    private readonly seq: Sequence,\n    private readonly frameOf: () => Rect,\n  ) {\n    const target = seq.target as Carrier;\n    target.z ??= 0;\n    target.rotationX ??= 0;\n    target.rotationY ??= 0;\n    this.display = new PerspectiveMesh({ texture: Texture.WHITE, verticesX: MESH_GRID, verticesY: MESH_GRID });\n    if (seq.spec.name) this.display.label = seq.spec.name;\n    this.display.visible = false;\n  }\n\n  update(host: SpaceHost, basis: CameraBasis): void {\n    const target = this.seq.target as Carrier | null;\n    // Pixi skips rendering (and clearing) a container that is not `visible`\n    // (e.g. PixiPlugin autoAlpha at alpha 0), which would leave a stale texture.\n    if (!target || !target.renderable || !target.visible) return this.hide();\n\n    const bounds = this.frameOf();\n    const pad = filterPadding(target);\n    const needW = Math.ceil(bounds.width + 2 * pad);\n    const needH = Math.ceil(bounds.height + 2 * pad);\n    if (!(needW >= 1 && needH >= 1) || !Number.isFinite(bounds.x) || !Number.isFinite(bounds.y)) return this.hide();\n\n    const size = this.sizeFor(needW, needH);\n    // The quad covers exactly the texture's pixel rect in layer space.\n    const frame: Rect = { x: bounds.x - pad, y: bounds.y - pad, width: size.w, height: size.h };\n    const projected = projectLayer(readLayerTransform(target), frame, basis);\n    this.depth = projected.depth;\n    if (!projected.visible) return this.hide();\n\n    this.ensureTexture(size);\n    // `transform` replaces the container's own local transform for this render\n    // (Pixi RenderGroupSystem), while `container.alpha` still applies — so the\n    // texture carries the layer's alpha and the mesh alpha stays at 1.\n    host.render({\n      container: target,\n      target: this.rt!,\n      transform: new Matrix().translate(-frame.x, -frame.y),\n      clear: true,\n      clearColor: [0, 0, 0, 0],\n    });\n    this.display.geometry.setCorners(...projected.corners);\n    this.display.visible = true;\n  }\n\n  destroy(): void {\n    this.display.destroy();\n    this.rt?.destroy(true);\n    this.rt = null;\n  }\n\n  private hide(): void {\n    this.display.visible = false;\n  }\n\n  /**\n   * Texture size for content of w×h. An existing texture is kept while it is at\n   * least that big and at most 2x too big, so content whose bounds change every\n   * frame (typewriter text, growing shapes) does not reallocate each frame.\n   */\n  private sizeFor(w: number, h: number): TextureSize {\n    const cur = this.size;\n    if (cur && cur.w >= w && cur.h >= h && cur.w <= 2 * w && cur.h <= 2 * h) return cur;\n    const resolution = Math.min(\n      SUPERSAMPLE,\n      MAX_TEXTURE_SIZE / Math.max(w, h),\n      Math.sqrt(MAX_TEXTURE_PIXELS / (w * h)),\n    );\n    const antialias = w * h * resolution * resolution <= ANTIALIAS_MAX_PIXELS;\n    return { w, h, resolution, antialias };\n  }\n\n  private ensureTexture(size: TextureSize): void {\n    if (this.rt && this.size === size) return;\n    const next = RenderTexture.create({\n      width: size.w, height: size.h, resolution: size.resolution, antialias: size.antialias,\n    });\n    this.display.texture = next;\n    this.rt?.destroy(true);\n    this.rt = next;\n    this.size = size;\n  }\n}\n","import { collectPropKeys } from './specKeys';\nimport type { SequenceSpec } from '../types';\n\ntype Warn = (message: string) => void;\nconst defaultWarn: Warn = m => console.warn(m);\n\nconst FOV_HINT = 'perspective is the camera\\'s \"fov\" — add a { type: \"camera\" } layer and set fov in its initial / keyframes';\n\n/** Keys that are never valid for any layer, with a hint at what the author probably meant. */\nconst LAYER_ALIASES: Record<string, string> = {\n  rotateX: 'did you mean \"rotationX\"?',\n  rotateY: 'did you mean \"rotationY\"?',\n  rotateZ: 'did you mean \"rotation\"?',\n  rotationZ: 'did you mean \"rotation\" (it is the Z rotation)?',\n  translateZ: 'did you mean \"z\"?',\n  depth: 'did you mean \"z\"?',\n  posZ: 'did you mean \"z\"?',\n  perspective: FOV_HINT,\n  zoom: FOV_HINT,\n};\n\n/** Camera-only mistakes. */\nconst CAMERA_ALIASES: Record<string, string> = {\n  pointOfInterest: 'did you mean \"lookAtX / lookAtY / lookAtZ\"?',\n  lookAt: 'did you mean \"lookAtX / lookAtY / lookAtZ\"?',\n};\n\nconst CAMERA_PROPS = ['x', 'y', 'z', 'fov', 'lookAtX', 'lookAtY', 'lookAtZ'];\nconst NEEDS_THREE_D = ['z', 'rotationX', 'rotationY'];\nconst SKEW_KEYS = ['skew', 'skewX', 'skewY'];\n\nfunction label(spec: SequenceSpec): string {\n  return spec.name ? `layer \"${spec.name}\"` : `unnamed ${spec.type} layer`;\n}\n\n/**\n * Warn (never throw) about the inputs an AI author is most likely to get wrong,\n * with a message that says what to change. One call per layer, at build time.\n */\nexport function lintSequence(spec: SequenceSpec, warn: Warn = defaultWarn): void {\n  const who = label(spec);\n  const keys = collectPropKeys(spec);\n  const explained = new Set<string>();\n\n  for (const k of keys) {\n    const hint = LAYER_ALIASES[k] ?? (spec.type === 'camera' ? CAMERA_ALIASES[k] : undefined);\n    if (hint) {\n      explained.add(k);\n      warn(`pixi-effects: ${who}: \"${k}\" is not a property — ${hint}`);\n    }\n  }\n\n  if (spec.type === 'camera') {\n    const raw = spec as unknown as Record<string, unknown>;\n    for (const p of CAMERA_PROPS) {\n      if (p in raw) warn(`pixi-effects: ${who}: \"${p}\" must go inside initial / keyframes, not on the camera itself`);\n    }\n    for (const k of Object.keys(raw)) {\n      const hint = CAMERA_ALIASES[k] ?? LAYER_ALIASES[k];\n      if (hint) warn(`pixi-effects: ${who}: \"${k}\" is not a property — ${hint} (inside initial)`);\n    }\n    for (const k of keys) {\n      if (!explained.has(k) && !CAMERA_PROPS.includes(k)) {\n        warn(`pixi-effects: ${who}: \"${k}\" has no effect on a camera (use ${CAMERA_PROPS.join(', ')})`);\n      }\n    }\n    return;\n  }\n\n  if (spec.type === 'audio') {\n    if (spec.threeD) warn(`pixi-effects: ${who}: threeD has no effect on audio`);\n    return;\n  }\n\n  if (!spec.threeD) {\n    for (const k of NEEDS_THREE_D) {\n      if (keys.has(k)) warn(`pixi-effects: ${who}: \"${k}\" needs threeD: true (it is ignored otherwise)`);\n    }\n  } else {\n    for (const k of SKEW_KEYS) {\n      if (keys.has(k)) warn(`pixi-effects: ${who}: \"${k}\" is ignored on threeD layers`);\n    }\n  }\n}\n","import { Container, Rectangle } from 'pixi.js';\nimport { Sequence } from './Base';\nimport { buildSequenceTree } from '../core/Composition';\nimport { CameraSequence } from '../space/CameraSequence';\nimport { findOverlap, pickActiveCamera } from '../space/camera';\nimport { assignDepthOrder } from '../space/depth';\nimport { Layer3D, type SpaceHost } from '../space/Layer3D';\nimport { lintSequence } from '../space/lint';\nimport { cameraBasis, homeCamera } from '../space/math';\nimport type { CompositionSequenceSpec, AudioDescriptor, CompositionShape, SequenceSpec } from '../types';\n\nimport type { gsap } from 'gsap';\ntype Timeline = ReturnType<typeof gsap.timeline>;\n\nexport class CompositionSequence extends Sequence {\n  declare spec: CompositionSequenceSpec;\n  private _innerContainer: Container | null = null;\n  private _compositionShape: CompositionShape | null = null;\n  _children: Sequence[] = [];\n  private _cameras: CameraSequence[] = [];\n  private _layers3d: Layer3D[] = [];\n  /** Drawn children in stack order (cameras and target-less sequences excluded). */\n  private _visual: Array<{ seq: Sequence; layer: Layer3D | null }> = [];\n\n  async build(): Promise<void> {\n    const width = this.spec.width ?? this.parent?.width ?? this.root.width;\n    const height = this.spec.height ?? this.parent?.height ?? this.root.height;\n    if (this.duration === undefined) {\n      this.duration = this.spec.duration ?? this.parent?.duration ?? this.root.duration;\n    }\n    const wrapper = new Container();\n    wrapper.cullable = true;\n    wrapper.cullableChildren = true;\n    wrapper.cullArea = new Rectangle(0, 0, width, height);\n\n    const inner = new Container();\n    inner.cullable = true;\n    inner.cullableChildren = true;\n    wrapper.addChild(inner);\n\n    this.target = wrapper;\n    this.intrinsicWidth = width;\n    this.intrinsicHeight = height;\n    this._innerContainer = inner;\n    this._compositionShape = { width, height, duration: this.duration };\n\n    for (const s of this.spec.sequences ?? []) lintSequence(s);\n\n    this._children = await buildSequenceTree(\n      this.spec.sequences ?? [],\n      this._compositionShape,\n      this.root,\n    );\n    for (const child of this._children) {\n      // Cameras are display-less: they only feed the projection pass.\n      if (child instanceof CameraSequence) {\n        this._cameras.push(child);\n        continue;\n      }\n      if (!child.target) continue;\n\n      const maskSpec = (child.spec as { mask?: SequenceSpec }).mask;\n\n      // threeD layers never enter the scene graph themselves: their display\n      // object is rendered into a texture and a perspective mesh stands in.\n      if (child.spec.threeD) {\n        const layer = new Layer3D(child, frameOf(child));\n        inner.addChild(layer.display);\n        this._layers3d.push(layer);\n        this._visual.push({ seq: child, layer });\n        if (maskSpec) {\n          const who = child.spec.name ? `layer \"${child.spec.name}\"` : `unnamed ${child.spec.type} layer`;\n          console.warn(`pixi-effects: ${who}: mask is not supported on threeD layers yet; ignored`);\n        }\n        continue;\n      }\n\n      inner.addChild(child.target);\n      this._visual.push({ seq: child, layer: null });\n      // If this child has a `mask` spec, build the mask sequence in the same\n      // composition shape, add its target to the same parent (so its\n      // transforms resolve in the same coord space), and wire PIXI's\n      // mask channel. PIXI v8 renders mask containers into the stencil /\n      // alpha buffer; they don't render as normal children.\n      if (maskSpec) {\n        const built = await buildSequenceTree([maskSpec], this._compositionShape, this.root);\n        const maskSeq = built[0];\n        if (maskSeq?.target) {\n          inner.addChild(maskSeq.target);\n          // PIXI v8 `setMask` accepts an `inverse` flag — that's how we\n          // expose `maskInverted` from the spec. Falls back to plain\n          // `target.mask = …` for runtimes that don't have setMask\n          // (older PIXI builds).\n          const inverse = (child.spec as { maskInverted?: boolean }).maskInverted ?? false;\n          const t = child.target as Container & {\n            setMask?: (opts: { mask: Container | null; inverse?: boolean }) => void;\n            mask: Container | null;\n          };\n          if (typeof t.setMask === 'function') {\n            t.setMask({ mask: maskSeq.target, inverse });\n          } else {\n            t.mask = maskSeq.target;\n          }\n          child.maskSequence = maskSeq;\n        }\n      }\n    }\n\n    if (this._layers3d.length > 0) {\n      // Stack order becomes explicit zIndex so threeD layers can be re-sorted\n      // by depth each frame without reparenting.\n      inner.sortableChildren = true;\n      this._visual.forEach((v, i) => {\n        (v.layer?.display ?? v.seq.target!).zIndex = i;\n      });\n    } else if (this._cameras.length > 0) {\n      console.warn('pixi-effects: camera has no effect: this composition has no threeD layers');\n    }\n\n    this.buildFilters();\n  }\n\n  override bindTimeline(timeline: Timeline, offset = 0): void {\n    super.bindTimeline(timeline, offset);\n    // Children's `at` is relative to this composition's start, so push them\n    // forward by our absolute start time on the global timeline.\n    const childOffset = offset + this.at;\n    for (const child of this._children) {\n      child.bindTimeline(timeline, childOffset);\n      // The mask shares the maskee's offset — its `at` is interpreted\n      // relative to the composition's start, just like the child itself,\n      // so a reveal-from-zero animation lines up naturally.\n      child.maskSequence?.bindTimeline(timeline, childOffset);\n    }\n    const overlap = findOverlap(this._cameras.map(c => c.window()));\n    if (overlap) {\n      console.warn(`pixi-effects: cameras #${overlap[0] + 1} and #${overlap[1] + 1} overlap in time; the top-most one wins`);\n    }\n  }\n\n  override updateSpace(t: number, host: SpaceHost): void {\n    // Inner compositions first: a threeD composition is rendered into its own\n    // texture by this level, so its content must already be projected.\n    for (const child of this._children) child.updateSpace(t, host);\n    if (this._layers3d.length === 0 || !this._compositionShape) return;\n\n    const { width, height } = this._compositionShape;\n    const compEnd = (this.absoluteStart ?? 0) + (this.duration ?? 0);\n    const active = pickActiveCamera(\n      this._cameras.map(cam => ({ cam, ...cam.window() })),\n      t,\n      compEnd,\n    );\n    const basis = cameraBasis(active ? active.cam.state() : homeCamera(width, height), width, height);\n\n    for (const layer of this._layers3d) layer.update(host, basis);\n\n    const order = assignDepthOrder(\n      this._visual.map((v, i) => ({ stackIndex: i, threeD: v.layer !== null, depth: v.layer?.depth ?? 0 })),\n    );\n    this._visual.forEach((v, i) => {\n      if (v.layer) v.layer.display.zIndex = order[i]!;\n    });\n  }\n\n  override collectAudio(out: AudioDescriptor[], baseTime: number): void {\n    super.collectAudio(out, baseTime);\n    const childBase = baseTime + this.at;\n    for (const child of this._children) child.collectAudio(out, childBase);\n  }\n\n  override destroy(): void {\n    for (const l of this._layers3d) l.destroy();\n    this._layers3d = [];\n    for (const c of this._children) c.destroy();\n    super.destroy();\n  }\n}\n\n/** Layer-space rectangle a threeD child projects: a composition's frame, otherwise its content bounds. */\nfunction frameOf(child: Sequence): () => { x: number; y: number; width: number; height: number } {\n  if (child instanceof CompositionSequence) {\n    return () => ({ x: 0, y: 0, width: child.intrinsicWidth, height: child.intrinsicHeight });\n  }\n  return () => child.target!.getLocalBounds();\n}\n"]}