@cueframe/kernel 0.2.32 → 0.2.33

package/dist/_members/errors/registry.d.ts

@@ -5,6 +5,8 @@ export interface ErrorSpec {
     category: ErrorCategory;
     retryable: boolean;
     httpStatus: number;
+    /** Overrides the derived wait; see `retryAfterSecondsFor`. */
+    retryAfterSeconds?: number;
 }
 export declare const ERROR_CODES: {
     readonly unauthorized: {
@@ -1649,6 +1651,8 @@ export declare class CueframeError extends Error {
 export declare function encodeError(e: CueframeError): string;
 export declare function decodeError(msg: string): CueframeError | null;
 export declare function scrubSensitive(s: string): string;
+/** Seconds to wait before retrying, or undefined when retrying will not help. */
+export declare function retryAfterSecondsFor(code: ErrorCode): number | undefined;
 export declare function toWireEnvelope(e: Envelope, opts?: {
     trusted?: boolean;
 }): Envelope;

package/dist/_members/render-harness/assetRefs.d.ts

@@ -0,0 +1,26 @@
+/**
+ * What counts as a reference to something OUTSIDE this document.
+ *
+ * Two guards ask that question about card HTML — `cardAssetAdmission`'s CSS/HTML
+ * walk and `renderInputAssets`'s `suspiciousUnannotatedAsset` sweep — and they
+ * disagreed. The walk knew that `url(#local-id)` is a same-document fragment;
+ * the sweep matched a bare `url(` and refused it.
+ *
+ * The visible cost: an inline `<svg>` using `clip-path="url(#mark-clip)"` passed
+ * the guard that understands SVG and was refused by the one that does not, so the
+ * org's own logo could not be inlined without rewriting it (CUE-31 sibling,
+ * reported 2026-09-17). A fragment reference is the OPPOSITE of remote — it
+ * cannot leave the document — and every guard has to agree on that.
+ *
+ * One definition, imported by both.
+ */
+/** `url(#id)`, `href="#id"` — resolves inside this document, never over a network. */
+export declare function isFragmentReference(value: string): boolean;
+/** Every `url(...)` payload in a CSS value, unquoted. */
+export declare function cssUrlPayloads(value: string): string[];
+/**
+ * Does this CSS value reach outside the document? True only when it carries a
+ * `url()` whose payload is not a same-document fragment.
+ */
+export declare function hasNonFragmentCssUrl(value: string): boolean;
+//# sourceMappingURL=assetRefs.d.ts.map

package/dist/_members/render-harness/assetRefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetRefs.d.ts","sourceRoot":"","sources":["../src/assetRefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAI3D"}

package/dist/_members/render-harness/cardAssetAdmission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cardAssetAdmission.d.ts","sourceRoot":"","sources":["../src/cardAssetAdmission.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA+GzD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAQhE"}
+{"version":3,"file":"cardAssetAdmission.d.ts","sourceRoot":"","sources":["../src/cardAssetAdmission.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA4GzD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAQhE"}

package/dist/_members/render-harness/cardFonts.d.ts

@@ -0,0 +1,13 @@
+/** The `font-family` stacks a card's HTML declares, deduplicated. */
+export declare function cardFontFamilyStacks(html: string): string[];
+/**
+ * The bundled families a card's HTML names, in the order a renderer should load them.
+ *
+ * The loader half of the same question `assertCardFontsAdmitted` gates on, off the
+ * same extraction, so the faces a card is ALLOWED to name and the faces a renderer
+ * actually registers cannot drift apart. Entries that are not bundled (a generic,
+ * a system face) are dropped: there is nothing to load for them.
+ */
+export declare function cardBundledFamilies(html: string): string[];
+export declare function assertCardFontsAdmitted(html: string, locator: string): void;
+//# sourceMappingURL=cardFonts.d.ts.map

package/dist/_members/render-harness/cardFonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardFonts.d.ts","sourceRoot":"","sources":["../src/cardFonts.ts"],"names":[],"mappings":"AAqEA,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI3D;AAmCD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ1D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAa3E"}

package/dist/_members/render-harness/cardRender.d.ts

@@ -5,6 +5,7 @@ export declare function generateCardRootSource(opts: {
     width: number;
     height: number;
     fps: number;
+    renderEntryRoot: string;
 }): string;
 export declare function generateCardEntrySource(): string;
 export declare function buildCardWebpackOverride(renderEntryRoot: string): (config: any) => any;

package/dist/_members/render-harness/cardRender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cardRender.d.ts","sourceRoot":"","sources":["../src/cardRender.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CA6BnG;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,IACtD,QAAQ,GAAG,SAOpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA0D7F"}
+{"version":3,"file":"cardRender.d.ts","sourceRoot":"","sources":["../src/cardRender.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,mBAAmB,sBAAsB,CAAC;AACvD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AACxD,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAkDT;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,IACtD,QAAQ,GAAG,SAOpB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgE7F"}

package/dist/_members/render-harness/css-tree-subpaths.d.ts

@@ -9,3 +9,8 @@ declare module 'css-tree/walker' {
   const walk: typeof import('css-tree').walk;
   export default walk;
 }
+
+declare module 'css-tree/generator' {
+  const generate: typeof import('css-tree').generate;
+  export default generate;
+}

package/dist/_members/render-harness/renderInputAssets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderInputAssets.d.ts","sourceRoot":"","sources":["../src/renderInputAssets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,GACP,cAAc,GACd,MAAM,GACN,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAM/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,IAAI,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AA8GD,wBAAiB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,CAoDpE;AAsBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,EAAE,CAYhE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CA2C3D"}
+{"version":3,"file":"renderInputAssets.d.ts","sourceRoot":"","sources":["../src/renderInputAssets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,OAAO,GACP,cAAc,GACd,MAAM,GACN,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,SAAS,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAM/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,IAAI,MAAM,GAAG,SAAS,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAkHD,wBAAiB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,CAoDpE;AAsBD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,EAAE,CAYhE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CA2C3D"}

package/dist/authoring.js

@@ -48,7 +48,7 @@ import {
   formatPlanSteps,
   initCodeGenPrompts
 } from "./chunk-Y4HPN4BC.js";
-import "./chunk-Q244EHRI.js";
+import "./chunk-GMVUJYPM.js";
 import {
   cssLayoutVars
 } from "./chunk-W5W3FDDI.js";
@@ -62,7 +62,7 @@ import "./chunk-WPZKOVYF.js";
 import "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-WYKUWRQG.js";
+import "./chunk-A3MXR6JI.js";
 import "./chunk-7PA7FGLD.js";
 import {
   collectSceneClipIssues,

package/dist/{chunk-LLC6TCH5.js → chunk-3GNTA646.js}

@@ -1,7 +1,7 @@
 import {
   CueframeError,
   encodeError
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 
 // ../execution/core/src/render/vcam/constants.ts
 var P_MIN = 0.5;

package/dist/{chunk-LEJ5QXHP.js → chunk-4RREA7VA.js}

@@ -1,6 +1,10 @@
+import {
+  cssUrlPayloads,
+  isFragmentReference
+} from "./chunk-OSMXQV5V.js";
 import {
   CueframeError
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 
 // ../execution/render-harness/src/cardAssetAdmission.ts
 import parseCss from "css-tree/parser";
@@ -41,9 +45,6 @@ var CSS_VALUE_ATTRIBUTES = /* @__PURE__ */ new Set([
   "mask",
   "stroke"
 ]);
-function isFragmentReference(value) {
-  return value.trim().startsWith("#");
-}
 function refuse(locator, reason) {
   throw new CueframeError(
     "card_external_asset_forbidden",
@@ -84,8 +85,8 @@ function assertNodeAssetFree(node, locator) {
       }
       if (name === "style") assertCssAssetFree(attr.value, "declarationList", locator);
       if (CSS_VALUE_ATTRIBUTES.has(name)) {
-        for (const match of attr.value.matchAll(/url\(\s*(['"]?)(.*?)\1\s*\)/gi)) {
-          if (!isFragmentReference(match[2] ?? "")) {
+        for (const payload of cssUrlPayloads(attr.value)) {
+          if (!isFragmentReference(payload)) {
             refuse(locator, `contains an unmanifested ${name} url() asset reference`);
           }
         }

package/dist/{chunk-WYKUWRQG.js → chunk-A3MXR6JI.js}

@@ -440,6 +440,34 @@ function scrubAll(obj) {
   for (const [k, v] of Object.entries(obj)) out[k] = scrubVal(v);
   return Object.keys(out).length ? out : void 0;
 }
+var DEFAULT_RETRY_AFTER_SECONDS = 30;
+var BUSY_RETRY_AFTER_SECONDS = 5;
+var PROVIDER_RETRY_AFTER_SECONDS = 60;
+var RETRY_AFTER_OVERRIDES = {
+  idempotency_conflict: BUSY_RETRY_AFTER_SECONDS,
+  resource_import_in_flight: BUSY_RETRY_AFTER_SECONDS,
+  capture_busy: BUSY_RETRY_AFTER_SECONDS,
+  snapshot_stale: BUSY_RETRY_AFTER_SECONDS,
+  too_many_active_sessions: BUSY_RETRY_AFTER_SECONDS,
+  rate_limited: PROVIDER_RETRY_AFTER_SECONDS,
+  billing_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  render_provider_unreachable: PROVIDER_RETRY_AFTER_SECONDS,
+  render_provider_start_failed: PROVIDER_RETRY_AFTER_SECONDS,
+  render_pipeline_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  sighted_provider_unreachable: PROVIDER_RETRY_AFTER_SECONDS,
+  lambda_infra_failed: PROVIDER_RETRY_AFTER_SECONDS,
+  pipeline_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  mux_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  import_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  import_source_unreachable: PROVIDER_RETRY_AFTER_SECONDS,
+  generator_unavailable: PROVIDER_RETRY_AFTER_SECONDS,
+  service_unavailable: PROVIDER_RETRY_AFTER_SECONDS
+};
+function retryAfterSecondsFor(code) {
+  const spec = ERROR_CODES[code];
+  if (!spec?.retryable) return void 0;
+  return spec.retryAfterSeconds ?? RETRY_AFTER_OVERRIDES[code] ?? DEFAULT_RETRY_AFTER_SECONDS;
+}
 function toWireEnvelope(e, opts) {
   const trusted = opts?.trusted ?? false;
   let message;
@@ -455,7 +483,10 @@ function toWireEnvelope(e, opts) {
     fix = pickScrub(e.fix, FIX_ALLOW);
   }
   const locator = pickScrub(e.locator, LOCATOR_ALLOW);
-  return { ...e, message, fix, locator };
+  const thrown = typeof fix?.retryAfter === "number" ? fix.retryAfter : void 0;
+  const retryAfter = thrown ?? retryAfterSecondsFor(e.code);
+  const withRetry = retryAfter === void 0 ? fix : { ...fix ?? {}, retryAfter };
+  return { ...e, message, fix: withRetry, locator };
 }
 
 export {
@@ -464,5 +495,6 @@ export {
   encodeError,
   decodeError,
   scrubSensitive,
+  retryAfterSecondsFor,
   toWireEnvelope
 };

package/dist/{chunk-T4XTC35J.js → chunk-DLKCGEKP.js}

@@ -9,7 +9,7 @@ import {
 import {
   decodeError,
   scrubSensitive
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 
 // ../director/src/domain/chat.ts
 import { z } from "zod";

package/dist/{chunk-Q244EHRI.js → chunk-GMVUJYPM.js}

@@ -6,7 +6,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 
 // ../composition/src/projection/cardTokens.ts
 var CARD_MOTION_VAR_NAMES = [

package/dist/{chunk-MN6D3U5N.js → chunk-KSRFYFUZ.js}

@@ -1,3 +1,6 @@
+import {
+  hasNonFragmentCssUrl
+} from "./chunk-OSMXQV5V.js";
 import {
   getPrimitiveCatalogMeta
 } from "./chunk-7AZLFN26.js";
@@ -86,7 +89,11 @@ function parameterAssetPaths(primitiveId) {
 }
 function suspiciousUnannotatedAsset(value) {
   if (typeof value === "string") {
-    return /^(?:https?:\/\/|\/\/|data:|blob:|file:|\.\.?\/)/i.test(value) || /url\(\s*['"]?/i.test(value) || /^[^\s]+\.(?:png|jpe?g|gif|webp|svg|json|lottie|mp4|mov|webm|m4a|mp3|wav|woff2?|ttf|otf)(?:\?.*)?$/i.test(value);
+    return /^(?:https?:\/\/|\/\/|data:|blob:|file:|\.\.?\/)/i.test(value) || // A `url()` counts only when it leaves the document. `url(#mark-clip)` is a
+    // same-document fragment — the SVG/CSS walk in `cardAssetAdmission` has
+    // always known that, and this sweep did not, so an inline logo passed one
+    // guard and was refused by the other. Same predicate, both places.
+    hasNonFragmentCssUrl(value) || /^[^\s]+\.(?:png|jpe?g|gif|webp|svg|json|lottie|mp4|mov|webm|m4a|mp3|wav|woff2?|ttf|otf)(?:\?.*)?$/i.test(value);
   }
   if (Array.isArray(value)) return value.some(suspiciousUnannotatedAsset);
   if (value && typeof value === "object") return Object.values(value).some(suspiciousUnannotatedAsset);

package/dist/chunk-OSMXQV5V.js

@@ -0,0 +1,18 @@
+// ../execution/render-harness/src/assetRefs.ts
+function isFragmentReference(value) {
+  return value.trim().startsWith("#");
+}
+function cssUrlPayloads(value) {
+  return [...value.matchAll(/url\(\s*(['"]?)(.*?)\1\s*\)/gi)].map((m) => m[2] ?? "");
+}
+function hasNonFragmentCssUrl(value) {
+  const payloads = cssUrlPayloads(value);
+  if (payloads.length === 0) return false;
+  return payloads.some((payload) => !isFragmentReference(payload));
+}
+
+export {
+  isFragmentReference,
+  cssUrlPayloads,
+  hasNonFragmentCssUrl
+};

package/dist/chunk-RAPDICTC.js

@@ -0,0 +1,82 @@
+import {
+  CueframeError
+} from "./chunk-A3MXR6JI.js";
+import {
+  bundledFontFamilyFaces,
+  isGenericOnlyStack,
+  parseFontStack
+} from "./chunk-AVTEPAWI.js";
+
+// ../execution/render-harness/src/cardFonts.ts
+import parseCss from "css-tree/parser";
+import walkCss from "css-tree/walker";
+import generateCss from "css-tree/generator";
+import { parseFragment } from "parse5";
+function collectFontFamilyStacks(css, context, out) {
+  let ast;
+  try {
+    ast = parseCss(css, { context });
+  } catch {
+    return;
+  }
+  walkCss(ast, (node) => {
+    if (node.type !== "Declaration") return;
+    if (node.property.toLowerCase() !== "font-family") return;
+    const value = generateCss(node.value).trim();
+    if (value.length > 0) out.add(value);
+  });
+}
+function collectFromNode(node, out) {
+  if ("tagName" in node) {
+    for (const attr of node.attrs) {
+      if (attr.name.toLowerCase() === "style") {
+        collectFontFamilyStacks(attr.value, "declarationList", out);
+      }
+      if (attr.name.toLowerCase() === "font-family" && attr.value.trim().length > 0) {
+        out.add(attr.value.trim());
+      }
+    }
+    if (node.tagName.toLowerCase() === "style" && "childNodes" in node) {
+      const css = node.childNodes.filter((child) => child.nodeName === "#text").map((child) => child.value).join("");
+      collectFontFamilyStacks(css, "stylesheet", out);
+    }
+  }
+  if ("childNodes" in node) for (const child of node.childNodes) collectFromNode(child, out);
+}
+function cardFontFamilyStacks(html) {
+  const out = /* @__PURE__ */ new Set();
+  for (const node of parseFragment(html).childNodes) collectFromNode(node, out);
+  return [...out];
+}
+function stackDrawsSomethingReal(stack) {
+  const entries = parseFontStack(stack);
+  if (entries.length === 0) return true;
+  return entries.some((entry) => bundledFontFamilyFaces(entry) !== void 0 || isGenericOnlyStack(entry));
+}
+function cardBundledFamilies(html) {
+  const out = /* @__PURE__ */ new Set();
+  for (const stack of cardFontFamilyStacks(html)) {
+    for (const entry of parseFontStack(stack)) {
+      if (bundledFontFamilyFaces(entry) !== void 0) out.add(entry);
+    }
+  }
+  return [...out];
+}
+function assertCardFontsAdmitted(html, locator) {
+  for (const stack of cardFontFamilyStacks(html)) {
+    if (!stackDrawsSomethingReal(stack)) {
+      throw new CueframeError(
+        "font_not_reproducible",
+        `Card ${locator} asks for font-family '${stack}', which the renderer has no bytes for. Read GET /v1/fonts (list_render_fonts) for the admitted families; a stack naming one of them resolves to it. @import and remote font files are not available inside a card.`,
+        void 0,
+        { card: locator, fontFamily: stack }
+      );
+    }
+  }
+}
+
+export {
+  cardFontFamilyStacks,
+  cardBundledFamilies,
+  assertCardFontsAdmitted
+};

package/dist/{chunk-NSXFYDBP.js → chunk-TCYULWNP.js}

@@ -1,7 +1,7 @@
 import {
   ChatErrorView,
   DirectorTurnContext
-} from "./chunk-T4XTC35J.js";
+} from "./chunk-DLKCGEKP.js";
 import {
   GenerationArtifact
 } from "./chunk-73DQTUWY.js";

package/dist/{chunk-AZSTZE64.js → chunk-W44ASS4N.js}

@@ -7,10 +7,6 @@ import {
   flattenCompoundClips,
   hasCompoundClips
 } from "./chunk-QISFYLBB.js";
-import {
-  compositionHasVo,
-  roleDefaultGainDb
-} from "./chunk-VZ7TYX6Z.js";
 import {
   DOMINANCE_WEIGHTS,
   ENTER_SEC,
@@ -28,7 +24,11 @@ import {
   scoreAndRank,
   segmentShots,
   stabilizeSelectionHysteresis
-} from "./chunk-LLC6TCH5.js";
+} from "./chunk-3GNTA646.js";
+import {
+  compositionHasVo,
+  roleDefaultGainDb
+} from "./chunk-VZ7TYX6Z.js";
 import {
   SHOT_SCALE_TARGET,
   shotScaleZoom
@@ -36,7 +36,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 import {
   SCENE_CAPTURE_IDENTITY_FIELDS_V1,
   SCENE_PRESET_TRIANGLES,

package/dist/compose.js

@@ -1,44 +1,44 @@
 import "./chunk-JVDUSOYG.js";
+import "./chunk-GULDS3VE.js";
 import {
   isContrastCritical
 } from "./chunk-QDBVYZSF.js";
 import "./chunk-JQMPHKLU.js";
 import "./chunk-ZZRBKGDA.js";
-import "./chunk-GULDS3VE.js";
-import {
-  catalog as catalog6
-} from "./chunk-VLJOIUHL.js";
-import {
-  catalog as catalog2
-} from "./chunk-WAUVKF2F.js";
-import {
-  catalog as catalog8
-} from "./chunk-7SQOXIWR.js";
 import {
   catalog as catalog4
 } from "./chunk-JRJQECCF.js";
 import {
   catalog as catalog7
-} from "./chunk-IAQHWJUO.js";
-import "./chunk-S5H6GH6M.js";
-import "./chunk-QAGGJHAF.js";
-import "./chunk-MFHXCHRI.js";
+} from "./chunk-TE3PNQG6.js";
 import {
   catalog
-} from "./chunk-ZDL7XEXW.js";
-import "./chunk-U4V4FZGE.js";
+} from "./chunk-RBWS5XHE.js";
 import "./chunk-DLF4WVSE.js";
-import "./chunk-LT4PWSR2.js";
-import "./chunk-FWSJLHSV.js";
+import "./chunk-U4V4FZGE.js";
 import {
   catalog as catalog3
 } from "./chunk-FVDFPJHT.js";
 import "./chunk-QGAWDLYX.js";
+import {
+  catalog as catalog6
+} from "./chunk-VLJOIUHL.js";
+import "./chunk-S5H6GH6M.js";
+import "./chunk-QAGGJHAF.js";
 import {
   catalog as catalog5
 } from "./chunk-RAXHCRVV.js";
-import "./chunk-XHGZ2E77.js";
+import {
+  catalog as catalog2
+} from "./chunk-WAUVKF2F.js";
+import "./chunk-MFHXCHRI.js";
+import {
+  catalog as catalog8
+} from "./chunk-RL5SO653.js";
+import "./chunk-LT4PWSR2.js";
+import "./chunk-FWSJLHSV.js";
 import "./chunk-ZFEXATWN.js";
+import "./chunk-XHGZ2E77.js";
 import "./chunk-W2245F6G.js";
 import "./chunk-JBWSK2YD.js";
 import "./chunk-OBA6NW4S.js";
@@ -54,7 +54,7 @@ import {
 import {
   CueframeError,
   encodeError
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-XACXNDFL.js";
 import "./chunk-2L7PYYJK.js";

package/dist/composition/projection.js

@@ -32,7 +32,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "../chunk-Q244EHRI.js";
+} from "../chunk-GMVUJYPM.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -74,7 +74,7 @@ import {
   contrastRatio
 } from "../chunk-ILO4NEZ3.js";
 import "../chunk-VG2ND6PX.js";
-import "../chunk-WYKUWRQG.js";
+import "../chunk-A3MXR6JI.js";
 import "../chunk-AVTEPAWI.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/composition-ops.js

@@ -1,10 +1,10 @@
 import {
   playableSpans
-} from "./chunk-AZSTZE64.js";
+} from "./chunk-W44ASS4N.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
+import "./chunk-3GNTA646.js";
 import "./chunk-VZ7TYX6Z.js";
-import "./chunk-LLC6TCH5.js";
 import "./chunk-DENF4TPI.js";
 import {
   createHeadlessStore,
@@ -30,7 +30,7 @@ import {
 } from "./chunk-B7J5UUUV.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-WYKUWRQG.js";
+import "./chunk-A3MXR6JI.js";
 import "./chunk-7PA7FGLD.js";
 import {
   SCENE_SLOT_MEDIA_FORMATS,
@@ -578,7 +578,7 @@ var CompositionOp = z.discriminatedUnion("type", [
     "Set the output format \u2014 `aspectRatio` (16:9|9:16|1:1|4:5) plus optional `fps` and `resolution`. Merges: an omitted field keeps the current value."
   ),
   z.object({ type: z.literal("addTrack"), kind: Track.shape.kind, name: z.string().optional(), id: z.string().optional() }).strict().describe(
-    "Add an EMPTY track of a given family (video|audio|image|overlay|effect). Optional pinned `id`."
+    "Add an EMPTY track of a given family (video|audio|image|overlay|effect). Optional pinned `id`. The new track is appended, so it starts at the BACK: index 0 is the top layer and higher indices are further back (see `reorderTracks`). Track order only ranks clips on the same plane \u2014 every overlay draws above the video lane unless its `zPlane` is `behind-subject`, whatever its track index."
   ),
   z.object({ type: z.literal("removeTrack"), trackId: z.string() }).strict().describe(
     "Remove a track AND all its clips by id."
@@ -587,7 +587,7 @@ var CompositionOp = z.discriminatedUnion("type", [
     "Patch a track's `name` / `enabled` by id."
   ),
   z.object({ type: z.literal("reorderTracks"), fromIndex: z.number(), toIndex: z.number() }).strict().describe(
-    "Move a track from one index to another (changes layer/compositing order)."
+    'Move a track from one index to another. ORDER: index 0 is the TOP layer, not the bottom \u2014 moving a backdrop to index 0 puts it in FRONT of everything and hides the composition. Higher index = further back. PRECEDENCE: track order decides compositing only among clips on the same plane. Overlays are composited in a lane ABOVE the video lane whatever their track index; the one exception is `zPlane:"behind-subject"`, which moves the overlay inside its host clip, behind the segmented foreground. So if reordering tracks does not change what you see, the plane split already decided it.'
   ),
   z.object({ type: z.literal("moveClipToTrack"), clipId: z.string(), targetTrackId: z.string(), newStartTime: z.number().optional() }).strict().describe(
     "Move a clip to another SAME-family track, optionally at a new `newStartTime`."

package/dist/composition.js

@@ -46,7 +46,7 @@ import {
   silhouetteKeepOutForWindow,
   sourceRectToOutput,
   sourceWindowKey
-} from "./chunk-Q244EHRI.js";
+} from "./chunk-GMVUJYPM.js";
 import {
   BRAND_TOKEN_REFS,
   BRAND_TOKEN_ROOT_KEYS,
@@ -194,7 +194,7 @@ import {
   ReframeSegmentFields
 } from "./chunk-B7J5UUUV.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-WYKUWRQG.js";
+import "./chunk-A3MXR6JI.js";
 import "./chunk-AVTEPAWI.js";
 import "./chunk-2ESYSVXG.js";
 

package/dist/core/render.js

@@ -66,19 +66,19 @@ import {
   sliceTranscriptWords,
   splitIntoSentences,
   validateComposition
-} from "../chunk-AZSTZE64.js";
+} from "../chunk-W44ASS4N.js";
 import {
   buildEasedZooms,
   buildPannedCenters,
   easeOutCubic
 } from "../chunk-QH3YI3ND.js";
 import "../chunk-QISFYLBB.js";
+import "../chunk-3GNTA646.js";
 import "../chunk-VZ7TYX6Z.js";
-import "../chunk-LLC6TCH5.js";
 import "../chunk-DENF4TPI.js";
 import "../chunk-KYRDKK2D.js";
 import "../chunk-WREYUH2E.js";
-import "../chunk-WYKUWRQG.js";
+import "../chunk-A3MXR6JI.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-XACXNDFL.js";
 import "../chunk-2L7PYYJK.js";

package/dist/core/select.js

@@ -7,8 +7,8 @@ import {
   stabilizeIncumbentChallenger,
   stabilizePresenceGate,
   stabilizeSelectionHysteresis
-} from "../chunk-LLC6TCH5.js";
-import "../chunk-WYKUWRQG.js";
+} from "../chunk-3GNTA646.js";
+import "../chunk-A3MXR6JI.js";
 import "../chunk-2ESYSVXG.js";
 
 // ../execution/core/src/select/errorCodes.ts

package/dist/core.js

@@ -10,15 +10,15 @@ import {
   ensureEven,
   extractCaptionWordsFromDoc,
   isEmphasized
-} from "./chunk-AZSTZE64.js";
+} from "./chunk-W44ASS4N.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
+import "./chunk-3GNTA646.js";
 import "./chunk-VZ7TYX6Z.js";
-import "./chunk-LLC6TCH5.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
-import "./chunk-WYKUWRQG.js";
+import "./chunk-A3MXR6JI.js";
 import "./chunk-7PA7FGLD.js";
 import "./chunk-XACXNDFL.js";
 import "./chunk-2L7PYYJK.js";

package/dist/director/ai-sdk.js

@@ -10,13 +10,13 @@ import {
   dataChunk,
   generationArtifactFromToolResult,
   projectDirectorHistory
-} from "../chunk-NSXFYDBP.js";
-import "../chunk-T4XTC35J.js";
+} from "../chunk-TCYULWNP.js";
+import "../chunk-DLKCGEKP.js";
 import "../chunk-73DQTUWY.js";
 import "../chunk-BADZHXLR.js";
 import "../chunk-U3JPILZS.js";
 import "../chunk-XELS2BGA.js";
-import "../chunk-WYKUWRQG.js";
+import "../chunk-A3MXR6JI.js";
 import "../chunk-2ESYSVXG.js";
 export {
   CueFrameIteration,

package/dist/director/domain.js

@@ -9,7 +9,7 @@ import {
   ProjectRef,
   chatErrorViewFromEnvelope,
   chatErrorViewFromUnknown
-} from "../chunk-T4XTC35J.js";
+} from "../chunk-DLKCGEKP.js";
 import {
   ClientRequestId,
   GenerateMediaCommand,
@@ -31,7 +31,7 @@ import {
 import "../chunk-BADZHXLR.js";
 import "../chunk-U3JPILZS.js";
 import "../chunk-XELS2BGA.js";
-import "../chunk-WYKUWRQG.js";
+import "../chunk-A3MXR6JI.js";
 import "../chunk-2ESYSVXG.js";
 export {
   ChatErrorView,

package/dist/director.js

@@ -10,7 +10,7 @@ import {
   dataChunk,
   generationArtifactFromToolResult,
   projectDirectorHistory
-} from "./chunk-NSXFYDBP.js";
+} from "./chunk-TCYULWNP.js";
 import "./chunk-FTVZF4GO.js";
 import {
   ChatErrorView,
@@ -22,7 +22,7 @@ import {
   ProjectRef,
   chatErrorViewFromEnvelope,
   chatErrorViewFromUnknown
-} from "./chunk-T4XTC35J.js";
+} from "./chunk-DLKCGEKP.js";
 import {
   ClientRequestId,
   GenerateMediaCommand,
@@ -44,7 +44,7 @@ import {
 import "./chunk-BADZHXLR.js";
 import "./chunk-U3JPILZS.js";
 import "./chunk-XELS2BGA.js";
-import "./chunk-WYKUWRQG.js";
+import "./chunk-A3MXR6JI.js";
 import "./chunk-2ESYSVXG.js";
 export {
   ChatErrorView,

package/dist/errors.js

@@ -3,15 +3,17 @@ import {
   ERROR_CODES,
   decodeError,
   encodeError,
+  retryAfterSecondsFor,
   scrubSensitive,
   toWireEnvelope
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 import "./chunk-2ESYSVXG.js";
 export {
   CueframeError,
   ERROR_CODES,
   decodeError,
   encodeError,
+  retryAfterSecondsFor,
   scrubSensitive,
   toWireEnvelope
 };

package/dist/primitives/hero-text.js

@@ -1,11 +1,11 @@
 import {
   HeroText,
   catalog
-} from "../chunk-7SQOXIWR.js";
+} from "../chunk-RL5SO653.js";
 import "../chunk-LT4PWSR2.js";
 import "../chunk-FWSJLHSV.js";
-import "../chunk-XHGZ2E77.js";
 import "../chunk-ZFEXATWN.js";
+import "../chunk-XHGZ2E77.js";
 import "../chunk-W2245F6G.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/primitives/lib/index.js

@@ -1,4 +1,10 @@
 import "../../chunk-JVDUSOYG.js";
+import {
+  SeededPRNG,
+  gauss,
+  pick,
+  range
+} from "../../chunk-GULDS3VE.js";
 import {
   ALLOWED_BRAND_PATHS,
   CONTRAST_CRITICAL_PATHS,
@@ -18,12 +24,6 @@ import {
   zodToDefaults,
   zodToJsonSchemaFor
 } from "../../chunk-ZZRBKGDA.js";
-import {
-  SeededPRNG,
-  gauss,
-  pick,
-  range
-} from "../../chunk-GULDS3VE.js";
 import {
   FRAME_BASELINE_WIDTH,
   frameScale,

package/dist/primitives/lib.js

@@ -1,4 +1,10 @@
 import "../chunk-JVDUSOYG.js";
+import {
+  SeededPRNG,
+  gauss,
+  pick,
+  range
+} from "../chunk-GULDS3VE.js";
 import {
   ALLOWED_BRAND_PATHS,
   CONTRAST_CRITICAL_PATHS,
@@ -18,12 +24,6 @@ import {
   zodToDefaults,
   zodToJsonSchemaFor
 } from "../chunk-ZZRBKGDA.js";
-import {
-  SeededPRNG,
-  gauss,
-  pick,
-  range
-} from "../chunk-GULDS3VE.js";
 import {
   FRAME_BASELINE_WIDTH,
   frameScale,

package/dist/primitives/scenes.js

@@ -8,11 +8,11 @@ import {
   ProductLaunchTrailer,
   TerminalToBrowserDeploy,
   catalog
-} from "../chunk-IAQHWJUO.js";
+} from "../chunk-TE3PNQG6.js";
+import "../chunk-QGAWDLYX.js";
 import "../chunk-S5H6GH6M.js";
 import "../chunk-QAGGJHAF.js";
 import "../chunk-MFHXCHRI.js";
-import "../chunk-QGAWDLYX.js";
 import "../chunk-W2245F6G.js";
 import "../chunk-JBWSK2YD.js";
 import "../chunk-OBA6NW4S.js";

package/dist/primitives/text.js

@@ -21,13 +21,13 @@ import {
   TrackingIn,
   Typewriter,
   catalog
-} from "../chunk-ZDL7XEXW.js";
-import "../chunk-U4V4FZGE.js";
+} from "../chunk-RBWS5XHE.js";
 import "../chunk-DLF4WVSE.js";
+import "../chunk-U4V4FZGE.js";
 import "../chunk-LT4PWSR2.js";
 import "../chunk-FWSJLHSV.js";
-import "../chunk-XHGZ2E77.js";
 import "../chunk-ZFEXATWN.js";
+import "../chunk-XHGZ2E77.js";
 import "../chunk-W2245F6G.js";
 import "../chunk-2ESYSVXG.js";
 export {

package/dist/primitives.js

@@ -1,37 +1,37 @@
-import {
-  catalog as catalog6
-} from "./chunk-VLJOIUHL.js";
-import {
-  catalog as catalog2
-} from "./chunk-WAUVKF2F.js";
-import {
-  catalog as catalog8
-} from "./chunk-7SQOXIWR.js";
 import {
   catalog as catalog4
 } from "./chunk-JRJQECCF.js";
 import {
   catalog as catalog7
-} from "./chunk-IAQHWJUO.js";
-import "./chunk-S5H6GH6M.js";
-import "./chunk-QAGGJHAF.js";
-import "./chunk-MFHXCHRI.js";
+} from "./chunk-TE3PNQG6.js";
 import {
   catalog
-} from "./chunk-ZDL7XEXW.js";
-import "./chunk-U4V4FZGE.js";
+} from "./chunk-RBWS5XHE.js";
 import "./chunk-DLF4WVSE.js";
-import "./chunk-LT4PWSR2.js";
-import "./chunk-FWSJLHSV.js";
+import "./chunk-U4V4FZGE.js";
 import {
   catalog as catalog3
 } from "./chunk-FVDFPJHT.js";
 import "./chunk-QGAWDLYX.js";
+import {
+  catalog as catalog6
+} from "./chunk-VLJOIUHL.js";
+import "./chunk-S5H6GH6M.js";
+import "./chunk-QAGGJHAF.js";
 import {
   catalog as catalog5
 } from "./chunk-RAXHCRVV.js";
-import "./chunk-XHGZ2E77.js";
+import {
+  catalog as catalog2
+} from "./chunk-WAUVKF2F.js";
+import "./chunk-MFHXCHRI.js";
+import {
+  catalog as catalog8
+} from "./chunk-RL5SO653.js";
+import "./chunk-LT4PWSR2.js";
+import "./chunk-FWSJLHSV.js";
 import "./chunk-ZFEXATWN.js";
+import "./chunk-XHGZ2E77.js";
 import "./chunk-W2245F6G.js";
 import "./chunk-JBWSK2YD.js";
 import "./chunk-OBA6NW4S.js";

package/dist/render-harness/cardAssetAdmission.js

@@ -1,7 +1,8 @@
 import {
   assertCardHtmlAssetFree
-} from "../chunk-LEJ5QXHP.js";
-import "../chunk-WYKUWRQG.js";
+} from "../chunk-4RREA7VA.js";
+import "../chunk-OSMXQV5V.js";
+import "../chunk-A3MXR6JI.js";
 import "../chunk-2ESYSVXG.js";
 export {
   assertCardHtmlAssetFree

package/dist/render-harness/cardFonts.d.ts

@@ -0,0 +1 @@
+export * from "../_members/render-harness/cardFonts.js";

package/dist/render-harness/cardFonts.js

@@ -0,0 +1,13 @@
+import {
+  assertCardFontsAdmitted,
+  cardBundledFamilies,
+  cardFontFamilyStacks
+} from "../chunk-RAPDICTC.js";
+import "../chunk-A3MXR6JI.js";
+import "../chunk-AVTEPAWI.js";
+import "../chunk-2ESYSVXG.js";
+export {
+  assertCardFontsAdmitted,
+  cardBundledFamilies,
+  cardFontFamilyStacks
+};

package/dist/render-harness/renderInputAssets.js

@@ -4,7 +4,8 @@ import {
   assetUrlKey,
   isRemoteUrl,
   renderInputAssets
-} from "../chunk-MN6D3U5N.js";
+} from "../chunk-KSRFYFUZ.js";
+import "../chunk-OSMXQV5V.js";
 import "../chunk-7AZLFN26.js";
 import "../chunk-7PA7FGLD.js";
 import "../chunk-2ESYSVXG.js";

package/dist/render-harness.js

@@ -1,13 +1,17 @@
 import {
   assertCardHtmlAssetFree
-} from "./chunk-LEJ5QXHP.js";
+} from "./chunk-4RREA7VA.js";
+import {
+  assertCardFontsAdmitted
+} from "./chunk-RAPDICTC.js";
 import {
   assertNoRemoteRefs,
   assetSlots,
   assetUrlKey,
   isRemoteUrl,
   renderInputAssets
-} from "./chunk-MN6D3U5N.js";
+} from "./chunk-KSRFYFUZ.js";
+import "./chunk-OSMXQV5V.js";
 import "./chunk-256ZO323.js";
 import "./chunk-BVA3537Z.js";
 import {
@@ -42,17 +46,17 @@ import {
   parseSceneComponentCaptureIntentV1,
   prepareSceneShotRenderInput,
   readSceneShotManifest
-} from "./chunk-AZSTZE64.js";
+} from "./chunk-W44ASS4N.js";
 import "./chunk-QH3YI3ND.js";
 import "./chunk-QISFYLBB.js";
+import "./chunk-3GNTA646.js";
 import "./chunk-VZ7TYX6Z.js";
-import "./chunk-LLC6TCH5.js";
 import "./chunk-DENF4TPI.js";
 import "./chunk-KYRDKK2D.js";
 import "./chunk-WREYUH2E.js";
 import {
   CueframeError
-} from "./chunk-WYKUWRQG.js";
+} from "./chunk-A3MXR6JI.js";
 import "./chunk-7PA7FGLD.js";
 import {
   evaluateScene,
@@ -1109,12 +1113,25 @@ var CARD_COMPOSITION_ID = "CueFrameCardStill";
 var CARD_ROOT_FILENAME = "card.Root.local.tsx";
 var CARD_ENTRY_FILENAME = "card.entry.local.tsx";
 function generateCardRootSource(opts) {
+  const fontsModule = JSON.stringify(join6(opts.renderEntryRoot, "src", "fonts"));
   return `// GENERATED by @cueframe/render-harness generateCardRootSource \u2014 DO NOT EDIT.
 import React from 'react';
-import { Composition, AbsoluteFill, getInputProps } from 'remotion';
+import { Composition, AbsoluteFill, getInputProps, delayRender, continueRender } from 'remotion';
+import { ensureAllFontsLoaded } from ${fontsModule};
 
 const Card: React.FC = () => {
   const { html, cssVars } = getInputProps() as { html: string; cssVars?: Record<string, string> };
+  // Hold the frame until the faces are registered. Without this the still can be
+  // captured mid-load and fall back to a system face \u2014 the same silent
+  // substitution, just intermittent instead of constant.
+  const [handle] = React.useState(() => delayRender('card-fonts'));
+  React.useEffect(() => {
+    let cancelled = false;
+    ensureAllFontsLoaded()
+      .catch(() => undefined)
+      .then(() => { if (!cancelled) continueRender(handle); });
+    return () => { cancelled = true; };
+  }, [handle]);
   return (
     <AbsoluteFill>
       <div
@@ -1162,7 +1179,11 @@ async function renderCardStill(opts) {
   const renderEntryRoot = resolveRenderEntryRoot(opts.renderEntryRoot);
   const browserExecutable = (await verifyLocalStagedBrowser(renderEntryRoot)).path;
   mkdirSync(opts.outDir, { recursive: true });
-  writeFileSync(join6(opts.outDir, CARD_ROOT_FILENAME), generateCardRootSource({ width, height, fps }));
+  assertCardFontsAdmitted(opts.html, "still");
+  writeFileSync(
+    join6(opts.outDir, CARD_ROOT_FILENAME),
+    generateCardRootSource({ width, height, fps, renderEntryRoot })
+  );
   const entryPoint = join6(opts.outDir, CARD_ENTRY_FILENAME);
   writeFileSync(entryPoint, generateCardEntrySource());
   const { bundle } = await importFromRenderEntry(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueframe/kernel",
-  "version": "0.2.32",
+  "version": "0.2.33",
   "type": "module",
   "description": "Publish-only aggregate of CueFrame's isomorphic kernel packages — composition, primitives, authoring, MCP, and friends shipped as one npm artifact. Members remain separate workspace packages; this only changes what ships.",
   "files": [
@@ -16,26 +16,26 @@
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.9.3",
+    "@cueframe/account-model": "0.1.0",
     "@cueframe/animate": "0.1.0",
+    "@cueframe/authoring": "0.1.0",
     "@cueframe/cloud-import": "0.1.0",
-    "@cueframe/account-model": "0.1.0",
-    "@cueframe/composition-ops": "0.1.0",
     "@cueframe/composition": "0.1.0",
     "@cueframe/compose": "0.1.0",
+    "@cueframe/errors": "0.1.0",
     "@cueframe/director": "0.1.0",
+    "@cueframe/composition-ops": "0.1.0",
     "@cueframe/component-runtime": "0.1.0",
     "@cueframe/core": "0.1.0",
-    "@cueframe/mcp": "0.1.0",
+    "@cueframe/brand-derivation": "0.1.0",
     "@cueframe/media-model": "0.1.0",
     "@cueframe/foundation": "0.1.0",
-    "@cueframe/errors": "0.1.0",
+    "@cueframe/plane": "0.1.0",
     "@cueframe/nle-export": "0.1.0",
-    "@cueframe/render-harness": "0.1.0",
-    "@cueframe/primitives": "0.1.0",
+    "@cueframe/mcp": "0.1.0",
     "@cueframe/perception": "0.1.0",
-    "@cueframe/authoring": "0.1.0",
-    "@cueframe/plane": "0.1.0",
-    "@cueframe/brand-derivation": "0.1.0"
+    "@cueframe/render-harness": "0.1.0",
+    "@cueframe/primitives": "0.1.0"
   },
   "peerDependencies": {
     "gsap": "3.13.0",
@@ -457,6 +457,10 @@
       "types": "./dist/render-harness/cardAssetAdmission.d.ts",
       "default": "./dist/render-harness/cardAssetAdmission.js"
     },
+    "./render-harness/cardFonts": {
+      "types": "./dist/render-harness/cardFonts.d.ts",
+      "default": "./dist/render-harness/cardFonts.js"
+    },
     "./render-harness/renderInputAssets": {
       "types": "./dist/render-harness/renderInputAssets.d.ts",
       "default": "./dist/render-harness/renderInputAssets.js"

package/dist/{chunk-ZDL7XEXW.js → chunk-RBWS5XHE.js}

@@ -1,9 +1,9 @@
-import {
-  TextStage
-} from "./chunk-U4V4FZGE.js";
 import {
   recolor
 } from "./chunk-DLF4WVSE.js";
+import {
+  TextStage
+} from "./chunk-U4V4FZGE.js";
 import {
   resolveTypeface
 } from "./chunk-LT4PWSR2.js";
@@ -12,15 +12,15 @@ import {
   FLOOR_TEXT,
   resolveContrast
 } from "./chunk-FWSJLHSV.js";
-import {
-  FitText,
-  resolveFitFontSize
-} from "./chunk-XHGZ2E77.js";
 import {
   resolveEasing,
   staggerRise,
   staggerUp
 } from "./chunk-ZFEXATWN.js";
+import {
+  FitText,
+  resolveFitFontSize
+} from "./chunk-XHGZ2E77.js";
 import {
   ACCENT,
   ACCENT_STRONG,

package/dist/{chunk-7SQOXIWR.js → chunk-RL5SO653.js}

@@ -4,15 +4,15 @@ import {
 import {
   resolveContrast
 } from "./chunk-FWSJLHSV.js";
-import {
-  resolveFitFontSize
-} from "./chunk-XHGZ2E77.js";
 import {
   fadeProgress,
   resolveEasing,
   staggerUp,
   wordPop
 } from "./chunk-ZFEXATWN.js";
+import {
+  resolveFitFontSize
+} from "./chunk-XHGZ2E77.js";
 
 // ../execution/primitives/src/hero-text/HeroText.tsx
 import { useCurrentFrame, useVideoConfig } from "remotion";

package/dist/{chunk-IAQHWJUO.js → chunk-TE3PNQG6.js}

@@ -1,3 +1,7 @@
+import {
+  frostedGlassWipe,
+  spatialPush
+} from "./chunk-QGAWDLYX.js";
 import {
   DashboardPopulate
 } from "./chunk-S5H6GH6M.js";
@@ -7,10 +11,6 @@ import {
 import {
   EASING_BY_INTENT
 } from "./chunk-MFHXCHRI.js";
-import {
-  frostedGlassWipe,
-  spatialPush
-} from "./chunk-QGAWDLYX.js";
 import {
   ACCENT,
   ACCENT_SOFT,