@svadmin/surface 0.6.2 → 0.7.1

package/README.md

@@ -78,6 +78,25 @@ import {
 
 When rendered inside `AdminApp`, the renderer resolves the configured provider for each resource. A trusted host may instead pass `dataProvider`, which is still narrowed to `getList` and `getOne`.
 
+## AI proposals
+
+The DOM-free root entry also exposes an opt-in Agent protocol. `buildSurfaceAgentPrompt()` constrains a model to return a proposal envelope and includes the host's widget/resource/field allowlists. `parseSurfaceAgentProposal()` parses and validates the complete `SurfaceSpec` against the same catalog and policy without querying a provider:
+
+```ts
+import {
+  buildSurfaceAgentPrompt,
+  parseSurfaceAgentProposal,
+} from '@svadmin/surface';
+
+const prompt = buildSurfaceAgentPrompt('Generate an inventory dashboard', catalog, policy);
+const proposal = parseSurfaceAgentProposal(modelText, catalog, policy);
+if (proposal.ok) {
+  // Preview proposal.value.spec, then require explicit user approval before rendering.
+}
+```
+
+The adapter is deliberately proposal-only. Persistence, revision history, audit records, and the final apply decision belong to the host application. It never executes generated code or mutation actions.
+
 ## Built-in catalog
 
 | Type | Binding | Purpose |

package/compatibility.json

@@ -1,5 +1,5 @@
 {
-  "surface": "0.6.x",
+  "surface": "0.7.x",
   "minimumSupported": {
     "@svadmin/core": "0.34.2",
     "@svadmin/ui": "0.40.6",

package/dist/agent.d.ts

@@ -0,0 +1,23 @@
+import type { SurfaceCatalog, SurfacePolicy, SurfaceSpec, SurfaceValidationIssue } from './types.js';
+/** Wire version for model-produced, human-reviewable Surface proposals. */
+export declare const SURFACE_AGENT_SCHEMA_VERSION: "surface-agent/v1";
+export interface SurfaceAgentProposal {
+    readonly schemaVersion: typeof SURFACE_AGENT_SCHEMA_VERSION;
+    readonly action: 'propose';
+    readonly summary?: string;
+    readonly spec: SurfaceSpec;
+}
+export type SurfaceAgentValidationResult = {
+    readonly ok: true;
+    readonly value: SurfaceAgentProposal;
+} | {
+    readonly ok: false;
+    readonly issues: readonly SurfaceValidationIssue[];
+};
+/**
+ * Parse and fully validate an AI-generated proposal before a host previews it.
+ * This function has no side effects and never queries a provider.
+ */
+export declare function parseSurfaceAgentProposal(input: unknown, catalog: SurfaceCatalog, policy: SurfacePolicy): SurfaceAgentValidationResult;
+/** Build a model instruction that keeps generation inside the Surface contract. */
+export declare function buildSurfaceAgentPrompt(request: string, catalog: SurfaceCatalog, policy: SurfacePolicy): string;

package/dist/agent.js

@@ -0,0 +1,78 @@
+import { Type } from '@sinclair/typebox';
+import { TypeCompiler } from '@sinclair/typebox/compiler';
+import { jsonPointer } from './json.js';
+import { validateSurfaceSpec } from './validation.js';
+/** Wire version for model-produced, human-reviewable Surface proposals. */
+export const SURFACE_AGENT_SCHEMA_VERSION = 'surface-agent/v1';
+const proposalSchema = Type.Object({
+    schemaVersion: Type.Literal(SURFACE_AGENT_SCHEMA_VERSION),
+    action: Type.Literal('propose'),
+    summary: Type.Optional(Type.String({ minLength: 1, maxLength: 240 })),
+    spec: Type.Unknown(),
+}, { additionalProperties: false });
+const compiledProposalSchema = TypeCompiler.Compile(proposalSchema);
+function parseCandidate(value) {
+    if (typeof value !== 'string')
+        return value;
+    const fenced = /```(?:json)?\s*([\s\S]*?)```/i.exec(value);
+    const source = fenced?.[1] ?? value.trim();
+    return JSON.parse(source);
+}
+function proposalIssue(message) {
+    return {
+        code: 'invalid_json',
+        path: '/',
+        message,
+    };
+}
+function proposalSchemaIssues(errors) {
+    return [...errors].map((issue) => ({
+        code: 'invalid_json',
+        path: issue.path || jsonPointer([]),
+        message: issue.message,
+    }));
+}
+/**
+ * Parse and fully validate an AI-generated proposal before a host previews it.
+ * This function has no side effects and never queries a provider.
+ */
+export function parseSurfaceAgentProposal(input, catalog, policy) {
+    let candidate;
+    try {
+        candidate = parseCandidate(input);
+    }
+    catch {
+        return { ok: false, issues: [proposalIssue('Agent proposal must be valid JSON')] };
+    }
+    if (!compiledProposalSchema.Check(candidate)) {
+        return { ok: false, issues: proposalSchemaIssues(compiledProposalSchema.Errors(candidate)) };
+    }
+    const parsed = candidate;
+    const surface = validateSurfaceSpec(parsed.spec, catalog, policy);
+    if (!surface.ok)
+        return surface;
+    return {
+        ok: true,
+        value: {
+            schemaVersion: SURFACE_AGENT_SCHEMA_VERSION,
+            action: 'propose',
+            ...(parsed.summary === undefined ? {} : { summary: parsed.summary }),
+            spec: surface.value,
+        },
+    };
+}
+/** Build a model instruction that keeps generation inside the Surface contract. */
+export function buildSurfaceAgentPrompt(request, catalog, policy) {
+    const widgetTypes = catalog.widgets.map((widget) => widget.type).join(', ') || '(none)';
+    const resources = Object.entries(policy.resources).map(([resource, resourcePolicy]) => {
+        const permissions = [
+            `read=${resourcePolicy.readFields.join(',') || '(none)'}`,
+            `filter=${resourcePolicy.filterFields?.join(',') || '(none)'}`,
+            `sort=${resourcePolicy.sortFields?.join(',') || '(none)'}`,
+            `getOne=${resourcePolicy.allowGetOne === true}`,
+            `maxPageSize=${resourcePolicy.maxPageSize ?? 'default'}`,
+        ];
+        return `${resource}(${permissions.join(';')})`;
+    }).join(' | ') || '(none)';
+    return `${request}\n\n[svadmin surface agent protocol]\nReturn only a human-reviewable fenced JSON proposal. Never generate or execute Svelte, HTML, CSS, JavaScript, SQL, URLs, event handlers, or mutations. The envelope must be {"schemaVersion":"${SURFACE_AGENT_SCHEMA_VERSION}","action":"propose","summary":"...","spec":{...}}. The spec must use schemaVersion "surface/v1" and catalogVersion "${catalog.version}". Allowed widget types: ${widgetTypes}. Resource policy: ${resources}. Use only catalog widgets and policy-authorized resources and fields. If the request cannot be represented safely, explain the limitation without inventing fields or capabilities.`;
+}

package/dist/builtin-schemas.d.ts

@@ -1,20 +1,4 @@
-import { type Static, type TSchema } from "@sinclair/typebox";
-export declare function createParsedSchema<T extends TSchema>(schema: T): T & {
-    parse: (value: unknown) => Static<T>;
-    safeParse: (value: unknown) => {
-        success: true;
-        data: Static<T>;
-    } | {
-        success: false;
-        error: {
-            issues: Array<{
-                path: string[];
-                message: string;
-            }>;
-        };
-    };
-    Check: (value: unknown) => boolean;
-};
+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">;
@@ -25,42 +9,7 @@ export declare const metricPropsSchema: import("@sinclair/typebox").TUnion<[impo
     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>;
-}>]> & {
-    parse: (value: unknown) => {
-        description?: string | undefined;
-        currency: string;
-        label: string;
-        format: "currency";
-    } | {
-        description?: string | undefined;
-        currency?: undefined;
-        label: string;
-        format: "number" | "percent";
-    };
-    safeParse: (value: unknown) => {
-        success: false;
-        error: {
-            issues: Array<{
-                path: string[];
-                message: string;
-            }>;
-        };
-    } | {
-        success: true;
-        data: {
-            description?: string | undefined;
-            currency: string;
-            label: string;
-            format: "currency";
-        } | {
-            description?: string | undefined;
-            currency?: undefined;
-            label: string;
-            format: "number" | "percent";
-        };
-    };
-    Check: (value: unknown) => boolean;
-};
+}>]>;
 export declare const resourceTablePropsSchema: import("@sinclair/typebox").TObject<{
     title: import("@sinclair/typebox").TString;
     emptyLabel: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -69,103 +18,20 @@ export declare const resourceTablePropsSchema: import("@sinclair/typebox").TObje
         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">]>>;
     }>>;
