@sparqjs/schema-core 0.1.0

package/dist/action/action-runtime.d.ts

@@ -0,0 +1,91 @@
+import type { ActionAfterEffect, ConfirmConfig, RenderMode, ResourceDescriptor, ResourceSchema } from '@sparqjs/schema-protocol';
+import type { DataAdapter } from '../data';
+import { type Diagnostic } from '../diagnostics';
+import type { SchemaRuntimeHooks } from '../hooks';
+import type { ResolvedAction } from './types';
+/**
+ * ActionRuntime 创建配置。
+ */
+export interface CreateActionRuntimeOptions {
+    /** 数据适配器。custom、delete 等动作会用到。 */
+    dataAdapter?: DataAdapter;
+    /** Runtime hooks。 */
+    hooks?: SchemaRuntimeHooks;
+    /** 确认处理器。返回 false 表示取消动作。 */
+    resolveConfirm?: ActionConfirmResolver;
+}
+/**
+ * 动作确认处理器。
+ */
+export type ActionConfirmResolver = (input: ActionConfirmInput) => boolean | Promise<boolean>;
+/**
+ * 动作确认输入。
+ */
+export interface ActionConfirmInput {
+    /** 当前动作。 */
+    action: ResolvedAction;
+    /** 当前动作确认配置。 */
+    confirm: ConfirmConfig;
+    /** 当前动作执行上下文。 */
+    context: RunActionContext;
+}
+/**
+ * ActionRuntime。
+ */
+export interface ActionRuntime {
+    /** 执行动作。 */
+    run(action: ResolvedAction, context: RunActionContext): Promise<ActionRunResult>;
+}
+/**
+ * 动作执行上下文。
+ */
+export interface RunActionContext {
+    /** 当前资源 schema。使用 hooks 时必须提供。 */
+    schema?: ResourceSchema;
+    /** 当前资源元信息。 */
+    resourceMeta?: ResourceDescriptor;
+    /** 当前资源编码。 */
+    resource?: string;
+    /** 当前渲染模式。使用 hooks 时必须提供。 */
+    mode?: RenderMode;
+    /** 当前 view 名称。使用 hooks 时必须提供。 */
+    viewName?: string;
+    /** 当前 view 名称。 */
+    view?: string;
+    /** 当前 runtime scope。 */
+    scope?: unknown;
+    /** 当前行主键。 */
+    id?: unknown;
+    /** 当前行记录。 */
+    record?: Record<string, unknown>;
+    /** 当前选中项。 */
+    selection?: unknown[];
+    /** 当前表单值。 */
+    formValues?: Record<string, unknown>;
+    /** 附加参数。 */
+    payload?: unknown;
+    /** 内部确认标记。session 层已处理确认时使用。 */
+    confirmed?: boolean;
+}
+/**
+ * 动作执行结果。
+ */
+export interface ActionRunResult {
+    /** 动作是否成功执行。 */
+    ok: boolean;
+    /** 动作返回值。 */
+    result?: unknown;
+    /** 需要 UI/runtime 后续应用的效果。 */
+    effects: ActionAfterEffect[];
+    /** 执行过程诊断。 */
+    diagnostics: Diagnostic[];
+    /** 是否被 beforeAction 或 confirm 阻止。 */
+    cancelled?: boolean;
+}
+/**
+ * 创建 ActionRuntime。
+ *
+ * 第一版只返回 effects，不直接操作 UI、弹窗、刷新或跳转。
+ */
+export declare function createActionRuntime(options?: CreateActionRuntimeOptions): ActionRuntime;
+//# sourceMappingURL=action-runtime.d.ts.map

