@riverbankcms/sdk 0.60.1 → 0.60.3

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

@@ -1,3 +1,6 @@
+import type { ButtonPersonalityId } from '../buttons/personalities';
+import type { PaletteVariantId } from '../palette/variants';
+import type { AcceptanceRegion } from './compatibility';
 import { type DesignSystemTemplate, 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"];
 export type CuratedSiteStyleIdValue = typeof curatedSiteStyleIdValues[number];
@@ -8,6 +11,25 @@ export type CuratedSiteStyle = Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>;
 /**
  * V1 generated site styles are curated product presets, not AI-authored design
@@ -21,6 +43,25 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -28,6 +69,25 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -35,6 +95,25 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -42,6 +121,25 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -49,6 +147,25 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -56,6 +173,25 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -63,6 +199,25 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -70,6 +225,25 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>];
 export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     id: SiteStyleId;
@@ -78,5 +252,24 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /**
+     * Default button personality applied when the site is generated and no
+     * explicit user selection exists. Must be compatible with `acceptedButtons`.
+     */
+    defaultButtonPersonalityId: ButtonPersonalityId;
+    /**
+     * Acceptance region for button personalities. The Style configurator UI
+     * filters the personality picker against this region; if a persisted
+     * personality stops being compatible (e.g. after a site-style switch) the
+     * compiler auto-picks `defaultButtonPersonalityId` and emits a warning.
+     */
+    acceptedButtons: AcceptanceRegion;
+    /**
+     * Default palette variant when generated with no explicit user selection.
+     * Must be compatible with `acceptedPalettes`.
+     */
+    defaultPaletteVariantId: PaletteVariantId;
+    /** Acceptance region for palette variants — mirrors `acceptedButtons`. */
+    acceptedPalettes: AcceptanceRegion;
 }>>;
 export declare function getCuratedSiteStyle(id: SiteStyleId): CuratedSiteStyle | null;

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

@@ -1,5 +1,6 @@
 export * from './appearancePresets';
 export * from './blockFlow';
+export * from './compatibility';
 export * from './compositionBudget';
 export * from './curatedSiteStyles';
 export * from './designState';

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

