@bettercms-ai/ui 0.3.0

package/dist/resolve.js

@@ -0,0 +1,58 @@
+"use client";
+
+// src/resolve.ts
+function childArrays(block) {
+  const p = block.props ?? {};
+  switch (block.type) {
+    case "columns":
+      return Array.isArray(p.columns) ? p.columns : [];
+    case "section":
+      return Array.isArray(p.children) ? [p.children] : [];
+    case "slider":
+      return Array.isArray(p.slides) ? p.slides.map((s) => Array.isArray(s.children) ? s.children : []) : [];
+    case "tabs":
+      return Array.isArray(p.tabs) ? p.tabs.map((t) => Array.isArray(t.children) ? t.children : []) : [];
+    default:
+      return [];
+  }
+}
+function findBlockById(blocks, id) {
+  for (const b of blocks) {
+    if (b?.id === id) return b;
+    for (const child of childArrays(b)) {
+      const found = findBlockById(child, id);
+      if (found) return found;
+    }
+  }
+  return null;
+}
+function setPath(obj, path, value) {
+  const keys = path.split(".");
+  let cur = obj;
+  for (let i = 0; i < keys.length - 1; i++) {
+    const k = keys[i];
+    if (typeof cur[k] !== "object" || cur[k] === null) cur[k] = {};
+    cur = cur[k];
+  }
+  cur[keys[keys.length - 1]] = value;
+}
+function applyOverrides(blockJson, propDefs, overrides) {
+  if (!Array.isArray(blockJson)) return [];
+  if (!propDefs.length || !overrides || Object.keys(overrides).length === 0) {
+    return blockJson;
+  }
+  const clone = structuredClone(blockJson);
+  for (const def of propDefs) {
+    if (!(def.key in overrides)) continue;
+    const target = findBlockById(clone, def.target.blockId);
+    if (target) setPath(target, def.target.path, overrides[def.key]);
+  }
+  return clone;
+}
+export {
+  applyOverrides,
+  childArrays,
+  findBlockById,
+  setPath
+};
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resolve.ts"],"sourcesContent":["/**\n * Pure component-instance resolver — clone a component's blockJson and write each\n * declared override at its target (blockId + dotted path), honoring the props[]\n * allowlist. The single source of truth shared by the dashboard canvas preview, the\n * backend live HTML renderer, and @bettercms-ai/next's SSG output, so all three resolve\n * instances identically. React-free and exported on its own subpath (@bettercms-ai/ui/\n * resolve) so the Hono server can import it without pulling in the block components.\n */\n\n/** Minimal block shape the resolver needs — every real block type is structurally wider.\n * `props` is `unknown` (not `Record<string, unknown>`) so typed block unions like\n * @bettercms-ai/types' ContentBlock — whose `props` are specific interfaces without an\n * index signature — still satisfy the constraint. */\nexport type ResolverBlock = { type: string; id?: string; props?: unknown };\n\n/** Minimal prop-def shape — the real ComponentPropDef is structurally wider. */\nexport type ResolverPropDef = { key: string; target: { blockId: string; path: string } };\n\n/** The child block arrays a container holds, one entry per nested slot (all container types). */\nexport function childArrays<B extends ResolverBlock>(block: B): B[][] {\n  const p = (block.props ?? {}) as Record<string, unknown>;\n  switch (block.type) {\n    case \"columns\":\n      return Array.isArray(p.columns) ? (p.columns as B[][]) : [];\n    case \"section\":\n      return Array.isArray(p.children) ? [p.children as B[]] : [];\n    case \"slider\":\n      return Array.isArray(p.slides)\n        ? (p.slides as { children?: B[] }[]).map((s) => (Array.isArray(s.children) ? s.children : []))\n        : [];\n    case \"tabs\":\n      return Array.isArray(p.tabs)\n        ? (p.tabs as { children?: B[] }[]).map((t) => (Array.isArray(t.children) ? t.children : []))\n        : [];\n    default:\n      return [];\n  }\n}\n\n/** Find a block by id anywhere in a tree (descends every container). */\nexport function findBlockById<B extends ResolverBlock>(blocks: B[], id: string): B | null {\n  for (const b of blocks) {\n    if (b?.id === id) return b;\n    for (const child of childArrays(b)) {\n      const found = findBlockById(child, id);\n      if (found) return found;\n    }\n  }\n  return null;\n}\n\n/** Write `value` at a dotted path (e.g. \"props.text\"), creating objects as needed. */\nexport function setPath(obj: Record<string, unknown>, path: string, value: unknown): void {\n  const keys = path.split(\".\");\n  let cur: Record<string, unknown> = obj;\n  for (let i = 0; i < keys.length - 1; i++) {\n    const k = keys[i]!;\n    if (typeof cur[k] !== \"object\" || cur[k] === null) cur[k] = {};\n    cur = cur[k] as Record<string, unknown>;\n  }\n  cur[keys[keys.length - 1]!] = value;\n}\n\n/**\n * Apply an instance's `overrides` onto a clone of a component's blockJson, honoring the\n * declared `props[]` allowlist (key → target block + path). Returns the original array\n * untouched (referentially stable) when there's nothing to override; returns [] for a\n * non-array input.\n */\nexport function applyOverrides<B extends ResolverBlock>(\n  blockJson: unknown,\n  propDefs: ResolverPropDef[],\n  overrides: Record<string, unknown> | undefined,\n): B[] {\n  if (!Array.isArray(blockJson)) return [];\n  if (!propDefs.length || !overrides || Object.keys(overrides).length === 0) {\n    return blockJson as B[];\n  }\n  const clone = structuredClone(blockJson) as B[];\n  for (const def of propDefs) {\n    if (!(def.key in overrides)) continue;\n    const target = findBlockById(clone, def.target.blockId);\n    if (target) setPath(target as unknown as Record<string, unknown>, def.target.path, overrides[def.key]);\n  }\n  return clone;\n}\n"],"mappings":";;;AAmBO,SAAS,YAAqC,OAAiB;AACpE,QAAM,IAAK,MAAM,SAAS,CAAC;AAC3B,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,MAAM,QAAQ,EAAE,OAAO,IAAK,EAAE,UAAoB,CAAC;AAAA,IAC5D,KAAK;AACH,aAAO,MAAM,QAAQ,EAAE,QAAQ,IAAI,CAAC,EAAE,QAAe,IAAI,CAAC;AAAA,IAC5D,KAAK;AACH,aAAO,MAAM,QAAQ,EAAE,MAAM,IACxB,EAAE,OAAgC,IAAI,CAAC,MAAO,MAAM,QAAQ,EAAE,QAAQ,IAAI,EAAE,WAAW,CAAC,CAAE,IAC3F,CAAC;AAAA,IACP,KAAK;AACH,aAAO,MAAM,QAAQ,EAAE,IAAI,IACtB,EAAE,KAA8B,IAAI,CAAC,MAAO,MAAM,QAAQ,EAAE,QAAQ,IAAI,EAAE,WAAW,CAAC,CAAE,IACzF,CAAC;AAAA,IACP;AACE,aAAO,CAAC;AAAA,EACZ;AACF;AAGO,SAAS,cAAuC,QAAa,IAAsB;AACxF,aAAW,KAAK,QAAQ;AACtB,QAAI,GAAG,OAAO,GAAI,QAAO;AACzB,eAAW,SAAS,YAAY,CAAC,GAAG;AAClC,YAAM,QAAQ,cAAc,OAAO,EAAE;AACrC,UAAI,MAAO,QAAO;AAAA,IACpB;AAAA,EACF;AACA,SAAO;AACT;AAGO,SAAS,QAAQ,KAA8B,MAAc,OAAsB;AACxF,QAAM,OAAO,KAAK,MAAM,GAAG;AAC3B,MAAI,MAA+B;AACnC,WAAS,IAAI,GAAG,IAAI,KAAK,SAAS,GAAG,KAAK;AACxC,UAAM,IAAI,KAAK,CAAC;AAChB,QAAI,OAAO,IAAI,CAAC,MAAM,YAAY,IAAI,CAAC,MAAM,KAAM,KAAI,CAAC,IAAI,CAAC;AAC7D,UAAM,IAAI,CAAC;AAAA,EACb;AACA,MAAI,KAAK,KAAK,SAAS,CAAC,CAAE,IAAI;AAChC;AAQO,SAAS,eACd,WACA,UACA,WACK;AACL,MAAI,CAAC,MAAM,QAAQ,SAAS,EAAG,QAAO,CAAC;AACvC,MAAI,CAAC,SAAS,UAAU,CAAC,aAAa,OAAO,KAAK,SAAS,EAAE,WAAW,GAAG;AACzE,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,gBAAgB,SAAS;AACvC,aAAW,OAAO,UAAU;AAC1B,QAAI,EAAE,IAAI,OAAO,WAAY;AAC7B,UAAM,SAAS,cAAc,OAAO,IAAI,OAAO,OAAO;AACtD,QAAI,OAAQ,SAAQ,QAA8C,IAAI,OAAO,MAAM,UAAU,IAAI,GAAG,CAAC;AAAA,EACvG;AACA,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@bettercms-ai/ui",
+  "version": "0.3.0",
+  "type": "module",
+  "description": "BetterCMS block components + registry/renderer for rendering page block_json in React (dashboard builder preview + headless sites).",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./blocks": {
+      "types": "./dist/blocks.d.ts",
+      "import": "./dist/blocks.js",
+      "default": "./dist/blocks.js"
+    },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "import": "./dist/registry.js",
+      "default": "./dist/registry.js"
+    },
+    "./renderer": {
+      "types": "./dist/renderer.d.ts",
+      "import": "./dist/renderer.js",
+      "default": "./dist/renderer.js"
+    },
+    "./resolve": {
+      "types": "./dist/resolve.d.ts",
+      "import": "./dist/resolve.js",
+      "default": "./dist/resolve.js"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsup",
+    "prepack": "tsup",
+    "lint": "echo 'lint not yet configured'",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "add": "echo 'Use npx shadcn@latest add -p ../.. <component>'"
+  },
+  "dependencies": {
+    "@bettercms-ai/types": "^1.3.1",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^2.6.0"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@swc/core": "^1.15.24",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vitest/coverage-v8": "^4.1.4",
+    "autoprefixer": "^10.4.21",
+    "jsdom": "^26.1.0",
+    "postcss": "^8.5.4",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "tailwindcss": "^3.4.17",
+    "tailwindcss-animate": "^1.0.7",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}