@svadmin/surface 0.11.8 → 0.13.0

package/README.md

@@ -13,7 +13,7 @@ the `minimum-supported` strict install and consumer checks in `pack:check` to
 pass against registry artifacts; workspace tarballs do not replace that check.
 
 ```bash
-bun add @svadmin/surface @svadmin/core @svadmin/ui @tanstack/svelte-query svelte @sinclair/typebox
+bun add @svadmin/surface @svadmin/core @svadmin/ui @tanstack/svelte-query svelte typebox
 ```
 
 Import protocol types and validation from the DOM-free root entry. Import rendering code from the Svelte subpath. Hosts do not need CSS compiler plugins to consume the package's static component styles.
@@ -157,8 +157,8 @@ Preview controls use local finite class helpers and maintained static CSS. `@sva
 The catalog version is `svadmin/v1`. `catalogVersion` must match exactly. Custom registrations use strict TypeBox props schemas and trusted Svelte components. Item widgets reading record fields must expose them through `getReferencedFields` so runtime validation checks `SurfacePolicy.readFields`.
 
 ```ts
-import { Type } from '@sinclair/typebox';
-import { Value } from '@sinclair/typebox/value';
+import { Type } from 'typebox';
+import { Value } from 'typebox/value';
 
 const statusProps = Type.Object({ statusField: Type.String() }, { additionalProperties: false });
 const catalog = defineSurfaceCatalog({
@@ -189,3 +189,18 @@ Limits are eight data sources, 24 widgets, 100 rows per page, eight filters, thr
 Actual OpenUI Lang parsing, nested interactive forms, registered business actions, server persistence, SSR/Lite rendering, arbitrary URLs, client aggregation, Canvas and iframe execution are not implemented. Aggregated metrics should come from a policy-authorized backend summary resource and bind through `resource-one`. The current UI contract remains read-only even though its definition can be edited.
 
 See `docs/architecture/openui-surface-phase2.md` for the original feature scope and `docs/architecture/surface-integration-provenance.md` for historical integration evidence. 中文指南见文档站的“声明式 Surface”。
+
+## json-render 适配
+
+Surface 可以接收 Vercel `json-render` 使用的标准扁平 `Spec`（`root` + `elements`），同时继续由 Surface 的 TypeBox Schema、组件目录和资源策略负责最终校验。协议入口提供 `jsonRenderSpecToSurfaceSpec` 和 `surfaceSpecToJsonRenderSpec`：前者只接受以 `surface` 为根、一级业务组件为子节点的受控子集，后者用于把已校验的 SurfaceSpec 输出为标准扁平 Spec。
+
+适配层不执行 json-render 的任意 action、脚本、URL 或嵌套组件树；业务数据查询仍经过 Surface DataProvider 和既有授权流程。项目业务契约继续使用 TypeBox，未引入 Zod 运行时依赖。本入口只提供格式互操作，不包含官方 json-render Catalog、流式编译器或渲染器集成。`binding` 和 `placement` 是适配器保留属性；导出包含这些业务属性的组件时会抛错，避免静默覆盖。
+
+```ts
+import { jsonRenderSpecToSurfaceSpec } from '@svadmin/surface';
+
+const result = jsonRenderSpecToSurfaceSpec(jsonRenderSpec, catalog, policy);
+if (result.ok) {
+  // 交给现有 SurfaceRenderer；此处仍是候选页面，不代表业务动作授权。
+}
+```

package/compatibility.json

@@ -1,5 +1,5 @@
 {
-  "surface": "0.11.x",
+  "surface": "0.13.x",
   "minimumSupported": {
     "@svadmin/core": "0.53.0",
     "@svadmin/ui": "0.73.0",

package/dist/agent-contract.d.ts

@@ -1,4 +1,4 @@
-import { type TSchema } from '@sinclair/typebox';
+import { Type, type TSchema } from 'typebox';
 import { type JsonObject, type SurfaceCatalog, type SurfacePolicy } from './types.js';
 export declare const SURFACE_CATALOG_SCHEMA_VERSION: "surface-catalog/v1";
 export declare const SURFACE_AGENT_SCHEMA_VERSION: "surface-agent/v1";
@@ -29,9 +29,9 @@ export declare function createSurfaceCatalogManifest(catalog: SurfaceCatalog): S
 /** 生成约束缩小候选空间，不能代替绑定/字段关联校验，更不能代替后端授权。 */
 export declare function createSurfaceGenerationSpecSchema(catalog: SurfaceCatalog, policy: SurfacePolicy): TSchema;
 export declare function createSurfaceAgentResponseSchema(catalog: SurfaceCatalog, policy: SurfacePolicy): JsonObject;
-export declare const surfaceCannotFulfillSchema: import("@sinclair/typebox").TObject<{
-    schemaVersion: import("@sinclair/typebox").TLiteral<"surface-agent/v2">;
-    action: import("@sinclair/typebox").TLiteral<"cannot-fulfill">;
-    reason: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"unsupported_request">, import("@sinclair/typebox").TLiteral<"insufficient_permissions">, import("@sinclair/typebox").TLiteral<"insufficient_context">]>;
-    message: import("@sinclair/typebox").TString;
+export declare const surfaceCannotFulfillSchema: Type.TObject<{
+    schemaVersion: Type.TLiteral<"surface-agent/v2">;
+    action: Type.TLiteral<"cannot-fulfill">;
+    reason: Type.TUnion<[Type.TLiteral<"unsupported_request">, Type.TLiteral<"insufficient_permissions">, Type.TLiteral<"insufficient_context">]>;
+    message: Type.TString;
 }>;

package/dist/agent-contract.js

@@ -1,5 +1,5 @@
-import { Kind, OptionalKind, ReadonlyKind, Type } from '@sinclair/typebox';
-import { Value } from '@sinclair/typebox/value';
+import { Type } from 'typebox';
+import { Value } from 'typebox/value';
 import { escapedJsonPointerToken, jsonValueIssue } from './json.js';
 import { surfaceFilterSchema, surfaceIdSchema, surfaceListSourceSchema, surfaceOneSourceSchema, surfaceSpecSchema, surfaceWidgetSchema, } from './schema.js';
 import { SURFACE_LIMITS, SURFACE_SCHEMA_VERSION, } from './types.js';
@@ -11,6 +11,8 @@ export const SURFACE_AGENT_LIMITS = {
     maxRequestCharacters: 16_384,
     maxContractCharacters: 131_072,
 };
+/** Scalar TypeBox 1.x markers that are dropped when serializing a schema to JSON. */
+const SURFACE_MARKERS = new Set(['~kind', '~optional', '~readonly', '~immutable']);
 /** 不把 Transform、函数或引用 schema 静默降级为宽松的 JSON schema。 */
 export function surfaceSchemaToJson(schema) {
     const ancestors = new Set();
@@ -37,10 +39,14 @@ export function surfaceSchemaToJson(schema) {
             if (Array.isArray(value) && key === 'length')
                 continue;
             if (typeof key === 'symbol') {
-                if (key === Kind || key === OptionalKind || key === ReadonlyKind)
-                    continue;
                 throw new Error('Surface schema contains unsupported symbol metadata or a transform');
             }
+            if (key.startsWith('~')) {
+                if (!SURFACE_MARKERS.has(key)) {
+                    throw new Error('Surface schema contains unsupported transform or metadata');
+                }
+                continue;
+            }
             if (['__proto__', 'constructor', 'prototype', '$ref', '$dynamicRef', '$recursiveRef'].includes(key)) {
                 throw new Error(`Surface schema key "${key}" is not supported; use an inline schema`);
             }

package/dist/agent.d.ts

@@ -1,4 +1,4 @@
-import { type Static } from '@sinclair/typebox';
+import { type Static } from 'typebox';
 import { SURFACE_AGENT_RESPONSE_SCHEMA_VERSION, SURFACE_AGENT_SCHEMA_VERSION, surfaceCannotFulfillSchema } from './agent-contract.js';
 import type { SurfaceCatalog, SurfacePolicy, SurfaceSpec, SurfaceValidationIssue } from './types.js';
 export { SURFACE_AGENT_SCHEMA_VERSION } from './agent-contract.js';

package/dist/agent.js

@@ -1,7 +1,7 @@
-import { Type } from '@sinclair/typebox';
-import { TypeCompiler } from '@sinclair/typebox/compiler';
+import { Type } from 'typebox';
+import { Compile } from 'typebox/compile';
 import { SURFACE_AGENT_LIMITS, SURFACE_AGENT_RESPONSE_SCHEMA_VERSION, SURFACE_AGENT_SCHEMA_VERSION, createSurfaceAgentResponseSchema, createSurfaceCatalogManifest, createSurfaceGenerationSpecSchema, surfaceCannotFulfillSchema, surfaceSchemaToJson, } from './agent-contract.js';
-import { validateSurfaceSpec } from './validation.js';
+import { validateSurfaceSpec, surfaceSchemaIssues } from './validation.js';
 import { parseSurfaceJson, surfaceWireError } from './wire.js';
 export { SURFACE_AGENT_SCHEMA_VERSION } from './agent-contract.js';
 const proposalFields = {
@@ -15,12 +15,12 @@ const responseProposalSchema = Type.Object({
     ...proposalFields,
     schemaVersion: Type.Literal(SURFACE_AGENT_RESPONSE_SCHEMA_VERSION),
 }, { additionalProperties: false });
-const compiledProposalSchema = TypeCompiler.Compile(proposalSchema);
-const compiledResponseSchema = TypeCompiler.Compile(Type.Union([
+const compiledProposalSchema = Compile(proposalSchema);
+const compiledResponseSchema = Compile(Type.Union([
     proposalSchema, responseProposalSchema, surfaceCannotFulfillSchema,
 ]));
 function schemaIssues(errors) {
-    return [...errors].map((issue) => ({ code: 'invalid_json', path: issue.path || '', message: issue.message }));
+    return surfaceSchemaIssues(errors).map((issue) => ({ code: 'invalid_json', path: issue.path || '', message: issue.message }));
 }
 /** 保留 v1 的函数签名、返回类型以及带说明文字的 fenced JSON 兼容行为。 */
 export function parseSurfaceAgentProposal(input, catalog, policy) {

package/dist/builtin-definitions.js

@@ -1,4 +1,4 @@
-import { Value } from '@sinclair/typebox/value';
+import { Value } from 'typebox/value';
 import { styledMetricPropsSchema, styledResourceTablePropsSchema, barChartPropsSchema, lineChartPropsSchema, metricPropsSchema, resourceTablePropsSchema, } from './builtin-schemas.js';
 export const DEFAULT_SURFACE_CATALOG_VERSION = 'svadmin/v1';
 export const STYLED_SURFACE_CATALOG_VERSION = 'svadmin/styled-v1';

package/dist/builtin-schemas.d.ts

@@ -1,63 +1,63 @@
-import { type Static } from "@sinclair/typebox";
-export declare const metricPropsSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
-    label: import("@sinclair/typebox").TString;
-    format: import("@sinclair/typebox").TLiteral<"currency">;
-    currency: import("@sinclair/typebox").TString;
-    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-}>, import("@sinclair/typebox").TObject<{
-    label: import("@sinclair/typebox").TString;
-    format: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"number">, import("@sinclair/typebox").TLiteral<"percent">]>;
-    currency: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNever>;
-    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+import { Type, type Static } from "typebox";
+export declare const metricPropsSchema: Type.TUnion<[Type.TObject<{
+    label: Type.TString;
+    format: Type.TLiteral<"currency">;
+    currency: Type.TString;
+    description: Type.TOptional<Type.TString>;
+}>, Type.TObject<{
+    label: Type.TString;
+    format: Type.TUnion<[Type.TLiteral<"number">, Type.TLiteral<"percent">]>;
+    currency: Type.TOptional<Type.TNever>;
+    description: Type.TOptional<Type.TString>;
 }>]>;
-export declare const resourceTablePropsSchema: import("@sinclair/typebox").TObject<{
-    title: import("@sinclair/typebox").TString;
-    emptyLabel: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    columns: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        field: import("@sinclair/typebox").TString;
-        label: import("@sinclair/typebox").TString;
-        format: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"text">, import("@sinclair/typebox").TLiteral<"number">, import("@sinclair/typebox").TLiteral<"date">, import("@sinclair/typebox").TLiteral<"boolean">]>>;
+export declare const resourceTablePropsSchema: Type.TObject<{
+    title: Type.TString;
+    emptyLabel: Type.TOptional<Type.TString>;
+    columns: Type.TArray<Type.TObject<{
+        field: Type.TString;
+        label: Type.TString;
+        format: Type.TOptional<Type.TUnion<[Type.TLiteral<"text">, Type.TLiteral<"number">, Type.TLiteral<"date">, Type.TLiteral<"boolean">]>>;
     }>>;
 }>;
-export declare const barChartPropsSchema: import("@sinclair/typebox").TObject<{
-    title: import("@sinclair/typebox").TString;
-    labelField: import("@sinclair/typebox").TString;
-    valueField: import("@sinclair/typebox").TString;
-    showValues: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+export declare const barChartPropsSchema: Type.TObject<{
+    title: Type.TString;
+    labelField: Type.TString;
+    valueField: Type.TString;
+    showValues: Type.TOptional<Type.TBoolean>;
 }>;
-export declare const lineChartPropsSchema: import("@sinclair/typebox").TObject<{
-    title: import("@sinclair/typebox").TString;
-    labelField: import("@sinclair/typebox").TString;
-    valueField: import("@sinclair/typebox").TString;
-    showDots: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-    fill: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
+export declare const lineChartPropsSchema: Type.TObject<{
+    title: Type.TString;
+    labelField: Type.TString;
+    valueField: Type.TString;
+    showDots: Type.TOptional<Type.TBoolean>;
+    fill: Type.TOptional<Type.TBoolean>;
 }>;
 export type MetricProps = Static<typeof metricPropsSchema>;
 export type ResourceTableProps = Static<typeof resourceTablePropsSchema>;
 export type BarChartProps = Static<typeof barChartPropsSchema>;
 export type LineChartProps = Static<typeof lineChartPropsSchema>;
-export declare const styledMetricPropsSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
-    tone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
-    density: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"compact" | "comfortable">[]>>;
-    label: import("@sinclair/typebox").TString;
-    format: import("@sinclair/typebox").TLiteral<"currency">;
-    currency: import("@sinclair/typebox").TString;
-    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-}>, import("@sinclair/typebox").TObject<{
-    tone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
-    density: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"compact" | "comfortable">[]>>;
-    label: import("@sinclair/typebox").TString;
-    format: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"number">, import("@sinclair/typebox").TLiteral<"percent">]>;
-    currency: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNever>;
-    description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+export declare const styledMetricPropsSchema: Type.TUnion<[Type.TObject<{
+    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
+    density: Type.TOptional<Type.TUnion<Type.TLiteral<"compact" | "comfortable">[]>>;
+    label: Type.TString;
+    format: Type.TLiteral<"currency">;
+    currency: Type.TString;
+    description: Type.TOptional<Type.TString>;
+}>, Type.TObject<{
+    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
+    density: Type.TOptional<Type.TUnion<Type.TLiteral<"compact" | "comfortable">[]>>;
+    label: Type.TString;
+    format: Type.TUnion<[Type.TLiteral<"number">, Type.TLiteral<"percent">]>;
+    currency: Type.TOptional<Type.TNever>;
+    description: Type.TOptional<Type.TString>;
 }>]>;
-export declare const styledResourceTablePropsSchema: import("@sinclair/typebox").TObject<{
-    density: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"compact" | "comfortable">[]>>;
-    title: import("@sinclair/typebox").TString;
-    emptyLabel: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    columns: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        field: import("@sinclair/typebox").TString;
-        label: import("@sinclair/typebox").TString;
-        format: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"text">, import("@sinclair/typebox").TLiteral<"number">, import("@sinclair/typebox").TLiteral<"date">, import("@sinclair/typebox").TLiteral<"boolean">]>>;
+export declare const styledResourceTablePropsSchema: Type.TObject<{
+    density: Type.TOptional<Type.TUnion<Type.TLiteral<"compact" | "comfortable">[]>>;
+    title: Type.TString;
+    emptyLabel: Type.TOptional<Type.TString>;
+    columns: Type.TArray<Type.TObject<{
+        field: Type.TString;
+        label: Type.TString;
+        format: Type.TOptional<Type.TUnion<[Type.TLiteral<"text">, Type.TLiteral<"number">, Type.TLiteral<"date">, Type.TLiteral<"boolean">]>>;
     }>>;
 }>;

package/dist/builtin-schemas.js

@@ -1,5 +1,5 @@
 import { surfaceDesignContract } from './design-contract.js';
-import { Type } from "@sinclair/typebox";
+import { Type } from "typebox";
 const catalogFieldSchema = Type.String({
     minLength: 1,
     maxLength: 64,

package/dist/business-definitions.d.ts

@@ -1,26 +1,26 @@
-import { type Static } from '@sinclair/typebox';
+import { Type, type Static } from 'typebox';
 import type { SurfaceCatalog } from './types.js';
-export declare const resourceDetailPropsSchema: import("@sinclair/typebox").TObject<{
-    fields: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        field: import("@sinclair/typebox").TString;
-        label: import("@sinclair/typebox").TString;
-        format: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<string>[]>>;
+export declare const resourceDetailPropsSchema: Type.TObject<{
+    fields: Type.TArray<Type.TObject<{
+        field: Type.TString;
+        label: Type.TString;
+        format: Type.TOptional<Type.TUnion<Type.TLiteral<string>[]>>;
     }>>;
-    title: import("@sinclair/typebox").TString;
-    tone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
-    density: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"compact" | "comfortable">[]>>;
+    title: Type.TString;
+    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
+    density: Type.TOptional<Type.TUnion<Type.TLiteral<"compact" | "comfortable">[]>>;
 }>;
-export declare const activityFeedPropsSchema: import("@sinclair/typebox").TObject<{
-    idField: import("@sinclair/typebox").TString;
-    actionField: import("@sinclair/typebox").TString;
-    timestampField: import("@sinclair/typebox").TString;
-    actorField: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    targetField: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    commentField: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    statusField: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    title: import("@sinclair/typebox").TString;
-    tone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
-    density: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"compact" | "comfortable">[]>>;
+export declare const activityFeedPropsSchema: Type.TObject<{
+    idField: Type.TString;
+    actionField: Type.TString;
+    timestampField: Type.TString;
+    actorField: Type.TOptional<Type.TString>;
+    targetField: Type.TOptional<Type.TString>;
+    commentField: Type.TOptional<Type.TString>;
+    statusField: Type.TOptional<Type.TString>;
+    title: Type.TString;
+    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
+    density: Type.TOptional<Type.TUnion<Type.TLiteral<"compact" | "comfortable">[]>>;
 }>;
 export type ResourceDetailProps = Static<typeof resourceDetailPropsSchema>;
 export type ActivityFeedProps = Static<typeof activityFeedPropsSchema>;

package/dist/business-definitions.js

@@ -1,5 +1,5 @@
-import { Type } from '@sinclair/typebox';
-import { Value } from '@sinclair/typebox/value';
+import { Type } from 'typebox';
+import { Value } from 'typebox/value';
 import { styledSurfaceDefinitions } from './builtin-definitions.js';
 import { surfaceDesignContract } from './design-contract.js';
 const field = Type.String({ minLength: 1, maxLength: 64, pattern: '^[A-Za-z][A-Za-z0-9_-]*$' });

package/dist/catalog.js

@@ -1,4 +1,4 @@
-import { Value } from '@sinclair/typebox/value';
+import { Value } from 'typebox/value';
 import BarChartWidget from './components/BarChartWidget.svelte';
 import LineChartWidget from './components/LineChartWidget.svelte';
 import MetricWidget from './components/MetricWidget.svelte';

package/dist/components/ActivityFeedWidget.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { Value } from '@sinclair/typebox/value';
+  import { Value } from 'typebox/value';
   import ActivityFeed from '@svadmin/ui/components/ActivityFeed.svelte';
   import { activityFeedPropsSchema } from '../business-definitions.js';
   import { asSurfaceActivities } from '../business-data.js';

package/dist/components/BarChartWidget.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { Value } from '@sinclair/typebox/value';
+  import { Value } from 'typebox/value';
   import BarChart from '@svadmin/ui/components/charts/BarChart.svelte';
   import CardContent from '@svadmin/ui/components/ui/card/card-content.svelte';
   import CardHeader from '@svadmin/ui/components/ui/card/card-header.svelte';

package/dist/components/LineChartWidget.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { Value } from '@sinclair/typebox/value';
+  import { Value } from 'typebox/value';
   import LineChart from '@svadmin/ui/components/charts/LineChart.svelte';
   import CardContent from '@svadmin/ui/components/ui/card/card-content.svelte';
   import CardHeader from '@svadmin/ui/components/ui/card/card-header.svelte';

package/dist/components/MetricWidget.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { Value } from '@sinclair/typebox/value';
+  import { Value } from 'typebox/value';
   import { surfaceMetric } from '../recipes.js';
   import '../styles.css';
   import StatsCard from '@svadmin/ui/components/StatsCard.svelte';

package/dist/components/ResourceDetailWidget.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { Value } from '@sinclair/typebox/value';
+  import { Value } from 'typebox/value';
   import Card from '@svadmin/ui/components/ui/card/card.svelte';
   import CardHeader from '@svadmin/ui/components/ui/card/card-header.svelte';
   import CardTitle from '@svadmin/ui/components/ui/card/card-title.svelte';

package/dist/components/ResourceFormBody.svelte

@@ -1,6 +1,6 @@
 <script lang="ts">
   import { onDestroy, untrack } from 'svelte';
-  import { Value } from '@sinclair/typebox/value';
+  import { Value } from 'typebox/value';
   import JsonSchemaForm from '@svadmin/ui/components/JsonSchemaForm.svelte';
   import { createSurfaceFormController, type SurfaceWorkflowClientState } from '../workflows/client.js';
   import type { SurfaceWorkflowHost } from '../workflows/context.js';
@@ -49,7 +49,7 @@
     // wire representation. The server repeats JSON and schema validation.
     const args: unknown = JSON.parse(JSON.stringify(input));
     if (!Value.Check(action.inputSchema, args)) {
-      errors = [...Value.Errors(action.inputSchema, args)].slice(0, 12).map((error) => `${error.path}: ${error.message}`);
+      errors = Value.Errors(action.inputSchema, args).slice(0, 12).map((error) => `${error.instancePath}: ${error.message}`);
       return;
     }
     errors = [];

package/dist/components/ResourceTableWidget.svelte

@@ -1,5 +1,5 @@
 <script lang="ts">
-  import { Value } from '@sinclair/typebox/value';
+  import { Value } from 'typebox/value';
   import { surfaceTable } from '../recipes.js';
   import '../styles.css';
   import CardContent from '@svadmin/ui/components/ui/card/card-content.svelte';

package/dist/edits.js

@@ -1,5 +1,5 @@
-import { Type } from '@sinclair/typebox';
-import { TypeCompiler } from '@sinclair/typebox/compiler';
+import { Type } from 'typebox';
+import { Compile } from 'typebox/compile';
 import { createSurfaceCatalogManifest, SURFACE_AGENT_LIMITS, surfaceSchemaToJson } from './agent-contract.js';
 import { surfaceIdSchema, surfaceLayoutSchema, surfaceListSourceSchema, surfaceOneSourceSchema, surfaceSpecSchema, surfaceWidgetSchema, } from './schema.js';
 import { SURFACE_LIMITS } from './types.js';
@@ -23,8 +23,8 @@ const editSchema = Type.Object({
         Type.Object({ op: Type.Literal('reorder-widgets'), ids: Type.Array(surfaceIdSchema, { maxItems: SURFACE_LIMITS.maxWidgets, uniqueItems: true }) }, { additionalProperties: false }),
     ]), { minItems: 1, maxItems: SURFACE_EDIT_LIMITS.maxOperations }),
 }, { additionalProperties: false });
-const compiledEdit = TypeCompiler.Compile(editSchema);
-const compiledRevision = TypeCompiler.Compile(Type.Object({ revision: revisionSchema, spec: surfaceSpecSchema }, { additionalProperties: false }));
+const compiledEdit = Compile(editSchema);
+const compiledRevision = Compile(Type.Object({ revision: revisionSchema, spec: surfaceSpecSchema }, { additionalProperties: false }));
 function editError(code, path, message) {
     return { ok: false, issues: [{ code, path, message }] };
 }

package/dist/index.d.ts

@@ -10,3 +10,5 @@ export { SURFACE_EDIT_SCHEMA_VERSION, SURFACE_EDIT_LIMITS, createSurfaceRevision
 export type { SurfaceEditOperation, SurfaceEditProposal, SurfaceEditIssue, SurfaceRevision, SurfaceRevisionResult, } from './edits.js';
 export { svarGridPropsSchema, svarGridDefinition } from './svar-schema.js';
 export type { SvarGridProps } from './svar-schema.js';
+export { jsonRenderSurfaceRootPropsSchema, jsonRenderUiElementSchema, jsonRenderSpecSchema, jsonRenderSpecToSurfaceSpec, surfaceSpecToJsonRenderSpec, } from './json-render.js';
+export type { JsonRenderSurfaceElement, JsonRenderSurfaceSpec, JsonRenderSurfaceResult, } from './json-render.js';

package/dist/index.js

@@ -5,3 +5,4 @@ export { SURFACE_AGENT_LIMITS, SURFACE_AGENT_RESPONSE_SCHEMA_VERSION, SURFACE_CA
 export { SURFACE_EDIT_SCHEMA_VERSION, SURFACE_EDIT_LIMITS, createSurfaceRevision, applySurfaceEditProposal, createSurfaceEditSchema, buildSurfaceEditMessages, } from './edits.js';
 // 只导出 JSON schema，不将可选 SVAR 渲染器加载到协议入口。
 export { svarGridPropsSchema, svarGridDefinition } from './svar-schema.js';
+export { jsonRenderSurfaceRootPropsSchema, jsonRenderUiElementSchema, jsonRenderSpecSchema, jsonRenderSpecToSurfaceSpec, surfaceSpecToJsonRenderSpec, } from './json-render.js';

package/dist/json-render.d.ts

@@ -0,0 +1,68 @@
+import { Type, type Static } from 'typebox';
+import type { SurfaceCatalog, SurfacePolicy, SurfaceSpec } from './types.js';
+/** json-render 的标准扁平 Spec 子集；业务字段仍由 Surface 的 TypeBox 契约校验。 */
+export declare const jsonRenderSurfaceRootPropsSchema: Type.TObject<{
+    layout: Type.TObject<{
+        type: Type.TLiteral<"grid">;
+        columns: Type.TLiteral<12>;
+        gap: Type.TOptional<Type.TUnion<[Type.TLiteral<"sm">, Type.TLiteral<"md">, Type.TLiteral<"lg">]>>;
+    }>;
+    title: Type.TString;
+    catalogVersion: Type.TString;
+    surfaceId: Type.TString;
+    dataSources: Type.TArray<Type.TUnion<[Type.TObject<{
+        id: Type.TString;
+        type: Type.TLiteral<"resource-list">;
+        resource: Type.TString;
+        pageSize: Type.TOptional<Type.TInteger>;
+        sorters: Type.TOptional<Type.TArray<Type.TObject<{
+            field: Type.TString;
+            order: Type.TUnion<[Type.TLiteral<"asc">, Type.TLiteral<"desc">]>;
+        }>>>;
+        filters: Type.TOptional<Type.TArray<Type.TUnion<[Type.TObject<{
+            field: Type.TString;
+            operator: Type.TUnion<[Type.TLiteral<"eq">, Type.TLiteral<"ne">, Type.TLiteral<"lt">, Type.TLiteral<"lte">, Type.TLiteral<"gt">, Type.TLiteral<"gte">, Type.TLiteral<"contains">, Type.TLiteral<"startswith">, Type.TLiteral<"endswith">]>;
+            value: Type.TUnion<[Type.TString, Type.TNumber, Type.TBoolean, Type.TNull]>;
+        }>, Type.TObject<{
+            field: Type.TString;
+            operator: Type.TUnion<[Type.TLiteral<"in">, Type.TLiteral<"nin">]>;
+            value: Type.TArray<Type.TUnion<[Type.TString, Type.TNumber, Type.TBoolean, Type.TNull]>>;
+        }>, Type.TObject<{
+            field: Type.TString;
+            operator: Type.TUnion<[Type.TLiteral<"null">, Type.TLiteral<"nnull">]>;
+        }>]>>>;
+    }>, Type.TObject<{
+        id: Type.TString;
+        type: Type.TLiteral<"resource-one">;
+        resource: Type.TString;
+        recordId: Type.TUnion<[Type.TString, Type.TNumber]>;
+    }>]>>;
+}>;
+export declare const jsonRenderUiElementSchema: Type.TObject<{
+    type: Type.TString;
+    props: Type.TRecord<"^.*$", Type.TUnknown>;
+    children: Type.TOptional<Type.TArray<Type.TString>>;
+}>;
+export declare const jsonRenderSpecSchema: Type.TObject<{
+    root: Type.TString;
+    elements: Type.TRecord<"^.*$", Type.TObject<{
+        type: Type.TString;
+        props: Type.TRecord<"^.*$", Type.TUnknown>;
+        children: Type.TOptional<Type.TArray<Type.TString>>;
+    }>>;
+}>;
+export type JsonRenderSurfaceElement = Static<typeof jsonRenderUiElementSchema>;
+export type JsonRenderSurfaceSpec = Static<typeof jsonRenderSpecSchema>;
+export type JsonRenderSurfaceResult = {
+    readonly ok: true;
+    readonly value: SurfaceSpec;
+} | {
+    readonly ok: false;
+    readonly issues: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[];
+};
+export declare function jsonRenderSpecToSurfaceSpec(input: unknown, catalog: SurfaceCatalog, policy: SurfacePolicy): JsonRenderSurfaceResult;
+/** 将已校验的 SurfaceSpec 编码为 json-render 的标准扁平 Spec。 */
+export declare function surfaceSpecToJsonRenderSpec(spec: SurfaceSpec): JsonRenderSurfaceSpec;

package/dist/json-render.js

@@ -0,0 +1,117 @@
+import { Type, ObjectOptions } from 'typebox';
+import { Value } from 'typebox/value';
+import { validateSurfaceSpec } from './validation.js';
+import { jsonPointer } from './json.js';
+import { parseSurfaceJson } from './wire.js';
+import { surfaceSpecSchema, surfaceWidgetSchema } from './schema.js';
+/** json-render 的标准扁平 Spec 子集；业务字段仍由 Surface 的 TypeBox 契约校验。 */
+export const jsonRenderSurfaceRootPropsSchema = Type.Omit(surfaceSpecSchema, ['schemaVersion', 'widgets'], ObjectOptions(surfaceSpecSchema));
+export const jsonRenderUiElementSchema = Type.Object({
+    type: Type.String({ minLength: 1 }),
+    props: Type.Record(Type.String(), Type.Unknown()),
+    children: Type.Optional(Type.Array(Type.String({ minLength: 1 }))),
+}, { additionalProperties: false });
+export const jsonRenderSpecSchema = Type.Object({
+    root: Type.String({ minLength: 1 }),
+    elements: Type.Record(Type.String({ minLength: 1 }), jsonRenderUiElementSchema),
+}, { additionalProperties: false });
+function issue(path, message) {
+    return { path, message };
+}
+/**
+ * 将 json-render Spec 转换为受 Surface 权限、目录和 TypeBox 规则保护的 SurfaceSpec。
+ * 只接受 root 类型为 surface 的子集，避免把任意 json-render 组件树当作业务页面执行。
+ */
+function readSurfaceRoot(candidate) {
+    const root = candidate.elements[candidate.root];
+    if (!root || root.type !== 'surface')
+        return { error: 'json-render root must reference a surface element' };
+    if (!Value.Check(jsonRenderSurfaceRootPropsSchema, root.props))
+        return { error: 'Invalid surface root properties' };
+    return root;
+}
+function readWidgetElement(element, id) {
+    if (element.type === 'surface')
+        return { error: 'Nested surface elements are not supported' };
+    if (element.children?.length)
+        return { error: 'Widget children are not supported' };
+    const binding = element.props['binding'];
+    const placement = element.props['placement'];
+    if (binding !== undefined && !Value.Check(surfaceWidgetSchema.properties.binding, binding))
+        return { error: 'Invalid widget binding' };
+    if (placement !== undefined && !Value.Check(surfaceWidgetSchema.properties.placement, placement))
+        return { error: 'Invalid widget placement' };
+    const props = { ...element.props };
+    delete props['binding'];
+    delete props['placement'];
+    return { id, type: element.type, props,
+        ...(binding === undefined ? {} : { binding }),
+        ...(placement === undefined ? {} : { placement }),
+    };
+}
+function parseJsonRenderSpec(input) {
+    const parsed = parseSurfaceJson(input);
+    if (!parsed.ok)
+        return { error: parsed.issues[0]?.message ?? 'Invalid JSON', path: parsed.issues[0]?.path ?? '' };
+    if (!Value.Check(jsonRenderSpecSchema, parsed.value))
+        return { error: 'Invalid json-render spec' };
+    return parsed.value;
+}
+export function jsonRenderSpecToSurfaceSpec(input, catalog, policy) {
+    const parsed = parseJsonRenderSpec(input);
+    if ('error' in parsed)
+        return { ok: false, issues: [issue(parsed.path ?? '', parsed.error)] };
+    const root = readSurfaceRoot(parsed);
+    if ('error' in root)
+        return { ok: false, issues: [issue('/root', root.error)] };
+    const children = root.children ?? [];
+    const widgets = [];
+    for (const childId of children) {
+        const element = parsed.elements[childId];
+        if (!element)
+            return { ok: false, issues: [issue(jsonPointer(['elements', childId]), 'Missing child element')] };
+        const widget = readWidgetElement(element, childId);
+        if ('error' in widget)
+            return { ok: false, issues: [issue(jsonPointer(['elements', childId]), widget.error)] };
+        widgets.push(widget);
+    }
+    if (new Set(children).size !== children.length || Object.keys(parsed.elements).length !== children.length + 1)
+        return { ok: false, issues: [issue('/elements', 'Every element must occur exactly once in the surface tree')] };
+    const surface = { schemaVersion: 'surface/v1', ...root.props, widgets };
+    const validation = validateSurfaceSpec(surface, catalog, policy);
+    return validation.ok ? validation : { ok: false, issues: validation.issues.map(({ path, message }) => ({ path, message })) };
+}
+/** 将已校验的 SurfaceSpec 编码为 json-render 的标准扁平 Spec。 */
+export function surfaceSpecToJsonRenderSpec(spec) {
+    const root = '__svadmin_surface_root';
+    if (spec.widgets.some(widget => widget.id === root)) {
+        throw new Error('Surface widget id is reserved by the json-render adapter');
+    }
+    const elements = {
+        [root]: {
+            type: 'surface',
+            props: {
+                catalogVersion: spec.catalogVersion,
+                surfaceId: spec.surfaceId,
+                title: spec.title,
+                layout: spec.layout,
+                dataSources: spec.dataSources,
+            },
+            children: spec.widgets.map(widget => widget.id),
+        },
+    };
+    for (const widget of spec.widgets) {
+        if (Object.hasOwn(widget.props, 'binding') || Object.hasOwn(widget.props, 'placement')) {
+            throw new Error('Widget props binding and placement are reserved by the json-render adapter');
+        }
+        elements[widget.id] = {
+            type: widget.type,
+            props: {
+                ...widget.props,
+                ...(widget.binding ? { binding: widget.binding } : {}),
+                ...(widget.placement ? { placement: widget.placement } : {}),
+            },
+        };
+    }
+    return { root, elements };
+}

package/dist/schema.d.ts

@@ -1,108 +1,109 @@
-export declare const surfaceIdSchema: import("@sinclair/typebox").TString;
-export declare const surfaceFilterSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
-    field: import("@sinclair/typebox").TString;
-    operator: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"eq">, import("@sinclair/typebox").TLiteral<"ne">, import("@sinclair/typebox").TLiteral<"lt">, import("@sinclair/typebox").TLiteral<"lte">, import("@sinclair/typebox").TLiteral<"gt">, import("@sinclair/typebox").TLiteral<"gte">, import("@sinclair/typebox").TLiteral<"contains">, import("@sinclair/typebox").TLiteral<"startswith">, import("@sinclair/typebox").TLiteral<"endswith">]>;
-    value: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TNull]>;
-}>, import("@sinclair/typebox").TObject<{
-    field: import("@sinclair/typebox").TString;
-    operator: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"in">, import("@sinclair/typebox").TLiteral<"nin">]>;
-    value: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TNull]>>;
-}>, import("@sinclair/typebox").TObject<{
-    field: import("@sinclair/typebox").TString;
-    operator: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"null">, import("@sinclair/typebox").TLiteral<"nnull">]>;
+import { Type } from 'typebox';
+export declare const surfaceIdSchema: Type.TString;
+export declare const surfaceFilterSchema: Type.TUnion<[Type.TObject<{
+    field: Type.TString;
+    operator: Type.TUnion<[Type.TLiteral<"eq">, Type.TLiteral<"ne">, Type.TLiteral<"lt">, Type.TLiteral<"lte">, Type.TLiteral<"gt">, Type.TLiteral<"gte">, Type.TLiteral<"contains">, Type.TLiteral<"startswith">, Type.TLiteral<"endswith">]>;
+    value: Type.TUnion<[Type.TString, Type.TNumber, Type.TBoolean, Type.TNull]>;
+}>, Type.TObject<{
+    field: Type.TString;
+    operator: Type.TUnion<[Type.TLiteral<"in">, Type.TLiteral<"nin">]>;
+    value: Type.TArray<Type.TUnion<[Type.TString, Type.TNumber, Type.TBoolean, Type.TNull]>>;
+}>, Type.TObject<{
+    field: Type.TString;
+    operator: Type.TUnion<[Type.TLiteral<"null">, Type.TLiteral<"nnull">]>;
 }>]>;
-export declare const surfaceListSourceSchema: import("@sinclair/typebox").TObject<{
-    id: import("@sinclair/typebox").TString;
-    type: import("@sinclair/typebox").TLiteral<"resource-list">;
-    resource: import("@sinclair/typebox").TString;
-    pageSize: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-    sorters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        field: import("@sinclair/typebox").TString;
-        order: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"asc">, import("@sinclair/typebox").TLiteral<"desc">]>;
+export declare const surfaceListSourceSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TLiteral<"resource-list">;
+    resource: Type.TString;
+    pageSize: Type.TOptional<Type.TInteger>;
+    sorters: Type.TOptional<Type.TArray<Type.TObject<{
+        field: Type.TString;
+        order: Type.TUnion<[Type.TLiteral<"asc">, Type.TLiteral<"desc">]>;
     }>>>;
-    filters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
-        field: import("@sinclair/typebox").TString;
-        operator: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"eq">, import("@sinclair/typebox").TLiteral<"ne">, import("@sinclair/typebox").TLiteral<"lt">, import("@sinclair/typebox").TLiteral<"lte">, import("@sinclair/typebox").TLiteral<"gt">, import("@sinclair/typebox").TLiteral<"gte">, import("@sinclair/typebox").TLiteral<"contains">, import("@sinclair/typebox").TLiteral<"startswith">, import("@sinclair/typebox").TLiteral<"endswith">]>;
-        value: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TNull]>;
-    }>, import("@sinclair/typebox").TObject<{
-        field: import("@sinclair/typebox").TString;
-        operator: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"in">, import("@sinclair/typebox").TLiteral<"nin">]>;
-        value: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TNull]>>;
-    }>, import("@sinclair/typebox").TObject<{
-        field: import("@sinclair/typebox").TString;
-        operator: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"null">, import("@sinclair/typebox").TLiteral<"nnull">]>;
+    filters: Type.TOptional<Type.TArray<Type.TUnion<[Type.TObject<{
+        field: Type.TString;
+        operator: Type.TUnion<[Type.TLiteral<"eq">, Type.TLiteral<"ne">, Type.TLiteral<"lt">, Type.TLiteral<"lte">, Type.TLiteral<"gt">, Type.TLiteral<"gte">, Type.TLiteral<"contains">, Type.TLiteral<"startswith">, Type.TLiteral<"endswith">]>;
+        value: Type.TUnion<[Type.TString, Type.TNumber, Type.TBoolean, Type.TNull]>;
+    }>, Type.TObject<{
+        field: Type.TString;
+        operator: Type.TUnion<[Type.TLiteral<"in">, Type.TLiteral<"nin">]>;
+        value: Type.TArray<Type.TUnion<[Type.TString, Type.TNumber, Type.TBoolean, Type.TNull]>>;
+    }>, Type.TObject<{
+        field: Type.TString;
+        operator: Type.TUnion<[Type.TLiteral<"null">, Type.TLiteral<"nnull">]>;
     }>]>>>;
 }>;
-export declare const surfaceOneSourceSchema: import("@sinclair/typebox").TObject<{
-    id: import("@sinclair/typebox").TString;
-    type: import("@sinclair/typebox").TLiteral<"resource-one">;
-    resource: import("@sinclair/typebox").TString;
-    recordId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>;
+export declare const surfaceOneSourceSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TLiteral<"resource-one">;
+    resource: Type.TString;
+    recordId: Type.TUnion<[Type.TString, Type.TNumber]>;
 }>;
-export declare const surfaceLayoutSchema: import("@sinclair/typebox").TObject<{
-    type: import("@sinclair/typebox").TLiteral<"grid">;
-    columns: import("@sinclair/typebox").TLiteral<12>;
-    gap: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"sm">, import("@sinclair/typebox").TLiteral<"md">, import("@sinclair/typebox").TLiteral<"lg">]>>;
+export declare const surfaceLayoutSchema: Type.TObject<{
+    type: Type.TLiteral<"grid">;
+    columns: Type.TLiteral<12>;
+    gap: Type.TOptional<Type.TUnion<[Type.TLiteral<"sm">, Type.TLiteral<"md">, Type.TLiteral<"lg">]>>;
 }>;
-export declare const surfaceWidgetSchema: import("@sinclair/typebox").TObject<{
-    id: import("@sinclair/typebox").TString;
-    type: import("@sinclair/typebox").TString;
-    props: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
-    binding: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-        sourceId: import("@sinclair/typebox").TString;
-        pointer: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+export declare const surfaceWidgetSchema: Type.TObject<{
+    id: Type.TString;
+    type: Type.TString;
+    props: Type.TRecord<"^.*$", Type.TUnknown>;
+    binding: Type.TOptional<Type.TObject<{
+        sourceId: Type.TString;
+        pointer: Type.TOptional<Type.TString>;
     }>>;
-    placement: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-        columnSpan: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+    placement: Type.TOptional<Type.TObject<{
+        columnSpan: Type.TOptional<Type.TInteger>;
     }>>;
 }>;
-export declare const surfaceSpecSchema: import("@sinclair/typebox").TObject<{
-    schemaVersion: import("@sinclair/typebox").TString;
-    catalogVersion: import("@sinclair/typebox").TString;
-    surfaceId: import("@sinclair/typebox").TString;
-    title: import("@sinclair/typebox").TString;
-    layout: import("@sinclair/typebox").TObject<{
-        type: import("@sinclair/typebox").TLiteral<"grid">;
-        columns: import("@sinclair/typebox").TLiteral<12>;
-        gap: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"sm">, import("@sinclair/typebox").TLiteral<"md">, import("@sinclair/typebox").TLiteral<"lg">]>>;
+export declare const surfaceSpecSchema: Type.TObject<{
+    schemaVersion: Type.TString;
+    catalogVersion: Type.TString;
+    surfaceId: Type.TString;
+    title: Type.TString;
+    layout: Type.TObject<{
+        type: Type.TLiteral<"grid">;
+        columns: Type.TLiteral<12>;
+        gap: Type.TOptional<Type.TUnion<[Type.TLiteral<"sm">, Type.TLiteral<"md">, Type.TLiteral<"lg">]>>;
     }>;
-    dataSources: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
-        id: import("@sinclair/typebox").TString;
-        type: import("@sinclair/typebox").TLiteral<"resource-list">;
-        resource: import("@sinclair/typebox").TString;
-        pageSize: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-        sorters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-            field: import("@sinclair/typebox").TString;
-            order: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"asc">, import("@sinclair/typebox").TLiteral<"desc">]>;
+    dataSources: Type.TArray<Type.TUnion<[Type.TObject<{
+        id: Type.TString;
+        type: Type.TLiteral<"resource-list">;
+        resource: Type.TString;
+        pageSize: Type.TOptional<Type.TInteger>;
+        sorters: Type.TOptional<Type.TArray<Type.TObject<{
+            field: Type.TString;
+            order: Type.TUnion<[Type.TLiteral<"asc">, Type.TLiteral<"desc">]>;
         }>>>;
-        filters: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
-            field: import("@sinclair/typebox").TString;
-            operator: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"eq">, import("@sinclair/typebox").TLiteral<"ne">, import("@sinclair/typebox").TLiteral<"lt">, import("@sinclair/typebox").TLiteral<"lte">, import("@sinclair/typebox").TLiteral<"gt">, import("@sinclair/typebox").TLiteral<"gte">, import("@sinclair/typebox").TLiteral<"contains">, import("@sinclair/typebox").TLiteral<"startswith">, import("@sinclair/typebox").TLiteral<"endswith">]>;
-            value: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TNull]>;
-        }>, import("@sinclair/typebox").TObject<{
-            field: import("@sinclair/typebox").TString;
-            operator: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"in">, import("@sinclair/typebox").TLiteral<"nin">]>;
-            value: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber, import("@sinclair/typebox").TBoolean, import("@sinclair/typebox").TNull]>>;
-        }>, import("@sinclair/typebox").TObject<{
-            field: import("@sinclair/typebox").TString;
-            operator: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"null">, import("@sinclair/typebox").TLiteral<"nnull">]>;
+        filters: Type.TOptional<Type.TArray<Type.TUnion<[Type.TObject<{
+            field: Type.TString;
+            operator: Type.TUnion<[Type.TLiteral<"eq">, Type.TLiteral<"ne">, Type.TLiteral<"lt">, Type.TLiteral<"lte">, Type.TLiteral<"gt">, Type.TLiteral<"gte">, Type.TLiteral<"contains">, Type.TLiteral<"startswith">, Type.TLiteral<"endswith">]>;
+            value: Type.TUnion<[Type.TString, Type.TNumber, Type.TBoolean, Type.TNull]>;
+        }>, Type.TObject<{
+            field: Type.TString;
+            operator: Type.TUnion<[Type.TLiteral<"in">, Type.TLiteral<"nin">]>;
+            value: Type.TArray<Type.TUnion<[Type.TString, Type.TNumber, Type.TBoolean, Type.TNull]>>;
+        }>, Type.TObject<{
+            field: Type.TString;
+            operator: Type.TUnion<[Type.TLiteral<"null">, Type.TLiteral<"nnull">]>;
         }>]>>>;
-    }>, import("@sinclair/typebox").TObject<{
-        id: import("@sinclair/typebox").TString;
-        type: import("@sinclair/typebox").TLiteral<"resource-one">;
-        resource: import("@sinclair/typebox").TString;
-        recordId: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNumber]>;
+    }>, Type.TObject<{
+        id: Type.TString;
+        type: Type.TLiteral<"resource-one">;
+        resource: Type.TString;
+        recordId: Type.TUnion<[Type.TString, Type.TNumber]>;
     }>]>>;
