@accelint/design-toolkit 9.3.0 → 9.4.0

package/dist/components/kanban/context.d.ts

@@ -12,25 +12,42 @@
 
 import { KanbanCardData, KanbanColumnData } from "./types.js";
 import { ReactNode } from "react";
-import * as react_jsx_runtime64 from "react/jsx-runtime";
+import * as react_jsx_runtime86 from "react/jsx-runtime";
 import { DragEndEvent } from "@dnd-kit/core";
 
 //#region src/components/kanban/context.d.ts
+/**
+ * Function signature for moving a card between columns or positions.
+ */
 type MoveCard = (cardId: string, targetColumnId: string, targetPosition: number, closestEdge?: 'top' | 'bottom') => void;
+/**
+ * Context data for Kanban state and operations.
+ */
 interface KanbanContextData {
+  /** Array of all columns. */
   columns: KanbanColumnData[];
+  /** Callback to update column state. */
   updateColumnState: (columns: KanbanColumnData[]) => void;
+  /** Function to move a card. */
   moveCard: MoveCard;
+  /** Get a column by its ID. */
   getColumnById: (id: string) => KanbanColumnData | undefined;
+  /** Map of card IDs to their location info. */
   cardMap: Map<string, {
     column: KanbanColumnData;
     card: KanbanCardData;
     index: number;
   }>;
 }
+/**
+ * Props for KanbanProvider component.
+ */
 interface KanbanProviderProps {
+  /** Array of column data. */
   columns: KanbanColumnData[];
+  /** Callback to update column state. */
   updateColumnState: (columns: KanbanColumnData[]) => void;
+  /** Child components. */
   children: ReactNode;
 }
 /**
@@ -96,6 +113,12 @@ declare function calculateClosestEdge(over: DragEndEvent['over'], active: DragEn
  * @returns Normalized drop target information or null if invalid drop
  */
 declare function parseDropTarget(event: DragEndEvent): DropTargetInfo | null;
+/**
+ * Calculates the insert index based on target position and drop edge.
+ * @param targetPosition - The target position index.
+ * @param closestEdge - The edge to drop relative to.
+ * @returns The calculated insert index.
+ */
 declare const getInsertIndex: (targetPosition: number, closestEdge?: "top" | "bottom") => number;
 /**
  * Validates all parameters for a card move operation
@@ -109,11 +132,35 @@ declare function validateMoveCard({
   columns,
   cardMap
 }: MoveCardValidationParams): MoveCardValidationResult;
+/**
+ * KanbanProvider - Context provider for Kanban state management
+ *
+ * Manages column and card state, handles drag-and-drop operations,
+ * and provides the moveCard function for card movements.
+ *
+ * @param props - {@link KanbanProviderProps}
+ * @param props.children - Child components.
+ * @param props.columns - Array of column data.
+ * @param props.updateColumnState - Callback to update column state.
+ * @returns The rendered KanbanProvider component.
+ *
+ * @example
+ * ```tsx
+ * <KanbanProvider columns={columns} updateColumnState={setColumns}>
+ *   <Kanban>...</Kanban>
+ * </KanbanProvider>
+ * ```
+ */
 declare const KanbanProvider: ({
   children,
   columns,
   updateColumnState
-}: KanbanProviderProps) => react_jsx_runtime64.JSX.Element;
+}: KanbanProviderProps) => react_jsx_runtime86.JSX.Element;
+/**
+ * Hook to access Kanban context values.
+ * Must be used within a KanbanProvider.
+ * @returns The Kanban context data.
+ */
 declare const useKanban: () => KanbanContextData;
 //#endregion
 export { DropTargetInfo, KanbanContextData, KanbanProvider, KanbanProviderProps, MoveCard, MoveCardValidationParams, MoveCardValidationResult, calculateClosestEdge, getInsertIndex, parseDropTarget, useKanban, validateMoveCard };

package/dist/components/kanban/context.js

@@ -56,6 +56,12 @@ const updatePositions = (column) => {
 		c.position = index;
 	});
 };
