@grafloria/element 0.1.0

package/src/lib/diagram-kit/card.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * Card building — the ONE source of truth for the ER/UML card HTML trees, the
+ * layout constants and the size math.
+ *
+ * Both the builders (er.ts / uml.ts, which emit the initial render() spec) and
+ * the live editor (update.ts, which regenerates a card after an edit) call
+ * these. Keeping them here is what stops the two paths from drifting: an edited
+ * card is byte-for-byte the card the builder would have produced for the same
+ * data, so a re-rendered table looks identical to a freshly built one.
+ *
+ * `editable` threads through: when true the card grows the in-canvas editing
+ * chrome (a per-row delete control and a trailing "add" affordance). That
+ * chrome is DELIBERATELY not a `.axk-row`/`.axk-member` — the row-selection and
+ * port-reconciliation code count those, and the affordance is neither a column
+ * nor a member.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UML_PAD = exports.UML_STEREO_H = exports.UML_NAME_H = exports.UML_LINE_H = exports.ER_ADD_H = exports.ER_BORDER_SLACK = exports.ER_HEAD_H = exports.ER_ROW_H = void 0;
+exports.erRowCenterY = erRowCenterY;
+exports.rowIndexFromY = rowIndexFromY;
+exports.entityCardContent = entityCardContent;
+exports.entityAutoHeight = entityAutoHeight;
+exports.classCardContent = classCardContent;
+exports.classAutoHeight = classAutoHeight;
+exports.matchColumns = matchColumns;
+/** Row height / header height of the entity card — sizing is derived from these. */
+exports.ER_ROW_H = 25;
+exports.ER_HEAD_H = 28;
+/**
+ * Auto-height slack: the html wrapper's padding (8px) + the card's 1px
+ * top/bottom borders + the head rendering slightly under ER_HEAD_H. Measured
+ * live — with less, an auto-sized card overflows a few px, and the wheel
+ * delegation would steal that much scroll on EVERY card.
+ */
+exports.ER_BORDER_SLACK = 9;
+/** The editable "add column" affordance row's height (excluded from row math). */
+exports.ER_ADD_H = 26;
+/** UML compartment metrics (mirrors the pre-kit demos, measured live). */
+exports.UML_LINE_H = 19;
+exports.UML_NAME_H = 30;
+exports.UML_STEREO_H = 14;
+exports.UML_PAD = 8;
+/** Node-local y of a row's centre (the +1 offsets past the card's top border). */
+function erRowCenterY(rowIndex) {
+    return exports.ER_HEAD_H + rowIndex * exports.ER_ROW_H + exports.ER_ROW_H / 2 + 1;
+}
+/** Inverse of {@link erRowCenterY}: which column row a pinned port sits on. */
+function rowIndexFromY(y) {
+    return Math.round((y - exports.ER_HEAD_H - exports.ER_ROW_H / 2 - 1) / exports.ER_ROW_H);
+}
+/**
+ * The `.axk-entity` content tree — the SAME tree er.ts ships and update.ts
+ * regenerates. `editable` adds the delete control per row and the trailing add
+ * affordance.
+ */
+function entityCardContent(entity, editable = false) {
+    var _a;
+    const rows = entity.columns.map((c) => {
+        var _a;
+        const children = [
+            { tag: 'span', className: 'axk-key' + (c.fk ? ' axk-fk' : ''), text: c.pk ? 'PK' : c.fk ? 'FK' : '' },
+            { tag: 'span', className: 'axk-col', text: c.name },
+            { tag: 'span', className: 'axk-ty', text: (_a = c.type) !== null && _a !== void 0 ? _a : '' },
+        ];
+        // The delete control is a real child so it survives re-renders (the card is
+        // regenerated wholesale on every edit) and hover-reveals via CSS only.
+        if (editable)
+            children.push({ tag: 'span', className: 'axk-col-del', text: '×' });
+        return { tag: 'div', className: 'axk-row' + (c.pk ? ' axk-pk' : ''), children };
+    });
+    const body = {
+        // Scroll is OPT-IN via an explicit height: an auto-sized card fits by
+        // construction and must never trap the wheel, not even by a pixel.
+        tag: 'div',
+        className: entity.height != null ? 'axk-entity-body axk-scroll' : 'axk-entity-body',
+        children: rows,
+    };
+    const children = [
+        { tag: 'div', className: 'axk-entity-head', text: (_a = entity.name) !== null && _a !== void 0 ? _a : entity.id },
+        body,
+    ];
+    // The affordance sits OUTSIDE the (scrollable) body so it is always reachable.
+    if (editable)
+        children.push({ tag: 'div', className: 'axk-entity-add', text: '＋ add column' });
+    return { tag: 'div', className: 'axk-entity', children };
+}
+/** Card height for an entity — explicit height wins, else derived from columns. */
+function entityAutoHeight(entity, editable = false) {
+    if (entity.height != null)
+        return entity.height;
+    return exports.ER_HEAD_H + entity.columns.length * exports.ER_ROW_H + exports.ER_BORDER_SLACK + (editable ? exports.ER_ADD_H : 0);
+}
+/**
+ * The `.axk-uml` content tree. `editable` adds a delete control per member and
+ * a trailing add affordance in each compartment.
+ */
+function classCardContent(cls, editable = false) {
+    var _a, _b, _c;
+    const attrs = (_a = cls.attributes) !== null && _a !== void 0 ? _a : [];
+    const methods = (_b = cls.methods) !== null && _b !== void 0 ? _b : [];
+    const italic = cls.abstract || cls.stereotype === 'abstract' || cls.stereotype === 'interface';
+    // Non-editable output stays BYTE-IDENTICAL to the pre-editing builder (a
+    // member is a text div); editable additions are purely additive.
+    const member = (text) => editable
+        ? {
+            tag: 'div',
+            className: 'axk-member',
+            children: [
+                { tag: 'span', className: 'axk-mtext', text },
+                { tag: 'span', className: 'axk-col-del', text: '×' },
+            ],
+        }
+        : { tag: 'div', className: 'axk-member', text };
+    const compartment = (members, section) => {
+        const children = members.map(member);
+        if (editable) {
+            children.push({
+                tag: 'div',
+                className: 'axk-uml-add',
+                text: section === 'attributes' ? '＋ attribute' : '＋ method',
+            });
+        }
+        return {
+            tag: 'div',
+            className: 'axk-uml-comp' + (members.length ? '' : ' axk-empty'),
+            children,
+        };
+    };
+    const name = {
+        tag: 'div',
+        className: 'axk-uml-name' + (italic ? ' axk-abstract' : ''),
+        children: [
+            ...(cls.stereotype ? [{ tag: 'span', className: 'axk-uml-stereo', text: `«${cls.stereotype}»` }] : []),
+            { tag: 'span', text: (_c = cls.name) !== null && _c !== void 0 ? _c : cls.id },
+        ],
+    };
+    return {
+        tag: 'div',
+        className: 'axk-uml',
+        children: [
+            name,
+            {
+                tag: 'div',
+                className: cls.height != null ? 'axk-uml-body axk-scroll' : 'axk-uml-body',
+                children: [compartment(attrs, 'attributes'), compartment(methods, 'methods')],
+            },
+        ],
+    };
+}
+/** Card height for a class — explicit height wins, else derived from members. */
+function classAutoHeight(cls, editable = false) {
+    var _a, _b;
+    if (cls.height != null)
+        return cls.height;
+    const attrs = (_a = cls.attributes) !== null && _a !== void 0 ? _a : [];
+    const methods = (_b = cls.methods) !== null && _b !== void 0 ? _b : [];
+    const addRows = editable ? 2 : 0; // one "add" affordance per compartment
+    return (exports.UML_NAME_H +
+        (cls.stereotype ? exports.UML_STEREO_H : 0) +
+        (attrs.length + methods.length + addRows) * exports.UML_LINE_H +
+        exports.UML_PAD * 2 +
+        12);
+}
+/**
+ * Match old columns to new columns for port reconciliation. Returns a map from
+ * OLD index → NEW index; an old index absent from the map is a REMOVED column
+ * (its pinned ports and their edges are dropped).
+ *
+ * Three passes, most-certain first, so a single edit is always read the way a
+ * human means it:
+ *   1. object identity — reorder / add / remove that preserved references;
+ *   2. name — a retype (same name, new object) or a rebuilt array;
+ *   3. positional remainder — the leftovers matched in order, which is exactly
+ *      what a rename is (one old + one new in the same slot). Without pass 3 a
+ *      rename reads as remove+add and the edge is severed.
+ */
+function matchColumns(oldCols, newCols) {
+    const out = new Map();
+    const usedNew = new Set();
+    const matchedOld = new Set();
+    const claim = (oldIdx, newIdx) => {
+        out.set(oldIdx, newIdx);
+        usedNew.add(newIdx);
+        matchedOld.add(oldIdx);
+    };
+    // Pass 1: object identity.
+    oldCols.forEach((oc, oi) => {
+        const ni = newCols.indexOf(oc);
+        if (ni !== -1 && !usedNew.has(ni))
+            claim(oi, ni);
+    });
+    // Pass 2: by name, among the unmatched.
+    oldCols.forEach((oc, oi) => {
+        if (matchedOld.has(oi))
+            return;
+        const ni = newCols.findIndex((nc, i) => !usedNew.has(i) && nc.name === oc.name);
+        if (ni !== -1)
+            claim(oi, ni);
+    });
+    // Pass 3: positional remainder (rename / retype-and-rename).
+    const remOld = oldCols.map((_, i) => i).filter((i) => !matchedOld.has(i));
+    const remNew = newCols.map((_, i) => i).filter((i) => !usedNew.has(i));
+    const n = Math.min(remOld.length, remNew.length);
+    for (let k = 0; k < n; k++)
+        claim(remOld[k], remNew[k]);
+    return out;
+}
+//# sourceMappingURL=card.js.map

