@aithe/aithe-ui 26.2.2 → 26.3.1

package/docs/api/display/label.md

@@ -0,0 +1,85 @@
+# AitheLabel / AitheLabel标签
+
+> Lightweight label component that renders a Markdown subset for descriptions and labels.
+> 轻量级标签组件，渲染 Markdown 子集用于描述和标签展示。
+
+## Supported Syntax / 支持的语法
+
+| Syntax         | Description (EN)                                               | Description (CN)                     |
+| -------------- | -------------------------------------------------------------- | ------------------------------------ |
+| `**text**`     | Bold                                                           | 加粗                                 |
+| `~~text~~`     | Strikethrough                                                  | 删除线                               |
+| `` `code` ``   | Inline code                                                    | 行内代码                             |
+| `[text](path)` | Internal link (external links blocked by default for security) | 站内链接（外链默认被阻止以确保安全） |
+| `:emoji_name:` | Emoji shortcode (e.g. `:smile:`, `:check:`)                    | 表情简码                             |
+| `:iconName:`   | Built-in icon via `<aithe-icon>`                               | 内置图标                             |
+
+> External URLs (http/https/ftp/absolute paths) are converted to plain text by default. Use `linkHooks` to customize this behavior.
+> 外部 URL（http/https/ftp/绝对路径）默认被转换为纯文本。可通过 `linkHooks` 自定义此行为。
+
+## Slots / 插槽
+
+| Name | Description (EN)                                          | Description (CN)                      |
+| ---- | --------------------------------------------------------- | ------------------------------------- |
+| —    | No slots; content is provided via the `content` property. | 无插槽；内容通过 `content` 属性提供。 |
+
+## Properties / 属性
+
+| Name      | Type                 | Default | Description (EN)                               | Description (CN)                      |
+| --------- | -------------------- | ------- | ---------------------------------------------- | ------------------------------------- |
+| content   | `string`             | `''`    | Markdown source text.                          | Markdown 源文本。                     |
+| linkHooks | `MarkdownLinkHook[]` | —       | Custom link hooks to intercept/transform URLs. | 自定义链接处理 hook，拦截或转换 URL。 |
+
+## Events / 事件
+
+| Name | Detail | Description (EN)  | Description (CN) |
+| ---- | ------ | ----------------- | ---------------- |
+| —    | —      | No custom events. | 无自定义事件。   |
+
+## CSS Custom Properties / CSS 自定义属性
+
+| Name                       | Default | Description (EN)                              | Description (CN)                 |
+| -------------------------- | ------- | --------------------------------------------- | -------------------------------- |
+| `--aithe-color-text`       | —       | Text color.                                   | 文本颜色。                       |
+| `--aithe-color-text-muted` | —       | Muted text color (strikethrough, blockquote). | 弱化文本颜色（删除线、引用块）。 |
+| `--aithe-color-bg-muted`   | —       | Code background color.                        | 代码背景颜色。                   |
+| `--aithe-primary-5`        | —       | Blockquote left border color.                 | 引用块左边框颜色。               |
+| `--aithe-primary-6`        | —       | Link color.                                   | 链接颜色。                       |
+| `--aithe-primary-7`        | —       | Inline code text color.                       | 行内代码文本颜色。               |
+| `--aithe-font-size-sm`     | `12px`  | Font size for `size="sm"`.                    | `size="sm"` 时的字号。           |
+| `--aithe-font-size-md`     | `14px`  | Font size for `size="md"`.                    | `size="md"` 时的字号。           |
+| `--aithe-font-size-lg`     | `16px`  | Font size for `size="lg"`.                    | `size="lg"` 时的字号。           |
+| `--aithe-font-family-mono` | —       | Monospace font for inline code.               | 行内代码的等宽字体。             |
+| `--aithe-space-2`          | —       | Spacing unit (blockquote/list margin).        | 间距单位（引用块/列表外边距）。  |
+| `--aithe-space-3`          | —       | Spacing unit (blockquote padding).            | 间距单位（引用块内边距）。       |
+| `--aithe-space-5`          | —       | Spacing unit (list padding-left).             | 间距单位（列表左内边距）。       |
+
+## Examples / 示例
+
+### Basic Usage / 基础用法
+
+```html
+<aithe-label content="**Bold** and `code`."></aithe-label>
+```
+
+### With Emoji and Icons / 带表情和图标
+
+```html
+<aithe-label content=":check: 已完成"></aithe-label>
+<aithe-label content=":smile: 很高兴见到你"></aithe-label>
+```
+
+### Size Variants / 尺寸变体
+
+```html
+<aithe-label content="Small label" size="sm"></aithe-label>
+<aithe-label content="Medium label" size="md"></aithe-label>
+<aithe-label content="Large label" size="lg"></aithe-label>
+```
+
+### With Custom Link Hooks / 自定义链接处理
+
+```javascript
+const label = document.querySelector('aithe-label');
+label.linkHooks = [(url) => (url.startsWith('/docs/') ? url : '')];
+```

