@overtone-art/canvas-editor-core 0.5.1 → 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;
@@ -423,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.
  *
@@ -447,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;
 }
 
@@ -970,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>;
@@ -1090,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.
@@ -1215,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 TileDrawSize, 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;
@@ -423,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.
  *
@@ -447,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;
 }
 
@@ -970,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>;
@@ -1090,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.
@@ -1215,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 TileDrawSize, 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 };