@riverbankcms/sdk 0.129.0 → 0.130.0

package/dist/_dts/blocks/src/system/registry.d.ts

@@ -36,6 +36,8 @@ export type SystemBlockComponent<TContent = Record<string, unknown>> = Component
 export type BlockDataLoader = {
     endpoint: string;
     params: Record<string, unknown>;
+    /** Resolved request parameters that must be non-empty before this loader runs. */
+    requiredParams?: readonly string[];
     mode?: 'server' | 'client';
     /**
      * Optional guard for whether this loader should execute.

package/dist/_dts/blocks/src/system/runtime/api/types/shop.d.ts

@@ -3,43 +3,8 @@
  *
  * Part of the block API client type surface; re-exported from `../types`.
  */
-export interface PublicProductVariant {
-    id: string;
-    title: string;
-    sku: string | null;
-    priceCents: number;
-    stockQuantity: number | null;
-    soldOut: boolean;
-}
-export interface PublicProduct {
-    id: string;
-    contentEntryId: string | null;
-    title: string;
-    slug: string;
-    path: string | null;
-    status: "draft" | "active";
-    priceCents: number;
-    currency: string;
-    productType: "physical" | "digital";
-    requiresShipping: boolean;
-    hasVariants: boolean;
-    trackInventory: boolean;
-    soldOut: boolean;
-    category: {
-        id: string;
-        name: string;
-        slug: string;
-    } | null;
-    summary: string | null;
-    badges: string[];
-    ctaLabel: string | null;
-    body: unknown;
-    gallery: Array<{
-        url: string;
-        alt: string | null;
-    }>;
-    variants: PublicProductVariant[];
-}
+import type { PublicProduct } from "../../../blocks/products/shared";
+export type { PublicProduct, PublicProductVariant, } from "../../../blocks/products/shared";
 export interface PublicProductsResponse {
     products: PublicProduct[];
 }

package/dist/_dts/blocks/src/system/runtime/components/registry.client.d.ts

@@ -896,7 +896,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     }>[];
                 }>;
                 hydration: Readonly<{
-                    products: readonly import("../../blocks/products/shared").PublicProduct[];
+                    products: readonly import("../api/types").PublicProduct[];
                     showSummary: boolean;
                     showPrices: boolean;
                     addButtonText: string;
@@ -939,7 +939,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             }>[];
                         }>;
                         hydration: Readonly<{
-                            products: readonly import("../../blocks/products/shared").PublicProduct[];
+                            products: readonly import("../api/types").PublicProduct[];
                             showSummary: boolean;
                             showPrices: boolean;
                             addButtonText: string;
@@ -976,7 +976,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             }>[];
                         }>;
                         hydration: Readonly<{
-                            products: readonly import("../../blocks/products/shared").PublicProduct[];
+                            products: readonly import("../api/types").PublicProduct[];
                             showSummary: boolean;
                             showPrices: boolean;
                             addButtonText: string;
@@ -1021,7 +1021,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         }>[];
                     }>;
                     hydration: Readonly<{
-                        products: readonly import("../../blocks/products/shared").PublicProduct[];
+                        products: readonly import("../api/types").PublicProduct[];
                         showSummary: boolean;
                         showPrices: boolean;
                         addButtonText: string;
@@ -1064,7 +1064,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 }>[];
                             }>;
                             hydration: Readonly<{
-                                products: readonly import("../../blocks/products/shared").PublicProduct[];
+                                products: readonly import("../api/types").PublicProduct[];
                                 showSummary: boolean;
                                 showPrices: boolean;
                                 addButtonText: string;
@@ -1101,7 +1101,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 }>[];
                             }>;
                             hydration: Readonly<{
-                                products: readonly import("../../blocks/products/shared").PublicProduct[];
+                                products: readonly import("../api/types").PublicProduct[];
                                 showSummary: boolean;
                                 showPrices: boolean;
                                 addButtonText: string;
@@ -1121,7 +1121,7 @@ export declare const runtimeBackedBlockClientEntries: {
             buildRender: (source: import("../nodes/shop.interactive").ShopSourceProps) => Readonly<{
                 display: import("../../../contracts").ProductDetailDisplay;
                 hydration: Readonly<{
-                    products: readonly import("../../blocks/products/shared").PublicProduct[];
+                    products: readonly import("../api/types").PublicProduct[];
                     productId: string | null;
                     showSummary: boolean;
                     showBody: boolean;
@@ -1137,7 +1137,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     encode: (value: Readonly<{
                         display: import("../../../contracts").ProductDetailDisplay;
                         hydration: Readonly<{
-                            products: readonly import("../../blocks/products/shared").PublicProduct[];
+                            products: readonly import("../api/types").PublicProduct[];
                             productId: string | null;
                             showSummary: boolean;
                             showBody: boolean;
@@ -1147,7 +1147,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         display: import("../../../contracts").ProductDetailDisplay;
                         hydration: Readonly<{
-                            products: readonly import("../../blocks/products/shared").PublicProduct[];
+                            products: readonly import("../api/types").PublicProduct[];
                             productId: string | null;
                             showSummary: boolean;
                             showBody: boolean;
@@ -1165,7 +1165,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 buildRender: (source: import("../nodes/shop.interactive").ShopSourceProps) => Readonly<{
                     display: import("../../../contracts").ProductDetailDisplay;
                     hydration: Readonly<{
-                        products: readonly import("../../blocks/products/shared").PublicProduct[];
+                        products: readonly import("../api/types").PublicProduct[];
                         productId: string | null;
                         showSummary: boolean;
                         showBody: boolean;
@@ -1181,7 +1181,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         encode: (value: Readonly<{
                             display: import("../../../contracts").ProductDetailDisplay;
                             hydration: Readonly<{
-                                products: readonly import("../../blocks/products/shared").PublicProduct[];
+                                products: readonly import("../api/types").PublicProduct[];
                                 productId: string | null;
                                 showSummary: boolean;
                                 showBody: boolean;
@@ -1191,7 +1191,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                             display: import("../../../contracts").ProductDetailDisplay;
                             hydration: Readonly<{
-                                products: readonly import("../../blocks/products/shared").PublicProduct[];
+                                products: readonly import("../api/types").PublicProduct[];
                                 productId: string | null;
                                 showSummary: boolean;
                                 showBody: boolean;
@@ -2132,7 +2132,14 @@ export declare const runtimeBackedBlockClientEntries: {
                         creditsLabel: string;
                         perCreditLabel: string | null;
                         validityLabel: string | null;
-                        actionLabel: string;
+                        action: Readonly<{
+                            kind: "purchase";
+                            label: string;
+                            product: import("../..").PurchasablePublicPassProduct;
+                        }> | Readonly<{
+                            kind: "unavailable";
+                            label: string;
+                        }>;
                     }>[];
                     memberships: readonly Readonly<{
                         id: string;
@@ -2144,7 +2151,6 @@ export declare const runtimeBackedBlockClientEntries: {
                     }>[];
                 }>;
                 hydration: Readonly<{
-                    passes: readonly import("../..").PublicPassProduct[];
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("../../..").BlockButtonRole;
@@ -2174,7 +2180,14 @@ export declare const runtimeBackedBlockClientEntries: {
                                 creditsLabel: string;
                                 perCreditLabel: string | null;
                                 validityLabel: string | null;
-                                actionLabel: string;
+                                action: Readonly<{
+                                    kind: "purchase";
+                                    label: string;
+                                    product: import("../..").PurchasablePublicPassProduct;
+                                }> | Readonly<{
+                                    kind: "unavailable";
+                                    label: string;
+                                }>;
                             }>[];
                             memberships: readonly Readonly<{
                                 id: string;
@@ -2186,7 +2199,6 @@ export declare const runtimeBackedBlockClientEntries: {
                             }>[];
                         }>;
                         hydration: Readonly<{
-                            passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
@@ -2210,7 +2222,14 @@ export declare const runtimeBackedBlockClientEntries: {
                                 creditsLabel: string;
                                 perCreditLabel: string | null;
                                 validityLabel: string | null;
-                                actionLabel: string;
+                                action: Readonly<{
+                                    kind: "purchase";
+                                    label: string;
+                                    product: import("../..").PurchasablePublicPassProduct;
+                                }> | Readonly<{
+                                    kind: "unavailable";
+                                    label: string;
+                                }>;
                             }>[];
                             memberships: readonly Readonly<{
                                 id: string;
@@ -2222,7 +2241,6 @@ export declare const runtimeBackedBlockClientEntries: {
                             }>[];
                         }>;
                         hydration: Readonly<{
-                            passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
@@ -2254,7 +2272,14 @@ export declare const runtimeBackedBlockClientEntries: {
                             creditsLabel: string;
                             perCreditLabel: string | null;
                             validityLabel: string | null;
-                            actionLabel: string;
+                            action: Readonly<{
+                                kind: "purchase";
+                                label: string;
+                                product: import("../..").PurchasablePublicPassProduct;
+                            }> | Readonly<{
+                                kind: "unavailable";
+                                label: string;
+                            }>;
                         }>[];
                         memberships: readonly Readonly<{
                             id: string;
@@ -2266,7 +2291,6 @@ export declare const runtimeBackedBlockClientEntries: {
                         }>[];
                     }>;
                     hydration: Readonly<{
-                        passes: readonly import("../..").PublicPassProduct[];
                         memberships: readonly import("../..").PublicMembershipProduct[];
                         passPurchaseMode: "add_to_cart" | "buy_now";
                         buttonVariant: import("../../..").BlockButtonRole;
@@ -2296,7 +2320,14 @@ export declare const runtimeBackedBlockClientEntries: {
                                     creditsLabel: string;
                                     perCreditLabel: string | null;
                                     validityLabel: string | null;
-                                    actionLabel: string;
+                                    action: Readonly<{
+                                        kind: "purchase";
+                                        label: string;
+                                        product: import("../..").PurchasablePublicPassProduct;
+                                    }> | Readonly<{
+                                        kind: "unavailable";
+                                        label: string;
+                                    }>;
                                 }>[];
                                 memberships: readonly Readonly<{
                                     id: string;
@@ -2308,7 +2339,6 @@ export declare const runtimeBackedBlockClientEntries: {
                                 }>[];
                             }>;
                             hydration: Readonly<{
-                                passes: readonly import("../..").PublicPassProduct[];
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                                 passPurchaseMode: "add_to_cart" | "buy_now";
                                 buttonVariant: import("../../..").BlockButtonRole;
@@ -2332,7 +2362,14 @@ export declare const runtimeBackedBlockClientEntries: {
                                     creditsLabel: string;
                                     perCreditLabel: string | null;
                                     validityLabel: string | null;
-                                    actionLabel: string;
+                                    action: Readonly<{
+                                        kind: "purchase";
+                                        label: string;
+                                        product: import("../..").PurchasablePublicPassProduct;
+                                    }> | Readonly<{
+                                        kind: "unavailable";
+                                        label: string;
+                                    }>;
                                 }>[];
                                 memberships: readonly Readonly<{
                                     id: string;
@@ -2344,7 +2381,6 @@ export declare const runtimeBackedBlockClientEntries: {
                                 }>[];
                             }>;
                             hydration: Readonly<{
-                                passes: readonly import("../..").PublicPassProduct[];
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                                 passPurchaseMode: "add_to_cart" | "buy_now";
                                 buttonVariant: import("../../..").BlockButtonRole;
@@ -2382,6 +2418,7 @@ export declare const clientComponentRegistryEntries: {
         component: React.ComponentType<{
             [key: string]: unknown;
             className?: string;
+            runtime?: import("../header/runtimeContract").HeaderChromeRuntimeContract;
             blockId?: string;
             blockKind?: string;
             blockContent?: unknown;

package/dist/_dts/blocks/src/system/runtime/components/runtime-backed-blocks.d.ts

@@ -466,7 +466,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     }>[];
                 }>;
                 hydration: Readonly<{
-                    products: readonly import("../../blocks/products/shared").PublicProduct[];
+                    products: readonly import("../api/types").PublicProduct[];
                     showSummary: boolean;
                     showPrices: boolean;
                     addButtonText: string;
@@ -509,7 +509,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             }>[];
                         }>;
                         hydration: Readonly<{
-                            products: readonly import("../../blocks/products/shared").PublicProduct[];
+                            products: readonly import("../api/types").PublicProduct[];
                             showSummary: boolean;
                             showPrices: boolean;
                             addButtonText: string;
@@ -546,7 +546,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             }>[];
                         }>;
                         hydration: Readonly<{
-                            products: readonly import("../../blocks/products/shared").PublicProduct[];
+                            products: readonly import("../api/types").PublicProduct[];
                             showSummary: boolean;
                             showPrices: boolean;
                             addButtonText: string;
@@ -564,7 +564,7 @@ export declare const runtimeBackedBlockServerEntries: {
             buildRender: (source: import("../nodes/shop.interactive").ShopSourceProps) => Readonly<{
                 display: import("../../../contracts").ProductDetailDisplay;
                 hydration: Readonly<{
-                    products: readonly import("../../blocks/products/shared").PublicProduct[];
+                    products: readonly import("../api/types").PublicProduct[];
                     productId: string | null;
                     showSummary: boolean;
                     showBody: boolean;
@@ -580,7 +580,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     encode: (value: Readonly<{
                         display: import("../../../contracts").ProductDetailDisplay;
                         hydration: Readonly<{
-                            products: readonly import("../../blocks/products/shared").PublicProduct[];
+                            products: readonly import("../api/types").PublicProduct[];
                             productId: string | null;
                             showSummary: boolean;
                             showBody: boolean;
@@ -590,7 +590,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
                         display: import("../../../contracts").ProductDetailDisplay;
                         hydration: Readonly<{
-                            products: readonly import("../../blocks/products/shared").PublicProduct[];
+                            products: readonly import("../api/types").PublicProduct[];
                             productId: string | null;
                             showSummary: boolean;
                             showBody: boolean;
@@ -1074,7 +1074,14 @@ export declare const runtimeBackedBlockServerEntries: {
                         creditsLabel: string;
                         perCreditLabel: string | null;
                         validityLabel: string | null;
-                        actionLabel: string;
+                        action: Readonly<{
+                            kind: "purchase";
+                            label: string;
+                            product: import("../..").PurchasablePublicPassProduct;
+                        }> | Readonly<{
+                            kind: "unavailable";
+                            label: string;
+                        }>;
                     }>[];
                     memberships: readonly Readonly<{
                         id: string;
@@ -1086,7 +1093,6 @@ export declare const runtimeBackedBlockServerEntries: {
                     }>[];
                 }>;
                 hydration: Readonly<{
-                    passes: readonly import("../..").PublicPassProduct[];
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
                     buttonVariant: import("../../..").BlockButtonRole;
@@ -1116,7 +1122,14 @@ export declare const runtimeBackedBlockServerEntries: {
                                 creditsLabel: string;
                                 perCreditLabel: string | null;
                                 validityLabel: string | null;
-                                actionLabel: string;
+                                action: Readonly<{
+                                    kind: "purchase";
+                                    label: string;
+                                    product: import("../..").PurchasablePublicPassProduct;
+                                }> | Readonly<{
+                                    kind: "unavailable";
+                                    label: string;
+                                }>;
                             }>[];
                             memberships: readonly Readonly<{
                                 id: string;
@@ -1128,7 +1141,6 @@ export declare const runtimeBackedBlockServerEntries: {
                             }>[];
                         }>;
                         hydration: Readonly<{
-                            passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;
@@ -1152,7 +1164,14 @@ export declare const runtimeBackedBlockServerEntries: {
                                 creditsLabel: string;
                                 perCreditLabel: string | null;
                                 validityLabel: string | null;
-                                actionLabel: string;
+                                action: Readonly<{
+                                    kind: "purchase";
+                                    label: string;
+                                    product: import("../..").PurchasablePublicPassProduct;
+                                }> | Readonly<{
+                                    kind: "unavailable";
+                                    label: string;
+                                }>;
                             }>[];
                             memberships: readonly Readonly<{
                                 id: string;
@@ -1164,7 +1183,6 @@ export declare const runtimeBackedBlockServerEntries: {
                             }>[];
                         }>;
                         hydration: Readonly<{
-                            passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
                             buttonVariant: import("../../..").BlockButtonRole;

package/dist/_dts/blocks/src/system/runtime/header/enhanceHeaderSection.d.ts

@@ -1,9 +1,7 @@
+import { type HeaderChromeRuntimeContract } from './runtimeContract';
 export type HeaderChromeRuntimeOptions = {
-    /**
-     * Enables scroll-aware styling (`header-scrolled` toggling).
-     * If omitted, inferred from DOM (`.rb-header-shrink` class on the section target).
-     */
-    scrollEnabled?: boolean;
+    /** Semantic runtime requirements derived from the effective header theme. */
+    runtime?: HeaderChromeRuntimeContract;
     /**
      * Optional explicit target to receive the `header-scrolled` class.
      * If omitted, the enhancer uses the first non-script child element.

package/dist/_dts/blocks/src/system/runtime/header/headerScrollRuntime.d.ts

@@ -0,0 +1,2 @@
+import type { HeaderScrollRuntime } from './runtimeContract';
+export declare function enhanceHeaderScrollBehavior(target: HTMLElement, runtime: HeaderScrollRuntime): Array<() => void>;

package/dist/_dts/blocks/src/system/runtime/header/runtimeContract.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export declare const headerScrollRuntimeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"none">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"threshold">;
+}, z.core.$strip>], "kind">;
+export type HeaderScrollRuntime = z.infer<typeof headerScrollRuntimeSchema>;
+export declare const headerChromeRuntimeContractSchema: z.ZodObject<{
+    scroll: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"threshold">;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>;
+export type HeaderChromeRuntimeContract = z.infer<typeof headerChromeRuntimeContractSchema>;
+export declare const staticHeaderChromeRuntime: {
+    readonly scroll: {
+        readonly kind: "none";
+    };
+};
+export declare function isHeaderScrollRuntimeEnabled(header: unknown): boolean;
+export declare function resolveHeaderChromeRuntimeContract(header: unknown): HeaderChromeRuntimeContract;

package/dist/_dts/blocks/src/system/runtime/nodes/commerce/shared/display.d.ts

@@ -1,4 +1,4 @@
-import type { PublicMembershipProduct, PublicPassProduct } from '../../../../blocks/shop';
+import type { PublicMembershipProduct, PublicPassProduct, PurchasablePublicPassProduct } from '../../../../blocks/shop';
 import type { PublicProduct } from '../../../../blocks/products/shared';
 import type { CommerceCartItem, CommerceCheckoutState } from '../../shop-commerce.shared';
 export declare function formatCommercePrice(cents: number, currency: string): string;
@@ -67,7 +67,14 @@ export type PassCardDisplay = Readonly<{
     creditsLabel: string;
     perCreditLabel: string | null;
     validityLabel: string | null;
-    actionLabel: string;
+    action: Readonly<{
+        kind: 'purchase';
+        label: string;
+        product: PurchasablePublicPassProduct;
+    }> | Readonly<{
+        kind: 'unavailable';
+        label: string;
+    }>;
 }>;
 export type MembershipCardDisplay = Readonly<{
     id: string;

package/dist/_dts/blocks/src/system/runtime/nodes/commerce/shared/view.d.ts

@@ -37,6 +37,9 @@ export declare function PassCardView(props: Readonly<{
     action: React.ReactNode;
     feedback?: React.ReactNode;
 }>): React.JSX.Element;
+export declare function PassPurchaseUnavailable(props: Readonly<{
+    label: string;
+}>): React.JSX.Element;
 export declare function MembershipCardView(props: Readonly<{
     display: MembershipCardDisplay;
     action: React.ReactNode;

package/dist/_dts/blocks/src/system/runtime/nodes/header-section.client.d.ts

@@ -1,6 +1,8 @@
 import React from 'react';
+import { type HeaderChromeRuntimeContract } from '../header/runtimeContract';
 type HeaderSectionNodeProps = React.PropsWithChildren<{
     className?: string;
+    runtime?: HeaderChromeRuntimeContract;
     blockId?: string;
     blockKind?: string;
     blockContent?: unknown;

package/dist/_dts/blocks/src/system/runtime/nodes/header-section.frame.d.ts

@@ -0,0 +1,21 @@
+import React, { type ReactNode, type Ref } from 'react';
+export type HeaderSectionFrameProps = React.PropsWithChildren<{
+    rootRef?: Ref<HTMLElement>;
+    rootClassName: string;
+    sectionClassName?: string;
+    blockId?: string | null;
+    blockKind?: string;
+    previewSiteChromeSurface?: string;
+    islandMounted?: boolean;
+    islandId?: string;
+    islandPropsNode?: ReactNode;
+    hasBlockContent?: boolean;
+    hasFragmentRegistry?: boolean;
+    pathBase?: string;
+    as?: React.ElementType;
+    style?: React.CSSProperties;
+    background?: string;
+    dataSlot?: string;
+}>;
+/** Shared DOM frame for server-rendered and React-owned site headers. */
+export declare function HeaderSectionFrame({ rootRef, rootClassName, sectionClassName, blockId, blockKind, previewSiteChromeSurface, islandMounted, islandId, islandPropsNode, hasBlockContent, hasFragmentRegistry, pathBase, as, style, background, dataSlot, children, }: HeaderSectionFrameProps): React.JSX.Element;

package/dist/_dts/blocks/src/system/runtime/nodes/header-section.server.d.ts

@@ -1,7 +1,9 @@
 import React from "react";
+import { type HeaderChromeRuntimeContract } from "../header/runtimeContract";
 type HeaderSectionNodeProps = React.PropsWithChildren<{
     blockId?: string | null;
     className?: string;
+    runtime?: HeaderChromeRuntimeContract;
     "data-preview-site-chrome-surface"?: string;
     [key: string]: unknown;
 }>;