@riverbankcms/sdk 0.123.0 → 0.124.0

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

@@ -235,6 +235,7 @@ export type HeaderLookResolutionInput = Readonly<{
 }>;
 export declare const defaultHeaderSelectionContext: HeaderSelectionContext;
 export declare function planOverlayHeaderOpening(opening: HeaderOpeningSectionContext): OverlayHeaderOpeningPlan;
+export declare function completeHeaderSelectionContext(context: Partial<HeaderSelectionContext> | undefined): HeaderSelectionContext;
 export declare function resolveHeaderBrandPresentation(input: Readonly<{
     logo: HeaderLogoContext;
     accommodations: readonly LogoAccommodationOption[];

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

@@ -3,6 +3,7 @@ export * from './appearancePresets';
 export * from './blockFlow';
 export * from './backgroundAppearance';
 export * from './compositionBudget';
+export * from './compilationPlan';
 export * from './contentTemplateDesignIntent';
 export * from './contentTemplateRuntimeCompiler';
 export * from './curatedChoices';

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

@@ -4,7 +4,8 @@ import { type ButtonStyleSelection } from '../buttons/styles';
 import type { CompleteResolvedPaletteSelection, PaletteSelection } from '../palette';
 import { type CuratedSiteStyle } from './curatedSiteStyles';
 import { type FooterLookId, type FooterSelectionResult } from './footerLooks';
-import { type HeaderLayoutId, type HeaderSelectionContext, type HeaderLookId, type HeaderSelectionResult, type HeaderStyleId } from './headerLooks';
+import type { HeaderSelectionIdentity, SiteThemeCompilationPlan } from './compilationPlan';
+import { type HeaderLayoutId, type HeaderLookId, type HeaderSelectionResult, type HeaderStyleId } from './headerLooks';
 import { type CompiledBlockRuntimeFields, type CompiledBoundaryRuntime, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext } from './runtimeCompiler';
 import { type AppearancePresetId, type DesignBlockId, type SiteStyleId } from './types';
 import { type CuratedSiteStyleTheme } from './siteStyleThemeCompiler';
@@ -44,22 +45,35 @@ type SiteThemeSelectionsCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
     buttonStyleSelection: ButtonStyleSelection | null;
     typography?: Theme['typography'];
-    /**
-     * Concrete footer presentation is independent of the selectable footer link
-     * treatment. Existing sites pass it through recompilation so choosing another
-     * style axis cannot reset footer structure, surfaces, branding, or legal layout.
-     */
-    footerPresentation?: Theme['footer'];
-    headerLookId?: HeaderLookId | null;
-    headerLayoutId?: HeaderLayoutId | null;
-    headerStyleId?: HeaderStyleId | null;
-    footerLookId?: FooterLookId | null;
-    headerSelectionContext?: Partial<HeaderSelectionContext>;
+    resolvedPalette: CompleteResolvedPaletteSelection;
+}>;
+export type ReplacementSiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
+    compilationPlan: Extract<SiteThemeCompilationPlan, {
+        kind: 'replace-site-style';
+    }>;
+}>;
+export type UpdateSiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
+    compilationPlan: Extract<SiteThemeCompilationPlan, {
+        kind: 'update-selection';
+    }>;
 }>;
 export type SiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
-    resolvedPalette: CompleteResolvedPaletteSelection;
+    compilationPlan: SiteThemeCompilationPlan;
 }>;
-type SiteThemeSelectionsBaseResult = Readonly<{
+type ResolvedSiteThemeSelections = Readonly<{
+    buttonStyleSelection: ButtonStyleSelection;
+    paletteSelection: PaletteSelection | null;
+    headerLookId: HeaderLookId | null;
+    headerLayoutId: HeaderLayoutId | null;
+    headerStyleId: HeaderStyleId | null;
+    footerLookId: FooterLookId | null;
+}>;
+type ReplacementResolvedSiteThemeSelections = ResolvedSiteThemeSelections & Readonly<{
+    headerLayoutId: HeaderLayoutId;
+    headerStyleId: HeaderStyleId;
+    footerLookId: FooterLookId;
+}>;
+type SiteThemeSelectionsBaseResult<TResolvedSelections extends ResolvedSiteThemeSelections> = Readonly<{
     theme: CuratedSiteStyleTheme;
     requestedSelections: Readonly<{
         headerLookId: HeaderLookId | null;
@@ -67,19 +81,26 @@ type SiteThemeSelectionsBaseResult = Readonly<{
         headerStyleId: HeaderStyleId | null;
         footerLookId: FooterLookId | null;
     }>;
-    resolvedSelections: Readonly<{
-        buttonStyleSelection: ButtonStyleSelection;
-        paletteSelection: PaletteSelection | null;
-        headerLookId: HeaderLookId | null;
-        headerLayoutId: HeaderLayoutId;
-        headerStyleId: HeaderStyleId;
-        footerLookId: FooterLookId;
+    resolvedSelections: TResolvedSelections;
+    headerCompilation: Readonly<{
+        kind: 'preserved';
+        selection: HeaderSelectionIdentity;
+    }> | Readonly<{
+        kind: 'recompiled';
+        result: HeaderSelectionResult;
+    }>;
+    footerCompilation: Readonly<{
+        kind: 'preserved';
+        footerLookId: FooterLookId | null;
+    }> | Readonly<{
+        kind: 'applied-look';
+        result: FooterSelectionResult;
     }>;
-    headerSelection: HeaderSelectionResult;
-    footerSelection: FooterSelectionResult;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>;
-export type SiteThemeSelectionsResult = SiteThemeSelectionsBaseResult;
+export type ReplacementSiteThemeSelectionsResult = SiteThemeSelectionsBaseResult<ReplacementResolvedSiteThemeSelections>;
+export type UpdateSiteThemeSelectionsResult = SiteThemeSelectionsBaseResult<ResolvedSiteThemeSelections>;
+export type SiteThemeSelectionsResult = ReplacementSiteThemeSelectionsResult | UpdateSiteThemeSelectionsResult;
 /**
  * High-level, site-style-aware compiler. Resolves the user's button style and
  * palette selections into theme tokens. Palette authority is always supplied
@@ -89,6 +110,8 @@ export type SiteThemeSelectionsResult = SiteThemeSelectionsBaseResult;
  * any fallback warnings the UI can surface as "we changed your selection"
  * notices.
  */
+export declare function compileSiteThemeFromSelections(input: ReplacementSiteThemeSelectionsInput): ReplacementSiteThemeSelectionsResult;
+export declare function compileSiteThemeFromSelections(input: UpdateSiteThemeSelectionsInput): UpdateSiteThemeSelectionsResult;
 export declare function compileSiteThemeFromSelections(input: SiteThemeSelectionsInput): SiteThemeSelectionsResult;
 export declare function siteStyleIdFromTheme(theme: Pick<Theme, 'siteStyleId'> | null | undefined): SiteStyleId | null;
 export type EditorModelRuntimeLookOverride<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{