@editframe/elements 0.33.0-beta → 0.34.6-beta

package/dist/preview/encoding/canvasEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasEncoder.js","names":["_workerPool: WorkerPool | null","dataUrl: string"],"sources":["../../../src/preview/encoding/canvasEncoder.ts"],"sourcesContent":["/**\n * Canvas encoding orchestration with worker pool support.\n * \n * Supports caching via RenderContext:\n * - For ef-image/ef-waveform: caches by element + renderVersion\n * - For ef-video: uses direct capture API with source timestamp caching\n */\n\nimport { logger } from \"../logger.js\";\nimport { WorkerPool } from \"../workers/WorkerPool.js\";\nimport { getEncoderWorkerUrl } from \"../workers/encoderWorkerInline.js\";\nimport { encodeCanvasOnMainThread } from \"./mainThreadEncoder.js\";\nimport { encodeCanvasInWorker } from \"./workerEncoder.js\";\nimport type { CanvasEncodeResult, CanvasEncodeOptions } from \"./types.js\";\nimport type { EFVideo } from \"../../elements/EFVideo.js\";\nimport type { EFSurface } from \"../../elements/EFSurface.js\";\n\n// Module-level worker pool state\nlet _workerPool: WorkerPool | null = null;\nlet _workerPoolWarningLogged = false;\n\n/**\n * Get or create the worker pool for canvas encoding.\n * Returns null if workers are not available.\n */\nfunction getWorkerPool(): WorkerPool | null {\n  if (_workerPool) {\n    return _workerPool;\n  }\n\n  // Check if workers are available\n  if (\n    typeof Worker === \"undefined\" ||\n    typeof OffscreenCanvas === \"undefined\" ||\n    typeof createImageBitmap === \"undefined\"\n  ) {\n    if (!_workerPoolWarningLogged) {\n      _workerPoolWarningLogged = true;\n      logger.warn(\n        \"[canvasEncoder] Web Workers or OffscreenCanvas not available, using main thread fallback\",\n      );\n    }\n    return null;\n  }\n\n  try {\n    // Use inline worker URL - this works in any bundler environment\n    // because the worker code is embedded in the bundle as a blob URL\n    const workerUrl = getEncoderWorkerUrl();\n    \n    _workerPool = new WorkerPool(workerUrl);\n    \n    // Check if workers were actually created\n    if (!_workerPool.isAvailable()) {\n      const reason = _workerPool.workerCount === 0 \n        ? \"no workers created (check console for errors)\" \n        : \"workers not available\";\n      _workerPool = null;\n      if (!_workerPoolWarningLogged) {\n        _workerPoolWarningLogged = true;\n        logger.warn(\n          `[canvasEncoder] Worker pool initialization failed (${reason}), using main thread fallback`,\n        );\n      }\n    }\n  } catch (error) {\n    _workerPool = null;\n    if (!_workerPoolWarningLogged) {\n      _workerPoolWarningLogged = true;\n      const errorMessage = error instanceof Error ? error.message : String(error);\n      logger.warn(\n        `[canvasEncoder] Failed to create worker pool: ${errorMessage} - using main thread fallback`,\n      );\n    }\n  }\n\n  return _workerPool;\n}\n\n/**\n * Check if an element is an EFVideo.\n */\nfunction isEFVideo(element: Element): element is EFVideo {\n  return element.tagName === \"EF-VIDEO\";\n}\n\n/**\n * Check if an element is an EFSurface.\n */\nfunction isEFSurface(element: Element): element is EFSurface {\n  return element.tagName === \"EF-SURFACE\";\n}\n\n/**\n * Encode canvases to data URLs in parallel using worker pool.\n * Falls back to main thread encoding if workers are unavailable.\n * \n * When RenderContext and sourceMap are provided:\n * - Checks cache for static elements (ef-image, ef-waveform)\n * - Uses direct capture API for ef-video elements\n * - Shares cached frames for ef-surface elements targeting ef-video\n * \n * @param canvases - Array of canvases to encode\n * @param options - Encoding options including optional renderContext and sourceMap\n * @returns Promise resolving to array of encoded results\n */\nexport async function encodeCanvasesInParallel(\n  canvases: HTMLCanvasElement[],\n  options: CanvasEncodeOptions = {},\n): Promise<CanvasEncodeResult[]> {\n  const { scale: canvasScale = 1, renderContext, sourceMap } = options;\n  const workerPool = getWorkerPool();\n\n  // Helper to encode a single canvas (with caching)\n  const encodeCanvas = async (canvas: HTMLCanvasElement): Promise<CanvasEncodeResult | null> => {\n    try {\n      if (canvas.width === 0 || canvas.height === 0) {\n        return null;\n      }\n\n      const preserveAlpha = canvas.dataset.preserveAlpha === \"true\";\n      const sourceElement = sourceMap?.get(canvas);\n\n      // OPTIMIZATION: Check RenderContext cache for static elements\n      if (renderContext && sourceElement) {\n        // For ef-video, use direct capture API\n        if (isEFVideo(sourceElement)) {\n          const sourceTimeMs = sourceElement.currentSourceTimeMs;\n          \n          // Use direct capture API (bypasses frameTask)\n          // Always use \"main\" quality for export - scrub track is only for preview scrubbing\n          try {\n            const frame = await sourceElement.captureFrameAtSourceTime(sourceTimeMs, { quality: \"main\" });\n            return { canvas, dataUrl: frame.dataUrl, preserveAlpha: false };\n          } catch (e) {\n            // Fall back to normal encoding if direct capture fails\n            logger.warn(\"[canvasEncoder] Direct capture failed, falling back to canvas encoding:\", e);\n          }\n        }\n        \n        // For ef-surface targeting ef-video, share the video's cached frame\n        if (isEFSurface(sourceElement)) {\n          const target = sourceElement.targetElement;\n          if (target && isEFVideo(target as Element)) {\n            const videoTarget = target as unknown as EFVideo;\n            const sourceTimeMs = videoTarget.currentSourceTimeMs;\n            const cached = renderContext.getCachedVideoFrame(videoTarget, sourceTimeMs);\n            if (cached) {\n              return { canvas, dataUrl: cached.dataUrl, preserveAlpha: false };\n            }\n            \n            // Capture from the target video\n            // Always use \"main\" quality for export\n            try {\n              const frame = await videoTarget.captureFrameAtSourceTime(sourceTimeMs, { quality: \"main\" });\n              renderContext.setCachedVideoFrame(videoTarget, sourceTimeMs, frame);\n              return { canvas, dataUrl: frame.dataUrl, preserveAlpha: false };\n            } catch (e) {\n              logger.warn(\"[canvasEncoder] Direct capture for surface target failed:\", e);\n            }\n          }\n        }\n        \n        // For static elements (ef-image, ef-waveform), check version-based cache\n        const cachedDataUrl = renderContext.getCachedCanvasDataUrl(sourceElement);\n        if (cachedDataUrl) {\n          return { canvas, dataUrl: cachedDataUrl, preserveAlpha };\n        }\n      }\n\n      // Standard encoding path (fallback when no RenderContext cache)\n      let sourceCanvas = canvas;\n\n      // Handle canvas scaling on main thread before encoding\n      if (canvasScale < 1) {\n        const scaledWidth = Math.floor(canvas.width * canvasScale);\n        const scaledHeight = Math.floor(canvas.height * canvasScale);\n        const scaledCanvas = document.createElement(\"canvas\");\n        scaledCanvas.width = scaledWidth;\n        scaledCanvas.height = scaledHeight;\n        const scaledCtx = scaledCanvas.getContext(\"2d\");\n        if (scaledCtx) {\n          scaledCtx.drawImage(canvas, 0, 0, scaledWidth, scaledHeight);\n          sourceCanvas = scaledCanvas;\n        }\n      }\n\n      let dataUrl: string;\n      \n      if (workerPool) {\n        // Encode in worker\n        dataUrl = await workerPool.execute((worker) =>\n          encodeCanvasInWorker(worker, sourceCanvas, preserveAlpha),\n        );\n      } else {\n        // Main thread fallback - warning already logged once in getWorkerPool()\n        const encoded = encodeCanvasOnMainThread(sourceCanvas, canvasScale);\n        if (!encoded) return null;\n        dataUrl = encoded.dataUrl;\n      }\n\n      // Cache the result for static elements\n      if (renderContext && sourceElement) {\n        renderContext.setCachedCanvasDataUrl(sourceElement, dataUrl);\n      }\n\n      return { canvas, dataUrl, preserveAlpha };\n    } catch (error) {\n      // Fallback to main thread if worker encoding fails\n      logger.warn(\"[canvasEncoder] Worker encoding failed, using main thread fallback:\", error);\n      const encoded = encodeCanvasOnMainThread(canvas, canvasScale);\n      if (encoded) {\n        logger.warn(\"[canvasEncoder] Main thread fallback succeeded\");\n        return { canvas, ...encoded };\n      }\n      \n      // Cross-origin canvas or other error - skip\n      logger.warn(\"[canvasEncoder] Main thread encoding also failed, skipping canvas:\", error);\n      return null;\n    }\n  };\n\n  // Encode all canvases in parallel\n  const encodingTasks = canvases.map(encodeCanvas);\n  const encodedResults = await Promise.all(encodingTasks);\n  const validResults = encodedResults.filter(\n    (r): r is CanvasEncodeResult => r !== null,\n  );\n  return validResults;\n}\n\n/**\n * Reset the worker pool state (for testing).\n */\nexport function resetWorkerPool(): void {\n  if (_workerPool) {\n    _workerPool.terminate();\n    _workerPool = null;\n  }\n  _workerPoolWarningLogged = false;\n}\n"],"mappings":"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"}

