@riverbankcms/sdk 0.135.1 → 0.137.0

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

@@ -0,0 +1,465 @@
+import type { HeaderStyleIdValue } from './headerLayoutTypes';
+import type { HeaderStyleRecipe } from './headerStyleRecipe';
+/**
+ * A site style's optional take-over of specific header recipes.
+ *
+ * Structural rather than importing `CuratedSiteStyle`, which would close an
+ * import cycle: the curated table already imports the header vocabulary.
+ */
+export type HeaderStyleRecipeOverrides = Partial<Record<HeaderStyleIdValue, HeaderStyleRecipe>>;
+export type HeaderStyleRecipeOwner = Readonly<{
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
+}>;
+/**
+ * A style either takes the default recipe or authors a complete one. This is
+ * deliberately not a deep merge: the same "declare the variant or fall back"
+ * rule cards use, so a half-authored recipe cannot exist.
+ */
+export declare function resolveHeaderStyleRecipe(siteStyle: HeaderStyleRecipeOwner | null, styleId: HeaderStyleIdValue): HeaderStyleRecipe;
+/**
+ * The default header appearance for every catalogue style id (#1318).
+ *
+ * This is the only id-keyed structure in the header appearance pipeline, and it
+ * is data rather than dispatch — the same shape `cards/siteStyleDefaults.ts`
+ * uses. A site style that wants a different header takes over an entry here
+ * with its own recipe; it does not add a branch anywhere.
+ *
+ * `navWeight` (the bar) and `navLinkWeight` (the link text) are separate fields
+ * and they disagree on five styles. That disagreement is real and pre-existing;
+ * it is spelled out here rather than left implicit in a helper default. See the
+ * note on `HeaderStyleRecipeCore.navLinkWeight`.
+ */
+export declare const defaultHeaderStyleRecipes: {
+    readonly minimal: {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "surface";
+        };
+        readonly nav: {
+            readonly kind: "minimal";
+            readonly hoverColorToken: "primary";
+        };
+        readonly navWeight: "medium";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "plain";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "default";
+        };
+    };
+    readonly 'fine-line': {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "surface";
+        };
+        readonly nav: {
+            readonly kind: "underline";
+            readonly hover: "underline";
+        };
+        readonly navWeight: "medium";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "plain";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "outline";
+        };
+    };
+    readonly 'soft-bar': {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "surfaceAlt";
+        };
+        readonly nav: {
+            readonly kind: "pill";
+            readonly backing: "capsule";
+            readonly hoverColorToken: "primary";
+            readonly hoverAlpha: 8;
+        };
+        readonly navWeight: "medium";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "plain";
+        readonly border: "bottom";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "default";
+        };
+    };
+    readonly 'pill-nav': {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "surface";
+        };
+        readonly nav: {
+            readonly kind: "pill";
+            readonly backing: "capsule";
+            readonly hoverColorToken: "primary";
+            readonly hoverAlpha: 10;
+        };
+        readonly navWeight: "medium";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "plain";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "nav-container";
+            readonly type: "pill";
+            readonly tint: "surfaceAlt";
+            readonly opacity: 0.7;
+        };
+        readonly cta: {
+            readonly treatment: "default";
+        };
+    };
+    readonly 'brand-bar': {
+        readonly tone: "brand";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "primary";
+        };
+        readonly nav: {
+            readonly kind: "minimal";
+            readonly hoverColorToken: "secondary";
+        };
+        readonly navWeight: "semibold";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "brand-caps";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "inverted";
+        };
+    };
+    /**
+     * Ledger D13 + D14. The catalogue look changes here, deliberately and once:
+     * bold links (the recipe used to set a bold bar over medium links), a hover
+     * that changes colour *and* underlines, and a compact CTA gap. No production
+     * site has `brand-underline` selected, so this changes zero live sites — and
+     * it is what lets `south-west-twerk-school` reach its current appearance
+     * through shared vocabulary instead of a site-style override.
+     */
+    readonly 'brand-underline': {
+        readonly tone: "brand";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "primary";
+        };
+        readonly nav: {
+            readonly kind: "underline";
+            readonly hover: "both";
+            readonly hoverColorToken: "secondary";
+            readonly underlineColorToken: "secondary";
+        };
+        readonly navWeight: "bold";
+        readonly navLinkWeight: "bold";
+        readonly navTypography: "brand-caps";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "inverted";
+            readonly gap: "compact";
+        };
+    };
+    readonly 'brand-pill': {
+        readonly tone: "brand";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "primary";
+        };
+        readonly nav: {
+            readonly kind: "pill";
+            readonly backing: "capsule";
+            readonly hoverColorToken: "primaryForeground";
+            readonly hoverAlpha: 14;
+        };
+        readonly navWeight: "semibold";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "brand-caps";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "inverted";
+        };
+        readonly onFloating: {
+            readonly background: {
+                readonly kind: "transparent";
+            };
+            readonly frame: {
+                readonly kind: "container";
+                readonly rounded: "2xl";
+                readonly padding: "sm";
+                readonly tint: "primary";
+                readonly opacity: 0.95;
+            };
+        };
+    };
+    readonly 'brand-capsule': {
+        readonly tone: "brand";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "primary";
+        };
+        readonly nav: {
+            readonly kind: "pill";
+            readonly backing: "capsule";
+            readonly hoverColorToken: "primaryForeground";
+            readonly hoverAlpha: 16;
+        };
+        readonly navWeight: "semibold";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "quiet-caps";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "fixed";
+            readonly elevation: "md";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "inverted";
+        };
+    };
+    readonly 'serif-line': {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "background";
+        };
+        readonly nav: {
+            readonly kind: "underline";
+            readonly hover: "underline";
+        };
+        readonly navWeight: "medium";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "heading";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "explicit-none";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "outline";
+            readonly gap: "relaxed";
+        };
+        readonly logo: {
+            readonly fontFamily: "heading";
+            readonly letterSpacing: "wide";
+            readonly gradient: false;
+        };
+    };
+    readonly 'flat-tabs': {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "token";
+            readonly token: "surface";
+        };
+        readonly nav: {
+            readonly kind: "flat-tab";
+        };
+        readonly navWeight: "semibold";
+        readonly navLinkWeight: "semibold";
+        readonly navTypography: "quiet-caps";
+        readonly border: "bottom";
+        readonly shadow: {
+            readonly kind: "themed";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "primary";
+            readonly gap: "compact";
+        };
+    };
+    readonly glass: {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "transparent";
+        };
+        readonly nav: {
+            readonly kind: "pill";
+            readonly backing: "frosted";
+            readonly hoverColorToken: "primary";
+            readonly hoverAlpha: 8;
+        };
+        readonly navWeight: "semibold";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "plain";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "container";
+            readonly rounded: "2xl";
+            readonly padding: "sm";
+            readonly tint: "surface";
+            readonly opacity: 0.4;
+        };
+        readonly cta: {
+            readonly treatment: "default";
+        };
+    };
+    readonly 'minimal-surface': {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "transparent";
+        };
+        readonly nav: {
+            readonly kind: "minimal";
+            readonly hoverColorToken: "primary";
+        };
+        readonly navWeight: "medium";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "plain";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "none";
+        };
+        readonly cta: {
+            readonly treatment: "default";
+        };
+        readonly navLinkExtras: {
+            readonly textSize: "lg";
+            readonly contrastTreatment: "soft-glow";
+        };
+        readonly openingForeground: "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" | "quiet";
+        }>;
+    };
+    readonly 'soft-shell': {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "transparent";
+        };
+        readonly nav: {
+            readonly kind: "pill";
+            readonly backing: "capsule";
+            readonly hoverColorToken: "primary";
+            readonly hoverAlpha: 8;
+        };
+        readonly navWeight: "medium";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "plain";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "container";
+            readonly rounded: "2xl";
+            readonly padding: "md";
+            readonly tint: "surfaceAlt";
+            readonly opacity: 0.95;
+        };
+        readonly cta: {
+            readonly treatment: "default";
+        };
+    };
+    readonly 'split-glass': {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "transparent";
+        };
+        readonly nav: {
+            readonly kind: "pill";
+            readonly backing: "frosted";
+            readonly hoverColorToken: "primary";
+            readonly hoverAlpha: 8;
+        };
+        readonly navWeight: "semibold";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "quiet-caps";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "nav-container";
+            readonly type: "glass";
+            readonly tint: "surface";
+            readonly opacity: 0.4;
+        };
+        readonly cta: {
+            readonly treatment: "default";
+        };
+        readonly openingForeground: "brand-only";
+    };
+    readonly 'split-pill': {
+        readonly tone: "neutral";
+        readonly background: {
+            readonly kind: "transparent";
+        };
+        readonly nav: {
+            readonly kind: "pill";
+            readonly backing: "capsule";
+            readonly hoverColorToken: "primary";
+            readonly hoverAlpha: 10;
+        };
+        readonly navWeight: "medium";
+        readonly navLinkWeight: "medium";
+        readonly navTypography: "heading";
+        readonly border: "none";
+        readonly shadow: {
+            readonly kind: "absent";
+        };
+        readonly frame: {
+            readonly kind: "nav-container";
+            readonly type: "pill";
+            readonly tint: "surface";
+            readonly opacity: 0.94;
+        };
+        readonly cta: {
+            readonly treatment: "default";
+        };
+        readonly openingForeground: "brand-only";
+    };
+};

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

