@overtone-art/canvas-editor-core 0.3.2 → 0.4.0

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { Canvas, FabricObject, ImageFormat } from 'fabric';
-import { b as EditorEvents, m as LayerType, k as LayerMeta, L as LayerData, W as SerializedLayer, J as PatternSourceResolver, P as PatternConfig, H as PatternLocks, a0 as TextCurveConfig, r as MaskPresetId, X as ShapeMaskPresetId, a1 as TextureMaskPresetId, a3 as Unit, G as MockupPrintArea, x as MockupConfig, e as FontDefinition, n as LicenseConfig, p as LicenseStatus, S as ProjectState, M as MaskBrushOptions, q as MaskPoint, t as MaskRefinementProvider, s as MaskRefinementPrompt, v as MaskRefinementResult, E as EditorConfig, Y as ShapePlugin, _ as TemplateDefinition, I as ImageAdjustments, c as EditorState, U as SemanticExportOptions, Z as SvgExportOptions, Q as PrintifyPositioning, N as NormalizedLayerPosition, O as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, V as SerializedBackgroundImageOptions, B as BackgroundImageOptions, T as ResizeOptions, a as DpiIssue, l as LayerShadowConfig, C as CanvasSizePreset, y as MockupDisplacement } from './types-Dh1unrzT.mjs';
-export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, o as LicensePayload, u as MaskRefinementRequest, w as MockupBlendMode, z as MockupDisplacementChannel, A as MockupOverlay, K as PatternState, R as ProjectPage, $ as TemplateParameter, a2 as TileMode } from './types-Dh1unrzT.mjs';
+import { b as EditorEvents, m as LayerType, k as LayerMeta, L as LayerData, V as SerializedLayer, P as PatternConfig, H as PatternLocks, $ as TextCurveConfig, r as MaskPresetId, W as ShapeMaskPresetId, a0 as TextureMaskPresetId, a2 as Unit, G as MockupPrintArea, x as MockupConfig, e as FontDefinition, n as LicenseConfig, p as LicenseStatus, R as ProjectState, M as MaskBrushOptions, q as MaskPoint, t as MaskRefinementProvider, s as MaskRefinementPrompt, v as MaskRefinementResult, E as EditorConfig, X as ShapePlugin, Z as TemplateDefinition, I as ImageAdjustments, c as EditorState, T as SemanticExportOptions, Y as SvgExportOptions, O as PrintifyPositioning, N as NormalizedLayerPosition, K as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, U as SerializedBackgroundImageOptions, B as BackgroundImageOptions, S as ResizeOptions, a as DpiIssue, l as LayerShadowConfig, C as CanvasSizePreset, y as MockupDisplacement } from './types-BNzE_X5M.mjs';
+export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, o as LicensePayload, u as MaskRefinementRequest, w as MockupBlendMode, z as MockupDisplacementChannel, A as MockupOverlay, J as PatternState, Q as ProjectPage, _ as TemplateParameter, a1 as TileMode } from './types-BNzE_X5M.mjs';
 
 type EventHandler<T> = (data: T) => void;
 declare class EventEmitter<TEvents extends {} = Record<string, unknown>> {
@@ -22,6 +22,12 @@ declare class Layer {
     /** Non-fabric data (e.g. pattern config) that must persist with the layer. */
     meta: LayerMeta;
     fabricObject: FabricObject;
+    /**
+     * Stand-in object drawn in place of `fabricObject` (the tiled pattern). It is
+     * part of the canvas but never part of the document: it is not serialized, and
+     * the layer's real object stays the one every editor API talks to.
+     */
+    renderProxy: FabricObject | null;
     constructor(type: LayerType, fabricObject: FabricObject, name?: string, id?: string);
     private hasMeta;
     toData(): LayerData;
@@ -38,6 +44,19 @@ declare class LayerManager {
     remove(id: string): boolean;
     /** Replace a layer's render object while preserving its immutable ID and panel state. */
     replaceObject(id: string, fabricObject: FabricObject): boolean;
+    /**
+     * Attach (or clear) the object drawn in place of a layer's own object. The
+     * proxy tracks the layer's stacking position, visibility and opacity, and is
+     * removed with the layer — it must never outlive or drift from its source.
+     */
+    setRenderProxy(id: string, proxy: FabricObject | null): void;
+    /**
+     * Re-stack every canvas object to match layer order, keeping each proxy
+     * directly above the source it stands in for. Canvas indices can't be derived
+     * from layer indices once proxies are in the array, so the order is rebuilt
+     * front-to-back instead of computed.
+     */
+    private syncZOrder;
     reorder(id: string, newIndex: number): boolean;
     select(id: string | null): void;
     get(id: string): Layer | undefined;
@@ -176,79 +195,141 @@ declare class CropController {
 }
 
 /**
- * Renders a single image layer as a repeating pattern that fills the canvas.
+ * Repeats a layer's own object across the print area.
  *
- * The tiled result is rasterised onto an offscreen canvas and swapped in as the
- * layer's image source, so it survives export, serialization and undo/redo with
- * no extra machinery. The original source + transform are kept in `layer.meta`
- * so the pattern can be turned back off.
+ * The layer keeps its real fabric object as the tile *source*: it stays in the
+ * document, stays selectable and stays editable, and is simply parked at
+ * `opacity: 0` while a {@link TiledPatternObject} render proxy draws the tiling
+ * over the print area. Nothing is baked into the layer, so a source edit (text,
+ * font, colour, drag, scale) shows up on the very next render, and the saved
+ * state stores a `Textbox` rather than a screenshot of one.
  */
 declare class PatternManager {
     private canvas;
     private layers;
     private history;
     private events;
-    private sourceResolver?;
-    private chains;
-    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>, sourceResolver?: PatternSourceResolver | undefined);
+    private proxies;
+    private readonly onSourceModified;
+    private readonly onLayerRemoved;
+    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>);
     isPattern(layerId: string): boolean;
     getConfig(layerId: string): PatternConfig | null;
-    /** Turn a plain image layer into a pattern, or update an existing one. */
+    /** Turn a layer into a repeating pattern, or update an existing one. */
     apply(layerId: string, config: PatternConfig): Promise<void>;
+    /** Drop the tiling and show the source again. */
+    disable(layerId: string): Promise<void>;
     /**
-     * Stretch every restored pattern layer back over the full print area and
-     * re-freeze it, without re-rasterising: the baked bitmap keeps whatever size
-     * it was saved at, so it is scaled (not re-tiled) to the current canvas. Used
-     * after a state restore, where the canvas may be a different display size
-     * than when the pattern was baked — and to repair states saved while a
-     * pattern could still be dragged out of the print area.
+     * Rebuild every proxy after a state restore, migrating any layer that was
+     * saved by the old bake-into-the-layer engine.
      */
-    repinAll(): void;
-    /** Restore the original image and drop the pattern. */
-    disable(layerId: string): Promise<void>;
-    /** Run `task` after any in-flight work for this layer, regardless of outcome. */
-    private enqueue;
-    private renderLayer;
+    rehydrateAll(): Promise<void>;
+    /** Re-fit every proxy to the print area (canvas resize). */
+    syncArea(): void;
+    /** Drop a layer's cached source snapshot (its content changed). */
+    invalidate(layerId: string): void;
+    /** Give a freshly cloned layer its own proxy (duplicating a pattern layer). */
+    attachTo(layer: Layer): void;
+    dispose(): void;
+    /** Release every proxy and the offscreen snapshot it holds. */
+    private clearProxies;
+    private attach;
+    private detach;
+    private invalidateFor;
 }
-/** Interaction flags to restore when a pattern is turned off. */
-declare function captureLocks(obj: FabricObject): PatternLocks;
-/** Pin a pattern object: no move, scale or rotate while the pattern is on. */
-declare function applyPatternLocks(obj: FabricObject): void;
 /**
- * Restore pre-pattern interaction flags. States saved before locking existed
- * carry no snapshot — fall back to a fully interactive object rather than
- * leaving it frozen forever.
+ * Restore pre-pattern interaction flags. Only legacy states carry a snapshot —
+ * the live-source engine never freezes anything — so a missing snapshot means
+ * "fully interactive", not "leave it frozen".
  */
 declare function restoreLocks(obj: FabricObject, locks: PatternLocks | undefined): void;
-declare function loadPatternImage(src: string, resolver?: PatternSourceResolver): Promise<HTMLImageElement>;
-/** Clear the decoded-image cache (e.g. on teardown). Exported for completeness. */
-declare function clearPatternImageCache(): void;
+
 /**
- * Draw the source image repeatedly across a `targetW × targetH` offscreen
- * canvas and return the result as a PNG data URL.
+ * Renders a layer's source object repeated across the print area.
+ *
+ * This is a *render proxy*, not a layer: it is attached to the layer that owns
+ * the source (see `LayerManager.setRenderProxy`) and never serialized. The
+ * document keeps the real object — a `Textbox` stays a `Textbox` — so tiling is
+ * non-destructive and every source edit simply shows up on the next render.
  *
- * Exported for unit testing of the tile geometry.
+ * The source is snapshotted to an offscreen canvas and blitted once per tile.
+ * The snapshot is rebuilt whenever the source changes or the drawing context
+ * gets sharper (a print export), so tiles are rasterised at export resolution
+ * instead of being upscaled from a screen-sized bitmap.
  */
-declare function buildPatternDataURL(src: string, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, sourceResolver?: PatternSourceResolver): Promise<string>;
-/** Placement of one tile, relative to the (already rotated) pattern centre. */
+declare class TiledPatternObject extends FabricObject {
+    static type: string;
+    /** The layer's real object. Never rendered directly (it is kept at opacity 0). */
+    source: FabricObject;
+    config: PatternConfig;
+    private snapshotEl;
+    private snapshotScale;
+    constructor(source: FabricObject, config: PatternConfig, width: number, height: number);
+    /** Swap in a new config; the next render picks it up. */
+    setConfig(config: PatternConfig): void;
+    /** Resize to a new print area. */
+    setArea(width: number, height: number): void;
+    /** Drop the cached source snapshot (e.g. the source was edited). */
+    invalidate(): void;
+    /** Free the offscreen snapshot. */
+    dispose(): void;
+    _render(ctx: CanvasRenderingContext2D): void;
+    /** Raster fallback for SVG export — one `<image>` covering the print area. */
+    _toSVG(): string[];
+    /**
+     * Fabric's generic clone round-trips through `toObject()` + the class
+     * registry, which cannot carry a live source reference. Export paths clone
+     * every canvas object, so without this a print export would silently lose the
+     * tiling. The copy shares the source (it only ever reads from it).
+     */
+    clone(): Promise<this>;
+    /**
+     * The proxy holds a live reference to its source, which would make a
+     * serialized canvas circular. Nothing persists this object (only layers are
+     * serialized) — this keeps an accidental `canvas.toObject()` from throwing.
+     */
+    toObject(): Record<string, unknown>;
+    /** Tile size in canvas units, floored so a tiny tile can't spawn a huge loop. */
+    private tileSize;
+    /** Grid anchor: the source's centre, in this object's coordinates. */
+    private gridOrigin;
+    /**
+     * Snapshot the source at (at least) `scale`, reusing the cached one when it is
+     * still sharp enough and the source has not changed.
+     */
+    private ensureSnapshot;
+    /** Bound the snapshot by both a linear scale and a total pixel budget. */
+    private clampScale;
+}
+
+/** Placement of one tile, relative to the (already rotated) pattern origin. */
 interface TilePlacement {
-    /** Tile-centre offset from the pattern centre, in px. */
+    /** Tile-centre offset from the pattern origin, in px. */
     x: number;
     y: number;
     /** Per-tile rotation, in radians. */
     rotation: number;
 }
+/** Where the tile grid is anchored inside the target, in target px. */
+interface PatternOrigin {
+    x: number;
+    y: number;
+}
 /**
  * Pure tile geometry: where each tile centre lands and how much it is rotated,
- * for a config + target/base size. Covers the rotated bounding diagonal so
- * corners stay filled at any pattern angle. Extracted for unit testing.
+ * for a config + target/base size. Covers every corner of the target from the
+ * grid origin, so no rotation or origin can uncover an edge. Extracted for unit
+ * testing.
+ *
+ * `origin` defaults to the centre of the target.
  */
-declare function computeTilePositions(config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number): TilePlacement[];
+declare function computeTilePositions(config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin): TilePlacement[];
 /**
- * Draw the tiled pattern onto a 2D context. The geometry lives in
- * {@link computeTilePositions}; this just plays it out as canvas calls.
+ * 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.
  */
-declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number): void;
+declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin): void;
 /** Minimal 2D-context surface used by {@link drawTiles}; lets tests inject a spy. */
 interface CanvasRenderingProtocol {
     save(): void;
@@ -820,4 +901,4 @@ declare class AnnotationOverlay {
  */
 declare function displaceRgba(source: Uint8ClampedArray, map: Uint8ClampedArray, width: number, height: number, options: Omit<MockupDisplacement, 'image'>): Uint8ClampedArray;
 
-export { AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_SIZE_PRESETS, CanvasEditor, 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, 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, PatternSourceResolver, 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, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applyPatternLocks, applySelectionStyle, buildCurvePathData, buildPatternDataURL, captureLocks, clamp, clearPatternImageCache, clearTextureMaskCache, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, loadPatternImage, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData };
+export { AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, 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, 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, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Canvas, FabricObject, ImageFormat } from 'fabric';
-import { b as EditorEvents, m as LayerType, k as LayerMeta, L as LayerData, W as SerializedLayer, J as PatternSourceResolver, P as PatternConfig, H as PatternLocks, a0 as TextCurveConfig, r as MaskPresetId, X as ShapeMaskPresetId, a1 as TextureMaskPresetId, a3 as Unit, G as MockupPrintArea, x as MockupConfig, e as FontDefinition, n as LicenseConfig, p as LicenseStatus, S as ProjectState, M as MaskBrushOptions, q as MaskPoint, t as MaskRefinementProvider, s as MaskRefinementPrompt, v as MaskRefinementResult, E as EditorConfig, Y as ShapePlugin, _ as TemplateDefinition, I as ImageAdjustments, c as EditorState, U as SemanticExportOptions, Z as SvgExportOptions, Q as PrintifyPositioning, N as NormalizedLayerPosition, O as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, V as SerializedBackgroundImageOptions, B as BackgroundImageOptions, T as ResizeOptions, a as DpiIssue, l as LayerShadowConfig, C as CanvasSizePreset, y as MockupDisplacement } from './types-Dh1unrzT.js';
-export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, o as LicensePayload, u as MaskRefinementRequest, w as MockupBlendMode, z as MockupDisplacementChannel, A as MockupOverlay, K as PatternState, R as ProjectPage, $ as TemplateParameter, a2 as TileMode } from './types-Dh1unrzT.js';
+import { b as EditorEvents, m as LayerType, k as LayerMeta, L as LayerData, V as SerializedLayer, P as PatternConfig, H as PatternLocks, $ as TextCurveConfig, r as MaskPresetId, W as ShapeMaskPresetId, a0 as TextureMaskPresetId, a2 as Unit, G as MockupPrintArea, x as MockupConfig, e as FontDefinition, n as LicenseConfig, p as LicenseStatus, R as ProjectState, M as MaskBrushOptions, q as MaskPoint, t as MaskRefinementProvider, s as MaskRefinementPrompt, v as MaskRefinementResult, E as EditorConfig, X as ShapePlugin, Z as TemplateDefinition, I as ImageAdjustments, c as EditorState, T as SemanticExportOptions, Y as SvgExportOptions, O as PrintifyPositioning, N as NormalizedLayerPosition, K as PositioningAdapter, h as ImageProviderResult, i as ImageSearchOptions, j as ImageSearchResult, F as FileAdapter, g as ImageProvider, U as SerializedBackgroundImageOptions, B as BackgroundImageOptions, S as ResizeOptions, a as DpiIssue, l as LayerShadowConfig, C as CanvasSizePreset, y as MockupDisplacement } from './types-BNzE_X5M.js';
+export { D as DEFAULT_PATTERN_CONFIG, d as ExportFormat, f as ImageAttribution, o as LicensePayload, u as MaskRefinementRequest, w as MockupBlendMode, z as MockupDisplacementChannel, A as MockupOverlay, J as PatternState, Q as ProjectPage, _ as TemplateParameter, a1 as TileMode } from './types-BNzE_X5M.js';
 
 type EventHandler<T> = (data: T) => void;
 declare class EventEmitter<TEvents extends {} = Record<string, unknown>> {
@@ -22,6 +22,12 @@ declare class Layer {
     /** Non-fabric data (e.g. pattern config) that must persist with the layer. */
     meta: LayerMeta;
     fabricObject: FabricObject;
+    /**
+     * Stand-in object drawn in place of `fabricObject` (the tiled pattern). It is
+     * part of the canvas but never part of the document: it is not serialized, and
+     * the layer's real object stays the one every editor API talks to.
+     */
+    renderProxy: FabricObject | null;
     constructor(type: LayerType, fabricObject: FabricObject, name?: string, id?: string);
     private hasMeta;
     toData(): LayerData;
@@ -38,6 +44,19 @@ declare class LayerManager {
     remove(id: string): boolean;
     /** Replace a layer's render object while preserving its immutable ID and panel state. */
     replaceObject(id: string, fabricObject: FabricObject): boolean;
+    /**
+     * Attach (or clear) the object drawn in place of a layer's own object. The
+     * proxy tracks the layer's stacking position, visibility and opacity, and is
+     * removed with the layer — it must never outlive or drift from its source.
+     */
+    setRenderProxy(id: string, proxy: FabricObject | null): void;
+    /**
+     * Re-stack every canvas object to match layer order, keeping each proxy
+     * directly above the source it stands in for. Canvas indices can't be derived
+     * from layer indices once proxies are in the array, so the order is rebuilt
+     * front-to-back instead of computed.
+     */
+    private syncZOrder;
     reorder(id: string, newIndex: number): boolean;
     select(id: string | null): void;
     get(id: string): Layer | undefined;
@@ -176,79 +195,141 @@ declare class CropController {
 }
 
 /**
- * Renders a single image layer as a repeating pattern that fills the canvas.
+ * Repeats a layer's own object across the print area.
  *
- * The tiled result is rasterised onto an offscreen canvas and swapped in as the
- * layer's image source, so it survives export, serialization and undo/redo with
- * no extra machinery. The original source + transform are kept in `layer.meta`
- * so the pattern can be turned back off.
+ * The layer keeps its real fabric object as the tile *source*: it stays in the
+ * document, stays selectable and stays editable, and is simply parked at
+ * `opacity: 0` while a {@link TiledPatternObject} render proxy draws the tiling
+ * over the print area. Nothing is baked into the layer, so a source edit (text,
+ * font, colour, drag, scale) shows up on the very next render, and the saved
+ * state stores a `Textbox` rather than a screenshot of one.
  */
 declare class PatternManager {
     private canvas;
     private layers;
     private history;
     private events;
-    private sourceResolver?;
-    private chains;
-    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>, sourceResolver?: PatternSourceResolver | undefined);
+    private proxies;
+    private readonly onSourceModified;
+    private readonly onLayerRemoved;
+    constructor(canvas: Canvas, layers: LayerManager, history: HistoryManager, events: EventEmitter<EditorEvents>);
     isPattern(layerId: string): boolean;
     getConfig(layerId: string): PatternConfig | null;
-    /** Turn a plain image layer into a pattern, or update an existing one. */
+    /** Turn a layer into a repeating pattern, or update an existing one. */
     apply(layerId: string, config: PatternConfig): Promise<void>;
+    /** Drop the tiling and show the source again. */
+    disable(layerId: string): Promise<void>;
     /**
-     * Stretch every restored pattern layer back over the full print area and
-     * re-freeze it, without re-rasterising: the baked bitmap keeps whatever size
-     * it was saved at, so it is scaled (not re-tiled) to the current canvas. Used
-     * after a state restore, where the canvas may be a different display size
-     * than when the pattern was baked — and to repair states saved while a
-     * pattern could still be dragged out of the print area.
+     * Rebuild every proxy after a state restore, migrating any layer that was
+     * saved by the old bake-into-the-layer engine.
      */
-    repinAll(): void;
-    /** Restore the original image and drop the pattern. */
-    disable(layerId: string): Promise<void>;
-    /** Run `task` after any in-flight work for this layer, regardless of outcome. */
-    private enqueue;
-    private renderLayer;
+    rehydrateAll(): Promise<void>;
+    /** Re-fit every proxy to the print area (canvas resize). */
+    syncArea(): void;
+    /** Drop a layer's cached source snapshot (its content changed). */
+    invalidate(layerId: string): void;
+    /** Give a freshly cloned layer its own proxy (duplicating a pattern layer). */
+    attachTo(layer: Layer): void;
+    dispose(): void;
+    /** Release every proxy and the offscreen snapshot it holds. */
+    private clearProxies;
+    private attach;
+    private detach;
+    private invalidateFor;
 }
-/** Interaction flags to restore when a pattern is turned off. */
-declare function captureLocks(obj: FabricObject): PatternLocks;
-/** Pin a pattern object: no move, scale or rotate while the pattern is on. */
-declare function applyPatternLocks(obj: FabricObject): void;
 /**
- * Restore pre-pattern interaction flags. States saved before locking existed
- * carry no snapshot — fall back to a fully interactive object rather than
- * leaving it frozen forever.
+ * Restore pre-pattern interaction flags. Only legacy states carry a snapshot —
+ * the live-source engine never freezes anything — so a missing snapshot means
+ * "fully interactive", not "leave it frozen".
  */
 declare function restoreLocks(obj: FabricObject, locks: PatternLocks | undefined): void;
-declare function loadPatternImage(src: string, resolver?: PatternSourceResolver): Promise<HTMLImageElement>;
-/** Clear the decoded-image cache (e.g. on teardown). Exported for completeness. */
-declare function clearPatternImageCache(): void;
+
 /**
- * Draw the source image repeatedly across a `targetW × targetH` offscreen
- * canvas and return the result as a PNG data URL.
+ * Renders a layer's source object repeated across the print area.
+ *
+ * This is a *render proxy*, not a layer: it is attached to the layer that owns
+ * the source (see `LayerManager.setRenderProxy`) and never serialized. The
+ * document keeps the real object — a `Textbox` stays a `Textbox` — so tiling is
+ * non-destructive and every source edit simply shows up on the next render.
  *
- * Exported for unit testing of the tile geometry.
+ * The source is snapshotted to an offscreen canvas and blitted once per tile.
+ * The snapshot is rebuilt whenever the source changes or the drawing context
+ * gets sharper (a print export), so tiles are rasterised at export resolution
+ * instead of being upscaled from a screen-sized bitmap.
  */
-declare function buildPatternDataURL(src: string, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, sourceResolver?: PatternSourceResolver): Promise<string>;
-/** Placement of one tile, relative to the (already rotated) pattern centre. */
+declare class TiledPatternObject extends FabricObject {
+    static type: string;
+    /** The layer's real object. Never rendered directly (it is kept at opacity 0). */
+    source: FabricObject;
+    config: PatternConfig;
+    private snapshotEl;
+    private snapshotScale;
+    constructor(source: FabricObject, config: PatternConfig, width: number, height: number);
+    /** Swap in a new config; the next render picks it up. */
+    setConfig(config: PatternConfig): void;
+    /** Resize to a new print area. */
+    setArea(width: number, height: number): void;
+    /** Drop the cached source snapshot (e.g. the source was edited). */
+    invalidate(): void;
+    /** Free the offscreen snapshot. */
+    dispose(): void;
+    _render(ctx: CanvasRenderingContext2D): void;
+    /** Raster fallback for SVG export — one `<image>` covering the print area. */
+    _toSVG(): string[];
+    /**
+     * Fabric's generic clone round-trips through `toObject()` + the class
+     * registry, which cannot carry a live source reference. Export paths clone
+     * every canvas object, so without this a print export would silently lose the
+     * tiling. The copy shares the source (it only ever reads from it).
+     */
+    clone(): Promise<this>;
+    /**
+     * The proxy holds a live reference to its source, which would make a
+     * serialized canvas circular. Nothing persists this object (only layers are
+     * serialized) — this keeps an accidental `canvas.toObject()` from throwing.
+     */
+    toObject(): Record<string, unknown>;
+    /** Tile size in canvas units, floored so a tiny tile can't spawn a huge loop. */
+    private tileSize;
+    /** Grid anchor: the source's centre, in this object's coordinates. */
+    private gridOrigin;
+    /**
+     * Snapshot the source at (at least) `scale`, reusing the cached one when it is
+     * still sharp enough and the source has not changed.
+     */
+    private ensureSnapshot;
+    /** Bound the snapshot by both a linear scale and a total pixel budget. */
+    private clampScale;
+}
+
+/** Placement of one tile, relative to the (already rotated) pattern origin. */
 interface TilePlacement {
-    /** Tile-centre offset from the pattern centre, in px. */
+    /** Tile-centre offset from the pattern origin, in px. */
     x: number;
     y: number;
     /** Per-tile rotation, in radians. */
     rotation: number;
 }
+/** Where the tile grid is anchored inside the target, in target px. */
+interface PatternOrigin {
+    x: number;
+    y: number;
+}
 /**
  * Pure tile geometry: where each tile centre lands and how much it is rotated,
- * for a config + target/base size. Covers the rotated bounding diagonal so
- * corners stay filled at any pattern angle. Extracted for unit testing.
+ * for a config + target/base size. Covers every corner of the target from the
+ * grid origin, so no rotation or origin can uncover an edge. Extracted for unit
+ * testing.
+ *
+ * `origin` defaults to the centre of the target.
  */
-declare function computeTilePositions(config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number): TilePlacement[];
+declare function computeTilePositions(config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin): TilePlacement[];
 /**
- * Draw the tiled pattern onto a 2D context. The geometry lives in
- * {@link computeTilePositions}; this just plays it out as canvas calls.
+ * 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.
  */
-declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number): void;
+declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin): void;
 /** Minimal 2D-context surface used by {@link drawTiles}; lets tests inject a spy. */
 interface CanvasRenderingProtocol {
     save(): void;
@@ -820,4 +901,4 @@ declare class AnnotationOverlay {
  */
 declare function displaceRgba(source: Uint8ClampedArray, map: Uint8ClampedArray, width: number, height: number, options: Omit<MockupDisplacement, 'image'>): Uint8ClampedArray;
 
-export { AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_SIZE_PRESETS, CanvasEditor, 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, 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, PatternSourceResolver, 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, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applyPatternLocks, applySelectionStyle, buildCurvePathData, buildPatternDataURL, captureLocks, clamp, clearPatternImageCache, clearTextureMaskCache, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, loadPatternImage, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData };
+export { AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, 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, 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, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData };