@grafloria/element 0.3.18 → 0.3.19

package/src/libs/renderer/src/svg/notation-shapes.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerNotationShapes = registerNotationShapes;
+/**
+ * The notation silhouettes the base registry was missing.
+ *
+ * Group B of the stencil fidelity audit: nine masters had no shape to point at,
+ * so they fell back to a rectangle — a Delay looked like a Process, a Weak
+ * Entity like a plain Entity, an ISA triangle like a box. Each is registered
+ * through the PUBLIC `registerPathShape` seam (the same one the shapes demo uses
+ * for its star), so links attach to the real outline rather than a bounding box.
+ *
+ * The double-outline family (weak entity / weak relationship / multivalued
+ * attribute) is the Chen-notation convention for "existence-dependent": the
+ * inner outline is inset by {@link DOUBLE_INSET} px.
+ */
+const shape_registry_1 = require("./shape-registry");
+/** Gap between the two outlines of a "double" ERD shape. */
+const DOUBLE_INSET = 5;
+const rectPath = (x, y, w, h) => `M ${x} ${y} L ${x + w} ${y} L ${x + w} ${y + h} L ${x} ${y + h} Z`;
+const diamondPath = (x, y, w, h) => `M ${x + w / 2} ${y} L ${x + w} ${y + h / 2} L ${x + w / 2} ${y + h} L ${x} ${y + h / 2} Z`;
+/** An axis-aligned ellipse as two arcs (path form, so it composes with insets). */
+const ellipsePath = (cx, cy, rx, ry) => `M ${cx - rx} ${cy} A ${rx} ${ry} 0 1 0 ${cx + rx} ${cy} A ${rx} ${ry} 0 1 0 ${cx - rx} ${cy} Z`;
+/** The same ellipse wound the OTHER way (sweep 1) — a nonzero-rule fill HOLE. */
+const ellipsePathCCW = (cx, cy, rx, ry) => `M ${cx - rx} ${cy} A ${rx} ${ry} 0 1 1 ${cx + rx} ${cy} A ${rx} ${ry} 0 1 1 ${cx - rx} ${cy} Z`;
+/** Register every notation shape that the base registry does not already own. */
+function registerNotationShapes() {
+    // ── Flowchart ──────────────────────────────────────────────────────────────
+    // Delay: a rectangle whose RIGHT edge is a half-round cap (ISO 5807).
+    define('delay', (w, h) => {
+        const r = h / 2;
+        return `M 0 0 L ${w - r} 0 A ${r} ${r} 0 0 1 ${w - r} ${h} L 0 ${h} Z`;
+    });
+    // Display: left edge swept inward, right edge rounded — the CRT/monitor glyph.
+    define('display', (w, h) => {
+        const r = h / 2;
+        const lead = Math.min(w * 0.18, r);
+        return `M ${lead} 0 L ${w - r} 0 A ${r} ${r} 0 0 1 ${w - r} ${h} L ${lead} ${h} Q 0 ${h / 2} ${lead} 0 Z`;
+    });
+    // Summing junction: a circle crossed by its two diagonals (✕).
+    define('summing-junction', (w, h) => {
+        const r = Math.min(w, h) / 2, cx = w / 2, cy = h / 2, d = r * Math.SQRT1_2;
+        return `${ellipsePath(cx, cy, r, r)} M ${cx - d} ${cy - d} L ${cx + d} ${cy + d} M ${cx + d} ${cy - d} L ${cx - d} ${cy + d}`;
+    });
+    // OR: a circle crossed by its vertical and horizontal axes (✚).
+    define('or-junction', (w, h) => {
+        const r = Math.min(w, h) / 2, cx = w / 2, cy = h / 2;
+        return `${ellipsePath(cx, cy, r, r)} M ${cx - r} ${cy} L ${cx + r} ${cy} M ${cx} ${cy - r} L ${cx} ${cy + r}`;
+    });
+    // ── UML activity ───────────────────────────────────────────────────────────
+    // Fork / join: a solid synchronisation BAR, not a full-height box. Kept as a
+    // band centred in the node box so the node can still be sized normally.
+    define('sync-bar', (w, h) => {
+        const t = Math.max(4, Math.min(h, 8)); // bar thickness
+        const y = (h - t) / 2;
+        return rectPath(0, y, w, t);
+    });
+    // ── ERD (Chen) double outlines ─────────────────────────────────────────────
+    define('double-rect', (w, h) => `${rectPath(0, 0, w, h)} ${rectPath(DOUBLE_INSET, DOUBLE_INSET, w - DOUBLE_INSET * 2, h - DOUBLE_INSET * 2)}`);
+    define('double-diamond', (w, h) => `${diamondPath(0, 0, w, h)} ${diamondPath(DOUBLE_INSET, DOUBLE_INSET, w - DOUBLE_INSET * 2, h - DOUBLE_INSET * 2)}`);
+    define('double-ellipse', (w, h) => `${ellipsePath(w / 2, h / 2, w / 2, h / 2)} ${ellipsePath(w / 2, h / 2, w / 2 - DOUBLE_INSET, h / 2 - DOUBLE_INSET)}`);
+    // ── BPMN gateways ──────────────────────────────────────────────────────────
+    // A gateway's IDENTITY is its inner marker, not its caption: exclusive = ✕,
+    // inclusive = ◯ ring, parallel = ＋ (BPMN 2.0 §10.6). The markers are extra
+    // subpaths of the diamond path: line subpaths have zero area, so `fill`
+    // paints only the diamond while `stroke` draws the marker; the ring subpath
+    // is wound the same direction as the diamond, so nonzero filling leaves it
+    // an outline. Links, ports and the caption's geometry delegate to the plain
+    // diamond so the marker never distorts attachment points.
+    const diamondGeom = delegateTo('diamond');
+    define('gateway-xor', (w, h) => {
+        const cx = w / 2, cy = h / 2, a = Math.min(w, h) * 0.18;
+        return `${diamondPath(0, 0, w, h)} M ${r3(cx - a)} ${r3(cy - a)} L ${r3(cx + a)} ${r3(cy + a)} M ${r3(cx + a)} ${r3(cy - a)} L ${r3(cx - a)} ${r3(cy + a)}`;
+    }, diamondGeom);
+    define('gateway-or', (w, h) => {
+        const r = Math.min(w, h) * 0.22;
+        return `${diamondPath(0, 0, w, h)} ${ellipsePath(w / 2, h / 2, r, r)}`;
+    }, diamondGeom);
+    define('gateway-and', (w, h) => {
+        const cx = w / 2, cy = h / 2, a = Math.min(w, h) * 0.24;
+        return `${diamondPath(0, 0, w, h)} M ${r3(cx - a)} ${cy} L ${r3(cx + a)} ${cy} M ${cx} ${r3(cy - a)} L ${cx} ${r3(cy + a)}`;
+    }, diamondGeom);
+    // ── BPMN events ────────────────────────────────────────────────────────────
+    // An intermediate event is a DOUBLE ring (start = thin single, end = thick
+    // single — those two stay `circle` and differ by strokeWidth, which is
+    // template data). Same double-outline device as the Chen shapes; geometry
+    // delegates to the plain circle.
+    define('event-intermediate', (w, h) => {
+        const r = Math.min(w, h) / 2, cx = w / 2, cy = h / 2;
+        const inset = Math.max(3, r * 0.18);
+        return `${ellipsePath(cx, cy, r, r)} ${ellipsePath(cx, cy, r - inset, r - inset)}`;
+    }, delegateTo('circle'));
+    // ── UML final node / final state ───────────────────────────────────────────
+    // A BULLS-EYE: thin outer ring + solid inner dot — what tells a final node
+    // apart from the initial node's plain filled disc. Painted from FILL alone by
+    // WINDING: outer circle clockwise, ring-hole circle COUNTER-clockwise (the
+    // nonzero rule leaves the band between them filled and the gap empty), inner
+    // dot clockwise again. Works with any fill colour the template declares;
+    // stroke should stay thin (it outlines each circle).
+    define('final-node', (w, h) => {
+        const r = Math.min(w, h) / 2, cx = w / 2, cy = h / 2;
+        const band = Math.max(2, r * 0.16); // outer ring line thickness
+        return `${ellipsePath(cx, cy, r, r)} ${ellipsePathCCW(cx, cy, r - band, r - band)} ${ellipsePath(cx, cy, r * 0.5, r * 0.5)}`;
+    }, delegateTo('circle'));
+}
+/** Round to 3 decimals, matching the registry's own vertex formatting. */
+const r3 = (n) => Math.round(n * 1000) / 1000;
+/**
+ * Geometry options that delegate ports / link attachment / label box to an
+ * already-registered base figure — used by shapes whose path carries interior
+ * MARKER subpaths. `registerPathShape` otherwise derives anchors by sampling
+ * every subpath, and a marker in the middle would pull them off the outline.
+ */
+function delegateTo(base) {
+    const def = (0, shape_registry_1.getShapeDefinition)(base);
+    return def
+        ? { portAnchor: def.portAnchor, boundaryPoint: def.boundaryPoint, innerRect: def.innerRect }
+        : {};
+}
+/** Register `type` unless something already owns that name (never clobber). */
+function define(type, path, opts) {
+    if ((0, shape_registry_1.hasShape)(type))
+        return;
+    (0, shape_registry_1.registerPathShape)(type, path, opts);
+}
+//# sourceMappingURL=notation-shapes.js.map

