@devframes/json-render 0.9.3 → 0.9.5

package/dist/hub.d.mts

@@ -1,4 +1,4 @@
-import { i as JsonRenderViewRef, n as JsonRenderView } from "./types-CC2-FD2H.mjs";
+import { a as JsonRenderViewRef, r as JsonRenderView } from "./types-P1hZJnNo.mjs";
 import { DockRenderer, DockRendererMountOptions } from "@devframes/hub/client";
 import { DevframeDockEntryBase } from "@devframes/hub/types";
 //#region src/hub.d.ts

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { Catalog, InferComponentProps, Spec, StateModel, StateStore, UIElement } from "./core.mjs";
-import { a as JsonRenderViewStateRef, i as JsonRenderViewRef, n as JsonRenderView, r as JsonRenderViewInlineRef, t as DevframeJsonRenderSpec } from "./types-CC2-FD2H.mjs";
+import { a as JsonRenderViewRef, i as JsonRenderViewInlineRef, n as DevframeJsonRenderSpec, o as JsonRenderViewStateRef, r as JsonRenderView, t as CatalogUIElement } from "./types-P1hZJnNo.mjs";
 import { z } from "zod";
 //#region src/prop-schemas.d.ts
 declare const StackPropsSchema: z.ZodObject<{
@@ -447,4 +447,4 @@ interface JsonRenderIndexEntry {
 /** The shape of the view-index shared state: entries keyed by `stateKey`. */
 type JsonRenderIndex = Record<string, JsonRenderIndexEntry>;
 //#endregion
-export { BadgePropsSchema, type BaseComponentName, ButtonPropsSchema, CardPropsSchema, type Catalog, CodeBlockPropsSchema, DataTablePropsSchema, type DevframeJsonRenderSpec, DividerPropsSchema, IconPropsSchema, type InferComponentProps, JSON_RENDER_INDEX_KEY, type JsonRenderIndex, type JsonRenderIndexEntry, type JsonRenderView, type JsonRenderViewInlineRef, type JsonRenderViewRef, type JsonRenderViewStateRef, KeyValueTablePropsSchema, LinkPropsSchema, ProgressPropsSchema, SelectPropsSchema, type Spec, StackPropsSchema, type StateModel, type StateStore, SwitchPropsSchema, TabsPropsSchema, TextInputPropsSchema, TextPropsSchema, TreePropsSchema, type UIElement, baseCatalog, baseComponentNames, basePropSchemas, baseSchema };
+export { BadgePropsSchema, type BaseComponentName, ButtonPropsSchema, CardPropsSchema, type Catalog, type CatalogUIElement, CodeBlockPropsSchema, DataTablePropsSchema, type DevframeJsonRenderSpec, DividerPropsSchema, IconPropsSchema, type InferComponentProps, JSON_RENDER_INDEX_KEY, type JsonRenderIndex, type JsonRenderIndexEntry, type JsonRenderView, type JsonRenderViewInlineRef, type JsonRenderViewRef, type JsonRenderViewStateRef, KeyValueTablePropsSchema, LinkPropsSchema, ProgressPropsSchema, SelectPropsSchema, type Spec, StackPropsSchema, type StateModel, type StateStore, SwitchPropsSchema, TabsPropsSchema, TextInputPropsSchema, TextPropsSchema, TreePropsSchema, type UIElement, baseCatalog, baseComponentNames, basePropSchemas, baseSchema };

package/dist/node/index.d.mts

@@ -1,8 +1,9 @@
-import { n as JsonRenderView, t as DevframeJsonRenderSpec } from "../types-CC2-FD2H.mjs";
+import { n as DevframeJsonRenderSpec, r as JsonRenderView } from "../types-P1hZJnNo.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 import { DevframeNodeContext, DevframeScopedNodeContext } from "devframe";
 //#region src/node/create-view.d.ts
 /** Options for {@link createJsonRenderView}. */
-interface CreateJsonRenderViewOptions {
+interface CreateJsonRenderViewOptions<SpecType extends DevframeJsonRenderSpec = DevframeJsonRenderSpec> {
   /**
    * Stable, author-supplied id, unique within the view's scope. Forms the
    * shared-state key `devframe:json-render:<scope>:<id>` and never changes
@@ -10,7 +11,9 @@ interface CreateJsonRenderViewOptions {
    */
   id: string;
   /** The initial spec. */
-  spec: DevframeJsonRenderSpec;
+  spec: SpecType;
+  /** A replacement Standard Schema validator, or `false` to disable validation. */
+  schema?: StandardSchemaV1 | false;
   /**
    * Override the scope segment of the view's stable id. Defaults to the
    * context's namespace when created from a scoped context, otherwise
@@ -40,7 +43,7 @@ type AnyContext = DevframeNodeContext | DevframeScopedNodeContext<string>;
  * view.dispose()
  * ```
  */
-declare function createJsonRenderView(ctx: AnyContext, options: CreateJsonRenderViewOptions): JsonRenderView;
+declare function createJsonRenderView<SpecType extends DevframeJsonRenderSpec = DevframeJsonRenderSpec>(ctx: AnyContext, options: CreateJsonRenderViewOptions<SpecType>): JsonRenderView<SpecType>;
 //#endregion
 //#region ../../node_modules/.pnpm/nostics@1.2.0/node_modules/nostics/dist/diagnostic-wduO7saY.d.mts
 //#region src/utils.d.ts
@@ -300,6 +303,19 @@ declare const diagnostics: Diagnostics<{
     }) => string;
     readonly fix: "Specs and state travel as strict JSON — remove functions, symbols, class instances, Map/Set, or circular references.";
   };
+  readonly DF0073: {
+    readonly why: (p: {
+      id: string;
+      issues: string;
+    }) => string;
+    readonly fix: "Match the authored spec to the Standard Schema passed to `createJsonRenderView`.";
+  };
+  readonly DF0074: {
+    readonly why: (p: {
+      id: string;
+    }) => string;
+    readonly fix: "Use a synchronous Standard Schema so initial creation and updates remain synchronous.";
+  };
 }, readonly [(d: Diagnostic, { method }?: {
   method?: "log" | "warn" | "error";
 }) => void]>;

package/dist/node/index.mjs

@@ -20,6 +20,14 @@ const diagnostics = defineDiagnostics({
 		DF0041: {
 			why: (p) => `JSON-render view "${p.id}" spec is not JSON-serializable: ${p.reason}`,
 			fix: "Specs and state travel as strict JSON — remove functions, symbols, class instances, Map/Set, or circular references."
+		},
+		DF0073: {
+			why: (p) => `JSON-render view "${p.id}" does not match its configured schema: ${p.issues}`,
+			fix: "Match the authored spec to the Standard Schema passed to `createJsonRenderView`."
+		},
+		DF0074: {
+			why: (p) => `JSON-render view "${p.id}" uses an asynchronous Standard Schema.`,
+			fix: "Use a synchronous Standard Schema so initial creation and updates remain synchronous."
 		}
 	}
 });
