@riverbankcms/sdk 0.135.1 → 0.136.0

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

@@ -1,8 +1,10 @@
 import { type ButtonStyleSelection } from '../buttons/styles';
 import { type KnownCuratedPaletteValueKey } from '../palette/curated';
 import type { Theme } from '../schema';
-import { type HeaderLayoutId, type HeaderLayoutStyleSelection, type HeaderStyleId } from './headerLayoutStyles';
+import { type HeaderLayoutId, type HeaderLayoutStyleSelection, type HeaderStyleId, type HeaderStyleIdValue } from './headerLayoutStyles';
 import { type FooterLookId } from './footerLooks';
+import { type HeaderStyleRecipeOverrides } from './headerStyleDefaults';
+import type { HeaderStyleRecipe } from './headerStyleRecipe';
 import { type CuratedChoice } from './curatedChoices';
 import { type AppearancePresetId, type DesignSystemTemplate, type HeadingDecoration, type NonEmptyReadonlyArray, type SiteStyleId } from './types';
 import { type SiteStyleHeroTypography } from './siteStyleTypography';
@@ -121,6 +123,16 @@ export type CuratedSiteStyle = Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -167,6 +179,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -202,6 +224,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -237,6 +269,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -272,6 +314,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -307,6 +359,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -342,6 +404,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -377,6 +449,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -412,6 +494,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -447,6 +539,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -482,6 +584,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -517,6 +629,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -552,6 +674,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -587,6 +719,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -622,6 +764,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -657,6 +809,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -692,6 +854,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -727,6 +899,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -762,6 +944,16 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -798,6 +990,16 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
     headerCuration: HeaderCuration;
+    /**
+     * Header appearance this style owns outright, keyed by catalogue style id.
+     * Absent entries take `defaultHeaderStyleRecipes`; a present entry is a whole
+     * recipe, never a partial merge. Mirrors `themeOverrides.cards`.
+     *
+     * No curated style authors one yet (ledger D5): the seam ships empty and
+     * adoption follows real site work, per the "do not pre-author" rule in
+     * docs/guides/site-styles.md.
+     */
+    headerStyleRecipes?: HeaderStyleRecipeOverrides;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -808,6 +1010,16 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     /** Optional concrete hero typography applied with the site style. */
     heroTypography?: SiteStyleHeroTypography;
 }>>;
+/**
+ * The header appearance a persisted theme actually renders: the catalogue
+ * recipe unless the theme's own site style has taken that id over (#1318).
+ *
+ * Consumers that hold a theme and a selected style id — the public frontend and
+ * the chrome customiser — go through here rather than reading the style
+ * definition, so a site-style override is visible to every reader rather than
+ * only to the compiler.
+ */
+export declare function headerStyleRecipeForTheme(theme: Pick<Theme, 'siteStyleId'> | null | undefined, styleId: HeaderStyleIdValue): HeaderStyleRecipe;
 export declare function getCuratedSiteStyle(id: SiteStyleId): CuratedSiteStyle | null;
 export declare function designRuntimeRulesForSiteStyle(siteStyle: CuratedSiteStyle | null | undefined): DesignRuntimeRules;
 export declare function designRuntimeRulesForTheme(theme: Pick<Theme, 'siteStyleId'> | null | undefined): DesignRuntimeRules;

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

