@aithe/aithe-ui 26.2.2

package/docs/api/feedback/notification.md

@@ -0,0 +1,33 @@
+# AitheNotification / AitheNotification 通知
+
+> Top-right notification card with auto-dismiss timer and close button.
+> 右上角通知卡片，支持自动消失计时器和关闭按钮。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; content driven by `content` property). | 默认插槽（未使用，内容由 content 属性控制）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| title | String | '' | Notification title text. | 通知标题文本。 |
+| icon | `string` | `''` | Icon name to display before the title. Uses built-in `aithe-icon` names. | 在标题前显示的图标名称，使用 aithe-icon 内置图标名。 |
+| content | String | '' | Notification body text. | 通知正文文本。 |
+| type | 'default' \| 'success' \| 'warning' \| 'danger' | 'default' | Notification color variant. | 通知颜色类型。 |
+| duration | Number | 3200 | Auto-dismiss duration in milliseconds. | 自动消失时长（毫秒）。 |
+| open | Boolean | true | Whether the notification is visible. | 是否显示通知。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-close | — | Emitted when the notification auto-dismisses or is manually closed. | 通知自动消失或手动关闭时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-notification title="Update" icon="info" content="New version available" type="success" duration="3200"></aithe-notification>
+```

package/docs/api/feedback/popover.md

@@ -0,0 +1,32 @@
+# AithePopover / AithePopover 弹出面板
+
+> Click-triggered popover panel anchored to a trigger element.
+> 点击触发的弹出面板，锚定于触发元素。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot for the trigger element. | 触发元素内容。 |
+| content | Custom popover content. | 自定义弹出面板内容。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| placement | 'top' \| 'right' \| 'bottom' \| 'left' | 'bottom' | Popover placement relative to trigger. | 弹出面板相对于触发元素的位置。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-open-change | { open } | Emitted when open state changes. | 开关状态变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-popover placement="bottom">
+  <button>Click me</button>
+  <slot name="content"><p>Popover content here.</p></slot>
+</aithe-popover>
+```

package/docs/api/feedback/toast.md

@@ -0,0 +1,33 @@
+# AitheToast / AitheToast 轻提示
+
+> Auto-dismiss toast message displayed at the top of the viewport.
+> 自动消失的轻提示消息，显示在视口顶部。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; content driven by `content` property). | 默认插槽（未使用，内容由 content 属性控制）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| content | String | '' | Toast message text. | 提示消息文本。 |
+| title | `string` | `''` | Display title (shown as tooltip). | 显示标题（作为工具提示）。 |
+| icon | `string` | `''` | Icon name to display before the content. | 在内容前显示的图标名称。 |
+| type | 'default' \| 'success' \| 'warning' \| 'danger' | 'default' | Toast color variant. | 提示颜色类型。 |
+| duration | Number | 2400 | Auto-dismiss duration in milliseconds. | 自动消失时长（毫秒）。 |
+| visible | Boolean | true | Whether the toast is currently visible. | 是否当前可见。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-close | — | Emitted when the toast auto-dismisses after duration. | 自动消失后触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-toast content="Saved successfully" title="Success" icon="check" type="success" duration="2400"></aithe-toast>
+```

package/docs/api/feedback/tooltip.md

@@ -0,0 +1,34 @@
+# AitheTooltip / AitheTooltip 工具提示
+
+> Tooltip overlay that appears on hover/focus over an anchor element.
+> 工具提示浮层，在悬停/聚焦锚点元素时显示。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot for the anchor element. | 锚点元素内容。 |
+| content | Custom tooltip content (overrides `content` property). | 自定义工具提示内容。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| content | String | '' | Tooltip text content. | 工具提示文本内容。 |
+| title | `string` | `''` | Display title (shown as tooltip). | 显示标题（作为工具提示）。 |
+| icon | `string` | `''` | Icon name to display before the tooltip content. | 在工具提示内容前显示的图标名称。 |
+| placement | 'top' \| 'right' \| 'bottom' \| 'left' | 'top' | Tooltip placement relative to anchor. | 工具提示相对于锚点的位置。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-open-change | { open } | Inherited from AnchoredOverlay; emitted on open state change. | 开关状态变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-tooltip content="Help text here" title="Help" icon="info" placement="top">
+  <button>Hover me</button>
+</aithe-tooltip>
+```

package/docs/api/form/checkbox-group.md

