@riverbankcms/sdk 0.109.0 → 0.118.0

package/dist/_dts/blocks/src/system/manifest/fieldValidation/index.d.ts

@@ -201,7 +201,7 @@ export type InlineTextFieldValidationPlan = PlanBase<"inlineText", "array", Inli
 }>;
 export type MediaFieldValidationPlan = PlanBase<"media", "object", ObjectConstraint> & Readonly<{
     fieldType: "media" | "file";
-    legacyStringType: string;
+    allowedMediaTypes: readonly string[];
 }>;
 export type LinkFieldValidationPlan = PlanBase<"link", "object", ObjectConstraint> & Readonly<{
     fieldType: "link";
@@ -216,7 +216,17 @@ export type RepeaterFieldValidationPlan = PlanBase<"repeater", "array", ArrayCon
 }>;
 export type GroupFieldValidationPlan = PlanBase<"group", "object", ObjectConstraint> & Readonly<{
     fieldType: "group" | "modal" | "tabGroup";
-    children: readonly FieldValidationPlan[];
+    childSelection: Readonly<{
+        kind: "all";
+        fields: readonly FieldValidationPlan[];
+    }> | Readonly<{
+        kind: "discriminatedTabs";
+        activeTabField: string;
+        tabs: readonly Readonly<{
+            typeId: string;
+            fields: readonly FieldValidationPlan[];
+        }>[];
+    }>;
     allowNullChildren?: boolean;
 }>;
 export type PassthroughFieldValidationPlan = PlanBase<"passthrough", "unknown", RequiredConstraint> & Readonly<{
@@ -241,6 +251,13 @@ export declare function deriveFieldValidationPlans(fields: readonly FieldDefinit
 export declare function fieldPlanToNativeInputProps(plan: FieldValidationPlan): NativeInputValidationProps;
 export declare function normalizeFieldInput(plan: FieldValidationPlan, value: unknown, options?: FieldValidationOptions): unknown;
 export declare function normalizeStoredContentValues(plans: readonly FieldValidationPlan[], content: unknown, options?: FieldValidationOptions): Record<string, unknown>;
+/**
+ * Produces the portable representation accepted by content persistence.
+ * Runtime-hydrated media fields are stripped only when a canonical identifier
+ * is already present; unresolved environment-specific references remain
+ * invalid and must be handled by the site-scoped media write normalizer first.
+ */
+export declare function normalizeManifestContentForWrite(plans: readonly FieldValidationPlan[], content: unknown, options?: FieldValidationOptions): Record<string, unknown>;
 export declare function validateFieldValue(plan: FieldValidationPlan, value: unknown, options?: FieldValidationOptions): FieldValidationIssue[];
 export declare function fieldPlanToZod(plan: FieldValidationPlan, options?: FieldValidationOptions): z.ZodTypeAny;
 export declare function fieldPresenceForPlan(plan: Pick<FieldValidationPlan, "required">): FieldPresence;

package/dist/_dts/blocks/src/system/manifest/richTextSchema.d.ts

@@ -1,17 +1,7 @@
 import { z } from 'zod';
+import type { RichTextDoc, TipTapNode } from '../../../../core/src/index';
+export type { RichTextDoc, TipTapMark, TipTapNode, } from '../../../../core/src/index';
 export declare const TipTapNodeSchema: z.ZodType<TipTapNode>;
-/**
- * Rich text value schema
- *
- * Producers MUST emit the canonical unwrapped form `{ type: 'doc', content: [...] }`.
- * The wrapped form `{ doc: {...} }` is accepted only as a reading tolerance for data
- * that pre-dates the unwrap migration (Supabase migrations `20251029173500_unwrap_richtext_format`
- * and `20251029174000_update_template_bindings_unwrapped`). Do not introduce new
- * producers of the wrapped shape.
- */
-export declare const RichTextValueSchema: z.ZodUnion<readonly [z.ZodType<TipTapNode, unknown, z.core.$ZodTypeInternals<TipTapNode, unknown>>, z.ZodObject<{
-    doc: z.ZodType<TipTapNode, unknown, z.core.$ZodTypeInternals<TipTapNode, unknown>>;
-}, z.core.$strip>]>;
 /**
  * Build Zod validation schema for rich text fields
  *
@@ -28,24 +18,7 @@ export declare const RichTextValueSchema: z.ZodUnion<readonly [z.ZodType<TipTapN
  * // Required field with custom label
  * const schema = buildRichTextSchema({ required: true, label: 'Description' })
  */
-/**
- * TypeScript type for a TipTap document node
- *
- * Use this type for rich text content fields in block definitions.
- * Defined explicitly (rather than inferred) because recursive Zod schemas
- * require `z.ZodType<any>` which loses type information.
- */
-export type TipTapNode = {
-    type: string;
-    content?: TipTapNode[];
-    text?: string;
-    attrs?: Record<string, unknown>;
-    marks?: TipTapMark[];
-};
-export type TipTapMark = {
-    type: string;
-    attrs?: Record<string, unknown>;
-};
+/** Narrow node variants used by the inline Markdown helpers below. */
 export type RichTextTextNode = TipTapNode & {
     type: 'text';
     text: string;
@@ -65,49 +38,16 @@ export type RichTextInlineNode = RichTextTextNode | RichTextHardBreakNode;
  * (dummy content, editor output, migrations) must emit, and the shape every
  * non-legacy consumer can rely on.
  *
- * Legacy envelopes are read-tolerated by {@link RichTextValueSchema} but
- * normalised before reaching anywhere typed as `RichTextDoc`.
  */
-export declare const RichTextDocSchema: z.ZodObject<{
-    type: z.ZodLiteral<"doc">;
-    content: z.ZodArray<z.ZodType<TipTapNode, unknown, z.core.$ZodTypeInternals<TipTapNode, unknown>>>;
-}, z.core.$strip>;
-/**
- * A TipTap document root — the canonical shape for rich text content
- * in this codebase. Derived from {@link RichTextDocSchema} so the type and
- * its runtime validator can never drift.
- */
-export type RichTextDoc = z.infer<typeof RichTextDocSchema>;
+export declare const RichTextDocSchema: z.ZodType<RichTextDoc>;
 /**
  * Type guard for {@link RichTextDoc}.
  *
- * Returns `true` only for the canonical unwrapped form. Callers that may
- * receive a legacy `{ doc: {...} }` envelope must normalise first via
- * {@link unwrapRichTextRoot}.
+ * Returns `true` only for the canonical unwrapped form. The shared structural
+ * contract lives in `@riverbankcms/core`; parity tests keep its dependency-free
+ * guard aligned with this detailed Zod validator.
  */
 export declare function isRichTextDoc(value: unknown): value is RichTextDoc;
-/**
- * Permissive unwrap for a value known to be the root of a rich-text field.
- *
- * Producers should emit the canonical unwrapped form `{ type: 'doc', content: [...] }`,
- * but two legacy shapes still appear in older data and pre-Phase-1 fixtures:
- *
- *   - `{ doc: <typed-doc> }` — pre-migration DB storage.
- *   - `{ doc: <typed-doc>, html, plain }` — pre-Phase-1 dummy-content output.
- *
- * This helper is the single right place to tolerate either shape at a known
- * rich-text root (transforms, coercion, validators that operate on rich text).
- * The strictness sits on the inner node's `type === 'doc'`, which prevents
- * misidentifying random objects that happen to carry a field named `doc`.
- *
- * Returns the inner doc node when the input matches a legacy shape, otherwise
- * returns the input unchanged.
- *
- * For deep structural traversal where any nested key might be named `doc`
- * (and unwrapping would be incorrect), use the strict `isDocWrapper` private
- * helper inside `@riverbankcms/blocks/bindings`.
- */
-export declare function unwrapRichTextRoot(value: unknown): unknown;
 /**
  * Build a canonical {@link RichTextDoc} from plain-text paragraphs.
  *
@@ -141,6 +81,4 @@ export declare function createRichTextDocFromMarkdown(markdown: string): RichTex
 export declare function buildRichTextSchema(options?: {
     required?: boolean;
     label?: string;
-}): z.ZodUnion<readonly [z.ZodType<TipTapNode, unknown, z.core.$ZodTypeInternals<TipTapNode, unknown>>, z.ZodObject<{
-    doc: z.ZodType<TipTapNode, unknown, z.core.$ZodTypeInternals<TipTapNode, unknown>>;
-}, z.core.$strip>]>;
+}): z.ZodType<RichTextDoc, unknown, z.core.$ZodTypeInternals<RichTextDoc, unknown>>;

package/dist/_dts/blocks/src/system/manifest/schema.d.ts

@@ -11,6 +11,7 @@ export declare const MEDIA_KINDS: readonly ["image", "video", "audio", "document
 export type MediaKind = (typeof MEDIA_KINDS)[number];
 export declare const DISPLAY_MEDIA_KINDS: readonly ["image", "video", "audio"];
 export type DisplayMediaKind = (typeof DISPLAY_MEDIA_KINDS)[number];
+export declare const DEFAULT_MEDIA_FIELD_KINDS: readonly ["image"];
 export declare const PUBLIC_FILE_FIELD_KINDS: readonly ["document", "spreadsheet", "archive", "audio"];
 export type FileFieldKind = (typeof PUBLIC_FILE_FIELD_KINDS)[number];
 export declare const siteOptionSources: readonly ["eventCategories", "venues", "staffMembers"];

package/dist/_dts/blocks/src/system/manifest/validation.d.ts

@@ -20,4 +20,10 @@ type ValidatorOptions = {
 };
 export declare function deriveContentZodFromManifest(manifestOrFields: BlockManifest | FieldDefinition[], options?: ValidatorOptions): z.ZodObject<FieldShape>;
 export declare function createManifestValidator(manifestOrFields: BlockManifest | FieldDefinition[], options?: ValidatorOptions): z.ZodType<Record<string, unknown>>;
+/**
+ * Validates content at a persistence boundary and returns identifier-only media
+ * values. Render-time validation intentionally uses createManifestValidator so
+ * hydrated projection fields remain available to renderers.
+ */
+export declare function createManifestWriteValidator(manifestOrFields: BlockManifest | FieldDefinition[], options?: ValidatorOptions): z.ZodType<Record<string, unknown>>;
 export {};

package/dist/_dts/blocks/src/system/node/schema.d.ts

@@ -9,8 +9,8 @@ export declare const bindingSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     pick: z.ZodDefault<z.ZodEnum<{
         value: "value";
-        collection: "collection";
         context: "context";
+        collection: "collection";
     }>>;
     coerce: z.ZodOptional<z.ZodEnum<{
         string: "string";
@@ -29,8 +29,8 @@ export declare const repeatSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         pick: z.ZodDefault<z.ZodEnum<{
             value: "value";
-            collection: "collection";
             context: "context";
+            collection: "collection";
         }>>;
         coerce: z.ZodOptional<z.ZodEnum<{
             string: "string";
@@ -67,8 +67,8 @@ export declare const conditionSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         pick: z.ZodDefault<z.ZodEnum<{
             value: "value";
-            collection: "collection";
             context: "context";
+            collection: "collection";
         }>>;
         coerce: z.ZodOptional<z.ZodEnum<{
             string: "string";
@@ -97,8 +97,8 @@ export declare const dataScopeSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         pick: z.ZodDefault<z.ZodEnum<{
             value: "value";
-            collection: "collection";
             context: "context";
+            collection: "collection";
         }>>;
         coerce: z.ZodOptional<z.ZodEnum<{
             string: "string";

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

@@ -2090,7 +2090,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 waitlistMessage?: string;
                 membershipMessage?: string;
                 buttonText?: string | null;
-                buttonVariant?: "primary" | "secondary" | "outline";
+                buttonVariant?: import("../../..").BlockButtonRole;
                 stage?: "preview" | "published";
             }>) => Readonly<{
                 display: Readonly<{
@@ -2124,7 +2124,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         waitlistMessage?: string;
                         membershipMessage?: string;
                         buttonText?: string | null;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         stage?: "preview" | "published";
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2148,7 +2148,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         waitlistMessage?: string;
                         membershipMessage?: string;
                         buttonText?: string | null;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         stage?: "preview" | "published";
                     }>>;
                 }>;
@@ -2200,7 +2200,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     waitlistMessage?: string;
                     membershipMessage?: string;
                     buttonText?: string | null;
-                    buttonVariant?: "primary" | "secondary" | "outline";
+                    buttonVariant?: import("../../..").BlockButtonRole;
                     stage?: "preview" | "published";
                 }>) => Readonly<{
                     display: Readonly<{
@@ -2234,7 +2234,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             waitlistMessage?: string;
                             membershipMessage?: string;
                             buttonText?: string | null;
-                            buttonVariant?: "primary" | "secondary" | "outline";
+                            buttonVariant?: import("../../..").BlockButtonRole;
                             stage?: "preview" | "published";
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2258,7 +2258,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             waitlistMessage?: string;
                             membershipMessage?: string;
                             buttonText?: string | null;
-                            buttonVariant?: "primary" | "secondary" | "outline";
+                            buttonVariant?: import("../../..").BlockButtonRole;
                             stage?: "preview" | "published";
                         }>>;
                     }>;
@@ -2445,7 +2445,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 showCapacity?: boolean;
                 successMessage?: string;
                 waitlistMessage?: string;
-                buttonVariant?: "primary" | "secondary" | "outline";
+                buttonVariant?: import("../../..").BlockButtonRole;
                 overlayEnabled?: boolean;
                 spamProtectionEnabled?: boolean;
                 stage?: "preview" | "published";
@@ -2490,7 +2490,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         showCapacity?: boolean;
                         successMessage?: string;
                         waitlistMessage?: string;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         overlayEnabled?: boolean;
                         spamProtectionEnabled?: boolean;
                         stage?: "preview" | "published";
@@ -2522,7 +2522,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         showCapacity?: boolean;
                         successMessage?: string;
                         waitlistMessage?: string;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         overlayEnabled?: boolean;
                         spamProtectionEnabled?: boolean;
                         stage?: "preview" | "published";
@@ -2588,7 +2588,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     showCapacity?: boolean;
                     successMessage?: string;
                     waitlistMessage?: string;
-                    buttonVariant?: "primary" | "secondary" | "outline";
+                    buttonVariant?: import("../../..").BlockButtonRole;
                     overlayEnabled?: boolean;
                     spamProtectionEnabled?: boolean;
                     stage?: "preview" | "published";
@@ -2633,7 +2633,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             showCapacity?: boolean;
                             successMessage?: string;
                             waitlistMessage?: string;
-                            buttonVariant?: "primary" | "secondary" | "outline";
+                            buttonVariant?: import("../../..").BlockButtonRole;
                             overlayEnabled?: boolean;
                             spamProtectionEnabled?: boolean;
                             stage?: "preview" | "published";
@@ -2665,7 +2665,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             showCapacity?: boolean;
                             successMessage?: string;
                             waitlistMessage?: string;
-                            buttonVariant?: "primary" | "secondary" | "outline";
+                            buttonVariant?: import("../../..").BlockButtonRole;
                             overlayEnabled?: boolean;
                             spamProtectionEnabled?: boolean;
                             stage?: "preview" | "published";
@@ -2747,7 +2747,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     passes: readonly import("../..").PublicPassProduct[];
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
-                    buttonVariant: "primary" | "secondary" | "outline" | "link";
+                    buttonVariant: import("../../..").BlockButtonRole;
                 }>;
             }>;
             contracts: Readonly<{
@@ -2789,7 +2789,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
-                            buttonVariant: "primary" | "secondary" | "outline" | "link";
+                            buttonVariant: import("../../..").BlockButtonRole;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2825,7 +2825,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
-                            buttonVariant: "primary" | "secondary" | "outline" | "link";
+                            buttonVariant: import("../../..").BlockButtonRole;
                         }>;
                     }>>;
                 }>;
