--- url: https://rickyshin93.github.io/tao-ui/guide/getting-started.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # Getting Started Requires React and React DOM 18.2 at minimum and also supports React 19. Both peer dependency ranges are `^18.2.0 || ^19.0.0`. The date pickers' `dayjs` dependency is installed automatically. Install tao-ui with your preferred package manager. ```sh [npm] npm install @rockshin/tao-ui ``` ```sh [yarn] yarn add @rockshin/tao-ui ``` ```sh [pnpm] pnpm add @rockshin/tao-ui ``` ```sh [bun] bun add @rockshin/tao-ui ``` ```sh [deno] deno add npm:@rockshin/tao-ui ``` ## Add the provider Wrap your application once with `TaoProvider`. Components inherit settings such as size, disabled state, and theme mode. ```tsx import { Button, TaoProvider } from '@rockshin/tao-ui'; export default function App() { return ( ); } ``` ## Component imports Component entries load only their component dependencies and shared theme styles. No separate CSS import is needed. The root entry remains available and includes all component styles. ```tsx import { Button, type ButtonProps } from '@rockshin/tao-ui/button'; import { TaoProvider } from '@rockshin/tao-ui/provider'; ``` Entry names use kebab-case, such as `/input-number`, `/range-picker`, and `/form-layout`. Related exports share an entry: `CheckboxGroup` uses `/checkbox`, and `HeadlessInputNumber` uses `/number-input`. ## Control field values For Input, Textarea, InputNumber, Select, DatePicker, and RangePicker, an explicit `value={undefined}` is a controlled empty value. Omit `value` and use `defaultValue` for an uncontrolled field. Form fields can be cleared with `form.setFieldsValue({ field: undefined })` without remounting the control. ## Use dark mode Set the theme mode on the provider. Portaled components inherit the same theme. ```tsx ``` Continue with the [Button component](https://rickyshin93.github.io/tao-ui/components/button.md). ## Accessibility and ARIA Use `FormField` or `Form.Item` to associate labels, help and validation messages with controls. Input, Textarea, InputNumber, Select, Checkbox, Radio, Switch, DatePicker and RangePicker forward field ARIA attributes to their interactive elements; CheckboxGroup and RadioGroup expose group labels and validation messages. Placeholders do not replace field labels. ```tsx ``` Radio maps `aria-required` to native `required`; an explicit `required` prop takes precedence. Group options retain their native disabled state, including explicit `disabled={false}` overrides. Desktop date inputs expose `combobox` semantics. ArrowDown opens the calendar and moves focus into it; Escape closes it and returns focus to the input. RangePicker combines explicit ARIA labels and each endpoint placeholder to distinguish its inputs. Native labels can instead target `id` and `${id}-end`. Calendar, month, year and time choices expose selection state. - Name Tabs with `aria-label` or `aria-labelledby`; text panels are reachable with Tab. - Give Modal, Drawer and Popover a visible `title` or explicit ARIA name. Popconfirm associates its question and description automatically. - Spinner accepts `aria-label`, defaults to `Loading` without a tip, and marks wrapped content `aria-busy` throughout loading, including its display delay. - Applications must still supply meaningful names for icon-only buttons. Automated checks cover DOM semantics and keyboard interaction in React 18/19; test composed screens with a browser and screen reader as well. See the [WAI-ARIA date combobox example](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-datepicker/) and [Tabs pattern](https://www.w3.org/WAI/ARIA/apg/patterns/tabs/). --- url: https://rickyshin93.github.io/tao-ui/guide/agents.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # Working with AI agents tao-ui is an MIT React component library for React and React DOM 18.2 or 19. Components support provider defaults, semantic `classNames` and `styles`, and OKLCH seed themes. The same bilingual references serve people and coding agents. ## Read the right source | Source | Use it for | | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- | | [agent-manifest.json](https://rickyshin93.github.io/tao-ui/agent-manifest.json) | Website package version, peer dependencies, exact component import paths, and English/Chinese HTML and Markdown URLs | | [component-manifest.json](https://rickyshin93.github.io/tao-ui/component-manifest.json) | Component descriptions, usage guidance, semantic parts, related components and selected props | | [llms.txt](https://rickyshin93.github.io/tao-ui/llms.txt) | A small navigation index; fetch only relevant pages | | [llms-full.txt](https://rickyshin93.github.io/tao-ui/llms-full.txt) | All English documentation when bulk context is necessary | | Installed `.d.ts` and generated component API tables | Exact prop types, callback signatures and supported overloads | `agent-manifest.json` is this project's discovery format, with `schemaVersion: 1`; it is not an MCP server or a universal agent protocol. The website tracks the current release. Check its package version against your installed dependency before copying an API. The metadata's `props` list is curated and can be incomplete; use declarations for the full contract. ## Generate a component safely 1. Read the installed package version and peer requirements. 2. Find the component in the discovery index, then fetch its Markdown page for examples and the API table. 3. Follow the documented import path. `TaoProvider` uses `/provider`; `HeadlessInputNumber` and `useNumberInput` use `/number-input`. 4. Wrap the application with `TaoProvider`; use `classNames` / `styles` with documented semantic parts for customization. 5. Run the application's typecheck and exercise the relevant interaction. Check narrow viewports for responsive controls. ```tsx import { Button } from '@rockshin/tao-ui/button'; import { TaoProvider } from '@rockshin/tao-ui/provider'; export default function App() { return ( ); } ``` Component entries include their CSS and shared theme styles. No separate CSS import is required. The package root is also supported and includes all component styles. React is a peer dependency; the date pickers' `dayjs` is installed automatically. For Next.js App Router, place interactive usage in a client component (`'use client'`). Use tao-ui's API documentation and type declarations as the component contract. For example, form controls distinguish an omitted `value` from `value={undefined}`; follow the [getting started guide](https://rickyshin93.github.io/tao-ui/guide/getting-started.md#control-field-values). ## Read installed metadata ```ts import { getComponentDoc } from '@rockshin/tao-ui/meta'; const button = getComponentDoc('button'); console.log(button?.semanticParts); ``` Node tools can resolve plain JSON without importing UI code: ```js import { readFileSync } from 'node:fs'; import { createRequire } from 'node:module'; const require = createRequire(import.meta.url); const file = require.resolve('@rockshin/tao-ui/component-manifest.json'); const manifest = JSON.parse(readFileSync(file, 'utf8')); console.log(manifest.components.find((item) => item.name === 'button')); ``` The installed package also includes `llms.txt`. Source/story/test paths inside component metadata refer to the repository; they are not HTTP routes or files promised inside the npm package. ## Browser tools Rspress enables six documentation tools through experimental WebMCP: `rspress_get_site_info`, `rspress_list_pages`, `rspress_get_page`, `rspress_get_current_page`, `rspress_search_docs`, and `rspress_navigate`. They require a browser supporting `document.modelContext` on HTTPS or localhost. A browser without it can still read the JSON and Markdown URLs above. No API key or hosted MCP service is required. These tools read and navigate documentation; they do not execute your application or establish that generated code passes its tests. See the [Rspress WebMCP documentation](https://www.rspress.rs/guide/basic/webmcp). --- url: https://rickyshin93.github.io/tao-ui/guide/changelog.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # Changelog User-facing changes for `@rockshin/tao-ui`, listed by release. Dates use UTC+8. ## 0.0.57 2026-11-16 - [Form](https://rickyshin93.github.io/tao-ui/components/form.md) clears stale validation errors when values are written through `setFields` or the controlled `fields` prop; entries that carry `errors` or `warnings` still apply their own validation state. - [Modal](https://rickyshin93.github.io/tao-ui/components/modal.md) focuses the configured button on every open cycle and restores focus to the trigger on close, including when content is retained between opens. - [Select](https://rickyshin93.github.io/tao-ui/components/select.md) keeps rich node labels intact in multiple-mode tags while text and number labels are still truncated by `maxTagTextLength`. - [Steps](https://rickyshin93.github.io/tao-ui/components/steps.md) adds `finishIconBackground` and `finishIconColor` to style the built-in finished-step circle and check mark. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.56...v0.0.57) ## 0.0.56 2026-11-13 - [Select](https://rickyshin93.github.io/tao-ui/components/select.md) prevents option text from being clipped vertically with consumer fonts. ## 0.0.55 2026-11-13 - [Select](https://rickyshin93.github.io/tao-ui/components/select.md) wraps long option labels on request and keeps selected tags within the control. ## 0.0.54 2026-11-10 - [Textarea](https://rickyshin93.github.io/tao-ui/components/textarea.md) aligns its character count beside the native resize handle at the bottom corner and reserves room for text. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.53...v0.0.54) ## 0.0.53 2026-11-10 - [Textarea](https://rickyshin93.github.io/tao-ui/components/textarea.md) places the character count inside the control without adding a separate row. - [Upload](https://rickyshin93.github.io/tao-ui/components/upload.md) keeps picture-card action backgrounds transparent over the image mask. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.52...v0.0.53) ## 0.0.52 2026-11-10 - [Upload](https://rickyshin93.github.io/tao-ui/components/upload.md) aligns picture cards, circular tiles, thumbnails and file actions; card triggers follow the file list and can be hidden with `null` or `false`. Uploading files show progress, and download actions appear for completed files. Dragger height applies to the drop zone independently of the file list. - [Input](https://rickyshin93.github.io/tao-ui/components/input.md) preserves the password placeholder font when toggling visibility. [Modal](https://rickyshin93.github.io/tao-ui/components/modal.md) reserves vertical space around its body content so control focus rings remain visible. - Upload documentation adds expanded bilingual examples and API guidance, original demo artwork, and a responsive two-column layout. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.51...v0.0.52) ## 0.0.51 2026-11-08 - Button sizes nested SVG icons consistently while respecting explicit dimensions; Input centers suffix content; Select maintains its intended single-row multiple-selection height; Transfer aligns its selection chevron and disabled state. - The documentation adds a bilingual Showcase and responsive commerce example. Clean builds now prepare the icon package used by the Showcase. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.49...v0.0.51) ## 0.0.50 2026-11-08 - [Button](https://rickyshin93.github.io/tao-ui/components/button.md) sizes nested SVG icons consistently while respecting explicit dimensions. - [Input](https://rickyshin93.github.io/tao-ui/components/input.md) centers suffix content, and [Select](https://rickyshin93.github.io/tao-ui/components/select.md) maintains its intended height for a single row of multiple selections. - [Transfer](https://rickyshin93.github.io/tao-ui/components/transfer.md) aligns the selection menu chevron with Select and clarifies its disabled state. - The documentation adds a bilingual Showcase and a responsive commerce example, alongside refreshed component and home pages. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.49...v0.0.50) ## 0.0.49 2026-11-07 **Data entry and selection** - [Form](https://rickyshin93.github.io/tao-ui/components/form.md) resets controlled field values and keeps validation feedback and native submission in sync. - [Select](https://rickyshin93.github.io/tao-ui/components/select.md) keeps the search query when a controlled multiple selection is declined and matches option values that contain a token separator. - [Upload](https://rickyshin93.github.io/tao-ui/components/upload.md) shows a request setup error on the affected file while the rest of the batch continues. Once a request succeeds or fails, later callbacks cannot change its result. A disabled upload also ignores pasted files. - [RangePicker](https://rickyshin93.github.io/tao-ui/components/range-picker.md) discards unconfirmed text when the user clears the range. If a controlled DatePicker or RangePicker ignores a keyboard request to open and the user leaves the field, opening it later no longer moves focus back. - [Cascader](https://rickyshin93.github.io/tao-ui/components/cascader.md) drops newly selected paths that are removed or become disabled before the user taps Done on mobile. Existing selections the user leaves in place are preserved. - [Table](https://rickyshin93.github.io/tao-ui/components/table.md) applies Select All to eligible rows on the current page, using the latest disabled state. Responsive columns retain their configured default sort when they appear. - [Input](https://rickyshin93.github.io/tao-ui/components/input.md) and [Textarea](https://rickyshin93.github.io/tao-ui/components/textarea.md) accept Enter again after an interrupted input method composition. Textarea autosizing accounts for custom padding and borders. Changes to the arrays passed to CheckboxGroup and Slider callbacks no longer alter component state. **Overlays and display** - [Image](https://rickyshin93.github.io/tao-ui/components/image.md) removes its open preview when preview is disabled. Re-enabling preview leaves it closed until the user opens it again, unless the application controls it as open. - [Modal](https://rickyshin93.github.io/tao-ui/components/modal.md) closes the remaining dialogs when an `afterClose` callback throws during `Modal.destroyAll()`, then reports the error. Tour uses its top-level scroll options unless a step supplies its own, and FloatButton detects outside clicks inside its iframe. - [Badge](https://rickyshin93.github.io/tao-ui/components/badge.md) positions a status dot over wrapped content, including in RTL. Card renders arrays of tab bar extras, and BorderBeam resumes animation when its host element is replaced. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.48...v0.0.49) ## 0.0.48 2026-11-06 **Fixed and improved** - **Form** reserves 24px for single-line feedback (18px for the message, 2px above and 4px below) at 12–14px message font sizes. Messages keep their existing font size, single lines appear without shifting fields, and longer messages wrap. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.47...v0.0.48) ## 0.0.47 2026-11-06 **Fixed and improved** - **Form** restores required and error styles when imported from the form subpath. Feedback takes less space, and fields without validation or messages leave no empty feedback row. - **Cascader** uses a bottom drawer on mobile. Search works inside it, single selection applies immediately, and multiple selection applies on Done. The clear affordance and expand arrow align with the control layout. **Documentation** - The bilingual docs use consistent colors, navigation and side-by-side example layouts. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.46...v0.0.47) ## 0.0.46 2026-11-06 **Added** - **TaoProvider** adds 17 locale packs, available from the package root and individual `@rockshin/tao-ui/locale/*` imports. Provider locale now translates component labels, empty states, modal actions and form validation, including content rendered in portals. - **DatePicker, RangePicker, Calendar and TimePicker** use regional labels and calendar conventions. Localized date and time formats support parsing user input, and per-component locale overrides take precedence. - **InputNumber and Statistic** display regional digits and separators. InputNumber continues to emit exact decimal strings, and date pickers retain their default output formats unless a localized format is selected. **Documentation** - Updated the bilingual site with a vector logo, dark-mode artwork and a favicon. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.45...v0.0.46) ## 0.0.45 2026-11-06 **Added** - **TaoProvider** adds `direction`. Components and portals inherit direction, and individual components can override it or use native `dir="auto"`. **Fixed and improved** - **RTL** fixes horizontal scroll, Splitter dragging, Rate input, pagination icons, Table alignment and fixed columns, and keyboard interaction in selection controls. Desktop and mobile popups keep their source direction. **Compatibility** - **Segmented** no longer hits a React 18 maximum update depth error during keyboard navigation. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.44...v0.0.45) ## 0.0.44 2026-11-05 **Added** - **Form** adds `FormInstance.scrollToField(name, options)` for mounted fields, including nested names, `Form.List` paths and `noStyle` items. Options control scrolling and can focus the field. `FormScrollOptions` is exported from the root and form subpath. **Fixed and improved** - The Chinese AI agent guide link resolves to the correct locale URL. **Migration** - Custom controls used as scroll targets should forward a DOM or `nativeElement` ref, or the field ID. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.43...v0.0.44) ## 0.0.43 2026-11-05 **Added** - **Input** adds clear/count support, Password, Search, TextArea, OTP and underlined variants. - **Collapse** supports item panels, accordion behavior and built-in styling. **Fixed and improved** - Improved Calendar and Carousel controls, RadioGroup selection, Form feedback spacing, Tree and TreeSelect checking, and responsive picker titles. Fixed isolated CSS and dark theme details across controls. **Migration** - Replace `Collapsible` and `/collapsible` imports with `Collapse` and `/collapse`. **Documentation** - Redesigned the bilingual site and added agent guides, `agent-manifest.json`, the package's `component-manifest.json` export, and searchable Markdown references. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.42...v0.0.43) ## 0.0.42 2026-11-05 **Added** - Expanded the catalog to 73 visual entries. New entries include Cascader, Tree, TreeSelect, Upload, Transfer, Calendar, ColorPicker, Carousel, and application-scoped feedback via App. - Added public `GetProps`, `GetProp` and `GetRef` utilities for deriving types from components. **Fixed and improved** - Improved responsive selection controls, provider localization and focus handling, and unified the default theme radius to 6px. **Documentation** - Added bilingual runnable examples with independent phone and desktop previews, synchronized dark mode and copyable snippets. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.41...v0.0.42) ## 0.0.41 2026-11-04 **Fixed and improved** - **Select** restores vertical scrolling in height-limited option lists for single, searchable, multiple and tags modes. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.40...v0.0.41) ## 0.0.40 2026-10-30 **Fixed and improved** - **Fields, pickers and overlays** improve native labels, required and disabled semantics, and focus restoration. RangePicker names each endpoint and announces committed selections. Mobile Select exposes its current selection and search label. - **Tabs, Spinner and Tag** expose clearer keyboard or accessibility states. Popover and confirmation dialogs use their visible titles as accessible names. **Compatibility** - Moved tao-ui into a Bun workspace and upgraded its build to Rslib 1.x. The npm package remains `@rockshin/tao-ui`. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.39...v0.0.40) ## 0.0.39 2026-10-18 **Fixed and improved** - **Theme, Table, Tag and Steps** mix colored and neutral tints in OKLab. Primary and status fills stay closer to their intended hue, and Table hover and row separators are easier to distinguish. - **Select** enlarges the `allowClear` hit area so near-edge clicks clear the value without opening the popup. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.38...v0.0.39) ## 0.0.38 2026-10-15 **Added** - **Table** adds sticky headers when `scroll.y` is set, expandable rows via `expandable`, and a `Table.Summary` footer that can be pinned and aligned with fixed columns. **Fixed and improved** - **Table** keeps pinned headers and fixed cells opaque, updates edge shadows on container resize, and covers the full table with the loading mask. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.37...v0.0.38) ## 0.0.37 2026-10-12 **Fixed and improved** - **Popover** uses the normal popup stacking level so a nested Select, Menu or DatePicker can open above its parent Popover. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.36...v0.0.37) ## 0.0.36 2026-10-05 **Fixed and improved** - **Table** keeps sort, filter and pagination callbacks aligned with the same data view and honors controlled state supplied by the parent. - **Select** keeps change, select, deselect and clear notifications in a consistent order. Mobile confirmation emits the committed changes, and cancelling discards the draft. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.35...v0.0.36) ## 0.0.35 2026-09-13 **Fixed and improved** - **Tabs** renders the animated active indicator with square ends, avoiding pointed caps as it scales to the selected tab's width. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.34...v0.0.35) ## 0.0.34 2026-09-13 **Added** - Added **Steps** with numbered progress, per-step status, keyboard-activatable items and `maxCount` for collapsing long workflows. **Fixed and improved** - **Table** keeps row dividers visible over colored rows and clips cell backgrounds inside rounded table corners. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.33...v0.0.34) ## 0.0.33 2026-09-08 **Fixed and improved** - **Select** in tags mode suppresses an empty popup when empty content is disabled. Free-text tag entry, suffix icons, explicit empty content and custom popups still work. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.32...v0.0.33) ## 0.0.32 2026-09-06 **Fixed and improved** - **DatePicker and RangePicker** handle changed date bounds, rejected edits and explicit form clears, and keep visible months synchronized. - **Select, Table, InputNumber and Splitter** fix updates to search, selection, pagination, numeric input and drag state. - **Popover, Modal, Checkbox, Tabs and Form** improve focus handling, label associations, checked-state rendering and cleared boolean values. **Compatibility** - Added React 18.2 support alongside React 19, including ref compatibility, and component subpath exports for importing an individual component with its styles. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.31...v0.0.32) ## 0.0.31 2026-09-01 **Fixed and improved** - **Table** fixed headers use the active variant's background. Fixed columns gain edge shadows when there is more content to scroll into view. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.30...v0.0.31) ## 0.0.30 2026-08-28 **Added** - **Button** adds the `bare` variant for retaining interaction behavior with caller-defined visuals. **Fixed and improved** - **Button** defaults move to a low-specificity component layer so consumer classes can override color, spacing and shape. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.29...v0.0.30) ## 0.0.29 2026-08-27 **Fixed and improved** - **Input** geometrically centers the native text line box so the caret and selection align with the control's height. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.28...v0.0.29) ## 0.0.28 2026-08-25 **Fixed and improved** - **Textarea** uses low-specificity defaults in the component cascade layer, letting Semantic DOM classes override the inner textarea's styles. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.27...v0.0.28) ## 0.0.27 2026-08-19 **Fixed and improved** - **DatePicker and RangePicker** restore the controlled value after rejected edits and cancel unfinished range selection when closing or receiving a new value. - **Select** keeps the first option when resolving duplicate values. **Sonner** keeps a recreated toast visible when an earlier instance's exit timer completes and cleans up loading toasts when promises settle. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.26...v0.0.27) ## 0.0.26 2026-08-19 **Added** - Added **Form** with field validation, lists and dependency tracking, plus **Alert**, **Popover**, **Popconfirm** and **Tooltip**. - **Table** columns accept responsive breakpoints. Added public responsive helpers and theme token utilities. **Fixed and improved** - **Button** keeps a typographic line box while flex-centering content to improve alignment across consumer fonts. **Documentation** - Added bilingual Rspress references with runnable examples and API tables. [Documentation PR](https://github.com/rickyshin93/tao-ui/pull/2) [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.25...v0.0.26) ## 0.0.25 2026-08-04 **Fixed and improved** - **Input** centers text and password dots independently so aligning the mask glyphs does not shift the password selection line box. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.24...v0.0.25) ## 0.0.24 2026-08-04 **Fixed and improved** - **Input** uses size-aware vertical padding to center native text and password mask glyphs. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.23...v0.0.24) ## 0.0.23 2026-08-04 **Fixed and improved** - **Input** clips browser autofill paint within rounded control edges and preserves the text's normal vertical metrics. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.22...v0.0.23) ## 0.0.22 2026-08-03 **Added** - Added typed Semantic DOM contracts for visual components, with dedicated metadata and theme helper imports. **Fixed and improved** - **DatePicker** improves keyboard navigation, **FormField** associates labels and help with controls, and **Select** keeps selected option checkmarks within the popup width. - **Button** aligns icon size and text spacing. **TaoProvider** respects disabled motion and resets inherited theme seeds when `inherit={false}`. **Migration** - Import metadata and token helpers from `@rockshin/tao-ui/meta` and `@rockshin/tao-ui/tokens` when moving from their former root exports. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.21...v0.0.22) ## 0.0.21 2026-07-26 **Added** - **Input** supports React SVG prefixes with automatic positioning and space reserved for typed text. **Fixed and improved** - **Drawer and Modal** close on an actual mask click when enabled. Interacting with a nested portal keeps the dialog open. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.20...v0.0.21) ## 0.0.20 2026-07-25 **Fixed and improved** - **Input** removes duplicate start padding when a prefix is present, so the text starts next to the prefix at the intended spacing. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.19...v0.0.20) ## 0.0.19 2026-07-25 **Compatibility** - Refreshed the Rslib, Rstest and Storybook development toolchain and synchronized the Bun lockfile during releases. This patch contains no component changes. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.18...v0.0.19) ## 0.0.18 2026-07-25 **Added** - **TaoProvider** adds dark mode via `theme.mode`. Nested providers inherit the mode and portaled components carry their source theme. [PR #1](https://github.com/rickyshin93/tao-ui/pull/1) - **DatePicker and RangePicker** accept strictly formatted typed dates on desktop and retain the drawer on mobile. Searchable **Select** supports editable desktop single selection and inline search for multiple and tags modes. **Fixed and improved** - **Input and RangePicker** improve prefix and text alignment. Table, Tag, Modal and Drawer derive their surfaces and overlays from theme tokens. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.17...v0.0.18) ## 0.0.17 2026-07-12 **Added** - **Button** adds `icon` and `loadingIcon`. The icon slot stays mounted while switching to loading, preventing layout flicker. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.16...v0.0.17) ## 0.0.16 2026-07-12 **Fixed and improved** - **Sonner** measures toast heights for expanded stacking, preserves positions during removal, and improves enter/exit motion and the close button's hit area. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.15...v0.0.16) ## 0.0.15 2026-07-12 **Added** - Added **Sonner** and the imperative `toast()` API, including rich colors, custom content, action buttons and promise-driven loading, success and error states. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.14...v0.0.15) ## 0.0.14 2026-07-10 **Added** - **Select** adds search, multiple and tags modes, custom tag rendering, selection limits and a mobile drawer with confirmation for multiple selection. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.13...v0.0.14) ## 0.0.13 2026-07-09 **Fixed and improved** - **Checkbox and Radio** keep their native inputs within the visual control box so they remain focusable and clickable without intercepting clicks outside the control. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.12...v0.0.13) ## 0.0.12 2026-07-05 **Fixed and improved** - **Select, DatePicker, RangePicker, Dropdown and menus** apply portal theme tokens directly to popup elements, avoiding leftover wrapper nodes for closed popups. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.11...v0.0.12) ## 0.0.11 2026-07-05 **Added** - Added a component metadata manifest and public component prop and Semantic DOM types. **Fixed and improved** - **Breadcrumb** renders action items as buttons. **DatePicker** uses focusable native buttons for dates, with accessible names and disabled states. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.10...v0.0.11) ## 0.0.10 2026-07-05 **Fixed and improved** - **FormSection** removes extra spacing caused by native fieldset and legend layout. Portal theme scopes are layout-transparent in flex and grid. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.9...v0.0.10) ## 0.0.9 2026-07-04 **Added** - Added **InputNumber**, a themed numeric field with grouping, caret preservation, and canonical string values for precision. Also exposes headless numeric input building blocks. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.8...v0.0.9) ## 0.0.8 2026-07-03 **Added** - **Table** adds row and cell props via `onRow`, `onHeaderRow`, `onCell` and `onHeaderCell`, plus row styles and callback-based Semantic DOM customization. **Fixed and improved** - **Tag** adjusts spacing and line height so its text and icon align more consistently. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.7...v0.0.8) ## 0.0.7 2026-07-03 **Added** - **Table** defaults to the new `modern` variant with a subtle frame and lighter header. Existing variants can still be selected explicitly. **Fixed and improved** - **Select** centers text and icons and allows keyboard clearing with Enter or Space. **Tag** refines semantic color fills and close button styling. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.6...v0.0.7) ## 0.0.6 2026-07-02 **Fixed and improved** - **TaoProvider** recalculates derived tokens inside nested providers and keeps children in their parent flex or grid layout. Equivalent inline token values avoid unnecessary context updates. - **Theme and Button** update the default radius from 6px to 10px, refine focus rings and borders, and adjust button text weight and shadows. **Migration** - **Input, Textarea, Select and date pickers** fill the available width by default. Set the width explicitly if a layout relied on the old 200px default. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.5...v0.0.6) ## 0.0.5 2026-07-01 **Fixed and improved** - **Input** fills the available width in a flex row. Single-row **Textarea** matches the Input height for the same size. **Compatibility** - The package preserves entry-point CSS with strict tree shaking. **Migration** - Set `rows={3}` to keep the previous taller Textarea default. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.4...v0.0.5) ## 0.0.4 2026-06-08 **Compatibility** - Replaced Tailwind and PostCSS-generated styles with native CSS and centralized theme and control style imports at the package entry point. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.3...v0.0.4) ## 0.0.3 2026-06-07 **Added** - **Select** adds an Ant Design-style single-select API for controlled opening, popup placement and width, custom rendering, grouped options and semantic styling. - Added **Spinner** with delay, custom indicator, content overlay and fullscreen modes. **Fixed and improved** - Portaled controls inherit theme tokens. Popup layers render above Modal and Drawer, and clearing Select keeps the popup closed. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.2...v0.0.3) ## 0.0.2 2026-06-07 **Added** - Added **Breadcrumb, Collapsible, ContextMenu, Dropdown and Textarea**. Textarea supports shared control variants and `autoSize` with minimum and maximum rows. - Added **Modal** with a controlled `open` prop, imperative confirmation and status methods, and `Modal.useModal()`. **Fixed and improved** - Form controls share focus and variant styles. Container and elevated surfaces use white with derived neutral colors. [Compare changes](https://github.com/rickyshin93/tao-ui/compare/v0.0.1...v0.0.2) ## 0.0.1 2026-06-06 **Added** - Initial release of **@rockshin/tao-ui** for React 19, with semantic DOM customization and OKLCH theme tokens. --- url: https://rickyshin93.github.io/tao-ui/components/border-beam.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # BorderBeam General`@rockshin/tao-ui` [Examples](#examples)[API](#api) Highlights an active surface with a moving border light. This native tao-ui component follows the public API of Ant Design 6.7.0. Appearance, theme tokens and Semantic DOM customization belong to tao-ui; configure themes with `TaoProvider`. Props follow the 6.7.0 beam API. The child must expose a native DOM ref or nativeElement handle. Motion uses transform and respects reduced-motion preferences. ## When to use Use sparingly for a meaningful active or processing state. Keep an explicit text status alongside the effect. ## Examples ### Active card ```tsx preview import { BorderBeam, Card } from "@rockshin/tao-ui"; export default function Example() { return ( 12 tasks are running. ); } ``` ### Count and duration ```tsx preview import { BorderBeam, Card } from "@rockshin/tao-ui"; export default function Example() { return ( Two highlights follow the same border with evenly spaced phases. ); } ``` ### Custom gradient and item overrides ```tsx preview import { BorderBeam, Card } from "@rockshin/tao-ui"; export default function Example() { return ( Each item controls its own color, size and line width. ); } ``` ### Inset and nonuniform corners ```tsx preview import { BorderBeam, Card } from "@rockshin/tao-ui"; export default function Example() { return ( The effect follows the top rounded corners and the square bottom corners. ); } ``` ### Toggle a meaningful active state ```tsx preview import { useState } from "react"; import { BorderBeam, Button, Card } from "@rockshin/tao-ui"; export default function Example() { const [active, setActive] = useState(true); return (
The border animation follows the current state.
); } ``` ## API ### [#](#borderbeam)BorderBeam | Property | Description | Type | Default Value | | --- | --- | --- | --- | | className | Additional css class | `string | undefined` | `-` | | style | Additional style | `CSSProperties | undefined` | `-` | --- url: https://rickyshin93.github.io/tao-ui/components/button.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # Button General`@rockshin/tao-ui` [Examples](#examples)[API](#api) Use `Button` for immediate actions such as submitting a form, saving changes, or opening a surface. ## Examples ### Variants Use one primary action per view or decision area. Secondary, ghost, and destructive variants reduce or clarify emphasis. Bare preserves button behavior while leaving its visual treatment to consumer classes or styles. ```tsx preview import { Button } from '@rockshin/tao-ui'; function ButtonVariants() { return (
); } export default ButtonVariants; ``` ### Sizes Use `small` for dense toolbars, `medium` for most actions, and `large` for prominent calls to action. ```tsx preview import { Button } from '@rockshin/tao-ui'; function ButtonSizes() { return (
); } export default ButtonSizes; ``` ### Loading and disabled Loading buttons set `aria-busy` and prevent repeated interaction. Their icon slot stays mounted, so switching states does not shift the content. ```tsx preview import { useState } from 'react'; import { Button } from '@rockshin/tao-ui'; function ButtonStates() { const [saving, setSaving] = useState(false); function save() { setSaving(true); window.setTimeout(() => setSaving(false), 1200); } return (
); } export default ButtonStates; ``` ### Icons and custom loading Pass a decorative leading icon with `icon`. Explicit SVG dimensions are preserved; unspecified dimensions default to the button's font size. Use `loadingIcon` only when the built-in spinner does not match the surrounding visual language. ```tsx preview import { Button } from '@rockshin/tao-ui'; function DownloadIcon() { return ( ); } function ProgressIcon() { return ( ); } function ButtonIcons() { return (
); } export default ButtonIcons; ``` ### Provider defaults Buttons inherit `size` and `disabled` from `TaoProvider`. A local prop can override the inherited size. ```tsx preview import { Button, TaoProvider } from '@rockshin/tao-ui'; function ButtonProviderDefaults() { return (
); } export default ButtonProviderDefaults; ``` ### Semantic customization Customize the stable `root` part without depending on private selectors. ```tsx preview import { Button } from '@rockshin/tao-ui'; function CustomizedButton() { return ( ); } export default CustomizedButton; ``` ### Native form actions Submit and reset use native form semantics; no network request is sent. ```tsx preview import { useState } from 'react'; import { Button, Input, Stack } from '@rockshin/tao-ui'; export default function Example() { const [result, setResult] = useState(''); return (
{ e.preventDefault(); setResult(String(new FormData(e.currentTarget).get('name'))); }} onReset={() => setResult('')} > {result ? `Saved: ${result}` : 'Edit and save'}
); } ``` ### Icon-only buttons Provide a name with aria-label and hide decorative icons from assistive technology. ```tsx preview import { useState } from 'react'; import { Button } from '@rockshin/tao-ui'; export default function Example() { const [count, setCount] = useState(0); return (
{count} items
); } ``` ### Provider defaults and overrides Set shared size and disabled defaults, then override a single button. ```tsx preview import { Button, Stack, TaoProvider } from '@rockshin/tao-ui'; export default function Example() { return ( ); } ``` ## API ### [#](#button)Button | Property | Description | Type | Default Value | | --- | --- | --- | --- | | disabled | Prevents interaction. Inherits from TaoProvider. | `boolean | undefined` | `-` | | children | Button label or inline content. | `ReactNode` | `-` | | variant | Visual emphasis for the action. | `"primary" | "secondary" | "ghost" | "destructive" | "bare" | undefined` | `primary` | | size | Control height and horizontal spacing. Inherits from TaoProvider. | `TaoSize | undefined` | `-` | | loading | Shows the loading icon, sets aria-busy, and prevents interaction. | `boolean | undefined` | `-` | | icon | Left-leading decorative icon (non-loading state). | `ReactNode` | `-` | | loadingIcon | Icon shown while loading. Defaults to a built-in spinner. | `ReactNode` | `-` | | classNames | Semantic class overrides keyed by ButtonSemanticPart. | `Partial> | undefined` | `-` | | styles | Semantic style overrides keyed by ButtonSemanticPart. | `Partial> | undefined` | `-` | --- url: https://rickyshin93.github.io/tao-ui/components/icons.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # Icons Explore rounded line icons for everyday interfaces and insurance workflows. Browse by category or search by name or keyword. Select an icon to copy its import. ## Installation The icons support React 18.2 and later and are available under the [MIT License ](/tao-ui/tao-icons-LICENSE.txt). ```sh npm install @rockshin/tao-icons ``` ## Icon catalog 2060 / 2060 icons ### Navigation 147 icons arrow-big-downarrow-big-down-dasharrow-big-leftarrow-big-left-dasharrow-big-rightarrow-big-right-dash ### Actions 23 icons closecopydownloadfilterfunnellink ### Files & documents 105 icons archivearchive-restorearchive-xbook-openbookmarkbookmark-minus ### Editing 88 icons axis-3dblendbrushcomponentcropdecimals-arrow-left ### Layout & typography 263 icons a-arrow-downa-arrow-upa-large-smallalign-bottomalign-centeralign-center-vertical ### People & security 114 icons awardbadgebadge-alertbadge-checkbadge-infobell-check ### Communication 119 icons at-signbadge-minusbadge-percentbadge-plusbadge-xballoon ### Media 100 icons adairplayapertureaudio-linesaudio-lines-offaudio-lines-x ### Time & status 77 icons alarm-clockalarm-clock-offalert-circlealert-trianglebell-minusbell-plus ### Devices 76 icons alarm-clock-checkalarm-clock-minusalarm-clock-plusantennabattery-mediumbattery-plus ### Developer tools 92 icons bitcoinblocksbook-copybook-dashedbook-downbook-key ### Commerce & places 99 icons anvilbadge-centbadge-dollar-signbadge-eurobadge-indian-rupeebadge-japanese-yen ### Everyday utility 22 icons axeboltbroombroom-sparkleschart-columnchart-line ### Lines & insured objects 12 icons insurance-accidentinsurance-autoinsurance-commercialinsurance-cyberinsurance-engineeringinsurance-health ### Product & rating 11 icons coveragecoverage-exclusioncoverage-limitinsurance-deductiblepolicy-wordingpremium-rating ### Distribution & sales 10 icons broker-networkcommission-paymentcommission-planembedded-insuranceinsurance-agentinsurance-needs ### Quote & application 10 icons applicantapplication-submitbeneficiarybenefit-illustrationelectronic-signatureinsurance-application ### Underwriting 10 icons medical-underwritingrisk-accumulationrisk-scorerisk-surveyunderwriting-acceptunderwriting-conditions ### Policy lifecycle 13 icons coverage-periodinsurance-certificateinsurance-policypolicy-bindpolicy-cancelpolicy-endorsement ### Billing & payments 44 icons agency-billingarmenian-dramautomatic-paymentbangladeshi-takabanknote-arrow-downbanknote-arrow-up ### Claims 16 icons claim-appealclaim-assignmentclaim-caseclaim-coverage-checkclaim-denialclaim-investigation ### Reinsurance & coinsurance 8 icons coinsurance-sharereinsurance-assumedreinsurance-bordereaureinsurance-cessionreinsurance-facultativereinsurance-recovery ### Health & group 12 icons benefit-accumulatorbenefit-planbenefit-statementcost-sharinggroup-policymedical-claim-pricing ### Life & annuities 9 icons annuity-paymentfund-switchmaturity-benefitpartial-withdrawalpolicy-cash-valuepolicy-loan ### Compliance & operations 8 icons complaint-casecustomer-verificationinsurance-ledgerregulatory-reportsanctions-screeningservice-network ### Actions & form controls 24 icons check-checkcheckboxcheckbox-checkedcheckbox-indeterminatecircle-minuscircle-plus ### Data & charts 38 icons activitycalculatorchart-areachart-barchart-bar-bigchart-bar-decreasing ### Connectivity 60 icons batterybattery-chargingbattery-fullbattery-lowbattery-warningbluetooth-connected ### Accessibility 18 icons accessibilitybabybadge-question-markcaptionsclosed-captioncontrast ### Development & AI 19 icons botbracketsbrainchart-networkcloud-checkcloud-off ### Animals & nature 37 icons birdbirdhousebonecannabiscannabis-offcat ### Food & drink 76 icons amphoraappleavocadobaconbananabarrel ### Games & sports 49 icons backpackbow-arrowchess-bishopchess-kingchess-knightchess-pawn ### Health & medicine 34 icons ambulancebandagebone-fracturebrain-offbriefcase-medicalcross ### Home & living 39 icons air-ventalarm-smokearmchairbedbed-doublebed-single ### Math & science 48 icons angleatombeakerbiohazardbrain-circuitbrain-cog ### Shapes & symbols 33 icons astroidboxboxescircle-dashed-checkcircle-offcircle-pile ### Transport & travel 63 icons anchorbaggage-claimbathbikebridgebriefcase ### Weather & seasons 34 icons bubblescloud-drizzlecloud-fogcloud-hailcloud-lightningcloud-moon ## React examples ### Basic usage Import named icons from the package. Icons render at 24px by default. ```tsx preview import { HomeIcon, SearchIcon, SettingsIcon } from '@rockshin/tao-icons'; export default function BasicIcons() { return (
); } ``` ### Size and stroke Set size to change the dimensions and strokeWidth to adjust line weight. ```tsx preview import { StarIcon } from '@rockshin/tao-icons'; export default function IconSizing() { return (
); } ``` ### Color Icons inherit the text color. Set color to override an individual icon. ```tsx preview import { HeartIcon, CircleCheckIcon, TriangleAlertIcon } from '@rockshin/tao-icons'; export default function IconColors() { return (
); } ``` ### Buttons and accessibility Icons in labeled buttons can stay decorative. Give icon-only buttons an accessible name. ```tsx preview import { DownloadIcon, SettingsIcon } from '@rockshin/tao-icons'; import { Button } from '@rockshin/tao-ui'; export default function IconButtons() { return (
); } ``` ### State changes Use React state to switch icons. Try the button in the preview. ```tsx preview import { useState } from 'react'; import { VolumeIcon, VolumeOffIcon } from '@rockshin/tao-icons'; import { Button } from '@rockshin/tao-ui'; export default function VolumeToggle() { const [muted, setMuted] = useState(false); return ( ); } ``` ### Per-icon import Each icon has a dedicated import path. Use title to name a standalone icon. ```tsx preview import { ArrowRightIcon } from '@rockshin/tao-icons/icons/arrow-right'; export default function DirectImport() { return ; } ``` --- url: https://rickyshin93.github.io/tao-ui/components/float-button.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # FloatButton General`@rockshin/tao-ui` [Examples](#examples)[API](#api) Provides persistent floating actions and a return-to-top control. This native tao-ui component follows the public API of Ant Design 6.7.0. Appearance, theme tokens and Semantic DOM customization belong to tao-ui; configure themes with `TaoProvider`. Buttons, Group and BackTop follow 6.7.0. Tooltips and badges use tao-ui components; scroll animations respect reduced motion. Fixed controls are isolated in iframe previews. ## When to use Use for a few actions that apply across the current screen. Provide accessible labels for icon-only buttons. ## Examples ### Basic action and tooltip ```tsx preview="iframe-follow" import { useState } from "react"; import { FloatButton } from "@rockshin/tao-ui"; export default function Example() { const [count, setCount] = useState(0); return (

Action count: {count}

setCount(count + 1)} />
); } ``` ### Shape, content and badge ```tsx preview="iframe-follow" import { FloatButton } from "@rockshin/tao-ui"; export default function Example() { return (
); } ``` ### Click group and placement ```tsx preview="iframe-follow" import { useState } from "react"; import { FloatButton } from "@rockshin/tao-ui"; export default function Example() { const [selected, setSelected] = useState("None"); return (

Selected: {selected}

setSelected("Action A")} /> setSelected("Action B")} />
); } ``` ### Controlled group ```tsx preview="iframe-follow" import { useState } from "react"; import { Button, FloatButton } from "@rockshin/tao-ui"; export default function Example() { const [open, setOpen] = useState(false); return (
); } ``` ### Hover and disabled actions ```tsx preview="iframe-follow" import { FloatButton } from "@rockshin/tao-ui"; export default function Example() { return (
); } ``` ### Return to a scroll container top ```tsx preview="iframe-follow" import { useRef } from "react"; import { FloatButton } from "@rockshin/tao-ui"; export default function Example() { const target = useRef(null); return (

Scroll down to reveal BackTop.

target.current!} visibilityHeight={120} showProgress duration={250} />
); } ``` ## API ### [#](#floatbutton)FloatButton | Property | Description | Type | Default Value | | --- | --- | --- | --- | | className | Additional css class | `string | undefined` | `-` | | style | Additional style | `CSSProperties | undefined` | `-` | | disabled | Whether to disable | `boolean | undefined` | `-` | --- url: https://rickyshin93.github.io/tao-ui/components/watermark.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # Watermark General`@rockshin/tao-ui` [Examples](#examples)[API](#api) Repeats text or an image across content and inherited dialogs. This native tao-ui component follows the public API of Ant Design 6.7.0. Appearance, theme tokens and Semantic DOM customization belong to tao-ui; configure themes with `TaoProvider`. Canvas drawing follows the 6.7.0 content/font/gap/offset API. Modal and Drawer inherit by default; inherit=false disables portal inheritance. Removed or changed overlays are restored. ## When to use Use to mark an owner, workspace or document classification while keeping the content readable. ## Examples ### Text watermark ```tsx preview import { Watermark } from "@rockshin/tao-ui"; export default function Example() { return (

Workspace report

Content remains selectable and interactive.

); } ``` ### Multiple lines and fonts ```tsx preview import { Watermark } from "@rockshin/tao-ui"; export default function Example() { return (
); } ``` ### Rotation, gap and offset ```tsx preview import { Watermark } from "@rockshin/tao-ui"; export default function Example() { return (
); } ``` ### Image with text fallback ```tsx preview import { Watermark } from "@rockshin/tao-ui"; const image = `data:image/svg+xml,${encodeURIComponent('TAO')}`; export default function Example() { return (
); } ``` ### Inherited Modal and Drawer ```tsx preview="iframe-follow" import { useState } from "react"; import { Button, Drawer, Modal, Watermark } from "@rockshin/tao-ui"; export default function Example() { const [panel, setPanel] = useState(""); return (
{" "} setPanel("")} title="Marked modal" footer={null} >
This portaled panel inherits the watermark.
setPanel("")} title="Marked drawer" >

