@devalok/shilp-sutra-karm 0.18.0 → 0.18.1

package/docs/components/admin/break-admin.md

@@ -0,0 +1,167 @@
+# BreakAdmin
+
+- Import: @devalok/shilp-sutra-karm/admin
+- Server-safe: No
+- Category: admin
+
+Compound component for break/leave management admin page. Uses React Context internally.
+Supports both compound usage (with children) and default layout (without children).
+
+Exports: BreakAdmin (compound), BreakAdminHeader, Breaks, LeaveRequest, BreakBalance, EditBreak, EditBreakBalance, DeleteBreak, BreakAdminSkeleton
+
+## Props
+
+### BreakAdmin.Root / BreakAdmin (BreakAdminProps)
+    currentUser: Pick<AdminUser, "id" | "name" | "role"> (REQUIRED)
+    breaks: BreakRequest[] (REQUIRED)
+    pendingRequests: BreakRequest[] (REQUIRED)
+    cashoutRequests: BreakRequest[] (default: [])
+    breakBalanceData: BreakBalanceData[] (REQUIRED)
+    breakBalance: { remainingDays: number; breakBalance: number } | null
+    userImages: Record<string, string> (REQUIRED)
+    users: AdminUser[] (REQUIRED)
+    isLoading: boolean (default: false)
+    isLoadingBreaks: boolean (default: false)
+    isLoadingRequests: boolean (default: false)
+    isLoadingBalance: boolean (default: false)
+    existingBreaks: BreakRequest[]
+    filters: BreakAdminFilters
+    onFilterChange: (filters: BreakAdminFilters) => void
+    onApproveRequest: (requestId: string, comment?: string, isCorrection?: boolean, request?: BreakRequest) => void
+    onRejectRequest: (requestId: string, comment?: string, isCorrection?: boolean, request?: BreakRequest) => void
+    onApproveCashout: (requestId: string) => void
+    onRejectCashout: (requestId: string) => void
+    onRefresh: () => void
+    onSaveBreak: (data: { requestId: string; userId: string; status: string; adminComment: string; startDate: string; endDate: string; isEditing: boolean }) => void
+    onDeleteBreak: () => void
+    onSaveBalance: (data: { userId: string; cashOutDays: number; carryForward: number; year: number }) => void
+    onFetchMonthBreaks: (month: number, year: number) => Promise<BreakRequest[]>
+    realtimeCallbacks: RealtimeCallbacks
+    children: ReactNode
+    ...HTMLDivElement attributes
+
+### BreakAdmin.Header
+    ...HTMLDivElement attributes (className, etc.)
+    Reads from context: filters, breakBalance, userImages, users
+
+### BreakAdmin.TabBar
+    ...HTMLDivElement attributes
+    Reads from context: activeTab, pendingRequests, breakBalanceData
+
+### BreakAdmin.BreaksPanel
+    ...HTMLDivElement attributes
+    Reads from context: breaks, userImages, existingBreaks, onFetchMonthBreaks, onSaveBreak, onDeleteBreak, onRefresh
+
+### BreakAdmin.RequestsPanel
+    ...HTMLDivElement attributes
+    Reads from context: pendingRequests, userImages, approve/reject handlers
+
+### BreakAdmin.BalancePanel
+    ...HTMLDivElement attributes
+    Reads from context: breakBalanceData, userImages, onSaveBalance
+
+### BreakAdminHeader (BreakAdminHeaderProps) — standalone
+    filters: BreakAdminFilters (REQUIRED)
+    onFilterChange: (filters: BreakAdminFilters) => void (REQUIRED)
+    breakBalance: { remainingDays: number; breakBalance: number } | null
+    userImages: Record<string, string> (REQUIRED)
+    users: AdminUser[] (REQUIRED)
+    ...HTMLDivElement attributes
+
+### Breaks (BreaksProps) — standalone
+    breaks: BreakRequest[] (REQUIRED)
+    userImages: Record<string, string> (REQUIRED)
+    existingBreaks: BreakRequest[]
+    onFetchMonthBreaks: (month: number, year: number) => Promise<BreakRequest[]>
+    onSave: (data: { requestId: string; userId: string; status: string; adminComment: string; startDate: string; endDate: string; isEditing: boolean }) => void
+    onDelete: () => void
+    onRefresh: () => void
+    ...HTMLDivElement attributes
+
+### LeaveRequest (LeaveRequestProps) — standalone
+    request: BreakRequest (REQUIRED)
+    userImages: Record<string, string> (REQUIRED)
+    handleRejectRequest: (event: MouseEvent | undefined, id: string, comment?: string) => void (REQUIRED)
+    handleApproveRequest: (event: MouseEvent | undefined, id: string, comment?: string) => void (REQUIRED)
+    commentBoxOpen: boolean (REQUIRED)
+    onCommentBoxClose: () => void (REQUIRED)
+    clickedAction: "approve" | "reject" | null (REQUIRED)
+    userId: string (REQUIRED)
+    ...HTMLDivElement attributes
+
+### BreakBalance (BreakBalanceProps) — standalone
+    breakBalanceData: BreakBalanceData[] (REQUIRED)
+    userImages: Record<string, string> (REQUIRED)
+    onSaveBalance: (data: { userId: string; cashOutDays: number; carryForward: number; year: number }) => void
+    ...HTMLDivElement attributes
+
+### EditBreak (EditBreakProps) — standalone
+    selectedLeave: BreakRequest & { numberOfDays: number } (REQUIRED)
+    existingBreaks: BreakRequest[]
+    onFetchMonthBreaks: (month: number, year: number) => Promise<BreakRequest[]>
+    onSave: (data: { requestId: string; userId: string; status: string; adminComment: string; startDate: string; endDate: string; isEditing: boolean }) => void
+    onDelete: () => void
+    ...HTMLDivElement attributes
+
+### EditBreakBalance (EditBreakBalanceProps) — standalone
+    selectedLeave: BreakBalanceData (REQUIRED)
+    onSave: (data: { userId: string; cashOutDays: number; carryForward: number; year: number }) => void
+    ...HTMLDivElement attributes
+
+### DeleteBreak (DeleteBreakProps) — standalone
+    id: string (REQUIRED)
+    userId: string (REQUIRED)
+    onDelete: () => void
+    ...HTMLDivElement attributes
+
+### BreakAdminSkeleton
+    ...HTMLDivElement attributes (className, etc.)
+
+## Supporting Types
+    BreakAdminFilters: { selectedAssociate: AdminUser | null; dateFilterStart: string | Date | null; dateFilterEnd: string | Date | null; currMonth: number; currYear: number; isOpen: boolean }
+
+## Defaults
+    isLoading=false, cashoutRequests=[], isLoadingBreaks=false, isLoadingRequests=false, isLoadingBalance=false
+
+## Example
+```jsx
+// Default layout (no children needed)
+<BreakAdmin
+  currentUser={{ id: "admin-1", name: "Admin", role: "Admin" }}
+  breaks={allBreaks}
+  pendingRequests={pending}
+  breakBalanceData={balanceData}
+  userImages={imageMap}
+  users={allUsers}
+  isLoading={isLoading}
+  onApproveRequest={handleApprove}
+  onRejectRequest={handleReject}
+  onSaveBreak={handleSaveBreak}
+  onSaveBalance={handleSaveBalance}
+/>
+
+// Compound layout (custom arrangement)
+<BreakAdmin.Root currentUser={user} breaks={b} pendingRequests={p} breakBalanceData={bd} userImages={ui} users={u}>
+  <BreakAdmin.Header />
+  <BreakAdmin.TabBar />
+  <BreakAdmin.BreaksPanel />
+  <BreakAdmin.RequestsPanel />
+  <BreakAdmin.BalancePanel />
+</BreakAdmin.Root>
+```
+
+## Gotchas
+- Without children, renders the default layout (Header + TabBar + all three panels)
+- With children, renders only the provided sub-components — you control the layout
+- Approve/reject with Cmd/Ctrl+click opens a comment box before confirming
+- `BreakAdmin.BreaksPanel` only renders when `activeTab === "breaks"`
+- `BreakAdmin.RequestsPanel` only renders when `activeTab === "requests"`
+- `BreakAdmin.BalancePanel` only renders when `activeTab === "balance"`
+- `isLoading=true` renders `BreakAdminSkeleton` instead of children
+- `onApproveRequest` receives `isCorrection` boolean and the full `request` object as 3rd/4th args
+- Toast notifications fire automatically on approve/reject success or error
+
+## Changes
+### v0.9.0
+- **Added** Compound component API replacing monolith
+- **Added** Standalone exports for BreakAdminHeader, Breaks, LeaveRequest, BreakBalance, EditBreak, EditBreakBalance, DeleteBreak