package/dist/action/action-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-runtime.d.ts","sourceRoot":"","sources":["../../src/action/action-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,cAAc,EACjB,MAAM,0BAA0B,CAAA;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACvC,kCAAkC;IAClC,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,qBAAqB;IACrB,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,qBAAqB,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE7F;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,YAAY;IACZ,MAAM,EAAE,cAAc,CAAA;IACtB,gBAAgB;IAChB,OAAO,EAAE,aAAa,CAAA;IACtB,iBAAiB;IACjB,OAAO,EAAE,gBAAgB,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,YAAY;IACZ,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACnF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,kCAAkC;IAClC,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,eAAe;IACf,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wBAAwB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,aAAa;IACb,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,aAAa;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,aAAa;IACb,SAAS,CAAC,EAAE,OAAO,EAAE,CAAA;IACrB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,YAAY;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gCAAgC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,gBAAgB;IAChB,EAAE,EAAE,OAAO,CAAA;IACX,aAAa;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,6BAA6B;IAC7B,OAAO,EAAE,iBAAiB,EAAE,CAAA;IAC5B,cAAc;IACd,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,aAAa,CAM3F"}

package/dist/action/action-runtime.js

@@ -0,0 +1,172 @@
+import { createDiagnosticCollector } from '../diagnostics';
+import { BUILTIN_ACTION_DELETE, BUILTIN_ACTION_RELOAD } from './builtin-actions';
+/**
+ * 创建 ActionRuntime。
+ *
+ * 第一版只返回 effects，不直接操作 UI、弹窗、刷新或跳转。
+ */
+export function createActionRuntime(options = {}) {
+    return {
+        run(action, context) {
+            return runAction(action, context, options);
+        },
+    };
+}
+/**
+ * 执行动作。
+ */
+async function runAction(action, context, options) {
+    const diagnostics = createDiagnosticCollector();
+    const beforeResult = await options.hooks?.beforeAction?.({
+        ...createHookBaseContext(context),
+        action,
+        record: context.record,
+        selection: context.selection,
+        formValues: context.formValues,
+    });
+    if (beforeResult === false) {
+        return {
+            ok: false,
+            cancelled: true,
+            effects: [],
+            diagnostics: diagnostics.toArray(),
+        };
+    }
+    if (action.confirm && !context.confirmed && !options.resolveConfirm) {
+        diagnostics.error({
+            code: 'CONFIRM_ACTION_UNAVAILABLE',
+            message: `Action "${action.action}" requires confirmation, but no confirmation resolver is configured.`,
+            hint: 'Provide resolveConfirm before executing actions that declare confirm.',
+            source: 'runtime',
+        });
+        return {
+            ok: false,
+            cancelled: true,
+            effects: [],
+            diagnostics: diagnostics.toArray(),
+        };
+    }
+    if (action.confirm && options.resolveConfirm && !context.confirmed) {
+        const confirmed = await options.resolveConfirm({
+            action,
+            confirm: action.confirm,
+            context,
+        });
+        if (!confirmed) {
+            return {
+                ok: false,
+                cancelled: true,
+                effects: [],
+                diagnostics: diagnostics.toArray(),
+            };
+        }
+    }
+    try {
+        const result = await executeAction(action, context, options, diagnostics);
+        await options.hooks?.afterAction?.({
+            ...createHookBaseContext(context),
+            action,
+            record: context.record,
+            selection: context.selection,
+            formValues: context.formValues,
+        });
+        return {
+            ok: true,
+            result,
+            effects: collectEffects(action.afterSuccess),
+            diagnostics: diagnostics.toArray(),
+        };
+    }
+    catch (error) {
+        await options.hooks?.onActionError?.({
+            ...createHookBaseContext(context),
+            action,
+            record: context.record,
+            selection: context.selection,
+            formValues: context.formValues,
+            error,
+        });
+        return {
+            ok: false,
+            result: error,
+            effects: collectEffects(action.afterError),
+            diagnostics: diagnostics.toArray(),
+        };
+    }
+}
+/**
+ * 执行动作主体。
+ */
+async function executeAction(action, context, options, diagnostics) {
+    if (action.kind === 'custom') {
+        if (!options.dataAdapter?.executeAction) {
+            diagnostics.error({
+                code: 'ACTION_NOT_FOUND',
+                message: `No dataAdapter.executeAction configured for action "${action.action}".`,
+                hint: 'Provide dataAdapter.executeAction or register a builtin action handler.',
+            });
+            return undefined;
+        }
+        return options.dataAdapter.executeAction({
+            resource: context.resource,
+            view: context.view,
+            scope: context.scope,
+            action: action.action,
+            handler: action.handler,
+            id: context.id,
+            record: context.record,
+            selection: context.selection,
+            formValues: context.formValues,
+            payload: context.payload,
+        });
+    }
+    if (action.action === BUILTIN_ACTION_DELETE) {
+        if (!options.dataAdapter?.remove) {
+            diagnostics.error({
+                code: 'ACTION_NOT_FOUND',
+                message: 'No dataAdapter.remove configured for delete action.',
+                hint: 'Provide dataAdapter.remove to execute delete.',
+            });
+            return undefined;
+        }
+        return options.dataAdapter.remove({
+            resource: context.resource,
+            view: context.view,
+            scope: context.scope,
+            id: context.id,
+            record: context.record,
+            payload: context.payload,
+        });
+    }
+    if (action.action === BUILTIN_ACTION_RELOAD) {
+        return undefined;
+    }
+    return {
+        intent: action.action,
+    };
+}
+/**
+ * 收集动作效果。
+ */
+function collectEffects(effect) {
+    return effect ? [effect] : [];
+}
+/**
+ * 构造 hook 基础上下文。
+ */
+function createHookBaseContext(context) {
+    if (!context.schema) {
+        throw new Error('Action hooks require runContext.schema.');
+    }
+    if (!context.mode) {
+        throw new Error('Action hooks require runContext.mode.');
+    }
+    return {
+        schema: context.schema,
+        resource: context.resourceMeta,
+        mode: context.mode,
+        viewName: context.viewName,
+        scope: context.scope,
+    };
+}
+//# sourceMappingURL=action-runtime.js.map

