@rockshin/tao-ui 0.0.10 → 0.0.11

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

@@ -0,0 +1,31 @@
+const stackDoc = {
+    name: 'stack',
+    displayName: 'Stack',
+    category: 'Layout',
+    description: 'Composes children in a flex row or column with consistent spacing.',
+    exports: [
+        'Stack'
+    ],
+    source: 'src/layouts/stack/stack.tsx',
+    story: 'stories/stack.stories.tsx',
+    tests: [
+        'tests/layouts/stack/stack.test.tsx'
+    ],
+    keywords: [
+        'layout',
+        'flex',
+        'spacing'
+    ],
+    related: [
+        'Splitter',
+        'FormLayout'
+    ],
+    usage: {
+        description: 'Use Stack for simple one-dimensional layout and spacing.',
+        bestPractices: [
+            'Prefer Stack over one-off margin rules for repeated spacing.',
+            'Use semantic containers when the layout has richer meaning.'
+        ]
+    }
+};
+export { stackDoc };

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

@@ -0,0 +1,17 @@
+export declare const switchDoc: {
+    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/switch.doc.js

@@ -0,0 +1,35 @@
+const switchDoc = {
+    name: 'switch',
+    displayName: 'Switch',
+    category: 'Data Entry',
+    description: 'Toggles a setting on or off with immediate effect.',
+    exports: [
+        'Switch'
+    ],
+    source: 'src/components/switch/switch.tsx',
+    story: 'stories/switch.stories.tsx',
+    tests: [
+        'tests/switch/switch.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'thumb',
+        'label'
+    ],
+    keywords: [
+        'toggle',
+        'setting',
+        'boolean'
+    ],
+    related: [
+        'Checkbox'
+    ],
+    usage: {
+        description: 'Use Switch for settings that take effect immediately.',
+        bestPractices: [
+            'Use labels that describe the enabled state.',
+            'Use Checkbox when the value is submitted with a form.'
+        ]
+    }
+};
+export { switchDoc };

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

@@ -0,0 +1,18 @@
+export declare const tableDoc: {
+    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[];
+        avoid: string[];
+    };
+};

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

@@ -0,0 +1,46 @@
+const tableDoc = {
+    name: 'table',
+    displayName: 'Table',
+    category: 'Data Display',
+    description: 'Displays structured row and column data with selection, sorting, filtering, and pagination hooks.',
+    exports: [
+        'Table'
+    ],
+    source: 'src/components/table/table.tsx',
+    story: 'stories/table.stories.tsx',
+    tests: [
+        'tests/table/table.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'table',
+        'header',
+        'header.cell',
+        'body',
+        'row',
+        'cell',
+        'pagination'
+    ],
+    keywords: [
+        'data grid',
+        'rows',
+        'columns',
+        'sorting'
+    ],
+    related: [
+        'Pagination',
+        'ScrollArea'
+    ],
+    usage: {
+        description: 'Use Table for dense, comparable records that benefit from aligned columns.',
+        bestPractices: [
+            'Keep columns focused on the task.',
+            'Use stable row keys.',
+            'Control sorting and pagination when data is remote.'
+        ],
+        avoid: [
+            'Do not use Table for card-like content where comparison is not important.'
+        ]
+    }
+};
+export { tableDoc };

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

@@ -0,0 +1,18 @@
+export declare const tabsDoc: {
+    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[];
+        avoid: string[];
+    };
+};

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