package/docs/components/board/board-column.md

@@ -0,0 +1,35 @@
+# BoardColumn
+
+- Import: @devalok/shilp-sutra-karm/board
+- Server-safe: No
+- Category: board
+
+## Props
+    column: BoardColumn (REQUIRED)
+    index: number (REQUIRED)
+    isOverlay: boolean
+    dragPreview: { taskId: string; columnId: string; index: number }
+    draggedTask: BoardTask | null
+    ...HTMLAttributes<HTMLDivElement>
+
+## Defaults
+    isOverlay=undefined, dragPreview=undefined, draggedTask=undefined
+
+## Example
+```jsx
+<BoardColumn column={column} index={0} />
+```
+
+## Gotchas
+- Must be rendered inside a BoardProvider context.
+- Reads viewMode from context to switch between TaskCard and TaskCardCompact.
+- Renders ColumnHeader, TaskContextMenu wrappers, and ColumnEmpty automatically.
+- When column.wipLimit is set and exceeded, the column background turns error-colored.
+- Fixed width defined by COLUMN_WIDTH constant.
+- Forwards ref to outer div.
+- Uses @dnd-kit useDroppable for drop target and SortableContext for task reordering.
+- Ghost silhouette (TaskGhost) is rendered at the dragPreview position during cross-column drags.
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/board/board-provider.md

