@riverbankcms/sdk 0.108.0 → 0.111.0

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

@@ -1,9 +1,9 @@
 import type { PageDesignEditorReadModel } from './pageDesignEditorModel';
 import { type Theme } from '../schema';
-import { type ButtonPersonalityId } from '../buttons/personalities';
+import { type ButtonStyleSelection } from '../buttons/styles';
 import type { CompleteResolvedPaletteSelection, PaletteSelection } from '../palette';
 import { type CuratedSiteStyle } from './curatedSiteStyles';
-import { type FooterLookId, type FooterSelectionContext, type FooterSelectionResult } from './footerLooks';
+import { type FooterLookId, 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';
 import { type AppearancePresetId, type DesignBlockId, type SiteStyleId } from './types';
@@ -24,7 +24,7 @@ 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, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
+export { curatedSiteStyles, defaultButtonStyleSelectionForSiteStyle, 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";
 /**
@@ -36,20 +36,19 @@ export declare function compileCuratedSiteStyleTheme(siteStyle: CuratedSiteStyle
 export declare function defaultResolvedPaletteForSiteStyle(siteStyle: CuratedSiteStyle): CompleteResolvedPaletteSelection;
 export declare function compileCuratedSiteStyleThemeById(siteStyleId: SiteStyleId): CuratedSiteStyleTheme | null;
 export type SelectionFallbackWarning = Readonly<{
-    kind: 'rejected-personality';
+    kind: 'rejected-button-style';
     requested: string;
-    fellBackTo: ButtonPersonalityId;
+    fellBackTo: ButtonStyleSelection;
 }>;
 type SiteThemeSelectionsCommonInput = Readonly<{
     siteStyle: CuratedSiteStyle;
-    buttonPersonalityId: ButtonPersonalityId | null;
+    buttonStyleSelection: ButtonStyleSelection | null;
     typography?: Theme['typography'];
     headerLookId?: HeaderLookId | null;
     headerLayoutId?: HeaderLayoutId | null;
     headerStyleId?: HeaderStyleId | null;
     footerLookId?: FooterLookId | null;
     headerSelectionContext?: Partial<HeaderSelectionContext>;
-    footerSelectionContext?: Partial<FooterSelectionContext>;
 }>;
 export type SiteThemeSelectionsInput = SiteThemeSelectionsCommonInput & Readonly<{
     resolvedPalette: CompleteResolvedPaletteSelection;
@@ -63,7 +62,7 @@ type SiteThemeSelectionsBaseResult = Readonly<{
         footerLookId: FooterLookId | null;
     }>;
     resolvedSelections: Readonly<{
-        buttonPersonalityId: ButtonPersonalityId;
+        buttonStyleSelection: ButtonStyleSelection;
         paletteSelection: PaletteSelection | null;
         headerLookId: HeaderLookId | null;
         headerLayoutId: HeaderLayoutId;
@@ -76,7 +75,7 @@ type SiteThemeSelectionsBaseResult = Readonly<{
 }>;
 export type SiteThemeSelectionsResult = SiteThemeSelectionsBaseResult;
 /**
- * High-level, site-style-aware compiler. Resolves the user's personality and
+ * High-level, site-style-aware compiler. Resolves the user's button style and
  * palette selections into theme tokens. Palette authority is always supplied
  * as a complete resolved curated/site selection or an explicit draft.
  *

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

@@ -1,18 +1,39 @@
 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 ButtonStyleSelection } from '../buttons/styles';
 import type { CompleteResolvedPaletteSelection } from '../palette/resolveSelection';
 import { type RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
 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';
+import { type ThemeColorToken } from '../tokens';
+import { type GradientPresetId } from '../gradients';
 export type SemanticSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
 export type SectionPaddingX = 'normal' | 'none';
-type SectionForegroundRuntimeTokens = Pick<NonNullable<SectionSurfaceRuntimeRule['background']>, 'textColor' | 'headingColor' | 'linkColor' | 'supportingColor'>;
-export type SectionSurfaceRuntimeRule = Readonly<{
-    background?: NonNullable<SectionStylesOverride['background']>;
+type SectionBackgroundOverride = NonNullable<SectionStylesOverride['background']>;
+type SectionForegroundRuntimeTokenKey = 'textColor' | 'headingColor' | 'linkColor' | 'supportingColor';
+export type SectionForegroundRuntimeTokens = {
+    readonly [TKey in SectionForegroundRuntimeTokenKey]: ThemeColorToken;
+};
+export declare function defineSectionForegroundRuntimeTokens(input: Readonly<Record<SectionForegroundRuntimeTokenKey, unknown>>): SectionForegroundRuntimeTokens;
+type NonGradientSectionRuntimeBackground = Omit<SectionBackgroundOverride, 'type' | 'gradient' | 'gradientPresetId'> & Readonly<{
+    type?: 'color' | 'image';
+    gradient?: never;
+    gradientPresetId?: never;
+}>;
+type GradientSectionRuntimeBackground = Readonly<{
+    type: 'gradient';
+    gradientPresetId: GradientPresetId;
+    opacity?: number;
+}>;
+type NonGradientSectionSurfaceRuntimeRule = Readonly<{
+    background?: NonGradientSectionRuntimeBackground;
     foreground?: Partial<SectionForegroundRuntimeTokens>;
 }>;
+type GradientSectionSurfaceRuntimeRule = Readonly<{
+    background: GradientSectionRuntimeBackground;
+    foreground: SectionForegroundRuntimeTokens;
+}>;
+export type SectionSurfaceRuntimeRule = NonGradientSectionSurfaceRuntimeRule | GradientSectionSurfaceRuntimeRule;
 export type DesignRuntimeRules = Readonly<{
     sectionSurfaces: Readonly<Record<SiteStyleSurfaceIntent, SectionSurfaceRuntimeRule>>;
     defaultEyebrowTreatment?: EyebrowTreatment;
@@ -150,10 +171,10 @@ export declare const defaultDesignRuntimeRules: {
         };
         readonly 'hero-image': {
             readonly background: {
-                readonly textColor?: string | null | undefined;
-                readonly headingColor?: string | null | undefined;
-                readonly linkColor?: string | null | undefined;
-                readonly supportingColor?: string | null | undefined;
+                readonly textColor: string;
+                readonly headingColor: string;
+                readonly linkColor: string;
+                readonly supportingColor: string;
                 readonly type: "image";
                 readonly opacity: 1;
                 readonly position: "center center";
@@ -317,8 +338,8 @@ type PaletteCompileOptions = Readonly<{
     resolvedPalette?: CompleteResolvedPaletteSelection;
 }>;
 export type CompileTokenRecipesOptions = Readonly<{
-    /** Resolved button personality ID. When provided, emits `theme.buttons`. */
-    buttonPersonalityId?: ButtonPersonalityId;
+    /** Validated button style selection. When provided, emits `theme.buttons`. */
+    buttonStyleSelection?: ButtonStyleSelection;
 }> & PaletteCompileOptions;
 /**
  * Compiles bounded token recipes to the current Theme schema. This is intentionally
@@ -326,7 +347,7 @@ export type CompileTokenRecipesOptions = Readonly<{
  * Theme output before any persistence or Phase 5 integration consumes them.
  *
  * Optional `options` accept an already-resolved palette selection and button
- * personality. Sparse overrides and legacy palette IDs are deliberately not
+ * style. 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;

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

@@ -28,9 +28,9 @@ export declare const styleTagsSchema: z.ZodObject<{
     era: z.ZodOptional<z.ZodEnum<{
         editorial: "editorial";
         modern: "modern";
-        retro: "retro";
-        technical: "technical";
         organic: "organic";
+        technical: "technical";
+        retro: "retro";
     }>>;
 }, z.core.$strip>;
 export type StyleTone = (typeof STYLE_AXIS_VALUES.tone)[number];

package/dist/_dts/ui/src/palette/hex.d.ts

@@ -2,8 +2,8 @@
  * Hex colour helpers shared by every palette-editing surface (Macadamia
  * onboarding swatches, the LiveThemeEditor, the Style configurator advanced
  * row). Consolidates three prior duplicates: `normalizeColorPickerValue` in
- * Macadamia, `normalizeHex` + `contrastRatio` in `theme-editor/utils.ts`, and
- * the inline regex in `updateColorRole`.
+ * Macadamia, `normalizeHex` + `contrastRatio` formerly in
+ * `theme-editor/utils.ts`, and the inline regex in `updateColorRole`.
  *
  * Pure functions; no DOM, no React.
  */
@@ -13,7 +13,7 @@
  * without a leading `#`; returns `fallback` for any other shape (empty
  * string, garbage, characters outside `[0-9a-f]`, wrong length, etc.). Pass
  * a `fallback` to make the fallback explicit at the call site — defaulting
- * to `'#000000'` keeps the legacy `theme-editor/utils.ts` semantics.
+ * to `'#000000'` preserves the former theme-editor helper semantics.
  */
 export declare function normalizeHex(input: string | null | undefined, fallback?: string): string;
 /**