@riverbankcms/sdk 0.78.2 → 0.80.0

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

@@ -29,9 +29,10 @@ export declare const generatedSiteStyleIdSchema: z.ZodPipe<z.ZodEnum<{
     "site-style:personal-retreat-journal": "site-style:personal-retreat-journal";
     "site-style:tactile-workshop": "site-style:tactile-workshop";
     "site-style:modern-wellness": "site-style:modern-wellness";
+    "site-style:clarity-zen-blue": "site-style:clarity-zen-blue";
     "site-style:bold-launch": "site-style:bold-launch";
     "site-style:south-west-twerk-school": "site-style:south-west-twerk-school";
-}>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
+}>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
 export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
     sectionSurface: z.ZodDiscriminatedUnion<[z.ZodObject<{
         source: z.ZodLiteral<"generated">;
@@ -81,6 +82,8 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
             flat: "flat";
             none: "none";
             default: "default";
+            inset: "inset";
+            editorial: "editorial";
             raised: "raised";
             outlined: "outlined";
         }>;
@@ -172,9 +175,10 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
         "site-style:personal-retreat-journal": "site-style:personal-retreat-journal";
         "site-style:tactile-workshop": "site-style:tactile-workshop";
         "site-style:modern-wellness": "site-style:modern-wellness";
+        "site-style:clarity-zen-blue": "site-style:clarity-zen-blue";
         "site-style:bold-launch": "site-style:bold-launch";
         "site-style:south-west-twerk-school": "site-style:south-west-twerk-school";
-    }>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
+    }>, z.ZodTransform<SiteStyleId, "site-style:soft-earth" | "site-style:calm-studio" | "site-style:clear-professional" | "site-style:warm-editorial" | "site-style:bright-community" | "site-style:quiet-luxury" | "site-style:practical-services" | "site-style:quiet-practice" | "site-style:personal-retreat-journal" | "site-style:tactile-workshop" | "site-style:modern-wellness" | "site-style:clarity-zen-blue" | "site-style:bold-launch" | "site-style:south-west-twerk-school">>;
     blocks: z.ZodArray<z.ZodObject<{
         blockId: z.ZodString;
         blockKind: z.ZodString;
@@ -228,6 +232,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                     flat: "flat";
                     none: "none";
                     default: "default";
+                    inset: "inset";
+                    editorial: "editorial";
                     raised: "raised";
                     outlined: "outlined";
                 }>;

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

@@ -1,5 +1,6 @@
 import type { Theme, ThemeHeader } from '../schema';
 import { type SiteChromeLookDiagnostics } from './customizableSurfaces';