package/docs/api/display/markdown-editor.md

@@ -0,0 +1,110 @@
+# AitheMarkdownEditor / AitheMarkdownEditor编辑器
+
+> Markdown editor component built on top of `aithe-code-editor`, with a live preview pane.
+> 基于 `aithe-code-editor` 定制的 Markdown 编辑器，集成实时预览面板。
+
+## Overview / 概述
+
+`aithe-markdown-editor` wraps `aithe-code-editor` with language fixed to `"markdown"`. It provides:
+
+- A code editor pane for writing Markdown
+- A live preview pane that renders Markdown as styled HTML
+- Configurable preview update strategy (auto or throttled)
+- Toolbar with toggle for code-only / code+preview modes
+
+`aithe-markdown-editor` 封装了 `aithe-code-editor`，语言固定为 `"markdown"`。提供：
+
+- 用于编写 Markdown 的代码编辑面板
+- 实时预览面板，将 Markdown 渲染为带样式的 HTML
+- 可配置的预览刷新策略（自动或节流）
+- 工具栏，支持纯代码 / 代码+预览模式切换
+
+## Slots / 插槽
+
+| Name | Description (EN)                                        | Description (CN)                    |
+| ---- | ------------------------------------------------------- | ----------------------------------- |
+| —    | No slots; content is provided via the `value` property. | 无插槽；内容通过 `value` 属性提供。 |
+
+## Properties / 属性
+
+| Name                  | Type              | Default  | Description (EN)                                                       | Description (CN)                            |
+| --------------------- | ----------------- | -------- | ---------------------------------------------------------------------- | ------------------------------------------- |
+| value                 | `string`          | `''`     | Markdown source text.                                                  | Markdown 源文本。                           |
+| showToolbar           | `boolean`         | `false`  | Whether the toolbar is visible.                                        | 是否显示工具栏。                            |
+| showTheme             | `boolean`         | `true`   | Whether to show the theme picker in toolbar.                           | 是否在工具栏中显示主题选择器。              |
+| lineNumbers           | `boolean`         | `true`   | Whether to show line numbers.                                          | 是否显示行号。                              |
+| readonly              | `boolean`         | `false`  | Whether the editor is read-only.                                       | 是否只读。                                  |
+| placeholder           | `string`          | `''`     | Placeholder text when the editor is empty.                             | 编辑器为空时的占位文本。                    |
+| showLanguage          | `boolean`         | `false`  | Whether to show the language selector (typically hidden for markdown). | 是否显示语言选择器（Markdown 时通常隐藏）。 |
+| showFullscreen        | `boolean`         | `true`   | Whether to show the fullscreen button.                                 | 是否显示全屏按钮。                          |
+| showCopy              | `boolean`         | `true`   | Whether to show the copy button.                                       | 是否显示复制按钮。                          |
+| showLineNumbersToggle | `boolean`         | `true`   | Whether to show the line numbers toggle button.                        | 是否显示行号切换按钮。                      |
+| previewStrategy       | `PreviewStrategy` | `'auto'` | Preview update strategy. See below.                                    | 预览刷新策略。详见下方。                    |
+
+### Preview Strategy / 预览刷新策略
+
+The `previewStrategy` property controls how often the preview pane re-renders:
+
+| Value                                  | Behavior                                                                          |
+| -------------------------------------- | --------------------------------------------------------------------------------- |
+| `'auto'`                               | Re-render preview on every value change (default). 每次值变更都重新渲染（默认）。 |
+| `{ changeCount: 5 }`                   | Re-render only after every 5 value changes. 每 5 次变更后刷新。                   |
+| `{ updateSeconds: 2 }`                 | Re-render at most once every 2 seconds. 每 2 秒最多刷新一次。                     |
+| `{ changeCount: 5, updateSeconds: 2 }` | Both conditions must be met. 两个条件同时满足时才刷新。                           |
+
+## Events / 事件
+
+| Name        | Detail              | Description (EN)                         | Description (CN)           |
+| ----------- | ------------------- | ---------------------------------------- | -------------------------- |
+| aithe-input | `{ value: string }` | Emitted when the markdown value changes. | 当 Markdown 值变化时触发。 |
+
+## Examples / 示例
+
+### Basic Usage / 基础用法
+
+```html
+<aithe-markdown-editor value="# Hello" show-toolbar></aithe-markdown-editor>
+```
+
+### Readonly Mode / 只读模式
+
+```html
+<aithe-markdown-editor value="**Bold** text" readonly></aithe-markdown-editor>
+```
+
+### Without Line Numbers / 不显示行号
+
+```html
+<aithe-markdown-editor value="- item 1\n- item 2" line-numbers="false"></aithe-markdown-editor>
+```
+
+### With Throttled Preview / 带节流预览
+
+```html
+<aithe-markdown-editor
+  value="# Hello"
+  show-toolbar
+  preview-strategy='{"updateSeconds":1}'
+></aithe-markdown-editor>
+```
+
+### Custom Toolbar / 自定义工具栏
+
+```html
+<aithe-markdown-editor
+  value="# Hello"
+  show-toolbar
+  show-theme="false"
+  show-copy="false"
+  show-fullscreen="false"
+></aithe-markdown-editor>
+```
+
+### Event Handling / 事件处理
+
+```javascript
+const editor = document.querySelector('aithe-markdown-editor');
+editor.addEventListener('aithe-input', (e) => {
+  console.log('Markdown content:', e.detail.value);
+});
+```