package/dist/action/action-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-runtime.js","sourceRoot":"","sources":["../../src/action/action-runtime.ts"],"names":[],"mappings":"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"}

package/dist/action/builtin-actions.d.ts

@@ -0,0 +1,35 @@
+import type { ActionDefinition } from '@sparqjs/schema-protocol';
+export declare const BUILTIN_ACTION_CREATE = "create";
+export declare const BUILTIN_ACTION_ATTACH = "attach";
+export declare const BUILTIN_ACTION_CREATE_CHILD = "create_child";
+export declare const BUILTIN_ACTION_UPDATE = "update";
+export declare const BUILTIN_ACTION_VIEW = "view";
+export declare const BUILTIN_ACTION_DELETE = "delete";
+export declare const BUILTIN_ACTION_DETACH = "detach";
+export declare const BUILTIN_ACTION_RELOAD = "reload";
+export declare const BUILTIN_ACTION_IMPORT = "import";
+export declare const BUILTIN_ACTION_EXPORT = "export";
+export declare const BUILTIN_ACTION_DUPLICATE = "duplicate";
+export declare const BUILTIN_ACTION_PRINT = "print";
+export declare const BUILTIN_ACTION_RECYCLE_BIN = "recycle_bin";
+export declare const BUILTIN_ACTION_RETURN_LIST = "return_list";
+export declare const BUILTIN_ACTION_RESTORE = "restore";
+export declare const BUILTIN_ACTION_PURGE = "purge";
+export declare const BUILTIN_ACTION_MORE = "more";
+export declare const BUILTIN_ACTION_SAVE_DRAFT = "save_draft";
+export declare const BUILTIN_ACTION_SUBMIT = "submit";
+export declare const BUILTIN_ACTION_RESET = "reset";
+export declare const BUILTIN_ACTION_CANCEL = "cancel";
+export declare const BUILTIN_ACTION_SEARCH_SUBMIT = "search.submit";
+export declare const BUILTIN_ACTION_SEARCH_RESET = "search.reset";
+/**
+ * 内置动作默认定义。
+ *
+ * 这里只描述动作的基础语义，不执行动作。真正执行由后续 ActionRuntime 负责。
+ */
+export declare const builtinActionDefinitions: Record<string, ActionDefinition>;
+/**
+ * 获取内置动作定义。
+ */
+export declare function getBuiltinActionDefinition(action: string): ActionDefinition | undefined;
+//# sourceMappingURL=builtin-actions.d.ts.map

