add dist

dist/modules/blocks/RenderBlocks.d.ts

@@ -0,0 +1,32 @@
+import type { BlockComponentMap, BlockData, EnhanceProps } from './types.js';
+export type RenderBlocksProps = {
+    /** Block data array from a Payload document (e.g. page.layout). */
+    blocks: BlockData[] | null | undefined;
+    /** Client-provided map of blockType → component. */
+    components: BlockComponentMap;
+    /**
+     * Optional client hook to inject block-specific props (nav anchors, etc.).
+     * Keeps the engine generic — the plugin knows no concrete block types.
+     */
+    enhanceProps?: EnhanceProps;
+};
+/**
+ * Generic, server-side block renderer.
+ *
+ * Iterates a document's blocks and renders each via the client's component
+ * map. Unknown blocks are skipped (null), never thrown. Block-specific logic is
+ * delegated to the client's optional `enhanceProps` — the plugin itself is
+ * block-agnostic.
+ *
+ * The client owns components and block schemas (they pass `components` and
+ * define blocks in their config); the plugin owns only the iteration and
+ * wiring. No wrapper markup is added — spacing/layout belong to the client's
+ * components.
+ *
+ * Nested blocks: a block that needs to render child blocks should render its
+ * own <RenderBlocks> and import the registry itself, rather than receiving the
+ * component map as a prop. Passing the map as a prop breaks React Server
+ * Components — functions (client components) can't cross the server→client
+ * boundary via props.
+ */
+export declare function RenderBlocks({ blocks, components, enhanceProps }: RenderBlocksProps): import("react/jsx-runtime").JSX.Element | null;

dist/modules/blocks/RenderBlocks.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Fragment } from 'react';
+/**
+ * Generic, server-side block renderer.
+ *
+ * Iterates a document's blocks and renders each via the client's component
+ * map. Unknown blocks are skipped (null), never thrown. Block-specific logic is
+ * delegated to the client's optional `enhanceProps` — the plugin itself is
+ * block-agnostic.
+ *
+ * The client owns components and block schemas (they pass `components` and
+ * define blocks in their config); the plugin owns only the iteration and
+ * wiring. No wrapper markup is added — spacing/layout belong to the client's
+ * components.
+ *
+ * Nested blocks: a block that needs to render child blocks should render its
+ * own <RenderBlocks> and import the registry itself, rather than receiving the
+ * component map as a prop. Passing the map as a prop breaks React Server
+ * Components — functions (client components) can't cross the server→client
+ * boundary via props.
+ */ export function RenderBlocks({ blocks, components, enhanceProps }) {
+    if (!blocks || !Array.isArray(blocks) || blocks.length === 0) {
+        return null;
+    }
+    return /*#__PURE__*/ _jsx(Fragment, {
+        children: blocks.map((block, index)=>{
+            const Component = components[block.blockType];
+            if (!Component) {
+                return null;
+            }
+            const extra = enhanceProps ? enhanceProps({
+                allBlocks: blocks,
+                block,
+                index
+            }) : {};
+            return /*#__PURE__*/ _jsx(Component, {
+                ...block,
+                ...extra
+            }, index);
+        })
+    });
+}
+
+//# sourceMappingURL=RenderBlocks.js.map

dist/modules/blocks/RenderBlocks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/blocks/RenderBlocks.tsx"],"sourcesContent":["import { Fragment } from 'react'\n\nimport type { BlockComponentMap, BlockData, EnhanceProps } from './types.js'\n\nexport type RenderBlocksProps = {\n  /** Block data array from a Payload document (e.g. page.layout). */\n  blocks: BlockData[] | null | undefined\n  /** Client-provided map of blockType → component. */\n  components: BlockComponentMap\n  /**\n   * Optional client hook to inject block-specific props (nav anchors, etc.).\n   * Keeps the engine generic — the plugin knows no concrete block types.\n   */\n  enhanceProps?: EnhanceProps\n}\n\n/**\n * Generic, server-side block renderer.\n *\n * Iterates a document's blocks and renders each via the client's component\n * map. Unknown blocks are skipped (null), never thrown. Block-specific logic is\n * delegated to the client's optional `enhanceProps` — the plugin itself is\n * block-agnostic.\n *\n * The client owns components and block schemas (they pass `components` and\n * define blocks in their config); the plugin owns only the iteration and\n * wiring. No wrapper markup is added — spacing/layout belong to the client's\n * components.\n *\n * Nested blocks: a block that needs to render child blocks should render its\n * own <RenderBlocks> and import the registry itself, rather than receiving the\n * component map as a prop. Passing the map as a prop breaks React Server\n * Components — functions (client components) can't cross the server→client\n * boundary via props.\n */\nexport function RenderBlocks({ blocks, components, enhanceProps }: RenderBlocksProps) {\n  if (!blocks || !Array.isArray(blocks) || blocks.length === 0) {\n    return null\n  }\n\n  return (\n    <Fragment>\n      {blocks.map((block, index) => {\n        const Component = components[block.blockType]\n        if (!Component) {return null}\n\n        const extra = enhanceProps ? enhanceProps({ allBlocks: blocks, block, index }) : {}\n\n        return <Component key={index} {...block} {...extra} />\n      })}\n    </Fragment>\n  )\n}\n"],"names":["Fragment","RenderBlocks","blocks","components","enhanceProps","Array","isArray","length","map","block","index","Component","blockType","extra","allBlocks"],"mappings":";AAAA,SAASA,QAAQ,QAAQ,QAAO;AAgBhC;;;;;;;;;;;;;;;;;;CAkBC,GACD,OAAO,SAASC,aAAa,EAAEC,MAAM,EAAEC,UAAU,EAAEC,YAAY,EAAqB;IAClF,IAAI,CAACF,UAAU,CAACG,MAAMC,OAAO,CAACJ,WAAWA,OAAOK,MAAM,KAAK,GAAG;QAC5D,OAAO;IACT;IAEA,qBACE,KAACP;kBACEE,OAAOM,GAAG,CAAC,CAACC,OAAOC;YAClB,MAAMC,YAAYR,UAAU,CAACM,MAAMG,SAAS,CAAC;YAC7C,IAAI,CAACD,WAAW;gBAAC,OAAO;YAAI;YAE5B,MAAME,QAAQT,eAAeA,aAAa;gBAAEU,WAAWZ;gBAAQO;gBAAOC;YAAM,KAAK,CAAC;YAElF,qBAAO,KAACC;gBAAuB,GAAGF,KAAK;gBAAG,GAAGI,KAAK;eAA3BH;QACzB;;AAGN"}