package/docs/api/display/markdown.md

@@ -1,29 +1,87 @@
 # AitheMarkdown / AitheMarkdown渲染器
 
-> Lightweight inline markdown renderer that converts markdown text to styled HTML.
-> 轻量级内联 Markdown 渲染器，将 Markdown 文本转换为带样式的 HTML。
+> Full-featured markdown renderer that converts GFM (GitHub Flavored Markdown) text to styled HTML.
+> 全功能 Markdown 渲染器，将 GFM Markdown 文本转换为带样式的 HTML。
+
+## Supported Syntax / 支持的语法
+
+| Syntax                        | Description (EN)                         | Description (CN)       |
+| ----------------------------- | ---------------------------------------- | ---------------------- |
+| `# ` `## ` `### ` … `###### ` | ATX headings                             | ATX 标题               |
+| `===` / `---` underline       | Setext headings                          | 下划线标题             |
+| `---` `***` `___`             | Thematic break / horizontal rule         | 分隔线                 |
+| `` ``` ```` / `~~~`           | Fenced code blocks                       | 围栏代码块             |
+| `\| col1 \| col2 \|`          | Tables                                   | 表格                   |
+| `> text`                      | Blockquote                               | 引用块                 |
+| `- item` / `* item`           | Unordered list                           | 无序列表               |
+| `1. item`                     | Ordered list                             | 有序列表               |
+| `- [ ] task` / `- [x] done`   | Task list                                | 任务列表               |
+| `**bold**`                    | Bold                                     | 加粗                   |
+| `*italic*`                    | Italic                                   | 斜体                   |
+| `` `code` ``                  | Inline code                              | 行内代码               |
+| `~~text~~`                    | Strikethrough                            | 删除线                 |
+| `[text](url)`                 | Link (external links blocked by default) | 链接（外链默认被阻止） |
+| `![alt](url)`                 | Image                                    | 图片                   |
+| `<url>`                       | Autolink                                 | 自动链接               |
+
+> External URLs (http/https/ftp/absolute paths) are converted to plain text by default. Use `linkHooks` to customize this behavior.
+> 外部 URL（http/https/ftp/绝对路径）默认被转换为纯文本。可通过 `linkHooks` 自定义此行为。
 
 ## Slots / 插槽
 
-| Name | Description (EN) | Description (CN) |
-|------|-------------------|-------------------|
-| — | — | No slots; content is provided via the `content` property. | 无插槽；内容通过 `content` 属性提供。 |
+| Name | Description (EN)                                          | Description (CN)                      |
+| ---- | --------------------------------------------------------- | ------------------------------------- |
+| —    | No slots; content is provided via the `content` property. | 无插槽；内容通过 `content` 属性提供。 |
 
 ## Properties / 属性
 
-| Name | Type | Default | Description (EN) | Description (CN) |
-|------|------|---------|-------------------|-------------------|
-| content | `string` | `''` | Raw markdown source string. | Markdown 源文本字符串。 |
-| theme | `'default' | 'article'` | `'default'` | Visual theme preset. | 视觉主题预设。 |
+| Name      | Type                 | Default | Description (EN)                               | Description (CN)                      |
+| --------- | -------------------- | ------- | ---------------------------------------------- | ------------------------------------- |
+| content   | `string`             | `''`    | Raw markdown source string.                    | Markdown 源文本字符串。               |
+| linkHooks | `MarkdownLinkHook[]` | —       | Custom link hooks to intercept/transform URLs. | 自定义链接处理 hook，拦截或转换 URL。 |
 
 ## Events / 事件
 
-| Name | Detail | Description (EN) | Description (CN) |
-|------|--------|-------------------|-------------------|
-| — | — | No custom events. | 无自定义事件。 |
+| Name | Detail | Description (EN)  | Description (CN) |
+| ---- | ------ | ----------------- | ---------------- |
+| —    | —      | No custom events. | 无自定义事件。   |
+
+## CSS Custom Properties / CSS 自定义属性
+
+| Name                       | Default | Description (EN)                | Description (CN)         |
+| -------------------------- | ------- | ------------------------------- | ------------------------ |
+| `--aithe-color-text`       | —       | Text color.                     | 文本颜色。               |
+| `--aithe-color-text-muted` | —       | Muted text color (blockquote).  | 弱化文本颜色（引用块）。 |
+| `--aithe-color-bg-muted`   | —       | Code / table header background. | 代码/表头背景颜色。      |
+| `--aithe-color-border`     | —       | Table border color.             | 表格边框颜色。           |
+| `--aithe-primary-5`        | —       | Blockquote left border color.   | 引用块左边框颜色。       |
+| `--aithe-primary-6`        | —       | Link color.                     | 链接颜色。               |
+| `--aithe-primary-7`        | —       | Inline code text color.         | 行内代码文本颜色。       |
+| `--aithe-font-family-mono` | —       | Monospace font for inline code. | 行内代码的等宽字体。     |
+| `--aithe-container-radius` | `6px`   | Image border radius.            | 图片圆角。               |
+| `--aithe-space-2`          | —       | Table cell padding.             | 表格单元格内边距。       |
+| `--aithe-space-3`          | —       | Heading / blockquote margin.    | 标题/引用块外边距。      |
+| `--aithe-space-4`          | —       | Block-level element spacing.    | 块级元素间距。           |
 
 ## Examples / 示例
 
+### Basic Usage / 基础用法
+
+### With Tables / 带表格
+
+```html
+<aithe-markdown content="| Name | Age |\n|------|-----|\n| Alice | 25 |"></aithe-markdown>
+```
+
+### With Task Lists / 带任务列表
+
 ```html