@@ -77,6 +85,27 @@ function validateElementProps(id, spec) {
 		}
 	}
 }
+function formatStandardSchemaIssues(issues) {
+	return issues.map((issue) => {
+		return `${issue.path?.map((segment) => typeof segment === "object" ? String(segment.key) : String(segment)).join(".") || "(root)"}: ${issue.message}`;
+	}).join("; ");
+}
+function isPromise(value) {
+	return typeof value.then === "function";
+}
+function validateSpec(id, spec, schema) {
+	if (schema === false) return;
+	if (!schema) {
+		validateElementProps(id, spec);
+		return;
+	}
+	const result = schema["~standard"].validate(spec);
+	if (isPromise(result)) throw diagnostics.DF0074({ id });
+	if (result.issues) throw diagnostics.DF0073({
+		id,
+		issues: formatStandardSchemaIssues(result.issues)
+	});
+}
 function normalizeSpec(spec) {
 	return spec.state ? spec : {
 		...spec,
@@ -111,7 +140,7 @@ function createJsonRenderView(ctx, options) {
 		scope
 	});
 	const initial = normalizeSpec(options.spec);
-	validateElementProps(id, initial);
+	validateSpec(id, initial, options.schema);
 	assertJsonSerializable(id, initial);
 	const state = createSharedState({
 		initialValue: initial,
@@ -140,7 +169,7 @@ function createJsonRenderView(ctx, options) {
 		update(spec) {
 			assertLive();
 			const next = normalizeSpec(spec);
-			validateElementProps(id, next);
+			validateSpec(id, next, options.schema);
 			assertJsonSerializable(id, next);
 			state.mutate(() => next);
 		},

package/dist/{types-CC2-FD2H.d.mts → types-P1hZJnNo.d.mts}

@@ -1,4 +1,4 @@
-import { Spec } from "@json-render/core";
+import { Catalog, InferCatalogComponents, InferComponentProps, Spec, UIElement } from "@json-render/core";
 //#region src/view-ref.d.ts
 /**
  * A view backed by **live shared state**: the client subscribes to `stateKey`
@@ -17,9 +17,9 @@ interface JsonRenderViewStateRef {
  * rendered as-is (static: local state and bindings still work, but there is no
  * server-driven live update stream).
  */
-interface JsonRenderViewInlineRef {
+interface JsonRenderViewInlineRef<SpecType extends DevframeJsonRenderSpec = DevframeJsonRenderSpec> {
   /** The full spec, carried in the reference itself. */
-  spec: DevframeJsonRenderSpec;
+  spec: SpecType;
 }
 /**
  * The serializable reference to a JSON-render view that crosses process /
@@ -28,7 +28,7 @@ interface JsonRenderViewInlineRef {
  * the client subscribes through, or an {@link JsonRenderViewInlineRef.spec
  * inline spec} rendered directly.
  */
-type JsonRenderViewRef = JsonRenderViewStateRef | JsonRenderViewInlineRef;
+type JsonRenderViewRef<SpecType extends DevframeJsonRenderSpec = DevframeJsonRenderSpec> = JsonRenderViewStateRef | JsonRenderViewInlineRef<SpecType>;
 //#endregion
 //#region src/types.d.ts
 /**
@@ -36,7 +36,11 @@ type JsonRenderViewRef = JsonRenderViewStateRef | JsonRenderViewInlineRef;
  * `root` key, an `elements` map, and optional initial `state`. This alias is
  * the Devframes-facing name; it does not add or remove fields.
  */
-type DevframeJsonRenderSpec = Spec;
+type DevframeJsonRenderSpec<Element extends UIElement = UIElement> = Omit<Spec, 'elements'> & {
+  elements: Record<string, Element>;
+};
+/** Derive a discriminated element union from every component in a catalog. */
+type CatalogUIElement<CatalogType extends Catalog> = { [ComponentName in keyof InferCatalogComponents<CatalogType> & string]: UIElement<ComponentName, InferComponentProps<CatalogType, ComponentName>>; }[keyof InferCatalogComponents<CatalogType> & string];
 /**
  * A single JSON-Pointer patch to a view's `state` model. `path` is an
  * RFC 6901 JSON Pointer relative to the state root (e.g. `/count`,
@@ -55,7 +59,7 @@ interface JsonRenderStatePatch {
  * serializable {@link JsonRenderViewStateRef} that a hub dock (or any client
  * transport) uses to locate it.
  */
-interface JsonRenderView {
+interface JsonRenderView<SpecType extends DevframeJsonRenderSpec = DevframeJsonRenderSpec> {
   /** Author-supplied stable id, unique within the view's scope. */
   readonly id: string;
   /** Human-facing label published in the view index (defaults to `id`). */
@@ -63,7 +67,7 @@ interface JsonRenderView {
   /** The serializable reference clients subscribe through. */
   readonly ref: JsonRenderViewStateRef;
   /** Replace the entire spec (a structural change replaces the whole spec). */
-  update: (spec: DevframeJsonRenderSpec) => void;
+  update: (spec: SpecType) => void;
   /**
    * Apply JSON-Pointer patches to the view's `state`. Travels as a
    * shared-state patch (not a whole-spec snapshot), so only the changed
@@ -71,9 +75,9 @@ interface JsonRenderView {
    */
   patchState: (patches: JsonRenderStatePatch[]) => void;
   /** Read the current spec (immutable). */
-  value: () => DevframeJsonRenderSpec;
+  value: () => SpecType;
   /** Unregister the shared state and its listeners. */
   dispose: () => void;
 }
 //#endregion
-export { JsonRenderViewStateRef as a, JsonRenderViewRef as i, JsonRenderView as n, JsonRenderViewInlineRef as r, DevframeJsonRenderSpec as t };
+export { JsonRenderViewRef as a, JsonRenderViewInlineRef as i, DevframeJsonRenderSpec as n, JsonRenderViewStateRef as o, JsonRenderView as r, CatalogUIElement as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/json-render",
   "type": "module",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "Protocol layer for describing devframe views as JSON that any renderer can display.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -30,8 +30,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/hub": "0.9.3",
-    "devframe": "0.9.3"
+    "@devframes/hub": "0.9.5",
+    "devframe": "0.9.5"
   },
   "peerDependenciesMeta": {
     "@devframes/hub": {
@@ -40,13 +40,14 @@
   },
   "dependencies": {
     "@json-render/core": "^0.19.0",
+    "@standard-schema/spec": "^1.1.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^26.2.0",
     "tsdown": "^0.22.14",
-    "@devframes/hub": "0.9.3",
-    "devframe": "0.9.3"
+    "@devframes/hub": "0.9.5",
+    "devframe": "0.9.5"
   },
   "scripts": {
     "build": "tsdown",