@json-render/react 0.2.0 → 0.4.0

package/dist/schema.d.mts

@@ -0,0 +1,106 @@
+import * as _json_render_core from '@json-render/core';
+
+/**
+ * The schema for @json-render/react
+ *
+ * Defines:
+ * - Spec: A flat tree of elements with keys, types, props, and children references
+ * - Catalog: Components with props schemas, and optional actions
+ */
+declare const schema: _json_render_core.Schema<{
+    spec: _json_render_core.SchemaType<"object", {
+        /** Root element key */
+        root: _json_render_core.SchemaType<"string", unknown>;
+        /** Flat map of elements by key */
+        elements: _json_render_core.SchemaType<"record", _json_render_core.SchemaType<"object", {
+            /** Unique key for this element */
+            key: _json_render_core.SchemaType<"string", unknown>;
+            /** Component type from catalog */
+            type: _json_render_core.SchemaType<"ref", string>;
+            /** Component props */
+            props: _json_render_core.SchemaType<"propsOf", string>;
+            /** Child element keys (flat reference) */
+            children: _json_render_core.SchemaType<"array", _json_render_core.SchemaType<"string", unknown>>;
+            /** Parent element key (null for root) */
+            parentKey: _json_render_core.SchemaType<"string", unknown>;
+            /** Visibility condition */
+            visible: _json_render_core.SchemaType<"any", unknown>;
+        }>>;
+    }>;
+    catalog: _json_render_core.SchemaType<"object", {
+        /** Component definitions */
+        components: _json_render_core.SchemaType<"map", {
+            /** Zod schema for component props */
+            props: _json_render_core.SchemaType<"zod", unknown>;
+            /** Slots for this component. Use ['default'] for children, or named slots like ['header', 'footer'] */
+            slots: _json_render_core.SchemaType<"array", _json_render_core.SchemaType<"string", unknown>>;
+            /** Description for AI generation hints */
+            description: _json_render_core.SchemaType<"string", unknown>;
+        }>;
+        /** Action definitions (optional) */
+        actions: _json_render_core.SchemaType<"map", {
+            /** Zod schema for action params */
+            params: _json_render_core.SchemaType<"zod", unknown>;
+            /** Description for AI generation hints */
+            description: _json_render_core.SchemaType<"string", unknown>;
+        }>;
+    }>;
+}>;
+/**
+ * Type for the React schema
+ */
+type ReactSchema = typeof schema;
+/**
+ * Infer the spec type from a catalog
+ */
+type ReactSpec<TCatalog> = typeof schema extends {
+    createCatalog: (catalog: TCatalog) => {
+        _specType: infer S;
+    };
+} ? S : never;
+/** @deprecated Use `schema` instead */
+declare const elementTreeSchema: _json_render_core.Schema<{
+    spec: _json_render_core.SchemaType<"object", {
+        /** Root element key */
+        root: _json_render_core.SchemaType<"string", unknown>;
+        /** Flat map of elements by key */
+        elements: _json_render_core.SchemaType<"record", _json_render_core.SchemaType<"object", {
+            /** Unique key for this element */
+            key: _json_render_core.SchemaType<"string", unknown>;
+            /** Component type from catalog */
+            type: _json_render_core.SchemaType<"ref", string>;
+            /** Component props */
+            props: _json_render_core.SchemaType<"propsOf", string>;
+            /** Child element keys (flat reference) */
+            children: _json_render_core.SchemaType<"array", _json_render_core.SchemaType<"string", unknown>>;
+            /** Parent element key (null for root) */
+            parentKey: _json_render_core.SchemaType<"string", unknown>;
+            /** Visibility condition */
+            visible: _json_render_core.SchemaType<"any", unknown>;
+        }>>;
+    }>;
+    catalog: _json_render_core.SchemaType<"object", {
+        /** Component definitions */
+        components: _json_render_core.SchemaType<"map", {
+            /** Zod schema for component props */
+            props: _json_render_core.SchemaType<"zod", unknown>;
+            /** Slots for this component. Use ['default'] for children, or named slots like ['header', 'footer'] */
+            slots: _json_render_core.SchemaType<"array", _json_render_core.SchemaType<"string", unknown>>;
+            /** Description for AI generation hints */
+            description: _json_render_core.SchemaType<"string", unknown>;
+        }>;
+        /** Action definitions (optional) */
+        actions: _json_render_core.SchemaType<"map", {
+            /** Zod schema for action params */
+            params: _json_render_core.SchemaType<"zod", unknown>;
+            /** Description for AI generation hints */
+            description: _json_render_core.SchemaType<"string", unknown>;
+        }>;
+    }>;
+}>;
+/** @deprecated Use `ReactSchema` instead */
+type ElementTreeSchema = ReactSchema;
+/** @deprecated Use `ReactSpec` instead */
+type ElementTreeSpec<T> = ReactSpec<T>;
+
+export { type ElementTreeSchema, type ElementTreeSpec, type ReactSchema, type ReactSpec, elementTreeSchema, schema };

