@multiplatform.one/components 6.1.0 → 6.4.0

package/types/views/kanbanDnd.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Pure drag-and-drop math and keyboard state machine for the Kanban board.
+ *
+ * Everything here is platform-agnostic and side-effect free so web
+ * (`Kanban.tsx`) and native (`Kanban.native.tsx`) share one source of truth
+ * and the logic stays unit-testable without a DOM.
+ *
+ * Coordinate vocabulary:
+ * - "original index": a card's index in its column's `items` array (the
+ *   dragged card still occupies its slot — data is never mutated mid-drag).
+ * - "without-dragged index" (wd): index in the list with the dragged card
+ *   removed. Insertion targets (`KanbanDropTarget.index`) always use wd
+ *   coordinates, so a target equals the final position after the drop.
+ *
+ * All displacement is expressed as transform translate offsets (never layout
+ * props) so the same math is native-driver safe (A-GESTURE / Axiom 4).
+ */
+/** Where the dragged card would land if dropped now. */
+export interface KanbanDropTarget {
+    columnId: string;
+    /** Insertion index in without-dragged coordinates (0..wdCount). */
+    index: number;
+}
+/** Minimal board snapshot for the keyboard machine. */
+export interface KanbanBoardColumnSnapshot {
+    id: string;
+    title: string;
+    /** Item count with the dragged card still in place. */
+    count: number;
+}
+/** Active keyboard drag session (source never changes while lifted). */
+export interface KanbanKeyboardDrag {
+    sourceColumnId: string;
+    /** Original index of the lifted card in its source column. */
+    sourceIndex: number;
+    target: KanbanDropTarget;
+}
+export type KanbanMoveDirection = "up" | "down" | "left" | "right";
+export interface SiblingOffsetOptions {
+    /** Card's original index in its column. */
+    index: number;
+    /** Dragged card's original index when this column is the source, else null. */
+    sourceIndex: number | null;
+    /** Insertion index (wd coords) when this column is the drop target, else null. */
+    gapIndex: number | null;
+    /** Dragged slot size in px (wrapper height including its gap padding). */
+    size: number;
+}
+/**
+ * Transform offset (px) a sibling card translates by so the board makes room
+ * for the insertion gap. Values are always -size, 0, or +size, so siblings
+ * move with pure transforms and spring back cleanly on cancel.
+ */
+export declare function siblingOffset({ index, sourceIndex, gapIndex, size, }: SiblingOffsetOptions): number;
+export interface GapPositionOptions {
+    /** Insertion index in wd coordinates. */
+    gapIndex: number;
+    /** Dragged card's original index when this column is the source, else null. */
+    sourceIndex: number | null;
+    /** Total item count of the column (dragged card included when source). */
+    count: number;
+    /** Dragged slot size in px. */
+    size: number;
+    /** Column content total size in px (virtualizer total). */
+    totalSize: number;
+    /** Start offset (px) of the card at an original index. */
+    getStart: (index: number) => number;
+}
+/** Top offset (px) of the insertion gap inside the column's content. */
+export declare function gapPosition({ gapIndex, sourceIndex, count, size, totalSize, getStart, }: GapPositionOptions): number;
+export interface RenderedCardMeasurement {
+    /** Original index in the column. */
+    index: number;
+    /** Start offset in px (column content coordinates). */
+    start: number;
+    /** Measured size in px. */
+    size: number;
+}
+export interface InsertionIndexOptions {
+    /** Pointer y in column content coordinates (client y − content top + scrollTop). */
+    localY: number;
+    /** Rendered (virtualized) card measurements sorted by index. */
+    items: RenderedCardMeasurement[];
+    /** Dragged card's original index when this column is the source, else null. */
+    sourceIndex: number | null;
+    /** Total item count of the column (dragged card included when source). */
+    count: number;
+    /** Dragged slot size in px. */
+    size: number;
+}
+/**
+ * Insertion index (wd coordinates) for a pointer at `localY`. Uses the
+ * midpoint rule (Trello/dnd-kit consensus): the gap lands after every card
+ * whose without-dragged midpoint sits above the pointer.
+ */
+export declare function insertionIndexForY({ localY, items, sourceIndex, count, size, }: InsertionIndexOptions): number;
+/**
+ * Closed-form insertion index for uniform card sizes (native path — FlashList
+ * does not expose per-item measurements). Equivalent to the midpoint rule.
+ */
+export declare function uniformInsertionIndex(localY: number, size: number, wdCount: number): number;
+export interface AutoScrollOptions {
+    /** Pointer position along the scroll axis (client coords). */
+    pos: number;
+    /** Viewport start edge (client coords). */
+    start: number;
+    /** Viewport end edge (client coords). */
+    end: number;
+    /** Edge activation zone in px. */
+    edge: number;
+    /** Max scroll speed in px per frame. */
+    maxSpeed: number;
+}
+/**
+ * Signed scroll velocity (px/frame) for edge auto-scroll. Speed ramps
+ * linearly with proximity to the edge and saturates at `maxSpeed` when the
+ * pointer reaches or passes it.
+ */
+export declare function autoScrollVelocity({ pos, start, end, edge, maxSpeed }: AutoScrollOptions): number;
+/** Max insertion index for a column (wd coordinates). */
+export declare function maxInsertionIndex(board: KanbanBoardColumnSnapshot[], drag: Pick<KanbanKeyboardDrag, "sourceColumnId">, columnId: string): number;
+/** Begin a keyboard drag session. Returns null when the card does not exist. */
+export declare function keyboardLift(board: KanbanBoardColumnSnapshot[], columnId: string, index: number): KanbanKeyboardDrag | null;
+/**
+ * Move the drop target one step. Returns the same session object when the
+ * move hits a boundary so callers can detect no-ops by identity.
+ */
+export declare function keyboardMove(drag: KanbanKeyboardDrag, board: KanbanBoardColumnSnapshot[], direction: KanbanMoveDirection): KanbanKeyboardDrag;
+export interface KanbanDropResult {
+    /** False when the card lands exactly where it started. */
+    commit: boolean;
+    from: {
+        columnId: string;
+        index: number;
+    };
+    to: KanbanDropTarget;
+}
+/** Resolve a drop for the current target (keyboard and pointer share this). */
+export declare function resolveDrop(drag: Pick<KanbanKeyboardDrag, "sourceColumnId" | "sourceIndex" | "target">): KanbanDropResult;
+export type KanbanAnnouncement = {
+    type: "lift";
+    card: string;
+    column: string;
+    position: number;
+    count: number;
+} | {
+    type: "move";
+    card: string;
+    column: string;
+    position: number;
+    count: number;
+} | {
+    type: "drop";
+    card: string;
+    column: string;
+    position: number;
+    count: number;
+} | {
+    type: "cancel";
+    card: string;
+    column: string;
+};
+/**
+ * Structured announcement payload for the aria-live region. Positions are
+ * 1-based and `count` is the column's size after the pending drop, matching
+ * the "position 2 of 3" phrasing of the WAI-ARIA drag pattern.
+ */
+export declare function describeDragState(type: "lift" | "move" | "drop", drag: Pick<KanbanKeyboardDrag, "sourceColumnId" | "sourceIndex" | "target">, board: KanbanBoardColumnSnapshot[], card: string): KanbanAnnouncement;
+export declare function describeCancel(drag: Pick<KanbanKeyboardDrag, "sourceColumnId">, board: KanbanBoardColumnSnapshot[], card: string): KanbanAnnouncement;
+//# sourceMappingURL=kanbanDnd.d.ts.map

