@prnt/dagr-explorer 0.1.3

package/dist/size.js

@@ -0,0 +1,20 @@
+/** The size of a node that declares none, in world pixels. */
+export const DEFAULT_NODE_SIZE = Object.freeze({ width: 240, height: 120 });
+/**
+ * A node's size: its own `size`, else the view's `nodeSize`, else the default.
+ *
+ * Sizes are declared and never measured, because a virtualized node has no
+ * element to measure. This is the one place that order is written down, so
+ * validation, layout and the shape key cannot disagree about it.
+ */
+export function resolveNodeSize(layout, node) {
+    if (node.size !== undefined && node.size !== null)
+        return node.size;
+    const configured = layout?.nodeSize;
+    if (configured === undefined)
+        return DEFAULT_NODE_SIZE;
+    // The `??` is for a function that returns nothing: a JavaScript caller, or a
+    // branch the type checker was told not to look at.
+    return (typeof configured === 'function' ? configured(node) : configured) ?? DEFAULT_NODE_SIZE;
+}
+//# sourceMappingURL=size.js.map

package/dist/size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"size.js","sourceRoot":"","sources":["../src/size.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAS,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA4C,EAC5C,IAAO;IAEP,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC;IACpE,MAAM,UAAU,GAAG,MAAM,EAAE,QAAQ,CAAC;IACpC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,iBAAiB,CAAC;IACvD,6EAA6E;IAC7E,mDAAmD;IACnD,OAAO,CAAC,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,iBAAiB,CAAC;AACjG,CAAC"}

package/dist/svg-base.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The default base layer: marks, edges and group outlines as one SVG.
+ *
+ * It sits inside the transformed plane, in world coordinates, so the camera
+ * never touches it: a pan or a zoom is the plane's transform and nothing
+ * here. It renders when the visible set or the emphasis changes, which is
+ * when the viewport hands it a new prop, and at no other time.
+ *
+ * It is decoration for sighted users, so it is `aria-hidden`. Every node a
+ * user can reach is reachable through the overlay and search, and a mark
+ * is clicked through the viewport's delegated listener, which resolves the
+ * point against the layout rather than against these elements.
+ *
+ * **One arrowhead marker per edge color.** An SVG marker cannot take the
+ * stroke of the path that uses it without `context-stroke`, which not every
+ * browser this package supports draws. So the arrowhead for a red edge is a
+ * red marker, and the markers are as many as the colors in view.
+ *
+ * **A marker's id is its color, escaped.** Ids live in the document, not
+ * in a React root, and two roots (two explorers, or two copies of React)
+ * can count `useId` the same way. Named by color, a marker one root reaches
+ * in another root's tree is the same arrowhead.
+ *
+ * **Strokes keep their width at any zoom** (`vector-effect`), so an edge
+ * never thins to nothing zoomed out or thickens to a bar zoomed in.
+ * Arrowheads are not strokes: the marker is in user space, so they scale
+ * with the camera like the marks they point at.
+ *
+ * Internal to the package. Nothing here is exported from the entry.
+ */
+import type { ExplorerBase } from './base.js';
+export declare const svgBase: ExplorerBase;
+//# sourceMappingURL=svg-base.d.ts.map

package/dist/svg-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-base.d.ts","sourceRoot":"","sources":["../src/svg-base.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,WAAW,CAAC;AA2IjE,eAAO,MAAM,OAAO,EAAE,YAAqE,CAAC"}

package/dist/svg-base.js

