@sepveneto/dnde-core 0.6.3 → 0.6.5

package/dist/{Node-B7pDsvZF.d.cts → capability-Ce3qGTm3.d.cts}

@@ -1,8 +1,126 @@
+import { FormItemProps, FormItemRule, InputProps, ElOption, SelectProps, InputNumberProps, SwitchProps, RadioGroupProps, ElRadio, ElRadioButton, DatePickerProps, ColorPickerProps, CheckboxProps, UploadRequestOptions } from 'element-plus';
 import * as vue from 'vue';
 import { CSSProperties } from 'vue';
-import { FormItemRule, UploadRequestOptions, FormItemProps, InputProps, ElOption, SelectProps, InputNumberProps, SwitchProps, RadioGroupProps, ElRadio, ElRadioButton, DatePickerProps, ColorPickerProps, CheckboxProps } from 'element-plus';
 import Validator from 'async-validator';
 
+type Option = InstanceType<typeof ElOption>['$props'];
+type RadioOption = InstanceType<typeof ElRadio>['$props'];
+type RadioButtonOption = InstanceType<typeof ElRadioButton>['$props'];
+interface SchemaItemBase {
+    /** @private */
+    _role?: string;
+    label: string;
+    key: string;
+    /** Capability range used by DSL scope validation. */
+    scope?: FieldScope;
+    /** A field may be discovered but not written by the configuration Agent. */
+    readOnly?: boolean;
+    formItem?: Partial<FormItemProps>;
+    rules?: FormItemRule | FormItemRule[];
+}
+interface SchemaItemInput extends SchemaItemBase {
+    type: 'input';
+    attrs?: InputProps;
+}
+interface SchemaItemSelect extends SchemaItemBase {
+    type: 'select';
+    options?: Option[];
+    attrs?: SelectProps;
+    link?: Record<string | number, SchemaItem[]>;
+}
+interface SchemaItemNumber extends SchemaItemBase {
+    type: 'number';
+    attrs?: InputNumberProps;
+}
+interface SchemaItemSwitch extends SchemaItemBase {
+    type: 'switch';
+    attrs?: SwitchProps;
+}
+interface SchemaItemDatetimePicker extends SchemaItemBase {
+    type: 'datetimePicker';
+    attrs?: DatePickerProps;
+}
+interface SchemaItemColorPicker extends SchemaItemBase {
+    type: 'colorPicker';
+    attrs?: ColorPickerProps;
+}
+interface SchemaItemCheckbox extends SchemaItemBase {
+    type: 'checkbox';
+    attrs?: CheckboxProps;
+}
+interface SchemaItemCustom extends SchemaItemBase {
+    type: 'custom';
+    name: string;
+    attrs?: Record<string, any>;
+}
+interface SchemaItemStyleNumber extends SchemaItemBase {
+    type: 'styleNumber';
+}
+interface SchemaItemRadio extends SchemaItemBase {
+    type: 'radio';
+    attrs?: RadioGroupProps;
+    options?: RadioOption[];
+    link?: Record<string | number, SchemaItem[]>;
+}
+interface SchemaItemRadioButton extends SchemaItemBase {
+    type: 'radioButton';
+    attrs?: RadioGroupProps;
+    options?: RadioButtonOption[];
+    link?: Record<string | number, SchemaItem[]>;
+}
+type SchemaItem = SchemaItemInput | SchemaItemSelect | SchemaItemNumber | SchemaItemSwitch | SchemaItemCustom | SchemaItemStyleNumber | SchemaItemRadio | SchemaItemRadioButton | SchemaItemDatetimePicker | SchemaItemColorPicker | SchemaItemCheckbox;
+declare class Widget {
+    name: string;
+    view: string;
+    _data: IWidget;
+    container: IWidget['container'];
+    constructor(widget: IWidget);
+    clone(): Widget;
+    get icon(): string | undefined;
+    get props(): SchemaItem[];
+    get style(): SchemaItem[];
+    get defaultStyle(): (vue.CSSProperties & WidgetPos) | undefined;
+    get defaultData(): any[] | Record<string, any> | undefined;
+    get agent(): WidgetAgent | undefined;
+    get draggable(): boolean;
+    get isFixed(): false | "header" | "footer" | undefined;
+    get visible(): boolean;
+    get validatorProps(): Validator;
+    get validatorStyle(): Validator;
+}
+
+declare class Node {
+    level: number;
+    wid: string;
+    widget: Readonly<Widget>;
+    parent?: Node;
+    list: Node[];
+    data: Record<string, any>;
+    style: CSSProperties;
+    hovering: boolean;
+    dragging: boolean;
+    constructor(widget: Widget, info?: {
+        uuid?: string;
+        props?: Node['data'];
+        style?: Node['style'];
+        list?: Node['list'];
+    });
+    get info(): {
+        style: CSSProperties;
+    };
+    get isContainer(): boolean;
+    get hasList(): boolean;
+    get mouseover(): boolean;
+    get type(): string;
+    get name(): string;
+    get visible(): boolean | undefined;
+    validate(only?: boolean): Promise<string | undefined>;
+    triggerHover(hover: boolean): void;
+    setList(list: Node[]): void;
+    copy(): Node;
+    parse(): Record<string, any>;
+}
+
 interface WidgetPos {
     x?: number;
     y?: number;
@@ -11,24 +129,43 @@ interface WidgetPos {
 }
 /** 布局子 Agent 的输出项：选中的组件 + 要放进去的元素 */
 interface WidgetLayoutItem {
-    widget: string;
-    items: Array<{
+    widget?: string;
+    items?: Array<{
         category: string;
         id: any;
     }>;
+    componentKey?: string;
+    changes?: Record<string, any>;
+}
+interface WidgetCapabilityExecutionContext {
+    node: Node;
+    args: Record<string, unknown>;
+    context: Record<string, unknown>;
 }
+type WidgetCapabilityAdapter = (input: WidgetCapabilityExecutionContext) => void | Record<string, unknown> | Promise<void | Record<string, unknown>>;
 interface WidgetAgent {
-    description: string;
+    /**
+     * 组件的功能描述。
+     * 用于组件检索、用户意图匹配和编辑时的组件定位。
+     */
+    description?: string;
+    /**
+     * 初始化页面时使用的布局信息。
+     */
     layout?: {
-        direction: 'row' | 'column';
-        density: 'low' | 'medium' | 'high';
-        priority: 'large';
+        /**
+         * 组件的布局特征与适用场景。
+         */
+        description: string;
+        estimatedSize: string;
+        priority: 'large' | 'medium' | 'small' | 'tiny';
     };
     /**
      * 布局子 Agent 结束、组件创建完成后，由业务侧决定数据如何更新到组件里。
      *
      * @param node 已创建的组件节点
      * @param item 布局结果项（选中的组件 + 元素引用）
+     * @param state 当前 Agent Run 的上下文，包含业务工具准备的数据
      */
     update?: (node: Node, item: WidgetLayoutItem, state: Record<string, unknown>) => void;
 }
@@ -154,134 +291,68 @@ interface EditorData {
     settings?: EditorSettings;
 }
 
-type Option = InstanceType<typeof ElOption>['$props'];
-type RadioOption = InstanceType<typeof ElRadio>['$props'];
-type RadioButtonOption = InstanceType<typeof ElRadioButton>['$props'];
-interface SchemaItemBase {
-    /** @private */
-    _role?: string;
-    label: string;
+type FieldScope = 'style' | 'content' | 'layout';
+type CapabilityValueType = 'string' | 'number' | 'integer' | 'boolean' | 'enum' | 'array' | 'object' | 'unknown';
+interface WidgetFieldCapability {
+    source: 'prop';
     key: string;
-    formItem?: Partial<FormItemProps>;
-    rules?: FormItemRule | FormItemRule[];
-}
-interface SchemaItemInput extends SchemaItemBase {
-    type: 'input';
-    attrs?: InputProps;
-}
-interface SchemaItemSelect extends SchemaItemBase {
-    type: 'select';
-    options?: Option[];
-    attrs?: SelectProps;
-    link?: Record<string | number, SchemaItem[]>;
-}
-interface SchemaItemNumber extends SchemaItemBase {
-    type: 'number';
-    attrs?: InputNumberProps;
-}
-interface SchemaItemSwitch extends SchemaItemBase {
-    type: 'switch';
-    attrs?: SwitchProps;
-}
-interface SchemaItemDatetimePicker extends SchemaItemBase {
-    type: 'datetimePicker';
-    attrs?: DatePickerProps;
-}
-interface SchemaItemColorPicker extends SchemaItemBase {
-    type: 'colorPicker';
-    attrs?: ColorPickerProps;
-}
-interface SchemaItemCheckbox extends SchemaItemBase {
-    type: 'checkbox';
-    attrs?: CheckboxProps;
+    label: string;
+    valueType: CapabilityValueType;
+    scope: FieldScope;
+    required: boolean;
+    readOnly: boolean;
+    enum?: unknown[];
+    minimum?: number;
+    maximum?: number;
+    default?: unknown;
 }
-interface SchemaItemCustom extends SchemaItemBase {
-    type: 'custom';
+interface WidgetCustomCapability {
     name: string;
-    attrs?: Record<string, any>;
+    inputSchema?: Record<string, unknown>;
+    semantics: 'append' | 'replace' | 'remove' | 'command';
+    idempotent: boolean;
+    destructive: boolean;
+    writableScope: FieldScope;
 }
-interface SchemaItemStyleNumber extends SchemaItemBase {
-    type: 'styleNumber';
+interface WidgetCustomTypeCapability {
+    type: string;
+    capabilities: WidgetCustomCapability[];
 }
-interface SchemaItemRadio extends SchemaItemBase {
-    type: 'radio';
-    attrs?: RadioGroupProps;
-    options?: RadioOption[];
-    link?: Record<string | number, SchemaItem[]>;
+interface StaticOption {
+    id: string;
+    name: string;
+    aliases: string[];
+    value: unknown;
+    types: string[];
 }
-interface SchemaItemRadioButton extends SchemaItemBase {
-    type: 'radioButton';
-    attrs?: RadioGroupProps;
-    options?: RadioButtonOption[];
-    link?: Record<string | number, SchemaItem[]>;
+interface WidgetCapabilityRegistration {
+    customTypes?: WidgetCustomTypeCapability[];
+    staticOptions?: StaticOption[];
 }
-type SchemaItem = SchemaItemInput | SchemaItemSelect | SchemaItemNumber | SchemaItemSwitch | SchemaItemCustom | SchemaItemStyleNumber | SchemaItemRadio | SchemaItemRadioButton | SchemaItemDatetimePicker | SchemaItemColorPicker | SchemaItemCheckbox;
-declare class Widget {
+type WidgetCapabilityRegistry = Record<string, WidgetCapabilityRegistration>;
+interface WidgetCapability {
+    type: string;
     name: string;
-    view: string;
-    _data: IWidget;
-    container: IWidget['container'];
-    constructor(widget: IWidget);
-    clone(): Widget;
-    get icon(): string | undefined;
-    get props(): SchemaItem[];
-    get style(): SchemaItem[];
-    get defaultStyle(): (vue.CSSProperties & WidgetPos) | undefined;
-    get defaultData(): any[] | Record<string, any> | undefined;
-    get agent(): WidgetAgent | undefined;
-    get draggable(): boolean;
-    get isFixed(): false | "header" | "footer" | undefined;
-    get visible(): boolean;
-    get validatorProps(): Validator;
-    get validatorStyle(): Validator;
-}
-
-declare class Node {
-    level: number;
-    wid: string;
-    widget: Readonly<Widget>;
-    parent?: Node;
-    list: Node[];
-    data: Record<string, any>;
-    style: CSSProperties;
-    hovering: boolean;
-    dragging: boolean;
-    constructor(widget: Widget, info?: {
-        uuid?: string;
-        props?: Node['data'];
-        style?: Node['style'];
-        list?: Node['list'];
-    });
-    get info(): {
-        style: CSSProperties;
-    };
-    get isContainer(): boolean;
-    get hasList(): boolean;
-    get mouseover(): boolean;
-    get type(): string;
-    get name(): string;
-    get visible(): boolean | undefined;
-    validate(only?: boolean): Promise<string | undefined>;
-    triggerHover(hover: boolean): void;
-    setList(list: Node[]): void;
-    copy(): Node;
-    parse(): Record<string, any>;
+    description: string;
+    defaultData: Record<string, any>;
+    defaultStyle: Record<string, any>;
+    fields: WidgetFieldCapability[];
+    customTypes: WidgetCustomTypeCapability[];
+    staticOptions: StaticOption[];
 }
-declare class RootNode {
-    level: number;
-    wid: string;
-    widget: Readonly<Widget>;
-    parent?: Node;
-    list: any[];
-    data: Record<string, any>;
-    style: CSSProperties;
-    hovering: boolean;
-    dragging: boolean;
-    constructor(widget: Widget, info?: {
-        props?: Node['data'];
-        style?: Node['style'];
-        list?: Node['list'];
-    });
+interface CapabilityCatalog {
+    catalogVersion: '1.0';
+    widgets: WidgetCapability[];
 }
+/**
+ * Convert live widget declarations into the stable catalog consumed by DSL
+ * validation. Custom schema entries are advertised from the schema itself;
+ * executable capabilities must be registered by the host.
+ */
+declare function createCapabilityCatalog(widgets: IWidget[], registry?: WidgetCapabilityRegistry): CapabilityCatalog;
+declare function findWidgetCapability(catalog: CapabilityCatalog, type: string): WidgetCapability | undefined;
+declare function findFieldCapability(widget: WidgetCapability, key: string): WidgetFieldCapability | undefined;
+declare function findCustomCapability(widget: WidgetCapability, type: string, name: string): WidgetCustomCapability | undefined;
+declare function listStaticOptions(catalog: CapabilityCatalog, widgetTypes?: string[], types?: string[]): StaticOption[];
 
-export { type Base as B, type DisabledItemFn as D, type EditorConfig as E, type IWidget as I, Node as N, type Option as O, type RadioOption as R, type SchemaOther as S, type WidgetPos as W, type WidgetLayoutItem as a, type WidgetAgent as b, type SchemaBox as c, type ISchema as d, type EditorSchema as e, type EditorWidget as f, type EditorRoute as g, type EditorWidgets as h, isBox as i, type EditorSettings as j, type EditorData as k, type SchemaItem as l, type RadioButtonOption as m, Widget as n, RootNode as o, type SchemaItemCustom as p };
+export { type EditorRoute as A, type Base as B, type CapabilityValueType as C, type DisabledItemFn as D, type EditorConfig as E, type FieldScope as F, type EditorWidgets as G, type EditorSettings as H, type IWidget as I, type EditorData as J, Node as N, type Option as O, type RadioOption as R, type SchemaItemCustom as S, Widget as W, type RadioButtonOption as a, type SchemaItem as b, type WidgetFieldCapability as c, type WidgetCustomCapability as d, type WidgetCustomTypeCapability as e, type StaticOption as f, type WidgetCapabilityRegistration as g, type WidgetCapabilityRegistry as h, type WidgetCapability as i, type CapabilityCatalog as j, createCapabilityCatalog as k, findWidgetCapability as l, findFieldCapability as m, findCustomCapability as n, listStaticOptions as o, type WidgetPos as p, type WidgetLayoutItem as q, type WidgetCapabilityExecutionContext as r, type WidgetCapabilityAdapter as s, type WidgetAgent as t, type SchemaOther as u, type SchemaBox as v, type ISchema as w, isBox as x, type EditorSchema as y, type EditorWidget as z };