+import { type 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", "brand-solid", "serif-line", "centered-calm", "practical-utility", "minimal-transparent", "transparent-overlay", "floating-glass"];
 export type HeaderLookIdValue = (typeof headerLookIdValues)[number];
@@ -144,7 +145,7 @@ export type HeaderLookDefinition = Readonly<{
     configuration: HeaderConfiguration;
     openingRequirement: HeaderLookOpeningRequirement;
     maxRecommendedNavItems?: number;
-    allowedLogoShapes?: readonly HeaderLogoShape[];
+    logoAccommodations: readonly LogoAccommodationOption[];
     requiresProminentCta?: boolean;
     compile: (theme: Theme) => Theme['header'];
 }>;
@@ -180,9 +181,19 @@ export type OverlayHeaderOpeningPlan = Readonly<{
     topSpacing: 'preserve' | 'add';
     legibilityFallback: 'none' | 'glass-nav-backing';
 }>;
-export type HeaderLogoContext = Readonly<{
+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;
 }>;
@@ -199,7 +210,7 @@ export type HeaderSelectionContext = Readonly<{
     cta: HeaderCtaContext;
     banner: HeaderBannerContext;
 }>;
-export type RejectedHeaderLookReason = 'requires-image-hero-with-contrast-overlay' | 'too-many-nav-items' | 'logo-shape-incompatible' | 'cta-treatment-unavailable';
+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[];
@@ -208,6 +219,7 @@ export type HeaderSelectionResult = Readonly<{
     selectedLookId: HeaderLookId;
     selectedLook: HeaderLookDefinition;
     header: Theme['header'];
+    brandPresentation: HeaderBrandPresentationSelection;
     rejected: readonly RejectedHeaderLook[];
 }>;
 export type HeaderLookDiagnostics = SiteChromeLookDiagnostics<HeaderLookId, RejectedHeaderLookReason>;
@@ -218,6 +230,11 @@ export type HeaderLookResolutionInput = Readonly<{
 }>;
 export declare const defaultHeaderSelectionContext: HeaderSelectionContext;
 export declare function planOverlayHeaderOpening(opening: HeaderOpeningSectionContext): OverlayHeaderOpeningPlan;
+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";
@@ -467,6 +484,41 @@ export declare const headerLookCatalog: readonly [{
         readonly behavior: "sticky";
     };
     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;
@@ -479,6 +531,41 @@ export declare const headerLookCatalog: readonly [{
         readonly behavior: "sticky-shrink";
     };
     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;
@@ -492,6 +579,41 @@ export declare const headerLookCatalog: readonly [{
     };
     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;
@@ -505,7 +627,41 @@ export declare const headerLookCatalog: readonly [{
     };
     readonly openingRequirement: "none";
     readonly maxRecommendedNavItems: 5;
-    readonly allowedLogoShapes: readonly ["none", "text-only", "horizontal", "square"];
+    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;
@@ -519,6 +675,41 @@ export declare const headerLookCatalog: readonly [{
     };
     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;
@@ -531,6 +722,41 @@ export declare const headerLookCatalog: readonly [{
         readonly behavior: "normal-flow";
     };
     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;
@@ -544,7 +770,34 @@ export declare const headerLookCatalog: readonly [{
     };
     readonly openingRequirement: "requires-image-hero-with-contrast-overlay";
     readonly maxRecommendedNavItems: 5;
-    readonly allowedLogoShapes: readonly ["none", "text-only", "horizontal"];
+    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;
@@ -558,7 +811,34 @@ export declare const headerLookCatalog: readonly [{
     };
     readonly openingRequirement: "requires-image-hero-with-contrast-overlay";
     readonly maxRecommendedNavItems: 5;
-    readonly allowedLogoShapes: readonly ["none", "text-only", "horizontal"];
+    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;

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

@@ -14,6 +14,7 @@ export * from './generatedDesignPipeline';
 export * from './headerLooks';
 export * from './headerOpeningSection';
 export * from './lookResolution';
+export * from './logoBranding';
 export * from './pageDesignAuthority';
 export * from './pageDesignEditorErrors';
 export * from './pageDesignEditorModel';
@@ -24,6 +25,7 @@ export * from './rawStyleFields';
 export * from './records';
 export * from './resolver';
 export * from './runtimeCompiler';
+export * from './siteStyleThemeCompiler';
 export * from './siteStyleBlockPolicies';
 export * from './sourceCatalogs';
 export * from './styleTags';

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

@@ -0,0 +1,193 @@
+import { z } from 'zod';
+export declare const logoTextConfidenceValues: readonly ["low", "medium", "high"];
+export type LogoTextConfidence = 'low' | 'medium' | 'high';
+export type LogoContainsText = Readonly<{
+    kind: 'contains-text';
+    confidence: LogoTextConfidence;
+    text?: string;
+}> | Readonly<{
+    kind: 'no-text';
+    confidence: LogoTextConfidence;
+}> | Readonly<{
+    kind: 'unknown';
+    reason: 'analysis-unavailable' | 'unsupported-file' | 'low-confidence';
+}>;
+export type LogoTextPresence = LogoContainsText['kind'];
+export declare const logoAssetShapeValues: readonly ["none", "horizontal", "square", "portrait", "tall"];
+export type LogoAssetShape = 'none' | 'horizontal' | 'square' | 'portrait' | 'tall';
+export declare const logoKindValues: readonly ["mark", "wordmark", "lockup", "badge", "stacked-wordmark", "unknown"];
+export type LogoKind = 'mark' | 'wordmark' | 'lockup' | 'badge' | 'stacked-wordmark' | 'unknown';
+export declare const logoDensityValues: readonly ["simple", "detailed", "unknown"];
+export type LogoDensity = 'simple' | 'detailed' | 'unknown';
+export type LogoAnalysisSource = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'deterministic';
+    reason: 'dimensions' | 'fallback';
+}> | Readonly<{
+    kind: 'llm';
+    model: 'gpt-5.4-mini';
+    analyzedAt?: string;
+}> | Readonly<{
+    kind: 'manual-override';
+}>;
+export type LogoFacts = Readonly<{
+    shape: LogoAssetShape;
+    containsText: LogoContainsText;
+    kind: LogoKind;
+    density: LogoDensity;
+    source: LogoAnalysisSource;
+}>;
+export declare const logoContainsTextSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"contains-text">;
+    confidence: z.ZodEnum<{
+        medium: "medium";
+        high: "high";
+        low: "low";
+    }>;
+    text: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"no-text">;
+    confidence: z.ZodEnum<{
+        medium: "medium";
+        high: "high";
+        low: "low";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"unknown">;
+    reason: z.ZodEnum<{
+        "analysis-unavailable": "analysis-unavailable";
+        "unsupported-file": "unsupported-file";
+        "low-confidence": "low-confidence";
+    }>;
+}, z.core.$strip>], "kind">;
+export declare const logoAnalysisSourceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"none">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"deterministic">;
+    reason: z.ZodEnum<{
+        fallback: "fallback";
+        dimensions: "dimensions";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"llm">;
+    model: z.ZodLiteral<"gpt-5.4-mini">;
+    analyzedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"manual-override">;
+}, z.core.$strip>], "kind">;
+export declare const logoFactsSchema: z.ZodObject<{
+    shape: z.ZodEnum<{
+        none: "none";
+        square: "square";
+        horizontal: "horizontal";
+        portrait: "portrait";
+        tall: "tall";
+    }>;
+    containsText: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"contains-text">;
+        confidence: z.ZodEnum<{
+            medium: "medium";
+            high: "high";
+            low: "low";
+        }>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"no-text">;
+        confidence: z.ZodEnum<{
+            medium: "medium";
+            high: "high";
+            low: "low";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"unknown">;
+        reason: z.ZodEnum<{
+            "analysis-unavailable": "analysis-unavailable";
+            "unsupported-file": "unsupported-file";
+            "low-confidence": "low-confidence";
+        }>;
+    }, z.core.$strip>], "kind">;
+    kind: z.ZodEnum<{
+        unknown: "unknown";
+        mark: "mark";
+        wordmark: "wordmark";
+        lockup: "lockup";
+        badge: "badge";
+        "stacked-wordmark": "stacked-wordmark";
+    }>;
+    density: z.ZodEnum<{
+        unknown: "unknown";
+        simple: "simple";
+        detailed: "detailed";
+    }>;
+    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"none">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"deterministic">;
+        reason: z.ZodEnum<{
+            fallback: "fallback";
+            dimensions: "dimensions";
+        }>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"llm">;
+        model: z.ZodLiteral<"gpt-5.4-mini">;
+        analyzedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"manual-override">;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>;
+export type BrandDisplayMode = 'auto' | 'logo-only' | 'logo-plus-title' | 'title-only';
+export declare const brandDisplayModeValues: readonly ["auto", "logo-only", "logo-plus-title", "title-only"];
+export type ResolvedBrandDisplay = 'logo-only' | 'logo-plus-title' | 'title-only';
+export declare const logoAccommodationPatternValues: readonly ["title-only", "inline-logo-only", "inline-wordmark", "inline-mark-with-title", "logo-plate", "centered-badge", "popout-badge", "centered-masthead", "hero-badge"];
+export type LogoAccommodationPattern = 'title-only' | 'inline-logo-only' | 'inline-wordmark' | 'inline-mark-with-title' | 'logo-plate' | 'centered-badge' | 'popout-badge' | 'centered-masthead' | 'hero-badge';
+export declare const logoSizePolicyValues: readonly ["auto", "compact", "standard", "generous", "display"];
+export type LogoSizePolicy = 'auto' | 'compact' | 'standard' | 'generous' | 'display';
+export type ResolvedLogoSize = Exclude<LogoSizePolicy, 'auto'>;
+export type LogoAccommodationOption = Readonly<{
+    pattern: LogoAccommodationPattern;
+    supportedShapes: readonly LogoAssetShape[];
+    supportedTextPresence: readonly LogoTextPresence[];
+    supportedDisplayModes: readonly ResolvedBrandDisplay[];
+    /** Minimum readable size for this accommodation; explicit user size can only increase it. */
+    size: ResolvedLogoSize;
+    providesBacking?: boolean;
+    maxDensity?: Exclude<LogoDensity, 'unknown'>;
+}>;
+export type LogoAccommodationRejectionReason = 'logo-shape-incompatible' | 'logo-text-incompatible' | 'display-mode-incompatible' | 'logo-too-detailed-for-compact-slot' | 'requires-logo-backing' | 'no-compatible-accommodation';
+export type RejectedLogoAccommodation = Readonly<{
+    pattern: LogoAccommodationPattern;
+    reasons: readonly LogoAccommodationRejectionReason[];
+}>;
+export type HeaderBrandPresentationSelection = Readonly<{
+    kind: 'selected';
+    display: ResolvedBrandDisplay;
+    accommodation: LogoAccommodationOption;
+    size: ResolvedLogoSize;
+    repairedDisplay?: Readonly<{
+        requested: ResolvedBrandDisplay;
+        reason: 'no-compatible-accommodation';
+    }>;
+    rejected: readonly RejectedLogoAccommodation[];
+}>;
+export type HeaderBrandPresentationRejection = Readonly<{
+    kind: 'rejected';
+    display: ResolvedBrandDisplay;
+    reasons: readonly LogoAccommodationRejectionReason[];
+    rejected: readonly RejectedLogoAccommodation[];
+}>;
+export type HeaderBrandPresentationPlan = HeaderBrandPresentationSelection | HeaderBrandPresentationRejection;
+export declare const defaultNoLogoFacts: LogoFacts;
+export declare function deterministicLogoFactsForShape(shape: LogoAssetShape): LogoFacts;
+export declare function resolveBrandDisplay(mode: BrandDisplayMode, logoFacts: LogoFacts): ResolvedBrandDisplay;
+export declare function selectLogoAccommodation(input: Readonly<{
+    options: readonly LogoAccommodationOption[];
+    logoFacts: LogoFacts;
+    display: ResolvedBrandDisplay;
+    sizePolicy?: LogoSizePolicy;
+}>): HeaderBrandPresentationPlan;
+export declare function rejectReasonsForAccommodation(input: Readonly<{
+    option: LogoAccommodationOption;
+    logoFacts: LogoFacts;
+    display: ResolvedBrandDisplay;
+}>): readonly LogoAccommodationRejectionReason[];