extensions-page-blocks

name	extensions-page-blocks
description	Work on Madoc TS page block extension definitions, editors, and rendering hooks. Use when adding page block types, updating block editors, or changing block rendering flow in services/madoc-ts.

Page Block Extensions (Madoc TS)

Goal

Explain how page blocks are defined and rendered so new blocks or editor changes integrate with the registry and rendering pipeline.

Scope

• Page block definitions and registry
• Block editor wiring and block config helpers
• Block rendering to HTML/React and slot/page APIs

Non-scope

• General site routes or admin routes
• Unrelated extension types
• Frontend styling not tied to blocks

Key Entry Points

• services/madoc-ts/src/extensions/page-blocks/extension.ts
• services/madoc-ts/src/extensions/page-blocks/default-definitions.ts
• services/madoc-ts/src/extensions/page-blocks/block-editor-for.ts
• services/madoc-ts/src/extensions/page-blocks/simple-html-block/
• services/madoc-ts/src/extensions/page-blocks/simple-markdown-block/

Architecture Summary (Based on Source)

• PageBlockExtension is a RegistryExtension using registry name block and supports plugin overrides.
• Definitions can be filtered by required/optional context in getDefinitions.
• Blocks can render as React or HTML; React rendering uses server-side rendering or client-side render-to-string.
• Slot/page CRUD APIs are exposed via /api/madoc/pages, /api/madoc/slots, /api/madoc/blocks.