@riverbankcms/sdk 0.109.0 → 0.118.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,6 +1,6 @@
 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';
@@ -338,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
@@ -347,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/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;
 /**