@aura3d/editor-runtime 1.0.6 → 1.1.0

package/dist/EpisodeReviewPanel.js

@@ -0,0 +1,162 @@
+export class EpisodeReviewPanel {
+    state;
+    constructor(state) {
+        this.state = sanitizeReviewState(state);
+    }
+    addNote(note) {
+        this.state = sanitizeReviewState({
+            ...this.state,
+            notes: [...this.state.notes, sanitizeReviewNote(note)]
+        });
+        return this.snapshot();
+    }
+    rejectFrame(frame) {
+        this.state = sanitizeReviewState({
+            ...this.state,
+            status: "rejected",
+            rejectedFrames: [...this.state.rejectedFrames, sanitizeRejectedFrame(frame)]
+        });
+        return this.snapshot();
+    }
+    setWaveformLanes(waveformLanes) {
+        this.state = sanitizeReviewState({
+            ...this.state,
+            waveformLanes: waveformLanes.map(sanitizeWaveformLane)
+        });
+        return this.snapshot();
+    }
+    applyManualVisemeEdit(edit) {
+        const sanitized = sanitizeManualVisemeEdit(edit);
+        this.state = sanitizeReviewState({
+            ...this.state,
+            manualVisemeEdits: [
+                ...((this.state.manualVisemeEdits ?? []).filter((candidate) => candidate.id !== sanitized.id)),
+                sanitized
+            ]
+        });
+        return this.snapshot();
+    }
+    approve(reviewer, approvedAt = new Date(0).toISOString()) {
+        const name = nonEmpty(reviewer, "Episode review reviewer");
+        if (this.state.rejectedFrames.length > 0) {
+            throw new Error("Episode review cannot be approved while rejected frames are present.");
+        }
+        this.state = sanitizeReviewState({
+            ...this.state,
+            status: "approved",
+            reviewer: name,
+            approvedAt
+        });
+        return this.snapshot();
+    }
+    markNeedsReview() {
+        this.state = sanitizeReviewState({
+            ...this.state,
+            status: "needs-review",
+            reviewer: undefined,
+            approvedAt: undefined
+        });
+        return this.snapshot();
+    }
+    serialize() {
+        return sanitizeReviewState(this.state);
+    }
+    snapshot() {
+        const waveformLanes = this.state.waveformLanes ?? [];
+        const manualVisemeEdits = this.state.manualVisemeEdits ?? [];
+        return {
+            kind: "episode-review-panel",
+            ...this.serialize(),
+            approvalRecorded: this.state.status === "approved" && Boolean(this.state.reviewer),
+            rejectedFrameCount: this.state.rejectedFrames.length,
+            noteCount: this.state.notes.length,
+            waveformLaneCount: waveformLanes.length,
+            manualVisemeEditCount: manualVisemeEdits.length,
+            reviewUiEvidence: {
+                waveformReview: waveformLanes.length > 0,
+                manualVisemeEdits: manualVisemeEdits.length > 0,
+                visualFrameReview: this.state.rejectedFrames.length > 0,
+                reviewerNotes: this.state.notes.length > 0
+            }
+        };
+    }
+}
+export function createEpisodeReviewPanel(state) {
+    return new EpisodeReviewPanel(state);
+}
+function sanitizeReviewState(state) {
+    return {
+        packageId: nonEmpty(state.packageId, "Episode review packageId"),
+        packageHash: state.packageHash,
+        status: state.status,
+        reviewer: state.reviewer,
+        approvedAt: state.approvedAt,
+        notes: state.notes.map(sanitizeReviewNote),
+        rejectedFrames: state.rejectedFrames.map(sanitizeRejectedFrame),
+        waveformLanes: (state.waveformLanes ?? []).map(sanitizeWaveformLane),
+        manualVisemeEdits: (state.manualVisemeEdits ?? []).map(sanitizeManualVisemeEdit)
+    };
+}
+function sanitizeReviewNote(note) {
+    return {
+        id: nonEmpty(note.id, "Episode review note id"),
+        author: nonEmpty(note.author, "Episode review note author"),
+        text: nonEmpty(note.text, "Episode review note text"),
+        time: note.time
+    };
+}
+function sanitizeRejectedFrame(frame) {
+    if (!Number.isFinite(frame.time) || frame.time < 0) {
+        throw new Error("Episode review rejected frame time must be a non-negative finite number.");
+    }
+    return {
+        id: nonEmpty(frame.id, "Episode review rejected frame id"),
+        time: frame.time,
+        reason: nonEmpty(frame.reason, "Episode review rejected frame reason")
+    };
+}
+function sanitizeWaveformLane(lane) {
+    if (!Number.isFinite(lane.startTime) || lane.startTime < 0) {
+        throw new Error("Episode review waveform lane startTime must be a non-negative finite number.");
+    }
+    if (!Number.isFinite(lane.duration) || lane.duration < 0) {
+        throw new Error("Episode review waveform lane duration must be a non-negative finite number.");
+    }
+    if (!Number.isInteger(lane.peakCount) || lane.peakCount < 0) {
+        throw new Error("Episode review waveform lane peakCount must be a non-negative integer.");
+    }
+    if (!Number.isInteger(lane.pathPointCount) || lane.pathPointCount < 0) {
+        throw new Error("Episode review waveform lane pathPointCount must be a non-negative integer.");
+    }
+    return {
+        id: nonEmpty(lane.id, "Episode review waveform lane id"),
+        label: nonEmpty(lane.label, "Episode review waveform lane label"),
+        startTime: lane.startTime,
+        duration: lane.duration,
+        peakCount: lane.peakCount,
+        pathPointCount: lane.pathPointCount
+    };
+}
+function sanitizeManualVisemeEdit(edit) {
+    if (!Number.isFinite(edit.startTime) || edit.startTime < 0) {
+        throw new Error("Episode review manual viseme startTime must be a non-negative finite number.");
+    }
+    if (!Number.isFinite(edit.endTime) || edit.endTime <= edit.startTime) {
+        throw new Error("Episode review manual viseme endTime must be greater than startTime.");
+    }
+    return {
+        id: nonEmpty(edit.id, "Episode review manual viseme id"),
+        characterId: nonEmpty(edit.characterId, "Episode review manual viseme characterId"),
+        visemeId: nonEmpty(edit.visemeId, "Episode review manual viseme visemeId"),
+        startTime: edit.startTime,
+        endTime: edit.endTime,
+        reason: edit.reason
+    };
+}
+function nonEmpty(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new Error(`${label} must be a non-empty string.`);
+    return trimmed;
+}
+//# sourceMappingURL=EpisodeReviewPanel.js.map

