@grafloria/element 0.3.20 → 0.3.22

package/src/libs/renderer/src/instance/index.d.ts

@@ -1,5 +0,0 @@
-export * from './diagram-instance';
-export * from './render-scheduler';
-export * from './dom-event-binder';
-export * from './model-input';
-export * from './layers';

package/src/libs/renderer/src/instance/index.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-// The headless instance API: createDiagram() + the pieces it is built from.
-// `diagram-instance` re-exports createDiagram and its types (and documents how
-// the four wave-3 blockers were closed) — do NOT also `export * from
-// './create-diagram'` here, or every symbol would arrive twice.
-tslib_1.__exportStar(require("./diagram-instance"), exports);
-tslib_1.__exportStar(require("./render-scheduler"), exports);
-tslib_1.__exportStar(require("./dom-event-binder"), exports);
-tslib_1.__exportStar(require("./model-input"), exports);
-tslib_1.__exportStar(require("./layers"), exports);
-//# sourceMappingURL=index.js.map

package/src/libs/renderer/src/instance/layers.d.ts

@@ -1,31 +0,0 @@
-/**
- * The DOM skeleton of a mounted diagram — ONE definition, used by both halves.
- *
- * The server (`renderToStaticSVG`) emits this markup as a string; the client
- * (`createDiagram`) builds the identical structure with `createElement`, or
- * ADOPTS the server's when hydrating. Any divergence between the two — a class
- * name, a style declaration, an attribute — is a hydration mismatch, so both
- * paths read the constants from here rather than each spelling them out.
- *
- *   <div class="grafloria-diagram-root" data-grafloria-instance="grafloria-1">
- *     <div class="grafloria-svg-layer">   <svg …/>  </div>   ← the deterministic part
- *     <div class="grafloria-html-layer">  …custom nodes…  </div>  ← client-only
- *   </div>
- *
- * The HTML layer holds nodes that render as framework components (React
- * portals, slotted templates). It carries the camera as a CSS transform so it
- * stays registered with the SVG layer, and is `pointer-events: none` so it does
- * not eat clicks meant for the SVG underneath — each mounted node host turns
- * pointer events back on for itself.
- */
-export declare const ROOT_CLASS = "grafloria-diagram-root";
-export declare const SVG_LAYER_CLASS = "grafloria-svg-layer";
-export declare const HTML_LAYER_CLASS = "grafloria-html-layer";
-/** `data-grafloria-instance` — the renderer's CSS scope, mirrored onto the root. */
-export declare const INSTANCE_ATTR = "data-grafloria-instance";
-export declare const ROOT_STYLE = "position:relative;width:100%;height:100%;overflow:hidden";
-export declare const SVG_LAYER_STYLE = "position:absolute;top:0;left:0;width:100%;height:100%";
-/** The HTML layer's style for a given camera transform (see ViewportController). */
-export declare function htmlLayerStyle(transform: string): string;
-/** The style of one custom node's host element inside the HTML layer. */
-export declare function nodeHostStyle(x: number, y: number, width: number, height: number): string;

package/src/libs/renderer/src/instance/layers.js

