@genetik/renderer 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eugene Michasiw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @genetik/renderer
+
+Framework-agnostic core: resolves content + schema into a **resolved tree** (ResolvedNode). No UI framework; use @genetik/renderer-react (or another binding) to map the tree to components.
+
+## Installation
+
+```bash
+pnpm add @genetik/renderer
+```
+
+## Usage
+
+- **resolve(content, schema)** — Returns the root ResolvedNode, or null if the entry node is missing. Each node has `block`, `config`, and `slots` (slot name → ordered array of ResolvedNode).
+
+See the [docs](/docs/packages/renderer) for API and examples.

package/dist/index.cjs

@@ -0,0 +1,55 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _genetik_content = require("@genetik/content");
+let _genetik_schema = require("@genetik/schema");
+
+//#region src/resolve.ts
+/**
+* Resolves content against a schema into a tree of ResolvedNode. Walks from the
+* entry node and resolves each slot to ordered child ResolvedNodes. Missing
+* nodes (dangling refs) are skipped. Framework-agnostic; use a binding
+* (e.g. @genetik/renderer-react) to map ResolvedNode to UI components.
+*
+* Accepts either a content object or a JSON string (parsed with parseContentJson).
+* Returns null if content is invalid JSON, the entry node is missing, or resolution fails.
+*/
+function resolve(content, schema) {
+	let parsed;
+	if (typeof content === "string") {
+		const result = (0, _genetik_content.parseContentJson)(content);
+		parsed = result.ok ? result.content : null;
+	} else parsed = content;
+	if (!parsed) return null;
+	const root = parsed.nodes[parsed.entryId];
+	if (!root) return null;
+	return resolveNode(parsed, schema, root);
+}
+function resolveNode(content, schema, node) {
+	const blockType = (0, _genetik_schema.getBlockType)(schema, node.block);
+	const slots = {};
+	if (blockType) for (const slotDef of blockType.slots) {
+		const value = node[slotDef.name];
+		const ids = slotValueToIds(value);
+		const children = [];
+		for (const id of ids) {
+			const child = content.nodes[id];
+			if (child) children.push(resolveNode(content, schema, child));
+		}
+		slots[slotDef.name] = children;
+	}
+	return {
+		id: node.id,
+		block: node.block,
+		config: node.config,
+		slots
+	};
+}
+function slotValueToIds(value) {
+	if (value === void 0 || value === null) return [];
+	if (typeof value === "string") return [value];
+	if (Array.isArray(value)) return value.filter((v) => typeof v === "string");
+	return [];
+}
+
+//#endregion
+exports.resolve = resolve;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/resolve.ts"],"sourcesContent":["import { parseContentJson } from \"@genetik/content\";\nimport type { ContentNode, GenetikContent } from \"@genetik/content\";\nimport type { GenetikSchema } from \"@genetik/schema\";\nimport { getBlockType } from \"@genetik/schema\";\nimport type { ResolvedNode } from \"./types.js\";\n\n/**\n * Resolves content against a schema into a tree of ResolvedNode. Walks from the\n * entry node and resolves each slot to ordered child ResolvedNodes. Missing\n * nodes (dangling refs) are skipped. Framework-agnostic; use a binding\n * (e.g. @genetik/renderer-react) to map ResolvedNode to UI components.\n *\n * Accepts either a content object or a JSON string (parsed with parseContentJson).\n * Returns null if content is invalid JSON, the entry node is missing, or resolution fails.\n */\nexport function resolve(\n  content: GenetikContent | string,\n  schema: GenetikSchema,\n): ResolvedNode | null {\n  let parsed: GenetikContent | null;\n  if (typeof content === \"string\") {\n    const result = parseContentJson(content);\n    parsed = result.ok ? result.content : null;\n  } else {\n    parsed = content;\n  }\n  if (!parsed) return null;\n  const root = parsed.nodes[parsed.entryId];\n  if (!root) return null;\n  return resolveNode(parsed, schema, root);\n}\n\nfunction resolveNode(\n  content: GenetikContent,\n  schema: GenetikSchema,\n  node: ContentNode\n): ResolvedNode {\n  const blockType = getBlockType(schema, node.block);\n  const slots: Record<string, ResolvedNode[]> = {};\n\n  if (blockType) {\n    for (const slotDef of blockType.slots) {\n      const value = node[slotDef.name];\n      const ids = slotValueToIds(value);\n      const children: ResolvedNode[] = [];\n      for (const id of ids) {\n        const child = content.nodes[id];\n        if (child) {\n          children.push(resolveNode(content, schema, child));\n        }\n      }\n      slots[slotDef.name] = children;\n    }\n  }\n\n  return {\n    id: node.id,\n    block: node.block,\n    config: node.config,\n    slots,\n  };\n}\n\nfunction slotValueToIds(value: unknown): string[] {\n  if (value === undefined || value === null) return [];\n  if (typeof value === \"string\") return [value];\n  if (Array.isArray(value)) return value.filter((v): v is string => typeof v === \"string\");\n  return [];\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAgB,QACd,SACA,QACqB;CACrB,IAAI;AACJ,KAAI,OAAO,YAAY,UAAU;EAC/B,MAAM,gDAA0B,QAAQ;AACxC,WAAS,OAAO,KAAK,OAAO,UAAU;OAEtC,UAAS;AAEX,KAAI,CAAC,OAAQ,QAAO;CACpB,MAAM,OAAO,OAAO,MAAM,OAAO;AACjC,KAAI,CAAC,KAAM,QAAO;AAClB,QAAO,YAAY,QAAQ,QAAQ,KAAK;;AAG1C,SAAS,YACP,SACA,QACA,MACc;CACd,MAAM,8CAAyB,QAAQ,KAAK,MAAM;CAClD,MAAM,QAAwC,EAAE;AAEhD,KAAI,UACF,MAAK,MAAM,WAAW,UAAU,OAAO;EACrC,MAAM,QAAQ,KAAK,QAAQ;EAC3B,MAAM,MAAM,eAAe,MAAM;EACjC,MAAM,WAA2B,EAAE;AACnC,OAAK,MAAM,MAAM,KAAK;GACpB,MAAM,QAAQ,QAAQ,MAAM;AAC5B,OAAI,MACF,UAAS,KAAK,YAAY,SAAS,QAAQ,MAAM,CAAC;;AAGtD,QAAM,QAAQ,QAAQ;;AAI1B,QAAO;EACL,IAAI,KAAK;EACT,OAAO,KAAK;EACZ,QAAQ,KAAK;EACb;EACD;;AAGH,SAAS,eAAe,OAA0B;AAChD,KAAI,UAAU,UAAa,UAAU,KAAM,QAAO,EAAE;AACpD,KAAI,OAAO,UAAU,SAAU,QAAO,CAAC,MAAM;AAC7C,KAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,QAAQ,MAAmB,OAAO,MAAM,SAAS;AACxF,QAAO,EAAE"}

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+import { GenetikContent } from "@genetik/content";
+import { GenetikSchema } from "@genetik/schema";
+
+//#region src/types.d.ts
+/**
+ * A node in the resolved tree: block type, config, and resolved children per slot.
+ * Framework-agnostic; a React (or other) binding maps this to components.
+ */
+interface ResolvedNode {
+  /** Content node id (for React keys when rendering slot children). */
+  id: string;
+  /** Block type name. */
+  block: string;
+  /** Block-specific config. */
+  config: Record<string, unknown>;
+  /** Resolved children by slot name. Each slot is an ordered array of ResolvedNode. */
+  slots: Record<string, ResolvedNode[]>;
+}
+//#endregion
+//#region src/resolve.d.ts
+/**
+ * Resolves content against a schema into a tree of ResolvedNode. Walks from the
+ * entry node and resolves each slot to ordered child ResolvedNodes. Missing
+ * nodes (dangling refs) are skipped. Framework-agnostic; use a binding
+ * (e.g. @genetik/renderer-react) to map ResolvedNode to UI components.
+ *
+ * Accepts either a content object or a JSON string (parsed with parseContentJson).
+ * Returns null if content is invalid JSON, the entry node is missing, or resolution fails.
+ */
+declare function resolve(content: GenetikContent | string, schema: GenetikSchema): ResolvedNode | null;
+//#endregion
+export { type ResolvedNode, resolve };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/types.ts","../src/resolve.ts"],"mappings":";;;;;;;;UAIiB,YAAA;EAAY;EAE3B,EAAA;EAIQ;EAFR,KAAA;EAIO;EAFP,MAAA,EAAQ,MAAA;EAEK;EAAb,KAAA,EAAO,MAAA,SAAe,YAAA;AAAA;;;;AARxB;;;;;;;;iBCWgB,OAAA,CACd,OAAA,EAAS,cAAA,WACT,MAAA,EAAQ,aAAA,GACP,YAAA"}

