@pactor-app/runtime 1.56.0 → 1.58.0

package/dist/index.cjs

@@ -28,7 +28,9 @@ __export(index_exports, {
   I18nContextProvider: () => I18nContextProvider,
   LocalizationProtocolError: () => LocalizationProtocolError,
   PageRuntimeError: () => PageRuntimeError,
+  PageRuntimeVersionError: () => PageRuntimeVersionError,
   PageRuntimeView: () => PageRuntimeView,
+  RUNTIME_VERSION: () => RUNTIME_VERSION,
   StateStore: () => StateStore,
   UnsupportedComponent: () => UnsupportedComponent,
   buildScope: () => buildScope,
@@ -1898,6 +1900,15 @@ function isEmbeddedDslNode(value) {
 // src/page/page-runtime.tsx
 var import_core6 = require("@pactor-app/core");
 var import_schema2 = require("@pactor-app/schema");
+var import_semver = require("semver");
+
+// package.json
+var version = "1.58.0";
+
+// src/version.ts
+var RUNTIME_VERSION = version;
+
+// src/page/page-runtime.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var PageRuntimeError = class extends Error {
   constructor(errors) {
@@ -1908,7 +1919,38 @@ var PageRuntimeError = class extends Error {
     this.errors = errors;
   }
 };
+var PageRuntimeVersionError = class extends PageRuntimeError {
+  constructor(requirement, runtimeVersion, message) {
+    super([{ path: "/requires/runtime", keyword: "version", message }]);
+    this.name = "PageRuntimeVersionError";
+    this.requirement = requirement;
+    this.runtimeVersion = runtimeVersion;
+  }
+};
+function assertRuntimeVersion(pageDsl) {
+  const requirement = pageDsl?.requires?.runtime;
+  if (typeof requirement !== "string") {
+    return;
+  }
+  const pageId = pageDsl?.page?.id;
+  const label = pageId === void 0 ? "\u9875\u9762" : `\u9875\u9762\uFF08${pageId}\uFF09`;
+  if ((0, import_semver.validRange)(requirement) === null) {
+    throw new PageRuntimeVersionError(
+      requirement,
+      RUNTIME_VERSION,
+      `${label}\u7684 requires.runtime \u4E0D\u662F\u5408\u6CD5\u7684\u7248\u672C\u8303\u56F4\uFF1A"${requirement}"`
+    );
+  }
+  if (!(0, import_semver.satisfies)(RUNTIME_VERSION, requirement)) {
+    throw new PageRuntimeVersionError(
+      requirement,
+      RUNTIME_VERSION,
+      `${label}\u8981\u6C42 Runtime ${requirement}\uFF0C\u5F53\u524D Runtime \u7248\u672C\u4E3A ${RUNTIME_VERSION}`
+    );
+  }
+}
 function createPageRuntime(pageDsl, options = {}) {
+  assertRuntimeVersion(pageDsl);
   const validation = (0, import_schema2.validatePageDsl)(pageDsl);
   if (!validation.valid) {
     throw new PageRuntimeError(validation.errors);
@@ -2064,7 +2106,9 @@ function renderRootItems(items, context, engine, children) {
   I18nContextProvider,
   LocalizationProtocolError,
   PageRuntimeError,
+  PageRuntimeVersionError,
   PageRuntimeView,
+  RUNTIME_VERSION,
   StateStore,
   UnsupportedComponent,
   buildScope,

package/dist/index.d.cts

@@ -522,6 +522,17 @@ declare class PageRuntimeError extends Error {
     readonly errors: DslValidationError[];
     constructor(errors: DslValidationError[]);
 }
+/**
+ * Runtime 版本不满足 Page DSL `requires.runtime` 声明的错误。
+ * 继承 `PageRuntimeError`，宿主现有的「DSL 校验失败」处理可直接复用。
+ */
+declare class PageRuntimeVersionError extends PageRuntimeError {
+    /** 页面声明的版本范围（requires.runtime） */
+    readonly requirement: string;
+    /** 当前 Runtime 版本 */
+    readonly runtimeVersion: string;
+    constructor(requirement: string, runtimeVersion: string, message: string);
+}
 /**
  * PageRuntime（设计文档第 20、89 节，决策 D6）：
  * PageDsl → 校验 → RuntimeContext → 初始化 state / dataSources（autoLoad）
@@ -571,4 +582,10 @@ declare function PageRuntimeView({ runtime, children, }: {
     children?: ReactNode;
 }): ReactNode;
 
-export { type ActionContext, ActionEngine, type ActionHandler, type ActionRegistry, type ActionResult, type CapabilityRegistry, type ComponentEntry, type ComponentRegistry, type CreateRuntimeContextOptions, type DataSourceStatus, DataStore, type DataStoreDeps, DslRenderer, type DslRendererProps, DslSourceBoundary, type DslSourceBoundaryProps, DslSourceResolver, type DslSourceResolverDeps, type FormHandle, type FormRegistry, type HttpAdapter, type HttpRequestConfig, I18nContextProvider, type LocalScope, type LocalizationMode, LocalizationProtocolError, type PageRuntime, PageRuntimeError, PageRuntimeView, type PermissionAdapter, type RendererContextValue, type ResolveDeepOptions, type RouteContext, type RouterAdapter, type RuntimeContext, type ScopedComponentEntry, type ServiceHandler, type ServiceRegistry, StateStore, UnsupportedComponent, buildScope, createDefaultPermissionAdapter, createDefaultRouterAdapter, createFetchHttpAdapter, createPageRuntime, createRuntimeContext, dslSourceKey, registerBuiltinActions, resolveDeep, useDataSource, useI18n, useRenderer, useRuntimeState };
+/**
+ * 当前 Runtime 版本（构建时从 package.json 注入）。
+ * 用于 Page DSL `requires.runtime` 的版本兼容性校验。
+ */
+declare const RUNTIME_VERSION: string;
+
+export { type ActionContext, ActionEngine, type ActionHandler, type ActionRegistry, type ActionResult, type CapabilityRegistry, type ComponentEntry, type ComponentRegistry, type CreateRuntimeContextOptions, type DataSourceStatus, DataStore, type DataStoreDeps, DslRenderer, type DslRendererProps, DslSourceBoundary, type DslSourceBoundaryProps, DslSourceResolver, type DslSourceResolverDeps, type FormHandle, type FormRegistry, type HttpAdapter, type HttpRequestConfig, I18nContextProvider, type LocalScope, type LocalizationMode, LocalizationProtocolError, type PageRuntime, PageRuntimeError, PageRuntimeVersionError, PageRuntimeView, type PermissionAdapter, RUNTIME_VERSION, type RendererContextValue, type ResolveDeepOptions, type RouteContext, type RouterAdapter, type RuntimeContext, type ScopedComponentEntry, type ServiceHandler, type ServiceRegistry, StateStore, UnsupportedComponent, buildScope, createDefaultPermissionAdapter, createDefaultRouterAdapter, createFetchHttpAdapter, createPageRuntime, createRuntimeContext, dslSourceKey, registerBuiltinActions, resolveDeep, useDataSource, useI18n, useRenderer, useRuntimeState };

package/dist/index.d.ts

@@ -522,6 +522,17 @@ declare class PageRuntimeError extends Error {
     readonly errors: DslValidationError[];
     constructor(errors: DslValidationError[]);
 }
+/**
+ * Runtime 版本不满足 Page DSL `requires.runtime` 声明的错误。
+ * 继承 `PageRuntimeError`，宿主现有的「DSL 校验失败」处理可直接复用。
+ */
+declare class PageRuntimeVersionError extends PageRuntimeError {
+    /** 页面声明的版本范围（requires.runtime） */
+    readonly requirement: string;
+    /** 当前 Runtime 版本 */
+    readonly runtimeVersion: string;
+    constructor(requirement: string, runtimeVersion: string, message: string);
+}
 /**
  * PageRuntime（设计文档第 20、89 节，决策 D6）：
  * PageDsl → 校验 → RuntimeContext → 初始化 state / dataSources（autoLoad）
@@ -571,4 +582,10 @@ declare function PageRuntimeView({ runtime, children, }: {
     children?: ReactNode;
 }): ReactNode;
 
-export { type ActionContext, ActionEngine, type ActionHandler, type ActionRegistry, type ActionResult, type CapabilityRegistry, type ComponentEntry, type ComponentRegistry, type CreateRuntimeContextOptions, type DataSourceStatus, DataStore, type DataStoreDeps, DslRenderer, type DslRendererProps, DslSourceBoundary, type DslSourceBoundaryProps, DslSourceResolver, type DslSourceResolverDeps, type FormHandle, type FormRegistry, type HttpAdapter, type HttpRequestConfig, I18nContextProvider, type LocalScope, type LocalizationMode, LocalizationProtocolError, type PageRuntime, PageRuntimeError, PageRuntimeView, type PermissionAdapter, type RendererContextValue, type ResolveDeepOptions, type RouteContext, type RouterAdapter, type RuntimeContext, type ScopedComponentEntry, type ServiceHandler, type ServiceRegistry, StateStore, UnsupportedComponent, buildScope, createDefaultPermissionAdapter, createDefaultRouterAdapter, createFetchHttpAdapter, createPageRuntime, createRuntimeContext, dslSourceKey, registerBuiltinActions, resolveDeep, useDataSource, useI18n, useRenderer, useRuntimeState };
+/**
+ * 当前 Runtime 版本（构建时从 package.json 注入）。
+ * 用于 Page DSL `requires.runtime` 的版本兼容性校验。
+ */
+declare const RUNTIME_VERSION: string;
+
+export { type ActionContext, ActionEngine, type ActionHandler, type ActionRegistry, type ActionResult, type CapabilityRegistry, type ComponentEntry, type ComponentRegistry, type CreateRuntimeContextOptions, type DataSourceStatus, DataStore, type DataStoreDeps, DslRenderer, type DslRendererProps, DslSourceBoundary, type DslSourceBoundaryProps, DslSourceResolver, type DslSourceResolverDeps, type FormHandle, type FormRegistry, type HttpAdapter, type HttpRequestConfig, I18nContextProvider, type LocalScope, type LocalizationMode, LocalizationProtocolError, type PageRuntime, PageRuntimeError, PageRuntimeVersionError, PageRuntimeView, type PermissionAdapter, RUNTIME_VERSION, type RendererContextValue, type ResolveDeepOptions, type RouteContext, type RouterAdapter, type RuntimeContext, type ScopedComponentEntry, type ServiceHandler, type ServiceRegistry, StateStore, UnsupportedComponent, buildScope, createDefaultPermissionAdapter, createDefaultRouterAdapter, createFetchHttpAdapter, createPageRuntime, createRuntimeContext, dslSourceKey, registerBuiltinActions, resolveDeep, useDataSource, useI18n, useRenderer, useRuntimeState };

package/dist/index.js

@@ -1871,6 +1871,15 @@ import {
   validateDslNodes as validateDslNodes2,
   validatePageDsl
 } from "@pactor-app/schema";
+import { satisfies, validRange } from "semver";
+
+// package.json
+var version = "1.58.0";
+
+// src/version.ts
+var RUNTIME_VERSION = version;
+
+// src/page/page-runtime.tsx
 import { Fragment as Fragment2, jsx as jsx3 } from "react/jsx-runtime";
 var PageRuntimeError = class extends Error {
   constructor(errors) {
@@ -1881,7 +1890,38 @@ var PageRuntimeError = class extends Error {
     this.errors = errors;
   }
 };
+var PageRuntimeVersionError = class extends PageRuntimeError {
+  constructor(requirement, runtimeVersion, message) {
+    super([{ path: "/requires/runtime", keyword: "version", message }]);
+    this.name = "PageRuntimeVersionError";
+    this.requirement = requirement;
+    this.runtimeVersion = runtimeVersion;
+  }
+};
+function assertRuntimeVersion(pageDsl) {
+  const requirement = pageDsl?.requires?.runtime;
+  if (typeof requirement !== "string") {
+    return;
+  }
+  const pageId = pageDsl?.page?.id;
+  const label = pageId === void 0 ? "\u9875\u9762" : `\u9875\u9762\uFF08${pageId}\uFF09`;
+  if (validRange(requirement) === null) {
+    throw new PageRuntimeVersionError(
+      requirement,
+      RUNTIME_VERSION,
+      `${label}\u7684 requires.runtime \u4E0D\u662F\u5408\u6CD5\u7684\u7248\u672C\u8303\u56F4\uFF1A"${requirement}"`
+    );
+  }
+  if (!satisfies(RUNTIME_VERSION, requirement)) {
+    throw new PageRuntimeVersionError(
+      requirement,
+      RUNTIME_VERSION,
+      `${label}\u8981\u6C42 Runtime ${requirement}\uFF0C\u5F53\u524D Runtime \u7248\u672C\u4E3A ${RUNTIME_VERSION}`
+    );
+  }
+}
 function createPageRuntime(pageDsl, options = {}) {
+  assertRuntimeVersion(pageDsl);
   const validation = validatePageDsl(pageDsl);
   if (!validation.valid) {
     throw new PageRuntimeError(validation.errors);
@@ -2036,7 +2076,9 @@ export {
   I18nContextProvider,
   LocalizationProtocolError,
   PageRuntimeError,
+  PageRuntimeVersionError,
   PageRuntimeView,
+  RUNTIME_VERSION,
   StateStore,
   UnsupportedComponent,
   buildScope,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pactor-app/runtime",
-  "version": "1.56.0",
+  "version": "1.58.0",
   "description": "Pactor runtime: RuntimeContext, StateStore, DataSource runtime, action engine, React renderer and page runtime",
   "keywords": [
     "pactor",
@@ -45,9 +45,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@pactor-app/expression": "1.56.0",
-    "@pactor-app/core": "1.56.0",
-    "@pactor-app/schema": "1.56.0"
+    "semver": "^7.8.5",
+    "@pactor-app/core": "1.58.0",
+    "@pactor-app/expression": "1.58.0",
+    "@pactor-app/schema": "1.58.0"
   },
   "peerDependencies": {
     "react": ">=18"
@@ -57,6 +58,7 @@
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
+    "@types/semver": "^7.8.0",
     "jsdom": "^30.0.1",
     "react": "^19.2.8",
     "react-dom": "^19.2.8"