-}> & {
-    parse: (value: unknown) => {
-        emptyLabel?: string | undefined;
-        title: string;
-        columns: {
-            format?: "number" | "boolean" | "text" | "date" | undefined;
-            field: string;
-            label: string;
-        }[];
-    };
-    safeParse: (value: unknown) => {
-        success: false;
-        error: {
-            issues: Array<{
-                path: string[];
-                message: string;
-            }>;
-        };
-    } | {
-        success: true;
-        data: {
-            emptyLabel?: string | undefined;
-            title: string;
-            columns: {
-                format?: "number" | "boolean" | "text" | "date" | undefined;
-                field: string;
-                label: string;
-            }[];
-        };
-    };
-    Check: (value: unknown) => 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>;
-}> & {
-    parse: (value: unknown) => {
-        showValues?: boolean | undefined;
-        title: string;
-        labelField: string;
-        valueField: string;
-    };
-    safeParse: (value: unknown) => {
-        success: false;
-        error: {
-            issues: Array<{
-                path: string[];
-                message: string;
-            }>;
-        };
-    } | {
-        success: true;
-        data: {
-            showValues?: boolean | undefined;
-            title: string;
-            labelField: string;
-            valueField: string;
-        };
-    };
-    Check: (value: unknown) => boolean;
-};
+}>;
 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>;
