@devalok/shilp-sutra-karm 0.18.0 → 0.19.0

package/dist/tasks/task-panel.d.ts

@@ -0,0 +1,104 @@
+"use client";
+import * as React from 'react';
+interface TaskPanelTabProps {
+    /** Unique tab identifier */
+    id: string;
+    /** Optional icon rendered in the tab trigger */
+    icon?: React.ReactNode;
+    /** Tab trigger label */
+    label: string;
+    /** Tab panel content */
+    children: React.ReactNode;
+}
+/**
+ * Declarative tab definition for TaskPanel.Tabs.
+ * Does not render anything on its own — TaskPanelTabs extracts props from these children.
+ */
+declare function TaskPanelTab(_props: TaskPanelTabProps): React.ReactElement | null;
+declare namespace TaskPanelTab {
+    var displayName: string;
+}
+interface TaskPanelRootProps {
+    children: React.ReactNode;
+    className?: string;
+}
+declare function TaskPanelRoot({ children, className }: TaskPanelRootProps): import("react/jsx-runtime").JSX.Element;
+declare namespace TaskPanelRoot {
+    var displayName: string;
+}
+interface TaskPanelHeaderProps {
+    children: React.ReactNode;
+    className?: string;
+}
+declare function TaskPanelHeader({ children, className }: TaskPanelHeaderProps): import("react/jsx-runtime").JSX.Element;
+declare namespace TaskPanelHeader {
+    var displayName: string;
+}
+interface TaskPanelTitleProps {
+    /** Current title value */
+    value: string;
+    /** Whether the title can be edited inline */
+    editable?: boolean;
+    /** Called when the user commits a title change */
+    onUpdate?: (title: string) => void;
+    /** When true, shows a small "Subtask" label above the title */
+    subtask?: boolean;
+    className?: string;
+}
+declare function TaskPanelTitle({ value, editable, onUpdate, subtask, className, }: TaskPanelTitleProps): import("react/jsx-runtime").JSX.Element;
+declare namespace TaskPanelTitle {
+    var displayName: string;
+}
+interface TaskPanelPropertiesProps {
+    children: React.ReactNode;
+    className?: string;
+}
+declare function TaskPanelProperties({ children, className }: TaskPanelPropertiesProps): import("react/jsx-runtime").JSX.Element;
+declare namespace TaskPanelProperties {
+    var displayName: string;
+}
+interface TaskPanelPropertyProps {
+    /** Icon element rendered at the start of the label area */
+    icon: React.ReactNode;
+    /** Human-readable property label */
+    label: string;
+    /** Property value / control */
+    children: React.ReactNode;
+    className?: string;
+}
+declare function TaskPanelProperty({ icon, label, children, className }: TaskPanelPropertyProps): import("react/jsx-runtime").JSX.Element;
+declare namespace TaskPanelProperty {
+    var displayName: string;
+}
+interface TaskPanelTabsProps {
+    /** Default active tab id */
+    defaultTab: string;
+    /** Called when the active tab changes */
+    onTabChange?: (tab: string) => void;
+    /** Must contain TaskPanel.Tab children */
+    children: React.ReactNode;
+    className?: string;
+}
+declare function TaskPanelTabs({ defaultTab, onTabChange, children, className, }: TaskPanelTabsProps): import("react/jsx-runtime").JSX.Element;
+declare namespace TaskPanelTabs {
+    var displayName: string;
+}
+interface TaskPanelLoadingProps {
+    className?: string;
+}
+declare function TaskPanelLoading({ className }: TaskPanelLoadingProps): import("react/jsx-runtime").JSX.Element;
+declare namespace TaskPanelLoading {
+    var displayName: string;
+}
+declare const TaskPanel: typeof TaskPanelRoot & {
+    Header: typeof TaskPanelHeader;
+    Title: typeof TaskPanelTitle;
+    Properties: typeof TaskPanelProperties;
+    Property: typeof TaskPanelProperty;
+    Tabs: typeof TaskPanelTabs;
+    Tab: typeof TaskPanelTab;
+    Loading: typeof TaskPanelLoading;
+};
+export { TaskPanel };
+export type { TaskPanelRootProps, TaskPanelHeaderProps, TaskPanelTitleProps, TaskPanelPropertiesProps, TaskPanelPropertyProps, TaskPanelTabsProps, TaskPanelTabProps, TaskPanelLoadingProps, };
+//# sourceMappingURL=task-panel.d.ts.map

