@grafloria/element 0.3.17 → 0.3.19

package/src/libs/renderer/src/svg/link-hit-test.d.ts

@@ -0,0 +1,142 @@
+import type { Point } from '@grafloria/engine';
+/**
+ * Part-aware link hit-testing (Wave 1 — Edges & links foundation).
+ *
+ * Classic link hit-testing only answers "was the link hit?". Every downstream
+ * edge feature — inline label editing, endpoint reconnection, edge-toolbar
+ * placement — needs to know WHICH sub-part of the link was hit. This module is
+ * a pure, framework-agnostic geometry primitive that reports the sub-part plus
+ * useful local info (which label, or the 0-1 position along the path).
+ *
+ * It is deliberately side-effect free and model-free: callers pass the already
+ * routed points, label placements, endpoint/arrow anchor points and a query
+ * point, so the same logic can back both the SVG hit-area path and the
+ * interaction-handler's geometric distance checks.
+ */
+/** The sub-part of a link that a query point resolved to. */
+export type LinkPart = 'body' | 'label' | 'source-endpoint' | 'target-endpoint' | 'source-arrow' | 'target-arrow';
+/** Result of a part-aware link hit-test. */
+export interface LinkHitResult {
+    /** Which sub-part of the link was hit. */
+    part: LinkPart;
+    /** Index into the supplied labels array — present only for `part === 'label'`. */
+    labelIndex?: number;
+    /**
+     * Position along the whole path in [0, 1] where the body was hit — present
+     * only for `part === 'body'`. Useful for inserting waypoints / positioning
+     * an edge toolbar on the segment under the cursor.
+     */
+    t?: number;
+    /**
+     * Distance from the query to the winning part's own metric (handle centre,
+     * body path; 0 for inside a label box). For ranking hits ACROSS links.
+     */
+    distance?: number;
+    /**
+     * Distance from the query to this link's BODY path, present whenever the
+     * link has >= 2 points — even when a handle or label won the part. This is
+     * the cross-link tiebreaker: at a shared fan-out anchor every sibling's
+     * endpoint handle is equidistant, but only the link actually under the
+     * cursor has body distance ~0.
+     */
+    bodyDistance?: number;
+}
+/** A label placement, expressed independently of the model. */
+export interface LinkHitLabel {
+    /** Position along the path in [0, 1] (the label's on-path anchor). */
+    position: number;
+    /** Offset of the label box centre from its on-path anchor. */
+    offset?: Point;
+    /** Label box width in world units (falls back to {@link DEFAULT_LABEL_WIDTH}). */
+    width?: number;
+    /** Label box height in world units (falls back to {@link DEFAULT_LABEL_HEIGHT}). */
+    height?: number;
+}
+/** Inputs describing a single link's geometry for hit-testing. */
+export interface LinkHitTestOptions {
+    /** Routed points of the link, in world coordinates (>= 2 for a body). */
+    points: Point[];
+    /** Label placements, in render order (later entries drawn on top). */
+    labels?: LinkHitLabel[];
+    /** Source endpoint anchor (defaults to `points[0]`). Pass `null` to disable. */
+    sourceEndpoint?: Point | null;
+    /** Target endpoint anchor (defaults to last point). Pass `null` to disable. */
+    targetEndpoint?: Point | null;
+    /** Source arrowhead anchor. Omit / `null` when there is no source arrow. */
+    sourceArrow?: Point | null;
+    /** Target arrowhead anchor. Omit / `null` when there is no target arrow. */
+    targetArrow?: Point | null;
+    /** Grab radius around endpoint anchors (default {@link DEFAULT_ENDPOINT_RADIUS}). */
+    endpointRadius?: number;
+    /** Grab radius around arrowhead anchors (default {@link DEFAULT_ARROW_RADIUS}). */
+    arrowRadius?: number;
+    /** Fallback label box width when a label omits one. */
+    defaultLabelWidth?: number;
+    /** Fallback label box height when a label omits one. */
+    defaultLabelHeight?: number;
+}
+export declare const DEFAULT_ENDPOINT_RADIUS = 8;
+export declare const DEFAULT_ARROW_RADIUS = 10;
+export declare const DEFAULT_LABEL_WIDTH = 40;
+export declare const DEFAULT_LABEL_HEIGHT = 18;
+/**
+ * Grab distance (WORLD units) for a link body — "how close to the line counts
+ * as clicking it".
+ *
+ * Exported because it is now a CROSS-BACKEND contract, not an implementation
+ * detail of one hit path: `InteractionController` applies it to resolve a link
+ * in SVG mode, and the Canvas backend strokes each link's pick region with
+ * exactly `2 x` this width on the colour-keyed hit canvas. If the two ever
+ * disagreed, switching backend would change which link is under the cursor.
+ * (It was previously a bare `5` inlined in the controller.)
+ *
+ * This is the FLOOR, not the whole contract — see {@link linkBodyHitTolerance}.
+ */
+export declare const DEFAULT_LINK_HIT_TOLERANCE = 5;
+/** Default width of the SVG renderer's transparent interaction stroke. */
+export declare const DEFAULT_LINK_HIT_AREA_WIDTH = 12;
+/**
+ * Width of the invisible "interaction stroke" painted along a link.
+ *
+ * Sized from the LITERAL stroke width, never a `var(--…)` expression — the
+ * renderer resolves its literals before calling this. The `+ 8` keeps a grab
+ * margin around fat strokes (a 10px casing would otherwise be pixel-hunting).
+ */
+export declare function linkHitAreaWidth(literalStrokeWidth: number, configWidth?: number): number;
+/**
+ * The grab distance for a link BODY — the one number the painted invitation
+ * and the accepted press must both derive from.
+ *
+ * The SVG renderer paints a transparent hit-area stroke `linkHitAreaWidth`
+ * wide, but the interaction layer used to accept only the flat 5px floor: the
+ * ring between them was DEAD — the DOM caught the pointer (cursor, native
+ * focus — the "rectangle around the line" report) while the press selected
+ * nothing. Every consumer of "how close is close enough to a link" now calls
+ * this: the interaction controller (SVG mode), the canvas pick-buffer stroke,
+ * and the hit-area painter (at exactly `2 x` this, minus slop).
+ *
+ * `literalStrokeWidth` must be the resolved numeric width (fall back to 2 for
+ * theme-bound `var(--…)` widths, matching the renderer's own literal
+ * fallback).
+ */
+export declare function linkBodyHitTolerance(literalStrokeWidth: number, configWidth?: number): number;
+/**
+ * Arc-length interpolation of a point at position `t` (0-1) along a polyline.
+ * Mirrors {@link LinkModel.getPointAtPosition}'s polyline fallback so label
+ * anchors line up with what the renderer draws. Returns `null` for < 2 points.
+ */
+export declare function pointAtPositionOnPolyline(points: Point[], t: number): Point | null;
+/**
+ * Part-aware link hit-test.
+ *
+ * Precedence (highest first): endpoint / arrow handles (small grab radius) >
+ * labels (bounding box) > body (near the path). Within the handle tier the
+ * nearest handle wins, tie-broken by declaration order
+ * (source-endpoint, target-endpoint, source-arrow, target-arrow).
+ *
+ * @param options  the link geometry to test against
+ * @param query    the world-space point to test
+ * @param tolerance grab distance for the body (and label box padding)
+ * @returns the hit part with local info, or `null` when nothing is within reach
+ */
+export declare function hitTestLink(options: LinkHitTestOptions, query: Point, tolerance: number): LinkHitResult | null;