-}> & {
-    parse: (value: unknown) => {
-        fill?: boolean | undefined;
-        showDots?: boolean | undefined;
-        title: string;
-        labelField: string;
-        valueField: string;
-    };
-    safeParse: (value: unknown) => {
-        success: false;
-        error: {
-            issues: Array<{
-                path: string[];
-                message: string;
-            }>;
-        };
-    } | {
-        success: true;
-        data: {
-            fill?: boolean | undefined;
-            showDots?: boolean | undefined;
-            title: string;
-            labelField: string;
-            valueField: string;
-        };
-    };
-    Check: (value: unknown) => boolean;
-};
+}>;
 export type MetricProps = Static<typeof metricPropsSchema>;
 export type ResourceTableProps = Static<typeof resourceTablePropsSchema>;
 export type BarChartProps = Static<typeof barChartPropsSchema>;

package/dist/builtin-schemas.js

@@ -1,40 +1,4 @@
 import { Type } from "@sinclair/typebox";
-import { TypeCompiler } from "@sinclair/typebox/compiler";
-export function createParsedSchema(schema) {
-    const compiled = TypeCompiler.Compile(schema);
-    const parse = (value) => {
-        if (compiled.Check(value))
-            return value;
-        const errors = [...compiled.Errors(value)];
-        const message = errors.map((e) => (e.path ? e.path + ": " : "") + e.message).join(", ") || "Validation error";
-        const err = new Error(message);
-        err.issues = errors.map((e) => ({
-            path: e.path ? (e.path.startsWith("/") ? e.path.slice(1) : e.path).split("/") : [],
-            message: e.message,
-        }));
-        throw err;
-    };
-    const safeParse = (value) => {
-        if (compiled.Check(value)) {
-            return { success: true, data: value };
-        }
-        const errors = [...compiled.Errors(value)];
-        return {
-            success: false,
-            error: {
-                issues: errors.map((e) => ({
-                    path: e.path ? (e.path.startsWith("/") ? e.path.slice(1) : e.path).split("/") : [],
-                    message: e.message,
-                })),
-            },
-        };
-    };
-    return Object.assign(schema, {
-        parse,
-        safeParse,
-        Check: (val) => compiled.Check(val),
-    });
-}
 const catalogFieldSchema = Type.String({
     minLength: 1,
     maxLength: 64,
@@ -52,8 +16,8 @@ const otherMetric = Type.Object({
     currency: Type.Optional(Type.Never()),
     description: Type.Optional(Type.String({ minLength: 1, maxLength: 160 })),
 }, { additionalProperties: false });
-export const metricPropsSchema = createParsedSchema(Type.Union([currencyMetric, otherMetric]));
-export const resourceTablePropsSchema = createParsedSchema(Type.Object({
+export const metricPropsSchema = Type.Union([currencyMetric, otherMetric]);
+export const resourceTablePropsSchema = Type.Object({
     title: Type.String({ minLength: 1, maxLength: 80 }),
     emptyLabel: Type.Optional(Type.String({ minLength: 1, maxLength: 80 })),
     columns: Type.Array(Type.Object({
@@ -66,17 +30,17 @@ export const resourceTablePropsSchema = createParsedSchema(Type.Object({
             Type.Literal("boolean"),
         ])),
     }, { additionalProperties: false }), { minItems: 1, maxItems: 8 }),
-}, { additionalProperties: false }));
-export const barChartPropsSchema = createParsedSchema(Type.Object({
+}, { additionalProperties: false });
+export const barChartPropsSchema = Type.Object({
     title: Type.String({ minLength: 1, maxLength: 80 }),
     labelField: catalogFieldSchema,
     valueField: catalogFieldSchema,
     showValues: Type.Optional(Type.Boolean()),
-}, { additionalProperties: false }));
-export const lineChartPropsSchema = createParsedSchema(Type.Object({
+}, { additionalProperties: false });
+export const lineChartPropsSchema = Type.Object({
     title: Type.String({ minLength: 1, maxLength: 80 }),
     labelField: catalogFieldSchema,
     valueField: catalogFieldSchema,
     showDots: Type.Optional(Type.Boolean()),
     fill: Type.Optional(Type.Boolean()),
-}, { additionalProperties: false }));
+}, { additionalProperties: false });

package/dist/catalog.d.ts

@@ -31,42 +31,7 @@ export declare const defaultSurfaceCatalog: {
             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>;
-        }>]> & {
-            parse: (value: unknown) => {
-                description?: string | undefined;
-                currency: string;
-                label: string;
-                format: "currency";
-            } | {
-                description?: string | undefined;
-                currency?: undefined;
-                label: string;
-                format: "number" | "percent";
-            };
-            safeParse: (value: unknown) => {
-                success: false;
-                error: {
-                    issues: Array<{
-                        path: string[];
-                        message: string;
-                    }>;
-                };
-            } | {
-                success: true;
-                data: {
-                    description?: string | undefined;
-                    currency: string;
-                    label: string;
-                    format: "currency";
-                } | {
-                    description?: string | undefined;
-                    currency?: undefined;
-                    label: string;
-                    format: "number" | "percent";
-                };
-            };
-            Check: (value: unknown) => boolean;
-        };
+        }>]>;
         readonly component: Component<SurfaceWidgetRendererProps, {}, "">;
     }, {
         readonly type: "resource-table";
@@ -79,38 +44,7 @@ export declare const defaultSurfaceCatalog: {
                 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">]>>;
             }>>;
-        }> & {
-            parse: (value: unknown) => {
-                emptyLabel?: string | undefined;
-                title: string;
-                columns: {
-                    format?: "number" | "boolean" | "text" | "date" | undefined;
-                    field: string;
-                    label: string;
-                }[];
-            };
-            safeParse: (value: unknown) => {
-                success: false;
-                error: {
-                    issues: Array<{
-                        path: string[];
-                        message: string;
-                    }>;
-                };
-            } | {
-                success: true;
-                data: {
-                    emptyLabel?: string | undefined;
-                    title: string;
-                    columns: {
-                        format?: "number" | "boolean" | "text" | "date" | undefined;
-                        field: string;
-                        label: string;
-                    }[];
-                };
-            };
-            Check: (value: unknown) => boolean;
-        };
+        }>;
         readonly getReferencedFields: typeof tableFields;
         readonly component: Component<SurfaceWidgetRendererProps, {}, "">;
     }, {
@@ -121,32 +55,7 @@ export declare const defaultSurfaceCatalog: {
             labelField: import("@sinclair/typebox").TString;
             valueField: import("@sinclair/typebox").TString;
             showValues: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-        }> & {
-            parse: (value: unknown) => {
-                showValues?: boolean | undefined;
-                title: string;
-                labelField: string;
-                valueField: string;
-            };
-            safeParse: (value: unknown) => {
-                success: false;
-                error: {
-                    issues: Array<{
-                        path: string[];
-                        message: string;
-                    }>;
-                };
-            } | {
-                success: true;
-                data: {
-                    showValues?: boolean | undefined;
-                    title: string;
-                    labelField: string;
-                    valueField: string;
-                };
-            };
-            Check: (value: unknown) => boolean;
-        };
+        }>;
         readonly getReferencedFields: typeof barChartFields;
         readonly component: Component<SurfaceWidgetRendererProps, {}, "">;
     }, {
@@ -158,34 +67,7 @@ export declare const defaultSurfaceCatalog: {
             valueField: import("@sinclair/typebox").TString;
             showDots: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
             fill: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
-        }> & {
-            parse: (value: unknown) => {
-                fill?: boolean | undefined;
-                showDots?: boolean | undefined;
-                title: string;
-                labelField: string;
-                valueField: string;
-            };
-            safeParse: (value: unknown) => {
-                success: false;
-                error: {
-                    issues: Array<{
-                        path: string[];
-                        message: string;
-                    }>;
-                };
-            } | {
-                success: true;
-                data: {
-                    fill?: boolean | undefined;
-                    showDots?: boolean | undefined;
-                    title: string;
-                    labelField: string;
-                    valueField: string;
-                };
-            };
-            Check: (value: unknown) => boolean;
-        };
+        }>;
         readonly getReferencedFields: typeof lineChartFields;
         readonly component: Component<SurfaceWidgetRendererProps, {}, "">;
     }];

