@snowcone-app/canvas 0.30.0 → 0.32.0

package/ERROR_CONTRACT.md

@@ -43,6 +43,7 @@ the issue key in `error.data.issue`.
 | [`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_INVALID_FILL`](#e_invalid_fill) | throw | A shape `fill` value is not a valid `ShapeFill` union member: unknown `type` (valid: "solid" \| "linear" \| "radial"), a gradient with fewer than 2 stops, a stop `offset` outside 0..1 (or non-finite), a non-string stop `color`, or a non-finite linear `angle`. Thrown wherever a fill enters the model — `new ShapeElement(...)` and `updateElement` patches. 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). |
@@ -432,6 +433,16 @@ the issue key in `error.data.issue`.
 
   `error.data`: `code`, `...data`, `docSlug`
 
+### `E_INVALID_FILL`
+
+**Fires when:** A shape `fill` value is not a valid `ShapeFill` union member: unknown `type` (valid: "solid" | "linear" | "radial"), a gradient with fewer than 2 stops, a stop `offset` outside 0..1 (or non-finite), a non-string stop `color`, or a non-finite linear `angle`. Thrown wherever a fill enters the model — `new ShapeElement(...)` and `updateElement` patches. Dev AND prod.
+
+- `src/core/shape-fill.ts`
+
+  ```text
+  ${message}
+  ```
+
 ### `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.

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> ×19
 ```
 
 ### `controls` — Editor.Controls — built-in floating toolbar (no Controls mounted; body portal)
@@ -117,7 +117,7 @@ stable hooks; `sc:`-prefixed utility classes are internal and NOT contract.
           … ×5
         <button aria-expanded="false" aria-label=<label> class="sc-toolbar-btn" type="button">
         <button aria-label=<label> aria-pressed="false">
-          … ×6
+          … ×8
         <button aria-label=<label> aria-pressed="false" disabled>
           …
         <button aria-expanded="false" aria-label=<label> class="sc-toolbar-btn" type="button">
@@ -398,7 +398,7 @@ stable hooks; `sc:`-prefixed utility classes are internal and NOT contract.
         <div>
           …
         <div class="sc-secondary-toolbar-panel-wrapper">
-          … ×16
+          … ×19
   <div data-sc-part="snowcone-editor-idle-dock">
     <div data-sc-part="add">
       <div>