@aithe/aithe-ui 26.2.2 → 26.2.3

package/dist/components/basic/button-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button-group.d.ts","sourceRoot":"","sources":["../../../src/components/basic/button-group.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD;;GAEG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IACpB,GAAG,SAA0B;IAC5B,QAAQ,UAAS;IAE9C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAQpB;IAEF,MAAM;CAkBP"}
+{"version":3,"file":"button-group.d.ts","sourceRoot":"","sources":["../../../src/components/basic/button-group.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;GAYG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,oDAAoD;IACxB,GAAG,SAA0B;IACzD,wDAAwD;IAC3B,QAAQ,UAAS;IAE9C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAQpB;IAEF,MAAM;CAkBP"}

package/dist/components/basic/button.d.ts

@@ -1,13 +1,55 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Button component with multiple visual types, sizes, and states.
+ * 按钮组件，支持多种视觉类型、尺寸和状态。
+ *
+ * When `href` is set, the button renders as an `<a>` element for native link behavior.
+ * Navigation occurs by default; call `event.preventDefault()` on `aithe-click` to suppress it.
+ * 设置 `href` 后，按钮渲染为 `<a>` 元素以获得原生链接行为。
+ * 默认执行导航；在 `aithe-click` 事件中调用 `preventDefault()` 可阻止导航。
+ *
+ * @slot        - Default slot for button label. 默认插槽，用于按钮标签。
+ * @slot prefix - Icon or content before the label. 标签前的图标或内容。
+ * @slot suffix - Icon or content after the label. 标签后的图标或内容。
+ *
+ * @fires aithe-click - Emitted when the button is clicked (not when disabled/loading). 按钮被点击时发出（禁用/加载时不发出）。
+ *   When `href` is set, navigation runs by default. Call `preventDefault()` to suppress. 设置 `href` 后默认执行导航，调用 `preventDefault()` 可阻止。
+ *
+ * @example
+ * ```html
+ * <aithe-button type="primary" size="medium">Submit</aithe-button>
+ * <aithe-button type="danger" loading>Deleting...</aithe-button>
+ * <aithe-button type="primary" href="/dashboard">Go to Dashboard</aithe-button>
+ * ```
+ */
 export declare class AitheButton extends AitheElement {
+    /** Visual type of the button. 按钮的视觉类型。 */
     type: 'primary' | 'default' | 'dashed' | 'text' | 'link';
+    /** Size scale of the button. 按钮的尺寸规格。 */
     size: 'small' | 'medium' | 'large';
+    /** Display title for the button (shown as tooltip). 按钮的显示标题（作为工具提示）。 */
+    title: string;
+    /** Icon name to display before the label. 在标签前显示的图标名称。 */
+    icon: string;
+    /** Whether the button is disabled. 按钮是否禁用。 */
     disabled: boolean;
+    /** Whether the button shows a loading spinner. 按钮是否显示加载旋转器。 */
     loading: boolean;
+    /** Whether the button uses danger styling. 按钮是否使用危险样式。 */
     danger: boolean;
+    /** Whether the button spans the full width of its container. 按钮是否占满容器宽度。 */
     block: boolean;
+    /** Link URL. When set, the button renders as an `<a>` element. 链接地址。设置后按钮渲染为 `<a>` 元素。 */
+    href: string;
+    /** Link target attribute (e.g. `_blank`). Only applies when `href` is set. 链接 target 属性（如 `_blank`）。仅在设置 `href` 时生效。 */
+    target: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private handleClick;
+    /**
+     * Handle click: prevent interaction when disabled or loading,
+     * then emit `aithe-click` with the original mouse event.
+     * 处理点击：在禁用或加载时阻止交互，然后附带原始鼠标事件发出 `aithe-click`。
+     */
+    private readonly handleClick;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=button.d.ts.map

package/dist/components/basic/button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/components/basic/button.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,qBACa,WAAY,SAAQ,YAAY;IACf,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAa;IACrE,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAY;IAC9B,QAAQ,UAAS;IACjB,OAAO,UAAS;IAChB,MAAM,UAAS;IACf,KAAK,UAAS;IAE1D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA2IpB;IAEF,OAAO,CAAC,WAAW,CAQjB;IAEF,MAAM;CAsBP"}
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/components/basic/button.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,WAAY,SAAQ,YAAY;IAC3C,0CAA0C;IACd,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAa;IACjG,yCAAyC;IACb,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAY;IAC1E,wEAAwE;IAC5C,KAAK,SAAM;IACvC,0DAA0D;IAC9B,IAAI,SAAM;IACtC,8CAA8C;IACF,QAAQ,UAAS;IAC7D,+DAA+D;IACnB,OAAO,UAAS;IAC5D,0DAA0D;IACd,MAAM,UAAS;IAC3D,4EAA4E;IAChC,KAAK,UAAS;IAC1D,0FAA0F;IAC9D,IAAI,SAAM;IACtC,wHAAwH;IAC5F,MAAM,SAAM;IAExC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqJpB;IAEF;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAoB1B;IAEF,MAAM;CAuDP"}

package/dist/components/basic/card.d.ts

@@ -1,18 +1,38 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Card container with header, body, and footer sections.
+ * 卡片容器，包含标题、正文和底部区域。
+ *
+ * @slot - Default slot for card body content. 卡片正文内容。
+ * @slot header - Custom header content (overrides title). 自定义头部内容。
+ * @slot footer - Footer action area. 底部操作区域。
+ * @example
+ * ```html
+ * <aithe-card title="Settings" icon="settings" shadow="2">
+ *   <p>Card body content here.</p>
+ *   <slot name="footer"><button>Save</button></slot>
+ * </aithe-card>
+ * ```
+ */
 export declare class AitheCard extends AitheElement {
+    /** Card title text. 卡片标题文本。 */
     title: string;
-    subtitle: string;
+    /** Icon name to display before the title. 在标题前显示的图标名称。 */
+    icon: string;
+    /** Shadow elevation level (0–4). 阴影层级（0–4）。 */
     shadow: number;
+    /** Padding for the card body section. 卡片正文区域内边距。 */
     bodyPadding: string;
+    /** Whether to show a border around the card. 是否显示卡片边框。 */
     bordered: boolean;
-    private titleSlotNodes;
-    private subtitleSlotNodes;
-    private footerSlotNodes;
-    private hasTitleSlot;
-    private hasSubtitleSlot;
+    /** Divider style between sections: 'border' | 'none'. 区域间分割线样式：'border' | 'none'。 */
+    divider: 'border' | 'none';
+    private readonly headerSlotNodes;
+    private readonly footerSlotNodes;
+    private hasHeaderSlot;
     private hasFooterSlot;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private syncSlots;
+    private readonly syncSlots;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=card.d.ts.map

package/dist/components/basic/card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/components/basic/card.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,qBACa,SAAU,SAAQ,YAAY;IACb,KAAK,SAAM;IACX,QAAQ,SAAM;IACd,MAAM,SAAK;IACgB,WAAW,SAA2B;IAChE,QAAQ,UAAQ;IAEH,OAAO,CAAC,cAAc,CAAiB;IACpC,OAAO,CAAC,iBAAiB,CAAiB;IAC5C,OAAO,CAAC,eAAe,CAAiB;IAE1E,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,aAAa,CAAS;IAEvC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA6CpB;IAEF,OAAO,CAAC,SAAS,CAIf;IAEF,MAAM;CA4BP"}
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../src/components/basic/card.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;;GAcG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,+BAA+B;IACH,KAAK,SAAM;IACvC,0DAA0D;IAC9B,IAAI,SAAM;IACtC,+CAA+C;IACnB,MAAM,SAAK;IACvC,oDAAoD;IACG,WAAW,SAA2B;IAC7F,0DAA0D;IAC7B,QAAQ,UAAQ;IAC7C,qFAAqF;IACzD,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAY;IAEvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IAEnF,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAS;IAEvC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA2DpB;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGxB;IAEF,MAAM;CA4CP"}

package/dist/components/basic/chip.d.ts

@@ -1,13 +1,26 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Compact selectable chip.
+ * Compact selectable chip with optional close button.
+ * 紧凑的可选中芯片，支持可选关闭按钮。
+ *
+ * @slot - Default slot for chip label content. 芯片标签内容。
+ * @fires aithe-select - Emitted when chip selection state changes. 选中状态变更时触发。
+ * @fires aithe-close - Emitted when the close button is clicked. 关闭按钮点击时触发。
+ * @example
+ * ```html
+ * <aithe-chip closable>Filter Tag</aithe-chip>
+ * ```
  */
 export declare class AitheChip extends AitheElement {
+    /** Whether the chip is selected. 是否选中。 */
     selected: boolean;
+    /** Whether the chip shows a close button. 是否显示关闭按钮。 */
     closable: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private toggleSelect;
-    private handleClose;
+    /** Toggles the selected state and emits select event. 切换选中状态并触发 select 事件。 */
+    private readonly toggleSelect;
+    /** Handles close button click: emits event, then removes the chip from DOM. 处理关闭按钮点击：触发事件、然后从 DOM 移除芯片。 */
+    private readonly handleClose;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=chip.d.ts.map

package/dist/components/basic/chip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chip.d.ts","sourceRoot":"","sources":["../../../src/components/basic/chip.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,SAAU,SAAQ,YAAY;IACG,QAAQ,UAAS;IAChC,QAAQ,UAAS;IAE9C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiCpB;IAEF,OAAO,CAAC,YAAY,CAGlB;IAEF,OAAO,CAAC,WAAW,CAGjB;IAEF,MAAM;CAQP"}
+{"version":3,"file":"chip.d.ts","sourceRoot":"","sources":["../../../src/components/basic/chip.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;GAWG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,0CAA0C;IACE,QAAQ,UAAS;IAC7D,uDAAuD;IAC1B,QAAQ,UAAS;IAE9C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiCpB;IAEF,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG3B;IAEF,2GAA2G;IAC3G,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI1B;IAEF,MAAM;CAgBP"}

package/dist/components/basic/divider.d.ts

@@ -1,7 +1,21 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Horizontal or vertical divider line with optional label.
+ * 水平或垂直分割线，支持可选标签。
+ *
+ * @slot - Default slot for divider label text (horizontal mode). 分割线标签文本（水平模式）。
+ * @example
+ * ```html
+ * <aithe-divider label="Section"></aithe-divider>
+ * <aithe-divider vertical dashed></aithe-divider>
+ * ```
+ */
 export declare class AitheDivider extends AitheElement {
+    /** Whether the divider renders vertically. 是否垂直渲染分割线。 */
     vertical: boolean;
+    /** Whether the line style is dashed. 是否使用虚线样式。 */
     dashed: boolean;
+    /** Center label text for horizontal divider. 水平分割线的居中标签文本。 */
     label: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/basic/divider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"divider.d.ts","sourceRoot":"","sources":["../../../src/components/basic/divider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,qBACa,YAAa,SAAQ,YAAY;IACA,QAAQ,UAAS;IAChC,MAAM,UAAS;IAChB,KAAK,SAAM;IAEvC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAoDpB;IAEF,MAAM;CAiBP"}
+{"version":3,"file":"divider.d.ts","sourceRoot":"","sources":["../../../src/components/basic/divider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,yDAAyD;IACb,QAAQ,UAAS;IAC7D,kDAAkD;IACrB,MAAM,UAAS;IAC5C,8DAA8D;IAClC,KAAK,SAAM;IAEvC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAoDpB;IAEF,MAAM;CA+BP"}

package/dist/components/basic/empty.d.ts

@@ -1,10 +1,19 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 import './icon';
 /**
- * Empty state placeholder.
+ * Empty state placeholder with icon and text.
+ * 空状态占位组件，显示图标和提示文本。
+ *
+ * @slot - Default slot for custom empty content (overrides icon + text). 自定义空状态内容。
+ * @example
+ * ```html
+ * <aithe-empty text="No results found" icon="sparkles"></aithe-empty>
+ * ```
  */
 export declare class AitheEmpty extends AitheElement {
+    /** Placeholder text. 占位提示文本。 */
     text: string;
+    /** Built-in icon name to display. 显示的内置图标名称。 */
     icon: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/basic/empty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"empty.d.ts","sourceRoot":"","sources":["../../../src/components/basic/empty.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,QAAQ,CAAC;AAEhB;;GAEG;AACH,qBACa,UAAW,SAAQ,YAAY;IACd,IAAI,SAAU;IACd,IAAI,SAAc;IAE9C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAoBpB;IAEF,MAAM;CAUP"}
+{"version":3,"file":"empty.d.ts","sourceRoot":"","sources":["../../../src/components/basic/empty.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,QAAQ,CAAC;AAEhB;;;;;;;;;GASG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,gCAAgC;IACJ,IAAI,SAAM;IACtC,gDAAgD;IACpB,IAAI,SAAc;IAE9C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAoBpB;IAEF,MAAM;CAUP"}

package/dist/components/basic/icon.d.ts

@@ -1,12 +1,91 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
  * Vector icon entry for the Aithe UI icon system.
+ * 矢量图标组件，用于 Aithe UI 图标系统。
+ *
+ * Renders an SVG glyph from the built-in icon map based on the `name` property.
+ * Supports extended icon format: `(type)value` where type can be:
+ *   - `class` — built-in icon name (default, e.g. `(class)sparkles` or just `sparkles`)
+ *   - `auto` — auto-generate from first character of text (e.g. `(auto)User Name`)
+ *   - `url` | `share` | `remote` — load from URL (e.g. `(url)https://example.com/icon.svg`)
+ *     Supports `URL|AltText` format — shows alt first character on load failure.
+ *     支持 `URL|AltText` 格式，加载失败时显示 alt 首字符。
+ * All icons use a 24×24 viewBox, stroke-based rendering with `stroke-width: 1.8`,
+ * and inherit color via `currentColor`.
+ * 根据 `name` 属性从内置图标映射中渲染 SVG 图形。
+ * 所有图标使用 24×24 视口，基于描边渲染（stroke-width: 1.8），颜色继承 currentColor。
+ *
+ * For `auto` and `url` types, rendering is delegated to {@link IconUtil.render}.
+ * `auto` 和 `url` 类型委托给 {@link IconUtil.render} 渲染。
+ *
+ * Built-in icon names (60+ glyphs):
+ * 内置图标名称（60+ 图形）：
+ *
+ * **General / 通用**: sparkles, close, check, info, warning, image, search, plus, minus,
+ * menu, more, settings, home, star, heart, copy, download, upload, share, link,
+ * external, refresh, edit, trash, filter, sort, lock, unlock, eye, eyeOff, clock,
+ * calendar, pin, flag, bookmark, paperclip, tag, thumbUp, thumbDown
+ *
+ * **Arrows / 箭头**: arrowUp, arrowDown, arrowLeft, arrowRight, chevronUp, chevronDown,
+ * chevronLeft, chevronRight, expand, collapse
+ *
+ * **Status / 状态**: success, error, question
+ *
+ * **Media / 媒体**: play, pause, volume, mute, camera, video, music
+ *
+ * **Communication / 交流**: mail, bell, chat, phone
+ *
+ * **Data / 数据**: barChart, pieChart, database, code, terminal, file, folder
+ *
+ * **Layout / 布局**: grid, list, sidebar, maximize, minimize
+ *
+ * **User / 用户**: user, users
+ *
+ * **Weather / 天气**: sun, moon, cloud
+ *
+ * @slot - Default slot for custom SVG content (overrides built-in glyph).
+ *        默认插槽，用于自定义 SVG 内容（覆盖内置图形）。
+ *
+ * @cssproperty --aithe-icon-size - Controls the SVG width/height. Set dynamically from `size` property.
+ * @cssproperty --aithe-icon-color - Controls the host `color` which cascades to `stroke: currentColor`.
+ *
+ * @example
+ * ```html
+ * <!-- Built-in icon / 内置图标 -->
+ * <aithe-icon name="sparkles" size="lg" color="#4d8dff"></aithe-icon>
+ * <aithe-icon name="check" size="sm"></aithe-icon>
+ * <aithe-icon name="heart" color="var(--aithe-danger-6)"></aithe-icon>
+ *
+ * <!-- Size presets / 尺寸预设: xs sm md lg xl 2xl 3xl 4xl 5xl 6xl -->
+ * <aithe-icon name="search" size="xs"></aithe-icon>
+ * <aithe-icon name="search" size="xl"></aithe-icon>
+ * <aithe-icon name="search" size="6xl"></aithe-icon>
+ *
+ * <!-- Auto-generated text / 文本首字母 -->
+ * <aithe-icon name="(auto)User Name" size="md"></aithe-icon>
+ *
+ * <!-- Remote image with alt fallback / 远程图片带 alt 占位 -->
+ * <aithe-icon name="(url)https://example.com/icon.svg|User" size="md"></aithe-icon>
+ * ```
  */
 export declare class AitheIcon extends AitheElement {
+    /** Icon glyph name from the built-in map. 内置图标名称。 */
     name: string;
+    /** Custom stroke/fill color. 自定义颜色。 */
     color: string;
+    /** Icon size preset or explicit CSS value. 图标尺寸预设或显式 CSS 值。
+     *
+     * Resolved via {@link IconUtil.resolveSize} against {@link ICON_SIZE_MAP}.
+     * 通过 {@link IconUtil.resolveSize} 结合 {@link ICON_SIZE_MAP} 解析。
+     *
+     * Presets / 预设:
+     *   `xs`(12px), `sm`(16px), `md`(20px), `lg`(24px),
+     *   `xl`(28px), `2xl`(32px), `3xl`(48px), `4xl`(64px), `5xl`(96px), `6xl`(128px)
+     *
+     * Any valid CSS dimension also works (e.g. `"32px"`, `"2rem"`, `"24"` → `24px`).
+     * 也支持任意合法 CSS 尺寸值。 */
     size: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    render(): import("lit-html").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult | typeof import("lit-html").nothing;
 }
 //# sourceMappingURL=icon.d.ts.map

package/dist/components/basic/icon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../../src/components/basic/icon.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAaxD;;GAEG;AACH,qBACa,SAAU,SAAQ,YAAY;IACb,IAAI,SAAc;IAClB,KAAK,SAAM;IACX,IAAI,SAAQ;IAExC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAkBpB;IAEF,MAAM;CAaP"}
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../../src/components/basic/icon.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,qDAAqD;IACzB,IAAI,SAAc;IAC9C,uCAAuC;IACX,KAAK,SAAM;IACvC;;;;;;;;;;0BAUsB;IACM,IAAI,SAAQ;IAExC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DASpB;IAEF,MAAM;CAKP"}

package/dist/components/basic/input.d.ts

@@ -1,28 +1,57 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Single-line text input field with prefix/suffix slots, status states, and clearable support.
+ * 单行文本输入框，支持前缀/后缀插槽、状态标记和可清除功能。
+ *
+ * @slot        - Default slot (unused). 默认插槽（未使用）。
+ * @slot prefix - Content before the input (icon, label, etc.). 输入框前的内容（图标、标签等）。
+ * @slot suffix - Content after the input (icon, unit, etc.). 输入框后的内容（图标、单位等）。
+ *
+ * @fires aithe-input  - Emitted on every keystroke with `{ value }`. 每次按键时发出 `{ value }`。
+ * @fires aithe-change - Emitted when the value is committed with `{ value }`. 值提交时发出 `{ value }`。
+ * @fires aithe-clear  - Emitted when the clear button is clicked. 清除按钮被点击时发出。
+ *
+ * @example
+ * ```html
+ * <aithe-input placeholder="Search..." clearable></aithe-input>
+ * <aithe-input status="error" label="Email">invalid@</aithe-input>
+ * ```
+ */
 export declare class AitheInput extends AitheElement {
+    /** HTML input type attribute. HTML input 类型属性。 */
     type: 'text' | 'password' | 'number' | 'tel' | 'email';
+    /** Size scale of the input. 输入框的尺寸规格。 */
     size: 'sm' | 'md' | 'lg';
+    /** Validation status indicator. 验证状态指示器。 */
     status: 'normal' | 'error' | 'success';
+    /** Current value of the input. 输入框的当前值。 */
     value: string;
+    /** Placeholder text. 占位符文本。 */
     placeholder: string;
+    /** Whether the input is disabled. 输入框是否禁用。 */
     disabled: boolean;
+    /** Whether the input is read-only. 输入框是否只读。 */
     readonly: boolean;
+    /** Whether to show a clear button when the input has a value. 输入框有值时是否显示清除按钮。 */
     clearable: boolean;
+    /** HTML `name` attribute. HTML `name` 属性。 */
     name: string;
+    /** HTML `autocomplete` attribute. HTML `autocomplete` 属性。 */
     autocomplete: string;
+    /** Accessible label (used as `aria-label` when no visible label exists). 无障碍标签（当无可见标签时用作 `aria-label`）。 */
     label: string;
-    private inputElement?;
-    private prefixNodes;
-    private suffixNodes;
+    private readonly inputElement?;
+    private readonly prefixNodes;
+    private readonly suffixNodes;
     private hasPrefix;
     private hasSuffix;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     focus(options?: FocusOptions): void;
     updated(changed: Map<string, unknown>): void;
-    private syncSlots;
-    private handleInput;
-    private handleChange;
-    private clearValue;
+    private readonly syncSlots;
+    private readonly handleInput;
+    private readonly handleChange;
+    private readonly clearValue;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=input.d.ts.map

package/dist/components/basic/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/components/basic/input.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,qBACa,UAAW,SAAQ,YAAY;IACd,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAU;IAChE,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAChC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAY;IAClD,KAAK,SAAM;IACX,WAAW,SAAM;IACD,QAAQ,UAAS;IAChC,QAAQ,UAAS;IACjB,SAAS,UAAS;IACnB,IAAI,SAAM;IACV,YAAY,SAAS;IACrB,KAAK,SAAM;IAEvB,OAAO,CAAC,YAAY,CAAC,CAAmB;IACb,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,WAAW,CAAiB;IAEtE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAEnC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwGpB;IAEF,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAInC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM5C,OAAO,CAAC,SAAS,CAGf;IAEF,OAAO,CAAC,WAAW,CAIjB;IAEF,OAAO,CAAC,YAAY,CAIlB;IAEF,OAAO,CAAC,UAAU,CAUhB;IAEF,MAAM;CA6CP"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/components/basic/input.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,kDAAkD;IACtB,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAU;IAC5F,yCAAyC;IACb,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAC5D,4CAA4C;IAChB,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAY;IAC9E,2CAA2C;IACf,KAAK,SAAM;IACvC,+BAA+B;IACH,WAAW,SAAM;IAC7C,8CAA8C;IACF,QAAQ,UAAS;IAC7D,+CAA+C;IAClB,QAAQ,UAAS;IAC9C,iFAAiF;IACpD,SAAS,UAAS;IAC/C,6CAA6C;IACjB,IAAI,SAAM;IACtC,6DAA6D;IACjC,YAAY,SAAS;IACjD,2GAA2G;IAC/E,KAAK,SAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAmB;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAE/E,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAEnC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAgHpB;IAEF,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAInC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGxB;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI1B;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAI3B;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAUzB;IAEF,MAAM;CAsDP"}

package/dist/components/basic/tag.d.ts

@@ -1,14 +1,34 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Colored tag / label with optional close and select behavior.
+ * 彩色标签，支持关闭和选中交互。
+ *
+ * @slot - Default slot for tag label text. 标签文本内容。
+ * @fires aithe-change - Emitted when selectable tag is toggled. 选中状态变更时触发。
+ * @fires aithe-close - Emitted when the close button is clicked. 关闭按钮点击时触发。
+ * @example
+ * ```html
+ * <aithe-tag type="primary" closable>Selectable Tag</aithe-tag>
+ * ```
+ */
 export declare class AitheTag extends AitheElement {
+    /** Tag color variant. 标签颜色类型。 */
     type: 'primary' | 'success' | 'warning' | 'danger' | 'default';
+    /** Whether the tag shows a close button. 是否显示关闭按钮。 */
     closable: boolean;
+    /** Whether the tag can be toggled (selected/unselected). 是否可选中切换。 */
     selectable: boolean;
+    /** Whether the tag is currently selected. 当前是否选中。 */
     selected: boolean;
+    /** Border-radius preset. 圆角预设。 */
     rounded: 'sm' | 'md' | 'lg' | 'full';
+    /** Whether the tag is disabled. 是否禁用。 */
     disabled: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private toggleTag;
-    private handleClose;
+    /** Toggles the selected state and emits change event. 切换选中状态并触发变更事件。 */
+    private readonly toggleTag;
+    /** Handles close button click: emits event, then removes the tag from DOM. 处理关闭按钮点击：触发事件、然后从 DOM 移除标签。 */
+    private readonly handleClose;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=tag.d.ts.map

package/dist/components/basic/tag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../../src/components/basic/tag.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,qBACa,QAAS,SAAQ,YAAY;IACZ,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAa;IAC1E,QAAQ,UAAS;IACjB,UAAU,UAAS;IACJ,QAAQ,UAAS;IACjC,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAU;IAC9B,QAAQ,UAAS;IAE7D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8FpB;IAEF,OAAO,CAAC,SAAS,CAOf;IAEF,OAAO,CAAC,WAAW,CAOjB;IAEF,MAAM;CAiCP"}
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../../src/components/basic/tag.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;GAWG;AACH,qBACa,QAAS,SAAQ,YAAY;IACxC,iCAAiC;IACL,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAC9E;IACZ,sDAAsD;IACzB,QAAQ,UAAS;IAC9C,qEAAqE;IACxC,UAAU,UAAS;IAChD,qDAAqD;IACT,QAAQ,UAAS;IAC7D,kCAAkC;IACN,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAU;IAC1E,yCAAyC;IACG,QAAQ,UAAS;IAE7D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8FpB;IAEF,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAOxB;IAEF,0GAA0G;IAC1G,OAAO,CAAC,QAAQ,CAAC,WAAW,CAM1B;IAEF,MAAM;CAiCP"}

package/dist/components/basic/textarea.d.ts

@@ -1,18 +1,34 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Multi-line text input component.
+ * Multi-line text input component with auto-grow support.
+ * 多行文本输入组件，支持自动增长。
+ *
+ * @slot - Default slot (unused; content controlled by value property). 默认插槽（未使用，内容由 value 属性控制）。
+ * @fires aithe-input - Emitted on each keystroke with current value. 每次输入时触发。
+ * @fires aithe-change - Emitted when the value is committed. 值提交时触发。
+ * @example
+ * ```html
+ * <aithe-textarea rows="4" placeholder="Enter text..." maxlength="200"></aithe-textarea>
+ * ```
  */
 export declare class AitheTextarea extends AitheElement {
+    /** Number of visible text rows. 可见文本行数。 */
     rows: number;
+    /** Placeholder text shown when empty. 空内容时的占位文本。 */
     placeholder: string;
+    /** Resize direction allowed for the textarea. 允许的调整大小方向。 */
     resize: 'none' | 'both' | 'horizontal' | 'vertical';
+    /** Current textarea value. 当前文本值。 */
     value: string;
+    /** Maximum character length (-1 means unlimited). 最大字符长度（-1 表示不限）。 */
     maxlength: number;
+    /** Whether the textarea is disabled. 是否禁用。 */
     disabled: boolean;
-    private textarea?;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private handleInput;
-    private handleChange;
+    /** Handles input events and emits value. 处理输入事件并触发 input 事件。 */
+    private readonly handleInput;
+    /** Handles change events and emits value. 处理变更事件并触发 change 事件。 */
+    private readonly handleChange;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=textarea.d.ts.map

package/dist/components/basic/textarea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../../../src/components/basic/textarea.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,aAAc,SAAQ,YAAY;IACjB,IAAI,SAAK;IACT,WAAW,SAAM;IACjB,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,CAAc;IACjE,KAAK,SAAM;IACX,SAAS,SAAM;IACC,QAAQ,UAAS;IAE1C,OAAO,CAAC,QAAQ,CAAC,CAAsB;IAE1D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiCpB;IAEF,OAAO,CAAC,WAAW,CAGjB;IAEF,OAAO,CAAC,YAAY,CAGlB;IAEF,MAAM;CAgBP"}
+{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../../../src/components/basic/textarea.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;GAWG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,2CAA2C;IACf,IAAI,SAAK;IACrC,oDAAoD;IACxB,WAAW,SAAM;IAC7C,4DAA4D;IAChC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,UAAU,CAAc;IAC7F,qCAAqC;IACT,KAAK,SAAM;IACvC,sEAAsE;IAC1C,SAAS,SAAM;IAC3C,8CAA8C;IACF,QAAQ,UAAS;IAE7D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAuCpB;IAEF,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAG1B;IAEF,kEAAkE;IAClE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG3B;IAEF,MAAM;CAgBP"}

package/dist/components/container/AGENTS.md

@@ -0,0 +1,23 @@
+# src/components/container/ — 容器组件（4个）
+
+## 组件列表
+
+| 组件             | 标签                  | 说明             |
+| ---------------- | --------------------- | ---------------- |
+| `callout.ts`     | `<aithe-callout>`     | 高亮提示块       |
+| `details.ts`     | `<aithe-details>`     | 可展开详情区域   |
+| `scroller.ts`    | `<aithe-scroller>`    | 自定义滚动容器   |
+| `split-panel.ts` | `<aithe-split-panel>` | 可调整双面板布局 |
+
+## 编码规范
+
+- 继承 `AitheElement`，使用 `@customElement` 装饰器
+- 导入使用 `@components/container/xxx` 路径别名
+- 中英文双语 JSDoc 注释
+
+## 关键约定
+
+- `aithe-callout` 通过 `type` 属性控制样式（info/success/warning/danger）
+- `aithe-details` 通过 `open` 属性控制展开/收起
+- `aithe-split-panel` 通过 `split` 属性控制分割方向（horizontal/vertical）
+- 新增组件需同步更新 `src/index.ts` 和 `docs/api/container/`

package/dist/components/container/callout.d.ts

@@ -1,10 +1,22 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Highlighted callout block.
+ * Highlighted callout block with colored left border and optional title.
+ * 高亮提示块，带彩色左边框和可选标题。
+ *
+ * @slot - Default slot for callout body content. 提示块正文内容的默认插槽。
+ *
+ * @example
+ * ```html
+ * <aithe-callout type="warning" title="Caution">Check before proceeding.</aithe-callout>
+ * ```
  */
 export declare class AitheCallout extends AitheElement {
+    /** Color variant of the callout. 提示块的颜色类型。 */
     type: 'default' | 'success' | 'warning' | 'danger';
+    /** Optional title displayed above the body. 正文上方显示的可选标题。 */
     title: string;
+    /** Icon name to display before the title. 在标题前显示的图标名称。 */
+    icon: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;
 }

package/dist/components/container/callout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callout.d.ts","sourceRoot":"","sources":["../../../src/components/container/callout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,YAAa,SAAQ,YAAY;IAChB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAC/D,KAAK,SAAM;IAEvC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqCpB;IAEF,MAAM;CAQP"}
+{"version":3,"file":"callout.d.ts","sourceRoot":"","sources":["../../../src/components/container/callout.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,8CAA8C;IAClB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAC3F,4DAA4D;IAChC,KAAK,SAAM;IACvC,0DAA0D;IAC9B,IAAI,SAAM;IAEtC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA6CpB;IAEF,MAAM;CAkBP"}

package/dist/components/container/details.d.ts

@@ -1,11 +1,27 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Themed details disclosure.
+ * Themed details disclosure with expand/collapse toggle.
+ * 带展开/收起切换的主题化详情折叠组件。
+ *
+ * @slot - Default slot for the disclosure body content. 折叠正文内容的默认插槽。
+ *
+ * @fires aithe-toggle - Emitted when the disclosure is toggled with `{ open }`. 折叠切换时发出 `{ open }`。
+ *
+ * @example
+ * ```html
+ * <aithe-details open summary="More info">Hidden content here.</aithe-details>
+ * ```
  */
 export declare class AitheDetails extends AitheElement {
+    /** Whether the disclosure is initially open. 折叠是否初始展开。 */
     open: boolean;
+    /** Summary text shown as the toggle label. 作为切换标签显示的摘要文本。 */
     summary: string;
-    private detailsElement?;
+    /** Icon name to display before the summary text. 在摘要文本前显示的图标名称。 */
+    icon: string;
+    /** Display title for the details (shown as tooltip). 详情折叠的显示标题（作为工具提示）。 */
+    title: string;
+    private readonly detailsElement?;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     protected updated(changed: Map<string, unknown>): void;
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/container/details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../../src/components/container/details.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,YAAa,SAAQ,YAAY;IACA,IAAI,UAAS;IAC7B,OAAO,SAAa;IAE9B,OAAO,CAAC,cAAc,CAAC,CAAqB;IAE9D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwBpB;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,MAAM;CAgBP"}
+{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../../src/components/container/details.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;GAYG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,0DAA0D;IACd,IAAI,UAAS;IACzD,6DAA6D;IACjC,OAAO,SAAM;IACzC,mEAAmE;IACvC,IAAI,SAAM;IACtC,2EAA2E;IAC/C,KAAK,SAAM;IAErB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAqB;IAEvE,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAgCpB;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,MAAM;CAuBP"}

package/dist/components/container/scroller.d.ts

@@ -1,16 +1,32 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Themed scroll container.
+ * Themed scroll container with optional shadow edges and scrollbar control.
+ * 主题化滚动容器，支持可选阴影边缘和滚动条控制。
+ *
+ * @slot - Default slot for scrollable content. 可滚动内容的默认插槽。
+ *
+ * @fires aithe-scroll - Emitted on scroll with `{ top, left }`. 滚动时发出 `{ top, left }`。
+ *
+ * @example
+ * ```html
+ * <aithe-scroller height="300px" shadow scrollbar>
+ *   <p>Long content here...</p>
+ * </aithe-scroller>
+ * ```
  */
 export declare class AitheScroller extends AitheElement {
+    /** Fixed height of the scroll area (CSS value). 滚动区域的固定高度（CSS 值）。 */
     height: string;
+    /** Maximum height of the scroll area (CSS value). 滚动区域的最大高度（CSS 值）。 */
     maxHeight: string;
+    /** Whether to show gradient shadows at scroll edges. 是否在滚动边缘显示渐变阴影。 */
     shadow: boolean;
+    /** Whether to show the native scrollbar. 是否显示原生滚动条。 */
     scrollbar: boolean;
     private shadowTop;
     private shadowBottom;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private handleScroll;
+    private readonly handleScroll;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=scroller.d.ts.map

package/dist/components/container/scroller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scroller.d.ts","sourceRoot":"","sources":["../../../src/components/container/scroller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,aAAc,SAAQ,YAAY;IACjB,MAAM,SAAM;IACa,SAAS,SAAM;IACvC,MAAM,UAAS;IACf,SAAS,UAAQ;IAErC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAEtC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiDpB;IAEF,OAAO,CAAC,YAAY,CAQlB;IAEF,MAAM;CAoBP"}
+{"version":3,"file":"scroller.d.ts","sourceRoot":"","sources":["../../../src/components/container/scroller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;;GAcG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,qEAAqE;IACzC,MAAM,SAAM;IACxC,uEAAuE;IAClB,SAAS,SAAM;IACpE,uEAAuE;IAC1C,MAAM,UAAS;IAC5C,uDAAuD;IAC1B,SAAS,UAAQ;IAErC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAEtC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiDpB;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAQ3B;IAEF,MAAM;CAuBP"}