@bettercms-ai/codegen 0.5.0 → 0.7.0

package/README.md

@@ -83,10 +83,10 @@ import { bcms } from "./bettercms.bindings.generated";
 </article>
 ```
 
-The attributes are emitted **only** when the site is built with `BCMS_ANNOTATE` set (preview
-builds); a normal production build ships zero extra attributes (`bcmsField` returns `{}`). Same
-generated file for both — no separate mode. Bindings follow the editor's one-level path grammar
-(`field`, `field[i]`, `field[i].sub`); non-repeatable zones and deeper nesting aren't
+The attributes are emitted on **every** build — two inert `data-*` attributes, the same way
+Storyblok emits `data-blok-c` and Sanity emits `data-sanity` — so a site is editable no matter
+which pipeline built it. No build flag, no separate mode. Bindings follow the editor's one-level
+path grammar (`field`, `field[i]`, `field[i].sub`); non-repeatable zones and deeper nesting aren't
 index-addressable yet, so they're omitted rather than emitted as paths that can't bind.
 
 ## Library API

package/dist/cli.js

@@ -47,12 +47,126 @@ var PREAMBLE = `/**
  *
  * The \`{ format, value }\` contract is unchanged; \`html\` is additive.
  */
+/**
+ * One Portable Text block, or a block object (an image, an embed, a placed component).
+ *
+ * Inlined rather than imported: this preamble is emitted INTO your repo and is deliberately
+ * dependency-free. To render structure, \`npm i @portabletext/react\` and pass
+ * \`portableText(field)\` to it; to render without adding anything, keep using \`rich()\`.
+ */
+export type PortableTextBlock = {
+  readonly _type: string;
+  readonly _key: string;
+  readonly style?: string;
+  readonly listItem?: string;
+  readonly level?: number;
+  readonly markDefs?: readonly { readonly _type: string; readonly _key: string; readonly [k: string]: unknown }[];
+  readonly children?: readonly { readonly _type: string; readonly _key: string; readonly text?: string; readonly marks?: readonly string[] }[];
+  readonly [k: string]: unknown;
+};
+
 export type RichText = {
+  /**
+   * The storage format. Deliberately \`string\` and NOT a literal union: a project mid-backfill
+   * holds both \`"lexical-\u2026"\` and \`"portable-text-1"\` values, and narrowing this would give a
+   * type error to anyone regenerating types against it.
+   */
   readonly format: string;
+  /** Portable Text blocks when \`format\` is \`"portable-text-1"\`; editor state otherwise. */
   readonly value: unknown;
+  /**
+   * Server-rendered, sanitized HTML. ALWAYS present, in every format, forever \u2014 sites built
+   * before Portable Text existed read this directly and cannot be rebuilt.
+   */
   readonly html?: string;
+  /**
+   * @deprecated Superseded by Portable Text \u2014 read \`portableText(field)\` instead. Retained so
+   * entries written before the migration keep type-checking; nothing mints it any more.
+   *
+   * Structured blocks. Present on Body (\`document\`) fields ONLY, and optional even there \u2014
+   * it is derived at write time, so an entry saved before this existed carries none until its
+   * next save, and there is no backfill. Branch on its absence; \`html\` is always there.
+   *
+   * \`id\` is stable within ONE document, never a global key \u2014 two entries both have a "0.0".
+   * A cross-document anchor is (entryId, fieldKey, id).
+   */
+  readonly doc?: {
+    readonly version: 1;
+    readonly blocks: readonly { readonly id: string; readonly type: string; readonly [k: string]: unknown }[];
+  };
 };
 