@@ -2869,7 +2869,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         passes: readonly import("../..").PublicPassProduct[];
                         memberships: readonly import("../..").PublicMembershipProduct[];
                         passPurchaseMode: "add_to_cart" | "buy_now";
-                        buttonVariant: "primary" | "secondary" | "outline" | "link";
+                        buttonVariant: import("../../..").BlockButtonRole;
                     }>;
                 }>;
                 contracts: Readonly<{
@@ -2911,7 +2911,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 passes: readonly import("../..").PublicPassProduct[];
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                                 passPurchaseMode: "add_to_cart" | "buy_now";
-                                buttonVariant: "primary" | "secondary" | "outline" | "link";
+                                buttonVariant: import("../../..").BlockButtonRole;
                             }>;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2947,7 +2947,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 passes: readonly import("../..").PublicPassProduct[];
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                                 passPurchaseMode: "add_to_cart" | "buy_now";
-                                buttonVariant: "primary" | "secondary" | "outline" | "link";
+                                buttonVariant: import("../../..").BlockButtonRole;
                             }>;
                         }>>;
                     }>;

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

@@ -1056,7 +1056,7 @@ export declare const runtimeBackedBlockServerEntries: {
                 waitlistMessage?: string;
                 membershipMessage?: string;
                 buttonText?: string | null;
-                buttonVariant?: "primary" | "secondary" | "outline";
+                buttonVariant?: import("../../..").BlockButtonRole;
                 stage?: "preview" | "published";
             }>) => Readonly<{
                 display: Readonly<{
@@ -1090,7 +1090,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         waitlistMessage?: string;
                         membershipMessage?: string;
                         buttonText?: string | null;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         stage?: "preview" | "published";
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1114,7 +1114,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         waitlistMessage?: string;
                         membershipMessage?: string;
                         buttonText?: string | null;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         stage?: "preview" | "published";
                     }>>;
                 }>;
