@riverbankcms/sdk 0.104.3 → 0.108.0

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

@@ -1,7 +1,7 @@
 import type { BlockAppearanceDesign, BlockAppearanceOptionGroup } from './appearancePresets';
 import type { BlockDesignMetadata, BlockLayoutDesignProfile } from './blockFlow';
 import { type PageDesignIntent } from './pageDesignIntent';
-import { type AppearancePresetId, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type SiteStyleId } from './types';
+import { type AppearancePresetId, type BlockDesignCapability, type BoundaryOptionId, type DesignBlockId, type DesignBoundaryId, type LayoutVariantKey, type NonEmptyReadonlyArray, type PageFlowPresetId, type SiteStyleId, type UnsupportedBlockDesignCapabilityReason } from './types';
 import { type BoundaryOption } from './sectionTransitions';
 export { boundaryOptions, type BoundaryOption } from './sectionTransitions';
 export type PageFlowBoundaryStrategy = 'quiet' | 'balanced' | 'expressive';
@@ -17,8 +17,16 @@ export type PageDesignEditorBlockInput<TBlockId extends DesignBlockId = DesignBl
     currentContentId?: string | null;
     currentLayoutVariantKey?: LayoutVariantKey | null;
     designMetadata?: BlockDesignMetadata | null;
+    designCapability?: BlockDesignCapability | null;
     layoutOptionLabels?: Readonly<Record<string, string>>;
 }>;