package/dist/index.d.mts

@@ -0,0 +1,33 @@
+import { GenetikContent } from "@genetik/content";
+import { GenetikSchema } from "@genetik/schema";
+
+//#region src/types.d.ts
+/**
+ * A node in the resolved tree: block type, config, and resolved children per slot.
+ * Framework-agnostic; a React (or other) binding maps this to components.
+ */
+interface ResolvedNode {
+  /** Content node id (for React keys when rendering slot children). */
+  id: string;
+  /** Block type name. */
+  block: string;
+  /** Block-specific config. */
+  config: Record<string, unknown>;
+  /** Resolved children by slot name. Each slot is an ordered array of ResolvedNode. */
+  slots: Record<string, ResolvedNode[]>;
+}
+//#endregion
+//#region src/resolve.d.ts
+/**
+ * Resolves content against a schema into a tree of ResolvedNode. Walks from the
+ * entry node and resolves each slot to ordered child ResolvedNodes. Missing
+ * nodes (dangling refs) are skipped. Framework-agnostic; use a binding
+ * (e.g. @genetik/renderer-react) to map ResolvedNode to UI components.
+ *
+ * Accepts either a content object or a JSON string (parsed with parseContentJson).
+ * Returns null if content is invalid JSON, the entry node is missing, or resolution fails.
+ */
+declare function resolve(content: GenetikContent | string, schema: GenetikSchema): ResolvedNode | null;
+//#endregion
+export { type ResolvedNode, resolve };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/resolve.ts"],"mappings":";;;;;;;;UAIiB,YAAA;EAAY;EAE3B,EAAA;EAIQ;EAFR,KAAA;EAIO;EAFP,MAAA,EAAQ,MAAA;EAEK;EAAb,KAAA,EAAO,MAAA,SAAe,YAAA;AAAA;;;;AARxB;;;;;;;;iBCWgB,OAAA,CACd,OAAA,EAAS,cAAA,WACT,MAAA,EAAQ,aAAA,GACP,YAAA"}