@@ -1232,7 +1232,7 @@ export declare const runtimeBackedBlockServerEntries: {
                 showCapacity?: boolean;
                 successMessage?: string;
                 waitlistMessage?: string;
-                buttonVariant?: "primary" | "secondary" | "outline";
+                buttonVariant?: import("../../..").BlockButtonRole;
                 overlayEnabled?: boolean;
                 spamProtectionEnabled?: boolean;
                 stage?: "preview" | "published";
@@ -1277,7 +1277,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         showCapacity?: boolean;
                         successMessage?: string;
                         waitlistMessage?: string;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         overlayEnabled?: boolean;
                         spamProtectionEnabled?: boolean;
                         stage?: "preview" | "published";
@@ -1309,7 +1309,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         showCapacity?: boolean;
                         successMessage?: string;
                         waitlistMessage?: string;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         overlayEnabled?: boolean;
                         spamProtectionEnabled?: boolean;
                         stage?: "preview" | "published";
@@ -1389,7 +1389,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     passes: readonly import("../..").PublicPassProduct[];
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
-                    buttonVariant: "primary" | "secondary" | "outline" | "link";
+                    buttonVariant: import("../../..").BlockButtonRole;
                 }>;
             }>;
             contracts: Readonly<{
@@ -1431,7 +1431,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
-                            buttonVariant: "primary" | "secondary" | "outline" | "link";
+                            buttonVariant: import("../../..").BlockButtonRole;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1467,7 +1467,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
-                            buttonVariant: "primary" | "secondary" | "outline" | "link";
+                            buttonVariant: import("../../..").BlockButtonRole;
                         }>;
                     }>>;
                 }>;

