@aithe/aithe-ui 26.2.2 → 26.2.3

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

@@ -1,16 +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?;
+    private readonly 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;
-    private handleOutsidePointer;
-    private handleDocumentKeydown;
-    private togglePanel;
+    /** 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/components/feedback/popover.d.ts.map

@@ -1 +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,qBACa,YAAa,SAAQ,2BAA2B;IAC/B,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,OAAO,CAAC,oBAAoB,CAS1B;IAEF,OAAO,CAAC,qBAAqB,CAI3B;IAEF,OAAO,CAAC,WAAW,CAEjB;IAEF,MAAM;CAcP"}
+{"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,wBAAwB,CAAC;AAGrE;;;;;;;;;;;;;;GAcG;AACH,qBACa,YAAa,SAAQ,2BAA2B;IAC3D,6DAA6D;IACjC,SAAS,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAY;IAErE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;IAEtD,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/components/feedback/toast.d.ts

@@ -1,17 +1,34 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Auto-dismiss toast message.
+ * 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>;
 }

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

@@ -1 +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;;GAEG;AACH,qBACa,UAAW,SAAQ,YAAY;IACd,OAAO,SAAM;IACb,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAa;IAC/D,QAAQ,SAAQ;IACA,OAAO,UAAQ;IAE3D,OAAO,CAAC,KAAK,CAAK;IAElB,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAiCpB;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,MAAM;CAKP"}
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../src/components/feedback/toast.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;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/components/feedback/tooltip.d.ts

@@ -1,18 +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 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;
-    private showTooltip;
-    private hideTooltip;
-    private handleKeydown;
+    /** 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/components/feedback/tooltip.d.ts.map

@@ -1 +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,qBACa,YAAa,SAAQ,2BAA2B;IAC/B,OAAO,SAAM;IACb,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,0DAsBpB;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,OAAO,CAAC,WAAW,CAEjB;IAEF,OAAO,CAAC,WAAW,CAEjB;IAEF,OAAO,CAAC,aAAa,CAInB;IAEF,MAAM;CAYP"}
+{"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,wBAAwB,CAAC;AAMrE;;;;;;;;;;;;;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,QAAQ,CAAC,OAAO,CAAC,CAAc;IAC1D,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/components/form/AGENTS.md

@@ -0,0 +1,39 @@
+# src/components/form/ — 表单组件（18个）
+
+## 组件列表
+
+| 组件                | 标签                     | 说明                              |
+| ------------------- | ------------------------ | --------------------------------- |
+| `autoform.ts`       | `<aithe-autoform>`       | JSON 驱动的自动表单，支持联动规则 |
+| `autoform-item.ts`  | `<aithe-autoform-item>`  | 自动表单项，三段式布局            |
+| `checkbox.ts`       | `<aithe-checkbox>`       | 复选框                            |
+| `checkbox-group.ts` | `<aithe-checkbox-group>` | 复选框组                          |
+| `radio.ts`          | `<aithe-radio>`          | 单选框                            |
+| `radio-group.ts`    | `<aithe-radio-group>`    | 单选框组                          |
+| `select.ts`         | `<aithe-select>`         | 下拉选择器，单选/多选             |
+| `switch.ts`         | `<aithe-switch>`         | 开关切换                          |
+| `color-picker.ts`   | `<aithe-color-picker>`   | 颜色选择器                        |
+| `combobox.ts`       | `<aithe-combobox>`       | 组合框，可搜索下拉带自由输入      |
+| `date-picker.ts`    | `<aithe-date-picker>`    | 日期选择器                        |
+| `time-picker.ts`    | `<aithe-time-picker>`    | 时间选择器                        |
+| `slider.ts`         | `<aithe-slider>`         | 滑块，数值范围选择                |
+| `rate.ts`           | `<aithe-rate>`           | 评分，星级评分                    |
+| `form.ts`           | `<aithe-form>`           | 表单容器，带验证                  |
+| `form-item.ts`      | `<aithe-form-item>`      | 表单项，带标签和验证              |
+| `upload.ts`         | `<aithe-upload>`         | 文件上传                          |
+| `transfer.ts`       | `<aithe-transfer>`       | 穿梭框，双列表数据转移            |
+
+## 编码规范
+
+- 继承 `AitheElement`，使用 `@customElement` 装饰器
+- 表单组件通过 `value` 属性和 `aithe-change` 事件实现双向绑定
+- 验证通过 `rules` 属性或 `form` 容器统一管理
+- 导入使用 `@components/form/xxx` 路径别名
+- 中英文双语 JSDoc 注释
+
+## 关键约定
+
+- `aithe-form` 通过 `ref` 获取表单实例，调用 `validate()` / `reset()` 方法
+- `aithe-autoform` 的 JSON Schema 定义在 `docs/autoform.md` 中详细说明
+- 日期/时间选择器内部依赖 `floating` 模块做面板定位
+- 新增组件需同步更新 `src/index.ts` 和 `docs/api/form/`

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

@@ -0,0 +1,142 @@
+/**
+ * @file JSON-driven auto form item / JSON 驱动的自动表单项
+ * @description 单个表单项容器，固定三段式布局：顶部（图标+label+tooltip）、
+ *              中部（输入控件）、底部（description+校验错误提示）。
+ *              Single form item container with fixed three-section layout:
+ *              top (icon + label + tooltip), middle (input control),
+ *              bottom (description + validation error).
+ */
+import { nothing } from 'lit';
+import { AitheElement } from '../../core/aithe-element';
+import type { FormRule, FormItemOption } from '../../core/autoform';
+import '../display/label.js';
+/**
+ * JSON-driven auto form item with three-section layout and validation.
+ * JSON 驱动的自动表单项，三段式布局，支持校验。
+ *
+ * @slot - Default slot for the form control element. 表单控件元素内容。
+ * ### Events
+ * - **aithe-change** — Emitted when the field value changes, with `{ name, value }`. 字段值变更时触发。
+ * @example
+ * ```html
+ * <aithe-autoform-item
+ *   name="email"
+ *   type="input"
+ *   label="Email"
+ *   icon="mail"
+ *   tooltip="Your work email"
+ *   description="We will never share your email."
+ *   required
+ * ></aithe-autoform-item>
+ * ```
+ */
+export declare class AitheAutoformItem extends AitheElement {
+    /** Field unique identifier. 字段唯一标识。 */
+    name: string;
+    /** Control type: input | textarea | select | radio | checkbox | switch | number | slider | date-picker | time-picker | rate | color-picker. 控件类型。 */
+    type: AutoformItemType;
+    /** Label text. 标签文本。 */
+    label: string;
+    /** Icon name displayed before the label. 标签前显示的图标名称。 */
+    icon: string;
+    /** Tooltip text shown on hover. 悬停提示文本。 */
+    tooltip: string;
+    /** Description text below the control. 控件下方的说明文字。 */
+    description: string;
+    /** Default value. 缺省值。 */
+    dft: string;
+    /** Placeholder text. 占位提示文本。 */
+    placeholder: string;
+    /** Whether the field is disabled. 是否禁用。 */
+    disabled: boolean;
+    /** Whether the field is required. 是否必填。 */
+    required: boolean;
+    /** Validation regex pattern string. 校验正则表达式字符串。 */
+    pattern: string;
+    /** Validation failure message. 校验失败提示语。 */
+    message: string;
+    /** Options for select/radio/checkbox. 选择类控件的选项。 */
+    options: FormItemOption[];
+    /** Current field value. 当前字段值。 */
+    value: string;
+    /** Input type attribute for type="input". input 控件的 type 属性。 */
+    inputType: string;
+    /** Minimum value for number/slider. 数字/滑块最小值。 */
+    min: string;
+    /** Maximum value for number/slider. 数字/滑块最大值。 */
+    max: string;
+    /** Step value for number/slider/rate. 数字/滑块/评分步长。 */
+    step: string;
+    /** Number of rows for textarea. 文本域行数。 */
+    rows: string;
+    /** Whether to validate on every change. 是否在每次变更时实时校验。 */
+    validateOnChange: boolean;
+    /** Internal validation error message. 内部校验错误消息。 */
+    private errorMsg;
+    /** Dependency field names. 依赖字段名称列表。 */
+    dependencies: string[];
+    /** Dependency rules. 依赖联动规则。 */
+    rules: FormRule[];
+    /** Current values of dependency fields. 依赖字段的当前值。 */
+    dependencyValues: Record<string, unknown>;
+    /** Whether the field is visible (controlled by dependency rules). 字段是否可见（由依赖规则控制）。 */
+    private _visible;
+    /** Whether the field is disabled by dependency rules. 是否被依赖规则禁用。 */
+    private _ruleDisabled;
+    /** Options computed by dependency rules. 依赖规则计算的选项。 */
+    private _ruleOptions;
+    /** Whether the field is visible (controlled by dependency rules). 字段是否可见（由依赖规则控制）。 */
+    get visible(): boolean;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    /** Initializes value from default if empty. 初始化时若值为空则使用缺省值。 */
+    connectedCallback(): void;
+    private pendingClear;
+    /** Applies dependency rules when dependencyValues or rules change. Also emits change after a clear rule resets the value. 依赖值或规则变更时应用联动规则，clear 规则重置值后触发 change 事件。 */
+    protected updated(changed: Map<string, unknown>): void;
+    /** Evaluates all dependency rules and updates visibility, disabled state, options, and value accordingly. 评估所有依赖规则，更新可见性、禁用状态、选项和值。 */
+    private applyRules;
+    /** Validates the field and sets error state. Skips validation if hidden. 校验字段并设置错误状态，隐藏时跳过校验。 */
+    validate(): boolean;
+    /** Clears the validation error. 清除校验错误。 */
+    clearError(): void;
+    /** Returns the current validation error message. 返回当前校验错误消息。 */
+    getError(): string;
+    /** Returns the current field value. 返回当前字段值。 */
+    getFieldValue(): unknown;
+    /** Handles input/textarea/number change events. 处理 input/textarea/number 的变更事件。 */
+    private readonly handleInputChange;
+    /** Handles switch toggle change. 处理开关组件的切换事件。 */
+    private readonly handleSwitchChange;
+    /** Handles select dropdown change. 处理下拉选择器的变更事件。 */
+    private readonly handleSelectChange;
+    /** Handles radio group selection change. 处理单选框组的变更事件。 */
+    private readonly handleRadioChange;
+    /** Handles checkbox group change, serializes selected values to JSON string. 处理复选框组的变更事件，将选中值序列化为 JSON 字符串。 */
+    private readonly handleCheckboxChange;
+    /** Handles slider value change. 处理滑块组件的变更事件。 */
+    private readonly handleSliderChange;
+    /** Handles rate component value change. 处理评分组件的变更事件。 */
+    private readonly handleRateChange;
+    /** Handles color picker value change. 处理颜色选择器的变更事件。 */
+    private readonly handleColorPickerChange;
+    /** Handles date picker value change. 处理日期选择器的变更事件。 */
+    private readonly handleDatePickerChange;
+    /** Handles time picker value change. 处理时间选择器的变更事件。 */
+    private readonly handleTimePickerChange;
+    /** Handles combobox value change. 处理组合框的变更事件。 */
+    private readonly handleComboboxChange;
+    /** Renders the appropriate form control based on type. Falls back to input for unknown types. 根据控件类型渲染对应的表单控件，未知类型回退为 input。 */
+    private renderControl;
+    /** Renders radio button options for radio group. 渲染单选框组的选项。 */
+    private renderRadioOptions;
+    /** Renders checkbox options for checkbox group. 渲染复选框组的选项。 */
+    private renderCheckboxOptions;
+    /** Parses checkbox value from JSON string or array to a string array. 将复选框值从 JSON 字符串或数组解析为字符串数组。 */
+    private parseCheckboxValue;
+    render(): import("lit-html").TemplateResult<1> | typeof nothing;
+}
+/** Autoform item control type. Built-in types plus any custom registered type. 自动表单项控件类型，包含内置类型和自定义注册类型。 */
+export type AutoformItemType = 'input' | 'textarea' | 'select' | 'radio' | 'checkbox' | 'switch' | 'number' | 'slider' | 'rate' | 'color-picker' | 'date-picker' | 'time-picker' | 'combobox' | string;
+/** Autoform item option for select/radio/checkbox. 选择类控件选项。 */
+export type { FormItemOption } from '../../core/autoform';
+//# sourceMappingURL=autoform-item.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"autoform-item.d.ts","sourceRoot":"","sources":["../../../src/components/form/autoform-item.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,90 @@
+import { AitheElement } from '../../core/aithe-element';
+/**
+ * JSON-driven auto form that renders form items from a configuration array.
+ * JSON 驱动的自动表单，根据配置数组自动渲染表单项。
+ *
+ * @slot - Default slot for custom actions below the auto-generated items. Replaces the built-in submit button when provided. 自动生成项下方的自定义操作区域，传入内容后将替换内置提交按钮。
+ * ### Events
+ * - **aithe-validate** — Emitted after validation, with `{ valid, errors }`. 校验完成后触发。
+ * - **aithe-submit** — Emitted on valid form submission, with `{ values }`. 有效表单提交时触发。
+ * - **aithe-change** — Emitted when any field value changes, with `{ name, value }`. 任意字段值变更时触发。
+ * @example
+ * ```html
+ * <aithe-autoform
+ *   fields='[
+ *     {"name":"username","type":"input","label":"Username","icon":"user","required":true,"placeholder":"Enter username"},
+ *     {"name":"role","type":"select","label":"Role","options":"[{\\"label\\":\\"Admin\\",\\"id\\":\\"admin\\"}]"}
+ *   ]'
+ * ></aithe-autoform>
+ * ```
+ */
+export declare class AitheAutoform extends AitheElement {
+    /**
+     * JSON string of field configuration array.
+     * 字段配置数组的 JSON 字符串。
+     *
+     * Each field object supports:
+     * - name (string, required): Field unique identifier
+     * - type (string): Control type — input|textarea|select|radio|checkbox|switch|number|slider|rate|color-picker|date-picker|time-picker|combobox
+     * - label (string): Label text
+     * - icon (string): Icon name before label
+     * - tooltip (string): Hover tooltip text
+     * - description (string): Description below control
+     * - dft (string): Default value
+     * - placeholder (string): Placeholder text
+     * - disabled (boolean): Whether disabled
+     * - required (boolean): Whether required
+     * - pattern (string): Validation regex pattern
+     * - message (string): Validation failure message
+     * - options (string): JSON string of options for select/radio/checkbox
+     * - inputType (string): HTML input type for type="input"
+     * - min (string): Min value for number/slider
+     * - max (string): Max value for number/slider
+     * - step (string): Step for number/slider/rate
+     * - rows (string): Rows for textarea
+     * - dependencies (string[]): Names of fields this field depends on
+     * - rules (array): Dependency rules — each rule has { type, condition?, options? }
+     *   - type: 'show'|'hide'|'disable'|'enable'|'clear'|'update'
+     *   - condition: Expression like "province !== ''" (optional, defaults to true)
+     *   - options: JSON string of options for 'update' rule
+     */
+    fields: string;
+    /** Whether to validate on every field change. 是否在每次字段变更时实时校验。 */
+    validateOnChange: boolean;
+    /** Submit button text. 提交按钮文本。 */
+    submitText: string;
+    /** Whether the form is in a submitting state. 表单是否处于提交中状态。 */
+    loading: boolean;
+    private readonly formItems;
+    private readonly actionNodes;
+    private hasActionSlot;
+    /** Current values of all fields, used for dependency resolution. 所有字段的当前值，用于依赖联动计算。 */
+    private fieldValues;
+    static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    /** Validates all form items and emits validate event. Skips hidden fields. 校验所有表单项并触发 validate 事件，跳过隐藏字段。 */
+    validate(): boolean;
+    /** Collects all field values as a key-value object. Excludes hidden fields. 收集所有字段值为键值对象，排除隐藏字段。 */
+    getValues(): Record<string, unknown>;
+    /** Resets all fields to their default values and clears errors. 重置所有字段为缺省值并清除错误。 */
+    reset(): void;
+    /** Handles value change from a child autoform-item, updates fieldValues state and emits aithe-change. 处理子表单项的值变更，更新 fieldValues 状态并触发 aithe-change 事件。 */
+    private readonly handleItemChange;
+    /** Syncs the action slot state — hides the built-in submit button when custom action content is provided. 同步 action slot 状态，当提供了自定义操作内容时隐藏内置提交按钮。 */
+    private readonly syncActionSlot;
+    /** Handles form submit: validates all fields, emits aithe-submit if valid. 处理表单提交：校验所有字段，通过后触发 aithe-submit 事件。 */
+    private readonly handleSubmit;
+    /** Parses the fields JSON string into a typed configuration array. Falls back to sanitized JSON on first parse failure. 解析 fields JSON 字符串为类型化配置数组，首次解析失败时尝试清理后重新解析。 */
+    private parseFields;
+    /** Normalizes options from JSON string or array to a uniform FormItemOption array. 将 JSON 字符串或数组格式的选项统一为 FormItemOption 数组。 */
+    private normalizeOptions;
+    /** Normalizes dependency rules, parsing options for 'update' type rules. 规范化依赖联动规则，为 update 类型规则解析 options。 */
+    private normalizeRules;
+    render(): import("lit-html").TemplateResult<1>;
+}
+/** Autoform rule type. 自动表单规则类型。 */
+export type { FormRuleType } from '../../core/autoform';
+/** Autoform dependency rule. 自动表单依赖联动规则。 */
+export type { FormRule } from '../../core/autoform';
+/** Autoform field configuration. 自动表单字段配置。 */
+export type { FormFieldConfig } from '../../core/autoform';
+//# sourceMappingURL=autoform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"autoform.d.ts","sourceRoot":"","sources":["../../../src/components/form/autoform.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,aAAc,SAAQ,YAAY;IAC7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACyB,MAAM,SAAQ;IAE1C,iEAAiE;IACH,gBAAgB,UAAQ;IAEtF,kCAAkC;IACoB,UAAU,SAAM;IAEtE,8DAA8D;IAClB,OAAO,UAAS;IAG5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAElC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAE7D,OAAO,CAAC,aAAa,CAAS;IAEvC,uFAAuF;IAC9E,OAAO,CAAC,WAAW,CAA+B;IAE3D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAqBpB;IAEF,6GAA6G;IAC7G,QAAQ,IAAI,OAAO;IAkBnB,oGAAoG;IACpG,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYpC,oFAAoF;IACpF,KAAK,IAAI,IAAI;IAWb,0JAA0J;IAC1J,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAK/B;IAEF,qJAAqJ;IACrJ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE7B;IAEF,mHAAmH;IACnH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAO3B;IAEF,wKAAwK;IACxK,OAAO,CAAC,WAAW;IAcnB,+HAA+H;IAC/H,OAAO,CAAC,gBAAgB;IAaxB,+GAA+G;IAC/G,OAAO,CAAC,cAAc;IAWtB,MAAM;CAyDP;AAED,oCAAoC;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,4CAA4C;AAC5C,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,8CAA8C;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -1,17 +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;
+    private readonly 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;
-    private syncChildren;
-    private handleToggle;
+    /** 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/components/form/checkbox-group.d.ts.map

@@ -1 +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,qBACa,kBAAmB,SAAQ,YAAY;IACF,SAAS,SAAM;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAM;IACxB,QAAQ,UAAS;IAClB,IAAI,SAAM;IAEb,OAAO,CAAC,KAAK,CAAa;IAEnD,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,OAAO,CAAC,YAAY,CAUlB;IAEF,OAAO,CAAC,YAAY,CAalB;IAEF,MAAM;CAGP"}
+{"version":3,"file":"checkbox-group.d.ts","sourceRoot":"","sources":["../../../src/components/form/checkbox-group.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD;;;;;;;;;;;;;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,QAAQ,CAAC,KAAK,CAAa;IAE5D,+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,CAU3B;IAEF,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAe3B;IAEF,MAAM;CAKP"}

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

@@ -1,15 +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?;
+    private readonly input?;
     static readonly styles: (import("lit").CSSResult | import("lit").CSSResult[])[];
+    /** Syncs the native input indeterminate property. 同步原生 input 的 indeterminate 属性。 */
     updated(): void;
