@prnt/dagr-explorer 0.1.3

package/dist/camera.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The camera's arithmetic, with no DOM and no clock.
+ *
+ * A camera is the plane's CSS transform: `translate(x, y) scale(scale)`, in
+ * CSS pixels, over a world that is y-down. Everything here is a pure function
+ * from a camera to a camera, so the hook that owns the animation frame holds
+ * no arithmetic of its own and all of it is testable in Node.
+ *
+ * **Functions return the camera that was ASKED for, not the one allowed.**
+ * `CameraLimits.constrain` is the one place a camera is clamped, and the
+ * caller decides when: a target is constrained when it is set, and the eased
+ * camera again when it is drawn, so a flight can cross a sparse gap without
+ * being trapped against the nearest node on the way.
+ *
+ * Limits come from `Camera2D` in `@prnt/dagr-render/core`, which speaks a
+ * y-up world with a center and a zoom. The conversion to and from this
+ * module's top-left, y-down camera lives in `createCameraLimits` and nowhere
+ * else.
+ *
+ * Internal to the package. Only the `ExplorerCamera` type is exported from
+ * the entry, because `ExplorerCameraSource` hands one out.
+ */
+import type { ExplorerBox, ExplorerLayout } from './layout.js';
+import type { Vec2 } from '@prnt/dagr-render/core';
+export interface ExplorerCamera {
+    readonly x: number;
+    readonly y: number;
+    readonly scale: number;
+}
+export interface ExplorerViewportSize {
+    readonly width: number;
+    readonly height: number;
+}
+export interface CameraLimits {
+    readonly minScale: number;
+    readonly maxScale: number;
+    /**
+     * Throws a `RangeError` for a camera whose `scale` is not a positive finite
+     * number or whose `x` or `y` is not finite, because `Camera2D` validates
+     * what it is given. Callers hold cameras that came from these functions.
+     */
+    constrain(camera: ExplorerCamera): ExplorerCamera;
+}
+export declare const CONTENT_PADDING = 0.05;
+export declare const FOCUS_MARGIN = 24;
+export declare const REVEAL_MARGIN = 12;
+export declare const EASE_MS = 55;
+export declare function createCameraLimits(layout: ExplorerLayout, viewport: ExplorerViewportSize): CameraLimits | null;
+export declare function fitCamera(layout: ExplorerLayout, viewport: ExplorerViewportSize, limits: CameraLimits): ExplorerCamera;
+/** Divides by `camera.scale`: expects a positive scale, as every camera from `fitCamera` and `constrain` has. */
+export declare function zoomCamera(camera: ExplorerCamera, factor: number, anchor: Vec2, limits: CameraLimits): ExplorerCamera;
+export declare function panCamera(camera: ExplorerCamera, dx: number, dy: number): ExplorerCamera;
+export declare function focusCamera(box: ExplorerBox, viewport: ExplorerViewportSize, limits: CameraLimits): ExplorerCamera;
+export declare function revealCamera(camera: ExplorerCamera, box: ExplorerBox, viewport: ExplorerViewportSize): ExplorerCamera;
+/** Divides by `camera.scale`: expects a positive scale, as every camera from `fitCamera` and `constrain` has. */
+export declare function visibleWorld(camera: ExplorerCamera, viewport: ExplorerViewportSize): ExplorerBox;
+/** Divides by `camera.scale`: expects a positive scale, as every camera from `fitCamera` and `constrain` has. */
+export declare function screenToWorld(camera: ExplorerCamera, point: Vec2): Vec2;
+export declare function easeCamera(current: ExplorerCamera, target: ExplorerCamera, elapsedMs: number): ExplorerCamera;
+export declare function cameraSettled(current: ExplorerCamera, target: ExplorerCamera): boolean;
+//# sourceMappingURL=camera.d.ts.map

