@meframe/core 0.5.5 → 0.5.6

package/dist/stages/compose/VideoComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoComposer.d.ts","sourceRoot":"","sources":["../../../src/stages/compose/VideoComposer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AAIjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAiBpD;;GAEG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,gBAAgB,CAAC,GAAG;QACtE,cAAc,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAAC;KACtD,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAErD,OAAO,CAAC,GAAG,CAA+D;IAC1E,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,mBAAmB,CAA8B;IACzD,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAU;gBAE1C,MAAM,EAAE,kBAAkB;IAiDtC,OAAO,CAAC,aAAa;IA8BrB,aAAa,CAAC,YAAY,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAAC,cAAc,EAAE,UAAU,CAAC;IA8BvF,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwF7D,iBAAiB,CACrB,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAWzB,OAAO,CAAC,WAAW;YAaL,iBAAiB;YAUjB,SAAS;YA6BT,WAAW;IAoCzB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAuBvD,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"VideoComposer.d.ts","sourceRoot":"","sources":["../../../src/stages/compose/VideoComposer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AAIjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAkBpD;;GAEG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,gBAAgB,CAAC,GAAG;QACtE,cAAc,CAAC,EAAE,iBAAiB,GAAG,eAAe,CAAC;KACtD,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAAC;IAErD,OAAO,CAAC,GAAG,CAA+D;IAC1E,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,mBAAmB,CAA8B;IACzD,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAU;gBAE1C,MAAM,EAAE,kBAAkB;IAiDtC,OAAO,CAAC,aAAa;IA8BrB,aAAa,CAAC,YAAY,CAAC,EAAE,kBAAkB,GAAG,eAAe,CAAC,cAAc,EAAE,UAAU,CAAC;IA+BvF,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAwF7D,iBAAiB,CACrB,WAAW,EAAE,cAAc,EAC3B,SAAS,EAAE,cAAc,EACzB,UAAU,EAAE,gBAAgB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAWzB,OAAO,CAAC,WAAW;YAaL,iBAAiB;YAUjB,SAAS;YA6BT,WAAW;IAoCzB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAuBvD,OAAO,IAAI,IAAI;CAGhB"}

package/dist/stages/compose/VideoComposer.js

@@ -1,6 +1,7 @@
 import { LayerRenderer } from "./LayerRenderer.js";
 import { TransitionProcessor } from "./TransitionProcessor.js";
 import { FilterProcessor } from "./FilterProcessor.js";
