@overtone-art/canvas-editor-core 0.8.6 → 0.9.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { Canvas, FabricObject, Point, ImageFormat, Group } from 'fabric';
-import { f as EditorEvents, v as LayerType, t as LayerMeta, L as LayerData, a3 as SerializedLayer, V as PatternConfig, W as PatternLocks, a9 as TextCurveConfig, aa as TextCurveInput, ad as TextWrapMode, ac as TextOverflow, A as MaskPresetId, a4 as ShapeMaskPresetId, ae as TextureMaskPresetId, ag as Unit, T as MockupPrintArea, P as MockupConfig, i as FontDefinition, w as LicenseConfig, y as LicenseStatus, $ as ProjectState, M as MaskBrushOptions, z as MaskPoint, J as MaskRefinementProvider, H as MaskRefinementPrompt, N as MaskRefinementResult, r as LayerMaskEntry, j as GradientConfig, s as LayerMaskMode, E as EditorConfig, a5 as ShapePlugin, c as BlendMode, a7 as TemplateDefinition, I as ImageAdjustments, g as EditorState, a1 as SemanticExportOptions, a6 as SvgExportOptions, Z as PrintifyPositioning, U as NormalizedLayerPosition, Y as PositioningAdapter, o as ImageProviderResult, p as ImageSearchOptions, q as ImageSearchResult, F as FileAdapter, n as ImageProvider, a2 as SerializedBackgroundImageOptions, b as BackgroundImageOptions, a0 as ResizeOptions, e as DpiIssue, u as LayerShadowConfig, C as CanvasSizePreset, Q as MockupDisplacement } from './types-F2GH3dcU.mjs';
-export { B as BLEND_GROUPS, a as BLEND_MODES, D as DEFAULT_GRADIENT_CONFIG, d as DEFAULT_PATTERN_CONFIG, h as ExportFormat, G as GradientBox, k as GradientKind, l as GradientStop, m as ImageAttribution, x as LicensePayload, K as MaskRefinementRequest, O as MockupBlendMode, R as MockupDisplacementChannel, S as MockupOverlay, X as PatternState, _ as ProjectPage, a8 as TemplateParameter, ab as TextCurveShape, af as TileMode, ah as angleFromCoords, ai as blendModeLabel, aj as blendModeOf, ak as blendOperation, al as linearCoords, am as readGradientConfig, an as toFabricGradient } from './types-F2GH3dcU.mjs';
+import { Canvas, FabricObject, Point, filters, ImageFormat, Group } from 'fabric';
+import { g as EditorEvents, O as LayerType, M as LayerMeta, L as LayerData, af as SerializedLayer, a5 as PatternConfig, a6 as PatternLocks, ai as ShapePlugin, aj as ShapeState, s as ImageEffectsState, H as LayerEffectState, z as LayerEffectKind, an as TextCurveConfig, ao as TextCurveInput, ar as TextWrapMode, aq as TextOverflow, U as MaskPresetId, ag as ShapeMaskPresetId, as as TextureMaskPresetId, au as Unit, a2 as MockupPrintArea, _ as MockupConfig, k as FontDefinition, P as LicenseConfig, R as LicenseStatus, ab as ProjectState, S as MaskBrushOptions, T as MaskPoint, W as MaskRefinementProvider, V as MaskRefinementPrompt, Y as MaskRefinementResult, J as LayerMaskEntry, l as GradientConfig, K as LayerMaskMode, E as EditorConfig, d as BlendMode, al as TemplateDefinition, h as EditorState, ad as SemanticExportOptions, ak as SvgExportOptions, a9 as PrintifyPositioning, a4 as NormalizedLayerPosition, a8 as PositioningAdapter, w as ImageProviderResult, x as ImageSearchOptions, y as ImageSearchResult, F as FileAdapter, v as ImageProvider, ae as SerializedBackgroundImageOptions, c as BackgroundImageOptions, ac as ResizeOptions, f as DpiIssue, N as LayerShadowConfig, C as CanvasSizePreset, $ as MockupDisplacement } from './specs-B_jOmY6u.mjs';
+export { A as ADJUST_KEYS, a as ADJUST_RANGES, B as BLEND_GROUPS, b as BLEND_MODES, D as DEFAULT_GRADIENT_CONFIG, e as DEFAULT_PATTERN_CONFIG, i as ExportFormat, j as FilterSpec, G as GradientBox, m as GradientKind, n as GradientStop, I as IMAGE_FILTER_PRESETS, o as IMAGE_PROXY_MAX_EDGE, p as ImageAdjust, q as ImageAlphaClip, r as ImageAttribution, t as ImageFilterPreset, u as ImageFilterPresetId, Q as LicensePayload, X as MaskRefinementRequest, Z as MockupBlendMode, a0 as MockupDisplacementChannel, a1 as MockupOverlay, a3 as NEUTRAL_ADJUST, a7 as PatternState, aa as ProjectPage, ah as ShapeParamDef, am as TemplateParameter, ap as TextCurveShape, at as TileMode, av as alphaClipMatrix, aw as angleFromCoords, ax as blendModeLabel, ay as blendModeOf, az as blendOperation, aA as clampAdjust, aB as clampAlphaClip, aC as imageEffectsFilterSpecs, aD as imageFilterPreset, aE as linearCoords, aF as normalizeImageEffects, aG as readGradientConfig, aH as toFabricGradient } from './specs-B_jOmY6u.mjs';
 
 type EventHandler<T> = (data: T) => void;
 declare class EventEmitter<TEvents extends {} = Record<string, unknown>> {
@@ -40,6 +40,14 @@ declare class Layer {
     private hasMeta;
     toData(): LayerData;
     serialize(): SerializedLayer;
+    /**
+     * A member of an ActiveSelection holds selection-relative coordinates and
+     * `toObject()` writes them verbatim. A snapshot taken mid-selection — which
+     * `HistoryManager.undo()` takes — then held positions no restore could use,
+     * and the redo scattered the layers. Realise the selection's transform for
+     * the write and put the object's own transform back.
+     */
+    private serializeObject;
 }
 declare class LayerManager {
     private canvas;
@@ -239,13 +247,47 @@ declare class CropController {
     constructor(canvas: Canvas, history: HistoryManager, events: EventEmitter<EditorEvents>);
     isActive(): boolean;
     activeLayerId(): string | null;
-    start(layer: Layer): void;
+    start(layer: Layer, options?: {
+        aspect?: number | null;
+    }): void;
+    /**
+     * The frame's own geometry, without its stroke.
+     *
+     * The rect draws a 1px dashed outline, and `getBoundingRect` /
+     * `getScaledWidth` both count it — so reading the frame through them made the
+     * aspect box, the zoom centre and the applied crop each about a pixel larger
+     * than the box the user drew. The rect is axis-aligned (rotation is locked),
+     * so its own left/top and scaled dimensions are exact.
+     */
+    private frameBox;
+    /**
+     * Lock the frame to a ratio: it becomes the largest box of that ratio inside
+     * the current frame, centred, and only the corner handles stay — fabric's
+     * default `uniformScaling` then keeps the ratio through a drag. `null` frees it.
+     */
+    setAspect(ratio: number | null): void;
+    /** Zoom the image under a fixed frame, about the frame's centre. */
+    setScale(factor: number): void;
+    /** Back to the frame and image transform the session started with; aspect freed. */
+    reset(): void;
     apply(): void;
     cancel(): void;
     dispose(): void;
     private finish;
 }
 
+type AlignTarget = 'left' | 'center-h' | 'right' | 'top' | 'middle' | 'bottom';
+interface Box {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+declare function unionBox(boxes: Box[]): Box;
+declare function alignObjects(objects: FabricObject[], target: AlignTarget, frame: Box): void;
+/** Equal gaps between neighbours along one axis; the outer two stay put. */
+declare function distributeObjects(objects: FabricObject[], axis: 'h' | 'v'): boolean;
+
 /**
  * Repeats a layer's own object across the print area.
  *
@@ -287,6 +329,8 @@ declare class PatternManager {
     /** Release every proxy and the offscreen snapshot it holds. */
     private clearProxies;
     private attach;
+    /** Fold a programmatic move of the proxy into the config and the source, as a drop does. */
+    commitProxy(layerId: string): void;
     /**
      * Fold a finished drag / scale / rotate on the proxy back into the pattern:
      * position becomes the grid origin (carried by the source), scale becomes the
@@ -482,6 +526,96 @@ interface CanvasRenderingProtocol {
     drawImage(image: CanvasImageSource, dx: number, dy: number, dw: number, dh: number): void;
 }
 
+/** Defaults filled in and every value clamped to its definition. */
+declare function resolveShapeParams(plugin: ShapePlugin, overrides?: Record<string, number>): Record<string, number>;
+/**
+ * Parametric shapes: the geometry lives on a stock fabric object (so the print
+ * path needs nothing), the parameters that produced it live in `meta.shape`,
+ * and this manager is the only writer of both.
+ */
+declare class ShapeManager {
+    private canvas;
+    private layers;
+    private history;
+    private events;
+    private plugins;
+    /**
+     * An arrow scaled 2×1 must not stretch its head: the new box is baked into
+     * the points and the scale returns to 1. Runs before the editor's own
+     * `object:modified` handler (constructed earlier), so history records the
+     * baked state.
+     */
+    private readonly onObjectModified;
+    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>);
+    dispose(): void;
+    /** A restored layer names its plugin by id; only a registered one can regenerate. */
+    register(plugin: ShapePlugin): void;
+    read(layerId: string): ShapeState | null;
+    /**
+     * `commit: false` is a slider drag: geometry and `meta.shape` are written and
+     * `layer:modified` is emitted so the Shape panel re-reads, but nothing reaches
+     * history. The default commits one entry.
+     */
+    setParams(layerId: string, patch: Record<string, number>, commit?: boolean): void;
+}
+
+type Filter = filters.BaseFilter<string>;
+declare class ImageEffectsManager {
+    private canvas;
+    private layers;
+    private history;
+    private events;
+    private proxies;
+    private lastSpecs;
+    private readonly onRemoved;
+    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>);
+    read(layerId: string): ImageEffectsState;
+    /** The filter instances a state derives to, in the D5 order, with no layer involved. */
+    filtersFor(state: ImageEffectsState): Filter[];
+    preview(layerId: string, patch: Partial<ImageEffectsState>): void;
+    commit(layerId: string, patch: Partial<ImageEffectsState>): void;
+    reset(layerId: string): void;
+    /** Re-derive after a source swap or a load. */
+    refresh(layerId: string): void;
+    refreshAll(): void;
+    hasProxy(layerId: string): boolean;
+    /** Run `fn` with every proxied image filtered at source resolution (export), then restore the proxies. */
+    withSourceResolution<T>(fn: () => T): T;
+    dispose(): void;
+    private imageLayer;
+    private write;
+    private apply;
+    private render;
+    private proxyFor;
+    private drop;
+}
+
+type Params = Record<string, number | string>;
+declare const LAYER_EFFECT_DEFAULTS: Record<Exclude<LayerEffectKind, 'none'>, Params>;
+/**
+ * One effect per layer, applied as one history entry. Outline, hollow and drop
+ * are native fabric props; splice, echo and background are the `effect` prop
+ * the effects-package subclasses render — so every kind survives
+ * `toObject()` → `enlivenObjects()` in both runtimes (engine D1, D3, D6).
+ */
+declare class LayerEffectsManager {
+    private canvas;
+    private layers;
+    private history;
+    private events;
+    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>);
+    read(layerId: string): LayerEffectState | null;
+    /**
+     * `commit: false` is a slider drag: props are written and `layer:modified`
+     * is emitted so the panels re-read, but nothing reaches history. The default
+     * commits ONE entry, setMeta's own save folded into the same transaction.
+     */
+    apply(layerId: string, kind: LayerEffectKind, params?: Params, commit?: boolean): void;
+    /** Undo what the previous kind wrote, so kinds never stack. */
+    private clear;
+    private install;
+}
+
 /** Straight text — the state every text layer starts in. */
 declare const DEFAULT_TEXT_CURVE: TextCurveConfig;
 interface CurvePath {
@@ -1183,11 +1317,17 @@ declare class CanvasEditor {
     readonly snapping: SnapManager;
     readonly crop: CropController;
     readonly patterns: PatternManager;
+    /** Parametric shape layers: `meta.shape` and in-place regeneration. */
+    readonly shapes: ShapeManager;
     readonly curves: TextCurveManager;
     readonly wrap: TextWrapManager;
     readonly maskPresets: MaskPresetManager;
+    /** Owner of every image layer's filter array (D5). */
+    readonly imageEffects: ImageEffectsManager;
     /** Stacked boolean masks, per layer and for the design as a whole. */
     readonly layerMasks: LayerMaskManager;
+    /** One effect per text or shape layer (D6). */
+    readonly effects: LayerEffectsManager;
     readonly fonts: FontRegistry;
     readonly licensing: LicenseManager;
     readonly pages: ProjectManager;
@@ -1197,13 +1337,27 @@ declare class CanvasEditor {
     private zoomLevel;
     private selectionStyle;
     private mockup;
+    /** Alt was held when a drag began on this layer; the drop leaves a copy behind. */
+    private altDrag;
     private designBackground;
     private designBackgroundImage;
     private backgroundImageOptions;
     constructor(canvasElement: HTMLCanvasElement, config: EditorConfig);
     addImage(url: string, options?: Partial<Record<string, unknown>>): Promise<Layer>;
     /** Replace an image source without changing its layer identity or visual transform. */
-    replaceImageSource(layerId: string, url: string): Promise<Layer>;
+    replaceImageSource(layerId: string, url: string, options?: {
+        crossOrigin?: 'anonymous';
+    }): Promise<Layer>;
+    /**
+     * The class the registry holds for a stock name.
+     *
+     * `registerEffects` (run in the constructor) overrides the stock names, but
+     * registration only decides what an ENLIVEN produces — a `new Textbox(...)`
+     * here would still be the stock class, which carries no `effect` in its
+     * `customProperties` and so could never serialize one. Authoring and
+     * restoring have to yield the same class.
+     */
+    private registered;
     addText(text: string, options?: Partial<Record<string, unknown>>): Layer;
     addShape(plugin: ShapePlugin, options?: Record<string, unknown>): Layer;
     /**
@@ -1231,9 +1385,17 @@ declare class CanvasEditor {
     getSelectedLayer(): Layer | null;
     /** Mirror a layer along the given axis. */
     flipLayer(id: string, axis: 'horizontal' | 'vertical'): void;
+    /** What the user is acting on: the proxy where a layer has one. */
+    private selectedTargets;
+    private afterMove;
+    /** One layer aligns to the canvas; several align to their common box. One history entry. */
+    alignLayers(target: AlignTarget): boolean;
+    /** Equal gaps along an axis. Needs three selected; returns false otherwise. */
+    distributeLayers(axis: 'h' | 'v'): boolean;
     /** Clone a layer (offset slightly) and select the copy. */
     duplicateLayer(id: string): Promise<Layer | null>;
-    applyImageAdjustments(layerId: string, adjustments: ImageAdjustments): boolean;
+    /** The drag moved the original; a copy takes the start position, just beneath it. */
+    private leaveCopyBehind;
     /**
      * 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
@@ -1535,4 +1697,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, BlendMode, 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, GradientConfig, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MAX_MASK_LAYERS, 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, TextOverflow, TextWrapManager, TextWrapMode, type TextWrapState, TextureMaskPresetId, type TileDrawSize, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, applyTextWrapToObject, buildCurveLinePaths, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, explodeTemplateSvg, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitTextWidth, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, normalizeTextCurve, preWrapWordSplit, readLayerShadow, readTextWrap, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, textPathCurve, textPathSpec, toCanvasSpace, toHostSpace, unwrapGroup };
+export { type AddMaskOptions, type AlignTarget, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, BlendMode, type Box, 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, GradientConfig, HistoryManager, ImageEffectsManager, ImageEffectsState, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, LAYER_EFFECT_DEFAULTS, Layer, LayerData, LayerEffectKind, LayerEffectState, LayerEffectsManager, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MAX_MASK_LAYERS, 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, ShapeManager, ShapeMaskPresetId, ShapePlugin, ShapeState, SnapManager, SvgExportOptions, TEXTURE_MASK_IDS, TEXTURE_MASK_SIZE, TemplateDefinition, type TemplateLayerSpec, TextCurveConfig, TextCurveInput, TextCurveManager, TextOverflow, TextWrapManager, TextWrapMode, type TextWrapState, TextureMaskPresetId, type TileDrawSize, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, alignObjects, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, applyTextWrapToObject, buildCurveLinePaths, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, distributeObjects, drawTiles, escapeXml, explodeTemplateSvg, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitTextWidth, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, normalizeTextCurve, preWrapWordSplit, readLayerShadow, readTextWrap, renderTextureMask, resetTransform, resolveShapeParams, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, textPathCurve, textPathSpec, toCanvasSpace, toHostSpace, unionBox, unwrapGroup };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { Canvas, FabricObject, Point, ImageFormat, Group } from 'fabric';
-import { f as EditorEvents, v as LayerType, t as LayerMeta, L as LayerData, a3 as SerializedLayer, V as PatternConfig, W as PatternLocks, a9 as TextCurveConfig, aa as TextCurveInput, ad as TextWrapMode, ac as TextOverflow, A as MaskPresetId, a4 as ShapeMaskPresetId, ae as TextureMaskPresetId, ag as Unit, T as MockupPrintArea, P as MockupConfig, i as FontDefinition, w as LicenseConfig, y as LicenseStatus, $ as ProjectState, M as MaskBrushOptions, z as MaskPoint, J as MaskRefinementProvider, H as MaskRefinementPrompt, N as MaskRefinementResult, r as LayerMaskEntry, j as GradientConfig, s as LayerMaskMode, E as EditorConfig, a5 as ShapePlugin, c as BlendMode, a7 as TemplateDefinition, I as ImageAdjustments, g as EditorState, a1 as SemanticExportOptions, a6 as SvgExportOptions, Z as PrintifyPositioning, U as NormalizedLayerPosition, Y as PositioningAdapter, o as ImageProviderResult, p as ImageSearchOptions, q as ImageSearchResult, F as FileAdapter, n as ImageProvider, a2 as SerializedBackgroundImageOptions, b as BackgroundImageOptions, a0 as ResizeOptions, e as DpiIssue, u as LayerShadowConfig, C as CanvasSizePreset, Q as MockupDisplacement } from './types-F2GH3dcU.js';
-export { B as BLEND_GROUPS, a as BLEND_MODES, D as DEFAULT_GRADIENT_CONFIG, d as DEFAULT_PATTERN_CONFIG, h as ExportFormat, G as GradientBox, k as GradientKind, l as GradientStop, m as ImageAttribution, x as LicensePayload, K as MaskRefinementRequest, O as MockupBlendMode, R as MockupDisplacementChannel, S as MockupOverlay, X as PatternState, _ as ProjectPage, a8 as TemplateParameter, ab as TextCurveShape, af as TileMode, ah as angleFromCoords, ai as blendModeLabel, aj as blendModeOf, ak as blendOperation, al as linearCoords, am as readGradientConfig, an as toFabricGradient } from './types-F2GH3dcU.js';
+import { Canvas, FabricObject, Point, filters, ImageFormat, Group } from 'fabric';
+import { g as EditorEvents, O as LayerType, M as LayerMeta, L as LayerData, af as SerializedLayer, a5 as PatternConfig, a6 as PatternLocks, ai as ShapePlugin, aj as ShapeState, s as ImageEffectsState, H as LayerEffectState, z as LayerEffectKind, an as TextCurveConfig, ao as TextCurveInput, ar as TextWrapMode, aq as TextOverflow, U as MaskPresetId, ag as ShapeMaskPresetId, as as TextureMaskPresetId, au as Unit, a2 as MockupPrintArea, _ as MockupConfig, k as FontDefinition, P as LicenseConfig, R as LicenseStatus, ab as ProjectState, S as MaskBrushOptions, T as MaskPoint, W as MaskRefinementProvider, V as MaskRefinementPrompt, Y as MaskRefinementResult, J as LayerMaskEntry, l as GradientConfig, K as LayerMaskMode, E as EditorConfig, d as BlendMode, al as TemplateDefinition, h as EditorState, ad as SemanticExportOptions, ak as SvgExportOptions, a9 as PrintifyPositioning, a4 as NormalizedLayerPosition, a8 as PositioningAdapter, w as ImageProviderResult, x as ImageSearchOptions, y as ImageSearchResult, F as FileAdapter, v as ImageProvider, ae as SerializedBackgroundImageOptions, c as BackgroundImageOptions, ac as ResizeOptions, f as DpiIssue, N as LayerShadowConfig, C as CanvasSizePreset, $ as MockupDisplacement } from './specs-B_jOmY6u.js';
+export { A as ADJUST_KEYS, a as ADJUST_RANGES, B as BLEND_GROUPS, b as BLEND_MODES, D as DEFAULT_GRADIENT_CONFIG, e as DEFAULT_PATTERN_CONFIG, i as ExportFormat, j as FilterSpec, G as GradientBox, m as GradientKind, n as GradientStop, I as IMAGE_FILTER_PRESETS, o as IMAGE_PROXY_MAX_EDGE, p as ImageAdjust, q as ImageAlphaClip, r as ImageAttribution, t as ImageFilterPreset, u as ImageFilterPresetId, Q as LicensePayload, X as MaskRefinementRequest, Z as MockupBlendMode, a0 as MockupDisplacementChannel, a1 as MockupOverlay, a3 as NEUTRAL_ADJUST, a7 as PatternState, aa as ProjectPage, ah as ShapeParamDef, am as TemplateParameter, ap as TextCurveShape, at as TileMode, av as alphaClipMatrix, aw as angleFromCoords, ax as blendModeLabel, ay as blendModeOf, az as blendOperation, aA as clampAdjust, aB as clampAlphaClip, aC as imageEffectsFilterSpecs, aD as imageFilterPreset, aE as linearCoords, aF as normalizeImageEffects, aG as readGradientConfig, aH as toFabricGradient } from './specs-B_jOmY6u.js';
 
 type EventHandler<T> = (data: T) => void;
 declare class EventEmitter<TEvents extends {} = Record<string, unknown>> {
@@ -40,6 +40,14 @@ declare class Layer {
     private hasMeta;
     toData(): LayerData;
     serialize(): SerializedLayer;
+    /**
+     * A member of an ActiveSelection holds selection-relative coordinates and
+     * `toObject()` writes them verbatim. A snapshot taken mid-selection — which
+     * `HistoryManager.undo()` takes — then held positions no restore could use,
+     * and the redo scattered the layers. Realise the selection's transform for
+     * the write and put the object's own transform back.
+     */
+    private serializeObject;
 }
 declare class LayerManager {
     private canvas;
@@ -239,13 +247,47 @@ declare class CropController {
     constructor(canvas: Canvas, history: HistoryManager, events: EventEmitter<EditorEvents>);
     isActive(): boolean;
     activeLayerId(): string | null;
-    start(layer: Layer): void;
+    start(layer: Layer, options?: {
+        aspect?: number | null;
+    }): void;
+    /**
+     * The frame's own geometry, without its stroke.
+     *
+     * The rect draws a 1px dashed outline, and `getBoundingRect` /
+     * `getScaledWidth` both count it — so reading the frame through them made the
+     * aspect box, the zoom centre and the applied crop each about a pixel larger
+     * than the box the user drew. The rect is axis-aligned (rotation is locked),
+     * so its own left/top and scaled dimensions are exact.
+     */
+    private frameBox;
+    /**
+     * Lock the frame to a ratio: it becomes the largest box of that ratio inside
+     * the current frame, centred, and only the corner handles stay — fabric's
+     * default `uniformScaling` then keeps the ratio through a drag. `null` frees it.
+     */
+    setAspect(ratio: number | null): void;
+    /** Zoom the image under a fixed frame, about the frame's centre. */
+    setScale(factor: number): void;
+    /** Back to the frame and image transform the session started with; aspect freed. */
+    reset(): void;
     apply(): void;
     cancel(): void;
     dispose(): void;
     private finish;
 }
 
+type AlignTarget = 'left' | 'center-h' | 'right' | 'top' | 'middle' | 'bottom';
+interface Box {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+declare function unionBox(boxes: Box[]): Box;
+declare function alignObjects(objects: FabricObject[], target: AlignTarget, frame: Box): void;
+/** Equal gaps between neighbours along one axis; the outer two stay put. */
+declare function distributeObjects(objects: FabricObject[], axis: 'h' | 'v'): boolean;
+
 /**
  * Repeats a layer's own object across the print area.
  *
@@ -287,6 +329,8 @@ declare class PatternManager {
     /** Release every proxy and the offscreen snapshot it holds. */
     private clearProxies;
     private attach;
+    /** Fold a programmatic move of the proxy into the config and the source, as a drop does. */
+    commitProxy(layerId: string): void;
     /**
      * Fold a finished drag / scale / rotate on the proxy back into the pattern:
      * position becomes the grid origin (carried by the source), scale becomes the
@@ -482,6 +526,96 @@ interface CanvasRenderingProtocol {
     drawImage(image: CanvasImageSource, dx: number, dy: number, dw: number, dh: number): void;
 }
 
+/** Defaults filled in and every value clamped to its definition. */
+declare function resolveShapeParams(plugin: ShapePlugin, overrides?: Record<string, number>): Record<string, number>;
+/**
+ * Parametric shapes: the geometry lives on a stock fabric object (so the print
+ * path needs nothing), the parameters that produced it live in `meta.shape`,
+ * and this manager is the only writer of both.
+ */
+declare class ShapeManager {
+    private canvas;
+    private layers;
+    private history;
+    private events;
+    private plugins;
+    /**
+     * An arrow scaled 2×1 must not stretch its head: the new box is baked into
+     * the points and the scale returns to 1. Runs before the editor's own
+     * `object:modified` handler (constructed earlier), so history records the
+     * baked state.
+     */
+    private readonly onObjectModified;
+    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>);
+    dispose(): void;
+    /** A restored layer names its plugin by id; only a registered one can regenerate. */
+    register(plugin: ShapePlugin): void;
+    read(layerId: string): ShapeState | null;
+    /**
+     * `commit: false` is a slider drag: geometry and `meta.shape` are written and
+     * `layer:modified` is emitted so the Shape panel re-reads, but nothing reaches
+     * history. The default commits one entry.
+     */
+    setParams(layerId: string, patch: Record<string, number>, commit?: boolean): void;
+}
+
+type Filter = filters.BaseFilter<string>;
+declare class ImageEffectsManager {
+    private canvas;
+    private layers;
+    private history;
+    private events;
+    private proxies;
+    private lastSpecs;
+    private readonly onRemoved;
+    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>);
+    read(layerId: string): ImageEffectsState;
+    /** The filter instances a state derives to, in the D5 order, with no layer involved. */
+    filtersFor(state: ImageEffectsState): Filter[];
+    preview(layerId: string, patch: Partial<ImageEffectsState>): void;
+    commit(layerId: string, patch: Partial<ImageEffectsState>): void;
+    reset(layerId: string): void;
+    /** Re-derive after a source swap or a load. */
+    refresh(layerId: string): void;
+    refreshAll(): void;
+    hasProxy(layerId: string): boolean;
+    /** Run `fn` with every proxied image filtered at source resolution (export), then restore the proxies. */
+    withSourceResolution<T>(fn: () => T): T;
+    dispose(): void;
+    private imageLayer;
+    private write;
+    private apply;
+    private render;
+    private proxyFor;
+    private drop;
+}
+
+type Params = Record<string, number | string>;
+declare const LAYER_EFFECT_DEFAULTS: Record<Exclude<LayerEffectKind, 'none'>, Params>;
+/**
+ * One effect per layer, applied as one history entry. Outline, hollow and drop
+ * are native fabric props; splice, echo and background are the `effect` prop
+ * the effects-package subclasses render — so every kind survives
+ * `toObject()` → `enlivenObjects()` in both runtimes (engine D1, D3, D6).
+ */
+declare class LayerEffectsManager {
+    private canvas;
+    private layers;
+    private history;
+    private events;
+    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>);
+    read(layerId: string): LayerEffectState | null;
+    /**
+     * `commit: false` is a slider drag: props are written and `layer:modified`
+     * is emitted so the panels re-read, but nothing reaches history. The default
+     * commits ONE entry, setMeta's own save folded into the same transaction.
+     */
+    apply(layerId: string, kind: LayerEffectKind, params?: Params, commit?: boolean): void;
+    /** Undo what the previous kind wrote, so kinds never stack. */
+    private clear;
+    private install;
+}
+
 /** Straight text — the state every text layer starts in. */
 declare const DEFAULT_TEXT_CURVE: TextCurveConfig;
 interface CurvePath {
@@ -1183,11 +1317,17 @@ declare class CanvasEditor {
     readonly snapping: SnapManager;
     readonly crop: CropController;
     readonly patterns: PatternManager;
+    /** Parametric shape layers: `meta.shape` and in-place regeneration. */
+    readonly shapes: ShapeManager;
     readonly curves: TextCurveManager;
     readonly wrap: TextWrapManager;
     readonly maskPresets: MaskPresetManager;
+    /** Owner of every image layer's filter array (D5). */
+    readonly imageEffects: ImageEffectsManager;
     /** Stacked boolean masks, per layer and for the design as a whole. */
     readonly layerMasks: LayerMaskManager;
+    /** One effect per text or shape layer (D6). */
+    readonly effects: LayerEffectsManager;
     readonly fonts: FontRegistry;
     readonly licensing: LicenseManager;
     readonly pages: ProjectManager;
@@ -1197,13 +1337,27 @@ declare class CanvasEditor {
     private zoomLevel;
     private selectionStyle;
     private mockup;
+    /** Alt was held when a drag began on this layer; the drop leaves a copy behind. */
+    private altDrag;
     private designBackground;
     private designBackgroundImage;
     private backgroundImageOptions;
     constructor(canvasElement: HTMLCanvasElement, config: EditorConfig);
     addImage(url: string, options?: Partial<Record<string, unknown>>): Promise<Layer>;
     /** Replace an image source without changing its layer identity or visual transform. */
-    replaceImageSource(layerId: string, url: string): Promise<Layer>;
+    replaceImageSource(layerId: string, url: string, options?: {
+        crossOrigin?: 'anonymous';
+    }): Promise<Layer>;
+    /**
+     * The class the registry holds for a stock name.
+     *
+     * `registerEffects` (run in the constructor) overrides the stock names, but
+     * registration only decides what an ENLIVEN produces — a `new Textbox(...)`
+     * here would still be the stock class, which carries no `effect` in its
+     * `customProperties` and so could never serialize one. Authoring and
+     * restoring have to yield the same class.
+     */
+    private registered;
     addText(text: string, options?: Partial<Record<string, unknown>>): Layer;
     addShape(plugin: ShapePlugin, options?: Record<string, unknown>): Layer;
     /**
@@ -1231,9 +1385,17 @@ declare class CanvasEditor {
     getSelectedLayer(): Layer | null;
     /** Mirror a layer along the given axis. */
     flipLayer(id: string, axis: 'horizontal' | 'vertical'): void;
+    /** What the user is acting on: the proxy where a layer has one. */
+    private selectedTargets;
+    private afterMove;
+    /** One layer aligns to the canvas; several align to their common box. One history entry. */
+    alignLayers(target: AlignTarget): boolean;
+    /** Equal gaps along an axis. Needs three selected; returns false otherwise. */
+    distributeLayers(axis: 'h' | 'v'): boolean;
     /** Clone a layer (offset slightly) and select the copy. */
     duplicateLayer(id: string): Promise<Layer | null>;
-    applyImageAdjustments(layerId: string, adjustments: ImageAdjustments): boolean;
+    /** The drag moved the original; a copy takes the start position, just beneath it. */
+    private leaveCopyBehind;
     /**
      * 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
@@ -1535,4 +1697,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, BlendMode, 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, GradientConfig, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MAX_MASK_LAYERS, 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, TextOverflow, TextWrapManager, TextWrapMode, type TextWrapState, TextureMaskPresetId, type TileDrawSize, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, applyTextWrapToObject, buildCurveLinePaths, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, explodeTemplateSvg, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitTextWidth, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, normalizeTextCurve, preWrapWordSplit, readLayerShadow, readTextWrap, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, textPathCurve, textPathSpec, toCanvasSpace, toHostSpace, unwrapGroup };
+export { type AddMaskOptions, type AlignTarget, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, BlendMode, type Box, 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, GradientConfig, HistoryManager, ImageEffectsManager, ImageEffectsState, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, LAYER_EFFECT_DEFAULTS, Layer, LayerData, LayerEffectKind, LayerEffectState, LayerEffectsManager, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MAX_MASK_LAYERS, 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, ShapeManager, ShapeMaskPresetId, ShapePlugin, ShapeState, SnapManager, SvgExportOptions, TEXTURE_MASK_IDS, TEXTURE_MASK_SIZE, TemplateDefinition, type TemplateLayerSpec, TextCurveConfig, TextCurveInput, TextCurveManager, TextOverflow, TextWrapManager, TextWrapMode, type TextWrapState, TextureMaskPresetId, type TileDrawSize, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, alignObjects, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, applyTextWrapToObject, buildCurveLinePaths, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, distributeObjects, drawTiles, escapeXml, explodeTemplateSvg, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitTextWidth, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, normalizeTextCurve, preWrapWordSplit, readLayerShadow, readTextWrap, renderTextureMask, resetTransform, resolveShapeParams, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, textPathCurve, textPathSpec, toCanvasSpace, toHostSpace, unionBox, unwrapGroup };