@grafloria/element 0.3.18 → 0.3.19

package/src/libs/renderer/src/interaction/highlighters.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HighlighterController = exports.DEFAULT_HIGHLIGHTER_CONFIG = void 0;
+exports.parseValidationPath = parseValidationPath;
+exports.DEFAULT_HIGHLIGHTER_CONFIG = {
+    hoverPadding: 2,
+    selectionPadding: 4,
+    validationPadding: 6,
+    showHover: true,
+    showSelection: true,
+    showValidation: true,
+    showConnectTargets: true,
+};
+/**
+ * Parse a ValidationEngine `path` back to the entity it names.
+ * Paths look like `node.<id>`, `node.<id>.port.<id>`, `node.<id>.hierarchy`,
+ * `link.<id>`. Anything else (diagram-level) is not entity-scoped.
+ */
+function parseValidationPath(path) {
+    const parts = (path !== null && path !== void 0 ? path : '').split('.');
+    if (parts.length < 2)
+        return null;
+    if (parts[0] === 'node')
+        return { entity: 'node', entityId: parts[1] };
+    if (parts[0] === 'link')
+        return { entity: 'link', entityId: parts[1] };
+    return null;
+}
+class HighlighterController {
+    constructor(config = {}) {
+        /** entityId → issues; refreshed by {@link refreshValidation}. */
+        this.issues = new Map();
+        this.config = Object.assign(Object.assign({}, exports.DEFAULT_HIGHLIGHTER_CONFIG), config);
+    }
+    getConfig() {
+        return Object.assign({}, this.config);
+    }
+    updateConfig(patch) {
+        this.config = Object.assign(Object.assign({}, this.config), patch);
+    }
+    /**
+     * Run the engine's validation once and cache the per-entity issues.
+     *
+     * Called on structure changes (node/link added/removed/reconnected) — NOT per
+     * frame: `validateDiagram()` walks every node, link, hierarchy and group.
+     */
+    refreshValidation(engine) {
+        var _a;
+        this.issues.clear();
+        const result = (_a = engine === null || engine === void 0 ? void 0 : engine.validateDiagram) === null || _a === void 0 ? void 0 : _a.call(engine);
+        if (!result)
+            return [];
+        const all = [];
+        const push = (severity) => (raw) => {
+            var _a;
+            const target = parseValidationPath(raw.path);
+            if (!target)
+                return;
+            const issue = {
+                entity: target.entity,
+                entityId: target.entityId,
+                severity,
+                message: raw.message,
+                code: raw.code,
+            };
+            all.push(issue);
+            const list = (_a = this.issues.get(target.entityId)) !== null && _a !== void 0 ? _a : [];
+            list.push(issue);
+            this.issues.set(target.entityId, list);
+        };
+        result.errors.forEach(push('error'));
+        result.warnings.forEach(push('warning'));
+        return all;
+    }
+    /** Issues cached for one entity (empty when clean / never refreshed). */
+    getIssues(entityId) {
+        var _a;
+        return (_a = this.issues.get(entityId)) !== null && _a !== void 0 ? _a : [];
+    }
+    /** Drop the cached validation (e.g. when the diagram is swapped). */
+    clearValidation() {
+        this.issues.clear();
+    }
+    /**
+     * Every highlighter that applies right now, in paint order: validation first
+     * (bottom), then selection, then hover, then connect targets (top).
+     */
+    compute(engine) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const diagram = (_a = engine === null || engine === void 0 ? void 0 : engine.getDiagram) === null || _a === void 0 ? void 0 : _a.call(engine);
+        if (!diagram)
+            return [];
+        const out = [];
+        const connectionState = (_d = (_c = (_b = engine.getConnectionStateManager) === null || _b === void 0 ? void 0 : _b.call(engine)) === null || _c === void 0 ? void 0 : _c.getState) === null || _d === void 0 ? void 0 : _d.call(_c);
+        const validTargets = (connectionState === null || connectionState === void 0 ? void 0 : connectionState.isConnecting)
+            ? (_e = connectionState.validTargetNodes) !== null && _e !== void 0 ? _e : new Set()
+            : new Set();
+        for (const node of diagram.getNodes()) {
+            if (((_f = node.state) === null || _f === void 0 ? void 0 : _f.visible) === false)
+                continue;
+            if (this.config.showValidation) {
+                const worst = this.worstIssue(node.id);
+                if (worst) {
+                    out.push({
+                        id: `validation-node-${node.id}`,
+                        kind: 'validation',
+                        entity: 'node',
+                        entityId: node.id,
+                        bounds: this.boxOf(node, this.config.validationPadding),
+                        rotation: node.rotation || 0,
+                        severity: worst.severity,
+                        message: worst.message,
+                        className: `grafloria-highlighter grafloria-highlighter-validation grafloria-highlighter-${worst.severity}`,
+                    });
+                }
+            }
+            if (this.config.showSelection && node.isSelected()) {
+                out.push({
+                    id: `selection-node-${node.id}`,
+                    kind: 'selection',
+                    entity: 'node',
+                    entityId: node.id,
+                    bounds: this.boxOf(node, this.config.selectionPadding),
+                    rotation: node.rotation || 0,
+                    className: 'grafloria-highlighter grafloria-highlighter-selection',
+                });
+            }
+            if (this.config.showHover && ((_g = node.state) === null || _g === void 0 ? void 0 : _g.hovered) && !node.isSelected()) {
+                out.push({
+                    id: `hover-node-${node.id}`,
+                    kind: 'hover',
+                    entity: 'node',
+                    entityId: node.id,
+                    bounds: this.boxOf(node, this.config.hoverPadding),
+                    rotation: node.rotation || 0,
+                    className: 'grafloria-highlighter grafloria-highlighter-hover',
+                });
+            }
+            if (this.config.showConnectTargets && validTargets.has(node.id)) {
+                out.push({
+                    id: `connect-node-${node.id}`,
+                    kind: 'connect-target',
+                    entity: 'node',
+                    entityId: node.id,
+                    bounds: this.boxOf(node, this.config.selectionPadding),
+                    rotation: node.rotation || 0,
+                    className: 'grafloria-highlighter grafloria-highlighter-connect-target',
+                });
+            }
+        }
+        for (const link of diagram.getLinks()) {
+            const points = link.points;
+            if (!points || points.length < 2)
+                continue;
+            if (this.config.showValidation) {
+                const worst = this.worstIssue(link.id);
+                if (worst) {
+                    out.push({
+                        id: `validation-link-${link.id}`,
+                        kind: 'validation',
+                        entity: 'link',
+                        entityId: link.id,
+                        points: points.map((p) => (Object.assign({}, p))),
+                        severity: worst.severity,
+                        message: worst.message,
+                        className: `grafloria-highlighter grafloria-highlighter-validation grafloria-highlighter-${worst.severity}`,
+                    });
+                }
+            }
+            if (this.config.showSelection && link.state === 'selected') {
+                out.push({
+                    id: `selection-link-${link.id}`,
+                    kind: 'selection',
+                    entity: 'link',
+                    entityId: link.id,
+                    points: points.map((p) => (Object.assign({}, p))),
+                    className: 'grafloria-highlighter grafloria-highlighter-selection',
+                });
+            }
+            if (this.config.showHover && link.state === 'hovered') {
+                out.push({
+                    id: `hover-link-${link.id}`,
+                    kind: 'hover',
+                    entity: 'link',
+                    entityId: link.id,
+                    points: points.map((p) => (Object.assign({}, p))),
+                    className: 'grafloria-highlighter grafloria-highlighter-hover',
+                });
+            }
+        }
+        return out;
+    }
+    /** Errors outrank warnings; the first of the worst severity wins. */
+    worstIssue(entityId) {
+        var _a;
+        const issues = this.issues.get(entityId);
+        if (!issues || issues.length === 0)
+            return null;
+        return (_a = issues.find((i) => i.severity === 'error')) !== null && _a !== void 0 ? _a : issues[0];
+    }
+    boxOf(node, padding) {
+        const box = node.getBoundingBox();
+        return {
+            x: box.left - padding,
+            y: box.top - padding,
+            width: box.right - box.left + padding * 2,
+            height: box.bottom - box.top + padding * 2,
+        };
+    }
+}
+exports.HighlighterController = HighlighterController;
+//# sourceMappingURL=highlighters.js.map

