@nexus-cross/design-system 1.0.14 → 1.1.1

package/dist/schemas/dataGrid.json

@@ -0,0 +1,102 @@
+{
+  "$ref": "#/definitions/dataGridPropsSchema",
+  "definitions": {
+    "dataGridPropsSchema": {
+      "type": "object",
+      "properties": {
+        "list": {
+          "anyOf": [
+            {
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "description": "Data array to render. null = loading state (required)"
+        },
+        "columns": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "base": {
+                  "type": "number",
+                  "description": "Default column count (mobile-first)"
+                },
+                "sm": {
+                  "type": "number",
+                  "description": ">= 640px"
+                },
+                "md": {
+                  "type": "number",
+                  "description": ">= 768px"
+                },
+                "lg": {
+                  "type": "number",
+                  "description": ">= 1024px"
+                },
+                "xl": {
+                  "type": "number",
+                  "description": ">= 1280px"
+                },
+                "2xl": {
+                  "type": "number",
+                  "description": ">= 1536px"
+                }
+              },
+              "additionalProperties": false
+            }
+          ],
+          "description": "Column count. number = fixed | { base, sm, md, lg, xl, 2xl } = responsive (required)"
+        },
+        "gap": {
+          "type": [
+            "number",
+            "string"
+          ],
+          "description": "Item gap. number = px | string = CSS value"
+        },
+        "noDataMessage": {
+          "description": "Message for empty array (string | ReactElement)"
+        },
+        "errorFallback": {
+          "description": "Fallback on error (ReactNode)"
+        },
+        "loadingElement": {
+          "description": "Custom loading element (default: Spinner)"
+        },
+        "skeletonElement": {
+          "description": "Skeleton element during loading (ReactElement)"
+        },
+        "skeletonCount": {
+          "type": "number",
+          "default": 3,
+          "description": "Skeleton repeat count"
+        },
+        "loading": {
+          "type": "boolean",
+          "default": false,
+          "description": "Force loading state"
+        },
+        "children": {
+          "description": "Item render function: ({ item, index }) => ReactNode (required)"
+        },
+        "className": {
+          "type": "string",
+          "description": "Root element style"
+        }
+      },
+      "required": [
+        "list",
+        "columns"
+      ],
+      "additionalProperties": false,
+      "description": "DataGrid — card grid version of DataList with responsive columns. Built-in ErrorBoundary, loading/skeleton/empty/error states.\n\nWHEN TO USE:\n  • Card grids: products, gallery, team members, posts\n  • Need responsive column count → pass { base: 1, sm: 2, lg: 3, xl: 4 }\n  • Single column / row layout → DataList\n  • Tabular data → table component (not DataGrid)\n  • Huge dataset → VirtualGrid\n\nANTI-PATTERNS:\n  ✗ Tabular data forced into card grid (use a table)\n  ✗ Hardcoded column count for responsive layouts → use responsive object\n  ✗ Manual loading/empty handling → DataGrid does it"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/schemas/dataList.json

@@ -49,7 +49,7 @@
         "list"
       ],
       "additionalProperties": false,