@@ -0,0 +1,89 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The default base layer: marks, edges and group outlines as one SVG.
+ *
+ * It sits inside the transformed plane, in world coordinates, so the camera
+ * never touches it: a pan or a zoom is the plane's transform and nothing
+ * here. It renders when the visible set or the emphasis changes, which is
+ * when the viewport hands it a new prop, and at no other time.
+ *
+ * It is decoration for sighted users, so it is `aria-hidden`. Every node a
+ * user can reach is reachable through the overlay and search, and a mark
+ * is clicked through the viewport's delegated listener, which resolves the
+ * point against the layout rather than against these elements.
+ *
+ * **One arrowhead marker per edge color.** An SVG marker cannot take the
+ * stroke of the path that uses it without `context-stroke`, which not every
+ * browser this package supports draws. So the arrowhead for a red edge is a
+ * red marker, and the markers are as many as the colors in view.
+ *
+ * **A marker's id is its color, escaped.** Ids live in the document, not
+ * in a React root, and two roots (two explorers, or two copies of React)
+ * can count `useId` the same way. Named by color, a marker one root reaches
+ * in another root's tree is the same arrowhead.
+ *
+ * **Strokes keep their width at any zoom** (`vector-effect`), so an edge
+ * never thins to nothing zoomed out or thickens to a bar zoomed in.
+ * Arrowheads are not strokes: the marker is in user space, so they scale
+ * with the camera like the marks they point at.
+ *
+ * Internal to the package. Nothing here is exported from the entry.
+ */
+import { useMemo } from 'react';
+const DEFAULT_COLOR = 'currentColor';
+const DASH = '6 4';
+/**
+ * The marker id for a color: letters and digits as they are, and every other
+ * character, `-` included, as `-<hex code point>-`. Escaped rather than
+ * stripped, so two colors never share an id (`rgb(1, 23, 4)` and
+ * `rgb(12, 3, 4)` strip to the same characters), and the result is a valid
+ * `url(#...)` fragment for any CSS color.
+ */
+function markerIdOf(color) {
+    const escaped = color.replace(/[^A-Za-z0-9]/gu, (char) => `-${(char.codePointAt(0) ?? 0).toString(16)}-`);
+    return `dagr-explorer-arrow-${escaped}`;
+}
+function SvgBaseLayer({ view, layout, visible, emphasis, }) {
+    const nodes = useMemo(() => new Map(view.nodes.map((node) => [node.id, node])), [view.nodes]);
+    const edges = useMemo(() => new Map(view.edges.map((edge) => [edge.id, edge])), [view.edges]);
+    const markers = new Map();
+    const markerFor = (color) => {
+        let id = markers.get(color);
+        if (id === undefined) {
+            id = markerIdOf(color);
+            markers.set(color, id);
+        }
+        return id;
+    };
+    const paths = [];
+    for (const id of visible.edges) {
+        const edge = edges.get(id);
+        const route = layout.routes.get(id);
+        const first = route?.[0];
+        if (edge === undefined || route === undefined || first === undefined)
+            continue;
+        const d = route.map((p, i) => `${i === 0 ? 'M' : 'L'}${String(p.x)} ${String(p.y)}`).join(' ');
+        const color = edge.color ?? DEFAULT_COLOR;
+        const dimmed = emphasis.dimmed.has(edge.source) || emphasis.dimmed.has(edge.target);
+        paths.push(_jsx("path", { "data-edge-id": id, "data-dimmed": dimmed ? 'true' : undefined, d: d, fill: "none", stroke: color, strokeWidth: 1.5, vectorEffect: "non-scaling-stroke", strokeDasharray: edge.dash === true ? DASH : undefined, markerEnd: `url(#${markerFor(color)})` }, id));
+    }
+    const marks = [];
+    for (const id of visible.baseNodes) {
+        const node = nodes.get(id);
+        const box = layout.boxes.get(id);
+        if (node === undefined || box === undefined)
+            continue;
+        marks.push(_jsx("rect", { "data-node-id": id, "data-dimmed": emphasis.dimmed.has(id) ? 'true' : undefined, x: box.x, y: box.y, width: box.width, height: box.height, rx: 4, fill: node.color ?? DEFAULT_COLOR }, id));
+    }
+    const groups = [];
+    for (const group of view.groups ?? []) {
+        const box = layout.groups.get(group.id);
+        if (box === undefined)
+            continue;
+        const color = group.color ?? DEFAULT_COLOR;
+        groups.push(_jsxs("g", { "data-group-id": group.id, children: [_jsx("rect", { x: box.x, y: box.y, width: box.width, height: box.height, rx: 8, fill: "none", stroke: color, vectorEffect: "non-scaling-stroke", strokeDasharray: "4 4" }), _jsx("text", { x: box.x + 12, y: box.y + 17, fill: color, fontSize: 12, children: group.label })] }, group.id));
+    }
+    return (_jsxs("svg", { "aria-hidden": "true", width: layout.width, height: layout.height, viewBox: `0 0 ${String(layout.width)} ${String(layout.height)}`, style: { position: 'absolute', left: 0, top: 0, overflow: 'visible' }, children: [_jsx("defs", { children: [...markers].map(([color, id]) => (_jsx("marker", { id: id, viewBox: "0 0 10 10", refX: 10, refY: 5, markerWidth: 8, markerHeight: 8, markerUnits: "userSpaceOnUse", orient: "auto", children: _jsx("path", { d: "M0 0L10 5L0 10z", fill: color }) }, id))) }), groups, paths, marks] }));
+}
+export const svgBase = Object.freeze({ Layer: SvgBaseLayer, space: 'plane' });
+//# sourceMappingURL=svg-base.js.map