-<aithe-markdown content="# Hello\n**Bold** text and `code`." theme="article"></aithe-markdown>
-```
+<aithe-markdown content="- [x] Done\n- [ ] Pending"></aithe-markdown>
+```
+
+### With Custom Link Hooks / 自定义链接处理
+
+```javascript
+const md = document.querySelector('aithe-markdown');
+md.linkHooks = [(url) => (url.startsWith('https://internal.example.com') ? url : '')];
+```

package/docs/api/display/mini-box.md

@@ -0,0 +1,100 @@
+# AitheMiniBox / AitheMiniBox 迷你记录（基类）
+
+> Base class for the Box component family. Provides region-based layout with named slots. The box only defines layout structure — all content is provided via named slots, with no data binding. Not intended for direct use as a base class — use `<aithe-mini-box>`, `<aithe-brief-box>`, or `<aithe-detail-box>` instead.
+> Box 组件族的基类。提供基于区域的布局和具名插槽。Box 只定义布局结构——所有内容通过具名插槽提供，无数据绑定。不推荐作为基类直接使用——请使用 `<aithe-mini-box>`、`<aithe-brief-box>` 或 `<aithe-detail-box>`。
+
+## Import / 引入
+
+```ts
+import '@aithe/aithe-ui/components/data/mini-box';
+// or
+import '@aithe/aithe-ui/components/data/brief-box';
+// or
+import '@aithe/aithe-ui/components/data/detail-box';
+```
+
+## Description / 描述
+
+`AitheMiniBox` is the base class for the three Box variants. It defines the common property set, styling, and region rendering logic shared by all variants. Each variant implements a distinct layout strategy:
+
+- `<aithe-mini-box>` — single horizontal row (compact list view)
+- `<aithe-brief-box>` — three rows with description and vertically spanning checkbox/actions
+- `<aithe-detail-box>` — two-column split with left metadata and right actions
+
+All content is provided via named slots. The box only defines layout structure — it does not bind data.
+
+`AitheMiniBox` 是三种 Box 变体的基类，定义了所有变体共享的公共属性集、样式和区域渲染逻辑。每种变体实现不同的布局策略：
+
+- `<aithe-mini-box>` — 单行水平布局（紧凑列表视图）
+- `<aithe-brief-box>` — 三行布局，含描述和垂直贯穿的 checkbox/actions
+- `<aithe-detail-box>` — 左右分栏布局，左侧元数据、右侧操作
+
+所有内容通过具名插槽提供。Box 只定义布局结构——不绑定数据。
+
+## Slots / 插槽
+
+| Name      | Description (EN)                                                    | Description (CN)               |
+| --------- | ------------------------------------------------------------------- | ------------------------------ |
+| select    | Selection control region (e.g. radio).                              | 选择控件区域（如单选框）。     |
+| checkbox  | Checkbox region.                                                    | 复选框区域。                   |
+| name      | Primary label / title region.                                       | 主标签/标题区域。              |
+| tags      | Tags region.                                                        | 标签区域。                     |
+| status    | Status indicator region.                                            | 状态指示器区域。               |
+| actions   | Action buttons region.                                              | 操作按钮区域。                 |
+| content   | Expandable content region.                                          | 可展开的内容区域。             |
+| (default) | Default slot, rendered inside the content region.                   | 默认插槽，渲染在内容区域内。   |
+
+## CSS Parts / CSS 部件
+
+| Name    | Description (EN)                    | Description (CN)     |
+| ------- | ----------------------------------- | -------------------- |
+| select  | The select region container.        | 选择区域容器。       |
+| checkbox| The checkbox region container.      | 复选框区域容器。     |
+| name    | The name region container.          | 名称区域容器。       |
+| tags    | The tags region container.          | 标签区域容器。       |
+| status  | The status region container.        | 状态区域容器。       |
+| actions | The actions region container.       | 操作区域容器。       |
+| content | The content region container.       | 内容区域容器。       |
+
+## Properties / 属性
+
+| Name      | Type                           | Default  | Attribute   | Description (EN)                                        | Description (CN)                     |
+| --------- | ------------------------------ | -------- | ----------- | ------------------------------------------------------- | ------------------------------------ |
+| selectable | `'none'` \| `'multi'` \| `'single'` | `'none'` | `selectable` | Selection mode. `'none'` disables selection, `'multi'` enables checkbox multi-select, `'single'` enables radio single-select. | 选择模式。`'none'` 不选择，`'multi'` 启用复选框多选，`'single'` 启用单选框单选。 |
+| selected  | `boolean`                      | `false`  | `selected`  | Whether the box is selected.                            | box 是否被选中。                     |
+| expanded  | `boolean`                      | `false`  | `expanded`  | Whether the content region is expanded.                 | 内容区域是否展开。                   |
+
+## Events / 事件
+
+| Name              | Detail | Cancelable | Description (EN)               | Description (CN)        |
+| ----------------- | ------ | ---------- | ------------------------------ | ----------------------- |
+| `aithe-box-click` | `{}`   | No         | Fired when the box is clicked. | 点击 box 时触发。       |
+
+## Usage / 用法
+
+### Basic / 基础用法
+
+```html
+<aithe-mini-box>
+  <aithe-profile slot="name" title="Project Alpha" desc="Frontend application" icon="app"></aithe-profile>
+  <span slot="status">Active</span>
+</aithe-mini-box>
+```
+
+### With Checkbox / 带复选框
+
+```html
+<aithe-mini-box selectable>
+  <aithe-profile slot="name" title="Project Alpha" desc="Frontend application" icon="app"></aithe-profile>
+  <span slot="status">Active</span>
+</aithe-mini-box>
+```
+
+### Selected State / 选中状态
+
+```html
+<aithe-mini-box selectable selected>
+  <aithe-profile slot="name" title="Project Alpha" desc="Frontend application" icon="app"></aithe-profile>
+  <span slot="status">Active</span>
+</aithe-mini-box>
+```

