@meframe/core 0.4.6 → 0.5.0

package/dist/index.d.ts

@@ -9,6 +9,8 @@ export { CompositionModel } from './model/CompositionModel';
 export type { CompositionModelData, CompositionPatch, DirtyRange, TimeUs, Track, Clip, VideoClip, AudioClip, CaptionClip, Resource, Effect, Transition, Attachment, AnimationEffect, AnimationKeyframe, Transform2D, } from './model/types';
 export type { CacheConfig, CacheStats } from './cache/types';
 export type { Plugin, PluginHook } from './plugins/types';
+export { computeCaptionLayout } from './stages/compose/text-utils/caption-layout';
+export type { CaptionLayoutInput, CaptionLayout, CaptionLine, CaptionWord, CaptionStyle, CaptionContainer, } from './stages/compose/text-utils/caption-layout';
 export { setupCanvasDPI, createHiDPICanvas, checkCanvasDPI } from './utils/canvas-utils';
 export { BrowserCompatibilityError } from './utils/errors';
 export declare const VERSION = "0.3.3";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,MAAM,EACN,KAAK,EACL,IAAI,EACJ,SAAS,EACT,SAAS,EACT,WAAW,EACX,QAAQ,EACR,MAAM,EACN,UAAU,EACV,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG7D,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAG3D,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,MAAM,EACN,KAAK,EACL,IAAI,EACJ,SAAS,EACT,SAAS,EACT,WAAW,EACX,QAAQ,EACR,MAAM,EACN,UAAU,EACV,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,WAAW,GACZ,MAAM,eAAe,CAAC;AAGvB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG7D,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,WAAW,EACX,YAAY,EACZ,gBAAgB,GACjB,MAAM,4CAA4C,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEzF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAG3D,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 import { Meframe } from "./Meframe.js";
 import { MeframeEvent } from "./event/events.js";
 import { CompositionModel } from "./model/CompositionModel.js";
+import { computeCaptionLayout } from "./stages/compose/text-utils/caption-layout.js";
 import { checkCanvasDPI, createHiDPICanvas, setupCanvasDPI } from "./utils/canvas-utils.js";
 import { BrowserCompatibilityError } from "./utils/errors.js";
 const VERSION = "0.3.3";
