aivee 0.1.0-alpha.0 → 0.1.0-dev.59872e1

package/src/timeline/blend-mode.mjs

@@ -1,34 +1,34 @@
-const BLEND_MODES = new Set([
-  'normal',
-  'multiply',
-  'screen',
-  'overlay',
-  'darken',
-  'lighten',
-  'color-dodge',
-  'color-burn',
-  'hard-light',
-  'soft-light',
-  'difference',
-  'exclusion',
-  'hue',
-  'saturation',
-  'color',
-  'luminosity',
-]);
-
-export function validateBlendMode(clip, trackKind) {
-  if (clip.blendMode === undefined) return;
-  if (trackKind !== 'video' && trackKind !== 'overlay') {
-    throw new TypeError(`Clip ${clip.id} blendMode is supported only on video and overlay tracks.`);
-  }
-  if (typeof clip.blendMode !== 'string' || !BLEND_MODES.has(clip.blendMode)) {
-    throw new TypeError(`Clip ${clip.id} blendMode must be one of: ${[...BLEND_MODES].join(', ')}.`);
-  }
-}
-
-export function blendModeStyle(clip) {
-  return clip.blendMode && clip.blendMode !== 'normal'
-    ? `mix-blend-mode:${clip.blendMode};`
-    : '';
-}
+const BLEND_MODES = new Set([
+  'normal',
+  'multiply',
+  'screen',
+  'overlay',
+  'darken',
+  'lighten',
+  'color-dodge',
+  'color-burn',
+  'hard-light',
+  'soft-light',
+  'difference',
+  'exclusion',
+  'hue',
+  'saturation',
+  'color',
+  'luminosity',
+]);
+
+export function validateBlendMode(clip, trackKind) {
+  if (clip.blendMode === undefined) return;
+  if (trackKind !== 'video' && trackKind !== 'overlay') {
+    throw new TypeError(`Clip ${clip.id} blendMode is supported only on video and overlay tracks.`);
+  }
+  if (typeof clip.blendMode !== 'string' || !BLEND_MODES.has(clip.blendMode)) {
+    throw new TypeError(`Clip ${clip.id} blendMode must be one of: ${[...BLEND_MODES].join(', ')}.`);
+  }
+}
+
+export function blendModeStyle(clip) {
+  return clip.blendMode && clip.blendMode !== 'normal'
+    ? `mix-blend-mode:${clip.blendMode};`
+    : '';
+}

package/src/timeline/caption-layouts.mjs

