@nexus-cross/design-system 1.0.13 → 1.1.0

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, comboboxOptionSchema } 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":"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"}

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"}

package/dist/schemas/spinner.json

@@ -27,7 +27,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Loading indicator. SVG-based. Built-in role=\"status\"."
+      "description": "Loading indicator (spinner). SVG-based. role=\"status\" + aria-label built-in.\n\nWHEN TO USE:\n  • Short loads (<1s), inline indicator (button content while submitting)\n  • Long loads with known structure → Skeleton (better perceived performance)\n  • Quantifiable progress → Progress\n  • Page-level loading boundary inside DataList/DataGrid → use their loading prop instead\n\nANTI-PATTERNS:\n  ✗ Custom CSS spinning div → Spinner (a11y + tokens)\n  ✗ Using Spinner where Skeleton fits (long loads with stable layout)\n  ✗ Forgetting aria-label override when meaning differs from \"Loading\""
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

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

@@ -1 +1 @@
-{"version":3,"file":"stepper.d.ts","sourceRoot":"","sources":["../../src/schemas/stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAeyB,CAAC"}
+{"version":3,"file":"stepper.d.ts","sourceRoot":"","sources":["../../src/schemas/stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B5B,CAAC"}

package/dist/schemas/stepper.json

@@ -66,7 +66,7 @@
         "steps"
       ],
       "additionalProperties": false,
-      "description": "Stepper. Step-by-step progress indicator."
+      "description": "Stepper — multi-step linear flow indicator (checkout, onboarding, wizard).\n\nWHEN TO USE:\n  • Sequential workflow with finite steps (3-7)\n  • Show user's current position in flow + completed/upcoming steps\n  • Independent navigation between unrelated sections → Tab\n  • Continuous % progress → Progress\n  • Hierarchy / location → Breadcrumb\n\nstatus=\"error\" highlights the current step with danger color when validation fails.\n\nANTI-PATTERNS:\n  ✗ Stepper with 2 steps (use Progress or just navigation)\n  ✗ Stepper with 10+ steps (overwhelming) — chunk into sub-flows\n  ✗ Letting users skip ahead by clicking future steps (only mark completed → current is allowed)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

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

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

package/dist/schemas/switch.json

@@ -45,7 +45,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Toggle switch. Native checkbox-based, role=\"switch\"."
+      "description": "Toggle switch for immediate on/off binary state. Native checkbox-based, role=\"switch\".\n\nWHEN TO USE:\n  • Setting that takes effect immediately (notifications on/off, dark mode)\n  • Binary state with no submit step\n  • Form field submitted later → CheckBox instead (semantics: checkbox is form data)\n  • Multiple related options → CheckBox group or ToggleGroup (multiple)\n\nANTI-PATTERNS:\n  ✗ <CheckBox> for \"Enable notifications\" toggle → <Switch>\n  ✗ <Switch> inside form requiring submit → <CheckBox>\n  ✗ Wrapping Switch in <label onClick> manually → use label prop or htmlFor pattern"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

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

@@ -1 +1 @@
-{"version":3,"file":"tab.d.ts","sourceRoot":"","sources":["../../src/schemas/tab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBuB,CAAC"}
+{"version":3,"file":"tab.d.ts","sourceRoot":"","sources":["../../src/schemas/tab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCxB,CAAC"}

package/dist/schemas/tab.json

@@ -82,7 +82,7 @@
         "items"
       ],
       "additionalProperties": false,
-      "description": "Tab navigation. line/pill variants."
+      "description": "Tab navigation — switch between content panels (settings sections, profile views).\n\nWHEN TO USE:\n  • Page area swap where only one panel is visible at a time\n  • Mutually exclusive content with stable section labels\n  • Form field selection → RadioGroup (semantics: not navigation)\n  • Immediate filter/option toggle → ToggleGroup\n  • Stacked collapsible sections → Accordion\n\ndestroyInactive=true unmounts hidden panels (saves memory but loses state).\n\nANTI-PATTERNS:\n  ✗ Tab with 1 item — just render the panel\n  ✗ Tab with 8+ items — consider sub-routing or DropdownMenu\n  ✗ Using Tab for form value selection → RadioGroup\n  ✗ Custom <button> + onClick + state → Tab (a11y, keyboard, focus management)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

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

@@ -1 +1 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/schemas/table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0B1B,CAAC;AAEJ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAUY,CAAC;AAE7C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCkC,CAAC"}
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/schemas/table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwC1B,CAAC;AAEJ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAiB7B,CAAC;AAEJ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsD7B,CAAC"}

package/dist/schemas/table.json

@@ -68,7 +68,7 @@
         "list"
       ],
       "additionalProperties": false,
-      "description": "Table. Column definitions via TdColumn, row wrapping via TableRow. Built-in sorting/skeleton loading."
+      "description": "Table — tabular data with sortable columns, skeleton/loading/empty states. Compound: TableRow + TdColumn.\n\nWHEN TO USE:\n  • Comparable structured data (financial reports, transaction history, leaderboard)\n  • Sortable per-column → enableSorting on TdColumn\n  • Card-style entities → DataGrid\n  • Single-column read-only list → DataList\n  • Huge dataset (>500 rows) → wrap with VirtualList logic or paginate\n\nlist={null} → loading state. list=[] → noDataMsg. children: ({ item, index }) => <TableRow>...</TableRow>.\n\nANTI-PATTERNS:\n  ✗ Native <table> + manual loading/empty handling → Table component\n  ✗ Forcing card-style data into Table (use DataGrid)\n  ✗ Sorting in client when server pagination is in use → server-side sort"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/tableRow.json

@@ -25,7 +25,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Table row. Used inside Table."
+      "description": "TableRow — a single row inside Table. Wraps TdColumn cells.\n\nWHEN TO USE:\n  • variant=\"accent\" highlights selected/current row\n  • onClick for row-level navigation (e.g. open detail page)\n  • Per-row checkbox/action → place inside a TdColumn child"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

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

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

package/dist/schemas/tagInput.json

@@ -63,7 +63,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Tag input. Enter key to add, Backspace to delete last tag."
+      "description": "TagInput — free-form multi-value entry (Enter to add, Backspace to remove last).\n\nWHEN TO USE:\n  • Free-form labels: skills, hashtags, email recipients, keywords\n  • Predefined options → Combobox with multi-select (NOT TagInput)\n  • Single value → TextInput\n  • Limited options → Select / RadioGroup / Checkbox\n\nallowDuplicates=false (default) prevents repeats. Use max to cap count.\n\nANTI-PATTERNS:\n  ✗ TagInput for predefined taxonomy → Combobox (controlled options)\n  ✗ TagInput without max for spam-prone fields\n  ✗ Custom comma-split string field → TagInput (proper UX + a11y)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/tdColumn.json

@@ -100,7 +100,7 @@
         "fieldId"
       ],
       "additionalProperties": false,
-      "description": "Table cell/column definition. Used inside TableRow."
+      "description": "TdColumn — table cell. Drives both <th> and <td> for the column. Provides sorting, alignment, overflow handling.\n\nWHEN TO USE:\n  • textOverflow=\"truncate\" (default) for fixed-width columns; \"wrap\" for narrative\n  • align=\"right\" for numeric/currency columns (a11y readability)\n  • enableSorting=true when column is sortable; supply order + handleClickSort for controlled sort\n  • highlightKey to group columns that highlight together on hover\n\nANTI-PATTERNS:\n  ✗ enableSorting without handleClickSort → sort indicator is dead\n  ✗ align=\"left\" for currency/number columns\n  ✗ Mixing text and numeric in one column without consistent align"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"