@@ -11,6 +12,7 @@ export {
   MeframeEvent,
   VERSION,
   checkCanvasDPI,
+  computeCaptionLayout,
   createHiDPICanvas,
   setupCanvasDPI
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * @meframe/core - Next generation media processing framework\n * Based on WebCodecs API for high-performance video/audio processing\n */\n\n// Core exports\nexport { Meframe } from './Meframe';\nexport type { MeframeConfig, MeframeState } from './types';\nexport { MeframeEvent } from './event/events';\n\n// Model exports\nexport { CompositionModel } from './model/CompositionModel';\nexport type {\n  CompositionModelData,\n  CompositionPatch,\n  DirtyRange,\n  TimeUs,\n  Track,\n  Clip,\n  VideoClip,\n  AudioClip,\n  CaptionClip,\n  Resource,\n  Effect,\n  Transition,\n  Attachment,\n  AnimationEffect,\n  AnimationKeyframe,\n  Transform2D,\n} from './model/types';\n\n// Cache exports\nexport type { CacheConfig, CacheStats } from './cache/types';\n\n// Plugin exports\nexport type { Plugin, PluginHook } from './plugins/types';\n\n// Utility exports\nexport { setupCanvasDPI, createHiDPICanvas, checkCanvasDPI } from './utils/canvas-utils';\n\nexport { BrowserCompatibilityError } from './utils/errors';\n\n// Re-export version\nexport const VERSION = '0.3.3';\n"],"names":[],"mappings":";;;;;AA2CO,MAAM,UAAU;"}
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * @meframe/core - Next generation media processing framework\n * Based on WebCodecs API for high-performance video/audio processing\n */\n\n// Core exports\nexport { Meframe } from './Meframe';\nexport type { MeframeConfig, MeframeState } from './types';\nexport { MeframeEvent } from './event/events';\n\n// Model exports\nexport { CompositionModel } from './model/CompositionModel';\nexport type {\n  CompositionModelData,\n  CompositionPatch,\n  DirtyRange,\n  TimeUs,\n  Track,\n  Clip,\n  VideoClip,\n  AudioClip,\n  CaptionClip,\n  Resource,\n  Effect,\n  Transition,\n  Attachment,\n  AnimationEffect,\n  AnimationKeyframe,\n  Transform2D,\n} from './model/types';\n\n// Cache exports\nexport type { CacheConfig, CacheStats } from './cache/types';\n\n// Plugin exports\nexport type { Plugin, PluginHook } from './plugins/types';\n\n// Caption layout exports\nexport { computeCaptionLayout } from './stages/compose/text-utils/caption-layout';\nexport type {\n  CaptionLayoutInput,\n  CaptionLayout,\n  CaptionLine,\n  CaptionWord,\n  CaptionStyle,\n  CaptionContainer,\n} from './stages/compose/text-utils/caption-layout';\n\n// Utility exports\nexport { setupCanvasDPI, createHiDPICanvas, checkCanvasDPI } from './utils/canvas-utils';\n\nexport { BrowserCompatibilityError } from './utils/errors';\n\n// Re-export version\nexport const VERSION = '0.3.3';\n"],"names":[],"mappings":";;;;;;AAsDO,MAAM,UAAU;"}

package/dist/model/CompositionModel.d.ts.map

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

package/dist/model/CompositionModel.js

@@ -1,4 +1,4 @@
-import { hasResourceId } from "./types.js";
+import { hasResourceId, isCaptionClip } from "./types.js";
 import { binarySearchRange, binarySearchOverlapping } from "../utils/binary-search.js";
 import { validateCompositionStructure } from "./validation.js";
 import { filterRenderConfig } from "../utils/object-utils.js";
@@ -340,6 +340,9 @@ ${errors.map((e) => `${e.path}: ${e.message}`).join("\n")}`
     if (!mainTrack) {
       throw new Error("Main track not found");
     }
+    if (attachmentTracks.length === 0) {
+      return;
+    }
     for (const clip of mainTrack.clips) {
       clip.attachments = [];
     }
@@ -373,6 +376,26 @@ ${errors.map((e) => `${e.path}: ${e.message}`).join("\n")}`
           if ("text" in attachmentClip && attachmentClip.text) {
             attachmentData.text = attachmentClip.text;
           }
+          if (isCaptionClip(attachmentClip)) {
+            if (attachmentClip.fontFamily) {
+              attachmentData.fontFamily = attachmentClip.fontFamily;
+            }
+            if (attachmentClip.localeCode) {
+              attachmentData.localeCode = attachmentClip.localeCode;
+            }
+            if (attachmentClip.fontTemplate) {
+              attachmentData.fontTemplate = attachmentClip.fontTemplate;
+            }
+            if (attachmentClip.wordTimings) {
+              attachmentData.wordTimings = attachmentClip.wordTimings;
+            }
+            if (attachmentClip.animation) {
+              attachmentData.animation = attachmentClip.animation;
+            }
+            if (attachmentClip.letterCase) {
+              attachmentData.letterCase = attachmentClip.letterCase;
+            }
+          }
           const newAttachment = {
             id: `${attachmentKind}-${attachmentClip.id}-${mainClip.id}`,
             kind: attachmentKind,

package/dist/model/CompositionModel.js.map

@@ -1 +1 @@
-{"version":3,"file":"CompositionModel.js","sources":["../../src/model/CompositionModel.ts"],"sourcesContent":["import {\n  CompositionModelData,\n  Track,\n  Clip,\n  Resource,\n  TimeUs,\n  AnimationEffect,\n  hasResourceId,\n} from './types';\nimport { binarySearchRange, binarySearchOverlapping } from '../utils/binary-search';\nimport { validateCompositionStructure } from './validation';\nimport { filterRenderConfig } from '../utils/object-utils';\n\nexport class CompositionModel {\n  public readonly version = '1.0' as const;\n  public readonly fps: 24 | 25 | 30 | 60;\n  public durationUs!: TimeUs; // Assigned in buildIndexes()\n  public readonly mainTrackId: string;\n  public tracks: Track[];\n  public readonly resources: Map<string, Resource>;\n\n  private readonly trackMap: Map<string, Track>;\n  private readonly clipMap: Map<string, Clip>;\n  private readonly resourceRefCount: Map<string, number>;\n\n  public readonly renderConfig?: {\n    width: number;\n    height: number;\n    backgroundColor?: string;\n  };\n\n  public readonly ext?: Record<string, unknown>;\n\n  constructor(data: CompositionModelData) {\n    const errors = validateCompositionStructure(data);\n    if (errors.length > 0) {\n      throw new Error(\n        `Validation failed:\\n${errors.map((e) => `${e.path}: ${e.message}`).join('\\n')}`\n      );\n    }\n\n    this.fps = data.fps;\n    this.mainTrackId = data.mainTrackId ?? 'main';\n    this.tracks = data.tracks;\n    this.resources = new Map(Object.entries(data.resources));\n    this.renderConfig = data.renderConfig;\n    this.ext = data.ext;\n\n    // Build indexes\n    this.trackMap = new Map();\n    this.clipMap = new Map();\n    this.resourceRefCount = new Map();\n\n    this.buildIndexes();\n  }\n\n  // Track operations\n  findTrack(id: string): Track | null {\n    return this.trackMap.get(id) || null;\n  }\n\n  getTracksByKind(kind: 'video' | 'audio' | 'caption' | 'overlay' | 'fx'): Track[] {\n    return this.tracks.filter((track) => track.kind === kind);\n  }\n\n  // Clip operations with binary search optimization\n  findClip(id: string): Clip | null {\n    return this.clipMap.get(id) || null;\n  }\n\n  getClipsAtTime(timeUs: TimeUs, trackId?: string): Clip[] {\n    const tracks = trackId ? [this.findTrack(trackId)] : this.tracks;\n    const clips: Clip[] = [];\n\n    for (const track of tracks) {\n      if (!track) continue;\n      // Use binary search for single point lookup\n      const clip = binarySearchRange(track.clips, timeUs, (entry, _index) => ({\n        start: entry.startUs,\n        end: entry.startUs + entry.durationUs,\n      }));\n\n      if (clip) {\n        clips.push(clip);\n      }\n    }\n\n    return clips;\n  }\n\n  getActiveClips(startUs: TimeUs, endUs: TimeUs): Clip[] {\n    const clips: Clip[] = [];\n\n    for (const track of this.tracks) {\n      // Use binary search for range overlap\n      const overlappingClips = binarySearchOverlapping(\n        track.clips,\n        startUs,\n        endUs,\n        (clip, _index) => ({\n          start: clip.startUs,\n          end: clip.startUs + clip.durationUs,\n        })\n      );\n\n      clips.push(...overlappingClips);\n    }\n\n    return clips;\n  }\n\n  /**\n   * Get all clips in a specific track that overlap with the given time range\n   * Uses binary search for O(log n + k) performance\n   * @param startUs - Range start time (inclusive)\n   * @param endUs - Range end time (exclusive)\n   * @param trackId - Optional track ID to filter (defaults to main track)\n   */\n  getClipsInRange(startUs: TimeUs, endUs: TimeUs, trackId?: string): Clip[] {\n    const targetTrackId = trackId ?? this.mainTrackId;\n    const track = this.findTrack(targetTrackId);\n\n    if (!track) {\n      return [];\n    }\n\n    return binarySearchOverlapping(track.clips, startUs, endUs, (clip) => ({\n      start: clip.startUs,\n      end: clip.startUs + clip.durationUs,\n    }));\n  }\n\n  getClipIdsByResourceId(resourceId: string): string[] {\n    const resource = this.resources.get(resourceId);\n    return resource?.clipIds || [];\n  }\n\n  getClipIdAtTime(trackId: string, timeUs: TimeUs): string | undefined {\n    const track = this.findTrack(trackId);\n    if (!track) {\n      return undefined;\n    }\n\n    const clip = binarySearchRange(track.clips, timeUs, (entry, _index) => ({\n      start: entry.startUs,\n      end: entry.startUs + entry.durationUs,\n    }));\n\n    return clip?.id;\n  }\n\n  /**\n   * Get neighboring clips (Prev/Current/Next) at a specific time for video tracks\n   * Returns prev, current, and next clip IDs\n   */\n  getNeighboringClips(timeUs: TimeUs): { prev?: string; current?: string; next?: string } {\n    const videoTracks = this.getTracksByKind('video');\n    const result: { prev?: string; current?: string; next?: string } = {};\n\n    for (const track of videoTracks) {\n      const clips = track.clips;\n\n      for (let i = 0; i < clips.length; i++) {\n        const clip = clips[i];\n        if (!clip) continue;\n\n        const clipEndUs = clip.startUs + clip.durationUs;\n\n        if (clip.startUs <= timeUs && timeUs < clipEndUs) {\n          if (!result.current) {\n            result.current = clip.id;\n          }\n\n          if (i > 0 && !result.prev) {\n            const prevClip = clips[i - 1];\n            if (prevClip) {\n              result.prev = prevClip.id;\n            }\n          }\n\n          if (i < clips.length - 1 && !result.next) {\n            const nextClip = clips[i + 1];\n            if (nextClip) {\n              result.next = nextClip.id;\n            }\n          }\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Get all clip IDs that should be cached using adaptive strategy\n   * - Short clips (≤ maxDuration): cache Current + Next (smooth transitions)\n   * - Long clips (> maxDuration): cache Current only (memory control)\n   * @param timeUs - Current playback time\n   * @param maxDuration - Max duration for 2-clip strategy (default 5s)\n   */\n  getClipsToCacheAtTime(timeUs: TimeUs, maxDuration = 5_000_000): Set<string> {\n    const { current, next } = this.getNeighboringClips(timeUs);\n    const clipIds = new Set<string>();\n\n    if (!current) return clipIds;\n    clipIds.add(current);\n\n    // Only cache next clip if current clip is short enough\n    const currentClip = this.findClip(current);\n    if (currentClip && currentClip.durationUs <= maxDuration && next) {\n      clipIds.add(next);\n    }\n\n    return clipIds;\n  }\n\n  // Resource operations\n  getResource(id: string): Resource | null {\n    return this.resources.get(id) || null;\n  }\n\n  updateResourceState(id: string, state: 'pending' | 'loading' | 'ready' | 'error'): void {\n    const resource = this.resources.get(id);\n    if (resource) {\n      resource.state = state;\n    }\n  }\n\n  getUnusedResources(): Resource[] {\n    const unused: Resource[] = [];\n\n    for (const [id, resource] of this.resources) {\n      if (!this.resourceRefCount.has(id) || this.resourceRefCount.get(id) === 0) {\n        unused.push(resource);\n      }\n    }\n\n    return unused;\n  }\n\n  // Time operations\n  getDuration(): TimeUs {\n    return this.durationUs;\n  }\n\n  getTrackDuration(trackId: string): TimeUs {\n    const track = this.findTrack(trackId);\n    if (!track || track.clips.length === 0) return 0;\n\n    // Since clips are sorted, last clip determines duration\n    const lastClip = track.clips[track.clips.length - 1];\n    return (lastClip?.startUs ?? 0) + (lastClip?.durationUs ?? 0);\n  }\n\n  buildIndexes(options?: {\n    incremental?: boolean;\n    trackId?: string;\n    clipId?: string;\n    clip?: Clip;\n    operation?: 'add' | 'update' | 'remove';\n  }): void {\n    const track = options?.trackId ? this.findTrack(options.trackId) : undefined;\n    const isAttachmentTrack = track && track.kind !== 'video' && track.kind !== 'audio';\n    // Incremental update for video/audio track clip operations\n    if (options?.incremental && !isAttachmentTrack && options.clipId && options.operation) {\n      const clip = options.clip ?? this.clipMap.get(options.clipId);\n\n      if (options.operation === 'add' && clip) {\n        this.addClipToIndexes(clip);\n      } else if (options.operation === 'remove' && clip) {\n        this.removeClipFromIndexes(clip);\n      } else if (options.operation === 'update' && clip) {\n        // Handle resource change during update\n        if (clip.oldResourceId) {\n          this.updateClipResourceIndex(\n            options.clipId,\n            clip.oldResourceId,\n            hasResourceId(clip) ? clip.resourceId : undefined\n          );\n        }\n      }\n\n      // Recalculate duration only if affected main track\n      if (track?.id === this.mainTrackId) {\n        this.recalculateDuration();\n      }\n      return;\n    }\n\n    // Full rebuild: needed for attachment tracks or initial load\n    this.fullRebuildIndexes();\n  }\n\n  private fullRebuildIndexes(): void {\n    // Clear existing indexes\n    this.trackMap.clear();\n    this.clipMap.clear();\n    this.resourceRefCount.clear();\n\n    // Step 1: Sink attachment tracks to main track (preserves original tracks)\n    this.sinkAttachmentTracks();\n\n    let maxEndUs = 0;\n\n    // Step 2: Build all indexes in one pass (track, clip, resource)\n    for (const track of this.tracks) {\n      this.trackMap.set(track.id, track);\n\n      for (const clip of track.clips) {\n        (clip as Clip).trackId = track.id;\n        (clip as Clip).trackKind = track.kind;\n        this.clipMap.set(clip.id, clip);\n\n        // Main track resource index (only for clips with resourceId)\n        if (hasResourceId(clip)) {\n          const resource = this.resources.get(clip.resourceId);\n          if (resource) {\n            resource.clipIds = [...(resource.clipIds || []), clip.id];\n          }\n          const count = this.resourceRefCount.get(clip.resourceId) || 0;\n          this.resourceRefCount.set(clip.resourceId, count + 1);\n        }\n\n        // Attachment resource indexes (attachments are already sunk)\n        const attachments = clip.attachments ?? [];\n        for (const attachment of attachments) {\n          const attachmentResourceId = attachment.data?.resourceId;\n          if (attachmentResourceId && typeof attachmentResourceId === 'string') {\n            const attachmentResource = this.resources.get(attachmentResourceId);\n            if (attachmentResource) {\n              const clipIds = attachmentResource.clipIds || [];\n              if (!clipIds.includes(clip.id)) {\n                attachmentResource.clipIds = [...clipIds, clip.id];\n              }\n            }\n            const attachmentCount = this.resourceRefCount.get(attachmentResourceId) || 0;\n            this.resourceRefCount.set(attachmentResourceId, attachmentCount + 1);\n          }\n        }\n\n        // Calculate max end time\n        const clipEndUs = clip.startUs + clip.durationUs;\n        if (clipEndUs > maxEndUs) {\n          maxEndUs = clipEndUs;\n        }\n      }\n    }\n\n    this.durationUs = maxEndUs;\n  }\n\n  private addClipToIndexes(clip: Clip): void {\n    this.clipMap.set(clip.id, clip);\n\n    if (hasResourceId(clip)) {\n      const resource = this.resources.get(clip.resourceId);\n      if (resource) {\n        if (!resource.clipIds) {\n          resource.clipIds = [];\n        }\n        if (!resource.clipIds.includes(clip.id)) {\n          resource.clipIds.push(clip.id);\n        }\n      }\n      const count = this.resourceRefCount.get(clip.resourceId) || 0;\n      this.resourceRefCount.set(clip.resourceId, count + 1);\n    }\n  }\n\n  private removeClipFromIndexes(clip: Clip): void {\n    this.clipMap.delete(clip.id);\n\n    const resourceId = clip.oldResourceId || (hasResourceId(clip) ? clip.resourceId : undefined);\n    if (resourceId) {\n      const resource = this.resources.get(resourceId);\n      if (resource?.clipIds) {\n        resource.clipIds = resource.clipIds.filter((id) => id !== clip.id);\n      }\n      const count = this.resourceRefCount.get(resourceId) || 0;\n      this.resourceRefCount.set(resourceId, Math.max(0, count - 1));\n    }\n  }\n\n  /**\n   * Incrementally update resource index when clip's resourceId changes\n   */\n  updateClipResourceIndex(\n    clipId: string,\n    oldResourceId: string | undefined,\n    newResourceId: string | undefined\n  ): void {\n    // Remove from old resource\n    if (oldResourceId) {\n      const oldResource = this.resources.get(oldResourceId);\n      if (oldResource?.clipIds) {\n        oldResource.clipIds = oldResource.clipIds.filter((id) => id !== clipId);\n      }\n      const oldCount = this.resourceRefCount.get(oldResourceId) || 0;\n      this.resourceRefCount.set(oldResourceId, Math.max(0, oldCount - 1));\n    }\n\n    // Add to new resource\n    if (newResourceId) {\n      const newResource = this.resources.get(newResourceId);\n      if (newResource) {\n        if (!newResource.clipIds) {\n          newResource.clipIds = [];\n        }\n        if (!newResource.clipIds.includes(clipId)) {\n          newResource.clipIds.push(clipId);\n        }\n      }\n      const newCount = this.resourceRefCount.get(newResourceId) || 0;\n      this.resourceRefCount.set(newResourceId, newCount + 1);\n    }\n  }\n\n  /**\n   * Recalculate total duration based on main track\n   */\n  recalculateDuration(): void {\n    const mainTrack = this.findTrack(this.mainTrackId);\n    if (!mainTrack || mainTrack.clips.length === 0) {\n      this.durationUs = 0;\n      return;\n    }\n\n    // Since clips are sorted, last clip determines duration\n    const lastClip = mainTrack.clips[mainTrack.clips.length - 1];\n    this.durationUs = (lastClip?.startUs ?? 0) + (lastClip?.durationUs ?? 0);\n  }\n\n  private sinkAttachmentTracks(): void {\n    let mainTrack: Track | undefined;\n    const attachmentTracks = [];\n\n    // Sort all tracks\n    for (const track of this.tracks) {\n      track.clips.sort((a, b) => a.startUs - b.startUs);\n\n      if (track.id === this.mainTrackId) {\n        mainTrack = track;\n        continue;\n      }\n      // Collect attachment tracks for sinking (caption, overlay, fx)\n      // Video and audio tracks are not sunk\n      if (track.kind === 'caption' || track.kind === 'overlay' || track.kind === 'fx') {\n        attachmentTracks.push(track);\n      }\n    }\n\n    if (!mainTrack) {\n      throw new Error('Main track not found');\n    }\n\n    // Clear existing attachments before sinking (in case of rebuild)\n    for (const clip of mainTrack.clips) {\n      clip.attachments = [];\n    }\n\n    for (const attachmentTrack of attachmentTracks) {\n      for (const attachmentClip of attachmentTrack.clips) {\n        // Use track.kind directly as attachment kind\n        const attachmentKind = attachmentTrack.kind;\n\n        for (const mainClip of mainTrack.clips) {\n          const overlap = this.getTimeOverlap(attachmentClip, mainClip);\n          if (!overlap) continue;\n\n          if (!mainClip.attachments) {\n            mainClip.attachments = [];\n          }\n\n          // Extract animation effect\n          const animationEffect = attachmentClip.effects?.find(\n            (e) => e.effectType === 'animation'\n          ) as AnimationEffect | undefined;\n\n          const attachmentData: Record<string, unknown> = {\n            animation: animationEffect?.params,\n            overlayClipStartUs: attachmentClip.startUs,\n            mainClipStartUs: mainClip.startUs,\n          };\n\n          // Add renderConfig if valid\n          const filteredRenderConfig = filterRenderConfig(\n            'renderConfig' in attachmentClip ? attachmentClip.renderConfig : undefined,\n            `attachment clip ${attachmentClip.id}`\n          );\n          if (filteredRenderConfig) {\n            attachmentData.renderConfig = filteredRenderConfig;\n          }\n\n          // Add resourceId if exists (trackKind not yet set, check field directly)\n          if ('resourceId' in attachmentClip && attachmentClip.resourceId) {\n            attachmentData.resourceId = attachmentClip.resourceId;\n          }\n\n          // Add text if exists (trackKind not yet set, check field directly)\n          if ('text' in attachmentClip && attachmentClip.text) {\n            attachmentData.text = attachmentClip.text;\n          }\n\n          const newAttachment = {\n            id: `${attachmentKind}-${attachmentClip.id}-${mainClip.id}`,\n            kind: attachmentKind,\n            startUs: overlap.clipRelativeStart,\n            durationUs: overlap.duration,\n            data: attachmentData,\n          };\n\n          mainClip.attachments.push(newAttachment);\n        }\n      }\n    }\n  }\n\n  private getTimeOverlap(\n    attachmentClip: Clip,\n    mainClip: Clip\n  ): { clipRelativeStart: number; duration: number } | null {\n    const attachmentStart = attachmentClip.startUs;\n    const attachmentEnd = attachmentClip.startUs + attachmentClip.durationUs;\n    const mainStart = mainClip.startUs;\n    const mainEnd = mainClip.startUs + mainClip.durationUs;\n\n    if (attachmentEnd <= mainStart || attachmentStart >= mainEnd) {\n      return null;\n    }\n\n    const overlapStart = Math.max(attachmentStart, mainStart);\n    const overlapEnd = Math.min(attachmentEnd, mainEnd);\n    const duration = overlapEnd - overlapStart;\n    const clipRelativeStart = overlapStart - mainStart;\n\n    return { clipRelativeStart, duration };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"CompositionModel.js","sources":["../../src/model/CompositionModel.ts"],"sourcesContent":["import {\n  CompositionModelData,\n  Track,\n  Clip,\n  Resource,\n  TimeUs,\n  AnimationEffect,\n  hasResourceId,\n  isCaptionClip,\n} from './types';\nimport { binarySearchRange, binarySearchOverlapping } from '../utils/binary-search';\nimport { validateCompositionStructure } from './validation';\nimport { filterRenderConfig } from '../utils/object-utils';\n\nexport class CompositionModel {\n  public readonly version = '1.0' as const;\n  public readonly fps: 24 | 25 | 30 | 60;\n  public durationUs!: TimeUs; // Assigned in buildIndexes()\n  public readonly mainTrackId: string;\n  public tracks: Track[];\n  public readonly resources: Map<string, Resource>;\n\n  private readonly trackMap: Map<string, Track>;\n  private readonly clipMap: Map<string, Clip>;\n  private readonly resourceRefCount: Map<string, number>;\n\n  public readonly renderConfig?: {\n    width: number;\n    height: number;\n    backgroundColor?: string;\n  };\n\n  public readonly ext?: Record<string, unknown>;\n\n  constructor(data: CompositionModelData) {\n    const errors = validateCompositionStructure(data);\n    if (errors.length > 0) {\n      throw new Error(\n        `Validation failed:\\n${errors.map((e) => `${e.path}: ${e.message}`).join('\\n')}`\n      );\n    }\n\n    this.fps = data.fps;\n    this.mainTrackId = data.mainTrackId ?? 'main';\n    this.tracks = data.tracks;\n    this.resources = new Map(Object.entries(data.resources));\n    this.renderConfig = data.renderConfig;\n    this.ext = data.ext;\n\n    // Build indexes\n    this.trackMap = new Map();\n    this.clipMap = new Map();\n    this.resourceRefCount = new Map();\n\n    this.buildIndexes();\n  }\n\n  // Track operations\n  findTrack(id: string): Track | null {\n    return this.trackMap.get(id) || null;\n  }\n\n  getTracksByKind(kind: 'video' | 'audio' | 'caption' | 'overlay' | 'fx'): Track[] {\n    return this.tracks.filter((track) => track.kind === kind);\n  }\n\n  // Clip operations with binary search optimization\n  findClip(id: string): Clip | null {\n    return this.clipMap.get(id) || null;\n  }\n\n  getClipsAtTime(timeUs: TimeUs, trackId?: string): Clip[] {\n    const tracks = trackId ? [this.findTrack(trackId)] : this.tracks;\n    const clips: Clip[] = [];\n\n    for (const track of tracks) {\n      if (!track) continue;\n      // Use binary search for single point lookup\n      const clip = binarySearchRange(track.clips, timeUs, (entry, _index) => ({\n        start: entry.startUs,\n        end: entry.startUs + entry.durationUs,\n      }));\n\n      if (clip) {\n        clips.push(clip);\n      }\n    }\n\n    return clips;\n  }\n\n  getActiveClips(startUs: TimeUs, endUs: TimeUs): Clip[] {\n    const clips: Clip[] = [];\n\n    for (const track of this.tracks) {\n      // Use binary search for range overlap\n      const overlappingClips = binarySearchOverlapping(\n        track.clips,\n        startUs,\n        endUs,\n        (clip, _index) => ({\n          start: clip.startUs,\n          end: clip.startUs + clip.durationUs,\n        })\n      );\n\n      clips.push(...overlappingClips);\n    }\n\n    return clips;\n  }\n\n  /**\n   * Get all clips in a specific track that overlap with the given time range\n   * Uses binary search for O(log n + k) performance\n   * @param startUs - Range start time (inclusive)\n   * @param endUs - Range end time (exclusive)\n   * @param trackId - Optional track ID to filter (defaults to main track)\n   */\n  getClipsInRange(startUs: TimeUs, endUs: TimeUs, trackId?: string): Clip[] {\n    const targetTrackId = trackId ?? this.mainTrackId;\n    const track = this.findTrack(targetTrackId);\n\n    if (!track) {\n      return [];\n    }\n\n    return binarySearchOverlapping(track.clips, startUs, endUs, (clip) => ({\n      start: clip.startUs,\n      end: clip.startUs + clip.durationUs,\n    }));\n  }\n\n  getClipIdsByResourceId(resourceId: string): string[] {\n    const resource = this.resources.get(resourceId);\n    return resource?.clipIds || [];\n  }\n\n  getClipIdAtTime(trackId: string, timeUs: TimeUs): string | undefined {\n    const track = this.findTrack(trackId);\n    if (!track) {\n      return undefined;\n    }\n\n    const clip = binarySearchRange(track.clips, timeUs, (entry, _index) => ({\n      start: entry.startUs,\n      end: entry.startUs + entry.durationUs,\n    }));\n\n    return clip?.id;\n  }\n\n  /**\n   * Get neighboring clips (Prev/Current/Next) at a specific time for video tracks\n   * Returns prev, current, and next clip IDs\n   */\n  getNeighboringClips(timeUs: TimeUs): { prev?: string; current?: string; next?: string } {\n    const videoTracks = this.getTracksByKind('video');\n    const result: { prev?: string; current?: string; next?: string } = {};\n\n    for (const track of videoTracks) {\n      const clips = track.clips;\n\n      for (let i = 0; i < clips.length; i++) {\n        const clip = clips[i];\n        if (!clip) continue;\n\n        const clipEndUs = clip.startUs + clip.durationUs;\n\n        if (clip.startUs <= timeUs && timeUs < clipEndUs) {\n          if (!result.current) {\n            result.current = clip.id;\n          }\n\n          if (i > 0 && !result.prev) {\n            const prevClip = clips[i - 1];\n            if (prevClip) {\n              result.prev = prevClip.id;\n            }\n          }\n\n          if (i < clips.length - 1 && !result.next) {\n            const nextClip = clips[i + 1];\n            if (nextClip) {\n              result.next = nextClip.id;\n            }\n          }\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * Get all clip IDs that should be cached using adaptive strategy\n   * - Short clips (≤ maxDuration): cache Current + Next (smooth transitions)\n   * - Long clips (> maxDuration): cache Current only (memory control)\n   * @param timeUs - Current playback time\n   * @param maxDuration - Max duration for 2-clip strategy (default 5s)\n   */\n  getClipsToCacheAtTime(timeUs: TimeUs, maxDuration = 5_000_000): Set<string> {\n    const { current, next } = this.getNeighboringClips(timeUs);\n    const clipIds = new Set<string>();\n\n    if (!current) return clipIds;\n    clipIds.add(current);\n\n    // Only cache next clip if current clip is short enough\n    const currentClip = this.findClip(current);\n    if (currentClip && currentClip.durationUs <= maxDuration && next) {\n      clipIds.add(next);\n    }\n\n    return clipIds;\n  }\n\n  // Resource operations\n  getResource(id: string): Resource | null {\n    return this.resources.get(id) || null;\n  }\n\n  updateResourceState(id: string, state: 'pending' | 'loading' | 'ready' | 'error'): void {\n    const resource = this.resources.get(id);\n    if (resource) {\n      resource.state = state;\n    }\n  }\n\n  getUnusedResources(): Resource[] {\n    const unused: Resource[] = [];\n\n    for (const [id, resource] of this.resources) {\n      if (!this.resourceRefCount.has(id) || this.resourceRefCount.get(id) === 0) {\n        unused.push(resource);\n      }\n    }\n\n    return unused;\n  }\n\n  // Time operations\n  getDuration(): TimeUs {\n    return this.durationUs;\n  }\n\n  getTrackDuration(trackId: string): TimeUs {\n    const track = this.findTrack(trackId);\n    if (!track || track.clips.length === 0) return 0;\n\n    // Since clips are sorted, last clip determines duration\n    const lastClip = track.clips[track.clips.length - 1];\n    return (lastClip?.startUs ?? 0) + (lastClip?.durationUs ?? 0);\n  }\n\n  buildIndexes(options?: {\n    incremental?: boolean;\n    trackId?: string;\n    clipId?: string;\n    clip?: Clip;\n    operation?: 'add' | 'update' | 'remove';\n  }): void {\n    const track = options?.trackId ? this.findTrack(options.trackId) : undefined;\n    const isAttachmentTrack = track && track.kind !== 'video' && track.kind !== 'audio';\n    // Incremental update for video/audio track clip operations\n    if (options?.incremental && !isAttachmentTrack && options.clipId && options.operation) {\n      const clip = options.clip ?? this.clipMap.get(options.clipId);\n\n      if (options.operation === 'add' && clip) {\n        this.addClipToIndexes(clip);\n      } else if (options.operation === 'remove' && clip) {\n        this.removeClipFromIndexes(clip);\n      } else if (options.operation === 'update' && clip) {\n        // Handle resource change during update\n        if (clip.oldResourceId) {\n          this.updateClipResourceIndex(\n            options.clipId,\n            clip.oldResourceId,\n            hasResourceId(clip) ? clip.resourceId : undefined\n          );\n        }\n      }\n\n      // Recalculate duration only if affected main track\n      if (track?.id === this.mainTrackId) {\n        this.recalculateDuration();\n      }\n      return;\n    }\n\n    // Full rebuild: needed for attachment tracks or initial load\n    this.fullRebuildIndexes();\n  }\n\n  private fullRebuildIndexes(): void {\n    // Clear existing indexes\n    this.trackMap.clear();\n    this.clipMap.clear();\n    this.resourceRefCount.clear();\n\n    // Step 1: Sink attachment tracks to main track (preserves original tracks)\n    this.sinkAttachmentTracks();\n\n    let maxEndUs = 0;\n\n    // Step 2: Build all indexes in one pass (track, clip, resource)\n    for (const track of this.tracks) {\n      this.trackMap.set(track.id, track);\n\n      for (const clip of track.clips) {\n        (clip as Clip).trackId = track.id;\n        (clip as Clip).trackKind = track.kind;\n        this.clipMap.set(clip.id, clip);\n\n        // Main track resource index (only for clips with resourceId)\n        if (hasResourceId(clip)) {\n          const resource = this.resources.get(clip.resourceId);\n          if (resource) {\n            resource.clipIds = [...(resource.clipIds || []), clip.id];\n          }\n          const count = this.resourceRefCount.get(clip.resourceId) || 0;\n          this.resourceRefCount.set(clip.resourceId, count + 1);\n        }\n\n        // Attachment resource indexes (attachments are already sunk)\n        const attachments = clip.attachments ?? [];\n        for (const attachment of attachments) {\n          const attachmentResourceId = attachment.data?.resourceId;\n          if (attachmentResourceId && typeof attachmentResourceId === 'string') {\n            const attachmentResource = this.resources.get(attachmentResourceId);\n            if (attachmentResource) {\n              const clipIds = attachmentResource.clipIds || [];\n              if (!clipIds.includes(clip.id)) {\n                attachmentResource.clipIds = [...clipIds, clip.id];\n              }\n            }\n            const attachmentCount = this.resourceRefCount.get(attachmentResourceId) || 0;\n            this.resourceRefCount.set(attachmentResourceId, attachmentCount + 1);\n          }\n        }\n\n        // Calculate max end time\n        const clipEndUs = clip.startUs + clip.durationUs;\n        if (clipEndUs > maxEndUs) {\n          maxEndUs = clipEndUs;\n        }\n      }\n    }\n\n    this.durationUs = maxEndUs;\n  }\n\n  private addClipToIndexes(clip: Clip): void {\n    this.clipMap.set(clip.id, clip);\n\n    if (hasResourceId(clip)) {\n      const resource = this.resources.get(clip.resourceId);\n      if (resource) {\n        if (!resource.clipIds) {\n          resource.clipIds = [];\n        }\n        if (!resource.clipIds.includes(clip.id)) {\n          resource.clipIds.push(clip.id);\n        }\n      }\n      const count = this.resourceRefCount.get(clip.resourceId) || 0;\n      this.resourceRefCount.set(clip.resourceId, count + 1);\n    }\n  }\n\n  private removeClipFromIndexes(clip: Clip): void {\n    this.clipMap.delete(clip.id);\n\n    const resourceId = clip.oldResourceId || (hasResourceId(clip) ? clip.resourceId : undefined);\n    if (resourceId) {\n      const resource = this.resources.get(resourceId);\n      if (resource?.clipIds) {\n        resource.clipIds = resource.clipIds.filter((id) => id !== clip.id);\n      }\n      const count = this.resourceRefCount.get(resourceId) || 0;\n      this.resourceRefCount.set(resourceId, Math.max(0, count - 1));\n    }\n  }\n\n  /**\n   * Incrementally update resource index when clip's resourceId changes\n   */\n  updateClipResourceIndex(\n    clipId: string,\n    oldResourceId: string | undefined,\n    newResourceId: string | undefined\n  ): void {\n    // Remove from old resource\n    if (oldResourceId) {\n      const oldResource = this.resources.get(oldResourceId);\n      if (oldResource?.clipIds) {\n        oldResource.clipIds = oldResource.clipIds.filter((id) => id !== clipId);\n      }\n      const oldCount = this.resourceRefCount.get(oldResourceId) || 0;\n      this.resourceRefCount.set(oldResourceId, Math.max(0, oldCount - 1));\n    }\n\n    // Add to new resource\n    if (newResourceId) {\n      const newResource = this.resources.get(newResourceId);\n      if (newResource) {\n        if (!newResource.clipIds) {\n          newResource.clipIds = [];\n        }\n        if (!newResource.clipIds.includes(clipId)) {\n          newResource.clipIds.push(clipId);\n        }\n      }\n      const newCount = this.resourceRefCount.get(newResourceId) || 0;\n      this.resourceRefCount.set(newResourceId, newCount + 1);\n    }\n  }\n\n  /**\n   * Recalculate total duration based on main track\n   */\n  recalculateDuration(): void {\n    const mainTrack = this.findTrack(this.mainTrackId);\n    if (!mainTrack || mainTrack.clips.length === 0) {\n      this.durationUs = 0;\n      return;\n    }\n\n    // Since clips are sorted, last clip determines duration\n    const lastClip = mainTrack.clips[mainTrack.clips.length - 1];\n    this.durationUs = (lastClip?.startUs ?? 0) + (lastClip?.durationUs ?? 0);\n  }\n\n  private sinkAttachmentTracks(): void {\n    let mainTrack: Track | undefined;\n    const attachmentTracks = [];\n\n    // Sort all tracks\n    for (const track of this.tracks) {\n      track.clips.sort((a, b) => a.startUs - b.startUs);\n\n      if (track.id === this.mainTrackId) {\n        mainTrack = track;\n        continue;\n      }\n      // Collect attachment tracks for sinking (caption, overlay, fx)\n      // Video and audio tracks are not sunk\n      if (track.kind === 'caption' || track.kind === 'overlay' || track.kind === 'fx') {\n        attachmentTracks.push(track);\n      }\n    }\n\n    if (!mainTrack) {\n      throw new Error('Main track not found');\n    }\n\n    if (attachmentTracks.length === 0) {\n      return;\n    }\n\n    // Clear existing attachments before sinking (in case of rebuild)\n    for (const clip of mainTrack.clips) {\n      clip.attachments = [];\n    }\n\n    for (const attachmentTrack of attachmentTracks) {\n      for (const attachmentClip of attachmentTrack.clips) {\n        // Use track.kind directly as attachment kind\n        const attachmentKind = attachmentTrack.kind;\n\n        for (const mainClip of mainTrack.clips) {\n          const overlap = this.getTimeOverlap(attachmentClip, mainClip);\n          if (!overlap) continue;\n\n          if (!mainClip.attachments) {\n            mainClip.attachments = [];\n          }\n\n          // Extract animation effect\n          const animationEffect = attachmentClip.effects?.find(\n            (e) => e.effectType === 'animation'\n          ) as AnimationEffect | undefined;\n\n          const attachmentData: Record<string, unknown> = {\n            animation: animationEffect?.params,\n            overlayClipStartUs: attachmentClip.startUs,\n            mainClipStartUs: mainClip.startUs,\n          };\n\n          // Add renderConfig if valid\n          const filteredRenderConfig = filterRenderConfig(\n            'renderConfig' in attachmentClip ? attachmentClip.renderConfig : undefined,\n            `attachment clip ${attachmentClip.id}`\n          );\n          if (filteredRenderConfig) {\n            attachmentData.renderConfig = filteredRenderConfig;\n          }\n\n          // Add resourceId if exists (trackKind not yet set, check field directly)\n          if ('resourceId' in attachmentClip && attachmentClip.resourceId) {\n            attachmentData.resourceId = attachmentClip.resourceId;\n          }\n\n          // Add text if exists (trackKind not yet set, check field directly)\n          if ('text' in attachmentClip && attachmentClip.text) {\n            attachmentData.text = attachmentClip.text;\n          }\n\n          if (isCaptionClip(attachmentClip)) {\n            if (attachmentClip.fontFamily) {\n              attachmentData.fontFamily = attachmentClip.fontFamily;\n            }\n            if (attachmentClip.localeCode) {\n              attachmentData.localeCode = attachmentClip.localeCode;\n            }\n            if (attachmentClip.fontTemplate) {\n              attachmentData.fontTemplate = attachmentClip.fontTemplate;\n            }\n            if (attachmentClip.wordTimings) {\n              attachmentData.wordTimings = attachmentClip.wordTimings;\n            }\n            if (attachmentClip.animation) {\n              attachmentData.animation = attachmentClip.animation;\n            }\n            if (attachmentClip.letterCase) {\n              attachmentData.letterCase = attachmentClip.letterCase;\n            }\n          }\n\n          const newAttachment = {\n            id: `${attachmentKind}-${attachmentClip.id}-${mainClip.id}`,\n            kind: attachmentKind,\n            startUs: overlap.clipRelativeStart,\n            durationUs: overlap.duration,\n            data: attachmentData,\n          };\n\n          mainClip.attachments.push(newAttachment);\n        }\n      }\n    }\n  }\n\n  private getTimeOverlap(\n    attachmentClip: Clip,\n    mainClip: Clip\n  ): { clipRelativeStart: number; duration: number } | null {\n    const attachmentStart = attachmentClip.startUs;\n    const attachmentEnd = attachmentClip.startUs + attachmentClip.durationUs;\n    const mainStart = mainClip.startUs;\n    const mainEnd = mainClip.startUs + mainClip.durationUs;\n\n    if (attachmentEnd <= mainStart || attachmentStart >= mainEnd) {\n      return null;\n    }\n\n    const overlapStart = Math.max(attachmentStart, mainStart);\n    const overlapEnd = Math.min(attachmentEnd, mainEnd);\n    const duration = overlapEnd - overlapStart;\n    const clipRelativeStart = overlapStart - mainStart;\n\n    return { clipRelativeStart, duration };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/model/types.js

@@ -4,6 +4,9 @@ function isVideoClip(clip) {
 function isAudioClip(clip) {
   return clip.trackKind === "audio";
 }
+function isCaptionClip(clip) {
+  return clip.trackKind === "caption";
+}
 function hasResourceId(clip) {
   return isVideoClip(clip) || isAudioClip(clip);
 }
@@ -26,6 +29,7 @@ export {
   hasAudioConfig,
   hasResourceId,
   isAudioClip,
+  isCaptionClip,
   isVideoClip,
   videoClipPlaybackRate
 };

package/dist/model/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/model/types.ts"],"sourcesContent":["// All time values in microseconds (µs)\nexport type TimeUs = number; // 1 second = 1_000_000 µs\n\n// Helper constants\nexport const MICROSECONDS_PER_SECOND = 1_000_000;\nexport const MICROSECONDS_PER_MILLISECOND = 1_000;\n\n// ────── Root Object ──────\nexport interface CompositionModelData {\n  version: '1.0';\n  fps: 24 | 25 | 30 | 60;\n  durationUs: TimeUs;\n  tracks: Track[];\n  resources: Record<string, Resource>;\n\n  mainTrackId?: string;\n  renderConfig?: RenderConfig;\n\n  ext?: Record<string, unknown>;\n}\n\nexport interface RenderConfig {\n  width: number;\n  height: number;\n  backgroundColor?: string;\n}\n\n// ────── Track ──────\nexport interface Track {\n  id: string;\n  kind: 'video' | 'audio' | 'caption' | 'overlay' | 'fx';\n  clips: Clip[];\n\n  effects?: Effect[];\n  duckingRules?: DuckingRule[];\n}\n\n// ────── Clip ──────\n\n// Clip-level render configuration for video/image resources\nexport interface ClipRenderConfig {\n  width?: number | string; // Pixels or percentage (e.g., \"10%\")\n  height?: number | string;\n}\n\ninterface BaseClip {\n  id: string;\n  startUs: TimeUs;\n  durationUs: TimeUs;\n  trackId?: string;\n\n  trimStartUs?: TimeUs;\n  /**\n   * Loop the underlying media content to fill this clip's duration.\n   *\n   * - AudioClip: loop audio samples\n   * - VideoClip: (future) loop video frames (and embedded audio) together\n   */\n  loop?: boolean;\n\n  effects?: Effect[];\n  attachments?: Attachment[];\n\n  transitionIn?: Transition;\n  transitionOut?: Transition;\n\n  metadata?: {\n    purpose?: 'caption' | 'overlay' | 'mask';\n    [key: string]: unknown;\n  };\n\n  // Internal: temporary field for tracking old resourceId during patch operations\n  oldResourceId?: string;\n}\n\nexport interface VideoClip extends BaseClip {\n  trackKind: 'video';\n  resourceId: string;\n\n  /**\n   * Timeline speed: source microseconds consumed per timeline microsecond (1 = normal).\n   * Effective source span for the clip is durationUs * playbackRate from trimStartUs.\n   */\n  playbackRate?: number;\n\n  // Render configuration (size, positioning strategy)\n  renderConfig?: ClipRenderConfig;\n\n  // Audio configuration for video's original sound\n  audioConfig?: {\n    volume?: number; // 0.0-1.0, default 1.0\n    muted?: boolean; // default false\n  };\n}\n\nexport interface AudioClip extends BaseClip {\n  trackKind: 'audio';\n  resourceId: string;\n\n  // Audio configuration\n  audioConfig?: {\n    volume?: number; // 0.0-1.0, default 1.0\n    muted?: boolean; // default false\n  };\n}\n\nexport interface CaptionClip extends BaseClip {\n  trackKind: 'caption';\n  text: string;\n  localeCode?: string;\n  fontTemplate?: string;\n  fontFamily?: string;\n  wordTimings?: Array<{\n    text: string;\n    startUs: TimeUs;\n    endUs: TimeUs;\n  }>;\n  animation?: {\n    type: 'none' | 'fade' | 'wordByWord' | 'characterKTV' | 'wordByWordFancy' | 'wordByWordSlideUp';\n    [key: string]: unknown;\n  };\n  letterCase?: 'upper' | 'lower' | 'none';\n}\n\nexport interface FxClip extends BaseClip {\n  trackKind: 'fx';\n}\n\nexport interface OverlayClip extends BaseClip {\n  trackKind: 'overlay';\n  resourceId: string;\n\n  // Render configuration (size, positioning strategy)\n  renderConfig?: ClipRenderConfig;\n\n  // Optional overlay-specific config\n  opacity?: number; // 0.0-1.0, default 1.0\n}\n\nexport type Clip = VideoClip | AudioClip | CaptionClip | OverlayClip | FxClip;\n\n// ────── Resource ──────\nexport interface Resource {\n  id: string;\n  type: 'video' | 'image' | 'audio' | 'json' | string;\n  uri: string;\n  metadata?: Record<string, unknown>;\n  clipIds?: string[];\n  // Runtime state maintained by engine\n  state?: 'pending' | 'loading' | 'ready' | 'error';\n  // Runtime error info maintained by engine (best-effort, non-persistent)\n  error?: {\n    code: string;\n    message: string;\n    terminal?: boolean;\n  };\n}\n\n// ────── Common Structures ──────\nexport interface Effect {\n  id: string;\n  effectType: 'filter' | 'lut' | 'animation' | string;\n  params?: Record<string, unknown>;\n}\n\n// Animation effect (effectType: 'animation')\nexport interface AnimationEffect extends Effect {\n  effectType: 'animation';\n  params: {\n    position: { x: number; y: number };\n    keyframes: AnimationKeyframe[];\n  };\n}\n\nexport interface AnimationKeyframe {\n  time: number; // Relative to clip.startUs (microseconds)\n  transform?: Transform2D;\n  opacity?: number;\n  easing?: 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';\n}\n\nexport interface Transform2D {\n  x?: number; // Relative offset\n  y?: number;\n  scaleX?: number;\n  scaleY?: number;\n  rotation?: number; // Degrees\n  anchorX?: number; // Rotation center x (0-1)\n  anchorY?: number; // Rotation center y (0-1)\n}\n\nexport interface Transition {\n  id: string;\n  transitionType: 'fade' | 'wipe' | 'slide' | string;\n  durationUs: TimeUs;\n  curve?: 'linear' | 'ease-in' | 'ease-out' | string;\n  params?: Record<string, unknown>;\n}\n\nexport interface Attachment {\n  id: string;\n  kind: 'caption' | 'overlay' | 'mask' | string;\n  startUs: TimeUs;\n  durationUs: TimeUs;\n  data: Record<string, unknown>;\n}\n\nexport interface CaptionAttachmentData {\n  text: string;\n  localeCode?: string;\n  fontTemplate?: string;\n  fontFamily?: string;\n  wordTimings?: Array<{\n    text: string;\n    startUs: TimeUs;\n    endUs: TimeUs;\n  }>;\n  animation?: {\n    type: 'none' | 'fade' | 'wordByWord' | 'characterKTV' | 'wordByWordFancy' | 'wordByWordSlideUp';\n    [key: string]: unknown;\n  };\n  letterCase?: 'upper' | 'lower' | 'none';\n  overlayClipStartUs?: TimeUs;\n  mainClipStartUs?: TimeUs;\n}\n\nexport interface DuckingRule {\n  targetTrackKind: 'voice' | 'audio' | string;\n  ratio: number;\n  attackMs: number;\n  releaseMs: number;\n}\n\n// ────── Patch System ──────\nexport interface CompositionPatch {\n  operations: PatchOperation[];\n  metadata?: {\n    timestamp: number;\n    source?: string;\n    version?: string;\n  };\n}\n\nexport type PatchOperation =\n  | TrackOperation\n  | ClipOperation\n  | ResourceOperation\n  | AttachmentOperation\n  | TransitionOperation\n  | EffectOperation\n  | RenderConfigOperation;\n\n// Track operations\nexport interface TrackOperation {\n  type: 'addTrack' | 'updateTrack' | 'removeTrack';\n  trackId?: string;\n  track?: Partial<Track>;\n}\n\n// Clip operations\nexport interface ClipOperation {\n  type: 'addClip' | 'updateClip' | 'removeClip' | 'moveClip';\n  trackId: string;\n  clipId?: string;\n  clip?: Partial<Clip>;\n  targetTrackId?: string;\n  targetStartUs?: TimeUs;\n}\n\n// Resource operations\nexport interface ResourceOperation {\n  type: 'addResource' | 'updateResource' | 'removeResource';\n  resourceId: string;\n  resource?: Partial<Resource>;\n}\n\n// Attachment operations\nexport interface AttachmentOperation {\n  type: 'addAttachment' | 'updateAttachment' | 'removeAttachment';\n  trackId: string;\n  clipId: string;\n  attachmentId?: string;\n  attachment?: Partial<Attachment>;\n}\n\n// Transition operations\nexport interface TransitionOperation {\n  type: 'addTransition' | 'updateTransition' | 'removeTransition';\n  trackId: string;\n  clipId: string;\n  position: 'in' | 'out';\n  transition?: Partial<Transition>;\n}\n\n// Render config operations\nexport interface RenderConfigOperation {\n  type: 'updateRenderConfig';\n  renderConfig?: Partial<RenderConfig>;\n}\n\n// Effect operations\nexport interface EffectOperation {\n  type: 'addEffect' | 'updateEffect' | 'removeEffect';\n  targetType: 'track' | 'clip';\n  targetId: string;\n  effectId?: string;\n  effect?: Partial<Effect>;\n}\n\n// ────── Dirty Range ──────\nexport interface DirtyRange {\n  trackId: string;\n  startUs: TimeUs;\n  endUs: TimeUs;\n  reason: string;\n}\n\n// ────── Validation ──────\nexport interface ValidationError {\n  path: string;\n  message: string;\n  value: any;\n}\n\n// ────── Type Guards ──────\nexport function isVideoClip(clip: Clip): clip is VideoClip {\n  return clip.trackKind === 'video';\n}\n\nexport function isAudioClip(clip: Clip): clip is AudioClip {\n  return clip.trackKind === 'audio';\n}\n\nexport function isCaptionClip(clip: Clip): clip is CaptionClip {\n  return clip.trackKind === 'caption';\n}\n\nexport function isFxClip(clip: Clip): clip is FxClip {\n  return clip.trackKind === 'fx';\n}\n\nexport function hasResourceId(clip: Clip): clip is VideoClip | AudioClip {\n  return isVideoClip(clip) || isAudioClip(clip);\n}\n\nexport function hasAudioConfig(clip: Clip): clip is VideoClip | AudioClip {\n  return isVideoClip(clip) || isAudioClip(clip);\n}\n\nconst PLAYBACK_RATE_MIN = 0.05;\nconst PLAYBACK_RATE_MAX = 32;\n\nexport function videoClipPlaybackRate(clip: Clip): number {\n  if (!isVideoClip(clip)) {\n    return 1;\n  }\n  const r = clip.playbackRate;\n  if (typeof r !== 'number' || !Number.isFinite(r) || r <= 0) {\n    return 1;\n  }\n  return Math.min(Math.max(r, PLAYBACK_RATE_MIN), PLAYBACK_RATE_MAX);\n}\n"],"names":[],"mappings":"AAqUO,SAAS,YAAY,MAA+B;AACzD,SAAO,KAAK,cAAc;AAC5B;AAEO,SAAS,YAAY,MAA+B;AACzD,SAAO,KAAK,cAAc;AAC5B;AAUO,SAAS,cAAc,MAA2C;AACvE,SAAO,YAAY,IAAI,KAAK,YAAY,IAAI;AAC9C;AAEO,SAAS,eAAe,MAA2C;AACxE,SAAO,YAAY,IAAI,KAAK,YAAY,IAAI;AAC9C;AAEA,MAAM,oBAAoB;AAC1B,MAAM,oBAAoB;AAEnB,SAAS,sBAAsB,MAAoB;AACxD,MAAI,CAAC,YAAY,IAAI,GAAG;AACtB,WAAO;AAAA,EACT;AACA,QAAM,IAAI,KAAK;AACf,MAAI,OAAO,MAAM,YAAY,CAAC,OAAO,SAAS,CAAC,KAAK,KAAK,GAAG;AAC1D,WAAO;AAAA,EACT;AACA,SAAO,KAAK,IAAI,KAAK,IAAI,GAAG,iBAAiB,GAAG,iBAAiB;AACnE;"}
+{"version":3,"file":"types.js","sources":["../../src/model/types.ts"],"sourcesContent":["// All time values in microseconds (µs)\nexport type TimeUs = number; // 1 second = 1_000_000 µs\n\n// Helper constants\nexport const MICROSECONDS_PER_SECOND = 1_000_000;\nexport const MICROSECONDS_PER_MILLISECOND = 1_000;\n\n// ────── Root Object ──────\nexport interface CompositionModelData {\n  version: '1.0';\n  fps: 24 | 25 | 30 | 60;\n  durationUs: TimeUs;\n  tracks: Track[];\n  resources: Record<string, Resource>;\n\n  mainTrackId?: string;\n  renderConfig?: RenderConfig;\n\n  ext?: Record<string, unknown>;\n}\n\nexport interface RenderConfig {\n  width: number;\n  height: number;\n  backgroundColor?: string;\n}\n\n// ────── Track ──────\nexport interface Track {\n  id: string;\n  kind: 'video' | 'audio' | 'caption' | 'overlay' | 'fx';\n  clips: Clip[];\n\n  effects?: Effect[];\n  duckingRules?: DuckingRule[];\n}\n\n// ────── Clip ──────\n\n// Clip-level render configuration for video/image resources\nexport interface ClipRenderConfig {\n  width?: number | string; // Pixels or percentage (e.g., \"10%\")\n  height?: number | string;\n}\n\ninterface BaseClip {\n  id: string;\n  startUs: TimeUs;\n  durationUs: TimeUs;\n  trackId?: string;\n\n  trimStartUs?: TimeUs;\n  /**\n   * Loop the underlying media content to fill this clip's duration.\n   *\n   * - AudioClip: loop audio samples\n   * - VideoClip: (future) loop video frames (and embedded audio) together\n   */\n  loop?: boolean;\n\n  effects?: Effect[];\n  attachments?: Attachment[];\n\n  transitionIn?: Transition;\n  transitionOut?: Transition;\n\n  metadata?: {\n    purpose?: 'caption' | 'overlay' | 'mask';\n    [key: string]: unknown;\n  };\n\n  // Internal: temporary field for tracking old resourceId during patch operations\n  oldResourceId?: string;\n}\n\nexport interface VideoClip extends BaseClip {\n  trackKind: 'video';\n  resourceId: string;\n\n  /**\n   * Timeline speed: source microseconds consumed per timeline microsecond (1 = normal).\n   * Effective source span for the clip is durationUs * playbackRate from trimStartUs.\n   */\n  playbackRate?: number;\n\n  // Render configuration (size, positioning strategy)\n  renderConfig?: ClipRenderConfig;\n\n  // Audio configuration for video's original sound\n  audioConfig?: {\n    volume?: number; // 0.0-1.0, default 1.0\n    muted?: boolean; // default false\n  };\n}\n\nexport interface AudioClip extends BaseClip {\n  trackKind: 'audio';\n  resourceId: string;\n\n  // Audio configuration\n  audioConfig?: {\n    volume?: number; // 0.0-1.0, default 1.0\n    muted?: boolean; // default false\n  };\n}\n\nexport interface CaptionClip extends BaseClip {\n  trackKind: 'caption';\n  text: string;\n  localeCode?: string;\n  fontTemplate?: string;\n  fontFamily?: string;\n  wordTimings?: Array<{\n    text: string;\n    startUs: TimeUs;\n    endUs: TimeUs;\n  }>;\n  animation?: {\n    type: 'none' | 'fade' | 'wordByWord' | 'characterKTV' | 'wordByWordFancy' | 'wordByWordSlideUp';\n    [key: string]: unknown;\n  };\n  letterCase?: 'upper' | 'lower' | 'none';\n}\n\nexport interface FxClip extends BaseClip {\n  trackKind: 'fx';\n}\n\nexport interface OverlayClip extends BaseClip {\n  trackKind: 'overlay';\n  resourceId: string;\n\n  // Render configuration (size, positioning strategy)\n  renderConfig?: ClipRenderConfig;\n\n  // Optional overlay-specific config\n  opacity?: number; // 0.0-1.0, default 1.0\n}\n\nexport type Clip = VideoClip | AudioClip | CaptionClip | OverlayClip | FxClip;\n\n// ────── Resource ──────\nexport interface Resource {\n  id: string;\n  type: 'video' | 'image' | 'audio' | 'json' | string;\n  uri: string;\n  metadata?: Record<string, unknown>;\n  clipIds?: string[];\n  // Runtime state maintained by engine\n  state?: 'pending' | 'loading' | 'ready' | 'error';\n  // Runtime error info maintained by engine (best-effort, non-persistent)\n  error?: {\n    code: string;\n    message: string;\n    terminal?: boolean;\n  };\n}\n\n// ────── Common Structures ──────\nexport interface Effect {\n  id: string;\n  effectType: 'filter' | 'lut' | 'animation' | string;\n  params?: Record<string, unknown>;\n}\n\n// Animation effect (effectType: 'animation')\nexport interface AnimationEffect extends Effect {\n  effectType: 'animation';\n  params: {\n    position: { x: number; y: number };\n    keyframes: AnimationKeyframe[];\n  };\n}\n\nexport interface AnimationKeyframe {\n  time: number; // Relative to clip.startUs (microseconds)\n  transform?: Transform2D;\n  opacity?: number;\n  easing?: 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out';\n}\n\nexport interface Transform2D {\n  x?: number; // Relative offset\n  y?: number;\n  scaleX?: number;\n  scaleY?: number;\n  rotation?: number; // Degrees\n  anchorX?: number; // Rotation center x (0-1)\n  anchorY?: number; // Rotation center y (0-1)\n}\n\nexport interface Transition {\n  id: string;\n  transitionType: 'fade' | 'wipe' | 'slide' | string;\n  durationUs: TimeUs;\n  curve?: 'linear' | 'ease-in' | 'ease-out' | string;\n  params?: Record<string, unknown>;\n}\n\nexport interface Attachment {\n  id: string;\n  kind: 'caption' | 'overlay' | 'mask' | string;\n  startUs: TimeUs;\n  durationUs: TimeUs;\n  data: Record<string, unknown>;\n}\n\nexport interface CaptionAttachmentData {\n  text: string;\n  localeCode?: string;\n  fontTemplate?: string;\n  fontFamily?: string;\n  wordTimings?: Array<{\n    text: string;\n    startUs: TimeUs;\n    endUs: TimeUs;\n  }>;\n  animation?: {\n    type: 'none' | 'fade' | 'wordByWord' | 'characterKTV' | 'wordByWordFancy' | 'wordByWordSlideUp';\n    [key: string]: unknown;\n  };\n  letterCase?: 'upper' | 'lower' | 'none';\n  overlayClipStartUs?: TimeUs;\n  mainClipStartUs?: TimeUs;\n}\n\nexport interface DuckingRule {\n  targetTrackKind: 'voice' | 'audio' | string;\n  ratio: number;\n  attackMs: number;\n  releaseMs: number;\n}\n\n// ────── Patch System ──────\nexport interface CompositionPatch {\n  operations: PatchOperation[];\n  metadata?: {\n    timestamp: number;\n    source?: string;\n    version?: string;\n  };\n}\n\nexport type PatchOperation =\n  | TrackOperation\n  | ClipOperation\n  | ResourceOperation\n  | AttachmentOperation\n  | TransitionOperation\n  | EffectOperation\n  | RenderConfigOperation;\n\n// Track operations\nexport interface TrackOperation {\n  type: 'addTrack' | 'updateTrack' | 'removeTrack';\n  trackId?: string;\n  track?: Partial<Track>;\n}\n\n// Clip operations\nexport interface ClipOperation {\n  type: 'addClip' | 'updateClip' | 'removeClip' | 'moveClip';\n  trackId: string;\n  clipId?: string;\n  clip?: Partial<Clip>;\n  targetTrackId?: string;\n  targetStartUs?: TimeUs;\n}\n\n// Resource operations\nexport interface ResourceOperation {\n  type: 'addResource' | 'updateResource' | 'removeResource';\n  resourceId: string;\n  resource?: Partial<Resource>;\n}\n\n// Attachment operations\nexport interface AttachmentOperation {\n  type: 'addAttachment' | 'updateAttachment' | 'removeAttachment';\n  trackId: string;\n  clipId: string;\n  attachmentId?: string;\n  attachment?: Partial<Attachment>;\n}\n\n// Transition operations\nexport interface TransitionOperation {\n  type: 'addTransition' | 'updateTransition' | 'removeTransition';\n  trackId: string;\n  clipId: string;\n  position: 'in' | 'out';\n  transition?: Partial<Transition>;\n}\n\n// Render config operations\nexport interface RenderConfigOperation {\n  type: 'updateRenderConfig';\n  renderConfig?: Partial<RenderConfig>;\n}\n\n// Effect operations\nexport interface EffectOperation {\n  type: 'addEffect' | 'updateEffect' | 'removeEffect';\n  targetType: 'track' | 'clip';\n  targetId: string;\n  effectId?: string;\n  effect?: Partial<Effect>;\n}\n\n// ────── Dirty Range ──────\nexport interface DirtyRange {\n  trackId: string;\n  startUs: TimeUs;\n  endUs: TimeUs;\n  reason: string;\n}\n\n// ────── Validation ──────\nexport interface ValidationError {\n  path: string;\n  message: string;\n  value: any;\n}\n\n// ────── Type Guards ──────\nexport function isVideoClip(clip: Clip): clip is VideoClip {\n  return clip.trackKind === 'video';\n}\n\nexport function isAudioClip(clip: Clip): clip is AudioClip {\n  return clip.trackKind === 'audio';\n}\n\nexport function isCaptionClip(clip: Clip): clip is CaptionClip {\n  return clip.trackKind === 'caption';\n}\n\nexport function isFxClip(clip: Clip): clip is FxClip {\n  return clip.trackKind === 'fx';\n}\n\nexport function hasResourceId(clip: Clip): clip is VideoClip | AudioClip {\n  return isVideoClip(clip) || isAudioClip(clip);\n}\n\nexport function hasAudioConfig(clip: Clip): clip is VideoClip | AudioClip {\n  return isVideoClip(clip) || isAudioClip(clip);\n}\n\nconst PLAYBACK_RATE_MIN = 0.05;\nconst PLAYBACK_RATE_MAX = 32;\n\nexport function videoClipPlaybackRate(clip: Clip): number {\n  if (!isVideoClip(clip)) {\n    return 1;\n  }\n  const r = clip.playbackRate;\n  if (typeof r !== 'number' || !Number.isFinite(r) || r <= 0) {\n    return 1;\n  }\n  return Math.min(Math.max(r, PLAYBACK_RATE_MIN), PLAYBACK_RATE_MAX);\n}\n"],"names":[],"mappings":"AAqUO,SAAS,YAAY,MAA+B;AACzD,SAAO,KAAK,cAAc;AAC5B;AAEO,SAAS,YAAY,MAA+B;AACzD,SAAO,KAAK,cAAc;AAC5B;AAEO,SAAS,cAAc,MAAiC;AAC7D,SAAO,KAAK,cAAc;AAC5B;AAMO,SAAS,cAAc,MAA2C;AACvE,SAAO,YAAY,IAAI,KAAK,YAAY,IAAI;AAC9C;AAEO,SAAS,eAAe,MAA2C;AACxE,SAAO,YAAY,IAAI,KAAK,YAAY,IAAI;AAC9C;AAEA,MAAM,oBAAoB;AAC1B,MAAM,oBAAoB;AAEnB,SAAS,sBAAsB,MAAoB;AACxD,MAAI,CAAC,YAAY,IAAI,GAAG;AACtB,WAAO;AAAA,EACT;AACA,QAAM,IAAI,KAAK;AACf,MAAI,OAAO,MAAM,YAAY,CAAC,OAAO,SAAS,CAAC,KAAK,KAAK,GAAG;AAC1D,WAAO;AAAA,EACT;AACA,SAAO,KAAK,IAAI,KAAK,IAAI,GAAG,iBAAiB,GAAG,iBAAiB;AACnE;"}

package/dist/orchestrator/AudioPreviewSession.js

@@ -14,8 +14,7 @@ class AudioPreviewSession {
   // - Always schedule audio in fixed 60s "mix blocks"
   // - Cache 2~3 mixed AudioBuffer blocks (LRU) to accelerate seek
   // - Schedule ahead using AudioContext clock to avoid underrun
-  PREVIEW_BLOCK_DURATION_US = 12 * 1e6;
-  // 12s
+  PREVIEW_BLOCK_DURATION_US = 90 * 1e6;
   PREVIEW_BLOCK_CACHE_SIZE = 3;
   PREVIEW_SCHEDULE_AHEAD_SEC = 6;
   // keep enough scheduled audio to hide mixing latency
@@ -244,7 +243,6 @@ class AudioPreviewSession {
           loadResource: true
         });
         const mixed = await this.mixer.mix(startUs, endUs);
-        if (!this.deps.cacheManager.isExporting) this.deps.cacheManager.clearAudioCache();
         return mixed;
       }, token);
     });

package/dist/orchestrator/AudioPreviewSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioPreviewSession.js","sources":["../../src/orchestrator/AudioPreviewSession.ts"],"sourcesContent":["import type { TimeUs } from '../model/types';\nimport { OfflineAudioMixer } from '../stages/compose/OfflineAudioMixer';\nimport { AudioMixBlockCache } from '../cache/AudioMixBlockCache';\nimport type { CacheManager } from '../cache/CacheManager';\nimport type { RequestMode } from './types';\nimport type { AudioWindowPreparer } from './AudioWindowPreparer';\n\nexport class AudioPreviewSession {\n  private mixer: OfflineAudioMixer;\n  private audioContext: AudioContext | null = null;\n  private volume = 1.0;\n  private playbackRate = 1.0;\n  private isPlaying = false;\n\n  // Preview strategy (unified):\n  // - Always schedule audio in fixed 60s \"mix blocks\"\n  // - Cache 2~3 mixed AudioBuffer blocks (LRU) to accelerate seek\n  // - Schedule ahead using AudioContext clock to avoid underrun\n  private readonly PREVIEW_BLOCK_DURATION_US: TimeUs = 12 * 1_000_000; // 12s\n  private readonly PREVIEW_BLOCK_CACHE_SIZE = 3;\n  private readonly PREVIEW_SCHEDULE_AHEAD_SEC = 6.0; // keep enough scheduled audio to hide mixing latency\n  private readonly PREVIEW_BUFFER_GUARD_US: TimeUs = 2_000_000; // if next block isn't ready near boundary -> buffering\n  private readonly PREVIEW_BLOCK_FADE_SEC = 0.01; // 10ms fade-in/out to avoid click at boundaries\n\n  private previewBlockCache = new AudioMixBlockCache(this.PREVIEW_BLOCK_CACHE_SIZE);\n\n  private previewScheduleTask: Promise<void> | null = null;\n  private previewScheduleToken = 0;\n  private previewMixToken = 0;\n  private previewNextBlockIndex = 0;\n  private previewNextScheduleTime = 0; // AudioContext time\n  private previewFirstBlockOffsetUs: TimeUs = 0; // seek offset within the first block\n  private previewLastTimelineUs: TimeUs = 0;\n  private previewLastStallWarnAt = 0; // AudioContext time (sec)\n\n  private previewScheduledSources = new Set<{ source: AudioBufferSourceNode; gain: GainNode }>();\n  private previewMixQueue: Promise<unknown> = Promise.resolve();\n\n  constructor(private deps: { cacheManager: CacheManager; preparer: AudioWindowPreparer }) {\n    this.mixer = new OfflineAudioMixer(deps.cacheManager, () => deps.preparer.getModel());\n  }\n\n  invalidatePreviewMixCache(): void {\n    // Mixed AudioBuffer blocks embed per-clip audioConfig (volume/muted).\n    // When model is replaced via setCompositionModel, these blocks must be invalidated,\n    // otherwise preview may keep scheduling old AudioBuffers and volume changes won't take effect.\n    this.previewBlockCache.clear();\n    // Ensure any in-flight mix tasks are dropped.\n    this.previewMixToken += 1;\n  }\n\n  private enqueuePreviewMix<T>(work: () => Promise<T>, token: number): Promise<T | null> {\n    const run = () => work();\n    const next = this.previewMixQueue.then(\n      () => {\n        // If a seek/reset happened since this task was enqueued, drop it.\n        if (this.previewMixToken !== token) {\n          return null;\n        }\n        return run();\n      },\n      () => {\n        if (this.previewMixToken !== token) {\n          return null;\n        }\n        return run();\n      }\n    );\n    // Keep queue alive even if a task fails.\n    this.previewMixQueue = next.then(\n      () => undefined,\n      () => undefined\n    );\n    return next as Promise<T | null>;\n  }\n\n  async ensureAudioForTime(timeUs: TimeUs, options?: { mode?: RequestMode }): Promise<void> {\n    if (this.deps.cacheManager.isExporting) return;\n\n    const model = this.deps.preparer.getModel();\n    if (!model) return;\n\n    const mode = options?.mode ?? 'blocking';\n\n    // Preview contract:\n    // - blocking: ensure the current 60s mixed block is ready (may be slow -> should be wrapped by buffering UI)\n    // - probe: best-effort preheat current and next block without blocking\n    const blockIndex = Math.floor(Math.max(0, timeUs) / this.PREVIEW_BLOCK_DURATION_US);\n\n    if (mode === 'probe') {\n      // Default: only preheat the current block.\n      void this.getOrCreateMixedBlock(blockIndex);\n\n      // If we're close enough to boundary (within scheduling lookahead), also preheat next block.\n      const blockEndUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;\n      const remainingToBoundaryUs = blockEndUs - Math.max(0, timeUs);\n      const lookaheadUs = Math.floor(this.PREVIEW_SCHEDULE_AHEAD_SEC * 1_000_000);\n      if (remainingToBoundaryUs > 0 && remainingToBoundaryUs <= lookaheadUs) {\n        void this.getOrCreateMixedBlock(blockIndex + 1);\n      }\n      return;\n    }\n\n    await this.getOrCreateMixedBlock(blockIndex);\n\n    // If we're very close to the block boundary, also ensure the next block.\n    const blockEndUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;\n    const remainingToBoundaryUs = blockEndUs - Math.max(0, timeUs);\n    if (remainingToBoundaryUs > 0 && remainingToBoundaryUs <= this.PREVIEW_BUFFER_GUARD_US) {\n      await this.getOrCreateMixedBlock(blockIndex + 1);\n    }\n  }\n\n  isPreviewMixBlockCached(timeUs: TimeUs): boolean {\n    const blockIndex = Math.floor(Math.max(0, timeUs) / this.PREVIEW_BLOCK_DURATION_US);\n    return this.previewBlockCache.get(blockIndex) !== null;\n  }\n\n  shouldEnterBufferingForUpcomingPreviewAudio(timeUs: TimeUs): boolean {\n    const model = this.deps.preparer.getModel();\n    if (!model) return false;\n\n    const clampedUs = Math.max(0, timeUs);\n    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);\n    const nextBlockStartUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;\n    if (nextBlockStartUs >= model.durationUs) return false;\n\n    const remainingToBoundaryUs = nextBlockStartUs - clampedUs;\n    if (remainingToBoundaryUs > this.PREVIEW_BUFFER_GUARD_US) return false;\n\n    // Probe next block readiness by checking cache at next block start time.\n    return !this.isPreviewMixBlockCached(nextBlockStartUs);\n  }\n\n  async startPlayback(timeUs: TimeUs, audioContext: AudioContext): Promise<void> {\n    this.audioContext = audioContext;\n\n    // Resume AudioContext if suspended (required by modern browsers)\n    if (audioContext.state === 'suspended') {\n      await audioContext.resume();\n    }\n\n    // Ensure audio is decoded and ready (blocking mode for startup).\n    await this.ensureAudioForTime(timeUs, { mode: 'blocking' });\n\n    this.isPlaying = true;\n\n    // Unified block scheduling: align to block index and schedule immediately.\n    this.startPreviewBlockScheduling(timeUs, audioContext);\n    // Schedule first block in blocking mode to avoid initial silence.\n    await this.scheduleNextPreviewBlock(audioContext, this.previewScheduleToken);\n    // Then keep scheduling in background.\n    void this.scheduleAudio(timeUs, audioContext);\n  }\n\n  stopPlayback(): void {\n    this.isPlaying = false;\n    this.stopAllPreviewSources();\n    this.cancelPreviewBlockScheduling();\n    this.previewMixToken += 1;\n  }\n\n  /**\n   * Schedule audio chunks ahead of playback cursor.\n   */\n  async scheduleAudio(currentTimelineUs: TimeUs, audioContext: AudioContext): Promise<void> {\n    if (!this.isPlaying || !this.deps.preparer.getModel() || !this.audioContext) {\n      return;\n    }\n\n    this.previewLastTimelineUs = currentTimelineUs;\n\n    // Keep scheduling in the background to avoid blocking the render loop.\n    if (this.previewScheduleTask) return;\n\n    // Initialize if needed (e.g. after model switch without explicit startPlayback).\n    if (this.previewNextScheduleTime === 0) {\n      this.startPreviewBlockScheduling(currentTimelineUs, audioContext);\n    }\n\n    const token = this.previewScheduleToken;\n    this.previewScheduleTask = this.runPreviewBlockSchedulingLoop(audioContext, token).finally(\n      () => {\n        if (this.previewScheduleToken === token) {\n          this.previewScheduleTask = null;\n        }\n      }\n    );\n  }\n\n  /**\n   * Reset playback states (called on seek)\n   */\n  resetPlaybackStates(): void {\n    this.stopAllPreviewSources();\n    this.cancelPreviewBlockScheduling();\n    this.previewMixToken += 1;\n  }\n\n  reset(): void {\n    this.stopPlayback();\n    this.deps.cacheManager.clearAudioCache();\n    this.previewBlockCache.clear();\n    this.deps.preparer.reset();\n  }\n\n  setVolume(volume: number): void {\n    this.volume = volume;\n    const audioContext = this.audioContext;\n    if (!audioContext) return;\n\n    // Apply volume to already scheduled nodes (small ramp to avoid click).\n    const t = audioContext.currentTime;\n    for (const { gain } of this.previewScheduledSources) {\n      try {\n        gain.gain.cancelScheduledValues(t);\n        gain.gain.setValueAtTime(gain.gain.value, t);\n        gain.gain.linearRampToValueAtTime(volume, t + 0.01);\n      } catch {\n        // ignore\n      }\n    }\n  }\n\n  setPlaybackRate(rate: number): void {\n    this.playbackRate = rate;\n    // Playback rate change requires restarting scheduling to keep sync with the timeline clock.\n    this.resetPlaybackStates();\n  }\n\n  private startPreviewBlockScheduling(startTimelineUs: TimeUs, audioContext: AudioContext): void {\n    this.cancelPreviewBlockScheduling();\n    this.stopAllPreviewSources();\n\n    const clampedUs = Math.max(0, startTimelineUs);\n    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);\n    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n\n    this.previewFirstBlockOffsetUs = clampedUs - blockStartUs;\n    this.previewNextBlockIndex = blockIndex;\n    this.previewNextScheduleTime = audioContext.currentTime + 0.02;\n    this.previewLastTimelineUs = startTimelineUs;\n  }\n\n  private cancelPreviewBlockScheduling(): void {\n    this.previewScheduleToken += 1;\n    this.previewScheduleTask = null;\n    this.previewNextBlockIndex = 0;\n    this.previewNextScheduleTime = 0;\n    this.previewFirstBlockOffsetUs = 0;\n    this.previewLastTimelineUs = 0;\n  }\n\n  private realignPreviewSchedulingToTimeline(audioContext: AudioContext): void {\n    const model = this.deps.preparer.getModel();\n    if (!model) return;\n\n    const clampedUs = Math.max(0, this.previewLastTimelineUs);\n    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);\n    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n    if (blockStartUs >= model.durationUs) return;\n\n    this.stopAllPreviewSources();\n    this.previewFirstBlockOffsetUs = clampedUs - blockStartUs;\n    this.previewNextBlockIndex = blockIndex;\n    this.previewNextScheduleTime = audioContext.currentTime + 0.02;\n  }\n\n  private async runPreviewBlockSchedulingLoop(\n    audioContext: AudioContext,\n    token: number\n  ): Promise<void> {\n    while (this.isPlaying && this.previewScheduleToken === token) {\n      const model = this.deps.preparer.getModel();\n      if (!model) return;\n\n      // End-of-timeline: nothing more to schedule.\n      const nextBlockStartUs = this.previewNextBlockIndex * this.PREVIEW_BLOCK_DURATION_US;\n      if (nextBlockStartUs >= model.durationUs) {\n        this.previewNextScheduleTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;\n        return;\n      }\n\n      const scheduleAheadTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;\n      if (this.previewNextScheduleTime >= scheduleAheadTime) return;\n\n      const prevBlockIndex = this.previewNextBlockIndex;\n      const prevScheduleTime = this.previewNextScheduleTime;\n\n      await this.scheduleNextPreviewBlock(audioContext, token);\n\n      // If scheduling made no progress, bail out to avoid a tight loop that can freeze UI.\n      if (\n        this.previewScheduleToken === token &&\n        this.previewNextBlockIndex === prevBlockIndex &&\n        this.previewNextScheduleTime === prevScheduleTime\n      ) {\n        const now = audioContext.currentTime;\n        if (now - this.previewLastStallWarnAt >= 1) {\n          this.previewLastStallWarnAt = now;\n          console.warn('[AudioPreviewSession] scheduling stalled; stop loop to avoid spin', {\n            prevBlockIndex,\n            prevScheduleTime,\n            now,\n          });\n        }\n        return;\n      }\n    }\n  }\n\n  private async getOrCreateMixedBlock(blockIndex: number): Promise<AudioBuffer | null> {\n    const model = this.deps.preparer.getModel();\n    if (!model) return null;\n\n    const token = this.previewMixToken;\n\n    return await this.previewBlockCache.getOrCreate(blockIndex, async () => {\n      return await this.enqueuePreviewMix(async () => {\n        // If export starts while a preview mix task is already queued/running, drop it.\n        if (this.deps.cacheManager.isExporting) return null;\n\n        const startUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n        const endUs = Math.min(startUs + this.PREVIEW_BLOCK_DURATION_US, model.durationUs);\n        await this.deps.preparer.ensureAudioForTimeRange(startUs, endUs, {\n          mode: 'blocking',\n          loadResource: true,\n        });\n        const mixed = await this.mixer.mix(startUs, endUs);\n\n        // Preview uses mixed AudioBuffer blocks as the primary cache.\n        if (!this.deps.cacheManager.isExporting) this.deps.cacheManager.clearAudioCache();\n\n        return mixed;\n      }, token);\n    });\n  }\n\n  private async scheduleNextPreviewBlock(audioContext: AudioContext, token: number): Promise<void> {\n    const model = this.deps.preparer.getModel();\n    if (!this.isPlaying || !model) return;\n    if (this.previewScheduleToken !== token) return;\n\n    // If we're behind the audio clock, resync to avoid attempting to schedule in the past.\n    if (this.previewNextScheduleTime < audioContext.currentTime + 0.01) {\n      this.realignPreviewSchedulingToTimeline(audioContext);\n    }\n\n    const blockIndex = this.previewNextBlockIndex;\n    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n    if (blockStartUs >= model.durationUs) {\n      // End-of-timeline: advance state so scheduling loop can finish without stalling.\n      this.previewFirstBlockOffsetUs = 0;\n      this.previewNextBlockIndex = blockIndex + 1;\n      this.previewNextScheduleTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;\n      return;\n    }\n\n    const buffer = await this.getOrCreateMixedBlock(blockIndex);\n    if (!buffer) {\n      // Could be cancelled (seek/reset) or an empty-range guard; advance to avoid stalling.\n      this.previewFirstBlockOffsetUs = 0;\n      this.previewNextBlockIndex = blockIndex + 1;\n      this.previewNextScheduleTime = audioContext.currentTime + 0.02;\n      return;\n    }\n    if (this.previewScheduleToken !== token) return;\n\n    const rate = this.playbackRate || 1.0;\n    const offsetUs = this.previewFirstBlockOffsetUs;\n    let startTime = this.previewNextScheduleTime;\n    let offsetSec = offsetUs > 0 ? offsetUs / 1_000_000 : 0;\n\n    // Mixing can be slow; after await, startTime might already be in the past.\n    const now = audioContext.currentTime;\n    if (startTime < now + 0.01) {\n      const targetStartTime = now + 0.02;\n      const skippedSec = Math.max(0, (targetStartTime - startTime) * rate);\n      startTime = targetStartTime;\n      offsetSec += skippedSec;\n    }\n\n    if (offsetSec >= buffer.duration) {\n      this.previewFirstBlockOffsetUs = 0;\n      this.previewNextBlockIndex = blockIndex + 1;\n      this.previewNextScheduleTime = startTime;\n      return;\n    }\n\n    const remainingSec = Math.max(0, buffer.duration - offsetSec);\n    if (remainingSec <= 0) return;\n\n    const source = audioContext.createBufferSource();\n    source.buffer = buffer;\n    source.playbackRate.value = rate;\n\n    const gainNode = audioContext.createGain();\n    const volume = this.volume;\n\n    // Fade in/out to avoid click at block boundaries.\n    const fadeSec = Math.min(this.PREVIEW_BLOCK_FADE_SEC, remainingSec / 2);\n    gainNode.gain.setValueAtTime(0, startTime);\n    gainNode.gain.linearRampToValueAtTime(volume, startTime + fadeSec);\n    gainNode.gain.setValueAtTime(volume, startTime + Math.max(fadeSec, remainingSec - fadeSec));\n    gainNode.gain.linearRampToValueAtTime(0, startTime + remainingSec);\n\n    source.connect(gainNode);\n    gainNode.connect(audioContext.destination);\n    source.start(startTime, offsetSec);\n\n    const entry = { source, gain: gainNode };\n    this.previewScheduledSources.add(entry);\n\n    source.onended = () => {\n      try {\n        source.disconnect();\n        gainNode.disconnect();\n      } catch {\n        // ignore\n      }\n      this.previewScheduledSources.delete(entry);\n    };\n\n    // Advance to next block\n    this.previewFirstBlockOffsetUs = 0;\n    this.previewNextBlockIndex = blockIndex + 1;\n    this.previewNextScheduleTime = startTime + remainingSec / rate;\n  }\n\n  private stopAllPreviewSources(): void {\n    for (const { source, gain } of this.previewScheduledSources) {\n      try {\n        source.disconnect();\n      } catch {\n        // ignore\n      }\n      try {\n        source.stop(0);\n      } catch {\n        // ignore\n      }\n      try {\n        gain.disconnect();\n      } catch {\n        // ignore\n      }\n    }\n    this.previewScheduledSources.clear();\n  }\n}\n"],"names":["blockEndUs","remainingToBoundaryUs"],"mappings":"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"}
+{"version":3,"file":"AudioPreviewSession.js","sources":["../../src/orchestrator/AudioPreviewSession.ts"],"sourcesContent":["import type { TimeUs } from '../model/types';\nimport { OfflineAudioMixer } from '../stages/compose/OfflineAudioMixer';\nimport { AudioMixBlockCache } from '../cache/AudioMixBlockCache';\nimport type { CacheManager } from '../cache/CacheManager';\nimport type { RequestMode } from './types';\nimport type { AudioWindowPreparer } from './AudioWindowPreparer';\n\nexport class AudioPreviewSession {\n  private mixer: OfflineAudioMixer;\n  private audioContext: AudioContext | null = null;\n  private volume = 1.0;\n  private playbackRate = 1.0;\n  private isPlaying = false;\n\n  // Preview strategy (unified):\n  // - Always schedule audio in fixed 60s \"mix blocks\"\n  // - Cache 2~3 mixed AudioBuffer blocks (LRU) to accelerate seek\n  // - Schedule ahead using AudioContext clock to avoid underrun\n  private readonly PREVIEW_BLOCK_DURATION_US: TimeUs = 90 * 1_000_000;\n  private readonly PREVIEW_BLOCK_CACHE_SIZE = 3;\n  private readonly PREVIEW_SCHEDULE_AHEAD_SEC = 6.0; // keep enough scheduled audio to hide mixing latency\n  private readonly PREVIEW_BUFFER_GUARD_US: TimeUs = 2_000_000; // if next block isn't ready near boundary -> buffering\n  private readonly PREVIEW_BLOCK_FADE_SEC = 0.01; // 10ms fade-in/out to avoid click at boundaries\n\n  private previewBlockCache = new AudioMixBlockCache(this.PREVIEW_BLOCK_CACHE_SIZE);\n\n  private previewScheduleTask: Promise<void> | null = null;\n  private previewScheduleToken = 0;\n  private previewMixToken = 0;\n  private previewNextBlockIndex = 0;\n  private previewNextScheduleTime = 0; // AudioContext time\n  private previewFirstBlockOffsetUs: TimeUs = 0; // seek offset within the first block\n  private previewLastTimelineUs: TimeUs = 0;\n  private previewLastStallWarnAt = 0; // AudioContext time (sec)\n\n  private previewScheduledSources = new Set<{ source: AudioBufferSourceNode; gain: GainNode }>();\n  private previewMixQueue: Promise<unknown> = Promise.resolve();\n\n  constructor(private deps: { cacheManager: CacheManager; preparer: AudioWindowPreparer }) {\n    this.mixer = new OfflineAudioMixer(deps.cacheManager, () => deps.preparer.getModel());\n  }\n\n  invalidatePreviewMixCache(): void {\n    // Mixed AudioBuffer blocks embed per-clip audioConfig (volume/muted).\n    // When model is replaced via setCompositionModel, these blocks must be invalidated,\n    // otherwise preview may keep scheduling old AudioBuffers and volume changes won't take effect.\n    this.previewBlockCache.clear();\n    // Ensure any in-flight mix tasks are dropped.\n    this.previewMixToken += 1;\n  }\n\n  private enqueuePreviewMix<T>(work: () => Promise<T>, token: number): Promise<T | null> {\n    const run = () => work();\n    const next = this.previewMixQueue.then(\n      () => {\n        // If a seek/reset happened since this task was enqueued, drop it.\n        if (this.previewMixToken !== token) {\n          return null;\n        }\n        return run();\n      },\n      () => {\n        if (this.previewMixToken !== token) {\n          return null;\n        }\n        return run();\n      }\n    );\n    // Keep queue alive even if a task fails.\n    this.previewMixQueue = next.then(\n      () => undefined,\n      () => undefined\n    );\n    return next as Promise<T | null>;\n  }\n\n  async ensureAudioForTime(timeUs: TimeUs, options?: { mode?: RequestMode }): Promise<void> {\n    if (this.deps.cacheManager.isExporting) return;\n\n    const model = this.deps.preparer.getModel();\n    if (!model) return;\n\n    const mode = options?.mode ?? 'blocking';\n\n    // Preview contract:\n    // - blocking: ensure the current 60s mixed block is ready (may be slow -> should be wrapped by buffering UI)\n    // - probe: best-effort preheat current and next block without blocking\n    const blockIndex = Math.floor(Math.max(0, timeUs) / this.PREVIEW_BLOCK_DURATION_US);\n\n    if (mode === 'probe') {\n      // Default: only preheat the current block.\n      void this.getOrCreateMixedBlock(blockIndex);\n\n      // If we're close enough to boundary (within scheduling lookahead), also preheat next block.\n      const blockEndUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;\n      const remainingToBoundaryUs = blockEndUs - Math.max(0, timeUs);\n      const lookaheadUs = Math.floor(this.PREVIEW_SCHEDULE_AHEAD_SEC * 1_000_000);\n      if (remainingToBoundaryUs > 0 && remainingToBoundaryUs <= lookaheadUs) {\n        void this.getOrCreateMixedBlock(blockIndex + 1);\n      }\n      return;\n    }\n\n    await this.getOrCreateMixedBlock(blockIndex);\n\n    // If we're very close to the block boundary, also ensure the next block.\n    const blockEndUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;\n    const remainingToBoundaryUs = blockEndUs - Math.max(0, timeUs);\n    if (remainingToBoundaryUs > 0 && remainingToBoundaryUs <= this.PREVIEW_BUFFER_GUARD_US) {\n      await this.getOrCreateMixedBlock(blockIndex + 1);\n    }\n  }\n\n  isPreviewMixBlockCached(timeUs: TimeUs): boolean {\n    const blockIndex = Math.floor(Math.max(0, timeUs) / this.PREVIEW_BLOCK_DURATION_US);\n    return this.previewBlockCache.get(blockIndex) !== null;\n  }\n\n  shouldEnterBufferingForUpcomingPreviewAudio(timeUs: TimeUs): boolean {\n    const model = this.deps.preparer.getModel();\n    if (!model) return false;\n\n    const clampedUs = Math.max(0, timeUs);\n    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);\n    const nextBlockStartUs = (blockIndex + 1) * this.PREVIEW_BLOCK_DURATION_US;\n    if (nextBlockStartUs >= model.durationUs) return false;\n\n    const remainingToBoundaryUs = nextBlockStartUs - clampedUs;\n    if (remainingToBoundaryUs > this.PREVIEW_BUFFER_GUARD_US) return false;\n\n    // Probe next block readiness by checking cache at next block start time.\n    return !this.isPreviewMixBlockCached(nextBlockStartUs);\n  }\n\n  async startPlayback(timeUs: TimeUs, audioContext: AudioContext): Promise<void> {\n    this.audioContext = audioContext;\n\n    // Resume AudioContext if suspended (required by modern browsers)\n    if (audioContext.state === 'suspended') {\n      await audioContext.resume();\n    }\n\n    // Ensure audio is decoded and ready (blocking mode for startup).\n    await this.ensureAudioForTime(timeUs, { mode: 'blocking' });\n\n    this.isPlaying = true;\n\n    // Unified block scheduling: align to block index and schedule immediately.\n    this.startPreviewBlockScheduling(timeUs, audioContext);\n    // Schedule first block in blocking mode to avoid initial silence.\n    await this.scheduleNextPreviewBlock(audioContext, this.previewScheduleToken);\n    // Then keep scheduling in background.\n    void this.scheduleAudio(timeUs, audioContext);\n  }\n\n  stopPlayback(): void {\n    this.isPlaying = false;\n    this.stopAllPreviewSources();\n    this.cancelPreviewBlockScheduling();\n    this.previewMixToken += 1;\n  }\n\n  /**\n   * Schedule audio chunks ahead of playback cursor.\n   */\n  async scheduleAudio(currentTimelineUs: TimeUs, audioContext: AudioContext): Promise<void> {\n    if (!this.isPlaying || !this.deps.preparer.getModel() || !this.audioContext) {\n      return;\n    }\n\n    this.previewLastTimelineUs = currentTimelineUs;\n\n    // Keep scheduling in the background to avoid blocking the render loop.\n    if (this.previewScheduleTask) return;\n\n    // Initialize if needed (e.g. after model switch without explicit startPlayback).\n    if (this.previewNextScheduleTime === 0) {\n      this.startPreviewBlockScheduling(currentTimelineUs, audioContext);\n    }\n\n    const token = this.previewScheduleToken;\n    this.previewScheduleTask = this.runPreviewBlockSchedulingLoop(audioContext, token).finally(\n      () => {\n        if (this.previewScheduleToken === token) {\n          this.previewScheduleTask = null;\n        }\n      }\n    );\n  }\n\n  /**\n   * Reset playback states (called on seek)\n   */\n  resetPlaybackStates(): void {\n    this.stopAllPreviewSources();\n    this.cancelPreviewBlockScheduling();\n    this.previewMixToken += 1;\n  }\n\n  reset(): void {\n    this.stopPlayback();\n    this.deps.cacheManager.clearAudioCache();\n    this.previewBlockCache.clear();\n    this.deps.preparer.reset();\n  }\n\n  setVolume(volume: number): void {\n    this.volume = volume;\n    const audioContext = this.audioContext;\n    if (!audioContext) return;\n\n    // Apply volume to already scheduled nodes (small ramp to avoid click).\n    const t = audioContext.currentTime;\n    for (const { gain } of this.previewScheduledSources) {\n      try {\n        gain.gain.cancelScheduledValues(t);\n        gain.gain.setValueAtTime(gain.gain.value, t);\n        gain.gain.linearRampToValueAtTime(volume, t + 0.01);\n      } catch {\n        // ignore\n      }\n    }\n  }\n\n  setPlaybackRate(rate: number): void {\n    this.playbackRate = rate;\n    // Playback rate change requires restarting scheduling to keep sync with the timeline clock.\n    this.resetPlaybackStates();\n  }\n\n  private startPreviewBlockScheduling(startTimelineUs: TimeUs, audioContext: AudioContext): void {\n    this.cancelPreviewBlockScheduling();\n    this.stopAllPreviewSources();\n\n    const clampedUs = Math.max(0, startTimelineUs);\n    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);\n    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n\n    this.previewFirstBlockOffsetUs = clampedUs - blockStartUs;\n    this.previewNextBlockIndex = blockIndex;\n    this.previewNextScheduleTime = audioContext.currentTime + 0.02;\n    this.previewLastTimelineUs = startTimelineUs;\n  }\n\n  private cancelPreviewBlockScheduling(): void {\n    this.previewScheduleToken += 1;\n    this.previewScheduleTask = null;\n    this.previewNextBlockIndex = 0;\n    this.previewNextScheduleTime = 0;\n    this.previewFirstBlockOffsetUs = 0;\n    this.previewLastTimelineUs = 0;\n  }\n\n  private realignPreviewSchedulingToTimeline(audioContext: AudioContext): void {\n    const model = this.deps.preparer.getModel();\n    if (!model) return;\n\n    const clampedUs = Math.max(0, this.previewLastTimelineUs);\n    const blockIndex = Math.floor(clampedUs / this.PREVIEW_BLOCK_DURATION_US);\n    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n    if (blockStartUs >= model.durationUs) return;\n\n    this.stopAllPreviewSources();\n    this.previewFirstBlockOffsetUs = clampedUs - blockStartUs;\n    this.previewNextBlockIndex = blockIndex;\n    this.previewNextScheduleTime = audioContext.currentTime + 0.02;\n  }\n\n  private async runPreviewBlockSchedulingLoop(\n    audioContext: AudioContext,\n    token: number\n  ): Promise<void> {\n    while (this.isPlaying && this.previewScheduleToken === token) {\n      const model = this.deps.preparer.getModel();\n      if (!model) return;\n\n      // End-of-timeline: nothing more to schedule.\n      const nextBlockStartUs = this.previewNextBlockIndex * this.PREVIEW_BLOCK_DURATION_US;\n      if (nextBlockStartUs >= model.durationUs) {\n        this.previewNextScheduleTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;\n        return;\n      }\n\n      const scheduleAheadTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;\n      if (this.previewNextScheduleTime >= scheduleAheadTime) return;\n\n      const prevBlockIndex = this.previewNextBlockIndex;\n      const prevScheduleTime = this.previewNextScheduleTime;\n\n      await this.scheduleNextPreviewBlock(audioContext, token);\n\n      // If scheduling made no progress, bail out to avoid a tight loop that can freeze UI.\n      if (\n        this.previewScheduleToken === token &&\n        this.previewNextBlockIndex === prevBlockIndex &&\n        this.previewNextScheduleTime === prevScheduleTime\n      ) {\n        const now = audioContext.currentTime;\n        if (now - this.previewLastStallWarnAt >= 1) {\n          this.previewLastStallWarnAt = now;\n          console.warn('[AudioPreviewSession] scheduling stalled; stop loop to avoid spin', {\n            prevBlockIndex,\n            prevScheduleTime,\n            now,\n          });\n        }\n        return;\n      }\n    }\n  }\n\n  private async getOrCreateMixedBlock(blockIndex: number): Promise<AudioBuffer | null> {\n    const model = this.deps.preparer.getModel();\n    if (!model) return null;\n\n    const token = this.previewMixToken;\n\n    return await this.previewBlockCache.getOrCreate(blockIndex, async () => {\n      return await this.enqueuePreviewMix(async () => {\n        // If export starts while a preview mix task is already queued/running, drop it.\n        if (this.deps.cacheManager.isExporting) return null;\n\n        const startUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n        const endUs = Math.min(startUs + this.PREVIEW_BLOCK_DURATION_US, model.durationUs);\n        await this.deps.preparer.ensureAudioForTimeRange(startUs, endUs, {\n          mode: 'blocking',\n          loadResource: true,\n        });\n        const mixed = await this.mixer.mix(startUs, endUs);\n\n        // Preview uses mixed AudioBuffer blocks as the primary cache.\n        //if (!this.deps.cacheManager.isExporting) this.deps.cacheManager.clearAudioCache();\n\n        return mixed;\n      }, token);\n    });\n  }\n\n  private async scheduleNextPreviewBlock(audioContext: AudioContext, token: number): Promise<void> {\n    const model = this.deps.preparer.getModel();\n    if (!this.isPlaying || !model) return;\n    if (this.previewScheduleToken !== token) return;\n\n    // If we're behind the audio clock, resync to avoid attempting to schedule in the past.\n    if (this.previewNextScheduleTime < audioContext.currentTime + 0.01) {\n      this.realignPreviewSchedulingToTimeline(audioContext);\n    }\n\n    const blockIndex = this.previewNextBlockIndex;\n    const blockStartUs = blockIndex * this.PREVIEW_BLOCK_DURATION_US;\n    if (blockStartUs >= model.durationUs) {\n      // End-of-timeline: advance state so scheduling loop can finish without stalling.\n      this.previewFirstBlockOffsetUs = 0;\n      this.previewNextBlockIndex = blockIndex + 1;\n      this.previewNextScheduleTime = audioContext.currentTime + this.PREVIEW_SCHEDULE_AHEAD_SEC;\n      return;\n    }\n\n    const buffer = await this.getOrCreateMixedBlock(blockIndex);\n    if (!buffer) {\n      // Could be cancelled (seek/reset) or an empty-range guard; advance to avoid stalling.\n      this.previewFirstBlockOffsetUs = 0;\n      this.previewNextBlockIndex = blockIndex + 1;\n      this.previewNextScheduleTime = audioContext.currentTime + 0.02;\n      return;\n    }\n    if (this.previewScheduleToken !== token) return;\n\n    const rate = this.playbackRate || 1.0;\n    const offsetUs = this.previewFirstBlockOffsetUs;\n    let startTime = this.previewNextScheduleTime;\n    let offsetSec = offsetUs > 0 ? offsetUs / 1_000_000 : 0;\n\n    // Mixing can be slow; after await, startTime might already be in the past.\n    const now = audioContext.currentTime;\n    if (startTime < now + 0.01) {\n      const targetStartTime = now + 0.02;\n      const skippedSec = Math.max(0, (targetStartTime - startTime) * rate);\n      startTime = targetStartTime;\n      offsetSec += skippedSec;\n    }\n\n    if (offsetSec >= buffer.duration) {\n      this.previewFirstBlockOffsetUs = 0;\n      this.previewNextBlockIndex = blockIndex + 1;\n      this.previewNextScheduleTime = startTime;\n      return;\n    }\n\n    const remainingSec = Math.max(0, buffer.duration - offsetSec);\n    if (remainingSec <= 0) return;\n\n    const source = audioContext.createBufferSource();\n    source.buffer = buffer;\n    source.playbackRate.value = rate;\n\n    const gainNode = audioContext.createGain();\n    const volume = this.volume;\n\n    // Fade in/out to avoid click at block boundaries.\n    const fadeSec = Math.min(this.PREVIEW_BLOCK_FADE_SEC, remainingSec / 2);\n    gainNode.gain.setValueAtTime(0, startTime);\n    gainNode.gain.linearRampToValueAtTime(volume, startTime + fadeSec);\n    gainNode.gain.setValueAtTime(volume, startTime + Math.max(fadeSec, remainingSec - fadeSec));\n    gainNode.gain.linearRampToValueAtTime(0, startTime + remainingSec);\n\n    source.connect(gainNode);\n    gainNode.connect(audioContext.destination);\n    source.start(startTime, offsetSec);\n\n    const entry = { source, gain: gainNode };\n    this.previewScheduledSources.add(entry);\n\n    source.onended = () => {\n      try {\n        source.disconnect();\n        gainNode.disconnect();\n      } catch {\n        // ignore\n      }\n      this.previewScheduledSources.delete(entry);\n    };\n\n    // Advance to next block\n    this.previewFirstBlockOffsetUs = 0;\n    this.previewNextBlockIndex = blockIndex + 1;\n    this.previewNextScheduleTime = startTime + remainingSec / rate;\n  }\n\n  private stopAllPreviewSources(): void {\n    for (const { source, gain } of this.previewScheduledSources) {\n      try {\n        source.disconnect();\n      } catch {\n        // ignore\n      }\n      try {\n        source.stop(0);\n      } catch {\n        // ignore\n      }\n      try {\n        gain.disconnect();\n      } catch {\n        // ignore\n      }\n    }\n    this.previewScheduledSources.clear();\n  }\n}\n"],"names":["blockEndUs","remainingToBoundaryUs"],"mappings":"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"}

package/dist/stages/compose/text-utils/caption-layout.d.ts

@@ -0,0 +1,59 @@
+import { GlobalPositionStyle } from '../font-system/types';
+
+export interface CaptionLayoutInput {
+    text: string;
+    canvasWidth: number;
+    canvasHeight: number;
+    localeCode?: string;
+    fontTemplate?: string;
+    fontFamily?: string;
+    wordTimings?: Array<{
+        text: string;
+        startUs: number;
+        endUs: number;
+    }>;
+    letterCase?: 'upper' | 'lower' | 'none';
+    animation?: {
+        type: string;
+        [key: string]: unknown;
+    };
+}
+export interface CaptionLayout {
+    lines: CaptionLine[];
+    style: CaptionStyle;
+    container: CaptionContainer;
+}
+export interface CaptionLine {
+    text: string;
+    lineIndex: number;
+    words: CaptionWord[];
+}
+export interface CaptionWord {
+    text: string;
+    wordIndex: number;
+    timing?: {
+        startUs: number;
+        endUs: number;
+    };
+}
+export interface CaptionStyle {
+    fontSize: number;
+    fontFamily: string;
+    fontWeight: string | number;
+    fill: string;
+    stroke?: string;
+    strokeWidth?: number;
+    lineHeight: number;
+    letterSpacing?: string | number;
+    paintOrder?: string;
+}
+export interface CaptionContainer {
+    maxWidth: number;
+    maxWidthPercent: number;
+    position: Pick<GlobalPositionStyle, 'top' | 'bottom' | 'alignItems' | 'justifyContent'>;
+    backgroundColor?: string;
+    padding?: string;
+    borderRadius?: number;
+}
+export declare function computeCaptionLayout(input: CaptionLayoutInput): CaptionLayout;
+//# sourceMappingURL=caption-layout.d.ts.map

package/dist/stages/compose/text-utils/caption-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caption-layout.d.ts","sourceRoot":"","sources":["../../../../src/stages/compose/text-utils/caption-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAQ5F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACxC,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACtD;AAID,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAC,CAAC;IACxF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAqFD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CA+D7E"}

package/dist/stages/compose/text-utils/caption-layout.js

@@ -0,0 +1,116 @@
+import { getFontConfig } from "../font-system/FontManager.js";
+import { formEvenLinesWithWords, wrapText } from "./text-wrapper.js";
+import { getLetterCaseText } from "./text-metrics.js";
+import { needsSpaceBetweenWords } from "./locale-detector.js";
+const DEFAULT_MAX_WIDTH_RATIO = 0.64;
+const KTV_MAX_WIDTH_RATIO = 0.9;
+const DEFAULT_FONT_TEMPLATE = "baseSubtitle";
+let sharedCtx = null;
+function getSharedCtx() {
+  if (!sharedCtx) {
+    const canvas = new OffscreenCanvas(1, 1);
+    sharedCtx = canvas.getContext("2d");
+  }
+  return sharedCtx;
+}
+function getMaxWidthRatio(animationType) {
+  return animationType === "characterKTV" ? KTV_MAX_WIDTH_RATIO : DEFAULT_MAX_WIDTH_RATIO;
+}
+function buildContainer(maxWidth, maxWidthPercent, globalPosition, containerStyle) {
+  return {
+    maxWidth,
+    maxWidthPercent,
+    position: {
+      top: globalPosition?.top,
+      bottom: globalPosition?.bottom,
+      alignItems: globalPosition?.alignItems,
+      justifyContent: globalPosition?.justifyContent
+    },
+    backgroundColor: containerStyle?.backgroundColor,
+    padding: containerStyle?.padding,
+    borderRadius: containerStyle?.borderRadius
+  };
+}
+function buildLinesWithWordMapping(lines, needsSpace, wordTimings) {
+  let globalWordIndex = 0;
+  return lines.map((lineText, lineIndex) => {
+    const lineWords = lineText.split(needsSpace ? /\s+/ : "").filter(Boolean);
+    const words = lineWords.map((wordText) => {
+      const timing = wordTimings?.[globalWordIndex];
+      const word = {
+        text: wordText,
+        wordIndex: globalWordIndex,
+        timing: timing ? { startUs: timing.startUs, endUs: timing.endUs } : void 0
+      };
+      globalWordIndex++;
+      return word;
+    });
+    return { text: lineText, lineIndex, words };
+  });
+}
+function buildLinesWithoutWordMapping(lines) {
+  return lines.map((lineText, lineIndex) => ({
+    text: lineText,
+    lineIndex,
+    words: [{ text: lineText, wordIndex: lineIndex }]
+  }));
+}
+function computeCaptionLayout(input) {
+  const {
+    text: rawText,
+    canvasWidth,
+    localeCode: inputLocale,
+    fontTemplate: inputTemplate,
+    fontFamily: inputFontFamily,
+    wordTimings,
+    letterCase,
+    animation
+  } = input;
+  const locale = inputLocale || "en-US";
+  const fontTemplate = inputTemplate || DEFAULT_FONT_TEMPLATE;
+  const fontConfig = getFontConfig(locale, fontTemplate, inputFontFamily);
+  const { textStyle, containerStyle, globalPosition } = fontConfig;
+  const text = getLetterCaseText(rawText, letterCase);
+  const hasWordTimings = wordTimings && wordTimings.length > 0;
+  const ratio = getMaxWidthRatio(animation?.type);
+  const maxWidth = canvasWidth * ratio;
+  const maxWidthPercent = ratio * 100;
+  const ctx = getSharedCtx();
+  const { fontSize, fontFamily, fontWeight } = textStyle;
+  let lines;
+  let captionLines;
+  if (hasWordTimings) {
+    const needsSpace = needsSpaceBetweenWords(locale, text);
+    const words = text.split(needsSpace ? /\s+/ : "");
+    lines = formEvenLinesWithWords(
+      ctx,
+      words,
+      maxWidth,
+      fontSize,
+      needsSpace,
+      fontFamily,
+      fontWeight
+    );
+    captionLines = buildLinesWithWordMapping(lines, needsSpace, wordTimings);
+  } else {
+    lines = wrapText(ctx, text, maxWidth, fontSize, fontFamily, fontWeight);
+    captionLines = buildLinesWithoutWordMapping(lines);
+  }
+  const style = {
+    fontSize,
+    fontFamily,
+    fontWeight,
+    fill: textStyle.fill,
+    stroke: textStyle.stroke,
+    strokeWidth: textStyle.strokeWidth,
+    lineHeight: textStyle.lineHeight || 1.2,
+    letterSpacing: textStyle.letterSpacing,
+    paintOrder: textStyle.paintOrder
+  };
+  const container = buildContainer(maxWidth, maxWidthPercent, globalPosition, containerStyle);
+  return { lines: captionLines, style, container };
+}
+export {
+  computeCaptionLayout
+};
+//# sourceMappingURL=caption-layout.js.map

package/dist/stages/compose/text-utils/caption-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"caption-layout.js","sources":["../../../../src/stages/compose/text-utils/caption-layout.ts"],"sourcesContent":["import type { LocaleCode, ContainerStyle, GlobalPositionStyle } from '../font-system/types';\nimport { getFontConfig } from '../font-system/FontManager';\nimport { wrapText, formEvenLinesWithWords } from './text-wrapper';\nimport { getLetterCaseText } from './text-metrics';\nimport { needsSpaceBetweenWords } from './locale-detector';\n\n// ────── Input ──────\n\nexport interface CaptionLayoutInput {\n  text: string;\n  canvasWidth: number;\n  canvasHeight: number;\n  localeCode?: string;\n  fontTemplate?: string;\n  fontFamily?: string;\n  wordTimings?: Array<{ text: string; startUs: number; endUs: number }>;\n  letterCase?: 'upper' | 'lower' | 'none';\n  animation?: { type: string; [key: string]: unknown };\n}\n\n// ────── Output ──────\n\nexport interface CaptionLayout {\n  lines: CaptionLine[];\n  style: CaptionStyle;\n  container: CaptionContainer;\n}\n\nexport interface CaptionLine {\n  text: string;\n  lineIndex: number;\n  words: CaptionWord[];\n}\n\nexport interface CaptionWord {\n  text: string;\n  wordIndex: number;\n  timing?: { startUs: number; endUs: number };\n}\n\nexport interface CaptionStyle {\n  fontSize: number;\n  fontFamily: string;\n  fontWeight: string | number;\n  fill: string;\n  stroke?: string;\n  strokeWidth?: number;\n  lineHeight: number;\n  letterSpacing?: string | number;\n  paintOrder?: string;\n}\n\nexport interface CaptionContainer {\n  maxWidth: number;\n  maxWidthPercent: number;\n  position: Pick<GlobalPositionStyle, 'top' | 'bottom' | 'alignItems' | 'justifyContent'>;\n  backgroundColor?: string;\n  padding?: string;\n  borderRadius?: number;\n}\n\n// ────── Constants ──────\n\nconst DEFAULT_MAX_WIDTH_RATIO = 0.64;\nconst KTV_MAX_WIDTH_RATIO = 0.9;\nconst DEFAULT_FONT_TEMPLATE = 'baseSubtitle';\n\n// ────── Implementation ──────\n\nlet sharedCtx: OffscreenCanvasRenderingContext2D | null = null;\n\nfunction getSharedCtx(): OffscreenCanvasRenderingContext2D {\n  if (!sharedCtx) {\n    const canvas = new OffscreenCanvas(1, 1);\n    sharedCtx = canvas.getContext('2d')!;\n  }\n  return sharedCtx;\n}\n\nfunction getMaxWidthRatio(animationType?: string): number {\n  return animationType === 'characterKTV' ? KTV_MAX_WIDTH_RATIO : DEFAULT_MAX_WIDTH_RATIO;\n}\n\nfunction buildContainer(\n  maxWidth: number,\n  maxWidthPercent: number,\n  globalPosition?: Partial<GlobalPositionStyle>,\n  containerStyle?: Partial<ContainerStyle>\n): CaptionContainer {\n  return {\n    maxWidth,\n    maxWidthPercent,\n    position: {\n      top: globalPosition?.top,\n      bottom: globalPosition?.bottom,\n      alignItems: globalPosition?.alignItems,\n      justifyContent: globalPosition?.justifyContent,\n    },\n    backgroundColor: containerStyle?.backgroundColor,\n    padding: containerStyle?.padding,\n    borderRadius: containerStyle?.borderRadius,\n  };\n}\n\n/**\n * Build CaptionLine[] with word-to-line mapping from lines produced by\n * formEvenLinesWithWords (wordTimings path).\n */\nfunction buildLinesWithWordMapping(\n  lines: string[],\n  needsSpace: boolean,\n  wordTimings?: CaptionLayoutInput['wordTimings']\n): CaptionLine[] {\n  let globalWordIndex = 0;\n\n  return lines.map((lineText, lineIndex) => {\n    const lineWords = lineText.split(needsSpace ? /\\s+/ : '').filter(Boolean);\n    const words: CaptionWord[] = lineWords.map((wordText) => {\n      const timing = wordTimings?.[globalWordIndex];\n      const word: CaptionWord = {\n        text: wordText,\n        wordIndex: globalWordIndex,\n        timing: timing ? { startUs: timing.startUs, endUs: timing.endUs } : undefined,\n      };\n      globalWordIndex++;\n      return word;\n    });\n\n    return { text: lineText, lineIndex, words };\n  });\n}\n\n/**\n * Build CaptionLine[] from lines produced by wrapText (no wordTimings).\n * Each line gets a single word entry covering the entire line text.\n */\nfunction buildLinesWithoutWordMapping(lines: string[]): CaptionLine[] {\n  return lines.map((lineText, lineIndex) => ({\n    text: lineText,\n    lineIndex,\n    words: [{ text: lineText, wordIndex: lineIndex }],\n  }));\n}\n\nexport function computeCaptionLayout(input: CaptionLayoutInput): CaptionLayout {\n  const {\n    text: rawText,\n    canvasWidth,\n    localeCode: inputLocale,\n    fontTemplate: inputTemplate,\n    fontFamily: inputFontFamily,\n    wordTimings,\n    letterCase,\n    animation,\n  } = input;\n\n  const locale = (inputLocale || 'en-US') as LocaleCode;\n  const fontTemplate = inputTemplate || DEFAULT_FONT_TEMPLATE;\n  const fontConfig = getFontConfig(locale, fontTemplate, inputFontFamily);\n  const { textStyle, containerStyle, globalPosition } = fontConfig;\n\n  const text = getLetterCaseText(rawText, letterCase);\n  const hasWordTimings = wordTimings && wordTimings.length > 0;\n\n  const ratio = getMaxWidthRatio(animation?.type);\n  const maxWidth = canvasWidth * ratio;\n  const maxWidthPercent = ratio * 100;\n\n  const ctx = getSharedCtx();\n  const { fontSize, fontFamily, fontWeight } = textStyle;\n\n  let lines: string[];\n  let captionLines: CaptionLine[];\n\n  if (hasWordTimings) {\n    const needsSpace = needsSpaceBetweenWords(locale, text);\n    const words = text.split(needsSpace ? /\\s+/ : '');\n    lines = formEvenLinesWithWords(\n      ctx,\n      words,\n      maxWidth,\n      fontSize,\n      needsSpace,\n      fontFamily,\n      fontWeight\n    );\n    captionLines = buildLinesWithWordMapping(lines, needsSpace, wordTimings);\n  } else {\n    lines = wrapText(ctx, text, maxWidth, fontSize, fontFamily, fontWeight);\n    captionLines = buildLinesWithoutWordMapping(lines);\n  }\n\n  const style: CaptionStyle = {\n    fontSize,\n    fontFamily,\n    fontWeight,\n    fill: textStyle.fill,\n    stroke: textStyle.stroke,\n    strokeWidth: textStyle.strokeWidth,\n    lineHeight: textStyle.lineHeight || 1.2,\n    letterSpacing: textStyle.letterSpacing,\n    paintOrder: textStyle.paintOrder,\n  };\n\n  const container = buildContainer(maxWidth, maxWidthPercent, globalPosition, containerStyle);\n\n  return { lines: captionLines, style, container };\n}\n"],"names":[],"mappings":"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"}

package/dist/stages/compose/text-utils/index.d.ts

@@ -1,4 +1,5 @@
 export * from './locale-detector';
 export * from './text-wrapper';
 export * from './text-metrics';
+export * from './caption-layout';
 //# sourceMappingURL=index.d.ts.map

package/dist/stages/compose/text-utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/stages/compose/text-utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/stages/compose/text-utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meframe/core",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "description": "Next generation media processing framework based on WebCodecs",
   "type": "module",
   "main": "./dist/index.js",