@@ -0,0 +1,73 @@
+# BoardProvider
+
+- Import: @devalok/shilp-sutra-karm/board
+- Server-safe: No
+- Category: board
+
+## Props
+    initialData: BoardData (REQUIRED)
+    currentUserId: string | null (default: null)
+    members: BoardMember[] (explicit member list for assignment dropdowns; falls back to deriving from task assignees)
+    children: ReactNode (REQUIRED)
+    onTaskMove: (taskId: string, toColumnId: string, newOrder: number) => void
+    onTaskAdd: (columnId: string, options: NewTaskOptions) => void
+    onBulkAction: (action: BulkAction) => void
+    onColumnReorder: (columnId: string, newIndex: number) => void
+    onColumnRename: (columnId: string, name: string) => void
+    onColumnDelete: (columnId: string) => void
+    onColumnToggleVisibility: (columnId: string, visible: boolean) => void
+    onColumnWipLimitChange: (columnId: string, limit: number | null) => void
+    onClickTask: (taskId: string) => void
+    onAddColumn: () => void
+    onQuickPriorityChange: (taskId: string, priority: string) => void
+    onQuickAssign: (taskId: string, userId: string) => void
+    onQuickDueDateChange: (taskId: string, date: string | null) => void
+    onQuickLabelAdd: (taskId: string, label: string) => void
+    onQuickVisibilityChange: (taskId: string, visibility: string) => void
+    onQuickDelete: (taskId: string) => void
+
+## Defaults
+    currentUserId=null
+
+## Context Value (useBoardContext)
+    columns: BoardColumn[] (filtered)
+    rawColumns: BoardColumn[] (unfiltered)
+    members: BoardMember[]
+    viewMode: BoardViewMode
+    setViewMode: (mode: BoardViewMode) => void
+    filters: BoardFilters
+    setFilters: (updates: Partial<BoardFilters>) => void
+    clearFilters: () => void
+    hasActiveFilters: boolean
+    selectedTaskIds: Set<string>
+    toggleTaskSelection: (taskId: string) => void
+    selectRange: (fromId: string, toId: string) => void
+    selectAll: () => void
+    clearSelection: () => void
+    focusedTaskId: string | null
+    setFocusedTaskId: (id: string | null) => void
+    currentUserId: string | null
+    highlightMyTasks: boolean
+    setHighlightMyTasks: (on: boolean) => void
+    activeTask: BoardTask | null
+    setActiveTask: (task: BoardTask | null) => void
+
+## Example
+```jsx
+<BoardProvider initialData={data} currentUserId="user-1" onTaskMove={handleMove}>
+  <BoardToolbar />
+  <BulkActionBar />
+  {/* custom layout */}
+</BoardProvider>
+```
+
+## Gotchas
+- Must wrap all board sub-components (BoardColumn, BoardToolbar, BulkActionBar, etc.).
+- useBoardContext() throws if used outside BoardProvider.
+- All callback props default to no-op internally.
+- columns in context are filtered; use rawColumns for unfiltered data.
+- Syncs with initialData changes via useEffect.
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/board/board-toolbar.md

