@grafloria/element 0.3.17 → 0.3.19

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

@@ -0,0 +1,325 @@
+"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

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

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

package/src/libs/renderer/src/instance/render-scheduler.d.ts

@@ -0,0 +1,79 @@
+/**
+ * RenderScheduler — framework-agnostic rAF coalescing + idle-skip.
+ *
+ * Blocker #3 of the headless-instance contract (see ./diagram-instance.ts): the
+ * only render loop in the codebase was `DiagramCanvasComponent.scheduleRender()`,
+ * a private Angular method. This is that logic, lifted verbatim in behaviour and
+ * with no framework or DOM imports, so React / the web component / a plain
+ * `<script>` host all inherit the same frame discipline:
+ *
+ *   - **Coalescing.** Any number of `schedule()` calls in one tick collapse into
+ *     exactly ONE painted frame. A burst of engine events (`node:changed` ×N, a
+ *     drag's mousemoves, several prop changes in one React commit) paints once.
+ *   - **Idle-skip.** A queued frame is DROPPED when `shouldSkip()` says nothing
+ *     visible can have changed — cheaper than a no-op render of a big diagram.
+ *   - **Synchronous escape.** `flush()` paints right now and cancels the queued
+ *     frame; used for the mount paint (so the first frame is not one rAF late)
+ *     and by tests.
+ *
+ * `requestFrame`/`cancelFrame` are injectable: pass fakes in tests, and note the
+ * default falls back to `setTimeout` where rAF is missing (Node), so a scheduler
+ * constructed during SSR never throws — it simply never gets a chance to fire
+ * because nothing calls `schedule()` on the server.
+ */
+export interface RenderSchedulerOptions {
+    /** The paint. Called at most once per frame. */
+    onFrame: () => void;
+    /**
+     * Idle-skip predicate, evaluated INSIDE the frame (not at schedule time, so it
+     * sees the final state of the tick). Return true to drop the frame.
+     */
+    shouldSkip?: () => boolean;
+    /** Injectable rAF (defaults to the platform one, with a setTimeout fallback). */
+    requestFrame?: (cb: (time: number) => void) => number;
+    /** Injectable cancel, must pair with `requestFrame`. */
+    cancelFrame?: (handle: number) => void;
+}
+/** Cheap counters — a steady-state idle canvas should paint 0 frames. */
+export interface RenderSchedulerStats {
+    /** `schedule()` calls. */
+    scheduled: number;
+    /** Frames actually painted (`onFrame` ran). */
+    painted: number;
+    /** Queued frames dropped by `shouldSkip()`. */
+    skipped: number;
+    /** `schedule()` calls that folded into an already-queued frame. */
+    coalesced: number;
+    /** Duration (ms) of the most recent paint. */
+    lastFrameMs: number;
+}
+export declare class RenderScheduler {
+    private handle;
+    private dirty;
+    private disposed;
+    private readonly onFrame;
+    private readonly shouldSkip?;
+    private readonly requestFrameFn;
+    private readonly cancelFrameFn;
+    private _stats;
+    constructor(options: RenderSchedulerOptions);
+    get stats(): Readonly<RenderSchedulerStats>;
+    /** True while a frame is queued but has not run yet. */
+    get pending(): boolean;
+    /**
+     * Mark dirty and queue a frame. Idempotent within a tick — the second and
+     * later calls before the frame runs are counted as `coalesced`, not queued.
+     */
+    schedule(): void;
+    /**
+     * Paint NOW, bypassing rAF and the idle-skip check, and cancel any queued
+     * frame. This is the mount paint (and the "give me a correct DOM before I
+     * measure it" escape hatch).
+     */
+    flush(): void;
+    /** Drop a queued frame without painting. */
+    cancel(): void;
+    dispose(): void;
+    private cancelPending;
+    private paint;
+}