package/dist/preview/encoding/mainThreadEncoder.js

@@ -0,0 +1,39 @@
+//#region src/preview/encoding/mainThreadEncoder.ts
+const JPEG_QUALITY_HIGH = .92;
+const JPEG_QUALITY_MEDIUM = .85;
+/**
+* Encode a single canvas to a data URL on the main thread (fallback).
+* @param canvas - The canvas to encode
+* @param canvasScale - Scale factor for encoding (default: 1)
+* @returns Encoded result or null if encoding fails
+*/
+function encodeCanvasOnMainThread(canvas, canvasScale) {
+	try {
+		if (canvas.width === 0 || canvas.height === 0) return null;
+		const preserveAlpha = canvas.dataset.preserveAlpha === "true";
+		let dataUrl;
+		if (canvasScale < 1) {
+			const scaledWidth = Math.floor(canvas.width * canvasScale);
+			const scaledHeight = Math.floor(canvas.height * canvasScale);
+			const scaledCanvas = document.createElement("canvas");
+			scaledCanvas.width = scaledWidth;
+			scaledCanvas.height = scaledHeight;
+			const scaledCtx = scaledCanvas.getContext("2d");
+			if (scaledCtx) {
+				scaledCtx.drawImage(canvas, 0, 0, scaledWidth, scaledHeight);
+				const quality = canvasScale < .5 ? JPEG_QUALITY_MEDIUM : JPEG_QUALITY_HIGH;
+				dataUrl = preserveAlpha ? scaledCanvas.toDataURL("image/png") : scaledCanvas.toDataURL("image/jpeg", quality);
+			} else dataUrl = preserveAlpha ? canvas.toDataURL("image/png") : canvas.toDataURL("image/jpeg", JPEG_QUALITY_HIGH);
+		} else dataUrl = preserveAlpha ? canvas.toDataURL("image/png") : canvas.toDataURL("image/jpeg", JPEG_QUALITY_HIGH);
+		return {
+			dataUrl,
+			preserveAlpha
+		};
+	} catch (e) {
+		return null;
+	}
+}
+
+//#endregion
+export { encodeCanvasOnMainThread };
+//# sourceMappingURL=mainThreadEncoder.js.map