package/src/libs/renderer/src/svg/link-hit-test.js

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LINK_HIT_AREA_WIDTH = exports.DEFAULT_LINK_HIT_TOLERANCE = exports.DEFAULT_LABEL_HEIGHT = exports.DEFAULT_LABEL_WIDTH = exports.DEFAULT_ARROW_RADIUS = exports.DEFAULT_ENDPOINT_RADIUS = void 0;
+exports.linkHitAreaWidth = linkHitAreaWidth;
+exports.linkBodyHitTolerance = linkBodyHitTolerance;
+exports.pointAtPositionOnPolyline = pointAtPositionOnPolyline;
+exports.hitTestLink = hitTestLink;
+exports.DEFAULT_ENDPOINT_RADIUS = 8;
+exports.DEFAULT_ARROW_RADIUS = 10;
+exports.DEFAULT_LABEL_WIDTH = 40;
+exports.DEFAULT_LABEL_HEIGHT = 18;
+/**
+ * Grab distance (WORLD units) for a link body — "how close to the line counts
+ * as clicking it".
+ *
+ * Exported because it is now a CROSS-BACKEND contract, not an implementation
+ * detail of one hit path: `InteractionController` applies it to resolve a link
+ * in SVG mode, and the Canvas backend strokes each link's pick region with
+ * exactly `2 x` this width on the colour-keyed hit canvas. If the two ever
+ * disagreed, switching backend would change which link is under the cursor.
+ * (It was previously a bare `5` inlined in the controller.)
+ *
+ * This is the FLOOR, not the whole contract — see {@link linkBodyHitTolerance}.
+ */
+exports.DEFAULT_LINK_HIT_TOLERANCE = 5;
+/** Default width of the SVG renderer's transparent interaction stroke. */
+exports.DEFAULT_LINK_HIT_AREA_WIDTH = 12;
+/**
+ * Width of the invisible "interaction stroke" painted along a link.
+ *
+ * Sized from the LITERAL stroke width, never a `var(--…)` expression — the
+ * renderer resolves its literals before calling this. The `+ 8` keeps a grab
+ * margin around fat strokes (a 10px casing would otherwise be pixel-hunting).
+ */
+function linkHitAreaWidth(literalStrokeWidth, configWidth = exports.DEFAULT_LINK_HIT_AREA_WIDTH) {
+    return Math.max(configWidth, literalStrokeWidth + 8);
+}
+/**
+ * The grab distance for a link BODY — the one number the painted invitation
+ * and the accepted press must both derive from.
+ *
+ * The SVG renderer paints a transparent hit-area stroke `linkHitAreaWidth`
+ * wide, but the interaction layer used to accept only the flat 5px floor: the
+ * ring between them was DEAD — the DOM caught the pointer (cursor, native
+ * focus — the "rectangle around the line" report) while the press selected
+ * nothing. Every consumer of "how close is close enough to a link" now calls
+ * this: the interaction controller (SVG mode), the canvas pick-buffer stroke,
+ * and the hit-area painter (at exactly `2 x` this, minus slop).
+ *
+ * `literalStrokeWidth` must be the resolved numeric width (fall back to 2 for
+ * theme-bound `var(--…)` widths, matching the renderer's own literal
+ * fallback).
+ */
+function linkBodyHitTolerance(literalStrokeWidth, configWidth = exports.DEFAULT_LINK_HIT_AREA_WIDTH) {
+    return Math.max(exports.DEFAULT_LINK_HIT_TOLERANCE, linkHitAreaWidth(literalStrokeWidth, configWidth) / 2);
+}
+/**
+ * Arc-length interpolation of a point at position `t` (0-1) along a polyline.
+ * Mirrors {@link LinkModel.getPointAtPosition}'s polyline fallback so label
+ * anchors line up with what the renderer draws. Returns `null` for < 2 points.
+ */
+function pointAtPositionOnPolyline(points, t) {
+    if (points.length === 0)
+        return null;
+    if (points.length === 1)
+        return Object.assign({}, points[0]);
+    const clamped = Math.max(0, Math.min(1, t));
+    let total = 0;
+    for (let i = 0; i < points.length - 1; i++) {
+        total += Math.hypot(points[i + 1].x - points[i].x, points[i + 1].y - points[i].y);
+    }
+    if (total <= 0)
+        return Object.assign({}, points[0]);
+    let remaining = total * clamped;
+    for (let i = 0; i < points.length - 1; i++) {
+        const a = points[i];
+        const b = points[i + 1];
+        const segLen = Math.hypot(b.x - a.x, b.y - a.y);
+        if (remaining <= segLen) {
+            const st = segLen > 0 ? remaining / segLen : 0;
+            return { x: a.x + (b.x - a.x) * st, y: a.y + (b.y - a.y) * st };
+        }
+        remaining -= segLen;
+    }
+    return Object.assign({}, points[points.length - 1]);
+}
+/** Closest-point projection of `q` onto segment `a`->`b`. */
+function projectOntoSegment(q, a, b) {
+    const dx = b.x - a.x;
+    const dy = b.y - a.y;
+    const lenSq = dx * dx + dy * dy;
+    let s = lenSq === 0 ? 0 : ((q.x - a.x) * dx + (q.y - a.y) * dy) / lenSq;
+    s = Math.max(0, Math.min(1, s));
+    const cx = a.x + s * dx;
+    const cy = a.y + s * dy;
+    return { distance: Math.hypot(q.x - cx, q.y - cy), s };
+}
+/**
+ * Part-aware link hit-test.
+ *
+ * Precedence (highest first): endpoint / arrow handles (small grab radius) >
+ * labels (bounding box) > body (near the path). Within the handle tier the
+ * nearest handle wins, tie-broken by declaration order
+ * (source-endpoint, target-endpoint, source-arrow, target-arrow).
+ *
+ * @param options  the link geometry to test against
+ * @param query    the world-space point to test
+ * @param tolerance grab distance for the body (and label box padding)
+ * @returns the hit part with local info, or `null` when nothing is within reach
+ */
+function hitTestLink(options, query, tolerance) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+    const { points } = options;
+    // Body distance first — it annotates EVERY hit (see LinkHitResult.bodyDistance).
+    let bodyDistance;
+    let bodyArcLength = 0;
+    let bodyTotalLength = 0;
+    if (points.length >= 2) {
+        let best = Infinity;
+        let cumulative = 0;
+        for (let i = 0; i < points.length - 1; i++) {
+            const segLen = Math.hypot(points[i + 1].x - points[i].x, points[i + 1].y - points[i].y);
+            const { distance, s } = projectOntoSegment(query, points[i], points[i + 1]);
+            if (distance < best) {
+                best = distance;
+                bodyArcLength = cumulative + s * segLen;
+            }
+            cumulative += segLen;
+        }
+        bodyTotalLength = cumulative;
+        bodyDistance = best;
+    }
+    const endpointRadius = (_a = options.endpointRadius) !== null && _a !== void 0 ? _a : exports.DEFAULT_ENDPOINT_RADIUS;
+    const arrowRadius = (_b = options.arrowRadius) !== null && _b !== void 0 ? _b : exports.DEFAULT_ARROW_RADIUS;
+    const labelW = (_c = options.defaultLabelWidth) !== null && _c !== void 0 ? _c : exports.DEFAULT_LABEL_WIDTH;
+    const labelH = (_d = options.defaultLabelHeight) !== null && _d !== void 0 ? _d : exports.DEFAULT_LABEL_HEIGHT;
+    // --- Tier 1: endpoint / arrow handles (nearest within its radius wins) ---
+    const sourceEndpoint = options.sourceEndpoint === undefined ? points[0] : options.sourceEndpoint;
+    const targetEndpoint = options.targetEndpoint === undefined
+        ? points[points.length - 1]
+        : options.targetEndpoint;
+    const handles = [
+        { part: 'source-endpoint', point: sourceEndpoint, radius: endpointRadius },
+        { part: 'target-endpoint', point: targetEndpoint, radius: endpointRadius },
+        { part: 'source-arrow', point: options.sourceArrow, radius: arrowRadius },
+        { part: 'target-arrow', point: options.targetArrow, radius: arrowRadius },
+    ];
+    let bestHandle = null;
+    for (const handle of handles) {
+        if (!handle.point)
+            continue;
+        const distance = Math.hypot(query.x - handle.point.x, query.y - handle.point.y);
+        if (distance <= handle.radius && (bestHandle === null || distance < bestHandle.distance)) {
+            bestHandle = { part: handle.part, distance };
+        }
+    }
+    if (bestHandle)
+        return { part: bestHandle.part, distance: bestHandle.distance, bodyDistance };
+    // --- Tier 2: labels (bounding box, topmost-drawn first) ---
+    if (options.labels && options.labels.length > 0) {
+        for (let i = options.labels.length - 1; i >= 0; i--) {
+            const label = options.labels[i];
+            const anchor = pointAtPositionOnPolyline(points, label.position);
+            if (!anchor)
+                continue;
+            const cx = anchor.x + ((_f = (_e = label.offset) === null || _e === void 0 ? void 0 : _e.x) !== null && _f !== void 0 ? _f : 0);
+            const cy = anchor.y + ((_h = (_g = label.offset) === null || _g === void 0 ? void 0 : _g.y) !== null && _h !== void 0 ? _h : 0);
+            const halfW = ((_j = label.width) !== null && _j !== void 0 ? _j : labelW) / 2 + tolerance;
+            const halfH = ((_k = label.height) !== null && _k !== void 0 ? _k : labelH) / 2 + tolerance;
+            if (Math.abs(query.x - cx) <= halfW && Math.abs(query.y - cy) <= halfH) {
+                return { part: 'label', labelIndex: i, distance: 0, bodyDistance };
+            }
+        }
+    }
+    // --- Tier 3: body (nearest point on the polyline; computed above) ---
+    if (bodyDistance !== undefined && bodyDistance <= tolerance) {
+        const t = bodyTotalLength > 0 ? bodyArcLength / bodyTotalLength : 0;
+        return { part: 'body', t, distance: bodyDistance, bodyDistance };
+    }
+    return null;
+}
+//# sourceMappingURL=link-hit-test.js.map

