@devalok/shilp-sutra 0.34.1 → 0.36.0

package/docs/components/ui/data-table-toolbar.md

@@ -1,44 +1,44 @@
-# DataTableToolbar
-
-- Import: @devalok/shilp-sutra/ui/data-table-toolbar
-- Server-safe: No
-- Category: ui
-
-## Props
-    table: Table<TData> (TanStack table instance)
-    globalFilter: boolean
-    globalFilterValue: string
-    onGlobalFilterChange: (value: string) => void
-    density: 'compact' | 'standard' | 'comfortable'
-    onDensityChange: (density: Density) => void
-    enableExport: boolean
-
-## Defaults
-    none
-
-## Example
-```jsx
-import { DataTableToolbar } from '@devalok/shilp-sutra/ui/data-table-toolbar'
-
-<DataTableToolbar
-  table={table}
-  globalFilter
-  globalFilterValue={filterValue}
-  onGlobalFilterChange={setFilterValue}
-  density={density}
-  onDensityChange={setDensity}
-  enableExport
-/>
-```
-
-## Gotchas
-- Barrel-isolated since v0.5.0 — must use `@devalok/shilp-sutra/ui/data-table-toolbar`, NOT the `ui` barrel
-- Companion to DataTable — provides column visibility, density toggle, and CSV export controls
-- Requires @tanstack/react-table as a peer dependency
-
-## Changes
-### v0.5.0
-- **Changed** (BREAKING) Removed from `@devalok/shilp-sutra/ui` barrel export — must use `@devalok/shilp-sutra/ui/data-table-toolbar`
-
-### v0.1.0
-- **Added** Initial release
+# DataTableToolbar
+
+- Import: @devalok/shilp-sutra/ui/data-table-toolbar
+- Server-safe: No
+- Category: ui
+
+## Props
+    table: Table<TData> (TanStack table instance)
+    globalFilter: boolean
+    globalFilterValue: string
+    onGlobalFilterChange: (value: string) => void
+    density: 'compact' | 'standard' | 'comfortable'
+    onDensityChange: (density: Density) => void
+    enableExport: boolean
+
+## Defaults
+    none
+
+## Example
+```jsx
+import { DataTableToolbar } from '@devalok/shilp-sutra/ui/data-table-toolbar'
+
+<DataTableToolbar
+  table={table}
+  globalFilter
+  globalFilterValue={filterValue}
+  onGlobalFilterChange={setFilterValue}
+  density={density}
+  onDensityChange={setDensity}
+  enableExport
+/>
+```
+
+## Gotchas
+- Barrel-isolated since v0.5.0 — must use `@devalok/shilp-sutra/ui/data-table-toolbar`, NOT the `ui` barrel
+- Companion to DataTable — provides column visibility, density toggle, and CSV export controls
+- Requires @tanstack/react-table as a peer dependency
+
+## Changes
+### v0.5.0
+- **Changed** (BREAKING) Removed from `@devalok/shilp-sutra/ui` barrel export — must use `@devalok/shilp-sutra/ui/data-table-toolbar`
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/data-table.md

