@nexus-cross/design-system 1.0.13 → 1.1.0

package/dist/schemas/text-area.d.ts.map

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

package/dist/schemas/text-input.d.ts

@@ -42,13 +42,13 @@ export declare const textInputPropsSchema: z.ZodObject<{
     onChange?: any;
     onValueChange?: any;
     placeholder?: string | undefined;
+    clearable?: boolean | undefined;
     autoComplete?: string | undefined;
     maxLength?: number | undefined;
     readOnly?: boolean | undefined;
     prefixIcon?: any;
     suffixIcon?: any;
     showCount?: boolean | undefined;
-    clearable?: boolean | undefined;
 }, {
     name?: string | undefined;
     className?: string | undefined;
@@ -67,12 +67,12 @@ export declare const textInputPropsSchema: z.ZodObject<{
     onChange?: any;
     onValueChange?: any;
     placeholder?: string | undefined;
+    clearable?: boolean | undefined;
     autoComplete?: string | undefined;
     maxLength?: number | undefined;
     readOnly?: boolean | undefined;
     prefixIcon?: any;
     suffixIcon?: any;
     showCount?: boolean | undefined;
-    clearable?: boolean | undefined;
 }>;
 //# sourceMappingURL=text-input.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../src/schemas/text-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2B+E,CAAC"}
+{"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../src/schemas/text-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwC9B,CAAC"}

package/dist/schemas/textArea.json

@@ -95,7 +95,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Multi-line text input with label, description, character counter, and resize modes."
+      "description": "Multi-line text input. Always prefer over native <textarea>.\n\nWHEN TO USE:\n  • Long-form text — comments, descriptions, memos, bios\n  • Single-line input → TextInput\n  • Numeric → NumberInput\n\nresize=\"auto\" auto-grows with content (great for chat input). resize=\"none\" locks size for fixed UI.\n\nANTI-PATTERNS:\n  ✗ Native <textarea> + custom counter → showCount + maxLength\n  ✗ <TextArea> for short labels — use TextInput (smaller affordance)\n  ✗ Wrapping with custom <label>/<p> → use built-in label/description props (auto a11y binding)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/textInput.json

@@ -100,7 +100,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Text input field. Supports label, description, prefix/suffix icons, clearable, character counter."
+      "description": "Single-line text input (always prefer over native <input type=\"text\">).\n\nWHEN TO USE: any short text — name, email, search, URL, password.\nUse the built-in label/description props instead of wrapping with your own <label>/<p> tags (auto-binds htmlFor/aria-describedby for accessibility).\nFor numeric input use NumberInput; for currency PriceInput; for long text TextArea; for date DatePicker.\n\nANTI-PATTERNS:\n  ✗ <TextInput type=\"number\"> → <NumberInput> (gives unit, step, ↑↓ keys)\n  ✗ <label>Email <input ...></label> + <p>helper</p> → <TextInput label=\"Email\" description=\"helper\">\n  ✗ Custom red border for error → use error prop (auto aria-invalid + token color)\n  ✗ Manual character counter → use showCount + maxLength\n  ✗ Manual clear X button → use clearable prop"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

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

@@ -1 +1 @@
-{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../src/schemas/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4E5B,CAAC;AAEJ,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwD5B,CAAC"}
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../src/schemas/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyF5B,CAAC;AAEJ,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkE5B,CAAC"}

package/dist/schemas/toastOptions.json

@@ -74,7 +74,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "toast() call options. Used as toast(message, options). Fully customizable via toast.custom(jsx)."
+      "description": "toast() options. Used as toast(message, options) / toast.success / .error / .warning / .info / .promise / .custom(jsx).\n\nWHEN TO USE TOAST:\n  • Transient feedback after user action: \"Saved\", \"Copied\", \"Network error\"\n  • Persistent in-page banner → Alert\n  • Critical destructive confirmation → Modal (toast can be missed)\n  • Form field error → use error/description prop on the input\n\nrichColors=true gives strong success/error/warning/info colors. Use action for \"Undo\" patterns.\n\nANTI-PATTERNS:\n  ✗ Toast for confirmation that user MUST acknowledge → Modal\n  ✗ Stacking many toasts → set visibleToasts on Toaster\n  ✗ Long-form content in toast (toast is for short messages)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/toaster.json

@@ -69,7 +69,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Toaster config. Place once at app root. Display notifications via toast(). Based on sonner."
+      "description": "Toaster — toast container. Mount ONCE at app root. Then call toast() anywhere. Based on sonner.\n\nWHEN TO USE:\n  • Mount in app shell (layout.tsx / _app.tsx) — exactly one instance globally\n  • Set position once here; per-toast position only when needed\n  • Provide visibleToasts cap to avoid stacking\n\nANTI-PATTERNS:\n  ✗ Multiple Toasters across pages — only one global Toaster\n  ✗ Mounting Toaster inside conditional render — toasts vanish on remount\n  ✗ Forgetting Toaster mount — toast() calls do nothing"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

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

@@ -23,15 +23,16 @@ export declare const toggleGroupPropsSchema: z.ZodObject<{
     value: z.ZodOptional<z.ZodAny>;
     defaultValue: z.ZodOptional<z.ZodAny>;
     onValueChange: z.ZodOptional<z.ZodAny>;
-    variant: z.ZodDefault<z.ZodEnum<["default", "primary", "secondary"]>>;
+    variant: z.ZodDefault<z.ZodEnum<["default", "primary", "secondary", "outline"]>>;
     size: z.ZodDefault<z.ZodEnum<["sm", "md", "lg"]>>;
+    fullWidth: z.ZodDefault<z.ZodBoolean>;
     disabled: z.ZodOptional<z.ZodBoolean>;
     required: z.ZodDefault<z.ZodBoolean>;
     className: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     type: "multiple" | "single";
     size: "lg" | "md" | "sm";
-    variant: "primary" | "secondary" | "default";
+    variant: "primary" | "secondary" | "default" | "outline";
     items: {
         value: string;
         className?: string | undefined;
@@ -39,6 +40,7 @@ export declare const toggleGroupPropsSchema: z.ZodObject<{
         icon?: any;
         disabled?: boolean | undefined;
     }[];
+    fullWidth: boolean;
     required: boolean;
     className?: string | undefined;
     value?: any;
@@ -58,9 +60,10 @@ export declare const toggleGroupPropsSchema: z.ZodObject<{
     value?: any;
     size?: "lg" | "md" | "sm" | undefined;
     disabled?: boolean | undefined;
-    variant?: "primary" | "secondary" | "default" | undefined;
+    variant?: "primary" | "secondary" | "default" | "outline" | undefined;
     defaultValue?: any;
     onValueChange?: any;
+    fullWidth?: boolean | undefined;
     required?: boolean | undefined;
 }>;
 //# sourceMappingURL=toggle-group.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"toggle-group.d.ts","sourceRoot":"","sources":["../../src/schemas/toggle-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAauC,CAAC"}
+{"version":3,"file":"toggle-group.d.ts","sourceRoot":"","sources":["../../src/schemas/toggle-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4ChC,CAAC"}

package/dist/schemas/toggleGroup.json

@@ -58,10 +58,11 @@
           "enum": [
             "default",
             "primary",
-            "secondary"
+            "secondary",
+            "outline"
           ],
           "default": "default",
-          "description": "Style variant (default=slider, primary=accent filled, secondary=accent filled)"
+          "description": "Style variant (default=slider, primary/secondary=accent filled, outline=bordered buttons with no background)"
         },
         "size": {
           "type": "string",
@@ -73,6 +74,11 @@
           "default": "md",
           "description": "Size"
         },
+        "fullWidth": {
+          "type": "boolean",
+          "default": false,
+          "description": "Stretch the group to parent width and split items equally"
+        },
         "disabled": {
           "type": "boolean",
           "description": "Disable all items"
@@ -91,7 +97,7 @@
         "items"
       ],
       "additionalProperties": false,
-      "description": "Toggle group / Segment control. Based on Radix ToggleGroup."
+      "description": "Toggle group / Segment control for immediate-effect option selection. Based on Radix ToggleGroup.\n\nWHEN TO USE:\n  • Sort order, view mode (grid/list), filter chips — selection takes effect immediately\n  • Visual comparison important (icons or short labels)\n  • Form field that submits later → RadioGroup or CheckBox instead\n  • Page area switching (settings tabs) → Tab instead\n\nVARIANTS:\n  • default — slider-style background (sleek)\n  • primary / secondary — accent-filled selected state\n  • outline — bordered buttons with no background (button-style toolbar)\n\nfullWidth=true distributes items equally across parent width (use with outline variant for button-row look).\n\ntype=\"single\" requires at least one selection by default (required=true). Set required=false to allow deselection.\n\nANTI-PATTERNS:\n  ✗ Using ToggleGroup for content tabs → Tab\n  ✗ Using ToggleGroup as form field submitted later → RadioGroup (semantics + a11y)\n  ✗ Mixing icons and text labels of different sizes — keep visual rhythm consistent"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

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

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

package/dist/schemas/tooltip.json

@@ -60,7 +60,7 @@
         }
       },
       "additionalProperties": false,
-      "description": "Tooltip. Based on Radix Tooltip. Built-in Provider."
+      "description": "Tooltip — short text hint shown on hover/focus. Based on Radix Tooltip. Provider built-in.\n\nWHEN TO USE:\n  • Brief explanation of an icon button or truncated label\n  • Hover-only, non-interactive content (text only)\n  • Need clickable content inside → Popover (not Tooltip)\n  • Action menu → DropdownMenu\n  • Force user attention → Modal\n\nANTI-PATTERNS:\n  ✗ Buttons/links inside content → use Popover (Tooltip not focusable)\n  ✗ Long paragraphs in tooltip → consider Popover or Drawer\n  ✗ Tooltip on disabled buttons (won't show in some browsers) — wrap in span instead\n  ✗ Critical info only in tooltip — duplicate visible elsewhere for mobile/touch"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

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

@@ -1 +1 @@
-{"version":3,"file":"virtual-scroll.d.ts","sourceRoot":"","sources":["../../src/schemas/virtual-scroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiBkC,CAAC;AAEtE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAekC,CAAC"}
+{"version":3,"file":"virtual-scroll.d.ts","sourceRoot":"","sources":["../../src/schemas/virtual-scroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiChC,CAAC;AAEJ,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BhC,CAAC"}

package/dist/schemas/virtualGrid.json

@@ -55,7 +55,7 @@
         "columns"
       ],
       "additionalProperties": false,
-      "description": "Virtual scroll grid. Based on @tanstack/react-virtual."
+      "description": "VirtualGrid — performant grid for huge lists. Based on @tanstack/react-virtual.\n\nWHEN TO USE:\n  • Image gallery / card grid with 200+ items\n  • Fixed column count (responsive via JS — recompute columns on breakpoint)\n  • Small grid → DataGrid (no virtualization, simpler API)\n  • Single-column list → VirtualList\n\nANTI-PATTERNS:\n  ✗ VirtualGrid with <50 items — DataGrid is simpler\n  ✗ Cards with hover-expanding height (breaks virtualization)\n  ✗ Forgetting to recompute columns on resize → visible empty space"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"

package/dist/schemas/virtualList.json

@@ -50,7 +50,7 @@
         "items"
       ],
       "additionalProperties": false,
-      "description": "Virtual scroll list. Based on @tanstack/react-virtual."
+      "description": "VirtualList — performant rendering of huge lists (1000+ items). Based on @tanstack/react-virtual.\n\nWHEN TO USE:\n  • Large datasets (>200 rows): chat history, transactions, logs, leaderboard\n  • Stable item height (or measurable per-item via estimateSize fn)\n  • Small list (<100 items) → DataList (much simpler API)\n  • Grid layout → VirtualGrid\n  • Server-side pagination → InfiniteScroll wrapping plain list\n\nestimateSize is critical — wrong values cause scroll jumps. Pair with onEndReached for server pagination.\n\nANTI-PATTERNS:\n  ✗ VirtualList for short lists (DataList is simpler and renders faster)\n  ✗ Variable estimateSize for uniform items — use a single number\n  ✗ Putting interactive overlays inside virtual rows (mounted/unmounted on scroll)"
     }
   },
   "$schema": "http://json-schema.org/draft-07/schema#"