+export type PageDesignEditorBackgroundSupport = Readonly<{
+    kind: 'supported';
+    richBackgrounds: 'supported' | 'unsupported';
+}> | Readonly<{
+    kind: 'unsupported';
+    reason: UnsupportedBlockDesignCapabilityReason | 'section-surfaces-unsupported' | 'missing-design-capability';
+}>;
 export type PageDesignEditorChoice<TValue> = Readonly<{
     kind: 'auto';
     effectiveValue: TValue | null;
@@ -53,17 +61,30 @@ export type PageDesignEditorLayoutOption = Readonly<{
 export type PageDesignEditorLooksForLayout = Readonly<{
     layoutVariantKey: LayoutVariantKey;
     availableLooks: readonly PageDesignEditorLookOption[];
+    autoLookId: AppearancePresetId | null;
 }>;
 export type PageDesignEditorBlockContentRevision = Readonly<{
     contentId: string | null;
 }>;
+export type PageDesignEditorLookAvailability = Readonly<{
+    kind: 'not-applicable';
+    reason: 'block-has-no-looks' | 'block-not-designed' | 'missing-design-capability';
+}> | Readonly<{
+    kind: 'available';
+}> | Readonly<{
+    kind: 'misconfigured';
+    reason: 'empty-look-catalog';
+}>;
 export type PageDesignEditorBlock<TBlockId extends DesignBlockId = DesignBlockId> = Readonly<{
     blockId: TBlockId;
     blockKind: string;
+    backgroundSupport: PageDesignEditorBackgroundSupport;
     contentRevision?: PageDesignEditorBlockContentRevision;
     layout: PageDesignEditorSelection<LayoutVariantKey> | null;
     availableLayouts: readonly PageDesignEditorLayoutOption[];
     availableLooksByLayout: readonly PageDesignEditorLooksForLayout[];
+    autoLookId: AppearancePresetId | null;
+    lookAvailability: PageDesignEditorLookAvailability;
     look: PageDesignEditorChoice<AppearancePresetId>;
     availableLooks: readonly PageDesignEditorLookOption[];
 }>;
@@ -165,6 +186,8 @@ export type PageDesignLayoutLookCompatibilityPlan = Readonly<{
     kind: 'layout-supported';
     layout: PageDesignEditorSelection<LayoutVariantKey>;
     availableLooks: readonly PageDesignEditorLookOption[];
+    autoLookId: AppearancePresetId | null;
+    lookAvailability: PageDesignEditorLookAvailability;
     look: PageDesignEditorChoice<AppearancePresetId>;
     lookIntentChange: PageDesignLayoutLookIntentChange;
 }>;

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

@@ -1,10 +1,8 @@
 import type { PageDesignEditorReadModel } from './pageDesignEditorModel';
 import { type Theme } from '../schema';
 import { type ButtonPersonalityId } from '../buttons/personalities';
-import { type PaletteOverrides, type CuratedPaletteId } from '../palette/curated';
-import type { PaletteSelection, ResolvedPaletteSelection } from '../palette';
+import type { CompleteResolvedPaletteSelection, PaletteSelection } from '../palette';
 import { type CuratedSiteStyle } from './curatedSiteStyles';
-import { type CompiledTypographySelection, type KnownTypographyPresetId, type TypographyPresetId, type TypographyPresetResolutionWarning, type TypographySelection } from './typographyPresets';
 import { type FooterLookId, type FooterSelectionContext, type FooterSelectionResult } from './footerLooks';
 import { type HeaderLayoutId, type HeaderSelectionContext, 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';
@@ -26,33 +24,26 @@ export { repairDesignIssue, resolveBlockDesignPlan } from './resolver';
 export { cycleableOptionsFromResolved, deriveDesignCustomizationScope, recommendedDesignOption, type CycleableDesignOption, type CycleableOptions, type DesignCustomizationAuthority, type DesignCustomizationScope, type DesignCustomizationSurface, type DesignCustomizationUnsupportedReason, type DesignOptionIssue, type ResolvedDesignOption, } from './previewCustomization';
 export { compileBlockRuntimeFields, compileBoundaryRuntime, compilePageRuntimeFields, compileTokenRecipes, compileTransitionRuntime, compiledRuntimeStyleFieldNames, defaultComponentRuntimeRules, defaultDesignRuntimeRules, surfaceResolutionContextFromPalette, surfaceResolutionContextFromTheme, stripCompiledRuntimeStyleFields, type CompiledBlockRuntime, type CompiledBlockRuntimeFields, type CompiledBoundaryRuntime, type CompiledPageRuntime, type CompileBlockRuntimeInput, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, type SurfaceResolutionContext, } from './runtimeCompiler';
 export { defaultCuratedChoice, requireEntriesForCuratedChoices, resolveCuratedChoice, type CuratedChoice, type CuratedChoiceResolution, } from './curatedChoices';
-export { curatedSiteStyles, defaultButtonPersonalityForSiteStyle, defaultPaletteForSiteStyle, defaultTypographyPresetForSiteStyle, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
-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 { curatedSiteStyles, defaultButtonPersonalityForSiteStyle, defaultPaletteForSiteStyle, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
 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";
 /**
  * Compiles a curated Site Style into a persisted Theme payload using the site
  * style's defaults for the Style configurator selections. Thin wrapper around
- * `compileSiteThemeFromSelections({…, null, null, null})`.
+ * `compileSiteThemeFromSelections` with the style's default curated palette.
  */
 export declare function compileCuratedSiteStyleTheme(siteStyle: CuratedSiteStyle): CuratedSiteStyleTheme;
+export declare function defaultResolvedPaletteForSiteStyle(siteStyle: CuratedSiteStyle): CompleteResolvedPaletteSelection;
 export declare function compileCuratedSiteStyleThemeById(siteStyleId: SiteStyleId): CuratedSiteStyleTheme | null;
 export type SelectionFallbackWarning = Readonly<{
     kind: 'rejected-personality';
     requested: string;
     fellBackTo: ButtonPersonalityId;
-}> | Readonly<{
-    kind: 'rejected-palette';
-    requested: string;
-    fellBackTo: CuratedPaletteId;
-}> | TypographyPresetResolutionWarning;
+}>;
 type SiteThemeSelectionsCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
     buttonPersonalityId: ButtonPersonalityId | null;
-    typographyPresetId?: TypographyPresetId | null;
-    typographyBodyFontOverride?: string | null;
-    typographyHeadingFontOverride?: string | null;
-    typographySelection?: TypographySelection | null;
+    typography?: Theme['typography'];
     headerLookId?: HeaderLookId | null;
     headerLayoutId?: HeaderLayoutId | null;
     headerStyleId?: HeaderStyleId | null;
@@ -60,18 +51,10 @@ type SiteThemeSelectionsCommonInput = Readonly<{
     headerSelectionContext?: Partial<HeaderSelectionContext>;
     footerSelectionContext?: Partial<FooterSelectionContext>;
 }>;
-export type LegacySiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
-    resolvedPalette?: undefined;
-    paletteVariantId: CuratedPaletteId | null;
-    paletteOverrides: PaletteOverrides | null;
+export type SiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
+    resolvedPalette: CompleteResolvedPaletteSelection;
 }>;
-export type ExplicitPaletteSiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
-    resolvedPalette: ResolvedPaletteSelection;
-    paletteVariantId?: never;
-    paletteOverrides?: never;
-}>;
-export type SiteThemeSelectionsInput = LegacySiteThemeSelectionsInput | ExplicitPaletteSiteThemeSelectionsInput;
-export type SiteThemeSelectionsResult = Readonly<{
+type SiteThemeSelectionsBaseResult = Readonly<{
     theme: CuratedSiteStyleTheme;
     requestedSelections: Readonly<{
         headerLookId: HeaderLookId | null;
@@ -81,15 +64,7 @@ export type SiteThemeSelectionsResult = Readonly<{
     }>;
     resolvedSelections: Readonly<{
         buttonPersonalityId: ButtonPersonalityId;
-        paletteVariantId: CuratedPaletteId;
-        paletteSelection: Readonly<{
-            kind: 'curated';
-            paletteId: CuratedPaletteId;
-        }>;
-        typographySelection: CompiledTypographySelection['resolvedSelection'];
-        typographyPresetId: KnownTypographyPresetId | null;
-        typographyBodyFontOverride: string | null;
-        typographyHeadingFontOverride: string | null;
+        paletteSelection: PaletteSelection | null;
         headerLookId: HeaderLookId | null;
         headerLayoutId: HeaderLayoutId;
         headerStyleId: HeaderStyleId;
@@ -99,26 +74,17 @@ export type SiteThemeSelectionsResult = Readonly<{
     footerSelection: FooterSelectionResult;
     warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>;
-export type ExplicitPaletteSiteThemeSelectionsResult = Omit<SiteThemeSelectionsResult, 'resolvedSelections'> & Readonly<{
-    resolvedSelections: Omit<SiteThemeSelectionsResult['resolvedSelections'], 'paletteVariantId' | 'paletteSelection'> & Readonly<{
-        paletteVariantId: CuratedPaletteId | null;
-        paletteSelection: PaletteSelection;
-    }>;
-}>;
+export type SiteThemeSelectionsResult = SiteThemeSelectionsBaseResult;
 /**
  * High-level, site-style-aware compiler. Resolves the user's personality and
- * palette selections into theme tokens. Button personality still resolves
- * against the site style's authored choice list; curated palettes are brand
- * choices, so any known palette is preserved across site styles and the style's
- * first palette choice is only used when the request is absent or unknown.
+ * palette selections into theme tokens. Palette authority is always supplied
+ * as a complete resolved curated/site selection or an explicit draft.
  *
  * Returns the resolved IDs so the caller can persist auto-pick decisions, plus
  * any fallback warnings the UI can surface as "we changed your selection"
  * notices.
  */
-export declare function compileSiteThemeFromSelections(input: LegacySiteThemeSelectionsInput): SiteThemeSelectionsResult;
-export declare function compileSiteThemeFromSelections(input: ExplicitPaletteSiteThemeSelectionsInput): ExplicitPaletteSiteThemeSelectionsResult;
-export declare function compileSiteThemeFromSelections(input: SiteThemeSelectionsInput): SiteThemeSelectionsResult | ExplicitPaletteSiteThemeSelectionsResult;
+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<{
     kind: 'pinned';

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

@@ -1,10 +1,9 @@
 import { type CardStylesOverride, type ContainerStylesOverride, type SectionStylesOverride, type Theme } from '../schema';
 import { type ExpandedPalette } from '../palette/expandPalette';
 import { type ButtonPersonalityId } from '../buttons/personalities';
-import { type PaletteOverrides, type CuratedPaletteId } from '../palette/curated';
-import type { ResolvedPaletteSelection } from '../palette/resolveSelection';
+import type { CompleteResolvedPaletteSelection } from '../palette/resolveSelection';
 import { type RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
-import { type ContentFrameIntent, type EyebrowTreatment, type FlushFrameTreatment, type DesignBoundaryId, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleItemSurfaceIntent, type SiteStyleSectionTransitionIntent, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
+import { type ContentFrameIntent, type BlockCompositionIntent, type EyebrowTreatment, type FlushFrameTreatment, type DesignBoundaryId, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleItemSurfaceIntent, type SiteStyleSectionTransitionIntent, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
 import { type SectionBoundaryRuntimeMetrics } from './sectionTransitions';
 import type { ThemeColorToken } from '../tokens';
 export type SemanticSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
@@ -34,6 +33,7 @@ export type CompiledBlockRuntimeFields = Readonly<{
     _cardStyles?: CardStylesOverride;
     _transitionStyles?: CompiledTransitionRuntime;
     blockLook?: string;
+    blockComposition?: BlockCompositionIntent;
     styleGroup?: string;
 }>;
 export type CompiledTransitionEndpoint = Readonly<{
@@ -72,7 +72,7 @@ export type HeroLayoutStylesOverride = Readonly<{
     contentMaxWidth?: 'default' | 'narrow' | 'medium' | 'wide';
     typographyScale?: NonNullable<ResolvedBlockDesignPlan['heroTypographyScale']>;
 }>;
-export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "_transitionStyles", "blockLook", "styleGroup"];
+export declare const compiledRuntimeStyleFieldNames: readonly ["_frameStyles", "_sectionStyles", "_containerStyles", "_contentCardStyles", "_heroLayoutStyles", "_cardStyles", "_transitionStyles", "blockLook", "blockComposition", "styleGroup"];
 export declare function stripCompiledRuntimeStyleFields<TContent extends Record<string, unknown>>(content: TContent): Record<string, unknown>;
 export type CompiledBlockRuntime = Readonly<{
     blockId: string;
@@ -139,7 +139,7 @@ export declare const defaultDesignRuntimeRules: {
         readonly 'accent-band': {
             readonly background: {
                 readonly type: "color";
-                readonly color: "primary";
+                readonly color: "accent";
             };
         };
         readonly 'brand-depth-band': {
@@ -312,35 +312,22 @@ export declare function compilePageRuntimeFields<TBlockId extends string, TPurpo
     sectionSpacing?: SemanticSpacing;
     terminalSectionAdjacency?: TerminalSectionAdjacency;
 }>): CompiledPageRuntime<TBlockId>;
-type ResolvedPaletteCompileOptions = Readonly<{
+type PaletteCompileOptions = Readonly<{
     /** A complete palette resolved from an explicit curated or site selection. */
-    resolvedPalette: ResolvedPaletteSelection;
-    paletteVariantId?: never;
-    paletteOverrides?: never;
-}>;
-type LegacyPaletteCompileOptions = Readonly<{
-    resolvedPalette?: undefined;
-    /**
-     * Legacy curated-palette selection retained while persisted Theme V2
-     * selections are migrated to the explicit palette-selection model.
-     */
-    paletteVariantId?: CuratedPaletteId;
-    /** Legacy sparse overrides materialized into a site palette during migration. */
-    paletteOverrides?: PaletteOverrides;
+    resolvedPalette?: CompleteResolvedPaletteSelection;
 }>;
 export type CompileTokenRecipesOptions = Readonly<{
     /** Resolved button personality ID. When provided, emits `theme.buttons`. */
     buttonPersonalityId?: ButtonPersonalityId;
-}> & (ResolvedPaletteCompileOptions | LegacyPaletteCompileOptions);
+}> & PaletteCompileOptions;
 /**
  * Compiles bounded token recipes to the current Theme schema. This is intentionally
  * pure and schema-validated so generated Theme V2 choices have a concrete legacy
  * Theme output before any persistence or Phase 5 integration consumes them.
  *
  * Optional `options` accept an already-resolved palette selection and button
- * personality. During migration they also accept the legacy curated ID plus
- * sparse overrides. When neither palette input is supplied, the function falls
- * through to the recipe-based palette lookup.
+ * personality. Sparse overrides and legacy palette IDs are deliberately not
+ * compiler inputs: callers must resolve a complete palette before compiling.
  */
 export declare function compileTokenRecipes(recipes: ThemeTokenRecipes, options?: CompileTokenRecipesOptions): Theme;
 export {};

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

@@ -41,5 +41,20 @@ export declare const defaultHeaderNavPreferences: {
 export declare function readHeaderNavPreferences(theme: Theme | null | undefined): HeaderNavPreferences;
 export declare function headerNavPreferencesEqual(left: HeaderNavPreferences, right: HeaderNavPreferences): boolean;
 export declare function withHeaderNavThemePreferences(theme: Theme, preferences: HeaderNavPreferences): Theme;
+/**
+ * Applies the user's nav font-role/size overrides on top of a style-resolved
+ * nav link style. This is where the precedence contract lands:
+ *
+ * - The nav typography TREATMENT (case/tracking identity: plain / heading /
+ *   quiet-caps / brand-caps) is ALWAYS owned by the active header style and is
+ *   baked into `style` before this call (see `applyNavTypography` in
+ *   headerLooks.ts).
+ * - Each treatment resolves through a DEFAULT font role: `heading` resolves
+ *   through the heading role; `plain` / `quiet-caps` / `brand-caps` resolve
+ *   through the body role.
+ * - The user's `navFontRole` (surfaced here as `preferences.typography`) only
+ *   overrides which font ROLE the treatment resolves through. It never changes
+ *   the treatment. `'inherit'` keeps the treatment's default role.
+ */
 export declare function mergeHeaderNavTypographyPreference(style: NavLinkStyle, preferences: HeaderNavPreferences): NavLinkStyle;
 export declare function readHeaderNavFontSizePreference(value: NavLinkTextSize | undefined): HeaderNavFontSizePreference;

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

@@ -1,11 +1,10 @@
 import { type Theme } from '../schema';
 import { type CuratedSiteStyle } from './curatedSiteStyles';
-import { type CompiledTypographySelection } from './typographyPresets';
 import type { SiteStyleId } from './types';
 export type CuratedSiteStyleTheme = Theme & Readonly<{
     siteStyleId: SiteStyleId;
 }>;
 export declare function withSiteStyleMetadata(theme: Theme, siteStyle: CuratedSiteStyle): CuratedSiteStyleTheme;
-export declare function applyTypographySelectionToTheme(theme: Theme, compiledTypography: CompiledTypographySelection): Theme;
+export declare function applyTypographyToTheme(theme: Theme, typography: Theme['typography'], heroTypography?: NonNullable<NonNullable<Theme['hero']>['typography']>): Theme;
 export declare function applySiteStyleThemeOverrides(theme: Theme, siteStyle: CuratedSiteStyle): Theme;
 export declare function compileCuratedSiteStyleBlockTheme(siteStyle: CuratedSiteStyle): CuratedSiteStyleTheme;