aivee 0.1.0-alpha.0 → 0.1.0-dev.d34a6ba

package/src/timeline/history.mjs

@@ -1,69 +1,69 @@
-import { editTimeline, editTimelineBatch } from './edit.mjs';
-import { validateTimeline } from './validate.mjs';
-
-const DEFAULT_HISTORY_LIMIT = 100;
-
-/** Create an isolated, bounded undo/redo history for immutable timeline edits. */
-export function createTimelineHistory(timeline, { limit = DEFAULT_HISTORY_LIMIT } = {}) {
-  if (!Number.isSafeInteger(limit) || limit < 1 || limit > 10_000) {
-    throw new TypeError('Timeline history limit must be an integer from 1 to 10000.');
-  }
-
-  validateTimeline(timeline);
-  let current = structuredClone(timeline);
-  const undoStack = [];
-  const redoStack = [];
-
-  return Object.freeze({
-    get current() {
-      return structuredClone(current);
-    },
-    get canUndo() {
-      return undoStack.length > 0;
-    },
-    get canRedo() {
-      return redoStack.length > 0;
-    },
-    get undoDepth() {
-      return undoStack.length;
-    },
-    get redoDepth() {
-      return redoStack.length;
-    },
-    apply(operation) {
-      const next = editTimeline(current, operation);
-      undoStack.push(current);
-      if (undoStack.length > limit) undoStack.shift();
-      current = next;
-      redoStack.length = 0;
-      return structuredClone(current);
-    },
-    applyBatch(operations) {
-      const next = editTimelineBatch(current, operations);
-      undoStack.push(current);
-      if (undoStack.length > limit) undoStack.shift();
-      current = next;
-      redoStack.length = 0;
-      return structuredClone(current);
-    },
-    undo() {
-      if (undoStack.length === 0) return structuredClone(current);
-      redoStack.push(current);
-      current = undoStack.pop();
-      return structuredClone(current);
-    },
-    redo() {
-      if (redoStack.length === 0) return structuredClone(current);
-      undoStack.push(current);
-      current = redoStack.pop();
-      return structuredClone(current);
-    },
-    reset(nextTimeline) {
-      validateTimeline(nextTimeline);
-      current = structuredClone(nextTimeline);
-      undoStack.length = 0;
-      redoStack.length = 0;
-      return structuredClone(current);
-    },
-  });
-}
+import { editTimeline, editTimelineBatch } from './edit.mjs';
+import { validateTimeline } from './validate.mjs';
+
+const DEFAULT_HISTORY_LIMIT = 100;
+
+/** Create an isolated, bounded undo/redo history for immutable timeline edits. */
+export function createTimelineHistory(timeline, { limit = DEFAULT_HISTORY_LIMIT } = {}) {
+  if (!Number.isSafeInteger(limit) || limit < 1 || limit > 10_000) {
+    throw new TypeError('Timeline history limit must be an integer from 1 to 10000.');
+  }
+
+  validateTimeline(timeline);
+  let current = structuredClone(timeline);
+  const undoStack = [];
+  const redoStack = [];
+
+  return Object.freeze({
+    get current() {
+      return structuredClone(current);
+    },
+    get canUndo() {
+      return undoStack.length > 0;
+    },
+    get canRedo() {
+      return redoStack.length > 0;
+    },
+    get undoDepth() {
+      return undoStack.length;
+    },
+    get redoDepth() {
+      return redoStack.length;
+    },
+    apply(operation) {
+      const next = editTimeline(current, operation);
+      undoStack.push(current);
+      if (undoStack.length > limit) undoStack.shift();
+      current = next;
+      redoStack.length = 0;
+      return structuredClone(current);
+    },
+    applyBatch(operations) {
+      const next = editTimelineBatch(current, operations);
+      undoStack.push(current);
+      if (undoStack.length > limit) undoStack.shift();
+      current = next;
+      redoStack.length = 0;
+      return structuredClone(current);
+    },
+    undo() {
+      if (undoStack.length === 0) return structuredClone(current);
+      redoStack.push(current);
+      current = undoStack.pop();
+      return structuredClone(current);
+    },
+    redo() {
+      if (redoStack.length === 0) return structuredClone(current);
+      undoStack.push(current);
+      current = redoStack.pop();
+      return structuredClone(current);
+    },
+    reset(nextTimeline) {
+      validateTimeline(nextTimeline);
+      current = structuredClone(nextTimeline);
+      undoStack.length = 0;
+      redoStack.length = 0;
+      return structuredClone(current);
+    },
+  });
+}