package/src/libs/renderer/src/svg/link-hit-test.js.map

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

package/src/libs/renderer/src/svg/motion-tracker.d.ts

@@ -0,0 +1,18 @@
+import type { Rect } from './route-memo';
+export declare class MotionTracker {
+    /** Rects as of the previous observed frame. */
+    private prev;
+    /** Nodes whose rect changed in the previous frame's diff. */
+    private prevMoved;
+    /** Nodes whose rect changed this frame AND last — continuous motion. */
+    private inMotion;
+    /**
+     * Observe a frame. `rects` is only read, never mutated — sharing the map the
+     * route memo takes ownership of is safe.
+     */
+    beginFrame(rects: Map<string, Rect>): void;
+    isInMotion(id: string): boolean;
+    /** True while anything at all is mid-animation. */
+    get hasMotion(): boolean;
+    clear(): void;
+}

package/src/libs/renderer/src/svg/motion-tracker.js

@@ -0,0 +1,71 @@
+"use strict";
+// Motion-stable routing — WHO is currently animating?
+//
+// The route pipeline re-decides obstacle detours from scratch every frame, which
+// is correct at rest and visibly WRONG during continuous motion: while a tween or
+// drag sweeps node bodies through link chords, the straight-router links snap
+// between shape classes (direct cubic ↔ detour spline ↔ rounded-orthogonal) —
+// measured at 17 flips / 22 discontinuity events in one 900ms 8-node tween on
+// demos/nodes/node-position-animation.html, worst flip 327px in a 21px frame.
+//
+// This tracker supplies the one fact the suppression needs: which nodes are IN
+// MOTION — meaning their rect changed in TWO consecutive observed frames. Two,
+// not one: a single `setPosition` + render is a programmatic jump whose very
+// frame must keep today's detour behaviour (unit tests and hosts rely on it); a
+// tween or drag writes every frame, so it earns the streak on its second frame
+// and loses it on the first still frame — which is exactly the settle frame
+// where the proper route returns.
+//
+// Fed from `invalidateStaleRoutes()` with the same per-frame rect map the route
+// memo diffs, so it costs one extra Map scan per painted frame and nothing at all
+// on gated (skipped) frames — a frame nobody painted moved nobody.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MotionTracker = void 0;
+class MotionTracker {
+    constructor() {
+        /** Rects as of the previous observed frame. */
+        this.prev = new Map();
+        /** Nodes whose rect changed in the previous frame's diff. */
+        this.prevMoved = new Set();
+        /** Nodes whose rect changed this frame AND last — continuous motion. */
+        this.inMotion = new Set();
+    }
+    /**
+     * Observe a frame. `rects` is only read, never mutated — sharing the map the
+     * route memo takes ownership of is safe.
+     */
+    beginFrame(rects) {
+        const moved = new Set();
+        for (const [id, now] of rects) {
+            const before = this.prev.get(id);
+            if (before &&
+                (before.x !== now.x ||
+                    before.y !== now.y ||
+                    before.width !== now.width ||
+                    before.height !== now.height)) {
+                moved.add(id);
+            }
+        }
+        this.inMotion.clear();
+        for (const id of moved) {
+            if (this.prevMoved.has(id))
+                this.inMotion.add(id);
+        }
+        this.prevMoved = moved;
+        this.prev = rects;
+    }
+    isInMotion(id) {
+        return this.inMotion.has(id);
+    }
+    /** True while anything at all is mid-animation. */
+    get hasMotion() {
+        return this.inMotion.size > 0;
+    }
+    clear() {
+        this.prev.clear();
+        this.prevMoved.clear();
+        this.inMotion.clear();
+    }
+}
+exports.MotionTracker = MotionTracker;
+//# sourceMappingURL=motion-tracker.js.map

