@aithe/aithe-ui 26.2.2 → 26.3.1

package/dist/core/aithe-element.js

@@ -0,0 +1,135 @@
+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 { LitElement } from 'lit';
+import { property } from 'lit/decorators.js';
+import { registerAitheTheme, resolveComputedTheme } from '../styles/theme';
+import { emitAitheEvent, findFirstFocusable, getFocusableElements } from '../utils';
+/**
+ * Base class for all Aithe UI components. Extends LitElement with theme awareness,
+ * accessibility helpers, a unified event emission API, and browser environment detection.
+ * 所有 Aithe UI 组件的基类。继承 LitElement，提供主题感知、无障碍辅助、统一事件发射 API 和浏览器环境检测。
+ *
+ * @example
+ * ```ts
+ * @customElement('aithe-my-comp')
+ * export class AitheMyComp extends AitheElement {}
+ * ```
+ */
+export class AitheElement extends LitElement {
+    constructor() {
+        super();
+        /** Visual variant of the component. 组件的视觉变体。 */
+        this.variant = 'default';
+        /** Size preset of the component. 组件的尺寸规格。 */
+        this.size = 'md';
+        /** Local theme override; falls back to the closest themed ancestor or global theme when empty. 本地主题覆盖；为空时继承最近带主题祖先或全局主题。 */
+        this.theme = '';
+        /** Whether the component is disabled. 组件是否禁用。 */
+        this.disabled = false;
+        /** When true, all events emitted by this component will be captured by the logger. 为 true 时，组件的所有事件将被日志器捕获。 */
+        this.log = false;
+        registerAitheTheme();
+    }
+    /**
+     * Emit a custom event with the `aithe-` prefix convention.
+     * 发射遵循 `aithe-` 前缀约定的自定义事件。
+     *
+     * @param type - Event type (without prefix). 事件类型（不含前缀）。
+     * @param detail - Event payload. 事件载荷。
+     * @returns Whether the event was not cancelled. 事件是否未被取消。
+     */
+    emit(type, detail) {
+        if (detail != null && typeof detail === 'object' && !Array.isArray(detail)) {
+            detail.log = this.log;
+        }
+        return emitAitheEvent(this, type, detail);
+    }
+    /**
+     * Resolved theme name: local override → closest themed ancestor → global theme.
+     * 计算后的主题名：本地覆盖 → 最近带主题祖先 → 全局主题。
+     */
+    get computedTheme() {
+        return resolveComputedTheme(this, this.theme || undefined);
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.syncBaseA11yState();
+    }
+    /**
+     * Focus the first focusable element within the given root.
+     * 聚焦给定根节点内第一个可聚焦元素。
+     *
+     * @param root - Parent node to search within. 搜索的父节点。
+     */
+    focusFirst(root = this.renderRoot) {
+        findFirstFocusable(root)?.focus();
+    }
+    /**
+     * Trap keyboard focus within the given root (Tab / Shift+Tab cycle).
+     * 在给定根节点内捕获键盘焦点（Tab / Shift+Tab 循环）。
+     *
+     * @param event - Keyboard event to handle. 要处理的键盘事件。
+     * @param root - Parent node to trap focus within. 捕获焦点的父节点。
+     */
+    trapFocus(event, root = this.renderRoot) {
+        if (event.key !== 'Tab') {
+            return;
+        }
+        const items = getFocusableElements(root);
+        if (!items.length) {
+            return;
+        }
+        const first = items[0];
+        const last = items.at(-1);
+        const current = this.shadowRoot?.activeElement;
+        if (event.shiftKey && current === first) {
+            event.preventDefault();
+            last.focus();
+            return;
+        }
+        if (!event.shiftKey && current === last) {
+            event.preventDefault();
+            first.focus();
+        }
+    }
+    /**
+     * Synchronize base accessibility attributes (aria-disabled, data-aithe-theme).
+     * 同步基础无障碍属性（aria-disabled、data-aithe-theme）。
+     */
+    syncBaseA11yState() {
+        if (this.disabled) {
+            this.setAttribute('aria-disabled', 'true');
+        }
+        else {
+            this.removeAttribute('aria-disabled');
+        }
+        /**
+        if (!Object.hasOwn(this.dataset, 'aitheTheme')) {
+          this.dataset.aitheTheme = this.computedTheme;
+        }
+            **/
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        super.attributeChangedCallback(name, oldValue, newValue);
+        queueMicrotask(() => this.syncBaseA11yState());
+    }
+}
+__decorate([
+    property({ type: String })
+], AitheElement.prototype, "variant", void 0);
+__decorate([
+    property({ type: String })
+], AitheElement.prototype, "size", void 0);
+__decorate([
+    property({ type: String })
+], AitheElement.prototype, "theme", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheElement.prototype, "disabled", void 0);
+__decorate([
+    property({ type: Boolean })
+], AitheElement.prototype, "log", void 0);

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