@@ -0,0 +1,39 @@
+const tabsDoc = {
+    name: 'tabs',
+    displayName: 'Tabs',
+    category: 'Navigation',
+    description: 'Switches between peer panels within the same page context.',
+    exports: [
+        'Tabs'
+    ],
+    source: 'src/components/tabs/tabs.tsx',
+    story: 'stories/tabs.stories.tsx',
+    tests: [
+        'tests/tabs/tabs.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'list',
+        'tab',
+        'panel'
+    ],
+    keywords: [
+        'tabs',
+        'sections',
+        'navigation'
+    ],
+    related: [
+        'Breadcrumb'
+    ],
+    usage: {
+        description: 'Use Tabs to separate peer views without navigating away from the current task.',
+        bestPractices: [
+            'Use short tab labels.',
+            'Keep tab panels at comparable hierarchy.'
+        ],
+        avoid: [
+            'Do not use Tabs for sequential steps.'
+        ]
+    }
+};
+export { tabsDoc };

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

@@ -0,0 +1,18 @@
+export declare const tagDoc: {
+    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[];
+        avoid: string[];
+    };
+};

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

@@ -0,0 +1,41 @@
+const tagDoc = {
+    name: 'tag',
+    displayName: 'Tag',
+    category: 'Data Display',
+    description: 'Displays compact labels, statuses, categories, or checkable chips.',
+    exports: [
+        'Tag',
+        'CheckableTag'
+    ],
+    source: 'src/components/tag/tag.tsx',
+    story: 'stories/tag.stories.tsx',
+    tests: [
+        'tests/tag/tag.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'icon',
+        'close'
+    ],
+    keywords: [
+        'badge',
+        'chip',
+        'status',
+        'label'
+    ],
+    related: [
+        'Checkbox',
+        'Table'
+    ],
+    usage: {
+        description: 'Use Tag for lightweight metadata or status markers. Use CheckableTag for compact filter choices.',
+        bestPractices: [
+            'Use semantic colors consistently.',
+            'Keep tag text short.'
+        ],
+        avoid: [
+            'Do not encode critical state by color alone.'
+        ]
+    }
+};
+export { tagDoc };

package/dist/docs/components/tao-provider.doc.d.ts

@@ -0,0 +1,22 @@
+export declare const taoProviderDoc: {
+    name: string;
+    displayName: string;
+    category: "Config";
+    description: string;
+    exports: string[];
+    source: string;
+    story: string;
+    tests: string[];
+    keywords: string[];
+    related: string[];
+    usage: {
+        description: string;
+        bestPractices: string[];
+        avoid: string[];
+    };
+    props: {
+        name: string;
+        type: string;
+        description: string;
+    }[];
+};

package/dist/docs/components/tao-provider.doc.js

@@ -0,0 +1,60 @@
+const taoProviderDoc = {
+    name: 'tao-provider',
+    displayName: 'TaoProvider',
+    category: 'Config',
+    description: 'Provides global component defaults, portal scoping, and theme seed token overrides.',
+    exports: [
+        'TaoProvider',
+        'TaoPortalScope'
+    ],
+    source: 'src/provider/tao-provider.tsx',
+    story: 'stories/provider.stories.tsx',
+    tests: [
+        'tests/provider/tao-provider.test.tsx'
+    ],
+    keywords: [
+        'provider',
+        'theme',
+        'tokens',
+        'size',
+        'disabled'
+    ],
+    related: [
+        'Button',
+        'Input',
+        'tokenVar'
+    ],
+    usage: {
+        description: 'Wrap an app or subtree with TaoProvider to set size, disabled, variant, and theme defaults.',
+        bestPractices: [
+            'Prefer provider-level defaults for app-wide decisions.',
+            'Use nested providers for scoped theme overrides.'
+        ],
+        avoid: [
+            'Do not override derived CSS variables directly unless a theme token cannot express the change.'
+        ]
+    },
+    props: [
+        {
+            name: 'size',
+            type: 'TaoSize',
+            description: 'Default component size for descendants.'
+        },
+        {
+            name: 'disabled',
+            type: 'boolean',
+            description: 'Default disabled state for descendants.'
+        },
+        {
+            name: 'variant',
+            type: 'TaoVariant',
+            description: 'Default field variant for descendants.'
+        },
+        {
+            name: 'theme',
+            type: 'TaoThemeConfig',
+            description: 'Seed token overrides for the provider scope.'
+        }
+    ]
+};
+export { taoProviderDoc };

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

