@bettercms-ai/convert 0.6.0 → 0.7.0

package/dist/index.js

@@ -141,195 +141,77 @@ function propsAttribute(props) {
   return `data-bcms-props="${value}"`;
 }
 
-// src/helper.ts
-import { createHash as createHash2 } from "crypto";
-var HELPER_VERSION = 4;
-var HEADER = "// @bettercms-ai/convert helper v";
-var HELPER_PATH = Object.fromEntries(
-  Object.keys(DIALECT_RULES).map((d) => [d, DIALECT_RULES[d].helper])
-);
-var CONTENT_DIR = "bcms-content";
-var STUB_CONTENT = "{}";
-function relativeImport(fromFile, toFile) {
-  const from = fromFile.split("/").slice(0, -1);
-  const to = toFile.split("/");
-  let shared = 0;
-  while (shared < from.length && shared < to.length - 1 && from[shared] === to[shared]) shared++;
-  const up = from.length - shared;
-  const path = [...Array(up).fill(".."), ...to.slice(shared)].join("/");
-  return up === 0 ? `./${path}` : path;
-}
-function helperSource(dialect) {
-  const path = HELPER_PATH[dialect];
-  if (!path) throw new Error(`The ${dialect} dialect reads its values at publish time, not at build time.`);
-  const layout = relativeImport(path, `${CONTENT_DIR}/layout.json`);
-  return `${HEADER}${HELPER_VERSION}
-// Values come from bcms-content/*.json, written into the tree before the build. The committed
-// stubs are {} \u2014 a build with them renders every fallback below and still succeeds.
-import layoutSnapshot from "${layout}";
-
-const isRecord = (v: unknown): v is Record<string, unknown> =>
-  typeof v === "object" && v !== null && !Array.isArray(v);
-
-/** Dotted keys and \`[n]\` indices, positionally \u2014 the editor's own path grammar. */
-function readPath(root: unknown, path: string): unknown {
-  let cursor: unknown = root;
-  for (const segment of path.split(".")) {
-    if (!segment) return undefined;
-    const key = segment.replace(/\\[\\d+\\]/g, "");
-    if (key) {
-      if (!isRecord(cursor)) return undefined;
-      cursor = cursor[key];
+// src/declarations.ts
+var BINDING_ATTR = /data-bcms-(?:layout-)?field\s*=\s*["']([^"']+)["']/g;
+var PROPS_ATTR = /data-bcms-props\s*=\s*["']([^"']+)["']/g;
+var TEMPLATE_SCAN = /:?data-bcms-(?:layout-)?field\s*=\s*(?:\{\s*`([^`]+)`\s*\}|"\s*`([^`]+)`\s*")/g;
+var BINDINGS_SCAN = /bcmsBindings\s*=\s*\{\{[^}]*\}\}/g;
+var propsDeclarations = (value, at) => value.split(";").flatMap((entry) => {
+  const [address, kind] = entry.split("|");
+  if (!address) return [];
+  const scope = address.startsWith("layout:") ? "layout" : "page";
+  return [{ scope, path: stripLayoutPrefix(address), kind: kind ?? "", at, via: "props" }];
+});
+var propsPaths = (value) => propsDeclarations(value, 0).map((d) => ({ scope: d.scope, path: d.path }));
+var TEMPLATE_BINDING = /^:?data-bcms-(?:layout-)?field\s*=\s*(?:\{\s*`([^`]+)`\s*\}|"\s*`([^`]+)`\s*")$/;
+var shapeOfPath = (path) => path.replace(/\[(?:\d+|\$\{[^}]*\})\]/g, "[*]");
+function declarationsIn(roots, content) {
+  const out = [];
+  const visit = (node) => {
+    if (node.type === "expr") {
+      for (const child of node.children) visit(child);
+      return;
     }
-    for (const index of segment.matchAll(/\\[(\\d+)\\]/g)) {
-      if (!Array.isArray(cursor)) return undefined;
-      cursor = cursor[Number(index[1])];
+    if (node.type !== "element") return;
+    const kind = node.attrs.find((a) => a.name === "data-bcms-kind")?.value ?? "";
+    const at = node.attrInsertAt;
+    for (const attr of node.attrs) {
+      const name = attr.name.replace(/^:/, "");
+      if (name === "data-bcms-field" || name === "data-bcms-layout-field") {
+        const scope = name === "data-bcms-layout-field" ? "layout" : "page";
+        const template = content.slice(attr.range.start, attr.range.end).match(TEMPLATE_BINDING);
+        const templated = template?.[1] ?? template?.[2];
+        if (templated) out.push({ scope, path: shapeOfPath(stripLayoutPrefix(templated)), kind, at, via: "field" });
+        else if (attr.value) out.push({ scope, path: stripLayoutPrefix(attr.value), kind, at, via: "field" });
+      } else if (attr.name === "data-bcms-props") {
+        out.push(...propsDeclarations(attr.value, at));
+      } else if (attr.name === "bcmsBindings") {
+        for (const path of bindingsPaths(content.slice(attr.range.start, attr.range.end))) {
+          out.push({ scope: "page", path, kind: "", at, via: "prop" });
+        }
+      }
     }
-  }
-  return cursor;
-}
-
-/** A stored value as a template renders it: richtext is its html, an image is its url. */
-function render(value: unknown): string | undefined {
-  if (typeof value === "string") return value;
-  if (typeof value === "number" || typeof value === "boolean") return String(value);
-  if (isRecord(value)) {
-    if (typeof value.html === "string") return value.html;
-    if (typeof value.url === "string") return value.url;
-  }
-  return undefined;
-}
-
-/** One field of one page. \`slug\` selects the entry on a dynamic route. */
-export function bcms(page: unknown, path: string, fallback: string, slug?: string): string {
-  const entries = isRecord(page) ? page.entries : undefined;
-  const root = slug !== undefined && isRecord(entries) ? entries[slug] : page;
-  return render(readPath(root, path)) ?? fallback;
-}
-
-/** One field of the shared layout \u2014 the header and footer every route renders. */
-export function bcmsLayout(path: string, fallback: string): string {
-  return render(readPath(layoutSnapshot, path)) ?? fallback;
-}
-
-/**
- * The ROWS of a repeater. \`fallback\` is every row the template shipped with, so a build against
- * an empty snapshot still renders the same number of cards it always did.
- */
-export function bcmsRows<T>(page: unknown, path: string, fallback: T[], slug?: string): T[] {
-  const entries = isRecord(page) ? page.entries : undefined;
-  const root = slug !== undefined && isRecord(entries) ? entries[slug] : page;
-  const value = readPath(root, path);
-  return Array.isArray(value) ? (value as T[]) : fallback;
-}
-
-/**
- * ONE SECTION's copy, for a component extracted by \`--componentize\`.
- *
- * OVERRIDES FIRST, PER KEY: \`overrides[key] ?? group[key]\`. An instance that owns its copy
- * (Phase B) carries an override for every prop it declares, so the group underneath it is never
- * read; a placement still bound to a page field group (Phase A) carries none, so the group is all
- * there is. The interesting case is the one in between \u2014 a section half moved \u2014 where a key the
- * instance does not hold has to keep rendering the page's value rather than nothing.
- *
- * \u{1F534} \`??\`, NOT \`||\`. An empty string is a value an editor typed, and treating it as absent put
- * the page's old copy back into a heading somebody had deliberately cleared.
- *
- * With neither an override nor a group, the answer is \`{}\` and every \`bcms(...)\` below renders
- * the fallback the template shipped with \u2014 which is why a section renders correctly against the
- * committed \`{}\` stub.
- */
-export function bcmsSection(page: unknown, bind?: string, overrides?: unknown): Record<string, unknown> {
-  const group = bind ? readPath(page, bind) : undefined;
-  const base: Record<string, unknown> = isRecord(group) ? { ...group } : {};
-  if (!isRecord(overrides)) return base;
-  for (const key of Object.keys(overrides)) {
-    const value = overrides[key];
-    if (value === undefined || value === null) continue;
-    /**
-     * \u{1F534} A TABLE PROP IS STORED AS \`{ rows: [...] }\` AND READ AS A LIST. That is the shape the
-     * dashboard edits a repeater in; handing it to \`bcmsRows\` unchanged is not an array, so the
-     * helper fell back to the rows the template shipped with and the editor's work never showed.
-     */
-    base[key] = isRecord(value) && Array.isArray(value.rows) ? value.rows : value;
-  }
-  return base;
-}
-
-/**
- * WHICH ADDRESS one bound element declares \u2014 decided at RENDER time, from the placement.
- *
- * An element carries exactly ONE \`data-bcms-field\`, and which lane it names depends on where its
- * copy lives. A placement that owns its copy declares the BLOCK lane \u2014
- * \`<blockId>__overrides.<propKey>\` \u2014 because that is the address the editor commits an instance's
- * own value to. A placement bound to a page field group declares the PAGE path, which is what the
- * page form and the coverage meter already know.
- *
- * \u{1F534} THE BOUND ADDRESS IS RE-BASED ONTO **THIS** PLACEMENT'S GROUP. The markup was cut from ONE
- * page and carries that page's paths (\`hero.title\`); the whole point of \`shapeHash\` is that a
- * second page renders the same component bound to a group of its own (\`bind="landingHero"\`).
- * Handing the embedded path through unchanged declared \`hero.title\` on a page whose field is
- * \`landingHero.title\` \u2014 an address that page does not have, so the editor wrote into nothing and
- * the meter counted a binding that was never there. The prefix the markup was cut with comes out,
- * the placement's own group goes in.
- *
- * \u{1F534} THE SAME EXTRACTED FILE SERVES BOTH LANES. The choice is a function of the props, never of
- * how the codemod ran: one component renders a Phase A placement on one page and a Phase B
- * instance on the next, and a repository does not have to be re-cut when its copy moves.
- */
-export function bcmsFields(
-  placement: { blockId?: string; bind?: string; overrides?: unknown },
-  pathPrefix: string,
-): (path: string) => string {
-  const id = placement.blockId;
-  const own = typeof id === "string" && id !== "" && !placement.bind && isRecord(placement.overrides);
-  /**
-   * What replaces the prefix the markup was cut with, or null for "leave every path alone".
-   *
-   * Null covers a placement with neither a bind nor an instance \u2014 a shipped fallback, or a page
-   * nobody has componentized yet \u2014 and a bound placement in a component whose prefix is EMPTY,
-   * where the plan said the prop key IS the whole page path: there is no group segment to swap,
-   * so prepending one would invent an address rather than correct it.
-   */
-  const lane = own ? \`\${id}__overrides.\` : placement.bind && pathPrefix ? \`\${placement.bind}.\` : null;
-  return (path: string): string => {
-    // A path outside the group this section was cut from is not one this placement re-addresses:
-    // it names a key the instance does not hold and a group this placement is not bound to.
-    // (An EMPTY prefix is a plan saying the prop key IS the page path, and matches everything.)
-    if (lane === null || !path.startsWith(pathPrefix)) return path;
-    return lane + path.slice(pathPrefix.length);
+    for (const child of node.children) visit(child);
   };
+  for (const root of roots) visit(root);
+  return out;
 }
-`;
-}
-var HISTORICAL = {
-  "src/bcms-content.ts": {
-    1: "c272412532efed7db64b6cf313b2bed4291f9951430412289c8a588b7f565407",
-    2: "51e2ae65ddd86bf43d14e29b3865e3f16e45f72069692d1fea57e1f986a894f0",
-    3: "d4305b2983adcb456ef782d35ea9d083a04465c2b68baa0d44a084dfa01a9227"
-  },
-  "src/lib/bcms-content.ts": {
-    1: "ae72ae14d706943d481c880d70da5789b4816ba1ba319a10fbc63ded4d0b42f2",
-    2: "a18731eb42f7db55dac0591c45f873758cde8e103fefcd6e5caf67936ae6a002",
-    3: "0be9c73160361882a038552bc02673c14ed532287823dabaafe36179bc55ed7e"
-  },
-  "composables/bcms-content.ts": {
-    1: "c272412532efed7db64b6cf313b2bed4291f9951430412289c8a588b7f565407",
-    2: "51e2ae65ddd86bf43d14e29b3865e3f16e45f72069692d1fea57e1f986a894f0",
-    3: "d4305b2983adcb456ef782d35ea9d083a04465c2b68baa0d44a084dfa01a9227"
+var bindingsPaths = (text) => [...text.matchAll(/["']([^"']+)["']/g)].map((match) => match[1]);
+var scopedPath = (scope, path) => `${scope}::${path}`;
+var covers = (declared, target) => declared !== void 0 && (declared.has(scopedPath(target.scope, target.path)) || declared.has(scopedPath(target.scope, shapeOfPath(target.path))));
+var declaredInTree = (roots, content) => new Set(declarationsIn(roots, content).map((d) => scopedPath(d.scope, d.path)));
+var scannedDeclarations = (content) => [...declaredByScan(content)].map((entry) => {
+  const [scope, ...rest] = entry.split("::");
+  return { scope, path: rest.join("::") };
+});
+function declaredByScan(content) {
+  const out = /* @__PURE__ */ new Set();
+  const add = (scope, path) => void out.add(scopedPath(scope, path));
+  for (const match of content.matchAll(BINDING_ATTR)) {
+    add(match[0].includes("layout-field") ? "layout" : "page", stripLayoutPrefix(match[1]));
   }
-};
-var sha256 = (value) => createHash2("sha256").update(value, "utf8").digest("hex");
-function isKnownHelper(content, dialect) {
-  if (content === helperSource(dialect)) return HELPER_VERSION;
-  const path = HELPER_PATH[dialect];
-  if (!path) return null;
-  const digest = sha256(content);
-  for (const [version, known] of Object.entries(HISTORICAL[path] ?? {})) {
-    if (known === digest) return Number(version);
+  for (const match of content.matchAll(TEMPLATE_SCAN)) {
+    add(match[0].includes("layout-field") ? "layout" : "page", shapeOfPath(stripLayoutPrefix(match[1] ?? match[2])));
   }
-  return null;
+  for (const match of content.matchAll(BINDINGS_SCAN)) for (const path of bindingsPaths(match[0])) add("page", path);
+  for (const match of content.matchAll(PROPS_ATTR))
+    for (const entry of propsPaths(match[1])) add(entry.scope, entry.path);
+  return out;
 }
+var stripLayoutPrefix = (value) => value.startsWith("layout:") ? value.slice("layout:".length) : value;
+
+// src/sites/jsx.ts
+import { parse as parseModule } from "@babel/parser";
 
 // src/entities.ts
 var LONGEST_ENTITY = 32;
@@ -2667,202 +2549,6 @@ function decodeStringEscapes(body) {
 }
 var unwrapJsxStrings = (value) => value.replace(JSX_STRING_CHILD, (_whole, _quote, body) => decodeStringEscapes(body));
 
-// src/locate.ts
-var flat = (value) => value.replace(/\s+/g, " ").trim();
-var stripTags = (value) => value.replace(/<br\s*\/?>/gi, " ").replace(/<[^>]*>/g, "");
-function locate(brief, sources, options) {
-  const flattened = sources.map((s) => {
-    const readable = unwrapJsxStrings(decodeEntities(s.content));
-    return {
-      path: s.path,
-      content: flat(readable),
-      text: options?.stripTags ? flat(stripTags(readable)) : null
-    };
-  });
-  const located = [];
-  const unlocated = [];
-  for (const page of brief.pages) {
-    for (const p of page.paths) {
-      const original = p.original === null ? "" : flat(p.original);
-      if (!original) {
-        unlocated.push({ route: page.route, scope: p.scope, path: p.path, reason: "no-original" });
-        continue;
-      }
-      const files = flattened.filter((f) => f.content.includes(original) || f.text !== null && f.text.includes(original)).map((f) => f.path);
-      if (files.length === 0) {
-        unlocated.push({ route: page.route, scope: p.scope, path: p.path, reason: "not-in-source" });
-        continue;
-      }
-      located.push({ route: page.route, scope: p.scope, path: p.path, kind: p.kind, original, files });
-    }
-  }
-  return { located, unlocated };
-}
-
-// src/loops.ts
-import MagicString from "magic-string";
-
-// src/declarations.ts
-var BINDING_ATTR = /data-bcms-(?:layout-)?field\s*=\s*["']([^"']+)["']/g;
-var PROPS_ATTR = /data-bcms-props\s*=\s*["']([^"']+)["']/g;
-var TEMPLATE_SCAN = /:?data-bcms-(?:layout-)?field\s*=\s*(?:\{\s*`([^`]+)`\s*\}|"\s*`([^`]+)`\s*")/g;
-var BINDINGS_SCAN = /bcmsBindings\s*=\s*\{\{[^}]*\}\}/g;
-var propsDeclarations = (value, at) => value.split(";").flatMap((entry) => {
-  const [address, kind] = entry.split("|");
-  if (!address) return [];
-  const scope = address.startsWith("layout:") ? "layout" : "page";
-  return [{ scope, path: stripLayoutPrefix(address), kind: kind ?? "", at, via: "props" }];
-});
-var propsPaths = (value) => propsDeclarations(value, 0).map((d) => ({ scope: d.scope, path: d.path }));
-var TEMPLATE_BINDING = /^:?data-bcms-(?:layout-)?field\s*=\s*(?:\{\s*`([^`]+)`\s*\}|"\s*`([^`]+)`\s*")$/;
-var shapeOfPath = (path) => path.replace(/\[(?:\d+|\$\{[^}]*\})\]/g, "[*]");
-function declarationsIn(roots, content) {
-  const out = [];
-  const visit = (node) => {
-    if (node.type === "expr") {
-      for (const child of node.children) visit(child);
-      return;
-    }
-    if (node.type !== "element") return;
-    const kind = node.attrs.find((a) => a.name === "data-bcms-kind")?.value ?? "";
-    const at = node.attrInsertAt;
-    for (const attr of node.attrs) {
-      const name = attr.name.replace(/^:/, "");
-      if (name === "data-bcms-field" || name === "data-bcms-layout-field") {
-        const scope = name === "data-bcms-layout-field" ? "layout" : "page";
-        const template = content.slice(attr.range.start, attr.range.end).match(TEMPLATE_BINDING);
-        const templated = template?.[1] ?? template?.[2];
-        if (templated) out.push({ scope, path: shapeOfPath(stripLayoutPrefix(templated)), kind, at, via: "field" });
-        else if (attr.value) out.push({ scope, path: stripLayoutPrefix(attr.value), kind, at, via: "field" });
-      } else if (attr.name === "data-bcms-props") {
-        out.push(...propsDeclarations(attr.value, at));
-      } else if (attr.name === "bcmsBindings") {
-        for (const path of bindingsPaths(content.slice(attr.range.start, attr.range.end))) {
-          out.push({ scope: "page", path, kind: "", at, via: "prop" });
-        }
-      }
-    }
-    for (const child of node.children) visit(child);
-  };
-  for (const root of roots) visit(root);
-  return out;
-}
-var bindingsPaths = (text) => [...text.matchAll(/["']([^"']+)["']/g)].map((match) => match[1]);
-var scopedPath = (scope, path) => `${scope}::${path}`;
-var covers = (declared, target) => declared !== void 0 && (declared.has(scopedPath(target.scope, target.path)) || declared.has(scopedPath(target.scope, shapeOfPath(target.path))));
-var declaredInTree = (roots, content) => new Set(declarationsIn(roots, content).map((d) => scopedPath(d.scope, d.path)));
-var scannedDeclarations = (content) => [...declaredByScan(content)].map((entry) => {
-  const [scope, ...rest] = entry.split("::");
-  return { scope, path: rest.join("::") };
-});
-function declaredByScan(content) {
-  const out = /* @__PURE__ */ new Set();
-  const add = (scope, path) => void out.add(scopedPath(scope, path));
-  for (const match of content.matchAll(BINDING_ATTR)) {
-    add(match[0].includes("layout-field") ? "layout" : "page", stripLayoutPrefix(match[1]));
-  }
-  for (const match of content.matchAll(TEMPLATE_SCAN)) {
-    add(match[0].includes("layout-field") ? "layout" : "page", shapeOfPath(stripLayoutPrefix(match[1] ?? match[2])));
-  }
-  for (const match of content.matchAll(BINDINGS_SCAN)) for (const path of bindingsPaths(match[0])) add("page", path);
-  for (const match of content.matchAll(PROPS_ATTR))
-    for (const entry of propsPaths(match[1])) add(entry.scope, entry.path);
-  return out;
-}
-var stripLayoutPrefix = (value) => value.startsWith("layout:") ? value.slice("layout:".length) : value;
-
-// src/scope.ts
-function patternNames(node, out) {
-  if (!node || typeof node !== "object") return;
-  const typed = node;
-  switch (typed.type) {
-    case "Identifier":
-      out.add(String(typed.name));
-      return;
-    case "ObjectPattern":
-      for (const property of typed.properties ?? [])
-        patternNames(property.type === "RestElement" ? property.argument : property.value, out);
-      return;
-    case "ArrayPattern":
-      for (const element of typed.elements ?? []) patternNames(element, out);
-      return;
-    case "AssignmentPattern":
-      patternNames(typed.left, out);
-      return;
-    case "RestElement":
-      patternNames(typed.argument, out);
-      return;
-    default:
-      return;
-  }
-}
-function statementNames(node, out) {
-  if (!node || typeof node !== "object") return;
-  const typed = node;
-  switch (typed.type) {
-    case "ExportNamedDeclaration":
-    case "ExportDefaultDeclaration":
-      statementNames(typed.declaration, out);
-      return;
-    case "ImportDeclaration":
-      for (const specifier of typed.specifiers ?? []) patternNames(specifier.local, out);
-      return;
-    case "VariableDeclaration":
-      for (const declarator of typed.declarations ?? []) patternNames(declarator.id, out);
-      return;
-    case "FunctionDeclaration":
-    case "ClassDeclaration":
-    case "TSTypeAliasDeclaration":
-    case "TSInterfaceDeclaration":
-    case "TSEnumDeclaration":
-    case "TSModuleDeclaration":
-      patternNames(typed.id, out);
-      return;
-    default:
-      return;
-  }
-}
-var DECLARED = /\b(?:const|let|var|function|class|interface|type|enum)\s+([A-Za-z_$][\w$]*)/g;
-var IMPORTED = /\bimport\s+([^;\n]*?)\s+from\b/g;
-function scanNames(code, out) {
-  for (const match of code.matchAll(DECLARED)) out.add(match[1]);
-  for (const match of code.matchAll(IMPORTED))
-    for (const name of match[1].match(/[A-Za-z_$][\w$]*/g) ?? []) {
-      if (name !== "as" && name !== "type") out.add(name);
-    }
-}
-function scriptText(nodes, content, out) {
-  for (const node of nodes) {
-    if (node.type !== "element") continue;
-    if (node.raw && node.tag === "script" && node.inner) out.push(content.slice(node.inner.start, node.inner.end));
-    scriptText(node.children, content, out);
-  }
-}
-function topLevelBindings(dialect, parsed, content) {
-  const out = /* @__PURE__ */ new Set();
-  const program = parsed.ast?.program;
-  if (program) for (const statement of program.body ?? []) statementNames(statement, out);
-  else if (parsed.script) scanNames(parsed.script.code, out);
-  if (dialect === "html") {
-    const scripts = [];
-    scriptText(parsed.roots, content, scripts);
-    for (const code of scripts) scanNames(code, out);
-  }
-  return out;
-}
-function allocateNames(taken, wanted) {
-  const used = new Set(taken);
-  const out = /* @__PURE__ */ new Map();
-  for (const { key, name } of wanted) {
-    if (out.has(key)) continue;
-    let candidate = name;
-    for (let n = 1; used.has(candidate); n++) candidate = `${name}_${n}`;
-    used.add(candidate);
-    out.set(key, candidate);
-  }
-  return out;
-}
-
 // src/sites/shared.ts
 var isIntrinsic = (tag) => tag !== "" && !tag.includes(".") && tag[0] === tag[0].toLowerCase();
 var IMAGE_SOURCES = {
@@ -2903,7 +2589,7 @@ function renderedText(node) {
 var attrsOf = (node) => Object.fromEntries(node.attrs.map((a) => [a.name, a.value]));
 function soleTextChild(node) {
   const texts = node.children.filter((c) => c.type === "text" && !isBlank(c.value));
-  return texts.length === 1 ? texts[0].range : null;
+  return texts.length === 1 ? texts[0] : null;
 }
 function collectSites(roots, literals) {
   const wanted = new Set(literals.map(norm));
@@ -2963,13 +2649,39 @@ function collectSites(roots, literals) {
         scope: "page",
         existingAttrs: attrs,
         mixed: node.children.some((c) => c.type !== "text"),
-        textRange: soleTextChild(node),
+        textRange: soleTextChild(node)?.range ?? null,
         literal,
         partial: false,
         ancestors: walk.ancestors,
         siblingIndex: walk.siblingIndex
       });
     }
+    const own = soleTextChild(node);
+    if (own && node.children.some((c) => c.type !== "text")) {
+      const value = norm(own.value);
+      for (const literal of wanted) {
+        if (matched.has(literal) || value !== literal) continue;
+        matched.add(literal);
+        sites.push({
+          file: "",
+          tag: node.tag,
+          attrInsertAt: node.attrInsertAt,
+          // The TEXT NODE's bytes, not the element's: two values inside one element must not be
+          // read as claiming the same span. @see overlapping
+          range: own.range,
+          inner: node.inner,
+          where: "text",
+          scope: "page",
+          existingAttrs: attrs,
+          mixed: true,
+          textRange: own.range,
+          literal,
+          partial: false,
+          ancestors: walk.ancestors,
+          siblingIndex: walk.siblingIndex
+        });
+      }
+    }
     const bindingsAttr = node.attrs.find((a) => a.name === "bcmsBindings")?.range;
     for (const attr of node.attrs) {
       if (attr.expression || !attr.valueRange || BCMS_ATTRS.includes(attr.name)) continue;
@@ -3036,7 +2748,7 @@ function partials(node, literals, walk, out) {
       scope: "page",
       existingAttrs: attrsOf(node),
       mixed: node.children.some((c) => c.type !== "text"),
-      textRange: soleTextChild(node),
+      textRange: soleTextChild(node)?.range ?? null,
       literal,
       partial: true,
       ancestors: walk.ancestors,
@@ -3056,264 +2768,32 @@ function wordBounded(haystack, needle) {
   return false;
 }
 
-// src/loops.ts
-function splitNested(leaf) {
-  const match = leaf.match(/^([^[\]]+)\[(\d+)\]\.(.+)$/);
-  return match ? { array: match[1], index: Number(match[2]), leaf: match[3] } : null;
-}
-var elementEnd = (node) => node.inner ? node.inner.end + node.tag.length + 3 : null;
-function findRows(roots, members) {
-  const wanted = new Set(members.map((m) => m.index));
-  const search = (node) => {
-    if (node.type !== "element") return null;
-    for (const child of node.children) {
-      const deeper = search(child);
-      if (deeper) return deeper;
-    }
-    const rows = [];
-    for (const child of node.children) {
-      if (child.type !== "element") continue;
-      const end = elementEnd(child);
-      if (end === null) continue;
-      const inside = members.filter((m) => m.site.range.start >= child.start && m.site.range.end <= end);
-      if (inside.length === 0) continue;
-      const indices = new Set(inside.map((m) => m.index));
-      if (indices.size !== 1) return null;
-      rows.push({
-        index: inside[0].index,
-        range: { start: child.start, end },
-        attrInsertAt: child.attrInsertAt,
-        // `:key` in vue, `key` in jsx — one existing key, whichever way it is spelled.
-        keyAttr: child.attrs.find((a) => a.name.replace(/^:/, "") === "key")?.range ?? null,
-        node: child,
-        members: inside
-      });
-    }
-    if (rows.length === 0) return null;
-    const covered = new Set(rows.flatMap((r) => r.members.map((m) => m.index)));
-    if (covered.size !== wanted.size || rows.length !== wanted.size) return null;
-    if (rows.some((r) => r.members.length !== members.length / wanted.size)) return null;
-    return rows.sort((a, b) => a.range.start - b.range.start);
-  };
-  for (const root of roots) {
-    const found = search(root);
-    if (found) return found;
-  }
-  return null;
-}
-var consecutive = (rows, content) => rows.every((row, at) => at === 0 || content.slice(rows[at - 1].range.end, row.range.start).trim() === "");
-function maskedRow(row, content) {
-  const masked = new Map(row.members.map((member) => [member.site.inner.start, member.leaf]));
-  return canonical(row.node, content, masked);
-}
-var TRIVIA = "
";
-function canonical(node, content, masked) {
-  if (node.type === "text") {
-    return node.value.trim() === "" ? TRIVIA : content.slice(node.range.start, node.range.end);
-  }
-  if (node.type === "comment" || node.type === "expr") {
-    return content.slice(node.range.start, node.range.end);
-  }
-  if (node.type !== "element") return "";
-  const open = content.slice(node.start, node.inner ? node.inner.start : node.attrInsertAt);
-  if (node.inner && masked.has(node.inner.start)) {
-    return `${open}\0${masked.get(node.inner.start)}\0</${node.tag}>`;
-  }
-  const inside = node.children.map((child) => canonical(child, content, masked)).join("");
-  return node.inner ? `${open}${inside}</${node.tag}>` : open;
-}
-function sameShape(rows, content) {
-  const first = maskedRow(rows[0], content);
-  return rows.every((row) => maskedRow(row, content) === first);
-}
-var indented = (body, indent) => body.split("\n").map((line) => line.startsWith(indent) ? `${indent}  ${line.slice(indent.length)}` : `${indent}  ${line}`).join("\n");
-function indentOf(content, at) {
-  const lineStart = content.lastIndexOf("\n", at - 1) + 1;
-  const prefix = content.slice(lineStart, at);
-  return prefix.trim() === "" ? prefix : "";
-}
-function writeLeaf(source, shift, member, rule, read, row, literal) {
-  const site = member.site;
-  const expression = `${read}(${row}, ${JSON.stringify(member.leaf)}, "")`;
-  if (member.kind === "richtext" && rule.richtext) {
-    source.remove(site.inner.start + shift, site.inner.end + shift);
-    source.appendLeft(site.attrInsertAt + shift, ` ${rule.richtext(expression)}`);
-  } else {
-    source.overwrite(site.inner.start + shift, site.inner.end + shift, rule.text(expression));
-  }
-  const kind = member.kind ? ` data-bcms-kind="${member.kind}"` : "";
-  source.appendLeft(site.attrInsertAt + shift, ` ${rule.attr("data-bcms-field", `\`${literal}\``)}${kind}`);
-}
-function emitNested(rule, array, members, prefix, outer, parent, ctx) {
-  if (!rule.loop || !rule.text) return null;
-  const inner = [];
-  for (const member of members) {
-    const split = splitNested(member.leaf);
-    if (!split || splitNested(split.leaf) !== null) return null;
-    inner.push({ ...member, index: split.index, leaf: split.leaf });
-  }
-  const rows = findRows([parent.node], inner);
-  if (!rows || rows.length === 0) return null;
-  if (!consecutive(rows, ctx.content)) return null;
-  if (!sameShape(rows, ctx.content)) return null;
-  const template = rows[0];
-  const used = /* @__PURE__ */ new Set([
-    ...ctx.content.slice(template.range.start, template.range.end).match(/[A-Za-z_$][\w$]*/g) ?? [],
-    outer.row,
-    outer.index
-  ]);
-  const allocated = allocateNames(used, [
-    { key: "row", name: "item" },
-    { key: "index", name: "j" }
-  ]);
-  const names = { row: allocated.get("row"), index: allocated.get("index") };
-  const fallback = [];
-  const writable = inner.every((member) => setLeaf(fallback[member.index] ??= emptyRow(), member.leaf, member.fallback));
-  if (!writable) return null;
-  const source = new MagicString(ctx.content.slice(template.range.start, template.range.end));
-  const shift = -template.range.start;
-  const declarations = [];
-  for (const member of template.members) {
-    const literal = `${prefix}.${array}[\${${names.index}}].${member.leaf}`;
-    writeLeaf(source, shift, member, rule, ctx.read, names.row, literal);
-    declarations.push({ path: shapeOfPath(literal), literal });
-  }
-  const rowsExpr = `${ctx.rows}(${outer.row}, ${JSON.stringify(array)}, ${JSON.stringify(fallback.filter(Boolean))})`;
-  if (rule.loop.kind === "attr") {
-    source.appendRight(template.attrInsertAt + shift, ` ${rule.loop.attr(rowsExpr, names.row, names.index)}`);
-  }
-  if (rule.loopKey) {
-    const key = rule.loopKey(names.index);
-    if (!template.keyAttr) source.appendRight(template.attrInsertAt + shift, ` ${key}`);
-    else if (template.keyAttr.end > template.keyAttr.start)
-      source.overwrite(template.keyAttr.start + shift, template.keyAttr.end + shift, key);
-    else return null;
-  }
-  const indent = indentOf(ctx.content, template.range.start);
-  const text = rule.loop.kind === "wrap" ? `${rule.loop.open(rowsExpr, names.row, names.index)}
-${indented(source.toString(), indent)}
-${indent}${rule.loop.close}` : source.toString();
-  return { range: { start: template.range.start, end: rows[rows.length - 1].range.end }, text, declarations };
-}
-function emitRepeater(dialect, group, arrayPath, fallbackRows, ctx) {
-  const rule = DIALECT_RULES[dialect];
-  if (!rule.loop || !rule.text || group.length === 0) return null;
-  const rows = findRows(ctx.roots, group);
-  if (!rows || rows.length < 2) return null;
-  if (!consecutive(rows, ctx.content)) return null;
-  if (!sameShape(rows, ctx.content)) return null;
-  if (group.some((m) => m.site.where !== "text" || !isIntrinsic(m.site.tag) || !m.site.inner)) return null;
-  const template = rows[0];
-  const used = new Set(ctx.content.slice(template.range.start, template.range.end).match(/[A-Za-z_$][\w$]*/g) ?? []);
-  const allocated = allocateNames(used, [
-    { key: "row", name: "card" },
-    { key: "index", name: "i" }
-  ]);
-  const names = { row: allocated.get("row"), index: allocated.get("index") };
-  const source = new MagicString(ctx.content.slice(template.range.start, template.range.end));
-  const shift = -template.range.start;
-  const declarations = [];
-  const nested = /* @__PURE__ */ new Map();
-  const direct = [];
-  for (const member of template.members) {
-    const inner = splitNested(member.leaf);
-    if (inner === null) direct.push(member);
-    else nested.set(inner.array, [...nested.get(inner.array) ?? [], member]);
-  }
-  for (const [array, members] of nested) {
-    const plan2 = emitNested(rule, array, members, `${arrayPath}[\${${names.index}}]`, names, template, ctx);
-    if (!plan2) return null;
-    if (direct.some((m) => m.site.range.start >= plan2.range.start && m.site.range.end <= plan2.range.end)) return null;
-    source.overwrite(plan2.range.start + shift, plan2.range.end + shift, plan2.text);
-    declarations.push(...plan2.declarations);
-  }
-  for (const member of direct) {
-    const literal = `${arrayPath}[\${${names.index}}].${member.leaf}`;
-    writeLeaf(source, shift, member, rule, ctx.read, names.row, literal);
-    declarations.push({ path: shapeOfPath(literal), literal });
-  }
-  const args = [ctx.snapshot, JSON.stringify(arrayPath), JSON.stringify(fallbackRows), ...ctx.slug ? [ctx.slug] : []];
-  const rowsExpr = `${ctx.rows}(${args.join(", ")})`;
-  if (rule.loop.kind === "attr") {
-    source.appendRight(template.attrInsertAt + shift, ` ${rule.loop.attr(rowsExpr, names.row, names.index)}`);
-  }
-  if (rule.loopKey) {
-    const key = rule.loopKey(names.index);
-    if (!template.keyAttr) source.appendRight(template.attrInsertAt + shift, ` ${key}`);
-    else if (template.keyAttr.end > template.keyAttr.start)
-      source.overwrite(template.keyAttr.start + shift, template.keyAttr.end + shift, key);
-    else return null;
-  }
-  const indent = indentOf(ctx.content, template.range.start);
-  const text = rule.loop.kind === "wrap" ? `${rule.loop.open(rowsExpr, names.row, names.index)}
-${indented(source.toString(), indent)}
-${indent}${rule.loop.close}` : source.toString();
-  return {
-    range: { start: template.range.start, end: rows[rows.length - 1].range.end },
-    text,
-    declarations,
-    bindings: [...new Set(declarations.map((d) => d.path))],
-    names
-  };
-}
-function setLeaf(row, leaf, value) {
-  const segments = leaf.split(".").flatMap((segment) => {
-    const name = segment.replace(/\[\d+\]/g, "");
-    const indices = [...segment.matchAll(/\[(\d+)\]/g)].map((m) => Number(m[1]));
-    return [...name ? [name] : [], ...indices];
-  });
-  if (segments.some((segment) => typeof segment === "string" && FORBIDDEN.has(segment))) return false;
-  let cursor = row;
-  for (const [at, segment] of segments.entries()) {
-    const key = segment;
-    const last = at === segments.length - 1;
-    if (last) {
-      cursor[key] = value;
-      return true;
-    }
-    const held = Object.prototype.hasOwnProperty.call(cursor, key) ? cursor[key] : void 0;
-    if (held === void 0 || typeof held !== "object" || held === null) {
-      cursor[key] = typeof segments[at + 1] === "number" ? [] : emptyRow();
-    }
-    cursor = cursor[key];
-  }
-  return true;
-}
-var FORBIDDEN = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
-var emptyRow = () => /* @__PURE__ */ Object.create(null);
-function splitIndexed(arrayPath, path) {
-  if (!path.startsWith(`${arrayPath}[`)) return null;
-  const match = path.slice(arrayPath.length).match(/^\[(\d+)\]\.(.+)$/);
-  return match ? { index: Number(match[1]), leaf: match[2] } : null;
-}
-
-// src/sites/jsx.ts
-import { parse as parseModule } from "@babel/parser";
-var nameOf = (node) => {
-  if (!node) return "";
-  if (node.type === "JSXIdentifier") return String(node.name);
-  if (node.type === "JSXMemberExpression")
-    return `${nameOf(node.object)}.${nameOf(node.property)}`;
-  if (node.type === "JSXNamespacedName")
-    return `${nameOf(node.namespace)}:${nameOf(node.name)}`;
-  return "";
-};
-var SPREAD = "{...}";
-function attrsOf2(open, content) {
-  return (open.attributes ?? []).flatMap((attr) => {
-    if (attr.type === "JSXSpreadAttribute") {
-      const argument = attr.argument;
-      return [
-        {
-          name: SPREAD,
-          value: content.slice(argument?.start ?? 0, argument?.end ?? 0),
-          valueRange: null,
-          expression: true,
-          range: { start: attr.start ?? 0, end: attr.end ?? 0 },
-          // `{...props}` — the braces ARE the attribute, so the expression is its whole span.
-          expressionRange: { start: attr.start ?? 0, end: attr.end ?? 0 }
-        }
-      ];
+// src/sites/jsx.ts
+var nameOf = (node) => {
+  if (!node) return "";
+  if (node.type === "JSXIdentifier") return String(node.name);
+  if (node.type === "JSXMemberExpression")
+    return `${nameOf(node.object)}.${nameOf(node.property)}`;
+  if (node.type === "JSXNamespacedName")
+    return `${nameOf(node.namespace)}:${nameOf(node.name)}`;
+  return "";
+};
+var SPREAD = "{...}";
+function attrsOf2(open, content) {
+  return (open.attributes ?? []).flatMap((attr) => {
+    if (attr.type === "JSXSpreadAttribute") {
+      const argument = attr.argument;
+      return [
+        {
+          name: SPREAD,
+          value: content.slice(argument?.start ?? 0, argument?.end ?? 0),
+          valueRange: null,
+          expression: true,
+          range: { start: attr.start ?? 0, end: attr.end ?? 0 },
+          // `{...props}` — the braces ARE the attribute, so the expression is its whole span.
+          expressionRange: { start: attr.start ?? 0, end: attr.end ?? 0 }
+        }
+      ];
     }
     if (attr.type !== "JSXAttribute") return [];
     const value = attr.value;
@@ -3756,130 +3236,1090 @@ function tryParse(code) {
   } catch {
     return void 0;
   }
-}
-var bindingsName = (viaProps) => viaProps ? "props.bcmsBindings" : "bcmsBindings";
-var bindingsRead = (prop, viaProps) => `${bindingsName(viaProps)}?.${prop}`;
-
-// src/resolve.ts
-var EXTENSIONS = [".astro", ".tsx", ".jsx", ".ts", ".js", ".svelte", ".vue", ".mjs", ".cjs"];
-function join(fromFile, specifier) {
-  const parts = fromFile.split("/").slice(0, -1);
-  for (const segment of specifier.split("/")) {
-    if (segment === "." || segment === "") continue;
-    if (segment === "..") parts.pop();
-    else parts.push(segment);
+}
+var bindingsName = (viaProps) => viaProps ? "props.bcmsBindings" : "bcmsBindings";
+var bindingsRead = (prop, viaProps) => `${bindingsName(viaProps)}?.${prop}`;
+
+// src/data.ts
+function splitGroup(path) {
+  const match = path.match(/^([^[\]]+)\[(\d+)\]\.(.+)$/);
+  return match ? { array: match[1], index: Number(match[2]), leaf: match[3] } : null;
+}
+function moduleOf(parsed) {
+  if (!parsed.ast) return null;
+  return { ast: parsed.ast, offset: parsed.script?.offset ?? 0 };
+}
+function arrayLiterals(ast) {
+  const out = /* @__PURE__ */ new Map();
+  walkAst(ast, (node) => {
+    if (node.type !== "VariableDeclarator") return;
+    const id = node.id;
+    const init = node.init;
+    if (id?.type !== "Identifier" || init?.type !== "ArrayExpression") return;
+    out.set(String(id.name), init);
+  });
+  return out;
+}
+function propertyFor(row, literal) {
+  if (row?.type !== "ObjectExpression") return null;
+  for (const property of row.properties ?? []) {
+    if (property.type !== "ObjectProperty" && property.type !== "Property") continue;
+    const key = property.key;
+    const value = property.value;
+    if (value?.type !== "StringLiteral" || key?.type !== "Identifier") continue;
+    if (norm(String(value.value)) === literal) return String(key.name);
+  }
+  return null;
+}
+function iterations(roots, identifier2) {
+  const pattern = new RegExp(`(?<![\\w$])${identifier2}(?![\\w$])\\s*\\.\\s*map\\s*\\(`);
+  const out = [];
+  const visit = (node) => {
+    if (node.type === "expr") {
+      if (pattern.test(node.value)) out.push(node);
+      return;
+    }
+    if (node.type === "element" && !node.raw) for (const child of node.children) visit(child);
+  };
+  for (const root of roots) visit(root);
+  return out;
+}
+function callbackParams(expression, identifier2) {
+  const pattern = new RegExp(
+    `(?<![\\w$])${identifier2}(?![\\w$])\\s*\\.\\s*map\\s*\\(\\s*(?:\\(\\s*([A-Za-z_$][\\w$]*)\\s*(,\\s*([A-Za-z_$][\\w$]*)\\s*)?\\)|([A-Za-z_$][\\w$]*))\\s*=>`
+  );
+  const match = expression.value.match(pattern);
+  if (!match || match.index === void 0) return null;
+  const row = match[1] ?? match[4];
+  if (match[4] !== void 0) return { row, index: null, addIndexAt: -1 };
+  const within = match[0].lastIndexOf(row);
+  return {
+    row,
+    index: match[3] ?? null,
+    addIndexAt: expression.range.start + match.index + within + row.length
+  };
+}
+function renders(content, node, row) {
+  if (!node.inner) return null;
+  const inner = content.slice(node.inner.start, node.inner.end).trim();
+  const match = inner.match(/^\{\s*([A-Za-z_$][\w$]*)\s*\.\s*([A-Za-z_$][\w$]*)\s*\}$/);
+  return match && match[1] === row ? match[2] : null;
+}
+function leafElements(content, expression, row) {
+  const out = /* @__PURE__ */ new Map();
+  const visit = (node) => {
+    if (node.type === "expr") {
+      for (const child of node.children) visit(child);
+      return;
+    }
+    if (node.type !== "element" || node.raw) return;
+    const property = isIntrinsic(node.tag) ? renders(content, node, row) : null;
+    if (property) out.set(property, [...out.get(property) ?? [], node]);
+    for (const child of node.children) visit(child);
+  };
+  for (const child of expression.children) visit(child);
+  return out;
+}
+function stringLiterals(ast) {
+  const out = /* @__PURE__ */ new Map();
+  walkAst(ast, (node) => {
+    if (node.type !== "VariableDeclarator") return;
+    const id = node.id;
+    const init = node.init;
+    if (id?.type !== "Identifier" || init?.type !== "StringLiteral") return;
+    out.set(String(id.name), init);
+  });
+  return out;
+}
+function scalarUses(content, roots, id) {
+  const mention = new RegExp(`(?<![\\w$])${id}(?![\\w$])`, "g");
+  const alone = new RegExp(`^\\{\\s*${id}\\s*\\}$`);
+  const count = (text) => (text.match(mention) ?? []).length;
+  let total = 0;
+  const hosts = [];
+  const visit = (node) => {
+    if (node.type === "expr") {
+      total += count(node.value);
+      for (const child of node.children) visit(child);
+      return;
+    }
+    if (node.type !== "element" || node.raw) return;
+    for (const attr of node.attrs) {
+      if (attr.expressionRange) total += count(content.slice(attr.expressionRange.start, attr.expressionRange.end));
+    }
+    if (node.inner && isIntrinsic(node.tag) && alone.test(content.slice(node.inner.start, node.inner.end).trim())) {
+      hosts.push(node);
+    }
+    for (const child of node.children) visit(child);
+  };
+  for (const root of roots) visit(root);
+  return { total, hosts };
+}
+function bindScalar(ctx, member, literals, offset) {
+  const rule = DIALECT_RULES[ctx.dialect];
+  const named = [...literals].filter(([, init2]) => norm(String(init2.value)) === member.literal);
+  if (named.length !== 1) return { splices: [], refusal: null };
+  const [id, init] = named[0];
+  const uses = scalarUses(ctx.content, ctx.parsed.roots, id);
+  if (uses.hosts.length !== 1 || uses.total !== 1) return { splices: [], refusal: "IN_EXPRESSION" };
+  const host = uses.hosts[0];
+  const at = { start: offset + (init.start ?? 0), end: offset + (init.end ?? 0) };
+  const args = [
+    ctx.snapshotName(member.slug),
+    JSON.stringify(member.path),
+    // The literal EXACTLY as the author wrote it — quotes, escapes and all — so the fallback the
+    // build renders is the byte-for-byte copy the repository renders today.
+    ctx.content.slice(at.start, at.end),
+    ...ctx.slug ? [ctx.slug] : []
+  ];
+  const attributes = [
+    `data-bcms-field="${member.path}"`,
+    ...member.kind ? [`data-bcms-kind="${member.kind}"`] : [],
+    ...member.kind === "richtext" && rule.richtext ? [rule.richtext(id)] : []
+  ];
+  const splices = [
+    { start: at.start, end: at.end, text: `${ctx.read}(${args.join(", ")})` },
+    { start: host.attrInsertAt, end: host.attrInsertAt, text: ` ${attributes.join(" ")}` }
+  ];
+  if (member.kind === "richtext" && rule.richtext && host.inner) {
+    splices.push({ start: host.inner.start, end: host.inner.end, text: "" });
+  }
+  return { splices, refusal: null };
+}
+function bindDataLiterals(ctx, members) {
+  const out = { splices: [], usesRead: false, usesRows: false, slugs: [], bound: [], declarations: [], refused: [] };
+  const rule = DIALECT_RULES[ctx.dialect];
+  const module = moduleOf(ctx.parsed);
+  if (!module || !rule.text) return out;
+  const groups = /* @__PURE__ */ new Map();
+  const scalars = [];
+  for (const member of members) {
+    const split = splitGroup(member.path);
+    if (!split) {
+      scalars.push(member);
+      continue;
+    }
+    const held = { ...member, array: split.array, index: split.index, leaf: split.leaf };
+    const key = `${member.slug}\0${split.array}`;
+    groups.set(key, [...groups.get(key) ?? [], held]);
+  }
+  const strings = stringLiterals(module.ast);
+  for (const member of scalars) {
+    const scalar = bindScalar(ctx, member, strings, module.offset);
+    if (scalar.refusal) out.refused.push({ key: member.key, reason: scalar.refusal });
+    if (scalar.splices.length === 0) continue;
+    out.splices.push(...scalar.splices);
+    out.usesRead = true;
+    out.slugs.push(member.slug);
+    out.bound.push(member.key);
+  }
+  if (groups.size === 0) return out;
+  const literals = arrayLiterals(module.ast);
+  for (const all of groups.values()) {
+    const array = all[0].array;
+    const nested = all.filter((member) => /\[\d+\]/.test(member.leaf));
+    for (const member of nested) out.refused.push({ key: member.key, reason: "PROP_DRILLED_DEEP" });
+    const group = all.filter((member) => !nested.includes(member));
+    if (group.length === 0) continue;
+    const refuse = (reason) => {
+      for (const member of group) out.refused.push({ key: member.key, reason });
+    };
+    let identifier2 = null;
+    let keys = null;
+    for (const [name, literal] of literals) {
+      const elements2 = literal.elements ?? [];
+      const mapped = /* @__PURE__ */ new Map();
+      const ok = group.every((member) => {
+        const property = propertyFor(elements2[member.index] ?? void 0, member.literal);
+        if (!property) return false;
+        const held = mapped.get(property);
+        if (held !== void 0 && held !== member.leaf) return false;
+        mapped.set(property, member.leaf);
+        return true;
+      });
+      if (!ok) continue;
+      if (identifier2 !== null) {
+        identifier2 = null;
+        break;
+      }
+      identifier2 = name;
+      keys = mapped;
+    }
+    if (identifier2 === null || keys === null) continue;
+    const loops = iterations(ctx.parsed.roots, identifier2);
+    if (loops.length === 0) continue;
+    if (loops.length > 1) {
+      refuse("REPEATER_AMBIGUOUS");
+      continue;
+    }
+    const loop = loops[0];
+    const params = callbackParams(loop, identifier2);
+    if (!params) {
+      refuse("IN_EXPRESSION");
+      continue;
+    }
+    const elements = leafElements(ctx.content, loop, params.row);
+    const placed = /* @__PURE__ */ new Map();
+    let refusal = null;
+    for (const property of keys.keys()) {
+      const found = elements.get(property) ?? [];
+      if (found.length === 1) placed.set(property, found[0]);
+      else refusal = found.length > 1 ? "REPEATER_AMBIGUOUS" : leafRefusal(loop.value, params.row, property);
+    }
+    if (refusal !== null) {
+      refuse(refusal);
+      continue;
+    }
+    const index = params.index ?? allocateIndex(loop.value);
+    const splices = [];
+    if (rule.loopKey) {
+      const rows = loop.children.filter((child) => child.type === "element");
+      const row = rows.length === 1 ? rows[0] : null;
+      if (row && row.tag !== "" && !row.attrs.some((a) => a.name.replace(/^:/, "") === "key")) {
+        splices.push({ start: row.attrInsertAt, end: row.attrInsertAt, text: ` ${rule.loopKey(index)}` });
+      }
+    }
+    if (params.index === null) {
+      if (params.addIndexAt < 0) {
+        refuse("IN_EXPRESSION");
+        continue;
+      }
+      splices.push({ start: params.addIndexAt, end: params.addIndexAt, text: `, ${index}` });
+    }
+    for (const [property, element] of placed) {
+      const leaf = keys.get(property);
+      const literal = `${array}[\${${index}}].${leaf}`;
+      const kind = group.find((member) => member.leaf === leaf).kind;
+      const attributes = [
+        rule.attr("data-bcms-field", `\`${literal}\``),
+        ...kind ? [`data-bcms-kind="${kind}"`] : [],
+        // A richtext row value is html, so it goes into the dialect's html sink rather than being
+        // printed as characters — the same rule `writeLeaf` follows one level down. @see loops.ts
+        ...kind === "richtext" && rule.richtext ? [rule.richtext(`${params.row}.${property}`)] : []
+      ];
+      splices.push({ start: element.attrInsertAt, end: element.attrInsertAt, text: ` ${attributes.join(" ")}` });
+      if (kind === "richtext" && rule.richtext && element.inner) {
+        splices.push({ start: element.inner.start, end: element.inner.end, text: "" });
+      }
+      out.declarations.push({ path: shapeOfPath(literal), literal });
+    }
+    const at = { start: module.offset + (literals.get(identifier2).start ?? 0), end: module.offset + (literals.get(identifier2).end ?? 0) };
+    const map = [...keys].map(([property, leaf]) => `${property}: ${JSON.stringify(leaf)}`).join(", ");
+    const args = [
+      ctx.snapshotName(group[0].slug),
+      JSON.stringify(array),
+      ctx.content.slice(at.start, at.end),
+      `{ ${map} }`,
+      ...ctx.slug ? [ctx.slug] : []
+    ];
+    splices.push({ start: at.start, end: at.end, text: `${ctx.rowsAs}(${args.join(", ")})` });
+    out.splices.push(...splices);
+    out.usesRows = true;
+    out.slugs.push(...group.map((member) => member.slug));
+    out.bound.push(...group.map((member) => member.key));
+  }
+  return out;
+}
+function leafRefusal(loop, row, property) {
+  const prop = new RegExp(`=\\s*\\{\\s*${row}\\s*\\.\\s*${property}\\s*\\}|\\{\\s*\\.\\.\\.\\s*${row}\\s*\\}`);
+  return prop.test(loop) ? "PROP_TARGET_NOT_FOUND" : "IN_EXPRESSION";
+}
+function allocateIndex(loop) {
+  const used = new Set(loop.match(/[A-Za-z_$][\w$]*/g) ?? []);
+  if (!used.has("i")) return "i";
+  for (let n = 1; ; n++) if (!used.has(`i_${n}`)) return `i_${n}`;
+}
+
+// src/resolve.ts
+var EXTENSIONS = [".astro", ".tsx", ".jsx", ".ts", ".js", ".svelte", ".vue", ".mjs", ".cjs"];
+function join(fromFile, specifier) {
+  const parts = fromFile.split("/").slice(0, -1);
+  for (const segment of specifier.split("/")) {
+    if (segment === "." || segment === "") continue;
+    if (segment === "..") parts.pop();
+    else parts.push(segment);
+  }
+  return parts.join("/");
+}
+var firstPresent = (base, files) => [base, ...EXTENSIONS.map((ext) => `${base}${ext}`), ...EXTENSIONS.map((ext) => `${base}/index${ext}`)].find(
+  (candidate) => files.has(candidate)
+) ?? null;
+function aliasesFrom(sources) {
+  const out = /* @__PURE__ */ new Map();
+  for (const source of sources) {
+    if (!isProjectConfig(source.path)) continue;
+    const parsed = readJsonc(source.content);
+    if (parsed === null) continue;
+    const base = parsed.compilerOptions?.baseUrl?.replace(/^\.\/?/, "").replace(/\/$/, "") ?? "";
+    const root = source.path.split("/").slice(0, -1).join("/");
+    for (const [pattern, targets] of Object.entries(parsed.compilerOptions?.paths ?? {})) {
+      out.set(
+        pattern,
+        targets.map((target) => [root, base, target.replace(/^\.\/?/, "")].filter(Boolean).join("/"))
+      );
+    }
+  }
+  return out;
+}
+var isProjectConfig = (path) => path.endsWith("tsconfig.json") || path.endsWith("jsconfig.json");
+function readJsonc(content) {
+  let out = "";
+  let at = 0;
+  while (at < content.length) {
+    const char = content[at];
+    if (char === '"') {
+      const start = at++;
+      while (at < content.length && content[at] !== '"') at += content[at] === "\\" ? 2 : 1;
+      out += content.slice(start, Math.min(at + 1, content.length));
+      at++;
+      continue;
+    }
+    if (char === "/" && content[at + 1] === "/") {
+      while (at < content.length && content[at] !== "\n") at++;
+      continue;
+    }
+    if (char === "/" && content[at + 1] === "*") {
+      const close = content.indexOf("*/", at + 2);
+      at = close < 0 ? content.length : close + 2;
+      continue;
+    }
+    out += char;
+    at++;
+  }
+  try {
+    const parsed = JSON.parse(out.replace(/,(?=\s*[}\]])/g, ""));
+    return isAliasShaped(parsed) ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+function isAliasShaped(value) {
+  if (!isRecord(value)) return false;
+  const options = value.compilerOptions;
+  if (options === void 0) return true;
+  if (!isRecord(options)) return false;
+  if (options.baseUrl !== void 0 && typeof options.baseUrl !== "string") return false;
+  if (options.paths === void 0) return true;
+  if (!isRecord(options.paths)) return false;
+  return Object.values(options.paths).every(
+    (targets) => Array.isArray(targets) && targets.every((target) => typeof target === "string")
+  );
+}
+function unreadableConfigs(sources) {
+  return sources.filter((source) => isProjectConfig(source.path) && readJsonc(source.content) === null).map((source) => source.path);
+}
+function expand(specifier, aliases) {
+  const out = [];
+  for (const [pattern, targets] of aliases) {
+    const star = pattern.indexOf("*");
+    if (star < 0) {
+      if (specifier === pattern) out.push(...targets);
+      continue;
+    }
+    const head = pattern.slice(0, star);
+    const tail = pattern.slice(star + 1);
+    if (!specifier.startsWith(head) || !specifier.endsWith(tail)) continue;
+    const middle = specifier.slice(head.length, specifier.length - tail.length);
+    out.push(...targets.map((target) => target.replace("*", middle)));
+  }
+  return out;
+}
+function resolveSpecifier(fromFile, specifier, files, aliases) {
+  if (specifier.startsWith(".")) return firstPresent(join(fromFile, specifier), files);
+  for (const candidate of expand(specifier, aliases)) {
+    const found = firstPresent(candidate.replace(/\/$/, ""), files);
+    if (found) return found;
+  }
+  return null;
+}
+function importsIn(parsed, _dialect) {
+  const out = /* @__PURE__ */ new Map();
+  walkAst(parsed.ast, (node) => {
+    if (node.type !== "ImportDeclaration") return;
+    if (node.importKind === "type") return;
+    const specifier = node.source?.value;
+    if (typeof specifier !== "string") return;
+    for (const entry of node.specifiers ?? []) {
+      if (entry.importKind === "type") continue;
+      const local = entry.local?.name;
+      if (typeof local !== "string") continue;
+      const kind = entry.type === "ImportDefaultSpecifier" ? "default" : entry.type === "ImportNamespaceSpecifier" ? "namespace" : "named";
+      const imported = kind === "named" ? entry.imported?.name ?? local : null;
+      out.set(local, { specifier, imported, kind });
+    }
+  });
+  return out;
+}
+
+// src/images.ts
+var IMAGE_EXTENSIONS = [".jpg", ".jpeg", ".png", ".webp", ".avif", ".gif", ".svg"];
+var ASSET_COMPONENTS = /* @__PURE__ */ new Set(["Image", "Picture"]);
+var ASSET_MODULE = "astro:assets";
+function baseName(url) {
+  const file = url.split(/[?#]/)[0].split("/").pop() ?? "";
+  const base = file.split(".")[0] ?? "";
+  return base === "" ? null : base.toLowerCase();
+}
+function assetCandidates(parsed, dialect, original) {
+  const wanted = baseName(original);
+  if (wanted === null || parsed.error) return [];
+  const found = [];
+  for (const [local, from] of importsIn(parsed, dialect)) {
+    const specifier = from.specifier.toLowerCase();
+    if (from.kind !== "default" || !IMAGE_EXTENSIONS.some((ext) => specifier.endsWith(ext))) continue;
+    if (baseName(from.specifier) === wanted) found.push(local);
+  }
+  return found;
+}
+function assetImport(parsed, dialect, original) {
+  const found = assetCandidates(parsed, dialect, original);
+  return found.length === 1 ? found[0] : null;
+}
+function renderedBy(content, parsed, dialect, binding) {
+  const assets = new Set(
+    [...importsIn(parsed, dialect)].filter(([, from]) => from.specifier === ASSET_MODULE).map(([local]) => local)
+  );
+  const out = [];
+  const visit = (node) => {
+    if (node.type === "expr") {
+      for (const child of node.children) visit(child);
+      return;
+    }
+    if (node.type !== "element" || node.raw) return;
+    const sources = IMAGE_SOURCES[node.tag.toLowerCase()] ?? (assets.has(node.tag) && ASSET_COMPONENTS.has(node.tag) ? ["src"] : []);
+    for (const attr of node.attrs) {
+      if (!sources.includes(attr.name) || !attr.expressionRange) continue;
+      const inner = content.slice(attr.expressionRange.start, attr.expressionRange.end).replace(/^\{|\}$/g, "").trim();
+      if (inner === binding) out.push({ node, attr: attr.name });
+    }
+    for (const child of node.children) visit(child);
+  };
+  for (const root of parsed.roots) visit(root);
+  return out;
+}
+function bindImages(ctx, targets) {
+  const out = { splices: [], slugs: [], bound: [], refused: [] };
+  const rule = DIALECT_RULES[ctx.dialect];
+  if (!rule.attr || !rule.text || ctx.parsed.error) return out;
+  const claimed = /* @__PURE__ */ new Set();
+  for (const target of targets) {
+    const binding = assetImport(ctx.parsed, ctx.dialect, target.original);
+    const rendered = binding === null ? [] : renderedBy(ctx.content, ctx.parsed, ctx.dialect, binding);
+    const free = rendered.filter((hit2) => !claimed.has(hit2.node.attrInsertAt));
+    if (free.length !== 1) {
+      out.refused.push({ key: target.key, reason: "IMAGE_ASSET_UNRESOLVED" });
+      continue;
+    }
+    const hit = free[0];
+    claimed.add(hit.node.attrInsertAt);
+    const attr = hit.node.attrs.find((a) => a.name === hit.attr);
+    const args = [
+      ctx.snapshotName(target.slug),
+      JSON.stringify(target.path),
+      binding,
+      ...ctx.slug ? [ctx.slug] : []
+    ];
+    out.splices.push({
+      start: attr.range.start,
+      end: attr.range.end,
+      text: rule.attr(hit.attr, `${ctx.image}(${args.join(", ")})`)
+    });
+    out.splices.push({
+      start: hit.node.attrInsertAt,
+      end: hit.node.attrInsertAt,
+      text: ` data-bcms-field="${target.path}" data-bcms-kind="${target.kind || "image"}"`
+    });
+    out.slugs.push(target.slug);
+    out.bound.push(target.key);
+  }
+  return out;
+}
+
+// src/helper.ts
+import { createHash as createHash2 } from "crypto";
+var HELPER_VERSION = 5;
+var HEADER = "// @bettercms-ai/convert helper v";
+var HELPER_PATH = Object.fromEntries(
+  Object.keys(DIALECT_RULES).map((d) => [d, DIALECT_RULES[d].helper])
+);
+var CONTENT_DIR = "bcms-content";
+var STUB_CONTENT = "{}";
+function relativeImport(fromFile, toFile) {
+  const from = fromFile.split("/").slice(0, -1);
+  const to = toFile.split("/");
+  let shared = 0;
+  while (shared < from.length && shared < to.length - 1 && from[shared] === to[shared]) shared++;
+  const up = from.length - shared;
+  const path = [...Array(up).fill(".."), ...to.slice(shared)].join("/");
+  return up === 0 ? `./${path}` : path;
+}
+function helperSource(dialect) {
+  const path = HELPER_PATH[dialect];
+  if (!path) throw new Error(`The ${dialect} dialect reads its values at publish time, not at build time.`);
+  const layout = relativeImport(path, `${CONTENT_DIR}/layout.json`);
+  return `${HEADER}${HELPER_VERSION}
+// Values come from bcms-content/*.json, written into the tree before the build. The committed
+// stubs are {} \u2014 a build with them renders every fallback below and still succeeds.
+import layoutSnapshot from "${layout}";
+
+const isRecord = (v: unknown): v is Record<string, unknown> =>
+  typeof v === "object" && v !== null && !Array.isArray(v);
+
+/** Dotted keys and \`[n]\` indices, positionally \u2014 the editor's own path grammar. */
+function readPath(root: unknown, path: string): unknown {
+  let cursor: unknown = root;
+  for (const segment of path.split(".")) {
+    if (!segment) return undefined;
+    const key = segment.replace(/\\[\\d+\\]/g, "");
+    if (key) {
+      if (!isRecord(cursor)) return undefined;
+      cursor = cursor[key];
+    }
+    for (const index of segment.matchAll(/\\[(\\d+)\\]/g)) {
+      if (!Array.isArray(cursor)) return undefined;
+      cursor = cursor[Number(index[1])];
+    }
+  }
+  return cursor;
+}
+
+/** A stored value as a template renders it: richtext is its html, an image is its url. */
+function render(value: unknown): string | undefined {
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (isRecord(value)) {
+    if (typeof value.html === "string") return value.html;
+    if (typeof value.url === "string") return value.url;
+  }
+  return undefined;
+}
+
+/** One field of one page. \`slug\` selects the entry on a dynamic route. */
+export function bcms(page: unknown, path: string, fallback: string, slug?: string): string {
+  const entries = isRecord(page) ? page.entries : undefined;
+  const root = slug !== undefined && isRecord(entries) ? entries[slug] : page;
+  return render(readPath(root, path)) ?? fallback;
+}
+
+/** One field of the shared layout \u2014 the header and footer every route renders. */
+export function bcmsLayout(path: string, fallback: string): string {
+  return render(readPath(layoutSnapshot, path)) ?? fallback;
+}
+
+/**
+ * The ROWS of a repeater. \`fallback\` is every row the template shipped with, so a build against
+ * an empty snapshot still renders the same number of cards it always did.
+ */
+export function bcmsRows<T>(page: unknown, path: string, fallback: T[], slug?: string): T[] {
+  const entries = isRecord(page) ? page.entries : undefined;
+  const root = slug !== undefined && isRecord(entries) ? entries[slug] : page;
+  const value = readPath(root, path);
+  return Array.isArray(value) ? (value as T[]) : fallback;
+}
+
+/**
+ * The rows of a repeater whose template renders its OWN property names.
+ *
+ * \u{1F534} A ROW IS MORE THAN ITS COPY. The template's array carries \`tone\`, \`link\`, an icon \u2014 styling
+ * the brief never heard of, because the CMS holds the four sentences and not the class names. So a
+ * CMS row is merged OVER the row the template shipped with rather than replacing it, and \`keys\`
+ * says which template property each CMS leaf lands on. A row an editor ADDS has no counterpart, so
+ * it inherits row 0's styling \u2014 the only answer that renders at all.
+ */
+export function bcmsRowsAs<T>(
+  page: unknown,
+  path: string,
+  fallback: T[],
+  keys: Record<string, string>,
+  slug?: string,
+): T[] {
+  const rows = bcmsRows<unknown>(page, path, [], slug);
+  if (rows.length === 0) return fallback;
+  return rows.map((row, index) => {
+    const base = { ...(fallback[index] ?? fallback[0] ?? {}) } as Record<string, unknown>;
+    for (const property of Object.keys(keys)) {
+      const value = render(readPath(row, keys[property] as string));
+      if (value !== undefined) base[property] = value;
+    }
+    return base as T;
+  });
+}
+
+/** An image field's url, or the asset the template already imports. @see IMAGE_ASSET_UNRESOLVED */
+export function bcmsImage<T>(page: unknown, path: string, fallback: T, slug?: string): T | string {
+  const entries = isRecord(page) ? page.entries : undefined;
+  const root = slug !== undefined && isRecord(entries) ? entries[slug] : page;
+  return render(readPath(root, path)) ?? fallback;
+}
+
+/**
+ * ONE SECTION's copy, for a component extracted by \`--componentize\`.
+ *
+ * OVERRIDES FIRST, PER KEY: \`overrides[key] ?? group[key]\`. An instance that owns its copy
+ * (Phase B) carries an override for every prop it declares, so the group underneath it is never
+ * read; a placement still bound to a page field group (Phase A) carries none, so the group is all
+ * there is. The interesting case is the one in between \u2014 a section half moved \u2014 where a key the
+ * instance does not hold has to keep rendering the page's value rather than nothing.
+ *
+ * \u{1F534} \`??\`, NOT \`||\`. An empty string is a value an editor typed, and treating it as absent put
+ * the page's old copy back into a heading somebody had deliberately cleared.
+ *
+ * With neither an override nor a group, the answer is \`{}\` and every \`bcms(...)\` below renders
+ * the fallback the template shipped with \u2014 which is why a section renders correctly against the
+ * committed \`{}\` stub.
+ */
+export function bcmsSection(page: unknown, bind?: string, overrides?: unknown): Record<string, unknown> {
+  const group = bind ? readPath(page, bind) : undefined;
+  const base: Record<string, unknown> = isRecord(group) ? { ...group } : {};
+  if (!isRecord(overrides)) return base;
+  for (const key of Object.keys(overrides)) {
+    const value = overrides[key];
+    if (value === undefined || value === null) continue;
+    /**
+     * \u{1F534} A TABLE PROP IS STORED AS \`{ rows: [...] }\` AND READ AS A LIST. That is the shape the
+     * dashboard edits a repeater in; handing it to \`bcmsRows\` unchanged is not an array, so the
+     * helper fell back to the rows the template shipped with and the editor's work never showed.
+     */
+    base[key] = isRecord(value) && Array.isArray(value.rows) ? value.rows : value;
+  }
+  return base;
+}
+
+/**
+ * WHICH ADDRESS one bound element declares \u2014 decided at RENDER time, from the placement.
+ *
+ * An element carries exactly ONE \`data-bcms-field\`, and which lane it names depends on where its
+ * copy lives. A placement that owns its copy declares the BLOCK lane \u2014
+ * \`<blockId>__overrides.<propKey>\` \u2014 because that is the address the editor commits an instance's
+ * own value to. A placement bound to a page field group declares the PAGE path, which is what the
+ * page form and the coverage meter already know.
+ *
+ * \u{1F534} THE BOUND ADDRESS IS RE-BASED ONTO **THIS** PLACEMENT'S GROUP. The markup was cut from ONE
+ * page and carries that page's paths (\`hero.title\`); the whole point of \`shapeHash\` is that a
+ * second page renders the same component bound to a group of its own (\`bind="landingHero"\`).
+ * Handing the embedded path through unchanged declared \`hero.title\` on a page whose field is
+ * \`landingHero.title\` \u2014 an address that page does not have, so the editor wrote into nothing and
+ * the meter counted a binding that was never there. The prefix the markup was cut with comes out,
+ * the placement's own group goes in.
+ *
+ * \u{1F534} THE SAME EXTRACTED FILE SERVES BOTH LANES. The choice is a function of the props, never of
+ * how the codemod ran: one component renders a Phase A placement on one page and a Phase B
+ * instance on the next, and a repository does not have to be re-cut when its copy moves.
+ */
+export function bcmsFields(
+  placement: { blockId?: string; bind?: string; overrides?: unknown },
+  pathPrefix: string,
+): (path: string) => string {
+  const id = placement.blockId;
+  const own = typeof id === "string" && id !== "" && !placement.bind && isRecord(placement.overrides);
+  /**
+   * What replaces the prefix the markup was cut with, or null for "leave every path alone".
+   *
+   * Null covers a placement with neither a bind nor an instance \u2014 a shipped fallback, or a page
+   * nobody has componentized yet \u2014 and a bound placement in a component whose prefix is EMPTY,
+   * where the plan said the prop key IS the whole page path: there is no group segment to swap,
+   * so prepending one would invent an address rather than correct it.
+   */
+  const lane = own ? \`\${id}__overrides.\` : placement.bind && pathPrefix ? \`\${placement.bind}.\` : null;
+  return (path: string): string => {
+    // A path outside the group this section was cut from is not one this placement re-addresses:
+    // it names a key the instance does not hold and a group this placement is not bound to.
+    // (An EMPTY prefix is a plan saying the prop key IS the page path, and matches everything.)
+    if (lane === null || !path.startsWith(pathPrefix)) return path;
+    return lane + path.slice(pathPrefix.length);
+  };
+}
+`;
+}
+var HISTORICAL = {
+  "src/bcms-content.ts": {
+    1: "c272412532efed7db64b6cf313b2bed4291f9951430412289c8a588b7f565407",
+    2: "51e2ae65ddd86bf43d14e29b3865e3f16e45f72069692d1fea57e1f986a894f0",
+    3: "d4305b2983adcb456ef782d35ea9d083a04465c2b68baa0d44a084dfa01a9227",
+    4: "a5742f64dacb1b26ee6dd5e1469a54871487934c71bc8267df19e3a80e417595"
+  },
+  "src/lib/bcms-content.ts": {
+    1: "ae72ae14d706943d481c880d70da5789b4816ba1ba319a10fbc63ded4d0b42f2",
+    2: "a18731eb42f7db55dac0591c45f873758cde8e103fefcd6e5caf67936ae6a002",
+    3: "0be9c73160361882a038552bc02673c14ed532287823dabaafe36179bc55ed7e",
+    4: "0146d027a727ecd3c9e3fc336fcf1299b59ddf75b04091c05703f3f983ec28af"
+  },
+  "composables/bcms-content.ts": {
+    1: "c272412532efed7db64b6cf313b2bed4291f9951430412289c8a588b7f565407",
+    2: "51e2ae65ddd86bf43d14e29b3865e3f16e45f72069692d1fea57e1f986a894f0",
+    3: "d4305b2983adcb456ef782d35ea9d083a04465c2b68baa0d44a084dfa01a9227",
+    4: "a5742f64dacb1b26ee6dd5e1469a54871487934c71bc8267df19e3a80e417595"
+  }
+};
+var sha256 = (value) => createHash2("sha256").update(value, "utf8").digest("hex");
+function isKnownHelper(content, dialect) {
+  if (content === helperSource(dialect)) return HELPER_VERSION;
+  const path = HELPER_PATH[dialect];
+  if (!path) return null;
+  const digest = sha256(content);
+  for (const [version, known] of Object.entries(HISTORICAL[path] ?? {})) {
+    if (known === digest) return Number(version);
+  }
+  return null;
+}
+
+// src/locate.ts
+var flat = (value) => value.replace(/\s+/g, " ").trim();
+var stripTags = (value) => value.replace(/<br\s*\/?>/gi, " ").replace(/<[^>]*>/g, "");
+function locate(brief, sources, options) {
+  const flattened = sources.map((s) => {
+    const readable = unwrapJsxStrings(decodeEntities(s.content));
+    return {
+      path: s.path,
+      content: flat(readable),
+      text: options?.stripTags ? flat(stripTags(readable)) : null
+    };
+  });
+  const located = [];
+  const unlocated = [];
+  for (const page of brief.pages) {
+    for (const p of page.paths) {
+      const original = p.original === null ? "" : flat(p.original);
+      if (!original) {
+        unlocated.push({ route: page.route, scope: p.scope, path: p.path, reason: "no-original" });
+        continue;
+      }
+      const files = flattened.filter((f) => f.content.includes(original) || f.text !== null && f.text.includes(original)).map((f) => f.path);
+      if (files.length === 0) {
+        unlocated.push({ route: page.route, scope: p.scope, path: p.path, reason: "not-in-source" });
+        continue;
+      }
+      located.push({ route: page.route, scope: p.scope, path: p.path, kind: p.kind, original, files });
+    }
+  }
+  return { located, unlocated };
+}
+
+// src/loops.ts
+import MagicString from "magic-string";
+
+// src/scope.ts
+function patternNames(node, out) {
+  if (!node || typeof node !== "object") return;
+  const typed = node;
+  switch (typed.type) {
+    case "Identifier":
+      out.add(String(typed.name));
+      return;
+    case "ObjectPattern":
+      for (const property of typed.properties ?? [])
+        patternNames(property.type === "RestElement" ? property.argument : property.value, out);
+      return;
+    case "ArrayPattern":
+      for (const element of typed.elements ?? []) patternNames(element, out);
+      return;
+    case "AssignmentPattern":
+      patternNames(typed.left, out);
+      return;
+    case "RestElement":
+      patternNames(typed.argument, out);
+      return;
+    default:
+      return;
+  }
+}
+function statementNames(node, out) {
+  if (!node || typeof node !== "object") return;
+  const typed = node;
+  switch (typed.type) {
+    case "ExportNamedDeclaration":
+    case "ExportDefaultDeclaration":
+      statementNames(typed.declaration, out);
+      return;
+    case "ImportDeclaration":
+      for (const specifier of typed.specifiers ?? []) patternNames(specifier.local, out);
+      return;
+    case "VariableDeclaration":
+      for (const declarator of typed.declarations ?? []) patternNames(declarator.id, out);
+      return;
+    case "FunctionDeclaration":
+    case "ClassDeclaration":
+    case "TSTypeAliasDeclaration":
+    case "TSInterfaceDeclaration":
+    case "TSEnumDeclaration":
+    case "TSModuleDeclaration":
+      patternNames(typed.id, out);
+      return;
+    default:
+      return;
+  }
+}
+var DECLARED = /\b(?:const|let|var|function|class|interface|type|enum)\s+([A-Za-z_$][\w$]*)/g;
+var IMPORTED = /\bimport\s+([^;\n]*?)\s+from\b/g;
+function scanNames(code, out) {
+  for (const match of code.matchAll(DECLARED)) out.add(match[1]);
+  for (const match of code.matchAll(IMPORTED))
+    for (const name of match[1].match(/[A-Za-z_$][\w$]*/g) ?? []) {
+      if (name !== "as" && name !== "type") out.add(name);
+    }
+}
+function scriptText(nodes, content, out) {
+  for (const node of nodes) {
+    if (node.type !== "element") continue;
+    if (node.raw && node.tag === "script" && node.inner) out.push(content.slice(node.inner.start, node.inner.end));
+    scriptText(node.children, content, out);
+  }
+}
+function topLevelBindings(dialect, parsed, content) {
+  const out = /* @__PURE__ */ new Set();
+  const program = parsed.ast?.program;
+  if (program) for (const statement of program.body ?? []) statementNames(statement, out);
+  else if (parsed.script) scanNames(parsed.script.code, out);
+  if (dialect === "html") {
+    const scripts = [];
+    scriptText(parsed.roots, content, scripts);
+    for (const code of scripts) scanNames(code, out);
+  }
+  return out;
+}
+function allocateNames(taken, wanted) {
+  const used = new Set(taken);
+  const out = /* @__PURE__ */ new Map();
+  for (const { key, name } of wanted) {
+    if (out.has(key)) continue;
+    let candidate = name;
+    for (let n = 1; used.has(candidate); n++) candidate = `${name}_${n}`;
+    used.add(candidate);
+    out.set(key, candidate);
+  }
+  return out;
+}
+
+// src/loops.ts
+function splitNested(leaf) {
+  const match = leaf.match(/^([^[\]]+)\[(\d+)\]\.(.+)$/);
+  return match ? { array: match[1], index: Number(match[2]), leaf: match[3] } : null;
+}
+var elementEnd = (node) => node.inner ? node.inner.end + node.tag.length + 3 : null;
+function findRows(roots, members) {
+  const wanted = new Set(members.map((m) => m.index));
+  const search = (node) => {
+    if (node.type !== "element") return null;
+    for (const child of node.children) {
+      const deeper = search(child);
+      if (deeper) return deeper;
+    }
+    const rows = [];
+    for (const child of node.children) {
+      if (child.type !== "element") continue;
+      const end = elementEnd(child);
+      if (end === null) continue;
+      const inside = members.filter((m) => m.site.range.start >= child.start && m.site.range.end <= end);
+      if (inside.length === 0) continue;
+      const indices = new Set(inside.map((m) => m.index));
+      if (indices.size !== 1) return null;
+      rows.push({
+        index: inside[0].index,
+        range: { start: child.start, end },
+        attrInsertAt: child.attrInsertAt,
+        // `:key` in vue, `key` in jsx — one existing key, whichever way it is spelled.
+        keyAttr: child.attrs.find((a) => a.name.replace(/^:/, "") === "key")?.range ?? null,
+        node: child,
+        members: inside
+      });
+    }
+    if (rows.length === 0) return null;
+    const covered = new Set(rows.flatMap((r) => r.members.map((m) => m.index)));
+    if (covered.size !== wanted.size || rows.length !== wanted.size) return null;
+    if (rows.some((r) => r.members.length !== members.length / wanted.size)) return null;
+    return rows.sort((a, b) => a.range.start - b.range.start);
+  };
+  for (const root of roots) {
+    const found = search(root);
+    if (found) return found;
+  }
+  return null;
+}
+var consecutive = (rows, content) => rows.every((row, at) => at === 0 || content.slice(rows[at - 1].range.end, row.range.start).trim() === "");
+function maskedRow(row, content) {
+  const masked = new Map(row.members.map((member) => [member.site.inner.start, member.leaf]));
+  return canonical(row.node, content, masked);
+}
+var TRIVIA = "
";
+function canonical(node, content, masked) {
+  if (node.type === "text") {
+    return node.value.trim() === "" ? TRIVIA : content.slice(node.range.start, node.range.end);
+  }
+  if (node.type === "comment" || node.type === "expr") {
+    return content.slice(node.range.start, node.range.end);
+  }
+  if (node.type !== "element") return "";
+  const open = content.slice(node.start, node.inner ? node.inner.start : node.attrInsertAt);
+  if (node.inner && masked.has(node.inner.start)) {
+    return `${open}\0${masked.get(node.inner.start)}\0</${node.tag}>`;
+  }
+  const inside = node.children.map((child) => canonical(child, content, masked)).join("");
+  return node.inner ? `${open}${inside}</${node.tag}>` : open;
+}
+function sameShape(rows, content) {
+  const first = maskedRow(rows[0], content);
+  return rows.every((row) => maskedRow(row, content) === first);
+}
+var indented = (body, indent) => body.split("\n").map((line) => line.startsWith(indent) ? `${indent}  ${line.slice(indent.length)}` : `${indent}  ${line}`).join("\n");
+function indentOf(content, at) {
+  const lineStart = content.lastIndexOf("\n", at - 1) + 1;
+  const prefix = content.slice(lineStart, at);
+  return prefix.trim() === "" ? prefix : "";
+}
+function writeLeaf(source, shift, member, rule, read, row, literal) {
+  const site = member.site;
+  const expression = `${read}(${row}, ${JSON.stringify(member.leaf)}, "")`;
+  if (member.kind === "richtext" && rule.richtext) {
+    source.remove(site.inner.start + shift, site.inner.end + shift);
+    source.appendLeft(site.attrInsertAt + shift, ` ${rule.richtext(expression)}`);
+  } else {
+    source.overwrite(site.inner.start + shift, site.inner.end + shift, rule.text(expression));
+  }
+  const kind = member.kind ? ` data-bcms-kind="${member.kind}"` : "";
+  source.appendLeft(site.attrInsertAt + shift, ` ${rule.attr("data-bcms-field", `\`${literal}\``)}${kind}`);
+}
+function emitNested(rule, array, members, prefix, outer, parent, ctx) {
+  if (!rule.loop || !rule.text) return null;
+  const inner = [];
+  for (const member of members) {
+    const split = splitNested(member.leaf);
+    if (!split || splitNested(split.leaf) !== null) return null;
+    inner.push({ ...member, index: split.index, leaf: split.leaf });
+  }
+  const rows = findRows([parent.node], inner);
+  if (!rows || rows.length === 0) return null;
+  if (!consecutive(rows, ctx.content)) return null;
+  if (!sameShape(rows, ctx.content)) return null;
+  const template = rows[0];
+  const used = /* @__PURE__ */ new Set([
+    ...ctx.content.slice(template.range.start, template.range.end).match(/[A-Za-z_$][\w$]*/g) ?? [],
+    outer.row,
+    outer.index
+  ]);
+  const allocated = allocateNames(used, [
+    { key: "row", name: "item" },
+    { key: "index", name: "j" }
+  ]);
+  const names = { row: allocated.get("row"), index: allocated.get("index") };
+  const fallback = [];
+  const writable = inner.every((member) => setLeaf(fallback[member.index] ??= emptyRow(), member.leaf, member.fallback));
+  if (!writable) return null;
+  const source = new MagicString(ctx.content.slice(template.range.start, template.range.end));
+  const shift = -template.range.start;
+  const declarations = [];
+  for (const member of template.members) {
+    const literal = `${prefix}.${array}[\${${names.index}}].${member.leaf}`;
+    writeLeaf(source, shift, member, rule, ctx.read, names.row, literal);
+    declarations.push({ path: shapeOfPath(literal), literal });
+  }
+  const rowsExpr = `${ctx.rows}(${outer.row}, ${JSON.stringify(array)}, ${JSON.stringify(fallback.filter(Boolean))})`;
+  if (rule.loop.kind === "attr") {
+    source.appendRight(template.attrInsertAt + shift, ` ${rule.loop.attr(rowsExpr, names.row, names.index)}`);
+  }
+  if (rule.loopKey) {
+    const key = rule.loopKey(names.index);
+    if (!template.keyAttr) source.appendRight(template.attrInsertAt + shift, ` ${key}`);
+    else if (template.keyAttr.end > template.keyAttr.start)
+      source.overwrite(template.keyAttr.start + shift, template.keyAttr.end + shift, key);
+    else return null;
   }
-  return parts.join("/");
+  const indent = indentOf(ctx.content, template.range.start);
+  const text = rule.loop.kind === "wrap" ? `${rule.loop.open(rowsExpr, names.row, names.index)}
+${indented(source.toString(), indent)}
+${indent}${rule.loop.close}` : source.toString();
+  return { range: { start: template.range.start, end: rows[rows.length - 1].range.end }, text, declarations };
 }
-var firstPresent = (base, files) => [base, ...EXTENSIONS.map((ext) => `${base}${ext}`), ...EXTENSIONS.map((ext) => `${base}/index${ext}`)].find(
-  (candidate) => files.has(candidate)
-) ?? null;
-function aliasesFrom(sources) {
-  const out = /* @__PURE__ */ new Map();
-  for (const source of sources) {
-    if (!isProjectConfig(source.path)) continue;
-    const parsed = readJsonc(source.content);
-    if (parsed === null) continue;
-    const base = parsed.compilerOptions?.baseUrl?.replace(/^\.\/?/, "").replace(/\/$/, "") ?? "";
-    const root = source.path.split("/").slice(0, -1).join("/");
-    for (const [pattern, targets] of Object.entries(parsed.compilerOptions?.paths ?? {})) {
-      out.set(
-        pattern,
-        targets.map((target) => [root, base, target.replace(/^\.\/?/, "")].filter(Boolean).join("/"))
-      );
-    }
+function emitRepeater(dialect, group, arrayPath, fallbackRows, ctx) {
+  const rule = DIALECT_RULES[dialect];
+  if (!rule.loop || !rule.text || group.length === 0) return null;
+  const rows = findRows(ctx.roots, group);
+  if (!rows || rows.length < 2) return null;
+  if (!consecutive(rows, ctx.content)) return null;
+  if (!sameShape(rows, ctx.content)) return null;
+  if (group.some((m) => m.site.where !== "text" || !isIntrinsic(m.site.tag) || !m.site.inner)) return null;
+  const template = rows[0];
+  const used = new Set(ctx.content.slice(template.range.start, template.range.end).match(/[A-Za-z_$][\w$]*/g) ?? []);
+  const allocated = allocateNames(used, [
+    { key: "row", name: "card" },
+    { key: "index", name: "i" }
+  ]);
+  const names = { row: allocated.get("row"), index: allocated.get("index") };
+  const source = new MagicString(ctx.content.slice(template.range.start, template.range.end));
+  const shift = -template.range.start;
+  const declarations = [];
+  const nested = /* @__PURE__ */ new Map();
+  const direct = [];
+  for (const member of template.members) {
+    const inner = splitNested(member.leaf);
+    if (inner === null) direct.push(member);
+    else nested.set(inner.array, [...nested.get(inner.array) ?? [], member]);
   }
-  return out;
-}
-var isProjectConfig = (path) => path.endsWith("tsconfig.json") || path.endsWith("jsconfig.json");
-function readJsonc(content) {
-  let out = "";
-  let at = 0;
-  while (at < content.length) {
-    const char = content[at];
-    if (char === '"') {
-      const start = at++;
-      while (at < content.length && content[at] !== '"') at += content[at] === "\\" ? 2 : 1;
-      out += content.slice(start, Math.min(at + 1, content.length));
-      at++;
-      continue;
-    }
-    if (char === "/" && content[at + 1] === "/") {
-      while (at < content.length && content[at] !== "\n") at++;
-      continue;
-    }
-    if (char === "/" && content[at + 1] === "*") {
-      const close = content.indexOf("*/", at + 2);
-      at = close < 0 ? content.length : close + 2;
-      continue;
-    }
-    out += char;
-    at++;
+  for (const [array, members] of nested) {
+    const plan2 = emitNested(rule, array, members, `${arrayPath}[\${${names.index}}]`, names, template, ctx);
+    if (!plan2) return null;
+    if (direct.some((m) => m.site.range.start >= plan2.range.start && m.site.range.end <= plan2.range.end)) return null;
+    source.overwrite(plan2.range.start + shift, plan2.range.end + shift, plan2.text);
+    declarations.push(...plan2.declarations);
   }
-  try {
-    const parsed = JSON.parse(out.replace(/,(?=\s*[}\]])/g, ""));
-    return isAliasShaped(parsed) ? parsed : null;
-  } catch {
-    return null;
+  for (const member of direct) {
+    const literal = `${arrayPath}[\${${names.index}}].${member.leaf}`;
+    writeLeaf(source, shift, member, rule, ctx.read, names.row, literal);
+    declarations.push({ path: shapeOfPath(literal), literal });
   }
-}
-var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-function isAliasShaped(value) {
-  if (!isRecord(value)) return false;
-  const options = value.compilerOptions;
-  if (options === void 0) return true;
-  if (!isRecord(options)) return false;
-  if (options.baseUrl !== void 0 && typeof options.baseUrl !== "string") return false;
-  if (options.paths === void 0) return true;
-  if (!isRecord(options.paths)) return false;
-  return Object.values(options.paths).every(
-    (targets) => Array.isArray(targets) && targets.every((target) => typeof target === "string")
-  );
-}
-function unreadableConfigs(sources) {
-  return sources.filter((source) => isProjectConfig(source.path) && readJsonc(source.content) === null).map((source) => source.path);
-}
-function expand(specifier, aliases) {
-  const out = [];
-  for (const [pattern, targets] of aliases) {
-    const star = pattern.indexOf("*");
-    if (star < 0) {
-      if (specifier === pattern) out.push(...targets);
-      continue;
-    }
-    const head = pattern.slice(0, star);
-    const tail = pattern.slice(star + 1);
-    if (!specifier.startsWith(head) || !specifier.endsWith(tail)) continue;
-    const middle = specifier.slice(head.length, specifier.length - tail.length);
-    out.push(...targets.map((target) => target.replace("*", middle)));
+  const args = [ctx.snapshot, JSON.stringify(arrayPath), JSON.stringify(fallbackRows), ...ctx.slug ? [ctx.slug] : []];
+  const rowsExpr = `${ctx.rows}(${args.join(", ")})`;
+  if (rule.loop.kind === "attr") {
+    source.appendRight(template.attrInsertAt + shift, ` ${rule.loop.attr(rowsExpr, names.row, names.index)}`);
   }
-  return out;
-}
-function resolveSpecifier(fromFile, specifier, files, aliases) {
-  if (specifier.startsWith(".")) return firstPresent(join(fromFile, specifier), files);
-  for (const candidate of expand(specifier, aliases)) {
-    const found = firstPresent(candidate.replace(/\/$/, ""), files);
-    if (found) return found;
+  if (rule.loopKey) {
+    const key = rule.loopKey(names.index);
+    if (!template.keyAttr) source.appendRight(template.attrInsertAt + shift, ` ${key}`);
+    else if (template.keyAttr.end > template.keyAttr.start)
+      source.overwrite(template.keyAttr.start + shift, template.keyAttr.end + shift, key);
+    else return null;
   }
-  return null;
+  const indent = indentOf(ctx.content, template.range.start);
+  const text = rule.loop.kind === "wrap" ? `${rule.loop.open(rowsExpr, names.row, names.index)}
+${indented(source.toString(), indent)}
+${indent}${rule.loop.close}` : source.toString();
+  return {
+    range: { start: template.range.start, end: rows[rows.length - 1].range.end },
+    text,
+    declarations,
+    bindings: [...new Set(declarations.map((d) => d.path))],
+    names
+  };
 }
-function importsIn(parsed, _dialect) {
-  const out = /* @__PURE__ */ new Map();
-  walkAst(parsed.ast, (node) => {
-    if (node.type !== "ImportDeclaration") return;
-    if (node.importKind === "type") return;
-    const specifier = node.source?.value;
-    if (typeof specifier !== "string") return;
-    for (const entry of node.specifiers ?? []) {
-      if (entry.importKind === "type") continue;
-      const local = entry.local?.name;
-      if (typeof local !== "string") continue;
-      const kind = entry.type === "ImportDefaultSpecifier" ? "default" : entry.type === "ImportNamespaceSpecifier" ? "namespace" : "named";
-      const imported = kind === "named" ? entry.imported?.name ?? local : null;
-      out.set(local, { specifier, imported, kind });
-    }
+function setLeaf(row, leaf, value) {
+  const segments = leaf.split(".").flatMap((segment) => {
+    const name = segment.replace(/\[\d+\]/g, "");
+    const indices = [...segment.matchAll(/\[(\d+)\]/g)].map((m) => Number(m[1]));
+    return [...name ? [name] : [], ...indices];
   });
-  return out;
+  if (segments.some((segment) => typeof segment === "string" && FORBIDDEN.has(segment))) return false;
+  let cursor = row;
+  for (const [at, segment] of segments.entries()) {
+    const key = segment;
+    const last = at === segments.length - 1;
+    if (last) {
+      cursor[key] = value;
+      return true;
+    }
+    const held = Object.prototype.hasOwnProperty.call(cursor, key) ? cursor[key] : void 0;
+    if (held === void 0 || typeof held !== "object" || held === null) {
+      cursor[key] = typeof segments[at + 1] === "number" ? [] : emptyRow();
+    }
+    cursor = cursor[key];
+  }
+  return true;
+}
+var FORBIDDEN = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+var emptyRow = () => /* @__PURE__ */ Object.create(null);
+function splitIndexed(arrayPath, path) {
+  if (!path.startsWith(`${arrayPath}[`)) return null;
+  const match = path.slice(arrayPath.length).match(/^\[(\d+)\]\.(.+)$/);
+  return match ? { index: Number(match[1]), leaf: match[2] } : null;
 }
 
 // src/routes.ts
@@ -4075,13 +4515,15 @@ function declaringElements(roots, content) {
   return out;
 }
 function helperLocals(parsed, dialect, file) {
-  const out = { bcms: [], bcmsRows: [], bcmsLayout: [] };
+  const out = { bcms: [], bcmsRows: [], bcmsRowsAs: [], bcmsImage: [], bcmsLayout: [] };
   const helper = HELPER_PATH[dialect];
   if (!helper) return out;
   for (const [local, from] of importsIn(parsed, dialect)) {
     if (!namesFile(file, from.specifier, helper)) continue;
     if (from.imported === "bcms") out.bcms.push(local);
     if (from.imported === "bcmsRows") out.bcmsRows.push(local);
+    if (from.imported === "bcmsRowsAs") out.bcmsRowsAs.push(local);
+    if (from.imported === "bcmsImage") out.bcmsImage.push(local);
     if (from.imported === "bcmsLayout") out.bcmsLayout.push(local);
   }
   return out;
@@ -4113,19 +4555,29 @@ function snapshotLocal(parsed, dialect, slug, file) {
   }
   return null;
 }
+function moduleBytes(roots, content) {
+  let out = "";
+  let at = 0;
+  for (const root of roots) {
+    if (root.type !== "element" || root.start < at) continue;
+    out += content.slice(at, root.start);
+    at = Math.max(at, root.end);
+  }
+  return out + content.slice(at);
+}
 var identifier = (name) => `(?<![\\w$])${escapeRegExp(name)}(?![\\w$])`;
-function elementReads(own, target, locals, snapshot) {
+function elementReads(own, target, locals, snapshot, viaRow) {
   const quoted = escapeRegExp(JSON.stringify(target.path));
   if (target.scope === "layout") {
     return locals.bcmsLayout.some((name) => new RegExp(`${identifier(name)}\\s*\\(\\s*${quoted}`).test(own));
   }
   const indexed = splitArrayPath(target.path);
-  if (indexed) {
+  if (viaRow && indexed) {
     const leaf = escapeRegExp(JSON.stringify(indexed.leaf));
     return locals.bcms.some((name) => new RegExp(`${identifier(name)}\\s*\\([^)]*,\\s*${leaf}`).test(own));
   }
   if (!snapshot) return false;
-  return locals.bcms.some(
+  return [...locals.bcms, ...locals.bcmsImage].some(
     (name) => new RegExp(`${identifier(name)}\\s*\\(\\s*${identifier(snapshot)}\\s*,\\s*${quoted}`).test(own)
   );
 }
@@ -4135,16 +4587,33 @@ function convertedHere(content, parsed, dialect, target, file) {
   const snapshot = snapshotLocal(parsed, dialect, target.slug, file);
   const shape = shapeOfPath(target.path);
   const indexed = splitArrayPath(target.path);
+  let keyed = false;
+  let rows = false;
   if (indexed) {
     const array = escapeRegExp(JSON.stringify(indexed.array));
-    const rows = locals.bcmsRows.some(
+    const reads = (names) => names.some(
       (name) => snapshot !== null && new RegExp(`${identifier(name)}\\s*\\(\\s*${identifier(snapshot)}\\s*,\\s*${array}`).test(content)
     );
-    if (!rows) return false;
-  }
-  return declaringElements(parsed.roots, content).some(
-    (element) => element.scope === target.scope && (element.path === target.path || element.path === shape) && elementReads(element.own, target, locals, snapshot)
-  );
+    keyed = reads(locals.bcmsRowsAs);
+    rows = keyed || reads(locals.bcmsRows);
+  }
+  let cached = null;
+  const moduleRead = () => {
+    if (indexed || snapshot === null) return false;
+    cached ??= moduleBytes(parsed.roots, content);
+    const quoted = escapeRegExp(JSON.stringify(target.path));
+    return locals.bcms.some(
+      (name) => new RegExp(`${identifier(name)}\\s*\\(\\s*${identifier(snapshot)}\\s*,\\s*${quoted}`).test(cached)
+    );
+  };
+  return declaringElements(parsed.roots, content).some((element) => {
+    if (element.scope !== target.scope) return false;
+    if (element.path === target.path) {
+      return elementReads(element.own, target, locals, snapshot, false) || moduleRead();
+    }
+    if (element.path !== shape) return false;
+    return rows && (keyed || elementReads(element.own, target, locals, snapshot, true));
+  });
 }
 
 // src/rewrite.ts
@@ -4210,7 +4679,7 @@ function rewriteFile(content, dialect, rewrites, imports, extra = []) {
       addDeclaration(site.attrInsertAt, declaration(rewrite));
       continue;
     }
-    if (kind === "richtext") {
+    if (kind === "richtext" && !(site.mixed && site.textRange)) {
       if (!isIntrinsic(site.tag)) continue;
       if (rule.richtext && site.inner) {
         source.remove(site.inner.start, site.inner.end);
@@ -4221,11 +4690,13 @@ function rewriteFile(content, dialect, rewrites, imports, extra = []) {
       continue;
     }
     if (site.mixed && site.textRange) {
+      const html = kind === "richtext" && rule.richtext ? rule.richtext(expression) : null;
       const inner = rule.text ? rule.text(expression) : content.slice(site.textRange.start, site.textRange.end).trim();
+      const attributes2 = attrsFor(path, kind, void 0, rewrite.scope);
       source.overwrite(
         site.textRange.start,
         site.textRange.end,
-        `<span ${attrsFor(path, kind, void 0, rewrite.scope)}>${inner}</span>`
+        html ? `<span ${attributes2} ${html}></span>` : `<span ${attributes2}>${inner}</span>`
       );
       continue;
     }
@@ -4481,6 +4952,7 @@ function convert3(node, content) {
       }
     ];
   }
+  if (node.type === "fragment") return (node.children ?? []).flatMap((child) => convert3(child, content));
   if (node.type !== "element" && node.type !== "component" && node.type !== "custom-element") return [];
   const tag = node.name ?? "";
   const children = (node.children ?? []).flatMap((child) => convert3(child, content));
@@ -4855,16 +5327,16 @@ function functionBindings(fn) {
   if (body?.type === "BlockStatement") statementNames2(body.body, out);
   return out;
 }
-function stringLiterals(node, out) {
+function stringLiterals2(node, out) {
   if (!isNode(node)) {
-    if (Array.isArray(node)) for (const child of node) stringLiterals(child, out);
+    if (Array.isArray(node)) for (const child of node) stringLiterals2(child, out);
     return;
   }
   if (FUNCTIONS3.has(node.type)) return;
   if (node.type === "StringLiteral" && typeof node.value === "string") out.add(node.value);
   for (const key of Object.keys(node)) {
     if (key === "loc" || key === "leadingComments" || key === "trailingComments") continue;
-    stringLiterals(node[key], out);
+    stringLiterals2(node[key], out);
   }
 }
 function usages(ast, local) {
@@ -4881,7 +5353,7 @@ function usages(ast, local) {
     if (FUNCTIONS3.has(node.type)) {
       nextScope = /* @__PURE__ */ new Set([...scope, ...functionBindings(node)]);
       nextLiterals = /* @__PURE__ */ new Set();
-      stringLiterals(node.body, nextLiterals);
+      stringLiterals2(node.body, nextLiterals);
     }
     if (node.type === "JSXElement") {
       const name = node.openingElement?.name;
@@ -5211,12 +5683,28 @@ var SOURCE_EXTENSIONS = [
   ".erb",
   ".twig"
 ];
+var PROSE_EXTENSIONS = [".md", ".mdx", ".njk", ".hbs", ".ejs", ".liquid", ".erb", ".twig"];
+var TEMPLATE_DIRS = /* @__PURE__ */ new Set([
+  "pages",
+  "content",
+  "src",
+  "app",
+  "routes",
+  "layouts",
+  "components",
+  "templates",
+  "views",
+  "_includes",
+  "_layouts"
+]);
 function isSourceCandidate(path) {
   const lower = path.toLowerCase();
   if (SKIP_DIRS.some((dir) => lower === dir.slice(0, -1) || lower.startsWith(dir) || lower.includes(`/${dir}`)))
     return false;
   if (SKIP_FILES.includes(lower.split("/").pop() ?? "")) return false;
-  return SOURCE_EXTENSIONS.some((ext) => lower.endsWith(ext));
+  if (!SOURCE_EXTENSIONS.some((ext) => lower.endsWith(ext))) return false;
+  if (!PROSE_EXTENSIONS.some((ext) => lower.endsWith(ext))) return true;
+  return lower.split("/").slice(0, -1).some((segment) => TEMPLATE_DIRS.has(segment));
 }
 
 // src/declared.ts
@@ -7042,6 +7530,7 @@ var ConvertError = class extends Error {
 var keyOf = (route, scope, path) => scope === "layout" ? `layout::${path}` : `${route}::page::${path}`;
 var escapeRegExp2 = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var identifierFor2 = (slug) => `bcms${slug.replace(/[^A-Za-z0-9]+(.)?/g, (_, c) => c ? c.toUpperCase() : "").replace(/^./, (c) => c.toUpperCase())}`;
+var UNPLACED = /* @__PURE__ */ new Set(["NOT_IN_SOURCE", "IN_EXPRESSION"]);
 async function drillProp(ctx, fromFile, component, prop, kind, hop) {
   const miss = { ok: false, reason: "PROP_TARGET_NOT_FOUND", edits: [] };
   if (hop > MAX_HOPS) return { ok: false, reason: "PROP_DRILLED_DEEP", edits: [] };
@@ -7138,7 +7627,7 @@ async function convertSources(briefIn, sources, options) {
     const parsed = await parseOf(source.path);
     declarations.set(
       source.path,
-      parsed === null ? /* @__PURE__ */ new Set() : parsed.error ? declaredByScan(source.content) : declaredInTree(parsed.roots, source.content)
+      parsed === null ? isTolerantDialect(source.path) ? declaredByScan(source.content) : /* @__PURE__ */ new Set() : parsed.error ? declaredByScan(source.content) : declaredInTree(parsed.roots, source.content)
     );
   }
   let declaredOnly = 0;
@@ -7170,6 +7659,36 @@ async function convertSources(briefIn, sources, options) {
     const key = keyOf(hit.route, hit.scope ?? "page", hit.path);
     if (!locatedByKey.has(key)) locatedByKey.set(key, hit);
   }
+  const imageUnresolved = /* @__PURE__ */ new Map();
+  for (const miss of unlocated) {
+    const key = keyOf(miss.route, miss.scope ?? "page", miss.path);
+    const target = targets.get(key);
+    if (!target || target.kind !== "image" || !target.fallback || locatedByKey.has(key)) continue;
+    const hosts = [];
+    for (const file of pageFilesFor(target.route, contents.keys())) {
+      const parsed = await parseOf(file);
+      const dialect = dialectOf(file, contents.get(file) ?? "");
+      const bindings = parsed && dialect ? assetCandidates(parsed, dialect, target.fallback) : [];
+      if (bindings.length > 0) hosts.push({ file, bindings });
+    }
+    const only = hosts.length === 1 && hosts[0].bindings.length === 1 ? hosts[0] : null;
+    if (only) {
+      locatedByKey.set(key, {
+        route: target.route,
+        scope: target.scope,
+        path: target.path,
+        kind: target.kind,
+        original: target.literal,
+        files: [only.file]
+      });
+      continue;
+    }
+    const named = hosts.flatMap((host) => host.bindings.map((binding) => `${host.file}:${binding}`));
+    imageUnresolved.set(
+      key,
+      named.length === 0 ? `No asset imported by this route's page has the base name of ${target.fallback}.` : `${named.join(", ")} all match the base name of ${target.fallback}, and nothing says which.`
+    );
+  }
   const sharingPath = /* @__PURE__ */ new Map();
   for (const [key, hit] of locatedByKey) {
     const held = targets.get(key);
@@ -7213,6 +7732,11 @@ async function convertSources(briefIn, sources, options) {
       declaredRow(target, false, byHand);
       continue;
     }
+    const unresolved = imageUnresolved.get(key);
+    if (unresolved !== void 0) {
+      pend2(target, "IMAGE_ASSET_UNRESOLVED", void 0, unresolved);
+      continue;
+    }
     pend2(target, miss.reason === "no-original" ? "NO_ORIGINAL" : "NOT_IN_SOURCE");
   }
   const byFile = /* @__PURE__ */ new Map();
@@ -7270,7 +7794,14 @@ async function convertSources(briefIn, sources, options) {
     const worst = outcomes.find((o) => o !== "rewritten" && o !== "declared");
     if (worst) {
       const file = hit.files[outcomes.indexOf(worst)];
-      pend2(target, worst, file);
+      pend2(
+        target,
+        worst,
+        file,
+        // The reason says the source does not render it and the file name says where it was
+        // found; without the second half the two read as a contradiction. @see unplacedReason
+        worst === "NOT_IN_SOURCE" && file ? `${file} contains this copy, but no element renders it on its own.` : void 0
+      );
     } else if (outcomes.every((o) => o === "declared")) {
       const witness = await witnessed(target);
       const byHand = witness === null ? declaredByHand(target, hit.files) : null;
@@ -7381,7 +7912,11 @@ async function convertFile(file, content, targets, parsed, declared, llmFallback
   if (pendingTargets.length === 0) return empty;
   if (!dialect) {
     if (isTolerantDialect(file)) {
-      const tolerantLiterals = [...new Set(pendingTargets.map((t) => t.literal))];
+      const already = declaredByScan(content);
+      const remaining = pendingTargets.filter((target) => !covers(already, target));
+      for (const target of pendingTargets) if (covers(already, target)) outcomes.set(target.key, "declared");
+      if (remaining.length === 0) return { ...empty, dialect: null, outcomes };
+      const tolerantLiterals = [...new Set(remaining.map((t) => t.literal))];
       const tolerantSites = findSitesTolerant(content, tolerantLiterals);
       if (tolerantSites.length > 0) {
         return plan(
@@ -7391,7 +7926,7 @@ async function convertFile(file, content, targets, parsed, declared, llmFallback
           // argument is behind `!parsed.error` or `tier !== 2`. Passing the writing dialect keeps
           // the parameter honest rather than widening its type for one caller.
           "html",
-          pendingTargets,
+          remaining,
           tolerantSites,
           void 0,
           // no parse, no import point: tier 2 declares, it does not read
@@ -7404,7 +7939,7 @@ async function convertFile(file, content, targets, parsed, declared, llmFallback
         );
       }
     }
-    for (const target of pendingTargets) outcomes.set(target.key, "DIALECT_UNSUPPORTED");
+    for (const target of pendingTargets) if (!outcomes.has(target.key)) outcomes.set(target.key, "DIALECT_UNSUPPORTED");
     return { ...empty, dialect: null, outcomes };
   }
   const literals = [...new Set(pendingTargets.map((t) => t.literal))];
@@ -7441,8 +7976,8 @@ async function convertFile(file, content, targets, parsed, declared, llmFallback
       return { ...empty, tier: 3, outcomes, dialect: null };
     }
   }
-  if (sites.length === 0) {
-    const reason = tier1.error?.code === "DIALECT_UNSUPPORTED" ? "DIALECT_UNSUPPORTED" : tier1.error ? "PARSE_ERROR" : "NOT_IN_SOURCE";
+  if (sites.length === 0 && tier1.error) {
+    const reason = tier1.error.code === "DIALECT_UNSUPPORTED" ? "DIALECT_UNSUPPORTED" : "PARSE_ERROR";
     for (const target of pendingTargets) outcomes.set(target.key, reason);
     return { ...empty, tier, outcomes, dialect };
   }
@@ -7460,9 +7995,24 @@ async function convertFile(file, content, targets, parsed, declared, llmFallback
     tier1.error ? [] : declarationsIn(tier1.roots, content)
   );
 }
+function unplacedReason(parsed, literal) {
+  if (!parsed || parsed.error) return "NOT_IN_SOURCE";
+  if (parsed.script && norm(parsed.script.code).includes(literal)) return "IN_EXPRESSION";
+  let found = false;
+  const visit = (node) => {
+    if (found) return;
+    if (node.type === "expr") {
+      if (norm(node.value).includes(literal)) found = true;
+      return;
+    }
+    if (node.type === "element" && !node.raw) for (const child of node.children) visit(child);
+  };
+  for (const root of parsed.roots) visit(root);
+  return found ? "IN_EXPRESSION" : "NOT_IN_SOURCE";
+}
 async function plan(file, content, dialect, targets, sites, importAt, outcomes, tier, parsed, drill, declarations) {
   const writing = tier === 2 ? "html" : dialect;
-  const missing = tier !== 2 ? "NOT_IN_SOURCE" : parsed.error?.code === "DIALECT_UNSUPPORTED" ? "DIALECT_UNSUPPORTED" : "PARSE_ERROR";
+  const missing = (literal) => tier !== 2 ? unplacedReason(parsed, literal) : parsed.error?.code === "DIALECT_UNSUPPORTED" ? "DIALECT_UNSUPPORTED" : "PARSE_ERROR";
   const taken = parsed.error ? /* @__PURE__ */ new Set() : topLevelBindings(dialect, parsed, content);
   const slugs = [...new Set(targets.map((t) => t.slug))].sort();
   const preset = /* @__PURE__ */ new Map();
@@ -7471,7 +8021,9 @@ async function plan(file, content, dialect, targets, sites, importAt, outcomes,
     for (const [key, held] of [
       ["helper:bcms", locals.bcms],
       ["helper:bcmsRows", locals.bcmsRows],
-      ["helper:bcmsLayout", locals.bcmsLayout]
+      ["helper:bcmsLayout", locals.bcmsLayout],
+      ["helper:bcmsRowsAs", locals.bcmsRowsAs],
+      ["helper:bcmsImage", locals.bcmsImage]
     ]) {
       if (held[0]) preset.set(key, held[0]);
     }
@@ -7484,6 +8036,8 @@ async function plan(file, content, dialect, targets, sites, importAt, outcomes,
     { key: "helper:bcms", name: "bcms" },
     { key: "helper:bcmsRows", name: "bcmsRows" },
     { key: "helper:bcmsLayout", name: "bcmsLayout" },
+    { key: "helper:bcmsRowsAs", name: "bcmsRowsAs" },
+    { key: "helper:bcmsImage", name: "bcmsImage" },
     // Keyed by the SLUG: two slugs that spell one identifier are still two pages. @see scope.ts
     ...slugs.map((slug) => ({ key: `slug:${slug}`, name: identifierFor2(slug) }))
   ].filter((entry) => !preset.has(entry.key));
@@ -7501,7 +8055,7 @@ async function plan(file, content, dialect, targets, sites, importAt, outcomes,
   for (const [literal, sharing] of byLiteral) {
     const forLiteral = sites.filter((s) => s.literal === literal);
     if (forLiteral.length === 0) {
-      for (const target of sharing) outcomes.set(target.key, missing);
+      for (const target of sharing) outcomes.set(target.key, missing(literal));
       continue;
     }
     const assigned = sharing.length === 1 ? /* @__PURE__ */ new Map([[sharing[0].key, forLiteral]]) : resolvePositionally(sharing, forLiteral);
@@ -7515,7 +8069,7 @@ async function plan(file, content, dialect, targets, sites, importAt, outcomes,
       if (rewritable.length === 0) {
         outcomes.set(
           target.key,
-          mine.some((s) => s.partial) ? "SUBSTRING_ONLY" : mine.some((s) => s.where === "script" || s.where === "comment") ? "IN_SCRIPT_OR_COMMENT" : missing
+          mine.some((s) => s.partial) ? "SUBSTRING_ONLY" : mine.some((s) => s.where === "script" || s.where === "comment") ? "IN_SCRIPT_OR_COMMENT" : missing(literal)
         );
         continue;
       }
@@ -7590,7 +8144,11 @@ async function plan(file, content, dialect, targets, sites, importAt, outcomes,
           // `original` has been through `firstBlockText`, so it is the text a reader sees with
           // the markup already stripped. Keeping that as the in-code fallback would silently
           // flatten every bold and link the moment a build ran against a stub snapshot.
-          fallback: target.kind === "richtext" && site.inner ? content.slice(site.inner.start, site.inner.end).trim() : target.fallback,
+          //
+          // 🔴 AND ONLY WHEN THE ELEMENT'S SUBTREE IS THE VALUE. A value that is one TEXT NODE of
+          // a mixed element gets a wrapper of its own, so taking the element's inner range as its
+          // fallback swallowed the `<em>` beside it — the wrapper then rendered the sibling twice.
+          fallback: target.kind === "richtext" && site.inner && !(site.mixed && site.textRange) ? content.slice(site.inner.start, site.inner.end).trim() : target.fallback,
           snapshot: snapshotName(target.slug),
           slug: target.slug,
           scope: target.scope,
@@ -7671,10 +8229,48 @@ async function plan(file, content, dialect, targets, sites, importAt, outcomes,
   const collided = new Set(overlapping(kept).map((r) => r.key));
   const applied = kept.filter((r) => !collided.has(r.key));
   for (const key of collided) outcomes.set(key, "AMBIGUOUS_LITERAL");
-  if (applied.length === 0) {
+  const data = bindDataLiterals(
+    {
+      content,
+      parsed,
+      dialect: writing,
+      rowsAs: helperName("bcmsRowsAs"),
+      read: helperName("bcms"),
+      snapshotName,
+      slug: params?.slug ?? null
+    },
+    targets.filter((t) => {
+      const outcome = outcomes.get(t.key);
+      return t.scope === "page" && (outcome === void 0 || UNPLACED.has(outcome));
+    }).map((t) => ({
+      key: t.key,
+      path: t.path,
+      kind: t.kind,
+      literal: t.literal,
+      slug: t.slug
+    }))
+  );
+  for (const key of data.bound) outcomes.set(key, "rewritten");
+  for (const refusal of data.refused) outcomes.set(refusal.key, refusal.reason);
+  for (const declaration2 of data.declarations) {
+    dynamic.push({ file, prop: null, path: declaration2.path, callSites: [{ file, literal: declaration2.literal }] });
+  }
+  const images = bindImages(
+    { content, parsed, dialect: writing, image: helperName("bcmsImage"), snapshotName, slug: params?.slug ?? null },
+    targets.filter((t) => {
+      const outcome = outcomes.get(t.key);
+      return t.kind === "image" && t.scope === "page" && (outcome === void 0 || UNPLACED.has(outcome));
+    }).map((t) => ({ key: t.key, path: t.path, kind: t.kind, original: t.fallback, slug: t.slug }))
+  );
+  for (const key of images.bound) outcomes.set(key, "rewritten");
+  for (const refusal of images.refused) outcomes.set(refusal.key, refusal.reason);
+  const lanes = [...data.splices, ...images.splices];
+  if (applied.length === 0 && lanes.length === 0) {
     return { tier, content: null, outcomes, bindings: [], occurrences: { located, rewritten: 0 }, dialect: writing, dynamic: [], componentEdits, snapshots: [] };
   }
-  const readSlugs = [...new Set(applied.filter((r) => r.scope === "page").map((r) => r.slug))].sort();
+  const readSlugs = [
+    .../* @__PURE__ */ new Set([...applied.filter((r) => r.scope === "page").map((r) => r.slug), ...data.slugs, ...images.slugs])
+  ].sort();
   const helper = HELPER_PATH[writing];
   const rewritten = rewriteFile(content, writing, applied, {
     // html reads nothing at build time, so it imports nothing: `injectFields` writes its values
@@ -7695,10 +8291,13 @@ async function plan(file, content, dialect, targets, sites, importAt, outcomes,
         { name: "bcms", alias: helperName("bcms") },
         { name: "bcmsRows", alias: helperName("bcmsRows") }
       ] : [],
-      ...applied.some((r) => r.scope === "layout") ? [{ name: "bcmsLayout", alias: helperName("bcmsLayout") }] : []
+      ...applied.some((r) => r.scope === "layout") ? [{ name: "bcmsLayout", alias: helperName("bcmsLayout") }] : [],
+      ...data.usesRows ? [{ name: "bcmsRowsAs", alias: helperName("bcmsRowsAs") }] : [],
+      ...data.usesRead ? [{ name: "bcms", alias: helperName("bcms") }] : [],
+      ...images.splices.length > 0 ? [{ name: "bcmsImage", alias: helperName("bcmsImage") }] : []
     ].filter((helper2, at, all) => all.findIndex((h) => h.name === helper2.name) === at).filter((helper2) => !preset.has(`helper:${helper2.name}`)),
     at: importAt
-  }, params?.splices ?? []);
+  }, [...params?.splices ?? [], ...lanes]);
   return {
     tier,
     content: rewritten,
@@ -7906,7 +8505,11 @@ export {
   aliasesFrom,
   assertReceipt,
   assertSections,
+  assetCandidates,
+  assetImport,
   attrsFor,
+  bindDataLiterals,
+  bindImages,
   briefDigest,
   canvasBridge,
   carryFor,