@@ -0,0 +1,34 @@
+# AitheCheckboxGroup / AitheCheckboxGroup 复选框组
+
+> Checkbox group container that manages collective checked values.
+> 复选框组容器，管理所有子复选框的选中值集合。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot for aithe-checkbox children. | 子复选框内容。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| valueJson | String | '' | JSON string of the current checked values. | 当前选中值的 JSON 字符串。 |
+| value | string[] | [] | Array of currently checked values. | 当前选中值数组。 |
+| disabled | Boolean | false | Whether all child checkboxes are disabled. | 是否禁用所有子复选框。 |
+| name | String | '' | Name attribute propagated to child checkboxes. | 传递给子复选框的 name 属性。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { value: string[] } | Emitted when the group value changes. | 组值变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-checkbox-group value='["a","b"]' name="options">
+  <aithe-checkbox value="a">Option A</aithe-checkbox>
+  <aithe-checkbox value="b">Option B</aithe-checkbox>
+</aithe-checkbox-group>
+```

package/docs/api/form/checkbox.md

@@ -0,0 +1,34 @@
+# AitheCheckbox / AitheCheckbox 复选框
+
+> Checkbox input with label slot and indeterminate state.
+> 复选框输入组件，支持标签插槽和半选状态。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot for checkbox label text. | 复选框标签文本。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| checked | Boolean | false | Whether the checkbox is checked. | 是否选中。 |
+| indeterminate | Boolean | false | Whether the checkbox is in indeterminate (partial) state. | 是否处于半选（不确定）状态。 |
+| disabled | Boolean | false | Whether the checkbox is disabled. | 是否禁用。 |
+| value | String | '' | Value submitted when checked (used in groups). | 选中时提交的值（在组中使用）。 |
+| name | String | '' | Name attribute for form submission. | 表单提交的 name 属性。 |
+| groupDisabled | Boolean | false | Disabled state propagated from parent checkbox-group. | 从父级复选框组传递的禁用状态。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { checked, value } | Emitted when checked state changes (standalone). | 选中状态变更时触发（独立使用）。 |
+| aithe-checkbox-toggle | { checked, value } | Emitted inside checkbox-group for group coordination. | 在复选框组内触发以协调状态。 |
+
+## Examples / 示例
+
+```html
+<aithe-checkbox value="opt1" checked>Option 1</aithe-checkbox>
+```

package/docs/api/form/color-picker.md

@@ -0,0 +1,33 @@
+# AitheColorPicker / AitheColorPicker 颜色选择器
+
+> Color picker built on native color input with optional alpha channel.
+> 基于原生颜色输入的颜色选择器，支持可选的透明度通道。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; picker is self-contained). | 默认插槽（未使用，选择器为自包含组件）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| value | String | '#4d8dff' | Current color value. | 当前颜色值。 |
+| format | 'hex' \| 'rgb' | 'hex' | Output color format. | 输出颜色格式。 |
+| alpha | Boolean | false | Whether to show the alpha (opacity) slider. | 是否显示透明度滑块。 |
+| alphaValue | Number | 1 | Alpha (opacity) value from 0 to 1. | 透明度值，范围 0 到 1。 |
+| disabled | Boolean | false | Whether the color picker is disabled. | 是否禁用颜色选择器。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { value, alpha, format } | Emitted when the color or alpha value changes. | 颜色或透明度变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-color-picker value="#4d8dff" format="hex"></aithe-color-picker>
+<aithe-color-picker alpha alpha-value="0.8"></aithe-color-picker>
+```

package/docs/api/form/combobox.md

