@reblu/site-blocks 0.32.0 → 0.34.0

package/dist/{full-invoice-fields-DMX0sjPG.d.cts → page-links-C0nXQzAW.d.cts}

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ShopCheckoutCopy, ShopCheckoutInput, ShopBillingInput } from '@reblu/site-contracts';
+import { ShopCheckoutCopy, ShopCheckoutInput, ShopBillingInput, BlockType, PageBlock, ResolvedEmbed } from '@reblu/site-contracts';
+import { ComponentType } from 'react';
 
 /** A heading level a caller can configure — `h1`…`h6`. */
 type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
@@ -137,4 +138,106 @@ interface FullInvoiceFieldsProps {
 }
 declare function FullInvoiceFields({ value, onChange, overCap, issuesInvoices, errors, countries, labels, className, }: FullInvoiceFieldsProps): react_jsx_runtime.JSX.Element | null;
 
-export { type CheckoutTermsCopy as C, DEFAULT_INVOICE_COUNTRIES as D, EMPTY_FULL_INVOICE_VALUE as E, type FullInvoiceFieldsLabels as F, type HeadingLevel as H, type FullInvoiceValue as a, CheckoutTermsAcceptance as b, type CheckoutTermsAcceptanceProps as c, type FullInvoiceErrors as d, FullInvoiceFields as e, type FullInvoiceFieldsProps as f, type FullInvoiceIdType as g, toCheckoutTermsFields as h, isOverSimplifiedInvoiceCap as i, shopIssuesInvoices as s, toCheckoutInvoiceFields as t };
+/**
+ * REB-850 — `PageBlocks`: the shared renderer for a page's registry blocks
+ * (`PageDetail.blocks`, REB-75), so a SITE stops hand-writing its own.
+ *
+ * A SERVER COMPONENT by default: no hooks, no `'use client'`, reachable from the
+ * RSC-safe root entry (`test/rsc-safety.test.ts` renders it under
+ * `--conditions=react-server`).
+ *
+ * Each block is wrapped in a `<section>` carrying the parent section's
+ * mirrored fields (REB-849): `heading`, `backgroundColor` and `cta`. The body
+ * comes from a per-type renderer that the `components` map can replace.
+ *
+ * Fail-closed rules:
+ *  • an unknown `blockType` renders nothing (the whole section) and never throws;
+ *  • an embed whose `resolved` is `null`/absent renders nothing — no heading,
+ *    no dead link;
+ *  • deprecated alias types (`doctor_embed`, `specialty_embed` — REB-852)
+ *    render through their generic type's renderer (`profile_embed`, `page_embed`).
+ */
+type DeprecatedAlias = 'doctor_embed' | 'specialty_embed';
+/** Block types a renderer is registered under — deprecated aliases resolve to these. */
+type CanonicalBlockType = Exclude<BlockType, DeprecatedAlias>;
+type EmbedType = 'page_embed' | 'profile_embed';
+type WireTypesOf<T extends CanonicalBlockType> = T extends 'profile_embed' ? 'profile_embed' | 'doctor_embed' : T extends 'page_embed' ? 'page_embed' | 'specialty_embed' : T;
+/**
+ * The block a renderer for `T` receives — including its deprecated alias, and
+ * with `resolved` guaranteed non-null for embeds (unresolved ones never render).
+ */
+type RenderableBlock<T extends CanonicalBlockType> = T extends EmbedType ? Extract<PageBlock, {
+    blockType: WireTypesOf<T>;
+}> & {
+    resolved: ResolvedEmbed;
+} : Extract<PageBlock, {
+    blockType: WireTypesOf<T>;
+}>;
+interface BlockRendererProps<T extends CanonicalBlockType> {
+    block: RenderableBlock<T>;
+    /** Level for headings INSIDE the block — one below the section heading when there is one. */
+    headingLevel: HeadingLevel;
+    /** Builds an embed's href (the `embedHref` prop, or the default `/${slug}`). */
+    embedHref: (resolved: ResolvedEmbed) => string;
+    /**
+     * REB-1268 — set only for block types that draw the SECTION heading
+     * themselves (`image_text`, whose heading sits beside the image): the id the
+     * section's `aria-labelledby` points at. `headingLevel` is then the section
+     * heading's own level. Undefined for every other block type.
+     */
+    headingId?: string;
+}
+/** Per-block-type renderer overrides, keyed by canonical type. */
+type PageBlocksComponents = Partial<{
+    [T in CanonicalBlockType]: ComponentType<BlockRendererProps<T>>;
+}>;
+interface PageBlocksProps {
+    blocks: readonly PageBlock[] | null | undefined;
+    /** Replace the body renderer of any block type. */
+    components?: PageBlocksComponents;
+    /** Level of each section heading. Default `2` (the page title is the `h1`). */
+    headingLevel?: HeadingLevel;
+    /** Href for an embedded page. Default `/${resolved.slug}`. */
+    embedHref?: (resolved: ResolvedEmbed) => string;
+    /**
+     * Namespace for the section heading ids (`aria-labelledby` targets). Pass a
+     * distinct value when one document renders `PageBlocks` more than once with
+     * overlapping blocks. Sanitised to a valid IDREF. Default `'page-block'`.
+     */
+    idPrefix?: string;
+    className?: string;
+    sectionClassName?: string;
+}
+declare function PageBlocks({ blocks, components, headingLevel, embedHref, idPrefix, className, sectionClassName, }: PageBlocksProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * REB-1100 — pure helpers over a page's `links` (the pages it picked in nexus,
+ * e.g. a team profile's areas). RSC-safe, no React.
+ *
+ * Structural types on purpose: any list item that carries `links` works, and
+ * an item from an API that predates `links` (absent) simply has none.
+ */
+interface PageLinkRef {
+    slug: string;
+    title: string;
+    category?: {
+        name: string;
+        slug: string;
+    } | null;
+}
+interface LinkFilterOption {
+    /** Stable key: `{categorySlug}/{slug}` (a slug is unique per category). */
+    key: string;
+    label: string;
+}
+declare function linkKey(link: PageLinkRef): string;
+/** Each distinct link across `items`, once, in first-seen order. */
+declare function linkFilterOptions(items: Array<{
+    links?: PageLinkRef[] | null;
+}>): LinkFilterOption[];
+/** The items linked to `key`; every item when `key` is null. */
+declare function filterByLink<T extends {
+    links?: PageLinkRef[] | null;
+}>(items: T[], key: string | null): T[];
+
+export { type BlockRendererProps as B, type CheckoutTermsCopy as C, DEFAULT_INVOICE_COUNTRIES as D, EMPTY_FULL_INVOICE_VALUE as E, type FullInvoiceFieldsLabels as F, type HeadingLevel as H, type LinkFilterOption as L, type PageLinkRef as P, type RenderableBlock as R, type FullInvoiceValue as a, type CanonicalBlockType as b, CheckoutTermsAcceptance as c, type CheckoutTermsAcceptanceProps as d, type FullInvoiceErrors as e, FullInvoiceFields as f, type FullInvoiceFieldsProps as g, type FullInvoiceIdType as h, PageBlocks as i, type PageBlocksComponents as j, type PageBlocksProps as k, filterByLink as l, isOverSimplifiedInvoiceCap as m, linkFilterOptions as n, linkKey as o, toCheckoutTermsFields as p, shopIssuesInvoices as s, toCheckoutInvoiceFields as t };

package/dist/{full-invoice-fields-DMX0sjPG.d.ts → page-links-C0nXQzAW.d.ts}

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ShopCheckoutCopy, ShopCheckoutInput, ShopBillingInput } from '@reblu/site-contracts';
+import { ShopCheckoutCopy, ShopCheckoutInput, ShopBillingInput, BlockType, PageBlock, ResolvedEmbed } from '@reblu/site-contracts';
+import { ComponentType } from 'react';
 
 /** A heading level a caller can configure — `h1`…`h6`. */
 type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
