@svadmin/surface 0.14.2 → 0.16.0

package/compatibility.json

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

package/dist/builtin-schemas.d.ts

@@ -37,13 +37,13 @@ export type ResourceTableProps = Static<typeof resourceTablePropsSchema>;
 export type BarChartProps = Static<typeof barChartPropsSchema>;
 export type LineChartProps = Static<typeof lineChartPropsSchema>;
 export declare const styledMetricPropsSchema: Type.TUnion<[Type.TObject<{
-    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
+    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "danger" | "neutral">[]>>;
     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">[]>>;
+    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "danger" | "neutral">[]>>;
     label: Type.TString;
     format: Type.TUnion<[Type.TLiteral<"number">, Type.TLiteral<"percent">]>;
     currency: Type.TOptional<Type.TNever>;

package/dist/business-definitions.d.ts

@@ -7,7 +7,7 @@ export declare const resourceDetailPropsSchema: Type.TObject<{
         format: Type.TOptional<Type.TUnion<Type.TLiteral<string>[]>>;
     }>>;
     title: Type.TString;
-    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "neutral" | "danger">[]>>;
+    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "danger" | "neutral">[]>>;
 }>;
 export declare const activityFeedPropsSchema: Type.TObject<{
     idField: Type.TString;
@@ -18,7 +18,7 @@ export declare const activityFeedPropsSchema: Type.TObject<{
     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">[]>>;
+    tone: Type.TOptional<Type.TUnion<Type.TLiteral<"info" | "warning" | "success" | "danger" | "neutral">[]>>;
 }>;
 export type ResourceDetailProps = Static<typeof resourceDetailPropsSchema>;
 export type ActivityFeedProps = Static<typeof activityFeedPropsSchema>;

package/dist/components/ActivityFeedWidget.svelte

@@ -5,7 +5,7 @@
   import { asSurfaceActivities } from '../business-data.js';
   import type { SurfaceWidgetRendererProps } from '../catalog.js';
   import { surfaceMetric } from '../recipes.js';
-  import { formatSurfaceMessage, resolveSurfaceMessages } from '../localization.js';
+  import { formatSurfaceMessage, resolveSurfaceMessages, surfaceErrorMessage } from '../localization.js';
 
   let { props, data, locale = 'en-US', messages }: SurfaceWidgetRendererProps = $props();
   const baseProps = $derived(Object.fromEntries(Object.entries(props).filter(([key]) => key !== 'appearance')));
@@ -23,7 +23,7 @@
   {:else if data.status === 'empty'}
     <p role="status">{text.activityEmpty}</p>
   {:else if data.status === 'error'}
-    <p role="alert">{text.activityUnavailable}</p>
+    <p role="alert">{surfaceErrorMessage(data.error, text, text.activityUnavailable, text.activityInvalidData)}</p>
   {:else if activities?.ok}
     <ActivityFeed activities={activities.value} allowComment={false} title={p.title} emptyLabel={text.activityEmpty}
       countLabel={formatSurfaceMessage(text.activityCount, { count: activities.value.length })} />

package/dist/components/BarChartWidget.svelte

@@ -7,7 +7,7 @@
   import Card from '@svadmin/ui/components/ui/card/card.svelte';
   import { barChartPropsSchema } from '../builtin-schemas.js';
   import type { SurfaceWidgetRendererProps } from '../catalog.js';
-  import { formatSurfaceMessage, resolveSurfaceMessages } from '../localization.js';
+  import { formatSurfaceMessage, resolveSurfaceMessages, surfaceErrorMessage } from '../localization.js';
   import { asChartPoints, compactChartLabel } from '../widget-data.js';
 
   let { props, data, locale = 'en-US', messages }: SurfaceWidgetRendererProps = $props();
@@ -32,7 +32,7 @@
     {:else if data.status === 'empty'}
       <p class="chart-state" role="status">{activeMessages.chartNoData}</p>
     {:else if data.status === 'error'}
-      <p class="chart-state" role="alert">{data.error.message}</p>
+      <p class="chart-state" role="alert">{surfaceErrorMessage(data.error, activeMessages, activeMessages.chartUnavailable, activeMessages.chartInvalidData)}</p>
     {:else if data.status === 'ready' && points?.ok}
       <div class="chart-frame" role="img" aria-label={chartProps.title}>
         <BarChart data={chartData} showValues={chartProps.showValues ?? true} />

package/dist/components/LineChartWidget.svelte

@@ -7,7 +7,7 @@
   import Card from '@svadmin/ui/components/ui/card/card.svelte';
   import { lineChartPropsSchema } from '../builtin-schemas.js';
   import type { SurfaceWidgetRendererProps } from '../catalog.js';
-  import { formatSurfaceMessage, resolveSurfaceMessages } from '../localization.js';
+  import { formatSurfaceMessage, resolveSurfaceMessages, surfaceErrorMessage } from '../localization.js';
   import { asChartPoints, compactChartLabel } from '../widget-data.js';
 
   let { props, data, locale = 'en-US', messages }: SurfaceWidgetRendererProps = $props();
@@ -32,7 +32,7 @@
     {:else if data.status === 'empty'}
       <p class="chart-state" role="status">{activeMessages.chartNoData}</p>
     {:else if data.status === 'error'}
-      <p class="chart-state" role="alert">{data.error.message}</p>
+      <p class="chart-state" role="alert">{surfaceErrorMessage(data.error, activeMessages, activeMessages.chartUnavailable, activeMessages.chartInvalidData)}</p>
     {:else if data.status === 'ready' && points?.ok}
       <div class="chart-frame" role="img" aria-label={chartProps.title}>
         <LineChart

package/dist/components/MetricWidget.svelte

@@ -5,7 +5,7 @@
   import StatsCard from '@svadmin/ui/components/StatsCard.svelte';
   import { styledMetricPropsSchema as metricPropsSchema } from '../builtin-schemas.js';
   import type { SurfaceWidgetRendererProps } from '../catalog.js';
-  import { resolveSurfaceMessages } from '../localization.js';
+  import { resolveSurfaceMessages, surfaceErrorMessage } from '../localization.js';
 
   let { widgetId, props, data, locale = 'en-US', messages }: SurfaceWidgetRendererProps = $props();
   const activeMessages = $derived(resolveSurfaceMessages(locale, messages));
@@ -42,7 +42,7 @@
   {:else}
     <div class={"metric-state " + (metricClasses?.state ?? "")} role={data.status === 'error' ? 'alert' : 'status'}>
       <strong>{metricProps.label}</strong>
-      <span>{data.status === 'error' ? data.error.message : data.status === 'empty' ? activeMessages.metricNoData : activeMessages.metricInvalidData}</span>
+      <span>{data.status === 'error' ? surfaceErrorMessage(data.error, activeMessages, activeMessages.providerUnavailable, activeMessages.metricInvalidData) : data.status === 'empty' ? activeMessages.metricNoData : activeMessages.metricInvalidData}</span>
     </div>
   {/if}
 </article>

package/dist/components/ResourceDetailWidget.svelte

@@ -8,7 +8,7 @@
   import type { SurfaceWidgetRendererProps } from '../catalog.js';
   import type { JsonObject } from '../types.js';
   import { surfaceMetric } from '../recipes.js';
-  import { resolveSurfaceMessages } from '../localization.js';
+  import { resolveSurfaceMessages, surfaceErrorMessage } from '../localization.js';
   import { displayTableValue } from '../widget-data.js';
 
   let { props, data, locale = 'en-US', messages }: SurfaceWidgetRendererProps = $props();
@@ -30,7 +30,7 @@
     {:else if data.status === 'empty'}
       <p role="status">{text.detailEmpty}</p>
     {:else if data.status === 'error'}
-      <p role="alert">{text.detailUnavailable}</p>
+      <p role="alert">{surfaceErrorMessage(data.error, text, text.detailUnavailable, text.detailInvalidData)}</p>
     {:else if record}
       <dl aria-label={p.title}>
         {#each p.fields as item, index (`${index}:${item.field}`)}

package/dist/components/ResourceTableWidget.svelte

@@ -14,7 +14,7 @@
   import Table from '@svadmin/ui/components/ui/table/table.svelte';
   import { styledResourceTablePropsSchema as resourceTablePropsSchema } from '../builtin-schemas.js';
   import type { SurfaceWidgetRendererProps } from '../catalog.js';
-  import { resolveSurfaceMessages } from '../localization.js';
+  import { resolveSurfaceMessages, surfaceErrorMessage } from '../localization.js';
   import { asRecordArray, displayTableValue } from '../widget-data.js';
 
   let { props, data, locale = 'en-US', messages }: SurfaceWidgetRendererProps = $props();
@@ -35,7 +35,7 @@
     {:else if data.status === 'empty'}
       <p class={"table-state " + (tableClasses?.state ?? "")} role="status">{tableProps.emptyLabel ?? activeMessages.tableNoRecords}</p>
     {:else if data.status === 'error'}
-      <p class={"table-state " + (tableClasses?.state ?? "")} role="alert">{data.error.message}</p>
+      <p class={"table-state " + (tableClasses?.state ?? "")} role="alert">{surfaceErrorMessage(data.error, activeMessages, activeMessages.tableUnavailable, activeMessages.tableInvalidData)}</p>
     {:else if data.status === 'ready' && records?.ok}
       <div class="surface-table">
         <Table aria-label={tableProps.title}>

package/dist/components/SurfaceRenderer.svelte

@@ -69,14 +69,26 @@
   ]);
   // 复用 PR #428 的请求所有权与会话隔离实现，不维护第二套缓存。
   const sourceCache = createSurfaceSourceCache({
-    set: (id, state) => { sourceStates.set(id, state); },
+    set: (id, state) => {
+      if (state.status !== 'error') {
+        sourceStates.set(id, state);
+        return;
+      }
+      const message = state.error.code === 'access_denied'
+        ? activeMessages.accessDenied
+        : state.error.code === 'provider_result_not_json' || state.error.code === 'binding_pointer_not_found'
+          ? state.error.message
+          : activeMessages.providerUnavailable;
+      sourceStates.set(id, { ...state, error: { ...state.error, message } });
+    },
     remove: (id) => { sourceStates.delete(id); },
-    onError: (state) => { onError?.({ type: 'data', error: state.error }); },
+    onError: (state, diagnostic) => { onError?.({ type: 'data', error: diagnostic ?? state.error }); },
   });
 
-  function providerError(sourceId: string, failure: unknown): SurfaceSourceDataState {
-    const message = failure instanceof Error ? failure.message : activeMessages.providerUnavailable;
-    return { status: 'error', sourceId, error: { code: 'provider_failed', sourceId, message } };
+  function providerError(sourceId: string): SurfaceSourceDataState {
+    return { status: 'error', sourceId, error: {
+      code: 'provider_failed', sourceId, message: activeMessages.providerUnavailable,
+    } };
   }
 
   const sourceRequests: SurfaceSourceRequest[] = $derived.by(() => {
@@ -97,11 +109,18 @@
         request.id === snapshot.source.id && sameSourceIdentity(request.identity, identity));
       return {
         id: snapshot.source.id, identity, isCurrent,
-        async load(isRequestCurrent) {
-          if (!provider) return providerError(snapshot.source.id, providerFailure);
+        async load(isRequestCurrent, reportDiagnostic) {
+          if (!provider) {
+            reportDiagnostic?.({
+              code: 'provider_failed', sourceId: snapshot.source.id,
+              message: providerFailure instanceof Error ? providerFailure.message : 'Data provider request failed',
+            });
+            return providerError(snapshot.source.id);
+          }
           try {
             return await loadSurfaceSource({
               source: snapshot.source, resourcePolicy: snapshot.resourcePolicy, provider,
+              ...(reportDiagnostic === undefined ? {} : { reportDiagnostic }),
               async authorize(resource, action) {
                 if (!isRequestCurrent()) return { can: false };
                 // 授权检查与缓存身份必须使用同一个所属上下文，不能回退到无关全局授权。
@@ -112,7 +131,13 @@
                 return isRequestCurrent() ? decision : { can: false };
               },
             });
-          } catch (failure) { return providerError(snapshot.source.id, failure); }
+          } catch (failure) {
+            reportDiagnostic?.({
+              code: 'provider_failed', sourceId: snapshot.source.id,
+              message: failure instanceof Error ? failure.message : 'Data provider request failed',
+            });
+            return providerError(snapshot.source.id);
+          }
         },
       };
     });

package/dist/components/SvarGridWidget.svelte

@@ -5,7 +5,7 @@
   import { SVAR_SURFACE_CONTEXT, type SvarSurfaceContext } from '../svar-context.js';
   import { decodeSvarGridProps } from '../svar-schema.js';
   import { asRecordArray } from '../widget-data.js';
-  import { resolveSurfaceMessages } from '../localization.js';
+  import { resolveSurfaceMessages, surfaceErrorMessage } from '../localization.js';
 
   let { widgetId, props, data, locale = 'en-US', messages }: SurfaceWidgetRendererProps = $props();
   const host = getContext<SvarSurfaceContext | undefined>(SVAR_SURFACE_CONTEXT);
@@ -24,9 +24,9 @@
 <section aria-labelledby="svar-surface-{widgetId}" class="surface-data-grid">
   <h3 id="svar-surface-{widgetId}">{config.title}</h3>
   {#if !Grid || !Theme}
-    <p role="alert">{locale.startsWith('zh') ? '宿主尚未配置 SVAR 引擎' : 'The host has not configured the SVAR engine'}</p>
+    <p role="alert">{labels.tableEngineUnavailable}</p>
   {:else if data.status === 'error'}
-    <p role="alert">{data.error.message}</p>
+    <p role="alert">{surfaceErrorMessage(data.error, labels, labels.tableUnavailable, labels.tableInvalidData)}</p>
   {:else if data.status === 'unbound' || (records && !records.ok)}
     <p role="alert">{labels.tableInvalidData}</p>
   {:else}

package/dist/json-render.js

@@ -71,7 +71,7 @@ export function jsonRenderSpecToSurfaceSpec(input, catalog, policy) {
         if (!element)
             return { ok: false, issues: [issue(jsonPointer(['elements', childId]), 'Missing child element')] };
         const widget = readWidgetElement(element, childId);
-        if ('error' in widget)
+        if (typeof widget.error === 'string')
             return { ok: false, issues: [issue(jsonPointer(['elements', childId]), widget.error)] };
         widgets.push(widget);
     }

package/dist/localization.d.ts

@@ -1,6 +1,8 @@
+import type { SurfaceDataError } from './types.js';
 export interface SurfaceMessages {
     readonly renderErrorTitle: string;
     readonly providerUnavailable: string;
+    readonly accessDenied?: string;
     readonly metricNoData: string;
     readonly metricInvalidData: string;
     readonly chartLoading: string;
@@ -11,6 +13,7 @@ export interface SurfaceMessages {
     readonly tableNoRecords: string;
     readonly tableInvalidData: string;
     readonly tableUnavailable: string;
+    readonly tableEngineUnavailable: string;
     readonly detailLoading?: string;
     readonly detailEmpty?: string;
     readonly detailUnavailable?: string;
@@ -26,3 +29,4 @@ export interface SurfaceMessages {
 }
 export declare function resolveSurfaceMessages(locale: string, overrides?: Partial<SurfaceMessages>): Required<SurfaceMessages>;
 export declare function formatSurfaceMessage(template: string, params: Readonly<Record<string, string | number>>): string;
+export declare function surfaceErrorMessage(error: Pick<SurfaceDataError, 'code'>, messages: Required<SurfaceMessages>, unavailable: string, invalid: string): string;

package/dist/localization.js

@@ -1,6 +1,7 @@
 const englishMessages = {
     renderErrorTitle: 'Surface could not be rendered',
     providerUnavailable: 'Data provider is unavailable',
+    accessDenied: 'Access denied',
     metricNoData: 'No data',
     metricInvalidData: 'Metric data is invalid',
     chartLoading: 'Loading {title}',
@@ -11,6 +12,7 @@ const englishMessages = {
     tableNoRecords: 'No records',
     tableInvalidData: 'Table data is invalid',
     tableUnavailable: 'Table data is unavailable',
+    tableEngineUnavailable: 'The host has not configured the SVAR engine',
     detailLoading: 'Loading record',
     detailEmpty: 'No record',
     detailUnavailable: 'Record is unavailable',
@@ -27,6 +29,7 @@ const englishMessages = {
 const simplifiedChineseMessages = {
     renderErrorTitle: '无法渲染 Surface',
     providerUnavailable: '数据提供器不可用',
+    accessDenied: '无权访问',
     metricNoData: '暂无数据',
     metricInvalidData: '指标数据无效',
     chartLoading: '正在加载{title}',
@@ -37,6 +40,7 @@ const simplifiedChineseMessages = {
     tableNoRecords: '暂无记录',
     tableInvalidData: '表格数据无效',
     tableUnavailable: '表格数据不可用',
+    tableEngineUnavailable: '宿主尚未配置 SVAR 引擎',
     detailLoading: '正在加载记录',
     detailEmpty: '暂无记录',
     detailUnavailable: '记录不可用',
@@ -63,3 +67,10 @@ export function formatSurfaceMessage(template, params) {
     }
     return formattedMessage;
 }
+export function surfaceErrorMessage(error, messages, unavailable, invalid) {
+    if (error.code === 'access_denied')
+        return messages.accessDenied;
+    if (error.code === 'provider_result_not_json' || error.code === 'binding_pointer_not_found')
+        return invalid;
+    return unavailable;
+}

package/dist/runtime.d.ts

@@ -1,4 +1,4 @@
-import type { SurfaceDataProvider, SurfaceDataSource, SurfaceResourcePolicy, SurfaceWidgetDataState } from './types.js';
+import type { SurfaceDataError, SurfaceDataProvider, SurfaceDataSource, SurfaceResourcePolicy, SurfaceWidgetDataState } from './types.js';
 export type SurfaceReadAction = 'list' | 'show';
 export interface SurfaceAccessDecision {
     readonly can: boolean;
@@ -10,6 +10,8 @@ export interface LoadSurfaceSourceRequest {
     readonly resourcePolicy: SurfaceResourcePolicy;
     readonly provider: SurfaceDataProvider;
     readonly authorize: SurfaceAuthorizer;
+    /** Internal host hook for diagnostics; never used as user-visible state. */
+    readonly reportDiagnostic?: (diagnostic: SurfaceDataError) => void;
 }
 export type SurfaceLoadedSourceState = Extract<SurfaceWidgetDataState, {
     status: 'ready' | 'error';

package/dist/runtime.js

@@ -46,6 +46,10 @@ function projectRecords(records, readableFields) {
 function sourceError(sourceId, code, message) {
     return { status: 'error', sourceId, error: { code, sourceId, message } };
 }
+function reportedError(request, code, message, diagnosticMessage) {
+    request.reportDiagnostic?.({ code, sourceId: request.source.id, message: diagnosticMessage });
+    return sourceError(request.source.id, code, message);
+}
 function listParams(source) {
     const sorters = source.sorters?.map((sorter) => ({ ...sorter })) ?? [];
     const filters = source.filters?.map((filter) => {
@@ -112,10 +116,11 @@ export async function loadSurfaceSource(request) {
     }
     catch (accessFailure) {
         const message = accessFailure instanceof Error ? accessFailure.message : 'Access check failed';
-        return sourceError(source.id, 'access_check_failed', message);
+        return reportedError(request, 'access_check_failed', 'Access check failed', message);
+    }
+    if (!accessDecision.can) {
+        return reportedError(request, 'access_denied', 'Access denied', accessDecision.reason ?? 'Access denied');
     }
-    if (!accessDecision.can)
-        return sourceError(source.id, 'access_denied', accessDecision.reason ?? 'Access denied');
     try {
         return source.type === 'resource-list'
             ? await loadListSource(source, resourcePolicy, provider)
@@ -123,6 +128,6 @@ export async function loadSurfaceSource(request) {
     }
     catch (providerFailure) {
         const message = providerFailure instanceof Error ? providerFailure.message : 'Data provider request failed';
-        return sourceError(source.id, 'provider_failed', message);
+        return reportedError(request, 'provider_failed', 'Data provider request failed', message);
     }
 }

package/dist/source-cache.d.ts

@@ -1,4 +1,7 @@
-import type { SurfaceDataSource, SurfaceResourcePolicy, SurfaceSourceDataState } from './types.js';
+import type { SurfaceDataSource, SurfaceDataError, SurfaceResourcePolicy, SurfaceSourceDataState } from './types.js';
+type SurfaceDataDiagnostic = Extract<SurfaceSourceDataState, {
+    status: 'error';
+}>['error'];
 /** Only query/projection inputs belong in this key, never widget or layout data. */
 export declare function snapshotSurfaceSource(source: SurfaceDataSource, policy: SurfaceResourcePolicy): {
     source: SurfaceDataSource;
@@ -9,7 +12,7 @@ export interface SurfaceSourceRequest {
     readonly id: string;
     /** Values compare by Object.is; provider and permission identities are not serialized. */
     readonly identity: readonly unknown[];
-    readonly load: (isCurrent: () => boolean) => Promise<SurfaceSourceDataState>;
+    readonly load: (isCurrent: () => boolean, reportDiagnostic?: (diagnostic: SurfaceDataDiagnostic) => void) => Promise<SurfaceSourceDataState>;
     /** Also guards prop changes that happen before Svelte's next effect flush. */
     readonly isCurrent: () => boolean;
 }
@@ -19,7 +22,7 @@ interface SourceCacheSink {
     readonly remove: (sourceId: string) => void;
     readonly onError: (state: Extract<SurfaceSourceDataState, {
         status: 'error';
-    }>) => void;
+    }>, diagnostic?: SurfaceDataError) => void;
 }
 /** Per-renderer reconciliation, not a cross-user or cross-component data cache. */
 export declare function createSurfaceSourceCache(sink: SourceCacheSink): {

package/dist/source-cache.js

@@ -1,3 +1,17 @@
+function stableSourceState(state) {
+    if (state.status !== 'error')
+        return state;
+    const message = state.error.code === 'access_denied'
+        ? 'Access denied'
+        : state.error.code === 'access_check_failed'
+            ? 'Access check failed'
+            : state.error.code === 'provider_failed'
+                ? 'Data provider request failed'
+                : state.error.message;
+    return message === state.error.message
+        ? state
+        : { ...state, error: { ...state.error, message } };
+}
 /** Only query/projection inputs belong in this key, never widget or layout data. */
 export function snapshotSurfaceSource(source, policy) {
     const snapshot = source.type === 'resource-one'
@@ -79,15 +93,23 @@ export function createSurfaceSourceCache(sink) {
                 return;
             }
             let state;
+            let diagnostic;
+            const reportDiagnostic = (next) => {
+                diagnostic ??= next;
+            };
             try {
-                state = await request.load(current);
+                state = await request.load(current, reportDiagnostic);
             }
             catch (failure) {
+                const message = failure instanceof Error ? failure.message : 'Data provider request failed';
+                diagnostic = {
+                    code: 'provider_failed', sourceId: request.id, message,
+                };
                 state = {
                     status: 'error', sourceId: request.id,
                     error: {
                         code: 'provider_failed', sourceId: request.id,
-                        message: failure instanceof Error ? failure.message : 'Data provider request failed',
+                        message: 'Data provider request failed',
                     },
                 };
             }
@@ -95,9 +117,10 @@ export function createSurfaceSourceCache(sink) {
                 retire();
                 return;
             }
+            state = stableSourceState(state);
             sink.set(request.id, state);
             if (state.status === 'error')
-                sink.onError(state);
+                sink.onError(state, diagnostic);
         })();
         return entry.pending;
     }

package/dist/workflows/catalog.d.ts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/surface",
-  "version": "0.14.2",
+  "version": "0.16.0",
   "description": "Validated declarative surfaces for svadmin dashboards",
   "type": "module",
   "sideEffects": [
@@ -74,8 +74,8 @@
     }
   },
   "peerDependencies": {
-    "@svadmin/core": ">=0.53.0 <0.63.0",
-    "@svadmin/ui": ">=0.73.0 <0.89.0",
+    "@svadmin/core": ">=0.53.0 <0.66.0",
+    "@svadmin/ui": ">=0.73.0 <0.92.0",
     "svelte": "^5.56.10"
   },
   "dependencies": {
@@ -86,7 +86,7 @@
     "@testing-library/dom": "^10.4.1",
     "@testing-library/svelte": "^5.4.2",
     "@testing-library/user-event": "^14.6.6",
-    "happy-dom": "^20.11.12",
+    "happy-dom": "^21.0.4",
     "postcss": "^8.5.26",
     "vitest": "^4.1.11"
   },