@@ -0,0 +1,20 @@
+import { AitheElement } from './aithe-element';
+/**
+ * Abstract base class for dashboard panel widget components.
+ * Subclasses must implement the `params` and `data` properties.
+ *
+ * 仪表盘面板业务组件的抽象基类。子类必须实现 `params` 和 `data` 属性。
+ */
+export declare abstract class AitheWidget extends AitheElement {
+    /**
+     * Generic configuration object whose structure is defined by the subclass.
+     * 通用配置对象，其结构由子类自行定义。
+     */
+    abstract params: object;
+    /**
+     * Generic data object or array whose structure is defined by the subclass.
+     * 通用数据对象或数组，其结构由子类自行理解。
+     */
+    abstract data: unknown;
+}
+//# sourceMappingURL=aithe-widget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aithe-widget.d.ts","sourceRoot":"","sources":["../../src/core/aithe-widget.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;GAKG;AACH,8BAAsB,WAAY,SAAQ,YAAY;IACpD;;;OAGG;IACyB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpD;;;OAGG;IACyB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACpD"}

package/dist/core/aithe-widget.js

@@ -0,0 +1,30 @@
+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 Abstract widget base class for dashboard panel business components / 仪表盘面板业务组件抽象基类
+ * @description AitheWidget extends AitheElement and serves as the base class for all business
+ *              components used within dashboard panels. It defines two abstract properties —
+ *              `params` and `data` — that subclasses must implement.
+ *              AitheWidget 继承 AitheElement，作为所有仪表盘面板中业务组件的基类。
+ *              定义了两个子类必须实现的抽象属性：`params` 和 `data`。
+ */
+import { property } from 'lit/decorators.js';
+import { AitheElement } from './aithe-element';
+/**
+ * Abstract base class for dashboard panel widget components.
+ * Subclasses must implement the `params` and `data` properties.
+ *
+ * 仪表盘面板业务组件的抽象基类。子类必须实现 `params` 和 `data` 属性。
+ */
+export class AitheWidget extends AitheElement {
+}
+__decorate([
+    property({ type: Object })
+], AitheWidget.prototype, "params", void 0);
+__decorate([
+    property({ type: Object })
+], AitheWidget.prototype, "data", void 0);

package/dist/core/anchored-overlay.d.ts

@@ -1,17 +1,46 @@
 import type { PropertyValues } from 'lit';
 import { AitheElement } from './aithe-element';
 import { type AithePlacement } from './floating';
+/**
+ * Abstract base class for components that position a floating panel
+ * relative to an anchor element (e.g. tooltips, dropdowns, popovers).
+ * Handles containing block offset correction for position:fixed panels
+ * inside transformed/filtered ancestors.
+ * 抽象基类，用于相对于锚点元素定位浮动面板的组件（如工具提示、下拉菜单、弹出框）。
+ * 处理 position:fixed 面板在 transform/filter 祖先元素内的含入块偏移修正。
+ */
 export declare abstract class AitheAnchoredOverlayElement extends AitheElement {
+    /** Whether the overlay panel is visible. 叠加面板是否可见。 */
     open: boolean;
+    /** Preferred placement of the overlay relative to the anchor. 叠加层相对于锚点的首选放置位置。 */
     placement: AithePlacement;
+    /** Pixel gap between anchor and overlay. 锚点与叠加层之间的像素间距。 */
     offset: number;
+    /** Recompute position on viewport resize / scroll. 在视口调整/滚动时重新计算位置。 */
     private readonly handleViewportChange;
+    /** The floating panel element that gets positioned. 需要定位的浮动面板元素。 */
     protected abstract get panelElement(): HTMLElement | null;
+    /**
+     * Resolve the anchor element from the default slot.
+     * 从默认插槽解析锚点元素。
+     */
     protected get anchorElement(): HTMLElement;
+    /** Unbind viewport listeners on disconnect. 断开连接时解绑视口监听器。 */
     disconnectedCallback(): void;
+    /**
+     * Bind/unbind floating listeners when `open` changes, and recompute
+     * position when placement or offset changes while open.
+     * 当 `open` 变化时绑定/解绑浮动监听器，并在打开状态下放置或偏移变化时重新计算位置。
+     */
     protected updated(changed: PropertyValues<this>): void;
+    /**
+     * Recompute the floating panel position based on current anchor and overlay rects.
+     * 根据当前锚点和叠加层矩形重新计算浮动面板位置。
+     */
     protected updateFloatingPosition(): void;
+    /** Bind viewport resize/scroll listeners. 绑定视口调整/滚动监听器。 */
     private bindFloating;
+    /** Unbind viewport resize/scroll listeners. 解绑视口调整/滚动监听器。 */
     private unbindFloating;
 }
 //# sourceMappingURL=anchored-overlay.d.ts.map