package/dist/preview/encoding/mainThreadEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mainThreadEncoder.js","names":["dataUrl: string"],"sources":["../../../src/preview/encoding/mainThreadEncoder.ts"],"sourcesContent":["/**\n * Main thread canvas encoding (fallback implementation).\n */\n\nimport type { CanvasEncodeResult } from \"./types.js\";\n\n// JPEG quality constants\nexport const JPEG_QUALITY_HIGH = 0.92;\nexport const JPEG_QUALITY_MEDIUM = 0.85;\n\n/**\n * Encode a single canvas to a data URL on the main thread (fallback).\n * @param canvas - The canvas to encode\n * @param canvasScale - Scale factor for encoding (default: 1)\n * @returns Encoded result or null if encoding fails\n */\nexport function encodeCanvasOnMainThread(\n  canvas: HTMLCanvasElement,\n  canvasScale: number,\n): { dataUrl: string; preserveAlpha: boolean } | null {\n  try {\n    if (canvas.width === 0 || canvas.height === 0) {\n      return null;\n    }\n\n    const preserveAlpha = canvas.dataset.preserveAlpha === \"true\";\n    let dataUrl: string;\n\n    if (canvasScale < 1) {\n      // Scale down canvas before encoding\n      const scaledWidth = Math.floor(canvas.width * canvasScale);\n      const scaledHeight = Math.floor(canvas.height * canvasScale);\n      const scaledCanvas = document.createElement(\"canvas\");\n      scaledCanvas.width = scaledWidth;\n      scaledCanvas.height = scaledHeight;\n      const scaledCtx = scaledCanvas.getContext(\"2d\");\n      if (scaledCtx) {\n        scaledCtx.drawImage(canvas, 0, 0, scaledWidth, scaledHeight);\n        const quality = canvasScale < 0.5 ? JPEG_QUALITY_MEDIUM : JPEG_QUALITY_HIGH;\n        dataUrl = preserveAlpha\n          ? scaledCanvas.toDataURL(\"image/png\")\n          : scaledCanvas.toDataURL(\"image/jpeg\", quality);\n      } else {\n        dataUrl = preserveAlpha\n          ? canvas.toDataURL(\"image/png\")\n          : canvas.toDataURL(\"image/jpeg\", JPEG_QUALITY_HIGH);\n      }\n    } else {\n      dataUrl = preserveAlpha\n        ? canvas.toDataURL(\"image/png\")\n        : canvas.toDataURL(\"image/jpeg\", JPEG_QUALITY_HIGH);\n    }\n\n    return { dataUrl, preserveAlpha };\n  } catch (e) {\n    // Cross-origin canvas or other error - skip\n    return null;\n  }\n}\n"],"mappings":";AAOA,MAAa,oBAAoB;AACjC,MAAa,sBAAsB;;;;;;;AAQnC,SAAgB,yBACd,QACA,aACoD;AACpD,KAAI;AACF,MAAI,OAAO,UAAU,KAAK,OAAO,WAAW,EAC1C,QAAO;EAGT,MAAM,gBAAgB,OAAO,QAAQ,kBAAkB;EACvD,IAAIA;AAEJ,MAAI,cAAc,GAAG;GAEnB,MAAM,cAAc,KAAK,MAAM,OAAO,QAAQ,YAAY;GAC1D,MAAM,eAAe,KAAK,MAAM,OAAO,SAAS,YAAY;GAC5D,MAAM,eAAe,SAAS,cAAc,SAAS;AACrD,gBAAa,QAAQ;AACrB,gBAAa,SAAS;GACtB,MAAM,YAAY,aAAa,WAAW,KAAK;AAC/C,OAAI,WAAW;AACb,cAAU,UAAU,QAAQ,GAAG,GAAG,aAAa,aAAa;IAC5D,MAAM,UAAU,cAAc,KAAM,sBAAsB;AAC1D,cAAU,gBACN,aAAa,UAAU,YAAY,GACnC,aAAa,UAAU,cAAc,QAAQ;SAEjD,WAAU,gBACN,OAAO,UAAU,YAAY,GAC7B,OAAO,UAAU,cAAc,kBAAkB;QAGvD,WAAU,gBACN,OAAO,UAAU,YAAY,GAC7B,OAAO,UAAU,cAAc,kBAAkB;AAGvD,SAAO;GAAE;GAAS;GAAe;UAC1B,GAAG;AAEV,SAAO"}