@@ -0,0 +1,49 @@
+# AitheCombobox / AitheCombobox 组合框
+
+> Filterable input + option list combobox.
+> 可过滤的输入框 + 选项列表组合框。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; combobox is self-contained). | 默认插槽（未使用，组合框为自包含组件）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| value | String | '' | Current input value. | 当前输入值。 |
+| title | `string` | `''` | Display title (shown as tooltip). | 显示标题（作为工具提示）。 |
+| icon | `string` | `''` | Icon name to display before the input. | 在输入框前显示的图标名称。 |
+| options | String | '[]' | JSON string of combobox options. Each option supports `icon` and `intent` (AitheIntent) fields. | 组合框选项的 JSON 字符串。每个选项支持 `icon` 和 `intent`（AitheIntent）字段。 |
+| filterable | Boolean | true | Whether the input supports filtering options. | 是否支持过滤选项。 |
+| disabled | Boolean | false | Whether the combobox is disabled. | 是否禁用组合框。 |
+| placeholder | String | 'Search or select' | Placeholder text for the input. | 输入框的占位文本。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { value, option } | Emitted when an option is selected. | 选中选项时触发。 |
+| aithe-input | { value } | Emitted on every keystroke. | 每次按键时触发。 |
+
+## Option Fields / 选项字段
+
+| Field | Type | Description (EN) | Description (CN) |
+|-------|------|-------------------|-------------------|
+| label | `string` | Display text. | 显示文本。 |
+| id | `string` | Unique value emitted on select. | 选择时发出的唯一值。 |
+| icon | `string` | Icon name rendered before the label via aithe-icon. | 通过 aithe-icon 在标签前渲染的图标名称。 |
+| intent | AitheIntent | Visual intent / semantic color for the option. | 选项的视觉意图/语义色。 |
+
+## Examples / 示例
+
+```html
+<aithe-combobox
+  options='[{"label":"Apple","id":"apple"},{"label":"Banana","id":"banana"}]'
+  title="Choose a fruit"
+  icon="search"
+  filterable
+></aithe-combobox>
+```

package/docs/api/form/date-picker.md

@@ -0,0 +1,33 @@
+# AitheDatePicker / AitheDatePicker 日期选择器
+
+> Date input wrapper with optional range mode.
+> 日期输入包装器，支持可选的范围模式。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; picker is self-contained). | 默认插槽（未使用，选择器为自包含组件）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| value | String | '' | Start date value. | 起始日期值。 |
+| format | String | 'YYYY-MM-DD' | Display format pattern. | 显示格式模式。 |
+| range | Boolean | false | Whether to enable date range selection. | 是否启用日期范围选择。 |
+| disabled | Boolean | false | Whether the date picker is disabled. | 是否禁用日期选择器。 |
+| endValue | String | '' | End date value for range mode. | 范围模式的结束日期值。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { value, format } | Emitted when a date value changes. | 日期值变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-date-picker value="2025-01-01" format="YYYY-MM-DD"></aithe-date-picker>
+<aithe-date-picker range value="2025-01-01" end-value="2025-01-31"></aithe-date-picker>
+```

package/docs/api/form/form-item.md

@@ -0,0 +1,35 @@
+# AitheFormItem / AitheFormItem 表单项
+
+> Labeled form field row with light validation state.
+> 带标签的表单字段行，支持轻量级校验状态。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot for the form control element. | 表单控件元素内容。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| label | String | '' | Field label text. | 字段标签文本。 |
+| title | `string` | `''` | Display title (shown as tooltip). | 显示标题（作为工具提示）。 |
+| icon | `string` | `''` | Icon name to display before the label. | 在标签前显示的图标名称。 |
+| prop | String | '' | Field property name for validation mapping. | 用于校验映射的字段属性名。 |
+| required | Boolean | false | Whether the field is required. | 是否为必填字段。 |
+| error | String | '' | Static error message to display. | 显示的静态错误消息。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| — | — | No custom events emitted. | 无自定义事件。 |
+
+## Examples / 示例
+
+```html
+<aithe-form-item label="Email" title="Email address" icon="mail" prop="email" required error="Email is required">
+  <aithe-input name="email"></aithe-input>
+</aithe-form-item>
+```

package/docs/api/form/form.md

@@ -0,0 +1,34 @@
+# AitheForm / AitheForm 表单
+
+> Form container with lightweight validation and submit events.
+> 表单容器，支持轻量级校验和提交事件。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot for form items and controls. | 表单项和控件内容。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| model | String | '{}' | JSON string of the form model data. | 表单模型数据的 JSON 字符串。 |
+| rules | String | '{}' | JSON string of validation rules. | 校验规则的 JSON 字符串。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-validate | { valid } | Emitted after validation. | 校验完成后触发。 |
+| aithe-submit | { values } | Emitted on valid form submission. | 有效表单提交时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-form model='{"name":""}' rules='{}'>
+  <aithe-form-item label="Name" prop="name" required>
+    <aithe-input name="name"></aithe-input>
+  </aithe-form-item>
+</aithe-form>
+```

package/docs/api/form/radio-group.md

