@motion-script/core 0.1.0

package/README.md

@@ -0,0 +1,69 @@
+# @motion-script/core
+
+The engine-agnostic animation library at the heart of [Motion Script](https://motionscript.dev).
+It provides the scene graph, generator-driven animation runtime, reactive
+signals, tweening, flex layout, and the JSX runtime used to describe scenes
+declaratively independent of any particular rendering backend.
+
+```tsx
+import { Scene, createRef, Rect, Ellipse } from '@motion-script/core';
+
+export class ShapeScene extends Scene {
+  *build() {
+    const lens = createRef<Ellipse>();
+
+    this.add(
+      <Rect width={400} height={400} fill="white" borderRadius={20}>
+        <Ellipse ref={lens} x={200} y={200} width={350} height={350} />
+      </Rect>,
+    );
+
+    yield* lens().to({ x: 700 }, 3);
+  }
+}
+```
+
+## What's in here
+
+- **Nodes** — the scene graph (`Scene`, `Rect`, `Ellipse`, `Txt`, paths, and
+  more) with attributes for fills, gradients, filters, and SkSL shader effects.
+- **Runtime** — drives animations from generators: `yield*` a tween or signal
+  change and the engine advances time, interpolating attributes frame by frame.
+- **Signals** — reactive values that nodes and tweens can depend on.
+- **Tweens** — interpolation and easing for animating attributes over time.
+- **Layout** — a flexbox-based layout system for positioning nodes.
+- **JSX runtime** — lets scenes be authored as TSX (`./jsx/jsx-runtime`,
+  `./jsx/jsx-dev-runtime`).
+- **Project / render / platform / assets** — the abstractions a rendering
+  backend (such as [`@motion-script/web`](../web)) implements to turn a scene
+  graph into pixels, audio, and exported video.
+
+This package has no rendering backend of its own — pair it with
+[`@motion-script/web`](../web) (Skia/CanvasKit) or build your own backend
+against the `platform`/`render` abstractions.
+
+## Usage
+
+```bash
+npm install @motion-script/core
+```
+
+For a guided setup, scaffold a project instead with:
+
+```bash
+npm create motion-script@latest
+```
+
+See the [docs](https://motionscript.dev/docs) for the full feature set and API
+reference.
+
+## Development
+
+From the monorepo root:
+
+```bash
+pnpm --filter @motion-script/core build
+pnpm --filter @motion-script/core test
+```
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for the architecture overview.

package/dist/assets/catalog.d.ts

@@ -0,0 +1,83 @@
+import { type AudioMeta, type FontMeta, type ImageMeta, AssetManifest, type VideoMeta } from "./manifest";
+/**
+ * A read-only query engine for retrieving strongly-typed asset metadata from an {@link AssetManifest}.
+ * * Use this class to safely extract dimensions, durations, and specific configurations for images,
+ * videos, audio files, and fonts, with built-in runtime validation.
+ * * @example
+ * ```ts
+ * import { AssetCatalog } from './catalog';
+ * import { manifest } from './generated-manifest';
+ * * const catalog = new AssetCatalog(manifest);
+ * const dimensions = catalog.getImageSize("hero-banner.png");
+ * console.log(dimensions.width); // 1920
+ * ```
+ */
+export declare class AssetCatalog {
+    private manifest;
+    /**
+     * Creates an instance of AssetCatalog.
+     * @param manifest - The underlying immutable asset manifest lookup structure.
+     */
+    constructor(manifest: AssetManifest);
+    /**
+     * Retrieves the complete metadata object for a specified image.
+     * * @param src - The unique source path or identifier of the image asset.
+     * @returns The associated {@link ImageMeta} block.
+     * @throws {Error} If the image resource does not exist in the manifest.
+     */
+    getImageMeta(src: string): ImageMeta;
+    /**
+     * Retrieves the complete metadata object for a specified video.
+     * * @param src - The unique source path or identifier of the video asset.
+     * @returns The associated {@link VideoMeta} block.
+     * @throws {Error} If the video resource does not exist in the manifest.
+     */
+    getVideoMeta(src: string): VideoMeta;
+    /**
+     * Retrieves the complete metadata object for a specified audio track.
+     * * @param src - The unique source path or identifier of the audio asset.
+     * @returns The associated {@link AudioMeta} block.
+     * @throws {Error} If the audio resource does not exist in the manifest.
+     */
+    getAudioMeta(src: string): AudioMeta;
+    /**
+     * Retrieves the complete metadata object for a specified font face.
+     * * @param key - The unique lookup key or family name of the font asset.
+     * @returns The associated {@link FontMeta} block.
+     * @throws {Error} If the font resource key does not exist in the manifest.
+     */
+    getFontMeta(key: string): FontMeta;
+    /**
+     * Return every font face registered for a family, across all weights and
+     * slants. Used to register the whole family with the renderer so the font
+     * matcher can resolve any requested weight to its nearest available file.
+     * @param fontFamily - The font family name (e.g. "Inter").
+     * @returns All matching {@link FontMeta} entries; empty if the family is unknown.
+     */
+    getFontFamilyMetas(fontFamily: string): FontMeta[];
+    /**
+     * Convenient shortcut to get the exact playback duration of a video asset.
+     * * @param src - The unique source path or identifier of the video asset.
+     * @returns The duration of the video in seconds (or frames, depending on manifest standard).
+     * @throws {Error} Inherits the missing asset error from {@link getVideoMeta}.
+     */
+    getVideoDuration(src: string): number;
+    /**
+     * Convenient shortcut to get the exact playback duration of an audio asset.
+     * * @param src - The unique source path or identifier of the audio asset.
+     * @returns The duration of the audio in seconds.
+     * @throws {Error} Inherits the missing asset error from {@link getAudioMeta}.
+     */
+    getAudioDuration(src: string): number;
+    /**
+     * Convenient shortcut to isolate the structural layout dimensions of an image asset.
+     * * @param src - The unique source path or identifier of the image asset.
+     * @returns An object containing the `width` and `height` dimensions of the asset.
+     * @throws {Error} Inherits the missing asset error from {@link getImageMeta}.
+     */
+    getImageSize(src: string): {
+        width: number;
+        height: number;
+    };
+}
+//# sourceMappingURL=catalog.d.ts.map

package/dist/assets/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/assets/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE1G;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IAKT,OAAO,CAAC,QAAQ;IAJ5B;;;OAGG;gBACiB,QAAQ,EAAE,aAAa;IAE3C;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAMpC;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAMpC;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAMpC;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ;IAMlC;;;;;;OAMG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE;IAIlD;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrC;;;;;OAKG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrC;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAI/D"}

package/dist/assets/catalog.js

@@ -0,0 +1,110 @@
+/**
+ * A read-only query engine for retrieving strongly-typed asset metadata from an {@link AssetManifest}.
+ * * Use this class to safely extract dimensions, durations, and specific configurations for images,
+ * videos, audio files, and fonts, with built-in runtime validation.
+ * * @example
+ * ```ts
+ * import { AssetCatalog } from './catalog';
+ * import { manifest } from './generated-manifest';
+ * * const catalog = new AssetCatalog(manifest);
+ * const dimensions = catalog.getImageSize("hero-banner.png");
+ * console.log(dimensions.width); // 1920
+ * ```
+ */
+export class AssetCatalog {
+    manifest;
+    /**
+     * Creates an instance of AssetCatalog.
+     * @param manifest - The underlying immutable asset manifest lookup structure.
+     */
+    constructor(manifest) {
+        this.manifest = manifest;
+    }
+    /**
+     * Retrieves the complete metadata object for a specified image.
+     * * @param src - The unique source path or identifier of the image asset.
+     * @returns The associated {@link ImageMeta} block.
+     * @throws {Error} If the image resource does not exist in the manifest.
+     */
+    getImageMeta(src) {
+        const meta = this.manifest.image[src];
+        if (!meta)
+            throw new Error(`No image metadata for src: ${src}`);
+        return meta;
+    }
+    /**
+     * Retrieves the complete metadata object for a specified video.
+     * * @param src - The unique source path or identifier of the video asset.
+     * @returns The associated {@link VideoMeta} block.
+     * @throws {Error} If the video resource does not exist in the manifest.
+     */
+    getVideoMeta(src) {
+        const meta = this.manifest.video[src];
+        if (!meta)
+            throw new Error(`No video metadata for src: ${src}`);
+        return meta;
+    }
+    /**
+     * Retrieves the complete metadata object for a specified audio track.
+     * * @param src - The unique source path or identifier of the audio asset.
+     * @returns The associated {@link AudioMeta} block.
+     * @throws {Error} If the audio resource does not exist in the manifest.
+     */
+    getAudioMeta(src) {
+        const meta = this.manifest.audio[src];
+        if (!meta)
+            throw new Error(`No audio metadata for src: ${src}`);
+        return meta;
+    }
+    /**
+     * Retrieves the complete metadata object for a specified font face.
+     * * @param key - The unique lookup key or family name of the font asset.
+     * @returns The associated {@link FontMeta} block.
+     * @throws {Error} If the font resource key does not exist in the manifest.
+     */
+    getFontMeta(key) {
+        const meta = this.manifest.font[key];
+        if (!meta)
+            throw new Error(`No font metadata for key: ${key}`);
+        return meta;
+    }
+    /**
+     * Return every font face registered for a family, across all weights and
+     * slants. Used to register the whole family with the renderer so the font
+     * matcher can resolve any requested weight to its nearest available file.
+     * @param fontFamily - The font family name (e.g. "Inter").
+     * @returns All matching {@link FontMeta} entries; empty if the family is unknown.
+     */
+    getFontFamilyMetas(fontFamily) {
+        return Object.values(this.manifest.font).filter(meta => meta.fontFamily === fontFamily);
+    }
+    /**
+     * Convenient shortcut to get the exact playback duration of a video asset.
+     * * @param src - The unique source path or identifier of the video asset.
+     * @returns The duration of the video in seconds (or frames, depending on manifest standard).
+     * @throws {Error} Inherits the missing asset error from {@link getVideoMeta}.
+     */
+    getVideoDuration(src) {
+        return this.getVideoMeta(src).duration;
+    }
+    /**
+     * Convenient shortcut to get the exact playback duration of an audio asset.
+     * * @param src - The unique source path or identifier of the audio asset.
+     * @returns The duration of the audio in seconds.
+     * @throws {Error} Inherits the missing asset error from {@link getAudioMeta}.
+     */
+    getAudioDuration(src) {
+        return this.getAudioMeta(src).duration;
+    }
+    /**
+     * Convenient shortcut to isolate the structural layout dimensions of an image asset.
+     * * @param src - The unique source path or identifier of the image asset.
+     * @returns An object containing the `width` and `height` dimensions of the asset.
+     * @throws {Error} Inherits the missing asset error from {@link getImageMeta}.
+     */
+    getImageSize(src) {
+        const { width, height } = this.getImageMeta(src);
+        return { width, height };
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/assets/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/assets/catalog.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IAKD;IAJpB;;;OAGG;IACH,YAAoB,QAAuB;QAAvB,aAAQ,GAAR,QAAQ,CAAe;IAAI,CAAC;IAEhD;;;;;OAKG;IACH,YAAY,CAAC,GAAW;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,GAAW;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,GAAW;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,GAAW;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACH,kBAAkB,CAAC,UAAkB;QACjC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,GAAW;QACxB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,GAAW;QACxB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC3C,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,GAAW;QACpB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACjD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;CACJ"}

package/dist/assets/index.d.ts

@@ -0,0 +1,5 @@
+export { AssetCatalog } from "./catalog";
+export type { ImageMeta, VideoMeta, AudioMeta, FontMeta, AssetMeta, AssetManifest } from "./manifest";
+export { AssetTracker, type LoaderFunction } from "./tracker";
+export { AssetManager } from "./manager";
+//# sourceMappingURL=index.d.ts.map

package/dist/assets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/assets/index.js

@@ -0,0 +1,4 @@
+export { AssetCatalog } from "./catalog";
+export { AssetTracker } from "./tracker";
+export { AssetManager } from "./manager";
+//# sourceMappingURL=index.js.map

package/dist/assets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/assets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAuB,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/assets/manager.d.ts

@@ -0,0 +1,32 @@
+import { AudioDevice } from "../platform/audio-device";
+import { StorageAdapter } from "../platform/storage-adapter";
+import { PrecompResult } from "../runtime/precompisition";
+/**
+ * Coordinates asset loading and audio synchronization during playback.
+ * Wraps a {@link PrecompResult} and delegates storage/audio work to platform adapters.
+ */
+export declare class AssetManager {
+    private readonly precomp;
+    private readonly storageAdapter;
+    private readonly audioDevice;
+    private lastAudioRequestKey;
+    private lastAudioSrcs;
+    private audioFetching;
+    constructor(precomp: PrecompResult, storageAdapter: StorageAdapter, audioDevice: AudioDevice);
+    /**
+     * Blocking load for seek and initial render. Waits for every asset whose
+     * cacheAt <= frame and endFrame >= frame to be ready, then schedules audio.
+     */
+    loadAt(frame: number): Promise<void>;
+    /**
+     * Non-blocking incremental prefetch called after each render tick. Fires
+     * loads for assets whose cacheAt window has been reached without blocking.
+     */
+    prefetch(frame: number): void;
+    /**
+     * Push the current audio working set to the AudioDevice. Called after each
+     * render tick so the device stays in sync with the scene's audio requests.
+     */
+    syncAudio(frame: number): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/assets/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/assets/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C,OAAO,CAAC,mBAAmB,CAAc;IACzC,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,aAAa,CAAoC;gBAGrD,OAAO,EAAE,aAAa,EACtB,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,WAAW;IAS5B;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU7B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CA4CjC"}

package/dist/assets/manager.js

@@ -0,0 +1,108 @@
+/**
+ * Coordinates asset loading and audio synchronization during playback.
+ * Wraps a {@link PrecompResult} and delegates storage/audio work to platform adapters.
+ */
+export class AssetManager {
+    precomp;
+    storageAdapter;
+    audioDevice;
+    lastAudioRequestKey = "";
+    lastAudioSrcs = new Set();
+    audioFetching = new Map();
+    constructor(precomp, storageAdapter, audioDevice) {
+        this.precomp = precomp;
+        this.storageAdapter = storageAdapter;
+        this.audioDevice = audioDevice;
+    }
+    // ─── Public surface ───────────────────────────────────────────────────────
+    /**
+     * Blocking load for seek and initial render. Waits for every asset whose
+     * cacheAt <= frame and endFrame >= frame to be ready, then schedules audio.
+     */
+    async loadAt(frame) {
+        const jobs = [];
+        for (const [key, track] of this.precomp.assets) {
+            if (track.cacheAt <= frame && track.record.endFrame >= frame) {
+                jobs.push(this.storageAdapter.loadAsset(key, track.record));
+            }
+        }
+        await Promise.all(jobs);
+        this.syncAudio(frame);
+    }
+    /**
+     * Non-blocking incremental prefetch called after each render tick. Fires
+     * loads for assets whose cacheAt window has been reached without blocking.
+     */
+    prefetch(frame) {
+        for (const [key, track] of this.precomp.assets) {
+            if (track.cacheAt <= frame && track.record.endFrame >= frame) {
+                this.storageAdapter.loadAsset(key, track.record).catch(err => {
+                    console.error(`[AssetManager] prefetch failed for ${key}:`, err);
+                });
+            }
+        }
+    }
+    /**
+     * Push the current audio working set to the AudioDevice. Called after each
+     * render tick so the device stays in sync with the scene's audio requests.
+     */
+    syncAudio(frame) {
+        const currentTime = frame / this.precomp.fps;
+        const inWindow = [];
+        const srcs = new Set();
+        const seen = new Set();
+        for (const scene of this.precomp.scenes) {
+            const sceneOffsetSecs = scene.startFrame / this.precomp.fps;
+            for (const req of scene.audioRequests) {
+                const globalStart = sceneOffsetSecs + req.startAt;
+                const globalEnd = sceneOffsetSecs + req.endAt;
+                if (globalEnd < currentTime || globalStart > currentTime + 10)
+                    continue;
+                const stableId = stableKey(req, sceneOffsetSecs);
+                if (seen.has(stableId))
+                    continue;
+                seen.add(stableId);
+                inWindow.push({ ...req, id: stableId, startAt: globalStart, endAt: globalEnd });
+                srcs.add(req.src);
+            }
+        }
+        for (const src of srcs) {
+            if (!this.audioDevice.has(src) && !this.audioFetching.has(src)) {
+                const job = this.storageAdapter.fetchAudioData(src)
+                    .then(data => this.audioDevice.append(src, data))
+                    .finally(() => this.audioFetching.delete(src));
+                this.audioFetching.set(src, job);
+            }
+        }
+        const requestKey = audioSignature(inWindow);
+        if (requestKey !== this.lastAudioRequestKey) {
+            this.audioDevice.schedule(inWindow);
+            this.lastAudioRequestKey = requestKey;
+        }
+        if (!setsEqual(this.lastAudioSrcs, srcs)) {
+            this.audioDevice.retain(srcs);
+            this.lastAudioSrcs = srcs;
+        }
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/** Produce a deterministic string key that uniquely identifies an audio request's playback identity. */
+function stableKey(req, sceneOffsetSecs) {
+    return `${req.src}|${sceneOffsetSecs + req.startAt}|${sceneOffsetSecs + req.endAt}|${req.trimStart}|${req.loop ? 1 : 0}|${req.volume}`;
+}
+/** Produce a stable hash of the active audio request set to detect scheduling changes. */
+function audioSignature(reqs) {
+    if (reqs.length === 0)
+        return "";
+    return reqs.map(r => r.id).sort().join("\n");
+}
+/** Shallow equality check for two string sets (order-independent). */
+function setsEqual(a, b) {
+    if (a.size !== b.size)
+        return false;
+    for (const v of a)
+        if (!b.has(v))
+            return false;
+    return true;
+}
+//# sourceMappingURL=manager.js.map

package/dist/assets/manager.js.map

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

package/dist/assets/manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manager.test.d.ts.map

package/dist/assets/manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.test.d.ts","sourceRoot":"","sources":["../../src/assets/manager.test.ts"],"names":[],"mappings":""}

package/dist/assets/manager.test.js

@@ -0,0 +1,133 @@
+import { describe, it, expect, vi } from 'vitest';
+import { AssetManager } from '@/assets/manager';
+import { FakeStorageAdapter, FakeAudioDevice, asStorage, makePrecompResult, makeScenePrecomp, makeAssetTrack, makeImageRecord, makeAudioRequest, } from '../runtime/runtime.fixtures';
+const flush = () => new Promise((r) => setTimeout(r, 0));
+function setup(precomp = makePrecompResult({ scenes: [] })) {
+    const storage = new FakeStorageAdapter();
+    const audio = new FakeAudioDevice();
+    const mgr = new AssetManager(precomp, asStorage(storage), audio);
+    return { mgr, storage, audio };
+}
+describe('AssetManager.loadAt', () => {
+    const assets = new Map([
+        ['a', makeAssetTrack({ cacheAt: 0, record: makeImageRecord({ src: 'a', endFrame: 10 }) })],
+        ['b', makeAssetTrack({ cacheAt: 20, record: makeImageRecord({ src: 'b', endFrame: 30 }) })],
+        ['c', makeAssetTrack({ cacheAt: 0, record: makeImageRecord({ src: 'c', endFrame: 2 }) })],
+    ]);
+    it('loads only assets whose [cacheAt, endFrame] window contains the frame', async () => {
+        const { mgr, storage } = setup(makePrecompResult({ assets, scenes: [] }));
+        await mgr.loadAt(5);
+        expect(storage.loadAssetCalls.map((c) => c.key)).toEqual(['a']);
+    });
+    it('loads an asset whose cacheAt window has just opened', async () => {
+        const { mgr, storage } = setup(makePrecompResult({ assets, scenes: [] }));
+        await mgr.loadAt(25); // a: endFrame 10 < 25 (out); b: cacheAt20<=25, endFrame30>=25 (in); c: out
+        expect(storage.loadAssetCalls.map((c) => c.key)).toEqual(['b']);
+    });
+    it('resolves with no work when nothing is in range', async () => {
+        const { mgr, storage } = setup(makePrecompResult({ assets, scenes: [] }));
+        await mgr.loadAt(15); // a out (10<15), b not yet (20>15), c out
+        expect(storage.loadAssetCalls).toHaveLength(0);
+    });
+});
+describe('AssetManager.prefetch', () => {
+    it('fires loads for in-window assets without awaiting', () => {
+        const assets = new Map([
+            ['a', makeAssetTrack({ cacheAt: 0, record: makeImageRecord({ src: 'a', endFrame: 10 }) })],
+        ]);
+        const { mgr, storage } = setup(makePrecompResult({ assets, scenes: [] }));
+        mgr.prefetch(5);
+        expect(storage.loadAssetCalls.map((c) => c.key)).toEqual(['a']);
+    });
+    it('swallows load rejections (logs instead of throwing)', async () => {
+        const assets = new Map([
+            ['a', makeAssetTrack({ cacheAt: 0, record: makeImageRecord({ src: 'a', endFrame: 10 }) })],
+        ]);
+        const { mgr, storage } = setup(makePrecompResult({ assets, scenes: [] }));
+        storage.loadShouldReject = true;
+        const errSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        expect(() => mgr.prefetch(5)).not.toThrow();
+        await flush();
+        expect(errSpy).toHaveBeenCalled();
+        errSpy.mockRestore();
+    });
+});
+describe('AssetManager.syncAudio', () => {
+    function precompWith(requests, startFrame = 0, fps = 10) {
+        return makePrecompResult({
+            fps,
+            scenes: [makeScenePrecomp({ startFrame, audioRequests: requests })],
+        });
+    }
+    it('schedules and retains a request that falls within the look-ahead window', () => {
+        const req = makeAudioRequest({ id: 'r1', src: 's1', startAt: 0, endAt: 1 });
+        const { mgr, audio, storage } = setup(precompWith([req]));
+        mgr.syncAudio(0);
+        expect(audio.scheduleCalls).toHaveLength(1);
+        expect(audio.scheduleCalls[0][0].src).toBe('s1');
+        expect(audio.retainCalls).toHaveLength(1);
+        expect([...audio.retainCalls[0]]).toEqual(['s1']);
+        // Not yet cached → triggers a fetch.
+        expect(storage.fetchAudioCalls).toEqual(['s1']);
+    });
+    it('rewrites request timing into global (scene-offset) seconds', () => {
+        const req = makeAudioRequest({ id: 'r1', src: 's1', startAt: 1, endAt: 2 });
+        // Scene starts at frame 10 (= 1s at 10fps), so global start = 1 + 1 = 2s.
+        const { mgr, audio } = setup(precompWith([req], 10, 10));
+        mgr.syncAudio(20); // currentTime = 2s
+        const scheduled = audio.scheduleCalls[0][0];
+        expect(scheduled.startAt).toBeCloseTo(2, 6);
+        expect(scheduled.endAt).toBeCloseTo(3, 6);
+    });
+    it('excludes requests that have already ended', () => {
+        const req = makeAudioRequest({ id: 'r1', src: 's1', startAt: 0, endAt: 1 });
+        const { mgr, audio } = setup(precompWith([req]));
+        mgr.syncAudio(50); // currentTime = 5s, request ended at 1s
+        expect(audio.scheduleCalls).toHaveLength(0);
+    });
+    it('excludes requests more than 10s beyond the current time', () => {
+        const req = makeAudioRequest({ id: 'r1', src: 's1', startAt: 100, endAt: 101 });
+        const { mgr, audio } = setup(precompWith([req]));
+        mgr.syncAudio(0);
+        expect(audio.scheduleCalls).toHaveLength(0);
+    });
+    it('does not fetch audio data already cached on the device', () => {
+        const req = makeAudioRequest({ id: 'r1', src: 's1', startAt: 0, endAt: 1 });
+        const { mgr, audio, storage } = setup(precompWith([req]));
+        audio.seed('s1');
+        mgr.syncAudio(0);
+        expect(storage.fetchAudioCalls).toHaveLength(0);
+    });
+    it('does not reschedule when the active window is unchanged', () => {
+        const req = makeAudioRequest({ id: 'r1', src: 's1', startAt: 0, endAt: 1 });
+        const { mgr, audio } = setup(precompWith([req]));
+        mgr.syncAudio(0);
+        mgr.syncAudio(0); // identical window
+        expect(audio.scheduleCalls).toHaveLength(1);
+        expect(audio.retainCalls).toHaveLength(1);
+    });
+    it('reschedules and re-retains when the window changes', () => {
+        const r1 = makeAudioRequest({ id: 'r1', src: 's1', startAt: 0, endAt: 1 });
+        const r2 = makeAudioRequest({ id: 'r2', src: 's2', startAt: 20, endAt: 21 });
+        const { mgr, audio } = setup(precompWith([r1, r2]));
+        mgr.syncAudio(0); // window = [r1] (r2 too far ahead)
+        mgr.syncAudio(150); // window = [r2] (r1 ended, r2 now near)
+        expect(audio.scheduleCalls).toHaveLength(2);
+        expect(audio.scheduleCalls[1][0].src).toBe('s2');
+        expect(audio.retainCalls).toHaveLength(2);
+    });
+    it('deduplicates identical requests emitted by multiple scenes', () => {
+        const shared = makeAudioRequest({ id: 'dup', src: 's1', startAt: 0, endAt: 1 });
+        const precomp = makePrecompResult({
+            fps: 10,
+            scenes: [
+                makeScenePrecomp({ startFrame: 0, audioRequests: [{ ...shared }] }),
+                makeScenePrecomp({ startFrame: 0, audioRequests: [{ ...shared }] }),
+            ],
+        });
+        const { mgr, audio } = setup(precomp);
+        mgr.syncAudio(0);
+        expect(audio.scheduleCalls[0]).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=manager.test.js.map

package/dist/assets/manager.test.js.map

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

package/dist/assets/manifest.d.ts

@@ -0,0 +1,38 @@
+/** Static metadata for an image asset, captured at build time. */
+export interface ImageMeta {
+    width: number;
+    height: number;
+    sizeBytes: number;
+    src: string;
+}
+/** Static metadata for a video asset, captured at build time. */
+export interface VideoMeta {
+    width: number;
+    height: number;
+    duration: number;
+    sizeBytes: number;
+    src: string;
+}
+/** Static metadata for an audio asset, captured at build time. */
+export interface AudioMeta {
+    duration: number;
+    sizeBytes: number;
+    src: string;
+}
+/** Static metadata for a font face, captured at build time. */
+export interface FontMeta {
+    fontFamily: string;
+    fontWeight: number;
+    src: string;
+    sizeBytes: number;
+}
+/** Discriminated union of all asset metadata shapes. */
+export type AssetMeta = ImageMeta | VideoMeta | AudioMeta | FontMeta;
+/** Build-time asset manifest keyed by source path (images/videos/audio) or family@weight (fonts). */
+export interface AssetManifest {
+    image: Record<string, ImageMeta>;
+    video: Record<string, VideoMeta>;
+    audio: Record<string, AudioMeta>;
+    font: Record<string, FontMeta>;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/assets/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/assets/manifest.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,SAAS;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACf;AAED,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErE,qGAAqG;AACrG,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAClC"}