@aithe/aithe-ui 26.2.2 → 26.2.3

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

@@ -1,18 +1,42 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Nested branch item for `aithe-menu`.
+ * Nested branch (sub-menu) item for `aithe-menu` with expandable children.
+ * aithe-menu 的嵌套分支（子菜单）项，支持展开子项。
+ *
+ * Supports collapsed mode: when `collapsed` is true, the trigger displays only
+ * the icon and children are shown in a popup panel on click.
+ * 支持折叠模式：当 collapsed 为 true 时，触发器仅显示图标，子菜单以弹出面板形式展示。
+ *
+ * @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`. When true, the trigger shows only the icon and children are displayed in a popup panel. 从父级 aithe-menu 继承的折叠状态。为 true 时触发器仅显示图标，子菜单以弹出面板形式展示。 */
     collapsed: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    connectedCallback(): void;
     protected updated(changed: Map<string, unknown>): void;
-    private toggle;
+    private readonly toggle;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=sub-menu.d.ts.map

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

@@ -1 +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;;GAEG;AACH,qBACa,YAAa,SAAQ,YAAY;IAChB,IAAI,SAAM;IACV,KAAK,SAAM;IACK,QAAQ,UAAS;IACjB,IAAI,UAAS;IACzB,MAAM,UAAS;IACf,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAc;IACjD,SAAS,UAAS;IAElD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA+DpB;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,CAAC,MAAM,CAMZ;IAEF,MAAM;CAoBP"}
+{"version":3,"file":"sub-menu.d.ts","sourceRoot":"","sources":["../../../src/components/navigation/sub-menu.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;;;;GAgBG;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,wMAAwM;IACxK,SAAS,UAAS;IAElD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA4FpB;IAEF,iBAAiB,IAAI,IAAI;IAIzB,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAuBtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAMrB;IAEF,MAAM;CAqDP"}

package/dist/components/progress/AGENTS.md

@@ -0,0 +1,24 @@
+# src/components/progress/ — 进度组件（4个）
+
+## 组件列表
+
+| 组件               | 标签                    | 说明           |
+| ------------------ | ----------------------- | -------------- |
+| `progress-bar.ts`  | `<aithe-progress-bar>`  | 线性进度条     |
+| `progress-ring.ts` | `<aithe-progress-ring>` | 环形进度指示器 |
+| `spinner.ts`       | `<aithe-spinner>`       | 通用加载旋转器 |
+| `skeleton.ts`      | `<aithe-skeleton>`      | 骨架屏占位     |
+
+## 编码规范
+
+- 继承 `AitheElement`，使用 `@customElement` 装饰器
+- 进度组件通过 `percent` / `value` 属性控制进度值
+- 导入使用 `@components/progress/xxx` 路径别名
+- 中英文双语 JSDoc 注释
+
+## 关键约定
+
+- `aithe-progress-bar` 支持 `striped`（条纹）和 `animated`（动画）属性
+- `aithe-progress-ring` 通过 `size` 和 `stroke-width` 控制尺寸
+- `aithe-skeleton` 通过 `variant` 控制骨架形状（text/card/avatar 等）
+- 新增组件需同步更新 `src/index.ts` 和 `docs/api/progress/`

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

@@ -1,10 +1,19 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Linear progress bar.
+ * 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>;

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

@@ -1 +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;;GAEG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IACpB,OAAO,SAAK;IACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IACxC,QAAQ,UAAQ;IAErE,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAsCpB;IAEF,MAAM;CAQP"}
+{"version":3,"file":"progress-bar.d.ts","sourceRoot":"","sources":["../../../src/components/progress/progress-bar.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;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/components/progress/progress-ring.d.ts

@@ -1,11 +1,21 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Circular progress indicator.
+ * 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>;

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

@@ -1 +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;;GAEG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACrB,OAAO,SAAK;IACZ,IAAI,SAAS;IACc,WAAW,SAAM;IAC5C,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAE7F,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqCpB;IAEF,MAAM;CA0BP"}
+{"version":3,"file":"progress-ring.d.ts","sourceRoot":"","sources":["../../../src/components/progress/progress-ring.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;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/components/progress/skeleton.d.ts

@@ -1,11 +1,26 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Skeleton placeholder.
+ * 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>;

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

@@ -1 +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;;GAEG;AACH,qBACa,aAAc,SAAQ,YAAY;IACjB,IAAI,SAAK;IACR,QAAQ,UAAQ;IACjB,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAU;IAC1C,MAAM,UAAQ;IAE3C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyCpB;IAEF,MAAM;CAWP"}
+{"version":3,"file":"skeleton.d.ts","sourceRoot":"","sources":["../../../src/components/progress/skeleton.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;;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/components/progress/spinner.d.ts

@@ -1,10 +1,19 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Generic loading spinner.
+ * 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>;

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

@@ -1 +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;;GAEG;AACH,qBACa,YAAa,SAAQ,YAAY;IAChB,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAChC,KAAK,SAA4B;IACjC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAU;IAE9D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqEpB;IAEF,MAAM;CAWP"}
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../src/components/progress/spinner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;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/components/theme/AGENTS.md

@@ -0,0 +1,27 @@
+# src/components/theme/ — 主题与外观组件（7个）
+
+## 组件列表
+
+| 组件               | 标签                    | 说明                                                       |
+| ------------------ | ----------------------- | ---------------------------------------------------------- |
+| `theme-switch.ts`  | `<aithe-theme-switch>`  | 统一外观切换器，整合主题/阴影/形状/排版在单个下拉菜单中    |
+| `theme-picker.ts`  | `<aithe-theme-picker>`  | 主题选择器，Light/Dark 分组带色点预览                      |
+| `theme-preview.ts` | `<aithe-theme-preview>` | 主题预览面板，局部预览并确认应用                           |
+| `locale-switch.ts` | `<aithe-locale-switch>` | 语言切换下拉                                               |
+| `shape-picker.ts`  | `<aithe-shape-picker>`  | 形状选择器，带预览缩略图                                   |
+| `shadow-picker.ts` | `<aithe-shadow-picker>` | 阴影选择器，带预览缩略图                                   |
+| `typo-picker.ts`   | `<aithe-typo-picker>`   | 排版选择器，带预览图标                                     |
+
+## 编码规范
+
+- 继承 `AitheElement`，使用 `@customElement` 装饰器
+- 这些组件直接调用 `aitheUI` 全局单例的 API（`setTheme/setShape/setShadow/setTypo/setLocale`）
+- 导入使用 `@components/theme/xxx` 路径别名
+- 中英文双语 JSDoc 注释
+
+## 关键约定
+
+- Picker 组件通常用于设置页面或用户偏好配置
+- `aithe-theme-preview` 提供"预览 → 确认应用"的交互模式
+- 所有 Picker 组件通过 `aithe-change` 事件通知变更
+- 新增组件需同步更新 `src/index.ts` 和 `docs/api/theme/`

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

@@ -0,0 +1,37 @@
+import { AitheElement } from '../../core/aithe-element';
+import { type AithePlacement } from '../../core/floating';
+export declare class AitheLocaleSwitch extends AitheElement {
+    placement: AithePlacement;
+    /** Whether to show only the icon and arrow without the label text. 是否仅显示图标和箭头，不显示标签文字。 */
+    iconOnly: boolean;
+    /**
+     * JSON string of locale identifiers to show in the dropdown.
+     * When empty or unset, all registered locales are displayed.
+     * 下拉菜单中显示的语言标识 JSON 字符串。为空时显示所有已注册语言。
+     *
+     * @example
+     * ```html
+     * <aithe-locale-switch locales='["en-US","zh-CN","ja-JP"]'></aithe-locale-switch>
+     * ```
+     */
+    locales: string;
+    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 handleTreeSelect;
+    private getFilteredMenu;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=locale-switch.d.ts.map

package/dist/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":"AAmBA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAK9E,qBACa,iBAAkB,SAAQ,YAAY;IACrB,SAAS,EAAE,cAAc,CAAgB;IAErE,0FAA0F;IACrC,QAAQ,UAAS;IAEtE;;;;;;;;;OASG;IACyB,OAAO,SAAM;IAEhC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,aAAa,CAAoC;IAE/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IAE5D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyEpB;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,gBAAgB,CAU/B;IAEF,OAAO,CAAC,eAAe;IAMvB,MAAM;CAsBP"}

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

@@ -0,0 +1,28 @@
+import { AitheElement } from '../../core/aithe-element';
+import { type AithePlacement } from '../../core/floating';
+import type { AitheShadowName } from '../../types';
+export declare class AitheShadowPicker extends AitheElement {
+    placement: AithePlacement;
+    /** Whether to show only the icon and arrow without the label text. 是否仅显示图标和箭头，不显示标签文字。 */
+    iconOnly: boolean;
+    value?: AitheShadowName;
+    private open;
+    private currentShadow;
+    private readonly triggerEl?;
+    private readonly overlayEl?;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private getEffectiveShadow;
+    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 handleTreeSelect;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=shadow-picker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-picker.d.ts","sourceRoot":"","sources":["../../../src/components/theme/shadow-picker.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAI9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAG9C,qBACa,iBAAkB,SAAQ,YAAY;IACrB,SAAS,EAAE,cAAc,CAAgB;IAErE,0FAA0F;IACrC,QAAQ,UAAS;IAE1C,KAAK,CAAC,EAAE,eAAe,CAAC;IAE3C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,aAAa,CAAwC;IAEnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IAE5D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyEpB;IAEF,OAAO,CAAC,kBAAkB;IAI1B,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,gBAAgB,CAU/B;IAEF,MAAM;CA8BP"}

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

@@ -0,0 +1,28 @@
+import { AitheElement } from '../../core/aithe-element';
+import { type AithePlacement } from '../../core/floating';
+import type { AitheShapeName } from '../../types';
+export declare class AitheShapePicker extends AitheElement {
+    placement: AithePlacement;
+    /** Whether to show only the icon and arrow without the label text. 是否仅显示图标和箭头，不显示标签文字。 */
+    iconOnly: boolean;
+    value?: AitheShapeName;
+    private open;
+    private currentShape;
+    private readonly triggerEl?;
+    private readonly overlayEl?;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private getEffectiveShape;
+    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 handleTreeSelect;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=shape-picker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shape-picker.d.ts","sourceRoot":"","sources":["../../../src/components/theme/shape-picker.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAI9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAG7C,qBACa,gBAAiB,SAAQ,YAAY;IACpB,SAAS,EAAE,cAAc,CAAgB;IAErE,0FAA0F;IACrC,QAAQ,UAAS;IAE1C,KAAK,CAAC,EAAE,cAAc,CAAC;IAE1C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,YAAY,CAAsC;IAEhD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IAE5D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyEpB;IAEF,OAAO,CAAC,iBAAiB;IAIzB,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,gBAAgB,CAU/B;IAEF,MAAM;CA6BP"}

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

@@ -0,0 +1,43 @@
+import { AitheElement } from '../../core/aithe-element';
+import { type AithePlacement } from '../../core/floating';
+import type { AitheThemeName } 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,
+ * rendered via `<aithe-tree-menu>`.
+ * 通过 `<aithe-tree-menu>` 按 Light/Dark 分组展示主题，并带有颜色圆点预览。
+ *
+ * @fires aithe-theme-change - Emitted when a theme is selected. 选择主题时发出，detail 包含 `{ theme: string }`。
+ *   Call `event.preventDefault()` to suppress the built-in theme switch. 调用 `preventDefault()` 可阻止内置切换逻辑。
+ *
+ * @example
+ * ```html
+ * <aithe-theme-picker value="light" placement="bottom-end"></aithe-theme-picker>
+ * ```
+ */
+export declare class AitheThemePicker extends AitheElement {
+    /** Currently selected theme name. 当前选中的主题名称。 */
+    value: AitheThemeName;
+    /** Placement of the dropdown overlay relative to the trigger. 下拉浮层相对于触发器的弹出位置。 */
+    placement: AithePlacement;
+    /** Whether to show only the icon and arrow without the label text. 是否仅显示图标和箭头，不显示标签文字。 */
+    iconOnly: boolean;
+    private open;
+    private readonly triggerEl?;
+    private readonly 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 handleTreeSelect;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=theme-picker.d.ts.map

package/dist/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,qBAAqB,CAAC;AACnD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAK7C;;;;;;;;;;;;;;;GAeG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,gDAAgD;IACpB,KAAK,EAAE,cAAc,CAAW;IAE5D,kFAAkF;IACtD,SAAS,EAAE,cAAc,CAAgB;IAErE,0FAA0F;IACrC,QAAQ,UAAS;IAE7D,OAAO,CAAC,IAAI,CAAS;IAEX,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IAE5D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAgFpB;IAEF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA+B;IAEpE,iBAAiB,IAAI,IAAI;IAMzB,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,CAKjC;IAEF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAOzB;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAW/B;IAEF,MAAM;CA6BP"}

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

@@ -0,0 +1,39 @@
+import { AitheElement } from '../../core/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;
+    private previewShape;
+    private previewShadow;
+    private previewTypo;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private readonly handleThemeChange;
+    private applyShapeTokensLocally;
+    private applyShadowTokensLocally;
+    private applyTypoTokensLocally;
+    private readonly handleShapeChange;
+    private readonly handleShadowChange;
+    private readonly handleTypoChange;
+    private readonly handleConfirm;
+    private readonly sidebarItems;
+    protected firstUpdated(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=theme-preview.d.ts.map

package/dist/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,qBAAqB,CAAC;AAInD,OAAO,KAAK,EAAE,iBAAiB,EAAkD,MAAM,QAAQ,CAAC;AAGhG;;;;;;;;;;;;;;;GAeG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACjD,+CAA+C;IACnB,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAW;IAE/D,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,WAAW,CAAoC;IAEhE,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAsJpB;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAGhC;IAEF,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAIhC;IAEF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAIjC;IAEF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI/B;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAO5B;IAEF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAK3B;IAEF,SAAS,CAAC,YAAY,IAAI,IAAI;IAM9B,MAAM;CA0GP"}

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

@@ -0,0 +1,34 @@
+import { AitheElement } from '../../core/aithe-element';
+import { type AithePlacement } from '../../core/floating';
+export declare class AitheThemeSwitch extends AitheElement {
+    placement: AithePlacement;
+    /** Whether to show only the icon and arrow without the label text. 是否仅显示图标和箭头，不显示标签文字。 */
+    iconOnly: boolean;
+    private open;
+    private currentTheme;
+    private currentShadow;
+    private currentShape;
+    private currentTypo;
+    private readonly triggerEl?;
+    private readonly overlayEl?;
+    private readonly themeMenu;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private getActiveId;
+    private readonly handleViewportChange;
+    private unsubscribeTheme?;
+    private unsubscribeShadow?;
+    private unsubscribeShape?;
+    private unsubscribeTypo?;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(): void;
+    private bindViewport;
+    private unbindViewport;
+    private updatePosition;
+    private readonly handleOutsideClick;
+    private readonly toggleOpen;
+    private readonly handleTreeSelect;
+    private readonly renderThemeItem;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=theme-switch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-switch.d.ts","sourceRoot":"","sources":["../../../src/components/theme/theme-switch.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAgD9E,qBACa,gBAAiB,SAAQ,YAAY;IACpB,SAAS,EAAE,cAAc,CAAgB;IAErE,0FAA0F;IACrC,QAAQ,UAAS;IAE7D,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,WAAW,CAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IAE5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAE9C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyEpB;IAEF,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA+B;IAEpE,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,eAAe,CAAC,CAAa;IAErC,iBAAiB,IAAI,IAAI;IAiBzB,oBAAoB,IAAI,IAAI;IAU5B,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,gBAAgB,CAsC/B;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAiB9B;IAEF,MAAM;CAuBP"}

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

@@ -0,0 +1,28 @@
+import { AitheElement } from '../../core/aithe-element';
+import { type AithePlacement } from '../../core/floating';
+import type { AitheTypoName } from '../../types';
+export declare class AitheTypoPicker extends AitheElement {
+    placement: AithePlacement;
+    /** Whether to show only the icon and arrow without the label text. 是否仅显示图标和箭头，不显示标签文字。 */
+    iconOnly: boolean;
+    value?: AitheTypoName;
+    private open;
+    private currentTypo;
+    private readonly triggerEl?;
+    private readonly overlayEl?;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private getEffectiveTypo;
+    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 handleTreeSelect;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=typo-picker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"typo-picker.d.ts","sourceRoot":"","sources":["../../../src/components/theme/typo-picker.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,gBAAgB,CAAC;AAI9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAI5C,qBACa,eAAgB,SAAQ,YAAY;IACnB,SAAS,EAAE,cAAc,CAAgB;IAErE,0FAA0F;IACrC,QAAQ,UAAS;IAE1C,KAAK,CAAC,EAAE,aAAa,CAAC;IAEzC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,WAAW,CAAoC;IAE7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IAE5D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyEpB;IAEF,OAAO,CAAC,gBAAgB;IAIxB,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,gBAAgB,CAU/B;IAEF,MAAM;CA6BP"}

package/dist/core/AGENTS.md

@@ -0,0 +1,38 @@
+# src/core/ — 核心模块
+
+## 概述
+
+包含 Aithe UI 组件库的核心基础设施，所有组件继承自 `AitheElement`。
+
+## 目录结构
+
+| 模块       | 文件                  | 说明                                                                                        |
+| ---------- | --------------------- | ------------------------------------------------------------------------------------------- |
+| 基类       | `aithe-element.ts`    | 所有组件的基类，继承 LitElement，提供 theme/disabled/log 等公共属性和 `emit()` 事件发射方法 |
+| 浮层       | `floating.ts`         | 浮层定位引擎，用于 tooltip/popover/dropdown 等弹出层                                        |
+| 锚定覆盖   | `anchored-overlay.ts` | 锚定覆盖层组件，提供定位 + 点击外部关闭 + 焦点管理                                          |
+| 样式       | `styles.ts`           | 基础样式集合，导出 `aitheBaseStyles` 供所有组件使用                                         |
+| 类型       | `types.ts`            | 核心类型定义                                                                                |
+| 路由       | `router/index.ts`     | 轻量前端路由，支持 hash/history 模式、动态路由、路由守卫                                    |
+| 数据中间层 | `datahub/`            | DataHub：请求调度、缓存、去重、Mock、幂等防护                                               |
+| 代码高亮   | `highlight/`          | 自研语法高亮引擎，支持 38 种语言                                                            |
+| Markdown   | `markdown/`           | Markdown 解析渲染模块，支持插件架构                                                         |
+| 日志       | `logger/`             | 日志系统，支持 console 劫持、级别过滤、远程上报                                             |
+| 自动表单   | `autoform/`           | 表单控件类型注册表和规则引擎                                                                |
+
+## 编码规范
+
+- 所有导出必须通过 `src/index.ts` 统一导出
+- 导入必须使用 `@core/*` 路径别名，禁止 `../` 相对路径
+- 基类属性使用 `@property` 装饰器，响应式状态使用 `@state`
+- 事件使用 `this.emit('event-name', detail)` 方式发射
+- 静态常量和固定配置必须加 `readonly`
+- 中英文双语 JSDoc 注释
+
+## 关键约定
+
+- `AitheElement` 是所有组件的唯一基类，不要直接继承 `LitElement`
+- 新增核心模块时需在 `src/index.ts` 添加对应导出
+- DataHub 适配器通过 `registerAdapter` 注册，可扩展
+- 高亮引擎语言通过 `import './lang-xxx'` 副作用导入注册
+- 路由守卫返回 `false` 阻止导航

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

@@ -1,2 +1,63 @@
-export { AitheElement } from '../base/aithe-element';
+import { LitElement } from 'lit';
+import type { AitheVariant } from "../styles/types";
+/**
+ * Base class for all Aithe UI components. Extends LitElement with theme awareness,
+ * accessibility helpers, and a unified event emission API.
+ * 所有 Aithe UI 组件的基类。继承 LitElement，提供主题感知、无障碍辅助和统一事件发射 API。
+ *
+ * @example
+ * ```ts
+ * @customElement('aithe-my-comp')
+ * export class AitheMyComp extends AitheElement {}
+ * ```
+ */
+export declare class AitheElement extends LitElement {
+    /** Visual variant of the component. 组件的视觉变体。 */
+    variant: AitheVariant;
+    /** Size preset of the component. 组件的尺寸规格。 */
+    size: string;
+    /** Local theme override; falls back to the closest themed ancestor or global theme when empty. 本地主题覆盖；为空时继承最近带主题祖先或全局主题。 */
+    theme: string;
+    /** Whether the component is disabled. 组件是否禁用。 */
+    disabled: boolean;
+    /** When true, all events emitted by this component will be captured by the logger. 为 true 时，组件的所有事件将被日志器捕获。 */
+    log: boolean;
+    constructor();
+    /**
+     * Emit a custom event with the `aithe-` prefix convention.
+     * 发射遵循 `aithe-` 前缀约定的自定义事件。
+     *
+     * @param type - Event type (without prefix). 事件类型（不含前缀）。
+     * @param detail - Event payload. 事件载荷。
+     * @returns Whether the event was not cancelled. 事件是否未被取消。
+     */
+    emit(type: string, detail?: unknown): boolean;
+    /**
+     * Resolved theme name: local override → closest themed ancestor → global theme.
+     * 计算后的主题名：本地覆盖 → 最近带主题祖先 → 全局主题。
+     */
+    get computedTheme(): string;
+    connectedCallback(): void;
+    /**
+     * Focus the first focusable element within the given root.
+     * 聚焦给定根节点内第一个可聚焦元素。
+     *
+     * @param root - Parent node to search within. 搜索的父节点。
+     */
+    protected focusFirst(root?: ParentNode): void;
+    /**
+     * Trap keyboard focus within the given root (Tab / Shift+Tab cycle).
+     * 在给定根节点内捕获键盘焦点（Tab / Shift+Tab 循环）。
+     *
+     * @param event - Keyboard event to handle. 要处理的键盘事件。
+     * @param root - Parent node to trap focus within. 捕获焦点的父节点。
+     */
+    protected trapFocus(event: KeyboardEvent, root?: ParentNode): void;
+    /**
+     * Synchronize base accessibility attributes (aria-disabled, data-aithe-theme).
+     * 同步基础无障碍属性（aria-disabled、data-aithe-theme）。
+     */
+    private syncBaseA11yState;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+}
 //# sourceMappingURL=aithe-element.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"aithe-element.d.ts","sourceRoot":"","sources":["../../src/core/aithe-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAKjC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,gDAAgD;IACpB,OAAO,EAAG,YAAY,CAAa;IAE/D,6CAA6C;IACjB,IAAI,SAAQ;IAExC,4HAA4H;IAChG,KAAK,SAAM;IAEvC,iDAAiD;IACL,QAAQ,UAAS;IAE7D,+GAA+G;IAClF,GAAG,UAAS;;IAOzC;;;;;;;OAOG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO;IAO7C;;;OAGG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAEQ,iBAAiB,IAAI,IAAI;IAKlC;;;;;OAKG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,GAAE,UAA4B,GAAG,IAAI;IAI9D;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,GAAE,UAA4B,GAAG,IAAI;IA0BnF;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAchB,wBAAwB,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,IAAI;CAIR"}