package/dist/EpisodeReviewPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EpisodeReviewPanel.js","sourceRoot":"","sources":["../../../../packages/editor-runtime/src/EpisodeReviewPanel.ts"],"names":[],"mappings":"AA4DA,MAAM,OAAO,kBAAkB;IACrB,KAAK,CAA0B;IAEvC,YAAY,KAA8B;QACxC,IAAI,CAAC,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,CAAC,IAAuB;QAC7B,IAAI,CAAC,KAAK,GAAG,mBAAmB,CAAC;YAC/B,GAAG,IAAI,CAAC,KAAK;YACb,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;SACvD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,WAAW,CAAC,KAAiC;QAC3C,IAAI,CAAC,KAAK,GAAG,mBAAmB,CAAC;YAC/B,GAAG,IAAI,CAAC,KAAK;YACb,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC;SAC7E,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,gBAAgB,CAAC,aAAmD;QAClE,IAAI,CAAC,KAAK,GAAG,mBAAmB,CAAC;YAC/B,GAAG,IAAI,CAAC,KAAK;YACb,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC,oBAAoB,CAAC;SACvD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,qBAAqB,CAAC,IAAmC;QACvD,MAAM,SAAS,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,GAAG,mBAAmB,CAAC;YAC/B,GAAG,IAAI,CAAC,KAAK;YACb,iBAAiB,EAAE;gBACjB,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC,CAAC;gBAC9F,SAAS;aACV;SACF,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,QAAgB,EAAE,UAAU,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE;QAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,mBAAmB,CAAC;YAC/B,GAAG,IAAI,CAAC,KAAK;YACb,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,IAAI;YACd,UAAU;SACX,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,eAAe;QACb,IAAI,CAAC,KAAK,GAAG,mBAAmB,CAAC;YAC/B,GAAG,IAAI,CAAC,KAAK;YACb,MAAM,EAAE,cAAc;YACtB,QAAQ,EAAE,SAAS;YACnB,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,SAAS;QACP,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ;QACN,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC;QACrD,MAAM,iBAAiB,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,sBAAsB;YAC5B,GAAG,IAAI,CAAC,SAAS,EAAE;YACnB,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAClF,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM;YACpD,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM;YAClC,iBAAiB,EAAE,aAAa,CAAC,MAAM;YACvC,qBAAqB,EAAE,iBAAiB,CAAC,MAAM;YAC/C,gBAAgB,EAAE;gBAChB,cAAc,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC;gBACxC,iBAAiB,EAAE,iBAAiB,CAAC,MAAM,GAAG,CAAC;gBAC/C,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;gBACvD,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;aAC3C;SACF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,KAA8B;IACrE,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAA8B;IACzD,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,0BAA0B,CAAC;QAChE,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC1C,cAAc,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,qBAAqB,CAAC;QAC/D,aAAa,EAAE,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC;QACpE,iBAAiB,EAAE,CAAC,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,wBAAwB,CAAC;KACjF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAuB;IACjD,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,wBAAwB,CAAC;QAC/C,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,4BAA4B,CAAC;QAC3D,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC;QACrD,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAiC;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,kCAAkC,CAAC;QAC1D,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,sCAAsC,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,IAA+B;IAC3D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,cAAc,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;IACjG,CAAC;IACD,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,iCAAiC,CAAC;QACxD,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,oCAAoC,CAAC;QACjE,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAmC;IACnE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO;QACL,EAAE,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,iCAAiC,CAAC;QACxD,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,0CAA0C,CAAC;QACnF,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,uCAAuC,CAAC;QAC1E,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,KAAa;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IACtE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/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/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/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

