@aithe/aithe-ui 26.2.2

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

@@ -0,0 +1,30 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * 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;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(changed: Map<string, unknown>): void;
+    private resolveTarget;
+    private bindTarget;
+    private unbindTarget;
+    private readonly handleScroll;
+    private readonly scrollToTop;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=back-top.d.ts.map

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

@@ -0,0 +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;AAIxD;;;;;;;;;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/src/components/navigation/breadcrumb-item.d.ts

@@ -0,0 +1,26 @@
+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>;
+}
+//# sourceMappingURL=breadcrumb-item.d.ts.map

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

@@ -0,0 +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;;;;;;;;;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/src/components/navigation/breadcrumb.d.ts

@@ -0,0 +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;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private readonly syncItems;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=breadcrumb.d.ts.map

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

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

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

@@ -0,0 +1,70 @@
+import type { PropertyValues, TemplateResult } from 'lit';
+import { AitheAnchoredOverlayElement } from '../../core/anchored-overlay';
+import type { AitheDropdownItem } from '../../core/types';
+/**
+ * Dropdown menu with nested submenus, keyboard navigation, and hover/click triggers.
+ * 下拉菜单，支持嵌套子菜单、键盘导航和悬停/点击触发。
+ *
+ * @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 AitheDropdownItem[];
+    /** Dropdown panel placement. 下拉面板位置。 */
+    placement: 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+    private panel?;
+    private openMap;
+    private submenuDirection;
+    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;
+    /** Focuses the first non-disabled menu item. 聚焦第一个非禁用菜单项。 */
+    private focusFirstMenuItem;
+    /** 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;
+    /** Opens a submenu at the given path and determines direction. 在指定路径打开子菜单并确定方向。 */
+    private setSubmenu;
+    /** Closes all submenus deeper than the given level. 关闭比给定层级更深的子菜单。 */
+    private closeDeeperSubmenus;
+    /** Handles leaf item selection and emits select event. 处理叶子项选中并触发 select 事件。 */
+    private handleItemSelect;
+    /** Returns visible sibling menu items for keyboard navigation. 返回可见的同级菜单项用于键盘导航。 */
+    private getVisibleSiblingItems;
+    /** Moves focus by delta offset within sibling items. 在同级项中按偏移量移动焦点。 */
+    private moveFocus;
+    /** Focuses the first item in a submenu. 聚焦子菜单中的第一个项。 */
+    private focusSubmenu;
+    /** Handles keyboard navigation within the menu. 处理菜单内的键盘导航。 */
+    private readonly handleMenuKeydown;
+    /** Renders a single menu item or divider. 渲染单个菜单项或分割线。 */
+    private renderItem;
+    render(): TemplateResult<1>;
+}
+//# sourceMappingURL=dropdown.d.ts.map

package/dist/src/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,cAAc,EAAE,MAAM,KAAK,CAAC;AAK1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D;;;;;;;;;;;;;GAaG;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,KAAK,CAAC,CAAc;IAEpC,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,gBAAgB,CAAwC;IAEzE,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAUzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAkIpB;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;IActD,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAQnC;IAEF,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,6DAA6D;IAC7D,OAAO,CAAC,kBAAkB;IAK1B,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,CAK9B;IAEF,mFAAmF;IACnF,OAAO,CAAC,UAAU;IAkBlB,sEAAsE;IACtE,OAAO,CAAC,mBAAmB;IAM3B,gFAAgF;IAChF,OAAO,CAAC,gBAAgB;IAcxB,oFAAoF;IACpF,OAAO,CAAC,sBAAsB;IAW9B,uEAAuE;IACvE,OAAO,CAAC,SAAS;IAWjB,wDAAwD;IACxD,OAAO,CAAC,YAAY;IASpB,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAwChC;IAEF,0DAA0D;IAC1D,OAAO,CAAC,UAAU;IA+ElB,MAAM;CAgCP"}

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

