@aithe/aithe-ui 26.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Archest
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,466 @@
+# Aithe UI
+
+Aithe UI is a cross-framework Web Components design system built with **Lit 3.x** and **TypeScript**, developed by the Archest team. It provides 79 reusable UI primitives with Shadow DOM isolation, multi-theme support, i18n (en-US / zh-CN), and accessible semantics — ready for any modern web application regardless of framework.
+
+Aithe UI 是 Archest 团队基于 **Lit 3.x** 和 **TypeScript** 开发的跨框架 Web Components 设计系统，提供 79 个可复用 UI 基础组件，具备 Shadow DOM 样式隔离、多主题支持、国际化（en-US / zh-CN）和无障碍语义，适用于任何现代 Web 应用。
+
+**版本**: 26.2.2 (2026年第2季度第2个月版本)
+
+---
+
+## Features / 特性
+
+- **Cross-framework** — Web Components work with React, Vue, Angular, Svelte, or vanilla JS
+- **`aithe-*` namespace** — consistent custom element tag prefix
+- **Shadow DOM** — style isolation per component
+- **Multi-theme** — 22 built-in themes (11 Light + 11 Dark); switch globally or per-component
+- **i18n** — built-in internationalization with en-US / zh-CN; extensible via `registerAitheTranslations()`
+- **Accessible** — keyboard interaction, ARIA semantics, focus trapping
+- **Enterprise-oriented** — layout system, form validation, data display, and feedback overlays
+- **TypeScript** — full type declarations shipped with the library
+- **Zero runtime deps** — only `lit` as a dependency
+
+---
+
+## Installation / 安装
+
+```bash
+npm install @aithe/aithe-ui
+```
+
+## Usage / 使用
+
+Import the library once to register all components and initialize the theme:
+
+```ts
+import '@aithe/aithe-ui';
+```
+
+Or import individual components:
+
+```ts
+import { AitheButton } from '@aithe/aithe-ui';
+```
+
+Then use the custom elements in your HTML:
+
+```html
+<aithe-button type="primary" size="md">Launch</aithe-button>
+```
+
+---
+
+## Theme / 主题
+
+Aithe UI ships 22 built-in themes across two series. Each theme provides a complete set of design tokens (primary, success, warning, danger, neutral color scales) and semantic CSS variables.
+
+Aithe UI 内置 22 套主题，分为 Light 系和 Dark 系。每套主题提供完整的设计令牌（primary / success / warning / danger / neutral 色阶）和语义化 CSS 变量。
+
+### Light Series / Light 系 (11)
+
+| Theme     | Primary   | Style / 风格                 | Use Case / 使用场景                                  |
+| --------- | --------- | ---------------------------- | ---------------------------------------------------- |
+| `light`   | `#4d8dff` | Clean and neutral / 清爽中性 | Default for most apps / 大多数应用的默认主题         |
+| `blue`    | `#2c73f6` | Professional blue / 专业蓝调 | Enterprise / finance dashboards / 企业级、金融仪表盘 |
+| `festive` | `#f5313d` | Vibrant red / 活力红         | Holiday / campaign pages / 节日、活动页面            |
+| `orange`  | `#e87a18` | Warm orange / 暖橙           | E-commerce / food delivery / 电商、外卖平台          |
+| `purple`  | `#7c4de0` | Elegant purple / 优雅紫      | Creative / design tools / 创意、设计工具             |
+| `pink`    | `#e04d8a` | Playful pink / 活泼粉        | Social / lifestyle apps / 社交、生活类应用           |
+| `teal`    | `#13a8a8` | Fresh teal / 清新青          | Health / eco-friendly / 健康、环保类应用             |
+| `indigo`  | `#5c48d6` | Deep indigo / 深靛蓝         | Education / knowledge platforms / 教育、知识平台     |
+| `cyan`    | `#0ebfc7` | Cool cyan / 冷青             | Tech / data visualization / 科技、数据可视化         |
+| `amber`   | `#d4a010` | Golden amber / 金琥珀        | Finance / premium products / 金融、高端产品          |
+| `gray`    | `#7485a4` | Muted gray / 柔和灰          | Docs / minimal interfaces / 文档、极简界面           |
+
+### Dark Series / Dark 系 (11)
+
+| Theme      | Primary   | Style / 风格                | Use Case / 使用场景                            |
+| ---------- | --------- | --------------------------- | ---------------------------------------------- |
+| `dark`     | `#4a7dff` | Standard dark / 标准暗色    | Default dark mode / 默认暗色模式               |
+| `slate`    | `#5470e0` | Blue-gray dark / 蓝灰暗色   | Developer tools / IDEs / 开发者工具、IDE       |
+| `charcoal` | `#6454d4` | Deep purple dark / 深紫暗色 | Media / video editors / 媒体、视频编辑器       |
+| `midnight` | `#4070e0` | Deep blue dark / 深蓝暗色   | Monitoring / ops dashboards / 监控、运维仪表盘 |
+| `obsidian` | `#4c6cd4` | Volcanic dark / 火山暗色    | Security / admin panels / 安全、管理后台       |
+| `graphite` | `#4c60a6` | Steel dark / 钢铁暗色       | Engineering / CAD tools / 工程、CAD 工具       |
+| `ink`      | `#6454d4` | Ink dark / 墨色暗色         | Writing / note-taking apps / 写作、笔记应用    |
+| `onyx`     | `#506088` | Minimal dark / 极简暗色     | Focus / distraction-free UI / 专注、无干扰界面 |
+| `ebony`    | `#6a5094` | Warm dark / 暖调暗色        | Music / entertainment / 音乐、娱乐应用         |
+| `navy`     | `#4066c0` | Navy dark / 海军蓝暗色      | Maritime / logistics / 航运、物流系统          |
+| `raisin`   | `#6e50c0` | Berry dark / 浆果暗色       | Fashion / luxury brands / 时尚、奢侈品牌       |
+
+### Global Theme / 全局主题
+
+Apply a theme to the entire page by setting a class on `<body>` or `<html>`:
+
+```html
+<body class="aithe-light">
+  <aithe-button type="primary">Primary Button</aithe-button>
+</body>
+```
+
+Switch to dark mode by replacing `aithe-light` with `aithe-dark`.
+
+### Programmatic Theme Switch / 编程式主题切换
+
+```ts
+import { setAitheTheme, getAitheTheme } from '@aithe/aithe-ui';
+
+// Switch theme (persisted to localStorage by default)
+setAitheTheme('dark');
+
+// Read current theme
+const current = getAitheTheme(); // 'dark'
+```
+
+### Per-Component Override / 单组件主题覆盖
+
+```html
+<aithe-card theme="blue">Card with blue theme</aithe-card>
+```
+
+---
+
+## Internationalization / 国际化
+
+Aithe UI ships with built-in i18n support for **en-US** and **zh-CN** (BCP 47 locale codes). All user-facing strings in 19 components are externalized and resolved via the `t()` function.
+
+Aithe UI 内置国际化支持，提供 **en-US** 和 **zh-CN**（BCP 47 格式）两种语言。19 个组件中的所有用户可见字符串已外部化，通过 `t()` 函数动态解析。
+
+### Locale Switch / 语言切换
+
+```html
+<aithe-locale-switch></aithe-locale-switch>
+```
+
+### Programmatic Locale / 编程式语言操作
+
+```ts
+import { setAitheLocale, getAitheLocale, t, onAitheLocaleChange } from 'aithe-ui';
+
+// Switch locale / 切换语言
+setAitheLocale('zh-CN');
+
+// Get current locale / 获取当前语言
+console.log(getAitheLocale()); // 'zh-CN'
+
+// Translate a key / 翻译键
+console.log(t('basic.empty.defaultText')); // '暂无数据'
+
+// Listen for changes / 监听变更
+const unsubscribe = onAitheLocaleChange(() => {
+  console.log('Locale changed to:', getAitheLocale());
+});
+```
+
+### Register App-Level Translations / 注册应用级翻译
+
+```ts
+import { registerAitheTranslations } from 'aithe-ui';
+
+// Merge app-specific keys into existing locale registries
+registerAitheTranslations('en-US', {
+  'app.dashboard.title': 'Dashboard',
+  'app.settings.save': 'Save Settings',
+});
+
+registerAitheTranslations('zh-CN', {
+  'app.dashboard.title': '仪表盘',
+  'app.settings.save': '保存设置',
+});
+```
+
+### Register a Custom Locale / 注册自定义语言
+
+```ts
+import { registerAitheLocale, setAitheLocale } from 'aithe-ui';
+
+registerAitheLocale('ja-JP', {
+  'basic.empty.defaultText': 'データなし',
+  'form.dialog.confirmText': '確認',
+  'form.dialog.cancelText': 'キャンセル',
+});
+
+setAitheLocale('ja-JP');
+```
+
+---
+
+## Documentation / 文档
+
+| Document / 文档                                        | Description / 说明                                                                         |
+| ------------------------------------------------------ | ------------------------------------------------------------------------------------------ |
+| [Quick Start](docs/quickstart.md)                      | Installation, import, and first component / 安装、导入和第一个组件                         |
+| [Usage Guide](docs/guide.md)                           | Common API patterns: props, events, slots, styling / 通用 API 模式：属性、事件、插槽、样式 |
+| [Theming](docs/theming.md)                             | 22 built-in themes, CSS variables, custom themes / 22 种内置主题、CSS 变量、自定义主题     |
+| [Internationalization](docs/i18n.md)                   | Locale switching, translation registration / 语言切换、翻译注册                            |
+| [Framework Integration](docs/framework-integration.md) | React / Vue / Angular / Svelte integration / 框架集成指南                                  |
+| [API Reference](docs/api/summary.md)                   | Full API docs for all 79 components / 全部 79 个组件的详细 API                             |
+
+---
+
+## Components / 组件列表
+
+Aithe UI provides **79 components** across 10 categories:
+
+### Basic / 基础 (12)
+
+| Tag                    | Description                                            | 说明                           |
+| ---------------------- | ------------------------------------------------------ | ------------------------------ |
+| `<aithe-button>`       | Action trigger with variants, sizes, and loading state | 按钮，支持变体、尺寸和加载状态 |
+| `<aithe-button-group>` | Layout helper for consistent button spacing            | 按钮组，统一按钮间距布局       |
+| `<aithe-icon>`         | Vector icon with built-in glyph map                    | 图标，内置矢量图标库           |
+| `<aithe-input>`        | Single-line text input with validation support         | 输入框，单行文本输入带验证     |
+| `<aithe-textarea>`     | Multi-line text input with auto-grow                   | 文本域，多行输入自动增高       |
+| `<aithe-card>`         | Container with header, body, and footer sections       | 卡片，含标题、内容和操作区     |
+| `<aithe-tag>`          | Colored label with close and select behavior           | 标签，可关闭、可选择           |
+| `<aithe-badge>`        | Count/dot indicator overlaid on an anchor              | 徽章，数字/圆点角标指示器      |
+| `<aithe-avatar>`       | Image, initials, or custom content display             | 头像，图片、文字或自定义内容   |
+| `<aithe-divider>`      | Horizontal or vertical separator line                  | 分割线，水平或垂直分隔         |
+| `<aithe-empty>`        | Empty state placeholder with icon and text             | 空状态，数据为空时的占位       |
+| `<aithe-chip>`         | Compact selectable chip with close button              | 芯片，紧凑可选标签带关闭按钮   |
+
+### Layout / 布局 (10)
+
+| Tag                      | Description                                   | 说明                     |
+| ------------------------ | --------------------------------------------- | ------------------------ |
+| `<aithe-container>`      | Top-level page layout container               | 容器，顶层页面布局容器   |
+| `<aithe-row>`            | 24-grid row for grid layout system            | 行，24 栅格行容器        |
+| `<aithe-col>`            | 24-grid column item                           | 列，24 栅格列项          |
+| `<aithe-flex>`           | Quick flex layout helper                      | 弹性布局，快速 Flex 布局 |
+| `<aithe-space>`          | Equal spacing helper for child elements       | 间距，子元素等间距布局   |
+| `<aithe-page-container>` | Standard page shell with title and spacing    | 页面容器，标准页面外壳   |
+| `<aithe-page>`           | Full-page layout with header and content area | 页面，完整页面布局       |
+| `<aithe-collapse>`       | Accordion / multi-expand collapse container   | 折叠面板，手风琴/多展开  |
+| `<aithe-collapse-item>`  | Single collapsible panel                      | 折叠项，单个可折叠面板   |
+| `<aithe-affix>`          | Sticky wrapper that pins content on scroll    | 固钉，滚动时固定元素     |
+
+### Navigation / 导航 (8)
+
+| Tag                       | Description                                    | 说明                     |
+| ------------------------- | ---------------------------------------------- | ------------------------ |
+| `<aithe-menu>`            | Navigation menu with vertical/horizontal modes | 菜单，垂直/水平导航菜单  |
+| `<aithe-menu-item>`       | Leaf navigation item                           | 菜单项，叶子导航项       |
+| `<aithe-sub-menu>`        | Nested expandable sub-menu                     | 子菜单，可展开嵌套子菜单 |
+| `<aithe-breadcrumb>`      | Page hierarchy breadcrumb                      | 面包屑，页面层级导航     |
+| `<aithe-breadcrumb-item>` | Single breadcrumb link or text                 | 面包屑项，单个面包屑链接 |
+| `<aithe-steps>`           | Stepper for process flow visualization         | 步骤条，流程步骤可视化   |
+| `<aithe-back-top>`        | Floating button to scroll back to top          | 回到顶部，滚动回顶按钮   |
+| `<aithe-dropdown>`        | Dropdown menu overlay                          | 下拉菜单，下拉菜单浮层   |
+
+### Form / 表单 (16)
+
+| Tag                      | Description                                  | 说明                           |
+| ------------------------ | -------------------------------------------- | ------------------------------ |
+| `<aithe-checkbox>`       | Binary selection control                     | 复选框，二选一控件             |
+| `<aithe-checkbox-group>` | Multi-select group of checkboxes             | 复选框组，多选组合             |
+| `<aithe-radio>`          | Single selection control                     | 单选框，单选控件               |
+| `<aithe-radio-group>`    | Group of mutually exclusive radios           | 单选框组，互斥单选组合         |
+| `<aithe-select>`         | Dropdown single/multi selector               | 选择器，下拉单选/多选          |
+| `<aithe-switch>`         | Toggle switch for on/off state               | 开关，开/关切换                |
+| `<aithe-color-picker>`   | Color selection input                        | 颜色选择器，颜色选取输入       |
+| `<aithe-combobox>`       | Searchable dropdown with free input          | 组合框，可搜索下拉带自由输入   |
+| `<aithe-date-picker>`    | Date selection input                         | 日期选择器，日期选取输入       |
+| `<aithe-time-picker>`    | Time selection input                         | 时间选择器，时间选取输入       |
+| `<aithe-slider>`         | Range slider for numeric input               | 滑块，数值范围滑块             |
+| `<aithe-rate>`           | Star rating input                            | 评分，星级评分输入             |
+| `<aithe-form>`           | Form container with validation               | 表单，带验证的表单容器         |
+| `<aithe-form-item>`      | Form field wrapper with label and validation | 表单项，带标签和验证的字段包装 |
+| `<aithe-upload>`         | File upload control                          | 上传，文件上传控件             |
+| `<aithe-transfer>`       | Dual-list transfer selector                  | 穿梭框，双列表数据转移         |
+
+### Feedback / 反馈 (9)
+
+| Tag                    | Description                     | 说明                       |
+| ---------------------- | ------------------------------- | -------------------------- |
+| `<aithe-dialog>`       | Modal dialog overlay            | 对话框，模态对话框浮层     |
+| `<aithe-modal>`        | Lightweight modal wrapper       | 模态框，轻量级模态包装     |
+| `<aithe-drawer>`       | Side panel drawer               | 抽屉，侧边面板             |
+| `<aithe-tooltip>`      | Hover tooltip overlay           | 工具提示，悬停提示浮层     |
+| `<aithe-popover>`      | Click-triggered popover         | 弹出框，点击触发的弹出内容 |
+| `<aithe-toast>`        | Auto-dismiss toast notification | 轻提示，自动消失的通知     |
+| `<aithe-alert>`        | Inline alert banner             | 警告提示，内联警告横幅     |
+| `<aithe-notification>` | Corner notification card        | 通知提醒框，角落通知卡片   |
+| `<aithe-loading>`      | Loading spinner overlay         | 加载中，加载旋转浮层       |
+
+### Data / 数据展示 (9)
+
+| Tag                     | Description                                         | 说明                         |
+| ----------------------- | --------------------------------------------------- | ---------------------------- |
+| `<aithe-table>`         | Data table with sorting and selection               | 表格，支持排序和选择的数据表 |
+| `<aithe-table-column>`  | Declarative column definition for aithe-table       | 表格列，声明式列定义         |
+| `<aithe-tabs>`          | Tab navigation container                            | 标签页，选项卡导航容器       |
+| `<aithe-tab-pane>`      | Single tab content panel                            | 标签页面板，单个选项卡内容   |
+| `<aithe-tree>`          | Hierarchical tree view                              | 树形控件，层级树视图         |
+| `<aithe-tree-menu>`     | Tree-based navigation menu with vertical/horizontal | 树形菜单，垂直/水平树形导航  |
+| `<aithe-timeline>`      | Timeline container with data-driven mode            | 时间线，支持数据驱动模式     |
+| `<aithe-timeline-item>` | Single timeline node                                | 时间线项，单个时间线节点     |
+| `<aithe-pagination>`    | Page navigation for large datasets                  | 分页，大数据集分页导航       |
+
+### Display / 展示 (4)
+
+| Tag                      | Description                       | 说明                      |
+| ------------------------ | --------------------------------- | ------------------------- |
+| `<aithe-carousel>`       | Slot-based image/content carousel | 走马灯，轮播图            |
+| `<aithe-comparison>`     | Before/after comparison slider    | 对比，前后对比滑块        |
+| `<aithe-animated-image>` | Animated image with pan/zoom      | 动画图片，缩放平移        |
+| `<aithe-markdown>`       | Lightweight markdown renderer     | Markdown 渲染，轻量渲染器 |
+
+### Progress / 进度 (4)
+
+| Tag                     | Description                              | 说明                     |
+| ----------------------- | ---------------------------------------- | ------------------------ |
+| `<aithe-progress-bar>`  | Linear progress bar                      | 进度条，线性进度条       |
+| `<aithe-progress-ring>` | Circular progress indicator              | 环形进度条，圆形进度指示 |
+| `<aithe-spinner>`       | Generic loading spinner                  | 旋转器，通用加载旋转     |
+| `<aithe-skeleton>`      | Skeleton placeholder for content loading | 骨架屏，内容加载占位     |
+
+### Container / 容器 (4)
+
+| Tag                   | Description                | 说明                       |
+| --------------------- | -------------------------- | -------------------------- |
+| `<aithe-callout>`     | Highlighted callout block  | 提示框，高亮提示块         |
+| `<aithe-details>`     | Themed disclosure widget   | 详情，可展开详情区域       |
+| `<aithe-scroller>`    | Themed scroll container    | 滚动容器，自定义滚动区域   |
+| `<aithe-split-panel>` | Resizable two-panel layout | 分割面板，可调整双面板布局 |
+
+### Theme / 主题 (3)
+
+| Tag                     | Description                                            | 说明                                      |
+| ----------------------- | ------------------------------------------------------ | ----------------------------------------- |
+| `<aithe-theme-picker>`  | Theme selector with Light/Dark grouping and color dots | 主题选择器，Light/Dark 分组展示带色点预览 |
+| `<aithe-theme-preview>` | Theme preview panel with local preview and apply       | 主题预览，局部预览并确认应用全局主题      |
+| `<aithe-locale-switch>` | Locale switcher dropdown for en-US / zh-CN             | 语言切换，en-US / zh-CN 下拉切换          |
+
+> Full API documentation with properties, slots, events, and examples: [docs/api/summary.md](docs/api/summary.md)
+
+---
+
+## Project Structure / 项目结构
+
+```text
+aithe-ui/
+├── src/
+│   ├── base/              # AitheElement base class
+│   ├── core/              # Types, utils, floating, anchored-overlay, styles, i18n
+│   ├── styles/            # Theme tokens (22 built-in themes), mixins, global CSS
+│   ├── types/             # Shared TypeScript type definitions
+│   ├── utils/             # DOM, events, theme, validation helpers
+│   ├── components/
+│   │   ├── basic/         # 12 basic components
+│   │   ├── layout/        # 10 layout components
+│   │   ├── navigation/    # 8 navigation components
+│   │   ├── form/          # 16 form components
+│   │   ├── feedback/      # 9 feedback components
+│   │   ├── data/          # 9 data display components
+│   │   ├── display/       # 4 display components
+│   │   ├── progress/      # 4 progress components
+│   │   ├── container/     # 4 container components
+│   │   └── theme/         # 3 theme components (picker, preview, locale-switch)
+│   ├── global.ts          # initializeAitheUI, setAitheTheme, getAitheTheme
+│   └── index.ts           # Library entry — exports all components
+├── docs/
+│   ├── quickstart.md     # Quick start guide / 快速上手
+│   ├── guide.md          # Usage guide / 使用指南
+│   ├── theming.md        # Theming system / 主题系统
+│   ├── i18n.md           # Internationalization / 国际化
+│   ├── framework-integration.md # Framework integration / 框架集成
+│   ├── api/              # Per-component API docs (bilingual)
+│   │   └ summary.md      # API reference index
+│   ├── changelog/        # Version changelogs
+│   └── issue/            # Issue tracking docs
+├── package.json
+├── tsconfig.json
+├── eslint.config.js       # ESLint flat config (SonarJS, Lit, WC rules)
+├── .prettierrc            # Prettier config
+└── vite.config.ts
+```
+
+---
+
+## Development / 开发
+
+```bash
+# Install dependencies
+npm install
+
+# Start dev server (Vite)
+npm run dev
+
+# Build library (JS bundle + TypeScript declarations)
+npm run build
+
+# Build demo site
+npm run build:demo
+
+# Build API documentation site
+npm run build:api
+
+# Preview built demo
+npm run preview
+
+# Preview built API docs
+npm run preview:api
+
+# Type check only
+npm run check
+
+# Lint with ESLint
+npm run lint
+
+# Lint and auto-fix
+npm run lint:fix
+
+# Check formatting with Prettier
+npm run format
+
+# Format and auto-fix
+npm run format:fix
+
+```
+
+---
+
+## Build Output / 构建产物
+
+`npm run build` outputs to `dist/`:
+
+| File                | Description             |
+| ------------------- | ----------------------- |
+| `dist/index.js`     | ES module entry         |
+| `dist/index.umd.js` | UMD bundle              |
+| `dist/index.d.ts`   | TypeScript declarations |
+
+---
+
+## Custom Events / 自定义事件
+
+All Aithe components emit custom events with the `aithe-` prefix (e.g., `aithe-click`, `aithe-change`, `aithe-select`). These events are composed and bubble through the DOM tree.
+
+```html
+<aithe-button @aithe-click="handleClick">Click me</aithe-button>
+```
+
+```ts
+button.addEventListener('aithe-click', (e) => {
+  console.log(e.detail); // event payload
+});
+```
+
+---
+
+## Base Element Properties / 基元素属性
+
+All Aithe components inherit from `AitheElement`, which provides these shared reactive properties:
+
+| Property   | Type      | Default     | Description                            |
+| ---------- | --------- | ----------- | -------------------------------------- |
+| `variant`  | `string`  | `'default'` | Visual variant style                   |
+| `size`     | `string`  | `'md'`      | Shared size scale (`sm` / `md` / `lg`) |
+| `theme`    | `string`  | `''`        | Optional local theme override          |
+| `disabled` | `boolean` | `false`     | Disabled state                         |
+
+---
+
+## License / 许可证
+
+MIT — Archest