package/src/libs/renderer/src/svg/motion-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-tracker.js","sourceRoot":"","sources":["../../../../../../renderer/src/svg/motion-tracker.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,EAAE;AACF,iFAAiF;AACjF,kFAAkF;AAClF,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,EAAE;AACF,+EAA+E;AAC/E,+EAA+E;AAC/E,6EAA6E;AAC7E,gFAAgF;AAChF,+EAA+E;AAC/E,4EAA4E;AAC5E,kCAAkC;AAClC,EAAE;AACF,gFAAgF;AAChF,kFAAkF;AAClF,mEAAmE;;;AAInE,MAAa,aAAa;IAA1B;QACE,+CAA+C;QACvC,SAAI,GAAG,IAAI,GAAG,EAAgB,CAAC;QACvC,6DAA6D;QACrD,cAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACtC,wEAAwE;QAChE,aAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IA2CvC,CAAC;IAzCC;;;OAGG;IACH,UAAU,CAAC,KAAwB;QACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjC,IACE,MAAM;gBACN,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;oBACjB,MAAM,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;oBAClB,MAAM,CAAC,KAAK,KAAK,GAAG,CAAC,KAAK;oBAC1B,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,EAC/B,CAAC;gBACD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,mDAAmD;IACnD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AAjDD,sCAiDC"}

