@riverbankcms/sdk 0.60.1 → 0.60.6

package/dist/_dts/core/src/rectification.d.ts

@@ -2,3 +2,82 @@ export declare const RECTIFICATION_SURFACES: readonly ["customer_profile", "book
 export type RectificationSurface = (typeof RECTIFICATION_SURFACES)[number];
 export declare const RECTIFICATION_ISSUE_URL_BASE: "https://github.com/wubss/builder/issues";
 export type RectificationIssueUrl<TNumber extends number = number> = `${typeof RECTIFICATION_ISSUE_URL_BASE}/${TNumber}`;
+/**
+ * Names which identity concept a rectification surface is allowed to mutate or
+ * explain, so customer, participant, snapshot, and ledger corrections cannot blur.
+ */
+export type RectificationIdentityBoundary = Readonly<{
+    kind: 'customer_commercial_current_identity';
+}> | Readonly<{
+    kind: 'customer_backed_participant_current_identity';
+}> | Readonly<{
+    kind: 'person_record_current_note';
+}> | Readonly<{
+    kind: 'immutable_subject_snapshot';
+}> | Readonly<{
+    kind: 'newsletter_current_subscription_identity';
+}> | Readonly<{
+    kind: 'finance_integrity_record';
+}> | Readonly<{
+    kind: 'immutable_audit_history';
+}> | Readonly<{
+    kind: 'derived_history_projection_or_ledger';
+}>;
+export declare const RECTIFICATION_IDENTITY_BOUNDARIES: {
+    readonly customer_commercial_current_identity: {
+        readonly kind: "customer_commercial_current_identity";
+    };
+    readonly customer_backed_participant_current_identity: {
+        readonly kind: "customer_backed_participant_current_identity";
+    };
+    readonly person_record_current_note: {
+        readonly kind: "person_record_current_note";
+    };
+    readonly immutable_subject_snapshot: {
+        readonly kind: "immutable_subject_snapshot";
+    };
+    readonly newsletter_current_subscription_identity: {
+        readonly kind: "newsletter_current_subscription_identity";
+    };
+    readonly finance_integrity_record: {
+        readonly kind: "finance_integrity_record";
+    };
+    readonly immutable_audit_history: {
+        readonly kind: "immutable_audit_history";
+    };
+    readonly derived_history_projection_or_ledger: {
+        readonly kind: "derived_history_projection_or_ledger";
+    };
+};
+/**
+ * Describes what happens to historical copies when the current identity source
+ * is corrected; immutable evidence is retained unless a plan says otherwise.
+ */
+export type RectificationHistoryPropagationPlan = Readonly<{
+    kind: 'update_current_identity_only';
+}> | Readonly<{
+    kind: 'append_correction_note';
+}> | Readonly<{
+    kind: 'annotate_immutable_snapshot';
+}> | Readonly<{
+    kind: 'manual_review_required';
+}> | Readonly<{
+    kind: 'blocked_immutable_history';
+}>;
+export declare const RECTIFICATION_HISTORY_PROPAGATION_PLANS: {
+    readonly update_current_identity_only: {
+        readonly kind: "update_current_identity_only";
+    };
+    readonly append_correction_note: {
+        readonly kind: "append_correction_note";
+    };
+    readonly annotate_immutable_snapshot: {
+        readonly kind: "annotate_immutable_snapshot";
+    };
+    readonly manual_review_required: {
+        readonly kind: "manual_review_required";
+    };
+    readonly blocked_immutable_history: {
+        readonly kind: "blocked_immutable_history";
+    };
+};

package/dist/_dts/db/src/generated/supabase/database.types.d.ts

@@ -2254,8 +2254,8 @@ export type Database = {
                     created_at: string;
                     customer_id: string | null;
                     display_name: string | null;
-                    email: string;
-                    email_normalized: string;
+                    email: string | null;
+                    email_normalized: string | null;
                     id: string;
                     identity_state: string;
                     metadata: Json;
@@ -2267,8 +2267,8 @@ export type Database = {
                     created_at?: string;
                     customer_id?: string | null;
                     display_name?: string | null;
-                    email: string;
-                    email_normalized: string;
+                    email?: string | null;
+                    email_normalized?: string | null;
                     id?: string;
                     identity_state?: string;
                     metadata?: Json;
@@ -2280,8 +2280,8 @@ export type Database = {
                     created_at?: string;
                     customer_id?: string | null;
                     display_name?: string | null;
-                    email?: string;
-                    email_normalized?: string;
+                    email?: string | null;
+                    email_normalized?: string | null;
                     id?: string;
                     identity_state?: string;
                     metadata?: Json;
@@ -8311,6 +8311,7 @@ export type Database = {
                     reply_to_email: string | null;
                     sender_address_line_1: string | null;
                     sender_address_line_2: string | null;
+                    sender_address_source: string;
                     sender_city: string | null;
                     sender_country: string | null;
                     sender_display_name: string | null;
@@ -8332,6 +8333,7 @@ export type Database = {
                     reply_to_email?: string | null;
                     sender_address_line_1?: string | null;
                     sender_address_line_2?: string | null;
+                    sender_address_source?: string;
                     sender_city?: string | null;
                     sender_country?: string | null;
                     sender_display_name?: string | null;
@@ -8353,6 +8355,7 @@ export type Database = {
                     reply_to_email?: string | null;
                     sender_address_line_1?: string | null;
                     sender_address_line_2?: string | null;
+                    sender_address_source?: string;
                     sender_city?: string | null;
                     sender_country?: string | null;
                     sender_display_name?: string | null;
@@ -11716,6 +11719,7 @@ export type Database = {
                     banner_settings: Json;
                     billing_settings: Json | null;
                     booking_settings: Json;
+                    business_address: Json | null;
                     created_at: string;
                     favicon_asset_id: string | null;
                     footer_content_json: Json;
@@ -11742,6 +11746,7 @@ export type Database = {
                     banner_settings?: Json;
                     billing_settings?: Json | null;
                     booking_settings?: Json;
+                    business_address?: Json | null;
                     created_at?: string;
                     favicon_asset_id?: string | null;
                     footer_content_json?: Json;
@@ -11768,6 +11773,7 @@ export type Database = {
                     banner_settings?: Json;
                     billing_settings?: Json | null;
                     booking_settings?: Json;
+                    business_address?: Json | null;
                     created_at?: string;
                     favicon_asset_id?: string | null;
                     footer_content_json?: Json;
@@ -12010,30 +12016,39 @@ export type Database = {
             };
             site_theme_selections: {
                 Row: {
+                    button_personality_id: string | null;
                     created_at: string;
                     id: string;
                     is_current: boolean;
                     overrides: Json;
+                    palette_overrides: Json | null;
+                    palette_variant_id: string | null;
                     site_id: string;
                     theme_id: string;
                     updated_at: string;
                     user_id: string;
                 };
                 Insert: {
+                    button_personality_id?: string | null;
                     created_at?: string;
                     id?: string;
                     is_current?: boolean;
                     overrides?: Json;
+                    palette_overrides?: Json | null;
+                    palette_variant_id?: string | null;
                     site_id: string;
                     theme_id: string;
                     updated_at?: string;
                     user_id: string;
                 };
                 Update: {
+                    button_personality_id?: string | null;
                     created_at?: string;
                     id?: string;
                     is_current?: boolean;
                     overrides?: Json;
+                    palette_overrides?: Json | null;
+                    palette_variant_id?: string | null;
                     site_id?: string;
                     theme_id?: string;
                     updated_at?: string;
@@ -13914,6 +13929,13 @@ export type Database = {
                     waitlist_position: number;
                 }[];
             };
+            create_media_asset_with_storage_quota: {
+                Args: {
+                    p_asset: Json;
+                    p_max_bytes: number;
+                };
+                Returns: string;
+            };
             create_order_shipment_atomic: {
                 Args: {
                     p_carrier_name?: string;

package/dist/_dts/preview-next/src/client/blocks/runOptimisticCustomizeAction.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Sequence-numbered runner for optimistic save flows where the user can fire
+ * the next action before the previous save resolves. Each invocation gets a
+ * fresh sequence number from a shared `nextSequence` callback; the runner
+ * only commits success / failure when its sequence is still the latest.
+ *
+ * Used by the Style configurator: tapping personality A then quickly tapping
+ * personality B should land B's save even if A's network round-trip is
+ * slower, and A's late-arriving response must not clobber B's local state.
+ */
+export type OptimisticActionRun<TSuccess> = Readonly<{
+    /**
+     * Pure result computed locally before the network call fires (the
+     * optimistic "this is what the world will look like" snapshot). Skipped
+     * if the runner has already been superseded.
+     */
+    optimistic?: () => void;
+    /** The network call. Resolves with the persisted payload. */
+    network: () => Promise<TSuccess>;
+    /**
+     * Invoked when `network` resolves AND this run is still the latest.
+     * Stale runs swallow the success silently — the next run will reconcile.
+     */
+    onSuccess: (success: TSuccess) => void;
+    /**
+     * Invoked when `network` rejects AND this run is still the latest. Stale
+     * failures are ignored on the same principle.
+     */
+    onError: (error: unknown) => void;
+}>;
+export type OptimisticActionRunner = Readonly<{
+    /** Schedule a new run; returns its sequence number for debugging / tests. */
+    run: <TSuccess>(action: OptimisticActionRun<TSuccess>) => Promise<number>;
+    /** Force the runner into a known sequence — useful for unmount sentinels. */
+    invalidate: () => void;
+    /** Read the latest sequence. Test/debug only; UI should not branch on it. */
+    current: () => number;
+}>;
+/**
+ * Create a runner. The runner is stateful (holds the latest sequence)
+ * but the inputs to each `run` call are pure data — so individual actions
+ * remain easy to unit-test by stubbing `network`.
+ */
+export declare function createOptimisticActionRunner(): OptimisticActionRunner;

package/dist/_dts/preview-next/src/client/preview/PreviewEditorSidebar.d.ts

@@ -5,6 +5,8 @@ import type { SurfaceId } from "@riverbankcms/surfaces";
 import type { MediaAssetIndexItem, OccurrenceContextData, Theme } from "@riverbankcms/blocks";
 import { type ContentTypeSchema } from "@riverbankcms/content-model";
 import { type ZoomLevel } from "@riverbankcms/content-editor";
+import type { ButtonPersonalityId } from "@riverbankcms/theme-core/buttons";
+import type { PaletteOverrides, PaletteVariantId } from "@riverbankcms/theme-core/palette";
 import type { ViewportMode, ViewportWidth } from "./PreviewViewportControls";
 import { type SiteStyleAccess } from "./siteStyleAccess";
 export type PreviewEditorSidebarTab = "editor" | "assistant";
@@ -29,6 +31,10 @@ export type PreviewEditorSidebarProps = {
     theme?: Theme | null;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    /** Persisted Style configurator selections (Phase C / E). */
+    themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
+    themeSelectionPaletteVariantId?: PaletteVariantId | null;
+    themeSelectionPaletteOverrides?: PaletteOverrides | null;
     apiClient: ApiClient;
     bearerToken?: string | null;
     supabaseUrl?: string;
@@ -47,4 +53,4 @@ export type PreviewEditorSidebarProps = {
     onViewportWidthChange: (width: ViewportWidth) => void;
     onZoomChange: (zoom: ZoomLevel) => void;
 };
-export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, apiClient, bearerToken, supabaseUrl, occurrenceContext, assistantPanel, sdkConfig, mediaAssets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, theme, themeId, themeSelectionId, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, apiClient, bearerToken, supabaseUrl, occurrenceContext, assistantPanel, sdkConfig, mediaAssets, siteStyleAccess, activeTab, onTabChange, onClose, viewportMode, viewportWidth, zoom, onViewportModeChange, onViewportWidthChange, onZoomChange, }: PreviewEditorSidebarProps): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/preview-next/src/client/preview/PreviewShell.d.ts

@@ -1,5 +1,7 @@
 import { type ComponentProps, type ReactNode } from "react";
 import { BlockApiProvider } from "@riverbankcms/blocks/client";
+import type { ButtonPersonalityId } from "@riverbankcms/theme-core/buttons";
+import type { PaletteOverrides, PaletteVariantId } from "@riverbankcms/theme-core/palette";
 import type { MediaAssetIndexItem, OccurrenceContextData, Theme } from "@riverbankcms/blocks";
 import type { ContentTypeSchema } from "@riverbankcms/content-model";
 import type { SdkConfigForBlockPicker } from "@riverbankcms/editor-blocks";
@@ -31,6 +33,15 @@ export type PreviewShellProps = {
     theme: Theme;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    /**
+     * Persisted Style configurator selections (Phase C). Forwarded into the
+     * StyleConfigurator so reload renders the user's saved button personality
+     * + palette variant + sparse overrides instead of falling back to the
+     * site style defaults.
+     */
+    themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
+    themeSelectionPaletteVariantId?: PaletteVariantId | null;
+    themeSelectionPaletteOverrides?: PaletteOverrides | null;
     pageId: string | null;
     routeId: string | null;
     entryData?: PreviewContentEntryData | null;
@@ -52,7 +63,7 @@ export type PreviewShellProps = {
     designEditorEligibility?: PreviewDesignEditorEligibility;
     baseFetch?: BaseFetch;
 };
-export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, occurrenceContext, assistantPanel, sdkConfig, mediaAssets, supabaseUrl, useThemeScope, designEditorEligibility, baseFetch, }: PreviewShellProps): import("react/jsx-runtime").JSX.Element;
+export declare function PreviewShell({ children, apiBaseUrl, blockApiConfig, siteId, siteSlug, editableId, previewSession, previewToken, dashboardBaseUrl, surfaceId, theme, themeId, themeSelectionId, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, pageId, routeId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, initialStatus, initialBlocks, pageMetadata, isSiteLaunched, maintenanceModeEnabled, occurrenceContext, assistantPanel, sdkConfig, mediaAssets, supabaseUrl, useThemeScope, designEditorEligibility, baseFetch, }: PreviewShellProps): import("react/jsx-runtime").JSX.Element;
 export declare function defaultDesignEditorEligibility(input: Readonly<{
     pageId: string | null;
     entryData?: PreviewContentEntryData | null;

package/dist/_dts/preview-next/src/client/preview/PreviewShellLayout.d.ts

@@ -1,5 +1,7 @@
 import { type ReactNode } from "react";
 import { type MediaAssetIndexItem, type OccurrenceContextData, type Theme } from "@riverbankcms/blocks";
+import type { ButtonPersonalityId } from "@riverbankcms/theme-core/buttons";
+import type { PaletteOverrides, PaletteVariantId } from "@riverbankcms/theme-core/palette";
 import type { ContentTypeSchema } from "@riverbankcms/content-model";
 import type { ApiClient } from "@riverbankcms/api/request";
 import type { SdkConfigForBlockPicker } from "@riverbankcms/editor-blocks";
@@ -22,6 +24,9 @@ export type PreviewShellLayoutProps = {
     bearerToken?: string | null;
     themeId?: string | null;
     themeSelectionId?: string | null;
+    themeSelectionButtonPersonalityId?: ButtonPersonalityId | null;
+    themeSelectionPaletteVariantId?: PaletteVariantId | null;
+    themeSelectionPaletteOverrides?: PaletteOverrides | null;
     supabaseUrl?: string;
     isSiteLaunched: boolean;
     maintenanceModeEnabled: boolean;
@@ -32,4 +37,4 @@ export type PreviewShellLayoutProps = {
     useThemeScope?: boolean;
     siteStyleAccess?: SiteStyleAccess;
 };
-export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, occurrenceContext, assistantPanel, sdkConfig, mediaAssets, useThemeScope, siteStyleAccess, }: PreviewShellLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionButtonPersonalityId, themeSelectionPaletteVariantId, themeSelectionPaletteOverrides, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, occurrenceContext, assistantPanel, sdkConfig, mediaAssets, useThemeScope, siteStyleAccess, }: PreviewShellLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/preview-next/src/client/preview/StyleConfigurator.d.ts

@@ -0,0 +1,20 @@
+import type { ApiClient } from '@riverbankcms/api/request';
+import type { Theme } from '@riverbankcms/blocks';
+import { type ButtonPersonalityId } from '@riverbankcms/theme-core/buttons';
+import { type PaletteVariantId, type PaletteOverrides } from '@riverbankcms/theme-core/palette';
+import { type VisibleSiteStyleAccess } from './siteStyleAccess';
+export type StyleConfiguratorProps = Readonly<{
+    siteId: string;
+    apiClient: ApiClient;
+    theme?: Theme | null;
+    themeId?: string | null;
+    selectionId?: string | null;
+    /** Server-persisted Style configurator selections (Phase C). */
+    initialSelections: Readonly<{
+        buttonPersonalityId: ButtonPersonalityId | null;
+        paletteVariantId: PaletteVariantId | null;
+        paletteOverrides: PaletteOverrides | null;
+    }>;
+    siteStyleAccess: VisibleSiteStyleAccess;
+}>;
+export declare function StyleConfigurator({ siteId, apiClient, theme, themeId, selectionId, initialSelections, siteStyleAccess, }: StyleConfiguratorProps): import("react/jsx-runtime").JSX.Element;

package/dist/_dts/preview-next/src/client/preview/StyleConfigurator.state.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Pure state module for the Style configurator. Per-action function style so
+ * the picker rows, apply flow, and concurrency layer can call into a small,
+ * exhaustive set of named transitions instead of a centralised reducer
+ * switch.
+ *
+ * The configurator surfaces three site-level decisions (site style, button
+ * personality, palette variant) plus optional sparse palette overrides. The
+ * "base" snapshot is what the server has persisted; "previewed" is what the
+ * preview pane is currently rendering. They diverge while the user is
+ * picking and converge on apply-success.
+ */
+import type { ButtonPersonalityId } from '@riverbankcms/theme-core/buttons';
+import type { PaletteOverrides, PaletteVariantId } from '@riverbankcms/theme-core/palette';
+import type { SelectionFallbackWarning, SiteStyleId } from '@riverbankcms/theme-core/site-styles/previewCompiler';
+export type StyleConfiguratorSaveStatus = Readonly<{
+    kind: 'idle';
+}> | Readonly<{
+    kind: 'saving';
+}> | Readonly<{
+    kind: 'saved';
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}>;
+export type StyleConfiguratorExpandedRow = 'style' | 'buttons' | 'palette' | 'colours' | null;
+/**
+ * Configurator-level notices that aren't compiler selection fallback warnings.
+ * Kept separate from `SelectionFallbackWarning` (which comes from
+ * `compileSiteThemeFromSelections`) so the layers stay clean: warnings are
+ * compiler-emitted, notices are UI-level decisions the configurator makes.
+ */
+export type StyleConfiguratorNotice = Readonly<{
+    kind: 'palette-overrides-hidden';
+}> | Readonly<{
+    kind: 'palette-overrides-restored';
+}>;
+export type SelectionSnapshot = Readonly<{
+    siteStyleId: SiteStyleId;
+    buttonPersonalityId: ButtonPersonalityId;
+    paletteVariantId: PaletteVariantId;
+    paletteOverrides: PaletteOverrides | null;
+}>;
+type PaletteOverrideDrafts = Readonly<Partial<Record<PaletteVariantId, PaletteOverrides>>>;
+export type StyleConfiguratorState = Readonly<{
+    /**
+     * Last persisted server snapshot. Updated on apply-success (and on
+     * external rebases via `syncStyleConfiguratorState`).
+     */
+    base: SelectionSnapshot;
+    /**
+     * Currently rendered selection. Diverges from `base` while the user is
+     * previewing changes. Identical to `base` after apply-success.
+     */
+    previewed: SelectionSnapshot;
+    saveStatus: StyleConfiguratorSaveStatus;
+    warnings: ReadonlyArray<SelectionFallbackWarning>;
+    notices: ReadonlyArray<StyleConfiguratorNotice>;
+    paletteOverrideDrafts: PaletteOverrideDrafts;
+    expandedRow: StyleConfiguratorExpandedRow;
+}>;
+export declare function createStyleConfiguratorState(base: SelectionSnapshot): StyleConfiguratorState;
+/**
+ * True iff the user has previewed a change that hasn't been applied yet.
+ * Drives the "Apply" / "Cancel" footer visibility and the live-preview
+ * `setOverrideTheme` call.
+ */
+export declare function isPreviewingChange(state: StyleConfiguratorState): boolean;
+export declare function previewSiteStyle(state: StyleConfiguratorState, siteStyleId: SiteStyleId): StyleConfiguratorState;
+export declare function previewButtonPersonality(state: StyleConfiguratorState, buttonPersonalityId: ButtonPersonalityId): StyleConfiguratorState;
+export declare function previewPaletteVariant(state: StyleConfiguratorState, paletteVariantId: PaletteVariantId): StyleConfiguratorState;
+export declare function setPaletteOverrides(state: StyleConfiguratorState, paletteOverrides: PaletteOverrides | null): StyleConfiguratorState;
+/**
+ * Records the post-compile resolved selection + any fallback warnings.
+ * Used after `compileSiteThemeFromSelections` runs against a new site style:
+ * the resolver may have auto-picked a different personality / palette if the
+ * user's previous selections are not offered for the new style.
+ *
+ * Palette overrides are scoped by palette variant. If the resolver moves the
+ * preview to a different palette, the current sparse overrides are stashed
+ * under the previous palette ID and any draft for the new palette is restored.
+ */
+export declare function applyResolvedSelections(state: StyleConfiguratorState, input: Readonly<{
+    resolved: Pick<SelectionSnapshot, 'buttonPersonalityId' | 'paletteVariantId'>;
+    warnings: ReadonlyArray<SelectionFallbackWarning>;
+}>): StyleConfiguratorState;
+export declare function cancelPreview(state: StyleConfiguratorState): StyleConfiguratorState;
+export declare function markApplySaving(state: StyleConfiguratorState): StyleConfiguratorState;
+export declare function markApplySaved(state: StyleConfiguratorState, persisted: SelectionSnapshot): StyleConfiguratorState;
+export declare function markApplyFailed(state: StyleConfiguratorState, message: string): StyleConfiguratorState;
+export declare function toggleRow(state: StyleConfiguratorState, row: StyleConfiguratorExpandedRow): StyleConfiguratorState;
+export declare function dismissWarnings(state: StyleConfiguratorState): StyleConfiguratorState;
+export declare function dismissNotices(state: StyleConfiguratorState): StyleConfiguratorState;
+/**
+ * Reconciles local state with a fresh server snapshot — used after
+ * `router.refresh()` lands new theme data, or when an external write
+ * changes the persisted selection out-of-band.
+ */
+export declare function syncStyleConfiguratorState(state: StyleConfiguratorState, base: SelectionSnapshot): StyleConfiguratorState;
+export declare function paletteOverridesEqual(a: PaletteOverrides | null, b: PaletteOverrides | null): boolean;
+export {};

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

@@ -278,6 +278,7 @@ export interface RiverbankClient {
          * for cache revalidation.
          */
         force?: boolean;
+        currentPath?: string;
     } & SdkMethodOptions): Promise<SiteResponse>;
     /**
      * Fetch a specific page by path

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

@@ -1,4 +1,4 @@
-import type { BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig } from '@riverbankcms/core';
+import type { AddressedLocationValue, BusinessAddress, BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig } from '@riverbankcms/core';
 import type { MediaAssetIndexItem, SiteFooterContent, SiteHeaderContent, Theme } from '../contracts';
 import type { BlockFieldConfig as SdkBlockFieldConfig, BlockFieldOptionsMap as SdkBlockFieldOptionsMap, ContentConfig as SdkContentConfig, ContainerOptionsConfig as SdkContainerOptionsConfig, FieldSelectOption as SdkFieldSelectOption, SdkCustomBlock, SdkThemeConfig, SdkThemePalette, SectionBackground as SdkSectionBackground, SectionOptionsConfig as SdkSectionOptionsConfig, SiteStyleConfig as SdkSiteStyleConfig } from '../config/types';
 export type RuntimeSiteSdkConfig = {
@@ -270,6 +270,8 @@ export type SiteResponse = {
         maintenance_mode_message?: unknown | null;
         deployment_mode?: 'managed' | 'headless_cms' | 'headless_full' | null;
         is_sdk_site?: boolean | null;
+        businessAddress?: BusinessAddress | null;
+        venuesById?: Record<string, AddressedLocationValue>;
     };
     favicon?: {
         assetId: string;
@@ -279,6 +281,14 @@ export type SiteResponse = {
     theme: Theme;
     themeId?: string | null;
     selectionId?: string | null;
+    /**
+     * Persisted Style configurator selections (Phase C). Optional so legacy
+     * payloads without these columns still satisfy the type — consumers fall
+     * back to the site style's defaults when null.
+     */
+    selectionButtonPersonalityId?: string | null;
+    selectionPaletteVariantId?: string | null;
+    selectionPaletteOverrides?: Record<string, string> | null;
     navigation: NavigationMenuWithItems[];
     appointmentsEnabled?: boolean;
     portalEnabled?: boolean;

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.60.1";
+export declare const SDK_VERSION = "0.60.6";

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

@@ -1,4 +1,4 @@
-import type { GradientDirection, ButtonPaddingPreset } from './types';
+import type { ButtonSizes, GradientDirection, ButtonPaddingPreset } from './types';
 /**
  * Shared constants for button CSS generation
  *
@@ -38,3 +38,11 @@ export declare const FONT_SIZE_MAP: Record<string, string>;
  * These are global defaults that apply to all button variants unless overridden
  */
 export declare const BUTTON_PADDING_PRESETS: Record<ButtonPaddingPreset, string>;
+/**
+ * System defaults used when a theme doesn't supply its own `theme.buttons.sizes`.
+ *
+ * Every size is defined so the size class CSS always emits a complete rule and
+ * variants are never naked. Referenced by `generateButtonCss` and surfaceable
+ * from UI ("Showing default size ramp") without duplicating the values.
+ */
+export declare const DEFAULT_BUTTON_SIZES: ButtonSizes;

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

@@ -1,19 +1,24 @@
 import type { Theme } from '../schema';
 import type { ButtonSystem } from './types';
-/**
- * Generate complete CSS for button system from theme config
- *
- * This function:
- * 1. Reads button variants from theme.buttons
- * 2. Generates CSS for each variant
- * 3. Returns scoped CSS string
- *
- * Runs SERVER-SIDE during theme loading.
- * NOTE: Renderer only knows about theme config, NOT presets.
- */
 export interface GenerateButtonCssOptions {
     themeId: string;
     theme: Theme;
     buttonSystem?: ButtonSystem;
 }
+/**
+ * Generate complete CSS for a button system.
+ *
+ * Pipeline:
+ *   1. Resolve effective sizes (theme.sizes ∪ defaults)
+ *   2. For each enabled variant, produce a list of `CssChunk`s (typed rules
+ *      + opaque effect CSS)
+ *   3. Emit a `.default` alias from the highest-priority variant
+ *   4. Serialise the whole list to a CSS string
+ *
+ * Padding/fontSize at size S resolve in order:
+ *   variant.sizes?.[S] → theme.buttons.sizes?.[S] → DEFAULT_BUTTON_SIZES[S]
+ *
+ * 2-class selector specificity (`.{id}.btn-{S}`) carries the size override;
+ * no `!important` required.
+ */
 export declare function generateButtonCss(options: GenerateButtonCssOptions): string;

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

@@ -1,30 +1,23 @@
 import type { Theme } from '../schema';
 import type { ButtonSystem } from './types';
 /**
- * Map motion level to transition duration (milliseconds)
- * Used in effect generation
- */
-export declare const MOTION_TO_DURATION_MAP: Record<string, string>;
-/**
- * Map motion easing to CSS easing function
- */
-export declare const MOTION_TO_EASING_MAP: Record<string, string>;
-/**
- * Generate default button system from theme settings
+ * Generate default button system from theme settings.
  *
- * Creates 4 standard button variants when theme.buttons is not defined:
+ * Creates 4 sized variants when theme.buttons is not defined:
  * 1. Primary - primary color background with opacity-reduce hover effect
  * 2. Secondary - neutral-700 background with opacity-reduce hover effect
  * 3. Outline - transparent background with primary border and opacity-reduce hover effect
  * 4. Ghost - transparent background, no border, with opacity-reduce hover effect
  *
- * All variants use theme settings for:
- * - Border radius (from theme.components.button.shape / theme.corners)
- * - Shadow (from theme.shadow.elevation)
+ * All four are sized variants — they inherit padding/fontSize from the theme's
+ * `sizes` config (or the system defaults) so they're consistent at any size.
+ *
+ * Variants use theme settings for:
+ * - Border radius (via global.cornerStyle / theme.corners)
+ * - Shadow (via global.shadow / theme.shadow.elevation)
  * - Border width for outline (from theme.border.width)
- * - Transitions (from theme.motion)
  *
  * @param theme - Theme configuration
- * @returns ButtonSystem with 4 default variants
+ * @returns ButtonSystem with 4 default sized variants
  */
 export declare function generateDefaultButtonSystem(theme: Theme): ButtonSystem;

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

@@ -8,6 +8,7 @@ export * from './generateButtonCss';
 export * from './generateDefaultButtonSystem';
 export * from './constants';
 export * from './presets';
+export * from './personalities';
 export * from './effects/types';
 export * from './effects/registry';
 export * from './effects/presets/transform';

package/dist/_dts/theme-core/src/buttons/personalities/brushed-wash.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Brushed Wash — gradient backgrounds that read as watercolour washes.
+ * Generous padding, soft shadows; pairs with vibrant organic brands.
+ */
+export declare const brushedWash: Readonly<{
+    id: import("./types").ButtonPersonalityId<"brushed-wash">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    buttonSystem: import("@riverbankcms/blocks").ButtonSystem;
+}>;

package/dist/_dts/theme-core/src/buttons/personalities/confident-chip.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Confident Chip — moderate-radius solid buttons that read as competent and
+ * direct. Default for Clear Professional; works for any modern brand voice.
+ */
+export declare const confidentChip: Readonly<{
+    id: import("./types").ButtonPersonalityId<"confident-chip">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    buttonSystem: import("@riverbankcms/blocks").ButtonSystem;
+}>;