pixi-effects 0.1.0 → 0.2.0

package/dist/three.cjs

@@ -0,0 +1,161 @@
+'use strict';
+
+var chunk7OIWYXGV_cjs = require('./chunk-7OIWYXGV.cjs');
+var pixi_js = require('pixi.js');
+var three$1 = require('three');
+
+var ThreeSequence = class extends chunk7OIWYXGV_cjs.Sequence {
+  _renderer = null;
+  _scene = null;
+  _camera = null;
+  _ctx = null;
+  _objects = {};
+  _warnedUpdate = false;
+  _warnedPaths = /* @__PURE__ */ new Set();
+  get _threeSpec() {
+    return this.spec;
+  }
+  pathRouters() {
+    return { three: (path) => this._resolveThreePath(path) };
+  }
+  async build() {
+    const spec = this._threeSpec;
+    if (this.duration === void 0) {
+      this.duration = this.parent?.duration ?? this.root.duration;
+    }
+    const scope = chunk7OIWYXGV_cjs.buildScope(this, this.parent, this.root);
+    const width = resolveDim(spec.width, scope) ?? this.parent?.width ?? this.root.width;
+    const height = resolveDim(spec.height, scope) ?? this.parent?.height ?? this.root.height;
+    const resolution = spec.resolution ?? 1;
+    const canvas = document.createElement("canvas");
+    const renderer = new three$1.WebGLRenderer({ canvas, alpha: true, antialias: true });
+    this._renderer = renderer;
+    try {
+      renderer.setSize(Math.round(width * resolution), Math.round(height * resolution), false);
+      renderer.setClearColor(0, 0);
+      const scene = new three$1.Scene();
+      const camera = new three$1.PerspectiveCamera(50, width / height, 0.1, 2e3);
+      const ctx = { scene, camera, renderer, width, height };
+      const result = await spec.setup(ctx);
+      if (result?.camera) ctx.camera = result.camera;
+      this._scene = scene;
+      this._camera = ctx.camera;
+      this._ctx = ctx;
+      this._objects = { ...result?.objects ?? {} };
+      if (!("camera" in this._objects)) this._objects.camera = this._camera;
+      renderer.render(scene, this._camera);
+      const texture = pixi_js.Texture.from(canvas);
+      const sprite = new pixi_js.Sprite({ texture, label: spec.name });
+      sprite.cullable = true;
+      sprite.width = width;
+      sprite.height = height;
+      this.target = sprite;
+      this.intrinsicWidth = width;
+      this.intrinsicHeight = height;
+      this.buildFilters();
+    } catch (err) {
+      this._disposeRenderer();
+      throw err;
+    }
+  }
+  /**
+   * Per-frame sync hook. Movie._awaitVideoFrames duck-types on this method
+   * (same contract as VideoSequence) and awaits it inside gotoFrame — the
+   * single frame path shared by playback and export, which is what makes
+   * three layers deterministic in both.
+   */
+  async awaitFrameAt(local) {
+    if (!this._renderer || !this._scene || !this._camera || !this._ctx) return;
+    const spec = this._threeSpec;
+    const t = Math.max(0, Math.min(local, this.duration ?? local));
+    if (spec.update) {
+      try {
+        spec.update(t, this._ctx);
+      } catch (err) {
+        if (!this._warnedUpdate) {
+          this._warnedUpdate = true;
+          console.warn("pixi-effects: three update() threw (reported once) \u2014", err);
+        }
+      }
+    }
+    this._renderer.render(this._scene, this._camera);
+    this.target?.texture.source.update();
+  }
+  _resolveThreePath(path) {
+    const segs = path.split(".");
+    if (segs.length < 2) {
+      this._warnPath(path, "needs at least <object>.<prop>");
+      return null;
+    }
+    let obj = this._objects[segs[0]];
+    if (obj == null) {
+      this._warnPath(path, `unknown object "${segs[0]}" \u2014 expose it via setup's { objects }`);
+      return null;
+    }
+    for (let i = 1; i < segs.length - 1; i++) {
+      obj = obj[segs[i]];
+      if (obj == null) {
+        this._warnPath(path, `"${segs[i]}" is undefined along the path`);
+        return null;
+      }
+    }
+    const prop = segs[segs.length - 1];
+    if (typeof obj !== "object" || !(prop in obj)) {
+      this._warnPath(path, `no property "${prop}"`);
+      return null;
+    }
+    return { target: obj, prop };
+  }
+  _warnPath(path, why) {
+    if (this._warnedPaths.has(path)) return;
+    this._warnedPaths.add(path);
+    console.warn(`pixi-effects: keyframe path three.${path} ${why}; skipped`);
+  }
+  _disposeRenderer() {
+    if (!this._renderer) return;
+    try {
+      this._renderer.dispose();
+      this._renderer.forceContextLoss();
+    } catch (err) {
+      console.warn("pixi-effects: three renderer dispose threw \u2014", err);
+    }
+    this._renderer = null;
+  }
+  destroy() {
+    const spec = this._threeSpec;
+    if (this._ctx && spec.dispose) {
+      try {
+        spec.dispose(this._ctx);
+      } catch (err) {
+        console.warn("pixi-effects: three dispose() threw \u2014", err);
+      }
+    }
+    const texture = this.target?.texture;
+    this._disposeRenderer();
+    this._scene = null;
+    this._camera = null;
+    this._ctx = null;
+    this._objects = {};
+    super.destroy();
+    texture?.destroy(true);
+  }
+};
+function resolveDim(v, scope) {
+  if (v === void 0) return void 0;
+  if (typeof v === "number") return v;
+  return chunk7OIWYXGV_cjs.evaluateExpr(v, scope);
+}
+
+// src/three/index.ts
+function registerThree() {
+  chunk7OIWYXGV_cjs.registerSequenceType("three", ThreeSequence);
+}
+function three(spec) {
+  return spec;
+}
+
+exports.ThreeSequence = ThreeSequence;
+exports.registerThree = registerThree;
+exports.three = three;
+//# sourceMappingURL=three.cjs.map
+//# sourceMappingURL=three.cjs.map