package/src/libs/renderer/src/svg/node-sizing.d.ts

@@ -0,0 +1,51 @@
+import type { NodeModel } from '@grafloria/engine';
+/**
+ * Sizing constraints for a single node. Every field is optional; an absent
+ * field means "no constraint" (the global resizer minimum still applies as a
+ * safety floor).
+ */
+export interface NodeSizing {
+    /** Content-aware auto-sizing: the node grows to fit its label + panel. */
+    auto?: boolean;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    /**
+     * Aspect lock. `true` locks to the node's CURRENT width/height ratio; a number
+     * locks to that explicit width÷height ratio. Honored during a resize gesture
+     * even without the Shift modifier.
+     */
+    aspectLock?: boolean | number;
+    /** Content padding (px) reserved around the label when auto-sizing. */
+    padding?: number;
+}
+/** Read a node's sizing config (never null — an absent config is `{}`). */
+export declare function getNodeSizing(node: NodeModel): NodeSizing;
+/** True when the node opts into content-aware auto-sizing. */
+export declare function isAutoSized(node: NodeModel): boolean;
+/**
+ * The explicit aspect ratio (w÷h) a node is locked to, or null when unlocked.
+ * `aspectLock: true` resolves against a supplied current size.
+ */
+export declare function resolveAspectRatio(sizing: NodeSizing, current?: {
+    width: number;
+    height: number;
+}): number | null;
+/** Clamp a scalar into `[min, max]`, tolerating an inverted or absent bound. */
+export declare function clampValue(value: number, min?: number, max?: number): number;
+export interface ClampOptions {
+    /** Global floor applied when the node declares no `minWidth`/`minHeight`. */
+    floorWidth?: number;
+    floorHeight?: number;
+}
+/**
+ * Clamp a candidate width/height to a node's sizing constraints. The per-node
+ * min/max win; a global floor (the resizer's `minWidth`/`minHeight`) fills in
+ * when the node sets none. Used identically by the resizer and the auto-sizer,
+ * so both cannot disagree about the legal range.
+ */
+export declare function clampSizeToConstraints(width: number, height: number, sizing: NodeSizing, opts?: ClampOptions): {
+    width: number;
+    height: number;
+};

