@riverbankcms/sdk 0.143.0 → 0.144.0

package/dist/_dts/db/src/schemas/forms.d.ts

@@ -944,10 +944,175 @@ export type FormSlug = string & {
     readonly [formSlugBrand]: 'FormSlug';
 };
 export declare const formSlugSchema: z.ZodPipe<z.ZodString, z.ZodTransform<FormSlug, string>>;
+/**
+ * A form's fields as sent to the Forms API: the generic contract, or the
+ * booking-questions contract (which adds file uploads). Which one a form may
+ * use depends on its type, which the service checks — on update the type
+ * lives on the stored form, not the request.
+ */
+export declare const formPayloadFieldsSchema: z.ZodUnion<readonly [z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    fields: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            date: "date";
+            time: "time";
+            text: "text";
+            email: "email";
+            url: "url";
+            textarea: "textarea";
+            select: "select";
+            checkbox: "checkbox";
+            radio: "radio";
+            tel: "tel";
+            consent: "consent";
+        }>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        helpText: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>>;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        pattern: z.ZodOptional<z.ZodString>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        layout: z.ZodOptional<z.ZodObject<{
+            width: z.ZodDefault<z.ZodEnum<{
+                full: "full";
+                half: "half";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+    version: z.ZodDefault<z.ZodString>;
+    fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        helpText: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strict>>>;
+        multiple: z.ZodOptional<z.ZodBoolean>;
+        minLength: z.ZodOptional<z.ZodNumber>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+        pattern: z.ZodOptional<z.ZodString>;
+        min: z.ZodOptional<z.ZodNumber>;
+        max: z.ZodOptional<z.ZodNumber>;
+        layout: z.ZodOptional<z.ZodObject<{
+            width: z.ZodDefault<z.ZodEnum<{
+                full: "full";
+                half: "half";
+            }>>;
+        }, z.core.$strict>>;
+        type: z.ZodEnum<{
+            number: "number";
+            date: "date";
+            time: "time";
+            text: "text";
+            email: "email";
+            url: "url";
+            textarea: "textarea";
+            select: "select";
+            checkbox: "checkbox";
+            radio: "radio";
+            tel: "tel";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodLiteral<"document_upload">;
+        required: z.ZodDefault<z.ZodBoolean>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        helpText: z.ZodOptional<z.ZodString>;
+        layout: z.ZodOptional<z.ZodObject<{
+            width: z.ZodDefault<z.ZodEnum<{
+                full: "full";
+                half: "half";
+            }>>;
+        }, z.core.$strict>>;
+        allowedFileTypes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            image: "image";
+            pdf: "pdf";
+            docx: "docx";
+        }>>>;
+        maxBytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>], "type">>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<2>;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            helpText: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>>>;
+            multiple: z.ZodOptional<z.ZodBoolean>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            pattern: z.ZodOptional<z.ZodString>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            layout: z.ZodOptional<z.ZodObject<{
+                width: z.ZodDefault<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                }>>;
+            }, z.core.$strict>>;
+            type: z.ZodEnum<{
+                number: "number";
+                date: "date";
+                time: "time";
+                text: "text";
+                email: "email";
+                url: "url";
+                textarea: "textarea";
+                select: "select";
+                checkbox: "checkbox";
+                radio: "radio";
+                tel: "tel";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodLiteral<"document_upload">;
+            required: z.ZodDefault<z.ZodBoolean>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            helpText: z.ZodOptional<z.ZodString>;
+            layout: z.ZodOptional<z.ZodObject<{
+                width: z.ZodDefault<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                }>>;
+            }, z.core.$strict>>;
+            allowedFileTypes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                image: "image";
+                pdf: "pdf";
+                docx: "docx";
+            }>>>;
+            maxBytes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>>;
+}, z.core.$strict>]>]>;
 export declare const createFormPayloadSchema: z.ZodObject<{
     name: z.ZodString;
     slug: z.ZodPipe<z.ZodString, z.ZodTransform<FormSlug, string>>;
-    schema: z.ZodObject<{
+    schema: z.ZodUnion<readonly [z.ZodObject<{
         version: z.ZodDefault<z.ZodString>;
         fields: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -986,7 +1151,126 @@ export declare const createFormPayloadSchema: z.ZodObject<{
                 }>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>;
-    }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodUnion<readonly [z.ZodObject<{
+        version: z.ZodDefault<z.ZodString>;
+        fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            helpText: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodString;
+            }, z.core.$strict>>>;
+            multiple: z.ZodOptional<z.ZodBoolean>;
+            minLength: z.ZodOptional<z.ZodNumber>;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+            pattern: z.ZodOptional<z.ZodString>;
+            min: z.ZodOptional<z.ZodNumber>;
+            max: z.ZodOptional<z.ZodNumber>;
+            layout: z.ZodOptional<z.ZodObject<{
+                width: z.ZodDefault<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                }>>;
+            }, z.core.$strict>>;
+            type: z.ZodEnum<{
+                number: "number";
+                date: "date";
+                time: "time";
+                text: "text";
+                email: "email";
+                url: "url";
+                textarea: "textarea";
+                select: "select";
+                checkbox: "checkbox";
+                radio: "radio";
+                tel: "tel";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodLiteral<"document_upload">;
+            required: z.ZodDefault<z.ZodBoolean>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            helpText: z.ZodOptional<z.ZodString>;
+            layout: z.ZodOptional<z.ZodObject<{
+                width: z.ZodDefault<z.ZodEnum<{
+                    full: "full";
+                    half: "half";
+                }>>;
+            }, z.core.$strict>>;
+            allowedFileTypes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                image: "image";
+                pdf: "pdf";
+                docx: "docx";
+            }>>>;
+            maxBytes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>], "type">>;
+    }, z.core.$strict>, z.ZodObject<{
+        schemaVersion: z.ZodLiteral<2>;
+        sections: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+                placeholder: z.ZodOptional<z.ZodString>;
+                helpText: z.ZodOptional<z.ZodString>;
+                options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    value: z.ZodString;
+                    label: z.ZodString;
+                }, z.core.$strict>>>;
+                multiple: z.ZodOptional<z.ZodBoolean>;
+                minLength: z.ZodOptional<z.ZodNumber>;
+                maxLength: z.ZodOptional<z.ZodNumber>;
+                pattern: z.ZodOptional<z.ZodString>;
+                min: z.ZodOptional<z.ZodNumber>;
+                max: z.ZodOptional<z.ZodNumber>;
+                layout: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodDefault<z.ZodEnum<{
+                        full: "full";
+                        half: "half";
+                    }>>;
+                }, z.core.$strict>>;
+                type: z.ZodEnum<{
+                    number: "number";
+                    date: "date";
+                    time: "time";
+                    text: "text";
+                    email: "email";
+                    url: "url";
+                    textarea: "textarea";
+                    select: "select";
+                    checkbox: "checkbox";
+                    radio: "radio";
+                    tel: "tel";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                type: z.ZodLiteral<"document_upload">;
+                required: z.ZodDefault<z.ZodBoolean>;
+                placeholder: z.ZodOptional<z.ZodString>;
+                helpText: z.ZodOptional<z.ZodString>;
+                layout: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodDefault<z.ZodEnum<{
+                        full: "full";
+                        half: "half";
+                    }>>;
+                }, z.core.$strict>>;
+                allowedFileTypes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+                    image: "image";
+                    pdf: "pdf";
+                    docx: "docx";
+                }>>>;
+                maxBytes: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>], "type">>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>]>;
     settings: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"contact">;
         successMessage: z.ZodOptional<z.ZodString>;

