@devalok/shilp-sutra 0.34.1 → 0.36.0

package/docs/components/ui/menubar.md

@@ -1,44 +1,44 @@
-# Menubar
-
-- Import: @devalok/shilp-sutra/ui/menubar
-- Server-safe: No
-- Category: ui
-
-## Compound Components
-    Menubar (root)
-      MenubarMenu
-        MenubarTrigger
-        MenubarContent
-          MenubarItem (+ MenubarShortcut)
-          MenubarCheckboxItem
-          MenubarRadioGroup > MenubarRadioItem
-          MenubarLabel
-          MenubarSeparator
-          MenubarSub > MenubarSubTrigger, MenubarSubContent
-
-## Example
-```jsx
-<Menubar>
-  <MenubarMenu>
-    <MenubarTrigger>File</MenubarTrigger>
-    <MenubarContent>
-      <MenubarItem>New<MenubarShortcut>Ctrl+N</MenubarShortcut></MenubarItem>
-      <MenubarSeparator />
-      <MenubarItem>Exit</MenubarItem>
-    </MenubarContent>
-  </MenubarMenu>
-</Menubar>
-```
-
-## Gotchas
-- Follows the standard Radix Menubar compound pattern
-
-## Changes
-### v0.18.0
-- **Added** `MenubarContentProps`, `MenubarItemProps` type exports
-
-### v0.14.0
-- **Changed** z-index promoted from `z-dropdown` (1000) to `z-popover` (1400) — fixes content rendering behind Sheet/Dialog overlays
-
-### v0.1.0
-- **Added** Initial release
+# Menubar
+
+- Import: @devalok/shilp-sutra/ui/menubar
+- Server-safe: No
+- Category: ui
+
+## Compound Components
+    Menubar (root)
+      MenubarMenu
+        MenubarTrigger
+        MenubarContent
+          MenubarItem (+ MenubarShortcut)
+          MenubarCheckboxItem
+          MenubarRadioGroup > MenubarRadioItem
+          MenubarLabel
+          MenubarSeparator
+          MenubarSub > MenubarSubTrigger, MenubarSubContent
+
+## Example
+```jsx
+<Menubar>
+  <MenubarMenu>
+    <MenubarTrigger>File</MenubarTrigger>
+    <MenubarContent>
+      <MenubarItem>New<MenubarShortcut>Ctrl+N</MenubarShortcut></MenubarItem>
+      <MenubarSeparator />
+      <MenubarItem>Exit</MenubarItem>
+    </MenubarContent>
+  </MenubarMenu>
+</Menubar>
+```
+
+## Gotchas
+- Follows the standard Radix Menubar compound pattern
+
+## Changes
+### v0.18.0
+- **Added** `MenubarContentProps`, `MenubarItemProps` type exports
+
+### v0.14.0
+- **Changed** z-index promoted from `z-dropdown` (1000) to `z-popover` (1400) — fixes content rendering behind Sheet/Dialog overlays
+
+### v0.1.0
+- **Added** Initial release

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