package/dist/preview/encoding/types.d.ts

@@ -0,0 +1 @@
+import "../RenderContext.js";

package/dist/preview/encoding/workerEncoder.js

@@ -0,0 +1,58 @@
+//#region src/preview/encoding/workerEncoder.ts
+/**
+* Worker-based canvas encoding.
+*/
+const WORKER_TASK_TIMEOUT_MS = 3e4;
+/**
+* Encode a canvas using a worker.
+* @param worker - The worker to use for encoding
+* @param canvas - The canvas to encode
+* @param preserveAlpha - Whether to preserve alpha channel (PNG vs JPEG)
+* @returns Promise resolving to the encoded data URL
+*/
+async function encodeCanvasInWorker(worker, canvas, preserveAlpha) {
+	return new Promise((resolve, reject) => {
+		const taskId = `task-${Date.now()}-${Math.random()}-${performance.now()}`;
+		let timeoutId = null;
+		const cleanup = () => {
+			if (timeoutId !== null) {
+				clearTimeout(timeoutId);
+				timeoutId = null;
+			}
+			worker.removeEventListener("message", messageHandler);
+			worker.removeEventListener("messageerror", messageErrorHandler);
+		};
+		const messageHandler = (event) => {
+			const result = event.data;
+			if (result.taskId === taskId) {
+				cleanup();
+				if (result.error) reject(/* @__PURE__ */ new Error(`Worker encoding failed: ${result.error}`));
+				else resolve(result.dataUrl);
+			}
+		};
+		const messageErrorHandler = () => {
+			cleanup();
+			reject(/* @__PURE__ */ new Error("Worker message error"));
+		};
+		worker.addEventListener("message", messageHandler);
+		worker.addEventListener("messageerror", messageErrorHandler);
+		timeoutId = window.setTimeout(() => {
+			cleanup();
+			reject(/* @__PURE__ */ new Error("Worker task timed out"));
+		}, WORKER_TASK_TIMEOUT_MS);
+		createImageBitmap(canvas).then((bitmap) => {
+			worker.postMessage({
+				taskId,
+				bitmap,
+				preserveAlpha
+			}, [bitmap]);
+		}).catch((error) => {
+			cleanup();
+			reject(error instanceof Error ? error : new Error(String(error)));
+		});
+	});
+}
+
+//#endregion
+export { encodeCanvasInWorker };
+//# sourceMappingURL=workerEncoder.js.map