package/src/libs/renderer/src/interaction/highlighters.js.map

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

package/src/libs/renderer/src/interaction/in-place-editor.d.ts

@@ -0,0 +1,63 @@
+import type { DiagramEngine, Command, Point } from '@grafloria/engine';
+import type { Rectangle } from '../types/geometry.types';
+/**
+ * InPlaceTextEditor — the model behind double-click-to-edit (Card 5,
+ * wave4/interaction).
+ *
+ * A host cannot avoid owning the actual text widget (an `<input>`, a
+ * `contenteditable`, a native text field), but everything AROUND it is
+ * framework-agnostic and belongs here:
+ *
+ *  - WHAT is being edited (node label / link label) and its current text;
+ *  - WHERE the editor goes, in world coordinates (the host maps to screen with
+ *    its viewport, so the editor lands exactly over the text at any zoom);
+ *  - the ONE undoable {@link Command} that commits the new value.
+ *
+ * The commit path is the point: before this, in-place edits wrote straight to the
+ * model and could not be undone.
+ */
+export type TextEditTargetType = 'node' | 'link-label';
+export interface TextEditTarget {
+    type: TextEditTargetType;
+    /** Node being edited (`type: 'node'`). */
+    nodeId?: string;
+    /** Link owning the label (`type: 'link-label'`). */
+    linkId?: string;
+    /**
+     * Which label on that link. Links carry TWO label dialects: the positioned
+     * `labels[]` collection, and the DISPLAY label every spec input writes
+     * (`edges: [{label}]` → `metadata.label`, painted at the path midpoint).
+     * When `labels[index]` does not exist, `begin()` falls back to the display
+     * label — the sentinel `-1` marks that dialect internally so `commit()`
+     * writes it back through {@link SetLinkDisplayLabelCommand}.
+     */
+    labelIndex?: number;
+}
+export interface TextEditSession {
+    target: TextEditTarget;
+    /** The text the editor opens with. */
+    value: string;
+    /** World rectangle the editor should cover. */
+    bounds: Rectangle;
+    /** World point the editor centres on (labels have no box of their own). */
+    center: Point;
+    /** Node labels wrap; link labels are single-line. */
+    multiline: boolean;
+}
+export declare class InPlaceTextEditor {
+    protected session: TextEditSession | null;
+    getSession(): TextEditSession | null;
+    isEditing(): boolean;
+    /**
+     * Open a session on a target. Returns null when the target does not exist or
+     * is not editable (`behavior.editable === false`, or a locked node).
+     */
+    begin(engine: DiagramEngine, target: TextEditTarget): TextEditSession | null;
+    /**
+     * Commit the session's new value. Returns the undoable command (null for a
+     * no-op edit, or when the session is gone). Always ends the session.
+     */
+    commit(engine: DiagramEngine, value: string): Command | null;
+    /** Abandon the session without touching the model. */
+    cancel(): void;
+}