package/dist/action/builtin-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-actions.d.ts","sourceRoot":"","sources":["../../src/action/builtin-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAqBhE,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,2BAA2B,iBAAiB,CAAA;AACzD,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,mBAAmB,SAAS,CAAA;AACzC,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,wBAAwB,cAAc,CAAA;AACnD,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAC3C,eAAO,MAAM,0BAA0B,gBAAgB,CAAA;AACvD,eAAO,MAAM,0BAA0B,gBAAgB,CAAA;AACvD,eAAO,MAAM,sBAAsB,YAAY,CAAA;AAC/C,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAC3C,eAAO,MAAM,mBAAmB,SAAS,CAAA;AACzC,eAAO,MAAM,yBAAyB,eAAe,CAAA;AACrD,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAC3C,eAAO,MAAM,qBAAqB,WAAW,CAAA;AAC7C,eAAO,MAAM,4BAA4B,kBAAkB,CAAA;AAC3D,eAAO,MAAM,2BAA2B,iBAAiB,CAAA;AAEzD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAmKrE,CAAA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAEvF"}

package/dist/action/builtin-actions.js

@@ -0,0 +1,200 @@
+import { SPARQ_ICON_ADD, SPARQ_ICON_BACK, SPARQ_ICON_CHECK, SPARQ_ICON_CLOSE, SPARQ_ICON_COPY, SPARQ_ICON_DELETE, SPARQ_ICON_DOWNLOAD, SPARQ_ICON_EDIT, SPARQ_ICON_MORE, SPARQ_ICON_PRINT, SPARQ_ICON_REFRESH, SPARQ_ICON_RESET, SPARQ_ICON_RESTORE, SPARQ_ICON_SAVE, SPARQ_ICON_SEARCH, SPARQ_ICON_UPLOAD, SPARQ_ICON_VIEW, } from '../icon-keys';
+export const BUILTIN_ACTION_CREATE = 'create';
+export const BUILTIN_ACTION_ATTACH = 'attach';
+export const BUILTIN_ACTION_CREATE_CHILD = 'create_child';
+export const BUILTIN_ACTION_UPDATE = 'update';
+export const BUILTIN_ACTION_VIEW = 'view';
+export const BUILTIN_ACTION_DELETE = 'delete';
+export const BUILTIN_ACTION_DETACH = 'detach';
+export const BUILTIN_ACTION_RELOAD = 'reload';
+export const BUILTIN_ACTION_IMPORT = 'import';
+export const BUILTIN_ACTION_EXPORT = 'export';
+export const BUILTIN_ACTION_DUPLICATE = 'duplicate';
+export const BUILTIN_ACTION_PRINT = 'print';
+export const BUILTIN_ACTION_RECYCLE_BIN = 'recycle_bin';
+export const BUILTIN_ACTION_RETURN_LIST = 'return_list';
+export const BUILTIN_ACTION_RESTORE = 'restore';
+export const BUILTIN_ACTION_PURGE = 'purge';
+export const BUILTIN_ACTION_MORE = 'more';
+export const BUILTIN_ACTION_SAVE_DRAFT = 'save_draft';
+export const BUILTIN_ACTION_SUBMIT = 'submit';
+export const BUILTIN_ACTION_RESET = 'reset';
+export const BUILTIN_ACTION_CANCEL = 'cancel';
+export const BUILTIN_ACTION_SEARCH_SUBMIT = 'search.submit';
+export const BUILTIN_ACTION_SEARCH_RESET = 'search.reset';
+/**
+ * 内置动作默认定义。
+ *
+ * 这里只描述动作的基础语义，不执行动作。真正执行由后续 ActionRuntime 负责。
+ */
+export const builtinActionDefinitions = {
+    [BUILTIN_ACTION_CREATE]: {
+        title: '新增',
+        icon: SPARQ_ICON_ADD,
+        type: 'primary',
+        kind: 'builtin',
+        scope: 'collection',
+    },
+    [BUILTIN_ACTION_ATTACH]: {
+        title: '选择已有',
+        icon: SPARQ_ICON_ADD,
+        type: 'primary',
+        kind: 'builtin',
+        scope: 'collection',
+    },
+    [BUILTIN_ACTION_CREATE_CHILD]: {
+        title: '添加下级',
+        icon: SPARQ_ICON_ADD,
+        kind: 'builtin',
+        scope: 'record',
+    },
+    [BUILTIN_ACTION_UPDATE]: {
+        title: '编辑',
+        icon: SPARQ_ICON_EDIT,
+        type: 'primary',
+        kind: 'builtin',
+        scope: 'record',
+    },
+    [BUILTIN_ACTION_VIEW]: {
+        title: '查看',
+        icon: SPARQ_ICON_VIEW,
+        kind: 'builtin',
+        scope: 'record',
+    },
+    [BUILTIN_ACTION_DELETE]: {
+        title: '删除',
+        icon: SPARQ_ICON_DELETE,
+        type: 'danger',
+        kind: 'builtin',
+        scope: 'record',
+        confirm: {
+            title: '确认删除？',
+            content: '删除后数据将无法恢复，请确认是否继续。',
+        },
+    },
+    [BUILTIN_ACTION_DETACH]: {
+        title: '解除关联',
+        icon: SPARQ_ICON_DELETE,
+        type: 'danger',
+        kind: 'builtin',
+        scope: 'record',
+        confirm: {
+            title: '确认解除关联？',
+            content: '解除后资源仍会保留，但不再属于当前记录。',
+        },
+    },
+    [BUILTIN_ACTION_RELOAD]: {
+        title: '刷新',
+        icon: SPARQ_ICON_REFRESH,
+        kind: 'builtin',
+        scope: 'collection',
+    },
+    [BUILTIN_ACTION_IMPORT]: {
+        title: '导入',
+        icon: SPARQ_ICON_UPLOAD,
+        kind: 'builtin',
+        scope: 'collection',
+    },
+    [BUILTIN_ACTION_EXPORT]: {
+        title: '导出',
+        icon: SPARQ_ICON_DOWNLOAD,
+        kind: 'builtin',
+        scope: 'collection',
+    },
+    [BUILTIN_ACTION_DUPLICATE]: {
+        title: '复制',
+        icon: SPARQ_ICON_COPY,
+        kind: 'builtin',
+        scope: 'record',
+    },
+    [BUILTIN_ACTION_PRINT]: {
+        title: '打印',
+        icon: SPARQ_ICON_PRINT,
+        kind: 'builtin',
+        scope: 'record',
+    },
+    [BUILTIN_ACTION_RECYCLE_BIN]: {
+        title: '回收站',
+        icon: SPARQ_ICON_DELETE,
+        kind: 'builtin',
+        scope: 'collection',
+    },
+    [BUILTIN_ACTION_RETURN_LIST]: {
+        title: '返回列表',
+        icon: SPARQ_ICON_BACK,
+        kind: 'builtin',
+        scope: 'collection',
+    },
+    [BUILTIN_ACTION_RESTORE]: {
+        title: '恢复',
+        icon: SPARQ_ICON_RESTORE,
+        kind: 'builtin',
+        scope: 'record',
+    },
+    [BUILTIN_ACTION_PURGE]: {
+        title: '彻底删除',
+        icon: SPARQ_ICON_DELETE,
+        type: 'danger',
+        kind: 'builtin',
+        scope: 'record',
+        confirm: {
+            title: '确认彻底删除？',
+            content: '彻底删除后数据将无法恢复，请确认是否继续。',
+        },
+    },
+    [BUILTIN_ACTION_MORE]: {
+        title: '更多',
+        icon: SPARQ_ICON_MORE,
+        kind: 'builtin',
+        type: 'dropdown',
+        scope: 'record',
+    },
+    [BUILTIN_ACTION_SAVE_DRAFT]: {
+        title: '保存草稿',
+        icon: SPARQ_ICON_SAVE,
+        kind: 'builtin',
+        scope: 'form',
+        props: {
+            validate: false,
+        },
+    },
+    [BUILTIN_ACTION_SUBMIT]: {
+        title: '提交',
+        icon: SPARQ_ICON_CHECK,
+        type: 'primary',
+        kind: 'builtin',
+        scope: 'form',
+    },
+    [BUILTIN_ACTION_RESET]: {
+        title: '重置',
+        icon: SPARQ_ICON_RESET,
+        kind: 'builtin',
+        scope: 'form',
+    },
+    [BUILTIN_ACTION_CANCEL]: {
+        title: '取消',
+        icon: SPARQ_ICON_CLOSE,
+        kind: 'builtin',
+        scope: 'self',
+    },
+    [BUILTIN_ACTION_SEARCH_SUBMIT]: {
+        title: '查询',
+        icon: SPARQ_ICON_SEARCH,
+        type: 'primary',
+        kind: 'builtin',
+        scope: 'form',
+    },
+    [BUILTIN_ACTION_SEARCH_RESET]: {
+        title: '重置',
+        icon: SPARQ_ICON_RESET,
+        kind: 'builtin',
+        scope: 'form',
+    },
+};
+/**
+ * 获取内置动作定义。
+ */
+export function getBuiltinActionDefinition(action) {
+    return builtinActionDefinitions[action];
+}
+//# sourceMappingURL=builtin-actions.js.map