package/types/views/kanbanDnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kanbanDnd.d.ts","sourceRoot":"","sources":["../../src/views/kanbanDnd.ts"],"names":[],"mappings":"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"}

package/types/views/treeViewDnd.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Pure drag-reorder math and keyboard state machine for the TreeView.
+ *
+ * Everything here is platform-agnostic and side-effect free (same discipline
+ * as `kanbanDnd.ts` / `treeViewMotion.ts`) so the logic stays unit-testable
+ * without a DOM and a future native fork shares one source of truth (LC-16).
+ *
+ * Coordinate vocabulary (mirrors kanbanDnd):
+ * - "original index": a node's index in its parent's `children` array (the
+ *   dragged node still occupies its slot — data is never mutated mid-drag).
+ * - "without-dragged index" (wd): index in the sibling list with the dragged
+ *   node removed. Drop targets (`TreeDropTarget.index`) always use wd
+ *   coordinates, so a target equals the final position after the drop.
+ *
+ * The keyboard grammar is the kanban grammar mapped onto a tree (LC-43):
+ * up/down move the insertion point among the current parent's positions,
+ * right nests into the previous sibling, left un-nests to after the parent.
+ */
+/** Minimal tree shape the DnD math needs (TreeNode satisfies this). */
+export interface DndTreeNode {
+    id: string;
+    label?: string;
+    children?: DndTreeNode[];
+}
+/** Where the dragged node would land if dropped now. */
+export interface TreeDropTarget {
+    /** Destination parent id; null = top level. */
+    parentId: string | null;
+    /** Insertion index among the parent's children (wd coordinates, 0..wdCount). */
+    index: number;
+}
+/** Active drag session (source never changes while lifted). */
+export interface TreeDragSession {
+    nodeId: string;
+    sourceParentId: string | null;
+    /** Original index of the lifted node in its parent's children. */
+    sourceIndex: number;
+    target: TreeDropTarget;
+}
+export type TreeMoveDirection = "up" | "down" | "left" | "right";
+/** Flattened visible row enriched with the structure DnD math needs. */
+export interface TreeDndRow {
+    id: string;
+    parentId: string | null;
+    /** Index within the parent's children (original coordinates). */
+    childIndex: number;
+    depth: number;
+    hasChildren: boolean;
+    isExpanded: boolean;
+}
+/**
+ * Row-fraction bands for the pointer drop model (VS Code / Notion consensus):
+ * the top band inserts before the row, the bottom band inserts after it, and
+ * the middle band nests into it. Recognition geometry per LC-43's exemption.
+ */
+export declare const DROP_BAND_BEFORE = 0.25;
+export declare const DROP_BAND_AFTER = 0.75;
+/** Node + its location, or null when the id is absent. */
+export declare function locateNode(nodes: readonly DndTreeNode[], id: string): {
+    node: DndTreeNode;
+    parentId: string | null;
+    index: number;
+} | null;
+/** Children array of a parent (null = the roots). Missing parent → empty. */
+export declare function childrenOf(nodes: readonly DndTreeNode[], parentId: string | null): readonly DndTreeNode[];
+/** Ids of a node and every descendant (the unit that moves together). */
+export declare function subtreeIds(nodes: readonly DndTreeNode[], id: string): Set<string>;
+/** Visible rows for a given expansion state, with DnD structure attached. */
+export declare function flattenDndRows(nodes: readonly DndTreeNode[], expandedIds: ReadonlySet<string>): TreeDndRow[];
+/** Child count of a parent in wd coordinates for an active session. */
+export declare function wdChildCount(nodes: readonly DndTreeNode[], session: Pick<TreeDragSession, "nodeId" | "sourceParentId">, parentId: string | null): number;
+/** Convert an original child index to wd coordinates for an active session. */
+export declare function toWdIndex(session: Pick<TreeDragSession, "sourceParentId" | "sourceIndex">, parentId: string | null, childIndex: number): number;
+/** Begin a keyboard drag session. Returns null when the node does not exist. */
+export declare function treeKeyboardLift(nodes: readonly DndTreeNode[], nodeId: string): TreeDragSession | null;
+/**
+ * Move the drop target one step. Returns the same session object when the
+ * move hits a boundary so callers can detect no-ops by identity.
+ *
+ * Grammar: up/down step among the current parent's insertion positions,
+ * right nests into the previous sibling (append as its last child), left
+ * un-nests (insert after the current parent in the grandparent).
+ */
+export declare function treeKeyboardMove(session: TreeDragSession, nodes: readonly DndTreeNode[], direction: TreeMoveDirection): TreeDragSession;
+export interface TreeDropResult {
+    /** False when the node lands exactly where it started. */
+    commit: boolean;
+    from: {
+        parentId: string | null;
+        index: number;
+    };
+    to: TreeDropTarget;
+}
+/** Resolve a drop for the current target (keyboard and pointer share this). */
+export declare function resolveTreeDrop(session: Pick<TreeDragSession, "sourceParentId" | "sourceIndex" | "target">): TreeDropResult;
+/** Visual result of a hit-test: a line between rows or a nest-into parent. */
+export type TreeDropIndicator = {
+    kind: "line";
+    /** The line renders above the visible row at this flat index (rows.length = list end). */
+    flatIndex: number;
+    /** Indent depth the line should render at. */
+    depth: number;
+} | {
+    kind: "into";
+    parentId: string;
+};
+export interface TreeDropHit {
+    target: TreeDropTarget;
+    indicator: TreeDropIndicator;
+}
+export interface TreeDropHitOptions {
+    /** Pointer y in list content coordinates (client y − list top + scrollOffset). */
+    localY: number;
+    /** Visible rows in visual order (dragged subtree included, still in place). */
+    rows: readonly TreeDndRow[];
+    /** Row height in px (measured when available, estimated otherwise). */
+    getHeight: (id: string) => number;
+    session: Pick<TreeDragSession, "nodeId" | "sourceParentId" | "sourceIndex">;
+    /** Ids of the dragged node and its descendants (invalid drop zone). */
+    draggedSubtree: ReadonlySet<string>;
+}
+/**
+ * Drop target + indicator for a pointer at `localY`, or null when the pointer
+ * sits over the dragged subtree (callers keep their previous target).
+ *
+ * Band model per row (recognition constants above): top band inserts before
+ * the row, bottom band inserts after it (which for an expanded branch means
+ * first-child position), middle band nests into the row (append as last
+ * child) — the parent-highlight case.
+ */
+export declare function treeDropTargetForY({ localY, rows, getHeight, session, draggedSubtree, }: TreeDropHitOptions): TreeDropHit | null;
+/**
+ * Indicator for a keyboard target. Falls back to the nest-into highlight when
+ * the destination parent has no visible children (collapsed or empty), where
+ * no between-rows line exists.
+ */
+export declare function indicatorForTarget(rows: readonly TreeDndRow[], session: Pick<TreeDragSession, "nodeId" | "sourceParentId" | "sourceIndex">, target: TreeDropTarget): TreeDropIndicator;
+/**
+ * Apply a move to a tree, returning a new tree (nodes untouched on invalid
+ * moves: unknown node, target inside the dragged subtree). `target.index` is
+ * in wd coordinates, matching `onNodeMove` payloads, so consumers can apply
+ * the callback directly: `setNodes((n) => applyTreeMove(n, nodeId, target))`.
+ */
+export declare function applyTreeMove<N extends DndTreeNode>(nodes: readonly N[], nodeId: string, target: TreeDropTarget): N[];
+export type TreeDragAnnouncement = {
+    type: "lift" | "move" | "drop";
+    node: string;
+    /** Destination parent label; null = top level (caller localizes). */
+    parent: string | null;
+    position: number;
+    count: number;
+} | {
+    type: "cancel";
+    node: string;
+    parent: string | null;
+};
+/**
+ * Structured announcement payload for the aria-live region. Positions are
+ * 1-based and `count` is the sibling list's size after the pending drop,
+ * matching the kanban grammar's "position 2 of 3" phrasing (LC-43).
+ */
+export declare function describeTreeDragState(type: "lift" | "move" | "drop", session: TreeDragSession, nodes: readonly DndTreeNode[], nodeLabel: string): TreeDragAnnouncement;
+export declare function describeTreeCancel(session: Pick<TreeDragSession, "sourceParentId">, nodes: readonly DndTreeNode[], nodeLabel: string): TreeDragAnnouncement;
+//# sourceMappingURL=treeViewDnd.d.ts.map

