@riverbankcms/sdk 0.60.0 → 0.60.3

package/dist/_dts/theme-core/src/schema.d.ts

@@ -3643,6 +3643,12 @@ export declare const themeSchema: z.ZodObject<{
                 body: "body";
                 heading: "heading";
             }>>;
+            fontSize: z.ZodOptional<z.ZodString>;
+            letterSpacing: z.ZodOptional<z.ZodEnum<{
+                normal: "normal";
+                loose: "loose";
+                tight: "tight";
+            }>>;
             italic: z.ZodOptional<z.ZodBoolean>;
             paddingPreset: z.ZodOptional<z.ZodEnum<{
                 compact: "compact";
@@ -3700,7 +3706,7 @@ export declare const themeSchema: z.ZodObject<{
                 type: z.ZodLiteral<"transparent">;
             }, z.core.$strip>], "type">;
             textColorToken: z.ZodString;
-            borderRadius: z.ZodString;
+            borderRadius: z.ZodOptional<z.ZodString>;
             shadow: z.ZodOptional<z.ZodObject<{
                 elevation: z.ZodEnum<{
                     medium: "medium";
@@ -3722,8 +3728,6 @@ export declare const themeSchema: z.ZodObject<{
                 widthClass: z.ZodString;
                 colorToken: z.ZodString;
             }, z.core.$strip>>;
-            padding: z.ZodOptional<z.ZodString>;
-            fontSize: z.ZodOptional<z.ZodString>;
             hoverBackgroundToken: z.ZodOptional<z.ZodString>;
             effects: z.ZodOptional<z.ZodObject<{
                 base: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -3743,8 +3747,26 @@ export declare const themeSchema: z.ZodObject<{
                     options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
                 }, z.core.$strip>>>;
             }, z.core.$strip>>;
+            sizes: z.ZodOptional<z.ZodObject<{
+                sm: z.ZodOptional<z.ZodObject<{
+                    padding: z.ZodString;
+                    fontSize: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                md: z.ZodOptional<z.ZodObject<{
+                    padding: z.ZodString;
+                    fontSize: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                lg: z.ZodOptional<z.ZodObject<{
+                    padding: z.ZodString;
+                    fontSize: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                xl: z.ZodOptional<z.ZodObject<{
+                    padding: z.ZodString;
+                    fontSize: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
-        sizes: z.ZodOptional<z.ZodObject<{
+        sizes: z.ZodOptional<z.ZodPipe<z.ZodObject<{
             sm: z.ZodObject<{
                 padding: z.ZodString;
                 fontSize: z.ZodOptional<z.ZodString>;
@@ -3761,7 +3783,41 @@ export declare const themeSchema: z.ZodObject<{
                 padding: z.ZodString;
                 fontSize: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
-        }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodTransform<{
+            sm: {
+                padding: string;
+                fontSize?: string | undefined;
+            };
+            md: {
+                padding: string;
+                fontSize?: string | undefined;
+            };
+            lg: {
+                padding: string;
+                fontSize?: string | undefined;
+            };
+            xl: {
+                padding: string;
+                fontSize?: string | undefined;
+            };
+        }, {
+            sm: {
+                padding: string;
+                fontSize?: string | undefined;
+            };
+            md: {
+                padding: string;
+                fontSize?: string | undefined;
+            };
+            lg: {
+                padding: string;
+                fontSize?: string | undefined;
+            };
+            xl?: {
+                padding: string;
+                fontSize?: string | undefined;
+            } | undefined;
+        }>>>;
     }, z.core.$strip>>;
     cards: z.ZodOptional<z.ZodObject<{
         variants: z.ZodArray<z.ZodObject<{
@@ -5612,6 +5668,12 @@ export declare const themesTurnSchema: z.ZodObject<{
                     body: "body";
                     heading: "heading";
                 }>>;
+                fontSize: z.ZodOptional<z.ZodString>;
+                letterSpacing: z.ZodOptional<z.ZodEnum<{
+                    normal: "normal";
+                    loose: "loose";
+                    tight: "tight";
+                }>>;
                 italic: z.ZodOptional<z.ZodBoolean>;
                 paddingPreset: z.ZodOptional<z.ZodEnum<{
                     compact: "compact";
@@ -5669,7 +5731,7 @@ export declare const themesTurnSchema: z.ZodObject<{
                     type: z.ZodLiteral<"transparent">;
                 }, z.core.$strip>], "type">;
                 textColorToken: z.ZodString;
-                borderRadius: z.ZodString;
+                borderRadius: z.ZodOptional<z.ZodString>;
                 shadow: z.ZodOptional<z.ZodObject<{
                     elevation: z.ZodEnum<{
                         medium: "medium";
@@ -5691,8 +5753,6 @@ export declare const themesTurnSchema: z.ZodObject<{
                     widthClass: z.ZodString;
                     colorToken: z.ZodString;
                 }, z.core.$strip>>;
-                padding: z.ZodOptional<z.ZodString>;
-                fontSize: z.ZodOptional<z.ZodString>;
                 hoverBackgroundToken: z.ZodOptional<z.ZodString>;
                 effects: z.ZodOptional<z.ZodObject<{
                     base: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -5712,8 +5772,26 @@ export declare const themesTurnSchema: z.ZodObject<{
                         options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
                     }, z.core.$strip>>>;
                 }, z.core.$strip>>;
+                sizes: z.ZodOptional<z.ZodObject<{
+                    sm: z.ZodOptional<z.ZodObject<{
+                        padding: z.ZodString;
+                        fontSize: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    md: z.ZodOptional<z.ZodObject<{
+                        padding: z.ZodString;
+                        fontSize: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    lg: z.ZodOptional<z.ZodObject<{
+                        padding: z.ZodString;
+                        fontSize: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                    xl: z.ZodOptional<z.ZodObject<{
+                        padding: z.ZodString;
+                        fontSize: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
             }, z.core.$strip>>;
-            sizes: z.ZodOptional<z.ZodObject<{
+            sizes: z.ZodOptional<z.ZodPipe<z.ZodObject<{
                 sm: z.ZodObject<{
                     padding: z.ZodString;
                     fontSize: z.ZodOptional<z.ZodString>;
@@ -5730,7 +5808,41 @@ export declare const themesTurnSchema: z.ZodObject<{
                     padding: z.ZodString;
                     fontSize: z.ZodOptional<z.ZodString>;
                 }, z.core.$strip>>;
-            }, z.core.$strip>>;
+            }, z.core.$strip>, z.ZodTransform<{
+                sm: {
+                    padding: string;
+                    fontSize?: string | undefined;
+                };
+                md: {
+                    padding: string;
+                    fontSize?: string | undefined;
+                };
+                lg: {
+                    padding: string;
+                    fontSize?: string | undefined;
+                };
+                xl: {
+                    padding: string;
+                    fontSize?: string | undefined;
+                };
+            }, {
+                sm: {
+                    padding: string;
+                    fontSize?: string | undefined;
+                };
+                md: {
+                    padding: string;
+                    fontSize?: string | undefined;
+                };
+                lg: {
+                    padding: string;
+                    fontSize?: string | undefined;
+                };
+                xl?: {
+                    padding: string;
+                    fontSize?: string | undefined;
+                } | undefined;
+            }>>>;
         }, z.core.$strip>>;
         cards: z.ZodOptional<z.ZodObject<{
             variants: z.ZodArray<z.ZodObject<{

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

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+/**
+ * Compatibility primitives for filtering button personalities and palette
+ * variants against a curated site style's acceptance region.
+ *
+ * Three axes (`tone`, `energy`, `motion`) reuse the values already declared on
+ * `theme.axes` so personality/palette tags can't drift from the rest of the
+ * design system. `era` is a fourth axis added here because the theme schema
+ * doesn't carry a "style language" / cultural-reference dimension.
+ *
+ * Pure functions; no ambient state. Used by:
+ *   - `compileSiteThemeFromSelections` to filter / resolve incompatible IDs
+ *   - The Style configurator UI to filter pickable options
+ */
+export declare const STYLE_AXIS_VALUES: {
+    readonly tone: readonly ["minimal", "classic", "bold"];
+    readonly energy: readonly ["calm", "vibrant"];
+    readonly motion: readonly ["subtle", "standard", "expressive"];
+    readonly era: readonly ["editorial", "modern", "organic", "technical", "retro"];
+};
+/**
+ * Zod schema for `StyleTags`. Derived from `STYLE_AXIS_VALUES` so a single
+ * source of truth governs both the type-level vocabulary and the runtime
+ * validator used by `buttonPersonalitySchema` and `paletteVariantSchema`.
+ */
+export declare const styleTagsSchema: z.ZodObject<{
+    tone: z.ZodOptional<z.ZodEnum<{
+        classic: "classic";
+        bold: "bold";
+        minimal: "minimal";
+    }>>;
+    energy: z.ZodOptional<z.ZodEnum<{
+        calm: "calm";
+        vibrant: "vibrant";
+    }>>;
+    motion: z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        subtle: "subtle";
+        expressive: "expressive";
+    }>>;
+    era: z.ZodOptional<z.ZodEnum<{
+        editorial: "editorial";
+        modern: "modern";
+        retro: "retro";
+        technical: "technical";
+        organic: "organic";
+    }>>;
+}, z.core.$strip>;
+export type StyleTone = (typeof STYLE_AXIS_VALUES.tone)[number];
+export type StyleEnergy = (typeof STYLE_AXIS_VALUES.energy)[number];
+export type StyleMotion = (typeof STYLE_AXIS_VALUES.motion)[number];
+export type StyleEra = (typeof STYLE_AXIS_VALUES.era)[number];
+export type StyleAxis = Readonly<{
+    tone: StyleTone;
+    energy: StyleEnergy;
+    motion: StyleMotion;
+    era: StyleEra;
+}>;
+/**
+ * A personality or palette's self-declared tags. All four axes are optional;
+ * an unset axis matches every region (no constraint).
+ */
+export type StyleTags = Readonly<Partial<StyleAxis>>;
+/**
+ * A site style's acceptance region. Each axis declares the set of values that
+ * pair well with the site style. An unset axis accepts everything.
+ */
+export type AcceptanceRegion = Readonly<{
+    [K in keyof StyleAxis]?: ReadonlyArray<StyleAxis[K]>;
+}>;
+/**
+ * True if every tag the entry declares falls inside the corresponding
+ * axis-acceptance set in the region. Unset axes (on either side) are skipped.
+ *
+ * Example: an entry with `{ tone: 'bold', era: 'retro' }` is compatible with
+ * a region of `{ tone: ['bold'], energy: ['vibrant'] }` because the entry
+ * doesn't declare `energy`, and `tone: 'bold'` is in the region's set.
+ */
+export declare function isCompatible(tags: StyleTags, region: AcceptanceRegion): boolean;
+/**
+ * Filter a library of tagged entries to those compatible with the region,
+ * preserving original order. Pure.
+ */
+export declare function compatibleEntries<T extends {
+    readonly tags: StyleTags;
+}>(entries: readonly T[], region: AcceptanceRegion): readonly T[];
+/**
+ * Deterministic auto-pick for the "user switched site style; their current
+ * personality/palette may be incompatible" flow.
+ *
+ * Algorithm:
+ *   1. Requested is null → fallback. No rejection.
+ *   2. Requested is compatible → keep. No rejection.
+ *   3. Requested is incompatible → fallback (which is the site style's default
+ *      and is required to be compatible). Record rejection.
+ *   4. Requested ID not found in library → fallback. Record rejection.
+ *
+ * The site-style invariant "every site style has at least one compatible
+ * entry per library" is what makes the fallback always valid. Enforced by a
+ * lint-style test, not at runtime.
+ */
+export type ResolveCompatibleResult<TId extends string> = Readonly<{
+    resolved: TId;
+    rejected: TId | null;
+}>;
+export declare function resolveCompatible<TId extends string, T extends {
+    readonly id: TId;
+    readonly tags: StyleTags;
+}>(requested: TId | null, region: AcceptanceRegion, library: readonly T[], fallback: TId): ResolveCompatibleResult<TId>;

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,11 +1,13 @@
 export * from './appearancePresets';
 export * from './blockFlow';
+export * from './compatibility';
 export * from './compositionBudget';
 export * from './curatedSiteStyles';
 export * from './designState';
 export * from './generatedSchemas';
 export * from './generatedDesignPipeline';
 export * from './pageDesignAuthority';
+export * from './pageDesignEditorErrors';
 export * from './pageDesignEditorModel';
 export * from './pageDesignIntent';
 export * from './previewCustomization';

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

@@ -0,0 +1 @@
+export declare const PAGE_DESIGN_EDITOR_STATE_FETCH_ERROR_MESSAGE = "Something went wrong fetching the page design state";

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';