@motion-script/core 0.1.0

package/dist/nodes/text/richtext-node.d.ts

@@ -0,0 +1,46 @@
+import { TextAlign } from "../../attributes/text/align";
+import { RenderContext } from "../../render/render-context";
+import { SizeConstraints } from "../../attributes/layout/constraints";
+import { MeasureScope } from "../../render/measure-scope";
+import { Size2D } from "../../attributes/layout/size";
+import { AssetTracker } from "../../assets/tracker";
+import { ShapeNode, ShapeProps } from "../geometry/shape-node";
+import { NodeConfig } from "../base/node";
+import { FontStyle, ResolvedTextSpan, TextSpan } from "../../attributes/text/span";
+export interface RichTextProps extends ShapeProps {
+    spans: TextSpan | TextSpan[];
+    /** Default font family inherited by spans that don't set one. */
+    fontFamily: string;
+    /** Default font size inherited by spans that don't set one. */
+    fontSize: number;
+    /** Default font weight inherited by spans that don't set one. */
+    fontWeight: number;
+    /** Default font style inherited by spans that don't set one. */
+    fontStyle: FontStyle;
+    /** Default letter spacing inherited by spans that don't set one. */
+    letterSpacing: number;
+    /** Line height multiplier applied to each run's font size. */
+    lineHeight: number;
+    align: TextAlign;
+}
+export declare class RichText extends ShapeNode<RichTextProps> {
+    readonly spans: TextSpan[];
+    readonly fontFamily: string;
+    readonly fontSize: number;
+    readonly fontWeight: number;
+    readonly fontStyle: FontStyle;
+    readonly letterSpacing: number;
+    readonly lineHeight: number;
+    readonly align: TextAlign;
+    constructor(props: NodeConfig<RichText, RichTextProps>);
+    prepare(storage: AssetTracker): void;
+    /**
+     * Flatten the nested span tree against this node's defaults, returning
+     * leaf runs in document order. Children inherit any style fields the
+     * parent set; explicit fields on a child override them.
+     */
+    runs(): ResolvedTextSpan[];
+    measure(constraints: SizeConstraints, scope: MeasureScope): Partial<Size2D>;
+    protected renderSelf(ctx: RenderContext): void;
+}
+//# sourceMappingURL=richtext-node.d.ts.map

package/dist/nodes/text/richtext-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richtext-node.d.ts","sourceRoot":"","sources":["../../../src/nodes/text/richtext-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAG/E,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC7C,KAAK,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAC7B,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,SAAS,EAAE,SAAS,CAAC;IACrB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;CACpB;AAED,qBAAa,QAAS,SAAQ,SAAS,CAAC,aAAa,CAAC;IAIlD,SAIoB,KAAK,EAAE,QAAQ,EAAE,CAAC;IACtC,SAAiD,UAAU,EAAE,MAAM,CAAC;IACpE,SAA4C,QAAQ,EAAE,MAAM,CAAC;IAC7D,SAA6C,UAAU,EAAE,MAAM,CAAC;IAChE,SAAkD,SAAS,EAAE,SAAS,CAAC;IACvE,SAA2C,aAAa,EAAE,MAAM,CAAC;IACjE,SAA6C,UAAU,EAAE,MAAM,CAAC;IAChE,SAAkD,KAAK,EAAE,SAAS,CAAC;gBAEvD,KAAK,EAAE,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC;IAMtD,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAWpC;;;;OAIG;IACH,IAAI,IAAI,gBAAgB,EAAE;IAyC1B,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;cA+CxD,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;CAS1D"}

package/dist/nodes/text/richtext-node.js