package/dist/catalog.js

@@ -1,3 +1,4 @@
+import { Value } from '@sinclair/typebox/value';
 import BarChartWidget from './components/BarChartWidget.svelte';
 import LineChartWidget from './components/LineChartWidget.svelte';
 import MetricWidget from './components/MetricWidget.svelte';
@@ -16,14 +17,14 @@ export function defineSurfaceCatalog(catalog) {
     return catalog;
 }
 function tableFields(props) {
-    return resourceTablePropsSchema.parse(props).columns.map((column) => column.field);
+    return Value.Decode(resourceTablePropsSchema, props).columns.map((column) => column.field);
 }
 function barChartFields(props) {
-    const chartProps = barChartPropsSchema.parse(props);
+    const chartProps = Value.Decode(barChartPropsSchema, props);
     return [chartProps.labelField, chartProps.valueField];
 }
 function lineChartFields(props) {
-    const chartProps = lineChartPropsSchema.parse(props);
+    const chartProps = Value.Decode(lineChartPropsSchema, props);
     return [chartProps.labelField, chartProps.valueField];
 }
 export const defaultSurfaceCatalog = defineSurfaceCatalog({

package/dist/components/BarChartWidget.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+  import { Value } from '@sinclair/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';
@@ -10,7 +11,7 @@
 
   let { props, data }: SurfaceWidgetRendererProps = $props();
 
-  const chartProps = $derived(barChartPropsSchema.parse(props));
+  const chartProps = $derived(Value.Decode(barChartPropsSchema, props));
   const points = $derived(data.status === 'ready'
     ? asChartPoints(data.value, chartProps.labelField, chartProps.valueField)
     : null);

package/dist/components/LineChartWidget.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+  import { Value } from '@sinclair/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';
@@ -10,7 +11,7 @@
 
   let { props, data }: SurfaceWidgetRendererProps = $props();
 
-  const chartProps = $derived(lineChartPropsSchema.parse(props));
+  const chartProps = $derived(Value.Decode(lineChartPropsSchema, props));
   const points = $derived(data.status === 'ready'
     ? asChartPoints(data.value, chartProps.labelField, chartProps.valueField)
     : null);

package/dist/components/MetricWidget.svelte

@@ -1,11 +1,12 @@
 <script lang="ts">
+  import { Value } from '@sinclair/typebox/value';
   import StatsCard from '@svadmin/ui/components/StatsCard.svelte';
   import { metricPropsSchema } from '../builtin-schemas.js';
   import type { SurfaceWidgetRendererProps } from '../catalog.js';
 
   let { widgetId, props, data }: SurfaceWidgetRendererProps = $props();
 
-  const metricProps = $derived(metricPropsSchema.parse(props));
+  const metricProps = $derived(Value.Decode(metricPropsSchema, props));
   const formattedValue = $derived.by(() => {
     if (data.status !== 'ready') return '—';
     const value = data.value;

package/dist/components/ResourceTableWidget.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+  import { Value } from '@sinclair/typebox/value';
   import CardContent from '@svadmin/ui/components/ui/card/card-content.svelte';
   import CardHeader from '@svadmin/ui/components/ui/card/card-header.svelte';
   import CardTitle from '@svadmin/ui/components/ui/card/card-title.svelte';
@@ -15,7 +16,7 @@
 
   let { props, data }: SurfaceWidgetRendererProps = $props();
 
-  const tableProps = $derived(resourceTablePropsSchema.parse(props));
+  const tableProps = $derived(Value.Decode(resourceTablePropsSchema, props));
   const records = $derived(data.status === 'ready' ? asRecordArray(data.value) : null);
 </script>
 

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { SURFACE_LIMITS, SURFACE_SCHEMA_VERSION } from './types.js';
 export type { JsonObject, JsonPrimitive, JsonValue, ResourceListDataSource, ResourceListSource, ResourceOneDataSource, ResourceOneSource, SurfaceBinding, SurfaceCatalog, SurfaceCatalogDataKind, SurfaceDataError, SurfaceDataProvider, SurfaceDataSource, SurfaceFilter, SurfaceGridLayout, SurfaceGridSpan, SurfacePolicy, SurfaceResourcePolicy, SurfaceSort, SurfaceSpec, SurfaceValidationCode, SurfaceValidationIssue, SurfaceValidationResult, SurfaceWidget, SurfaceWidgetDataState, SurfaceWidgetDefinition, } from './types.js';
 export { validateSurfaceSpec } from './validation.js';
+export { SURFACE_AGENT_SCHEMA_VERSION, buildSurfaceAgentPrompt, parseSurfaceAgentProposal, } from './agent.js';
+export type { SurfaceAgentProposal, SurfaceAgentValidationResult, } from './agent.js';

package/dist/index.js

@@ -1,2 +1,3 @@
 export { SURFACE_LIMITS, SURFACE_SCHEMA_VERSION } from './types.js';
 export { validateSurfaceSpec } from './validation.js';
+export { SURFACE_AGENT_SCHEMA_VERSION, buildSurfaceAgentPrompt, parseSurfaceAgentProposal, } from './agent.js';

package/dist/types.d.ts

@@ -92,12 +92,7 @@ export type SurfaceCatalogDataKind = 'none' | 'scalar' | 'items';
 export interface SurfaceWidgetDefinition {
     readonly type: string;
     readonly dataKind: SurfaceCatalogDataKind;
-    readonly propsSchema: TSchema | {
-        Check?: (data: unknown) => boolean;
-        safeParse?: (data: unknown) => {
-            success: boolean;
-        };
-    };
+    readonly propsSchema: TSchema;
     /** 组件从绑定记录中读取的字段，由可信 Catalog 提供。 */
     readonly getReferencedFields?: (props: JsonObject) => readonly string[];
 }

package/dist/validation.js

@@ -234,9 +234,6 @@ function checkPropsSchema(schema, data) {
     if ("Check" in schema && typeof schema.Check === "function") {
         return schema.Check(data);
     }
-    if ("safeParse" in schema && typeof schema.safeParse === "function") {
-        return schema.safeParse(data).success;
-    }
     return Value.Check(schema, data);
 }
 function widgetIssue(widget, widgetIndex, definition, sources, policy) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/surface",
-  "version": "0.6.2",
+  "version": "0.7.1",
   "description": "Validated declarative surfaces for svadmin dashboards",
   "type": "module",
   "sideEffects": false,