@@ -0,0 +1,17 @@
+export declare const textareaDoc: {
+    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/textarea.doc.js

@@ -0,0 +1,35 @@
+const textareaDoc = {
+    name: 'textarea',
+    displayName: 'Textarea',
+    category: 'Data Entry',
+    description: 'Multi-line text input with optional auto sizing.',
+    exports: [
+        'Textarea'
+    ],
+    source: 'src/components/textarea/textarea.tsx',
+    story: 'stories/textarea.stories.tsx',
+    tests: [
+        'tests/textarea/textarea.test.tsx'
+    ],
+    semanticParts: [
+        'root',
+        'textarea'
+    ],
+    keywords: [
+        'textarea',
+        'multiline',
+        'input'
+    ],
+    related: [
+        'Input',
+        'FormField'
+    ],
+    usage: {
+        description: "Use Textarea for longer freeform content such as descriptions, notes, and comments.",
+        bestPractices: [
+            'Set rows or autoSize based on expected content length.',
+            'Use maxLength when limits are strict.'
+        ]
+    }
+};
+export { textareaDoc };

package/dist/docs/index.d.ts

@@ -0,0 +1,2 @@
+export type { ComponentDoc, ComponentDocCategory, ComponentDocProp, ComponentDocUsage, } from './component-doc';
+export { componentDocs, getComponentDoc } from './component-docs';

package/dist/docs/index.js

@@ -0,0 +1 @@
+export { componentDocs, getComponentDoc } from "./component-docs.js";

package/dist/index.d.ts

@@ -1,33 +1,35 @@
-import "./theme/theme.css";
-import "./theme/control.css";
-export { Breadcrumb, type BreadcrumbItemType, type BreadcrumbProps, type BreadcrumbSemanticPart, } from "./components/breadcrumb/breadcrumb";
-export { Button, type ButtonProps, type ButtonSemanticPart, } from "./components/button/button";
-export { Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxOptionType, type CheckboxProps, type CheckboxSemanticPart, } from "./components/checkbox/checkbox";
-export { Collapsible, type CollapsibleContentProps, type CollapsibleProps, type CollapsibleSemanticPart, type CollapsibleTriggerProps, } from "./components/collapsible/collapsible";
-export { ContextMenu, type ContextMenuProps, type ContextMenuSemanticPart, } from "./components/context-menu/context-menu";
-export { DatePicker, type DatePickerProps, } from "./components/date-picker/date-picker";
-export { RangePicker, type RangePickerProps, } from "./components/date-picker/range-picker";
-export { Drawer, type DrawerPlacement, type DrawerProps, type DrawerResizableConfig, type DrawerSemanticPart, type DrawerSize, } from "./components/drawer/drawer";
-export { Dropdown, type DropdownButtonProps, type DropdownPlacement, type DropdownProps, type DropdownSemanticPart, type DropdownTrigger, type MenuDividerType, type MenuGroupType, type MenuItem, type MenuItemType, type MenuProps, } from "./components/dropdown/dropdown";
-export { FormActions, type FormActionsProps, type FormActionsSemanticPart, } from "./components/form-actions/form-actions";
-export { FormField, type FormFieldProps, type FormFieldSemanticPart, } from "./components/form-field/form-field";
-export { FormSection, type FormSectionProps, type FormSectionSemanticPart, } from "./components/form-section/form-section";
-export { Input, type InputProps, type InputSemanticPart, } from "./components/input/input";
-export { InputNumber, type InputNumberProps, type InputNumberSemanticPart, } from "./components/input-number/input-number";
-export { type ConfirmType, Modal, type ModalFooterRender, type ModalFuncProps, type ModalFuncReturn, type ModalHookApi, type ModalProps, type ModalSemanticPart, } from "./components/modal";
-export { Pagination, type PaginationProps, type PaginationSemanticPart, } from "./components/pagination/pagination";
-export { Radio, RadioGroup, type RadioGroupProps, type RadioOptionType, type RadioProps, type RadioSemanticPart, } from "./components/radio/radio";
-export { ScrollArea, type ScrollAreaProps, type ScrollAreaSemanticPart, type ScrollAreaType, } from "./components/scroll-area/scroll-area";
-export { ChevronsUpDownIcon, Select, type SelectOption, type SelectPlacement, type SelectProps, type SelectSemanticPart, } from "./components/select/select";
-export { Spinner, type SpinnerProps, type SpinnerSemanticPart, } from "./components/spinner/spinner";
-export { Splitter, type SplitterPanelProps, type SplitterProps, type SplitterSemanticPart, } from "./components/splitter/splitter";
-export { Switch, type SwitchProps, type SwitchSemanticPart, } from "./components/switch/switch";
-export { type SorterResult, type SortOrder, Table, type TableColumn, type TableFilterItem, type TablePagination, type TableProps, type TableRowSelection, type TableSemanticPart, type TableVariant, } from "./components/table/table";
-export { type TabItem, Tabs, type TabsProps, type TabsSemanticPart, } from "./components/tabs/tabs";
-export { CheckableTag, type CheckableTagProps, Tag, type TagColor, type TagProps, type TagSemanticPart, type TagVariant, } from "./components/tag/tag";
-export { type AutoSizeOptions, Textarea, type TextareaProps, type TextareaSemanticPart, } from "./components/textarea/textarea";
-export { FormLayout, type FormLayoutProps, } from "./layouts/form-layout/form-layout";
-export { Stack, type StackProps } from "./layouts/stack/stack";
-export { type FormatOptions, HeadlessInputNumber, type HeadlessInputNumberProps, NumberInput, type NumberInputProps, type PadDecimalsOnBlur, type UseNumberInputOptions, type UseNumberInputReturn, useNumberInput, } from "./number-input";
-export { TaoPortalScope, TaoProvider, type TaoProviderProps, type TaoSeedToken, type TaoSize, type TaoThemeConfig, type TaoVariant, useTaoConfig, } from "./provider/tao-provider";
-export { cx, type SemanticClassNames, type SemanticStyles, } from "./utils/semantic";
+import './theme/theme.css';
+import './theme/control.css';
+export { Breadcrumb, type BreadcrumbItemType, type BreadcrumbProps, type BreadcrumbSemanticPart, } from './components/breadcrumb/breadcrumb';
+export { Button, type ButtonProps, type ButtonSemanticPart, } from './components/button/button';
+export { Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxOptionType, type CheckboxProps, type CheckboxSemanticPart, } from './components/checkbox/checkbox';
+export { Collapsible, type CollapsibleContentProps, type CollapsibleProps, type CollapsibleSemanticPart, type CollapsibleTriggerProps, } from './components/collapsible/collapsible';
+export { ContextMenu, type ContextMenuProps, type ContextMenuSemanticPart, } from './components/context-menu/context-menu';
+export { DatePicker, type DatePickerProps, } from './components/date-picker/date-picker';
+export { RangePicker, type RangePickerProps, } from './components/date-picker/range-picker';
+export { Drawer, type DrawerPlacement, type DrawerProps, type DrawerResizableConfig, type DrawerSemanticPart, type DrawerSize, } from './components/drawer/drawer';
+export { Dropdown, type DropdownButtonProps, type DropdownPlacement, type DropdownProps, type DropdownSemanticPart, type DropdownTrigger, type MenuDividerType, type MenuGroupType, type MenuItem, type MenuItemType, type MenuProps, } from './components/dropdown/dropdown';
+export { FormActions, type FormActionsProps, type FormActionsSemanticPart, } from './components/form-actions/form-actions';
+export { FormField, type FormFieldProps, type FormFieldSemanticPart, } from './components/form-field/form-field';
+export { FormSection, type FormSectionProps, type FormSectionSemanticPart, } from './components/form-section/form-section';
+export { Input, type InputProps, type InputSemanticPart, } from './components/input/input';
+export { InputNumber, type InputNumberProps, type InputNumberSemanticPart, } from './components/input-number/input-number';
+export { type ConfirmType, Modal, type ModalFooterRender, type ModalFuncProps, type ModalFuncReturn, type ModalHookApi, type ModalProps, type ModalSemanticPart, } from './components/modal';
+export { Pagination, type PaginationProps, type PaginationSemanticPart, } from './components/pagination/pagination';
+export { Radio, RadioGroup, type RadioGroupProps, type RadioOptionType, type RadioProps, type RadioSemanticPart, } from './components/radio/radio';
+export { ScrollArea, type ScrollAreaProps, type ScrollAreaSemanticPart, type ScrollAreaType, } from './components/scroll-area/scroll-area';
+export { ChevronsUpDownIcon, Select, type SelectOption, type SelectPlacement, type SelectProps, type SelectSemanticPart, } from './components/select/select';
+export { Spinner, type SpinnerProps, type SpinnerSemanticPart, } from './components/spinner/spinner';
+export { Splitter, type SplitterPanelProps, type SplitterProps, type SplitterSemanticPart, } from './components/splitter/splitter';
+export { Switch, type SwitchProps, type SwitchSemanticPart, } from './components/switch/switch';
+export { type SorterResult, type SortOrder, Table, type TableColumn, type TableFilterItem, type TablePagination, type TableProps, type TableRowSelection, type TableSemanticPart, type TableVariant, } from './components/table/table';
+export { type TabItem, Tabs, type TabsProps, type TabsSemanticPart, } from './components/tabs/tabs';
+export { CheckableTag, type CheckableTagProps, Tag, type TagColor, type TagProps, type TagSemanticPart, type TagVariant, } from './components/tag/tag';
+export { type AutoSizeOptions, Textarea, type TextareaProps, type TextareaSemanticPart, } from './components/textarea/textarea';
+export { type ComponentDoc, type ComponentDocCategory, type ComponentDocProp, type ComponentDocUsage, componentDocs, getComponentDoc, } from './docs';
+export { FormLayout, type FormLayoutProps, } from './layouts/form-layout/form-layout';
+export { Stack, type StackProps } from './layouts/stack/stack';
+export { type FormatOptions, HeadlessInputNumber, type HeadlessInputNumberProps, NumberInput, type NumberInputProps, type PadDecimalsOnBlur, type UseNumberInputOptions, type UseNumberInputReturn, useNumberInput, } from './number-input';
+export { TaoPortalScope, TaoProvider, type TaoProviderProps, type TaoSeedToken, type TaoSize, type TaoThemeConfig, type TaoVariant, useTaoConfig, } from './provider/tao-provider';
+export { type TaoTokenName, taoTokenNames, taoTokenVars, tokenVar, } from './theme/tokens';
+export { cx, type SemanticClassNames, type SemanticStyles, } from './utils/semantic';

package/dist/index.js

@@ -26,8 +26,10 @@ export { Table } from "./components/table/table.js";
 export { Tabs } from "./components/tabs/tabs.js";
 export { CheckableTag, Tag } from "./components/tag/tag.js";
 export { Textarea } from "./components/textarea/textarea.js";
+export { componentDocs, getComponentDoc } from "./docs/index.js";
 export { FormLayout } from "./layouts/form-layout/form-layout.js";
 export { Stack } from "./layouts/stack/stack.js";
 export { HeadlessInputNumber, NumberInput, useNumberInput } from "./number-input/index.js";
 export { TaoPortalScope, TaoProvider, useTaoConfig } from "./provider/tao-provider.js";
+export { taoTokenNames, taoTokenVars, tokenVar } from "./theme/tokens.js";
 export { cx } from "./utils/semantic.js";