@grafloria/element 0.3.18 → 0.3.19

package/src/libs/renderer/src/ext/components/minimap.js

@@ -0,0 +1,326 @@
+"use strict";
+/**
+ * ============================================================================
+ * Card 6 — <MiniMap>: the overview panel. GAP CLOSED.
+ * ============================================================================
+ *
+ * The audit's finding: "no minimap". Every competitor ships one, and its absence
+ * is the first thing a side-by-side eval notices. `DiagramStore.showMinimap`
+ * existed as a `false`-defaulted boolean with ZERO consumers — the flag was the
+ * fossil of a feature that had never been built. It drives this component now.
+ *
+ * ---------------------------------------------------------------------------
+ * What it draws
+ * ---------------------------------------------------------------------------
+ * A screen-space panel (a portal) containing an SVG whose `viewBox` is the
+ * CONTENT bounding box of the diagram. Because the viewBox does the scaling, the
+ * node rects are drawn in raw world coordinates — no manual scale maths, and no
+ * drift between the minimap and the canvas.
+ *
+ * On top sits the VIEWPORT RECT: the camera's world rectangle, drawn in the same
+ * coordinate system. Panning the canvas moves it; dragging it pans the canvas.
+ *
+ * ---------------------------------------------------------------------------
+ * Interaction (this is the part that makes it a real minimap, not a picture)
+ * ---------------------------------------------------------------------------
+ *   click      → centre the camera on that world point
+ *   drag       → pan continuously
+ *   wheel      → zoom the canvas
+ *
+ * Screen→world for the minimap is NOT the canvas's `clientToWorld` — the minimap
+ * has its own camera (its viewBox). It is inverted here from the panel's own
+ * bounding rect, which is why the two never fight.
+ *
+ * ---------------------------------------------------------------------------
+ * Cost
+ * ---------------------------------------------------------------------------
+ * Redrawing every node rect on every camera change would make panning O(nodes)
+ * for no reason — the nodes have not moved. So the node layer is rebuilt ONLY on
+ * model change, while the camera rect is updated on viewport change. Panning a
+ * 5,000-node diagram therefore touches exactly one `<rect>`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMiniMap = createMiniMap;
+const disposable_1 = require("../disposable");
+const portal_1 = require("../portal");
+const SVG_NS = 'http://www.w3.org/2000/svg';
+function contentBoundsOf(model, padding) {
+    const nodes = model.getNodes().filter((n) => { var _a; return ((_a = n.state) === null || _a === void 0 ? void 0 : _a.visible) !== false; });
+    if (nodes.length === 0)
+        return null;
+    let left = Infinity;
+    let top = Infinity;
+    let right = -Infinity;
+    let bottom = -Infinity;
+    for (const node of nodes) {
+        const p = typeof node.getWorldPosition === 'function' ? node.getWorldPosition() : node.position;
+        left = Math.min(left, p.x);
+        top = Math.min(top, p.y);
+        right = Math.max(right, p.x + node.size.width);
+        bottom = Math.max(bottom, p.y + node.size.height);
+    }
+    if (!Number.isFinite(left))
+        return null;
+    return {
+        x: left - padding,
+        y: top - padding,
+        w: Math.max(1, right - left + padding * 2),
+        h: Math.max(1, bottom - top + padding * 2),
+    };
+}
+function createMiniMap(root, viewport, getModel, options = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+    const doc = root.ownerDocument;
+    let opts = {
+        placement: (_a = options.placement) !== null && _a !== void 0 ? _a : 'bottom-right',
+        offset: (_b = options.offset) !== null && _b !== void 0 ? _b : 12,
+        width: (_c = options.width) !== null && _c !== void 0 ? _c : 200,
+        height: (_d = options.height) !== null && _d !== void 0 ? _d : 150,
+        padding: (_e = options.padding) !== null && _e !== void 0 ? _e : 40,
+        maskColor: (_f = options.maskColor) !== null && _f !== void 0 ? _f : 'rgba(80,130,220,0.18)',
+        maskStroke: (_g = options.maskStroke) !== null && _g !== void 0 ? _g : 'rgba(60,110,200,0.9)',
+        panelBackground: (_h = options.panelBackground) !== null && _h !== void 0 ? _h : 'rgba(250,250,252,0.92)',
+        panelBorder: (_j = options.panelBorder) !== null && _j !== void 0 ? _j : 'rgba(0,0,0,0.15)',
+        interactive: (_k = options.interactive) !== null && _k !== void 0 ? _k : true,
+        showLinks: (_l = options.showLinks) !== null && _l !== void 0 ? _l : false,
+        linkColor: (_m = options.linkColor) !== null && _m !== void 0 ? _m : 'rgba(120,130,145,0.6)',
+        ariaLabel: (_o = options.ariaLabel) !== null && _o !== void 0 ? _o : 'Diagram minimap',
+        nodeColor: options.nodeColor,
+    };
+    const portal = (0, portal_1.createPortal)(root, {
+        placement: opts.placement,
+        offset: opts.offset,
+        className: 'grafloria-minimap',
+    });
+    const applyPanelStyle = () => {
+        portal.element.style.width = `${opts.width}px`;
+        portal.element.style.height = `${opts.height}px`;
+        portal.element.style.background = opts.panelBackground;
+        portal.element.style.border = `1px solid ${opts.panelBorder}`;
+        portal.element.style.borderRadius = '4px';
+        portal.element.style.boxShadow = '0 1px 4px rgba(0,0,0,0.12)';
+        portal.element.style.overflow = 'hidden';
+        portal.element.style.cursor = opts.interactive ? 'pointer' : 'default';
+    };
+    applyPanelStyle();
+    const svg = doc.createElementNS(SVG_NS, 'svg');
+    svg.setAttribute('width', '100%');
+    svg.setAttribute('height', '100%');
+    svg.setAttribute('class', 'grafloria-minimap-svg');
+    svg.setAttribute('role', 'img');
+    svg.setAttribute('aria-label', opts.ariaLabel);
+    svg.style.display = 'block';
+    const linkLayer = doc.createElementNS(SVG_NS, 'g');
+    linkLayer.setAttribute('class', 'grafloria-minimap-links');
+    const nodeLayer = doc.createElementNS(SVG_NS, 'g');
+    nodeLayer.setAttribute('class', 'grafloria-minimap-nodes');
+    const cameraRect = doc.createElementNS(SVG_NS, 'rect');
+    cameraRect.setAttribute('class', 'grafloria-minimap-viewport');
+    cameraRect.setAttribute('pointer-events', 'none');
+    svg.appendChild(linkLayer);
+    svg.appendChild(nodeLayer);
+    svg.appendChild(cameraRect);
+    portal.element.appendChild(svg);
+    let visible = true;
+    /** The world box the minimap's viewBox currently shows. */
+    let bounds = null;
+    const nodeFill = (node) => {
+        var _a;
+        const c = opts.nodeColor;
+        if (typeof c === 'function')
+            return c(node);
+        if (typeof c === 'string')
+            return c;
+        // NOTE: NodeState is an OBJECT (`{ visible, locked, selected, … }`), unlike
+        // LinkModel.state which is a STRING enum. Comparing `node.state ===
+        // 'selected'` — the idiom the link code uses — is always false.
+        return ((_a = node.state) === null || _a === void 0 ? void 0 : _a.selected) ? 'rgba(60,110,200,0.95)' : 'rgba(140,150,165,0.85)';
+    };
+    /**
+     * Rebuild the viewBox + the node/link layers. Model-change only — NOT called
+     * on pan/zoom (see the cost note in the header).
+     */
+    const refresh = () => {
+        var _a;
+        if (!visible)
+            return;
+        const model = getModel();
+        bounds = contentBoundsOf(model, opts.padding);
+        while (nodeLayer.firstChild)
+            nodeLayer.removeChild(nodeLayer.firstChild);
+        while (linkLayer.firstChild)
+            linkLayer.removeChild(linkLayer.firstChild);
+        if (!bounds) {
+            // Empty diagram: nothing to show, and a 0-width viewBox is invalid.
+            svg.removeAttribute('viewBox');
+            cameraRect.setAttribute('width', '0');
+            cameraRect.setAttribute('height', '0');
+            return;
+        }
+        svg.setAttribute('viewBox', `${bounds.x} ${bounds.y} ${bounds.w} ${bounds.h}`);
+        // Match the canvas's aspect handling: never distort the picture.
+        svg.setAttribute('preserveAspectRatio', 'xMidYMid meet');
+        if (opts.showLinks) {
+            for (const link of model.getLinks()) {
+                const pts = link.points;
+                if (!pts || pts.length < 2)
+                    continue;
+                const line = doc.createElementNS(SVG_NS, 'polyline');
+                line.setAttribute('points', pts.map((p) => `${p.x},${p.y}`).join(' '));
+                line.setAttribute('fill', 'none');
+                line.setAttribute('stroke', opts.linkColor);
+                // Keep hairlines visible regardless of how big the content box is.
+                line.setAttribute('stroke-width', String(Math.max(1, bounds.w / 300)));
+                linkLayer.appendChild(line);
+            }
+        }
+        for (const node of model.getNodes()) {
+            if (((_a = node.state) === null || _a === void 0 ? void 0 : _a.visible) === false)
+                continue;
+            const p = typeof node.getWorldPosition === 'function' ? node.getWorldPosition() : node.position;
+            const rect = doc.createElementNS(SVG_NS, 'rect');
+            rect.setAttribute('x', String(p.x));
+            rect.setAttribute('y', String(p.y));
+            rect.setAttribute('width', String(Math.max(1, node.size.width)));
+            rect.setAttribute('height', String(Math.max(1, node.size.height)));
+            rect.setAttribute('rx', '2');
+            rect.setAttribute('fill', nodeFill(node));
+            rect.setAttribute('data-node-id', node.id);
+            nodeLayer.appendChild(rect);
+        }
+        drawCamera();
+    };
+    /** Cheap: one rect. Runs on every camera change. */
+    const drawCamera = () => {
+        if (!visible || !bounds)
+            return;
+        // getViewBox(), NOT getViewport(): the viewport's width/height are CSS-pixel
+        // spans, the VISIBLE WORLD rect divides them by zoom. Copying the raw
+        // viewport made the tinted camera rect zoom-blind — at zoom 1.44 it still
+        // claimed the whole scene while the canvas showed ~60% of it (live audit).
+        const v = viewport.getViewBox();
+        cameraRect.setAttribute('x', String(v.x));
+        cameraRect.setAttribute('y', String(v.y));
+        cameraRect.setAttribute('width', String(Math.max(0, v.width)));
+        cameraRect.setAttribute('height', String(Math.max(0, v.height)));
+        cameraRect.setAttribute('fill', opts.maskColor);
+        cameraRect.setAttribute('stroke', opts.maskStroke);
+        // Constant visual weight regardless of content scale.
+        cameraRect.setAttribute('stroke-width', String(Math.max(1, bounds.w / 200)));
+    };
+    // -- interaction ------------------------------------------------------------
+    //
+    // The minimap has its OWN camera (the viewBox + preserveAspectRatio letterbox).
+    // Inverting it by hand is the only way to turn a click into a world point; the
+    // canvas's clientToWorld would answer for a different camera entirely.
+    const clientToMiniWorld = (clientX, clientY) => {
+        if (!bounds)
+            return null;
+        const r = svg.getBoundingClientRect();
+        if (r.width === 0 || r.height === 0)
+            return null;
+        // 'meet' letterboxes: the content scale is the SMALLER of the two ratios,
+        // and the unused axis is centred (xMidYMid).
+        const scale = Math.min(r.width / bounds.w, r.height / bounds.h);
+        const drawnW = bounds.w * scale;
+        const drawnH = bounds.h * scale;
+        const padX = (r.width - drawnW) / 2;
+        const padY = (r.height - drawnH) / 2;
+        return {
+            x: bounds.x + (clientX - r.left - padX) / scale,
+            y: bounds.y + (clientY - r.top - padY) / scale,
+        };
+    };
+    /** Centre the canvas camera on a world point. */
+    const centreOn = (world) => {
+        // World-rect maths — see drawCamera: spans must be the view box's, or the
+        // centring lands offset whenever zoom != 1.
+        const vp = viewport.getViewport();
+        const vb = viewport.getViewBox();
+        viewport.setViewport({
+            x: world.x - vb.width / 2,
+            y: world.y - vb.height / 2,
+            width: vp.width,
+            height: vp.height,
+        });
+    };
+    let dragging = false;
+    const onPointerDown = (event) => {
+        var _a;
+        if (!opts.interactive)
+            return;
+        const world = clientToMiniWorld(event.clientX, event.clientY);
+        if (!world)
+            return;
+        dragging = true;
+        // Capture on the SVG so a drag that leaves the little panel keeps panning —
+        // without capture the camera would stick the moment the pointer exits.
+        (_a = svg.setPointerCapture) === null || _a === void 0 ? void 0 : _a.call(svg, event.pointerId);
+        centreOn(world);
+        event.preventDefault();
+        event.stopPropagation();
+    };
+    const onPointerMove = (event) => {
+        if (!dragging || !opts.interactive)
+            return;
+        const world = clientToMiniWorld(event.clientX, event.clientY);
+        if (!world)
+            return;
+        centreOn(world);
+        event.preventDefault();
+    };
+    const endDrag = (event) => {
+        var _a;
+        if (!dragging)
+            return;
+        dragging = false;
+        (_a = svg.releasePointerCapture) === null || _a === void 0 ? void 0 : _a.call(svg, event.pointerId);
+    };
+    const onWheel = (event) => {
+        if (!opts.interactive)
+            return;
+        // Zoom the CANVAS about its own centre. Zooming about the minimap cursor
+        // would be a lie: the canvas is not showing that point.
+        viewport.zoomByWheel(event.deltaY);
+        event.preventDefault();
+        event.stopPropagation();
+    };
+    svg.addEventListener('pointerdown', onPointerDown);
+    svg.addEventListener('pointermove', onPointerMove);
+    svg.addEventListener('pointerup', endDrag);
+    svg.addEventListener('pointercancel', endDrag);
+    svg.addEventListener('wheel', onWheel, { passive: false });
+    refresh();
+    const unsubscribeViewport = viewport.onChange(drawCamera);
+    return {
+        portal,
+        element: svg,
+        refresh,
+        setVisible(next) {
+            if (visible === next)
+                return;
+            visible = next;
+            portal.element.style.display = next ? 'block' : 'none';
+            if (next)
+                refresh();
+        },
+        isVisible: () => visible,
+        update(next) {
+            opts = Object.assign(Object.assign({}, opts), next);
+            applyPanelStyle();
+            portal.update({ placement: opts.placement, offset: opts.offset });
+            svg.setAttribute('aria-label', opts.ariaLabel);
+            refresh();
+        },
+        dispose: (0, disposable_1.once)(() => {
+            unsubscribeViewport();
+            svg.removeEventListener('pointerdown', onPointerDown);
+            svg.removeEventListener('pointermove', onPointerMove);
+            svg.removeEventListener('pointerup', endDrag);
+            svg.removeEventListener('pointercancel', endDrag);
+            svg.removeEventListener('wheel', onWheel);
+            portal.dispose();
+        }),
+    };
+}
+//# sourceMappingURL=minimap.js.map