-      "description": "Data list. Automatically handles loading/skeleton/empty/data states based on list. Built-in ErrorBoundary."
+      "description": "DataList — render-prop list that handles loading / skeleton / empty / error / data in one component. Built-in ErrorBoundary.\n\nWHEN TO USE:\n  • Any async list (<200 items) — feed, comments, dashboard rows\n  • Pass list={null} during loading (auto-shows skeleton/spinner)\n  • Pass list=[] for empty state (auto-shows noDataMessage)\n  • Card grid → DataGrid (same API + columns prop)\n  • Huge dataset → VirtualList\n\nchildren is render fn: ({ item, index }) => ReactNode.\n\nANTI-PATTERNS:\n  ✗ Manual if (loading) {...} else if (!data.length) {...} chains → DataList handles all\n  ✗ DataList without skeletonElement when component shape is known (use Skeleton)\n  ✗ list=undefined (treated as data, not loading) — use null for loading"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/date-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-picker.d.ts","sourceRoot":"","sources":["../../src/schemas/date-picker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAasD,CAAC"}
+{"version":3,"file":"date-picker.d.ts","sourceRoot":"","sources":["../../src/schemas/date-picker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4B/B,CAAC"}

package/dist/schemas/datePicker.json

@@ -49,7 +49,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "DatePicker. Calendar popup for date selection. Based on react-day-picker."
+      "description": "DatePicker — calendar popup for date selection. Based on react-day-picker.\n\nWHEN TO USE:\n  • Single date selection: birthday, due date, appointment\n  • Date range → use two DatePickers with minDate/maxDate cross-bound\n  • Time selection → not yet supported; use TextInput with type=\"time\" + DatePicker combo\n  • Quick relative ranges (Today/Last 7 days) → DropdownMenu of preset Buttons + DatePicker for \"Custom\"\n\nminDate/maxDate disable out-of-range dates. locale=\"ko\" for Korean labels.\n\nANTI-PATTERNS:\n  ✗ Native <input type=\"date\"> for branded UI (inconsistent across browsers) → DatePicker\n  ✗ Free-text date with parsing → DatePicker (consistent UX)\n  ✗ DatePicker without minDate for past-date-invalid fields (e.g. booking)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/divider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"divider.d.ts","sourceRoot":"","sources":["../../src/schemas/divider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAc2C,CAAC"}
+{"version":3,"file":"divider.d.ts","sourceRoot":"","sources":["../../src/schemas/divider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EA4B5B,CAAC"}

package/dist/schemas/divider.json

@@ -36,7 +36,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Divider. Supports horizontal/vertical, solid/dashed/dotted."
+      "description": "Divider — visual separator (horizontal/vertical line).\n\nWHEN TO USE:\n  • Separating sections within a card / list\n  • Vertical separator between inline items (orientation=\"vertical\")\n  • Use color prop sparingly — defaults to border-default token\n  • For grouping form sections, prefer larger spacing over Divider\n  • Tab/Accordion already provide visual separation — don't add Divider\n\nANTI-PATTERNS:\n  ✗ Stacking many Dividers — increase spacing instead\n  ✗ Using Divider as decorative line with bright color → use Tailwind border utility on container\n  ✗ Inline <hr> with custom CSS → Divider (consistent token)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/drawer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drawer.d.ts","sourceRoot":"","sources":["../../src/schemas/drawer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;EAUgD,CAAC;AAE/E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAYF,CAAC;AAEpC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAMF,CAAC;AAEpC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAMA,CAAC;AAEpC,eAAO,MAAM,sBAAsB;;;;;;;;;EAKsB,CAAC;AAE1D,eAAO,MAAM,4BAA4B;;;;;;;;;EAKP,CAAC"}
+{"version":3,"file":"drawer.d.ts","sourceRoot":"","sources":["../../src/schemas/drawer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;EA0B3B,CAAC;AAEJ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAYF,CAAC;AAEpC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAMF,CAAC;AAEpC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAMA,CAAC;AAEpC,eAAO,MAAM,sBAAsB;;;;;;;;;EAKsB,CAAC;AAE1D,eAAO,MAAM,4BAA4B;;;;;;;;;EAKP,CAAC"}

package/dist/schemas/drawer.json

@@ -39,7 +39,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Drawer/bottom sheet. Based on Vaul. Compound component pattern."
+      "description": "Drawer / bottom sheet. Based on Vaul. Compound component pattern.\n\nWHEN TO USE:\n  • Side panel for secondary action while user can still see main content (filter panel, item details)\n  • Mobile bottom sheet (direction=\"bottom\")\n  • Force decision blocking main flow → Modal instead\n  • Inline anchor-positioned UI → Popover instead\n\nDIRECTION: bottom (default, mobile-friendly), top, left, right.\ndismissible=true (default) allows swipe/outside-click close. Set false for blocking flows.\n\nANTI-PATTERNS:\n  ✗ Drawer for confirmation dialogs → Modal (decision-forcing)\n  ✗ Always shouldScaleBackground → only enable for true mobile bottom-sheets\n  ✗ Forgetting Drawer.Title → required for screen readers (a11y)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/dropdown-menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dropdown-menu.d.ts","sourceRoot":"","sources":["../../src/schemas/dropdown-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS0D,CAAC"}
+{"version":3,"file":"dropdown-menu.d.ts","sourceRoot":"","sources":["../../src/schemas/dropdown-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BjC,CAAC"}

package/dist/schemas/dropdownMenu.json

@@ -76,7 +76,7 @@
         "items"
       ],
       "additionalProperties": false,
-      "description": "Dropdown menu. Based on Radix DropdownMenu. Action menu for context/more menus."
+      "description": "Dropdown menu — list of actions/commands triggered by a button. Based on Radix DropdownMenu (role=\"menu\" + keyboard nav).\n\nWHEN TO USE:\n  • \"More\" / context menu (•••, ⋮)\n  • Action lists where each item triggers a function (save, share, delete)\n  • Selecting a value (form field) → Select / Combobox (not DropdownMenu)\n  • Multi-select toggles → ToggleGroup or CheckBox group\n  • Anchored info panel → Popover\n\nUse danger=true on destructive items (Delete) for visual + semantic emphasis.\nUse separator=true to group related actions.\n\nANTI-PATTERNS:\n  ✗ DropdownMenu for value selection submitted later → Select / Combobox\n  ✗ Custom <div onClick> with isOpen state → DropdownMenu\n  ✗ Long form inputs inside menu items → Popover instead"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/ellipsis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ellipsis.d.ts","sourceRoot":"","sources":["../../src/schemas/ellipsis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW6B,CAAC"}
+{"version":3,"file":"ellipsis.d.ts","sourceRoot":"","sources":["../../src/schemas/ellipsis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0B7B,CAAC"}

package/dist/schemas/ellipsis.json

@@ -42,7 +42,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Text ellipsis. Built-in show more/less toggle."
+      "description": "Ellipsis — clamp long text to N lines with \"show more / less\" toggle.\n\nWHEN TO USE:\n  • Long descriptions in cards, comments, post previews\n  • Single-line truncation only → CSS line-clamp utility (lighter)\n  • Tooltip on hover for full text → Tooltip + truncate utility\n  • Critical content that must be fully readable — don't truncate\n\ntriggerMore/triggerLess accept ReactNode for icons or styled buttons.\n\nANTI-PATTERNS:\n  ✗ Ellipsis on titles / labels — confusing UX\n  ✗ Always-collapsed (defaultShortened=true) for short text — measurement waste\n  ✗ Overriding triggerMore/Less with HTML that breaks accessibility (use button-like)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/empty-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"empty-state.d.ts","sourceRoot":"","sources":["../../src/schemas/empty-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAU8C,CAAC"}
+{"version":3,"file":"empty-state.d.ts","sourceRoot":"","sources":["../../src/schemas/empty-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAyB/B,CAAC"}

package/dist/schemas/emptyState.json

@@ -37,7 +37,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Empty state placeholder. Shown when data is empty or unavailable."
+      "description": "EmptyState — friendly placeholder for empty lists, no search results, first-time setup.\n\nWHEN TO USE:\n  • Empty inbox / list / search results\n  • First-time use (onboarding nudge with action button)\n  • Loading → Skeleton/Spinner (NOT EmptyState)\n  • Error → Alert (or pass icon + title to EmptyState only when conceptually \"nothing here\")\n\nDataList/DataGrid have built-in noDataMessage that wraps EmptyState — use that prop instead of conditional rendering.\n\nANTI-PATTERNS:\n  ✗ Showing EmptyState during loading (confuses users into thinking data is missing)\n  ✗ EmptyState without action when user can fix it (\"Create your first X\" button)\n  ✗ Cluttered EmptyState (too much text/multiple CTAs) — keep one primary action"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/error-boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../src/schemas/error-boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EASyD,CAAC"}
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../src/schemas/error-boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAuBlC,CAAC"}

package/dist/schemas/errorBoundary.json

@@ -15,7 +15,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Error boundary. Catches child component render errors and displays fallback UI."
+      "description": "ErrorBoundary — catches render-time errors in subtree and shows fallback UI.\n\nWHEN TO USE:\n  • Wrap risky areas: third-party widgets, dynamic imports, untrusted content rendering\n  • Async errors / promise rejections → NOT caught (use try/catch in handlers)\n  • Per-route error wrapping → use framework's error.tsx (Next.js) where possible\n\nDataList / DataGrid have ErrorBoundary built-in — don't double-wrap.\n\nANTI-PATTERNS:\n  ✗ ErrorBoundary at app root only — granular boundaries give better UX (one widget fails, page survives)\n  ✗ Showing raw Error.message in production (leak risk) — use friendly fallback\n  ✗ Forgetting onError logging → silent failures in production"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/image-upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-upload.d.ts","sourceRoot":"","sources":["../../src/schemas/image-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BhC,CAAC"}
+{"version":3,"file":"image-upload.d.ts","sourceRoot":"","sources":["../../src/schemas/image-upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0ChC,CAAC"}

package/dist/schemas/imageUpload.json

@@ -76,7 +76,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "ImageUpload. Drag-and-drop image upload with preview, file validation, and field label/description support."
+      "description": "ImageUpload — drag-and-drop image upload with preview, file-type/size validation, label/description.\n\nWHEN TO USE:\n  • Single image upload: avatar, cover, KYC document, post thumbnail\n  • Multiple files / non-image → not yet supported; build custom or use a file dropzone\n  • Inline image picker without preview → custom <input type=\"file\">\n\naccept whitelist + maxSize together cover validation. onError fires with i18n-ready string.\n\nANTI-PATTERNS:\n  ✗ <input type=\"file\"> + manual preview → ImageUpload (handles drag, validation, preview)\n  ✗ ImageUpload without onError handler → silent failure on validation reject\n  ✗ Storing image as data-URL value (use File via onChange and upload to server)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/index.d.ts

@@ -3,6 +3,7 @@ export { buttonPropsSchema } from './button';
 export { textInputPropsSchema } from './text-input';
 export { textAreaPropsSchema } from './text-area';
 export { selectPropsSchema, selectItemPropsSchema } from './select';
+export { comboboxPropsSchema, comboboxOptionPropsSchema, comboboxOptionDescriptionPropsSchema, comboboxOptionMetaPropsSchema, } from './combobox';
 export { dropdownMenuPropsSchema } from './dropdown-menu';
 export { toggleGroupPropsSchema } from './toggle-group';
 export { sliderPropsSchema } from './slider';
@@ -35,10 +36,10 @@ export { emptyStatePropsSchema } from './empty-state';
 export { numberInputPropsSchema } from './number-input';
 export { priceInputPropsSchema } from './price-input';
 export { dataListPropsSchema } from './data-list';
+export { dataGridPropsSchema } from './data-grid';
 export { modalTemplatePropsSchema, modalCallSchema } from './modal';
 export { errorBoundaryPropsSchema } from './error-boundary';
 export { clientOnlyPropsSchema } from './client-only';
-export { themeProviderPropsSchema } from './theme-provider';
 export { tablePropsSchema, tableRowPropsSchema, tdColumnPropsSchema, } from './table';
 export { toasterPropsSchema, toastOptionsSchema } from './toast';
 export { tagInputPropsSchema } from './tag-input';

package/dist/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,oCAAoC,EACpC,6BAA6B,GAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/schemas/infinite-scroll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"infinite-scroll.d.ts","sourceRoot":"","sources":["../../src/schemas/infinite-scroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBwB,CAAC"}
+{"version":3,"file":"infinite-scroll.d.ts","sourceRoot":"","sources":["../../src/schemas/infinite-scroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCnC,CAAC"}

package/dist/schemas/infiniteScroll.json

@@ -58,7 +58,7 @@
         "list"
       ],
       "additionalProperties": false,
-      "description": "Infinite scroll. Based on IntersectionObserver."
+      "description": "InfiniteScroll — auto-load more when sentinel enters viewport. Based on IntersectionObserver.\n\nWHEN TO USE:\n  • Feeds, social timelines, search-as-you-scroll\n  • Continuous browsing where total isn't critical\n  • Need jump-to-page → Pagination (not InfiniteScroll)\n  • Need to render 1000s of already-loaded items efficiently → VirtualList\n  • Combine with VirtualList for huge + paginated data\n\nPass either totalCount or hasMore (not both). handleLoadMore is required.\n\nANTI-PATTERNS:\n  ✗ InfiniteScroll without footer/loading element (looks broken at the bottom)\n  ✗ InfiniteScroll without debouncing handleLoadMore — duplicate fetches\n  ✗ Auto-loading critical actions in footer (links, contact) — they become unreachable"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/marquee.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"marquee.d.ts","sourceRoot":"","sources":["../../src/schemas/marquee.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;EAakB,CAAC"}
+{"version":3,"file":"marquee.d.ts","sourceRoot":"","sources":["../../src/schemas/marquee.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;EA4B5B,CAAC"}

package/dist/schemas/marquee.json

@@ -42,7 +42,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Marquee (scrolling text/elements)."
+      "description": "Marquee — endless scrolling content (logo strip, promo banner, news ticker).\n\nWHEN TO USE:\n  • Logo cloud, partner brands strip, social proof\n  • Critical info that must be read → not Marquee (auto-scroll hurts a11y)\n  • Long static list → VirtualList\n  • User-paced gallery → Carousel\n\npauseOnHover=true is recommended whenever content is readable text.\n\nANTI-PATTERNS:\n  ✗ Marquee with action buttons inside (hard to click)\n  ✗ Fast-speed marquee on important text (unreadable, a11y violation)\n  ✗ Multiple Marquees on same page in different directions (visual chaos)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/modal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../../src/schemas/modal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2ClC,CAAC;AAEJ,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BzB,CAAC"}
+{"version":3,"file":"modal.d.ts","sourceRoot":"","sources":["../../src/schemas/modal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0DlC,CAAC;AAEJ,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6BzB,CAAC"}

package/dist/schemas/modalTemplate.json

@@ -119,7 +119,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Modal template. All modal components must be wrapped with ModalTemplate."
+      "description": "Modal template. All modal components must be wrapped with ModalTemplate.\n\nWHEN TO USE:\n  • Force user decision (delete confirm, submit confirm, blocking dialog)\n  • Long form/flow that needs full attention\n  • Side panel that doesn't block main flow → Drawer instead\n  • Inline contextual UI → Popover instead\n  • Short hint → Tooltip instead\n\nPREFERRED API: use modal() / useModal() imperative API rather than mounting <ModalTemplate> directly. modal() handles stacking, focus return, ESC, and background scroll automatically.\n\nANTI-PATTERNS:\n  ✗ Custom <div className=\"fixed inset-0\"> → modal() (loses focus trap, a11y)\n  ✗ Direct <ModalTemplate> mount in render tree → wrap with modal()\n  ✗ Modal with no title for screen readers → always pass title prop\n  ✗ Multiple modals stacking confusingly → use isAlone:true to close prior modals"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/number-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"number-input.d.ts","sourceRoot":"","sources":["../../src/schemas/number-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqDhC,CAAC"}
+{"version":3,"file":"number-input.d.ts","sourceRoot":"","sources":["../../src/schemas/number-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+DhC,CAAC"}

package/dist/schemas/numberInput.json

@@ -107,7 +107,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Number input with two variants: basic (chevron arrows) and bind (+/- buttons). Supports label, description, max display (click to fill), accelerated increment on long press. numberInputBind(ref, direction) binds acceleration to external buttons."
+      "description": "Number input with two variants: basic (chevron arrows) and bind (+/- buttons). Supports label, description, max display (click to fill), accelerated increment on long press. numberInputBind(ref, direction) binds acceleration to external buttons.\n\nWHEN TO USE:\n  • Any numeric field — quantity, score, age, count\n  • Currency with thousand separators → PriceInput instead\n  • Date / time → DatePicker instead\n\nANTI-PATTERNS:\n  ✗ <TextInput type=\"number\"> → <NumberInput> (loses keyboard ↑↓, step, accelerated long-press, max click)\n  ✗ Custom +/- buttons + <input> → variant=\"bind\" (or numberInputBind for external)\n  ✗ Manual thousand separators for currency → PriceInput"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/nx-image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nx-image.d.ts","sourceRoot":"","sources":["../../src/schemas/nx-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe6C,CAAC"}
+{"version":3,"file":"nx-image.d.ts","sourceRoot":"","sources":["../../src/schemas/nx-image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8B5B,CAAC"}

package/dist/schemas/nxImage.json

@@ -49,7 +49,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Enhanced image. Lazy loading, fallback, aspect-ratio support."
+      "description": "NxImage — lazy-loaded <img> with fallback, fixed aspect-ratio, object-fit. Always prefer over native <img>.\n\nWHEN TO USE:\n  • Content images: covers, banners, illustrations, hero images\n  • Profile/user avatar (with text fallback) → Avatar\n  • Background image / decorative → CSS bg-image\n  • Need Next.js optimization → use next/image directly (NxImage doesn't optimize)\n\naspectRatio reserves space, preventing CLS (layout shift).\n\nANTI-PATTERNS:\n  ✗ <img> with manual onError handling → NxImage (built-in fallback)\n  ✗ NxImage without alt for content images (a11y violation)\n  ✗ NxImage without aspectRatio in fluid layouts → CLS jank"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/pagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/schemas/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAe6B,CAAC"}
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/schemas/pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EA6B/B,CAAC"}

package/dist/schemas/pagination.json

@@ -43,7 +43,7 @@
         "totalPages"
       ],
       "additionalProperties": false,
-      "description": "Pagination. Previous/next + page number buttons."
+      "description": "Pagination — page-by-page navigation for long datasets.\n\nWHEN TO USE:\n  • User needs to jump to specific pages (search results, blog archives)\n  • Total count is known and stable\n  • Continuous browsing → InfiniteScroll instead\n  • Real-time stream → InfiniteScroll\n  • Both fit → Pagination is more accessible (keyboard, deep-linkable URL)\n\nANTI-PATTERNS:\n  ✗ Pagination with totalPages=1 — hide it\n  ✗ Mixing Pagination + InfiniteScroll on same list (confusing)\n  ✗ Custom page button divs → Pagination (a11y, edge cases like ellipsis)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/popover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../src/schemas/popover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuBgB,CAAC"}
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../src/schemas/popover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqC5B,CAAC"}

package/dist/schemas/popover.json

@@ -60,7 +60,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Popover. Based on Radix Popover."
+      "description": "Popover — anchor-positioned panel with interactive content. Based on Radix Popover.\n\nWHEN TO USE:\n  • Trigger-anchored UI with buttons, inputs, or rich content\n  • Filter/option panel near a button (not a full sidebar)\n  • Hover-only text hint → Tooltip (lighter)\n  • Action menu list → DropdownMenu (gives role=menu, keyboard nav)\n  • Decision dialog → Modal\n\nANTI-PATTERNS:\n  ✗ Action lists with onClick handlers → DropdownMenu (a11y semantics)\n  ✗ Implementing dropdown manually with Popover + custom buttons → DropdownMenu\n  ✗ Long forms inside Popover → Drawer or Modal"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/price-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"price-input.d.ts","sourceRoot":"","sources":["../../src/schemas/price-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyD/B,CAAC"}
+{"version":3,"file":"price-input.d.ts","sourceRoot":"","sources":["../../src/schemas/price-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsE/B,CAAC"}

package/dist/schemas/priceInput.json

@@ -97,7 +97,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Price/amount input field with prefix, suffix, balance display, and auto-fill on balance click."
+      "description": "PriceInput — currency / amount input with prefix, suffix, balance display, click-to-fill.\n\nWHEN TO USE:\n  • Money / token amounts: payment, transfer, swap, withdraw\n  • Need balance hint with auto-fill UX (set balance + onBalanceClick)\n  • Pure number (count, age, score) → NumberInput\n  • Generic text → TextInput\n\nseparator=true displays commas; onValueChange always returns raw value (no commas). maxBalance auto-applies error styling on overflow.\n\nANTI-PATTERNS:\n  ✗ <TextInput type=\"number\"> + manual currency formatting → PriceInput\n  ✗ NumberInput for currency (loses prefix/suffix/balance UX)\n  ✗ Using string input for amounts then parseFloat — lose precision; use this component"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/schemas/progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc+C,CAAC"}
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/schemas/progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8B7B,CAAC"}

package/dist/schemas/progress.json

@@ -56,7 +56,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Progress bar. Linear progress indicator with percentage display."
+      "description": "Progress — linear progress bar (file upload, multi-step form, loading with known %).\n\nWHEN TO USE:\n  • Quantifiable progress (% complete, X of Y)\n  • Unknown duration spinner → Spinner\n  • Stable component shape during load → Skeleton\n  • Step-based navigation → Stepper\n  • Indeterminate (loading without %) → set indeterminate=true\n\nvariant follows semantic colors (success when complete, danger on error).\n\nANTI-PATTERNS:\n  ✗ Indeterminate Progress for short loads (<1s) — Spinner is lighter\n  ✗ Custom <div style={{ width: x% }}> → Progress (a11y, tokens)\n  ✗ Progress without label/showValue when % is critical info"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/radio-group.d.ts

@@ -4,6 +4,7 @@ export declare const radioGroupPropsSchema: z.ZodObject<{
     value: z.ZodOptional<z.ZodString>;
     defaultValue: z.ZodOptional<z.ZodString>;
     size: z.ZodDefault<z.ZodEnum<["sm", "md"]>>;
+    variant: z.ZodDefault<z.ZodEnum<["default", "ring"]>>;
     orientation: z.ZodDefault<z.ZodEnum<["horizontal", "vertical"]>>;
     disabled: z.ZodOptional<z.ZodBoolean>;
     children: z.ZodAny;
@@ -14,6 +15,7 @@ export declare const radioGroupPropsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name: string;
     size: "md" | "sm";
+    variant: "default" | "ring";
     orientation: "horizontal" | "vertical";
     className?: string | undefined;
     children?: any;
@@ -30,6 +32,7 @@ export declare const radioGroupPropsSchema: z.ZodObject<{
     value?: string | undefined;
     size?: "md" | "sm" | undefined;
     disabled?: boolean | undefined;
+    variant?: "default" | "ring" | undefined;
     defaultValue?: string | undefined;
     'aria-label'?: string | undefined;
     'aria-labelledby'?: string | undefined;
@@ -39,7 +42,9 @@ export declare const radioGroupPropsSchema: z.ZodObject<{
 export declare const radioItemPropsSchema: z.ZodObject<{
     value: z.ZodString;
     size: z.ZodOptional<z.ZodEnum<["sm", "md"]>>;
+    variant: z.ZodOptional<z.ZodEnum<["default", "ring"]>>;
     label: z.ZodOptional<z.ZodAny>;
+    description: z.ZodOptional<z.ZodAny>;
     children: z.ZodOptional<z.ZodAny>;
     disabled: z.ZodOptional<z.ZodBoolean>;
     className: z.ZodOptional<z.ZodString>;
@@ -48,14 +53,18 @@ export declare const radioItemPropsSchema: z.ZodObject<{
     className?: string | undefined;
     children?: any;
     label?: any;
+    description?: any;
     size?: "md" | "sm" | undefined;
     disabled?: boolean | undefined;
+    variant?: "default" | "ring" | undefined;
 }, {
     value: string;
     className?: string | undefined;
     children?: any;
     label?: any;
+    description?: any;
     size?: "md" | "sm" | undefined;
     disabled?: boolean | undefined;
+    variant?: "default" | "ring" | undefined;
 }>;
 //# sourceMappingURL=radio-group.d.ts.map

package/dist/schemas/radio-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../src/schemas/radio-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBc,CAAC;AAEjD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;EASkB,CAAC"}
+{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../src/schemas/radio-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0C/B,CAAC;AAEJ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBkB,CAAC"}

package/dist/schemas/radioGroup.json

@@ -25,6 +25,15 @@
           "default": "md",
           "description": "Size"
         },
+        "variant": {
+          "type": "string",
+          "enum": [
+            "default",
+            "ring"
+          ],
+          "default": "default",
+          "description": "Visual style. default=outline circle with inner dot, ring=thick border replaces dot when checked"
+        },
         "orientation": {
           "type": "string",
           "enum": [
@@ -61,7 +70,7 @@
         "name"
       ],
       "additionalProperties": false,
-      "description": "Radio group. Used with RadioItem."
+      "description": "Radio group for single-choice form fields. Used with RadioItem.\n\nWHEN TO USE:\n  • Form field where user picks ONE of small set (≤4-7) and submits later → RadioGroup\n  • All options should be visible at once for comparison → RadioGroup (not Select)\n  • Immediate effect on selection (no submit) → ToggleGroup instead\n  • Page area switching (tabs) → Tab (not RadioGroup)\n  • Many options → Select / Combobox\n\nVARIANTS:\n  • variant=\"default\" — outline circle with inner dot when checked (classic)\n  • variant=\"ring\" — thick border replaces inner dot when checked (modern, Figma \"ring\" style)\n\nANTI-PATTERNS:\n  ✗ Using RadioGroup for tab-like content switching → Tab\n  ✗ Using RadioGroup for immediate filters → ToggleGroup\n  ✗ Mixing RadioGroup and ToggleGroup in same form → pick one pattern\n  ✗ Native <input type=\"radio\"> → RadioItem (gets a11y, focus ring, tokens)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/radioItem.json

@@ -16,9 +16,20 @@
           ],
           "description": "Size (overrides group)"
         },
+        "variant": {
+          "type": "string",
+          "enum": [
+            "default",
+            "ring"
+          ],
+          "description": "Visual style (overrides group)"
+        },
         "label": {
           "description": "Label text (ReactNode)"
         },
+        "description": {
+          "description": "Help text shown beneath the label (ReactNode)"
+        },
         "children": {
           "description": "Label alternative content (ReactNode)"
         },

package/dist/schemas/select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/schemas/select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB8C,CAAC;AAE7E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAOa,CAAC"}
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/schemas/select.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoC3B,CAAC;AAEJ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAOa,CAAC"}

package/dist/schemas/select.json

@@ -55,7 +55,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Dropdown select. Based on Radix Select. Used with SelectItem."
+      "description": "Dropdown select for short option lists. Based on Radix Select. Used with SelectItem.\n\nWHEN TO USE:\n  • Options ≤ 7, no search needed → Select\n  • Options ≥ 7 OR search needed OR async → Combobox instead\n  • Need multi-select → Combobox (multiple)\n  • Action menu (save/delete/share) → DropdownMenu (not Select; values vs actions)\n\nANTI-PATTERNS:\n  ✗ Select with 20+ options → Combobox\n  ✗ Using Select for menu items that trigger functions → DropdownMenu\n  ✗ Manual <select> styling → Select gives consistent token styling\n  ✗ Wrapping each SelectItem with Tooltip — instead put hint in item label"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/skeleton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skeleton.d.ts","sourceRoot":"","sources":["../../src/schemas/skeleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EA2B7B,CAAC"}
+{"version":3,"file":"skeleton.d.ts","sourceRoot":"","sources":["../../src/schemas/skeleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;EAyC7B,CAAC"}

package/dist/schemas/skeleton.json

@@ -44,7 +44,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Skeleton loading placeholder. Size/shape via className. With children, wraps transparently to maintain actual size."
+      "description": "Skeleton loading placeholder. Size/shape via className. With children, wraps transparently to maintain actual size.\n\nWHEN TO USE:\n  • Long load with known component shape (cards, lists, profile headers)\n  • Reduces perceived wait time when layout is predictable\n  • Short loads (<1s) → Spinner\n  • Quantifiable progress → Progress\n  • DataList/DataGrid loading → set list={null} (uses skeletonElement prop automatically)\n\nGOLDEN RULE: Skeleton must match the real component's shape and size. Mismatch causes layout shift.\n\nANTI-PATTERNS:\n  ✗ Generic gray rectangle for everything → match real component shape\n  ✗ Skeleton for instant loads (causes flash)\n  ✗ Many skeletons of different shapes when component is uniform → use a single skeleton in DataList"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/slider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../src/schemas/slider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB6D,CAAC"}
+{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../src/schemas/slider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgC3B,CAAC"}

package/dist/schemas/slider.json

@@ -71,7 +71,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Slider / Range input. Based on Radix Slider. Supports single and range mode."
+      "description": "Slider — numeric range selector. Based on Radix Slider. Single thumb or range (two thumbs).\n\nWHEN TO USE:\n  • Continuous range with visual feedback: volume, brightness, price filter\n  • Range filter (min-max) → defaultValue=[20, 80]\n  • Precise number entry → NumberInput\n  • Discrete few options → ToggleGroup or RadioGroup\n  • Boolean → Switch\n\nstep controls increments. onValueCommit fires only after pointer release (good for expensive recomputations).\n\nANTI-PATTERNS:\n  ✗ Slider for required precise input (typing 47 is faster than dragging)\n  ✗ Long step count without showValue / labels (users have no reference)\n  ✗ Calling expensive API on every onValueChange tick → use onValueCommit"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/spinner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/schemas/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAQqC,CAAC"}
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/schemas/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAqB5B,CAAC"}