package/src/lib/diagram-kit/card.js.map

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

package/src/lib/diagram-kit/editing.d.ts

@@ -0,0 +1,54 @@
+/**
+ * In-canvas editing chrome (P2 title rename + P4 column/member editing).
+ *
+ * Bound once per container by a kit's `finalize(api)` when `editable: true`.
+ * It turns the editing affordances the card already draws (`card.ts` grows them
+ * when editable) into gestures:
+ *
+ *   - double-click the header (`.axk-entity-head` / `.axk-uml-name`) → rename
+ *     the table / class;
+ *   - double-click a column name (`.axk-col`) or a member (`.axk-member`) →
+ *     rename it in place;
+ *   - click the "＋ add column" / "＋ attribute" / "＋ method" affordance → add
+ *     one, then inline-edit its name;
+ *   - click a row's "×" delete control → remove that column / member.
+ *
+ * Every mutation goes through {@link updateEntity} / {@link updateClass} — so it
+ * is ONE undoable step and the card + ports + edges stay consistent.
+ *
+ * The inline editor is a real `<input>` mounted in the renderer's WORLD layer
+ * via `createViewportPortal`, so it pans and zooms WITH the card. When there is
+ * no world layer (a bare jsdom mount, or a host that swapped the renderer) it
+ * falls back to an absolutely-positioned input in the container — the edit
+ * still commits, it just doesn't track the camera.
+ *
+ * Control clicks are claimed in the CAPTURE phase (`stopPropagation`) so the
+ * row-selection handler and the binder's node/​waypoint double-click never also
+ * fire for the same gesture.
+ */
+interface EditApi {
+    container: HTMLElement;
+    viewport?: {
+        getZoom?: () => number;
+        clientToWorld?: (x: number, y: number, rect: DOMRect) => {
+            x: number;
+            y: number;
+        };
+    };
+    getModel(): {
+        getNode(id: string): {
+            getMetadata(key: string): unknown;
+        } | undefined;
+    };
+    getEngine?: () => unknown;
+    renderNow?: () => void;
+}
+export interface CardEditingHandle {
+    dispose(): void;
+}
+/**
+ * Wire the editing gestures onto a kit container. Idempotent per container
+ * (a re-bind disposes the previous one), matching `bindRowInteractions`.
+ */
+export declare function bindCardEditing(api: EditApi): CardEditingHandle;
+export {};