@@ -0,0 +1,36 @@
+# BoardToolbar
+
+- Import: @devalok/shilp-sutra-karm/board
+- Server-safe: No
+- Category: board
+
+## Props
+    ...HTMLAttributes<HTMLDivElement>
+
+## Features
+- Debounced search input (200ms)
+- Priority filter (multi-select checkbox dropdown: LOW, MEDIUM, HIGH, URGENT)
+- Assignee filter (multi-select checkbox dropdown, derived from board members)
+- Label filter (multi-select checkbox dropdown, derived from task labels)
+- Due date filter (radio: overdue, today, this-week)
+- "Highlight my tasks" toggle button
+- View mode toggle (SegmentedControl: Board / Compact)
+- Active filter chips with individual dismiss and "Clear all" button
+
+## Example
+```jsx
+{/* Rendered automatically by KanbanBoard, or manually inside BoardProvider */}
+<BoardProvider initialData={data}>
+  <BoardToolbar />
+</BoardProvider>
+```
+
+## Gotchas
+- Must be rendered inside a BoardProvider context.
+- No props needed — all state comes from context.
+- Assignee and Label filter dropdowns only render when members/labels exist.
+- Forwards ref to outer div.
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/board/board-types.md

@@ -0,0 +1,62 @@
+# Board Types
+
+- Import: @devalok/shilp-sutra-karm/board
+- Category: board
+
+## BoardTask
+    id: string
+    taskId: string (display ID, e.g. "KRM-42")
+    title: string
+    priority: 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
+    labels: string[]
+    dueDate: string | null
+    isBlocked: boolean
+    visibility: 'INTERNAL' | 'EVERYONE'
+    owner: BoardMember | null
+    assignees: BoardMember[]
+    subtaskCount: number
+    subtasksDone: number
+
+## BoardMember
+    id: string
+    name: string
+    image: string | null
+
+## BoardColumn
+    id: string
+    name: string
+    isClientVisible: boolean (optional)
+    wipLimit: number (optional)
+    tasks: BoardTask[]
+
+## BoardData
+    columns: BoardColumn[]
+
+## BoardFilters
+    search: string
+    assignees: string[]
+    priorities: string[]
+    labels: string[]
+    dueDateRange: 'overdue' | 'today' | 'this-week' | 'none' | null
+
+## BoardViewMode
+    'default' | 'compact'
+
+## NewTaskOptions
+    title: string
+    ownerId: string | null (optional)
+    dueDate: string | null (optional)
+
+## BulkAction
+    type: 'move' | 'priority' | 'assign' | 'label' | 'dueDate' | 'delete' | 'visibility'
+    taskIds: string[]
+    value: string | null (optional)
+
+## Gotchas
+- BoardTask.taskId is the human-readable display ID (e.g. "KRM-42"), not the same as BoardTask.id (database UUID).
+- BoardColumn.wipLimit is optional; when set and exceeded, the column renders in error state.
+- BoardFilters.dueDateRange can be null or 'none' to indicate no filter.
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/board/bulk-action-bar.md