@@ -1,43 +0,0 @@
-"use strict";
-/**
- * The DOM skeleton of a mounted diagram — ONE definition, used by both halves.
- *
- * The server (`renderToStaticSVG`) emits this markup as a string; the client
- * (`createDiagram`) builds the identical structure with `createElement`, or
- * ADOPTS the server's when hydrating. Any divergence between the two — a class
- * name, a style declaration, an attribute — is a hydration mismatch, so both
- * paths read the constants from here rather than each spelling them out.
- *
- *   <div class="grafloria-diagram-root" data-grafloria-instance="grafloria-1">
- *     <div class="grafloria-svg-layer">   <svg …/>  </div>   ← the deterministic part
- *     <div class="grafloria-html-layer">  …custom nodes…  </div>  ← client-only
- *   </div>
- *
- * The HTML layer holds nodes that render as framework components (React
- * portals, slotted templates). It carries the camera as a CSS transform so it
- * stays registered with the SVG layer, and is `pointer-events: none` so it does
- * not eat clicks meant for the SVG underneath — each mounted node host turns
- * pointer events back on for itself.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SVG_LAYER_STYLE = exports.ROOT_STYLE = exports.INSTANCE_ATTR = exports.HTML_LAYER_CLASS = exports.SVG_LAYER_CLASS = exports.ROOT_CLASS = void 0;
-exports.htmlLayerStyle = htmlLayerStyle;
-exports.nodeHostStyle = nodeHostStyle;
-exports.ROOT_CLASS = 'grafloria-diagram-root';
-exports.SVG_LAYER_CLASS = 'grafloria-svg-layer';
-exports.HTML_LAYER_CLASS = 'grafloria-html-layer';
-/** `data-grafloria-instance` — the renderer's CSS scope, mirrored onto the root. */
-exports.INSTANCE_ATTR = 'data-grafloria-instance';
-exports.ROOT_STYLE = 'position:relative;width:100%;height:100%;overflow:hidden';
-exports.SVG_LAYER_STYLE = 'position:absolute;top:0;left:0;width:100%;height:100%';
-/** The HTML layer's style for a given camera transform (see ViewportController). */
-function htmlLayerStyle(transform) {
-    return ('position:absolute;top:0;left:0;transform-origin:0 0;pointer-events:none;' +
-        `transform:${transform}`);
-}
-/** The style of one custom node's host element inside the HTML layer. */
-function nodeHostStyle(x, y, width, height) {
-    return (`position:absolute;left:${x}px;top:${y}px;` +
-        `width:${width}px;height:${height}px;pointer-events:auto`);
-}
-//# sourceMappingURL=layers.js.map

package/src/libs/renderer/src/instance/model-input.d.ts

