aivee 0.0.0-stage → 0.1.0-dev.59872e1

package/src/timeline/layers.mjs

@@ -0,0 +1,18 @@
+/** Assign renderer layer indices while preserving track order and clip overlap. */
+export function assignRenderTrackIndices(timeline) {
+  const orderedTracks = [...timeline.tracks].sort((a, b) => a.order - b.order);
+  const indices = new Map();
+  let baseIndex = 0;
+  for (const track of orderedTracks) {
+    const laneEnds = [];
+    const clips = [...track.clips].sort((a, b) => a.timelineStart - b.timelineStart || a.id.localeCompare(b.id));
+    for (const clip of clips) {
+      let lane = laneEnds.findIndex((end) => end <= clip.timelineStart + 1e-6);
+      if (lane < 0) lane = laneEnds.length;
+      laneEnds[lane] = clip.timelineStart + clip.durationSeconds;
+      indices.set(`${track.id}/${clip.id}`, baseIndex + lane);
+    }
+    baseIndex += Math.max(1, laneEnds.length);
+  }
+  return indices;
+}

package/src/timeline/mask.mjs

@@ -0,0 +1,53 @@
+const SHAPES = new Set(['circle', 'ellipse', 'rect']);
+
+export function validateVisualMask(mask, label = 'Visual mask') {
+  if (!mask || typeof mask !== 'object' || Array.isArray(mask) || !SHAPES.has(mask.type)) {
+    throw new TypeError(`${label} type must be circle, ellipse, or rect.`);
+  }
+  const fields = mask.type === 'circle'
+    ? ['type', 'centerX', 'centerY', 'radius']
+    : mask.type === 'ellipse'
+      ? ['type', 'centerX', 'centerY', 'radiusX', 'radiusY']
+      : ['type', 'x', 'y', 'width', 'height'];
+  if (Object.keys(mask).some((field) => !fields.includes(field))) {
+    throw new TypeError(`${label} contains unsupported fields for ${mask.type}.`);
+  }
+  const values = fields.filter((field) => field !== 'type').map((field) => mask[field]);
+  if (!values.every((value) => Number.isFinite(value) && value >= 0 && value <= 1)) {
+    throw new TypeError(`${label} values must be finite normalized numbers from 0 to 1.`);
+  }
+  if (mask.type === 'circle' && mask.radius <= 0) throw new TypeError(`${label} radius must be greater than 0.`);
+  if (mask.type === 'ellipse' && (mask.radiusX <= 0 || mask.radiusY <= 0)) throw new TypeError(`${label} radii must be greater than 0.`);
+  if (mask.type === 'rect' && (mask.width <= 0 || mask.height <= 0 || mask.x + mask.width > 1 || mask.y + mask.height > 1)) {
+    throw new TypeError(`${label} rectangle must have positive size within normalized bounds.`);
+  }
+  return mask;
+}
+
+export function visualMaskClipPath(mask, animated = false) {
+  validateVisualMask(mask);
+  if (mask.type === 'circle') return `circle(${animated ? scaleLength(mask.radius) : percent(mask.radius)} at ${percent(mask.centerX)} ${percent(mask.centerY)})`;
+  if (mask.type === 'ellipse') return `ellipse(${animated ? scaleLength(mask.radiusX) : percent(mask.radiusX)} ${animated ? scaleLength(mask.radiusY) : percent(mask.radiusY)} at ${percent(mask.centerX)} ${percent(mask.centerY)})`;
+  if (animated) {
+    const x1 = scaleFromCenter(mask.x), y1 = scaleFromCenter(mask.y);
+    const x2 = scaleFromCenter(mask.x + mask.width), y2 = scaleFromCenter(mask.y + mask.height);
+    return `polygon(${x1} ${y1}, ${x2} ${y1}, ${x2} ${y2}, ${x1} ${y2})`;
+  }
+  const top = percent(mask.y);
+  const right = percent(1 - mask.x - mask.width);
+  const bottom = percent(1 - mask.y - mask.height);
+  const left = percent(mask.x);
+  return `inset(${top} ${right} ${bottom} ${left})`;
+}
+
+function scaleLength(value) {
+  return `calc(${percent(value)} * var(--engine-mask-progress, 1))`;
+}
+
+function scaleFromCenter(value) {
+  return `calc(50% + (${percent(value)} - 50%) * var(--engine-mask-progress, 1))`;
+}
+
+function percent(value) {
+  return `${Number((value * 100).toFixed(6))}%`;
+}

package/src/timeline/project.mjs

@@ -0,0 +1,52 @@
+import { existsSync, lstatSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { listProjectAssets } from '../project/assets.mjs';
+import { validateTimeline } from './validate.mjs';
+
+export function createProjectTimeline(projectPath, options = {}) {
+  if (!options || typeof options !== 'object' || Array.isArray(options)) throw new TypeError('Timeline creation options must be an object.');
+  for (const key of Object.keys(options)) if (key !== 'durationSeconds') throw new TypeError(`Unsupported timeline creation option: ${key}.`);
+  const root = resolve(projectPath);
+  const metaPath = join(root, 'meta.json');
+  if (!existsSync(metaPath) || lstatSync(metaPath).isSymbolicLink() || !lstatSync(metaPath).isFile()) {
+    throw new Error(`Not an Engine project: ${root}`);
+  }
+  const meta = JSON.parse(readFileSync(metaPath, 'utf8'));
+  const durationSeconds = options.durationSeconds ?? meta.durationSeconds;
+  if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) throw new TypeError('Timeline durationSeconds must be positive.');
+  const catalog = listProjectAssets(root);
+  const timeline = {
+    schemaVersion: 1,
+    project: {
+      id: meta.id,
+      width: meta.width,
+      height: meta.height,
+      fps: meta.fps,
+      durationSeconds,
+      ...(meta.sourceFit === undefined ? {} : { sourceFit: meta.sourceFit }),
+      ...(meta.backgroundColor === undefined ? {} : { backgroundColor: meta.backgroundColor }),
+    },
+    assets: catalog.assets.map((asset) => ({
+      id: asset.id,
+      path: asset.path,
+      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.nominalFrameRate === undefined ? {} : { nominalFrameRate: asset.nominalFrameRate }),
+      ...(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) }),
+      sha256: asset.sha256,
+    })),
+    markers: [],
+    tracks: [
+      { id: 'video-main', kind: 'video', order: 0, clips: [] },
+      { id: 'audio-main', kind: 'audio', order: 1, clips: [] },
+      { id: 'overlay-main', kind: 'overlay', order: 2, clips: [] },
+    ],
+  };
+  return validateTimeline(timeline);
+}