@snowcone-app/canvas 0.27.0 → 0.29.0

package/dist/embed.mjs

@@ -1,9 +1,9 @@
-import { C as a, a as r, b as t, u as i, d as o, f as n, g as d } from "./UnifiedFontService-CHVYDBDW.js";
-import { E as l, R as u, a as E, b as c, S as p, c as g, d as S, f, p as x, e as T, g as v, h as C, v as P } from "./embed-CJswRZte.js";
-import { g as B, i as h, u as y } from "./editorErrors-BhrZ_nwj.js";
-import { D as k, d as D, a as I, i as F } from "./design-builder-cZY958Rw.js";
-import { D as w, T as M, h as A, i as G, j as K, k as _, l as j, m as z, r as N, u as Y, a as q, b as H, c as J, d as O, e as Q, f as U, w as V } from "./template-fields-BXl29sgh.js";
-import { s as X } from "./CanvasStateV1-BTbCD_xC.js";
+import { C as a, a as r, b as t, u as i, d as o, f as n, g as d } from "./UnifiedFontService-CgYnYTj7.js";
+import { E as l, R as u, a as E, b as c, S as p, c as g, d as S, f, p as x, e as T, g as v, h as C, v as P } from "./embed-BTRtoktw.js";
+import { g as B, i as h, u as y } from "./editorErrors-CCvoKj_P.js";
+import { D as k, d as D, a as I, i as F } from "./design-builder-COj0zkxu.js";
+import { D as w, T as M, h as A, i as G, j as K, k as _, l as j, m as z, r as N, u as Y, a as q, b as H, c as J, d as O, e as Q, f as U, w as V } from "./template-fields-BLRp84Ny.js";
+import { s as X } from "./CanvasStateV1-BMxr6xb8.js";
 export {
   a as CanvasServicesProvider,
   k as DesignBuilder,

package/dist/errors/editorError.d.ts

@@ -87,7 +87,13 @@ export type EditorErrorCode =
  | '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';
+ | 'E_AUDIT_NO_ROOT'
+/** `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). */
+ | 'E_DISTRIBUTE_MIN_THREE';
 export interface EditorErrorData {
     code: EditorErrorCode;
     /** Slug under https://developers.snowcone.app/ for the violated contract. */

package/dist/{guards-DIX8aXWM.js → guards-uQtEQJbs.js}

@@ -1,4 +1,4 @@
-import { G as n, I as t, P as a, S as s, T as i } from "./FontAnalyzer-EF3gLPr8.js";
+import { G as n, I as t, P as a, S as s, T as i } from "./FontAnalyzer-D4Sg-P6_.js";
 function r(e) {
   return e instanceof i;
 }
@@ -21,4 +21,4 @@ export {
   r as d,
   u as i
 };
-//# sourceMappingURL=guards-DIX8aXWM.js.map
+//# sourceMappingURL=guards-uQtEQJbs.js.map

package/dist/{guards-DIX8aXWM.js.map → guards-uQtEQJbs.js.map}

@@ -1 +1 @@
-{"version":3,"file":"guards-DIX8aXWM.js","sources":["../src/types/guards.ts"],"sourcesContent":["/**\n * Type guards for EditorElement discrimination\n *\n * These guards use instanceof checks against the concrete element classes,\n * matching the pattern established in EditorContext.tsx. They accept\n * BaseElement | EditorElement | undefined | null for maximum flexibility\n * at call sites.\n */\n\nimport { BaseElement } from '../core/BaseElement.js';\nimport { TextElement } from '../core/TextElement.js';\nimport { ImageElement } from '../core/ImageElement.js';\nimport { GroupElement } from '../core/GroupElement.js';\nimport { ShapeElement } from '../core/ShapeElement.js';\nimport { PathElement } from '../core/PathElement.js';\n\ntype Narrowable = BaseElement | TextElement | ImageElement | GroupElement | ShapeElement | PathElement | undefined | null;\n\n/**\n * Type guard: checks if an element is a TextElement (or any text-based transform subclass).\n *\n * TextElement is the base class for all text transforms (custom, circle, arch, wave, etc.),\n * so this returns true for any text-based element regardless of its specific transformType.\n */\nexport function isTextElement(element: Narrowable): element is TextElement {\n  return element instanceof TextElement;\n}\n\n/**\n * Type guard: checks if an element is an ImageElement.\n */\nexport function isImageElement(element: Narrowable): element is ImageElement {\n  return element instanceof ImageElement;\n}\n\n/**\n * Type guard: checks if an element is a GroupElement.\n */\nexport function isGroupElement(element: Narrowable): element is GroupElement {\n  return element instanceof GroupElement;\n}\n\n/**\n * Type guard: checks if an element is a ShapeElement.\n */\nexport function isShapeElement(element: Narrowable): element is ShapeElement {\n  return element instanceof ShapeElement;\n}\n\n/**\n * Type guard: checks if an element is a PathElement.\n */\nexport function isPathElement(element: Narrowable): element is PathElement {\n  return element instanceof PathElement;\n}\n"],"names":["isTextElement","element","TextElement","isImageElement","ImageElement","isGroupElement","GroupElement","isShapeElement","ShapeElement","isPathElement","PathElement"],"mappings":";AAwBO,SAASA,EAAcC,GAA6C;AACzE,SAAOA,aAAmBC;AAC5B;AAKO,SAASC,EAAeF,GAA8C;AAC3E,SAAOA,aAAmBG;AAC5B;AAKO,SAASC,EAAeJ,GAA8C;AAC3E,SAAOA,aAAmBK;AAC5B;AAKO,SAASC,EAAeN,GAA8C;AAC3E,SAAOA,aAAmBO;AAC5B;AAKO,SAASC,EAAcR,GAA6C;AACzE,SAAOA,aAAmBS;AAC5B;"}
+{"version":3,"file":"guards-uQtEQJbs.js","sources":["../src/types/guards.ts"],"sourcesContent":["/**\n * Type guards for EditorElement discrimination\n *\n * These guards use instanceof checks against the concrete element classes,\n * matching the pattern established in EditorContext.tsx. They accept\n * BaseElement | EditorElement | undefined | null for maximum flexibility\n * at call sites.\n */\n\nimport { BaseElement } from '../core/BaseElement.js';\nimport { TextElement } from '../core/TextElement.js';\nimport { ImageElement } from '../core/ImageElement.js';\nimport { GroupElement } from '../core/GroupElement.js';\nimport { ShapeElement } from '../core/ShapeElement.js';\nimport { PathElement } from '../core/PathElement.js';\n\ntype Narrowable = BaseElement | TextElement | ImageElement | GroupElement | ShapeElement | PathElement | undefined | null;\n\n/**\n * Type guard: checks if an element is a TextElement (or any text-based transform subclass).\n *\n * TextElement is the base class for all text transforms (custom, circle, arch, wave, etc.),\n * so this returns true for any text-based element regardless of its specific transformType.\n */\nexport function isTextElement(element: Narrowable): element is TextElement {\n  return element instanceof TextElement;\n}\n\n/**\n * Type guard: checks if an element is an ImageElement.\n */\nexport function isImageElement(element: Narrowable): element is ImageElement {\n  return element instanceof ImageElement;\n}\n\n/**\n * Type guard: checks if an element is a GroupElement.\n */\nexport function isGroupElement(element: Narrowable): element is GroupElement {\n  return element instanceof GroupElement;\n}\n\n/**\n * Type guard: checks if an element is a ShapeElement.\n */\nexport function isShapeElement(element: Narrowable): element is ShapeElement {\n  return element instanceof ShapeElement;\n}\n\n/**\n * Type guard: checks if an element is a PathElement.\n */\nexport function isPathElement(element: Narrowable): element is PathElement {\n  return element instanceof PathElement;\n}\n"],"names":["isTextElement","element","TextElement","isImageElement","ImageElement","isGroupElement","GroupElement","isShapeElement","ShapeElement","isPathElement","PathElement"],"mappings":";AAwBO,SAASA,EAAcC,GAA6C;AACzE,SAAOA,aAAmBC;AAC5B;AAKO,SAASC,EAAeF,GAA8C;AAC3E,SAAOA,aAAmBG;AAC5B;AAKO,SAASC,EAAeJ,GAA8C;AAC3E,SAAOA,aAAmBK;AAC5B;AAKO,SAASC,EAAeN,GAA8C;AAC3E,SAAOA,aAAmBO;AAC5B;AAKO,SAASC,EAAcR,GAA6C;AACzE,SAAOA,aAAmBS;AAC5B;"}

package/dist/hooks/index.d.ts

@@ -40,3 +40,5 @@ export { useCanvasEvents } from './useCanvasEvents';
 export { useCommandHistory } from './useCommandHistory';
 export { useKeyboardShortcuts } from './useKeyboardShortcuts';
 export { useElementProperties } from './useElementProperties';
+export { useAlignDistribute } from './useAlignDistribute';
+export type { UseAlignDistributeResult, AlignMode, DistributeMode } from './useAlignDistribute';

package/dist/hooks/useAlignDistribute.d.ts

@@ -0,0 +1,19 @@
+import { AlignMode, DistributeMode } from '../utils/alignDistribute.js';
+export type { AlignMode, DistributeMode } from '../utils/alignDistribute.js';
+export interface UseAlignDistributeResult {
+    /** Number of movable (selected, unlocked) elements. */
+    movableCount: number;
+    /** True when align commands have something to act on. */
+    canAlign: boolean;
+    /** True when distribute commands are available (≥3 movable elements).
+     *  UI must gate rendering of distribute affordances on this. */
+    canDistribute: boolean;
+    /** Align the movable selection. ≥2 elements: relative to the selection's
+     *  combined bbox; exactly 1: relative to the active artboard. */
+    align: (mode: AlignMode) => void;
+    /** Distribute the movable selection with equal gaps between bbox edges.
+     *  Throws `E_DISTRIBUTE_MIN_THREE` when `canDistribute` is false. */
+    distribute: (mode: DistributeMode) => void;
+}
+export declare function useAlignDistribute(): UseAlignDistributeResult;
+export default useAlignDistribute;

package/dist/hooks/useTextToolbar.d.ts

@@ -12,8 +12,16 @@ export interface UseTextToolbarReturn {
     italic: boolean;
     underline: boolean;
     letterCase: string;
+    /** Letter-spacing in px per character (element-level default; 0 = none). */
+    letterSpacing: number;
+    /** Line-height multiplier (1.2 = the layout default). */
+    lineHeight: number;
     handleFontSizeChange: (size: number) => void;
     handleFontSizeIncrement: (delta: number) => void;
+    /** Per-character aware (applies to the selection while editing text). */
+    handleLetterSpacingChange: (spacing: number) => void;
+    /** Element-level only (line layout is an element concern, not a span one). */
+    handleLineHeightChange: (lineHeight: number) => void;
     handleFontFamilyChange: (family: string) => void;
     handleFontColorChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
     handleBoldToggle: () => void;

package/dist/index.mjs

@@ -1,12 +1,12 @@
-import { e as u } from "./UnifiedFontService-CHVYDBDW.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-CHVYDBDW.js";
-import { E as _, S as y, S as L, u as O, a as M } from "./SnowconeCanvas-DuWALOAt.js";
-import { u as d, a as m } from "./editorErrors-BhrZ_nwj.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-BXl29sgh.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-DGXAQmUC.js";
-import { C as W, D as X, d as $, s as ee } from "./design-builder-cZY958Rw.js";
+import { e as u } from "./UnifiedFontService-CgYnYTj7.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-CgYnYTj7.js";
+import { E as _, S as y, S as L, u as O, a as M } from "./SnowconeCanvas-CR_LdRFP.js";
+import { u as d, a as m } from "./editorErrors-CCvoKj_P.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-BLRp84Ny.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-eCebhplp.js";
+import { C as W, D as X, d as $, s as ee } from "./design-builder-COj0zkxu.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-BTbCD_xC.js";
+import { d as oe, m as ie, s as ne, v as ue } from "./CanvasStateV1-BMxr6xb8.js";
 function C() {
   const { isCanvasReady: e } = d();
   return e;

package/dist/internals.mjs

@@ -1,8 +1,8 @@
-import { A as w, a as b, C as I, I as R, R as W, S as A, T as E } from "./CanvasRenderer-yszzrDfo.js";
-import { r as p } from "./ExportManager-BTcyj4cf.js";
-import { D as O, E as F, I as L, W as X, a as z, b as K, c as Y, d as B, e as _, f as J, h as N, i as V, j, k as q, l as Q, m as U, n as Z, o as $, p as m, q as G, s as x, t as D, u as rr, v as or, w as sr, x as ir, y as er, z as ar, A as nr, B as tr, C as hr } from "./ExportManager-BTcyj4cf.js";
-import { D as cr, E as fr, H as pr, J as gr, K as lr, L as ur, M as Tr, N as kr, O as Mr, Q as yr, W as Cr, V as vr, X as Sr, Y as Pr, c as wr, Z as br, _ as Ir, $ as Rr, a0 as Wr, a1 as Ar } from "./FontAnalyzer-EF3gLPr8.js";
-import { A as Hr, e as Or, C as Fr, S as Lr } from "./CanvasStateV1-BTbCD_xC.js";
+import { A as w, a as b, C as I, I as R, R as W, S as A, T as E } from "./CanvasRenderer-_lFoIoz5.js";
+import { r as p } from "./ExportManager-B8Td7uR5.js";
+import { D as O, E as F, I as L, W as X, a as z, b as K, c as Y, d as B, e as _, f as J, h as N, i as V, j, k as q, l as Q, m as U, n as Z, o as $, p as m, q as G, s as x, t as D, u as rr, v as or, w as sr, x as ir, y as er, z as ar, A as nr, B as tr, C as hr } from "./ExportManager-B8Td7uR5.js";
+import { D as cr, E as fr, H as pr, J as gr, K as lr, L as ur, M as Tr, N as kr, O as Mr, Q as yr, W as Cr, V as vr, X as Sr, Y as Pr, c as wr, Z as br, _ as Ir, $ as Rr, a0 as Wr, a1 as Ar } from "./FontAnalyzer-D4Sg-P6_.js";
+import { A as Hr, e as Or, C as Fr, S as Lr } from "./CanvasStateV1-BMxr6xb8.js";
 function y(r, o) {
   return !r.needsCropPixelConversion || r.cropWidth === void 0 ? r : {
     ...r,

package/dist/rendering/renderer-types.d.ts

@@ -19,6 +19,10 @@ export interface SerializedTextElement {
     italic: boolean;
     underline: boolean;
     strikethrough: boolean;
+    /** Extra advance per character in px (custom transform only; spans may override). */
+    letterSpacing?: number;
+    /** Line-height multiplier; undefined = LINE_HEIGHT_MULTIPLIER (1.2). Custom transform only. */
+    lineHeight?: number;
     transformData: AnyTransformData;
     stroke?: StrokeConfig;
     openTypeFeatures?: OpenTypeFeatures;

package/dist/rendering/rich-text-renderer.d.ts

@@ -15,4 +15,8 @@ export declare function renderRichTextFillOnly(ctx: RenderContext, richText: Ric
     underline?: boolean;
     strikethrough?: boolean;
     textAlign?: TextAlign;
+    /** Element-level letter-spacing default (px/char); spans may override. */
+    letterSpacing?: number;
+    /** Line-height multiplier; undefined = LINE_HEIGHT_MULTIPLIER (1.2). */
+    lineHeight?: number;
 }, maxWidth?: number, lockedLineCount?: number): void;

package/dist/rendering/text-renderer.d.ts

@@ -6,8 +6,9 @@ import { RenderContext, SerializedTextElement } from './renderer-types.js';
 export declare function buildFontString(fontSize: number, fontFamily: string, bold?: boolean, italic?: boolean): string;
 /**
  * Measure text width
+ * @param letterSpacing - Extra advance per character in px (default 0 — legacy width)
  */
-export declare function measureTextWidth(text: string, fontSize: number, fontFamily: string, bold?: boolean, italic?: boolean): number;
+export declare function measureTextWidth(text: string, fontSize: number, fontFamily: string, bold?: boolean, italic?: boolean, letterSpacing?: number): number;
 /**
  * Get font metrics for accurate text positioning
  */
@@ -49,6 +50,8 @@ export declare function renderTextFillOnly(ctx: RenderContext, element: {
     italic?: boolean;
     textAlign?: TextAlign;
     color: string;
+    /** Extra advance per character in px (custom transform only). */
+    letterSpacing?: number;
 }): void;
 /**
  * Word wrap text to fit within a given width

package/dist/state/CanvasStateV1.d.ts

@@ -74,6 +74,7 @@ declare const CharacterStyleSchema: z.ZodObject<{
     italic: z.ZodOptional<z.ZodBoolean>;
     underline: z.ZodOptional<z.ZodBoolean>;
     strikethrough: z.ZodOptional<z.ZodBoolean>;
+    letterSpacing: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 declare const TextSpanSchema: z.ZodObject<{
     text: z.ZodString;
@@ -85,6 +86,7 @@ declare const TextSpanSchema: z.ZodObject<{
         italic: z.ZodOptional<z.ZodBoolean>;
         underline: z.ZodOptional<z.ZodBoolean>;
         strikethrough: z.ZodOptional<z.ZodBoolean>;
+        letterSpacing: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 declare const RichTextSchema: z.ZodObject<{
@@ -98,6 +100,7 @@ declare const RichTextSchema: z.ZodObject<{
             italic: z.ZodOptional<z.ZodBoolean>;
             underline: z.ZodOptional<z.ZodBoolean>;
             strikethrough: z.ZodOptional<z.ZodBoolean>;
+            letterSpacing: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/{template-fields-BXl29sgh.js → template-fields-BLRp84Ny.js}

@@ -1,10 +1,10 @@
-import { g as C, u as ut, c as Y, b as W } from "./editorErrors-BhrZ_nwj.js";
-import { l as it, i as gt, a as Nt } from "./design-builder-cZY958Rw.js";
+import { g as C, u as ut, c as Y, b as W } from "./editorErrors-CCvoKj_P.js";
+import { l as it, i as gt, a as Nt } from "./design-builder-COj0zkxu.js";
 import { toOptionAttributes as St, toCombinations as It, getMissingSelections as wt, validateProductSelection as Ot, findBestCombination as J, computeDisabledChoices as At } from "@snowcone-app/sdk";
 import { useRef as E, useCallback as I, useEffect as Tt, useContext as ht, useId as kt, useLayoutEffect as Dt, useMemo as V, useState as ot } from "react";
-import { G as Bt, I as z, P as _t, S as Ft, T as K, z as yt, U as st, c as Ut, y as rt } from "./FontAnalyzer-EF3gLPr8.js";
-import { p as pt, U as Rt } from "./UnifiedFontService-CHVYDBDW.js";
-import { a as Lt, o as R, b as d, n as Pt, l as b, u as at, c as Yt } from "./CanvasStateV1-BTbCD_xC.js";
+import { G as Bt, I as z, P as _t, S as Ft, T as K, z as yt, U as st, c as Ut, y as rt } from "./FontAnalyzer-D4Sg-P6_.js";
+import { p as pt, U as Rt } from "./UnifiedFontService-CgYnYTj7.js";
+import { a as Lt, o as R, b as d, n as Pt, l as b, u as at, c as Yt } from "./CanvasStateV1-BMxr6xb8.js";
 function X(e) {
   return e.text;
 }
@@ -713,4 +713,4 @@ export {
   Oe as u,
   De as w
 };
-//# sourceMappingURL=template-fields-BXl29sgh.js.map
+//# sourceMappingURL=template-fields-BLRp84Ny.js.map