package/src/timeline/inspect.mjs

@@ -1,117 +1,117 @@
-import { validateTimeline } from './validate.mjs';
-
-/** Return a compact, deterministic editing overview for agents and review tools. */
-export function inspectTimeline(timeline) {
-  validateTimeline(timeline);
-  const assets = new Map(timeline.assets.map((asset) => [asset.id, asset]));
-  const tracks = [...timeline.tracks]
-    .sort((left, right) => left.order - right.order)
-    .map((track) => {
-      const clips = [...track.clips]
-        .sort((left, right) => left.timelineStart - right.timelineStart
-          || (left.id < right.id ? -1 : left.id > right.id ? 1 : 0))
-        .map((clip) => inspectClip(track, clip, assets.get(clip.assetId)));
-      return {
-        id: track.id,
-        kind: track.kind,
-        order: track.order,
-        ...(track.name === undefined ? {} : { name: track.name }),
-        ...(track.visible === undefined ? {} : { visible: track.visible }),
-        ...(track.muted === undefined ? {} : { muted: track.muted }),
-        ...(track.solo === undefined ? {} : { solo: track.solo }),
-        ...(track.locked === undefined ? {} : { locked: track.locked }),
-        ...(track.volume === undefined ? {} : { volume: track.volume }),
-        ...(track.volumeKeyframes === undefined ? {} : { volumeKeyframes: structuredClone(track.volumeKeyframes) }),
-        ...(track.audioEffects === undefined ? {} : { audioEffects: structuredClone(track.audioEffects) }),
-        ...(track.allowOverlap === undefined ? {} : { allowOverlap: track.allowOverlap }),
-        clipCount: clips.length,
-        clips,
-      };
-    });
-
-  const clipCounts = Object.fromEntries(['video', 'audio', 'overlay'].map((kind) => [
-    kind,
-    tracks.filter((track) => track.kind === kind).reduce((total, track) => total + track.clipCount, 0),
-  ]));
-  return {
-    schemaVersion: 1,
-    project: {
-      id: timeline.project.id,
-      width: timeline.project.width,
-      height: timeline.project.height,
-      fps: timeline.project.fps,
-      durationSeconds: timeline.project.durationSeconds,
-      ...(timeline.project.sourceFit === undefined ? {} : { sourceFit: timeline.project.sourceFit }),
-      ...(timeline.project.backgroundColor === undefined ? {} : { backgroundColor: timeline.project.backgroundColor }),
-    },
-    ...(timeline.audioMix === undefined ? {} : { audioMix: structuredClone(timeline.audioMix) }),
-    ...(timeline.audioMastering === undefined ? {} : { audioMastering: structuredClone(timeline.audioMastering) }),
-    ...(timeline.lineage === undefined ? {} : { lineage: structuredClone(timeline.lineage) }),
-    markers: [...(timeline.markers ?? [])]
-      .sort((left, right) => left.timeSeconds - right.timeSeconds || (left.id < right.id ? -1 : left.id > right.id ? 1 : 0))
-      .map((marker) => structuredClone(marker)),
-    summary: {
-      assetCount: timeline.assets.length,
-      trackCount: tracks.length,
-      clipCount: Object.values(clipCounts).reduce((total, count) => total + count, 0),
-      clipCounts,
-      markerCount: timeline.markers?.length ?? 0,
-    },
-    assets: timeline.assets.map((asset) => ({
-      id: asset.id,
-      path: asset.path,
-      ...(asset.type === undefined ? {} : { type: asset.type }),
-      ...(asset.durationSeconds === undefined ? {} : { durationSeconds: asset.durationSeconds }),
-      ...(asset.width === undefined ? {} : { width: asset.width }),
-      ...(asset.height === undefined ? {} : { height: asset.height }),
-      ...(asset.frameRate === undefined ? {} : { frameRate: asset.frameRate }),
-      ...(asset.hasAudio === undefined ? {} : { hasAudio: asset.hasAudio }),
-      ...(asset.videoStreams === undefined ? {} : { videoStreams: structuredClone(asset.videoStreams) }),
-      ...(asset.audioStreams === undefined ? {} : { audioStreams: structuredClone(asset.audioStreams) }),
-      ...(asset.streamTiming === undefined ? {} : { streamTiming: structuredClone(asset.streamTiming) }),
-      ...(asset.proxies === undefined ? {} : { proxies: structuredClone(asset.proxies) }),
-    })),
-    tracks,
-  };
-}
-
-function inspectClip(track, clip, asset) {
-  const result = {
-    id: clip.id,
-    assetId: clip.assetId ?? null,
-    ...(clip.enabled === undefined ? {} : { enabled: clip.enabled }),
-    mediaType: track.kind === 'overlay' ? (clip.text === undefined ? 'composition' : 'text') : asset?.type ?? track.kind,
-    timeline: {
-      startSeconds: clip.timelineStart,
-      endSeconds: roundInspectionSeconds(clip.timelineStart + clip.durationSeconds),
-      durationSeconds: clip.durationSeconds,
-    },
-  };
-  if (track.kind !== 'overlay') {
-    result.source = {
-      inSeconds: clip.sourceIn,
-      outSeconds: clip.sourceOut,
-      ...(clip.playbackRate === undefined ? {} : { playbackRate: clip.playbackRate }),
-      ...(clip.speedRamp === undefined ? {} : { speedRamp: clip.speedRamp }),
-      ...(clip.reverse === undefined ? {} : { reverse: clip.reverse }),
-      ...(clip.videoStreamIndex === undefined ? {} : { videoStreamIndex: clip.videoStreamIndex }),
-    };
-  }
-  for (const field of [
-    'text', 'x', 'y', 'width', 'height', 'fontFamily', 'fontSize', 'fontWeight',
-    'lineHeight', 'verticalAlign', 'paddingPixels', 'color', 'backgroundColor',
-    'textAlign', 'textOutline', 'textShadow', 'wordTimings', 'wordHighlightColor',
-    'wordHighlightAnimation', 'volume', 'fadeInSeconds', 'fadeOutSeconds',
-    'bubble',
-    'audioEffects', 'volumeKeyframes',
-    'transitionIn', 'transitionOut', 'blendMode', 'keyframes', 'effects', 'mask',
-    'sourceFit',
-  ]) {
-    if (clip[field] !== undefined) result[field] = structuredClone(clip[field]);
-  }
-  return result;
-}
-
-function roundInspectionSeconds(seconds) {
-  return Number(seconds.toFixed(6));
-}
+import { validateTimeline } from './validate.mjs';
+
+/** Return a compact, deterministic editing overview for agents and review tools. */
+export function inspectTimeline(timeline) {
+  validateTimeline(timeline);
+  const assets = new Map(timeline.assets.map((asset) => [asset.id, asset]));
+  const tracks = [...timeline.tracks]
+    .sort((left, right) => left.order - right.order)
+    .map((track) => {
+      const clips = [...track.clips]
+        .sort((left, right) => left.timelineStart - right.timelineStart
+          || (left.id < right.id ? -1 : left.id > right.id ? 1 : 0))
+        .map((clip) => inspectClip(track, clip, assets.get(clip.assetId)));
+      return {
+        id: track.id,
+        kind: track.kind,
+        order: track.order,
+        ...(track.name === undefined ? {} : { name: track.name }),
+        ...(track.visible === undefined ? {} : { visible: track.visible }),
+        ...(track.muted === undefined ? {} : { muted: track.muted }),
+        ...(track.solo === undefined ? {} : { solo: track.solo }),
+        ...(track.locked === undefined ? {} : { locked: track.locked }),
+        ...(track.volume === undefined ? {} : { volume: track.volume }),
+        ...(track.volumeKeyframes === undefined ? {} : { volumeKeyframes: structuredClone(track.volumeKeyframes) }),
+        ...(track.audioEffects === undefined ? {} : { audioEffects: structuredClone(track.audioEffects) }),
+        ...(track.allowOverlap === undefined ? {} : { allowOverlap: track.allowOverlap }),
+        clipCount: clips.length,
+        clips,
+      };
+    });
+
+  const clipCounts = Object.fromEntries(['video', 'audio', 'overlay'].map((kind) => [
+    kind,
+    tracks.filter((track) => track.kind === kind).reduce((total, track) => total + track.clipCount, 0),
+  ]));
+  return {
+    schemaVersion: 1,
+    project: {
+      id: timeline.project.id,
+      width: timeline.project.width,
+      height: timeline.project.height,
+      fps: timeline.project.fps,
+      durationSeconds: timeline.project.durationSeconds,
+      ...(timeline.project.sourceFit === undefined ? {} : { sourceFit: timeline.project.sourceFit }),
+      ...(timeline.project.backgroundColor === undefined ? {} : { backgroundColor: timeline.project.backgroundColor }),
+    },
+    ...(timeline.audioMix === undefined ? {} : { audioMix: structuredClone(timeline.audioMix) }),
+    ...(timeline.audioMastering === undefined ? {} : { audioMastering: structuredClone(timeline.audioMastering) }),
+    ...(timeline.lineage === undefined ? {} : { lineage: structuredClone(timeline.lineage) }),
+    markers: [...(timeline.markers ?? [])]
+      .sort((left, right) => left.timeSeconds - right.timeSeconds || (left.id < right.id ? -1 : left.id > right.id ? 1 : 0))
+      .map((marker) => structuredClone(marker)),
+    summary: {
+      assetCount: timeline.assets.length,
+      trackCount: tracks.length,
+      clipCount: Object.values(clipCounts).reduce((total, count) => total + count, 0),
+      clipCounts,
+      markerCount: timeline.markers?.length ?? 0,
+    },
+    assets: timeline.assets.map((asset) => ({
+      id: asset.id,
+      path: asset.path,
+      ...(asset.type === undefined ? {} : { type: asset.type }),
+      ...(asset.durationSeconds === undefined ? {} : { durationSeconds: asset.durationSeconds }),
+      ...(asset.width === undefined ? {} : { width: asset.width }),
+      ...(asset.height === undefined ? {} : { height: asset.height }),
+      ...(asset.frameRate === undefined ? {} : { frameRate: asset.frameRate }),
+      ...(asset.hasAudio === undefined ? {} : { hasAudio: asset.hasAudio }),
+      ...(asset.videoStreams === undefined ? {} : { videoStreams: structuredClone(asset.videoStreams) }),
+      ...(asset.audioStreams === undefined ? {} : { audioStreams: structuredClone(asset.audioStreams) }),
+      ...(asset.streamTiming === undefined ? {} : { streamTiming: structuredClone(asset.streamTiming) }),
+      ...(asset.proxies === undefined ? {} : { proxies: structuredClone(asset.proxies) }),
+    })),
+    tracks,
+  };
+}
+
+function inspectClip(track, clip, asset) {
+  const result = {
+    id: clip.id,
+    assetId: clip.assetId ?? null,
+    ...(clip.enabled === undefined ? {} : { enabled: clip.enabled }),
+    mediaType: track.kind === 'overlay' ? (clip.text === undefined ? 'composition' : 'text') : asset?.type ?? track.kind,
+    timeline: {
+      startSeconds: clip.timelineStart,
+      endSeconds: roundInspectionSeconds(clip.timelineStart + clip.durationSeconds),
+      durationSeconds: clip.durationSeconds,
+    },
+  };
+  if (track.kind !== 'overlay') {
+    result.source = {
+      inSeconds: clip.sourceIn,
+      outSeconds: clip.sourceOut,
+      ...(clip.playbackRate === undefined ? {} : { playbackRate: clip.playbackRate }),
+      ...(clip.speedRamp === undefined ? {} : { speedRamp: clip.speedRamp }),
+      ...(clip.reverse === undefined ? {} : { reverse: clip.reverse }),
+      ...(clip.videoStreamIndex === undefined ? {} : { videoStreamIndex: clip.videoStreamIndex }),
+    };
+  }
+  for (const field of [
+    'text', 'x', 'y', 'width', 'height', 'fontFamily', 'fontSize', 'fontWeight',
+    'lineHeight', 'verticalAlign', 'paddingPixels', 'color', 'backgroundColor',
+    'textAlign', 'textOutline', 'textShadow', 'wordTimings', 'wordHighlightColor',
+    'wordHighlightAnimation', 'volume', 'fadeInSeconds', 'fadeOutSeconds',
+    'bubble',
+    'audioEffects', 'volumeKeyframes',
+    'transitionIn', 'transitionOut', 'blendMode', 'keyframes', 'effects', 'mask',
+    'sourceFit',
+  ]) {
+    if (clip[field] !== undefined) result[field] = structuredClone(clip[field]);
+  }
+  return result;
+}
+
+function roundInspectionSeconds(seconds) {
+  return Number(seconds.toFixed(6));
+}