@aithe/aithe-ui 26.2.3 → 26.3.2

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/autoview.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @file Auto-view registry & renderer types / 只读视图注册表与渲染器类型
+ * @description Defines the extension point for custom read-only field renderers.
+ *              Zero Lit dependency — pure types and a static registry, mirroring FormRegistry.
+ *              定义自定义只读字段渲染器的扩展点。
+ *              零 Lit 依赖 — 仅类型与静态注册表，与 FormRegistry 对称。
+ */
+import type { TemplateResult } from 'lit';
+import type { FormFieldConfig, FormItemOption } from './types';
+/**
+ * Extended field configuration for read-only views.
+ * 只读视图的扩展字段配置。
+ * @description Extends FormFieldConfig with optional display-only properties.
+ *             All extra fields are optional, so a plain FormFieldConfig can be used directly.
+ *             在 FormFieldConfig 基础上追加可选的展示属性，
+ *             全部可选，因此可直接传入纯 FormFieldConfig。
+ */
+export interface ViewFieldConfig extends FormFieldConfig {
+    /** Filter expression for formatting the value, e.g. "amount" / "date yyyy-MM-dd" / "empty". 值过滤器表达式。 */
+    filter?: string;
+    /** Placeholder text for empty values; falls back to the component's empty-text. 空值占位文本，回退到组件的全局 empty-text。 */
+    emptyText?: string;
+    /** Column span in the grid layout. Default 1. 网格中占用的列数，默认 1。 */
+    span?: number;
+    /** Row span in the grid layout. Default 1. 网格中占用的行数，默认 1。 */
+    rowspan?: number;
+    /** Content text alignment. 内容文本对齐方式。 */
+    align?: 'left' | 'center' | 'right';
+    /** Whether to hide the label cell. 是否隐藏标签单元格。 */
+    hideLabel?: boolean;
+}
+/**
+ * Context passed to a read-only view renderer.
+ * 传递给只读视图渲染器的上下文。
+ */
+export interface ViewRenderContext {
+    /** Transformed value (boolean for switch, number for number, string[] for checkbox, etc.). 转换后的值。 */
+    value: unknown;
+    /** Raw string value as stored in data. 原始字符串值。 */
+    rawValue: string;
+    /** Options for select/radio/checkbox controls. 选择类控件的选项。 */
+    options: FormItemOption[];
+    /** Full field configuration. 完整字段配置。 */
+    field: ViewFieldConfig;
+    /** Resolved empty placeholder text. 解析后的空值占位文本。 */
+    emptyText: string;
+}
+/**
+ * Read-only view renderer function. Returns a TemplateResult to be injected into a desc-item slot.
+ * 只读视图渲染函数，返回 TemplateResult 注入 desc-item 的 slot。
+ */
+export type ViewRenderer = (ctx: ViewRenderContext) => TemplateResult;
+/**
+ * Read-only view control type definition.
+ * 只读视图控件类型定义。
+ */
+export interface ViewControlDefinition {
+    /** Control type matching the `type` field in ViewFieldConfig. 匹配 ViewFieldConfig 中 type 字段的控件类型。 */
+    type: string;
+    /** Renderer function. 渲染函数。 */
+    render: ViewRenderer;
+}
+/**
+ * Read-only view control type registry. Allows registering custom renderers
+ * to extend autoview with arbitrary display logic for specific field types.
+ * 只读视图控件类型注册表。允许注册自定义渲染器，
+ * 以特定字段类型的任意展示逻辑扩展 autoview。
+ */
+export declare class ViewRegistry {
+    private static readonly _views;
+    /**
+     * Register a custom read-only renderer.
+     * 注册自定义只读渲染器。
+     * @throws Error if the type is already registered. 类型已注册时抛错。
+     */
+    static register(definition: ViewControlDefinition): void;
+    /** Unregister a view type. Returns whether the type existed. 注销视图类型，返回类型是否存在。 */
+    static unregister(type: string): boolean;
+    /** Get a view definition by type. 按 type 获取视图定义。 */
+    static get(type: string): ViewControlDefinition | undefined;
+    /** Check whether a view type is registered. 检查视图类型是否已注册。 */
+    static has(type: string): boolean;
+    /** List all registered view type names. 列出所有已注册的视图类型名。 */
+    static types(): string[];
+}
+//# sourceMappingURL=autoview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"autoview.d.ts","sourceRoot":"","sources":["../../../src/core/autoform/autoview.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,wGAAwG;IACxG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+GAA+G;IAC/G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,qGAAqG;IACrG,KAAK,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,wCAAwC;IACxC,KAAK,EAAE,eAAe,CAAC;IACvB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,cAAc,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,oGAAoG;IACpG,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA4C;IAE1E;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,GAAG,IAAI;IAUxD,iFAAiF;IACjF,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIxC,oDAAoD;IACpD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI3D,4DAA4D;IAC5D,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,0DAA0D;IAC1D,MAAM,CAAC,KAAK,IAAI,MAAM,EAAE;CAGzB"}

package/dist/core/autoform/autoview.js

@@ -0,0 +1,37 @@
+/**
+ * Read-only view control type registry. Allows registering custom renderers
+ * to extend autoview with arbitrary display logic for specific field types.
+ * 只读视图控件类型注册表。允许注册自定义渲染器，
+ * 以特定字段类型的任意展示逻辑扩展 autoview。
+ */
+export class ViewRegistry {
+    static { this._views = new Map(); }
+    /**
+     * Register a custom read-only renderer.
+     * 注册自定义只读渲染器。
+     * @throws Error if the type is already registered. 类型已注册时抛错。
+     */
+    static register(definition) {
+        if (ViewRegistry._views.has(definition.type)) {
+            throw new Error(`[ViewRegistry] View type "${definition.type}" is already registered. ` +
+                `Call ViewRegistry.unregister() first if you want to replace it.`);
+        }
+        ViewRegistry._views.set(definition.type, definition);
+    }
+    /** Unregister a view type. Returns whether the type existed. 注销视图类型，返回类型是否存在。 */
+    static unregister(type) {
+        return ViewRegistry._views.delete(type);
+    }
+    /** Get a view definition by type. 按 type 获取视图定义。 */
+    static get(type) {
+        return ViewRegistry._views.get(type);
+    }
+    /** Check whether a view type is registered. 检查视图类型是否已注册。 */
+    static has(type) {
+        return ViewRegistry._views.has(type);
+    }
+    /** List all registered view type names. 列出所有已注册的视图类型名。 */
+    static types() {
+        return Array.from(ViewRegistry._views.keys());
+    }
+}