package/dist/_dts/blocks/src/system/runtime/hooks/useHeadlessWholeSeriesRegistrationFlow.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import { type BlockApiConfig } from '../api';
+import type { CourseRegistrationClientProps } from '../nodes/course-registration/types';
+import { useCourseRegistrationWizard } from '../nodes/course-registration/useCourseRegistrationWizard';
+import type { HeadlessWholeSeriesRegistrationFlow, WholeSeriesRegistrationRunInput } from '../nodes/course-registration/whole-series-registration.headless.contract';
+export type { BlockApiConfig };
+export type { HeadlessWholeSeriesRegistrationFlow, WholeSeriesRegistrationAvailabilityModel, WholeSeriesRegistrationFlowActionResult, WholeSeriesRegistrationFlowActions, WholeSeriesRegistrationFlowStatus, WholeSeriesRegistrationFlowStep, WholeSeriesRegistrationFlowStepId, WholeSeriesRegistrationFlowView, WholeSeriesRegistrationPaymentModel, WholeSeriesRegistrationPaymentSelection, WholeSeriesRegistrationPricingInput, WholeSeriesRegistrationPricingModel, WholeSeriesRegistrationPricingOptionInput, WholeSeriesRegistrationRun, WholeSeriesRegistrationRunInput, WholeSeriesRegistrationRunsModel, WholeSeriesRegistrationSpamProtectionModel, WholeSeriesRegistrationWaitlistClaimModel, } from '../nodes/course-registration/whole-series-registration.headless.contract';
+export type HeadlessWholeSeriesRegistrationFlowOptions = Readonly<{
+    runs?: readonly WholeSeriesRegistrationRunInput[];
+    contentEntry?: CourseRegistrationClientProps['contentEntry'];
+    subject?: CourseRegistrationClientProps['subject'];
+}>;
+export type HeadlessWholeSeriesRegistrationProviderProps = Readonly<{
+    config: BlockApiConfig;
+    children?: React.ReactNode;
+}>;
+export type WholeSeriesRegistrationControllerDeps = Readonly<{
+    useCourseRegistrationWizard: typeof useCourseRegistrationWizard;
+}>;
+export declare function createWholeSeriesRegistrationBlockApiConfig(input: Readonly<{
+    siteId: string;
+    apiBaseUrl: string;
+    portalToken?: string | null;
+    previewToken?: string | null;
+    stage?: 'preview' | 'published';
+}>): BlockApiConfig;
+export declare function HeadlessWholeSeriesRegistrationProvider({ config, children, }: HeadlessWholeSeriesRegistrationProviderProps): React.ReactElement;
+export declare function useHeadlessWholeSeriesRegistrationFlow(options: HeadlessWholeSeriesRegistrationFlowOptions): HeadlessWholeSeriesRegistrationFlow;
+export declare function useWholeSeriesRegistrationControllerWithDeps(options: HeadlessWholeSeriesRegistrationFlowOptions, deps: WholeSeriesRegistrationControllerDeps): HeadlessWholeSeriesRegistrationFlow;

