@devframes/json-render 0.7.5

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-PRESENT Anthony Fu <https://github.com/antfu>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/core.d.mts

@@ -0,0 +1,2 @@
+import { Catalog, InferActionParams, InferCatalogActions, InferCatalogComponents, InferCatalogInput, InferComponentProps, InferSpec, Schema, SchemaBuilder, SchemaDefinition, SchemaOptions, SchemaType, Spec, StateModel, StateStore, UIElement, createStateStore, defineCatalog, defineSchema } from "@json-render/core";
+export { type Catalog, type InferActionParams, type InferCatalogActions, type InferCatalogComponents, type InferCatalogInput, type InferComponentProps, type InferSpec, type Schema, type SchemaBuilder, type SchemaDefinition, type SchemaOptions, type SchemaType, type Spec, type StateModel, type StateStore, type UIElement, createStateStore, defineCatalog, defineSchema };

package/dist/core.mjs

@@ -0,0 +1,2 @@
+import { createStateStore, defineCatalog, defineSchema } from "@json-render/core";
+export { createStateStore, defineCatalog, defineSchema };

package/dist/hub.d.mts

@@ -0,0 +1,27 @@
+import { i as JsonRenderViewRef, n as JsonRenderView } from "./types-DafC9dUn.mjs";
+import { DevframeDockEntryBase } from "@devframes/hub/types";
+//#region src/hub.d.ts
+/**
+ * A `json-render` dock entry. Contributed to the hub's **open** dock union
+ * (`DevframeDockEntryRegistry`) by this opt-in integration — the hub itself
+ * hard-codes no json-render variant. Carries only the serializable
+ * {@link JsonRenderViewRef}; no functions cross the wire.
+ */
+interface DevframeJsonRenderDockEntry extends DevframeDockEntryBase {
+  type: 'json-render';
+  /** Serializable reference the client subscribes through. */
+  view: JsonRenderViewRef;
+}
+declare module '@devframes/hub/types' {
+  interface DevframeDockEntryRegistry {
+    'json-render': DevframeJsonRenderDockEntry;
+  }
+}
+/**
+ * Build a `json-render` dock entry from a {@link JsonRenderView} and the dock
+ * metadata (id, title, icon, …). Projects the view down to its serializable
+ * {@link JsonRenderViewRef} so it survives dock projection into shared state.
+ */
+declare function toJsonRenderDockEntry(view: JsonRenderView, meta: Omit<DevframeJsonRenderDockEntry, 'type' | 'view'>): DevframeJsonRenderDockEntry;
+//#endregion
+export { DevframeJsonRenderDockEntry, toJsonRenderDockEntry };

package/dist/hub.mjs

@@ -0,0 +1,15 @@
+//#region src/hub.ts
+/**
+* Build a `json-render` dock entry from a {@link JsonRenderView} and the dock
+* metadata (id, title, icon, …). Projects the view down to its serializable
+* {@link JsonRenderViewRef} so it survives dock projection into shared state.
+*/
+function toJsonRenderDockEntry(view, meta) {
+	return {
+		...meta,
+		type: "json-render",
+		view: view.ref
+	};
+}
+//#endregion
+export { toJsonRenderDockEntry };

package/dist/index.d.mts