package/src/libs/renderer/src/svg/notation-shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notation-shapes.js","sourceRoot":"","sources":["../../../../../../renderer/src/svg/notation-shapes.ts"],"names":[],"mappings":";;AAsCA,wDA2FC;AAjID;;;;;;;;;;;;GAYG;AACH,qDAK0B;AAE1B,4DAA4D;AAC5D,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,EAAE,CAC9D,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;AAEtE,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,EAAE,CACjE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;AAE9F,mFAAmF;AACnF,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAE,CACrE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;AAEnG,iFAAiF;AACjF,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAE,CACxE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;AAEnG,iFAAiF;AACjF,SAAgB,sBAAsB;IACpC,8EAA8E;IAC9E,sEAAsE;IACtE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,+EAA+E;IAC/E,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QACnC,OAAO,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC;IAC5G,CAAC,CAAC,CAAC;IAEH,+DAA+D;IAC/D,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3E,OAAO,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IAChI,CAAC,CAAC,CAAC;IAEH,gEAAgE;IAChE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACrD,OAAO,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IAChH,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAC9E,6EAA6E;IAC7E,wEAAwE;IACxE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAW,gBAAgB;QACjE,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAC9E,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC7B,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAEjH,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAChC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,YAAY,EAAE,YAAY,EAAE,CAAC,GAAG,YAAY,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAEvH,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAChC,GAAG,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;IAEzH,8EAA8E;IAC9E,4EAA4E;IAC5E,2EAA2E;IAC3E,wEAAwE;IACxE,4EAA4E;IAC5E,2EAA2E;IAC3E,4EAA4E;IAC5E,0DAA0D;IAC1D,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QACxD,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IAC9J,CAAC,EAAE,WAAW,CAAC,CAAC;IAChB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QAChC,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACzE,CAAC,EAAE,WAAW,CAAC,CAAC;IAChB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QACxD,OAAO,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;IAC9H,CAAC,EAAE,WAAW,CAAC,CAAC;IAEhB,8EAA8E;IAC9E,2EAA2E;IAC3E,uEAAuE;IACvE,0EAA0E;IAC1E,iCAAiC;IACjC,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACpC,OAAO,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC;IACrF,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEzB,8EAA8E;IAC9E,2EAA2E;IAC3E,8EAA8E;IAC9E,2EAA2E;IAC3E,6EAA6E;IAC7E,yEAAyE;IACzE,qDAAqD;IACrD,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAU,4BAA4B;QACzE,OAAO,GAAG,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,WAAW,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;IAC/H,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,0EAA0E;AAC1E,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AAEtD;;;;;GAKG;AACH,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,GAAG,GAAG,IAAA,mCAAkB,EAAC,IAAI,CAAC,CAAC;IACrC,OAAO,GAAG;QACR,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE;QAC5F,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,+EAA+E;AAC/E,SAAS,MAAM,CAAC,IAAY,EAAE,IAAsC,EAAE,IAAuB;IAC3F,IAAI,IAAA,yBAAQ,EAAC,IAAI,CAAC;QAAE,OAAO;IAC3B,IAAA,kCAAiB,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/src/libs/renderer/src/svg/paint-servers.d.ts

