@aithe/aithe-ui 26.2.2

package/dist/src/components/feedback/notification.d.ts

@@ -0,0 +1,35 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Top-right notification card with auto-dismiss timer and close button.
+ * 右上角通知卡片，支持自动消失计时器和关闭按钮。
+ *
+ * @slot - Default slot (unused; content driven by `content` property). 默认插槽（未使用，内容由 content 属性控制）。
+ * @fires aithe-close - Emitted when the notification auto-dismisses or is manually closed. 通知自动消失或手动关闭时触发。
+ * @example
+ * ```html
+ * <aithe-notification title="Update" content="New version available" type="success" duration="3200"></aithe-notification>
+ * ```
+ */
+export declare class AitheNotification extends AitheElement {
+    /** Notification title text. 通知标题文本。 */
+    title: string;
+    /** Icon name to display before the title. 在标题前显示的图标名称。 */
+    icon: string;
+    /** Notification body text. 通知正文文本。 */
+    content: string;
+    /** Notification color variant. 通知颜色类型。 */
+    type: 'default' | 'success' | 'warning' | 'danger';
+    /** Auto-dismiss duration in milliseconds. 自动消失时长（毫秒）。 */
+    duration: number;
+    /** Whether the notification is visible. 是否显示通知。 */
+    open: boolean;
+    private timer;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(changed: Map<string, unknown>): void;
+    private startTimer;
+    private readonly close;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=notification.d.ts.map

package/dist/src/components/feedback/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../../../src/components/feedback/notification.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;;;;GAUG;AACH,qBACa,iBAAkB,SAAQ,YAAY;IACjD,uCAAuC;IACX,KAAK,SAAM;IACvC,0DAA0D;IAC9B,IAAI,SAAM;IACtC,sCAAsC;IACV,OAAO,SAAM;IACzC,0CAA0C;IACd,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAC3F,yDAAyD;IAC7B,QAAQ,SAAQ;IAC5C,mDAAmD;IACP,IAAI,UAAQ;IAExD,OAAO,CAAC,KAAK,CAAK;IAElB,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8DpB;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,UAAU;IAYlB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGpB;IAEF,MAAM;CAmBP"}

package/dist/src/components/feedback/popover.d.ts

@@ -0,0 +1,35 @@
+import type { PropertyValues } from 'lit';
+import { AitheAnchoredOverlayElement } from '../../core/anchored-overlay';
+/**
+ * Click-triggered popover panel anchored to a trigger element.
+ * 点击触发的弹出面板，锚定于触发元素。
+ *
+ * @slot - Default slot for the trigger element. 触发元素内容。
+ * @slot content - Custom popover content. 自定义弹出面板内容。
+ * @fires aithe-open-change - Emitted when open state changes, with `{ open }`. 开关状态变更时触发。
+ * @example
+ * ```html
+ * <aithe-popover placement="bottom">
+ *   <button>Click me</button>
+ *   <slot name="content"><p>Popover content here.</p></slot>
+ * </aithe-popover>
+ * ```
+ */
+export declare class AithePopover extends AitheAnchoredOverlayElement {
+    /** Popover placement relative to trigger. 弹出面板相对于触发元素的位置。 */
+    placement: 'top' | 'right' | 'bottom' | 'left';
+    private panel?;
+    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 popover on outside pointer events. 点击外部时关闭弹出面板。 */
+    private readonly handleOutsidePointer;
+    /** Closes popover on Escape key. 按 Escape 键关闭弹出面板。 */
+    private readonly handleDocumentKeydown;
+    /** Toggles popover open state. 切换弹出面板开关状态。 */
+    private readonly togglePanel;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=popover.d.ts.map

package/dist/src/components/feedback/popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../../../src/components/feedback/popover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAI1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAG1E;;;;;;;;;;;;;;GAcG;AACH,qBACa,YAAa,SAAQ,2BAA2B;IAC3D,6DAA6D;IACjC,SAAS,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAY;IAErE,OAAO,CAAC,KAAK,CAAC,CAAc;IAE7C,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAuBpB;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;IAOtD,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CASnC;IAEF,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IAEF,MAAM;CAmBP"}

package/dist/src/components/feedback/toast.d.ts

@@ -0,0 +1,35 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Auto-dismiss toast message displayed at the top of the viewport.
+ * 自动消失的轻提示消息，显示在视口顶部。
+ *
+ * @slot - Default slot (unused; content driven by `content` property). 默认插槽（未使用，内容由 content 属性控制）。
+ * @fires aithe-close - Emitted when the toast auto-dismisses after duration. 自动消失后触发。
+ * @example
+ * ```html
+ * <aithe-toast content="Saved successfully" type="success" duration="2400"></aithe-toast>
+ * ```
+ */
+export declare class AitheToast extends AitheElement {
+    /** Toast message text. 提示消息文本。 */
+    content: string;
+    /** Display title for the toast (shown as tooltip). 提示消息的显示标题（作为工具提示）。 */
+    title: string;
+    /** Icon name to display before the content. 在内容前显示的图标名称。 */
+    icon: string;
+    /** Toast color variant. 提示颜色类型。 */
+    type: 'default' | 'success' | 'warning' | 'danger';
+    /** Auto-dismiss duration in milliseconds. 自动消失时长（毫秒）。 */
+    duration: number;
+    /** Whether the toast is currently visible. 是否当前可见。 */
+    visible: boolean;
+    private timer;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(changed: Map<string, unknown>): void;
+    /** Starts the auto-dismiss timer. 启动自动消失计时器。 */
+    private startTimer;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=toast.d.ts.map

package/dist/src/components/feedback/toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../../src/components/feedback/toast.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;;;;GAUG;AACH,qBACa,UAAW,SAAQ,YAAY;IAC1C,kCAAkC;IACN,OAAO,SAAM;IACzC,yEAAyE;IAC7C,KAAK,SAAM;IACvC,4DAA4D;IAChC,IAAI,SAAM;IACtC,mCAAmC;IACP,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAC3F,yDAAyD;IAC7B,QAAQ,SAAQ;IAC5C,sDAAsD;IACV,OAAO,UAAQ;IAE3D,OAAO,CAAC,KAAK,CAAK;IAElB,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyCpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAMtD,gDAAgD;IAChD,OAAO,CAAC,UAAU;IAYlB,MAAM;CAeP"}

package/dist/src/components/feedback/tooltip.d.ts

@@ -0,0 +1,41 @@
+import type { PropertyValues } from 'lit';
+import { AitheAnchoredOverlayElement } from '../../core/anchored-overlay';
+/**
+ * Tooltip overlay that appears on hover/focus over an anchor element.
+ * 工具提示浮层，在悬停/聚焦锚点元素时显示。
+ *
+ * @slot - Default slot for the anchor element. 锚点元素内容。
+ * @slot content - Custom tooltip content (overrides `content` property). 自定义工具提示内容。
+ * @fires aithe-open-change - Inherited from AnchoredOverlay; emitted on open state change. 开关状态变更时触发。
+ * @example
+ * ```html
+ * <aithe-tooltip content="Help text here" placement="top">
+ *   <button>Hover me</button>
+ * </aithe-tooltip>
+ * ```
+ */
+export declare class AitheTooltip extends AitheAnchoredOverlayElement {
+    /** Tooltip text content. 工具提示文本内容。 */
+    content: string;
+    /** Display title for the tooltip anchor (shown as native tooltip). 工具提示锚点的显示标题（作为原生工具提示）。 */
+    title: string;
+    /** Icon name to display before the tooltip content. 在工具提示内容前显示的图标名称。 */
+    icon: string;
+    /** Tooltip placement relative to anchor. 工具提示相对于锚点的位置。 */
+    placement: 'top' | 'right' | 'bottom' | 'left';
+    private tooltip?;
+    private readonly tooltipId;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    protected get panelElement(): HTMLElement | null;
+    protected updated(changed: PropertyValues<this>): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /** Shows the tooltip on hover/focus. 悬停/聚焦时显示工具提示。 */
+    private readonly showTooltip;
+    /** Hides the tooltip on unhover/unfocus. 取消悬停/聚焦时隐藏工具提示。 */
+    private readonly hideTooltip;
+    /** Hides tooltip on Escape key. 按 Escape 键隐藏工具提示。 */
+    private readonly handleKeydown;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=tooltip.d.ts.map

package/dist/src/components/feedback/tooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooltip.d.ts","sourceRoot":"","sources":["../../../../src/components/feedback/tooltip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAI1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAI1E;;;;;;;;;;;;;GAaG;AACH,qBACa,YAAa,SAAQ,2BAA2B;IAC3D,sCAAsC;IACV,OAAO,SAAM;IACzC,6FAA6F;IACjE,KAAK,SAAM;IACvC,wEAAwE;IAC5C,IAAI,SAAM;IACtC,0DAA0D;IAC9B,SAAS,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAS;IAEhE,OAAO,CAAC,OAAO,CAAC,CAAc;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAElD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8BpB;IAEF,SAAS,KAAK,YAAY,IAAI,WAAW,GAAG,IAAI,CAE/C;IAED,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAatD,iBAAiB,IAAI,IAAI;IASzB,oBAAoB,IAAI,IAAI;IAS5B,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IAEF,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAE1B;IAEF,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAI5B;IAEF,MAAM;CAmBP"}

package/dist/src/components/form/checkbox-group.d.ts

@@ -0,0 +1,38 @@
+import { AitheElement } from '../../core/aithe-element';
+/**
+ * Checkbox group container that manages collective checked values.
+ * 复选框组容器，管理所有子复选框的选中值集合。
+ *
+ * @slot - Default slot for aithe-checkbox children. 子复选框内容。
+ * @fires aithe-change - Emitted when the group value changes, with `value: string[]`. 组值变更时触发。
+ * @example
+ * ```html
+ * <aithe-checkbox-group value='["a","b"]' name="options">
+ *   <aithe-checkbox value="a">Option A</aithe-checkbox>
+ *   <aithe-checkbox value="b">Option B</aithe-checkbox>
+ * </aithe-checkbox-group>
+ * ```
+ */
+export declare class AitheCheckboxGroup extends AitheElement {
+    /** JSON string of the current checked values. 当前选中值的 JSON 字符串。 */
+    valueJson: string;
+    /** Array of currently checked values. 当前选中值数组。 */
+    value: string[];
+    /** Whether all child checkboxes are disabled. 是否禁用所有子复选框。 */
+    disabled: boolean;
+    /** Name attribute propagated to child checkboxes. 传递给子复选框的 name 属性。 */
+    name: string;
+    private nodes;
+    /** Parses valueJson into the value array on property change. 属性变更时将 valueJson 解析为 value 数组。 */
+    protected willUpdate(changed: Map<string, unknown>): void;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changed: Map<string, unknown>): void;
+    /** Syncs checked/disabled/name state to child checkboxes. 将选中/禁用/name 状态同步到子复选框。 */
+    private readonly syncChildren;
+    /** Handles child checkbox toggle and updates group value. 处理子复选框切换并更新组值。 */
+    private readonly handleToggle;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=checkbox-group.d.ts.map

package/dist/src/components/form/checkbox-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-group.d.ts","sourceRoot":"","sources":["../../../../src/components/form/checkbox-group.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD;;;;;;;;;;;;;GAaG;AACH,qBACa,kBAAmB,SAAQ,YAAY;IAClD,kEAAkE;IAClB,SAAS,SAAM;IAC/D,kDAAkD;IAClB,KAAK,EAAE,MAAM,EAAE,CAAM;IACrD,6DAA6D;IAChC,QAAQ,UAAS;IAC9C,uEAAuE;IAC3C,IAAI,SAAM;IAEb,OAAO,CAAC,KAAK,CAAa;IAEnD,+FAA+F;IAC/F,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUzD,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,oFAAoF;IACpF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAW3B;IAEF,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAe3B;IAEF,MAAM;CAKP"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.d.ts","sourceRoot":"","sources":["../../../../src/components/form/checkbox.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;;;;;GAWG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,6CAA6C;IACD,OAAO,UAAS;IAC5D,+EAA+E;IAClD,aAAa,UAAS;IACnD,8CAA8C;IACF,QAAQ,UAAS;IAC7D,qEAAqE;IACzC,KAAK,SAAM;IACvC,yDAAyD;IAC7B,IAAI,SAAM;IACtC,4EAA4E;IAC5C,aAAa,UAAS;IAEtC,OAAO,CAAC,KAAK,CAAC,CAAmB;IAEjD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyBpB;IAEF,oFAAoF;IACpF,OAAO,IAAI,IAAI;IAMf,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAW3B;IAEF,MAAM;CAiBP"}

package/dist/src/components/form/color-picker.d.ts

@@ -0,0 +1,32 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Color picker built on native color input with optional alpha channel.
+ * 基于原生颜色输入的颜色选择器，支持可选的透明度通道。
+ *
+ * @slot - Default slot (unused; picker is self-contained). 默认插槽（未使用，选择器为自包含组件）。
+ * @fires aithe-change - Emitted when the color or alpha value changes, with `{ value, alpha, format }`. 颜色或透明度变更时触发。
+ *
+ * @example
+ * ```html
+ * <aithe-color-picker value="#4d8dff" format="hex"></aithe-color-picker>
+ * <aithe-color-picker alpha alpha-value="0.8"></aithe-color-picker>
+ * ```
+ */
+export declare class AitheColorPicker extends AitheElement {
+    /** Current color value. 当前颜色值。 */
+    value: string;
+    /** Output color format. 输出颜色格式。 */
+    format: 'hex' | 'rgb';
+    /** Whether to show the alpha (opacity) slider. 是否显示透明度滑块。 */
+    alpha: boolean;
+    /** Alpha (opacity) value from 0 to 1. 透明度值，范围 0 到 1。 */
+    alphaValue: number;
+    /** Whether the color picker is disabled. 是否禁用颜色选择器。 */
+    disabled: boolean;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    private emitChange;
+    private readonly handleColor;
+    private readonly handleAlpha;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=color-picker.d.ts.map

package/dist/src/components/form/color-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-picker.d.ts","sourceRoot":"","sources":["../../../../src/components/form/color-picker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGxD;;;;;;;;;;;;GAYG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IAChD,kCAAkC;IACN,KAAK,SAAa;IAC9C,mCAAmC;IACP,MAAM,EAAE,KAAK,GAAG,KAAK,CAAS;IAC1D,6DAA6D;IAChC,KAAK,UAAS;IAC3C,wDAAwD;IACF,UAAU,SAAK;IACrE,uDAAuD;IACX,QAAQ,UAAS;IAE7D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA4CpB;IAEF,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAG1B;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAG1B;IAEF,MAAM;CAgCP"}

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

@@ -0,0 +1,45 @@
+import { AitheElement } from '../../base/aithe-element';
+/**
+ * Filterable input + option list combobox.
+ * 可过滤的输入框 + 选项列表组合框。
+ *
+ * @slot - Default slot (unused; combobox is self-contained). 默认插槽（未使用，组合框为自包含组件）。
+ * @fires aithe-change - Emitted when an option is selected, with `{ value, option }`. 选中选项时触发。
+ * @fires aithe-input - Emitted on every keystroke, with `{ value }`. 每次按键时触发。
+ *
+ * @example
+ * ```html
+ * <aithe-combobox
+ *   options='[{"label":"Apple","id":"apple"},{"label":"Banana","id":"banana"}]'
+ *   filterable
+ * ></aithe-combobox>
+ * ```
+ */
+export declare class AitheCombobox extends AitheElement {
+    /** Current input value. 当前输入值。 */
+    value: string;
+    /** Display title for the combobox (shown as tooltip). 组合框的显示标题（作为工具提示）。 */
+    title: string;
+    /** Icon name to display before the input. 在输入框前显示的图标名称。 */
+    icon: string;
+    /** JSON string of combobox options. 组合框选项的 JSON 字符串。 */
+    options: string;
+    /** Whether the input supports filtering options. 是否支持过滤选项。 */
+    filterable: boolean;
+    /** Whether the combobox is disabled. 是否禁用组合框。 */
+    disabled: boolean;
+    /** Placeholder text for the input. 输入框的占位文本。 */
+    placeholder: string;
+    private open;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private get parsedOptions();
+    private get filteredOptions();
+    private readonly handleDocumentPointer;
+    private readonly handleInput;
+    private selectOption;
+    render(): import("lit-html").TemplateResult<1>;
+    private renderOptionList;
+}
+//# sourceMappingURL=combobox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../../src/components/form/combobox.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAYxD;;;;;;;;;;;;;;;GAeG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C,kCAAkC;IACN,KAAK,SAAM;IACvC,2EAA2E;IAC/C,KAAK,SAAM;IACvC,2DAA2D;IAC/B,IAAI,SAAM;IACtC,wDAAwD;IAC5B,OAAO,SAAQ;IAC3C,8DAA8D;IACjC,UAAU,UAAQ;IAC/C,iDAAiD;IACL,QAAQ,UAAS;IAC7D,gDAAgD;IACpB,WAAW,SAAM;IAEpC,OAAO,CAAC,IAAI,CAAS;IAE9B,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA8FpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,KAAK,aAAa,GAOxB;IAED,OAAO,KAAK,eAAe,GAQ1B;IAED,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAIpC;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI1B;IAEF,OAAO,CAAC,YAAY;IAMpB,MAAM;IA0BN,OAAO,CAAC,gBAAgB;CAwBzB"}

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

@@ -0,0 +1,30 @@
+import { AitheElement } from '../../base/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;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=date-picker.d.ts.map

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

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

@@ -0,0 +1,34 @@
+import { AitheElement } from '../../base/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>;
+}
+//# sourceMappingURL=form-item.d.ts.map

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

@@ -0,0 +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;AAIxD;;;;;;;;;;;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;IAkBnB,MAAM;CAgCP"}

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

@@ -0,0 +1,32 @@
+import { AitheElement } from '../../base/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 {
+    /** 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;
+    /** Handles form submit: validates then emits submit event on success. 处理表单提交：校验成功后触发 submit 事件。 */
+    private readonly handleSubmit;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=form.d.ts.map

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

@@ -0,0 +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;IACzC,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;IAqBrB,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAS3B;IAEF,MAAM;CAOP"}

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

@@ -0,0 +1,34 @@
+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;
+    updated(changed: Map<string, unknown>): void;
+    /** 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/src/components/form/radio-group.d.ts.map

@@ -0,0 +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;;;;;;;;;;;;;GAaG;AACH,qBACa,eAAgB,SAAQ,YAAY;IAC/C,gDAAgD;IACpB,KAAK,SAAM;IACvC,0DAA0D;IAC7B,QAAQ,UAAS;IAC9C,oEAAoE;IACxC,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,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAW3B;IAEF,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAW3B;IAEF,MAAM;CAKP"}

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

@@ -0,0 +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[])[];
+    /** 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/src/components/form/radio.d.ts.map

@@ -0,0 +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;;;;;;;;;;;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,CAU3B;IAEF,MAAM;CAiBP"}

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

@@ -0,0 +1,27 @@
+import { AitheElement } from '../../base/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;
+    render(): import("lit-html").TemplateResult<1>;
+}
+//# sourceMappingURL=rate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rate.d.ts","sourceRoot":"","sources":["../../../../src/components/form/rate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIxD;;;;;;;;;;;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/src/components/form/select.d.ts

@@ -0,0 +1,74 @@
+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 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;
+    protected get anchorElement(): HTMLElement;
+    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();
+    /** 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;
+    /** 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