@snowcone-app/canvas 0.29.0 → 0.31.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/STYLING_CONTRACT.md

@@ -92,7 +92,7 @@ stable hooks; `sc:`-prefixed utility classes are internal and NOT contract.
         <div class="sc-toolbar" data-mode="embedded">
           …
     <div class="sc-secondary-toolbar-panel-wrapper">
-      <div> ×16
+      <div> ×17
 ```
 
 ### `controls` — Editor.Controls — built-in floating toolbar (no Controls mounted; body portal)
@@ -398,7 +398,7 @@ stable hooks; `sc:`-prefixed utility classes are internal and NOT contract.
         <div>
           …
         <div class="sc-secondary-toolbar-panel-wrapper">
-          … ×16
+          … ×17
   <div data-sc-part="snowcone-editor-idle-dock">
     <div data-sc-part="add">
       <div>

package/dist/{CanvasRenderer-_lFoIoz5.js → CanvasRenderer-hpJ05JGO.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 { a2 as oe, a3 as ie, aB as nt, a4 as Ft, aO as ae, aM as re, aF as Ot, aL as le, aE as gt, aP as he, aQ as Yt, aR as ce, aS as de, c as Zt, aT as fe, aU as ge, aV as ue, aW as pe, ab as Jt, a7 as Qt, af as pt, a8 as te, a9 as Lt, ag as Gt, ae as Pt, ah as Xt, ac as ye, ai as be, aX as Nt, aY as Se, aZ as me, a_ as Te, I as we, a$ as ve, b0 as Me, b1 as tt } from "./FontAnalyzer-BYhwxDhe.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-Bkzzyxgw.js";
+import { i as Dt, a as Ee } from "./guards-DgZuwVgu.js";
 const ct = {
   // Canvas-specific
   canvas: {
@@ -3444,4 +3444,4 @@ export {
   $t as g,
   Ze as r
 };
-//# sourceMappingURL=CanvasRenderer-_lFoIoz5.js.map
+//# sourceMappingURL=CanvasRenderer-hpJ05JGO.js.map