@danxbot/ui 2.8.0 → 2.9.0

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

@@ -55,6 +55,57 @@ export interface DragDropItemProps {
     children?: ReactNode;
 }
 export declare function DragDropItem({ id, index, label, className, children, }: DragDropItemProps): import("react").JSX.Element;
+export interface DragDropSurfaceProps {
+    /**
+     * Accessible name, used ONLY in the case where the surface has to become
+     * focusable itself — see the banner. Defaults to the item's label.
+     */
+    label?: string;
+    className?: string;
+    children?: ReactNode;
+}
+/**
+ * THE WHOLE ROW IS THE DRAG SOURCE. The alternative to `DragDropHandle`, and
+ * the right one wherever every row is draggable by definition.
+ *
+ * A GRIP IS A CHOICE ABOUT WHICH ROWS MOVE. On a list where some rows are fixed
+ * and some are not, the grip is the affordance that says which — and it is also
+ * the only way to keep a row full of buttons from starting a drag from every
+ * one of them. On a kanban board neither is true: every card moves, and the
+ * card's own job is to open a record. Reported, in the user's words: "I should
+ * be able to drag anywhere on the card and it should drag the card. Get rid of
+ * the drag handle entirely. Cards are just draggable. Click opens them, drag
+ * drags them."
+ *
+ * THE HARD PART IS NOT THE DRAG, IT IS THE CLICK. A card that is both a drag
+ * source and a link has to tell a press-that-moved from a press-that-did-not,
+ * and it has to do it without a threshold invented here — the engine already
+ * has one, tuned against real devices (`PointerActivation`: 5px for a mouse, a
+ * 250ms dwell for a finger). A press under that stays a click and opens the
+ * record; a press over it becomes a drag AND has its trailing `click`
+ * swallowed, in `sensors/gesture.ts`, because the browser fires one either way.
+ *
+ * THE KEYBOARD IS THE HALF THAT IS EASY TO LOSE, and losing it is not
+ * acceptable — a board that can only be reordered with a mouse is a board some
+ * people cannot reorder at all. Two things keep it:
+ *
+ *   THE KEYS ARE SPLIT. Space picks the card up, Enter is left to whatever
+ *   control has focus inside it. The keyboard sensor reads that off the event's
+ *   target rather than from a flag here, so a grip (where the source IS the
+ *   focused control) keeps both keys and a card gets the split, with nothing to
+ *   configure and nothing to forget.
+ *
+ *   THE INSTRUCTIONS FOLLOW THE FOCUS. A grip carried `aria-describedby`
+ *   itself. A card's focus lands on the consumer's own control — a
+ *   `RecordCard`'s button — which this component did not render and cannot pass
+ *   props to, so the description is attached to that element directly and
+ *   removed again on unmount. A card with NO focusable control of its own has
+ *   nothing to describe and no way into a drag, so the surface becomes the
+ *   focusable control instead. Both branches are measured by
+ *   `probe-kanban.mjs`; without the second one, a board of plain cards would be
+ *   keyboard-inaccessible with nothing to see and nothing to fail.
+ */
+export declare function DragDropSurface({ label, className, children }: DragDropSurfaceProps): import("react").JSX.Element;
 export interface DragDropHandleProps {
     /** Accessible name. Defaults to `Reorder <the item's label>`. */
     label?: string;

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

@@ -1,4 +1,4 @@
-import type { ReactNode, Ref } from "react";
+import { type ReactNode, type Ref } from "react";
 import { Select as BaseSelect } from "@base-ui/react/select";
 import { type VariantProps } from "tailwind-variants";
 declare const trigger: import("tailwind-variants").TVReturnType<{
@@ -28,7 +28,7 @@ export interface SelectProps<Value> extends Omit<BaseSelect.Root.Props<Value, bo
     children: ReactNode;
     ref?: Ref<HTMLButtonElement>;
 }
-export declare function Select<Value>({ size, placeholder, className, children, ref, "aria-label": ariaLabel, ...props }: SelectProps<Value>): import("react").JSX.Element;
+export declare function Select<Value>({ size, placeholder, className, children, ref, items, "aria-label": ariaLabel, ...props }: SelectProps<Value>): import("react").JSX.Element;
 export interface SelectItemProps extends Omit<BaseSelect.Item.Props, "className"> {
     className?: string;
     ref?: Ref<HTMLDivElement>;

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

@@ -2,6 +2,11 @@ import type { ReactNode, Ref } from "react";
 import { type VariantProps } from "tailwind-variants";
 declare const stat: import("tailwind-variants").TVReturnType<{
     size: {
+        xs: {
+            label: string;
+            hint: string;
+            value: string;
+        };
         sm: {
             value: string;
         };
@@ -21,6 +26,11 @@ declare const stat: import("tailwind-variants").TVReturnType<{
     hint: string;
 }, undefined, {
     size: {
+        xs: {
+            label: string;
+            hint: string;
+            value: string;
+        };
         sm: {
             value: string;
         };
@@ -40,6 +50,11 @@ declare const stat: import("tailwind-variants").TVReturnType<{
     hint: string;
 }, import("tailwind-variants").TVReturnTypeLike<{
     size: {
+        xs: {
+            label: string;
+            hint: string;
+            value: string;
+        };
         sm: {
             value: string;
         };

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

@@ -1,4 +1,4 @@
-import type { ReactNode, Ref } from "react";
+import { type ReactNode, type Ref } from "react";
 import { Tabs as BaseTabs } from "@base-ui/react/tabs";
 import { type VariantProps } from "tailwind-variants";
 declare const tabs: import("tailwind-variants").TVReturnType<{

package/dist/types/components/drag-drop/recipe.d.ts

@@ -6,6 +6,7 @@ export declare const dnd: import("tailwind-variants").TVReturnType<{
             marker: string;
             landing: string;
             handle: string;
+            surface: string;
         };
         x: {
             container: string;
@@ -13,6 +14,7 @@ export declare const dnd: import("tailwind-variants").TVReturnType<{
             marker: string;
             landing: string;
             handle: string;
+            surface: string;
         };
     };
     moving: {
@@ -36,6 +38,7 @@ export declare const dnd: import("tailwind-variants").TVReturnType<{
     shift: string;
     marker: string[];
     landing: string;
+    surface: string[];
     handle: string[];
     overlay: string[];
 }, undefined, {
@@ -46,6 +49,7 @@ export declare const dnd: import("tailwind-variants").TVReturnType<{
             marker: string;
             landing: string;
             handle: string;
+            surface: string;
         };
         x: {
             container: string;
@@ -53,6 +57,7 @@ export declare const dnd: import("tailwind-variants").TVReturnType<{
             marker: string;
             landing: string;
             handle: string;
+            surface: string;
         };
     };
     moving: {
@@ -76,6 +81,7 @@ export declare const dnd: import("tailwind-variants").TVReturnType<{
     shift: string;
     marker: string[];
     landing: string;
+    surface: string[];
     handle: string[];
     overlay: string[];
 }, import("tailwind-variants").TVReturnTypeLike<{
@@ -86,6 +92,7 @@ export declare const dnd: import("tailwind-variants").TVReturnType<{
             marker: string;
             landing: string;
             handle: string;
+            surface: string;
         };
         x: {
             container: string;
@@ -93,6 +100,7 @@ export declare const dnd: import("tailwind-variants").TVReturnType<{
             marker: string;
             landing: string;
             handle: string;
+            surface: string;
         };
     };
     moving: {
@@ -116,6 +124,7 @@ export declare const dnd: import("tailwind-variants").TVReturnType<{
     shift: string;
     marker: string[];
     landing: string;
+    surface: string[];
     handle: string[];
     overlay: string[];
 }>>;

package/dist/types/components/kanban/recipe.d.ts

@@ -12,8 +12,7 @@ export declare const kanban: import("tailwind-variants").TVReturnType<{
     laneLabel: string;
     laneHint: string;
     laneItems: string;
-    card: string[];
-    cardHandle: string;
+    card: string;
     laneEmpty: string;
     laneRefusal: string;
 }, undefined, {
@@ -30,8 +29,7 @@ export declare const kanban: import("tailwind-variants").TVReturnType<{
     laneLabel: string;
     laneHint: string;
     laneItems: string;
-    card: string[];
-    cardHandle: string;
+    card: string;
     laneEmpty: string;
     laneRefusal: string;
 }, import("tailwind-variants").TVReturnTypeLike<{
@@ -48,8 +46,7 @@ export declare const kanban: import("tailwind-variants").TVReturnType<{
     laneLabel: string;
     laneHint: string;
     laneItems: string;
-    card: string[];
-    cardHandle: string;
+    card: string;
     laneEmpty: string;
     laneRefusal: string;
 }>>;

package/dist/types/index.d.ts

@@ -69,7 +69,7 @@ export type { Command, Edit } from "./lib/markdown/commands";
 export { toggleBold, toggleItalic, toggleCode, toggleStrike, toggleInline, setHeading, adjustHeading, headingLevel, toggleList, toggleTask, indentLines, outdentLines, toggleQuote, toggleCodeBlock, fenceAround, insertRule, insertImage, insertLink, insertTable, insertRow, insertColumn, deleteRow, deleteColumn, deleteTable, alignColumn, tableAround, cellsOf, cellAt, tableTab, smartEnter, smartTab, smartShiftTab, } from "./lib/markdown/commands";
 export { tokenize, listLanguages, resolveLanguage, defineGrammar, registerGrammar, checkCoverage, type Token, type TokenType, type Grammar, type Rule, } from "./lib/syntax";
 export { parseMarkdown, MarkdownNodes, sanitizeHref, type MdNode, type MdInline, type MdCodeRenderer, } from "./lib/syntax/markdown";
-export { DragDrop, DragDropContainer, DragDropItem, DragDropHandle, type DragDropProps, type DragDropContainerProps, type DragDropItemProps, type DragDropHandleProps, } from "./components/DragDrop";
+export { DragDrop, DragDropContainer, DragDropItem, DragDropHandle, DragDropSurface, type DragDropProps, type DragDropContainerProps, type DragDropItemProps, type DragDropHandleProps, type DragDropSurfaceProps, } from "./components/DragDrop";
 export { KanbanBoard, type KanbanBoardProps, type KanbanLane, type KanbanMove, type KanbanRefusal, } from "./components/kanban/KanbanBoard";
 export { DEFAULT_DRAG_STRINGS, DRAG_INSTRUCTIONS_ID, DragInstructions, DragLiveRegion, DragSession, DragSessionProvider, applyMove, attachAutoScroll, attachKeyboardSensor, attachPointerSensor, attachSessionWindowListeners, isNoOp, resolveTarget, sameTarget, scrollVelocity, useCreateDragSession, useDragAnnouncements, useDragSession, useDragState, useDraggable, useDropContainer, type ContainerId, type DragAxis, type DragCancelEvent, type DragEndEvent, type DragId, type DragMode, type DragPhase, type DragSessionCallbacks, type DragStartEvent, type DragState, type AutoScrollOptions, type DragAnnouncementContext, type DragAnnouncementOptions, type DragAnnouncements, type DragInstructionsProps, type DragLiveRegionProps, type DragStrings, type DropTarget, type KeyboardSensorOptions, type PointerActivation, } from "./lib/dnd";
 export type { MessageRole, MessagePart, MessagePartType, TextPart, CodePart, ReasoningPart, ToolPart, ToolStatus, FilePart, ComponentPart, ChatFile, ChatMessage, RenderContext, PartRenderer, PartRenderers, ChatComponentRenderer, ChatComponents, } from "./components/chat/types";

package/dist/types/lib/dnd/sensors/keyboard.d.ts

@@ -13,7 +13,11 @@ import type { DragAxis, DragId } from "../types";
  *
  * THE KEY MAP IS FIXED BY THE PROJECT CONTRACT, not by this file:
  *
- *   Space / Enter  pick up on a focused handle; drop when already carrying
+ *   Space          pick up; drop when already carrying
+ *   Enter          the same, but ONLY when the drag source is itself the
+ *                  focused control. On a whole-card source the key arrives by
+ *                  bubbling from the card's own button, and Enter is that
+ *                  button's — see the note at the check.
  *   Escape         cancel — handled by `attachSessionWindowListeners`, NOT here
  *   Along the axis step the insertion point inside the current container
  *   Across it      move to the previous / next container

package/dist/types/lib/motion.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The one reduced-motion answer, read from `--motion-scale`.
+ *
+ * WHY THE TOKEN AND NOT `matchMedia` DIRECTLY. `--motion-scale` is the single
+ * place where the OS media query and the app-level `data-motion` override are
+ * reconciled (see `styles/motion.css`). Reading the media query alone would
+ * ignore the in-app preference control, so a user who set "reduced" in the app
+ * on a machine with no OS setting would get full-speed motion — the exact case
+ * that control exists for. It is also why a raw `motion-reduce:` utility is the
+ * wrong tool for anything this system builds (see the note on `Choice`'s
+ * thumb): that variant reads the OS query alone and fires even for someone who
+ * has explicitly chosen `data-motion="full"`.
+ *
+ * ONLY THE COMPARISON IS EVER USED, never the value. Multiplying a SPEED by the
+ * scale would be backwards — a slower auto-scroll ramp holds the user at the
+ * edge longer and produces MORE motion overall — and a scroll has no "half"
+ * anyway: it is smooth or it is a jump.
+ *
+ * ITS OWN MODULE because two unrelated layers need it. The drag engine's edge
+ * auto-scroll had the only copy, and the tab strip's reveal-the-active-tab
+ * scroll needs exactly the same question answered exactly the same way. A
+ * second copy is a second place for the token name to go stale.
+ */
+export declare function reducedMotion(): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danxbot/ui",
-  "version": "2.8.0",
+  "version": "2.9.0",
   "type": "module",
   "description": "Danxbot — a domain-agnostic React design system with motion as a first-class primitive.",
   "license": "MIT",
@@ -69,7 +69,7 @@
     "gates": "npm run shoot && npm run a11y && node scripts/shoot-overlays.mjs && npm run probe",
     "a11y": "node scripts/a11y-scan.mjs",
     "shoot": "node scripts/shoot.mjs",
-    "probe": "node scripts/probe-scale.mjs && node scripts/probe-switch.mjs && node scripts/probe-slider.mjs && node scripts/probe-panel.mjs && node scripts/probe-popover-width.mjs && node scripts/probe-api.mjs && node scripts/probe-api-live.mjs",
+    "probe": "node scripts/probe-scale.mjs && node scripts/probe-switch.mjs && node scripts/probe-slider.mjs && node scripts/probe-panel.mjs && node scripts/probe-popover-width.mjs && node scripts/probe-api.mjs && node scripts/probe-api-live.mjs && node scripts/probe-tabs-overflow.mjs && node scripts/probe-stat-row.mjs",
     "sync": "node scripts/sync.mjs",
     "visual": "node scripts/visual-docker.mjs",
     "visual:update": "node scripts/visual-docker.mjs --update-snapshots",