@sparqjs/schema-core 0.1.0

package/dist/render/resolve-render-view.js

@@ -0,0 +1,93 @@
+import { createDiagnostic } from '../diagnostics';
+const DEFAULT_RENDER_MODE = 'page';
+const DEFAULT_VIEW_NAME = 'default';
+export function resolveRenderView(input) {
+    const mode = input.mode ?? DEFAULT_RENDER_MODE;
+    const viewName = input.view ?? DEFAULT_VIEW_NAME;
+    const view = getRuntimeViewByMode(input.viewModel, mode, viewName);
+    if (view) {
+        return {
+            mode,
+            viewName,
+            view,
+            autoLoadTable: shouldAutoLoadTable(mode, view),
+            tableReloadViewName: resolveTableReloadViewName(mode, viewName, view),
+            tableReloadMode: resolveTableReloadMode(mode, view),
+            tableReloadTree: resolveTableReloadTree(mode, view),
+            diagnostics: [],
+            fatal: false,
+        };
+    }
+    return {
+        mode,
+        viewName,
+        autoLoadTable: false,
+        diagnostics: [
+            createDiagnostic('error', {
+                code: 'VIEW_NOT_FOUND',
+                message: `View "${viewName}" was not found for mode "${mode}".`,
+                path: `schema.views.${getViewGroupName(mode)}.${viewName}`,
+                hint: `Define views.${getViewGroupName(mode)}.${viewName}, or change SparqView mode/view.`,
+                fatal: true,
+            }),
+        ],
+        fatal: true,
+    };
+}
+function getRuntimeViewByMode(viewModel, mode, viewName) {
+    switch (mode) {
+        case 'page':
+            return viewModel.pages.get(viewName);
+        case 'form':
+            return viewModel.forms.get(viewName);
+        case 'table':
+            return viewModel.tables.get(viewName);
+        case 'search':
+            return viewModel.searches.get(viewName);
+        case 'detail':
+            return viewModel.details.get(viewName);
+    }
+}
+function shouldAutoLoadTable(mode, view) {
+    if (mode === 'table') {
+        return true;
+    }
+    return mode === 'page' && 'table' in view && view.table !== undefined;
+}
+function resolveTableReloadViewName(mode, viewName, view) {
+    if (mode === 'page' && 'tableName' in view) {
+        return view.tableName ?? 'default';
+    }
+    if (mode === 'table') {
+        return viewName;
+    }
+    return undefined;
+}
+function resolveTableReloadMode(mode, view) {
+    if (mode === 'page' && 'table' in view) {
+        return view.table?.mode;
+    }
+    if (mode === 'table' && 'mode' in view) {
+        return view.mode;
+    }
+    return undefined;
+}
+function resolveTableReloadTree(mode, view) {
+    if (mode === 'page' && 'table' in view) {
+        return view.table?.tree;
+    }
+    if (mode === 'table' && 'tree' in view) {
+        return view.tree;
+    }
+    return undefined;
+}
+function getViewGroupName(mode) {
+    if (mode === 'page') {
+        return 'pages';
+    }
+    if (mode === 'search') {
+        return 'searches';
+    }
+    return `${mode}s`;
+}
+//# sourceMappingURL=resolve-render-view.js.map

package/dist/render/resolve-render-view.js.map

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

package/dist/render/types.d.ts