@@ -1,94 +1,94 @@
-# DataTable
-
-- Import: @devalok/shilp-sutra/ui/data-table
-- Server-safe: No
-- Category: ui
-
-## Props
-    columns: ColumnDef<TData>[] (TanStack column definitions)
-    data: TData[]
-    sortable: boolean — enable column sorting
-    onSort: (key: string, dir: 'asc' | 'desc' | false) => void — server-side sort callback (enables manualSorting)
-    filterable: boolean — enable per-column filters
-    globalFilter: boolean — enable global search
-    paginated: boolean — enable client-side pagination
-    pagination: { page: number, pageSize: number, total: number, onPageChange: (page: number) => void } — server-side pagination (1-based page)
-    pageSize: number (default 10)
-    selectable: boolean — enable row selection with checkboxes
-    selectedIds: Set<string> — controlled selection state
-    selectableFilter: (row: TData) => boolean — disable selection on certain rows
-    getRowId: (row: TData) => string — custom row ID accessor
-    onSelectionChange: (selectedRows: TData[]) => void
-    expandable: boolean — enable row expansion
-    renderExpanded: (row: TData) => ReactNode — expanded row content
-    singleExpand: boolean — only one row expanded at a time
-    loading: boolean — show skeleton shimmer rows
-    emptyState: ReactNode — custom empty state (takes precedence over noResultsText)
-    noResultsText: string (default "No results.")
-    stickyHeader: boolean — sticky table header
-    onRowClick: (row: TData) => void — row click handler (excludes interactive element clicks)
-    bulkActions: BulkAction<TData>[] — floating action bar on selection — { label, onClick, color?: 'default'|'error', disabled? }
-    toolbar: boolean — show DataTableToolbar (column visibility, density, CSV export)
-    editable: boolean — enable double-click cell editing
-    virtualRows: boolean — virtualize rows for large datasets
-    columnPinning: { left?: string[], right?: string[] }
-    defaultDensity: 'compact' | 'standard' | 'comfortable'
-
-## Defaults
-    pageSize=10, noResultsText="No results."
-
-## Example
-```jsx
-import { DataTable } from '@devalok/shilp-sutra/ui/data-table'
-
-<DataTable
-  columns={[
-    { accessorKey: 'name', header: 'Name' },
-    { accessorKey: 'email', header: 'Email' },
-  ]}
-  data={users}
-  sortable
-  onSort={(key, dir) => handleSort(key, dir)}
-  pagination={{ page, pageSize: 20, total: totalCount, onPageChange: setPage }}
-  loading={isLoading}
-  emptyState={<EmptyState title="No users" />}
-/>
-```
-
-## Gotchas
-- Barrel-isolated since v0.5.0 — must use `@devalok/shilp-sutra/ui/data-table`, NOT the `ui` barrel
-- Requires @tanstack/react-table and @tanstack/react-virtual as peer dependencies
-- When onSort is provided, sorting is manual (server-side) — rows stay in data order
-- When pagination prop is provided, pagination is manual — pass total count
-- selectedIds syncs via useEffect — provide getRowId for custom row IDs
-- onRowClick does NOT fire when clicking checkboxes, buttons, links, or inputs
-- Use defaultDensity="compact" for Karm-style h-9 rows
-
-## Changes
-### v0.29.0
-- **Fixed** Controlled selection infinite re-render loop — inline `getRowId` callback caused `onSelectionChange` effect to fire every render, creating a setState cycle with `selectedIds`. Now uses a stable ref for `getRowId`.
-
-### v0.16.1
-- **Fixed** `serverPagination` object reference in `useCallback` dependency caused stale closure — now uses stable ref for `onPageChange`
-- **Fixed** `onSelectionChange` effect fired every render due to `table` in dependency array — now derives selected rows directly
-- **Fixed** `selectedRows` useMemo for bulk actions had same `table` dependency issue
-
-### v0.16.0
-- **Added** `onSort` callback for server-side sorting
-- **Added** `emptyState` ReactNode slot
-- **Added** `loading` prop with shimmer skeleton rows
-- **Added** `selectedIds` + `selectableFilter` for controlled selection
-- **Added** `pagination` prop for server-side pagination
-- **Added** `singleExpand` prop
-- **Added** `stickyHeader` prop
-- **Added** `onRowClick` handler
-- **Added** `bulkActions` floating action bar
-
-### v0.5.0
-- **Changed** (BREAKING) Removed from `@devalok/shilp-sutra/ui` barrel export — must use `@devalok/shilp-sutra/ui/data-table`
-
-### v0.1.1
-- **Fixed** `useEffect` exhaustive-deps with proper dependency array
-
-### v0.1.0
-- **Added** Initial release
+# DataTable
+
+- Import: @devalok/shilp-sutra/ui/data-table
+- Server-safe: No
+- Category: ui
+
+## Props
+    columns: ColumnDef<TData>[] (TanStack column definitions)
+    data: TData[]
+    sortable: boolean — enable column sorting
+    onSort: (key: string, dir: 'asc' | 'desc' | false) => void — server-side sort callback (enables manualSorting)
+    filterable: boolean — enable per-column filters
+    globalFilter: boolean — enable global search
+    paginated: boolean — enable client-side pagination
+    pagination: { page: number, pageSize: number, total: number, onPageChange: (page: number) => void } — server-side pagination (1-based page)
+    pageSize: number (default 10)
+    selectable: boolean — enable row selection with checkboxes
+    selectedIds: Set<string> — controlled selection state
+    selectableFilter: (row: TData) => boolean — disable selection on certain rows
+    getRowId: (row: TData) => string — custom row ID accessor
+    onSelectionChange: (selectedRows: TData[]) => void
+    expandable: boolean — enable row expansion
+    renderExpanded: (row: TData) => ReactNode — expanded row content
+    singleExpand: boolean — only one row expanded at a time
+    loading: boolean — show skeleton shimmer rows
+    emptyState: ReactNode — custom empty state (takes precedence over noResultsText)
+    noResultsText: string (default "No results.")
+    stickyHeader: boolean — sticky table header
+    onRowClick: (row: TData) => void — row click handler (excludes interactive element clicks)
+    bulkActions: BulkAction<TData>[] — floating action bar on selection — { label, onClick, color?: 'default'|'error', disabled? }
+    toolbar: boolean — show DataTableToolbar (column visibility, density, CSV export)
+    editable: boolean — enable double-click cell editing
+    virtualRows: boolean — virtualize rows for large datasets
+    columnPinning: { left?: string[], right?: string[] }
+    defaultDensity: 'compact' | 'standard' | 'comfortable'
+
+## Defaults
+    pageSize=10, noResultsText="No results."
+
+## Example
+```jsx
+import { DataTable } from '@devalok/shilp-sutra/ui/data-table'
+
+<DataTable
+  columns={[
+    { accessorKey: 'name', header: 'Name' },
+    { accessorKey: 'email', header: 'Email' },
+  ]}
+  data={users}
+  sortable
+  onSort={(key, dir) => handleSort(key, dir)}
+  pagination={{ page, pageSize: 20, total: totalCount, onPageChange: setPage }}
+  loading={isLoading}
+  emptyState={<EmptyState title="No users" />}
+/>
+```
+
+## Gotchas
+- Barrel-isolated since v0.5.0 — must use `@devalok/shilp-sutra/ui/data-table`, NOT the `ui` barrel
+- Requires @tanstack/react-table and @tanstack/react-virtual as peer dependencies
+- When onSort is provided, sorting is manual (server-side) — rows stay in data order
+- When pagination prop is provided, pagination is manual — pass total count
+- selectedIds syncs via useEffect — provide getRowId for custom row IDs
+- onRowClick does NOT fire when clicking checkboxes, buttons, links, or inputs
+- Use defaultDensity="compact" for Karm-style h-9 rows
+
+## Changes
+### v0.29.0
+- **Fixed** Controlled selection infinite re-render loop — inline `getRowId` callback caused `onSelectionChange` effect to fire every render, creating a setState cycle with `selectedIds`. Now uses a stable ref for `getRowId`.
+
+### v0.16.1
+- **Fixed** `serverPagination` object reference in `useCallback` dependency caused stale closure — now uses stable ref for `onPageChange`
+- **Fixed** `onSelectionChange` effect fired every render due to `table` in dependency array — now derives selected rows directly
+- **Fixed** `selectedRows` useMemo for bulk actions had same `table` dependency issue
+
+### v0.16.0
+- **Added** `onSort` callback for server-side sorting
+- **Added** `emptyState` ReactNode slot
+- **Added** `loading` prop with shimmer skeleton rows
+- **Added** `selectedIds` + `selectableFilter` for controlled selection
+- **Added** `pagination` prop for server-side pagination
+- **Added** `singleExpand` prop
+- **Added** `stickyHeader` prop
+- **Added** `onRowClick` handler
+- **Added** `bulkActions` floating action bar
+
+### v0.5.0
+- **Changed** (BREAKING) Removed from `@devalok/shilp-sutra/ui` barrel export — must use `@devalok/shilp-sutra/ui/data-table`
+
+### v0.1.1
+- **Fixed** `useEffect` exhaustive-deps with proper dependency array
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/dialog.md

