@aithe/aithe-ui 26.2.3 → 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.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

@@ -4,7 +4,10 @@ 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. 叠加面板是否可见。 */

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;;;;GAIG;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;IAiBxC,2DAA2D;IAC3D,OAAO,CAAC,YAAY;IAKpB,6DAA6D;IAC7D,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.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.js

@@ -0,0 +1,170 @@
+/**
+ * @file 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.
+ * 将条件表达式（如 "field === 'value' || field2 > 10"）解析为 AST 并基于值映射求值。
+ */
+import { safeStringify } from '../../utils/utils';
+const TRUTHY_STRINGS = new Set(['true', '1', 'yes', 'on']);
+const FALSY_STRINGS = new Set(['false', '0', 'no', 'off', '', 'null', 'undefined']);
+/**
+ * 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 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, values) {
+        const node = FormCondition.parse(condition);
+        if (!node)
+            return true;
+        return FormCondition.evaluateNode(node, values);
+    }
+    /**
+     * 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) {
+        const trimmed = expr.trim();
+        if (!trimmed)
+            return null;
+        const orParts = FormCondition.splitLogical(trimmed, '||');
+        if (orParts.length > 1) {
+            const children = orParts
+                .map((p) => FormCondition.parse(p))
+                .filter((n) => n !== null);
+            return children.length > 0 ? { kind: 'or', children } : null;
+        }
+        const andParts = FormCondition.splitLogical(trimmed, '&&');
+        if (andParts.length > 1) {
+            const children = andParts
+                .map((p) => FormCondition.parse(p))
+                .filter((n) => n !== null);
+            return children.length > 0 ? { kind: 'and', children } : null;
+        }
+        return FormCondition.parseSingleComparison(trimmed);
+    }
+    static evaluateNode(node, values) {
+        if (node.kind === 'comparison') {
+            const fieldValue = values[node.field] ?? '';
+            return FormCondition.compareValues(fieldValue, node.operator, node.value);
+        }
+        if (node.kind === 'and') {
+            return node.children.every((child) => FormCondition.evaluateNode(child, values));
+        }
+        if (node.kind === 'or') {
+            return node.children.some((child) => FormCondition.evaluateNode(child, values));
+        }
+        return false;
+    }
+    static toComparable(val) {
+        if (val === null || val === undefined)
+            return '';
+        if (typeof val === 'boolean')
+            return val;
+        if (typeof val === 'number')
+            return val;
+        const str = safeStringify(val);
+        if (TRUTHY_STRINGS.has(str))
+            return true;
+        if (FALSY_STRINGS.has(str))
+            return false;
+        const num = Number(str);
+        if (str !== '' && !Number.isNaN(num))
+            return num;
+        return str;
+    }
+    static compareValues(left, operator, right) {
+        const lv = FormCondition.toComparable(left);
+        const rv = FormCondition.toComparable(right);
+        switch (operator) {
+            case '===':
+                return lv === rv;
+            case '!==':
+                return lv !== rv;
+            case '>':
+                return typeof lv === 'number' && typeof rv === 'number' && lv > rv;
+            case '>=':
+                return typeof lv === 'number' && typeof rv === 'number' && lv >= rv;
+            case '<':
+                return typeof lv === 'number' && typeof rv === 'number' && lv < rv;
+            case '<=':
+                return typeof lv === 'number' && typeof rv === 'number' && lv <= rv;
+            default:
+                return false;
+        }
+    }
+    static parseLiteral(raw) {
+        const trimmed = raw.trim();
+        if (trimmed === 'true')
+            return true;
+        if (trimmed === 'false')
+            return false;
+        if (trimmed === 'null')
+            return null;
+        if (trimmed === 'undefined')
+            return undefined;
+        if (/^-?\d+(\.\d+)?$/.test(trimmed))
+            return Number(trimmed);
+        if ((trimmed.startsWith("'") && trimmed.endsWith("'")) ||
+            (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
+            return trimmed.slice(1, -1);
+        }
+        return trimmed;
+    }
+    static parseSingleComparison(expr) {
+        const re = /^\s*([a-zA-Z_]\w*)\s*(===|!==|>=|<=|>|<)\s*(.+?)\s*$/;
+        const match = re.exec(expr);
+        if (!match?.[1] || !match?.[2] || match[3] === undefined)
+            return null;
+        return {
+            kind: 'comparison',
+            field: match[1],
+            operator: match[2],
+            value: FormCondition.parseLiteral(match[3]),
+        };
+    }
+    static splitLogical(expr, op) {
+        const parts = [];
+        let depth = 0;
+        let current = '';
+        let i = 0;
+        while (i < expr.length) {
+            if (expr[i] === '(') {
+                depth++;
+                current += expr[i];
+                i++;
+            }
+            else if (expr[i] === ')') {
+                depth--;
+                current += expr[i];
+                i++;
+            }
+            else if (depth === 0 && expr.slice(i, i + op.length) === op) {
+                parts.push(current);
+                current = '';
+                i += op.length;
+            }
+            else {
+                current += expr[i];
+                i++;
+            }
+        }
+        if (current.trim())
+            parts.push(current);
+        return parts;
+    }
+}

package/dist/core/autoform/index.js

@@ -0,0 +1,8 @@
+/**
+ * @file Form module entry — unified exports / 表单模块入口 — 统一导出
+ * @description Re-exports all public APIs from the form module:
+ * FormRuleEngine, FormRegistry, FormCondition, and all related types.
+ * 重新导出表单模块的所有公开 API：规则引擎、控件注册表、条件解析器及相关类型。
+ */
+export { FormRuleEngine, FormRegistry } from './autoform';
+export { FormCondition } from './condition';