package/docs/api/display/profile.md

@@ -0,0 +1,92 @@
+# AitheProfile / AitheProfile 档案展示
+
+> Fixed left-right layout: icon/avatar on the left, title and description on the right. Designed as the standard name region component for the Box component family.
+> 固定左右布局：左侧图标/头像，右侧标题和描述。作为 Box 组件族的标准 name 区域组件。
+
+## Import / 引入
+
+```ts
+import '@aithe/aithe-ui/components/display/profile';
+```
+
+## Description / 描述
+
+`AitheProfile` renders a fixed left-right layout with icon/avatar on the left and title/description on the right. It can be used independently or embedded into the `name` slot of `aithe-mini-box`, `aithe-brief-box`, or `aithe-detail-box`. Icon supports `(class)xxx` format for class-based icons, or auto-generates from the first character of `title` when `icon` is empty.
+
+`AitheProfile` 渲染固定左右布局：左侧图标/头像，右侧标题和描述。可独立使用，也可嵌入 `aithe-mini-box` / `aithe-brief-box` / `aithe-detail-box` 的 name 插槽。Icon 支持 `(class)xxx` 格式使用 class 图标，icon 为空时自动用 title 首字符生成。
+
+## Properties / 属性
+
+| Name          | Type                  | Default   | Attribute      | Description (EN)                                                       | Description (CN)                     |
+| ------------- | --------------------- | --------- | -------------- | ---------------------------------------------------------------------- | ------------------------------------ |
+| icon          | `string`              | `''`      | `icon`         | Icon content. Supports `(class)xxx` format for class icons. Empty auto-generates from title first char. | 图标内容。支持 `(class)xxx` 格式使用 class 图标，空时自动用 title 首字符生成。 |
+| icon-size     | `string`              | `'lg'`    | `icon-size`    | Icon size, same as `aithe-avatar` size.                                | 图标尺寸，同 `aithe-avatar` 的 size。 |
+| icon-shape    | `'circle' \| 'square' \| 'none'` | `'none'` | `icon-shape`   | Icon shape. `'none'` renders `<aithe-icon>`, others render `<aithe-avatar>`. | 图标形状。`'none'` 渲染 `<aithe-icon>`，其他值渲染 `<aithe-avatar>`。 |
+| title         | `string`              | `''`      | `title`        | Primary name text.                                                     | 主名称。                             |
+| desc          | `string`              | `''`      | `desc`         | Description text.                                                      | 描述文案。                           |
+| title-ellipsis | `boolean`             | `true`    | `title-ellipsis` | Whether to truncate title with ellipsis when overflow.                 | 标题超长时是否省略。                 |
+| desc-ellipsis  | `boolean`             | `true`    | `desc-ellipsis`  | Whether to truncate description with ellipsis when overflow.           | 描述超长时是否省略。                 |
+
+## Slots / 插槽
+
+| Name  | Description (EN)                          | Description (CN)             |
+| ----- | ----------------------------------------- | ---------------------------- |
+| icon  | Custom icon/avatar region, overrides default avatar. | 自定义图标/头像区域，覆盖默认 avatar。 |
+| title | Custom title region, overrides default title text.   | 自定义标题区域，覆盖默认 title 文本。   |
+| desc  | Custom description region, overrides default desc text. | 自定义描述区域，覆盖默认 desc 文本。   |
+
+## CSS Parts / CSS 部件
+
+| Name  | Description (EN)                    | Description (CN)     |
+| ----- | ----------------------------------- | -------------------- |
+| title | The title region container.         | 标题区域容器。       |
+| desc  | The description region container.   | 描述区域容器。       |
+
+## Examples / 示例
+
+### Basic / 基础用法
+
+```html
+<aithe-profile title="Project Alpha" desc="Frontend application" icon="(class)app"></aithe-profile>
+```
+
+### Title Only / 仅标题
+
+```html
+<aithe-profile title="Project Alpha"></aithe-profile>
+```
+
+### Custom Icon Shape / 自定义图标形状
+
+```html
+<aithe-profile title="User" desc="Administrator" icon="(class)user" icon-shape="circle"></aithe-profile>
+<aithe-profile title="Server" desc="Production" icon="(class)server" icon-shape="square"></aithe-profile>
+```
+
+### Default Icon (aithe-icon) / 默认图标（aithe-icon）
+
+```html
+<aithe-profile title="Project" desc="Description" icon="(class)app"></aithe-profile>
+```
+
+### Custom Icon Size / 自定义图标尺寸
+
+```html
+<aithe-profile title="Project" desc="Description" icon="(class)app" icon-size="xl"></aithe-profile>
+```
+
+### Disable Ellipsis / 关闭省略号
+
+```html
+<aithe-profile title="A very long project name that should not be truncated" desc="Description" ?title-ellipsis=${false}></aithe-profile>
+```
+
+### Custom Slots / 使用插槽自定义
+
+```html
+<aithe-profile>
+  <img slot="icon" src="/avatar.png" style="width:40px;height:40px;border-radius:50%;" />
+  <div slot="title"><strong>Custom Title</strong></div>
+  <span slot="desc">Custom description with <aithe-tag>tag</aithe-tag></span>
+</aithe-profile>
+```