@@ -127,6 +127,10 @@ export declare const boundaryOptions: readonly [{
     readonly id: BoundaryOptionId;
     readonly label: "Soft";
     readonly transitionAfter: "soft-fade-short";
+}, {
+    readonly id: BoundaryOptionId;
+    readonly label: "Wave";
+    readonly transitionAfter: "wave-edge";
 }, {
     readonly id: BoundaryOptionId;
     readonly label: "Spacious";

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

@@ -1,5 +1,7 @@
 import type { PageDesignEditorReadModel } from './pageDesignEditorModel';
 import type { Theme } from '../schema';
+import { type ButtonPersonalityId } from '../buttons/personalities';
+import { type PaletteOverrides, type PaletteVariantId } from '../palette/variants';
 import { type CuratedSiteStyle } from './curatedSiteStyles';
 import { type CompiledBlockRuntimeFields, type CompiledPageRuntime, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing } from './runtimeCompiler';
 import type { AppearancePresetId, DesignBlockId, SiteStyleId } from './types';
@@ -29,11 +31,50 @@ export type CuratedSiteStyleTheme = Theme & Readonly<{
     siteStyleId: SiteStyleId;
 }>;
 /**
- * Compiles a curated Site Style into a persisted Theme payload while keeping
- * the curated catalog metadata authoritative for name/description/rationale.
+ * 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})` — kept for back-compat
+ * with callers that don't yet plumb user selections through.
+ *
+ * @deprecated Prefer `compileSiteThemeFromSelections` directly so resolved
+ * selection IDs and compatibility warnings are visible at the call site.
  */
 export declare function compileCuratedSiteStyleTheme(siteStyle: CuratedSiteStyle): CuratedSiteStyleTheme;
 export declare function compileCuratedSiteStyleThemeById(siteStyleId: SiteStyleId): CuratedSiteStyleTheme | null;
+export type CompatibilityWarning = Readonly<{
+    kind: 'rejected-personality';
+    requested: ButtonPersonalityId;
+    fellBackTo: ButtonPersonalityId;
+}> | Readonly<{
+    kind: 'rejected-palette';
+    requested: PaletteVariantId;
+    fellBackTo: PaletteVariantId;
+}>;
+export type SiteThemeSelectionsInput = Readonly<{
+    siteStyle: CuratedSiteStyle;
+    buttonPersonalityId: ButtonPersonalityId | null;
+    paletteVariantId: PaletteVariantId | null;
+    paletteOverrides: PaletteOverrides | null;
+}>;
+export type SiteThemeSelectionsResult = Readonly<{
+    theme: CuratedSiteStyleTheme;
+    resolvedSelections: Readonly<{
+        buttonPersonalityId: ButtonPersonalityId;
+        paletteVariantId: PaletteVariantId;
+    }>;
+    warnings: ReadonlyArray<CompatibilityWarning>;
+}>;
+/**
+ * High-level, site-style-aware compiler. Resolves the user's personality and
+ * palette selections against the site style's acceptance regions (auto-picking
+ * the site style's defaults when the request is incompatible or unknown),
+ * then delegates to `compileTokenRecipes` with the resolved IDs.
+ *
+ * Returns the resolved IDs so the caller can persist auto-pick decisions, plus
+ * any compatibility warnings the UI can surface as "we changed your selection"
+ * notices.
+ */
+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,4 +1,6 @@
 import { type CardStylesOverride, type ContainerStylesOverride, type SectionStylesOverride, type Theme } from '../schema';
+import { type ButtonPersonalityId } from '../buttons/personalities';
+import { type PaletteOverrides, type PaletteVariantId } from '../palette/variants';
 import { type RuntimeStyleWriteResultForFields, type StyleAuthority } from './designState';
 import { type ContentFrameIntent, type FlushFrameTreatment, type PanelFrameTreatment, type ResolvedBlockDesignPlan, type ResolvedPageDesignPlan, type SiteStyleItemSurfaceIntent, type SiteStyleSectionTransitionIntent, type SiteStyleSurfaceIntent, type ThemeTokenRecipes } from './types';
 export type SemanticSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
@@ -206,9 +208,29 @@ export declare function compilePageRuntimeFields<TBlockId extends string, TPurpo
     componentRules?: ComponentRuntimeRules;
     sectionSpacing?: SemanticSpacing;
 }>): CompiledPageRuntime<TBlockId>;
+export type CompileTokenRecipesOptions = Readonly<{
+    /** Resolved button personality ID. When provided, emits `theme.buttons`. */
+    buttonPersonalityId?: ButtonPersonalityId;
+    /**
+     * Resolved palette variant ID. When provided, replaces the recipe-based
+     * palette lookup; the recipe family is still consulted for the rest of the
+     * theme (typography, spacing, etc.).
+     */
+    paletteVariantId?: PaletteVariantId;
+    /**
+     * Sparse per-token hex overrides applied on top of the palette variant.
+     * Tokens not in this map keep the variant's value.
+     */
+    paletteOverrides?: PaletteOverrides;
+}>;
 /**
  * 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 already-resolved button personality and palette
+ * variant IDs (typically supplied by `compileSiteThemeFromSelections`). When
+ * IDs are omitted, the function falls through to the legacy recipe-based
+ * palette lookup and leaves `theme.buttons` as the mock-theme default.
  */
-export declare function compileTokenRecipes(recipes: ThemeTokenRecipes): Theme;
+export declare function compileTokenRecipes(recipes: ThemeTokenRecipes, options?: CompileTokenRecipesOptions): Theme;

package/dist/_dts/ui/src/badge.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
 declare const badgeVariants: (props?: ({
-    variant?: "secondary" | "outline" | "default" | "success" | "warning" | "destructive" | null | undefined;
+    variant?: "success" | "secondary" | "outline" | "default" | "warning" | "destructive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
 }

package/dist/_dts/ui/src/callout.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const calloutVariants: (props?: ({
-    tone?: "default" | "success" | "warning" | "info" | "danger" | null | undefined;
+    tone?: "success" | "default" | "warning" | "info" | "danger" | null | undefined;
     layout?: "inline" | "banner" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type CalloutProps = React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof calloutVariants> & {