@riverbankcms/sdk 0.60.16 → 0.62.4

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

@@ -0,0 +1,448 @@
+export declare const blockAppearancePresets: readonly [{
+    readonly kind: "block-design";
+    readonly id: "hero-immersive-image";
+    readonly target: "hero";
+    readonly label: "Immersive image hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly constraints: {
+        readonly layoutFamilies: readonly ["centered", "compact"];
+    };
+    readonly design: {
+        readonly sectionSurface: "hero-image";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly sectionHeight: "hero";
+        readonly imageSurfaceTreatment: {
+            readonly kind: "neutral-wash";
+        };
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "hero-brand-scrim";
+    readonly target: "hero";
+    readonly label: "Brand scrim image hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly constraints: {
+        readonly layoutFamilies: readonly ["centered", "compact"];
+    };
+    readonly optionGroups: readonly [{
+        readonly id: "image-surface-treatment";
+        readonly label: "Treatment";
+        readonly selectedOptionId: "brand-scrim-primary";
+        readonly options: readonly [{
+            readonly id: "brand-scrim-primary";
+            readonly label: "Brand scrim";
+            readonly designPatch: {
+                readonly imageSurfaceTreatment: {
+                    readonly kind: "brand-scrim";
+                    readonly token: "primary";
+                };
+            };
+        }, {
+            readonly id: "neutral-scrim";
+            readonly label: "Neutral scrim";
+            readonly designPatch: {
+                readonly imageSurfaceTreatment: {
+                    readonly kind: "neutral-scrim";
+                };
+            };
+        }];
+    }];
+    readonly layoutPatches: readonly [{
+        readonly constraints: {
+            readonly layoutVariantKeys: readonly ["micro"];
+        };
+        readonly designPatch: {
+            readonly sectionHeight: "banner";
+        };
+    }];
+    readonly design: {
+        readonly sectionSurface: "hero-image";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly sectionHeight: "immersive";
+        readonly imageSurfaceTreatment: {
+            readonly kind: "brand-scrim";
+            readonly token: "primary";
+        };
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "hero-brand-scrim-fixed-frame";
+    readonly target: "hero";
+    readonly label: "Fixed-frame brand scrim hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly constraints: {
+        readonly layoutFamilies: readonly ["centered", "compact"];
+    };
+    readonly optionGroups: readonly [{
+        readonly id: "image-surface-treatment";
+        readonly label: "Treatment";
+        readonly selectedOptionId: "brand-scrim-primary";
+        readonly options: readonly [{
+            readonly id: "brand-scrim-primary";
+            readonly label: "Brand scrim";
+            readonly designPatch: {
+                readonly imageSurfaceTreatment: {
+                    readonly kind: "brand-scrim";
+                    readonly token: "primary";
+                };
+            };
+        }, {
+            readonly id: "neutral-scrim";
+            readonly label: "Neutral scrim";
+            readonly designPatch: {
+                readonly imageSurfaceTreatment: {
+                    readonly kind: "neutral-scrim";
+                };
+            };
+        }];
+    }];
+    readonly layoutPatches: readonly [{
+        readonly constraints: {
+            readonly layoutVariantKeys: readonly ["micro"];
+        };
+        readonly designPatch: {
+            readonly sectionHeight: "banner";
+        };
+    }];
+    readonly design: {
+        readonly sectionSurface: "hero-image";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly sectionHeight: "immersive";
+        readonly imageSurfaceTreatment: {
+            readonly kind: "brand-scrim";
+            readonly token: "primary";
+        };
+        readonly imageSurfaceMotion: "fixed-frame";
+        readonly eyebrowTreatment: "accent-pill-bounce";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "hero-brand-depth-expressive";
+    readonly target: "hero";
+    readonly label: "Expressive brand-depth hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly constraints: {
+        readonly layoutFamilies: readonly ["centered", "compact"];
+    };
+    readonly design: {
+        readonly sectionSurface: "brand-depth-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly eyebrowTreatment: "accent-pill-bounce";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "hero-contained-intro";
+    readonly target: "hero";
+    readonly label: "Contained intro hero";
+    readonly blockKinds: readonly ["block.hero"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "inset";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "body-text-editorial-intro";
+    readonly target: "body-text";
+    readonly label: "Editorial intro copy";
+    readonly blockKinds: readonly ["block.body-text"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "body-text-brand-depth-intro";
+    readonly target: "body-text";
+    readonly label: "Brand-depth intro copy";
+    readonly blockKinds: readonly ["block.body-text"];
+    readonly design: {
+        readonly sectionSurface: "brand-depth-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "offerings-calm-list";
+    readonly target: "offerings";
+    readonly label: "Calm offerings list";
+    readonly blockKinds: readonly ["block.event-listing", "block.event-calendar", "block.event-spotlight", "block.product-list"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "events-base-calendar";
+    readonly target: "events";
+    readonly label: "Base event calendar";
+    readonly blockKinds: readonly ["block.event-calendar", "block.event-listing"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "schedule-details-accent-section";
+    readonly target: "events";
+    readonly label: "Accent schedule details";
+    readonly blockKinds: readonly ["block.event-details", "block.course-details"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "schedule-details-brand-depth";
+    readonly target: "events";
+    readonly label: "Brand-depth schedule details";
+    readonly blockKinds: readonly ["block.event-details", "block.course-details"];
+    readonly design: {
+        readonly sectionSurface: "brand-depth-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+        readonly tileTreatment: "brand-depth";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "media-text-flush-feature";
+    readonly target: "media-text";
+    readonly label: "Flush media feature";
+    readonly blockKinds: readonly ["block.media-text"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "flush-panel";
+            treatment: import("@riverbankcms/blocks").FlushFrameTreatment;
+            bleed: "start";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "media-text-quiet-story";
+    readonly target: "media-text";
+    readonly label: "Quiet media story";
+    readonly blockKinds: readonly ["block.media-text"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-carded-proof";
+    readonly target: "testimonials";
+    readonly label: "Carded social proof";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "default";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-contained-proof";
+    readonly target: "testimonials";
+    readonly label: "Contained social proof";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "raised";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-dark-proof";
+    readonly target: "testimonials";
+    readonly label: "Dark proof panel";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "raised";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "testimonials-accent-quote-proof";
+    readonly target: "testimonials";
+    readonly label: "Accent quote proof";
+    readonly blockKinds: readonly ["block.testimonials"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "raised";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+        readonly testimonialCardTreatment: "accent-quote";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "faq-base-accordion";
+    readonly target: "faq";
+    readonly label: "Base accordion FAQ";
+    readonly blockKinds: readonly ["block.faq"];
+    readonly design: {
+        readonly sectionSurface: "base";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "default";
+        readonly transitionAfter: "none";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "faq-contained-help";
+    readonly target: "faq";
+    readonly label: "Contained help panel";
+    readonly blockKinds: readonly ["block.faq"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "inset";
+        }>;
+        readonly itemSurface: "default";
+        readonly transitionAfter: "none";
+        readonly emphasis: "low";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "contact-form-panel";
+    readonly target: "contact-form";
+    readonly label: "Contact form panel";
+    readonly blockKinds: readonly ["block.form"];
+    readonly design: {
+        readonly sectionSurface: "muted-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "medium";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "contact-form-dark-card";
+    readonly target: "contact-form";
+    readonly label: "Dark form card";
+    readonly blockKinds: readonly ["block.form"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "soft-fade-short";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "contact-form-brand-depth-card";
+    readonly target: "contact-form";
+    readonly label: "Brand-depth form card";
+    readonly blockKinds: readonly ["block.form"];
+    readonly design: {
+        readonly sectionSurface: "brand-depth-band";
+        readonly contentFrame: Readonly<{
+            kind: "panel";
+            treatment: "raised";
+        }>;
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
+    };
+}, {
+    readonly kind: "block-design";
+    readonly id: "cta-accent-band";
+    readonly target: "cta";
+    readonly label: "Accent CTA band";
+    readonly blockKinds: readonly ["block.cta-full"];
+    readonly design: {
+        readonly sectionSurface: "accent-band";
+        readonly contentFrame: {
+            readonly kind: "plain";
+        };
+        readonly itemSurface: "none";
+        readonly transitionAfter: "none";
+        readonly emphasis: "high";
+    };
+}];

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

@@ -1,6 +1,8 @@
 import { type ButtonPersonalityId, type KnownButtonPersonalityId } from '../buttons/personalities';
 import { type KnownPaletteVariantId, type PaletteVariantId } from '../palette/variants';
 import type { Theme } from '../schema';
+import { type HeaderLookId } from './headerLooks';
+import { type FooterLookId } from './footerLooks';
 import { type CuratedChoice } from './curatedChoices';
 import { type AppearancePresetId, type DesignSystemTemplate, type NonEmptyReadonlyArray, type SiteStyleId } from './types';
 export declare const curatedSiteStyleIdValues: readonly ["site-style:calm-studio", "site-style:clear-professional", "site-style:warm-editorial", "site-style:bright-community", "site-style:quiet-luxury", "site-style:practical-services", "site-style:modern-wellness", "site-style:bold-launch", "site-style:south-west-twerk-school"];
@@ -11,6 +13,7 @@ type CuratedSiteStyleHeroOverrides = Readonly<{
 type CuratedSiteStyleBodyTextOverrides = Readonly<{
     intro?: NonNullable<NonNullable<Theme['bodyText']>['intro']>;
 }>;
+type CuratedSiteStyleInputOverrides = NonNullable<Theme['inputs']>;
 /**
  * Site-style-specific Theme overrides are applied after token recipes,
  * button personality, and palette variant selection have compiled the base
@@ -21,6 +24,11 @@ export type CuratedSiteStyleThemeOverrides = Readonly<{
     typography?: Theme['typography'];
     hero?: CuratedSiteStyleHeroOverrides;
     bodyText?: CuratedSiteStyleBodyTextOverrides;
+    /**
+     * Inputs are authored as a complete system rather than sparsely merged so
+     * site styles can curate accessible, internally consistent control states.
+     */
+    inputs?: CuratedSiteStyleInputOverrides;
 }>;
 export type ButtonPersonalityChoice = CuratedChoice<KnownButtonPersonalityId>;
 export type PaletteVariantChoice = CuratedChoice<KnownPaletteVariantId>;
@@ -33,6 +41,8 @@ export type CuratedSiteStyle = Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -54,6 +64,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -67,6 +79,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -80,6 +94,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -93,6 +109,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -106,6 +124,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -119,6 +139,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -132,6 +154,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -145,6 +169,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -158,6 +184,8 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */
@@ -172,6 +200,8 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     template: DesignSystemTemplate;
     themeOverrides?: CuratedSiteStyleThemeOverrides;
     recommendedAppearancePresetIds: readonly AppearancePresetId[];
+    recommendedHeaderLookIds: readonly HeaderLookId[];
+    recommendedFooterLookIds: readonly FooterLookId[];
     /** Authored picker choices. First item is the default/fallback. */
     buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
     /** Authored picker choices. First item is the default/fallback. */

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

@@ -0,0 +1,94 @@
+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<{
+    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<{
+    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>;