package/docs/api/feedback/popover.md

@@ -5,22 +5,22 @@
 
 ## Slots / 插槽
 
-| Name | Description (EN) | Description (CN) |
-|------|-------------------|-------------------|
-| (default) | Default slot for the trigger element. | 触发元素内容。 |
-| content | Custom popover content. | 自定义弹出面板内容。 |
+| Name      | Description (EN)                      | Description (CN)     |
+| --------- | ------------------------------------- | -------------------- |
+| (default) | Default slot for the trigger element. | 触发元素内容。       |
+| content   | Custom popover content.               | 自定义弹出面板内容。 |
 
 ## Properties / 属性
 
-| Name | Type | Default | Description (EN) | Description (CN) |
-|------|------|---------|-------------------|-------------------|
+| 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. | 开关状态变更时触发。 |
+| Name                  | Detail   | Description (EN)                 | Description (CN)     |
+| --------------------- | -------- | -------------------------------- | -------------------- |
+| aithe-dropdown-change | { open } | Emitted when open state changes. | 开关状态变更时触发。 |
 
 ## Examples / 示例
 
@@ -29,4 +29,4 @@
   <button>Click me</button>
   <slot name="content"><p>Popover content here.</p></slot>
 </aithe-popover>
-```
+```

package/docs/api/feedback/tooltip.md

@@ -5,25 +5,25 @@
 
 ## Slots / 插槽
 
-| Name | Description (EN) | Description (CN) |
-|------|-------------------|-------------------|
-| (default) | Default slot for the anchor element. | 锚点元素内容。 |
-| content | Custom tooltip content (overrides `content` property). | 自定义工具提示内容。 |
+| 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. | 工具提示相对于锚点的位置。 |
+| 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. | 开关状态变更时触发。 |
+| Name                  | Detail   | Description (EN)                                              | Description (CN)                             |
+| --------------------- | -------- | ------------------------------------------------------------- | -------------------------------------------- |
+| aithe-dropdown-change | { open } | Inherited from AnchoredOverlay; emitted on open state change. | 继承自 AnchoredOverlay，开关状态变更时触发。 |
 
 ## Examples / 示例
 
@@ -31,4 +31,4 @@
 <aithe-tooltip content="Help text here" title="Help" icon="info" placement="top">
   <button>Hover me</button>
 </aithe-tooltip>
-```
+```