@aura3d/engine 1.0.10 → 1.3.0

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

@@ -0,0 +1,54 @@
+import type { AnimationClipEventType, SerializedAnimationEventTracks } from "@aura3d/animation";
+export interface EventMarkerView {
+    readonly id: string;
+    readonly time: number;
+    readonly duration?: number;
+    readonly type: AnimationClipEventType;
+    readonly selected: boolean;
+}
+export interface EventTrackLane {
+    readonly name: string;
+    readonly type: AnimationClipEventType;
+    readonly markers: readonly EventMarkerView[];
+}
+export interface EventTrackEditorOptions {
+    readonly clipId: string;
+    readonly duration: number;
+}
+export interface AddEventMarkerOptions {
+    readonly id?: string;
+    readonly type?: AnimationClipEventType;
+    /** Window length (seconds). >0 makes the marker an active-frame window (e.g. hitbox on/off). */
+    readonly duration?: number;
+    readonly payload?: unknown;
+    readonly tags?: readonly string[];
+}
+/**
+ * Timeline event-track authoring controller. Deterministic: marker ids come from a monotonic
+ * counter (no `Date.now`/`Math.random`), so undo/redo and serialization are reproducible.
+ */
+export declare class EventTrackEditor {
+    readonly clipId: string;
+    duration: number;
+    private readonly order;
+    private readonly lanesMap;
+    private selectedId;
+    private idCounter;
+    constructor(options: EventTrackEditorOptions);
+    addTrack(name: string, type?: AnimationClipEventType): this;
+    removeTrack(name: string): this;
+    /** Add a marker to a lane (auto-creates the lane). Returns the new marker id. */
+    addMarker(trackName: string, time: number, options?: AddEventMarkerOptions): string;
+    /** Move an existing marker to a new time. */
+    moveMarker(trackName: string, markerId: string, time: number): this;
+    /** Delete a marker. */
+    removeMarker(trackName: string, markerId: string): this;
+    select(markerId: string | undefined): this;
+    markerCount(): number;
+    /** View-model for the timeline UI: lanes with marker positions + selection state. */
+    lanes(): readonly EventTrackLane[];
+    /** Serialize to the canonical `animation-event-tracks/v1` shape. */
+    serialize(): SerializedAnimationEventTracks;
+}
+export declare function createEventTrackEditor(options: EventTrackEditorOptions): EventTrackEditor;
+//# sourceMappingURL=EventTrackEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EventTrackEditor.d.ts","sourceRoot":"","sources":["../../../../packages/editor-runtime/src/EventTrackEditor.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,sBAAsB,EAEtB,8BAA8B,EAC/B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IACvC,gGAAgG;IAChG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAOD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IACzD,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAK;gBAEV,OAAO,EAAE,uBAAuB;IAQ5C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,sBAAiC,GAAG,IAAI;IAQrE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK/B,iFAAiF;IACjF,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,MAAM;IAoBvF,6CAA6C;IAC7C,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAYnE,uBAAuB;IACvB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IASvD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAK1C,WAAW,IAAI,MAAM;IAMrB,qFAAqF;IACrF,KAAK,IAAI,SAAS,cAAc,EAAE;IAiBlC,oEAAoE;IACpE,SAAS,IAAI,8BAA8B;CAO5C;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB,CAEzF"}

package/dist/editor-runtime/EventTrackEditor.js