package/src/libs/renderer/src/ext/components/minimap.js.map

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

package/src/libs/renderer/src/ext/diagram-registry.d.ts

@@ -0,0 +1,109 @@
+/**
+ * ============================================================================
+ * `DiagramRegistry` — one diagram's contribution surface
+ * ============================================================================
+ *
+ * Every method here exists as a module-level function already. What this adds is
+ * an ANSWER TO "WHOSE?".
+ *
+ *   registerShape('badge', …)          // the process. Everyone's.
+ *   diagram.registry.registerShape(…)  // this diagram. Nobody else's.
+ *
+ * The two layer: a diagram resolves a name against its own table first and falls
+ * through to the process-global registry, so an app that registers its shape
+ * library once at import time keeps working unchanged in every diagram, and a
+ * single diagram can still override one name for itself without mutating what
+ * the diagram beside it sees.
+ *
+ * ONE IMPLEMENTATION, TWO BINDINGS. `GLOBAL_DIAGRAM_REGISTRY` is this same class
+ * with a null scope, so the process-wide path and the per-diagram path are the
+ * same code with the same disposer semantics. That is deliberate: the previous
+ * arrangement had the ExtensionHost's restore-on-dispose logic written once, for
+ * the global registries only, and the whole bug was that it then ran on behalf
+ * of a diagram that did not own what it was restoring.
+ *
+ * DISPOSERS RESTORE, they do not merely delete — the rule `ext/disposable.ts`
+ * states. Scoped disposers restore the SCOPE's previous entry, which may be
+ * "nothing", in which case the global definition becomes visible again. That
+ * layering is the point: unloading a diagram's override reveals the built-in,
+ * it does not punch a hole through to the fallback.
+ */
+import type { Disposer } from './disposable';
+import { RegistryScope } from './registry-scope';
+import type { PathGeometry, PathShapeOptions, ShapeDefinition } from '../svg/shape-registry';
+import type { NamedStyle } from '../themes/style-registry';
+import type { LabelTemplate, LinkTemplate, MarkerDefinition } from '../svg/edge-templates';
+import type { AnchorFn, ConnectionPointFn, ConnectorFn } from './link-pipeline';
+import { CustomAnimationRegistry } from '../services/custom-animation-registry';
+/**
+ * The contribution surface. Obtained from a diagram as `diagram.registry`, or as
+ * {@link GLOBAL_DIAGRAM_REGISTRY} for the process-wide one.
+ */
+export declare class DiagramRegistry {
+    private readonly scope;
+    /**
+     * @param scope this diagram's private tables, or `null` for the
+     *              process-global registries.
+     */
+    constructor(scope?: RegistryScope | null);
+    /** True when writes here are private to one diagram. */
+    get isScoped(): boolean;
+    registerShape(type: string, definition: Omit<ShapeDefinition, 'type'> & {
+        type?: string;
+    }): Disposer;
+    registerPathShape(type: string, path: PathGeometry, options?: PathShapeOptions): Disposer;
+    unregisterShape(type: string): boolean;
+    hasShape(type: string): boolean;
+    listShapes(): string[];
+    getShapeDefinition(type: string): ShapeDefinition | undefined;
+    defineStyle(name: string, style: NamedStyle): Disposer;
+    defineStyles(styles: Record<string, NamedStyle>): Disposer;
+    removeStyle(name: string): boolean;
+    /**
+     * Drop THIS diagram's named styles. The process-global ones are untouched and
+     * become visible again — which is what makes this safe to call from a teardown
+     * that has no idea what else is on the page.
+     */
+    clearStyles(): void;
+    getStyle(name: string): NamedStyle | undefined;
+    hasStyle(name: string): boolean;
+    listStyles(): string[];
+    registerLinkTemplate(name: string, template: LinkTemplate): Disposer;
+    registerLabelTemplate(name: string, template: LabelTemplate): Disposer;
+    registerMarker(name: string, definition: MarkerDefinition): Disposer;
+    getLinkTemplate(name: string): LinkTemplate | undefined;
+    getLabelTemplate(name: string): LabelTemplate | undefined;
+    getMarker(name: string): MarkerDefinition | undefined;
+    hasMarker(name: string): boolean;
+    listLinkTemplates(): string[];
+    listLabelTemplates(): string[];
+    listMarkers(): string[];
+    registerAnchor(name: string, anchor: AnchorFn): Disposer;
+    registerConnectionPoint(name: string, strategy: ConnectionPointFn): Disposer;
+    registerConnector(name: string, connector: ConnectorFn): Disposer;
+    listAnchors(): string[];
+    listConnectionPoints(): string[];
+    listConnectors(): string[];
+    /**
+     * This diagram's own {@link CustomAnimationRegistry}, or the process-global
+     * singleton when unscoped.
+     *
+     * Lazy: the constructor appends a `<style>` element to the document, so a
+     * diagram that never contributes an animation must not pay for one.
+     */
+    get animations(): CustomAnimationRegistry;
+    private ownAnimations;
+    /** Drop every contribution this diagram made. No-op on the global registry. */
+    dispose(): void;
+    /**
+     * Run a READ with this diagram's scope active.
+     *
+     * Every accessor above goes through here rather than reading the module maps,
+     * because the shadowing rule (mine first, then the process) must be identical
+     * whether a name is being resolved by a render pass or by a host asking
+     * `listShapes()`. Two implementations of that rule would drift.
+     */
+    private read;
+}
+/** The process-wide registry — what the module-level `register*` functions write to. */
+export declare const GLOBAL_DIAGRAM_REGISTRY: DiagramRegistry;