@@ -0,0 +1,38 @@
+# BulkActionBar
+
+- Import: @devalok/shilp-sutra-karm/board
+- Server-safe: No
+- Category: board
+
+## Props
+    ...HTMLAttributes<HTMLDivElement>
+
+## Features
+- Animates in/out when tasks are selected (AnimatePresence)
+- Shows selection count with clear button
+- Dropdown actions: Move to column, Set priority, Assign, Set visibility
+- Delete button (right-aligned, error-colored)
+- All actions trigger onBulkAction from context then clear selection
+
+## Bulk Action Shape
+    { type: 'move' | 'priority' | 'assign' | 'label' | 'dueDate' | 'delete' | 'visibility', taskIds: string[], value?: string | null }
+
+## Example
+```jsx
+{/* Rendered automatically by KanbanBoard, or manually inside BoardProvider */}
+<BoardProvider initialData={data} onBulkAction={handleBulk}>
+  <BulkActionBar />
+</BoardProvider>
+```
+
+## Gotchas
+- Must be rendered inside a BoardProvider context.
+- No props needed — all state comes from context.
+- Only visible when selectedTaskIds.size > 0.
+- Assign dropdown only renders when members exist.
+- Forwards ref to outer div.
+- Uses aria-live="polite" for screen reader announcements.
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/board/column-empty.md

@@ -0,0 +1,33 @@
+# ColumnEmpty
+
+- Import: @devalok/shilp-sutra-karm/board
+- Server-safe: No
+- Category: board
+
+## Props
+    index: number (REQUIRED) — used to cycle through 4 illustration variants
+    onAddTask: () => void
+    isDropTarget: boolean (default: false)
+    ...HTMLAttributes<HTMLDivElement>
+
+## Defaults
+    isDropTarget=false
+
+## Illustrations
+Cycles through 4 SVG illustrations by column index:
+0: Clipboard, 1: Stacked Cards, 2: Checkmark Circle, 3: Inbox
+
+## Example
+```jsx
+<ColumnEmpty index={0} onAddTask={() => addTask(columnId)} />
+<ColumnEmpty index={1} isDropTarget />
+```
+
+## Gotchas
+- When isDropTarget=true, shows "Drop tasks here" text instead of the default empty state with "Add a task" button.
+- Illustrations use currentColor (inherits text-surface-fg-subtle).
+- Forwards ref to outer div.
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/board/column-header.md

@@ -0,0 +1,36 @@
+# ColumnHeader
+
+- Import: @devalok/shilp-sutra-karm/board
+- Server-safe: No
+- Category: board
+
+## Props
+    column: BoardColumn (REQUIRED)
+    index: number (REQUIRED)
+    ...HTMLAttributes<HTMLDivElement>
+
+## Features
+- Color-coded accent dot (cycles through COLUMN_ACCENT_COLORS by index)
+- Column name with task count badge
+- Double-click to rename (inline Input)
+- WIP limit display with exceeded state (error color)
+- Inline WIP limit editor
+- Quick-add task form (title, owner picker, due date picker)
+- Column options dropdown: Rename, Set WIP Limit, Show/Hide from client, Delete column
+- Avatar stack of unique members in the column (AvatarGroup, max 3)
+
+## Example
+```jsx
+{/* Rendered automatically by BoardColumn */}
+<ColumnHeader column={column} index={0} />
+```
+
+## Gotchas
+- Must be rendered inside a BoardProvider context.
+- Reads members, onColumnRename, onColumnDelete, onColumnToggleVisibility, onTaskAdd from context.
+- Quick-add form expands with animation (AnimatePresence + framer-motion).
+- Forwards ref to outer div.
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/board/kanban-board.md

