@aithe/aithe-ui 26.2.2 → 26.3.1

package/dist/components/basic/tag.js

@@ -0,0 +1,248 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { css, html } from 'lit';
+import { customElement, property } from 'lit/decorators.js';
+import { classMap } from 'lit/directives/class-map.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles } from '../../core/styles';
+/**
+ * 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 variant="primary" closable>Selectable Tag</aithe-tag>
+ * ```
+ */
+let AitheTag = class AitheTag extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /**
+         * Tag color variant. 标签颜色类型。
+         * @deprecated Use `variant` instead. 请使用 `variant` 代替。
+         */
+        this.type = 'success';
+        /** Whether the tag shows a close button. 是否显示关闭按钮。 */
+        this.closable = false;
+        /** Whether the tag can be toggled (selected/unselected). 是否可选中切换。 */
+        this.selectable = false;
+        /** Whether the tag is currently selected. 当前是否选中。 */
+        this.selected = false;
+        /** Border-radius preset. 圆角预设。 */
+        this.rounded = 'full';
+        /** Whether the tag is disabled. 是否禁用。 */
+        this.disabled = false;
+        /** Size scale of the tag. 标签的尺寸规格。 */
+        this.size = 'sm';
+        /** Toggles the selected state and emits change event. 切换选中状态并触发变更事件。 */
+        this.toggleTag = () => {
+            if (!this.selectable || this.disabled) {
+                return;
+            }
+            this.selected = !this.selected;
+            this.emit('aithe-change', { selected: this.selected });
+        };
+        /** Handles close button click: emits event, then removes the tag from DOM. 处理关闭按钮点击：触发事件、然后从 DOM 移除标签。 */
+        this.handleClose = (event) => {
+            event.stopPropagation();
+            if (this.disabled)
+                return;
+            this.emit('aithe-close');
+            this.remove();
+        };
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        display: inline-flex;
+      }
+
+      .tag {
+        display: inline-flex;
+        align-items: center;
+        gap: var(--aithe-space-2);
+        padding: 0 var(--aithe-space-3);
+        border: 1px solid transparent;
+        color: var(--aithe-color-text);
+        font-size: var(--aithe-font-size-sm);
+        transition:
+          background var(--aithe-duration-fast) var(--aithe-ease-standard),
+          border-color var(--aithe-duration-fast) var(--aithe-ease-standard),
+          color var(--aithe-duration-fast) var(--aithe-ease-standard),
+          box-shadow var(--aithe-duration-fast) var(--aithe-ease-standard);
+      }
+
+      /* Size variants — use vertical padding to control overall height */
+      .size-sm {
+        font-size: var(--aithe-font-size-xs);
+        padding: 1px var(--aithe-space-2);
+        line-height: 1.4;
+      }
+      .size-md {
+        font-size: var(--aithe-font-size-sm);
+        padding: 3px var(--aithe-space-3);
+        line-height: 1.5;
+      }
+      .size-lg {
+        font-size: var(--aithe-font-size-md);
+        padding: 7px var(--aithe-space-4);
+        line-height: 1.6;
+      }
+
+      .tag.selectable {
+        cursor: pointer;
+      }
+
+      .tag.disabled {
+        opacity: 0.56;
+        cursor: not-allowed;
+      }
+
+      /* Variant styles via :host attribute selector */
+      :host([variant='primary']) .tag {
+        color: var(--aithe-primary-8);
+        background: var(--aithe-primary-1);
+        border-color: var(--aithe-primary-3);
+      }
+      :host([variant='success']) .tag {
+        color: var(--aithe-success-8);
+        background: var(--aithe-success-1);
+        border-color: var(--aithe-success-3);
+      }
+      :host([variant='warning']) .tag {
+        color: var(--aithe-warning-8);
+        background: var(--aithe-warning-1);
+        border-color: var(--aithe-warning-3);
+      }
+      :host([variant='danger']) .tag {
+        color: var(--aithe-danger-8);
+        background: var(--aithe-danger-1);
+        border-color: var(--aithe-danger-3);
+      }
+
+      /* Deprecated type class styles for backward compatibility */
+      .tag.primary {
+        color: var(--aithe-primary-8);
+        background: var(--aithe-primary-1);
+        border-color: var(--aithe-primary-3);
+      }
+      .tag.success {
+        color: var(--aithe-success-8);
+        background: var(--aithe-success-1);
+        border-color: var(--aithe-success-3);
+      }
+      .tag.warning {
+        color: var(--aithe-warning-8);
+        background: var(--aithe-warning-1);
+        border-color: var(--aithe-warning-3);
+      }
+      .tag.danger {
+        color: var(--aithe-danger-8);
+        background: var(--aithe-danger-1);
+        border-color: var(--aithe-danger-3);
+      }
+
+      .selected {
+        box-shadow: 0 0 0 3px var(--aithe-color-focus-ring);
+      }
+
+      .radius-sm {
+        border-radius: var(--aithe-radius-sm);
+      }
+
+      .radius-md {
+        border-radius: var(--aithe-radius-md);
+      }
+
+      .radius-lg {
+        border-radius: var(--aithe-radius-lg);
+      }
+
+      .radius-full {
+        border-radius: var(--aithe-radius-full);
+      }
+
+      .close {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        width: 18px;
+        height: 18px;
+        border: none;
+        border-radius: 50%;
+        background: transparent;
+        color: inherit;
+        cursor: pointer;
+      }
+    `,
+    ]; }
+    render() {
+        return html `
+      <span
+        class=${classMap({
+            tag: true,
+            [`size-${this.size}`]: true,
+            [`radius-${this.rounded}`]: true,
+            selectable: this.selectable,
+            selected: this.selected,
+            disabled: this.disabled,
+            // Deprecated: keep type class for backward compatibility
+            // eslint-disable-next-line sonarjs/deprecation
+            [this.type]: this.type !== 'default',
+        })}
+        aria-pressed=${this.selectable ? String(this.selected) : 'false'}
+        role=${this.selectable ? 'button' : 'status'}
+        tabindex=${this.selectable && !this.disabled ? 0 : -1}
+        @click=${this.toggleTag}
+        @keydown=${(event) => {
+            if (event.key === 'Enter' || event.key === ' ') {
+                event.preventDefault();
+                this.toggleTag();
+            }
+        }}
+      >
+        <slot></slot>
+        ${this.closable
+            ? html `
+              <button class="close" type="button" tabindex="-1" @click=${this.handleClose}>
+                ×
+              </button>
+            `
+            : null}
+      </span>
+    `;
+    }
+};
+__decorate([
+    property({ type: String })
+], AitheTag.prototype, "type", void 0);
+__decorate([
+    property({ type: Boolean })
+], AitheTag.prototype, "closable", void 0);
+__decorate([
+    property({ type: Boolean })
+], AitheTag.prototype, "selectable", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheTag.prototype, "selected", void 0);
+__decorate([
+    property({ type: String })
+], AitheTag.prototype, "rounded", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheTag.prototype, "disabled", void 0);
+__decorate([
+    property({ type: String })
+], AitheTag.prototype, "size", void 0);
+AitheTag = __decorate([
+    customElement('aithe-tag')
+], AitheTag);
+export { AitheTag };

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

@@ -1,18 +1,33 @@
-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;
+    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,CAI1B;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAI3B;IAEF,MAAM;CAgBP"}

package/dist/components/basic/textarea.js

@@ -0,0 +1,130 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { css, html } from 'lit';
+import { customElement, property } from 'lit/decorators.js';
+import { classMap } from 'lit/directives/class-map.js';
+import { styleMap } from 'lit/directives/style-map.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles, aitheControlFocusStyleBlock, aitheControlStyleBlock } from '../../core/styles';
+/**
+ * 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>
+ * ```
+ */
+let AitheTextarea = class AitheTextarea extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /** Number of visible text rows. 可见文本行数。 */
+        this.rows = 4;
+        /** Placeholder text shown when empty. 空内容时的占位文本。 */
+        this.placeholder = '';
+        /** Resize direction allowed for the textarea. 允许的调整大小方向。 */
+        this.resize = 'vertical';
+        /** Current textarea value. 当前文本值。 */
+        this.value = '';
+        /** Maximum character length (-1 means unlimited). 最大字符长度（-1 表示不限）。 */
+        this.maxlength = -1;
+        /** Whether the textarea is disabled. 是否禁用。 */
+        this.disabled = false;
+        /** Handles input events and emits value. 处理输入事件并触发 input 事件。 */
+        this.handleInput = (event) => {
+            event.stopPropagation();
+            this.value = event.currentTarget.value;
+            this.emit('aithe-input', { value: this.value });
+        };
+        this.handleChange = (event) => {
+            event.stopPropagation();
+            this.value = event.currentTarget.value;
+            this.emit('aithe-change', { value: this.value });
+        };
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        display: inline-flex;
+        width: 100%;
+      }
+
+      .field {
+        display: flex;
+        flex-direction: column;
+        ${aitheControlStyleBlock}
+        width: 100%;
+        padding: var(--aithe-space-3) var(--aithe-space-3);
+      }
+
+      .field:focus-within {
+        ${aitheControlFocusStyleBlock}
+      }
+
+      .field.disabled {
+        opacity: 0.56;
+        cursor: not-allowed;
+      }
+
+      textarea {
+        width: 100%;
+        min-height: 100%;
+        border: none !important;
+        outline: none;
+        background: transparent;
+        color: inherit;
+      }
+
+      textarea:focus {
+        border: none !important;
+        outline: none;
+      }
+    `,
+    ]; }
+    render() {
+        return html `
+      <label class=${classMap({ field: true, disabled: this.disabled })}>
+        <textarea
+          .value=${this.value}
+          ?disabled=${this.disabled}
+          maxlength=${this.maxlength > -1 ? String(this.maxlength) : ''}
+          placeholder=${this.placeholder}
+          rows=${String(this.rows)}
+          style=${styleMap({ resize: this.resize })}
+          @change=${this.handleChange}
+          @input=${this.handleInput}
+        ></textarea>
+      </label>
+    `;
+    }
+};
+__decorate([
+    property({ type: Number })
+], AitheTextarea.prototype, "rows", void 0);
+__decorate([
+    property({ type: String })
+], AitheTextarea.prototype, "placeholder", void 0);
+__decorate([
+    property({ type: String })
+], AitheTextarea.prototype, "resize", void 0);
+__decorate([
+    property({ type: String })
+], AitheTextarea.prototype, "value", void 0);
+__decorate([
+    property({ type: Number })
+], AitheTextarea.prototype, "maxlength", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheTextarea.prototype, "disabled", void 0);
+AitheTextarea = __decorate([
+    customElement('aithe-textarea')
+], AitheTextarea);
+export { AitheTextarea };

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/callout.js

@@ -0,0 +1,108 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { css, html, nothing } from 'lit';
+import { customElement, property } from 'lit/decorators.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles } from '../../core/styles';
+/**
+ * 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>
+ * ```
+ */
+let AitheCallout = class AitheCallout extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /** Color variant of the callout. 提示块的颜色类型。 */
+        this.type = 'default';
+        /** Optional title displayed above the body. 正文上方显示的可选标题。 */
+        this.title = '';
+        /** Icon name to display before the title. 在标题前显示的图标名称。 */
+        this.icon = '';
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        display: block;
+      }
+
+      .callout {
+        display: grid;
+        gap: var(--aithe-space-2);
+        padding: var(--aithe-space-5);
+        border: 1px solid var(--aithe-color-border);
+        border-left-width: 4px;
+        border-radius: var(--aithe-container-radius-xl);
+        background: var(--aithe-color-surface-elevated);
+      }
+
+      .callout.success {
+        border-left-color: var(--aithe-success-6);
+      }
+
+      .callout.warning {
+        border-left-color: var(--aithe-warning-6);
+      }
+
+      .callout.danger {
+        border-left-color: var(--aithe-danger-6);
+      }
+
+      .callout.default {
+        border-left-color: var(--aithe-primary-6);
+      }
+
+      .title {
+        display: inline-flex;
+        align-items: center;
+        gap: var(--aithe-space-2);
+        font-weight: var(--aithe-font-weight-semibold);
+      }
+
+      .title-icon {
+        flex-shrink: 0;
+        color: var(--aithe-color-text-muted);
+      }
+    `,
+    ]; }
+    render() {
+        const titleIcon = this.icon
+            ? html `
+          <aithe-icon class="title-icon" name=${this.icon} size="16"></aithe-icon>
+        `
+            : nothing;
+        return html `
+      <div class=${`callout ${this.type}`}>
+        ${this.title
+            ? html `
+              <div class="title">${titleIcon}${this.title}</div>
+            `
+            : null}
+        <slot></slot>
+      </div>
+    `;
+    }
+};
+__decorate([
+    property({ type: String })
+], AitheCallout.prototype, "type", void 0);
+__decorate([
+    property({ type: String })
+], AitheCallout.prototype, "title", void 0);
+__decorate([
+    property({ type: String })
+], AitheCallout.prototype, "icon", void 0);
+AitheCallout = __decorate([
+    customElement('aithe-callout')
+], AitheCallout);
+export { AitheCallout };

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"}