@@ -1,229 +0,0 @@
-import { LinkModel, NodeModel, PortModel } from '@grafloria/engine';
-import type { DiagramModel, LinkConnectorName, LinkRouterName, LinkStyle, NodeStyle, Point, PortGatingSpec, PortLabelSpec, PortLayoutSpec, PortShapeSpec, PortSpot, PortSpreadSpec } from '@grafloria/engine';
-/**
- * Spec → model: the input layer every wrapper shares.
- *
- * A React/Vue/web-component host hands the diagram PLAIN DATA (`nodes`, `edges`)
- * — the React-Flow shape everyone already knows — and expects the library to
- * reconcile it against the live model. That reconciliation is diagram logic, not
- * framework logic, so it lives here and NOT in the wrappers.
- *
- * ## Determinism (Card 6 — SSR + hydration)
- *
- * The server and the client each build their own `DiagramEngine` from the SAME
- * spec, and the two VNode trees must come out byte-identical or hydration would
- * flash. Two sources of randomness had to go:
- *
- * 1. **Node / edge ids.** A spec entry without an `id` gets `node-<index>` /
- *    `edge-<index>`, never a nanoid.
- * 2. **Port ids.** `new NodeModel(...)` auto-creates four default ports whose ids
- *    are nanoids, and the renderer emits them as VNode keys (`port-<id>`). Two
- *    processes would therefore disagree on every port key. {@link buildNode}
- *    replaces those four ports with deterministic ones — `<nodeId>__top`,
- *    `__right`, `__bottom`, `__left` — which also gives edges a stable, readable
- *    handle name (`sourceHandle: 'right'`) instead of an opaque generated id.
- */
-/**
- * A port on a node. Omit `id` to get the deterministic `<nodeId>__<side>` name.
- *
- * ## wave10/gallery BUG FIX — the wave-6 port vocabulary was UNREACHABLE
- *
- * `PortSpec` used to be `{ id, side, type, index }` and `buildNode()` passed
- * exactly those four fields to `new PortModel(...)`. Everything else Wave 6
- * shipped — glyph shapes, port labels, the pluggable layout strategies, port
- * groups, data types, directional gating, link spots, link spreading — is
- * declared on `PortModel`, is accepted by its constructor, and is READ by the
- * renderer and the connection validator… and was silently dropped on the floor
- * by the one translator every host actually goes through.
- *
- * `Grafloria.render()`, `<grafloria-flow>` and `<GrafloriaFlow>` (React) ALL build their
- * ports here. So an entire wave of feature work — square/diamond/triangle/path
- * glyphs, `sideLinear`/`line`/`ellipse` layouts, typed data-flow ports, "this
- * port accepts at most one link" — could not be expressed by any embedder, from
- * any framework, through any public entry point. It had passing unit tests the
- * whole time, because the unit tests construct `PortModel` directly.
- *
- * This is the demo gallery's canonical finding shape, and it is why the gallery
- * exists: a unit test proves a unit works; it never proves anything CALLS it.
- */
-export interface PortSpec {
-    id?: string;
-    /**
-     * Which edge of the node the port sits on. Optional when the port names a
-     * `group` that declares one — `PortModel.explicitSide` exists precisely so an
-     * inherited side is not clobbered by a default.
-     */
-    side?: 'top' | 'right' | 'bottom' | 'left';
-    type?: 'input' | 'output' | 'bi';
-    index?: number;
-    /** Named port group. Config is inherited from it; these fields override. */
-    group?: string;
-    /** Glyph: square / diamond / triangle / a custom SVG path. Default: circle. */
-    shape?: PortShapeSpec;
-    /** Port label + its placement (inside / outside / orthogonal / radial). */
-    label?: PortLabelSpec;
-    /** Layout strategy (line / sideLinear / ellipse / …). Default: the shape anchor. */
-    layout?: PortLayoutSpec;
-    /** Directional connectability + link caps + allowed types. */
-    gating?: PortGatingSpec;
-    /** Data-flow type. Drives glyph colour AND connection validity. */
-    dataType?: string;
-    /** Where links leave / land on the glyph box. */
-    fromSpot?: PortSpot;
-    toSpot?: PortSpot;
-    /** Fan several links out along the port's edge instead of piling them. */
-    spread?: PortSpreadSpec;
-    /** Raw SVG presentation attributes merged onto the glyph. */
-    style?: Record<string, unknown>;
-    /** The legacy single cap. `gating` is the richer form. */
-    maxConnections?: number;
-    visible?: boolean;
-}
-/** A node, as a host hands it in. */
-export interface NodeSpec {
-    id?: string;
-    /** Engine node type. Default `'rect'`. */
-    type?: string;
-    position: {
-        x: number;
-        y: number;
-    };
-    size?: {
-        width: number;
-        height: number;
-    };
-    /** Free-form user payload — passed straight to custom node components. */
-    data?: Record<string, any>;
-    /** Convenience for `metadata.label`. */
-    label?: string;
-    /** Convenience for `metadata.shape` (fill / stroke / cornerRadius / …). */
-    shape?: Record<string, any>;
-    style?: Partial<NodeStyle>;
-    selected?: boolean;
-    draggable?: boolean;
-    selectable?: boolean;
-    /**
-     * Render this node through the host's custom-node callback (React component,
-     * slotted template, …) instead of as SVG. Sets `metadata.useHTMLLayer`.
-     */
-    custom?: boolean;
-    /** Ports. Omit to keep the four deterministic defaults. */
-    ports?: PortSpec[];
-    /** Anything else you want on `node.metadata`. */
-    metadata?: Record<string, any>;
-}
-/**
- * An edge, as a host hands it in. Node-to-node, like React Flow.
- *
- * ## wave10/gallery BUG FIX — `router`, `connector`, `metadata` and `points`
- *
- * Wave 5 Card 0 split `pathType` into two orthogonal, per-link, SERIALIZABLE
- * settings — `router` (where the line goes) and `connector` (how it is drawn) —
- * and Wave 6 Card 2 made the connector a real registry addressed by name. Both
- * fields live on `LinkModel`, both round-trip through `serialize()`… and neither
- * was on `EdgeSpec`. So the A* / manhattan obstacle routers, and every custom
- * connector, were addressable only by reaching past the spec layer into the live
- * model. Same for `metadata`, which is how a link names its anchor and its
- * connection-point strategy (floating edges), and for `points`, which is how a
- * host restores saved waypoints.
- */
-export interface EdgeSpec {
-    id?: string;
-    /** Source NODE id (a port id also resolves, for full control). */
-    source: string;
-    /** Target NODE id. */
-    target: string;
-    /**
-     * Port id, or a bare side name (`'right'`). Naming a handle PINS the edge to
-     * that port. When neither handle is named the edge is PORT-FACING: it
-     * attaches to the node's real port on whichever side faces its partner (the
-     * `'port-facing'` strategy), so a layouted tree connects bottom→top instead
-     * of looping out of a frozen right→left pick — and the endpoint always sits
-     * on a port, never sliding along the perimeter. `metadata.connectionPoint =
-     * 'smart'` opts into true perimeter floating.
-     */
-    sourceHandle?: string;
-    /** Port id, or a bare side name (`'left'`). See `sourceHandle` for the default. */
-    targetHandle?: string;
-    type?: 'direct' | 'smooth' | 'orthogonal' | 'bezier';
-    /**
-     * WHERE the line goes: `straight` | `orthogonal` | `manhattan` | `avoid` |
-     * `elk`, or any router registered on the RoutingEngine. Unset = derived from
-     * `type`.
-     */
-    router?: LinkRouterName;
-    /**
-     * HOW the polyline is drawn: `straight` | `rounded` | `smooth` | `bezier`, or
-     * any name passed to `registerConnector`. Unset = derived from `type`.
-     */
-    connector?: LinkConnectorName;
-    label?: string;
-    style?: Partial<LinkStyle>;
-    selected?: boolean;
-    data?: Record<string, any>;
-    /**
-     * Link metadata. This is how a link names its `sourceAnchor` / `targetAnchor`
-     * and its `connectionPoint` strategy — i.e. how floating edges are turned on
-     * per link.
-     */
-    metadata?: Record<string, any>;
-    /** Explicit waypoints. Restores a user-edited route. */
-    points?: Point[];
-}
-export declare const PORT_SIDES: readonly ["top", "right", "bottom", "left"];
-/** The deterministic id of a node's default port on `side`. */
-export declare function defaultPortId(nodeId: string, side: (typeof PORT_SIDES)[number]): string;
-/** Stable id for the nth node of a spec list. */
-export declare function nodeSpecId(spec: NodeSpec, index: number): string;
-/** Stable id for the nth edge of a spec list. */
-export declare function edgeSpecId(spec: EdgeSpec, index: number): string;
-/** True for a live `NodeModel` (vs a plain spec object). */
-export declare function isNodeModel(value: unknown): value is NodeModel;
-/** True for a live `LinkModel`. */
-export declare function isLinkModel(value: unknown): value is LinkModel;
-/** Build a fresh `NodeModel` from a spec, with deterministic ports. */
-export declare function buildNode(spec: NodeSpec, index: number): NodeModel;
-/**
- * Spec → `PortModel`, carrying the WHOLE wave-6 vocabulary through.
- *
- * The gating spec is flattened onto the model's individual fields because that
- * is the shape `resolvePortConfig()` reads; `PortSpec.gating` is only the
- * ergonomic grouping of them.
- *
- * A port with no explicit `side` and no `group` still lands on `right` (the
- * `PortModel` default) — but a port that names a group and no side is now built
- * WITHOUT `side`, so `explicitSide` stays false and the group's side is
- * inherited, which is the entire reason that flag exists.
- */
-export declare function buildPort(nodeId: string, spec: PortSpec, index: number): PortModel;
-/** Apply the mutable parts of a spec onto an existing node (the update path). */
-export declare function applyNodeSpec(node: NodeModel, spec: NodeSpec): void;
-/**
- * Resolve an edge endpoint to a PORT id.
- * Accepts (in order): an explicit port id, a side name, or the node's default
- * port for `fallbackSide`. Returns undefined when the node does not exist.
- */
-export declare function resolvePortId(diagram: DiagramModel, nodeOrPortId: string, handle: string | undefined, fallbackSide: (typeof PORT_SIDES)[number]): string | undefined;
-/** Build a fresh `LinkModel` from a spec. Returns null when an endpoint is unresolvable. */
-export declare function buildEdge(diagram: DiagramModel, spec: EdgeSpec, index: number): LinkModel | null;
-/** Apply the mutable parts of an edge spec onto an existing link. */
-export declare function applyEdgeSpec(link: LinkModel, spec: EdgeSpec): void;
-/**
- * Reconcile the diagram's nodes against `specs`: add what is new, update what
- * moved, remove what disappeared. Live `NodeModel`s pass through untouched, so a
- * host can mix "give me the data" with "here is my own model".
- *
- * @returns whether anything changed (i.e. whether a repaint is warranted).
- */
-export declare function applyNodes(diagram: DiagramModel, specs: Array<NodeSpec | NodeModel>): boolean;
-/**
- * Model → spec: the projection a host needs to write model changes BACK into its
- * own state (a React `useState`, a Vue `ref`, a web-component property). Without
- * it a wrapper would have to reach into engine models, which is exactly the
- * coupling these specs exist to avoid.
- */
-export declare function toNodeSpec(node: NodeModel): NodeSpec;
-/** Model → spec for a link. See {@link toNodeSpec}. */
-export declare function toEdgeSpec(link: LinkModel): EdgeSpec;
-/** Reconcile the diagram's links against `specs`. See {@link applyNodes}. */
-export declare function applyEdges(diagram: DiagramModel, specs: Array<EdgeSpec | LinkModel>): boolean;

