@editframe/elements 0.30.1-beta.0 → 0.31.0-beta.0

package/dist/EF_FRAMEGEN.d.ts

@@ -47,6 +47,11 @@ declare class EFFramegen {
   private initializeVerificationCanvas;
   private drawVerificationStrip;
   constructor();
+  /**
+   * Helper method to get the workbench and set its rendering state.
+   * This ensures consistent state management across the framegen lifecycle.
+   */
+  private setWorkbenchRendering;
   connectToBridge(): void;
   get showFrameBox(): boolean;
   initialize(renderOptions: VideoRenderOptions): Promise<void>;

package/dist/EF_FRAMEGEN.js

@@ -92,6 +92,14 @@ var EFFramegen = class {
 		this.BRIDGE = window.FRAMEGEN_BRIDGE;
 		if (this.BRIDGE) this.connectToBridge();
 	}
+	/**
+	* Helper method to get the workbench and set its rendering state.
+	* This ensures consistent state management across the framegen lifecycle.
+	*/
+	setWorkbenchRendering(isRendering) {
+		const workbench = document.querySelector("ef-workbench");
+		if (workbench) workbench.rendering = isRendering;
+	}
 	connectToBridge() {
 		const BRIDGE = this.BRIDGE;
 		if (!BRIDGE) throw new Error("No BRIDGE when attempting to connect to bridge");
@@ -112,10 +120,13 @@ var EFFramegen = class {
 				fps: renderOptions.encoderOptions.video.framerate,
 				durationMs: renderOptions.encoderOptions.toMs - renderOptions.encoderOptions.fromMs
 			}, parentContext, async () => {
-				await this.initialize(renderOptions).catch((error) => {
+				try {
+					await this.initialize(renderOptions);
+				} catch (error) {
+					this.setWorkbenchRendering(false);
 					console.error("[EF_FRAMEGEN.connectToBridge] error initializing", error);
 					throw error;
-				});
+				}
 			});
 			BRIDGE.initialized();
 		});
@@ -128,11 +139,15 @@ var EFFramegen = class {
 				setCurrentFrameSpan(span);
 				try {
 					await this.beginFrame(frameNumber, isLast);
+				} catch (error) {
+					this.setWorkbenchRendering(false);
+					throw error;
 				} finally {
 					clearCurrentFrameSpan();
 				}
 			}).catch((error) => {
 				console.error("[EF_FRAMEGEN.beginFrame] error:", error);
+				this.setWorkbenchRendering(false);
 				clearCurrentFrameSpan();
 				throw error;
 			});
@@ -152,7 +167,7 @@ var EFFramegen = class {
 		this.renderOptions = renderOptions;
 		const workbench = document.querySelector("ef-workbench");
 		if (!workbench) throw new Error("No workbench found");
-		workbench.rendering = true;
+		this.setWorkbenchRendering(true);
 		workbench.playing = false;
 		const firstGroup = shallowGetTimegroups(workbench)[0];
 		if (!firstGroup) throw new Error("No temporal elements found");
@@ -181,7 +196,7 @@ var EFFramegen = class {
 		if (this.renderOptions === void 0) throw new Error("No renderOptions");
 		const workbench = document.querySelector("ef-workbench");
 		if (!workbench) throw new Error("No workbench found");
-		workbench.rendering = true;
+		this.setWorkbenchRendering(true);
 		const firstGroup = shallowGetTimegroups(workbench)[0];
 		if (!firstGroup) throw new Error("No temporal elements found");
 		const frameTime = this.renderOptions.encoderOptions.fromMs + frameNumber * this.frameDurationMs;
@@ -209,6 +224,7 @@ var EFFramegen = class {
 				});
 				return fileReader.result;
 			}