@@ -1,46 +1,46 @@
-# NavigationMenu
-
-- Import: @devalok/shilp-sutra/ui/navigation-menu
-- Server-safe: No
-- Category: ui
-
-## Compound Components
-    NavigationMenu (root)
-      NavigationMenuList
-        NavigationMenuItem
-          NavigationMenuTrigger (for items with content panels)
-          NavigationMenuContent (dropdown panel)
-          NavigationMenuLink (for direct links)
-      NavigationMenuIndicator
-      NavigationMenuViewport
-
-## Example
-```jsx
-<NavigationMenu>
-  <NavigationMenuList>
-    <NavigationMenuItem>
-      <NavigationMenuTrigger>Products</NavigationMenuTrigger>
-      <NavigationMenuContent>
-        <ul>...</ul>
-      </NavigationMenuContent>
-    </NavigationMenuItem>
-    <NavigationMenuItem>
-      <NavigationMenuLink href="/about">About</NavigationMenuLink>
-    </NavigationMenuItem>
-  </NavigationMenuList>
-</NavigationMenu>
-```
-
-## Gotchas
-- Uses Framer Motion for enter/exit animations (v0.18.0)
-
-## Changes
-### v0.18.0
-- **Changed** Migrated to Framer Motion for enter/exit animations
-- **Added** `NavigationMenuProps`, `NavigationMenuContentProps` type exports
-
-### v0.1.1
-- **Fixed** Token compliance — icon sizes replaced with `h-ico-sm w-ico-sm`
-
-### v0.1.0
-- **Added** Initial release
+# NavigationMenu
+
+- Import: @devalok/shilp-sutra/ui/navigation-menu
+- Server-safe: No
+- Category: ui
+
+## Compound Components
+    NavigationMenu (root)
+      NavigationMenuList
+        NavigationMenuItem
+          NavigationMenuTrigger (for items with content panels)
+          NavigationMenuContent (dropdown panel)
+          NavigationMenuLink (for direct links)
+      NavigationMenuIndicator
+      NavigationMenuViewport
+
+## Example
+```jsx
+<NavigationMenu>
+  <NavigationMenuList>
+    <NavigationMenuItem>
+      <NavigationMenuTrigger>Products</NavigationMenuTrigger>
+      <NavigationMenuContent>
+        <ul>...</ul>
+      </NavigationMenuContent>
+    </NavigationMenuItem>
+    <NavigationMenuItem>
+      <NavigationMenuLink href="/about">About</NavigationMenuLink>
+    </NavigationMenuItem>
+  </NavigationMenuList>
+</NavigationMenu>
+```
+
+## Gotchas
+- Uses Framer Motion for enter/exit animations (v0.18.0)
+
+## Changes
+### v0.18.0
+- **Changed** Migrated to Framer Motion for enter/exit animations
+- **Added** `NavigationMenuProps`, `NavigationMenuContentProps` type exports
+
+### v0.1.1
+- **Fixed** Token compliance — icon sizes replaced with `h-ico-sm w-ico-sm`
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/number-input.md

@@ -1,44 +1,44 @@
-# NumberInput
-
-- Import: @devalok/shilp-sutra/ui/number-input
-- Server-safe: No
-- Category: ui
-
-## Props
-    value: number (default: 0)
-    onValueChange: (value: number) => void
-    min: number
-    max: number
-    step: number (default: 1)
-    disabled: boolean
-
-## Defaults
-    value: 0
-    step: 1
-    min: Number.MIN_SAFE_INTEGER
-    max: Number.MAX_SAFE_INTEGER
-
-## Example
-```jsx
-<NumberInput value={qty} onValueChange={setQty} min={1} max={99} />
-```
-
-## Gotchas
-- Controlled only — buttons won't work without onValueChange
-
-## Changes
-### v0.18.0
-- **Fixed** Replaced `parseInt` with `Number()`, handle empty input
-
-### v0.15.0
-- **Changed** `md` size font standardized to `text-ds-md` (14px)
-
-### v0.8.0
-- **Fixed** FormField context consumption, `aria-label` fallback, `parseInt` radix parameter
-
-### v0.3.0
-- **Changed** (BREAKING) `onChange` renamed to `onValueChange`
-- **Changed** Now extends HTMLAttributes — accepts all standard HTML props
-
-### v0.1.0
-- **Added** Initial release
+# NumberInput
+
+- Import: @devalok/shilp-sutra/ui/number-input
+- Server-safe: No
+- Category: ui
+
+## Props
+    value: number (default: 0)
+    onValueChange: (value: number) => void
+    min: number
+    max: number
+    step: number (default: 1)
+    disabled: boolean
+
+## Defaults
+    value: 0
+    step: 1
+    min: Number.MIN_SAFE_INTEGER
+    max: Number.MAX_SAFE_INTEGER
+
+## Example
+```jsx
+<NumberInput value={qty} onValueChange={setQty} min={1} max={99} />
+```
+
+## Gotchas
+- Controlled only — buttons won't work without onValueChange
+
+## Changes
+### v0.18.0
+- **Fixed** Replaced `parseInt` with `Number()`, handle empty input
+
+### v0.15.0
+- **Changed** `md` size font standardized to `text-ds-md` (14px)
+
+### v0.8.0
+- **Fixed** FormField context consumption, `aria-label` fallback, `parseInt` radix parameter
+
+### v0.3.0
+- **Changed** (BREAKING) `onChange` renamed to `onValueChange`
+- **Changed** Now extends HTMLAttributes — accepts all standard HTML props
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/pagination.md

