@danxbot/ui 20.19.0 → 20.21.0

package/dist/types/components/SortMenu.d.ts

@@ -1,4 +1,5 @@
 import type { ButtonProps } from "./Button";
+import { type IconName } from "./Icon";
 export type SortDirection = "asc" | "desc";
 export interface SortOption<Field extends string = string> {
     value: Field;
@@ -15,6 +16,12 @@ export interface SortOption<Field extends string = string> {
         asc: string;
         desc: string;
     };
+    /**
+     * A registered icon for the field (DX-4615). When the sorted field carries one, the closed control draws it before the
+     * direction's arrow ("what" then "which way"), and the popover draws it beside the field's label. A list whose options
+     * carry none renders exactly as it did; give every option an icon or none, so the rows and the trigger stay one shape.
+     */
+    icon?: IconName;
 }
 export interface SortValue<Field extends string = string> {
     field: Field;
@@ -27,7 +34,12 @@ export interface SortMenuProps<Field extends string = string> {
     /** Names the control for assistive technology, e.g. "Sort plans". The active order is appended to it. */
     "aria-label": string;
     size?: ButtonProps["size"];
+    /**
+     * The trigger's resting look (DX-4615). `outline` (default) draws the bordered button; `ghost` draws the bare arrow, for a
+     * header that already holds other borderless icons (a board lane's title row). Same arrow, same tooltip, same popover.
+     */
+    triggerVariant?: "outline" | "ghost";
     align?: "start" | "center" | "end";
     className?: string;
 }
-export declare function SortMenu<Field extends string = string>({ options, value, onValueChange, "aria-label": ariaLabel, size, align, className, }: SortMenuProps<Field>): import("react").JSX.Element;
+export declare function SortMenu<Field extends string = string>({ options, value, onValueChange, "aria-label": ariaLabel, size, triggerVariant, align, className, }: SortMenuProps<Field>): import("react").JSX.Element;

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

@@ -1462,6 +1462,68 @@ export declare const coreIcons: {
     readonly wrench: readonly [readonly ["path", {
         readonly d: "M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.106-3.105c.32-.322.863-.22.983.218a6 6 0 0 1-8.259 7.057l-7.91 7.91a1 1 0 0 1-2.999-3l7.91-7.91a6 6 0 0 1 7.057-8.259c.438.12.54.662.219.984z";
     }]];
+    readonly "calendar-plus": readonly [readonly ["path", {
+        readonly d: "M16 19h6";
+    }], readonly ["path", {
+        readonly d: "M16 2v4";
+    }], readonly ["path", {
+        readonly d: "M19 16v6";
+    }], readonly ["path", {
+        readonly d: "M21 12.598V6a2 2 0 0 0-2-2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h8.5";
+    }], readonly ["path", {
+        readonly d: "M3 10h18";
+    }], readonly ["path", {
+        readonly d: "M8 2v4";
+    }]];
+    readonly "clock-arrow-up": readonly [readonly ["path", {
+        readonly d: "M12 6v6l1.56.78";
+    }], readonly ["path", {
+        readonly d: "M13.227 21.925a10 10 0 1 1 8.767-9.588";
+    }], readonly ["path", {
+        readonly d: "m14 18 4-4 4 4";
+    }], readonly ["path", {
+        readonly d: "M18 22v-8";
+    }]];
+    readonly files: readonly [readonly ["path", {
+        readonly d: "M15 2a2 2 0 0 1 1.414.586l4 4A2 2 0 0 1 21 8v7a2 2 0 0 1-2 2h-8a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2z";
+    }], readonly ["path", {
+        readonly d: "M15 2v4a2 2 0 0 0 2 2h4";
+    }], readonly ["path", {
+        readonly d: "M5 7a2 2 0 0 0-2 2v11a2 2 0 0 0 2 2h8a2 2 0 0 0 1.732-1";
+    }]];
+    readonly hash: readonly [readonly ["line", {
+        readonly x1: "4";
+        readonly x2: "20";
+        readonly y1: "9";
+        readonly y2: "9";
+    }], readonly ["line", {
+        readonly x1: "4";
+        readonly x2: "20";
+        readonly y1: "15";
+        readonly y2: "15";
+    }], readonly ["line", {
+        readonly x1: "10";
+        readonly x2: "8";
+        readonly y1: "3";
+        readonly y2: "21";
+    }], readonly ["line", {
+        readonly x1: "16";
+        readonly x2: "14";
+        readonly y1: "3";
+        readonly y2: "21";
+    }]];
+    readonly milestone: readonly [readonly ["path", {
+        readonly d: "M12 13v8";
+    }], readonly ["path", {
+        readonly d: "M12 3v3";
+    }], readonly ["path", {
+        readonly d: "M4 6a1 1 0 0 0-1 1v5a1 1 0 0 0 1 1h13a2 2 0 0 0 1.152-.365l3.424-2.317a1 1 0 0 0 0-1.635l-3.424-2.318A2 2 0 0 0 17 6z";
+    }]];
+    readonly signature: readonly [readonly ["path", {
+        readonly d: "m21 17-2.156-1.868A.5.5 0 0 0 18 15.5v.5a1 1 0 0 1-1 1h-2a1 1 0 0 1-1-1c0-2.545-3.991-3.97-8.5-4a1 1 0 0 0 0 5c4.153 0 4.745-11.295 5.708-13.5a2.5 2.5 0 1 1 3.31 3.284";
+    }], readonly ["path", {
+        readonly d: "M3 21h18";
+    }]];
     readonly "align-center": readonly [readonly ["path", {
         readonly d: "M21 5H3";
     }], readonly ["path", {

package/dist/types/index.d.ts

@@ -116,7 +116,7 @@ export { Board, BoardColumn, BoardCard, BoardCardSurface, type BoardProps, type
 export { buildBoardModel, resolveMove, applyBoardMoves, useBoard, moveAnchor, columnLength, positionInColumn, type BoardModel, type MoveAnchor, type UseBoardResult, } from "./lib/board";
 export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveTarget, BoardMoveRequest, BoardMoveSource, BoardMoveVerdict, BoardReorderLabels, UseBoardOptions, } from "./lib/board";
 export { PagedWindowList, type PagedWindowItemPosition, type PagedWindowListProps, type PagedWindowStrings, } from "./components/PagedWindowList";
-export { PagedWindowStore, usePagedWindow, windowPageNumbers, type LoadCount, type LoadPage, type LoadPageContext, type PageResponse, type PageSnapshot, type PageStatus, type PagedWindow, type PagedWindowMode, type PagedWindowOptions, type PagedWindowSnapshot, type UsePagedWindowOptions, } from "./lib/paged-window";
+export { PAGED_WINDOW_SETTLE_MS, PagedWindowStore, usePagedWindow, windowPageNumbers, type LoadCount, type LoadPage, type LoadPageContext, type PageResponse, type PageSnapshot, type PageStatus, type PagedWindow, type PagedWindowMode, type PagedWindowOptions, type PagedWindowSnapshot, type UsePagedWindowOptions, } from "./lib/paged-window";
 export type { MessageRole, MessagePart, TextPart, CodePart, ReasoningPart, ToolPart, ToolStatus, FilePart, ComponentPart, ChatFile, ChatMessage, RenderContext, PartRenderer, PartRenderers, ChatComponentRenderer, ChatComponents, } from "./components/chat/types";
 export { Chat, ChatPopover, type ChatProps, type ChatPopoverProps, type ChatSurface, } from "./components/chat/Chat";
 export { Message, MessagePartView, ToolCall, type MessageProps, type MessageAction, type MessagePartViewProps, type ToolCallProps, } from "./components/chat/Message";

package/dist/types/lib/paged-window/index.d.ts

@@ -1,2 +1,2 @@
-export { PagedWindowStore, windowPageNumbers, type LoadCount, type LoadPage, type LoadPageContext, type PageResponse, type PageSnapshot, type PageStatus, type PagedWindowMode, type PagedWindowOptions, type PagedWindowSnapshot, } from "./store";
+export { PAGED_WINDOW_SETTLE_MS, PagedWindowStore, windowPageNumbers, type LoadCount, type LoadPage, type LoadPageContext, type PageResponse, type PageSnapshot, type PageStatus, type PagedWindowMode, type PagedWindowOptions, type PagedWindowSnapshot, } from "./store";
 export { usePagedWindow, type PagedWindow, type UsePagedWindowOptions } from "./use-paged-window";

package/dist/types/lib/paged-window/store.d.ts

@@ -12,6 +12,8 @@ export type LoadPage<T> = (page: number, context: LoadPageContext) => Promise<Pa
 /** Answers the list's length alone — no items. What a hidden (`count` mode) lane asks. */
 export type LoadCount = (context: LoadPageContext) => Promise<number>;
 export type PagedWindowMode = "pages" | "count";
+/** How long the viewer's page must stay put before the window moves to it, in ms. */
+export declare const PAGED_WINDOW_SETTLE_MS = 200;
 export type PageStatus = "loading" | "ready" | "error";
 export interface PageSnapshot<T> {
     page: number;
@@ -54,6 +56,12 @@ export interface PagedWindowOptions<T> {
     loadCount?: LoadCount;
     /** @default "pages" */
     mode?: PagedWindowMode;
+    /**
+     * How long the viewer's page must stay put before the window moves to it; 0
+     * moves it synchronously. A negative or fractional value throws.
+     * @default PAGED_WINDOW_SETTLE_MS
+     */
+    settleMs?: number;
 }
 /**
  * The pages to hold for an anchor: `windowPages` of them centred on it (the
@@ -64,13 +72,17 @@ export declare function windowPageNumbers(anchorPage: number, pageCount: number,
 export declare class PagedWindowStore<T> {
     private readonly pageSize;
     private readonly windowPages;
+    private readonly settleMs;
     private loadPage;
     private loadCount;
     private held;
     private total;
+    /** Where the viewer is; moves the instant they do. */
     private anchor;
-    /** The anchor the held pages were last synced to; differs from `anchor` only while frozen. */
+    /** The anchor the held pages were last synced to; differs from `anchor` while the viewer is still moving, or frozen. */
     private appliedAnchor;
+    /** Moves the window to `anchor` once it has been still for `settleMs`; null when no move is waiting. */
+    private settleTimer;
     private mode;
     private frozen;
     private epoch;
@@ -85,7 +97,7 @@ export declare class PagedWindowStore<T> {
     private countError;
     private snapshot;
     private listeners;
-    constructor({ pageSize, windowPages, loadPage, loadCount, mode }: PagedWindowOptions<T>);
+    constructor({ pageSize, windowPages, loadPage, loadCount, mode, settleMs, }: PagedWindowOptions<T>);
     /**
      * Replace the loaders. The React binding calls this after every commit so a
      * consumer's loaders can close over fresh state without the store being
@@ -95,7 +107,10 @@ export declare class PagedWindowStore<T> {
     setLoaders(loadPage: LoadPage<T>, loadCount: LoadCount | undefined): void;
     getSnapshot: () => PagedWindowSnapshot<T>;
     subscribe: (listener: () => void) => (() => void);
-    /** The viewer moved to another page. Ignored while frozen, applied on thaw. */
+    /**
+     * The viewer moved to another page. The window follows once they have stayed
+     * there for `settleMs`; while frozen it follows on thaw.
+     */
     setAnchorPage(page: number): void;
     /**
      * While true nothing about the window changes: it neither loads nor drops
@@ -130,7 +145,16 @@ export declare class PagedWindowStore<T> {
     private wanted;
     /** Bring the held pages to the wanted ones — unless frozen, when that waits for the thaw. */
     private sync;
-    /** `force` is `reset()`'s alone: it brings the window to its (new) list even while frozen. */
+    /** The viewer has settled on `anchor`: the window moves to it, in one step. */
+    private applyAnchor;
+    private clearSettle;
+    /**
+     * Moves the held pages to the window around `appliedAnchor` — which only
+     * `applyAnchor`, `thaw` and `reset` move, so a response arriving while the
+     * viewer is still moving brings in no page of the unsettled position.
+     * `force` is `reset()`'s alone: it brings the window to its (new) list even
+     * while frozen.
+     */
     private reconcile;
     /** Everything the frozen window put off, in the order the header promises. */
     private thaw;

package/dist/types/lib/paged-window/use-paged-window.d.ts

@@ -34,8 +34,14 @@ export interface PagedWindow<T> extends PagedWindowSnapshot<T> {
  * view which ones to show. `loadPage` answers one page AND the list's current
  * length, so the scrollbar can span `total` before most of it is loaded.
  *
+ * The window moves to the viewer's page only after it has stayed put for
+ * `settleMs` (200 ms by default), so a fast scroll loads the pages it lands
+ * on, never the ones it passes (DX-4614); a read for a page that leaves the
+ * window is aborted through its `signal`, and an aborted read is never an error.
+ *
  * `pageSize` and `windowPages` are fixed for the life of the hook: changing one
  * means every held page is cut differently, which is a different list — give it
- * a new `queryKey` and a new mount instead. It throws rather than guessing.
+ * a new `queryKey` and a new mount instead. `settleMs` is fixed too: the store
+ * reads it once. All three throw rather than guess.
  */
-export declare function usePagedWindow<T>({ pageSize, windowPages, loadPage, loadCount, queryKey, mode, }: UsePagedWindowOptions<T>): PagedWindow<T>;
+export declare function usePagedWindow<T>({ pageSize, windowPages, loadPage, loadCount, queryKey, mode, settleMs, }: UsePagedWindowOptions<T>): PagedWindow<T>;

package/package.json

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