@riverbankcms/sdk 0.129.0 → 0.130.0

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

@@ -1,5 +1,5 @@
 import type { Theme } from '../schema';
-import { type HeaderLayoutId, type HeaderLookId, type HeaderSelectionContext, type HeaderStyleId } from './headerLooks';
+import type { HeaderLayoutStyleSelection, HeaderLogoContext } from './headerLayoutStyles';
 import type { FooterLookId } from './footerLooks';
 import type { BrandDisplayMode, LogoSizePolicy } from './logoBranding';
 export type HeaderBrandPreferences = Readonly<{
@@ -8,21 +8,14 @@ export type HeaderBrandPreferences = Readonly<{
 }>;
 export declare const defaultHeaderBrandPreferences: HeaderBrandPreferences;
 export declare function headerBrandPreferencesFromTheme(theme: Theme | null | undefined): HeaderBrandPreferences;
-export type HeaderSelectionIdentity = Readonly<{
-    headerLookId: HeaderLookId | null;
-    headerLayoutId: HeaderLayoutId | null;
-    headerStyleId: HeaderStyleId | null;
-}>;
 export type HeaderRecompileDirective = Readonly<{
     kind: 'recompile';
-    selection: HeaderSelectionIdentity;
-    context: HeaderSelectionContext;
+    selection: HeaderLayoutStyleSelection;
     brandPresentation: ReplacementBrandPresentation;
 }>;
 export type HeaderCompilationDirective = Readonly<{
     kind: 'preserve';
     header: Theme['header'];
-    selection: HeaderSelectionIdentity;
 }> | HeaderRecompileDirective;
 export type FooterCompilationDirective = Readonly<{
     kind: 'preserve';
@@ -35,6 +28,7 @@ export type FooterCompilationDirective = Readonly<{
 }>;
 export type ReplacementBrandPresentation = Readonly<{
     kind: 'apply-logo-context';
+    logo: HeaderLogoContext;
 }> | Readonly<{
     kind: 'use-compiled-defaults';
 }>;
@@ -47,12 +41,10 @@ export type SiteThemeCompilationPlan = Readonly<{
     header: HeaderCompilationDirective;
     footer: FooterCompilationDirective;
 }>;
-export declare function replaceSiteStyleCompilationPlan(input?: Readonly<{
-    headerLookId?: HeaderLookId | null;
-    headerLayoutId?: HeaderLayoutId | null;
-    headerStyleId?: HeaderStyleId | null;
+export declare function replaceSiteStyleCompilationPlan(input: Readonly<{
+    headerSelection: HeaderLayoutStyleSelection;
     footerLookId?: FooterLookId | null;
-    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    headerLogo?: HeaderLogoContext;
 }>): Extract<SiteThemeCompilationPlan, {
     kind: 'replace-site-style';
 }>;

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

@@ -1,7 +1,7 @@
 import { type ButtonStyleSelection } from '../buttons/styles';
 import { type KnownCuratedPaletteValueKey } from '../palette/curated';
 import type { Theme } from '../schema';
-import { type HeaderLayoutId, type HeaderLayoutIdValue, type HeaderLookId, type HeaderStyleId } from './headerLooks';
+import { type HeaderLayoutId, type HeaderLayoutStyleSelection, type HeaderStyleId } from './headerLayoutStyles';
 import { type FooterLookId } from './footerLooks';
 import { type CuratedChoice } from './curatedChoices';
 import { type AppearancePresetId, type DesignSystemTemplate, type HeadingDecoration, type NonEmptyReadonlyArray, type SiteStyleId } from './types';
@@ -68,7 +68,11 @@ export type HeaderLayoutStyleChoice = Readonly<{
     layoutId: HeaderLayoutId;
     styleId: HeaderStyleId;
 }>;
-export type RecommendedHeaderStylesByLayout = Readonly<Partial<Record<HeaderLayoutIdValue, NonEmptyReadonlyArray<HeaderStyleChoice>>>>;
+export type HeaderLayoutCuration = Readonly<{
+    layout: HeaderLayoutChoice;
+    styles: NonEmptyReadonlyArray<HeaderStyleChoice>;
+}>;
+export type HeaderCuration = NonEmptyReadonlyArray<HeaderLayoutCuration>;
 export type FaqDefaultBlockVariant = 'default' | 'two-column' | 'question-columns' | 'split-heading-columns';
 export type CuratedSiteStyleDefaultBlockVariants = Readonly<Partial<{
     'block.faq': FaqDefaultBlockVariant;
@@ -116,11 +120,7 @@ export type CuratedSiteStyle = Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -133,6 +133,9 @@ export type CuratedSiteStyle = Readonly<{
 }>;
 export declare function defaultButtonStyleSelectionForSiteStyle(siteStyle: CuratedSiteStyle): ButtonStyleSelection;
 export declare function defaultPaletteForSiteStyle(siteStyle: CuratedSiteStyle): KnownCuratedPaletteValueKey;
+export declare function defaultHeaderSelectionForSiteStyle(siteStyle: CuratedSiteStyle): HeaderLayoutStyleSelection;
+export declare function headerLayoutChoicesForSiteStyle(siteStyle: CuratedSiteStyle): NonEmptyReadonlyArray<HeaderLayoutChoice>;
+export declare function headerStyleChoicesForLayout(siteStyle: CuratedSiteStyle, layoutId: HeaderLayoutId): NonEmptyReadonlyArray<HeaderStyleChoice> | null;
 /**
  * V1 generated site styles are curated product presets, not AI-authored design
  * systems. Generators choose one of these bounded entries, then downstream
@@ -163,11 +166,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -202,11 +201,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -241,11 +236,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -280,11 +271,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -319,11 +306,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -358,11 +341,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -397,11 +376,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -436,11 +411,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -475,11 +446,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -514,11 +481,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -553,11 +516,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -592,11 +551,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -631,11 +586,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -670,11 +621,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -709,11 +656,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -748,11 +691,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -787,11 +726,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -826,11 +761,7 @@ export declare const curatedSiteStyles: readonly [Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;
@@ -866,11 +797,7 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
      */
     headingDecoration: HeadingDecoration;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
-    defaultHeaderSelection: HeaderLayoutStyleChoice;
-    recommendedHeaderLayoutChoices: NonEmptyReadonlyArray<HeaderLayoutChoice>;
-    recommendedHeaderStyleChoicesByLayout: RecommendedHeaderStylesByLayout;
-    discouragedHeaderSelections?: readonly HeaderLayoutStyleChoice[];
-    recommendedHeaderLookIds: readonly HeaderLookId[];
+    headerCuration: HeaderCuration;
     recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonStyleChoices: NonEmptyReadonlyArray<ButtonStyleChoice>;

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

@@ -1,94 +1,21 @@
-import { type DesignBlockId } from './types';
-export type SiteChromeCustomizableSurface = Readonly<{
-    kind: 'site-header';
-}> | Readonly<{
-    kind: 'site-footer';
-}>;
-export type BlockCustomizableSurface = Readonly<{
-    kind: 'block';
-    blockId: DesignBlockId;
-    blockKind: string;
-}>;
-export type CustomizableSurface = BlockCustomizableSurface | SiteChromeCustomizableSurface;
-export type SiteChromePersistenceSurface = 'header' | 'footer';
-export type LookPersistenceTarget = Readonly<{
-    kind: 'page-design';
-    blockId: DesignBlockId;
-}> | Readonly<{
-    kind: 'site-chrome';
-    surface: SiteChromePersistenceSurface;
-}>;
-export type PreviewLookCustomizationCommand<TLookId> = Readonly<{
+export type FooterLookCustomizationCommand<TLookId> = Readonly<{
     kind: 'inspect';
-    surface: CustomizableSurface;
 }> | Readonly<{
     kind: 'cycle';
-    surface: CustomizableSurface;
     direction: 'previous' | 'next';
 }> | Readonly<{
     kind: 'select';
-    surface: CustomizableSurface;
     lookId: TLookId;
 }> | Readonly<{
     kind: 'clear';
-    surface: CustomizableSurface;
 }>;
-export type LookCustomizationWritePlan<TLookId> = Readonly<{
+export type FooterLookCustomizationWritePlan<TLookId> = Readonly<{
     kind: 'no-write';
     command: 'inspect' | 'cycle';
 }> | Readonly<{
     kind: 'write-selection';
-    target: LookPersistenceTarget;
     lookId: TLookId;
 }> | Readonly<{
     kind: 'clear-selection';
-    target: LookPersistenceTarget;
-}>;
-export type SiteChromeLookRejection<TLookId, TReason> = Readonly<{
-    lookId: TLookId;
-    reasons: readonly TReason[];
-}>;
-export type SiteChromeLookDiagnostics<TLookId, TReason> = Readonly<{
-    surface: SiteChromeCustomizableSurface;
-    selectedLookId: TLookId;
-    rejected: readonly SiteChromeLookRejection<TLookId, TReason>[];
-}>;
-export type LookCustomizationOption<TLookId, TIssue> = Readonly<{
-    kind: 'available';
-    lookId: TLookId;
-    label: string;
-}> | Readonly<{
-    kind: 'selected';
-    lookId: TLookId;
-    label: string;
-}> | Readonly<{
-    kind: 'unavailable';
-    lookId: TLookId;
-    label: string;
-    issue: TIssue;
-}>;
-export type LookCustomizationAdapterSnapshot<TSurface extends CustomizableSurface, TLookId, TIssue> = Readonly<{
-    surface: TSurface;
-    selectedLookId: TLookId | null;
-    options: readonly LookCustomizationOption<TLookId, TIssue>[];
-}>;
-export declare function uniqueLookIds<TLookId>(ids: readonly TLookId[]): readonly TLookId[];
-export type ResolvedLook<TLookId, TLook, TReason, TCompiled> = Readonly<{
-    selectedLookId: TLookId;
-    selectedLook: TLook;
-    compiled: TCompiled;
-    rejected: readonly SiteChromeLookRejection<TLookId, TReason>[];
 }>;
-export declare function resolveLook<TLookId, TLook extends Readonly<{
-    id: TLookId;
-}>, TContext, TReason, TCompiled>(input: Readonly<{
-    recommendedLookIds: readonly TLookId[];
-    guaranteedFallbackLookId: TLookId;
-    getLookOrThrow: (lookId: TLookId) => TLook;
-    context: TContext;
-    rejectReasonsForLook: (look: TLook, context: TContext) => readonly TReason[];
-    compileLook: (look: TLook) => TCompiled;
-}>): ResolvedLook<TLookId, TLook, TReason, TCompiled>;
-export declare function mergeWithDefaults<TValue extends Readonly<Record<string, unknown>>>(defaults: TValue, partial: Partial<TValue> | undefined): TValue;
-export declare function persistenceTargetForSurface(surface: CustomizableSurface): LookPersistenceTarget;
-export declare function writePlanForLookCustomizationCommand<TLookId>(command: PreviewLookCustomizationCommand<TLookId>): LookCustomizationWritePlan<TLookId>;
+export declare function writePlanForFooterLookCustomization<TLookId>(command: FooterLookCustomizationCommand<TLookId>): FooterLookCustomizationWritePlan<TLookId>;

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

@@ -144,8 +144,8 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
         raised: "raised";
         editorial: "editorial";
         "color-blocked": "color-blocked";
-        outlined: "outlined";
         inset: "inset";
+        outlined: "outlined";
     }>;
     transitionAfter: z.ZodEnum<{
         none: "none";
@@ -183,9 +183,9 @@ export declare const blockDesignPlanSchema: z.ZodObject<{
     }>>;
     heroTypographyScale: z.ZodOptional<z.ZodEnum<{
         display: "display";
+        poster: "poster";
         editorial: "editorial";
         quiet: "quiet";
-        poster: "poster";
     }>>;
     imageSurfaceTreatment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"none">;
@@ -365,8 +365,8 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
             raised: "raised";
             editorial: "editorial";
             "color-blocked": "color-blocked";
-            outlined: "outlined";
             inset: "inset";
+            outlined: "outlined";
         }>;
         transitionAfter: z.ZodEnum<{
             none: "none";
@@ -404,9 +404,9 @@ export declare const persistedPageDesignStateV1Schema: z.ZodObject<{
         }>>;
         heroTypographyScale: z.ZodOptional<z.ZodEnum<{
             display: "display";
+            poster: "poster";
             editorial: "editorial";
             quiet: "quiet";
-            poster: "poster";
         }>>;
         imageSurfaceTreatment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"none">;

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

@@ -1,11 +1,12 @@
 import { type CompositionBudgetIssue } from './compositionBudget';
-import { type ThemeV2StyleAuthority } from './designState';
+import type { ThemeV2StyleAuthority } from './designState';
 import { type PageDesignIntent } from './pageDesignIntent';
 import { type HeaderOpeningSectionRepair } from './headerOpeningSection';
-import type { HeaderOpeningSectionContext } from './headerLooks';
+import type { HeaderOpeningSectionContext } from './headerLayoutStyles';
 import { type CompiledPageRuntime } from './runtimeCompiler';
 import { type BlockDesignCapabilityMap, type BlockDesignPlan, type DesignBlockId, type DesignRepairResult, type DesignResolutionIssue, type GeneratedPageDesignIntent, type ResolvedPageDesignPlan, type SiteStyleId } from './types';
 import type { CuratedSiteStyle } from './curatedSiteStyles';
+export { buildDeterministicGeneratedPageDesignIntent } from './generatedDesignPipelineHelpers';
 export declare const generatedDesignRetryPolicy: {
     readonly schemaRetries: 1;
     readonly repairPasses: 1;
@@ -64,9 +65,4 @@ export type GeneratedDesignPipelineInput = Readonly<{
     siteStyle: CuratedSiteStyle;
     capabilities: BlockDesignCapabilityMap;
 }>;
-export declare function buildDeterministicGeneratedPageDesignIntent(input: Readonly<{
-    siteStyle: CuratedSiteStyle;
-    blocks: readonly GeneratedDesignBlockDescriptor<DesignBlockId>[];
-}>): GeneratedPageDesignIntent<DesignBlockId>;
 export declare function runGeneratedPageDesignPipeline(input: GeneratedDesignPipelineInput): GeneratedDesignPipelineResult<DesignBlockId>;
-export {};

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

@@ -0,0 +1,17 @@
+import { type ThemeV2StyleAuthority } from './designState';
+import type { CompiledPageRuntime } from './runtimeCompiler';
+import { type DesignBlockId, type GeneratedPageDesignIntent } from './types';
+import type { CuratedSiteStyle } from './curatedSiteStyles';
+export declare function assertCompiledRuntimeFieldsHaveStyleAuthority(input: Readonly<{
+    compiledRuntime: CompiledPageRuntime<DesignBlockId>;
+    styleAuthority: ThemeV2StyleAuthority;
+}>): void;
+export declare function buildDeterministicGeneratedPageDesignIntent(input: Readonly<{
+    siteStyle: CuratedSiteStyle;
+    blocks: readonly Readonly<{
+        blockId: DesignBlockId;
+        blockKind: string;
+        purpose: string;
+    }>[];
+}>): GeneratedPageDesignIntent<DesignBlockId>;
+export declare function brandGeneratedPageDesignIntentBlockIds(intent: GeneratedPageDesignIntent): GeneratedPageDesignIntent<DesignBlockId>;

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

@@ -89,8 +89,8 @@ export declare const generatedBlockDesignIntentSchema: z.ZodObject<{
             raised: "raised";
             editorial: "editorial";
             "color-blocked": "color-blocked";
-            outlined: "outlined";
             inset: "inset";
+            outlined: "outlined";
         }>;
     }, z.core.$strict>], "kind">;
     transitionAfter: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -244,8 +244,8 @@ export declare const generatedPageDesignIntentSchema: z.ZodObject<{
                     raised: "raised";
                     editorial: "editorial";
                     "color-blocked": "color-blocked";
-                    outlined: "outlined";
                     inset: "inset";
+                    outlined: "outlined";
                 }>;
             }, z.core.$strict>], "kind">;
             transitionAfter: z.ZodDiscriminatedUnion<[z.ZodObject<{