@snowcone-app/canvas 0.26.0 → 0.27.0

package/ERROR_CONTRACT.md

@@ -42,6 +42,8 @@ the issue key in `error.data.issue`.
 | [`E_COLOR_ROLE_INVALID`](#e_color_role_invalid) | throw | `design({ colors })`: a role's value is not a `#RGB`/`#RRGGBB` hex (value-matched bindings normalize hex; other syntaxes can't bind). |
 | [`E_COLOR_ROLE_NOT_FOUND`](#e_color_role_not_found) | throw | `design.color(name)`: no color role with this name — lists the design's declared roles. |
 | [`E_PREVIEW_NO_LOADER`](#e_preview_no_loader) | throw | `Editor.Preview loadingOverlay` got `false`/an unknown value. A mockup preview ALWAYS has a render-in-flight treatment (a server render takes real time, and the loader paints OVER the still-visible previous mockup) — keep the default, pass a variant/custom element, or declare `"host-owned"` with your own indicator. Silence-then-pop-in is a composition mistake, not a preference. |
+| [`E_INVALID_PATCH`](#e_invalid_patch) | throw | `updateElement(target, patch)`: a patch key doesn't apply to the target element's kind (e.g. `fontSize` on a shape), or a value is out of range (opacity outside 0..1, fontSize/width/height <= 0, non-finite number, wrong primitive type). The message names the element kind and lists the valid keys for it. Dev AND prod. |
+| [`E_NO_ACTIVE_ARTBOARD`](#e_no_active_artboard) | throw | `addElement(spec)`: there is no active artboard to add the element to. Create or select an artboard first (`<Editor.Root>` seeds one automatically; with a raw `EditorProvider` use `executeCreateArtboard`). Replaces the old `handleAddElement` window.alert — agents read throws, not dialogs. |
 | [`E_ASSET_FORBIDDEN`](#e_asset_forbidden) | throw | `assertRenders`: the shop's asset-origin allowlist denied a design asset (translated from the server's 403 — F4). |
 | [`E_RENDER_FAILED`](#e_render_failed) | throw | `assertRenders`: the render failed or produced no usable image (F4). |
 | [`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). |
@@ -118,6 +120,14 @@ the issue key in `error.data.issue`.
 
   `error.data`: `code`, `layerName`, `validNames`, `docSlug`
 
+- `src/hooks/elementPatch.ts`
+
+  ```text
+  no element with ${isToken ? 'layer name' : 'id or layer name'} "${key}" in this document. Valid layer names: ${JSON.stringify(names)}; valid ids: ${JSON.stringify(all.map((el) => el.id))}.
+  ```
+
+  `error.data`: `code`, `layerName`, `validNames`, `validIds`, `docSlug`
+
 ### `E_LAYER_WRONG_KIND`
 
 **Fires when:** The layer exists but is not the kind the part binds (e.g. an image layer passed to `Editor.TextField`).
@@ -406,6 +416,34 @@ the issue key in `error.data.issue`.
 
   `error.data`: `code`, `docSlug`
 
+### `E_INVALID_PATCH`
+
+**Fires when:** `updateElement(target, patch)`: a patch key doesn't apply to the target element's kind (e.g. `fontSize` on a shape), or a value is out of range (opacity outside 0..1, fontSize/width/height <= 0, non-finite number, wrong primitive type). The message names the element kind and lists the valid keys for it. Dev AND prod.
+
+**Docs:** <https://developers.snowcone.app/embed-mode> (`error.data.docSlug`)
+
+- `src/hooks/elementPatch.ts`
+
+  ```text
+  ${message}
+  ```
+
+  `error.data`: `code`, `...data`, `docSlug`
+
+### `E_NO_ACTIVE_ARTBOARD`
+
+**Fires when:** `addElement(spec)`: there is no active artboard to add the element to. Create or select an artboard first (`<Editor.Root>` seeds one automatically; with a raw `EditorProvider` use `executeCreateArtboard`). Replaces the old `handleAddElement` window.alert — agents read throws, not dialogs.
+
+**Docs:** <https://developers.snowcone.app/embed-mode> (`error.data.docSlug`)
+
+- `src/contexts/EditorContext.tsx`
+
+  ```text
+  addElement({ type: "${elementType}" }) needs an active artboard and none exists. <Editor.Root> seeds one automatically; with a raw EditorProvider create one first (executeCreateArtboard) or select one (artboardManager.setActiveArtboard).
+  ```
+
+  `error.data`: `code`, `type`, `docSlug`
+
 ### `E_ASSET_FORBIDDEN`
 
 **Fires when:** `assertRenders`: the shop's asset-origin allowlist denied a design asset (translated from the server's 403 — F4).

package/dist/{CanvasRenderer-6_HhR4-q.js → CanvasRenderer-yszzrDfo.js}

@@ -1,6 +1,6 @@
-import { V as te, X as ee, ar as tt, Y as zt, aE as ne, aC as se, av as Vt, aB as oe, au as ht, aF as ie, aG as Ft, aH as ae, aI as re, c as $t, aJ as le, aK as he, aL as ce, aM as de, a3 as jt, $ as qt, a5 as ft, a0 as Ut, a1 as Ht, a4 as fe, a7 as ge, aN as Ot, aO as ue, aP as pe, aQ as ye, I as be, aR as Se, aS as me, aT as Q } from "./FontAnalyzer-CwIpgTGd.js";
-import { T as Bt, a as Te, u as ve, K as we, z as kt, L as Yt, M as Ce, N as Me, O as xe } from "./ExportManager-DoU4VK6h.js";
-import { i as Lt, a as Re } from "./guards-8rkFAMBs.js";
+import { X as te, Y as ee, ar as tt, Z as zt, aE as ne, aC as se, av as Vt, aB as oe, au as ht, aF as ie, aG as Ft, aH as ae, aI as re, c as $t, aJ as le, aK as he, aL as ce, aM as de, a4 as jt, a0 as qt, a6 as ft, a1 as Ut, a2 as Ht, a5 as fe, a8 as ge, aN as Ot, aO as ue, aP as pe, aQ as ye, I as be, aR as Se, aS as me, aT as Q } from "./FontAnalyzer-EF3gLPr8.js";
+import { T as Bt, a as Te, u as ve, K as we, z as kt, L as Yt, M as Ce, N as Me, O as xe } from "./ExportManager-BTcyj4cf.js";
+import { i as Lt, a as Re } from "./guards-DIX8aXWM.js";
 const it = {
   // Canvas-specific
   canvas: {
@@ -3376,4 +3376,4 @@ export {
   Gt as g,
   Ye as r
 };
-//# sourceMappingURL=CanvasRenderer-6_HhR4-q.js.map
+//# sourceMappingURL=CanvasRenderer-yszzrDfo.js.map