package/dist/_dts/blocks/src/system/runtime/nodes/basic.d.ts

@@ -1,6 +1,5 @@
 import React from 'react';
 import { type ButtonSizeName } from '../../../../../theme-core/src/buttons/index';
-import { type ButtonAffordance } from './buttonAffordance';
 import type { PreviewLinkedEntryFieldBinding } from '../../data';
 export type TextNodeProps = {
     value?: unknown;
@@ -52,17 +51,9 @@ export type ButtonNodeProps = {
     linkRequired?: boolean;
     /**
      * Optional trailing affordance icon (a registry icon id, e.g. `'ArrowRight'`)
-     * rendered after the label. Overrides any personality-supplied affordance.
+     * rendered after the label. Overrides any theme-owned affordance.
      */
     trailingIcon?: string;
-    /** Optional palette token for the trailing icon colour (e.g. `'accent'`). */
-    trailingIconColorToken?: string;
-    /**
-     * Personality/variant affordance default, supplied by the theme so a variant
-     * can carry a trailing icon without per-node authoring. Node-level
-     * `trailingIcon` takes precedence.
-     */
-    personalityAffordance?: ButtonAffordance;
 };
 export declare const ButtonNode: React.FC<ButtonNodeProps & {
     blockId?: string;

package/dist/_dts/blocks/src/system/runtime/nodes/buttonAffordance.d.ts

@@ -1,33 +1,17 @@
 /**
- * Pure resolution of a button's trailing affordance icon.
+ * Pure normalization of a button node's authored trailing icon.
  *
- * A button can acquire a trailing icon from two places:
- *   1. The node itself (`trailingIcon` / `trailingIconColorToken` props).
- *   2. The active button personality/variant (`affordance`), supplied by the
- *      theme so a variant carries an affordance without per-node authoring.
- *
- * Node-level wins over the personality default. When neither supplies one, the
- * button renders no trailing icon (and the personality's CSS `::after`
- * affordance, if any, is left to show through).
+ * Theme-owned affordances render through canonical button CSS and `currentColor`;
+ * they are not duplicated as a second runtime colour contract.
  */
-export type ButtonAffordance = {
+export type ResolvedButtonAffordance = {
     iconId: string;
-    colorToken?: string;
 };
 export type ResolveButtonAffordanceInput = {
     /** Node-level icon id (e.g. `'ArrowRight'`). Highest priority. */
     trailingIcon?: string | null;
-    /** Node-level colour token for the node icon. */
-    trailingIconColorToken?: string | null;
-    /** Personality/variant affordance default (theme-supplied). */
-    personalityAffordance?: ButtonAffordance | null;
-};
-export type ResolvedButtonAffordance = ButtonAffordance & {
-    /** Where the affordance came from — useful for suppression decisions and tests. */
-    source: 'node' | 'personality';
 };
 /**
- * Resolve the trailing affordance a button should render. Node overrides
- * personality; returns `null` when nothing is configured.
+ * Resolve the node-authored trailing affordance, or `null` when no icon exists.
  */
 export declare function resolveButtonAffordance(input: ResolveButtonAffordanceInput): ResolvedButtonAffordance | null;

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/ErrorStep.d.ts

@@ -2,13 +2,14 @@
  * Error terminal state component.
  * Shows error message with retry option.
  */
+import type { BlockButtonRole } from '../../../constants/buttonRoles';
 type ErrorStepProps = {
     /** Error message to display */
     message: string;
     /** Button text */
     buttonText?: string;
     /** Button style variant */
-    buttonVariant?: 'primary' | 'secondary' | 'outline';
+    buttonVariant?: BlockButtonRole;
     /** Callback when retry is clicked */
     onRetry: () => void;
 };

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/PaymentFailedStep.d.ts

@@ -2,13 +2,14 @@
  * Payment failed terminal state component.
  * Shows when payment could not be processed.
  */
+import type { BlockButtonRole } from '../../../constants/buttonRoles';
 type PaymentFailedStepProps = {
     /** Error message to display */
     message?: string;
     /** Button text */
     buttonText?: string;
     /** Button style variant */
-    buttonVariant?: 'primary' | 'secondary' | 'outline';
+    buttonVariant?: BlockButtonRole;
     /** Callback when retry is clicked */
     onRetry: () => void;
 };

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/VerifyingTimeoutStep.d.ts

@@ -2,11 +2,12 @@
  * Verifying timeout terminal state component.
  * Shows when payment verification takes too long.
  */
+import type { BlockButtonRole } from '../../../constants/buttonRoles';
 type VerifyingTimeoutStepProps = {
     /** Button text */
     buttonText?: string;
     /** Button style variant */
-    buttonVariant?: 'primary' | 'secondary' | 'outline';
+    buttonVariant?: BlockButtonRole;
     /** Callback when check again is clicked */
     onCheckAgain: () => void;
     /** Optional support email to display */

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/types.d.ts

@@ -29,6 +29,20 @@ export type EnrollmentResult = {
     waitlistPosition?: number;
     usedMembership?: boolean;
 };
+export type CourseRegistrationWizardActionResult = Readonly<{
+    kind: 'state-updated';
+}> | Readonly<{
+    kind: 'checkout-redirect';
+    checkoutUrl: string;
+}> | Readonly<{
+    kind: 'validation-failed';
+}> | Readonly<{
+    kind: 'blocked';
+    message: string;
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}>;
 /**
  * Content entry context from CMS
  */
@@ -105,3 +119,10 @@ export interface CourseRegistrationClientProps extends CourseRegistrationBasePro
     /** @deprecated Stage is now controlled by BlockApiProvider's isPreview config */
     stage?: 'preview' | 'published';
 }
+export type CourseRegistrationWizardOptions = Readonly<{
+    /**
+     * Receives checkout destinations for headless consumers. The default UI
+     * navigates automatically when this callback is absent.
+     */
+    onCheckoutRedirect?: (checkoutUrl: string) => void;
+}>;