@aithe/aithe-ui 26.2.2 → 26.2.3

package/dist/components/form/date-picker.d.ts

@@ -1,12 +1,27 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
  * Date input wrapper with optional range mode.
+ * 日期输入包装器，支持可选的范围模式。
+ *
+ * @slot - Default slot (unused; picker is self-contained). 默认插槽（未使用，选择器为自包含组件）。
+ * @fires aithe-change - Emitted when a date value changes, with `{ value, format }`. 日期值变更时触发。
+ *
+ * @example
+ * ```html
+ * <aithe-date-picker value="2025-01-01" format="YYYY-MM-DD"></aithe-date-picker>
+ * <aithe-date-picker range value="2025-01-01" end-value="2025-01-31"></aithe-date-picker>
+ * ```
  */
 export declare class AitheDatePicker extends AitheElement {
+    /** Start date value. 起始日期值。 */
     value: string;
+    /** Display format pattern. 显示格式模式。 */
     format: string;
+    /** Whether to enable date range selection. 是否启用日期范围选择。 */
     range: boolean;
+    /** Whether the date picker is disabled. 是否禁用日期选择器。 */
     disabled: boolean;
+    /** End date value for range mode. 范围模式的结束日期值。 */
     endValue: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     private emitChange;

package/dist/components/form/date-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"date-picker.d.ts","sourceRoot":"","sources":["../../../src/components/form/date-picker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,eAAgB,SAAQ,YAAY;IACnB,KAAK,SAAM;IACX,MAAM,SAAgB;IACrB,KAAK,UAAS;IACC,QAAQ,UAAS;IACT,QAAQ,SAAM;IAElE,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8BpB;IAEF,OAAO,CAAC,UAAU;IAOlB,MAAM;CAmBP"}
+{"version":3,"file":"date-picker.d.ts","sourceRoot":"","sources":["../../../src/components/form/date-picker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;GAYG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,+BAA+B;IACH,KAAK,SAAM;IACvC,sCAAsC;IACV,MAAM,SAAgB;IAClD,0DAA0D;IAC7B,KAAK,UAAS;IAC3C,sDAAsD;IACV,QAAQ,UAAS;IAC7D,iDAAiD;IACG,QAAQ,SAAM;IAElE,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8BpB;IAEF,OAAO,CAAC,UAAU;IAOlB,MAAM;CA6BP"}

package/dist/components/form/form-item.d.ts

@@ -1,14 +1,33 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
  * Labeled form field row with light validation state.
+ * 带标签的表单字段行，支持轻量级校验状态。
+ *
+ * @slot - Default slot for the form control element. 表单控件元素内容。
+ * @example
+ * ```html
+ * <aithe-form-item label="Email" prop="email" required error="Email is required">
+ *   <aithe-input name="email"></aithe-input>
+ * </aithe-form-item>
+ * ```
  */
 export declare class AitheFormItem extends AitheElement {
+    /** Field label text. 字段标签文本。 */
     label: string;
+    /** Display title for the form item (shown as tooltip). 表单项的显示标题（作为工具提示）。 */
+    title: string;
+    /** Icon name to display before the label. 在标签前显示的图标名称。 */
+    icon: string;
+    /** Field property name for validation mapping. 用于校验映射的字段属性名。 */
     prop: string;
+    /** Whether the field is required. 是否为必填字段。 */
     required: boolean;
+    /** Static error message to display. 显示的静态错误消息。 */
     error: string;
+    /** Internal error message from validation. 校验产生的内部错误消息。 */
     private internalError;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    /** Validates the child control and sets internal error state. 校验子控件并设置内部错误状态。 */
     validate(): boolean;
     render(): import("lit-html").TemplateResult<1>;
 }

package/dist/components/form/form-item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form-item.d.ts","sourceRoot":"","sources":["../../../src/components/form/form-item.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,aAAc,SAAQ,YAAY;IACjB,KAAK,SAAM;IACX,IAAI,SAAM;IACT,QAAQ,UAAS;IAClB,KAAK,SAAM;IAE9B,OAAO,CAAC,aAAa,CAAM;IAEpC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwBpB;IAEF,QAAQ,IAAI,OAAO;IAcnB,MAAM;CAgBP"}
+{"version":3,"file":"form-item.d.ts","sourceRoot":"","sources":["../../../src/components/form/form-item.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;GAWG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,gCAAgC;IACJ,KAAK,SAAM;IACvC,4EAA4E;IAChD,KAAK,SAAM;IACvC,0DAA0D;IAC9B,IAAI,SAAM;IACtC,gEAAgE;IACpC,IAAI,SAAM;IACtC,8CAA8C;IACjB,QAAQ,UAAS;IAC9C,kDAAkD;IACtB,KAAK,SAAM;IAEvC,2DAA2D;IAClD,OAAO,CAAC,aAAa,CAAM;IAEpC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA6BpB;IAEF,iFAAiF;IACjF,QAAQ,IAAI,OAAO;IAsBnB,MAAM;CAgCP"}

package/dist/components/form/form.d.ts

@@ -1,14 +1,33 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
  * Form container with lightweight validation and submit events.
+ * 表单容器，支持轻量级校验和提交事件。
+ *
+ * @slot - Default slot for form items and controls. 表单项和控件内容。
+ * @fires aithe-validate - Emitted after validation, with `{ valid }`. 校验完成后触发。
+ * @fires aithe-submit - Emitted on valid form submission, with `{ values }`. 有效表单提交时触发。
+ * @example
+ * ```html
+ * <aithe-form model='{"name":""}' rules='{}'>
+ *   <aithe-form-item label="Name" prop="name" required>
+ *     <aithe-input name="name"></aithe-input>
+ *   </aithe-form-item>
+ * </aithe-form>
+ * ```
  */
-export declare class AitheForm extends AitheElement {
+declare class AitheForm extends AitheElement {
+    /** JSON string of the form model data. 表单模型数据的 JSON 字符串。 */
     model: string;
+    /** JSON string of validation rules. 校验规则的 JSON 字符串。 */
     rules: string;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    /** Validates all child form-items and emits validate event. 校验所有子表单项并触发 validate 事件。 */
     validate(): boolean;
+    /** Collects name/value pairs from all form controls. 从所有表单控件收集 name/value 对。 */
     private collectValues;
-    private handleSubmit;
+    /** Handles form submit: validates then emits submit event on success. 处理表单提交：校验成功后触发 submit 事件。 */
+    private readonly handleSubmit;
     render(): import("lit-html").TemplateResult<1>;
 }
+export default AitheForm;
 //# sourceMappingURL=form.d.ts.map

package/dist/components/form/form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../../src/components/form/form.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD;;GAEG;AACH,qBACa,SAAU,SAAQ,YAAY;IACb,KAAK,SAAQ;IACb,KAAK,SAAQ;IAEzC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAYpB;IAEF,QAAQ,IAAI,OAAO;IAOnB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,YAAY,CASlB;IAEF,MAAM;CAOP"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../../src/components/form/form.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;;;GAeG;AACH,cACM,SAAU,SAAQ,YAAY;IAClC,4DAA4D;IAChC,KAAK,SAAQ;IACzC,uDAAuD;IAC3B,KAAK,SAAQ;IAEzC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAYpB;IAEF,wFAAwF;IACxF,QAAQ,IAAI,OAAO;IAOnB,gFAAgF;IAChF,OAAO,CAAC,aAAa;IAuBrB,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAS3B;IAEF,MAAM;CAOP;AAED,eAAe,SAAS,CAAA"}

package/dist/components/form/radio-group.d.ts

@@ -1,15 +1,35 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Radio group container that manages the currently selected value.
+ * 单选组容器，管理当前选中的值。
+ *
+ * @slot - Default slot for aithe-radio children. 子单选按钮内容。
+ * @fires aithe-change - Emitted when the group value changes, with `value: string`. 组值变更时触发。
+ * @example
+ * ```html
+ * <aithe-radio-group value="a" name="choice">
+ *   <aithe-radio value="a">Option A</aithe-radio>
+ *   <aithe-radio value="b">Option B</aithe-radio>
+ * </aithe-radio-group>
+ * ```
+ */
 export declare class AitheRadioGroup extends AitheElement {
+    /** Currently selected radio value. 当前选中的单选值。 */
     value: string;
+    /** Whether all child radios are disabled. 是否禁用所有子单选按钮。 */
     disabled: boolean;
+    /** Name attribute propagated to child radios. 传递给子单选按钮的 name 属性。 */
     name: string;
-    private nodes;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     connectedCallback(): void;
     disconnectedCallback(): void;
+    protected firstUpdated(): void;
     updated(changed: Map<string, unknown>): void;
-    private syncChildren;
-    private handleToggle;
+    private getRadios;
+    /** Syncs checked/disabled/name state to child radios. 将选中/禁用/name 状态同步到子单选按钮。 */
+    private readonly syncChildren;
+    /** Handles child radio toggle and updates group value. 处理子单选按钮切换并更新组值。 */
+    private readonly handleToggle;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=radio-group.d.ts.map

package/dist/components/form/radio-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../../src/components/form/radio-group.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD,qBACa,eAAgB,SAAQ,YAAY;IACnB,KAAK,SAAM;IACV,QAAQ,UAAS;IAClB,IAAI,SAAM;IAEb,OAAO,CAAC,KAAK,CAAa;IAEnD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DASpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM5C,OAAO,CAAC,YAAY,CAUlB;IAEF,OAAO,CAAC,YAAY,CASlB;IAEF,MAAM;CAGP"}
+{"version":3,"file":"radio-group.d.ts","sourceRoot":"","sources":["../../../src/components/form/radio-group.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;GAaG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,gDAAgD;IACpB,KAAK,SAAM;IACvC,0DAA0D;IAC7B,QAAQ,UAAS;IAC9C,oEAAoE;IACxC,IAAI,SAAM;IAEtC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DASpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;cAKT,YAAY,IAAI,IAAI;IAIvC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM5C,OAAO,CAAC,SAAS;IAMjB,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAe3B;IAEF,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAW3B;IAEF,MAAM;CAKP"}

package/dist/components/form/radio.d.ts

@@ -1,12 +1,30 @@
 import { AitheElement } from '../../core/aithe-element';
+/**
+ * Radio button input with label slot.
+ * 单选按钮输入组件，支持标签插槽。
+ *
+ * @slot - Default slot for radio label text. 单选按钮标签文本。
+ * @fires aithe-change - Emitted when checked state changes (standalone). 选中状态变更时触发（独立使用）。
+ * @fires aithe-radio-toggle - Emitted inside radio-group for group coordination. 在单选组内触发以协调状态。
+ * @example
+ * ```html
+ * <aithe-radio value="a" name="choice">Option A</aithe-radio>
+ * ```
+ */
 export declare class AitheRadio extends AitheElement {
+    /** Whether the radio is checked. 是否选中。 */
     checked: boolean;
+    /** Whether the radio is disabled. 是否禁用。 */
     disabled: boolean;
+    /** Value submitted when selected (used in groups). 选中时提交的值（在组中使用）。 */
     value: string;
+    /** Name attribute for form submission. 表单提交的 name 属性。 */
     name: string;
+    /** Disabled state propagated from parent radio-group. 从父级单选组传递的禁用状态。 */
     groupDisabled: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private handleChange;
+    /** Handles native change event and emits appropriate custom event. 处理原生变更事件并触发自定义事件。 */
+    private readonly handleChange;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=radio.d.ts.map

package/dist/components/form/radio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../../src/components/form/radio.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD,qBACa,UAAW,SAAQ,YAAY;IACE,OAAO,UAAS;IAChB,QAAQ,UAAS;IACjC,KAAK,SAAM;IACX,IAAI,SAAM;IACN,aAAa,UAAS;IAEtD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyBpB;IAEF,OAAO,CAAC,YAAY,CAUlB;IAEF,MAAM;CAiBP"}
+{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../../src/components/form/radio.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;GAWG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,0CAA0C;IACE,OAAO,UAAS;IAC5D,2CAA2C;IACC,QAAQ,UAAS;IAC7D,sEAAsE;IAC1C,KAAK,SAAM;IACvC,yDAAyD;IAC7B,IAAI,SAAM;IACtC,wEAAwE;IACxC,aAAa,UAAS;IAEtD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyBpB;IAEF,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAY3B;IAEF,MAAM;CAiBP"}

package/dist/components/form/rate.d.ts

@@ -1,11 +1,24 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
  * Star rating component with optional half steps.
+ * 星级评分组件，支持可选的半星步进。
+ *
+ * @slot - Default slot (unused; rate is self-contained). 默认插槽（未使用，评分组件为自包含组件）。
+ * @fires aithe-change - Emitted when the rating value changes, with `{ value }`. 评分值变更时触发。
+ *
+ * @example
+ * ```html
+ * <aithe-rate value="3" max="5" allow-half color="var(--aithe-warning-5)"></aithe-rate>
+ * ```
  */
 export declare class AitheRate extends AitheElement {
+    /** Maximum number of stars. 最大星数。 */
     max: number;
+    /** Whether to allow half-star ratings. 是否允许半星评分。 */
     allowHalf: boolean;
+    /** Custom color for filled stars. 已填充星星的自定义颜色。 */
     color: string;
+    /** Current rating value. 当前评分值。 */
     value: number;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     private setValue;

package/dist/components/form/rate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate.d.ts","sourceRoot":"","sources":["../../../src/components/form/rate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,SAAU,SAAQ,YAAY;IACb,GAAG,SAAK;IACkB,SAAS,UAAS;IAC5C,KAAK,SAA4B;IACjC,KAAK,SAAK;IAEtC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAoCpB;IAEF,OAAO,CAAC,QAAQ;IAQhB,MAAM;CAeP"}
+{"version":3,"file":"rate.d.ts","sourceRoot":"","sources":["../../../src/components/form/rate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;GAWG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,qCAAqC;IACT,GAAG,SAAK;IACpC,oDAAoD;IACE,SAAS,UAAS;IACxE,kDAAkD;IACtB,KAAK,SAA4B;IAC7D,mCAAmC;IACP,KAAK,SAAK;IAEtC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAoCpB;IAEF,OAAO,CAAC,QAAQ;IAQhB,MAAM;CAmBP"}

package/dist/components/form/select.d.ts

@@ -1,20 +1,50 @@
 import type { PropertyValues } from 'lit';
 import { AitheAnchoredOverlayElement } from '../../core/anchored-overlay';
 import type { AitheSelectOption } from '../../core/types';
+/**
+ * Dropdown select component with search, clear, and keyboard navigation.
+ * 下拉选择组件，支持搜索、清除和键盘导航。
+ *
+ * @slot - Default slot (unused; content driven by options). 默认插槽（未使用，内容由 options 控制）。
+ * @fires aithe-change - Emitted when a value is selected, with `{ option, value }`. 选中值变更时触发。
+ * @fires aithe-clear - Emitted when the value is cleared. 值被清除时触发。
+ * @fires aithe-open-change - Emitted when the dropdown opens or closes. 下拉框开关状态变更时触发。
+ * @example
+ * ```html
+ * <aithe-select
+ *   options='[{"id":"a","label":"Option A"},{"id":"b","label":"Option B"}]'
+ *   searchable
+ *   clearable
+ * ></aithe-select>
+ * ```
+ */
 export declare class AitheSelect extends AitheAnchoredOverlayElement {
+    /** JSON string of select options. 选项的 JSON 字符串。 */
     optionsJson: string;
+    /** Array of select option objects. 选项对象数组。 */
     options: AitheSelectOption[];
+    /** Currently selected value. 当前选中的值。 */
     value: string;
+    /** Display title for the select (shown as tooltip). 下拉选择的显示标题（作为工具提示）。 */
+    title: string;
+    /** Icon name to display before the selected value. 在选中值前显示的图标名称。 */
+    icon: string;
+    /** Placeholder text shown when no value is selected. 无选中值时的占位文本。 */
     placeholder: string;
+    /** Whether the select supports search/filter. 是否支持搜索过滤。 */
     searchable: boolean;
+    /** Whether the selected value can be cleared. 是否允许清除选中值。 */
     clearable: boolean;
+    /** Whether the select is disabled. 是否禁用。 */
     disabled: boolean;
+    /** Dropdown panel placement. 下拉面板位置。 */
     placement: 'bottom-start' | 'top-start';
-    private triggerElement?;
-    private panel?;
-    private searchInput?;
+    private readonly triggerElement?;
+    private readonly panel?;
+    private readonly searchInput?;
     private query;
     private activeIndex;
+    /** Parses optionsJson into the options array on property change. 属性变更时将 optionsJson 解析为 options 数组。 */
     protected willUpdate(changed: PropertyValues<this>): void;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     protected get panelElement(): HTMLElement | null;
@@ -22,14 +52,23 @@ export declare class AitheSelect extends AitheAnchoredOverlayElement {
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected updated(changed: PropertyValues<this>): void;
+    /** Returns the option object matching the current value. 返回与当前值匹配的选项对象。 */
     private get selectedOption();
+    /** Filters options by search query keyword. 根据搜索关键词过滤选项。 */
     private get filteredOptions();
-    private handleOutsidePointer;
-    private handleDocumentKeydown;
-    private toggleOpen;
+    /** Closes dropdown on outside pointer events. 点击外部时关闭下拉框。 */
+    private readonly handleOutsidePointer;
+    /** Closes dropdown on Escape key. 按 Escape 键关闭下拉框。 */
+    private readonly handleDocumentKeydown;
+    /** Toggles the dropdown open state. 切换下拉框开关状态。 */
+    private readonly toggleOpen;
+    /** Selects an option, closes dropdown, and emits change event. 选中选项、关闭下拉框并触发变更事件。 */
     private selectOption;
-    private clearValue;
-    private handleTriggerKeydown;
+    /** Clears the current value and emits clear + change events. 清除当前值并触发清除和变更事件。 */
+    private readonly clearValue;
+    /** Handles keyboard navigation for the trigger element. 处理触发元素的键盘导航。 */
+    private readonly handleTriggerKeydown;
     render(): import("lit-html").TemplateResult<1>;
+    private renderOptionList;
 }
 //# sourceMappingURL=select.d.ts.map

package/dist/components/form/select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/components/form/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAK1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,qBACa,WAAY,SAAQ,2BAA2B;IACR,WAAW,SAAM;IACnC,OAAO,EAAE,iBAAiB,EAAE,CAAM;IACtC,KAAK,SAAM;IACX,WAAW,SAAS;IACnB,UAAU,UAAS;IACnB,SAAS,UAAS;IACH,QAAQ,UAAS;IACjC,SAAS,EAAE,cAAc,GAAG,WAAW,CAAkB;IAElE,OAAO,CAAC,cAAc,CAAC,CAAc;IACvC,OAAO,CAAC,KAAK,CAAC,CAAc;IACrB,OAAO,CAAC,WAAW,CAAC,CAAmB;IAEtD,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,WAAW,CAAM;IAElC,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAUzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA2HpB;IAEF,SAAS,KAAK,YAAY,IAAI,WAAW,GAAG,IAAI,CAE/C;IAED,SAAS,KAAK,aAAa,IAAI,WAAW,CAEzC;IAED,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAM5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAqBtD,OAAO,KAAK,cAAc,GAEzB;IAED,OAAO,KAAK,eAAe,GAW1B;IAED,OAAO,CAAC,oBAAoB,CAI1B;IAEF,OAAO,CAAC,qBAAqB,CAI3B;IAEF,OAAO,CAAC,UAAU,CAMhB;IAEF,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,UAAU,CAUhB;IAEF,OAAO,CAAC,oBAAoB,CAiC1B;IAEF,MAAM;CA0EP"}
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/components/form/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAK1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIrD;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,WAAY,SAAQ,2BAA2B;IAC1D,mDAAmD;IACD,WAAW,SAAM;IACnE,8CAA8C;IACd,OAAO,EAAE,iBAAiB,EAAE,CAAM;IAClE,wCAAwC;IACZ,KAAK,SAAM;IACvC,0EAA0E;IAC9C,KAAK,SAAM;IACvC,oEAAoE;IACxC,IAAI,SAAM;IACtC,oEAAoE;IACxC,WAAW,SAAM;IAC7C,2DAA2D;IAC9B,UAAU,UAAS;IAChD,4DAA4D;IAC/B,SAAS,UAAS;IAC/C,4CAA4C;IACA,QAAQ,UAAS;IAC7D,wCAAwC;IACZ,SAAS,EAAE,cAAc,GAAG,WAAW,CAAkB;IAElE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAc;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAmB;IAE/D,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,WAAW,CAAM;IAElC,uGAAuG;IACvG,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAUzD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAoJpB;IAEF,SAAS,KAAK,YAAY,IAAI,WAAW,GAAG,IAAI,CAE/C;IAED,SAAS,KAAK,aAAa,IAAI,WAAW,CAEzC;IAED,iBAAiB,IAAI,IAAI;IAMzB,oBAAoB,IAAI,IAAI;IAM5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAwBtD,2EAA2E;IAC3E,OAAO,KAAK,cAAc,GAEzB;IAED,4DAA4D;IAC5D,OAAO,KAAK,eAAe,GAW1B;IAED,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAInC;IAEF,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,kDAAkD;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAMzB;IAEF,qFAAqF;IACrF,OAAO,CAAC,YAAY;IAWpB,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAUzB;IAEF,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAiCnC;IAEF,MAAM;IAyEN,OAAO,CAAC,gBAAgB;CA0CzB"}

package/dist/components/form/slider.d.ts

@@ -1,13 +1,29 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
  * Numeric slider with single and range modes.
+ * 数值滑块，支持单值和范围模式。
+ *
+ * @slot - Default slot (unused; slider is self-contained). 默认插槽（未使用，滑块为自包含组件）。
+ * @fires aithe-change - Emitted when the slider value changes, with `{ value }`. 滑块值变更时触发。
+ *
+ * @example
+ * ```html
+ * <aithe-slider value="50" min="0" max="100" step="1"></aithe-slider>
+ * <aithe-slider range value="20,80"></aithe-slider>
+ * ```
  */
 export declare class AitheSlider extends AitheElement {
+    /** Minimum value of the slider. 滑块的最小值。 */
     min: number;
+    /** Maximum value of the slider. 滑块的最大值。 */
     max: number;
+    /** Step increment for the slider. 滑块的步进增量。 */
     step: number;
+    /** Whether to enable range (dual-thumb) mode. 是否启用范围（双滑块）模式。 */
     range: boolean;
+    /** Current value (comma-separated for range mode). 当前值（范围模式用逗号分隔）。 */
     value: string;
+    /** Whether the slider is disabled. 是否禁用滑块。 */
     disabled: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     private get values();

package/dist/components/form/slider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../../src/components/form/slider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,WAAY,SAAQ,YAAY;IACf,GAAG,SAAK;IACR,GAAG,SAAO;IACV,IAAI,SAAK;IACR,KAAK,UAAS;IACf,KAAK,SAAQ;IACG,QAAQ,UAAS;IAE7D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwBpB;IAEF,OAAO,KAAK,MAAM,GAGjB;IAED,OAAO,CAAC,WAAW;IAanB,MAAM;CAkCP"}
+{"version":3,"file":"slider.d.ts","sourceRoot":"","sources":["../../../src/components/form/slider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;GAYG;AACH,qBACa,WAAY,SAAQ,YAAY;IAC3C,2CAA2C;IACf,GAAG,SAAK;IACpC,2CAA2C;IACf,GAAG,SAAO;IACtC,8CAA8C;IAClB,IAAI,SAAK;IACrC,gEAAgE;IACnC,KAAK,UAAS;IAC3C,sEAAsE;IAC1C,KAAK,SAAQ;IACzC,8CAA8C;IACF,QAAQ,UAAS;IAE7D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwBpB;IAEF,OAAO,KAAK,MAAM,GAGjB;IAED,OAAO,CAAC,WAAW;IAcnB,MAAM;CAmCP"}

package/dist/components/form/switch.d.ts

@@ -1,12 +1,25 @@
 import { AitheElement } from '../../core/aithe-element';
-import type { AitheIntent } from '../../core/types';
+/**
+ * Toggle switch with size and color variants.
+ * 开关切换组件，支持尺寸和颜色变体。
+ *
+ * @slot - Default slot (unused; switch is self-contained). 默认插槽（未使用，开关为自包含组件）。
+ * @fires aithe-change - Emitted when checked state changes, with `{ checked }`. 选中状态变更时触发。
+ * @example
+ * ```html
+ * <aithe-switch checked size="md" variant="primary"></aithe-switch>
+ * ```
+ */
 export declare class AitheSwitch extends AitheElement {
+    /** Whether the switch is checked (on). 是否选中（开启）。 */
     checked: boolean;
+    /** Whether the switch is disabled. 是否禁用。 */
     disabled: boolean;
+    /** Switch size preset. 开关尺寸预设。 */
     size: 'sm' | 'md' | 'lg';
-    type: AitheIntent;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private toggleSwitch;
+    /** Toggles the checked state and emits change event. 切换选中状态并触发变更事件。 */
+    private readonly toggleSwitch;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=switch.d.ts.map

package/dist/components/form/switch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/components/form/switch.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,qBACa,WAAY,SAAQ,YAAY;IACC,OAAO,UAAS;IAChB,QAAQ,UAAS;IACjC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAChC,IAAI,EAAE,WAAW,CAAa;IAE1D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyEpB;IAEF,OAAO,CAAC,YAAY,CAOlB;IAEF,MAAM;CAkBP"}
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/components/form/switch.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,qBACa,WAAY,SAAQ,YAAY;IAC3C,oDAAoD;IACR,OAAO,UAAS;IAC5D,4CAA4C;IACA,QAAQ,UAAS;IAC7D,kCAAkC;IACN,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAQ;IAE5D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyEpB;IAEF,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAO3B;IAEF,MAAM;CAkBP"}

package/dist/components/form/time-picker.d.ts

@@ -1,11 +1,24 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
  * Time picker wrapper around native input.
+ * 基于原生输入的时间选择器。
+ *
+ * @slot - Default slot (unused; picker is self-contained). 默认插槽（未使用，选择器为自包含组件）。
+ * @fires aithe-change - Emitted when the time value changes, with `{ value, format, step }`. 时间值变更时触发。
+ *
+ * @example
+ * ```html
+ * <aithe-time-picker value="09:30" format="HH:mm" step="300"></aithe-time-picker>
+ * ```
  */
 export declare class AitheTimePicker extends AitheElement {
+    /** Current time value. 当前时间值。 */
     value: string;
+    /** Display format pattern. 显示格式模式。 */
     format: string;
+    /** Step interval in seconds for the time input. 时间输入的步进间隔（秒）。 */
     step: number;
+    /** Whether the time picker is disabled. 是否禁用时间选择器。 */
     disabled: boolean;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
     render(): import("lit-html").TemplateResult<1>;

package/dist/components/form/time-picker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-picker.d.ts","sourceRoot":"","sources":["../../../src/components/form/time-picker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,eAAgB,SAAQ,YAAY;IACnB,KAAK,SAAM;IACX,MAAM,SAAW;IACjB,IAAI,SAAO;IACK,QAAQ,UAAS;IAE7D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwBpB;IAEF,MAAM;CAgBP"}
+{"version":3,"file":"time-picker.d.ts","sourceRoot":"","sources":["../../../src/components/form/time-picker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;GAWG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,iCAAiC;IACL,KAAK,SAAM;IACvC,sCAAsC;IACV,MAAM,SAAW;IAC7C,iEAAiE;IACrC,IAAI,SAAO;IACvC,sDAAsD;IACV,QAAQ,UAAS;IAE7D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwBpB;IAEF,MAAM;CAgBP"}

package/dist/components/form/transfer.d.ts

@@ -1,11 +1,29 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Dual-list transfer component.
+ * Dual-list transfer component for moving items between source and target panels.
+ * 双列表穿梭框组件，用于在源面板和目标面板之间移动项目。
+ *
+ * @slot - Default slot (unused; transfer is self-contained). 默认插槽（未使用，穿梭框为自包含组件）。
+ * @fires aithe-change - Emitted when items are transferred, with `{ value: string[] }`. 项目转移时触发。
+ *
+ * @example
+ * ```html
+ * <aithe-transfer
+ *   data='[{"label":"Item A","id":"a"},{"label":"Item B","id":"b"}]'
+ *   value='["b"]'
+ *   titles='["Source","Target"]'
+ *   searchable
+ * ></aithe-transfer>
+ * ```
  */
 export declare class AitheTransfer extends AitheElement {
+    /** JSON string of transfer item data. 穿梭框项目数据的 JSON 字符串。 */
     data: string;
+    /** JSON string of currently transferred values. 当前已转移值的 JSON 字符串。 */
     value: string;
+    /** JSON string of panel titles `[sourceTitle, targetTitle]`. 面板标题的 JSON 字符串 `[源标题, 目标标题]`。 */
     titles: string;
+    /** Whether panels support search/filter. 是否支持面板搜索过滤。 */
     searchable: boolean;
     private leftSelected;
     private rightSelected;

package/dist/components/form/transfer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../../src/components/form/transfer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AASxD;;GAEG;AACH,qBACa,aAAc,SAAQ,YAAY;IACjB,IAAI,SAAQ;IACZ,KAAK,SAAQ;IACb,MAAM,SAAyB;IAC9B,UAAU,UAAS;IAEvC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,UAAU,CAAM;IAEjC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA+DpB;IAEF,OAAO,KAAK,UAAU,GAMrB;IAED,OAAO,KAAK,WAAW,GAStB;IAED,OAAO,KAAK,YAAY,GAOvB;IAED,OAAO,KAAK,KAAK,GAKhB;IAED,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,IAAI;IAkBZ,OAAO,CAAC,MAAM;IAUd,MAAM;CAiEP"}
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../../src/components/form/transfer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUnD;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,4DAA4D;IAChC,IAAI,SAAQ;IACxC,qEAAqE;IACzC,KAAK,SAAQ;IACzC,8FAA8F;IAClE,MAAM,SAAM;IACxC,wDAAwD;IAC3B,UAAU,UAAS;IAEvC,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,UAAU,CAAM;IAEjC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA+DpB;IAEF,OAAO,KAAK,UAAU,GAMrB;IAED,OAAO,KAAK,WAAW,GAStB;IAED,OAAO,KAAK,YAAY,GAUvB;IAED,OAAO,KAAK,KAAK,GAKhB;IAED,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,IAAI;IAkBZ,OAAO,CAAC,MAAM;IAUd,MAAM;CAiFP"}

package/dist/components/form/upload.d.ts

@@ -1,16 +1,34 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
  * Local file picker with upload-like progress events.
+ * 本地文件选择器，支持类上传进度事件。
+ *
+ * @slot - Default slot for the upload trigger button label. 上传触发按钮标签内容。
+ * @fires aithe-change - Emitted when files are selected, with `{ files }`. 文件选择时触发。
+ * @fires aithe-progress - Emitted with upload progress, with `{ percent, files }`. 上传进度时触发。
+ * @fires aithe-success - Emitted when upload completes, with `{ files, url }`. 上传完成时触发。
+ *
+ * @example
+ * ```html
+ * <aithe-upload url="/api/upload" accept=".png,.jpg" multiple limit="3">
+ *   Choose files
+ * </aithe-upload>
+ * ```
  */
 export declare class AitheUpload extends AitheElement {
+    /** Upload target URL. 上传目标 URL。 */
     url: string;
+    /** Whether multiple files can be selected. 是否允许选择多个文件。 */
     multiple: boolean;
+    /** Accepted file types (MIME or extension). 接受的文件类型（MIME 或扩展名）。 */
     accept: string;
+    /** Maximum number of files allowed (0 = unlimited). 允许的最大文件数（0 = 不限）。 */
     limit: number;
+    /** Whether the upload is disabled. 是否禁用上传。 */
     disabled: boolean;
     private files;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
-    private handleFiles;
+    private readonly handleFiles;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=upload.d.ts.map

package/dist/components/form/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/components/form/upload.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;GAEG;AACH,qBACa,WAAY,SAAQ,YAAY;IACf,GAAG,SAAM;IACR,QAAQ,UAAS;IAClB,MAAM,SAAM;IACZ,KAAK,SAAK;IACM,QAAQ,UAAS;IAEpD,OAAO,CAAC,KAAK,CAAc;IAEpC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqCpB;IAEF,OAAO,CAAC,WAAW,CAOjB;IAEF,MAAM;CA6BP"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/components/form/upload.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;;;GAeG;AACH,qBACa,WAAY,SAAQ,YAAY;IAC3C,mCAAmC;IACP,GAAG,SAAM;IACrC,0DAA0D;IAC7B,QAAQ,UAAS;IAC9C,mEAAmE;IACvC,MAAM,SAAM;IACxC,yEAAyE;IAC7C,KAAK,SAAK;IACtC,8CAA8C;IACF,QAAQ,UAAS;IAEpD,OAAO,CAAC,KAAK,CAAc;IAEpC,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqCpB;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAO1B;IAEF,MAAM;CA6BP"}

package/dist/components/framework/AGENTS.md

@@ -0,0 +1,27 @@
+# src/components/framework/ — 框架组件（7个）
+
+## 组件列表
+
+| 组件                 | 标签                      | 说明                                       |
+| -------------------- | ------------------------- | ------------------------------------------ |
+| `header.ts`          | `<aithe-header>`          | 页头，含品牌、国际化/主题切换和插槽        |
+| `body.ts`            | `<aithe-body>`            | 页体，支持布局密度控制和浮动操作栏         |
+| `sidebar.ts`         | `<aithe-sidebar>`         | 侧边栏，含品牌、菜单树和操作按钮，支持伸缩 |
+| `page.ts`            | `<aithe-page>`            | 路由容器，渲染匹配到的页面组件             |
+| `log-panel.ts`       | `<aithe-log-panel>`       | 日志面板，支持级别过滤、搜索和远程上报     |
+| `dashboard.ts`       | `<aithe-dashboard>`       | 仪表盘容器，网格化面板布局                 |
+| `dashboard-panel.ts` | `<aithe-dashboard-panel>` | 仪表盘面板，含标题、内容和操作区           |
+
+## 编码规范
+
+- 继承 `AitheElement`，使用 `@customElement` 装饰器
+- 这些组件通常与 `src/core/router/` 配合使用
+- 导入使用 `@components/framework/xxx` 路径别名
+- 中英文双语 JSDoc 注释
+
+## 关键约定
+
+- `aithe-header` + `aithe-sidebar` + `aithe-body` + `aithe-page` 构成完整页面框架
+- 布局密度通过 `layout` 属性控制（`loose` / `medium` / `compact`）
+- `aithe-page` 配合路由系统使用，通过 `route` 属性匹配页面组件
+- 新增组件需同步更新 `src/index.ts` 和 `docs/api/framework/`

package/dist/components/framework/body.d.ts

@@ -0,0 +1,62 @@
+import { AitheElement } from '../../core/aithe-element';
+import type { AitheLayoutName } from '../../types';
+/**
+ * Framework-level page body that sits below `aithe-header`.
+ * 框架级页面主体区域，位于 `aithe-header` 下方。
+ *
+ * Provides layout density control (compact / medium / wide) that scales the content width,
+ * automatic scrolling, and a fixed floating action bar in the bottom-right corner.
+ * 提供布局密度控制（紧凑/适中/宽松）来缩放内容宽度，自动滚动，以及右下角固定的浮动操作栏。
+ *
+ * @slot - Default slot for page content. 默认插槽，用于页面内容。
+ * @slot actions - Extra action buttons in the floating bar (before built-in buttons). 浮动栏中的额外操作按钮（在内置按钮之前）。
+ *
+ * @fires aithe-layout-change - Emitted when layout density changes. 布局密度变更时发出，detail 包含 `{ layout: string }`。
+ *   Call `preventDefault()` to suppress the built-in layout switch. 调用 `preventDefault()` 可阻止内置切换逻辑。
+ *
+ * @example
+ * ```html
+ * <aithe-header brand="App" show-locale-switch show-theme-switch></aithe-header>
+ * <aithe-body show-actions>
+ *   <main>Your content here</main>
+ * </aithe-body>
+ * ```
+ */
+export declare class AitheBody extends AitheElement {
+    /** Current layout density. 布局密度。 */
+    layout: AitheLayoutName;
+    /** Whether to show the floating action bar. 是否显示浮动操作栏。 */
+    showActions: boolean;
+    /** Whether to show the "back to top" button in the action bar. 是否在操作栏中显示"回到顶部"按钮。 */
+    showBackTop: boolean;
+    /** Whether to show the "switch layout" button in the action bar. 是否在操作栏中显示"切换布局"按钮。 */
+    showLayoutSwitch: boolean;
+    /** Whether to show the log panel toggle button in the action bar. 是否在操作栏中显示日志面板按钮。 */
+    showLogPanel: boolean;
+    /** Scroll threshold in pixels before the back-to-top button appears. 回到顶部按钮出现前的滚动阈值（像素）。 */
+    visibilityHeight: number;
+    /** Mobile breakpoint in pixels; when viewport width ≤ this value, layout is forced to wide and layout-switch is hidden.
+     * 移动端断点（像素）；视口宽度 ≤ 此值时强制 wide 布局并隐藏布局切换按钮。 */
+    mobileBreakpoint: number;
+    private scrolledPastThreshold;
+    private isMobile;
+    logPanelOpen: boolean;
+    private unsubscribeLayout?;
+    private mql?;
+    private readonly _scrollEl?;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    connectedCallback(): void;
+    protected firstUpdated(): void;
+    disconnectedCallback(): void;
+    private setupMobileListener;
+    private readonly handleMobileChange;
+    protected updated(changed: Map<string, unknown>): void;
+    private applyLayoutWidth;
+    private readonly handleScroll;
+    private readonly handleBackTop;
+    private readonly handleLayoutSwitch;
+    private readonly handleLogPanelToggle;
+    private readonly handleLogPanelEvent;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=body.d.ts.map

package/dist/components/framework/body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../../../src/components/framework/body.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAiB9C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBACa,SAAU,SAAQ,YAAY;IACzC,oCAAoC;IACR,MAAM,EAAE,eAAe,CAAY;IAE/D,0DAA0D;IACF,WAAW,UAAS;IAE5E,qFAAqF;IAC5B,WAAW,UAAQ;IAE5E,uFAAuF;IACzB,gBAAgB,UAAQ;IAEtF,sFAAsF;IAC5B,YAAY,UAAS;IAE/E,4FAA4F;IAChC,gBAAgB,SAAO;IAEnF;kDAC8C;IACc,gBAAgB,SAAO;IAE1E,OAAO,CAAC,qBAAqB,CAAS;IAEtC,OAAO,CAAC,QAAQ,CAAS;IAEwB,YAAY,UAAS;IAE/E,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,GAAG,CAAC,CAAiB;IACN,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAc;IAEhE,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAwGpB;IAEF,iBAAiB,IAAI,IAAI;IAWzB,SAAS,CAAC,YAAY,IAAI,IAAI;IAI9B,oBAAoB,IAAI,IAAI;IAO5B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CASjC;IAEF,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAE3B;IAEF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAE5B;IAEF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAQjC;IAEF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAEnC;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAIlC;IAEF,MAAM;CA8DP"}