+/**
+* Calculates the insert index based on target position and drop edge.
+* @param targetPosition - The target position index.
+* @param closestEdge - The edge to drop relative to.
+* @returns The calculated insert index.
+*/
 const getInsertIndex = (targetPosition, closestEdge) => {
 	if (!closestEdge) return targetPosition;
 	return closestEdge === "top" ? targetPosition : targetPosition + 1;
@@ -122,6 +128,25 @@ const KanbanContext = createContext({
 	getColumnById: () => void 0,
 	cardMap: /* @__PURE__ */ new Map()
 });
+/**
+* KanbanProvider - Context provider for Kanban state management
+*
+* Manages column and card state, handles drag-and-drop operations,
+* and provides the moveCard function for card movements.
+*
+* @param props - {@link KanbanProviderProps}
+* @param props.children - Child components.
+* @param props.columns - Array of column data.
+* @param props.updateColumnState - Callback to update column state.
+* @returns The rendered KanbanProvider component.
+*
+* @example
+* ```tsx
+* <KanbanProvider columns={columns} updateColumnState={setColumns}>
+*   <Kanban>...</Kanban>
+* </KanbanProvider>
+* ```
+*/
 const KanbanProvider = ({ children, columns, updateColumnState }) => {
 	const cardMap = useMemo(() => {
 		const map = /* @__PURE__ */ new Map();
@@ -191,6 +216,11 @@ const KanbanProvider = ({ children, columns, updateColumnState }) => {
 		children
 	});
 };
+/**
+* Hook to access Kanban context values.
+* Must be used within a KanbanProvider.
+* @returns The Kanban context data.
+*/
 const useKanban = () => {
 	const context = useContext(KanbanContext);
 	if (!context) throw new Error("useKanban must be used within KanbanProvider");

package/dist/components/kanban/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":["errors: string[]"],"sources":["../../../src/components/kanban/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useMemo,\n} from 'react';\nimport type { DragEndEvent } from '@dnd-kit/core';\nimport type { KanbanCardData, KanbanColumnData } from './types';\n\nexport type MoveCard = (\n  cardId: string,\n  targetColumnId: string,\n  targetPosition: number,\n  closestEdge?: 'top' | 'bottom',\n) => void;\nexport interface KanbanContextData {\n  columns: KanbanColumnData[];\n  updateColumnState: (columns: KanbanColumnData[]) => void;\n  moveCard: MoveCard;\n  getColumnById: (id: string) => KanbanColumnData | undefined;\n  cardMap: Map<\n    string,\n    { column: KanbanColumnData; card: KanbanCardData; index: number }\n  >;\n}\n\nexport interface KanbanProviderProps {\n  columns: KanbanColumnData[];\n  updateColumnState: (columns: KanbanColumnData[]) => void;\n  children: ReactNode;\n}\n\n/**\n * Result of parsing a drop target from a drag event\n */\nexport interface DropTargetInfo {\n  /** The ID of the column where the card should be dropped */\n  columnId: string;\n  /** The position/index within the column */\n  position: number;\n  /** The edge to drop relative to (undefined when dropping on empty column) */\n  edge: 'top' | 'bottom' | undefined;\n}\n\n/**\n * Parameters for validating a card move operation\n */\nexport interface MoveCardValidationParams {\n  cardId: string;\n  targetColumnId: string;\n  targetPosition: number;\n  columns: KanbanColumnData[];\n  cardMap: Map<\n    string,\n    { column: KanbanColumnData; card: KanbanCardData; index: number }\n  >;\n}\n\n/**\n * Result of validating a card move operation\n * Uses discriminated union to ensure type safety based on success/failure\n */\nexport type MoveCardValidationResult =\n  | {\n      /** Validation succeeded */\n      success: true;\n      /** Adjusted target position (clamped to valid bounds) */\n      adjustedPosition: number;\n      /** Source card information */\n      sourceInfo: {\n        column: KanbanColumnData;\n        card: KanbanCardData;\n        index: number;\n      };\n      /** Target column */\n      targetColumn: KanbanColumnData;\n      /** Empty error array for success case */\n      errors: [];\n    }\n  | {\n      /** Validation failed */\n      success: false;\n      /** List of error messages describing validation failures */\n      errors: string[];\n    };\n\n/**\n * Calculates which edge of a drop target is closest to the dragged item\n * @param over - The drop target from dnd-kit\n * @param active - The active dragged item from dnd-kit\n * @returns 'top' if the dragged item's center is above the midpoint, 'bottom' otherwise\n */\nexport function calculateClosestEdge(\n  over: DragEndEvent['over'],\n  active: DragEndEvent['active'],\n): 'top' | 'bottom' {\n  if (!over?.rect) {\n    return 'bottom';\n  }\n\n  const translated = active?.rect?.current?.translated;\n  if (!translated) {\n    return 'bottom';\n  }\n\n  const overRect = over.rect;\n  const midpoint = overRect.top + overRect.height / 2;\n  const draggedItemCenter = translated.top + translated.height / 2;\n\n  return draggedItemCenter < midpoint ? 'top' : 'bottom';\n}\n\n/**\n * Parses a drag event to determine where a card should be dropped\n * @param event - The drag end event from dnd-kit\n * @returns Normalized drop target information or null if invalid drop\n */\nexport function parseDropTarget(event: DragEndEvent): DropTargetInfo | null {\n  const { active, over } = event;\n\n  if (!over) {\n    return null;\n  }\n\n  const overData = over.data.current;\n\n  if (!overData) {\n    return null;\n  }\n\n  // Dropping on a column (empty space or column container)\n  if (Array.isArray(overData.cards)) {\n    return {\n      columnId: overData.id,\n      position: overData.cards.length,\n      edge: undefined,\n    };\n  }\n\n  // Dropping on a card position\n  const edge = calculateClosestEdge(over, active);\n  return {\n    columnId: overData.columnId,\n    position: overData.position,\n    edge,\n  };\n}\n\nconst updatePositions = (column: KanbanColumnData) => {\n  column.cards.forEach((c, index) => {\n    c.position = index;\n  });\n};\n\nexport const getInsertIndex = (\n  targetPosition: number,\n  closestEdge?: 'top' | 'bottom',\n) => {\n  // If no edge is specified, use the target position as-is\n  if (!closestEdge) {\n    return targetPosition;\n  }\n\n  // If dropping on top edge, insert at the target position (before the card)\n  // If dropping on bottom edge, insert after the target position (position + 1)\n  return closestEdge === 'top' ? targetPosition : targetPosition + 1;\n};\n\n/**\n * Validates all parameters for a card move operation\n * @param params - Validation parameters\n * @returns Validation result with success flag, adjusted values, and errors\n */\nexport function validateMoveCard({\n  cardId,\n  targetColumnId,\n  targetPosition,\n  columns,\n  cardMap,\n}: MoveCardValidationParams): MoveCardValidationResult {\n  const errors: string[] = [];\n  let adjustedPosition = targetPosition;\n\n  // 1. Type validation\n  if (typeof cardId !== 'string' || !cardId.trim()) {\n    errors.push('[Kanban] moveCard: cardId must be a non-empty string');\n  }\n\n  if (typeof targetColumnId !== 'string' || !targetColumnId.trim()) {\n    errors.push('[Kanban] moveCard: targetColumnId must be a non-empty string');\n  }\n\n  if (typeof targetPosition !== 'number' || !Number.isFinite(targetPosition)) {\n    errors.push('[Kanban] moveCard: targetPosition must be a finite number');\n  }\n\n  // Early return if type validation fails\n  if (errors.length > 0) {\n    return { success: false, errors };\n  }\n\n  // 2. Card existence validation\n  const sourceInfo = cardMap.get(cardId);\n  if (!sourceInfo) {\n    errors.push(`[Kanban] moveCard: Card \"${cardId}\" not found in any column`);\n    return { success: false, errors };\n  }\n\n  // 3. Target column existence validation\n  const targetColumn = columns.find((col) => col.id === targetColumnId);\n  if (!targetColumn) {\n    errors.push(\n      `[Kanban] moveCard: Target column \"${targetColumnId}\" not found`,\n    );\n    return { success: false, errors };\n  }\n\n  // 4. Position bounds validation (with adjustment)\n  if (adjustedPosition < 0) {\n    console.warn(\n      `[Kanban] moveCard: targetPosition (${adjustedPosition}) cannot be negative. Using 0 instead.`,\n    );\n    adjustedPosition = 0;\n  }\n\n  const maxPosition = targetColumn.cards.length;\n  if (adjustedPosition > maxPosition) {\n    console.warn(\n      `[Kanban] moveCard: targetPosition (${adjustedPosition}) exceeds maximum (${maxPosition}). ` +\n        `Using ${maxPosition} instead.`,\n    );\n    adjustedPosition = maxPosition;\n  }\n\n  // 5. canDrop validation\n  if (targetColumn.canDrop === false) {\n    errors.push(\n      `[Kanban] moveCard: Column \"${targetColumnId}\" does not accept drops`,\n    );\n    return { success: false, errors };\n  }\n\n  // All validations passed\n  return {\n    success: true,\n    adjustedPosition,\n    sourceInfo,\n    targetColumn,\n    errors: [],\n  };\n}\n\nconst KanbanContext = createContext<KanbanContextData>({\n  columns: [],\n  updateColumnState: () => null,\n  moveCard: () => null,\n  getColumnById: () => undefined,\n  cardMap: new Map(),\n});\n\nexport const KanbanProvider = ({\n  children,\n  columns,\n  updateColumnState,\n}: KanbanProviderProps) => {\n  // Create a lookup map for O(1) card access\n  const cardMap = useMemo(() => {\n    const map = new Map<\n      string,\n      { column: KanbanColumnData; card: KanbanCardData; index: number }\n    >();\n\n    columns.forEach((column) => {\n      column.cards.forEach((card, index) => {\n        map.set(card.id, { column, card, index });\n      });\n    });\n\n    return map;\n  }, [columns]);\n\n  const moveCard = useCallback(\n    (\n      cardId: string,\n      targetColumnId: string,\n      targetPosition: number,\n      closestEdge?: 'top' | 'bottom',\n    ) => {\n      // Validate all inputs\n      const validation = validateMoveCard({\n        cardId,\n        targetColumnId,\n        targetPosition,\n        columns,\n        cardMap,\n      });\n\n      // Handle validation failure\n      if (!validation.success) {\n        validation.errors.forEach((error) => {\n          console.error(error);\n        });\n        return false;\n      }\n\n      // Extract validated data - TypeScript knows these are defined after success check\n      const { adjustedPosition, sourceInfo: source, targetColumn } = validation;\n\n      const newColumns = [...columns];\n      const isSameColumn = source.column.id === targetColumn.id;\n\n      // Remove card from source column\n      const newSourceColumn = {\n        ...source.column,\n        cards: source.column.cards.filter((_, i) => i !== source.index),\n      };\n\n      // Calculate insert index using adjusted position\n      let index = getInsertIndex(adjustedPosition, closestEdge);\n\n      // If moving within the same column and moving down, adjust index\n      if (isSameColumn && source.index < index) {\n        index -= 1;\n      }\n\n      // Insert card into target column\n      const newTargetColumn = isSameColumn\n        ? newSourceColumn\n        : { ...targetColumn, cards: [...targetColumn.cards] };\n\n      newTargetColumn.cards.splice(index, 0, {\n        ...source.card,\n        columnId: targetColumnId,\n      });\n\n      // Update positions\n      updatePositions(newTargetColumn);\n      if (!isSameColumn) {\n        updatePositions(newSourceColumn);\n      }\n\n      // Update the columns array with the modified columns\n      const updatedColumns = newColumns.map((col) => {\n        if (col.id === source.column.id) {\n          return newSourceColumn;\n        }\n        if (col.id === targetColumn.id) {\n          return newTargetColumn;\n        }\n        return col;\n      });\n\n      updateColumnState(updatedColumns);\n    },\n    [columns, updateColumnState, cardMap],\n  );\n\n  const getColumnById = useCallback(\n    (id: string) => columns.find((c) => c.id === id),\n    [columns],\n  );\n\n  return (\n    <KanbanContext.Provider\n      value={{ columns, updateColumnState, moveCard, getColumnById, cardMap }}\n    >\n      {children}\n    </KanbanContext.Provider>\n  );\n};\n\nexport const useKanban = () => {\n  const context = useContext(KanbanContext);\n  if (!context) {\n    throw new Error('useKanban must be used within KanbanProvider');\n  }\n  return context;\n};\n"],"mappings":"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"}
+{"version":3,"file":"context.js","names":["errors: string[]"],"sources":["../../../src/components/kanban/context.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {\n  createContext,\n  type ReactNode,\n  useCallback,\n  useContext,\n  useMemo,\n} from 'react';\nimport type { DragEndEvent } from '@dnd-kit/core';\nimport type { KanbanCardData, KanbanColumnData } from './types';\n\n/**\n * Function signature for moving a card between columns or positions.\n */\nexport type MoveCard = (\n  cardId: string,\n  targetColumnId: string,\n  targetPosition: number,\n  closestEdge?: 'top' | 'bottom',\n) => void;\n\n/**\n * Context data for Kanban state and operations.\n */\nexport interface KanbanContextData {\n  /** Array of all columns. */\n  columns: KanbanColumnData[];\n  /** Callback to update column state. */\n  updateColumnState: (columns: KanbanColumnData[]) => void;\n  /** Function to move a card. */\n  moveCard: MoveCard;\n  /** Get a column by its ID. */\n  getColumnById: (id: string) => KanbanColumnData | undefined;\n  /** Map of card IDs to their location info. */\n  cardMap: Map<\n    string,\n    { column: KanbanColumnData; card: KanbanCardData; index: number }\n  >;\n}\n\n/**\n * Props for KanbanProvider component.\n */\nexport interface KanbanProviderProps {\n  /** Array of column data. */\n  columns: KanbanColumnData[];\n  /** Callback to update column state. */\n  updateColumnState: (columns: KanbanColumnData[]) => void;\n  /** Child components. */\n  children: ReactNode;\n}\n\n/**\n * Result of parsing a drop target from a drag event\n */\nexport interface DropTargetInfo {\n  /** The ID of the column where the card should be dropped */\n  columnId: string;\n  /** The position/index within the column */\n  position: number;\n  /** The edge to drop relative to (undefined when dropping on empty column) */\n  edge: 'top' | 'bottom' | undefined;\n}\n\n/**\n * Parameters for validating a card move operation\n */\nexport interface MoveCardValidationParams {\n  cardId: string;\n  targetColumnId: string;\n  targetPosition: number;\n  columns: KanbanColumnData[];\n  cardMap: Map<\n    string,\n    { column: KanbanColumnData; card: KanbanCardData; index: number }\n  >;\n}\n\n/**\n * Result of validating a card move operation\n * Uses discriminated union to ensure type safety based on success/failure\n */\nexport type MoveCardValidationResult =\n  | {\n      /** Validation succeeded */\n      success: true;\n      /** Adjusted target position (clamped to valid bounds) */\n      adjustedPosition: number;\n      /** Source card information */\n      sourceInfo: {\n        column: KanbanColumnData;\n        card: KanbanCardData;\n        index: number;\n      };\n      /** Target column */\n      targetColumn: KanbanColumnData;\n      /** Empty error array for success case */\n      errors: [];\n    }\n  | {\n      /** Validation failed */\n      success: false;\n      /** List of error messages describing validation failures */\n      errors: string[];\n    };\n\n/**\n * Calculates which edge of a drop target is closest to the dragged item\n * @param over - The drop target from dnd-kit\n * @param active - The active dragged item from dnd-kit\n * @returns 'top' if the dragged item's center is above the midpoint, 'bottom' otherwise\n */\nexport function calculateClosestEdge(\n  over: DragEndEvent['over'],\n  active: DragEndEvent['active'],\n): 'top' | 'bottom' {\n  if (!over?.rect) {\n    return 'bottom';\n  }\n\n  const translated = active?.rect?.current?.translated;\n  if (!translated) {\n    return 'bottom';\n  }\n\n  const overRect = over.rect;\n  const midpoint = overRect.top + overRect.height / 2;\n  const draggedItemCenter = translated.top + translated.height / 2;\n\n  return draggedItemCenter < midpoint ? 'top' : 'bottom';\n}\n\n/**\n * Parses a drag event to determine where a card should be dropped\n * @param event - The drag end event from dnd-kit\n * @returns Normalized drop target information or null if invalid drop\n */\nexport function parseDropTarget(event: DragEndEvent): DropTargetInfo | null {\n  const { active, over } = event;\n\n  if (!over) {\n    return null;\n  }\n\n  const overData = over.data.current;\n\n  if (!overData) {\n    return null;\n  }\n\n  // Dropping on a column (empty space or column container)\n  if (Array.isArray(overData.cards)) {\n    return {\n      columnId: overData.id,\n      position: overData.cards.length,\n      edge: undefined,\n    };\n  }\n\n  // Dropping on a card position\n  const edge = calculateClosestEdge(over, active);\n  return {\n    columnId: overData.columnId,\n    position: overData.position,\n    edge,\n  };\n}\n\nconst updatePositions = (column: KanbanColumnData) => {\n  column.cards.forEach((c, index) => {\n    c.position = index;\n  });\n};\n\n/**\n * Calculates the insert index based on target position and drop edge.\n * @param targetPosition - The target position index.\n * @param closestEdge - The edge to drop relative to.\n * @returns The calculated insert index.\n */\nexport const getInsertIndex = (\n  targetPosition: number,\n  closestEdge?: 'top' | 'bottom',\n) => {\n  // If no edge is specified, use the target position as-is\n  if (!closestEdge) {\n    return targetPosition;\n  }\n\n  // If dropping on top edge, insert at the target position (before the card)\n  // If dropping on bottom edge, insert after the target position (position + 1)\n  return closestEdge === 'top' ? targetPosition : targetPosition + 1;\n};\n\n/**\n * Validates all parameters for a card move operation\n * @param params - Validation parameters\n * @returns Validation result with success flag, adjusted values, and errors\n */\nexport function validateMoveCard({\n  cardId,\n  targetColumnId,\n  targetPosition,\n  columns,\n  cardMap,\n}: MoveCardValidationParams): MoveCardValidationResult {\n  const errors: string[] = [];\n  let adjustedPosition = targetPosition;\n\n  // 1. Type validation\n  if (typeof cardId !== 'string' || !cardId.trim()) {\n    errors.push('[Kanban] moveCard: cardId must be a non-empty string');\n  }\n\n  if (typeof targetColumnId !== 'string' || !targetColumnId.trim()) {\n    errors.push('[Kanban] moveCard: targetColumnId must be a non-empty string');\n  }\n\n  if (typeof targetPosition !== 'number' || !Number.isFinite(targetPosition)) {\n    errors.push('[Kanban] moveCard: targetPosition must be a finite number');\n  }\n\n  // Early return if type validation fails\n  if (errors.length > 0) {\n    return { success: false, errors };\n  }\n\n  // 2. Card existence validation\n  const sourceInfo = cardMap.get(cardId);\n  if (!sourceInfo) {\n    errors.push(`[Kanban] moveCard: Card \"${cardId}\" not found in any column`);\n    return { success: false, errors };\n  }\n\n  // 3. Target column existence validation\n  const targetColumn = columns.find((col) => col.id === targetColumnId);\n  if (!targetColumn) {\n    errors.push(\n      `[Kanban] moveCard: Target column \"${targetColumnId}\" not found`,\n    );\n    return { success: false, errors };\n  }\n\n  // 4. Position bounds validation (with adjustment)\n  if (adjustedPosition < 0) {\n    console.warn(\n      `[Kanban] moveCard: targetPosition (${adjustedPosition}) cannot be negative. Using 0 instead.`,\n    );\n    adjustedPosition = 0;\n  }\n\n  const maxPosition = targetColumn.cards.length;\n  if (adjustedPosition > maxPosition) {\n    console.warn(\n      `[Kanban] moveCard: targetPosition (${adjustedPosition}) exceeds maximum (${maxPosition}). ` +\n        `Using ${maxPosition} instead.`,\n    );\n    adjustedPosition = maxPosition;\n  }\n\n  // 5. canDrop validation\n  if (targetColumn.canDrop === false) {\n    errors.push(\n      `[Kanban] moveCard: Column \"${targetColumnId}\" does not accept drops`,\n    );\n    return { success: false, errors };\n  }\n\n  // All validations passed\n  return {\n    success: true,\n    adjustedPosition,\n    sourceInfo,\n    targetColumn,\n    errors: [],\n  };\n}\n\nconst KanbanContext = createContext<KanbanContextData>({\n  columns: [],\n  updateColumnState: () => null,\n  moveCard: () => null,\n  getColumnById: () => undefined,\n  cardMap: new Map(),\n});\n\n/**\n * KanbanProvider - Context provider for Kanban state management\n *\n * Manages column and card state, handles drag-and-drop operations,\n * and provides the moveCard function for card movements.\n *\n * @param props - {@link KanbanProviderProps}\n * @param props.children - Child components.\n * @param props.columns - Array of column data.\n * @param props.updateColumnState - Callback to update column state.\n * @returns The rendered KanbanProvider component.\n *\n * @example\n * ```tsx\n * <KanbanProvider columns={columns} updateColumnState={setColumns}>\n *   <Kanban>...</Kanban>\n * </KanbanProvider>\n * ```\n */\nexport const KanbanProvider = ({\n  children,\n  columns,\n  updateColumnState,\n}: KanbanProviderProps) => {\n  // Create a lookup map for O(1) card access\n  const cardMap = useMemo(() => {\n    const map = new Map<\n      string,\n      { column: KanbanColumnData; card: KanbanCardData; index: number }\n    >();\n\n    columns.forEach((column) => {\n      column.cards.forEach((card, index) => {\n        map.set(card.id, { column, card, index });\n      });\n    });\n\n    return map;\n  }, [columns]);\n\n  const moveCard = useCallback(\n    (\n      cardId: string,\n      targetColumnId: string,\n      targetPosition: number,\n      closestEdge?: 'top' | 'bottom',\n    ) => {\n      // Validate all inputs\n      const validation = validateMoveCard({\n        cardId,\n        targetColumnId,\n        targetPosition,\n        columns,\n        cardMap,\n      });\n\n      // Handle validation failure\n      if (!validation.success) {\n        validation.errors.forEach((error) => {\n          console.error(error);\n        });\n        return false;\n      }\n\n      // Extract validated data - TypeScript knows these are defined after success check\n      const { adjustedPosition, sourceInfo: source, targetColumn } = validation;\n\n      const newColumns = [...columns];\n      const isSameColumn = source.column.id === targetColumn.id;\n\n      // Remove card from source column\n      const newSourceColumn = {\n        ...source.column,\n        cards: source.column.cards.filter((_, i) => i !== source.index),\n      };\n\n      // Calculate insert index using adjusted position\n      let index = getInsertIndex(adjustedPosition, closestEdge);\n\n      // If moving within the same column and moving down, adjust index\n      if (isSameColumn && source.index < index) {\n        index -= 1;\n      }\n\n      // Insert card into target column\n      const newTargetColumn = isSameColumn\n        ? newSourceColumn\n        : { ...targetColumn, cards: [...targetColumn.cards] };\n\n      newTargetColumn.cards.splice(index, 0, {\n        ...source.card,\n        columnId: targetColumnId,\n      });\n\n      // Update positions\n      updatePositions(newTargetColumn);\n      if (!isSameColumn) {\n        updatePositions(newSourceColumn);\n      }\n\n      // Update the columns array with the modified columns\n      const updatedColumns = newColumns.map((col) => {\n        if (col.id === source.column.id) {\n          return newSourceColumn;\n        }\n        if (col.id === targetColumn.id) {\n          return newTargetColumn;\n        }\n        return col;\n      });\n\n      updateColumnState(updatedColumns);\n    },\n    [columns, updateColumnState, cardMap],\n  );\n\n  const getColumnById = useCallback(\n    (id: string) => columns.find((c) => c.id === id),\n    [columns],\n  );\n\n  return (\n    <KanbanContext.Provider\n      value={{ columns, updateColumnState, moveCard, getColumnById, cardMap }}\n    >\n      {children}\n    </KanbanContext.Provider>\n  );\n};\n\n/**\n * Hook to access Kanban context values.\n * Must be used within a KanbanProvider.\n * @returns The Kanban context data.\n */\nexport const useKanban = () => {\n  const context = useContext(KanbanContext);\n  if (!context) {\n    throw new Error('useKanban must be used within KanbanProvider');\n  }\n  return context;\n};\n"],"mappings":"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"}

package/dist/components/kanban/header-actions.d.ts

@@ -12,14 +12,22 @@
 
 import { KanbanComponentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime66 from "react/jsx-runtime";
+import * as react_jsx_runtime83 from "react/jsx-runtime";
 
 //#region src/components/kanban/header-actions.d.ts
+/**
+ * KanbanHeaderActions - Container for header action buttons
+ *
+ * @param props - {@link KanbanComponentProps}
+ * @param props.children - Action button elements.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered KanbanHeaderActions component.
+ */
 declare function KanbanHeaderActions({
   children,
   className,
   ...rest
-}: KanbanComponentProps): react_jsx_runtime66.JSX.Element;
+}: KanbanComponentProps): react_jsx_runtime83.JSX.Element;
 //#endregion
 export { KanbanHeaderActions };
 //# sourceMappingURL=header-actions.d.ts.map

package/dist/components/kanban/header-actions.js

@@ -19,6 +19,14 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/kanban/header-actions.tsx
+/**
+* KanbanHeaderActions - Container for header action buttons
+*
+* @param props - {@link KanbanComponentProps}
+* @param props.children - Action button elements.
+* @param props.className - Optional CSS class name.
+* @returns The rendered KanbanHeaderActions component.
+*/
 function KanbanHeaderActions({ children, className, ...rest }) {
 	return /* @__PURE__ */ jsx("div", {
 		...rest,

package/dist/components/kanban/header-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"header-actions.js","names":[],"sources":["../../../src/components/kanban/header-actions.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\nexport function KanbanHeaderActions({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <div {...rest} className={clsx(styles.headerActions, className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,eAAe,UAAU;EAC5D;GACG"}
+{"version":3,"file":"header-actions.js","names":[],"sources":["../../../src/components/kanban/header-actions.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\n/**\n * KanbanHeaderActions - Container for header action buttons\n *\n * @param props - {@link KanbanComponentProps}\n * @param props.children - Action button elements.\n * @param props.className - Optional CSS class name.\n * @returns The rendered KanbanHeaderActions component.\n */\nexport function KanbanHeaderActions({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <div {...rest} className={clsx(styles.headerActions, className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,SAAgB,oBAAoB,EAClC,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,eAAe,UAAU;EAC5D;GACG"}

package/dist/components/kanban/header-search.d.ts

@@ -12,13 +12,20 @@
 
 import { KanbanSearchProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime98 from "react/jsx-runtime";
+import * as react_jsx_runtime84 from "react/jsx-runtime";
 
 //#region src/components/kanban/header-search.d.ts
+/**
+ * KanbanHeaderSearch - Search field for filtering cards
+ *
+ * @param props - {@link KanbanSearchProps}
+ * @param props.classNames - CSS class names for the search field.
+ * @returns The rendered KanbanHeaderSearch component.
+ */
 declare function KanbanHeaderSearch({
   classNames,
   ...rest
-}: KanbanSearchProps): react_jsx_runtime98.JSX.Element;
+}: KanbanSearchProps): react_jsx_runtime84.JSX.Element;
 //#endregion
 export { KanbanHeaderSearch };
 //# sourceMappingURL=header-search.d.ts.map

package/dist/components/kanban/header-search.js

@@ -18,6 +18,13 @@ import "client-only";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/components/kanban/header-search.tsx
+/**
+* KanbanHeaderSearch - Search field for filtering cards
+*
+* @param props - {@link KanbanSearchProps}
+* @param props.classNames - CSS class names for the search field.
+* @returns The rendered KanbanHeaderSearch component.
+*/
 function KanbanHeaderSearch({ classNames, ...rest }) {
 	return /* @__PURE__ */ jsx(SearchField, {
 		...rest,

package/dist/components/kanban/header-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"header-search.js","names":[],"sources":["../../../src/components/kanban/header-search.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { SearchField } from '../search-field';\nimport type { KanbanSearchProps } from './types';\n\nexport function KanbanHeaderSearch({ classNames, ...rest }: KanbanSearchProps) {\n  return (\n    <SearchField\n      {...rest}\n      variant='outline'\n      classNames={classNames}\n      aria-label='Search'\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAiBA,SAAgB,mBAAmB,EAAE,YAAY,GAAG,QAA2B;AAC7E,QACE,oBAAC;EACC,GAAI;EACJ,SAAQ;EACI;EACZ,cAAW;GACX"}
+{"version":3,"file":"header-search.js","names":[],"sources":["../../../src/components/kanban/header-search.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { SearchField } from '../search-field';\nimport type { KanbanSearchProps } from './types';\n\n/**\n * KanbanHeaderSearch - Search field for filtering cards\n *\n * @param props - {@link KanbanSearchProps}\n * @param props.classNames - CSS class names for the search field.\n * @returns The rendered KanbanHeaderSearch component.\n */\nexport function KanbanHeaderSearch({ classNames, ...rest }: KanbanSearchProps) {\n  return (\n    <SearchField\n      {...rest}\n      variant='outline'\n      classNames={classNames}\n      aria-label='Search'\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBA,SAAgB,mBAAmB,EAAE,YAAY,GAAG,QAA2B;AAC7E,QACE,oBAAC;EACC,GAAI;EACJ,SAAQ;EACI;EACZ,cAAW;GACX"}

package/dist/components/kanban/header-title.d.ts

@@ -12,14 +12,22 @@
 
 import { KanbanComponentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime99 from "react/jsx-runtime";
+import * as react_jsx_runtime85 from "react/jsx-runtime";
 
 //#region src/components/kanban/header-title.d.ts
+/**
+ * KanbanHeaderTitle - Heading element for the board title
+ *
+ * @param props - {@link KanbanComponentProps}
+ * @param props.children - Title text content.
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered KanbanHeaderTitle component.
+ */
 declare function KanbanHeaderTitle({
   children,
   className,
   ...rest
-}: KanbanComponentProps): react_jsx_runtime99.JSX.Element;
+}: KanbanComponentProps): react_jsx_runtime85.JSX.Element;
 //#endregion
 export { KanbanHeaderTitle };
 //# sourceMappingURL=header-title.d.ts.map

package/dist/components/kanban/header-title.js

@@ -20,6 +20,14 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/kanban/header-title.tsx
+/**
+* KanbanHeaderTitle - Heading element for the board title
+*
+* @param props - {@link KanbanComponentProps}
+* @param props.children - Title text content.
+* @param props.className - Optional CSS class name.
+* @returns The rendered KanbanHeaderTitle component.
+*/
 function KanbanHeaderTitle({ children, className, ...rest }) {
 	return /* @__PURE__ */ jsx(Heading, {
 		...rest,

package/dist/components/kanban/header-title.js.map

@@ -1 +1 @@
-{"version":3,"file":"header-title.js","names":[],"sources":["../../../src/components/kanban/header-title.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Heading } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\nexport function KanbanHeaderTitle({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <Heading {...rest} className={clsx(styles.headerTitle, className)}>\n      {children}\n    </Heading>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAmBA,SAAgB,kBAAkB,EAChC,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAQ,GAAI;EAAM,WAAW,KAAK,OAAO,aAAa,UAAU;EAC9D;GACO"}
+{"version":3,"file":"header-title.js","names":[],"sources":["../../../src/components/kanban/header-title.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport { Heading } from 'react-aria-components';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\n/**\n * KanbanHeaderTitle - Heading element for the board title\n *\n * @param props - {@link KanbanComponentProps}\n * @param props.children - Title text content.\n * @param props.className - Optional CSS class name.\n * @returns The rendered KanbanHeaderTitle component.\n */\nexport function KanbanHeaderTitle({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <Heading {...rest} className={clsx(styles.headerTitle, className)}>\n      {children}\n    </Heading>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,SAAgB,kBAAkB,EAChC,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAQ,GAAI;EAAM,WAAW,KAAK,OAAO,aAAa,UAAU;EAC9D;GACO"}

package/dist/components/kanban/header.d.ts

@@ -12,14 +12,24 @@
 
 import { KanbanComponentProps } from "./types.js";
 import "client-only";
-import * as react_jsx_runtime58 from "react/jsx-runtime";
+import * as react_jsx_runtime87 from "react/jsx-runtime";
 
 //#region src/components/kanban/header.d.ts
+/**
+ * KanbanHeader - Header section for the kanban board
+ *
+ * Contains title, search, and action buttons.
+ *
+ * @param props - {@link KanbanComponentProps}
+ * @param props.children - Header content (title, search, actions).
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered KanbanHeader component.
+ */
 declare function KanbanHeader({
   children,
   className,
   ...rest
-}: KanbanComponentProps): react_jsx_runtime58.JSX.Element;
+}: KanbanComponentProps): react_jsx_runtime87.JSX.Element;
 //#endregion
 export { KanbanHeader };
 //# sourceMappingURL=header.d.ts.map

package/dist/components/kanban/header.js

@@ -19,6 +19,16 @@ import { jsx } from "react/jsx-runtime";
 import styles from "./styles.module.css";
 
 //#region src/components/kanban/header.tsx
+/**
+* KanbanHeader - Header section for the kanban board
+*
+* Contains title, search, and action buttons.
+*
+* @param props - {@link KanbanComponentProps}
+* @param props.children - Header content (title, search, actions).
+* @param props.className - Optional CSS class name.
+* @returns The rendered KanbanHeader component.
+*/
 function KanbanHeader({ children, className, ...rest }) {
 	return /* @__PURE__ */ jsx("div", {
 		...rest,

package/dist/components/kanban/header.js.map

@@ -1 +1 @@
-{"version":3,"file":"header.js","names":[],"sources":["../../../src/components/kanban/header.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\nexport function KanbanHeader({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <div {...rest} className={clsx(styles.header, className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkBA,SAAgB,aAAa,EAC3B,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,QAAQ,UAAU;EACrD;GACG"}
+{"version":3,"file":"header.js","names":[],"sources":["../../../src/components/kanban/header.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport styles from './styles.module.css';\nimport type { KanbanComponentProps } from './types';\n\n/**\n * KanbanHeader - Header section for the kanban board\n *\n * Contains title, search, and action buttons.\n *\n * @param props - {@link KanbanComponentProps}\n * @param props.children - Header content (title, search, actions).\n * @param props.className - Optional CSS class name.\n * @returns The rendered KanbanHeader component.\n */\nexport function KanbanHeader({\n  children,\n  className,\n  ...rest\n}: KanbanComponentProps) {\n  return (\n    <div {...rest} className={clsx(styles.header, className)}>\n      {children}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,SAAgB,aAAa,EAC3B,UACA,WACA,GAAG,QACoB;AACvB,QACE,oBAAC;EAAI,GAAI;EAAM,WAAW,KAAK,OAAO,QAAQ,UAAU;EACrD;GACG"}

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

@@ -12,21 +12,50 @@
 
 import { KanbanProps } from "./types.js";
 import "client-only";
-import * as react24 from "react";
-import * as react_jsx_runtime63 from "react/jsx-runtime";
+import * as react25 from "react";
+import * as react_jsx_runtime88 from "react/jsx-runtime";
 
 //#region src/components/kanban/kanban.d.ts
-declare const DragContext: react24.Context<{
+/**
+ * Context for sharing active drag state across Kanban components.
+ */
+declare const DragContext: react25.Context<{
   activeId: string | null;
 } | null>;
+/**
+ * Hook to access the active drag state.
+ * Must be used within a Kanban component.
+ * @returns The drag context with activeId.
+ */
 declare const useDragContext: () => {
   activeId: string | null;
 };
+/**
+ * Kanban - Root container for the drag-and-drop kanban board
+ *
+ * Provides DnD context and manages drag state for cards and columns.
+ * Must be wrapped in a KanbanProvider.
+ *
+ * @param props - {@link KanbanProps}
+ * @param props.children - Child components (columns, header, etc.).
+ * @param props.className - Optional CSS class name.
+ * @returns The rendered Kanban component.
+ *
+ * @example
+ * ```tsx
+ * <KanbanProvider columns={columns} updateColumnState={setColumns}>
+ *   <Kanban>
+ *     <KanbanHeader>...</KanbanHeader>
+ *     <KanbanColumnContainer>...</KanbanColumnContainer>
+ *   </Kanban>
+ * </KanbanProvider>
+ * ```
+ */
 declare function Kanban({
   children,
   className,
   ...rest
-}: KanbanProps): react_jsx_runtime63.JSX.Element;
+}: KanbanProps): react_jsx_runtime88.JSX.Element;
 //#endregion
 export { DragContext, Kanban, useDragContext };
 //# sourceMappingURL=kanban.d.ts.map

package/dist/components/kanban/kanban.js

@@ -22,13 +22,42 @@ import styles from "./styles.module.css";
 import { DndContext, DragOverlay, PointerSensor, closestCenter, pointerWithin, rectIntersection, useSensor, useSensors } from "@dnd-kit/core";
 
 //#region src/components/kanban/kanban.tsx
+/**
+* Context for sharing active drag state across Kanban components.
+*/
 const DragContext = createContext(null);
+/**
+* Hook to access the active drag state.
+* Must be used within a Kanban component.
+* @returns The drag context with activeId.
+*/
 const useDragContext = () => {
 	const context = useContext(DragContext);
 	if (!context) throw new Error("useDragContext must be used within Kanban component");
 	return context;
 };
 const ACTIVATION_DISTANCE = 8;
+/**
+* Kanban - Root container for the drag-and-drop kanban board
+*
+* Provides DnD context and manages drag state for cards and columns.
+* Must be wrapped in a KanbanProvider.
+*
+* @param props - {@link KanbanProps}
+* @param props.children - Child components (columns, header, etc.).
+* @param props.className - Optional CSS class name.
+* @returns The rendered Kanban component.
+*
+* @example
+* ```tsx
+* <KanbanProvider columns={columns} updateColumnState={setColumns}>
+*   <Kanban>
+*     <KanbanHeader>...</KanbanHeader>
+*     <KanbanColumnContainer>...</KanbanColumnContainer>
+*   </Kanban>
+* </KanbanProvider>
+* ```
+*/
 function Kanban({ children, className, ...rest }) {
 	const { moveCard, cardMap } = useKanban();
 	const [activeId, setActiveId] = useState(null);

package/dist/components/kanban/kanban.js.map

@@ -1 +1 @@
-{"version":3,"file":"kanban.js","names":["collisionDetectionStrategy: CollisionDetection"],"sources":["../../../src/components/kanban/kanban.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  type CollisionDetection,\n  closestCenter,\n  DndContext,\n  type DragEndEvent,\n  DragOverlay,\n  type DragStartEvent,\n  PointerSensor,\n  pointerWithin,\n  rectIntersection,\n  useSensor,\n  useSensors,\n} from '@dnd-kit/core';\nimport { createContext, useContext, useState } from 'react';\nimport { parseDropTarget, useKanban } from '@/components/kanban/context';\nimport styles from './styles.module.css';\nimport type { KanbanProps } from './types';\n\n// Context for sharing active drag state\n\nexport const DragContext = createContext<{ activeId: string | null } | null>(\n  null,\n);\n\nexport const useDragContext = () => {\n  const context = useContext(DragContext);\n  if (!context) {\n    throw new Error('useDragContext must be used within Kanban component');\n  }\n  return context;\n};\n\nconst ACTIVATION_DISTANCE = 8;\n\nexport function Kanban({ children, className, ...rest }: KanbanProps) {\n  const { moveCard, cardMap } = useKanban();\n  const [activeId, setActiveId] = useState<string | null>(null);\n\n  const sensors = useSensors(\n    useSensor(PointerSensor, {\n      activationConstraint: {\n        distance: ACTIVATION_DISTANCE,\n      },\n    }),\n  );\n\n  const collisionDetectionStrategy: CollisionDetection = (args) => {\n    // First, try pointer within for direct pointer detection\n    const pointerCollisions = pointerWithin(args);\n    if (pointerCollisions.length > 0) {\n      return pointerCollisions;\n    }\n\n    // Then try rectangle intersection for better coverage\n    const rectCollisions = rectIntersection(args);\n    if (rectCollisions.length > 0) {\n      return rectCollisions;\n    }\n\n    // Fall back to closest center\n    return closestCenter(args);\n  };\n\n  const handleDragStart = (event: DragStartEvent) => {\n    setActiveId(event.active.id as string);\n  };\n\n  const handleDragEnd = (event: DragEndEvent) => {\n    setActiveId(null);\n\n    const dropTarget = parseDropTarget(event);\n    if (!dropTarget) {\n      return;\n    }\n\n    moveCard(\n      event.active.id as string,\n      dropTarget.columnId,\n      dropTarget.position,\n      dropTarget.edge,\n    );\n  };\n\n  // Find the active card for the drag overlay\n  const activeCard = activeId ? cardMap.get(activeId)?.card : null;\n\n  return (\n    <DragContext.Provider value={{ activeId }}>\n      <DndContext\n        sensors={sensors}\n        collisionDetection={collisionDetectionStrategy}\n        onDragStart={handleDragStart}\n        onDragEnd={handleDragEnd}\n      >\n        <div className={clsx(styles.kanban, className)} {...rest}>\n          {children}\n        </div>\n        <DragOverlay>\n          {activeCard ? (\n            <div data-current className={clsx(styles.card)}>\n              <div className={styles.cardHeader}>\n                <span className={styles.cardTitle}>{activeCard.title}</span>\n              </div>\n              <div className={styles.cardBody}>{activeCard.body}</div>\n            </div>\n          ) : null}\n        </DragOverlay>\n      </DndContext>\n    </DragContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAmCA,MAAa,cAAc,cACzB,KACD;AAED,MAAa,uBAAuB;CAClC,MAAM,UAAU,WAAW,YAAY;AACvC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,sDAAsD;AAExE,QAAO;;AAGT,MAAM,sBAAsB;AAE5B,SAAgB,OAAO,EAAE,UAAU,WAAW,GAAG,QAAqB;CACpE,MAAM,EAAE,UAAU,YAAY,WAAW;CACzC,MAAM,CAAC,UAAU,eAAe,SAAwB,KAAK;CAE7D,MAAM,UAAU,WACd,UAAU,eAAe,EACvB,sBAAsB,EACpB,UAAU,qBACX,EACF,CAAC,CACH;CAED,MAAMA,8BAAkD,SAAS;EAE/D,MAAM,oBAAoB,cAAc,KAAK;AAC7C,MAAI,kBAAkB,SAAS,EAC7B,QAAO;EAIT,MAAM,iBAAiB,iBAAiB,KAAK;AAC7C,MAAI,eAAe,SAAS,EAC1B,QAAO;AAIT,SAAO,cAAc,KAAK;;CAG5B,MAAM,mBAAmB,UAA0B;AACjD,cAAY,MAAM,OAAO,GAAa;;CAGxC,MAAM,iBAAiB,UAAwB;AAC7C,cAAY,KAAK;EAEjB,MAAM,aAAa,gBAAgB,MAAM;AACzC,MAAI,CAAC,WACH;AAGF,WACE,MAAM,OAAO,IACb,WAAW,UACX,WAAW,UACX,WAAW,KACZ;;CAIH,MAAM,aAAa,WAAW,QAAQ,IAAI,SAAS,EAAE,OAAO;AAE5D,QACE,oBAAC,YAAY;EAAS,OAAO,EAAE,UAAU;YACvC,qBAAC;GACU;GACT,oBAAoB;GACpB,aAAa;GACb,WAAW;cAEX,oBAAC;IAAI,WAAW,KAAK,OAAO,QAAQ,UAAU;IAAE,GAAI;IACjD;KACG,EACN,oBAAC,yBACE,aACC,qBAAC;IAAI;IAAa,WAAW,KAAK,OAAO,KAAK;eAC5C,oBAAC;KAAI,WAAW,OAAO;eACrB,oBAAC;MAAK,WAAW,OAAO;gBAAY,WAAW;OAAa;MACxD,EACN,oBAAC;KAAI,WAAW,OAAO;eAAW,WAAW;MAAW;KACpD,GACJ,OACQ;IACH;GACQ"}
+{"version":3,"file":"kanban.js","names":["collisionDetectionStrategy: CollisionDetection"],"sources":["../../../src/components/kanban/kanban.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\nimport 'client-only';\n\nimport { clsx } from '@accelint/design-foundation/lib/utils';\nimport {\n  type CollisionDetection,\n  closestCenter,\n  DndContext,\n  type DragEndEvent,\n  DragOverlay,\n  type DragStartEvent,\n  PointerSensor,\n  pointerWithin,\n  rectIntersection,\n  useSensor,\n  useSensors,\n} from '@dnd-kit/core';\nimport { createContext, useContext, useState } from 'react';\nimport { parseDropTarget, useKanban } from '@/components/kanban/context';\nimport styles from './styles.module.css';\nimport type { KanbanProps } from './types';\n\n/**\n * Context for sharing active drag state across Kanban components.\n */\nexport const DragContext = createContext<{ activeId: string | null } | null>(\n  null,\n);\n\n/**\n * Hook to access the active drag state.\n * Must be used within a Kanban component.\n * @returns The drag context with activeId.\n */\nexport const useDragContext = () => {\n  const context = useContext(DragContext);\n  if (!context) {\n    throw new Error('useDragContext must be used within Kanban component');\n  }\n  return context;\n};\n\nconst ACTIVATION_DISTANCE = 8;\n\n/**\n * Kanban - Root container for the drag-and-drop kanban board\n *\n * Provides DnD context and manages drag state for cards and columns.\n * Must be wrapped in a KanbanProvider.\n *\n * @param props - {@link KanbanProps}\n * @param props.children - Child components (columns, header, etc.).\n * @param props.className - Optional CSS class name.\n * @returns The rendered Kanban component.\n *\n * @example\n * ```tsx\n * <KanbanProvider columns={columns} updateColumnState={setColumns}>\n *   <Kanban>\n *     <KanbanHeader>...</KanbanHeader>\n *     <KanbanColumnContainer>...</KanbanColumnContainer>\n *   </Kanban>\n * </KanbanProvider>\n * ```\n */\nexport function Kanban({ children, className, ...rest }: KanbanProps) {\n  const { moveCard, cardMap } = useKanban();\n  const [activeId, setActiveId] = useState<string | null>(null);\n\n  const sensors = useSensors(\n    useSensor(PointerSensor, {\n      activationConstraint: {\n        distance: ACTIVATION_DISTANCE,\n      },\n    }),\n  );\n\n  const collisionDetectionStrategy: CollisionDetection = (args) => {\n    // First, try pointer within for direct pointer detection\n    const pointerCollisions = pointerWithin(args);\n    if (pointerCollisions.length > 0) {\n      return pointerCollisions;\n    }\n\n    // Then try rectangle intersection for better coverage\n    const rectCollisions = rectIntersection(args);\n    if (rectCollisions.length > 0) {\n      return rectCollisions;\n    }\n\n    // Fall back to closest center\n    return closestCenter(args);\n  };\n\n  const handleDragStart = (event: DragStartEvent) => {\n    setActiveId(event.active.id as string);\n  };\n\n  const handleDragEnd = (event: DragEndEvent) => {\n    setActiveId(null);\n\n    const dropTarget = parseDropTarget(event);\n    if (!dropTarget) {\n      return;\n    }\n\n    moveCard(\n      event.active.id as string,\n      dropTarget.columnId,\n      dropTarget.position,\n      dropTarget.edge,\n    );\n  };\n\n  // Find the active card for the drag overlay\n  const activeCard = activeId ? cardMap.get(activeId)?.card : null;\n\n  return (\n    <DragContext.Provider value={{ activeId }}>\n      <DndContext\n        sensors={sensors}\n        collisionDetection={collisionDetectionStrategy}\n        onDragStart={handleDragStart}\n        onDragEnd={handleDragEnd}\n      >\n        <div className={clsx(styles.kanban, className)} {...rest}>\n          {children}\n        </div>\n        <DragOverlay>\n          {activeCard ? (\n            <div data-current className={clsx(styles.card)}>\n              <div className={styles.cardHeader}>\n                <span className={styles.cardTitle}>{activeCard.title}</span>\n              </div>\n              <div className={styles.cardBody}>{activeCard.body}</div>\n            </div>\n          ) : null}\n        </DragOverlay>\n      </DndContext>\n    </DragContext.Provider>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,cAAc,cACzB,KACD;;;;;;AAOD,MAAa,uBAAuB;CAClC,MAAM,UAAU,WAAW,YAAY;AACvC,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,sDAAsD;AAExE,QAAO;;AAGT,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;AAuB5B,SAAgB,OAAO,EAAE,UAAU,WAAW,GAAG,QAAqB;CACpE,MAAM,EAAE,UAAU,YAAY,WAAW;CACzC,MAAM,CAAC,UAAU,eAAe,SAAwB,KAAK;CAE7D,MAAM,UAAU,WACd,UAAU,eAAe,EACvB,sBAAsB,EACpB,UAAU,qBACX,EACF,CAAC,CACH;CAED,MAAMA,8BAAkD,SAAS;EAE/D,MAAM,oBAAoB,cAAc,KAAK;AAC7C,MAAI,kBAAkB,SAAS,EAC7B,QAAO;EAIT,MAAM,iBAAiB,iBAAiB,KAAK;AAC7C,MAAI,eAAe,SAAS,EAC1B,QAAO;AAIT,SAAO,cAAc,KAAK;;CAG5B,MAAM,mBAAmB,UAA0B;AACjD,cAAY,MAAM,OAAO,GAAa;;CAGxC,MAAM,iBAAiB,UAAwB;AAC7C,cAAY,KAAK;EAEjB,MAAM,aAAa,gBAAgB,MAAM;AACzC,MAAI,CAAC,WACH;AAGF,WACE,MAAM,OAAO,IACb,WAAW,UACX,WAAW,UACX,WAAW,KACZ;;CAIH,MAAM,aAAa,WAAW,QAAQ,IAAI,SAAS,EAAE,OAAO;AAE5D,QACE,oBAAC,YAAY;EAAS,OAAO,EAAE,UAAU;YACvC,qBAAC;GACU;GACT,oBAAoB;GACpB,aAAa;GACb,WAAW;cAEX,oBAAC;IAAI,WAAW,KAAK,OAAO,QAAQ,UAAU;IAAE,GAAI;IACjD;KACG,EACN,oBAAC,yBACE,aACC,qBAAC;IAAI;IAAa,WAAW,KAAK,OAAO,KAAK;eAC5C,oBAAC;KAAI,WAAW,OAAO;eACrB,oBAAC;MAAK,WAAW,OAAO;gBAAY,WAAW;OAAa;MACxD,EACN,oBAAC;KAAI,WAAW,OAAO;eAAW,WAAW;MAAW;KACpD,GACJ,OACQ;IACH;GACQ"}