@riverbankcms/sdk 0.79.0 → 0.80.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];
@@ -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[];

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

@@ -8,6 +8,8 @@ import { type FooterLookId, type FooterSelectionContext, type FooterSelectionRes
 import { type HeaderLayoutId, type HeaderSelectionContext, type HeaderLookId, type HeaderSelectionResult, type HeaderStyleId } from './headerLooks';
 import { type CompiledBlockRuntimeFields, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext } from './runtimeCompiler';
 import type { AppearancePresetId, DesignBlockId, SiteStyleId } from './types';
+import { type CuratedSiteStyleTheme } from './siteStyleThemeCompiler';
+export type { CuratedSiteStyleTheme } from './siteStyleThemeCompiler';
 /**
  * Browser-safe public API for Theme V2 live preview compilation.
  *
@@ -27,14 +29,6 @@ export { curatedSiteStyles, defaultButtonPersonalityForSiteStyle, defaultPalette
 export { asTypographyPresetId, compileTypographySelection, evaluateTypographyFontSlot, findTypographyPreset, parsePersistedTypographyPresetId, typographyPresetIdValues, typographyPresets, type CompiledTypographySelection, type GoogleFontCategory, type KnownTypographyPresetId, type KnownTypographyPresetIdValue, type TypographyFontCapability, type TypographyFontSlot, type TypographyFontSlotFit, type TypographyFontSlotPolicy, type TypographyPreset, type TypographyPresetId, type TypographyPresetResolutionWarning, type TypographySelection, } from './typographyPresets';
 export { asDesignBlockId, asSiteStyleId, makeBoundaryId, type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type ResolvedPageDesignPlan, type SiteStyleId, } from './types';
 export declare const previewCustomizePurpose: "preview-customize";
-/**
- * Narrow Theme subtype for curated Site Styles only. Base `Theme` keeps
- * `siteStyleId` optional because not every persisted theme necessarily comes
- * from the curated Site Style catalog.
- */
-export type CuratedSiteStyleTheme = Theme & Readonly<{
-    siteStyleId: SiteStyleId;
-}>;
 /**
  * Compiles a curated Site Style into a persisted Theme payload using the site
  * style's defaults for the Style configurator selections. Thin wrapper around

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

@@ -6,5 +6,7 @@ export type ThemeV2NormalEditorRawStyleFieldName = ThemeV2RuntimeStyleFieldName
 export type ThemeV2CompilerOwnedFieldName = ThemeV2RuntimeStyleFieldName | ThemeV2BlockSpecificRawStyleFieldName;
 export declare const themeV2NormalEditorRawStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
 export declare const themeV2CompilerOwnedFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_cardStyles", "styleGroup", "_contentCardStyles", "_heroLayoutStyles", "_textCardStyles"];
+export declare const pageDesignEditorBackgroundOverrideOwner: "page-design-editor";
+export type PageDesignEditorBackgroundOverrideOwner = typeof pageDesignEditorBackgroundOverrideOwner;
 export declare function isThemeV2NormalEditorRawStyleFieldName(fieldName: string): boolean;
 export declare function isThemeV2NormalEditorRawStylePath(fieldPath: string): boolean;

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

@@ -189,9 +189,13 @@ export declare const defaultComponentRuntimeRules: {
             readonly raised: true;
         };
         readonly inset: {
+            readonly treatment: "soft-panel";
             readonly spacing: "comfortable";
-            readonly rounded: "lg";
+            readonly rounded: "xl";
             readonly raised: false;
+            readonly border: {
+                readonly enabled: false;
+            };
             readonly background: {
                 readonly type: "color";
                 readonly color: "surfaceAlt";
@@ -199,13 +203,12 @@ export declare const defaultComponentRuntimeRules: {
             };
         };
         readonly editorial: {
-            readonly spacing: "medium";
-            readonly rounded: "xl";
+            readonly treatment: "editorial-rule";
+            readonly spacing: "none";
+            readonly rounded: "none";
             readonly raised: false;
-            readonly background: {
-                readonly type: "color";
-                readonly color: "surface";
-                readonly textColor: "text";
+            readonly border: {
+                readonly enabled: false;
             };
         };
     };