package/dist/action/builtin-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-actions.js","sourceRoot":"","sources":["../../src/action/builtin-actions.ts"],"names":[],"mappings":"AACA,OAAO,EACH,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAClB,MAAM,cAAc,CAAA;AAErB,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,2BAA2B,GAAG,cAAc,CAAA;AACzD,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AACzC,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAA;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAA;AACvD,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAA;AACvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,SAAS,CAAA;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AACzC,MAAM,CAAC,MAAM,yBAAyB,GAAG,YAAY,CAAA;AACrD,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAC3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,QAAQ,CAAA;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,eAAe,CAAA;AAC3D,MAAM,CAAC,MAAM,2BAA2B,GAAG,cAAc,CAAA;AAEzD;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACtE,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,YAAY;KACtB;IACD,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,YAAY;KACtB;IACD,CAAC,2BAA2B,CAAC,EAAE;QAC3B,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ;KAClB;IACD,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ;KAClB;IACD,CAAC,mBAAmB,CAAC,EAAE;QACnB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ;KAClB;IACD,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE;YACL,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,qBAAqB;SACjC;KACJ;IACD,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE;YACL,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,sBAAsB;SAClC;KACJ;IACD,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,YAAY;KACtB;IACD,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,YAAY;KACtB;IACD,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,YAAY;KACtB;IACD,CAAC,wBAAwB,CAAC,EAAE;QACxB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ;KAClB;IACD,CAAC,oBAAoB,CAAC,EAAE;QACpB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ;KAClB;IACD,CAAC,0BAA0B,CAAC,EAAE;QAC1B,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,YAAY;KACtB;IACD,CAAC,0BAA0B,CAAC,EAAE;QAC1B,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,YAAY;KACtB;IACD,CAAC,sBAAsB,CAAC,EAAE;QACtB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ;KAClB;IACD,CAAC,oBAAoB,CAAC,EAAE;QACpB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE;YACL,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,uBAAuB;SACnC;KACJ;IACD,CAAC,mBAAmB,CAAC,EAAE;QACnB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,QAAQ;KAClB;IACD,CAAC,yBAAyB,CAAC,EAAE;QACzB,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;QACb,KAAK,EAAE;YACH,QAAQ,EAAE,KAAK;SAClB;KACJ;IACD,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;KAChB;IACD,CAAC,oBAAoB,CAAC,EAAE;QACpB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;KAChB;IACD,CAAC,qBAAqB,CAAC,EAAE;QACrB,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;KAChB;IACD,CAAC,4BAA4B,CAAC,EAAE;QAC5B,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;KAChB;IACD,CAAC,2BAA2B,CAAC,EAAE;QAC3B,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,MAAM;KAChB;CACJ,CAAA;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACrD,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAA;AAC3C,CAAC"}

