@bettercms-ai/astro 0.9.1 → 0.9.2

package/components/BcmsBlocks.astro

@@ -27,9 +27,12 @@
  */
 import type { ContentBlock } from "@bettercms-ai/types";
 import { blockStyleToCss, componentInstanceAddresses } from "@bettercms-ai/types";
-import { bind, bindProps } from "../src/bindings.js";
+import { bind, bindProps } from "../dist/bindings.js";
 import type { DeliveryComponent, DeliveryForm } from "@bettercms-ai/sdk";
 import { applyOverrides } from "@bettercms-ai/ui/resolve";
+import { addressFor } from "../dist/bindings.js";
+import { portableTextToHtml } from "@bettercms-ai/richtext/html";
+import { readStructuredContent } from "@bettercms-ai/richtext";
 import BcmsImage from "./BcmsImage.astro";
 import BcmsForm from "./BcmsForm.astro";
 
@@ -206,8 +209,29 @@ const pass = { forms, components, turnstileSiteKey, nested: true, fieldAddresses
       // `richtext` and `text` carry the same payload and differ only in the authoring
       // surface, so delivery renders them identically — the hosted renderer does the same.
       case "text":
-      case "richtext":
+      case "richtext": {
+        /**
+         * STRUCTURED CONTENT WINS. This lane read `p.html` unconditionally while the hosted
+         * renderer preferred `p.content`, so a block whose structured value had moved past its
+         * derived cache rendered the stale cache on Astro sites only — the same per-lane
+         * divergence that once made `richtext` render nothing here at all.
+         *
+         * Serialised to a STRING rather than mounting React. `@portabletext/react` would drag
+         * `@astrojs/react` into every customer project, which is a breaking install-time change
+         * for a rendering result that is identical. `set:html` is already what this line did;
+         * the difference is that the string is now generated by our own escaping serialiser
+         * instead of coming out of storage, which REDUCES the trust surface.
+         *
+         * The per-block `#<_key>` addresses are stamped by the serialiser, so one paragraph
+         * inside the field is clickable rather than the field being one opaque string.
+         */
+        const structured = readStructuredContent(p);
+        if (structured) {
+          const base = addressFor(block.id, "html", bctx);
+          return <div class="bcms-text" {...blockAttrs} set:html={portableTextToHtml(structured, base ? { bindingBase: base } : {})} />;
+        }
         return <div class="bcms-text" {...bind(block.id, "html", "richtext", bctx)} {...blockAttrs} set:html={p.html ?? ""} />;
+      }
       case "image": {
         // Matches the Next adapter: the image block is click-to-select on the Visual Editor
         // canvas like heading/text/button, rather than dock-only. `kind="image"` means select

package/dist/bindings.d.ts

@@ -0,0 +1,42 @@
+import { BindingKind } from '@bettercms-ai/types';
+
+/**
+ * Visual Editor addresses for the Astro renderer.
+ *
+ * Identical contract to `@bettercms-ai/next`'s `bindings.ts`, and the SAME reason for existing:
+ * inside a component instance the definition's block ids address nothing, because they are
+ * shared by every instance of it. Stamping them produces an orphan on one placement and a
+ * duplicate that drops BOTH on two.
+ *
+ * Kept as a `.ts` module rather than inlined in the `.astro` frontmatter so the logic is
+ * testable without an Astro compiler, and so the two SDKs cannot drift from each other by
+ * having one file edited and not the other.
+ */
+
+interface BindingCtx {
+    /** Present only inside a component instance, where it is AUTHORITATIVE. */
+    fieldAddresses?: Map<string, string>;
+}
+/** The address a write lands on, or null when none exists. */
+declare function addressFor(id: string | undefined, prop: string, ctx: BindingCtx): string | null;
+/**
+ * Attributes for a value rendered as this element's own content. Astro omits `undefined`
+ * attributes, so an empty object spreads to nothing.
+ */
+declare function bind(id: string | undefined, prop: string, kind: BindingKind, ctx: BindingCtx): Record<string, string>;
+/**
+ * Attributes for values that live in an ATTRIBUTE of this element. `data-bcms-field` addresses
+ * one element and an element cannot hold two, so these ride `data-bcms-props`:
+ * `<address>|<kind>|<domAttribute>`, semicolon separated.
+ *
+ * An entry whose value is absent is dropped — `setFieldPath` refuses to create a final key, so
+ * the address would be a write the editor rejects.
+ */
+declare function bindProps(id: string | undefined, entries: readonly {
+    prop: string;
+    kind: BindingKind;
+    attr: string;
+    present: boolean;
+}[], ctx: BindingCtx): Record<string, string>;
+
+export { type BindingCtx, addressFor, bind, bindProps };

package/dist/bindings.js

@@ -0,0 +1,26 @@
+// src/bindings.ts
+import { formatPropsAttribute } from "@bettercms-ai/types";
+function addressFor(id, prop, ctx) {
+  if (!id) return null;
+  const key = `${id}__${prop}`;
+  if (ctx.fieldAddresses) return ctx.fieldAddresses.get(key) ?? null;
+  return key;
+}
+function bind(id, prop, kind, ctx) {
+  const address = addressFor(id, prop, ctx);
+  return address ? { "data-bcms-field": address, "data-bcms-kind": kind } : {};
+}
+function bindProps(id, entries, ctx) {
+  const resolved = entries.flatMap(({ prop, kind, attr, present }) => {
+    if (!present) return [];
+    const address = addressFor(id, prop, ctx);
+    return address ? [{ address, kind, attr }] : [];
+  });
+  return resolved.length ? { "data-bcms-props": formatPropsAttribute(resolved) } : {};
+}
+export {
+  addressFor,
+  bind,
+  bindProps
+};
+//# sourceMappingURL=bindings.js.map

package/dist/bindings.js.map

@@ -0,0 +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"],"mappings":";AAaA,SAAS,4BAA4B;AAQ9B,SAAS,WAAW,IAAwB,MAAc,KAAgC;AAC/F,MAAI,CAAC,GAAI,QAAO;AAChB,QAAM,MAAM,GAAG,EAAE,KAAK,IAAI;AAC1B,MAAI,IAAI,eAAgB,QAAO,IAAI,eAAe,IAAI,GAAG,KAAK;AAC9D,SAAO;AACT;AAMO,SAAS,KACd,IACA,MACA,MACA,KACwB;AACxB,QAAM,UAAU,WAAW,IAAI,MAAM,GAAG;AACxC,SAAO,UAAU,EAAE,mBAAmB,SAAS,kBAAkB,KAAK,IAAI,CAAC;AAC7E;AAUO,SAAS,UACd,IACA,SACA,KACwB;AACxB,QAAM,WAAW,QAAQ,QAAQ,CAAC,EAAE,MAAM,MAAM,MAAM,QAAQ,MAAM;AAClE,QAAI,CAAC,QAAS,QAAO,CAAC;AACtB,UAAM,UAAU,WAAW,IAAI,MAAM,GAAG;AACxC,WAAO,UAAU,CAAC,EAAE,SAAS,MAAM,KAAK,CAAC,IAAI,CAAC;AAAA,EAChD,CAAC;AACD,SAAO,SAAS,SAAS,EAAE,mBAAmB,qBAAqB,QAAQ,EAAE,IAAI,CAAC;AACpF;","names":[]}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@bettercms-ai/astro",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "type": "module",
-  "description": "The BetterCMS adapter for Astro — a `bettercms()` integration, a `bettercms:client` virtual module, typed content loaders, draft preview, and native .astro rendering components.",
+  "description": "The BetterCMS adapter for Astro \u2014 a `bettercms()` integration, a `bettercms:client` virtual module, typed content loaders, draft preview, and native .astro rendering components.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,6 +18,11 @@
       "import": "./dist/runtime.js",
       "default": "./dist/runtime.js"
     },
+    "./bindings": {
+      "types": "./dist/bindings.d.ts",
+      "import": "./dist/bindings.js",
+      "default": "./dist/bindings.js"
+    },
     "./middleware": {
       "types": "./dist/middleware-entry.d.ts",
       "import": "./dist/middleware-entry.js",
@@ -50,7 +55,8 @@
     "@bettercms-ai/image-url": "^0.3.0",
     "@bettercms-ai/sdk": "^1.13.1",
     "@bettercms-ai/types": "^1.11.0",
-    "@bettercms-ai/ui": "^0.6.0"
+    "@bettercms-ai/ui": "^0.6.0",
+    "@bettercms-ai/richtext": "^0.1.0"
   },
   "peerDependencies": {
     "astro": ">=4"