package/dist/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAAC;CACnD;AAED,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,OAAO,KAAK,CAAC;AAE1B,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,oBAAoB,GAC7B,YAAY,GAAG,IAAI,CA6CrB;AAED,wBAAgB,SAAS,CACvB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,YAAY,GACnB,cAAc,CAOhB;AAED,iHAAiH;AACjH,wBAAgB,UAAU,CACxB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE,YAAY,GACnB,cAAc,CAQhB;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,CAExF;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,YAAY,GACnB,cAAc,CAWhB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,oBAAoB,GAC7B,cAAc,CAchB;AAED,iHAAiH;AACjH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,oBAAoB,GAAG,WAAW,CAOhG;AAED,iHAAiH;AACjH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAEvE;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GAChB,cAAc,CAOhB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAKtF"}

package/dist/camera.js

@@ -0,0 +1,142 @@
+/**
+ * The camera's arithmetic, with no DOM and no clock.
+ *
+ * A camera is the plane's CSS transform: `translate(x, y) scale(scale)`, in
+ * CSS pixels, over a world that is y-down. Everything here is a pure function
+ * from a camera to a camera, so the hook that owns the animation frame holds
+ * no arithmetic of its own and all of it is testable in Node.
+ *
+ * **Functions return the camera that was ASKED for, not the one allowed.**
+ * `CameraLimits.constrain` is the one place a camera is clamped, and the
+ * caller decides when: a target is constrained when it is set, and the eased
+ * camera again when it is drawn, so a flight can cross a sparse gap without
+ * being trapped against the nearest node on the way.
+ *
+ * Limits come from `Camera2D` in `@prnt/dagr-render/core`, which speaks a
+ * y-up world with a center and a zoom. The conversion to and from this
+ * module's top-left, y-down camera lives in `createCameraLimits` and nowhere
+ * else.
+ *
+ * Internal to the package. Only the `ExplorerCamera` type is exported from
+ * the entry, because `ExplorerCameraSource` hands one out.
+ */
+import { Camera2D, fitZoom } from '@prnt/dagr-render/core';
+export const CONTENT_PADDING = 0.05;
+export const FOCUS_MARGIN = 24;
+export const REVEAL_MARGIN = 12;
+export const EASE_MS = 55;
+export function createCameraLimits(layout, viewport) {
+    if (!(viewport.width > 0) || !(viewport.height > 0) || !(layout.width > 0) || !(layout.height > 0)) {
+        return null;
+    }
+    const limiter = new Camera2D({
+        viewport: { width: viewport.width, height: viewport.height, devicePixelRatio: 1 },
+    });
+    let detail = { width: 160, height: 80 };
+    let best = 0;
+    const regions = [];
+    for (const box of layout.boxes.values()) {
+        const zoom = fitZoom({ minX: 0, minY: 0, maxX: box.width, maxY: box.height }, limiter.viewport);
+        if (zoom > best) {
+            best = zoom;
+            detail = { width: box.width, height: box.height };
+        }
+        regions.push({
+            minX: box.x,
+            maxX: box.x + box.width,
+            minY: -box.y - box.height,
+            maxY: -box.y,
+        });
+    }
+    limiter.setContentBounds({ minX: 0, maxX: layout.width, minY: -layout.height, maxY: 0 }, detail, CONTENT_PADDING, regions);
+    return {
+        minScale: limiter.minZoom,
+        maxScale: limiter.maxZoom,
+        constrain(camera) {
+            limiter.setZoom(camera.scale);
+            limiter.setCenter({
+                x: (viewport.width / 2 - camera.x) / limiter.zoom,
+                y: -(viewport.height / 2 - camera.y) / limiter.zoom,
+            });
+            return {
+                x: viewport.width / 2 - limiter.center.x * limiter.zoom,
+                y: viewport.height / 2 + limiter.center.y * limiter.zoom,
+                scale: limiter.zoom,
+            };
+        },
+    };
+}
+export function fitCamera(layout, viewport, limits) {
+    const scale = limits.minScale;
+    return {
+        x: (viewport.width - layout.width * scale) / 2,
+        y: (viewport.height - layout.height * scale) / 2,
+        scale,
+    };
+}
+/** Divides by `camera.scale`: expects a positive scale, as every camera from `fitCamera` and `constrain` has. */
+export function zoomCamera(camera, factor, anchor, limits) {
+    const scale = Math.max(limits.minScale, Math.min(limits.maxScale, camera.scale * factor));
+    const ratio = scale / camera.scale;
+    return {
+        x: anchor.x - (anchor.x - camera.x) * ratio,
+        y: anchor.y - (anchor.y - camera.y) * ratio,
+        scale,
+    };
+}
+export function panCamera(camera, dx, dy) {
+    return { x: camera.x + dx, y: camera.y + dy, scale: camera.scale };
+}
+export function focusCamera(box, viewport, limits) {
+    const fill = Math.min((viewport.width - FOCUS_MARGIN * 2) / box.width, (viewport.height - FOCUS_MARGIN * 2) / box.height);
+    const scale = Math.max(limits.minScale, Math.min(limits.maxScale, fill));
+    return {
+        x: viewport.width / 2 - (box.x + box.width / 2) * scale,
+        y: viewport.height / 2 - (box.y + box.height / 2) * scale,
+        scale,
+    };
+}
+export function revealCamera(camera, box, viewport) {
+    const axis = (offset, start, size, extent) => {
+        const lo = offset + start * camera.scale;
+        const hi = lo + size * camera.scale;
+        if (hi - lo > extent - REVEAL_MARGIN * 2)
+            return offset + (extent / 2 - (lo + hi) / 2);
+        if (lo < REVEAL_MARGIN)
+            return offset + (REVEAL_MARGIN - lo);
+        if (hi > extent - REVEAL_MARGIN)
+            return offset + (extent - REVEAL_MARGIN - hi);
+        return offset;
+    };
+    return {
+        x: axis(camera.x, box.x, box.width, viewport.width),
+        y: axis(camera.y, box.y, box.height, viewport.height),
+        scale: camera.scale,
+    };
+}
+/** Divides by `camera.scale`: expects a positive scale, as every camera from `fitCamera` and `constrain` has. */
+export function visibleWorld(camera, viewport) {
+    return {
+        x: -camera.x / camera.scale,
+        y: -camera.y / camera.scale,
+        width: viewport.width / camera.scale,
+        height: viewport.height / camera.scale,
+    };
+}
+/** Divides by `camera.scale`: expects a positive scale, as every camera from `fitCamera` and `constrain` has. */
+export function screenToWorld(camera, point) {
+    return { x: (point.x - camera.x) / camera.scale, y: (point.y - camera.y) / camera.scale };
+}
+export function easeCamera(current, target, elapsedMs) {
+    const alpha = 1 - Math.exp(-Math.max(0, Math.min(64, elapsedMs)) / EASE_MS);
+    return {
+        x: current.x + (target.x - current.x) * alpha,
+        y: current.y + (target.y - current.y) * alpha,
+        scale: current.scale + (target.scale - current.scale) * alpha,
+    };
+}
+export function cameraSettled(current, target) {
+    return (Math.abs(current.x - target.x) + Math.abs(current.y - target.y) < 0.05 &&
+        Math.abs(current.scale - target.scale) < 0.0001);
+}
+//# sourceMappingURL=camera.js.map