dist/modules/blocks/index.d.ts

@@ -0,0 +1,3 @@
+export { RenderBlocks } from './RenderBlocks.js';
+export type { RenderBlocksProps } from './RenderBlocks.js';
+export type { BlockComponentMap, BlockData, EnhanceProps } from './types.js';

dist/modules/blocks/index.js

@@ -0,0 +1,3 @@
+export { RenderBlocks } from './RenderBlocks.js';
+
+//# sourceMappingURL=index.js.map

dist/modules/blocks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/blocks/index.ts"],"sourcesContent":["export { RenderBlocks } from './RenderBlocks.js'\nexport type { RenderBlocksProps } from './RenderBlocks.js'\nexport type { BlockComponentMap, BlockData, EnhanceProps } from './types.js'\n"],"names":["RenderBlocks"],"mappings":"AAAA,SAASA,YAAY,QAAQ,oBAAmB"}

dist/modules/blocks/types.d.ts

@@ -0,0 +1,26 @@
+import type { ComponentType } from 'react';
+/**
+ * A single block's data as stored by Payload — always has a blockType, plus
+ * arbitrary block-specific fields. The plugin stays generic over the shape.
+ */
+export type BlockData = {
+    [key: string]: unknown;
+    blockType: string;
+};
+/**
+ * Maps a blockType to the client's component for it.
+ * The client owns the components; the plugin only receives this map.
+ */
+export type BlockComponentMap = Record<string, ComponentType<any>>;
+/**
+ * Optional per-block prop enhancer supplied by the client.
+ *
+ * Lets the client inject block-specific logic (e.g. collect anchors for a nav
+ * block) without the plugin knowing any concrete block types. Returns extra
+ * props merged into the rendered block.
+ */
+export type EnhanceProps = (args: {
+    allBlocks: BlockData[];
+    block: BlockData;
+    index: number;
+}) => Record<string, unknown>;

dist/modules/blocks/types.js

@@ -0,0 +1,9 @@
+/**
+ * Optional per-block prop enhancer supplied by the client.
+ *
+ * Lets the client inject block-specific logic (e.g. collect anchors for a nav
+ * block) without the plugin knowing any concrete block types. Returns extra
+ * props merged into the rendered block.
+ */ export { };
+
+//# sourceMappingURL=types.js.map

dist/modules/blocks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/modules/blocks/types.ts"],"sourcesContent":["import type { ComponentType } from 'react'\n\n/**\n * A single block's data as stored by Payload — always has a blockType, plus\n * arbitrary block-specific fields. The plugin stays generic over the shape.\n */\nexport type BlockData = {\n  [key: string]: unknown\n  blockType: string\n}\n\n/**\n * Maps a blockType to the client's component for it.\n * The client owns the components; the plugin only receives this map.\n */\nexport type BlockComponentMap = Record<string, ComponentType<any>>\n\n/**\n * Optional per-block prop enhancer supplied by the client.\n *\n * Lets the client inject block-specific logic (e.g. collect anchors for a nav\n * block) without the plugin knowing any concrete block types. Returns extra\n * props merged into the rendered block.\n */\nexport type EnhanceProps = (args: {\n  allBlocks: BlockData[]\n  block: BlockData\n  index: number\n}) => Record<string, unknown>\n"],"names":[],"mappings":"AAiBA;;;;;;CAMC,GACD,WAI6B"}