@danxbot/ui 18.4.0 → 19.1.0

package/dist/types/components/file-viewer/use-frame-cursor.d.ts

@@ -0,0 +1,13 @@
+import type { ViewerFile, ViewerFrame } from "./types";
+export interface UseFrameCursorOptions {
+    open: boolean;
+    files: ViewerFile[];
+    initialFileId?: string | null;
+    initialPageId?: string | null;
+    onFrameChange?: (frame: ViewerFrame) => void;
+}
+export declare function useFrameCursor({ open, files, initialFileId, initialPageId, onFrameChange }: UseFrameCursorOptions): {
+    frames: ViewerFrame[];
+    frame: ViewerFrame | null;
+    go: (next: number) => void;
+};

package/dist/types/components/file-viewer/use-viewer-keys.d.ts

@@ -0,0 +1,24 @@
+export interface ViewerKeyActions {
+    go: (index: number) => void;
+    index: number;
+    total: number;
+    /** Null when the frame is not zoomable: the zoom keys are then not handled. */
+    zoom: {
+        zoomIn: () => void;
+        zoomOut: () => void;
+        reset: () => void;
+    } | null;
+}
+/**
+ * The viewer's keyboard (DX-4398): Arrow, PageUp/PageDown, Home and End step
+ * frames; `+`, `-` and `0` zoom. Returns the callback ref for the Dialog popup.
+ *
+ * A NATIVE listener on the popup element, not a document one and not a React
+ * `onKeyDown`: Base UI's popup stops propagation of the arrow, Home, End and Page
+ * keys (they belong to composite widgets), so by the time a key reached
+ * `document` it was gone. On the popup itself it runs first. It only ever sees
+ * keys aimed at the viewer's own DOM: a key inside a portalled Popover (the
+ * overflow menu) has a target outside the popup, so it never gets here. Escape is
+ * not handled: it is the Dialog's.
+ */
+export declare function useViewerKeys(actions: ViewerKeyActions): import("react").Dispatch<import("react").SetStateAction<HTMLDivElement | null>>;

package/dist/types/components/file-viewer/use-viewer-zoom.d.ts

@@ -0,0 +1,29 @@
+import { type CameraState, type ScaleBounds, type Size } from "../graph-explorer/camera-math";
+/** The zoom range of the viewer: far enough out to see a wide page whole, far
+    enough in to read a signature. */
+export declare const VIEWER_ZOOM_BOUNDS: ScaleBounds;
+export type ViewerFit = "width" | "contain";
+export interface UseViewerZoomOptions {
+    /** Changing this is a different frame: refit. */
+    frameKey: string;
+    /** How the frame opens. Null: the frame is not zoomable (video, a plain file). */
+    fit: ViewerFit | null;
+}
+export declare function useViewerZoom({ frameKey, fit }: UseViewerZoomOptions): {
+    camera: CameraState;
+    /** Whole-number percent, null until the frame has been measured. */
+    percent: number | null;
+    measured: boolean;
+    atFit: boolean;
+    canToggle: boolean;
+    panning: boolean;
+    bindViewport: (node: HTMLElement | null) => (() => void) | undefined;
+    setContentSize: (next: Size) => void;
+    zoomIn: () => void;
+    zoomOut: () => void;
+    reset: () => void;
+    toggleActual: (point?: {
+        x: number;
+        y: number;
+    }) => void;
+};

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