The drawer inherits the same watermark.

); } ``` ### Disable portal inheritance ```tsx preview="iframe-follow" import { useState } from "react"; import { Button, Modal, Watermark } from "@rockshin/tao-ui"; export default function Example() { const [open, setOpen] = useState(false); return (
setOpen(false)} title="No inherited mark" footer={null} > Only the containing page has a watermark.
); } ``` ## API ### [#](#watermark)Watermark | Property | Description | Type | Default Value | | --- | --- | --- | --- | --- url: https://rickyshin93.github.io/tao-ui/components/divider.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # Divider Layout`@rockshin/tao-ui` [Examples](#examples)[API](#api) Separates content into readable sections or inline groups. This native tao-ui component follows the public API of Ant Design 6.7.0. Appearance, theme tokens and Semantic DOM customization belong to tao-ui; configure themes with `TaoProvider`. Use titlePlacement for the title position and orientation for the axis. TaoProvider controls the default size. ## When to use Use separators when nearby content has a meaningful boundary. ## Examples ### Sections and titles ```tsx preview import { Divider } from "@rockshin/tao-ui"; export default function Example() { return (

Workspace overview

Activity

Recent changes and updates.

End of report.

); } ``` ### Title placement ```tsx preview import { Divider } from "@rockshin/tao-ui"; export default function Example() { return (
Start Center End Plain label
); } ``` ### Line styles and spacing ```tsx preview import { Divider } from "@rockshin/tao-ui"; export default function Example() { return (
Small Dashed Dotted
); } ``` ### Inline separators and RTL ```tsx preview import { Divider } from "@rockshin/tao-ui"; export default function Example() { return (
Overview Activity Settings
); } ``` ### Semantic styling ```tsx preview import { Divider } from "@rockshin/tao-ui"; export default function Example() { return ( Custom section ); } ``` ## API ### [#](#divider)Divider | Property | Description | Type | Default Value | | --- | --- | --- | --- | | type | @deprecated Use orientation. | `"vertical" | "horizontal" | undefined` | `-` | | orientationMargin | @deprecated Use styles.content margins. | `string | number | undefined` | `-` | --- url: https://rickyshin93.github.io/tao-ui/components/form-layout.md --- > For AI agents: the complete documentation index is available at https://rickyshin93.github.io/tao-ui/llms.txt, the full documentation bundle is available at https://rickyshin93.github.io/tao-ui/llms-full.txt. # FormLayout Layout`@rockshin/tao-ui` [Examples](#examples)[API](#api) Arranges form content with consistent label and control alignment. ## When to use Use FormLayout to keep dense forms aligned and predictable. **Recommended** - Use one layout strategy per form. - Prefer vertical layout on narrow screens. **Avoid** - Do not use the component outside its intended interaction model. ## Examples ### Basic usage ```tsx preview import { Button, FormActions, FormField, FormLayout, FormSection, Input, } from '@rockshin/tao-ui'; function FormLayoutExample() { return ( ); } export default FormLayoutExample; ``` ### Multiple sections ```tsx preview import { Button, FormActions, FormField, FormLayout, FormSection, Input, } from '@rockshin/tao-ui'; function CompleteFormLayout() { return ( ); } export default CompleteFormLayout; ``` ### Semantic customization ```tsx preview import { Button, FormActions, FormLayout } from '@rockshin/tao-ui'; function CustomizedFormLayout() { return (

Layout width is customized through the stable root part.

); } export default CustomizedFormLayout; ``` ### Complete form composition Compose layout, fields, and actions with native submission feedback. ```tsx preview import { useState } from 'react'; import { FormLayout, FormSection, FormField, FormActions, Input, Textarea, Button, } from '@rockshin/tao-ui'; export default function Example() { const [saved, setSaved] = useState(''); return (
{ e.preventDefault(); setSaved(String(new FormData(e.currentTarget).get('name'))); }} onReset={() => setSaved('')} >