@rasamjs/connectors 0.0.0-stage → 0.1.0

package/API.md

@@ -0,0 +1,114 @@
+# Connectors API
+
+The root exports `Connectors`, `isConnector`, `connectorPort`, `routeConnector` and
+connector option/state/geometry types. Optional `./tool` exports `ConnectorTool` and
+`ConnectorToolOptions`. Only core is imported at runtime. Imports are document-free.
+
+## Model and history
+
+`new Connectors(drawing)` attaches one service to an owning SVG root. Existing saved
+connectors are validated without rewriting their stored geometry. No history recorder
+is created; supply your own if needed.
+
+`create(options)` returns an ordinary `Path` in one labelled core change group:
+
+- `start`, `end`: `{ target, anchor? }` or `{ point: { x, y } }`. Free points use drawing
+  units. Targets are transformable shapes/groups/viewports in the same drawing,
+  excluding the root, connectors and groups containing connectors.
+- `anchor`: `auto` (default), `top`, `right`, `bottom`, `left`, or `{ x, y }` normalized
+  between 0 and 1 within the target's local geometric bounds. `{ x: 1, y: 0.5 }` is
+  right-center and follows resizing. Sides rotate with the target. Auto intersects the
+  ray toward the other endpoint with the local bounds rectangle.
+- `routing`: `straight` (default) or `elbow`. Elbows use orthogonal drawing-space
+  segments with 16-unit outward leads. They do not avoid obstacles; close/opposing
+  anchors can produce backtracking. Curved routing and connector labels are deferred.
+- `arrows`: `end` (default), `both`, or `none`. SVG markers use `auto-start-reverse`
+  orientation and `context-stroke` fill, following the connector's stroke.
+- `stroke`: nonempty SVG paint, default `#334155`; `strokeWidth`: finite nonnegative
+  number, default 2. Edit subsequent appearance through ordinary path APIs.
+
+`nodes` is a frozen snapshot of current paths in document order. `read(path)` returns
+`{ path, start, end, routing }`. `update(path, { start?, end?, routing? })` changes a
+connection in one labelled edit. `remove(path)` detaches it reversibly in one edit;
+its marker resources remain available. Undoing creation also removes newly created
+endpoint IDs and markers. Undo/redo retain path and endpoint identities.
+
+Routes update synchronously through core `deriveChanges()`, before the mover's final
+change snapshot. Shape/parent moves, resizing, rotation and reparenting join the same
+operation/group, including ordinary setters, transformer gestures and transactions.
+Getter-only operations do not route. Replay and rollback restore saved path data
+without recomputing it. Camera changes with source `viewport` do not route.
+
+Geometry uses fill bounds, excluding strokes and clipping. Curved/irregular targets
+use their bounds rectangle for automatic anchors. Empty/unavailable geometry or an
+unmappable automatic anchor/path rejects creation/update. Existing paths retain their last geometry
+while targets are detached or unmappable; undo and later changes restore tracking.
+A connector cannot be placed inside its own endpoint target, which would make routing
+cyclic. Failed connector commands cancel partial edits. Caller setters follow core's
+failure semantics; use a history transaction for rollback when dependent writes fail.
+The service discovers imported/cloned paths at operation boundaries without registration.
+
+`isDestroyed` reports disposal. `destroy()` is idempotent and stops derivation without
+removing document paths. `onDispose(callback)` returns an unsubscribe function.
+Drawing disposal destroys the service and its tools. Recreate for a replacement drawing.
+
+## Persistence
+
+Versioned routing, anchors and free points live in `data-rasam-connector`. Attached
+targets use typed href fragments in the reserved `data-rasam-connector-start` and
+`data-rasam-connector-end` attributes. Core recognizes them during clone, export/import
+and ID remapping. Markers use normal typed URL references. No custom catalog is needed.
+
+Cloning a whole group rebinds copied connectors to copied endpoints. Cloning a path
+alone shares its external endpoints/markers by default. Exporting a connector alone
+includes referenced shapes as dependencies in defs; a whole drawing retains visible
+shapes and attachments. Permanently destroying a referenced target requires unbinding
+its consumers first; editor deletion uses reversible removal. Use the matching current
+core build while these APIs remain unreleased.
+
+## Geometry helpers
+
+`connectorPort(endpoint, toward)` returns `{ point, direction }` in drawing units or
+null for unavailable geometry. Direction is the dominant orthogonal outward axis,
+or zero for a free endpoint. `routeConnector({ start, end, routing })` returns route
+points without editing the drawing.
+
+## Connector tool
+
+`new ConnectorTool(connectors, options = {})` creates a disabled overlay outside the
+managed SVG. Set `enabled = true` to draw primary-pointer drags. Options accept the
+same routing/arrows/stroke/strokeWidth settings, plus:
+
+- `selectable(target)`: filter hover targets, for example with layer lock rules.
+- `onCreate(path)`: select the committed node or switch tools after creation.
+- `onGesture(active)`: suspend camera input during a drag; false on completion/cancel.
+- `onError(error)`: receives pointer/callback errors; otherwise errors propagate.
+- `onExit()`: runs after Escape exits an idle enabled tool.
+
+Hover shows four side hints, five overlay pixels in radius at every zoom. Press within
+twelve client pixels of a side to choose it; body presses use auto anchors. Empty-space
+presses/releases use free points. Previews never edit the document. Release creates one
+labelled edit; coincident endpoints create nothing. The tool stays enabled so the app
+can choose keep-tool behavior.
+
+Escape cancels an active drag; another Escape exits the tool. Blur, pointer cancellation,
+lost capture, disabling, endpoint removal, service destruction and drawing destruction
+release captures/previews. Editable controls and dialogs retain their keys. `update()`
+refreshes the overlay and returns the tool. `isDestroyed` reports disposal. `destroy()`
+is idempotent and releases listeners, frames, observers and DOM. Disable the tool when
+switching other application modes.
+
+## Editor integration entry
+
+`@rasamjs/connectors/editor` exports `connectorEditing()`, a structural extension
+factory. Its value is the current `Connectors` service. It registers
+`connector-straight` (C) and `connector-elbow` (Shift+C), with matching command IDs,
+active-tool metadata, current selection/layer restrictions, paint, keep-tool and
+camera/capture cleanup. Escape cancels a drag first and exits an idle tool;
+document replacement, editing/dialog actions, tool changes and disposal interrupt
+sessions. Read-only camera commands retain an idle connector mode.
+
+`ConnectorTool.paint` reads an immutable `{ stroke, strokeWidth }` snapshot and
+accepts a validated replacement. Updates repaint an active preview and apply to
+the committed path. The adapter forwards editor paint changes through this API.
+The adapter imports only connector modules and core, with no editor peer.

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## Unreleased
+
+- Add `./editor` connector integration with registered tool metadata, live paint,
+  keep-tool and scoped camera/input cleanup. Add `ConnectorTool.paint` for preview updates.
+
+- Add attached straight/elbow paths, automatic/side/normalized-point anchors, free
+  endpoints, marker arrows and saved typed references.
+- Derive routing inside the mover's original operation/group; undo/redo restore stored
+  geometry. Support transformed parents, resizing, reparenting and cloned connections.
+- Add optional `./tool` with hover anchors, previews, capture, cancellation and cleanup.
+- Include API, documentation, size/isolation and packed-consumer checks.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rasam contributors
+
+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,45 @@
-# Temporary Holding Version
+# @rasamjs/connectors
 
