@aithe/aithe-ui 26.2.2 → 26.2.3

package/dist/components/data/tabs.d.ts

@@ -1,15 +1,36 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Tab navigation container that manages tab-pane children.
+ * 标签页导航容器，管理 tab-pane 子组件。
+ *
+ * @slot - Default slot for `aithe-tab-pane` children. 默认插槽，用于 `aithe-tab-pane` 子组件。
+ *
+ * @fires aithe-change    - Emitted when the active tab changes with `{ activeKey }`. 活动标签页变更时发出 `{ activeKey }`。
+ * @fires aithe-tab-remove - Emitted when a closable tab is removed with `{ key }`. 可关闭标签页被移除时发出 `{ key }`。
+ * @fires aithe-tab-add   - Emitted when the add button is clicked. 添加按钮被点击时发出。
+ *
+ * @example
+ * ```html
+ * <aithe-tabs type="card" active-key="a">
+ *   <aithe-tab-pane tab-id="a" label="Tab A">Content A</aithe-tab-pane>
+ *   <aithe-tab-pane tab-id="b" label="Tab B">Content B</aithe-tab-pane>
+ * </aithe-tabs>
+ * ```
+ */
 export declare class AitheTabs extends AitheElement {
+    /** Visual style of the tab navigation. 标签页导航的视觉样式。 */
     type: 'line' | 'card' | 'button';
+    /** Key of the currently active tab pane. 当前活动标签页的键。 */
     activeKey: string;
+    /** Whether to show an add button in the tab bar. 是否在标签栏中显示添加按钮。 */
     addable: boolean;
-    private slotNodes;
+    private readonly slotNodes;
     private panes;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private syncPanes;
+    private readonly syncPanes;
     private activate;
     private removePane;
-    private handleKeydown;
+    private readonly handleKeydown;
     render(): import("lit-html").TemplateResult<1>;
 }
 export declare class AitheTabGroup extends AitheTabs {

package/dist/components/data/tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../src/components/data/tabs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD,qBACa,SAAU,SAAQ,YAAY;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAU;IACjB,SAAS,SAAM;IACvC,OAAO,UAAS;IAEpB,OAAO,CAAC,SAAS,CAAa;IAC9C,OAAO,CAAC,KAAK,CAAsB;IAE5C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyFpB;IAEF,OAAO,CAAC,SAAS,CAaf;IAEF,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,aAAa,CAmBnB;IAEF,MAAM;CAkDP;AAED,qBACa,aAAc,SAAQ,SAAS;CAAG"}
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../../src/components/data/tabs.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,sDAAsD;IAC1B,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAU;IACtE,uDAAuD;IACF,SAAS,SAAM;IACpE,mEAAmE;IACtC,OAAO,UAAS;IAEpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;IACvD,OAAO,CAAC,KAAK,CAAsB;IAE5C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8FpB;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAkBxB;IAEF,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAmB5B;IAEF,MAAM;CAiEP;AAED,qBACa,aAAc,SAAQ,SAAS;CAAG"}

package/dist/components/data/timeline-item.d.ts

@@ -0,0 +1,24 @@
+import { AitheElement } from '../../core/aithe-element';
+/**
+ * Single node inside `aithe-timeline` with timestamp and color variant.
+ * 时间线节点，用于 aithe-timeline 内部，包含时间戳和颜色类型。
+ *
+ * @slot - Default slot for timeline item content. 时间线节点内容。
+ * @example
+ * ```html
+ * <aithe-timeline-item timestamp="2024-03-15" type="success" dot="✓">
+ *   Task completed successfully
+ * </aithe-timeline-item>
+ * ```
+ */
+export declare class AitheTimelineItem extends AitheElement {
+    /** Timestamp label text. 时间戳标签文本。 */
+    timestamp: string;
+    /** Color variant for the dot indicator. 圆点指示器的颜色类型。 */
+    type: 'default' | 'primary' | 'success' | 'warning' | 'danger';
+    /** Custom dot content (overrides default circle). 自定义圆点内容（覆盖默认圆圈）。 */
+    dot: string;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=timeline-item.d.ts.map

package/dist/components/data/timeline-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-item.d.ts","sourceRoot":"","sources":["../../../src/components/data/timeline-item.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;GAWG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACjD,qCAAqC;IACT,SAAS,SAAM;IAC3C,uDAAuD;IAC3B,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAC9E;IACZ,sEAAsE;IAC1C,GAAG,SAAM;IAErC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAmEpB;IAEF,MAAM;CAaP"}

package/dist/components/data/timeline.d.ts

@@ -0,0 +1,49 @@
+import { AitheElement } from '../../core/aithe-element';
+import type { AitheTimelineItemMeta } from '../../core/types';
+import './timeline-item';
+/**
+ * Timeline container for displaying process and audit records.
+ * 时间线容器，用于展示流程和审计记录。
+ *
+ * Supports two item definition modes:
+ * 支持两种节点定义模式：
+ * - **Data-driven**: Set `items` / `items-json` attribute.
+ *   **数据驱动**：设置 `items` / `items-json` 属性。
+ * - **DOM-defined**: Place `<aithe-timeline-item>` children in the default slot.
+ *   **DOM 定义**：在默认插槽中放置 `<aithe-timeline-item>` 子元素。
+ *
+ * @slot - Default slot for `aithe-timeline-item` elements (DOM-defined mode). aithe-timeline-item 时间线节点元素（DOM 定义模式）。
+ *
+ * @example Data-driven mode / 数据驱动模式
+ * ```html
+ * <aithe-timeline
+ *   items='[{"content":"Step 1","timestamp":"09:00","type":"primary"},{"content":"Step 2","timestamp":"11:30","type":"success"}]'
+ * ></aithe-timeline>
+ * ```
+ *
+ * @example DOM-defined mode / DOM 定义模式
+ * ```html
+ * <aithe-timeline reverse>
+ *   <aithe-timeline-item timestamp="2024-01-01" type="primary">Step 1</aithe-timeline-item>
+ *   <aithe-timeline-item timestamp="2024-01-02" type="success">Step 2</aithe-timeline-item>
+ * </aithe-timeline>
+ * ```
+ */
+export declare class AitheTimeline extends AitheElement {
+    /** JSON string of timeline items (parsed into `items`). 时间线节点的 JSON 字符串（解析为 `items`）。 */
+    itemsJson: string;
+    /** Array of timeline items (prefer this over `itemsJson` in JS). 时间线节点数组（在 JS 中优先使用此属性而非 `itemsJson`）。 */
+    items: AitheTimelineItemMeta[];
+    /** Whether to reverse the order of timeline items. 是否反转时间线节点顺序。 */
+    reverse: boolean;
+    private hasSlotItems;
+    protected willUpdate(changed: Map<string, unknown>): void;
+    private get resolvedItems();
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private readonly onSlotChange;
+    private readonly syncOrder;
+    protected updated(changed: Map<string, unknown>): void;
+    private renderItem;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=timeline.d.ts.map

package/dist/components/data/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../src/components/data/timeline.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,yFAAyF;IACzC,SAAS,SAAM;IAC/D,0GAA0G;IAC1E,KAAK,EAAE,qBAAqB,EAAE,CAAM;IACpE,mEAAmE;IACtC,OAAO,UAAS;IAEpC,OAAO,CAAC,YAAY,CAAS;IAEtC,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUzD,OAAO,KAAK,aAAa,GAGxB;IAED,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyEpB;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAI3B;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAOxB;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,CAAC,UAAU;IAiBlB,MAAM;CAiBP"}

package/dist/components/data/tree-menu.d.ts

@@ -0,0 +1,63 @@
+import { nothing } from 'lit';
+import type { TemplateResult } from 'lit';
+import { AitheElement } from '../../core/aithe-element';
+import type { AitheTreeNodeMeta, AitheSidebarItemFilter } from '../../core/types';
+/**
+ * Data-driven tree menu with menu-style active highlighting and expand/collapse.
+ * 数据驱动的树形菜单，支持菜单样式高亮和展开/折叠。
+ *
+ * @fires aithe-select - Emitted when a menu item is selected with `{ value }`. 菜单项选中时发出 `{ value }`。
+ *
+ * @example
+ * ```html
+ * <aithe-tree-menu
+ *   items='[{"label":"Dashboard","id":"dashboard","icon":"home"},{"label":"Settings","id":"settings","icon":"settings","children":[{"label":"Profile","id":"profile"},{"label":"Security","id":"security"}]}]'
+ *   active="dashboard"
+ * ></aithe-tree-menu>
+ * ```
+ */
+export declare class AitheTreeMenu extends AitheElement {
+    /** JSON string of tree menu items (parsed into `items`). 树菜单项的 JSON 字符串（解析为 `items`）。 */
+    itemsJson: string;
+    /** Array of tree menu items (prefer this over `itemsJson` in JS). 树菜单项数组（在 JS 中优先使用此属性而非 `itemsJson`）。 */
+    items: AitheTreeNodeMeta[];
+    /** Active (selected) menu item value. 当前选中的菜单项值。 */
+    active: string;
+    /** Whether all nodes are expanded by default. 是否默认展开所有节点。 */
+    expandAll: boolean;
+    /** Layout direction: vertical (stacked) or horizontal (inline). 布局方向：垂直（堆叠）或水平（行内）。 */
+    direction: 'vertical' | 'horizontal';
+    /**
+     * Filter callback for menu items. Return `true` to show the item, `false` to hide it.
+     * Useful for permission-based access control.
+     * 菜单项过滤回调。返回 `true` 显示该项，返回 `false` 隐藏该项。适用于基于权限的访问控制。
+     */
+    itemFilter: AitheSidebarItemFilter | null;
+    /**
+     * Custom item renderer. When provided, this function is called for each leaf item
+     * and its return value is rendered inside the `<button>` element, replacing the
+     * default icon/label rendering. Useful for rendering custom previews like color dots,
+     * shape previews, etc.
+     * 自定义 item 渲染器。当提供时，每个叶子项都会调用此函数，返回值渲染在 `<button>` 内部，
+     * 替换默认的图标/标签渲染。适用于渲染自定义预览，如颜色圆点、形状预览等。
+     *
+     * The function receives the item metadata and should return a `TemplateResult` or `nothing`.
+     * 函数接收 item 元数据，应返回 `TemplateResult` 或 `nothing`。
+     */
+    itemRenderer: ((item: AitheTreeNodeMeta) => TemplateResult | typeof nothing) | null;
+    private expanded;
+    private unsubscribeLocale?;
+    private readonly handleDocumentPointer;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    protected willUpdate(changed: Map<string, unknown>): void;
+    protected updated(changed: Map<string, unknown>): void;
+    private collectKeys;
+    private isGroupActive;
+    private toggleExpand;
+    private selectItem;
+    private renderItems;
+    render(): TemplateResult<1>;
+}
+//# sourceMappingURL=tree-menu.d.ts.map

package/dist/components/data/tree-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-menu.d.ts","sourceRoot":"","sources":["../../../src/components/data/tree-menu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,OAAO,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAI1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAI7E;;;;;;;;;;;;;GAaG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,yFAAyF;IACzC,SAAS,SAAM;IAC/D,0GAA0G;IAC1E,KAAK,EAAE,iBAAiB,EAAE,CAAM;IAChE,oDAAoD;IACxB,MAAM,SAAM;IACxC,6DAA6D;IACP,SAAS,UAAS;IACxE,uFAAuF;IAC3D,SAAS,EAAE,UAAU,GAAG,YAAY,CAAc;IAE9E;;;;OAIG;IAC6B,UAAU,EAAE,sBAAsB,GAAG,IAAI,CAAQ;IAEjF;;;;;;;;;;OAUG;IAC6B,YAAY,EACxC,CAAC,CAAC,IAAI,EAAE,iBAAiB,KAAK,cAAc,GAAG,OAAO,OAAO,CAAC,GAC9D,IAAI,CAAQ;IAEP,OAAO,CAAC,QAAQ,CAAqB;IAE9C,OAAO,CAAC,iBAAiB,CAAC,CAAa;IAEvC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAKpC;IAEO,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAMrC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyKpB;IAEF,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUzD,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,WAAW;IAgFnB,MAAM;CAQP"}

package/dist/components/data/tree.d.ts

@@ -1,14 +1,41 @@
 import type { TemplateResult } from 'lit';
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
+import type { AitheTreeNodeMeta } from '../../core/types';
+export type TreeNodeRenderer = (node: AitheTreeNodeMeta) => TemplateResult;
 /**
- * Recursive tree view.
+ * Recursive tree view with expand/collapse and optional checkbox support.
+ * 递归树形视图，支持展开/折叠和可选的复选框功能。
+ *
+ * @fires aithe-check      - Emitted when a checkbox is toggled with `{ checked }`. 复选框切换时发出 `{ checked }`。
+ * @fires aithe-node-click - Emitted when a node label is clicked with `{ node }`. 节点标签被点击时发出 `{ node }`。
+ *
+ * @example
+ * ```html
+ * <aithe-tree
+ *   data='[{"label":"Root","id":"root","children":[{"label":"Child","id":"child"}]}]'
+ *   checkable
+ *   expand-all
+ * ></aithe-tree>
+ * ```
  */
 export declare class AitheTree extends AitheElement {
+    /** JSON string of tree node data. 树节点数据的 JSON 字符串。 */
     data: string;
+    /** Display title for the tree (shown as tooltip). 树形视图的显示标题（作为工具提示）。 */
+    title: string;
+    /** Icon name to display before the tree title. 在树标题前显示的图标名称。 */
+    icon: string;
+    /** Whether nodes show checkboxes for selection. 节点是否显示复选框以供选择。 */
     checkable: boolean;
+    /** Whether all nodes are expanded by default. 是否默认展开所有节点。 */
     expandAll: boolean;
+    /** Custom renderer function for tree nodes. 树节点的自定义渲染函数。 */
+    renderer?: TreeNodeRenderer;
     private expanded;
     private checked;
+    private unsubscribeLocale?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     protected updated(changed: Map<string, unknown>): void;
     private get parsedData();

package/dist/components/data/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/components/data/tree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAG1C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAUxD;;GAEG;AACH,qBACa,SAAU,SAAQ,YAAY;IACb,IAAI,SAAQ;IACX,SAAS,UAAS;IACO,SAAS,UAAS;IAE/D,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAqB;IAE7C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA2CpB;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,KAAK,UAAU,GAMrB;IAED,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,WAAW;IAyCnB,MAAM;CAGP"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/components/data/tree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAG1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIrD,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,iBAAiB,KAAK,cAAc,CAAC;AAE3E;;;;;;;;;;;;;;;GAeG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,sDAAsD;IAC1B,IAAI,SAAQ;IACxC,wEAAwE;IAC5C,KAAK,SAAM;IACvC,gEAAgE;IACpC,IAAI,SAAM;IACtC,kEAAkE;IACrC,SAAS,UAAS;IAC/C,6DAA6D;IACP,SAAS,UAAS;IACxE,4DAA4D;IAC5B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAEnD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAqB;IAE7C,OAAO,CAAC,iBAAiB,CAAC,CAAa;IAE9B,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAKrC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA0EpB;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,KAAK,UAAU,GAMrB;IAED,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,WAAW;IAgEnB,MAAM;CAiBP"}

package/dist/components/display/AGENTS.md

@@ -0,0 +1,28 @@
+# src/components/display/ — 展示组件（7个）
+
+## 组件列表
+
+| 组件                 | 标签                      | 说明                         |
+| -------------------- | ------------------------- | ---------------------------- |
+| `carousel.ts`        | `<aithe-carousel>`        | 走马灯/轮播图                |
+| `comparison.ts`      | `<aithe-comparison>`      | 前后对比滑块                 |
+| `animated-image.ts`  | `<aithe-animated-image>`  | 动画图片，支持缩放平移       |
+| `markdown.ts`        | `<aithe-markdown>`        | Markdown 渲染器              |
+| `code-editor.ts`     | `<aithe-code-editor>`     | 代码编辑器，语法高亮         |
+| `markdown-editor.ts` | `<aithe-markdown-editor>` | Markdown 编辑器，实时预览    |
+| `label.ts`           | `<aithe-label>`           | 标签文本，支持尺寸和颜色变体 |
+
+## 编码规范
+
+- 继承 `AitheElement`，使用 `@customElement` 装饰器
+- `aithe-markdown` 依赖 `@core/markdown` 解析模块
+- `aithe-code-editor` 和 `aithe-markdown-editor` 依赖 `@core/highlight` 高亮引擎
+- 导入使用 `@components/display/xxx` 路径别名
+- 中英文双语 JSDoc 注释
+
+## 关键约定
+
+- `aithe-markdown` 支持通过 `src` 属性加载外部 Markdown 文件
+- `aithe-code-editor` 通过 `language` 属性指定高亮语言
+- `aithe-carousel` 支持自动轮播（`autoplay` 属性）和指示器
+- 新增组件需同步更新 `src/index.ts` 和 `docs/api/display/`

package/dist/components/display/animated-image.d.ts

@@ -1,11 +1,23 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Animated image display with pan/zoom motion.
+ * Animated image display with pan/zoom motion effect.
+ * 带平移/缩放动效的动画图片展示组件。
+ *
+ * @slot - Default slot for fallback content when `src` is empty. `src` 为空时的回退内容插槽。
+ *
+ * @example
+ * ```html
+ * <aithe-animated-image src="hero.jpg" loop speed="2" play></aithe-animated-image>
+ * ```
  */
 export declare class AitheAnimatedImage extends AitheElement {
+    /** Image source URL. 图片源 URL。 */
     src: string;
+    /** Whether the animation loops infinitely. 动画是否无限循环。 */
     loop: boolean;
+    /** Animation speed multiplier (higher = faster). 动画速度倍数（越高越快）。 */
     speed: number;
+    /** Whether the animation is currently playing. 动画是否正在播放。 */
     play: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/display/animated-image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"animated-image.d.ts","sourceRoot":"","sources":["../../../src/components/display/animated-image.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,kBAAmB,SAAQ,YAAY;IACtB,GAAG,SAAM;IACR,IAAI,UAAQ;IACb,KAAK,SAAK;IACT,IAAI,UAAQ;IAEzC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8BpB;IAEF,MAAM;CAWP"}
+{"version":3,"file":"animated-image.d.ts","sourceRoot":"","sources":["../../../src/components/display/animated-image.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,qBACa,kBAAmB,SAAQ,YAAY;IAClD,iCAAiC;IACL,GAAG,SAAM;IACrC,wDAAwD;IAC3B,IAAI,UAAQ;IACzC,kEAAkE;IACtC,KAAK,SAAK;IACtC,4DAA4D;IAC/B,IAAI,UAAQ;IAEzC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8BpB;IAEF,MAAM;CAiBP"}

package/dist/components/display/carousel.d.ts

@@ -1,11 +1,29 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Slot-based carousel.
+ * Slot-based carousel for cycling through child elements with autoplay, arrows, and indicators.
+ * 基于插槽的轮播组件，支持自动播放、箭头导航和指示器。
+ *
+ * @slot - Default slot for carousel slide content. 轮播幻灯片内容的默认插槽。
+ *
+ * @fires aithe-change - Emitted when the active slide changes with `{ current }`. 当前幻灯片切换时发出 `{ current }`。
+ *
+ * @example
+ * ```html
+ * <aithe-carousel autoplay interval="4000" arrows indicators>
+ *   <div>Slide 1</div>
+ *   <div>Slide 2</div>
+ *   <div>Slide 3</div>
+ * </aithe-carousel>
+ * ```
  */
 export declare class AitheCarousel extends AitheElement {
+    /** Whether the carousel auto-advances slides. 轮播是否自动切换幻灯片。 */
     autoplay: boolean;
+    /** Auto-advance interval in milliseconds. 自动切换间隔（毫秒）。 */
     interval: number;
+    /** Whether to show dot indicators. 是否显示指示器圆点。 */
     indicators: boolean;
+    /** Whether to show prev/next arrow buttons. 是否显示前进/后退箭头按钮。 */
     arrows: boolean;
     private current;
     private timer;
@@ -15,7 +33,7 @@ export declare class AitheCarousel extends AitheElement {
     protected updated(changed: Map<string, unknown>): void;
     private get slides();
     private startTimer;
-    private syncSlides;
+    private readonly syncSlides;
     private next;
     private prev;
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/display/carousel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["../../../src/components/display/carousel.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,aAAc,SAAQ,YAAY;IAChB,QAAQ,UAAS;IAClB,QAAQ,SAAQ;IACf,UAAU,UAAQ;IAClB,MAAM,UAAQ;IAElC,OAAO,CAAC,OAAO,CAAK;IAC7B,OAAO,CAAC,KAAK,CAAK;IAElB,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA+DpB;IAEF,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWtD,OAAO,KAAK,MAAM,GAEjB;IAED,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,UAAU,CAYhB;IAEF,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,IAAI;IASZ,MAAM;CAgCP"}
+{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["../../../src/components/display/carousel.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,8DAA8D;IACjC,QAAQ,UAAS;IAC9C,yDAAyD;IAC7B,QAAQ,SAAQ;IAC5C,iDAAiD;IACpB,UAAU,UAAQ;IAC/C,8DAA8D;IACjC,MAAM,UAAQ;IAElC,OAAO,CAAC,OAAO,CAAK;IAC7B,OAAO,CAAC,KAAK,CAAK;IAElB,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA+DpB;IAEF,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWtD,OAAO,KAAK,MAAM,GAIjB;IAED,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAYzB;IAEF,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,IAAI;IASZ,MAAM;CA+CP"}

package/dist/components/display/code-editor.d.ts

@@ -0,0 +1,246 @@
+import { AitheElement } from '../../core/aithe-element';
+/**
+ * A full-featured code editor Web Component with syntax highlighting,
+ * line numbers, toolbar controls, resizable preview pane, and fullscreen mode.
+ *
+ * Architecture / 架构说明：
+ * - Uses a transparent <textarea> overlaid on a syntax-highlighted <div>
+ *   (the "highlight layer") so the user sees colored text while typing
+ *   into a native textarea for reliable input handling.
+ * - Syntax highlighting is powered by SyntaxRegistry, a rule-based tokenizer
+ *   that supports 30+ languages out of the box.
+ * - The toolbar provides language selection, theme switching, copy,
+ *   fullscreen, line numbers toggle, and preview pane toggle.
+ * - The preview pane is a slot-based area that can host custom content
+ *   (e.g., a markdown renderer in markdown-editor).
+ *
+ * 使用透明的 <textarea> 覆盖在语法高亮的 <div>（"高亮层"）之上，
+ * 用户在原生 textarea 中输入时能看到彩色文本，同时获得可靠的输入处理。
+ * 语法高亮由 SyntaxRegistry 驱动，它是一个基于规则的分词器，内置支持 30+ 种语言。
+ * 工具栏提供语言选择、主题切换、复制、全屏、行号切换和预览面板切换。
+ * 预览面板是基于插槽的区域，可承载自定义内容（例如 markdown-editor 中的 markdown 渲染器）。
+ *
+ * @slot toolbar-left - Custom content on the left side of toolbar. 工具栏左侧的自定义内容。
+ * @slot toolbar-right - Custom content on the right side of toolbar. 工具栏右侧的自定义内容。
+ * @slot preview - Custom preview content (when show-preview is enabled). 自定义预览内容。
+ *
+ * @property {string} value - Editor content. 编辑器内容。
+ * @property {string} language - Programming language for syntax highlighting. 用于语法高亮的编程语言。
+ * @property {boolean} readonly - Whether the editor is readonly. 是否只读。
+ * @property {boolean} lineNumbers - Whether to show line numbers. 是否显示行号。
+ * @property {string} placeholder - Placeholder text when empty. 占位符文本。
+ * @property {boolean} showToolbar - Whether to show the toolbar. 是否显示工具栏。
+ * @property {boolean} showTheme - Whether to show the theme picker. 是否显示主题选择器。
+ * @property {boolean} showPreview - Whether to show the preview pane. 是否显示预览面板。
+ * @property {boolean} showLanguage - Whether to show the language selector. 是否显示语言选择器。
+ * @property {boolean} showFullscreen - Whether to show the fullscreen button. 是否显示全屏按钮。
+ * @property {boolean} showCopy - Whether to show the copy button. 是否显示复制按钮。
+ * @property {boolean} showLineNumbersToggle - Whether to show the line numbers toggle button. 是否显示行号切换按钮。
+ *
+ * @fires aithe-input - Fired when editor content changes. 当编辑器内容发生变化时触发。
+ * @fires aithe-focus - Fired when editor gains focus. 当编辑器获得焦点时触发。
+ * @fires aithe-blur - Fired when editor loses focus. 当编辑器失去焦点时触发。
+ * @fires aithe-language-change - Fired when language is changed via toolbar select. 通过工具栏选择更改语言时触发。
+ * @fires aithe-line-numbers-change - Fired when line numbers visibility is toggled. 行号显示切换时触发。
+ * @fires aithe-fullscreen-change - Fired when fullscreen mode is toggled. 全屏模式切换时触发。
+ * @fires aithe-copy - Fired after copy button is clicked. 点击复制按钮后触发。
+ * @fires aithe-theme-change - Fired when theme is changed via toolbar picker. 通过工具栏选择更改主题时触发。
+ * @fires aithe-preview-toggle - Fired when preview pane is toggled. 预览面板切换时触发。
+ *
+ * @example
+ * ```html
+ * <aithe-code-editor language="javascript" show-toolbar></aithe-code-editor>
+ * ```
+ */
+export declare class AitheCodeEditor extends AitheElement {
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    /** Editor content. Code text displayed in the editor. 编辑器内容。 */
+    value: string;
+    /** Programming language for syntax highlighting. 用于语法高亮的编程语言。 */
+    language: string;
+    /** Whether the editor is readonly. 是否只读。 */
+    readonly: boolean;
+    /** Whether to show line numbers on the left side. 是否显示左侧行号。 */
+    lineNumbers: boolean;
+    /** Placeholder text when editor is empty. 编辑器为空时显示的占位符文本。 */
+    placeholder: string;
+    /** Whether to show the toolbar. 是否显示工具栏。 */
+    showToolbar: boolean;
+    /** Whether to show the theme picker in toolbar. 是否在工具栏中显示主题选择器。 */
+    showTheme: boolean;
+    /** Whether to show the preview pane. 是否显示预览面板。 */
+    showPreview: boolean;
+    /** Whether to show the language selector in toolbar. 是否在工具栏中显示语言选择器。 */
+    showLanguage: boolean;
+    /** Whether to show the fullscreen button in toolbar. 是否在工具栏中显示全屏按钮。 */
+    showFullscreen: boolean;
+    /** Whether to show the copy button in toolbar. 是否在工具栏中显示复制按钮。 */
+    showCopy: boolean;
+    /** Whether to show the line numbers toggle button in toolbar. 是否在工具栏中显示行号切换按钮。 */
+    showLineNumbersToggle: boolean;
+    /** Reference to the textarea element for direct DOM access. textarea 元素的引用。 */
+    private readonly textarea;
+    /** Whether the editor is currently focused. 编辑器是否聚焦。 */
+    private focused;
+    /** Whether the editor is in fullscreen mode. 是否全屏模式。 */
+    private isFullscreen;
+    /** Whether the copy button was just clicked (shows feedback). 复制按钮是否刚被点击（显示反馈）。 */
+    private copied;
+    /** Current editor theme (from theme picker). 当前编辑器主题（来自主题选择器）。 */
+    private editorTheme;
+    /** Whether the preview pane is visible. 预览面板是否可见。 */
+    private previewVisible;
+    /** Whether the preview splitter is being dragged. 预览分割条是否正在拖动。 */
+    private splitterDragging;
+    /** Refs for splitter, editor body, code pane, and preview pane elements. */
+    private readonly splitterRef;
+    private readonly editorBodyRef;
+    private readonly codePaneRef;
+    private readonly previewPaneRef;
+    /**
+     * Returns the syntax-highlighted HTML for the current value and language.
+     * Falls back to placeholder text if the editor is empty.
+     * 返回当前值和语言的语法高亮 HTML。编辑器为空时回退到占位符文本。
+     */
+    private get highlightedHtml();
+    /**
+     * Returns the number of lines in the current value.
+     * 返回当前值的行数。
+     */
+    private get lineCount();
+    firstUpdated(): void;
+    updated(changedProperties: Map<string, unknown>): void;
+    /**
+     * Handles textarea input: updates value and emits aithe-input.
+     * 处理 textarea 输入：更新 value 并触发 aithe-input 事件。
+     */
+    private handleInput;
+    /** Handles focus event. 处理聚焦事件。 */
+    private handleFocus;
+    /** Handles blur event. 处理失焦事件。 */
+    private handleBlur;
+    /**
+     * Handles Tab key: inserts 2 spaces instead of moving focus.
+     * 处理 Tab 键：插入 2 个空格而不是切换焦点。
+     */
+    private handleKeyDown;
+    /** Handles language selector change. 处理语言选择器变更。 */
+    private handleLanguageChange;
+    /** Toggles line numbers visibility. 切换行号显示。 */
+    private handleToggleLineNumbers;
+    /**
+     * Toggles fullscreen mode. When entering fullscreen,
+     * locks body scroll to prevent background scrolling.
+     * 切换全屏模式。进入全屏时锁定 body 滚动以防止背景滚动。
+     */
+    private handleFullscreen;
+    /**
+     * Copies editor content to clipboard using the Clipboard API.
+     * Shows a brief "copied" feedback state for 2 seconds.
+     * 使用 Clipboard API 将编辑器内容复制到剪贴板。
+     * 显示 2 秒的"已复制"反馈状态。
+     */
+    private handleCopy;
+    /** Toggles preview pane visibility. 切换预览面板可见性。 */
+    private handleTogglePreview;
+    /**
+     * Initializes splitter drag: captures pointer and adds move/up listeners.
+     * 初始化分割条拖动：捕获指针并添加 move/up 监听器。
+     */
+    private handleSplitterDown;
+    /**
+     * Handles splitter drag move: calculates percentage and resizes panes.
+     * Clamps between 20%-80% to prevent collapsing either pane.
+     * 处理分割条拖动移动：计算百分比并调整面板大小。
+     * 限制在 20%-80% 之间以防止任一面板折叠。
+     */
+    private readonly handleSplitterMove;
+    /**
+     * Handles splitter drag end: cleans up listeners and removes dragging class.
+     * 处理分割条拖动结束：清理监听器并移除 dragging 类。
+     */
+    private readonly handleSplitterUp;
+    /**
+     * Global keydown handler: Escape exits fullscreen.
+     * 全局键盘事件处理：Escape 键退出全屏。
+     */
+    private handleGlobalKeyDown;
+    /**
+     * Handles theme change from the theme picker component.
+     * Stores the selected theme and emits aithe-theme-change.
+     * 处理主题选择器的主题变更。存储所选主题并触发 aithe-theme-change 事件。
+     */
+    private readonly handleThemeChange;
+    /** Focus the editor textarea. 将焦点设置到编辑器文本区域。 */
+    focus(): void;
+    /** Get the start position of text selection. 获取选区起始位置。 */
+    getSelectionStart(): number;
+    /** Get the end position of text selection. 获取选区结束位置。 */
+    getSelectionEnd(): number;
+    /** Set the text selection range. 设置文本选区范围。 */
+    setSelection(start: number, end: number): void;
+    /**
+     * Get the list of supported languages from SyntaxRegistry.
+     * 从 SyntaxRegistry 获取支持的语言列表。
+     */
+    static getSupportedLanguages(): {
+        langId: string;
+        name: string;
+    }[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Renders the language selector dropdown.
+     * 渲染语言选择器下拉框。
+     */
+    private renderLanguageSelect;
+    /**
+     * Renders the line numbers toggle button.
+     * 渲染行号切换按钮。
+     */
+    private renderLineNumbersToggle;
+    /**
+     * Renders the theme picker button.
+     * 渲染主题选择器按钮。
+     */
+    private renderThemePicker;
+    /**
+     * Renders the preview toggle button.
+     * 渲染预览切换按钮。
+     */
+    private renderPreviewToggle;
+    /**
+     * Renders the copy button.
+     * 渲染复制按钮。
+     */
+    private renderCopyButton;
+    /**
+     * Renders the fullscreen toggle button.
+     * 渲染全屏切换按钮。
+     */
+    private renderFullscreenButton;
+    /**
+     * Renders the toolbar with language selector, theme picker,
+     * and action buttons (line numbers, preview, copy, fullscreen).
+     * 渲染工具栏，包含语言选择器、主题选择器和操作按钮。
+     */
+    private renderToolbar;
+    /**
+     * Renders the editor body with line numbers gutter and
+     * the textarea + highlight layer overlay.
+     * 渲染编辑器主体，包含行号槽和 textarea + 高亮层叠加。
+     */
+    private renderEditorBody;
+    /**
+     * Main render: assembles the editor wrapper with toolbar,
+     * editor body, optional preview pane, and resizable splitter.
+     * 主渲染：组装编辑器外壳，包含工具栏、编辑器主体、可选预览面板和可调整分割条。
+     */
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'aithe-code-editor': AitheCodeEditor;
+    }
+}
+//# sourceMappingURL=code-editor.d.ts.map

package/dist/components/display/code-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-editor.d.ts","sourceRoot":"","sources":["../../../src/components/display/code-editor.ts"],"names":[],"mappings":"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"}

package/dist/components/display/comparison.d.ts

@@ -1,10 +1,22 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Before/after comparison slider.
+ * Before/after image comparison slider with adjustable split ratio.
+ * 前后对比图片滑块组件，支持可调节的分割比例。
+ *
+ * @slot before - Content for the "before" pane (falls back to `beforeSrc` image). "之前"面板内容（回退到 `beforeSrc` 图片）。
+ * @slot after  - Content for the "after" pane (falls back to `afterSrc` image). "之后"面板内容（回退到 `afterSrc` 图片）。
+ *
+ * @example
+ * ```html
+ * <aithe-comparison before="old.jpg" after="new.jpg" ratio="60"></aithe-comparison>
+ * ```
  */
 export declare class AitheComparison extends AitheElement {
+    /** URL of the "before" image. "之前"图片的 URL。 */
     beforeSrc: string;
+    /** URL of the "after" image. "之后"图片的 URL。 */
     afterSrc: string;
+    /** Split ratio percentage (0–100). 分割比例百分比（0–100）。 */
     ratio: number;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/display/comparison.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"comparison.d.ts","sourceRoot":"","sources":["../../../src/components/display/comparison.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,eAAgB,SAAQ,YAAY;IACE,SAAS,SAAM;IAChB,QAAQ,SAAM;IAClC,KAAK,SAAM;IAEvC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiDpB;IAEF,MAAM;CAwBP"}
+{"version":3,"file":"comparison.d.ts","sourceRoot":"","sources":["../../../src/components/display/comparison.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;GAWG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,8CAA8C;IACG,SAAS,SAAM;IAChE,6CAA6C;IACG,QAAQ,SAAM;IAC9D,sDAAsD;IAC1B,KAAK,SAAM;IAEvC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiDpB;IAEF,MAAM;CAoCP"}