package/dist/core/anchored-overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchored-overlay.d.ts","sourceRoot":"","sources":["../../src/core/anchored-overlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAG1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,YAAY,CAAC;AAE1E,8BAAsB,2BAA4B,SAAQ,YAAY;IACxB,IAAI,UAAS;IAC7B,SAAS,EAAE,cAAc,CAAkB;IAC3C,MAAM,SAAK;IAEvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuC;IAE5E,SAAS,CAAC,QAAQ,KAAK,YAAY,IAAI,WAAW,GAAG,IAAI,CAAC;IAE1D,SAAS,KAAK,aAAa,IAAI,WAAW,CAOzC;IAED,oBAAoB,IAAI,IAAI;IAK5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAgBtD,SAAS,CAAC,sBAAsB,IAAI,IAAI;IAiBxC,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,cAAc;CAIvB"}
+{"version":3,"file":"anchored-overlay.d.ts","sourceRoot":"","sources":["../../src/core/anchored-overlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAG1C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,KAAK,cAAc,EAA2B,MAAM,YAAY,CAAC;AAE1E;;;;;;;GAOG;AACH,8BAAsB,2BAA4B,SAAQ,YAAY;IACpE,sDAAsD;IACV,IAAI,UAAS;IACzD,kFAAkF;IACtD,SAAS,EAAE,cAAc,CAAkB;IACvE,2DAA2D;IAC/B,MAAM,SAAK;IAEvC,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAuC;IAE5E,oEAAoE;IACpE,SAAS,CAAC,QAAQ,KAAK,YAAY,IAAI,WAAW,GAAG,IAAI,CAAC;IAE1D;;;OAGG;IACH,SAAS,KAAK,aAAa,IAAI,WAAW,CAOzC;IAED,6DAA6D;IAC7D,oBAAoB,IAAI,IAAI;IAK5B;;;;OAIG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAgBtD;;;OAGG;IACH,SAAS,CAAC,sBAAsB,IAAI,IAAI;IA8BxC,2DAA2D;IAC3D,OAAO,CAAC,YAAY;IAKpB,6DAA6D;IAC7D,OAAO,CAAC,cAAc;CAIvB"}

package/dist/core/anchored-overlay.js

@@ -0,0 +1,111 @@
+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 { property } from 'lit/decorators.js';
+import { AitheElement } from './aithe-element';
+import { computeFloatingPosition } from './floating';
+/**
+ * Abstract base class for components that position a floating panel
+ * relative to an anchor element (e.g. tooltips, dropdowns, popovers).
+ * Handles containing block offset correction for position:fixed panels
+ * inside transformed/filtered ancestors.
+ * 抽象基类，用于相对于锚点元素定位浮动面板的组件（如工具提示、下拉菜单、弹出框）。
+ * 处理 position:fixed 面板在 transform/filter 祖先元素内的含入块偏移修正。
+ */
+export class AitheAnchoredOverlayElement extends AitheElement {
+    constructor() {
+        super(...arguments);
+        /** Whether the overlay panel is visible. 叠加面板是否可见。 */
+        this.open = false;
+        /** Preferred placement of the overlay relative to the anchor. 叠加层相对于锚点的首选放置位置。 */
+        this.placement = 'bottom-start';
+        /** Pixel gap between anchor and overlay. 锚点与叠加层之间的像素间距。 */
+        this.offset = 8;
+        /** Recompute position on viewport resize / scroll. 在视口调整/滚动时重新计算位置。 */
+        this.handleViewportChange = () => this.updateFloatingPosition();
+    }
+    /**
+     * Resolve the anchor element from the default slot.
+     * 从默认插槽解析锚点元素。
+     */
+    get anchorElement() {
+        const defaultSlot = this.shadowRoot?.querySelector('slot:not([name])');
+        const assigned = defaultSlot?.assignedElements({ flatten: true }) ?? [];
+        return assigned[0] ?? this;
+    }
+    /** Unbind viewport listeners on disconnect. 断开连接时解绑视口监听器。 */
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.unbindFloating();
+    }
+    /**
+     * Bind/unbind floating listeners when `open` changes, and recompute
+     * position when placement or offset changes while open.
+     * 当 `open` 变化时绑定/解绑浮动监听器，并在打开状态下放置或偏移变化时重新计算位置。
+     */
+    updated(changed) {
+        super.updated(changed);
+        if (changed.has('open')) {
+            if (this.open) {
+                this.bindFloating();
+            }
+            else {
+                this.unbindFloating();
+            }
+        }
+        if (this.open && (changed.has('open') || changed.has('placement') || changed.has('offset'))) {
+            queueMicrotask(() => this.updateFloatingPosition());
+        }
+    }
+    /**
+     * Recompute the floating panel position based on current anchor and overlay rects.
+     * 根据当前锚点和叠加层矩形重新计算浮动面板位置。
+     */
+    updateFloatingPosition() {
+        const panel = this.panelElement;
+        if (!panel || !this.open) {
+            return;
+        }
+        const anchor = this.anchorElement;
+        const anchorRect = anchor.getBoundingClientRect();
+        // Temporarily move panel to (0,0) to measure the containing block offset.
+        // When a position:fixed element has a containing block created by
+        // transform/backdrop-filter/filter/etc., left:0;top:0 positions it at
+        // the containing block's origin, not the viewport origin.
+        // getBoundingClientRect() always returns viewport-relative coordinates,
+        // so the difference reveals the containing block's offset.
+        panel.style.left = '0px';
+        panel.style.top = '0px';
+        const zeroRect = panel.getBoundingClientRect();
+        const cbOffsetX = zeroRect.left;
+        const cbOffsetY = zeroRect.top;
+        const overlayRect = panel.getBoundingClientRect();
+        const position = computeFloatingPosition(anchorRect, overlayRect, this.placement, {
+            offset: this.offset,
+        });
+        panel.style.left = `${position.left - cbOffsetX}px`;
+        panel.style.top = `${position.top - cbOffsetY}px`;
+    }
+    /** Bind viewport resize/scroll listeners. 绑定视口调整/滚动监听器。 */
+    bindFloating() {
+        window.addEventListener('resize', this.handleViewportChange);
+        window.addEventListener('scroll', this.handleViewportChange, true);
+    }
+    /** Unbind viewport resize/scroll listeners. 解绑视口调整/滚动监听器。 */
+    unbindFloating() {
+        window.removeEventListener('resize', this.handleViewportChange);
+        window.removeEventListener('scroll', this.handleViewportChange, true);
+    }
+}
+__decorate([
+    property({ type: Boolean, reflect: true })
+], AitheAnchoredOverlayElement.prototype, "open", void 0);
+__decorate([
+    property({ type: String })
+], AitheAnchoredOverlayElement.prototype, "placement", void 0);
+__decorate([
+    property({ type: Number })
+], AitheAnchoredOverlayElement.prototype, "offset", void 0);