@@ -1,54 +1,54 @@
-# Dialog
-
-- Import: @devalok/shilp-sutra/ui/dialog
-- Server-safe: No
-- Category: ui
-
-## Compound Components
-    Dialog (root)
-      DialogTrigger
-      DialogContent
-        DialogHeader
-          DialogTitle
-          DialogDescription
-        [body content]
-        DialogFooter
-      DialogClose
-
-## Defaults
-    none
-
-## Example
-```jsx
-<Dialog>
-  <DialogTrigger asChild><Button>Open</Button></DialogTrigger>
-  <DialogContent>
-    <DialogHeader>
-      <DialogTitle>Edit Profile</DialogTitle>
-      <DialogDescription>Make changes to your profile.</DialogDescription>
-    </DialogHeader>
-    <div>Form fields here</div>
-    <DialogFooter>
-      <Button>Save</Button>
-    </DialogFooter>
-  </DialogContent>
-</Dialog>
-```
-
-## Gotchas
-- DialogTitle is required for accessibility — screen readers announce it when the dialog opens
-
-## Changes
-### v0.19.1
-- **Fixed** Dialog not centered after Framer Motion animation completes — `transform: none` inline style overrode Tailwind `translate-x/y` classes. Centering now handled via Framer Motion `x`/`y` properties.
-
-### v0.18.0
-- **Changed** Overlay animations migrated to Framer Motion (physics-based springs)
-- **Added** `DialogContentProps`, `DialogTitleProps` type exports
-- **Fixed** Context provider value wrapped in `useMemo` for performance
-
-### v0.3.0
-- **Fixed** DialogHeader/Footer now support ref forwarding
-
-### v0.1.0
-- **Added** Initial release
+# Dialog
+
+- Import: @devalok/shilp-sutra/ui/dialog
+- Server-safe: No
+- Category: ui
+
+## Compound Components
+    Dialog (root)
+      DialogTrigger
+      DialogContent
+        DialogHeader
+          DialogTitle
+          DialogDescription
+        [body content]
+        DialogFooter
+      DialogClose
+
+## Defaults
+    none
+
+## Example
+```jsx
+<Dialog>
+  <DialogTrigger asChild><Button>Open</Button></DialogTrigger>
+  <DialogContent>
+    <DialogHeader>
+      <DialogTitle>Edit Profile</DialogTitle>
+      <DialogDescription>Make changes to your profile.</DialogDescription>
+    </DialogHeader>
+    <div>Form fields here</div>
+    <DialogFooter>
+      <Button>Save</Button>
+    </DialogFooter>
+  </DialogContent>
+</Dialog>
+```
+
+## Gotchas
+- DialogTitle is required for accessibility — screen readers announce it when the dialog opens
+
+## Changes
+### v0.19.1
+- **Fixed** Dialog not centered after Framer Motion animation completes — `transform: none` inline style overrode Tailwind `translate-x/y` classes. Centering now handled via Framer Motion `x`/`y` properties.
+
+### v0.18.0
+- **Changed** Overlay animations migrated to Framer Motion (physics-based springs)
+- **Added** `DialogContentProps`, `DialogTitleProps` type exports
+- **Fixed** Context provider value wrapped in `useMemo` for performance
+
+### v0.3.0
+- **Fixed** DialogHeader/Footer now support ref forwarding
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/dropdown-menu.md

