hyperframes 0.7.80 → 0.7.81

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.7.80" : "0.0.0-dev";
+    VERSION = true ? "0.7.81" : "0.0.0-dev";
   }
 });
 
@@ -114529,7 +114529,9 @@ __export(deterministicFonts_exports, {
   FONT_ALIASES: () => FONT_ALIASES,
   FONT_ALIAS_KEYS: () => FONT_ALIAS_KEYS,
   FONT_FETCH_FAILED: () => FONT_FETCH_FAILED,
+  FONT_FETCH_UNAVAILABLE: () => FONT_FETCH_UNAVAILABLE,
   FontFetchError: () => FontFetchError,
+  FontFetchUnavailableError: () => FontFetchUnavailableError,
   GENERIC_FAMILIES: () => GENERIC_FAMILIES2,
   collectFontFamilyCustomProperties: () => collectFontFamilyCustomProperties,
   fontFormatHint: () => fontFormatHint,
@@ -114540,7 +114542,7 @@ __export(deterministicFonts_exports, {
   resolveFontFamilyDeclarationFamilies: () => resolveFontFamilyDeclarationFamilies
 });
 import { createHash as createHash11 } from "crypto";
-import { existsSync as existsSync43, mkdirSync as mkdirSync19, readFileSync as readFileSync25, writeFileSync as writeFileSync16 } from "fs";
+import { existsSync as existsSync43, mkdirSync as mkdirSync19, mkdtempSync as mkdtempSync5, readFileSync as readFileSync25, writeFileSync as writeFileSync16 } from "fs";
 import { homedir as homedir12, tmpdir as tmpdir6 } from "os";
 import { join as join39 } from "path";
 import postcss4 from "postcss";
@@ -114862,13 +114864,20 @@ function warnUnresolvedFonts(unresolved) {
   );
 }
 function resolveFontCacheRoot() {
-  return process.env.HYPERFRAMES_FONT_CACHE_DIR ?? (process.env.AWS_LAMBDA_FUNCTION_NAME ? join39(tmpdir6(), "hyperframes", "fonts") : join39(homedir12(), ".cache", "hyperframes", "fonts"));
+  if (process.env.HYPERFRAMES_FONT_CACHE_DIR) {
+    return process.env.HYPERFRAMES_FONT_CACHE_DIR;
+  }
+  if (process.env.AWS_LAMBDA_FUNCTION_NAME) {
+    lambdaFontCacheRoot ??= mkdtempSync5(join39(tmpdir6(), "hyperframes-fonts-"));
+    return lambdaFontCacheRoot;
+  }
+  return join39(homedir12(), ".cache", "hyperframes", "fonts");
 }
 function fontSlug(familyName) {
   return familyName.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
 }
 function fontCacheDir(slug) {
-  const dir = join39(GOOGLE_FONTS_CACHE_DIR, slug);
+  const dir = join39(resolveFontCacheRoot(), slug);
   if (!existsSync43(dir)) {
     mkdirSync19(dir, { recursive: true });
   }
@@ -114880,10 +114889,100 @@ function subsetToken(woff2Url) {
 function cachedWoff2Path(slug, weight, style, subset) {
   return join39(fontCacheDir(slug), `${weight}-${style}-${subset}.woff2`);
 }
-function fontFetchError(familyName, url, what, cause) {
-  const reason = "status" in cause ? `returned HTTP ${cause.status}` : `failed: ${cause.error.message}`;
+function fontFetchError(familyName, url, what, cause, unavailable = false) {
+  const reason = "status" in cause ? `returned HTTP ${cause.status}` : `failed: ${cause.error instanceof Error ? cause.error.message : String(cause.error)}`;
   const message = `[deterministicFonts] ${what} fetch for ${JSON.stringify(familyName)} ${reason}. Distributed renders require deterministic fonts; system-font fallback would produce non-byte-identical output.`;
-  return new FontFetchError(familyName, url, message, "error" in cause ? cause.error : void 0);
+  const errorCause = "error" in cause ? cause.error : void 0;
+  return unavailable ? new FontFetchUnavailableError(familyName, url, message, errorCause) : new FontFetchError(familyName, url, message, errorCause);
+}
+function isRetryableFontFetchStatus(status) {
+  return status === 408 || status === 425 || status === 429 || status >= 500;
+}
+function retryAfterMs(response) {
+  const value = response.headers.get("retry-after");
+  if (value === null) return null;
+  const seconds = Number(value);
+  if (Number.isFinite(seconds)) return Math.max(0, seconds * 1e3);
+  const date = Date.parse(value);
+  return Number.isNaN(date) ? null : Math.max(0, date - Date.now());
+}
+function callerAbortReason(signal) {
+  return signal.reason ?? new DOMException("Font fetch cancelled", "AbortError");
+}
+function throwIfCallerAborted(signal) {
+  if (signal?.aborted) throw callerAbortReason(signal);
+}
+async function waitForFontFetchRetry(delayMs, signal) {
+  throwIfCallerAborted(signal);
+  if (delayMs <= 0) return;
+  await new Promise((resolve77, reject) => {
+    const timeout = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve77();
+    }, delayMs);
+    const onAbort = () => {
+      clearTimeout(timeout);
+      reject(signal ? callerAbortReason(signal) : new DOMException("Cancelled", "AbortError"));
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+    if (signal?.aborted) onAbort();
+  });
+}
+function retryDelayMs(response, attempt, baseDelayMs) {
+  const requestedDelay = response ? retryAfterMs(response) : null;
+  if (requestedDelay !== null) return requestedDelay;
+  const ceiling = baseDelayMs * 2 ** attempt;
+  return Math.floor(Math.random() * (ceiling + 1));
+}
+function cancelResponseBody2(response) {
+  try {
+    void response.body?.cancel().catch(() => {
+    });
+  } catch {
+  }
+}
+async function runFontFetchAttempt(url, init, readBody, options, remainingMs) {
+  const timeoutSignal = AbortSignal.timeout(
+    Math.max(1, Math.min(options.retryPolicy.attemptTimeoutMs, remainingMs))
+  );
+  const signal = options.abortSignal ? AbortSignal.any([options.abortSignal, timeoutSignal]) : timeoutSignal;
+  let response;
+  try {
+    response = await options.fetchImpl(url, { ...init, signal });
+    if (!isRetryableFontFetchStatus(response.status)) {
+      if (!response.ok) return { completed: true, result: { ok: false, response } };
+      const body = await readBody(response);
+      return { completed: true, result: { ok: true, response, body } };
+    }
+    cancelResponseBody2(response);
+    return { completed: false, response, cause: { status: response.status } };
+  } catch (error) {
+    throwIfCallerAborted(options.abortSignal);
+    return { completed: false, response, cause: { error } };
+  }
+}
+async function fetchFontResource(url, init, readBody, familyName, what, options) {
+  if (!options.failClosedFontFetch) {
+    const response = await options.fetchImpl(url, { ...init, signal: options.abortSignal });
+    if (!response.ok) return { ok: false, response };
+    return { ok: true, response, body: await readBody(response) };
+  }
+  let lastCause = {
+    error: new DOMException("Font fetch budget exhausted", "TimeoutError")
+  };
+  for (let attempt = 0; attempt < options.retryPolicy.maxAttempts; attempt += 1) {
+    throwIfCallerAborted(options.abortSignal);
+    const remainingMs = options.retryDeadlineMs - Date.now();
+    if (remainingMs <= 0) break;
+    const attemptResult = await runFontFetchAttempt(url, init, readBody, options, remainingMs);
+    if (attemptResult.completed) return attemptResult.result;
+    lastCause = attemptResult.cause;
+    if (attempt + 1 >= options.retryPolicy.maxAttempts) break;
+    const delayMs = retryDelayMs(attemptResult.response, attempt, options.retryPolicy.baseDelayMs);
+    if (delayMs >= options.retryDeadlineMs - Date.now()) break;
+    await waitForFontFetchRetry(delayMs, options.abortSignal);
+  }
+  throw fontFetchError(familyName, url, what, lastCause, true);
 }
 async function ensureWoff2DataUri(cachePath2, woff2Url, familyName, weight, style, options) {
   try {
@@ -114892,15 +114991,18 @@ async function ensureWoff2DataUri(cachePath2, woff2Url, familyName, weight, styl
   }
   const woff2What = `Google Fonts woff2 (${weight}/${style})`;
   try {
-    const fontRes = await options.fetchImpl(woff2Url);
-    if (!fontRes.ok) {
-      if (fontRes.status >= 500 && options.failClosedFontFetch) {
-        throw fontFetchError(familyName, woff2Url, woff2What, { status: fontRes.status });
-      }
-      return null;
-    }
-    writeFileSync16(cachePath2, Buffer.from(await fontRes.arrayBuffer()), { flag: "wx", mode: 420 });
+    const fontResult = await fetchFontResource(
+      woff2Url,
+      void 0,
+      (response) => response.arrayBuffer(),
+      familyName,
+      woff2What,
+      options
+    );
+    if (!fontResult.ok) return null;
+    writeFileSync16(cachePath2, Buffer.from(fontResult.body), { flag: "wx", mode: 420 });
   } catch (err) {
+    throwIfCallerAborted(options.abortSignal);
     if (err instanceof FontFetchError) throw err;
     if (err.code === "EEXIST") {
     } else if (options.failClosedFontFetch) {
@@ -114919,17 +115021,20 @@ async function fetchGoogleFont(familyName, options, fontText) {
   const url = `https://fonts.googleapis.com/css2?family=${encodedFamily}:ital,wght@0,100;0,200;0,300;0,400;0,500;0,600;0,700;0,800;0,900;1,400;1,700${textParam}`;
   let cssText;
   try {
-    const res = await options.fetchImpl(url, {
-      headers: { "User-Agent": WOFF2_USER_AGENT }
-    });
-    if (!res.ok) {
-      if (res.status >= 500 && options.failClosedFontFetch) {
-        throw fontFetchError(familyName, url, "Google Fonts CSS", { status: res.status });
-      }
+    const cssResult = await fetchFontResource(
+      url,
+      { headers: { "User-Agent": WOFF2_USER_AGENT } },
+      (response) => response.text(),
+      familyName,
+      "Google Fonts CSS",
+      options
+    );
+    if (!cssResult.ok) {
       return [];
     }
-    cssText = await res.text();
+    cssText = cssResult.body;
   } catch (err) {
+    throwIfCallerAborted(options.abortSignal);
     if (err instanceof FontFetchError) throw err;
     if (options.failClosedFontFetch) {
       throw fontFetchError(familyName, url, "Google Fonts CSS", { error: err });
@@ -114970,14 +115075,38 @@ function extractGoogleFontsText(html) {
   );
   return encodeURIComponent(uniqueCharacters).length <= GOOGLE_FONTS_TEXT_MAX_ENCODED_LENGTH ? uniqueCharacters : void 0;
 }
+function resolveFontFetchRetryPolicy(configured) {
+  return {
+    maxAttempts: Math.max(
+      1,
+      Math.floor(configured?.maxAttempts ?? DEFAULT_FONT_FETCH_RETRY_POLICY.maxAttempts)
+    ),
+    attemptTimeoutMs: Math.max(
+      1,
+      configured?.attemptTimeoutMs ?? DEFAULT_FONT_FETCH_RETRY_POLICY.attemptTimeoutMs
+    ),
+    maxElapsedMs: Math.max(
+      1,
+      configured?.maxElapsedMs ?? DEFAULT_FONT_FETCH_RETRY_POLICY.maxElapsedMs
+    ),
+    baseDelayMs: Math.max(
+      0,
+      configured?.baseDelayMs ?? DEFAULT_FONT_FETCH_RETRY_POLICY.baseDelayMs
+    )
+  };
+}
 async function injectDeterministicFontFaces(html, options = {}) {
   const failClosedFontFetch = options.failClosedFontFetch === true;
   const fetchImpl = options.fetchImpl ?? fetch;
   const allowSystemFontCapture = options.allowSystemFontCapture !== false;
+  const retryPolicy = resolveFontFetchRetryPolicy(options.fontFetchRetryPolicy);
   const fetchOptions = {
     failClosedFontFetch,
     fetchImpl,
-    allowSystemFontCapture
+    allowSystemFontCapture,
+    abortSignal: options.abortSignal,
+    retryPolicy,
+    retryDeadlineMs: Date.now() + retryPolicy.maxElapsedMs
   };
   const existingFaces = extractExistingFontFaces(html);
   const requestedFamilies = extractRequestedFontFamilies(html);
@@ -115025,7 +115154,7 @@ async function injectDeterministicFontFaces(html, options = {}) {
   }
   return document2.toString();
 }
-var GENERIC_FAMILIES2, CANONICAL_FONTS, FONT_ALIASES, GOOGLE_FONTS_CACHE_DIR, WOFF2_USER_AGENT, FONT_FETCH_FAILED, FontFetchError, GOOGLE_FONTS_TEXT_MAX_ENCODED_LENGTH;
+var GENERIC_FAMILIES2, CANONICAL_FONTS, FONT_ALIASES, lambdaFontCacheRoot, WOFF2_USER_AGENT, FONT_FETCH_FAILED, FONT_FETCH_UNAVAILABLE, FontFetchError, FontFetchUnavailableError, DEFAULT_FONT_FETCH_RETRY_POLICY, GOOGLE_FONTS_TEXT_MAX_ENCODED_LENGTH;
 var init_deterministicFonts = __esm({
   "../producer/src/services/deterministicFonts.ts"() {
     "use strict";
@@ -115127,22 +115256,35 @@ var init_deterministicFonts = __esm({
       }
     };
     FONT_ALIASES = FONT_ALIAS_MAP;
-    GOOGLE_FONTS_CACHE_DIR = resolveFontCacheRoot();
     WOFF2_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36";
     FONT_FETCH_FAILED = "FONT_FETCH_FAILED";
+    FONT_FETCH_UNAVAILABLE = "FONT_FETCH_UNAVAILABLE";
     FontFetchError = class extends Error {
-      code = FONT_FETCH_FAILED;
+      code;
       familyName;
       url;
       cause;
-      constructor(familyName, url, message, cause) {
+      constructor(familyName, url, message, cause, code = FONT_FETCH_FAILED) {
         super(message);
         this.name = "FontFetchError";
+        this.code = code;
         this.familyName = familyName;
         this.url = url;
         this.cause = cause;
       }
     };
+    FontFetchUnavailableError = class extends FontFetchError {
+      constructor(familyName, url, message, cause) {
+        super(familyName, url, message, cause, FONT_FETCH_UNAVAILABLE);
+        this.name = "FontFetchUnavailableError";
+      }
+    };
+    DEFAULT_FONT_FETCH_RETRY_POLICY = {
+      maxAttempts: 2,
+      attemptTimeoutMs: 8e3,
+      maxElapsedMs: 2e4,
+      baseDelayMs: 250
+    };
     GOOGLE_FONTS_TEXT_MAX_ENCODED_LENGTH = 1700;
   }
 });
@@ -116475,7 +116617,8 @@ async function compileForRender(projectDir, htmlPath, downloadDir, options = {})
   );
   const coalescedHtml = await injectDeterministicFontFaces(normalizedFontHtml, {
     failClosedFontFetch: options.failClosedFontFetch === true,
-    allowSystemFontCapture: options.allowSystemFontCapture
+    allowSystemFontCapture: options.allowSystemFontCapture,
+    abortSignal: options.abortSignal
   });
   const assembledHtml = await inlineExternalScripts(coalescedHtml);
   const HF_POSITION_ATTRS = [
@@ -116922,13 +117065,15 @@ async function runCompileStage(input2) {
     log: log2,
     assertNotAborted,
     failClosedFontFetch,
-    allowSystemFontCapture
+    allowSystemFontCapture,
+    abortSignal
   } = input2;
   const compileStart = Date.now();
   const compiled = await compileForRender(projectDir, htmlPath, join43(workDir, "downloads"), {
     log: log2,
     failClosedFontFetch: failClosedFontFetch === true,
     allowSystemFontCapture,
+    abortSignal,
     variables: input2.variables,
     animatedGifCacheDir: cfg.extractCacheDir ? join43(cfg.extractCacheDir, "animated-gif") : void 0,
     ffmpegProcessTimeout: cfg.ffmpegProcessTimeout
@@ -119322,7 +119467,7 @@ import {
   constants as constants3,
   fstatSync as fstatSync4,
   mkdirSync as mkdirSync23,
-  mkdtempSync as mkdtempSync5,
+  mkdtempSync as mkdtempSync6,
   openSync as openSync6,
   readFileSync as readFileSync28,
   statfsSync as statfsSync2
@@ -119458,7 +119603,7 @@ async function extractHdrVideoFrames(args) {
     const video = composition.videos.find((v2) => v2.id === videoId);
     if (!video) continue;
     mkdirSync23(framesDir, { recursive: true });
-    const frameDir = mkdtempSync5(join49(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
+    const frameDir = mkdtempSync6(join49(framesDir, `hdr_${tempDirSafePrefix(videoId)}-`));
     const duration = video.end - video.start;
     const dims = prep.hdrExtractionDims.get(videoId) ?? { width, height };
     const rawPath = join49(frameDir, "frames.rgb48le");
@@ -121058,7 +121203,7 @@ var init_assembleStage = __esm({
 import {
   existsSync as existsSync50,
   mkdirSync as mkdirSync26,
-  mkdtempSync as mkdtempSync6,
+  mkdtempSync as mkdtempSync7,
   readFileSync as readFileSync29,
   readdirSync as readdirSync16,
   rmSync as rmSync16,
@@ -121578,7 +121723,7 @@ async function executeRenderJob(job, projectDir, outputPath, progressSink, abort
   const debugDir = join57(producerRoot, ".debug");
   const outputDir = dirname25(outputPath);
   if (!existsSync50(outputDir)) mkdirSync26(outputDir, { recursive: true });
-  const workDir = job.config.debug ? join57(debugDir, job.id) : mkdtempSync6(resolveRenderWorkDirPrefix(outputPath, job.id));
+  const workDir = job.config.debug ? join57(debugDir, job.id) : mkdtempSync7(resolveRenderWorkDirPrefix(outputPath, job.id));
   const pipelineStart = Date.now();
   const baseLog = job.config.logger ?? defaultLogger;
   const logPath = job.config.debug ? join57(workDir, "render.log") : null;
@@ -123774,7 +123919,7 @@ import {
   existsSync as existsSync54,
   mkdirSync as mkdirSync27,
   statSync as statSync17,
-  mkdtempSync as mkdtempSync7,
+  mkdtempSync as mkdtempSync8,
   writeFileSync as writeFileSync18,
   rmSync as rmSync17,
   createReadStream as createReadStream2
@@ -123929,7 +124074,7 @@ async function resolveInlineRenderHtml(body) {
 }
 function materializeInlineProject(html, options) {
   const tempRoot = process.env.PRODUCER_TMP_PROJECT_DIR || tmpdir9();
-  const tempProjectDir = mkdtempSync7(join60(tempRoot, "producer-project-"));
+  const tempProjectDir = mkdtempSync8(join60(tempRoot, "producer-project-"));
   writeFileSync18(join60(tempProjectDir, "index.html"), html, "utf-8");
   return {
     prepared: {
@@ -125384,6 +125529,7 @@ async function plan(projectDir, config, planDir) {
     needsAlpha,
     log: log2,
     assertNotAborted,
+    abortSignal,
     // Distributed renders fail closed on font-fetch errors so the planDir
     // is content-addressed against deterministic fonts only.
     failClosedFontFetch: config.failClosedFontFetch !== false,
@@ -125711,7 +125857,7 @@ import {
   existsSync as existsSync58,
   linkSync as linkSync2,
   mkdirSync as mkdirSync30,
-  mkdtempSync as mkdtempSync8,
+  mkdtempSync as mkdtempSync9,
   renameSync as renameSync13,
   rmSync as rmSync19,
   statSync as statSync18,
@@ -125761,7 +125907,7 @@ var init_planV2Publisher = __esm({
         this.destinationDir = destinationDir;
         this.#linkFile = options.linkFile ?? linkSync2;
         mkdirSync30(dirname29(destinationDir), { recursive: true });
-        this.temporaryDir = mkdtempSync8(join67(dirname29(destinationDir), ".plan-v2-publish-"));
+        this.temporaryDir = mkdtempSync9(join67(dirname29(destinationDir), ".plan-v2-publish-"));
       }
       async putBlob(blob) {
         const digest = assertPlanV2Sha256(blob.sha256, "published blob sha256");
@@ -125774,7 +125920,7 @@ var init_planV2Publisher = __esm({
         const destinationPath = planV2BlobPath(this.temporaryDir, digest);
         if (existsSync58(destinationPath)) return;
         mkdirSync30(dirname29(destinationPath), { recursive: true });
-        const stagingDir = mkdtempSync8(join67(dirname29(destinationPath), ".plan-v2-blob-"));
+        const stagingDir = mkdtempSync9(join67(dirname29(destinationPath), ".plan-v2-blob-"));
         const temporaryPath = join67(stagingDir, "blob");
         try {
           try {
@@ -125816,7 +125962,7 @@ import {
   existsSync as existsSync59,
   lstatSync as lstatSync6,
   mkdirSync as mkdirSync31,
-  mkdtempSync as mkdtempSync9,
+  mkdtempSync as mkdtempSync10,
   openSync as openSync7,
   readFileSync as readFileSync34,
   readSync as readSync4,
@@ -126060,7 +126206,7 @@ function computeManifestHash(manifest) {
 function writeBlob(sourcePath, destinationPath) {
   if (existsSync59(destinationPath)) return;
   mkdirSync31(dirname30(destinationPath), { recursive: true });
-  const temporaryDir = mkdtempSync9(join68(dirname30(destinationPath), ".plan-v2-blob-"));
+  const temporaryDir = mkdtempSync10(join68(dirname30(destinationPath), ".plan-v2-blob-"));
   const temporaryPath = join68(temporaryDir, "blob");
   try {
     copyFileSync8(sourcePath, temporaryPath);
@@ -126144,7 +126290,7 @@ function createPlanV2FromV1(planV1Dir, planV2Dir) {
   }
   const publication = buildPlanV2Publication(planV1Dir);
   mkdirSync31(dirname30(planV2Dir), { recursive: true });
-  const tempDir = mkdtempSync9(join68(dirname30(planV2Dir), ".plan-v2-build-"));
+  const tempDir = mkdtempSync10(join68(dirname30(planV2Dir), ".plan-v2-build-"));
   try {
     for (const blob of publication.blobs) {
       writeBlob(blob.sourcePath, planV2BlobPath(tempDir, blob.sha256));
@@ -126183,7 +126329,7 @@ async function publishPlanV2FromV1(planV1Dir, publisher) {
   }
 }
 async function planV2WithPublisher(projectDir, config, publisher, options = {}) {
-  const stagingRoot = mkdtempSync9(join68(options.stagingParentDir ?? tmpdir10(), ".plan-v2-source-"));
+  const stagingRoot = mkdtempSync10(join68(options.stagingParentDir ?? tmpdir10(), ".plan-v2-source-"));
   try {
     await plan(
       projectDir,
@@ -126388,7 +126534,7 @@ function materializePlanV2Target(planV2Dir, target, destinationDir) {
     sourcePath: verifyBlob(planV2Dir, artifact)
   }));
   mkdirSync31(dirname30(destinationDir), { recursive: true });
-  const tempDir = mkdtempSync9(join68(dirname30(destinationDir), ".plan-v2-materialize-"));
+  const tempDir = mkdtempSync10(join68(dirname30(destinationDir), ".plan-v2-materialize-"));
   try {
     for (const { artifact, sourcePath } of verified) {
       const destinationPath = join68(tempDir, ...artifact.path.split("/"));
@@ -127307,11 +127453,11 @@ var init_renderChunk = __esm({
 });
 
 // ../producer/src/services/distributed/planV2Execution.ts
-import { mkdtempSync as mkdtempSync10, rmSync as rmSync24 } from "fs";
+import { mkdtempSync as mkdtempSync11, rmSync as rmSync24 } from "fs";
 import { tmpdir as tmpdir11 } from "os";
 import { join as join71 } from "path";
 async function renderChunkV2(planV2Dir, chunkIndex, outputChunkPath) {
-  const workRoot = mkdtempSync10(join71(tmpdir11(), "hf-plan-v2-chunk-"));
+  const workRoot = mkdtempSync11(join71(tmpdir11(), "hf-plan-v2-chunk-"));
   const materializedPlanDir = join71(workRoot, "plan");
   try {
     materializePlanV2Target(planV2Dir, { role: "chunk", chunkIndex }, materializedPlanDir);
@@ -127321,7 +127467,7 @@ async function renderChunkV2(planV2Dir, chunkIndex, outputChunkPath) {
   }
 }
 async function assembleV2(planV2Dir, chunkPaths, outputPath, options) {
-  const workRoot = mkdtempSync10(join71(tmpdir11(), "hf-plan-v2-assembler-"));
+  const workRoot = mkdtempSync11(join71(tmpdir11(), "hf-plan-v2-assembler-"));
   const materializedPlanDir = join71(workRoot, "plan");
   try {
     const materialized = materializePlanV2Target(
@@ -127384,6 +127530,10 @@ __export(src_exports2, {
   CURRENT_PLAN_PROTOCOL: () => CURRENT_PLAN_PROTOCOL,
   DEFAULT_CONFIG: () => DEFAULT_CONFIG2,
   DISTRIBUTED_RENDER_CAPABILITIES: () => DISTRIBUTED_RENDER_CAPABILITIES,
+  FONT_FETCH_FAILED: () => FONT_FETCH_FAILED,
+  FONT_FETCH_UNAVAILABLE: () => FONT_FETCH_UNAVAILABLE,
+  FontFetchError: () => FontFetchError,
+  FontFetchUnavailableError: () => FontFetchUnavailableError,
   PLAN_ARTIFACT_LAYOUT: () => PLAN_ARTIFACT_LAYOUT,
   PLAN_HASH_SCHEMA: () => PLAN_HASH_SCHEMA,
   PLAN_PROTOCOL_UNSUPPORTED: () => PLAN_PROTOCOL_UNSUPPORTED,
@@ -135755,7 +135905,7 @@ __export(render_exports, {
   renderLocal: () => renderLocal,
   resolveBrowserGpuForCli: () => resolveBrowserGpuForCli
 });
-import { mkdtempSync as mkdtempSync11, readdirSync as readdirSync27, readFileSync as readFileSync53, statSync as statSync28, writeFileSync as writeFileSync30, rmSync as rmSync26 } from "fs";
+import { mkdtempSync as mkdtempSync12, readdirSync as readdirSync27, readFileSync as readFileSync53, statSync as statSync28, writeFileSync as writeFileSync30, rmSync as rmSync26 } from "fs";
 import { freemem as freemem5, tmpdir as tmpdir12 } from "os";
 import { resolve as resolve54, dirname as dirname41, join as join87, basename as basename16 } from "path";
 import { execFileSync as execFileSync11, spawn as spawn14 } from "child_process";
@@ -135823,7 +135973,7 @@ function ensureDockerImage(version2, platform10, quiet) {
   }
   if (!quiet) console.log(c.dim(`  Building Docker image: ${tag} (${platform10})...`));
   const dockerfilePath = resolveDockerfilePath();
-  const tmpDir = mkdtempSync11(join87(tmpdir12(), "hyperframes-docker-"));
+  const tmpDir = mkdtempSync12(join87(tmpdir12(), "hyperframes-docker-"));
   writeFileSync30(join87(tmpDir, "Dockerfile"), readFileSync53(dockerfilePath));
   const targetArch = platform10 === "linux/arm64" ? "arm64" : "amd64";
   try {
@@ -138401,7 +138551,7 @@ __export(validate_exports, {
   resolveNavigationTimeoutMs: () => resolveNavigationTimeoutMs,
   shouldIgnoreRequestFailure: () => shouldIgnoreRequestFailure
 });
-import { existsSync as existsSync80, mkdtempSync as mkdtempSync12, readFileSync as readFileSync56, rmSync as rmSync27 } from "fs";
+import { existsSync as existsSync80, mkdtempSync as mkdtempSync13, readFileSync as readFileSync56, rmSync as rmSync27 } from "fs";
 import { tmpdir as tmpdir13 } from "os";
 import { join as join90, dirname as dirname43 } from "path";
 import { fileURLToPath as fileURLToPath12 } from "url";
@@ -138568,7 +138718,7 @@ async function localizeRemoteAssets(html) {
   try {
     const { loadProducer: loadProducer2 } = await Promise.resolve().then(() => (init_producer(), producer_exports));
     const { localizeRemoteMediaSources: localizeRemoteMediaSources2, localizeRemoteImageSources: localizeRemoteImageSources2, localizeRemoteFontFaces: localizeRemoteFontFaces2 } = await loadProducer2();
-    dir = mkdtempSync12(join90(tmpdir13(), "hf-validate-assets-"));
+    dir = mkdtempSync13(join90(tmpdir13(), "hf-validate-assets-"));
     const assetDir = dir;
     const media = await localizeRemoteMediaSources2(html, assetDir);
     const images = await localizeRemoteImageSources2(media.html, assetDir);
@@ -145413,7 +145563,7 @@ var init_remove_background = __esm({
 
 // src/whisper/parakeet.ts
 import { execFileSync as execFileSync12 } from "child_process";
-import { existsSync as existsSync88, mkdtempSync as mkdtempSync13, readFileSync as readFileSync63, rmSync as rmSync28, writeFileSync as writeFileSync36 } from "fs";
+import { existsSync as existsSync88, mkdtempSync as mkdtempSync14, readFileSync as readFileSync63, rmSync as rmSync28, writeFileSync as writeFileSync36 } from "fs";
 import { homedir as homedir17, tmpdir as tmpdir14 } from "os";
 import { basename as basename19, extname as extname17, join as join99 } from "path";
 function isRunnable(bin) {
@@ -145483,7 +145633,7 @@ function transcribeWithParakeet(inputPath, dir, options) {
   options?.onProgress?.(
     cached2 ? "Transcribing with Parakeet..." : "Downloading Parakeet model (first run, ~600MB)..."
   );
-  const workDir = mkdtempSync13(join99(tmpdir14(), "hyperframes-parakeet-"));
+  const workDir = mkdtempSync14(join99(tmpdir14(), "hyperframes-parakeet-"));
   try {
     const argv2 = [inputPath, "--model", model, "--output-format", "json", "--output-dir", workDir];
     if (options?.language) argv2.push("--language", options.language);
@@ -187478,7 +187628,7 @@ __export(snapshot_exports, {
   resolveSnapshotVideoFrameTime: () => resolveSnapshotVideoFrameTime,
   tailFrameTime: () => tailFrameTime
 });
-import { existsSync as existsSync98, mkdtempSync as mkdtempSync14, readFileSync as readFileSync68, mkdirSync as mkdirSync49, rmSync as rmSync29, writeFileSync as writeFileSync41 } from "fs";
+import { existsSync as existsSync98, mkdtempSync as mkdtempSync15, readFileSync as readFileSync68, mkdirSync as mkdirSync49, rmSync as rmSync29, writeFileSync as writeFileSync41 } from "fs";
 import { tmpdir as tmpdir15 } from "os";
 import { resolve as resolve67, join as join106, relative as relative24, isAbsolute as isAbsolute15, basename as basename25 } from "path";
 function orbitStageSource() {
@@ -187526,7 +187676,7 @@ function requireSnapshotFfmpeg(ffmpegPath) {
   );
 }
 async function extractVideoFrameToBuffer(videoPath, timeSeconds, useVp9AlphaDecoder = false) {
-  const tmp = mkdtempSync14(join106(tmpdir15(), "hf-snapshot-frame-"));
+  const tmp = mkdtempSync15(join106(tmpdir15(), "hf-snapshot-frame-"));
   const outPath = join106(tmp, "frame.png");
   try {
     const ffmpegPath = requireSnapshotFfmpeg(findFFmpeg());
@@ -188995,7 +189145,7 @@ import {
   copyFileSync as copyFileSync10,
   existsSync as existsSync100,
   mkdirSync as mkdirSync50,
-  mkdtempSync as mkdtempSync15,
+  mkdtempSync as mkdtempSync16,
   readFileSync as readFileSync70,
   rmSync as rmSync30,
   writeFileSync as writeFileSync44
@@ -189257,7 +189407,7 @@ function frameFileNameForPath(framePath) {
   return "frame.png";
 }
 async function prepareGradeCompareTempProject(opts) {
-  const tempDir = mkdtempSync15(join107(tmpdir16(), "hf-grade-compare-"));
+  const tempDir = mkdtempSync16(join107(tmpdir16(), "hf-grade-compare-"));
   try {
     const frameFileName2 = opts.frameFileName ?? frameFileNameForPath(opts.framePath);
     writeFileSync44(join107(tempDir, frameFileName2), opts.frameBuffer);
@@ -189304,7 +189454,7 @@ function isVideoPath2(filePath) {
   return [".mp4", ".mov", ".m4v", ".webm", ".mkv", ".avi", ".mpeg", ".mpg", ".ogv"].includes(ext);
 }
 async function extractVideoFrameToBuffer2(videoPath) {
-  const tmp = mkdtempSync15(join107(tmpdir16(), "hf-grade-compare-frame-"));
+  const tmp = mkdtempSync16(join107(tmpdir16(), "hf-grade-compare-frame-"));
   const outPath = join107(tmp, "frame.png");
   try {
     const ffmpegPath = findFFmpeg();
@@ -189546,7 +189696,7 @@ __export(compare_exports, {
   parseCompareArgs: () => parseCompareArgs,
   prepareCompareVariantProjects: () => prepareCompareVariantProjects
 });
-import { cpSync as cpSync6, existsSync as existsSync101, mkdirSync as mkdirSync51, mkdtempSync as mkdtempSync16, renameSync as renameSync16, rmSync as rmSync31, statSync as statSync35 } from "fs";
+import { cpSync as cpSync6, existsSync as existsSync101, mkdirSync as mkdirSync51, mkdtempSync as mkdtempSync17, renameSync as renameSync16, rmSync as rmSync31, statSync as statSync35 } from "fs";
 import { tmpdir as tmpdir17 } from "os";
 import { basename as basename28, dirname as dirname55, extname as extname24, join as join108 } from "path";
 function defaultLabelForPath(input2) {
@@ -189647,7 +189797,7 @@ function inputError(variant) {
   );
 }
 function stageHtmlVariant(variant) {
-  const stagedDir = mkdtempSync16(join108(tmpdir17(), "hf-compare-variant-"));
+  const stagedDir = mkdtempSync17(join108(tmpdir17(), "hf-compare-variant-"));
   try {
     cpSync6(dirname55(variant.inputPath), stagedDir, {
       recursive: true,
@@ -189744,7 +189894,7 @@ async function renderCompareSheet(parsed) {
   const capResult = capCompareVariants(parsed.variants);
   const variants = capResult.variants;
   const prepared = prepareCompareVariantProjects(variants);
-  const frameDir = mkdtempSync16(join108(tmpdir17(), "hf-compare-frames-"));
+  const frameDir = mkdtempSync17(join108(tmpdir17(), "hf-compare-frames-"));
   const framePaths = [];
   try {
     let renderReadyTimedOut = false;
@@ -198837,7 +198987,7 @@ ${c.bold("ENV VARS:")}
 });
 
 // ../core/dist/figma/client.js
-function retryAfterMs(res) {
+function retryAfterMs2(res) {
   const raw = res.headers.get("retry-after");
   if (raw === null)
     return null;
@@ -198937,7 +199087,7 @@ function createFigmaClient(options) {
       res = await doFetch(`${base2}${path2}`, { headers: { "X-Figma-Token": token } });
       if (res.status !== 429 || attempt >= maxRetries)
         break;
-      const wait = retryAfterMs(res) ?? 1e3 * 2 ** attempt;
+      const wait = retryAfterMs2(res) ?? 1e3 * 2 ** attempt;
       await sleep5(wait);
     }
     await throwForStatus(res, path2, opts);

package/dist/hyperframes-player.global.js

@@ -1,4 +1,4 @@
-"use strict";var HyperframesPlayer=(()=>{var J=Object.defineProperty;var Ge=Object.getOwnPropertyDescriptor;var qe=Object.getOwnPropertyNames;var Ye=Object.prototype.hasOwnProperty;var Xe=(i,e)=>{for(var t in e)J(i,t,{get:e[t],enumerable:!0})},Ze=(i,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of qe(e))!Ye.call(i,n)&&n!==t&&J(i,n,{get:()=>e[n],enumerable:!(r=Ge(e,n))||r.enumerable});return i};var Qe=i=>Ze(J({},"__esModule",{value:!0}),i);var Lt={};Xe(Lt,{HyperframesPlayer:()=>Q,SPEED_PRESETS:()=>te,formatSpeed:()=>N,formatTime:()=>$});function ye(i){return i.hasRuntime||i.runtimeInjected?!1:!!(i.hasNestedCompositions||i.hasTimelines&&i.attempts>=5)}function I(i){return typeof i=="object"&&i!==null}function Ee(i){return I(i)&&typeof i.getDuration=="function"}function Se(i){return I(i)&&typeof i.duration=="function"&&typeof i.time=="function"&&typeof i.seek=="function"&&typeof i.play=="function"&&typeof i.pause=="function"}var Je="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.7.80/dist/hyperframe.runtime.iife.js";function D(i){if(i===null)return null;let e=Number.parseInt(i,10);return Number.isFinite(e)&&e>0?e:null}function Ke(i){let e=i?.querySelector("[data-composition-id][data-width][data-height]")??i?.querySelector("[data-width][data-height]");if(!e)return null;let t=D(e.getAttribute("data-width")),r=D(e.getAttribute("data-height"));return t!==null&&r!==null?{width:t,height:r}:null}var j=class{constructor(e,t){this._iframe=e;this._callbacks=t}_iframe;_callbacks;_interval=null;_runtimeInjected=!1;get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let e=0;this._interval=setInterval(()=>{e++;try{let t=this._iframe.contentWindow;if(!t)return;let r=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(ye({hasRuntime:r,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!r)return;let s=this._resolvePlaybackDurationAdapter(t);if(s&&s.getDuration()>0){this.stop();let l=Ke(this._iframe.contentDocument);this._callbacks.onReady({duration:s.getDuration(),adapter:s,compositionSize:l});return}}catch{}e>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{let e=this._iframe.contentWindow;return e?this._resolveDirectTimelineAdapterFromWindow(e):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(e){return this._resolveDirectTimelineAdapterFromWindow(e)}hasRuntimeBridge(e){return Reflect.get(e,"__hf")!==void 0||I(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=Je,(e.head||e.documentElement).appendChild(t),this._callbacks.onRuntimeInjected?.()}catch{}}_resolveDirectTimelineAdapterFromWindow(e){if(this.hasRuntimeBridge(e))return null;let t=Reflect.get(e,"__timelines");if(!I(t))return null;let r=Object.keys(t);if(r.length===0)return null;let n=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=n&&n in t?n:r[r.length-1],s=t[o];return Se(s)?s:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(Ee(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let r=this._resolveDirectTimelineAdapterFromWindow(e);return r?{kind:"direct-timeline",timeline:r,getDuration:()=>r.duration()}:null}};var Te=`
+"use strict";var HyperframesPlayer=(()=>{var J=Object.defineProperty;var Ge=Object.getOwnPropertyDescriptor;var qe=Object.getOwnPropertyNames;var Ye=Object.prototype.hasOwnProperty;var Xe=(i,e)=>{for(var t in e)J(i,t,{get:e[t],enumerable:!0})},Ze=(i,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of qe(e))!Ye.call(i,n)&&n!==t&&J(i,n,{get:()=>e[n],enumerable:!(r=Ge(e,n))||r.enumerable});return i};var Qe=i=>Ze(J({},"__esModule",{value:!0}),i);var Lt={};Xe(Lt,{HyperframesPlayer:()=>Q,SPEED_PRESETS:()=>te,formatSpeed:()=>N,formatTime:()=>$});function ye(i){return i.hasRuntime||i.runtimeInjected?!1:!!(i.hasNestedCompositions||i.hasTimelines&&i.attempts>=5)}function I(i){return typeof i=="object"&&i!==null}function Ee(i){return I(i)&&typeof i.getDuration=="function"}function Se(i){return I(i)&&typeof i.duration=="function"&&typeof i.time=="function"&&typeof i.seek=="function"&&typeof i.play=="function"&&typeof i.pause=="function"}var Je="https://cdn.jsdelivr.net/npm/@hyperframes/core@0.7.81/dist/hyperframe.runtime.iife.js";function D(i){if(i===null)return null;let e=Number.parseInt(i,10);return Number.isFinite(e)&&e>0?e:null}function Ke(i){let e=i?.querySelector("[data-composition-id][data-width][data-height]")??i?.querySelector("[data-width][data-height]");if(!e)return null;let t=D(e.getAttribute("data-width")),r=D(e.getAttribute("data-height"));return t!==null&&r!==null?{width:t,height:r}:null}var j=class{constructor(e,t){this._iframe=e;this._callbacks=t}_iframe;_callbacks;_interval=null;_runtimeInjected=!1;get runtimeInjected(){return this._runtimeInjected}start(){this.stop(),this._runtimeInjected=!1;let e=0;this._interval=setInterval(()=>{e++;try{let t=this._iframe.contentWindow;if(!t)return;let r=!!(t.__hf||t.__player),n=!!(t.__timelines&&Object.keys(t.__timelines).length>0),o=!!this._iframe.contentDocument?.querySelector("[data-composition-src]");if(ye({hasRuntime:r,hasTimelines:n,hasNestedCompositions:o,runtimeInjected:this._runtimeInjected,attempts:e})){this._injectRuntime();return}if(this._runtimeInjected&&!r)return;let s=this._resolvePlaybackDurationAdapter(t);if(s&&s.getDuration()>0){this.stop();let l=Ke(this._iframe.contentDocument);this._callbacks.onReady({duration:s.getDuration(),adapter:s,compositionSize:l});return}}catch{}e>=40&&(this.stop(),this._callbacks.onError("Composition timeline not found after 8s"))},200)}stop(){this._interval!==null&&(clearInterval(this._interval),this._interval=null)}resolveDirectTimelineAdapter(){try{let e=this._iframe.contentWindow;return e?this._resolveDirectTimelineAdapterFromWindow(e):null}catch{return null}}resolveDirectTimelineAdapterFromWindow(e){return this._resolveDirectTimelineAdapterFromWindow(e)}hasRuntimeBridge(e){return Reflect.get(e,"__hf")!==void 0||I(Reflect.get(e,"__player"))}_injectRuntime(){this._runtimeInjected=!0;try{let e=this._iframe.contentDocument;if(!e)return;let t=e.createElement("script");t.src=Je,(e.head||e.documentElement).appendChild(t),this._callbacks.onRuntimeInjected?.()}catch{}}_resolveDirectTimelineAdapterFromWindow(e){if(this.hasRuntimeBridge(e))return null;let t=Reflect.get(e,"__timelines");if(!I(t))return null;let r=Object.keys(t);if(r.length===0)return null;let n=this._iframe.contentDocument?.querySelector("[data-composition-id]")?.getAttribute("data-composition-id"),o=n&&n in t?n:r[r.length-1],s=t[o];return Se(s)?s:null}_resolvePlaybackDurationAdapter(e){let t=Reflect.get(e,"__player");if(Ee(t))return{kind:"runtime",getDuration:()=>t.getDuration()};let r=this._resolveDirectTimelineAdapterFromWindow(e);return r?{kind:"direct-timeline",timeline:r,getDuration:()=>r.duration()}:null}};var Te=`
   :host {
     display: block;
     position: relative;