@riverbankcms/sdk 0.126.0 → 0.128.0

package/dist/_dts/theme-core/src/site-styles/headerLooks.d.ts

@@ -1,5 +1,6 @@
 import type { Theme, ThemeHeader } from '../schema';
-import { type SiteChromeLookDiagnostics } from './customizableSurfaces';
+import { type HeaderInteractionPaletteOptionGroup } from './headerInteractionPalette';
+import { type HeaderOpeningForeground } from './headerOpeningForeground';
 import { type BrandDisplayMode, type HeaderBrandPresentationPlan, type HeaderBrandPresentationSelection, type LogoAccommodationOption, type LogoAccommodationRejectionReason, type LogoFacts, type LogoSizePolicy } from './logoBranding';
 import { type Brand } from './types';
 export declare const headerLookIdValues: readonly ["clean-base", "classic-centered-nav", "brand-solid", "serif-line", "centered-calm", "practical-utility", "minimal-transparent", "transparent-overlay", "floating-glass"];
@@ -57,7 +58,6 @@ export type HeaderLayoutDefinition = Readonly<{
     id: HeaderLayoutId;
     label: string;
     description: string;
-    structure: HeaderStructureId;
     variant: ThemeHeader['variant'];
     defaultPositioning: ThemeHeader['positioning'];
     shrinkOnScroll: boolean;
@@ -78,6 +78,9 @@ export type HeaderStyleDefinition = Readonly<{
     defaultDepth: HeaderStyleDepth;
     navTypography: HeaderStyleNavTypography;
     moods: readonly HeaderStyleMood[];
+    openingForegroundTarget?: 'brand-only' | 'all';
+    scrollTreatment?: 'contrast-glass';
+    interactionPalette?: HeaderInteractionPaletteOptionGroup;
 }>;
 export type HeaderLayoutStyleSelection = Readonly<{
     layoutId: HeaderLayoutId;
@@ -115,25 +118,6 @@ export type HeaderLayoutStyleResolution = Readonly<{
     style: HeaderStyleDefinition;
     repair: HeaderLayoutStyleRepair;
 }>;
-export type HeaderLookVisualTreatment = 'solid-neutral' | 'solid-brand' | 'light-serif' | 'minimal-transparent' | 'transparent-overlay' | 'floating-glass';
-export type HeaderLookLayoutBehavior = 'normal-flow' | 'sticky' | 'sticky-shrink' | 'fixed-overlay' | 'fixed-floating';
-export type HeaderStructureId = 'inline-classic' | 'centered-stack' | 'floating-shell';
-export type HeaderTreatmentId = HeaderLookVisualTreatment;
-export type HeaderBehaviorId = HeaderLookLayoutBehavior;
-export type HeaderConfiguration = Readonly<{
-    structure: HeaderStructureId;
-    treatment: HeaderTreatmentId;
-    behavior: HeaderBehaviorId;
-}>;
-export type HeaderConfigurationRejectionReason = 'unsupported-structure-treatment-behavior-combination';
-export type HeaderConfigurationResolution = Readonly<{
-    kind: 'valid';
-    configuration: HeaderConfiguration;
-}> | Readonly<{
-    kind: 'rejected';
-    requested: HeaderConfiguration;
-    reasons: readonly HeaderConfigurationRejectionReason[];
-}>;
 export type HeaderLookOpeningRequirement = 'none' | 'reserved-space-ok' | 'requires-image-hero-with-contrast-overlay';
 export type HeaderLogoShape = 'none' | 'text-only' | 'horizontal' | 'square' | 'tall';
 export type HeaderLogoDimensions = Readonly<{
@@ -145,9 +129,6 @@ export type HeaderStyleNavTypography = 'plain' | 'heading' | 'quiet-caps' | 'bra
 export type HeaderLookDefinition = Readonly<{
     id: HeaderLookId;
     label: string;
-    visualTreatment: HeaderLookVisualTreatment;
-    layoutBehavior: HeaderLookLayoutBehavior;
-    configuration: HeaderConfiguration;
     openingRequirement: HeaderLookOpeningRequirement;
     maxRecommendedNavItems?: number;
     logoAccommodations: readonly LogoAccommodationOption[];
@@ -180,12 +161,6 @@ export type HeaderOpeningSectionContext = Readonly<{
     hasTopSpacing: boolean;
     canAdjust: boolean;
 }>;
-export type OverlayHeaderOpeningPlan = Readonly<{
-    canRender: true;
-    contrastIntent: 'theme-default' | 'light-on-dark' | 'dark-on-light';
-    topSpacing: 'preserve' | 'add';
-    legibilityFallback: 'none' | 'glass-nav-backing';
-}>;
 export type HeaderLogoPreferences = Readonly<{
     brandDisplayMode?: BrandDisplayMode;
     sizePolicy?: LogoSizePolicy;
@@ -210,6 +185,7 @@ export type HeaderBannerContext = Readonly<{
 }>;
 export type HeaderSelectionContext = Readonly<{
     openingSection: HeaderOpeningSectionContext;
+    openingForeground: HeaderOpeningForeground;
     logo: HeaderLogoContext;
     navigation: HeaderNavigationContext;
     cta: HeaderCtaContext;
@@ -227,14 +203,12 @@ export type HeaderSelectionResult = Readonly<{
     brandPresentation: HeaderBrandPresentationSelection;
     rejected: readonly RejectedHeaderLook[];
 }>;
-export type HeaderLookDiagnostics = SiteChromeLookDiagnostics<HeaderLookId, RejectedHeaderLookReason>;
 export type HeaderLookResolutionInput = Readonly<{
     theme: Theme;
     recommendedLookIds: readonly HeaderLookId[];
     context?: Partial<HeaderSelectionContext>;
 }>;
 export declare const defaultHeaderSelectionContext: HeaderSelectionContext;
-export declare function planOverlayHeaderOpening(opening: HeaderOpeningSectionContext): OverlayHeaderOpeningPlan;
 export declare function completeHeaderSelectionContext(context: Partial<HeaderSelectionContext> | undefined): HeaderSelectionContext;
 export declare function resolveHeaderBrandPresentation(input: Readonly<{
     logo: HeaderLogoContext;
@@ -245,7 +219,6 @@ export declare const headerLayoutCatalog: readonly [{
     readonly id: HeaderLayoutId;
     readonly label: "Classic";
     readonly description: "Logo and navigation in one practical horizontal row.";
-    readonly structure: "inline-classic";
     readonly variant: "classic";
     readonly defaultPositioning: "sticky";
     readonly shrinkOnScroll: false;
@@ -253,7 +226,6 @@ export declare const headerLayoutCatalog: readonly [{
     readonly id: HeaderLayoutId;
     readonly label: "Centered";
     readonly description: "Logo centered above a balanced navigation row.";
-    readonly structure: "centered-stack";
     readonly variant: "centered";
     readonly defaultPositioning: "static";
     readonly shrinkOnScroll: false;
@@ -263,7 +235,6 @@ export declare const headerLayoutCatalog: readonly [{
     readonly id: HeaderLayoutId;
     readonly label: "Floating";
     readonly description: "Detached header chrome that sits over the opening section.";
-    readonly structure: "floating-shell";
     readonly variant: "floating";
     readonly defaultPositioning: "sticky";
     readonly shrinkOnScroll: true;
@@ -385,10 +356,18 @@ export declare const headerStyleCatalog: readonly [{
     readonly label: "Clear Split";
     readonly description: "Floating logo with transparent navigation and no shared shell.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "color-change";
+    readonly navInteraction: "pill-background";
     readonly surface: "floating";
-    readonly defaultDepth: "none";
+    readonly defaultDepth: "line";
     readonly navTypography: "plain";
+    readonly openingForegroundTarget: "all";
+    readonly scrollTreatment: "contrast-glass";
+    readonly interactionPalette: Readonly<{
+        id: "interaction-palette";
+        label: string;
+        options: readonly [import("../../../blocks/src/index").HeaderInteractionPaletteOption, ...import("../../../blocks/src/index").HeaderInteractionPaletteOption[]];
+        defaultOptionId: "accent" | "primary" | "secondary";
+    }>;
     readonly moods: readonly ["editorial", "calm"];
 }, {
     readonly id: HeaderStyleId;
@@ -409,6 +388,7 @@ export declare const headerStyleCatalog: readonly [{
     readonly surface: "floating";
     readonly defaultDepth: "shadow";
     readonly navTypography: "quiet-caps";
+    readonly openingForegroundTarget: "brand-only";
     readonly moods: readonly ["expressive"];
 }, {
     readonly id: HeaderStyleId;
@@ -419,6 +399,7 @@ export declare const headerStyleCatalog: readonly [{
     readonly surface: "floating";
     readonly defaultDepth: "shadow";
     readonly navTypography: "heading";
+    readonly openingForegroundTarget: "brand-only";
     readonly moods: readonly ["calm", "editorial"];
 }];
 export declare const legacyHeaderLookAliases: readonly [{
@@ -479,7 +460,6 @@ export declare const legacyHeaderLookAliases: readonly [{
 export declare function getHeaderLayout(id: HeaderLayoutId): HeaderLayoutDefinition | null;
 export declare function getHeaderStyle(id: HeaderStyleId): HeaderStyleDefinition | null;
 export declare function isHeaderStyleCompatibleWithLayout(style: HeaderStyleDefinition, layoutId: HeaderLayoutId): boolean;
-export declare function headerLayoutSupportsBarFrame(layoutId: HeaderLayoutId): boolean;
 export declare function resolveLegacyHeaderLookAlias(lookId: HeaderLookId): HeaderLayoutStyleSelection | null;
 export declare function findLegacyHeaderLookIdForSelection(selection: HeaderLayoutStyleSelection): HeaderLookId | null;
 export declare function getCompatibleHeaderStyleIds(layoutId: HeaderLayoutId): readonly HeaderStyleId[];
@@ -487,7 +467,7 @@ export declare function getOrderedHeaderLayoutIdsForCuration(curation: HeaderLay
 export declare function getOrderedHeaderStyleIdsForLayout(curation: HeaderLayoutStyleCuration, layoutId: HeaderLayoutId): readonly HeaderStyleId[];
 export declare function deriveNearestCompatibleHeaderStyle(styleId: HeaderStyleId, layoutId: HeaderLayoutId): HeaderStyleId;
 export declare function resolveHeaderLayoutStyleSelection(selection: HeaderLayoutStyleSelection): HeaderLayoutStyleResolution;
-export declare function compileHeaderLayoutStyleSelection(theme: Theme, selection: HeaderLayoutStyleSelection): Theme['header'];
+export declare function compileHeaderLayoutStyleSelection(theme: Theme, selection: HeaderLayoutStyleSelection, context?: Partial<HeaderSelectionContext>): Theme['header'];
 declare function solidBrandHeader(theme: Theme): Theme['header'];
 declare function cleanBaseHeader(theme: Theme): Theme['header'];
 declare function classicCenteredNavHeader(theme: Theme): Theme['header'];
@@ -500,13 +480,6 @@ declare function floatingGlassHeader(theme: Theme): Theme['header'];
 export declare const headerLookCatalog: readonly [{
     readonly id: HeaderLookId;
     readonly label: "Clean base";
-    readonly visualTreatment: "solid-neutral";
-    readonly layoutBehavior: "sticky";
-    readonly configuration: {
-        readonly structure: "inline-classic";
-        readonly treatment: "solid-neutral";
-        readonly behavior: "sticky";
-    };
     readonly openingRequirement: "none";
     readonly logoAccommodations: readonly [{
         readonly pattern: "title-only";
@@ -547,13 +520,6 @@ export declare const headerLookCatalog: readonly [{
 }, {
     readonly id: HeaderLookId;
     readonly label: "Centered nav";
-    readonly visualTreatment: "solid-neutral";
-    readonly layoutBehavior: "sticky";
-    readonly configuration: {
-        readonly structure: "inline-classic";
-        readonly treatment: "solid-neutral";
-        readonly behavior: "sticky";
-    };
     readonly openingRequirement: "none";
     readonly maxRecommendedNavItems: 6;
     readonly logoAccommodations: readonly [{
@@ -595,13 +561,6 @@ export declare const headerLookCatalog: readonly [{
 }, {
     readonly id: HeaderLookId;
     readonly label: "Brand solid";
-    readonly visualTreatment: "solid-brand";
-    readonly layoutBehavior: "sticky-shrink";
-    readonly configuration: {
-        readonly structure: "inline-classic";
-        readonly treatment: "solid-brand";
-        readonly behavior: "sticky-shrink";
-    };
     readonly openingRequirement: "none";
     readonly logoAccommodations: readonly [{
         readonly pattern: "title-only";
@@ -642,13 +601,6 @@ export declare const headerLookCatalog: readonly [{
 }, {
     readonly id: HeaderLookId;
     readonly label: "Serif line";
-    readonly visualTreatment: "light-serif";
-    readonly layoutBehavior: "sticky";
-    readonly configuration: {
-        readonly structure: "centered-stack";
-        readonly treatment: "light-serif";
-        readonly behavior: "sticky";
-    };
     readonly openingRequirement: "none";
     readonly maxRecommendedNavItems: 6;
     readonly logoAccommodations: readonly [{
@@ -690,13 +642,6 @@ export declare const headerLookCatalog: readonly [{
 }, {
     readonly id: HeaderLookId;
     readonly label: "Centered calm";
-    readonly visualTreatment: "light-serif";
-    readonly layoutBehavior: "normal-flow";
-    readonly configuration: {
-        readonly structure: "centered-stack";
-        readonly treatment: "light-serif";
-        readonly behavior: "normal-flow";
-    };
     readonly openingRequirement: "none";
     readonly maxRecommendedNavItems: 5;
     readonly logoAccommodations: readonly [{
@@ -738,13 +683,6 @@ export declare const headerLookCatalog: readonly [{
 }, {
     readonly id: HeaderLookId;
     readonly label: "Practical utility";
-    readonly visualTreatment: "solid-neutral";
-    readonly layoutBehavior: "sticky-shrink";
-    readonly configuration: {
-        readonly structure: "inline-classic";
-        readonly treatment: "solid-neutral";
-        readonly behavior: "sticky-shrink";
-    };
     readonly openingRequirement: "none";
     readonly requiresProminentCta: true;
     readonly logoAccommodations: readonly [{
@@ -786,13 +724,6 @@ export declare const headerLookCatalog: readonly [{
 }, {
     readonly id: HeaderLookId;
     readonly label: "Minimal transparent";
-    readonly visualTreatment: "minimal-transparent";
-    readonly layoutBehavior: "normal-flow";
-    readonly configuration: {
-        readonly structure: "inline-classic";
-        readonly treatment: "minimal-transparent";
-        readonly behavior: "normal-flow";
-    };
     readonly openingRequirement: "reserved-space-ok";
     readonly logoAccommodations: readonly [{
         readonly pattern: "title-only";
@@ -833,13 +764,6 @@ export declare const headerLookCatalog: readonly [{
 }, {
     readonly id: HeaderLookId;
     readonly label: "Transparent overlay";
-    readonly visualTreatment: "transparent-overlay";
-    readonly layoutBehavior: "fixed-overlay";
-    readonly configuration: {
-        readonly structure: "inline-classic";
-        readonly treatment: "transparent-overlay";
-        readonly behavior: "fixed-overlay";
-    };
     readonly openingRequirement: "requires-image-hero-with-contrast-overlay";
     readonly maxRecommendedNavItems: 5;
     readonly logoAccommodations: readonly [{
@@ -874,13 +798,6 @@ export declare const headerLookCatalog: readonly [{
 }, {
     readonly id: HeaderLookId;
     readonly label: "Floating glass";
-    readonly visualTreatment: "floating-glass";
-    readonly layoutBehavior: "fixed-floating";
-    readonly configuration: {
-        readonly structure: "floating-shell";
-        readonly treatment: "floating-glass";
-        readonly behavior: "fixed-floating";
-    };
     readonly openingRequirement: "requires-image-hero-with-contrast-overlay";
     readonly maxRecommendedNavItems: 5;
     readonly logoAccommodations: readonly [{
@@ -916,13 +833,9 @@ export declare const headerLookCatalog: readonly [{
 export declare const guaranteedFallbackHeaderLookId: HeaderLookId;
 export declare const guaranteedFallbackHeaderLayoutId: HeaderLayoutId;
 export declare const guaranteedFallbackHeaderStyleId: HeaderStyleId;
-export declare function resolveHeaderConfiguration(configuration: HeaderConfiguration): HeaderConfigurationResolution;
 export declare function getHeaderLook(id: HeaderLookId): HeaderLookDefinition | null;
 export declare function findHeaderLook(id: HeaderLookId): HeaderLookDefinition | undefined;
 export declare function getHeaderLookOrThrow(id: HeaderLookId): HeaderLookDefinition;
 export declare function headerLookRequiresImageHeroOpening(look: HeaderLookDefinition): boolean;
-export declare function headerLookUsesOverlayLayout(look: HeaderLookDefinition): boolean;
 export declare function resolveHeaderLook(input: HeaderLookResolutionInput): HeaderSelectionResult;
-export declare function headerLookDiagnosticsFromSelectionResult(result: HeaderSelectionResult): HeaderLookDiagnostics;
-export declare function headerLookRejectionReasonLabel(reason: RejectedHeaderLookReason): string;
 export {};

package/dist/_dts/theme-core/src/site-styles/headerOpeningForeground.d.ts

@@ -0,0 +1,22 @@
+import type { Theme } from '../schema';
+import { type ThemeColorToken } from '../tokens';
+import type { HeaderSelectionContext, HeaderStyleDefinition } from './headerLooks';
+export type HeaderOpeningForeground = Readonly<{
+    kind: 'known';
+    token: ThemeColorToken;
+    evidence: 'declared-opening-surface' | 'theme-default';
+}> | Readonly<{
+    kind: 'unknown';
+}>;
+export type HeaderStyleAvailability = Readonly<{
+    kind: 'available';
+}> | Readonly<{
+    kind: 'unavailable';
+    reason: 'requires-known-opening-foreground';
+}>;
+export declare function headerStyleAvailability(style: HeaderStyleDefinition, context: Partial<HeaderSelectionContext> | undefined): HeaderStyleAvailability;
+export declare function headerStyleAvailabilityReasonLabel(reason: Extract<HeaderStyleAvailability, {
+    kind: 'unavailable';
+}>['reason']): string;
+export declare function applyOpeningForeground(theme: Theme, header: Theme['header'], style: HeaderStyleDefinition, context: Partial<HeaderSelectionContext> | undefined): Theme['header'];
+export declare function applyPageOpeningForegroundToTheme(theme: Theme, style: HeaderStyleDefinition | null | undefined, context: Partial<HeaderSelectionContext> | undefined): Theme;

package/dist/_dts/theme-core/src/site-styles/headerOpeningSection.d.ts

@@ -1,5 +1,6 @@
 import type { BlockDesignPlan, DesignBlockId, ResolvedBlockDesignPlan } from './types';
 import type { HeaderLookId, HeaderOpeningSectionContext } from './headerLooks';
+import type { HeaderOpeningForeground } from './headerOpeningForeground';
 export type HeaderOpeningSectionRepair = 'promote-opening-hero-surface' | 'add-opening-contrast-overlay' | 'add-opening-top-spacing';
 export type HeaderOpeningSectionPlan<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     plan: readonly BlockDesignPlan<TBlockId>[];
@@ -15,6 +16,7 @@ export declare function planGeneratedHeaderOpeningSection<TBlockId extends Desig
     recommendedHeaderLookIds: readonly HeaderLookId[];
 }>): HeaderOpeningSectionPlan<TBlockId>;
 export declare function deriveHeaderOpeningSectionContextFromContent(input: HeaderOpeningContentSnapshot): HeaderOpeningSectionContext;
+export declare function deriveHeaderOpeningForegroundFromContent(input: HeaderOpeningContentSnapshot): HeaderOpeningForeground;
 export declare function deriveHeaderOpeningSectionContext(input: Readonly<{
     openingBlock: ResolvedBlockDesignPlan | null;
     openingContent?: Record<string, unknown> | null;

package/dist/_dts/theme-core/src/site-styles/headerStyleParts.d.ts

@@ -0,0 +1,4 @@
+import type { ThemeHeader } from '../schema';
+export declare function brandHeaderForeground(): Pick<ThemeHeader, 'textColor' | 'navColor'>;
+export declare function neutralDropdownStyle(): NonNullable<ThemeHeader['dropdownStyle']>;
+export declare function brandDropdownStyle(): NonNullable<ThemeHeader['dropdownStyle']>;

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

@@ -14,8 +14,11 @@ export * from './footerLooks';
 export * from './generatedSchemas';
 export * from './generatedDesignPipeline';
 export * from './headerLooks';
+export * from './headerInteractionPalette';
+export * from './headerOpeningForeground';
 export * from './headerOpeningSection';
 export * from './lookResolution';
+export * from './lookOptionGroups';
 export * from './logoBranding';
 export * from './pageDesignAuthority';
 export * from './pageDesignEditorErrors';

package/dist/_dts/theme-core/src/site-styles/lookOptionGroups.d.ts

@@ -0,0 +1,24 @@
+export type LookOption = Readonly<{
+    id: string;
+    label: string;
+}>;
+export type LookOptionGroup<TGroupId extends string, TOption extends LookOption> = Readonly<{
+    id: TGroupId;
+    label: string;
+    options: readonly [TOption, ...TOption[]];
+    defaultOptionId: TOption['id'];
+}>;
+export type LookOptionResolution<TOption extends LookOption> = Readonly<{
+    kind: 'defaulted';
+    option: TOption;
+}> | Readonly<{
+    kind: 'selected';
+    option: TOption;
+}> | Readonly<{
+    kind: 'repaired';
+    requestedOptionId: string;
+    option: TOption;
+    reason: 'unsupported-option';
+}>;
+export declare function defineLookOptionGroup<const TGroupId extends string, const TOption extends LookOption>(group: LookOptionGroup<TGroupId, TOption>): LookOptionGroup<TGroupId, TOption>;
+export declare function resolveLookOption<TGroupId extends string, TOption extends LookOption>(group: LookOptionGroup<TGroupId, TOption>, requestedOptionId: string | null | undefined): LookOptionResolution<TOption>;

package/dist/_dts/theme-core/src/site-styles/lookResolution.d.ts

@@ -1,4 +1,4 @@
-import { type BlockAppearanceDesign, type BlockAppearanceOptionGroup, type BlockAppearancePreset } from './appearancePresets';
+import { type BlockAppearanceDesign, type BlockAppearancePreset } from './appearancePresets';
 import type { BlockLayoutDesignProfile } from './blockFlow';
 import type { CuratedSiteStyle } from './curatedSiteStyles';
 import { type AppearancePresetId } from './types';
@@ -6,7 +6,6 @@ export type ResolvedBlockAppearancePreset = Readonly<{
     id: AppearancePresetId;
     label: string;
     design: BlockAppearanceDesign;
-    optionGroups: readonly BlockAppearanceOptionGroup[];
 }>;
 export declare function blockAppearancePresetSupportsBlockKind(preset: BlockAppearancePreset, blockKind: string): boolean;
 export declare function blockAppearancePresetSupportsLayoutProfile(preset: BlockAppearancePreset, profile: BlockLayoutDesignProfile | null, input?: Readonly<{

package/dist/_dts/theme-core/src/site-styles/pageDesignEditorModel.d.ts

@@ -1,9 +1,10 @@
-import type { BlockAppearanceDesign, BlockAppearanceOptionGroup } from './appearancePresets';
-import type { BlockDesignMetadata, BlockLayoutDesignProfile } from './blockFlow';
+import type { BlockDesignMetadata } from './blockFlow';
 import { type PageDesignDecisions } from './pageDesignIntent';
 import { type AppearancePresetId, type BlockDesignCapability, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type SiteStyleId, type UnsupportedBlockDesignCapabilityReason } from './types';
 import { type BoundaryOption } from './sectionTransitions';
+import type { PageDesignEditorBlockContentRevision, PageDesignEditorLayoutOption, PageDesignEditorLookOption, PageDesignEditorLooksForLayout } from './pageDesignEditorOptions';
 export { boundaryOptions, type BoundaryOption } from './sectionTransitions';
+export type { PageDesignEditorBlockContentRevision, PageDesignEditorLayoutOption, PageDesignEditorLookOption, PageDesignEditorLooksForLayout, } from './pageDesignEditorOptions';
 export type PageFlowBoundaryStrategy = 'quiet' | 'balanced' | 'expressive';
 export type PageFlowPreset = Readonly<{
     id: PageFlowPresetId;
@@ -47,25 +48,6 @@ export type PageDesignEditorSelection<TValue> = Readonly<{
     status: 'supported' | 'unsupported';
     effectiveValue: TValue;
 }>;
-export type PageDesignEditorLookOption = Readonly<{
-    id: AppearancePresetId;
-    label: string;
-    design: BlockAppearanceDesign;
-    optionGroups: readonly BlockAppearanceOptionGroup[];
-}>;
-export type PageDesignEditorLayoutOption = Readonly<{
-    id: LayoutVariantKey;
-    label: string;
-    profile: BlockLayoutDesignProfile;
-}>;
-export type PageDesignEditorLooksForLayout = Readonly<{
-    layoutVariantKey: LayoutVariantKey;
-    availableLooks: readonly PageDesignEditorLookOption[];
-    autoLookId: AppearancePresetId | null;
-}>;
-export type PageDesignEditorBlockContentRevision = Readonly<{
-    contentId: string | null;
-}>;
 export type PageDesignEditorLookAvailability = Readonly<{
     kind: 'not-applicable';
     reason: 'block-has-no-looks' | 'block-not-designed' | 'missing-design-capability';
@@ -95,7 +77,7 @@ export declare const backgroundImagePromotedFieldPath: "_sectionStyles.backgroun
  * Look/Layout semantics support them.
  */
 export declare const normalEditorCuratedPromotedFieldPaths: readonly ["_sectionStyles.background.image"];
-export type NormalEditorCuratedPromotedFieldPath = typeof normalEditorCuratedPromotedFieldPaths[number];
+export type NormalEditorCuratedPromotedFieldPath = (typeof normalEditorCuratedPromotedFieldPaths)[number];
 export type PageDesignEditorBoundary<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     boundaryId: DesignBoundaryId;
     previousBlockId: TBlockId;

package/dist/_dts/theme-core/src/site-styles/pageDesignEditorOptions.d.ts

@@ -0,0 +1,21 @@
+import type { BlockLayoutDesignProfile } from './blockFlow';
+import type { BlockAppearanceDesign } from './appearancePresets';
+import type { AppearancePresetId, LayoutVariantKey } from './types';
+export type PageDesignEditorLookOption = Readonly<{
+    id: AppearancePresetId;
+    label: string;
+    design: BlockAppearanceDesign;
+}>;
+export type PageDesignEditorLayoutOption = Readonly<{
+    id: LayoutVariantKey;
+    label: string;
+    profile: BlockLayoutDesignProfile;
+}>;
+export type PageDesignEditorLooksForLayout = Readonly<{
+    layoutVariantKey: LayoutVariantKey;
+    availableLooks: readonly PageDesignEditorLookOption[];
+    autoLookId: AppearancePresetId | null;
+}>;
+export type PageDesignEditorBlockContentRevision = Readonly<{
+    contentId: string | null;
+}>;

package/dist/_dts/theme-core/src/site-styles/previewCompiler.d.ts

@@ -3,7 +3,7 @@ import { type Theme } from '../schema';
 import { type ButtonStyleSelection } from '../buttons/styles';
 import { type CuratedSiteStyle } from './curatedSiteStyles';
 import { type FooterLookId, type FooterSelectionResult } from './footerLooks';
-import type { HeaderSelectionIdentity, SiteThemeCompilationPlan } from './compilationPlan';
+import { type HeaderSelectionIdentity, type SiteThemeCompilationPlan } from './compilationPlan';
 import { type HeaderLayoutId, type HeaderLookId, type HeaderSelectionResult, type HeaderStyleId } from './headerLooks';
 import { type CompiledBlockRuntimeFields, type CompiledBoundaryRuntime, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext } from './runtimeCompiler';
 import { type AppearancePresetId, type DesignBlockId, type SiteStyleId } from './types';

package/dist/_dts/theme-core/src/site-styles/siteChromeNavPreferences.d.ts

@@ -1,5 +1,6 @@
 import type { NavLinkStyle, NavLinkTextSize } from '../navigation/types';
 import type { Theme } from '../schema';
+import type { HeaderInteractionPalettePreference } from '../header/interactionPalette';
 export declare const headerNavTypographyPreferenceValues: readonly ["inherit", "body", "heading"];
 export type HeaderNavTypographyPreference = (typeof headerNavTypographyPreferenceValues)[number];
 export declare const headerNavFontSizePreferenceValues: readonly ["inherit", "sm", "base", "lg", "xl"];
@@ -7,6 +8,7 @@ export type HeaderNavFontSizePreference = (typeof headerNavFontSizePreferenceVal
 export type HeaderNavPreferences = Readonly<{
     typography: HeaderNavTypographyPreference;
     fontSize: HeaderNavFontSizePreference;
+    interactionPalette: HeaderInteractionPalettePreference;
 }>;
 export declare const headerNavTypographyOptions: readonly [{
     readonly value: "inherit";
@@ -37,6 +39,7 @@ export declare const headerNavFontSizeOptions: readonly [{
 export declare const defaultHeaderNavPreferences: {
     readonly typography: "inherit";
     readonly fontSize: "inherit";
+    readonly interactionPalette: "recommended";
 };
 export declare function readHeaderNavPreferences(theme: Theme | null | undefined): HeaderNavPreferences;
 export declare function headerNavPreferencesEqual(left: HeaderNavPreferences, right: HeaderNavPreferences): boolean;
@@ -56,5 +59,5 @@ export declare function withHeaderNavThemePreferences(theme: Theme, preferences:
  *   overrides which font ROLE the treatment resolves through. It never changes
  *   the treatment. `'inherit'` keeps the treatment's default role.
  */
-export declare function mergeHeaderNavTypographyPreference(style: NavLinkStyle, preferences: HeaderNavPreferences): NavLinkStyle;
+export declare function mergeHeaderNavTypographyPreference(style: NavLinkStyle, preferences: Pick<HeaderNavPreferences, 'typography' | 'fontSize'>): NavLinkStyle;
 export declare function readHeaderNavFontSizePreference(value: NavLinkTextSize | undefined): HeaderNavFontSizePreference;