package/dist/_dts/editor-blocks/src/block-editor/{BlockCardHeader.d.ts → BlockCardFrame.d.ts}

@@ -1,3 +1,4 @@
+import { type ReactNode } from 'react';
 import type { SyntheticListenerMap } from '@dnd-kit/core/dist/hooks/utilities';
 import type { FieldWidgetComponent } from '../../../block-form/src/index';
 import { type SiteIconStyleGuideVersionId, type SystemBlockDefinition, type Theme } from '../../../blocks/src/index';
@@ -8,11 +9,15 @@ import { type GeneratedIconSetGenerateInput, type GeneratedIconSetGenerateResult
 import { type GeneratedIconApplyState } from './generatedIconApplyCoordination';
 /** Drag listener props from dnd-kit */
 type DragListeners = SyntheticListenerMap | undefined;
-type BlockCardHeaderStore = UiStore<GeneratedIconApplyState & Pick<UiSlice, 'focusRequest' | 'clearFocus'> & {
+type BlockCardFrameStore = UiStore<GeneratedIconApplyState & Pick<UiSlice, 'focusRequest' | 'clearFocus'> & {
     drafts: Pick<DraftsSlice, 'getBlockSnapshot' | 'getCurrentValues' | 'initNewBlock' | 'updateBlockBaseline' | 'clearError' | 'setAtPath' | 'getAtPath'>;
     arrayKeys: ArrayKeysManager;
 }>;
-export declare function BlockCardHeader({ interactionReady, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, }: {
+/**
+ * One block in the block editor: the shared editor item card, with the
+ * block's own actions, dialogs and body.
+ */
+export declare function BlockCardFrame({ interactionReady, block, manifest, isFirst, isLast, isMoving, onMove, onDuplicate, onDelete, dragListeners, canReorder, collapsed, onToggleCollapsed, contentId, uiStore, widgetOverrides, theme, hideThemeV2RawStyleFields, reorderControlMode, actionPresentation, currentStyleGuideVersionId, iconStyleGuideSummary, iconStyleGuideEditHref, onGenerateIconSet, highlighted, children, }: {
     interactionReady: boolean;
     block: BlockItem;
     manifest: SystemBlockDefinition['manifest'];
@@ -27,7 +32,10 @@ export declare function BlockCardHeader({ interactionReady, block, manifest, isF
     collapsed: boolean;
     onToggleCollapsed: () => void;
     contentId?: string;
-    uiStore: BlockCardHeaderStore;
+    highlighted?: boolean;
+    /** The block's body, shown when expanded. */
+    children?: ReactNode;
+    uiStore: BlockCardFrameStore;
     /** Optional widget overrides for block customization form fields */
     widgetOverrides?: Record<string, FieldWidgetComponent>;
     theme?: Theme | null;

package/dist/_dts/logger/src/console.d.ts

@@ -0,0 +1,3 @@
+import type { AppLogger } from './api';
+export declare const logger: AppLogger;
+export type { AppLogger, LogFields } from './api';

package/dist/_dts/sdk/src/client/publicEventReadOperations.d.ts

@@ -6,6 +6,7 @@ type PublicEventReadDeps = Readonly<{
     resilientFetchData: <T>(policyEndpoint: PublicReadEndpoint, cacheKey: string, fetcher: (signal: AbortSignal) => Promise<ApiResult<T>>, options: Readonly<{
         signal?: AbortSignal;
         force?: boolean;
+        preview?: boolean;
     }>) => Promise<T>;
 }>;
 type PublicEventReadOperations = Pick<RiverbankClient, 'resolveEventOccurrence' | 'resolveEventRun' | 'listPublicEventCalendarWindow'>;

package/dist/_dts/sdk/src/client/types.d.ts

@@ -574,12 +574,15 @@ export interface RiverbankClient {
         siteId: string;
         subject: EventPageSurfaceSubjectRefWire;
         segment: string;
+        /** Include draft subroutes; the API still validates preview credentials. */
+        preview?: boolean;
     } & SdkMethodOptions): Promise<ResolveEventOccurrenceResponse>;
     /** Resolve one run slug within a canonical parent Event. */
     resolveEventRun(params: {
         siteId: string;
         subject: EventPageSurfaceSubjectRefWire;
         segment: string;
+        preview?: boolean;
     } & SdkMethodOptions): Promise<ResolveEventRunResponse>;
     /**
      * Check if a path has a configured redirect rule

package/dist/_dts/sdk/src/navigation/index.d.ts

@@ -415,4 +415,31 @@ export declare function resolveNavigationLinkHref(link: LinkPayload | null, rout
  * ```
  */
 export declare function buildLogo(logo: Partial<LogoSource> | null, fallbackAlt: string | null | undefined): Logo;
+/** Both site logos, for chrome that picks one per surface. */
+export type LogoVariants = {
+    forLightBackgrounds: Logo;
+    forDarkBackgrounds: Logo;
+};
+/**
+ * Build both site logos from layout data. The default header and footer choose
+ * between them by the surface they sit on; custom chrome can do the same.
+ *
+ * @example
+ * ```ts
+ * const logoVariants = buildLogoVariants(siteData.layout, siteData.site.title);
+ * ```
+ */
+export declare function buildLogoVariants(layout: Readonly<{
+    logo?: Partial<LogoSource> | null;
+    logoForDarkBackgrounds?: Partial<LogoSource> | null;
+}> | null | undefined, fallbackAlt: string | null | undefined): LogoVariants;
+/**
+ * Header/footer block content for the site logos. `logo` stays populated with
+ * whichever logo exists so presence checks keep working; `logoVariants` is
+ * what the blocks select from at render.
+ */
+export declare function buildChromeLogoContent(layout: Parameters<typeof buildLogoVariants>[0], fallbackAlt: string | null | undefined): {
+    logo: Logo;
+    logoVariants: LogoVariants;
+};
 export type { NavigationMenuWithItems, NavigationItemRecord, LinkPayload } from '../public-api/contracts';

package/dist/_dts/sdk/src/public-api/contracts.d.ts

@@ -184,14 +184,22 @@ export type SiteLayoutSettingsPayload = {
     header: SiteHeaderContent;
     footer: SiteFooterContent;
 };
+export type SiteLayoutLogoPayload = {
+    assetId: string | null;
+    url: string | null;
+    alt: string | null;
+    width?: number | null;
+    height?: number | null;
+};
 export type SiteLayoutResolvedPayload = SiteLayoutSettingsPayload & {
-    logo?: {
-        assetId: string | null;
-        url: string | null;
-        alt: string | null;
-        width?: number | null;
-        height?: number | null;
-    };
+    /** The site logo, designed for light backgrounds. */
+    logo?: SiteLayoutLogoPayload;
+    /**
+     * Optional logo designed for dark backgrounds. The default header and
+     * footer draw it on surfaces whose text colour resolves light. Absent or
+     * null when the site has not set one.
+     */
+    logoForDarkBackgrounds?: SiteLayoutLogoPayload | null;
 };
 export interface SiteAnalyticsCookieBannerCopyOverrides {
     title?: string;

package/dist/_dts/sdk/src/rendering/blocks-page-renderer.d.ts

@@ -44,6 +44,7 @@ export type PageRendererDataContext = {
     apiBaseUrl?: string;
     portalToken?: string | null;
     previewToken?: string | null;
+    readAuthority?: import('../../../blocks/src/api').BrowserReadAuthority;
     eventRegistrationOverlayEnabled?: boolean;
 };
 export type BlocksPageRendererDataContext = Omit<PageRendererDataContext, 'mediaAssets' | 'imageResolveContext'> & {

package/dist/_dts/sdk/src/rendering/client.d.ts

@@ -10,6 +10,7 @@ export type BlockApiAuth = Readonly<{
     type: 'none';
 }>;
 export type BlockApiConfig = Readonly<{
+    readAuthority?: import('../../../blocks/src/api').BrowserReadAuthority;
     baseUrl: string;
     auth: BlockApiAuth;
     siteId?: string;

package/dist/_dts/sdk/src/rendering/components/Block.shared.d.ts

@@ -34,6 +34,7 @@ type BlockCommonProps = {
      * Portal token for customer portal Bearer auth.
      */
     portalToken?: string | null;
+    readAuthority?: import('../../../../blocks/src/api').BrowserReadAuthority;
     /** Route lookup for CMS links inside block content. */
     routeMap?: RouteMap;
     /** Page identifier to routeId lookup for { kind: 'page' } links. */

package/dist/_dts/sdk/src/rendering/components/Layout.d.ts

@@ -3,14 +3,17 @@
  *
  * Renders site header and footer around content. Fetches site data if not provided.
  */
-import { buildMenu, buildFooterMenu, buildFooterMenuForRole, buildLogo } from '../../navigation';
+import { buildMenu, buildFooterMenu, buildFooterMenuForRole, type buildLogo, type buildLogoVariants } from '../../navigation';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
 import type { Theme } from '../../contracts';
 import { type SdkThemeRuntime } from '../themeRuntime';
 import { type SdkOverrideOnlyRendering } from '../renderingMode';
 export type CustomHeaderData = {
     menu: ReturnType<typeof buildMenu>;
+    /** The site logo (for light backgrounds), or the dark-background one if it is the only logo set. */
     logo: ReturnType<typeof buildLogo>;
+    /** Both logos, so a custom header can pick by its own surface. */
+    logoVariants: ReturnType<typeof buildLogoVariants>;
     site: SiteResponse['site'];
     routes: SiteResponse['routes'];
 };
@@ -18,7 +21,10 @@ export type CustomFooterData = {
     menu: ReturnType<typeof buildMenu>;
     footerMenu: ReturnType<typeof buildFooterMenu>;
     legalFooterMenu: ReturnType<typeof buildFooterMenuForRole>;
+    /** The site logo (for light backgrounds), or the dark-background one if it is the only logo set. */
     logo: ReturnType<typeof buildLogo>;
+    /** Both logos, so a custom footer can pick by its own surface. */
+    logoVariants: ReturnType<typeof buildLogoVariants>;
     site: SiteResponse['site'];
     routes: SiteResponse['routes'];
 };

package/dist/_dts/sdk/src/rendering/components/pageShared.d.ts

@@ -55,11 +55,13 @@ type PageCommonProps = {
      * Optional because normal published rendering does not have or need one.
      */
     previewToken?: string | null;
+    readAuthority?: import('../../../../blocks/src/api').BrowserReadAuthority;
     /**
      * Additional context data for content entry pages.
      * Used to pass occurrence context and content entry data to blocks.
      */
     dataContext?: {
+        readAuthority?: import('../../../../blocks/src/api').BrowserReadAuthority;
         /** Mailing-list runtime projected for the placements on this page. */
         mailingList?: import('../../../../core/src/index').MailingListRuntimeContext;
         /** Occurrence context for event pages (from URL like /events/yoga/2025-01-15) */

package/dist/_dts/sdk/src/rendering/islands/enhancers/routeIslandApiConfig.d.ts

@@ -1,9 +1,10 @@
-import type { BlockApiConfig } from '../../../../../blocks/src/api';
+import { type BlockApiConfig, type BrowserReadAuthority } from '../../../../../blocks/src/api';
 export type RouteIslandApiConfigInput = Readonly<{
     apiBaseUrl: string;
     portalToken?: string | null;
     previewToken?: string | null;
     siteId: string;
     stage?: 'preview' | 'published';
+    readAuthority?: BrowserReadAuthority;
 }>;
-export declare function buildRouteIslandApiConfig({ apiBaseUrl, portalToken, previewToken, siteId, stage, }: RouteIslandApiConfigInput): BlockApiConfig;
+export declare function buildRouteIslandApiConfig({ apiBaseUrl, portalToken, previewToken, siteId, stage, readAuthority, }: RouteIslandApiConfigInput): BlockApiConfig;

package/dist/_dts/sdk/src/rendering/islands/enhancers/shopShared.d.ts

@@ -1,7 +1,9 @@
 import { type ComponentType } from 'react';
+import type { BrowserReadAuthority } from '../../../../../blocks/src/api';
 type IslandPropsWithApi = Readonly<{
     siteId?: string;
     apiBaseUrl?: string;
+    readAuthority?: BrowserReadAuthority;
     stage?: 'preview' | 'published';
 }>;
 export declare function mountShopBlockIsland<TProps extends IslandPropsWithApi>(root: HTMLElement, props: TProps, Component: ComponentType<TProps>, label: string): (() => void) | undefined;

package/dist/_dts/sdk/src/rendering/overrides.d.ts

@@ -17,6 +17,7 @@ export type BlockOverrideProps<TContent = Record<string, unknown>, TData = Recor
     apiBaseUrl?: string;
     portalToken?: string | null;
     previewToken?: string | null;
+    readAuthority?: import('../../../blocks/src/api').BrowserReadAuthority;
     stage?: 'published' | 'preview';
     occurrenceContext?: OccurrenceContextData | null;
     entrySubrouteContext?: EntrySubrouteContextData | null;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.143.0";
+export declare const SDK_VERSION = "0.144.0";

package/dist/_dts/theme-core/src/buttons/affordanceSuppression.d.ts

@@ -12,6 +12,6 @@
  * overriding the twelve styles that deliberately declare none. Whether a button
  * carries a trailing affordance is the style's decision; the only caller that
  * legitimately opts out is the authored-button renderer, which reaches it
- * through `themeButtonClassNameWithTrailingIcon`.
+ * through `themeButtonExtraClassesWithTrailingIcon`.
  */
 export declare const AFFORDANCE_SUPPRESS_CLASS = "rb-affordance-off";

package/dist/_dts/theme-core/src/buttons/classNames.d.ts

@@ -1,14 +1,6 @@
 import { type ButtonSizeName, type DefaultVariantAliasId, type VariantId } from './types';
 export type ThemeButtonVariantId = VariantId | DefaultVariantAliasId;
-export type ThemeButtonClassName = string & {
-    readonly __brand: 'ThemeButtonClassName';
-};
 export type ThemeButtonSizeClassName = `btn-${ButtonSizeName}`;
-export type ThemeButtonClassSpec = Readonly<{
-    variant: ThemeButtonVariantId;
-    size: ButtonSizeName;
-    extraClassName?: string | null;
-}>;
 /**
  * Parse content/runtime variant identifiers into the closed theme-button class
  * contract. Empty input is the intentional local/unstyled escape hatch used by
@@ -18,12 +10,10 @@ export declare function parseThemeButtonVariantId(value: string | null | undefin
 export declare function themeButtonVariantClassNames(variant: ThemeButtonVariantId): readonly [string] | readonly [string, string];
 export declare function themeButtonSizeClassName(size: ButtonSizeName): ThemeButtonSizeClassName;
 export declare function themeButtonSelector(variant: ThemeButtonVariantId, size?: ButtonSizeName): string;
-export declare function themeButtonClassName(spec: ThemeButtonClassSpec): ThemeButtonClassName;
 /**
- * Button classes for an authored button that renders its own trailing icon.
+ * Extra classes for an authored button that renders its own trailing icon.
  *
- * A separate function rather than a flag on `themeButtonClassName`, because
- * there is exactly one caller and it should stay visible in a diff. The name
+ * This intent-named function has exactly one caller. The name
  * states what the caller knows to be true of its own markup — that it renders a
  * trailing icon — rather than what the theme does about it. The consequence is
  * the theme's to decide and to change; a caller naming the consequence would be
@@ -34,4 +24,4 @@ export declare function themeButtonClassName(spec: ThemeButtonClassSpec): ThemeB
  * affordance is declared by the button style, and a block overriding that is the
  * defect this replaced.
  */
-export declare function themeButtonClassNameWithTrailingIcon(spec: ThemeButtonClassSpec): ThemeButtonClassName;
+export declare function themeButtonExtraClassesWithTrailingIcon(): string;

package/dist/_dts/theme-core/src/customCss/index.d.ts

@@ -9,4 +9,4 @@ export { selectorSchema, declarationValueSchema, declarationsSchema, customCssRu
 export { keyframesAtRuleSchema, fontFaceAtRuleSchema, mediaAtRuleSchema, supportsAtRuleSchema, rawAtRuleSchema, customCssAtRuleSchema, customCssAtRulesSchema, type KeyframesAtRuleInput, type FontFaceAtRuleInput, type MediaAtRuleInput, type SupportsAtRuleInput, type RawAtRuleInput, type CustomCssAtRuleInput, } from './atRuleValidation';
 export { compileCustomCssRules, compileBlockCustomCssRules, } from './compile';
 export { compileCustomCssAtRules } from './compileAtRules';
-export { type CssRulePatch, generateCssRuleId, applyCssRulePatch, applyCssRulePatches, diffCssRules, } from './patch';
+export { type CssRulePatch, applyCssRulePatch, applyCssRulePatches, diffCssRules, } from './patch';

package/dist/_dts/theme-core/src/customCss/patch.d.ts

@@ -19,11 +19,6 @@ export type CssRulePatch = {
     ruleId: string;
     changes: Partial<Omit<CustomCssRule, 'id'>>;
 };
-/**
- * Generate a unique ID for a new CSS rule.
- * Uses timestamp + random suffix for uniqueness.
- */
-export declare function generateCssRuleId(): string;
 /**
  * Apply a single patch operation to a rules array.
  *