@@ -55,6 +55,16 @@ export interface FitOptions extends ScaleBounds {
 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;
+/**
+ * A camera that makes `content` exactly as wide as `viewport` and starts at its
+ * top (DX-4398) — how a document page is read: the width fits, the length
+ * scrolls, and the top is where a page starts. Horizontally centred, which only
+ * shows once `bounds` clamp the page narrower than the viewport. Never an
+ * unbounded scale: a 10px-wide page stops at `maxScale`, a 100000px-wide one at
+ * `minScale`. Zero-size content (an image not measured yet) is a finite 100%
+ * camera at the origin, never NaN.
+ */
+export declare function fitWidth(content: Size, viewport: Size, bounds?: ScaleBounds): CameraState;
 /**
  * Which viewport edges have `box`'s content extending past them at `camera`'s
  * current position/scale — the input `fitBoxWithFloor` (below) needs to

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

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

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

@@ -1,8 +1,6 @@
 import { type Box, type CameraState, type FrameOverflow } from "./camera-math";
-export interface CameraClickEvent {
-    /** Client coordinates, for the caller to hit-test against its own elements. */
-    target: HTMLElement;
-}
+import { type ViewportClickEvent } from "./viewport-gesture";
+export type CameraClickEvent = ViewportClickEvent;
 export interface UseCameraOptions {
     /** Content-space bounding box of the whole drawing. Drives `fitAll`. */
     contentBox: Box;
@@ -73,7 +71,7 @@ export interface UseCameraResult {
      * re-derives this from raw `camera` state itself.
      */
     frameOverflow: FrameOverflow;
-    bindViewport: (node: HTMLDivElement | null) => void;
+    bindViewport: (node: HTMLElement | null) => (() => void) | undefined;
     zoomIn: () => void;
     zoomOut: () => void;
     fitAll: () => void;

package/dist/types/components/graph-explorer/viewport-gesture.d.ts

@@ -0,0 +1,32 @@
+import { type CameraState, type ScaleBounds, type Size } from "./camera-math";
+/** How far a pointer may travel and still resolve to a click on release — below
+    the jitter of a resting hand, above the travel of a deliberate press. */
+export declare const CLICK_DISTANCE = 5;
+export interface ViewportClickEvent {
+    /** The element under the pointer at release, for the caller to hit-test. */
+    target: HTMLElement;
+}
+export interface UseViewportGestureOptions {
+    /** The camera right now. Read at the start of a pan and on every resume. */
+    camera: CameraState;
+    /** Wheel, pan and pinch write the camera through this. Wheel and pinch use
+        the updater form: they compound on whatever is current. */
+    setCamera: (next: CameraState | ((current: CameraState) => CameraState)) => void;
+    /** Wheel and pinch never leave these. */
+    zoomBounds: ScaleBounds;
+    /** A new gesture is starting: stop any programmatic move in flight. */
+    onGestureStart?: () => void;
+    /** A press that released without travelling past `CLICK_DISTANCE`. */
+    onClick?: (event: ViewportClickEvent) => void;
+    /** The viewport's content-box size, on observe and on every change. */
+    onResize?: (size: Size) => void;
+    /** Nothing pans, zooms or clicks. */
+    disabled?: boolean;
+}
+export interface UseViewportGestureResult {
+    /** A pointer is actively panning or pinching right now. */
+    panning: boolean;
+    /** Callback ref for the clipping viewport element. */
+    bindViewport: (node: HTMLElement | null) => (() => void) | undefined;
+}
+export declare function useViewportGesture(options: UseViewportGestureOptions): UseViewportGestureResult;

package/dist/types/components/overlay-stack.d.ts

@@ -0,0 +1,18 @@
+/** The scopes of every Popover whose content the reader is inside, outermost first. */
+export declare const PopoverScopeContext: import("react").Context<readonly symbol[]>;
+interface OpenPopover {
+    scope: symbol;
+    close: () => void;
+    /** Hide or show the popover without unmounting it. */
+    setCovered: (covered: boolean) => void;
+    /** How many open dialogs inside it are covering it right now. */
+    covers: number;
+}
+/** A Popover is open. Returns the call that says it no longer is. */
+export declare function registerOpenPopover(entry: OpenPopover): () => void;
+/** A Dialog is opening inside `ancestry`: close every open Popover outside it. */
+export declare function dismissPopoversOutside(ancestry: readonly symbol[]): void;
+/** A Dialog is open inside `ancestry`: hide those popovers until it closes.
+    Returns the call that says it has. */
+export declare function coverPopovers(ancestry: readonly symbol[]): () => void;
+export {};

package/dist/types/icons/data.d.ts

@@ -856,6 +856,15 @@ export declare const coreIcons: {
     }], readonly ["path", {
         readonly d: "M14 20h7";
     }]];