package/dist/core/autoform/autoform.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @file Form dependency rule engine & registry / 表单依赖联动规则引擎与注册表
+ * @description 纯 JSON 可配置的规则引擎，解析条件表达式并计算字段联动状态。
+ *              包含规则引擎（FormRuleEngine）、控件注册表（FormRegistry）、
+ *              自定义控件渲染器类型（FormControlRenderer/FormControlContext/FormControlDefinition）。
+ *              Pure JSON-configurable rule engine that parses condition expressions
+ *              and computes field dependency states (visible, disabled, options, value).
+ *              Includes rule engine (FormRuleEngine), control registry (FormRegistry),
+ *              and custom control renderer types (FormControlRenderer/FormControlContext/FormControlDefinition).
+ */
+import type { TemplateResult } from 'lit';
+import type { FormRule, FormItemOption } from './types';
+import type { ConditionNode } from './condition';
+/**
+ * Form field dependency state — the computed result of rule evaluation.
+ * 表单字段依赖联动状态 — 规则求值后的计算结果。
+ */
+export interface FormDependencyState {
+    visible: boolean;
+    disabled: boolean;
+    options: FormItemOption[];
+    value: string;
+}
+/**
+ * Form rule engine — evaluates dependency rules against current form values.
+ * 表单规则引擎 — 基于当前表单值对依赖联动规则进行求值。
+ */
+export declare class FormRuleEngine {
+    /**
+     * Evaluate all rules and compute the resulting dependency state.
+     * 对所有规则求值，计算最终的依赖联动状态。
+     * @param rules - 规则列表 / Rule list
+     * @param values - 当前表单所有字段的值 / Current values of all form fields
+     * @param baseState - 初始状态（未应用规则前的默认值）/ Base state before applying rules
+     * @returns 计算后的最终状态 / Computed final state
+     */
+    static evaluate(rules: FormRule[], values: Record<string, unknown>, baseState: FormDependencyState): FormDependencyState;
+    /**
+     * Parse a condition expression string into an AST node.
+     * 将条件表达式字符串解析为 AST 节点。
+     * @param condition - 条件表达式字符串，如 "field === 'value'" / Condition expression string
+     * @returns 解析后的 AST 节点，解析失败返回 null / Parsed AST node, or null on failure
+     */
+    static parseCondition(condition: string): ConditionNode | null;
+}
+/**
+ * Custom control renderer function.
+ * 自定义控件渲染函数。
+ */
+export type FormControlRenderer = (context: FormControlContext) => TemplateResult;
+/**
+ * Context passed to a custom control renderer.
+ * 传递给自定义控件渲染函数的上下文。
+ */
+export interface FormControlContext {
+    value: string;
+    placeholder: string;
+    disabled: boolean;
+    name: string;
+    options: string | Array<{
+        label: string;
+        id: string;
+        disabled?: boolean;
+    }>;
+    min: string;
+    max: string;
+    step: string;
+    rows: string;
+    inputType: string;
+    onChange: (value: unknown) => void;
+}
+/**
+ * Custom control type definition.
+ * 自定义控件类型定义。
+ */
+export interface FormControlDefinition {
+    type: string;
+    render: FormControlRenderer;
+    valueTransformer?: (value: string) => unknown;
+    styles?: string;
+}
+/**
+ * Form control type registry. Allows registering custom control types
+ * to extend the autoform with arbitrary Web Components or rendering logic.
+ * 表单控件类型注册表。允许注册自定义控件类型，以任意 Web Component 或渲染逻辑扩展自动表单。
+ */
+export declare class FormRegistry {
+    private static readonly _controls;
+    static register(definition: FormControlDefinition): void;
+    static unregister(type: string): boolean;
+    static get(type: string): FormControlDefinition | undefined;
+    static has(type: string): boolean;
+    static types(): string[];
+}
+//# sourceMappingURL=autoform.d.ts.map