package/src/libs/renderer/src/svg/node-sizing.js

@@ -0,0 +1,65 @@
+"use strict";
+// Per-node sizing constraints (Wave 5 / Nodes & shapes — shared by Card 6 + 7)
+//
+// One config seam owns every "how big may this node be" rule: the interactive
+// resizer (Card 6) reads it to clamp a drag DURING the gesture, and the
+// content-aware auto-sizer (Card 7) reads it to floor/ceil a computed desired
+// size. Keeping it in ONE place is deliberate — the two features must agree
+// about a node's min/max, or a user could drag a node to a size auto-sizing
+// would immediately fight.
+//
+// It lives on `node.metadata.sizing` so it serializes for free (metadata is part
+// of SerializedNode) and needs no NodeModel schema change.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeSizing = getNodeSizing;
+exports.isAutoSized = isAutoSized;
+exports.resolveAspectRatio = resolveAspectRatio;
+exports.clampValue = clampValue;
+exports.clampSizeToConstraints = clampSizeToConstraints;
+/** Read a node's sizing config (never null — an absent config is `{}`). */
+function getNodeSizing(node) {
+    const raw = node.getMetadata('sizing');
+    return raw && typeof raw === 'object' ? raw : {};
+}
+/** True when the node opts into content-aware auto-sizing. */
+function isAutoSized(node) {
+    return getNodeSizing(node).auto === true;
+}
+/**
+ * The explicit aspect ratio (w÷h) a node is locked to, or null when unlocked.
+ * `aspectLock: true` resolves against a supplied current size.
+ */
+function resolveAspectRatio(sizing, current) {
+    if (typeof sizing.aspectLock === 'number' && sizing.aspectLock > 0) {
+        return sizing.aspectLock;
+    }
+    if (sizing.aspectLock === true && current && current.height > 0) {
+        return current.width / current.height;
+    }
+    return null;
+}
+/** Clamp a scalar into `[min, max]`, tolerating an inverted or absent bound. */
+function clampValue(value, min, max) {
+    let out = value;
+    if (typeof max === 'number' && isFinite(max))
+        out = Math.min(out, max);
+    if (typeof min === 'number' && isFinite(min))
+        out = Math.max(out, min);
+    return out;
+}
+/**
+ * Clamp a candidate width/height to a node's sizing constraints. The per-node
+ * min/max win; a global floor (the resizer's `minWidth`/`minHeight`) fills in
+ * when the node sets none. Used identically by the resizer and the auto-sizer,
+ * so both cannot disagree about the legal range.
+ */
+function clampSizeToConstraints(width, height, sizing, opts = {}) {
+    var _a, _b;
+    const minW = (_a = sizing.minWidth) !== null && _a !== void 0 ? _a : opts.floorWidth;
+    const minH = (_b = sizing.minHeight) !== null && _b !== void 0 ? _b : opts.floorHeight;
+    return {
+        width: clampValue(width, minW, sizing.maxWidth),
+        height: clampValue(height, minH, sizing.maxHeight),
+    };
+}
+//# sourceMappingURL=node-sizing.js.map

