@growth-labs/cms 0.5.21 → 0.5.23

package/dist/ui/editor/LayoutBuilder.d.ts

@@ -0,0 +1,12 @@
+import '@puckeditor/core/no-external.css';
+import { type LayoutData } from '../../puck/index.js';
+import { type RteProps } from './Rte.js';
+export interface LayoutBuilderProps {
+    /** Stored layout envelope JSON at mount time; null starts a blank canvas. */
+    layoutJson: string | null;
+    /** Fires on every canvas edit with the raw Puck data. */
+    onDataChange: (data: LayoutData) => void;
+    onImageUpload?: RteProps['onImageUpload'];
+}
+export declare function LayoutBuilder({ layoutJson, onDataChange, onImageUpload }: LayoutBuilderProps): import("react").JSX.Element;
+//# sourceMappingURL=LayoutBuilder.d.ts.map

package/dist/ui/editor/LayoutBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutBuilder.d.ts","sourceRoot":"","sources":["../../../src/ui/editor/LayoutBuilder.tsx"],"names":[],"mappings":"AAYA,OAAO,kCAAkC,CAAA;AAGzC,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAKvE,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAgD7C,MAAM,WAAW,kBAAkB;IAClC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,yDAAyD;IACzD,YAAY,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAA;IACxC,aAAa,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAA;CACzC;AAED,wBAAgB,aAAa,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,kBAAkB,+BAuB5F"}

package/dist/ui/editor/LayoutBuilder.js

@@ -0,0 +1,66 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// src/ui/editor/LayoutBuilder.tsx
+// Builder mode for page documents: mounts the Puck editor over the shared
+// component config (src/puck/config.tsx). Browser-only by nature — this
+// module imports the full @puckeditor/core editor and TipTap HTML generation,
+// and it ships in the admin client bundle only.
+//
+// <Puck data> is initial-only: the parent renders this component conditionally
+// (or keyed per doc), so every mount re-reads the stored envelope. Canvas
+// changes flow up through onDataChange as plain LayoutData; the parent owns
+// wrapping, projection, and autosave (layout-mode.ts).
+import { Puck } from '@puckeditor/core';
+import '@puckeditor/core/no-external.css';
+import { generateHTML } from '@tiptap/core';
+import { useMemo, useState } from 'react';
+import { createPuckConfig } from '../../puck/index.js';
+import { parsePortableTextEnvelope } from '../../schema/portable-text.js';
+import { createRteExtensions } from './extensions.js';
+import { initialLayoutData, richTextMarkdownFromEnvelope } from './layout-mode.js';
+import { portableTextToDoc } from './portable-text.js';
+import { Rte } from './Rte.js';
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+// Canvas preview for RichText blocks: the same TipTap schema the Rte uses,
+// so the preview matches what the field editor shows. Falls back to escaped
+// text if HTML generation fails; empty envelopes show a placeholder hint.
+function canvasRichTextHtml(envelopeJson) {
+    const parsed = parsePortableTextEnvelope(envelopeJson);
+    if (!parsed) {
+        return '<p class="gl-builder-richtext-empty">Empty rich text — select the block to write.</p>';
+    }
+    try {
+        return generateHTML(portableTextToDoc(parsed.content), createRteExtensions());
+    }
+    catch {
+        return `<p>${escapeHtml(richTextMarkdownFromEnvelope(envelopeJson))}</p>`;
+    }
+}
+function makeRichTextField(onImageUpload) {
+    return {
+        type: 'custom',
+        label: 'Rich text',
+        render: ({ value, onChange }) => {
+            const stored = typeof value === 'string' ? value : '';
+            return (_jsx("div", { className: "gl-builder-richtext-field", children: _jsx(Rte, { value: richTextMarkdownFromEnvelope(stored), portableText: stored || null, onChange: (_md, portableText) => onChange(portableText), onImageUpload: onImageUpload }) }));
+        },
+    };
+}
+const EMPTY_DATA = { root: { props: {} }, content: [] };
+export function LayoutBuilder({ layoutJson, onDataChange, onImageUpload }) {
+    const config = useMemo(() => createPuckConfig({
+        renderRichTextHtml: canvasRichTextHtml,
+        richTextField: makeRichTextField(onImageUpload),
+    }), [onImageUpload]);
+    // Initial-only by contract — a lazy state initializer reads the prop once
+    // at mount (Puck ignores later data props; a remount re-reads the envelope).
+    const [initialData] = useState(() => initialLayoutData(layoutJson) ?? EMPTY_DATA);
+    return (_jsx("div", { className: "gl-layout-builder", style: { border: '1px solid var(--line)', borderRadius: 8 }, children: _jsx(Puck, { config: config, data: initialData, onChange: (data) => onDataChange(data), iframe: { enabled: false }, height: "72vh" }) }));
+}
+//# sourceMappingURL=LayoutBuilder.js.map