@@ -1,48 +1,48 @@
-# Pagination
-
-- Import: @devalok/shilp-sutra/ui/pagination
-- Server-safe: No
-- Category: ui
-
-## Compound Components
-    PaginationRoot (nav)
-      PaginationContent (ul)
-        PaginationItem (li)
-          PaginationLink (isActive: boolean, asChild: boolean)
-          PaginationPrevious
-          PaginationNext
-          PaginationEllipsis
-    PaginationNav (convenience wrapper)
-
-## Utility
-    generatePagination(current: number, total: number, siblingCount: number) => (number | 'ellipsis')[]
-
-## Example
-```jsx
-<PaginationRoot>
-  <PaginationContent>
-    <PaginationItem><PaginationPrevious onClick={() => setPage(p - 1)} /></PaginationItem>
-    {generatePagination(page, totalPages, 1).map((item, i) =>
-      item === 'ellipsis'
-        ? <PaginationItem key={i}><PaginationEllipsis /></PaginationItem>
-        : <PaginationItem key={i}>
-            <PaginationLink isActive={item === page} onClick={() => setPage(item)}>
-              {item}
-            </PaginationLink>
-          </PaginationItem>
-    )}
-    <PaginationItem><PaginationNext onClick={() => setPage(p + 1)} /></PaginationItem>
-  </PaginationContent>
-</PaginationRoot>
-```
-
-## Gotchas
-- Root component is PaginationRoot (NOT Pagination)
-
-## Changes
-### v0.1.1
-- **Fixed** Pagination link padding uses `ds-*` tokens instead of Tailwind arbitrary values
-
-### v0.1.0
-- **Added** Initial release
-- **Added** PaginationNav compound wrapper with `generatePagination` helper
+# Pagination
+
+- Import: @devalok/shilp-sutra/ui/pagination
+- Server-safe: No
+- Category: ui
+
+## Compound Components
+    PaginationRoot (nav)
+      PaginationContent (ul)
+        PaginationItem (li)
+          PaginationLink (isActive: boolean, asChild: boolean)
+          PaginationPrevious
+          PaginationNext
+          PaginationEllipsis
+    PaginationNav (convenience wrapper)
+
+## Utility
+    generatePagination(current: number, total: number, siblingCount: number) => (number | 'ellipsis')[]
+
+## Example
+```jsx
+<PaginationRoot>
+  <PaginationContent>
+    <PaginationItem><PaginationPrevious onClick={() => setPage(p - 1)} /></PaginationItem>
+    {generatePagination(page, totalPages, 1).map((item, i) =>
+      item === 'ellipsis'
+        ? <PaginationItem key={i}><PaginationEllipsis /></PaginationItem>
+        : <PaginationItem key={i}>
+            <PaginationLink isActive={item === page} onClick={() => setPage(item)}>
+              {item}
+            </PaginationLink>
+          </PaginationItem>
+    )}
+    <PaginationItem><PaginationNext onClick={() => setPage(p + 1)} /></PaginationItem>
+  </PaginationContent>
+</PaginationRoot>
+```
+
+## Gotchas
+- Root component is PaginationRoot (NOT Pagination)
+
+## Changes
+### v0.1.1
+- **Fixed** Pagination link padding uses `ds-*` tokens instead of Tailwind arbitrary values
+
+### v0.1.0
+- **Added** Initial release
+- **Added** PaginationNav compound wrapper with `generatePagination` helper

package/docs/components/ui/popover.md