package/src/libs/renderer/src/svg/node-sizing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-sizing.js","sourceRoot":"","sources":["../../../../../../renderer/src/svg/node-sizing.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,EAAE;AACF,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,2BAA2B;AAC3B,EAAE;AACF,iFAAiF;AACjF,2DAA2D;;AA2B3D,sCAGC;AAGD,kCAEC;AAMD,gDAWC;AAGD,gCAKC;AAcD,wDAYC;AA5DD,2EAA2E;AAC3E,SAAgB,aAAa,CAAC,IAAe;IAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACvC,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,8DAA8D;AAC9D,SAAgB,WAAW,CAAC,IAAe;IACzC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAChC,MAAkB,EAClB,OAA2C;IAE3C,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QACnE,OAAO,MAAM,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,OAAO,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,SAAgB,UAAU,CAAC,KAAa,EAAE,GAAY,EAAE,GAAY;IAClE,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvE,OAAO,GAAG,CAAC;AACb,CAAC;AAQD;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,KAAa,EACb,MAAc,EACd,MAAkB,EAClB,OAAqB,EAAE;;IAEvB,MAAM,IAAI,GAAG,MAAA,MAAM,CAAC,QAAQ,mCAAI,IAAI,CAAC,UAAU,CAAC;IAChD,MAAM,IAAI,GAAG,MAAA,MAAM,CAAC,SAAS,mCAAI,IAAI,CAAC,WAAW,CAAC;IAClD,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC;QAC/C,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/src/libs/renderer/src/svg/node-toolbar.d.ts

@@ -0,0 +1,30 @@
+import type { NodeModel } from '@grafloria/engine';
+/** The Halo context-toolbar actions a node may expose. */
+export type ToolbarHaloAction = 'connect' | 'clone' | 'fork' | 'delete';
+/**
+ * Per-node tool visibility. Every field is optional; an absent field means "use
+ * the controller's global default". `halo: true` → all actions, an array → only
+ * those actions, `false` → no halo.
+ */
+export interface NodeToolbarConfig {
+    resize?: boolean;
+    rotate?: boolean;
+    remove?: boolean;
+    halo?: boolean | ToolbarHaloAction[];
+}
+/** A per-TYPE policy the host installs on the controller. */
+export type ToolbarResolver = (node: NodeModel) => NodeToolbarConfig | undefined;
+/** Read a node's own toolbar config from metadata, or undefined. */
+export declare function getNodeToolbar(node: NodeModel): NodeToolbarConfig | undefined;
+/**
+ * The effective toolbar config for a node: the node's own metadata, with a
+ * host-supplied resolver (per-type policy) layered on top.
+ */
+export declare function resolveToolbar(node: NodeModel, resolver?: ToolbarResolver): NodeToolbarConfig;
+/** Whether a boolean tool (resize / rotate / remove) is enabled; `def` when unset. */
+export declare function toolbarAllows(config: NodeToolbarConfig, tool: 'resize' | 'rotate' | 'remove', def?: boolean): boolean;
+/**
+ * Whether a Halo action is enabled: `undefined` → `def`, `false` → never,
+ * `true` → always, an array → membership.
+ */
+export declare function haloAllows(config: NodeToolbarConfig, action: ToolbarHaloAction, def?: boolean): boolean;

