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

package/dist/index.d.mts

@@ -323,8 +323,32 @@ declare class TiledPatternObject extends FabricObject {
      * tiling. The copy shares the source (it only ever reads from it).
      */
     clone(): Promise<this>;
+    /**
+     * The source's tile footprint: its bounding box, minus a stroke it reserves
+     * room for but never paints.
+     *
+     * fabric keeps `strokeWidth` inside an object's box whether or not a `stroke`
+     * colour paints it, and the built-in shapes arrive with `strokeWidth: 1` and no
+     * stroke. Stepping the grid by that box puts a transparent seam between every
+     * pair of neighbours at zero spacing: the artwork is a pixel narrower than the
+     * box it is stepped by.
+     */
+    private sourceBox;
     /** The source's on-canvas width, before the tile scale. */
     private baseW;
+    /** The source's on-canvas height, before the tile scale. */
+    private baseH;
+    /**
+     * Size to paint the snapshot at, for a tile of `tileW × tileH`.
+     *
+     * The snapshot is NOT exactly the source's box: `toCanvasElement` rounds the
+     * raster up to whole pixels and pads it further for a shadow. Painting it into
+     * the tile step would squeeze the artwork inside that padding — every tile
+     * shrinks by up to a pixel and the grid shows transparent seams at zero
+     * spacing. So the bitmap is painted at its own footprint, scaled by the same
+     * factor the tile is, and the step stays the source's box.
+     */
+    private drawSize;
     /** Tile size from the config alone, ignoring any in-flight gesture. */
     private baseTile;
     /** Tile size as drawn right now, including a live scale gesture. */
@@ -356,6 +380,18 @@ interface PatternOrigin {
     x: number;
     y: number;
 }
+/**
+ * Size the tile bitmap is painted at, when that differs from the grid step.
+ *
+ * A snapshot of the source is not always exactly the source's box: the raster is
+ * allocated in whole pixels, and a shadow pads it further. Painting such a bitmap
+ * into the step would shrink the artwork inside its own transparent margin and
+ * open a hairline gap between neighbours at zero spacing.
+ */
+interface TileDrawSize {
+    width: number;
+    height: number;
+}
 /**
  * Pure tile geometry: where each tile centre lands and how much it is rotated,
  * for a config + target/base size. Covers every corner of the target from the
@@ -369,8 +405,12 @@ declare function computeTilePositions(config: PatternConfig, targetW: number, ta
  * Draw the tiled pattern onto a 2D context, in target coordinates (0,0 = the
  * target's top-left corner). The geometry lives in {@link computeTilePositions};
  * this just plays it out as canvas calls.
+ *
+ * `baseW`/`baseH` are the grid STEP. `draw` is the size the bitmap is painted at
+ * and defaults to the step — pass it when the bitmap carries padding the step
+ * does not (see {@link TileDrawSize}), so the artwork still lands step-sized.
  */
-declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin): void;
+declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin, draw?: TileDrawSize): void;
 /** Minimal 2D-context surface used by {@link drawTiles}; lets tests inject a spy. */
 interface CanvasRenderingProtocol {
     save(): void;
@@ -1175,4 +1215,4 @@ declare class AnnotationOverlay {
  */
 declare function displaceRgba(source: Uint8ClampedArray, map: Uint8ClampedArray, width: number, height: number, options: Omit<MockupDisplacement, 'image'>): Uint8ClampedArray;
 
-export { type AddMaskOptions, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_MASK_TARGET, CANVAS_SIZE_PRESETS, CanvasEditor, type CanvasRenderingProtocol, CanvasSizePreset, type CoverPlacement, CropController, DEFAULT_LAYER_SHADOW, DEFAULT_SELECTION_STYLE, DEFAULT_TEXT_CURVE, DpiIssue, EditorConfig, EditorEvents, EditorState, EventEmitter, FileAdapter, FontDefinition, FontRegistry, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MaskBrushOptions, MaskController, type MaskPerformanceSample, MaskPoint, MaskPresetId, MaskPresetManager, MaskRefinementError, type MaskRefinementErrorCode, MaskRefinementPrompt, MaskRefinementProvider, MaskRefinementResult, MockupConfig, MockupDisplacement, MockupPrintArea, NormalizedLayerPosition, PatternConfig, PatternLocks, PatternManager, type PatternOrigin, type PngExportOptions, PositioningAdapter, PrintifyPositioning, ProjectManager, ProjectState, ResizeOptions, SHAPE_MASK_BOX, SHAPE_MASK_IDS, type SelectionStyle, SemanticExportOptions, SerializedBackgroundImageOptions, SerializedLayer, ShapeMaskPresetId, ShapePlugin, SnapManager, SvgExportOptions, TEXTURE_MASK_IDS, TEXTURE_MASK_SIZE, TemplateDefinition, TextCurveConfig, TextCurveManager, TextureMaskPresetId, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, toCanvasSpace, toHostSpace, unwrapGroup };
+export { type AddMaskOptions, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_MASK_TARGET, CANVAS_SIZE_PRESETS, CanvasEditor, type CanvasRenderingProtocol, CanvasSizePreset, type CoverPlacement, CropController, 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 };

package/dist/index.d.ts

@@ -323,8 +323,32 @@ declare class TiledPatternObject extends FabricObject {
      * tiling. The copy shares the source (it only ever reads from it).
      */
     clone(): Promise<this>;
+    /**
+     * The source's tile footprint: its bounding box, minus a stroke it reserves
+     * room for but never paints.
+     *
+     * fabric keeps `strokeWidth` inside an object's box whether or not a `stroke`
+     * colour paints it, and the built-in shapes arrive with `strokeWidth: 1` and no
+     * stroke. Stepping the grid by that box puts a transparent seam between every
+     * pair of neighbours at zero spacing: the artwork is a pixel narrower than the
+     * box it is stepped by.
+     */
+    private sourceBox;
     /** The source's on-canvas width, before the tile scale. */
     private baseW;
+    /** The source's on-canvas height, before the tile scale. */
+    private baseH;
+    /**
+     * Size to paint the snapshot at, for a tile of `tileW × tileH`.
+     *
+     * The snapshot is NOT exactly the source's box: `toCanvasElement` rounds the
+     * raster up to whole pixels and pads it further for a shadow. Painting it into
+     * the tile step would squeeze the artwork inside that padding — every tile
+     * shrinks by up to a pixel and the grid shows transparent seams at zero
+     * spacing. So the bitmap is painted at its own footprint, scaled by the same
+     * factor the tile is, and the step stays the source's box.
+     */
+    private drawSize;
     /** Tile size from the config alone, ignoring any in-flight gesture. */
     private baseTile;
     /** Tile size as drawn right now, including a live scale gesture. */
@@ -356,6 +380,18 @@ interface PatternOrigin {
     x: number;
     y: number;
 }
+/**
+ * Size the tile bitmap is painted at, when that differs from the grid step.
+ *
+ * A snapshot of the source is not always exactly the source's box: the raster is
+ * allocated in whole pixels, and a shadow pads it further. Painting such a bitmap
+ * into the step would shrink the artwork inside its own transparent margin and
+ * open a hairline gap between neighbours at zero spacing.
+ */
+interface TileDrawSize {
+    width: number;
+    height: number;
+}
 /**
  * Pure tile geometry: where each tile centre lands and how much it is rotated,
  * for a config + target/base size. Covers every corner of the target from the
@@ -369,8 +405,12 @@ declare function computeTilePositions(config: PatternConfig, targetW: number, ta
  * Draw the tiled pattern onto a 2D context, in target coordinates (0,0 = the
  * target's top-left corner). The geometry lives in {@link computeTilePositions};
  * this just plays it out as canvas calls.
+ *
+ * `baseW`/`baseH` are the grid STEP. `draw` is the size the bitmap is painted at
+ * and defaults to the step — pass it when the bitmap carries padding the step
+ * does not (see {@link TileDrawSize}), so the artwork still lands step-sized.
  */
-declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin): void;
+declare function drawTiles(ctx: CanvasRenderingProtocol, img: CanvasImageSource, config: PatternConfig, targetW: number, targetH: number, baseW: number, baseH: number, origin?: PatternOrigin, draw?: TileDrawSize): void;
 /** Minimal 2D-context surface used by {@link drawTiles}; lets tests inject a spy. */
 interface CanvasRenderingProtocol {
     save(): void;
@@ -1175,4 +1215,4 @@ declare class AnnotationOverlay {
  */
 declare function displaceRgba(source: Uint8ClampedArray, map: Uint8ClampedArray, width: number, height: number, options: Omit<MockupDisplacement, 'image'>): Uint8ClampedArray;
 
-export { type AddMaskOptions, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_MASK_TARGET, CANVAS_SIZE_PRESETS, CanvasEditor, type CanvasRenderingProtocol, CanvasSizePreset, type CoverPlacement, CropController, DEFAULT_LAYER_SHADOW, DEFAULT_SELECTION_STYLE, DEFAULT_TEXT_CURVE, DpiIssue, EditorConfig, EditorEvents, EditorState, EventEmitter, FileAdapter, FontDefinition, FontRegistry, HistoryManager, ImageAdjustments, ImageProvider, ImageProviderResult, ImageSearchOptions, ImageSearchResult, Layer, LayerData, LayerManager, LayerMaskEntry, LayerMaskManager, LayerMaskMode, LayerMeta, LayerShadowConfig, LayerType, LicenseConfig, LicenseManager, LicenseStatus, MaskBrushOptions, MaskController, type MaskPerformanceSample, MaskPoint, MaskPresetId, MaskPresetManager, MaskRefinementError, type MaskRefinementErrorCode, MaskRefinementPrompt, MaskRefinementProvider, MaskRefinementResult, MockupConfig, MockupDisplacement, MockupPrintArea, NormalizedLayerPosition, PatternConfig, PatternLocks, PatternManager, type PatternOrigin, type PngExportOptions, PositioningAdapter, PrintifyPositioning, ProjectManager, ProjectState, ResizeOptions, SHAPE_MASK_BOX, SHAPE_MASK_IDS, type SelectionStyle, SemanticExportOptions, SerializedBackgroundImageOptions, SerializedLayer, ShapeMaskPresetId, ShapePlugin, SnapManager, SvgExportOptions, TEXTURE_MASK_IDS, TEXTURE_MASK_SIZE, TemplateDefinition, TextCurveConfig, TextCurveManager, TextureMaskPresetId, type TilePlacement, TiledPatternObject, Unit, UnitConverter, type ViewportTransform, applyAspectLock, applyLayerShadow, applyObjectSelectionStyle, applySelectionStyle, buildCurvePathData, clamp, clearTextureMaskCache, composeMaskGroup, computeCoverPlacement, computePrintAreaClip, computeTilePositions, deserializeEditor, displaceRgba, drawTiles, escapeXml, exportDataURL, exportMockup, exportPNG, exportPrintArea, exportSVG, fitToBox, generateId, isCssColor, isMaskPresetId, isShapeMaskId, isTextureMaskId, needsAbsoluteSpace, readLayerShadow, renderTextureMask, resetTransform, restoreLocks, round2, sanitizeSvg, serializeEditor, shapeMaskPathData, toCanvasSpace, toHostSpace, unwrapGroup };
+export { type AddMaskOptions, AnnotationOverlay, type AnnotationPrimitive, BackgroundImageOptions, CANVAS_MASK_TARGET, CANVAS_SIZE_PRESETS, CanvasEditor, type CanvasRenderingProtocol, CanvasSizePreset, type CoverPlacement, CropController, 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 };