@aithe/aithe-ui 26.2.2 → 26.3.1

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

@@ -0,0 +1,100 @@
+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 (buttons) below the auto-generated items. Use together with `show-submit` to control the built-in submit button. 自动生成项下方的自定义操作区域（按钮），配合 `show-submit` 属性控制内置提交按钮的显隐。
+ * ### 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;
+    /**
+     * Initial values for form fields, as an object or JSON string.
+     * When provided, these values override `dft` for each matching field.
+     * 表单字段初始值，支持对象或 JSON 字符串。提供时覆盖对应字段的 `dft`。
+     */
+    initialValues: Record<string, unknown> | string;
+    private get _initialValues();
+    private readonly formItems;
+    /**
+     * Whether to show the built-in submit button. Set to false when using custom action slot.
+     * 是否显示内置提交按钮。使用自定义操作 slot 时设为 false。
+     */
+    showSubmit: boolean;
+    /** 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;
+    /** Triggers form validation and submission programmatically. Emits aithe-submit if valid. 编程触发表单校验和提交，通过后触发 aithe-submit 事件。 */
+    submit(): void;
+    /** Handles value change from a child autoform-item, updates fieldValues state and emits aithe-change. 处理子表单项的值变更，更新 fieldValues 状态并触发 aithe-change 事件。 */
+    private readonly handleItemChange;
+    /** 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;IAE5D;;;;OAIG;IACsD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAM;IAE9G,OAAO,KAAK,cAAc,GAQzB;IAGD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D;;;OAGG;IACoD,UAAU,UAAQ;IAEzE,uFAAuF;IAC9E,OAAO,CAAC,WAAW,CAA+B;IAE3D,MAAM,CAAC,QAAQ,CAAC,MAAM,0DAepB;IAEF,6GAA6G;IAC7G,QAAQ,IAAI,OAAO;IAkBnB,oGAAoG;IACpG,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYpC,oFAAoF;IACpF,KAAK,IAAI,IAAI;IAWb,gIAAgI;IAChI,MAAM,IAAI,IAAI;IAId,0JAA0J;IAC1J,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAK/B;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;CAwDP;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/autoform.js

@@ -0,0 +1,303 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @file JSON-driven auto form / JSON 驱动的自动表单
+ * @description 接收 JSON 配置数组，自动渲染所有表单项，支持实时校验和提交校验。
+ *              Accepts a JSON configuration array, automatically renders all form items,
+ *              supports real-time validation and submit-time validation.
+ */
+import { css, html, nothing } from 'lit';
+import { customElement, property, queryAll, state } from 'lit/decorators.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles } from '../../core/styles';
+import { t } from '../../styles/i18n';
+/**
+ * JSON-driven auto form that renders form items from a configuration array.
+ * JSON 驱动的自动表单，根据配置数组自动渲染表单项。
+ *
+ * @slot - Default slot for custom actions (buttons) below the auto-generated items. Use together with `show-submit` to control the built-in submit button. 自动生成项下方的自定义操作区域（按钮），配合 `show-submit` 属性控制内置提交按钮的显隐。
+ * ### 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>
+ * ```
+ */
+let AitheAutoform = class AitheAutoform extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /**
+         * 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
+         */
+        this.fields = '[]';
+        /** Whether to validate on every field change. 是否在每次字段变更时实时校验。 */
+        this.validateOnChange = true;
+        /** Submit button text. 提交按钮文本。 */
+        this.submitText = '';
+        /** Whether the form is in a submitting state. 表单是否处于提交中状态。 */
+        this.loading = false;
+        /**
+         * Initial values for form fields, as an object or JSON string.
+         * When provided, these values override `dft` for each matching field.
+         * 表单字段初始值，支持对象或 JSON 字符串。提供时覆盖对应字段的 `dft`。
+         */
+        this.initialValues = {};
+        /**
+         * Whether to show the built-in submit button. Set to false when using custom action slot.
+         * 是否显示内置提交按钮。使用自定义操作 slot 时设为 false。
+         */
+        this.showSubmit = true;
+        /** Current values of all fields, used for dependency resolution. 所有字段的当前值，用于依赖联动计算。 */
+        this.fieldValues = {};
+        /** Handles value change from a child autoform-item, updates fieldValues state and emits aithe-change. 处理子表单项的值变更，更新 fieldValues 状态并触发 aithe-change 事件。 */
+        this.handleItemChange = (ev) => {
+            ev.stopPropagation();
+            const { name, value } = ev.detail;
+            this.fieldValues = { ...this.fieldValues, [name]: value };
+            this.emit('aithe-change', { name, value });
+        };
+        /** Handles form submit: validates all fields, emits aithe-submit if valid. 处理表单提交：校验所有字段，通过后触发 aithe-submit 事件。 */
+        this.handleSubmit = (ev) => {
+            ev.preventDefault();
+            const valid = this.validate();
+            if (!valid) {
+                return;
+            }
+            this.emit('aithe-submit', { values: this.getValues() });
+        };
+    }
+    get _initialValues() {
+        if (typeof this.initialValues === 'string') {
+            if (this.initialValues) {
+                try {
+                    return JSON.parse(this.initialValues);
+                }
+                catch {
+                    return {};
+                }
+            }
+            return {};
+        }
+        return this.initialValues ?? {};
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        display: block;
+        width: 100%;
+      }
+
+      .autoform-container {
+        display: flex;
+        flex-direction: column;
+        gap: var(--aithe-space-5);
+        width: 100%;
+      }
+    `,
+    ]; }
+    /** Validates all form items and emits validate event. Skips hidden fields. 校验所有表单项并触发 validate 事件，跳过隐藏字段。 */
+    validate() {
+        const items = Array.from(this.formItems);
+        const errors = {};
+        let valid = true;
+        for (const item of items) {
+            if (!item.visible)
+                continue;
+            const itemValid = item.validate();
+            if (!itemValid) {
+                valid = false;
+                errors[item.name] = item.getError?.() ?? '';
+            }
+        }
+        this.emit('aithe-validate', { valid, errors });
+        return valid;
+    }
+    /** Collects all field values as a key-value object. Excludes hidden fields. 收集所有字段值为键值对象，排除隐藏字段。 */
+    getValues() {
+        const values = {};
+        const items = Array.from(this.formItems);
+        for (const item of items) {
+            if (!item.visible)
+                continue;
+            values[item.name] = item.getFieldValue();
+        }
+        return values;
+    }
+    /** Resets all fields to their default values and clears errors. 重置所有字段为缺省值并清除错误。 */
+    reset() {
+        const items = Array.from(this.formItems);
+        const newFieldValues = {};
+        for (const item of items) {
+            item.value = item.dft ?? '';
+            item.clearError();
+            newFieldValues[item.name] = item.getFieldValue();
+        }
+        this.fieldValues = newFieldValues;
+    }
+    /** Triggers form validation and submission programmatically. Emits aithe-submit if valid. 编程触发表单校验和提交，通过后触发 aithe-submit 事件。 */
+    submit() {
+        this.handleSubmit(new Event('submit', { cancelable: true }));
+    }
+    /** Parses the fields JSON string into a typed configuration array. Falls back to sanitized JSON on first parse failure. 解析 fields JSON 字符串为类型化配置数组，首次解析失败时尝试清理后重新解析。 */
+    parseFields() {
+        const raw = this.fields || '[]';
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            try {
+                const sanitized = raw.replaceAll(/\\(?!["\\/bfnrtu])/g, '\\\\');
+                return JSON.parse(sanitized);
+            }
+            catch {
+                return [];
+            }
+        }
+    }
+    /** Normalizes options from JSON string or array to a uniform FormItemOption array. 将 JSON 字符串或数组格式的选项统一为 FormItemOption 数组。 */
+    normalizeOptions(raw) {
+        if (Array.isArray(raw))
+            return raw;
+        if (typeof raw === 'string') {
+            try {
+                const parsed = JSON.parse(raw || '[]');
+                return Array.isArray(parsed) ? parsed : [];
+            }
+            catch {
+                return [];
+            }
+        }
+        return [];
+    }
+    /** Normalizes dependency rules, parsing options for 'update' type rules. 规范化依赖联动规则，为 update 类型规则解析 options。 */
+    normalizeRules(rules) {
+        if (!rules)
+            return [];
+        return rules.map((rule) => ({
+            ...rule,
+            options: rule.type === 'update' && rule.options != null
+                ? this.normalizeOptions(rule.options)
+                : rule.options,
+        }));
+    }
+    render() {
+        const fieldConfigs = this.parseFields();
+        const submitLabel = this.submitText || t('form.autoform.submit');
+        const initVals = this._initialValues;
+        return html `
+      <form class="autoform-container" novalidate @submit=${this.handleSubmit}>
+        ${fieldConfigs.map((field) => {
+            const depValues = {};
+            if (field.dependencies) {
+                for (const dep of field.dependencies) {
+                    depValues[dep] = this.fieldValues[dep] ?? '';
+                }
+            }
+            const fieldValue = field.name && field.name in initVals ? initVals[field.name] : (field.dft ?? '');
+            return html `
+            <aithe-autoform-item
+              .name=${field.name ?? ''}
+              .type=${field.type ?? 'input'}
+              .label=${field.label ?? ''}
+              .icon=${field.icon ?? ''}
+              .tooltip=${field.tooltip ?? ''}
+              .description=${field.description ?? ''}
+              .dft=${field.dft ?? ''}
+              .placeholder=${field.placeholder ?? ''}
+              .disabled=${field.disabled ?? false}
+              .required=${field.required ?? false}
+              .pattern=${field.pattern ?? ''}
+              .message=${field.message ?? ''}
+              .options=${this.normalizeOptions(field.options)}
+              .value=${fieldValue}
+              .inputType=${field.inputType ?? 'text'}
+              .min=${field.min ?? ''}
+              .max=${field.max ?? ''}
+              .step=${field.step ?? ''}
+              .rows=${field.rows ?? '3'}
+              .validateOnChange=${this.validateOnChange}
+              .dependencies=${field.dependencies ?? []}
+              .rules=${this.normalizeRules(field.rules)}
+              .dependencyValues=${depValues}
+              @aithe-change=${this.handleItemChange}
+            ></aithe-autoform-item>
+          `;
+        })}
+        <aithe-button-group>
+          <slot></slot>
+          ${this.showSubmit ? html `
+            <aithe-button type="primary" ?loading=${this.loading} @aithe-click=${this.handleSubmit}>
+              ${submitLabel}
+            </aithe-button>
+          ` : nothing}
+        </aithe-button-group>
+      </form>
+    `;
+    }
+};
+__decorate([
+    property({ type: String })
+], AitheAutoform.prototype, "fields", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'validate-on-change' })
+], AitheAutoform.prototype, "validateOnChange", void 0);
+__decorate([
+    property({ type: String, attribute: 'submit-text' })
+], AitheAutoform.prototype, "submitText", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheAutoform.prototype, "loading", void 0);
+__decorate([
+    property({ type: Object, attribute: 'initial-values' })
+], AitheAutoform.prototype, "initialValues", void 0);
+__decorate([
+    queryAll('aithe-autoform-item')
+], AitheAutoform.prototype, "formItems", void 0);
+__decorate([
+    property({ type: Boolean, attribute: 'show-submit' })
+], AitheAutoform.prototype, "showSubmit", void 0);
+__decorate([
+    state()
+], AitheAutoform.prototype, "fieldValues", void 0);
+AitheAutoform = __decorate([
+    customElement('aithe-autoform')
+], AitheAutoform);
+export { AitheAutoform };

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-group.js

@@ -0,0 +1,118 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { css, html } from 'lit';
+import { customElement, property, queryAssignedElements } from 'lit/decorators.js';
+import { AitheElement } from '../../core/aithe-element';
+import { aitheBaseStyles } from '../../core/styles';
+/**
+ * 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>
+ * ```
+ */
+let AitheCheckboxGroup = class AitheCheckboxGroup extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /** JSON string of the current checked values. 当前选中值的 JSON 字符串。 */
+        this.valueJson = '';
+        /** Array of currently checked values. 当前选中值数组。 */
+        this.value = [];
+        /** Whether all child checkboxes are disabled. 是否禁用所有子复选框。 */
+        this.disabled = false;
+        /** Name attribute propagated to child checkboxes. 传递给子复选框的 name 属性。 */
+        this.name = '';
+        /** Syncs checked/disabled/name state to child checkboxes. 将选中/禁用/name 状态同步到子复选框。 */
+        this.syncChildren = () => {
+            const checkboxes = this.nodes.filter((node) => node instanceof HTMLElement && node.tagName.toLowerCase() === 'aithe-checkbox');
+            for (const checkbox of checkboxes) {
+                checkbox.checked = this.value.includes(checkbox.value);
+                checkbox.groupDisabled = this.disabled;
+                checkbox.name = this.name || checkbox.name;
+            }
+        };
+        /** Handles child checkbox toggle and updates group value. 处理子复选框切换并更新组值。 */
+        this.handleToggle = (event) => {
+            event.stopPropagation();
+            const next = new Set(this.value);
+            if (event.detail.checked) {
+                next.add(event.detail.value);
+            }
+            else {
+                next.delete(event.detail.value);
+            }
+            this.value = Array.from(next);
+            this.syncChildren();
+            this.emit('aithe-change', { value: this.value });
+        };
+    }
+    /** Parses valueJson into the value array on property change. 属性变更时将 valueJson 解析为 value 数组。 */
+    willUpdate(changed) {
+        if (changed.has('valueJson') && this.valueJson) {
+            try {
+                this.value = JSON.parse(this.valueJson);
+            }
+            catch {
+                this.value = [];
+            }
+        }
+    }
+    static { this.styles = [
+        aitheBaseStyles,
+        css `
+      :host {
+        display: inline-flex;
+        flex-wrap: wrap;
+        gap: var(--aithe-space-4);
+      }
+    `,
+    ]; }
+    connectedCallback() {
+        super.connectedCallback();
+        this.addEventListener('aithe-checkbox-toggle', this.handleToggle);
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.removeEventListener('aithe-checkbox-toggle', this.handleToggle);
+    }
+    updated(changed) {
+        if (changed.has('value') || changed.has('disabled') || changed.has('name')) {
+            this.syncChildren();
+        }
+    }
+    render() {
+        return html `
+      <slot @slotchange=${this.syncChildren}></slot>
+    `;
+    }
+};
+__decorate([
+    property({ type: String, attribute: 'value' })
+], AitheCheckboxGroup.prototype, "valueJson", void 0);
+__decorate([
+    property({ attribute: false })
+], AitheCheckboxGroup.prototype, "value", void 0);
+__decorate([
+    property({ type: Boolean })
+], AitheCheckboxGroup.prototype, "disabled", void 0);
+__decorate([
+    property({ type: String })
+], AitheCheckboxGroup.prototype, "name", void 0);
+__decorate([
+    queryAssignedElements()
+], AitheCheckboxGroup.prototype, "nodes", void 0);
+AitheCheckboxGroup = __decorate([
+    customElement('aithe-checkbox-group')
+], AitheCheckboxGroup);
+export { AitheCheckboxGroup };

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"}