package/types/views/treeViewDnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeViewDnd.d.ts","sourceRoot":"","sources":["../../src/views/treeViewDnd.ts"],"names":[],"mappings":"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"}

package/types/views/treeViewMotion.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Pure expand/collapse motion math for the TreeView.
+ *
+ * Everything here is platform-agnostic and side-effect free (same discipline
+ * as `kanbanDnd.ts`) so web and native share one source of truth and the
+ * logic stays unit-testable without a DOM.
+ *
+ * Motion vocabulary (Axiom 4): a toggle is a *discrete jump* — surviving rows
+ * FLIP from their previous offset to their new one and newly revealed rows
+ * fade in, all tweened by the component layer with `knobProps.transition`
+ * (LC-25). Offsets are expressed as transform translate deltas (never layout
+ * props) so the same math is native-driver safe. Initial mount never animates
+ * (mount is not a jump) and `animation: none` / reduced motion skips the
+ * machine entirely.
+ */
+/** Minimal tree shape needed to compute visible rows. */
+export interface MotionTreeNode {
+    id: string;
+    children?: MotionTreeNode[];
+}
+/**
+ * Ids of the rows a tree renders for a given expansion state, in visual
+ * order. Mirrors the component's flatten walk so motion diffs and rendering
+ * can never disagree about what is visible.
+ */
+export declare function flattenVisibleIds(nodes: readonly MotionTreeNode[], expandedIds: ReadonlySet<string>): string[];
+/** One toggle's worth of motion: who fades in, and who slides from where. */
+export interface TreeRowMotionDiff {
+    /** Rows that just became visible (expand) — enter with fade/slide. */
+    entering: Set<string>;
+    /**
+     * Transform offset (px) a surviving row starts at so it begins the tween at
+     * its previous visual position (FLIP invert). Positive = the row starts
+     * lower than its new slot (collapse above it), negative = higher (expand
+     * above it). Rows with a zero delta are omitted.
+     */
+    deltas: Map<string, number>;
+}
+/**
+ * Diff two visible-row lists into FLIP deltas + entering rows.
+ *
+ * `getHeight` supplies each row's height in px (measured when available,
+ * estimated otherwise) so offsets stay correct with mixed row heights.
+ * Rows removed by a collapse simply unmount — the closing motion is carried
+ * by the surviving rows sliding up over the vacated space, which keeps the
+ * whole animation transform-only (no height/layout tweens).
+ */
+export declare function diffVisibleRows(prevIds: readonly string[], nextIds: readonly string[], getHeight: (id: string) => number): TreeRowMotionDiff;
+/** True when a diff carries no motion (toggle produced an identical list). */
+export declare function isEmptyDiff(diff: TreeRowMotionDiff): boolean;
+//# sourceMappingURL=treeViewMotion.d.ts.map

package/types/views/treeViewMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeViewMotion.d.ts","sourceRoot":"","sources":["../../src/views/treeViewMotion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAC/B,MAAM,EAAE,CAYV;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB;;;;;OAKG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,GAChC,iBAAiB,CAwBnB;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAE5D"}