package/dist/three.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/three/ThreeSequence.ts","../src/three/index.ts"],"names":["Sequence","buildScope","WebGLRenderer","Scene","PerspectiveCamera","Texture","Sprite","evaluateExpr","registerSequenceType"],"mappings":"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","file":"three.cjs","sourcesContent":["import { Sprite, Texture } from 'pixi.js';\nimport { PerspectiveCamera, Scene, WebGLRenderer, type Camera } from 'three';\nimport { Sequence } from '../sequences/Base';\nimport { buildScope } from '../expr/Scope';\nimport { evaluateExpr } from '../expr/Parser';\nimport type { PathRouters } from '../core/Timeline';\nimport type { PropValue } from '../types';\nimport type { ThreeContext, ThreeSequenceSpec } from './types';\n\nexport class ThreeSequence extends Sequence {\n  private _renderer: WebGLRenderer | null = null;\n  private _scene: Scene | null = null;\n  private _camera: Camera | null = null;\n  private _ctx: ThreeContext | null = null;\n  private _objects: Record<string, object> = {};\n  private _warnedUpdate = false;\n  private _warnedPaths = new Set<string>();\n\n  private get _threeSpec(): ThreeSequenceSpec {\n    return this.spec as unknown as ThreeSequenceSpec;\n  }\n\n  protected override pathRouters(): PathRouters {\n    return { three: (path) => this._resolveThreePath(path) };\n  }\n\n  async build(): Promise<void> {\n    const spec = this._threeSpec;\n    if (this.duration === undefined) {\n      this.duration = this.parent?.duration ?? this.root.duration;\n    }\n\n    // Resolve layer size. Expressions see the usual scope; intrinsic w/h are\n    // still 0 here (same chicken-and-egg as shapes), so W/H/GW/GH carry it.\n    const scope = buildScope(this, this.parent, this.root) as unknown as Record<string, number>;\n    const width = resolveDim(spec.width, scope) ?? this.parent?.width ?? this.root.width;\n    const height = resolveDim(spec.height, scope) ?? this.parent?.height ?? this.root.height;\n    const resolution = spec.resolution ?? 1;\n\n    // Offscreen canvas — never attached to the DOM. document.createElement\n    // (not OffscreenCanvas) so PIXI's Texture.from and three both accept it.\n    const canvas = document.createElement('canvas');\n    const renderer = new WebGLRenderer({ canvas, alpha: true, antialias: true });\n    this._renderer = renderer;\n    try {\n      renderer.setSize(Math.round(width * resolution), Math.round(height * resolution), false);\n      renderer.setClearColor(0x000000, 0);\n\n      const scene = new Scene();\n      const camera: Camera = new PerspectiveCamera(50, width / height, 0.1, 2000);\n      const ctx: ThreeContext = { scene, camera, renderer, width, height };\n\n      const result = await spec.setup(ctx);\n      if (result?.camera) ctx.camera = result.camera;\n      this._scene = scene;\n      this._camera = ctx.camera;\n      this._ctx = ctx;\n      this._objects = { ...(result?.objects ?? {}) };\n      if (!('camera' in this._objects)) this._objects.camera = this._camera;\n\n      // Frame 0 so the texture is never blank before the first tick.\n      renderer.render(scene, this._camera);\n\n      const texture = Texture.from(canvas);\n      const sprite = new Sprite({ texture, label: spec.name });\n      sprite.cullable = true;\n      // Texture is canvas-sized (layer px × resolution); scale back to comp px.\n      sprite.width = width;\n      sprite.height = height;\n      this.target = sprite;\n      this.intrinsicWidth = width;\n      this.intrinsicHeight = height;\n      this.buildFilters();\n    } catch (err) {\n      this._disposeRenderer();\n      throw err;\n    }\n  }\n\n  /**\n   * Per-frame sync hook. Movie._awaitVideoFrames duck-types on this method\n   * (same contract as VideoSequence) and awaits it inside gotoFrame — the\n   * single frame path shared by playback and export, which is what makes\n   * three layers deterministic in both.\n   */\n  async awaitFrameAt(local: number): Promise<void> {\n    if (!this._renderer || !this._scene || !this._camera || !this._ctx) return;\n    const spec = this._threeSpec;\n    const t = Math.max(0, Math.min(local, this.duration ?? local));\n    if (spec.update) {\n      try {\n        spec.update(t, this._ctx);\n      } catch (err) {\n        if (!this._warnedUpdate) {\n          this._warnedUpdate = true;\n          console.warn('pixi-effects: three update() threw (reported once) —', err);\n        }\n      }\n    }\n    this._renderer.render(this._scene, this._camera);\n    (this.target as Sprite | null)?.texture.source.update();\n  }\n\n  private _resolveThreePath(path: string): { target: object; prop: string } | null {\n    const segs = path.split('.');\n    if (segs.length < 2) {\n      this._warnPath(path, 'needs at least <object>.<prop>');\n      return null;\n    }\n    let obj: unknown = this._objects[segs[0]!];\n    if (obj == null) {\n      this._warnPath(path, `unknown object \"${segs[0]}\" — expose it via setup's { objects }`);\n      return null;\n    }\n    for (let i = 1; i < segs.length - 1; i++) {\n      obj = (obj as Record<string, unknown>)[segs[i]!];\n      if (obj == null) {\n        this._warnPath(path, `\"${segs[i]}\" is undefined along the path`);\n        return null;\n      }\n    }\n    const prop = segs[segs.length - 1]!;\n    if (typeof obj !== 'object' || !(prop in (obj as object))) {\n      this._warnPath(path, `no property \"${prop}\"`);\n      return null;\n    }\n    return { target: obj as object, prop };\n  }\n\n  private _warnPath(path: string, why: string): void {\n    if (this._warnedPaths.has(path)) return;\n    this._warnedPaths.add(path);\n    console.warn(`pixi-effects: keyframe path three.${path} ${why}; skipped`);\n  }\n\n  private _disposeRenderer(): void {\n    if (!this._renderer) return;\n    try {\n      this._renderer.dispose();\n      this._renderer.forceContextLoss();\n    } catch (err) {\n      console.warn('pixi-effects: three renderer dispose threw —', err);\n    }\n    this._renderer = null;\n  }\n\n  override destroy(): void {\n    const spec = this._threeSpec;\n    if (this._ctx && spec.dispose) {\n      try { spec.dispose(this._ctx); } catch (err) {\n        console.warn('pixi-effects: three dispose() threw —', err);\n      }\n    }\n    const texture = (this.target as Sprite | null)?.texture;\n    this._disposeRenderer();\n    this._scene = null;\n    this._camera = null;\n    this._ctx = null;\n    this._objects = {};\n    super.destroy();\n    texture?.destroy(true); // canvas-backed source is per-sequence; safe to kill\n  }\n}\n\nfunction resolveDim(v: PropValue | undefined, scope: Record<string, number>): number | undefined {\n  if (v === undefined) return undefined;\n  if (typeof v === 'number') return v;\n  return evaluateExpr(v, scope);\n}\n","/**\n * pixi-effects/three — optional three.js integration.\n *\n * Import this entry only when you use `type: 'three'` sequences; the core\n * `pixi-effects` entry never touches three.js. Call `registerThree()` once\n * before Movie.init builds a composition containing a three sequence.\n */\nimport { registerSequenceType, type SequenceCtor } from '../core/Composition';\nimport { ThreeSequence } from './ThreeSequence';\nimport type { SequenceSpec } from '../types';\nimport type { ThreeSequenceSpec } from './types';\n\nexport { ThreeSequence } from './ThreeSequence';\nexport type { ThreeContext, ThreeSetupResult, ThreeSequenceSpec } from './types';\n\n/** Register the 'three' sequence type. Idempotent; explicit call so `sideEffects: false` bundlers can't drop it. */\nexport function registerThree(): void {\n  registerSequenceType('three', ThreeSequence as unknown as SequenceCtor);\n}\n\n/**\n * Typing helper: accepts a strongly-typed three spec and returns it as a\n * core SequenceSpec, keeping three.js types out of the core union.\n */\nexport function three(spec: ThreeSequenceSpec): SequenceSpec {\n  return spec as unknown as SequenceSpec;\n}\n"]}

package/dist/three.d.cts

@@ -0,0 +1,79 @@
+import { a as SequenceCommon, n as PropValue, S as SequenceSpec } from './types-CNBilhpz.cjs';
+import { Scene, Camera, WebGLRenderer } from 'three';
+import { S as Sequence, P as PathRouters } from './Base-B1Tdn0Cv.cjs';
+import 'pixi.js';
+import 'gsap';
+
+/** Handed to setup / update / dispose. One per three sequence. */
+interface ThreeContext {
+    scene: Scene;
+    /** Default: PerspectiveCamera(50, width/height, 0.1, 2000). Replaced when setup returns { camera }. */
+    camera: Camera;
+    renderer: WebGLRenderer;
+    /** Resolved layer size in composition px. */
+    width: number;
+    height: number;
+}
+interface ThreeSetupResult {
+    /** Objects addressable from keyframes as `three.<name>.<path>`. `camera` is added implicitly unless present. */
+    objects?: Record<string, object>;
+    /** Replaces the default camera. */
+    camera?: Camera;
+}
+interface ThreeSequenceSpec extends SequenceCommon {
+    type: 'three';
+    /** Layer size in composition px. Expressions allowed (e.g. 'W * 0.5'). Default: parent composition size. */
+    width?: PropValue;
+    height?: PropValue;
+    /** Supersampling factor for the offscreen canvas. Default 1. */
+    resolution?: number;
+    /**
+     * Build the scene. Add objects to `ctx.scene`, position `ctx.camera`
+     * (or replace it entirely by returning `{ camera }`). Async so GLTF /
+     * texture loading can be awaited — Movie.init waits for it.
+     */
+    setup: (ctx: ThreeContext) => Promise<ThreeSetupResult | void> | ThreeSetupResult | void;
+    /**
+     * Optional per-frame hook; `t` is sequence-local time in seconds.
+     * MUST derive state purely from `t` (no wall clock, no unseeded
+     * randomness) — playback and export both seek arbitrarily and must
+     * produce identical frames.
+     */
+    update?: (t: number, ctx: ThreeContext) => void;
+    /** Cleanup for user-created GPU resources (geometries, materials, textures). Called from destroy(). */
+    dispose?: (ctx: ThreeContext) => void;
+}
+
+declare class ThreeSequence extends Sequence {
+    private _renderer;
+    private _scene;
+    private _camera;
+    private _ctx;
+    private _objects;
+    private _warnedUpdate;
+    private _warnedPaths;
+    private get _threeSpec();
+    protected pathRouters(): PathRouters;
+    build(): Promise<void>;
+    /**
+     * Per-frame sync hook. Movie._awaitVideoFrames duck-types on this method
+     * (same contract as VideoSequence) and awaits it inside gotoFrame — the
+     * single frame path shared by playback and export, which is what makes
+     * three layers deterministic in both.
+     */
+    awaitFrameAt(local: number): Promise<void>;
+    private _resolveThreePath;
+    private _warnPath;
+    private _disposeRenderer;
+    destroy(): void;
+}
+
+/** Register the 'three' sequence type. Idempotent; explicit call so `sideEffects: false` bundlers can't drop it. */
+declare function registerThree(): void;
+/**
+ * Typing helper: accepts a strongly-typed three spec and returns it as a
+ * core SequenceSpec, keeping three.js types out of the core union.
+ */
+declare function three(spec: ThreeSequenceSpec): SequenceSpec;
+
+export { type ThreeContext, ThreeSequence, type ThreeSequenceSpec, type ThreeSetupResult, registerThree, three };

package/dist/three.d.ts

@@ -0,0 +1,79 @@
+import { a as SequenceCommon, n as PropValue, S as SequenceSpec } from './types-CNBilhpz.js';
+import { Scene, Camera, WebGLRenderer } from 'three';
+import { S as Sequence, P as PathRouters } from './Base-Bh_VSusi.js';
+import 'pixi.js';
+import 'gsap';
+
+/** Handed to setup / update / dispose. One per three sequence. */
+interface ThreeContext {
+    scene: Scene;
+    /** Default: PerspectiveCamera(50, width/height, 0.1, 2000). Replaced when setup returns { camera }. */
+    camera: Camera;
+    renderer: WebGLRenderer;
+    /** Resolved layer size in composition px. */
+    width: number;
+    height: number;
+}
+interface ThreeSetupResult {
+    /** Objects addressable from keyframes as `three.<name>.<path>`. `camera` is added implicitly unless present. */
+    objects?: Record<string, object>;
+    /** Replaces the default camera. */
+    camera?: Camera;
+}
+interface ThreeSequenceSpec extends SequenceCommon {
+    type: 'three';
+    /** Layer size in composition px. Expressions allowed (e.g. 'W * 0.5'). Default: parent composition size. */
+    width?: PropValue;
+    height?: PropValue;
+    /** Supersampling factor for the offscreen canvas. Default 1. */
+    resolution?: number;
+    /**
+     * Build the scene. Add objects to `ctx.scene`, position `ctx.camera`
+     * (or replace it entirely by returning `{ camera }`). Async so GLTF /
+     * texture loading can be awaited — Movie.init waits for it.
+     */
+    setup: (ctx: ThreeContext) => Promise<ThreeSetupResult | void> | ThreeSetupResult | void;
+    /**
+     * Optional per-frame hook; `t` is sequence-local time in seconds.
+     * MUST derive state purely from `t` (no wall clock, no unseeded
+     * randomness) — playback and export both seek arbitrarily and must
+     * produce identical frames.
+     */
+    update?: (t: number, ctx: ThreeContext) => void;
+    /** Cleanup for user-created GPU resources (geometries, materials, textures). Called from destroy(). */
+    dispose?: (ctx: ThreeContext) => void;
+}
+
+declare class ThreeSequence extends Sequence {
+    private _renderer;
+    private _scene;
+    private _camera;
+    private _ctx;
+    private _objects;
+    private _warnedUpdate;
+    private _warnedPaths;
+    private get _threeSpec();
+    protected pathRouters(): PathRouters;
+    build(): Promise<void>;
+    /**
+     * Per-frame sync hook. Movie._awaitVideoFrames duck-types on this method
+     * (same contract as VideoSequence) and awaits it inside gotoFrame — the
+     * single frame path shared by playback and export, which is what makes
+     * three layers deterministic in both.
+     */
+    awaitFrameAt(local: number): Promise<void>;
+    private _resolveThreePath;
+    private _warnPath;
+    private _disposeRenderer;
+    destroy(): void;
+}
+
+/** Register the 'three' sequence type. Idempotent; explicit call so `sideEffects: false` bundlers can't drop it. */
+declare function registerThree(): void;
+/**
+ * Typing helper: accepts a strongly-typed three spec and returns it as a
+ * core SequenceSpec, keeping three.js types out of the core union.
+ */
+declare function three(spec: ThreeSequenceSpec): SequenceSpec;
+
+export { type ThreeContext, ThreeSequence, type ThreeSequenceSpec, type ThreeSetupResult, registerThree, three };

package/dist/three.js

@@ -0,0 +1,157 @@
+import { Sequence, buildScope, evaluateExpr, registerSequenceType } from './chunk-VJCDG6YG.js';
+import { Texture, Sprite } from 'pixi.js';
+import { WebGLRenderer, Scene, PerspectiveCamera } from 'three';
+
+var ThreeSequence = class extends Sequence {
+  _renderer = null;
+  _scene = null;
+  _camera = null;
+  _ctx = null;
+  _objects = {};
+  _warnedUpdate = false;
+  _warnedPaths = /* @__PURE__ */ new Set();
+  get _threeSpec() {
+    return this.spec;
+  }
+  pathRouters() {
+    return { three: (path) => this._resolveThreePath(path) };
+  }
+  async build() {
+    const spec = this._threeSpec;
+    if (this.duration === void 0) {
+      this.duration = this.parent?.duration ?? this.root.duration;
+    }
+    const scope = buildScope(this, this.parent, this.root);
+    const width = resolveDim(spec.width, scope) ?? this.parent?.width ?? this.root.width;
+    const height = resolveDim(spec.height, scope) ?? this.parent?.height ?? this.root.height;
+    const resolution = spec.resolution ?? 1;
+    const canvas = document.createElement("canvas");
+    const renderer = new WebGLRenderer({ canvas, alpha: true, antialias: true });
+    this._renderer = renderer;
+    try {
+      renderer.setSize(Math.round(width * resolution), Math.round(height * resolution), false);
+      renderer.setClearColor(0, 0);
+      const scene = new Scene();
+      const camera = new PerspectiveCamera(50, width / height, 0.1, 2e3);
+      const ctx = { scene, camera, renderer, width, height };
+      const result = await spec.setup(ctx);
+      if (result?.camera) ctx.camera = result.camera;
+      this._scene = scene;
+      this._camera = ctx.camera;
+      this._ctx = ctx;
+      this._objects = { ...result?.objects ?? {} };
+      if (!("camera" in this._objects)) this._objects.camera = this._camera;
+      renderer.render(scene, this._camera);
+      const texture = Texture.from(canvas);
+      const sprite = new Sprite({ texture, label: spec.name });
+      sprite.cullable = true;
+      sprite.width = width;
+      sprite.height = height;
+      this.target = sprite;
+      this.intrinsicWidth = width;
+      this.intrinsicHeight = height;
+      this.buildFilters();
+    } catch (err) {
+      this._disposeRenderer();
+      throw err;
+    }
+  }
+  /**
+   * Per-frame sync hook. Movie._awaitVideoFrames duck-types on this method
+   * (same contract as VideoSequence) and awaits it inside gotoFrame — the
+   * single frame path shared by playback and export, which is what makes
+   * three layers deterministic in both.
+   */
+  async awaitFrameAt(local) {
+    if (!this._renderer || !this._scene || !this._camera || !this._ctx) return;
+    const spec = this._threeSpec;
+    const t = Math.max(0, Math.min(local, this.duration ?? local));
+    if (spec.update) {
+      try {
+        spec.update(t, this._ctx);
+      } catch (err) {
+        if (!this._warnedUpdate) {
+          this._warnedUpdate = true;
+          console.warn("pixi-effects: three update() threw (reported once) \u2014", err);
+        }
+      }
+    }
+    this._renderer.render(this._scene, this._camera);
+    this.target?.texture.source.update();
+  }
+  _resolveThreePath(path) {
+    const segs = path.split(".");
+    if (segs.length < 2) {
+      this._warnPath(path, "needs at least <object>.<prop>");
+      return null;
+    }
+    let obj = this._objects[segs[0]];
+    if (obj == null) {
+      this._warnPath(path, `unknown object "${segs[0]}" \u2014 expose it via setup's { objects }`);
+      return null;
+    }
+    for (let i = 1; i < segs.length - 1; i++) {
+      obj = obj[segs[i]];
+      if (obj == null) {
+        this._warnPath(path, `"${segs[i]}" is undefined along the path`);
+        return null;
+      }
+    }
+    const prop = segs[segs.length - 1];
+    if (typeof obj !== "object" || !(prop in obj)) {
+      this._warnPath(path, `no property "${prop}"`);
+      return null;
+    }
+    return { target: obj, prop };
+  }
+  _warnPath(path, why) {
+    if (this._warnedPaths.has(path)) return;
+    this._warnedPaths.add(path);
+    console.warn(`pixi-effects: keyframe path three.${path} ${why}; skipped`);
+  }
+  _disposeRenderer() {
+    if (!this._renderer) return;
+    try {
+      this._renderer.dispose();
+      this._renderer.forceContextLoss();
+    } catch (err) {
+      console.warn("pixi-effects: three renderer dispose threw \u2014", err);
+    }
+    this._renderer = null;
+  }
+  destroy() {
+    const spec = this._threeSpec;
+    if (this._ctx && spec.dispose) {
+      try {
+        spec.dispose(this._ctx);
+      } catch (err) {
+        console.warn("pixi-effects: three dispose() threw \u2014", err);
+      }
+    }
+    const texture = this.target?.texture;
+    this._disposeRenderer();
+    this._scene = null;
+    this._camera = null;
+    this._ctx = null;
+    this._objects = {};
+    super.destroy();
+    texture?.destroy(true);
+  }
+};
+function resolveDim(v, scope) {
+  if (v === void 0) return void 0;
+  if (typeof v === "number") return v;
+  return evaluateExpr(v, scope);
+}
+
+// src/three/index.ts
+function registerThree() {
+  registerSequenceType("three", ThreeSequence);
+}
+function three(spec) {
+  return spec;
+}
+
+export { ThreeSequence, registerThree, three };
+//# sourceMappingURL=three.js.map
+//# sourceMappingURL=three.js.map

package/dist/three.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/three/ThreeSequence.ts","../src/three/index.ts"],"names":[],"mappings":"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","file":"three.js","sourcesContent":["import { Sprite, Texture } from 'pixi.js';\nimport { PerspectiveCamera, Scene, WebGLRenderer, type Camera } from 'three';\nimport { Sequence } from '../sequences/Base';\nimport { buildScope } from '../expr/Scope';\nimport { evaluateExpr } from '../expr/Parser';\nimport type { PathRouters } from '../core/Timeline';\nimport type { PropValue } from '../types';\nimport type { ThreeContext, ThreeSequenceSpec } from './types';\n\nexport class ThreeSequence extends Sequence {\n  private _renderer: WebGLRenderer | null = null;\n  private _scene: Scene | null = null;\n  private _camera: Camera | null = null;\n  private _ctx: ThreeContext | null = null;\n  private _objects: Record<string, object> = {};\n  private _warnedUpdate = false;\n  private _warnedPaths = new Set<string>();\n\n  private get _threeSpec(): ThreeSequenceSpec {\n    return this.spec as unknown as ThreeSequenceSpec;\n  }\n\n  protected override pathRouters(): PathRouters {\n    return { three: (path) => this._resolveThreePath(path) };\n  }\n\n  async build(): Promise<void> {\n    const spec = this._threeSpec;\n    if (this.duration === undefined) {\n      this.duration = this.parent?.duration ?? this.root.duration;\n    }\n\n    // Resolve layer size. Expressions see the usual scope; intrinsic w/h are\n    // still 0 here (same chicken-and-egg as shapes), so W/H/GW/GH carry it.\n    const scope = buildScope(this, this.parent, this.root) as unknown as Record<string, number>;\n    const width = resolveDim(spec.width, scope) ?? this.parent?.width ?? this.root.width;\n    const height = resolveDim(spec.height, scope) ?? this.parent?.height ?? this.root.height;\n    const resolution = spec.resolution ?? 1;\n\n    // Offscreen canvas — never attached to the DOM. document.createElement\n    // (not OffscreenCanvas) so PIXI's Texture.from and three both accept it.\n    const canvas = document.createElement('canvas');\n    const renderer = new WebGLRenderer({ canvas, alpha: true, antialias: true });\n    this._renderer = renderer;\n    try {\n      renderer.setSize(Math.round(width * resolution), Math.round(height * resolution), false);\n      renderer.setClearColor(0x000000, 0);\n\n      const scene = new Scene();\n      const camera: Camera = new PerspectiveCamera(50, width / height, 0.1, 2000);\n      const ctx: ThreeContext = { scene, camera, renderer, width, height };\n\n      const result = await spec.setup(ctx);\n      if (result?.camera) ctx.camera = result.camera;\n      this._scene = scene;\n      this._camera = ctx.camera;\n      this._ctx = ctx;\n      this._objects = { ...(result?.objects ?? {}) };\n      if (!('camera' in this._objects)) this._objects.camera = this._camera;\n\n      // Frame 0 so the texture is never blank before the first tick.\n      renderer.render(scene, this._camera);\n\n      const texture = Texture.from(canvas);\n      const sprite = new Sprite({ texture, label: spec.name });\n      sprite.cullable = true;\n      // Texture is canvas-sized (layer px × resolution); scale back to comp px.\n      sprite.width = width;\n      sprite.height = height;\n      this.target = sprite;\n      this.intrinsicWidth = width;\n      this.intrinsicHeight = height;\n      this.buildFilters();\n    } catch (err) {\n      this._disposeRenderer();\n      throw err;\n    }\n  }\n\n  /**\n   * Per-frame sync hook. Movie._awaitVideoFrames duck-types on this method\n   * (same contract as VideoSequence) and awaits it inside gotoFrame — the\n   * single frame path shared by playback and export, which is what makes\n   * three layers deterministic in both.\n   */\n  async awaitFrameAt(local: number): Promise<void> {\n    if (!this._renderer || !this._scene || !this._camera || !this._ctx) return;\n    const spec = this._threeSpec;\n    const t = Math.max(0, Math.min(local, this.duration ?? local));\n    if (spec.update) {\n      try {\n        spec.update(t, this._ctx);\n      } catch (err) {\n        if (!this._warnedUpdate) {\n          this._warnedUpdate = true;\n          console.warn('pixi-effects: three update() threw (reported once) —', err);\n        }\n      }\n    }\n    this._renderer.render(this._scene, this._camera);\n    (this.target as Sprite | null)?.texture.source.update();\n  }\n\n  private _resolveThreePath(path: string): { target: object; prop: string } | null {\n    const segs = path.split('.');\n    if (segs.length < 2) {\n      this._warnPath(path, 'needs at least <object>.<prop>');\n      return null;\n    }\n    let obj: unknown = this._objects[segs[0]!];\n    if (obj == null) {\n      this._warnPath(path, `unknown object \"${segs[0]}\" — expose it via setup's { objects }`);\n      return null;\n    }\n    for (let i = 1; i < segs.length - 1; i++) {\n      obj = (obj as Record<string, unknown>)[segs[i]!];\n      if (obj == null) {\n        this._warnPath(path, `\"${segs[i]}\" is undefined along the path`);\n        return null;\n      }\n    }\n    const prop = segs[segs.length - 1]!;\n    if (typeof obj !== 'object' || !(prop in (obj as object))) {\n      this._warnPath(path, `no property \"${prop}\"`);\n      return null;\n    }\n    return { target: obj as object, prop };\n  }\n\n  private _warnPath(path: string, why: string): void {\n    if (this._warnedPaths.has(path)) return;\n    this._warnedPaths.add(path);\n    console.warn(`pixi-effects: keyframe path three.${path} ${why}; skipped`);\n  }\n\n  private _disposeRenderer(): void {\n    if (!this._renderer) return;\n    try {\n      this._renderer.dispose();\n      this._renderer.forceContextLoss();\n    } catch (err) {\n      console.warn('pixi-effects: three renderer dispose threw —', err);\n    }\n    this._renderer = null;\n  }\n\n  override destroy(): void {\n    const spec = this._threeSpec;\n    if (this._ctx && spec.dispose) {\n      try { spec.dispose(this._ctx); } catch (err) {\n        console.warn('pixi-effects: three dispose() threw —', err);\n      }\n    }\n    const texture = (this.target as Sprite | null)?.texture;\n    this._disposeRenderer();\n    this._scene = null;\n    this._camera = null;\n    this._ctx = null;\n    this._objects = {};\n    super.destroy();\n    texture?.destroy(true); // canvas-backed source is per-sequence; safe to kill\n  }\n}\n\nfunction resolveDim(v: PropValue | undefined, scope: Record<string, number>): number | undefined {\n  if (v === undefined) return undefined;\n  if (typeof v === 'number') return v;\n  return evaluateExpr(v, scope);\n}\n","/**\n * pixi-effects/three — optional three.js integration.\n *\n * Import this entry only when you use `type: 'three'` sequences; the core\n * `pixi-effects` entry never touches three.js. Call `registerThree()` once\n * before Movie.init builds a composition containing a three sequence.\n */\nimport { registerSequenceType, type SequenceCtor } from '../core/Composition';\nimport { ThreeSequence } from './ThreeSequence';\nimport type { SequenceSpec } from '../types';\nimport type { ThreeSequenceSpec } from './types';\n\nexport { ThreeSequence } from './ThreeSequence';\nexport type { ThreeContext, ThreeSetupResult, ThreeSequenceSpec } from './types';\n\n/** Register the 'three' sequence type. Idempotent; explicit call so `sideEffects: false` bundlers can't drop it. */\nexport function registerThree(): void {\n  registerSequenceType('three', ThreeSequence as unknown as SequenceCtor);\n}\n\n/**\n * Typing helper: accepts a strongly-typed three spec and returns it as a\n * core SequenceSpec, keeping three.js types out of the core union.\n */\nexport function three(spec: ThreeSequenceSpec): SequenceSpec {\n  return spec as unknown as SequenceSpec;\n}\n"]}