@@ -1,61 +1,62 @@
-const SOCIAL_LAYOUT = {
-  x: 0.08, y: 0.68, width: 0.84, height: 0.24, fontSize: 64,
-  fontWeight: 800, lineHeight: 1.05, verticalAlign: 'bottom', paddingPixels: 14,
-  wordWrap: true,
-  textShadow: { color: '#000000cc', blurPixels: 6, offsetXPixels: 0, offsetYPixels: 3 },
-  color: '#ffffff', backgroundColor: '#00000000', textAlign: 'center',
-};
-
-const LAYOUTS = {
-  subtitle: {
-    x: 0.08, y: 0.76, width: 0.84, height: 0.16, fontSize: 54,
-    fontWeight: 600, verticalAlign: 'bottom', paddingPixels: 12, wordWrap: true,
-    textShadow: { color: '#000000b8', blurPixels: 4, offsetXPixels: 0, offsetYPixels: 2 },
-    color: '#ffffff', backgroundColor: '#000000b8', textAlign: 'center',
-  },
-  social: SOCIAL_LAYOUT,
-  socialPop: {
-    ...SOCIAL_LAYOUT,
-    wordHighlight: true, wordHighlightColor: '#ffe45c', wordHighlightAnimation: 'pop',
-  },
-  socialStack: {
-    ...SOCIAL_LAYOUT,
-    y: 0.64, height: 0.3, fontSize: 58, lineHeight: 1.02,
-    wordsPerCaption: 6, wordsPerLine: 3,
-    wordHighlight: true, wordHighlightColor: '#ffe45c', wordHighlightAnimation: 'pop',
-  },
-  speechBubble: {
-    x: 0.32, y: 0.66, width: 0.62, height: 0.1, fontSize: 44,
-    fontWeight: 600, lineHeight: 1.12, verticalAlign: 'center', paddingPixels: 22,
-    wordWrap: true, wordsPerCaption: 6, wordsPerLine: 3,
-    wordHighlight: true, wordHighlightColor: '#426BEB', wordHighlightAnimation: 'scale',
-    color: '#172236', backgroundColor: '#ffffff', textAlign: 'left',
-    textShadow: { color: '#17223622', blurPixels: 10, offsetXPixels: 0, offsetYPixels: 4 },
-    bubble: { tailSide: 'bottom', tailPosition: 0.16, tailSizePixels: 26, cornerRadiusPixels: 28 },
-  },
-  lowerThird: {
-    x: 0.08, y: 0.72, width: 0.76, height: 0.18, fontSize: 48,
-    fontWeight: 600, verticalAlign: 'bottom', paddingPixels: 12, wordWrap: true,
-    textShadow: { color: '#000000b8', blurPixels: 3, offsetXPixels: 0, offsetYPixels: 2 },
-    color: '#ffffff', backgroundColor: '#000000b8', textAlign: 'left',
-  },
-};
-
-export const CAPTION_LAYOUT_PRESETS = Object.freeze(Object.fromEntries(
-  Object.entries(LAYOUTS).map(([name, layout]) => [name, Object.freeze({
-    ...layout,
-    ...(layout.textOutline ? { textOutline: Object.freeze({ ...layout.textOutline }) } : {}),
-    ...(layout.textShadow ? { textShadow: Object.freeze({ ...layout.textShadow }) } : {}),
-  })]),
-));
-
-export function listCaptionLayoutPresets() {
-  return Object.keys(CAPTION_LAYOUT_PRESETS);
-}
-
-export function resolveCaptionLayoutPreset(name = 'subtitle') {
-  if (typeof name !== 'string' || !Object.hasOwn(CAPTION_LAYOUT_PRESETS, name)) {
-    throw new TypeError(`Unknown caption layout preset: ${name}`);
-  }
-  return structuredClone(CAPTION_LAYOUT_PRESETS[name]);
-}
+const SOCIAL_LAYOUT = {
+  x: 0.08, y: 0.68, width: 0.84, height: 0.24, fontSize: 64,
+  fontWeight: 800, lineHeight: 1.05, verticalAlign: 'bottom', paddingPixels: 14,
+  wordWrap: true,
+  textShadow: { color: '#000000cc', blurPixels: 6, offsetXPixels: 0, offsetYPixels: 3 },
+  color: '#ffffff', backgroundColor: '#00000000', textAlign: 'center',
+};
+
+const LAYOUTS = {
+  subtitle: {
+    x: 0.08, y: 0.76, width: 0.84, height: 0.16, fontSize: 54,
+    fontWeight: 600, verticalAlign: 'bottom', paddingPixels: 12, wordWrap: true,
+    textShadow: { color: '#000000b8', blurPixels: 4, offsetXPixels: 0, offsetYPixels: 2 },
+    color: '#ffffff', backgroundColor: '#000000b8', textAlign: 'center',
+  },
+  social: SOCIAL_LAYOUT,
+  socialPop: {
+    ...SOCIAL_LAYOUT,
+    wordHighlight: true, wordHighlightColor: '#ffe45c', wordHighlightAnimation: 'pop',
+  },
+  socialStack: {
+    ...SOCIAL_LAYOUT,
+    y: 0.64, height: 0.3, fontSize: 58, lineHeight: 1.02,
+    wordsPerCaption: 6, wordsPerLine: 3,
+    wordHighlight: true, wordHighlightColor: '#ffe45c', wordHighlightAnimation: 'pop',
+  },
+  speechBubble: {
+    x: 0.32, y: 0.66, width: 0.62, height: 0.1, fontSize: 44,
+    fontWeight: 600, lineHeight: 1.12, verticalAlign: 'center', paddingPixels: 22,
+    wordWrap: true, wordsPerCaption: 6, wordsPerLine: 3,
+    wordHighlight: true, wordHighlightColor: '#426BEB', wordHighlightAnimation: 'scale',
+    color: '#172236', backgroundColor: '#ffffff', textAlign: 'left',
+    textShadow: { color: '#17223622', blurPixels: 10, offsetXPixels: 0, offsetYPixels: 4 },
+    bubble: { tailSide: 'bottom', tailPosition: 0.16, tailSizePixels: 26, cornerRadiusPixels: 28 },
+  },
+  lowerThird: {
+    x: 0.08, y: 0.72, width: 0.76, height: 0.18, fontSize: 48,
+    fontWeight: 600, verticalAlign: 'bottom', paddingPixels: 12, wordWrap: true,
+    textShadow: { color: '#000000b8', blurPixels: 3, offsetXPixels: 0, offsetYPixels: 2 },
+    color: '#ffffff', backgroundColor: '#000000b8', textAlign: 'left',
+  },
+};
+
+export const CAPTION_LAYOUT_PRESETS = Object.freeze(Object.fromEntries(
+  Object.entries(LAYOUTS).map(([name, layout]) => [name, Object.freeze({
+    ...layout,
+    ...(layout.textOutline ? { textOutline: Object.freeze({ ...layout.textOutline }) } : {}),
+    ...(layout.textShadow ? { textShadow: Object.freeze({ ...layout.textShadow }) } : {}),
+    ...(layout.bubble ? { bubble: Object.freeze({ ...layout.bubble }) } : {}),
+  })]),
+));
+
+export function listCaptionLayoutPresets() {
+  return Object.keys(CAPTION_LAYOUT_PRESETS);
+}
+
+export function resolveCaptionLayoutPreset(name = 'subtitle') {
+  if (typeof name !== 'string' || !Object.hasOwn(CAPTION_LAYOUT_PRESETS, name)) {
+    throw new TypeError(`Unknown caption layout preset: ${name}`);
+  }
+  return structuredClone(CAPTION_LAYOUT_PRESETS[name]);
+}