-    private handleChange;
+    /** 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/components/form/checkbox.d.ts.map

@@ -1 +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,qBACa,aAAc,SAAQ,YAAY;IACD,OAAO,UAAS;IAC/B,aAAa,UAAS;IACP,QAAQ,UAAS;IACjC,KAAK,SAAM;IACX,IAAI,SAAM;IACN,aAAa,UAAS;IAEtC,OAAO,CAAC,KAAK,CAAC,CAAmB;IAEjD,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAyBpB;IAEF,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,YAAY,CAWlB;IAEF,MAAM;CAiBP"}
+{"version":3,"file":"checkbox.d.ts","sourceRoot":"","sources":["../../../src/components/form/checkbox.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;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,QAAQ,CAAC,KAAK,CAAC,CAAmB;IAE1D,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/components/form/color-picker.d.ts

@@ -1,17 +1,32 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/aithe-element';
 /**
- * Color picker built on native color input.
+ * 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 handleColor;
-    private handleAlpha;
+    private readonly handleColor;
+    private readonly handleAlpha;
     render(): import("lit-html").TemplateResult<1>;
 }
 //# sourceMappingURL=color-picker.d.ts.map

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

@@ -1 +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;;GAEG;AACH,qBACa,gBAAiB,SAAQ,YAAY;IACpB,KAAK,SAAa;IAClB,MAAM,EAAE,KAAK,GAAG,KAAK,CAAS;IAC7B,KAAK,UAAS;IACW,UAAU,SAAK;IACzB,QAAQ,UAAS;IAE7D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DA4CpB;IAEF,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,WAAW,CAGjB;IAEF,OAAO,CAAC,WAAW,CAGjB;IAEF,MAAM;CA2BP"}
+{"version":3,"file":"color-picker.d.ts","sourceRoot":"","sources":["../../../src/components/form/color-picker.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;;;;;;;;;;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/components/form/combobox.d.ts

@@ -1,12 +1,34 @@
-import { AitheElement } from '../../base/aithe-element';
+import { AitheElement } from '../../core/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[])[];
@@ -14,9 +36,10 @@ export declare class AitheCombobox extends AitheElement {
     disconnectedCallback(): void;
     private get parsedOptions();
     private get filteredOptions();
-    private handleDocumentPointer;
-    private handleInput;
+    private readonly handleDocumentPointer;
+    private readonly handleInput;
     private selectOption;
     render(): import("lit-html").TemplateResult<1>;
+    private renderOptionList;
 }
 //# sourceMappingURL=combobox.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../src/components/form/combobox.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAQxD;;GAEG;AACH,qBACa,aAAc,SAAQ,YAAY;IACjB,KAAK,SAAM;IACX,OAAO,SAAQ;IACd,UAAU,UAAQ;IACH,QAAQ,UAAS;IACjC,WAAW,SAAsB;IAEpD,OAAO,CAAC,IAAI,CAAS;IAE9B,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAsEpB;IAEF,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,KAAK,aAAa,GAOxB;IAED,OAAO,KAAK,eAAe,GAQ1B;IAED,OAAO,CAAC,qBAAqB,CAI3B;IAEF,OAAO,CAAC,WAAW,CAIjB;IAEF,OAAO,CAAC,YAAY;IAMpB,MAAM;CA8BP"}
+{"version":3,"file":"combobox.d.ts","sourceRoot":"","sources":["../../../src/components/form/combobox.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAYnD;;;;;;;;;;;;;;;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,0DAoHpB;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"}