package/dist/KeyframeEditor.js.map

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

package/dist/MultiUserReviewWorkflow.d.ts

@@ -0,0 +1,77 @@
+export type ReviewParticipantRole = "owner" | "reviewer" | "animator" | "audio" | "viewer";
+export type ReviewDecisionStatus = "pending" | "approved" | "changes-requested";
+export type ReviewWorkflowStatus = "draft" | "needs-review" | "changes-requested" | "approved";
+export interface ReviewParticipant {
+    readonly id: string;
+    readonly name: string;
+    readonly role: ReviewParticipantRole;
+    readonly active?: boolean | undefined;
+}
+export interface ReviewThread {
+    readonly id: string;
+    readonly authorId: string;
+    readonly text: string;
+    readonly time?: number | undefined;
+    readonly frame?: number | undefined;
+    readonly assignedTo?: string | undefined;
+    readonly resolved: boolean;
+}
+export interface ReviewDecision {
+    readonly reviewerId: string;
+    readonly status: ReviewDecisionStatus;
+    readonly at: string;
+    readonly note?: string | undefined;
+}
+export interface MultiUserReviewWorkflowState {
+    readonly packageId: string;
+    readonly status?: ReviewWorkflowStatus | undefined;
+    readonly requiredReviewerCount?: number | undefined;
+    readonly participants: readonly ReviewParticipant[];
+    readonly threads: readonly ReviewThread[];
+    readonly decisions: readonly ReviewDecision[];
+}
+export interface MultiUserReviewWorkflowSnapshot {
+    readonly kind: "multi-user-review-workflow";
+    readonly packageId: string;
+    readonly status: ReviewWorkflowStatus;
+    readonly participantCount: number;
+    readonly activeParticipantCount: number;
+    readonly reviewerCount: number;
+    readonly requiredReviewerCount: number;
+    readonly approvedReviewerCount: number;
+    readonly changeRequestCount: number;
+    readonly threadCount: number;
+    readonly unresolvedThreadCount: number;
+    readonly assignedThreadCount: number;
+    readonly canPublish: boolean;
+    readonly participants: readonly ReviewParticipant[];
+    readonly threads: readonly ReviewThread[];
+    readonly decisions: readonly ReviewDecision[];
+    readonly evidence: {
+        readonly multiUserReview: boolean;
+        readonly assignmentWorkflow: boolean;
+        readonly reviewerQuorum: boolean;
+        readonly publishBlockedByOpenThreads: boolean;
+    };
+}
+export declare class MultiUserReviewWorkflow {
+    private packageId;
+    private status;
+    private requiredReviewerCount;
+    private participants;
+    private threads;
+    private decisions;
+    constructor(state: MultiUserReviewWorkflowState);
+    addParticipant(participant: ReviewParticipant): MultiUserReviewWorkflowSnapshot;
+    addThread(thread: ReviewThread): MultiUserReviewWorkflowSnapshot;
+    assignThread(threadId: string, participantId: string): MultiUserReviewWorkflowSnapshot;
+    resolveThread(threadId: string): MultiUserReviewWorkflowSnapshot;
+    recordDecision(decision: ReviewDecision): MultiUserReviewWorkflowSnapshot;
+    markNeedsReview(): MultiUserReviewWorkflowSnapshot;
+    serialize(): MultiUserReviewWorkflowState;
+    snapshot(): MultiUserReviewWorkflowSnapshot;
+    private requireParticipant;
+    private requireThread;
+}
+export declare function createMultiUserReviewWorkflow(state: MultiUserReviewWorkflowState): MultiUserReviewWorkflow;
+//# sourceMappingURL=MultiUserReviewWorkflow.d.ts.map