package/dist/core/autoform/autoform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoform.d.ts","sourceRoot":"","sources":["../../../src/core/autoform/autoform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAiBD;;;GAGG;AACH,qBAAa,cAAc;IACzB;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CACb,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,mBAAmB,GAC7B,mBAAmB;IAmBtB;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;CAG/D;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,kBAAkB,KAAK,cAAc,CAAC;AAElF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAA4C;IAE7E,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAUxD,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI3D,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,MAAM,CAAC,KAAK,IAAI,MAAM,EAAE;CAGzB"}

package/dist/core/autoform/autoform.js

@@ -0,0 +1,79 @@
+import { FormCondition } from './condition';
+const RULE_HANDLERS = {
+    show: (s, c) => { s.visible = c; },
+    hide: (s, c) => { s.visible = !c; },
+    disable: (s, c) => { if (c)
+        s.disabled = true; },
+    enable: (s, c) => { if (c)
+        s.disabled = false; },
+    clear: (s, c) => { if (c)
+        s.value = ''; },
+    update: (s, c, r) => { if (c && r.options)
+        s.options = Array.isArray(r.options) ? r.options : []; },
+};
+/**
+ * Form rule engine — evaluates dependency rules against current form values.
+ * 表单规则引擎 — 基于当前表单值对依赖联动规则进行求值。
+ */
+export class FormRuleEngine {
+    /**
+     * Evaluate all rules and compute the resulting dependency state.
+     * 对所有规则求值，计算最终的依赖联动状态。
+     * @param rules - 规则列表 / Rule list
+     * @param values - 当前表单所有字段的值 / Current values of all form fields
+     * @param baseState - 初始状态（未应用规则前的默认值）/ Base state before applying rules
+     * @returns 计算后的最终状态 / Computed final state
+     */
+    static evaluate(rules, values, baseState) {
+        const state = {
+            visible: baseState.visible,
+            disabled: baseState.disabled,
+            options: baseState.options,
+            value: baseState.value,
+        };
+        for (const rule of rules) {
+            const conditionMet = rule.condition ? FormCondition.evaluate(rule.condition, values) : true;
+            const handler = RULE_HANDLERS[rule.type];
+            if (handler) {
+                handler(state, conditionMet, rule);
+            }
+        }
+        return state;
+    }
+    /**
+     * Parse a condition expression string into an AST node.
+     * 将条件表达式字符串解析为 AST 节点。
+     * @param condition - 条件表达式字符串，如 "field === 'value'" / Condition expression string
+     * @returns 解析后的 AST 节点，解析失败返回 null / Parsed AST node, or null on failure
+     */
+    static parseCondition(condition) {
+        return FormCondition.parse(condition);
+    }
+}
+/**
+ * Form control type registry. Allows registering custom control types
+ * to extend the autoform with arbitrary Web Components or rendering logic.
+ * 表单控件类型注册表。允许注册自定义控件类型，以任意 Web Component 或渲染逻辑扩展自动表单。
+ */
+export class FormRegistry {
+    static { this._controls = new Map(); }
+    static register(definition) {
+        if (FormRegistry._controls.has(definition.type)) {
+            throw new Error(`[FormRegistry] Control type "${definition.type}" is already registered. ` +
+                `Call FormRegistry.unregister() first if you want to replace it.`);
+        }
+        FormRegistry._controls.set(definition.type, definition);
+    }
+    static unregister(type) {
+        return FormRegistry._controls.delete(type);
+    }
+    static get(type) {
+        return FormRegistry._controls.get(type);
+    }
+    static has(type) {
+        return FormRegistry._controls.has(type);
+    }
+    static types() {
+        return Array.from(FormRegistry._controls.keys());
+    }
+}

