@grafloria/element 0.3.18 → 0.3.19

package/src/libs/renderer/src/svg/panel.js

@@ -0,0 +1,353 @@
+"use strict";
+// Composite / panel node model (Wave 5 / Nodes & shapes — Card 5)
+//
+// A node body beyond "one shape + one label": an optional header band over the
+// body (ERD / UML title rows), an image slot, an icon slot, corner/count badges
+// and stacked text rows. This is a LIGHTWEIGHT panel — a vertical stack plus
+// four corner anchors, deliberately ~10% of a GoJS Panel — NOT a general layout
+// engine.
+//
+// It composes with ANY base shape: the panel VNodes are OVERLAID on top of the
+// shape body the registry produced, so `{ shape: 'cylinder', panel: {...} }`
+// works exactly like `{ shape: 'rect', panel: {...} }`. The spec lives on
+// `node.metadata.panel`, so it serializes for free.
+//
+// SAFETY: every text field is user data and is emitted through `textContent`
+// (never innerHTML), and every image href is passed through `sanitizeAssetUrl`,
+// which blocks the `javascript:`/`data:text/html` vectors. This is the same
+// "diagram data is user input" rule the foreignObject XSS fix established.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodePanel = getNodePanel;
+exports.hasPanel = hasPanel;
+exports.sanitizeAssetUrl = sanitizeAssetUrl;
+exports.measurePanelReserve = measurePanelReserve;
+exports.renderNodePanel = renderNodePanel;
+exports.panelAdjustedInnerRect = panelAdjustedInnerRect;
+const DEFAULT_HEADER_HEIGHT = 22;
+const DEFAULT_IMAGE_HEIGHT = 48;
+const DEFAULT_ROW_HEIGHT = 18;
+const DEFAULT_ICON_SIZE = 18;
+const DEFAULT_FONT_SIZE = 12;
+const HEADER_LINE_HEIGHT = 16;
+const MIN_HEADER_FONT_PX = 8;
+/** The header's lines, whether given as `lines` or a single `text`. */
+function headerLines(header) {
+    if (header.lines && header.lines.length > 0)
+        return header.lines;
+    return header.text ? [header.text] : [];
+}
+/** The header band's height: explicit, or grown to hold its stacked lines. */
+function headerHeight(header) {
+    if (header.height !== undefined)
+        return header.height;
+    const n = headerLines(header).length;
+    return n > 1 ? n * HEADER_LINE_HEIGHT + 4 : DEFAULT_HEADER_HEIGHT;
+}
+/**
+ * The font size at which one UNWRAPPABLE header line fits `maxWidth`. Same
+ * 0.6em average-glyph estimate the label engine uses; the floor keeps a very
+ * long line legible-and-shrunk rather than invisible (past it the band is
+ * simply too small for the name, and clipping at 8px beats 3px noise).
+ */
+function fitHeaderLine(line, maxWidth, base) {
+    if (!line || !isFinite(maxWidth) || maxWidth <= 0)
+        return base;
+    const needed = maxWidth / (line.length * 0.6);
+    return needed >= base ? base : Math.max(MIN_HEADER_FONT_PX, Math.floor(needed));
+}
+/** Read a node's panel spec, or null when it has none. */
+function getNodePanel(node) {
+    const raw = node.getMetadata('panel');
+    return raw && typeof raw === 'object' ? raw : null;
+}
+/** True when the node carries a composite panel. */
+function hasPanel(node) {
+    return getNodePanel(node) !== null;
+}
+/**
+ * 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.
+ */
+function sanitizeAssetUrl(href) {
+    if (typeof href !== 'string')
+        return '';
+    const trimmed = href.trim();
+    if (trimmed === '')
+        return '';
+    // Strip whitespace + control chars (0x00–0x20 and DEL) an attacker could use
+    // to smuggle a scheme past the check ("java\tscript:"), but keep URL
+    // punctuation intact. Escapes only — never embed raw control bytes here.
+    const normalized = trimmed.replace(/[\u0000-\u0020\u007f]/g, '').toLowerCase();
+    if (normalized.startsWith('javascript:') || normalized.startsWith('vbscript:'))
+        return '';
+    if (normalized.startsWith('data:')) {
+        // Only raster image data URIs — never data:text/html or data:image/svg+xml
+        // (SVG can carry script).
+        return /^data:image\/(png|jpe?g|gif|webp|bmp|avif);/.test(normalized) ? trimmed : '';
+    }
+    return trimmed;
+}
+/**
+ * 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.
+ */
+function measurePanelReserve(node) {
+    var _a, _b;
+    const panel = getNodePanel(node);
+    if (!panel)
+        return undefined;
+    const rowHeight = (_a = panel.rowHeight) !== null && _a !== void 0 ? _a : DEFAULT_ROW_HEIGHT;
+    let top = 0;
+    let bottom = 0;
+    let width = 0;
+    if (panel.header) {
+        top += headerHeight(panel.header);
+        for (const line of headerLines(panel.header))
+            width = Math.max(width, estimate(line));
+    }
+    if (panel.image)
+        top += (_b = panel.image.height) !== null && _b !== void 0 ? _b : DEFAULT_IMAGE_HEIGHT;
+    if (panel.rows && panel.rows.length > 0) {
+        bottom += panel.rows.length * rowHeight;
+        for (const row of panel.rows)
+            width = Math.max(width, estimate(row.text));
+    }
+    const out = {};
+    if (top > 0)
+        out.top = top;
+    if (bottom > 0)
+        out.bottom = bottom;
+    if (width > 0)
+        out.width = width;
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function estimate(text) {
+    return text ? text.length * DEFAULT_FONT_SIZE * 0.6 + 12 : 0;
+}
+/**
+ * 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.
+ */
+function renderNodePanel(node, width, height, ctx) {
+    var _a, _b, _c, _d, _e;
+    const panel = getNodePanel(node);
+    if (!panel)
+        return [];
+    const out = [];
+    const rowHeight = (_a = panel.rowHeight) !== null && _a !== void 0 ? _a : DEFAULT_ROW_HEIGHT;
+    let cursorY = 0;
+    // ── header band ──────────────────────────────────────────────────────────
+    if (panel.header) {
+        const header = panel.header;
+        const h = headerHeight(header);
+        out.push({
+            type: 'rect',
+            key: `panel-header-bg-${ctx.nodeId}`,
+            props: {
+                x: 0,
+                y: 0,
+                width,
+                height: h,
+                fill: (_b = header.fill) !== null && _b !== void 0 ? _b : ctx.headerFill,
+                className: 'panel-header',
+                pointerEvents: 'none',
+            },
+        });
+        const lines = headerLines(header);
+        const lineH = lines.length > 0 ? h / lines.length : h;
+        lines.forEach((line, i) => {
+            var _a;
+            // A stacked stereotype line reads smaller and lighter than the name —
+            // the UML card convention («interface» over Interface).
+            const stereo = lines.length > 1 && i < lines.length - 1;
+            const base = stereo ? ctx.fontSize - 2 : ctx.fontSize;
+            out.push(textVNode(`panel-header-text-${ctx.nodeId}${lines.length > 1 ? `-${i}` : ''}`, {
+                text: line,
+                x: width / 2,
+                y: lineH * (i + 0.5),
+                align: 'middle',
+                fill: (_a = header.textColor) !== null && _a !== void 0 ? _a : ctx.headerTextColor,
+                // A header line cannot wrap; it shrinks to its band instead of
+                // painting past the card's edges.
+                fontSize: fitHeaderLine(line, width - 10, base),
+                fontWeight: stereo ? 400 : 600,
+            }));
+        });
+        cursorY += h;
+    }
+    // ── image slot ───────────────────────────────────────────────────────────
+    if (panel.image) {
+        const h = (_c = panel.image.height) !== null && _c !== void 0 ? _c : DEFAULT_IMAGE_HEIGHT;
+        const href = sanitizeAssetUrl(panel.image.href);
+        if (href) {
+            out.push({
+                type: 'image',
+                key: `panel-image-${ctx.nodeId}`,
+                props: {
+                    x: 0,
+                    y: cursorY,
+                    width,
+                    height: h,
+                    href,
+                    preserveAspectRatio: 'xMidYMid meet',
+                    className: 'panel-image',
+                    pointerEvents: 'none',
+                },
+            });
+        }
+        cursorY += h;
+    }
+    // ── stacked rows (ERD/UML members), pinned to the BOTTOM of the body ───────
+    if (panel.rows && panel.rows.length > 0) {
+        const rowsTop = height - panel.rows.length * rowHeight;
+        panel.rows.forEach((row, i) => {
+            var _a;
+            const align = (_a = row.align) !== null && _a !== void 0 ? _a : 'start';
+            const x = align === 'middle' ? width / 2 : align === 'end' ? width - 6 : 6;
+            out.push(textVNode(`panel-row-${ctx.nodeId}-${i}`, {
+                text: row.text,
+                x,
+                y: rowsTop + i * rowHeight + rowHeight / 2,
+                align,
+                fill: ctx.bodyTextColor,
+                fontSize: ctx.fontSize,
+            }));
+        });
+    }
+    // ── icon (corner overlay) ──────────────────────────────────────────────────
+    if (panel.icon) {
+        const size = (_d = panel.icon.size) !== null && _d !== void 0 ? _d : DEFAULT_ICON_SIZE;
+        const pos = cornerBox((_e = panel.icon.corner) !== null && _e !== void 0 ? _e : 'tl', width, height, size, size);
+        const href = sanitizeAssetUrl(panel.icon.href);
+        if (href) {
+            out.push({
+                type: 'image',
+                key: `panel-icon-${ctx.nodeId}`,
+                props: {
+                    x: pos.x,
+                    y: pos.y,
+                    width: size,
+                    height: size,
+                    href,
+                    preserveAspectRatio: 'xMidYMid meet',
+                    className: 'panel-icon',
+                    pointerEvents: 'none',
+                },
+            });
+        }
+        else if (panel.icon.glyph) {
+            out.push(textVNode(`panel-icon-${ctx.nodeId}`, {
+                text: panel.icon.glyph,
+                x: pos.x + size / 2,
+                y: pos.y + size / 2,
+                align: 'middle',
+                fill: ctx.bodyTextColor,
+                fontSize: size,
+            }));
+        }
+    }
+    // ── badges (corner overlays, last so they sit on top) ──────────────────────
+    if (panel.badges && panel.badges.length > 0) {
+        // Group badges by corner so multiple badges on the same corner stack inward.
+        const perCorner = new Map();
+        panel.badges.forEach((badge, i) => {
+            var _a, _b, _c, _d;
+            const corner = (_a = badge.corner) !== null && _a !== void 0 ? _a : 'tr';
+            const index = (_b = perCorner.get(corner)) !== null && _b !== void 0 ? _b : 0;
+            perCorner.set(corner, index + 1);
+            const text = String(badge.text);
+            const bw = Math.max(16, text.length * ctx.fontSize * 0.6 + 8);
+            const bh = 16;
+            const base = cornerBox(corner, width, height, bw, bh);
+            // Stack additional same-corner badges toward the centre horizontally.
+            const dir = corner === 'tr' || corner === 'br' ? -1 : 1;
+            const x = base.x + dir * index * (bw + 4);
+            out.push({
+                type: 'rect',
+                key: `panel-badge-bg-${ctx.nodeId}-${i}`,
+                props: {
+                    x,
+                    y: base.y,
+                    width: bw,
+                    height: bh,
+                    rx: bh / 2,
+                    ry: bh / 2,
+                    fill: (_c = badge.fill) !== null && _c !== void 0 ? _c : ctx.badgeFill,
+                    className: 'panel-badge',
+                    pointerEvents: 'none',
+                },
+            });
+            out.push(textVNode(`panel-badge-text-${ctx.nodeId}-${i}`, {
+                text,
+                x: x + bw / 2,
+                y: base.y + bh / 2,
+                align: 'middle',
+                fill: (_d = badge.textColor) !== null && _d !== void 0 ? _d : ctx.badgeTextColor,
+                fontSize: ctx.fontSize - 2,
+                fontWeight: 600,
+            }));
+        });
+    }
+    return out;
+}
+/**
+ * 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.
+ */
+function panelAdjustedInnerRect(node, inner, width, height) {
+    var _a, _b;
+    const panel = getNodePanel(node);
+    if (!panel)
+        return inner;
+    const rowHeight = (_a = panel.rowHeight) !== null && _a !== void 0 ? _a : DEFAULT_ROW_HEIGHT;
+    let top = 0;
+    let bottom = 0;
+    if (panel.header)
+        top += headerHeight(panel.header);
+    if (panel.image)
+        top += (_b = panel.image.height) !== null && _b !== void 0 ? _b : DEFAULT_IMAGE_HEIGHT;
+    if (panel.rows && panel.rows.length > 0)
+        bottom += panel.rows.length * rowHeight;
+    // Intersect the panel-reserved body band with the shape's own inner rect.
+    const bandTop = Math.max(inner.y, top);
+    const bandBottom = Math.min(inner.y + inner.h, height - bottom);
+    const h = Math.max(0, bandBottom - bandTop);
+    return { x: inner.x, y: bandTop, w: inner.w, h };
+}
+/** Position a `bw × bh` box in one of the four corners (2px inset) or centred. */
+function cornerBox(corner, width, height, bw, bh) {
+    const inset = 2;
+    const right = width - bw - inset;
+    const bottom = height - bh - inset;
+    switch (corner) {
+        case 'tl':
+            return { x: inset, y: inset };
+        case 'tr':
+            return { x: right, y: inset };
+        case 'bl':
+            return { x: inset, y: bottom };
+        case 'br':
+            return { x: right, y: bottom };
+        case 'c':
+            return { x: (width - bw) / 2, y: (height - bh) / 2 };
+    }
+}
+/**
+ * A single-line <text> carrying user content via `textContent` (never
+ * innerHTML). dominant-baseline centres it vertically on `y`.
+ */
+function textVNode(key, spec) {
+    return {
+        type: 'text',
+        key,
+        props: Object.assign(Object.assign({ x: spec.x, y: spec.y, textAnchor: spec.align, dominantBaseline: 'middle', fontSize: spec.fontSize, fill: spec.fill }, (spec.fontWeight ? { fontWeight: spec.fontWeight } : {})), { pointerEvents: 'none', textContent: spec.text }),
+    };
+}
+//# sourceMappingURL=panel.js.map

package/src/libs/renderer/src/svg/panel.js.map

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

package/src/libs/renderer/src/svg/path-outline.d.ts

@@ -0,0 +1,35 @@
+import { type PathCmd, type Point } from '../canvas/path-geometry';
+/** Map every coordinate in a command list through `fn` (structure preserved). */
+export declare function mapPathCmds(cmds: PathCmd[], fn: (x: number, y: number) => Point): PathCmd[];
+/** Serialize a command list back into a compact `d` string. */
+export declare function serializePathCmds(cmds: PathCmd[]): string;
+/** The author's declared reference box for a STATIC path string. */
+export interface PathViewBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/**
+ * Rescale a parsed static path from its `viewBox` reference frame into a
+ * `width × height` box anchored at the origin. Degenerate viewBox dimensions
+ * fall back to 1 so a zero-width authoring box can't divide by zero.
+ */
+export declare function fitCmdsToBox(cmds: PathCmd[], viewBox: PathViewBox, width: number, height: number): PathCmd[];
+/** Offset every coordinate by (dx, dy) — used for grow/shadow transforms. */
+export declare function translateCmds(cmds: PathCmd[], dx: number, dy: number): PathCmd[];
+/**
+ * Sample a path's OUTLINE as a dense polygon of points.
+ *
+ * The path is flattened (curves → line segments) and the single richest subpath
+ * — the shape's main silhouette — is returned as a vertex ring. Interior detail
+ * subpaths (a UML component's tabs, a cube's inner edges) are intentionally
+ * dropped: the boundary/anchor scanline treats its input as ONE closed ring, and
+ * stitching several subpaths into one ring would invent phantom edges.
+ *
+ * Returns an empty array for an unparseable / empty `d` so callers fall back to
+ * the bounding box.
+ */
+export declare function sampleOutlinePoints(cmds: PathCmd[], steps?: number): Point[];
+/** Parse + sample a `d` string in one call. */
+export declare function sampleOutlineFromData(d: string, steps?: number): Point[];

package/src/libs/renderer/src/svg/path-outline.js

@@ -0,0 +1,134 @@
+"use strict";
+// Path-outline sampling (Wave 5 / Nodes & shapes — Card 2)
+//
+// Card 2 makes arbitrary SVG-path geometry a FIRST-CLASS, userland shape: a
+// caller registers a `'path'`/`'custom'` shape with either a static `d` string
+// or a parametric generator `(w, h) => d`, and the registry derives everything
+// else — the smart-connection boundary (`edgeIntersect`) and the per-side port
+// anchors — by SAMPLING the path's real outline instead of falling back to the
+// bounding box. That is what lets a hand-authored star / gauge / chevron attach
+// links to its true silhouette the same way the built-in diamond/hexagon do.
+//
+// This module owns the pure geometry that makes that possible. It leans on the
+// canvas backend's path parser/flattener (`../canvas/path-geometry`), which is a
+// dependency-FREE leaf module (parses `d`, converts arcs → cubics, flattens
+// curves to polylines). Reusing it means Card 2's sampler and the Canvas hit
+// tester cannot disagree about what a path's outline is.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapPathCmds = mapPathCmds;
+exports.serializePathCmds = serializePathCmds;
+exports.fitCmdsToBox = fitCmdsToBox;
+exports.translateCmds = translateCmds;
+exports.sampleOutlinePoints = sampleOutlinePoints;
+exports.sampleOutlineFromData = sampleOutlineFromData;
+const path_geometry_1 = require("../canvas/path-geometry");
+/** Round to 3dp so serialized path strings stay compact and diff-stable. */
+function round3(n) {
+    return Math.round(n * 1000) / 1000;
+}
+/** Map every coordinate in a command list through `fn` (structure preserved). */
+function mapPathCmds(cmds, fn) {
+    return cmds.map((cmd) => {
+        switch (cmd.op) {
+            case 'M':
+            case 'L': {
+                const p = fn(cmd.x, cmd.y);
+                return { op: cmd.op, x: p.x, y: p.y };
+            }
+            case 'C': {
+                const c1 = fn(cmd.x1, cmd.y1);
+                const c2 = fn(cmd.x2, cmd.y2);
+                const p = fn(cmd.x, cmd.y);
+                return { op: 'C', x1: c1.x, y1: c1.y, x2: c2.x, y2: c2.y, x: p.x, y: p.y };
+            }
+            case 'Q': {
+                const c1 = fn(cmd.x1, cmd.y1);
+                const p = fn(cmd.x, cmd.y);
+                return { op: 'Q', x1: c1.x, y1: c1.y, x: p.x, y: p.y };
+            }
+            case 'Z':
+                return cmd;
+        }
+    });
+}
+/** Serialize a command list back into a compact `d` string. */
+function serializePathCmds(cmds) {
+    const parts = [];
+    for (const cmd of cmds) {
+        switch (cmd.op) {
+            case 'M':
+                parts.push(`M ${round3(cmd.x)},${round3(cmd.y)}`);
+                break;
+            case 'L':
+                parts.push(`L ${round3(cmd.x)},${round3(cmd.y)}`);
+                break;
+            case 'C':
+                parts.push(`C ${round3(cmd.x1)},${round3(cmd.y1)} ${round3(cmd.x2)},${round3(cmd.y2)} ${round3(cmd.x)},${round3(cmd.y)}`);
+                break;
+            case 'Q':
+                parts.push(`Q ${round3(cmd.x1)},${round3(cmd.y1)} ${round3(cmd.x)},${round3(cmd.y)}`);
+                break;
+            case 'Z':
+                parts.push('Z');
+                break;
+        }
+    }
+    return parts.join(' ');
+}
+/**
+ * Rescale a parsed static path from its `viewBox` reference frame into a
+ * `width × height` box anchored at the origin. Degenerate viewBox dimensions
+ * fall back to 1 so a zero-width authoring box can't divide by zero.
+ */
+function fitCmdsToBox(cmds, viewBox, width, height) {
+    const sx = viewBox.w !== 0 ? width / viewBox.w : 1;
+    const sy = viewBox.h !== 0 ? height / viewBox.h : 1;
+    return mapPathCmds(cmds, (x, y) => ({
+        x: (x - viewBox.x) * sx,
+        y: (y - viewBox.y) * sy,
+    }));
+}
+/** Offset every coordinate by (dx, dy) — used for grow/shadow transforms. */
+function translateCmds(cmds, dx, dy) {
+    if (dx === 0 && dy === 0)
+        return cmds;
+    return mapPathCmds(cmds, (x, y) => ({ x: x + dx, y: y + dy }));
+}
+/**
+ * Sample a path's OUTLINE as a dense polygon of points.
+ *
+ * The path is flattened (curves → line segments) and the single richest subpath
+ * — the shape's main silhouette — is returned as a vertex ring. Interior detail
+ * subpaths (a UML component's tabs, a cube's inner edges) are intentionally
+ * dropped: the boundary/anchor scanline treats its input as ONE closed ring, and
+ * stitching several subpaths into one ring would invent phantom edges.
+ *
+ * Returns an empty array for an unparseable / empty `d` so callers fall back to
+ * the bounding box.
+ */
+function sampleOutlinePoints(cmds, steps = 24) {
+    const subs = (0, path_geometry_1.flattenPath)(cmds, steps);
+    if (subs.length === 0)
+        return [];
+    // Richest subpath = the main silhouette.
+    let best = subs[0];
+    for (const sub of subs) {
+        if (sub.points.length > best.points.length)
+            best = sub;
+    }
+    // Drop a duplicated closing vertex (flattenPath echoes the start point on Z).
+    const pts = best.points;
+    if (pts.length > 1) {
+        const first = pts[0];
+        const last = pts[pts.length - 1];
+        if (Math.abs(first.x - last.x) < 1e-6 && Math.abs(first.y - last.y) < 1e-6) {
+            return pts.slice(0, -1);
+        }
+    }
+    return pts;
+}
+/** Parse + sample a `d` string in one call. */
+function sampleOutlineFromData(d, steps = 24) {
+    return sampleOutlinePoints((0, path_geometry_1.parsePath)(d), steps);
+}
+//# sourceMappingURL=path-outline.js.map

package/src/libs/renderer/src/svg/path-outline.js.map

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

package/src/libs/renderer/src/svg/port-glyph.d.ts

@@ -0,0 +1,27 @@
+import type { PortShapeSpec } from '@grafloria/engine';
+import type { VNode } from '../types/vnode.types';
+export interface PortGlyphInput {
+    /** Node-local anchor: the port's position. The glyph is CENTRED on it. */
+    x: number;
+    y: number;
+    /** Resolved glyph spec. Undefined → a circle of `radius` (the legacy glyph). */
+    shape?: PortShapeSpec;
+    /** The circle radius the interaction config asks for, and the size fallback. */
+    radius: number;
+    /** Presentation attributes (fill/stroke/…) already merged from theme+group+port. */
+    props: Record<string, unknown>;
+}
+/** Half-extents of the glyph box, honouring size/width/height with `radius` fallback. */
+export declare function glyphHalfExtents(shape: PortShapeSpec | undefined, radius: number): {
+    hw: number;
+    hh: number;
+};
+/**
+ * Build the port's glyph VNode.
+ *
+ * BYTE-STABILITY CONTRACT: with `shape` undefined this returns exactly the
+ * `<circle cx cy r>` the renderer emitted before wave 6 — same element, same
+ * prop set, same order, no rotation attribute. Every existing diagram's port
+ * VNodes are unchanged.
+ */
+export declare function renderPortGlyph(input: PortGlyphInput): VNode;