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

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,51 @@ 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>>]>>;
+  native: 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 +311,47 @@ 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>>]>>;
+    native: 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 +386,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 +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, 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-CJ8aJJLZ.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 or a native `<select>` fallback."
 };
 /**
-* 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,5 @@
 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 {
@@ -43,12 +42,236 @@ type AnyContext = DevframeNodeContext | DevframeScopedNodeContext<string>;
  */
 declare function createJsonRenderView(ctx: AnyContext, options: CreateJsonRenderViewOptions): JsonRenderView;
 //#endregion
-//#region src/node/diagnostics.d.ts
-interface ReporterOptions {
-  method?: 'log' | 'warn' | 'error';
+//#region ../../node_modules/.pnpm/nostics@1.2.0/node_modules/nostics/dist/diagnostic-wduO7saY.d.mts
+//#region src/utils.d.ts
+/**
+ * A value of type T, or a function that resolves T from a single params object.
+ *
+ * @internal
+ */
+type ValueOrFn<T, P = any> = T | ((params: P) => T);
+/**
+ * Extracts the param type from a single-arg function, or `never` for
+ * non-function inputs. Pairs with {@link ValueOrFn}.
+ *
+ * @internal
+ */
+type ExtractFnParam<T> = T extends ((params: infer P) => any) ? P : never;
+/**
+ * Converts a union of types to their intersection.
+ *
+ * @internal
+ */
+type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
+/**
+ * `true` when `T` is the `any` type.
+ *
+ * @internal
+ */
+type IsAny<Type> = 0 extends 1 & Type ? true : false;
+/**
+ * `true` when `T` is the `unknown` type (and not `any`).
+ *
+ * @internal
+ */
+type IsUnknown<Type> = IsAny<Type> extends true ? false : unknown extends Type ? true : false;
+/**
+ * Expands a type to its property listing so editor hovers show the resolved
+ * shape instead of a chain of aliases / intersections.
+ *
+ * @internal
+ */
+type Prettify<Type> = { [Key in keyof Type]: Type[Key]; };
+//#endregion
+//#region src/diagnostic.d.ts
+/**
+ * Define-time shape of a diagnostic. Each field can be a static value or a
+ * function that resolves it from a shared `params` object passed at call
+ * time. Runtime-only fields (`cause`, `sources`) from {@link DiagnosticInit}
+ * are intentionally omitted: they're only meaningful at the call site.
+ */
+interface DiagnosticDefinition<P = any> {
+  /**
+   * The error message: why this failed. String, or a function of `params`.
+   *
+   * @example
+   * ```ts
+   * why: (p: { name: string }) => `module "${p.name}" failed to load`
+   * ```
+   */
+  why: ValueOrFn<string, P>;
+  /**
+   * Actionable instructions on how to resolve the problem. String, or a
+   * function of `params`.
+   *
+   * @example
+   * ```ts
+   * fix: (p: { name: string }) => `run "npm install ${p.name}"`
+   * ```
+   */
+  fix?: ValueOrFn<string, P>;
+  /**
+   * Per-code docs URL. A string overrides
+   * {@link DefineDiagnosticsOptions.docsBase} for this code; `false` opts this
+   * code out entirely, even when `docsBase` is set. When omitted, the URL is
+   * derived from `docsBase`.
+   */
+  docs?: string | false;
+}
+/**
+ * Runtime-only fields that can be passed alongside the interpolation params
+ * at call time. Merged into the same object so callers pass everything in
+ * one place.
+ */
+interface DiagnosticCallParams {
+  /**
+   * Original error or exception that triggered this diagnostic. Pass it
+   * through when re-throwing so the original stack trace is preserved.
+   */
+  cause?: unknown;
+  /**
+   * Locations in user code that contributed to this diagnostic, in
+   * `file:line:column` format. Useful for compilers and other tools where the
+   * JS stack trace doesn't reflect the user's source.
+   */
+  sources?: string[];
+}
+/**
+ * Structured initializer for a {@link Diagnostic}. `why` is the only required
+ * field: it becomes the {@link Diagnostic.message}. The remaining fields are
+ * optional metadata that reporters and consumers can render or forward.
+ */
+interface DiagnosticInit extends DiagnosticCallParams {
+  /**
+   * The diagnostic code, e.g. `MATH_E001`. Appear as {@link Diagnostic.name}.
+   */
+  code: string;
+  /**
+   * The actual error message: why this failed.
+   * Mirrored to `Error.message`.
+   */
+  why: string;
+  /**
+   * Optional actionable instructions on how to resolve the problem.
+   */
+  fix?: string;
+  /**
+   * URL to extended documentation for this diagnostic.
+   */
+  docs?: string;
 }
-declare function jsonRenderReporter(d: Diagnostic, { method }?: ReporterOptions): void;
-declare const diagnostics: import("nostics").Diagnostics<{
+/**
+ * Permissive reporter constraint used internally so reporters with 1 arg,
+ * required options, or optional options all satisfy the array constraint.
+ *
+ * @internal
+ */
+type AnyDiagnosticReporter = (diagnostic: Diagnostic, options: any) => void;
+/**
+ * Resolves the `params` type a code expects from the intersection of params
+ * across all function-typed fields, falling back to `{}` when every field is
+ * static. Merged with {@link DiagnosticCallParams} at the call site.
+ *
+ * @internal
+ */
+type InferCodeParams<Def> = [ExtractFnParam<Def[keyof Def]>] extends [never] ? {} : UnionToIntersection<ExtractFnParam<Def[keyof Def]>>;
+/**
+ * The first positional argument of a {@link DiagnosticHandle} call:
+ * interpolation params merged with the runtime-only call-site fields
+ * (`cause`, `sources`).
+ *
+ * @internal
+ */
+type CallSiteParams<Params> = Params & DiagnosticCallParams;
+/**
+ * Resolves the full argument tuple for a {@link DiagnosticHandle} call.
+ * Branches on whether params and reporter options each have required fields.
+ * Required positions become required tuple elements, all-optional ones
+ * become `?`, and when no reporter declares any options the parameter is
+ * omitted entirely.
+ *
+ * @internal
+ */
+type ActionArgs<Params, ReporterOpts> = keyof ReporterOpts extends never ? {} extends Params ? [params?: CallSiteParams<Params>] : [params: CallSiteParams<Params>] : {} extends ReporterOpts ? {} extends Params ? [params?: CallSiteParams<Params>, reporterOptions?: ReporterOpts] : [params: CallSiteParams<Params>, reporterOptions?: ReporterOpts] : {} extends Params ? [params: CallSiteParams<Params> | undefined, reporterOptions: ReporterOpts] : [params: CallSiteParams<Params>, reporterOptions: ReporterOpts];
+/**
+ * Per-code handle exposed by {@link defineDiagnostics}. Each code is a
+ * callable: invoke it to build the diagnostic and run every reporter, or
+ * prefix the call with `throw` to raise it.
+ *
+ * @example
+ * ```ts
+ * diagnostics.MATH_E001({ name: 'x' })           // report
+ * throw diagnostics.MATH_E001({ name: 'x' })     // throw
+ * ```
+ */
+interface DiagnosticHandle<Params, ReporterOpts> {
+  /**
+   * Builds the diagnostic, runs every reporter, and returns the diagnostic
+   * instance. The returned diagnostic can be inspected, attached as `cause`,
+   * or thrown with `throw`.
+   */
+  (...args: ActionArgs<Params, ReporterOpts>): Diagnostic;
+}
+/**
+ * Return type of {@link defineDiagnostics}.
+ */
+type Diagnostics<Codes extends Record<string, DiagnosticDefinition>, Reporters extends readonly AnyDiagnosticReporter[]> = { [Code in keyof Codes]: DiagnosticHandle<InferCodeParams<Codes[Code]>, Prettify<ExtractReportersOptions<Reporters>>>; };
+declare class Diagnostic extends Error {
+  name: string;
+  /**
+   * The diagnostic code, e.g. `MATH_E001`.
+   * Also appears as the `name` property.
+   */
+  code: string;
+  /**
+   * URL to extended documentation for this diagnostic code.
+   * Auto-generated from {@link DefineDiagnosticsOptions.docsBase}.
+   */
+  docs?: string;
+  /**
+   * Optional actionable instructions on how to resolve the problem.
+   */
+  fix?: string;
+  /**
+   * Locations in user code that contributed to this diagnostic, in
+   * `file:line:column` format. Relevant when the stack trace doesn't reflect
+   * the user's source (e.g. compilers, bundlers), otherwise redundant with the
+   * stack and should be omitted.
+   */
+  sources?: string[];
+  /**
+   * Alias for {@link Error.message}: the reason this diagnostic was raised.
+   */
+  get why(): string;
+  /**
+   * @param init        structured initializer; `why` is required
+   * @param captureFrom V8 stack-cutoff frame. Defaults to {@link Diagnostic}
+   * so the top of the trace is the `new Diagnostic(...)` call site.
+   * `defineDiagnostics` passes its action method to strip its own frames too.
+   * Ignored on engines without `Error.captureStackTrace`.
+   */
+  constructor(init: DiagnosticInit, captureFrom?: Function);
+  /**
+   * Converts the diagnostic into a serializable structured object.
+   */
+  toJSON(): object;
+}
+/**
+ * Extracts the options object a reporter accepts as its 2nd argument. Returns
+ * `{}` when the reporter has no 2nd arg (so it contributes nothing to the
+ * merged shape).
+ */
+type ExtractSingleReporterOptions<Reporter> = Reporter extends ((diagnostic: Diagnostic, options: infer ReporterOpts) => any) ? IsUnknown<ReporterOpts> extends true ? {} : Exclude<ReporterOpts, undefined> : {};
+/**
+ * Intersects every reporter's options shape into a single object. If any
+ * reporter has a required field, the merged shape has a required field, and
+ * {@link ActionArgs} flips `reporterOptions` from optional to required via
+ * `{} extends Merged`.
+ */
+type ExtractReportersOptions<Reporters extends readonly any[]> = Reporters extends readonly [infer First, ...infer Rest] ? ExtractSingleReporterOptions<First> & ExtractReportersOptions<Rest> : {};
+//#endregion
+//#region src/node/diagnostics.d.ts
+declare const diagnostics: Diagnostics<{
   readonly DF0038: {
     readonly why: (p: {
       id: string;
@@ -77,6 +300,8 @@ declare const diagnostics: import("nostics").Diagnostics<{
     }) => string;
     readonly fix: "Specs and state travel as strict JSON — remove functions, symbols, class instances, Map/Set, or circular references.";
   };
-}, readonly [typeof jsonRenderReporter]>;
+}, readonly [(d: Diagnostic, { method }?: {
+  method?: "log" | "warn" | "error";
+}) => void]>;
 //#endregion
 export { type CreateJsonRenderViewOptions, createJsonRenderView, diagnostics as jsonRenderDiagnostics };

package/dist/node/index.mjs

@@ -1,16 +1,9 @@
-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-CJ8aJJLZ.mjs";
 import { createSharedState } from "devframe/utils/shared-state";
-import { colors } from "devframe/utils/colors";
-import { defineDiagnostics } from "nostics";
-import { ansiFormatter } from "nostics/formatters/ansi";
+import { defineDiagnostics } from "devframe/utils/nostics";
 //#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}`,

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

@@ -147,9 +147,48 @@ 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(),
+	native: 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 +204,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 +225,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.10",
+  "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.10",
+    "devframe": "0.9.0-beta.10"
   },
   "peerDependenciesMeta": {
     "@devframes/hub": {
@@ -40,14 +40,13 @@
   },
   "dependencies": {
     "@json-render/core": "^0.19.0",
-    "nostics": "^1.2.0",
     "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"
+    "devframe": "0.9.0-beta.10",
+    "@devframes/hub": "0.9.0-beta.10"
   },
   "scripts": {
     "build": "tsdown",