package/src/libs/renderer/src/interaction/in-place-editor.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InPlaceTextEditor = void 0;
+const engine_1 = require("@grafloria/engine");
+class InPlaceTextEditor {
+    constructor() {
+        this.session = null;
+    }
+    getSession() {
+        return this.session ? Object.assign({}, this.session) : null;
+    }
+    isEditing() {
+        return this.session !== null;
+    }
+    /**
+     * Open a session on a target. Returns null when the target does not exist or
+     * is not editable (`behavior.editable === false`, or a locked node).
+     */
+    begin(engine, target) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+        const diagram = (_a = engine === null || engine === void 0 ? void 0 : engine.getDiagram) === null || _a === void 0 ? void 0 : _a.call(engine);
+        if (!diagram)
+            return null;
+        if (target.type === 'node') {
+            const node = target.nodeId ? diagram.getNode(target.nodeId) : undefined;
+            if (!node)
+                return null;
+            if (((_b = node.behavior) === null || _b === void 0 ? void 0 : _b.editable) === false || ((_c = node.state) === null || _c === void 0 ? void 0 : _c.locked))
+                return null;
+            const box = node.getBoundingBox();
+            const bounds = {
+                x: box.left,
+                y: box.top,
+                width: box.right - box.left,
+                height: box.bottom - box.top,
+            };
+            this.session = {
+                target: Object.assign({}, target),
+                value: String((_d = node.getLabel()) !== null && _d !== void 0 ? _d : ''),
+                bounds,
+                center: { x: bounds.x + bounds.width / 2, y: bounds.y + bounds.height / 2 },
+                multiline: true,
+            };
+            return this.getSession();
+        }
+        const link = target.linkId ? diagram.getLink(target.linkId) : undefined;
+        if (!link)
+            return null;
+        const index = (_e = target.labelIndex) !== null && _e !== void 0 ? _e : 0;
+        const label = (_f = link.labels) === null || _f === void 0 ? void 0 : _f[index];
+        if (!label) {
+            // DISPLAY-label dialect: the edge has no positioned labels[], but the
+            // canonical `metadata.label` (what `edges: [{label}]` writes and the SVG
+            // renderer paints at the path's middle routed point) may exist — that is
+            // the label the user is LOOKING at, so it is the one an editor must
+            // open on. Anchor exactly where the renderer anchors: points[mid].
+            // A link with positioned labels keeps the old contract: asking for a
+            // slot that does not exist opens nothing.
+            const displayValue = String((_g = link.getLabel()) !== null && _g !== void 0 ? _g : '');
+            if (((_j = (_h = link.labels) === null || _h === void 0 ? void 0 : _h.length) !== null && _j !== void 0 ? _j : 0) > 0 || !displayValue)
+                return null;
+            const points = (_k = link.points) !== null && _k !== void 0 ? _k : [];
+            if (points.length < 2)
+                return null;
+            const anchor = points[Math.floor(points.length / 2)];
+            const width = Math.max(40, displayValue.length * 8);
+            const height = 20;
+            this.session = {
+                target: Object.assign(Object.assign({}, target), { labelIndex: -1 }),
+                value: displayValue,
+                bounds: {
+                    x: anchor.x - width / 2,
+                    y: anchor.y - height / 2,
+                    width,
+                    height,
+                },
+                center: { x: anchor.x, y: anchor.y },
+                multiline: false,
+            };
+            return this.getSession();
+        }
+        // The label sits at `position` along the route, plus its own offset — the
+        // exact anchor LabelRenderer draws it at, so the editor lands ON the text
+        // instead of near it.
+        const anchor = link.getPointAtPosition((_l = label.position) !== null && _l !== void 0 ? _l : 0.5);
+        if (!anchor)
+            return null;
+        const center = {
+            x: anchor.x + ((_o = (_m = label.offset) === null || _m === void 0 ? void 0 : _m.x) !== null && _o !== void 0 ? _o : 0),
+            y: anchor.y + ((_q = (_p = label.offset) === null || _p === void 0 ? void 0 : _p.y) !== null && _q !== void 0 ? _q : 0),
+        };
+        const width = Math.max(40, ((_s = (_r = label.text) === null || _r === void 0 ? void 0 : _r.length) !== null && _s !== void 0 ? _s : 0) * 8);
+        const height = 20;
+        this.session = {
+            target: Object.assign(Object.assign({}, target), { labelIndex: index }),
+            value: (_t = label.text) !== null && _t !== void 0 ? _t : '',
+            bounds: { x: center.x - width / 2, y: center.y - height / 2, width, height },
+            center,
+            multiline: false,
+        };
+        return this.getSession();
+    }
+    /**
+     * Commit the session's new value. Returns the undoable command (null for a
+     * no-op edit, or when the session is gone). Always ends the session.
+     */
+    commit(engine, value) {
+        var _a;
+        const session = this.session;
+        this.session = null;
+        if (!session)
+            return null;
+        if (value === session.value)
+            return null;
+        const diagram = (_a = engine === null || engine === void 0 ? void 0 : engine.getDiagram) === null || _a === void 0 ? void 0 : _a.call(engine);
+        if (!diagram)
+            return null;
+        if (session.target.type === 'node' && session.target.nodeId) {
+            if (!diagram.getNode(session.target.nodeId))
+                return null;
+            return new engine_1.SetNodeLabelCommand(session.target.nodeId, value, session.value);
+        }
+        if (session.target.linkId !== undefined && session.target.labelIndex !== undefined) {
+            if (!diagram.getLink(session.target.linkId))
+                return null;
+            // -1 marks the display-label dialect (see begin()): the write goes to
+            // `metadata.label`, not into a labels[] slot that does not exist.
+            if (session.target.labelIndex === -1) {
+                return new engine_1.SetLinkDisplayLabelCommand(session.target.linkId, value, session.value);
+            }
+            return new engine_1.SetLinkLabelCommand(session.target.linkId, session.target.labelIndex, value, session.value);
+        }
+        return null;
+    }
+    /** Abandon the session without touching the model. */
+    cancel() {
+        this.session = null;
+    }
+}
+exports.InPlaceTextEditor = InPlaceTextEditor;
+//# sourceMappingURL=in-place-editor.js.map