@@ -0,0 +1,21 @@
+import type { RenderMode } from '@sparqjs/schema-protocol';
+import type { Diagnostic } from '../diagnostics';
+import type { ResourceViewModel, RuntimeDetailView, RuntimeFormView, RuntimePageView, RuntimeSearchView, RuntimeTableView } from '../view-model';
+export type RuntimeRenderableView = RuntimePageView | RuntimeFormView | RuntimeTableView | RuntimeSearchView | RuntimeDetailView;
+export interface ResolveRenderViewInput {
+    viewModel: ResourceViewModel;
+    mode?: RenderMode;
+    view?: string;
+}
+export interface ResolveRenderViewResult {
+    mode: RenderMode;
+    viewName: string;
+    view?: RuntimeRenderableView;
+    autoLoadTable: boolean;
+    tableReloadViewName?: string;
+    tableReloadMode?: string;
+    tableReloadTree?: RuntimeTableView['tree'];
+    diagnostics: Diagnostic[];
+    fatal: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/render/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/render/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EACR,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EACnB,MAAM,eAAe,CAAA;AAEtB,MAAM,MAAM,qBAAqB,GAC3B,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,CAAA;AAEvB,MAAM,WAAW,sBAAsB;IACnC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,qBAAqB,CAAA;IAC5B,aAAa,EAAE,OAAO,CAAA;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC1C,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,KAAK,EAAE,OAAO,CAAA;CACjB"}

package/dist/render/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/render/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/render/types.ts"],"names":[],"mappings":""}

package/dist/runtime.d.ts

@@ -0,0 +1,34 @@
+import type { SchemaResource } from '@sparqjs/schema-protocol';
+import type { DataAdapter, LoadSchemaContext } from './data';
+import type { SchemaRuntimeHooks } from './hooks';
+import type { ActionConfirmResolver } from './action';
+import { type NormalizedResource } from './normalizer';
+import { type RuntimeRegistries } from './registry';
+import { type ResolveRenderViewInput, type ResolveRenderViewResult } from './render';
+import { type SessionPreset } from './session';
+import { type ResourceViewModel } from './view-model';
+export interface CreateSchemaRuntimeOptions {
+    dataAdapter?: DataAdapter;
+    sessionPreset?: SessionPreset;
+    registries?: RuntimeRegistries;
+    hooks?: SchemaRuntimeHooks;
+    confirmAction?: ActionConfirmResolver;
+    notify?: SchemaRuntimeNotifier;
+}
+export interface SchemaRuntime {
+    options: CreateSchemaRuntimeOptions;
+    normalize(resource: SchemaResource): NormalizedResource;
+    buildViewModel(resource: SchemaResource): ResourceViewModel;
+    resolveView(input: ResolveRenderViewInput): ResolveRenderViewResult;
+    loadSchema(context: LoadSchemaContext): Promise<SchemaResource>;
+}
+export interface SchemaRuntimeNotice {
+    type: 'error' | 'success' | 'warning' | 'info';
+    message: string;
+    title?: string;
+    error?: unknown;
+    payload?: unknown;
+}
+export type SchemaRuntimeNotifier = (notice: SchemaRuntimeNotice) => void | Promise<void>;
+export declare function createSchemaRuntime(options?: CreateSchemaRuntimeOptions): SchemaRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAA2B,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC/E,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAqB,KAAK,sBAAsB,EAAE,KAAK,uBAAuB,EAAE,MAAM,UAAU,CAAA;AACvG,OAAO,EAAwD,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AACpG,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAE7E,MAAM,WAAW,0BAA0B;IACvC,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,UAAU,CAAC,EAAE,iBAAiB,CAAA;IAC9B,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,aAAa,CAAC,EAAE,qBAAqB,CAAA;IACrC,MAAM,CAAC,EAAE,qBAAqB,CAAA;CACjC;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,0BAA0B,CAAA;IACnC,SAAS,CAAC,QAAQ,EAAE,cAAc,GAAG,kBAAkB,CAAA;IACvD,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,iBAAiB,CAAA;IAC3D,WAAW,CAAC,KAAK,EAAE,sBAAsB,GAAG,uBAAuB,CAAA;IACnE,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,CAAA;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B,GAAG,aAAa,CA6B3F"}

package/dist/runtime.js

@@ -0,0 +1,31 @@
+import { normalizeResourceSchema } from './normalizer';
+import { mergeRuntimeRegistries } from './registry';
+import { resolveRenderView } from './render';
+import { createDefaultRuntimeRegistries, installSessionPreset } from './session';
+import { buildResourceViewModel } from './view-model';
+export function createSchemaRuntime(options = {}) {
+    const registries = mergeRuntimeRegistries(createDefaultRuntimeRegistries(), options.sessionPreset ? installSessionPreset({}, options.sessionPreset) : undefined, options.registries);
+    const runtimeOptions = {
+        ...options,
+        registries,
+    };
+    return {
+        options: runtimeOptions,
+        normalize(resource) {
+            return normalizeResourceSchema(resource);
+        },
+        buildViewModel(resource) {
+            return buildResourceViewModel(resource);
+        },
+        resolveView(input) {
+            return resolveRenderView(input);
+        },
+        async loadSchema(context) {
+            if (!runtimeOptions.dataAdapter?.loadSchema) {
+                throw new Error('No dataAdapter.loadSchema configured.');
+            }
+            return runtimeOptions.dataAdapter.loadSchema(context);
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,uBAAuB,EAA2B,MAAM,cAAc,CAAA;AAC/E,OAAO,EAAE,sBAAsB,EAA0B,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,iBAAiB,EAA6D,MAAM,UAAU,CAAA;AACvG,OAAO,EAAE,8BAA8B,EAAE,oBAAoB,EAAsB,MAAM,WAAW,CAAA;AACpG,OAAO,EAAE,sBAAsB,EAA0B,MAAM,cAAc,CAAA;AA6B7E,MAAM,UAAU,mBAAmB,CAAC,UAAsC,EAAE;IACxE,MAAM,UAAU,GAAG,sBAAsB,CACrC,8BAA8B,EAAE,EAChC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC,EAAE,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,EACnF,OAAO,CAAC,UAAU,CACrB,CAAA;IACD,MAAM,cAAc,GAA+B;QAC/C,GAAG,OAAO;QACV,UAAU;KACb,CAAA;IAED,OAAO;QACH,OAAO,EAAE,cAAc;QACvB,SAAS,CAAC,QAAQ;YACd,OAAO,uBAAuB,CAAC,QAAQ,CAAC,CAAA;QAC5C,CAAC;QACD,cAAc,CAAC,QAAQ;YACnB,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAA;QAC3C,CAAC;QACD,WAAW,CAAC,KAAK;YACb,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAA;QACnC,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,OAAO;YACpB,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;YAC5D,CAAC;YACD,OAAO,cAAc,CAAC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QACzD,CAAC;KACJ,CAAA;AACL,CAAC"}

package/dist/scope/index.d.ts

@@ -0,0 +1,4 @@
+export * from './resolve-target';
+export * from './scope-tree';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/scope/index.js

@@ -0,0 +1,4 @@
+export * from './resolve-target';
+export * from './scope-tree';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/dist/scope/index.js.map

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

package/dist/scope/resolve-target.d.ts

@@ -0,0 +1,9 @@
+import type { ScopeTree } from './scope-tree';
+import type { ResolveScopeTargetContext, RuntimeScope, ScopeTarget } from './types';
+/**
+ * 解析 scope target。
+ *
+ * 支持 self、source、parent、root、table:default、root.table:default、scope:custom_id。
+ */
+export declare function resolveScopeTarget(tree: ScopeTree, target: ScopeTarget, context: ResolveScopeTargetContext): RuntimeScope | undefined;
+//# sourceMappingURL=resolve-target.d.ts.map

package/dist/scope/resolve-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-target.d.ts","sourceRoot":"","sources":["../../src/scope/resolve-target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEnF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,yBAAyB,GACnC,YAAY,GAAG,SAAS,CA2B1B"}

package/dist/scope/resolve-target.js

@@ -0,0 +1,40 @@
+/**
+ * 解析 scope target。
+ *
+ * 支持 self、source、parent、root、table:default、root.table:default、scope:custom_id。
+ */
+export function resolveScopeTarget(tree, target, context) {
+    if (target === 'self') {
+        return tree.getScope(context.currentScopeId);
+    }
+    if (target === 'source') {
+        return tree.getScope(context.sourceScopeId ?? context.currentScopeId);
+    }
+    if (target === 'parent') {
+        return tree.getParent(context.currentScopeId);
+    }
+    if (target === 'root') {
+        return tree.getRoot(context.currentScopeId);
+    }
+    if (target.startsWith('scope:')) {
+        return tree.getScope(target.slice('scope:'.length));
+    }
+    if (target.startsWith('root.')) {
+        const root = tree.getRoot(context.currentScopeId);
+        return root ? resolveTypedViewTarget(tree, root.id, target.slice('root.'.length)) : undefined;
+    }
+    return resolveTypedViewTarget(tree, context.currentScopeId, target);
+}
+/**
+ * 解析带类型和 view 名称的 target。
+ *
+ * 例如 table:default 表示当前 scope 下 viewName=default 的 table scope。
+ */
+function resolveTypedViewTarget(tree, parentScopeId, target) {
+    const [type, viewName] = target.split(':');
+    if (!type || !viewName) {
+        return undefined;
+    }
+    return tree.findChild(parentScopeId, (scope) => scope.type === type && scope.viewName === viewName);
+}
+//# sourceMappingURL=resolve-target.js.map

package/dist/scope/resolve-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-target.js","sourceRoot":"","sources":["../../src/scope/resolve-target.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAC9B,IAAe,EACf,MAAmB,EACnB,OAAkC;IAElC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IAChD,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC,CAAA;IACzE,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;IACvD,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QACjD,OAAO,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;IACjG,CAAC;IAED,OAAO,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;AACvE,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB,CAAC,IAAe,EAAE,aAAqB,EAAE,MAAc;IAClF,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,SAAS,CAAA;IACpB,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAA;AACvG,CAAC"}

package/dist/scope/scope-tree.d.ts

@@ -0,0 +1,27 @@
+import type { CreateRuntimeScopeInput, RuntimeScope } from './types';
+/**
+ * ScopeTree 管理嵌套 view 的 scope 树。
+ */
+export interface ScopeTree {
+    /** 创建并加入 scope。 */
+    addScope(input: CreateRuntimeScopeInput): RuntimeScope;
+    /** 按 id 获取 scope。 */
+    getScope(id: string): RuntimeScope | undefined;
+    /** 获取父 scope。 */
+    getParent(id: string): RuntimeScope | undefined;
+    /** 获取根 scope。 */
+    getRoot(id?: string): RuntimeScope | undefined;
+    /** 获取直接子 scope。 */
+    getChildren(id: string): RuntimeScope[];
+    /** 查找指定父级下的第一个匹配 scope。 */
+    findChild(id: string, predicate: (scope: RuntimeScope) => boolean): RuntimeScope | undefined;
+    /** 返回所有 scope。 */
+    toArray(): RuntimeScope[];
+}
+/**
+ * 创建 scope tree。
+ *
+ * id 缺失时使用递增 id。renderer 可以传入更稳定的 id，方便 Stage 和 Designer 定位。
+ */
+export declare function createScopeTree(seed?: RuntimeScope[]): ScopeTree;
+//# sourceMappingURL=scope-tree.d.ts.map

package/dist/scope/scope-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-tree.d.ts","sourceRoot":"","sources":["../../src/scope/scope-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,GAAG,YAAY,CAAA;IACtD,qBAAqB;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;IAC9C,iBAAiB;IACjB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;IAC/C,iBAAiB;IACjB,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;IAC9C,mBAAmB;IACnB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,EAAE,CAAA;IACvC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,GAAG,YAAY,GAAG,SAAS,CAAA;IAC5F,kBAAkB;IAClB,OAAO,IAAI,YAAY,EAAE,CAAA;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,YAAY,EAAO,GAAG,SAAS,CAmDpE"}

package/dist/scope/scope-tree.js

@@ -0,0 +1,55 @@
+/**
+ * 创建 scope tree。
+ *
+ * id 缺失时使用递增 id。renderer 可以传入更稳定的 id，方便 Stage 和 Designer 定位。
+ */
+export function createScopeTree(seed = []) {
+    const scopes = new Map();
+    let nextId = 1;
+    for (const scope of seed) {
+        scopes.set(scope.id, scope);
+    }
+    return {
+        addScope(input) {
+            const id = input.id ?? `scope_${nextId++}`;
+            const scope = {
+                id,
+                type: input.type,
+                resource: input.resource,
+                viewName: input.viewName,
+                parentId: input.parentId,
+                sourceNodeId: input.sourceNodeId,
+                meta: input.meta,
+            };
+            scopes.set(id, scope);
+            return scope;
+        },
+        getScope(id) {
+            return scopes.get(id);
+        },
+        getParent(id) {
+            const scope = scopes.get(id);
+            return scope?.parentId ? scopes.get(scope.parentId) : undefined;
+        },
+        getRoot(id) {
+            if (!id) {
+                return [...scopes.values()].find((scope) => !scope.parentId);
+            }
+            let current = scopes.get(id);
+            while (current?.parentId) {
+                current = scopes.get(current.parentId);
+            }
+            return current;
+        },
+        getChildren(id) {
+            return [...scopes.values()].filter((scope) => scope.parentId === id);
+        },
+        findChild(id, predicate) {
+            return [...scopes.values()].find((scope) => scope.parentId === id && predicate(scope));
+        },
+        toArray() {
+            return [...scopes.values()];
+        },
+    };
+}
+//# sourceMappingURL=scope-tree.js.map

package/dist/scope/scope-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-tree.js","sourceRoot":"","sources":["../../src/scope/scope-tree.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAuB,EAAE;IACrD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAA;IAC9C,IAAI,MAAM,GAAG,CAAC,CAAA;IAEd,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO;QACH,QAAQ,CAAC,KAAK;YACV,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,SAAS,MAAM,EAAE,EAAE,CAAA;YAC1C,MAAM,KAAK,GAAiB;gBACxB,EAAE;gBACF,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,IAAI,EAAE,KAAK,CAAC,IAAI;aACnB,CAAA;YACD,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;YACrB,OAAO,KAAK,CAAA;QAChB,CAAC;QACD,QAAQ,CAAC,EAAE;YACP,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACzB,CAAC;QACD,SAAS,CAAC,EAAE;YACR,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC5B,OAAO,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACnE,CAAC;QACD,OAAO,CAAC,EAAE;YACN,IAAI,CAAC,EAAE,EAAE,CAAC;gBACN,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YAChE,CAAC;YAED,IAAI,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC5B,OAAO,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACvB,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;YAC1C,CAAC;YACD,OAAO,OAAO,CAAA;QAClB,CAAC;QACD,WAAW,CAAC,EAAE;YACV,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAA;QACxE,CAAC;QACD,SAAS,CAAC,EAAE,EAAE,SAAS;YACnB,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,EAAE,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QAC1F,CAAC;QACD,OAAO;YACH,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAC/B,CAAC;KACJ,CAAA;AACL,CAAC"}

package/dist/scope/types.d.ts

@@ -0,0 +1,63 @@
+import type { RenderMode } from '@sparqjs/schema-protocol';
+/**
+ * Runtime scope 类型。
+ *
+ * 每个被渲染出来的 view 实例都应有一个 scope。
+ */
+export type RuntimeScopeType = RenderMode | 'custom';
+/**
+ * Runtime scope。
+ *
+ * Scope 用于描述嵌套 view 的运行边界，action 的 close/refresh 默认只影响来源 scope。
+ */
+export interface RuntimeScope {
+    /** scope 唯一标识。 */
+    id: string;
+    /** scope 类型。 */
+    type: RuntimeScopeType;
+    /** 当前资源编码。 */
+    resource?: string;
+    /** 当前 view 名称。 */
+    viewName?: string;
+    /** 父 scope id。 */
+    parentId?: string;
+    /** 创建该 scope 的 schema 节点 id。 */
+    sourceNodeId?: string;
+    /** 附加信息。 */
+    meta?: Record<string, unknown>;
+}
+/**
+ * 创建 scope 的输入。
+ */
+export interface CreateRuntimeScopeInput {
+    /** scope id。缺失时由 ScopeTree 生成。 */
+    id?: string;
+    /** scope 类型。 */
+    type: RuntimeScopeType;
+    /** 当前资源编码。 */
+    resource?: string;
+    /** 当前 view 名称。 */
+    viewName?: string;
+    /** 父 scope id。 */
+    parentId?: string;
+    /** 创建该 scope 的 schema 节点 id。 */
+    sourceNodeId?: string;
+    /** 附加信息。 */
+    meta?: Record<string, unknown>;
+}
+/**
+ * scope target 字符串。
+ *
+ * 常见值包括 self、source、parent、root、table:default、root.table:default、scope:custom_id。
+ */
+export type ScopeTarget = string;
+/**
+ * scope target 解析上下文。
+ */
+export interface ResolveScopeTargetContext {
+    /** 当前 scope id。 */
+    currentScopeId: string;
+    /** action 来源 scope id。缺失时按 currentScopeId 处理。 */
+    sourceScopeId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scope/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scope/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEpD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,gBAAgB;IAChB,IAAI,EAAE,gBAAgB,CAAA;IACtB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,kCAAkC;IAClC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,gBAAgB;IAChB,IAAI,EAAE,gBAAgB,CAAA;IACtB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAEhC;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACtC,mBAAmB;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB"}

package/dist/scope/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scope/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scope/types.ts"],"names":[],"mappings":""}

package/dist/session/action-execution.d.ts

@@ -0,0 +1,16 @@
+import type { DispatchSchemaActionInput, SessionActionDispatchInput, SessionController, SessionFormState } from './types';
+/**
+ * 转发 controller 内部动作执行。
+ *
+ * controller 持有 action 状态和已注册的 session registry。
+ * defaultForm 作为缺省 form 上下文，供 page/table 动作复用。
+ */
+export declare function dispatchControllerAction(controller: SessionController, defaultForm: SessionFormState, input: SessionActionDispatchInput): Promise<unknown>;
+/**
+ * 执行 schema action。
+ *
+ * input.controller 存在时走 session controller 链路。
+ * 没有 controller 时只保留 action runtime 和 onAction 执行能力。
+ */
+export declare function dispatchSchemaAction(input: DispatchSchemaActionInput): Promise<unknown>;
+//# sourceMappingURL=action-execution.d.ts.map

package/dist/session/action-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-execution.d.ts","sourceRoot":"","sources":["../../src/session/action-execution.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACR,yBAAyB,EAEzB,0BAA0B,EAI1B,iBAAiB,EACjB,gBAAgB,EACnB,MAAM,SAAS,CAAA;AAEhB;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC1C,UAAU,EAAE,iBAAiB,EAC7B,WAAW,EAAE,gBAAgB,EAC7B,KAAK,EAAE,0BAA0B,GAClC,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoC7F"}