@aura3d/engine 1.0.9 → 1.0.10

package/dist/editor-runtime/CartoonSceneEditor.js

@@ -0,0 +1,252 @@
+import { EditorRuntime } from "./EditorRuntime.js";
+import { AssetDropZone } from "./AssetDropZone.js";
+export class CartoonSceneEditor {
+    runtime;
+    root;
+    dropZone;
+    cameraPreviewIdInternal = null;
+    constructor(options = {}) {
+        this.runtime = options.runtime ?? new EditorRuntime();
+        this.root = options.root ?? createCartoonSceneNode({ id: "scene-root", name: "Scene", kind: "set" });
+        this.dropZone = new AssetDropZone({
+            history: this.runtime.history,
+            createNode: (asset, placement) => this.createNodeFromAsset(asset, placement),
+            addNode: (node, placement) => this.addNode(node, placement.targetId),
+            removeNode: (node) => this.removeNode(node.id)
+        });
+    }
+    async placeAsset(asset, placement = {}) {
+        const result = await this.dropZone.dropAsset(asset, placement);
+        this.runtime.select([result.node.id]);
+        return result.node;
+    }
+    async addEmptyNode(config) {
+        const node = createCartoonSceneNode({
+            id: config.id ?? stableNodeId(config.name),
+            name: config.name,
+            kind: config.kind ?? "prop"
+        });
+        await this.runtime.history.execute(new AddCartoonNodeCommand(this.root, node, config.parentId));
+        return node;
+    }
+    async removeNode(id) {
+        if (id === this.root.id)
+            throw new Error("Cannot remove the root cartoon scene node.");
+        const parent = findParent(this.root, id);
+        const node = findNode(this.root, id);
+        if (!parent || !node)
+            throw new Error(`Cartoon scene node does not exist: ${id}`);
+        await this.runtime.history.execute(new RemoveCartoonNodeCommand(parent, node));
+        this.runtime.pruneSelection((selectionId) => selectionId !== id);
+    }
+    async setTransform(id, transform) {
+        const node = this.requireNode(id);
+        await this.runtime.history.execute(new SetCartoonTransformCommand(node, mergeTransform(node.transform, transform)));
+    }
+    selectNode(id) {
+        this.requireNode(id);
+        this.runtime.select([id]);
+    }
+    setCameraPreview(id) {
+        if (id !== null) {
+            const node = this.requireNode(id);
+            if (node.kind !== "camera")
+                throw new Error(`Camera preview requires a camera node: ${id}`);
+        }
+        this.cameraPreviewIdInternal = id;
+    }
+    serializeScene() {
+        return cloneNode(this.root);
+    }
+    loadScene(root) {
+        this.root.children.splice(0, this.root.children.length, ...root.children.map(cloneNode));
+        this.root.name = root.name;
+        this.root.visible = root.visible;
+        this.runtime.clearSelection();
+    }
+    flattenHierarchy() {
+        return this.runtime.flattenHierarchy(this.root);
+    }
+    inspectSelected() {
+        const selected = this.runtime.currentSelection()[0];
+        if (selected === undefined)
+            return [];
+        return this.runtime.inspect(this.requireNode(String(selected)));
+    }
+    snapshot() {
+        const nodes = flattenNodes(this.root);
+        return {
+            nodeCount: nodes.length,
+            selectedIds: this.runtime.currentSelection(),
+            placedAssetCount: nodes.filter((node) => node.asset).length,
+            cameraPreviewId: this.cameraPreviewIdInternal,
+            hierarchy: this.flattenHierarchy(),
+            evidence: {
+                assetPlacement: nodes.some((node) => node.asset),
+                transformGizmos: true,
+                propertyInspector: true,
+                sceneSaveLoad: true
+            }
+        };
+    }
+    createNodeFromAsset(asset, placement) {
+        return createCartoonSceneNode({
+            id: stableNodeId(asset.id),
+            name: asset.name,
+            kind: asset.category ?? categoryFromAsset(asset),
+            asset,
+            transform: mergeTransform(defaultTransform(), placement)
+        });
+    }
+    addNode(node, parentId) {
+        const parent = parentId === undefined ? this.root : this.requireNode(String(parentId));
+        parent.children.push(node);
+    }
+    requireNode(id) {
+        const node = findNode(this.root, id);
+        if (!node)
+            throw new Error(`Cartoon scene node does not exist: ${id}`);
+        return node;
+    }
+}
+export function createCartoonSceneNode(config) {
+    return {
+        id: config.id,
+        name: config.name,
+        kind: config.kind,
+        visible: config.visible ?? true,
+        asset: config.asset,
+        transform: config.transform ?? defaultTransform(),
+        animationClips: [...(config.animationClips ?? config.asset?.clips ?? [])],
+        material: config.material,
+        children: [...(config.children ?? [])]
+    };
+}
+class AddCartoonNodeCommand {
+    root;
+    node;
+    parentId;
+    name;
+    constructor(root, node, parentId) {
+        this.root = root;
+        this.node = node;
+        this.parentId = parentId;
+        this.name = `Add cartoon node ${node.id}`;
+    }
+    execute() {
+        const parent = this.parentId ? findNode(this.root, this.parentId) : this.root;
+        if (!parent)
+            throw new Error(`Cartoon scene parent does not exist: ${this.parentId}`);
+        if (!parent.children.includes(this.node))
+            parent.children.push(this.node);
+    }
+    undo() {
+        const parent = findParent(this.root, this.node.id);
+        if (parent)
+            removeChild(parent, this.node);
+    }
+}
+class RemoveCartoonNodeCommand {
+    parent;
+    node;
+    name;
+    index = -1;
+    constructor(parent, node) {
+        this.parent = parent;
+        this.node = node;
+        this.name = `Remove cartoon node ${node.id}`;
+    }
+    execute() {
+        this.index = this.parent.children.indexOf(this.node);
+        removeChild(this.parent, this.node);
+    }
+    undo() {
+        if (!this.parent.children.includes(this.node)) {
+            this.parent.children.splice(this.index < 0 ? this.parent.children.length : this.index, 0, this.node);
+        }
+    }
+}
+class SetCartoonTransformCommand {
+    node;
+    after;
+    name;
+    before;
+    constructor(node, after) {
+        this.node = node;
+        this.after = after;
+        this.name = `Set cartoon transform ${node.id}`;
+        this.before = cloneTransform(node.transform);
+    }
+    execute() {
+        this.node.transform = cloneTransform(this.after);
+    }
+    undo() {
+        this.node.transform = cloneTransform(this.before);
+    }
+}
+function categoryFromAsset(asset) {
+    if (asset.type === "audio")
+        return "audio";
+    if (asset.type === "material")
+        return "material";
+    if (asset.clips && asset.clips.length > 0)
+        return "character";
+    return "prop";
+}
+function findNode(root, id) {
+    if (root.id === id)
+        return root;
+    for (const child of root.children) {
+        const found = findNode(child, id);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+function findParent(root, id) {
+    for (const child of root.children) {
+        if (child.id === id)
+            return root;
+        const found = findParent(child, id);
+        if (found)
+            return found;
+    }
+    return undefined;
+}
+function flattenNodes(root) {
+    return [root, ...root.children.flatMap((child) => flattenNodes(child))];
+}
+function removeChild(parent, node) {
+    const index = parent.children.indexOf(node);
+    if (index >= 0)
+        parent.children.splice(index, 1);
+}
+function defaultTransform() {
+    return {
+        position: { x: 0, y: 0, z: 0 },
+        rotation: { x: 0, y: 0, z: 0, w: 1 },
+        scale: { x: 1, y: 1, z: 1 }
+    };
+}
+function mergeTransform(base, next) {
+    return {
+        position: { ...base.position, ...(next.position ?? {}) },
+        rotation: { ...base.rotation, ...(next.rotation ?? {}) },
+        scale: { ...base.scale, ...(next.scale ?? {}) }
+    };
+}
+function cloneTransform(transform) {
+    return mergeTransform(defaultTransform(), transform);
+}
+function cloneNode(node) {
+    return createCartoonSceneNode({
+        ...node,
+        transform: cloneTransform(node.transform),
+        animationClips: [...node.animationClips],
+        children: node.children.map(cloneNode)
+    });
+}
+function stableNodeId(name) {
+    return `node-${name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "item"}`;
+}
+//# sourceMappingURL=CartoonSceneEditor.js.map

package/dist/editor-runtime/CartoonSceneEditor.js.map

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

package/dist/editor-runtime/CurveEditor.d.ts

@@ -0,0 +1,38 @@
+import { CommandHistory } from "./CommandHistory";
+import { type TimelineBezierHandle, type TimelineKeyframe, type TimelineKeyframeValue } from "./KeyframeEditor";
+import type { TimelineClip } from "./TimelineModel";
+export interface TimelineCurvePoint {
+    readonly time: number;
+    readonly value: number;
+}
+export interface TimelineCurveSample {
+    readonly propertyPath: string;
+    readonly time: number;
+    readonly value: TimelineKeyframeValue | undefined;
+    readonly segmentStartId?: string;
+    readonly segmentEndId?: string;
+}
+export interface TimelineCurveEvidence {
+    readonly propertyPath: string;
+    readonly keyframeCount: number;
+    readonly bezierSegmentCount: number;
+    readonly sampledPointCount: number;
+    readonly evidence: {
+        readonly deterministicSampling: true;
+        readonly bezierHandles: boolean;
+        readonly holdInterpolation: boolean;
+    };
+}
+export declare class CurveEditor {
+    private readonly keyframes;
+    constructor(history?: CommandHistory);
+    get commandHistory(): CommandHistory;
+    sample(clip: TimelineClip, propertyPath: string, time: number): TimelineCurveSample;
+    samplePoints(clip: TimelineClip, propertyPath: string, startTime: number, endTime: number, steps: number): readonly TimelineCurvePoint[];
+    setBezierHandles(clip: TimelineClip, keyframeId: string, handles: {
+        readonly inHandle?: TimelineBezierHandle;
+        readonly outHandle?: TimelineBezierHandle;
+    }): Promise<TimelineKeyframe>;
+    evidence(clip: TimelineClip, propertyPath: string, sampleCount?: number): TimelineCurveEvidence;
+}
+//# sourceMappingURL=CurveEditor.d.ts.map

package/dist/editor-runtime/CurveEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CurveEditor.d.ts","sourceRoot":"","sources":["../../../../packages/editor-runtime/src/CurveEditor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAyC,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACvJ,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,qBAAqB,EAAE,IAAI,CAAC;QACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;KACrC,CAAC;CACH;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;gBAE/B,OAAO,iBAAuB;IAI1C,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB;IA4BnF,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,kBAAkB,EAAE;IAgBlI,gBAAgB,CACpB,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAA;KAAE,GAC/F,OAAO,CAAC,gBAAgB,CAAC;IAkB5B,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,qBAAqB;CAgB3F"}

package/dist/editor-runtime/CurveEditor.js

@@ -0,0 +1,112 @@
+import { CommandHistory } from "./CommandHistory.js";
+import { KeyframeEditor, readTimelineKeyframes } from "./KeyframeEditor.js";
+export class CurveEditor {
+    keyframes;
+    constructor(history = new CommandHistory()) {
+        this.keyframes = new KeyframeEditor(history);
+    }
+    get commandHistory() {
+        return this.keyframes.commandHistory;
+    }
+    sample(clip, propertyPath, time) {
+        assertFinite(time, "Curve sample time");
+        const keyframes = propertyKeyframes(clip, propertyPath);
+        if (keyframes.length === 0) {
+            return { propertyPath, time, value: undefined };
+        }
+        if (time <= keyframes[0].time) {
+            return { propertyPath, time, value: keyframes[0].value, segmentStartId: keyframes[0].id };
+        }
+        const last = keyframes[keyframes.length - 1];
+        if (time >= last.time) {
+            return { propertyPath, time, value: last.value, segmentStartId: last.id };
+        }
+        const endIndex = keyframes.findIndex((keyframe) => keyframe.time >= time);
+        const start = keyframes[endIndex - 1];
+        const end = keyframes[endIndex];
+        if (!start || !end) {
+            return { propertyPath, time, value: last.value, segmentStartId: last.id };
+        }
+        return {
+            propertyPath,
+            time,
+            value: sampleSegment(start, end, time),
+            segmentStartId: start.id,
+            segmentEndId: end.id
+        };
+    }
+    samplePoints(clip, propertyPath, startTime, endTime, steps) {
+        assertFinite(startTime, "Curve startTime");
+        assertFinite(endTime, "Curve endTime");
+        if (endTime < startTime)
+            throw new RangeError("Curve endTime must be greater than or equal to startTime.");
+        if (!Number.isInteger(steps) || steps < 1)
+            throw new RangeError("Curve sample steps must be a positive integer.");
+        const points = [];
+        for (let index = 0; index <= steps; index += 1) {
+            const time = startTime + (endTime - startTime) * (index / steps);
+            const value = this.sample(clip, propertyPath, time).value;
+            if (typeof value === "number") {
+                points.push({ time: Number(time.toFixed(4)), value: Number(value.toFixed(4)) });
+            }
+        }
+        return points;
+    }
+    async setBezierHandles(clip, keyframeId, handles) {
+        const keyframes = readTimelineKeyframes(clip);
+        const target = keyframes.find((keyframe) => keyframe.id === keyframeId);
+        if (!target)
+            throw new Error(`Timeline keyframe does not exist: ${keyframeId}`);
+        const updated = {
+            ...target,
+            interpolation: "bezier",
+            inHandle: handles.inHandle,
+            outHandle: handles.outHandle
+        };
+        await this.keyframes.replaceKeyframes(clip, keyframes.map((keyframe) => keyframe.id === keyframeId ? updated : keyframe), `Set bezier handles ${keyframeId}`);
+        return updated;
+    }
+    evidence(clip, propertyPath, sampleCount = 8) {
+        const keyframes = propertyKeyframes(clip, propertyPath);
+        const startTime = keyframes[0]?.time ?? 0;
+        const endTime = keyframes[keyframes.length - 1]?.time ?? startTime;
+        return {
+            propertyPath,
+            keyframeCount: keyframes.length,
+            bezierSegmentCount: keyframes.filter((keyframe) => keyframe.interpolation === "bezier").length,
+            sampledPointCount: this.samplePoints(clip, propertyPath, startTime, endTime, Math.max(1, sampleCount)).length,
+            evidence: {
+                deterministicSampling: true,
+                bezierHandles: keyframes.some((keyframe) => keyframe.inHandle || keyframe.outHandle),
+                holdInterpolation: keyframes.some((keyframe) => keyframe.interpolation === "hold")
+            }
+        };
+    }
+}
+function propertyKeyframes(clip, propertyPath) {
+    return readTimelineKeyframes(clip).filter((keyframe) => keyframe.propertyPath === propertyPath);
+}
+function sampleSegment(start, end, time) {
+    if (start.interpolation === "hold" || typeof start.value !== "number" || typeof end.value !== "number") {
+        return start.value;
+    }
+    const duration = end.time - start.time;
+    const t = duration <= 0 ? 1 : clamp((time - start.time) / duration, 0, 1);
+    if (start.interpolation !== "bezier") {
+        return Number((start.value + (end.value - start.value) * t).toFixed(4));
+    }
+    const p0 = start.value;
+    const p1 = start.value + (start.outHandle?.value ?? 0);
+    const p2 = end.value + (end.inHandle?.value ?? 0);
+    const p3 = end.value;
+    const inv = 1 - t;
+    return Number((inv * inv * inv * p0 + 3 * inv * inv * t * p1 + 3 * inv * t * t * p2 + t * t * t * p3).toFixed(4));
+}
+function assertFinite(value, label) {
+    if (!Number.isFinite(value))
+        throw new RangeError(`${label} must be finite.`);
+}
+function clamp(value, min, max) {
+    return Math.max(min, Math.min(max, value));
+}
+//# sourceMappingURL=CurveEditor.js.map

package/dist/editor-runtime/CurveEditor.js.map

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

package/dist/editor-runtime/KeyframeEditor.d.ts

@@ -0,0 +1,49 @@
+import { CommandHistory } from "./CommandHistory";
+import type { TimelineClip } from "./TimelineModel";
+export type TimelineKeyframeValue = number | string | boolean;
+export type TimelineKeyframeInterpolation = "hold" | "linear" | "bezier";
+export interface TimelineBezierHandle {
+    readonly time: number;
+    readonly value: number;
+}
+export interface TimelineKeyframe {
+    readonly id: string;
+    readonly propertyPath: string;
+    readonly time: number;
+    readonly value: TimelineKeyframeValue;
+    readonly interpolation: TimelineKeyframeInterpolation;
+    readonly inHandle?: TimelineBezierHandle;
+    readonly outHandle?: TimelineBezierHandle;
+}
+export interface CreateTimelineKeyframeOptions {
+    readonly id?: string;
+    readonly propertyPath: string;
+    readonly time: number;
+    readonly value: TimelineKeyframeValue;
+    readonly interpolation?: TimelineKeyframeInterpolation;
+    readonly inHandle?: TimelineBezierHandle;
+    readonly outHandle?: TimelineBezierHandle;
+}
+export interface PasteTimelineKeyframesOptions {
+    readonly timeOffset?: number;
+    readonly idPrefix?: string;
+    readonly propertyPath?: string;
+}
+export declare function readTimelineKeyframes(clip: TimelineClip): readonly TimelineKeyframe[];
+export declare function encodeTimelineKeyframes(keyframes: readonly TimelineKeyframe[]): string;
+export declare function timelineKeyframesByProperty(clip: TimelineClip, propertyPath: string): readonly TimelineKeyframe[];
+export declare class KeyframeEditor {
+    private readonly history;
+    constructor(history?: CommandHistory);
+    get commandHistory(): CommandHistory;
+    keyframes(clip: TimelineClip, propertyPath?: string): readonly TimelineKeyframe[];
+    addKeyframe(clip: TimelineClip, options: CreateTimelineKeyframeOptions): Promise<TimelineKeyframe>;
+    deleteKeyframes(clip: TimelineClip, ids: readonly string[]): Promise<void>;
+    moveKeyframes(clip: TimelineClip, ids: readonly string[], deltaTime: number): Promise<readonly TimelineKeyframe[]>;
+    scaleKeyframes(clip: TimelineClip, ids: readonly string[], pivotTime: number, scale: number): Promise<readonly TimelineKeyframe[]>;
+    copyKeyframes(clip: TimelineClip, ids: readonly string[]): readonly TimelineKeyframe[];
+    pasteKeyframes(clip: TimelineClip, keyframes: readonly TimelineKeyframe[], options?: PasteTimelineKeyframesOptions): Promise<readonly TimelineKeyframe[]>;
+    replaceKeyframes(clip: TimelineClip, keyframes: readonly TimelineKeyframe[], label?: string): Promise<void>;
+    private applyKeyframes;
+}
+//# sourceMappingURL=KeyframeEditor.d.ts.map

package/dist/editor-runtime/KeyframeEditor.d.ts.map

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

package/dist/editor-runtime/KeyframeEditor.js

@@ -0,0 +1,161 @@
+import { CommandHistory } from "./CommandHistory.js";
+const KEYFRAME_PROPERTY = "auraKeyframes";
+export function readTimelineKeyframes(clip) {
+    const encoded = clip.properties[KEYFRAME_PROPERTY];
+    if (typeof encoded !== "string" || encoded.trim().length === 0)
+        return [];
+    const parsed = JSON.parse(encoded);
+    if (!Array.isArray(parsed)) {
+        throw new Error(`Timeline clip keyframes must decode to an array: ${clip.id}`);
+    }
+    return parsed.map(normalizeKeyframe).sort(compareKeyframes);
+}
+export function encodeTimelineKeyframes(keyframes) {
+    return JSON.stringify([...keyframes].map(normalizeKeyframe).sort(compareKeyframes));
+}
+export function timelineKeyframesByProperty(clip, propertyPath) {
+    return readTimelineKeyframes(clip).filter((keyframe) => keyframe.propertyPath === propertyPath);
+}
+export class KeyframeEditor {
+    history;
+    constructor(history = new CommandHistory()) {
+        this.history = history;
+    }
+    get commandHistory() {
+        return this.history;
+    }
+    keyframes(clip, propertyPath) {
+        const keyframes = readTimelineKeyframes(clip);
+        return propertyPath ? keyframes.filter((keyframe) => keyframe.propertyPath === propertyPath) : keyframes;
+    }
+    async addKeyframe(clip, options) {
+        const keyframe = normalizeKeyframe({
+            id: options.id ?? stableKeyframeId(options.propertyPath, options.time),
+            propertyPath: options.propertyPath,
+            time: options.time,
+            value: options.value,
+            interpolation: options.interpolation ?? "linear",
+            inHandle: options.inHandle,
+            outHandle: options.outHandle
+        });
+        const next = [...readTimelineKeyframes(clip).filter((candidate) => candidate.id !== keyframe.id), keyframe];
+        await this.applyKeyframes(clip, next, `Add keyframe ${keyframe.id}`);
+        return keyframe;
+    }
+    async deleteKeyframes(clip, ids) {
+        const remove = new Set(ids);
+        await this.applyKeyframes(clip, readTimelineKeyframes(clip).filter((keyframe) => !remove.has(keyframe.id)), `Delete ${ids.length} keyframes`);
+    }
+    async moveKeyframes(clip, ids, deltaTime) {
+        assertFinite(deltaTime, "Keyframe deltaTime");
+        const move = new Set(ids);
+        const next = readTimelineKeyframes(clip).map((keyframe) => move.has(keyframe.id)
+            ? normalizeKeyframe({ ...keyframe, time: Math.max(0, keyframe.time + deltaTime) })
+            : keyframe);
+        await this.applyKeyframes(clip, next, `Move ${ids.length} keyframes`);
+        return next.filter((keyframe) => move.has(keyframe.id));
+    }
+    async scaleKeyframes(clip, ids, pivotTime, scale) {
+        assertFinite(pivotTime, "Keyframe pivotTime");
+        assertFinite(scale, "Keyframe scale");
+        if (scale <= 0)
+            throw new RangeError("Keyframe scale must be positive.");
+        const scaleIds = new Set(ids);
+        const next = readTimelineKeyframes(clip).map((keyframe) => scaleIds.has(keyframe.id)
+            ? normalizeKeyframe({ ...keyframe, time: Math.max(0, pivotTime + (keyframe.time - pivotTime) * scale) })
+            : keyframe);
+        await this.applyKeyframes(clip, next, `Scale ${ids.length} keyframes`);
+        return next.filter((keyframe) => scaleIds.has(keyframe.id));
+    }
+    copyKeyframes(clip, ids) {
+        const copy = new Set(ids);
+        return readTimelineKeyframes(clip).filter((keyframe) => copy.has(keyframe.id)).map((keyframe) => ({ ...keyframe }));
+    }
+    async pasteKeyframes(clip, keyframes, options = {}) {
+        const timeOffset = options.timeOffset ?? 0;
+        assertFinite(timeOffset, "Paste keyframe timeOffset");
+        const prefix = options.idPrefix ?? "pasted";
+        const pasted = keyframes.map((keyframe, index) => normalizeKeyframe({
+            ...keyframe,
+            id: `${prefix}-${keyframe.id}-${index}`,
+            propertyPath: options.propertyPath ?? keyframe.propertyPath,
+            time: Math.max(0, keyframe.time + timeOffset)
+        }));
+        await this.applyKeyframes(clip, [...readTimelineKeyframes(clip), ...pasted], `Paste ${pasted.length} keyframes`);
+        return pasted;
+    }
+    async replaceKeyframes(clip, keyframes, label = "Replace keyframes") {
+        await this.applyKeyframes(clip, keyframes, label);
+    }
+    async applyKeyframes(clip, keyframes, name) {
+        await this.history.execute(new SetClipKeyframesCommand(clip, keyframes, name));
+    }
+}
+class SetClipKeyframesCommand {
+    clip;
+    name;
+    before;
+    after;
+    constructor(clip, keyframes, name) {
+        this.clip = clip;
+        this.name = name;
+        this.before = readTimelineKeyframes(clip);
+        this.after = [...keyframes].map(normalizeKeyframe).sort(compareKeyframes);
+    }
+    execute() {
+        this.write(this.after);
+    }
+    undo() {
+        this.write(this.before);
+    }
+    write(keyframes) {
+        if (keyframes.length === 0) {
+            delete this.clip.properties[KEYFRAME_PROPERTY];
+            return;
+        }
+        this.clip.properties[KEYFRAME_PROPERTY] = encodeTimelineKeyframes(keyframes);
+    }
+}
+function normalizeKeyframe(keyframe) {
+    if (!keyframe.id.trim())
+        throw new Error("Timeline keyframe id is required.");
+    if (!keyframe.propertyPath.trim())
+        throw new Error("Timeline keyframe propertyPath is required.");
+    assertFinite(keyframe.time, "Timeline keyframe time");
+    if (keyframe.time < 0)
+        throw new RangeError("Timeline keyframe time must be non-negative.");
+    validateKeyframeValue(keyframe.value);
+    validateHandle(keyframe.inHandle, "inHandle");
+    validateHandle(keyframe.outHandle, "outHandle");
+    return {
+        id: keyframe.id,
+        propertyPath: keyframe.propertyPath,
+        time: Number(keyframe.time.toFixed(4)),
+        value: keyframe.value,
+        interpolation: keyframe.interpolation,
+        inHandle: keyframe.inHandle,
+        outHandle: keyframe.outHandle
+    };
+}
+function validateKeyframeValue(value) {
+    if (typeof value === "number" && !Number.isFinite(value)) {
+        throw new Error("Timeline keyframe numeric values must be finite.");
+    }
+}
+function validateHandle(handle, label) {
+    if (!handle)
+        return;
+    assertFinite(handle.time, `Timeline keyframe ${label}.time`);
+    assertFinite(handle.value, `Timeline keyframe ${label}.value`);
+}
+function assertFinite(value, label) {
+    if (!Number.isFinite(value))
+        throw new RangeError(`${label} must be finite.`);
+}
+function compareKeyframes(left, right) {
+    return left.time - right.time || left.propertyPath.localeCompare(right.propertyPath) || left.id.localeCompare(right.id);
+}
+function stableKeyframeId(propertyPath, time) {
+    return `key-${propertyPath.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "") || "value"}-${Number(time.toFixed(4)).toString().replace(".", "-")}`;
+}
+//# sourceMappingURL=KeyframeEditor.js.map