package/src/lib/diagram-kit/editing.js

@@ -0,0 +1,289 @@
+"use strict";
+/**
+ * In-canvas editing chrome (P2 title rename + P4 column/member editing).
+ *
+ * Bound once per container by a kit's `finalize(api)` when `editable: true`.
+ * It turns the editing affordances the card already draws (`card.ts` grows them
+ * when editable) into gestures:
+ *
+ *   - double-click the header (`.axk-entity-head` / `.axk-uml-name`) → rename
+ *     the table / class;
+ *   - double-click a column name (`.axk-col`) or a member (`.axk-member`) →
+ *     rename it in place;
+ *   - click the "＋ add column" / "＋ attribute" / "＋ method" affordance → add
+ *     one, then inline-edit its name;
+ *   - click a row's "×" delete control → remove that column / member.
+ *
+ * Every mutation goes through {@link updateEntity} / {@link updateClass} — so it
+ * is ONE undoable step and the card + ports + edges stay consistent.
+ *
+ * The inline editor is a real `<input>` mounted in the renderer's WORLD layer
+ * via `createViewportPortal`, so it pans and zooms WITH the card. When there is
+ * no world layer (a bare jsdom mount, or a host that swapped the renderer) it
+ * falls back to an absolutely-positioned input in the container — the edit
+ * still commits, it just doesn't track the camera.
+ *
+ * Control clicks are claimed in the CAPTURE phase (`stopPropagation`) so the
+ * row-selection handler and the binder's node/​waypoint double-click never also
+ * fire for the same gesture.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindCardEditing = bindCardEditing;
+const renderer_1 = require("@grafloria/renderer");
+const update_1 = require("./update");
+const bindings = new WeakMap();
+const ROW_SELECTOR = '.axk-row, .axk-member';
+/** Resolve the node id + the clicked row's global index (among selectable rows). */
+function locate(el) {
+    const group = el.closest('[data-node-id]');
+    if (!group)
+        return null;
+    const nodeId = group.getAttribute('data-node-id');
+    if (!nodeId)
+        return null;
+    const rowEl = el.closest(ROW_SELECTOR);
+    const rows = Array.from(group.querySelectorAll(ROW_SELECTOR));
+    const rowIndex = rowEl ? rows.indexOf(rowEl) : -1;
+    return { nodeId, rowIndex, group };
+}
+const kitEntity = (api, nodeId) => { var _a; return (_a = api.getModel().getNode(nodeId)) === null || _a === void 0 ? void 0 : _a.getMetadata('kitEntity'); };
+const kitClass = (api, nodeId) => { var _a; return (_a = api.getModel().getNode(nodeId)) === null || _a === void 0 ? void 0 : _a.getMetadata('kitClass'); };
+/** UML: split a global member index into its compartment + local index. */
+function umlSection(cls, rowIndex) {
+    var _a;
+    const attrs = (_a = cls.attributes) !== null && _a !== void 0 ? _a : [];
+    return rowIndex < attrs.length
+        ? { section: 'attributes', local: rowIndex }
+        : { section: 'methods', local: rowIndex - attrs.length };
+}
+/**
+ * Mount a focused `<input>` over `targetEl`, prefilled with `value`. Commits on
+ * Enter/blur, cancels on Escape. Returns the input (already in the DOM).
+ */
+function openInlineEditor(api, targetEl, value, onCommit) {
+    var _a, _b, _c, _d;
+    const container = api.container;
+    const doc = container.ownerDocument;
+    const input = doc.createElement('input');
+    input.className = 'axk-edit-input';
+    input.value = value;
+    input.spellcheck = false;
+    input.setAttribute('autocomplete', 'off');
+    const rect = targetEl.getBoundingClientRect();
+    const zoom = (_c = (_b = (_a = api.viewport) === null || _a === void 0 ? void 0 : _a.getZoom) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : 1;
+    const layer = container.querySelector('.grafloria-html-layer');
+    let portal = null;
+    if (layer && ((_d = api.viewport) === null || _d === void 0 ? void 0 : _d.clientToWorld) && rect.width > 0) {
+        // World-space: place the input at the target's world position; the layer's
+        // camera transform scales it, so its px width is divided by the zoom.
+        const world = api.viewport.clientToWorld(rect.left, rect.top, container.getBoundingClientRect());
+        input.style.cssText = `width:${rect.width / zoom}px;height:${rect.height / zoom}px;`;
+        try {
+            portal = (0, renderer_1.createViewportPortal)(layer, { x: world.x, y: world.y, className: 'axk-edit-portal' });
+            portal.element.appendChild(input);
+        }
+        catch (_e) {
+            portal = null;
+        }
+    }
+    if (!portal) {
+        // Fallback: absolute in the container (jsdom / no world layer).
+        const host = container.getBoundingClientRect();
+        input.style.cssText =
+            `position:absolute;left:${rect.left - host.left}px;top:${rect.top - host.top}px;` +
+                (rect.width ? `width:${rect.width}px;height:${rect.height}px;` : 'min-width:120px;');
+        container.appendChild(input);
+    }
+    let done = false;
+    const cleanup = () => {
+        if (portal)
+            portal.dispose();
+        else
+            input.remove();
+    };
+    const commit = () => {
+        if (done)
+            return;
+        done = true;
+        const next = input.value.trim();
+        cleanup();
+        if (next.length)
+            onCommit(next);
+    };
+    const cancel = () => {
+        if (done)
+            return;
+        done = true;
+        cleanup();
+    };
+    input.addEventListener('keydown', (e) => {
+        if (e.key === 'Enter') {
+            e.preventDefault();
+            commit();
+        }
+        else if (e.key === 'Escape') {
+            e.preventDefault();
+            cancel();
+        }
+        e.stopPropagation();
+    });
+    input.addEventListener('blur', commit);
+    // Don't let a click INSIDE the input bubble to the canvas (deselect / pan).
+    input.addEventListener('mousedown', (e) => e.stopPropagation());
+    // Focus after mount so select() works.
+    setTimeout(() => {
+        input.focus();
+        input.select();
+    }, 0);
+    return input;
+}
+/** Begin renaming whatever the clicked row/header targets. */
+function beginRename(api, target) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const loc = locate(target);
+    if (!loc)
+        return;
+    const { nodeId, rowIndex } = loc;
+    // Title (ER header / UML name).
+    if (target.closest('.axk-entity-head')) {
+        const ent = kitEntity(api, nodeId);
+        openInlineEditor(api, target.closest('.axk-entity-head'), (_a = ent === null || ent === void 0 ? void 0 : ent.name) !== null && _a !== void 0 ? _a : nodeId, (name) => void (0, update_1.updateEntity)(api, nodeId, { name }));
+        return;
+    }
+    if (target.closest('.axk-uml-name')) {
+        const cls = kitClass(api, nodeId);
+        openInlineEditor(api, target.closest('.axk-uml-name'), (_b = cls === null || cls === void 0 ? void 0 : cls.name) !== null && _b !== void 0 ? _b : nodeId, (name) => void (0, update_1.updateClass)(api, nodeId, { name }));
+        return;
+    }
+    // ER column rename.
+    const colEl = target.closest('.axk-col');
+    if (colEl && rowIndex >= 0) {
+        const ent = kitEntity(api, nodeId);
+        if (!ent)
+            return;
+        openInlineEditor(api, colEl, (_d = (_c = ent.columns[rowIndex]) === null || _c === void 0 ? void 0 : _c.name) !== null && _d !== void 0 ? _d : '', (name) => void (0, update_1.updateEntity)(api, nodeId, { columns: (0, update_1.renameColumnAt)(ent.columns, rowIndex, name) }));
+        return;
+    }
+    // UML member rename.
+    const memberEl = target.closest('.axk-member');
+    if (memberEl && rowIndex >= 0) {
+        const cls = kitClass(api, nodeId);
+        if (!cls)
+            return;
+        const { section, local } = umlSection(cls, rowIndex);
+        const list = ((_e = cls[section]) !== null && _e !== void 0 ? _e : []).slice();
+        openInlineEditor(api, (_f = memberEl.querySelector('.axk-mtext')) !== null && _f !== void 0 ? _f : memberEl, (_g = list[local]) !== null && _g !== void 0 ? _g : '', (next) => {
+            list[local] = next;
+            void (0, update_1.updateClass)(api, nodeId, { [section]: list });
+        });
+    }
+}
+/** Add a column / member (then inline-edit the new one). Returns true if handled. */
+function handleAdd(api, target) {
+    var _a;
+    const addEr = target.closest('.axk-entity-add');
+    if (addEr) {
+        const loc = locate(addEr);
+        if (!loc)
+            return true;
+        const ent = kitEntity(api, loc.nodeId);
+        if (!ent)
+            return true;
+        const columns = (0, update_1.addColumnAt)(ent.columns, { name: 'new_column', type: '' });
+        void (0, update_1.updateEntity)(api, loc.nodeId, { columns }).then(() => {
+            const newRow = api.container.querySelectorAll(`[data-node-id="${cssEscape(loc.nodeId)}"] .axk-row`)[columns.length - 1];
+            const col = newRow === null || newRow === void 0 ? void 0 : newRow.querySelector('.axk-col');
+            if (col)
+                beginRename(api, col);
+        });
+        return true;
+    }
+    const addUml = target.closest('.axk-uml-add');
+    if (addUml) {
+        const loc = locate(addUml);
+        if (!loc)
+            return true;
+        const cls = kitClass(api, loc.nodeId);
+        if (!cls)
+            return true;
+        const comps = Array.from(loc.group.querySelectorAll('.axk-uml-comp'));
+        const section = comps.indexOf(addUml.closest('.axk-uml-comp')) === 0 ? 'attributes' : 'methods';
+        const list = [...((_a = cls[section]) !== null && _a !== void 0 ? _a : []), section === 'attributes' ? '+ field: type' : '+ method(): void'];
+        void (0, update_1.updateClass)(api, loc.nodeId, { [section]: list });
+        return true;
+    }
+    return false;
+}
+/** Delete the column / member whose "×" control was clicked. Returns true if handled. */
+function handleDelete(api, target) {
+    var _a;
+    const del = target.closest('.axk-col-del');
+    if (!del)
+        return false;
+    const loc = locate(del);
+    if (!loc || loc.rowIndex < 0)
+        return true;
+    const ent = kitEntity(api, loc.nodeId);
+    if (ent) {
+        void (0, update_1.updateEntity)(api, loc.nodeId, { columns: (0, update_1.removeColumnAt)(ent.columns, loc.rowIndex) });
+        return true;
+    }
+    const cls = kitClass(api, loc.nodeId);
+    if (cls) {
+        const { section, local } = umlSection(cls, loc.rowIndex);
+        const list = ((_a = cls[section]) !== null && _a !== void 0 ? _a : []).slice();
+        list.splice(local, 1);
+        void (0, update_1.updateClass)(api, loc.nodeId, { [section]: list });
+    }
+    return true;
+}
+function cssEscape(id) {
+    return typeof CSS !== 'undefined' && CSS.escape ? CSS.escape(id) : id.replace(/"/g, '\\"');
+}
+/**
+ * Wire the editing gestures onto a kit container. Idempotent per container
+ * (a re-bind disposes the previous one), matching `bindRowInteractions`.
+ */
+function bindCardEditing(api) {
+    var _a;
+    const container = api.container;
+    (_a = bindings.get(container)) === null || _a === void 0 ? void 0 : _a.dispose();
+    const onClickCapture = (event) => {
+        const target = event.target instanceof Element ? event.target : null;
+        if (!target)
+            return;
+        // Claim control clicks BEFORE row-selection / canvas handlers see them.
+        if (handleDelete(api, target) || handleAdd(api, target)) {
+            event.preventDefault();
+            event.stopPropagation();
+        }
+    };
+    const onDblClickCapture = (event) => {
+        const target = event.target instanceof Element ? event.target : null;
+        if (!target)
+            return;
+        if (target.closest('.axk-edit-input'))
+            return; // don't re-open over our own input
+        if (target.closest('.axk-entity-head') ||
+            target.closest('.axk-uml-name') ||
+            target.closest('.axk-col') ||
+            target.closest('.axk-member')) {
+            event.preventDefault();
+            event.stopPropagation();
+            beginRename(api, target);
+        }
+    };
+    container.addEventListener('click', onClickCapture, true);
+    container.addEventListener('dblclick', onDblClickCapture, true);
+    const handle = {
+        dispose() {
+            container.removeEventListener('click', onClickCapture, true);
+            container.removeEventListener('dblclick', onDblClickCapture, true);
+            if (bindings.get(container) === handle)
+                bindings.delete(container);
+        },
+    };
+    bindings.set(container, handle);
+    return handle;
+}
+//# sourceMappingURL=editing.js.map

package/src/lib/diagram-kit/editing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing.js","sourceRoot":"","sources":["../../../../../../libs/element/src/lib/diagram-kit/editing.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;AA4OH,0CA0CC;AApRD,kDAA2D;AAC3D,qCAAkG;AAkBlG,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAkC,CAAC;AAE/D,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAE7C,oFAAoF;AACpF,SAAS,MAAM,CAAC,EAAW;IACzB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,GAAY,EAAE,MAAc,EAA4B,EAAE,WAC3E,OAAA,MAAA,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,0CAAE,WAAW,CAAC,WAAW,CAA6B,CAAA,EAAA,CAAC;AACvF,MAAM,QAAQ,GAAG,CAAC,GAAY,EAAE,MAAc,EAA4B,EAAE,WAC1E,OAAA,MAAA,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,0CAAE,WAAW,CAAC,UAAU,CAA6B,CAAA,EAAA,CAAC;AAEtF,2EAA2E;AAC3E,SAAS,UAAU,CAAC,GAAiB,EAAE,QAAgB;;IACrD,MAAM,KAAK,GAAG,MAAA,GAAG,CAAC,UAAU,mCAAI,EAAE,CAAC;IACnC,OAAO,QAAQ,GAAG,KAAK,CAAC,MAAM;QAC5B,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE;QAC5C,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAY,EAAE,QAAiB,EAAE,KAAa,EAAE,QAAgC;;IACxG,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAChC,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,CAAC;IACpC,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,KAAK,CAAC,SAAS,GAAG,gBAAgB,CAAC;IACnC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;IACzB,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAE1C,MAAM,IAAI,GAAG,QAAQ,CAAC,qBAAqB,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAA,MAAA,MAAA,GAAG,CAAC,QAAQ,0CAAE,OAAO,kDAAI,mCAAI,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,uBAAuB,CAAuB,CAAC;IAErF,IAAI,MAAM,GAAqD,IAAI,CAAC;IACpE,IAAI,KAAK,KAAI,MAAA,GAAG,CAAC,QAAQ,0CAAE,aAAa,CAAA,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3D,2EAA2E;QAC3E,sEAAsE;QACtE,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,qBAAqB,EAAE,CAAC,CAAC;QACjG,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAC;QACrF,IAAI,CAAC;YACH,MAAM,GAAG,IAAA,+BAAoB,EAAC,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAC/F,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAAC,WAAM,CAAC;YACP,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,gEAAgE;QAChE,MAAM,IAAI,GAAG,SAAS,CAAC,qBAAqB,EAAE,CAAC;QAC/C,KAAK,CAAC,KAAK,CAAC,OAAO;YACjB,0BAA0B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,KAAK;gBACjF,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,KAAK,aAAa,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QACvF,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,MAAM;YAAE,MAAM,CAAC,OAAO,EAAE,CAAC;;YACxB,KAAK,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,GAAG,IAAI,CAAC;QACZ,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,MAAM;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,IAAI;YAAE,OAAO;QACjB,IAAI,GAAG,IAAI,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;IAEF,KAAK,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE;QACtC,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,EAAE,CAAC;YACtB,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,MAAM,EAAE,CAAC;QACX,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC9B,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,MAAM,EAAE,CAAC;QACX,CAAC;QACD,CAAC,CAAC,eAAe,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;IACH,KAAK,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,4EAA4E;IAC5E,KAAK,CAAC,gBAAgB,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;IAEhE,uCAAuC;IACvC,UAAU,CAAC,GAAG,EAAE;QACd,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,KAAK,CAAC,MAAM,EAAE,CAAC;IACjB,CAAC,EAAE,CAAC,CAAC,CAAC;IACN,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8DAA8D;AAC9D,SAAS,WAAW,CAAC,GAAY,EAAE,MAAe;;IAChD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;IAEjC,gCAAgC;IAChC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAE,EAAE,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,IAAI,mCAAI,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACvF,KAAK,IAAA,qBAAY,EAAC,GAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAClD,CAAC;QACF,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAE,EAAE,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,IAAI,mCAAI,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CACpF,KAAK,IAAA,oBAAW,EAAC,GAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CACjD,CAAC;QACF,OAAO;IACT,CAAC;IAED,oBAAoB;IACpB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,KAAK,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,gBAAgB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAA,MAAA,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,0CAAE,IAAI,mCAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CACvE,KAAK,IAAA,qBAAY,EAAC,GAAY,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAA,uBAAc,EAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,CAClG,CAAC;QACF,OAAO;IACT,CAAC;IAED,qBAAqB;IACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/C,IAAI,QAAQ,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,CAAC,MAAA,GAAG,CAAC,OAAO,CAAC,mCAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC1C,gBAAgB,CAAC,GAAG,EAAE,MAAA,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,mCAAI,QAAQ,EAAE,MAAA,IAAI,CAAC,KAAK,CAAC,mCAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE;YAClG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;YACnB,KAAK,IAAA,oBAAW,EAAC,GAAY,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,SAAS,SAAS,CAAC,GAAY,EAAE,MAAe;;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,OAAO,GAAG,IAAA,oBAAW,EAAC,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3E,KAAK,IAAA,qBAAY,EAAC,GAAY,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YACjE,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,kBAAkB,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACxH,MAAM,GAAG,GAAG,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,aAAa,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,GAAG;gBAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9C,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC;QACtE,MAAM,OAAO,GAA6B,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3H,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAA,GAAG,CAAC,OAAO,CAAC,mCAAI,EAAE,CAAC,EAAE,OAAO,KAAK,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QACxG,KAAK,IAAA,oBAAW,EAAC,GAAY,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yFAAyF;AACzF,SAAS,YAAY,CAAC,GAAY,EAAE,MAAe;;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,GAAG,EAAE,CAAC;QACR,KAAK,IAAA,qBAAY,EAAC,GAAY,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAA,uBAAc,EAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACpG,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,CAAC,MAAA,GAAG,CAAC,OAAO,CAAC,mCAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtB,KAAK,IAAA,oBAAW,EAAC,GAAY,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,SAAS,CAAC,EAAU;IAC3B,OAAO,OAAO,GAAG,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,GAAY;;IAC1C,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC;IAChC,MAAA,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,0CAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,cAAc,GAAG,CAAC,KAAiB,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACrE,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,wEAAwE;QACxE,IAAI,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;YACxD,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,iBAAiB,GAAG,CAAC,KAAiB,EAAE,EAAE;QAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,YAAY,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;QACrE,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAAE,OAAO,CAAC,mCAAmC;QAClF,IACE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC;YAClC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC;YAC/B,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;YAC1B,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAC7B,CAAC;YACD,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,KAAK,CAAC,eAAe,EAAE,CAAC;YACxB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC;IAEF,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IAC1D,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAEhE,MAAM,MAAM,GAAsB;QAChC,OAAO;YACL,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;YAC7D,SAAS,CAAC,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;YACnE,IAAI,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,MAAM;gBAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrE,CAAC;KACF,CAAC;IACF,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/src/lib/diagram-kit/er.d.ts

@@ -0,0 +1,73 @@
+import { erRowCenterY, ER_ROW_H, ER_HEAD_H } from './card';
+export { erRowCenterY, ER_ROW_H, ER_HEAD_H };
+export interface ErColumn {
+    name: string;
+    type?: string;
+    pk?: boolean;
+    fk?: boolean;
+}
+export interface ErEntitySpec {
+    id: string;
+    /** Header text. Defaults to the id. */
+    name?: string;
+    columns: ErColumn[];
+    position?: {
+        x: number;
+        y: number;
+    };
+    width?: number;
+    /**
+     * Fixed card height. When smaller than the computed height the column list
+     * SCROLLS (the kit body is overflow-y:auto, and the canvas yields the wheel
+     * to it). Omit for auto-height from the column count.
+     */
+    height?: number;
+}
+export type ErCardinality = 'one-to-many' | 'one-to-one' | 'many-to-many' | 'one-to-zero-or-many' | 'one-to-one-or-many';
+export type ErSide = 'left' | 'right' | 'top' | 'bottom';
+export interface ErRelationshipSpec {
+    /** Entity id, or `ENTITY.column` to attach at that column's row. */
+    from: string;
+    to: string;
+    label?: string;
+    /** Named cardinality (default one-to-many) or explicit marker types. */
+    cardinality?: ErCardinality | {
+        tail: string;
+        head: string;
+    };
+    fromSide?: ErSide;
+    toSide?: ErSide;
+    color?: string;
+    id?: string;
+}
+export interface ErDiagramOptions {
+    entities: ErEntitySpec[];
+    relationships?: ErRelationshipSpec[];
+    /**
+     * Rows are selectable by default: click a column to select it (painted with
+     * .axk-row-selected; axk:row-click / axk:row-select CustomEvents fire on the
+     * container). Set false to opt out.
+     */
+    rowSelection?: boolean;
+    /**
+     * In-canvas editing (opt-in, default false — read-only diagrams are
+     * unchanged). When true the card grows editing chrome: double-click the
+     * header to rename the table, double-click a column name to rename it, an
+     * "add column" affordance and a per-row delete control. Every change routes
+     * through {@link updateEntity} as ONE undoable step.
+     */
+    editable?: boolean;
+}
+/**
+ * Build a render() spec for an ER diagram.
+ *
+ * Entities become HTML table cards; relationships become orthogonal edges with
+ * crow's-foot cardinality. A `TABLE.column` end pins the edge to that row via
+ * an absolute-layout port (the FK→PK look). Two edges landing on the same
+ * column are automatically spread apart.
+ */
+export declare function erDiagram(options: ErDiagramOptions): {
+    nodes: Array<Record<string, unknown>>;
+    edges: Array<Record<string, unknown>>;
+    finalize: (api: unknown) => void;
+};