package/src/libs/renderer/src/interaction/in-place-editor.js.map

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

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

@@ -0,0 +1,11 @@
+export * from './WaypointEditor';
+export * from './ControlPointEditor';
+export * from './interaction-controller';
+export * from './selection-tools';
+export * from './highlighters';
+export * from './in-place-editor';
+export * from './snapping';
+export * from './keyboard-navigation';
+export * from './whiteboard-tools';
+export * from './ink-overlay';
+export * from './touch-gestures';

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

@@ -0,0 +1,29 @@
+"use strict";
+// Interaction tools exports
+// Phase 2.3: Interactive link editing
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./WaypointEditor"), exports);
+tslib_1.__exportStar(require("./ControlPointEditor"), exports);
+// Framework-agnostic interaction brain (Angular's InteractionHandlerService is
+// a thin @Injectable subclass of this).
+tslib_1.__exportStar(require("./interaction-controller"), exports);
+// Wave 4 — Card 5: the floating tool layer (resize/rotate handles, Halo,
+// link endpoint + vertex tools), the highlighter layer, and in-place text editing.
+tslib_1.__exportStar(require("./selection-tools"), exports);
+tslib_1.__exportStar(require("./highlighters"), exports);
+tslib_1.__exportStar(require("./in-place-editor"), exports);
+// Wave 4 — Card 6: snaplines, equal-spacing guides, grid snap, keep-in-bounds,
+// magnetic snap-to-port and proximity connect.
+tslib_1.__exportStar(require("./snapping"), exports);
+// Wave 4 — Card 7: keyboard-first + accessible canvas interaction.
+tslib_1.__exportStar(require("./keyboard-navigation"), exports);
+// wave10/whiteboard: the freehand-draw / rectangle / eraser tools, and the separate
+// overlay layer the in-progress stroke draws on (the presence pattern, for the frame gate).
+tslib_1.__exportStar(require("./whiteboard-tools"), exports);
+tslib_1.__exportStar(require("./ink-overlay"), exports);
+// Wave 9: the SHARED touch gesture brain — pan / pinch / tap / long-press /
+// drag-to-connect / touch-resize. One implementation for the framework-free
+// DomEventBinder AND the Angular wrapper (which used to deep-import it).
+tslib_1.__exportStar(require("./touch-gestures"), exports);
+//# sourceMappingURL=index.js.map