@@ -0,0 +1,337 @@
+import { Catalog, InferComponentProps, Spec, StateModel, StateStore, UIElement } from "./core.mjs";
+import { i as JsonRenderViewRef, n as JsonRenderView, r as JSON_RENDER_UPSTREAM_VERSION, t as DevframeJsonRenderSpec } from "./types-DafC9dUn.mjs";
+import { z } from "zod";
+//#region src/prop-schemas.d.ts
+declare const StackPropsSchema: z.ZodObject<{
+  direction: z.ZodOptional<z.ZodEnum<{
+    row: "row";
+    column: "column";
+  }>>;
+  gap: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  align: z.ZodOptional<z.ZodEnum<{
+    start: "start";
+    center: "center";
+    end: "end";
+    stretch: "stretch";
+  }>>;
+  justify: z.ZodOptional<z.ZodEnum<{
+    start: "start";
+    center: "center";
+    end: "end";
+    between: "between";
+    around: "around";
+  }>>;
+  wrap: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  flex: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const CardPropsSchema: z.ZodObject<{
+  title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  border: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  collapsible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  defaultCollapsed: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const TextPropsSchema: z.ZodObject<{
+  text: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  variant: z.ZodOptional<z.ZodEnum<{
+    code: "code";
+    heading: "heading";
+    subheading: "subheading";
+    body: "body";
+    caption: "caption";
+  }>>;
+  weight: z.ZodOptional<z.ZodEnum<{
+    bold: "bold";
+    normal: "normal";
+    medium: "medium";
+  }>>;
+  color: z.ZodOptional<z.ZodEnum<{
+    success: "success";
+    base: "base";
+    muted: "muted";
+    faint: "faint";
+    primary: "primary";
+    warning: "warning";
+    danger: "danger";
+  }>>;
+}, z.core.$strip>;
+declare const BadgePropsSchema: z.ZodObject<{
+  text: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  variant: z.ZodOptional<z.ZodEnum<{
+    success: "success";
+    default: "default";
+    warning: "warning";
+    danger: "danger";
+    info: "info";
+  }>>;
+  minWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const ButtonPropsSchema: z.ZodObject<{
+  label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  variant: z.ZodOptional<z.ZodEnum<{
+    primary: "primary";
+    danger: "danger";
+    secondary: "secondary";
+    ghost: "ghost";
+  }>>;
+  icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  disabled: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const IconPropsSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  size: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const DividerPropsSchema: z.ZodObject<{
+  label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const TextInputPropsSchema: z.ZodObject<{
+  value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  placeholder: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  disabled: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  type: z.ZodOptional<z.ZodEnum<{
+    number: "number";
+    search: "search";
+    text: "text";
+    password: "password";
+    email: "email";
+  }>>;
+  loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const SwitchPropsSchema: z.ZodObject<{
+  value: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  disabled: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const KeyValueTablePropsSchema: z.ZodObject<{
+  data: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const DataTablePropsSchema: z.ZodObject<{
+  columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>]>>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  rows: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodUnknown>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  height: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const CodeBlockPropsSchema: z.ZodObject<{
+  code: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  language: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  filename: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  height: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const ProgressPropsSchema: z.ZodObject<{
+  value: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  max: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+declare const TreePropsSchema: z.ZodObject<{
+  data: z.ZodOptional<z.ZodUnknown>;
+  defaultExpanded: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+}, z.core.$strip>;
+/**
+ * Map of base-catalog component name → Zod prop schema. The keys are the
+ * canonical component set (catalog v1).
+ */
+declare const basePropSchemas: {
+  readonly Stack: z.ZodObject<{
+    direction: z.ZodOptional<z.ZodEnum<{
+      row: "row";
+      column: "column";
+    }>>;
+    gap: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    align: z.ZodOptional<z.ZodEnum<{
+      start: "start";
+      center: "center";
+      end: "end";
+      stretch: "stretch";
+    }>>;
+    justify: z.ZodOptional<z.ZodEnum<{
+      start: "start";
+      center: "center";
+      end: "end";
+      between: "between";
+      around: "around";
+    }>>;
+    wrap: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    flex: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly Card: z.ZodObject<{
+    title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    border: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    collapsible: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    defaultCollapsed: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly Text: z.ZodObject<{
+    text: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    variant: z.ZodOptional<z.ZodEnum<{
+      code: "code";
+      heading: "heading";
+      subheading: "subheading";
+      body: "body";
+      caption: "caption";
+    }>>;
+    weight: z.ZodOptional<z.ZodEnum<{
+      bold: "bold";
+      normal: "normal";
+      medium: "medium";
+    }>>;
+    color: z.ZodOptional<z.ZodEnum<{
+      success: "success";
+      base: "base";
+      muted: "muted";
+      faint: "faint";
+      primary: "primary";
+      warning: "warning";
+      danger: "danger";
+    }>>;
+  }, z.core.$strip>;
+  readonly Badge: z.ZodObject<{
+    text: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    variant: z.ZodOptional<z.ZodEnum<{
+      success: "success";
+      default: "default";
+      warning: "warning";
+      danger: "danger";
+      info: "info";
+    }>>;
+    minWidth: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly Button: z.ZodObject<{
+    label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    variant: z.ZodOptional<z.ZodEnum<{
+      primary: "primary";
+      danger: "danger";
+      secondary: "secondary";
+      ghost: "ghost";
+    }>>;
+    icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    disabled: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly Icon: z.ZodObject<{
+    name: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    size: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly Divider: z.ZodObject<{
+    label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly TextInput: z.ZodObject<{
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    placeholder: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    disabled: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    type: z.ZodOptional<z.ZodEnum<{
+      number: "number";
+      search: "search";
+      text: "text";
+      password: "password";
+      email: "email";
+    }>>;
+    loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly Switch: z.ZodObject<{
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    disabled: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly KeyValueTable: z.ZodObject<{
+    data: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly DataTable: z.ZodObject<{
+    columns: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      key: z.ZodString;
+      label: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>]>>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    rows: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodUnknown>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    height: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    loading: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly CodeBlock: z.ZodObject<{
+    code: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    language: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    filename: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    height: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly Progress: z.ZodObject<{
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    max: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    label: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly Tree: z.ZodObject<{
+    data: z.ZodOptional<z.ZodUnknown>;
+    defaultExpanded: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+};
+/** Canonical base-catalog component name. */
+type BaseComponentName = keyof typeof basePropSchemas;
+/** The ordered list of base-catalog component names (catalog v1). */
+declare const baseComponentNames: BaseComponentName[];
+//#endregion
+//#region src/catalog.d.ts
+/**
+ * The Devframes base-catalog schema. A Devframes spec is an
+ * `@json-render/core` `Spec` (flat `root` + `elements` map); the structural
+ * fields upstream's Vue schema omits (`state`, `on`, `repeat`, `watch`) pass
+ * through unchecked. The one validation Devframes adds is per-component prop
+ * validation (see {@link basePropSchemas}).
+ */
+declare const baseSchema: import("@json-render/core").Schema<{
+  spec: import("@json-render/core").SchemaType<"object", {
+    root: import("@json-render/core").SchemaType<"string", unknown>;
+    elements: import("@json-render/core").SchemaType<"record", import("@json-render/core").SchemaType<"object", {
+      type: import("@json-render/core").SchemaType<"ref", string>;
+      props: import("@json-render/core").SchemaType<"propsOf", string>;
+      children: import("@json-render/core").SchemaType<"array", import("@json-render/core").SchemaType<"string", unknown>>;
+    }>>;
+  }>;
+  catalog: import("@json-render/core").SchemaType<"object", {
+    components: import("@json-render/core").SchemaType<"map", {
+      props: import("@json-render/core").SchemaType<"zod", unknown>;
+      description: import("@json-render/core").SchemaType<"string", unknown>;
+    }>;
+    actions: import("@json-render/core").SchemaType<"map", {
+      description: import("@json-render/core").SchemaType<"string", unknown>;
+    }>;
+  }>;
+}>;
+/**
+ * The Devframes base catalog (catalog v1): the fourteen canonical components
+ * with their Devframes-authored Zod prop schemas and descriptions, and an
+ * empty action set (actions are dispatched dynamically via the bridge, they
+ * are not declared here). Reference frontend libraries implement this set.
+ */
+declare const baseCatalog: import("@json-render/core").Catalog<{
+  spec: import("@json-render/core").SchemaType<"object", {
+    root: import("@json-render/core").SchemaType<"string", unknown>;
+    elements: import("@json-render/core").SchemaType<"record", import("@json-render/core").SchemaType<"object", {
+      type: import("@json-render/core").SchemaType<"ref", string>;
+      props: import("@json-render/core").SchemaType<"propsOf", string>;
+      children: import("@json-render/core").SchemaType<"array", import("@json-render/core").SchemaType<"string", unknown>>;
+    }>>;
+  }>;
+  catalog: import("@json-render/core").SchemaType<"object", {
+    components: import("@json-render/core").SchemaType<"map", {
+      props: import("@json-render/core").SchemaType<"zod", unknown>;
+      description: import("@json-render/core").SchemaType<"string", unknown>;
+    }>;
+    actions: import("@json-render/core").SchemaType<"map", {
+      description: import("@json-render/core").SchemaType<"string", unknown>;
+    }>;
+  }>;
+}, {
+  components: { [K in keyof typeof basePropSchemas]: {
+    props: (typeof basePropSchemas)[K];
+    description: string;
+  }; };
+  actions: {};
+}>;
+//#endregion
+export { BadgePropsSchema, type BaseComponentName, ButtonPropsSchema, CardPropsSchema, type Catalog, CodeBlockPropsSchema, DataTablePropsSchema, type DevframeJsonRenderSpec, DividerPropsSchema, IconPropsSchema, type InferComponentProps, JSON_RENDER_UPSTREAM_VERSION, type JsonRenderView, type JsonRenderViewRef, KeyValueTablePropsSchema, ProgressPropsSchema, type Spec, StackPropsSchema, type StateModel, type StateStore, SwitchPropsSchema, TextInputPropsSchema, TextPropsSchema, TreePropsSchema, type UIElement, baseCatalog, baseComponentNames, basePropSchemas, baseSchema };

package/dist/index.mjs

@@ -0,0 +1,58 @@
+import { _ as basePropSchemas, a as CodeBlockPropsSchema, c as IconPropsSchema, d as StackPropsSchema, f as SwitchPropsSchema, g as baseComponentNames, h as TreePropsSchema, i as CardPropsSchema, l as KeyValueTablePropsSchema, m as TextPropsSchema, n as BadgePropsSchema, o as DataTablePropsSchema, p as TextInputPropsSchema, r as ButtonPropsSchema, s as DividerPropsSchema, t as JSON_RENDER_UPSTREAM_VERSION, u as ProgressPropsSchema } from "./view-ref-70LHsEHb.mjs";
+import { defineCatalog, defineSchema } from "@json-render/core";
+//#region src/catalog.ts
+/**
+* The Devframes base-catalog schema. A Devframes spec is an
+* `@json-render/core` `Spec` (flat `root` + `elements` map); the structural
+* fields upstream's Vue schema omits (`state`, `on`, `repeat`, `watch`) pass
+* through unchecked. The one validation Devframes adds is per-component prop
+* validation (see {@link basePropSchemas}).
+*/
+const baseSchema = defineSchema((s) => ({
+	spec: s.object({
+		root: s.string(),
+		elements: s.record(s.object({
+			type: s.ref("catalog.components"),
+			props: s.propsOf("catalog.components"),
+			children: s.array(s.string())
+		}))
+	}),
+	catalog: s.object({
+		components: s.map({
+			props: s.zod(),
+			description: s.string()
+		}),
+		actions: s.map({ description: s.string() })
+	})
+}));
+const componentDescriptions = {
+	Stack: "Flex row/column container with gap, padding, alignment and justification.",
+	Card: "Bordered container with an optional title and collapsible body.",
+	Text: "Typographic text — heading, subheading, body, caption or inline code.",
+	Badge: "Small status pill with a semantic variant.",
+	Button: "Clickable button with a variant, optional icon and loading state.",
+	Icon: "Renders an icon resolved by name at runtime.",
+	Divider: "Horizontal rule with an optional centered label.",
+	TextInput: "Single-line text input with two-way state binding.",
+	Switch: "Accessible on/off toggle bound to a boolean state value.",
+	KeyValueTable: "Two-column table of key/value pairs.",
+	DataTable: "Tabular data with columns, rows and optional scroll height.",
+	CodeBlock: "Preformatted code block with a filename and language label.",
+	Progress: "Determinate progress bar.",
+	Tree: "Recursive object/array viewer with expandable nodes."
+};
+/**
+* The Devframes base catalog (catalog v1): the fourteen canonical components
+* with their Devframes-authored Zod prop schemas and descriptions, and an
+* empty action set (actions are dispatched dynamically via the bridge, they
+* are not declared here). Reference frontend libraries implement this set.
+*/
+const baseCatalog = defineCatalog(baseSchema, {
+	components: Object.fromEntries(Object.keys(basePropSchemas).map((name) => [name, {
+		props: basePropSchemas[name],
+		description: componentDescriptions[name]
+	}])),
+	actions: {}
+});
+//#endregion
+export { BadgePropsSchema, ButtonPropsSchema, CardPropsSchema, CodeBlockPropsSchema, DataTablePropsSchema, DividerPropsSchema, IconPropsSchema, JSON_RENDER_UPSTREAM_VERSION, KeyValueTablePropsSchema, ProgressPropsSchema, StackPropsSchema, SwitchPropsSchema, TextInputPropsSchema, TextPropsSchema, TreePropsSchema, baseCatalog, baseComponentNames, basePropSchemas, baseSchema };

package/dist/node/index.d.mts

@@ -0,0 +1,76 @@
+import { n as JsonRenderView, t as DevframeJsonRenderSpec } from "../types-DafC9dUn.mjs";
+import { Diagnostic } from "nostics";
+import { DevframeNodeContext, DevframeScopedNodeContext } from "devframe/types";
+//#region src/node/create-view.d.ts
+/** Options for {@link createJsonRenderView}. */
+interface CreateJsonRenderViewOptions {
+  /**
+   * Stable, author-supplied id, unique within the view's scope. Forms the
+   * shared-state key `devframe:json-render:<scope>:<id>` and never changes
+   * across updates, so a client keeps its subscription across reconnects.
+   */
+  id: string;
+  /** The initial spec. */
+  spec: DevframeJsonRenderSpec;
+  /**
+   * Override the scope segment of the view's stable id. Defaults to the
+   * context's namespace when created from a scoped context, otherwise
+   * `'global'`.
+   */
+  scope?: string;
+}
+type AnyContext = DevframeNodeContext | DevframeScopedNodeContext<string>;
+/**
+ * Create a JSON-render view bound to a devframe context. Registers a
+ * server-side shared state (patches enabled) carrying the live spec + state,
+ * validates element props at ingress against the base catalog, and returns a
+ * handle plus the serializable {@link JsonRenderView.ref} a client subscribes
+ * through.
+ *
+ * @example
+ * ```ts
+ * const view = createJsonRenderView(ctx, { id: 'metrics', spec })
+ * view.update(nextSpec)
+ * view.patchState([{ op: 'replace', path: '/count', value: 3 }])
+ * view.dispose()
+ * ```
+ */
+declare function createJsonRenderView(ctx: AnyContext, options: CreateJsonRenderViewOptions): JsonRenderView;
+//#endregion
+//#region src/node/diagnostics.d.ts
+interface ReporterOptions {
+  method?: 'log' | 'warn' | 'error';
+}
+declare function jsonRenderReporter(d: Diagnostic, { method }?: ReporterOptions): void;
+declare const diagnostics: import("nostics").Diagnostics<{
+  readonly DF0038: {
+    readonly why: (p: {
+      id: string;
+      key: string;
+      issues: string;
+    }) => string;
+    readonly fix: "Match the element props to the base catalog's prop schema for that component. See the component reference for the expected shape.";
+  };
+  readonly DF0039: {
+    readonly why: (p: {
+      id: string;
+      scope: string;
+    }) => string;
+    readonly fix: "Give each view a stable id unique within its scope, or dispose the previous view before recreating it.";
+  };
+  readonly DF0040: {
+    readonly why: (p: {
+      id: string;
+    }) => string;
+    readonly fix: "Create a fresh view with `createJsonRenderView` instead of reusing a disposed handle.";
+  };
+  readonly DF0041: {
+    readonly why: (p: {
+      id: string;
+      reason: string;
+    }) => string;
+    readonly fix: "Specs and state travel as strict JSON — remove functions, symbols, class instances, Map/Set, or circular references.";
+  };
+}, readonly [typeof jsonRenderReporter]>;
+//#endregion
+export { type CreateJsonRenderViewOptions, createJsonRenderView, diagnostics as jsonRenderDiagnostics };

package/dist/node/index.mjs

@@ -0,0 +1,154 @@
+import { _ as basePropSchemas, t as JSON_RENDER_UPSTREAM_VERSION } from "../view-ref-70LHsEHb.mjs";
+import { createSharedState } from "devframe/utils/shared-state";
+import { colors } from "devframe/utils/colors";
+import { defineDiagnostics } from "nostics";
+import { ansiFormatter } from "nostics/formatters/ansi";
+//#region src/node/diagnostics.ts
+const formatAnsi = ansiFormatter(colors);
+function jsonRenderReporter(d, { method = "warn" } = {}) {
+	console[method](formatAnsi(d));
+}
+const diagnostics = defineDiagnostics({
+	docsBase: "https://devfra.me/errors",
+	reporters: [jsonRenderReporter],
+	codes: {
+		DF0038: {
+			why: (p) => `JSON-render view "${p.id}" received invalid props on element "${p.key}": ${p.issues}`,
+			fix: "Match the element props to the base catalog's prop schema for that component. See the component reference for the expected shape."
+		},
+		DF0039: {
+			why: (p) => `A JSON-render view with id "${p.id}" already exists in scope "${p.scope}".`,
+			fix: "Give each view a stable id unique within its scope, or dispose the previous view before recreating it."
+		},
+		DF0040: {
+			why: (p) => `JSON-render view "${p.id}" was used after it was disposed.`,
+			fix: "Create a fresh view with `createJsonRenderView` instead of reusing a disposed handle."
+		},
+		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."
+		}
+	}
+});
+//#endregion
+//#region src/node/create-view.ts
+function isScoped(ctx) {
+	return "base" in ctx && "namespace" in ctx;
+}
+const registries = /* @__PURE__ */ new WeakMap();
+function registryFor(ctx) {
+	let set = registries.get(ctx);
+	if (!set) {
+		set = /* @__PURE__ */ new Set();
+		registries.set(ctx, set);
+	}
+	return set;
+}
+/** Parse an RFC 6901 JSON Pointer into path segments. */
+function parsePointer(pointer) {
+	if (pointer === "" || pointer === "/") return [];
+	return pointer.replace(/^\//, "").split("/").map((seg) => seg.replace(/~1/g, "/").replace(/~0/g, "~"));
+}
+function assertJsonSerializable(id, spec) {
+	try {
+		JSON.stringify(spec);
+	} catch (error) {
+		throw diagnostics.DF0041({
+			id,
+			reason: error.message
+		});
+	}
+}
+function validateElementProps(id, spec) {
+	for (const [key, element] of Object.entries(spec.elements ?? {})) {
+		const schema = basePropSchemas[element.type];
+		if (!schema) continue;
+		const result = schema.safeParse(element.props ?? {});
+		if (!result.success) {
+			const issues = result.error.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+			throw diagnostics.DF0038({
+				id,
+				key,
+				issues
+			});
+		}
+	}
+}
+function normalizeSpec(spec) {
+	return spec.state ? spec : {
+		...spec,
+		state: {}
+	};
+}
+/**
+* Create a JSON-render view bound to a devframe context. Registers a
+* server-side shared state (patches enabled) carrying the live spec + state,
+* validates element props at ingress against the base catalog, and returns a
+* handle plus the serializable {@link JsonRenderView.ref} a client subscribes
+* through.
+*
+* @example
+* ```ts
+* const view = createJsonRenderView(ctx, { id: 'metrics', spec })
+* view.update(nextSpec)
+* view.patchState([{ op: 'replace', path: '/count', value: 3 }])
+* view.dispose()
+* ```
+*/
+function createJsonRenderView(ctx, options) {
+	const scoped = isScoped(ctx);
+	const baseCtx = scoped ? ctx.base : ctx;
+	const scope = options.scope ?? (scoped ? ctx.namespace : "global");
+	const { id } = options;
+	const stateKey = `devframe:json-render:${scope}:${id}`;
+	const registry = registryFor(baseCtx);
+	if (registry.has(stateKey)) throw diagnostics.DF0039({
+		id,
+		scope
+	});
+	const initial = normalizeSpec(options.spec);
+	validateElementProps(id, initial);
+	assertJsonSerializable(id, initial);
+	const state = createSharedState({
+		initialValue: initial,
+		enablePatches: true
+	});
+	registry.add(stateKey);
+	baseCtx.rpc.sharedState.get(stateKey, { sharedState: state });
+	let disposed = false;
+	function assertLive() {
+		if (disposed) throw diagnostics.DF0040({ id });
+	}
+	return {
+		id,
+		ref: {
+			stateKey,
+			upstreamVersion: JSON_RENDER_UPSTREAM_VERSION
+		},
+		value: () => state.value(),
+		update(spec) {
+			assertLive();
+			const next = normalizeSpec(spec);
+			validateElementProps(id, next);
+			assertJsonSerializable(id, next);
+			state.mutate(() => next);
+		},
+		patchState(patches) {
+			assertLive();
+			const prefixed = patches.map((p) => ({
+				op: p.op,
+				path: ["state", ...parsePointer(p.path)],
+				value: p.value
+			}));
+			state.patch(prefixed);
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			registry.delete(stateKey);
+			baseCtx.rpc.sharedState.delete(stateKey);
+		}
+	};
+}
+//#endregion
+export { createJsonRenderView, diagnostics as jsonRenderDiagnostics };

package/dist/types-DafC9dUn.d.mts

@@ -0,0 +1,78 @@
+import { Spec } from "@json-render/core";
+//#region src/view-ref.d.ts
+/**
+ * The `@json-render/core` / `@json-render/vue` version this build of
+ * `@devframes/json-render` is written and tested against. It is the sole
+ * compatibility signal carried across the wire — there is no separate
+ * Devframes protocol/catalog version stamp. A renderer compares its own
+ * upstream version against a view's {@link JsonRenderViewRef.upstreamVersion}
+ * and warns (rather than blocking) on a mismatch.
+ *
+ * Kept paired with the caret range on `@json-render/core` /
+ * `@json-render/vue` in this package's manifest; the committed lockfile is
+ * the guard against a breaking upstream upgrade.
+ */
+declare const JSON_RENDER_UPSTREAM_VERSION = "0.19.0";
+/**
+ * The serializable reference to a JSON-render view that crosses process /
+ * static boundaries — e.g. projected onto a hub dock entry. It carries **no
+ * functions** and no Devframes catalog version: just the shared-state key the
+ * client subscribes to for the live spec + state, and the upstream version
+ * the view was authored against.
+ *
+ * This is the corrected projection contract: the previous hub implementation
+ * leaked an accidental `_stateKey` field and a non-serializable renderer
+ * handle; a `JsonRenderViewRef` is a plain, fully-serializable object.
+ */
+interface JsonRenderViewRef {
+  /** Shared-state key the client subscribes to for the live spec + state. */
+  stateKey: string;
+  /** Upstream `@json-render/*` version the view was authored against. */
+  upstreamVersion: string;
+}
+//#endregion
+//#region src/types.d.ts
+/**
+ * A Devframes JSON-render spec **is** an `@json-render/core` `Spec`: a flat
+ * `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;
+/**
+ * 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`,
+ * `/user/name`). Structural spec changes replace the whole spec via
+ * `update` instead.
+ */
+interface JsonRenderStatePatch {
+  op: 'add' | 'remove' | 'replace';
+  /** JSON Pointer relative to the state root, e.g. `/count`. */
+  path: string;
+  value?: unknown;
+}
+/**
+ * A JSON-render view handle, returned by `createJsonRenderView`. Owns a
+ * server-side shared state carrying the live spec + state, and exposes the
+ * serializable {@link JsonRenderViewRef} that a hub dock (or any client
+ * transport) uses to locate it.
+ */
+interface JsonRenderView {
+  /** Author-supplied stable id, unique within the view's scope. */
+  readonly id: string;
+  /** The serializable reference clients subscribe through. */
+  readonly ref: JsonRenderViewRef;
+  /** Replace the entire spec (a structural change replaces the whole spec). */
+  update: (spec: DevframeJsonRenderSpec) => 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
+   * paths cross the wire.
+   */
+  patchState: (patches: JsonRenderStatePatch[]) => void;
+  /** Read the current spec (immutable). */
+  value: () => DevframeJsonRenderSpec;
+  /** Unregister the shared state and its listeners. */
+  dispose: () => void;
+}
+//#endregion
+export { JsonRenderViewRef as i, JsonRenderView as n, JSON_RENDER_UPSTREAM_VERSION as r, DevframeJsonRenderSpec as t };

package/dist/view-ref-70LHsEHb.mjs

@@ -0,0 +1,188 @@
+import { z } from "zod";
+//#region src/prop-schemas.ts
+/**
+* Devframes-authored per-component prop schemas for the base catalog.
+*
+* Upstream `defineCatalog` collapses a multi-component `propsOf` to
+* `Record<string, unknown>`, so it validates component *names* but not
+* per-component *props*. These schemas are the one validation Devframes
+* adds: element props are parsed against the matching schema at both trust
+* boundaries — spec ingress (server) and render time (client).
+*
+* Each schema validates the types of the documented props and tolerates
+* extra keys (upstream directives like `$bindState` resolve to values at
+* render time), so validation catches genuine authoring mistakes without
+* rejecting valid dynamic expressions.
+*/
+const dynamic = z.looseObject({}).and(z.record(z.string(), z.unknown()));
+function scalar(schema) {
+	return z.union([schema, dynamic]);
+}
+const str = scalar(z.string());
+const num = scalar(z.number());
+const bool = scalar(z.boolean());
+const StackPropsSchema = z.object({
+	direction: z.enum(["row", "column"]).optional(),
+	gap: num.optional(),
+	padding: num.optional(),
+	align: z.enum([
+		"start",
+		"center",
+		"end",
+		"stretch"
+	]).optional(),
+	justify: z.enum([
+		"start",
+		"center",
+		"end",
+		"between",
+		"around"
+	]).optional(),
+	wrap: bool.optional(),
+	flex: scalar(z.union([z.number(), z.string()])).optional()
+});
+const CardPropsSchema = z.object({
+	title: str.optional(),
+	border: bool.optional(),
+	collapsible: bool.optional(),
+	defaultCollapsed: bool.optional(),
+	loading: bool.optional()
+});
+const TextPropsSchema = z.object({
+	text: str.optional(),
+	variant: z.enum([
+		"heading",
+		"subheading",
+		"body",
+		"caption",
+		"code"
+	]).optional(),
+	weight: z.enum([
+		"normal",
+		"medium",
+		"bold"
+	]).optional(),
+	color: z.enum([
+		"base",
+		"muted",
+		"faint",
+		"primary",
+		"success",
+		"warning",
+		"danger"
+	]).optional()
+});
+const BadgePropsSchema = z.object({
+	text: str.optional(),
+	variant: z.enum([
+		"default",
+		"success",
+		"warning",
+		"danger",
+		"info"
+	]).optional(),
+	minWidth: num.optional()
+});
+const ButtonPropsSchema = z.object({
+	label: str.optional(),
+	variant: z.enum([
+		"primary",
+		"secondary",
+		"ghost",
+		"danger"
+	]).optional(),
+	icon: str.optional(),
+	disabled: bool.optional(),
+	loading: bool.optional()
+});
+const IconPropsSchema = z.object({
+	name: str.optional(),
+	size: num.optional()
+});
+const DividerPropsSchema = z.object({ label: str.optional() });
+const TextInputPropsSchema = z.object({
+	value: str.optional(),
+	placeholder: str.optional(),
+	label: str.optional(),
+	disabled: bool.optional(),
+	type: z.enum([
+		"text",
+		"number",
+		"password",
+		"email",
+		"search"
+	]).optional(),
+	loading: bool.optional()
+});
+const SwitchPropsSchema = z.object({
+	value: bool.optional(),
+	label: str.optional(),
+	disabled: bool.optional()
+});
+const KeyValueTablePropsSchema = z.object({
+	data: z.union([z.record(z.string(), z.unknown()), dynamic]).optional(),
+	loading: bool.optional()
+});
+const DataTablePropsSchema = z.object({
+	columns: scalar(z.array(z.union([z.string(), z.looseObject({
+		key: z.string(),
+		label: z.string().optional()
+	})]))).optional(),
+	rows: scalar(z.array(z.unknown())).optional(),
+	height: num.optional(),
+	loading: bool.optional()
+});
+const CodeBlockPropsSchema = z.object({
+	code: str.optional(),
+	language: str.optional(),
+	filename: str.optional(),
+	height: num.optional()
+});
+const ProgressPropsSchema = z.object({
+	value: num.optional(),
+	max: num.optional(),
+	label: str.optional()
+});
+const TreePropsSchema = z.object({
+	data: z.unknown().optional(),
+	defaultExpanded: bool.optional()
+});
+/**
+* Map of base-catalog component name → Zod prop schema. The keys are the
+* canonical component set (catalog v1).
+*/
+const basePropSchemas = {
+	Stack: StackPropsSchema,
+	Card: CardPropsSchema,
+	Text: TextPropsSchema,
+	Badge: BadgePropsSchema,
+	Button: ButtonPropsSchema,
+	Icon: IconPropsSchema,
+	Divider: DividerPropsSchema,
+	TextInput: TextInputPropsSchema,
+	Switch: SwitchPropsSchema,
+	KeyValueTable: KeyValueTablePropsSchema,
+	DataTable: DataTablePropsSchema,
+	CodeBlock: CodeBlockPropsSchema,
+	Progress: ProgressPropsSchema,
+	Tree: TreePropsSchema
+};
+/** The ordered list of base-catalog component names (catalog v1). */
+const baseComponentNames = Object.keys(basePropSchemas);
+//#endregion
+//#region src/view-ref.ts
+/**
+* The `@json-render/core` / `@json-render/vue` version this build of
+* `@devframes/json-render` is written and tested against. It is the sole
+* compatibility signal carried across the wire — there is no separate
+* Devframes protocol/catalog version stamp. A renderer compares its own
+* upstream version against a view's {@link JsonRenderViewRef.upstreamVersion}
+* and warns (rather than blocking) on a mismatch.
+*
+* Kept paired with the caret range on `@json-render/core` /
+* `@json-render/vue` in this package's manifest; the committed lockfile is
+* the guard against a breaking upstream upgrade.
+*/
+const JSON_RENDER_UPSTREAM_VERSION = "0.19.0";
+//#endregion
+export { basePropSchemas as _, CodeBlockPropsSchema as a, IconPropsSchema as c, StackPropsSchema as d, SwitchPropsSchema as f, baseComponentNames as g, TreePropsSchema as h, CardPropsSchema as i, KeyValueTablePropsSchema as l, TextPropsSchema as m, BadgePropsSchema as n, DataTablePropsSchema as o, TextInputPropsSchema as p, ButtonPropsSchema as r, DividerPropsSchema as s, JSON_RENDER_UPSTREAM_VERSION as t, ProgressPropsSchema as u };

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@devframes/json-render",
+  "type": "module",
+  "version": "0.7.5",
+  "description": "Opt-in, framework-neutral JSON-render protocol layer for devframe — spec/catalog types, base catalog, and the node runtime factory.",
+  "author": "Anthony Fu <anthonyfu117@hotmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/devframes/devframe#readme",
+  "repository": {
+    "directory": "packages/json-render",
+    "type": "git",
+    "url": "git+https://github.com/devframes/devframe.git"
+  },
+  "bugs": "https://github.com/devframes/devframe/issues",
+  "keywords": [
+    "devtools",
+    "devframe",
+    "json-render"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./core": "./dist/core.mjs",
+    "./hub": "./dist/hub.mjs",
+    "./node": "./dist/node/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@devframes/hub": "0.7.5",
+    "devframe": "0.7.5"
+  },
+  "peerDependenciesMeta": {
+    "@devframes/hub": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@json-render/core": "^0.19.0",
+    "nostics": "^1.2.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "tsdown": "^0.22.12",
+    "@devframes/hub": "0.7.5",
+    "devframe": "0.7.5"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "watch": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}