@rockshin/tao-ui 0.0.10 → 0.0.11

package/dist/docs/components/headless-input-number.doc.d.ts

@@ -0,0 +1,16 @@
+export declare const headlessInputNumberDoc: {
+    name: string;
+    displayName: string;
+    category: "Headless";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+    };
+};

package/dist/docs/components/headless-input-number.doc.js

@@ -0,0 +1,36 @@
+const headlessInputNumberDoc = {
+    name: 'headless-input-number',
+    displayName: 'HeadlessInputNumber',
+    category: 'Headless',
+    description: 'Headless numeric input primitives and hook for custom number entry experiences.',
+    exports: [
+        'HeadlessInputNumber',
+        'NumberInput',
+        'useNumberInput'
+    ],
+    source: 'src/number-input/number-input.tsx',
+    story: 'stories/headless-input-number.stories.tsx',
+    tests: [
+        'tests/number-input/headless-input-number.test.tsx',
+        'tests/number-input/use-number-input.test.tsx',
+        'tests/number-input/format.test.ts',
+        'tests/number-input/validate.test.ts'
+    ],
+    keywords: [
+        'headless',
+        'number',
+        'formatting',
+        'validation'
+    ],
+    related: [
+        'InputNumber'
+    ],
+    usage: {
+        description: 'Use the headless API when tao-ui styling is not appropriate but number formatting behavior should stay consistent.',
+        bestPractices: [
+            'Use useNumberInput for fully custom rendering.',
+            'Reuse the validation helpers for parity with the styled InputNumber.'
+        ]
+    }
+};
+export { headlessInputNumberDoc };

package/dist/docs/components/input-number.doc.d.ts

@@ -0,0 +1,18 @@
+export declare const inputNumberDoc: {
+    name: string;
+    displayName: string;
+    category: "Data Entry";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+        avoid: string[];
+    };
+};

package/dist/docs/components/input-number.doc.js

@@ -0,0 +1,41 @@
+const inputNumberDoc = {
+    name: 'input-number',
+    displayName: 'InputNumber',
+    category: 'Data Entry',
+    description: 'A styled numeric input built on tao-ui number formatting and validation behavior.',
+    exports: [
+        'InputNumber'
+    ],
+    source: 'src/components/input-number/input-number.tsx',
+    story: 'stories/input-number.stories.tsx',
+    tests: [
+        'tests/input-number/input-number.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'input',
+        'controls',
+        'increment',
+        'decrement'
+    ],
+    keywords: [
+        'number',
+        'numeric',
+        'stepper'
+    ],
+    related: [
+        'HeadlessInputNumber',
+        'Input'
+    ],
+    usage: {
+        description: 'Use InputNumber for numeric values that need min, max, step, precision, or formatted display.',
+        bestPractices: [
+            'Set min and max when the domain is bounded.',
+            'Use the headless API when custom rendering is required.'
+        ],
+        avoid: [
+            'Do not use a numeric input for identifiers such as account numbers.'
+        ]
+    }
+};
+export { inputNumberDoc };

package/dist/docs/components/input.doc.d.ts

@@ -0,0 +1,17 @@
+export declare const inputDoc: {
+    name: string;
+    displayName: string;
+    category: "Data Entry";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+    };
+};

package/dist/docs/components/input.doc.js

@@ -0,0 +1,38 @@
+const inputDoc = {
+    name: 'input',
+    displayName: 'Input',
+    category: 'Data Entry',
+    description: 'Single-line text input for short freeform values.',
+    exports: [
+        'Input'
+    ],
+    source: 'src/components/input/input.tsx',
+    story: 'stories/input.stories.tsx',
+    tests: [
+        'tests/input/input.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'input',
+        'prefix',
+        'suffix',
+        'clear'
+    ],
+    keywords: [
+        'text field',
+        'input',
+        'search'
+    ],
+    related: [
+        'Textarea',
+        'FormField'
+    ],
+    usage: {
+        description: 'Use Input for short text values such as names, filters, search terms, and identifiers.',
+        bestPractices: [
+            'Pair with FormField for labels and validation.',
+            'Use type, inputMode, and autoComplete when applicable.'
+        ]
+    }
+};
+export { inputDoc };

package/dist/docs/components/modal.doc.d.ts

@@ -0,0 +1,18 @@
+export declare const modalDoc: {
+    name: string;
+    displayName: string;
+    category: "Feedback";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+        avoid: string[];
+    };
+};

package/dist/docs/components/modal.doc.js

