@open-draw/canvas 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chandra Shekhar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+# @open-draw/canvas
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![npm version](https://img.shields.io/badge/npm-0.1.0-green.svg)](https://www.npmjs.com/package/@open-draw/canvas)
+
+> DOM Canvas engine — an infinite canvas where every shape is a real SVG element.
+
+`@open-draw/canvas` provides a high-performance, pure SVG DOM canvas engine. It powers infinite pan and zoom, reactive transactions, undo/redo history, shape registration, live preview transforms, inline text editing, and export to PNG, all while maintaining strict zero runtime dependencies outside of `@open-draw/schema`.
+
+---
+
+### Installation
+
+```bash
+npm install @open-draw/canvas @open-draw/schema
+```
+
+---
+
+### Minimal Example (30 lines)
+
+```typescript
+import { CanvasEditor } from '@open-draw/canvas';
+
+// 1. Initialize and mount canvas
+const container = document.getElementById('canvas-container')!;
+const editor = new CanvasEditor();
+editor.mount(container);
+
+// 2. Create shapes via reactive transactions
+const note = editor.createShape({
+  type: 'note',
+  x: 100,
+  y: 100,
+  props: { width: 180, height: 120, color: '#fef08a', text: 'Important Note' },
+});
+
+// 3. Attach custom HTML/SVG badges into the shape's overlay slot
+const slot = editor.getOverlaySlot(note.id);
+if (slot) {
+  const badge = document.createElementNS('http://www.w3.org/2000/svg', 'text');
+  badge.setAttribute('x', '10');
+  badge.setAttribute('y', '24');
+  badge.textContent = 'STATUS: REVIEW';
+  slot.appendChild(badge);
+}
+
+// 4. Undo and redo with single-step atomic transactions
+editor.undo();
+editor.redo();
+
+// 5. Export canvas to PNG Blob
+const pngBlob = await editor.exportPNG({ chips: true });
+```
+
+---
+
+### Try the Playground
+
+You can run the interactive development playground locally from the repository root:
+
+```bash
+npx vite --config packages/canvas/e2e/playground/vite.config.ts packages/canvas/e2e/playground --host 127.0.0.1 --port 5173
+```
+
+Navigate to `http://127.0.0.1:5173/` in your browser to interact with the live canvas, test gestures, and benchmark FPS.
+
+---
+
+### Semver Statement
+
+Starting from version `0.1.0`, the public API surface of `@open-draw/canvas` is frozen under CI surveillance. No public export or contract will be changed or removed without an advance minor-version deprecation cycle.
+
+---
+
+### License
+
+MIT © Chandu4221

package/dist/a11y.d.ts

@@ -0,0 +1,13 @@
+import type { ShapeRecord } from '@open-draw/schema';
+import type { ShapeDefinition } from './registry.js';
+/**
+ * Computes semantic role and accessible label for SVG shape wrappers.
+ * Containers (shapes with clipping or group capability) receive 'group' to prevent nested-interactive violations.
+ * Shapes with visible text (props.text, props.label, or text capability) include visible text in accessible name (WCAG 2.5.3).
+ */
+export declare function computeShapeAria(shape: ShapeRecord, def?: ShapeDefinition): {
+    role: string;
+    ariaLabel: string;
+};
+export declare const A11Y_FOCUS_STYLES = "\n  .od-canvas-root:focus-visible { outline: 2px solid #3b82f6; outline-offset: -2px; }\n  .od-shape:focus-visible { outline: 2px solid #3b82f6; outline-offset: 2px; }\n";
+//# sourceMappingURL=a11y.d.ts.map

package/dist/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../src/a11y.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,GAAG,CAAC,EAAE,eAAe,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CA8BrC;AAED,eAAO,MAAM,iBAAiB,8KAG7B,CAAC"}

package/dist/a11y.js

@@ -0,0 +1,41 @@
+/**
+ * Computes semantic role and accessible label for SVG shape wrappers.
+ * Containers (shapes with clipping or group capability) receive 'group' to prevent nested-interactive violations.
+ * Shapes with visible text (props.text, props.label, or text capability) include visible text in accessible name (WCAG 2.5.3).
+ */
+export function computeShapeAria(shape, def) {
+    const isContainer = Boolean(def?.capabilities?.clipping || def?.capabilities?.group);
+    const role = isContainer ? 'group' : 'button';
+    let visibleText = '';
+    if (def?.capabilities?.text?.canEditText(shape)) {
+        visibleText = def.capabilities.text.getText(shape).trim();
+    }
+    else if (typeof shape.props['text'] === 'string' && shape.props['text'].trim()) {
+        visibleText = shape.props['text'].trim();
+    }
+    else if (typeof shape.props['label'] === 'string' && shape.props['label'].trim()) {
+        visibleText = shape.props['label'].trim();
+    }
+    const metaName = typeof shape.meta['name'] === 'string' && shape.meta['name'].trim()
+        ? shape.meta['name'].trim()
+        : '';
+    let ariaLabel;
+    if (visibleText && metaName) {
+        ariaLabel = `${visibleText} (${shape.type} ${metaName})`;
+    }
+    else if (visibleText) {
+        ariaLabel = `${visibleText} (${shape.type})`;
+    }
+    else if (metaName) {
+        ariaLabel = `${shape.type} ${metaName}`;
+    }
+    else {
+        ariaLabel = shape.type;
+    }
+    return { role, ariaLabel };
+}
+export const A11Y_FOCUS_STYLES = `
+  .od-canvas-root:focus-visible { outline: 2px solid #3b82f6; outline-offset: -2px; }
+  .od-shape:focus-visible { outline: 2px solid #3b82f6; outline-offset: 2px; }
+`;
+//# sourceMappingURL=a11y.js.map

package/dist/a11y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.js","sourceRoot":"","sources":["../src/a11y.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAkB,EAClB,GAAqB;IAErB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,IAAI,GAAG,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE9C,IAAI,WAAW,GAAG,EAAE,CAAC;IACrB,IAAI,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5D,CAAC;SAAM,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACjF,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;SAAM,IAAI,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACnF,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,QAAQ,GACZ,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QACjE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QAC3B,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,SAAiB,CAAC;IACtB,IAAI,WAAW,IAAI,QAAQ,EAAE,CAAC;QAC5B,SAAS,GAAG,GAAG,WAAW,KAAK,KAAK,CAAC,IAAI,IAAI,QAAQ,GAAG,CAAC;IAC3D,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,SAAS,GAAG,GAAG,WAAW,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC;IAC/C,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,SAAS,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;CAGhC,CAAC"}

package/dist/camera.d.ts

@@ -0,0 +1,96 @@
+import type { Camera, Point } from '@open-draw/schema';
+/**
+ * Error thrown when camera parameters are invalid (e.g. non-finite or non-positive zoom).
+ */
+export declare class InvalidCameraError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when an invalid zoom factor is supplied.
+ */
+export declare class InvalidZoomError extends Error {
+    readonly factor: number;
+    constructor(factor: number, message?: string);
+}
+/**
+ * Default camera state positioned at origin with 1x zoom.
+ */
+export declare const DEFAULT_CAMERA: Camera;
+/**
+ * Options for zoom operations.
+ */
+export interface ZoomOptions {
+    readonly minZoom?: number;
+    readonly maxZoom?: number;
+}
+/**
+ * Validates and creates an immutable Camera state object.
+ */
+export declare function createCamera(initial?: Partial<Camera>): Camera;
+/**
+ * Converts a point from page (canvas world) coordinates to screen (viewport) coordinates.
+ * Screen point = point * camera.zoom + camera.offset
+ */
+export declare function pageToScreen(point: Point, camera: Camera): Point;
+/**
+ * Converts a point from screen (viewport) coordinates to page (canvas world) coordinates.
+ * Page point = (screen point - camera.offset) / camera.zoom
+ */
+export declare function screenToPage(point: Point, camera: Camera): Point;
+/**
+ * Pans the camera by a delta in screen space.
+ */
+export declare function panCamera(camera: Camera, delta: Point): Camera;
+/**
+ * Zooms the camera around a specific anchor point on the screen (cursor-anchored zoom).
+ * The canvas page point currently under screenPoint remains under screenPoint after zooming.
+ */
+export declare function zoomAroundPoint(camera: Camera, screenPoint: Point, factor: number, options?: ZoomOptions): Camera;
+/**
+ * Fits the camera to focus on given bounds within a viewport.
+ */
+export declare function fitToBounds(bounds: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, viewportSize: {
+    width: number;
+    height: number;
+}, padding?: number): Camera;
+/**
+ * Produces the SVG transform string for the root viewport group:
+ * translate(x, y) scale(zoom)
+ */
+export declare function cameraToTransform(camera: Camera): string;
+/**
+ * Stateful controller for managing camera state, coordinate transforms, and change listeners.
+ */
+export declare class CameraController {
+    private _camera;
+    private readonly _listeners;
+    constructor(initial?: Partial<Camera>);
+    get camera(): Camera;
+    get x(): number;
+    get y(): number;
+    get zoom(): number;
+    setCamera(camera: Camera): void;
+    pageToScreen(point: Point): Point;
+    screenToPage(point: Point): Point;
+    pan(dx: number, dy: number): Camera;
+    zoomAroundPoint(screenPoint: Point, factor: number, options?: ZoomOptions): Camera;
+    toTransform(): string;
+    reset(): Camera;
+    fitToBounds(bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }, viewportSize: {
+        width: number;
+        height: number;
+    }, padding?: number): Camera;
+    subscribe(listener: (camera: Camera) => void): () => void;
+    private _notify;
+}
+//# sourceMappingURL=camera.d.ts.map