@@ -0,0 +1,53 @@
+# KanbanBoard
+
+- Import: @devalok/shilp-sutra-karm/board
+- Server-safe: No
+- Category: board
+
+## Props
+    initialData: BoardData (REQUIRED)
+    currentUserId: string | null (default: null)
+    members: BoardMember[] (explicit member list; falls back to deriving from task assignees)
+    onTaskMove: (taskId: string, toColumnId: string, newOrder: number) => void
+    onTaskAdd: (columnId: string, options: NewTaskOptions) => void
+    onBulkAction: (action: BulkAction) => void
+    onColumnReorder: (columnId: string, newIndex: number) => void
+    onColumnRename: (columnId: string, name: string) => void
+    onColumnDelete: (columnId: string) => void
+    onColumnToggleVisibility: (columnId: string, visible: boolean) => void
+    onColumnWipLimitChange: (columnId: string, limit: number | null) => void
+    onClickTask: (taskId: string) => void
+    onAddColumn: () => void
+    onQuickPriorityChange: (taskId: string, priority: string) => void
+    onQuickAssign: (taskId: string, userId: string) => void
+    onQuickDueDateChange: (taskId: string, date: string | null) => void
+    onQuickLabelAdd: (taskId: string, label: string) => void
+    onQuickVisibilityChange: (taskId: string, visibility: string) => void
+    onQuickDelete: (taskId: string) => void
+    className: string
+
+## Defaults
+    currentUserId=null
+
+## Example
+```jsx
+<KanbanBoard
+  initialData={{ columns: [...] }}
+  currentUserId="user-1"
+  members={teamMembers}
+  onTaskMove={(taskId, toCol, order) => moveTask(taskId, toCol, order)}
+  onClickTask={(taskId) => openDetail(taskId)}
+  onAddColumn={() => createColumn()}
+/>
+```
+
+## Gotchas
+- This is the top-level orchestrator. It composes BoardProvider, BoardToolbar, BulkActionBar, and BoardColumn internally.
+- All callback props are optional and default to no-op. Wire them up to persist changes.
+- Extends Omit<BoardProviderProps, 'children'> plus className. Forwards ref to outer div.
+- Drag-and-drop uses @dnd-kit (PointerSensor, TouchSensor, KeyboardSensor).
+- The "Add column" button is always rendered at the end of the horizontal scroll area.
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/board/task-card.md