@@ -141,101 +141,76 @@ export declare const headerStyleCatalog: readonly [{
     readonly label: "Minimal";
     readonly description: "Quiet surface with simple color-change navigation.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "plain";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Seamless";
     readonly description: "Borderless surface with underline hover for a quieter page transition.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "plain";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Soft Bar";
     readonly description: "Soft tinted surface with gentle pill hover states.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "plain";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Pill Nav";
     readonly description: "A calm pill navigation rail over a neutral header.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "plain";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Brand Bar";
     readonly description: "Solid brand surface with high-contrast navigation.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "brand-caps";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Brand Underline";
     readonly description: "Brand surface with underline-grow navigation.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "brand-caps";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Brand Pill";
     readonly description: "Solid brand surface with rounded active and hover states.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "brand-caps";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Brand Capsule";
     readonly description: "Solid brand chrome designed as a floating capsule, with quiet-caps nav, a soft pill active state, and an inverted CTA pill.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "quiet-caps";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Serif Line";
     readonly description: "Typographic logo treatment with understated underline navigation.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "heading";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Flat Tabs";
     readonly description: "Flat block hover and active states with a Swiss utility feel.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "quiet-caps";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Glass";
     readonly description: "Translucent chrome with frosted navigation backing.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "plain";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Clear Split";
     readonly description: "Floating logo with transparent navigation and no shared shell.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    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 id: HeaderStyleId;
     readonly label: "Soft Shell";
     readonly description: "Floating rounded shell with soft pill navigation states.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "plain";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Split Glass";
     readonly description: "Logo floats independently while the navigation sits in a glass rail.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "quiet-caps";
-    readonly openingForegroundTarget: "brand-only";
 }, {
     readonly id: HeaderStyleId;
     readonly label: "Split Pill";
     readonly description: "Logo floats independently with a soft pill-backed navigation rail.";
     readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navTypography: "heading";
-    readonly openingForegroundTarget: "brand-only";
 }];
 export declare const headerLayoutsById: Map<HeaderLayoutId, Readonly<{
     id: HeaderLayoutId;
@@ -252,10 +227,6 @@ export declare const headerStylesById: Map<HeaderStyleId, Readonly<{
     label: string;
     description: string;
     supportedLayoutIds: readonly HeaderLayoutId[];
-    navTypography: import("../../../blocks/src/index").HeaderStyleNavTypography;
-    openingForegroundTarget?: "brand-only" | "all";
-    scrollTreatment?: "contrast-glass";
-    interactionPalette?: import("../../../blocks/src/index").HeaderInteractionPaletteOptionGroup;
 }>>;
 export declare const headerStyleCompatibilityOrder: {
     readonly classic: readonly ["minimal", "fine-line", "soft-bar", "pill-nav", "brand-bar", "brand-underline", "brand-pill", "brand-capsule", "serif-line", "flat-tabs"];

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

@@ -2,5 +2,15 @@ export * from './headerLayoutTypes';
 export * from './headerLayoutCatalog';
 export * from './headerLayoutResolution';
 export * from './headerStyleCompiler';
+/**
+ * The recipe modules are re-exported by name rather than with `export *`.
+ * `compileHeaderRecipe` and `headerForLayout` are deliberately absent: the only
+ * supported way to compile a header is `compileHeaderLayoutStyleSelection`,
+ * which resolves the recipe and applies the interaction palette. A consumer
+ * reaching the interpreter directly would be a second compilation authority,
+ * which is the thing #1318 removes.
+ */
+export { type HeaderStyleRecipe, type HeaderStyleRecipeCore, type HeaderToneRecipe, type HeaderBackgroundRecipe, type HeaderNavRecipe, type HeaderShadowRecipe, type HeaderFrameRecipe, } from './headerStyleRecipe';
+export { defaultHeaderStyleRecipes, resolveHeaderStyleRecipe, type HeaderStyleRecipeOverrides, type HeaderStyleRecipeOwner, } from './headerStyleDefaults';
 export declare const guaranteedFallbackHeaderLayoutId: import("../../../blocks/src/index").HeaderLayoutId;
 export declare const guaranteedFallbackHeaderStyleId: import("../../../blocks/src/index").HeaderStyleId;

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

@@ -1,5 +1,4 @@
 import type { ThemeHeader } from '../schema';
-import type { HeaderInteractionPaletteOptionGroup } from './headerInteractionPalette';
 import type { ResolvedSurfaceForeground } from '../surfaces';
 import { type BrandDisplayMode, type LogoAccommodationOption, type LogoFacts, type LogoSizePolicy } from './logoBranding';
 import { type Brand } from './types';
@@ -47,15 +46,19 @@ export type HeaderLayoutDefinition = Readonly<{
     logoAccommodations: readonly LogoAccommodationOption[];
     openingRequirement: HeaderOpeningRequirement;
 }>;
+/**
+ * Metadata only: what a style is called and where it may be used. Never what it
+ * looks like — every appearance field moved to `HeaderStyleRecipe` in #1318
+ * (`navTypography` under ledger D7, then `openingForegroundTarget`,
+ * `scrollTreatment` and `interactionPalette` under D19), so a site style can own
+ * all of it. If a field here ever answers "what does this look like", it is in
+ * the wrong file.
+ */
 export type HeaderStyleDefinition = Readonly<{
     id: HeaderStyleId;
     label: string;
     description: string;
     supportedLayoutIds: readonly HeaderLayoutId[];
-    navTypography: HeaderStyleNavTypography;
-    openingForegroundTarget?: 'brand-only' | 'all';
-    scrollTreatment?: 'contrast-glass';
-    interactionPalette?: HeaderInteractionPaletteOptionGroup;
 }>;
 export type HeaderLayoutStyleSelection = Readonly<{
     layoutId: HeaderLayoutId;

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

@@ -1,6 +1,6 @@
 import type { Theme } from '../schema';
 import type { ResolvedSurfaceForeground } from '../surfaces';
-import type { HeaderStyleDefinition } from './headerLayoutTypes';
+import type { HeaderStyleRecipe } from './headerStyleRecipe';
 export type HeaderOpeningForegroundContext = Readonly<{
     openingForeground: ResolvedSurfaceForeground;
 }>;
@@ -10,9 +10,9 @@ export type HeaderStyleAvailability = Readonly<{
     kind: 'unavailable';
     reason: 'requires-known-opening-foreground';
 }>;
-export declare function headerStyleAvailability(style: HeaderStyleDefinition, context: Partial<HeaderOpeningForegroundContext> | undefined): HeaderStyleAvailability;
+export declare function headerStyleAvailability(recipe: HeaderStyleRecipe, context: Partial<HeaderOpeningForegroundContext> | 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<HeaderOpeningForegroundContext> | undefined): Theme['header'];
-export declare function applyPageOpeningForegroundToTheme(theme: Theme, style: HeaderStyleDefinition | null | undefined, context: Partial<HeaderOpeningForegroundContext> | undefined): Theme;
+export declare function applyOpeningForeground(theme: Theme, header: Theme['header'], recipe: HeaderStyleRecipe, context: Partial<HeaderOpeningForegroundContext> | undefined): Theme['header'];
+export declare function applyPageOpeningForegroundToTheme(theme: Theme, recipe: HeaderStyleRecipe | null | undefined, context: Partial<HeaderOpeningForegroundContext> | undefined): Theme;

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

@@ -1,3 +1,17 @@
 import type { Theme } from '../schema';
-import { type HeaderLayoutStyleResolution } from './headerLayoutTypes';
-export declare function compileHeaderLayoutStyleSelection(theme: Theme, resolution: HeaderLayoutStyleResolution): Theme['header'];
+import type { HeaderLayoutStyleResolution } from './headerLayoutTypes';
+import { type HeaderStyleRecipeOwner } from './headerStyleDefaults';
+/**
+ * The header compilation pipeline: pick the recipe, interpret it, then apply
+ * the user's interaction-palette preference.
+ *
+ * Appearance decisions live in `headerStyleDefaults.ts` (data), optionally
+ * taken over per site style, and `headerStyleRecipe.ts` (one pure interpreter).
+ * Nothing here switches on a header style id.
+ *
+ * `siteStyle` is required rather than optional: a caller that has no resolved
+ * site style has to say so, because silently falling back to the catalogue
+ * default is exactly the ownership leak this slice closes. Pass `null` when
+ * there genuinely is no site style (initial site provisioning).
+ */
+export declare function compileHeaderLayoutStyleSelection(theme: Theme, resolution: HeaderLayoutStyleResolution, siteStyle: HeaderStyleRecipeOwner | null): Theme['header'];