@riverbankcms/sdk 0.79.0 → 0.81.0

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

@@ -1,5 +1,6 @@
 import type { Theme, ThemeHeader } from '../schema';
 import { type SiteChromeLookDiagnostics } from './customizableSurfaces';
+import { type 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];
@@ -135,6 +136,11 @@ export type HeaderConfigurationResolution = Readonly<{
 }>;
 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;
@@ -144,7 +150,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 +186,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 +215,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 +224,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 +235,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 +489,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 +536,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 +584,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 +632,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 +680,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 +727,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 +775,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 +816,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,8 @@ export * from './rawStyleFields';
 export * from './records';
 export * from './resolver';
 export * from './runtimeCompiler';
+export * from './sectionTransitions';
+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[];

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

@@ -1,7 +1,9 @@
 import type { BlockAppearanceDesign, BlockAppearanceOptionGroup } from './appearancePresets';
 import type { BlockDesignMetadata, BlockLayoutDesignProfile } from './blockFlow';
 import { type PageDesignIntent } from './pageDesignIntent';
-import { type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type SiteStyleId, type SiteStyleSectionTransitionIntent } from './types';
+import { type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type SiteStyleId } from './types';
+import { type BoundaryOption } from './sectionTransitions';
+export { boundaryOptions, type BoundaryOption } from './sectionTransitions';
 export type PageFlowBoundaryStrategy = 'quiet' | 'balanced' | 'expressive';
 export type PageFlowPreset = Readonly<{
     id: PageFlowPresetId;
@@ -9,11 +11,6 @@ export type PageFlowPreset = Readonly<{
     boundaryStrategy: PageFlowBoundaryStrategy;
     defaultBoundaryOptionId: BoundaryOptionId;
 }>;
-export type BoundaryOption = Readonly<{
-    id: BoundaryOptionId;
-    label: string;
-    transitionAfter: SiteStyleSectionTransitionIntent;
-}>;
 export type PageDesignEditorBlockInput<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     blockId: TBlockId;
     blockKind: string;
@@ -125,23 +122,6 @@ export type PageDesignEditorReadModel<TBlockId extends DesignBlockId = DesignBlo
     boundaries: readonly PageDesignEditorBoundary<TBlockId>[];
     issues: readonly PageDesignEditorIssue<TBlockId>[];
 }>;
-export declare const boundaryOptions: readonly [{
-    readonly id: BoundaryOptionId;
-    readonly label: "None";
-    readonly transitionAfter: "none";
-}, {
-    readonly id: BoundaryOptionId;
-    readonly label: "Soft";
-    readonly transitionAfter: "soft-fade-short";
-}, {
-    readonly id: BoundaryOptionId;
-    readonly label: "Wave";
-    readonly transitionAfter: "wave-edge";
-}, {
-    readonly id: BoundaryOptionId;
-    readonly label: "Spacious";
-    readonly transitionAfter: "soft-fade-long";
-}];
 /**
  * Must remain non-empty; downstream code indexes `[0]` as the documented default.
  */