@devframes/json-render 0.8.2 → 0.9.0-beta.2

package/dist/hub.d.mts

@@ -1,4 +1,5 @@
 import { i as JsonRenderViewRef, n as JsonRenderView } from "./types-CC2-FD2H.mjs";
+import { DockRenderer, DockRendererMountOptions } from "@devframes/hub/client";
 import { DevframeDockEntryBase } from "@devframes/hub/types";
 //#region src/hub.d.ts
 /**
@@ -17,6 +18,23 @@ declare module '@devframes/hub/types' {
     'json-render': DevframeJsonRenderDockEntry;
   }
 }
+/**
+ * The mount options a hub viewer hands a json-render dock renderer — the
+ * hub's `DockRendererMountOptions` narrowed to the `'json-render'` entry.
+ * This protocol package owns the renderer contract so every frontend —
+ * `@devframes/json-render-ui`, a community renderer, a host page's own —
+ * implements one shared shape instead of re-declaring it.
+ */
+type JsonRenderDockMountOptions = DockRendererMountOptions<DevframeJsonRenderDockEntry>;
+/**
+ * The renderer contract for `'json-render'` docks: a hub `DockRenderer`
+ * narrowed to {@link DevframeJsonRenderDockEntry}. Implement it to replace
+ * the reference frontend — register the implementation locally
+ * (`createDevframeClientHost({ renderers })`) or ship it as a prebuilt
+ * module registered through the hub's renderer manifest
+ * (`initHub({ renderers })`).
+ */
+type JsonRenderDockRenderer = DockRenderer<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
@@ -24,4 +42,4 @@ declare module '@devframes/hub/types' {
  */
 declare function toJsonRenderDockEntry(view: JsonRenderView, meta: Omit<DevframeJsonRenderDockEntry, 'type' | 'view'>): DevframeJsonRenderDockEntry;
 //#endregion
-export { DevframeJsonRenderDockEntry, toJsonRenderDockEntry };
+export { DevframeJsonRenderDockEntry, JsonRenderDockMountOptions, JsonRenderDockRenderer, toJsonRenderDockEntry };

package/dist/index.d.mts

@@ -133,9 +133,50 @@ 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>;
+declare const TabsPropsSchema: z.ZodObject<{
+  tabs: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+    value: z.ZodString;
+    label: z.ZodString;
+    icon: z.ZodOptional<z.ZodString>;
+    badge: z.ZodOptional<z.ZodString>;
+    badgeVariant: z.ZodOptional<z.ZodEnum<{
+      success: "success";
+      default: "default";
+      warning: "warning";
+      danger: "danger";
+      info: "info";
+    }>>;
+  }, z.core.$loose>>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  orientation: z.ZodOptional<z.ZodEnum<{
+    horizontal: "horizontal";
+    vertical: "vertical";
+  }>>;
+}, z.core.$strip>;
+declare const LinkPropsSchema: z.ZodObject<{
+  href: 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>>]>>;
+  icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  external: 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 SelectPropsSchema: z.ZodObject<{
+  value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  options: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    value: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+  }, z.core.$loose>]>>, 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>>]>>;
+  searchable: 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).
+ * canonical component set (catalog v1: the original fourteen plus the
+ * additive Tabs/Link/Select).
  */
 declare const basePropSchemas: {
   readonly Stack: z.ZodObject<{
@@ -269,6 +310,46 @@ declare const basePropSchemas: {
     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>;
+  readonly Tabs: z.ZodObject<{
+    tabs: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+      value: z.ZodString;
+      label: z.ZodString;
+      icon: z.ZodOptional<z.ZodString>;
+      badge: z.ZodOptional<z.ZodString>;
+      badgeVariant: z.ZodOptional<z.ZodEnum<{
+        success: "success";
+        default: "default";
+        warning: "warning";
+        danger: "danger";
+        info: "info";
+      }>>;
+    }, z.core.$loose>>, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    defaultValue: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    orientation: z.ZodOptional<z.ZodEnum<{
+      horizontal: "horizontal";
+      vertical: "vertical";
+    }>>;
+  }, z.core.$strip>;
+  readonly Link: z.ZodObject<{
+    href: 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>>]>>;
+    icon: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    external: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+  }, z.core.$strip>;
+  readonly Select: z.ZodObject<{
+    value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodIntersection<z.ZodObject<{}, z.core.$loose>, z.ZodRecord<z.ZodString, z.ZodUnknown>>]>>;
+    options: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      value: z.ZodString;
+      label: z.ZodOptional<z.ZodString>;
+      icon: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>]>>, 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>>]>>;
+    searchable: 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;
@@ -303,7 +384,7 @@ declare const baseSchema: import("@json-render/core").Schema<{
   }>;
 }>;
 /**
- * The Devframes base catalog (catalog v1): the fourteen canonical components
+ * The Devframes base catalog (catalog v1): the seventeen 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.
@@ -364,4 +445,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, ProgressPropsSchema, type Spec, StackPropsSchema, type StateModel, type StateStore, SwitchPropsSchema, TextInputPropsSchema, TextPropsSchema, TreePropsSchema, type UIElement, baseCatalog, baseComponentNames, basePropSchemas, baseSchema };
+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 };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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_INDEX_KEY, u as ProgressPropsSchema } from "./view-index-BItK4ftT.mjs";
+import { _ as TextPropsSchema, a as CodeBlockPropsSchema, b as basePropSchemas, c as IconPropsSchema, d as ProgressPropsSchema, f as SelectPropsSchema, g as TextInputPropsSchema, h as TabsPropsSchema, i as CardPropsSchema, l as KeyValueTablePropsSchema, m as SwitchPropsSchema, n as BadgePropsSchema, o as DataTablePropsSchema, p as StackPropsSchema, r as ButtonPropsSchema, s as DividerPropsSchema, t as JSON_RENDER_INDEX_KEY, u as LinkPropsSchema, v as TreePropsSchema, y as baseComponentNames } from "./view-index-CUg7TaB4.mjs";
 import { defineCatalog, defineSchema } from "@json-render/core";
 //#region src/catalog.ts
 /**
@@ -39,10 +39,13 @@ const componentDescriptions = {
 	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."
+	Tree: "Recursive object/array viewer with expandable nodes.",
+	Tabs: "Tabbed container; each child renders under the positionally-matching tab.",
+	Link: "Hyperlink to a safe-scheme URL with an optional icon.",
+	Select: "Single-select dropdown bound to a state value, with optional search."
 };
 /**
-* The Devframes base catalog (catalog v1): the fourteen canonical components
+* The Devframes base catalog (catalog v1): the seventeen 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.
@@ -55,4 +58,4 @@ const baseCatalog = defineCatalog(baseSchema, {
 	actions: {}
 });
 //#endregion
-export { BadgePropsSchema, ButtonPropsSchema, CardPropsSchema, CodeBlockPropsSchema, DataTablePropsSchema, DividerPropsSchema, IconPropsSchema, JSON_RENDER_INDEX_KEY, KeyValueTablePropsSchema, ProgressPropsSchema, StackPropsSchema, SwitchPropsSchema, TextInputPropsSchema, TextPropsSchema, TreePropsSchema, baseCatalog, baseComponentNames, basePropSchemas, baseSchema };
+export { BadgePropsSchema, ButtonPropsSchema, CardPropsSchema, CodeBlockPropsSchema, DataTablePropsSchema, DividerPropsSchema, IconPropsSchema, JSON_RENDER_INDEX_KEY, KeyValueTablePropsSchema, LinkPropsSchema, ProgressPropsSchema, SelectPropsSchema, StackPropsSchema, SwitchPropsSchema, TabsPropsSchema, TextInputPropsSchema, TextPropsSchema, TreePropsSchema, baseCatalog, baseComponentNames, basePropSchemas, baseSchema };

package/dist/node/index.d.mts

@@ -1,6 +1,6 @@
 import { n as JsonRenderView, t as DevframeJsonRenderSpec } from "../types-CC2-FD2H.mjs";
 import { Diagnostic } from "nostics";
-import { DevframeNodeContext, DevframeScopedNodeContext } from "devframe/types";
+import { DevframeNodeContext, DevframeScopedNodeContext } from "devframe";
 //#region src/node/create-view.d.ts
 /** Options for {@link createJsonRenderView}. */
 interface CreateJsonRenderViewOptions {

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-import { _ as basePropSchemas, t as JSON_RENDER_INDEX_KEY } from "../view-index-BItK4ftT.mjs";
+import { b as basePropSchemas, t as JSON_RENDER_INDEX_KEY } from "../view-index-CUg7TaB4.mjs";
 import { createSharedState } from "devframe/utils/shared-state";
 import { colors } from "devframe/utils/colors";
 import { defineDiagnostics } from "nostics";

package/dist/{view-index-BItK4ftT.mjs → view-index-CUg7TaB4.mjs}

@@ -147,9 +147,47 @@ const TreePropsSchema = z.object({
 	data: z.unknown().optional(),
 	defaultExpanded: bool.optional()
 });
+const TabsPropsSchema = z.object({
+	tabs: scalar(z.array(z.looseObject({
+		value: z.string(),
+		label: z.string(),
+		icon: z.string().optional(),
+		badge: z.string().optional(),
+		badgeVariant: z.enum([
+			"default",
+			"info",
+			"success",
+			"warning",
+			"danger"
+		]).optional()
+	}))).optional(),
+	value: str.optional(),
+	defaultValue: str.optional(),
+	orientation: z.enum(["horizontal", "vertical"]).optional()
+});
+const LinkPropsSchema = z.object({
+	href: str.optional(),
+	label: str.optional(),
+	icon: str.optional(),
+	external: bool.optional()
+});
+const SelectPropsSchema = z.object({
+	value: str.optional(),
+	options: scalar(z.array(z.union([z.string(), z.looseObject({
+		value: z.string(),
+		label: z.string().optional(),
+		icon: z.string().optional(),
+		description: z.string().optional()
+	})]))).optional(),
+	placeholder: str.optional(),
+	label: str.optional(),
+	disabled: bool.optional(),
+	searchable: bool.optional()
+});
 /**
 * Map of base-catalog component name → Zod prop schema. The keys are the
-* canonical component set (catalog v1).
+* canonical component set (catalog v1: the original fourteen plus the
+* additive Tabs/Link/Select).
 */
 const basePropSchemas = {
 	Stack: StackPropsSchema,
@@ -165,7 +203,10 @@ const basePropSchemas = {
 	DataTable: DataTablePropsSchema,
 	CodeBlock: CodeBlockPropsSchema,
 	Progress: ProgressPropsSchema,
-	Tree: TreePropsSchema
+	Tree: TreePropsSchema,
+	Tabs: TabsPropsSchema,
+	Link: LinkPropsSchema,
+	Select: SelectPropsSchema
 };
 /** The ordered list of base-catalog component names (catalog v1). */
 const baseComponentNames = Object.keys(basePropSchemas);
@@ -183,4 +224,4 @@ const baseComponentNames = Object.keys(basePropSchemas);
 */
 const JSON_RENDER_INDEX_KEY = "devframe:json-render:index";
 //#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_INDEX_KEY as t, ProgressPropsSchema as u };
+export { TextPropsSchema as _, CodeBlockPropsSchema as a, basePropSchemas as b, IconPropsSchema as c, ProgressPropsSchema as d, SelectPropsSchema as f, TextInputPropsSchema as g, TabsPropsSchema as h, CardPropsSchema as i, KeyValueTablePropsSchema as l, SwitchPropsSchema as m, BadgePropsSchema as n, DataTablePropsSchema as o, StackPropsSchema as p, ButtonPropsSchema as r, DividerPropsSchema as s, JSON_RENDER_INDEX_KEY as t, LinkPropsSchema as u, TreePropsSchema as v, baseComponentNames as y };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@devframes/json-render",
   "type": "module",
-  "version": "0.8.2",
-  "description": "Opt-in, framework-neutral JSON-render protocol layer for devframe — spec/catalog types, base catalog, and the node runtime factory.",
+  "version": "0.9.0-beta.2",
+  "description": "Protocol layer for describing devframe views as JSON that any renderer can display.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
   "homepage": "https://github.com/devframes/devframe#readme",
@@ -30,8 +30,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/hub": "0.8.2",
-    "devframe": "0.8.2"
+    "@devframes/hub": "0.9.0-beta.2",
+    "devframe": "0.9.0-beta.2"
   },
   "peerDependenciesMeta": {
     "@devframes/hub": {
@@ -44,10 +44,10 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^26.1.2",
+    "@types/node": "^26.2.0",
     "tsdown": "^0.22.14",
-    "@devframes/hub": "0.8.2",
-    "devframe": "0.8.2"
+    "@devframes/hub": "0.9.0-beta.2",
+    "devframe": "0.9.0-beta.2"
   },
   "scripts": {
     "build": "tsdown",