+/**
+ * A field that may arrive as EITHER shape.
+ *
+ * Switching a field between \`text\` and \`richtext\` in the CMS switches what Delivery
+ * returns for it \u2014 a bare string becomes \`{ format, value, html }\`. Type author-editable
+ * text with this and read it through \`plain()\`/\`rich()\` below, and that switch stops being
+ * a site-breaking change. Interpolating the value directly renders \`[object Object]\`.
+ */
+export type TextOrRich = string | RichText | null | undefined;
+
+/** True when the value is a rich-text envelope rather than a bare string. */
+export function isRichText(value: unknown): value is RichText {
+  return (
+    typeof value === "object" && value !== null && !Array.isArray(value) &&
+    ("html" in value || "format" in value)
+  );
+}
+
+/** The marker on a Portable Text envelope. */
+export const PORTABLE_TEXT_FORMAT = "portable-text-1";
+
+/**
+ * Portable Text blocks when the field stores them, otherwise null.
+ *
+ * ADDITIVE. \`rich()\` and \`plain()\` keep working exactly as before on every format, so
+ * nothing you have already shipped needs to change. Use this only if you want to render the
+ * structure yourself \u2014 for example with \`@portabletext/react\`.
+ */
+export function portableText(value: TextOrRich): readonly PortableTextBlock[] | null {
+  if (!isRichText(value)) return null;
+  return value.format === PORTABLE_TEXT_FORMAT && Array.isArray(value.value)
+    ? (value.value as readonly PortableTextBlock[])
+    : null;
+}
+
+/** Plain text for attribute contexts \u2014 \`<title>\`, meta description, JSON-LD, \`alt\`. */
+export function plain(value: TextOrRich): string {
+  if (typeof value === "string") return value;
+  if (!isRichText(value) || typeof value.html !== "string") return "";
+  return decodeEntities(value.html.replace(/<[^>]+>/g, "")).trim();
+}
+
+/**
+ * Renderable HTML, for \`set:html\` / \`dangerouslySetInnerHTML\`. Rich text keeps its inline
+ * marks (the server sanitizes \`html\` on write); a bare string is escaped, so a plain field
+ * can never inject markup. A LONE wrapping block is unwrapped \u2014 a field switched from
+ * \`text\` stores \`<p>\u2026</p>\`, and \`<h1><p>\u2026</p></h1>\` is invalid HTML (the parser closes the
+ * heading early, dropping the text out of it). Real block structure is left alone.
+ */
+export function rich(value: TextOrRich, fallback = ""): string {
+  const html = (
+    typeof value === "string" ? escapeHtml(value) : isRichText(value) ? (value.html ?? "") : ""
+  ).trim();
+  return html ? unwrapLoneBlock(html) : escapeHtml(fallback);
+}
+
+function unwrapLoneBlock(html: string): string {
+  const m = html.match(/^<(p|div|h[1-6])(?:\\s[^>]*)?>([\\s\\S]*)<\\/\\1>$/i);
+  return m && !new RegExp(\`</\${m[1]}>\`, "i").test(m[2]) ? m[2] : html;
+}
+
+function escapeHtml(s: string): string {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+function decodeEntities(s: string): string {
+  return s
+    .replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"')
+    .replace(/&#0?39;/g, "'").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&");
+}
+
 /**
  * Image / media field value as stored and returned verbatim by the Delivery API
  * (server-normalized on write to the canonical shape). \`url\` is always present; an
@@ -68,6 +182,45 @@ export interface BetterCMSImage {
   readonly height?: number;
 }
 
+/**
+ * A component slot's value, as stored and delivered.
+ *
+ * \`componentId\` points at a component definition; \`overrides\` are the author's values,
+ * keyed by the component's declared prop keys.
+ *
+ * \`resolved\` is the SNAPSHOT: at publish time the component is resolved (its block tree
+ * with the overrides applied) and frozen onto the published value. That is why editing a
+ * component does not silently rewrite entries that were already published \u2014 a published
+ * entry carries what it was published with until it is published again.
+ *
+ * Read \`resolved\` when it is there; it is absent on draft-perspective reads, where you
+ * should resolve \`componentId\` yourself against the components endpoint.
+ */
+export interface BetterCMSComponentRef {
+  readonly componentId: string;
+  readonly overrides?: Readonly<Record<string, unknown>>;
+  readonly resolved?: readonly unknown[];
+}
+
+/**
+ * One block in a section zone, as stored and delivered.
+ *
+ * This is the SAME shape a page's \`blockJson\` holds \u2014 a section zone is a composable page
+ * region, so it delivers page blocks, not a shape of its own. Deliberately structural rather
+ * than a discriminated union over every block type: the container blocks
+ * (\`columns\`, \`section\`, \`slider\`, \`tabs\`) nest \`BetterCMSBlock\` inside \`props\`,
+ * and the block vocabulary is server-side and versioned independently of any generated SDK.
+ * Narrow on \`type\` at the call site.
+ *
+ * \`style\` carries the block's design tokens when the author set any.
+ */
+export interface BetterCMSBlock {
+  readonly type: string;
+  readonly id: string;
+  readonly props?: Readonly<Record<string, unknown>>;
+  readonly style?: Readonly<Record<string, unknown>>;
+}
+
 /**
  * Delivery envelope around a model's typed \`data\`. \`getEntry\`/\`listEntries\` in the
  * Next adapter return this shape, with \`fields\` typed by the model.
@@ -78,6 +231,54 @@ export interface BetterCMSEntry<TFields> {
   readonly fields: TFields;
   readonly updatedAt: string;
 }
+
+/** Fully resolved published or preview Layout returned beside a delivered page. */
+export interface BetterCMSLayout {
+  readonly version: 1;
+  readonly nodes: ReadonlyArray<
+    | { readonly kind: "page-content"; readonly id: "page-content" }
+    | {
+        readonly kind: "section";
+        readonly id: string;
+        readonly slug: string;
+        readonly name: string;
+        readonly source: "inherit" | "override-content" | "customize-structure" | "page-only" | "detached";
+      }
+  >;
+  readonly sections: Readonly<Record<string, {
+    readonly id: string;
+    readonly slug: string;
+    readonly name: string;
+    /** Headless Section values, including values represented by direct field items. */
+    readonly fields: Readonly<Record<string, unknown>>;
+    readonly items: ReadonlyArray<
+      | { readonly id: string; readonly kind: "field"; readonly fieldId: string; readonly value: unknown }
+      | {
+          readonly id: string;
+          readonly kind: "component";
+          readonly componentId: string;
+          readonly variantGroupId?: string;
+          readonly canonicalInputs: readonly BetterCMSLayoutInput[];
+          readonly bindings: ReadonlyArray<{ readonly inputId: string; readonly fieldId: string }>;
+          readonly canonicalValues: Readonly<Record<string, unknown>>;
+          readonly resolvedProps: Readonly<Record<string, unknown>>;
+          readonly blocks: readonly unknown[];
+        }
+    >;
+  }>>;
+}
+
+/** Recursive canonical input description exposed with each delivered Component item. */
+export interface BetterCMSLayoutInput {
+  readonly id: string;
+  readonly slug: string;
+  readonly label: string;
+  readonly type: string;
+  readonly required?: boolean;
+  readonly defaultValue?: unknown;
+  readonly config?: Readonly<Record<string, unknown>>;
+  readonly fields?: readonly BetterCMSLayoutInput[];
+}
 `;
 function pascalCase(slug) {
   const parts = slug.split(/[-_\s]+/).filter(Boolean);
@@ -97,6 +298,10 @@ function scalarType(field) {
     case "text":
       return "string";
     case "richtext":
+    // A document field stores the SAME {format, value, html} envelope as richtext — the
+    // difference is the editor and the placement, not the wire shape. So it maps to the same
+    // generated type, and the `doc` rendition lands on `RichText` itself rather than here.
+    case "document":
       return "RichText";
     case "image":
       return "BetterCMSImage";
@@ -115,7 +320,12 @@ function scalarType(field) {
     case "reference":
       return "string";
     // referenced entry id
+    // Both spellings are live (see ContentModelFieldType). Template- and Webflow-seeded
+    // models carry the camelCase one; until it was handled here it fell through to the
+    // exhaustiveness default, so generated types for every template-created collection
+    // typed this field as `unknown` instead of `string[]`.
     case "multi-reference":
+    case "multiReference":
       return "string[]";
     // referenced entry ids
     case "array": {
@@ -123,6 +333,35 @@ function scalarType(field) {
       const inner = itemType === "number" ? "number" : "string";
       return `${inner}[]`;
     }
+    // ── Builder scalars ────────────────────────────────────────────────────────
+    // All string-shaped on the wire; each is value-validated on write (see
+    // src/lib/content/reference-validation.ts), so the generated type is the
+    // narrowest thing that is actually true of the stored value.
+    case "longtext":
+    case "slug":
+    case "email":
+    case "phone":
+    case "link":
+    case "color":
+      return "string";
+    case "json":
+      return "unknown";
+    case "component-ref":
+      return "BetterCMSComponentRef";
+    case "modular":
+      return "ReadonlyArray<{ readonly __id: string; readonly __type: string; readonly data: Record<string, unknown> }>";
+    case "sections": {
+      const config = field.config;
+      const unresolvedLegacy = config?.mode === "authored-v2" && Object.prototype.hasOwnProperty.call(config, "allowedSections") && config.legacyResolved !== true;
+      if (config?.mode === "authored-v2" && !unresolvedLegacy) {
+        return "ReadonlyArray<{ readonly __id: string; readonly __section: string; readonly __type: string; readonly data: Record<string, unknown> }>";
+      }
+      return "ReadonlyArray<BetterCMSBlock>";
+    }
+    case "location":
+      return "{ readonly lat: number; readonly lng: number; readonly label?: string }";
+    case "file":
+      return "BetterCMSImage";
     default: {
       const _exhaustive = t;
       return "unknown";
@@ -227,6 +466,8 @@ function bindingKind(t) {
     case "select":
     case "array":
       return t;
+    case "document":
+      return "richtext";
     // reference / multi-reference / date / datetime → plain text in the editor v1.
     default:
       return "text";
@@ -277,27 +518,12 @@ function fieldsToBindings(fields, indent) {
   return fields.map((field) => fieldBinding(field, "", indent)).join("\n");
 }
 var PREAMBLE2 = `/**
- * True when this site is built for Live Preview annotation. Set \`BCMS_ANNOTATE=1\`
- * in the preview build only; unset (the default) ships zero binding attributes.
- * Read defensively so the module is safe in any runtime (browser, Node, edge).
- */
-const BCMS_ANNOTATE: boolean = (() => {
-  try {
-    const v = (globalThis as { process?: { env?: Record<string, string | undefined> } })
-      .process?.env?.BCMS_ANNOTATE;
-    return v != null && v !== "" && v !== "0" && v !== "false";
-  } catch {
-    return false;
-  }
-})();
-
-/**
  * Binding attributes for a CMS-bound element. Spread onto the element that renders a
- * field: \`<h1 {...bcmsField("title", "text")}>\`. Returns \`{}\` unless BCMS_ANNOTATE
- * is set, so production markup is untouched.
+ * field: \`<h1 {...bcmsField("title", "text")}>\`. Always emitted, on every build \u2014
+ * two inert \`data-*\` attributes are what makes the site editable in Live Preview.
  */
 export function bcmsField(path: string, kind: string): Record<string, string> {
-  return BCMS_ANNOTATE ? { "data-bcms-field": path, "data-bcms-kind": kind } : {};
+  return { "data-bcms-field": path, "data-bcms-kind": kind };
 }
 `;
 function generateBindings(models, opts = {}) {
@@ -308,7 +534,7 @@ function generateBindings(models, opts = {}) {
   const header = `// \u26A0\uFE0F  AUTO-GENERATED by @bettercms-ai/codegen v${version} \u2014 DO NOT EDIT.
 // Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>
 // Spread these onto the elements that render your content; they emit
-// data-bcms-field/data-bcms-kind only when the site is built with BCMS_ANNOTATE set.
+// data-bcms-field/data-bcms-kind on every build.
 ${opts.bannerComment ? `// ${opts.bannerComment}
 ` : ""}`;
   const entries = sorted.map((model) => {
@@ -344,6 +570,12 @@ export type RichTextValue = {
   readonly format: string;
   readonly value: unknown;
   readonly html?: string;
+  /**
+   * Structured blocks \u2014 Body (\`document\`) fields only, and optional even there: derived at
+   * write time, so entries saved before it existed carry none until re-saved. No backfill.
+   * Block ids are stable within one document only, never a global key.
+   */
+  readonly doc?: { readonly version: 1; readonly blocks: readonly { readonly id: string; readonly type: string; readonly [k: string]: unknown }[] };
 };
 
 /** Normalized image/media value from the Delivery API. */

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/fetch-models.ts","../src/generate.ts","../src/bindings.ts","../src/components.ts"],"sourcesContent":["/**\n * `bettercms-codegen` — fetch a project's content models and write a typed `.ts` file.\n *\n * Designed for two call sites:\n *   1. A developer in their repo:  npx @bettercms-ai/codegen --out src/bettercms.generated.ts\n *   2. The build-time GitHub Action: same command, key from a repo secret.\n *\n * Auth + endpoint come from flags or env (BETTERCMS_API_KEY, BETTERCMS_API_URL).\n */\n\nimport { writeFile, mkdir } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\nimport { fetchModels } from \"./fetch-models.js\";\nimport { generateTypes } from \"./generate.js\";\nimport { generateBindings } from \"./bindings.js\";\nimport { generateComponents } from \"./components.js\";\n\nconst VERSION = \"0.2.0\";\nconst DEFAULT_API_URL = \"https://api.bettercms.ai/api/v1\";\nconst DEFAULT_OUT = \"bettercms.generated.ts\";\n\ninterface CliArgs {\n  apiUrl: string;\n  apiKey: string | undefined;\n  out: string;\n  /** When set, also emit the Live Preview bindings module to this path. */\n  bindingsOut: string | undefined;\n  /** When set, also emit the typed React render components (.tsx) to this path. */\n  componentsOut: string | undefined;\n  help: boolean;\n}\n\nfunction parseArgs(argv: string[]): CliArgs {\n  const args: CliArgs = {\n    apiUrl: process.env.BETTERCMS_API_URL ?? DEFAULT_API_URL,\n    apiKey: process.env.BETTERCMS_API_KEY,\n    out: DEFAULT_OUT,\n    bindingsOut: undefined,\n    componentsOut: undefined,\n    help: false,\n  };\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n    const next = () => argv[++i];\n    switch (arg) {\n      case \"--api-url\":\n        args.apiUrl = next() ?? args.apiUrl;\n        break;\n      case \"--key\":\n      case \"--api-key\":\n        args.apiKey = next();\n        break;\n      case \"--out\":\n      case \"-o\":\n        args.out = next() ?? args.out;\n        break;\n      case \"--bindings-out\":\n        args.bindingsOut = next();\n        break;\n      case \"--components-out\":\n        args.componentsOut = next();\n        break;\n      case \"--help\":\n      case \"-h\":\n        args.help = true;\n        break;\n    }\n  }\n  return args;\n}\n\nconst HELP = `bettercms-codegen v${VERSION} — generate TypeScript types from your BetterCMS schema\n\nUsage:\n  npx @bettercms-ai/codegen [options]\n\nOptions:\n  -o, --out <path>      Output file (default: ${DEFAULT_OUT})\n      --bindings-out <path>  Also emit the Live Preview bindings module to <path>\n      --components-out <path>  Also emit typed <RichText>/<Image> React components (.tsx) to <path>\n      --api-url <url>   Management API base (default: ${DEFAULT_API_URL})\n      --key <key>       Management API key (or set BETTERCMS_API_KEY)\n  -h, --help            Show this help\n\nEnv:\n  BETTERCMS_API_KEY     Management-scoped key (content:manage)\n  BETTERCMS_API_URL     Override the API base\n`;\n\nasync function main(): Promise<void> {\n  const args = parseArgs(process.argv.slice(2));\n\n  if (args.help) {\n    process.stdout.write(HELP);\n    return;\n  }\n  if (!args.apiKey) {\n    process.stderr.write(\n      \"error: no API key. Pass --key <key> or set BETTERCMS_API_KEY.\\n\",\n    );\n    process.exit(1);\n  }\n\n  const models = await fetchModels({ apiUrl: args.apiUrl, apiKey: args.apiKey });\n\n  const outPath = resolve(process.cwd(), args.out);\n  await mkdir(dirname(outPath), { recursive: true });\n  await writeFile(outPath, generateTypes(models, { version: VERSION }), \"utf8\");\n\n  const plural = models.length === 1 ? \"\" : \"s\";\n  process.stdout.write(\n    `✓ Generated ${models.length} model type${plural} → ${args.out}\\n`,\n  );\n\n  if (args.bindingsOut) {\n    const bindingsPath = resolve(process.cwd(), args.bindingsOut);\n    await mkdir(dirname(bindingsPath), { recursive: true });\n    await writeFile(bindingsPath, generateBindings(models, { version: VERSION }), \"utf8\");\n    process.stdout.write(`✓ Generated Live Preview bindings → ${args.bindingsOut}\\n`);\n  }\n\n  if (args.componentsOut) {\n    const componentsPath = resolve(process.cwd(), args.componentsOut);\n    await mkdir(dirname(componentsPath), { recursive: true });\n    await writeFile(componentsPath, generateComponents({ version: VERSION }), \"utf8\");\n    process.stdout.write(`✓ Generated render components → ${args.componentsOut}\\n`);\n  }\n}\n\nmain().catch((err: unknown) => {\n  process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\\n`);\n  process.exit(1);\n});\n","/**\n * Fetches content models from the BetterCMS Management API so the CLI can generate\n * types against a live project. Kept dependency-free (plain fetch) so the generated\n * artifact and this fetcher can run anywhere — a GitHub Action, a postinstall, a script.\n */\n\nimport type { GeneratableModel } from \"./generate.js\";\n\nexport interface FetchModelsOptions {\n  /** Management API base, e.g. \"https://api.bettercms.ai/api/v1\". */\n  apiUrl: string;\n  /** A management-scoped key (content:manage) or device-minted token. */\n  apiKey: string;\n  /** Optional fetch override (testing / custom runtime). */\n  fetchImpl?: typeof fetch;\n}\n\ninterface ManagedModelRow {\n  slug: string;\n  name?: string;\n  description?: string | null;\n  fields: GeneratableModel[\"fields\"];\n}\n\n/**\n * GET /management/content/models — returns the project's models (the key is\n * project-scoped server-side, so this is exactly the schema for this site).\n */\nexport async function fetchModels(\n  opts: FetchModelsOptions,\n): Promise<GeneratableModel[]> {\n  const doFetch = opts.fetchImpl ?? globalThis.fetch;\n  const base = opts.apiUrl.replace(/\\/+$/, \"\");\n  const url = `${base}/management/content/models`;\n\n  let res: Response;\n  try {\n    res = await doFetch(url, {\n      // No Content-Type: this is a bodyless GET; the header is incorrect here and\n      // strict edge runtimes/proxies may reject it.\n      headers: { Authorization: `Bearer ${opts.apiKey}`, Accept: \"application/json\" },\n    });\n  } catch (err) {\n    throw new Error(\n      `Could not reach the BetterCMS Management API at ${url}: ${\n        err instanceof Error ? err.message : String(err)\n      }`,\n    );\n  }\n\n  if (!res.ok) {\n    const hint =\n      res.status === 401 || res.status === 403\n        ? \" — check your management API key (it must have the content:manage scope).\"\n        : \"\";\n    throw new Error(`Management API returned ${res.status} ${res.statusText}${hint}`);\n  }\n\n  const body = (await res.json()) as { data?: ManagedModelRow[] };\n  const rows = body.data ?? [];\n  return rows.map((r) => ({\n    slug: r.slug,\n    name: r.name,\n    description: r.description ?? null,\n    fields: r.fields ?? [],\n  }));\n}\n","/**\n * @bettercms-ai/codegen — schema → TypeScript generator (the single source of truth).\n *\n * Both the dashboard schema builder and the MCP `create_model`/`add_field` tools write\n * the SAME `content_models.fields` (an array of `ContentModelField`). This generator maps\n * that one array into TypeScript. Because there is exactly one schema representation, the\n * generated types can never drift from the editor or the agent — they are the same source.\n *\n * Pure + deterministic: same models in → identical string out (stable ordering, no clock,\n * no I/O). That makes it trivially testable and safe to commit + diff in a customer repo.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\n\n/** Minimal model shape the generator needs — a subset of the Management API model row. */\nexport interface GeneratableModel {\n  /** Machine-safe slug, e.g. \"blog\" or \"case-study\". Used for the schema-map key. */\n  slug: string;\n  /** Human name, used only for the JSDoc header. */\n  name?: string;\n  description?: string | null;\n  fields: ContentModelField[];\n}\n\nexport interface GenerateOptions {\n  /** Generator version stamped into the header (defaults to the package version). */\n  version?: string;\n  /** Override the banner timestamp source — omitted by default so output is deterministic. */\n  bannerComment?: string;\n}\n\n/** Helper types emitted once at the top of every generated file (self-contained, zero-dep). */\nconst PREAMBLE = `/**\n * Rich-text field value returned by the Delivery API.\n *\n * - \\`format\\`/\\`value\\`: the portable, editor-agnostic payload (Lexical EditorState) —\n *   render it with your editor's serializer for full fidelity.\n * - \\`html\\`: server-rendered, sanitized HTML (computed render-on-write). Present on\n *   Delivery reads; the simplest path for non-React consumers — safe to inject directly\n *   (e.g. \\`dangerouslySetInnerHTML\\`). Optional: legacy/un-normalized values may omit it.\n *\n * The \\`{ format, value }\\` contract is unchanged; \\`html\\` is additive.\n */\nexport type RichText = {\n  readonly format: string;\n  readonly value: unknown;\n  readonly html?: string;\n};\n\n/**\n * Image / media field value as stored and returned verbatim by the Delivery API\n * (server-normalized on write to the canonical shape). \\`url\\` is always present; an\n * unresolved/external value may carry only \\`url\\`. \\`altText\\` is the accessibility text\n * for \\`<img alt>\\`.\n */\nexport interface BetterCMSImage {\n  readonly id?: string;\n  readonly url: string;\n  readonly name?: string;\n  readonly altText?: string | null;\n  readonly width?: number;\n  readonly height?: number;\n}\n\n/**\n * Delivery envelope around a model's typed \\`data\\`. \\`getEntry\\`/\\`listEntries\\` in the\n * Next adapter return this shape, with \\`fields\\` typed by the model.\n */\nexport interface BetterCMSEntry<TFields> {\n  readonly slug: string;\n  readonly status: \"draft\" | \"published\";\n  readonly fields: TFields;\n  readonly updatedAt: string;\n}\n`;\n\n/** PascalCase an identifier from a slug: \"case-study\" → \"CaseStudy\". */\nfunction pascalCase(slug: string): string {\n  const parts = slug.split(/[-_\\s]+/).filter(Boolean);\n  const pascal = parts\n    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))\n    .join(\"\");\n  // Guard against an identifier that starts with a digit (invalid TS type name).\n  return /^[0-9]/.test(pascal) ? `Model${pascal}` : pascal || \"Model\";\n}\n\n/**\n * Make a string safe to embed inside a `/** ... *​/` JSDoc comment. A field label\n * (free-text, author/agent-controlled) could contain `*​/` — which closes the comment\n * early and injects the remainder as code — or a newline, which breaks the single-line\n * comment. Both are neutralized here. Without this, hostile content produces non-\n * compiling (or worse, code-injected) output.\n */\nfunction escapeJsDoc(text: string): string {\n  return text.replace(/\\*\\//g, \"* /\").replace(/[\\r\\n]+/g, \" \").trim();\n}\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as a TS property name. Field keys are author/agent-controlled and\n * not guaranteed to be valid identifiers (e.g. \"my-field\", \"1title\", \"\"), so anything\n * that isn't a bare identifier is emitted as a quoted property name — always valid TS.\n */\nfunction propName(key: string): string {\n  return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/** A scalar/primitive field maps to a TS type expression (no nesting). */\nfunction scalarType(field: ContentModelField): string {\n  const t: ContentModelFieldType = field.type;\n  switch (t) {\n    case \"text\":\n      return \"string\";\n    case \"richtext\":\n      return \"RichText\";\n    case \"image\":\n      return \"BetterCMSImage\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"number\":\n      return \"number\";\n    case \"date\":\n    case \"datetime\":\n      return \"string\"; // ISO 8601\n    case \"select\": {\n      const opts = field.options?.filter((o) => typeof o === \"string\") ?? [];\n      return opts.length > 0\n        ? opts.map((o) => JSON.stringify(o)).join(\" | \")\n        : \"string\";\n    }\n    case \"reference\":\n      return \"string\"; // referenced entry id\n    case \"multi-reference\":\n      return \"string[]\"; // referenced entry ids\n    case \"array\": {\n      // Zoned arrays (config.zones) are expanded by fieldsToBody before reaching here;\n      // this branch handles only the primitive list form (config.itemType).\n      const itemType = field.config?.itemType ?? \"text\";\n      const inner =\n        itemType === \"number\" ? \"number\" : \"string\"; // text | date → string\n      return `${inner}[]`;\n    }\n    default: {\n      // Exhaustiveness guard: if a new field type is added to the union and not\n      // mapped here, this line becomes a compile error in the codegen build.\n      const _exhaustive: never = t;\n      return \"unknown\";\n    }\n  }\n}\n\n/**\n * Render the TS type for a zoned `array` field: an object with optional\n * `nonRepeatable` (a fixed block) and/or `repeatable` (a list of blocks). Recurses\n * through zone fields, so a zone field that is itself a zoned `array` nests naturally.\n */\nfunction arrayZoneType(field: ContentModelField, indent: string): string {\n  const zones = field.config?.zones;\n  const parts: string[] = [];\n  if (zones?.nonRepeatable?.length) {\n    const nested = fieldsToBody(zones.nonRepeatable, indent + \"  \");\n    parts.push(`${indent}  readonly nonRepeatable?: {\\n${nested}\\n${indent}  };`);\n  }\n  if (zones?.repeatable?.fields?.length) {\n    const nested = fieldsToBody(zones.repeatable.fields, indent + \"    \");\n    parts.push(`${indent}  readonly repeatable?: Array<{\\n${nested}\\n${indent}  }>;`);\n  }\n  if (parts.length === 0) return \"Record<string, unknown>\"; // zoned array with no fields yet\n  return `{\\n${parts.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the body of an object type from a field list, recursing into zones. */\nfunction fieldsToBody(fields: ContentModelField[], indent: string): string {\n  const lines: string[] = [];\n  for (const field of fields) {\n    const optional = field.required ? \"\" : \"?\";\n    let typeExpr: string;\n\n    if (field.type === \"array\" && field.config?.zones) {\n      typeExpr = arrayZoneType(field, indent);\n    } else {\n      typeExpr = scalarType(field);\n    }\n\n    const safeLabel = field.label ? escapeJsDoc(field.label) : \"\";\n    if (safeLabel && safeLabel !== field.key) {\n      lines.push(`${indent}/** ${safeLabel} */`);\n    }\n    lines.push(`${indent}readonly ${propName(field.key)}${optional}: ${typeExpr};`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generate a complete `.ts` module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateTypes(\n  models: GeneratableModel[],\n  opts: GenerateOptions = {},\n): string {\n  const version = opts.version ?? \"0.1.0\";\n  // Code-unit sort (NOT localeCompare): locale/ICU-independent so the generated\n  // file is byte-identical on every machine — committed output diffs cleanly.\n  const sorted = [...models].sort((a, b) =>\n    a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n  );\n\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen\n// Source of truth: your BetterCMS content models (the same schema the dashboard\n// builder and the MCP tools write). Re-run codegen after any schema change.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const interfaces: string[] = [];\n  const mapEntries: string[] = [];\n  // Different slugs can PascalCase to the same base name (e.g. \"case-study\" and\n  // \"case_study\" → \"CaseStudy\"). Emitting two identical interfaces would silently\n  // declaration-merge into one wrong type, so disambiguate with a numeric suffix.\n  const usedNames = new Set<string>();\n\n  for (const model of sorted) {\n    const base = `${pascalCase(model.slug)}Fields`;\n    let typeName = base;\n    for (let n = 2; usedNames.has(typeName); n++) typeName = `${base}_${n}`;\n    usedNames.add(typeName);\n\n    const name = model.name ? escapeJsDoc(model.name) : \"\";\n    const desc = model.description ? escapeJsDoc(model.description) : \"\";\n    const doc = name\n      ? `/**\\n * ${name}${desc ? ` — ${desc}` : \"\"}\\n * Model slug: \\`${model.slug}\\`\\n */\\n`\n      : \"\";\n    const body = model.fields.length\n      ? fieldsToBody(model.fields, \"  \")\n      : \"  // (no fields defined yet)\";\n    interfaces.push(`${doc}export interface ${typeName} {\\n${body}\\n}`);\n    mapEntries.push(`  readonly ${JSON.stringify(model.slug)}: ${typeName};`);\n  }\n\n  const schemaMap = `/**\n * Registry mapping each model slug to its typed fields. The Next adapter uses this to\n * type \\`getEntry(\"blog\", ...)\\` by slug — autocomplete and exhaustiveness for free.\n */\nexport interface BetterCMSSchema {\n${mapEntries.join(\"\\n\") || \"  // (no models defined yet)\"}\n}\n\n/** Union of all model slugs. */\nexport type BetterCMSModelSlug = keyof BetterCMSSchema;`;\n\n  return [header, PREAMBLE, interfaces.join(\"\\n\\n\"), schemaMap, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → Live Preview binding helper generator.\n *\n * Companion to {@link generateTypes}. Where that emits the *types*, this emits a\n * tiny, schema-derived runtime that stamps `data-bcms-field` / `data-bcms-kind`\n * attributes onto the elements a site author binds to CMS content. Those\n * attributes are what the dashboard's Live Preview editor reads to turn the real,\n * running site into an editable canvas (the parent maps `data-bcms-field` → its\n * internal `data-node-id` on frame load).\n *\n * Why a helper and not auto-injection: BetterCMS never renders the customer's DOM\n * — the site does. So binding is opt-in per element via a spread:\n *\n *   import { bcms } from \"./bettercms.bindings.generated\";\n *\n *   <h1 {...bcms.blog.title}>{entry.fields.title}</h1>          // scalar\n *   <li {...bcms.blog.tags.value(i)}>{tag}</li>                 // primitive-array item\n *   <article {...bcms.blog.features.$(i)}>                      // array item root\n *     <h3 {...bcms.blog.features.label(i)}>{f.label}</h3>       // array item sub-field\n *   </article>\n *\n * The attributes only appear when the site is built with `BCMS_ANNOTATE` set\n * (preview builds); a normal production build ships zero extra attributes, because\n * `bcmsField` returns `{}`. Same generated file, both builds — no separate mode.\n *\n * Pure + deterministic, exactly like the type generator: same models in → identical\n * string out (slug-sorted, field order preserved, no clock, no I/O). Field keys are\n * author/agent-controlled, so every embedded key is emitted as an escaped string\n * literal (never interpolated into code) — hostile input can't break the output.\n *\n * Grammar — mirrors what the editor's `fieldPathToNodeId` resolves:\n *   `title` · `hero.heroTitle` · `hero.primaryCta.label`         (group leaves, any depth)\n *   `features[0]` · `features[0].label` · `intro.facts[0].label` (repeaters, one index)\n * Group (non-repeatable) zones recurse into nested binding objects; a repeater is an\n * object with `$(i)` (item root) + one accessor per scalar sub-field. Arrays nested\n * inside a repeater item (a second index) are still beyond what the editor can\n * address, so they are intentionally omitted rather than emitted as dead paths.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\nimport type { GeneratableModel, GenerateOptions } from \"./generate.js\";\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as an object property name. Keys aren't guaranteed to be valid\n * identifiers (e.g. \"my-field\", \"1title\"), so anything that isn't a bare identifier\n * is quoted — always valid TS. (Mirrors the same helper in `generate.ts`.)\n */\nfunction propName(key: string): string {\n  return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/**\n * The kind label written to `data-bcms-kind`, mapped to the editor's closed field-type\n * set (matches the dashboard adapter's `toEditorFieldType`): API-only types that have\n * no on-canvas control collapse to \"text\". Informational today — the editor derives the\n * authoritative kind from the loaded model — but kept truthful for debugging/forward use.\n */\nfunction bindingKind(t: ContentModelFieldType): string {\n  switch (t) {\n    case \"text\":\n    case \"richtext\":\n    case \"image\":\n    case \"boolean\":\n    case \"number\":\n    case \"select\":\n    case \"array\":\n      return t;\n    // reference / multi-reference / date / datetime → plain text in the editor v1.\n    default:\n      return \"text\";\n  }\n}\n\n/**\n * Build a runtime path expression for an array element: a string literal split around\n * the index so it concatenates at call time. Both halves are JSON-escaped, so an\n * author-controlled key can never inject code. e.g. (\"features[\", \"].label\") →\n * `\"features[\" + i + \"].label\"`.\n */\nfunction indexedPath(prefix: string, suffix: string): string {\n  return `${JSON.stringify(prefix)} + i + ${JSON.stringify(suffix)}`;\n}\n\n/** Render a repeater binding object: `$(i)` item root + one accessor per scalar\n *  sub-field. `path` is the repeater's full (possibly dotted) field path. */\nfunction repeaterBinding(\n  itemFields: ContentModelField[],\n  path: string,\n  indent: string,\n): string {\n  const lines: string[] = [\n    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n  ];\n  for (const sub of itemFields) {\n    // A sub-field that is itself an array would need a second index the editor\n    // can't address yet — skip it rather than emit a path that won't bind.\n    if (sub.type === \"array\") continue;\n    lines.push(\n      `${indent}  ${propName(sub.key)}: (i: number) => bcmsField(${indexedPath(`${path}[`, `].${sub.key}`)}, ${JSON.stringify(bindingKind(sub.type))}),`,\n    );\n  }\n  return `{\\n${lines.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the binding for one field at `path`, recursing into group zones. */\nfunction fieldBinding(\n  field: ContentModelField,\n  prefix: string,\n  indent: string,\n): string {\n  const path = prefix ? `${prefix}.${field.key}` : field.key;\n  const name = propName(field.key);\n\n  if (field.type !== \"array\") {\n    return `${indent}${name}: bcmsField(${JSON.stringify(path)}, ${JSON.stringify(bindingKind(field.type))}),`;\n  }\n\n  const zones = field.config?.zones;\n  // Group (non-repeatable) → a nested object of dotted-path leaf bindings.\n  if (zones?.nonRepeatable?.length) {\n    const body = zones.nonRepeatable\n      .map((child) => fieldBinding(child, path, `${indent}  `))\n      .join(\"\\n\");\n    return `${indent}${name}: {\\n${body}\\n${indent}},`;\n  }\n  // Repeater → `$(i)` + scalar sub-field accessors.\n  if (zones?.repeatable?.fields?.length) {\n    return `${indent}${name}: ${repeaterBinding(zones.repeatable.fields, path, indent)},`;\n  }\n  // Primitive list (`config.itemType` or bare) → `$(i)` + synthetic `value(i)`.\n  const lines = [\n    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n    `${indent}  value: (i: number) => bcmsField(${indexedPath(`${path}[`, \"].value\")}, \"text\"),`,\n  ];\n  return `${indent}${name}: {\\n${lines.join(\"\\n\")}\\n${indent}},`;\n}\n\n/** Render the binding entries for one model's fields (field order preserved). */\nfunction fieldsToBindings(fields: ContentModelField[], indent: string): string {\n  return fields.map((field) => fieldBinding(field, \"\", indent)).join(\"\\n\");\n}\n\n/** The self-contained runtime emitted once at the top of every bindings file. */\nconst PREAMBLE = `/**\n * True when this site is built for Live Preview annotation. Set \\`BCMS_ANNOTATE=1\\`\n * in the preview build only; unset (the default) ships zero binding attributes.\n * Read defensively so the module is safe in any runtime (browser, Node, edge).\n */\nconst BCMS_ANNOTATE: boolean = (() => {\n  try {\n    const v = (globalThis as { process?: { env?: Record<string, string | undefined> } })\n      .process?.env?.BCMS_ANNOTATE;\n    return v != null && v !== \"\" && v !== \"0\" && v !== \"false\";\n  } catch {\n    return false;\n  }\n})();\n\n/**\n * Binding attributes for a CMS-bound element. Spread onto the element that renders a\n * field: \\`<h1 {...bcmsField(\"title\", \"text\")}>\\`. Returns \\`{}\\` unless BCMS_ANNOTATE\n * is set, so production markup is untouched.\n */\nexport function bcmsField(path: string, kind: string): Record<string, string> {\n  return BCMS_ANNOTATE ? { \"data-bcms-field\": path, \"data-bcms-kind\": kind } : {};\n}\n`;\n\n/**\n * Generate the Live Preview bindings module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateBindings(\n  models: GeneratableModel[],\n  opts: GenerateOptions = {},\n): string {\n  const version = opts.version ?? \"0.1.0\";\n  // Code-unit sort (NOT localeCompare) so output is byte-identical on every machine.\n  const sorted = [...models].sort((a, b) =>\n    a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n  );\n\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>\n// Spread these onto the elements that render your content; they emit\n// data-bcms-field/data-bcms-kind only when the site is built with BCMS_ANNOTATE set.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const entries = sorted.map((model) => {\n    const body = model.fields.length\n      ? `\\n${fieldsToBindings(model.fields, \"    \")}\\n  `\n      : \"\";\n    return `  ${JSON.stringify(model.slug)}: {${body}},`;\n  });\n\n  const bcms = `/**\n * Field bindings keyed by model slug. Spread a binding onto the element that renders\n * that field. Arrays expose \\`$(i)\\` for the item element and one accessor per\n * (one-level) sub-field; primitive arrays expose \\`value(i)\\` for the item's scalar.\n */\nexport const bcms = {\n${entries.join(\"\\n\") || \"  // (no models defined yet)\"}\n} as const;`;\n\n  return [header, PREAMBLE, bcms, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → typed React render components generator.\n *\n * Companion to {@link generateTypes} (types) and {@link generateBindings} (Live\n * Preview attributes). This emits a small, self-contained `.tsx` module with two\n * components that render the canonical Delivery field shapes CORRECTLY, so authors\n * never hand-roll the rendering that produces the classic bugs:\n *\n *   - <RichText> renders the server-sanitized `html` via `dangerouslySetInnerHTML`,\n *     instead of interpolating the value as a JSX child (which React escapes, so the\n *     page shows literal `<p>…</p>` tags — the #6 escaped-richtext bug).\n *   - <Image> reads the normalized image object's `.url`/`.altText`, instead of\n *     treating the object as a string.\n *\n * The emitted module is intentionally generic (not per-model) and dependency-free\n * beyond React, so it is a drop-in: point codegen at a path and import the two\n * components. It is deterministic (no clock, no I/O) like the sibling generators.\n *\n * Security: `html` is the Delivery API's server-rendered, DOMPurify-sanitized output\n * (see the RichText type docs). `<RichText>` injects exactly that field. If a caller\n * passes HTML from another, untrusted source they must sanitize it themselves.\n */\n\nimport type { GenerateOptions } from \"./generate.js\";\n\n/**\n * Generate the `bettercms.components.tsx` module: typed `<RichText>` and `<Image>`\n * components for the canonical Delivery field shapes. Deterministic — same options\n * in, identical string out.\n */\nexport function generateComponents(opts: GenerateOptions = {}): string {\n  const version = opts.version ?? \"0.1.0\";\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen --components-out <path>\n// Typed render components for BetterCMS field shapes. Use these instead of\n// hand-rendering richtext/image values — they render the canonical shapes correctly.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const body = `import * as React from \"react\";\n\n/** Rich-text value from the Delivery API. \\`html\\` is server-rendered + sanitized. */\nexport type RichTextValue = {\n  readonly format: string;\n  readonly value: unknown;\n  readonly html?: string;\n};\n\n/** Normalized image/media value from the Delivery API. */\nexport interface BetterCMSImageValue {\n  readonly url: string;\n  readonly altText?: string | null;\n  readonly width?: number;\n  readonly height?: number;\n}\n\ntype RichTextProps = {\n  /** The richtext field value (\\`entry.fields.someRichText\\`). */\n  field?: RichTextValue | null;\n  /** Element/component to render as. Default: \\`\"div\"\\`. */\n  as?: React.ElementType;\n} & Omit<React.HTMLAttributes<HTMLElement>, \"dangerouslySetInnerHTML\" | \"children\">;\n\n/**\n * Render a richtext field as HTML. Uses the server-sanitized \\`html\\` via\n * \\`dangerouslySetInnerHTML\\` — NEVER interpolate a richtext value as a JSX child\n * (React escapes it, so the page shows literal tags). Renders nothing when unset.\n */\nexport function RichText({ field, as: Tag = \"div\", ...rest }: RichTextProps) {\n  if (!field || !field.html) return null;\n  return <Tag {...rest} dangerouslySetInnerHTML={{ __html: field.html }} />;\n}\n\ntype ImageProps = {\n  /** The image field value (\\`entry.fields.someImage\\`). */\n  field?: BetterCMSImageValue | null;\n  /** Alt text override; defaults to the field's \\`altText\\`, then \\`\"\"\\`. */\n  alt?: string;\n} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, \"src\">;\n\n/**\n * Render an image field as an \\`<img>\\` from its normalized \\`.url\\`/\\`.altText\\`.\n * Renders nothing when unset. Pass \\`alt\\` to override the stored alt text.\n */\nexport function Image({ field, alt, ...rest }: ImageProps) {\n  if (!field || !field.url) return null;\n  return (\n    <img\n      src={field.url}\n      alt={alt ?? field.altText ?? \"\"}\n      width={field.width}\n      height={field.height}\n      {...rest}\n    />\n  );\n}\n`;\n\n  return [header, body].join(\"\\n\");\n}\n"],"mappings":"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","names":["VALID_IDENT","propName","PREAMBLE"]}
+{"version":3,"sources":["../src/cli.ts","../src/fetch-models.ts","../src/generate.ts","../src/bindings.ts","../src/components.ts"],"sourcesContent":["/**\n * `bettercms-codegen` — fetch a project's content models and write a typed `.ts` file.\n *\n * Designed for two call sites:\n *   1. A developer in their repo:  npx @bettercms-ai/codegen --out src/bettercms.generated.ts\n *   2. The build-time GitHub Action: same command, key from a repo secret.\n *\n * Auth + endpoint come from flags or env (BETTERCMS_API_KEY, BETTERCMS_API_URL).\n */\n\nimport { writeFile, mkdir } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\nimport { fetchModels } from \"./fetch-models.js\";\nimport { generateTypes } from \"./generate.js\";\nimport { generateBindings } from \"./bindings.js\";\nimport { generateComponents } from \"./components.js\";\n\nconst VERSION = \"0.2.0\";\nconst DEFAULT_API_URL = \"https://api.bettercms.ai/api/v1\";\nconst DEFAULT_OUT = \"bettercms.generated.ts\";\n\ninterface CliArgs {\n  apiUrl: string;\n  apiKey: string | undefined;\n  out: string;\n  /** When set, also emit the Live Preview bindings module to this path. */\n  bindingsOut: string | undefined;\n  /** When set, also emit the typed React render components (.tsx) to this path. */\n  componentsOut: string | undefined;\n  help: boolean;\n}\n\nfunction parseArgs(argv: string[]): CliArgs {\n  const args: CliArgs = {\n    apiUrl: process.env.BETTERCMS_API_URL ?? DEFAULT_API_URL,\n    apiKey: process.env.BETTERCMS_API_KEY,\n    out: DEFAULT_OUT,\n    bindingsOut: undefined,\n    componentsOut: undefined,\n    help: false,\n  };\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n    const next = () => argv[++i];\n    switch (arg) {\n      case \"--api-url\":\n        args.apiUrl = next() ?? args.apiUrl;\n        break;\n      case \"--key\":\n      case \"--api-key\":\n        args.apiKey = next();\n        break;\n      case \"--out\":\n      case \"-o\":\n        args.out = next() ?? args.out;\n        break;\n      case \"--bindings-out\":\n        args.bindingsOut = next();\n        break;\n      case \"--components-out\":\n        args.componentsOut = next();\n        break;\n      case \"--help\":\n      case \"-h\":\n        args.help = true;\n        break;\n    }\n  }\n  return args;\n}\n\nconst HELP = `bettercms-codegen v${VERSION} — generate TypeScript types from your BetterCMS schema\n\nUsage:\n  npx @bettercms-ai/codegen [options]\n\nOptions:\n  -o, --out <path>      Output file (default: ${DEFAULT_OUT})\n      --bindings-out <path>  Also emit the Live Preview bindings module to <path>\n      --components-out <path>  Also emit typed <RichText>/<Image> React components (.tsx) to <path>\n      --api-url <url>   Management API base (default: ${DEFAULT_API_URL})\n      --key <key>       Management API key (or set BETTERCMS_API_KEY)\n  -h, --help            Show this help\n\nEnv:\n  BETTERCMS_API_KEY     Management-scoped key (content:manage)\n  BETTERCMS_API_URL     Override the API base\n`;\n\nasync function main(): Promise<void> {\n  const args = parseArgs(process.argv.slice(2));\n\n  if (args.help) {\n    process.stdout.write(HELP);\n    return;\n  }\n  if (!args.apiKey) {\n    process.stderr.write(\n      \"error: no API key. Pass --key <key> or set BETTERCMS_API_KEY.\\n\",\n    );\n    process.exit(1);\n  }\n\n  const models = await fetchModels({ apiUrl: args.apiUrl, apiKey: args.apiKey });\n\n  const outPath = resolve(process.cwd(), args.out);\n  await mkdir(dirname(outPath), { recursive: true });\n  await writeFile(outPath, generateTypes(models, { version: VERSION }), \"utf8\");\n\n  const plural = models.length === 1 ? \"\" : \"s\";\n  process.stdout.write(\n    `✓ Generated ${models.length} model type${plural} → ${args.out}\\n`,\n  );\n\n  if (args.bindingsOut) {\n    const bindingsPath = resolve(process.cwd(), args.bindingsOut);\n    await mkdir(dirname(bindingsPath), { recursive: true });\n    await writeFile(bindingsPath, generateBindings(models, { version: VERSION }), \"utf8\");\n    process.stdout.write(`✓ Generated Live Preview bindings → ${args.bindingsOut}\\n`);\n  }\n\n  if (args.componentsOut) {\n    const componentsPath = resolve(process.cwd(), args.componentsOut);\n    await mkdir(dirname(componentsPath), { recursive: true });\n    await writeFile(componentsPath, generateComponents({ version: VERSION }), \"utf8\");\n    process.stdout.write(`✓ Generated render components → ${args.componentsOut}\\n`);\n  }\n}\n\nmain().catch((err: unknown) => {\n  process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\\n`);\n  process.exit(1);\n});\n","/**\n * Fetches content models from the BetterCMS Management API so the CLI can generate\n * types against a live project. Kept dependency-free (plain fetch) so the generated\n * artifact and this fetcher can run anywhere — a GitHub Action, a postinstall, a script.\n */\n\nimport type { GeneratableModel } from \"./generate.js\";\n\nexport interface FetchModelsOptions {\n  /** Management API base, e.g. \"https://api.bettercms.ai/api/v1\". */\n  apiUrl: string;\n  /** A management-scoped key (content:manage) or device-minted token. */\n  apiKey: string;\n  /** Optional fetch override (testing / custom runtime). */\n  fetchImpl?: typeof fetch;\n}\n\ninterface ManagedModelRow {\n  slug: string;\n  name?: string;\n  description?: string | null;\n  fields: GeneratableModel[\"fields\"];\n}\n\n/**\n * GET /management/content/models — returns the project's models (the key is\n * project-scoped server-side, so this is exactly the schema for this site).\n */\nexport async function fetchModels(\n  opts: FetchModelsOptions,\n): Promise<GeneratableModel[]> {\n  const doFetch = opts.fetchImpl ?? globalThis.fetch;\n  const base = opts.apiUrl.replace(/\\/+$/, \"\");\n  const url = `${base}/management/content/models`;\n\n  let res: Response;\n  try {\n    res = await doFetch(url, {\n      // No Content-Type: this is a bodyless GET; the header is incorrect here and\n      // strict edge runtimes/proxies may reject it.\n      headers: { Authorization: `Bearer ${opts.apiKey}`, Accept: \"application/json\" },\n    });\n  } catch (err) {\n    throw new Error(\n      `Could not reach the BetterCMS Management API at ${url}: ${\n        err instanceof Error ? err.message : String(err)\n      }`,\n    );\n  }\n\n  if (!res.ok) {\n    const hint =\n      res.status === 401 || res.status === 403\n        ? \" — check your management API key (it must have the content:manage scope).\"\n        : \"\";\n    throw new Error(`Management API returned ${res.status} ${res.statusText}${hint}`);\n  }\n\n  const body = (await res.json()) as { data?: ManagedModelRow[] };\n  const rows = body.data ?? [];\n  return rows.map((r) => ({\n    slug: r.slug,\n    name: r.name,\n    description: r.description ?? null,\n    fields: r.fields ?? [],\n  }));\n}\n","/**\n * @bettercms-ai/codegen — schema → TypeScript generator (the single source of truth).\n *\n * Both the dashboard schema builder and the MCP `create_model`/`add_field` tools write\n * the SAME `content_models.fields` (an array of `ContentModelField`). This generator maps\n * that one array into TypeScript. Because there is exactly one schema representation, the\n * generated types can never drift from the editor or the agent — they are the same source.\n *\n * Pure + deterministic: same models in → identical string out (stable ordering, no clock,\n * no I/O). That makes it trivially testable and safe to commit + diff in a customer repo.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\n\n/** Minimal model shape the generator needs — a subset of the Management API model row. */\nexport interface GeneratableModel {\n  /** Machine-safe slug, e.g. \"blog\" or \"case-study\". Used for the schema-map key. */\n  slug: string;\n  /** Human name, used only for the JSDoc header. */\n  name?: string;\n  description?: string | null;\n  fields: ContentModelField[];\n}\n\nexport interface GenerateOptions {\n  /** Generator version stamped into the header (defaults to the package version). */\n  version?: string;\n  /** Override the banner timestamp source — omitted by default so output is deterministic. */\n  bannerComment?: string;\n}\n\n/** Helper types emitted once at the top of every generated file (self-contained, zero-dep). */\nconst PREAMBLE = `/**\n * Rich-text field value returned by the Delivery API.\n *\n * - \\`format\\`/\\`value\\`: the portable, editor-agnostic payload (Lexical EditorState) —\n *   render it with your editor's serializer for full fidelity.\n * - \\`html\\`: server-rendered, sanitized HTML (computed render-on-write). Present on\n *   Delivery reads; the simplest path for non-React consumers — safe to inject directly\n *   (e.g. \\`dangerouslySetInnerHTML\\`). Optional: legacy/un-normalized values may omit it.\n *\n * The \\`{ format, value }\\` contract is unchanged; \\`html\\` is additive.\n */\n/**\n * One Portable Text block, or a block object (an image, an embed, a placed component).\n *\n * Inlined rather than imported: this preamble is emitted INTO your repo and is deliberately\n * dependency-free. To render structure, \\`npm i @portabletext/react\\` and pass\n * \\`portableText(field)\\` to it; to render without adding anything, keep using \\`rich()\\`.\n */\nexport type PortableTextBlock = {\n  readonly _type: string;\n  readonly _key: string;\n  readonly style?: string;\n  readonly listItem?: string;\n  readonly level?: number;\n  readonly markDefs?: readonly { readonly _type: string; readonly _key: string; readonly [k: string]: unknown }[];\n  readonly children?: readonly { readonly _type: string; readonly _key: string; readonly text?: string; readonly marks?: readonly string[] }[];\n  readonly [k: string]: unknown;\n};\n\nexport type RichText = {\n  /**\n   * The storage format. Deliberately \\`string\\` and NOT a literal union: a project mid-backfill\n   * holds both \\`\"lexical-…\"\\` and \\`\"portable-text-1\"\\` values, and narrowing this would give a\n   * type error to anyone regenerating types against it.\n   */\n  readonly format: string;\n  /** Portable Text blocks when \\`format\\` is \\`\"portable-text-1\"\\`; editor state otherwise. */\n  readonly value: unknown;\n  /**\n   * Server-rendered, sanitized HTML. ALWAYS present, in every format, forever — sites built\n   * before Portable Text existed read this directly and cannot be rebuilt.\n   */\n  readonly html?: string;\n  /**\n   * @deprecated Superseded by Portable Text — read \\`portableText(field)\\` instead. Retained so\n   * entries written before the migration keep type-checking; nothing mints it any more.\n   *\n   * Structured blocks. Present on Body (\\`document\\`) fields ONLY, and optional even there —\n   * it is derived at write time, so an entry saved before this existed carries none until its\n   * next save, and there is no backfill. Branch on its absence; \\`html\\` is always there.\n   *\n   * \\`id\\` is stable within ONE document, never a global key — two entries both have a \"0.0\".\n   * A cross-document anchor is (entryId, fieldKey, id).\n   */\n  readonly doc?: {\n    readonly version: 1;\n    readonly blocks: readonly { readonly id: string; readonly type: string; readonly [k: string]: unknown }[];\n  };\n};\n\n/**\n * A field that may arrive as EITHER shape.\n *\n * Switching a field between \\`text\\` and \\`richtext\\` in the CMS switches what Delivery\n * returns for it — a bare string becomes \\`{ format, value, html }\\`. Type author-editable\n * text with this and read it through \\`plain()\\`/\\`rich()\\` below, and that switch stops being\n * a site-breaking change. Interpolating the value directly renders \\`[object Object]\\`.\n */\nexport type TextOrRich = string | RichText | null | undefined;\n\n/** True when the value is a rich-text envelope rather than a bare string. */\nexport function isRichText(value: unknown): value is RichText {\n  return (\n    typeof value === \"object\" && value !== null && !Array.isArray(value) &&\n    (\"html\" in value || \"format\" in value)\n  );\n}\n\n/** The marker on a Portable Text envelope. */\nexport const PORTABLE_TEXT_FORMAT = \"portable-text-1\";\n\n/**\n * Portable Text blocks when the field stores them, otherwise null.\n *\n * ADDITIVE. \\`rich()\\` and \\`plain()\\` keep working exactly as before on every format, so\n * nothing you have already shipped needs to change. Use this only if you want to render the\n * structure yourself — for example with \\`@portabletext/react\\`.\n */\nexport function portableText(value: TextOrRich): readonly PortableTextBlock[] | null {\n  if (!isRichText(value)) return null;\n  return value.format === PORTABLE_TEXT_FORMAT && Array.isArray(value.value)\n    ? (value.value as readonly PortableTextBlock[])\n    : null;\n}\n\n/** Plain text for attribute contexts — \\`<title>\\`, meta description, JSON-LD, \\`alt\\`. */\nexport function plain(value: TextOrRich): string {\n  if (typeof value === \"string\") return value;\n  if (!isRichText(value) || typeof value.html !== \"string\") return \"\";\n  return decodeEntities(value.html.replace(/<[^>]+>/g, \"\")).trim();\n}\n\n/**\n * Renderable HTML, for \\`set:html\\` / \\`dangerouslySetInnerHTML\\`. Rich text keeps its inline\n * marks (the server sanitizes \\`html\\` on write); a bare string is escaped, so a plain field\n * can never inject markup. A LONE wrapping block is unwrapped — a field switched from\n * \\`text\\` stores \\`<p>…</p>\\`, and \\`<h1><p>…</p></h1>\\` is invalid HTML (the parser closes the\n * heading early, dropping the text out of it). Real block structure is left alone.\n */\nexport function rich(value: TextOrRich, fallback = \"\"): string {\n  const html = (\n    typeof value === \"string\" ? escapeHtml(value) : isRichText(value) ? (value.html ?? \"\") : \"\"\n  ).trim();\n  return html ? unwrapLoneBlock(html) : escapeHtml(fallback);\n}\n\nfunction unwrapLoneBlock(html: string): string {\n  const m = html.match(/^<(p|div|h[1-6])(?:\\\\s[^>]*)?>([\\\\s\\\\S]*)<\\\\/\\\\1>$/i);\n  return m && !new RegExp(\\`</\\${m[1]}>\\`, \"i\").test(m[2]) ? m[2] : html;\n}\n\nfunction escapeHtml(s: string): string {\n  return s.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\");\n}\n\nfunction decodeEntities(s: string): string {\n  return s\n    .replace(/&lt;/g, \"<\").replace(/&gt;/g, \">\").replace(/&quot;/g, '\"')\n    .replace(/&#0?39;/g, \"'\").replace(/&nbsp;/g, \" \").replace(/&amp;/g, \"&\");\n}\n\n/**\n * Image / media field value as stored and returned verbatim by the Delivery API\n * (server-normalized on write to the canonical shape). \\`url\\` is always present; an\n * unresolved/external value may carry only \\`url\\`. \\`altText\\` is the accessibility text\n * for \\`<img alt>\\`.\n */\nexport interface BetterCMSImage {\n  readonly id?: string;\n  readonly url: string;\n  readonly name?: string;\n  readonly altText?: string | null;\n  readonly width?: number;\n  readonly height?: number;\n}\n\n/**\n * A component slot's value, as stored and delivered.\n *\n * \\`componentId\\` points at a component definition; \\`overrides\\` are the author's values,\n * keyed by the component's declared prop keys.\n *\n * \\`resolved\\` is the SNAPSHOT: at publish time the component is resolved (its block tree\n * with the overrides applied) and frozen onto the published value. That is why editing a\n * component does not silently rewrite entries that were already published — a published\n * entry carries what it was published with until it is published again.\n *\n * Read \\`resolved\\` when it is there; it is absent on draft-perspective reads, where you\n * should resolve \\`componentId\\` yourself against the components endpoint.\n */\nexport interface BetterCMSComponentRef {\n  readonly componentId: string;\n  readonly overrides?: Readonly<Record<string, unknown>>;\n  readonly resolved?: readonly unknown[];\n}\n\n/**\n * One block in a section zone, as stored and delivered.\n *\n * This is the SAME shape a page's \\`blockJson\\` holds — a section zone is a composable page\n * region, so it delivers page blocks, not a shape of its own. Deliberately structural rather\n * than a discriminated union over every block type: the container blocks\n * (\\`columns\\`, \\`section\\`, \\`slider\\`, \\`tabs\\`) nest \\`BetterCMSBlock\\` inside \\`props\\`,\n * and the block vocabulary is server-side and versioned independently of any generated SDK.\n * Narrow on \\`type\\` at the call site.\n *\n * \\`style\\` carries the block's design tokens when the author set any.\n */\nexport interface BetterCMSBlock {\n  readonly type: string;\n  readonly id: string;\n  readonly props?: Readonly<Record<string, unknown>>;\n  readonly style?: Readonly<Record<string, unknown>>;\n}\n\n/**\n * Delivery envelope around a model's typed \\`data\\`. \\`getEntry\\`/\\`listEntries\\` in the\n * Next adapter return this shape, with \\`fields\\` typed by the model.\n */\nexport interface BetterCMSEntry<TFields> {\n  readonly slug: string;\n  readonly status: \"draft\" | \"published\";\n  readonly fields: TFields;\n  readonly updatedAt: string;\n}\n\n/** Fully resolved published or preview Layout returned beside a delivered page. */\nexport interface BetterCMSLayout {\n  readonly version: 1;\n  readonly nodes: ReadonlyArray<\n    | { readonly kind: \"page-content\"; readonly id: \"page-content\" }\n    | {\n        readonly kind: \"section\";\n        readonly id: string;\n        readonly slug: string;\n        readonly name: string;\n        readonly source: \"inherit\" | \"override-content\" | \"customize-structure\" | \"page-only\" | \"detached\";\n      }\n  >;\n  readonly sections: Readonly<Record<string, {\n    readonly id: string;\n    readonly slug: string;\n    readonly name: string;\n    /** Headless Section values, including values represented by direct field items. */\n    readonly fields: Readonly<Record<string, unknown>>;\n    readonly items: ReadonlyArray<\n      | { readonly id: string; readonly kind: \"field\"; readonly fieldId: string; readonly value: unknown }\n      | {\n          readonly id: string;\n          readonly kind: \"component\";\n          readonly componentId: string;\n          readonly variantGroupId?: string;\n          readonly canonicalInputs: readonly BetterCMSLayoutInput[];\n          readonly bindings: ReadonlyArray<{ readonly inputId: string; readonly fieldId: string }>;\n          readonly canonicalValues: Readonly<Record<string, unknown>>;\n          readonly resolvedProps: Readonly<Record<string, unknown>>;\n          readonly blocks: readonly unknown[];\n        }\n    >;\n  }>>;\n}\n\n/** Recursive canonical input description exposed with each delivered Component item. */\nexport interface BetterCMSLayoutInput {\n  readonly id: string;\n  readonly slug: string;\n  readonly label: string;\n  readonly type: string;\n  readonly required?: boolean;\n  readonly defaultValue?: unknown;\n  readonly config?: Readonly<Record<string, unknown>>;\n  readonly fields?: readonly BetterCMSLayoutInput[];\n}\n`;\n\n/** PascalCase an identifier from a slug: \"case-study\" → \"CaseStudy\". */\nfunction pascalCase(slug: string): string {\n  const parts = slug.split(/[-_\\s]+/).filter(Boolean);\n  const pascal = parts\n    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))\n    .join(\"\");\n  // Guard against an identifier that starts with a digit (invalid TS type name).\n  return /^[0-9]/.test(pascal) ? `Model${pascal}` : pascal || \"Model\";\n}\n\n/**\n * Make a string safe to embed inside a `/** ... *​/` JSDoc comment. A field label\n * (free-text, author/agent-controlled) could contain `*​/` — which closes the comment\n * early and injects the remainder as code — or a newline, which breaks the single-line\n * comment. Both are neutralized here. Without this, hostile content produces non-\n * compiling (or worse, code-injected) output.\n */\nfunction escapeJsDoc(text: string): string {\n  return text.replace(/\\*\\//g, \"* /\").replace(/[\\r\\n]+/g, \" \").trim();\n}\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as a TS property name. Field keys are author/agent-controlled and\n * not guaranteed to be valid identifiers (e.g. \"my-field\", \"1title\", \"\"), so anything\n * that isn't a bare identifier is emitted as a quoted property name — always valid TS.\n */\nfunction propName(key: string): string {\n  return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/** A scalar/primitive field maps to a TS type expression (no nesting). */\nfunction scalarType(field: ContentModelField): string {\n  const t: ContentModelFieldType = field.type;\n  switch (t) {\n    case \"text\":\n      return \"string\";\n    case \"richtext\":\n    // A document field stores the SAME {format, value, html} envelope as richtext — the\n    // difference is the editor and the placement, not the wire shape. So it maps to the same\n    // generated type, and the `doc` rendition lands on `RichText` itself rather than here.\n    case \"document\":\n      return \"RichText\";\n    case \"image\":\n      return \"BetterCMSImage\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"number\":\n      return \"number\";\n    case \"date\":\n    case \"datetime\":\n      return \"string\"; // ISO 8601\n    case \"select\": {\n      const opts = field.options?.filter((o) => typeof o === \"string\") ?? [];\n      return opts.length > 0\n        ? opts.map((o) => JSON.stringify(o)).join(\" | \")\n        : \"string\";\n    }\n    case \"reference\":\n      return \"string\"; // referenced entry id\n    // Both spellings are live (see ContentModelFieldType). Template- and Webflow-seeded\n    // models carry the camelCase one; until it was handled here it fell through to the\n    // exhaustiveness default, so generated types for every template-created collection\n    // typed this field as `unknown` instead of `string[]`.\n    case \"multi-reference\":\n    case \"multiReference\":\n      return \"string[]\"; // referenced entry ids\n    case \"array\": {\n      // Zoned arrays (config.zones) are expanded by fieldsToBody before reaching here;\n      // this branch handles only the primitive list form (config.itemType).\n      const itemType = field.config?.itemType ?? \"text\";\n      const inner =\n        itemType === \"number\" ? \"number\" : \"string\"; // text | date → string\n      return `${inner}[]`;\n    }\n    // ── Builder scalars ────────────────────────────────────────────────────────\n    // All string-shaped on the wire; each is value-validated on write (see\n    // src/lib/content/reference-validation.ts), so the generated type is the\n    // narrowest thing that is actually true of the stored value.\n    case \"longtext\":\n    case \"slug\":\n    case \"email\":\n    case \"phone\":\n    case \"link\":\n    case \"color\":\n      return \"string\";\n    case \"json\":\n      // Arbitrary author-supplied JSON — object or parseable string. `unknown`\n      // forces the consumer to narrow, which is correct: we genuinely don't know.\n      return \"unknown\";\n    case \"component-ref\":\n      // The delivered value is the reference plus, on published reads, its frozen tree.\n      return \"BetterCMSComponentRef\";\n    case \"modular\":\n      // ponytail: `data` stays an open record. A per-block discriminated union would need\n      // every allowed block model resolved at generate time (they are separate rows, and\n      // this function only sees the field), and consumers narrow on __type anyway. Emitting\n      // the union later is additive — it only makes an existing `unknown` more specific.\n      return \"ReadonlyArray<{ readonly __id: string; readonly __type: string; readonly data: Record<string, unknown> }>\";\n    case \"sections\": {\n      const config = field.config as {\n        mode?: unknown;\n        allowedSections?: unknown;\n        legacyResolved?: unknown;\n      } | null | undefined;\n      // Creating the durable authored Zone intentionally preserves `allowedSections` until\n      // migration is explicitly confirmed. During that window the writer, validator and\n      // renderer still use the legacy BetterCMSBlock[] value, so codegen must tell the same\n      // truth instead of exposing the authored instance shape one release too early.\n      const unresolvedLegacy = config?.mode === \"authored-v2\"\n        && Object.prototype.hasOwnProperty.call(config, \"allowedSections\")\n        && config.legacyResolved !== true;\n      if (config?.mode === \"authored-v2\" && !unresolvedLegacy) {\n        return \"ReadonlyArray<{ readonly __id: string; readonly __section: string; readonly __type: string; readonly data: Record<string, unknown> }>\";\n      }\n      // The value IS the page block tree, so it gets the public block type rather than a\n      // shape of its own — a section zone and a page's blockJson deliver the identical\n      // thing, and emitting two names for one shape is how a consumer ends up writing a\n      // converter between them.\n      return \"ReadonlyArray<BetterCMSBlock>\";\n    }\n    case \"location\":\n      return \"{ readonly lat: number; readonly lng: number; readonly label?: string }\";\n    case \"file\":\n      // The file envelope is the image envelope minus the pixel dimensions\n      // ({ url, name?, ... }), and BetterCMSImage's width/height are optional — so\n      // every file value is already a valid BetterCMSImage. Reused rather than\n      // emitting a second near-identical public type into every generated SDK.\n      return \"BetterCMSImage\";\n    default: {\n      // Exhaustiveness guard: if a new field type is added to the union and not\n      // mapped here, this line becomes a compile error in the codegen build.\n      const _exhaustive: never = t;\n      return \"unknown\";\n    }\n  }\n}\n\n/**\n * Render the TS type for a zoned `array` field: an object with optional\n * `nonRepeatable` (a fixed block) and/or `repeatable` (a list of blocks). Recurses\n * through zone fields, so a zone field that is itself a zoned `array` nests naturally.\n */\nfunction arrayZoneType(field: ContentModelField, indent: string): string {\n  const zones = field.config?.zones;\n  const parts: string[] = [];\n  if (zones?.nonRepeatable?.length) {\n    const nested = fieldsToBody(zones.nonRepeatable, indent + \"  \");\n    parts.push(`${indent}  readonly nonRepeatable?: {\\n${nested}\\n${indent}  };`);\n  }\n  if (zones?.repeatable?.fields?.length) {\n    const nested = fieldsToBody(zones.repeatable.fields, indent + \"    \");\n    parts.push(`${indent}  readonly repeatable?: Array<{\\n${nested}\\n${indent}  }>;`);\n  }\n  if (parts.length === 0) return \"Record<string, unknown>\"; // zoned array with no fields yet\n  return `{\\n${parts.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the body of an object type from a field list, recursing into zones. */\nfunction fieldsToBody(fields: ContentModelField[], indent: string): string {\n  const lines: string[] = [];\n  for (const field of fields) {\n    const optional = field.required ? \"\" : \"?\";\n    let typeExpr: string;\n\n    if (field.type === \"array\" && field.config?.zones) {\n      typeExpr = arrayZoneType(field, indent);\n    } else {\n      typeExpr = scalarType(field);\n    }\n\n    const safeLabel = field.label ? escapeJsDoc(field.label) : \"\";\n    if (safeLabel && safeLabel !== field.key) {\n      lines.push(`${indent}/** ${safeLabel} */`);\n    }\n    lines.push(`${indent}readonly ${propName(field.key)}${optional}: ${typeExpr};`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generate a complete `.ts` module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateTypes(\n  models: GeneratableModel[],\n  opts: GenerateOptions = {},\n): string {\n  const version = opts.version ?? \"0.1.0\";\n  // Code-unit sort (NOT localeCompare): locale/ICU-independent so the generated\n  // file is byte-identical on every machine — committed output diffs cleanly.\n  const sorted = [...models].sort((a, b) =>\n    a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n  );\n\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen\n// Source of truth: your BetterCMS content models (the same schema the dashboard\n// builder and the MCP tools write). Re-run codegen after any schema change.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const interfaces: string[] = [];\n  const mapEntries: string[] = [];\n  // Different slugs can PascalCase to the same base name (e.g. \"case-study\" and\n  // \"case_study\" → \"CaseStudy\"). Emitting two identical interfaces would silently\n  // declaration-merge into one wrong type, so disambiguate with a numeric suffix.\n  const usedNames = new Set<string>();\n\n  for (const model of sorted) {\n    const base = `${pascalCase(model.slug)}Fields`;\n    let typeName = base;\n    for (let n = 2; usedNames.has(typeName); n++) typeName = `${base}_${n}`;\n    usedNames.add(typeName);\n\n    const name = model.name ? escapeJsDoc(model.name) : \"\";\n    const desc = model.description ? escapeJsDoc(model.description) : \"\";\n    const doc = name\n      ? `/**\\n * ${name}${desc ? ` — ${desc}` : \"\"}\\n * Model slug: \\`${model.slug}\\`\\n */\\n`\n      : \"\";\n    const body = model.fields.length\n      ? fieldsToBody(model.fields, \"  \")\n      : \"  // (no fields defined yet)\";\n    interfaces.push(`${doc}export interface ${typeName} {\\n${body}\\n}`);\n    mapEntries.push(`  readonly ${JSON.stringify(model.slug)}: ${typeName};`);\n  }\n\n  const schemaMap = `/**\n * Registry mapping each model slug to its typed fields. The Next adapter uses this to\n * type \\`getEntry(\"blog\", ...)\\` by slug — autocomplete and exhaustiveness for free.\n */\nexport interface BetterCMSSchema {\n${mapEntries.join(\"\\n\") || \"  // (no models defined yet)\"}\n}\n\n/** Union of all model slugs. */\nexport type BetterCMSModelSlug = keyof BetterCMSSchema;`;\n\n  return [header, PREAMBLE, interfaces.join(\"\\n\\n\"), schemaMap, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → Live Preview binding helper generator.\n *\n * Companion to {@link generateTypes}. Where that emits the *types*, this emits a\n * tiny, schema-derived runtime that stamps `data-bcms-field` / `data-bcms-kind`\n * attributes onto the elements a site author binds to CMS content. Those\n * attributes are what the dashboard's Live Preview editor reads to turn the real,\n * running site into an editable canvas (the parent maps `data-bcms-field` → its\n * internal `data-node-id` on frame load).\n *\n * Why a helper and not auto-injection: BetterCMS never renders the customer's DOM\n * — the site does. So binding is opt-in per element via a spread:\n *\n *   import { bcms } from \"./bettercms.bindings.generated\";\n *\n *   <h1 {...bcms.blog.title}>{entry.fields.title}</h1>          // scalar\n *   <li {...bcms.blog.tags.value(i)}>{tag}</li>                 // primitive-array item\n *   <article {...bcms.blog.features.$(i)}>                      // array item root\n *     <h3 {...bcms.blog.features.label(i)}>{f.label}</h3>       // array item sub-field\n *   </article>\n *\n * The attributes are always emitted — inert `data-*` attributes on any build, exactly\n * like Storyblok's `data-blok-c` / Sanity's `data-sanity` — so a site is editable no\n * matter which pipeline built it. One generated file, no build modes.\n *\n * Pure + deterministic, exactly like the type generator: same models in → identical\n * string out (slug-sorted, field order preserved, no clock, no I/O). Field keys are\n * author/agent-controlled, so every embedded key is emitted as an escaped string\n * literal (never interpolated into code) — hostile input can't break the output.\n *\n * Grammar — mirrors what the editor's `fieldPathToNodeId` resolves:\n *   `title` · `hero.heroTitle` · `hero.primaryCta.label`         (group leaves, any depth)\n *   `features[0]` · `features[0].label` · `intro.facts[0].label` (repeaters, one index)\n * Group (non-repeatable) zones recurse into nested binding objects; a repeater is an\n * object with `$(i)` (item root) + one accessor per scalar sub-field. Arrays nested\n * inside a repeater item (a second index) are still beyond what the editor can\n * address, so they are intentionally omitted rather than emitted as dead paths.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\nimport type { GeneratableModel, GenerateOptions } from \"./generate.js\";\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as an object property name. Keys aren't guaranteed to be valid\n * identifiers (e.g. \"my-field\", \"1title\"), so anything that isn't a bare identifier\n * is quoted — always valid TS. (Mirrors the same helper in `generate.ts`.)\n */\nfunction propName(key: string): string {\n  return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/**\n * The kind label written to `data-bcms-kind`, mapped to the editor's closed field-type\n * set (matches the dashboard adapter's `toEditorFieldType`): API-only types that have\n * no on-canvas control collapse to \"text\". Informational today — the editor derives the\n * authoritative kind from the loaded model — but kept truthful for debugging/forward use.\n */\nfunction bindingKind(t: ContentModelFieldType): string {\n  switch (t) {\n    case \"text\":\n    case \"richtext\":\n    case \"image\":\n    case \"boolean\":\n    case \"number\":\n    case \"select\":\n    case \"array\":\n      return t;\n    case \"document\":\n      return \"richtext\";\n    // reference / multi-reference / date / datetime → plain text in the editor v1.\n    default:\n      return \"text\";\n  }\n}\n\n/**\n * Build a runtime path expression for an array element: a string literal split around\n * the index so it concatenates at call time. Both halves are JSON-escaped, so an\n * author-controlled key can never inject code. e.g. (\"features[\", \"].label\") →\n * `\"features[\" + i + \"].label\"`.\n */\nfunction indexedPath(prefix: string, suffix: string): string {\n  return `${JSON.stringify(prefix)} + i + ${JSON.stringify(suffix)}`;\n}\n\n/** Render a repeater binding object: `$(i)` item root + one accessor per scalar\n *  sub-field. `path` is the repeater's full (possibly dotted) field path. */\nfunction repeaterBinding(\n  itemFields: ContentModelField[],\n  path: string,\n  indent: string,\n): string {\n  const lines: string[] = [\n    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n  ];\n  for (const sub of itemFields) {\n    // A sub-field that is itself an array would need a second index the editor\n    // can't address yet — skip it rather than emit a path that won't bind.\n    if (sub.type === \"array\") continue;\n    lines.push(\n      `${indent}  ${propName(sub.key)}: (i: number) => bcmsField(${indexedPath(`${path}[`, `].${sub.key}`)}, ${JSON.stringify(bindingKind(sub.type))}),`,\n    );\n  }\n  return `{\\n${lines.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the binding for one field at `path`, recursing into group zones. */\nfunction fieldBinding(\n  field: ContentModelField,\n  prefix: string,\n  indent: string,\n): string {\n  const path = prefix ? `${prefix}.${field.key}` : field.key;\n  const name = propName(field.key);\n\n  if (field.type !== \"array\") {\n    return `${indent}${name}: bcmsField(${JSON.stringify(path)}, ${JSON.stringify(bindingKind(field.type))}),`;\n  }\n\n  const zones = field.config?.zones;\n  // Group (non-repeatable) → a nested object of dotted-path leaf bindings.\n  if (zones?.nonRepeatable?.length) {\n    const body = zones.nonRepeatable\n      .map((child) => fieldBinding(child, path, `${indent}  `))\n      .join(\"\\n\");\n    return `${indent}${name}: {\\n${body}\\n${indent}},`;\n  }\n  // Repeater → `$(i)` + scalar sub-field accessors.\n  if (zones?.repeatable?.fields?.length) {\n    return `${indent}${name}: ${repeaterBinding(zones.repeatable.fields, path, indent)},`;\n  }\n  // Primitive list (`config.itemType` or bare) → `$(i)` + synthetic `value(i)`.\n  const lines = [\n    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n    `${indent}  value: (i: number) => bcmsField(${indexedPath(`${path}[`, \"].value\")}, \"text\"),`,\n  ];\n  return `${indent}${name}: {\\n${lines.join(\"\\n\")}\\n${indent}},`;\n}\n\n/** Render the binding entries for one model's fields (field order preserved). */\nfunction fieldsToBindings(fields: ContentModelField[], indent: string): string {\n  return fields.map((field) => fieldBinding(field, \"\", indent)).join(\"\\n\");\n}\n\n/** The self-contained runtime emitted once at the top of every bindings file. */\nconst PREAMBLE = `/**\n * Binding attributes for a CMS-bound element. Spread onto the element that renders a\n * field: \\`<h1 {...bcmsField(\"title\", \"text\")}>\\`. Always emitted, on every build —\n * two inert \\`data-*\\` attributes are what makes the site editable in Live Preview.\n */\nexport function bcmsField(path: string, kind: string): Record<string, string> {\n  return { \"data-bcms-field\": path, \"data-bcms-kind\": kind };\n}\n`;\n\n/**\n * Generate the Live Preview bindings module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateBindings(\n  models: GeneratableModel[],\n  opts: GenerateOptions = {},\n): string {\n  const version = opts.version ?? \"0.1.0\";\n  // Code-unit sort (NOT localeCompare) so output is byte-identical on every machine.\n  const sorted = [...models].sort((a, b) =>\n    a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n  );\n\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>\n// Spread these onto the elements that render your content; they emit\n// data-bcms-field/data-bcms-kind on every build.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const entries = sorted.map((model) => {\n    const body = model.fields.length\n      ? `\\n${fieldsToBindings(model.fields, \"    \")}\\n  `\n      : \"\";\n    return `  ${JSON.stringify(model.slug)}: {${body}},`;\n  });\n\n  const bcms = `/**\n * Field bindings keyed by model slug. Spread a binding onto the element that renders\n * that field. Arrays expose \\`$(i)\\` for the item element and one accessor per\n * (one-level) sub-field; primitive arrays expose \\`value(i)\\` for the item's scalar.\n */\nexport const bcms = {\n${entries.join(\"\\n\") || \"  // (no models defined yet)\"}\n} as const;`;\n\n  return [header, PREAMBLE, bcms, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → typed React render components generator.\n *\n * Companion to {@link generateTypes} (types) and {@link generateBindings} (Live\n * Preview attributes). This emits a small, self-contained `.tsx` module with two\n * components that render the canonical Delivery field shapes CORRECTLY, so authors\n * never hand-roll the rendering that produces the classic bugs:\n *\n *   - <RichText> renders the server-sanitized `html` via `dangerouslySetInnerHTML`,\n *     instead of interpolating the value as a JSX child (which React escapes, so the\n *     page shows literal `<p>…</p>` tags — the #6 escaped-richtext bug).\n *   - <Image> reads the normalized image object's `.url`/`.altText`, instead of\n *     treating the object as a string.\n *\n * The emitted module is intentionally generic (not per-model) and dependency-free\n * beyond React, so it is a drop-in: point codegen at a path and import the two\n * components. It is deterministic (no clock, no I/O) like the sibling generators.\n *\n * Security: `html` is the Delivery API's server-rendered, DOMPurify-sanitized output\n * (see the RichText type docs). `<RichText>` injects exactly that field. If a caller\n * passes HTML from another, untrusted source they must sanitize it themselves.\n */\n\nimport type { GenerateOptions } from \"./generate.js\";\n\n/**\n * Generate the `bettercms.components.tsx` module: typed `<RichText>` and `<Image>`\n * components for the canonical Delivery field shapes. Deterministic — same options\n * in, identical string out.\n */\nexport function generateComponents(opts: GenerateOptions = {}): string {\n  const version = opts.version ?? \"0.1.0\";\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen --components-out <path>\n// Typed render components for BetterCMS field shapes. Use these instead of\n// hand-rendering richtext/image values — they render the canonical shapes correctly.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const body = `import * as React from \"react\";\n\n/** Rich-text value from the Delivery API. \\`html\\` is server-rendered + sanitized. */\nexport type RichTextValue = {\n  readonly format: string;\n  readonly value: unknown;\n  readonly html?: string;\n  /**\n   * Structured blocks — Body (\\`document\\`) fields only, and optional even there: derived at\n   * write time, so entries saved before it existed carry none until re-saved. No backfill.\n   * Block ids are stable within one document only, never a global key.\n   */\n  readonly doc?: { readonly version: 1; readonly blocks: readonly { readonly id: string; readonly type: string; readonly [k: string]: unknown }[] };\n};\n\n/** Normalized image/media value from the Delivery API. */\nexport interface BetterCMSImageValue {\n  readonly url: string;\n  readonly altText?: string | null;\n  readonly width?: number;\n  readonly height?: number;\n}\n\ntype RichTextProps = {\n  /** The richtext field value (\\`entry.fields.someRichText\\`). */\n  field?: RichTextValue | null;\n  /** Element/component to render as. Default: \\`\"div\"\\`. */\n  as?: React.ElementType;\n} & Omit<React.HTMLAttributes<HTMLElement>, \"dangerouslySetInnerHTML\" | \"children\">;\n\n/**\n * Render a richtext field as HTML. Uses the server-sanitized \\`html\\` via\n * \\`dangerouslySetInnerHTML\\` — NEVER interpolate a richtext value as a JSX child\n * (React escapes it, so the page shows literal tags). Renders nothing when unset.\n */\nexport function RichText({ field, as: Tag = \"div\", ...rest }: RichTextProps) {\n  if (!field || !field.html) return null;\n  return <Tag {...rest} dangerouslySetInnerHTML={{ __html: field.html }} />;\n}\n\ntype ImageProps = {\n  /** The image field value (\\`entry.fields.someImage\\`). */\n  field?: BetterCMSImageValue | null;\n  /** Alt text override; defaults to the field's \\`altText\\`, then \\`\"\"\\`. */\n  alt?: string;\n} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, \"src\">;\n\n/**\n * Render an image field as an \\`<img>\\` from its normalized \\`.url\\`/\\`.altText\\`.\n * Renders nothing when unset. Pass \\`alt\\` to override the stored alt text.\n */\nexport function Image({ field, alt, ...rest }: ImageProps) {\n  if (!field || !field.url) return null;\n  return (\n    <img\n      src={field.url}\n      alt={alt ?? field.altText ?? \"\"}\n      width={field.width}\n      height={field.height}\n      {...rest}\n    />\n  );\n}\n`;\n\n  return [header, body].join(\"\\n\");\n}\n"],"mappings":"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","names":["VALID_IDENT","propName","PREAMBLE"]}

package/dist/index.d.ts

@@ -54,9 +54,9 @@ declare function generateTypes(models: GeneratableModel[], opts?: GenerateOption
  *     <h3 {...bcms.blog.features.label(i)}>{f.label}</h3>       // array item sub-field
  *   </article>
  *
- * The attributes only appear when the site is built with `BCMS_ANNOTATE` set
- * (preview builds); a normal production build ships zero extra attributes, because
- * `bcmsField` returns `{}`. Same generated file, both builds — no separate mode.
+ * The attributes are always emitted — inert `data-*` attributes on any build, exactly
+ * like Storyblok's `data-blok-c` / Sanity's `data-sanity` — so a site is editable no
+ * matter which pipeline built it. One generated file, no build modes.
  *
  * Pure + deterministic, exactly like the type generator: same models in → identical
  * string out (slug-sorted, field order preserved, no clock, no I/O). Field keys are

package/dist/index.js

@@ -10,12 +10,126 @@ var PREAMBLE = `/**
  *
  * The \`{ format, value }\` contract is unchanged; \`html\` is additive.
  */
+/**
+ * One Portable Text block, or a block object (an image, an embed, a placed component).
+ *
+ * Inlined rather than imported: this preamble is emitted INTO your repo and is deliberately
+ * dependency-free. To render structure, \`npm i @portabletext/react\` and pass
+ * \`portableText(field)\` to it; to render without adding anything, keep using \`rich()\`.
+ */
+export type PortableTextBlock = {
+  readonly _type: string;
+  readonly _key: string;
+  readonly style?: string;
+  readonly listItem?: string;
+  readonly level?: number;
+  readonly markDefs?: readonly { readonly _type: string; readonly _key: string; readonly [k: string]: unknown }[];
+  readonly children?: readonly { readonly _type: string; readonly _key: string; readonly text?: string; readonly marks?: readonly string[] }[];
+  readonly [k: string]: unknown;
+};
+
 export type RichText = {
+  /**
+   * The storage format. Deliberately \`string\` and NOT a literal union: a project mid-backfill
+   * holds both \`"lexical-\u2026"\` and \`"portable-text-1"\` values, and narrowing this would give a
+   * type error to anyone regenerating types against it.
+   */
   readonly format: string;
+  /** Portable Text blocks when \`format\` is \`"portable-text-1"\`; editor state otherwise. */
   readonly value: unknown;
+  /**
+   * Server-rendered, sanitized HTML. ALWAYS present, in every format, forever \u2014 sites built
+   * before Portable Text existed read this directly and cannot be rebuilt.
+   */
   readonly html?: string;
+  /**
+   * @deprecated Superseded by Portable Text \u2014 read \`portableText(field)\` instead. Retained so
+   * entries written before the migration keep type-checking; nothing mints it any more.
+   *
+   * Structured blocks. Present on Body (\`document\`) fields ONLY, and optional even there \u2014
+   * it is derived at write time, so an entry saved before this existed carries none until its
+   * next save, and there is no backfill. Branch on its absence; \`html\` is always there.
+   *
+   * \`id\` is stable within ONE document, never a global key \u2014 two entries both have a "0.0".
+   * A cross-document anchor is (entryId, fieldKey, id).
+   */
+  readonly doc?: {
+    readonly version: 1;
+    readonly blocks: readonly { readonly id: string; readonly type: string; readonly [k: string]: unknown }[];
+  };
 };
 
+/**
+ * A field that may arrive as EITHER shape.
+ *
+ * Switching a field between \`text\` and \`richtext\` in the CMS switches what Delivery
+ * returns for it \u2014 a bare string becomes \`{ format, value, html }\`. Type author-editable
+ * text with this and read it through \`plain()\`/\`rich()\` below, and that switch stops being
+ * a site-breaking change. Interpolating the value directly renders \`[object Object]\`.
+ */
+export type TextOrRich = string | RichText | null | undefined;
+
+/** True when the value is a rich-text envelope rather than a bare string. */
+export function isRichText(value: unknown): value is RichText {
+  return (
+    typeof value === "object" && value !== null && !Array.isArray(value) &&
+    ("html" in value || "format" in value)
+  );
+}
+
+/** The marker on a Portable Text envelope. */
+export const PORTABLE_TEXT_FORMAT = "portable-text-1";
+
+/**
+ * Portable Text blocks when the field stores them, otherwise null.
+ *
+ * ADDITIVE. \`rich()\` and \`plain()\` keep working exactly as before on every format, so
+ * nothing you have already shipped needs to change. Use this only if you want to render the
+ * structure yourself \u2014 for example with \`@portabletext/react\`.
+ */
+export function portableText(value: TextOrRich): readonly PortableTextBlock[] | null {
+  if (!isRichText(value)) return null;
+  return value.format === PORTABLE_TEXT_FORMAT && Array.isArray(value.value)
+    ? (value.value as readonly PortableTextBlock[])
+    : null;
+}
+
+/** Plain text for attribute contexts \u2014 \`<title>\`, meta description, JSON-LD, \`alt\`. */
+export function plain(value: TextOrRich): string {
+  if (typeof value === "string") return value;
+  if (!isRichText(value) || typeof value.html !== "string") return "";
+  return decodeEntities(value.html.replace(/<[^>]+>/g, "")).trim();
+}
+
+/**
+ * Renderable HTML, for \`set:html\` / \`dangerouslySetInnerHTML\`. Rich text keeps its inline
+ * marks (the server sanitizes \`html\` on write); a bare string is escaped, so a plain field
+ * can never inject markup. A LONE wrapping block is unwrapped \u2014 a field switched from
+ * \`text\` stores \`<p>\u2026</p>\`, and \`<h1><p>\u2026</p></h1>\` is invalid HTML (the parser closes the
+ * heading early, dropping the text out of it). Real block structure is left alone.
+ */
+export function rich(value: TextOrRich, fallback = ""): string {
+  const html = (
+    typeof value === "string" ? escapeHtml(value) : isRichText(value) ? (value.html ?? "") : ""
+  ).trim();
+  return html ? unwrapLoneBlock(html) : escapeHtml(fallback);
+}
+
+function unwrapLoneBlock(html: string): string {
+  const m = html.match(/^<(p|div|h[1-6])(?:\\s[^>]*)?>([\\s\\S]*)<\\/\\1>$/i);
+  return m && !new RegExp(\`</\${m[1]}>\`, "i").test(m[2]) ? m[2] : html;
+}
+
+function escapeHtml(s: string): string {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+
+function decodeEntities(s: string): string {
+  return s
+    .replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"')
+    .replace(/&#0?39;/g, "'").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&");
+}
+
 /**
  * Image / media field value as stored and returned verbatim by the Delivery API
  * (server-normalized on write to the canonical shape). \`url\` is always present; an
@@ -31,6 +145,45 @@ export interface BetterCMSImage {
   readonly height?: number;
 }
 
+/**
+ * A component slot's value, as stored and delivered.
+ *
+ * \`componentId\` points at a component definition; \`overrides\` are the author's values,
+ * keyed by the component's declared prop keys.
+ *
+ * \`resolved\` is the SNAPSHOT: at publish time the component is resolved (its block tree
+ * with the overrides applied) and frozen onto the published value. That is why editing a
+ * component does not silently rewrite entries that were already published \u2014 a published
+ * entry carries what it was published with until it is published again.
+ *
+ * Read \`resolved\` when it is there; it is absent on draft-perspective reads, where you
+ * should resolve \`componentId\` yourself against the components endpoint.
+ */
+export interface BetterCMSComponentRef {
+  readonly componentId: string;
+  readonly overrides?: Readonly<Record<string, unknown>>;
+  readonly resolved?: readonly unknown[];
+}
+
+/**
+ * One block in a section zone, as stored and delivered.
+ *
+ * This is the SAME shape a page's \`blockJson\` holds \u2014 a section zone is a composable page
+ * region, so it delivers page blocks, not a shape of its own. Deliberately structural rather
+ * than a discriminated union over every block type: the container blocks
+ * (\`columns\`, \`section\`, \`slider\`, \`tabs\`) nest \`BetterCMSBlock\` inside \`props\`,
+ * and the block vocabulary is server-side and versioned independently of any generated SDK.
+ * Narrow on \`type\` at the call site.
+ *
+ * \`style\` carries the block's design tokens when the author set any.
+ */
+export interface BetterCMSBlock {
+  readonly type: string;
+  readonly id: string;
+  readonly props?: Readonly<Record<string, unknown>>;
+  readonly style?: Readonly<Record<string, unknown>>;
+}
+
 /**
  * Delivery envelope around a model's typed \`data\`. \`getEntry\`/\`listEntries\` in the
  * Next adapter return this shape, with \`fields\` typed by the model.
@@ -41,6 +194,54 @@ export interface BetterCMSEntry<TFields> {
   readonly fields: TFields;
   readonly updatedAt: string;
 }
+
+/** Fully resolved published or preview Layout returned beside a delivered page. */
+export interface BetterCMSLayout {
+  readonly version: 1;
+  readonly nodes: ReadonlyArray<
+    | { readonly kind: "page-content"; readonly id: "page-content" }
+    | {
+        readonly kind: "section";
+        readonly id: string;
+        readonly slug: string;
+        readonly name: string;
+        readonly source: "inherit" | "override-content" | "customize-structure" | "page-only" | "detached";
+      }
+  >;
+  readonly sections: Readonly<Record<string, {
+    readonly id: string;
+    readonly slug: string;
+    readonly name: string;
+    /** Headless Section values, including values represented by direct field items. */
+    readonly fields: Readonly<Record<string, unknown>>;
+    readonly items: ReadonlyArray<
+      | { readonly id: string; readonly kind: "field"; readonly fieldId: string; readonly value: unknown }
+      | {
+          readonly id: string;
+          readonly kind: "component";
+          readonly componentId: string;
+          readonly variantGroupId?: string;
+          readonly canonicalInputs: readonly BetterCMSLayoutInput[];
+          readonly bindings: ReadonlyArray<{ readonly inputId: string; readonly fieldId: string }>;
+          readonly canonicalValues: Readonly<Record<string, unknown>>;
+          readonly resolvedProps: Readonly<Record<string, unknown>>;
+          readonly blocks: readonly unknown[];
+        }
+    >;
+  }>>;
+}
+
+/** Recursive canonical input description exposed with each delivered Component item. */
+export interface BetterCMSLayoutInput {
+  readonly id: string;
+  readonly slug: string;
+  readonly label: string;
+  readonly type: string;
+  readonly required?: boolean;
+  readonly defaultValue?: unknown;
+  readonly config?: Readonly<Record<string, unknown>>;
+  readonly fields?: readonly BetterCMSLayoutInput[];
+}
 `;
 function pascalCase(slug) {
   const parts = slug.split(/[-_\s]+/).filter(Boolean);
@@ -60,6 +261,10 @@ function scalarType(field) {
     case "text":
       return "string";
     case "richtext":
+    // A document field stores the SAME {format, value, html} envelope as richtext — the
+    // difference is the editor and the placement, not the wire shape. So it maps to the same
+    // generated type, and the `doc` rendition lands on `RichText` itself rather than here.
+    case "document":
       return "RichText";
     case "image":
       return "BetterCMSImage";
@@ -78,7 +283,12 @@ function scalarType(field) {
     case "reference":
       return "string";
     // referenced entry id
+    // Both spellings are live (see ContentModelFieldType). Template- and Webflow-seeded
+    // models carry the camelCase one; until it was handled here it fell through to the
+    // exhaustiveness default, so generated types for every template-created collection
+    // typed this field as `unknown` instead of `string[]`.
     case "multi-reference":
+    case "multiReference":
       return "string[]";
     // referenced entry ids
     case "array": {
@@ -86,6 +296,35 @@ function scalarType(field) {
       const inner = itemType === "number" ? "number" : "string";
       return `${inner}[]`;
     }
+    // ── Builder scalars ────────────────────────────────────────────────────────
+    // All string-shaped on the wire; each is value-validated on write (see
+    // src/lib/content/reference-validation.ts), so the generated type is the
+    // narrowest thing that is actually true of the stored value.
+    case "longtext":
+    case "slug":
+    case "email":
+    case "phone":
+    case "link":
+    case "color":
+      return "string";
+    case "json":
+      return "unknown";
+    case "component-ref":
+      return "BetterCMSComponentRef";
+    case "modular":
+      return "ReadonlyArray<{ readonly __id: string; readonly __type: string; readonly data: Record<string, unknown> }>";
+    case "sections": {
+      const config = field.config;
+      const unresolvedLegacy = config?.mode === "authored-v2" && Object.prototype.hasOwnProperty.call(config, "allowedSections") && config.legacyResolved !== true;
+      if (config?.mode === "authored-v2" && !unresolvedLegacy) {
+        return "ReadonlyArray<{ readonly __id: string; readonly __section: string; readonly __type: string; readonly data: Record<string, unknown> }>";
+      }
+      return "ReadonlyArray<BetterCMSBlock>";
+    }
+    case "location":
+      return "{ readonly lat: number; readonly lng: number; readonly label?: string }";
+    case "file":
+      return "BetterCMSImage";
     default: {
       const _exhaustive = t;
       return "unknown";
@@ -190,6 +429,8 @@ function bindingKind(t) {
     case "select":
     case "array":
       return t;
+    case "document":
+      return "richtext";
     // reference / multi-reference / date / datetime → plain text in the editor v1.
     default:
       return "text";
@@ -240,27 +481,12 @@ function fieldsToBindings(fields, indent) {
   return fields.map((field) => fieldBinding(field, "", indent)).join("\n");
 }
 var PREAMBLE2 = `/**
- * True when this site is built for Live Preview annotation. Set \`BCMS_ANNOTATE=1\`
- * in the preview build only; unset (the default) ships zero binding attributes.
- * Read defensively so the module is safe in any runtime (browser, Node, edge).
- */
-const BCMS_ANNOTATE: boolean = (() => {
-  try {
-    const v = (globalThis as { process?: { env?: Record<string, string | undefined> } })
-      .process?.env?.BCMS_ANNOTATE;
-    return v != null && v !== "" && v !== "0" && v !== "false";
-  } catch {
-    return false;
-  }
-})();
-
-/**
  * Binding attributes for a CMS-bound element. Spread onto the element that renders a
- * field: \`<h1 {...bcmsField("title", "text")}>\`. Returns \`{}\` unless BCMS_ANNOTATE
- * is set, so production markup is untouched.
+ * field: \`<h1 {...bcmsField("title", "text")}>\`. Always emitted, on every build \u2014
+ * two inert \`data-*\` attributes are what makes the site editable in Live Preview.
  */
 export function bcmsField(path: string, kind: string): Record<string, string> {
-  return BCMS_ANNOTATE ? { "data-bcms-field": path, "data-bcms-kind": kind } : {};
+  return { "data-bcms-field": path, "data-bcms-kind": kind };
 }
 `;
 function generateBindings(models, opts = {}) {
@@ -271,7 +497,7 @@ function generateBindings(models, opts = {}) {
   const header = `// \u26A0\uFE0F  AUTO-GENERATED by @bettercms-ai/codegen v${version} \u2014 DO NOT EDIT.
 // Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>
 // Spread these onto the elements that render your content; they emit
-// data-bcms-field/data-bcms-kind only when the site is built with BCMS_ANNOTATE set.
+// data-bcms-field/data-bcms-kind on every build.
 ${opts.bannerComment ? `// ${opts.bannerComment}
 ` : ""}`;
   const entries = sorted.map((model) => {
@@ -307,6 +533,12 @@ export type RichTextValue = {
   readonly format: string;
   readonly value: unknown;
   readonly html?: string;
+  /**
+   * Structured blocks \u2014 Body (\`document\`) fields only, and optional even there: derived at
+   * write time, so entries saved before it existed carry none until re-saved. No backfill.
+   * Block ids are stable within one document only, never a global key.
+   */
+  readonly doc?: { readonly version: 1; readonly blocks: readonly { readonly id: string; readonly type: string; readonly [k: string]: unknown }[] };
 };
 
 /** Normalized image/media value from the Delivery API. */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/generate.ts","../src/bindings.ts","../src/components.ts","../src/fetch-models.ts"],"sourcesContent":["/**\n * @bettercms-ai/codegen — schema → TypeScript generator (the single source of truth).\n *\n * Both the dashboard schema builder and the MCP `create_model`/`add_field` tools write\n * the SAME `content_models.fields` (an array of `ContentModelField`). This generator maps\n * that one array into TypeScript. Because there is exactly one schema representation, the\n * generated types can never drift from the editor or the agent — they are the same source.\n *\n * Pure + deterministic: same models in → identical string out (stable ordering, no clock,\n * no I/O). That makes it trivially testable and safe to commit + diff in a customer repo.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\n\n/** Minimal model shape the generator needs — a subset of the Management API model row. */\nexport interface GeneratableModel {\n  /** Machine-safe slug, e.g. \"blog\" or \"case-study\". Used for the schema-map key. */\n  slug: string;\n  /** Human name, used only for the JSDoc header. */\n  name?: string;\n  description?: string | null;\n  fields: ContentModelField[];\n}\n\nexport interface GenerateOptions {\n  /** Generator version stamped into the header (defaults to the package version). */\n  version?: string;\n  /** Override the banner timestamp source — omitted by default so output is deterministic. */\n  bannerComment?: string;\n}\n\n/** Helper types emitted once at the top of every generated file (self-contained, zero-dep). */\nconst PREAMBLE = `/**\n * Rich-text field value returned by the Delivery API.\n *\n * - \\`format\\`/\\`value\\`: the portable, editor-agnostic payload (Lexical EditorState) —\n *   render it with your editor's serializer for full fidelity.\n * - \\`html\\`: server-rendered, sanitized HTML (computed render-on-write). Present on\n *   Delivery reads; the simplest path for non-React consumers — safe to inject directly\n *   (e.g. \\`dangerouslySetInnerHTML\\`). Optional: legacy/un-normalized values may omit it.\n *\n * The \\`{ format, value }\\` contract is unchanged; \\`html\\` is additive.\n */\nexport type RichText = {\n  readonly format: string;\n  readonly value: unknown;\n  readonly html?: string;\n};\n\n/**\n * Image / media field value as stored and returned verbatim by the Delivery API\n * (server-normalized on write to the canonical shape). \\`url\\` is always present; an\n * unresolved/external value may carry only \\`url\\`. \\`altText\\` is the accessibility text\n * for \\`<img alt>\\`.\n */\nexport interface BetterCMSImage {\n  readonly id?: string;\n  readonly url: string;\n  readonly name?: string;\n  readonly altText?: string | null;\n  readonly width?: number;\n  readonly height?: number;\n}\n\n/**\n * Delivery envelope around a model's typed \\`data\\`. \\`getEntry\\`/\\`listEntries\\` in the\n * Next adapter return this shape, with \\`fields\\` typed by the model.\n */\nexport interface BetterCMSEntry<TFields> {\n  readonly slug: string;\n  readonly status: \"draft\" | \"published\";\n  readonly fields: TFields;\n  readonly updatedAt: string;\n}\n`;\n\n/** PascalCase an identifier from a slug: \"case-study\" → \"CaseStudy\". */\nfunction pascalCase(slug: string): string {\n  const parts = slug.split(/[-_\\s]+/).filter(Boolean);\n  const pascal = parts\n    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))\n    .join(\"\");\n  // Guard against an identifier that starts with a digit (invalid TS type name).\n  return /^[0-9]/.test(pascal) ? `Model${pascal}` : pascal || \"Model\";\n}\n\n/**\n * Make a string safe to embed inside a `/** ... *​/` JSDoc comment. A field label\n * (free-text, author/agent-controlled) could contain `*​/` — which closes the comment\n * early and injects the remainder as code — or a newline, which breaks the single-line\n * comment. Both are neutralized here. Without this, hostile content produces non-\n * compiling (or worse, code-injected) output.\n */\nfunction escapeJsDoc(text: string): string {\n  return text.replace(/\\*\\//g, \"* /\").replace(/[\\r\\n]+/g, \" \").trim();\n}\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as a TS property name. Field keys are author/agent-controlled and\n * not guaranteed to be valid identifiers (e.g. \"my-field\", \"1title\", \"\"), so anything\n * that isn't a bare identifier is emitted as a quoted property name — always valid TS.\n */\nfunction propName(key: string): string {\n  return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/** A scalar/primitive field maps to a TS type expression (no nesting). */\nfunction scalarType(field: ContentModelField): string {\n  const t: ContentModelFieldType = field.type;\n  switch (t) {\n    case \"text\":\n      return \"string\";\n    case \"richtext\":\n      return \"RichText\";\n    case \"image\":\n      return \"BetterCMSImage\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"number\":\n      return \"number\";\n    case \"date\":\n    case \"datetime\":\n      return \"string\"; // ISO 8601\n    case \"select\": {\n      const opts = field.options?.filter((o) => typeof o === \"string\") ?? [];\n      return opts.length > 0\n        ? opts.map((o) => JSON.stringify(o)).join(\" | \")\n        : \"string\";\n    }\n    case \"reference\":\n      return \"string\"; // referenced entry id\n    case \"multi-reference\":\n      return \"string[]\"; // referenced entry ids\n    case \"array\": {\n      // Zoned arrays (config.zones) are expanded by fieldsToBody before reaching here;\n      // this branch handles only the primitive list form (config.itemType).\n      const itemType = field.config?.itemType ?? \"text\";\n      const inner =\n        itemType === \"number\" ? \"number\" : \"string\"; // text | date → string\n      return `${inner}[]`;\n    }\n    default: {\n      // Exhaustiveness guard: if a new field type is added to the union and not\n      // mapped here, this line becomes a compile error in the codegen build.\n      const _exhaustive: never = t;\n      return \"unknown\";\n    }\n  }\n}\n\n/**\n * Render the TS type for a zoned `array` field: an object with optional\n * `nonRepeatable` (a fixed block) and/or `repeatable` (a list of blocks). Recurses\n * through zone fields, so a zone field that is itself a zoned `array` nests naturally.\n */\nfunction arrayZoneType(field: ContentModelField, indent: string): string {\n  const zones = field.config?.zones;\n  const parts: string[] = [];\n  if (zones?.nonRepeatable?.length) {\n    const nested = fieldsToBody(zones.nonRepeatable, indent + \"  \");\n    parts.push(`${indent}  readonly nonRepeatable?: {\\n${nested}\\n${indent}  };`);\n  }\n  if (zones?.repeatable?.fields?.length) {\n    const nested = fieldsToBody(zones.repeatable.fields, indent + \"    \");\n    parts.push(`${indent}  readonly repeatable?: Array<{\\n${nested}\\n${indent}  }>;`);\n  }\n  if (parts.length === 0) return \"Record<string, unknown>\"; // zoned array with no fields yet\n  return `{\\n${parts.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the body of an object type from a field list, recursing into zones. */\nfunction fieldsToBody(fields: ContentModelField[], indent: string): string {\n  const lines: string[] = [];\n  for (const field of fields) {\n    const optional = field.required ? \"\" : \"?\";\n    let typeExpr: string;\n\n    if (field.type === \"array\" && field.config?.zones) {\n      typeExpr = arrayZoneType(field, indent);\n    } else {\n      typeExpr = scalarType(field);\n    }\n\n    const safeLabel = field.label ? escapeJsDoc(field.label) : \"\";\n    if (safeLabel && safeLabel !== field.key) {\n      lines.push(`${indent}/** ${safeLabel} */`);\n    }\n    lines.push(`${indent}readonly ${propName(field.key)}${optional}: ${typeExpr};`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generate a complete `.ts` module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateTypes(\n  models: GeneratableModel[],\n  opts: GenerateOptions = {},\n): string {\n  const version = opts.version ?? \"0.1.0\";\n  // Code-unit sort (NOT localeCompare): locale/ICU-independent so the generated\n  // file is byte-identical on every machine — committed output diffs cleanly.\n  const sorted = [...models].sort((a, b) =>\n    a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n  );\n\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen\n// Source of truth: your BetterCMS content models (the same schema the dashboard\n// builder and the MCP tools write). Re-run codegen after any schema change.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const interfaces: string[] = [];\n  const mapEntries: string[] = [];\n  // Different slugs can PascalCase to the same base name (e.g. \"case-study\" and\n  // \"case_study\" → \"CaseStudy\"). Emitting two identical interfaces would silently\n  // declaration-merge into one wrong type, so disambiguate with a numeric suffix.\n  const usedNames = new Set<string>();\n\n  for (const model of sorted) {\n    const base = `${pascalCase(model.slug)}Fields`;\n    let typeName = base;\n    for (let n = 2; usedNames.has(typeName); n++) typeName = `${base}_${n}`;\n    usedNames.add(typeName);\n\n    const name = model.name ? escapeJsDoc(model.name) : \"\";\n    const desc = model.description ? escapeJsDoc(model.description) : \"\";\n    const doc = name\n      ? `/**\\n * ${name}${desc ? ` — ${desc}` : \"\"}\\n * Model slug: \\`${model.slug}\\`\\n */\\n`\n      : \"\";\n    const body = model.fields.length\n      ? fieldsToBody(model.fields, \"  \")\n      : \"  // (no fields defined yet)\";\n    interfaces.push(`${doc}export interface ${typeName} {\\n${body}\\n}`);\n    mapEntries.push(`  readonly ${JSON.stringify(model.slug)}: ${typeName};`);\n  }\n\n  const schemaMap = `/**\n * Registry mapping each model slug to its typed fields. The Next adapter uses this to\n * type \\`getEntry(\"blog\", ...)\\` by slug — autocomplete and exhaustiveness for free.\n */\nexport interface BetterCMSSchema {\n${mapEntries.join(\"\\n\") || \"  // (no models defined yet)\"}\n}\n\n/** Union of all model slugs. */\nexport type BetterCMSModelSlug = keyof BetterCMSSchema;`;\n\n  return [header, PREAMBLE, interfaces.join(\"\\n\\n\"), schemaMap, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → Live Preview binding helper generator.\n *\n * Companion to {@link generateTypes}. Where that emits the *types*, this emits a\n * tiny, schema-derived runtime that stamps `data-bcms-field` / `data-bcms-kind`\n * attributes onto the elements a site author binds to CMS content. Those\n * attributes are what the dashboard's Live Preview editor reads to turn the real,\n * running site into an editable canvas (the parent maps `data-bcms-field` → its\n * internal `data-node-id` on frame load).\n *\n * Why a helper and not auto-injection: BetterCMS never renders the customer's DOM\n * — the site does. So binding is opt-in per element via a spread:\n *\n *   import { bcms } from \"./bettercms.bindings.generated\";\n *\n *   <h1 {...bcms.blog.title}>{entry.fields.title}</h1>          // scalar\n *   <li {...bcms.blog.tags.value(i)}>{tag}</li>                 // primitive-array item\n *   <article {...bcms.blog.features.$(i)}>                      // array item root\n *     <h3 {...bcms.blog.features.label(i)}>{f.label}</h3>       // array item sub-field\n *   </article>\n *\n * The attributes only appear when the site is built with `BCMS_ANNOTATE` set\n * (preview builds); a normal production build ships zero extra attributes, because\n * `bcmsField` returns `{}`. Same generated file, both builds — no separate mode.\n *\n * Pure + deterministic, exactly like the type generator: same models in → identical\n * string out (slug-sorted, field order preserved, no clock, no I/O). Field keys are\n * author/agent-controlled, so every embedded key is emitted as an escaped string\n * literal (never interpolated into code) — hostile input can't break the output.\n *\n * Grammar — mirrors what the editor's `fieldPathToNodeId` resolves:\n *   `title` · `hero.heroTitle` · `hero.primaryCta.label`         (group leaves, any depth)\n *   `features[0]` · `features[0].label` · `intro.facts[0].label` (repeaters, one index)\n * Group (non-repeatable) zones recurse into nested binding objects; a repeater is an\n * object with `$(i)` (item root) + one accessor per scalar sub-field. Arrays nested\n * inside a repeater item (a second index) are still beyond what the editor can\n * address, so they are intentionally omitted rather than emitted as dead paths.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\nimport type { GeneratableModel, GenerateOptions } from \"./generate.js\";\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as an object property name. Keys aren't guaranteed to be valid\n * identifiers (e.g. \"my-field\", \"1title\"), so anything that isn't a bare identifier\n * is quoted — always valid TS. (Mirrors the same helper in `generate.ts`.)\n */\nfunction propName(key: string): string {\n  return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/**\n * The kind label written to `data-bcms-kind`, mapped to the editor's closed field-type\n * set (matches the dashboard adapter's `toEditorFieldType`): API-only types that have\n * no on-canvas control collapse to \"text\". Informational today — the editor derives the\n * authoritative kind from the loaded model — but kept truthful for debugging/forward use.\n */\nfunction bindingKind(t: ContentModelFieldType): string {\n  switch (t) {\n    case \"text\":\n    case \"richtext\":\n    case \"image\":\n    case \"boolean\":\n    case \"number\":\n    case \"select\":\n    case \"array\":\n      return t;\n    // reference / multi-reference / date / datetime → plain text in the editor v1.\n    default:\n      return \"text\";\n  }\n}\n\n/**\n * Build a runtime path expression for an array element: a string literal split around\n * the index so it concatenates at call time. Both halves are JSON-escaped, so an\n * author-controlled key can never inject code. e.g. (\"features[\", \"].label\") →\n * `\"features[\" + i + \"].label\"`.\n */\nfunction indexedPath(prefix: string, suffix: string): string {\n  return `${JSON.stringify(prefix)} + i + ${JSON.stringify(suffix)}`;\n}\n\n/** Render a repeater binding object: `$(i)` item root + one accessor per scalar\n *  sub-field. `path` is the repeater's full (possibly dotted) field path. */\nfunction repeaterBinding(\n  itemFields: ContentModelField[],\n  path: string,\n  indent: string,\n): string {\n  const lines: string[] = [\n    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n  ];\n  for (const sub of itemFields) {\n    // A sub-field that is itself an array would need a second index the editor\n    // can't address yet — skip it rather than emit a path that won't bind.\n    if (sub.type === \"array\") continue;\n    lines.push(\n      `${indent}  ${propName(sub.key)}: (i: number) => bcmsField(${indexedPath(`${path}[`, `].${sub.key}`)}, ${JSON.stringify(bindingKind(sub.type))}),`,\n    );\n  }\n  return `{\\n${lines.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the binding for one field at `path`, recursing into group zones. */\nfunction fieldBinding(\n  field: ContentModelField,\n  prefix: string,\n  indent: string,\n): string {\n  const path = prefix ? `${prefix}.${field.key}` : field.key;\n  const name = propName(field.key);\n\n  if (field.type !== \"array\") {\n    return `${indent}${name}: bcmsField(${JSON.stringify(path)}, ${JSON.stringify(bindingKind(field.type))}),`;\n  }\n\n  const zones = field.config?.zones;\n  // Group (non-repeatable) → a nested object of dotted-path leaf bindings.\n  if (zones?.nonRepeatable?.length) {\n    const body = zones.nonRepeatable\n      .map((child) => fieldBinding(child, path, `${indent}  `))\n      .join(\"\\n\");\n    return `${indent}${name}: {\\n${body}\\n${indent}},`;\n  }\n  // Repeater → `$(i)` + scalar sub-field accessors.\n  if (zones?.repeatable?.fields?.length) {\n    return `${indent}${name}: ${repeaterBinding(zones.repeatable.fields, path, indent)},`;\n  }\n  // Primitive list (`config.itemType` or bare) → `$(i)` + synthetic `value(i)`.\n  const lines = [\n    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n    `${indent}  value: (i: number) => bcmsField(${indexedPath(`${path}[`, \"].value\")}, \"text\"),`,\n  ];\n  return `${indent}${name}: {\\n${lines.join(\"\\n\")}\\n${indent}},`;\n}\n\n/** Render the binding entries for one model's fields (field order preserved). */\nfunction fieldsToBindings(fields: ContentModelField[], indent: string): string {\n  return fields.map((field) => fieldBinding(field, \"\", indent)).join(\"\\n\");\n}\n\n/** The self-contained runtime emitted once at the top of every bindings file. */\nconst PREAMBLE = `/**\n * True when this site is built for Live Preview annotation. Set \\`BCMS_ANNOTATE=1\\`\n * in the preview build only; unset (the default) ships zero binding attributes.\n * Read defensively so the module is safe in any runtime (browser, Node, edge).\n */\nconst BCMS_ANNOTATE: boolean = (() => {\n  try {\n    const v = (globalThis as { process?: { env?: Record<string, string | undefined> } })\n      .process?.env?.BCMS_ANNOTATE;\n    return v != null && v !== \"\" && v !== \"0\" && v !== \"false\";\n  } catch {\n    return false;\n  }\n})();\n\n/**\n * Binding attributes for a CMS-bound element. Spread onto the element that renders a\n * field: \\`<h1 {...bcmsField(\"title\", \"text\")}>\\`. Returns \\`{}\\` unless BCMS_ANNOTATE\n * is set, so production markup is untouched.\n */\nexport function bcmsField(path: string, kind: string): Record<string, string> {\n  return BCMS_ANNOTATE ? { \"data-bcms-field\": path, \"data-bcms-kind\": kind } : {};\n}\n`;\n\n/**\n * Generate the Live Preview bindings module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateBindings(\n  models: GeneratableModel[],\n  opts: GenerateOptions = {},\n): string {\n  const version = opts.version ?? \"0.1.0\";\n  // Code-unit sort (NOT localeCompare) so output is byte-identical on every machine.\n  const sorted = [...models].sort((a, b) =>\n    a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n  );\n\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>\n// Spread these onto the elements that render your content; they emit\n// data-bcms-field/data-bcms-kind only when the site is built with BCMS_ANNOTATE set.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const entries = sorted.map((model) => {\n    const body = model.fields.length\n      ? `\\n${fieldsToBindings(model.fields, \"    \")}\\n  `\n      : \"\";\n    return `  ${JSON.stringify(model.slug)}: {${body}},`;\n  });\n\n  const bcms = `/**\n * Field bindings keyed by model slug. Spread a binding onto the element that renders\n * that field. Arrays expose \\`$(i)\\` for the item element and one accessor per\n * (one-level) sub-field; primitive arrays expose \\`value(i)\\` for the item's scalar.\n */\nexport const bcms = {\n${entries.join(\"\\n\") || \"  // (no models defined yet)\"}\n} as const;`;\n\n  return [header, PREAMBLE, bcms, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → typed React render components generator.\n *\n * Companion to {@link generateTypes} (types) and {@link generateBindings} (Live\n * Preview attributes). This emits a small, self-contained `.tsx` module with two\n * components that render the canonical Delivery field shapes CORRECTLY, so authors\n * never hand-roll the rendering that produces the classic bugs:\n *\n *   - <RichText> renders the server-sanitized `html` via `dangerouslySetInnerHTML`,\n *     instead of interpolating the value as a JSX child (which React escapes, so the\n *     page shows literal `<p>…</p>` tags — the #6 escaped-richtext bug).\n *   - <Image> reads the normalized image object's `.url`/`.altText`, instead of\n *     treating the object as a string.\n *\n * The emitted module is intentionally generic (not per-model) and dependency-free\n * beyond React, so it is a drop-in: point codegen at a path and import the two\n * components. It is deterministic (no clock, no I/O) like the sibling generators.\n *\n * Security: `html` is the Delivery API's server-rendered, DOMPurify-sanitized output\n * (see the RichText type docs). `<RichText>` injects exactly that field. If a caller\n * passes HTML from another, untrusted source they must sanitize it themselves.\n */\n\nimport type { GenerateOptions } from \"./generate.js\";\n\n/**\n * Generate the `bettercms.components.tsx` module: typed `<RichText>` and `<Image>`\n * components for the canonical Delivery field shapes. Deterministic — same options\n * in, identical string out.\n */\nexport function generateComponents(opts: GenerateOptions = {}): string {\n  const version = opts.version ?? \"0.1.0\";\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen --components-out <path>\n// Typed render components for BetterCMS field shapes. Use these instead of\n// hand-rendering richtext/image values — they render the canonical shapes correctly.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const body = `import * as React from \"react\";\n\n/** Rich-text value from the Delivery API. \\`html\\` is server-rendered + sanitized. */\nexport type RichTextValue = {\n  readonly format: string;\n  readonly value: unknown;\n  readonly html?: string;\n};\n\n/** Normalized image/media value from the Delivery API. */\nexport interface BetterCMSImageValue {\n  readonly url: string;\n  readonly altText?: string | null;\n  readonly width?: number;\n  readonly height?: number;\n}\n\ntype RichTextProps = {\n  /** The richtext field value (\\`entry.fields.someRichText\\`). */\n  field?: RichTextValue | null;\n  /** Element/component to render as. Default: \\`\"div\"\\`. */\n  as?: React.ElementType;\n} & Omit<React.HTMLAttributes<HTMLElement>, \"dangerouslySetInnerHTML\" | \"children\">;\n\n/**\n * Render a richtext field as HTML. Uses the server-sanitized \\`html\\` via\n * \\`dangerouslySetInnerHTML\\` — NEVER interpolate a richtext value as a JSX child\n * (React escapes it, so the page shows literal tags). Renders nothing when unset.\n */\nexport function RichText({ field, as: Tag = \"div\", ...rest }: RichTextProps) {\n  if (!field || !field.html) return null;\n  return <Tag {...rest} dangerouslySetInnerHTML={{ __html: field.html }} />;\n}\n\ntype ImageProps = {\n  /** The image field value (\\`entry.fields.someImage\\`). */\n  field?: BetterCMSImageValue | null;\n  /** Alt text override; defaults to the field's \\`altText\\`, then \\`\"\"\\`. */\n  alt?: string;\n} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, \"src\">;\n\n/**\n * Render an image field as an \\`<img>\\` from its normalized \\`.url\\`/\\`.altText\\`.\n * Renders nothing when unset. Pass \\`alt\\` to override the stored alt text.\n */\nexport function Image({ field, alt, ...rest }: ImageProps) {\n  if (!field || !field.url) return null;\n  return (\n    <img\n      src={field.url}\n      alt={alt ?? field.altText ?? \"\"}\n      width={field.width}\n      height={field.height}\n      {...rest}\n    />\n  );\n}\n`;\n\n  return [header, body].join(\"\\n\");\n}\n","/**\n * Fetches content models from the BetterCMS Management API so the CLI can generate\n * types against a live project. Kept dependency-free (plain fetch) so the generated\n * artifact and this fetcher can run anywhere — a GitHub Action, a postinstall, a script.\n */\n\nimport type { GeneratableModel } from \"./generate.js\";\n\nexport interface FetchModelsOptions {\n  /** Management API base, e.g. \"https://api.bettercms.ai/api/v1\". */\n  apiUrl: string;\n  /** A management-scoped key (content:manage) or device-minted token. */\n  apiKey: string;\n  /** Optional fetch override (testing / custom runtime). */\n  fetchImpl?: typeof fetch;\n}\n\ninterface ManagedModelRow {\n  slug: string;\n  name?: string;\n  description?: string | null;\n  fields: GeneratableModel[\"fields\"];\n}\n\n/**\n * GET /management/content/models — returns the project's models (the key is\n * project-scoped server-side, so this is exactly the schema for this site).\n */\nexport async function fetchModels(\n  opts: FetchModelsOptions,\n): Promise<GeneratableModel[]> {\n  const doFetch = opts.fetchImpl ?? globalThis.fetch;\n  const base = opts.apiUrl.replace(/\\/+$/, \"\");\n  const url = `${base}/management/content/models`;\n\n  let res: Response;\n  try {\n    res = await doFetch(url, {\n      // No Content-Type: this is a bodyless GET; the header is incorrect here and\n      // strict edge runtimes/proxies may reject it.\n      headers: { Authorization: `Bearer ${opts.apiKey}`, Accept: \"application/json\" },\n    });\n  } catch (err) {\n    throw new Error(\n      `Could not reach the BetterCMS Management API at ${url}: ${\n        err instanceof Error ? err.message : String(err)\n      }`,\n    );\n  }\n\n  if (!res.ok) {\n    const hint =\n      res.status === 401 || res.status === 403\n        ? \" — check your management API key (it must have the content:manage scope).\"\n        : \"\";\n    throw new Error(`Management API returned ${res.status} ${res.statusText}${hint}`);\n  }\n\n  const body = (await res.json()) as { data?: ManagedModelRow[] };\n  const rows = body.data ?? [];\n  return rows.map((r) => ({\n    slug: r.slug,\n    name: r.name,\n    description: r.description ?? null,\n    fields: r.fields ?? [],\n  }));\n}\n"],"mappings":"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","names":["VALID_IDENT","propName","PREAMBLE"]}
+{"version":3,"sources":["../src/generate.ts","../src/bindings.ts","../src/components.ts","../src/fetch-models.ts"],"sourcesContent":["/**\n * @bettercms-ai/codegen — schema → TypeScript generator (the single source of truth).\n *\n * Both the dashboard schema builder and the MCP `create_model`/`add_field` tools write\n * the SAME `content_models.fields` (an array of `ContentModelField`). This generator maps\n * that one array into TypeScript. Because there is exactly one schema representation, the\n * generated types can never drift from the editor or the agent — they are the same source.\n *\n * Pure + deterministic: same models in → identical string out (stable ordering, no clock,\n * no I/O). That makes it trivially testable and safe to commit + diff in a customer repo.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\n\n/** Minimal model shape the generator needs — a subset of the Management API model row. */\nexport interface GeneratableModel {\n  /** Machine-safe slug, e.g. \"blog\" or \"case-study\". Used for the schema-map key. */\n  slug: string;\n  /** Human name, used only for the JSDoc header. */\n  name?: string;\n  description?: string | null;\n  fields: ContentModelField[];\n}\n\nexport interface GenerateOptions {\n  /** Generator version stamped into the header (defaults to the package version). */\n  version?: string;\n  /** Override the banner timestamp source — omitted by default so output is deterministic. */\n  bannerComment?: string;\n}\n\n/** Helper types emitted once at the top of every generated file (self-contained, zero-dep). */\nconst PREAMBLE = `/**\n * Rich-text field value returned by the Delivery API.\n *\n * - \\`format\\`/\\`value\\`: the portable, editor-agnostic payload (Lexical EditorState) —\n *   render it with your editor's serializer for full fidelity.\n * - \\`html\\`: server-rendered, sanitized HTML (computed render-on-write). Present on\n *   Delivery reads; the simplest path for non-React consumers — safe to inject directly\n *   (e.g. \\`dangerouslySetInnerHTML\\`). Optional: legacy/un-normalized values may omit it.\n *\n * The \\`{ format, value }\\` contract is unchanged; \\`html\\` is additive.\n */\n/**\n * One Portable Text block, or a block object (an image, an embed, a placed component).\n *\n * Inlined rather than imported: this preamble is emitted INTO your repo and is deliberately\n * dependency-free. To render structure, \\`npm i @portabletext/react\\` and pass\n * \\`portableText(field)\\` to it; to render without adding anything, keep using \\`rich()\\`.\n */\nexport type PortableTextBlock = {\n  readonly _type: string;\n  readonly _key: string;\n  readonly style?: string;\n  readonly listItem?: string;\n  readonly level?: number;\n  readonly markDefs?: readonly { readonly _type: string; readonly _key: string; readonly [k: string]: unknown }[];\n  readonly children?: readonly { readonly _type: string; readonly _key: string; readonly text?: string; readonly marks?: readonly string[] }[];\n  readonly [k: string]: unknown;\n};\n\nexport type RichText = {\n  /**\n   * The storage format. Deliberately \\`string\\` and NOT a literal union: a project mid-backfill\n   * holds both \\`\"lexical-…\"\\` and \\`\"portable-text-1\"\\` values, and narrowing this would give a\n   * type error to anyone regenerating types against it.\n   */\n  readonly format: string;\n  /** Portable Text blocks when \\`format\\` is \\`\"portable-text-1\"\\`; editor state otherwise. */\n  readonly value: unknown;\n  /**\n   * Server-rendered, sanitized HTML. ALWAYS present, in every format, forever — sites built\n   * before Portable Text existed read this directly and cannot be rebuilt.\n   */\n  readonly html?: string;\n  /**\n   * @deprecated Superseded by Portable Text — read \\`portableText(field)\\` instead. Retained so\n   * entries written before the migration keep type-checking; nothing mints it any more.\n   *\n   * Structured blocks. Present on Body (\\`document\\`) fields ONLY, and optional even there —\n   * it is derived at write time, so an entry saved before this existed carries none until its\n   * next save, and there is no backfill. Branch on its absence; \\`html\\` is always there.\n   *\n   * \\`id\\` is stable within ONE document, never a global key — two entries both have a \"0.0\".\n   * A cross-document anchor is (entryId, fieldKey, id).\n   */\n  readonly doc?: {\n    readonly version: 1;\n    readonly blocks: readonly { readonly id: string; readonly type: string; readonly [k: string]: unknown }[];\n  };\n};\n\n/**\n * A field that may arrive as EITHER shape.\n *\n * Switching a field between \\`text\\` and \\`richtext\\` in the CMS switches what Delivery\n * returns for it — a bare string becomes \\`{ format, value, html }\\`. Type author-editable\n * text with this and read it through \\`plain()\\`/\\`rich()\\` below, and that switch stops being\n * a site-breaking change. Interpolating the value directly renders \\`[object Object]\\`.\n */\nexport type TextOrRich = string | RichText | null | undefined;\n\n/** True when the value is a rich-text envelope rather than a bare string. */\nexport function isRichText(value: unknown): value is RichText {\n  return (\n    typeof value === \"object\" && value !== null && !Array.isArray(value) &&\n    (\"html\" in value || \"format\" in value)\n  );\n}\n\n/** The marker on a Portable Text envelope. */\nexport const PORTABLE_TEXT_FORMAT = \"portable-text-1\";\n\n/**\n * Portable Text blocks when the field stores them, otherwise null.\n *\n * ADDITIVE. \\`rich()\\` and \\`plain()\\` keep working exactly as before on every format, so\n * nothing you have already shipped needs to change. Use this only if you want to render the\n * structure yourself — for example with \\`@portabletext/react\\`.\n */\nexport function portableText(value: TextOrRich): readonly PortableTextBlock[] | null {\n  if (!isRichText(value)) return null;\n  return value.format === PORTABLE_TEXT_FORMAT && Array.isArray(value.value)\n    ? (value.value as readonly PortableTextBlock[])\n    : null;\n}\n\n/** Plain text for attribute contexts — \\`<title>\\`, meta description, JSON-LD, \\`alt\\`. */\nexport function plain(value: TextOrRich): string {\n  if (typeof value === \"string\") return value;\n  if (!isRichText(value) || typeof value.html !== \"string\") return \"\";\n  return decodeEntities(value.html.replace(/<[^>]+>/g, \"\")).trim();\n}\n\n/**\n * Renderable HTML, for \\`set:html\\` / \\`dangerouslySetInnerHTML\\`. Rich text keeps its inline\n * marks (the server sanitizes \\`html\\` on write); a bare string is escaped, so a plain field\n * can never inject markup. A LONE wrapping block is unwrapped — a field switched from\n * \\`text\\` stores \\`<p>…</p>\\`, and \\`<h1><p>…</p></h1>\\` is invalid HTML (the parser closes the\n * heading early, dropping the text out of it). Real block structure is left alone.\n */\nexport function rich(value: TextOrRich, fallback = \"\"): string {\n  const html = (\n    typeof value === \"string\" ? escapeHtml(value) : isRichText(value) ? (value.html ?? \"\") : \"\"\n  ).trim();\n  return html ? unwrapLoneBlock(html) : escapeHtml(fallback);\n}\n\nfunction unwrapLoneBlock(html: string): string {\n  const m = html.match(/^<(p|div|h[1-6])(?:\\\\s[^>]*)?>([\\\\s\\\\S]*)<\\\\/\\\\1>$/i);\n  return m && !new RegExp(\\`</\\${m[1]}>\\`, \"i\").test(m[2]) ? m[2] : html;\n}\n\nfunction escapeHtml(s: string): string {\n  return s.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\");\n}\n\nfunction decodeEntities(s: string): string {\n  return s\n    .replace(/&lt;/g, \"<\").replace(/&gt;/g, \">\").replace(/&quot;/g, '\"')\n    .replace(/&#0?39;/g, \"'\").replace(/&nbsp;/g, \" \").replace(/&amp;/g, \"&\");\n}\n\n/**\n * Image / media field value as stored and returned verbatim by the Delivery API\n * (server-normalized on write to the canonical shape). \\`url\\` is always present; an\n * unresolved/external value may carry only \\`url\\`. \\`altText\\` is the accessibility text\n * for \\`<img alt>\\`.\n */\nexport interface BetterCMSImage {\n  readonly id?: string;\n  readonly url: string;\n  readonly name?: string;\n  readonly altText?: string | null;\n  readonly width?: number;\n  readonly height?: number;\n}\n\n/**\n * A component slot's value, as stored and delivered.\n *\n * \\`componentId\\` points at a component definition; \\`overrides\\` are the author's values,\n * keyed by the component's declared prop keys.\n *\n * \\`resolved\\` is the SNAPSHOT: at publish time the component is resolved (its block tree\n * with the overrides applied) and frozen onto the published value. That is why editing a\n * component does not silently rewrite entries that were already published — a published\n * entry carries what it was published with until it is published again.\n *\n * Read \\`resolved\\` when it is there; it is absent on draft-perspective reads, where you\n * should resolve \\`componentId\\` yourself against the components endpoint.\n */\nexport interface BetterCMSComponentRef {\n  readonly componentId: string;\n  readonly overrides?: Readonly<Record<string, unknown>>;\n  readonly resolved?: readonly unknown[];\n}\n\n/**\n * One block in a section zone, as stored and delivered.\n *\n * This is the SAME shape a page's \\`blockJson\\` holds — a section zone is a composable page\n * region, so it delivers page blocks, not a shape of its own. Deliberately structural rather\n * than a discriminated union over every block type: the container blocks\n * (\\`columns\\`, \\`section\\`, \\`slider\\`, \\`tabs\\`) nest \\`BetterCMSBlock\\` inside \\`props\\`,\n * and the block vocabulary is server-side and versioned independently of any generated SDK.\n * Narrow on \\`type\\` at the call site.\n *\n * \\`style\\` carries the block's design tokens when the author set any.\n */\nexport interface BetterCMSBlock {\n  readonly type: string;\n  readonly id: string;\n  readonly props?: Readonly<Record<string, unknown>>;\n  readonly style?: Readonly<Record<string, unknown>>;\n}\n\n/**\n * Delivery envelope around a model's typed \\`data\\`. \\`getEntry\\`/\\`listEntries\\` in the\n * Next adapter return this shape, with \\`fields\\` typed by the model.\n */\nexport interface BetterCMSEntry<TFields> {\n  readonly slug: string;\n  readonly status: \"draft\" | \"published\";\n  readonly fields: TFields;\n  readonly updatedAt: string;\n}\n\n/** Fully resolved published or preview Layout returned beside a delivered page. */\nexport interface BetterCMSLayout {\n  readonly version: 1;\n  readonly nodes: ReadonlyArray<\n    | { readonly kind: \"page-content\"; readonly id: \"page-content\" }\n    | {\n        readonly kind: \"section\";\n        readonly id: string;\n        readonly slug: string;\n        readonly name: string;\n        readonly source: \"inherit\" | \"override-content\" | \"customize-structure\" | \"page-only\" | \"detached\";\n      }\n  >;\n  readonly sections: Readonly<Record<string, {\n    readonly id: string;\n    readonly slug: string;\n    readonly name: string;\n    /** Headless Section values, including values represented by direct field items. */\n    readonly fields: Readonly<Record<string, unknown>>;\n    readonly items: ReadonlyArray<\n      | { readonly id: string; readonly kind: \"field\"; readonly fieldId: string; readonly value: unknown }\n      | {\n          readonly id: string;\n          readonly kind: \"component\";\n          readonly componentId: string;\n          readonly variantGroupId?: string;\n          readonly canonicalInputs: readonly BetterCMSLayoutInput[];\n          readonly bindings: ReadonlyArray<{ readonly inputId: string; readonly fieldId: string }>;\n          readonly canonicalValues: Readonly<Record<string, unknown>>;\n          readonly resolvedProps: Readonly<Record<string, unknown>>;\n          readonly blocks: readonly unknown[];\n        }\n    >;\n  }>>;\n}\n\n/** Recursive canonical input description exposed with each delivered Component item. */\nexport interface BetterCMSLayoutInput {\n  readonly id: string;\n  readonly slug: string;\n  readonly label: string;\n  readonly type: string;\n  readonly required?: boolean;\n  readonly defaultValue?: unknown;\n  readonly config?: Readonly<Record<string, unknown>>;\n  readonly fields?: readonly BetterCMSLayoutInput[];\n}\n`;\n\n/** PascalCase an identifier from a slug: \"case-study\" → \"CaseStudy\". */\nfunction pascalCase(slug: string): string {\n  const parts = slug.split(/[-_\\s]+/).filter(Boolean);\n  const pascal = parts\n    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))\n    .join(\"\");\n  // Guard against an identifier that starts with a digit (invalid TS type name).\n  return /^[0-9]/.test(pascal) ? `Model${pascal}` : pascal || \"Model\";\n}\n\n/**\n * Make a string safe to embed inside a `/** ... *​/` JSDoc comment. A field label\n * (free-text, author/agent-controlled) could contain `*​/` — which closes the comment\n * early and injects the remainder as code — or a newline, which breaks the single-line\n * comment. Both are neutralized here. Without this, hostile content produces non-\n * compiling (or worse, code-injected) output.\n */\nfunction escapeJsDoc(text: string): string {\n  return text.replace(/\\*\\//g, \"* /\").replace(/[\\r\\n]+/g, \" \").trim();\n}\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as a TS property name. Field keys are author/agent-controlled and\n * not guaranteed to be valid identifiers (e.g. \"my-field\", \"1title\", \"\"), so anything\n * that isn't a bare identifier is emitted as a quoted property name — always valid TS.\n */\nfunction propName(key: string): string {\n  return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/** A scalar/primitive field maps to a TS type expression (no nesting). */\nfunction scalarType(field: ContentModelField): string {\n  const t: ContentModelFieldType = field.type;\n  switch (t) {\n    case \"text\":\n      return \"string\";\n    case \"richtext\":\n    // A document field stores the SAME {format, value, html} envelope as richtext — the\n    // difference is the editor and the placement, not the wire shape. So it maps to the same\n    // generated type, and the `doc` rendition lands on `RichText` itself rather than here.\n    case \"document\":\n      return \"RichText\";\n    case \"image\":\n      return \"BetterCMSImage\";\n    case \"boolean\":\n      return \"boolean\";\n    case \"number\":\n      return \"number\";\n    case \"date\":\n    case \"datetime\":\n      return \"string\"; // ISO 8601\n    case \"select\": {\n      const opts = field.options?.filter((o) => typeof o === \"string\") ?? [];\n      return opts.length > 0\n        ? opts.map((o) => JSON.stringify(o)).join(\" | \")\n        : \"string\";\n    }\n    case \"reference\":\n      return \"string\"; // referenced entry id\n    // Both spellings are live (see ContentModelFieldType). Template- and Webflow-seeded\n    // models carry the camelCase one; until it was handled here it fell through to the\n    // exhaustiveness default, so generated types for every template-created collection\n    // typed this field as `unknown` instead of `string[]`.\n    case \"multi-reference\":\n    case \"multiReference\":\n      return \"string[]\"; // referenced entry ids\n    case \"array\": {\n      // Zoned arrays (config.zones) are expanded by fieldsToBody before reaching here;\n      // this branch handles only the primitive list form (config.itemType).\n      const itemType = field.config?.itemType ?? \"text\";\n      const inner =\n        itemType === \"number\" ? \"number\" : \"string\"; // text | date → string\n      return `${inner}[]`;\n    }\n    // ── Builder scalars ────────────────────────────────────────────────────────\n    // All string-shaped on the wire; each is value-validated on write (see\n    // src/lib/content/reference-validation.ts), so the generated type is the\n    // narrowest thing that is actually true of the stored value.\n    case \"longtext\":\n    case \"slug\":\n    case \"email\":\n    case \"phone\":\n    case \"link\":\n    case \"color\":\n      return \"string\";\n    case \"json\":\n      // Arbitrary author-supplied JSON — object or parseable string. `unknown`\n      // forces the consumer to narrow, which is correct: we genuinely don't know.\n      return \"unknown\";\n    case \"component-ref\":\n      // The delivered value is the reference plus, on published reads, its frozen tree.\n      return \"BetterCMSComponentRef\";\n    case \"modular\":\n      // ponytail: `data` stays an open record. A per-block discriminated union would need\n      // every allowed block model resolved at generate time (they are separate rows, and\n      // this function only sees the field), and consumers narrow on __type anyway. Emitting\n      // the union later is additive — it only makes an existing `unknown` more specific.\n      return \"ReadonlyArray<{ readonly __id: string; readonly __type: string; readonly data: Record<string, unknown> }>\";\n    case \"sections\": {\n      const config = field.config as {\n        mode?: unknown;\n        allowedSections?: unknown;\n        legacyResolved?: unknown;\n      } | null | undefined;\n      // Creating the durable authored Zone intentionally preserves `allowedSections` until\n      // migration is explicitly confirmed. During that window the writer, validator and\n      // renderer still use the legacy BetterCMSBlock[] value, so codegen must tell the same\n      // truth instead of exposing the authored instance shape one release too early.\n      const unresolvedLegacy = config?.mode === \"authored-v2\"\n        && Object.prototype.hasOwnProperty.call(config, \"allowedSections\")\n        && config.legacyResolved !== true;\n      if (config?.mode === \"authored-v2\" && !unresolvedLegacy) {\n        return \"ReadonlyArray<{ readonly __id: string; readonly __section: string; readonly __type: string; readonly data: Record<string, unknown> }>\";\n      }\n      // The value IS the page block tree, so it gets the public block type rather than a\n      // shape of its own — a section zone and a page's blockJson deliver the identical\n      // thing, and emitting two names for one shape is how a consumer ends up writing a\n      // converter between them.\n      return \"ReadonlyArray<BetterCMSBlock>\";\n    }\n    case \"location\":\n      return \"{ readonly lat: number; readonly lng: number; readonly label?: string }\";\n    case \"file\":\n      // The file envelope is the image envelope minus the pixel dimensions\n      // ({ url, name?, ... }), and BetterCMSImage's width/height are optional — so\n      // every file value is already a valid BetterCMSImage. Reused rather than\n      // emitting a second near-identical public type into every generated SDK.\n      return \"BetterCMSImage\";\n    default: {\n      // Exhaustiveness guard: if a new field type is added to the union and not\n      // mapped here, this line becomes a compile error in the codegen build.\n      const _exhaustive: never = t;\n      return \"unknown\";\n    }\n  }\n}\n\n/**\n * Render the TS type for a zoned `array` field: an object with optional\n * `nonRepeatable` (a fixed block) and/or `repeatable` (a list of blocks). Recurses\n * through zone fields, so a zone field that is itself a zoned `array` nests naturally.\n */\nfunction arrayZoneType(field: ContentModelField, indent: string): string {\n  const zones = field.config?.zones;\n  const parts: string[] = [];\n  if (zones?.nonRepeatable?.length) {\n    const nested = fieldsToBody(zones.nonRepeatable, indent + \"  \");\n    parts.push(`${indent}  readonly nonRepeatable?: {\\n${nested}\\n${indent}  };`);\n  }\n  if (zones?.repeatable?.fields?.length) {\n    const nested = fieldsToBody(zones.repeatable.fields, indent + \"    \");\n    parts.push(`${indent}  readonly repeatable?: Array<{\\n${nested}\\n${indent}  }>;`);\n  }\n  if (parts.length === 0) return \"Record<string, unknown>\"; // zoned array with no fields yet\n  return `{\\n${parts.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the body of an object type from a field list, recursing into zones. */\nfunction fieldsToBody(fields: ContentModelField[], indent: string): string {\n  const lines: string[] = [];\n  for (const field of fields) {\n    const optional = field.required ? \"\" : \"?\";\n    let typeExpr: string;\n\n    if (field.type === \"array\" && field.config?.zones) {\n      typeExpr = arrayZoneType(field, indent);\n    } else {\n      typeExpr = scalarType(field);\n    }\n\n    const safeLabel = field.label ? escapeJsDoc(field.label) : \"\";\n    if (safeLabel && safeLabel !== field.key) {\n      lines.push(`${indent}/** ${safeLabel} */`);\n    }\n    lines.push(`${indent}readonly ${propName(field.key)}${optional}: ${typeExpr};`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Generate a complete `.ts` module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateTypes(\n  models: GeneratableModel[],\n  opts: GenerateOptions = {},\n): string {\n  const version = opts.version ?? \"0.1.0\";\n  // Code-unit sort (NOT localeCompare): locale/ICU-independent so the generated\n  // file is byte-identical on every machine — committed output diffs cleanly.\n  const sorted = [...models].sort((a, b) =>\n    a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n  );\n\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen\n// Source of truth: your BetterCMS content models (the same schema the dashboard\n// builder and the MCP tools write). Re-run codegen after any schema change.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const interfaces: string[] = [];\n  const mapEntries: string[] = [];\n  // Different slugs can PascalCase to the same base name (e.g. \"case-study\" and\n  // \"case_study\" → \"CaseStudy\"). Emitting two identical interfaces would silently\n  // declaration-merge into one wrong type, so disambiguate with a numeric suffix.\n  const usedNames = new Set<string>();\n\n  for (const model of sorted) {\n    const base = `${pascalCase(model.slug)}Fields`;\n    let typeName = base;\n    for (let n = 2; usedNames.has(typeName); n++) typeName = `${base}_${n}`;\n    usedNames.add(typeName);\n\n    const name = model.name ? escapeJsDoc(model.name) : \"\";\n    const desc = model.description ? escapeJsDoc(model.description) : \"\";\n    const doc = name\n      ? `/**\\n * ${name}${desc ? ` — ${desc}` : \"\"}\\n * Model slug: \\`${model.slug}\\`\\n */\\n`\n      : \"\";\n    const body = model.fields.length\n      ? fieldsToBody(model.fields, \"  \")\n      : \"  // (no fields defined yet)\";\n    interfaces.push(`${doc}export interface ${typeName} {\\n${body}\\n}`);\n    mapEntries.push(`  readonly ${JSON.stringify(model.slug)}: ${typeName};`);\n  }\n\n  const schemaMap = `/**\n * Registry mapping each model slug to its typed fields. The Next adapter uses this to\n * type \\`getEntry(\"blog\", ...)\\` by slug — autocomplete and exhaustiveness for free.\n */\nexport interface BetterCMSSchema {\n${mapEntries.join(\"\\n\") || \"  // (no models defined yet)\"}\n}\n\n/** Union of all model slugs. */\nexport type BetterCMSModelSlug = keyof BetterCMSSchema;`;\n\n  return [header, PREAMBLE, interfaces.join(\"\\n\\n\"), schemaMap, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → Live Preview binding helper generator.\n *\n * Companion to {@link generateTypes}. Where that emits the *types*, this emits a\n * tiny, schema-derived runtime that stamps `data-bcms-field` / `data-bcms-kind`\n * attributes onto the elements a site author binds to CMS content. Those\n * attributes are what the dashboard's Live Preview editor reads to turn the real,\n * running site into an editable canvas (the parent maps `data-bcms-field` → its\n * internal `data-node-id` on frame load).\n *\n * Why a helper and not auto-injection: BetterCMS never renders the customer's DOM\n * — the site does. So binding is opt-in per element via a spread:\n *\n *   import { bcms } from \"./bettercms.bindings.generated\";\n *\n *   <h1 {...bcms.blog.title}>{entry.fields.title}</h1>          // scalar\n *   <li {...bcms.blog.tags.value(i)}>{tag}</li>                 // primitive-array item\n *   <article {...bcms.blog.features.$(i)}>                      // array item root\n *     <h3 {...bcms.blog.features.label(i)}>{f.label}</h3>       // array item sub-field\n *   </article>\n *\n * The attributes are always emitted — inert `data-*` attributes on any build, exactly\n * like Storyblok's `data-blok-c` / Sanity's `data-sanity` — so a site is editable no\n * matter which pipeline built it. One generated file, no build modes.\n *\n * Pure + deterministic, exactly like the type generator: same models in → identical\n * string out (slug-sorted, field order preserved, no clock, no I/O). Field keys are\n * author/agent-controlled, so every embedded key is emitted as an escaped string\n * literal (never interpolated into code) — hostile input can't break the output.\n *\n * Grammar — mirrors what the editor's `fieldPathToNodeId` resolves:\n *   `title` · `hero.heroTitle` · `hero.primaryCta.label`         (group leaves, any depth)\n *   `features[0]` · `features[0].label` · `intro.facts[0].label` (repeaters, one index)\n * Group (non-repeatable) zones recurse into nested binding objects; a repeater is an\n * object with `$(i)` (item root) + one accessor per scalar sub-field. Arrays nested\n * inside a repeater item (a second index) are still beyond what the editor can\n * address, so they are intentionally omitted rather than emitted as dead paths.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\nimport type { GeneratableModel, GenerateOptions } from \"./generate.js\";\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as an object property name. Keys aren't guaranteed to be valid\n * identifiers (e.g. \"my-field\", \"1title\"), so anything that isn't a bare identifier\n * is quoted — always valid TS. (Mirrors the same helper in `generate.ts`.)\n */\nfunction propName(key: string): string {\n  return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/**\n * The kind label written to `data-bcms-kind`, mapped to the editor's closed field-type\n * set (matches the dashboard adapter's `toEditorFieldType`): API-only types that have\n * no on-canvas control collapse to \"text\". Informational today — the editor derives the\n * authoritative kind from the loaded model — but kept truthful for debugging/forward use.\n */\nfunction bindingKind(t: ContentModelFieldType): string {\n  switch (t) {\n    case \"text\":\n    case \"richtext\":\n    case \"image\":\n    case \"boolean\":\n    case \"number\":\n    case \"select\":\n    case \"array\":\n      return t;\n    case \"document\":\n      return \"richtext\";\n    // reference / multi-reference / date / datetime → plain text in the editor v1.\n    default:\n      return \"text\";\n  }\n}\n\n/**\n * Build a runtime path expression for an array element: a string literal split around\n * the index so it concatenates at call time. Both halves are JSON-escaped, so an\n * author-controlled key can never inject code. e.g. (\"features[\", \"].label\") →\n * `\"features[\" + i + \"].label\"`.\n */\nfunction indexedPath(prefix: string, suffix: string): string {\n  return `${JSON.stringify(prefix)} + i + ${JSON.stringify(suffix)}`;\n}\n\n/** Render a repeater binding object: `$(i)` item root + one accessor per scalar\n *  sub-field. `path` is the repeater's full (possibly dotted) field path. */\nfunction repeaterBinding(\n  itemFields: ContentModelField[],\n  path: string,\n  indent: string,\n): string {\n  const lines: string[] = [\n    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n  ];\n  for (const sub of itemFields) {\n    // A sub-field that is itself an array would need a second index the editor\n    // can't address yet — skip it rather than emit a path that won't bind.\n    if (sub.type === \"array\") continue;\n    lines.push(\n      `${indent}  ${propName(sub.key)}: (i: number) => bcmsField(${indexedPath(`${path}[`, `].${sub.key}`)}, ${JSON.stringify(bindingKind(sub.type))}),`,\n    );\n  }\n  return `{\\n${lines.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the binding for one field at `path`, recursing into group zones. */\nfunction fieldBinding(\n  field: ContentModelField,\n  prefix: string,\n  indent: string,\n): string {\n  const path = prefix ? `${prefix}.${field.key}` : field.key;\n  const name = propName(field.key);\n\n  if (field.type !== \"array\") {\n    return `${indent}${name}: bcmsField(${JSON.stringify(path)}, ${JSON.stringify(bindingKind(field.type))}),`;\n  }\n\n  const zones = field.config?.zones;\n  // Group (non-repeatable) → a nested object of dotted-path leaf bindings.\n  if (zones?.nonRepeatable?.length) {\n    const body = zones.nonRepeatable\n      .map((child) => fieldBinding(child, path, `${indent}  `))\n      .join(\"\\n\");\n    return `${indent}${name}: {\\n${body}\\n${indent}},`;\n  }\n  // Repeater → `$(i)` + scalar sub-field accessors.\n  if (zones?.repeatable?.fields?.length) {\n    return `${indent}${name}: ${repeaterBinding(zones.repeatable.fields, path, indent)},`;\n  }\n  // Primitive list (`config.itemType` or bare) → `$(i)` + synthetic `value(i)`.\n  const lines = [\n    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n    `${indent}  value: (i: number) => bcmsField(${indexedPath(`${path}[`, \"].value\")}, \"text\"),`,\n  ];\n  return `${indent}${name}: {\\n${lines.join(\"\\n\")}\\n${indent}},`;\n}\n\n/** Render the binding entries for one model's fields (field order preserved). */\nfunction fieldsToBindings(fields: ContentModelField[], indent: string): string {\n  return fields.map((field) => fieldBinding(field, \"\", indent)).join(\"\\n\");\n}\n\n/** The self-contained runtime emitted once at the top of every bindings file. */\nconst PREAMBLE = `/**\n * Binding attributes for a CMS-bound element. Spread onto the element that renders a\n * field: \\`<h1 {...bcmsField(\"title\", \"text\")}>\\`. Always emitted, on every build —\n * two inert \\`data-*\\` attributes are what makes the site editable in Live Preview.\n */\nexport function bcmsField(path: string, kind: string): Record<string, string> {\n  return { \"data-bcms-field\": path, \"data-bcms-kind\": kind };\n}\n`;\n\n/**\n * Generate the Live Preview bindings module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateBindings(\n  models: GeneratableModel[],\n  opts: GenerateOptions = {},\n): string {\n  const version = opts.version ?? \"0.1.0\";\n  // Code-unit sort (NOT localeCompare) so output is byte-identical on every machine.\n  const sorted = [...models].sort((a, b) =>\n    a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n  );\n\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>\n// Spread these onto the elements that render your content; they emit\n// data-bcms-field/data-bcms-kind on every build.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const entries = sorted.map((model) => {\n    const body = model.fields.length\n      ? `\\n${fieldsToBindings(model.fields, \"    \")}\\n  `\n      : \"\";\n    return `  ${JSON.stringify(model.slug)}: {${body}},`;\n  });\n\n  const bcms = `/**\n * Field bindings keyed by model slug. Spread a binding onto the element that renders\n * that field. Arrays expose \\`$(i)\\` for the item element and one accessor per\n * (one-level) sub-field; primitive arrays expose \\`value(i)\\` for the item's scalar.\n */\nexport const bcms = {\n${entries.join(\"\\n\") || \"  // (no models defined yet)\"}\n} as const;`;\n\n  return [header, PREAMBLE, bcms, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → typed React render components generator.\n *\n * Companion to {@link generateTypes} (types) and {@link generateBindings} (Live\n * Preview attributes). This emits a small, self-contained `.tsx` module with two\n * components that render the canonical Delivery field shapes CORRECTLY, so authors\n * never hand-roll the rendering that produces the classic bugs:\n *\n *   - <RichText> renders the server-sanitized `html` via `dangerouslySetInnerHTML`,\n *     instead of interpolating the value as a JSX child (which React escapes, so the\n *     page shows literal `<p>…</p>` tags — the #6 escaped-richtext bug).\n *   - <Image> reads the normalized image object's `.url`/`.altText`, instead of\n *     treating the object as a string.\n *\n * The emitted module is intentionally generic (not per-model) and dependency-free\n * beyond React, so it is a drop-in: point codegen at a path and import the two\n * components. It is deterministic (no clock, no I/O) like the sibling generators.\n *\n * Security: `html` is the Delivery API's server-rendered, DOMPurify-sanitized output\n * (see the RichText type docs). `<RichText>` injects exactly that field. If a caller\n * passes HTML from another, untrusted source they must sanitize it themselves.\n */\n\nimport type { GenerateOptions } from \"./generate.js\";\n\n/**\n * Generate the `bettercms.components.tsx` module: typed `<RichText>` and `<Image>`\n * components for the canonical Delivery field shapes. Deterministic — same options\n * in, identical string out.\n */\nexport function generateComponents(opts: GenerateOptions = {}): string {\n  const version = opts.version ?? \"0.1.0\";\n  const header = `// ⚠️  AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen --components-out <path>\n// Typed render components for BetterCMS field shapes. Use these instead of\n// hand-rendering richtext/image values — they render the canonical shapes correctly.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n  const body = `import * as React from \"react\";\n\n/** Rich-text value from the Delivery API. \\`html\\` is server-rendered + sanitized. */\nexport type RichTextValue = {\n  readonly format: string;\n  readonly value: unknown;\n  readonly html?: string;\n  /**\n   * Structured blocks — Body (\\`document\\`) fields only, and optional even there: derived at\n   * write time, so entries saved before it existed carry none until re-saved. No backfill.\n   * Block ids are stable within one document only, never a global key.\n   */\n  readonly doc?: { readonly version: 1; readonly blocks: readonly { readonly id: string; readonly type: string; readonly [k: string]: unknown }[] };\n};\n\n/** Normalized image/media value from the Delivery API. */\nexport interface BetterCMSImageValue {\n  readonly url: string;\n  readonly altText?: string | null;\n  readonly width?: number;\n  readonly height?: number;\n}\n\ntype RichTextProps = {\n  /** The richtext field value (\\`entry.fields.someRichText\\`). */\n  field?: RichTextValue | null;\n  /** Element/component to render as. Default: \\`\"div\"\\`. */\n  as?: React.ElementType;\n} & Omit<React.HTMLAttributes<HTMLElement>, \"dangerouslySetInnerHTML\" | \"children\">;\n\n/**\n * Render a richtext field as HTML. Uses the server-sanitized \\`html\\` via\n * \\`dangerouslySetInnerHTML\\` — NEVER interpolate a richtext value as a JSX child\n * (React escapes it, so the page shows literal tags). Renders nothing when unset.\n */\nexport function RichText({ field, as: Tag = \"div\", ...rest }: RichTextProps) {\n  if (!field || !field.html) return null;\n  return <Tag {...rest} dangerouslySetInnerHTML={{ __html: field.html }} />;\n}\n\ntype ImageProps = {\n  /** The image field value (\\`entry.fields.someImage\\`). */\n  field?: BetterCMSImageValue | null;\n  /** Alt text override; defaults to the field's \\`altText\\`, then \\`\"\"\\`. */\n  alt?: string;\n} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, \"src\">;\n\n/**\n * Render an image field as an \\`<img>\\` from its normalized \\`.url\\`/\\`.altText\\`.\n * Renders nothing when unset. Pass \\`alt\\` to override the stored alt text.\n */\nexport function Image({ field, alt, ...rest }: ImageProps) {\n  if (!field || !field.url) return null;\n  return (\n    <img\n      src={field.url}\n      alt={alt ?? field.altText ?? \"\"}\n      width={field.width}\n      height={field.height}\n      {...rest}\n    />\n  );\n}\n`;\n\n  return [header, body].join(\"\\n\");\n}\n","/**\n * Fetches content models from the BetterCMS Management API so the CLI can generate\n * types against a live project. Kept dependency-free (plain fetch) so the generated\n * artifact and this fetcher can run anywhere — a GitHub Action, a postinstall, a script.\n */\n\nimport type { GeneratableModel } from \"./generate.js\";\n\nexport interface FetchModelsOptions {\n  /** Management API base, e.g. \"https://api.bettercms.ai/api/v1\". */\n  apiUrl: string;\n  /** A management-scoped key (content:manage) or device-minted token. */\n  apiKey: string;\n  /** Optional fetch override (testing / custom runtime). */\n  fetchImpl?: typeof fetch;\n}\n\ninterface ManagedModelRow {\n  slug: string;\n  name?: string;\n  description?: string | null;\n  fields: GeneratableModel[\"fields\"];\n}\n\n/**\n * GET /management/content/models — returns the project's models (the key is\n * project-scoped server-side, so this is exactly the schema for this site).\n */\nexport async function fetchModels(\n  opts: FetchModelsOptions,\n): Promise<GeneratableModel[]> {\n  const doFetch = opts.fetchImpl ?? globalThis.fetch;\n  const base = opts.apiUrl.replace(/\\/+$/, \"\");\n  const url = `${base}/management/content/models`;\n\n  let res: Response;\n  try {\n    res = await doFetch(url, {\n      // No Content-Type: this is a bodyless GET; the header is incorrect here and\n      // strict edge runtimes/proxies may reject it.\n      headers: { Authorization: `Bearer ${opts.apiKey}`, Accept: \"application/json\" },\n    });\n  } catch (err) {\n    throw new Error(\n      `Could not reach the BetterCMS Management API at ${url}: ${\n        err instanceof Error ? err.message : String(err)\n      }`,\n    );\n  }\n\n  if (!res.ok) {\n    const hint =\n      res.status === 401 || res.status === 403\n        ? \" — check your management API key (it must have the content:manage scope).\"\n        : \"\";\n    throw new Error(`Management API returned ${res.status} ${res.statusText}${hint}`);\n  }\n\n  const body = (await res.json()) as { data?: ManagedModelRow[] };\n  const rows = body.data ?? [];\n  return rows.map((r) => ({\n    slug: r.slug,\n    name: r.name,\n    description: r.description ?? null,\n    fields: r.fields ?? [],\n  }));\n}\n"],"mappings":";AAgCA,IAAM,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAA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","names":["VALID_IDENT","propName","PREAMBLE"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettercms-ai/codegen",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "Generate TypeScript types from your BetterCMS content schema — the single source of truth shared by the dashboard builder and the MCP tools.",
   "bin": {