@@ -0,0 +1,49 @@
+import type { VNode } from '../types';
+import type { LinearGradient, RadialGradient, Pattern, Shadow, GradientStop } from '@grafloria/engine';
+/** A fill/stroke paint that resolves to an SVG paint server (not a colour). */
+export type PaintSpec = LinearGradient | RadialGradient | Pattern;
+/** True when a fill/stroke value is a paint-server spec object (vs a colour string). */
+export declare function isPaintSpec(value: unknown): value is PaintSpec;
+/** True when a `style.shadow` value is a Shadow spec object (vs the legacy boolean). */
+export declare function isShadowSpec(value: unknown): value is Shadow;
+/**
+ * The one flat colour that best stands in for a paint server.
+ *
+ * wave8/culling — Card 4: at a far-zoom LOD tier the renderer stops emitting
+ * paint servers entirely and paints this instead. A gradient across a shape that
+ * is 35x17 CSS pixels resolves to about one colour on the display anyway; what it
+ * costs is a `<defs>` entry, a `url(#…)` indirection, and — the expensive part —
+ * a VNode-cache bypass for every gradient entity in the scene, every frame.
+ *
+ * For a gradient that stand-in is the stop nearest the MIDDLE, not the first one:
+ * a two-stop white→black gradient read as "white" is a bigger visual lie than
+ * reading it as mid-grey, and the middle stop is what the eye integrates to.
+ * For a pattern it is the background it is drawn on — the marks are sub-pixel and
+ * what survives is the field they sit on.
+ */
+export declare function flattenPaint(spec: PaintSpec): string;
+/** Stable `<defs>` element id for a paint/shadow spec (identical specs → same id). */
+export declare function paintDefId(spec: object): string;
+/** A linear gradient in absolute pixel endpoints (userSpaceOnUse), not 0–1. */
+export interface UserSpaceLinear {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    stops: GradientStop[];
+}
+/** A radial gradient with a pixel centre and radius (userSpaceOnUse), not 0–1. */
+export interface UserSpaceRadial {
+    cx: number;
+    cy: number;
+    r: number;
+    stops: GradientStop[];
+}
+/** `<linearGradient gradientUnits="userSpaceOnUse">` with pixel endpoints. */
+export declare function buildLinearGradientUserSpace(id: string, g: UserSpaceLinear): VNode;
+/** `<radialGradient gradientUnits="userSpaceOnUse">` with a pixel centre + radius. */
+export declare function buildRadialGradientUserSpace(id: string, g: UserSpaceRadial): VNode;
+/** Build the `<linearGradient>` / `<radialGradient>` / `<pattern>` def for a paint spec. */
+export declare function buildPaintServerVNode(id: string, spec: PaintSpec): VNode;
+/** Build the `<filter>` (feDropShadow) def for a Shadow spec. */
+export declare function buildShadowFilterVNode(id: string, shadow: Shadow): VNode;

