@danxbot/ui 13.0.0 → 13.0.1

package/dist/types/components/graph-explorer/GraphExplorer.d.ts

@@ -22,9 +22,9 @@ export interface GraphExplorerProps<Extra = unknown> {
     onNodeClick?: (node: CanvasNode<Extra>) => void;
     /** `variant="minimap"` only: the expand affordance's handler. Defaults to an in-place full-screen dialog. */
     onExpand?: () => void;
-    /** Along-axis extent of a node that does not need more, in px. @default LAYOUT_DEFAULTS.nodeWidth */
+    /** Cross-axis extent of a node that does not need more, in px — the rank's OWN axis (ranks spread along y, DX-3401's vertical default) unless `orientation` is overridden. @default LAYOUT_DEFAULTS.nodeWidth */
     nodeWidth?: number;
-    /** Cross-axis extent BEFORE a taller node's own content grows it. @default LAYOUT_DEFAULTS.nodeHeight */
+    /** Along-axis extent BEFORE a taller node's own content grows it — the axis ranks advance along. @default LAYOUT_DEFAULTS.nodeHeight */
     nodeHeight?: number;
     /** `variant="explorer"` only: height of the viewport. @default "32rem" */
     height?: string;

package/dist/types/components/graph-explorer/camera-math.d.ts

@@ -46,5 +46,12 @@ export interface FitOptions extends ScaleBounds {
     /** @default CAMERA_DEFAULTS.fitMaxScale — never zoom IN past this to fit a small box. */
     maxScale?: number;
 }
+/**
+ * The smallest box containing every one of `boxes` — how a camera "frame"
+ * (e.g. a focused node plus its parent and children, DX-3401) is built from
+ * several already-placed boxes without re-deriving a bounding-box formula at
+ * every call site. `null` for an empty list — nothing to union.
+ */
+export declare function unionBox(boxes: readonly Box[]): Box | null;
 /** A camera that fits the whole of `box` inside `viewport`, centred, padded. */
 export declare function fitBox(box: Box, viewport: Size, options?: FitOptions): CameraState;

package/dist/types/components/graph-explorer/index.d.ts

@@ -1,5 +1,5 @@
 export { GraphExplorer, type GraphExplorerProps } from "./GraphExplorer";
-export { layoutExplorerTree, neighbourhoodTree, edgePath } from "./tree-layout";
-export { CAMERA_DEFAULTS, centerOn, clampScale, fitBox, toContentPoint, toScreenPoint, zoomAtPoint } from "./camera-math";
+export { frameBoxFor, layoutExplorerTree, neighbourhoodTree, edgePath } from "./tree-layout";
+export { CAMERA_DEFAULTS, centerOn, clampScale, fitBox, toContentPoint, toScreenPoint, unionBox, zoomAtPoint } from "./camera-math";
 export type { Box, CameraState, FitOptions, Point, ScaleBounds, Size } from "./camera-math";
 export type { CrossLink, ExplorerLayout, ExplorerNodeRenderContext, ExplorerNodeRenderer, ExplorerTree, GraphExplorerVariant, TreeNode, } from "./types";

package/dist/types/components/graph-explorer/tree-layout.d.ts

@@ -1,10 +1,19 @@
 import { edgePath } from "../node-canvas/layout";
 import type { LayoutOptions } from "../node-canvas/types";
+import { type Box } from "./camera-math";
 import type { CrossLink, ExplorerLayout, ExplorerTree } from "./types";
 /** Re-exported for a consumer drawing `edges`/`crossLinks` into an SVG. */
 export { edgePath };
 /**
- * Lay out a tree, left to right, from a parent backbone alone.
+ * Lay out a tree, top to bottom, from a parent backbone alone. Ranked
+ * vertically (dagre `rankdir: "TB"`) so SIBLINGS spread horizontally within a
+ * rank — the sprawl DX-3401's card asks for. A tree this shallow-but-wide (a
+ * handful of levels, many children per level) stacked its siblings into one
+ * tall column under the previous `"horizontal"` (`LR`) default, which is
+ * exactly backwards for that shape: `"horizontal"` ranks left to right, so
+ * within-rank siblings stack along the CROSS axis (vertically) instead.
+ * `options.orientation` still overrides this default for a caller with the
+ * opposite shape (deep and narrow).
  *
  * `crossLinks` are resolved against the ALREADY-FIXED node positions and
  * returned separately (`ExplorerLayout.crossLinks`) — they never reach
@@ -15,6 +24,18 @@ export { edgePath };
  * uses for a group boundary.
  */
 export declare function layoutExplorerTree<Extra>(tree: ExplorerTree<Extra>, crossLinks?: readonly CrossLink[], options?: LayoutOptions): ExplorerLayout<Extra>;
+/**
+ * The box a camera should keep in frame around `focusId`: the focused node
+ * itself, its parent (one rank up) and every one of its direct children (one
+ * rank down) — "the minimap always frames the current node, its parent and
+ * its children" (DX-3401's fix for the minimap shrinking an entire tree to
+ * specks, and for the full-screen explorer's initial view not opening
+ * focused). Computed from an ALREADY-LAID-OUT tree, so it can never disagree
+ * with what is actually on screen the way fitting a separately-computed
+ * bounding box could. `null` when `focusId` isn't laid out at all — nothing
+ * to frame (a stale id, or data still loading).
+ */
+export declare function frameBoxFor<Extra>(layout: ExplorerLayout<Extra>, focusId: string): Box | null;
 /**
  * The subtree a minimap draws: `focusId`'s ancestor chain up to its root,
  * `focusId`'s immediate siblings, and `focusId`'s immediate children — "the

package/dist/types/components/graph-explorer/use-camera.d.ts

@@ -6,6 +6,29 @@ export interface CameraClickEvent {
 export interface UseCameraOptions {
     /** Content-space bounding box of the whole drawing. Drives `fitAll`. */
     contentBox: Box;
+    /**
+     * The box the camera AUTOMATICALLY keeps in frame — on mount, and again
+     * whenever `frameKey` changes (DX-3401). Typically the focused node plus
+     * its parent and children, so the camera never zooms out further than the
+     * relevant neighbourhood just because the whole tree is big. `null`/
+     * `undefined` falls back to `contentBox` (fit the whole drawing) — the
+     * ordinary case when there is no focus yet.
+     */
+    frameBox?: Box | null;
+    /**
+     * A caller-chosen, STABLE value (e.g. the focused node's id) that changing
+     * re-runs the automatic frame fit even when `resetKey` hasn't changed —
+     * `frameBox` itself is deliberately NOT a dependency (see the frame-fit
+     * effect below for why), so this is the only reliable "the frame target
+     * moved" signal for a caller whose `resetKey` tracks something else (e.g.
+     * the explorer's own `resetKey` is the tree, not the focused node).
+     */
+    frameKey?: unknown;
+    /** Padding around the auto-fit target (`frameBox ?? contentBox`) — distinct
+        from `fitAll`'s always-`CAMERA_DEFAULTS.fitPadding`, since a compact
+        minimap strip wants much less breathing room than the full explorer.
+        @default CAMERA_DEFAULTS.fitPadding */
+    framePadding?: number;
     /** A node's content-space box, for `flyTo`. `null` for an id not laid out. */
     boxOf: (id: string) => Box | null;
     /** A press that released without travelling past `CLICK_DISTANCE`. */

package/dist/types/index.d.ts

@@ -129,7 +129,7 @@ export { ProvenanceDisclosure, ProvenanceDetail, ProvenanceBadge, ConfidenceRead
 export { confidenceLevel, CONFIDENCE_LEVEL_LABELS, type ConfidenceLevel } from "./lib/confidence";
 export { createSimStore, resetSimStores, useSimSettings, setSimSettings, getNetworkSpeed, getDataSource, simulateLatency, SimNetworkError, type SimStore, type SimStoreOptions, type SimSettings, type NetworkSpeed, type DataSource, type SimNamespace, } from "./lib/sim";
 export { NodeCanvas, LAYOUT_DEFAULTS, edgePath, layoutGraph, neighbourhood, type NodeCanvasProps, type CanvasCycleScope, type CanvasEdge, type CanvasGraph, type CanvasGroup, type CanvasLayout, type CanvasNode, type CanvasOrientation, type CanvasPlacedEdge, type CanvasScope, type LayoutOptions, type NodeRenderContext, type NodeRenderer, type PlacedNode, } from "./components/node-canvas";
-export { GraphExplorer, layoutExplorerTree, neighbourhoodTree, CAMERA_DEFAULTS, centerOn, clampScale, fitBox, toContentPoint, toScreenPoint, zoomAtPoint, type GraphExplorerProps, type Box, type CameraState, type FitOptions, type Point, type ScaleBounds, type Size, type CrossLink, type ExplorerLayout, type ExplorerNodeRenderContext, type ExplorerNodeRenderer, type ExplorerTree, type GraphExplorerVariant, type TreeNode as ExplorerTreeNode, } from "./components/graph-explorer";
+export { GraphExplorer, frameBoxFor, layoutExplorerTree, neighbourhoodTree, CAMERA_DEFAULTS, centerOn, clampScale, fitBox, toContentPoint, toScreenPoint, unionBox, zoomAtPoint, type GraphExplorerProps, type Box, type CameraState, type FitOptions, type Point, type ScaleBounds, type Size, type CrossLink, type ExplorerLayout, type ExplorerNodeRenderContext, type ExplorerNodeRenderer, type ExplorerTree, type GraphExplorerVariant, type TreeNode as ExplorerTreeNode, } from "./components/graph-explorer";
 export { defineRecordType, resetRecordTypes, useRecord, useRecords, useStaleness, write, writeAll, peekRecord, readState, readStaleness, subscribeToKey, subscribeToStaleness, retainKeys, sweepRecords, setRecordStoreTenant, getRecordStoreTenant, flushRecordNotifications, resetRecordStore, recordStoreStats, UNKNOWN_STATE, normalizeTypeName, normalizeTimestamp, recordKey, isRecordRef, type RecordRef, type ReadOptions, type RecordPayload, type RecordState, type RecordTypeOptions, type RecordTypeToken, type StalenessEntry, type WriteAllResult, type WriteOptions, type WriteResult, type WriteSource, type WriteVerdict, } from "./lib/records";
 export { RealtimeProvider, useRealtime, useRealtimeEpoch, useRealtimeHealth, useRealtimeRegistry, SubscriptionRegistry, normalizeScope, scopeKey, subscriptionKey, readRealtimeEpoch, subscribeToRealtimeEpoch, subscribeToRealtimeEvents, resetRealtimeSignals, type RealtimeChannel, type RealtimeConnectionState, type RealtimeDiagnostic, type RealtimeEvent, type RealtimeHealth, type RealtimeProviderProps, type RealtimeScope, type RealtimeScopeInput, type RealtimeStatus, type RealtimeTransport, type RegistryOptions, type SubscriptionHealth, type SubscriptionLease, type SubscriptionRequest, } from "./lib/realtime";
 export { useRecordRead, useRecordListRead, useRecordStoreSweep, applyMutationResult, optimisticWrite, beginOptimisticWrite, resetOptimisticWrites, type OptimisticHandle, type OptimisticWriteOptions, type OptimisticWriteSpec, type SlotDescriptor, acquireSlot, appendCreated, emptySlotSnapshot, readSlot, resetSlots, slotKeys, subscribeToSlot, writeSlot, RefetchRunner, registerActiveRead, resetActiveReads, type ActiveRead, type ListFetch, type ListFetchResult, type ListReadOptions, type ListReadResult, type ReadError, type RecordFetch, type RecordReadOptions, type RecordReadResult, type RunnerOptions, type SlotSnapshot, } from "./lib/reads";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "13.0.0",
+  "version": "13.0.1",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",