+			this.setWorkbenchRendering(false);
 		} else if (this.BRIDGE) this.BRIDGE.frameReady(frameNumber, /* @__PURE__ */ new ArrayBuffer(0));
 		else {
 			const fileReader = new FileReader();

package/dist/EF_FRAMEGEN.js.map

@@ -1 +1 @@
-{"version":3,"file":"EF_FRAMEGEN.js","names":[],"sources":["../src/EF_FRAMEGEN.ts"],"sourcesContent":["import type { VideoRenderOptions } from \"@editframe/assets\";\n\nimport { shallowGetTimegroups } from \"./elements/EFTimegroup.js\";\nimport { setupBrowserTracing } from \"./otel/setupBrowserTracing.js\";\nimport {\n  clearCurrentFrameSpan,\n  enableTracing,\n  extractParentContext,\n  setCurrentFrameSpan,\n  type TraceContext,\n  withSpan,\n  withSpanAndContext,\n} from \"./otel/tracingHelpers.js\";\n\ninterface Bridge {\n  onInitialize: (\n    callback: (\n      renderOptions: VideoRenderOptions,\n      traceContext?: TraceContext,\n      otelEndpoint?: string,\n    ) => void,\n  ) => void;\n\n  initialized(): void;\n\n  onBeginFrame(\n    callback: (\n      frameNumber: number,\n      isLast: boolean,\n      traceContext?: TraceContext,\n    ) => void,\n  ): void;\n\n  onTriggerCanvas(callback: (traceContext?: TraceContext) => void): void;\n\n  frameReady(frameNumber: number, audioSamples: ArrayBuffer): void;\n\n  error(error: Error): void;\n\n  syncLog(sequence: number, message: string, callback: () => void): void;\n\n  exportSpans?: (endpoint: string, payload: string) => void;\n}\n\ndeclare global {\n  interface Window {\n    EF_FRAMEGEN?: EFFramegen;\n    FRAMEGEN_BRIDGE?: Bridge;\n    FRAMEGEN_BINDING?: any;\n    FRAMEGEN_BINDING_error?: (error: Error) => void;\n    EF_RENDERING?: () => boolean;\n  }\n}\n\nclass TriggerCanvas {\n  private canvas: HTMLCanvasElement;\n  private ctx: CanvasRenderingContext2D;\n\n  private canvasInitialized = false;\n\n  constructor() {\n    this.canvas = document.createElement(\"canvas\");\n    const ctx = this.canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) throw new Error(\"Canvas 2d context not ready\");\n    this.ctx = ctx;\n    this.ctx.fillStyle = \"transparent\";\n  }\n\n  initialize() {\n    if (this.canvasInitialized) return;\n    this.canvasInitialized = true;\n    this.canvas.width = 1;\n    this.canvas.height = 1;\n    Object.assign(this.canvas.style, {\n      position: \"fixed\",\n      top: \"0px\",\n      left: \"0px\",\n      width: \"100%\",\n      height: \"100%\",\n      zIndex: \"100000\",\n    });\n    document.body.appendChild(this.canvas);\n  }\n\n  trigger() {\n    this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);\n  }\n}\n\nexport class EFFramegen {\n  time = 0;\n  frameDurationMs = 0;\n  audioBufferPromise?: Promise<AudioBuffer>;\n  renderOptions?: VideoRenderOptions;\n  frameBox = document.createElement(\"div\");\n  BRIDGE: typeof window.FRAMEGEN_BRIDGE;\n  triggerCanvas = new TriggerCanvas();\n  verificationCanvas?: HTMLCanvasElement;\n  verificationCtx?: CanvasRenderingContext2D;\n  private logSequence = 0;\n\n  // Frame sequence coordination\n  public frameTasksInProgress = false;\n  public currentFrameNumber = 0;\n\n  trace(...args: any[]) {\n    console.trace(\"[EF_FRAMEGEN]\", ...args);\n  }\n\n  async syncLog(...args: any[]): Promise<void> {\n    if (!this.BRIDGE) {\n      // Fallback to regular console.log if no bridge\n      console.log(\"[EF_FRAMEGEN]\", ...args);\n      return;\n    }\n\n    const sequence = ++this.logSequence;\n    const message = args\n      .map((arg) =>\n        typeof arg === \"object\" ? JSON.stringify(arg) : String(arg),\n      )\n      .join(\" \");\n\n    return new Promise<void>((resolve) => {\n      // biome-ignore lint/style/noNonNullAssertion: We know BRIDGE is set due to the guard above\n      this.BRIDGE!.syncLog(sequence, message, () => {\n        resolve();\n      });\n    });\n  }\n\n  private initializeVerificationCanvas() {\n    if (this.verificationCanvas) {\n      return;\n    }\n\n    this.verificationCanvas = document.createElement(\"canvas\");\n    const ctx = this.verificationCanvas.getContext(\"2d\");\n    if (!ctx) throw new Error(\"Verification canvas 2d context not ready\");\n    this.verificationCtx = ctx;\n\n    // Size to match the workbench width, 1 pixel height for verification strip\n    const workbench = document.querySelector(\"ef-workbench\") as HTMLElement;\n    if (workbench) {\n      this.verificationCanvas.width = workbench.clientWidth;\n      this.verificationCanvas.height = 1;\n\n      // Position at the bottom of the workbench (beyond content height)\n      Object.assign(this.verificationCanvas.style, {\n        position: \"fixed\",\n        left: \"0px\",\n        bottom: \"0px\",\n        width: `${workbench.clientWidth}px`,\n        height: \"1px\",\n        zIndex: \"99999\", // Above trigger canvas\n      });\n\n      document.body.appendChild(this.verificationCanvas);\n    }\n  }\n\n  private drawVerificationStrip(frameNumber: number) {\n    this.initializeVerificationCanvas();\n\n    if (!this.verificationCanvas || !this.verificationCtx) {\n      return;\n    }\n\n    const width = this.verificationCanvas.width;\n    const height = this.verificationCanvas.height;\n\n    // Clear the strip\n    this.verificationCtx.clearRect(0, 0, width, height);\n\n    // Encode frame number into RGB (24-bit)\n    // R=high byte, G=middle byte, B=low byte\n    const red = Math.floor(frameNumber / (256 * 256)) % 256;\n    const green = Math.floor(frameNumber / 256) % 256;\n    const blue = frameNumber % 256;\n\n    // Fill the entire strip with the encoded frame number\n    this.verificationCtx.fillStyle = `rgb(${red}, ${green}, ${blue})`;\n    this.verificationCtx.fillRect(0, 0, width, height);\n  }\n\n  constructor() {\n    this.BRIDGE = window.FRAMEGEN_BRIDGE;\n    if (this.BRIDGE) {\n      this.connectToBridge();\n    }\n  }\n\n  connectToBridge() {\n    const BRIDGE = this.BRIDGE;\n    if (!BRIDGE) {\n      throw new Error(\"No BRIDGE when attempting to connect to bridge\");\n    }\n\n    BRIDGE.onInitialize(async (renderOptions, traceContext, otelEndpoint) => {\n      // Only enable tracing if explicitly requested in renderOptions\n      if (renderOptions.enableTracing && otelEndpoint) {\n        enableTracing();\n        await setupBrowserTracing({\n          otelEndpoint,\n          serviceName: \"telecine-browser\",\n          bridge: BRIDGE,\n          useBatching: true, // Batch spans to reduce overhead during rendering\n        });\n      }\n\n      const parentContext = extractParentContext(traceContext);\n\n      await withSpan(\n        \"browser.initialize\",\n        {\n          width: renderOptions.encoderOptions.video.width,\n          height: renderOptions.encoderOptions.video.height,\n          fps: renderOptions.encoderOptions.video.framerate,\n          durationMs:\n            renderOptions.encoderOptions.toMs -\n            renderOptions.encoderOptions.fromMs,\n        },\n        parentContext,\n        async () => {\n          await this.initialize(renderOptions).catch((error) => {\n            console.error(\n              \"[EF_FRAMEGEN.connectToBridge] error initializing\",\n              error,\n            );\n            throw error;\n          });\n        },\n      );\n\n      BRIDGE.initialized();\n    });\n\n    BRIDGE.onBeginFrame((frameNumber, isLast, traceContext) => {\n      const parentContext = extractParentContext(traceContext);\n      withSpanAndContext(\n        \"browser.frame.render\",\n        {\n          frameNumber,\n          isLast,\n        },\n        parentContext,\n        async (span, _spanContext) => {\n          // Store the span itself for child operations\n          // This allows spans created in Lit Tasks to use it as their parent\n          setCurrentFrameSpan(span);\n\n          try {\n            await this.beginFrame(frameNumber, isLast);\n          } finally {\n            clearCurrentFrameSpan();\n          }\n        },\n      ).catch((error) => {\n        console.error(\"[EF_FRAMEGEN.beginFrame] error:\", error);\n        clearCurrentFrameSpan();\n        throw error;\n      });\n    });\n\n    BRIDGE.onTriggerCanvas((traceContext) => {\n      const parentContext = extractParentContext(traceContext);\n\n      withSpan(\"browser.canvas.trigger\", {}, parentContext, async () => {\n        this.triggerCanvas.trigger();\n      }).catch((error) => {\n        console.error(\"[EF_FRAMEGEN.triggerCanvas] error:\", error);\n      });\n    });\n  }\n\n  get showFrameBox() {\n    return this.renderOptions?.showFrameBox ?? false;\n  }\n\n  async initialize(renderOptions: VideoRenderOptions) {\n    this.renderOptions = renderOptions;\n\n    const workbench = document.querySelector(\"ef-workbench\");\n    if (!workbench) {\n      throw new Error(\"No workbench found\");\n    }\n    workbench.rendering = true;\n    workbench.playing = false;\n    const timegroups = shallowGetTimegroups(workbench);\n    const firstGroup = timegroups[0];\n    if (!firstGroup) {\n      throw new Error(\"No temporal elements found\");\n    }\n    const startingTimeMs = renderOptions.encoderOptions.fromMs;\n    await firstGroup.waitForMediaDurations();\n    await firstGroup.waitForFrameTasks();\n\n    this.frameDurationMs = 1000 / renderOptions.encoderOptions.video.framerate;\n\n    this.time = startingTimeMs;\n    if (this.showFrameBox) {\n      Object.assign(this.frameBox.style, {\n        width: \"200px\",\n        height: \"100px\",\n        font: \"10px Arial\",\n        backgroundColor: \"white\",\n        position: \"absolute\",\n        top: \"0px\",\n        right: \"0px\",\n        zIndex: \"100000\",\n      });\n      document.body.prepend(this.frameBox);\n    }\n\n    this.triggerCanvas.initialize();\n\n    // These times are aligned to the audio frame boundaries\n    // And they include padding if any.\n    this.audioBufferPromise = firstGroup.renderAudio(\n      renderOptions.encoderOptions.alignedFromUs / 1000,\n      renderOptions.encoderOptions.alignedToUs / 1000,\n    );\n  }\n\n  async beginFrame(frameNumber: number, isLast: boolean) {\n    if (this.renderOptions === undefined) {\n      throw new Error(\"No renderOptions\");\n    }\n    const workbench = document.querySelector(\"ef-workbench\");\n    if (!workbench) {\n      throw new Error(\"No workbench found\");\n    }\n    workbench.rendering = true;\n    const timegroups = shallowGetTimegroups(workbench);\n    const firstGroup = timegroups[0];\n    if (!firstGroup) {\n      throw new Error(\"No temporal elements found\");\n    }\n\n    // Calculate base frame time using normal progression\n    const frameTime =\n      this.renderOptions.encoderOptions.fromMs +\n      frameNumber * this.frameDurationMs;\n    firstGroup.currentTimeMs = Number(Number(frameTime).toFixed(5));\n    await firstGroup.waitForFrameTasks();\n    if (this.showFrameBox) {\n      this.frameBox.innerHTML = `\n        <div>🖼️   Frame: ${frameNumber}</div>\n        <div>🕛 Segment: ${this.time.toFixed(4)}</div>\n        <div>🕛   Frame: ${firstGroup.currentTimeMs.toFixed(4)}</div>\n        <div>  from-to: ${this.renderOptions.encoderOptions.fromMs.toFixed(4)} - ${this.renderOptions.encoderOptions.toMs.toFixed(4)}</div>\n      `;\n    }\n\n    // Draw verification pixel strip for frame verification\n    this.drawVerificationStrip(frameNumber);\n\n    if (isLast && this.audioBufferPromise) {\n      // Currently we emit the audio in one belch at the end of the render.\n      // This is not ideal, but it's the simplest thing that could possibly work.\n      // We could either emit it slices, or in parallel with the video.\n      // But in any case, it's fine for now.\n      const renderedAudio = await this.audioBufferPromise;\n\n      const channelCount = renderedAudio.numberOfChannels;\n\n      const interleavedSamples = new Float32Array(\n        channelCount * renderedAudio.length,\n      );\n\n      for (let i = 0; i < renderedAudio.length; i++) {\n        for (let j = 0; j < channelCount; j++) {\n          interleavedSamples.set(\n            renderedAudio.getChannelData(j).slice(i, i + 1),\n            i * channelCount + j,\n          );\n        }\n      }\n\n      if (this.BRIDGE) {\n        this.BRIDGE.frameReady(frameNumber, interleavedSamples.buffer);\n      } else {\n        const fileReader = new FileReader();\n        fileReader.readAsDataURL(new Blob([interleavedSamples.buffer]));\n        await new Promise((resolve, reject) => {\n          fileReader.onload = resolve;\n          fileReader.onerror = reject;\n        });\n        return fileReader.result;\n      }\n    } else {\n      if (this.BRIDGE) {\n        this.BRIDGE.frameReady(frameNumber, new ArrayBuffer(0));\n      } else {\n        const fileReader = new FileReader();\n        fileReader.readAsDataURL(new Blob([]));\n        await new Promise((resolve, reject) => {\n          fileReader.onload = resolve;\n          fileReader.onerror = reject;\n        });\n        return fileReader.result;\n      }\n    }\n  }\n}\n\nif (typeof window !== \"undefined\") {\n  window.EF_FRAMEGEN = new EFFramegen();\n}\n"],"mappings":"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"}
+{"version":3,"file":"EF_FRAMEGEN.js","names":[],"sources":["../src/EF_FRAMEGEN.ts"],"sourcesContent":["import type { VideoRenderOptions } from \"@editframe/assets\";\n\nimport { shallowGetTimegroups } from \"./elements/EFTimegroup.js\";\nimport { setupBrowserTracing } from \"./otel/setupBrowserTracing.js\";\nimport {\n  clearCurrentFrameSpan,\n  enableTracing,\n  extractParentContext,\n  setCurrentFrameSpan,\n  type TraceContext,\n  withSpan,\n  withSpanAndContext,\n} from \"./otel/tracingHelpers.js\";\n\ninterface Bridge {\n  onInitialize: (\n    callback: (\n      renderOptions: VideoRenderOptions,\n      traceContext?: TraceContext,\n      otelEndpoint?: string,\n    ) => void,\n  ) => void;\n\n  initialized(): void;\n\n  onBeginFrame(\n    callback: (\n      frameNumber: number,\n      isLast: boolean,\n      traceContext?: TraceContext,\n    ) => void,\n  ): void;\n\n  onTriggerCanvas(callback: (traceContext?: TraceContext) => void): void;\n\n  frameReady(frameNumber: number, audioSamples: ArrayBuffer): void;\n\n  error(error: Error): void;\n\n  syncLog(sequence: number, message: string, callback: () => void): void;\n\n  exportSpans?: (endpoint: string, payload: string) => void;\n}\n\ndeclare global {\n  interface Window {\n    EF_FRAMEGEN?: EFFramegen;\n    FRAMEGEN_BRIDGE?: Bridge;\n    FRAMEGEN_BINDING?: any;\n    FRAMEGEN_BINDING_error?: (error: Error) => void;\n    EF_RENDERING?: () => boolean;\n  }\n}\n\nclass TriggerCanvas {\n  private canvas: HTMLCanvasElement;\n  private ctx: CanvasRenderingContext2D;\n\n  private canvasInitialized = false;\n\n  constructor() {\n    this.canvas = document.createElement(\"canvas\");\n    const ctx = this.canvas.getContext(\"2d\", { willReadFrequently: true });\n    if (!ctx) throw new Error(\"Canvas 2d context not ready\");\n    this.ctx = ctx;\n    this.ctx.fillStyle = \"transparent\";\n  }\n\n  initialize() {\n    if (this.canvasInitialized) return;\n    this.canvasInitialized = true;\n    this.canvas.width = 1;\n    this.canvas.height = 1;\n    Object.assign(this.canvas.style, {\n      position: \"fixed\",\n      top: \"0px\",\n      left: \"0px\",\n      width: \"100%\",\n      height: \"100%\",\n      zIndex: \"100000\",\n    });\n    document.body.appendChild(this.canvas);\n  }\n\n  trigger() {\n    this.ctx.clearRect(0, 0, this.canvas.width, this.canvas.height);\n  }\n}\n\nexport class EFFramegen {\n  time = 0;\n  frameDurationMs = 0;\n  audioBufferPromise?: Promise<AudioBuffer>;\n  renderOptions?: VideoRenderOptions;\n  frameBox = document.createElement(\"div\");\n  BRIDGE: typeof window.FRAMEGEN_BRIDGE;\n  triggerCanvas = new TriggerCanvas();\n  verificationCanvas?: HTMLCanvasElement;\n  verificationCtx?: CanvasRenderingContext2D;\n  private logSequence = 0;\n\n  // Frame sequence coordination\n  public frameTasksInProgress = false;\n  public currentFrameNumber = 0;\n\n  trace(...args: any[]) {\n    console.trace(\"[EF_FRAMEGEN]\", ...args);\n  }\n\n  async syncLog(...args: any[]): Promise<void> {\n    if (!this.BRIDGE) {\n      // Fallback to regular console.log if no bridge\n      console.log(\"[EF_FRAMEGEN]\", ...args);\n      return;\n    }\n\n    const sequence = ++this.logSequence;\n    const message = args\n      .map((arg) =>\n        typeof arg === \"object\" ? JSON.stringify(arg) : String(arg),\n      )\n      .join(\" \");\n\n    return new Promise<void>((resolve) => {\n      // biome-ignore lint/style/noNonNullAssertion: We know BRIDGE is set due to the guard above\n      this.BRIDGE!.syncLog(sequence, message, () => {\n        resolve();\n      });\n    });\n  }\n\n  private initializeVerificationCanvas() {\n    if (this.verificationCanvas) {\n      return;\n    }\n\n    this.verificationCanvas = document.createElement(\"canvas\");\n    const ctx = this.verificationCanvas.getContext(\"2d\");\n    if (!ctx) throw new Error(\"Verification canvas 2d context not ready\");\n    this.verificationCtx = ctx;\n\n    // Size to match the workbench width, 1 pixel height for verification strip\n    const workbench = document.querySelector(\"ef-workbench\") as HTMLElement;\n    if (workbench) {\n      this.verificationCanvas.width = workbench.clientWidth;\n      this.verificationCanvas.height = 1;\n\n      // Position at the bottom of the workbench (beyond content height)\n      Object.assign(this.verificationCanvas.style, {\n        position: \"fixed\",\n        left: \"0px\",\n        bottom: \"0px\",\n        width: `${workbench.clientWidth}px`,\n        height: \"1px\",\n        zIndex: \"99999\", // Above trigger canvas\n      });\n\n      document.body.appendChild(this.verificationCanvas);\n    }\n  }\n\n  private drawVerificationStrip(frameNumber: number) {\n    this.initializeVerificationCanvas();\n\n    if (!this.verificationCanvas || !this.verificationCtx) {\n      return;\n    }\n\n    const width = this.verificationCanvas.width;\n    const height = this.verificationCanvas.height;\n\n    // Clear the strip\n    this.verificationCtx.clearRect(0, 0, width, height);\n\n    // Encode frame number into RGB (24-bit)\n    // R=high byte, G=middle byte, B=low byte\n    const red = Math.floor(frameNumber / (256 * 256)) % 256;\n    const green = Math.floor(frameNumber / 256) % 256;\n    const blue = frameNumber % 256;\n\n    // Fill the entire strip with the encoded frame number\n    this.verificationCtx.fillStyle = `rgb(${red}, ${green}, ${blue})`;\n    this.verificationCtx.fillRect(0, 0, width, height);\n  }\n\n  constructor() {\n    this.BRIDGE = window.FRAMEGEN_BRIDGE;\n    if (this.BRIDGE) {\n      this.connectToBridge();\n    }\n  }\n\n  /**\n   * Helper method to get the workbench and set its rendering state.\n   * This ensures consistent state management across the framegen lifecycle.\n   */\n  private setWorkbenchRendering(isRendering: boolean) {\n    const workbench = document.querySelector(\"ef-workbench\");\n    if (workbench) {\n      workbench.rendering = isRendering;\n    }\n  }\n\n  connectToBridge() {\n    const BRIDGE = this.BRIDGE;\n    if (!BRIDGE) {\n      throw new Error(\"No BRIDGE when attempting to connect to bridge\");\n    }\n\n    BRIDGE.onInitialize(async (renderOptions, traceContext, otelEndpoint) => {\n      // Only enable tracing if explicitly requested in renderOptions\n      if (renderOptions.enableTracing && otelEndpoint) {\n        enableTracing();\n        await setupBrowserTracing({\n          otelEndpoint,\n          serviceName: \"telecine-browser\",\n          bridge: BRIDGE,\n          useBatching: true, // Batch spans to reduce overhead during rendering\n        });\n      }\n\n      const parentContext = extractParentContext(traceContext);\n\n      await withSpan(\n        \"browser.initialize\",\n        {\n          width: renderOptions.encoderOptions.video.width,\n          height: renderOptions.encoderOptions.video.height,\n          fps: renderOptions.encoderOptions.video.framerate,\n          durationMs:\n            renderOptions.encoderOptions.toMs -\n            renderOptions.encoderOptions.fromMs,\n        },\n        parentContext,\n        async () => {\n          try {\n            await this.initialize(renderOptions);\n          } catch (error) {\n            // If initialization fails, ensure rendering state is cleared\n            this.setWorkbenchRendering(false);\n            console.error(\n              \"[EF_FRAMEGEN.connectToBridge] error initializing\",\n              error,\n            );\n            throw error;\n          }\n        },\n      );\n\n      BRIDGE.initialized();\n    });\n\n    BRIDGE.onBeginFrame((frameNumber, isLast, traceContext) => {\n      const parentContext = extractParentContext(traceContext);\n      withSpanAndContext(\n        \"browser.frame.render\",\n        {\n          frameNumber,\n          isLast,\n        },\n        parentContext,\n        async (span, _spanContext) => {\n          // Store the span itself for child operations\n          // This allows spans created in Lit Tasks to use it as their parent\n          setCurrentFrameSpan(span);\n\n          try {\n            await this.beginFrame(frameNumber, isLast);\n          } catch (error) {\n            // If an error occurs during rendering, ensure rendering state is cleared\n            this.setWorkbenchRendering(false);\n            throw error;\n          } finally {\n            clearCurrentFrameSpan();\n          }\n        },\n      ).catch((error) => {\n        console.error(\"[EF_FRAMEGEN.beginFrame] error:\", error);\n        // Ensure rendering state is cleared on error\n        this.setWorkbenchRendering(false);\n        clearCurrentFrameSpan();\n        throw error;\n      });\n    });\n\n    BRIDGE.onTriggerCanvas((traceContext) => {\n      const parentContext = extractParentContext(traceContext);\n\n      withSpan(\"browser.canvas.trigger\", {}, parentContext, async () => {\n        this.triggerCanvas.trigger();\n      }).catch((error) => {\n        console.error(\"[EF_FRAMEGEN.triggerCanvas] error:\", error);\n      });\n    });\n  }\n\n  get showFrameBox() {\n    return this.renderOptions?.showFrameBox ?? false;\n  }\n\n  async initialize(renderOptions: VideoRenderOptions) {\n    this.renderOptions = renderOptions;\n\n    const workbench = document.querySelector(\"ef-workbench\");\n    if (!workbench) {\n      throw new Error(\"No workbench found\");\n    }\n    this.setWorkbenchRendering(true);\n    workbench.playing = false;\n    const timegroups = shallowGetTimegroups(workbench);\n    const firstGroup = timegroups[0];\n    if (!firstGroup) {\n      throw new Error(\"No temporal elements found\");\n    }\n    const startingTimeMs = renderOptions.encoderOptions.fromMs;\n    await firstGroup.waitForMediaDurations();\n    await firstGroup.waitForFrameTasks();\n\n    this.frameDurationMs = 1000 / renderOptions.encoderOptions.video.framerate;\n\n    this.time = startingTimeMs;\n    if (this.showFrameBox) {\n      Object.assign(this.frameBox.style, {\n        width: \"200px\",\n        height: \"100px\",\n        font: \"10px Arial\",\n        backgroundColor: \"white\",\n        position: \"absolute\",\n        top: \"0px\",\n        right: \"0px\",\n        zIndex: \"100000\",\n      });\n      document.body.prepend(this.frameBox);\n    }\n\n    this.triggerCanvas.initialize();\n\n    // These times are aligned to the audio frame boundaries\n    // And they include padding if any.\n    this.audioBufferPromise = firstGroup.renderAudio(\n      renderOptions.encoderOptions.alignedFromUs / 1000,\n      renderOptions.encoderOptions.alignedToUs / 1000,\n    );\n  }\n\n  async beginFrame(frameNumber: number, isLast: boolean) {\n    if (this.renderOptions === undefined) {\n      throw new Error(\"No renderOptions\");\n    }\n    const workbench = document.querySelector(\"ef-workbench\");\n    if (!workbench) {\n      throw new Error(\"No workbench found\");\n    }\n    this.setWorkbenchRendering(true);\n    const timegroups = shallowGetTimegroups(workbench);\n    const firstGroup = timegroups[0];\n    if (!firstGroup) {\n      throw new Error(\"No temporal elements found\");\n    }\n\n    // Calculate base frame time using normal progression\n    const frameTime =\n      this.renderOptions.encoderOptions.fromMs +\n      frameNumber * this.frameDurationMs;\n    firstGroup.currentTimeMs = Number(Number(frameTime).toFixed(5));\n    await firstGroup.waitForFrameTasks();\n    if (this.showFrameBox) {\n      this.frameBox.innerHTML = `\n        <div>🖼️   Frame: ${frameNumber}</div>\n        <div>🕛 Segment: ${this.time.toFixed(4)}</div>\n        <div>🕛   Frame: ${firstGroup.currentTimeMs.toFixed(4)}</div>\n        <div>  from-to: ${this.renderOptions.encoderOptions.fromMs.toFixed(4)} - ${this.renderOptions.encoderOptions.toMs.toFixed(4)}</div>\n      `;\n    }\n\n    // Draw verification pixel strip for frame verification\n    this.drawVerificationStrip(frameNumber);\n\n    if (isLast && this.audioBufferPromise) {\n      // Currently we emit the audio in one belch at the end of the render.\n      // This is not ideal, but it's the simplest thing that could possibly work.\n      // We could either emit it slices, or in parallel with the video.\n      // But in any case, it's fine for now.\n      const renderedAudio = await this.audioBufferPromise;\n\n      const channelCount = renderedAudio.numberOfChannels;\n\n      const interleavedSamples = new Float32Array(\n        channelCount * renderedAudio.length,\n      );\n\n      for (let i = 0; i < renderedAudio.length; i++) {\n        for (let j = 0; j < channelCount; j++) {\n          interleavedSamples.set(\n            renderedAudio.getChannelData(j).slice(i, i + 1),\n            i * channelCount + j,\n          );\n        }\n      }\n\n      if (this.BRIDGE) {\n        this.BRIDGE.frameReady(frameNumber, interleavedSamples.buffer);\n      } else {\n        const fileReader = new FileReader();\n        fileReader.readAsDataURL(new Blob([interleavedSamples.buffer]));\n        await new Promise((resolve, reject) => {\n          fileReader.onload = resolve;\n          fileReader.onerror = reject;\n        });\n        return fileReader.result;\n      }\n      \n      // Rendering is complete after the last frame\n      this.setWorkbenchRendering(false);\n    } else {\n      if (this.BRIDGE) {\n        this.BRIDGE.frameReady(frameNumber, new ArrayBuffer(0));\n      } else {\n        const fileReader = new FileReader();\n        fileReader.readAsDataURL(new Blob([]));\n        await new Promise((resolve, reject) => {\n          fileReader.onload = resolve;\n          fileReader.onerror = reject;\n        });\n        return fileReader.result;\n      }\n    }\n  }\n}\n\nif (typeof window !== \"undefined\") {\n  window.EF_FRAMEGEN = new EFFramegen();\n}\n"],"mappings":"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"}

package/dist/EF_INTERACTIVE.js.map

@@ -1 +1 @@
-{"version":3,"file":"EF_INTERACTIVE.js","names":[],"sources":["../src/EF_INTERACTIVE.ts"],"sourcesContent":["export let EF_INTERACTIVE = false;\n\nif (typeof window !== \"undefined\") {\n  EF_INTERACTIVE = !window.location?.search.includes(\"EF_NONINTERACTIVE\");\n}\n"],"mappings":";AAAA,IAAW,iBAAiB;AAE5B,IAAI,OAAO,WAAW,YACpB,kBAAiB,CAAC,OAAO,UAAU,OAAO,SAAS,oBAAoB"}
+{"version":3,"file":"EF_INTERACTIVE.js","names":[],"sources":["../src/EF_INTERACTIVE.ts"],"sourcesContent":["export let EF_INTERACTIVE = false;\n\nif (typeof window !== \"undefined\") {\n  EF_INTERACTIVE = !window.location?.search.includes(\"EF_NONINTERACTIVE\");\n}\n\n/**\n * Set EF_INTERACTIVE value for testing purposes.\n * @internal\n */\nexport const setEFInteractive = (value: boolean) => {\n  EF_INTERACTIVE = value;\n};\n"],"mappings":";AAAA,IAAW,iBAAiB;AAE5B,IAAI,OAAO,WAAW,YACpB,kBAAiB,CAAC,OAAO,UAAU,OAAO,SAAS,oBAAoB"}

package/dist/_virtual/rolldown_runtime.js

@@ -0,0 +1,27 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+export { __commonJS, __toESM };

package/dist/canvas/EFCanvas.d.ts

@@ -0,0 +1,311 @@
+import { TemporalMixinInterface } from "../elements/EFTemporal.js";
+import { CanvasElementData } from "./api/types.js";
+import { SelectionContext } from "./selection/selectionContext.js";
+import { PanZoomTransform } from "../elements/EFPanZoom.js";
+import * as lit33 from "lit";
+import { LitElement } from "lit";
+import * as lit_html32 from "lit-html";
+
+//#region src/canvas/EFCanvas.d.ts
+declare const EFCanvas_base: typeof LitElement;
+/**
+ * =============================================================================
+ * COORDINATE SYSTEM AND DIMENSION CALCULATION PRINCIPLES
+ * =============================================================================
+ *
+ * This canvas system uses a unified approach for calculating element positions
+ * and dimensions that works correctly regardless of CSS transforms (rotation,
+ * scale, etc.), zoom level, or nesting depth.
+ *
+ * TWO KEY DOM APIS WITH DIFFERENT BEHAVIORS:
+ *
+ * 1. offsetWidth / offsetHeight
+ *    - Returns the element's LAYOUT dimensions (CSS box model)
+ *    - These are the dimensions BEFORE any CSS transforms are applied
+ *    - UNAFFECTED by: rotation, scale, skew, or any other transform
+ *    - UNAFFECTED by: parent transforms (including zoom scale)
+ *    - AFFECTED by: CSS width/height properties, padding, border
+ *    - Units: CSS pixels in the element's own coordinate space
+ *
+ *    Example: A 200x100px element rotated 45° still has offsetWidth=200, offsetHeight=100
+ *    Example: A 200x100px element in a 2x zoomed canvas still has offsetWidth=200, offsetHeight=100
+ *
+ *    USE FOR: Getting the actual dimensions of an element in canvas coordinates
+ *
+ * 2. getBoundingClientRect()
+ *    - Returns the element's visual BOUNDING BOX on screen
+ *    - This is the axis-aligned rectangle that fully contains the transformed element
+ *    - AFFECTED by: rotation (bounding box grows), scale, all transforms
+ *    - AFFECTED by: parent transforms (including zoom scale)
+ *    - Units: Screen pixels (viewport coordinates)
+ *
+ *    Example: A 200x100px element rotated 45° has bounding box ~212x212px
+ *    Example: A 200x100px element in a 2x zoomed canvas has bounding rect 400x200px
+ *
+ *    USE FOR: Getting the visual center position (center of bounding box = element center)
+ *    NOT FOR: Getting actual dimensions (bounding box ≠ actual size when rotated)
+ *
+ * THE UNIFIED CALCULATION METHOD:
+ *
+ * For ANY element (rotated, scaled, nested, etc.):
+ *
+ * 1. DIMENSIONS: Use offsetWidth/offsetHeight
+ *    - These give us the true dimensions in canvas coordinates
+ *    - No division by scale needed - they're already in canvas space
+ *
+ * 2. CENTER POSITION: Use getBoundingClientRect() center
+ *    - screenCenterX = rect.left + rect.width / 2
+ *    - screenCenterY = rect.top + rect.height / 2
+ *    - The center of the bounding box IS the element's center
+ *    - This is true for ANY rotation (rotation around center keeps center fixed)
+ *
+ * 3. TOP-LEFT POSITION: Calculate from center and dimensions
+ *    - canvasX = canvasCenter.x - width / 2
+ *    - canvasY = canvasCenter.y - height / 2
+ *
+ * WHY THIS WORKS UNIVERSALLY:
+ *
+ * - offsetWidth/Height are defined by CSS spec to be unaffected by transforms
+ * - The center of any shape is preserved under rotation around that center
+ * - This mathematical relationship holds for ALL transform combinations
+ * - No special cases needed for rotation, scale, or nesting
+ *
+ * COMMON MISTAKES TO AVOID:
+ *
+ * ❌ Using getBoundingClientRect().width for dimensions (wrong when rotated)
+ * ❌ Dividing offsetWidth by scale (offsetWidth is already in canvas coords)
+ * ❌ Using getBoundingClientRect().left/top for position (wrong when rotated)
+ * ❌ Having different code paths for rotated vs non-rotated elements
+ *
+ * =============================================================================
+ */
+/**
+ * Main canvas container element.
+ * Manages existing elements (EF* elements, divs, etc.) and provides selection functionality.
+ */
+declare class EFCanvas extends EFCanvas_base {
+  static styles: lit33.CSSResult[];
+  panZoomTransform?: PanZoomTransform;
+  elementIdAttribute: string;
+  enableTransformHandles: boolean;
+  private elementRegistry;
+  private elementMetadata;
+  private selectionController;
+  private overlayLayer;
+  private selectionOverlay;
+  private transformHandlesMap;
+  private overlayRafId;
+  private isDragging;
+  private dragStarted;
+  private dragStartPos;
+  private dragStartCanvasPos;
+  private dragStartElementPositions;
+  private draggedElementId;
+  private capturedPointerId;
+  private readonly DRAG_THRESHOLD;
+  private isBoxSelecting;
+  private boxSelectStart;
+  private boxSelectModifierKeys;
+  private emptySpaceClickPos;
+  private selectionChangeHandler?;
+  private elementHoverHandlers;
+  private _activeRootTemporal;
+  selectionContext: SelectionContext;
+  /**
+   * The currently highlighted (hovered) element.
+   * This is the source of truth for highlight state across all panels
+   * (canvas, hierarchy, timeline).
+   */
+  highlightedElement: HTMLElement | null;
+  constructor();
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  /**
+   * Setup mutation observer to track element additions/removals.
+   */
+  private setupElementTracking;
+  /**
+   * Try to register an element, auto-generating an ID if needed.
+   * Public method for external use (e.g., hierarchy selection).
+   */
+  tryRegisterElement(element: HTMLElement): void;
+  /**
+   * Register an element for canvas management.
+   * @throws Error if element does not have an ID
+   */
+  registerElement(element: HTMLElement, id?: string): string;
+  /**
+   * Unregister an element.
+   */
+  unregisterElement(element: HTMLElement | string): void;
+  /**
+   * Setup hover event listeners for an element to update highlightedElement.
+   * The canvas is the source of truth for highlight state.
+   */
+  private setupElementHoverListeners;
+  /**
+   * Set the highlighted element. Called by canvas hover handlers
+   * and by external panels (hierarchy, timeline) when user hovers items.
+   */
+  setHighlightedElement(element: HTMLElement | null): void;
+  /**
+   * Remove hover event listeners for an element.
+   */
+  private removeElementHoverListeners;
+  /**
+   * Update element metadata from DOM.
+   *
+   * UNIFIED APPROACH - works for ALL elements regardless of rotation, scale, or nesting:
+   *
+   * 1. DIMENSIONS: Always use offsetWidth/offsetHeight
+   *    - These are layout dimensions in the element's coordinate space
+   *    - Unaffected by CSS transforms (rotation, scale, etc.)
+   *    - Already in canvas coordinates (no scale division needed)
+   *
+   * 2. CENTER POSITION: Always use getBoundingClientRect() center
+   *    - The center of the bounding box IS the element's center (transform-origin: center)
+   *    - Works correctly for rotated elements (center is rotation-invariant)
+   *    - Convert to canvas coordinates using screenToCanvas()
+   *
+   * 3. TOP-LEFT POSITION: Calculate from center and dimensions
+   *    - x = centerX - width/2
+   *    - y = centerY - height/2
+   */
+  private updateElementMetadata;
+  /**
+   * Hit test - find elements intersecting with bounds.
+   * @param bounds - DOMRect in canvas coordinate space (from SelectionModel.boxSelectBounds)
+   */
+  private hitTest;
+  /**
+   * Handle pointer down events.
+   * Only handles events when clicking on elements. Otherwise, lets panzoom handle it.
+   */
+  private handlePointerDown;
+  /**
+   * Handle pointer move events.
+   */
+  private handlePointerMove;
+  /**
+   * Handle pointer up events.
+   */
+  private handlePointerUp;
+  /**
+   * Setup listener for selection changes to update data-selected attributes.
+   */
+  private setupSelectionListener;
+  /**
+   * Remove selection change listener.
+   */
+  private removeSelectionListener;
+  /**
+   * Get the root temporal element containing the current selection.
+   * Returns null if no element is selected or the selected element has no root temporal.
+   */
+  get activeRootTemporal(): (TemporalMixinInterface & HTMLElement) | null;
+  /**
+   * Update data-selected attributes on elements based on current selection.
+   * This enables pure CSS styling of selected elements.
+   */
+  private updateSelectionAttributes;
+  /**
+   * Update element position in canvas coordinates.
+   * Unified approach: Always calculate relative to parent (or .canvas-content for direct children).
+   * For direct children, parent position is (0, 0), so relative = absolute (no-op).
+   *
+   * For nested elements, we read parent's current position from DOM (not metadata) to ensure
+   * we're always calculating relative to the actual current position.
+   */
+  updateElementPosition(elementId: string, x: number, y: number): void;
+  /**
+   * Get element metadata.
+   */
+  getElementData(elementId: string): CanvasElementData | null;
+  /**
+   * Get all element data.
+   */
+  getAllElementsData(): CanvasElementData[];
+  /**
+   * Convert screen coordinates to canvas coordinates (for API).
+   */
+  screenToCanvasCoords(screenX: number, screenY: number): {
+    x: number;
+    y: number;
+  };
+  /**
+   * Convert canvas coordinates to screen coordinates (for API).
+   */
+  canvasToScreenCoords(canvasX: number, canvasY: number): {
+    x: number;
+    y: number;
+  };
+  /**
+   * Setup overlay layer as sibling of panzoom (outside panzoom, same level as panzoom).
+   */
+  private setupOverlayLayer;
+  /**
+   * Cleanup overlay layer if we created it.
+   */
+  private cleanupOverlayLayer;
+  /**
+   * Setup selection overlay as sibling of panzoom (outside panzoom, same level as panzoom).
+   * This ensures the overlay maintains 1:1 pixel ratio regardless of zoom level.
+   */
+  private setupSelectionOverlay;
+  /**
+   * Cleanup selection overlay if we created it.
+   */
+  private cleanupSelectionOverlay;
+  /**
+   * Start RAF loop for overlay layer sync and transform handles updates.
+   */
+  private startOverlayRafLoop;
+  /**
+   * Stop RAF loop.
+   */
+  private stopOverlayRafLoop;
+  /**
+   * Update transform handles for selected elements.
+   * For multiple selections, shows a single set of handles for the bounding box.
+   */
+  private updateTransformHandles;
+  /**
+   * Update transform handles bounds for an element.
+   */
+  private updateTransformHandlesBounds;
+  /**
+   * Handle transform handles bounds-change event for multi-selection.
+   * Updates all selected elements proportionally.
+   */
+  private handleMultiSelectionTransformHandlesBoundsChange;
+  private lastMultiSelectionRotation;
+  private multiSelectionRotationCenter;
+  private multiSelectionResizeInitial;
+  /**
+   * Handle transform handles rotation-change event for multiple selected elements.
+   * Rotates all elements around the center of the bounding box.
+   */
+  private handleMultiSelectionTransformHandlesRotationChange;
+  /**
+   * Handle transform handles bounds-change event for single element.
+   * Converts bounds from overlay-relative screen coordinates to canvas coordinates.
+   */
+  private handleTransformHandlesBoundsChange;
+  /**
+   * Handle transform handles rotation-change event for single element.
+   */
+  private handleTransformHandlesRotationChange;
+  /**
+   * Cleanup transform handles.
+   */
+  private cleanupTransformHandles;
+  render(): lit_html32.TemplateResult<1>;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "ef-canvas": EFCanvas;
+  }
+}
+//#endregion
+export { EFCanvas };
+//# sourceMappingURL=EFCanvas.d.ts.map