@libxai/board 0.17.157 → 0.17.159

package/dist/index.d.cts

@@ -7,664 +7,1060 @@ import React__default, { Component, ReactNode, ErrorInfo } from 'react';
 import { ClassValue } from 'clsx';
 import * as _tanstack_virtual_core from '@tanstack/virtual-core';
 
+interface TaskSegment {
+    startDate: Date;
+    endDate: Date;
+}
 /**
- * Card Stack Types
- * Smart grouping of related cards within columns
- * @module types/card-stack
+ * v0.17.158: Tag/Label for tasks (ClickUp-style)
+ * Tags are workspace-scoped and can be applied to multiple tasks
  */
-type StackingStrategy = 'manual' | 'ai-similarity' | 'labels' | 'assignee' | 'priority' | 'epic';
-interface CardStack$1 {
-    /** Unique stack identifier */
+interface TaskTag {
     id: string;
-    /** Display title for the stack */
-    title: string;
-    /** Cards contained in this stack */
-    cardIds: string[];
-    /** Column this stack belongs to */
-    columnId: string;
-    /** How this stack was created */
-    strategy: StackingStrategy;
-    /** Visual color for the stack */
+    name: string;
+    color: string;
+}
+interface Task {
+    id: string;
+    name: string;
+    startDate?: Date;
+    endDate?: Date;
+    progress: number;
+    assignees?: Array<{
+        name: string;
+        avatar?: string;
+        initials: string;
+        color: string;
+    }>;
+    status?: string;
+    dependencies?: string[];
+    subtasks?: Task[];
+    isExpanded?: boolean;
+    isMilestone?: boolean;
+    isCriticalPath?: boolean;
     color?: string;
-    /** Whether stack is expanded or collapsed */
-    isExpanded: boolean;
-    /** Position within the column */
-    position: number;
-    /** Timestamp when stack was created */
-    createdAt: Date;
-    /** AI confidence score (0-1) for auto-stacked groups */
-    confidence?: number;
+    priority?: 'low' | 'medium' | 'high' | 'urgent';
+    tags?: TaskTag[];
+    segments?: TaskSegment[];
+    parentId?: string;
+    level?: number;
+    position?: number;
 }
-interface StackingConfig {
-    /** Enable automatic AI-powered stacking */
-    enableAutoStacking: boolean;
-    /** Minimum confidence threshold for auto-stacking (0-1) */
-    autoStackConfidenceThreshold: number;
-    /** Minimum cards required to form a stack */
-    minCardsPerStack: number;
-    /** Enable manual drag-to-stack */
-    enableManualStacking: boolean;
-    /** Show stack summaries (card count, assignees, etc.) */
-    showStackSummaries: boolean;
-    /** Animation duration in ms */
-    animationDuration: number;
+type TimeScale = 'day' | 'week' | 'month';
+type Theme$1 = 'dark' | 'light' | 'neutral';
+type RowDensity = 'compact' | 'comfortable' | 'spacious';
+type ColumnType = 'name' | 'startDate' | 'endDate' | 'duration' | 'assignees' | 'status' | 'progress' | 'priority';
+interface GanttColumn {
+    id: ColumnType;
+    label: string;
+    width: number;
+    minWidth?: number;
+    maxWidth?: number;
+    visible: boolean;
+    sortable?: boolean;
+    resizable?: boolean;
 }
-interface StackSuggestion {
-    /** Suggested stack configuration */
-    stack: Omit<CardStack$1, 'id' | 'createdAt' | 'isExpanded' | 'position'>;
-    /** Reason for suggestion */
-    reason: string;
-    /** Confidence score (0-1) */
-    confidence: number;
+interface Assignee {
+    name: string;
+    initials: string;
+    color: string;
+}
+interface GanttTheme {
+    bgPrimary: string;
+    bgSecondary: string;
+    bgGrid: string;
+    bgWeekend: string;
+    border: string;
+    borderLight: string;
+    textPrimary: string;
+    textSecondary: string;
+    textTertiary: string;
+    accent: string;
+    accentHover: string;
+    accentLight: string;
+    taskBarPrimary: string;
+    taskBarProgress: string;
+    taskBarHandle: string;
+    dependency: string;
+    dependencyHover: string;
+    criticalPath: string;
+    criticalPathLight: string;
+    today: string;
+    todayLight: string;
+    milestone: string;
+    milestoneLight: string;
+    statusTodo: string;
+    statusInProgress: string;
+    statusCompleted: string;
+    hoverBg: string;
+    focusRing: string;
 }
-
-/**
- * Core types for ASAKAA Kanban Board
- * @module types
- */
-
-/**
- * Priority levels for cards
- */
-type Priority = 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT';
 /**
- * Subtask entity
- * Represents a checklist item within a card
+ * Templates for customizing Gantt rendering
+ * Similar to DHTMLX gantt.templates.*
  */
-interface Subtask {
-    /** Unique identifier */
-    id: string;
-    /** Subtask title */
-    title: string;
-    /** Completion status */
-    completed: boolean;
-    /** Position within the subtask list */
-    position?: number;
-    /** Assigned user ID (optional) */
-    assigneeId?: string;
-    /** Due date (optional) */
-    dueDate?: Date | string;
-    /** Created timestamp */
-    createdAt?: Date | string;
-    /** Updated timestamp */
-    updatedAt?: Date | string;
+interface GanttTemplates {
+    /**
+     * Customize task tooltip content
+     * @param task - The task to render tooltip for
+     * @returns Tooltip content (string or JSX)
+     */
+    taskTooltip?: (task: Task) => string | React.ReactNode;
+    /**
+     * Customize task label in timeline
+     * @param task - The task to render label for
+     * @returns Label content (string or JSX)
+     */
+    taskLabel?: (task: Task) => string | React.ReactNode;
+    /**
+     * Customize grid cell content
+     * @param task - The task for this row
+     * @param column - The column type
+     * @param value - Default cell value
+     * @returns Cell content (string or JSX)
+     */
+    gridCell?: (task: Task, column: ColumnType, value: any) => string | React.ReactNode;
+    /**
+     * Add custom CSS classes to task bar
+     * @param task - The task to style
+     * @returns Space-separated CSS class names
+     */
+    taskClass?: (task: Task) => string;
+    /**
+     * Customize milestone rendering
+     * @param task - The milestone task
+     * @returns Milestone content (string or JSX)
+     */
+    milestoneContent?: (task: Task) => string | React.ReactNode;
+    /**
+     * Format date display
+     * @param date - Date to format
+     * @returns Formatted date string
+     */
+    dateFormat?: (date: Date) => string;
+    /**
+     * Format duration display
+     * @param days - Duration in days
+     * @returns Formatted duration string
+     */
+    durationFormat?: (days: number) => string;
+    /**
+     * Format progress display
+     * @param progress - Progress percentage (0-100)
+     * @returns Formatted progress string
+     */
+    progressFormat?: (progress: number) => string;
 }
 /**
- * Card status types
+ * Permissions interface for controlling Gantt operations
+ * Useful for integrating with authorization libraries like CASL
+ * @example
+ *
+ * // With CASL integration
+ * const ability = useAbility();
+ *
+ * <GanttBoard
+ *   tasks={tasks}
+ *   config={{
+ *     permissions: {
+ *       canCreateTask: ability.can('create', 'Task'),
+ *       canUpdateTask: ability.can('update', 'Task'),
+ *       canDeleteTask: ability.can('delete', 'Task'),
+ *       canCreateDependency: ability.can('create', 'Dependency'),
+ *       canUpdateProgress: ability.can('update', 'TaskProgress'),
+ *     }
+ *   }}
+ * />
+ *
  */
-type CardStatus = 'TODO' | 'IN_PROGRESS' | 'REVIEW' | 'DONE' | 'BLOCKED';
+interface GanttPermissions {
+    canCreateTask?: boolean;
+    canUpdateTask?: boolean;
+    canDeleteTask?: boolean;
+    canCreateDependency?: boolean;
+    canDeleteDependency?: boolean;
+    canUpdateProgress?: boolean;
+    canAssignUsers?: boolean;
+    canModifyHierarchy?: boolean;
+    canDuplicateTask?: boolean;
+    canReorderTasks?: boolean;
+    canExport?: boolean;
+    canToggleExpansion?: boolean;
+    canPerformAction?: (task: Task, action: 'create' | 'update' | 'delete' | 'assign' | 'progress') => boolean;
+}
 /**
- * Card entity
- * Represents a single task/item in the Kanban board
- */
-interface Card$1 {
-    /** Unique identifier */
-    id: string;
-    /** Card title (required) */
-    title: string;
-    /** Card description (optional) */
-    description?: string;
-    /** Lexicographic position within column (for ordering) */
-    position: number;
-    /** Parent column ID */
-    columnId: string;
-    /** Priority level */
-    priority?: Priority;
-    /** Assigned user ID (legacy - use assignedUserIds) */
-    assigneeId?: string;
-    /** Assigned user IDs (multiple users) */
-    assignedUserIds?: string[];
-    /** Tags/labels */
-    labels?: string[];
-    /** Due date (legacy - use startDate/endDate) */
-    dueDate?: Date | string;
-    /** Date range - start date */
-    startDate?: Date | string;
-    /** Date range - end date */
-    endDate?: Date | string;
-    /** Task dependencies - supports both legacy format (string[]) and new format (Dependency[]) */
-    dependencies?: string[] | Dependency[];
-    /** Estimated time (in hours) */
-    estimatedTime?: number;
-    /** Manual progress override (0-100%) */
-    progress?: number;
-    /** Cover image URL */
-    coverImage?: string;
-    /** Subtasks/checklist items */
-    subtasks?: Subtask[];
-    /** v0.17.29: Custom color for visual identification (hex color) */
-    color?: string;
-    /** Custom metadata */
-    metadata?: Record<string, unknown>;
-    createdAt?: Date | string;
-    updatedAt?: Date | string;
-}
-/**
- * Column entity
- * Represents a stage/status in the workflow
+ * Scroll behavior configuration for timeline interactions
+ * Controls how the Gantt chart viewport behaves during user interactions
+ *
+ * @example
+ * // Disable all automatic scrolling during drag operations
+ * <GanttBoard
+ *   config={{
+ *     scrollBehavior: {
+ *       preventAutoScroll: true,
+ *       axis: 'horizontal'
+ *     }
+ *   }}
+ * />
+ *
+ * @example
+ * // Allow vertical auto-scroll but prevent horizontal
+ * <GanttBoard
+ *   config={{
+ *     scrollBehavior: {
+ *       preventAutoScroll: true,
+ *       axis: 'horizontal',
+ *       onScrollPrevented: (axis, scrollDelta) => {
+ *         console.log(`Prevented ${axis} scroll by ${scrollDelta}px`);
+ *       }
+ *     }
+ *   }}
+ * />
  */
-interface Column$1 {
-    /** Unique identifier */
-    id: string;
-    /** Column title */
-    title: string;
-    /** Lexicographic position (for ordering columns) */
-    position: number;
-    /** Array of card IDs in this column */
-    cardIds: string[];
-    /** Work-in-progress limit */
-    wipLimit?: number;
-    /** WIP limit enforcement type: 'soft' = warning, 'hard' = block */
-    wipLimitType?: 'soft' | 'hard';
-    /** Color for visual distinction */
-    color?: string;
-    /** Custom metadata */
-    metadata?: Record<string, unknown>;
-    createdAt?: Date | string;
-    updatedAt?: Date | string;
+interface GanttScrollBehavior {
+    /**
+     * Prevent automatic viewport scrolling during drag operations
+     * When true, the viewport will not automatically center on dragged tasks
+     * Users can still manually scroll using scrollbars or mouse wheel
+     * @default false
+     */
+    preventAutoScroll?: boolean;
+    /**
+     * Which axis to prevent auto-scroll on
+     * - 'horizontal': Only prevent horizontal auto-scroll (recommended for Gantt charts)
+     * - 'vertical': Only prevent vertical auto-scroll
+     * - 'both': Prevent both horizontal and vertical auto-scroll
+     * @default 'horizontal'
+     */
+    axis?: 'horizontal' | 'vertical' | 'both';
+    /**
+     * Callback fired when auto-scroll is prevented
+     * Useful for debugging or showing user feedback
+     * @param axis - Which axis was prevented ('x' or 'y')
+     * @param scrollDelta - How many pixels of scroll were prevented
+     */
+    onScrollPrevented?: (axis: 'x' | 'y', scrollDelta: number) => void;
+    /**
+     * Allow auto-scroll if task would go out of viewport bounds
+     * When true, auto-scroll is only prevented if task remains visible
+     * @default false
+     */
+    allowScrollWhenOutOfBounds?: boolean;
 }
 /**
- * Board entity
- * Top-level container for the Kanban board
+ * AI chat message interface
+ * @version 0.17.42
  */
-interface Board {
-    /** Unique identifier */
+interface AIMessage {
     id: string;
-    /** Board title */
-    title?: string;
-    /** Array of columns */
-    columns: Column$1[];
-    /** Array of all cards */
-    cards: Card$1[];
-    metadata?: Record<string, any>;
-}
-/**
- * Callbacks for board operations
- * These allow the library consumer to persist changes
- */
-interface BoardCallbacks {
-    /** Called when a card is moved to a different position/column */
-    onCardMove?: (cardId: string, targetColumnId: string, position: number) => void | Promise<void>;
-    /** Called when card properties are updated */
-    onCardUpdate?: (cardId: string, updates: Partial<Card$1>) => void | Promise<void>;
-    /** Called when a new card is created */
-    onCardCreate?: (card: Omit<Card$1, 'id'>) => void | Promise<void>;
-    /** Called when a card is deleted */
-    onCardDelete?: (cardId: string) => void | Promise<void>;
-    /** Called when a new column is created */
-    onColumnCreate?: (column: Omit<Column$1, 'id' | 'cardIds'>) => void | Promise<void>;
-    /** Called when column properties are updated */
-    onColumnUpdate?: (columnId: string, updates: Partial<Column$1>) => void | Promise<void>;
-    /** Called when a column is deleted */
-    onColumnDelete?: (columnId: string) => void | Promise<void>;
-    /** Called when columns are reordered */
-    onColumnReorder?: (columnId: string, newPosition: number) => void | Promise<void>;
-    /** Called when WIP limit is exceeded (hard limit only) */
-    onWipLimitExceeded?: (column: Column$1, card: Card$1) => void;
-}
-/**
- * Insight types generated by AI
- */
-type InsightType = 'RISK_DELAY' | 'RISK_OVERLOAD' | 'RISK_BLOCKER' | 'OPPORTUNITY' | 'SUGGESTION';
-/**
- * Severity levels for insights
- */
-type InsightSeverity = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
-/**
- * AI-generated insight about the board state
- */
-interface Insight {
-    /** Unique identifier */
-    id?: string;
-    /** Type of insight */
-    type: InsightType;
-    /** Severity level */
-    severity: InsightSeverity;
-    /** Human-readable title */
-    title: string;
-    /** Detailed description */
-    description: string;
-    /** AI confidence score (0-1) */
-    confidence: number;
-    /** Suggested action to take */
-    suggestedAction?: string;
-    /** Related card IDs */
-    relatedCardIds?: string[];
-    /** Related column IDs */
-    relatedColumnIds?: string[];
-    /** Timestamp */
-    timestamp?: Date | string;
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+    command?: AICommandResult;
+    isLoading?: boolean;
 }
 /**
- * Result of AI assignee suggestion
+ * Configuration for persisting AI chat history in localStorage
+ * @version 0.17.42
  */
-interface AssigneeSuggestion {
-    /** Suggested user ID */
-    userId: string;
-    /** Confidence score (0-1) */
-    confidence: number;
-    /** Reasoning for suggestion */
-    reasoning: string;
+interface PersistHistoryConfig {
+    /** Enable history persistence in localStorage */
+    enabled: boolean;
+    /** Maximum messages to persist (default: 5) */
+    maxMessages?: number;
+    /** Custom storage key (default: 'gantt-ai-history') */
+    storageKey?: string;
 }
 /**
- * Result of AI plan generation
+ * AI Assistant configuration for natural language task editing
+ * @version 0.14.0
+ * @updated 0.17.42 - Added persistHistory option
  */
-interface GeneratedPlan {
-    /** Generated columns */
-    columns: Omit<Column$1, 'id'>[];
-    /** Generated cards */
-    cards: Omit<Card$1, 'id'>[];
-    /** Explanation of the plan */
-    explanation?: string;
+interface GanttAIAssistantConfig {
+    /** Enable AI assistant (default: false) */
+    enabled?: boolean;
+    /** Custom placeholder text */
+    placeholder?: string;
+    /** Position of the chat button */
+    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+    /** Handler for AI commands - should return task updates */
+    onCommand?: (command: string, tasks: Task[]) => Promise<AICommandResult>;
+    /** Custom suggestions for the command palette */
+    suggestions?: string[];
+    /** Maximum messages to keep in memory history */
+    maxHistory?: number;
+    /** Persist chat history in localStorage @version 0.17.42 */
+    persistHistory?: PersistHistoryConfig;
 }
 /**
- * AI callbacks (optional)
- * Consumer provides these if they want AI features
+ * AI Command result interface
+ * @version 0.14.0
  */
-interface AICallbacks {
-    /** Generate a complete board plan from a text prompt */
-    onGeneratePlan?: (prompt: string) => Promise<GeneratedPlan>;
-    /** Suggest best assignee for a card */
-    onSuggestAssignee?: (card: Card$1) => Promise<AssigneeSuggestion>;
-    /** Predict risks and opportunities based on board state */
-    onPredictRisks?: (boardState: Board) => Promise<Insight[]>;
-    /** Generate subtasks for a card */
-    onGenerateSubtasks?: (card: Card$1) => Promise<Omit<Card$1, 'id'>[]>;
-    /** Estimate effort for a card */
-    onEstimateEffort?: (card: Card$1) => Promise<{
-        hours: number;
-        confidence: number;
-    }>;
+interface AICommandResult {
+    type: 'move_task' | 'resize_task' | 'rename_task' | 'delete_task' | 'create_task' | 'link_tasks' | 'unlink_tasks' | 'assign_task' | 'set_progress' | 'set_status' | 'split_task' | 'group_tasks' | 'unknown';
+    taskId?: string;
+    taskName?: string;
+    updates?: Partial<Task>;
+    newTask?: Task;
+    dependencyFrom?: string;
+    dependencyTo?: string;
+    message: string;
+    success: boolean;
+    error?: string;
 }
-/**
- * Configuration options for the Kanban board
- */
-interface BoardConfig {
-    /** Theme: 'dark' | 'light' | 'neutral' */
-    theme?: 'dark' | 'light' | 'neutral';
-    /** Locale for i18n */
+interface GanttConfig {
+    theme?: Theme$1;
+    timeScale?: TimeScale;
+    rowDensity?: RowDensity;
+    showThemeSelector?: boolean;
+    showExportButton?: boolean;
+    availableUsers?: Array<{
+        id: string;
+        name: string;
+        initials: string;
+        color: string;
+    }>;
+    /**
+     * v0.15.0: Internationalization (i18n) support
+     * Set the locale for all UI text in the Gantt chart
+     * Built-in support for 'en' (English) and 'es' (Spanish)
+     * @default 'en'
+     */
     locale?: 'en' | 'es' | string;
-    /** Enable virtualization (auto-enabled if >100 cards) */
-    enableVirtualization?: boolean;
-    /** Enable AI features */
-    enableAI?: boolean;
-    /** Animation duration in milliseconds */
-    animationDuration?: number;
-    /** Fixed column width in pixels */
-    columnWidth?: number;
-    /** Estimated card height for virtualization */
-    cardHeight?: number;
-    /** Enable keyboard shortcuts */
-    enableKeyboardShortcuts?: boolean;
-    /** Show card count in column headers */
-    showCardCount?: boolean;
-    /** Show WIP limits */
-    showWipLimits?: boolean;
-    /** Enable column collapsing */
-    enableCollapsible?: boolean;
-    /** Maximum cards to display per column before showing "show more" */
-    maxCardsPerColumn?: number;
-}
-/**
- * Render props for customization
- */
-interface RenderProps {
-    /** Custom card renderer */
-    renderCard?: (card: Card$1) => React.ReactNode;
-    /** Custom column renderer */
-    renderColumn?: (column: Column$1, cards: Card$1[]) => React.ReactNode;
-    /** Custom card overlay during drag */
-    renderCardOverlay?: (card: Card$1) => React.ReactNode;
-    /** Custom column header */
-    renderColumnHeader?: (column: Column$1, cardCount: number) => React.ReactNode;
-    /** Custom empty state */
-    renderEmptyState?: (column: Column$1) => React.ReactNode;
+    /**
+     * v0.15.0: Custom translations to override default locale strings
+     * Allows partial overrides while keeping defaults for missing keys
+     * @see GanttTranslations in i18n.ts
+     */
+    customTranslations?: Record<string, any>;
+    aiAssistant?: GanttAIAssistantConfig;
+    showCreateTaskButton?: boolean;
+    createTaskLabel?: string;
+    onCreateTask?: () => void;
+    templates?: GanttTemplates;
+    permissions?: GanttPermissions;
+    disableScrollSync?: boolean;
+    /**
+     * v0.9.2: Advanced scroll behavior configuration
+     * Controls how the timeline viewport behaves during drag operations
+     * Provides fine-grained control over auto-scroll prevention with events
+     * @see GanttScrollBehavior
+     */
+    scrollBehavior?: GanttScrollBehavior;
+    /**
+     * v0.11.1: Enable automatic Critical Path Method (CPM) calculation
+     * When true (default), tasks with zero slack are automatically marked as critical (red)
+     * When false, preserves custom task colors and disables automatic CPM marking
+     * @default true
+     */
+    enableAutoCriticalPath?: boolean;
+    onThemeChange?: (theme: Theme$1) => void;
+    onTaskClick?: (task: Task) => void;
+    onTaskDblClick?: (task: Task) => void;
+    onTaskContextMenu?: (task: Task, event: React.MouseEvent) => void;
+    onTaskUpdate?: (task: Task) => void;
+    onTaskDateChange?: (task: Task, startDate: Date, endDate: Date) => void;
+    onProgressChange?: (taskId: string, oldProgress: number, newProgress: number) => void;
+    /**
+     * Called when user clicks "Edit Task" in context menu
+     * If not provided, the built-in TaskFormModal will be used
+     */
+    onTaskEdit?: (task: Task) => void;
+    /**
+     * Called when user clicks "Add Subtask" in context menu
+     * If not provided, the built-in subtask creation will be used
+     */
+    onTaskAddSubtask?: (parentTask: Task) => void;
+    /**
+     * Called when user clicks "Mark Incomplete" in context menu
+     * Sets task status to 'todo' and progress to 0
+     */
+    onTaskMarkIncomplete?: (task: Task) => void;
+    /**
+     * Called when user clicks "Set In Progress" in context menu
+     * Sets task status to 'in-progress'
+     */
+    onTaskSetInProgress?: (task: Task) => void;
+    onDependencyCreate?: (fromTaskId: string, toTaskId: string) => void;
+    onDependencyDelete?: (taskId: string, dependencyId: string) => void;
+    onBeforeTaskAdd?: (task: Task) => boolean | void | Promise<boolean | void>;
+    onAfterTaskAdd?: (task: Task) => void;
+    onBeforeTaskUpdate?: (taskId: string, newData: Partial<Task>) => boolean | void | Promise<boolean | void>;
+    onAfterTaskUpdate?: (task: Task) => void;
+    onBeforeTaskDelete?: (taskId: string) => boolean | void | Promise<boolean | void>;
+    onAfterTaskDelete?: (taskId: string) => void;
+    onTaskCreate?: (parentId: string | undefined, position: number) => void;
+    onTaskDelete?: (taskId: string) => void;
+    onMultiTaskDelete?: (taskIds: string[]) => void;
+    onTaskDuplicate?: (taskId: string) => void;
+    onTaskMove?: (taskId: string, direction: 'up' | 'down') => void;
+    onTaskIndent?: (taskId: string) => void;
+    onTaskOutdent?: (taskId: string) => void;
+    onTaskRename?: (taskId: string, newName: string) => void;
+    onTaskToggleExpand?: (taskId: string) => void;
+    onTaskReparent?: (taskId: string, newParentId: string | null, position?: number) => void;
 }
+
 /**
- * User entity for assignment
+ * Card Stack Types
+ * Smart grouping of related cards within columns
+ * @module types/card-stack
  */
-interface User$1 {
+type StackingStrategy = 'manual' | 'ai-similarity' | 'labels' | 'assignee' | 'priority' | 'epic';
+interface CardStack$1 {
+    /** Unique stack identifier */
     id: string;
-    name: string;
-    initials: string;
-    color: string;
-    avatar?: string;
+    /** Display title for the stack */
+    title: string;
+    /** Cards contained in this stack */
+    cardIds: string[];
+    /** Column this stack belongs to */
+    columnId: string;
+    /** How this stack was created */
+    strategy: StackingStrategy;
+    /** Visual color for the stack */
+    color?: string;
+    /** Whether stack is expanded or collapsed */
+    isExpanded: boolean;
+    /** Position within the column */
+    position: number;
+    /** Timestamp when stack was created */
+    createdAt: Date;
+    /** AI confidence score (0-1) for auto-stacked groups */
+    confidence?: number;
+}
+interface StackingConfig {
+    /** Enable automatic AI-powered stacking */
+    enableAutoStacking: boolean;
+    /** Minimum confidence threshold for auto-stacking (0-1) */
+    autoStackConfidenceThreshold: number;
+    /** Minimum cards required to form a stack */
+    minCardsPerStack: number;
+    /** Enable manual drag-to-stack */
+    enableManualStacking: boolean;
+    /** Show stack summaries (card count, assignees, etc.) */
+    showStackSummaries: boolean;
+    /** Animation duration in ms */
+    animationDuration: number;
+}
+interface StackSuggestion {
+    /** Suggested stack configuration */
+    stack: Omit<CardStack$1, 'id' | 'createdAt' | 'isExpanded' | 'position'>;
+    /** Reason for suggestion */
+    reason: string;
+    /** Confidence score (0-1) */
+    confidence: number;
 }
+
 /**
- * Main KanbanBoard component props
+ * Core types for ASAKAA Kanban Board
+ * @module types
  */
-interface KanbanBoardProps {
-    /** Board data (controlled) */
-    board: Board;
-    /** Callbacks for mutations */
-    callbacks: BoardCallbacks;
-    /** AI callbacks (optional) */
-    aiCallbacks?: AICallbacks;
-    /** Card click handler */
-    onCardClick?: (card: Card$1) => void;
-    /** Render customization */
-    renderProps?: RenderProps;
-    /** Configuration */
-    config?: BoardConfig;
-    /** Available users for assignment */
-    availableUsers?: User$1[];
-    /** Custom CSS class */
-    className?: string;
-    /** Custom inline styles */
-    style?: React.CSSProperties;
-    /** Loading state */
-    isLoading?: boolean;
-    /** Error state */
-    error?: Error | string;
-}
+
 /**
- * Drag event data
+ * Priority levels for cards
  */
-interface DragData {
-    /** Card being dragged */
-    card: Card$1;
-    /** Source column ID */
-    sourceColumnId: string;
-    /** Source position */
-    sourcePosition: number;
-}
+type Priority = 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT';
 /**
- * Drop event data
+ * Subtask entity
+ * Represents a checklist item within a card
  */
-interface DropData {
-    /** Card being dropped */
-    card: Card$1;
-    /** Target column ID */
-    targetColumnId: string;
-    /** Target position */
-    targetPosition: number;
-    /** Source column ID */
-    sourceColumnId: string;
+interface Subtask {
+    /** Unique identifier */
+    id: string;
+    /** Subtask title */
+    title: string;
+    /** Completion status */
+    completed: boolean;
+    /** Position within the subtask list */
+    position?: number;
+    /** Assigned user ID (optional) */
+    assigneeId?: string;
+    /** Due date (optional) */
+    dueDate?: Date | string;
+    /** Created timestamp */
+    createdAt?: Date | string;
+    /** Updated timestamp */
+    updatedAt?: Date | string;
 }
 /**
- * Filter criteria for cards
+ * Card status types
  */
-interface CardFilter {
-    /** Filter by assignee */
-    assigneeIds?: string[];
-    /** Filter by priority */
-    priorities?: Priority[];
-    /** Filter by labels */
-    labels?: string[];
-    /** Search in title/description */
-    search?: string;
-    /** Filter by date range */
-    dateRange?: {
-        start: Date | string;
-        end: Date | string;
-    };
-}
-/**
- * Sort options for cards
- */
-type CardSortKey = 'position' | 'priority' | 'dueDate' | 'createdAt' | 'title';
-interface CardSort {
-    key: CardSortKey;
-    direction: 'asc' | 'desc';
-}
+type CardStatus = 'TODO' | 'IN_PROGRESS' | 'REVIEW' | 'DONE' | 'BLOCKED';
 /**
- * Comment on a card
+ * Card entity
+ * Represents a single task/item in the Kanban board
  */
-interface Comment {
+interface Card$1 {
     /** Unique identifier */
     id: string;
-    /** Card ID */
-    cardId: string;
-    /** Author user ID */
-    authorId: string;
-    /** Comment content */
-    content: string;
-    /** Timestamp */
-    createdAt: Date | string;
-    /** Last update timestamp */
+    /** Card title (required) */
+    title: string;
+    /** Card description (optional) */
+    description?: string;
+    /** Lexicographic position within column (for ordering) */
+    position: number;
+    /** Parent column ID */
+    columnId: string;
+    /** Priority level */
+    priority?: Priority;
+    /** Assigned user ID (legacy - use assignedUserIds) */
+    assigneeId?: string;
+    /** Assigned user IDs (multiple users) */
+    assignedUserIds?: string[];
+    /** Tags/labels */
+    labels?: string[];
+    /** Due date (legacy - use startDate/endDate) */
+    dueDate?: Date | string;
+    /** Date range - start date */
+    startDate?: Date | string;
+    /** Date range - end date */
+    endDate?: Date | string;
+    /** Task dependencies - supports both legacy format (string[]) and new format (Dependency[]) */
+    dependencies?: string[] | Dependency[];
+    /** Estimated time (in hours) */
+    estimatedTime?: number;
+    /** Manual progress override (0-100%) */
+    progress?: number;
+    /** Cover image URL */
+    coverImage?: string;
+    /** Subtasks/checklist items */
+    subtasks?: Subtask[];
+    /** v0.17.29: Custom color for visual identification (hex color) */
+    color?: string;
+    /** v0.17.158: Tags with colors (ClickUp-style) */
+    tags?: TaskTag[];
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    createdAt?: Date | string;
     updatedAt?: Date | string;
-    /** Mentions (user IDs) */
-    mentions?: string[];
 }
 /**
- * Activity log entry types
- */
-type ActivityType = 'CARD_CREATED' | 'CARD_UPDATED' | 'CARD_MOVED' | 'CARD_DELETED' | 'COMMENT_ADDED' | 'USER_ASSIGNED' | 'USER_UNASSIGNED' | 'PRIORITY_CHANGED' | 'DUE_DATE_CHANGED' | 'LABEL_ADDED' | 'LABEL_REMOVED' | 'DEPENDENCY_ADDED' | 'DEPENDENCY_REMOVED' | 'ATTACHMENT_ADDED' | 'ATTACHMENT_REMOVED';
-/**
- * Activity log entry
+ * Column entity
+ * Represents a stage/status in the workflow
  */
-interface Activity {
+interface Column$1 {
     /** Unique identifier */
     id: string;
-    /** Activity type */
-    type: ActivityType;
-    /** Card ID */
-    cardId: string;
-    /** User who performed the action */
-    userId: string;
-    /** Timestamp */
-    timestamp: Date | string;
-    /** Previous value (for updates) */
-    previousValue?: any;
-    /** New value (for updates) */
-    newValue?: any;
-    /** Additional metadata */
-    metadata?: Record<string, any>;
+    /** Column title */
+    title: string;
+    /** Lexicographic position (for ordering columns) */
+    position: number;
+    /** Array of card IDs in this column */
+    cardIds: string[];
+    /** Work-in-progress limit */
+    wipLimit?: number;
+    /** WIP limit enforcement type: 'soft' = warning, 'hard' = block */
+    wipLimitType?: 'soft' | 'hard';
+    /** Color for visual distinction */
+    color?: string;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    createdAt?: Date | string;
+    updatedAt?: Date | string;
 }
 /**
- * File attachment on a card
+ * Board entity
+ * Top-level container for the Kanban board
  */
-interface Attachment {
+interface Board {
     /** Unique identifier */
     id: string;
-    /** Card ID */
-    cardId: string;
-    /** File name */
-    name: string;
-    /** File size in bytes */
-    size: number;
-    /** MIME type */
-    type: string;
-    /** File URL or data URI */
-    url: string;
-    /** Upload timestamp */
-    uploadedAt: Date | string;
-    /** User who uploaded */
-    uploadedBy: string;
-    /** Thumbnail URL (for images) */
-    thumbnailUrl?: string;
+    /** Board title */
+    title?: string;
+    /** Array of columns */
+    columns: Column$1[];
+    /** Array of all cards */
+    cards: Card$1[];
+    metadata?: Record<string, any>;
 }
 /**
- * Bulk operations callbacks
+ * Callbacks for board operations
+ * These allow the library consumer to persist changes
  */
-interface BulkOperationsCallbacks {
-    /** Called when bulk update is performed */
-    onBulkUpdate?: (cardIds: string[], updates: Partial<Card$1>) => void | Promise<void>;
-    /** Called when bulk delete is performed */
-    onBulkDelete?: (cardIds: string[]) => void | Promise<void>;
-    /** Called when bulk move is performed */
-    onBulkMove?: (cardIds: string[], targetColumnId: string) => void | Promise<void>;
+interface BoardCallbacks {
+    /** Called when a card is moved to a different position/column */
+    onCardMove?: (cardId: string, targetColumnId: string, position: number) => void | Promise<void>;
+    /** Called when card properties are updated */
+    onCardUpdate?: (cardId: string, updates: Partial<Card$1>) => void | Promise<void>;
+    /** Called when a new card is created */
+    onCardCreate?: (card: Omit<Card$1, 'id'>) => void | Promise<void>;
+    /** Called when a card is deleted */
+    onCardDelete?: (cardId: string) => void | Promise<void>;
+    /** Called when a new column is created */
+    onColumnCreate?: (column: Omit<Column$1, 'id' | 'cardIds'>) => void | Promise<void>;
+    /** Called when column properties are updated */
+    onColumnUpdate?: (columnId: string, updates: Partial<Column$1>) => void | Promise<void>;
+    /** Called when a column is deleted */
+    onColumnDelete?: (columnId: string) => void | Promise<void>;
+    /** Called when columns are reordered */
+    onColumnReorder?: (columnId: string, newPosition: number) => void | Promise<void>;
+    /** Called when WIP limit is exceeded (hard limit only) */
+    onWipLimitExceeded?: (column: Column$1, card: Card$1) => void;
 }
 /**
- * Grouping options for swimlanes
+ * Insight types generated by AI
  */
-type GroupByOption = 'none' | 'assignee' | 'priority' | 'label' | 'custom';
+type InsightType = 'RISK_DELAY' | 'RISK_OVERLOAD' | 'RISK_BLOCKER' | 'OPPORTUNITY' | 'SUGGESTION';
 /**
- * Swimlane configuration
+ * Severity levels for insights
  */
-interface SwimlaneConfig {
-    /** Grouping option */
-    groupBy: GroupByOption;
-    /** Custom field ID (when groupBy is 'custom') */
-    customFieldId?: string;
-    /** Show empty swimlanes */
-    showEmptyLanes?: boolean;
-    /** Collapsible swimlanes */
-    collapsible?: boolean;
-    /** Default collapsed state */
-    defaultCollapsed?: boolean;
-}
+type InsightSeverity = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
 /**
- * Swimlane (horizontal row grouping cards)
+ * AI-generated insight about the board state
  */
-interface Swimlane {
+interface Insight {
     /** Unique identifier */
-    id: string;
-    /** Swimlane title */
+    id?: string;
+    /** Type of insight */
+    type: InsightType;
+    /** Severity level */
+    severity: InsightSeverity;
+    /** Human-readable title */
     title: string;
-    /** Group value (user ID, priority, label, etc.) */
-    groupValue: any;
-    /** Card IDs in this swimlane */
-    cardIds: string[];
-    /** Is collapsed */
-    isCollapsed?: boolean;
-    /** Color for visual distinction */
-    color?: string;
-    /** Icon */
-    icon?: string;
+    /** Detailed description */
+    description: string;
+    /** AI confidence score (0-1) */
+    confidence: number;
+    /** Suggested action to take */
+    suggestedAction?: string;
+    /** Related card IDs */
+    relatedCardIds?: string[];
+    /** Related column IDs */
+    relatedColumnIds?: string[];
+    /** Timestamp */
+    timestamp?: Date | string;
 }
 /**
- * Keyboard shortcut action types
- * v0.5.0: Added single-key shortcuts for speed
- */
-type KeyboardAction = 'navigate_up' | 'navigate_down' | 'navigate_left' | 'navigate_right' | 'open_card' | 'close_modal' | 'select_all' | 'deselect_all' | 'new_card' | 'edit_card' | 'delete_card' | 'focus_search' | 'show_shortcuts' | 'new_card_modal' | 'search' | 'open_filters' | 'save' | 'undo' | 'redo' | 'quick_add' | 'delete_card_confirm';
-/**
- * Keyboard shortcut definition
+ * Result of AI assignee suggestion
  */
-interface KeyboardShortcut {
-    /** Shortcut key(s) */
-    keys: string | string[];
-    /** Action to perform */
-    action: KeyboardAction;
-    /** Description */
-    description: string;
-    /** Modifier keys required */
-    modifiers?: {
-        ctrl?: boolean;
-        shift?: boolean;
-        alt?: boolean;
-        meta?: boolean;
-    };
+interface AssigneeSuggestion {
+    /** Suggested user ID */
+    userId: string;
+    /** Confidence score (0-1) */
+    confidence: number;
+    /** Reasoning for suggestion */
+    reasoning: string;
 }
 /**
- * Card template for quick creation
+ * Result of AI plan generation
  */
-interface CardTemplate {
-    /** Unique identifier */
+interface GeneratedPlan {
+    /** Generated columns */
+    columns: Omit<Column$1, 'id'>[];
+    /** Generated cards */
+    cards: Omit<Card$1, 'id'>[];
+    /** Explanation of the plan */
+    explanation?: string;
+}
+/**
+ * AI callbacks (optional)
+ * Consumer provides these if they want AI features
+ */
+interface AICallbacks {
+    /** Generate a complete board plan from a text prompt */
+    onGeneratePlan?: (prompt: string) => Promise<GeneratedPlan>;
+    /** Suggest best assignee for a card */
+    onSuggestAssignee?: (card: Card$1) => Promise<AssigneeSuggestion>;
+    /** Predict risks and opportunities based on board state */
+    onPredictRisks?: (boardState: Board) => Promise<Insight[]>;
+    /** Generate subtasks for a card */
+    onGenerateSubtasks?: (card: Card$1) => Promise<Omit<Card$1, 'id'>[]>;
+    /** Estimate effort for a card */
+    onEstimateEffort?: (card: Card$1) => Promise<{
+        hours: number;
+        confidence: number;
+    }>;
+}
+/**
+ * Configuration options for the Kanban board
+ */
+interface BoardConfig {
+    /** Theme: 'dark' | 'light' | 'neutral' */
+    theme?: 'dark' | 'light' | 'neutral';
+    /** Locale for i18n */
+    locale?: 'en' | 'es' | string;
+    /** Enable virtualization (auto-enabled if >100 cards) */
+    enableVirtualization?: boolean;
+    /** Enable AI features */
+    enableAI?: boolean;
+    /** Animation duration in milliseconds */
+    animationDuration?: number;
+    /** Fixed column width in pixels */
+    columnWidth?: number;
+    /** Estimated card height for virtualization */
+    cardHeight?: number;
+    /** Enable keyboard shortcuts */
+    enableKeyboardShortcuts?: boolean;
+    /** Show card count in column headers */
+    showCardCount?: boolean;
+    /** Show WIP limits */
+    showWipLimits?: boolean;
+    /** Enable column collapsing */
+    enableCollapsible?: boolean;
+    /** Maximum cards to display per column before showing "show more" */
+    maxCardsPerColumn?: number;
+}
+/**
+ * Render props for customization
+ */
+interface RenderProps {
+    /** Custom card renderer */
+    renderCard?: (card: Card$1) => React.ReactNode;
+    /** Custom column renderer */
+    renderColumn?: (column: Column$1, cards: Card$1[]) => React.ReactNode;
+    /** Custom card overlay during drag */
+    renderCardOverlay?: (card: Card$1) => React.ReactNode;
+    /** Custom column header */
+    renderColumnHeader?: (column: Column$1, cardCount: number) => React.ReactNode;
+    /** Custom empty state */
+    renderEmptyState?: (column: Column$1) => React.ReactNode;
+}
+/**
+ * User entity for assignment
+ */
+interface User$1 {
     id: string;
-    /** Template name */
     name: string;
-    /** Template description */
-    description?: string;
-    /** Icon or emoji */
-    icon?: string;
-    /** Pre-filled card data */
-    template: Partial<Omit<Card$1, 'id' | 'position' | 'columnId'>>;
-    /** Category for organization */
-    category?: string;
+    initials: string;
+    color: string;
+    avatar?: string;
 }
 /**
- * Export format options
+ * Main KanbanBoard component props
  */
-type ExportFormat = 'json' | 'csv' | 'pdf';
+interface KanbanBoardProps {
+    /** Board data (controlled) */
+    board: Board;
+    /** Callbacks for mutations */
+    callbacks: BoardCallbacks;
+    /** AI callbacks (optional) */
+    aiCallbacks?: AICallbacks;
+    /** Card click handler */
+    onCardClick?: (card: Card$1) => void;
+    /** Render customization */
+    renderProps?: RenderProps;
+    /** Configuration */
+    config?: BoardConfig;
+    /** Available users for assignment */
+    availableUsers?: User$1[];
+    /** Custom CSS class */
+    className?: string;
+    /** Custom inline styles */
+    style?: React.CSSProperties;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Error state */
+    error?: Error | string;
+}
 /**
- * Export options
+ * Drag event data
  */
-interface ExportOptions {
-    /** Format to export */
-    format: ExportFormat;
-    /** Include card details */
-    includeCardDetails?: boolean;
-    /** Include comments */
-    includeComments?: boolean;
-    /** Include activity log */
-    includeActivity?: boolean;
-    /** Include attachments */
-    includeAttachments?: boolean;
-    /** Date range filter */
+interface DragData {
+    /** Card being dragged */
+    card: Card$1;
+    /** Source column ID */
+    sourceColumnId: string;
+    /** Source position */
+    sourcePosition: number;
+}
+/**
+ * Drop event data
+ */
+interface DropData {
+    /** Card being dropped */
+    card: Card$1;
+    /** Target column ID */
+    targetColumnId: string;
+    /** Target position */
+    targetPosition: number;
+    /** Source column ID */
+    sourceColumnId: string;
+}
+/**
+ * Filter criteria for cards
+ */
+interface CardFilter {
+    /** Filter by assignee */
+    assigneeIds?: string[];
+    /** Filter by priority */
+    priorities?: Priority[];
+    /** Filter by labels */
+    labels?: string[];
+    /** Search in title/description */
+    search?: string;
+    /** Filter by date range */
     dateRange?: {
         start: Date | string;
         end: Date | string;
     };
 }
 /**
- * Import result
+ * Sort options for cards
  */
-interface ImportResult {
-    /** Was import successful */
-    success: boolean;
-    /** Number of cards imported */
-    cardsImported?: number;
-    /** Number of columns imported */
-    columnsImported?: number;
-    /** Errors encountered */
-    errors?: string[];
-    /** Warnings */
-    warnings?: string[];
+type CardSortKey = 'position' | 'priority' | 'dueDate' | 'createdAt' | 'title';
+interface CardSort {
+    key: CardSortKey;
+    direction: 'asc' | 'desc';
 }
-
 /**
- * KanbanViewAdapter - ViewAdapter implementation for Kanban board
- * @module views/KanbanViewAdapter
- *
- * Implements the ViewAdapter interface from @libxai/core to enable
- * the Kanban board to work with AsakaaRuntime and ViewRegistry.
+ * Comment on a card
  */
-
+interface Comment {
+    /** Unique identifier */
+    id: string;
+    /** Card ID */
+    cardId: string;
+    /** Author user ID */
+    authorId: string;
+    /** Comment content */
+    content: string;
+    /** Timestamp */
+    createdAt: Date | string;
+    /** Last update timestamp */
+    updatedAt?: Date | string;
+    /** Mentions (user IDs) */
+    mentions?: string[];
+}
 /**
- * Kanban view configuration
+ * Activity log entry types
  */
-interface KanbanViewConfig {
-    /**
-     * Board callbacks
-     */
-    callbacks?: KanbanBoardProps['callbacks'];
-    /**
-     * Card click handler
-     */
-    onCardClick?: KanbanBoardProps['onCardClick'];
-    /**
-     * Custom render props
-     */
-    renderProps?: KanbanBoardProps['renderProps'];
-    /**
-     * Board configuration
-     */
-    config?: KanbanBoardProps['config'];
-    /**
-     * Available users for assignment
-     */
-    availableUsers?: KanbanBoardProps['availableUsers'];
-    /**
-     * Custom class name
-     */
-    className?: string;
-    /**
-     * Custom inline styles (React.CSSProperties)
-     */
-    style?: React.CSSProperties;
-    /**
-     * View options
-     */
-    viewOptions?: ViewOptions;
-}
+type ActivityType = 'CARD_CREATED' | 'CARD_UPDATED' | 'CARD_MOVED' | 'CARD_DELETED' | 'COMMENT_ADDED' | 'USER_ASSIGNED' | 'USER_UNASSIGNED' | 'PRIORITY_CHANGED' | 'DUE_DATE_CHANGED' | 'LABEL_ADDED' | 'LABEL_REMOVED' | 'DEPENDENCY_ADDED' | 'DEPENDENCY_REMOVED' | 'ATTACHMENT_ADDED' | 'ATTACHMENT_REMOVED';
 /**
- * KanbanViewAdapter
- *
- * React-based ViewAdapter implementation that wraps the KanbanBoard component.
- * This allows the Kanban board to be used as a view in the ViewRegistry and
- * work seamlessly with AsakaaRuntime.
- *
- * @example
- * ```typescript
- * import { KanbanViewAdapter } from '@libxai/board'
- * import { ViewRegistry } from '@libxai/core'
- *
- * const registry = new ViewRegistry()
- * const kanbanView = new KanbanViewAdapter({
- *   callbacks: {
- *     onCardMove: (cardId, columnId) => { ... },
- *     onCardUpdate: (cardId, updates) => { ... }
+ * Activity log entry
+ */
+interface Activity {
+    /** Unique identifier */
+    id: string;
+    /** Activity type */
+    type: ActivityType;
+    /** Card ID */
+    cardId: string;
+    /** User who performed the action */
+    userId: string;
+    /** Timestamp */
+    timestamp: Date | string;
+    /** Previous value (for updates) */
+    previousValue?: any;
+    /** New value (for updates) */
+    newValue?: any;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * File attachment on a card
+ */
+interface Attachment {
+    /** Unique identifier */
+    id: string;
+    /** Card ID */
+    cardId: string;
+    /** File name */
+    name: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    type: string;
+    /** File URL or data URI */
+    url: string;
+    /** Upload timestamp */
+    uploadedAt: Date | string;
+    /** User who uploaded */
+    uploadedBy: string;
+    /** Thumbnail URL (for images) */
+    thumbnailUrl?: string;
+}
+/**
+ * Bulk operations callbacks
+ */
+interface BulkOperationsCallbacks {
+    /** Called when bulk update is performed */
+    onBulkUpdate?: (cardIds: string[], updates: Partial<Card$1>) => void | Promise<void>;
+    /** Called when bulk delete is performed */
+    onBulkDelete?: (cardIds: string[]) => void | Promise<void>;
+    /** Called when bulk move is performed */
+    onBulkMove?: (cardIds: string[], targetColumnId: string) => void | Promise<void>;
+}
+/**
+ * Grouping options for swimlanes
+ */
+type GroupByOption = 'none' | 'assignee' | 'priority' | 'label' | 'custom';
+/**
+ * Swimlane configuration
+ */
+interface SwimlaneConfig {
+    /** Grouping option */
+    groupBy: GroupByOption;
+    /** Custom field ID (when groupBy is 'custom') */
+    customFieldId?: string;
+    /** Show empty swimlanes */
+    showEmptyLanes?: boolean;
+    /** Collapsible swimlanes */
+    collapsible?: boolean;
+    /** Default collapsed state */
+    defaultCollapsed?: boolean;
+}
+/**
+ * Swimlane (horizontal row grouping cards)
+ */
+interface Swimlane {
+    /** Unique identifier */
+    id: string;
+    /** Swimlane title */
+    title: string;
+    /** Group value (user ID, priority, label, etc.) */
+    groupValue: any;
+    /** Card IDs in this swimlane */
+    cardIds: string[];
+    /** Is collapsed */
+    isCollapsed?: boolean;
+    /** Color for visual distinction */
+    color?: string;
+    /** Icon */
+    icon?: string;
+}
+/**
+ * Keyboard shortcut action types
+ * v0.5.0: Added single-key shortcuts for speed
+ */
+type KeyboardAction = 'navigate_up' | 'navigate_down' | 'navigate_left' | 'navigate_right' | 'open_card' | 'close_modal' | 'select_all' | 'deselect_all' | 'new_card' | 'edit_card' | 'delete_card' | 'focus_search' | 'show_shortcuts' | 'new_card_modal' | 'search' | 'open_filters' | 'save' | 'undo' | 'redo' | 'quick_add' | 'delete_card_confirm';
+/**
+ * Keyboard shortcut definition
+ */
+interface KeyboardShortcut {
+    /** Shortcut key(s) */
+    keys: string | string[];
+    /** Action to perform */
+    action: KeyboardAction;
+    /** Description */
+    description: string;
+    /** Modifier keys required */
+    modifiers?: {
+        ctrl?: boolean;
+        shift?: boolean;
+        alt?: boolean;
+        meta?: boolean;
+    };
+}
+/**
+ * Card template for quick creation
+ */
+interface CardTemplate {
+    /** Unique identifier */
+    id: string;
+    /** Template name */
+    name: string;
+    /** Template description */
+    description?: string;
+    /** Icon or emoji */
+    icon?: string;
+    /** Pre-filled card data */
+    template: Partial<Omit<Card$1, 'id' | 'position' | 'columnId'>>;
+    /** Category for organization */
+    category?: string;
+}
+/**
+ * Export format options
+ */
+type ExportFormat = 'json' | 'csv' | 'pdf';
+/**
+ * Export options
+ */
+interface ExportOptions {
+    /** Format to export */
+    format: ExportFormat;
+    /** Include card details */
+    includeCardDetails?: boolean;
+    /** Include comments */
+    includeComments?: boolean;
+    /** Include activity log */
+    includeActivity?: boolean;
+    /** Include attachments */
+    includeAttachments?: boolean;
+    /** Date range filter */
+    dateRange?: {
+        start: Date | string;
+        end: Date | string;
+    };
+}
+/**
+ * Import result
+ */
+interface ImportResult {
+    /** Was import successful */
+    success: boolean;
+    /** Number of cards imported */
+    cardsImported?: number;
+    /** Number of columns imported */
+    columnsImported?: number;
+    /** Errors encountered */
+    errors?: string[];
+    /** Warnings */
+    warnings?: string[];
+}
+
+/**
+ * KanbanViewAdapter - ViewAdapter implementation for Kanban board
+ * @module views/KanbanViewAdapter
+ *
+ * Implements the ViewAdapter interface from @libxai/core to enable
+ * the Kanban board to work with AsakaaRuntime and ViewRegistry.
+ */
+
+/**
+ * Kanban view configuration
+ */
+interface KanbanViewConfig {
+    /**
+     * Board callbacks
+     */
+    callbacks?: KanbanBoardProps['callbacks'];
+    /**
+     * Card click handler
+     */
+    onCardClick?: KanbanBoardProps['onCardClick'];
+    /**
+     * Custom render props
+     */
+    renderProps?: KanbanBoardProps['renderProps'];
+    /**
+     * Board configuration
+     */
+    config?: KanbanBoardProps['config'];
+    /**
+     * Available users for assignment
+     */
+    availableUsers?: KanbanBoardProps['availableUsers'];
+    /**
+     * Custom class name
+     */
+    className?: string;
+    /**
+     * Custom inline styles (React.CSSProperties)
+     */
+    style?: React.CSSProperties;
+    /**
+     * View options
+     */
+    viewOptions?: ViewOptions;
+}
+/**
+ * KanbanViewAdapter
+ *
+ * React-based ViewAdapter implementation that wraps the KanbanBoard component.
+ * This allows the Kanban board to be used as a view in the ViewRegistry and
+ * work seamlessly with AsakaaRuntime.
+ *
+ * @example
+ * ```typescript
+ * import { KanbanViewAdapter } from '@libxai/board'
+ * import { ViewRegistry } from '@libxai/core'
+ *
+ * const registry = new ViewRegistry()
+ * const kanbanView = new KanbanViewAdapter({
+ *   callbacks: {
+ *     onCardMove: (cardId, columnId) => { ... },
+ *     onCardUpdate: (cardId, updates) => { ... }
  *   }
  * })
  *
@@ -1171,8 +1567,12 @@ interface CardDetailModalV2Props {
         id: string;
         title: string;
     }>;
-    /** Available labels */
+    /** Available labels (legacy - use availableTags for colored tags) */
     availableLabels?: string[];
+    /** v0.17.158: Available tags with colors (ClickUp-style) */
+    availableTags?: TaskTag[];
+    /** v0.17.158: Callback to create a new tag */
+    onCreateTag?: (name: string, color: string) => Promise<TaskTag | null>;
     /** Upload cover image callback (optional - returns public URL) */
     onUploadCoverImage?: (file: File) => Promise<string>;
     /** Unsplash API key for cover images (optional) */
@@ -1182,7 +1582,7 @@ interface CardDetailModalV2Props {
     /** Callback when subtasks are changed (for persistence) */
     onSubtasksChange?: (cardId: string, subtasks: Subtask[]) => void;
 }
-declare function CardDetailModalV2({ card, isOpen, onClose, onUpdate, onDelete: _onDelete, availableUsers, comments, activities, onAddComment, onDeleteComment: _onDeleteComment, currentUser, onAIGenerateDescription: _onAIGenerateDescription, onAICreateSubtasks: _onAICreateSubtasks, onAIFindSimilar: _onAIFindSimilar, availableColumns, availableLabels, onUploadCoverImage: _onUploadCoverImage, unsplashAccessKey: _unsplashAccessKey, theme, onSubtasksChange, }: CardDetailModalV2Props): react_jsx_runtime.JSX.Element | null;
+declare function CardDetailModalV2({ card, isOpen, onClose, onUpdate, onDelete: _onDelete, availableUsers, comments, activities, onAddComment, onDeleteComment: _onDeleteComment, currentUser, onAIGenerateDescription: _onAIGenerateDescription, onAICreateSubtasks: _onAICreateSubtasks, onAIFindSimilar: _onAIFindSimilar, availableColumns, availableLabels, availableTags, onCreateTag, onUploadCoverImage: _onUploadCoverImage, unsplashAccessKey: _unsplashAccessKey, theme, onSubtasksChange, }: CardDetailModalV2Props): react_jsx_runtime.JSX.Element | null;
 
 interface AttachmentUploaderProps {
     /** Card ID for attachments */
@@ -1353,508 +1753,124 @@ interface CardTemplateSelectorProps {
     className?: string;
 }
 /**
- * Default card templates
- */
-declare const DEFAULT_TEMPLATES: CardTemplate[];
-/**
- * CardTemplateSelector Component
- */
-declare function CardTemplateSelector({ templates, onSelectTemplate, className, }: CardTemplateSelectorProps): react_jsx_runtime.JSX.Element;
-
-interface ExportImportModalProps {
-    /** Board data to export */
-    board: Board;
-    /** Is modal open */
-    isOpen: boolean;
-    /** Close handler */
-    onClose: () => void;
-    /** Import handler */
-    onImport?: (result: ImportResult, content: string) => void;
-    /** Board element ref for PDF export */
-    boardElementRef?: React.RefObject<HTMLElement>;
-    /** Custom className */
-    className?: string;
-}
-/**
- * ExportImportModal Component
- */
-declare function ExportImportModal({ board, isOpen, onClose, onImport, boardElementRef, className, }: ExportImportModalProps): react_jsx_runtime.JSX.Element | null;
-
-type DateFilter = 'all' | 'overdue' | 'today' | 'this-week' | 'custom';
-type SortBy = 'created' | 'priority' | 'dueDate' | 'title' | 'estimate' | 'none';
-type SortOrder = 'asc' | 'desc';
-interface FilterState {
-    dateFilter: DateFilter;
-    dateRange?: {
-        start: Date;
-        end: Date;
-    };
-    priorities: Priority[];
-    assignees: string[];
-    labels: string[];
-    columns: string[];
-    search: string;
-}
-interface SortState {
-    by: SortBy;
-    order: SortOrder;
-}
-interface UseFiltersOptions {
-    initialFilters?: Partial<FilterState>;
-    initialSort?: Partial<SortState>;
-    currentUserId?: string;
-}
-interface UseFiltersReturn {
-    filters: FilterState;
-    sort: SortState;
-    setFilters: (filters: Partial<FilterState>) => void;
-    setSort: (sort: Partial<SortState>) => void;
-    resetFilters: () => void;
-    filterMyTasks: () => void;
-    filterOverdue: () => void;
-    filterHighPriority: () => void;
-    applyFilters: (cards: Card$1[]) => Card$1[];
-    hasActiveFilters: boolean;
-}
-/**
- * Hook for filtering and sorting board cards
- *
- * @example
- * ```tsx
- * const { filters, setFilters, applyFilters, filterMyTasks } = useFilters({
- *   currentUserId: 'user-1'
- * })
- *
- * const filteredCards = applyFilters(board.cards)
- * ```
- */
-declare function useFilters({ initialFilters, initialSort, currentUserId, }?: UseFiltersOptions): UseFiltersReturn;
-
-interface FilterBarProps {
-    filters: FilterState;
-    sort: SortState;
-    onFiltersChange: (filters: Partial<FilterState>) => void;
-    onSortChange: (sort: Partial<SortState>) => void;
-    onReset: () => void;
-    onFilterMyTasks?: () => void;
-    onFilterOverdue?: () => void;
-    onFilterHighPriority?: () => void;
-    availableUsers?: User$1[];
-    availableLabels?: string[];
-    availableColumns?: Array<{
-        id: string;
-        title: string;
-    }>;
-    showQuickFilters?: boolean;
-    compact?: boolean;
-    groupBy?: GroupByOption;
-    onGroupByChange?: (value: GroupByOption) => void;
-}
-declare function FilterBar({ filters, sort, onFiltersChange, onSortChange, onReset, onFilterMyTasks, onFilterOverdue, onFilterHighPriority, availableUsers, availableLabels, availableColumns: _availableColumns, showQuickFilters, compact, groupBy, onGroupByChange, }: FilterBarProps): react_jsx_runtime.JSX.Element;
-
-interface ConfigMenuProps {
-    onOpenExport: () => void;
-    onOpenThemes: () => void;
-    onOpenShortcuts: () => void;
-    className?: string;
-    viewMode?: 'kanban' | 'gantt';
-    onExportGanttPDF?: () => Promise<void>;
-    onExportGanttExcel?: () => Promise<void>;
-    onExportGanttPNG?: () => Promise<void>;
-    onExportGanttCSV?: () => void;
-}
-declare function ConfigMenu({ onOpenExport, onOpenThemes, onOpenShortcuts, className, viewMode, onExportGanttPDF, onExportGanttExcel, onExportGanttPNG, onExportGanttCSV, }: ConfigMenuProps): react_jsx_runtime.JSX.Element;
-
-interface ThemeModalProps {
-    isOpen: boolean;
-    onClose: () => void;
-    className?: string;
-}
-declare function ThemeModal({ isOpen, onClose, className }: ThemeModalProps): react_jsx_runtime.JSX.Element | null;
-
-interface TaskSegment {
-    startDate: Date;
-    endDate: Date;
-}
-interface Task {
-    id: string;
-    name: string;
-    startDate?: Date;
-    endDate?: Date;
-    progress: number;
-    assignees?: Array<{
-        name: string;
-        avatar?: string;
-        initials: string;
-        color: string;
-    }>;
-    status?: string;
-    dependencies?: string[];
-    subtasks?: Task[];
-    isExpanded?: boolean;
-    isMilestone?: boolean;
-    isCriticalPath?: boolean;
-    color?: string;
-    priority?: 'low' | 'medium' | 'high' | 'urgent';
-    segments?: TaskSegment[];
-    parentId?: string;
-    level?: number;
-    position?: number;
-}
-type TimeScale = 'day' | 'week' | 'month';
-type Theme$1 = 'dark' | 'light' | 'neutral';
-type RowDensity = 'compact' | 'comfortable' | 'spacious';
-type ColumnType = 'name' | 'startDate' | 'endDate' | 'duration' | 'assignees' | 'status' | 'progress' | 'priority';
-interface GanttColumn {
-    id: ColumnType;
-    label: string;
-    width: number;
-    minWidth?: number;
-    maxWidth?: number;
-    visible: boolean;
-    sortable?: boolean;
-    resizable?: boolean;
-}
-interface Assignee {
-    name: string;
-    initials: string;
-    color: string;
-}
-interface GanttTheme {
-    bgPrimary: string;
-    bgSecondary: string;
-    bgGrid: string;
-    bgWeekend: string;
-    border: string;
-    borderLight: string;
-    textPrimary: string;
-    textSecondary: string;
-    textTertiary: string;
-    accent: string;
-    accentHover: string;
-    accentLight: string;
-    taskBarPrimary: string;
-    taskBarProgress: string;
-    taskBarHandle: string;
-    dependency: string;
-    dependencyHover: string;
-    criticalPath: string;
-    criticalPathLight: string;
-    today: string;
-    todayLight: string;
-    milestone: string;
-    milestoneLight: string;
-    statusTodo: string;
-    statusInProgress: string;
-    statusCompleted: string;
-    hoverBg: string;
-    focusRing: string;
-}
-/**
- * Templates for customizing Gantt rendering
- * Similar to DHTMLX gantt.templates.*
- */
-interface GanttTemplates {
-    /**
-     * Customize task tooltip content
-     * @param task - The task to render tooltip for
-     * @returns Tooltip content (string or JSX)
-     */
-    taskTooltip?: (task: Task) => string | React.ReactNode;
-    /**
-     * Customize task label in timeline
-     * @param task - The task to render label for
-     * @returns Label content (string or JSX)
-     */
-    taskLabel?: (task: Task) => string | React.ReactNode;
-    /**
-     * Customize grid cell content
-     * @param task - The task for this row
-     * @param column - The column type
-     * @param value - Default cell value
-     * @returns Cell content (string or JSX)
-     */
-    gridCell?: (task: Task, column: ColumnType, value: any) => string | React.ReactNode;
-    /**
-     * Add custom CSS classes to task bar
-     * @param task - The task to style
-     * @returns Space-separated CSS class names
-     */
-    taskClass?: (task: Task) => string;
-    /**
-     * Customize milestone rendering
-     * @param task - The milestone task
-     * @returns Milestone content (string or JSX)
-     */
-    milestoneContent?: (task: Task) => string | React.ReactNode;
-    /**
-     * Format date display
-     * @param date - Date to format
-     * @returns Formatted date string
-     */
-    dateFormat?: (date: Date) => string;
-    /**
-     * Format duration display
-     * @param days - Duration in days
-     * @returns Formatted duration string
-     */
-    durationFormat?: (days: number) => string;
-    /**
-     * Format progress display
-     * @param progress - Progress percentage (0-100)
-     * @returns Formatted progress string
-     */
-    progressFormat?: (progress: number) => string;
-}
-/**
- * Permissions interface for controlling Gantt operations
- * Useful for integrating with authorization libraries like CASL
- * @example
- *
- * // With CASL integration
- * const ability = useAbility();
- *
- * <GanttBoard
- *   tasks={tasks}
- *   config={{
- *     permissions: {
- *       canCreateTask: ability.can('create', 'Task'),
- *       canUpdateTask: ability.can('update', 'Task'),
- *       canDeleteTask: ability.can('delete', 'Task'),
- *       canCreateDependency: ability.can('create', 'Dependency'),
- *       canUpdateProgress: ability.can('update', 'TaskProgress'),
- *     }
- *   }}
- * />
- *
- */
-interface GanttPermissions {
-    canCreateTask?: boolean;
-    canUpdateTask?: boolean;
-    canDeleteTask?: boolean;
-    canCreateDependency?: boolean;
-    canDeleteDependency?: boolean;
-    canUpdateProgress?: boolean;
-    canAssignUsers?: boolean;
-    canModifyHierarchy?: boolean;
-    canDuplicateTask?: boolean;
-    canReorderTasks?: boolean;
-    canExport?: boolean;
-    canToggleExpansion?: boolean;
-    canPerformAction?: (task: Task, action: 'create' | 'update' | 'delete' | 'assign' | 'progress') => boolean;
-}
-/**
- * Scroll behavior configuration for timeline interactions
- * Controls how the Gantt chart viewport behaves during user interactions
- *
- * @example
- * // Disable all automatic scrolling during drag operations
- * <GanttBoard
- *   config={{
- *     scrollBehavior: {
- *       preventAutoScroll: true,
- *       axis: 'horizontal'
- *     }
- *   }}
- * />
- *
- * @example
- * // Allow vertical auto-scroll but prevent horizontal
- * <GanttBoard
- *   config={{
- *     scrollBehavior: {
- *       preventAutoScroll: true,
- *       axis: 'horizontal',
- *       onScrollPrevented: (axis, scrollDelta) => {
- *         console.log(`Prevented ${axis} scroll by ${scrollDelta}px`);
- *       }
- *     }
- *   }}
- * />
- */
-interface GanttScrollBehavior {
-    /**
-     * Prevent automatic viewport scrolling during drag operations
-     * When true, the viewport will not automatically center on dragged tasks
-     * Users can still manually scroll using scrollbars or mouse wheel
-     * @default false
-     */
-    preventAutoScroll?: boolean;
-    /**
-     * Which axis to prevent auto-scroll on
-     * - 'horizontal': Only prevent horizontal auto-scroll (recommended for Gantt charts)
-     * - 'vertical': Only prevent vertical auto-scroll
-     * - 'both': Prevent both horizontal and vertical auto-scroll
-     * @default 'horizontal'
-     */
-    axis?: 'horizontal' | 'vertical' | 'both';
-    /**
-     * Callback fired when auto-scroll is prevented
-     * Useful for debugging or showing user feedback
-     * @param axis - Which axis was prevented ('x' or 'y')
-     * @param scrollDelta - How many pixels of scroll were prevented
-     */
-    onScrollPrevented?: (axis: 'x' | 'y', scrollDelta: number) => void;
-    /**
-     * Allow auto-scroll if task would go out of viewport bounds
-     * When true, auto-scroll is only prevented if task remains visible
-     * @default false
-     */
-    allowScrollWhenOutOfBounds?: boolean;
-}
-/**
- * AI chat message interface
- * @version 0.17.42
+ * Default card templates
  */
-interface AIMessage {
-    id: string;
-    role: 'user' | 'assistant';
-    content: string;
-    timestamp: Date;
-    command?: AICommandResult;
-    isLoading?: boolean;
-}
+declare const DEFAULT_TEMPLATES: CardTemplate[];
 /**
- * Configuration for persisting AI chat history in localStorage
- * @version 0.17.42
+ * CardTemplateSelector Component
  */
-interface PersistHistoryConfig {
-    /** Enable history persistence in localStorage */
-    enabled: boolean;
-    /** Maximum messages to persist (default: 5) */
-    maxMessages?: number;
-    /** Custom storage key (default: 'gantt-ai-history') */
-    storageKey?: string;
+declare function CardTemplateSelector({ templates, onSelectTemplate, className, }: CardTemplateSelectorProps): react_jsx_runtime.JSX.Element;
+
+interface ExportImportModalProps {
+    /** Board data to export */
+    board: Board;
+    /** Is modal open */
+    isOpen: boolean;
+    /** Close handler */
+    onClose: () => void;
+    /** Import handler */
+    onImport?: (result: ImportResult, content: string) => void;
+    /** Board element ref for PDF export */
+    boardElementRef?: React.RefObject<HTMLElement>;
+    /** Custom className */
+    className?: string;
 }
 /**
- * AI Assistant configuration for natural language task editing
- * @version 0.14.0
- * @updated 0.17.42 - Added persistHistory option
+ * ExportImportModal Component
  */
-interface GanttAIAssistantConfig {
-    /** Enable AI assistant (default: false) */
-    enabled?: boolean;
-    /** Custom placeholder text */
-    placeholder?: string;
-    /** Position of the chat button */
-    position?: 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
-    /** Handler for AI commands - should return task updates */
-    onCommand?: (command: string, tasks: Task[]) => Promise<AICommandResult>;
-    /** Custom suggestions for the command palette */
-    suggestions?: string[];
-    /** Maximum messages to keep in memory history */
-    maxHistory?: number;
-    /** Persist chat history in localStorage @version 0.17.42 */
-    persistHistory?: PersistHistoryConfig;
+declare function ExportImportModal({ board, isOpen, onClose, onImport, boardElementRef, className, }: ExportImportModalProps): react_jsx_runtime.JSX.Element | null;
+
+type DateFilter = 'all' | 'overdue' | 'today' | 'this-week' | 'custom';
+type SortBy = 'created' | 'priority' | 'dueDate' | 'title' | 'estimate' | 'none';
+type SortOrder = 'asc' | 'desc';
+interface FilterState {
+    dateFilter: DateFilter;
+    dateRange?: {
+        start: Date;
+        end: Date;
+    };
+    priorities: Priority[];
+    assignees: string[];
+    labels: string[];
+    columns: string[];
+    search: string;
+}
+interface SortState {
+    by: SortBy;
+    order: SortOrder;
+}
+interface UseFiltersOptions {
+    initialFilters?: Partial<FilterState>;
+    initialSort?: Partial<SortState>;
+    currentUserId?: string;
+}
+interface UseFiltersReturn {
+    filters: FilterState;
+    sort: SortState;
+    setFilters: (filters: Partial<FilterState>) => void;
+    setSort: (sort: Partial<SortState>) => void;
+    resetFilters: () => void;
+    filterMyTasks: () => void;
+    filterOverdue: () => void;
+    filterHighPriority: () => void;
+    applyFilters: (cards: Card$1[]) => Card$1[];
+    hasActiveFilters: boolean;
 }
 /**
- * AI Command result interface
- * @version 0.14.0
+ * Hook for filtering and sorting board cards
+ *
+ * @example
+ * ```tsx
+ * const { filters, setFilters, applyFilters, filterMyTasks } = useFilters({
+ *   currentUserId: 'user-1'
+ * })
+ *
+ * const filteredCards = applyFilters(board.cards)
+ * ```
  */
-interface AICommandResult {
-    type: 'move_task' | 'resize_task' | 'rename_task' | 'delete_task' | 'create_task' | 'link_tasks' | 'unlink_tasks' | 'assign_task' | 'set_progress' | 'set_status' | 'split_task' | 'group_tasks' | 'unknown';
-    taskId?: string;
-    taskName?: string;
-    updates?: Partial<Task>;
-    newTask?: Task;
-    dependencyFrom?: string;
-    dependencyTo?: string;
-    message: string;
-    success: boolean;
-    error?: string;
-}
-interface GanttConfig {
-    theme?: Theme$1;
-    timeScale?: TimeScale;
-    rowDensity?: RowDensity;
-    showThemeSelector?: boolean;
-    showExportButton?: boolean;
-    availableUsers?: Array<{
+declare function useFilters({ initialFilters, initialSort, currentUserId, }?: UseFiltersOptions): UseFiltersReturn;
+
+interface FilterBarProps {
+    filters: FilterState;
+    sort: SortState;
+    onFiltersChange: (filters: Partial<FilterState>) => void;
+    onSortChange: (sort: Partial<SortState>) => void;
+    onReset: () => void;
+    onFilterMyTasks?: () => void;
+    onFilterOverdue?: () => void;
+    onFilterHighPriority?: () => void;
+    availableUsers?: User$1[];
+    availableLabels?: string[];
+    availableColumns?: Array<{
         id: string;
-        name: string;
-        initials: string;
-        color: string;
+        title: string;
     }>;
-    /**
-     * v0.15.0: Internationalization (i18n) support
-     * Set the locale for all UI text in the Gantt chart
-     * Built-in support for 'en' (English) and 'es' (Spanish)
-     * @default 'en'
-     */
-    locale?: 'en' | 'es' | string;
-    /**
-     * v0.15.0: Custom translations to override default locale strings
-     * Allows partial overrides while keeping defaults for missing keys
-     * @see GanttTranslations in i18n.ts
-     */
-    customTranslations?: Record<string, any>;
-    aiAssistant?: GanttAIAssistantConfig;
-    showCreateTaskButton?: boolean;
-    createTaskLabel?: string;
-    onCreateTask?: () => void;
-    templates?: GanttTemplates;
-    permissions?: GanttPermissions;
-    disableScrollSync?: boolean;
-    /**
-     * v0.9.2: Advanced scroll behavior configuration
-     * Controls how the timeline viewport behaves during drag operations
-     * Provides fine-grained control over auto-scroll prevention with events
-     * @see GanttScrollBehavior
-     */
-    scrollBehavior?: GanttScrollBehavior;
-    /**
-     * v0.11.1: Enable automatic Critical Path Method (CPM) calculation
-     * When true (default), tasks with zero slack are automatically marked as critical (red)
-     * When false, preserves custom task colors and disables automatic CPM marking
-     * @default true
-     */
-    enableAutoCriticalPath?: boolean;
-    onThemeChange?: (theme: Theme$1) => void;
-    onTaskClick?: (task: Task) => void;
-    onTaskDblClick?: (task: Task) => void;
-    onTaskContextMenu?: (task: Task, event: React.MouseEvent) => void;
-    onTaskUpdate?: (task: Task) => void;
-    onTaskDateChange?: (task: Task, startDate: Date, endDate: Date) => void;
-    onProgressChange?: (taskId: string, oldProgress: number, newProgress: number) => void;
-    /**
-     * Called when user clicks "Edit Task" in context menu
-     * If not provided, the built-in TaskFormModal will be used
-     */
-    onTaskEdit?: (task: Task) => void;
-    /**
-     * Called when user clicks "Add Subtask" in context menu
-     * If not provided, the built-in subtask creation will be used
-     */
-    onTaskAddSubtask?: (parentTask: Task) => void;
-    /**
-     * Called when user clicks "Mark Incomplete" in context menu
-     * Sets task status to 'todo' and progress to 0
-     */
-    onTaskMarkIncomplete?: (task: Task) => void;
-    /**
-     * Called when user clicks "Set In Progress" in context menu
-     * Sets task status to 'in-progress'
-     */
-    onTaskSetInProgress?: (task: Task) => void;
-    onDependencyCreate?: (fromTaskId: string, toTaskId: string) => void;
-    onDependencyDelete?: (taskId: string, dependencyId: string) => void;
-    onBeforeTaskAdd?: (task: Task) => boolean | void | Promise<boolean | void>;
-    onAfterTaskAdd?: (task: Task) => void;
-    onBeforeTaskUpdate?: (taskId: string, newData: Partial<Task>) => boolean | void | Promise<boolean | void>;
-    onAfterTaskUpdate?: (task: Task) => void;
-    onBeforeTaskDelete?: (taskId: string) => boolean | void | Promise<boolean | void>;
-    onAfterTaskDelete?: (taskId: string) => void;
-    onTaskCreate?: (parentId: string | undefined, position: number) => void;
-    onTaskDelete?: (taskId: string) => void;
-    onMultiTaskDelete?: (taskIds: string[]) => void;
-    onTaskDuplicate?: (taskId: string) => void;
-    onTaskMove?: (taskId: string, direction: 'up' | 'down') => void;
-    onTaskIndent?: (taskId: string) => void;
-    onTaskOutdent?: (taskId: string) => void;
-    onTaskRename?: (taskId: string, newName: string) => void;
-    onTaskToggleExpand?: (taskId: string) => void;
-    onTaskReparent?: (taskId: string, newParentId: string | null, position?: number) => void;
+    showQuickFilters?: boolean;
+    compact?: boolean;
+    groupBy?: GroupByOption;
+    onGroupByChange?: (value: GroupByOption) => void;
+}
+declare function FilterBar({ filters, sort, onFiltersChange, onSortChange, onReset, onFilterMyTasks, onFilterOverdue, onFilterHighPriority, availableUsers, availableLabels, availableColumns: _availableColumns, showQuickFilters, compact, groupBy, onGroupByChange, }: FilterBarProps): react_jsx_runtime.JSX.Element;
+
+interface ConfigMenuProps {
+    onOpenExport: () => void;
+    onOpenThemes: () => void;
+    onOpenShortcuts: () => void;
+    className?: string;
+    viewMode?: 'kanban' | 'gantt';
+    onExportGanttPDF?: () => Promise<void>;
+    onExportGanttExcel?: () => Promise<void>;
+    onExportGanttPNG?: () => Promise<void>;
+    onExportGanttCSV?: () => void;
+}
+declare function ConfigMenu({ onOpenExport, onOpenThemes, onOpenShortcuts, className, viewMode, onExportGanttPDF, onExportGanttExcel, onExportGanttPNG, onExportGanttCSV, }: ConfigMenuProps): react_jsx_runtime.JSX.Element;
+
+interface ThemeModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    className?: string;
 }
+declare function ThemeModal({ isOpen, onClose, className }: ThemeModalProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * GanttBoardRef - Imperative API for GanttBoard component
@@ -2260,6 +2276,7 @@ interface TaskFormData {
         color: string;
     }>;
     dependencies?: string[];
+    tags?: TaskTag[];
 }
 interface TaskFormModalProps {
     isOpen: boolean;
@@ -2276,8 +2293,10 @@ interface TaskFormModalProps {
     mode?: 'create' | 'edit';
     theme?: Theme$1;
     customStatuses?: CustomStatus[];
+    availableTags?: TaskTag[];
+    onCreateTag?: (name: string, color: string) => Promise<TaskTag | null>;
 }
-declare function TaskFormModal({ isOpen, onClose, task, availableTasks, availableUsers, onSubmit, isLoading, mode, theme, customStatuses, }: TaskFormModalProps): react_jsx_runtime.JSX.Element;
+declare function TaskFormModal({ isOpen, onClose, task, availableTasks, availableUsers, onSubmit, isLoading, mode, theme, customStatuses, availableTags, onCreateTag, }: TaskFormModalProps): react_jsx_runtime.JSX.Element;
 
 interface GanttAIAssistantProps {
     /** All current tasks in the Gantt */
@@ -2302,6 +2321,40 @@ interface GanttAIAssistantProps {
 declare function GanttAIAssistant({ tasks, theme, config, onTasksUpdate: _onTasksUpdate, // Reserved for batch updates
 onTaskUpdate, onTaskCreate, onTaskDelete, onDependencyCreate, onDependencyDelete, }: GanttAIAssistantProps): react_jsx_runtime.JSX.Element | null;
 
+interface TagPickerProps {
+    /** Currently selected tags on the task */
+    selectedTags: TaskTag[];
+    /** All available tags in the workspace */
+    availableTags: TaskTag[];
+    /** Callback when tags change */
+    onChange: (tags: TaskTag[]) => void;
+    /** Callback to create a new tag */
+    onCreateTag?: (name: string, color: string) => Promise<TaskTag | null>;
+    /** Theme colors */
+    theme: any;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Compact mode (pill style) */
+    compact?: boolean;
+}
+declare function TagPicker({ selectedTags, availableTags, onChange, onCreateTag, theme, disabled, compact: _compact, }: TagPickerProps): react_jsx_runtime.JSX.Element;
+/**
+ * TagBadge - Small tag badge for displaying in cards/lists
+ */
+declare function TagBadge({ tag, onRemove, size }: {
+    tag: TaskTag;
+    onRemove?: () => void;
+    size?: 'xs' | 'sm';
+}): react_jsx_runtime.JSX.Element;
+/**
+ * TagList - Display list of tags (for cards)
+ */
+declare function TagList({ tags, maxVisible, size, }: {
+    tags: TaskTag[];
+    maxVisible?: number;
+    size?: 'xs' | 'sm';
+}): react_jsx_runtime.JSX.Element | null;
+
 /**
  * AI Command Parser for Gantt Chart
  * Parses natural language commands and converts them to task operations
@@ -5538,4 +5591,4 @@ declare const themes: Record<ThemeName, Theme>;
  */
 declare const defaultTheme: ThemeName;
 
-export { type AICallbacks, type AICommandResult, type GanttTask as AIGanttTask, type AIMessage, type AIModelKey, type AIOperation, AIUsageDashboard, type AIUsageDashboardProps, AI_FEATURES, AI_MODELS, type Activity, type ActivityType, AddCardButton, type AddCardButtonProps, type AddCardData, AddColumnButton, type AddColumnButtonProps, type AssigneeSuggestion, type Attachment, AttachmentUploader, type AttachmentUploaderProps, type Board, type BoardCallbacks, type BoardConfig, BoardProvider, type BoardProviderProps, type BorderRadiusToken, BulkOperationsToolbar, type BulkOperationsToolbarProps, BurnDownChart, type BurnDownChartProps, type BurnDownDataPoint, CalendarBoard, type CalendarBoardProps, type CalendarCallbacks, type CalendarConfig, type CalendarDay, type CalendarEvent, type CalendarPermissions, type CalendarSupportedLocale, type CalendarTheme, type CalendarThemeName, type CalendarTranslations, type CalendarViewMode, Card, CardDetailModal, type CardDetailModalProps, CardDetailModalV2, type CardDetailModalV2Props, type CardFilter, type CardFilters, CardHistoryReplay, type CardHistoryReplayProps, CardHistoryTimeline, type CardHistoryTimelineProps, type CardProps, CardRelationshipsGraph, type CardRelationshipsGraphProps, type CardSort, type CardSortKey, CardStack, type CardStackProps, type CardStack$1 as CardStackType, type CardStatus, type CardTemplate, CardTemplateSelector, type CardTemplateSelectorProps, type Card$1 as CardType, CircuitBreaker, Column, ColumnManager, type ColumnProps, type Column$1 as ColumnType, CommandPalette, type CommandPaletteProps, type Comment, ConfigMenu, type ConfigMenuProps, ContextMenu, DEFAULT_SHORTCUTS, DEFAULT_TEMPLATES, type DateFilter, DateRangePicker, type DateRangePickerProps, DependenciesSelector, type DependenciesSelectorProps, DependencyLine, type DesignTokens, DistributionCharts, type DistributionChartsProps, type DistributionDataPoint, type DragData, type DropData, type DurationToken, type EasingToken, EditableColumnTitle, type EditableColumnTitleProps, ErrorBoundary, type ErrorBoundaryProps, type ExportFormat, ExportImportModal, type ExportImportModalProps, type ExportOptions, FilterBar, type FilterBarProps, type FilterState, type FlattenedTask, type FontSizeToken, type FontWeightToken, GANTT_AI_SYSTEM_PROMPT, GanttAIAssistant, type GanttAIAssistantConfig, type Assignee as GanttAssignee, GanttBoard, type GanttConfig as GanttBoardConfig, type GanttBoardRef, type GanttColumn, type ColumnType as GanttColumnType, GanttI18nContext, Milestone as GanttMilestone, type GanttPermissions, type Task as GanttTask, type GanttTemplates, type Theme$1 as GanttTheme, type GanttTheme as GanttThemeConfig, GanttToolbar, type GanttTranslations, GenerateGanttTasksDialog, type GenerateGanttTasksDialogProps, GeneratePlanModal, type GeneratePlanModalProps, type GeneratedPlan, type GeneratedTasksResponse, type GroupByOption, GroupBySelector, type GroupBySelectorProps, type IPluginManager, type ImportResult, type Insight, type InsightSeverity, type InsightType, KanbanBoard, type KanbanBoardProps, KanbanToolbar, type KanbanToolbarProps, KanbanViewAdapter, type KanbanViewConfig, type KeyboardAction, type KeyboardShortcut, KeyboardShortcutsHelp, type KeyboardShortcutsHelpProps, type LineHeightToken, type ListColumn, type ListFilter, type ListSort, type ListSortColumn, ListView, type ListViewCallbacks, type ListViewConfig, type ListViewPermissions, type ListViewProps, type ListViewSupportedLocale, type ListViewTheme, type ListViewThemeName, type ListViewTranslations, MenuIcons, type OpacityToken, type PersistHistoryConfig, type Plugin, type PluginContext, type PluginHooks, PluginManager, type Priority, PrioritySelector, type PrioritySelectorProps, RATE_LIMITS, type RenderProps, type RetryOptions, type RetryResult, type ShadowToken, type SortBy, type SortDirection, type SortOrder, type SortState, type SpacingToken, type StackSuggestion, type StackingConfig, type StackingStrategy, type Subtask, type SupportedLocale, type Swimlane, SwimlaneBoardView, type SwimlaneBoardViewProps, type SwimlaneConfig, TaskBar, type TaskFormData, TaskFormModal, type TaskFormModalProps, TaskGrid, type TaskPriority, type Theme, type ThemeColors, type ThemeContextValue, ThemeModal, type ThemeModalProps, type ThemeName, ThemeProvider, ThemeSwitcher, type TimeScale, Timeline, type ThemeColors$1 as TokenThemeColors, type TokenValue, type UsageStats, type UseAIOptions, type UseAIReturn, type UseBoardReturn as UseBoardCoreReturn, type UseBoardOptions, type UseBoardReturn$1 as UseBoardReturn, type UseCardStackingOptions, type UseCardStackingResult, type UseDragStateReturn, type UseFiltersOptions, type UseFiltersReturn, type UseKanbanStateOptions, type UseKanbanStateReturn, type UseKeyboardShortcutsOptions, type UseKeyboardShortcutsReturn, type UseMultiSelectReturn, type UseSelectionStateReturn, type User$1 as User, UserAssignmentSelector, type UserAssignmentSelectorProps, VelocityChart, type VelocityChartProps, type VelocityDataPoint, VirtualGrid, type VirtualGridProps, VirtualList, type VirtualListProps, type WeekDay, type ZIndexToken, aiUsageTracker, borderRadius, calculatePosition, darkTheme$2 as calendarDarkTheme, en as calendarEnTranslations, es as calendarEsTranslations, lightTheme$2 as calendarLightTheme, neutralTheme$2 as calendarNeutralTheme, calendarThemes, calendarTranslations, cardToGanttTask, cardsToGanttTasks, cn, createKanbanView, createRetryWrapper, darkTheme, darkTheme$1 as darkTokenTheme, defaultTheme, designTokens, duration, easing, exportTokensToCSS, findTaskByName, fontSize, fontWeight, formatCost, en$2 as ganttEnTranslations, es$2 as ganttEsTranslations, ganttTaskToCardUpdate, themes$1 as ganttThemes, gantt as ganttTokens, translations as ganttTranslations, ganttUtils, generateCSSVariables, generateCompleteCSS, generateInitialPositions, generateTasksContext, generateThemeVariables, getCalendarTheme, getCalendarTranslations, getListViewTheme, getListViewTranslations, getMonthNames, getToken, getTranslations, getWeekdayNames, kanban as kanbanTokens, lightTheme, lightTheme$1 as lightTokenTheme, lineHeight, darkTheme$3 as listViewDarkTheme, en$1 as listViewEnTranslations, es$1 as listViewEsTranslations, lightTheme$3 as listViewLightTheme, neutralTheme$3 as listViewNeutralTheme, listViewThemes, listViewTranslations, mergeCalendarTranslations, mergeListViewTranslations, mergeTranslations, neutralTheme, neutralTheme$1 as neutralTokenTheme, opacity, parseLocalCommand, parseNaturalDate, parseNaturalDuration, parseProgress, parseStatus, pluginManager, retrySyncOperation, retryWithBackoff, shadows, shouldVirtualizeGrid, spacing, themes, useAI, useBoard$1 as useBoard, useBoard as useBoardCore, useBoardStore, useCardStacking, useDragState, useFilteredCards, useFilters, useGanttI18n, useKanbanState, useKeyboardShortcuts, useMultiSelect, useSelectionState, useSortedCards, useTheme, useVirtualGrid, useVirtualList, validateAIResponse, withErrorBoundary, wouldCreateCircularDependency, zIndex };
+export { type AICallbacks, type AICommandResult, type GanttTask as AIGanttTask, type AIMessage, type AIModelKey, type AIOperation, AIUsageDashboard, type AIUsageDashboardProps, AI_FEATURES, AI_MODELS, type Activity, type ActivityType, AddCardButton, type AddCardButtonProps, type AddCardData, AddColumnButton, type AddColumnButtonProps, type AssigneeSuggestion, type Attachment, AttachmentUploader, type AttachmentUploaderProps, type Board, type BoardCallbacks, type BoardConfig, BoardProvider, type BoardProviderProps, type BorderRadiusToken, BulkOperationsToolbar, type BulkOperationsToolbarProps, BurnDownChart, type BurnDownChartProps, type BurnDownDataPoint, CalendarBoard, type CalendarBoardProps, type CalendarCallbacks, type CalendarConfig, type CalendarDay, type CalendarEvent, type CalendarPermissions, type CalendarSupportedLocale, type CalendarTheme, type CalendarThemeName, type CalendarTranslations, type CalendarViewMode, Card, CardDetailModal, type CardDetailModalProps, CardDetailModalV2, type CardDetailModalV2Props, type CardFilter, type CardFilters, CardHistoryReplay, type CardHistoryReplayProps, CardHistoryTimeline, type CardHistoryTimelineProps, type CardProps, CardRelationshipsGraph, type CardRelationshipsGraphProps, type CardSort, type CardSortKey, CardStack, type CardStackProps, type CardStack$1 as CardStackType, type CardStatus, type CardTemplate, CardTemplateSelector, type CardTemplateSelectorProps, type Card$1 as CardType, CircuitBreaker, Column, ColumnManager, type ColumnProps, type Column$1 as ColumnType, CommandPalette, type CommandPaletteProps, type Comment, ConfigMenu, type ConfigMenuProps, ContextMenu, DEFAULT_SHORTCUTS, DEFAULT_TEMPLATES, type DateFilter, DateRangePicker, type DateRangePickerProps, DependenciesSelector, type DependenciesSelectorProps, DependencyLine, type DesignTokens, DistributionCharts, type DistributionChartsProps, type DistributionDataPoint, type DragData, type DropData, type DurationToken, type EasingToken, EditableColumnTitle, type EditableColumnTitleProps, ErrorBoundary, type ErrorBoundaryProps, type ExportFormat, ExportImportModal, type ExportImportModalProps, type ExportOptions, FilterBar, type FilterBarProps, type FilterState, type FlattenedTask, type FontSizeToken, type FontWeightToken, GANTT_AI_SYSTEM_PROMPT, GanttAIAssistant, type GanttAIAssistantConfig, type Assignee as GanttAssignee, GanttBoard, type GanttConfig as GanttBoardConfig, type GanttBoardRef, type GanttColumn, type ColumnType as GanttColumnType, GanttI18nContext, Milestone as GanttMilestone, type GanttPermissions, type Task as GanttTask, type GanttTemplates, type Theme$1 as GanttTheme, type GanttTheme as GanttThemeConfig, GanttToolbar, type GanttTranslations, GenerateGanttTasksDialog, type GenerateGanttTasksDialogProps, GeneratePlanModal, type GeneratePlanModalProps, type GeneratedPlan, type GeneratedTasksResponse, type GroupByOption, GroupBySelector, type GroupBySelectorProps, type IPluginManager, type ImportResult, type Insight, type InsightSeverity, type InsightType, KanbanBoard, type KanbanBoardProps, KanbanToolbar, type KanbanToolbarProps, KanbanViewAdapter, type KanbanViewConfig, type KeyboardAction, type KeyboardShortcut, KeyboardShortcutsHelp, type KeyboardShortcutsHelpProps, type LineHeightToken, type ListColumn, type ListFilter, type ListSort, type ListSortColumn, ListView, type ListViewCallbacks, type ListViewConfig, type ListViewPermissions, type ListViewProps, type ListViewSupportedLocale, type ListViewTheme, type ListViewThemeName, type ListViewTranslations, MenuIcons, type OpacityToken, type PersistHistoryConfig, type Plugin, type PluginContext, type PluginHooks, PluginManager, type Priority, PrioritySelector, type PrioritySelectorProps, RATE_LIMITS, type RenderProps, type RetryOptions, type RetryResult, type ShadowToken, type SortBy, type SortDirection, type SortOrder, type SortState, type SpacingToken, type StackSuggestion, type StackingConfig, type StackingStrategy, type Subtask, type SupportedLocale, type Swimlane, SwimlaneBoardView, type SwimlaneBoardViewProps, type SwimlaneConfig, TagBadge, TagList, TagPicker, TaskBar, type TaskFormData, TaskFormModal, type TaskFormModalProps, TaskGrid, type TaskPriority, type TaskTag, type Theme, type ThemeColors, type ThemeContextValue, ThemeModal, type ThemeModalProps, type ThemeName, ThemeProvider, ThemeSwitcher, type TimeScale, Timeline, type ThemeColors$1 as TokenThemeColors, type TokenValue, type UsageStats, type UseAIOptions, type UseAIReturn, type UseBoardReturn as UseBoardCoreReturn, type UseBoardOptions, type UseBoardReturn$1 as UseBoardReturn, type UseCardStackingOptions, type UseCardStackingResult, type UseDragStateReturn, type UseFiltersOptions, type UseFiltersReturn, type UseKanbanStateOptions, type UseKanbanStateReturn, type UseKeyboardShortcutsOptions, type UseKeyboardShortcutsReturn, type UseMultiSelectReturn, type UseSelectionStateReturn, type User$1 as User, UserAssignmentSelector, type UserAssignmentSelectorProps, VelocityChart, type VelocityChartProps, type VelocityDataPoint, VirtualGrid, type VirtualGridProps, VirtualList, type VirtualListProps, type WeekDay, type ZIndexToken, aiUsageTracker, borderRadius, calculatePosition, darkTheme$2 as calendarDarkTheme, en as calendarEnTranslations, es as calendarEsTranslations, lightTheme$2 as calendarLightTheme, neutralTheme$2 as calendarNeutralTheme, calendarThemes, calendarTranslations, cardToGanttTask, cardsToGanttTasks, cn, createKanbanView, createRetryWrapper, darkTheme, darkTheme$1 as darkTokenTheme, defaultTheme, designTokens, duration, easing, exportTokensToCSS, findTaskByName, fontSize, fontWeight, formatCost, en$2 as ganttEnTranslations, es$2 as ganttEsTranslations, ganttTaskToCardUpdate, themes$1 as ganttThemes, gantt as ganttTokens, translations as ganttTranslations, ganttUtils, generateCSSVariables, generateCompleteCSS, generateInitialPositions, generateTasksContext, generateThemeVariables, getCalendarTheme, getCalendarTranslations, getListViewTheme, getListViewTranslations, getMonthNames, getToken, getTranslations, getWeekdayNames, kanban as kanbanTokens, lightTheme, lightTheme$1 as lightTokenTheme, lineHeight, darkTheme$3 as listViewDarkTheme, en$1 as listViewEnTranslations, es$1 as listViewEsTranslations, lightTheme$3 as listViewLightTheme, neutralTheme$3 as listViewNeutralTheme, listViewThemes, listViewTranslations, mergeCalendarTranslations, mergeListViewTranslations, mergeTranslations, neutralTheme, neutralTheme$1 as neutralTokenTheme, opacity, parseLocalCommand, parseNaturalDate, parseNaturalDuration, parseProgress, parseStatus, pluginManager, retrySyncOperation, retryWithBackoff, shadows, shouldVirtualizeGrid, spacing, themes, useAI, useBoard$1 as useBoard, useBoard as useBoardCore, useBoardStore, useCardStacking, useDragState, useFilteredCards, useFilters, useGanttI18n, useKanbanState, useKeyboardShortcuts, useMultiSelect, useSelectionState, useSortedCards, useTheme, useVirtualGrid, useVirtualList, validateAIResponse, withErrorBoundary, wouldCreateCircularDependency, zIndex };