package/dist/schema.d.ts

@@ -0,0 +1,106 @@
+import * as _json_render_core from '@json-render/core';
+
+/**
+ * The schema for @json-render/react
+ *
+ * Defines:
+ * - Spec: A flat tree of elements with keys, types, props, and children references
+ * - Catalog: Components with props schemas, and optional actions
+ */
+declare const schema: _json_render_core.Schema<{
+    spec: _json_render_core.SchemaType<"object", {
+        /** Root element key */
+        root: _json_render_core.SchemaType<"string", unknown>;
+        /** Flat map of elements by key */
+        elements: _json_render_core.SchemaType<"record", _json_render_core.SchemaType<"object", {
+            /** Unique key for this element */
+            key: _json_render_core.SchemaType<"string", unknown>;
+            /** Component type from catalog */
+            type: _json_render_core.SchemaType<"ref", string>;
+            /** Component props */
+            props: _json_render_core.SchemaType<"propsOf", string>;
+            /** Child element keys (flat reference) */
+            children: _json_render_core.SchemaType<"array", _json_render_core.SchemaType<"string", unknown>>;
+            /** Parent element key (null for root) */
+            parentKey: _json_render_core.SchemaType<"string", unknown>;
+            /** Visibility condition */
+            visible: _json_render_core.SchemaType<"any", unknown>;
+        }>>;
+    }>;
+    catalog: _json_render_core.SchemaType<"object", {
+        /** Component definitions */
+        components: _json_render_core.SchemaType<"map", {
+            /** Zod schema for component props */
+            props: _json_render_core.SchemaType<"zod", unknown>;
+            /** Slots for this component. Use ['default'] for children, or named slots like ['header', 'footer'] */
+            slots: _json_render_core.SchemaType<"array", _json_render_core.SchemaType<"string", unknown>>;
+            /** Description for AI generation hints */
+            description: _json_render_core.SchemaType<"string", unknown>;
+        }>;
+        /** Action definitions (optional) */
+        actions: _json_render_core.SchemaType<"map", {
+            /** Zod schema for action params */
+            params: _json_render_core.SchemaType<"zod", unknown>;
+            /** Description for AI generation hints */
+            description: _json_render_core.SchemaType<"string", unknown>;
+        }>;
+    }>;
+}>;
+/**
+ * Type for the React schema
+ */
+type ReactSchema = typeof schema;
+/**
+ * Infer the spec type from a catalog
+ */
+type ReactSpec<TCatalog> = typeof schema extends {
+    createCatalog: (catalog: TCatalog) => {
+        _specType: infer S;
+    };
+} ? S : never;
+/** @deprecated Use `schema` instead */
+declare const elementTreeSchema: _json_render_core.Schema<{
+    spec: _json_render_core.SchemaType<"object", {
+        /** Root element key */
+        root: _json_render_core.SchemaType<"string", unknown>;
+        /** Flat map of elements by key */
+        elements: _json_render_core.SchemaType<"record", _json_render_core.SchemaType<"object", {
+            /** Unique key for this element */
+            key: _json_render_core.SchemaType<"string", unknown>;
+            /** Component type from catalog */
+            type: _json_render_core.SchemaType<"ref", string>;
+            /** Component props */
+            props: _json_render_core.SchemaType<"propsOf", string>;
+            /** Child element keys (flat reference) */
+            children: _json_render_core.SchemaType<"array", _json_render_core.SchemaType<"string", unknown>>;
+            /** Parent element key (null for root) */
+            parentKey: _json_render_core.SchemaType<"string", unknown>;
+            /** Visibility condition */
+            visible: _json_render_core.SchemaType<"any", unknown>;
+        }>>;
+    }>;
+    catalog: _json_render_core.SchemaType<"object", {
+        /** Component definitions */
+        components: _json_render_core.SchemaType<"map", {
+            /** Zod schema for component props */
+            props: _json_render_core.SchemaType<"zod", unknown>;
+            /** Slots for this component. Use ['default'] for children, or named slots like ['header', 'footer'] */
+            slots: _json_render_core.SchemaType<"array", _json_render_core.SchemaType<"string", unknown>>;
+            /** Description for AI generation hints */
+            description: _json_render_core.SchemaType<"string", unknown>;
+        }>;
+        /** Action definitions (optional) */
+        actions: _json_render_core.SchemaType<"map", {
+            /** Zod schema for action params */
+            params: _json_render_core.SchemaType<"zod", unknown>;
+            /** Description for AI generation hints */
+            description: _json_render_core.SchemaType<"string", unknown>;
+        }>;
+    }>;
+}>;
+/** @deprecated Use `ReactSchema` instead */
+type ElementTreeSchema = ReactSchema;
+/** @deprecated Use `ReactSpec` instead */
+type ElementTreeSpec<T> = ReactSpec<T>;
+
+export { type ElementTreeSchema, type ElementTreeSpec, type ReactSchema, type ReactSpec, elementTreeSchema, schema };