+import { clearCaptionStaggerCache } from "./text-renderers/caption-stagger-entrance-renderer.js";
 import { clearTextLayoutCache } from "./text-utils/text-layout-cache.js";
 const closeLayerFrame = (layer) => {
   if (layer.type === "video") {
@@ -100,6 +101,7 @@ class VideoComposer {
         flush: async () => {
           this.filterProcessor.clearCache();
           clearTextLayoutCache();
+          clearCaptionStaggerCache();
         }
       },
       {

package/dist/stages/compose/VideoComposer.js.map

@@ -1 +1 @@
-{"version":3,"file":"VideoComposer.js","sources":["../../../src/stages/compose/VideoComposer.ts"],"sourcesContent":["import type {\n  VideoComposeConfig,\n  ComposeRequest,\n  ComposeResult,\n  TransitionEffect,\n  VideoLayer,\n  Layer,\n} from './types';\nimport { LayerRenderer } from './LayerRenderer';\nimport { TransitionProcessor } from './TransitionProcessor';\nimport { FilterProcessor } from './FilterProcessor';\nimport { ClipInstructionSet } from './instructions';\nimport { clearTextLayoutCache } from './text-utils/text-layout-cache';\n\nconst closeLayerFrame = (layer: Layer) => {\n  if (layer.type === 'video') {\n    const videoLayer = layer as VideoLayer;\n    // Only close videoFrame if layer doesn't use RcFrame wrapper\n    // RcFrame-wrapped frames are managed by CacheManager lifecycle\n    if (!videoLayer.rcFrame) {\n      const vf = videoLayer.videoFrame;\n      if (vf?.close) {\n        vf.close();\n      }\n    }\n  }\n};\n\n/**\n * VideoComposer - Main visual composition orchestrator\n */\nexport class VideoComposer {\n  readonly config: Omit<Required<VideoComposeConfig>, 'externalCanvas'> & {\n    externalCanvas?: HTMLCanvasElement | OffscreenCanvas;\n  };\n  readonly canvas: OffscreenCanvas | HTMLCanvasElement;\n\n  private ctx: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D;\n  private layerRenderer: LayerRenderer;\n  private transitionProcessor: TransitionProcessor;\n  private filterProcessor: FilterProcessor;\n  private frameDurationUs: number; // Cached frame duration\n  private fontsLoadingPromise: Promise<void> | null = null;\n  private loadedFonts = new Set<string>();\n  private static readonly FONT_LOAD_TIMEOUT_MS = 10_000;\n\n  constructor(config: VideoComposeConfig) {\n    this.config = this.applyDefaults(config);\n    this.frameDurationUs = Math.round(1_000_000 / this.config.fps); // Pre-calculate\n\n    if (config.externalCanvas) {\n      this.canvas = config.externalCanvas;\n\n      // FIX: Ensure external canvas dimensions match the config\n      if (this.canvas.width !== this.config.width || this.canvas.height !== this.config.height) {\n        this.canvas.width = this.config.width;\n        this.canvas.height = this.config.height;\n      }\n\n      this.ctx = this.canvas.getContext('2d', {\n        alpha: true,\n        desynchronized: true,\n        willReadFrequently: false,\n        colorSpace: 'srgb',\n      }) as CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;\n    } else {\n      this.canvas = new OffscreenCanvas(this.config.width, this.config.height);\n      this.ctx = this.canvas.getContext('2d', {\n        alpha: true,\n        desynchronized: true,\n        willReadFrequently: false,\n        colorSpace: 'srgb',\n      }) as OffscreenCanvasRenderingContext2D;\n    }\n\n    if (!this.ctx) {\n      throw new Error('Failed to create 2D rendering context');\n    }\n\n    this.ctx.imageSmoothingEnabled = this.config.enableSmoothing;\n\n    // Start loading fonts but don't block constructor\n    this.fontsLoadingPromise = this.loadFonts();\n    this.ctx.imageSmoothingQuality = 'high';\n\n    this.layerRenderer = new LayerRenderer(\n      this.ctx,\n      this.config.width,\n      this.config.height,\n      this.config.fps\n    );\n    this.transitionProcessor = new TransitionProcessor(this.config.width, this.config.height);\n    this.filterProcessor = new FilterProcessor();\n  }\n\n  private applyDefaults(config: VideoComposeConfig): Omit<\n    Required<VideoComposeConfig>,\n    'externalCanvas'\n  > & {\n    externalCanvas?: HTMLCanvasElement | OffscreenCanvas;\n  } {\n    return {\n      width: config.width || 720,\n      height: config.height || 1280,\n      fps: config.fps || 30,\n      backgroundColor: config.backgroundColor ?? '#000',\n      renderer: config.renderer ?? 'canvas2d',\n      enableSmoothing: config.enableSmoothing ?? true,\n      enableHardwareAcceleration: config.enableHardwareAcceleration ?? true,\n      revision: config.revision ?? 0,\n      inputHighWaterMark: config.inputHighWaterMark ?? 3,\n      outputHighWaterMark: config.outputHighWaterMark ?? 1,\n      maxLayers: config.maxLayers ?? 100,\n      timeline: config.timeline ?? {\n        clipId: 'default',\n        trackId: 'main',\n        clipStartUs: 0,\n        clipDurationUs: Infinity,\n        compositionFps: 30,\n      },\n      fonts: config.fonts ?? [],\n      externalCanvas: config.externalCanvas,\n    };\n  }\n\n  createStreams(_instruction?: ClipInstructionSet): TransformStream<ComposeRequest, VideoFrame> {\n    // Always create new streams for each clip\n    // ReadableStreams can only be consumed once\n    const stream = new TransformStream<ComposeRequest, VideoFrame>(\n      {\n        transform: async (request, controller) => {\n          // console.log('[VideoComposer] transform', request, controller.desiredSize);\n          const result = await this.composeFrame(request);\n          if (result.frame) {\n            controller.enqueue(result.frame);\n          }\n          // setTimeout(() => {\n          //   result.frame.close();\n          // }, 1000);\n        },\n\n        flush: async () => {\n          this.filterProcessor.clearCache();\n          clearTextLayoutCache();\n        },\n      },\n      {\n        highWaterMark: this.config.inputHighWaterMark,\n      },\n      {\n        highWaterMark: this.config.outputHighWaterMark,\n      }\n    );\n    return stream;\n  }\n  async composeFrame(request: ComposeRequest): Promise<ComposeResult> {\n    // Ensure fonts are loaded before rendering\n    if (this.fontsLoadingPromise) {\n      // Font loading can hang indefinitely in some environments (e.g. headless + cross-origin).\n      // Cap the wait time to keep export progress moving; fall back to system fonts on timeout.\n      try {\n        await this.withTimeout(this.fontsLoadingPromise, VideoComposer.FONT_LOAD_TIMEOUT_MS);\n      } catch {\n        // ignore - fallback to system fonts\n      }\n      this.fontsLoadingPromise = null; // Only wait once\n    }\n\n    if (request.layers.length > this.config.maxLayers) {\n      throw new Error(`Too many layers: ${request.layers.length} > ${this.config.maxLayers}`);\n    }\n\n    this.clearCanvas();\n\n    // Calculate current frame number for animations (relative to clip start)\n    const frameDurationUs = 1_000_000 / this.config.fps;\n    const relativeFrame = Math.floor(request.timeUs / frameDurationUs);\n    this.layerRenderer.setCurrentFrame(relativeFrame);\n\n    if (request.transition) {\n      this.ctx.save();\n      this.transitionProcessor.applyTransition(this.ctx, request.transition);\n    }\n\n    for (const layer of request.layers) {\n      if (!layer.visible || layer.opacity <= 0) {\n        // Close video frame for invisible layers\n        closeLayerFrame(layer);\n        continue;\n      }\n\n      try {\n        // If layer has RcFrame, use it within the rendering scope\n        const videoLayer = layer as VideoLayer;\n        if (videoLayer.rcFrame) {\n          videoLayer.rcFrame.use((frame: VideoFrame) => {\n            // Set the frame reference (direct access, no clone for performance)\n            videoLayer.videoFrame = frame;\n\n            if (layer.filters && layer.filters.length > 0) {\n              this.ctx.save();\n              this.filterProcessor.applyFilters(this.ctx, layer.filters);\n            }\n            this.layerRenderer.renderLayer(layer);\n\n            if (layer.filters && layer.filters.length > 0) {\n              this.ctx.restore();\n            }\n          });\n        } else {\n          // Regular layer without RcFrame\n          if (layer.filters && layer.filters.length > 0) {\n            this.ctx.save();\n            this.filterProcessor.applyFilters(this.ctx, layer.filters);\n          }\n          this.layerRenderer.renderLayer(layer);\n\n          if (layer.filters && layer.filters.length > 0) {\n            this.ctx.restore();\n          }\n        }\n      } catch (error) {\n        console.error('[VideoComposer] composeFrame error: ', error);\n      } finally {\n        closeLayerFrame(layer);\n      }\n    }\n\n    if (request.transition) {\n      this.ctx.restore();\n    }\n\n    let frame: VideoFrame | null = null;\n    if (!this.config.externalCanvas) {\n      frame = await this.createOutputFrame(request.timeUs);\n    }\n\n    return {\n      frame,\n      timeUs: request.timeUs,\n    };\n  }\n\n  async composeTransition(\n    fromRequest: ComposeRequest,\n    toRequest: ComposeRequest,\n    transition: TransitionEffect\n  ): Promise<ComposeResult> {\n    await this.composeFrame(fromRequest);\n\n    const toFrameRequest = {\n      ...toRequest,\n      transition,\n    };\n\n    return this.composeFrame(toFrameRequest);\n  }\n\n  private clearCanvas(): void {\n    if (this.config.backgroundColor) {\n      this.ctx.fillStyle = this.config.backgroundColor;\n      this.ctx.fillRect(0, 0, this.config.width, this.config.height);\n    } else {\n      this.ctx.clearRect(0, 0, this.config.width, this.config.height);\n    }\n  }\n\n  // private sortLayers(layers: Layer[]): Layer[] {\n  //   return [...layers].sort((a, b) => a.zIndex - b.zIndex);\n  // }\n\n  private async createOutputFrame(timeUs: number): Promise<VideoFrame> {\n    const frame = new VideoFrame(this.canvas, {\n      timestamp: timeUs,\n      duration: this.frameDurationUs, // Use cached duration\n      alpha: 'discard',\n      visibleRect: { x: 0, y: 0, width: this.canvas.width, height: this.canvas.height },\n    });\n    return frame;\n  }\n\n  private async loadFonts(): Promise<void> {\n    if (!this.config.fonts || this.config.fonts.length === 0) {\n      return;\n    }\n\n    for (const font of this.config.fonts) {\n      if (this.loadedFonts.has(font.family)) {\n        continue;\n      }\n\n      try {\n        const fontFace = new FontFace(font.family, `url(${font.url})`);\n        // Prevent hung FontFace.load() from blocking the entire pipeline forever.\n        const loadedFont = await this.withTimeout(\n          fontFace.load(),\n          VideoComposer.FONT_LOAD_TIMEOUT_MS\n        );\n\n        if ('fonts' in self) {\n          self.fonts.add(loadedFont);\n        }\n\n        this.loadedFonts.add(font.family);\n      } catch {\n        // Font loading failed, will fallback to system fonts\n      }\n    }\n  }\n\n  private async withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T> {\n    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n      return promise;\n    }\n\n    let timeoutId: ReturnType<typeof setTimeout> | null = null;\n    try {\n      // Ensure the original promise never becomes an unhandled rejection if we time out.\n      const safe = promise.then(\n        (value) => ({ ok: true as const, value }),\n        (error) => ({ ok: false as const, error })\n      );\n\n      const result = await Promise.race([\n        safe,\n        new Promise<T>((_, reject) => {\n          timeoutId = setTimeout(\n            () => reject(new Error(`Timeout after ${timeoutMs}ms`)),\n            timeoutMs\n          );\n        }),\n      ]);\n      if ((result as any)?.ok === true) {\n        return (result as any).value as T;\n      }\n      if ((result as any)?.ok === false) {\n        throw (result as any).error;\n      }\n      return result as T;\n    } finally {\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n      }\n    }\n  }\n\n  updateConfig(config: Partial<VideoComposeConfig>): void {\n    Object.assign(this.config, this.applyDefaults({ ...this.config, ...config }));\n\n    if (config.fps !== undefined) {\n      this.frameDurationUs = Math.round(1_000_000 / this.config.fps); // Update cached duration\n    }\n\n    if (config.width || config.height) {\n      this.canvas.width = this.config.width;\n      this.canvas.height = this.config.height;\n      this.layerRenderer.updateDimensions(this.config.width, this.config.height);\n      this.transitionProcessor.updateDimensions(this.config.width, this.config.height);\n    }\n\n    if (config.enableSmoothing !== undefined) {\n      this.ctx.imageSmoothingEnabled = this.config.enableSmoothing;\n    }\n\n    if (config.fonts) {\n      this.fontsLoadingPromise = this.loadFonts();\n    }\n  }\n\n  dispose(): void {\n    this.filterProcessor.clearCache();\n  }\n}\n"],"names":["frame"],"mappings":"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"}
+{"version":3,"file":"VideoComposer.js","sources":["../../../src/stages/compose/VideoComposer.ts"],"sourcesContent":["import type {\n  VideoComposeConfig,\n  ComposeRequest,\n  ComposeResult,\n  TransitionEffect,\n  VideoLayer,\n  Layer,\n} from './types';\nimport { LayerRenderer } from './LayerRenderer';\nimport { TransitionProcessor } from './TransitionProcessor';\nimport { FilterProcessor } from './FilterProcessor';\nimport { ClipInstructionSet } from './instructions';\nimport { clearCaptionStaggerCache } from './text-renderers/caption-stagger-entrance-renderer';\nimport { clearTextLayoutCache } from './text-utils/text-layout-cache';\n\nconst closeLayerFrame = (layer: Layer) => {\n  if (layer.type === 'video') {\n    const videoLayer = layer as VideoLayer;\n    // Only close videoFrame if layer doesn't use RcFrame wrapper\n    // RcFrame-wrapped frames are managed by CacheManager lifecycle\n    if (!videoLayer.rcFrame) {\n      const vf = videoLayer.videoFrame;\n      if (vf?.close) {\n        vf.close();\n      }\n    }\n  }\n};\n\n/**\n * VideoComposer - Main visual composition orchestrator\n */\nexport class VideoComposer {\n  readonly config: Omit<Required<VideoComposeConfig>, 'externalCanvas'> & {\n    externalCanvas?: HTMLCanvasElement | OffscreenCanvas;\n  };\n  readonly canvas: OffscreenCanvas | HTMLCanvasElement;\n\n  private ctx: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D;\n  private layerRenderer: LayerRenderer;\n  private transitionProcessor: TransitionProcessor;\n  private filterProcessor: FilterProcessor;\n  private frameDurationUs: number; // Cached frame duration\n  private fontsLoadingPromise: Promise<void> | null = null;\n  private loadedFonts = new Set<string>();\n  private static readonly FONT_LOAD_TIMEOUT_MS = 10_000;\n\n  constructor(config: VideoComposeConfig) {\n    this.config = this.applyDefaults(config);\n    this.frameDurationUs = Math.round(1_000_000 / this.config.fps); // Pre-calculate\n\n    if (config.externalCanvas) {\n      this.canvas = config.externalCanvas;\n\n      // FIX: Ensure external canvas dimensions match the config\n      if (this.canvas.width !== this.config.width || this.canvas.height !== this.config.height) {\n        this.canvas.width = this.config.width;\n        this.canvas.height = this.config.height;\n      }\n\n      this.ctx = this.canvas.getContext('2d', {\n        alpha: true,\n        desynchronized: true,\n        willReadFrequently: false,\n        colorSpace: 'srgb',\n      }) as CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;\n    } else {\n      this.canvas = new OffscreenCanvas(this.config.width, this.config.height);\n      this.ctx = this.canvas.getContext('2d', {\n        alpha: true,\n        desynchronized: true,\n        willReadFrequently: false,\n        colorSpace: 'srgb',\n      }) as OffscreenCanvasRenderingContext2D;\n    }\n\n    if (!this.ctx) {\n      throw new Error('Failed to create 2D rendering context');\n    }\n\n    this.ctx.imageSmoothingEnabled = this.config.enableSmoothing;\n\n    // Start loading fonts but don't block constructor\n    this.fontsLoadingPromise = this.loadFonts();\n    this.ctx.imageSmoothingQuality = 'high';\n\n    this.layerRenderer = new LayerRenderer(\n      this.ctx,\n      this.config.width,\n      this.config.height,\n      this.config.fps\n    );\n    this.transitionProcessor = new TransitionProcessor(this.config.width, this.config.height);\n    this.filterProcessor = new FilterProcessor();\n  }\n\n  private applyDefaults(config: VideoComposeConfig): Omit<\n    Required<VideoComposeConfig>,\n    'externalCanvas'\n  > & {\n    externalCanvas?: HTMLCanvasElement | OffscreenCanvas;\n  } {\n    return {\n      width: config.width || 720,\n      height: config.height || 1280,\n      fps: config.fps || 30,\n      backgroundColor: config.backgroundColor ?? '#000',\n      renderer: config.renderer ?? 'canvas2d',\n      enableSmoothing: config.enableSmoothing ?? true,\n      enableHardwareAcceleration: config.enableHardwareAcceleration ?? true,\n      revision: config.revision ?? 0,\n      inputHighWaterMark: config.inputHighWaterMark ?? 3,\n      outputHighWaterMark: config.outputHighWaterMark ?? 1,\n      maxLayers: config.maxLayers ?? 100,\n      timeline: config.timeline ?? {\n        clipId: 'default',\n        trackId: 'main',\n        clipStartUs: 0,\n        clipDurationUs: Infinity,\n        compositionFps: 30,\n      },\n      fonts: config.fonts ?? [],\n      externalCanvas: config.externalCanvas,\n    };\n  }\n\n  createStreams(_instruction?: ClipInstructionSet): TransformStream<ComposeRequest, VideoFrame> {\n    // Always create new streams for each clip\n    // ReadableStreams can only be consumed once\n    const stream = new TransformStream<ComposeRequest, VideoFrame>(\n      {\n        transform: async (request, controller) => {\n          // console.log('[VideoComposer] transform', request, controller.desiredSize);\n          const result = await this.composeFrame(request);\n          if (result.frame) {\n            controller.enqueue(result.frame);\n          }\n          // setTimeout(() => {\n          //   result.frame.close();\n          // }, 1000);\n        },\n\n        flush: async () => {\n          this.filterProcessor.clearCache();\n          clearTextLayoutCache();\n          clearCaptionStaggerCache();\n        },\n      },\n      {\n        highWaterMark: this.config.inputHighWaterMark,\n      },\n      {\n        highWaterMark: this.config.outputHighWaterMark,\n      }\n    );\n    return stream;\n  }\n  async composeFrame(request: ComposeRequest): Promise<ComposeResult> {\n    // Ensure fonts are loaded before rendering\n    if (this.fontsLoadingPromise) {\n      // Font loading can hang indefinitely in some environments (e.g. headless + cross-origin).\n      // Cap the wait time to keep export progress moving; fall back to system fonts on timeout.\n      try {\n        await this.withTimeout(this.fontsLoadingPromise, VideoComposer.FONT_LOAD_TIMEOUT_MS);\n      } catch {\n        // ignore - fallback to system fonts\n      }\n      this.fontsLoadingPromise = null; // Only wait once\n    }\n\n    if (request.layers.length > this.config.maxLayers) {\n      throw new Error(`Too many layers: ${request.layers.length} > ${this.config.maxLayers}`);\n    }\n\n    this.clearCanvas();\n\n    // Calculate current frame number for animations (relative to clip start)\n    const frameDurationUs = 1_000_000 / this.config.fps;\n    const relativeFrame = Math.floor(request.timeUs / frameDurationUs);\n    this.layerRenderer.setCurrentFrame(relativeFrame);\n\n    if (request.transition) {\n      this.ctx.save();\n      this.transitionProcessor.applyTransition(this.ctx, request.transition);\n    }\n\n    for (const layer of request.layers) {\n      if (!layer.visible || layer.opacity <= 0) {\n        // Close video frame for invisible layers\n        closeLayerFrame(layer);\n        continue;\n      }\n\n      try {\n        // If layer has RcFrame, use it within the rendering scope\n        const videoLayer = layer as VideoLayer;\n        if (videoLayer.rcFrame) {\n          videoLayer.rcFrame.use((frame: VideoFrame) => {\n            // Set the frame reference (direct access, no clone for performance)\n            videoLayer.videoFrame = frame;\n\n            if (layer.filters && layer.filters.length > 0) {\n              this.ctx.save();\n              this.filterProcessor.applyFilters(this.ctx, layer.filters);\n            }\n            this.layerRenderer.renderLayer(layer);\n\n            if (layer.filters && layer.filters.length > 0) {\n              this.ctx.restore();\n            }\n          });\n        } else {\n          // Regular layer without RcFrame\n          if (layer.filters && layer.filters.length > 0) {\n            this.ctx.save();\n            this.filterProcessor.applyFilters(this.ctx, layer.filters);\n          }\n          this.layerRenderer.renderLayer(layer);\n\n          if (layer.filters && layer.filters.length > 0) {\n            this.ctx.restore();\n          }\n        }\n      } catch (error) {\n        console.error('[VideoComposer] composeFrame error: ', error);\n      } finally {\n        closeLayerFrame(layer);\n      }\n    }\n\n    if (request.transition) {\n      this.ctx.restore();\n    }\n\n    let frame: VideoFrame | null = null;\n    if (!this.config.externalCanvas) {\n      frame = await this.createOutputFrame(request.timeUs);\n    }\n\n    return {\n      frame,\n      timeUs: request.timeUs,\n    };\n  }\n\n  async composeTransition(\n    fromRequest: ComposeRequest,\n    toRequest: ComposeRequest,\n    transition: TransitionEffect\n  ): Promise<ComposeResult> {\n    await this.composeFrame(fromRequest);\n\n    const toFrameRequest = {\n      ...toRequest,\n      transition,\n    };\n\n    return this.composeFrame(toFrameRequest);\n  }\n\n  private clearCanvas(): void {\n    if (this.config.backgroundColor) {\n      this.ctx.fillStyle = this.config.backgroundColor;\n      this.ctx.fillRect(0, 0, this.config.width, this.config.height);\n    } else {\n      this.ctx.clearRect(0, 0, this.config.width, this.config.height);\n    }\n  }\n\n  // private sortLayers(layers: Layer[]): Layer[] {\n  //   return [...layers].sort((a, b) => a.zIndex - b.zIndex);\n  // }\n\n  private async createOutputFrame(timeUs: number): Promise<VideoFrame> {\n    const frame = new VideoFrame(this.canvas, {\n      timestamp: timeUs,\n      duration: this.frameDurationUs, // Use cached duration\n      alpha: 'discard',\n      visibleRect: { x: 0, y: 0, width: this.canvas.width, height: this.canvas.height },\n    });\n    return frame;\n  }\n\n  private async loadFonts(): Promise<void> {\n    if (!this.config.fonts || this.config.fonts.length === 0) {\n      return;\n    }\n\n    for (const font of this.config.fonts) {\n      if (this.loadedFonts.has(font.family)) {\n        continue;\n      }\n\n      try {\n        const fontFace = new FontFace(font.family, `url(${font.url})`);\n        // Prevent hung FontFace.load() from blocking the entire pipeline forever.\n        const loadedFont = await this.withTimeout(\n          fontFace.load(),\n          VideoComposer.FONT_LOAD_TIMEOUT_MS\n        );\n\n        if ('fonts' in self) {\n          self.fonts.add(loadedFont);\n        }\n\n        this.loadedFonts.add(font.family);\n      } catch {\n        // Font loading failed, will fallback to system fonts\n      }\n    }\n  }\n\n  private async withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T> {\n    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {\n      return promise;\n    }\n\n    let timeoutId: ReturnType<typeof setTimeout> | null = null;\n    try {\n      // Ensure the original promise never becomes an unhandled rejection if we time out.\n      const safe = promise.then(\n        (value) => ({ ok: true as const, value }),\n        (error) => ({ ok: false as const, error })\n      );\n\n      const result = await Promise.race([\n        safe,\n        new Promise<T>((_, reject) => {\n          timeoutId = setTimeout(\n            () => reject(new Error(`Timeout after ${timeoutMs}ms`)),\n            timeoutMs\n          );\n        }),\n      ]);\n      if ((result as any)?.ok === true) {\n        return (result as any).value as T;\n      }\n      if ((result as any)?.ok === false) {\n        throw (result as any).error;\n      }\n      return result as T;\n    } finally {\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n      }\n    }\n  }\n\n  updateConfig(config: Partial<VideoComposeConfig>): void {\n    Object.assign(this.config, this.applyDefaults({ ...this.config, ...config }));\n\n    if (config.fps !== undefined) {\n      this.frameDurationUs = Math.round(1_000_000 / this.config.fps); // Update cached duration\n    }\n\n    if (config.width || config.height) {\n      this.canvas.width = this.config.width;\n      this.canvas.height = this.config.height;\n      this.layerRenderer.updateDimensions(this.config.width, this.config.height);\n      this.transitionProcessor.updateDimensions(this.config.width, this.config.height);\n    }\n\n    if (config.enableSmoothing !== undefined) {\n      this.ctx.imageSmoothingEnabled = this.config.enableSmoothing;\n    }\n\n    if (config.fonts) {\n      this.fontsLoadingPromise = this.loadFonts();\n    }\n  }\n\n  dispose(): void {\n    this.filterProcessor.clearCache();\n  }\n}\n"],"names":["frame"],"mappings":"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"}

package/dist/stages/compose/text-renderers/caption-stagger-entrance-renderer.d.ts

@@ -2,6 +2,8 @@ import { TextLayer } from '../types';
 
 export declare function charProgress(relativeFrame: number, fps: number, charIndex: number, staggerMs: number, durationMs: number): number;
 export type CaptionStaggerPreset = 'fade' | 'slideUp' | 'scale' | 'rotateScale' | 'blur' | 'flip3d' | 'typewriter' | 'letterSpread';
+export declare function staggerEntranceEndMs(slotCount: number, preset: CaptionStaggerPreset): number;
+export declare function clearCaptionStaggerCache(): void;
 /**
  * Per-character stagger entrance aligned with medeo-web preview (anime.js easeOutExpo, 800ms, 50ms stagger).
  */

package/dist/stages/compose/text-renderers/caption-stagger-entrance-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"caption-stagger-entrance-renderer.d.ts","sourceRoot":"","sources":["../../../../src/stages/compose/text-renderers/caption-stagger-entrance-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAkD1C,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAMR;AAED,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,SAAS,GACT,OAAO,GACP,aAAa,GACb,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,cAAc,CAAC;AA0EnB;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,iCAAiC,GAAG,wBAAwB,EACjE,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CA6GN"}
+{"version":3,"file":"caption-stagger-entrance-renderer.d.ts","sourceRoot":"","sources":["../../../../src/stages/compose/text-renderers/caption-stagger-entrance-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAkD1C,wBAAgB,YAAY,CAC1B,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAMR;AAED,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,SAAS,GACT,OAAO,GACP,aAAa,GACb,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,cAAc,CAAC;AA2CnB,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAO5F;AAwMD,wBAAgB,wBAAwB,IAAI,IAAI,CAM/C;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,iCAAiC,GAAG,wBAAwB,EACjE,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,oBAAoB,GAC3B,IAAI,CA0BN"}

package/dist/stages/compose/text-renderers/caption-stagger-entrance-renderer.js

@@ -1,4 +1,4 @@
-import { formEvenLinesWithWords, wrapText } from "../text-utils/text-wrapper.js";
+import { getCachedEvenLinesWithWords, getCachedWrapText } from "../text-utils/text-layout-cache.js";
 import { getLetterCaseText, measureTextWidth } from "../text-utils/text-metrics.js";
 import { needsSpaceBetweenWords } from "../text-utils/locale-detector.js";
 const DEFAULT_DURATION_MS = 800;
@@ -36,6 +36,34 @@ function charProgress(relativeFrame, fps, charIndex, staggerMs, durationMs) {
   const raw = (tMs - startMs) / durationMs;
   return easeOutExpo(Math.min(1, raw));
 }
+const charSlotsCache = /* @__PURE__ */ new Map();
+const staggerFinalRasterCache = /* @__PURE__ */ new Map();
+function layoutCacheKey(layer, canvasWidth, canvasHeight) {
+  const ts = layer.fontConfig?.textStyle;
+  return [
+    layer.id,
+    layer.text,
+    layer.letterCase ?? "",
+    canvasWidth,
+    canvasHeight,
+    ts?.fontSize,
+    ts?.fontFamily,
+    ts?.fontWeight,
+    ts?.lineHeight,
+    JSON.stringify(layer.fontConfig?.globalPosition ?? null)
+  ].join("");
+}
+function staggerRasterKey(layer, canvasWidth, canvasHeight, preset) {
+  return `${layoutCacheKey(layer, canvasWidth, canvasHeight)}${preset}`;
+}
+function staggerEntranceEndMs(slotCount, preset) {
+  if (slotCount <= 0) return 0;
+  const lastIndex = slotCount - 1;
+  if (preset === "typewriter") {
+    return lastIndex * DEFAULT_STAGGER_MS + DEFAULT_STAGGER_MS;
+  }
+  return lastIndex * DEFAULT_STAGGER_MS + DEFAULT_DURATION_MS;
+}
 function buildCharSlots(ctx, layer, canvasWidth, canvasHeight) {
   const fontConfig = layer.fontConfig?.textStyle;
   if (!fontConfig) return null;
@@ -48,8 +76,8 @@ function buildCharSlots(ctx, layer, canvasWidth, canvasHeight) {
   let lines;
   if (layer.wordTimings && layer.wordTimings.length > 0) {
     const needsSpace = needsSpaceBetweenWords(layer.localeCode || "en-US", text);
-    const words = text.split(needsSpace ? /\s+/ : "");
-    lines = formEvenLinesWithWords(
+    const words = needsSpace ? text.split(/\s+/) : Array.from(text);
+    lines = getCachedEvenLinesWithWords(
       ctx,
       words,
       maxWidth,
@@ -59,7 +87,7 @@ function buildCharSlots(ctx, layer, canvasWidth, canvasHeight) {
       fontWeight
     );
   } else {
-    lines = wrapText(ctx, text, maxWidth, fontSize, fontFamily, fontWeight);
+    lines = getCachedWrapText(ctx, text, maxWidth, fontSize, fontFamily, fontWeight);
   }
   const totalHeight = lines.length * fontSize * lineHeight;
   const startY = calculateYPosition(canvasHeight, totalHeight, layer.fontConfig?.globalPosition);
@@ -87,9 +115,19 @@ function buildCharSlots(ctx, layer, canvasWidth, canvasHeight) {
   ctx.restore();
   return { slots, fontSize, lineHeight };
 }
-function renderCaptionStaggerEntrance(ctx, layer, canvasWidth, canvasHeight, relativeFrame, fps, preset) {
+function getCachedCharSlots(ctx, layer, canvasWidth, canvasHeight) {
+  const key = layoutCacheKey(layer, canvasWidth, canvasHeight);
+  const cached = charSlotsCache.get(key);
+  if (cached) {
+    return cached;
+  }
   const built = buildCharSlots(ctx, layer, canvasWidth, canvasHeight);
-  if (!built) return;
+  if (built) {
+    charSlotsCache.set(key, built);
+  }
+  return built;
+}
+function drawStaggerEntranceFrame(ctx, layer, built, relativeFrame, fps, preset) {
   const { slots, fontSize } = built;
   const fontConfig = layer.fontConfig.textStyle;
   const fontFamily = fontConfig.fontFamily;
@@ -181,8 +219,41 @@ function renderCaptionStaggerEntrance(ctx, layer, canvasWidth, canvasHeight, rel
   }
   ctx.restore();
 }
+function clearCaptionStaggerCache() {
+  charSlotsCache.clear();
+  for (const bitmap of staggerFinalRasterCache.values()) {
+    bitmap.close();
+  }
+  staggerFinalRasterCache.clear();
+}
+function renderCaptionStaggerEntrance(ctx, layer, canvasWidth, canvasHeight, relativeFrame, fps, preset) {
+  const built = getCachedCharSlots(ctx, layer, canvasWidth, canvasHeight);
+  if (!built) return;
+  const endMs = staggerEntranceEndMs(built.slots.length, preset);
+  const endFrame = Math.ceil(endMs / 1e3 * fps);
+  if (relativeFrame >= endFrame) {
+    const rasterKey = staggerRasterKey(layer, canvasWidth, canvasHeight, preset);
+    let bitmap = staggerFinalRasterCache.get(rasterKey);
+    if (!bitmap) {
+      const offscreen = new OffscreenCanvas(canvasWidth, canvasHeight);
+      const offCtx = offscreen.getContext("2d");
+      if (!offCtx) {
+        drawStaggerEntranceFrame(ctx, layer, built, endFrame, fps, preset);
+        return;
+      }
+      drawStaggerEntranceFrame(offCtx, layer, built, endFrame, fps, preset);
+      bitmap = offscreen.transferToImageBitmap();
+      staggerFinalRasterCache.set(rasterKey, bitmap);
+    }
+    ctx.drawImage(bitmap, 0, 0);
+    return;
+  }
+  drawStaggerEntranceFrame(ctx, layer, built, relativeFrame, fps, preset);
+}
 export {
   charProgress,
-  renderCaptionStaggerEntrance
+  clearCaptionStaggerCache,
+  renderCaptionStaggerEntrance,
+  staggerEntranceEndMs
 };
 //# sourceMappingURL=caption-stagger-entrance-renderer.js.map

package/dist/stages/compose/text-renderers/caption-stagger-entrance-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"caption-stagger-entrance-renderer.js","sources":["../../../../src/stages/compose/text-renderers/caption-stagger-entrance-renderer.ts"],"sourcesContent":["import type { TextLayer } from '../types';\nimport { wrapText, formEvenLinesWithWords } from '../text-utils/text-wrapper';\nimport { getLetterCaseText, measureTextWidth } from '../text-utils/text-metrics';\nimport { needsSpaceBetweenWords } from '../text-utils/locale-detector';\n\n/** Matches medeo-web caption preview (`caption-anime-effects` + anime.js defaults). */\nconst DEFAULT_DURATION_MS = 800;\nconst DEFAULT_STAGGER_MS = 50;\nconst SLIDE_BASE_PX = 50;\nconst LETTER_SPREAD_BASE_PX = 20;\nconst BLUR_START_PX = 10;\nconst FONT_REF_PX = 40;\n\nfunction easeOutExpo(t: number): number {\n  if (t <= 0) return 0;\n  if (t >= 1) return 1;\n  return 1 - Math.pow(2, -10 * t);\n}\n\nfunction calculateYPosition(\n  canvasHeight: number,\n  totalHeight: number,\n  globalPosition?: {\n    position?: 'absolute';\n    top?: string;\n    bottom?: string;\n    left?: string;\n    right?: string;\n    display?: string;\n    alignItems?: string;\n    justifyContent?: string;\n  }\n): number {\n  if (!globalPosition) {\n    return canvasHeight / 2 - totalHeight / 2;\n  }\n  if (globalPosition.top) {\n    const topPercent = parseFloat(globalPosition.top) / 100;\n    return canvasHeight * topPercent;\n  }\n  if (globalPosition.bottom) {\n    const bottomPercent = parseFloat(globalPosition.bottom) / 100;\n    return canvasHeight * (1 - bottomPercent) - totalHeight;\n  }\n  if (globalPosition.justifyContent === 'center' || globalPosition.alignItems === 'center') {\n    return canvasHeight / 2 - totalHeight / 2;\n  }\n  return canvasHeight / 2 - totalHeight / 2;\n}\n\nexport function charProgress(\n  relativeFrame: number,\n  fps: number,\n  charIndex: number,\n  staggerMs: number,\n  durationMs: number\n): number {\n  const tMs = (relativeFrame / fps) * 1000;\n  const startMs = charIndex * staggerMs;\n  if (tMs <= startMs) return 0;\n  const raw = (tMs - startMs) / durationMs;\n  return easeOutExpo(Math.min(1, raw));\n}\n\nexport type CaptionStaggerPreset =\n  | 'fade'\n  | 'slideUp'\n  | 'scale'\n  | 'rotateScale'\n  | 'blur'\n  | 'flip3d'\n  | 'typewriter'\n  | 'letterSpread';\n\ninterface CharSlot {\n  ch: string;\n  x: number;\n  y: number;\n  globalIndex: number;\n}\n\nfunction buildCharSlots(\n  ctx: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D,\n  layer: TextLayer,\n  canvasWidth: number,\n  canvasHeight: number\n): { slots: CharSlot[]; fontSize: number; lineHeight: number } | null {\n  const fontConfig = layer.fontConfig?.textStyle;\n  if (!fontConfig) return null;\n\n  const fontSize = fontConfig.fontSize;\n  const fontFamily = fontConfig.fontFamily;\n  const fontWeight = fontConfig.fontWeight;\n  const lineHeight = fontConfig.lineHeight || 1.2;\n  const maxWidth = canvasWidth * 0.64;\n  const text = getLetterCaseText(layer.text, layer.letterCase);\n\n  let lines: string[];\n  if (layer.wordTimings && layer.wordTimings.length > 0) {\n    const needsSpace = needsSpaceBetweenWords(layer.localeCode || 'en-US', 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  } else {\n    lines = wrapText(ctx, text, maxWidth, fontSize, fontFamily, fontWeight);\n  }\n\n  const totalHeight = lines.length * fontSize * lineHeight;\n  const startY = calculateYPosition(canvasHeight, totalHeight, layer.fontConfig?.globalPosition);\n\n  ctx.save();\n  ctx.font = `${fontWeight} ${fontSize}px ${fontFamily}`;\n\n  const slots: CharSlot[] = [];\n  let globalIndex = 0;\n\n  for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {\n    const line = lines[lineIndex]!;\n    const y = startY + lineIndex * fontSize * lineHeight + fontSize / 2;\n    const lineWidth = measureTextWidth(ctx, line, fontSize, fontFamily, fontWeight);\n    let cx = canvasWidth / 2 - lineWidth / 2;\n\n    for (const ch of Array.from(line)) {\n      const cw = measureTextWidth(ctx, ch, fontSize, fontFamily, fontWeight);\n      slots.push({\n        ch,\n        x: cx + cw / 2,\n        y,\n        globalIndex,\n      });\n      globalIndex++;\n      cx += cw;\n    }\n  }\n\n  ctx.restore();\n  return { slots, fontSize, lineHeight };\n}\n\n/**\n * Per-character stagger entrance aligned with medeo-web preview (anime.js easeOutExpo, 800ms, 50ms stagger).\n */\nexport function renderCaptionStaggerEntrance(\n  ctx: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D,\n  layer: TextLayer,\n  canvasWidth: number,\n  canvasHeight: number,\n  relativeFrame: number,\n  fps: number,\n  preset: CaptionStaggerPreset\n): void {\n  const built = buildCharSlots(ctx, layer, canvasWidth, canvasHeight);\n  if (!built) return;\n\n  const { slots, fontSize } = built;\n  const fontConfig = layer.fontConfig!.textStyle!;\n  const fontFamily = fontConfig.fontFamily;\n  const fontWeight = fontConfig.fontWeight;\n  const fill = fontConfig.fill;\n  const stroke = fontConfig.stroke;\n  const strokeWidth = fontConfig.strokeWidth || 0;\n\n  const scalePx = fontSize / FONT_REF_PX;\n  const staggerMs = DEFAULT_STAGGER_MS;\n\n  ctx.save();\n  ctx.font = `${fontWeight} ${fontSize}px ${fontFamily}`;\n  ctx.textAlign = 'center';\n  ctx.textBaseline = 'middle';\n  ctx.lineJoin = 'round';\n  ctx.lineCap = 'round';\n\n  const tMsGlobal = (relativeFrame / fps) * 1000;\n\n  for (const slot of slots) {\n    let p: number;\n    if (preset === 'typewriter') {\n      const startMs = slot.globalIndex * staggerMs;\n      p = tMsGlobal >= startMs ? 1 : 0;\n    } else {\n      p = charProgress(relativeFrame, fps, slot.globalIndex, staggerMs, DEFAULT_DURATION_MS);\n    }\n    if (p <= 0 && preset !== 'blur') continue;\n\n    const slidePx = SLIDE_BASE_PX * scalePx;\n    const spreadPx = LETTER_SPREAD_BASE_PX * scalePx;\n\n    ctx.save();\n\n    let opacity = p;\n    let tx = 0;\n    let ty = 0;\n    let rot = 0;\n    let sc = 1;\n    let sy = 1;\n    let blurPx = 0;\n\n    switch (preset) {\n      case 'fade':\n        opacity = p;\n        break;\n      case 'slideUp':\n        opacity = p;\n        ty = (1 - p) * slidePx;\n        break;\n      case 'scale':\n        opacity = p;\n        sc = Math.max(0.04, p);\n        break;\n      case 'rotateScale':\n        opacity = p;\n        rot = ((1 - p) * 45 * Math.PI) / 180;\n        sc = 0.5 + p * 0.5;\n        break;\n      case 'blur':\n        opacity = p;\n        blurPx = (1 - p) * BLUR_START_PX;\n        break;\n      case 'flip3d':\n        opacity = p;\n        sy = Math.max(0.04, p);\n        sc = 1;\n        break;\n      case 'typewriter':\n        opacity = p >= 1 ? 1 : p;\n        break;\n      case 'letterSpread':\n        opacity = p;\n        tx = (1 - p) * spreadPx * slot.globalIndex;\n        break;\n      default:\n        break;\n    }\n\n    ctx.globalAlpha = opacity;\n    if (blurPx > 0.01) {\n      ctx.filter = `blur(${blurPx}px)`;\n    }\n\n    ctx.translate(slot.x + tx, slot.y + ty);\n    ctx.rotate(rot);\n    if (preset === 'flip3d') {\n      ctx.scale(1, sy);\n    } else {\n      ctx.scale(sc, sc);\n    }\n\n    if (stroke && strokeWidth > 0) {\n      ctx.strokeStyle = stroke;\n      ctx.lineWidth = strokeWidth;\n      ctx.strokeText(slot.ch, 0, 0);\n    }\n    ctx.fillStyle = fill;\n    ctx.fillText(slot.ch, 0, 0);\n\n    ctx.restore();\n  }\n\n  ctx.restore();\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"caption-stagger-entrance-renderer.js","sources":["../../../../src/stages/compose/text-renderers/caption-stagger-entrance-renderer.ts"],"sourcesContent":["import type { TextLayer } from '../types';\nimport { getCachedEvenLinesWithWords, getCachedWrapText } from '../text-utils/text-layout-cache';\nimport { getLetterCaseText, measureTextWidth } from '../text-utils/text-metrics';\nimport { needsSpaceBetweenWords } from '../text-utils/locale-detector';\n\n/** Matches medeo-web caption preview (`caption-anime-effects` + anime.js defaults). */\nconst DEFAULT_DURATION_MS = 800;\nconst DEFAULT_STAGGER_MS = 50;\nconst SLIDE_BASE_PX = 50;\nconst LETTER_SPREAD_BASE_PX = 20;\nconst BLUR_START_PX = 10;\nconst FONT_REF_PX = 40;\n\nfunction easeOutExpo(t: number): number {\n  if (t <= 0) return 0;\n  if (t >= 1) return 1;\n  return 1 - Math.pow(2, -10 * t);\n}\n\nfunction calculateYPosition(\n  canvasHeight: number,\n  totalHeight: number,\n  globalPosition?: {\n    position?: 'absolute';\n    top?: string;\n    bottom?: string;\n    left?: string;\n    right?: string;\n    display?: string;\n    alignItems?: string;\n    justifyContent?: string;\n  }\n): number {\n  if (!globalPosition) {\n    return canvasHeight / 2 - totalHeight / 2;\n  }\n  if (globalPosition.top) {\n    const topPercent = parseFloat(globalPosition.top) / 100;\n    return canvasHeight * topPercent;\n  }\n  if (globalPosition.bottom) {\n    const bottomPercent = parseFloat(globalPosition.bottom) / 100;\n    return canvasHeight * (1 - bottomPercent) - totalHeight;\n  }\n  if (globalPosition.justifyContent === 'center' || globalPosition.alignItems === 'center') {\n    return canvasHeight / 2 - totalHeight / 2;\n  }\n  return canvasHeight / 2 - totalHeight / 2;\n}\n\nexport function charProgress(\n  relativeFrame: number,\n  fps: number,\n  charIndex: number,\n  staggerMs: number,\n  durationMs: number\n): number {\n  const tMs = (relativeFrame / fps) * 1000;\n  const startMs = charIndex * staggerMs;\n  if (tMs <= startMs) return 0;\n  const raw = (tMs - startMs) / durationMs;\n  return easeOutExpo(Math.min(1, raw));\n}\n\nexport type CaptionStaggerPreset =\n  | 'fade'\n  | 'slideUp'\n  | 'scale'\n  | 'rotateScale'\n  | 'blur'\n  | 'flip3d'\n  | 'typewriter'\n  | 'letterSpread';\n\ninterface CharSlot {\n  ch: string;\n  x: number;\n  y: number;\n  globalIndex: number;\n}\n\ninterface CharSlotsLayout {\n  slots: CharSlot[];\n  fontSize: number;\n  lineHeight: number;\n}\n\nconst charSlotsCache = new Map<string, CharSlotsLayout>();\nconst staggerFinalRasterCache = new Map<string, ImageBitmap>();\n\nfunction layoutCacheKey(layer: TextLayer, canvasWidth: number, canvasHeight: number): string {\n  const ts = layer.fontConfig?.textStyle;\n  return [\n    layer.id,\n    layer.text,\n    layer.letterCase ?? '',\n    canvasWidth,\n    canvasHeight,\n    ts?.fontSize,\n    ts?.fontFamily,\n    ts?.fontWeight,\n    ts?.lineHeight,\n    JSON.stringify(layer.fontConfig?.globalPosition ?? null),\n  ].join('\\x1f');\n}\n\nfunction staggerRasterKey(\n  layer: TextLayer,\n  canvasWidth: number,\n  canvasHeight: number,\n  preset: CaptionStaggerPreset\n): string {\n  return `${layoutCacheKey(layer, canvasWidth, canvasHeight)}\\x1f${preset}`;\n}\n\nexport function staggerEntranceEndMs(slotCount: number, preset: CaptionStaggerPreset): number {\n  if (slotCount <= 0) return 0;\n  const lastIndex = slotCount - 1;\n  if (preset === 'typewriter') {\n    return lastIndex * DEFAULT_STAGGER_MS + DEFAULT_STAGGER_MS;\n  }\n  return lastIndex * DEFAULT_STAGGER_MS + DEFAULT_DURATION_MS;\n}\n\nfunction buildCharSlots(\n  ctx: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D,\n  layer: TextLayer,\n  canvasWidth: number,\n  canvasHeight: number\n): CharSlotsLayout | null {\n  const fontConfig = layer.fontConfig?.textStyle;\n  if (!fontConfig) return null;\n\n  const fontSize = fontConfig.fontSize;\n  const fontFamily = fontConfig.fontFamily;\n  const fontWeight = fontConfig.fontWeight;\n  const lineHeight = fontConfig.lineHeight || 1.2;\n  const maxWidth = canvasWidth * 0.64;\n  const text = getLetterCaseText(layer.text, layer.letterCase);\n\n  let lines: string[];\n  if (layer.wordTimings && layer.wordTimings.length > 0) {\n    const needsSpace = needsSpaceBetweenWords(layer.localeCode || 'en-US', text);\n    const words = needsSpace ? text.split(/\\s+/) : Array.from(text);\n    lines = getCachedEvenLinesWithWords(\n      ctx,\n      words,\n      maxWidth,\n      fontSize,\n      needsSpace,\n      fontFamily,\n      fontWeight\n    );\n  } else {\n    lines = getCachedWrapText(ctx, text, maxWidth, fontSize, fontFamily, fontWeight);\n  }\n\n  const totalHeight = lines.length * fontSize * lineHeight;\n  const startY = calculateYPosition(canvasHeight, totalHeight, layer.fontConfig?.globalPosition);\n\n  ctx.save();\n  ctx.font = `${fontWeight} ${fontSize}px ${fontFamily}`;\n\n  const slots: CharSlot[] = [];\n  let globalIndex = 0;\n\n  for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {\n    const line = lines[lineIndex]!;\n    const y = startY + lineIndex * fontSize * lineHeight + fontSize / 2;\n    const lineWidth = measureTextWidth(ctx, line, fontSize, fontFamily, fontWeight);\n    let cx = canvasWidth / 2 - lineWidth / 2;\n\n    for (const ch of Array.from(line)) {\n      const cw = measureTextWidth(ctx, ch, fontSize, fontFamily, fontWeight);\n      slots.push({\n        ch,\n        x: cx + cw / 2,\n        y,\n        globalIndex,\n      });\n      globalIndex++;\n      cx += cw;\n    }\n  }\n\n  ctx.restore();\n  return { slots, fontSize, lineHeight };\n}\n\nfunction getCachedCharSlots(\n  ctx: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D,\n  layer: TextLayer,\n  canvasWidth: number,\n  canvasHeight: number\n): CharSlotsLayout | null {\n  const key = layoutCacheKey(layer, canvasWidth, canvasHeight);\n  const cached = charSlotsCache.get(key);\n  if (cached) {\n    return cached;\n  }\n  const built = buildCharSlots(ctx, layer, canvasWidth, canvasHeight);\n  if (built) {\n    charSlotsCache.set(key, built);\n  }\n  return built;\n}\n\nfunction drawStaggerEntranceFrame(\n  ctx: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D,\n  layer: TextLayer,\n  built: CharSlotsLayout,\n  relativeFrame: number,\n  fps: number,\n  preset: CaptionStaggerPreset\n): void {\n  const { slots, fontSize } = built;\n  const fontConfig = layer.fontConfig!.textStyle!;\n  const fontFamily = fontConfig.fontFamily;\n  const fontWeight = fontConfig.fontWeight;\n  const fill = fontConfig.fill;\n  const stroke = fontConfig.stroke;\n  const strokeWidth = fontConfig.strokeWidth || 0;\n\n  const scalePx = fontSize / FONT_REF_PX;\n  const staggerMs = DEFAULT_STAGGER_MS;\n\n  ctx.save();\n  ctx.font = `${fontWeight} ${fontSize}px ${fontFamily}`;\n  ctx.textAlign = 'center';\n  ctx.textBaseline = 'middle';\n  ctx.lineJoin = 'round';\n  ctx.lineCap = 'round';\n\n  const tMsGlobal = (relativeFrame / fps) * 1000;\n\n  for (const slot of slots) {\n    let p: number;\n    if (preset === 'typewriter') {\n      const startMs = slot.globalIndex * staggerMs;\n      p = tMsGlobal >= startMs ? 1 : 0;\n    } else {\n      p = charProgress(relativeFrame, fps, slot.globalIndex, staggerMs, DEFAULT_DURATION_MS);\n    }\n    if (p <= 0 && preset !== 'blur') continue;\n\n    const slidePx = SLIDE_BASE_PX * scalePx;\n    const spreadPx = LETTER_SPREAD_BASE_PX * scalePx;\n\n    ctx.save();\n\n    let opacity = p;\n    let tx = 0;\n    let ty = 0;\n    let rot = 0;\n    let sc = 1;\n    let sy = 1;\n    let blurPx = 0;\n\n    switch (preset) {\n      case 'fade':\n        opacity = p;\n        break;\n      case 'slideUp':\n        opacity = p;\n        ty = (1 - p) * slidePx;\n        break;\n      case 'scale':\n        opacity = p;\n        sc = Math.max(0.04, p);\n        break;\n      case 'rotateScale':\n        opacity = p;\n        rot = ((1 - p) * 45 * Math.PI) / 180;\n        sc = 0.5 + p * 0.5;\n        break;\n      case 'blur':\n        opacity = p;\n        blurPx = (1 - p) * BLUR_START_PX;\n        break;\n      case 'flip3d':\n        opacity = p;\n        sy = Math.max(0.04, p);\n        sc = 1;\n        break;\n      case 'typewriter':\n        opacity = p >= 1 ? 1 : p;\n        break;\n      case 'letterSpread':\n        opacity = p;\n        tx = (1 - p) * spreadPx * slot.globalIndex;\n        break;\n      default:\n        break;\n    }\n\n    ctx.globalAlpha = opacity;\n    if (blurPx > 0.01) {\n      ctx.filter = `blur(${blurPx}px)`;\n    }\n\n    ctx.translate(slot.x + tx, slot.y + ty);\n    ctx.rotate(rot);\n    if (preset === 'flip3d') {\n      ctx.scale(1, sy);\n    } else {\n      ctx.scale(sc, sc);\n    }\n\n    if (stroke && strokeWidth > 0) {\n      ctx.strokeStyle = stroke;\n      ctx.lineWidth = strokeWidth;\n      ctx.strokeText(slot.ch, 0, 0);\n    }\n    ctx.fillStyle = fill;\n    ctx.fillText(slot.ch, 0, 0);\n\n    ctx.restore();\n  }\n\n  ctx.restore();\n}\n\nexport function clearCaptionStaggerCache(): void {\n  charSlotsCache.clear();\n  for (const bitmap of staggerFinalRasterCache.values()) {\n    bitmap.close();\n  }\n  staggerFinalRasterCache.clear();\n}\n\n/**\n * Per-character stagger entrance aligned with medeo-web preview (anime.js easeOutExpo, 800ms, 50ms stagger).\n */\nexport function renderCaptionStaggerEntrance(\n  ctx: OffscreenCanvasRenderingContext2D | CanvasRenderingContext2D,\n  layer: TextLayer,\n  canvasWidth: number,\n  canvasHeight: number,\n  relativeFrame: number,\n  fps: number,\n  preset: CaptionStaggerPreset\n): void {\n  const built = getCachedCharSlots(ctx, layer, canvasWidth, canvasHeight);\n  if (!built) return;\n\n  const endMs = staggerEntranceEndMs(built.slots.length, preset);\n  const endFrame = Math.ceil((endMs / 1000) * fps);\n\n  if (relativeFrame >= endFrame) {\n    const rasterKey = staggerRasterKey(layer, canvasWidth, canvasHeight, preset);\n    let bitmap = staggerFinalRasterCache.get(rasterKey);\n    if (!bitmap) {\n      const offscreen = new OffscreenCanvas(canvasWidth, canvasHeight);\n      const offCtx = offscreen.getContext('2d');\n      if (!offCtx) {\n        drawStaggerEntranceFrame(ctx, layer, built, endFrame, fps, preset);\n        return;\n      }\n      drawStaggerEntranceFrame(offCtx, layer, built, endFrame, fps, preset);\n      bitmap = offscreen.transferToImageBitmap();\n      staggerFinalRasterCache.set(rasterKey, bitmap);\n    }\n    ctx.drawImage(bitmap, 0, 0);\n    return;\n  }\n\n  drawStaggerEntranceFrame(ctx, layer, built, relativeFrame, fps, preset);\n}\n"],"names":[],"mappings":"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"}

package/dist/workers/stages/export/{export.worker.C9m51RNP.js → export.worker.CPqXBEVe.js}

@@ -1048,6 +1048,34 @@ function charProgress(relativeFrame, fps, charIndex, staggerMs, durationMs) {
   const raw = (tMs - startMs) / durationMs;
   return easeOutExpo(Math.min(1, raw));
 }
+const charSlotsCache = /* @__PURE__ */ new Map();
+const staggerFinalRasterCache = /* @__PURE__ */ new Map();
+function layoutCacheKey(layer, canvasWidth, canvasHeight) {
+  const ts = layer.fontConfig?.textStyle;
+  return [
+    layer.id,
+    layer.text,
+    layer.letterCase ?? "",
+    canvasWidth,
+    canvasHeight,
+    ts?.fontSize,
+    ts?.fontFamily,
+    ts?.fontWeight,
+    ts?.lineHeight,
+    JSON.stringify(layer.fontConfig?.globalPosition ?? null)
+  ].join("");
+}
+function staggerRasterKey(layer, canvasWidth, canvasHeight, preset) {
+  return `${layoutCacheKey(layer, canvasWidth, canvasHeight)}${preset}`;
+}
+function staggerEntranceEndMs(slotCount, preset) {
+  if (slotCount <= 0) return 0;
+  const lastIndex = slotCount - 1;
+  if (preset === "typewriter") {
+    return lastIndex * DEFAULT_STAGGER_MS + DEFAULT_STAGGER_MS;
+  }
+  return lastIndex * DEFAULT_STAGGER_MS + DEFAULT_DURATION_MS;
+}
 function buildCharSlots(ctx, layer, canvasWidth, canvasHeight) {
   const fontConfig = layer.fontConfig?.textStyle;
   if (!fontConfig) return null;
@@ -1060,8 +1088,8 @@ function buildCharSlots(ctx, layer, canvasWidth, canvasHeight) {
   let lines;
   if (layer.wordTimings && layer.wordTimings.length > 0) {
     const needsSpace = needsSpaceBetweenWords(layer.localeCode || "en-US", text);
-    const words = text.split(needsSpace ? /\s+/ : "");
-    lines = formEvenLinesWithWords(
+    const words = needsSpace ? text.split(/\s+/) : Array.from(text);
+    lines = getCachedEvenLinesWithWords(
       ctx,
       words,
       maxWidth,
@@ -1071,7 +1099,7 @@ function buildCharSlots(ctx, layer, canvasWidth, canvasHeight) {
       fontWeight
     );
   } else {
-    lines = wrapText(ctx, text, maxWidth, fontSize, fontFamily, fontWeight);
+    lines = getCachedWrapText(ctx, text, maxWidth, fontSize, fontFamily, fontWeight);
   }
   const totalHeight = lines.length * fontSize * lineHeight;
   const startY = calculateYPosition$3(canvasHeight, totalHeight, layer.fontConfig?.globalPosition);
@@ -1099,9 +1127,19 @@ function buildCharSlots(ctx, layer, canvasWidth, canvasHeight) {
   ctx.restore();
   return { slots, fontSize, lineHeight };
 }
-function renderCaptionStaggerEntrance(ctx, layer, canvasWidth, canvasHeight, relativeFrame, fps, preset) {
+function getCachedCharSlots(ctx, layer, canvasWidth, canvasHeight) {
+  const key = layoutCacheKey(layer, canvasWidth, canvasHeight);
+  const cached = charSlotsCache.get(key);
+  if (cached) {
+    return cached;
+  }
   const built = buildCharSlots(ctx, layer, canvasWidth, canvasHeight);
-  if (!built) return;
+  if (built) {
+    charSlotsCache.set(key, built);
+  }
+  return built;
+}
+function drawStaggerEntranceFrame(ctx, layer, built, relativeFrame, fps, preset) {
   const { slots, fontSize } = built;
   const fontConfig = layer.fontConfig.textStyle;
   const fontFamily = fontConfig.fontFamily;
@@ -1193,6 +1231,37 @@ function renderCaptionStaggerEntrance(ctx, layer, canvasWidth, canvasHeight, rel
   }
   ctx.restore();
 }
+function clearCaptionStaggerCache() {
+  charSlotsCache.clear();
+  for (const bitmap of staggerFinalRasterCache.values()) {
+    bitmap.close();
+  }
+  staggerFinalRasterCache.clear();
+}
+function renderCaptionStaggerEntrance(ctx, layer, canvasWidth, canvasHeight, relativeFrame, fps, preset) {
+  const built = getCachedCharSlots(ctx, layer, canvasWidth, canvasHeight);
+  if (!built) return;
+  const endMs = staggerEntranceEndMs(built.slots.length, preset);
+  const endFrame = Math.ceil(endMs / 1e3 * fps);
+  if (relativeFrame >= endFrame) {
+    const rasterKey = staggerRasterKey(layer, canvasWidth, canvasHeight, preset);
+    let bitmap = staggerFinalRasterCache.get(rasterKey);
+    if (!bitmap) {
+      const offscreen = new OffscreenCanvas(canvasWidth, canvasHeight);
+      const offCtx = offscreen.getContext("2d");
+      if (!offCtx) {
+        drawStaggerEntranceFrame(ctx, layer, built, endFrame, fps, preset);
+        return;
+      }
+      drawStaggerEntranceFrame(offCtx, layer, built, endFrame, fps, preset);
+      bitmap = offscreen.transferToImageBitmap();
+      staggerFinalRasterCache.set(rasterKey, bitmap);
+    }
+    ctx.drawImage(bitmap, 0, 0);
+    return;
+  }
+  drawStaggerEntranceFrame(ctx, layer, built, relativeFrame, fps, preset);
+}
 function usToFrame$2(us, fps) {
   return Math.floor(us / (1e6 / fps));
 }
@@ -2394,6 +2463,7 @@ class VideoComposer {
         flush: async () => {
           this.filterProcessor.clearCache();
           clearTextLayoutCache();
+          clearCaptionStaggerCache();
         }
       },
       {
@@ -3550,4 +3620,4 @@ const export_worker = null;
 export {
   export_worker as default
 };
-//# sourceMappingURL=export.worker.C9m51RNP.js.map
+//# sourceMappingURL=export.worker.CPqXBEVe.js.map