package/dist/camera.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The contexts the parts talk through, and the public shapes they carry.
+ *
+ * `ExplorerRoot` provides two. The api context holds only the stable
+ * `ExplorerApi`, and its value never changes, so a component that only calls
+ * methods (`useExplorerApi()`) never re-renders for a keystroke. The main
+ * context holds two things:
+ * the state a host may read and the methods it may call (`useExplorer()`
+ * returns exactly that), and a few internals only the built-in parts use to
+ * wire themselves to the root: the viewport's registration, its camera
+ * controls, and the elements focus is restored to.
+ *
+ * **The type parameters are a claim, not a check.** A context erases them, so
+ * the state is stored over the base node and edge types and each part casts
+ * to the `N` and `E` it was given. See the spec's Composition section.
+ */
+import type { MutableRefObject } from 'react';
+import type { ExplorerCameraSource } from './base.js';
+import type { ExplorerLabels } from './labels.js';
+import type { ExplorerLayout } from './layout.js';
+import type { ExplorerEdge, ExplorerNode, ExplorerView } from './types.js';
+import type { ExplorerCameraControls } from './use-explorer-camera.js';
+/**
+ * Everything a host can do to an explorer. `ExplorerRoot`'s `apiRef` and
+ * `useExplorer()` hand out the same functions, stable for the root's life.
+ *
+ * Under a controlled `viewId` or `selectedId`, a method that would change it
+ * calls `onViewChange` or `onSelectedChange` and changes nothing on screen
+ * until the prop does. An id the active view lacks is ignored.
+ */
+export interface ExplorerApi {
+    /** Fits the whole view. A no-op before a viewport has a size. */
+    fit(): void;
+    /** Zooms about the viewport center. */
+    zoomBy(factor: number): void;
+    /** Flies the camera to fit the node. */
+    focusNode(id: string): void;
+    /** Pans the least distance that brings the node into view, at the current zoom. */
+    reveal(id: string): void;
+    /** Sets the current node, or clears it. Does not open the drawer. */
+    select(id: string | null): void;
+    /**
+     * Selects the node and opens the drawer on it. `trigger` is the element
+     * focus returns to when the drawer closes. Without one, the element that
+     * has focus is recorded, unless the drawer is already open, in which case
+     * the opener it has is kept: that is how a connection in the drawer
+     * inspects its neighbor and `Escape` still returns to the first opener.
+     */
+    inspect(id: string, trigger?: HTMLElement | null): void;
+    closeDetails(): void;
+    /** Switches view. Resets the query, trace, drawer and camera. */
+    selectView(id: string): void;
+    setQuery(query: string): void;
+    setTrace(on: boolean): void;
+}
+/** What `useExplorer()` returns: the explorer's current state, and its methods. */
+export interface ExplorerState<N extends ExplorerNode = ExplorerNode, E extends ExplorerEdge = ExplorerEdge> extends ExplorerApi {
+    /** The root's `label`, the accessible name the parts derive theirs from. */
+    readonly label: string;
+    readonly labels: ExplorerLabels;
+    readonly views: readonly ExplorerView<N, E>[];
+    /** `null` only when there are no views. */
+    readonly activeView: ExplorerView<N, E> | null;
+    /** The active view, placed. `null` only when there are no views. */
+    readonly layout: ExplorerLayout | null;
+    /** The current node, or `null`. Never an id the active view lacks. */
+    readonly selectedId: string | null;
+    readonly selectedNode: N | null;
+    readonly query: string;
+    /** The nodes the query matches, in data order. Empty for a blank query. */
+    readonly matches: readonly N[];
+    readonly trace: boolean;
+    /** Whether the drawer is showing the selected node. */
+    readonly detailsOpen: boolean;
+    /** Node ids drawn dimmed: by the query, by trace, or by both. */
+    readonly dimmed: ReadonlySet<string>;
+    /** The camera on screen and every frame of it, for a host's own zoom readout. */
+    readonly camera: ExplorerCameraSource;
+}
+/**
+ * The camera source the root hands out before and after a viewport exists:
+ * it forwards to whichever viewport is attached, and stays the same object
+ * across a view switch, which remounts the viewport.
+ */
+export interface CameraHub extends ExplorerCameraSource {
+    /** Attaches a viewport's source. Returns the detach. */
+    attach(source: ExplorerCameraSource): () => void;
+}
+export declare function createCameraHub(): CameraHub;
+/** What only the built-in parts use. Stable for the root's life. */
+export interface ExplorerInternals {
+    /** Called from the viewport's effect. Throws `SECOND_VIEWPORT` for a second. */
+    registerViewport(): () => void;
+    readonly controlsRef: MutableRefObject<ExplorerCameraControls | null>;
+    readonly camera: CameraHub;
+    /** Where focus goes when the drawer closes and its opener is gone. */
+    readonly searchInputRef: MutableRefObject<HTMLInputElement | null>;
+}
+export interface ExplorerContextValue {
+    readonly state: ExplorerState;
+    readonly internals: ExplorerInternals;
+}
+export declare const ExplorerContext: import("react").Context<ExplorerContextValue | null>;
+/** The root's context, or `OUTSIDE_EXPLORER` naming `part`. */
+export declare function useExplorerContext(part: string): ExplorerContextValue;
+/** The root's stable methods alone. Its value is the same object for the root's life. */
+export declare const ExplorerApiContext: import("react").Context<ExplorerApi | null>;
+/** The root's stable methods, or `OUTSIDE_EXPLORER` naming `part`. */
+export declare function useExplorerApiContext(part: string): ExplorerApi;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

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