package/dist/core/autoform/types.js

@@ -0,0 +1,7 @@
+/**
+ * @file Form module shared types / 表单模块共享类型定义
+ * @description Core type definitions for the form dependency rule engine, migrated from components/form
+ * to eliminate circular dependency between core and components.
+ * 表单依赖联动规则引擎核心类型定义，从 components/form 迁移至此，消除 core 与 components 之间的循环依赖。
+ */
+export {};

package/dist/core/datahub/config/strategy.d.ts

@@ -10,7 +10,7 @@
  *              - Query strategy: cacheable, dedupable, retryable
  *              - Submit strategy: idempotent guard, no cache, no retry
  */
-import type { DataHubStrategyConfig } from '../types';
+import type { DataHubStrategyConfig } from '../../datahub/types';
 /**
  * 根据 URL 解析请求策略 / Resolve request strategy based on URL
  * @param url - 请求地址 / Request URL

package/dist/core/datahub/config/strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/config/strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAuB,MAAM,UAAU,CAAC;AA0B3E;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAIlE"}
+{"version":3,"file":"strategy.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/config/strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAuB,MAAM,qBAAqB,CAAC;AA0BtF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAIlE"}

package/dist/core/datahub/config/strategy.js

@@ -0,0 +1,50 @@
+/**
+ * @file 策略配置 / Strategy Configuration
+ * @description 根据 URL 自动识别请求策略（查询 or 提交），
+ *              并返回对应的策略配置。策略决定了请求经过哪些中间件处理：
+ *              - 查询策略（query）：可缓存、可去重、可重试
+ *              - 提交策略（submit）：幂等防护、不缓存、不重试
+ *              Automatically identifies the request strategy (query or submit) based on the URL,
+ *              and returns the corresponding strategy config. Strategy determines which middleware
+ *              the request passes through:
+ *              - Query strategy: cacheable, dedupable, retryable
+ *              - Submit strategy: idempotent guard, no cache, no retry
+ */
+import { isQueryAction } from '../../datahub/utils/is-query';
+/**
+ * 策略映射表 / Strategy mapping table
+ * @description 定义两种策略的完整行为配置 / Defines the complete behavior config for both strategies
+ */
+const STRATEGY_MAP = {
+    /** 查询策略：结果可缓存，并发请求可去重，失败可重试 / Query strategy: cacheable results, dedupable concurrent requests, retryable on failure */
+    query: {
+        type: 'query',
+        cacheable: true,
+        dedupable: true,
+        idempotent: false,
+        retryable: true,
+    },
+    /** 提交策略：不缓存，不去重，需幂等防护，失败不重试 / Submit strategy: no cache, no dedup, idempotent guard required, no retry on failure */
+    submit: {
+        type: 'submit',
+        cacheable: false,
+        dedupable: false,
+        idempotent: true,
+        retryable: false,
+    },
+};
+/**
+ * 根据 URL 解析请求策略 / Resolve request strategy based on URL
+ * @param url - 请求地址 / Request URL
+ * @returns 策略配置（返回副本，避免外部修改影响全局配置）/ Strategy config (returns a copy to prevent external mutation)
+ *
+ * @example
+ * resolveStrategy('/order/query')   // { type: 'query', cacheable: true, ... }
+ * resolveStrategy('/order/submit')  // { type: 'submit', idempotent: true, ... }
+ * resolveStrategy('/order/pay')     // { type: 'submit', idempotent: true, ... }
+ */
+export function resolveStrategy(url) {
+    const type = isQueryAction(url) ? 'query' : 'submit';
+    // 返回副本，防止外部修改影响策略映射表 / Return a copy to prevent external mutation of the strategy map
+    return { ...STRATEGY_MAP[type] };
+}

package/dist/core/datahub/core/adapter/fetch-adapter.d.ts

@@ -16,7 +16,7 @@
  *              4. Support merging external signal with internal timeout signal
  *              5. Propagate traceId via request header
  */
-import type { DataHubAdapter, DataHubAdapterRequest, DataHubAdapterResponse } from '../../types';
+import type { DataHubAdapter, DataHubAdapterRequest, DataHubAdapterResponse } from '../../../datahub/types';
 /**
  * FetchAdapter - 原生 fetch 适配器 / Native fetch adapter
  * @implements {DataHubAdapter}

package/dist/core/datahub/core/adapter/fetch-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/core/datahub/core/adapter/fetch-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAKjG;;;GAGG;AACH,qBAAa,YAAa,YAAW,cAAc;IACjD,wCAAwC;IACxC,SAAgB,IAAI,WAAW;IAE/B;;;;;OAKG;IACU,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IA4DrC;;OAEG;IACI,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAOhC"}
+{"version":3,"file":"fetch-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/core/datahub/core/adapter/fetch-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAKzG;;;GAGG;AACH,qBAAa,YAAa,YAAW,cAAc;IACjD,wCAAwC;IACxC,SAAgB,IAAI,WAAW;IAE/B;;;;;OAKG;IACU,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,GAAG,EAAE,qBAAqB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IA4DrC;;OAEG;IACI,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAOhC"}