package/dist/action/index.d.ts

@@ -0,0 +1,6 @@
+export * from './action-runtime';
+export * from './builtin-actions';
+export * from './merge-action';
+export * from './resolve-action';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/action/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/action/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA"}

package/dist/action/index.js

@@ -0,0 +1,6 @@
+export * from './action-runtime';
+export * from './builtin-actions';
+export * from './merge-action';
+export * from './resolve-action';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/action/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/action/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA"}

package/dist/action/merge-action.d.ts

@@ -0,0 +1,9 @@
+import type { ActionDefinition, ActionRef, ActionScope } from '@sparqjs/schema-protocol';
+import type { ResolvedAction } from './types';
+/**
+ * 合并动作引用、顶层动作定义和内置动作默认值。
+ *
+ * 优先级：ActionRef > schema.actions[action] > location default scope > builtin defaults。
+ */
+export declare function mergeAction(ref: ActionRef, definition: ActionDefinition | undefined, builtin: ActionDefinition | undefined, defaultScope?: ActionScope): ResolvedAction;
+//# sourceMappingURL=merge-action.d.ts.map

package/dist/action/merge-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-action.d.ts","sourceRoot":"","sources":["../../src/action/merge-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C;;;;GAIG;AACH,wBAAgB,WAAW,CACvB,GAAG,EAAE,SAAS,EACd,UAAU,EAAE,gBAAgB,GAAG,SAAS,EACxC,OAAO,EAAE,gBAAgB,GAAG,SAAS,EACrC,YAAY,CAAC,EAAE,WAAW,GAC3B,cAAc,CA0BhB"}

