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

package/dist/index.d.mts

@@ -172,6 +172,7 @@ declare const SelectPropsSchema: z.ZodObject<{
   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
@@ -349,6 +350,7 @@ declare const basePropSchemas: {
     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. */

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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 { _ 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
 /**
@@ -42,7 +42,7 @@ const componentDescriptions = {
 	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."
+	Select: "Single-select dropdown bound to a state value, with optional search or a native `<select>` fallback."
 };
 /**
 * The Devframes base catalog (catalog v1): the seventeen canonical components

package/dist/node/index.d.mts

@@ -1,5 +1,4 @@
 import { n as JsonRenderView, t as DevframeJsonRenderSpec } from "../types-CC2-FD2H.mjs";
-import { Diagnostic } from "nostics";
 import { DevframeNodeContext, DevframeScopedNodeContext } from "devframe";
 //#region src/node/create-view.d.ts
 /** Options for {@link createJsonRenderView}. */
@@ -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 { b as basePropSchemas, t as JSON_RENDER_INDEX_KEY } from "../view-index-CUg7TaB4.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-CUg7TaB4.mjs → view-index-CJ8aJJLZ.mjs}

@@ -182,7 +182,8 @@ const SelectPropsSchema = z.object({
 	placeholder: str.optional(),
 	label: str.optional(),
 	disabled: bool.optional(),
-	searchable: bool.optional()
+	searchable: bool.optional(),
+	native: bool.optional()
 });
 /**
 * Map of base-catalog component name → Zod prop schema. The keys are the

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/json-render",
   "type": "module",
-  "version": "0.9.0-beta.1",
+  "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",
@@ -30,8 +30,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/hub": "0.9.0-beta.1",
-    "devframe": "0.9.0-beta.1"
+    "@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.2.0",
     "tsdown": "^0.22.14",
-    "@devframes/hub": "0.9.0-beta.1",
-    "devframe": "0.9.0-beta.1"
+    "devframe": "0.9.0-beta.10",
+    "@devframes/hub": "0.9.0-beta.10"
   },
   "scripts": {
     "build": "tsdown",