@x12i/catalox 2.0.1 → 2.0.2

package/README.md

@@ -76,6 +76,7 @@ Metadata:
 - `catalogAdapters/{adapterId}` (mongo/api adapter definitions)
 - `catalogMappings/{mappingId}` (field mapping specs)
 - `catalogDescriptors/{catalogId}` (**descriptor metadata** for generic consumption)
+- `catalogRendererSnippets/{catalogId}:{surface}` (**stored TSX/JSX snippets** for list/item rendering)
 - `catalogReferences/{referenceId}` (standardized reference records)
 
 Data:
@@ -210,7 +211,9 @@ Catalog descriptors can include optional UI metadata for generic presentation la
 
 - `filterSpec`: declarative filter configuration (built on `FieldSource`)
 - `presentationSpec`: declarative layout + view/edit semantics (grid/list/cards/form)
-- `customRenderer`: escape hatch that assigns a host-resolved JSX component (by registry key) and passes a stable render-map contract
+- `customRenderer`: escape hatch that assigns either:
+  - a host-resolved JSX component (by registry key), or
+  - a separately-stored TSX/JSX snippet reference (`snippetRef`)
 
 Custom renderer contracts:
 
@@ -219,6 +222,23 @@ Custom renderer contracts:
 
 Important: host presentation layers are responsible for resolving `FieldSource` lookups (cross-catalog enums/refs) and populating `resolvedSources` for renderers.
 
+#### Stored JSX/TSX renderer snippets (optional)
+
+In addition to `customRenderer.{list|item}.component`, descriptors may specify:
+
+- `customRenderer.list.snippetRef` or `customRenderer.item.snippetRef`
+
+Snippets are stored separately in Firestore:
+
+- `catalogRendererSnippets/{catalogId}:{surface}` where `surface` is `list` or `item`
+
+This package includes a small set of opt-in helpers for snippet compilation/validation:
+
+- `transpileJsxToModuleSource(...)`: TSX/JSX → ESM module source (string)
+- `typecheckRendererSnippetIo(...)` (optional): best-effort TypeScript validation that a snippet’s default export matches the list/item render-map I/O contract
+- `unsafeCreateRendererFunction(...)`: **UNSAFE** runtime evaluation of transpiled code
+- `renderRendererToHtml(...)`: best-effort HTML rendering if `react` + `react-dom` are installed
+
 ### What you need persisted for “generic consumption”
 
 To let consumers operate *purely* from `appId` with no hardcoded catalog registrations, Catalox relies on these being present in Firestore:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/catalox",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "Catalox: Firebase-native catalog metadata + unification package.",
   "license": "MIT",
   "private": false,