package/dist/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"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"}

package/dist/camera.js

@@ -0,0 +1,208 @@
+/**
+ * Error thrown when camera parameters are invalid (e.g. non-finite or non-positive zoom).
+ */
+export class InvalidCameraError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'InvalidCameraError';
+    }
+}
+/**
+ * Error thrown when an invalid zoom factor is supplied.
+ */
+export class InvalidZoomError extends Error {
+    factor;
+    constructor(factor, message) {
+        super(message ?? `Invalid zoom factor: ${factor}. Zoom factor must be a finite positive number.`);
+        this.name = 'InvalidZoomError';
+        this.factor = factor;
+    }
+}
+/**
+ * Default camera state positioned at origin with 1x zoom.
+ */
+export const DEFAULT_CAMERA = Object.freeze({
+    x: 0,
+    y: 0,
+    zoom: 1,
+});
+/**
+ * Validates and creates an immutable Camera state object.
+ */
+export function createCamera(initial) {
+    const x = initial?.x ?? DEFAULT_CAMERA.x;
+    const y = initial?.y ?? DEFAULT_CAMERA.y;
+    const zoom = initial?.zoom ?? DEFAULT_CAMERA.zoom;
+    if (!Number.isFinite(x) || !Number.isFinite(y)) {
+        throw new InvalidCameraError(`Camera coordinates must be finite numbers: x=${x}, y=${y}`);
+    }
+    if (!Number.isFinite(zoom) || zoom <= 0) {
+        throw new InvalidCameraError(`Camera zoom must be a finite positive number: zoom=${zoom}`);
+    }
+    return Object.freeze({ x, y, zoom });
+}
+/**
+ * Converts a point from page (canvas world) coordinates to screen (viewport) coordinates.
+ * Screen point = point * camera.zoom + camera.offset
+ */
+export function pageToScreen(point, camera) {
+    if (!Number.isFinite(point.x) || !Number.isFinite(point.y)) {
+        throw new InvalidCameraError(`Point coordinates must be finite numbers: x=${point.x}, y=${point.y}`);
+    }
+    return {
+        x: point.x * camera.zoom + camera.x,
+        y: point.y * camera.zoom + camera.y,
+    };
+}
+/**
+ * Converts a point from screen (viewport) coordinates to page (canvas world) coordinates.
+ * Page point = (screen point - camera.offset) / camera.zoom
+ */
+export function screenToPage(point, camera) {
+    if (!Number.isFinite(point.x) || !Number.isFinite(point.y)) {
+        throw new InvalidCameraError(`Point coordinates must be finite numbers: x=${point.x}, y=${point.y}`);
+    }
+    if (!Number.isFinite(camera.zoom) || camera.zoom <= 0) {
+        throw new InvalidCameraError(`Camera zoom must be a finite positive number: zoom=${camera.zoom}`);
+    }
+    return {
+        x: (point.x - camera.x) / camera.zoom,
+        y: (point.y - camera.y) / camera.zoom,
+    };
+}
+/**
+ * Pans the camera by a delta in screen space.
+ */
+export function panCamera(camera, delta) {
+    if (!Number.isFinite(delta.x) || !Number.isFinite(delta.y)) {
+        throw new InvalidCameraError(`Pan delta coordinates must be finite numbers: dx=${delta.x}, dy=${delta.y}`);
+    }
+    return createCamera({
+        x: camera.x + delta.x,
+        y: camera.y + delta.y,
+        zoom: camera.zoom,
+    });
+}
+/**
+ * Zooms the camera around a specific anchor point on the screen (cursor-anchored zoom).
+ * The canvas page point currently under screenPoint remains under screenPoint after zooming.
+ */
+export function zoomAroundPoint(camera, screenPoint, factor, options) {
+    if (!Number.isFinite(factor) || factor <= 0) {
+        throw new InvalidZoomError(factor);
+    }
+    if (!Number.isFinite(screenPoint.x) || !Number.isFinite(screenPoint.y)) {
+        throw new InvalidCameraError(`Screen anchor coordinates must be finite: x=${screenPoint.x}, y=${screenPoint.y}`);
+    }
+    let targetZoom = camera.zoom * factor;
+    if (options?.minZoom !== undefined && Number.isFinite(options.minZoom)) {
+        targetZoom = Math.max(targetZoom, options.minZoom);
+    }
+    if (options?.maxZoom !== undefined && Number.isFinite(options.maxZoom)) {
+        targetZoom = Math.min(targetZoom, options.maxZoom);
+    }
+    const effectiveFactor = targetZoom / camera.zoom;
+    const newX = screenPoint.x - (screenPoint.x - camera.x) * effectiveFactor;
+    const newY = screenPoint.y - (screenPoint.y - camera.y) * effectiveFactor;
+    return createCamera({
+        x: newX,
+        y: newY,
+        zoom: targetZoom,
+    });
+}
+/**
+ * Fits the camera to focus on given bounds within a viewport.
+ */
+export function fitToBounds(bounds, viewportSize, padding = 40) {
+    if (bounds.width <= 0 || bounds.height <= 0 || viewportSize.width <= 0 || viewportSize.height <= 0) {
+        return DEFAULT_CAMERA;
+    }
+    const availableW = Math.max(10, viewportSize.width - padding * 2);
+    const availableH = Math.max(10, viewportSize.height - padding * 2);
+    const zoomX = availableW / bounds.width;
+    const zoomY = availableH / bounds.height;
+    const clampedZoom = Math.max(0.1, Math.min(2, Math.min(zoomX, zoomY)));
+    const centerX = bounds.x + bounds.width / 2;
+    const centerY = bounds.y + bounds.height / 2;
+    const x = viewportSize.width / 2 - centerX * clampedZoom;
+    const y = viewportSize.height / 2 - centerY * clampedZoom;
+    return createCamera({ x, y, zoom: clampedZoom });
+}
+/**
+ * Produces the SVG transform string for the root viewport group:
+ * translate(x, y) scale(zoom)
+ */
+export function cameraToTransform(camera) {
+    return `translate(${camera.x}, ${camera.y}) scale(${camera.zoom})`;
+}
+/**
+ * Stateful controller for managing camera state, coordinate transforms, and change listeners.
+ */
+export class CameraController {
+    _camera;
+    _listeners = new Set();
+    constructor(initial) {
+        this._camera = createCamera(initial);
+    }
+    get camera() {
+        return this._camera;
+    }
+    get x() {
+        return this._camera.x;
+    }
+    get y() {
+        return this._camera.y;
+    }
+    get zoom() {
+        return this._camera.zoom;
+    }
+    setCamera(camera) {
+        const next = createCamera(camera);
+        if (next.x !== this._camera.x || next.y !== this._camera.y || next.zoom !== this._camera.zoom) {
+            this._camera = next;
+            this._notify();
+        }
+    }
+    pageToScreen(point) {
+        return pageToScreen(point, this._camera);
+    }
+    screenToPage(point) {
+        return screenToPage(point, this._camera);
+    }
+    pan(dx, dy) {
+        const next = panCamera(this._camera, { x: dx, y: dy });
+        this._camera = next;
+        this._notify();
+        return next;
+    }
+    zoomAroundPoint(screenPoint, factor, options) {
+        const next = zoomAroundPoint(this._camera, screenPoint, factor, options);
+        this._camera = next;
+        this._notify();
+        return next;
+    }
+    toTransform() {
+        return cameraToTransform(this._camera);
+    }
+    reset() {
+        this.setCamera(DEFAULT_CAMERA);
+        return this._camera;
+    }
+    fitToBounds(bounds, viewportSize, padding) {
+        const next = fitToBounds(bounds, viewportSize, padding);
+        this.setCamera(next);
+        return next;
+    }
+    subscribe(listener) {
+        this._listeners.add(listener);
+        return () => {
+            this._listeners.delete(listener);
+        };
+    }
+    _notify() {
+        for (const listener of this._listeners) {
+            listener(this._camera);
+        }
+    }
+}
+//# sourceMappingURL=camera.js.map