package/src/libs/renderer/src/interaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../renderer/src/interaction/index.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,sCAAsC;;;AAEtC,2DAAiC;AACjC,+DAAqC;AAErC,+EAA+E;AAC/E,wCAAwC;AACxC,mEAAyC;AAEzC,yEAAyE;AACzE,mFAAmF;AACnF,4DAAkC;AAClC,yDAA+B;AAC/B,4DAAkC;AAElC,+EAA+E;AAC/E,+CAA+C;AAC/C,qDAA2B;AAE3B,mEAAmE;AACnE,gEAAsC;AAEtC,oFAAoF;AACpF,4FAA4F;AAC5F,6DAAmC;AACnC,wDAA8B;AAE9B,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,2DAAiC"}

package/src/libs/renderer/src/interaction/ink-overlay.d.ts

@@ -0,0 +1,53 @@
+import type { ViewportController } from '../viewport/viewport-controller';
+export declare const INK_OVERLAY_CLASS = "grafloria-ink-overlay";
+export interface InkOverlayOptions {
+    /** The mounted diagram's root (`.grafloria-diagram-root`). */
+    root: HTMLElement;
+    viewport: ViewportController;
+}
+/** How a preview should look while it is being drawn. */
+export interface InkPreviewStyle {
+    color: string;
+    width: number;
+    opacity?: number;
+    /** Dashed outline, for the rectangle tool's rubber-band. */
+    dashed?: boolean;
+}
+/**
+ * A camera-registered SVG scratch layer for transient drawing feedback.
+ *
+ * Draws in WORLD coordinates: the layer's `<g>` carries the same translate+scale the SVG
+ * layer's viewBox implies, so a pan or a zoom re-registers every preview with ONE transform
+ * write instead of re-projecting points in JS.
+ */
+export declare class InkOverlay {
+    private readonly options;
+    private readonly layer;
+    private readonly world;
+    private readonly doc;
+    private readonly unsubViewport;
+    private disposed;
+    /** Reused elements — updated by attribute, never recreated per pointermove. */
+    private path;
+    private rect;
+    constructor(options: InkOverlayOptions);
+    /** For tests and the a11y audit — the DOM this owns. */
+    get element(): SVGSVGElement;
+    /** SVG transform (unitless) equivalent to the SVG layer's viewBox: world → container px. */
+    private cameraTransform;
+    private ensurePath;
+    private ensureRect;
+    /**
+     * Paint (or repaint) the in-progress freehand line through `points` (world coordinates).
+     * ONE `d` attribute write — no VNode, no frame.
+     */
+    drawPolyline(points: ReadonlyArray<{
+        x: number;
+        y: number;
+    }>, style: InkPreviewStyle): void;
+    /** Paint the rubber-band rectangle for the rectangle tool (world coordinates). */
+    drawRect(x: number, y: number, width: number, height: number, style: InkPreviewStyle): void;
+    /** Remove all preview geometry. Called on pointerup/cancel, once per gesture. */
+    clear(): void;
+    dispose(): void;
+}