package/src/libs/renderer/src/svg/paint-servers.js

@@ -0,0 +1,225 @@
+"use strict";
+// SVG paint servers (Styling & theming — Card 2)
+//
+// First-class support for gradient / pattern fills and drop-shadow filters.
+// When a node/link `style.fill` or `style.stroke` is a SPEC OBJECT (not a
+// colour string), or `style.shadow` is a Shadow spec, the renderer materialises
+// a `<linearGradient>` / `<radialGradient>` / `<pattern>` / `<filter>` inside a
+// single deduped `<defs>` block and references it via `url(#grafloria-def-<hash>)`.
+//
+// Two identical specs hash to the SAME id, so they share ONE def — the renderer
+// keeps a per-frame Map<id, VNode> and only registers a def the first time it
+// sees that id in a frame.
+//
+// These helpers are PURE (no renderer state) so they can be unit-tested in
+// isolation; the renderer owns the per-frame dedup Map and the resolve() glue.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPaintSpec = isPaintSpec;
+exports.isShadowSpec = isShadowSpec;
+exports.flattenPaint = flattenPaint;
+exports.paintDefId = paintDefId;
+exports.buildLinearGradientUserSpace = buildLinearGradientUserSpace;
+exports.buildRadialGradientUserSpace = buildRadialGradientUserSpace;
+exports.buildPaintServerVNode = buildPaintServerVNode;
+exports.buildShadowFilterVNode = buildShadowFilterVNode;
+const GRADIENT_TYPES = new Set(['linear', 'radial']);
+const PATTERN_TYPES = new Set(['dots', 'lines', 'grid', 'hatch', 'crosshatch']);
+/** True when a fill/stroke value is a paint-server spec object (vs a colour string). */
+function isPaintSpec(value) {
+    if (value == null || typeof value !== 'object')
+        return false;
+    const type = value.type;
+    return typeof type === 'string' && (GRADIENT_TYPES.has(type) || PATTERN_TYPES.has(type));
+}
+/** True when a `style.shadow` value is a Shadow spec object (vs the legacy boolean). */
+function isShadowSpec(value) {
+    return (value != null &&
+        typeof value === 'object' &&
+        typeof value.blur === 'number' &&
+        typeof value.offsetX === 'number');
+}
+/**
+ * The one flat colour that best stands in for a paint server.
+ *
+ * wave8/culling — Card 4: at a far-zoom LOD tier the renderer stops emitting
+ * paint servers entirely and paints this instead. A gradient across a shape that
+ * is 35x17 CSS pixels resolves to about one colour on the display anyway; what it
+ * costs is a `<defs>` entry, a `url(#…)` indirection, and — the expensive part —
+ * a VNode-cache bypass for every gradient entity in the scene, every frame.
+ *
+ * For a gradient that stand-in is the stop nearest the MIDDLE, not the first one:
+ * a two-stop white→black gradient read as "white" is a bigger visual lie than
+ * reading it as mid-grey, and the middle stop is what the eye integrates to.
+ * For a pattern it is the background it is drawn on — the marks are sub-pixel and
+ * what survives is the field they sit on.
+ */
+function flattenPaint(spec) {
+    var _a, _b, _c, _d, _e, _f;
+    if (spec.type === 'linear' || spec.type === 'radial') {
+        const stops = (_a = spec.stops) !== null && _a !== void 0 ? _a : [];
+        if (stops.length === 0)
+            return FLATTEN_FALLBACK;
+        let best = stops[0];
+        let bestDelta = Math.abs(((_b = best.offset) !== null && _b !== void 0 ? _b : 0) - 0.5);
+        for (const stop of stops) {
+            const delta = Math.abs(((_c = stop.offset) !== null && _c !== void 0 ? _c : 0) - 0.5);
+            if (delta < bestDelta) {
+                best = stop;
+                bestDelta = delta;
+            }
+        }
+        return (_d = best.color) !== null && _d !== void 0 ? _d : FLATTEN_FALLBACK;
+    }
+    // Pattern: dots/lines/grid/hatch/crosshatch.
+    return (_f = (_e = spec.backgroundColor) !== null && _e !== void 0 ? _e : spec.color) !== null && _f !== void 0 ? _f : FLATTEN_FALLBACK;
+}
+/** Used only when a spec carries no colour at all — a malformed spec still paints. */
+const FLATTEN_FALLBACK = '#888888';
+// ---------------------------------------------------------------------------
+// Stable hashing — identical specs (regardless of key order) share one def id.
+// ---------------------------------------------------------------------------
+function stableStringify(value) {
+    var _a;
+    if (value === null || typeof value !== 'object')
+        return (_a = JSON.stringify(value)) !== null && _a !== void 0 ? _a : 'null';
+    if (Array.isArray(value))
+        return '[' + value.map(stableStringify).join(',') + ']';
+    const keys = Object.keys(value).sort();
+    return '{' + keys.map((k) => JSON.stringify(k) + ':' + stableStringify(value[k])).join(',') + '}';
+}
+/** FNV-1a 32-bit → base36. Short, stable, collision-resistant enough for def ids. */
+function fnv1a(str) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < str.length; i++) {
+        h ^= str.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(36);
+}
+/** Stable `<defs>` element id for a paint/shadow spec (identical specs → same id). */
+function paintDefId(spec) {
+    return `grafloria-def-${fnv1a(stableStringify(spec))}`;
+}
+// ---------------------------------------------------------------------------
+// VNode builders (pure) — turn a spec + id into the SVG def element.
+// ---------------------------------------------------------------------------
+function buildStops(stops) {
+    return (stops !== null && stops !== void 0 ? stops : []).map((s, i) => ({
+        type: 'stop',
+        key: `stop-${i}`,
+        props: Object.assign({ offset: s.offset, 'stop-color': s.color }, (s.opacity !== undefined ? { 'stop-opacity': s.opacity } : {})),
+    }));
+}
+function buildLinearGradient(id, g) {
+    // Coordinates are 0–1 normalized → SVG default gradientUnits="objectBoundingBox".
+    return {
+        type: 'linearGradient',
+        key: id,
+        props: { id, x1: g.x1, y1: g.y1, x2: g.x2, y2: g.y2 },
+        children: buildStops(g.stops),
+    };
+}
+function buildRadialGradient(id, g) {
+    return {
+        type: 'radialGradient',
+        key: id,
+        props: { id, cx: g.cx, cy: g.cy, r: g.r },
+        children: buildStops(g.stops),
+    };
+}
+function buildPattern(id, p) {
+    var _a, _b, _c;
+    const tile = Math.max(1, (_a = p.spacing) !== null && _a !== void 0 ? _a : 8); // repeat period (user units)
+    const feature = Math.max(0.5, (_b = p.size) !== null && _b !== void 0 ? _b : 2); // dot radius / line thickness
+    const color = (_c = p.color) !== null && _c !== void 0 ? _c : '#000000';
+    const c = tile / 2;
+    const children = [];
+    if (p.backgroundColor) {
+        children.push({
+            type: 'rect',
+            key: 'bg',
+            props: { x: 0, y: 0, width: tile, height: tile, fill: p.backgroundColor },
+        });
+    }
+    const line = (x1, y1, x2, y2, key) => ({
+        type: 'line',
+        key,
+        props: { x1, y1, x2, y2, stroke: color, strokeWidth: feature },
+    });
+    switch (p.type) {
+        case 'dots':
+            children.push({ type: 'circle', key: 'dot', props: { cx: c, cy: c, r: feature, fill: color } });
+            break;
+        case 'lines':
+            children.push(line(0, c, tile, c, 'h'));
+            break;
+        case 'grid':
+            children.push(line(0, c, tile, c, 'h'), line(c, 0, c, tile, 'v'));
+            break;
+        case 'hatch':
+            children.push(line(0, tile, tile, 0, 'd'));
+            break;
+        case 'crosshatch':
+            children.push(line(0, tile, tile, 0, 'd1'), line(0, 0, tile, tile, 'd2'));
+            break;
+    }
+    return {
+        type: 'pattern',
+        key: id,
+        props: { id, width: tile, height: tile, patternUnits: 'userSpaceOnUse' },
+        children,
+    };
+}
+/** `<linearGradient gradientUnits="userSpaceOnUse">` with pixel endpoints. */
+function buildLinearGradientUserSpace(id, g) {
+    return {
+        type: 'linearGradient',
+        key: id,
+        props: { id, gradientUnits: 'userSpaceOnUse', x1: g.x1, y1: g.y1, x2: g.x2, y2: g.y2 },
+        children: buildStops(g.stops),
+    };
+}
+/** `<radialGradient gradientUnits="userSpaceOnUse">` with a pixel centre + radius. */
+function buildRadialGradientUserSpace(id, g) {
+    return {
+        type: 'radialGradient',
+        key: id,
+        props: { id, gradientUnits: 'userSpaceOnUse', cx: g.cx, cy: g.cy, r: g.r },
+        children: buildStops(g.stops),
+    };
+}
+/** Build the `<linearGradient>` / `<radialGradient>` / `<pattern>` def for a paint spec. */
+function buildPaintServerVNode(id, spec) {
+    switch (spec.type) {
+        case 'linear':
+            return buildLinearGradient(id, spec);
+        case 'radial':
+            return buildRadialGradient(id, spec);
+        default:
+            return buildPattern(id, spec);
+    }
+}
+/** Build the `<filter>` (feDropShadow) def for a Shadow spec. */
+function buildShadowFilterVNode(id, shadow) {
+    return {
+        type: 'filter',
+        key: id,
+        // Room around the element so the blurred shadow isn't clipped. The filter
+        // region is expressed as percentage strings, whereas VNodeProps types
+        // x/y/width/height as numbers — hence the `as any` on this one props object.
+        props: { id, x: '-50%', y: '-50%', width: '200%', height: '200%' },
+        children: [
+            {
+                type: 'feDropShadow',
+                key: 'drop',
+                props: {
+                    dx: shadow.offsetX,
+                    dy: shadow.offsetY,
+                    stdDeviation: shadow.blur,
+                    'flood-color': shadow.color,
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=paint-servers.js.map

package/src/libs/renderer/src/svg/paint-servers.js.map

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

package/src/libs/renderer/src/svg/panel.d.ts

@@ -0,0 +1,115 @@
+import type { NodeModel } from '@grafloria/engine';
+import type { VNode } from '../types/vnode.types';
+/** Icon/badge anchor: a corner, or `'c'` — dead centre of the node body
+ *  (a BPMN event's trigger glyph sits in the middle of its circle). */
+export type PanelCorner = 'tl' | 'tr' | 'bl' | 'br' | 'c';
+/** A header band across the top of the node (ERD/UML title row). */
+export interface PanelHeader {
+    text?: string;
+    /**
+     * STACKED header lines — the UML classifier convention of a «stereotype»
+     * over the name. Wins over `text` when present; the band grows to hold
+     * every line, and each line is fitted to the band width (shrunk, never
+     * clipped: «enumeration» over a 120px card used to paint "umeration»
+     * Enumera" cut off at both edges).
+     */
+    lines?: string[];
+    /** Band height in px. Default 22, or 16/line + 4 when `lines` stack. */
+    height?: number;
+    fill?: string;
+    textColor?: string;
+}
+/** A raster image slot below the header (data: URI strongly preferred). */
+export interface PanelImage {
+    href: string;
+    /** Slot height in px. Default 48. */
+    height?: number;
+}
+/** A small icon — a raster href OR an emoji/text glyph — pinned to a corner. */
+export interface PanelIcon {
+    href?: string;
+    /** Emoji or short glyph, used when `href` is absent. */
+    glyph?: string;
+    /** Box size in px. Default 18. */
+    size?: number;
+    /** Corner to pin to. Default 'tl'. */
+    corner?: PanelCorner;
+}
+/** A count / status badge pinned to a corner. */
+export interface PanelBadge {
+    text: string;
+    corner?: PanelCorner;
+    fill?: string;
+    textColor?: string;
+}
+/** A stacked body text row (ERD field / UML member). */
+export interface PanelRow {
+    text: string;
+    align?: 'start' | 'middle' | 'end';
+}
+/** The composite-panel spec stored at `node.metadata.panel`. */
+export interface PanelSpec {
+    header?: PanelHeader;
+    image?: PanelImage;
+    icon?: PanelIcon;
+    badges?: PanelBadge[];
+    rows?: PanelRow[];
+    /** Per-row height in px. Default 18. */
+    rowHeight?: number;
+}
+/** Read a node's panel spec, or null when it has none. */
+export declare function getNodePanel(node: NodeModel): PanelSpec | null;
+/** True when the node carries a composite panel. */
+export declare function hasPanel(node: NodeModel): boolean;
+/**
+ * Allow only image-safe URL schemes on an asset href. Blocks `javascript:` and
+ * `data:text/html` (the executable-URL vectors); permits `data:image/*`,
+ * `blob:`, `http(s):`, and scheme-relative / path references. An unsafe or
+ * non-string href resolves to '' so the slot renders empty instead of dangerous.
+ */
+export declare function sanitizeAssetUrl(href: unknown): string;
+/**
+ * Extra content space a panel reserves so content-aware auto-sizing (Card 7)
+ * grows the shape to fit the WHOLE body. `top` = header + image stacked above
+ * the label; `bottom` = the stacked rows below it; `width` = the widest text the
+ * panel must show.
+ */
+export declare function measurePanelReserve(node: NodeModel): {
+    top?: number;
+    bottom?: number;
+    width?: number;
+} | undefined;
+/** Style inputs the host renderer supplies (theme-derived, CSS-mode aware). */
+export interface PanelRenderContext {
+    /** Node id — used for stable child keys. */
+    nodeId: string;
+    fontSize: number;
+    headerFill: string;
+    headerTextColor: string;
+    bodyTextColor: string;
+    badgeFill: string;
+    badgeTextColor: string;
+}
+/**
+ * Build the panel overlay VNodes for a node, in draw order (background bands
+ * first, corner overlays last). Returns [] when the node has no panel. These are
+ * appended to the node group ON TOP of the base shape body, so the panel rides
+ * whatever silhouette the shape registry drew.
+ */
+export declare function renderNodePanel(node: NodeModel, width: number, height: number, ctx: PanelRenderContext): VNode[];
+/**
+ * The body inner rect available to the node LABEL once the panel's header/image
+ * (top) and rows (bottom) have taken their space. Keeps the label from
+ * overlapping the panel bands. Given the shape's own inner rect.
+ */
+export declare function panelAdjustedInnerRect(node: NodeModel, inner: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}, width: number, height: number): {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};