package/dist/context.js

@@ -0,0 +1,71 @@
+/**
+ * The contexts the parts talk through, and the public shapes they carry.
+ *
+ * `ExplorerRoot` provides two. The api context holds only the stable
+ * `ExplorerApi`, and its value never changes, so a component that only calls
+ * methods (`useExplorerApi()`) never re-renders for a keystroke. The main
+ * context holds two things:
+ * the state a host may read and the methods it may call (`useExplorer()`
+ * returns exactly that), and a few internals only the built-in parts use to
+ * wire themselves to the root: the viewport's registration, its camera
+ * controls, and the elements focus is restored to.
+ *
+ * **The type parameters are a claim, not a check.** A context erases them, so
+ * the state is stored over the base node and edge types and each part casts
+ * to the `N` and `E` it was given. See the spec's Composition section.
+ */
+import { createContext, useContext } from 'react';
+import { ExplorerContextError } from './errors.js';
+export function createCameraHub() {
+    let attached = null;
+    const listeners = new Set();
+    const emit = (camera) => {
+        for (const listener of [...listeners])
+            listener(camera);
+    };
+    return {
+        get: () => attached?.get() ?? null,
+        subscribe(listener) {
+            // Wrapped, so one listener subscribed twice is two subscriptions.
+            const own = (camera) => listener(camera);
+            listeners.add(own);
+            return () => {
+                listeners.delete(own);
+            };
+        },
+        attach(source) {
+            attached = source;
+            const off = source.subscribe(emit);
+            // The viewport drew its first frame before it could be attached, so a
+            // readout that subscribed early would otherwise wait for the next one.
+            const now = source.get();
+            if (now !== null)
+                emit(now);
+            return () => {
+                off();
+                if (attached === source)
+                    attached = null;
+            };
+        },
+    };
+}
+export const ExplorerContext = createContext(null);
+/** The root's context, or `OUTSIDE_EXPLORER` naming `part`. */
+export function useExplorerContext(part) {
+    const value = useContext(ExplorerContext);
+    if (value === null) {
+        throw new ExplorerContextError('OUTSIDE_EXPLORER', `${part} must be used inside an ExplorerRoot`);
+    }
+    return value;
+}
+/** The root's stable methods alone. Its value is the same object for the root's life. */
+export const ExplorerApiContext = createContext(null);
+/** The root's stable methods, or `OUTSIDE_EXPLORER` naming `part`. */
+export function useExplorerApiContext(part) {
+    const value = useContext(ExplorerApiContext);
+    if (value === null) {
+        throw new ExplorerContextError('OUTSIDE_EXPLORER', `${part} must be used inside an ExplorerRoot`);
+    }
+    return value;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAIlD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA4EnD,MAAM,UAAU,eAAe;IAC7B,IAAI,QAAQ,GAAgC,IAAI,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoC,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,MAAsB,EAAQ,EAAE;QAC5C,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC;YAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC,CAAC;IACF,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,IAAI;QAClC,SAAS,CAAC,QAAQ;YAChB,kEAAkE;YAClE,MAAM,GAAG,GAAG,CAAC,MAAsB,EAAQ,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/D,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,MAAM;YACX,QAAQ,GAAG,MAAM,CAAC;YAClB,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YACnC,sEAAsE;YACtE,uEAAuE;YACvE,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;YACzB,IAAI,GAAG,KAAK,IAAI;gBAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5B,OAAO,GAAG,EAAE;gBACV,GAAG,EAAE,CAAC;gBACN,IAAI,QAAQ,KAAK,MAAM;oBAAE,QAAQ,GAAG,IAAI,CAAC;YAC3C,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAiBD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAA8B,IAAI,CAAC,CAAC;AAEhF,+DAA+D;AAC/D,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,oBAAoB,CAC5B,kBAAkB,EAClB,GAAG,IAAI,sCAAsC,CAC9C,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAC;AAE1E,sEAAsE;AACtE,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,KAAK,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,oBAAoB,CAAC,kBAAkB,EAAE,GAAG,IAAI,sCAAsC,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/dagr-explorer.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `DagrExplorer`: the explorer, preassembled.
+ *
+ * It is composed only from the public parts, with no private access, so
+ * anything it does a host can do by composing the parts itself. Its props are
+ * the root's, plus the parts' slots and options under the names below.
+ *
+ * `N` and `E` are inferred from `views` (or `nodes` and `edges`), and every
+ * slot is typed from them. That is the check hand-composed parts cannot
+ * give, because they talk through a context.
+ */
+import type { ReactElement } from 'react';
+import type { ExplorerBase } from './base.js';
+import type { ExplorerDetailsProps } from './explorer-details.js';
+import type { ExplorerViewportProps } from './explorer-viewport.js';
+import type { ExplorerViewsProps } from './explorer-views.js';
+import type { ExplorerRootProps } from './root.js';
+import type { ExplorerEdge, ExplorerNode } from './types.js';
+import type { ExplorerTiers } from './visible-set.js';
+interface DagrExplorerParts<N extends ExplorerNode, E extends ExplorerEdge> {
+    /** `ExplorerViewport`'s `renderNode`. */
+    readonly renderNode?: ExplorerViewportProps<N>['renderNode'];
+    /** `ExplorerViewport`'s `nodeAriaLabel`. */
+    readonly nodeAriaLabel?: ExplorerViewportProps<N>['nodeAriaLabel'];
+    readonly tiers?: ExplorerTiers | undefined;
+    readonly maxOverlayNodes?: number | undefined;
+    /** Experimental. See `ExplorerBase`. */
+    readonly base?: ExplorerBase | undefined;
+    /** `ExplorerDetails`'s children. */
+    readonly renderDetails?: ExplorerDetailsProps<N, E>['children'];
+    /** `ExplorerDetails`'s `renderConnection`. */
+    readonly renderConnection?: ExplorerDetailsProps<N, E>['renderConnection'];
+    /** `ExplorerViews`'s children. */
+    readonly renderViews?: ExplorerViewsProps<N, E>['children'];
+    /** Preassembled: compose the parts to add your own. */
+    readonly children?: never;
+}
+export type DagrExplorerProps<N extends ExplorerNode = ExplorerNode, E extends ExplorerEdge = ExplorerEdge> = ExplorerRootProps<N, E> & DagrExplorerParts<N, E>;
+export declare function DagrExplorer<N extends ExplorerNode = ExplorerNode, E extends ExplorerEdge = ExplorerEdge>(props: DagrExplorerProps<N, E>): ReactElement;
+export {};
+//# sourceMappingURL=dagr-explorer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dagr-explorer.d.ts","sourceRoot":"","sources":["../src/dagr-explorer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAKlE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,UAAU,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,YAAY;IACxE,yCAAyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC7D,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACzC,oCAAoC;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAChE,8CAA8C;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAC3E,kCAAkC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5D,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,CAC3B,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,YAAY,GAAG,YAAY,IACnC,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEtD,wBAAgB,YAAY,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,CAAC,SAAS,YAAY,GAAG,YAAY,EACvG,KAAK,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,YAAY,CA8Bd"}

package/dist/dagr-explorer.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { ExplorerDetails } from './explorer-details.js';
+import { ExplorerSearch } from './explorer-search.js';
+import { ExplorerToolbar } from './explorer-toolbar.js';
+import { ExplorerTraceToggle } from './explorer-trace-toggle.js';
+import { ExplorerViewport } from './explorer-viewport.js';
+import { ExplorerViews } from './explorer-views.js';
+import { ExplorerRoot } from './root.js';
+export function DagrExplorer(props) {
+    const { renderNode, nodeAriaLabel, tiers, maxOverlayNodes, base, renderDetails, renderConnection, renderViews, ...root } = props;
+    return (_jsxs(ExplorerRoot, { ...root, children: [_jsx(ExplorerViews, { children: renderViews }), _jsx(ExplorerSearch, {}), _jsx(ExplorerTraceToggle, {}), _jsx(ExplorerViewport, { renderNode: renderNode, nodeAriaLabel: nodeAriaLabel, tiers: tiers, maxOverlayNodes: maxOverlayNodes, base: base, children: _jsx(ExplorerDetails, { renderConnection: renderConnection, children: renderDetails }) }), _jsx(ExplorerToolbar, {})] }));
+}
+//# sourceMappingURL=dagr-explorer.js.map

package/dist/dagr-explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dagr-explorer.js","sourceRoot":"","sources":["../src/dagr-explorer.tsx"],"names":[],"mappings":";AAcA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AA6BzC,MAAM,UAAU,YAAY,CAC1B,KAA8B;IAE9B,MAAM,EACJ,UAAU,EACV,aAAa,EACb,KAAK,EACL,eAAe,EACf,IAAI,EACJ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IACV,OAAO,CACL,MAAC,YAAY,OAAY,IAAgC,aACvD,KAAC,aAAa,cAAQ,WAAW,GAAiB,EAClD,KAAC,cAAc,KAAG,EAClB,KAAC,mBAAmB,KAAG,EAEvB,KAAC,gBAAgB,IACf,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,eAAe,EAChC,IAAI,EAAE,IAAI,YAEV,KAAC,eAAe,IAAO,gBAAgB,EAAE,gBAAgB,YAAG,aAAa,GAAmB,GAC3E,EACnB,KAAC,eAAe,KAAG,IACN,CAChB,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Errors thrown by `@prnt/dagr-explorer` for data it cannot draw honestly.
+ *
+ * One class with a `code`, because a caller switches on the code and never on
+ * the class: the failures are all "this view is malformed", and they differ
+ * only in how. Codes are UPPER_SNAKE and the type is named for the package, as
+ * in every sibling.
+ *
+ * **The offender is a field, not only a phrase in the message.** A host that
+ * wants to highlight the bad node, or list the errors of one view, reads `id`
+ * and `viewId` and never parses prose. What `id` names depends on the code:
+ *
+ * - `INVALID_ID`: the empty id itself, so `id` is `''`. `viewId` is the view, or `undefined` when the empty id is a view's.
+ * - `DUPLICATE_VIEW_ID`: the view. `viewId` is `undefined`.
+ * - `INVALID_LAYOUT_OPTION`: the view. `viewId` is `undefined`.
+ * - `DUPLICATE_NODE_ID`, `INVALID_NODE_SIZE`: the node.
+ * - `DUPLICATE_EDGE_ID`, `MISSING_EDGE_ENDPOINT`: the edge.
+ * - `DUPLICATE_GROUP_ID`, `EMPTY_GROUP`, `MISSING_GROUP_MEMBER`,
+ *   `GROUP_ENCLOSES_NON_MEMBER`: the group.
+ *
+ * The message still names every id involved, including the second one a
+ * missing endpoint or an enclosed node adds, so a log line is enough to fix it.
+ *
+ * The prototype is restored explicitly, as every sibling package does, so
+ * `instanceof` stays correct when the output is downlevelled below ES2022.
+ */
+/** The `code` of every data error this package throws. */
+export type DagrExplorerErrorCode = 'INVALID_ID' | 'DUPLICATE_VIEW_ID' | 'DUPLICATE_NODE_ID' | 'DUPLICATE_EDGE_ID' | 'DUPLICATE_GROUP_ID' | 'INVALID_NODE_SIZE' | 'INVALID_LAYOUT_OPTION' | 'MISSING_EDGE_ENDPOINT' | 'MISSING_GROUP_MEMBER' | 'EMPTY_GROUP' | 'GROUP_ENCLOSES_NON_MEMBER';
+export declare class ExplorerDataError extends Error {
+    readonly code: DagrExplorerErrorCode;
+    /** The view, node, edge or group the error is about. See the table above. */
+    readonly id: string;
+    /** The view it was found in. `undefined` when the error is about a view. */
+    readonly viewId: string | undefined;
+    constructor(code: DagrExplorerErrorCode, message: string, id: string, viewId?: string);
+}
+/**
+ * The `code` of every composition error: a part used where it cannot work.
+ *
+ * - `OUTSIDE_EXPLORER`: a part, or `useExplorer()`, rendered outside an
+ *   `ExplorerRoot`. The message names the part.
+ * - `SECOND_VIEWPORT`: a second `ExplorerViewport` in one root.
+ */
+export type ExplorerContextErrorCode = 'OUTSIDE_EXPLORER' | 'SECOND_VIEWPORT';
+/**
+ * A mistake in how the parts are put together, as opposed to the data. A
+ * separate class from {@link ExplorerDataError}, because a host that shows
+ * data errors to its users should never show these: they are the host's own
+ * bug, found the first time the page renders.
+ */
+export declare class ExplorerContextError extends Error {
+    readonly code: ExplorerContextErrorCode;
+    constructor(code: ExplorerContextErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,oBAAoB,GACpB,mBAAmB,GACnB,uBAAuB,GACvB,uBAAuB,GACvB,sBAAsB,GACtB,aAAa,GACb,2BAA2B,CAAC;AAEhC,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IAErC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;gBAExB,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAQtF;AAED;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAE9E;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;gBAE5B,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM;CAM5D"}

package/dist/errors.js

@@ -0,0 +1,57 @@
+/**
+ * Errors thrown by `@prnt/dagr-explorer` for data it cannot draw honestly.
+ *
+ * One class with a `code`, because a caller switches on the code and never on
+ * the class: the failures are all "this view is malformed", and they differ
+ * only in how. Codes are UPPER_SNAKE and the type is named for the package, as
+ * in every sibling.
+ *
+ * **The offender is a field, not only a phrase in the message.** A host that
+ * wants to highlight the bad node, or list the errors of one view, reads `id`
+ * and `viewId` and never parses prose. What `id` names depends on the code:
+ *
+ * - `INVALID_ID`: the empty id itself, so `id` is `''`. `viewId` is the view, or `undefined` when the empty id is a view's.
+ * - `DUPLICATE_VIEW_ID`: the view. `viewId` is `undefined`.
+ * - `INVALID_LAYOUT_OPTION`: the view. `viewId` is `undefined`.
+ * - `DUPLICATE_NODE_ID`, `INVALID_NODE_SIZE`: the node.
+ * - `DUPLICATE_EDGE_ID`, `MISSING_EDGE_ENDPOINT`: the edge.
+ * - `DUPLICATE_GROUP_ID`, `EMPTY_GROUP`, `MISSING_GROUP_MEMBER`,
+ *   `GROUP_ENCLOSES_NON_MEMBER`: the group.
+ *
+ * The message still names every id involved, including the second one a
+ * missing endpoint or an enclosed node adds, so a log line is enough to fix it.
+ *
+ * The prototype is restored explicitly, as every sibling package does, so
+ * `instanceof` stays correct when the output is downlevelled below ES2022.
+ */
+export class ExplorerDataError extends Error {
+    code;
+    /** The view, node, edge or group the error is about. See the table above. */
+    id;
+    /** The view it was found in. `undefined` when the error is about a view. */
+    viewId;
+    constructor(code, message, id, viewId) {
+        super(message);
+        this.name = 'ExplorerDataError';
+        this.code = code;
+        this.id = id;
+        this.viewId = viewId;
+        Object.setPrototypeOf(this, ExplorerDataError.prototype);
+    }
+}
+/**
+ * A mistake in how the parts are put together, as opposed to the data. A
+ * separate class from {@link ExplorerDataError}, because a host that shows
+ * data errors to its users should never show these: they are the host's own
+ * bug, found the first time the page renders.
+ */
+export class ExplorerContextError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'ExplorerContextError';
+        this.code = code;
+        Object.setPrototypeOf(this, ExplorerContextError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAgBH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAAwB;IAErC,6EAA6E;IACpE,EAAE,CAAS;IAEpB,4EAA4E;IACnE,MAAM,CAAqB;IAEpC,YAAY,IAA2B,EAAE,OAAe,EAAE,EAAU,EAAE,MAAe;QACnF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAWD;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,CAA2B;IAExC,YAAY,IAA8B,EAAE,OAAe;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF"}