-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.
+The optional [editor adapter](API.md#editor-integration-entry) packages connector
+services and registered straight/elbow tools, including live paint and input cleanup.
+
+Attached straight and elbow lines and marker arrows for rasam SVG drawings. Core is
+the only runtime peer. This package is unreleased and remains private.
+
+```ts
+import { SVG } from '@rasamjs/core';
+import { Connectors } from '@rasamjs/connectors';
+import { ConnectorTool } from '@rasamjs/connectors/tool';
+
+const drawing = SVG(host, { width: 700, height: 500 });
+const a = drawing.rect({ x: 40, y: 40, width: 80, height: 50 });
+const b = drawing.rect({ x: 300, y: 180, width: 80, height: 50 });
+const connectors = new Connectors(drawing);
+const path = connectors.create({
+  start: { target: a, anchor: 'right' },
+  end: { target: b, anchor: 'auto' },
+  routing: 'elbow',
+});
+const tool = new ConnectorTool(connectors, { routing: 'straight' });
+tool.enabled = true;
+```
+
+Moving or resizing an endpoint, or its parent, updates the connector inside the same
+model operation and change group. History records one undo step for a move and all
+its attached lines. Replay restores stored geometry without routing again.
+
+The optional tool previews on an overlay, shows side anchors on hover, and writes
+one connector on release. Escape, pointer cancellation and blur discard the preview.
+The playground exposes Connector (`C`) and Elbow connector (`Shift+C`) tools.
+
+Attachments are typed references on ordinary paths, so saved SVG, clones, imports,
+clipboard and history retain them. No custom element registration is needed.
+Both entries can be imported without a document. See [API.md](./API.md) for anchor
+coordinates, lifecycle, routing limits and persistence behavior.
+
+```sh
+bun run --cwd packages/connectors test
+bun run --cwd packages/connectors test:browser
+bun run --cwd packages/connectors typecheck
+bun run --cwd packages/connectors build
+```

package/RELEASING.md

@@ -0,0 +1,25 @@
+# Releasing connectors
+
+The package remains private and unreleased. Phase 10 does not authorize publishing,
+pushing or changing an existing approved size cap.
+
+Run scoped format, typecheck, unit, build, API, docs, browser, consumer and size checks.
+Run `api:update` only after reviewing the API diff. The root's 5 KiB gzip and optional
+tool's 4 KiB budgets keep core external and UI code isolated from the model entry.
+
+The separately requested `release:check` uses the shared workspace gate and records
+source hashes/readiness. Build core first: connectors need its current derivation and
+reserved-reference APIs. The consumer check packs only core and connectors, validates
+all three entries, declarations, maps, document-free imports and absence of dependencies.
+
+Phase 13 adds `@rasamjs/connectors/editor`, a structural service/tool adapter at
+5,781/8,192 B gzip. It keeps the existing core-only peer graph; editor is not a
+runtime dependency or peer. Root/tool caps remain unchanged. The tool accepts live
+paint updates, and editor/playground matrices cover registered shortcuts, metadata,
+keep-tool, captures and camera cleanup. Scoped checks pass 18 unit tests and 12
+three-engine browser cases, typecheck/build, formatting, API/docs, size/isolation
+and the packed consumer. The full release gate, new benchmarks and native-device
+checks were not run.
+
+Before separately authorized publication, follow the workspace/core release procedure
+and validate the matching core version. No npm publication is performed here.

package/dist/connectors.d.ts

@@ -0,0 +1,26 @@
+import { Path } from '@rasamjs/core';
+import type { Svg } from '@rasamjs/core';
+import type { ConnectorOptions, ConnectorState } from './types.js';
+export declare class Connectors {
+    readonly drawing: Svg;
+    private disposed;
+    private readonly cleanups;
+    private readonly disposals;
+    constructor(drawing: Svg);
+    get isDestroyed(): boolean;
+    onDispose(listener: () => void): () => void;
+    get nodes(): readonly Path[];
+    read(path: Path): ConnectorState;
+    create(options: ConnectorOptions): Path;
+    update(path: Path, patch: Partial<Pick<ConnectorOptions, 'start' | 'end' | 'routing'>>): void;
+    remove(path: Path): void;
+    destroy(): void;
+    private assertLive;
+    private assertPath;
+    private validate;
+    private validateEndpoint;
+    private affects;
+    private route;
+    private edit;
+}
+//# sourceMappingURL=connectors.d.ts.map

package/dist/connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["../src/connectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,EAAE,GAAG,EAAW,MAAM,eAAe,CAAC;AAYlD,OAAO,KAAK,EAAqB,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAkBtF,qBAAa,UAAU;IAIT,QAAQ,CAAC,OAAO,EAAE,GAAG;IAHjC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,YAAqB,OAAO,EAAE,GAAG,EAuBhC;IACD,IAAI,WAAW,IAAI,OAAO,CAEzB;IACD,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAO1C;IACD,IAAI,KAAK,IAAI,SAAS,IAAI,EAAE,CAG3B;IACD,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,CAG/B;IACD,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAgCtC;IACD,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC,GAAG,IAAI,CAS5F;IACD,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAGvB;IACD,OAAO,IAAI,IAAI,CAcd;IACD,OAAO,CAAC,UAAU;IAGlB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,KAAK;IAuBb,OAAO,CAAC,IAAI;CAgBb"}

package/dist/connectors.js

@@ -0,0 +1,231 @@
+import { Path } from '@rasamjs/core';
+import { Guards } from '@rasamjs/core/advanced';
+import { beginChangeGroup, deriveChanges } from '@rasamjs/core/changes';
+import { isConnector, readConnector, writeConnector } from './metadata.js';
+import { connectorPort, endpointCenter, pathData, routeConnector, validateAnchor, validatePoint, } from './routing.js';
+const owners = new WeakMap();
+const drawableTags = new Set([
+    'rect',
+    'circle',
+    'ellipse',
+    'line',
+    'polyline',
+    'polygon',
+    'path',
+    'text',
+    'image',
+    'foreignObject',
+    'use',
+    'g',
+    'svg',
+]);
+export class Connectors {
+    drawing;
+    disposed = false;
+    cleanups = [];
+    disposals = new Set();
+    constructor(drawing) {
+        this.drawing = drawing;
+        if (!Guards.isTransformable(drawing) ||
+            drawing.isDestroyed ||
+            drawing !== drawing.context.root ||
+            drawing.el.localName !== 'svg')
+            throw new TypeError('Connectors needs a live SVG drawing root');
+        if (owners.has(drawing))
+            throw new Error('Connectors is already attached to this drawing');
+        // Validate saved attachments without changing stored routing during attachment or replay.
+        this.nodes.forEach(readConnector);
+        owners.set(drawing, this);
+        this.cleanups.push(deriveChanges(drawing, (event) => {
+            if (event.source === 'viewport')
+                return;
+            for (const path of this.nodes) {
+                const state = readConnector(path);
+                if (event.nodes.some((changed) => changed === path || this.affects(changed, state)))
+                    this.route(state);
+            }
+        }), drawing.onDispose(() => this.destroy()));
+    }
+    get isDestroyed() {
+        return this.disposed;
+    }
+    onDispose(listener) {
+        this.assertLive();
+        if (typeof listener !== 'function')
+            throw new TypeError('Disposal listener must be a function');
+        this.disposals.add(listener);
+        return () => {
+            this.disposals.delete(listener);
+        };
+    }
+    get nodes() {
+        this.assertLive();
+        return Object.freeze(this.drawing.descendants().filter(isConnector));
+    }
+    read(path) {
+        this.assertPath(path);
+        return readConnector(path);
+    }
+    create(options) {
+        this.assertLive();
+        this.validate(options);
+        return this.edit('Create connector', () => {
+            const path = this.drawing.path({
+                d: '',
+                fill: 'none',
+                stroke: options.stroke ?? '#334155',
+                'stroke-width': options.strokeWidth ?? 2,
+            });
+            writeConnector(path, {
+                start: options.start,
+                end: options.end,
+                routing: options.routing ?? 'straight',
+            });
+            if ((options.arrows ?? 'end') !== 'none') {
+                const marker = this.drawing.createMarker({
+                    viewBox: '0 0 10 10',
+                    markerWidth: 6,
+                    markerHeight: 6,
+                    refX: 9,
+                    refY: 5,
+                    orient: 'auto-start-reverse',
+                });
+                marker.path({ d: 'M0 0 L10 5 L0 10 Z', fill: 'context-stroke', stroke: 'none' });
+                path.marker('end', marker);
+                if (options.arrows === 'both')
+                    path.marker('start', marker);
+            }
+            if (!this.route(readConnector(path)))
+                throw new Error('Connector needs available bounds and invertible transforms');
+            return path;
+        });
+    }
+    update(path, patch) {
+        this.assertPath(path);
+        const state = { ...readConnector(path), ...patch };
+        this.validate(state);
+        this.edit('Edit connector', () => {
+            writeConnector(path, state);
+            if (!this.route(state))
+                throw new Error('Connector needs available bounds and invertible transforms');
+        });
+    }
+    remove(path) {
+        this.assertPath(path);
+        this.edit('Delete connector', () => path.remove());
+    }
+    destroy() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        owners.delete(this.drawing);
+        const failures = [];
+        for (const stop of [...this.cleanups.splice(0).reverse(), ...this.disposals]) {
+            try {
+                stop();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        this.disposals.clear();
+        if (failures.length)
+            throw new AggregateError(failures, 'Connector cleanup failed');
+    }
+    assertLive() {
+        if (this.disposed)
+            throw new Error('Connectors is destroyed');
+    }
+    assertPath(path) {
+        this.assertLive();
+        if (!isConnector(path) ||
+            path.isDestroyed ||
+            path.context !== this.drawing.context ||
+            !this.drawing.descendants().includes(path))
+            throw new TypeError('Expected a connector in this drawing');
+    }
+    validate(options) {
+        if (!options || typeof options !== 'object')
+            throw new TypeError('Connector options must be an object');
+        for (const endpoint of [options.start, options.end])
+            this.validateEndpoint(endpoint);
+        if (options.routing !== undefined && !['straight', 'elbow'].includes(options.routing))
+            throw new TypeError('Unknown connector routing');
+        if (options.arrows !== undefined && !['none', 'end', 'both'].includes(options.arrows))
+            throw new TypeError('Unknown connector arrows');
+        if (options.stroke !== undefined &&
+            (typeof options.stroke !== 'string' || !options.stroke.trim()))
+            throw new TypeError('Connector stroke must be nonempty');
+        if (options.strokeWidth !== undefined &&
+            (!Number.isFinite(options.strokeWidth) || options.strokeWidth < 0))
+            throw new TypeError('Connector stroke width must be nonnegative');
+    }
+    validateEndpoint(endpoint) {
+        if (!endpoint || typeof endpoint !== 'object' || 'target' in endpoint === 'point' in endpoint)
+            throw new TypeError('Endpoint needs either a target or a point');
+        if ('point' in endpoint) {
+            validatePoint(endpoint.point);
+            return;
+        }
+        const target = endpoint.target;
+        if (!Guards.isTransformable(target) ||
+            target.isDestroyed ||
+            target === this.drawing ||
+            target.context !== this.drawing.context ||
+            !this.drawing.descendants().includes(target) ||
+            target.descendants().some(isConnector))
+            throw new TypeError('Endpoint target must be a drawable shape without connectors in this drawing');
+        for (let node = target; node && node !== this.drawing; node = node.parent)
+            if (!drawableTags.has(node.el.localName))
+                throw new TypeError('Connector targets cannot be inside definitions');
+        validateAnchor(endpoint.anchor ?? 'auto');
+    }
+    affects(changed, { path, start, end }) {
+        // Parents can move, resize, reparent or change a group's local bounds through a descendant.
+        return [
+            path,
+            ...[start, end].flatMap((endpoint) => ('target' in endpoint ? [endpoint.target] : [])),
+        ].some((node) => node === changed ||
+            node.descendants().includes(changed) ||
+            changed.descendants().includes(node));
+    }
+    route(state) {
+        const { path, start, end } = state;
+        for (const endpoint of [start, end])
+            if ('target' in endpoint) {
+                if (endpoint.target.isDestroyed || !this.drawing.descendants().includes(endpoint.target))
+                    return false;
+                if (endpoint.target.descendants().includes(path))
+                    throw new TypeError('A connector cannot be inside its endpoint target');
+            }
+        const a = endpointCenter(start), b = endpointCenter(end);
+        const from = a && b ? connectorPort(start, b) : null;
+        const to = a && b ? connectorPort(end, a) : null;
+        const inverse = path.worldMatrix().inverse();
+        if (!from || !to || !inverse)
+            return false;
+        const d = pathData(routeConnector({ start: from, end: to, routing: state.routing }).map((point) => inverse.apply(point)));
+        if (path.getAttributeValue('d') !== d)
+            path.attrs({ d });
+        return true;
+    }
+    edit(label, run) {
+        const group = beginChangeGroup(this.drawing, { source: 'connectors', label });
+        let result;
+        try {
+            result = group.run(run);
+        }
+        catch (error) {
+            try {
+                group.cancel();
+            }
+            catch (cleanup) {
+                throw new AggregateError([error, cleanup], 'Connector edit and rollback failed');
+            }
+            throw error;
+        }
+        group.end();
+        return result;
+    }
+}
+//# sourceMappingURL=connectors.js.map

package/dist/connectors.js.map

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

package/dist/editor.d.ts

@@ -0,0 +1,42 @@
+import type { AnyNode, Svg } from '@rasamjs/core';
+import { Connectors } from './connectors.js';
+export interface ConnectorScope {
+    readonly drawing: Svg;
+    readonly editor: {
+        readonly paint: {
+            readonly stroke: string;
+            readonly strokeWidth: number;
+        };
+        readonly selection: {
+            canSelect(node: AnyNode): boolean;
+        };
+        readonly layers: {
+            isSelectable(node: AnyNode): boolean;
+        };
+        fail(action: string, error: unknown): void;
+    };
+    use<Value extends {
+        destroy(): void;
+    }>(value: Value): Value;
+    registerTool(definition: {
+        id: string;
+        label: string;
+        key: string;
+        hint: string;
+        commandId: string;
+        activate(scope: ConnectorScope): {
+            destroy(): void;
+            key?(event: KeyboardEvent): boolean;
+        };
+    }): () => void;
+    cleanup(callback: () => void): void;
+    on(type: 'camera' | 'paint', callback: () => void): void;
+    gesture(): () => void;
+    created(node: AnyNode): void;
+    exit(): void;
+}
+export declare function connectorEditing(): {
+    id: string;
+    create(scope: ConnectorScope): Connectors;
+};
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,KAAK,EAAE;YAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1E,QAAQ,CAAC,SAAS,EAAE;YAAE,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;SAAE,CAAC;QAC1D,QAAQ,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;SAAE,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;KAC5C,CAAC;IACF,GAAG,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;IAC5D,YAAY,CAAC,UAAU,EAAE;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG;YAAE,OAAO,IAAI,IAAI,CAAC;YAAC,GAAG,CAAC,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAA;SAAE,CAAC;KAC3F,GAAG,MAAM,IAAI,CAAC;IACf,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACpC,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACzD,OAAO,IAAI,MAAM,IAAI,CAAC;IACtB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,IAAI,IAAI,IAAI,CAAC;CACd;AACD,wBAAgB,gBAAgB;IAE5B,EAAE;IACF,MAAM,QAAQ,cAAc;EAmD/B"}

package/dist/editor.js

@@ -0,0 +1,55 @@
+import { Connectors } from './connectors.js';
+import { ConnectorTool } from './tool.js';
+export function connectorEditing() {
+    return {
+        id: 'connectors',
+        create(scope) {
+            const service = scope.use(new Connectors(scope.drawing));
+            for (const routing of ['straight', 'elbow'])
+                scope.registerTool({
+                    id: `connector-${routing}`,
+                    commandId: `connector-${routing}`,
+                    label: routing === 'straight' ? 'Connector' : 'Elbow connector',
+                    key: routing === 'straight' ? 'C' : 'Shift+C',
+                    hint: 'Drag between shapes to connect; hover to choose an anchor; Escape cancels.',
+                    activate(current) {
+                        const editor = current.editor;
+                        let release = () => { }, dragging = false;
+                        current.cleanup(() => release());
+                        const tool = current.use(new ConnectorTool(service, {
+                            routing,
+                            ...editor.paint,
+                            selectable: (node) => editor.selection.canSelect(node) && editor.layers.isSelectable(node),
+                            onGesture(active) {
+                                dragging = active;
+                                release();
+                                release = active ? current.gesture() : () => { };
+                            },
+                            onCreate: (path) => current.created(path),
+                            onError: (error) => {
+                                editor.fail('Draw connector', error);
+                                current.exit();
+                            },
+                            onExit: () => current.exit(),
+                        }));
+                        current.on('camera', () => tool.update());
+                        current.on('paint', () => {
+                            tool.paint = editor.paint;
+                        });
+                        tool.enabled = true;
+                        return {
+                            destroy() { },
+                            key(event) {
+                                if (event.type !== 'keydown' || event.key !== 'Escape' || !dragging)
+                                    return false;
+                                tool.cancel();
+                                return true;
+                            },
+                        };
+                    },
+                });
+            return service;
+        },
+    };
+}
+//# sourceMappingURL=editor.js.map

package/dist/editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.js","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAyB1C,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,EAAE,EAAE,YAAY;QAChB,MAAM,CAAC,KAAqB;YAC1B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACzD,KAAK,MAAM,OAAO,IAAI,CAAC,UAAU,EAAE,OAAO,CAAU;gBAClD,KAAK,CAAC,YAAY,CAAC;oBACjB,EAAE,EAAE,aAAa,OAAO,EAAE;oBAC1B,SAAS,EAAE,aAAa,OAAO,EAAE;oBACjC,KAAK,EAAE,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB;oBAC/D,GAAG,EAAE,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;oBAC7C,IAAI,EAAE,4EAA4E;oBAClF,QAAQ,CAAC,OAAO;wBACd,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;wBAC9B,IAAI,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,EACpB,QAAQ,GAAG,KAAK,CAAC;wBACnB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;wBACjC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CACtB,IAAI,aAAa,CAAC,OAAO,EAAE;4BACzB,OAAO;4BACP,GAAG,MAAM,CAAC,KAAK;4BACf,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CACnB,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC;4BACtE,SAAS,CAAC,MAAM;gCACd,QAAQ,GAAG,MAAM,CAAC;gCAClB,OAAO,EAAE,CAAC;gCACV,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;4BAClD,CAAC;4BACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;4BACzC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gCACjB,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;gCACrC,OAAO,CAAC,IAAI,EAAE,CAAC;4BACjB,CAAC;4BACD,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE;yBAC7B,CAAC,CACH,CAAC;wBACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;wBAC1C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;4BACvB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;wBAC5B,CAAC,CAAC,CAAC;wBACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;wBACpB,OAAO;4BACL,OAAO,KAAI,CAAC;4BACZ,GAAG,CAAC,KAAoB;gCACtB,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,QAAQ;oCAAE,OAAO,KAAK,CAAC;gCAClF,IAAI,CAAC,MAAM,EAAE,CAAC;gCACd,OAAO,IAAI,CAAC;4BACd,CAAC;yBACF,CAAC;oBACJ,CAAC;iBACF,CAAC,CAAC;YACL,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Connectors } from './connectors.js';
+export { isConnector } from './metadata.js';
+export { connectorPort, routeConnector } from './routing.js';
+export type { ConnectorTarget, ConnectorAnchor, ConnectorSide, ConnectorEndpoint, ConnectorRouting, ConnectorOptions, ConnectorState, ConnectorPort, ConnectorRoute, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Connectors } from './connectors.js';
+export { isConnector } from './metadata.js';
+export { connectorPort, routeConnector } from './routing.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/metadata.d.ts

@@ -0,0 +1,8 @@
+import { Path } from '@rasamjs/core';
+import type { AnyNode } from '@rasamjs/core';
+import type { ConnectorState } from './types.js';
+export declare const endpointAttribute: (end: 'start' | 'end') => string;
+export declare function isConnector(node: AnyNode): node is Path;
+export declare function readConnector(path: Path): ConnectorState;
+export declare function writeConnector(path: Path, state: Omit<ConnectorState, 'path'>): void;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,iBAAiB,QAAS,OAAO,GAAG,KAAK,WAAkC,CAAC;AAYzF,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,IAAI,CAEvD;AACD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,CAsBxD;AACD,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,IAAI,CAcpF"}