package/dist/action/merge-action.js

@@ -0,0 +1,51 @@
+/**
+ * 合并动作引用、顶层动作定义和内置动作默认值。
+ *
+ * 优先级：ActionRef > schema.actions[action] > location default scope > builtin defaults。
+ */
+export function mergeAction(ref, definition, builtin, defaultScope) {
+    return {
+        action: ref.action,
+        title: ref.title ?? definition?.title ?? builtin?.title,
+        kind: definition?.kind ?? builtin?.kind ?? 'custom',
+        scope: ref.scope ?? definition?.scope ?? defaultScope ?? builtin?.scope ?? 'self',
+        handler: definition?.handler ?? builtin?.handler,
+        icon: ref.icon ?? definition?.icon ?? builtin?.icon,
+        type: ref.type ?? definition?.type ?? builtin?.type,
+        component: ref.component,
+        props: {
+            ...(builtin?.props ?? {}),
+            ...(definition?.props ?? {}),
+            ...(ref.props ?? {}),
+        },
+        presentation: refPresentation(ref, definition, builtin),
+        confirm: ref.confirm ?? definition?.confirm ?? builtin?.confirm,
+        show_when: ref.show_when ?? definition?.show_when,
+        disabled_when: ref.disabled_when ?? definition?.disabled_when,
+        afterSuccess: ref.afterSuccess ?? definition?.afterSuccess ?? builtin?.afterSuccess,
+        afterError: ref.afterError ?? definition?.afterError ?? builtin?.afterError,
+        source: {
+            builtin: Boolean(builtin),
+            custom: Boolean(definition),
+        },
+    };
+}
+/**
+ * 合并动作展示配置。
+ *
+ * ActionRef 当前没有 presentation 字段，因此第一阶段只在 definition 和 builtin 之间合并。
+ */
+function refPresentation(_ref, definition, builtin) {
+    if (!builtin?.presentation && !definition?.presentation) {
+        return undefined;
+    }
+    return {
+        ...(builtin?.presentation ?? {}),
+        ...(definition?.presentation ?? {}),
+        props: {
+            ...(builtin?.presentation?.props ?? {}),
+            ...(definition?.presentation?.props ?? {}),
+        },
+    };
+}
+//# sourceMappingURL=merge-action.js.map