@@ -0,0 +1,155 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { resolveFillArray } from "../../attributes/shape/fill/registry";
+import { resolveStrokeArray } from "../../attributes/shape/stroke/mapper";
+import { ShapeNode } from "../geometry/shape-node";
+import { property } from "../../attributes/properties/decorator";
+export class RichText extends ShapeNode {
+    constructor(props) {
+        super(props);
+        this.applyProp("height", props.height ?? "hug");
+        this.applyProp("width", props.width ?? "hug");
+    }
+    prepare(storage) {
+        super.prepare(storage);
+        const seen = new Set();
+        for (const run of this.runs()) {
+            const key = `${run.fontFamily}@${run.fontWeight}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            storage.requestFont(run.fontFamily, run.fontWeight.toString());
+        }
+    }
+    /**
+     * Flatten the nested span tree against this node's defaults, returning
+     * leaf runs in document order. Children inherit any style fields the
+     * parent set; explicit fields on a child override them.
+     */
+    runs() {
+        const out = [];
+        const base = {
+            fontFamily: this.fontFamily,
+            fontSize: this.fontSize,
+            fontWeight: this.fontWeight,
+            fontStyle: this.fontStyle,
+            letterSpacing: this.letterSpacing,
+            fill: this.fill,
+            stroke: this.stroke,
+        };
+        const walk = (span, inherited) => {
+            const merged = {
+                fontFamily: span.fontFamily ?? inherited.fontFamily,
+                fontSize: span.fontSize ?? inherited.fontSize,
+                fontWeight: span.fontWeight ?? inherited.fontWeight,
+                fontStyle: span.fontStyle ?? inherited.fontStyle,
+                letterSpacing: span.letterSpacing ?? inherited.letterSpacing,
+                fill: span.fill != null ? resolveFillArray(span.fill) : inherited.fill,
+                stroke: span.stroke != null ? resolveStrokeArray(span.stroke) : inherited.stroke,
+            };
+            if (span.text) {
+                out.push({
+                    text: span.text,
+                    fontFamily: merged.fontFamily,
+                    fontSize: merged.fontSize,
+                    fontWeight: merged.fontWeight,
+                    fontStyle: merged.fontStyle,
+                    letterSpacing: merged.letterSpacing,
+                    fill: merged.fill,
+                    stroke: merged.stroke,
+                });
+            }
+            if (span.children) {
+                for (const child of span.children)
+                    walk(child, merged);
+            }
+        };
+        for (const span of this.spans)
+            walk(span, base);
+        return out;
+    }
+    measure(constraints, scope) {
+        const runs = this.runs();
+        let lineW = 0;
+        let maxLineH = 0;
+        let totalW = 0;
+        let totalH = 0;
+        const finishLine = () => {
+            if (lineW > totalW)
+                totalW = lineW;
+            totalH += maxLineH;
+            lineW = 0;
+            maxLineH = 0;
+        };
+        for (const run of runs) {
+            const lh = run.fontSize * this.lineHeight;
+            const segments = run.text.split("\n");
+            for (let i = 0; i < segments.length; i++) {
+                if (i > 0)
+                    finishLine();
+                if (segments[i].length > 0) {
+                    lineW += scope.measureText(segments[i], run.fontSize, run.fontFamily, run.fontWeight, run.letterSpacing, run.fontStyle);
+                }
+                if (lh > maxLineH)
+                    maxLineH = lh;
+            }
+        }
+        finishLine();
+        if (totalH === 0)
+            totalH = this.fontSize * this.lineHeight;
+        const wm = this.width;
+        const hm = this.height;
+        const resolvedW = typeof wm === "number"
+            ? wm
+            : wm === "hug"
+                ? totalW
+                : constraints.maxWidth ?? 0;
+        const resolvedH = typeof hm === "number"
+            ? hm
+            : hm === "hug"
+                ? totalH
+                : constraints.maxHeight ?? 0;
+        return { width: resolvedW, height: resolvedH };
+    }
+    renderSelf(ctx) {
+        ctx.richText({
+            spans: this.runs(),
+            lineHeight: this.lineHeight,
+            align: this.align,
+            width: this.layoutRect?.width ?? 0,
+            height: this.layoutRect?.height ?? 0,
+        });
+    }
+}
+__decorate([
+    property({
+        default: [],
+        mapper: (v) => v == null ? [] : Array.isArray(v) ? v : [v],
+    })
+], RichText.prototype, "spans", void 0);
+__decorate([
+    property({ default: "Inter" })
+], RichText.prototype, "fontFamily", void 0);
+__decorate([
+    property({ default: 16 })
+], RichText.prototype, "fontSize", void 0);
+__decorate([
+    property({ default: 400 })
+], RichText.prototype, "fontWeight", void 0);
+__decorate([
+    property({ default: 'normal' })
+], RichText.prototype, "fontStyle", void 0);
+__decorate([
+    property({ default: 0 })
+], RichText.prototype, "letterSpacing", void 0);
+__decorate([
+    property({ default: 1.2 })
+], RichText.prototype, "lineHeight", void 0);
+__decorate([
+    property({ default: 'center' })
+], RichText.prototype, "align", void 0);
+//# sourceMappingURL=richtext-node.js.map

package/dist/nodes/text/richtext-node.js.map

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

package/dist/nodes/text/text-node.d.ts

@@ -0,0 +1,42 @@
+import { TextAlign } from "../../attributes/text/align";
+import { FontStyle } from "../../attributes/text/span";
+import { ShapeNode, ShapeProps } from "../geometry/shape-node";
+import { NodeConfig } from "../base/node";
+import { AssetTracker } from "../../assets/tracker";
+import { SizeConstraints } from "../../attributes/layout/constraints";
+import { MeasureScope } from "../../render/measure-scope";
+import { Size2D } from "../../attributes/layout/size";
+import { EaseFunction } from "../../tween/ease/type";
+import { FrameGenerator } from "../../tween/generator";
+import { RenderContext } from "../../render/render-context";
+export interface TextProps extends ShapeProps {
+    text: string;
+    fontSize: number | 'autofit';
+    fontFamily: string;
+    fontWeight: number;
+    fontStyle: FontStyle;
+    letterSpacing: number;
+    lineHeight: number;
+    align: TextAlign;
+    wrap: boolean;
+    minFontSize: number;
+}
+export declare class Text extends ShapeNode<TextProps> {
+    readonly text: string;
+    readonly fontFamily: string;
+    readonly fontSize: number | 'autofit';
+    readonly fontWeight: number;
+    readonly fontStyle: FontStyle;
+    readonly letterSpacing: number;
+    readonly lineHeight: number;
+    readonly align: TextAlign;
+    readonly wrap: boolean;
+    readonly minFontSize: number;
+    constructor(props: NodeConfig<Text, TextProps>);
+    prepare(storage: AssetTracker): void;
+    measure(constraints: SizeConstraints, scope: MeasureScope): Partial<Size2D>;
+    append(text: string, duration: number, easing?: EaseFunction): FrameGenerator;
+    prepend(text: string, duration: number, easing?: EaseFunction): FrameGenerator;
+    protected renderSelf(ctx: RenderContext): void;
+}
+//# sourceMappingURL=text-node.d.ts.map

package/dist/nodes/text/text-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-node.d.ts","sourceRoot":"","sources":["../../../src/nodes/text/text-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,MAAM,WAAW,SAAU,SAAQ,UAAU;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACvB;AAGD,qBAAa,IAAK,SAAQ,SAAS,CAAC,SAAS,CAAC;IAI1C,SAA2E,IAAI,EAAE,MAAM,CAAC;IACxF,SAA+D,UAAU,EAAE,MAAM,CAAC;IAClF,SAA0D,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACvF,SAA2D,UAAU,EAAE,MAAM,CAAC;IAC9E,SAAgE,SAAS,EAAE,SAAS,CAAC;IACrF,SAAyD,aAAa,EAAE,MAAM,CAAC;IAC/E,SAA2D,UAAU,EAAE,MAAM,CAAC;IAC9E,SAAgE,KAAK,EAAE,SAAS,CAAC;IACjF,SAA6D,IAAI,EAAE,OAAO,CAAC;IAC3E,SAA0D,WAAW,EAAE,MAAM,CAAC;gBAElE,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC;IAQ9C,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIpC,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IA+B1E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc;IAI7E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,cAAc;cAI5D,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;CAkB1D"}

package/dist/nodes/text/text-node.js

@@ -0,0 +1,123 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { lerpText } from "../../attributes/text/lerp";
+import { ShapeNode } from "../geometry/shape-node";
+import { property } from "../../attributes/properties/decorator";
+export class Text extends ShapeNode {
+    constructor(props) {
+        super(props);
+        const autofit = props.fontSize === 'autofit';
+        this.applyProp("height", props.height ?? (autofit || props.wrap ? "fill" : "hug"));
+        this.applyProp("width", props.width ?? (autofit || props.wrap ? "fill" : "hug"));
+    }
+    prepare(storage) {
+        storage.requestFont(this.fontFamily, this.fontWeight.toString());
+    }
+    measure(constraints, scope) {
+        const measureFontSize = this.fontSize === 'autofit' ? 16 : this.fontSize;
+        const paragraphs = this.text.split("\n");
+        const lineH = measureFontSize * this.lineHeight;
+        const intrinsicW = Math.max(...paragraphs.map(l => scope.measureText(l, measureFontSize, this.fontFamily, this.fontWeight, this.letterSpacing, this.fontStyle)));
+        const wm = this.width;
+        const hm = this.height;
+        const resolvedW = typeof wm === "number"
+            ? wm
+            : wm === "hug"
+                ? intrinsicW
+                : constraints.maxWidth ?? 0;
+        // When wrap is on and the box has a finite width narrower than the text,
+        // height needs to account for the extra lines produced by wrapping.
+        const lineCount = this.wrap && resolvedW > 0
+            ? paragraphs.reduce((n, p) => n + countWrappedLines(p, resolvedW, measureFontSize, this.fontFamily, this.fontWeight, scope, this.letterSpacing, this.fontStyle), 0)
+            : paragraphs.length;
+        const intrinsicH = lineCount * lineH;
+        const resolvedH = typeof hm === "number"
+            ? hm
+            : hm === "hug"
+                ? intrinsicH
+                : constraints.maxHeight ?? 0;
+        return { width: resolvedW, height: resolvedH };
+    }
+    *append(text, duration, easing) {
+        yield* this.to({ text: this.text + text }, duration, easing);
+    }
+    *prepend(text, duration, easing) {
+        yield* this.to({ text: text + this.text }, duration, easing);
+    }
+    renderSelf(ctx) {
+        ctx.text({
+            text: this.text,
+            fontSize: this.fontSize,
+            fontFamily: this.fontFamily,
+            fontWeight: this.fontWeight,
+            fontStyle: this.fontStyle,
+            letterSpacing: this.letterSpacing,
+            lineHeight: this.lineHeight,
+            align: this.align,
+            wrap: this.wrap,
+            minFontSize: this.minFontSize,
+            width: this.layoutRect?.width ?? 0,
+            height: this.layoutRect?.height ?? 0,
+        })
+            .fill(this.fill)
+            .stroke(this.stroke).shadow(this.shadow);
+    }
+}
+__decorate([
+    property({ default: "", tween: lerpText, layout: true })
+], Text.prototype, "text", void 0);
+__decorate([
+    property({ default: "Inter", layout: true })
+], Text.prototype, "fontFamily", void 0);
+__decorate([
+    property({ default: 16, layout: true })
+], Text.prototype, "fontSize", void 0);
+__decorate([
+    property({ default: 400, layout: true })
+], Text.prototype, "fontWeight", void 0);
+__decorate([
+    property({ default: 'normal', layout: true })
+], Text.prototype, "fontStyle", void 0);
+__decorate([
+    property({ default: 0, layout: true })
+], Text.prototype, "letterSpacing", void 0);
+__decorate([
+    property({ default: 1.2, layout: true })
+], Text.prototype, "lineHeight", void 0);
+__decorate([
+    property({ default: 'center', layout: true })
+], Text.prototype, "align", void 0);
+__decorate([
+    property({ default: false, layout: true })
+], Text.prototype, "wrap", void 0);
+__decorate([
+    property({ default: 12, layout: true })
+], Text.prototype, "minFontSize", void 0);
+function countWrappedLines(paragraph, maxWidth, fontSize, fontFamily, fontWeight, scope, letterSpacing = 0, fontStyle = 'normal') {
+    if (paragraph.length === 0)
+        return 1;
+    if (scope.measureText(paragraph, fontSize, fontFamily, fontWeight, letterSpacing, fontStyle) <= maxWidth)
+        return 1;
+    const words = paragraph.split(/(\s+)/).filter(s => s.length > 0);
+    let lines = 1;
+    let lineW = 0;
+    for (const word of words) {
+        const w = scope.measureText(word, fontSize, fontFamily, fontWeight, letterSpacing, fontStyle);
+        if (lineW === 0) {
+            lineW = w;
+        }
+        else if (lineW + w <= maxWidth) {
+            lineW += w;
+        }
+        else {
+            lines++;
+            lineW = /^\s+$/.test(word) ? 0 : w;
+        }
+    }
+    return lines;
+}
+//# sourceMappingURL=text-node.js.map

package/dist/nodes/text/text-node.js.map

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

package/dist/platform/audio-device.d.ts

@@ -0,0 +1,40 @@
+import type { AudioRequest } from "../attributes/audio/request";
+/**
+ * Stackable audio player driven by the AssetManager.
+ *
+ * The AssetManager decides which audio data is needed within the current
+ * look-ahead window and pushes it in via {@link append}; the device caches the
+ * decoded form, schedules the matching {@link AudioRequest}s via
+ * {@link schedule}, and drives playback through {@link syncTo} on each tick.
+ */
+export declare abstract class AudioDevice {
+    /** True if decoded data for `src` is already cached on the device. */
+    abstract has(src: string): boolean;
+    /**
+     * Decode and stack `data` under `src`. Idempotent — repeat calls for an
+     * already-cached `src` are no-ops.
+     */
+    abstract append(src: string, data: ArrayBuffer): Promise<void>;
+    /** Drop cached audio data (and any active sources) for srcs not in `keep`. */
+    abstract retain(keep: ReadonlySet<string>): void;
+    /**
+     * Set the working set of audio requests for the current look-ahead window.
+     * Requests no longer present are stopped; new ones become eligible for
+     * playback via {@link syncTo} as soon as their data is appended.
+     */
+    abstract schedule(requests: readonly AudioRequest[]): void;
+    /**
+     * Start/stop scheduled sources to match `sceneTime`. Called every tick.
+     * Sources whose data has not yet been appended are skipped until it is.
+     */
+    abstract syncTo(sceneTime: number): void;
+    abstract play(time: number, speed: number, reverse: boolean): void | Promise<void>;
+    abstract stop(): void;
+    /**
+     * Mute or unmute all output. Default is a no-op for devices that produce no
+     * sound (e.g. export/noop sinks).
+     */
+    setMuted(_muted: boolean): void;
+    dispose(): void;
+}
+//# sourceMappingURL=audio-device.d.ts.map

package/dist/platform/audio-device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-device.d.ts","sourceRoot":"","sources":["../../src/platform/audio-device.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D;;;;;;;GAOG;AACH,8BAAsB,WAAW;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAElC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAE9D,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAEhD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI;IAE1D;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAExC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAClF,QAAQ,CAAC,IAAI,IAAI,IAAI;IAErB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAE/B,OAAO,IAAI,IAAI;CAGlB"}

package/dist/platform/audio-device.js

@@ -0,0 +1,19 @@
+/**
+ * Stackable audio player driven by the AssetManager.
+ *
+ * The AssetManager decides which audio data is needed within the current
+ * look-ahead window and pushes it in via {@link append}; the device caches the
+ * decoded form, schedules the matching {@link AudioRequest}s via
+ * {@link schedule}, and drives playback through {@link syncTo} on each tick.
+ */
+export class AudioDevice {
+    /**
+     * Mute or unmute all output. Default is a no-op for devices that produce no
+     * sound (e.g. export/noop sinks).
+     */
+    setMuted(_muted) { }
+    dispose() {
+        this.stop();
+    }
+}
+//# sourceMappingURL=audio-device.js.map

package/dist/platform/audio-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-device.js","sourceRoot":"","sources":["../../src/platform/audio-device.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,OAAgB,WAAW;IA6B7B;;;OAGG;IACH,QAAQ,CAAC,MAAe,IAAS,CAAC;IAElC,OAAO;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;CACJ"}

package/dist/platform/index.d.ts

@@ -0,0 +1,4 @@
+export { MasterClock } from './master-clock';
+export { AudioDevice } from './audio-device';
+export { StorageAdapter } from './storage-adapter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/platform/index.js

@@ -0,0 +1,4 @@
+export { MasterClock } from './master-clock';
+export { AudioDevice } from './audio-device';
+export { StorageAdapter } from './storage-adapter';
+//# sourceMappingURL=index.js.map

package/dist/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/platform/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/platform/master-clock.d.ts

@@ -0,0 +1,54 @@
+/** Called every animation frame with the current playhead time (seconds). Must return a Promise so the clock can await all renderers before advancing. */
+export type TickCallback = (time: number) => Promise<void>;
+/** Fired when playback starts. Receives the time at which playback began, the playback speed multiplier, and whether playback is reversed. */
+export type PlayCallback = (time: number, speed: number, reverse: boolean) => void;
+/** Fired whenever the playhead position changes. */
+export type TimeCallback = (time: number) => void;
+/**
+ * Platform-agnostic base class for driving animation playback.
+ *
+ * Subclasses implement the actual frame loop (e.g. requestAnimationFrame in the
+ * browser, a setInterval loop in Node) and call `setCurrentTime` / `tick` each
+ * frame. `MasterClock` owns the subscriber lists and the shared playback state
+ * so that renderers and UI controls can coordinate without knowing about each
+ * other.
+ *
+ * Lifecycle:
+ *   1. Set total duration with `setDuration`.
+ *   2. Register listeners via `onTick` / `onPlay` / `onPause` / `onTime`.
+ *   3. Call `play`, `pause`, or `seek` to control playback.
+ *   4. Call `dispose` when the clock is no longer needed to prevent leaks.
+ */
+export declare abstract class MasterClock {
+    private _isPlaying;
+    private _currentTime;
+    protected _duration: number;
+    get isPlaying(): boolean;
+    /** Current playhead position in seconds. */
+    get currentTime(): number;
+    /** Total animation duration in seconds. */
+    get duration(): number;
+    setDuration(duration: number): void;
+    /** Updates the playhead and notifies time listeners. No-ops if the time hasn't changed. */
+    protected setCurrentTime(t: number): void;
+    protected setPlaying(playing: boolean): void;
+    /** Starts playback at the given speed and direction, notifying all play listeners. */
+    play(speed: number, reverse: boolean): void;
+    /** Awaits all tick callbacks in parallel. Subclasses call this once per frame after updating `currentTime`. */
+    protected tick(): Promise<void>;
+    /** Pauses playback and notifies all pause listeners. */
+    pause(): void;
+    /** Moves the playhead to `t` (seconds). Subclasses decide whether this also triggers a tick. */
+    abstract seek(t: number): void;
+    protected tickCallbacks: TickCallback[];
+    protected playCallbacks: PlayCallback[];
+    protected pauseCallbacks: (() => void)[];
+    protected timeCallbacks: TimeCallback[];
+    /** Clears all registered callbacks. Call when tearing down a scene to avoid memory leaks. */
+    dispose(): void;
+    onTick(callback: TickCallback): void;
+    onPlay(callback: PlayCallback): void;
+    onPause(callback: () => void): void;
+    onTime(callback: TimeCallback): void;
+}
+//# sourceMappingURL=master-clock.d.ts.map

package/dist/platform/master-clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-clock.d.ts","sourceRoot":"","sources":["../../src/platform/master-clock.ts"],"names":[],"mappings":"AAAA,0JAA0J;AAC1J,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3D,8IAA8I;AAC9I,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAEnF,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAElD;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,WAAW;IAC7B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,YAAY,CAAa;IACjC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAK;IAEhC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,4CAA4C;IAC5C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,2CAA2C;IAC3C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAInC,2FAA2F;IAC3F,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMzC,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI5C,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAK3C,+GAA+G;cAC/F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,wDAAwD;IACxD,KAAK,IAAI,IAAI;IAKb,gGAAgG;IAChG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAE9B,SAAS,CAAC,aAAa,EAAE,YAAY,EAAE,CAAM;IAC7C,SAAS,CAAC,aAAa,EAAE,YAAY,EAAE,CAAM;IAC7C,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,IAAI,CAAC,EAAE,CAAM;IAC9C,SAAS,CAAC,aAAa,EAAE,YAAY,EAAE,CAAM;IAE7C,6FAA6F;IAC7F,OAAO;IAOP,MAAM,CAAC,QAAQ,EAAE,YAAY;IAI7B,MAAM,CAAC,QAAQ,EAAE,YAAY;IAI7B,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI;IAI5B,MAAM,CAAC,QAAQ,EAAE,YAAY;CAGhC"}

package/dist/platform/master-clock.js

@@ -0,0 +1,85 @@
+/**
+ * Platform-agnostic base class for driving animation playback.
+ *
+ * Subclasses implement the actual frame loop (e.g. requestAnimationFrame in the
+ * browser, a setInterval loop in Node) and call `setCurrentTime` / `tick` each
+ * frame. `MasterClock` owns the subscriber lists and the shared playback state
+ * so that renderers and UI controls can coordinate without knowing about each
+ * other.
+ *
+ * Lifecycle:
+ *   1. Set total duration with `setDuration`.
+ *   2. Register listeners via `onTick` / `onPlay` / `onPause` / `onTime`.
+ *   3. Call `play`, `pause`, or `seek` to control playback.
+ *   4. Call `dispose` when the clock is no longer needed to prevent leaks.
+ */
+export class MasterClock {
+    _isPlaying = false;
+    _currentTime = 0;
+    _duration = 0;
+    get isPlaying() {
+        return this._isPlaying;
+    }
+    /** Current playhead position in seconds. */
+    get currentTime() {
+        return this._currentTime;
+    }
+    /** Total animation duration in seconds. */
+    get duration() {
+        return this._duration;
+    }
+    setDuration(duration) {
+        this._duration = duration;
+    }
+    /** Updates the playhead and notifies time listeners. No-ops if the time hasn't changed. */
+    setCurrentTime(t) {
+        if (this._currentTime === t)
+            return;
+        this._currentTime = t;
+        for (const cb of this.timeCallbacks)
+            cb(t);
+    }
+    setPlaying(playing) {
+        this._isPlaying = playing;
+    }
+    /** Starts playback at the given speed and direction, notifying all play listeners. */
+    play(speed, reverse) {
+        this._isPlaying = true;
+        for (const cb of this.playCallbacks)
+            cb(this._currentTime, speed, reverse);
+    }
+    /** Awaits all tick callbacks in parallel. Subclasses call this once per frame after updating `currentTime`. */
+    async tick() {
+        await Promise.all(this.tickCallbacks.map(c => c(this._currentTime)));
+    }
+    /** Pauses playback and notifies all pause listeners. */
+    pause() {
+        this._isPlaying = false;
+        for (const cb of this.pauseCallbacks)
+            cb();
+    }
+    tickCallbacks = [];
+    playCallbacks = [];
+    pauseCallbacks = [];
+    timeCallbacks = [];
+    /** Clears all registered callbacks. Call when tearing down a scene to avoid memory leaks. */
+    dispose() {
+        this.tickCallbacks.length = 0;
+        this.playCallbacks.length = 0;
+        this.pauseCallbacks.length = 0;
+        this.timeCallbacks.length = 0;
+    }
+    onTick(callback) {
+        this.tickCallbacks.push(callback);
+    }
+    onPlay(callback) {
+        this.playCallbacks.push(callback);
+    }
+    onPause(callback) {
+        this.pauseCallbacks.push(callback);
+    }
+    onTime(callback) {
+        this.timeCallbacks.push(callback);
+    }
+}
+//# sourceMappingURL=master-clock.js.map

package/dist/platform/master-clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-clock.js","sourceRoot":"","sources":["../../src/platform/master-clock.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAgB,WAAW;IACrB,UAAU,GAAY,KAAK,CAAC;IAC5B,YAAY,GAAW,CAAC,CAAC;IACvB,SAAS,GAAW,CAAC,CAAC;IAEhC,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,4CAA4C;IAC5C,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED,2CAA2C;IAC3C,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,WAAW,CAAC,QAAgB;QACxB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,2FAA2F;IACjF,cAAc,CAAC,CAAS;QAC9B,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC;YAAE,OAAO;QACpC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa;YAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IAES,UAAU,CAAC,OAAgB;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,sFAAsF;IACtF,IAAI,CAAC,KAAa,EAAE,OAAgB;QAChC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,aAAa;YAAE,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,+GAA+G;IACrG,KAAK,CAAC,IAAI;QAChB,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,wDAAwD;IACxD,KAAK;QACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,cAAc;YAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IAKS,aAAa,GAAmB,EAAE,CAAC;IACnC,aAAa,GAAmB,EAAE,CAAC;IACnC,cAAc,GAAmB,EAAE,CAAC;IACpC,aAAa,GAAmB,EAAE,CAAC;IAE7C,6FAA6F;IAC7F,OAAO;QACH,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,QAAsB;QACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,QAAsB;QACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,QAAoB;QACxB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,QAAsB;QACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;CACJ"}