@bettercms-ai/astro 0.25.0 → 0.27.0

package/README.md

@@ -151,6 +151,38 @@ typed — the value is still composed correctly on submit. `@bettercms-ai/next`
 choice and ships a formatter in a lazy chunk.
 
 
+## Sections in the CMS order: `<BcmsSections>`
+
+A page whose sections are written in its `.astro` file renders them in the order its CMS page
+lists them. Each section goes in a named slot, named by its placement's bind; the markup inside is
+yours and is rendered as written.
+
+```astro
+---
+import BcmsSections from "@bettercms-ai/astro/components/BcmsSections.astro";
+---
+<Layout>
+  <BcmsSections page="home">
+    <Fragment slot="hero"><Hero /></Fragment>
+    <Fragment slot="code:sec1"><LogoStrip /></Fragment>
+    <Fragment slot="features"><Features /></Fragment>
+  </BcmsSections>
+</Layout>
+```
+
+- A block bound to a slot renders that slot at the block's position. Its root element gets
+  `data-bcms-block`, `data-bcms-style` and the block's style; no element is added around it.
+- A section added in the editor (a block with no bind) is drawn by `<BcmsBlocks>`, which
+  `<BcmsSections>` imports itself. It needs no `bettercms()` on the build: without the integration
+  the components read `PUBLIC_BCMS_*` and the content snapshot. `Blocks` swaps in another renderer.
+- A slot no block names: `code:<bind>` always renders where you wrote it. A bare `<bind>` does too
+  until the list names one of the page's slots; after that it is a removed section.
+- With no snapshot (a local build, the API down) every slot renders in source order, untouched.
+
+The block list is the published snapshot's (`bcms-content.json`), or the draft's when the Visual
+Editor frames a server-rendered page in draft mode. Pass `blocks` to give it yourself.
+`npx @bettercms-ai/convert --sections` writes this wrap for you.
+
 ## Live editing on a static site — `<BcmsLiveBlocks>`
 
 When the Visual Editor frames a static build it can only show what was built, so editing a

package/components/BcmsBlocks.astro

@@ -352,6 +352,20 @@ const pass = { forms, components, turnstileSiteKey, nested: true, fieldAddresses
         );
       }
       case "button":