package/dist/apps/api/app.d.ts

@@ -0,0 +1,24 @@
+/**
+ * API 文档应用根组件
+ * Root component for the API documentation application.
+ *
+ * 集成国际化：通过 registerApiTranslations 注册应用层翻译，
+ * 使用 localeVersion 状态触发 locale 变更时的重新渲染。
+ * Integrates i18n: registers app-level translations via registerApiTranslations,
+ * uses localeVersion state to trigger re-render on locale change.
+ */
+import { LitElement } from 'lit';
+import '../../src/index';
+import './docs-viewer';
+export declare class AitheApiApp extends LitElement {
+    private theme;
+    /** locale 变更版本号，用于触发 Lit 重新渲染 / Locale version counter to trigger Lit re-render */
+    private localeVersion;
+    private unsubscribeLocale?;
+    static readonly styles: import("lit").CSSResult;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private changeTheme;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/apps/api/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../apps/api/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAa,MAAM,KAAK,CAAC;AAG5C,OAAO,iBAAiB,CAAC;AAIzB,OAAO,eAAe,CAAC;AAMvB,qBACa,WAAY,SAAQ,UAAU;IAChC,OAAO,CAAC,KAAK,CAAmB;IACzC,mFAAmF;IAC1E,OAAO,CAAC,aAAa,CAAK;IAEnC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IAEvC,MAAM,CAAC,QAAQ,CAAC,MAAM,0BAiFpB;IAEF,iBAAiB,IAAI,IAAI;IAOzB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,CAAC,WAAW;IAKnB,MAAM;CA2BP"}

package/dist/apps/api/demo-data.d.ts

@@ -0,0 +1,3 @@
+import type { DocEntry } from './docs-viewer';
+export declare function getDemoData(entryKey: string): Pick<DocEntry, 'demoCode' | 'demoSetup' | 'previewHeight'> | undefined;
+//# sourceMappingURL=demo-data.d.ts.map

package/dist/apps/api/demo-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo-data.d.ts","sourceRoot":"","sources":["../../../apps/api/demo-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA0vB9C,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,GACf,IAAI,CAAC,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,eAAe,CAAC,GAAG,SAAS,CAExE"}

package/dist/apps/api/docs-viewer.d.ts

@@ -0,0 +1,54 @@
+/**
+ * API 文档查看器组件
+ * API documentation viewer component with sidebar navigation and live demo support.
+ *
+ * 支持国际化：label 可为字符串或返回字符串的函数，在渲染时动态解析。
+ * Supports i18n: labels can be strings or functions returning strings, resolved at render time.
+ */
+import { LitElement } from 'lit';
+/** 文档条目 / Documentation entry */
+export interface DocEntry {
+    key: string;
+    /** 显示标签，支持 i18n 函数 / Display label, supports i18n function */
+    label: string | (() => string);
+    html: string;
+    demoCode?: string;
+    demoSetup?: (container: HTMLElement) => void;
+    previewHeight?: string;
+}
+/** 文档分类 / Documentation category */
+export interface DocCategory {
+    key: string;
+    /** 分类标签，支持 i18n 函数 / Category label, supports i18n function */
+    label: string | (() => string);
+    entries: DocEntry[];
+}
+export declare class AitheDocsViewer extends LitElement {
+    categories: DocCategory[];
+    private activeCategory;
+    private activeEntry;
+    private demoSource;
+    private demoError;
+    /** locale 变更版本号，用于触发 Lit 重新渲染 / Locale version counter to trigger Lit re-render */
+    private localeVersion;
+    /** locale 变更取消订阅函数 / Unsubscribe function for locale changes */
+    private unsubscribeLocale?;
+    static readonly styles: import("lit").CSSResult;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private handleContentClick;
+    private get currentEntry();
+    private selectEntry;
+    private demoPreview?;
+    private demoDebounceTimer?;
+    protected willUpdate(changed: Map<string, unknown>): void;
+    protected updated(changed: Map<string, unknown>): void;
+    private scheduleDemoRender;
+    private renderDemoPreview;
+    private renderSidebar;
+    private renderEmpty;
+    private renderDemoSection;
+    private renderContent;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=docs-viewer.d.ts.map

package/dist/apps/api/docs-viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-viewer.d.ts","sourceRoot":"","sources":["../../../apps/api/docs-viewer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAa,MAAM,KAAK,CAAC;AAK5C,iCAAiC;AACjC,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED,qBACa,eAAgB,SAAQ,UAAU;IACb,UAAU,EAAE,WAAW,EAAE,CAAM;IAEtD,OAAO,CAAC,cAAc,CAAM;IAE5B,OAAO,CAAC,WAAW,CAAM;IAEzB,OAAO,CAAC,UAAU,CAAM;IAExB,OAAO,CAAC,SAAS,CAAM;IAEhC,mFAAmF;IAC1E,OAAO,CAAC,aAAa,CAAK;IAEnC,gEAAgE;IAChE,OAAO,CAAC,iBAAiB,CAAC,CAAa;IAEvC,MAAM,CAAC,QAAQ,CAAC,MAAM,0BA+SpB;IAEF,iBAAiB,IAAI,IAAI;IAazB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,CAAC,kBAAkB,CA0CxB;IAEF,OAAO,KAAK,YAAY,GASvB;IAED,OAAO,CAAC,WAAW;IAKK,OAAO,CAAC,WAAW,CAAC,CAAc;IAE1D,OAAO,CAAC,iBAAiB,CAAC,CAAgC;IAE1D,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQzD,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,iBAAiB;IA2CzB,OAAO,CAAC,aAAa;IASrB,MAAM;CAYP"}

package/dist/apps/api/i18n/en-US.d.ts

@@ -0,0 +1,7 @@
+/**
+ * API 应用英文翻译资源
+ * English translation resource for the API documentation app.
+ */
+import type { AitheTranslationValue } from '../../../src/core/i18n';
+export declare const apiEn: Record<string, AitheTranslationValue>;
+//# sourceMappingURL=en-US.d.ts.map

package/dist/apps/api/i18n/en-US.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../../../apps/api/i18n/en-US.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CA+GvD,CAAC"}

package/dist/apps/api/i18n/index.d.ts

@@ -0,0 +1,2 @@
+export declare function registerApiTranslations(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/apps/api/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../apps/api/i18n/index.ts"],"names":[],"mappings":"AAQA,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/dist/apps/api/i18n/zh-CN.d.ts

@@ -0,0 +1,7 @@
+/**
+ * API 应用中文翻译资源
+ * Chinese (zh-CN) translation resource for the API documentation app.
+ */
+import type { AitheTranslationValue } from '../../../src/core/i18n';
+export declare const apiZh: Record<string, AitheTranslationValue>;
+//# sourceMappingURL=zh-CN.d.ts.map

package/dist/apps/api/i18n/zh-CN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-CN.d.ts","sourceRoot":"","sources":["../../../../apps/api/i18n/zh-CN.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CA+GvD,CAAC"}

package/dist/apps/api/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Aithe UI API Documentation</title>
+    <script type="module" crossorigin src="/index2.js"></script>
+    <link rel="modulepreload" crossorigin href="/index-jd7NIlfT.js">
+  </head>
+  <body>
+    <aithe-api-app></aithe-api-app>
+  </body>
+</html>

package/dist/apps/api/pages/docs.d.ts

@@ -0,0 +1,11 @@
+/**
+ * API 文档分类与条目定义
+ * API documentation categories and entries definition.
+ *
+ * 所有 label 使用 () => t('api.*') 模式以支持国际化动态切换。
+ * All labels use () => t('api.*') pattern to support dynamic i18n switching.
+ */
+import type { DocCategory } from '../docs-viewer';
+declare const docCategories: DocCategory[];
+export { docCategories };
+//# sourceMappingURL=docs.d.ts.map

package/dist/apps/api/pages/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../../apps/api/pages/docs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAY,MAAM,gBAAgB,CAAC;AA+F5D,QAAA,MAAM,aAAa,EAAE,WAAW,EAiL/B,CAAC;AAeF,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/apps/api/standalone.d.ts

@@ -0,0 +1,2 @@
+import './app';
+//# sourceMappingURL=standalone.d.ts.map

package/dist/apps/api/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../apps/api/standalone.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,CAAC"}