@devalok/shilp-sutra 0.18.1 → 0.18.2

package/docs/components/ui/toggle.md

@@ -0,0 +1,37 @@
+# Toggle
+
+- Import: @devalok/shilp-sutra/ui/toggle
+- Server-safe: No
+- Category: ui
+
+## Props
+    variant: "default" | "outline"
+    size: "sm" | "md" | "lg"
+    pressed: boolean
+    onPressedChange: (pressed: boolean) => void
+    defaultPressed: boolean
+
+## Defaults
+    variant: "default"
+    size: "md"
+
+## Example
+```jsx
+<Toggle aria-label="Toggle bold" pressed={isBold} onPressedChange={setIsBold}>
+  <IconBold />
+</Toggle>
+```
+
+## Gotchas
+- Always provide aria-label for accessibility
+
+## Changes
+### v0.18.0
+- **Changed** Migrated to Framer Motion press spring animation
+
+### v0.4.2
+- **Fixed** `className` was passed inside CVA (silently dropped) — now separate `cn()` argument
+- **Added** `ToggleProps` type export
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/tooltip.md

@@ -0,0 +1,33 @@
+# Tooltip
+
+- Import: @devalok/shilp-sutra/ui/tooltip
+- Server-safe: No
+- Category: ui
+
+## Compound Components
+    TooltipProvider (REQUIRED at layout root or wrapping tooltip usage, controls delay)
+      Tooltip (root)
+        TooltipTrigger
+        TooltipContent
+
+## Example
+```jsx
+<TooltipProvider>
+  <Tooltip>
+    <TooltipTrigger asChild><Button>Hover me</Button></TooltipTrigger>
+    <TooltipContent>Tooltip text</TooltipContent>
+  </Tooltip>
+</TooltipProvider>
+```
+
+## Gotchas
+- TooltipProvider is REQUIRED — without it, tooltips won't show
+
+## Changes
+### v0.18.0
+- **Changed** Migrated to Framer Motion for enter/exit animations
+- **Added** `TooltipContentProps` type export
+- **Fixed** Wrapped Tooltip context provider value in `useMemo` for performance
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/tree-view.md

@@ -0,0 +1,65 @@
+# TreeView / TreeItem
+
+- Import: @devalok/shilp-sutra/ui/tree-view
+- Server-safe: No
+- Category: ui
+
+## Props
+### TreeView
+    items: TreeNode[] (data-driven mode) — { id, label, icon?, disabled?, children? }
+    defaultExpanded: string[]
+    defaultSelected: string[]
+    multiSelect: boolean
+    checkboxes: boolean
+    onSelect: (ids: string[]) => void
+    onExpand: (ids: string[]) => void
+    children: ReactNode (declarative mode)
+
+### TreeItem
+    itemId: string (REQUIRED)
+    label: ReactNode
+    secondaryLabel: ReactNode
+    icon: ReactNode
+    actions: ReactNode
+    disabled: boolean
+    depth: number
+    children: ReactNode (nested TreeItems)
+
+## Hook
+    useTree({ defaultExpanded, defaultSelected, multiSelect, onSelect, onExpand })
+
+## Example (data-driven)
+```jsx
+<TreeView
+  items={[
+    { id: '1', label: 'Folder', children: [
+      { id: '1.1', label: 'File A' },
+      { id: '1.2', label: 'File B' },
+    ]},
+  ]}
+  defaultExpanded={['1']}
+  onSelect={(ids) => console.log(ids)}
+/>
+```
+
+## Example (declarative)
+```jsx
+<TreeView>
+  <TreeItem itemId="1" label="Folder">
+    <TreeItem itemId="1.1" label="File A" />
+  </TreeItem>
+</TreeView>
+```
+
+## Gotchas
+- Supports both data-driven (items prop) and declarative (children) modes
+
+## Changes
+### v0.4.2
+- **Added** TreeItem now accepts `className` prop
+
+### v0.3.0
+- **Added** Per-component export: `./ui/tree-view`
+
+### v0.1.0
+- **Added** Initial release

package/docs/components/ui/visually-hidden.md

@@ -0,0 +1,21 @@
+# VisuallyHidden
+
+- Import: @devalok/shilp-sutra/ui/visually-hidden
+- Server-safe: Yes
+- Category: ui
+
+## Props
+    standard span attributes
+
+## Example
+```jsx
+<VisuallyHidden>Screen reader only text</VisuallyHidden>
+```
+
+## Gotchas
+- Content is visually hidden but accessible to screen readers
+- Useful for providing accessible labels without visual UI
+
+## Changes
+### v0.1.0
+- **Added** Initial release

package/llms-full.txt

@@ -5,7 +5,7 @@
 > All variant values and props verified from source CVA definitions.
 >
 > Package: @devalok/shilp-sutra
-> Version: 0.18.1
+> Version: 0.18.2
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devalok/shilp-sutra",
-  "version": "0.18.1",
+  "version": "0.18.2",
   "description": "Devalok Design System — tokens, components, and patterns for Next.js",
   "license": "MIT",
   "type": "module",
@@ -555,10 +555,12 @@
       "import": "./dist/motion/primitives-index.js",
       "default": "./dist/motion/primitives-index.js",
       "types": "./dist/motion/primitives-index.d.ts"
-    }
+    },
+    "./docs/*": "./docs/components/*"
   },
   "files": [
     "dist",
+    "docs/components",
     "fonts",
     "README.md",
     "llms.txt",