@@ -0,0 +1,33 @@
+# AitheRadioGroup / AitheRadioGroup 单选组
+
+> Radio group container that manages the currently selected value.
+> 单选组容器，管理当前选中的值。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot for aithe-radio children. | 子单选按钮内容。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| value | String | '' | Currently selected radio value. | 当前选中的单选值。 |
+| disabled | Boolean | false | Whether all child radios are disabled. | 是否禁用所有子单选按钮。 |
+| name | String | '' | Name attribute propagated to child radios. | 传递给子单选按钮的 name 属性。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { value: string } | Emitted when the group value changes. | 组值变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-radio-group value="a" name="choice">
+  <aithe-radio value="a">Option A</aithe-radio>
+  <aithe-radio value="b">Option B</aithe-radio>
+</aithe-radio-group>
+```

package/docs/api/form/radio.md

@@ -0,0 +1,33 @@
+# AitheRadio / AitheRadio 单选按钮
+
+> Radio button input with label slot.
+> 单选按钮输入组件，支持标签插槽。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot for radio label text. | 单选按钮标签文本。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| checked | Boolean | false | Whether the radio is checked. | 是否选中。 |
+| disabled | Boolean | false | Whether the radio is disabled. | 是否禁用。 |
+| value | String | '' | Value submitted when selected (used in groups). | 选中时提交的值（在组中使用）。 |
+| name | String | '' | Name attribute for form submission. | 表单提交的 name 属性。 |
+| groupDisabled | Boolean | false | Disabled state propagated from parent radio-group. | 从父级单选组传递的禁用状态。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { checked, value } | Emitted when checked state changes (standalone). | 选中状态变更时触发（独立使用）。 |
+| aithe-radio-toggle | { checked, value } | Emitted inside radio-group for group coordination. | 在单选组内触发以协调状态。 |
+
+## Examples / 示例
+
+```html
+<aithe-radio value="a" name="choice">Option A</aithe-radio>
+```

package/docs/api/form/rate.md

@@ -0,0 +1,31 @@
+# AitheRate / AitheRate 评分
+
+> Star rating component with optional half steps.
+> 星级评分组件，支持可选的半星步进。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; rate is self-contained). | 默认插槽（未使用，评分组件为自包含组件）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| max | Number | 5 | Maximum number of stars. | 最大星数。 |
+| allowHalf | Boolean | false | Whether to allow half-star ratings. | 是否允许半星评分。 |
+| color | String | 'var(--aithe-warning-5)' | Custom color for filled stars. | 已填充星星的自定义颜色。 |
+| value | Number | 0 | Current rating value. | 当前评分值。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { value } | Emitted when the rating value changes. | 评分值变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-rate value="3" max="5" allow-half color="var(--aithe-warning-5)"></aithe-rate>
+```

package/docs/api/form/select.md

@@ -0,0 +1,56 @@
+# AitheSelect / AitheSelect 下拉选择
+
+> Dropdown select component with search, clear, and keyboard navigation.
+> 下拉选择组件，支持搜索、清除和键盘导航。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; content driven by options). | 默认插槽（未使用，内容由 options 控制）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| optionsJson | String | '' | JSON string of select options. | 选项的 JSON 字符串。 |
+| options | AitheSelectOption[] | [] | Array of select option objects. Each option supports `icon` and `intent` (AitheIntent) fields. | 选项对象数组。每个选项支持 `icon` 和 `intent`（AitheIntent）字段。 |
+| value | String | '' | Currently selected value. | 当前选中的值。 |
+| title | `string` | `''` | Display title (shown as tooltip). | 显示标题（作为工具提示）。 |
+| icon | `string` | `''` | Icon name to display before the selected value. | 在选中值前显示的图标名称。 |
+| placeholder | String | '请选择' | Placeholder text shown when no value is selected. | 无选中值时的占位文本。 |
+| searchable | Boolean | false | Whether the select supports search/filter. | 是否支持搜索过滤。 |
+| clearable | Boolean | false | Whether the selected value can be cleared. | 是否允许清除选中值。 |
+| disabled | Boolean | false | Whether the select is disabled. | 是否禁用。 |
+| placement | 'bottom-start' \| 'top-start' | 'bottom-start' | Dropdown panel placement. | 下拉面板位置。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { option, value } | Emitted when a value is selected. | 选中值变更时触发。 |
+| aithe-clear | — | Emitted when the value is cleared. | 值被清除时触发。 |
+| aithe-open-change | { open } | Emitted when the dropdown opens or closes. | 下拉框开关状态变更时触发。 |
+
+## Option Fields / 选项字段
+
+| Field | Type | Description (EN) | Description (CN) |
+|-------|------|-------------------|-------------------|
+| label | `string` | Display text. | 显示文本。 |
+| id | `string` | Unique value emitted on select. | 选择时发出的唯一值。 |
+| disabled | `boolean` | Whether the option is non-interactive. | 是否不可交互。 |
+| description | `string` | Secondary description line. | 二级描述行。 |
+| icon | `string` | Icon name rendered before the label via aithe-icon. | 通过 aithe-icon 在标签前渲染的图标名称。 |
+| intent | AitheIntent | Visual intent / semantic color for the option. | 选项的视觉意图/语义色。 |
+
+## Examples / 示例
+
+```html
+<aithe-select
+  options='[{"id":"a","label":"Option A"},{"id":"b","label":"Option B"}]'
+  title="Select an option"
+  icon="search"
+  searchable
+  clearable
+></aithe-select>
+```

