@snowcone-app/canvas 0.22.0 → 0.23.0

package/dist/embed.mjs

@@ -1,45 +1,46 @@
 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 { 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 T, v } from "./embed-DxsaqZJF.js";
+import { g as b, i as B, u as y } from "./editorErrors-B2mb1sVN.js";
+import { D as R, d as D, a as k, i as F } from "./design-builder-2VUjfmdt.js";
+import { D as L, T as w, r as M, u as h, a as A, b as _, c as z, d as G, e as K, f as N, w as Y } from "./template-fields-CQ6n2P4V.js";
+import { s as q } from "./CanvasStateV1-DmZ1Qvvn.js";
 export {
   a as CanvasServicesProvider,
   R as DesignBuilder,
   L as DesignStateStore,
   m as Editor,
-  B as EditorError,
+  b as EditorError,
   l as RealtimeCanvas,
   E as RealtimeEmbed,
   c as RealtimeMockup,
   p as SnowconeEditor,
-  k as TEMPLATE_FIELDS_KEY,
+  w as TEMPLATE_FIELDS_KEY,
   g as collectEmbedIssues,
   r as createProxyGenerate,
   o as createProxyImageSearch,
   D as design,
   f as formatBuyPrice,
-  C as isEditorError,
+  k as isColorToken,
+  B as isEditorError,
   F as isLayerToken,
   S as productToRenderConfig,
-  w as readTemplateFields,
-  j as serializeState,
+  M as readTemplateFields,
+  q as serializeState,
   t as useArtboards,
   i as useCanvasServices,
-  M as useColorBinding,
-  h as useCommands,
+  h as useColorBinding,
+  A as useCommands,
   y as useEditor,
-  A as useElementByName,
+  _ as useElementByName,
   d as useExport,
-  _ as useFontBinding,
-  z as useImageBinding,
+  z as useFontBinding,
+  G 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 useRealtimeMockups,
+  K as useSelectedElement,
+  N as useTextBinding,
+  v as validateEmbed,
+  Y as withTemplateFields
 };
 //# sourceMappingURL=embed.mjs.map

package/dist/errors/editorError.d.ts

@@ -39,6 +39,16 @@ export type EditorErrorCode =
 /** `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'
 /** `assertRenders`: the shop's asset-origin allowlist denied a design asset
  *  (translated from the server's 403 — F4). */
  | 'E_ASSET_FORBIDDEN'

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 _, S as y, S as L, u as O, a as M } from "./SnowconeCanvas-D1sLcIja.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 { 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-CQ6n2P4V.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 { C as W, D as X, d as $, s as ee } from "./design-builder-2VUjfmdt.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() {