package/dist/action/merge-action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-action.js","sourceRoot":"","sources":["../../src/action/merge-action.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACvB,GAAc,EACd,UAAwC,EACxC,OAAqC,EACrC,YAA0B;IAE1B,OAAO;QACH,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,UAAU,EAAE,KAAK,IAAI,OAAO,EAAE,KAAK;QACvD,IAAI,EAAE,UAAU,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,IAAI,QAAQ;QACnD,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,UAAU,EAAE,KAAK,IAAI,YAAY,IAAI,OAAO,EAAE,KAAK,IAAI,MAAM;QACjF,OAAO,EAAE,UAAU,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO;QAChD,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,UAAU,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI;QACnD,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,UAAU,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI;QACnD,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,KAAK,EAAE;YACH,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;YACzB,GAAG,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,CAAC;YAC5B,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;SACvB;QACD,YAAY,EAAE,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,CAAC;QACvD,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,UAAU,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO;QAC/D,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,UAAU,EAAE,SAAS;QACjD,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,UAAU,EAAE,aAAa;QAC7D,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,UAAU,EAAE,YAAY,IAAI,OAAO,EAAE,YAAY;QACnF,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,UAAU,EAAE,UAAU,IAAI,OAAO,EAAE,UAAU;QAC3E,MAAM,EAAE;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;YACzB,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC;SAC9B;KACJ,CAAA;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CACpB,IAAe,EACf,UAAwC,EACxC,OAAqC;IAErC,IAAI,CAAC,OAAO,EAAE,YAAY,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC;QACtD,OAAO,SAAS,CAAA;IACpB,CAAC;IAED,OAAO;QACH,GAAG,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,CAAC;QAChC,GAAG,CAAC,UAAU,EAAE,YAAY,IAAI,EAAE,CAAC;QACnC,KAAK,EAAE;YACH,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC;YACvC,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC;SAC7C;KACJ,CAAA;AACL,CAAC"}

package/dist/action/resolve-action.d.ts

@@ -0,0 +1,14 @@
+import type { ResolveActionInput, ResolveActionsInput, ResolvedActionResult, ResolvedActionsResult } from './types';
+/**
+ * 解析单个动作。
+ *
+ * 该函数只负责合并配置和产生诊断，不执行动作。
+ */
+export declare function resolveAction(input: ResolveActionInput): ResolvedActionResult;
+/**
+ * 批量解析动作。
+ *
+ * dropdown 子动作会递归解析，并继承父动作的默认 scope。
+ */
+export declare function resolveActions(input: ResolveActionsInput): ResolvedActionsResult;
+//# sourceMappingURL=resolve-action.d.ts.map

package/dist/action/resolve-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-action.d.ts","sourceRoot":"","sources":["../../src/action/resolve-action.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACR,kBAAkB,EAClB,mBAAmB,EAEnB,oBAAoB,EACpB,qBAAqB,EACxB,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,oBAAoB,CAQ7E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,qBAAqB,CAYhF"}