package/src/timeline/captions.mjs

@@ -1,80 +1,80 @@
-import { validateTranscript } from '../transcript/validate.mjs';
-import { resolveCaptionLayoutPreset } from './caption-layouts.mjs';
-import { resolveSpeechBubble } from './speech-bubble.mjs';
-
-export function createCaptionTrack(transcript, options = {}) {
-  validateTranscript(transcript);
-  const layout = resolveCaptionLayoutPreset(options.layoutPreset);
-  const wordHighlight = options.wordHighlight ?? layout.wordHighlight ?? false;
-  if (typeof wordHighlight !== 'boolean') throw new TypeError('wordHighlight must be a boolean.');
-  if (wordHighlight && transcript.granularity === 'cue') throw new TypeError('Word highlighting requires word-level transcript timing.');
-  const wordHighlightColor = options.wordHighlightColor ?? layout.wordHighlightColor ?? '#ffe45c';
-  if (typeof wordHighlightColor !== 'string' || !/^#(?:[\da-f]{3}|[\da-f]{4}|[\da-f]{6}|[\da-f]{8})$/i.test(wordHighlightColor)) {
-    throw new TypeError('wordHighlightColor must be a hex color.');
-  }
-  if (!wordHighlight && options.wordHighlightColor !== undefined) throw new TypeError('wordHighlightColor requires wordHighlight: true.');
-  const wordHighlightAnimation = options.wordHighlightAnimation ?? layout.wordHighlightAnimation ?? 'scale';
-  if (!['scale', 'pop'].includes(wordHighlightAnimation)) throw new TypeError('wordHighlightAnimation must be scale or pop.');
-  if (!wordHighlight && options.wordHighlightAnimation !== undefined) throw new TypeError('wordHighlightAnimation requires wordHighlight: true.');
-  const wordsPerCaption = options.wordsPerCaption ?? layout.wordsPerCaption ?? 6;
-  if (!Number.isSafeInteger(wordsPerCaption) || wordsPerCaption < 1 || wordsPerCaption > 20) throw new TypeError('wordsPerCaption must be an integer from 1 to 20.');
-  const wordsPerLine = options.wordsPerLine ?? layout.wordsPerLine;
-  if (wordsPerLine !== undefined && (!Number.isSafeInteger(wordsPerLine) || wordsPerLine < 1 || wordsPerLine > 20)) {
-    throw new TypeError('wordsPerLine must be an integer from 1 to 20.');
-  }
-  const wordWrap = options.wordWrap ?? layout.wordWrap ?? false;
-  if (typeof wordWrap !== 'boolean') throw new TypeError('wordWrap must be a boolean.');
-  const maxGapSeconds = options.maxGapSeconds ?? 0.8;
-  if (!Number.isFinite(maxGapSeconds) || maxGapSeconds < 0) throw new TypeError('maxGapSeconds must be a non-negative number.');
-  const bubbleSource = options.bubble ?? layout.bubble;
-  const bubble = bubbleSource === undefined ? undefined : resolveSpeechBubble(bubbleSource, layout.bubble);
-
-  const groups = [];
-  let group = [];
-  for (const word of transcript.words) {
-    if (group.length && (group.length >= wordsPerCaption || word.start - group.at(-1).end > maxGapSeconds || /[.!?]$/.test(group.at(-1).text))) {
-      groups.push(group);
-      group = [];
-    }
-    group.push(word);
-  }
-  if (group.length) groups.push(group);
-
-  const clips = groups.map((words, index) => ({
-    id: `caption-${String(index + 1).padStart(3, '0')}`,
-    timelineStart: words[0].start,
-    durationSeconds: words.at(-1).end - words[0].start,
-    text: words.map(({ text }) => text).join(' '),
-    ...(wordsPerLine !== undefined ? { wordsPerLine } : {}),
-    ...(wordHighlight ? {
-      wordTimings: words.map((word) => ({
-        text: word.text,
-        start: word.start - words[0].start,
-        end: word.end - words[0].start,
-      })),
-      wordHighlightColor,
-      wordHighlightAnimation,
-    } : {}),
-    x: options.x ?? layout.x,
-    y: options.y ?? layout.y,
-    width: options.width ?? layout.width,
-    height: options.height ?? layout.height,
-    fontSize: options.fontSize ?? layout.fontSize,
-    ...(options.fontFamily !== undefined ? { fontFamily: options.fontFamily } : {}),
-    fontWeight: options.fontWeight ?? layout.fontWeight,
-    ...(options.lineHeight !== undefined || layout.lineHeight !== undefined ? { lineHeight: options.lineHeight ?? layout.lineHeight } : {}),
-    verticalAlign: options.verticalAlign ?? layout.verticalAlign,
-    wordWrap,
-    paddingPixels: options.paddingPixels ?? layout.paddingPixels,
-    textOutline: options.textOutline ?? layout.textOutline,
-    textShadow: options.textShadow ?? layout.textShadow,
-    color: options.color ?? layout.color,
-    backgroundColor: options.backgroundColor ?? layout.backgroundColor,
-    textAlign: options.textAlign ?? layout.textAlign,
-    ...(bubble === undefined ? {} : { bubble: structuredClone(bubble) }),
-    ...(options.fadeInSeconds ? { fadeInSeconds: options.fadeInSeconds } : {}),
-    ...(options.fadeOutSeconds ? { fadeOutSeconds: options.fadeOutSeconds } : {}),
-  }));
-
-  return { id: options.trackId ?? 'captions', kind: 'overlay', order: options.order ?? 100, clips };
-}
+import { validateTranscript } from '../transcript/validate.mjs';
+import { resolveCaptionLayoutPreset } from './caption-layouts.mjs';
+import { resolveSpeechBubble } from './speech-bubble.mjs';
+
+export function createCaptionTrack(transcript, options = {}) {
+  validateTranscript(transcript);
+  const layout = resolveCaptionLayoutPreset(options.layoutPreset);
+  const wordHighlight = options.wordHighlight ?? layout.wordHighlight ?? false;
+  if (typeof wordHighlight !== 'boolean') throw new TypeError('wordHighlight must be a boolean.');
+  if (wordHighlight && transcript.granularity === 'cue') throw new TypeError('Word highlighting requires word-level transcript timing.');
+  const wordHighlightColor = options.wordHighlightColor ?? layout.wordHighlightColor ?? '#ffe45c';
+  if (typeof wordHighlightColor !== 'string' || !/^#(?:[\da-f]{3}|[\da-f]{4}|[\da-f]{6}|[\da-f]{8})$/i.test(wordHighlightColor)) {
+    throw new TypeError('wordHighlightColor must be a hex color.');
+  }
+  if (!wordHighlight && options.wordHighlightColor !== undefined) throw new TypeError('wordHighlightColor requires wordHighlight: true.');
+  const wordHighlightAnimation = options.wordHighlightAnimation ?? layout.wordHighlightAnimation ?? 'scale';
+  if (!['scale', 'pop'].includes(wordHighlightAnimation)) throw new TypeError('wordHighlightAnimation must be scale or pop.');
+  if (!wordHighlight && options.wordHighlightAnimation !== undefined) throw new TypeError('wordHighlightAnimation requires wordHighlight: true.');
+  const wordsPerCaption = options.wordsPerCaption ?? layout.wordsPerCaption ?? 6;
+  if (!Number.isSafeInteger(wordsPerCaption) || wordsPerCaption < 1 || wordsPerCaption > 20) throw new TypeError('wordsPerCaption must be an integer from 1 to 20.');
+  const wordsPerLine = options.wordsPerLine ?? layout.wordsPerLine;
+  if (wordsPerLine !== undefined && (!Number.isSafeInteger(wordsPerLine) || wordsPerLine < 1 || wordsPerLine > 20)) {
+    throw new TypeError('wordsPerLine must be an integer from 1 to 20.');
+  }
+  const wordWrap = options.wordWrap ?? layout.wordWrap ?? false;
+  if (typeof wordWrap !== 'boolean') throw new TypeError('wordWrap must be a boolean.');
+  const maxGapSeconds = options.maxGapSeconds ?? 0.8;
+  if (!Number.isFinite(maxGapSeconds) || maxGapSeconds < 0) throw new TypeError('maxGapSeconds must be a non-negative number.');
+  const bubbleSource = options.bubble ?? layout.bubble;
+  const bubble = bubbleSource === undefined ? undefined : resolveSpeechBubble(bubbleSource, layout.bubble);
+
+  const groups = [];
+  let group = [];
+  for (const word of transcript.words) {
+    if (group.length && (group.length >= wordsPerCaption || word.start - group.at(-1).end > maxGapSeconds || /[.!?]$/.test(group.at(-1).text))) {
+      groups.push(group);
+      group = [];
+    }
+    group.push(word);
+  }
+  if (group.length) groups.push(group);
+
+  const clips = groups.map((words, index) => ({
+    id: `caption-${String(index + 1).padStart(3, '0')}`,
+    timelineStart: words[0].start,
+    durationSeconds: words.at(-1).end - words[0].start,
+    text: words.map(({ text }) => text).join(' '),
+    ...(wordsPerLine !== undefined ? { wordsPerLine } : {}),
+    ...(wordHighlight ? {
+      wordTimings: words.map((word) => ({
+        text: word.text,
+        start: word.start - words[0].start,
+        end: word.end - words[0].start,
+      })),
+      wordHighlightColor,
+      wordHighlightAnimation,
+    } : {}),
+    x: options.x ?? layout.x,
+    y: options.y ?? layout.y,
+    width: options.width ?? layout.width,
+    height: options.height ?? layout.height,
+    fontSize: options.fontSize ?? layout.fontSize,
+    ...(options.fontFamily !== undefined ? { fontFamily: options.fontFamily } : {}),
+    fontWeight: options.fontWeight ?? layout.fontWeight,
+    ...(options.lineHeight !== undefined || layout.lineHeight !== undefined ? { lineHeight: options.lineHeight ?? layout.lineHeight } : {}),
+    verticalAlign: options.verticalAlign ?? layout.verticalAlign,
+    wordWrap,
+    paddingPixels: options.paddingPixels ?? layout.paddingPixels,
+    textOutline: options.textOutline ?? layout.textOutline,
+    textShadow: options.textShadow ?? layout.textShadow,
+    color: options.color ?? layout.color,
+    backgroundColor: options.backgroundColor ?? layout.backgroundColor,
+    textAlign: options.textAlign ?? layout.textAlign,
+    ...(bubble === undefined ? {} : { bubble: structuredClone(bubble) }),
+    ...(options.fadeInSeconds ? { fadeInSeconds: options.fadeInSeconds } : {}),
+    ...(options.fadeOutSeconds ? { fadeOutSeconds: options.fadeOutSeconds } : {}),
+  }));
+
+  return { id: options.trackId ?? 'captions', kind: 'overlay', order: options.order ?? 100, clips };
+}