@@ -1,30 +1,30 @@
-# Popover
-
-- Import: @devalok/shilp-sutra/ui/popover
-- Server-safe: No
-- Category: ui
-
-## Compound Components
-    Popover (root)
-      PopoverTrigger
-      PopoverContent
-      PopoverAnchor (optional anchor point)
-
-## Example
-```jsx
-<Popover>
-  <PopoverTrigger asChild><Button>Open</Button></PopoverTrigger>
-  <PopoverContent>Content here</PopoverContent>
-</Popover>
-```
-
-## Gotchas
-- Uses Framer Motion for enter/exit animations (v0.18.0)
-
-## Changes
-### v0.18.0
-- **Changed** Migrated to Framer Motion for enter/exit animations
-- **Added** `PopoverContentProps` type export
-
-### v0.1.0
-- **Added** Initial release
+# Popover
+
+- Import: @devalok/shilp-sutra/ui/popover
+- Server-safe: No
+- Category: ui
+
+## Compound Components
+    Popover (root)
+      PopoverTrigger
+      PopoverContent
+      PopoverAnchor (optional anchor point)
+
+## Example
+```jsx
+<Popover>
+  <PopoverTrigger asChild><Button>Open</Button></PopoverTrigger>
+  <PopoverContent>Content here</PopoverContent>
+</Popover>
+```
+
+## Gotchas
+- Uses Framer Motion for enter/exit animations (v0.18.0)
+
+## Changes
+### v0.18.0
+- **Changed** Migrated to Framer Motion for enter/exit animations
+- **Added** `PopoverContentProps` type export
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/progress-ring.md

@@ -1,41 +1,41 @@
-# ProgressRing
-
-- Import: @devalok/shilp-sutra/ui/progress-ring
-- Server-safe: No
-- Category: ui
-
-## Props
-
-### ProgressRing
-    value: number (current progress value)
-    max: number (maximum value)
-    size: "sm" | "md" | "lg"
-    color: "default" | "success" | "warning" | "error" | "info"
-    showValue: boolean (show percentage text in center)
-    label: string (accessible label — falls back to "{n}% progress")
-
-### MultiProgressRing
-    rings: Array<{ value: number; max?: number; color?: "default" | "success" | "warning" | "error" | "info"; label?: string }>
-    size: "sm" | "md" | "lg"
-
-## Defaults
-    max={100}, size="md", color="default", showValue={false}
-
-## Example
-```jsx
-<ProgressRing value={75} />
-<ProgressRing value={3} max={12} size="lg" color="warning" showValue />
-
-<MultiProgressRing
-  rings={[
-    { value: 80, color: 'error', label: 'Move' },
-    { value: 60, color: 'success', label: 'Exercise' },
-  ]}
-  size="lg"
-/>
-```
-
-## Gotchas
-- Uses Framer Motion for the animated fill — not server-safe
-- Value is clamped to `[0, max]` internally
-- MultiProgressRing skips rings whose computed radius would be <= 0 (too many rings for the size)
+# ProgressRing
+
+- Import: @devalok/shilp-sutra/ui/progress-ring
+- Server-safe: No
+- Category: ui
+
+## Props
+
+### ProgressRing
+    value: number (current progress value)
+    max: number (maximum value)
+    size: "sm" | "md" | "lg"
+    color: "default" | "success" | "warning" | "error" | "info"
+    showValue: boolean (show percentage text in center)
+    label: string (accessible label — falls back to "{n}% progress")
+
+### MultiProgressRing
+    rings: Array<{ value: number; max?: number; color?: "default" | "success" | "warning" | "error" | "info"; label?: string }>
+    size: "sm" | "md" | "lg"
+
+## Defaults
+    max={100}, size="md", color="default", showValue={false}
+
+## Example
+```jsx
+<ProgressRing value={75} />
+<ProgressRing value={3} max={12} size="lg" color="warning" showValue />
+
+<MultiProgressRing
+  rings={[
+    { value: 80, color: 'error', label: 'Move' },
+    { value: 60, color: 'success', label: 'Exercise' },
+  ]}
+  size="lg"
+/>
+```
+
+## Gotchas
+- Uses Framer Motion for the animated fill — not server-safe
+- Value is clamped to `[0, max]` internally
+- MultiProgressRing skips rings whose computed radius would be <= 0 (too many rings for the size)

package/docs/components/ui/progress.md