@@ -0,0 +1,33 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Leaf navigation item for `aithe-menu`.
+ * aithe-menu 的叶子导航项。
+ *
+ * @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`. 从父级 aithe-menu 继承的折叠状态。 */
+    collapsed: boolean;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private readonly select;
+    private readonly handleKeydown;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=menu-item.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;GAUG;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,kFAAkF;IAClD,SAAS,UAAS;IAElD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA+CpB;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAO5B;IAEF,MAAM;CAuBP"}

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

@@ -0,0 +1,35 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * 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 readonly syncChildren;
+    private readonly handleSelect;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=menu.d.ts.map

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

@@ -0,0 +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;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/src/components/navigation/steps.d.ts

@@ -0,0 +1,31 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * 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/src/components/navigation/steps.d.ts.map

@@ -0,0 +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;;;;;;;;;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"}

package/dist/src/components/navigation/sub-menu.d.ts

@@ -0,0 +1,37 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Nested branch (sub-menu) item for `aithe-menu` with expandable children.
+ * aithe-menu 的嵌套分支（子菜单）项，支持展开子项。
+ *
+ * @slot - Default slot for nested `aithe-menu-item` elements. 嵌套的 aithe-menu-item 元素。
+ * @example
+ * ```html
+ * <aithe-sub-menu title="Settings" name="settings" icon="settings">
+ *   <aithe-menu-item name="profile">Profile</aithe-menu-item>
+ *   <aithe-menu-item name="security">Security</aithe-menu-item>
+ * </aithe-sub-menu>
+ * ```
+ */
+export declare class AitheSubMenu extends AitheElement {
+    /** Unique key identifying this sub-menu. 子菜单唯一标识键。 */
+    name: string;
+    /** Display title for the sub-menu trigger. 子菜单触发器的显示标题。 */
+    title: string;
+    /** Icon name to display before the title. 在标题前显示的图标名称。 */
+    icon: string;
+    /** Whether the sub-menu is disabled. 是否禁用子菜单。 */
+    disabled: boolean;
+    /** Whether the sub-menu is currently expanded. 是否当前展开。 */
+    open: boolean;
+    /** Whether any child item is currently active. 是否有子项当前选中。 */
+    active: boolean;
+    /** Inherited menu mode from parent `aithe-menu`. 从父级 aithe-menu 继承的菜单模式。 */
+    menuMode: 'horizontal' | 'vertical';
+    /** Inherited collapsed state from parent `aithe-menu`. 从父级 aithe-menu 继承的折叠状态。 */
+    collapsed: boolean;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    protected updated(changed: Map<string, unknown>): void;
+    private readonly toggle;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=sub-menu.d.ts.map

package/dist/src/components/navigation/sub-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-menu.d.ts","sourceRoot":"","sources":["../../../../src/components/navigation/sub-menu.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;;;;;;GAYG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,sDAAsD;IAC1B,IAAI,SAAM;IACtC,2DAA2D;IAC/B,KAAK,SAAM;IACvC,0DAA0D;IAC9B,IAAI,SAAM;IACtC,iDAAiD;IACL,QAAQ,UAAS;IAC7D,0DAA0D;IACd,IAAI,UAAS;IACzD,6DAA6D;IAC7B,MAAM,UAAS;IAC/C,4EAA4E;IAC5C,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAc;IACjF,kFAAkF;IAClD,SAAS,UAAS;IAElD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA2EpB;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;IAEF,MAAM;CA2BP"}

package/dist/src/components/navigation/theme-picker.d.ts

@@ -0,0 +1,27 @@
+import { AitheElement } from '../../base/aithe-element';
+import { type AithePlacement } from '../../core/floating';
+import type { AitheBuiltinTheme } from '../../types';
+export declare class AitheThemePicker extends AitheElement {
+    value: AitheBuiltinTheme | string;
+    placement: AithePlacement;
+    private open;
+    private expandedGroup;
+    private triggerEl?;
+    private overlayEl?;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private readonly handleViewportChange;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(): void;
+    private bindViewport;
+    private unbindViewport;
+    private updatePosition;
+    private handleOutsideClick;
+    private toggleOpen;
+    private toggleGroup;
+    private handleThemeSelect;
+    private renderGroup;
+    private renderThemeItem;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=theme-picker.d.ts.map

package/dist/src/components/navigation/theme-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-picker.d.ts","sourceRoot":"","sources":["../../../../src/components/navigation/theme-picker.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,qBAAqB,CAAC;AAEnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA+CrD,qBACa,gBAAiB,SAAQ,YAAY;IACpB,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAW;IAE5C,SAAS,EAAE,cAAc,CAAgB;IAE5D,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,aAAa,CAAuB;IAElC,OAAO,CAAC,SAAS,CAAC,CAAc;IAChC,OAAO,CAAC,SAAS,CAAC,CAAc;IAEnD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAsLpB;IAEF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA+B;IAEpE,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAM5B,SAAS,CAAC,OAAO,IAAI,IAAI;IAMzB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,kBAAkB,CAMxB;IAEF,OAAO,CAAC,UAAU,CAQhB;IAEF,OAAO,CAAC,WAAW,CAEjB;IAEF,OAAO,CAAC,iBAAiB,CAMvB;IAEF,OAAO,CAAC,WAAW;IA8BnB,OAAO,CAAC,eAAe;IAqBvB,MAAM;CAqBP"}

package/dist/src/components/progress/progress-bar.d.ts

@@ -0,0 +1,21 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Linear progress bar with status colors and optional percentage label.
+ * 线性进度条，支持状态颜色和可选百分比标签。
+ *
+ * @example
+ * ```html
+ * <aithe-progress-bar percent="75" status="success" show-info></aithe-progress-bar>
+ * ```
+ */
+export declare class AitheProgressBar extends AitheElement {
+    /** Current progress percentage (0–100). 当前进度百分比（0–100）。 */
+    percent: number;
+    /** Status color variant. 状态颜色类型。 */
+    status: 'default' | 'success' | 'warning' | 'danger';
+    /** Whether to display the percentage text. 是否显示百分比文本。 */
+    showInfo: boolean;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=progress-bar.d.ts.map

package/dist/src/components/progress/progress-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-bar.d.ts","sourceRoot":"","sources":["../../../../src/components/progress/progress-bar.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;;GAQG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,2DAA2D;IAC/B,OAAO,SAAK;IACxC,oCAAoC;IACR,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAC7F,yDAAyD;IACJ,QAAQ,UAAQ;IAErE,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAsCpB;IAEF,MAAM;CAeP"}

package/dist/src/components/progress/progress-ring.d.ts

@@ -0,0 +1,23 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Circular progress ring indicator with status colors and percentage label.
+ * 圆形进度环指示器，支持状态颜色和百分比标签。
+ *
+ * @example
+ * ```html
+ * <aithe-progress-ring percent="60" size="160" stroke-width="12" status="warning"></aithe-progress-ring>
+ * ```
+ */
+export declare class AitheProgressRing extends AitheElement {
+    /** Current progress percentage (0–100). 当前进度百分比（0–100）。 */
+    percent: number;
+    /** Diameter of the ring in pixels. 环的直径（像素）。 */
+    size: string;
+    /** Stroke width of the ring in pixels. 环的描边宽度（像素）。 */
+    strokeWidth: number;
+    /** Status color variant. 状态颜色类型。 */
+    status: 'default' | 'success' | 'warning' | 'danger';
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    render(): import("lit-html").TemplateResult<2>;
+}
+//# sourceMappingURL=progress-ring.d.ts.map

package/dist/src/components/progress/progress-ring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-ring.d.ts","sourceRoot":"","sources":["../../../../src/components/progress/progress-ring.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;;GAQG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACjD,2DAA2D;IAC/B,OAAO,SAAK;IACxC,gDAAgD;IACpB,IAAI,SAAS;IACzC,sDAAsD;IACC,WAAW,SAAM;IACxE,oCAAoC;IACR,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAE7F,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqCpB;IAEF,MAAM;CA0BP"}

package/dist/src/components/progress/skeleton.d.ts

@@ -0,0 +1,28 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Skeleton placeholder for content loading states with line, circle, and rect shapes.
+ * 骨架屏占位组件，用于内容加载状态，支持线条、圆形和矩形形状。
+ *
+ * @slot - Default slot shown when `active` is false. `active` 为 false 时显示的默认插槽。
+ *
+ * @example
+ * ```html
+ * <aithe-skeleton rows="4" shape="line" animated active></aithe-skeleton>
+ * <aithe-skeleton shape="circle" :active="loading">
+ *   <aithe-avatar src="user.jpg"></aithe-avatar>
+ * </aithe-skeleton>
+ * ```
+ */
+export declare class AitheSkeleton extends AitheElement {
+    /** Number of placeholder rows. 占位行数。 */
+    rows: number;
+    /** Whether rows have a shimmer animation. 行是否具有闪烁动画。 */
+    animated: boolean;
+    /** Shape of each placeholder row. 每行占位的形状。 */
+    shape: 'line' | 'circle' | 'rect';
+    /** Whether the skeleton is active (true = show placeholder, false = show slot content). 骨架屏是否激活（true = 显示占位，false = 显示插槽内容）。 */
+    active: boolean;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=skeleton.d.ts.map

package/dist/src/components/progress/skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton.d.ts","sourceRoot":"","sources":["../../../../src/components/progress/skeleton.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;;;;;;;GAaG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,wCAAwC;IACZ,IAAI,SAAK;IACrC,wDAAwD;IAC3B,QAAQ,UAAQ;IAC7C,8CAA8C;IAClB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAU;IACvE,gIAAgI;IACnG,MAAM,UAAQ;IAE3C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyCpB;IAEF,MAAM;CAgBP"}

package/dist/src/components/progress/spinner.d.ts

@@ -0,0 +1,21 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Generic loading spinner with ring and dots variants.
+ * 通用加载旋转器，支持环形和圆点两种变体。
+ *
+ * @example
+ * ```html
+ * <aithe-spinner size="lg" variant="dots" color="var(--aithe-danger-6)"></aithe-spinner>
+ * ```
+ */
+export declare class AitheSpinner extends AitheElement {
+    /** Size scale of the spinner. 旋转器的尺寸规格。 */
+    size: 'sm' | 'md' | 'lg';
+    /** Custom color for the spinner (CSS value). 旋转器的自定义颜色（CSS 值）。 */
+    color: string;
+    /** Visual variant of the spinner. 旋转器的视觉变体。 */
+    variant: 'ring' | 'dots';
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=spinner.d.ts.map

package/dist/src/components/progress/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../../src/components/progress/spinner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;;GAQG;AACH,qBACa,YAAa,SAAQ,YAAY;IAC5C,2CAA2C;IACf,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAC5D,kEAAkE;IACtC,KAAK,SAA4B;IAC7D,+CAA+C;IACnB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAU;IAE9D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqEpB;IAEF,MAAM;CAgBP"}

package/dist/src/components/theme/locale-switch.d.ts

@@ -0,0 +1,24 @@
+import { AitheElement } from '../../base/aithe-element';
+import { type AithePlacement } from '../../core/floating';
+export declare class AitheLocaleSwitch extends AitheElement {
+    placement: AithePlacement;
+    private open;
+    private currentLocale;
+    private readonly triggerEl?;
+    private readonly overlayEl?;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private readonly handleViewportChange;
+    private unsubscribe?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(): void;
+    private bindViewport;
+    private unbindViewport;
+    private updatePosition;
+    private readonly handleOutsideClick;
+    private readonly toggleOpen;
+    private readonly handleSelect;
+    private getLocaleLabel;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=locale-switch.d.ts.map

package/dist/src/components/theme/locale-switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-switch.d.ts","sourceRoot":"","sources":["../../../../src/components/theme/locale-switch.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,qBAAqB,CAAC;AAkBnF,qBACa,iBAAkB,SAAQ,YAAY;IACrB,SAAS,EAAE,cAAc,CAAgB;IAE5D,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,aAAa,CAAiC;IAE5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IAE5D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqGpB;IAEF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA+B;IAEpE,OAAO,CAAC,WAAW,CAAC,CAAa;IAEjC,iBAAiB,IAAI,IAAI;IAQzB,oBAAoB,IAAI,IAAI;IAO5B,SAAS,CAAC,OAAO,IAAI,IAAI;IAMzB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAKjC;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAOzB;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAI3B;IAEF,OAAO,CAAC,cAAc;IAItB,MAAM;CAyCP"}

package/dist/src/components/theme/theme-picker.d.ts

@@ -0,0 +1,43 @@
+import { AitheElement } from '../../base/aithe-element';
+import { type AithePlacement } from '../../core/floating';
+import type { AitheBuiltinTheme } from '../../types';
+/**
+ * Theme picker dropdown for browsing and selecting built-in Aithe UI themes.
+ * 主题选择器下拉菜单，用于浏览和选择 Aithe UI 内置主题。
+ *
+ * Displays themes grouped by light/dark categories with color dot previews.
+ * 按 Light/Dark 分组展示主题，并带有颜色圆点预览。
+ *
+ * @fires aithe-theme-change - Emitted when a theme is selected. 选择主题时发出，detail 包含 `{ theme: string }`。
+ *
+ * @example
+ * ```html
+ * <aithe-theme-picker value="light" placement="bottom-end"></aithe-theme-picker>
+ * ```
+ */
+export declare class AitheThemePicker extends AitheElement {
+    /** Currently selected theme name. 当前选中的主题名称。 */
+    value: AitheBuiltinTheme | string;
+    /** Placement of the dropdown overlay relative to the trigger. 下拉浮层相对于触发器的弹出位置。 */
+    placement: AithePlacement;
+    private open;
+    private expandedGroup;
+    private triggerEl?;
+    private overlayEl?;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private readonly handleViewportChange;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(): void;
+    private bindViewport;
+    private unbindViewport;
+    private updatePosition;
+    private readonly handleOutsideClick;
+    private readonly toggleOpen;
+    private readonly toggleGroup;
+    private readonly handleThemeSelect;
+    private renderGroup;
+    private renderThemeItem;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=theme-picker.d.ts.map

package/dist/src/components/theme/theme-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-picker.d.ts","sourceRoot":"","sources":["../../../../src/components/theme/theme-picker.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,qBAAqB,CAAC;AAEnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAoErD;;;;;;;;;;;;;GAaG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,gDAAgD;IACpB,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAW;IAExE,kFAAkF;IACtD,SAAS,EAAE,cAAc,CAAgB;IAE5D,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,aAAa,CAAuB;IAElC,OAAO,CAAC,SAAS,CAAC,CAAc;IAChC,OAAO,CAAC,SAAS,CAAC,CAAc;IAEnD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwLpB;IAEF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA+B;IAEpE,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAM5B,SAAS,CAAC,OAAO,IAAI,IAAI;IAMzB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAMjC;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAQzB;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAMhC;IAEF,OAAO,CAAC,WAAW;IAmCnB,OAAO,CAAC,eAAe;IAyBvB,MAAM;CAqBP"}

package/dist/src/components/theme/theme-preview.d.ts

@@ -0,0 +1,29 @@
+import { AitheElement } from '../../base/aithe-element';
+import type { AitheBuiltinTheme } from '../../types';
+/**
+ * Live theme preview panel with an embedded theme picker and sample components.
+ * 实时主题预览面板，内嵌主题选择器和示例组件。
+ *
+ * Renders a mini application layout (sidebar + content area) themed with the
+ * selected preview theme, allowing users to evaluate themes before applying.
+ * 渲染一个迷你应用布局（侧边栏 + 内容区），使用所选预览主题，
+ * 允许用户在应用前评估主题效果。
+ *
+ * @fires aithe-theme-apply - Emitted when the "Apply Theme" button is clicked. 点击"应用主题"按钮时发出，detail 包含 `{ theme: string }`。
+ *
+ * @example
+ * ```html
+ * <aithe-theme-preview value="dark"></aithe-theme-preview>
+ * ```
+ */
+export declare class AitheThemePreview extends AitheElement {
+    /** Currently applied theme name. 当前应用的主题名称。 */
+    value: AitheBuiltinTheme | string;
+    private previewTheme;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private readonly handleThemeChange;
+    private readonly handleConfirm;
+    private sidebarItems;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=theme-preview.d.ts.map

package/dist/src/components/theme/theme-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-preview.d.ts","sourceRoot":"","sources":["../../../../src/components/theme/theme-preview.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrD;;;;;;;;;;;;;;;GAeG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACjD,+CAA+C;IACnB,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAW;IAE/D,OAAO,CAAC,YAAY,CAAsB;IAEnD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAsJpB;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAEhC;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAI5B;IAEF,OAAO,CAAC,YAAY,CAKlB;IAEF,MAAM;CA8FP"}

package/dist/src/core/aithe-element.d.ts

@@ -0,0 +1,2 @@
+export { AitheElement } from '../base/aithe-element';
+//# sourceMappingURL=aithe-element.d.ts.map

package/dist/src/core/aithe-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aithe-element.d.ts","sourceRoot":"","sources":["../../../src/core/aithe-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}