+    readonly maximize: readonly [readonly ["path", {
+        readonly d: "M8 3H5a2 2 0 0 0-2 2v3";
+    }], readonly ["path", {
+        readonly d: "M21 8V5a2 2 0 0 0-2-2h-3";
+    }], readonly ["path", {
+        readonly d: "M3 16v3a2 2 0 0 0 2 2h3";
+    }], readonly ["path", {
+        readonly d: "M16 21h3a2 2 0 0 0 2-2v-3";
+    }]];
     readonly "maximize-2": readonly [readonly ["path", {
         readonly d: "M15 3h6v6";
     }], readonly ["path", {
@@ -916,6 +925,15 @@ export declare const coreIcons: {
     }], readonly ["path", {
         readonly d: "M21 15H3";
     }]];
+    readonly scan: readonly [readonly ["path", {
+        readonly d: "M3 7V5a2 2 0 0 1 2-2h2";
+    }], readonly ["path", {
+        readonly d: "M17 3h2a2 2 0 0 1 2 2v2";
+    }], readonly ["path", {
+        readonly d: "M21 17v2a2 2 0 0 1-2 2h-2";
+    }], readonly ["path", {
+        readonly d: "M7 21H5a2 2 0 0 1-2-2v-2";
+    }]];
     readonly table: readonly [readonly ["path", {
         readonly d: "M12 3v18";
     }], readonly ["rect", {
@@ -929,6 +947,41 @@ export declare const coreIcons: {
     }], readonly ["path", {
         readonly d: "M3 15h18";
     }]];
+    readonly "zoom-in": readonly [readonly ["circle", {
+        readonly cx: "11";
+        readonly cy: "11";
+        readonly r: "8";
+    }], readonly ["line", {
+        readonly x1: "21";
+        readonly x2: "16.65";
+        readonly y1: "21";
+        readonly y2: "16.65";
+    }], readonly ["line", {
+        readonly x1: "11";
+        readonly x2: "11";
+        readonly y1: "8";
+        readonly y2: "14";
+    }], readonly ["line", {
+        readonly x1: "8";
+        readonly x2: "14";
+        readonly y1: "11";
+        readonly y2: "11";
+    }]];
+    readonly "zoom-out": readonly [readonly ["circle", {
+        readonly cx: "11";
+        readonly cy: "11";
+        readonly r: "8";
+    }], readonly ["line", {
+        readonly x1: "21";
+        readonly x2: "16.65";
+        readonly y1: "21";
+        readonly y2: "16.65";
+    }], readonly ["line", {
+        readonly x1: "8";
+        readonly x2: "14";
+        readonly y1: "11";
+        readonly y2: "11";
+    }]];
     readonly activity: readonly [readonly ["path", {
         readonly d: "M22 12h-2.48a2 2 0 0 0-1.93 1.46l-2.35 8.36a.25.25 0 0 1-.48 0L9.24 2.18a.25.25 0 0 0-.48 0l-2.35 8.36A2 2 0 0 1 4.49 12H2";
     }]];

package/dist/types/index.d.ts

@@ -18,6 +18,7 @@ export { IconButton, type IconButtonProps, type IconButtonVariant, type IconButt
 export { Badge, type BadgeProps, type BadgeDismiss, } from "./components/Badge";
 export { Callout, type CalloutProps } from "./components/Callout";
 export { Spinner, type SpinnerProps } from "./components/Spinner";
+export { AgentWorkingSpinner, type AgentWorkingSpinnerProps, } from "./components/AgentWorkingSpinner";
 export { Skeleton, SkeletonText, LoadingOverlay, type SkeletonProps, type SkeletonTextProps, type LoadingOverlayProps, } from "./components/Loading";
 export { ErrorBoundary, type ErrorBoundaryProps } from "./components/ErrorBoundary";
 export { Field, FieldSet, type FieldProps, type FieldSetProps } from "./components/Field";
@@ -119,8 +120,9 @@ export { Message, MessagePartView, ToolCall, type MessageProps, type MessageActi
 export { MessageScroller, type MessageScrollerProps, } from "./components/chat/MessageScroller";
 export { Composer, type ComposerProps } from "./components/chat/Composer";
 export { StreamingMarkdown, type StreamingMarkdownProps, } from "./components/chat/StreamingMarkdown";
-export { Attachment, AttachmentAction, AttachmentList, AttachmentPreview, type AttachmentProps, type AttachmentActionProps, type AttachmentListProps, type AttachmentPreviewProps, type AttachmentLayout, } from "./components/chat/Attachment";
+export { Attachment, AttachmentAction, AttachmentList, type AttachmentProps, type AttachmentActionProps, type AttachmentListProps, type AttachmentLayout, } from "./components/chat/Attachment";
 export { FileCover, type FileCoverProps } from "./components/chat/FileCover";
+export { FileViewer, PageNumberJumpField, type FileViewerProps, type PageNumberJumpFieldProps, type ViewerFile, type ViewerFrame, type ViewerPage, } from "./components/file-viewer";
 export { fileIconFor, type FileIdentity } from "./components/chat/file-icon";
 export { VideoPlayer, type VideoPlayerProps, type VideoTrack } from "./components/VideoPlayer";
 export { ModelSelector, type ModelSelectorProps, type ChatModel, } from "./components/chat/ModelSelector";
@@ -155,7 +157,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, frameBoxFor, layoutExplorerTree, neighbourhoodTree, CAMERA_DEFAULTS, centerOn, clampScale, fitBox, fitBoxWithFloor, toContentPoint, toScreenPoint, unionBox, zoomAtPoint, type GraphExplorerProps, type Box, type CameraState, type FitOptions, type FitWithFloorOptions, type FitWithFloorResult, type FrameOverflow, 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, fitBoxWithFloor, fitWidth, toContentPoint, toScreenPoint, unionBox, zoomAtPoint, type GraphExplorerProps, type Box, type CameraState, type FitOptions, type FitWithFloorOptions, type FitWithFloorResult, type FrameOverflow, 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 { FocusWeb, CENTER_POSITION, PARENT_POSITION, WIDE_RING_THRESHOLD, layoutRing, type FocusNodeRenderContext, type FocusNodeRenderer, type FocusNodeRole, type FocusWebNode, type FocusWebNodeLook, type FocusWebProps, type PlacedRingNode, } from "./components/focus-web";
 export { SequenceDiagram, type SequenceDiagramProps, type SequenceStep, } from "./components/SequenceDiagram";
 export { OpenApiViewer, type OpenApiViewerProps, OperationCard, type OperationCardProps, OperationHeader, type OperationHeaderProps, OperationDetail, type OperationDetailProps, SchemaView, type SchemaViewProps, groupOperations, isHttpMethod, mergedParameters, operationAnchorId, resolveSchema, resolveWebhooks, schemaToExample, type SchemaResolution, HTTP_METHODS, type HttpMethod, type OpenApiDocument, type OpenApiMediaType, type OpenApiOperation, type OpenApiParameter, type OpenApiParameterLocation, type OpenApiPathItem, type OpenApiRequestBody, type OpenApiResponse, type OpenApiSchema, type OpenApiSecurityRequirement, type OpenApiSecurityScheme, type OpenApiTag, type OperationGroup, type ResolvedOperation, } from "./components/openapi";

package/dist/types/lib/interactive-target.d.ts

@@ -0,0 +1,3 @@
+export declare const INTERACTIVE_SELECTOR = "button, a, input, textarea, select, [role='button']";
+/** True when `target` is, or is inside, a control. */
+export declare function isInteractiveTarget(target: EventTarget | null): boolean;

package/package.json

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