@@ -137,4 +138,106 @@ interface FullInvoiceFieldsProps {
 }
 declare function FullInvoiceFields({ value, onChange, overCap, issuesInvoices, errors, countries, labels, className, }: FullInvoiceFieldsProps): react_jsx_runtime.JSX.Element | null;
 
-export { type CheckoutTermsCopy as C, DEFAULT_INVOICE_COUNTRIES as D, EMPTY_FULL_INVOICE_VALUE as E, type FullInvoiceFieldsLabels as F, type HeadingLevel as H, type FullInvoiceValue as a, CheckoutTermsAcceptance as b, type CheckoutTermsAcceptanceProps as c, type FullInvoiceErrors as d, FullInvoiceFields as e, type FullInvoiceFieldsProps as f, type FullInvoiceIdType as g, toCheckoutTermsFields as h, isOverSimplifiedInvoiceCap as i, shopIssuesInvoices as s, toCheckoutInvoiceFields as t };
+/**
+ * REB-850 — `PageBlocks`: the shared renderer for a page's registry blocks
+ * (`PageDetail.blocks`, REB-75), so a SITE stops hand-writing its own.
+ *
+ * A SERVER COMPONENT by default: no hooks, no `'use client'`, reachable from the
+ * RSC-safe root entry (`test/rsc-safety.test.ts` renders it under
+ * `--conditions=react-server`).
+ *
+ * Each block is wrapped in a `<section>` carrying the parent section's
+ * mirrored fields (REB-849): `heading`, `backgroundColor` and `cta`. The body
+ * comes from a per-type renderer that the `components` map can replace.
+ *
+ * Fail-closed rules:
+ *  • an unknown `blockType` renders nothing (the whole section) and never throws;
+ *  • an embed whose `resolved` is `null`/absent renders nothing — no heading,
+ *    no dead link;
+ *  • deprecated alias types (`doctor_embed`, `specialty_embed` — REB-852)
+ *    render through their generic type's renderer (`profile_embed`, `page_embed`).
+ */
+type DeprecatedAlias = 'doctor_embed' | 'specialty_embed';
+/** Block types a renderer is registered under — deprecated aliases resolve to these. */
+type CanonicalBlockType = Exclude<BlockType, DeprecatedAlias>;
+type EmbedType = 'page_embed' | 'profile_embed';
+type WireTypesOf<T extends CanonicalBlockType> = T extends 'profile_embed' ? 'profile_embed' | 'doctor_embed' : T extends 'page_embed' ? 'page_embed' | 'specialty_embed' : T;
+/**
+ * The block a renderer for `T` receives — including its deprecated alias, and
+ * with `resolved` guaranteed non-null for embeds (unresolved ones never render).
+ */
+type RenderableBlock<T extends CanonicalBlockType> = T extends EmbedType ? Extract<PageBlock, {
+    blockType: WireTypesOf<T>;
+}> & {
+    resolved: ResolvedEmbed;
+} : Extract<PageBlock, {
+    blockType: WireTypesOf<T>;
+}>;
+interface BlockRendererProps<T extends CanonicalBlockType> {
+    block: RenderableBlock<T>;
+    /** Level for headings INSIDE the block — one below the section heading when there is one. */
+    headingLevel: HeadingLevel;
+    /** Builds an embed's href (the `embedHref` prop, or the default `/${slug}`). */
+    embedHref: (resolved: ResolvedEmbed) => string;
+    /**
+     * REB-1268 — set only for block types that draw the SECTION heading
+     * themselves (`image_text`, whose heading sits beside the image): the id the
+     * section's `aria-labelledby` points at. `headingLevel` is then the section
+     * heading's own level. Undefined for every other block type.
+     */
+    headingId?: string;
+}
+/** Per-block-type renderer overrides, keyed by canonical type. */
+type PageBlocksComponents = Partial<{
+    [T in CanonicalBlockType]: ComponentType<BlockRendererProps<T>>;
+}>;
+interface PageBlocksProps {
+    blocks: readonly PageBlock[] | null | undefined;
+    /** Replace the body renderer of any block type. */
+    components?: PageBlocksComponents;
+    /** Level of each section heading. Default `2` (the page title is the `h1`). */
+    headingLevel?: HeadingLevel;
+    /** Href for an embedded page. Default `/${resolved.slug}`. */
+    embedHref?: (resolved: ResolvedEmbed) => string;
+    /**
+     * Namespace for the section heading ids (`aria-labelledby` targets). Pass a
+     * distinct value when one document renders `PageBlocks` more than once with
+     * overlapping blocks. Sanitised to a valid IDREF. Default `'page-block'`.
+     */
+    idPrefix?: string;
+    className?: string;
+    sectionClassName?: string;
+}
+declare function PageBlocks({ blocks, components, headingLevel, embedHref, idPrefix, className, sectionClassName, }: PageBlocksProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * REB-1100 — pure helpers over a page's `links` (the pages it picked in nexus,
+ * e.g. a team profile's areas). RSC-safe, no React.
+ *
+ * Structural types on purpose: any list item that carries `links` works, and
+ * an item from an API that predates `links` (absent) simply has none.
+ */
+interface PageLinkRef {
+    slug: string;
+    title: string;
+    category?: {
+        name: string;
+        slug: string;
+    } | null;
+}
+interface LinkFilterOption {
+    /** Stable key: `{categorySlug}/{slug}` (a slug is unique per category). */
+    key: string;
+    label: string;
+}
+declare function linkKey(link: PageLinkRef): string;
+/** Each distinct link across `items`, once, in first-seen order. */
+declare function linkFilterOptions(items: Array<{
+    links?: PageLinkRef[] | null;
+}>): LinkFilterOption[];
+/** The items linked to `key`; every item when `key` is null. */
+declare function filterByLink<T extends {
+    links?: PageLinkRef[] | null;
+}>(items: T[], key: string | null): T[];
+
+export { type BlockRendererProps as B, type CheckoutTermsCopy as C, DEFAULT_INVOICE_COUNTRIES as D, EMPTY_FULL_INVOICE_VALUE as E, type FullInvoiceFieldsLabels as F, type HeadingLevel as H, type LinkFilterOption as L, type PageLinkRef as P, type RenderableBlock as R, type FullInvoiceValue as a, type CanonicalBlockType as b, CheckoutTermsAcceptance as c, type CheckoutTermsAcceptanceProps as d, type FullInvoiceErrors as e, FullInvoiceFields as f, type FullInvoiceFieldsProps as g, type FullInvoiceIdType as h, PageBlocks as i, type PageBlocksComponents as j, type PageBlocksProps as k, filterByLink as l, isOverSimplifiedInvoiceCap as m, linkFilterOptions as n, linkKey as o, toCheckoutTermsFields as p, shopIssuesInvoices as s, toCheckoutInvoiceFields as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reblu/site-blocks",
-  "version": "0.32.0",
+  "version": "0.34.0",
   "description": "Data-driven presentational organisms for Reblu SITEs (Collection, MarkdownRenderer, Treatment, ParentPage, ProfileCard, ProductCard) — clean, token-driven, white-label.",
   "license": "Apache-2.0",
   "author": "Reblu — Adolfo Unturbe",
@@ -70,8 +70,8 @@
   "dependencies": {
     "class-variance-authority": "^0.7.1",
     "html-react-parser": "5.2.17",
-    "@reblu/site-ui": "^0.7.2",
-    "@reblu/site-contracts": "^1.30.0"
+    "@reblu/site-contracts": "^1.32.0",
+    "@reblu/site-ui": "^0.7.2"
   },
   "peerDependencies": {
     "react": ">=19",
@@ -101,7 +101,7 @@
     "unist-util-visit": "^5.1.0",
     "vitest": "^4.0.15",
     "@reblu/config": "0.0.1",
-    "@reblu/site-client": "^5.20.0"
+    "@reblu/site-client": "^5.21.0"
   },
   "scripts": {
     "build": "tsup",