@@ -0,0 +1,168 @@
+import type { NavLinkStyle } from '../navigation/types';
+import type { HeaderCtaGap, LogoStyle, NavFontWeight, Theme, ThemeHeader } from '../schema';
+import type { PaletteTokenName } from '../tokens/themeColorTokens';
+import { type HeaderCtaTreatment } from './headerCtaVariants';
+import type { HeaderInteractionPaletteOptionGroup } from './headerInteractionPalette';
+import { type HeaderLayoutDefinition, type HeaderStyleNavTypography } from './headerLayoutTypes';
+/**
+ * The closed vocabulary a header appearance is authored in (#1318).
+ *
+ * Everything here is data: no closures, no `Theme` argument, no header style id.
+ * `compileHeaderRecipe` is the single interpreter, and every switch in it is
+ * over a facet kind ending in `assertNever` — never over a style id. That is
+ * what lets a site style own header appearance the way it already owns cards:
+ * it hands over a different recipe, not a different branch.
+ *
+ * Tokens are typed as `PaletteTokenName` rather than `ThemeColorToken`. The
+ * latter is a branded `string` that a literal cannot satisfy without a cast, so
+ * it would push every recipe through a parse; the palette role names are the
+ * closed 13-role vocabulary these recipes actually draw from.
+ */
+type HeaderShadowElevation = NonNullable<ThemeHeader['shadow']>['elevation'];
+type HeaderContainerFrame = NonNullable<ThemeHeader['container']>;
+type HeaderNavContainerFrame = NonNullable<ThemeHeader['navContainer']>;
+type HeaderNavLinkTextSize = NavLinkStyle['textSize'];
+type HeaderNavLinkContrastTreatment = NavLinkStyle['contrastTreatment'];
+/** Drives textColor, navColor, dropdownStyle and the nav link's own colour. Nothing else. */
+export type HeaderToneRecipe = 'neutral' | 'brand';
+/** Drives background only. Deliberately a separate axis from tone: floating
+ * `brand-pill` is brand content tone on a transparent background, which a
+ * single coupled union cannot express in either direction. */
+export type HeaderBackgroundRecipe = Readonly<{
+    kind: 'token';
+    token: 'surface' | 'surfaceAlt' | 'background' | 'primary';
+}> | Readonly<{
+    kind: 'transparent';
+}>;
+/**
+ * Nav treatment, split by hover affordance so no invalid state is representable.
+ *
+ * - `minimal` — colour change on hover, plus a top-level `hoverColorToken`.
+ * - `underline` with `hover: 'underline'` — one `nav-underline` effect and *no*
+ *   top-level `hoverColorToken`.
+ * - `underline` with `hover: 'colour' | 'both'` — requires the token, because a
+ *   colour change without one is a state the interpreter could only answer with
+ *   a throw or a silent fallback.
+ * - `pill` — background-alpha hover, with the active state at `hoverAlpha + 5`.
+ *   `backing` is explicit because it is not derivable: `glass` and `split-glass`
+ *   use the same pill nav link over `navStyle: 'frosted'`, everything else over
+ *   `'capsule'`.
+ * - `flat-tab` — the Swiss block treatment; its tokens are fixed by the helper.
+ */
+export type HeaderNavRecipe = Readonly<{
+    kind: 'minimal';
+    hoverColorToken: PaletteTokenName;
+}> | Readonly<{
+    kind: 'underline';
+    hover: 'underline';
+    underlineColorToken?: PaletteTokenName;
+}> | Readonly<{
+    kind: 'underline';
+    hover: 'colour' | 'both';
+    hoverColorToken: PaletteTokenName;
+    underlineColorToken?: PaletteTokenName;
+}> | Readonly<{
+    kind: 'pill';
+    backing: 'capsule' | 'frosted';
+    hoverColorToken: PaletteTokenName;
+    hoverAlpha: 8 | 10 | 14 | 16;
+}> | Readonly<{
+    kind: 'flat-tab';
+}>;
+/**
+ * `absent` and `explicit-none` are distinct because they are distinct bytes:
+ * `serif-line` persists `{elevation: 'none'}` as a present key, every other
+ * neutral style omits `shadow` entirely, and `themed` resolves against the
+ * theme's own elevation and can itself come back absent.
+ */
+export type HeaderShadowRecipe = Readonly<{
+    kind: 'absent';
+}> | Readonly<{
+    kind: 'explicit-none';
+}> | Readonly<{
+    kind: 'fixed';
+    elevation: HeaderShadowElevation;
+}> | Readonly<{
+    kind: 'themed';
+}>;
+export type HeaderFrameRecipe = Readonly<{
+    kind: 'none';
+}> | (Readonly<{
+    kind: 'container';
+}> & Pick<HeaderContainerFrame, 'rounded' | 'padding' | 'tint' | 'opacity'>) | (Readonly<{
+    kind: 'nav-container';
+}> & Readonly<{
+    type: Exclude<HeaderNavContainerFrame['type'], 'none'>;
+}> & Pick<HeaderNavContainerFrame, 'tint' | 'opacity'>);
+export type HeaderStyleRecipeCore = Readonly<{
+    tone: HeaderToneRecipe;
+    background: HeaderBackgroundRecipe;
+    nav: HeaderNavRecipe;
+    /** `header.navWeight` — the weight of the nav bar as a whole. */
+    navWeight: NavFontWeight;
+    /**
+     * `navLinkStyle.fontWeight` — the weight of the link text itself.
+     *
+     * The plan for #1318 proposed one field driving both, on the grounds that
+     * `brand-underline` sets `navWeight: 'bold'` over a link left at `'medium'`.
+     * That is true, but it is not unique: `brand-bar`, `brand-pill`,
+     * `brand-capsule`, `glass` and `split-glass` all pair a `'semibold'` bar with
+     * `'medium'` links today, so collapsing the two would change bytes for five
+     * styles that no ledger row covers. Two required fields keep every recipe
+     * byte-identical *and* put the disagreement in the table where a reviewer can
+     * see it, rather than splitting it across two files.
+     */
+    navLinkWeight: NavFontWeight;
+    navTypography: HeaderStyleNavTypography;
+    border: 'none' | 'bottom';
+    shadow: HeaderShadowRecipe;
+    frame: HeaderFrameRecipe;
+    cta: Readonly<{
+        treatment: HeaderCtaTreatment;
+        gap?: HeaderCtaGap;
+    }>;
+    logo?: LogoStyle;
+    /**
+     * Which parts of the header adopt the opening section's foreground, for
+     * styles that float over it. `'brand-only'` recolours the wordmark;
+     * `'all'` recolours nav and border too and enables `scrollTreatment`.
+     * Absent means the header does not read its opening section at all, which is
+     * also what makes the style available without a known opening foreground.
+     */
+    openingForeground?: 'brand-only' | 'all';
+    /** Contrast treatment once the page scrolls under a floating header. */
+    scrollTreatment?: 'contrast-glass';
+    /**
+     * The hover-colour choice this style offers the user. Data, not a closure —
+     * a `LookOptionGroup` of ids and labels.
+     */
+    interactionPalette?: HeaderInteractionPaletteOptionGroup;
+    navLinkExtras?: Readonly<{
+        textSize?: HeaderNavLinkTextSize;
+        contrastTreatment?: HeaderNavLinkContrastTreatment;
+    }>;
+}>;
+export type HeaderStyleRecipe = HeaderStyleRecipeCore & Readonly<{
+    /**
+     * The one layout-conditional adjustment in the catalogue: floating
+     * `brand-pill` swaps to a transparent background inside a tinted container.
+     * Narrowed to the two facets it actually adjusts, so a layout cannot reach
+     * tone or nav and no "used at most once" test is needed to police it.
+     * Keyed on the floating layout because layout id and `header.variant` are
+     * 1:1 (asserted in `headerCompilationParity.test.ts`).
+     */
+    onFloating?: Pick<HeaderStyleRecipeCore, 'background' | 'frame'>;
+}>;
+/**
+ * The single header interpreter. Pure and total: same `(theme, layout, recipe)`
+ * in, same object out, no throws of its own.
+ *
+ * It **constructs** a `ThemeHeader` rather than starting from one (#1318 Phase
+ * 4e). `theme` is read for the palette-dependent facets only — the themed
+ * shadow and the CTA variant — never for `theme.header`, so no value can
+ * survive a recompile by accident. Every required field of `headerSchema` is
+ * produced by a named branch here or in `headerForLayout`; the type is the
+ * check.
+ */
+export declare function compileHeaderRecipe(theme: Theme, layout: HeaderLayoutDefinition, recipe: HeaderStyleRecipe): ThemeHeader;
+export {};

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