package/src/libs/renderer/src/svg/node-toolbar.js

@@ -0,0 +1,45 @@
+"use strict";
+// Per-node toolbar configuration (Wave 5 / Nodes & shapes — Card 6)
+//
+// Which floating tools appear around a selected node — the 8 resize handles, the
+// rotate handle, the remove button, and which Halo actions — should be a
+// per-node / per-type decision, not one global switch. A sticky-note node might
+// allow resize but not rotate; a locked "system" node might show only the Halo
+// `connect`. This config seam lets a node declare that on `metadata.toolbar`
+// (serializes for free), with a controller-level resolver for per-TYPE policy.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeToolbar = getNodeToolbar;
+exports.resolveToolbar = resolveToolbar;
+exports.toolbarAllows = toolbarAllows;
+exports.haloAllows = haloAllows;
+/** Read a node's own toolbar config from metadata, or undefined. */
+function getNodeToolbar(node) {
+    const raw = node.getMetadata('toolbar');
+    return raw && typeof raw === 'object' ? raw : undefined;
+}
+/**
+ * The effective toolbar config for a node: the node's own metadata, with a
+ * host-supplied resolver (per-type policy) layered on top.
+ */
+function resolveToolbar(node, resolver) {
+    var _a, _b;
+    return Object.assign(Object.assign({}, ((_a = getNodeToolbar(node)) !== null && _a !== void 0 ? _a : {})), ((_b = resolver === null || resolver === void 0 ? void 0 : resolver(node)) !== null && _b !== void 0 ? _b : {}));
+}
+/** Whether a boolean tool (resize / rotate / remove) is enabled; `def` when unset. */
+function toolbarAllows(config, tool, def = true) {
+    const v = config[tool];
+    return v === undefined ? def : v !== false;
+}
+/**
+ * Whether a Halo action is enabled: `undefined` → `def`, `false` → never,
+ * `true` → always, an array → membership.
+ */
+function haloAllows(config, action, def = true) {
+    const h = config.halo;
+    if (h === undefined)
+        return def;
+    if (typeof h === 'boolean')
+        return h;
+    return h.includes(action);
+}
+//# sourceMappingURL=node-toolbar.js.map

package/src/libs/renderer/src/svg/node-toolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-toolbar.js","sourceRoot":"","sources":["../../../../../../renderer/src/svg/node-toolbar.ts"],"names":[],"mappings":";AAAA,oEAAoE;AACpE,EAAE;AACF,iFAAiF;AACjF,yEAAyE;AACzE,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;;AAuB/E,wCAGC;AAMD,wCAEC;AAGD,sCAOC;AAMD,gCASC;AArCD,oEAAoE;AACpE,SAAgB,cAAc,CAAC,IAAe;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAAyB,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,IAAe,EAAE,QAA0B;;IACxE,uCAAY,CAAC,MAAA,cAAc,CAAC,IAAI,CAAC,mCAAI,EAAE,CAAC,GAAK,CAAC,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAG,IAAI,CAAC,mCAAI,EAAE,CAAC,EAAG;AAC1E,CAAC;AAED,sFAAsF;AACtF,SAAgB,aAAa,CAC3B,MAAyB,EACzB,IAAoC,EACpC,GAAG,GAAG,IAAI;IAEV,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CACxB,MAAyB,EACzB,MAAyB,EACzB,GAAG,GAAG,IAAI;IAEV,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IACtB,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IAChC,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/src/libs/renderer/src/svg/notation-shapes.d.ts

@@ -0,0 +1,2 @@
+/** Register every notation shape that the base registry does not already own. */
+export declare function registerNotationShapes(): void;