@alneas/appkit-react 0.2.0 → 0.3.1

package/dist/tools/components/kanban/kanban-primitives.d.ts

@@ -1,18 +1,85 @@
 import { KanbanColumn, KanbanTask } from './types.js';
 import { useKanbanDrag } from './use-kanban-drag.js';
 import * as React from 'react';
-/** Internal shared D&D boundary; the overlay never registers a second draggable. */
+/**
+ * Render the native Kanban provider and one body-portal overlay.
+ * @param props - Native controller, optional overlay class and registered children.
+ * @returns The provider and overlay; no portal is created during server rendering.
+ * @remarks Uses immediate drop completion with native focus restoration. The
+ * overlay is presentation only and never registers a second draggable.
+ * @example
+ * ```tsx
+ * import {KanbanDragSurface, KanbanColumnFrame, KanbanDraggableCard, useKanbanDrag}
+ *   from '@alneas/appkit-react/tools/kanban';
+ * import '@alneas/appkit-react/styles';
+ * export function CustomCards() {
+ *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];
+ *   const controller = useKanbanDrag({tasks});
+ *   return <KanbanDragSurface controller={controller}>
+ *     <KanbanColumnFrame column={{id: 'todo', title: 'Todo'}}>
+ *       <KanbanDraggableCard task={tasks[0]}>Review</KanbanDraggableCard>
+ *     </KanbanColumnFrame>
+ *   </KanbanDragSurface>;
+ * }
+ * ```
+ */
 export declare function KanbanDragSurface({ controller, overlayClassName, children, }: {
     controller: ReturnType<typeof useKanbanDrag>;
     overlayClassName?: string;
     children: React.ReactNode;
 }): React.JSX.Element;
