@danxbot/ui 20.13.1 → 20.14.0

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

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import type { AutoScrollOptions, DragStrings } from "../lib/dnd";
+import type { AutoScrollOptions, CrossDrop, DragStrings } from "../lib/dnd";
 import type { BoardColumnModel, BoardItemId, UseBoardOptions, UseBoardResult } from "../lib/board";
 import { type BoardReorderLabels } from "./board/context";
 export interface BoardProps<T> extends UseBoardOptions<T> {
@@ -11,6 +11,23 @@ export interface BoardProps<T> extends UseBoardOptions<T> {
      * "Move to bottom".
      */
     reorderLabels?: Partial<BoardReorderLabels>;
+    /**
+     * DX-4583: what dropping a card on ANOTHER lane means.
+     *
+     * `"position"` (the default) is a drop at a place: the lane's cards part, a
+     * marker shows the slot, and the `BoardMove` carries that `index`.
+     *
+     * `"lane"` is a lane change and nothing else, for a board whose lanes are
+     * ordered by something a drop cannot set (a rank the card already has): the
+     * whole lane is highlighted, no marker shows and no card moves, and the
+     * `BoardMove` is `{ columnId, lane: true }` with no position. The card menu's
+     * "Move to <lane>" items send the same move, and the live region says the lane
+     * rather than a position. Inside the card's own lane a drag is still a
+     * positional drop either way. Whether a drag is over "another lane" is read
+     * from the drag session's own `from.container` and `over.container`, never
+     * from card counts.
+     */
+    crossLaneDrop?: CrossDrop;
     /** Forwarded to `DragDrop` — see its own doc; cannot be turned off. */
     autoScroll?: AutoScrollOptions;
     className?: string;
@@ -49,7 +66,7 @@ export interface BoardProps<T> extends UseBoardOptions<T> {
      *  returns. */
     children: (board: UseBoardResult<T>) => ReactNode;
 }
-export declare function Board<T>({ items, columns, accessors, validateMove, onMove, selection, strings, reorderLabels, autoScroll, className, columnsClassName, renderDragging, children, }: BoardProps<T>): import("react").JSX.Element;
+export declare function Board<T>({ items, columns, accessors, validateMove, onMove, selection, strings, reorderLabels, crossLaneDrop, autoScroll, className, columnsClassName, renderDragging, children, }: BoardProps<T>): import("react").JSX.Element;
 export interface BoardCardSurfaceProps {
     className?: string;
     children?: ReactNode;

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

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import { type AutoScrollOptions, type ContainerId, type DragAxis, type DragId, type DragSessionCallbacks, type DragStrings } from "../lib/dnd";
+import { type AutoScrollOptions, type ContainerId, type CrossDrop, type DragAxis, type DragId, type DragSessionCallbacks, type DragStrings } from "../lib/dnd";
 export interface DragDropProps extends DragSessionCallbacks {
     /** Override any subset of the announcement grammar — localisation, or a domain noun. */
     strings?: Partial<DragStrings>;
@@ -46,10 +46,19 @@ export interface DragDropContainerProps {
     offset?: number;
     /** The whole list's length, counting the carried item when it lives here. See `offset`. */
     total?: number;
+    /**
+     * DX-4583: what a card carried in from ANOTHER container means here.
+     * `"position"` (the default) lands it at an index, siblings parting and a
+     * marker showing where. `"lane"` lands it in this container as a whole: no gap
+     * opens and no marker shows, because there is no position to show — the
+     * consumer decides what the drop writes (see `Board`'s `crossLaneDrop`). A
+     * card carried inside its own container is always positional.
+     */
+    crossDrop?: CrossDrop;
     className?: string;
     children?: ReactNode;
 }
-export declare function DragDropContainer({ id, label, axis, offset, total, className, children, }: DragDropContainerProps): import("react").JSX.Element;
+export declare function DragDropContainer({ id, label, axis, offset, total, crossDrop, className, children, }: DragDropContainerProps): import("react").JSX.Element;
 export interface DragDropItemProps {
     id: DragId;
     /**

package/dist/types/components/board/context.d.ts

@@ -1,4 +1,5 @@
 import type { BoardColumnId, BoardColumnModel, BoardItemId, BoardMoveRequest, BoardMoveVerdict } from "../../lib/board";
+import type { CrossDrop } from "../../lib/dnd";
 export declare const BoardCardSurfaceContext: import("react").Context<boolean>;
 /** `true` when an ancestor `BoardCardSurface` makes this whole card draggable. */
 export declare function useBoardCardIsDragSource(): boolean;
@@ -23,6 +24,8 @@ export interface BoardContextValue<T> {
     requestMove: (request: BoardMoveRequest) => BoardMoveVerdict;
     /** The words for the card menu's within-column items (`Board`'s `reorderLabels`). */
     reorderLabels: BoardReorderLabels;
+    /** What a card dropped on another lane means — `Board`'s `crossLaneDrop`. */
+    crossLaneDrop: CrossDrop;
 }
 /** The card menu's within-column items. DX-4575: a consumer that calls moving inside a list something else renames them. */
 export interface BoardReorderLabels {

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

@@ -28,6 +28,7 @@ export declare const board: import("tailwind-variants").TVReturnType<{
     handleCluster: string;
     menuTrigger: string[];
     reorderLocked: string[];
+    laneDrop: string[];
     rejection: string[];
 }, undefined, {
     overWip: {
@@ -59,6 +60,7 @@ export declare const board: import("tailwind-variants").TVReturnType<{
     handleCluster: string;
     menuTrigger: string[];
     reorderLocked: string[];
+    laneDrop: string[];
     rejection: string[];
 }, import("tailwind-variants").TVReturnTypeLike<{
     overWip: {
@@ -90,5 +92,6 @@ export declare const board: import("tailwind-variants").TVReturnType<{
     handleCluster: string;
     menuTrigger: string[];
     reorderLocked: string[];
+    laneDrop: string[];
     rejection: string[];
 }>>;

package/dist/types/index.d.ts

@@ -111,11 +111,11 @@ export { tokenize, listLanguages, resolveLanguage, defineGrammar, registerGramma
 export { parseMarkdown, MarkdownNodes, sanitizeHref, type MdNode, type MdInline, type MdCodeRenderer, } from "./lib/syntax/markdown";
 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, useDragLive, 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 { DEFAULT_DRAG_STRINGS, DRAG_INSTRUCTIONS_ID, DragInstructions, DragLiveRegion, DragSession, DragSessionProvider, applyMove, attachAutoScroll, attachKeyboardSensor, attachPointerSensor, attachSessionWindowListeners, isNoOp, resolveTarget, sameTarget, scrollVelocity, useCreateDragSession, useDragAnnouncements, useDragSession, useDragState, useDragLive, useDraggable, useDropContainer, type ContainerId, type CrossDrop, 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 { Board, BoardColumn, BoardCard, BoardCardSurface, type BoardProps, type BoardColumnProps, type BoardCardProps, type BoardCardSurfaceProps, } from "./components/Board";
 export type { BoardReorderLabels } from "./components/board/context";
 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, BoardMoveRequest, BoardMoveSource, BoardMoveVerdict, UseBoardOptions, } from "./lib/board";
+export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveTarget, BoardMoveRequest, BoardMoveSource, BoardMoveVerdict, 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 type { MessageRole, MessagePart, TextPart, CodePart, ReasoningPart, ToolPart, ToolStatus, FilePart, ComponentPart, ChatFile, ChatMessage, RenderContext, PartRenderer, PartRenderers, ChatComponentRenderer, ChatComponents, } from "./components/chat/types";

package/dist/types/lib/board/anchor.d.ts

@@ -16,6 +16,10 @@
  * only at the end of the loaded run, where nothing is below, the card it lands
  * directly below (`afterId`). An empty destination names nothing.
  *
+ * A LANE MOVE NAMES NOTHING (DX-4583). It carries no position, so there is no
+ * neighbour to anchor to: the anchor is empty and the server keeps the card's
+ * own rank in the new lane.
+ *
  * AN EDGE INTENT TRUMPS THE NEIGHBOURS. "Move to top" in a window that starts
  * at card 221 means the top of the column, which no loaded neighbour can say,
  * so the anchor carries the edge and no ids.
@@ -28,6 +32,7 @@ import type { BoardEdge, BoardItemId, BoardMove } from "./types";
  *   afterId   it lands directly below this one: only when it lands after the last
  *             loaded card, where nothing is below to name
  *   edge      it goes to the very top or bottom of the whole column
+ * None is set for an empty destination and for a lane move.
  */
 export type MoveAnchor = {
     beforeId: BoardItemId;

package/dist/types/lib/board/index.d.ts

@@ -8,7 +8,7 @@
  * NOT wired into the package's top-level `src/index.ts` — that barrel is
  * owned by the contract's author, not this agent (see this round's brief).
  */
-export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveRequest, BoardMoveSource, BoardMoveVerdict, UseBoardOptions, } from "./types";
+export type { BoardAccessors, BoardColumnDef, BoardEdge, BoardColumnId, BoardColumnModel, BoardItemId, BoardMove, BoardMoveTarget, BoardMoveRequest, BoardMoveSource, BoardMoveVerdict, UseBoardOptions, } from "./types";
 export { buildBoardModel, type BoardModel } from "./model";
 export { moveAnchor, type MoveAnchor } from "./anchor";
 export { columnLength, positionInColumn } from "./position";

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

@@ -126,12 +126,30 @@ export interface BoardMove {
         columnId: BoardColumnId;
         index: number;
     };
-    to: {
-        columnId: BoardColumnId;
-        index: number;
-        edge?: BoardEdge;
-    };
+    to: BoardMoveTarget;
 }
+/**
+ * Where a move lands: a place in the destination (`index`, and optionally the
+ * `edge` it stands for), or only the destination (`lane: true`).
+ *
+ * DX-4583: a lane move names no position, so it has no `index` to be wrong
+ * about. It is what a board produces when a card is carried into another lane
+ * and the consumer decided that a lane change is not also a reorder (`Board`'s
+ * `crossLaneDrop="lane"`): the card keeps whatever rank it already has in the
+ * consumer's data. Narrow on `to.lane` before reading `to.index`, so a consumer
+ * that turns the option on cannot miss that there is no position to write.
+ */
+export type BoardMoveTarget = {
+    columnId: BoardColumnId;
+    index: number;
+    edge?: BoardEdge;
+    lane?: never;
+} | {
+    columnId: BoardColumnId;
+    lane: true;
+    index?: never;
+    edge?: never;
+};
 /**
  * Which input produced the move. Kept on the request rather than inferred
  * downstream because the three that are not `"pointer"` are the ones with no

package/dist/types/lib/dnd/announce.d.ts

@@ -6,6 +6,12 @@ export interface DragAnnouncementContext {
     /** `labelOf(id)` if supplied, otherwise the id — which is at least speakable. */
     label: string;
     container: ContainerId;
+    /**
+     * DX-4583: the container the card was picked up from. A message whose
+     * `container` differs from it describes a card in another container, which is
+     * the case where a consumer may mean "this lane" and no position at all.
+     */
+    from: ContainerId;
     containerLabel: string;
     /** 1-based, as spoken, in the WHOLE container — a windowed container reports its real offset and length (DX-4540). */
     position: number;

package/dist/types/lib/dnd/index.d.ts

@@ -6,7 +6,7 @@
  * delete, and esbuild does; that is exactly how this project once shipped an
  * empty icon registry (CAV-11).
  */
-export type { ContainerId, ContainerRect, ContainerRegistration, DragAxis, DragCancelEvent, DragEndEvent, DragId, DragMode, DragPhase, DragSessionCallbacks, DragStartEvent, DragState, DropTarget, ItemRect, ItemRegistration, LayoutSnapshot, Point, } from "./types";
+export type { ContainerId, ContainerRect, ContainerRegistration, CrossDrop, DragAxis, DragCancelEvent, DragEndEvent, DragId, DragMode, DragPhase, DragSessionCallbacks, DragStartEvent, DragState, DropTarget, ItemRect, ItemRegistration, LayoutSnapshot, Point, } from "./types";
 export { applyMove, containerAt, indexAt, isNoOp, measure, nearestContainer, remainingItems, resolveTarget, sameTarget, } from "./geometry";
 export { DragSession, type StartArgs } from "./session";
 export { attachPointerSensor, attachSessionWindowListeners, type PointerActivation, type PointerSensorOptions, } from "./sensors/pointer";

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

@@ -104,7 +104,17 @@ export interface ContainerRegistration {
     offset?: number;
     /** The whole list's length, the carried item counted in it when it lives here. See `offset`. */
     total?: number;
+    /**
+     * DX-4583: what a card carried in from ANOTHER container means here. Absent or
+     * `"position"`, it lands at an index: siblings part and a marker shows where.
+     * `"lane"`, it lands in the container as a whole and no index is meant: no gap
+     * opens, no marker shows, and the consumer decides what the drop writes. A
+     * card carried inside its own container is always positional.
+     */
+    crossDrop?: CrossDrop;
 }
+/** See `ContainerRegistration.crossDrop`. */
+export type CrossDrop = "position" | "lane";
 /** One item's measured box, taken at snapshot time. */
 export interface ItemRect {
     id: DragId;
@@ -115,6 +125,8 @@ export interface ItemRect {
 export interface ContainerRect {
     id: ContainerId;
     axis: DragAxis;
+    /** Copied from the registration — see `ContainerRegistration.crossDrop`. */
+    crossDrop?: CrossDrop;
     rect: DOMRect;
 }
 /**

package/dist/types/lib/dnd/use-drag.d.ts

@@ -1,6 +1,6 @@
 import { DragSession } from "./session";
 import type { PointerActivation } from "./sensors/pointer";
-import type { ContainerId, DragAxis, DragId, DragSessionCallbacks, DragState } from "./types";
+import type { ContainerId, CrossDrop, DragAxis, DragId, DragSessionCallbacks, DragState } from "./types";
 export declare const DragSessionProvider: import("react").Provider<DragSession | null>;
 export declare function useDragSession(component: string): DragSession;
 /**
@@ -59,6 +59,8 @@ export interface UseDropContainerOptions {
     offset?: number;
     /** See `ContainerRegistration.total` — a windowed container's whole length. */
     total?: number;
+    /** See `ContainerRegistration.crossDrop`. */
+    crossDrop?: CrossDrop;
 }
 export interface UseDropContainerResult {
     setContainerRef: (el: HTMLElement | null) => void;

package/package.json

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