@@ -1,48 +1,48 @@
-# DropdownMenu
-
-- Import: @devalok/shilp-sutra/ui/dropdown-menu
-- Server-safe: No
-- Category: ui
-
-## Compound Components
-    DropdownMenu (root)
-      DropdownMenuTrigger
-      DropdownMenuContent
-        DropdownMenuLabel
-        DropdownMenuSeparator
-        DropdownMenuItem (+ DropdownMenuShortcut for keyboard hints)
-        DropdownMenuCheckboxItem
-        DropdownMenuRadioGroup > DropdownMenuRadioItem
-        DropdownMenuGroup
-        DropdownMenuSub > DropdownMenuSubTrigger, DropdownMenuSubContent
-
-## Defaults
-    none
-
-## Example
-```jsx
-<DropdownMenu>
-  <DropdownMenuTrigger asChild><Button variant="ghost">Menu</Button></DropdownMenuTrigger>
-  <DropdownMenuContent>
-    <DropdownMenuItem>Profile</DropdownMenuItem>
-    <DropdownMenuSeparator />
-    <DropdownMenuItem>Logout</DropdownMenuItem>
-  </DropdownMenuContent>
-</DropdownMenu>
-```
-
-## Gotchas
-- Use `asChild` on DropdownMenuTrigger to render your own button element
-
-## Changes
-### v0.22.0
-- **Added** Hover state on `DropdownMenuItem` — was completely missing. Items now show `bg-surface-3` on hover with `ease-productive-standard` transition.
-
-### v0.18.0
-- **Added** `DropdownMenuContentProps`, `DropdownMenuItemProps` type exports
-
-### v0.14.0
-- **Changed** z-index promoted from `z-dropdown` (1000) to `z-popover` (1400) — fixes dropdown rendering behind Sheet/Dialog overlays
-
-### v0.1.0
-- **Added** Initial release
+# DropdownMenu
+
+- Import: @devalok/shilp-sutra/ui/dropdown-menu
+- Server-safe: No
+- Category: ui
+
+## Compound Components
+    DropdownMenu (root)
+      DropdownMenuTrigger
+      DropdownMenuContent
+        DropdownMenuLabel
+        DropdownMenuSeparator
+        DropdownMenuItem (+ DropdownMenuShortcut for keyboard hints)
+        DropdownMenuCheckboxItem
+        DropdownMenuRadioGroup > DropdownMenuRadioItem
+        DropdownMenuGroup
+        DropdownMenuSub > DropdownMenuSubTrigger, DropdownMenuSubContent
+
+## Defaults
+    none
+
+## Example
+```jsx
+<DropdownMenu>
+  <DropdownMenuTrigger asChild><Button variant="ghost">Menu</Button></DropdownMenuTrigger>
+  <DropdownMenuContent>
+    <DropdownMenuItem>Profile</DropdownMenuItem>
+    <DropdownMenuSeparator />
+    <DropdownMenuItem>Logout</DropdownMenuItem>
+  </DropdownMenuContent>
+</DropdownMenu>
+```
+
+## Gotchas
+- Use `asChild` on DropdownMenuTrigger to render your own button element
+
+## Changes
+### v0.22.0
+- **Added** Hover state on `DropdownMenuItem` — was completely missing. Items now show `bg-surface-3` on hover with `ease-productive-standard` transition.
+
+### v0.18.0
+- **Added** `DropdownMenuContentProps`, `DropdownMenuItemProps` type exports
+
+### v0.14.0
+- **Changed** z-index promoted from `z-dropdown` (1000) to `z-popover` (1400) — fixes dropdown rendering behind Sheet/Dialog overlays
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/file-upload.md