package/docs/api/form/slider.md

@@ -0,0 +1,34 @@
+# AitheSlider / AitheSlider 滑块
+
+> Numeric slider with single and range modes.
+> 数值滑块，支持单值和范围模式。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; slider is self-contained). | 默认插槽（未使用，滑块为自包含组件）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| min | Number | 0 | Minimum value of the slider. | 滑块的最小值。 |
+| max | Number | 100 | Maximum value of the slider. | 滑块的最大值。 |
+| step | Number | 1 | Step increment for the slider. | 滑块的步进增量。 |
+| range | Boolean | false | Whether to enable range (dual-thumb) mode. | 是否启用范围（双滑块）模式。 |
+| value | String | '50' | Current value (comma-separated for range mode). | 当前值（范围模式用逗号分隔）。 |
+| disabled | Boolean | false | Whether the slider is disabled. | 是否禁用滑块。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { value } | Emitted when the slider value changes. | 滑块值变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-slider value="50" min="0" max="100" step="1"></aithe-slider>
+<aithe-slider range value="20,80"></aithe-slider>
+```

package/docs/api/form/switch.md

@@ -0,0 +1,31 @@
+# AitheSwitch / AitheSwitch 开关
+
+> Toggle switch with size and color variants.
+> 开关切换组件，支持尺寸和颜色变体。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; switch is self-contained). | 默认插槽（未使用，开关为自包含组件）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| checked | Boolean | false | Whether the switch is checked (on). | 是否选中（开启）。 |
+| disabled | Boolean | false | Whether the switch is disabled. | 是否禁用。 |
+| size | 'sm' \| 'md' \| 'lg' | 'md' | Switch size preset. | 开关尺寸预设。 |
+| type | AitheIntent | 'primary' | Color intent when checked. | 选中时的颜色意图。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { checked } | Emitted when checked state changes. | 选中状态变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-switch checked size="md" type="primary"></aithe-switch>
+```

package/docs/api/form/time-picker.md

@@ -0,0 +1,31 @@
+# AitheTimePicker / AitheTimePicker 时间选择器
+
+> Time picker wrapper around native input.
+> 基于原生输入的时间选择器。
+
+## Slots / 插槽
+
+| Name | Description (EN) | Description (CN) |
+|------|-------------------|-------------------|
+| (default) | Default slot (unused; picker is self-contained). | 默认插槽（未使用，选择器为自包含组件）。 |
+
+## Properties / 属性
+
+| Name | Type | Default | Description (EN) | Description (CN) |
+|------|------|---------|-------------------|-------------------|
+| value | String | '' | Current time value. | 当前时间值。 |
+| format | String | 'HH:mm' | Display format pattern. | 显示格式模式。 |
+| step | Number | 300 | Step interval in seconds for the time input. | 时间输入的步进间隔（秒）。 |
+| disabled | Boolean | false | Whether the time picker is disabled. | 是否禁用时间选择器。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN) | Description (CN) |
+|------|--------|-------------------|-------------------|
+| aithe-change | { value, format, step } | Emitted when the time value changes. | 时间值变更时触发。 |
+
+## Examples / 示例
+
+```html
+<aithe-time-picker value="09:30" format="HH:mm" step="300"></aithe-time-picker>
+```