package/dist/tasks/task-panel.d.ts.map

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

package/dist/tasks/task-properties.d.ts

@@ -1,17 +1,7 @@
 "use client";
+import { Member, Column } from './task-types';
 import * as React from 'react';
-export interface Member {
-    id: string;
-    name: string;
-    email?: string;
-    image?: string | null;
-}
-export interface Column {
-    id: string;
-    name: string;
-    isDefault?: boolean;
-    isTerminal?: boolean;
-}
+export type { Member, Column };
 interface TaskData {
     id: string;
     columnId: string;

package/dist/tasks/task-properties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-properties.d.ts","sourceRoot":"","sources":["../../src/tasks/task-properties.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAiC9B,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC7B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;IAC9C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,EAAE,UAAU,GAAG,UAAU,CAAA;CACpC;AAED,UAAU,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACxE,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACjD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,uEAAuE;IACvE,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAA;IAC1E,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE;QACzB,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;QAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAA;QACrC,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,KAAK,KAAK,CAAC,SAAS,CAAA;IACrB,gGAAgG;IAChG,yBAAyB,CAAC,EAAE,MAAM,IAAI,CAAA;CACvC;AA0DD,QAAA,MAAM,cAAc,4FAoXnB,CAAA;AAID,OAAO,EAAE,cAAc,EAAE,CAAA;AACzB,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"task-properties.d.ts","sourceRoot":"","sources":["../../src/tasks/task-properties.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AA6B9B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAClD,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAM9B,UAAU,QAAQ;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC7B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAA;IAC9C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,EAAE,UAAU,GAAG,UAAU,CAAA;CACpC;AAED,UAAU,mBAAoB,SAAQ,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC;IACxE,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACjD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,uEAAuE;IACvE,uBAAuB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAA;IAC1E,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE;QACzB,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;QAClB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAA;QACrC,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,KAAK,KAAK,CAAC,SAAS,CAAA;IACrB,gGAAgG;IAChG,yBAAyB,CAAC,EAAE,MAAM,IAAI,CAAA;CACvC;AA0DD,QAAA,MAAM,cAAc,4FAoXnB,CAAA;AAID,OAAO,EAAE,cAAc,EAAE,CAAA;AACzB,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAA"}

package/dist/tasks/task-types.d.ts

@@ -0,0 +1,104 @@
+"use client";
+export type Priority = 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT';
+export type Visibility = 'INTERNAL' | 'EVERYONE';
+export type CommentAuthorType = 'INTERNAL' | 'CLIENT';
+export interface LabelOption {
+    name: string;
+    color?: string;
+}
+export interface Member {
+    id: string;
+    name: string;
+    email?: string;
+    image?: string | null;
+}
+export interface Column {
+    id: string;
+    name: string;
+    isDefault?: boolean;
+    isTerminal?: boolean;
+}
+export interface Subtask {
+    id: string;
+    title: string;
+    priority: Priority;
+    columnId: string;
+    column?: {
+        id: string;
+        name: string;
+        isTerminal?: boolean;
+    };
+    assignees: {
+        user: {
+            id: string;
+            name: string;
+            image?: string | null;
+        };
+    }[];
+}
+export interface ReviewUser {
+    id: string;
+    name: string;
+    image: string | null;
+}
+export interface ReviewRequest {
+    id: string;
+    taskId: string;
+    status: 'PENDING' | 'APPROVED' | 'CHANGES_REQUESTED' | 'REJECTED';
+    feedback: string | null;
+    requestedBy: ReviewUser;
+    reviewer: ReviewUser;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CommentAuthor {
+    id: string;
+    name: string;
+    email?: string;
+    image?: string | null;
+}
+export interface Comment {
+    id: string;
+    taskId: string;
+    authorType: CommentAuthorType;
+    authorId: string;
+    content: string;
+    createdAt: string;
+    updatedAt: string;
+    internalAuthor?: CommentAuthor | null;
+    clientAuthor?: {
+        id: string;
+        name: string;
+        email: string;
+    } | null;
+}
+export interface TaskFile {
+    id: string;
+    taskId: string;
+    title: string;
+    fileUrl: string;
+    downloadUrl?: string;
+    fileType: string | null;
+    uploadedBy: {
+        id: string;
+        name: string;
+        image: string | null;
+    };
+    createdAt: string;
+    /** External link (e.g. Google Drive) displayed alongside the download button */
+    externalUrl?: string;
+    /** Label for the external link tooltip (default: "Open externally") */
+    externalLabel?: string;
+}
+export interface AuditLogEntry {
+    id: string;
+    timestamp: string;
+    actorType: 'USER' | 'CLIENT' | 'SYSTEM' | 'AGENT';
+    actorId: string | null;
+    action: string;
+    entityType: string;
+    entityId: string;
+    projectId: string | null;
+    metadata: Record<string, unknown> | null;
+}
+//# sourceMappingURL=task-types.d.ts.map

package/dist/tasks/task-types.d.ts.map

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

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

@@ -0,0 +1,215 @@
+# AdminDashboard
+
+- Import: @devalok/shilp-sutra-karm/admin
+- Server-safe: No
+- Category: admin
+
+Compound component for the admin attendance dashboard. Uses React Context internally.
+All sub-components must be rendered inside `<AdminDashboard.Root>`.
+
+Exports: AdminDashboard (compound), AdminDashboard.Content, AdminDashboardSkeleton, Calendar, BreakRequestCard, LeaveRequests, DashboardHeader, AttendanceOverview, AssociateDetail, CorrectionList, RenderDate
+
+## Props
+
+### AdminDashboard.Root (AdminDashboardRootProps)
+    currentUserId: string (REQUIRED)
+    currentUserRole: UserRole (REQUIRED)
+    currentUser?: AdminUser
+    assetsBaseUrl: string (default: "")
+    userImages: Record<string, string> (default: {})
+    isLoading: boolean (default: false)
+    onAssociateChange: (user: AdminUser | null) => void
+    children: ReactNode (REQUIRED)
+    ...HTMLDivElement attributes (className, etc.)
+
+### AdminDashboard.Calendar (AdminDashboardCalendarProps)
+    dateAttendanceMap: Map<string, DateAttendanceInfo> | null (default: null)
+    onDateChange: (date: string) => void
+    onTimeFrameChange: (timeFrame: string) => void
+    users: AdminUser[] (default: [])
+    selectedUserAttendance: AttendanceRecord | null (default: null)
+    ...HTMLDivElement attributes
+
+### AdminDashboard.AttendanceOverview (AdminDashboardAttendanceOverviewProps)
+    groupedAttendance?: GroupedAttendance | null (default: null)
+    users?: AdminUser[] (default: [])
+    ...HTMLDivElement attributes
+
+### AdminDashboard.AssociateDetail (AdminDashboardAssociateDetailProps)
+    attendance: AttendanceRecord | null (default: null)
+    tasks: TaskItem[] (default: [])
+    breakRequest: BreakRequest | null (default: null)
+    onUpdateAttendanceStatus: (params: { userId: string; date: string; isPresent: boolean }) => void | Promise<void>
+    onToggleTaskStatus: (taskId: string, newStatus: string) => void | Promise<void>
+    onAddTask: (title: string, assigneeId: string) => void | Promise<void>
+    onReorderTasks: (draggedTaskId: string, targetTaskId: string) => void | Promise<void>
+    onCancelBreak: (params: { requestId: string; deleteSingleDay: boolean; dateToCancel: string | Date; userId: string }) => void | Promise<void>
+    onRefreshSelectedUserAttendance: () => void | Promise<void>
+    onRefreshAttendanceData: () => void | Promise<void>
+    ...HTMLDivElement attributes
+
+### AdminDashboard.LeaveRequests (AdminDashboardLeaveRequestsProps)
+    requests?: BreakRequest[] (default: [])
+    corrections?: AttendanceCorrection[] (default: [])
+    onApproveBreak: (params: { requestId: string; adminComment: string; userId: string }) => void | Promise<void>
+    onRejectBreak: (params: { requestId: string; adminComment: string; userId: string }) => void | Promise<void>
+    onApproveCorrection: (correctionId: string) => void | Promise<void>
+    onRejectCorrection: (correctionId: string) => void | Promise<void>
+    ...HTMLDivElement attributes
+
+### AdminDashboard.Content (AdminDashboardContentProps)
+    children: ReactNode (REQUIRED)
+    ...HTMLDivElement attributes
+
+### Calendar (CalendarProps) — standalone
+    onDateSelect: (date: Date) => void (REQUIRED)
+    hasCorrection: (date: Date) => boolean
+    ...HTMLDivElement attributes
+
+### BreakRequestCard (BreakRequestProps) — standalone
+    selectedDate: string | Date (REQUIRED)
+    userId: string (REQUIRED)
+    breakRequest: BreakRequest | null
+    assetsBaseUrl: string
+    onCancelBreak: (params: { requestId: string; deleteSingleDay: boolean; dateToCancel: string | Date; userId: string }) => void | Promise<void>
+    onRefreshAttendance: () => void | Promise<void>
+    onRefreshGroupedAttendance: () => void | Promise<void>
+    ...HTMLDivElement attributes
+
+### LeaveRequests (LeaveRequestsProps) — standalone
+    requests: BreakRequest[] (REQUIRED)
+    currentUserId: string (REQUIRED)
+    userImages: Record<string, string>
+    activeTimeFrame: string
+    onApproveBreak: (params: { requestId: string; adminComment: string; userId: string }) => void | Promise<void>
+    onRejectBreak: (params: { requestId: string; adminComment: string; userId: string }) => void | Promise<void>
+    ...HTMLDivElement attributes
+
+### DashboardHeader (DashboardHeaderProps) — standalone
+    selectedMonth: string (REQUIRED)
+    yearsList: string[] (REQUIRED)
+    isTodaySelected: boolean (REQUIRED)
+    selectedAssociate: AdminUser | null (REQUIRED)
+    users: AdminUser[] (REQUIRED)
+    userImages: Record<string, string> (REQUIRED)
+    activeTimeFrame: string (REQUIRED)
+    onMonthSelection: (monthYear: string) => void (REQUIRED)
+    onTodayClick: () => void (REQUIRED)
+    onSelectAssociate: (user: AdminUser | null) => void (REQUIRED)
+    onTimeFrameChange: (id: string) => void (REQUIRED)
+    onDateChange: (direction: "prev" | "next") => void (REQUIRED)
+    ...HTMLDivElement attributes
+
+### AttendanceOverview (AttendanceOverviewProps) — standalone
+    isFutureDate: boolean (REQUIRED)
+    users: AdminUser[] (REQUIRED)
+    groupedAttendance: GroupedAttendance | null (REQUIRED)
+    userImages: Record<string, string> (REQUIRED)
+    selectedDate: string (REQUIRED)
+    ...HTMLDivElement attributes
+
+### AssociateDetail (AssociateDetailProps) — standalone
+    selectedAssociate: AdminUser (REQUIRED)
+    selectedDate: string (REQUIRED)
+    selectedUserAttendance: AttendanceRecord | null (REQUIRED)
+    userTasks: TaskItem[] (REQUIRED)
+    selectedBreakRequest: BreakRequest | null (REQUIRED)
+    isFutureDate: boolean (REQUIRED)
+    assetsBaseUrl: string (REQUIRED)
+    onUpdateAttendanceStatus: (params: { userId: string; date: string; isPresent: boolean }) => void | Promise<void>
+    onToggleTaskStatus: (taskId: string, newStatus: string) => void | Promise<void>
+    onAddTask: (title: string, assigneeId: string) => void | Promise<void>
+    onReorderTasks: (draggedTaskId: string, targetTaskId: string) => void | Promise<void>
+    onCancelBreak: (params: { requestId: string; deleteSingleDay: boolean; dateToCancel: string | Date; userId: string }) => void | Promise<void>
+    onRefreshSelectedUserAttendance: () => void | Promise<void>
+    onRefreshAttendanceData: () => void | Promise<void>
+    ...HTMLDivElement attributes
+
+### CorrectionList (CorrectionListProps) — standalone
+    corrections: AttendanceCorrection[] (REQUIRED)
+    currentUserId: string (REQUIRED)
+    userImages: Record<string, string> (REQUIRED)
+    assetsBaseUrl: string (REQUIRED)
+    activeTimeFrame: string (REQUIRED)
+    onApproveCorrection: (correctionId: string) => void | Promise<void>
+    onRejectCorrection: (correctionId: string) => void | Promise<void>
+    ...HTMLDivElement attributes
+
+### RenderDate (RenderDateProps) — standalone
+    day: DayInfo (REQUIRED)
+    isAdmin: boolean (REQUIRED)
+    selectedDate: string | Date (REQUIRED)
+    dateAttendanceMap: Map<string, DateAttendanceInfo> | null (REQUIRED)
+    activeTimeFrame: string (REQUIRED)
+    ...HTMLDivElement attributes
+
+### AdminDashboardSkeleton (DashboardSkeleton)
+    ...HTMLDivElement attributes (className, etc.)
+
+## Supporting Types
+    TaskItem: { id: string; title: string; status: string; assigneeIds?: string; priority?: string }
+    AttendanceCorrection: { id: string; date: string; reason?: string; requestedDate?: string; correctionStatus: CorrectionStatus; user?: AdminUser }
+    DateAttendanceInfo: { status: AttendanceStatus | null; hasCorrectionOrApproval?: boolean; isBreakApproved?: boolean }
+
+## Defaults
+    assetsBaseUrl="", userImages={}, isLoading=false
+
+## Example
+```jsx
+<AdminDashboard.Root
+  currentUserId="user-1"
+  currentUserRole="Admin"
+  currentUser={currentUser}
+  assetsBaseUrl="/assets"
+  userImages={userImageMap}
+  isLoading={isLoading}
+  onAssociateChange={(user) => setSelected(user)}
+>
+  <AdminDashboard.Calendar
+    dateAttendanceMap={dateMap}
+    onDateChange={handleDateChange}
+    onTimeFrameChange={handleTimeFrameChange}
+    users={allUsers}
+    selectedUserAttendance={attendance}
+  />
+  <AdminDashboard.Content>
+    <AdminDashboard.AttendanceOverview
+      groupedAttendance={grouped}
+      users={allUsers}
+    />
+    <AdminDashboard.AssociateDetail
+      attendance={selectedAttendance}
+      tasks={tasks}
+      breakRequest={breakReq}
+      onUpdateAttendanceStatus={handleUpdateStatus}
+      onToggleTaskStatus={handleToggleTask}
+      onAddTask={handleAddTask}
+    />
+    <AdminDashboard.LeaveRequests
+      requests={pendingRequests}
+      corrections={corrections}
+      onApproveBreak={handleApproveBreak}
+      onRejectBreak={handleRejectBreak}
+      onApproveCorrection={handleApproveCorrection}
+      onRejectCorrection={handleRejectCorrection}
+    />
+  </AdminDashboard.Content>
+</AdminDashboard.Root>
+```
+
+## Gotchas
+- All sub-components must be inside `<AdminDashboard.Root>` or they throw a context error
+- `AdminDashboard.AttendanceOverview` only renders when NO associate is selected
+- `AdminDashboard.AssociateDetail` only renders when an associate IS selected
+- `AdminDashboard.LeaveRequests` auto-hides when there are zero requests AND zero pending corrections
+- `AdminDashboard.LeaveRequests` auto-switches tabs when new requests arrive
+- The `Calendar` standalone export is a simpler calendar without the compound context — use it for non-admin pages
+- `BreakRequestCard` standalone export displays a single break with cancel dialog — used inside AssociateDetail internally
+- Date callbacks fire ISO-formatted strings via `format(date, "yyyy-MM-dd'T'HH:mm:ssxxx")`
+- `isLoading=true` on Root renders `DashboardSkeleton` instead of children
+
+## Changes
+### v0.9.0
+- **Added** Compound component API replacing 29-prop monolith (BREAKING)
+- **Added** AdminDashboard.Content wrapper for rounded-corner management
+- **Added** Standalone exports for Calendar, BreakRequestCard, LeaveRequests, DashboardHeader, AttendanceOverview, AssociateDetail, CorrectionList, RenderDate

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

@@ -0,0 +1,167 @@
+# Admin Types
+
+- Import: @devalok/shilp-sutra-karm/admin
+- Server-safe: Yes
+- Category: admin
+
+Type-only exports for the admin module. No runtime code.
+
+## Types
+
+### UserRole
+```ts
+type UserRole = 'Apprentice' | 'Associate' | 'Admin' | 'SuperAdmin'
+```
+
+### AttendanceStatus
+```ts
+type AttendanceStatus = 'PRESENT' | 'ABSENT' | 'BREAK' | 'Not_Marked' | 'HOLIDAY' | 'WEEKEND'
+```
+
+### CorrectionStatus
+```ts
+type CorrectionStatus = 'PENDING' | 'APPROVED' | 'REJECTED'
+```
+
+### BreakRequestStatus
+```ts
+type BreakRequestStatus = 'PENDING' | 'APPROVED' | 'REJECTED' | 'CANCELLED'
+```
+
+### AdminUser
+```ts
+interface AdminUser {
+  id: string
+  name: string
+  firstName?: string
+  lastName?: string
+  email: string
+  devalokEmail?: string
+  designation: string | null
+  image: string | null
+  role: UserRole
+  isActive: boolean
+  createdAt: string | Date
+}
+```
+
+### AttendanceRecord
+```ts
+interface AttendanceRecord {
+  id: string
+  userId: string
+  date: string
+  timeIn: string | null
+  timeOut: string | null
+  status: AttendanceStatus
+  correctionStatus?: CorrectionStatus | null
+  reason?: string | null
+  adminComment?: string | null
+  requestedDate?: string | null
+  newTimeIn?: string | null
+  newTimeOut?: string | null
+  oldTimeIn?: string | null
+  oldTimeOut?: string | null
+  user?: AdminUser
+}
+```
+
+### BreakRequest
+```ts
+interface BreakRequest {
+  id: string
+  userId: string
+  startDate: string
+  endDate: string
+  numberOfDays: number
+  reason: string
+  status: BreakRequestStatus
+  adminComment?: string | null
+  correction?: boolean
+  user?: Pick<AdminUser, 'id' | 'name' | 'firstName' | 'image'>
+}
+```
+
+### BreakBalanceData
+```ts
+interface BreakBalanceData {
+  id: string
+  userId: string
+  totalDays: number
+  usedDays?: number
+  carryForward: number
+  cashout: number
+  yearlyBalance?: number
+  other?: number
+  user?: Pick<AdminUser, 'id' | 'name' | 'firstName' | 'image'>
+  createdAt: string
+  updatedAt: string
+}
+```
+
+### Adjustment
+```ts
+interface Adjustment {
+  id: string
+  userId: string
+  numberOfDays: number
+  type: string
+  reason: string
+  status: string
+  comment: string | null
+  approvedBy: string | null
+  createdAt: string
+  updatedAt: string
+  user?: Pick<AdminUser, 'name' | 'email'>
+  approver?: Pick<AdminUser, 'name' | 'email'>
+}
+```
+
+### GroupedAttendance
+```ts
+interface GroupedAttendance {
+  present: Array<{ user: AdminUser; attendance: AttendanceRecord }>
+  absent: Array<{ user: AdminUser; attendance?: AttendanceRecord }>
+  onBreak: Array<{ user: AdminUser; attendance: AttendanceRecord; breakRequest?: BreakRequest }>
+  yetToMark: Array<{ user: AdminUser }>
+}
+```
+
+### DayInfo
+```ts
+interface DayInfo {
+  day: string
+  date: number
+  fullDate: Date
+  isToday: boolean
+  isActive: boolean
+  isPadding?: boolean
+  hasBreak?: boolean
+  isAbsent?: boolean
+  isDisabled?: boolean
+}
+```
+
+### RealtimeCallbacks
+```ts
+interface RealtimeCallbacks {
+  onBreakRequestCreated?: (data: BreakRequest) => void
+  onBreakRequestApproved?: (data: BreakRequest) => void
+  onBreakRequestRejected?: (data: BreakRequest) => void
+  onBreakRequestCancelled?: (data: BreakRequest) => void
+  onAttendanceCorrectionCreated?: (data: AttendanceRecord) => void
+  onAttendanceCorrectionProcessed?: (data: AttendanceRecord) => void
+  onTaskUpdated?: (data: unknown) => void
+}
+```
+
+## Gotchas
+- `AttendanceStatus` includes `'Not_Marked'` (mixed case with underscore) — not `'NOT_MARKED'`
+- `BreakRequest.correction` is a boolean flag that indicates the request is an attendance correction, not a break
+- `AdminUser.designation` and `AdminUser.image` are nullable (`string | null`)
+- `AdminUser.createdAt` accepts both `string` and `Date`
+- `DayInfo` is used by the calendar components — `isPadding` marks days from adjacent months
+
+## Changes
+### v0.9.0
+- **Added** Initial release with all admin domain types