-/** Single sortable registration shared by preset cards and Compound cards with custom children. */
-export declare function KanbanDraggableCard({ task, disabled, className, children, ...props }: React.HTMLAttributes<HTMLDivElement> & {
+/**
+ * Register a native status-only Kanban card with custom content.
+ * @param props - Task, optional disabled flag (default false), HTML attributes,
+ * custom style and children. Caller-supplied accessibility attributes are retained.
+ * @returns A div registered under the native Kanban surface.
+ * @remarks Requires the same native provider as KanbanColumnFrame. Disabled cards
+ * have no automatic drag tab stop; this component does not persist order or status.
+ * @example
+ * ```tsx
+ * import {KanbanDragSurface, KanbanColumnFrame, KanbanDraggableCard, useKanbanDrag}
+ *   from '@alneas/appkit-react/tools/kanban';
+ * import '@alneas/appkit-react/styles';
+ * export function CustomCards() {
+ *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];
+ *   const controller = useKanbanDrag({tasks});
+ *   return <KanbanDragSurface controller={controller}>
+ *     <KanbanColumnFrame column={{id: 'todo', title: 'Todo'}}>
+ *       <KanbanDraggableCard task={tasks[0]}>Review</KanbanDraggableCard>
+ *     </KanbanColumnFrame>
+ *   </KanbanDragSurface>;
+ * }
+ * ```
+ */
+export declare function KanbanDraggableCard({ task, disabled, className, children, style, ...props }: React.HTMLAttributes<HTMLDivElement> & {
     task: KanbanTask;
     disabled?: boolean;
 }): React.JSX.Element;
-/** Shared column registration and drag-over presentation; headers and contents remain composable. */
+/**
+ * Register a native Kanban column while retaining host-composed content.
+ * @remarks Retain forwardRef to compose native registration and caller refs, including
+ * callback cleanup; this is not a direct DOM-ref passthrough.
+ * Requires the native Kanban surface. Pointer intersection excludes outside
+ * drops; WIP limits are presentational and do not reject a host status callback.
+ * @param props - Column metadata, optional limit presentation, HTML attributes and children.
+ * @param ref - Forwarded div ref, including React 19 callback cleanup support.
+ * @returns A column div accepting Kanban task registrations.
+ * @example
+ * ```tsx
+ * import {KanbanDragSurface, KanbanColumnFrame, KanbanDraggableCard, useKanbanDrag}
+ *   from '@alneas/appkit-react/tools/kanban';
+ * import '@alneas/appkit-react/styles';
+ * export function CustomCards() {
+ *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];
+ *   const controller = useKanbanDrag({tasks});
+ *   return <KanbanDragSurface controller={controller}>
+ *     <KanbanColumnFrame column={{id: 'todo', title: 'Todo'}}>
+ *       <KanbanDraggableCard task={tasks[0]}>Review</KanbanDraggableCard>
+ *     </KanbanColumnFrame>
+ *   </KanbanDragSurface>;
+ * }
+ * ```
+ */
 export declare const KanbanColumnFrame: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & {
     column: KanbanColumn;
     isOverLimit?: boolean;

package/dist/tools/components/kanban/kanban-primitives.js

@@ -1,74 +1,97 @@
 "use client";
 import { cn as e } from "../../../ui/lib/utils.js";
-import { KanbanCardView as t } from "./KanbanCardView.js";
-import { jsx as n, jsxs as r } from "react/jsx-runtime";
-import * as i from "react";
-import { DndContext as a, DragOverlay as o, useDroppable as s } from "@dnd-kit/core";
-import { useSortable as c } from "@dnd-kit/sortable";
-import { CSS as l } from "@dnd-kit/utilities";
-import { createPortal as u } from "react-dom";
+import { useAccessibleDragRef as t } from "../ui/dnd/use-accessible-drag-ref.js";
+import { KanbanCardView as n } from "./KanbanCardView.js";
+import { jsx as r, jsxs as i } from "react/jsx-runtime";
+import * as a from "react";
+import { DragDropProvider as o, DragOverlay as s, useDraggable as c, useDroppable as l } from "@dnd-kit/react";
+import { pointerIntersection as u } from "@dnd-kit/collision";
+import { createPortal as d } from "react-dom";
 //#region src/tools/components/kanban/kanban-primitives.tsx
-function d({ controller: e, overlayClassName: i, children: s }) {
-	let c = e.activeTask && /* @__PURE__ */ n(t, { task: e.activeTask });
-	return /* @__PURE__ */ r(a, {
+function f({ controller: e, overlayClassName: t, children: a }) {
+	let c = e.activeTask && /* @__PURE__ */ r(n, { task: e.activeTask });
+	return /* @__PURE__ */ i(o, {
 		...e.contextProps,
-		children: [s, typeof document < "u" && u(/* @__PURE__ */ n(o, { children: c && (i ? /* @__PURE__ */ n("div", {
-			className: i,
-			children: c
-		}) : c) }), document.body)]
+		children: [a, typeof document < "u" && d(/* @__PURE__ */ r(s, {
+			dropAnimation: { duration: 0 },
+			children: c && (t ? /* @__PURE__ */ r("div", {
+				className: t,
+				children: c
+			}) : c)
+		}), document.body)]
 	});
 }
-function f({ task: t, disabled: r, className: i, children: a, ...o }) {
-	let { setNodeRef: s, attributes: u, listeners: d, transform: f, transition: p, isDragging: m } = c({
-		id: t.id,
+function p({ task: n, disabled: i, className: o, children: s, style: l, ...u }) {
+	let { ref: d, draggable: f, isDragging: p } = c({
+		id: n.id,
+		type: "kanban-task",
 		data: {
 			type: "Task",
-			task: t
-		},
-		disabled: r
-	});
-	return /* @__PURE__ */ n("div", {
-		ref: s,
-		style: {
-			transition: p,
-			transform: l.Transform.toString(f)
+			task: n
 		},
-		...r ? {} : u,
-		...r ? {} : d,
-		"data-task-id": t.id,
-		...o,
-		className: e("cursor-grab active:cursor-grabbing", r && "cursor-default", m && "opacity-30", i),
-		children: a
+		disabled: i
+	}), m = a.useRef(null), h = a.useCallback((e) => {
+		m.current = e, d(i ? null : e);
+	}, [d, i]), g = t(h, !i);
+	return a.useLayoutEffect(() => {
+		if (i) {
+			let e = f.manager?.registry.draggables.get(n.id);
+			e && (e.element = void 0);
+			for (let e of [
+				"tabindex",
+				"role",
+				"aria-roledescription",
+				"aria-describedby",
+				"aria-disabled",
+				"aria-pressed",
+				"aria-grabbed"
+			]) {
+				let t = u[e === "tabindex" ? "tabIndex" : e];
+				t == null ? m.current?.removeAttribute(e) : m.current?.setAttribute(e, String(t));
+			}
+		}
+	}), /* @__PURE__ */ r("div", {
+		ref: g,
+		tabIndex: i ? void 0 : 0,
+		role: i ? void 0 : "button",
+		"aria-roledescription": i ? void 0 : "draggable",
+		style: l,
+		"data-task-id": n.id,
+		...u,
+		className: e("cursor-grab active:cursor-grabbing", i && "cursor-default", p && "opacity-30", o),
+		children: s
 	});
 }
-var p = i.forwardRef(({ column: t, isOverLimit: r, className: a, children: o, ...c }, l) => {
-	let { setNodeRef: u, isOver: d } = s({
+var m = a.forwardRef(({ column: t, isOverLimit: n, className: i, children: o, ...s }, c) => {
+	let { ref: d, isDropTarget: f } = l({
 		id: t.id,
+		accept: "kanban-task",
+		collisionDetector: u,
 		data: {
 			type: "Column",
 			column: t
 		}
-	}), f = i.useCallback((e) => {
-		if (u(e), typeof l == "function") {
-			let t = l(e);
+	}), p = a.useCallback((e) => {
+		if (d(e), typeof c == "function") {
+			let t = c(e);
 			if (typeof t == "function") return () => {
-				u(null), t();
+				d(null), t();
 			};
-		} else l && (l.current = e);
-	}, [u, l]);
-	return /* @__PURE__ */ n("div", {
-		ref: f,
+		} else c && (c.current = e);
+	}, [d, c]);
+	return /* @__PURE__ */ r("div", {
+		ref: p,
 		"data-slot": "kanban-column",
 		"data-column-id": t.id,
-		"data-over": d || void 0,
-		"data-over-limit": r || void 0,
-		...c,
-		className: e("flex h-full w-[320px] min-w-[320px] flex-col rounded-lg bg-muted/30 dark:bg-muted/10 p-3 transition-colors duration-200", d && "bg-primary/5 ring-2 ring-primary/20", r && "bg-destructive/5", a),
+		"data-over": f || void 0,
+		"data-over-limit": n || void 0,
+		...s,
+		className: e("flex h-full w-[320px] min-w-[320px] flex-col rounded-lg bg-muted/30 dark:bg-muted/10 p-3 transition-colors duration-200", f && "bg-primary/5 ring-2 ring-primary/20", n && "bg-destructive/5", i),
 		children: o
 	});
 });
-p.displayName = "KanbanColumnFrame";
+m.displayName = "KanbanColumnFrame";
 //#endregion
-export { p as KanbanColumnFrame, d as KanbanDragSurface, f as KanbanDraggableCard };
+export { m as KanbanColumnFrame, f as KanbanDragSurface, p as KanbanDraggableCard };
 
 //# sourceMappingURL=kanban-primitives.js.map

package/dist/tools/components/kanban/kanban-primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"kanban-primitives.js","names":["React","React$1","KanbanDragSurface","card","controller","KanbanCardView","DndContext","children","createPortal","DragOverlay","overlayClassName","KanbanDraggableCard","props","useSortable","task","setNodeRef","CSS","transform","disabled","attributes","listeners","cn","isDragging","className","KanbanColumnFrame","useDroppable","column","composedRef","node","ref","cleanup","isOver","isOverLimit"],"sources":["../../../../src/tools/components/kanban/kanban-primitives.tsx"],"sourcesContent":["import * as React from 'react';\nimport { createPortal } from 'react-dom';\nimport { DndContext, DragOverlay, useDroppable } from '@dnd-kit/core';\nimport { useSortable } from '@dnd-kit/sortable';\nimport { CSS } from '@dnd-kit/utilities';\nimport { cn } from '../../lib/utils';\nimport { KanbanCardView } from './KanbanCardView';\nimport type { KanbanColumn, KanbanTask } from './types';\nimport type { useKanbanDrag } from './use-kanban-drag';\n\n/** Internal shared D&D boundary; the overlay never registers a second draggable. */\nexport function KanbanDragSurface({\n  controller,\n  overlayClassName,\n  children,\n}: {\n  controller: ReturnType<typeof useKanbanDrag>;\n  overlayClassName?: string;\n  children: React.ReactNode;\n}) {\n  const card = controller.activeTask && <KanbanCardView task={controller.activeTask} />;\n  return (\n    <DndContext {...controller.contextProps}>\n      {children}\n      {typeof document !== 'undefined' &&\n        createPortal(\n          <DragOverlay>\n            {card && (overlayClassName ? <div className={overlayClassName}>{card}</div> : card)}\n          </DragOverlay>,\n          document.body,\n        )}\n    </DndContext>\n  );\n}\n\n/** Single sortable registration shared by preset cards and Compound cards with custom children. */\nexport function KanbanDraggableCard({\n  task,\n  disabled,\n  className,\n  children,\n  ...props\n}: React.HTMLAttributes<HTMLDivElement> & { task: KanbanTask; disabled?: boolean }) {\n  const { setNodeRef, attributes, listeners, transform, transition, isDragging } = useSortable({\n    id: task.id,\n    data: { type: 'Task', task },\n    disabled,\n  });\n  return (\n    <div\n      ref={setNodeRef}\n      style={{ transition, transform: CSS.Transform.toString(transform) }}\n      {...(!disabled ? attributes : {})}\n      {...(!disabled ? listeners : {})}\n      data-task-id={task.id}\n      {...props}\n      className={cn(\n        'cursor-grab active:cursor-grabbing',\n        disabled && 'cursor-default',\n        isDragging && 'opacity-30',\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n}\n\n/** Shared column registration and drag-over presentation; headers and contents remain composable. */\nexport const KanbanColumnFrame = React.forwardRef<\n  HTMLDivElement,\n  React.HTMLAttributes<HTMLDivElement> & { column: KanbanColumn; isOverLimit?: boolean }\n>(({ column, isOverLimit, className, children, ...props }, ref) => {\n  const { setNodeRef, isOver } = useDroppable({\n    id: column.id,\n    data: { type: 'Column', column },\n  });\n  const composedRef = React.useCallback(\n    (node: HTMLDivElement | null) => {\n      setNodeRef(node);\n      if (typeof ref === 'function') {\n        // ForwardedRef also supports React 18's void return type; React 19 may return cleanup.\n        const cleanup: unknown = ref(node);\n        if (typeof cleanup === 'function')\n          return () => {\n            setNodeRef(null);\n            cleanup();\n          };\n      } else if (ref) ref.current = node;\n    },\n    [setNodeRef, ref],\n  );\n  return (\n    <div\n      ref={composedRef}\n      data-slot='kanban-column'\n      data-column-id={column.id}\n      data-over={isOver || undefined}\n      data-over-limit={isOverLimit || undefined}\n      {...props}\n      className={cn(\n        'flex h-full w-[320px] min-w-[320px] flex-col rounded-lg bg-muted/30 dark:bg-muted/10 p-3 transition-colors duration-200',\n        isOver && 'bg-primary/5 ring-2 ring-primary/20',\n        isOverLimit && 'bg-destructive/5',\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n});\nKanbanColumnFrame.displayName = 'KanbanColumnFrame';\n"],"mappings":";;;;;;;;;;AAWA,SAAgBE,EAAkB,EAChC,eACA,qBACA,eAKC;CACD,IAAMC,IAAOC,EAAW,cAAc,kBAACC,GAAD,EAAgB,MAAMD,EAAW,WAAa,CAAA;CACpF,OACE,kBAACE,GAAD;EAAY,GAAIF,EAAW;EAA3B,UAAA,CACGG,GACA,OAAO,WAAa,OACnBC,EACE,kBAACC,GAAD,EAAA,UACGN,MAASO,IAAmB,kBAAC,OAAD;GAAK,WAAWA;GAAmB,UAAAP;EAAU,CAAA,IAAIA,GACnE,CAAA,GACb,SAAS,IACX,CACQ;;AAEhB;AAGA,SAAgBQ,EAAoB,EAClC,SACA,aACA,cACA,aACA,GAAGC,KAC+E;CAClF,IAAM,EAAE,eAAY,eAAY,cAAW,cAAW,eAAY,kBAAeC,EAAY;EAC3F,IAAIC,EAAK;EACT,MAAM;GAAE,MAAM;GAAQ;EAAK;EAC3B;CACF,CAAC;CACD,OACE,kBAAC,OAAD;EACE,KAAKC;EACL,OAAO;GAAE;GAAY,WAAWC,EAAI,UAAU,SAASC,CAAS;EAAE;EAClE,GAAMC,IAAwB,CAAC,IAAdC;EACjB,GAAMD,IAAuB,CAAC,IAAbE;EACjB,gBAAcN,EAAK;EACnB,GAAIF;EACJ,WAAWS,EACT,sCACAH,KAAY,kBACZI,KAAc,cACdC,CACF;EAEC;CACE,CAAA;AAET;AAGA,IAAaC,IAAoBxB,EAAM,YAGpC,EAAE,WAAQ,gBAAa,cAAW,aAAU,GAAGY,KAAS,MAAQ;CACjE,IAAM,EAAE,eAAY,cAAWa,EAAa;EAC1C,IAAIC,EAAO;EACX,MAAM;GAAE,MAAM;GAAU;EAAO;CACjC,CAAC,GACKC,IAAc3B,EAAM,aACvB,MAAgC;EAE/B,IADAe,EAAWa,CAAI,GACX,OAAOC,KAAQ,YAAY;GAE7B,IAAMC,IAAmBD,EAAID,CAAI;GACjC,IAAI,OAAOE,KAAY,YACrB,aAAa;IAEX,AADAf,EAAW,IAAI,GACfe,EAAQ;GACV;EACJ,OAAO,AAAID,MAAK,EAAI,UAAUD;CAChC,GACA,CAACb,GAAYc,CAAG,CAClB;CACA,OACE,kBAAC,OAAD;EACE,KAAKF;EACL,aAAU;EACV,kBAAgBD,EAAO;EACvB,aAAWK,KAAU,KAAA;EACrB,mBAAiBC,KAAe,KAAA;EAChC,GAAIpB;EACJ,WAAWS,EACT,2HACAU,KAAU,uCACVC,KAAe,oBACfT,CACF;EAEC;CACE,CAAA;AAET,CAAC;AACD,EAAkB,cAAc"}
+{"version":3,"file":"kanban-primitives.js","names":["React","React$1","KanbanDragSurface","card","controller","KanbanCardView","DragDropProvider","children","createPortal","DragOverlay","overlayClassName","KanbanDraggableCard","props","useDraggable","task","elementRef","cardRef","element","ref","disabled","accessibleCardRef","useAccessibleDragRef","registered","draggable","attribute","supplied","cn","isDragging","className","KanbanColumnFrame","setNodeRef","isOver","useDroppable","column","pointerIntersection","composedRef","node","cleanup","isOverLimit"],"sources":["../../../../src/tools/components/kanban/kanban-primitives.tsx"],"sourcesContent":["import * as React from 'react';\nimport { createPortal } from 'react-dom';\nimport { DragDropProvider, DragOverlay, useDraggable, useDroppable } from '@dnd-kit/react';\nimport { pointerIntersection } from '@dnd-kit/collision';\nimport { cn } from '../../lib/utils';\nimport {useAccessibleDragRef} from '../ui/dnd/use-accessible-drag-ref';\nimport { KanbanCardView } from './KanbanCardView';\nimport type { KanbanColumn, KanbanTask } from './types';\nimport type { useKanbanDrag } from './use-kanban-drag';\n\n/**\n * Render the native Kanban provider and one body-portal overlay.\n * @param props - Native controller, optional overlay class and registered children.\n * @returns The provider and overlay; no portal is created during server rendering.\n * @remarks Uses immediate drop completion with native focus restoration. The\n * overlay is presentation only and never registers a second draggable.\n * @example\n * ```tsx\n * import {KanbanDragSurface, KanbanColumnFrame, KanbanDraggableCard, useKanbanDrag}\n *   from '@alneas/appkit-react/tools/kanban';\n * import '@alneas/appkit-react/styles';\n * export function CustomCards() {\n *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];\n *   const controller = useKanbanDrag({tasks});\n *   return <KanbanDragSurface controller={controller}>\n *     <KanbanColumnFrame column={{id: 'todo', title: 'Todo'}}>\n *       <KanbanDraggableCard task={tasks[0]}>Review</KanbanDraggableCard>\n *     </KanbanColumnFrame>\n *   </KanbanDragSurface>;\n * }\n * ```\n */\nexport function KanbanDragSurface({\n  controller,\n  overlayClassName,\n  children,\n}: {\n  controller: ReturnType<typeof useKanbanDrag>;\n  overlayClassName?: string;\n  children: React.ReactNode;\n}) {\n  const card = controller.activeTask && <KanbanCardView task={controller.activeTask} />;\n  return (\n    <DragDropProvider {...controller.contextProps}>\n      {children}\n      {typeof document !== 'undefined' &&\n        createPortal(\n          <DragOverlay dropAnimation={{duration: 0}}>\n            {card && (overlayClassName ? <div className={overlayClassName}>{card}</div> : card)}\n          </DragOverlay>,\n          document.body,\n        )}\n    </DragDropProvider>\n  );\n}\n\n/**\n * Register a native status-only Kanban card with custom content.\n * @param props - Task, optional disabled flag (default false), HTML attributes,\n * custom style and children. Caller-supplied accessibility attributes are retained.\n * @returns A div registered under the native Kanban surface.\n * @remarks Requires the same native provider as KanbanColumnFrame. Disabled cards\n * have no automatic drag tab stop; this component does not persist order or status.\n * @example\n * ```tsx\n * import {KanbanDragSurface, KanbanColumnFrame, KanbanDraggableCard, useKanbanDrag}\n *   from '@alneas/appkit-react/tools/kanban';\n * import '@alneas/appkit-react/styles';\n * export function CustomCards() {\n *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];\n *   const controller = useKanbanDrag({tasks});\n *   return <KanbanDragSurface controller={controller}>\n *     <KanbanColumnFrame column={{id: 'todo', title: 'Todo'}}>\n *       <KanbanDraggableCard task={tasks[0]}>Review</KanbanDraggableCard>\n *     </KanbanColumnFrame>\n *   </KanbanDragSurface>;\n * }\n * ```\n */\nexport function KanbanDraggableCard({\n  task,\n  disabled,\n  className,\n  children,\n  style,\n  ...props\n}: React.HTMLAttributes<HTMLDivElement> & { task: KanbanTask; disabled?: boolean }) {\n  const { ref, draggable, isDragging } = useDraggable({\n    id: task.id,\n    type: 'kanban-task',\n    data: { type: 'Task', task },\n    disabled,\n  });\n  const elementRef = React.useRef<HTMLDivElement | null>(null);\n  const cardRef = React.useCallback((element: HTMLDivElement | null) => {\n    elementRef.current = element;\n    ref(disabled ? null : element);\n  }, [ref, disabled]);\n  const accessibleCardRef = useAccessibleDragRef(cardRef, !disabled);\n  React.useLayoutEffect(() => {\n    // Native ref cleanup retains an active source. Explicitly detach read-only\n    // cards so Accessibility cannot restore drag attributes after React clears them.\n    if (disabled) {\n      const registered = draggable.manager?.registry.draggables.get(task.id);\n      if (registered) registered.element = undefined;\n      for (const attribute of ['tabindex', 'role', 'aria-roledescription', 'aria-describedby', 'aria-disabled', 'aria-pressed', 'aria-grabbed']) {\n        const supplied = props[attribute === 'tabindex' ? 'tabIndex' : attribute as keyof typeof props];\n        if (supplied == null) elementRef.current?.removeAttribute(attribute);\n        else elementRef.current?.setAttribute(attribute, String(supplied));\n      }\n    }\n  });\n  return (\n    <div\n      ref={accessibleCardRef}\n      tabIndex={disabled ? undefined : 0}\n      role={disabled ? undefined : 'button'}\n      aria-roledescription={disabled ? undefined : 'draggable'}\n      style={style}\n      data-task-id={task.id}\n      {...props}\n      className={cn(\n        'cursor-grab active:cursor-grabbing',\n        disabled && 'cursor-default',\n        isDragging && 'opacity-30',\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n}\n\n/**\n * Register a native Kanban column while retaining host-composed content.\n * @remarks Retain forwardRef to compose native registration and caller refs, including\n * callback cleanup; this is not a direct DOM-ref passthrough.\n * Requires the native Kanban surface. Pointer intersection excludes outside\n * drops; WIP limits are presentational and do not reject a host status callback.\n * @param props - Column metadata, optional limit presentation, HTML attributes and children.\n * @param ref - Forwarded div ref, including React 19 callback cleanup support.\n * @returns A column div accepting Kanban task registrations.\n * @example\n * ```tsx\n * import {KanbanDragSurface, KanbanColumnFrame, KanbanDraggableCard, useKanbanDrag}\n *   from '@alneas/appkit-react/tools/kanban';\n * import '@alneas/appkit-react/styles';\n * export function CustomCards() {\n *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];\n *   const controller = useKanbanDrag({tasks});\n *   return <KanbanDragSurface controller={controller}>\n *     <KanbanColumnFrame column={{id: 'todo', title: 'Todo'}}>\n *       <KanbanDraggableCard task={tasks[0]}>Review</KanbanDraggableCard>\n *     </KanbanColumnFrame>\n *   </KanbanDragSurface>;\n * }\n * ```\n */\nexport const KanbanColumnFrame = React.forwardRef<\n  HTMLDivElement,\n  React.HTMLAttributes<HTMLDivElement> & { column: KanbanColumn; isOverLimit?: boolean }\n>(({ column, isOverLimit, className, children, ...props }, ref) => {\n  const { ref: setNodeRef, isDropTarget: isOver } = useDroppable({\n    id: column.id,\n    accept: 'kanban-task',\n    collisionDetector: pointerIntersection,\n    data: { type: 'Column', column },\n  });\n  const composedRef = React.useCallback(\n    (node: HTMLDivElement | null) => {\n      setNodeRef(node);\n      if (typeof ref === 'function') {\n        // ForwardedRef also supports React 18's void return type; React 19 may return cleanup.\n        const cleanup: unknown = ref(node);\n        if (typeof cleanup === 'function')\n          return () => {\n            setNodeRef(null);\n            cleanup();\n          };\n      } else if (ref) ref.current = node;\n    },\n    [setNodeRef, ref],\n  );\n  return (\n    <div\n      ref={composedRef}\n      data-slot='kanban-column'\n      data-column-id={column.id}\n      data-over={isOver || undefined}\n      data-over-limit={isOverLimit || undefined}\n      {...props}\n      className={cn(\n        'flex h-full w-[320px] min-w-[320px] flex-col rounded-lg bg-muted/30 dark:bg-muted/10 p-3 transition-colors duration-200',\n        isOver && 'bg-primary/5 ring-2 ring-primary/20',\n        isOverLimit && 'bg-destructive/5',\n        className,\n      )}\n    >\n      {children}\n    </div>\n  );\n});\nKanbanColumnFrame.displayName = 'KanbanColumnFrame';\n"],"mappings":";;;;;;;;;;AAgCA,SAAgBE,EAAkB,EAChC,eACA,qBACA,eAKC;CACD,IAAMC,IAAOC,EAAW,cAAc,kBAACC,GAAD,EAAgB,MAAMD,EAAW,WAAa,CAAA;CACpF,OACE,kBAACE,GAAD;EAAkB,GAAIF,EAAW;EAAjC,UAAA,CACGG,GACA,OAAO,WAAa,OACnBC,EACE,kBAACC,GAAD;GAAa,eAAe,EAAC,UAAU,EAAC;GACrC,UAAAN,MAASO,IAAmB,kBAAC,OAAD;IAAK,WAAWA;IAAmB,UAAAP;GAAU,CAAA,IAAIA;EACnE,CAAA,GACb,SAAS,IACX,CACc;;AAEtB;AAyBA,SAAgBQ,EAAoB,EAClC,SACA,aACA,cACA,aACA,UACA,GAAGC,KAC+E;CAClF,IAAM,EAAE,QAAK,cAAW,kBAAeC,EAAa;EAClD,IAAIC,EAAK;EACT,MAAM;EACN,MAAM;GAAE,MAAM;GAAQ;EAAK;EAC3B;CACF,CAAC,GACKC,IAAaf,EAAM,OAA8B,IAAI,GACrDgB,IAAUhB,EAAM,aAAa,MAAmC;EAEpE,AADA,EAAW,UAAUiB,GACrBC,EAAIC,IAAW,OAAOF,CAAO;CAC/B,GAAG,CAACC,GAAKC,CAAQ,CAAC,GACZC,IAAoBC,EAAqBL,GAAS,CAACG,CAAQ;CAcjE,OAbAlB,EAAM,sBAAsB;EAG1B,IAAIkB,GAAU;GACZ,IAAMG,IAAaC,EAAU,SAAS,SAAS,WAAW,IAAIT,EAAK,EAAE;GACrE,AAAIQ,MAAY,EAAW,UAAU,KAAA;GACrC,KAAK,IAAME,KAAa;IAAC;IAAY;IAAQ;IAAwB;IAAoB;IAAiB;IAAgB;GAAc,GAAG;IACzI,IAAMC,IAAWb,EAAMY,MAAc,aAAa,aAAaA;IAC/D,AAAIC,KAAY,OAAMV,EAAW,SAAS,gBAAgBS,CAAS,IAC9DT,EAAW,SAAS,aAAaS,GAAW,OAAOC,CAAQ,CAAC;GACnE;EACF;CACF,CAAC,GAEC,kBAAC,OAAD;EACE,KAAKL;EACL,UAAUD,IAAW,KAAA,IAAY;EACjC,MAAMA,IAAW,KAAA,IAAY;EAC7B,wBAAsBA,IAAW,KAAA,IAAY;EACtC;EACP,gBAAcL,EAAK;EACnB,GAAIF;EACJ,WAAWc,EACT,sCACAP,KAAY,kBACZQ,KAAc,cACdC,CACF;EAEC;CACE,CAAA;AAET;AA2BA,IAAaC,IAAoB7B,EAAM,YAGpC,EAAE,WAAQ,gBAAa,cAAW,aAAU,GAAGY,KAAS,MAAQ;CACjE,IAAM,EAAE,KAAKkB,GAAY,cAAcC,MAAWC,EAAa;EAC7D,IAAIC,EAAO;EACX,QAAQ;EACR,mBAAmBC;EACnB,MAAM;GAAE,MAAM;GAAU;EAAO;CACjC,CAAC,GACKC,IAAcnC,EAAM,aACvB,MAAgC;EAE/B,IADA8B,EAAWM,CAAI,GACX,OAAOlB,KAAQ,YAAY;GAE7B,IAAMmB,IAAmBnB,EAAIkB,CAAI;GACjC,IAAI,OAAOC,KAAY,YACrB,aAAa;IAEX,AADAP,EAAW,IAAI,GACfO,EAAQ;GACV;EACJ,OAAO,AAAInB,MAAK,EAAI,UAAUkB;CAChC,GACA,CAACN,GAAYZ,CAAG,CAClB;CACA,OACE,kBAAC,OAAD;EACE,KAAKiB;EACL,aAAU;EACV,kBAAgBF,EAAO;EACvB,aAAWF,KAAU,KAAA;EACrB,mBAAiBO,KAAe,KAAA;EAChC,GAAI1B;EACJ,WAAWc,EACT,2HACAK,KAAU,uCACVO,KAAe,oBACfV,CACF;EAEC;CACE,CAAA;AAET,CAAC;AACD,EAAkB,cAAc"}

package/dist/tools/components/kanban/use-kanban-drag.cjs

@@ -1,2 +1,2 @@
-"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../_virtual/_rolldown/runtime.cjs"),t=require("./kanban-drag.cjs"),n=require("./use-kanban-sensors.cjs");let r=require("react");r=e.__toESM(r,1);function i({tasks:e,columns:i,statusField:a=`status`,readOnly:o=!1,onStatusChange:s}){let[c,l]=r.useState(null),u=n.useKanbanSensors(a),d=o?null:e.find(e=>e.id===c)??null,f=r.useCallback(({active:t})=>{let n=e.find(e=>e.id===t.id);l(!o&&n?n.id:null)},[e,o]),p=r.useCallback(()=>l(null),[]),m=r.useCallback(n=>{if(l(null),o)return;let r=t.resolveKanbanMove(n,e,a,i);r&&s?.(r.taskId,r.status)},[e,i,a,o,s]);return{activeTask:d,contextProps:{sensors:u,accessibility:n.kanbanAccessibility,onDragStart:f,onDragEnd:m,onDragCancel:p}}}exports.useKanbanDrag=i;
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../../../_virtual/_rolldown/runtime.cjs"),t=require("./kanban-events.cjs"),n=require("./use-kanban-sensors.cjs");let r=require("react");r=e.__toESM(r,1);let i=require("@dnd-kit/dom");var a=e=>[...e,i.Accessibility.configure(n.kanbanAccessibility)];function o({tasks:e,columns:i,statusField:o=`status`,readOnly:s=!1,onStatusChange:c}){let[l,u]=r.useState(null),d=n.useKanbanSensors(o);return{activeTask:s?null:e.find(e=>e.id===l)??null,contextProps:{sensors:d,plugins:a,onBeforeDragStart:t=>{(s||!e.some(e=>e.id===t.operation.source?.id))&&t.preventDefault()},onDragStart:t=>{let n=e.find(e=>e.id===t.operation.source?.id);u(!s&&n?n.id:null)},onDragEnd:(n,r)=>{if(u(null),s||!n.operation.target||!r.registry.droppables.get(n.operation.target.id))return;let a=t.resolveKanbanDrop(n,e,o,i);a&&c?.(a.taskId,a.status)}}}}exports.useKanbanDrag=o;
 //# sourceMappingURL=use-kanban-drag.cjs.map

package/dist/tools/components/kanban/use-kanban-drag.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-kanban-drag.cjs","names":["React","useKanbanSensors","resolveKanbanMove","kanbanAccessibility","require_runtime","require_tools_components_kanban_kanban_drag","require_tools_components_kanban_use_kanban_sensors","react","useKanbanDrag","activeId","setActiveId","sensors","statusField","activeTask","readOnly","tasks","task","onDragStart","candidate","active","onDragCancel","onDragEnd","move","event","columns","onStatusChange"],"sources":["../../../../src/tools/components/kanban/use-kanban-drag.ts"],"sourcesContent":["import * as React from 'react';\nimport type { DragEndEvent, DragStartEvent } from '@dnd-kit/core';\nimport { resolveKanbanMove } from './kanban-drag';\nimport { useKanbanSensors, kanbanAccessibility } from './use-kanban-sensors';\nimport type { KanbanBoardProps } from './types';\n\ntype KanbanDragOptions = Pick<\n  KanbanBoardProps,\n  'tasks' | 'statusField' | 'readOnly' | 'onStatusChange'\n> &\n  Partial<Pick<KanbanBoardProps, 'columns'>>;\n\n/** Shared interaction lifecycle. State ownership (optimistic or controlled) stays with the caller. */\nexport function useKanbanDrag({\n  tasks,\n  columns,\n  statusField = 'status',\n  readOnly = false,\n  onStatusChange,\n}: KanbanDragOptions) {\n  const [activeId, setActiveId] = React.useState<string | null>(null);\n  const sensors = useKanbanSensors(statusField);\n  const activeTask = readOnly ? null : (tasks.find((task) => task.id === activeId) ?? null);\n\n  const onDragStart = React.useCallback(\n    ({ active }: DragStartEvent) => {\n      const task = tasks.find((candidate) => candidate.id === active.id);\n      setActiveId(!readOnly && task ? task.id : null);\n    },\n    [tasks, readOnly],\n  );\n  const onDragCancel = React.useCallback(() => setActiveId(null), []);\n  const onDragEnd = React.useCallback(\n    (event: DragEndEvent) => {\n      setActiveId(null);\n      if (readOnly) return;\n      const move = resolveKanbanMove(event, tasks, statusField, columns);\n      if (move) onStatusChange?.(move.taskId, move.status);\n    },\n    [tasks, columns, statusField, readOnly, onStatusChange],\n  );\n\n  return {\n    activeTask,\n    contextProps: {\n      sensors,\n      accessibility: kanbanAccessibility,\n      onDragStart,\n      onDragEnd,\n      onDragCancel,\n    },\n  };\n}\n"],"mappings":"A,wPAaA,SAAgBQ,EAAc,CAC5B,QACA,UACA,cAAc,SACd,WAAW,GACX,kBACoB,CACpB,GAAM,CAACC,EAAUC,GAAeV,EAAM,SAAwB,IAAI,EAC5DW,EAAUV,EAAAA,iBAAiBW,CAAW,EACtCC,EAAaC,EAAW,KAAQC,EAAM,KAAM,GAASC,EAAK,KAAOP,CAAQ,GAAK,KAE9EQ,EAAcjB,EAAM,aACvB,CAAE,YAA6B,CAC9B,IAAMgB,EAAOD,EAAM,KAAM,GAAcG,EAAU,KAAOC,EAAO,EAAE,EACjET,EAAY,CAACI,GAAYE,EAAOA,EAAK,GAAK,IAAI,CAChD,EACA,CAACD,EAAOD,CAAQ,CAClB,EACMM,EAAepB,EAAM,gBAAkBU,EAAY,IAAI,EAAG,CAAC,CAAC,EAC5DW,EAAYrB,EAAM,YACrB,GAAwB,CAEvB,GADAU,EAAY,IAAI,EACZI,EAAU,OACd,IAAMQ,EAAOpB,EAAAA,kBAAkBqB,EAAOR,EAAOH,EAAaY,CAAO,EAC7DF,GAAMG,IAAiBH,EAAK,OAAQA,EAAK,MAAM,CACrD,EACA,CAACP,EAAOS,EAASZ,EAAaE,EAAUW,CAAc,CACxD,EAEA,MAAO,CACL,aACA,aAAc,CACZ,UACA,cAAetB,EAAAA,oBACf,cACA,YACA,cACF,CACF,CACF,C"}
+{"version":3,"file":"use-kanban-drag.cjs","names":["Accessibility","kanbanAccessibility","React","useKanbanSensors","resolveKanbanDrop","require_runtime","require_tools_components_kanban_kanban_events","require_tools_components_kanban_use_kanban_sensors","react","_dnd_kit_dom","plugins","defaults","useKanbanDrag","activeId","setActiveId","sensors","statusField","readOnly","tasks","task","event","manager","move","columns","onStatusChange"],"sources":["../../../../src/tools/components/kanban/use-kanban-drag.ts"],"sourcesContent":["import * as React from 'react';\nimport {DragDropProvider} from '@dnd-kit/react';\nimport {Accessibility} from '@dnd-kit/dom';\nimport {resolveKanbanDrop} from './kanban-events';\nimport {useKanbanSensors, kanbanAccessibility} from './use-kanban-sensors';\nimport type {KanbanBoardProps, KanbanTask} from './types';\n\ntype KanbanDragOptions = Pick<KanbanBoardProps, 'tasks' | 'statusField' | 'readOnly' | 'onStatusChange'> & Partial<Pick<KanbanBoardProps, 'columns'>>;\ntype NativeContextProps = Omit<React.ComponentProps<typeof DragDropProvider>, 'children'>;\n/** Native drag state and provider props used by KanbanDragSurface. */\nexport interface KanbanDragController {\n  /** Current task, or null when idle, removed or read-only. */\n  activeTask: KanbanTask | null;\n  /** Native provider props; legacy DndContext controllers are incompatible. */\n  contextProps: NativeContextProps;\n}\nconst plugins: NativeContextProps['plugins'] = defaults => [...defaults, Accessibility.configure(kanbanAccessibility)];\n\n/**\n * Control a status-only Kanban drag using native provider events and sensors.\n * @param options - Current tasks, optional columns, statusField (default status),\n * readOnly (default false) and the status-change callback. Hosts own durable state.\n * @returns The active task or null and native props for KanbanDragSurface.\n * @remarks No within-column ordering is persisted. Canceled, removed or read-only\n * operations do not notify a status change. Use the migrated surface/provider;\n * contextProps is not a legacy DndContext prop object.\n * @example\n * ```tsx\n * import {KanbanDragSurface, KanbanColumn, useKanbanDrag} from '@alneas/appkit-react/tools/kanban';\n * import '@alneas/appkit-react/styles';\n * export function CustomBoard() {\n *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];\n *   const controller = useKanbanDrag({tasks});\n *   return <KanbanDragSurface controller={controller}>\n *     <KanbanColumn column={{id: 'todo', title: 'Todo'}} tasks={tasks} />\n *     <KanbanColumn column={{id: 'done', title: 'Done'}} tasks={[]} />\n *   </KanbanDragSurface>;\n * }\n * ```\n */\nexport function useKanbanDrag({tasks, columns, statusField = 'status', readOnly = false, onStatusChange}: KanbanDragOptions): KanbanDragController {\n  const [activeId, setActiveId] = React.useState<string | null>(null);\n  const sensors = useKanbanSensors(statusField);\n  const activeTask = readOnly ? null : (tasks.find(task => task.id === activeId) ?? null);\n  const onBeforeDragStart: NativeContextProps['onBeforeDragStart'] = event => {\n    if (readOnly || !tasks.some(task => task.id === event.operation.source?.id)) event.preventDefault();\n  };\n  const onDragStart: NativeContextProps['onDragStart'] = event => {\n    const task = tasks.find(task => task.id === event.operation.source?.id);\n    setActiveId(!readOnly && task ? task.id : null);\n  };\n  const onDragEnd: NativeContextProps['onDragEnd'] = (event, manager) => {\n    setActiveId(null);\n    if (readOnly || !event.operation.target || !manager.registry.droppables.get(event.operation.target.id)) return;\n    const move = resolveKanbanDrop(event, tasks, statusField, columns);\n    if (move) onStatusChange?.(move.taskId, move.status);\n  };\n  return {activeTask, contextProps: {sensors, plugins, onBeforeDragStart, onDragStart, onDragEnd}};\n}\n"],"mappings":"A,wRAgBA,IAAMU,EAAyC,GAAY,CAAC,GAAGC,EAAUX,EAAAA,cAAc,UAAUC,EAAAA,mBAAmB,CAAC,EAwBrH,SAAgBW,EAAc,CAAC,QAAO,UAAS,cAAc,SAAU,WAAW,GAAO,kBAA0D,CACjJ,GAAM,CAACC,EAAUC,GAAeZ,EAAM,SAAwB,IAAI,EAC5Da,EAAUZ,EAAAA,iBAAiBa,CAAW,EAe5C,MAAO,CAAC,WAdWC,EAAW,KAAQC,EAAM,KAAK,GAAQC,EAAK,KAAON,CAAQ,GAAK,KAc9D,aAAc,CAAC,UAAS,UAAS,kBAbc,GAAS,EACtEI,GAAY,CAACC,EAAM,KAAK,GAAQC,EAAK,KAAOC,EAAM,UAAU,QAAQ,EAAE,IAAGA,EAAM,eAAe,CACpG,EAWwE,YAVjB,GAAS,CAC9D,IAAMD,EAAOD,EAAM,KAAK,GAAQC,EAAK,KAAOC,EAAM,UAAU,QAAQ,EAAE,EACtEN,EAAY,CAACG,GAAYE,EAAOA,EAAK,GAAK,IAAI,CAChD,EAOqF,WANjC,EAAO,IAAY,CAErE,GADAL,EAAY,IAAI,EACZG,GAAY,CAACG,EAAM,UAAU,QAAU,CAACC,EAAQ,SAAS,WAAW,IAAID,EAAM,UAAU,OAAO,EAAE,EAAG,OACxG,IAAME,EAAOlB,EAAAA,kBAAkBgB,EAAOF,EAAOF,EAAaO,CAAO,EAC7DD,GAAME,IAAiBF,EAAK,OAAQA,EAAK,MAAM,CACrD,CAC8F,CAAC,CACjG,C"}

package/dist/tools/components/kanban/use-kanban-drag.d.cts

@@ -1,19 +1,36 @@
-import { DragEndEvent, DragStartEvent } from '@dnd-kit/core';
-import { KanbanBoardProps } from './types.cjs';
+import { DragDropProvider } from '@dnd-kit/react';
+import { KanbanBoardProps, KanbanTask } from './types.cjs';
+import * as React from 'react';
 type KanbanDragOptions = Pick<KanbanBoardProps, 'tasks' | 'statusField' | 'readOnly' | 'onStatusChange'> & Partial<Pick<KanbanBoardProps, 'columns'>>;
-/** Shared interaction lifecycle. State ownership (optimistic or controlled) stays with the caller. */
-export declare function useKanbanDrag({ tasks, columns, statusField, readOnly, onStatusChange, }: KanbanDragOptions): {
-    activeTask: import('./types.cjs').KanbanTask | null;
-    contextProps: {
-        sensors: import('@dnd-kit/core').SensorDescriptor<import('@dnd-kit/core').SensorOptions>[];
-        accessibility: {
-            screenReaderInstructions: {
-                draggable: string;
-            };
-        };
-        onDragStart: ({ active }: DragStartEvent) => void;
-        onDragEnd: (event: DragEndEvent) => void;
-        onDragCancel: () => void;
-    };
-};
+type NativeContextProps = Omit<React.ComponentProps<typeof DragDropProvider>, 'children'>;
+/** Native drag state and provider props used by KanbanDragSurface. */
+export interface KanbanDragController {
+    /** Current task, or null when idle, removed or read-only. */
+    activeTask: KanbanTask | null;
+    /** Native provider props; legacy DndContext controllers are incompatible. */
+    contextProps: NativeContextProps;
+}
+/**
+ * Control a status-only Kanban drag using native provider events and sensors.
+ * @param options - Current tasks, optional columns, statusField (default status),
+ * readOnly (default false) and the status-change callback. Hosts own durable state.
+ * @returns The active task or null and native props for KanbanDragSurface.
+ * @remarks No within-column ordering is persisted. Canceled, removed or read-only
+ * operations do not notify a status change. Use the migrated surface/provider;
+ * contextProps is not a legacy DndContext prop object.
+ * @example
+ * ```tsx
+ * import {KanbanDragSurface, KanbanColumn, useKanbanDrag} from '@alneas/appkit-react/tools/kanban';
+ * import '@alneas/appkit-react/styles';
+ * export function CustomBoard() {
+ *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];
+ *   const controller = useKanbanDrag({tasks});
+ *   return <KanbanDragSurface controller={controller}>
+ *     <KanbanColumn column={{id: 'todo', title: 'Todo'}} tasks={tasks} />
+ *     <KanbanColumn column={{id: 'done', title: 'Done'}} tasks={[]} />
+ *   </KanbanDragSurface>;
+ * }
+ * ```
+ */
+export declare function useKanbanDrag({ tasks, columns, statusField, readOnly, onStatusChange }: KanbanDragOptions): KanbanDragController;
 export {};

package/dist/tools/components/kanban/use-kanban-drag.d.ts

@@ -1,19 +1,36 @@
-import { DragEndEvent, DragStartEvent } from '@dnd-kit/core';
-import { KanbanBoardProps } from './types.js';
+import { DragDropProvider } from '@dnd-kit/react';
+import { KanbanBoardProps, KanbanTask } from './types.js';
+import * as React from 'react';
 type KanbanDragOptions = Pick<KanbanBoardProps, 'tasks' | 'statusField' | 'readOnly' | 'onStatusChange'> & Partial<Pick<KanbanBoardProps, 'columns'>>;
-/** Shared interaction lifecycle. State ownership (optimistic or controlled) stays with the caller. */
-export declare function useKanbanDrag({ tasks, columns, statusField, readOnly, onStatusChange, }: KanbanDragOptions): {
-    activeTask: import('./types.js').KanbanTask | null;
-    contextProps: {
-        sensors: import('@dnd-kit/core').SensorDescriptor<import('@dnd-kit/core').SensorOptions>[];
-        accessibility: {
-            screenReaderInstructions: {
-                draggable: string;
-            };
-        };
-        onDragStart: ({ active }: DragStartEvent) => void;
-        onDragEnd: (event: DragEndEvent) => void;
-        onDragCancel: () => void;
-    };
-};
+type NativeContextProps = Omit<React.ComponentProps<typeof DragDropProvider>, 'children'>;
+/** Native drag state and provider props used by KanbanDragSurface. */
+export interface KanbanDragController {
+    /** Current task, or null when idle, removed or read-only. */
+    activeTask: KanbanTask | null;
+    /** Native provider props; legacy DndContext controllers are incompatible. */
+    contextProps: NativeContextProps;
+}
+/**
+ * Control a status-only Kanban drag using native provider events and sensors.
+ * @param options - Current tasks, optional columns, statusField (default status),
+ * readOnly (default false) and the status-change callback. Hosts own durable state.
+ * @returns The active task or null and native props for KanbanDragSurface.
+ * @remarks No within-column ordering is persisted. Canceled, removed or read-only
+ * operations do not notify a status change. Use the migrated surface/provider;
+ * contextProps is not a legacy DndContext prop object.
+ * @example
+ * ```tsx
+ * import {KanbanDragSurface, KanbanColumn, useKanbanDrag} from '@alneas/appkit-react/tools/kanban';
+ * import '@alneas/appkit-react/styles';
+ * export function CustomBoard() {
+ *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];
+ *   const controller = useKanbanDrag({tasks});
+ *   return <KanbanDragSurface controller={controller}>
+ *     <KanbanColumn column={{id: 'todo', title: 'Todo'}} tasks={tasks} />
+ *     <KanbanColumn column={{id: 'done', title: 'Done'}} tasks={[]} />
+ *   </KanbanDragSurface>;
+ * }
+ * ```
+ */
+export declare function useKanbanDrag({ tasks, columns, statusField, readOnly, onStatusChange }: KanbanDragOptions): KanbanDragController;
 export {};

package/dist/tools/components/kanban/use-kanban-drag.js

@@ -1,35 +1,33 @@
 "use client";
-import { resolveKanbanMove as e } from "./kanban-drag.js";
+import { resolveKanbanDrop as e } from "./kanban-events.js";
 import { kanbanAccessibility as t, useKanbanSensors as n } from "./use-kanban-sensors.js";
 import * as r from "react";
+import { Accessibility as i } from "@dnd-kit/dom";
 //#region src/tools/components/kanban/use-kanban-drag.ts
-function i({ tasks: i, columns: a, statusField: o = "status", readOnly: s = !1, onStatusChange: c }) {
-	let [l, u] = r.useState(null), d = n(o), f = s ? null : i.find((e) => e.id === l) ?? null, p = r.useCallback(({ active: e }) => {
-		let t = i.find((t) => t.id === e.id);
-		u(!s && t ? t.id : null);
-	}, [i, s]), m = r.useCallback(() => u(null), []), h = r.useCallback((t) => {
-		if (u(null), s) return;
-		let n = e(t, i, o, a);
-		n && c?.(n.taskId, n.status);
-	}, [
-		i,
-		a,
-		o,
-		s,
-		c
-	]);
+var a = (e) => [...e, i.configure(t)];
+function o({ tasks: t, columns: i, statusField: o = "status", readOnly: s = !1, onStatusChange: c }) {
+	let [l, u] = r.useState(null), d = n(o);
 	return {
-		activeTask: f,
+		activeTask: s ? null : t.find((e) => e.id === l) ?? null,
 		contextProps: {
 			sensors: d,
-			accessibility: t,
-			onDragStart: p,
-			onDragEnd: h,
-			onDragCancel: m
+			plugins: a,
+			onBeforeDragStart: (e) => {
+				(s || !t.some((t) => t.id === e.operation.source?.id)) && e.preventDefault();
+			},
+			onDragStart: (e) => {
+				let n = t.find((t) => t.id === e.operation.source?.id);
+				u(!s && n ? n.id : null);
+			},
+			onDragEnd: (n, r) => {
+				if (u(null), s || !n.operation.target || !r.registry.droppables.get(n.operation.target.id)) return;
+				let a = e(n, t, o, i);
+				a && c?.(a.taskId, a.status);
+			}
 		}
 	};
 }
 //#endregion
-export { i as useKanbanDrag };
+export { o as useKanbanDrag };
 
 //# sourceMappingURL=use-kanban-drag.js.map

package/dist/tools/components/kanban/use-kanban-drag.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-kanban-drag.js","names":["React","React$1","useKanbanDrag","activeId","setActiveId","sensors","useKanbanSensors","statusField","activeTask","readOnly","tasks","task","onDragStart","candidate","active","onDragCancel","onDragEnd","move","resolveKanbanMove","event","columns","onStatusChange","kanbanAccessibility"],"sources":["../../../../src/tools/components/kanban/use-kanban-drag.ts"],"sourcesContent":["import * as React from 'react';\nimport type { DragEndEvent, DragStartEvent } from '@dnd-kit/core';\nimport { resolveKanbanMove } from './kanban-drag';\nimport { useKanbanSensors, kanbanAccessibility } from './use-kanban-sensors';\nimport type { KanbanBoardProps } from './types';\n\ntype KanbanDragOptions = Pick<\n  KanbanBoardProps,\n  'tasks' | 'statusField' | 'readOnly' | 'onStatusChange'\n> &\n  Partial<Pick<KanbanBoardProps, 'columns'>>;\n\n/** Shared interaction lifecycle. State ownership (optimistic or controlled) stays with the caller. */\nexport function useKanbanDrag({\n  tasks,\n  columns,\n  statusField = 'status',\n  readOnly = false,\n  onStatusChange,\n}: KanbanDragOptions) {\n  const [activeId, setActiveId] = React.useState<string | null>(null);\n  const sensors = useKanbanSensors(statusField);\n  const activeTask = readOnly ? null : (tasks.find((task) => task.id === activeId) ?? null);\n\n  const onDragStart = React.useCallback(\n    ({ active }: DragStartEvent) => {\n      const task = tasks.find((candidate) => candidate.id === active.id);\n      setActiveId(!readOnly && task ? task.id : null);\n    },\n    [tasks, readOnly],\n  );\n  const onDragCancel = React.useCallback(() => setActiveId(null), []);\n  const onDragEnd = React.useCallback(\n    (event: DragEndEvent) => {\n      setActiveId(null);\n      if (readOnly) return;\n      const move = resolveKanbanMove(event, tasks, statusField, columns);\n      if (move) onStatusChange?.(move.taskId, move.status);\n    },\n    [tasks, columns, statusField, readOnly, onStatusChange],\n  );\n\n  return {\n    activeTask,\n    contextProps: {\n      sensors,\n      accessibility: kanbanAccessibility,\n      onDragStart,\n      onDragEnd,\n      onDragCancel,\n    },\n  };\n}\n"],"mappings":";;;;;AAaA,SAAgBE,EAAc,EAC5B,UACA,YACA,iBAAc,UACd,cAAW,IACX,qBACoB;CACpB,IAAM,CAACC,GAAUC,KAAeJ,EAAM,SAAwB,IAAI,GAC5DK,IAAUC,EAAiBC,CAAW,GACtCC,IAAaC,IAAW,OAAQC,EAAM,MAAM,MAASC,EAAK,OAAOR,CAAQ,KAAK,MAE9ES,IAAcZ,EAAM,aACvB,EAAE,gBAA6B;EAC9B,IAAMW,IAAOD,EAAM,MAAM,MAAcG,EAAU,OAAOC,EAAO,EAAE;EACjE,EAAY,CAACL,KAAYE,IAAOA,EAAK,KAAK,IAAI;CAChD,GACA,CAACD,GAAOD,CAAQ,CAClB,GACMM,IAAef,EAAM,kBAAkBI,EAAY,IAAI,GAAG,CAAC,CAAC,GAC5DY,IAAYhB,EAAM,aACrB,MAAwB;EAEvB,IADAI,EAAY,IAAI,GACZK,GAAU;EACd,IAAMQ,IAAOC,EAAkBC,GAAOT,GAAOH,GAAaa,CAAO;EACjE,AAAIH,KAAMI,IAAiBJ,EAAK,QAAQA,EAAK,MAAM;CACrD,GACA;EAACP;EAAOU;EAASb;EAAaE;EAAUY;CAAc,CACxD;CAEA,OAAO;EACL;EACA,cAAc;GACZ;GACA,eAAeC;GACf;GACA;GACA;EACF;CACF;AACF"}
+{"version":3,"file":"use-kanban-drag.js","names":["React","React$1","plugins","defaults","Accessibility","kanbanAccessibility","useKanbanDrag","activeId","setActiveId","sensors","useKanbanSensors","statusField","readOnly","tasks","task","event","manager","move","resolveKanbanDrop","columns","onStatusChange"],"sources":["../../../../src/tools/components/kanban/use-kanban-drag.ts"],"sourcesContent":["import * as React from 'react';\nimport {DragDropProvider} from '@dnd-kit/react';\nimport {Accessibility} from '@dnd-kit/dom';\nimport {resolveKanbanDrop} from './kanban-events';\nimport {useKanbanSensors, kanbanAccessibility} from './use-kanban-sensors';\nimport type {KanbanBoardProps, KanbanTask} from './types';\n\ntype KanbanDragOptions = Pick<KanbanBoardProps, 'tasks' | 'statusField' | 'readOnly' | 'onStatusChange'> & Partial<Pick<KanbanBoardProps, 'columns'>>;\ntype NativeContextProps = Omit<React.ComponentProps<typeof DragDropProvider>, 'children'>;\n/** Native drag state and provider props used by KanbanDragSurface. */\nexport interface KanbanDragController {\n  /** Current task, or null when idle, removed or read-only. */\n  activeTask: KanbanTask | null;\n  /** Native provider props; legacy DndContext controllers are incompatible. */\n  contextProps: NativeContextProps;\n}\nconst plugins: NativeContextProps['plugins'] = defaults => [...defaults, Accessibility.configure(kanbanAccessibility)];\n\n/**\n * Control a status-only Kanban drag using native provider events and sensors.\n * @param options - Current tasks, optional columns, statusField (default status),\n * readOnly (default false) and the status-change callback. Hosts own durable state.\n * @returns The active task or null and native props for KanbanDragSurface.\n * @remarks No within-column ordering is persisted. Canceled, removed or read-only\n * operations do not notify a status change. Use the migrated surface/provider;\n * contextProps is not a legacy DndContext prop object.\n * @example\n * ```tsx\n * import {KanbanDragSurface, KanbanColumn, useKanbanDrag} from '@alneas/appkit-react/tools/kanban';\n * import '@alneas/appkit-react/styles';\n * export function CustomBoard() {\n *   const tasks = [{id: 'one', title: 'Review', status: 'todo'}];\n *   const controller = useKanbanDrag({tasks});\n *   return <KanbanDragSurface controller={controller}>\n *     <KanbanColumn column={{id: 'todo', title: 'Todo'}} tasks={tasks} />\n *     <KanbanColumn column={{id: 'done', title: 'Done'}} tasks={[]} />\n *   </KanbanDragSurface>;\n * }\n * ```\n */\nexport function useKanbanDrag({tasks, columns, statusField = 'status', readOnly = false, onStatusChange}: KanbanDragOptions): KanbanDragController {\n  const [activeId, setActiveId] = React.useState<string | null>(null);\n  const sensors = useKanbanSensors(statusField);\n  const activeTask = readOnly ? null : (tasks.find(task => task.id === activeId) ?? null);\n  const onBeforeDragStart: NativeContextProps['onBeforeDragStart'] = event => {\n    if (readOnly || !tasks.some(task => task.id === event.operation.source?.id)) event.preventDefault();\n  };\n  const onDragStart: NativeContextProps['onDragStart'] = event => {\n    const task = tasks.find(task => task.id === event.operation.source?.id);\n    setActiveId(!readOnly && task ? task.id : null);\n  };\n  const onDragEnd: NativeContextProps['onDragEnd'] = (event, manager) => {\n    setActiveId(null);\n    if (readOnly || !event.operation.target || !manager.registry.droppables.get(event.operation.target.id)) return;\n    const move = resolveKanbanDrop(event, tasks, statusField, columns);\n    if (move) onStatusChange?.(move.taskId, move.status);\n  };\n  return {activeTask, contextProps: {sensors, plugins, onBeforeDragStart, onDragStart, onDragEnd}};\n}\n"],"mappings":";;;;;;AAgBA,IAAME,KAAyC,MAAY,CAAC,GAAGC,GAAUC,EAAc,UAAUC,CAAmB,CAAC;AAwBrH,SAAgBC,EAAc,EAAC,UAAO,YAAS,iBAAc,UAAU,cAAW,IAAO,qBAA0D;CACjJ,IAAM,CAACC,GAAUC,KAAeR,EAAM,SAAwB,IAAI,GAC5DS,IAAUC,EAAiBC,CAAW;CAe5C,OAAO;EAAC,YAdWC,IAAW,OAAQC,EAAM,MAAK,MAAQC,EAAK,OAAOP,CAAQ,KAAK;EAc9D,cAAc;GAAC;GAAS;GAAS,oBAbc,MAAS;IAC1E,CAAIK,KAAY,CAACC,EAAM,MAAK,MAAQC,EAAK,OAAOC,EAAM,UAAU,QAAQ,EAAE,MAAGA,EAAM,eAAe;GACpG;GAWwE,cAVjB,MAAS;IAC9D,IAAMD,IAAOD,EAAM,MAAK,MAAQC,EAAK,OAAOC,EAAM,UAAU,QAAQ,EAAE;IACtE,EAAY,CAACH,KAAYE,IAAOA,EAAK,KAAK,IAAI;GAChD;GAOqF,YANjC,GAAO,MAAY;IAErE,IADAN,EAAY,IAAI,GACZI,KAAY,CAACG,EAAM,UAAU,UAAU,CAACC,EAAQ,SAAS,WAAW,IAAID,EAAM,UAAU,OAAO,EAAE,GAAG;IACxG,IAAME,IAAOC,EAAkBH,GAAOF,GAAOF,GAAaQ,CAAO;IACjE,AAAIF,KAAMG,IAAiBH,EAAK,QAAQA,EAAK,MAAM;GACrD;EAC8F;CAAC;AACjG"}

package/dist/tools/components/kanban/use-kanban-sensors.cjs

@@ -1,2 +1,2 @@
-"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@dnd-kit/core");function t(t){return(0,e.useSensors)((0,e.useSensor)(e.MouseSensor,{activationConstraint:{distance:10}}),(0,e.useSensor)(e.TouchSensor,{activationConstraint:{delay:250,tolerance:5}}),(0,e.useSensor)(e.KeyboardSensor,{coordinateGetter:(e,{context:n,currentCoordinates:r})=>{if(e.code!==`ArrowLeft`&&e.code!==`ArrowRight`)return;e.preventDefault();let{active:i,over:a,droppableContainers:o,droppableRects:s,collisionRect:c}=n;if(!i||!c)return;let l=o.getEnabled().filter(e=>e.data.current?.type===`Column`).map(e=>({id:e.id,rect:s.get(e.id)})).filter(e=>e.rect!==void 0).sort((e,t)=>e.rect.left-t.rect.left),u=a?.data.current??i.data.current,d=u?.type===`Column`?a?.id:u?.task?.[t],f=l.findIndex(e=>e.id===d);if(f<0)return;let p=l[f+(e.code===`ArrowRight`?1:-1)]?.rect;if(p)return{x:r.x+p.left+p.width/2-c.left-c.width/2,y:r.y+p.top+Math.min(p.height/2,80)-c.top-c.height/2}},scrollBehavior:`auto`}))}var n={screenReaderInstructions:{draggable:`SpaceまたはEnterで移動開始。左右矢印で列を選択し、SpaceまたはEnterで確定。Escapeで取り消します。`}};exports.kanbanAccessibility=n,exports.useKanbanSensors=t;
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("react"),t=require("@dnd-kit/dom");function n(n){return(0,e.useMemo)(()=>{class e extends t.KeyboardSensor{restoreCollision=!1;handleStart(e,t,n){super.handleStart(e,t,n),this.manager.dragOperation.source===t&&(this.restoreCollision=!this.manager.collisionObserver.disabled,this.manager.collisionObserver.disable())}cleanup(){super.cleanup(),this.restoreCollision&&this.manager.collisionObserver.enable(),this.restoreCollision=!1}handleMove(e,t){if(e!==`left`&&e!==`right`)return;t.preventDefault();let{source:r,target:i}=this.manager.dragOperation;if(!r)return;let a=[...this.manager.registry.droppables].filter(e=>!e.disabled&&e.data.type===`Column`&&e.element).sort((e,t)=>e.element.getBoundingClientRect().left-t.element.getBoundingClientRect().left),o=i?.data.type===`Column`?i.id:r.data.task?.[n],s=a.findIndex(e=>e.id===o),c=a[s+(e===`right`?1:-1)];if(s<0||!c?.element)return;c.element.scrollIntoView({block:`nearest`,inline:`nearest`,behavior:`instant`});let l=c.element.getBoundingClientRect();this.manager.actions.move({event:t,to:{x:l.left+l.width/2,y:l.top+Math.min(l.height/2,80)}}),this.manager.actions.setDropTarget(c.id)}}return[t.PointerSensor.configure({activationConstraints:e=>e.pointerType===`touch`?[new t.PointerActivationConstraints.Delay({value:250,tolerance:5})]:[new t.PointerActivationConstraints.Distance({value:10})]}),e]},[n])}var r={screenReaderInstructions:{draggable:`SpaceまたはEnterで移動開始。左右矢印で列を選択し、SpaceまたはEnterで確定。Escapeで取り消します。`}};exports.kanbanAccessibility=r,exports.useKanbanSensors=n;
 //# sourceMappingURL=use-kanban-sensors.cjs.map

package/dist/tools/components/kanban/use-kanban-sensors.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-kanban-sensors.cjs","names":["useSensors","useSensor","MouseSensor","TouchSensor","KeyboardSensor","_dnd_kit_core","useKanbanSensors","event","context","active","collisionRect","columns","droppableContainers","c","droppableRects","a","b","data","over","status","statusField","index","target","currentCoordinates","kanbanAccessibility"],"sources":["../../../../src/tools/components/kanban/use-kanban-sensors.ts"],"sourcesContent":["import {\n  KeyboardSensor,\n  MouseSensor,\n  TouchSensor,\n  useSensor,\n  useSensors,\n  type KeyboardCoordinateGetter,\n} from '@dnd-kit/core';\n\n/** Shared sensors: Space/Enter picks up or drops, Left/Right selects a status column, Escape cancels. */\nexport function useKanbanSensors(statusField: string) {\n  const coordinates: KeyboardCoordinateGetter = (event, { context, currentCoordinates }) => {\n    if (event.code !== 'ArrowLeft' && event.code !== 'ArrowRight') return;\n    event.preventDefault();\n    const { active, over, droppableContainers, droppableRects, collisionRect } = context;\n    if (!active || !collisionRect) return;\n    const columns = droppableContainers\n      .getEnabled()\n      .filter((c) => c.data.current?.type === 'Column')\n      .map((c) => ({ id: c.id, rect: droppableRects.get(c.id) }))\n      .filter((c) => c.rect !== undefined)\n      .sort((a, b) => a.rect!.left - b.rect!.left);\n    const data = over?.data.current ?? active.data.current;\n    const status = data?.type === 'Column' ? over?.id : data?.task?.[statusField];\n    const index = columns.findIndex((c) => c.id === status);\n    if (index < 0) return;\n    const target = columns[index + (event.code === 'ArrowRight' ? 1 : -1)]?.rect;\n    if (!target) return;\n    return {\n      x:\n        currentCoordinates.x +\n        target.left +\n        target.width / 2 -\n        collisionRect.left -\n        collisionRect.width / 2,\n      y:\n        currentCoordinates.y +\n        target.top +\n        Math.min(target.height / 2, 80) -\n        collisionRect.top -\n        collisionRect.height / 2,\n    };\n  };\n  return useSensors(\n    useSensor(MouseSensor, { activationConstraint: { distance: 10 } }),\n    useSensor(TouchSensor, { activationConstraint: { delay: 250, tolerance: 5 } }),\n    useSensor(KeyboardSensor, { coordinateGetter: coordinates, scrollBehavior: 'auto' }),\n  );\n}\n\nexport const kanbanAccessibility = {\n  screenReaderInstructions: {\n    draggable:\n      'SpaceまたはEnterで移動開始。左右矢印で列を選択し、SpaceまたはEnterで確定。Escapeで取り消します。',\n  },\n};\n"],"mappings":"A,+GAUA,SAAgBM,EAAiB,EAAqB,CAiCpD,OAAA,EAAON,EAAAA,WAAAA,EAAAA,EACLC,EAAAA,UAAAA,CAAUC,EAAAA,YAAa,CAAE,qBAAsB,CAAE,SAAU,EAAG,CAAE,CAAC,GAAA,EACjED,EAAAA,UAAAA,CAAUE,EAAAA,YAAa,CAAE,qBAAsB,CAAE,MAAO,IAAK,UAAW,CAAE,CAAE,CAAC,GAAA,EAC7EF,EAAAA,UAAAA,CAAUG,EAAAA,eAAgB,CAAE,kBAnCiB,EAAO,CAAE,UAAS,wBAAyB,CACxF,GAAIG,EAAM,OAAS,aAAeA,EAAM,OAAS,aAAc,OAC/DA,EAAM,eAAe,EACrB,GAAM,CAAE,SAAQ,OAAM,sBAAqB,iBAAgB,iBAAkBC,EAC7E,GAAI,CAACC,GAAU,CAACC,EAAe,OAC/B,IAAMC,EAAUC,EACb,WAAW,CAAC,CACZ,OAAQ,GAAMC,EAAE,KAAK,SAAS,OAAS,QAAQ,CAAC,CAChD,IAAK,IAAO,CAAE,GAAIA,EAAE,GAAI,KAAMC,EAAe,IAAID,EAAE,EAAE,CAAE,EAAE,CAAC,CAC1D,OAAQ,GAAMA,EAAE,OAAS,IAAA,EAAS,CAAC,CACnC,MAAM,EAAG,IAAME,EAAE,KAAM,KAAOC,EAAE,KAAM,IAAI,EACvCC,EAAOC,GAAM,KAAK,SAAWT,EAAO,KAAK,QACzCU,EAASF,GAAM,OAAS,SAAWC,GAAM,GAAKD,GAAM,OAAOG,GAC3DC,EAAQV,EAAQ,UAAW,GAAME,EAAE,KAAOM,CAAM,EACtD,GAAIE,EAAQ,EAAG,OACf,IAAMC,EAASX,EAAQU,GAASd,EAAM,OAAS,aAAe,EAAI,IAAI,EAAE,KACxE,GAAKe,EACL,MAAO,CACL,EACEC,EAAmB,EACnBD,EAAO,KACPA,EAAO,MAAQ,EACfZ,EAAc,KACdA,EAAc,MAAQ,EACxB,EACEa,EAAmB,EACnBD,EAAO,IACP,KAAK,IAAIA,EAAO,OAAS,EAAG,EAAE,EAC9BZ,EAAc,IACdA,EAAc,OAAS,CAC3B,CACF,EAI6D,eAAgB,MAAO,CAAC,CACrF,CACF,CAEA,IAAac,EAAsB,CACjC,yBAA0B,CACxB,UACE,+DACJ,CACF,E"}
+{"version":3,"file":"use-kanban-sensors.cjs","names":["useMemo","KeyboardSensor","PointerSensor","PointerActivationConstraints","react","_dnd_kit_dom","useKanbanSensors","ColumnKeyboardSensor","event","source","options","direction","columns","column","a","b","status","target","statusField","index","next","rect","kanbanAccessibility"],"sources":["../../../../src/tools/components/kanban/use-kanban-sensors.ts"],"sourcesContent":["import {useMemo} from 'react';\nimport {\n  KeyboardSensor, PointerSensor, PointerActivationConstraints,\n  type Draggable, type KeyboardSensorOptions, type Sensors,\n} from '@dnd-kit/dom';\n\n/**\n * Build native pointer sensors and visual-column Left/Right keyboard traversal.\n * @param statusField - Task property holding its current column id.\n * @returns Native sensor descriptors, memoized by statusField; these are not\n * legacy DndContext sensors.\n * @remarks Mouse/pen movement requires 10px; touch requires a 250ms hold with\n * 5px tolerance. Columns must register Column metadata under the same native\n * provider. Prefer useKanbanDrag for the complete status-change lifecycle.\n * @example\n * ```tsx\n * import {DragDropProvider} from '@dnd-kit/react';\n * import {useKanbanSensors} from '@alneas/appkit-react/tools/kanban';\n * export function SensorBoundary() {\n *   const sensors = useKanbanSensors('status');\n *   return <DragDropProvider sensors={sensors}><div>Host registrations</div></DragDropProvider>;\n * }\n * ```\n */\nexport function useKanbanSensors(statusField: string): Sensors {\n  return useMemo(() => {\n    class ColumnKeyboardSensor extends KeyboardSensor {\n      private restoreCollision = false;\n      protected override handleStart(event: KeyboardEvent, source: Draggable, options: KeyboardSensorOptions | undefined) {\n        super.handleStart(event, source, options);\n        if (this.manager.dragOperation.source !== source) return;\n        this.restoreCollision = !this.manager.collisionObserver.disabled;\n        this.manager.collisionObserver.disable();\n      }\n      protected override cleanup() {\n        super.cleanup();\n        if (this.restoreCollision) this.manager.collisionObserver.enable();\n        this.restoreCollision = false;\n      }\n      protected override handleMove(direction: 'up' | 'down' | 'left' | 'right', event: KeyboardEvent) {\n        if (direction !== 'left' && direction !== 'right') return;\n        event.preventDefault();\n        const {source, target} = this.manager.dragOperation;\n        if (!source) return;\n        const columns = [...this.manager.registry.droppables]\n          .filter(column => !column.disabled && column.data.type === 'Column' && column.element)\n          .sort((a, b) => a.element!.getBoundingClientRect().left - b.element!.getBoundingClientRect().left);\n        const status = target?.data.type === 'Column' ? target.id : source.data.task?.[statusField];\n        const index = columns.findIndex(column => column.id === status);\n        const next = columns[index + (direction === 'right' ? 1 : -1)];\n        if (index < 0 || !next?.element) return;\n        next.element.scrollIntoView({block: 'nearest', inline: 'nearest', behavior: 'instant'});\n        const rect = next.element.getBoundingClientRect();\n        this.manager.actions.move({event, to: {x: rect.left + rect.width / 2, y: rect.top + Math.min(rect.height / 2, 80)}});\n        void this.manager.actions.setDropTarget(next.id);\n      }\n    }\n    return [\n      PointerSensor.configure({activationConstraints: event => event.pointerType === 'touch'\n        ? [new PointerActivationConstraints.Delay({value: 250, tolerance: 5})]\n        : [new PointerActivationConstraints.Distance({value: 10})]}),\n      ColumnKeyboardSensor,\n    ];\n  }, [statusField]);\n}\n\n/** Japanese native accessibility instructions for status-only column movement. */\nexport const kanbanAccessibility = {\n  screenReaderInstructions: {\n    draggable: 'SpaceまたはEnterで移動開始。左右矢印で列を選択し、SpaceまたはEnterで確定。Escapeで取り消します。',\n  },\n};\n"],"mappings":"A,iIAwBA,SAAgBM,EAAiB,EAA8B,CAC7D,OAAA,EAAON,EAAAA,QAAAA,KAAc,CACnB,MAAMO,UAA6BN,EAAAA,cAAe,CAChD,iBAA2B,GAC3B,YAA+B,EAAsB,EAAmB,EAA4C,CAClH,MAAM,YAAYO,EAAOC,EAAQC,CAAO,EACpC,KAAK,QAAQ,cAAc,SAAWD,IAC1C,KAAK,iBAAmB,CAAC,KAAK,QAAQ,kBAAkB,SACxD,KAAK,QAAQ,kBAAkB,QAAQ,EACzC,CACA,SAA6B,CAC3B,MAAM,QAAQ,EACV,KAAK,kBAAkB,KAAK,QAAQ,kBAAkB,OAAO,EACjE,KAAK,iBAAmB,EAC1B,CACA,WAA8B,EAA6C,EAAsB,CAC/F,GAAIE,IAAc,QAAUA,IAAc,QAAS,OACnDH,EAAM,eAAe,EACrB,GAAM,CAAC,SAAQ,UAAU,KAAK,QAAQ,cACtC,GAAI,CAACC,EAAQ,OACb,IAAMG,EAAU,CAAC,GAAG,KAAK,QAAQ,SAAS,UAAU,CAAC,CAClD,OAAO,GAAU,CAACC,EAAO,UAAYA,EAAO,KAAK,OAAS,UAAYA,EAAO,OAAO,CAAC,CACrF,MAAM,EAAG,IAAMC,EAAE,QAAS,sBAAsB,CAAC,CAAC,KAAOC,EAAE,QAAS,sBAAsB,CAAC,CAAC,IAAI,EAC7FC,EAASC,GAAQ,KAAK,OAAS,SAAWA,EAAO,GAAKR,EAAO,KAAK,OAAOS,GACzEC,EAAQP,EAAQ,UAAU,GAAUC,EAAO,KAAOG,CAAM,EACxDI,EAAOR,EAAQO,GAASR,IAAc,QAAU,EAAI,KAC1D,GAAIQ,EAAQ,GAAK,CAACC,GAAM,QAAS,OACjCA,EAAK,QAAQ,eAAe,CAAC,MAAO,UAAW,OAAQ,UAAW,SAAU,SAAS,CAAC,EACtF,IAAMC,EAAOD,EAAK,QAAQ,sBAAsB,EAChD,KAAK,QAAQ,QAAQ,KAAK,CAAC,QAAO,GAAI,CAAC,EAAGC,EAAK,KAAOA,EAAK,MAAQ,EAAG,EAAGA,EAAK,IAAM,KAAK,IAAIA,EAAK,OAAS,EAAG,EAAE,CAAC,CAAC,CAAC,EACnH,KAAU,QAAQ,QAAQ,cAAcD,EAAK,EAAE,CACjD,CACF,CACA,MAAO,CACLlB,EAAAA,cAAc,UAAU,CAAC,sBAAuB,GAASM,EAAM,cAAgB,QAC3E,CAAC,IAAIL,EAAAA,6BAA6B,MAAM,CAAC,MAAO,IAAK,UAAW,CAAC,CAAC,CAAC,EACnE,CAAC,IAAIA,EAAAA,6BAA6B,SAAS,CAAC,MAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAC7DI,CACF,CACF,EAAG,CAACW,CAAW,CAAC,CAClB,CAGA,IAAaI,EAAsB,CACjC,yBAA0B,CACxB,UAAW,+DACb,CACF,E"}

package/dist/tools/components/kanban/use-kanban-sensors.d.cts

@@ -1,5 +1,24 @@
-/** Shared sensors: Space/Enter picks up or drops, Left/Right selects a status column, Escape cancels. */
-export declare function useKanbanSensors(statusField: string): import('@dnd-kit/core').SensorDescriptor<import('@dnd-kit/core').SensorOptions>[];
+import { Sensors } from '@dnd-kit/dom';
+/**
+ * Build native pointer sensors and visual-column Left/Right keyboard traversal.
+ * @param statusField - Task property holding its current column id.
+ * @returns Native sensor descriptors, memoized by statusField; these are not
+ * legacy DndContext sensors.
+ * @remarks Mouse/pen movement requires 10px; touch requires a 250ms hold with
+ * 5px tolerance. Columns must register Column metadata under the same native
+ * provider. Prefer useKanbanDrag for the complete status-change lifecycle.
+ * @example
+ * ```tsx
+ * import {DragDropProvider} from '@dnd-kit/react';
+ * import {useKanbanSensors} from '@alneas/appkit-react/tools/kanban';
+ * export function SensorBoundary() {
+ *   const sensors = useKanbanSensors('status');
+ *   return <DragDropProvider sensors={sensors}><div>Host registrations</div></DragDropProvider>;
+ * }
+ * ```
+ */
+export declare function useKanbanSensors(statusField: string): Sensors;
+/** Japanese native accessibility instructions for status-only column movement. */
 export declare const kanbanAccessibility: {
     screenReaderInstructions: {
         draggable: string;