package/dist/schema.js

@@ -0,0 +1,77 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/schema.ts
+var schema_exports = {};
+__export(schema_exports, {
+  elementTreeSchema: () => elementTreeSchema,
+  schema: () => schema
+});
+module.exports = __toCommonJS(schema_exports);
+var import_core = require("@json-render/core");
+var schema = (0, import_core.defineSchema)((s) => ({
+  // What the AI-generated SPEC looks like
+  spec: s.object({
+    /** Root element key */
+    root: s.string(),
+    /** Flat map of elements by key */
+    elements: s.record(
+      s.object({
+        /** Unique key for this element */
+        key: s.string(),
+        /** Component type from catalog */
+        type: s.ref("catalog.components"),
+        /** Component props */
+        props: s.propsOf("catalog.components"),
+        /** Child element keys (flat reference) */
+        children: s.array(s.string()),
+        /** Parent element key (null for root) */
+        parentKey: s.string(),
+        /** Visibility condition */
+        visible: s.any()
+      })
+    )
+  }),
+  // What the CATALOG must provide
+  catalog: s.object({
+    /** Component definitions */
+    components: s.map({
+      /** Zod schema for component props */
+      props: s.zod(),
+      /** Slots for this component. Use ['default'] for children, or named slots like ['header', 'footer'] */
+      slots: s.array(s.string()),
+      /** Description for AI generation hints */
+      description: s.string()
+    }),
+    /** Action definitions (optional) */
+    actions: s.map({
+      /** Zod schema for action params */
+      params: s.zod(),
+      /** Description for AI generation hints */
+      description: s.string()
+    })
+  })
+}));
+var elementTreeSchema = schema;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  elementTreeSchema,
+  schema
+});
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts"],"sourcesContent":["import { defineSchema } from \"@json-render/core\";\n\n/**\n * The schema for @json-render/react\n *\n * Defines:\n * - Spec: A flat tree of elements with keys, types, props, and children references\n * - Catalog: Components with props schemas, and optional actions\n */\nexport const schema = defineSchema((s) => ({\n  // What the AI-generated SPEC looks like\n  spec: s.object({\n    /** Root element key */\n    root: s.string(),\n    /** Flat map of elements by key */\n    elements: s.record(\n      s.object({\n        /** Unique key for this element */\n        key: s.string(),\n        /** Component type from catalog */\n        type: s.ref(\"catalog.components\"),\n        /** Component props */\n        props: s.propsOf(\"catalog.components\"),\n        /** Child element keys (flat reference) */\n        children: s.array(s.string()),\n        /** Parent element key (null for root) */\n        parentKey: s.string(),\n        /** Visibility condition */\n        visible: s.any(),\n      }),\n    ),\n  }),\n\n  // What the CATALOG must provide\n  catalog: s.object({\n    /** Component definitions */\n    components: s.map({\n      /** Zod schema for component props */\n      props: s.zod(),\n      /** Slots for this component. Use ['default'] for children, or named slots like ['header', 'footer'] */\n      slots: s.array(s.string()),\n      /** Description for AI generation hints */\n      description: s.string(),\n    }),\n    /** Action definitions (optional) */\n    actions: s.map({\n      /** Zod schema for action params */\n      params: s.zod(),\n      /** Description for AI generation hints */\n      description: s.string(),\n    }),\n  }),\n}));\n\n/**\n * Type for the React schema\n */\nexport type ReactSchema = typeof schema;\n\n/**\n * Infer the spec type from a catalog\n */\nexport type ReactSpec<TCatalog> = typeof schema extends {\n  createCatalog: (catalog: TCatalog) => { _specType: infer S };\n}\n  ? S\n  : never;\n\n// Backward compatibility aliases\n/** @deprecated Use `schema` instead */\nexport const elementTreeSchema = schema;\n/** @deprecated Use `ReactSchema` instead */\nexport type ElementTreeSchema = ReactSchema;\n/** @deprecated Use `ReactSpec` instead */\nexport type ElementTreeSpec<T> = ReactSpec<T>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAA6B;AAStB,IAAM,aAAS,0BAAa,CAAC,OAAO;AAAA;AAAA,EAEzC,MAAM,EAAE,OAAO;AAAA;AAAA,IAEb,MAAM,EAAE,OAAO;AAAA;AAAA,IAEf,UAAU,EAAE;AAAA,MACV,EAAE,OAAO;AAAA;AAAA,QAEP,KAAK,EAAE,OAAO;AAAA;AAAA,QAEd,MAAM,EAAE,IAAI,oBAAoB;AAAA;AAAA,QAEhC,OAAO,EAAE,QAAQ,oBAAoB;AAAA;AAAA,QAErC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC;AAAA;AAAA,QAE5B,WAAW,EAAE,OAAO;AAAA;AAAA,QAEpB,SAAS,EAAE,IAAI;AAAA,MACjB,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AAAA;AAAA,EAGD,SAAS,EAAE,OAAO;AAAA;AAAA,IAEhB,YAAY,EAAE,IAAI;AAAA;AAAA,MAEhB,OAAO,EAAE,IAAI;AAAA;AAAA,MAEb,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;AAAA;AAAA,MAEzB,aAAa,EAAE,OAAO;AAAA,IACxB,CAAC;AAAA;AAAA,IAED,SAAS,EAAE,IAAI;AAAA;AAAA,MAEb,QAAQ,EAAE,IAAI;AAAA;AAAA,MAEd,aAAa,EAAE,OAAO;AAAA,IACxB,CAAC;AAAA,EACH,CAAC;AACH,EAAE;AAkBK,IAAM,oBAAoB;","names":[]}

package/dist/schema.mjs

@@ -0,0 +1,9 @@
+import {
+  elementTreeSchema,
+  schema
+} from "./chunk-IGPI5WNB.mjs";
+export {
+  elementTreeSchema,
+  schema
+};
+//# sourceMappingURL=schema.mjs.map

package/dist/schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-render/react",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "license": "Apache-2.0",
   "description": "React renderer for @json-render/core. JSON becomes React components.",
   "keywords": [
@@ -34,13 +34,18 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "import": "./dist/schema.mjs",
+      "require": "./dist/schema.js"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "@json-render/core": "0.2.0"
+    "@json-render/core": "0.4.0"
   },
   "devDependencies": {
     "@types/react": "19.2.3",