@@ -0,0 +1,124 @@
+// Editor authoring controller for animation event tracks (T2.2). Lets a timeline UI add / move /
+// delete typed markers on named lanes (hitbox active-frames, footsteps, VFX, generic markers) and
+// serialize to the canonical `animation-event-tracks/v1` shape that `@aura3d/animation`'s
+// `deserializeAnimationEventTracks` / `sampleClipEvents` consume — so authored tracks drive gameplay
+// (hitbox windows) and playback (footstep/VFX triggers) deterministically.
+//
+// Type-only imports from `@aura3d/animation` keep this controller free of any runtime coupling to
+// that package (the types are erased at build time); the serialized output is verified to round-trip
+// through the animation package's deserializer in tests.
+/**
+ * Timeline event-track authoring controller. Deterministic: marker ids come from a monotonic
+ * counter (no `Date.now`/`Math.random`), so undo/redo and serialization are reproducible.
+ */
+export class EventTrackEditor {
+    clipId;
+    duration;
+    order = [];
+    lanesMap = new Map();
+    selectedId;
+    idCounter = 0;
+    constructor(options) {
+        if (!Number.isFinite(options.duration) || options.duration < 0) {
+            throw new Error("EventTrackEditor duration must be a finite, non-negative number.");
+        }
+        this.clipId = options.clipId;
+        this.duration = options.duration;
+    }
+    addTrack(name, type = "marker") {
+        if (!this.lanesMap.has(name)) {
+            this.lanesMap.set(name, { type, markers: [] });
+            this.order.push(name);
+        }
+        return this;
+    }
+    removeTrack(name) {
+        if (this.lanesMap.delete(name))
+            this.order.splice(this.order.indexOf(name), 1);
+        return this;
+    }
+    /** Add a marker to a lane (auto-creates the lane). Returns the new marker id. */
+    addMarker(trackName, time, options = {}) {
+        if (!Number.isFinite(time) || time < 0) {
+            throw new Error("Event marker time must be a finite, non-negative number.");
+        }
+        this.addTrack(trackName, options.type);
+        const lane = this.lanesMap.get(trackName);
+        const id = options.id ?? `${trackName}#${this.idCounter++}`;
+        lane.markers.push({
+            id,
+            name: trackName,
+            type: options.type ?? lane.type,
+            time,
+            ...(options.duration !== undefined ? { duration: options.duration } : {}),
+            ...(options.payload !== undefined ? { payload: options.payload } : {}),
+            ...(options.tags !== undefined ? { tags: options.tags } : {})
+        });
+        lane.markers.sort((a, b) => a.time - b.time);
+        return id;
+    }
+    /** Move an existing marker to a new time. */
+    moveMarker(trackName, markerId, time) {
+        if (!Number.isFinite(time) || time < 0) {
+            throw new Error("Event marker time must be a finite, non-negative number.");
+        }
+        const lane = this.lanesMap.get(trackName);
+        const index = lane?.markers.findIndex((m) => m.id === markerId) ?? -1;
+        if (!lane || index < 0)
+            throw new Error(`Marker ${markerId} not found on track ${trackName}.`);
+        lane.markers[index] = { ...lane.markers[index], time };
+        lane.markers.sort((a, b) => a.time - b.time);
+        return this;
+    }
+    /** Delete a marker. */
+    removeMarker(trackName, markerId) {
+        const lane = this.lanesMap.get(trackName);
+        if (!lane)
+            return this;
+        const index = lane.markers.findIndex((m) => m.id === markerId);
+        if (index >= 0)
+            lane.markers.splice(index, 1);
+        if (this.selectedId === markerId)
+            this.selectedId = undefined;
+        return this;
+    }
+    select(markerId) {
+        this.selectedId = markerId;
+        return this;
+    }
+    markerCount() {
+        let count = 0;
+        for (const lane of this.lanesMap.values())
+            count += lane.markers.length;
+        return count;
+    }
+    /** View-model for the timeline UI: lanes with marker positions + selection state. */
+    lanes() {
+        return this.order.map((name) => {
+            const lane = this.lanesMap.get(name);
+            return {
+                name,
+                type: lane.type,
+                markers: lane.markers.map((m) => ({
+                    id: m.id,
+                    time: m.time,
+                    ...(m.duration !== undefined ? { duration: m.duration } : {}),
+                    type: m.type ?? lane.type,
+                    selected: m.id === this.selectedId
+                }))
+            };
+        });
+    }
+    /** Serialize to the canonical `animation-event-tracks/v1` shape. */
+    serialize() {
+        const tracks = this.order.map((name) => {
+            const lane = this.lanesMap.get(name);
+            return { name, type: lane.type, markers: lane.markers.map((m) => ({ ...m })) };
+        });
+        return { schema: "animation-event-tracks/v1", clipId: this.clipId, duration: this.duration, tracks };
+    }
+}
+export function createEventTrackEditor(options) {
+    return new EventTrackEditor(options);
+}
+//# sourceMappingURL=EventTrackEditor.js.map

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

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

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

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

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

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

