@devframes/json-render 0.7.8 → 0.7.10

package/dist/hub.d.mts

@@ -1,4 +1,4 @@
-import { i as JsonRenderViewRef, n as JsonRenderView } from "./types-DafC9dUn.mjs";
+import { i as JsonRenderViewRef, n as JsonRenderView } from "./types-Di-9QrXX.mjs";
 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 { i as JsonRenderViewRef, n as JsonRenderView, r as JSON_RENDER_UPSTREAM_VERSION, t as DevframeJsonRenderSpec } from "./types-DafC9dUn.mjs";
+import { i as JsonRenderViewRef, n as JsonRenderView, r as JSON_RENDER_UPSTREAM_VERSION, t as DevframeJsonRenderSpec } from "./types-Di-9QrXX.mjs";
 import { z } from "zod";
 //#region src/prop-schemas.d.ts
 declare const StackPropsSchema: z.ZodObject<{
@@ -334,4 +334,36 @@ declare const baseCatalog: import("@json-render/core").Catalog<{
   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 };
+//#region src/view-index.d.ts
+/**
+ * Well-known shared-state key carrying the **view index**: a map of every
+ * live JSON-render view registered on a context, keyed by its `stateKey`.
+ *
+ * A frontend that does not know view ids ahead of time (e.g. the prebuilt
+ * standalone SPA in `@devframes/json-render-ui`) subscribes to this one key to
+ * discover which views exist, then subscribes to each view's own state. A hub
+ * dock, by contrast, is handed a specific {@link JsonRenderViewRef} and needs
+ * no index.
+ */
+declare const JSON_RENDER_INDEX_KEY = "devframe:json-render:index";
+/**
+ * One entry in the {@link JSON_RENDER_INDEX_KEY view index}. Fully
+ * serializable: it locates a view's live state and carries the display title a
+ * multi-view frontend uses to label it.
+ */
+interface JsonRenderIndexEntry {
+  /** Author-supplied stable id, unique within the view's scope. */
+  id: string;
+  /** The view's scope segment (e.g. `global` or a context namespace). */
+  scope: string;
+  /** Shared-state key the client subscribes to for the live spec + state. */
+  stateKey: string;
+  /** Human-facing label for the view (defaults to `id`). */
+  title: string;
+  /** Upstream `@json-render/*` version the view was authored against. */
+  upstreamVersion: string;
+}
+/** 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, JSON_RENDER_UPSTREAM_VERSION, type JsonRenderIndex, type JsonRenderIndexEntry, 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

@@ -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_UPSTREAM_VERSION, u as ProgressPropsSchema } from "./view-ref-70LHsEHb.mjs";
+import { _ as baseComponentNames, a as CardPropsSchema, c as DividerPropsSchema, d as ProgressPropsSchema, f as StackPropsSchema, g as TreePropsSchema, h as TextPropsSchema, i as ButtonPropsSchema, l as IconPropsSchema, m as TextInputPropsSchema, n as JSON_RENDER_INDEX_KEY, o as CodeBlockPropsSchema, p as SwitchPropsSchema, r as BadgePropsSchema, s as DataTablePropsSchema, t as JSON_RENDER_UPSTREAM_VERSION, u as KeyValueTablePropsSchema, v as basePropSchemas } from "./view-ref-B_nBPfeR.mjs";
 import { defineCatalog, defineSchema } from "@json-render/core";
 //#region src/catalog.ts
 /**
@@ -55,4 +55,4 @@ const baseCatalog = defineCatalog(baseSchema, {
 	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 };
+export { BadgePropsSchema, ButtonPropsSchema, CardPropsSchema, CodeBlockPropsSchema, DataTablePropsSchema, DividerPropsSchema, IconPropsSchema, JSON_RENDER_INDEX_KEY, JSON_RENDER_UPSTREAM_VERSION, KeyValueTablePropsSchema, ProgressPropsSchema, StackPropsSchema, SwitchPropsSchema, TextInputPropsSchema, TextPropsSchema, TreePropsSchema, baseCatalog, baseComponentNames, basePropSchemas, baseSchema };

package/dist/node/index.d.mts

@@ -1,4 +1,4 @@
-import { n as JsonRenderView, t as DevframeJsonRenderSpec } from "../types-DafC9dUn.mjs";
+import { n as JsonRenderView, t as DevframeJsonRenderSpec } from "../types-Di-9QrXX.mjs";
 import { Diagnostic } from "nostics";
 import { DevframeNodeContext, DevframeScopedNodeContext } from "devframe/types";
 //#region src/node/create-view.d.ts
@@ -18,6 +18,12 @@ interface CreateJsonRenderViewOptions {
    * `'global'`.
    */
   scope?: string;
+  /**
+   * Human-facing label published in the view index and used by a multi-view
+   * frontend (e.g. the standalone SPA's view switcher) to name this view.
+   * Defaults to {@link CreateJsonRenderViewOptions.id}.
+   */
+  title?: string;
 }
 type AnyContext = DevframeNodeContext | DevframeScopedNodeContext<string>;
 /**

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-import { _ as basePropSchemas, t as JSON_RENDER_UPSTREAM_VERSION } from "../view-ref-70LHsEHb.mjs";
+import { n as JSON_RENDER_INDEX_KEY, t as JSON_RENDER_UPSTREAM_VERSION, v as basePropSchemas } from "../view-ref-B_nBPfeR.mjs";
 import { createSharedState } from "devframe/utils/shared-state";
 import { colors } from "devframe/utils/colors";
 import { defineDiagnostics } from "nostics";
@@ -44,6 +44,16 @@ function registryFor(ctx) {
 	}
 	return set;
 }
+const indexStates = /* @__PURE__ */ new WeakMap();
+function indexStateFor(ctx) {
+	let state = indexStates.get(ctx);
+	if (!state) {
+		state = createSharedState({ initialValue: {} });
+		indexStates.set(ctx, state);
+		ctx.rpc.sharedState.get(JSON_RENDER_INDEX_KEY, { sharedState: state });
+	}
+	return state;
+}
 /** Parse an RFC 6901 JSON Pointer into path segments. */
 function parsePointer(pointer) {
 	if (pointer === "" || pointer === "/") return [];
@@ -100,6 +110,7 @@ function createJsonRenderView(ctx, options) {
 	const baseCtx = scoped ? ctx.base : ctx;
 	const scope = options.scope ?? (scoped ? ctx.namespace : "global");
 	const { id } = options;
+	const title = options.title ?? id;
 	const stateKey = `devframe:json-render:${scope}:${id}`;
 	const registry = registryFor(baseCtx);
 	if (registry.has(stateKey)) throw diagnostics.DF0039({
@@ -115,12 +126,23 @@ function createJsonRenderView(ctx, options) {
 	});
 	registry.add(stateKey);
 	baseCtx.rpc.sharedState.get(stateKey, { sharedState: state });
+	const index = indexStateFor(baseCtx);
+	index.mutate((idx) => {
+		idx[stateKey] = {
+			id,
+			scope,
+			stateKey,
+			title,
+			upstreamVersion: JSON_RENDER_UPSTREAM_VERSION
+		};
+	});
 	let disposed = false;
 	function assertLive() {
 		if (disposed) throw diagnostics.DF0040({ id });
 	}
 	return {
 		id,
+		title,
 		ref: {
 			stateKey,
 			upstreamVersion: JSON_RENDER_UPSTREAM_VERSION
@@ -146,6 +168,9 @@ function createJsonRenderView(ctx, options) {
 			if (disposed) return;
 			disposed = true;
 			registry.delete(stateKey);
+			index.mutate((idx) => {
+				delete idx[stateKey];
+			});
 			baseCtx.rpc.sharedState.delete(stateKey);
 		}
 	};

package/dist/{types-DafC9dUn.d.mts → types-Di-9QrXX.d.mts}

@@ -59,6 +59,8 @@ interface JsonRenderStatePatch {
 interface JsonRenderView {
   /** Author-supplied stable id, unique within the view's scope. */
   readonly id: string;
+  /** Human-facing label published in the view index (defaults to `id`). */
+  readonly title: string;
   /** The serializable reference clients subscribe through. */
   readonly ref: JsonRenderViewRef;
   /** Replace the entire spec (a structural change replaces the whole spec). */

package/dist/{view-ref-70LHsEHb.mjs → view-ref-B_nBPfeR.mjs}

@@ -170,6 +170,19 @@ const basePropSchemas = {
 /** The ordered list of base-catalog component names (catalog v1). */
 const baseComponentNames = Object.keys(basePropSchemas);
 //#endregion
+//#region src/view-index.ts
+/**
+* Well-known shared-state key carrying the **view index**: a map of every
+* live JSON-render view registered on a context, keyed by its `stateKey`.
+*
+* A frontend that does not know view ids ahead of time (e.g. the prebuilt
+* standalone SPA in `@devframes/json-render-ui`) subscribes to this one key to
+* discover which views exist, then subscribes to each view's own state. A hub
+* dock, by contrast, is handed a specific {@link JsonRenderViewRef} and needs
+* no index.
+*/
+const JSON_RENDER_INDEX_KEY = "devframe:json-render:index";
+//#endregion
 //#region src/view-ref.ts
 /**
 * The `@json-render/core` / `@json-render/vue` version this build of
@@ -185,4 +198,4 @@ const baseComponentNames = Object.keys(basePropSchemas);
 */
 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 };
+export { baseComponentNames as _, CardPropsSchema as a, DividerPropsSchema as c, ProgressPropsSchema as d, StackPropsSchema as f, TreePropsSchema as g, TextPropsSchema as h, ButtonPropsSchema as i, IconPropsSchema as l, TextInputPropsSchema as m, JSON_RENDER_INDEX_KEY as n, CodeBlockPropsSchema as o, SwitchPropsSchema as p, BadgePropsSchema as r, DataTablePropsSchema as s, JSON_RENDER_UPSTREAM_VERSION as t, KeyValueTablePropsSchema as u, basePropSchemas as v };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/json-render",
   "type": "module",
-  "version": "0.7.8",
+  "version": "0.7.10",
   "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",
@@ -30,8 +30,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/hub": "0.7.8",
-    "devframe": "0.7.8"
+    "@devframes/hub": "0.7.10",
+    "devframe": "0.7.10"
   },
   "peerDependenciesMeta": {
     "@devframes/hub": {
@@ -46,8 +46,8 @@
   "devDependencies": {
     "@types/node": "^26.1.1",
     "tsdown": "^0.22.12",
-    "@devframes/hub": "0.7.8",
-    "devframe": "0.7.8"
+    "@devframes/hub": "0.7.10",
+    "devframe": "0.7.10"
   },
   "scripts": {
     "build": "tsdown",