@@ -16,6 +16,11 @@ export * from './generatedSchemas';
 export * from './generatedDesignPipeline';
 export * from './headerLayoutStyles';
 export * from './headerInteractionPalette';
+export * from './headerBrandPresentation';
+export { applyHeaderPreferences, defaultHeaderPreferences, defaultHeaderStructurePreferences, type HeaderLogoTextIntent, type HeaderPreferences, type HeaderQuickControlPreferences, type HeaderStructurePreferences, } from './headerPreferences';
+export { headerPreferencesSchema, headerPreferencesWireSchema, parsePersistedHeaderPreferences, type PersistedHeaderPreferences, } from './headerPreferencesPersistence';
+export { compareCompiledHeaders, type CompiledHeaderComparison, type HeaderFieldDiff, } from './headerBytesComparison';
+export { compileHeaderForCuratedSelection, recompileSiteChromeHeader, recompileSiteChromeHeaderFromPersistedIntent, type CuratedHeaderSelectionRepair, type CompiledCuratedHeader, type HeaderInteractionPaletteRequest, type RecompileSiteChromeHeaderInput, type RecompiledSiteChromeHeader, } from './headerRecompile';
 export * from './headerOpeningForeground';
 export * from './headerOpeningSection';
 export * from './lookResolution';

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

