@snowcone-app/canvas 0.27.0 → 0.28.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_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. |
 | [`empty-mockup-ids`](#empty-mockup-ids) | error → throws `E_EMBED_CONFIG` | `product.mockupIds` is empty — nothing to render. |
@@ -536,6 +537,18 @@ the issue key in `error.data.issue`.
 
   `error.data`: `code`, `docSlug`
 
+### `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).
+
+- `src/utils/alignDistribute.ts`
+
+  ```text
+  distribute ${mode} needs at least ${DISTRIBUTE_MIN_COUNT} movable elements, got ${items.length}. Gate the action on useAlignDistribute().canDistribute (or items.length >= DISTRIBUTE_MIN_COUNT) instead of calling computeDistribute below the threshold.
+  ```
+
+  `error.data`: `code`, `mode`, `count`, `min`
+
 ## Embed wiring issues (the `onIssue` channel)
 
 Mount-time wiring problems and runtime stalls are `EmbedIssue` objects