package/dist/ui/editor/LayoutBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LayoutBuilder.js","sourceRoot":"","sources":["../../../src/ui/editor/LayoutBuilder.tsx"],"names":[],"mappings":"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"}

package/dist/ui/editor/content-payload.d.ts

@@ -5,6 +5,8 @@ export interface ContentDraftFields {
     body: string;
     /** Serialized Portable Text envelope for the body; null until the editor emits one. */
     bodyPortableText?: string | null;
+    /** Serialized Puck layout envelope (pages only); null clears, undefined never sent. */
+    layoutJson?: string | null;
     videoUrl: string;
     videoSourceKind?: string | null;
     videoId?: string | null;

package/dist/ui/editor/content-payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-payload.d.ts","sourceRoot":"","sources":["../../../src/ui/editor/content-payload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG3E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,qBAAqB,CACpC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAkBT;AAED,wBAAgB,6BAA6B,CAC5C,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,GACvB,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAe9E;AAED,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6CzB;AAED,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}
+{"version":3,"file":"content-payload.d.ts","sourceRoot":"","sources":["../../../src/ui/editor/content-payload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAG3E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQlD;AAED,wBAAgB,qBAAqB,CACpC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,GACvB,OAAO,CAkBT;AAED,wBAAgB,6BAA6B,CAC5C,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,GACvB,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAe9E;AAED,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgDzB;AAED,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,kBAAkB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}

package/dist/ui/editor/content-payload.js

@@ -73,6 +73,9 @@ export function buildContentUpdatePayload(contentType, draft) {
             bodyPortableText: draft.bodyPortableText || null,
             wordCount,
             readTimeMinutes: estimateReadTime(wordCount),
+            // Pages always state their layout explicitly: a value writes it,
+            // null clears it (the engine preserves only when the key is absent).
+            ...(contentType === 'page' ? { layoutJson: draft.layoutJson ?? null } : {}),
         };
     }
     else if (contentType === 'video') {

package/dist/ui/editor/content-payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-payload.js","sourceRoot":"","sources":["../../../src/ui/editor/content-payload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"content-payload.js","sourceRoot":"","sources":["../../../src/ui/editor/content-payload.ts"],"names":[],"mappings":"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"}

package/dist/ui/editor/layout-mode.d.ts

@@ -0,0 +1,21 @@
+import { type LayoutData } from '../../puck/index.js';
+export interface LayoutDraft {
+    layoutJson: string;
+    body: string;
+    bodyPortableText: null;
+}
+/**
+ * Turn a Puck canvas change into the fields a builder save persists. The
+ * classic body stays populated with the derived-markdown projection (search,
+ * SEO, non-layout surfaces); an unprojectable layout keeps the previous body,
+ * then the title, so create/publish body requirements still hold.
+ */
+export declare function layoutDraftFromData(data: LayoutData, previousBody: string, title: string): LayoutDraft;
+/** Stored layout JSON → Puck canvas data; null for absent/malformed. */
+export declare function initialLayoutData(layoutJson: string | null): LayoutData | null;
+/**
+ * Portable Text envelope JSON (a RichText block's stored prop) → markdown,
+ * for seeding the embedded Rte. Empty string when the envelope is malformed.
+ */
+export declare function richTextMarkdownFromEnvelope(envelopeJson: string): string;
+//# sourceMappingURL=layout-mode.d.ts.map

package/dist/ui/editor/layout-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-mode.d.ts","sourceRoot":"","sources":["../../../src/ui/editor/layout-mode.ts"],"names":[],"mappings":"AAMA,OAAO,EACN,KAAK,UAAU,EAIf,MAAM,qBAAqB,CAAA;AAK5B,MAAM,WAAW,WAAW;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB,EAAE,IAAI,CAAA;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACX,WAAW,CAUb;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,GAAG,IAAI,CAE9E;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAIzE"}

package/dist/ui/editor/layout-mode.js

@@ -0,0 +1,41 @@
+// src/ui/editor/layout-mode.ts
+// Pure Builder-mode logic: canvas data → persisted draft triple, stored
+// envelope → canvas data, and the Portable Text ↔ markdown bridge for the
+// RichText custom field. No DOM, no Puck imports — the LayoutBuilder
+// component owns the browser-only pieces.
+import { layoutToMarkdown, parseLayoutEnvelope, wrapLayout, } from '../../puck/index.js';
+import { parsePortableTextEnvelope } from '../../schema/portable-text.js';
+import { portableTextToDoc } from './portable-text.js';
+import { docToMarkdown } from './serialize.js';
+/**
+ * Turn a Puck canvas change into the fields a builder save persists. The
+ * classic body stays populated with the derived-markdown projection (search,
+ * SEO, non-layout surfaces); an unprojectable layout keeps the previous body,
+ * then the title, so create/publish body requirements still hold.
+ */
+export function layoutDraftFromData(data, previousBody, title) {
+    const envelope = wrapLayout(data);
+    const projected = layoutToMarkdown(envelope).trim();
+    return {
+        layoutJson: JSON.stringify(envelope),
+        body: projected || previousBody.trim() || title.trim(),
+        // The derived body is markdown-only — stale Portable Text must not
+        // survive a builder save (same staleness rule the engine enforces).
+        bodyPortableText: null,
+    };
+}
+/** Stored layout JSON → Puck canvas data; null for absent/malformed. */
+export function initialLayoutData(layoutJson) {
+    return parseLayoutEnvelope(layoutJson)?.data ?? null;
+}
+/**
+ * Portable Text envelope JSON (a RichText block's stored prop) → markdown,
+ * for seeding the embedded Rte. Empty string when the envelope is malformed.
+ */
+export function richTextMarkdownFromEnvelope(envelopeJson) {
+    const parsed = parsePortableTextEnvelope(envelopeJson);
+    if (!parsed)
+        return '';
+    return docToMarkdown(portableTextToDoc(parsed.content)).trim();
+}
+//# sourceMappingURL=layout-mode.js.map

package/dist/ui/editor/layout-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-mode.js","sourceRoot":"","sources":["../../../src/ui/editor/layout-mode.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,wEAAwE;AACxE,0EAA0E;AAC1E,qEAAqE;AACrE,0CAA0C;AAE1C,OAAO,EAEN,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,GACV,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAQ9C;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAClC,IAAgB,EAChB,YAAoB,EACpB,KAAa;IAEb,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAA;IACnD,OAAO;QACN,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;QACpC,IAAI,EAAE,SAAS,IAAI,YAAY,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE;QACtD,mEAAmE;QACnE,oEAAoE;QACpE,gBAAgB,EAAE,IAAI;KACtB,CAAA;AACF,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,UAAyB;IAC1D,OAAO,mBAAmB,CAAC,UAAU,CAAC,EAAE,IAAI,IAAI,IAAI,CAAA;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,YAAoB;IAChE,MAAM,MAAM,GAAG,yBAAyB,CAAC,YAAY,CAAC,CAAA;IACtD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,OAAO,aAAa,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;AAC/D,CAAC"}

package/migrations/0025_page_layout_json.sql

@@ -0,0 +1,7 @@
+-- Puck page-layout envelope for builder-mode pages. Nullable JSON
+-- ({ version, data }) written alongside the classic body columns; NULL means
+-- "classic page — render via body_portable_text/markdown". The body columns
+-- are never dropped; builder pages derive body_markdown from their RichText
+-- blocks so text consumers keep working.
+ALTER TABLE article_content
+  ADD COLUMN layout_json TEXT;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growth-labs/cms",
-  "version": "0.5.21",
+  "version": "0.5.23",
   "type": "module",
   "bin": {
     "growth-labs-cms-migrations": "./dist/cli/migrations.js"
@@ -35,6 +35,10 @@
       "types": "./dist/migration-vendor.d.ts",
       "import": "./dist/migration-vendor.js"
     },
+    "./puck": {
+      "types": "./dist/puck/index.d.ts",
+      "import": "./dist/puck/index.js"
+    },
     "./ui": {
       "types": "./dist/ui/components/CmsApp.d.ts",
       "import": "./dist/ui/components/CmsApp.js"
@@ -54,10 +58,16 @@
     "README.md"
   ],
   "peerDependencies": {
+    "@puckeditor/core": "^0.23.0",
     "astro": "^6.1.10 || ^7.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "@puckeditor/core": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -78,6 +88,7 @@
     "zod": "^3.24.0"
   },
   "devDependencies": {
+    "@puckeditor/core": "0.23.0",
     "@types/node": "^25.5.0",
     "@types/react": "19.2.16",
     "@types/react-dom": "19.2.3",

package/src/engine/published-content.ts

@@ -122,7 +122,7 @@ FROM content_items ci
 // SQL. Every byte accounting downstream (page budget, per-item cap, the
 // changed-during-read integrity check) uses the STRIPPED length consistently,
 // so the contracts hold with no special cases.
-const BODYLESS_PAYLOAD_EXPR = `json_remove(cr.payload_json, '$.content.body_markdown', '$.content.body_html', '$.content.body_portable_text')`
+const BODYLESS_PAYLOAD_EXPR = `json_remove(cr.payload_json, '$.content.body_markdown', '$.content.body_html', '$.content.body_portable_text', '$.content.layout_json')`
 const SELECT_PUBLISHED_CONTENT_BODYLESS = `
 SELECT
   ci.id AS content_id,

package/src/engine/publisher.ts

@@ -44,7 +44,7 @@ export {
 type ContentVisibility = 'free' | 'premium'
 type BodyBackedContentType = 'article' | 'newsletter' | 'page'
 
-function isBodyBackedContentType(type: ContentType): type is BodyBackedContentType {
+export function isBodyBackedContentType(type: ContentType): type is BodyBackedContentType {
 	return type === 'article' || type === 'newsletter' || type === 'page'
 }
 
@@ -123,6 +123,8 @@ export interface ArticleInput extends BaseContentInput {
 		bodyHtml?: string | null
 		/** Serialized Portable Text envelope JSON (schema/portable-text.ts). */
 		bodyPortableText?: string | null
+		/** Serialized Puck layout envelope JSON (schema/layout.ts, pages only). */
+		layoutJson?: string | null
 		subtitle?: string | null
 		wordCount?: number | null
 		readTimeMinutes?: number | null
@@ -158,6 +160,8 @@ export interface NewsletterInput extends BaseContentInput {
 		bodyHtml?: string | null
 		/** Serialized Portable Text envelope JSON (schema/portable-text.ts). */
 		bodyPortableText?: string | null
+		/** Serialized Puck layout envelope JSON (schema/layout.ts, pages only). */
+		layoutJson?: string | null
 		subtitle?: string | null
 		wordCount?: number | null
 		readTimeMinutes?: number | null
@@ -172,6 +176,8 @@ export interface PageInput extends BaseContentInput {
 		bodyHtml?: string | null
 		/** Serialized Portable Text envelope JSON (schema/portable-text.ts). */
 		bodyPortableText?: string | null
+		/** Serialized Puck layout envelope JSON (schema/layout.ts, pages only). */
+		layoutJson?: string | null
 		subtitle?: string | null
 		wordCount?: number | null
 		readTimeMinutes?: number | null
@@ -666,14 +672,15 @@ export async function createContent(
 		const rt = input.content.readTimeMinutes ?? estimateReadTime(wc)
 		await db
 			.prepare(
-				`INSERT INTO article_content (content_id, body_markdown, body_html, body_portable_text, word_count, read_time_minutes, subtitle, editor_takeaways)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+				`INSERT INTO article_content (content_id, body_markdown, body_html, body_portable_text, layout_json, word_count, read_time_minutes, subtitle, editor_takeaways)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
 			)
 			.bind(
 				id,
 				input.content.bodyMarkdown,
 				input.content.bodyHtml || null,
 				input.content.bodyPortableText || null,
+				input.content.layoutJson || null,
 				wc || null,
 				rt || null,
 				input.content.subtitle || null,
@@ -982,7 +989,7 @@ export async function updateContentItem(
 			const current = await db
 				.prepare(
 					`
-          SELECT body_markdown, body_html, body_portable_text, word_count, read_time_minutes, subtitle, editor_takeaways
+          SELECT body_markdown, body_html, body_portable_text, layout_json, word_count, read_time_minutes, subtitle, editor_takeaways
           FROM article_content
           WHERE content_id = ?
           LIMIT 1
@@ -993,6 +1000,7 @@ export async function updateContentItem(
 					body_markdown: string
 					body_html: string | null
 					body_portable_text: string | null
+					layout_json: string | null
 					word_count: number | null
 					read_time_minutes: number | null
 					subtitle: string | null
@@ -1030,6 +1038,7 @@ export async function updateContentItem(
             body_markdown = ?,
             body_html = ?,
             body_portable_text = ?,
+            layout_json = ?,
             word_count = ?,
             read_time_minutes = ?,
             subtitle = ?,
@@ -1053,6 +1062,12 @@ export async function updateContentItem(
 						: bodyMarkdownProvided
 							? null
 							: current.body_portable_text,
+					// The layout is a separate representation from the body columns:
+					// classic body edits do NOT invalidate a page layout, so absent
+					// means "preserve" with no markdown coupling.
+					hasOwn(articleContent, 'layoutJson')
+						? (articleContent.layoutJson ?? null)
+						: current.layout_json,
 					nextWordCount,
 					nextReadTime,
 					hasOwn(articleContent, 'subtitle') ? (articleContent.subtitle ?? null) : current.subtitle,
@@ -1317,8 +1332,8 @@ export async function duplicateContentItem(
 		// generated faq_json carry across so the duplicate keeps its SEO/FAQ work.
 		await db
 			.prepare(
-				`INSERT INTO article_content (content_id, body_markdown, body_html, body_portable_text, word_count, read_time_minutes, subtitle, editor_takeaways, faq_json)
-				 SELECT ?, body_markdown, body_html, body_portable_text, word_count, read_time_minutes, subtitle, editor_takeaways, faq_json
+				`INSERT INTO article_content (content_id, body_markdown, body_html, body_portable_text, layout_json, word_count, read_time_minutes, subtitle, editor_takeaways, faq_json)
+				 SELECT ?, body_markdown, body_html, body_portable_text, layout_json, word_count, read_time_minutes, subtitle, editor_takeaways, faq_json
 				 FROM article_content WHERE content_id = ?`,
 			)
 			.bind(newId, sourceId)

package/src/engine/revisions.ts

@@ -7,7 +7,13 @@
 
 import { parseContentMetadata } from './content-metadata.js'
 import type { D1Database } from './d1.js'
-import { countWords, getContentItem, getContentSnapshot, updateContentItem } from './publisher.js'
+import {
+	countWords,
+	getContentItem,
+	getContentSnapshot,
+	isBodyBackedContentType,
+	updateContentItem,
+} from './publisher.js'
 import { validateRevisionTaxonomy } from './taxonomy.js'
 
 /** The one canonical revision snapshot shape (spec §4 "ContentRevisionPayload"). */
@@ -193,6 +199,7 @@ export async function restoreRevision(
 		body_markdown?: string
 		body_html?: string | null
 		body_portable_text?: string | null
+		layout_json?: string | null
 		subtitle?: string | null
 		script?: string
 		video_id?: string
@@ -254,11 +261,14 @@ export async function restoreRevision(
 			reason: r.reason,
 		})),
 		content:
-			existing.type === 'article' || existing.type === 'newsletter'
+			// Pages are body-backed too — they must take this branch, or a page
+			// restore silently skips its body and layout entirely.
+			isBodyBackedContentType(existing.type)
 				? {
 						bodyMarkdown: body?.body_markdown ?? '',
 						bodyHtml: body?.body_html ?? null,
 						bodyPortableText: body?.body_portable_text ?? null,
+						layoutJson: body?.layout_json ?? null,
 						subtitle: body?.subtitle ?? null,
 						// Editor takeaways were captured in the snapshot — roll them back.
 						editorTakeaways: restoredTakeaways,

package/src/puck/config.tsx

@@ -0,0 +1,194 @@
+// src/puck/config.tsx
+// The cms-owned Puck component library (v1): the Config consumed by both the
+// admin editor (<Puck>) and the public renderer (<Render> from
+// @puckeditor/core/rsc). Every render function is server-safe — plain JSX,
+// no hooks, no DOM access — so the fronts Worker can render layouts with
+// zero client JS. @puckeditor/core itself is only a TYPE dependency here;
+// the runtime dependency lives with the consumer (optional peer).
+//
+// RichText stores a Portable Text envelope (schema/portable-text.ts) in its
+// props — NEVER Puck's built-in `richtext` field, whose /rsc render path
+// requires a DOM (@tiptap/html + happy-dom) and breaks on workerd. The HTML
+// projection is injected by the consumer so site render pipelines (sanitize,
+// heading ids, entity linking) stay site-owned.
+
+import type { Config, Field } from '@puckeditor/core'
+import type { ReactNode } from 'react'
+
+export interface PuckConfigOptions {
+	/**
+	 * Portable Text envelope JSON → trusted HTML for RichText blocks. The
+	 * consumer owns this (fronts routes it through its article render
+	 * pipeline). Without it, RichText renders a loud inline marker instead of
+	 * silently dropping content.
+	 */
+	renderRichTextHtml?: (portableTextEnvelopeJson: string) => string
+	/**
+	 * Editor-side replacement for the RichText placeholder field — typically a
+	 * custom field embedding the Portable Text editor. Injected here so the
+	 * shared config module stays server-safe (no TipTap/DOM imports).
+	 */
+	richTextField?: Field
+}
+
+/** The v1 layout component set, in palette order. */
+export const LAYOUT_COMPONENT_TYPES = [
+	'Section',
+	'Heading',
+	'RichText',
+	'Image',
+	'CTAButton',
+	'Spacer',
+] as const
+
+export type LayoutComponentType = (typeof LAYOUT_COMPONENT_TYPES)[number]
+
+export function createPuckConfig(options: PuckConfigOptions = {}): Config {
+	const { renderRichTextHtml, richTextField } = options
+	return {
+		components: {
+			Section: {
+				label: 'Section',
+				fields: {
+					width: {
+						type: 'select',
+						label: 'Width',
+						options: [
+							{ label: 'Normal', value: 'normal' },
+							{ label: 'Wide', value: 'wide' },
+						],
+					},
+					content: { type: 'slot' },
+				},
+				defaultProps: { width: 'normal', content: [] },
+				render: ({ width, content }) => (
+					<section className={`gl-layout-section gl-layout-section--${width || 'normal'}`}>
+						{typeof content === 'function' ? content() : null}
+					</section>
+				),
+			},
+			Heading: {
+				label: 'Heading',
+				fields: {
+					text: { type: 'text', label: 'Text', contentEditable: true },
+					level: {
+						type: 'select',
+						label: 'Level',
+						options: [
+							{ label: 'Heading 2', value: '2' },
+							{ label: 'Heading 3', value: '3' },
+						],
+					},
+				},
+				defaultProps: { text: '', level: '2' },
+				render: ({ text, level }) =>
+					level === '3' ? (
+						<h3 className="gl-layout-heading">{text}</h3>
+					) : (
+						<h2 className="gl-layout-heading">{text}</h2>
+					),
+			},
+			RichText: {
+				label: 'Rich text',
+				// The editor injects its Portable Text custom field via
+				// options.richTextField; the textarea is the headless fallback.
+				fields: {
+					portableText: richTextField ?? {
+						type: 'textarea',
+						label: 'Portable Text envelope',
+					},
+				},
+				defaultProps: { portableText: '' },
+				render: ({ portableText }) => {
+					const raw = typeof portableText === 'string' ? portableText : ''
+					if (renderRichTextHtml && raw !== '') {
+						return (
+							<div
+								className="gl-layout-richtext"
+								// biome-ignore lint/security/noDangerouslySetInnerHtml: the consumer-injected projection owns sanitization
+								dangerouslySetInnerHTML={{ __html: renderRichTextHtml(raw) }}
+							/>
+						)
+					}
+					// Loud, greppable marker — mirrors the fronts data-pt-unknown
+					// convention so a missing renderer never silently drops prose.
+					return (
+						<div
+							className="gl-layout-richtext"
+							data-gl-layout-unknown="richtext-renderer-missing"
+						/>
+					)
+				},
+			},
+			Image: {
+				label: 'Image',
+				fields: {
+					src: { type: 'text', label: 'Image URL' },
+					alt: { type: 'text', label: 'Alt text' },
+					caption: { type: 'text', label: 'Caption' },
+				},
+				defaultProps: { src: '', alt: '', caption: '' },
+				render: ({ src, alt, caption }) => (
+					<figure className="gl-layout-image">
+						{typeof src === 'string' && src !== '' ? (
+							<img src={src} alt={typeof alt === 'string' ? alt : ''} loading="lazy" />
+						) : null}
+						{typeof caption === 'string' && caption !== '' ? (
+							<figcaption>{caption}</figcaption>
+						) : null}
+					</figure>
+				),
+			},
+			CTAButton: {
+				label: 'CTA button',
+				fields: {
+					label: { type: 'text', label: 'Label', contentEditable: true },
+					href: { type: 'text', label: 'Link URL' },
+					tone: {
+						type: 'select',
+						label: 'Tone',
+						options: [
+							{ label: 'Primary', value: 'primary' },
+							{ label: 'Secondary', value: 'secondary' },
+						],
+					},
+				},
+				defaultProps: { label: '', href: '', tone: 'primary' },
+				render: ({ label, href, tone }) => (
+					<a
+						className={`gl-layout-cta gl-layout-cta--${tone || 'primary'}`}
+						href={typeof href === 'string' && href !== '' ? href : undefined}
+					>
+						{label}
+					</a>
+				),
+			},
+			Spacer: {
+				label: 'Spacer',
+				fields: {
+					size: {
+						type: 'select',
+						label: 'Size',
+						options: [
+							{ label: 'Small', value: 'sm' },
+							{ label: 'Medium', value: 'md' },
+							{ label: 'Large', value: 'lg' },
+						],
+					},
+				},
+				defaultProps: { size: 'md' },
+				render: ({ size }) => (
+					<div
+						className={`gl-layout-spacer gl-layout-spacer--${size || 'md'}`}
+						aria-hidden="true"
+					/>
+				),
+			},
+		},
+		root: {
+			// The page shell (nav, footer, prose width) belongs to the consumer;
+			// the layout root is deliberately chromeless.
+			render: ({ children }: { children?: ReactNode }) => <>{children}</>,
+		},
+	}
+}

package/src/puck/index.ts

@@ -0,0 +1,23 @@
+// src/puck/index.ts
+// The `@growth-labs/cms/puck` subpath: the page-builder component library
+// (Puck Config factory + server-safe React renders), the derived-markdown
+// projection, and the layout storage envelope contract. Consumers pair this
+// with @puckeditor/core (optional peer): the admin editor mounts <Puck>, the
+// public site renders with <Render> from @puckeditor/core/rsc.
+
+export {
+	LAYOUT_VERSION,
+	type LayoutComponent,
+	type LayoutData,
+	type LayoutEnvelope,
+	layoutEnvelopeSchema,
+	parseLayoutEnvelope,
+	wrapLayout,
+} from '../schema/layout.js'
+export {
+	createPuckConfig,
+	LAYOUT_COMPONENT_TYPES,
+	type LayoutComponentType,
+	type PuckConfigOptions,
+} from './config.js'
+export { layoutJsonToMarkdown, layoutToMarkdown } from './markdown.js'