@rasamjs/connectors 0.0.0-stage → 0.2.0

package/API.md

@@ -0,0 +1,143 @@
+# 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? }`, `{ target, port }` 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.
+- `port`: the name of one of the target's ports, read structurally from its
+  `portDefinitions` (core's `PortDefinition`), such as a component's `ports()`. The end
+  sits exactly on the port and leaves along the port's side, transformed with the
+  target; a port without a side has no lead. An unknown port rejects the edit.
+- `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. `links(target, port?)`
+lists the connectors with an end on `target`, or only on its port named `port`, in
+the same 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.
+
+Only the connectors a change reaches are routed: those inside a changed subtree and
+those attached to a changed node, its descendants or its ancestors. Attachments are
+found through core's typed-reference index (`context.defs.consumersOf(target)`), so a
+move costs about the same with 10 or 1,000 connectors in the drawing. `links()` uses the
+same index. `bun run bench` measures 500 parts with 10 and 1,000 links
+(`reports/benchmark.json`; `--revision=<commit>` measures older connector sources).
+
+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. When a target leaves the
+drawing (removal, Delete, Cut, or removing a parent) or its port disappears (for
+example after a prop change), that end becomes a loose point where the path ends now,
+in the same operation and undo step, and the target is no longer referenced. Undo
+restores the attachment. Existing paths retain their last geometry while targets are
+unmappable.
+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, ports and free points live in `data-rasam-connector`
+(version 1). A port end is saved as `{ "port": "b" }`; readers without port support
+treat it as an automatic anchor on the same target. 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. Targets are links, not
+resources: exporting, copying or duplicating a connector never copies the shapes it
+joins into defs. Importing or pasting one whose target was left out turns that end into
+a loose point where it was, and ends whose targets were copied along rebind to the
+copies. A whole drawing retains visible shapes and attachments. Permanently destroying
+a target that a connector still references is refused, as for any referenced node;
+editor deletion uses reversible removal, which loosens those ends first. Connectors
+0.2.0 requires core 0.3.0 or a compatible newer 0.3.x release. Earlier connector
+versions do not provide the named-port or partial-copy behavior above.
+
+## 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. A target with
+ports, such as a component, shows its ports instead (`data-connector-port`). Press or
+release within twelve client pixels of a hint to choose it, a side anchor or a
+`{ target, port }` end; the chosen hint is filled (`data-connector-active`). Other
+body presses use auto anchors. Hit testing never reports groups, so a hit that
+`selectable` rejects, such as a component's rendered child, resolves to its nearest
+accepted ancestor. 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(options?)`, a structural extension
+factory. Its value is the current `Connectors` service. It registers
+`connector-straight` (C) and `connector-elbow` (Shift+C), or the `tools` you pass:
+`ConnectorEditingTool` entries `{ id, label, key, routing?, arrows?, hint? }`, for
+example `{ id: 'wire', label: 'Wire', key: 'W', routing: 'elbow', arrows: 'none' }`.
+Each tool has a matching command ID and 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,40 @@
+# Changelog
+
+## Unreleased
+
+## 0.2.0 — 2026-11-07
+
+- Ignore disposed derived children when finding affected links during component
+  hydration, so copying and pasting rendered components keeps its undo step.
+- Attach ends to named ports with `{ target, port }`, read structurally from
+  `portDefinitions` such as a component's `ports()`. Port ends sit exactly on the port,
+  lead out along its side and save as `{ "port": "b" }` in version 1 metadata.
+- When a target leaves the drawing or its port disappears, that end becomes a loose
+  point where it was, in the same undo step; undo reattaches it. Deleted targets are no
+  longer saved as hidden dependencies in `<defs>`.
+- Copying or pasting a connector without its targets pastes loose ends instead of
+  hidden copies of the targets.
+- Add `links(target, port?)`.
+- Route only the connectors a change reaches, found through core's reference index:
+  with 500 parts, moving one part 100 times takes 20 ms with 1,000 links (1,726 ms
+  before) and 15 ms with 10 links. Creating 1,000 links takes 1.1 s instead of 11.2 s.
+  Add `bun run bench`.
+- The tool shows a target's ports instead of its side hints, snaps to the nearest one
+  within twelve client pixels, fills the chosen hint, and resolves a rejected hit (such
+  as a component's rendered child) to its nearest accepted ancestor.
+- `connectorEditing({ tools })` registers custom tools, such as a Wire tool with elbow
+  routing and no arrows, in place of Connector and Elbow connector.
+- TypeScript: `ConnectorEndpoint` has a third, port variant. Narrow with
+  `'anchor' in endpoint` before reading `anchor`.
+
+## 0.1.0 — 2026-11-06
+
+- 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,55 @@
-# 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. Version 0.2.0 requires `@rasamjs/core@^0.3.0` for named ports,
+loose-end persistence and indexed routing. Source manifests stay private between releases.
+
+```sh
+npm install @rasamjs/core@^0.3.0 @rasamjs/connectors@^0.2.0
+```
+
+```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;
+```
+
+Ends can also attach to a component's named ports, `{ target: chip, port: 'p3' }`, and
+`connectors.links(chip)` lists the connectors on it. Deleting a target keeps its
+connectors, with a loose end where it was.
+
+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
+bun run --cwd packages/connectors bench
+```

package/RELEASING.md

@@ -0,0 +1,27 @@
+# Releasing connectors
+
+The source manifest stays private between releases. Version 0.2.0 is paired with
+core 0.3.0 and adds named ports, loose ends, partial-copy remapping and indexed routing.
+The owner authorized release preparation, publication and pushing on 2026-11-07.
+Existing approved size caps stay unchanged.
+
+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,38 @@
+import { Path } from '@rasamjs/core';
+import type { Svg } from '@rasamjs/core';
+import type { ConnectorOptions, ConnectorState, ConnectorTarget } 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;
+    /** Connectors with an end on `target`, or only on its port named `port`. */
+    links(target: ConnectorTarget, port?: string): readonly Path[];
+    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;
+    /** An end whose target left the drawing, or whose port is gone, stays where it is. */
+    private loosen;
+    /** Connectors in this drawing with an end on `target`, from core's reference index. */
+    private attached;
+    /**
+     * Connectors to route after a change: those inside a changed subtree, and those attached
+     * to a changed node, its descendants or its ancestors, since parents move, resize or
+     * reparent targets and a descendant changes a group's bounds. The work follows the
+     * size of the change, not the number of connectors.
+     */
+    private affected;
+    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;AAoBlD,OAAO,KAAK,EAEV,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AAkBpB,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,EAyBhC;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,4EAA4E;IAC5E,KAAK,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,IAAI,EAAE,CAiB7D;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;IA2BxB,sFAAsF;IACtF,OAAO,CAAC,MAAM;IAgBd,uFAAuF;IACvF,OAAO,CAAC,QAAQ;IAYhB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAehB,OAAO,CAAC,KAAK;IAuBb,OAAO,CAAC,IAAI;CAgBb"}

package/dist/connectors.js

@@ -0,0 +1,291 @@
+import { Path } from '@rasamjs/core';
+import { Guards } from '@rasamjs/core/advanced';
+import { beginChangeGroup, deriveChanges } from '@rasamjs/core/changes';
+import { endpointAttribute, isConnector, pathEnd, readConnector, unbound, writeConnector, } from './metadata.js';
+import { connectorPort, endpointCenter, findPort, 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.affected(event.nodes)) {
+                let state = readConnector(path);
+                const loose = this.loosen(state);
+                if (loose !== state || unbound.has(state.start) || unbound.has(state.end))
+                    writeConnector(path, (state = loose));
+                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);
+    }
+    /** Connectors with an end on `target`, or only on its port named `port`. */
+    links(target, port) {
+        this.assertLive();
+        if (port !== undefined && (typeof port !== 'string' || !port))
+            throw new TypeError('Port names must be non-empty strings');
+        return Object.freeze(this.attached(target)
+            .filter((path) => {
+            const { start, end } = readConnector(path);
+            return [start, end].some((endpoint) => 'target' in endpoint &&
+                endpoint.target === target &&
+                (port === undefined || ('port' in endpoint && endpoint.port === port)));
+        })
+            .sort((a, b) => (a.el.compareDocumentPosition(b.el) & 4 ? -1 : 1)));
+    }
+    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.el.contains(path.el))
+            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.el.contains(target.el) ||
+            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');
+        if (!('port' in endpoint))
+            return validateAnchor(endpoint.anchor ?? 'auto');
+        if ('anchor' in endpoint)
+            throw new TypeError('Endpoint needs either a port or an anchor');
+        if (typeof endpoint.port !== 'string' || !findPort(target, endpoint.port))
+            throw new TypeError(`Unknown connector port: ${String(endpoint.port)}`);
+    }
+    /** An end whose target left the drawing, or whose port is gone, stays where it is. */
+    loosen(state) {
+        const loose = (end) => {
+            const endpoint = state[end];
+            if ('point' in endpoint)
+                return endpoint;
+            const { target } = endpoint;
+            const gone = target.isDestroyed ||
+                !this.drawing.el.contains(target.el) ||
+                ('port' in endpoint && !findPort(target, endpoint.port));
+            const point = gone && pathEnd(state.path, end);
+            return point ? { point } : endpoint;
+        };
+        const start = loose('start'), end = loose('end');
+        return start === state.start && end === state.end ? state : { ...state, start, end };
+    }
+    /** Connectors in this drawing with an end on `target`, from core's reference index. */
+    attached(target) {
+        return this.drawing.context.defs
+            .consumersOf(target)
+            .filter((node) => isConnector(node) &&
+            this.drawing.el.contains(node.el) &&
+            ['start', 'end'].some((end) => node.references.get(endpointAttribute(end)) === target));
+    }
+    /**
+     * Connectors to route after a change: those inside a changed subtree, and those attached
+     * to a changed node, its descendants or its ancestors, since parents move, resize or
+     * reparent targets and a descendant changes a group's bounds. The work follows the
+     * size of the change, not the number of connectors.
+     */
+    affected(changed) {
+        const paths = new Set(), seen = new Set();
+        const visit = (node) => {
+            if (node.isDestroyed || seen.has(node))
+                return;
+            seen.add(node);
+            if (isConnector(node) && this.drawing.el.contains(node.el))
+                paths.add(node);
+            for (const path of this.attached(node))
+                paths.add(path);
+        };
+        for (const node of changed) {
+            node.descendants().forEach(visit);
+            for (let parent = node.parent; parent; parent = parent.parent)
+                visit(parent);
+        }
+        return paths;
+    }
+    route(state) {
+        const { path, start, end } = state;
+        for (const endpoint of [start, end])
+            if ('target' in endpoint) {
+                if (endpoint.target.isDestroyed || !this.drawing.el.contains(endpoint.target.el))
+                    return false;
+                if (endpoint.target.el.contains(path.el))
+                    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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"}