@@ -0,0 +1,58 @@
+# TaskCard / TaskCardCompact / TaskCardOverlay / TaskCardCompactOverlay
+
+- Import: @devalok/shilp-sutra-karm/board
+- Server-safe: No
+- Category: board
+
+## TaskCard Props
+    task: BoardTask (REQUIRED)
+    ...HTMLAttributes<HTMLDivElement>
+
+## TaskCardCompact Props
+    task: BoardTask (REQUIRED)
+    ...HTMLAttributes<HTMLDivElement>
+
+## TaskCardOverlay Props
+    task: BoardTask (REQUIRED)
+    ...HTMLAttributes<HTMLDivElement>
+
+## TaskCardCompactOverlay Props
+    task: BoardTask (REQUIRED)
+    ...HTMLAttributes<HTMLDivElement>
+
+## Card Variants (CVA)
+    state: "default" | "dragging" | "overlay" (default: "default")
+    blocked: boolean (default: false) — adds left error border
+    selected: boolean (default: false) — adds accent ring
+    dimmed: boolean (default: false) — reduces opacity
+
+## Compact Card Variants (CVA)
+    selected: boolean (default: false)
+    dimmed: boolean (default: false)
+
+## Example
+```jsx
+{/* Used automatically by BoardColumn based on viewMode */}
+<TaskCard task={task} />
+<TaskCardCompact task={task} />
+
+{/* Overlay variants used inside DragOverlay */}
+<TaskCardOverlay task={task} />
+<TaskCardCompactOverlay task={task} />
+```
+
+## Visual Elements
+- Default card: taskId, priority icon, drag handle, title (2-line clamp), due date, subtask count, visibility/blocked badges, avatar stack (owner with glow + up to 3 assignees)
+- Compact card: single row with priority icon, taskId, title (1-line clamp), subtask count, lead avatar
+
+## Gotchas
+- Must be rendered inside a BoardProvider context (reads selectedTaskIds, focusedTaskId, currentUserId, highlightMyTasks, onClickTask).
+- TaskCard and TaskCardCompact use @dnd-kit useSortable hooks internally for drag-and-drop.
+- TaskCardOverlay and TaskCardCompactOverlay have NO sortable hooks — they are for DragOverlay only.
+- Selection checkbox appears on hover or when any tasks are selected.
+- highlightMyTasks dims cards where the current user is not owner or assignee.
+- All four variants forward ref.
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/board/task-context-menu.md

@@ -0,0 +1,36 @@
+# TaskContextMenu
+
+- Import: @devalok/shilp-sutra-karm/board
+- Server-safe: No
+- Category: board
+
+## Props
+    taskId: string (REQUIRED)
+    children: ReactNode (REQUIRED)
+    className: string
+
+## Menu Items
+- Set Priority (submenu: Low, Medium, High, Urgent with icons)
+- Assign (submenu: member list, only shown when members exist)
+- Add Label (submenu: labels derived from board data)
+- Set Due Date (opens native date picker)
+- Visibility (submenu: Internal only, Visible to all)
+- Delete (destructive, separated by divider)
+
+## Example
+```jsx
+<TaskContextMenu taskId={task.id}>
+  <TaskCard task={task} />
+</TaskContextMenu>
+```
+
+## Gotchas
+- Must be rendered inside a BoardProvider context.
+- Right-click triggers the context menu via Radix ContextMenu.
+- Callbacks come from context: onQuickPriorityChange, onQuickAssign, onQuickLabelAdd, onQuickDueDateChange, onQuickVisibilityChange, onQuickDelete.
+- Due date uses a hidden native date input with showPicker().
+- Forwards ref to ContextMenuTrigger (HTMLSpanElement).
+
+## Changes
+### v0.18.0
+- **Added** Initial release

package/docs/components/chat/chat-input.md

@@ -0,0 +1,37 @@
+# ChatInput
+
+- Import: @devalok/shilp-sutra-karm/chat
+- Server-safe: No
+- Category: chat
+
+## Props
+    onSubmit: (message: string) => void (REQUIRED)
+    onCancel: () => void
+    isStreaming: boolean (default: false)
+    placeholder: string (default: "Ask Karm AI...")
+    disclaimer: string (default: "AI responses may be inaccurate. Verify important information.")
+    className: string
+
+## Defaults
+    isStreaming=false, placeholder="Ask Karm AI...", disclaimer="AI responses may be inaccurate. Verify important information."
+
+## Example
+```jsx
+<ChatInput
+  onSubmit={(msg) => sendMessage(msg)}
+  onCancel={() => cancelStream()}
+  isStreaming={isStreaming}
+/>
+```
+
+## Gotchas
+- Enter sends the message; Shift+Enter inserts a newline
+- When isStreaming=true, the send button becomes a red stop button that calls onCancel
+- The textarea auto-resizes up to 160px max height
+- Trims whitespace before submitting — empty/whitespace-only messages are blocked
+- Extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onSubmit'> — the native onSubmit is replaced
+- Set disclaimer="" (empty string) to hide the disclaimer text
+
+## Changes
+### v0.18.0
+- **Added** Initial release