@@ -4,7 +4,7 @@ import { type ButtonStyleSelection } from '../buttons/styles';
 import { type CuratedSiteStyle } from './curatedSiteStyles';
 import { type FooterLookId } from './footerLooks';
 import type { SiteThemeCompilationPlan } from './compilationPlan';
-import { type HeaderLayoutStyleSelection } from './headerLayoutStyles';
+import type { HeaderLayoutStyleSelection } from './headerLayoutStyles';
 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';
 import { type CuratedSiteStyleTheme } from './siteStyleThemeCompiler';

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

@@ -1,4 +1,4 @@
-import type { Theme } from '../schema';
+import type { Theme, ThemeFooter, ThemeHeader } from '../schema';
 import type { ThemeColorToken } from '../tokens';
 export type SiteChromeSurface = 'header' | 'footer';
 export type SiteChromeBackgroundColorToken = ThemeColorToken & {
@@ -28,3 +28,22 @@ export declare function siteChromeBackgroundOverrideLabel(override: SiteChromeBa
 export declare function formatSiteChromeBackgroundTokenLabel(token: SiteChromeBackgroundColorToken): string;
 export declare function siteChromeBackgroundOverrideEquals(left: SiteChromeBackgroundOverride, right: SiteChromeBackgroundOverride): boolean;
 export declare function cycleSiteChromeBackgroundOverride(current: SiteChromeBackgroundOverride, direction: SiteChromeBackgroundCycleDirection): SiteChromeBackgroundOverride;
+/**
+ * Reads the header background override back out of persisted bytes. Exported
+ * for `readHeaderPreferences`, which needs the header half on its own.
+ */
+export declare function siteChromeBackgroundOverrideFromHeader(header: ThemeHeader): SiteChromeBackgroundOverride;
+/**
+ * Header-only background applier. Exported so the header preference pipeline
+ * can apply the header override without going through
+ * `applySiteChromeBackgroundPreferences`, which also writes the footer and
+ * would clobber footer intent (#1318 Correction 20).
+ */
+export declare function applyHeaderBackgroundOverride(theme: Theme, header: ThemeHeader, override: SiteChromeBackgroundOverride): ThemeHeader;
+/**
+ * Footer-only background applier, the counterpart of
+ * `applyHeaderBackgroundOverride`. Exported so a caller that owns one surface
+ * can write that surface rather than passing a no-op override for the other
+ * (#1318 Correction 20).
+ */
+export declare function applyFooterBackgroundOverride(theme: Theme, footer: ThemeFooter, override: SiteChromeBackgroundOverride): ThemeFooter;