-    widgets: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        id: import("@sinclair/typebox").TString;
-        type: import("@sinclair/typebox").TString;
-        props: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
-        binding: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            sourceId: import("@sinclair/typebox").TString;
-            pointer: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    widgets: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        type: Type.TString;
+        props: Type.TRecord<"^.*$", Type.TUnknown>;
+        binding: Type.TOptional<Type.TObject<{
+            sourceId: Type.TString;
+            pointer: Type.TOptional<Type.TString>;
         }>>;
-        placement: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
-            columnSpan: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+        placement: Type.TOptional<Type.TObject<{
+            columnSpan: Type.TOptional<Type.TInteger>;
         }>>;
     }>>;
 }>;

package/dist/schema.js

@@ -1,4 +1,4 @@
-import { Type } from '@sinclair/typebox';
+import { Type } from 'typebox';
 import { SURFACE_LIMITS } from './types.js';
 // 结构定义只维护一份：运行时校验与 AI 输出 schema 共用，策略校验仍在 validation.ts。
 export const surfaceIdSchema = Type.String({

package/dist/svar-schema.d.ts

@@ -1,19 +1,19 @@
-import { type Static } from '@sinclair/typebox';
+import { Type, type Static } from 'typebox';
 import type { JsonObject, SurfaceWidgetDefinition } from './types.js';
 /** JSON-only 契约；宿主引擎、回调、URL 和写操作不属于 AI 可以生成的属性。 */
-export declare const svarGridPropsSchema: import("@sinclair/typebox").TObject<{
-    title: import("@sinclair/typebox").TString;
-    rowKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    height: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-    density: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"compact">, import("@sinclair/typebox").TLiteral<"comfortable">]>>;
-    freezeLeft: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-    freezeRight: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-    emptyLabel: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
-    columns: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
-        field: import("@sinclair/typebox").TString;
-        label: import("@sinclair/typebox").TString;
-        width: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-        format: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"plain">, import("@sinclair/typebox").TLiteral<"number">, import("@sinclair/typebox").TLiteral<"percent">, import("@sinclair/typebox").TLiteral<"date">, import("@sinclair/typebox").TLiteral<"datetime">, import("@sinclair/typebox").TLiteral<"boolean">]>>;
+export declare const svarGridPropsSchema: Type.TObject<{
+    title: Type.TString;
+    rowKey: Type.TOptional<Type.TString>;
+    height: Type.TOptional<Type.TInteger>;
+    density: Type.TOptional<Type.TUnion<[Type.TLiteral<"compact">, Type.TLiteral<"comfortable">]>>;
+    freezeLeft: Type.TOptional<Type.TInteger>;
+    freezeRight: Type.TOptional<Type.TInteger>;
+    emptyLabel: Type.TOptional<Type.TString>;
+    columns: Type.TArray<Type.TObject<{
+        field: Type.TString;
+        label: Type.TString;
+        width: Type.TOptional<Type.TInteger>;
+        format: Type.TOptional<Type.TUnion<[Type.TLiteral<"plain">, Type.TLiteral<"number">, Type.TLiteral<"percent">, Type.TLiteral<"date">, Type.TLiteral<"datetime">, Type.TLiteral<"boolean">]>>;
     }>>;
 }>;
 export type SvarGridProps = Static<typeof svarGridPropsSchema>;

package/dist/svar-schema.js

@@ -1,5 +1,5 @@
-import { Type } from '@sinclair/typebox';
-import { Value } from '@sinclair/typebox/value';
+import { Type } from 'typebox';
+import { Value } from 'typebox/value';
 const field = Type.String({ minLength: 1, maxLength: 64, pattern: '^[A-Za-z][A-Za-z0-9_-]*$' });
 /** JSON-only 契约；宿主引擎、回调、URL 和写操作不属于 AI 可以生成的属性。 */
 export const svarGridPropsSchema = Type.Object({

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { DataProvider } from '@svadmin/core';
-import type { TSchema } from '@sinclair/typebox';
+import type { TSchema } from 'typebox';
 export declare const SURFACE_SCHEMA_VERSION: "surface/v1";
 export declare const SURFACE_LIMITS: {
     readonly maxDataSources: 8;

package/dist/validation.d.ts

@@ -1,2 +1,15 @@
 import { type SurfaceCatalog, type SurfacePolicy, type SurfaceValidationResult } from "./types.js";
+interface SchemaErrorLike {
+    instancePath?: string;
+    path?: string;
+    keyword?: string;
+    params?: Record<string, unknown>;
+    message: string;
+}
+/** TypeBox 1.x groups missing properties into one Ajv-style error; split them per field. */
+export declare function surfaceSchemaIssues(errors: Iterable<SchemaErrorLike>): {
+    path: string;
+    message: string;
+}[];
 export declare function validateSurfaceSpec(input: unknown, catalog: SurfaceCatalog, policy: SurfacePolicy): SurfaceValidationResult;
+export {};

package/dist/validation.js

@@ -1,9 +1,9 @@
-import { TypeCompiler } from "@sinclair/typebox/compiler";
-import { Value } from "@sinclair/typebox/value";
+import { Compile } from "typebox/compile";
+import { Value } from "typebox/value";
 import { decodedJsonPointerToken, jsonPointer, jsonValueIssue } from "./json.js";
 import { surfaceSpecSchema } from './schema.js';
 import { SURFACE_LIMITS, SURFACE_SCHEMA_VERSION, } from "./types.js";
-const compiledSurfaceSpec = TypeCompiler.Compile(surfaceSpecSchema);
+const compiledSurfaceSpec = Compile(surfaceSpecSchema);
 const forbiddenPropertyNames = new Set([
     "class", "className", "color", "href", "html", "innerHTML", "src", "style", "url",
 ]);
@@ -11,17 +11,38 @@ const strictSchemaProbeKey = "__surface_unknown_property_probe__";
 function invalidJsonIssue(pathSegments, message) {
     return { code: "invalid_json", path: jsonPointer(pathSegments), message };
 }
-function schemaErrors(errors) {
+function escapePointerSegment(segment) {
+    return segment.replaceAll('~', '~0').replaceAll('/', '~1');
+}
+/** TypeBox 1.x groups missing properties into one Ajv-style error; split them per field. */
+export function surfaceSchemaIssues(errors) {
     const issues = [];
-    for (const err of errors) {
+    for (const error of errors) {
+        const base = error.instancePath ?? error.path ?? '';
+        const required = error.params?.['requiredProperties'];
+        if (error.keyword === 'required' && Array.isArray(required)) {
+            for (const property of required) {
+                if (typeof property !== 'string')
+                    continue;
+                issues.push({ path: `${base}/${escapePointerSegment(property)}`, message: `must have required property '${property}'` });
+            }
+            continue;
+        }
+        const additional = error.params?.['additionalProperty'];
         issues.push({
-            code: "invalid_json",
-            path: err.path || "",
-            message: err.message,
+            path: typeof additional === 'string' ? `${base}/${escapePointerSegment(additional)}` : base,
+            message: error.message,
         });
     }
     return issues;
 }
+function schemaErrors(errors) {
+    return surfaceSchemaIssues(errors).map((issue) => ({
+        code: "invalid_json",
+        path: issue.path,
+        message: issue.message,
+    }));
+}
 function catalogDefinitions(catalog) {
     return new Map(catalog.widgets.map((widgetDefinition) => [widgetDefinition.type, widgetDefinition]));
 }

package/dist/workflows/action-contracts.js

@@ -1,4 +1,4 @@
-import { Value } from '@sinclair/typebox/value';
+import { Value } from 'typebox/value';
 import { surfaceSchemaToJson } from '../agent-contract.js';
 /** Only the form subset actually rendered by JsonSchemaForm is advertised.
  * No refs, transforms, secret inputs, arbitrary unions or computed fields.
@@ -10,29 +10,30 @@ export function validateSurfaceActionDescriptor(action) {
     }
     surfaceSchemaToJson(action.inputSchema);
     let fields = 0;
-    function visit(schema, depth) {
+    function visit(input, depth) {
+        const schema = input;
         if (++fields > 128 || depth > 8)
             throw new Error('Surface form schema exceeds supported limits');
-        if (schema['anyOf'] || schema['oneOf'] || schema['allOf'] || schema['not'] || schema['if'] || schema.writeOnly
-            || !['object', 'array', 'string', 'number', 'integer', 'boolean'].includes(schema['type'])) {
+        if (schema.anyOf || schema.oneOf || schema.allOf || schema.not || schema.if || schema.writeOnly
+            || !['object', 'array', 'string', 'number', 'integer', 'boolean'].includes(schema.type ?? '')) {
             throw new Error('Unsupported Surface form schema; use a registered custom widget instead');
         }
-        if (schema['type'] === 'object') {
-            if (schema['additionalProperties'] !== false || !schema['properties'])
+        if (schema.type === 'object') {
+            if (schema.additionalProperties !== false || !schema.properties)
                 throw new Error('Surface actions require closed object schemas');
-            for (const [name, child] of Object.entries(schema['properties'])) {
+            for (const [name, child] of Object.entries(schema.properties)) {
                 if (!/^[A-Za-z][A-Za-z0-9_-]{0,63}$/u.test(name))
                     throw new Error('Invalid Surface form field');
                 visit(child, depth + 1);
             }
         }
-        else if (schema['type'] === 'array') {
-            if (!schema['items'] || Array.isArray(schema['items']))
+        else if (schema.type === 'array') {
+            if (!schema.items || Array.isArray(schema.items))
                 throw new Error('Surface forms require homogeneous array items');
-            visit(schema['items'], depth + 1);
+            visit(schema.items, depth + 1);
         }
     }
-    if (action.inputSchema['type'] !== 'object')
+    if (action.inputSchema.type !== 'object')
         throw new Error('Surface actions require an object input schema');
     visit(action.inputSchema, 0);
 }

package/dist/workflows/catalog.d.ts

@@ -1,8 +1,9 @@
+import { Type } from 'typebox';
 import type { SurfaceCatalog, SurfaceWidgetDefinition, JsonObject } from '../types.js';
 import type { SurfaceActionDescriptor } from './types.js';
-export declare const surfaceAppearanceSchema: import("@sinclair/typebox").TObject<{
-    tone: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
-    density: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"compact" | "comfortable">[]>>;
+export declare const surfaceAppearanceSchema: Type.TObject<{
+    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
+    density: Type.TOptional<Type.TUnion<Type.TLiteral<"compact" | "comfortable">[]>>;
 }>;
 export declare function withoutSurfaceAppearance(props: JsonObject): JsonObject;
 /** Adds frame-level semantic appearance to every registered widget without

package/dist/workflows/catalog.js

@@ -1,4 +1,4 @@
-import { Type } from '@sinclair/typebox';
+import { Type } from 'typebox';
 import { surfaceDesignContract } from '../design-contract.js';
 import { validateSurfaceActionDescriptor } from './action-contracts.js';
 export const surfaceAppearanceSchema = Type.Object({
@@ -8,13 +8,14 @@ export const surfaceAppearanceSchema = Type.Object({
 export function withoutSurfaceAppearance(props) {
     return Object.fromEntries(Object.entries(props).filter(([key]) => key !== 'appearance'));
 }
-function withAppearance(schema) {
-    if (Array.isArray(schema['anyOf']))
-        return { ...schema, anyOf: schema['anyOf'].map((part) => withAppearance(part)) };
-    if (schema['type'] !== 'object' || schema['additionalProperties'] !== false || !schema['properties'] || 'appearance' in schema['properties']) {
+function withAppearance(input) {
+    const schema = input;
+    if (Array.isArray(schema.anyOf))
+        return { ...input, anyOf: schema.anyOf.map((part) => withAppearance(part)) };
+    if (schema.type !== 'object' || schema.additionalProperties !== false || !schema.properties || 'appearance' in schema.properties) {
         throw new Error('Surface appearance requires closed object schemas without a reserved appearance property');
     }
-    return { ...schema, properties: { ...schema['properties'], appearance: Type.Optional(surfaceAppearanceSchema) } };
+    return { ...input, properties: { ...schema.properties, appearance: Type.Optional(surfaceAppearanceSchema) } };
 }
 /** Adds frame-level semantic appearance to every registered widget without
  * leaking presentation props into its existing component implementation.

package/dist/workflows/types.d.ts

@@ -1,4 +1,4 @@
-import type { TSchema } from '@sinclair/typebox';
+import type { TSchema } from 'typebox';
 import type { JsonObject, JsonValue, SurfaceCatalog, SurfacePolicy, SurfaceSpec } from '../types.js';
 /** Identity comes from authenticated server middleware, never from model JSON. */
 export interface SurfaceWorkflowContext {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/surface",
-  "version": "0.11.8",
+  "version": "0.13.0",
   "description": "Validated declarative surfaces for svadmin dashboards",
   "type": "module",
   "sideEffects": [
@@ -74,12 +74,12 @@
     }
   },
   "peerDependencies": {
-    "@svadmin/core": ">=0.53.0 <0.59.0",
-    "@svadmin/ui": ">=0.73.0 <0.82.0",
+    "@svadmin/core": ">=0.53.0 <0.60.0",
+    "@svadmin/ui": ">=0.73.0 <0.83.0",
     "svelte": "^5.56.10"
   },
   "dependencies": {
-    "@sinclair/typebox": "^0.34.52"
+    "typebox": "^1.3.34"
   },
   "devDependencies": {
     "@sveltejs/vite-plugin-svelte": "^7.3.0",