@aithe/aithe-ui 26.2.2 → 26.2.3

package/dist/components/layout/col.d.ts

@@ -1,12 +1,27 @@
 import { AitheElement } from '../../core/aithe-element';
 /**
- * 24-grid column item.
+ * 24-grid column item for use inside `aithe-row`.
+ * 24栅格列元素，用于 aithe-row 内部。
+ *
+ * @slot - Default slot for column content. 列内容。
+ * @example
+ * ```html
+ * <aithe-row gutter="16">
+ *   <aithe-col span="8" offset="4">Content</aithe-col>
+ *   <aithe-col span="12" flex="1 1 auto">Flexible</aithe-col>
+ * </aithe-row>
+ * ```
  */
 export declare class AitheCol extends AitheElement {
+    /** Number of grid columns to occupy (1–24). 占据的栅格数（1–24）。 */
     span: number;
+    /** Number of grid columns to offset from the left. 左侧偏移的栅格数。 */
     offset: number;
+    /** Number of grid columns to push right. 向右推的栅格数。 */
     push: number;
+    /** Number of grid columns to pull left. 向左拉的栅格数。 */
     pull: number;
+    /** Custom flex value (overrides span-based width). 自定义 flex 值（覆盖基于 span 的宽度）。 */
     flex: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     connectedCallback(): void;

package/dist/components/layout/col.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"col.d.ts","sourceRoot":"","sources":["../../../src/components/layout/col.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,QAAS,SAAQ,YAAY;IACZ,IAAI,SAAM;IACV,MAAM,SAAK;IACX,IAAI,SAAK;IACT,IAAI,SAAK;IACT,IAAI,SAAM;IAEtC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAmBpB;IAEO,iBAAiB,IAAI,IAAI;IAKzB,OAAO,IAAI,IAAI;IAIxB,OAAO,CAAC,iBAAiB;IAgBzB,MAAM;CAGP"}
+{"version":3,"file":"col.d.ts","sourceRoot":"","sources":["../../../src/components/layout/col.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;GAYG;AACH,qBACa,QAAS,SAAQ,YAAY;IACxC,6DAA6D;IACjC,IAAI,SAAM;IACtC,gEAAgE;IACpC,MAAM,SAAK;IACvC,qDAAqD;IACzB,IAAI,SAAK;IACrC,oDAAoD;IACxB,IAAI,SAAK;IACrC,iFAAiF;IACrD,IAAI,SAAM;IAEtC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAmBpB;IAEO,iBAAiB,IAAI,IAAI;IAKzB,OAAO,IAAI,IAAI;IAIxB,OAAO,CAAC,iBAAiB;IAgBzB,MAAM;CAKP"}

package/dist/components/layout/collapse-item.d.ts

@@ -1,15 +1,31 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Single collapsible panel for `aithe-collapse`.
+ * Single collapsible panel for use inside `aithe-collapse`.
+ * 单个可折叠面板，用于 aithe-collapse 内部。
+ *
+ * @slot - Default slot for panel body content. 面板正文内容。
+ * @fires aithe-collapse-toggle - Emitted when the panel is toggled. 面板切换时触发。
+ * @example
+ * ```html
+ * <aithe-collapse-item title="Details" name="detail-1" icon="info">
+ *   <p>Expanded content here.</p>
+ * </aithe-collapse-item>
+ * ```
  */
 export declare class AitheCollapseItem extends AitheElement {
+    /** Panel header title text. 面板标题文本。 */
     title: string;
+    /** Unique key identifying this panel. 面板唯一标识键。 */
     name: string;
+    /** Icon name to display before the title. 在标题前显示的图标名称。 */
+    icon: string;
+    /** Whether the panel is disabled and cannot be toggled. 是否禁用面板切换。 */
     disabled: boolean;
+    /** Whether the panel is currently expanded. 是否当前展开。 */
     open: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private toggle;
-    private handleKeydown;
+    private readonly toggle;
+    private readonly handleKeydown;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=collapse-item.d.ts.map

package/dist/components/layout/collapse-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collapse-item.d.ts","sourceRoot":"","sources":["../../../src/components/layout/collapse-item.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACrB,KAAK,SAAM;IACX,IAAI,SAAM;IACM,QAAQ,UAAS;IACjB,IAAI,UAAS;IAEzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqDpB;IAEF,OAAO,CAAC,MAAM,CASZ;IAEF,OAAO,CAAC,aAAa,CAOnB;IAEF,MAAM;CAkBP"}
+{"version":3,"file":"collapse-item.d.ts","sourceRoot":"","sources":["../../../src/components/layout/collapse-item.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;GAYG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACjD,uCAAuC;IACX,KAAK,SAAM;IACvC,kDAAkD;IACtB,IAAI,SAAM;IACtC,0DAA0D;IAC9B,IAAI,SAAM;IACtC,qEAAqE;IACzB,QAAQ,UAAS;IAC7D,uDAAuD;IACX,IAAI,UAAS;IAEzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiEpB;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CASrB;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAO5B;IAEF,MAAM;CAyBP"}

package/dist/components/layout/collapse.d.ts

@@ -1,9 +1,22 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Accordion / multi-expand collapse container.
+ * Accordion / multi-expand collapse container for collapsible panels.
+ * 手风琴/多展开折叠容器，用于可折叠面板。
+ *
+ * @slot - Default slot for `aithe-collapse-item` elements. aithe-collapse-item 面板元素。
+ * @fires aithe-change - Emitted when the active panel changes. 活动面板变更时触发。
+ * @example
+ * ```html
+ * <aithe-collapse active-key="panel-1" accordion>
+ *   <aithe-collapse-item title="Section A" name="panel-1">Content A</aithe-collapse-item>
+ *   <aithe-collapse-item title="Section B" name="panel-2">Content B</aithe-collapse-item>
+ * </aithe-collapse>
+ * ```
  */
 export declare class AitheCollapse extends AitheElement {
+    /** Comma-separated keys of active (expanded) panels. 活动（展开）面板的键，逗号分隔。 */
     activeKey: string;
+    /** Whether only one panel can be open at a time (accordion mode). 是否只允许同时打开一个面板（手风琴模式）。 */
     accordion: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     connectedCallback(): void;
@@ -11,8 +24,8 @@ export declare class AitheCollapse extends AitheElement {
     protected updated(changed: Map<string, unknown>): void;
     private get items();
     private get activeKeys();
-    private syncItems;
-    private handleToggle;
+    private readonly syncItems;
+    private readonly handleToggle;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=collapse.d.ts.map

package/dist/components/layout/collapse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collapse.d.ts","sourceRoot":"","sources":["../../../src/components/layout/collapse.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD;;GAEG;AACH,qBACa,aAAc,SAAQ,YAAY;IACQ,SAAS,SAAM;IACvC,SAAS,UAAS;IAE/C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAQpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,UAAU,GAOrB;IAED,OAAO,CAAC,SAAS,CAQf;IAEF,OAAO,CAAC,YAAY,CAqBlB;IAEF,MAAM;CAGP"}
+{"version":3,"file":"collapse.d.ts","sourceRoot":"","sources":["../../../src/components/layout/collapse.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;GAaG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,yEAAyE;IACpB,SAAS,SAAM;IACpE,2FAA2F;IAC9D,SAAS,UAAS;IAE/C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAQpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,KAAK,KAAK,GAEhB;IAED,OAAO,KAAK,UAAU,GAOrB;IAED,OAAO,CAAC,QAAQ,CAAC,SAAS,CAOxB;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAqB3B;IAEF,MAAM;CAKP"}

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

@@ -1,13 +1,28 @@
 import { AitheElement } from '../../core/aithe-element';
 /**
- * Top-level page layout container.
+ * Top-level page layout container with configurable width, padding, and direction.
+ * 顶层页面布局容器，支持配置宽度、内边距和方向。
+ *
+ * @slot - Default slot for container content. 容器内容。
+ * @example
+ * ```html
+ * <aithe-container max-width="960px" padding="var(--aithe-space-lg)" direction="column">
+ *   <p>Centered content</p>
+ * </aithe-container>
+ * ```
  */
 export declare class AitheContainer extends AitheElement {
+    /** Maximum width of the container (CSS value). 容器最大宽度（CSS 值）。 */
     maxWidth: string;
+    /** Horizontal padding of the container (CSS value). 容器水平内边距（CSS 值）。 */
     padding: string;
+    /** Gap between child elements (CSS value). 子元素间距（CSS 值）。 */
     gap: string;
+    /** Whether the container fills the full width without max-width constraint. 是否填满全宽，不受最大宽度限制。 */
     fluid: boolean;
+    /** Whether the container fills the full viewport height. 是否填满整个视口高度。 */
     full: boolean;
+    /** Flex direction for child layout. 子元素排列方向。 */
     direction: 'row' | 'column';
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

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

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../src/components/layout/container.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD;;GAEG;AACH,qBACa,cAAe,SAAQ,YAAY;IAClB,QAAQ,SAAY;IACpB,OAAO,SAA2B;IAClC,GAAG,SAAO;IACM,KAAK,UAAS;IAC7B,IAAI,UAAS;IACd,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAY;IAEnE,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAQpB;IAEF,MAAM;CAqBP"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../src/components/layout/container.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;GAWG;AACH,qBACa,cAAe,SAAQ,YAAY;IAC9C,iEAAiE;IACrC,QAAQ,SAAY;IAChD,uEAAuE;IAC3C,OAAO,SAA2B;IAC9D,4DAA4D;IAChC,GAAG,SAAO;IACtC,gGAAgG;IACpD,KAAK,UAAS;IAC1D,wEAAwE;IAC3C,IAAI,UAAS;IAC1C,gDAAgD;IACpB,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAY;IAEnE,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAQpB;IAEF,MAAM;CAqBP"}

package/dist/components/layout/flex.d.ts

@@ -1,13 +1,29 @@
 import { AitheElement } from '../../core/aithe-element';
 /**
- * Quick flex layout helper.
+ * Quick flex layout helper with declarative properties.
+ * 快速弹性布局辅助组件，支持声明式属性配置。
+ *
+ * @slot - Default slot for flex child elements. 弹性子元素内容。
+ * @example
+ * ```html
+ * <aithe-flex justify="center" align="middle" gap="var(--aithe-space-md)" direction="row">
+ *   <div>Item 1</div>
+ *   <div>Item 2</div>
+ * </aithe-flex>
+ * ```
  */
 export declare class AitheFlex extends AitheElement {
+    /** Flex justify-content value. flex justify-content 值。 */
     justify: string;
+    /** Flex align-items value. flex align-items 值。 */
     align: string;
+    /** Flex direction. flex 方向。 */
     direction: 'row' | 'column';
+    /** Gap between flex items (CSS value). flex 子元素间距（CSS 值）。 */
     gap: string;
+    /** Flex wrap behavior. flex 换行方式。 */
     wrap: 'nowrap' | 'wrap';
+    /** Whether the flex container is inline. 是否为内联弹性容器。 */
     inline: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/layout/flex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flex.d.ts","sourceRoot":"","sources":["../../../src/components/layout/flex.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD;;GAEG;AACH,qBACa,SAAU,SAAQ,YAAY;IACb,OAAO,SAAgB;IACvB,KAAK,SAAa;IAClB,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAS;IACpC,GAAG,SAA2B;IAC9B,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAY;IACnB,MAAM,UAAS;IAE3D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiBpB;IAEF,MAAM;CAmBP"}
+{"version":3,"file":"flex.d.ts","sourceRoot":"","sources":["../../../src/components/layout/flex.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;GAYG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,0DAA0D;IAC9B,OAAO,SAAgB;IACnD,kDAAkD;IACtB,KAAK,SAAa;IAC9C,+BAA+B;IACH,SAAS,EAAE,KAAK,GAAG,QAAQ,CAAS;IAChE,6DAA6D;IACjC,GAAG,SAA2B;IAC1D,qCAAqC;IACT,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAY;IAC/D,uDAAuD;IACX,MAAM,UAAS;IAE3D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiBpB;IAEF,MAAM;CAmBP"}

package/dist/components/layout/row.d.ts

@@ -1,11 +1,25 @@
 import { AitheElement } from '../../core/aithe-element';
 /**
- * 24-grid row container.
+ * 24-grid row container for grid layout system.
+ * 24栅格行容器，用于栅格布局系统。
+ *
+ * @slot - Default slot for `aithe-col` elements. aithe-col 列元素。
+ * @example
+ * ```html
+ * <aithe-row gutter="16" justify="space-between" align="center">
+ *   <aithe-col span="12">Left</aithe-col>
+ *   <aithe-col span="12">Right</aithe-col>
+ * </aithe-row>
+ * ```
  */
 export declare class AitheRow extends AitheElement {
+    /** Column gutter in pixels. 列间距（像素）。 */
     gutter: number;
+    /** Vertical gap between rows in pixels. 行间距（像素）。 */
     rowGap: number;
+    /** Horizontal alignment of columns. 列水平对齐方式。 */
     justify: 'start' | 'center' | 'end' | 'space-between' | 'space-around';
+    /** Vertical alignment of columns. 列垂直对齐方式。 */
     align: 'stretch' | 'start' | 'center' | 'end';
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/layout/row.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"row.d.ts","sourceRoot":"","sources":["../../../src/components/layout/row.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,QAAS,SAAQ,YAAY;IACZ,MAAM,SAAM;IACU,MAAM,SAAM;IAClC,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,eAAe,GAAG,cAAc,CACxF;IACkB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAa;IAEtF,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqBpB;IAEF,MAAM;CA8BP"}
+{"version":3,"file":"row.d.ts","sourceRoot":"","sources":["../../../src/components/layout/row.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;GAYG;AACH,qBACa,QAAS,SAAQ,YAAY;IACxC,wCAAwC;IACZ,MAAM,SAAM;IACxC,oDAAoD;IACF,MAAM,SAAM;IAC9D,gDAAgD;IACpB,OAAO,EAC/B,OAAO,GACP,QAAQ,GACR,KAAK,GACL,eAAe,GACf,cAAc,CAAW;IAC7B,8CAA8C;IAClB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAa;IAEtF,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqBpB;IAEF,MAAM;CA8BP"}

package/dist/components/layout/space.d.ts

@@ -1,11 +1,25 @@
 import { AitheElement } from '../../core/aithe-element';
 /**
- * Equal spacing helper.
+ * Equal spacing helper for consistent gaps between child elements.
+ * 等间距辅助组件，为子元素提供统一间距。
+ *
+ * @slot - Default slot for spaced child elements. 需要间距的子元素内容。
+ * @example
+ * ```html
+ * <aithe-space size="var(--aithe-space-md)" direction="horizontal" wrap>
+ *   <aithe-button>Save</aithe-button>
+ *   <aithe-button>Cancel</aithe-button>
+ * </aithe-space>
+ * ```
  */
 export declare class AitheSpace extends AitheElement {
+    /** Gap size between items (CSS value). 子元素间距大小（CSS 值）。 */
     size: string;
+    /** Spacing direction. 间距方向。 */
     direction: 'vertical' | 'horizontal';
+    /** Cross-axis alignment. 交叉轴对齐方式。 */
     align: string;
+    /** Whether items wrap when overflowing. 子元素溢出时是否换行。 */
     wrap: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/layout/space.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"space.d.ts","sourceRoot":"","sources":["../../../src/components/layout/space.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD;;GAEG;AACH,qBACa,UAAW,SAAQ,YAAY;IACd,IAAI,SAA2B;IAC/B,SAAS,EAAE,UAAU,GAAG,YAAY,CAAc;IAClD,KAAK,SAAa;IACF,IAAI,UAAS;IAEzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAapB;IAEF,MAAM;CAkBP"}
+{"version":3,"file":"space.d.ts","sourceRoot":"","sources":["../../../src/components/layout/space.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;GAYG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,0DAA0D;IAC9B,IAAI,SAA2B;IAC3D,+BAA+B;IACH,SAAS,EAAE,UAAU,GAAG,YAAY,CAAc;IAC9E,qCAAqC;IACT,KAAK,SAAa;IAC9C,uDAAuD;IACX,IAAI,UAAS;IAEzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAapB;IAEF,MAAM;CAkBP"}

package/dist/components/navigation/AGENTS.md

@@ -0,0 +1,26 @@
+# src/components/navigation/ — 导航组件（7个）
+
+## 组件列表
+
+| 组件                 | 标签                      | 说明                    |
+| -------------------- | ------------------------- | ----------------------- |
+| `menu.ts`            | `<aithe-menu>`            | 导航菜单，垂直/水平模式 |
+| `menu-item.ts`       | `<aithe-menu-item>`       | 叶子导航项              |
+| `sub-menu.ts`        | `<aithe-sub-menu>`        | 子菜单，可展开嵌套      |
+| `breadcrumb.ts`      | `<aithe-breadcrumb>`      | 面包屑，页面层级导航    |
+| `breadcrumb-item.ts` | `<aithe-breadcrumb-item>` | 单个面包屑链接          |
+| `steps.ts`           | `<aithe-steps>`           | 步骤条，流程步骤可视化  |
+| `back-top.ts`        | `<aithe-back-top>`        | 回到顶部按钮            |
+
+## 编码规范
+
+- 继承 `AitheElement`，使用 `@customElement` 装饰器
+- 菜单组件支持递归嵌套（menu > sub-menu > menu-item）
+- 导入使用 `@components/navigation/xxx` 路径别名
+- 中英文双语 JSDoc 注释
+
+## 关键约定
+
+- `aithe-menu` 通过 `mode` 属性切换垂直/水平布局
+- `aithe-steps` 通过 `current` 属性控制当前步骤
+- 新增组件需同步更新 `src/index.ts` 和 `docs/api/navigation/`

package/dist/components/navigation/back-top.d.ts

@@ -1,9 +1,18 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Back to top floating action button.
+ * Back to top floating action button that appears after scrolling past a threshold.
+ * 回到顶部浮动按钮，滚动超过阈值后出现。
+ *
+ * @slot - Default slot for custom button content (overrides default arrow). 自定义按钮内容（覆盖默认箭头）。
+ * @example
+ * ```html
+ * <aithe-back-top visibility-height="300" target="#scroll-container"></aithe-back-top>
+ * ```
  */
 export declare class AitheBackTop extends AitheElement {
+    /** CSS selector for the scroll container (defaults to window). 滚动容器的 CSS 选择器（默认为 window）。 */
     target: string;
+    /** Scroll threshold in pixels before the button appears. 按钮出现前的滚动阈值（像素）。 */
     visibilityHeight: number;
     private visible;
     private scrollTarget;
@@ -14,8 +23,8 @@ export declare class AitheBackTop extends AitheElement {
     private resolveTarget;
     private bindTarget;
     private unbindTarget;
-    private handleScroll;
-    private scrollToTop;
+    private readonly handleScroll;
+    private readonly scrollToTop;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=back-top.d.ts.map

package/dist/components/navigation/back-top.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"back-top.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/back-top.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,YAAa,SAAQ,YAAY;IAChB,MAAM,SAAM;IACoB,gBAAgB,SAAO;IAE1E,OAAO,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,YAAY,CAAqC;IAEzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwBpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAOtD,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,YAAY,CAMlB;IAEF,OAAO,CAAC,WAAW,CAOjB;IAEF,MAAM;CASP"}
+{"version":3,"file":"back-top.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/back-top.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;GASG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,6FAA6F;IACjE,MAAM,SAAM;IACxC,4EAA4E;IAChB,gBAAgB,SAAO;IAE1E,OAAO,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,YAAY,CAAqC;IAEzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwBpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAOtD,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAM3B;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAO1B;IAEF,MAAM;CAaP"}

package/dist/components/navigation/breadcrumb-item.d.ts

@@ -1,9 +1,24 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Single breadcrumb link or text item for use inside `aithe-breadcrumb`.
+ * 单个面包屑链接或文本项，用于 aithe-breadcrumb 内部。
+ *
+ * @slot - Default slot for breadcrumb item label text. 面包屑项标签文本。
+ * @example
+ * ```html
+ * <aithe-breadcrumb-item href="/settings" target="_self">Settings</aithe-breadcrumb-item>
+ * ```
+ */
 export declare class AitheBreadcrumbItem extends AitheElement {
+    /** Link URL for navigable breadcrumb items. 可导航面包屑项的链接地址。 */
     href: string;
+    /** Link target attribute. 链接 target 属性。 */
     target: string;
+    /** Whether the breadcrumb item is disabled. 是否禁用面包屑项。 */
     disabled: boolean;
+    /** Whether this is the current (last) breadcrumb item. 是否为当前（最后一个）面包屑项。 */
     current: boolean;
+    /** Separator character (inherited from parent `aithe-breadcrumb`). 分隔符（从父级 aithe-breadcrumb 继承）。 */
     separator: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/navigation/breadcrumb-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumb-item.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/breadcrumb-item.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,qBACa,mBAAoB,SAAQ,YAAY;IACvB,IAAI,SAAM;IACV,MAAM,SAAM;IACI,QAAQ,UAAS;IACjB,OAAO,UAAS;IAChC,SAAS,SAAO;IAE5C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAgCpB;IAEF,MAAM;CAgBP"}
+{"version":3,"file":"breadcrumb-item.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/breadcrumb-item.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;GASG;AACH,qBACa,mBAAoB,SAAQ,YAAY;IACnD,6DAA6D;IACjC,IAAI,SAAM;IACtC,2CAA2C;IACf,MAAM,SAAM;IACxC,yDAAyD;IACb,QAAQ,UAAS;IAC7D,2EAA2E;IAC/B,OAAO,UAAS;IAC5D,oGAAoG;IACxE,SAAS,SAAO;IAE5C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAgCpB;IAEF,MAAM;CAuBP"}

package/dist/components/navigation/breadcrumb.d.ts

@@ -1,9 +1,24 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Breadcrumb navigation container for showing page hierarchy.
+ * 面包屑导航容器，用于展示页面层级关系。
+ *
+ * @slot - Default slot for `aithe-breadcrumb-item` elements. aithe-breadcrumb-item 元素。
+ * @example
+ * ```html
+ * <aithe-breadcrumb separator="/">
+ *   <aithe-breadcrumb-item href="/home">Home</aithe-breadcrumb-item>
+ *   <aithe-breadcrumb-item href="/products">Products</aithe-breadcrumb-item>
+ *   <aithe-breadcrumb-item>Detail</aithe-breadcrumb-item>
+ * </aithe-breadcrumb>
+ * ```
+ */
 export declare class AitheBreadcrumb extends AitheElement {
+    /** Separator character between breadcrumb items. 面包屑项之间的分隔符。 */
     separator: string;
-    private items;
+    private readonly items;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private syncItems;
+    private readonly syncItems;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=breadcrumb.d.ts.map

package/dist/components/navigation/breadcrumb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/breadcrumb.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD,qBACa,eAAgB,SAAQ,YAAY;IACnB,SAAS,SAAO;IAEnB,OAAO,CAAC,KAAK,CAAa;IAEnD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAapB;IAEF,OAAO,CAAC,SAAS,CAUf;IAEF,MAAM;CAOP"}
+{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/breadcrumb.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;GAaG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,gEAAgE;IACpC,SAAS,SAAO;IAEnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IAE5D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAapB;IAEF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAUxB;IAEF,MAAM;CAOP"}

package/dist/components/navigation/dropdown.d.ts

@@ -0,0 +1,56 @@
+import type { PropertyValues } from 'lit';
+import { AitheAnchoredOverlayElement } from '../../core/anchored-overlay';
+import type { AitheTreeNodeMeta } from '../../core/types';
+/**
+ * Dropdown menu with nested submenus, keyboard navigation, and hover/click triggers.
+ * Internally uses `<aithe-tree-menu>` for menu rendering.
+ * 下拉菜单，支持嵌套子菜单、键盘导航和悬停/点击触发。内部使用 `<aithe-tree-menu>` 渲染菜单。
+ *
+ * @slot - Default slot for the trigger element. 触发元素内容。
+ * @fires aithe-select - Emitted when a menu item is selected, with `{ item, path, id }`. 菜单项选中时触发。
+ * @fires aithe-open-change - Emitted when open state changes, with `{ open }`. 开关状态变更时触发。
+ * @example
+ * ```html
+ * <aithe-dropdown trigger="click" items='[{"id":"a","label":"Action"},{"id":"b","label":"Another"}]'>
+ *   <button>Menu</button>
+ * </aithe-dropdown>
+ * ```
+ */
+export declare class AitheDropdown extends AitheAnchoredOverlayElement {
+    /** Trigger mode: click or hover. 触发方式：点击或悬停。 */
+    trigger: 'click' | 'hover';
+    /** Display title for the dropdown trigger (shown as tooltip). 下拉菜单触发器的显示标题（作为工具提示）。 */
+    title: string;
+    /** Icon name to display before the trigger slot content. 在触发器插槽内容前显示的图标名称。 */
+    icon: string;
+    /** JSON string of dropdown menu items. 下拉菜单项的 JSON 字符串。 */
+    itemsJson: string;
+    /** Array of dropdown menu item objects. 下拉菜单项对象数组。 */
+    items: readonly AitheTreeNodeMeta[];
+    /** Dropdown panel placement. 下拉面板位置。 */
+    placement: 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+    private readonly panel?;
+    private activeId;
+    protected willUpdate(changed: PropertyValues<this>): void;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    protected get panelElement(): HTMLElement | null;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(changed: PropertyValues<this>): void;
+    /** Closes dropdown on outside pointer events. 点击外部时关闭下拉菜单。 */
+    private readonly handleOutsidePointer;
+    /** Closes dropdown on Escape key. 按 Escape 键关闭下拉菜单。 */
+    private readonly handleDocumentKeydown;
+    /** Toggles dropdown open state (click trigger only). 切换下拉菜单开关状态（仅点击触发）。 */
+    private readonly toggleOpen;
+    /** Opens dropdown on hover (hover trigger only). 悬停时打开下拉菜单（仅悬停触发）。 */
+    private readonly openOnHover;
+    /** Closes dropdown on hover end (hover trigger only). 悬停结束时关闭下拉菜单（仅悬停触发）。 */
+    private readonly closeOnHoverEnd;
+    /** Handles item selection from the tree-menu and emits aithe-select. 处理 tree-menu 的选中事件并触发 aithe-select。 */
+    private readonly handleTreeSelect;
+    /** Recursively finds an item by id. 递归查找指定 id 的菜单项。 */
+    private findItemById;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=dropdown.d.ts.map

package/dist/components/navigation/dropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dropdown.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/dropdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAI1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD;;;;;;;;;;;;;;GAcG;AACH,qBACa,aAAc,SAAQ,2BAA2B;IAC5D,gDAAgD;IACpB,OAAO,EAAE,OAAO,GAAG,OAAO,CAAW;IACjE,uFAAuF;IAC3D,KAAK,SAAM;IACvC,8EAA8E;IAClD,IAAI,SAAM;IACtC,2DAA2D;IACX,SAAS,SAAM;IAC/D,sDAAsD;IACtB,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAM;IACzE,wCAAwC;IACZ,SAAS,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAC7E;IAEA,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;IAE7C,OAAO,CAAC,QAAQ,CAAM;IAE/B,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAUzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA+BpB;IAEF,SAAS,KAAK,YAAY,IAAI,WAAW,GAAG,IAAI,CAE/C;IAED,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAM5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAYtD,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAQnC;IAEF,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAIzB;IAEF,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI1B;IAEF,6EAA6E;IAC7E,OAAO,CAAC,QAAQ,CAAC,eAAe,CAI9B;IAEF,4GAA4G;IAC5G,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAO/B;IAEF,uDAAuD;IACvD,OAAO,CAAC,YAAY;IAcpB,MAAM;CAkCP"}

package/dist/components/navigation/menu-item.d.ts

@@ -1,16 +1,39 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Leaf item for `aithe-menu`.
+ * Leaf navigation item for `aithe-menu`.
+ * aithe-menu 的叶子导航项。
+ *
+ * Supports collapsed mode: when `collapsed` is true, the item hides its label
+ * and displays only the icon, suitable for sidebar collapse scenarios.
+ * 支持折叠模式：当 collapsed 为 true 时，隐藏文字标签仅显示图标，适用于侧边栏折叠场景。
+ *
+ * @slot - Default slot for menu item label content. 菜单项标签内容。
+ * @fires aithe-menu-select - Emitted when the item is clicked. 菜单项点击时触发。
+ * @example
+ * ```html
+ * <aithe-menu-item name="dashboard" title="Dashboard" icon="home" disabled>Dashboard</aithe-menu-item>
+ * ```
  */
 export declare class AitheMenuItem extends AitheElement {
+    /** Unique key identifying this menu item. 菜单项唯一标识键。 */
     name: string;
+    /** Display title for the menu item (shown as tooltip). 菜单项的显示标题（作为工具提示）。 */
+    title: string;
+    /** Icon name to display before the label. 在标签前显示的图标名称。 */
+    icon: string;
+    /** Whether the menu item is disabled. 是否禁用菜单项。 */
     disabled: boolean;
+    /** Whether the menu item is currently active (selected). 是否当前选中。 */
     active: boolean;
+    /** Inherited menu mode from parent `aithe-menu`. 从父级 aithe-menu 继承的菜单模式。 */
     menuMode: 'horizontal' | 'vertical';
+    /** Inherited collapsed state from parent `aithe-menu`. When true, hides the label and displays only the icon. 从父级 aithe-menu 继承的折叠状态。为 true 时隐藏文字标签仅显示图标。 */
     collapsed: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private select;
-    private handleKeydown;
+    connectedCallback(): void;
+    protected updated(changed: Map<string, unknown>): void;
+    private readonly select;
+    private readonly handleKeydown;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=menu-item.d.ts.map

package/dist/components/navigation/menu-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu-item.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/menu-item.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,aAAc,SAAQ,YAAY;IACjB,IAAI,SAAM;IACM,QAAQ,UAAS;IACjB,MAAM,UAAS;IAC3B,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAc;IACjD,SAAS,UAAS;IAElD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA0CpB;IAEF,OAAO,CAAC,MAAM,CAMZ;IAEF,OAAO,CAAC,aAAa,CAOnB;IAEF,MAAM;CAiBP"}
+{"version":3,"file":"menu-item.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/menu-item.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;;GAcG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,uDAAuD;IAC3B,IAAI,SAAM;IACtC,4EAA4E;IAChD,KAAK,SAAM;IACvC,0DAA0D;IAC9B,IAAI,SAAM;IACtC,kDAAkD;IACN,QAAQ,UAAS;IAC7D,oEAAoE;IACxB,MAAM,UAAS;IAC3D,4EAA4E;IAC5C,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAc;IACjF,6JAA6J;IAC7H,SAAS,UAAS;IAElD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyDpB;IAEF,iBAAiB,IAAI,IAAI;IAOzB,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAO5B;IAEF,MAAM;CAwBP"}

package/dist/components/navigation/menu.d.ts

@@ -1,18 +1,35 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Cross-framework navigation menu.
+ * Cross-framework navigation menu with vertical and horizontal modes.
+ * 跨框架导航菜单，支持垂直和水平模式。
+ *
+ * @slot - Default slot for `aithe-menu-item` and `aithe-sub-menu` elements. aithe-menu-item 和 aithe-sub-menu 元素。
+ * @fires aithe-select - Emitted when a menu item is selected. 菜单项选中时触发。
+ * @example
+ * ```html
+ * <aithe-menu mode="vertical" active="home">
+ *   <aithe-menu-item name="home">Home</aithe-menu-item>
+ *   <aithe-sub-menu title="Settings">
+ *     <aithe-menu-item name="profile">Profile</aithe-menu-item>
+ *   </aithe-sub-menu>
+ * </aithe-menu>
+ * ```
  */
 export declare class AitheMenu extends AitheElement {
+    /** Menu layout mode. 菜单布局模式。 */
     mode: 'horizontal' | 'vertical';
+    /** Active (selected) menu item key. 当前选中的菜单项键。 */
     active: string;
+    /** Whether the menu is in collapsed state. 菜单是否处于折叠状态。 */
     collapsed: boolean;
+    /** Whether menu items can be selected. 菜单项是否可选中。 */
     selectable: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected updated(changed: Map<string, unknown>): void;
-    private syncChildren;
-    private handleSelect;
+    private readonly syncChildren;
+    private readonly handleSelect;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=menu.d.ts.map

package/dist/components/navigation/menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/menu.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAKxD;;GAEG;AACH,qBACa,SAAU,SAAQ,YAAY;IACb,IAAI,EAAE,YAAY,GAAG,UAAU,CAAc;IAC7C,MAAM,SAAM;IACX,SAAS,UAAS;IAClB,UAAU,UAAQ;IAE/C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAmBpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,CAAC,YAAY,CAqBlB;IAEF,OAAO,CAAC,YAAY,CAWlB;IAEF,MAAM;CAGP"}
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/menu.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKnD;;;;;;;;;;;;;;;GAeG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,gCAAgC;IACJ,IAAI,EAAE,YAAY,GAAG,UAAU,CAAc;IACzE,kDAAkD;IACtB,MAAM,SAAM;IACxC,0DAA0D;IAC7B,SAAS,UAAS;IAC/C,oDAAoD;IACvB,UAAU,UAAQ;IAE/C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAmBpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAqB3B;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAW3B;IAEF,MAAM;CAOP"}

package/dist/components/navigation/steps.d.ts

@@ -1,14 +1,31 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Stepper component with JSON-driven items.
+ * Stepper component with JSON-driven items for process flow visualization.
+ * 步骤条组件，支持 JSON 驱动的步骤项，用于流程可视化。
+ *
+ * @example
+ * ```html
+ * <aithe-steps current="1" direction="horizontal" items='["Step 1","Step 2","Step 3"]'></aithe-steps>
+ * <aithe-steps current="2" items='[{"title":"Account","description":"Create account"},{"title":"Profile","description":"Fill info"}]'></aithe-steps>
+ * ```
  */
 export declare class AitheSteps extends AitheElement {
+    /** Current active step index (0-based). 当前活动步骤索引（从 0 开始）。 */
     current: number;
+    /** Step size preset. 步骤尺寸预设。 */
     size: 'sm' | 'md' | 'lg';
+    /** Steps layout direction. 步骤布局方向。 */
     direction: 'horizontal' | 'vertical';
+    /** JSON string or comma-separated list of step items. 步骤项的 JSON 字符串或逗号分隔列表。 */
     items: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     private get parsedItems();
+    /**
+     * Get the state of a step item based on its index.
+     * @param index - The index of the step item
+     * @returns The state of the step: 'done', 'active', or 'pending'
+     */
+    private getStepState;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=steps.d.ts.map

package/dist/components/navigation/steps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/steps.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAQxD;;GAEG;AACH,qBACa,UAAW,SAAQ,YAAY;IACd,OAAO,SAAK;IACZ,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAChC,SAAS,EAAE,YAAY,GAAG,UAAU,CAAgB;IACpD,KAAK,SAAQ;IAEzC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA0EpB;IAEF,OAAO,KAAK,WAAW,GAWtB;IAED,MAAM;CAoBP"}
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/steps.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQnD;;;;;;;;;GASG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,6DAA6D;IACjC,OAAO,SAAK;IACxC,gCAAgC;IACJ,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAC5D,sCAAsC;IACV,SAAS,EAAE,YAAY,GAAG,UAAU,CAAgB;IAChF,+EAA+E;IACnD,KAAK,SAAQ;IAEzC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAgFpB;IAEF,OAAO,KAAK,WAAW,GAWtB;IAED;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAUpB,MAAM;CAwBP"}