@@ -1,34 +1,34 @@
-# Progress
-
-- Import: @devalok/shilp-sutra/ui/progress
-- Server-safe: No
-- Category: ui
-
-## Props
-    value: number (0-100) — omit for indeterminate
-    size: "sm" | "md" | "lg" (track height)
-    color: "default" | "success" | "warning" | "error" (indicator color)
-    autoColor: boolean (auto-shifts color by value: 0-59=default, 60-84=warning, 85-100=success, >100=error)
-    showLabel: boolean (shows percentage text)
-    indicatorClassName: string
-
-## Defaults
-    size: "md"
-    color: "default"
-
-## Example
-```jsx
-<Progress value={75} color="success" showLabel />
-<Progress size="sm" />  {/* indeterminate */}
-```
-
-## Gotchas
-- Omit value (or pass undefined) for indeterminate animation
-- `autoColor` overrides `color` when `value` is set — do not pass both unless you want autoColor to win
-
-## Changes
-### v0.29.0
-- **Added** `autoColor` prop — automatically shifts indicator color based on value thresholds (0-59 default, 60-84 warning, 85-100 success, >100 error)
-
-### v0.1.0
-- **Added** Initial release with `size`, `color`, `indeterminate` variants and optional label slot
+# Progress
+
+- Import: @devalok/shilp-sutra/ui/progress
+- Server-safe: No
+- Category: ui
+
+## Props
+    value: number (0-100) — omit for indeterminate
+    size: "sm" | "md" | "lg" (track height)
+    color: "default" | "success" | "warning" | "error" (indicator color)
+    autoColor: boolean (auto-shifts color by value: 0-59=default, 60-84=warning, 85-100=success, >100=error)
+    showLabel: boolean (shows percentage text)
+    indicatorClassName: string
+
+## Defaults
+    size: "md"
+    color: "default"
+
+## Example
+```jsx
+<Progress value={75} color="success" showLabel />
+<Progress size="sm" />  {/* indeterminate */}
+```
+
+## Gotchas
+- Omit value (or pass undefined) for indeterminate animation
+- `autoColor` overrides `color` when `value` is set — do not pass both unless you want autoColor to win
+
+## Changes
+### v0.29.0
+- **Added** `autoColor` prop — automatically shifts indicator color based on value thresholds (0-59 default, 60-84 warning, 85-100 success, >100 error)
+
+### v0.1.0
+- **Added** Initial release with `size`, `color`, `indeterminate` variants and optional label slot

package/docs/components/ui/radio.md

@@ -1,34 +1,34 @@
-# RadioGroup
-
-- Import: @devalok/shilp-sutra/ui/radio
-- Server-safe: No
-- Category: ui
-
-## Compound Components
-    RadioGroup (root, value, onValueChange, defaultValue)
-      RadioGroupItem (value: string, REQUIRED)
-
-## Example
-```jsx
-<RadioGroup defaultValue="option-1" onValueChange={setValue}>
-  <div className="flex items-center gap-2">
-    <RadioGroupItem value="option-1" id="r1" />
-    <Label htmlFor="r1">Option 1</Label>
-  </div>
-  <div className="flex items-center gap-2">
-    <RadioGroupItem value="option-2" id="r2" />
-    <Label htmlFor="r2">Option 2</Label>
-  </div>
-</RadioGroup>
-```
-
-## Gotchas
-- Each RadioGroupItem needs a unique `value` prop
-- Pair each item with a Label for accessibility
-
-## Changes
-### v0.4.2
-- **Added** `RadioGroupProps`, `RadioGroupItemProps` type exports
-
-### v0.1.0
-- **Added** Initial release
+# RadioGroup
+
+- Import: @devalok/shilp-sutra/ui/radio
+- Server-safe: No
+- Category: ui
+
+## Compound Components
+    RadioGroup (root, value, onValueChange, defaultValue)
+      RadioGroupItem (value: string, REQUIRED)
+
+## Example
+```jsx
+<RadioGroup defaultValue="option-1" onValueChange={setValue}>
+  <div className="flex items-center gap-2">
+    <RadioGroupItem value="option-1" id="r1" />
+    <Label htmlFor="r1">Option 1</Label>
+  </div>
+  <div className="flex items-center gap-2">
+    <RadioGroupItem value="option-2" id="r2" />
+    <Label htmlFor="r2">Option 2</Label>
+  </div>
+</RadioGroup>
+```
+
+## Gotchas
+- Each RadioGroupItem needs a unique `value` prop
+- Pair each item with a Label for accessibility
+
+## Changes
+### v0.4.2
+- **Added** `RadioGroupProps`, `RadioGroupItemProps` type exports
+
+### v0.1.0
+- **Added** Initial release