@overtone-art/canvas-editor-core 0.5.0 → 0.6.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { Canvas, FabricObject, Point, ImageFormat, Group } from 'fabric';
-import { b as EditorEvents, o as LayerType, m as LayerMeta, L as LayerData, X as SerializedLayer, P as PatternConfig, K as PatternLocks, a1 as TextCurveConfig, t as MaskPresetId, Y as ShapeMaskPresetId, a2 as TextureMaskPresetId, a4 as Unit, J as MockupPrintArea, z as MockupConfig, e as FontDefinition, p as LicenseConfig, r as LicenseStatus, T as ProjectState, M as MaskBrushOptions, s as MaskPoint, v as MaskRefinementProvider, u as MaskRefinementPrompt, x as MaskRefinementResult, k as LayerMaskEntry, l as LayerMaskMode, E as EditorConfig, Z as ShapePlugin, $ as TemplateDefinition, I as ImageAdjustments, c as EditorState, V as SemanticExportOptions, _ as SvgExportOptions, R as PrintifyPositioning, N as NormalizedLayerPosition, Q as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, W as SerializedBackgroundImageOptions, B as BackgroundImageOptions, U as ResizeOptions, a as DpiIssue, n as LayerShadowConfig, C as CanvasSizePreset, A as MockupDisplacement } from './types-JP8MZsIs.mjs';
-export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, q as LicensePayload, w as MaskRefinementRequest, y as MockupBlendMode, G as MockupDisplacementChannel, H as MockupOverlay, O as PatternState, S as ProjectPage, a0 as TemplateParameter, a3 as TileMode } from './types-JP8MZsIs.mjs';
+import { b as EditorEvents, o as LayerType, m as LayerMeta, L as LayerData, X as SerializedLayer, P as PatternConfig, K as PatternLocks, a1 as TextCurveConfig, a2 as TextCurveInput, t as MaskPresetId, Y as ShapeMaskPresetId, a4 as TextureMaskPresetId, a6 as Unit, J as MockupPrintArea, z as MockupConfig, e as FontDefinition, p as LicenseConfig, r as LicenseStatus, T as ProjectState, M as MaskBrushOptions, s as MaskPoint, v as MaskRefinementProvider, u as MaskRefinementPrompt, x as MaskRefinementResult, k as LayerMaskEntry, l as LayerMaskMode, E as EditorConfig, Z as ShapePlugin, $ as TemplateDefinition, I as ImageAdjustments, c as EditorState, V as SemanticExportOptions, _ as SvgExportOptions, R as PrintifyPositioning, N as NormalizedLayerPosition, Q as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, W as SerializedBackgroundImageOptions, B as BackgroundImageOptions, U as ResizeOptions, a as DpiIssue, n as LayerShadowConfig, C as CanvasSizePreset, A as MockupDisplacement } from './types-LM7pOkkj.mjs';
+export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, q as LicensePayload, w as MaskRefinementRequest, y as MockupBlendMode, G as MockupDisplacementChannel, H as MockupOverlay, O as PatternState, S as ProjectPage, a0 as TemplateParameter, a3 as TextCurveShape, a5 as TileMode } from './types-LM7pOkkj.mjs';
 
 type EventHandler<T> = (data: T) => void;
 declare class EventEmitter<TEvents extends {} = Record<string, unknown>> {
@@ -28,6 +28,14 @@ declare class Layer {
      * the layer's real object stays the one every editor API talks to.
      */
     renderProxy: FabricObject | null;
+    /**
+     * Layers nested inside this one, in draw order. Only a `group` layer has any:
+     * their fabric objects live inside this layer's fabric `Group`, not on the
+     * canvas, which is why the manager keeps them off the canvas stack.
+     */
+    children: Layer[];
+    /** Group this layer sits inside, or null when it is on the canvas stack. */
+    parentId: string | null;
     constructor(type: LayerType, fabricObject: FabricObject, name?: string, id?: string);
     private hasMeta;
     toData(): LayerData;
@@ -42,6 +50,26 @@ declare class LayerManager {
     setHistoryCallback(callback: () => void): void;
     add(type: LayerType, fabricObject: FabricObject, name?: string, id?: string): Layer;
     remove(id: string): boolean;
+    /**
+     * Take a top-level layer off the canvas stack **without** disposing it — it is
+     * about to become a group's child, so its object has to stay alive.
+     */
+    detach(id: string): Layer | undefined;
+    /** Put a group's children back on the canvas stack and drop the group. */
+    explode(group: Layer): Layer[];
+    /**
+     * Empty a group onto the canvas stack, in the group's own place, and drop the
+     * group record. `removeAll` restores each child's absolute transform, so the
+     * group's matrix must NOT be re-applied on top of it.
+     */
+    private dissolve;
+    /**
+     * Re-attach child records to an enlivened group. `data[i]` describes
+     * `group._objects[i]` — the order fabric serializes and restores them in. A
+     * missing record still becomes a child, so a hand-edited state cannot drop
+     * artwork off the canvas.
+     */
+    adoptGroupChildren(group: Layer, data: LayerData[]): void;
     /** Replace a layer's render object while preserving its immutable ID and panel state. */
     replaceObject(id: string, fabricObject: FabricObject): boolean;
     /**
@@ -57,10 +85,26 @@ declare class LayerManager {
      * front-to-back instead of computed.
      */
     private syncZOrder;
+    /** The list a layer lives in: its group's children, or the canvas stack. */
+    private siblingsOf;
     reorder(id: string, newIndex: number): boolean;
     select(id: string | null): void;
+    /** Drill into a group so its children can be selected and clicked. */
+    private enterGroup;
+    /** Leave every entered group — selecting anything else is done drilling in. */
+    exitGroups(): void;
+    /**
+     * Select several layers at once, as one fabric `ActiveSelection`. Children are
+     * skipped: a selection spanning in and out of a group has no single transform.
+     */
+    selectMany(ids: string[]): void;
+    /** Depth-first over the whole tree, each layer before its children. */
+    private walk;
     get(id: string): Layer | undefined;
+    /** Top-level layers only — the canvas stack. Children hang off their group. */
     getAll(): Layer[];
+    /** Top-level layers, each carrying its children: what the layer panel renders. */
+    getTree(): LayerData[];
     findByObject(obj: FabricObject): Layer | undefined;
     setVisibility(id: string, visible: boolean): void;
     setLocked(id: string, locked: boolean): void;
@@ -323,8 +367,32 @@ declare class TiledPatternObject extends FabricObject {
      * tiling. The copy shares the source (it only ever reads from it).
      */
     clone(): Promise<this>;
+    /**
+     * The source's tile footprint: its bounding box, minus a stroke it reserves
+     * room for but never paints.
+     *
+     * fabric keeps `strokeWidth` inside an object's box whether or not a `stroke`
+     * colour paints it, and the built-in shapes arrive with `strokeWidth: 1` and no
+     * stroke. Stepping the grid by that box puts a transparent seam between every
+     * pair of neighbours at zero spacing: the artwork is a pixel narrower than the
+     * box it is stepped by.
+     */
+    private sourceBox;
     /** The source's on-canvas width, before the tile scale. */
     private baseW;
+    /** The source's on-canvas height, before the tile scale. */
+    private baseH;
+    /**
+     * Size to paint the snapshot at, for a tile of `tileW × tileH`.
+     *
+     * The snapshot is NOT exactly the source's box: `toCanvasElement` rounds the
+     * raster up to whole pixels and pads it further for a shadow. Painting it into
+     * the tile step would squeeze the artwork inside that padding — every tile
+     * shrinks by up to a pixel and the grid shows transparent seams at zero
+     * spacing. So the bitmap is painted at its own footprint, scaled by the same
+     * factor the tile is, and the step stays the source's box.
+     */
+    private drawSize;
     /** Tile size from the config alone, ignoring any in-flight gesture. */
     private baseTile;
     /** Tile size as drawn right now, including a live scale gesture. */
@@ -356,6 +424,18 @@ interface PatternOrigin {
     x: number;
     y: number;
 }
+/**
+ * Size the tile bitmap is painted at, when that differs from the grid step.
+ *
+ * A snapshot of the source is not always exactly the source's box: the raster is
+ * allocated in whole pixels, and a shadow pads it further. Painting such a bitmap
+ * into the step would shrink the artwork inside its own transparent margin and
+ * open a hairline gap between neighbours at zero spacing.
+ */
+interface TileDrawSize {
+    width: number;
+    height: number;
+}
 /**
  * Pure tile geometry: where each tile centre lands and how much it is rotated,
  * for a config + target/base size. Covers every corner of the target from the
@@ -369,8 +449,12 @@ declare function computeTilePositions(config: PatternConfig, targetW: number, ta
  * Draw the tiled pattern onto a 2D context, in target coordinates (0,0 = the
  * target's top-left corner). The geometry lives in {@link computeTilePositions};
  * this just plays it out as canvas calls.
+ *
+ * `baseW`/`baseH` are the grid STEP. `draw` is the size the bitmap is painted at
+ * and defaults to the step — pass it when the bitmap carries padding the step
+ * does not (see {@link TileDrawSize}), so the artwork still lands step-sized.
  */
-declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin): void;
+declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin, draw?: TileDrawSize): void;
 /** Minimal 2D-context surface used by {@link drawTiles}; lets tests inject a spy. */
 interface CanvasRenderingProtocol {
     save(): void;
@@ -383,13 +467,31 @@ interface CanvasRenderingProtocol {
 /** Straight text — the state every text layer starts in. */
 declare const DEFAULT_TEXT_CURVE: TextCurveConfig;
 interface CurvePath {
-    /** SVG path data the text is laid out along. */
+    /** SVG path data the line is laid out along. */
     data: string;
-    /** Length of that path, used to centre the run on it. */
+    /** Length of that path. */
     length: number;
 }
-/** Path the given curve traces for a text run of `width` px, or null when straight. */
-declare function buildCurvePathData(config: TextCurveConfig, width: number, fontSize: number): CurvePath | null;
+/**
+ * Fills in a partial curve.
+ *
+ * States saved before the shape switch existed carry only `arc` and `wave`, and
+ * held exactly one of them — so the non-zero one names the shape.
+ */
+declare function normalizeTextCurve(config: TextCurveInput): TextCurveConfig;
+/**
+ * One path per line of text, in a single shared coordinate frame.
+ *
+ * Fabric lays every line of a text object along the *same* path, so a
+ * multi-line run collapses into one overlapping pile. Each line gets its own
+ * path here, and `TextCurveManager` measures each line against its own — arcs
+ * concentric around one centre, waves stacked a line-height apart. The block is
+ * centred on the single-line baseline so adding a line doesn't shift the design.
+ */
+declare function buildCurveLinePaths(config: TextCurveInput, width: number, fontSize: number, lineCount?: number, lineHeight?: number): CurvePath[] | null;
+/** Path the given curve traces for a single-line run, or null when straight. */
+declare function buildCurvePathData(config: TextCurveInput, width: number, fontSize: number): CurvePath | null;
+
 /**
  * Bends a text layer's baseline along a generated path.
  *
@@ -407,18 +509,44 @@ declare class TextCurveManager {
     /** Curve parameters for a layer, or null when it is not curved text. */
     get(layerId: string): TextCurveConfig | null;
     isCurved(layerId: string): boolean;
-    /** Apply (or update) the curve on a text layer. Zeroed config clears it. */
-    apply(layerId: string, config: Partial<TextCurveConfig>, save?: boolean): boolean;
+    /** Apply (or update) the curve on a text layer. A straight config clears it. */
+    apply(layerId: string, config: TextCurveInput, save?: boolean): boolean;
     /** Remove the curve, restoring the authored text box width. */
     clear(layerId: string, save?: boolean): boolean;
     /**
-     * Rebuild the path from the stored parameters. Text content, font family and
-     * font size all change the run's width, and the path is sized to that width —
-     * without this the curve keeps the geometry of the text it was created from.
+     * Rebuild the paths from the stored parameters. Text content, line count,
+     * font family and font size all change the geometry the paths are sized to —
+     * without this the curve keeps that of the text it was created from.
      */
     refresh(layerId: string, save?: boolean): boolean;
     /** Rebuild every curved layer — used after a state restore. */
     refreshAll(): void;
+    /**
+     * Puts every line's path on the object as one shape, and hooks per-line
+     * measuring so each line is laid out on its own.
+     *
+     * The object's own path is the union of the lines: fabric sizes a curved text
+     * object from it, and a single line's path would leave the rest of the block
+     * outside the layer's box — where object caching clips it away.
+     */
+    private attach;
+    /**
+     * Fabric lays every line of a text object along `this.path`, from one
+     * `pathStartOffset` — so a multi-line run piles all its lines on top of each
+     * other. Each line is measured against its own path instead, by swapping the
+     * path in around fabric's own per-line measure pass.
+     *
+     * The paths all share the first one's `pathOffset`, which is the origin
+     * fabric subtracts to place a glyph in the object — without that each line
+     * would be re-centred on its own bounding box and land back in the same spot.
+     *
+     * `textAlign` is switched to centre for the pass, which is how fabric centres
+     * a line on its path; the authored value is restored before anything else
+     * reads it.
+     */
+    private patchLineMeasure;
+    /** Restore fabric's own per-line measuring, if this manager replaced it. */
+    private unpatchLineMeasure;
     private detach;
 }
 
@@ -930,15 +1058,21 @@ declare class CanvasEditor {
     addTemplate(template: TemplateDefinition, params: Record<string, string | number>): Promise<Layer>;
     removeLayer(id: string): void;
     selectLayer(id: string | null): void;
+    /** Select several layers at once — what a panel's shift/⌘ click drives. */
+    selectLayers(ids: string[]): void;
     getSelectedLayer(): Layer | null;
     /** Mirror a layer along the given axis. */
     flipLayer(id: string, axis: 'horizontal' | 'vertical'): void;
     /** Clone a layer (offset slightly) and select the copy. */
     duplicateLayer(id: string): Promise<Layer | null>;
     applyImageAdjustments(layerId: string, adjustments: ImageAdjustments): boolean;
-    /** Combine two or more layers into a single editable group layer. */
+    /**
+     * Combine two or more layers into one group layer. Picking a group among them
+     * **absorbs** it — its children join the new group and the old group record is
+     * dropped — because groups are exactly one level deep.
+     */
     groupLayers(ids: string[], name?: string): Promise<Layer | null>;
-    /** Restore a group created by groupLayers back to its original layer records. */
+    /** Split a group back into the layers it holds, in place. */
     ungroupLayer(id: string): Promise<Layer[]>;
     toJSON(): EditorState;
     fromJSON(state: EditorState): Promise<void>;
@@ -1050,6 +1184,37 @@ declare class CanvasEditor {
     private setupCanvasEvents;
 }
 
+/**
+ * A template is a bootstrap, not a frozen picture: it is taken apart into the
+ * layers it is drawn from, so every run of copy stays editable afterwards.
+ */
+interface TemplateLayerSpec {
+    type: 'text' | 'shape';
+    name: string;
+    object: FabricObject;
+    /**
+     * Baseline curve to apply once the layer exists (`<textPath>` templates).
+     * Partial on purpose: a template states only the parameters it cares about
+     * and `TextCurveManager.apply` normalizes the rest.
+     */
+    curve?: Partial<TextCurveConfig>;
+}
+/**
+ * Curve a `<textPath>` template asks for.
+ *
+ * Fabric's SVG parser cannot read `<textPath>` at all, so these templates are
+ * rebuilt from their parameters instead of parsed — the curve is the engine's
+ * own, which keeps the text editable rather than rasterized.
+ */
+declare function textPathCurve(template: TemplateDefinition, values: Record<string, string | number>, runWidth: number): Partial<TextCurveConfig>;
+/** The single text layer a `<textPath>` template stands for. */
+declare function textPathSpec(template: TemplateDefinition, values: Record<string, string | number>): TemplateLayerSpec;
+/**
+ * The layers a resolved template SVG is made of, in draw order: every `<text>`
+ * an editable text layer, every other top-level element a vector layer.
+ */
+declare function explodeTemplateSvg(template: TemplateDefinition, resolvedSvg: string, values: Record<string, string | number>): Promise<TemplateLayerSpec[]>;
+
 declare const DEFAULT_LAYER_SHADOW: LayerShadowConfig;
 /**
  * Read a layer's drop shadow back off its fabric object.
@@ -1175,4 +1340,4 @@ declare class AnnotationOverlay {
  */
 declare function displaceRgba(source: Uint8ClampedArray, map: Uint8ClampedArray, width: number, height: number, options: Omit<MockupDisplacement, 'image'>): Uint8ClampedArray;
 
-export { type AddMaskOptions, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_MASK_TARGET, CANVAS_SIZE_PRESETS, CanvasEditor, type CanvasRenderingProtocol, CanvasSizePreset, type CoverPlacement, CropController, DEFAULT_LAYER_SHADOW, DEFAULT_SELECTION_STYLE, DEFAULT_TEXT_CURVE, DpiIssue, EditorConfig, EditorEvents, EditorState, EventEmitter, FileAdapter, FontDefinition, FontRegistry, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MaskBrushOptions, MaskController, type MaskPerformanceSample, MaskPoint, MaskPresetId, MaskPresetManager, MaskRefinementError, type MaskRefinementErrorCode, MaskRefinementPrompt, MaskRefinementProvider, MaskRefinementResult, MockupConfig, MockupDisplacement, MockupPrintArea, NormalizedLayerPosition, PatternConfig, PatternLocks, PatternManager, type PatternOrigin, type PngExportOptions, PositioningAdapter, PrintifyPositioning, ProjectManager, ProjectState, ResizeOptions, SHAPE_MASK_BOX, SHAPE_MASK_IDS, type SelectionStyle, SemanticExportOptions, SerializedBackgroundImageOptions, SerializedLayer, ShapeMaskPresetId, ShapePlugin, SnapManager, SvgExportOptions, TEXTURE_MASK_IDS, TEXTURE_MASK_SIZE, TemplateDefinition, TextCurveConfig, TextCurveManager, TextureMaskPresetId, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, toCanvasSpace, toHostSpace, unwrapGroup };
+export { type AddMaskOptions, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_MASK_TARGET, CANVAS_SIZE_PRESETS, CanvasEditor, type CanvasRenderingProtocol, CanvasSizePreset, type CoverPlacement, CropController, type CurvePath, DEFAULT_LAYER_SHADOW, DEFAULT_SELECTION_STYLE, DEFAULT_TEXT_CURVE, DpiIssue, EditorConfig, EditorEvents, EditorState, EventEmitter, FileAdapter, FontDefinition, FontRegistry, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MaskBrushOptions, MaskController, type MaskPerformanceSample, MaskPoint, MaskPresetId, MaskPresetManager, MaskRefinementError, type MaskRefinementErrorCode, MaskRefinementPrompt, MaskRefinementProvider, MaskRefinementResult, MockupConfig, MockupDisplacement, MockupPrintArea, NormalizedLayerPosition, PatternConfig, PatternLocks, PatternManager, type PatternOrigin, type PngExportOptions, PositioningAdapter, PrintifyPositioning, ProjectManager, ProjectState, ResizeOptions, SHAPE_MASK_BOX, SHAPE_MASK_IDS, type SelectionStyle, SemanticExportOptions, SerializedBackgroundImageOptions, SerializedLayer, ShapeMaskPresetId, ShapePlugin, SnapManager, SvgExportOptions, TEXTURE_MASK_IDS, TEXTURE_MASK_SIZE, TemplateDefinition, type TemplateLayerSpec, TextCurveConfig, TextCurveInput, TextCurveManager, TextureMaskPresetId, type TileDrawSize, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, buildCurveLinePaths, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, explodeTemplateSvg, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, normalizeTextCurve, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, textPathCurve, textPathSpec, toCanvasSpace, toHostSpace, unwrapGroup };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Canvas, FabricObject, Point, ImageFormat, Group } from 'fabric';
-import { b as EditorEvents, o as LayerType, m as LayerMeta, L as LayerData, X as SerializedLayer, P as PatternConfig, K as PatternLocks, a1 as TextCurveConfig, t as MaskPresetId, Y as ShapeMaskPresetId, a2 as TextureMaskPresetId, a4 as Unit, J as MockupPrintArea, z as MockupConfig, e as FontDefinition, p as LicenseConfig, r as LicenseStatus, T as ProjectState, M as MaskBrushOptions, s as MaskPoint, v as MaskRefinementProvider, u as MaskRefinementPrompt, x as MaskRefinementResult, k as LayerMaskEntry, l as LayerMaskMode, E as EditorConfig, Z as ShapePlugin, $ as TemplateDefinition, I as ImageAdjustments, c as EditorState, V as SemanticExportOptions, _ as SvgExportOptions, R as PrintifyPositioning, N as NormalizedLayerPosition, Q as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, W as SerializedBackgroundImageOptions, B as BackgroundImageOptions, U as ResizeOptions, a as DpiIssue, n as LayerShadowConfig, C as CanvasSizePreset, A as MockupDisplacement } from './types-JP8MZsIs.js';
-export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, q as LicensePayload, w as MaskRefinementRequest, y as MockupBlendMode, G as MockupDisplacementChannel, H as MockupOverlay, O as PatternState, S as ProjectPage, a0 as TemplateParameter, a3 as TileMode } from './types-JP8MZsIs.js';
+import { b as EditorEvents, o as LayerType, m as LayerMeta, L as LayerData, X as SerializedLayer, P as PatternConfig, K as PatternLocks, a1 as TextCurveConfig, a2 as TextCurveInput, t as MaskPresetId, Y as ShapeMaskPresetId, a4 as TextureMaskPresetId, a6 as Unit, J as MockupPrintArea, z as MockupConfig, e as FontDefinition, p as LicenseConfig, r as LicenseStatus, T as ProjectState, M as MaskBrushOptions, s as MaskPoint, v as MaskRefinementProvider, u as MaskRefinementPrompt, x as MaskRefinementResult, k as LayerMaskEntry, l as LayerMaskMode, E as EditorConfig, Z as ShapePlugin, $ as TemplateDefinition, I as ImageAdjustments, c as EditorState, V as SemanticExportOptions, _ as SvgExportOptions, R as PrintifyPositioning, N as NormalizedLayerPosition, Q as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, W as SerializedBackgroundImageOptions, B as BackgroundImageOptions, U as ResizeOptions, a as DpiIssue, n as LayerShadowConfig, C as CanvasSizePreset, A as MockupDisplacement } from './types-LM7pOkkj.js';
+export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, q as LicensePayload, w as MaskRefinementRequest, y as MockupBlendMode, G as MockupDisplacementChannel, H as MockupOverlay, O as PatternState, S as ProjectPage, a0 as TemplateParameter, a3 as TextCurveShape, a5 as TileMode } from './types-LM7pOkkj.js';
 
 type EventHandler<T> = (data: T) => void;
 declare class EventEmitter<TEvents extends {} = Record<string, unknown>> {
@@ -28,6 +28,14 @@ declare class Layer {
      * the layer's real object stays the one every editor API talks to.
      */
     renderProxy: FabricObject | null;
+    /**
+     * Layers nested inside this one, in draw order. Only a `group` layer has any:
+     * their fabric objects live inside this layer's fabric `Group`, not on the
+     * canvas, which is why the manager keeps them off the canvas stack.
+     */
+    children: Layer[];
+    /** Group this layer sits inside, or null when it is on the canvas stack. */
+    parentId: string | null;
     constructor(type: LayerType, fabricObject: FabricObject, name?: string, id?: string);
     private hasMeta;
     toData(): LayerData;
@@ -42,6 +50,26 @@ declare class LayerManager {
     setHistoryCallback(callback: () => void): void;
     add(type: LayerType, fabricObject: FabricObject, name?: string, id?: string): Layer;
     remove(id: string): boolean;
+    /**
+     * Take a top-level layer off the canvas stack **without** disposing it — it is
+     * about to become a group's child, so its object has to stay alive.
+     */
+    detach(id: string): Layer | undefined;
+    /** Put a group's children back on the canvas stack and drop the group. */
+    explode(group: Layer): Layer[];
+    /**
+     * Empty a group onto the canvas stack, in the group's own place, and drop the
+     * group record. `removeAll` restores each child's absolute transform, so the
+     * group's matrix must NOT be re-applied on top of it.
+     */
+    private dissolve;
+    /**
+     * Re-attach child records to an enlivened group. `data[i]` describes
+     * `group._objects[i]` — the order fabric serializes and restores them in. A
+     * missing record still becomes a child, so a hand-edited state cannot drop
+     * artwork off the canvas.
+     */
+    adoptGroupChildren(group: Layer, data: LayerData[]): void;
     /** Replace a layer's render object while preserving its immutable ID and panel state. */
     replaceObject(id: string, fabricObject: FabricObject): boolean;
     /**
@@ -57,10 +85,26 @@ declare class LayerManager {
      * front-to-back instead of computed.
      */
     private syncZOrder;
+    /** The list a layer lives in: its group's children, or the canvas stack. */
+    private siblingsOf;
     reorder(id: string, newIndex: number): boolean;
     select(id: string | null): void;
+    /** Drill into a group so its children can be selected and clicked. */
+    private enterGroup;
+    /** Leave every entered group — selecting anything else is done drilling in. */
+    exitGroups(): void;
+    /**
+     * Select several layers at once, as one fabric `ActiveSelection`. Children are
+     * skipped: a selection spanning in and out of a group has no single transform.
+     */
+    selectMany(ids: string[]): void;
+    /** Depth-first over the whole tree, each layer before its children. */
+    private walk;
     get(id: string): Layer | undefined;
+    /** Top-level layers only — the canvas stack. Children hang off their group. */
     getAll(): Layer[];
+    /** Top-level layers, each carrying its children: what the layer panel renders. */
+    getTree(): LayerData[];
     findByObject(obj: FabricObject): Layer | undefined;
     setVisibility(id: string, visible: boolean): void;
     setLocked(id: string, locked: boolean): void;
@@ -323,8 +367,32 @@ declare class TiledPatternObject extends FabricObject {
      * tiling. The copy shares the source (it only ever reads from it).
      */
     clone(): Promise<this>;
+    /**
+     * The source's tile footprint: its bounding box, minus a stroke it reserves
+     * room for but never paints.
+     *
+     * fabric keeps `strokeWidth` inside an object's box whether or not a `stroke`
+     * colour paints it, and the built-in shapes arrive with `strokeWidth: 1` and no
+     * stroke. Stepping the grid by that box puts a transparent seam between every
+     * pair of neighbours at zero spacing: the artwork is a pixel narrower than the
+     * box it is stepped by.
+     */
+    private sourceBox;
     /** The source's on-canvas width, before the tile scale. */
     private baseW;
+    /** The source's on-canvas height, before the tile scale. */
+    private baseH;
+    /**
+     * Size to paint the snapshot at, for a tile of `tileW × tileH`.
+     *
+     * The snapshot is NOT exactly the source's box: `toCanvasElement` rounds the
+     * raster up to whole pixels and pads it further for a shadow. Painting it into
+     * the tile step would squeeze the artwork inside that padding — every tile
+     * shrinks by up to a pixel and the grid shows transparent seams at zero
+     * spacing. So the bitmap is painted at its own footprint, scaled by the same
+     * factor the tile is, and the step stays the source's box.
+     */
+    private drawSize;
     /** Tile size from the config alone, ignoring any in-flight gesture. */
     private baseTile;
     /** Tile size as drawn right now, including a live scale gesture. */
@@ -356,6 +424,18 @@ interface PatternOrigin {
     x: number;
     y: number;
 }
+/**
+ * Size the tile bitmap is painted at, when that differs from the grid step.
+ *
+ * A snapshot of the source is not always exactly the source's box: the raster is
+ * allocated in whole pixels, and a shadow pads it further. Painting such a bitmap
+ * into the step would shrink the artwork inside its own transparent margin and
+ * open a hairline gap between neighbours at zero spacing.
+ */
+interface TileDrawSize {
+    width: number;
+    height: number;
+}
 /**
  * Pure tile geometry: where each tile centre lands and how much it is rotated,
  * for a config + target/base size. Covers every corner of the target from the
@@ -369,8 +449,12 @@ declare function computeTilePositions(config: PatternConfig, targetW: number, ta
  * Draw the tiled pattern onto a 2D context, in target coordinates (0,0 = the
  * target's top-left corner). The geometry lives in {@link computeTilePositions};
  * this just plays it out as canvas calls.
+ *
+ * `baseW`/`baseH` are the grid STEP. `draw` is the size the bitmap is painted at
+ * and defaults to the step — pass it when the bitmap carries padding the step
+ * does not (see {@link TileDrawSize}), so the artwork still lands step-sized.
  */
-declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin): void;
+declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin, draw?: TileDrawSize): void;
 /** Minimal 2D-context surface used by {@link drawTiles}; lets tests inject a spy. */
 interface CanvasRenderingProtocol {
     save(): void;
@@ -383,13 +467,31 @@ interface CanvasRenderingProtocol {
 /** Straight text — the state every text layer starts in. */
 declare const DEFAULT_TEXT_CURVE: TextCurveConfig;
 interface CurvePath {
-    /** SVG path data the text is laid out along. */
+    /** SVG path data the line is laid out along. */
     data: string;
-    /** Length of that path, used to centre the run on it. */
+    /** Length of that path. */
     length: number;
 }
-/** Path the given curve traces for a text run of `width` px, or null when straight. */
-declare function buildCurvePathData(config: TextCurveConfig, width: number, fontSize: number): CurvePath | null;
+/**
+ * Fills in a partial curve.
+ *
+ * States saved before the shape switch existed carry only `arc` and `wave`, and
+ * held exactly one of them — so the non-zero one names the shape.
+ */
+declare function normalizeTextCurve(config: TextCurveInput): TextCurveConfig;
+/**
+ * One path per line of text, in a single shared coordinate frame.
+ *
+ * Fabric lays every line of a text object along the *same* path, so a
+ * multi-line run collapses into one overlapping pile. Each line gets its own
+ * path here, and `TextCurveManager` measures each line against its own — arcs
+ * concentric around one centre, waves stacked a line-height apart. The block is
+ * centred on the single-line baseline so adding a line doesn't shift the design.
+ */
+declare function buildCurveLinePaths(config: TextCurveInput, width: number, fontSize: number, lineCount?: number, lineHeight?: number): CurvePath[] | null;
+/** Path the given curve traces for a single-line run, or null when straight. */
+declare function buildCurvePathData(config: TextCurveInput, width: number, fontSize: number): CurvePath | null;
+
 /**
  * Bends a text layer's baseline along a generated path.
  *
@@ -407,18 +509,44 @@ declare class TextCurveManager {
     /** Curve parameters for a layer, or null when it is not curved text. */
     get(layerId: string): TextCurveConfig | null;
     isCurved(layerId: string): boolean;
-    /** Apply (or update) the curve on a text layer. Zeroed config clears it. */
-    apply(layerId: string, config: Partial<TextCurveConfig>, save?: boolean): boolean;
+    /** Apply (or update) the curve on a text layer. A straight config clears it. */
+    apply(layerId: string, config: TextCurveInput, save?: boolean): boolean;
     /** Remove the curve, restoring the authored text box width. */
     clear(layerId: string, save?: boolean): boolean;
     /**
-     * Rebuild the path from the stored parameters. Text content, font family and
-     * font size all change the run's width, and the path is sized to that width —
-     * without this the curve keeps the geometry of the text it was created from.
+     * Rebuild the paths from the stored parameters. Text content, line count,
+     * font family and font size all change the geometry the paths are sized to —
+     * without this the curve keeps that of the text it was created from.
      */
     refresh(layerId: string, save?: boolean): boolean;
     /** Rebuild every curved layer — used after a state restore. */
     refreshAll(): void;
+    /**
+     * Puts every line's path on the object as one shape, and hooks per-line
+     * measuring so each line is laid out on its own.
+     *
+     * The object's own path is the union of the lines: fabric sizes a curved text
+     * object from it, and a single line's path would leave the rest of the block
+     * outside the layer's box — where object caching clips it away.
+     */
+    private attach;
+    /**
+     * Fabric lays every line of a text object along `this.path`, from one
+     * `pathStartOffset` — so a multi-line run piles all its lines on top of each
+     * other. Each line is measured against its own path instead, by swapping the
+     * path in around fabric's own per-line measure pass.
+     *
+     * The paths all share the first one's `pathOffset`, which is the origin
+     * fabric subtracts to place a glyph in the object — without that each line
+     * would be re-centred on its own bounding box and land back in the same spot.
+     *
+     * `textAlign` is switched to centre for the pass, which is how fabric centres
+     * a line on its path; the authored value is restored before anything else
+     * reads it.
+     */
+    private patchLineMeasure;
+    /** Restore fabric's own per-line measuring, if this manager replaced it. */
+    private unpatchLineMeasure;
     private detach;
 }
 
@@ -930,15 +1058,21 @@ declare class CanvasEditor {
     addTemplate(template: TemplateDefinition, params: Record<string, string | number>): Promise<Layer>;
     removeLayer(id: string): void;
     selectLayer(id: string | null): void;
+    /** Select several layers at once — what a panel's shift/⌘ click drives. */
+    selectLayers(ids: string[]): void;
     getSelectedLayer(): Layer | null;
     /** Mirror a layer along the given axis. */
     flipLayer(id: string, axis: 'horizontal' | 'vertical'): void;
     /** Clone a layer (offset slightly) and select the copy. */
     duplicateLayer(id: string): Promise<Layer | null>;
     applyImageAdjustments(layerId: string, adjustments: ImageAdjustments): boolean;
-    /** Combine two or more layers into a single editable group layer. */
+    /**
+     * Combine two or more layers into one group layer. Picking a group among them
+     * **absorbs** it — its children join the new group and the old group record is
+     * dropped — because groups are exactly one level deep.
+     */
     groupLayers(ids: string[], name?: string): Promise<Layer | null>;
-    /** Restore a group created by groupLayers back to its original layer records. */
+    /** Split a group back into the layers it holds, in place. */
     ungroupLayer(id: string): Promise<Layer[]>;
     toJSON(): EditorState;
     fromJSON(state: EditorState): Promise<void>;
@@ -1050,6 +1184,37 @@ declare class CanvasEditor {
     private setupCanvasEvents;
 }
 
+/**
+ * A template is a bootstrap, not a frozen picture: it is taken apart into the
+ * layers it is drawn from, so every run of copy stays editable afterwards.
+ */
+interface TemplateLayerSpec {
+    type: 'text' | 'shape';
+    name: string;
+    object: FabricObject;
+    /**
+     * Baseline curve to apply once the layer exists (`<textPath>` templates).
+     * Partial on purpose: a template states only the parameters it cares about
+     * and `TextCurveManager.apply` normalizes the rest.
+     */
+    curve?: Partial<TextCurveConfig>;
+}
+/**
+ * Curve a `<textPath>` template asks for.
+ *
+ * Fabric's SVG parser cannot read `<textPath>` at all, so these templates are
+ * rebuilt from their parameters instead of parsed — the curve is the engine's
+ * own, which keeps the text editable rather than rasterized.
+ */
+declare function textPathCurve(template: TemplateDefinition, values: Record<string, string | number>, runWidth: number): Partial<TextCurveConfig>;
+/** The single text layer a `<textPath>` template stands for. */
+declare function textPathSpec(template: TemplateDefinition, values: Record<string, string | number>): TemplateLayerSpec;
+/**
+ * The layers a resolved template SVG is made of, in draw order: every `<text>`
+ * an editable text layer, every other top-level element a vector layer.
+ */
+declare function explodeTemplateSvg(template: TemplateDefinition, resolvedSvg: string, values: Record<string, string | number>): Promise<TemplateLayerSpec[]>;
+
 declare const DEFAULT_LAYER_SHADOW: LayerShadowConfig;
 /**
  * Read a layer's drop shadow back off its fabric object.
@@ -1175,4 +1340,4 @@ declare class AnnotationOverlay {
  */
 declare function displaceRgba(source: Uint8ClampedArray, map: Uint8ClampedArray, width: number, height: number, options: Omit<MockupDisplacement, 'image'>): Uint8ClampedArray;
 
-export { type AddMaskOptions, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_MASK_TARGET, CANVAS_SIZE_PRESETS, CanvasEditor, type CanvasRenderingProtocol, CanvasSizePreset, type CoverPlacement, CropController, DEFAULT_LAYER_SHADOW, DEFAULT_SELECTION_STYLE, DEFAULT_TEXT_CURVE, DpiIssue, EditorConfig, EditorEvents, EditorState, EventEmitter, FileAdapter, FontDefinition, FontRegistry, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MaskBrushOptions, MaskController, type MaskPerformanceSample, MaskPoint, MaskPresetId, MaskPresetManager, MaskRefinementError, type MaskRefinementErrorCode, MaskRefinementPrompt, MaskRefinementProvider, MaskRefinementResult, MockupConfig, MockupDisplacement, MockupPrintArea, NormalizedLayerPosition, PatternConfig, PatternLocks, PatternManager, type PatternOrigin, type PngExportOptions, PositioningAdapter, PrintifyPositioning, ProjectManager, ProjectState, ResizeOptions, SHAPE_MASK_BOX, SHAPE_MASK_IDS, type SelectionStyle, SemanticExportOptions, SerializedBackgroundImageOptions, SerializedLayer, ShapeMaskPresetId, ShapePlugin, SnapManager, SvgExportOptions, TEXTURE_MASK_IDS, TEXTURE_MASK_SIZE, TemplateDefinition, TextCurveConfig, TextCurveManager, TextureMaskPresetId, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, toCanvasSpace, toHostSpace, unwrapGroup };
+export { type AddMaskOptions, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_MASK_TARGET, CANVAS_SIZE_PRESETS, CanvasEditor, type CanvasRenderingProtocol, CanvasSizePreset, type CoverPlacement, CropController, type CurvePath, DEFAULT_LAYER_SHADOW, DEFAULT_SELECTION_STYLE, DEFAULT_TEXT_CURVE, DpiIssue, EditorConfig, EditorEvents, EditorState, EventEmitter, FileAdapter, FontDefinition, FontRegistry, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MaskBrushOptions, MaskController, type MaskPerformanceSample, MaskPoint, MaskPresetId, MaskPresetManager, MaskRefinementError, type MaskRefinementErrorCode, MaskRefinementPrompt, MaskRefinementProvider, MaskRefinementResult, MockupConfig, MockupDisplacement, MockupPrintArea, NormalizedLayerPosition, PatternConfig, PatternLocks, PatternManager, type PatternOrigin, type PngExportOptions, PositioningAdapter, PrintifyPositioning, ProjectManager, ProjectState, ResizeOptions, SHAPE_MASK_BOX, SHAPE_MASK_IDS, type SelectionStyle, SemanticExportOptions, SerializedBackgroundImageOptions, SerializedLayer, ShapeMaskPresetId, ShapePlugin, SnapManager, SvgExportOptions, TEXTURE_MASK_IDS, TEXTURE_MASK_SIZE, TemplateDefinition, type TemplateLayerSpec, TextCurveConfig, TextCurveInput, TextCurveManager, TextureMaskPresetId, type TileDrawSize, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, buildCurveLinePaths, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, explodeTemplateSvg, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, normalizeTextCurve, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, textPathCurve, textPathSpec, toCanvasSpace, toHostSpace, unwrapGroup };