@prnt/dagr-explorer 0.1.3

package/dist/use-explorer.d.ts

@@ -0,0 +1,23 @@
+import type { ExplorerApi, ExplorerState } from './context.js';
+import type { ExplorerEdge, ExplorerNode } from './types.js';
+/**
+ * The explorer's state and methods, for a part of the host's own. It is what
+ * the built-in parts read and call, so a custom part can do what they do.
+ *
+ * `N` and `E` are a claim about the root's data that nothing checks: a
+ * context erases type parameters. They default to the base types, so an
+ * unannotated call sees only the fields the explorer guarantees.
+ *
+ * @throws {ExplorerContextError} `OUTSIDE_EXPLORER` outside an `ExplorerRoot`.
+ */
+export declare function useExplorer<N extends ExplorerNode = ExplorerNode, E extends ExplorerEdge = ExplorerEdge>(): ExplorerState<N, E>;
+/**
+ * The explorer's methods alone: the same stable functions `apiRef` and
+ * `useExplorer()` hand out. A component that only calls them should use this,
+ * because it never re-renders for a change of state: not a keystroke, not a
+ * selection, not a trace toggle.
+ *
+ * @throws {ExplorerContextError} `OUTSIDE_EXPLORER` outside an `ExplorerRoot`.
+ */
+export declare function useExplorerApi(): ExplorerApi;
+//# sourceMappingURL=use-explorer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-explorer.d.ts","sourceRoot":"","sources":["../src/use-explorer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,YAAY,GAAG,YAAY,KAClC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAEvB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAE5C"}

package/dist/use-explorer.js

@@ -0,0 +1,26 @@
+import { useExplorerApiContext, useExplorerContext } from './context.js';
+/**
+ * The explorer's state and methods, for a part of the host's own. It is what
+ * the built-in parts read and call, so a custom part can do what they do.
+ *
+ * `N` and `E` are a claim about the root's data that nothing checks: a
+ * context erases type parameters. They default to the base types, so an
+ * unannotated call sees only the fields the explorer guarantees.
+ *
+ * @throws {ExplorerContextError} `OUTSIDE_EXPLORER` outside an `ExplorerRoot`.
+ */
+export function useExplorer() {
+    return useExplorerContext('useExplorer()').state;
+}
+/**
+ * The explorer's methods alone: the same stable functions `apiRef` and
+ * `useExplorer()` hand out. A component that only calls them should use this,
+ * because it never re-renders for a change of state: not a keystroke, not a
+ * selection, not a trace toggle.
+ *
+ * @throws {ExplorerContextError} `OUTSIDE_EXPLORER` outside an `ExplorerRoot`.
+ */
+export function useExplorerApi() {
+    return useExplorerApiContext('useExplorerApi()');
+}
+//# sourceMappingURL=use-explorer.js.map

package/dist/use-explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-explorer.js","sourceRoot":"","sources":["../src/use-explorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIzE;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW;IAIzB,OAAO,kBAAkB,CAAC,eAAe,CAAC,CAAC,KAAuC,CAAC;AACrF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;AACnD,CAAC"}

package/dist/validate.d.ts

@@ -0,0 +1,20 @@
+import type { ExplorerEdge, ExplorerNode, ExplorerView } from './types.js';
+/**
+ * Throws {@link ExplorerDataError} for a view that cannot be drawn honestly.
+ *
+ * Sizes are checked here rather than left to the layout engine, which accepts
+ * a zero-size node and reports `NaN` as a fault in its own config. Neither
+ * tells the caller which node to fix.
+ *
+ * Layout options are checked for the same reason: the engine rejects a bad
+ * spacing with an error that names no view, the renderer throws a bare
+ * `RangeError` for an unknown edge style, and an unknown direction would be
+ * read as `'down'` without a word.
+ *
+ * A self loop and parallel edges are valid data. What happens to them is
+ * `layout.ts`'s business.
+ */
+export declare function validateView<N extends ExplorerNode, E extends ExplorerEdge>(view: ExplorerView<N, E>): void;
+/** Validates every view, and that no two share an id. Ids may repeat across views. */
+export declare function validateViews<N extends ExplorerNode, E extends ExplorerEdge>(views: readonly ExplorerView<N, E>[]): void;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI3E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,YAAY,EACzE,IAAI,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GACvB,IAAI,CAuIN;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,YAAY,EAC1E,KAAK,EAAE,SAAS,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GACnC,IAAI,CASN"}

package/dist/validate.js