package/dist/MultiUserReviewWorkflow.d.ts.map

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

package/dist/MultiUserReviewWorkflow.js

@@ -0,0 +1,162 @@
+export class MultiUserReviewWorkflow {
+    packageId;
+    status;
+    requiredReviewerCount;
+    participants = new Map();
+    threads = new Map();
+    decisions = new Map();
+    constructor(state) {
+        this.packageId = nonEmpty(state.packageId, "Review package id");
+        this.status = state.status ?? "needs-review";
+        this.requiredReviewerCount = Math.max(1, Math.floor(state.requiredReviewerCount ?? 1));
+        for (const participant of state.participants)
+            this.addParticipant(participant);
+        for (const thread of state.threads)
+            this.addThread(thread);
+        for (const decision of state.decisions)
+            this.recordDecision(decision);
+    }
+    addParticipant(participant) {
+        const clean = sanitizeParticipant(participant);
+        this.participants.set(clean.id, clean);
+        return this.snapshot();
+    }
+    addThread(thread) {
+        const clean = sanitizeThread(thread);
+        this.requireParticipant(clean.authorId);
+        if (clean.assignedTo)
+            this.requireParticipant(clean.assignedTo);
+        this.threads.set(clean.id, clean);
+        if (!clean.resolved && this.status === "approved")
+            this.status = "changes-requested";
+        return this.snapshot();
+    }
+    assignThread(threadId, participantId) {
+        this.requireParticipant(participantId);
+        const thread = this.requireThread(threadId);
+        this.threads.set(threadId, { ...thread, assignedTo: participantId });
+        return this.snapshot();
+    }
+    resolveThread(threadId) {
+        const thread = this.requireThread(threadId);
+        this.threads.set(threadId, { ...thread, resolved: true });
+        return this.snapshot();
+    }
+    recordDecision(decision) {
+        const clean = sanitizeDecision(decision);
+        const participant = this.requireParticipant(clean.reviewerId);
+        if (participant.role !== "reviewer" && participant.role !== "owner") {
+            throw new Error(`Review participant "${clean.reviewerId}" is not allowed to approve or request changes.`);
+        }
+        this.decisions.set(clean.reviewerId, clean);
+        if (clean.status === "changes-requested")
+            this.status = "changes-requested";
+        else if (this.snapshot().canPublish)
+            this.status = "approved";
+        return this.snapshot();
+    }
+    markNeedsReview() {
+        this.status = "needs-review";
+        return this.snapshot();
+    }
+    serialize() {
+        return {
+            packageId: this.packageId,
+            status: this.status,
+            requiredReviewerCount: this.requiredReviewerCount,
+            participants: [...this.participants.values()],
+            threads: [...this.threads.values()],
+            decisions: [...this.decisions.values()]
+        };
+    }
+    snapshot() {
+        const participants = [...this.participants.values()];
+        const threads = [...this.threads.values()];
+        const decisions = [...this.decisions.values()];
+        const reviewerCount = participants.filter((participant) => participant.role === "owner" || participant.role === "reviewer").length;
+        const approvedReviewerCount = decisions.filter((decision) => decision.status === "approved").length;
+        const changeRequestCount = decisions.filter((decision) => decision.status === "changes-requested").length;
+        const unresolvedThreadCount = threads.filter((thread) => !thread.resolved).length;
+        const canPublish = approvedReviewerCount >= this.requiredReviewerCount && changeRequestCount === 0 && unresolvedThreadCount === 0;
+        const status = canPublish ? "approved" : changeRequestCount > 0 ? "changes-requested" : this.status === "draft" ? "draft" : "needs-review";
+        return {
+            kind: "multi-user-review-workflow",
+            packageId: this.packageId,
+            status,
+            participantCount: participants.length,
+            activeParticipantCount: participants.filter((participant) => participant.active !== false).length,
+            reviewerCount,
+            requiredReviewerCount: this.requiredReviewerCount,
+            approvedReviewerCount,
+            changeRequestCount,
+            threadCount: threads.length,
+            unresolvedThreadCount,
+            assignedThreadCount: threads.filter((thread) => Boolean(thread.assignedTo)).length,
+            canPublish,
+            participants,
+            threads,
+            decisions,
+            evidence: {
+                multiUserReview: participants.length > 1,
+                assignmentWorkflow: threads.some((thread) => Boolean(thread.assignedTo)),
+                reviewerQuorum: approvedReviewerCount >= this.requiredReviewerCount,
+                publishBlockedByOpenThreads: unresolvedThreadCount > 0
+            }
+        };
+    }
+    requireParticipant(id) {
+        const participant = this.participants.get(id);
+        if (!participant)
+            throw new Error(`Unknown review participant: ${id}`);
+        return participant;
+    }
+    requireThread(id) {
+        const thread = this.threads.get(id);
+        if (!thread)
+            throw new Error(`Unknown review thread: ${id}`);
+        return thread;
+    }
+}
+export function createMultiUserReviewWorkflow(state) {
+    return new MultiUserReviewWorkflow(state);
+}
+function sanitizeParticipant(participant) {
+    return {
+        id: nonEmpty(participant.id, "Review participant id"),
+        name: nonEmpty(participant.name, "Review participant name"),
+        role: participant.role,
+        active: participant.active
+    };
+}
+function sanitizeThread(thread) {
+    if (thread.time !== undefined && (!Number.isFinite(thread.time) || thread.time < 0)) {
+        throw new Error("Review thread time must be a non-negative finite number.");
+    }
+    if (thread.frame !== undefined && (!Number.isInteger(thread.frame) || thread.frame < 0)) {
+        throw new Error("Review thread frame must be a non-negative integer.");
+    }
+    return {
+        id: nonEmpty(thread.id, "Review thread id"),
+        authorId: nonEmpty(thread.authorId, "Review thread author"),
+        text: nonEmpty(thread.text, "Review thread text"),
+        time: thread.time,
+        frame: thread.frame,
+        assignedTo: thread.assignedTo,
+        resolved: thread.resolved
+    };
+}
+function sanitizeDecision(decision) {
+    return {
+        reviewerId: nonEmpty(decision.reviewerId, "Review decision reviewer"),
+        status: decision.status,
+        at: nonEmpty(decision.at, "Review decision timestamp"),
+        note: decision.note
+    };
+}
+function nonEmpty(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new Error(`${label} must be a non-empty string.`);
+    return trimmed;
+}
+//# sourceMappingURL=MultiUserReviewWorkflow.js.map