@@ -0,0 +1,43 @@
+const modalDoc = {
+    name: 'modal',
+    displayName: 'Modal',
+    category: 'Feedback',
+    description: 'Displays a focused dialog for decisions, forms, and interruptive information.',
+    exports: [
+        'Modal'
+    ],
+    source: 'src/components/modal/modal.tsx',
+    story: 'stories/modal.stories.tsx',
+    tests: [
+        'tests/modal/modal.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'overlay',
+        'content',
+        'header',
+        'body',
+        'footer',
+        'close'
+    ],
+    keywords: [
+        'dialog',
+        'confirm',
+        'overlay'
+    ],
+    related: [
+        'Drawer',
+        'Button'
+    ],
+    usage: {
+        description: 'Use Modal for focused tasks or decisions. Static helpers such as Modal.confirm mirror common confirmation flows.',
+        bestPractices: [
+            'Prefer Modal.useModal inside React trees so dialogs inherit TaoProvider context.',
+            'Keep modal content short and task-oriented.'
+        ],
+        avoid: [
+            'Do not use nested modals for multi-step workflows.'
+        ]
+    }
+};
+export { modalDoc };

package/dist/docs/components/pagination.doc.d.ts

@@ -0,0 +1,17 @@
+export declare const paginationDoc: {
+    name: string;
+    displayName: string;
+    category: "Navigation";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+    };
+};

package/dist/docs/components/pagination.doc.js

@@ -0,0 +1,37 @@
+const paginationDoc = {
+    name: 'pagination',
+    displayName: 'Pagination',
+    category: 'Navigation',
+    description: 'Moves through paged data with current page and page-size controls.',
+    exports: [
+        'Pagination'
+    ],
+    source: 'src/components/pagination/pagination.tsx',
+    story: 'stories/pagination.stories.tsx',
+    tests: [
+        'tests/pagination/pagination.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'item',
+        'prev',
+        'next',
+        'sizeChanger'
+    ],
+    keywords: [
+        'pages',
+        'table',
+        'navigation'
+    ],
+    related: [
+        'Table'
+    ],
+    usage: {
+        description: 'Use Pagination when a collection is split into pages rather than infinitely loaded.',
+        bestPractices: [
+            'Keep the current page controlled when data is loaded remotely.',
+            'Show total counts when they help users judge scope.'
+        ]
+    }
+};
+export { paginationDoc };

package/dist/docs/components/radio.doc.d.ts

@@ -0,0 +1,18 @@
+export declare const radioDoc: {
+    name: string;
+    displayName: string;
+    category: "Data Entry";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+        avoid: string[];
+    };
+};

package/dist/docs/components/radio.doc.js

@@ -0,0 +1,43 @@
+const radioDoc = {
+    name: 'radio',
+    displayName: 'Radio',
+    category: 'Data Entry',
+    description: 'Selects exactly one option from a mutually exclusive set.',
+    exports: [
+        'Radio',
+        'RadioGroup'
+    ],
+    source: 'src/components/radio/radio.tsx',
+    story: 'stories/radio.stories.tsx',
+    tests: [
+        'tests/radio/radio.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'input',
+        'indicator',
+        'label',
+        'group',
+        'option'
+    ],
+    keywords: [
+        'radio',
+        'single choice',
+        'selection'
+    ],
+    related: [
+        'Checkbox',
+        'SegmentedControl'
+    ],
+    usage: {
+        description: 'Use RadioGroup when every option is visible and only one can be selected.',
+        bestPractices: [
+            'Use concise labels.',
+            'Provide a default value when one option is recommended or required.'
+        ],
+        avoid: [
+            'Do not use RadioGroup for very long option lists; use Select instead.'
+        ]
+    }
+};
+export { radioDoc };

package/dist/docs/components/range-picker.doc.d.ts

@@ -0,0 +1,17 @@
+export declare const rangePickerDoc: {
+    name: string;
+    displayName: string;
+    category: "Data Entry";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+    };
+};

package/dist/docs/components/range-picker.doc.js

@@ -0,0 +1,39 @@
+const rangePickerDoc = {
+    name: 'range-picker',
+    displayName: 'RangePicker',
+    category: 'Data Entry',
+    description: 'Lets users select a start and end date as one range value.',
+    exports: [
+        'RangePicker'
+    ],
+    source: 'src/components/date-picker/range-picker.tsx',
+    story: 'stories/date-picker.stories.tsx',
+    tests: [
+        'tests/date-picker/range-picker.test.tsx',
+        'tests/date-picker/use-calendar.test.ts'
+    ],
+    semanticParts: [
+        'root',
+        'input',
+        'popup',
+        'calendar',
+        'cell',
+        'footer'
+    ],
+    keywords: [
+        'date range',
+        'calendar',
+        'time range'
+    ],
+    related: [
+        'DatePicker'
+    ],
+    usage: {
+        description: 'Use RangePicker for reporting windows, booking windows, and filters with start/end dates.',
+        bestPractices: [
+            'Use presets for common ranges such as today, this week, or last 30 days.',
+            'Make inclusive/exclusive range behavior clear when it matters.'
+        ]
+    }
+};
+export { rangePickerDoc };

package/dist/docs/components/scroll-area.doc.d.ts

@@ -0,0 +1,17 @@
+export declare const scrollAreaDoc: {
+    name: string;
+    displayName: string;
+    category: "Data Display";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+    };
+};

package/dist/docs/components/scroll-area.doc.js