+        // The site's script owns the click: a `<button type="button">`, never an anchor with an invented href.
+        if (p.action === "code") return (
+          <button
+            type="button"
+            class={`bcms-btn bcms-btn-${buttonVariantOf(p.variant)}${p.size === "sm" || p.size === "lg" ? ` bcms-btn-${p.size}` : ""}${p.fullWidth === true ? " bcms-btn-full" : ""}`}
+            style={buttonPaintAttr(block)}
+            {...bind(block.id, "text", "text", bctx)}
+            {...blockAttrs}
+          >
+            {buttonIconOf(p.icon) && <Fragment set:html={buttonIconSvg(buttonIconOf(p.icon)!, "bcms-btn-icon")} />}
+            {p.text}
+            {p.arrow === true && <Fragment set:html={buttonIconSvg("arrow-right", "bcms-btn-arrow")} />}
+          </button>
+        );
         return (
           <a
             class={`bcms-btn bcms-btn-${buttonVariantOf(p.variant)}${p.size === "sm" || p.size === "lg" ? ` bcms-btn-${p.size}` : ""}${p.fullWidth === true ? " bcms-btn-full" : ""}`}

package/components/BcmsButton.astro

@@ -1,17 +1,21 @@
 ---
 /**
  * <BcmsButton> — render a `button` field ({ label, href, variant?, size?, arrow?, icon?,
- * newTab? }) as one editable button, the way the BetterCMS visual editor and in-place publishing
+ * newTab?, fullWidth? }) as one editable button, the way the BetterCMS visual editor and in-place publishing
  * expect to find it:
  *
- *   <a data-bcms-button="<path>" data-variant data-size href [target rel] data-bcms-props="<path>.href|url|href">
+ *   <a data-bcms-button="<path>" data-variant data-size [data-full-width] href [target rel] data-bcms-props="<path>.href|url|href">
  *     [<svg class="bcms-btn-icon">]<span data-bcms-field="<path>.label">Label</span>[<svg class="bcms-btn-arrow">]
  *   </a>
  *
+ * A value with `action: "code"` (no href: the site's script handles the click) renders the same
+ * children in `<button type="button" data-bcms-button="<path>" data-variant data-size>`.
+ *
  * Style it by `data-variant` (primary · secondary · tertiary · brand · dark · light · outline ·
  * link) and `data-size` (sm · md · lg) in your own CSS: the editor repaints those attributes as the
  * author picks, and publishing writes them into the live page, so your stylesheet decides what a
- * look looks like. `class` is passed through untouched.
+ * look looks like. A full-width button also carries `display:flex;width:100%;justify-content:center`
+ * inline, so it stretches across its column with no rule of yours. `class` is passed through untouched.
  *
  *   <BcmsButton path="hero.cta" value={page.hero.cta} class="btn" />
  */
@@ -27,13 +31,21 @@ interface Props {
 const { path, value, class: className } = Astro.props;
 const b = readButtonValue(value);
 ---
-{b.label && (
+{b.label && b.action === "code" && (
+  <button type="button" class={className} data-bcms-button={path} data-variant={b.variant} data-size={b.size} {...(b.fullWidth ? { "data-full-width": "", style: "display:flex;width:100%;justify-content:center" } : {})}>
+    {b.icon && <Fragment set:html={buttonIconSvg(b.icon, "bcms-btn-icon")} />}
+    <span data-bcms-field={`${path}.label`} data-bcms-kind="text">{b.label}</span>
+    {b.arrow && <Fragment set:html={buttonIconSvg("arrow-right", "bcms-btn-arrow")} />}
+  </button>
+)}
+{b.label && b.action !== "code" && (
   <a
     class={className}
     href={b.href || "#"}
     data-bcms-button={path}
     data-variant={b.variant}
     data-size={b.size}
+    {...(b.fullWidth ? { "data-full-width": "", style: "display:flex;width:100%;justify-content:center" } : {})}
     data-bcms-props={formatPropsAttribute([{ address: `${path}.href`, kind: "url", attr: "href" }])}
     {...(b.newTab ? { target: "_blank", rel: "noopener noreferrer" } : {})}
   >

package/components/BcmsForm.astro

@@ -7,7 +7,7 @@
  * Markup is class-driven and unstyled — the host owns CSS (matches the
  * server-side renderer's class names: bcms-form, bcms-field, bcms-check, …).
  */
-import config from "bettercms:config";
+import config from "@bettercms-ai/astro/public-config";
 import type { DeliveryForm, DeliveryFormField } from "@bettercms-ai/sdk";
 import { getCountries, getCountryCallingCode, isSupportedCountry, getExampleNumber } from "libphonenumber-js/min";
 import phoneExamples from "libphonenumber-js/mobile/examples";

package/components/BcmsImage.astro

@@ -15,7 +15,7 @@
  * is what `sizes` selects from. The value's `altText` is the alt unless `alt` says otherwise.
  * The same markup as @bettercms-ai/next's <BcmsImage>.
  */
-import config from "bettercms:config";
+import config from "@bettercms-ai/astro/public-config";
 import imageUrlBuilder, {
   focalInCrop,
   normalizeImageCrop,

package/components/BcmsSections.astro

@@ -0,0 +1,88 @@
+---
+/**
+ * <BcmsSections> — a code-built page's sections, in the order its CMS page lists them.
+ *
+ *   <BcmsSections page="home" Blocks={BcmsBlocks}>
+ *     <Fragment slot="hero"><Hero title="…" /></Fragment>
+ *     <Fragment slot="features"><Features /></Fragment>
+ *   </BcmsSections>
+ *
+ * Each section the page can draw is a named slot, named by its placement's bind: the markup inside
+ * is the site's own and is rendered as written. The CMS page's block list decides the rest:
+ *
+ * - a block bound to a slot renders that slot at the block's position, with `data-bcms-block`, the
+ *   `data-bcms-style` marker and the block's style on the section's own root (no wrapper);
+ * - a block with no bind (a section added from the library) is drawn by `<BcmsBlocks>`, with or
+ *   without `bettercms()` registered on this build. `Blocks` swaps in another renderer;
+ * - a slot no block names: `code:<bind>` always renders where the source has it; a bare `<bind>`
+ *   does too until the list names one of this page's slots, and from then on it is a removed section.
+ *
+ * With no block list (a build without a snapshot, the API down) every slot renders in source order,
+ * untouched. Server-rendered only: no script, and no element of its own around the sections.
+ * Twin: `BcmsSections` in @bettercms-ai/next/sections; the order is `planSections` in @bettercms-ai/types.
+ */
+import type { ContentBlock } from "@bettercms-ai/types";
+import { RESPONSIVE_CSS, planSections, usesHideOn, visibleBlocks } from "@bettercms-ai/types";
+import { SECTIONS_END, draftSections, publishedSections, sectionsApiUrl, sectionsStart, stampSectionRoot } from "../dist/sections.js";
+import BcmsBlocks from "./BcmsBlocks.astro";
+
+interface Props {
+  /** The CMS page's slug: `home`, `services`. */
+  page: string;
+  /** A dynamic route (`[slug].astro`): `page` is the collection page, whose list is its item template's, drawn on every entry. */
+  template?: boolean;
+  /** The block list to follow instead of the snapshot's (or the draft's). `null` renders the source order. */
+  blocks?: ContentBlock[] | null;
+  /** What draws a block the page has no slot for. Default: `BcmsBlocks` from this package. */
+  Blocks?: any;
+  /** Component definitions and forms for `Blocks`. Default: the snapshot's. */
+  components?: unknown[];
+  forms?: unknown[];
+  /** The slots in source order, when it must be said outright. Default: the order they are written in. */
+  order?: string[];
+}
+
+const { page, template = false, blocks: given, Blocks = BcmsBlocks, components, forms, order } = Astro.props;
+const names = (order ?? Object.keys(Astro.slots)).filter((name) => name !== "default" && Astro.slots.has(name));
+
+const published = given === undefined ? publishedSections(page, template) : null;
+const bcms = (Astro.locals as { bcms?: { draft?: boolean; token?: string } } | undefined)?.bcms;
+const draft = published && bcms?.draft && bcms.token ? await draftSections(page, bcms.token, sectionsApiUrl(published.apiUrl)) : null;
+const list = given !== undefined ? given : (draft ?? published?.blocks ?? null);
+const plan = planSections(names, Array.isArray(list) ? visibleBlocks(list, new Date()) : null);
+
+// A section that throws is CONTAINED to itself: on a page rendered per request the response is
+// already streaming, and one section's exception would end it there. Left out and logged in
+// production; in dev it still fails loudly.
+const renderSlot = async (name: string): Promise<string> => {
+  try {
+    return await Astro.slots.render(name);
+  } catch (error) {
+    if (import.meta.env.DEV) throw error;
+    console.error(`[BcmsSections] section "${name}" failed to render on ${Astro.url.pathname}:`, error);
+    return "";
+  }
+};
+
+// Consecutive CMS blocks share one `Blocks` call, so its container wraps the run once.
+const parts: Array<{ html: string } | { blocks: ContentBlock[] }> = [];
+for (const item of plan) {
+  if (item.slot !== null) {
+    const html = await renderSlot(item.slot);
+    parts.push({ html: item.block ? stampSectionRoot(html, item.block, page) : html });
+  } else {
+    const last = parts[parts.length - 1];
+    if (last && "blocks" in last) last.blocks.push(item.block);
+    else parts.push({ blocks: [item.block] });
+  }
+}
+// Only when a placed section hides somewhere, so a page without `hideOn` renders exactly as before.
+const hides = usesHideOn(plan.filter((item) => item.slot !== null).map((item) => item.block));
+---
+<Fragment set:html={sectionsStart(page)} />{hides && <style is:inline set:html={RESPONSIVE_CSS}></style>}{parts.map((part) =>
+  "html" in part ? (
+    <Fragment set:html={part.html} />
+  ) : (
+    <Blocks blocks={part.blocks} components={components ?? published?.components ?? []} forms={forms ?? published?.forms ?? []} />
+  ),
+)}<slot /><Fragment set:html={SECTIONS_END} />

package/dist/bindings.d.ts

@@ -38,6 +38,8 @@ declare function bindProps(id: string | undefined, entries: readonly {
     attr: string;
     present: boolean;
 }[], ctx: BindingCtx): Record<string, string>;
+/** Where the tag opened at `from` (`<`) ends, quotes respected; -1 when it never does. */
+declare function tagEnd(html: string, from: number): number;
 /**
  * `<BcmsField>`'s child, when it is ONE element: the same markup with the binding attributes on
  * that element's own tag. Null when the rendered slot is anything else (text, several elements,
@@ -53,4 +55,4 @@ declare function bindProps(id: string | undefined, entries: readonly {
  */
 declare function stampSoleElement(html: string, attrs: Record<string, string | undefined>): string | null;
 
-export { type BindingCtx, addressFor, bind, bindProps, stampSoleElement };
+export { type BindingCtx, addressFor, bind, bindProps, stampSoleElement, tagEnd };

package/dist/bindings.js

@@ -82,6 +82,7 @@ export {
   addressFor,
   bind,
   bindProps,
-  stampSoleElement
+  stampSoleElement,
+  tagEnd
 };
 //# sourceMappingURL=bindings.js.map

package/dist/bindings.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bindings.ts"],"sourcesContent":["/**\n * Visual Editor addresses for the Astro renderer.\n *\n * Identical contract to `@bettercms-ai/next`'s `bindings.ts`, and the SAME reason for existing:\n * inside a component instance the definition's block ids address nothing, because they are\n * shared by every instance of it. Stamping them produces an orphan on one placement and a\n * duplicate that drops BOTH on two.\n *\n * Kept as a `.ts` module rather than inlined in the `.astro` frontmatter so the logic is\n * testable without an Astro compiler, and so the two SDKs cannot drift from each other by\n * having one file edited and not the other.\n */\nimport type { BindingKind } from \"@bettercms-ai/types\";\nimport { formatPropsAttribute } from \"@bettercms-ai/types\";\n\nexport interface BindingCtx {\n  /** Present only inside a component instance, where it is AUTHORITATIVE. */\n  fieldAddresses?: Map<string, string>;\n}\n\n/** The address a write lands on, or null when none exists. */\nexport function addressFor(id: string | undefined, prop: string, ctx: BindingCtx): string | null {\n  if (!id) return null;\n  const key = `${id}__${prop}`;\n  if (ctx.fieldAddresses) return ctx.fieldAddresses.get(key) ?? null;\n  return key;\n}\n\n/**\n * Attributes for a value rendered as this element's own content. Astro omits `undefined`\n * attributes, so an empty object spreads to nothing.\n */\nexport function bind(\n  id: string | undefined,\n  prop: string,\n  kind: BindingKind,\n  ctx: BindingCtx,\n): Record<string, string> {\n  const address = addressFor(id, prop, ctx);\n  return address ? { \"data-bcms-field\": address, \"data-bcms-kind\": kind } : {};\n}\n\n/**\n * Attributes for values that live in an ATTRIBUTE of this element. `data-bcms-field` addresses\n * one element and an element cannot hold two, so these ride `data-bcms-props`:\n * `<address>|<kind>|<domAttribute>`, semicolon separated.\n *\n * An entry whose value is absent is dropped — `setFieldPath` refuses to create a final key, so\n * the address would be a write the editor rejects.\n */\nexport function bindProps(\n  id: string | undefined,\n  entries: readonly { prop: string; kind: BindingKind; attr: string; present: boolean }[],\n  ctx: BindingCtx,\n): Record<string, string> {\n  const resolved = entries.flatMap(({ prop, kind, attr, present }) => {\n    if (!present) return [];\n    const address = addressFor(id, prop, ctx);\n    return address ? [{ address, kind, attr }] : [];\n  });\n  return resolved.length ? { \"data-bcms-props\": formatPropsAttribute(resolved) } : {};\n}\n\nconst VOID_TAGS = new Set([\"area\", \"base\", \"br\", \"col\", \"embed\", \"hr\", \"img\", \"input\", \"link\", \"meta\", \"source\", \"track\", \"wbr\"]);\nconst RAW_TEXT_TAGS = new Set([\"script\", \"style\", \"textarea\", \"title\"]);\n\n/** Where the tag opened at `from` (`<`) ends, quotes respected; -1 when it never does. */\nfunction tagEnd(html: string, from: number): number {\n  let quote = \"\";\n  for (let i = from; i < html.length; i++) {\n    const c = html[i]!;\n    if (quote) {\n      if (c === quote) quote = \"\";\n    } else if (c === '\"' || c === \"'\") quote = c;\n    else if (c === \">\") return i;\n  }\n  return -1;\n}\n\n/**\n * `<BcmsField>`'s child, when it is ONE element: the same markup with the binding attributes on\n * that element's own tag. Null when the rendered slot is anything else (text, several elements,\n * an element that already declares a field, a framework island), and the caller wraps as before.\n *\n * Why not always wrap: the wrapper is a `<span>` between the author's parent and the author's\n * element. `.hero > h1`, `gsap.utils.toArray(\".hero > *\")` and `:first-child` all stop matching,\n * and an animation that targeted the heading targets nothing. With the attributes on the element\n * itself the page's DOM is exactly the one the author wrote.\n *\n * A scan, not a parser: it only has to find where the first element ends. Anything it is not\n * sure of answers null, which is the old behaviour.\n */\nexport function stampSoleElement(html: string, attrs: Record<string, string | undefined>): string | null {\n  const start = html.search(/\\S/);\n  const open = /^<([a-zA-Z][\\w:-]*)/.exec(html.slice(start));\n  if (start < 0 || !open) return null;\n  const tag = open[1]!.toLowerCase();\n  const openEnd = tagEnd(html, start);\n  // A custom element is a framework's own wrapper (`astro-island`): not the author's element.\n  if (openEnd < 0 || tag.includes(\"-\") || /\\sdata-bcms-(?:layout-)?field[\\s=>/]/.test(html.slice(start, openEnd + 1))) return null;\n  let i = openEnd + 1;\n  if (!VOID_TAGS.has(tag) && html[openEnd - 1] !== \"/\") {\n    let depth = 1;\n    let raw = RAW_TEXT_TAGS.has(tag) ? tag : \"\";\n    while (depth > 0) {\n      const lt = html.indexOf(\"<\", i);\n      if (lt < 0) return null;\n      if (raw) {\n        const close = html.toLowerCase().indexOf(`</${raw}`, i);\n        if (close < 0) return null;\n        i = tagEnd(html, close) + 1;\n        if (i === 0) return null;\n        raw = \"\";\n        depth--;\n        continue;\n      }\n      if (html.startsWith(\"<!--\", lt)) {\n        const end = html.indexOf(\"-->\", lt + 4);\n        if (end < 0) return null;\n        i = end + 3;\n        continue;\n      }\n      const end = tagEnd(html, lt);\n      if (end < 0) return null;\n      const name = /^<\\/?([a-zA-Z][\\w:-]*)/.exec(html.slice(lt, end + 1))?.[1]?.toLowerCase();\n      if (name && html[lt + 1] === \"/\") depth--;\n      else if (name && !VOID_TAGS.has(name) && html[end - 1] !== \"/\") {\n        depth++;\n        if (RAW_TEXT_TAGS.has(name)) raw = name;\n      }\n      i = end + 1;\n    }\n  }\n  if (html.slice(i).trim() !== \"\") return null;\n  const escape = (value: string) => value.replace(/&/g, \"&amp;\").replace(/\"/g, \"&quot;\");\n  const added = Object.entries(attrs)\n    .filter((entry): entry is [string, string] => entry[1] !== undefined)\n    .map(([name, value]) => ` ${name}=\"${escape(value)}\"`)\n    .join(\"\");\n  // Last on the tag, where React's `cloneElement` puts them: the two lanes emit the same bytes.\n  const selfClosed = html[openEnd - 1] === \"/\";\n  const at = selfClosed ? openEnd - 1 : openEnd;\n  return html.slice(0, at).replace(/\\s+$/, \"\") + added + (selfClosed ? \" \" : \"\") + html.slice(at);\n}\n"],"mappings":"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","names":["end"]}
+{"version":3,"sources":["../src/bindings.ts"],"sourcesContent":["/**\n * Visual Editor addresses for the Astro renderer.\n *\n * Identical contract to `@bettercms-ai/next`'s `bindings.ts`, and the SAME reason for existing:\n * inside a component instance the definition's block ids address nothing, because they are\n * shared by every instance of it. Stamping them produces an orphan on one placement and a\n * duplicate that drops BOTH on two.\n *\n * Kept as a `.ts` module rather than inlined in the `.astro` frontmatter so the logic is\n * testable without an Astro compiler, and so the two SDKs cannot drift from each other by\n * having one file edited and not the other.\n */\nimport type { BindingKind } from \"@bettercms-ai/types\";\nimport { formatPropsAttribute } from \"@bettercms-ai/types\";\n\nexport interface BindingCtx {\n  /** Present only inside a component instance, where it is AUTHORITATIVE. */\n  fieldAddresses?: Map<string, string>;\n}\n\n/** The address a write lands on, or null when none exists. */\nexport function addressFor(id: string | undefined, prop: string, ctx: BindingCtx): string | null {\n  if (!id) return null;\n  const key = `${id}__${prop}`;\n  if (ctx.fieldAddresses) return ctx.fieldAddresses.get(key) ?? null;\n  return key;\n}\n\n/**\n * Attributes for a value rendered as this element's own content. Astro omits `undefined`\n * attributes, so an empty object spreads to nothing.\n */\nexport function bind(\n  id: string | undefined,\n  prop: string,\n  kind: BindingKind,\n  ctx: BindingCtx,\n): Record<string, string> {\n  const address = addressFor(id, prop, ctx);\n  return address ? { \"data-bcms-field\": address, \"data-bcms-kind\": kind } : {};\n}\n\n/**\n * Attributes for values that live in an ATTRIBUTE of this element. `data-bcms-field` addresses\n * one element and an element cannot hold two, so these ride `data-bcms-props`:\n * `<address>|<kind>|<domAttribute>`, semicolon separated.\n *\n * An entry whose value is absent is dropped — `setFieldPath` refuses to create a final key, so\n * the address would be a write the editor rejects.\n */\nexport function bindProps(\n  id: string | undefined,\n  entries: readonly { prop: string; kind: BindingKind; attr: string; present: boolean }[],\n  ctx: BindingCtx,\n): Record<string, string> {\n  const resolved = entries.flatMap(({ prop, kind, attr, present }) => {\n    if (!present) return [];\n    const address = addressFor(id, prop, ctx);\n    return address ? [{ address, kind, attr }] : [];\n  });\n  return resolved.length ? { \"data-bcms-props\": formatPropsAttribute(resolved) } : {};\n}\n\nconst VOID_TAGS = new Set([\"area\", \"base\", \"br\", \"col\", \"embed\", \"hr\", \"img\", \"input\", \"link\", \"meta\", \"source\", \"track\", \"wbr\"]);\nconst RAW_TEXT_TAGS = new Set([\"script\", \"style\", \"textarea\", \"title\"]);\n\n/** Where the tag opened at `from` (`<`) ends, quotes respected; -1 when it never does. */\nexport function tagEnd(html: string, from: number): number {\n  let quote = \"\";\n  for (let i = from; i < html.length; i++) {\n    const c = html[i]!;\n    if (quote) {\n      if (c === quote) quote = \"\";\n    } else if (c === '\"' || c === \"'\") quote = c;\n    else if (c === \">\") return i;\n  }\n  return -1;\n}\n\n/**\n * `<BcmsField>`'s child, when it is ONE element: the same markup with the binding attributes on\n * that element's own tag. Null when the rendered slot is anything else (text, several elements,\n * an element that already declares a field, a framework island), and the caller wraps as before.\n *\n * Why not always wrap: the wrapper is a `<span>` between the author's parent and the author's\n * element. `.hero > h1`, `gsap.utils.toArray(\".hero > *\")` and `:first-child` all stop matching,\n * and an animation that targeted the heading targets nothing. With the attributes on the element\n * itself the page's DOM is exactly the one the author wrote.\n *\n * A scan, not a parser: it only has to find where the first element ends. Anything it is not\n * sure of answers null, which is the old behaviour.\n */\nexport function stampSoleElement(html: string, attrs: Record<string, string | undefined>): string | null {\n  const start = html.search(/\\S/);\n  const open = /^<([a-zA-Z][\\w:-]*)/.exec(html.slice(start));\n  if (start < 0 || !open) return null;\n  const tag = open[1]!.toLowerCase();\n  const openEnd = tagEnd(html, start);\n  // A custom element is a framework's own wrapper (`astro-island`): not the author's element.\n  if (openEnd < 0 || tag.includes(\"-\") || /\\sdata-bcms-(?:layout-)?field[\\s=>/]/.test(html.slice(start, openEnd + 1))) return null;\n  let i = openEnd + 1;\n  if (!VOID_TAGS.has(tag) && html[openEnd - 1] !== \"/\") {\n    let depth = 1;\n    let raw = RAW_TEXT_TAGS.has(tag) ? tag : \"\";\n    while (depth > 0) {\n      const lt = html.indexOf(\"<\", i);\n      if (lt < 0) return null;\n      if (raw) {\n        const close = html.toLowerCase().indexOf(`</${raw}`, i);\n        if (close < 0) return null;\n        i = tagEnd(html, close) + 1;\n        if (i === 0) return null;\n        raw = \"\";\n        depth--;\n        continue;\n      }\n      if (html.startsWith(\"<!--\", lt)) {\n        const end = html.indexOf(\"-->\", lt + 4);\n        if (end < 0) return null;\n        i = end + 3;\n        continue;\n      }\n      const end = tagEnd(html, lt);\n      if (end < 0) return null;\n      const name = /^<\\/?([a-zA-Z][\\w:-]*)/.exec(html.slice(lt, end + 1))?.[1]?.toLowerCase();\n      if (name && html[lt + 1] === \"/\") depth--;\n      else if (name && !VOID_TAGS.has(name) && html[end - 1] !== \"/\") {\n        depth++;\n        if (RAW_TEXT_TAGS.has(name)) raw = name;\n      }\n      i = end + 1;\n    }\n  }\n  if (html.slice(i).trim() !== \"\") return null;\n  const escape = (value: string) => value.replace(/&/g, \"&amp;\").replace(/\"/g, \"&quot;\");\n  const added = Object.entries(attrs)\n    .filter((entry): entry is [string, string] => entry[1] !== undefined)\n    .map(([name, value]) => ` ${name}=\"${escape(value)}\"`)\n    .join(\"\");\n  // Last on the tag, where React's `cloneElement` puts them: the two lanes emit the same bytes.\n  const selfClosed = html[openEnd - 1] === \"/\";\n  const at = selfClosed ? openEnd - 1 : openEnd;\n  return html.slice(0, at).replace(/\\s+$/, \"\") + added + (selfClosed ? \" \" : \"\") + html.slice(at);\n}\n"],"mappings":"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","names":["end"]}

package/dist/config-CU7bp5dd.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The platform's canonical media host, matching `@bettercms-ai/image-url`'s own
+ * `DEFAULT_BASE_URL` and the `CDN_URL` the backend mints asset URLs on.
+ *
+ * This used to be `media.bettercms.ai`. Both hostnames route to the backend — they are both in
+ * `$bcms_api_host` in infra/nginx/backend-lb.conf — so nothing was broken, but a site built by
+ * this integration disagreed with the URL the server itself hands out for the same asset. That
+ * splits the CDN cache for identical bytes and makes an asset URL's origin depend on which code
+ * path produced it, which is the exact drift image-url was moved off this host to end.
+ *
+ * A project that serves media from the API origin instead (`useCdn: false`) overrides this with
+ * `PUBLIC_BCMS_MEDIA_URL` or the `mediaUrl` option.
+ */
+declare const DEFAULT_MEDIA_URL = "https://cdn.bettercms.ai";
+declare const DRAFT_COOKIE = "bcms-draft";
+/** The specifier the components import, and the integration's plugin answers. */
+declare const PUBLIC_CONFIG_ID = "@bettercms-ai/astro/public-config";
+/**
+ * The config with no integration: `PUBLIC_BCMS_*`, then the snapshot. Never throws: with neither,
+ * `apiUrl` and `workspace` are empty, which a build that never talks to the API renders with.
+ */
+declare function fallbackConfig(): PublicConfig;
+declare const config: PublicConfig;
+
+/**
+ * Resolved configuration shared by the integration, runtime, middleware and
+ * draft routes. Public values are safe to ship to the browser; the API key and
+ * draft secret are read from server env at runtime and never live here.
+ *
+ * Resolution order is options → `PUBLIC_BCMS_*` env → the build snapshot. Config-time
+ * only: this module is reached exclusively through `dist/index.js`, which only an
+ * `astro.config.*` imports, so the `node:fs` read below never enters a client bundle.
+ * Browser code gets the `bettercms:config` virtual module instead.
+ */
+
+interface BetterCMSAstroOptions {
+    /** Backend base, e.g. `https://api.bettercms.ai`. Falls back to `PUBLIC_BCMS_API_URL`. */
+    apiUrl?: string;
+    /** Workspace slug. Falls back to `PUBLIC_BCMS_WORKSPACE`. */
+    workspace?: string;
+    /** Optional project scope for forms. Falls back to `PUBLIC_BCMS_PROJECT_ID`. */
+    projectId?: string;
+    /** Media host for the image-url builder. Defaults to the prod media host. */
+    mediaUrl?: string;
+    /** Dashboard base for visual-editing deep links. */
+    studioUrl?: string;
+    /** Enable the draft-mode middleware + injected draft routes. Default true. */
+    draft?: boolean;
+}
+/** Browser-safe config — exposed via the `bettercms:config` virtual module. */
+interface PublicConfig {
+    apiUrl: string;
+    workspace: string;
+    projectId?: string;
+    mediaUrl: string;
+    studioUrl?: string;
+    draftCookie: string;
+}
+interface ResolvedConfig extends PublicConfig {
+    draft: boolean;
+}
+/**
+ * Merge integration options with `PUBLIC_BCMS_*` env and the build snapshot, validating the
+ * essentials. Precedence: explicit options → env → snapshot.
+ */
+declare function resolveConfig(options: BetterCMSAstroOptions, env?: Record<string, string | undefined>, cwd?: string): ResolvedConfig;
+
+export { type BetterCMSAstroOptions as B, DRAFT_COOKIE as D, type PublicConfig as P, type ResolvedConfig as R, DEFAULT_MEDIA_URL as a, PUBLIC_CONFIG_ID as b, config as c, fallbackConfig as f, resolveConfig as r };

package/dist/index.d.ts

@@ -1,53 +1,13 @@
 import { AstroIntegration } from 'astro';
+import { B as BetterCMSAstroOptions } from './config-CU7bp5dd.js';
+export { D as DRAFT_COOKIE, P as PublicConfig, R as ResolvedConfig, r as resolveConfig } from './config-CU7bp5dd.js';
 export { BcmsLocals, BetterCMSRuntime, RuntimeConfig, liveSrc } from './runtime.js';
-import { BlockStyle, FieldStyles, FieldStyle } from '@bettercms-ai/types';
+import { FieldStyles, FieldStyle } from '@bettercms-ai/types';
 export { ContentBlock, DeliveredLayout, DeliveryEntry, DeliveryList, DeliveryPage, LinkValue, PageMetaJson, Perspective, RESPONSIVE_CSS, SiteSeoDefaults, linkHref } from '@bettercms-ai/types';
+export { S as SectionColumnAttrs, a as SectionRootAttrs, b as SectionRootBlock, s as sectionColumnAttrs, c as sectionRootAttrs } from './section-root-JrXFxiBm.js';
 export { ImageCrop, ImageFit, ImageFocal, ImageFormat, ImageSource, ImageUrlBuilder, ImageValueUrlOptions, imageUrl, default as imageUrlBuilder, imageValueObjectPosition, imageValueUrl } from '@bettercms-ai/image-url';
 export { DeliveryForm, DeliveryFormField, ResolvedSeo, SeoInput, resolveSeo } from '@bettercms-ai/sdk';
 
-/**
- * Resolved configuration shared by the integration, runtime, middleware and
- * draft routes. Public values are safe to ship to the browser; the API key and
- * draft secret are read from server env at runtime and never live here.
- *
- * Resolution order is options → `PUBLIC_BCMS_*` env → the build snapshot. Config-time
- * only: this module is reached exclusively through `dist/index.js`, which only an
- * `astro.config.*` imports, so the `node:fs` read below never enters a client bundle.
- * Browser code gets the `bettercms:config` virtual module instead.
- */
-declare const DRAFT_COOKIE = "bcms-draft";
-interface BetterCMSAstroOptions {
-    /** Backend base, e.g. `https://api.bettercms.ai`. Falls back to `PUBLIC_BCMS_API_URL`. */
-    apiUrl?: string;
-    /** Workspace slug. Falls back to `PUBLIC_BCMS_WORKSPACE`. */
-    workspace?: string;
-    /** Optional project scope for forms. Falls back to `PUBLIC_BCMS_PROJECT_ID`. */
-    projectId?: string;
-    /** Media host for the image-url builder. Defaults to the prod media host. */
-    mediaUrl?: string;
-    /** Dashboard base for visual-editing deep links. */
-    studioUrl?: string;
-    /** Enable the draft-mode middleware + injected draft routes. Default true. */
-    draft?: boolean;
-}
-/** Browser-safe config — exposed via the `bettercms:config` virtual module. */
-interface PublicConfig {
-    apiUrl: string;
-    workspace: string;
-    projectId?: string;
-    mediaUrl: string;
-    studioUrl?: string;
-    draftCookie: string;
-}
-interface ResolvedConfig extends PublicConfig {
-    draft: boolean;
-}
-/**
- * Merge integration options with `PUBLIC_BCMS_*` env and the build snapshot, validating the
- * essentials. Precedence: explicit options → env → snapshot.
- */
-declare function resolveConfig(options: BetterCMSAstroOptions, env?: Record<string, string | undefined>, cwd?: string): ResolvedConfig;
-
 /**
  * `bettercms()` — the Astro integration.
  *
@@ -59,56 +19,6 @@ declare function resolveConfig(options: BetterCMSAstroOptions, env?: Record<stri
 
 declare function bettercms(options?: BetterCMSAstroOptions): AstroIntegration;
 
-/**
- * C3/C4 — `sectionRootAttrs(block)`: the attributes a site's OWN section root spreads so the
- * BetterCMS editor offers that section's spacing and style handles.
- *
- *   <section class="hero" {...sectionRootAttrs(block)}>…</section>
- *
- * The editor shows those handles on a site-rendered page only when EVERY root the site stamps
- * with `data-bcms-block` also carries `data-bcms-style`, which is the site's promise that "this
- * root's inline style is `blockStyleToCss(block.style)`" — the same declarations `<BcmsBlocks>`
- * puts on its own wrapper. A root that stamps the block without applying its style would get a
- * capsule that paints the canvas and never ships, so the marker must travel with the style.
- *
- * The marker is present even when the style is EMPTY (then there is no `style` attribute at all):
- * an unstyled section is exactly the one an author is about to give its first spacing edit.
- */
-
-interface SectionRootBlock {
-    id?: string | null;
-    style?: BlockStyle | Record<string, unknown> | null;
-}
-interface SectionRootAttrs {
-    "data-bcms-block"?: string;
-    "data-bcms-style": "";
-    /** `"mobile tablet"` when `style.hideOn` hides it there; the site ships `RESPONSIVE_CSS` for it. */
-    "data-bcms-hide"?: string;
-    /** `blockStyleToCss(block.style)` as a CSS string; absent when the block has no style. */
-    style?: string;
-}
-declare function sectionRootAttrs(block: SectionRootBlock | null | undefined): SectionRootAttrs;
-interface SectionColumnAttrs {
-    "data-bcms-column": "";
-    /** `blockStyleToColumnCss(block.style)` as a CSS string; absent when the section has no column. */
-    style?: string;
-}
-/**
- * C3 — `sectionColumnAttrs(block)`: the attributes a site's own INNER container spreads so the
- * section's content WIDTH (`style.contentWidth`, placed by `contentAlign`) ships.
- *
- *   <section {...sectionRootAttrs(block)}>
- *     <div class="container" {...sectionColumnAttrs(block)}>…</div>
- *   </section>
- *
- * The width is the column BetterCMS draws as `.bcms-block-inner` inside the section's styled box —
- * never on the root itself, whose background must stay full-bleed. `data-bcms-column` is the
- * site's promise that this box's inline style is the column; the editor offers the width handle
- * on a site-rendered page only where every styled root holds one. Max-width plus left/right
- * margins, so the container keeps its own vertical margins and, with no column, its own width.
- */
-declare function sectionColumnAttrs(block: SectionRootBlock | null | undefined): SectionColumnAttrs;
-
 /**
  * C3 — `fieldAttrs(path, fieldStyles)`: the attributes a site's OWN element spreads to bind a PAGE
  * FIELD and apply that field's stored style, so the BetterCMS editor offers its width and spacing
@@ -138,4 +48,4 @@ interface FieldAttrs {
 declare function fieldStyleOf(path: string, fieldStyles: FieldStyles | Record<string, unknown> | null | undefined): FieldStyle | undefined;
 declare function fieldAttrs(path: string, fieldStyles?: FieldStyles | Record<string, unknown> | null): FieldAttrs;
 
-export { type BetterCMSAstroOptions, DRAFT_COOKIE, type FieldAttrs, type PublicConfig, type ResolvedConfig, type SectionColumnAttrs, type SectionRootAttrs, type SectionRootBlock, bettercms, bettercms as default, fieldAttrs, fieldStyleOf, resolveConfig, sectionColumnAttrs, sectionRootAttrs };
+export { BetterCMSAstroOptions, type FieldAttrs, bettercms, bettercms as default, fieldAttrs, fieldStyleOf };

package/dist/index.js

@@ -1,9 +1,42 @@
 // src/config.ts
 import { readFileSync } from "fs";
 import { resolve } from "path";
+
+// src/public-config.ts
+import { readPublishedContent } from "@bettercms-ai/sdk";
 var DEFAULT_MEDIA_URL = "https://cdn.bettercms.ai";
-var SNAPSHOT_FILE = "bcms-content.json";
 var DRAFT_COOKIE = "bcms-draft";
+var PUBLIC_CONFIG_ID = "@bettercms-ai/astro/public-config";
+function env(name) {
+  const fromProcess = typeof process !== "undefined" ? process.env?.[name] : void 0;
+  if (fromProcess) return fromProcess;
+  try {
+    return import.meta.env?.[name] || void 0;
+  } catch {
+    return void 0;
+  }
+}
+var trim = (url) => url.replace(/\/+$/, "");
+var text = (value) => typeof value === "string" && value ? value : void 0;
+function fallbackConfig() {
+  const snapshot2 = readPublishedContent() ?? {};
+  return {
+    apiUrl: trim(env("PUBLIC_BCMS_API_URL") ?? text(snapshot2.apiUrl) ?? ""),
+    workspace: env("PUBLIC_BCMS_WORKSPACE") ?? text(snapshot2.workspace) ?? "",
+    projectId: env("PUBLIC_BCMS_PROJECT_ID") ?? text(snapshot2.projectId),
+    mediaUrl: trim(env("PUBLIC_BCMS_MEDIA_URL") ?? DEFAULT_MEDIA_URL),
+    studioUrl: env("PUBLIC_BCMS_STUDIO_URL"),
+    draftCookie: DRAFT_COOKIE
+  };
+}
+var KEYS = ["apiUrl", "workspace", "projectId", "mediaUrl", "studioUrl", "draftCookie"];
+var config = Object.defineProperties(
+  {},
+  Object.fromEntries(KEYS.map((key) => [key, { enumerable: true, get: () => fallbackConfig()[key] }]))
+);
+
+// src/config.ts
+var SNAPSHOT_FILE = "bcms-content.json";
 var snapshotCache;
 function snapshot(cwd) {
   if (snapshotCache === void 0) {
@@ -19,10 +52,10 @@ var required = (name, envVar, extra) => new Error(
   `[@bettercms-ai/astro] \`${name}\` is required. Pass \`bettercms({ ${name} })\`, set ${envVar}, or ${extra}
 On BetterCMS hosting these are injected automatically \u2014 if this failed in a hosted build, the repository is running an outdated deploy workflow: publish once, or save Hosting settings, to refresh it.`
 );
-function resolveConfig(options, env = process.env, cwd = process.cwd()) {
+function resolveConfig(options, env2 = process.env, cwd = process.cwd()) {
   const snap = () => snapshot(cwd);
-  const apiUrl = (options.apiUrl ?? env.PUBLIC_BCMS_API_URL ?? snap().apiUrl ?? "").replace(/\/+$/, "");
-  const workspace = options.workspace ?? env.PUBLIC_BCMS_WORKSPACE ?? snap().workspace ?? "";
+  const apiUrl = (options.apiUrl ?? env2.PUBLIC_BCMS_API_URL ?? snap().apiUrl ?? "").replace(/\/+$/, "");
+  const workspace = options.workspace ?? env2.PUBLIC_BCMS_WORKSPACE ?? snap().workspace ?? "";
   if (!apiUrl) throw required("apiUrl", "PUBLIC_BCMS_API_URL", `run the content fetch so ${SNAPSHOT_FILE} is present.`);
   if (!workspace) {
     throw required("workspace", "PUBLIC_BCMS_WORKSPACE", `run the content fetch so ${SNAPSHOT_FILE} is present.`);
@@ -30,9 +63,9 @@ function resolveConfig(options, env = process.env, cwd = process.cwd()) {
   return {
     apiUrl,
     workspace,
-    projectId: options.projectId ?? env.PUBLIC_BCMS_PROJECT_ID ?? snap().projectId,
-    mediaUrl: (options.mediaUrl ?? env.PUBLIC_BCMS_MEDIA_URL ?? DEFAULT_MEDIA_URL).replace(/\/+$/, ""),
-    studioUrl: options.studioUrl ?? env.PUBLIC_BCMS_STUDIO_URL,
+    projectId: options.projectId ?? env2.PUBLIC_BCMS_PROJECT_ID ?? snap().projectId,
+    mediaUrl: (options.mediaUrl ?? env2.PUBLIC_BCMS_MEDIA_URL ?? DEFAULT_MEDIA_URL).replace(/\/+$/, ""),
+    studioUrl: options.studioUrl ?? env2.PUBLIC_BCMS_STUDIO_URL,
     draftCookie: DRAFT_COOKIE,
     draft: options.draft ?? true
   };
@@ -75,8 +108,12 @@ function clientModule(cfg, buildCache) {
 function virtualPlugin(cfg, buildCache) {
   return {
     name: "@bettercms-ai/astro:virtual",
+    // Before Vite's own resolver: `PUBLIC_CONFIG_ID` names a real file of this package, and a
+    // plugin that runs after the resolver is never asked about a specifier it already resolved.
+    enforce: "pre",
     resolveId(id) {
       if (id === CLIENT_ID || id === CONFIG_ID) return RESOLVED(id);
+      if (id === PUBLIC_CONFIG_ID) return RESOLVED(CONFIG_ID);
       return null;
     },
     load(id) {
@@ -135,13 +172,13 @@ function bettercms(options = {}) {
        * prerenders everything — on-demand rendering required `"server"` or `"hybrid"`, both
        * of which fail this check. The adapter test stays as a second line of defence.
        */
-      "astro:config:done": ({ config, logger, ...rest }) => {
+      "astro:config:done": ({ config: config2, logger, ...rest }) => {
         const buildOutput = rest.buildOutput;
-        const staticOutput = buildOutput !== void 0 ? buildOutput === "static" : config.output === "static" && !config.adapter;
+        const staticOutput = buildOutput !== void 0 ? buildOutput === "static" : config2.output === "static" && !config2.adapter;
         buildCache.on = buildCache.command === "build" && staticOutput;
         decide = () => {
           const late = rest.buildOutput;
-          const stillStatic = late !== void 0 ? late === "static" : config.output === "static" && !config.adapter;
+          const stillStatic = late !== void 0 ? late === "static" : config2.output === "static" && !config2.adapter;
           buildCache.on = buildCache.command === "build" && stillStatic;
           buildCache.resolved = true;
           if (buildCache.on) {
@@ -171,7 +208,7 @@ var integration_default = bettercms;
 
 // src/runtime.ts
 import { createClient } from "@bettercms-ai/sdk";
-import { readPublishedContent, publishedEntry } from "@bettercms-ai/sdk";
+import { readPublishedContent as readPublishedContent2, publishedEntry } from "@bettercms-ai/sdk";
 function liveSrc(opts) {
   const base = opts.apiUrl.replace(/\/+$/, "");
   const q = new URLSearchParams({ key: opts.apiKey });