package/dist/svg-base.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+import type { ReactNode } from 'react';
+import type { Size } from '@prnt/dagr-render/core';
+export type { Size };
+/**
+ * One node. `id` and `label` are all the explorer itself reads: the label is
+ * the accessible name, the search result text, and the default content.
+ * Everything else about a node is the caller's own fields on a type that
+ * extends this one, and every slot receives that type.
+ *
+ * Optional fields are spelled `T | undefined` so a caller compiling with
+ * `exactOptionalPropertyTypes` can pass a value it computed, including
+ * `undefined`, without a conditional spread.
+ */
+export interface ExplorerNode {
+    readonly id: string;
+    readonly label: string;
+    /** World size in CSS pixels at zoom 1. Declared, never measured. */
+    readonly size?: Size | undefined;
+    /** Any CSS color. */
+    readonly color?: string | undefined;
+}
+export interface ExplorerEdge {
+    readonly id: string;
+    readonly source: string;
+    readonly target: string;
+    readonly label?: string | undefined;
+    /** Any CSS color. */
+    readonly color?: string | undefined;
+    /** Draw the edge dashed. */
+    readonly dash?: boolean | undefined;
+}
+/** A labeled outline around its members. An annotation: it moves no node. */
+export interface ExplorerGroup {
+    readonly id: string;
+    readonly label: string;
+    readonly nodeIds: readonly string[];
+    /** Any CSS color. */
+    readonly color?: string | undefined;
+}
+export interface ExplorerLayoutOptions<N extends ExplorerNode = ExplorerNode> {
+    /** Which way edges flow. Default `'right'`. */
+    readonly direction?: 'right' | 'down' | undefined;
+    /** Size for nodes with no `size` of their own. Default 240 by 120. */
+    readonly nodeSize?: Size | ((node: N) => Size) | undefined;
+    /** Gap between neighbors across the flow. Default 40. */
+    readonly nodeSep?: number | undefined;
+    /** Gap between ranks along the flow. Default 120. */
+    readonly rankSep?: number | undefined;
+    /** Default `'smooth'`. */
+    readonly edgeStyle?: 'smooth' | 'orthogonal' | undefined;
+}
+export interface ExplorerView<N extends ExplorerNode = ExplorerNode, E extends ExplorerEdge = ExplorerEdge> {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: ReactNode | undefined;
+    readonly nodes: readonly N[];
+    readonly edges: readonly E[];
+    readonly groups?: readonly ExplorerGroup[] | undefined;
+    readonly layout?: ExplorerLayoutOptions<N> | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,YAAY,EAAE,IAAI,EAAE,CAAC;AAErB;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IACjC,qBAAqB;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,qBAAqB;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,qBAAqB;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IAC1E,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC3D,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,YAAY,CAC3B,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,YAAY,GAAG,YAAY;IAErC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CACxD"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/use-explorer-camera.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The explorer's camera: one animation frame loop, a resize observer and the
+ * gestures, bound to a viewport element and the plane inside it.
+ *
+ * A port of the docs' `useGraphCamera` with its arithmetic taken out: every
+ * camera this file holds comes from `camera.ts`. What is left here is time
+ * (the frame loop), input (wheel, pointer, keys) and the DOM writes.
+ *
+ * **The camera never causes a React render.** A frame is one
+ * `style.transform` write on the plane, and `onFrame` is how the owner
+ * learns the camera moved. Whether that is worth a render (the visible set
+ * changed) is the owner's decision, not this hook's.
+ *
+ * **One engine per effect.** Everything mutable lives in a closure the
+ * effect creates and its cleanup disposes, so StrictMode's mount, cleanup,
+ * mount leaves exactly one loop and one set of listeners, and a frame that
+ * fires after cleanup finds the engine disposed and writes nothing. The
+ * controls the hook returns are stable for the component's lifetime and
+ * forward to whichever engine is live, or do nothing.
+ *
+ * **No size, no camera.** A viewport measured at zero (a hidden tab,
+ * `display: none`, the server) has no limits, so there is no camera to
+ * draw: the controls are no-ops and the plane stays hidden. The first real
+ * size places the fitted camera at once, without a flight.
+ *
+ * **A resize or a new layout keeps the user's place:** the world point at
+ * the center and the scale, under the new limits. Only a camera that was at
+ * fit is fitted again, so a user zoomed in on a node keeps it.
+ *
+ * Internal to the package. Nothing here is exported from the entry.
+ */
+import type { RefObject } from 'react';
+import type { Vec2 } from '@prnt/dagr-render/core';
+import type { ExplorerCamera, ExplorerViewportSize } from './camera.js';
+import type { ExplorerBox, ExplorerLayout } from './layout.js';
+export interface ExplorerCameraControls {
+    fit(): void;
+    /** Anchored at the viewport center. */
+    zoomBy(factor: number): void;
+    /** A flight to fit the box. */
+    focusBox(box: ExplorerBox): void;
+    /** The least pan that brings the box into view, at the current scale. */
+    revealBox(box: ExplorerBox): void;
+    /** The camera on screen, or `null` before the first fit. */
+    getCamera(): ExplorerCamera | null;
+    screenToWorld(point: Vec2): Vec2 | null;
+}
+export interface UseExplorerCameraOptions {
+    readonly viewportRef: RefObject<HTMLElement | null>;
+    readonly planeRef: RefObject<HTMLElement | null>;
+    readonly layout: ExplorerLayout;
+    /** Called on every drawn frame, after the transform is written. */
+    readonly onFrame: (camera: ExplorerCamera, viewport: ExplorerViewportSize) => void;
+}
+export declare function useExplorerCamera(options: UseExplorerCameraOptions): ExplorerCameraControls;
+//# sourceMappingURL=use-explorer-camera.d.ts.map

package/dist/use-explorer-camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-explorer-camera.d.ts","sourceRoot":"","sources":["../src/use-explorer-camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAYnD,OAAO,KAAK,EAAgB,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,GAAG,IAAI,IAAI,CAAC;IACZ,uCAAuC;IACvC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,yEAAyE;IACzE,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,4DAA4D;IAC5D,SAAS,IAAI,cAAc,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;CACpF;AAqjBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,sBAAsB,CAyC3F"}