@@ -0,0 +1,36 @@
+const scrollAreaDoc = {
+    name: 'scroll-area',
+    displayName: 'ScrollArea',
+    category: 'Data Display',
+    description: 'Provides a styled scroll container for overflow content.',
+    exports: [
+        'ScrollArea'
+    ],
+    source: 'src/components/scroll-area/scroll-area.tsx',
+    story: 'stories/scroll-area.stories.tsx',
+    tests: [
+        'tests/scroll-area/scroll-area.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'viewport',
+        'scrollbar',
+        'thumb'
+    ],
+    keywords: [
+        'scroll',
+        'overflow',
+        'viewport'
+    ],
+    related: [
+        'Table'
+    ],
+    usage: {
+        description: 'Use ScrollArea when a fixed region needs overflow behavior without changing page scroll.',
+        bestPractices: [
+            'Constrain height explicitly.',
+            'Avoid hiding important actions below a small scroll region.'
+        ]
+    }
+};
+export { scrollAreaDoc };

package/dist/docs/components/select.doc.d.ts

@@ -0,0 +1,18 @@
+export declare const selectDoc: {
+    name: string;
+    displayName: string;
+    category: "Data Entry";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+        avoid: string[];
+    };
+};

package/dist/docs/components/select.doc.js

@@ -0,0 +1,43 @@
+const selectDoc = {
+    name: 'select',
+    displayName: 'Select',
+    category: 'Data Entry',
+    description: 'Chooses one value from a compact list of options.',
+    exports: [
+        'Select',
+        'ChevronsUpDownIcon'
+    ],
+    source: 'src/components/select/select.tsx',
+    story: 'stories/select.stories.tsx',
+    tests: [
+        'tests/select/select.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'trigger',
+        'value',
+        'content',
+        'item',
+        'empty'
+    ],
+    keywords: [
+        'select',
+        'combobox',
+        'options'
+    ],
+    related: [
+        'Dropdown',
+        'Radio'
+    ],
+    usage: {
+        description: 'Use Select when choices are known but too numerous or secondary to show as radios.',
+        bestPractices: [
+            'Use RadioGroup when there are only a few important choices.',
+            'Keep option labels stable and easy to scan.'
+        ],
+        avoid: [
+            'Do not use Select for arbitrary text entry.'
+        ]
+    }
+};
+export { selectDoc };

package/dist/docs/components/spinner.doc.d.ts

@@ -0,0 +1,18 @@
+export declare const spinnerDoc: {
+    name: string;
+    displayName: string;
+    category: "Feedback";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+        avoid: string[];
+    };
+};

package/dist/docs/components/spinner.doc.js

@@ -0,0 +1,36 @@
+const spinnerDoc = {
+    name: 'spinner',
+    displayName: 'Spinner',
+    category: 'Feedback',
+    description: 'Indicates indeterminate loading activity.',
+    exports: [
+        'Spinner'
+    ],
+    source: 'src/components/spinner/spinner.tsx',
+    story: 'stories/spinner.stories.tsx',
+    tests: [
+        'tests/spinner/spinner.test.tsx'
+    ],
+    semanticParts: [
+        'root'
+    ],
+    keywords: [
+        'loading',
+        'progress',
+        'busy'
+    ],
+    related: [
+        'Button'
+    ],
+    usage: {
+        description: 'Use Spinner for short indeterminate waits when progress cannot be measured.',
+        bestPractices: [
+            'Prefer inline placement near the content that is loading.',
+            'Use aria labels for standalone spinners.'
+        ],
+        avoid: [
+            'Do not use Spinner for determinate progress.'
+        ]
+    }
+};
+export { spinnerDoc };

package/dist/docs/components/splitter.doc.d.ts

@@ -0,0 +1,17 @@
+export declare const splitterDoc: {
+    name: string;
+    displayName: string;
+    category: "Layout";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    semanticParts: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+    };
+};

package/dist/docs/components/splitter.doc.js

@@ -0,0 +1,36 @@
+const splitterDoc = {
+    name: 'splitter',
+    displayName: 'Splitter',
+    category: 'Layout',
+    description: 'Creates resizable panes separated by draggable handles.',
+    exports: [
+        'Splitter'
+    ],
+    source: 'src/components/splitter/splitter.tsx',
+    story: 'stories/splitter.stories.tsx',
+    tests: [
+        'tests/splitter/splitter.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'panel',
+        'handle'
+    ],
+    keywords: [
+        'resizable',
+        'panes',
+        'layout'
+    ],
+    related: [
+        'Stack',
+        'FormLayout'
+    ],
+    usage: {
+        description: 'Use Splitter for work surfaces where users need to allocate space between adjacent panes.',
+        bestPractices: [
+            'Set sensible min sizes.',
+            'Persist sizes only when the layout is user-specific.'
+        ]
+    }
+};
+export { splitterDoc };

package/dist/docs/components/stack.doc.d.ts

@@ -0,0 +1,16 @@
+export declare const stackDoc: {
+    name: string;
+    displayName: string;
+    category: "Layout";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+    };
+};