package/dist/index.mjs

@@ -0,0 +1,54 @@
+import { parseContentJson } from "@genetik/content";
+import { getBlockType } from "@genetik/schema";
+
+//#region src/resolve.ts
+/**
+* Resolves content against a schema into a tree of ResolvedNode. Walks from the
+* entry node and resolves each slot to ordered child ResolvedNodes. Missing
+* nodes (dangling refs) are skipped. Framework-agnostic; use a binding
+* (e.g. @genetik/renderer-react) to map ResolvedNode to UI components.
+*
+* Accepts either a content object or a JSON string (parsed with parseContentJson).
+* Returns null if content is invalid JSON, the entry node is missing, or resolution fails.
+*/
+function resolve(content, schema) {
+	let parsed;
+	if (typeof content === "string") {
+		const result = parseContentJson(content);
+		parsed = result.ok ? result.content : null;
+	} else parsed = content;
+	if (!parsed) return null;
+	const root = parsed.nodes[parsed.entryId];
+	if (!root) return null;
+	return resolveNode(parsed, schema, root);
+}
+function resolveNode(content, schema, node) {
+	const blockType = getBlockType(schema, node.block);
+	const slots = {};
+	if (blockType) for (const slotDef of blockType.slots) {
+		const value = node[slotDef.name];
+		const ids = slotValueToIds(value);
+		const children = [];
+		for (const id of ids) {
+			const child = content.nodes[id];
+			if (child) children.push(resolveNode(content, schema, child));
+		}
+		slots[slotDef.name] = children;
+	}
+	return {
+		id: node.id,
+		block: node.block,
+		config: node.config,
+		slots
+	};
+}
+function slotValueToIds(value) {
+	if (value === void 0 || value === null) return [];
+	if (typeof value === "string") return [value];
+	if (Array.isArray(value)) return value.filter((v) => typeof v === "string");
+	return [];
+}
+
+//#endregion
+export { resolve };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/resolve.ts"],"sourcesContent":["import { parseContentJson } from \"@genetik/content\";\nimport type { ContentNode, GenetikContent } from \"@genetik/content\";\nimport type { GenetikSchema } from \"@genetik/schema\";\nimport { getBlockType } from \"@genetik/schema\";\nimport type { ResolvedNode } from \"./types.js\";\n\n/**\n * Resolves content against a schema into a tree of ResolvedNode. Walks from the\n * entry node and resolves each slot to ordered child ResolvedNodes. Missing\n * nodes (dangling refs) are skipped. Framework-agnostic; use a binding\n * (e.g. @genetik/renderer-react) to map ResolvedNode to UI components.\n *\n * Accepts either a content object or a JSON string (parsed with parseContentJson).\n * Returns null if content is invalid JSON, the entry node is missing, or resolution fails.\n */\nexport function resolve(\n  content: GenetikContent | string,\n  schema: GenetikSchema,\n): ResolvedNode | null {\n  let parsed: GenetikContent | null;\n  if (typeof content === \"string\") {\n    const result = parseContentJson(content);\n    parsed = result.ok ? result.content : null;\n  } else {\n    parsed = content;\n  }\n  if (!parsed) return null;\n  const root = parsed.nodes[parsed.entryId];\n  if (!root) return null;\n  return resolveNode(parsed, schema, root);\n}\n\nfunction resolveNode(\n  content: GenetikContent,\n  schema: GenetikSchema,\n  node: ContentNode\n): ResolvedNode {\n  const blockType = getBlockType(schema, node.block);\n  const slots: Record<string, ResolvedNode[]> = {};\n\n  if (blockType) {\n    for (const slotDef of blockType.slots) {\n      const value = node[slotDef.name];\n      const ids = slotValueToIds(value);\n      const children: ResolvedNode[] = [];\n      for (const id of ids) {\n        const child = content.nodes[id];\n        if (child) {\n          children.push(resolveNode(content, schema, child));\n        }\n      }\n      slots[slotDef.name] = children;\n    }\n  }\n\n  return {\n    id: node.id,\n    block: node.block,\n    config: node.config,\n    slots,\n  };\n}\n\nfunction slotValueToIds(value: unknown): string[] {\n  if (value === undefined || value === null) return [];\n  if (typeof value === \"string\") return [value];\n  if (Array.isArray(value)) return value.filter((v): v is string => typeof v === \"string\");\n  return [];\n}\n"],"mappings":";;;;;;;;;;;;;AAeA,SAAgB,QACd,SACA,QACqB;CACrB,IAAI;AACJ,KAAI,OAAO,YAAY,UAAU;EAC/B,MAAM,SAAS,iBAAiB,QAAQ;AACxC,WAAS,OAAO,KAAK,OAAO,UAAU;OAEtC,UAAS;AAEX,KAAI,CAAC,OAAQ,QAAO;CACpB,MAAM,OAAO,OAAO,MAAM,OAAO;AACjC,KAAI,CAAC,KAAM,QAAO;AAClB,QAAO,YAAY,QAAQ,QAAQ,KAAK;;AAG1C,SAAS,YACP,SACA,QACA,MACc;CACd,MAAM,YAAY,aAAa,QAAQ,KAAK,MAAM;CAClD,MAAM,QAAwC,EAAE;AAEhD,KAAI,UACF,MAAK,MAAM,WAAW,UAAU,OAAO;EACrC,MAAM,QAAQ,KAAK,QAAQ;EAC3B,MAAM,MAAM,eAAe,MAAM;EACjC,MAAM,WAA2B,EAAE;AACnC,OAAK,MAAM,MAAM,KAAK;GACpB,MAAM,QAAQ,QAAQ,MAAM;AAC5B,OAAI,MACF,UAAS,KAAK,YAAY,SAAS,QAAQ,MAAM,CAAC;;AAGtD,QAAM,QAAQ,QAAQ;;AAI1B,QAAO;EACL,IAAI,KAAK;EACT,OAAO,KAAK;EACZ,QAAQ,KAAK;EACb;EACD;;AAGH,SAAS,eAAe,OAA0B;AAChD,KAAI,UAAU,UAAa,UAAU,KAAM,QAAO,EAAE;AACpD,KAAI,OAAO,UAAU,SAAU,QAAO,CAAC,MAAM;AAC7C,KAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,QAAQ,MAAmB,OAAO,MAAM,SAAS;AACxF,QAAO,EAAE"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@genetik/renderer",
+  "version": "0.0.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@genetik/content": "0.0.0",
+    "@genetik/schema": "0.0.0"
+  },
+  "devDependencies": {
+    "eslint": "^9.39.1",
+    "tsdown": "0.20.3",
+    "typescript": "5.9.2",
+    "vitest": "^2.1.8",
+    "@genetik/eslint-config": "0.0.0",
+    "@genetik/typescript-config": "0.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "lint": "eslint . --max-warnings 0",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}