@snowcone-app/canvas 0.22.0 → 0.26.0

package/dist/embed.mjs

@@ -1,45 +1,48 @@
-import { C as a, a as r, b as o, u as t, d as i, f as d, g as n } from "./UnifiedFontService-CC3CSmH5.js";
-import { E as m, R as l, a as E, b as c, S as p, c as g, f, p as S, d as x, e as v, v as T } from "./embed-8ecUMMH-.js";
-import { g as B, i as C, u as y } from "./editorErrors-B2mb1sVN.js";
-import { D as R, d as D, i as F } from "./design-builder-CT4DHIPe.js";
-import { D as L, T as k, r as w, u as M, a as h, b as A, c as _, d as z, e as G, f as K, w as N } from "./template-fields-C2pSfMBh.js";
-import { s as j } from "./CanvasStateV1-DmZ1Qvvn.js";
+import { C as a, a as r, b as o, u as t, d as i, f as d, g as n } from "./UnifiedFontService-Bx2MxFfy.js";
+import { E as m, R as l, a as E, b as c, S as g, c as p, d as f, f as S, p as x, e as T, g as v, h as C, v as b } from "./embed-DXGydZOT.js";
+import { g as P, i as y, u as R } from "./editorErrors-B2mb1sVN.js";
+import { D as k, d as F, a as I, i as L } from "./design-builder-U7Su9MMC.js";
+import { D as w, T as M, r as A, u as _, a as z, b as G, c as K, d as N, e as Y, f as j, w as q } from "./template-fields-DJ157D3E.js";
+import { s as J } from "./CanvasStateV1-DmZ1Qvvn.js";
 export {
   a as CanvasServicesProvider,
-  R as DesignBuilder,
-  L as DesignStateStore,
+  k as DesignBuilder,
+  w as DesignStateStore,
   m as Editor,
-  B as EditorError,
+  P as EditorError,
   l as RealtimeCanvas,
   E as RealtimeEmbed,
   c as RealtimeMockup,
-  p as SnowconeEditor,
-  k as TEMPLATE_FIELDS_KEY,
-  g as collectEmbedIssues,
+  g as SnowconeEditor,
+  M as TEMPLATE_FIELDS_KEY,
+  p as auditEditor,
+  f as collectEmbedIssues,
   r as createProxyGenerate,
   o as createProxyImageSearch,
-  D as design,
-  f as formatBuyPrice,
-  C as isEditorError,
-  F as isLayerToken,
-  S as productToRenderConfig,
-  w as readTemplateFields,
-  j as serializeState,
+  F as design,
+  S as formatBuyPrice,
+  I as isColorToken,
+  y as isEditorError,
+  L as isLayerToken,
+  x as productToRenderConfig,
+  A as readTemplateFields,
+  J as serializeState,
   t as useArtboards,
   i as useCanvasServices,
-  M as useColorBinding,
-  h as useCommands,
-  y as useEditor,
-  A as useElementByName,
+  _ as useColorBinding,
+  z as useCommands,
+  R as useEditor,
+  G as useElementByName,
   d as useExport,
-  _ as useFontBinding,
-  z as useImageBinding,
+  K as useFontBinding,
+  N as useImageBinding,
   n as useLayers,
-  x as useProductSelection,
-  v as useRealtimeMockups,
-  G as useSelectedElement,
-  K as useTextBinding,
-  T as validateEmbed,
-  N as withTemplateFields
+  T as usePlacements,
+  v as useProductSelection,
+  C as useRealtimeMockups,
+  Y as useSelectedElement,
+  j as useTextBinding,
+  b as validateEmbed,
+  q as withTemplateFields
 };
 //# sourceMappingURL=embed.mjs.map

package/dist/errors/editorError.d.ts

@@ -36,9 +36,32 @@ export type EditorErrorCode =
 /** `productToRenderConfig`: the catalog product has no renderable image
  *  placement / no mockup scenes, or the requested placement doesn't exist. */
  | 'E_PRODUCT_NOT_RENDERABLE'
+/** `design().artboard()`: an artboard with this label already exists in the
+ *  design (artboard names are placement labels — unique by contract). */
+ | 'E_DUPLICATE_ARTBOARD'
+/** `usePlacements().select()`: the label names no artboard in the design
+ *  (ADR-0088). Lists the valid placement labels. */
+ | 'E_UNKNOWN_PLACEMENT'
 /** `select()` named an option key/choice that doesn't exist on the product
  *  (Buy-owned selection, ADR-0085 §2 / P2). */
  | 'E_UNKNOWN_OPTION'
+/** `design({ colors })`: two color roles share one (normalized) hex value.
+ *  `useColorBinding` matches by VALUE, so colliding roles would capture each
+ *  other's elements — rejected at mint time instead of failing subtly. */
+ | 'E_COLOR_ROLE_COLLISION'
+/** `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_INVALID'
+/** `design.color(name)`: no color role with this name — lists the design's
+ *  declared roles. */
+ | 'E_COLOR_ROLE_NOT_FOUND'
+/** `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_PREVIEW_NO_LOADER'
 /** `assertRenders`: the shop's asset-origin allowlist denied a design asset
  *  (translated from the server's 403 — F4). */
  | 'E_ASSET_FORBIDDEN'
@@ -49,7 +72,10 @@ export type EditorErrorCode =
  | 'E_BINDING_INERT'
 /** `assertRenders`: the design has no named text layer to mutate and no
  *  `mutate` override was given (F4). */
