@bwp-web/canvas 0.5.0 → 0.6.0

package/dist/interactions/dragToCreate.d.ts

@@ -1,5 +1,5 @@
 import { Canvas as FabricCanvas, FabricObject } from 'fabric';
-import type { DragBounds, ShapeStyleOptions, SnappableInteractionOptions } from '../types';
+import type { DragBounds, Point2D, ShapeStyleOptions, SnappableInteractionOptions } from '../types';
 export interface DragToCreateOptions extends SnappableInteractionOptions {
     /** Style applied to the preview rectangle shown during drag. */
     previewStyle?: ShapeStyleOptions & {
@@ -8,6 +8,11 @@ export interface DragToCreateOptions extends SnappableInteractionOptions {
     };
     /** When true, constrain the drag to a 1:1 aspect ratio (square). */
     constrainToSquare?: boolean;
+    /**
+     * Factory called when the user clicks without dragging (below MIN_DRAG_SIZE).
+     * Receives the canvas and the click point. If not provided, clicks are ignored.
+     */
+    clickFactory?: (canvas: FabricCanvas, point: Point2D) => FabricObject;
     /** Called when the user cancels the drag via Escape. */
     onCancel?: () => void;
 }

package/dist/interactions/dragToCreate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dragToCreate.d.ts","sourceRoot":"","sources":["../../src/interactions/dragToCreate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,YAAY,EAAQ,MAAM,QAAQ,CAAC;AACpE,OAAO,KAAK,EACV,UAAU,EAEV,iBAAiB,EACjB,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAMlB,MAAM,WAAW,mBAAoB,SAAQ,2BAA2B;IACtE,gEAAgE;IAChE,YAAY,CAAC,EAAE,iBAAiB,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,KAAK,YAAY,EACnE,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,IAAI,CAuJZ"}
+{"version":3,"file":"dragToCreate.d.ts","sourceRoot":"","sources":["../../src/interactions/dragToCreate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,YAAY,EAAQ,MAAM,QAAQ,CAAC;AACpE,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,iBAAiB,EACjB,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAMlB,MAAM,WAAW,mBAAoB,SAAQ,2BAA2B;IACtE,gEAAgE;IAChE,YAAY,CAAC,EAAE,iBAAiB,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,KAAK,YAAY,CAAC;IACtE,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,KAAK,YAAY,EACnE,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,IAAI,CA6JZ"}

package/dist/interactions/drawToCreate.d.ts

@@ -1,15 +1,20 @@
 import { Canvas as FabricCanvas, FabricObject } from 'fabric';
-import type { SnappableInteractionOptions } from '../types';
-import { type PolygonStyleOptions } from '../shapes';
+import type { Point2D, ShapeStyleOptions, SnappableInteractionOptions } from '../types';
 export interface DrawToCreateOptions extends SnappableInteractionOptions {
     /** Style applied to the polygon being drawn. */
-    style?: PolygonStyleOptions;
+    style?: ShapeStyleOptions;
     /**
      * Metadata to attach to the created polygon. If provided, this is set on
      * the polygon's `data` property after creation. Takes precedence over
      * `style.data` if both are specified.
      */
     data?: FabricObject['data'];
+    /**
+     * Factory function to create the final object from placed vertices.
+     * Receives the canvas and the array of placed points.
+     * Default: creates a polygon via `createPolygonFromVertices`.
+     */
+    factory?: (canvas: FabricCanvas, points: Point2D[]) => FabricObject;
     /**
      * Snap vertex positions to multiples of `interval` degrees when Shift is
      * held while placing a vertex. The angle is measured relative to the

package/dist/interactions/drawToCreate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drawToCreate.d.ts","sourceRoot":"","sources":["../../src/interactions/drawToCreate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,YAAY,EAEtB,YAAY,EAGb,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAW,2BAA2B,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAahF,MAAM,WAAW,mBAAoB,SAAQ,2BAA2B;IACtE,gDAAgD;IAChD,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AA8ED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,IAAI,CA6OZ"}
+{"version":3,"file":"drawToCreate.d.ts","sourceRoot":"","sources":["../../src/interactions/drawToCreate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,YAAY,EAEtB,YAAY,EAGb,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,2BAA2B,EAC5B,MAAM,UAAU,CAAC;AAclB,MAAM,WAAW,mBAAoB,SAAQ,2BAA2B;IACtE,gDAAgD;IAChD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,YAAY,CAAC;IACpE;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AA8ED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,IAAI,CA+OZ"}

package/dist/interactions/vertexEdit.d.ts

@@ -4,6 +4,8 @@ export interface VertexEditOptions {
     handleFill?: string;
     handleStroke?: string;
     handleStrokeWidth?: number;
+    /** Called when vertex editing is exited (via Escape, empty-canvas click, or cleanup). */
+    onExit?: () => void;
 }
 /**
  * Enable vertex editing on a polygon.
@@ -14,5 +16,7 @@ export interface VertexEditOptions {
  *
  * Returns a cleanup function that removes handles and exits edit mode.
  */
-export declare function enableVertexEdit(canvas: FabricCanvas, polygon: Polygon, options?: VertexEditOptions, onExit?: () => void): () => void;
+export declare function enableVertexEdit(canvas: FabricCanvas, polygon: Polygon, options?: VertexEditOptions, 
+/** @deprecated Pass `onExit` in options instead. */
+onExit?: () => void): () => void;
 //# sourceMappingURL=vertexEdit.d.ts.map

package/dist/interactions/vertexEdit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vertexEdit.d.ts","sourceRoot":"","sources":["../../src/interactions/vertexEdit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,YAAY,EAGtB,OAAO,EAER,MAAM,QAAQ,CAAC;AAUhB,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AA2ED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,MAAM,CAAC,EAAE,MAAM,IAAI,GAClB,MAAM,IAAI,CA8LZ"}
+{"version":3,"file":"vertexEdit.d.ts","sourceRoot":"","sources":["../../src/interactions/vertexEdit.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,YAAY,EAGtB,OAAO,EAER,MAAM,QAAQ,CAAC;AAUhB,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AA2ED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,iBAAiB;AAC3B,oDAAoD;AACpD,MAAM,CAAC,EAAE,MAAM,IAAI,GAClB,MAAM,IAAI,CA8LZ"}

package/dist/serialization.d.ts

@@ -1,4 +1,5 @@
 import { Canvas as FabricCanvas, type FabricObject } from 'fabric';
+import type { CanvasJSON } from './types';
 /**
  * Enable zoom-independent stroke widths on a canvas.
  *
@@ -11,6 +12,23 @@ import { Canvas as FabricCanvas, type FabricObject } from 'fabric';
  * stroke widths to their base values.
  */
 export declare function enableScaledStrokes(canvas: FabricCanvas): () => void;
+/**
+ * Keep border radii visually constant on Rects loaded via {@link loadCanvas}.
+ *
+ * On every render, each tracked Rect's `rx`/`ry` is recalculated as
+ * `VIEW_BORDER_RADIUS / scale` so corners always appear circular regardless
+ * of non-uniform scaling. The original rx/ry values are stored in an internal
+ * WeakMap and automatically restored before serialization by
+ * {@link serializeCanvas}.
+ *
+ * Returns a cleanup function that removes the listener and restores all
+ * rx/ry values to their originals.
+ */
+export interface ScaledBorderRadiusOptions {
+    /** Visual border radius in pixels. Default: 4. */
+    radius?: number;
+}
+export declare function enableScaledBorderRadius(canvas: FabricCanvas, options?: ScaledBorderRadiusOptions): () => void;
 /**
  * Options for {@link serializeCanvas}.
  */
@@ -41,7 +59,7 @@ export declare function getBaseStrokeWidth(obj: FabricObject): number;
  *   zoom-scaled values. This ensures the saved JSON always contains the
  *   intended visual stroke width, not the zoom-adjusted one.
  */
-export declare function serializeCanvas(canvas: FabricCanvas, options?: SerializeOptions): object;
+export declare function serializeCanvas(canvas: FabricCanvas, options?: SerializeOptions): CanvasJSON;
 /**
  * Options for {@link loadCanvas}.
  */
@@ -52,6 +70,11 @@ export interface LoadCanvasOptions {
      * no longer exist in the application's data model.
      */
     filter?: (obj: FabricObject) => boolean;
+    /**
+     * Visual border radius applied to loaded Rects (excluding circles and DEVICE objects).
+     * Pass a number to customize, or `false` to skip entirely. Default: `4`.
+     */
+    borderRadius?: number | false;
 }
 /**
  * Load a canvas from a previously serialized JSON object (from {@link serializeCanvas}).
@@ -59,5 +82,5 @@ export interface LoadCanvasOptions {
  * Clears the canvas and restores all objects, then requests a re-render.
  * The returned promise resolves once the canvas is fully loaded.
  */
-export declare function loadCanvas(canvas: FabricCanvas, json: object, options?: LoadCanvasOptions): Promise<FabricObject[]>;
+export declare function loadCanvas(canvas: FabricCanvas, json: CanvasJSON | object, options?: LoadCanvasOptions): Promise<FabricObject[]>;
 //# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAQ,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAWzE;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,CA2BpE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CAqCR;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC;CACzC;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CAwCzB"}
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,YAAY,EAGtB,KAAK,YAAY,EAClB,MAAM,QAAQ,CAAC;AAGhB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAkB1C;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,CA2BpE;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,yBAAyB;IACxC,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,yBAAyB,GAClC,MAAM,IAAI,CAyBZ;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,gBAAgB,GACzB,UAAU,CAqDZ;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC;IACxC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,UAAU,GAAG,MAAM,EACzB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CAwFzB"}

package/dist/shapes/polygon.d.ts

@@ -24,12 +24,12 @@ export declare function createPolygonAtPoint(canvas: FabricCanvas, point: Point2
  * Create a rectangular polygon from drag bounds (two corner points) and add it to the canvas.
  * Returns the fabric Polygon instance.
  */
-export declare function createPolygonFromDrag(canvas: FabricCanvas, start: Point2D, end: Point2D, style?: PolygonStyleOptions): Polygon;
+export declare function createPolygonFromDrag(canvas: FabricCanvas, start: Point2D, end: Point2D, options?: ShapeStyleOptions): Polygon;
 /**
  * Create a polygon from an arbitrary array of vertices and add it to the canvas.
  * Returns the fabric Polygon instance.
  */
-export declare function createPolygonFromVertices(canvas: FabricCanvas, points: Point2D[], style?: PolygonStyleOptions): Polygon;
+export declare function createPolygonFromVertices(canvas: FabricCanvas, points: Point2D[], options?: ShapeStyleOptions): Polygon;
 /**
  * Edit an existing polygon's properties (position, points, appearance, etc.).
  */

package/dist/shapes/polygon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../../src/shapes/polygon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG3D,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,0GAA0G;AAC1G,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,cAAc,GACtB,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAcT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,OAAO,EACZ,KAAK,CAAC,EAAE,mBAAmB,GAC1B,OAAO,CAiBT;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,OAAO,EAAE,EACjB,KAAK,CAAC,EAAE,mBAAmB,GAC1B,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,IAAI,CASN"}
+{"version":3,"file":"polygon.d.ts","sourceRoot":"","sources":["../../src/shapes/polygon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,YAAY,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG3D,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,0GAA0G;AAC1G,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,cAAc,GACtB,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAcT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAiBT;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,IAAI,CASN"}

package/dist/styles.d.ts

@@ -1,9 +1,11 @@
+/** Selection handle appearance (border, corner color). Applied to all objects. */
 export declare const DEFAULT_CONTROL_STYLE: {
     borderColor: string;
     cornerColor: string;
     cornerStrokeColor: string;
     transparentCorners: boolean;
 };
+/** Default fill/stroke for rectangles and polygons. */
 export declare const DEFAULT_SHAPE_STYLE: {
     borderColor: string;
     cornerColor: string;
@@ -14,6 +16,7 @@ export declare const DEFAULT_SHAPE_STYLE: {
     strokeWidth: number;
     strokeUniform: boolean;
 };
+/** Default fill for circles (Rects with full border-radius). */
 export declare const DEFAULT_CIRCLE_STYLE: {
     borderColor: string;
     cornerColor: string;
@@ -24,6 +27,7 @@ export declare const DEFAULT_CIRCLE_STYLE: {
     strokeWidth: number;
     strokeUniform: boolean;
 };
+/** Preview rectangle shown during drag-to-create (dashed stroke). */
 export declare const DEFAULT_DRAG_SHAPE_STYLE: {
     fill: string;
     stroke: string;
@@ -31,6 +35,7 @@ export declare const DEFAULT_DRAG_SHAPE_STYLE: {
     strokeUniform: boolean;
     strokeDashArray: number[];
 };
+/** Preview polygon shown during draw-to-create (semi-transparent dashed stroke). */
 export declare const DEFAULT_GUIDELINE_SHAPE_STYLE: {
     fill: string;
     stroke: string;
@@ -38,6 +43,7 @@ export declare const DEFAULT_GUIDELINE_SHAPE_STYLE: {
     strokeUniform: boolean;
     strokeDashArray: number[];
 };
+/** Alignment guideline appearance (color, width, x-marker size). */
 export declare const DEFAULT_ALIGNMENT_STYLE: {
     readonly color: "rgba(255, 0, 0, 0.9)";
     readonly width: 1;

package/dist/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB;;;;;CAKjC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;CAM/B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;CAMhC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;CAMpC,CAAC;AAEF,eAAO,MAAM,6BAA6B;;;;;;CAMzC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;CAI1B,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAKA,kFAAkF;AAClF,eAAO,MAAM,qBAAqB;;;;;CAKjC,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,mBAAmB;;;;;;;;;CAM/B,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,oBAAoB;;;;;;;;;CAMhC,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,wBAAwB;;;;;;CAMpC,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,6BAA6B;;;;;;CAMzC,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,uBAAuB;;;;CAI1B,CAAC"}

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 import type { Canvas as FabricCanvas, FabricObject } from 'fabric';
 import type { ViewportController } from './viewport';
 import type { GuidelineStyle } from './alignment/cursorSnapping';
+import type { ObjectDataType } from './fabricAugmentation';
 /** A simple 2D point. */
 export type Point2D = {
     x: number;
@@ -13,10 +14,16 @@ export interface ShapeStyleOptions {
     strokeWidth?: number;
     /** Optional metadata to attach to the created object. */
     data?: {
-        type: string;
+        type: ObjectDataType;
         id: string;
     };
 }
+/** JSON representation returned by {@link serializeCanvas}. */
+export interface CanvasJSON {
+    version: string;
+    objects: Record<string, unknown>[];
+    [key: string]: unknown;
+}
 /** Snapping configuration used by interaction modes (dragToCreate, drawToCreate). */
 export type SnappingOptions = boolean | {
     /** Snap margin in screen pixels. Default: 6. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,YAAY,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,yBAAyB;AACzB,MAAM,MAAM,OAAO,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC;AAED,qFAAqF;AACrF,MAAM,MAAM,eAAe,GACvB,OAAO,GACP;IACE,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEN,mEAAmE;AACnE,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,iEAAiE;AACjE,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG,CACtB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,kBAAkB,GAAG,SAAS,KACrC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,YAAY,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,yBAAyB;AACzB,MAAM,MAAM,OAAO,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,2DAA2D;AAC3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qFAAqF;AACrF,MAAM,MAAM,eAAe,GACvB,OAAO,GACP;IACE,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAEN,mEAAmE;AACnE,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,iEAAiE;AACjE,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;IACzE,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GAAG,CACtB,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,kBAAkB,GAAG,SAAS,KACrC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC"}

package/dist/viewport.d.ts

@@ -11,11 +11,15 @@ export interface PanAndZoomOptions {
     minZoom?: number;
     /** Maximum zoom level (default: 10) */
     maxZoom?: number;
-    /** Zoom sensitivity — larger values zoom faster (default: 1.03) */
+    /** Zoom sensitivity base — raised to the power of deltaY (default: 0.999). */
     zoomFactor?: number;
     /** Initial viewport mode (default: 'select') */
     initialMode?: ViewportMode;
 }
+export interface ZoomToFitOptions {
+    /** Padding fraction around the object (default: 0.1 = 10% on each side). */
+    padding?: number;
+}
 export interface ViewportController {
     /** Switch between select and pan modes. */
     setMode: (mode: ViewportMode) => void;
@@ -35,9 +39,15 @@ export interface ViewportController {
     zoomOut: (factor?: number) => void;
     /**
      * Pan the viewport so the given object is centered on the canvas.
-     * Optionally animate the transition.
+     * Optionally animate the transition. Automatically cancels any
+     * in-progress panToObject animation.
      */
     panToObject: (object: FabricObject, options?: PanToObjectOptions) => void;
+    /**
+     * Zoom and pan the viewport so the given object fills the canvas
+     * with optional padding.
+     */
+    zoomToFit: (object: FabricObject, options?: ZoomToFitOptions) => void;
     /** Remove all event listeners. */
     cleanup: () => void;
 }

package/dist/viewport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,YAAY,EACtB,KAAK,YAAY,EAGlB,MAAM,QAAQ,CAAC;AAQhB,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC,qCAAqC;IACrC,OAAO,EAAE,MAAM,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;;OAGG;IACH,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;OAGG;IACH,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;OAGG;IACH,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC1E,kCAAkC;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AA0MD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,kBAAkB,CAkIpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAExD"}
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../src/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,YAAY,EACtB,KAAK,YAAY,EAGlB,MAAM,QAAQ,CAAC;AAQhB,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACtC,qCAAqC;IACrC,OAAO,EAAE,MAAM,YAAY,CAAC;IAC5B,2EAA2E;IAC3E,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC;;;OAGG;IACH,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;OAGG;IACH,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;OAIG;IACH,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC1E;;;OAGG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACtE,kCAAkC;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AA0MD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,kBAAkB,CA2KpB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAExD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bwp-web/canvas",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",