package/dist/core/autoform/condition.d.ts

@@ -0,0 +1,45 @@
+export interface ComparisonNode {
+    kind: 'comparison';
+    field: string;
+    operator: string;
+    value: unknown;
+}
+export interface LogicalNode {
+    kind: 'and' | 'or';
+    children: ConditionNode[];
+}
+export type ConditionNode = ComparisonNode | LogicalNode;
+/**
+ * Form condition expression parser and evaluator.
+ * 表单条件表达式解析与求值器。
+ * @description Parses condition expressions like "field === 'value' || field2 > 10"
+ * into an AST and evaluates them against a values map.
+ * Supports comparison operators (===, !==, >, >=, <, <=), logical AND (&&) and OR (||),
+ * nested parentheses, and automatic type coercion for comparison.
+ * 将条件表达式（如 "field === 'value' || field2 > 10"）解析为 AST 并基于值映射求值。
+ * 支持比较运算符、逻辑与/或、嵌套括号及自动类型转换。
+ */
+export declare class FormCondition {
+    /**
+     * Evaluate a condition expression against form values.
+     * 对条件表达式进行求值。
+     * @param condition - 条件表达式字符串 / Condition expression string
+     * @param values - 当前表单字段值映射 / Current form field values map
+     * @returns 求值结果，条件为空时返回 true / Evaluation result, returns true if condition is empty
+     */
+    static evaluate(condition: string, values: Record<string, unknown>): boolean;
+    /**
+     * Parse a condition expression string into an AST.
+     * 将条件表达式字符串解析为 AST。
+     * @param expr - 表达式字符串 / Expression string
+     * @returns AST 根节点，空字符串返回 null / Root AST node, or null for empty string
+     */
+    static parse(expr: string): ConditionNode | null;
+    private static evaluateNode;
+    private static toComparable;
+    private static compareValues;
+    private static parseLiteral;
+    private static parseSingleComparison;
+    private static splitLogical;
+}
+//# sourceMappingURL=condition.d.ts.map

package/dist/core/autoform/condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../../../src/core/autoform/condition.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;IACnB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,WAAW,CAAC;AAEzD;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACxB;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAM5E;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAuBhD,OAAO,CAAC,MAAM,CAAC,YAAY;IAc3B,OAAO,CAAC,MAAM,CAAC,YAAY;IAY3B,OAAO,CAAC,MAAM,CAAC,aAAa;IAsB5B,OAAO,CAAC,MAAM,CAAC,YAAY;IAgB3B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAYpC,OAAO,CAAC,MAAM,CAAC,YAAY;CA0B5B"}