@snowcone-app/canvas 0.29.0 → 0.30.0

package/ERROR_CONTRACT.md

@@ -49,6 +49,7 @@ the issue key in `error.data.issue`.
 | [`E_BINDING_INERT`](#e_binding_inert) | throw | `assertRenders`: the mutated render is byte-identical to the seed render — the binding under test is dead (the two-render contract, F4). |
 | [`E_NO_MUTABLE_BINDING`](#e_no_mutable_binding) | throw | `assertRenders`: the design has no named text layer to mutate and no `mutate` override was given (F4). |
 | [`E_AUDIT_NO_ROOT`](#e_audit_no_root) | throw | `auditEditor()` called with no `<Editor.Root>` mounted — the imperative audit reads the most-recent mounted Root's registry (#10). |
+| [`E_FONT_LOAD_FAILED`](#e_font_load_failed) | throw | A custom (brand) font failed to load from its hosted URL — the binary fetch failed (CORS, 404, network) or FontFace rejected the bytes. Custom fonts NEVER fall back silently to a system face: the design would render with a different typeface/metrics everywhere it's consumed. `data` carries `family`, `url`, `weight`, `style`. Fix the URL (must serve the font file over a plain cross-origin GET) and re-register. Dev AND prod. |
 | [`E_DISTRIBUTE_MIN_THREE`](#e_distribute_min_three) | throw | `computeDistribute()` called with fewer than 3 movable elements — distributing needs something between the two ends. Gate the action on `useAlignDistribute().canDistribute` instead of calling below the threshold (the toolbar hides its distribute buttons for exactly this reason). |
 | [`missing-shop`](#missing-shop) | error → throws `E_EMBED_CONFIG` | No `shop` (the publishable shop id) was passed. |
 | [`missing-grant`](#missing-grant) | error → throws `E_EMBED_CONFIG` | No grant source (`grantUrl`/`grant`) — the session can never authorize, so no mockup ever renders. |
@@ -537,6 +538,18 @@ the issue key in `error.data.issue`.
 
   `error.data`: `code`, `docSlug`
 
+### `E_FONT_LOAD_FAILED`
+
+**Fires when:** A custom (brand) font failed to load from its hosted URL — the binary fetch failed (CORS, 404, network) or FontFace rejected the bytes. Custom fonts NEVER fall back silently to a system face: the design would render with a different typeface/metrics everywhere it's consumed. `data` carries `family`, `url`, `weight`, `style`. Fix the URL (must serve the font file over a plain cross-origin GET) and re-register. Dev AND prod.
+
+- `src/utils/custom-fonts.ts`
+
+  ```text
+  Custom font "${font.family}" failed to load from ${font.url}. The URL must serve the font binary over a plain cross-origin GET (CORS). Verify the URL is reachable and sends Access-Control-Allow-Origin, then re-register the font. Custom fonts never fall back silently — the design would render with the wrong typeface.
+  ```
+
+  `error.data`: `code`, `family`, `url`, `weight`, `style`
+
 ### `E_DISTRIBUTE_MIN_THREE`
 
 **Fires when:** `computeDistribute()` called with fewer than 3 movable elements — distributing needs something between the two ends. Gate the action on `useAlignDistribute().canDistribute` instead of calling below the threshold (the toolbar hides its distribute buttons for exactly this reason).

package/dist/{CanvasRenderer-_lFoIoz5.js → CanvasRenderer-BEf0hXeF.js}

@@ -1,6 +1,6 @@
-import { X as oe, Y as ie, au as nt, Z as Ft, aH as ae, aF as re, ay as Ot, aE as le, ax as gt, aI as he, aJ as Yt, aK as ce, aL as de, c as Zt, aM as fe, aN as ge, aO as ue, aP as pe, a4 as Jt, a0 as Qt, a8 as pt, a1 as te, a2 as Lt, a9 as Gt, a7 as Pt, aa as Xt, a5 as ye, ab as be, aQ as Nt, aR as Se, aS as me, aT as Te, I as we, aU as ve, aV as Me, aW as tt } from "./FontAnalyzer-D4Sg-P6_.js";
-import { T as Wt, a as xe, u as Ce, K as Re, z as At, L as Kt, M as ke, N as Pe, O as Ae } from "./ExportManager-B8Td7uR5.js";
-import { i as Dt, a as Ee } from "./guards-uQtEQJbs.js";
+import { _ as oe, $ as ie, ax as nt, a0 as Ft, aK as ae, aI as re, aB as Ot, aH as le, aA as gt, aL as he, aM as Yt, aN as ce, aO as de, c as Zt, aP as fe, aQ as ge, aR as ue, aS as pe, a7 as Jt, a3 as Qt, ab as pt, a4 as te, a5 as Lt, ac as Gt, aa as Pt, ad as Xt, a8 as ye, ae as be, aT as Nt, aU as Se, aV as me, aW as Te, I as we, aX as ve, aY as Me, aZ as tt } from "./FontAnalyzer-DKG5JK0x.js";
+import { T as Wt, b as xe, y as Ce, O as Re, F as At, P as Kt, Q as ke, R as Pe, S as Ae } from "./ExportManager-DUdis6se.js";
+import { i as Dt, a as Ee } from "./guards-BSoX73yg.js";
 const ct = {
   // Canvas-specific
   canvas: {
@@ -3444,4 +3444,4 @@ export {
   $t as g,
   Ze as r
 };
-//# sourceMappingURL=CanvasRenderer-_lFoIoz5.js.map
+//# sourceMappingURL=CanvasRenderer-BEf0hXeF.js.map