package/dist/preview/encoding/workerEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerEncoder.js","names":["timeoutId: number | null"],"sources":["../../../src/preview/encoding/workerEncoder.ts"],"sourcesContent":["/**\n * Worker-based canvas encoding.\n */\n\nconst WORKER_TASK_TIMEOUT_MS = 30000;\n\n/**\n * Encode a canvas using a worker.\n * @param worker - The worker to use for encoding\n * @param canvas - The canvas to encode\n * @param preserveAlpha - Whether to preserve alpha channel (PNG vs JPEG)\n * @returns Promise resolving to the encoded data URL\n */\nexport async function encodeCanvasInWorker(\n  worker: Worker,\n  canvas: HTMLCanvasElement,\n  preserveAlpha: boolean,\n): Promise<string> {\n  return new Promise<string>((resolve, reject) => {\n    const taskId = `task-${Date.now()}-${Math.random()}-${performance.now()}`;\n    let timeoutId: number | null = null;\n\n    const cleanup = () => {\n      if (timeoutId !== null) {\n        clearTimeout(timeoutId);\n        timeoutId = null;\n      }\n      worker.removeEventListener(\"message\", messageHandler);\n      worker.removeEventListener(\"messageerror\", messageErrorHandler);\n    };\n\n    const messageHandler = (event: MessageEvent) => {\n      const result = event.data as { taskId: string; dataUrl: string; error?: string };\n      if (result.taskId === taskId) {\n        cleanup();\n        if (result.error) {\n          reject(new Error(`Worker encoding failed: ${result.error}`));\n        } else {\n          resolve(result.dataUrl);\n        }\n      }\n    };\n\n    const messageErrorHandler = () => {\n      cleanup();\n      reject(new Error(\"Worker message error\"));\n    };\n\n    worker.addEventListener(\"message\", messageHandler);\n    worker.addEventListener(\"messageerror\", messageErrorHandler);\n\n    // Set timeout to detect if worker never responds\n    timeoutId = window.setTimeout(() => {\n      cleanup();\n      reject(new Error(\"Worker task timed out\"));\n    }, WORKER_TASK_TIMEOUT_MS);\n\n    // Create ImageBitmap from canvas\n    createImageBitmap(canvas)\n      .then((bitmap) => {\n        // Transfer bitmap to worker (zero-copy)\n        worker.postMessage(\n          {\n            taskId,\n            bitmap,\n            preserveAlpha,\n          },\n          [bitmap],\n        );\n      })\n      .catch((error) => {\n        cleanup();\n        reject(error instanceof Error ? error : new Error(String(error)));\n      });\n  });\n}\n"],"mappings":";;;;AAIA,MAAM,yBAAyB;;;;;;;;AAS/B,eAAsB,qBACpB,QACA,QACA,eACiB;AACjB,QAAO,IAAI,SAAiB,SAAS,WAAW;EAC9C,MAAM,SAAS,QAAQ,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG,YAAY,KAAK;EACvE,IAAIA,YAA2B;EAE/B,MAAM,gBAAgB;AACpB,OAAI,cAAc,MAAM;AACtB,iBAAa,UAAU;AACvB,gBAAY;;AAEd,UAAO,oBAAoB,WAAW,eAAe;AACrD,UAAO,oBAAoB,gBAAgB,oBAAoB;;EAGjE,MAAM,kBAAkB,UAAwB;GAC9C,MAAM,SAAS,MAAM;AACrB,OAAI,OAAO,WAAW,QAAQ;AAC5B,aAAS;AACT,QAAI,OAAO,MACT,wBAAO,IAAI,MAAM,2BAA2B,OAAO,QAAQ,CAAC;QAE5D,SAAQ,OAAO,QAAQ;;;EAK7B,MAAM,4BAA4B;AAChC,YAAS;AACT,0BAAO,IAAI,MAAM,uBAAuB,CAAC;;AAG3C,SAAO,iBAAiB,WAAW,eAAe;AAClD,SAAO,iBAAiB,gBAAgB,oBAAoB;AAG5D,cAAY,OAAO,iBAAiB;AAClC,YAAS;AACT,0BAAO,IAAI,MAAM,wBAAwB,CAAC;KACzC,uBAAuB;AAG1B,oBAAkB,OAAO,CACtB,MAAM,WAAW;AAEhB,UAAO,YACL;IACE;IACA;IACA;IACD,EACD,CAAC,OAAO,CACT;IACD,CACD,OAAO,UAAU;AAChB,YAAS;AACT,UAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC,CAAC;IACjE;GACJ"}

package/dist/preview/logger.js

@@ -0,0 +1,41 @@
+//#region src/preview/logger.ts
+const LOG_LEVELS = {
+	debug: 0,
+	info: 1,
+	warn: 2,
+	error: 3,
+	silent: 4
+};
+function getLogLevel() {
+	if (typeof globalThis !== "undefined" && "EF_LOG_LEVEL" in globalThis) {
+		const level = globalThis.EF_LOG_LEVEL;
+		if (level && level in LOG_LEVELS) return level;
+	}
+	if (typeof process !== "undefined" && process.env?.EF_LOG_LEVEL) {
+		const level = process.env.EF_LOG_LEVEL;
+		if (level in LOG_LEVELS) return level;
+	}
+	return "silent";
+}
+function shouldLog(level) {
+	const currentLevel = getLogLevel();
+	return LOG_LEVELS[level] >= LOG_LEVELS[currentLevel];
+}
+const logger = {
+	debug: (...args) => {
+		if (shouldLog("debug")) console.log(...args);
+	},
+	info: (...args) => {
+		if (shouldLog("info")) console.log(...args);
+	},
+	warn: (...args) => {
+		if (shouldLog("warn")) console.warn(...args);
+	},
+	error: (...args) => {
+		if (shouldLog("error")) console.error(...args);
+	}
+};
+
+//#endregion
+export { logger };
+//# sourceMappingURL=logger.js.map

package/dist/preview/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","names":["LOG_LEVELS: Record<LogLevel, number>"],"sources":["../../src/preview/logger.ts"],"sourcesContent":["/**\n * Centralized logging utility for the preview module.\n * \n * Logging is disabled by default. To enable logging, set:\n * - Environment variable: EF_LOG_LEVEL=debug (or info, warn, error)\n * - Global flag: globalThis.EF_LOG_LEVEL = 'debug'\n * \n * Log levels (in order of verbosity):\n * - debug: All logs including performance metrics\n * - info: Informational messages\n * - warn: Warnings\n * - error: Errors only\n * - silent: No logging (default)\n */\n\ntype LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';\n\nconst LOG_LEVELS: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n  silent: 4,\n};\n\nfunction getLogLevel(): LogLevel {\n  // Check global flag first\n  if (typeof globalThis !== 'undefined' && 'EF_LOG_LEVEL' in globalThis) {\n    const level = (globalThis as { EF_LOG_LEVEL?: string }).EF_LOG_LEVEL;\n    if (level && level in LOG_LEVELS) {\n      return level as LogLevel;\n    }\n  }\n  \n  // Check environment variable (works in Node.js and some bundlers)\n  if (typeof process !== 'undefined' && process.env?.EF_LOG_LEVEL) {\n    const level = process.env.EF_LOG_LEVEL;\n    if (level in LOG_LEVELS) {\n      return level as LogLevel;\n    }\n  }\n  \n  // Default to silent\n  return 'silent';\n}\n\nfunction shouldLog(level: LogLevel): boolean {\n  const currentLevel = getLogLevel();\n  return LOG_LEVELS[level] >= LOG_LEVELS[currentLevel];\n}\n\nexport const logger = {\n  debug: (...args: unknown[]): void => {\n    if (shouldLog('debug')) {\n      console.log(...args);\n    }\n  },\n  \n  info: (...args: unknown[]): void => {\n    if (shouldLog('info')) {\n      console.log(...args);\n    }\n  },\n  \n  warn: (...args: unknown[]): void => {\n    if (shouldLog('warn')) {\n      console.warn(...args);\n    }\n  },\n  \n  error: (...args: unknown[]): void => {\n    if (shouldLog('error')) {\n      console.error(...args);\n    }\n  },\n};\n"],"mappings":";AAiBA,MAAMA,aAAuC;CAC3C,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,QAAQ;CACT;AAED,SAAS,cAAwB;AAE/B,KAAI,OAAO,eAAe,eAAe,kBAAkB,YAAY;EACrE,MAAM,QAAS,WAAyC;AACxD,MAAI,SAAS,SAAS,WACpB,QAAO;;AAKX,KAAI,OAAO,YAAY,eAAe,QAAQ,KAAK,cAAc;EAC/D,MAAM,QAAQ,QAAQ,IAAI;AAC1B,MAAI,SAAS,WACX,QAAO;;AAKX,QAAO;;AAGT,SAAS,UAAU,OAA0B;CAC3C,MAAM,eAAe,aAAa;AAClC,QAAO,WAAW,UAAU,WAAW;;AAGzC,MAAa,SAAS;CACpB,QAAQ,GAAG,SAA0B;AACnC,MAAI,UAAU,QAAQ,CACpB,SAAQ,IAAI,GAAG,KAAK;;CAIxB,OAAO,GAAG,SAA0B;AAClC,MAAI,UAAU,OAAO,CACnB,SAAQ,IAAI,GAAG,KAAK;;CAIxB,OAAO,GAAG,SAA0B;AAClC,MAAI,UAAU,OAAO,CACnB,SAAQ,KAAK,GAAG,KAAK;;CAIzB,QAAQ,GAAG,SAA0B;AACnC,MAAI,UAAU,QAAQ,CACpB,SAAQ,MAAM,GAAG,KAAK;;CAG3B"}

package/dist/preview/previewTypes.js

@@ -8,18 +8,22 @@ function isTemporal(el) {
 /**
 * Get temporal bounds for an element, treating invalid ranges as unbounded.
 * Invalid range (end <= start) means element hasn't computed its duration yet.
+* 
+* NOTE: No caching - bounds are computed dynamically by timegroups based on
+* composition mode (sequence/contain/fit) and may change between frames.
 */
 function getTemporalBounds(el) {
 	if (!isTemporal(el)) return {
 		startMs: -Infinity,
 		endMs: Infinity
 	};
-	const startMs = el.startTimeMs ?? -Infinity;
-	const endMs = el.endTimeMs ?? Infinity;
-	if (endMs <= startMs) return {
-		startMs: -Infinity,
-		endMs: Infinity
-	};
+	const temporal = el;
+	let startMs = temporal.startTimeMs ?? -Infinity;
+	let endMs = temporal.endTimeMs ?? Infinity;
+	if (endMs <= startMs) {
+		startMs = -Infinity;
+		endMs = Infinity;
+	}
 	return {
 		startMs,
 		endMs
@@ -39,9 +43,6 @@ const DEFAULT_HEIGHT = 1080;
 const DEFAULT_THUMBNAIL_SCALE = .25;
 /** Default timeout for blocking content readiness mode (ms) */
 const DEFAULT_BLOCKING_TIMEOUT_MS = 5e3;
-/** JPEG quality settings for different canvas scales */
-const JPEG_QUALITY_HIGH = .95;
-const JPEG_QUALITY_MEDIUM = .85;
 /**
 * Create a preview container with standard styling.
 * Consolidates the repeated container creation pattern across preview functions.
@@ -60,5 +61,5 @@ function createPreviewContainer(options) {
 }
 
 //#endregion
-export { DEFAULT_BLOCKING_TIMEOUT_MS, DEFAULT_HEIGHT, DEFAULT_THUMBNAIL_SCALE, DEFAULT_WIDTH, JPEG_QUALITY_HIGH, JPEG_QUALITY_MEDIUM, createPreviewContainer, getTemporalBounds, isTemporal, isVisibleAtTime };
+export { DEFAULT_BLOCKING_TIMEOUT_MS, DEFAULT_HEIGHT, DEFAULT_THUMBNAIL_SCALE, DEFAULT_WIDTH, createPreviewContainer, getTemporalBounds, isTemporal, isVisibleAtTime };
 //# sourceMappingURL=previewTypes.js.map

package/dist/preview/previewTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"previewTypes.js","names":[],"sources":["../../src/preview/previewTypes.ts"],"sourcesContent":["/**\n * Shared types and constants for preview rendering.\n * \n * Consolidates duplicate definitions from renderTimegroupToCanvas.ts and\n * renderTimegroupPreview.ts into a single source of truth.\n */\n\n// ============================================================================\n// Temporal Types\n// ============================================================================\n\n/**\n * Element with temporal properties (startTimeMs, endTimeMs).\n * Used for temporal visibility checks during preview rendering.\n */\nexport interface TemporalElement extends Element {\n  startTimeMs?: number;\n  endTimeMs?: number;\n  src?: string;\n}\n\n/**\n * Type guard to check if an element has temporal properties.\n */\nexport function isTemporal(el: Element): el is TemporalElement {\n  return \"startTimeMs\" in el && \"endTimeMs\" in el;\n}\n\n/**\n * Get temporal bounds for an element, treating invalid ranges as unbounded.\n * Invalid range (end <= start) means element hasn't computed its duration yet.\n */\nexport function getTemporalBounds(el: Element): { startMs: number; endMs: number } {\n  if (!isTemporal(el)) return { startMs: -Infinity, endMs: Infinity };\n\n  const startMs = el.startTimeMs ?? -Infinity;\n  const endMs = el.endTimeMs ?? Infinity;\n\n  // Invalid range (end <= start) means element hasn't computed its duration yet\n  if (endMs <= startMs) return { startMs: -Infinity, endMs: Infinity };\n\n  return { startMs, endMs };\n}\n\n/**\n * Check if an element is temporally visible at the given time.\n */\nexport function isVisibleAtTime(element: Element, timeMs: number): boolean {\n  const { startMs, endMs } = getTemporalBounds(element);\n  return timeMs >= startMs && timeMs <= endMs;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** Default timegroup dimensions when not measurable */\nexport const DEFAULT_WIDTH = 1920;\nexport const DEFAULT_HEIGHT = 1080;\n\n/** Default scale for thumbnail captures */\nexport const DEFAULT_THUMBNAIL_SCALE = 0.25;\n\n/** Default timeout for blocking content readiness mode (ms) */\nexport const DEFAULT_BLOCKING_TIMEOUT_MS = 5000;\n\n/** JPEG quality settings for different canvas scales */\nexport const JPEG_QUALITY_HIGH = 0.95;\nexport const JPEG_QUALITY_MEDIUM = 0.85;\n\n// ============================================================================\n// Container Creation\n// ============================================================================\n\n/**\n * Options for creating a preview container.\n */\nexport interface PreviewContainerOptions {\n  width: number;\n  height: number;\n  background?: string;\n  position?: \"relative\" | \"absolute\" | \"fixed\";\n}\n\n/**\n * Create a preview container with standard styling.\n * Consolidates the repeated container creation pattern across preview functions.\n */\nexport function createPreviewContainer(options: PreviewContainerOptions): HTMLDivElement {\n  const { width, height, background = \"#000\", position = \"relative\" } = options;\n\n  const container = document.createElement(\"div\");\n  container.style.cssText = `\n    width: ${width}px;\n    height: ${height}px;\n    position: ${position};\n    overflow: hidden;\n    background: ${background};\n  `;\n  return container;\n}\n\n// ============================================================================\n// Style Injection\n// ============================================================================\n\n/**\n * Inject document styles into a container for foreignObject rendering.\n * SVG foreignObject needs all CSS rules inlined since it can't access\n * the document's stylesheets.\n */\nexport function injectDocumentStyles(\n  container: HTMLElement,\n  collectStyles: () => string,\n): HTMLStyleElement {\n  const styleEl = document.createElement(\"style\");\n  styleEl.textContent = collectStyles();\n  container.appendChild(styleEl);\n  return styleEl;\n}\n"],"mappings":";;;;AAwBA,SAAgB,WAAW,IAAoC;AAC7D,QAAO,iBAAiB,MAAM,eAAe;;;;;;AAO/C,SAAgB,kBAAkB,IAAiD;AACjF,KAAI,CAAC,WAAW,GAAG,CAAE,QAAO;EAAE,SAAS;EAAW,OAAO;EAAU;CAEnE,MAAM,UAAU,GAAG,eAAe;CAClC,MAAM,QAAQ,GAAG,aAAa;AAG9B,KAAI,SAAS,QAAS,QAAO;EAAE,SAAS;EAAW,OAAO;EAAU;AAEpE,QAAO;EAAE;EAAS;EAAO;;;;;AAM3B,SAAgB,gBAAgB,SAAkB,QAAyB;CACzE,MAAM,EAAE,SAAS,UAAU,kBAAkB,QAAQ;AACrD,QAAO,UAAU,WAAW,UAAU;;;AAQxC,MAAa,gBAAgB;AAC7B,MAAa,iBAAiB;;AAG9B,MAAa,0BAA0B;;AAGvC,MAAa,8BAA8B;;AAG3C,MAAa,oBAAoB;AACjC,MAAa,sBAAsB;;;;;AAoBnC,SAAgB,uBAAuB,SAAkD;CACvF,MAAM,EAAE,OAAO,QAAQ,aAAa,QAAQ,WAAW,eAAe;CAEtE,MAAM,YAAY,SAAS,cAAc,MAAM;AAC/C,WAAU,MAAM,UAAU;aACf,MAAM;cACL,OAAO;gBACL,SAAS;;kBAEP,WAAW;;AAE3B,QAAO"}
+{"version":3,"file":"previewTypes.js","names":[],"sources":["../../src/preview/previewTypes.ts"],"sourcesContent":["/**\n * Shared types and constants for preview rendering.\n * \n * Consolidates duplicate definitions from renderTimegroupToCanvas.ts and\n * renderTimegroupPreview.ts into a single source of truth.\n */\n\n// ============================================================================\n// Temporal Types\n// ============================================================================\n\n/**\n * Element with temporal properties (startTimeMs, endTimeMs).\n * Used for temporal visibility checks during preview rendering.\n */\nexport interface TemporalElement extends Element {\n  startTimeMs?: number;\n  endTimeMs?: number;\n  src?: string;\n}\n\n/**\n * Type guard to check if an element has temporal properties.\n */\nexport function isTemporal(el: Element): el is TemporalElement {\n  return \"startTimeMs\" in el && \"endTimeMs\" in el;\n}\n\n/**\n * Get temporal bounds for an element, treating invalid ranges as unbounded.\n * Invalid range (end <= start) means element hasn't computed its duration yet.\n * \n * NOTE: No caching - bounds are computed dynamically by timegroups based on\n * composition mode (sequence/contain/fit) and may change between frames.\n */\nexport function getTemporalBounds(el: Element): { startMs: number; endMs: number } {\n  // Non-temporal elements are always visible\n  if (!isTemporal(el)) {\n    return { startMs: -Infinity, endMs: Infinity };\n  }\n\n  // Compute bounds fresh each time\n  const temporal = el as TemporalElement;\n  let startMs = temporal.startTimeMs ?? -Infinity;\n  let endMs = temporal.endTimeMs ?? Infinity;\n\n  // If end <= start, treat as always visible (element hasn't computed duration yet)\n  if (endMs <= startMs) {\n    startMs = -Infinity;\n    endMs = Infinity;\n  }\n\n  return { startMs, endMs };\n}\n\n/**\n * Check if an element is temporally visible at the given time.\n */\nexport function isVisibleAtTime(element: Element, timeMs: number): boolean {\n  const { startMs, endMs } = getTemporalBounds(element);\n  return timeMs >= startMs && timeMs <= endMs;\n}\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** Default timegroup dimensions when not measurable */\nexport const DEFAULT_WIDTH = 1920;\nexport const DEFAULT_HEIGHT = 1080;\n\n/** Default scale for thumbnail captures */\nexport const DEFAULT_THUMBNAIL_SCALE = 0.25;\n\n/** Default timeout for blocking content readiness mode (ms) */\nexport const DEFAULT_BLOCKING_TIMEOUT_MS = 5000;\n\n// ============================================================================\n// Container Creation\n// ============================================================================\n\n/**\n * Options for creating a preview container.\n */\nexport interface PreviewContainerOptions {\n  width: number;\n  height: number;\n  background?: string;\n  position?: \"relative\" | \"absolute\" | \"fixed\";\n}\n\n/**\n * Create a preview container with standard styling.\n * Consolidates the repeated container creation pattern across preview functions.\n */\nexport function createPreviewContainer(options: PreviewContainerOptions): HTMLDivElement {\n  const { width, height, background = \"#000\", position = \"relative\" } = options;\n\n  const container = document.createElement(\"div\");\n  container.style.cssText = `\n    width: ${width}px;\n    height: ${height}px;\n    position: ${position};\n    overflow: hidden;\n    background: ${background};\n  `;\n  return container;\n}\n\n// ============================================================================\n// Style Injection\n// ============================================================================\n\n/**\n * Inject document styles into a container for foreignObject rendering.\n * SVG foreignObject needs all CSS rules inlined since it can't access\n * the document's stylesheets.\n */\nexport function injectDocumentStyles(\n  container: HTMLElement,\n  collectStyles: () => string,\n): HTMLStyleElement {\n  const styleEl = document.createElement(\"style\");\n  styleEl.textContent = collectStyles();\n  container.appendChild(styleEl);\n  return styleEl;\n}\n"],"mappings":";;;;AAwBA,SAAgB,WAAW,IAAoC;AAC7D,QAAO,iBAAiB,MAAM,eAAe;;;;;;;;;AAU/C,SAAgB,kBAAkB,IAAiD;AAEjF,KAAI,CAAC,WAAW,GAAG,CACjB,QAAO;EAAE,SAAS;EAAW,OAAO;EAAU;CAIhD,MAAM,WAAW;CACjB,IAAI,UAAU,SAAS,eAAe;CACtC,IAAI,QAAQ,SAAS,aAAa;AAGlC,KAAI,SAAS,SAAS;AACpB,YAAU;AACV,UAAQ;;AAGV,QAAO;EAAE;EAAS;EAAO;;;;;AAM3B,SAAgB,gBAAgB,SAAkB,QAAyB;CACzE,MAAM,EAAE,SAAS,UAAU,kBAAkB,QAAQ;AACrD,QAAO,UAAU,WAAW,UAAU;;;AAQxC,MAAa,gBAAgB;AAC7B,MAAa,iBAAiB;;AAG9B,MAAa,0BAA0B;;AAGvC,MAAa,8BAA8B;;;;;AAoB3C,SAAgB,uBAAuB,SAAkD;CACvF,MAAM,EAAE,OAAO,QAAQ,aAAa,QAAQ,WAAW,eAAe;CAEtE,MAAM,YAAY,SAAS,cAAc,MAAM;AAC/C,WAAU,MAAM,UAAU;aACf,MAAM;cACL,OAAO;gBACL,SAAS;;kBAEP,WAAW;;AAE3B,QAAO"}