feat!: composition builder — JSON PressTree replaces the dynamic-zone mechanism

[odenirdev]

Composition builder — a JSON PressTree replaces the dynamic-zone mechanism engine-wide

Per-page layout root (header/footer/children slots), rows with 1–4 ratio-bound columns, full recursion, adopter custom-* blocks anywhere. Stored via one plugin::press-cms.builder JSON custom field; a structural tree-editor drives it in the admin.

BREAKING (wire + palette + API), no data migration (pre-release). 25 commits, executed task-by-task from docs/superpowers/plans/2026-07-20-composition-builder.md.

Highlights

• Storage: page.body (full PressTree) and site-setting.pageDefaults ({header,footer} slots) are JSON custom fields; the page-body + chrome Dynamic Zones and dz-populate are gone.
• @ogs-tech/press-shared is now a published runtime dependency: it ships the tree types + the sanitizing validatePressTree/validateNodeArray validators (cms bundles into dist; web depends + host transpiles). Strict-write (cms lifecycle rejects errors OR warnings) / tolerant-read (web sanitizes).
• Palette: new preset-molecule.link (label/page/url/newTab) referenced by button/hero/cta/navbar; nav-item/molecule.column/organism.columns retired. Text atoms store curated plain text (content: text) — the Strapi blocks AST leaves the wire. preset-layout.{container,row,column} descriptors drive the builder's layout forms.
• Serve-time hydration: media {assetId} → url/dims, page {documentId} → slug — resolved server-side (rename-safe internal links, no populate depth to fight), batched one query pair per request.
• Web: TreeRenderer (<header>/<main>/<footer> shell) replaces BlockRenderer; PressLink/resolveLink is the one link resolver (dangerous-protocol-safe); prose rail rescoped to direct <main> children; PageBody generates as PressTree; PressPageRef added; HeaderBlocks/FooterBlocks unions gone. Block-override contract components={{ 'preset-organism.hero': MyHero }} unchanged.

Automated verification (all green)

• pnpm build 6/6 incl. the playground Next build (SSG 3/3)
• pnpm -r test — web 260, cms 67, cli 29, shared 11
• typechecks clean (shared/cli/web + cms test:ts:back/test:ts:front)
• pnpm pack:check exit 0 — no *.test.ts in any tarball

Plan gaps caught & fixed during execution

• Batched hydratePageDocs to one query pair (was a plan-mandated N+1 on the unpaginated /pages route) + added serve-hydrated.test.ts.
• Moved press-shared devDeps→deps in web (Decision 3 gap); host transpiles it.
• footer.tsx inline-typed after ResolvedChromeFooter deletion (Task 14 migrated navbar but not footer).
• publish-readiness made target-aware (press-shared now published; workspace: allowed to co-published targets).
• Dropped files allowlist from press-shared so .npmignore keeps tests out of the tarball (surfaced by pack:check).
• Generator keys Page.body off type==='customField' alone (serialize strips the id) — production-shape guard test added.

Manual review checklist (not covered by automated tests — please verify on pnpm dev)

• /api/press/schema has tree:{version:1}; /api/pages/home body.version===1, hero image carries a hydrated url, navbar pageDefaults.header item has page:{documentId,slug:"home"}.
• localhost:3000 renders navbar / hero+image / prose atoms at ~72ch / the recursive 50-50 row / cta / callout / footer.
• Admin Composition field: add a paragraph in a column → Save → change appears (≤60s ISR). Pick a hero image via the media dialog (if the dialog key mismatches, the assetId fallback input must show).
• Site Settings pageDefaults slots editor; emptying header → inheriting pages render bare.
• CSS: prose-rail direct-child rescope, cell verticalAlign center/end, no main[data-press-stack] ↔ organism margin-block double-gap.

Known cosmetic note

The playground regen changed the cms Strapi uuid (the plan expected it preserved) — harmless dev instance id; can restore on request.

🤖 Generated with Claude Code