@@ -0,0 +1,81 @@
+import { type TimelineEditorSnapshot } from "./TimelineEditorController";
+import { type TimelineClipConfig, type TimelineModelConfig, type TimelineTrackConfig } from "./TimelineModel";
+import { type TimelineEditorTrackKind } from "./TimelineTrackTypes";
+export type NonlinearBinAssetKind = "animation" | "audio" | "camera" | "shot" | "sequence" | "caption" | "viseme";
+export interface NonlinearBinAsset {
+    readonly id: string;
+    readonly name: string;
+    readonly kind: NonlinearBinAssetKind;
+    readonly assetId?: string | undefined;
+    readonly clipName?: string | undefined;
+    readonly duration?: number | undefined;
+    readonly metadata?: Readonly<Record<string, string | number | boolean>> | undefined;
+}
+export interface NonlinearSequenceConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly timeline?: TimelineModelConfig | undefined;
+}
+export interface NonlinearSequenceSnapshot {
+    readonly id: string;
+    readonly name: string;
+    readonly trackCount: number;
+    readonly clipCount: number;
+    readonly duration: number;
+}
+export interface NonlinearAnimationEditorSnapshot {
+    readonly kind: "nonlinear-animation-editor";
+    readonly activeSequenceId: string;
+    readonly sequenceCount: number;
+    readonly binAssetCount: number;
+    readonly nestedSequenceClipCount: number;
+    readonly totalTrackCount: number;
+    readonly totalClipCount: number;
+    readonly sequences: readonly NonlinearSequenceSnapshot[];
+    readonly activeTimeline: TimelineEditorSnapshot;
+    readonly evidence: {
+        readonly nonlinearSequences: boolean;
+        readonly trimSplitMoveDuplicate: boolean;
+        readonly nestedSequences: boolean;
+        readonly multiTrackTimeline: boolean;
+        readonly serialization: true;
+    };
+}
+export interface NonlinearAnimationEditorState {
+    readonly activeSequenceId: string;
+    readonly binAssets: readonly NonlinearBinAsset[];
+    readonly sequences: readonly NonlinearSequenceConfig[];
+}
+export declare class NonlinearAnimationEditor {
+    private readonly binAssets;
+    private readonly sequences;
+    private activeSequenceId;
+    constructor(state: NonlinearAnimationEditorState);
+    addBinAsset(asset: NonlinearBinAsset): NonlinearBinAsset;
+    createSequence(config: NonlinearSequenceConfig): NonlinearSequenceSnapshot;
+    selectSequence(sequenceId: string): NonlinearAnimationEditorSnapshot;
+    addTrack(kind: TimelineEditorTrackKind, name?: string, options?: Omit<TimelineTrackConfig, "name" | "type">): Promise<string>;
+    insertAssetClip(trackId: string, assetId: string, options: Omit<TimelineClipConfig, "name" | "startTime" | "duration" | "assetId" | "clipName"> & {
+        readonly id?: string | undefined;
+        readonly name?: string | undefined;
+        readonly startTime: number;
+        readonly duration?: number | undefined;
+    }): Promise<string>;
+    insertNestedSequence(trackId: string, sequenceId: string, options: Omit<TimelineClipConfig, "name" | "startTime" | "duration"> & {
+        readonly id?: string | undefined;
+        readonly startTime: number;
+        readonly duration?: number | undefined;
+    }): Promise<string>;
+    moveClip(clipId: string, startTime: number): Promise<void>;
+    trimClip(clipId: string, duration: number, startTime?: number): Promise<void>;
+    splitClip(clipId: string, splitTime: number): Promise<readonly string[]>;
+    duplicateClip(clipId: string, timeOffset?: number): Promise<string>;
+    serialize(): NonlinearAnimationEditorState;
+    snapshot(): NonlinearAnimationEditorSnapshot;
+    private activeSequence;
+    private requireSequence;
+    private requireBinAsset;
+    private sequenceSnapshot;
+}
+export declare function createNonlinearAnimationEditor(state: NonlinearAnimationEditorState): NonlinearAnimationEditor;
+//# sourceMappingURL=NonlinearAnimationEditor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NonlinearAnimationEditor.d.ts","sourceRoot":"","sources":["../../../../packages/editor-runtime/src/NonlinearAnimationEditor.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAiB,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7H,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/F,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CACrF;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACrD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACzD,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;QACrC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;QACzC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;QAClC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;QACrC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACxD;AAQD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+C;IACzE,OAAO,CAAC,gBAAgB,CAAS;gBAErB,KAAK,EAAE,6BAA6B;IAQhD,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB;IAMxD,cAAc,CAAC,MAAM,EAAE,uBAAuB,GAAG,yBAAyB;IAkB1E,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,gCAAgC;IAK9D,QAAQ,CAAC,IAAI,EAAE,uBAAuB,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKjI,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC,GAAG;QACtJ,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACxC,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBb,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC,GAAG;QACrI,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACxC,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBb,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAKxE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzE,SAAS,IAAI,6BAA6B;IAY1C,QAAQ,IAAI,gCAAgC;IA4B5C,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,gBAAgB;CAUzB;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,6BAA6B,GAAG,wBAAwB,CAE7G"}