@riverbankcms/sdk 0.126.0 → 0.127.0

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

@@ -11,7 +11,13 @@ import { type SiteStyleAccess } from "./siteStyleAccess";
 import { type PreviewThemeRuntime } from "./themeRuntime";
 export type PreviewShellLayoutProps = {
     children: ReactNode;
+    /** Canonical site theme — persistence/configurator base, never page-adapted. */
     theme: Theme;
+    /**
+     * Page-adapted theme for rendering the preview document. Render-only;
+     * falls back to the canonical theme when absent.
+     */
+    renderTheme?: Theme | null;
     surfaceId: SurfaceId;
     siteId: string;
     dashboardBaseUrl?: string | null;
@@ -45,4 +51,4 @@ export type PreviewShellLayoutProps = {
     siteStyleAccess?: SiteStyleAccess;
     onFooterSaved?: () => void;
 };
-export declare function PreviewShellLayout({ children, theme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, onFooterSaved, }: PreviewShellLayoutProps): React.JSX.Element;
+export declare function PreviewShellLayout({ children, theme, renderTheme, surfaceId, siteId, dashboardBaseUrl, pageId, entryData, contentTypeSchema, referenceContentTypeKeys, draftContent, currentTemplate, apiClient, bearerToken, themeId, themeSelectionId, themeSelectionVersion, themeSelectionUpdatedAt, themeSelectionButtonStyleSelection, themeSelectionHeaderLayoutId, themeSelectionHeaderStyleId, themeSelectionHeaderLookId, themeSelectionFooterLookId, themeSelectionHeaderContext, supabaseUrl, isSiteLaunched, maintenanceModeEnabled, entrySubrouteContext, assistantPanel, sdkConfig, mediaAssets, bookingOfferingPresets, themeRuntime, siteStyleAccess, onFooterSaved, }: PreviewShellLayoutProps): React.JSX.Element;

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

@@ -1,14 +1,13 @@
 import React, { type ReactNode } from 'react';
 import { type ApiClient } from '../../../../api/src/request';
 import type { Theme } from '../../../../blocks/src/index';
-import type { BrandDisplayMode, FooterLookId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderLayoutId, HeaderSelectionContext, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
-import { headerNavFontSizeOptions, headerNavTypographyOptions } from '../../../../theme-core/src/site-styles/index';
+import type { BrandDisplayMode, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderInteractionPalettePreference, HeaderSelectionContext, LogoSizePolicy, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
 import { type StyleConfiguratorHistoryEntry } from './StyleConfigurator.state';
 import type { SiteStyleAccess } from './siteStyleAccess';
-import { type SiteChromeLookOption } from './siteChromeLookRows';
 import { type StyleConfiguratorInitialSelections } from './styleConfiguratorSnapshot';
 import type { SiteChromeEditableSurfaceKind } from './SiteChromeEditableSurface';
-import { type HeaderBrandDisplayOption, type HeaderLogoSizeOption } from './siteChromeBrandPreferences';
+import type { SiteChromeCustomizeSurfaceState } from './siteChromeCustomizeTypes';
+export type { SiteChromeBackgroundControlState, SiteChromeCustomizeSurfaceState, } from './siteChromeCustomizeTypes';
 import { type SiteStyleHistoryFailure, type SiteStyleHistorySkipReason } from './siteStyleHistoryState';
 import { type SiteChromeQuickControlHistoryFailure, type SiteChromeQuickControlHistorySkipReason } from './siteChromeQuickControlHistoryState';
 type SiteStyleHistoryController = Readonly<{
@@ -44,50 +43,6 @@ type SiteChromeQuickControlApplyOutcome = Readonly<{
     kind: 'skipped';
     reason: SiteChromeQuickControlHistorySkipReason | 'superseded';
 }> | SiteChromeQuickControlHistoryFailure;
-export type SiteChromeBackgroundControlState = Readonly<{
-    available: boolean;
-    current: SiteChromeBackgroundOverride;
-    currentLabel: string;
-    quickTokens: readonly SiteChromeBackgroundColorToken[];
-    advancedTokens: readonly SiteChromeBackgroundColorToken[];
-}>;
-export type SiteChromeCustomizeSurfaceState = Readonly<{
-    kind: 'unavailable';
-}> | Readonly<{
-    kind: 'available';
-    surface: 'header';
-    label: string;
-    currentLayoutId: HeaderLayoutId;
-    currentLayoutLabel: string;
-    layoutOptions: readonly SiteChromeLookOption<HeaderLayoutId>[];
-    currentId: HeaderStyleId;
-    currentLabel: string;
-    options: readonly SiteChromeLookOption<HeaderStyleId>[];
-    brandDisplay: BrandDisplayMode;
-    brandDisplayOptions: readonly HeaderBrandDisplayOption[];
-    brandSizeLabel: string;
-    logoSize: LogoSizePolicy;
-    logoSizeOptions: readonly HeaderLogoSizeOption[];
-    menuFont: HeaderNavTypographyPreference;
-    menuFontOptions: typeof headerNavTypographyOptions;
-    menuFontSize: HeaderNavFontSizePreference;
-    menuFontSizeOptions: typeof headerNavFontSizeOptions;
-    diagnostics: readonly string[];
-    background: SiteChromeBackgroundControlState;
-    failure: string | null;
-    applyAllowed: boolean;
-}> | Readonly<{
-    kind: 'available';
-    surface: 'footer';
-    label: string;
-    currentId: FooterLookId | null;
-    currentLabel: string;
-    options: readonly SiteChromeLookOption<FooterLookId | null>[];
-    diagnostics: readonly string[];
-    background: SiteChromeBackgroundControlState;
-    failure: string | null;
-    applyAllowed: boolean;
-}>;
 type SiteChromeCustomizeContextValue = Readonly<{
     canOpenDesignEditor: boolean;
     getSurfaceState: (surface: SiteChromeEditableSurfaceKind) => SiteChromeCustomizeSurfaceState;
@@ -97,6 +52,7 @@ type SiteChromeCustomizeContextValue = Readonly<{
     setHeaderLogoSize: (value: LogoSizePolicy) => void;
     setHeaderMenuFont: (value: HeaderNavTypographyPreference) => void;
     setHeaderMenuFontSize: (value: HeaderNavFontSizePreference) => void;
+    setHeaderInteractionPalette: (value: HeaderInteractionPalettePreference) => void;
     cycleSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, direction: 'prev' | 'next') => void;
     chooseSurfaceBackground: (surface: SiteChromeEditableSurfaceKind, override: SiteChromeBackgroundOverride) => void;
     siteStyleHistory: SiteStyleHistoryController;
@@ -118,4 +74,3 @@ export type SiteChromeCustomizeProviderProps = Readonly<{
 }>;
 export declare function SiteChromeCustomizeProvider({ children, siteId, apiClient, theme, themeId, selectionId, selectionVersion, selectionUpdatedAt, initialSelections, headerSelectionContext, siteStyleAccess, canOpenDesignEditor, }: SiteChromeCustomizeProviderProps): React.JSX.Element;
 export declare function useSiteChromeCustomizeOptional(): SiteChromeCustomizeContextValue | null;
-export {};

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

@@ -0,0 +1,8 @@
+import type { HeaderInteractionPalettePreference, HeaderStyleId } from '../../../../theme-core/src/site-styles/index';
+import { resolveHeaderInteractionPaletteControl } from '../../../../theme-core/src/site-styles/index';
+type HeaderInteractionPaletteSurfaceState = Readonly<{
+    interactionPalette: ReturnType<typeof resolveHeaderInteractionPaletteControl>;
+    diagnostics: readonly string[];
+}>;
+export declare function headerInteractionPaletteSurfaceState(styleId: HeaderStyleId, preference: HeaderInteractionPalettePreference): HeaderInteractionPaletteSurfaceState;
+export {};

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

@@ -0,0 +1,15 @@
+import type { Theme } from "../../../../theme-core/src/index";
+export type PreviewThemeRoles = Readonly<{
+    /** Base theme for site-style saves and configurator state. */
+    persistenceTheme: Theme;
+    /** Theme the preview document renders with (may be page-adapted). */
+    documentTheme: Theme;
+}>;
+/**
+ * Splits the preview theme inputs into their two distinct roles so the
+ * page-adapted render theme can never reach the persistence path.
+ */
+export declare function resolvePreviewThemeRoles(input: {
+    theme: Theme;
+    renderTheme?: Theme | null;
+}): PreviewThemeRoles;

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

@@ -0,0 +1,54 @@
+import type { BrandDisplayMode, FooterLookId, HeaderInteractionPaletteControlState, HeaderLayoutId, HeaderNavFontSizePreference, HeaderNavTypographyPreference, HeaderStyleId, LogoSizePolicy, SiteChromeBackgroundColorToken, SiteChromeBackgroundOverride } from '../../../../theme-core/src/site-styles/index';
+import type { HeaderBrandDisplayOption, HeaderLogoSizeOption } from './siteChromeBrandPreferences';
+import type { SiteChromeLookOption } from './siteChromeLookRows';
+export type SiteChromeBackgroundControlState = Readonly<{
+    available: boolean;
+    current: SiteChromeBackgroundOverride;
+    currentLabel: string;
+    quickTokens: readonly SiteChromeBackgroundColorToken[];
+    advancedTokens: readonly SiteChromeBackgroundColorToken[];
+}>;
+export type SiteChromeCustomizeSurfaceState = Readonly<{
+    kind: 'unavailable';
+}> | Readonly<{
+    kind: 'available';
+    surface: 'header';
+    label: string;
+    currentLayoutId: HeaderLayoutId;
+    currentLayoutLabel: string;
+    layoutOptions: readonly SiteChromeLookOption<HeaderLayoutId>[];
+    currentId: HeaderStyleId;
+    currentLabel: string;
+    options: readonly SiteChromeLookOption<HeaderStyleId>[];
+    brandDisplay: BrandDisplayMode;
+    brandDisplayOptions: readonly HeaderBrandDisplayOption[];
+    brandSizeLabel: string;
+    logoSize: LogoSizePolicy;
+    logoSizeOptions: readonly HeaderLogoSizeOption[];
+    menuFont: HeaderNavTypographyPreference;
+    menuFontOptions: readonly Readonly<{
+        value: HeaderNavTypographyPreference;
+        label: string;
+    }>[];
+    menuFontSize: HeaderNavFontSizePreference;
+    menuFontSizeOptions: readonly Readonly<{
+        value: HeaderNavFontSizePreference;
+        label: string;
+    }>[];
+    interactionPalette: HeaderInteractionPaletteControlState;
+    diagnostics: readonly string[];
+    background: SiteChromeBackgroundControlState;
+    failure: string | null;
+    applyAllowed: boolean;
+}> | Readonly<{
+    kind: 'available';
+    surface: 'footer';
+    label: string;
+    currentId: FooterLookId | null;
+    currentLabel: string;
+    options: readonly SiteChromeLookOption<FooterLookId | null>[];
+    diagnostics: readonly string[];
+    background: SiteChromeBackgroundControlState;
+    failure: string | null;
+    applyAllowed: boolean;
+}>;

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

@@ -1,12 +1,21 @@
 import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/previewCompiler';
-import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId, type LookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
+import { type FooterLookId, type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleAvailability, type HeaderStyleId, type LookCustomizationWritePlan } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot, StyleConfiguratorState } from './StyleConfigurator.state';
-export type SiteChromeLookOption<TId extends string | null> = Readonly<{
+export type SiteChromeLookUnavailableReason = Extract<HeaderStyleAvailability, {
+    kind: 'unavailable';
+}>['reason'] | 'unknown-header-style';
+type SiteChromeLookOptionBase<TId extends string | null> = Readonly<{
     id: TId;
     label: string;
     description?: string;
-    available: boolean;
 }>;
+export type SiteChromeLookOption<TId extends string | null> = SiteChromeLookOptionBase<TId> & (Readonly<{
+    available: true;
+    unavailableReason?: never;
+}> | Readonly<{
+    available: false;
+    unavailableReason: SiteChromeLookUnavailableReason;
+}>);
 export type SiteChromeLookCatalogOption<TId extends string> = Readonly<{
     id: TId;
     label: string;
@@ -33,6 +42,7 @@ type SiteChromeLookModelInput = Readonly<{
     headerSelectionContext?: Partial<HeaderSelectionContext>;
 }>;
 export declare function buildSiteChromeLookModels(input: SiteChromeLookModelInput): SiteChromeLookModels;
+export declare function siteChromeLookUnavailableReasonLabel(reason: SiteChromeLookUnavailableReason): string;
 export declare function cycleSiteChromeLookId<TId extends string>(options: readonly SiteChromeLookOption<TId | null>[], currentId: TId | null, direction: 'prev' | 'next'): TId | null | undefined;
 export declare function cycleableSiteChromeOptions<TId extends string>(options: readonly SiteChromeLookOption<TId | null>[]): readonly SiteChromeLookOption<TId | null>[];
 export type SiteChromeLookSelectionCommand = Readonly<{

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

@@ -0,0 +1,3 @@
+import { type HeaderNavPreferences } from '../../../../theme-core/src/site-styles/index';
+import type { SiteChromeQuickControlHistoryEntry, SiteChromeQuickControlNavTarget } from './siteChromeQuickControlHistoryState';
+export declare function quickControlHistoryEntryFromNavPreferenceChange(previous: HeaderNavPreferences, next: HeaderNavPreferences, target: SiteChromeQuickControlNavTarget): SiteChromeQuickControlHistoryEntry | null;

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

@@ -1,5 +1,5 @@
 import { type HistoryState } from '../../../../content-editor/src/index';
-import { type BrandDisplayMode, type FooterLookId, type HeaderNavFontSizePreference, type HeaderNavPreferences, type HeaderNavTypographyPreference, type LogoSizePolicy, type SiteChromeBackgroundOverride, type SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
+import { type BrandDisplayMode, type FooterLookId, type HeaderNavFontSizePreference, type HeaderNavPreferences, type HeaderNavTypographyPreference, type HeaderInteractionPalettePreference, type LogoSizePolicy, type SiteChromeBackgroundOverride, type SiteChromeBackgroundPreferences } from '../../../../theme-core/src/site-styles/index';
 import type { SelectionSnapshot } from './StyleConfigurator.state';
 import type { HeaderBrandPreferences } from './siteChromeBrandPreferences';
 type HeaderLayoutSelection = Pick<SelectionSnapshot, 'headerLayoutId' | 'headerStyleId' | 'headerLookId'>;
@@ -40,6 +40,10 @@ export type SiteChromeQuickControlHistoryEntry = Readonly<{
     kind: 'header-menu-font-size';
     previous: HeaderNavFontSizePreference;
     next: HeaderNavFontSizePreference;
+}> | Readonly<{
+    kind: 'header-interaction-palette';
+    previous: HeaderInteractionPalettePreference;
+    next: HeaderInteractionPalettePreference;
 }>;
 export type SiteChromeQuickControlHistoryPresent = Readonly<{
     selection: SelectionSnapshot;
@@ -108,7 +112,7 @@ export type SiteChromeQuickControlHistoryFailure = Readonly<{
 }>;
 export type SiteChromeQuickControlSelectionTarget = 'header-layout' | 'header-style' | 'footer-look';
 export type SiteChromeQuickControlBrandTarget = 'header-brand-display' | 'header-logo-size';
-export type SiteChromeQuickControlNavTarget = 'header-menu-font' | 'header-menu-font-size';
+export type SiteChromeQuickControlNavTarget = 'header-menu-font' | 'header-menu-font-size' | 'header-interaction-palette';
 export type SiteChromeQuickControlBackgroundTarget = 'header-background' | 'footer-background';
 export declare function createSiteChromeQuickControlHistoryState(present: SiteChromeQuickControlHistoryPresentInput): SiteChromeQuickControlHistoryState;
 export declare function recordSiteChromeQuickControlHistoryEntry(state: SiteChromeQuickControlHistoryState, input: Readonly<{
@@ -119,7 +123,6 @@ export declare function recordSiteChromeQuickControlHistoryEntry(state: SiteChro
 export declare function quickControlHistoryEntryFromSelectionChange(previous: SelectionSnapshot, next: SelectionSnapshot, target: SiteChromeQuickControlSelectionTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function quickControlHistoryEntryFromBrandPreferenceChange(previous: HeaderBrandPreferences, next: HeaderBrandPreferences, target: SiteChromeQuickControlBrandTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function quickControlHistoryEntryFromBackgroundPreferenceChange(previous: SiteChromeBackgroundPreferences, next: SiteChromeBackgroundPreferences, target: SiteChromeQuickControlBackgroundTarget): SiteChromeQuickControlHistoryEntry | null;
-export declare function quickControlHistoryEntryFromNavPreferenceChange(previous: HeaderNavPreferences, next: HeaderNavPreferences, target: SiteChromeQuickControlNavTarget): SiteChromeQuickControlHistoryEntry | null;
 export declare function beginSiteChromeQuickControlHistoryUndo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
 export declare function beginSiteChromeQuickControlHistoryRedo(state: SiteChromeQuickControlHistoryState): SiteChromeQuickControlHistoryBeginResult;
 export declare function confirmSiteChromeQuickControlHistoryMutation(state: SiteChromeQuickControlHistoryState, persisted: SiteChromeQuickControlHistoryPresentInput): SiteChromeQuickControlHistoryState;

package/dist/_dts/sdk/src/rendering/islands/types.d.ts

@@ -1,4 +1,4 @@
-import type { EventScheduleScope as SystemEventScheduleScope, EventSurfacePreset as SystemEventSurfacePreset, RichTextDoc as SystemRichTextDoc } from '../../contracts/system-block-content';
+import type { ButtonVariant as SystemButtonVariant, EventScheduleScope as SystemEventScheduleScope, EventSurfacePreset as SystemEventSurfacePreset, RichTextDoc as SystemRichTextDoc } from '../../contracts/system-block-content';
 import type { PublicTeamMemberSummary } from '../../../../api/src/index';
 import type { BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig, LocationCoordinates, PublicCoursePriceDisplay, PublicEventPriceDisplay, PublicEventPricing, PublicEventPricingType } from '../../../../core/src/index';
 import type { AccordionIslandProps as BlocksAccordionIslandProps, BookingFormConfig as BlocksBookingFormConfig, BookingFormInteractiveIslandProps as BlocksBookingFormIslandProps, BookingFormService as BlocksBookingFormService, CarouselIslandProps as BlocksCarouselIslandProps, CourseRegistrationInteractiveIslandProps as BlocksCourseRegistrationIslandProps, CartDisplay as BlocksCartDisplay, CartInteractiveIslandProps as BlocksCartIslandProps, CartLineDisplay as BlocksCartLineDisplay, CheckoutDisplay as BlocksCheckoutDisplay, CheckoutInteractiveIslandProps as BlocksCheckoutIslandProps, EventCalendarInteractiveIslandProps as BlocksEventCalendarIslandProps, EventCombinedInteractiveIslandProps as BlocksEventCombinedIslandProps, EventDetailsIslandProps as BlocksEventDetailsIslandProps, EventDetailsOccurrenceContext as BlocksEventDetailsOccurrenceContext, LocationMapIslandProps as BlocksLocationMapIslandProps, EventRegistrationInteractiveIslandProps as BlocksEventRegistrationIslandProps, EventListingDisplay as BlocksEventListingDisplay, EventListingHydration as BlocksEventListingHydration, EventListingInteractiveIslandProps as BlocksEventListingIslandProps, PublicEvent as BlocksPublicEvent, FormInteractiveIslandProps as BlocksFormIslandProps, HeaderSectionIslandProps as BlocksHeaderSectionIslandProps, MembershipCardDisplay as BlocksMembershipCardDisplay, NewsletterFormInteractiveIslandProps as BlocksNewsletterFormIslandProps, PassCardDisplay as BlocksPassCardDisplay, PassesMembershipsDisplay as BlocksPassesMembershipsDisplay, ProductCardDisplay as BlocksProductCardDisplay, ProductDetailDisplay as BlocksProductDetailDisplay, ProductDetailInteractiveIslandProps as BlocksProductDetailIslandProps, ProductListDisplay as BlocksProductListDisplay, ProductListInteractiveIslandProps as BlocksProductListIslandProps, ProductVariantOptionDisplay as BlocksProductVariantOptionDisplay, ShopInteractiveIslandProps as BlocksShopIslandProps } from '../../../../blocks/src/contracts/index';
@@ -240,7 +240,7 @@ export type BookingFormService = BlocksBookingFormService;
 export type BookingFormConfig = BlocksBookingFormConfig;
 export type BookingFormIslandProps = BlocksBookingFormIslandProps;
 export type CardVariant = 'default' | 'variant1' | 'variant2';
-export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'link';
+export type ButtonVariant = SystemButtonVariant;
 export type EventListingLayout = EventLayout;
 export type CardOrientation = 'vertical' | 'horizontal';
 export type EventListingDisplay = BlocksEventListingDisplay;

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

package/dist/_dts/theme-core/src/buttons/effects/presets/background.d.ts

@@ -1,4 +1,4 @@
-import type { EffectPreset } from "../types";
+import type { EffectPreset } from '../types';
 /**
  * Darken background on hover
  *

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

@@ -720,24 +720,6 @@ export type ResolveButtonStyleSelectionResult = Readonly<{
 }>;
 export declare function resolveButtonStyleSelection(selection: ButtonStyleSelection): ResolveButtonStyleSelectionResult;
 export declare function defaultButtonStyleSelectionFor<TStyleId extends ButtonStyleId>(styleId: TStyleId): ButtonStyleSelectionFor<TStyleId>;
-export type PersistedButtonStyleWarning = Readonly<{
-    kind: 'missing-style-id';
-}> | Readonly<{
-    kind: 'unknown-style-id';
-    raw: string;
-}> | Readonly<{
-    kind: 'invalid-parameters';
-    styleId: ButtonStyleId;
-    issues: readonly string[];
-}>;
-export type PersistedButtonStyleSelectionResult = Readonly<{
-    selection: ButtonStyleSelection;
-    warning: PersistedButtonStyleWarning | null;
-}>;
-export declare function parsePersistedButtonStyleSelection(input: Readonly<{
-    styleId: string | null | undefined;
-    parameters: unknown;
-}>, fallback?: ButtonStyleSelection): PersistedButtonStyleSelectionResult;
 export declare function buttonStyleSelectionParameterValue(selection: ButtonStyleSelection, parameter: string): string | null;
 export type UpdateButtonStyleSelectionChoiceResult = Readonly<{
     kind: 'updated';

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

@@ -41,7 +41,7 @@ export type ButtonSizes = Record<ButtonSizeName, ButtonSizeConfig>;
  * Block content references variants by role; the active theme determines
  * what each role looks like.
  */
-export declare const VARIANT_ROLES: readonly ["primary", "secondary", "outline", "ghost", "link", "tertiary", "accent"];
+export declare const VARIANT_ROLES: readonly ["primary", "secondary", "outline", "ghost", "accent"];
 export type VariantRole = (typeof VARIANT_ROLES)[number];
 export declare function isVariantRole(value: string): value is VariantRole;
 declare const SpecialVariantIdBrand: unique symbol;
@@ -307,13 +307,11 @@ export declare const gradientSharpnessSchema: z.ZodEnum<{
 }>;
 export declare const prioritySchema: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
 export declare const variantRoleSchema: z.ZodEnum<{
-    link: "link";
     outline: "outline";
     accent: "accent";
     primary: "primary";
     secondary: "secondary";
     ghost: "ghost";
-    tertiary: "tertiary";
 }>;
 export declare const buttonSizeNameSchema: z.ZodEnum<{
     sm: "sm";

package/dist/_dts/theme-core/src/header/containerSchema.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const headerContainerSchema: z.ZodOptional<z.ZodObject<{
+    rounded: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        xl: "xl";
+        "2xl": "2xl";
+    }>>;
+    border: z.ZodDefault<z.ZodBoolean>;
+    shadow: z.ZodDefault<z.ZodBoolean>;
+    padding: z.ZodDefault<z.ZodEnum<{
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+    }>>;
+    tint: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    opacity: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>>;

package/dist/_dts/theme-core/src/header/generateHeaderCss.d.ts

@@ -16,5 +16,5 @@ export declare const _testExports: {
 /**
  * Generate root header container styles
  */
-declare function generateHeaderRootStyles(header: ThemeHeader, themeId: string, tokens: TokenResolver, _theme: Theme): string;
+declare function generateHeaderRootStyles(header: ThemeHeader, themeId: string, tokens: TokenResolver): string;
 export {};

package/dist/_dts/theme-core/src/header/interactionPalette.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const headerInteractionPaletteValues: readonly ["primary", "secondary", "accent"];
+export declare const headerInteractionPaletteSchema: z.ZodEnum<{
+    accent: "accent";
+    primary: "primary";
+    secondary: "secondary";
+}>;
+export type HeaderInteractionPalette = z.infer<typeof headerInteractionPaletteSchema>;
+export type HeaderInteractionPalettePreference = 'recommended' | HeaderInteractionPalette;
+export type HeaderInteractionPalettePair = Readonly<{
+    backgroundToken: 'primary' | 'secondary' | 'accent';
+    foregroundToken: 'onPrimary' | 'onSecondary' | 'onAccent';
+}>;
+export declare function headerInteractionPalettePair(palette: HeaderInteractionPalette): HeaderInteractionPalettePair;

package/dist/_dts/theme-core/src/header/legacyNavLinkStyle.d.ts

@@ -0,0 +1,3 @@
+import type { NavLinkContrastTreatment, NavLinkStyle } from '../navigation/types';
+import type { ThemeHeader } from '../schema';
+export declare function buildLegacyHeaderNavLinkStyle(header: ThemeHeader, contrastTreatment: NavLinkContrastTreatment | null, navTextSize: NavLinkStyle['textSize'] | null): NavLinkStyle | null;

package/dist/_dts/theme-core/src/header/paintTargets.d.ts

@@ -0,0 +1,25 @@
+type HeaderLayoutVariant = 'classic' | 'centered' | 'transparent' | 'floating';
+type ElementBoxPaintTarget = Readonly<{
+    kind: 'element-box';
+    selector: string;
+    mediaQuery?: string;
+    pseudoElement?: 'inset';
+}>;
+type ViewportBandPaintTarget = Readonly<{
+    kind: 'viewport-band';
+    clipSelector: string;
+    ownerSelector: string;
+    selector: string;
+    mediaQuery: string;
+    topExtension: Readonly<{
+        customProperty: '--rb-header-floating-top-gap';
+        value: '1rem' | '0.75rem';
+        ownerProperty: 'top' | 'margin-top';
+    }>;
+    ownerNeedsPositioning: boolean;
+}>;
+export type HeaderPaintTarget = ElementBoxPaintTarget | ViewportBandPaintTarget;
+/** Resolve the element that owns the visible header surface for each layout. */
+export declare function getHeaderPaintTargets(variant: HeaderLayoutVariant, themeId: string, state?: 'base' | 'scrolled'): readonly HeaderPaintTarget[];
+export declare function renderHeaderPaintTargetRules(targets: readonly HeaderPaintTarget[], rules: readonly string[]): string;
+export {};

package/dist/_dts/theme-core/src/header/scrollTreatment.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const headerScrollTreatmentSchema: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"contrast-glass">;
+    backgroundTone: z.ZodEnum<{
+        light: "light";
+        dark: "dark";
+    }>;
+}, z.core.$strip>], "kind">>;
+export type HeaderScrollTreatment = z.infer<typeof headerScrollTreatmentSchema>;
+export declare function generateMobileOverlayBackdropFilterFix(themeId: string, variant: 'classic' | 'centered' | 'transparent' | 'floating'): string;
+export declare function generateHeaderScrollTreatmentStyles(treatment: HeaderScrollTreatment, themeId: string, variant: 'classic' | 'centered' | 'transparent' | 'floating', surfaceRules?: readonly string[]): string;

package/dist/_dts/theme-core/src/header/surfaceRules.d.ts

@@ -0,0 +1,9 @@
+import type { ThemeHeader } from '../schema';
+import type { TokenResolver } from '../tokens/resolver';
+export type HeaderSurfaceRules = Readonly<{
+    base: readonly string[];
+    scrolled: readonly string[];
+    border: readonly string[];
+}>;
+/** Compile the visual surface declarations independently of paint geometry. */
+export declare function buildHeaderSurfaceRules(header: ThemeHeader, tokens: TokenResolver, blur: string): HeaderSurfaceRules;

package/dist/_dts/theme-core/src/mock-themes/all.d.ts

@@ -187,6 +187,10 @@ export declare const mockThemes: {
                     tint?: string | null | undefined;
                 };
                 barFrame?: "full-bleed" | "inset-shell" | undefined;
+                scrollTreatment?: {
+                    kind: "contrast-glass";
+                    backgroundTone: "light" | "dark";
+                } | undefined;
                 logoOverride?: {
                     type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
                     purpose?: string | undefined;
@@ -226,6 +230,7 @@ export declare const mockThemes: {
                 navFontRole?: "heading" | "body" | undefined;
                 navTypography?: "heading" | "body" | undefined;
                 navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+                interactionPalette?: "accent" | "primary" | "secondary" | undefined;
                 navPlacement?: "center" | "end" | undefined;
                 container?: {
                     rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
@@ -1540,6 +1545,10 @@ export declare const mockThemes: {
                     tint?: string | null | undefined;
                 };
                 barFrame?: "full-bleed" | "inset-shell" | undefined;
+                scrollTreatment?: {
+                    kind: "contrast-glass";
+                    backgroundTone: "light" | "dark";
+                } | undefined;
                 logoOverride?: {
                     type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
                     purpose?: string | undefined;
@@ -1579,6 +1588,7 @@ export declare const mockThemes: {
                 navFontRole?: "heading" | "body" | undefined;
                 navTypography?: "heading" | "body" | undefined;
                 navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+                interactionPalette?: "accent" | "primary" | "secondary" | undefined;
                 navPlacement?: "center" | "end" | undefined;
                 container?: {
                     rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
@@ -2893,6 +2903,10 @@ export declare const mockThemes: {
                     tint?: string | null | undefined;
                 };
                 barFrame?: "full-bleed" | "inset-shell" | undefined;
+                scrollTreatment?: {
+                    kind: "contrast-glass";
+                    backgroundTone: "light" | "dark";
+                } | undefined;
                 logoOverride?: {
                     type: "image" | "video" | "audio" | "document" | "spreadsheet" | "archive";
                     purpose?: string | undefined;
@@ -2932,6 +2946,7 @@ export declare const mockThemes: {
                 navFontRole?: "heading" | "body" | undefined;
                 navTypography?: "heading" | "body" | undefined;
                 navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+                interactionPalette?: "accent" | "primary" | "secondary" | undefined;
                 navPlacement?: "center" | "end" | undefined;
                 container?: {
                     rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";

package/dist/_dts/theme-core/src/palette/colors.d.ts

@@ -87,7 +87,7 @@ export declare function paletteColorsEqual(left: PaletteColors, right: PaletteCo
 export declare function paletteColorFingerprint(colors: PaletteColors): string;
 export declare function canonicalPaletteHashInput(colors: PaletteColors, mode: PaletteMode): string;
 /**
- * The shared TypeScript/SQL protocol. Do not reorder roles: the order comes
+ * Stable curated-catalogue identity. Do not reorder roles: the order comes
  * from PALETTE_TOKEN_NAMES through canonicalPaletteHashInput.
  */
 export declare function paletteValueKey(colors: PaletteColors, mode: PaletteMode): PaletteValueKey;