package/src/libs/renderer/src/instance/model-input.js

@@ -1,325 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PORT_SIDES = void 0;
-exports.defaultPortId = defaultPortId;
-exports.nodeSpecId = nodeSpecId;
-exports.edgeSpecId = edgeSpecId;
-exports.isNodeModel = isNodeModel;
-exports.isLinkModel = isLinkModel;
-exports.buildNode = buildNode;
-exports.buildPort = buildPort;
-exports.applyNodeSpec = applyNodeSpec;
-exports.resolvePortId = resolvePortId;
-exports.buildEdge = buildEdge;
-exports.applyEdgeSpec = applyEdgeSpec;
-exports.applyNodes = applyNodes;
-exports.toNodeSpec = toNodeSpec;
-exports.toEdgeSpec = toEdgeSpec;
-exports.applyEdges = applyEdges;
-const engine_1 = require("@grafloria/engine");
-exports.PORT_SIDES = ['top', 'right', 'bottom', 'left'];
-/** The deterministic id of a node's default port on `side`. */
-function defaultPortId(nodeId, side) {
-    return `${nodeId}__${side}`;
-}
-/** Stable id for the nth node of a spec list. */
-function nodeSpecId(spec, index) {
-    var _a;
-    return (_a = spec.id) !== null && _a !== void 0 ? _a : `node-${index}`;
-}
-/** Stable id for the nth edge of a spec list. */
-function edgeSpecId(spec, index) {
-    var _a;
-    return (_a = spec.id) !== null && _a !== void 0 ? _a : `edge-${index}`;
-}
-/** True for a live `NodeModel` (vs a plain spec object). */
-function isNodeModel(value) {
-    return value instanceof engine_1.NodeModel;
-}
-/** True for a live `LinkModel`. */
-function isLinkModel(value) {
-    return value instanceof engine_1.LinkModel;
-}
-/** Build a fresh `NodeModel` from a spec, with deterministic ports. */
-function buildNode(spec, index) {
-    var _a, _b;
-    const id = nodeSpecId(spec, index);
-    const node = new engine_1.NodeModel({
-        id,
-        type: (_a = spec.type) !== null && _a !== void 0 ? _a : 'rect',
-        position: Object.assign({}, spec.position),
-        size: spec.size ? Object.assign({}, spec.size) : undefined,
-    });
-    // Swap the nanoid-keyed auto-ports for deterministic ones (see the module doc).
-    node.ports.clear();
-    const ports = (_b = spec.ports) !== null && _b !== void 0 ? _b : exports.PORT_SIDES.map((side) => ({ side, type: 'bi', index: 0 }));
-    for (const [portIndex, port] of ports.entries()) {
-        node.addPort(buildPort(id, port, portIndex));
-    }
-    applyNodeSpec(node, spec);
-    return node;
-}
-/**
- * Spec → `PortModel`, carrying the WHOLE wave-6 vocabulary through.
- *
- * The gating spec is flattened onto the model's individual fields because that
- * is the shape `resolvePortConfig()` reads; `PortSpec.gating` is only the
- * ergonomic grouping of them.
- *
- * A port with no explicit `side` and no `group` still lands on `right` (the
- * `PortModel` default) — but a port that names a group and no side is now built
- * WITHOUT `side`, so `explicitSide` stays false and the group's side is
- * inherited, which is the entire reason that flag exists.
- */
-function buildPort(nodeId, spec, index) {
-    var _a, _b, _c, _d, _e;
-    const gating = spec.gating;
-    const id = (_a = spec.id) !== null && _a !== void 0 ? _a : (spec.side ? defaultPortId(nodeId, spec.side) : `${nodeId}__p${index}`);
-    return new engine_1.PortModel(Object.assign(Object.assign({ id, type: (_b = spec.type) !== null && _b !== void 0 ? _b : 'bi' }, (spec.side ? { side: spec.side } : {})), { index: (_c = spec.index) !== null && _c !== void 0 ? _c : 0, group: spec.group, shape: spec.shape, label: spec.label, layout: spec.layout, fromSpot: spec.fromSpot, toSpot: spec.toSpot, spread: spec.spread, style: spec.style, visible: spec.visible, dataType: spec.dataType, maxConnections: (_e = (_d = gating === null || gating === void 0 ? void 0 : gating.maxConnections) !== null && _d !== void 0 ? _d : spec.maxConnections) !== null && _e !== void 0 ? _e : undefined, isConnectableStart: gating === null || gating === void 0 ? void 0 : gating.isConnectableStart, isConnectableEnd: gating === null || gating === void 0 ? void 0 : gating.isConnectableEnd, fromMaxLinks: gating === null || gating === void 0 ? void 0 : gating.fromMaxLinks, toMaxLinks: gating === null || gating === void 0 ? void 0 : gating.toMaxLinks, allowSelfLink: gating === null || gating === void 0 ? void 0 : gating.allowSelfLink, allowDuplicateLinks: gating === null || gating === void 0 ? void 0 : gating.allowDuplicateLinks, allowedTypes: gating === null || gating === void 0 ? void 0 : gating.allowedTypes }));
-}
-/** Apply the mutable parts of a spec onto an existing node (the update path). */
-function applyNodeSpec(node, spec) {
-    if (node.position.x !== spec.position.x || node.position.y !== spec.position.y) {
-        node.setPosition(spec.position.x, spec.position.y);
-    }
-    if (spec.size && (node.size.width !== spec.size.width || node.size.height !== spec.size.height)) {
-        node.setSize(spec.size.width, spec.size.height);
-    }
-    if (spec.data)
-        node.data = Object.assign({}, spec.data);
-    if (spec.style)
-        node.style = Object.assign(Object.assign({}, node.style), spec.style);
-    if (spec.label !== undefined)
-        node.setMetadata('label', spec.label);
-    if (spec.shape !== undefined)
-        node.setMetadata('shape', spec.shape);
-    if (spec.custom !== undefined)
-        node.setMetadata('useHTMLLayer', spec.custom);
-    if (spec.metadata) {
-        for (const [key, value] of Object.entries(spec.metadata))
-            node.setMetadata(key, value);
-    }
-    if (spec.draggable !== undefined)
-        node.behavior.draggable = spec.draggable;
-    if (spec.selectable !== undefined)
-        node.behavior.selectable = spec.selectable;
-    if (spec.selected !== undefined && spec.selected !== node.isSelected()) {
-        node.setSelected(spec.selected);
-    }
-}
-/**
- * Resolve an edge endpoint to a PORT id.
- * Accepts (in order): an explicit port id, a side name, or the node's default
- * port for `fallbackSide`. Returns undefined when the node does not exist.
- */
-function resolvePortId(diagram, nodeOrPortId, handle, fallbackSide) {
-    var _a;
-    const node = diagram.getNode(nodeOrPortId);
-    if (!node) {
-        // `source` may itself be a port id (full-control escape hatch).
-        return diagram.getPortById(nodeOrPortId) ? nodeOrPortId : undefined;
-    }
-    if (handle) {
-        if (node.getPort(handle))
-            return handle;
-        if (exports.PORT_SIDES.includes(handle)) {
-            const port = node.getPortBySide(handle);
-            if (port)
-                return port.id;
-        }
-        // An unknown handle name is a caller error; fall through to the default side
-        // rather than silently dropping the edge.
-    }
-    return (_a = node.getPortBySide(fallbackSide)) === null || _a === void 0 ? void 0 : _a.id;
-}
-/** Build a fresh `LinkModel` from a spec. Returns null when an endpoint is unresolvable. */
-function buildEdge(diagram, spec, index) {
-    var _a, _b, _c, _d, _e, _f;
-    const sourcePortId = resolvePortId(diagram, spec.source, spec.sourceHandle, 'right');
-    const targetPortId = resolvePortId(diagram, spec.target, spec.targetHandle, 'left');
-    if (!sourcePortId || !targetPortId)
-        return null;
-    const link = new engine_1.LinkModel(sourcePortId, targetPortId, (_a = spec.type) !== null && _a !== void 0 ? _a : 'smooth');
-    // LinkModel's id is generated; force the deterministic one so SSR and the
-    // client agree on the `link-<id>` VNode key.
-    link.id = edgeSpecId(spec, index);
-    link.sourceNodeId = (_b = diagram.getNodeByPortId(sourcePortId)) === null || _b === void 0 ? void 0 : _b.id;
-    link.targetNodeId = (_c = diagram.getNodeByPortId(targetPortId)) === null || _c === void 0 ? void 0 : _c.id;
-    applyEdgeSpec(link, spec);
-    // An edge that names NO handle has expressed no opinion about sides — but the
-    // fallback above still had to pick ports, and that pick (right→left) froze at
-    // build time. Once a layout stacks the nodes vertically, every such edge exits
-    // the wrong side and loops back around its own node. So record the fact that
-    // the anchoring was left to us: the renderer resolves this stamp to the 'smart'
-    // (draw.io floating) strategy at the LOWEST precedence — an explicit
-    // `metadata.connectionPoint`, per-end anchors, a diagram-wide
-    // `connectionPoint` config, or explicit waypoints all still win, and naming
-    // either handle pins the edge exactly as before.
-    if (!spec.sourceHandle &&
-        !spec.targetHandle &&
-        spec.points === undefined &&
-        ((_d = spec.metadata) === null || _d === void 0 ? void 0 : _d['connectionPoint']) === undefined &&
-        ((_e = spec.metadata) === null || _e === void 0 ? void 0 : _e['sourceAnchor']) === undefined &&
-        ((_f = spec.metadata) === null || _f === void 0 ? void 0 : _f['targetAnchor']) === undefined) {
-        link.setMetadata('autoConnectionPoint', true);
-    }
-    return link;
-}
-/** Apply the mutable parts of an edge spec onto an existing link. */
-function applyEdgeSpec(link, spec) {
-    if (spec.type && link.pathType !== spec.type)
-        link.setPathType(spec.type);
-    // Router/connector go through the SETTERS, not assignment: `setRouter` drops
-    // the stale polyline (it belongs to the old router) and both track the change,
-    // which is what invalidates the link's cached VNode.
-    if (spec.router !== undefined && link.router !== spec.router)
-        link.setRouter(spec.router);
-    if (spec.connector !== undefined && link.connector !== spec.connector) {
-        link.setConnector(spec.connector);
-    }
-    if (spec.style)
-        link.updateStyle(spec.style);
-    if (spec.data)
-        link.data = Object.assign({}, spec.data);
-    if (spec.label !== undefined)
-        link.setMetadata('label', spec.label);
-    if (spec.metadata) {
-        for (const [key, value] of Object.entries(spec.metadata))
-            link.setMetadata(key, value);
-    }
-    if (spec.points)
-        link.setPoints(spec.points);
-    if (spec.selected !== undefined) {
-        const want = spec.selected ? 'selected' : 'default';
-        if (link.state !== want)
-            link.setState(want);
-    }
-}
-/**
- * Reconcile the diagram's nodes against `specs`: add what is new, update what
- * moved, remove what disappeared. Live `NodeModel`s pass through untouched, so a
- * host can mix "give me the data" with "here is my own model".
- *
- * @returns whether anything changed (i.e. whether a repaint is warranted).
- */
-function applyNodes(diagram, specs) {
-    const seen = new Set();
-    let changed = false;
-    specs.forEach((spec, index) => {
-        if (isNodeModel(spec)) {
-            seen.add(spec.id);
-            if (!diagram.getNode(spec.id)) {
-                diagram.addNode(spec);
-                changed = true;
-            }
-            return;
-        }
-        const id = nodeSpecId(spec, index);
-        seen.add(id);
-        const existing = diagram.getNode(id);
-        if (existing) {
-            applyNodeSpec(existing, spec);
-            changed = true; // conservative: specs are new objects every render
-        }
-        else {
-            diagram.addNode(buildNode(spec, index));
-            changed = true;
-        }
-    });
-    for (const node of diagram.getNodes()) {
-        if (!seen.has(node.id)) {
-            diagram.removeNode(node.id);
-            changed = true;
-        }
-    }
-    return changed;
-}
-/**
- * Model → spec: the projection a host needs to write model changes BACK into its
- * own state (a React `useState`, a Vue `ref`, a web-component property). Without
- * it a wrapper would have to reach into engine models, which is exactly the
- * coupling these specs exist to avoid.
- */
-function toNodeSpec(node) {
-    const spec = {
-        id: node.id,
-        type: node.type,
-        position: { x: node.position.x, y: node.position.y },
-        size: { width: node.size.width, height: node.size.height },
-        selected: node.isSelected(),
-    };
-    const data = node.data;
-    if (data && Object.keys(data).length > 0)
-        spec.data = Object.assign({}, data);
-    const label = node.getLabel();
-    if (label !== undefined)
-        spec.label = label;
-    const shape = node.getMetadata('shape');
-    if (shape !== undefined)
-        spec.shape = shape;
-    if (node.getMetadata('useHTMLLayer'))
-        spec.custom = true;
-    return spec;
-}
-/** Model → spec for a link. See {@link toNodeSpec}. */
-function toEdgeSpec(link) {
-    var _a, _b;
-    const spec = {
-        id: link.id,
-        source: (_a = link.sourceNodeId) !== null && _a !== void 0 ? _a : link.sourcePortId,
-        target: (_b = link.targetNodeId) !== null && _b !== void 0 ? _b : link.targetPortId,
-        sourceHandle: link.sourcePortId,
-        targetHandle: link.targetPortId,
-        type: link.pathType,
-        selected: link.state === 'selected',
-    };
-    // Round-trip the wave-5 split fields, or a host that projects the model back
-    // into its own state would silently reset every custom router/connector.
-    if (link.router !== undefined)
-        spec.router = link.router;
-    if (link.connector !== undefined)
-        spec.connector = link.connector;
-    const label = link.getLabel();
-    if (label !== undefined)
-        spec.label = label;
-    if (link.data && Object.keys(link.data).length > 0)
-        spec.data = Object.assign({}, link.data);
-    return spec;
-}
-/** Reconcile the diagram's links against `specs`. See {@link applyNodes}. */
-function applyEdges(diagram, specs) {
-    const seen = new Set();
-    let changed = false;
-    specs.forEach((spec, index) => {
-        if (isLinkModel(spec)) {
-            seen.add(spec.id);
-            if (!diagram.getLink(spec.id)) {
-                diagram.addLink(spec);
-                changed = true;
-            }
-            return;
-        }
-        const id = edgeSpecId(spec, index);
-        seen.add(id);
-        const existing = diagram.getLink(id);
-        if (existing) {
-            applyEdgeSpec(existing, spec);
-            changed = true;
-        }
-        else {
-            const link = buildEdge(diagram, spec, index);
-            if (link) {
-                diagram.addLink(link);
-                changed = true;
-            }
-        }
-    });
-    for (const link of diagram.getLinks()) {
-        if (!seen.has(link.id)) {
-            diagram.removeLink(link.id);
-            changed = true;
-        }
-    }
-    return changed;
-}
-//# sourceMappingURL=model-input.js.map