package/dist/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/clipping/defs.d.ts

@@ -0,0 +1,7 @@
+import type { ShapeId } from '@open-draw/schema';
+export interface ChildOrphanedEvent {
+    readonly childId: ShapeId;
+    readonly previousParentId: ShapeId;
+}
+export type OrphanListener = (event: ChildOrphanedEvent) => void;
+//# sourceMappingURL=defs.d.ts.map

package/dist/capabilities/clipping/defs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defs.d.ts","sourceRoot":"","sources":["../../../src/capabilities/clipping/defs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC"}

package/dist/capabilities/clipping/defs.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defs.js.map

package/dist/capabilities/clipping/defs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defs.js","sourceRoot":"","sources":["../../../src/capabilities/clipping/defs.ts"],"names":[],"mappings":""}

package/dist/capabilities/clipping/index.d.ts

@@ -0,0 +1,3 @@
+export * from './defs.js';
+export * from './manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/clipping/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/clipping/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/capabilities/clipping/index.js

@@ -0,0 +1,3 @@
+export * from './defs.js';
+export * from './manager.js';
+//# sourceMappingURL=index.js.map

package/dist/capabilities/clipping/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/capabilities/clipping/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/capabilities/clipping/manager.d.ts

@@ -0,0 +1,14 @@
+import type { Bounds, ShapeId, ShapeRecord } from '@open-draw/schema';
+import type { ShapeRegistry } from '../../registry.js';
+import type { CanvasStore } from '../../store/index.js';
+import type { ChildOrphanedEvent, OrphanListener } from './defs.js';
+export declare function isContainedWithin(child: Bounds, container: Bounds): boolean;
+export declare function findSuggestedParent(childBounds: Bounds, shapes: Iterable<ShapeRecord>, registry: ShapeRegistry, excludeId?: ShapeId): ShapeRecord | null;
+export declare class ClippingManager {
+    private orphanListeners;
+    onChildOrphaned(listener: OrphanListener): () => void;
+    emitOrphaned(event: ChildOrphanedEvent): void;
+    handleParentDeletion(deletedParentId: ShapeId, store: CanvasStore): void;
+    detachChild(childId: ShapeId, store: CanvasStore): void;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/capabilities/clipping/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/capabilities/clipping/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAO3E;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAC7B,QAAQ,EAAE,aAAa,EACvB,SAAS,CAAC,EAAE,OAAO,GAClB,WAAW,GAAG,IAAI,CAuBpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,eAAe,CAAkC;IAEzD,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAGpD;IAED,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAQ5C;IAED,oBAAoB,CAAC,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAkBvE;IAED,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAUtD;CACF"}

package/dist/capabilities/clipping/manager.js

@@ -0,0 +1,75 @@
+export function isContainedWithin(child, container) {
+    return (child.x >= container.x &&
+        child.y >= container.y &&
+        child.x + child.width <= container.x + container.width &&
+        child.y + child.height <= container.y + container.height);
+}
+export function findSuggestedParent(childBounds, shapes, registry, excludeId) {
+    let bestCandidate = null;
+    let smallestArea = Infinity;
+    for (const candidate of shapes) {
+        if (candidate.id === excludeId)
+            continue;
+        const def = registry.get(candidate.type);
+        if (!def?.capabilities?.clipping?.isMask(candidate)) {
+            continue;
+        }
+        const containerBounds = def.geometry.bounds(candidate);
+        if (isContainedWithin(childBounds, containerBounds)) {
+            const area = containerBounds.width * containerBounds.height;
+            if (area < smallestArea) {
+                smallestArea = area;
+                bestCandidate = candidate;
+            }
+        }
+    }
+    return bestCandidate;
+}
+export class ClippingManager {
+    orphanListeners = new Set();
+    onChildOrphaned(listener) {
+        this.orphanListeners.add(listener);
+        return () => this.orphanListeners.delete(listener);
+    }
+    emitOrphaned(event) {
+        for (const listener of this.orphanListeners) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                console.error('Orphan listener error:', err);
+            }
+        }
+    }
+    handleParentDeletion(deletedParentId, store) {
+        const orphaned = [];
+        for (const shape of store.listShapes()) {
+            if (shape.meta['parent'] === deletedParentId || shape.meta['parentId'] === deletedParentId) {
+                orphaned.push(shape);
+            }
+        }
+        if (orphaned.length === 0)
+            return;
+        store.transact(() => {
+            for (const child of orphaned) {
+                store.updateShape(child.id, {
+                    meta: { parent: undefined, parentId: undefined },
+                });
+                this.emitOrphaned({ childId: child.id, previousParentId: deletedParentId });
+            }
+        });
+    }
+    detachChild(childId, store) {
+        const child = store.getShape(childId);
+        if (!child)
+            return;
+        const parentId = (child.meta['parent'] ?? child.meta['parentId']);
+        if (!parentId || typeof parentId !== 'string')
+            return;
+        store.updateShape(childId, {
+            meta: { parent: undefined, parentId: undefined },
+        });
+        this.emitOrphaned({ childId, previousParentId: parentId });
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/capabilities/clipping/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/capabilities/clipping/manager.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/connector/defs.d.ts

@@ -0,0 +1,9 @@
+import type { Point, ShapeId } from '@open-draw/schema';
+export interface TargetUnboundEvent {
+    readonly arrowId: ShapeId;
+    readonly which: 'start' | 'end';
+    readonly previousTargetId: ShapeId;
+    readonly fallbackPoint: Point;
+}
+export type UnbindListener = (event: TargetUnboundEvent) => void;
+//# sourceMappingURL=defs.d.ts.map

package/dist/capabilities/connector/defs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defs.d.ts","sourceRoot":"","sources":["../../../src/capabilities/connector/defs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC"}

package/dist/capabilities/connector/defs.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=defs.js.map

package/dist/capabilities/connector/defs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defs.js","sourceRoot":"","sources":["../../../src/capabilities/connector/defs.ts"],"names":[],"mappings":""}