@@ -1,41 +1,41 @@
-# FileUpload
-
-- Import: @devalok/shilp-sutra/ui/file-upload
-- Server-safe: No
-- Category: ui
-
-## Props
-    onFiles: (files: File[]) => void (REQUIRED)
-    accept: string (MIME or extension, e.g. "image/*", ".pdf,.doc")
-    maxSize: number (bytes, default: 10MB)
-    multiple: boolean
-    uploading: boolean
-    progress: number (0-100)
-    error: string
-    compact: boolean (inline button mode vs drop zone)
-    disabled: boolean
-    label: string
-    sublabel: string
-
-## Defaults
-    compact: false
-    maxSize: 10MB (10485760 bytes)
-
-## Example
-```jsx
-<FileUpload
-  accept="image/*"
-  maxSize={2 * 1024 * 1024}
-  onFiles={(files) => uploadAvatar(files[0])}
-  label="Upload profile photo"
-  sublabel="PNG, JPG up to 2MB"
-/>
-```
-
-## Gotchas
-- compact=true renders a small inline button; false (default) renders a large drag-and-drop zone
-- Client-side validation: invalid files are rejected before onFiles is called
-
-## Changes
-### v0.1.0
-- **Added** Initial release
+# FileUpload
+
+- Import: @devalok/shilp-sutra/ui/file-upload
+- Server-safe: No
+- Category: ui
+
+## Props
+    onFiles: (files: File[]) => void (REQUIRED)
+    accept: string (MIME or extension, e.g. "image/*", ".pdf,.doc")
+    maxSize: number (bytes, default: 10MB)
+    multiple: boolean
+    uploading: boolean
+    progress: number (0-100)
+    error: string
+    compact: boolean (inline button mode vs drop zone)
+    disabled: boolean
+    label: string
+    sublabel: string
+
+## Defaults
+    compact: false
+    maxSize: 10MB (10485760 bytes)
+
+## Example
+```jsx
+<FileUpload
+  accept="image/*"
+  maxSize={2 * 1024 * 1024}
+  onFiles={(files) => uploadAvatar(files[0])}
+  label="Upload profile photo"
+  sublabel="PNG, JPG up to 2MB"
+/>
+```
+
+## Gotchas
+- compact=true renders a small inline button; false (default) renders a large drag-and-drop zone
+- Client-side validation: invalid files are rejected before onFiles is called
+
+## Changes
+### v0.1.0
+- **Added** Initial release