@aithe/aithe-ui 26.2.2 → 26.3.1

package/dist/components/layout/flex.js

@@ -0,0 +1,100 @@
+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 { styleMap } from 'lit/directives/style-map.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles } from '../../core/styles';
+import { normalizeCssUnit } from '../../utils';
+/**
+ * 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>
+ * ```
+ */
+let AitheFlex = class AitheFlex extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /** Flex justify-content value. flex justify-content 值。 */
+        this.justify = 'flex-start';
+        /** Flex align-items value. flex align-items 值。 */
+        this.align = 'stretch';
+        /** Flex direction. flex 方向。 */
+        this.direction = 'row';
+        /** Gap between flex items (CSS value). flex 子元素间距（CSS 值）。 */
+        this.gap = 'var(--aithe-space-md)';
+        /** Flex wrap behavior. flex 换行方式。 */
+        this.wrap = 'nowrap';
+        /** Whether the flex container is inline. 是否为内联弹性容器。 */
+        this.inline = false;
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        display: block;
+        min-width: 0;
+      }
+
+      .wrap {
+        min-width: 0;
+        width: 100%;
+      }
+
+      :host([inline]) .wrap {
+        width: auto;
+      }
+    `,
+    ]; }
+    render() {
+        const gap = normalizeCssUnit(this.gap, 'var(--aithe-space-md)');
+        return html `
+      <div
+        class="wrap"
+        style=${styleMap({
+            alignItems: this.align,
+            display: this.inline ? 'inline-flex' : 'flex',
+            flexDirection: this.direction,
+            flexWrap: this.wrap,
+            gap,
+            justifyContent: this.justify,
+        })}
+      >
+        <slot></slot>
+      </div>
+    `;
+    }
+};
+__decorate([
+    property({ type: String })
+], AitheFlex.prototype, "justify", void 0);
+__decorate([
+    property({ type: String })
+], AitheFlex.prototype, "align", void 0);
+__decorate([
+    property({ type: String })
+], AitheFlex.prototype, "direction", void 0);
+__decorate([
+    property({ type: String })
+], AitheFlex.prototype, "gap", void 0);
+__decorate([
+    property({ type: String })
+], AitheFlex.prototype, "wrap", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheFlex.prototype, "inline", void 0);
+AitheFlex = __decorate([
+    customElement('aithe-flex')
+], AitheFlex);
+export { AitheFlex };

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

@@ -0,0 +1,103 @@
+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 { styleMap } from 'lit/directives/style-map.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles } from '../../core/styles';
+/**
+ * 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>
+ * ```
+ */
+let AitheRow = class AitheRow extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /** Column gutter in pixels. 列间距（像素）。 */
+        this.gutter = 24;
+        /** Vertical gap between rows in pixels. 行间距（像素）。 */
+        this.rowGap = 24;
+        /** Horizontal alignment of columns. 列水平对齐方式。 */
+        this.justify = 'start';
+        /** Vertical alignment of columns. 列垂直对齐方式。 */
+        this.align = 'stretch';
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        display: block;
+        min-width: 0;
+      }
+
+      .row {
+        display: flex;
+        flex-wrap: wrap;
+        min-width: 0;
+        width: calc(100% + var(--aithe-row-gutter, 24px));
+        margin-inline: calc(var(--aithe-row-gutter, 24px) / -2);
+      }
+
+      ::slotted(aithe-col) {
+        min-width: 0;
+        padding-inline: calc(var(--aithe-row-gutter, 24px) / 2);
+      }
+    `,
+    ]; }
+    render() {
+        const justifyMap = {
+            start: 'flex-start',
+            center: 'center',
+            end: 'flex-end',
+            'space-between': 'space-between',
+            'space-around': 'space-around',
+        };
+        const alignMap = {
+            stretch: 'stretch',
+            start: 'flex-start',
+            center: 'center',
+            end: 'flex-end',
+        };
+        return html `
+      <div
+        class="row"
+        style=${styleMap({
+            '--aithe-row-gutter': `${this.gutter}px`,
+            alignItems: alignMap[this.align],
+            justifyContent: justifyMap[this.justify],
+            rowGap: `${this.rowGap}px`,
+        })}
+      >
+        <slot></slot>
+      </div>
+    `;
+    }
+};
+__decorate([
+    property({ type: Number })
+], AitheRow.prototype, "gutter", void 0);
+__decorate([
+    property({ type: Number, attribute: 'row-gap' })
+], AitheRow.prototype, "rowGap", void 0);
+__decorate([
+    property({ type: String })
+], AitheRow.prototype, "justify", void 0);
+__decorate([
+    property({ type: String })
+], AitheRow.prototype, "align", void 0);
+AitheRow = __decorate([
+    customElement('aithe-row')
+], AitheRow);
+export { AitheRow };

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/layout/space.js

@@ -0,0 +1,85 @@
+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 { styleMap } from 'lit/directives/style-map.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles } from '../../core/styles';
+import { normalizeCssUnit } from '../../utils';
+/**
+ * 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>
+ * ```
+ */
+let AitheSpace = class AitheSpace extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /** Gap size between items (CSS value). 子元素间距大小（CSS 值）。 */
+        this.size = 'var(--aithe-space-md)';
+        /** Spacing direction. 间距方向。 */
+        this.direction = 'vertical';
+        /** Cross-axis alignment. 交叉轴对齐方式。 */
+        this.align = 'stretch';
+        /** Whether items wrap when overflowing. 子元素溢出时是否换行。 */
+        this.wrap = false;
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        display: block;
+        min-width: 0;
+      }
+
+      .wrap {
+        min-width: 0;
+        width: 100%;
+      }
+    `,
+    ]; }
+    render() {
+        const gap = normalizeCssUnit(this.size, 'var(--aithe-space-md)');
+        return html `
+      <div
+        class="wrap"
+        style=${styleMap({
+            alignItems: this.align,
+            display: 'flex',
+            flexDirection: this.direction === 'vertical' ? 'column' : 'row',
+            flexWrap: this.wrap ? 'wrap' : 'nowrap',
+            gap,
+        })}
+      >
+        <slot></slot>
+      </div>
+    `;
+    }
+};
+__decorate([
+    property({ type: String })
+], AitheSpace.prototype, "size", void 0);
+__decorate([
+    property({ type: String })
+], AitheSpace.prototype, "direction", void 0);
+__decorate([
+    property({ type: String })
+], AitheSpace.prototype, "align", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheSpace.prototype, "wrap", void 0);
+AitheSpace = __decorate([
+    customElement('aithe-space')
+], AitheSpace);
+export { AitheSpace };

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/back-top.js

@@ -0,0 +1,127 @@
+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, state } from 'lit/decorators.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles } from '../../core/styles';
+import { t } from '../../styles/i18n';
+/**
+ * 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>
+ * ```
+ */
+let AitheBackTop = class AitheBackTop extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /** CSS selector for the scroll container (defaults to window). 滚动容器的 CSS 选择器（默认为 window）。 */
+        this.target = '';
+        /** Scroll threshold in pixels before the button appears. 按钮出现前的滚动阈值（像素）。 */
+        this.visibilityHeight = 260;
+        this.visible = false;
+        this.scrollTarget = null;
+        this.handleScroll = () => {
+            const top = this.scrollTarget instanceof Window
+                ? globalThis.scrollY
+                : this.scrollTarget.scrollTop;
+            this.visible = top >= this.visibilityHeight;
+        };
+        this.scrollToTop = () => {
+            if (this.scrollTarget instanceof Window) {
+                globalThis.scrollTo({ top: 0, behavior: 'smooth' });
+                return;
+            }
+            this.scrollTarget.scrollTo({ top: 0, behavior: 'smooth' });
+        };
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        position: fixed;
+        right: 28px;
+        bottom: 28px;
+        z-index: var(--aithe-z-dropdown);
+      }
+
+      button {
+        display: inline-flex;
+        align-items: center;
+        justify-content: center;
+        width: 44px;
+        height: 44px;
+        border: 1px solid var(--aithe-color-border);
+        border-radius: 50%;
+        background: var(--aithe-color-surface-elevated);
+        color: var(--aithe-color-text);
+        box-shadow: var(--aithe-shadow-2);
+        cursor: pointer;
+      }
+    `,
+    ]; }
+    connectedCallback() {
+        super.connectedCallback();
+        this.bindTarget();
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.unbindTarget();
+    }
+    updated(changed) {
+        if (changed.has('target')) {
+            this.unbindTarget();
+            this.bindTarget();
+        }
+    }
+    resolveTarget() {
+        const root = this.getRootNode();
+        const shadowTarget = root instanceof ShadowRoot && this.target
+            ? root.querySelector(this.target)
+            : null;
+        const target = shadowTarget ?? (this.target ? document.querySelector(this.target) : null);
+        return target ?? globalThis.window;
+    }
+    bindTarget() {
+        this.scrollTarget = this.resolveTarget();
+        this.scrollTarget.addEventListener('scroll', this.handleScroll, { passive: true });
+        this.handleScroll();
+    }
+    unbindTarget() {
+        this.scrollTarget?.removeEventListener('scroll', this.handleScroll);
+        this.scrollTarget = null;
+    }
+    render() {
+        return this.visible
+            ? html `
+          <button
+            type="button"
+            aria-label=${t('navigation.backTop.ariaLabel')}
+            @click=${this.scrollToTop}
+          >
+            ↑
+          </button>
+        `
+            : html ``;
+    }
+};
+__decorate([
+    property({ type: String })
+], AitheBackTop.prototype, "target", void 0);
+__decorate([
+    property({ type: Number, attribute: 'visibility-height' })
+], AitheBackTop.prototype, "visibilityHeight", void 0);
+__decorate([
+    state()
+], AitheBackTop.prototype, "visible", void 0);
+AitheBackTop = __decorate([
+    customElement('aithe-back-top')
+], AitheBackTop);
+export { AitheBackTop };

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