@@ -0,0 +1,99 @@
+import { ExplorerDataError } from './errors.js';
+import { resolveNodeSize } from './size.js';
+const positive = (value) => Number.isFinite(value) && value > 0;
+/**
+ * Throws {@link ExplorerDataError} for a view that cannot be drawn honestly.
+ *
+ * Sizes are checked here rather than left to the layout engine, which accepts
+ * a zero-size node and reports `NaN` as a fault in its own config. Neither
+ * tells the caller which node to fix.
+ *
+ * Layout options are checked for the same reason: the engine rejects a bad
+ * spacing with an error that names no view, the renderer throws a bare
+ * `RangeError` for an unknown edge style, and an unknown direction would be
+ * read as `'down'` without a word.
+ *
+ * A self loop and parallel edges are valid data. What happens to them is
+ * `layout.ts`'s business.
+ */
+export function validateView(view) {
+    const where = `view "${view.id}"`;
+    if (view.id === '') {
+        throw new ExplorerDataError('INVALID_ID', 'A view has an empty id. Ids must not be empty', '');
+    }
+    const layoutOptions = view.layout;
+    if (layoutOptions !== undefined) {
+        for (const key of ['nodeSep', 'rankSep']) {
+            const value = layoutOptions[key];
+            if (value !== undefined && !(Number.isFinite(value) && value >= 0)) {
+                throw new ExplorerDataError('INVALID_LAYOUT_OPTION', `View "${view.id}" has layout.${key} ${String(value)}. It must be a finite number that is zero or greater`, view.id);
+            }
+        }
+        const { direction, edgeStyle } = layoutOptions;
+        if (direction !== undefined && direction !== 'right' && direction !== 'down') {
+            throw new ExplorerDataError('INVALID_LAYOUT_OPTION', `View "${view.id}" has layout.direction ${JSON.stringify(direction)}. It must be "right" or "down"`, view.id);
+        }
+        if (edgeStyle !== undefined && edgeStyle !== 'smooth' && edgeStyle !== 'orthogonal') {
+            throw new ExplorerDataError('INVALID_LAYOUT_OPTION', `View "${view.id}" has layout.edgeStyle ${JSON.stringify(edgeStyle)}. It must be "smooth" or "orthogonal"`, view.id);
+        }
+    }
+    const nodeIds = new Set();
+    for (const node of view.nodes) {
+        if (node.id === '') {
+            throw new ExplorerDataError('INVALID_ID', `A node in view "${view.id}" has an empty id. Ids must not be empty`, '', view.id);
+        }
+        if (nodeIds.has(node.id)) {
+            throw new ExplorerDataError('DUPLICATE_NODE_ID', `Duplicate node id "${node.id}" in ${where}`, node.id, view.id);
+        }
+        nodeIds.add(node.id);
+        const size = resolveNodeSize(view.layout, node);
+        if (!positive(size.width) || !positive(size.height)) {
+            throw new ExplorerDataError('INVALID_NODE_SIZE', `Node "${node.id}" in ${where} has size ${String(size.width)} by ${String(size.height)}. Width and height must be finite and greater than zero`, node.id, view.id);
+        }
+    }
+    const edgeIds = new Set();
+    for (const edge of view.edges) {
+        if (edge.id === '') {
+            throw new ExplorerDataError('INVALID_ID', `An edge in view "${view.id}" has an empty id. Ids must not be empty`, '', view.id);
+        }
+        if (edgeIds.has(edge.id)) {
+            throw new ExplorerDataError('DUPLICATE_EDGE_ID', `Duplicate edge id "${edge.id}" in ${where}`, edge.id, view.id);
+        }
+        edgeIds.add(edge.id);
+        for (const end of [edge.source, edge.target]) {
+            if (!nodeIds.has(end)) {
+                throw new ExplorerDataError('MISSING_EDGE_ENDPOINT', `Edge "${edge.id}" in ${where} names missing node "${end}"`, edge.id, view.id);
+            }
+        }
+    }
+    const groupIds = new Set();
+    for (const group of view.groups ?? []) {
+        if (group.id === '') {
+            throw new ExplorerDataError('INVALID_ID', `A group in view "${view.id}" has an empty id. Ids must not be empty`, '', view.id);
+        }
+        if (groupIds.has(group.id)) {
+            throw new ExplorerDataError('DUPLICATE_GROUP_ID', `Duplicate group id "${group.id}" in ${where}`, group.id, view.id);
+        }
+        groupIds.add(group.id);
+        if (group.nodeIds.length === 0) {
+            throw new ExplorerDataError('EMPTY_GROUP', `Group "${group.id}" in ${where} has no nodes`, group.id, view.id);
+        }
+        for (const id of group.nodeIds) {
+            if (!nodeIds.has(id)) {
+                throw new ExplorerDataError('MISSING_GROUP_MEMBER', `Group "${group.id}" in ${where} names missing node "${id}"`, group.id, view.id);
+            }
+        }
+    }
+}
+/** Validates every view, and that no two share an id. Ids may repeat across views. */
+export function validateViews(views) {
+    const viewIds = new Set();
+    for (const view of views) {
+        if (viewIds.has(view.id)) {
+            throw new ExplorerDataError('DUPLICATE_VIEW_ID', `Duplicate view id "${view.id}"`, view.id);
+        }
+        viewIds.add(view.id);
+        validateView(view);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

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

package/dist/viewport-surface.d.ts

@@ -0,0 +1,90 @@
+/**
+ * The explorer's viewport: a pannable, zoomable surface with a base layer
+ * and a windowed DOM overlay, driven by props.
+ *
+ * Internal. M5.6d wraps it with the root's context as the public
+ * `ExplorerViewport` part, which is why everything here arrives as a prop.
+ *
+ * **React renders only when the visible set changes, or a prop does.**
+ * `useExplorerCamera` writes the plane's transform on each frame and calls
+ * back here. The callback computes the visible set and keeps the previous
+ * one, by reference, when `sameVisibleSet` says nothing changed, so a pan
+ * inside the overscan margin is a style write and no React work. A node
+ * button is placed in world coordinates once, when it mounts, and the plane
+ * carries it.
+ *
+ * **Most frames skip the scan.** The set was computed over the view plus a
+ * margin on every side, so while the view stays inside half that margin, at
+ * the same scale, every node it can show is already in the set. A frame
+ * like that does not call `computeVisibleSet` at all.
+ *
+ * **One listener per gesture, on the viewport.** No node has a listener of
+ * its own. A click on a button resolves to that node, a click anywhere else
+ * resolves through the layout, so a base mark (which has no element the
+ * overlay owns) is clickable at every tier.
+ *
+ * The plane is a composited layer only while the camera moves, which the
+ * camera hook decides, and never through `translateZ`. A cached raster of
+ * text enlarged by the camera goes blurry, so at rest there is none.
+ *
+ * **The graph is one tab stop.** Exactly one node button has `tabIndex` 0:
+ * the selected node, else the last node focused from the keyboard, else the
+ * node nearest the viewport center as of the last scan, else (before there
+ * is a camera) the first node. It is pinned, so it is always mounted, and so
+ * is the node that has focus and the node an arrow is moving focus to. An
+ * arrow on a focused node moves focus to `nearestInDirection`: the target is
+ * pinned, mounted, focused, and only then does the old node lose its pin, so
+ * focus never falls to the page in between. A node focused from the keyboard
+ * is revealed by the least pan; one focused by a pointer moves nothing.
+ *
+ * **Nothing reads the DOM in render,** so the surface renders on a server:
+ * the base draws every mark, the plane is hidden, and no node has a button.
+ */
+import type { CSSProperties, MutableRefObject, ReactElement, ReactNode } from 'react';
+import type { ExplorerBase, ExplorerCameraSource } from './base.js';
+import type { ExplorerLayout } from './layout.js';
+import type { ExplorerEdge, ExplorerGroup, ExplorerNode, ExplorerView } from './types.js';
+import type { ExplorerCameraControls } from './use-explorer-camera.js';
+import type { ExplorerTier, ExplorerTiers } from './visible-set.js';
+export interface ViewportSurfaceProps<N extends ExplorerNode, E extends ExplorerEdge> {
+    /** Accessible name of the region. */
+    readonly label: string;
+    readonly view: ExplorerView<N, E>;
+    readonly layout: ExplorerLayout;
+    readonly selectedId?: string | null | undefined;
+    readonly dimmed?: ReadonlySet<string> | undefined;
+    /** Always mounted. `selectedId` is pinned as well. */
+    readonly pinned?: readonly string[] | undefined;
+    readonly tiers?: ExplorerTiers | undefined;
+    readonly maxOverlayNodes?: number | undefined;
+    /** Default: the SVG base. */
+    readonly base?: ExplorerBase | undefined;
+    readonly renderNode?: ((node: N, context: {
+        tier: ExplorerTier;
+        selected: boolean;
+        dimmed: boolean;
+    }) => ReactNode) | undefined;
+    readonly nodeAriaLabel?: ((node: N, context: {
+        groups: readonly ExplorerGroup[];
+    }) => string) | undefined;
+    /** One group in the default accessible name. Default: `in <group>`. */
+    readonly inGroup?: ((groupLabel: string) => string) | undefined;
+    /** Click, Enter, Space. `trigger` is the node's button, or `null` for a mark. */
+    readonly onNodeActivate?: ((id: string, trigger: HTMLElement | null) => void) | undefined;
+    /** Double click. */
+    readonly onNodeZoom?: ((id: string) => void) | undefined;
+    readonly controlsRef?: MutableRefObject<ExplorerCameraControls | null> | undefined;
+    /**
+     * The camera on screen and every drawn frame, the same source the base
+     * gets, for a part outside the viewport that follows the camera without
+     * re-rendering (the toolbar's zoom readout).
+     */
+    readonly cameraSourceRef?: MutableRefObject<ExplorerCameraSource | null> | undefined;
+    /** The id of the element that describes the region. */
+    readonly describedBy?: string | undefined;
+    readonly className?: string | undefined;
+    /** Sizing and decoration pass through. `position` and `overflow` stay the viewport's own, because the graph needs them. */
+    readonly style?: CSSProperties | undefined;
+}
+export declare function ViewportSurface<N extends ExplorerNode, E extends ExplorerEdge>(props: ViewportSurfaceProps<N, E>): ReactElement;
+//# sourceMappingURL=viewport-surface.d.ts.map

package/dist/viewport-surface.d.ts.map

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