@riverbankcms/sdk 0.96.0 → 0.99.0

package/dist/_dts/blocks/src/PageRenderer.d.ts

@@ -50,6 +50,8 @@ type PageRendererDataContext = {
     occurrenceContext?: OccurrenceContextData | null;
     entrySubrouteContext?: EntrySubrouteContextData | null;
     contentEntry?: Record<string, unknown> | null;
+    pageSurface?: Record<string, unknown> | null;
+    subject?: unknown;
     editableRouteMetadataFieldIds?: ReadonlyArray<string> | null;
     supabaseUrl?: string;
     mediaAssets?: readonly MediaAssetIndexItem[];
@@ -104,6 +106,10 @@ export type BlockOverrideProps<TContent = Record<string, unknown>> = {
     entrySubrouteContext?: EntrySubrouteContextData | null;
     /** Content entry context for template-aware block overrides. */
     contentEntry?: Record<string, unknown> | null;
+    /** Native page-surface context for template-aware block overrides. */
+    pageSurface?: Record<string, unknown> | null;
+    /** Subject descriptor for native page-surface block overrides. */
+    subject?: unknown;
     /** Supabase project URL (useful for media URL resolution in override components) */
     supabaseUrl?: string;
     /** Full image-resolution context including canonical media sidecars. */
@@ -172,6 +178,7 @@ interface PageRendererProps {
     blockOverrides?: BlockOverrides;
     sdkConfig?: SdkConfigForRenderer | null;
     customBlocks?: SdkCustomBlock[];
+    previewAuthoring?: ResolverContext['previewAuthoring'];
 }
-export default function PageRenderer({ theme, page, usePlaceholders, dataContext, wrapBlock, registry, themeTokens: providedThemeTokens, routeMap, blockOverrides, sdkConfig, customBlocks, }: PageRendererProps): React.JSX.Element;
+export default function PageRenderer({ theme, page, usePlaceholders, dataContext, wrapBlock, registry, themeTokens: providedThemeTokens, routeMap, blockOverrides, sdkConfig, customBlocks, previewAuthoring, }: PageRendererProps): React.JSX.Element;
 export {};

package/dist/_dts/blocks/src/bindings/types.d.ts

@@ -49,10 +49,6 @@ export type BindingContext<TFields extends Record<string, unknown> = Record<stri
 };
 /**
  * Available transform function names.
- *
- * Keep in sync with:
- * - @riverbankcms/sdk `BINDING_TRANSFORMS`
- * - @riverbankcms/content-model `TEMPLATE_BINDING_TRANSFORMS`
  */
 export declare const TRANSFORMS: {
     readonly RICHTEXT_FIRST_PARAGRAPH: "richtext.firstParagraph";

package/dist/_dts/blocks/src/client/site-chrome.d.ts

@@ -1,5 +1,7 @@
 import type { ReactNode } from 'react';
+import { buildThemeRuntime as buildThemeRuntimeImpl } from '../../../theme-core/src/runtime/buildThemeRuntime';
 import type { Theme } from '../../../theme-core/src/schema';
+import { renderBlock as renderBlockImpl } from '../system/componentFactory';
 export type SiteChromeThemeConfigOverride = Readonly<{
     header?: Partial<NonNullable<Theme['header']>>;
     footer?: Partial<NonNullable<Theme['footer']>>;
@@ -16,6 +18,11 @@ export type SiteChromeRenderModel = Readonly<{
 }>;
 export type SiteChromeBlockRenderOptions = Readonly<{
     themeConfigOverrideMode?: 'apply' | 'ignore';
+    deps?: SiteChromeBlockRenderDeps;
+}>;
+export type SiteChromeBlockRenderDeps = Readonly<{
+    buildThemeRuntime: typeof buildThemeRuntimeImpl;
+    renderBlock: typeof renderBlockImpl;
 }>;
 export declare function renderSiteChromeBlock(model: SiteChromeRenderModel, surface: 'header' | 'footer', theme: Theme, options?: SiteChromeBlockRenderOptions): ReactNode;
 export declare function SiteChromeBlockRenderer({ model, surface, theme, }: {

package/dist/_dts/blocks/src/contracts/index.d.ts

@@ -1,5 +1,6 @@
 export type { AnyBlockRuntimeDefinition, BlockRenderKind, BlockRuntimeDefinition, ClientOwnedBlockRuntime, Codec, DecodeIssue, DecodeResult, InteractiveBlockRenderKind, InteractiveBlockRuntime, InteractiveRuntimeContracts, ProgressiveBlockRender, ProgressiveBlockRuntime, RuntimeContractsFor, RuntimeDisplay, RuntimeHydration, RuntimeKind, RuntimeRender, RuntimeSource, StaticBlockRuntime, StaticRuntimeContracts, } from './runtime';
 export type { InteractiveIslandProps } from './islands';
+export type { PublicEvent } from '../system/blocks/events/shared/types';
 export type { AccordionIslandProps, CarouselIslandProps, EventDetailsContentEntry, EventDetailsIslandProps, EventDetailsOccurrenceContext, HeaderSectionIslandProps, LocationMapIslandProps, } from './non-block-islands';
 export type { BookingFormConfig, BookingFormDisplay, BookingFormHydration, BookingFormInteractiveIslandProps, BookingFormService, CourseRegistrationDisplay, CourseRegistrationHydration, CourseRegistrationInteractiveIslandProps, CartDisplay, CartHydration, CartInteractiveIslandProps, CartLineDisplay, CheckoutDisplay, CheckoutHydration, CheckoutInteractiveIslandProps, EventCalendarDisplay, EventCalendarHydration, EventCalendarInteractiveIslandProps, EventCombinedDisplay, EventCombinedHydration, EventCombinedInteractiveIslandProps, EventRegistrationDisplay, EventRegistrationHydration, EventRegistrationInteractiveIslandProps, EventListingDisplay, EventListingHydration, EventListingInteractiveIslandProps, FormDisplay, FormHydration, FormInteractiveIslandProps, MembershipCardDisplay, NewsletterFormDisplay, NewsletterFormHydration, NewsletterFormInteractiveIslandProps, PassCardDisplay, PassesMembershipsDisplay, PassesMembershipsHydration, ProductCardDisplay, ProductDetailDisplay, ProductDetailInteractiveIslandProps, ProductDetailHydration, ProductListDisplay, ProductListInteractiveIslandProps, ProductListHydration, ProductVariantOptionDisplay, ShopInteractiveIslandProps, } from './proof-block-islands';
 export { accordionIslandPropsCodec, carouselIslandPropsCodec, eventDetailsIslandPropsCodec, headerSectionIslandPropsCodec, locationMapIslandPropsCodec, } from './non-block-islands';

package/dist/_dts/blocks/src/contracts/proof-block-islands.d.ts

@@ -359,7 +359,7 @@ export declare const proofBlockIslandCodecs: {
                     showMap: boolean;
                     showCapacity: boolean;
                     orientation: import("..").CardOrientation;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                 }>;
                 hydration: Readonly<{
                     siteId: string;
@@ -405,7 +405,7 @@ export declare const proofBlockIslandCodecs: {
                     showMap: boolean;
                     showCapacity: boolean;
                     orientation: import("..").CardOrientation;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                 }>;
                 hydration: Readonly<{
                     siteId: string;
@@ -442,7 +442,7 @@ export declare const proofBlockIslandCodecs: {
                     kind: "event-calendar";
                     displayMode: import("..").DisplayMode;
                     className: string | null;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                     listLayout: import("..").EventLayout;
                     listColumns: import("..").ColumnOption;
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
@@ -492,7 +492,7 @@ export declare const proofBlockIslandCodecs: {
                     kind: "event-calendar";
                     displayMode: import("..").DisplayMode;
                     className: string | null;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                     listLayout: import("..").EventLayout;
                     listColumns: import("..").ColumnOption;
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
@@ -993,7 +993,7 @@ export declare const runtimeIslandCodecs: {
                 display: Readonly<{
                     kind: "event-combined";
                     className: string | null;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                     listLayout: import("..").EventLayout;
                     listColumns: import("..").ColumnOption;
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
@@ -1042,7 +1042,7 @@ export declare const runtimeIslandCodecs: {
                 display: Readonly<{
                     kind: "event-combined";
                     className: string | null;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                     listLayout: import("..").EventLayout;
                     listColumns: import("..").ColumnOption;
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
@@ -1429,7 +1429,7 @@ export declare const runtimeIslandCodecs: {
                     showMap: boolean;
                     showCapacity: boolean;
                     orientation: import("..").CardOrientation;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                 }>;
                 hydration: Readonly<{
                     siteId: string;
@@ -1475,7 +1475,7 @@ export declare const runtimeIslandCodecs: {
                     showMap: boolean;
                     showCapacity: boolean;
                     orientation: import("..").CardOrientation;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                 }>;
                 hydration: Readonly<{
                     siteId: string;
@@ -1512,7 +1512,7 @@ export declare const runtimeIslandCodecs: {
                     kind: "event-calendar";
                     displayMode: import("..").DisplayMode;
                     className: string | null;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                     listLayout: import("..").EventLayout;
                     listColumns: import("..").ColumnOption;
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
@@ -1562,7 +1562,7 @@ export declare const runtimeIslandCodecs: {
                     kind: "event-calendar";
                     displayMode: import("..").DisplayMode;
                     className: string | null;
-                    events: readonly import("..").PublicEvent[];
+                    events: readonly import(".").PublicEvent[];
                     listLayout: import("..").EventLayout;
                     listColumns: import("..").ColumnOption;
                     eventsPerPage: import("../system/runtime/nodes/events/shared/listOptions").EventPageSize;
@@ -2100,7 +2100,7 @@ export declare const runtimeIslandCodecs: {
                 slug: string;
                 contentTypeSlug: string;
             }> | null;
-            events?: readonly import("..").PublicEvent[] | null;
+            events?: readonly import(".").PublicEvent[] | null;
             showVenue?: boolean;
             showMap?: boolean;
             showOtherDates?: boolean;
@@ -2125,7 +2125,7 @@ export declare const runtimeIslandCodecs: {
                 slug: string;
                 contentTypeSlug: string;
             }> | null;
-            events?: readonly import("..").PublicEvent[] | null;
+            events?: readonly import(".").PublicEvent[] | null;
             showVenue?: boolean;
             showMap?: boolean;
             showOtherDates?: boolean;

package/dist/_dts/blocks/src/primitives/content/primitives.d.ts

@@ -8,6 +8,8 @@ export type TextProps = PrimitiveProps & {
     path?: string;
     linkedEntryField?: PreviewLinkedEntryFieldBinding;
     maxLength?: number;
+    placeholder?: string;
+    ariaLabel?: string;
     blockData?: Record<string, unknown> | null;
 };
 export type RichTextPrimitiveProps = {
@@ -17,6 +19,8 @@ export type RichTextPrimitiveProps = {
     linkedEntryField?: PreviewLinkedEntryFieldBinding;
     doc?: TipTapNode | null;
     variant?: RichTextVariant;
+    placeholder?: string;
+    ariaLabel?: string;
     blockData?: Record<string, unknown> | null;
 };
 export type RichTextVariant = "full" | "inline" | "limited" | "media" | "notes";

package/dist/_dts/blocks/src/system/blocks/events/shared/index.d.ts

@@ -5,3 +5,4 @@ export * from './types';
 export * from './schemas';
 export * from './fields';
 export * from './filtering';
+export * from './layout';

package/dist/_dts/blocks/src/system/blocks/events/shared/layout.d.ts

@@ -0,0 +1,2 @@
+import type { NodeDefinition } from '../../../node';
+export declare function eventSectionHeaderLayoutNodes(): readonly NodeDefinition[];

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

@@ -36,6 +36,7 @@ export * from "./feature-cards";
 export * from "./feature-card-icons";
 export * from "./media-text";
 export * from "./appointment-booking";
+export * from "./weekly-slot-availability";
 export * from "./event-registration";
 export * from "./event-details";
 export * from "./course-registration";

package/dist/_dts/blocks/src/system/blocks/weekly-slot-availability.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import type { SystemBlockDefinition } from "../registry";
+import { type SectionStylesContent } from "../fields/boxStyles";
+import type { BlockManifest } from "../manifest";
+export declare const weeklySlotAvailabilityManifest: BlockManifest;
+export type WeeklySlotAvailabilityContent = {
+    serviceId: string;
+    resourceId?: string | null;
+    horizonWeeks?: string | null;
+    timezone?: string | null;
+    heading?: string | null;
+    description?: unknown;
+    emptyMessage?: string | null;
+    ctaText?: string | null;
+    ctaUrl?: string | null;
+    _sectionStyles?: SectionStylesContent;
+};
+export declare const weeklySlotAvailabilityDataSchema: z.ZodObject<{
+    slots: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        resourceId: z.ZodString;
+        weekday: z.ZodNumber;
+        weekdayLabel: z.ZodString;
+        startTime: z.ZodString;
+        endTime: z.ZodString;
+        nextDate: z.ZodString;
+        availableWeeks: z.ZodNumber;
+    }, z.core.$strip>>;
+    horizonWeeks: z.ZodNumber;
+    timezone: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+}, z.core.$strip>;
+export declare const weeklySlotAvailabilityBlockDefinition: SystemBlockDefinition<WeeklySlotAvailabilityContent>;

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

@@ -13,6 +13,7 @@ type RenderOptions = {
     data?: Record<string, unknown>;
     pathBase?: string;
     imageResolveContext?: Parameters<typeof resolveTree>[1]["imageResolveContext"];
+    previewAuthoring?: Parameters<typeof resolveTree>[1]["previewAuthoring"];
 };
 /**
  * Resolves the layout definition for a block based on its manifest and content.

package/dist/_dts/blocks/src/system/constants/blockKinds.d.ts

@@ -1,4 +1,4 @@
-export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.contact-newsletter", "block.appointment-booking", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
+export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.contact-newsletter", "block.appointment-booking", "block.weekly-slot-availability", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
 export type SystemBlockKind = (typeof SYSTEM_BLOCK_KINDS)[number];
 export type CustomBlockKind = `custom.${string}`;
 export type BlockKind = SystemBlockKind | CustomBlockKind;

package/dist/_dts/blocks/src/system/customize/facets.d.ts

@@ -27,7 +27,7 @@ export declare const eventCalendarListLayoutFacet: {
     readonly label: "List style";
     readonly values: {
         value: "compact" | "grid" | "stack";
-        label: "Compact" | "Stack" | "Grid";
+        label: "Stack" | "Grid" | "Compact";
     }[];
     readonly defaultValue: "stack";
     readonly target: {
@@ -41,7 +41,7 @@ export declare const systemCustomizeFacetDefinitions: readonly [{
     readonly label: "List style";
     readonly values: {
         value: "compact" | "grid" | "stack";
-        label: "Compact" | "Stack" | "Grid";
+        label: "Stack" | "Grid" | "Compact";
     }[];
     readonly defaultValue: "stack";
     readonly target: {

package/dist/_dts/blocks/src/system/data/loaderEndpoints.d.ts

@@ -1,3 +1,3 @@
-export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices"];
+export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "getPublicEventDetails", "listPublicCourses", "listPublicRouteCandidates", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicWeeklySlotAvailability"];
 export type SupportedLoaderEndpoint = typeof SUPPORTED_LOADER_ENDPOINTS[number];
 export declare function isSupportedLoaderEndpoint(endpoint: string): endpoint is SupportedLoaderEndpoint;

package/dist/_dts/blocks/src/system/data/prefetchBlockData.d.ts

@@ -8,7 +8,8 @@
  * - Frontend: provide internal API client
  * - SDK: provide SDK client with endpoint mapping
  */
-import { type BlockDataLoader } from '../registry';
+import { getBlockDefinition as getSystemBlockDefinition, type BlockDataLoader } from '../registry';
+import { resolveParamsBindings as resolveRuntimeParamsBindings } from '../runtime/bindings';
 import type { PageOutline } from '../../structure/schema';
 import type { ApiClient, PrefetchContext, ResolvedBlockData } from './types';
 export type PrefetchBlockDataOptions = {
@@ -40,6 +41,8 @@ export type PrefetchBlockDataOptions = {
      * @returns Record of data loaders, or undefined if not a custom block
      */
     getCustomBlockLoaders?: (blockKind: string) => Record<string, BlockDataLoader> | undefined;
+    getBlockDefinition?: typeof getSystemBlockDefinition;
+    resolveParamsBindings?: typeof resolveRuntimeParamsBindings;
 };
 /**
  * Core data prefetching logic (framework-agnostic).

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

@@ -1,4 +1,5 @@
 import { type Binding, type NodeDefinition } from './schema';
+import type { ConditionalAuthoringPresence } from './schema';
 import { type NodeProps } from './types';
 export type NodeModifier = (node: NodeDefinition) => NodeDefinition;
 export declare function el(type: string, props?: NodeProps | null, children?: Array<NodeDefinition | null | undefined> | null, ...mods: NodeModifier[]): NodeDefinition;
@@ -46,6 +47,7 @@ export declare function bind(from: string, options?: {
 export declare function when(path: string, options?: {
     equals?: unknown;
     not?: boolean;
+    authoringPresence?: ConditionalAuthoringPresence;
 }): NodeModifier;
 export declare function scopes(entries: Array<{
     name: string;

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

@@ -50,6 +50,13 @@ export declare const repeatSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type RepeatConfig = z.input<typeof repeatSchema>;
+export declare const conditionalAuthoringPresenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"visitor-only">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"recover-empty-when-active">;
+    placeholder: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "kind">;
+export type ConditionalAuthoringPresence = z.input<typeof conditionalAuthoringPresenceSchema>;
 export declare const conditionSchema: z.ZodObject<{
     when: z.ZodObject<{
         from: z.ZodString;
@@ -71,6 +78,12 @@ export declare const conditionSchema: z.ZodObject<{
     }, z.core.$strip>;
     equals: z.ZodOptional<z.ZodUnknown>;
     not: z.ZodDefault<z.ZodBoolean>;
+    authoringPresence: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"visitor-only">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"recover-empty-when-active">;
+        placeholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "kind">>;
 }, z.core.$strip>;
 export type ConditionConfig = z.input<typeof conditionSchema>;
 export declare const dataScopeSchema: z.ZodObject<{

package/dist/_dts/blocks/src/system/node/validation-constants.d.ts

@@ -11,7 +11,7 @@
  * SdkCustomBlock.layout definitions. Node types not in this list
  * will be rejected during validation.
  */
-export declare const ALLOWED_NODE_TYPES: readonly ["div", "figure", "section", "headerSection", "stack", "inline", "grid", "text", "richText", "media", "videoEmbed", "button", "link", "carousel", "accordion", "accordionItem", "form", "booking-form", "event-registration", "event-spotlight", "event-listing", "event-calendar", "offerings-preview", "event-combined", "shop", "product-list", "product-detail", "cart", "checkout", "gifting"];
+export declare const ALLOWED_NODE_TYPES: readonly ["div", "figure", "section", "headerSection", "stack", "inline", "grid", "text", "richText", "media", "videoEmbed", "button", "link", "carousel", "accordion", "accordionItem", "form", "booking-form", "weekly-slot-availability", "event-registration", "event-spotlight", "event-listing", "event-calendar", "offerings-preview", "event-combined", "shop", "product-list", "product-detail", "cart", "checkout", "gifting"];
 export type AllowedNodeType = (typeof ALLOWED_NODE_TYPES)[number];
 /**
  * Valid transform IDs for declarative layouts.

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

@@ -30,6 +30,7 @@ export type SystemBlockComponentProps<TContent = Record<string, unknown>> = {
     editableRouteMetadataFieldIds?: ResolverContext['editableRouteMetadataFieldIds'];
     fragmentRegistry?: ResolverContext['fragmentRegistry'];
     imageResolveContext?: ResolverContext['imageResolveContext'];
+    previewAuthoring?: ResolverContext['previewAuthoring'];
 };
 export type SystemBlockComponent<TContent = Record<string, unknown>> = ComponentType<SystemBlockComponentProps<TContent>>;
 export type BlockDataLoader = {

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

@@ -3,7 +3,7 @@
  *
  * Factory function for creating a typed API client for block client-side API calls.
  */
-import type { BlockApiConfig, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, BookingSubmitRequest, BookingPackageSubmitRequest, BookingSubmitResponse, EligibleAppointmentPackagesResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, AvailableDatesRequest, AvailableDatesResponse, BookingServicesResponse, BookingServiceResponse, BookingResourcesResponse, PublicEventsRequest, PublicEvent, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, EligibilityCheckRequest, EligibilityCheckResponse, EventRegistrationStatusRequest, EventRegistrationStatusResponse, CourseEnrollRequest, CourseEnrollResponse, CourseEligibilityCheckRequest, CourseEligibilityCheckResponse, CourseCheckoutRequest, CourseCheckoutResponse, CourseRegistrationStatusRequest, CourseRegistrationStatusResponse, ResolveWaitlistClaimRequest, ResolveWaitlistClaimResponse, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyRequest, DiscountApplyResponse, PublicProductsResponse, ShopCheckoutRequest, ShopCheckoutResponse, UnifiedCheckoutRequest, UnifiedCheckoutResponse, PublicGiftingOffersResponse, CreateGiftingCheckoutRequest, CreateGiftingCheckoutResponse, ClaimGiftCardRequest, ClaimGiftCardResponse, PortalMeResponse, CustomerProfile, CustomerOrder, PortalMeUpdateRequest, CustomerPass, CustomerMembership, CustomerEventRegistration, PortalEventTicket, CustomerAppointment, BookingQuestionsTaskDetail, CustomerCourseEnrollment, PortalCredit, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalDigitalProductsResponse, PortalCancelCourseEnrollmentRequest, PortalCancelCourseEnrollmentResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateCourseBookingQuestionsRequest, PortalUpdateEventBookingQuestionsRequest, PortalCancelEventRegistrationRequest, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, EventGuest, UpdateEventGuestsRequest, NewsletterSubscribeRequest, NewsletterSubscribeResponse } from './types';
+import type { BlockApiConfig, FormSubmitRequest, FormSubmitResponse, FormConfigResponse, BookingSubmitRequest, BookingPackageSubmitRequest, BookingSubmitResponse, EligibleAppointmentPackagesResponse, AppointmentBookingStatusRequest, AppointmentBookingStatusResponse, AvailableSlotsRequest, AvailableSlotsResponse, WeeklySlotAvailabilityRequest, WeeklySlotAvailabilityResponse, AvailableDatesRequest, AvailableDatesResponse, BookingServicesResponse, BookingServiceResponse, BookingResourcesResponse, PublicEventsRequest, PublicEvent, EventFiltersResponse, EventRegisterRequest, EventRegisterResponse, EventCheckoutRequest, EventCheckoutResponse, EligibilityCheckRequest, EligibilityCheckResponse, EventRegistrationStatusRequest, EventRegistrationStatusResponse, CourseEnrollRequest, CourseEnrollResponse, CourseEligibilityCheckRequest, CourseEligibilityCheckResponse, CourseCheckoutRequest, CourseCheckoutResponse, CourseRegistrationStatusRequest, CourseRegistrationStatusResponse, ResolveWaitlistClaimRequest, ResolveWaitlistClaimResponse, DiscountsAvailableRequest, DiscountsAvailableResponse, DiscountApplyRequest, DiscountApplyResponse, PublicProductsResponse, ShopCheckoutRequest, ShopCheckoutResponse, UnifiedCheckoutRequest, UnifiedCheckoutResponse, PublicGiftingOffersResponse, CreateGiftingCheckoutRequest, CreateGiftingCheckoutResponse, ClaimGiftCardRequest, ClaimGiftCardResponse, PortalMeResponse, CustomerProfile, CustomerOrder, PortalMeUpdateRequest, CustomerPass, CustomerMembership, CustomerEventRegistration, PortalEventTicket, CustomerAppointment, BookingQuestionsTaskDetail, CustomerCourseEnrollment, PortalCredit, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalDigitalProductsResponse, PortalCancelCourseEnrollmentRequest, PortalCancelCourseEnrollmentResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalUpdateAppointmentBookingQuestionsRequest, PortalUpdateCourseBookingQuestionsRequest, PortalUpdateEventBookingQuestionsRequest, PortalCancelEventRegistrationRequest, PortalCancelEventRegistrationResult, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCancelMembershipAtPeriodEndResult, MagicLinkRequest, EventGuest, UpdateEventGuestsRequest, NewsletterSubscribeRequest, NewsletterSubscribeResponse } from './types';
 type PublicProductCategorySelector = Readonly<{
     kind: 'category';
     productCategoryId: string;
@@ -33,6 +33,7 @@ export interface BlockApiClient {
     }): Promise<EligibleAppointmentPackagesResponse>;
     getAppointmentBookingStatus(params: Omit<AppointmentBookingStatusRequest, 'siteId'>): Promise<AppointmentBookingStatusResponse>;
     getAvailableSlots(params: Omit<AvailableSlotsRequest, 'siteId'>): Promise<AvailableSlotsResponse>;
+    getWeeklySlotAvailability(params: Omit<WeeklySlotAvailabilityRequest, 'siteId'>): Promise<WeeklySlotAvailabilityResponse>;
     getAvailableDates(params: Omit<AvailableDatesRequest, 'siteId'>): Promise<AvailableDatesResponse>;
     getBookingServices(params?: {
         ids?: string[];

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

@@ -52,6 +52,10 @@ export declare const BOOKINGS: {
         path: string;
         method: "GET";
     };
+    getWeeklySlotAvailability: {
+        path: string;
+        method: "GET";
+    };
     getAvailableDates: {
         path: string;
         method: "GET";
@@ -394,6 +398,10 @@ export declare const ENDPOINTS: {
             path: string;
             method: "GET";
         };
+        getWeeklySlotAvailability: {
+            path: string;
+            method: "GET";
+        };
         getAvailableDates: {
             path: string;
             method: "GET";

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

@@ -192,6 +192,30 @@ export interface TimeSlot {
 export interface AvailableSlotsResponse {
     slots: TimeSlot[];
 }
+export interface WeeklySlotAvailabilityRequest {
+    siteId: string;
+    serviceId: string;
+    resourceId?: string;
+    horizonWeeks?: number;
+    timezone: string;
+}
+export interface WeeklySlotAvailabilityOption {
+    id: string;
+    resourceId: string;
+    weekday: number;
+    weekdayLabel: string;
+    startTime: string;
+    endTime: string;
+    nextDate: string;
+    availableWeeks: number;
+}
+export interface WeeklySlotAvailabilityResponse {
+    slots: WeeklySlotAvailabilityOption[];
+    horizonWeeks: number;
+    timezone: string;
+    startDate: string;
+    endDate: string;
+}
 export interface AvailableDatesRequest {
     siteId: string;
     serviceId: string;

package/dist/_dts/blocks/src/system/runtime/components/booking/DatePicker.d.ts

@@ -1,8 +1,10 @@
 /**
  * DatePicker Component
  *
- * Displays a dropdown for selecting an appointment date from available dates.
- * Supports loading states, empty states, and progressive loading.
+ * Selectable grid of available appointment dates rendered as pill buttons
+ * (weekday / day / month), with loading, empty and progressive-loading
+ * states. Selection uses button-toggle semantics: each pill is a button with
+ * aria-pressed and a full accessible date name, inside a labelled group.
  */
 import React from 'react';
 type DatePickerProps = {
@@ -10,6 +12,8 @@ type DatePickerProps = {
     onChange: (date: string) => void;
     dateOptions: string[];
     required?: boolean;
+    ariaDescribedBy?: string;
+    ariaInvalid?: boolean;
     isLoading?: boolean;
     isEmpty?: boolean;
     hasMore?: boolean;

package/dist/_dts/blocks/src/system/runtime/components/booking/SuccessMessage.d.ts

@@ -1,7 +1,9 @@
 /**
  * SuccessMessage Component
  *
- * Displays success message after successful appointment booking.
+ * Terminal success state after a completed appointment booking.
+ * Rendered on the shared registration-surface (see booking-form.client),
+ * using the shared TerminalPanel + StateIcon primitives.
  */
 import React from 'react';
 type SuccessMessageProps = {

package/dist/_dts/blocks/src/system/runtime/components/booking/TimeSlotSelector.d.ts

@@ -1,16 +1,22 @@
 /**
  * TimeSlotSelector Component
  *
- * Displays available time slots for the selected date with loading and empty states.
+ * Selectable grid of available time slots for the chosen date, rendered as
+ * pill buttons with button-toggle semantics (aria-pressed) inside a labelled
+ * group. The timezone is part of each pill's accessible name via the full
+ * time format; the visible pill shows the compact time.
  */
 import React from 'react';
-import type { TimeSlot } from '../../hooks/useAvailableSlots';
+import type { BookingSlotDisplayOption } from '../../hooks/useHeadlessBookingFlow.state';
 type TimeSlotSelectorProps = {
     value: string;
-    onChange: (slotStartTime: string) => void;
-    slots: TimeSlot[];
+    onChange: (slotKey: string) => void;
+    slots: readonly BookingSlotDisplayOption[];
     isLoading: boolean;
+    timezone: string;
     required?: boolean;
+    ariaDescribedBy?: string;
+    ariaInvalid?: boolean;
 };
 export declare const TimeSlotSelector: React.FC<TimeSlotSelectorProps>;
 export {};

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

@@ -8,6 +8,7 @@ import { AccordionNode, AccordionItemNode } from '../nodes/accordion';
 import HeaderSectionNode from '../nodes/header-section.client';
 import { EventCombinedIslandClient } from '../nodes/events';
 import { MediaNode } from '../nodes/media.client';
+import WeeklySlotAvailabilityClient from '../nodes/weekly-slot-availability.client';
 import { runtimeBackedBlockServerEntries, type RuntimeBackedBlockMode, type RuntimeBackedBlockKind, type RuntimeBackedClientBlockEntry, type RuntimeBackedClientComponentProps } from './runtime-backed-blocks';
 type SourcePropsClientEntry<TProps extends object = object> = Readonly<{
     kind: 'source-props';
@@ -28,6 +29,7 @@ export type ClientComponentRegistryEntryByKind = Readonly<{
     'event-details': ExplicitAdapterClientEntry<React.ComponentProps<typeof EventDetailsIslandClient>>;
     'location-map': ExplicitAdapterClientEntry<React.ComponentProps<typeof LocationMapIslandClient>>;
     'event-combined': ExplicitAdapterClientEntry<React.ComponentProps<typeof EventCombinedIslandClient>>;
+    'weekly-slot-availability': SourcePropsClientEntry<React.ComponentProps<typeof WeeklySlotAvailabilityClient>>;
 }>;
 export type ClientComponentRegistryEntry = ClientComponentRegistryEntryByKind[keyof ClientComponentRegistryEntryByKind];
 export declare function defineSourcePropsClientEntry<TProps extends object>(component: React.ComponentType<TProps>): SourcePropsClientEntry<TProps>;
@@ -2992,6 +2994,10 @@ export declare const clientComponentRegistryEntries: {
         }>>;
         produces: "client-props" | "island-props";
     }>;
+    readonly 'weekly-slot-availability': Readonly<{
+        kind: "source-props";
+        component: React.ComponentType<import("../nodes/weekly-slot-availability.client").WeeklySlotAvailabilityClientProps>;
+    }>;
 };
 export declare const clientComponentRegistry: ComponentRegistry;
 export {};

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

@@ -1,4 +1,6 @@
+import { useBlockApi } from "../api";
 import { type AppointmentCheckoutVerificationState } from "../nodes/booking-form.state";
+import { usePolling } from "./usePolling";
 export type AppointmentCheckoutVerificationConfig = {
     sessionId: string;
     maxAttempts?: number;
@@ -8,4 +10,9 @@ export type AppointmentCheckoutVerificationResult = {
     state: AppointmentCheckoutVerificationState;
     retry: () => void;
 };
+export type AppointmentCheckoutVerificationDeps = Readonly<{
+    useBlockApi: typeof useBlockApi;
+    usePolling: typeof usePolling;
+}>;
 export declare function useAppointmentCheckoutVerification(config: AppointmentCheckoutVerificationConfig | null): AppointmentCheckoutVerificationResult;
+export declare function useAppointmentCheckoutVerificationWithDeps(config: AppointmentCheckoutVerificationConfig | null, deps: AppointmentCheckoutVerificationDeps): AppointmentCheckoutVerificationResult;

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

@@ -6,14 +6,14 @@
  */
 import { type TimeSlot } from "../api";
 export type { TimeSlot };
-type UseAvailableSlotsOptions = {
+export type UseAvailableSlotsOptions = {
     siteId: string;
     serviceId: string | undefined;
     resourceId: string | undefined;
     selectedDate: string;
     timezone: string;
 };
-type UseAvailableSlotsResult = {
+export type UseAvailableSlotsResult = {
     slots: TimeSlot[];
     isLoading: boolean;
     isRefreshing: boolean;

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

@@ -1,3 +1,3 @@
-export { unsafeAsBookingFieldId, bookingFlowReducer, buildBookingAvailabilityQuery, buildBookingStepPlan, buildBookingSubmitPlan, createBookingBlockApiConfig, createEmptyBookingValidationErrors, createFieldBookingValidationErrors, createFormBookingValidationError, createInitialBookingFlowReducerState, describeUnknownError, deriveBookingFieldViews, deriveBookingFlowSteps, getAppointmentBookingOverrideInput, hasBookingValidationErrors, resolveAppointmentPackagesModel, resolveAvailabilitySelectionInvalidation, resolveHeadlessBookingStatus, resolveHeadlessBookingView, toBookingFormData, toBookingSlotView, toBookingSlotViews, toOptionalAppointmentResourceId, toOptionalAppointmentServiceId, validateBookingField, validateBookingFields, validateBookingStep, } from "../nodes/booking-form.headless.state";
+export { unsafeAsBookingFieldId, bookingFlowReducer, buildBookingAvailabilityQuery, buildBookingStepPlan, buildBookingSubmitPlan, createBookingBlockApiConfig, createEmptyBookingValidationErrors, createFieldBookingValidationErrors, createFormBookingValidationError, createInitialBookingFlowReducerState, deriveBookingSlotDisplayOptions, describeUnknownError, deriveBookingFieldViews, deriveBookingFlowSteps, getAppointmentBookingOverrideInput, hasBookingValidationErrors, resolveAppointmentPackagesModel, resolveAvailabilitySelectionInvalidation, resolveHeadlessBookingStatus, resolveHeadlessBookingView, toBookingFormData, toBookingSlotView, toBookingSlotViews, toOptionalAppointmentResourceId, toOptionalAppointmentServiceId, validateBookingField, validateBookingFields, validateBookingStep, } from "../nodes/booking-form.headless.state";
 export { formatBookingCentsAsCurrencyInput, getBookingServiceSlidingScale, parseBookingCurrencyInputToCents, } from "../nodes/booking-form.state";
-export type { AppointmentBookingOverrideData, AppointmentBookingOverrideInput, AppointmentBookingOverrideInputResult, AppointmentBookingOverridePropsLike, BookingAvailabilityQuery, BookingAppointmentPackagesModel, BookingAppointmentPackagesUnavailableReason, BookingFieldId, BookingFieldValue, BookingFieldView, BookingFlowActionResult, BookingFlowFeedback, BookingFlowStatus, BookingFlowStep, BookingFlowStepId, BookingFlowView, BookingResourceView, BookingSlotSelection, BookingSlotView, BookingSubmitActionResult, BookingSubmitOptions, BookingValidationErrors, DerivedBookingFlowSteps, DeriveBookingFlowStepsInput, LoadState, } from "../nodes/booking-form.headless.state";
+export type { AppointmentBookingOverrideData, AppointmentBookingOverrideInput, AppointmentBookingOverrideInputResult, AppointmentBookingOverridePropsLike, BookingAvailabilityQuery, BookingAppointmentPackagesModel, BookingAppointmentPackagesUnavailableReason, BookingFieldId, BookingFieldValue, BookingFieldView, BookingFlowActionResult, BookingFlowFeedback, BookingFlowStatus, BookingFlowStep, BookingFlowStepId, BookingFlowView, BookingResourceView, BookingSlotDisplayOption, BookingSlotSelection, BookingSlotView, BookingSubmitActionResult, BookingSubmitOptions, BookingValidationErrors, DerivedBookingFlowSteps, DeriveBookingFlowStepsInput, LoadState, } from "../nodes/booking-form.headless.state";

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

@@ -27,7 +27,11 @@ export type EventRegistrationController = Readonly<{
 export type EventRegistrationWizardController = Readonly<{
     wizard: ReturnType<typeof useEventRegistrationWizard>;
 }>;
+export type EventRegistrationControllerDeps = Readonly<{
+    useEventRegistrationWizard: typeof useEventRegistrationWizard;
+}>;
 export declare function HeadlessEventRegistrationProvider({ config, children, }: HeadlessEventRegistrationProviderProps): React.ReactElement;
 export declare function useHeadlessEventRegistrationFlow(options: HeadlessEventRegistrationFlowOptions): HeadlessEventRegistrationFlow;
 export declare function useEventRegistrationController(options: HeadlessEventRegistrationFlowOptions): EventRegistrationController;
+export declare function useEventRegistrationControllerWithDeps(options: HeadlessEventRegistrationFlowOptions, deps: EventRegistrationControllerDeps): EventRegistrationController;
 export declare function useEventRegistrationWizardController(options: HeadlessEventRegistrationFlowOptions): EventRegistrationWizardController;