@riverbankcms/sdk 0.129.0 → 0.130.0

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

@@ -1,841 +0,0 @@
-import type { Theme, ThemeHeader } from '../schema';
-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"];
-export type HeaderLookIdValue = (typeof headerLookIdValues)[number];
-export type HeaderLookId = Brand<HeaderLookIdValue, 'HeaderLookId'>;
-export declare function asHeaderLookId(value: HeaderLookIdValue): HeaderLookId;
-export type PersistedHeaderLookIdParseResult = Readonly<{
-    kind: 'known';
-    id: HeaderLookId;
-}> | Readonly<{
-    kind: 'unknown';
-    raw: string;
-}> | Readonly<{
-    kind: 'empty';
-}>;
-export declare function parsePersistedHeaderLookId(value: string): Exclude<PersistedHeaderLookIdParseResult, {
-    kind: 'empty';
-}>;
-export declare function parsePersistedHeaderLookId(value: string | null | undefined): PersistedHeaderLookIdParseResult;
-export declare const headerLayoutIdValues: readonly ["classic", "centered", "floating"];
-export type HeaderLayoutIdValue = (typeof headerLayoutIdValues)[number];
-export type HeaderLayoutId = Brand<HeaderLayoutIdValue, 'HeaderLayoutId'>;
-export declare function asHeaderLayoutId(value: HeaderLayoutIdValue): HeaderLayoutId;
-export type PersistedHeaderLayoutIdParseResult = Readonly<{
-    kind: 'known';
-    id: HeaderLayoutId;
-}> | Readonly<{
-    kind: 'unknown';
-    raw: string;
-}> | Readonly<{
-    kind: 'empty';
-}>;
-export declare function parsePersistedHeaderLayoutId(value: string): Exclude<PersistedHeaderLayoutIdParseResult, {
-    kind: 'empty';
-}>;
-export declare function parsePersistedHeaderLayoutId(value: string | null | undefined): PersistedHeaderLayoutIdParseResult;
-export declare const headerStyleIdValues: readonly ["minimal", "fine-line", "soft-bar", "pill-nav", "brand-bar", "brand-underline", "brand-pill", "brand-capsule", "serif-line", "flat-tabs", "glass", "minimal-surface", "soft-shell", "split-glass", "split-pill"];
-export type HeaderStyleIdValue = (typeof headerStyleIdValues)[number];
-export type HeaderStyleId = Brand<HeaderStyleIdValue, 'HeaderStyleId'>;
-export declare function asHeaderStyleId(value: HeaderStyleIdValue): HeaderStyleId;
-export type PersistedHeaderStyleIdParseResult = Readonly<{
-    kind: 'known';
-    id: HeaderStyleId;
-}> | Readonly<{
-    kind: 'unknown';
-    raw: string;
-}> | Readonly<{
-    kind: 'empty';
-}>;
-export declare function parsePersistedHeaderStyleId(value: string): Exclude<PersistedHeaderStyleIdParseResult, {
-    kind: 'empty';
-}>;
-export declare function parsePersistedHeaderStyleId(value: string | null | undefined): PersistedHeaderStyleIdParseResult;
-export type HeaderLayoutDefinition = Readonly<{
-    id: HeaderLayoutId;
-    label: string;
-    description: string;
-    variant: ThemeHeader['variant'];
-    defaultPositioning: ThemeHeader['positioning'];
-    shrinkOnScroll: boolean;
-    maxRecommendedNavItems?: number;
-    allowedLogoShapes?: readonly HeaderLogoShape[];
-}>;
-export type HeaderStyleNavInteraction = 'color-change' | 'underline-grow' | 'pill-background' | 'flat-block' | 'glass-backed';
-export type HeaderStyleSurface = 'neutral' | 'bordered' | 'soft' | 'brand-solid' | 'floating';
-export type HeaderStyleDepth = 'none' | 'line' | 'shadow';
-export type HeaderStyleMood = 'calm' | 'professional' | 'editorial' | 'expressive' | 'utility';
-export type HeaderStyleDefinition = Readonly<{
-    id: HeaderStyleId;
-    label: string;
-    description: string;
-    supportedLayoutIds: readonly HeaderLayoutId[];
-    navInteraction: HeaderStyleNavInteraction;
-    surface: HeaderStyleSurface;
-    defaultDepth: HeaderStyleDepth;
-    navTypography: HeaderStyleNavTypography;
-    moods: readonly HeaderStyleMood[];
-    openingForegroundTarget?: 'brand-only' | 'all';
-    scrollTreatment?: 'contrast-glass';
-    interactionPalette?: HeaderInteractionPaletteOptionGroup;
-}>;
-export type HeaderLayoutStyleSelection = Readonly<{
-    layoutId: HeaderLayoutId;
-    styleId: HeaderStyleId;
-}>;
-export type HeaderStyleChoiceSource = Readonly<{
-    id: HeaderStyleId;
-}>;
-export type HeaderLayoutChoiceSource = Readonly<{
-    id: HeaderLayoutId;
-}>;
-export type HeaderStyleChoicesByLayout = Readonly<Partial<Record<HeaderLayoutIdValue, readonly HeaderStyleChoiceSource[]>>>;
-export type HeaderLayoutStyleCuration = Readonly<{
-    recommendedHeaderLayoutChoices: readonly HeaderLayoutChoiceSource[];
-    recommendedHeaderStyleChoicesByLayout: HeaderStyleChoicesByLayout;
-}>;
-export type HeaderLegacyLookAlias = Readonly<{
-    lookId: HeaderLookId;
-    selection: HeaderLayoutStyleSelection;
-}>;
-export type HeaderLayoutStyleRepair = Readonly<{
-    requested: HeaderLayoutStyleSelection;
-    resolved: HeaderLayoutStyleSelection;
-    reason: 'style-incompatible-with-layout';
-}>;
-export type HeaderLayoutStyleResolution = Readonly<{
-    kind: 'valid';
-    selection: HeaderLayoutStyleSelection;
-    layout: HeaderLayoutDefinition;
-    style: HeaderStyleDefinition;
-}> | Readonly<{
-    kind: 'repaired';
-    selection: HeaderLayoutStyleSelection;
-    layout: HeaderLayoutDefinition;
-    style: HeaderStyleDefinition;
-    repair: HeaderLayoutStyleRepair;
-}>;
-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<{
-    width: number | null;
-    height: number | null;
-}>;
-export declare function deriveHeaderLogoShapeFromDimensions({ width, height, }: HeaderLogoDimensions): HeaderLogoShape;
-export type HeaderStyleNavTypography = 'plain' | 'heading' | 'quiet-caps' | 'brand-caps';
-export type HeaderLookDefinition = Readonly<{
-    id: HeaderLookId;
-    label: string;
-    openingRequirement: HeaderLookOpeningRequirement;
-    maxRecommendedNavItems?: number;
-    logoAccommodations: readonly LogoAccommodationOption[];
-    requiresProminentCta?: boolean;
-    compile: (theme: Theme) => Theme['header'];
-}>;
-export type HeaderOpeningSectionContext = Readonly<{
-    kind: 'unknown';
-    canAdjust: false;
-}> | Readonly<{
-    kind: 'plain';
-    canAdjust: boolean;
-}> | Readonly<{
-    kind: 'page-background';
-    canAdjust: true;
-}> | Readonly<{
-    kind: 'color-section';
-    contrast: 'light' | 'dark' | 'unknown';
-    canAdjust: boolean;
-}> | Readonly<{
-    kind: 'gradient-section';
-    contrast: 'light' | 'dark' | 'unknown';
-    canAdjust: boolean;
-}> | Readonly<{
-    kind: 'dynamic-media';
-    canAdjust: boolean;
-}> | Readonly<{
-    kind: 'image-hero';
-    hasContrastOverlay: boolean;
-    hasTopSpacing: boolean;
-    canAdjust: boolean;
-}>;
-export type HeaderLogoPreferences = Readonly<{
-    brandDisplayMode?: BrandDisplayMode;
-    sizePolicy?: LogoSizePolicy;
-}>;
-export type HeaderLogoShapeContext = HeaderLogoPreferences & Readonly<{
-    kind?: 'shape';
-    shape: HeaderLogoShape;
-}>;
-export type HeaderLogoFactsContext = HeaderLogoPreferences & Readonly<{
-    kind: 'facts';
-    facts: LogoFacts;
-}>;
-export type HeaderLogoContext = HeaderLogoShapeContext | HeaderLogoFactsContext;
-export type HeaderNavigationContext = Readonly<{
-    itemCount: number;
-}>;
-export type HeaderCtaContext = Readonly<{
-    importance: 'low' | 'medium' | 'high';
-}>;
-export type HeaderBannerContext = Readonly<{
-    persistentVisibility: 'none' | 'possible' | 'visible';
-}>;
-export type HeaderSelectionContext = Readonly<{
-    openingSection: HeaderOpeningSectionContext;
-    openingForeground: HeaderOpeningForeground;
-    logo: HeaderLogoContext;
-    navigation: HeaderNavigationContext;
-    cta: HeaderCtaContext;
-    banner: HeaderBannerContext;
-}>;
-export type RejectedHeaderLookReason = 'requires-image-hero-with-contrast-overlay' | 'too-many-nav-items' | LogoAccommodationRejectionReason | 'cta-treatment-unavailable';
-export type RejectedHeaderLook = Readonly<{
-    lookId: HeaderLookId;
-    reasons: readonly RejectedHeaderLookReason[];
-}>;
-export type HeaderSelectionResult = Readonly<{
-    selectedLookId: HeaderLookId;
-    selectedLook: HeaderLookDefinition;
-    header: Theme['header'];
-    brandPresentation: HeaderBrandPresentationSelection;
-    rejected: readonly RejectedHeaderLook[];
-}>;
-export type HeaderLookResolutionInput = Readonly<{
-    theme: Theme;
-    recommendedLookIds: readonly HeaderLookId[];
-    context?: Partial<HeaderSelectionContext>;
-}>;
-export declare const defaultHeaderSelectionContext: HeaderSelectionContext;
-export declare function completeHeaderSelectionContext(context: Partial<HeaderSelectionContext> | undefined): HeaderSelectionContext;
-export declare function resolveHeaderBrandPresentation(input: Readonly<{
-    logo: HeaderLogoContext;
-    accommodations: readonly LogoAccommodationOption[];
-    allowDisplayFallback?: boolean;
-}>): HeaderBrandPresentationPlan;
-export declare const headerLayoutCatalog: readonly [{
-    readonly id: HeaderLayoutId;
-    readonly label: "Classic";
-    readonly description: "Logo and navigation in one practical horizontal row.";
-    readonly variant: "classic";
-    readonly defaultPositioning: "sticky";
-    readonly shrinkOnScroll: false;
-}, {
-    readonly id: HeaderLayoutId;
-    readonly label: "Centered";
-    readonly description: "Logo centered above a balanced navigation row.";
-    readonly variant: "centered";
-    readonly defaultPositioning: "static";
-    readonly shrinkOnScroll: false;
-    readonly maxRecommendedNavItems: 5;
-    readonly allowedLogoShapes: readonly ["none", "text-only", "horizontal", "square"];
-}, {
-    readonly id: HeaderLayoutId;
-    readonly label: "Floating";
-    readonly description: "Detached header chrome that sits over the opening section.";
-    readonly variant: "floating";
-    readonly defaultPositioning: "sticky";
-    readonly shrinkOnScroll: true;
-    readonly maxRecommendedNavItems: 5;
-    readonly allowedLogoShapes: readonly ["none", "text-only", "horizontal"];
-}];
-export declare const headerStyleCatalog: readonly [{
-    readonly id: HeaderStyleId;
-    readonly label: "Minimal";
-    readonly description: "Quiet surface with simple color-change navigation.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "color-change";
-    readonly surface: "neutral";
-    readonly defaultDepth: "none";
-    readonly navTypography: "plain";
-    readonly moods: readonly ["calm", "professional", "editorial"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Seamless";
-    readonly description: "Borderless surface with underline hover for a quieter page transition.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "underline-grow";
-    readonly surface: "neutral";
-    readonly defaultDepth: "none";
-    readonly navTypography: "plain";
-    readonly moods: readonly ["calm", "professional", "editorial"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Soft Bar";
-    readonly description: "Soft tinted surface with gentle pill hover states.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "pill-background";
-    readonly surface: "soft";
-    readonly defaultDepth: "line";
-    readonly navTypography: "plain";
-    readonly moods: readonly ["calm", "professional"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Pill Nav";
-    readonly description: "A calm pill navigation rail over a neutral header.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "pill-background";
-    readonly surface: "soft";
-    readonly defaultDepth: "none";
-    readonly navTypography: "plain";
-    readonly moods: readonly ["calm"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Brand Bar";
-    readonly description: "Solid brand surface with high-contrast navigation.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "color-change";
-    readonly surface: "brand-solid";
-    readonly defaultDepth: "none";
-    readonly navTypography: "brand-caps";
-    readonly moods: readonly ["professional", "expressive", "utility"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Brand Underline";
-    readonly description: "Brand surface with underline-grow navigation.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "underline-grow";
-    readonly surface: "brand-solid";
-    readonly defaultDepth: "none";
-    readonly navTypography: "brand-caps";
-    readonly moods: readonly ["expressive"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Brand Pill";
-    readonly description: "Solid brand surface with rounded active and hover states.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "pill-background";
-    readonly surface: "brand-solid";
-    readonly defaultDepth: "none";
-    readonly navTypography: "brand-caps";
-    readonly moods: readonly ["expressive"];
-}, {
-    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 navInteraction: "pill-background";
-    readonly surface: "brand-solid";
-    readonly defaultDepth: "shadow";
-    readonly navTypography: "quiet-caps";
-    readonly moods: readonly ["expressive", "professional"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Serif Line";
-    readonly description: "Typographic logo treatment with understated underline navigation.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "underline-grow";
-    readonly surface: "bordered";
-    readonly defaultDepth: "line";
-    readonly navTypography: "heading";
-    readonly moods: readonly ["editorial", "calm"];
-}, {
-    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 navInteraction: "flat-block";
-    readonly surface: "bordered";
-    readonly defaultDepth: "shadow";
-    readonly navTypography: "quiet-caps";
-    readonly moods: readonly ["professional", "utility", "expressive"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Glass";
-    readonly description: "Translucent chrome with frosted navigation backing.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "glass-backed";
-    readonly surface: "floating";
-    readonly defaultDepth: "shadow";
-    readonly navTypography: "plain";
-    readonly moods: readonly ["expressive", "calm"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Clear Split";
-    readonly description: "Floating logo with transparent navigation and no shared shell.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "pill-background";
-    readonly surface: "floating";
-    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;
-    readonly label: "Soft Shell";
-    readonly description: "Floating rounded shell with soft pill navigation states.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "pill-background";
-    readonly surface: "floating";
-    readonly defaultDepth: "shadow";
-    readonly navTypography: "plain";
-    readonly moods: readonly ["calm", "professional"];
-}, {
-    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 navInteraction: "glass-backed";
-    readonly surface: "floating";
-    readonly defaultDepth: "shadow";
-    readonly navTypography: "quiet-caps";
-    readonly openingForegroundTarget: "brand-only";
-    readonly moods: readonly ["expressive"];
-}, {
-    readonly id: HeaderStyleId;
-    readonly label: "Split Pill";
-    readonly description: "Logo floats independently with a soft pill-backed navigation rail.";
-    readonly supportedLayoutIds: readonly HeaderLayoutId[];
-    readonly navInteraction: "pill-background";
-    readonly surface: "floating";
-    readonly defaultDepth: "shadow";
-    readonly navTypography: "heading";
-    readonly openingForegroundTarget: "brand-only";
-    readonly moods: readonly ["calm", "editorial"];
-}];
-export declare const legacyHeaderLookAliases: readonly [{
-    readonly lookId: HeaderLookId;
-    readonly selection: {
-        readonly layoutId: HeaderLayoutId;
-        readonly styleId: HeaderStyleId;
-    };
-}, {
-    readonly lookId: HeaderLookId;
-    readonly selection: {
-        readonly layoutId: HeaderLayoutId;
-        readonly styleId: HeaderStyleId;
-    };
-}, {
-    readonly lookId: HeaderLookId;
-    readonly selection: {
-        readonly layoutId: HeaderLayoutId;
-        readonly styleId: HeaderStyleId;
-    };
-}, {
-    readonly lookId: HeaderLookId;
-    readonly selection: {
-        readonly layoutId: HeaderLayoutId;
-        readonly styleId: HeaderStyleId;
-    };
-}, {
-    readonly lookId: HeaderLookId;
-    readonly selection: {
-        readonly layoutId: HeaderLayoutId;
-        readonly styleId: HeaderStyleId;
-    };
-}, {
-    readonly lookId: HeaderLookId;
-    readonly selection: {
-        readonly layoutId: HeaderLayoutId;
-        readonly styleId: HeaderStyleId;
-    };
-}, {
-    readonly lookId: HeaderLookId;
-    readonly selection: {
-        readonly layoutId: HeaderLayoutId;
-        readonly styleId: HeaderStyleId;
-    };
-}, {
-    readonly lookId: HeaderLookId;
-    readonly selection: {
-        readonly layoutId: HeaderLayoutId;
-        readonly styleId: HeaderStyleId;
-    };
-}, {
-    readonly lookId: HeaderLookId;
-    readonly selection: {
-        readonly layoutId: HeaderLayoutId;
-        readonly styleId: HeaderStyleId;
-    };
-}];
-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 resolveLegacyHeaderLookAlias(lookId: HeaderLookId): HeaderLayoutStyleSelection | null;
-export declare function findLegacyHeaderLookIdForSelection(selection: HeaderLayoutStyleSelection): HeaderLookId | null;
-export declare function getCompatibleHeaderStyleIds(layoutId: HeaderLayoutId): readonly HeaderStyleId[];
-export declare function getOrderedHeaderLayoutIdsForCuration(curation: HeaderLayoutStyleCuration): readonly HeaderLayoutId[];
-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, 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'];
-declare function serifLineHeader(theme: Theme): Theme['header'];
-declare function centeredCalmHeader(theme: Theme): Theme['header'];
-declare function practicalUtilityHeader(theme: Theme): Theme['header'];
-declare function minimalTransparentHeader(theme: Theme): Theme['header'];
-declare function transparentOverlayHeader(theme: Theme): Theme['header'];
-declare function floatingGlassHeader(theme: Theme): Theme['header'];
-export declare const headerLookCatalog: readonly [{
-    readonly id: HeaderLookId;
-    readonly label: "Clean base";
-    readonly openingRequirement: "none";
-    readonly logoAccommodations: readonly [{
-        readonly pattern: "title-only";
-        readonly supportedShapes: readonly ["none", "horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["title-only"];
-        readonly size: "compact";
-    }, {
-        readonly pattern: "inline-wordmark";
-        readonly supportedShapes: readonly ["horizontal"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "standard";
-        readonly maxDensity: "detailed";
-    }, {
-        readonly pattern: "inline-mark-with-title";
-        readonly supportedShapes: readonly ["horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["no-text"];
-        readonly supportedDisplayModes: readonly ["logo-plus-title"];
-        readonly size: "compact";
-        readonly maxDensity: "simple";
-    }, {
-        readonly pattern: "popout-badge";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }, {
-        readonly pattern: "logo-plate";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }];
-    readonly compile: typeof cleanBaseHeader;
-}, {
-    readonly id: HeaderLookId;
-    readonly label: "Centered nav";
-    readonly openingRequirement: "none";
-    readonly maxRecommendedNavItems: 6;
-    readonly logoAccommodations: readonly [{
-        readonly pattern: "title-only";
-        readonly supportedShapes: readonly ["none", "horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["title-only"];
-        readonly size: "compact";
-    }, {
-        readonly pattern: "inline-wordmark";
-        readonly supportedShapes: readonly ["horizontal"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "standard";
-        readonly maxDensity: "detailed";
-    }, {
-        readonly pattern: "inline-mark-with-title";
-        readonly supportedShapes: readonly ["horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["no-text"];
-        readonly supportedDisplayModes: readonly ["logo-plus-title"];
-        readonly size: "compact";
-        readonly maxDensity: "simple";
-    }, {
-        readonly pattern: "popout-badge";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }, {
-        readonly pattern: "logo-plate";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }];
-    readonly compile: typeof classicCenteredNavHeader;
-}, {
-    readonly id: HeaderLookId;
-    readonly label: "Brand solid";
-    readonly openingRequirement: "none";
-    readonly logoAccommodations: readonly [{
-        readonly pattern: "title-only";
-        readonly supportedShapes: readonly ["none", "horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["title-only"];
-        readonly size: "compact";
-    }, {
-        readonly pattern: "inline-wordmark";
-        readonly supportedShapes: readonly ["horizontal"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "standard";
-        readonly maxDensity: "detailed";
-    }, {
-        readonly pattern: "inline-mark-with-title";
-        readonly supportedShapes: readonly ["horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["no-text"];
-        readonly supportedDisplayModes: readonly ["logo-plus-title"];
-        readonly size: "compact";
-        readonly maxDensity: "simple";
-    }, {
-        readonly pattern: "popout-badge";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }, {
-        readonly pattern: "logo-plate";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }];
-    readonly compile: typeof solidBrandHeader;
-}, {
-    readonly id: HeaderLookId;
-    readonly label: "Serif line";
-    readonly openingRequirement: "none";
-    readonly maxRecommendedNavItems: 6;
-    readonly logoAccommodations: readonly [{
-        readonly pattern: "title-only";
-        readonly supportedShapes: readonly ["none", "horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["title-only"];
-        readonly size: "compact";
-    }, {
-        readonly pattern: "inline-wordmark";
-        readonly supportedShapes: readonly ["horizontal"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "standard";
-        readonly maxDensity: "detailed";
-    }, {
-        readonly pattern: "inline-mark-with-title";
-        readonly supportedShapes: readonly ["horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["no-text"];
-        readonly supportedDisplayModes: readonly ["logo-plus-title"];
-        readonly size: "compact";
-        readonly maxDensity: "simple";
-    }, {
-        readonly pattern: "centered-masthead";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }, {
-        readonly pattern: "centered-badge";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }];
-    readonly compile: typeof serifLineHeader;
-}, {
-    readonly id: HeaderLookId;
-    readonly label: "Centered calm";
-    readonly openingRequirement: "none";
-    readonly maxRecommendedNavItems: 5;
-    readonly logoAccommodations: readonly [{
-        readonly pattern: "title-only";
-        readonly supportedShapes: readonly ["none", "horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["title-only"];
-        readonly size: "compact";
-    }, {
-        readonly pattern: "inline-wordmark";
-        readonly supportedShapes: readonly ["horizontal"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "standard";
-        readonly maxDensity: "detailed";
-    }, {
-        readonly pattern: "inline-mark-with-title";
-        readonly supportedShapes: readonly ["horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["no-text"];
-        readonly supportedDisplayModes: readonly ["logo-plus-title"];
-        readonly size: "compact";
-        readonly maxDensity: "simple";
-    }, {
-        readonly pattern: "centered-masthead";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }, {
-        readonly pattern: "centered-badge";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }];
-    readonly compile: typeof centeredCalmHeader;
-}, {
-    readonly id: HeaderLookId;
-    readonly label: "Practical utility";
-    readonly openingRequirement: "none";
-    readonly requiresProminentCta: true;
-    readonly logoAccommodations: readonly [{
-        readonly pattern: "title-only";
-        readonly supportedShapes: readonly ["none", "horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["title-only"];
-        readonly size: "compact";
-    }, {
-        readonly pattern: "inline-wordmark";
-        readonly supportedShapes: readonly ["horizontal"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "standard";
-        readonly maxDensity: "detailed";
-    }, {
-        readonly pattern: "inline-mark-with-title";
-        readonly supportedShapes: readonly ["horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["no-text"];
-        readonly supportedDisplayModes: readonly ["logo-plus-title"];
-        readonly size: "compact";
-        readonly maxDensity: "simple";
-    }, {
-        readonly pattern: "popout-badge";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }, {
-        readonly pattern: "logo-plate";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }];
-    readonly compile: typeof practicalUtilityHeader;
-}, {
-    readonly id: HeaderLookId;
-    readonly label: "Minimal transparent";
-    readonly openingRequirement: "reserved-space-ok";
-    readonly logoAccommodations: readonly [{
-        readonly pattern: "title-only";
-        readonly supportedShapes: readonly ["none", "horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["title-only"];
-        readonly size: "compact";
-    }, {
-        readonly pattern: "inline-wordmark";
-        readonly supportedShapes: readonly ["horizontal"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "standard";
-        readonly maxDensity: "detailed";
-    }, {
-        readonly pattern: "inline-mark-with-title";
-        readonly supportedShapes: readonly ["horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["no-text"];
-        readonly supportedDisplayModes: readonly ["logo-plus-title"];
-        readonly size: "compact";
-        readonly maxDensity: "simple";
-    }, {
-        readonly pattern: "popout-badge";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }, {
-        readonly pattern: "logo-plate";
-        readonly supportedShapes: readonly ["square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "display";
-        readonly providesBacking: true;
-    }];
-    readonly compile: typeof minimalTransparentHeader;
-}, {
-    readonly id: HeaderLookId;
-    readonly label: "Transparent overlay";
-    readonly openingRequirement: "requires-image-hero-with-contrast-overlay";
-    readonly maxRecommendedNavItems: 5;
-    readonly logoAccommodations: readonly [{
-        readonly pattern: "title-only";
-        readonly supportedShapes: readonly ["none", "horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["title-only"];
-        readonly size: "compact";
-    }, {
-        readonly pattern: "inline-wordmark";
-        readonly supportedShapes: readonly ["horizontal"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "standard";
-        readonly maxDensity: "detailed";
-    }, {
-        readonly pattern: "inline-mark-with-title";
-        readonly supportedShapes: readonly ["horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["no-text"];
-        readonly supportedDisplayModes: readonly ["logo-plus-title"];
-        readonly size: "compact";
-        readonly maxDensity: "simple";
-    }, {
-        readonly pattern: "inline-logo-only";
-        readonly supportedShapes: readonly ["square"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "compact";
-        readonly providesBacking: false;
-    }];
-    readonly compile: typeof transparentOverlayHeader;
-}, {
-    readonly id: HeaderLookId;
-    readonly label: "Floating glass";
-    readonly openingRequirement: "requires-image-hero-with-contrast-overlay";
-    readonly maxRecommendedNavItems: 5;
-    readonly logoAccommodations: readonly [{
-        readonly pattern: "title-only";
-        readonly supportedShapes: readonly ["none", "horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["title-only"];
-        readonly size: "compact";
-    }, {
-        readonly pattern: "inline-wordmark";
-        readonly supportedShapes: readonly ["horizontal"];
-        readonly supportedTextPresence: readonly ["contains-text", "no-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "standard";
-        readonly maxDensity: "detailed";
-    }, {
-        readonly pattern: "inline-mark-with-title";
-        readonly supportedShapes: readonly ["horizontal", "square", "portrait", "tall"];
-        readonly supportedTextPresence: readonly ["no-text"];
-        readonly supportedDisplayModes: readonly ["logo-plus-title"];
-        readonly size: "compact";
-        readonly maxDensity: "simple";
-    }, {
-        readonly pattern: "inline-logo-only";
-        readonly supportedShapes: readonly ["square"];
-        readonly supportedTextPresence: readonly ["contains-text", "unknown"];
-        readonly supportedDisplayModes: readonly ["logo-only"];
-        readonly size: "compact";
-        readonly providesBacking: false;
-    }];
-    readonly compile: typeof floatingGlassHeader;
-}];
-export declare const guaranteedFallbackHeaderLookId: HeaderLookId;
-export declare const guaranteedFallbackHeaderLayoutId: HeaderLayoutId;
-export declare const guaranteedFallbackHeaderStyleId: HeaderStyleId;
-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 resolveHeaderLook(input: HeaderLookResolutionInput): HeaderSelectionResult;
-export {};