package/src/libs/renderer/src/instance/render-scheduler.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenderScheduler = void 0;
+const platform_1 = require("../platform");
+class RenderScheduler {
+    constructor(options) {
+        var _a, _b;
+        this.handle = null;
+        this.dirty = false;
+        this.disposed = false;
+        this._stats = {
+            scheduled: 0,
+            painted: 0,
+            skipped: 0,
+            coalesced: 0,
+            lastFrameMs: 0,
+        };
+        this.onFrame = options.onFrame;
+        this.shouldSkip = options.shouldSkip;
+        this.requestFrameFn = (_a = options.requestFrame) !== null && _a !== void 0 ? _a : platform_1.requestFrame;
+        this.cancelFrameFn = (_b = options.cancelFrame) !== null && _b !== void 0 ? _b : platform_1.cancelFrame;
+    }
+    get stats() {
+        return this._stats;
+    }
+    /** True while a frame is queued but has not run yet. */
+    get pending() {
+        return this.handle !== null;
+    }
+    /**
+     * Mark dirty and queue a frame. Idempotent within a tick — the second and
+     * later calls before the frame runs are counted as `coalesced`, not queued.
+     */
+    schedule() {
+        if (this.disposed)
+            return;
+        this._stats.scheduled++;
+        this.dirty = true;
+        if (this.handle !== null) {
+            this._stats.coalesced++;
+            return;
+        }
+        this.handle = this.requestFrameFn(() => {
+            var _a;
+            this.handle = null;
+            if (this.disposed)
+                return;
+            // A synchronous flush() already painted this tick's work.
+            if (!this.dirty)
+                return;
+            if ((_a = this.shouldSkip) === null || _a === void 0 ? void 0 : _a.call(this)) {
+                this.dirty = false;
+                this._stats.skipped++;
+                return;
+            }
+            this.paint();
+        });
+    }
+    /**
+     * Paint NOW, bypassing rAF and the idle-skip check, and cancel any queued
+     * frame. This is the mount paint (and the "give me a correct DOM before I
+     * measure it" escape hatch).
+     */
+    flush() {
+        if (this.disposed)
+            return;
+        this.cancelPending();
+        this.dirty = false;
+        this.paint();
+    }
+    /** Drop a queued frame without painting. */
+    cancel() {
+        this.cancelPending();
+        this.dirty = false;
+    }
+    dispose() {
+        this.cancelPending();
+        this.disposed = true;
+        this.dirty = false;
+    }
+    cancelPending() {
+        if (this.handle !== null) {
+            this.cancelFrameFn(this.handle);
+            this.handle = null;
+        }
+    }
+    paint() {
+        const start = (0, platform_1.now)();
+        this.dirty = false;
+        this.onFrame();
+        this._stats.painted++;
+        this._stats.lastFrameMs = (0, platform_1.now)() - start;
+    }
+}
+exports.RenderScheduler = RenderScheduler;
+//# sourceMappingURL=render-scheduler.js.map

package/src/libs/renderer/src/instance/render-scheduler.js.map

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

package/src/libs/renderer/src/instance/wheel-scroll-yield.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Wheel-over-scrollable-card delegation — makes scrollbars inside HTML nodes
+ * (foreignObject cards: ER tables, class boxes, custom cards) usable, and
+ * keeps a card's wheel from ever panning the canvas out from under the cursor.
+ *
+ * Two facts, both found empirically, force this to be a DELEGATION and not a
+ * mere yield:
+ *
+ *  1. The binder's plain-wheel PAN branch preventDefault()s every wheel, so
+ *     native scroll never runs and the canvas pans under the cursor.
+ *  2. Card content inside a foreignObject is `pointer-events: none` (so
+ *     clicks and drags fall through to the node) — the wheel's target is the
+ *     foreignObject or another SVG element, NEVER the scrollable div. Even if
+ *     the canvas yielded, the browser would have nothing to scroll: a
+ *     pointer-events:none element can't be an event target, and native scroll
+ *     chains only walk UP from the target.
+ *
+ * So the binder finds the scrollable content under the cursor itself and
+ * scrolls it programmatically. The rule is CONTAINMENT (overscroll-behavior:
+ * contain), not scroll-chaining:
+ *
+ *  - ctrl/⌘ wheel (pinch-zoom) ALWAYS belongs to the canvas;
+ *  - a plain wheel over a card that is scrollable in the wheel's axis belongs
+ *    to THAT card — it scrolls as far as it can and, AT THE END OF ITS RANGE,
+ *    the wheel is CONSUMED, not handed to the canvas. Reaching the bottom of a
+ *    table must never suddenly pan the whole diagram (the reported bug). To
+ *    pan, the cursor leaves the card;
+ *  - a plain wheel that is NOT over such a card falls through to the canvas.
+ */
+/**
+ * If this wheel is over scrollable card content, scroll that content and
+ * report the wheel HANDLED — the caller preventDefault()s and skips panning.
+ * Handled is returned whenever the cursor is over such a card, INCLUDING at
+ * the end of its scroll range (containment: the card, not the canvas, absorbs
+ * the wheel). Returns false only for pinch-zoom or when no scrollable card is
+ * under the cursor, so the canvas pans normally.
+ */
+export declare function delegateWheelToScrollable(event: WheelEvent): boolean;