- | 'E_NO_MUTABLE_BINDING';
+ | 'E_NO_MUTABLE_BINDING'
+/** `auditEditor()` called with no `<Editor.Root>` mounted — the imperative
+ *  audit reads the most-recent mounted Root's registry (#10). */
+ | 'E_AUDIT_NO_ROOT';
 export interface EditorErrorData {
     code: EditorErrorCode;
     /** Slug under https://developers.snowcone.app/ for the violated contract. */

package/dist/hooks/bindingGuards.d.ts

@@ -0,0 +1,16 @@
+import { LayerKind, LayerToken } from '../design/design-builder.js';
+import { ElementStore } from '../core/ElementStore.js';
+/**
+ * Under `<Editor.Root>`, declare that this binding hook needs a mounted
+ * `Editor.Canvas` — Root's registry validation throws `E_REQUIRES_CANVAS`
+ * (its existing single validation point) when none is in the composition.
+ * No-op outside a Root.
+ */
+export declare function useBindingRequiresCanvas(hookName: string): void;
+/**
+ * Accept a binding hook's `string | LayerToken` argument and return the bare
+ * layer name. With a token under `<Editor.Root>`, mount-validate it against
+ * the first non-empty element snapshot (see module doc). Bare strings keep
+ * the settle-aware dead-binding console.warn instead.
+ */
+export declare function useValidatedBindingLayer(layerOrName: string | LayerToken, expectedKind: LayerKind, elementStore: ElementStore): string;

package/dist/hooks/useColorBinding.d.ts

@@ -1,3 +1,4 @@
+import { ColorToken } from '../design/design-builder.js';
 import { EditorElement } from '../contexts/EditorContext.js';
 /** Result returned by {@link useColorBinding}. */
 export interface ColorBindingResult {
@@ -18,4 +19,4 @@ export interface ColorBindingResult {
  * @param originalColor - The hex color to match (the template field's `color`).
  * @returns Applied color, setter, matching elements, and connection status.
  */
-export declare function useColorBinding(originalColor: string): ColorBindingResult;
+export declare function useColorBinding(original: string | ColorToken): ColorBindingResult;

package/dist/hooks/useFontBinding.d.ts

@@ -1,4 +1,5 @@
 import { EditorElement } from '../contexts/EditorContext.js';
+import { LayerToken } from '../design/design-builder.js';
 /** Result returned by {@link useFontBinding}. */
 export interface FontBindingResult {
     /** Current font family (from first bound element). Empty string if disconnected. */
@@ -20,4 +21,4 @@ export interface FontBindingResult {
  * @param name - The element name to bind to.
  * @returns Font family, setter, element references, and connection status.
  */
-export declare function useFontBinding(name: string): FontBindingResult;
+export declare function useFontBinding(layer: string | LayerToken<'text'>): FontBindingResult;

package/dist/hooks/useImageBinding.d.ts

@@ -1,4 +1,5 @@
 import { EditorElement } from '../contexts/EditorContext.js';
+import { LayerToken } from '../design/design-builder.js';
 /** How the image fits the element bounds. */
 export type ImageFitMode = 'cover' | 'contain';
 /** Options for {@link useImageBinding}. */
@@ -31,4 +32,4 @@ export interface ImageBindingResult {
  * @param options - Optional configuration (fit mode, etc.).
  * @returns Image URL value, setter, element references, and connection status.
  */
-export declare function useImageBinding(name: string, options?: ImageBindingOptions): ImageBindingResult;
+export declare function useImageBinding(layer: string | LayerToken<'image'>, options?: ImageBindingOptions): ImageBindingResult;

package/dist/hooks/useTextBinding.d.ts

@@ -1,4 +1,5 @@
 import { EditorElement } from '../contexts/EditorContext.js';
+import { LayerToken } from '../design/design-builder.js';
 /** Result returned by {@link useTextBinding}. */
 export interface TextBindingResult {
     /** Current plain text content (from first bound element). Empty string if disconnected. */
@@ -23,4 +24,4 @@ export interface TextBindingResult {
  * @param name - The element name to bind to.
  * @returns Text value, setter, element references, and connection status.
  */
-export declare function useTextBinding(name: string): TextBindingResult;
+export declare function useTextBinding(layer: string | LayerToken<'text'>): TextBindingResult;

package/dist/index.mjs

@@ -1,10 +1,10 @@
-import { e as u } from "./UnifiedFontService-CC3CSmH5.js";
-import { C as l, c as x, a as I, b as v, u as A, d as T, f as g, g as B } from "./UnifiedFontService-CC3CSmH5.js";
-import { E as _, S as y, S as L, u as O, a as M } from "./SnowconeCanvas-Cx7nXlBI.js";
+import { e as u } from "./UnifiedFontService-Bx2MxFfy.js";
+import { C as l, c as x, a as I, b as v, u as A, d as T, f as g, g as B } from "./UnifiedFontService-Bx2MxFfy.js";
+import { E as _, S as y, S as L, u as O, a as M } from "./SnowconeCanvas-4ef4a61J.js";
 import { u as d, a as m } from "./editorErrors-B2mb1sVN.js";
-import { T as z, r as w, u as F, a as D, b as K, c as N, d as V, e as b, f as h, w as U } from "./template-fields-C2pSfMBh.js";
-import { A as Z, C as G, E as H, M as j, P as k, r as q, v as J } from "./validation-C9Fe9ahK.js";
-import { C as W, D as X, d as $, s as ee } from "./design-builder-CT4DHIPe.js";
+import { T as z, r as w, u as F, a as D, b as K, c as N, d as V, e as b, f as h, w as U } from "./template-fields-DJ157D3E.js";
+import { A as Z, C as G, E as H, M as j, P as k, r as q, v as J } from "./validation-DnAkXdUg.js";
+import { C as W, D as X, d as $, s as ee } from "./design-builder-U7Su9MMC.js";
 import { c as se, e as te } from "./compose-DtQL_oit.js";
 import { d as oe, m as ie, s as ne, v as ue } from "./CanvasStateV1-DmZ1Qvvn.js";
 function C() {