@riverbankcms/sdk 0.60.1 → 0.60.6

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/curatedChoices.d.ts

@@ -0,0 +1,27 @@
+import type { NonEmptyReadonlyArray } from './types';
+export type CuratedChoice<TId extends string> = Readonly<{
+    id: TId;
+    note?: string;
+}>;
+export type UnknownPersistedChoice = Readonly<{
+    kind: 'unknown';
+    raw: string;
+}>;
+export type CuratedChoiceRequest<TId extends string> = TId | UnknownPersistedChoice | null;
+export type CuratedChoiceResolution<TId extends string> = Readonly<{
+    kind: 'accepted';
+    resolved: TId;
+}> | Readonly<{
+    kind: 'defaulted-empty';
+    resolved: TId;
+}> | Readonly<{
+    kind: 'defaulted-rejected';
+    requested: string;
+    resolved: TId;
+    reason: 'unknown' | 'not-curated-for-style';
+}>;
+export declare function defaultCuratedChoice<TId extends string>(choices: NonEmptyReadonlyArray<CuratedChoice<TId>>): TId;
+export declare function resolveCuratedChoice<TId extends string>(requested: CuratedChoiceRequest<TId>, choices: NonEmptyReadonlyArray<CuratedChoice<TId>>): CuratedChoiceResolution<TId>;
+export declare function requireEntriesForCuratedChoices<TEntry extends Readonly<{
+    id: string;
+}>, TId extends TEntry['id']>(entries: readonly TEntry[], choices: NonEmptyReadonlyArray<CuratedChoice<TId>>): NonEmptyReadonlyArray<TEntry>;

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

@@ -1,6 +1,11 @@
-import { type DesignSystemTemplate, type SiteStyleId } from './types';
+import { type ButtonPersonalityId, type KnownButtonPersonalityId } from '../buttons/personalities';
+import { type KnownPaletteVariantId, type PaletteVariantId } from '../palette/variants';
+import { type CuratedChoice } from './curatedChoices';
+import { type DesignSystemTemplate, type NonEmptyReadonlyArray, 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];
+export type ButtonPersonalityChoice = CuratedChoice<KnownButtonPersonalityId>;
+export type PaletteVariantChoice = CuratedChoice<KnownPaletteVariantId>;
 export type CuratedSiteStyle = Readonly<{
     id: SiteStyleId;
     name: string;
@@ -8,7 +13,13 @@ export type CuratedSiteStyle = Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>;
+export declare function defaultButtonPersonalityForSiteStyle(siteStyle: CuratedSiteStyle): ButtonPersonalityId;
+export declare function defaultPaletteVariantForSiteStyle(siteStyle: CuratedSiteStyle): PaletteVariantId;
 /**
  * V1 generated site styles are curated product presets, not AI-authored design
  * systems. Generators choose one of these bounded entries, then downstream
@@ -21,6 +32,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -28,6 +43,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -35,6 +54,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -42,6 +65,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -49,6 +76,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -56,6 +87,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -63,6 +98,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>, Readonly<{
     id: SiteStyleId;
     name: string;
@@ -70,6 +109,10 @@ export declare const curatedSiteStyles: readonly [Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>];
 export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     id: SiteStyleId;
@@ -78,5 +121,9 @@ export declare const curatedSiteStylesById: Map<SiteStyleId, Readonly<{
     generationBrief: string;
     selectionKeywords: readonly string[];
     template: DesignSystemTemplate;
+    /** Authored picker choices. First item is the default/fallback. */
+    buttonPersonalityChoices: NonEmptyReadonlyArray<ButtonPersonalityChoice>;
+    /** Authored picker choices. First item is the default/fallback. */
+    paletteVariantChoices: NonEmptyReadonlyArray<PaletteVariantChoice>;
 }>>;
 export declare function getCuratedSiteStyle(id: SiteStyleId): CuratedSiteStyle | null;

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

@@ -1,6 +1,7 @@
 export * from './appearancePresets';
 export * from './blockFlow';
 export * from './compositionBudget';
+export * from './curatedChoices';
 export * from './curatedSiteStyles';
 export * from './designState';
 export * from './generatedSchemas';
@@ -14,5 +15,6 @@ export * from './rawStyleFields';
 export * from './resolver';
 export * from './runtimeCompiler';
 export * from './sourceCatalogs';
+export * from './styleTags';
 export * from './tokenRecipes';
 export * from './types';

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';
@@ -17,7 +19,8 @@ export { autoDesignChoice, reducePageDesignIntentForUserAction, resolvePageDesig
 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, compilePageRuntimeFields, compileTokenRecipes, compiledRuntimeStyleFieldNames, defaultComponentRuntimeRules, defaultDesignRuntimeRules, stripCompiledRuntimeStyleFields, type CompiledBlockRuntime, type CompiledBlockRuntimeFields, type CompiledPageRuntime, type CompileBlockRuntimeInput, type ComponentRuntimeRules, type DesignRuntimeRules, type SemanticSpacing, } from './runtimeCompiler';
-export { curatedSiteStyles, getCuratedSiteStyle, type CuratedSiteStyle, } from './curatedSiteStyles';
+export { defaultCuratedChoice, requireEntriesForCuratedChoices, resolveCuratedChoice, type CuratedChoice, type CuratedChoiceResolution, } from './curatedChoices';
+export { curatedSiteStyles, defaultButtonPersonalityForSiteStyle, defaultPaletteVariantForSiteStyle, 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";
 /**
@@ -29,11 +32,47 @@ 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})`.
  */
 export declare function compileCuratedSiteStyleTheme(siteStyle: CuratedSiteStyle): CuratedSiteStyleTheme;
 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: 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<SelectionFallbackWarning>;
+}>;
+/**
+ * High-level, site-style-aware compiler. Resolves the user's personality and
+ * palette selections against the site style's authored choice lists
+ * (auto-picking the first/default choice when the request is absent, unknown,
+ * or not curated for this style), then delegates to `compileTokenRecipes` with
+ * the resolved IDs.
+ *
+ * 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: 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/theme-core/src/site-styles/styleTags.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+/**
+ * Descriptive style-axis metadata for button personalities and palette
+ * variants. Site Style picker shape is curated explicitly; these tags remain
+ * for catalog audit, docs, and future discovery tooling.
+ */
+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"];
+};
+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;
+}>;
+export type StyleTags = Readonly<Partial<StyleAxis>>;

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> & {

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

@@ -0,0 +1,47 @@
+/**
+ * Optional pre-set swatch passed to the chooser. Macadamia onboarding feeds
+ * logo-extracted colours here; the LiveThemeEditor and Style configurator
+ * pass an empty array (or omit the prop) so the dialog just exposes the
+ * freeform colour picker.
+ */
+export type ColorChooserSwatch = Readonly<{
+    hex: string;
+    label: string;
+}>;
+export type ColorChooserDialogProps = Readonly<{
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Current persisted value for the slot being edited. */
+    currentValue: string | null;
+    /** Suggested-swatch grid. Empty/omitted => freeform picker only. */
+    swatches?: ReadonlyArray<ColorChooserSwatch>;
+    /**
+     * Swatches in `swatches` that should render as visibly disabled
+     * (typically: already used elsewhere in the palette). Selecting one of
+     * these is still possible if it matches `currentValue`.
+     */
+    disabledHexes?: ReadonlyArray<string>;
+    /**
+     * Fallback hex used when neither `currentValue` nor `swatches[0]` resolve
+     * to a usable colour. Defaults to `#000000`; pass the brand colour if you
+     * want the dialog to open on it.
+     */
+    defaultValue?: string;
+    /** Localised dialog title. */
+    title?: string;
+    /** Localised body description. Falls back to a swatches-aware default. */
+    description?: string;
+    /** Confirm button label. Defaults to "Use this colour". */
+    confirmLabel?: string;
+    /** Optional remove handler. When provided, a "Remove colour" button appears. */
+    onRemove?: () => void;
+    /** Remove button label. Defaults to "Remove colour". */
+    removeLabel?: string;
+    onChoose: (value: string) => void;
+}>;
+/**
+ * Shared colour-chooser dialog. Combines an optional logo-derived swatch
+ * grid with a freeform `ColorPicker` + hex display. Consolidates the
+ * implementations that previously lived inline in Macadamia onboarding.
+ */
+export declare function ColorChooserDialog({ open, onOpenChange, currentValue, swatches, disabledHexes, defaultValue, title, description, confirmLabel, onRemove, removeLabel, onChoose, }: ColorChooserDialogProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,15 @@
+/**
+ * Slot affordance for "this row holds a colour, click to choose". Renders as
+ * an empty dashed-border tile when `value` is null, or as a filled swatch
+ * with the hex displayed when a value is set. Used in the Macadamia
+ * onboarding's primary/secondary colour rows and the Style configurator's
+ * advanced palette panel.
+ */
+export type ColorSlotButtonProps = Readonly<{
+    value: string | null;
+    emptyLabel: string;
+    ariaLabel: string;
+    onClick: () => void;
+    className?: string;
+}>;
+export declare function ColorSlotButton({ value, emptyLabel, ariaLabel, onClick, className }: ColorSlotButtonProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,15 @@
+/**
+ * Compact swatch + label tile. Used in the colour-chooser dialog's
+ * "from your logo" grid and anywhere a palette-aware single-colour row is
+ * needed (Macadamia onboarding's brand colour rows, the Style configurator
+ * advanced palette panel).
+ */
+export type ColorSwatchButtonProps = Readonly<{
+    hex: string;
+    label: string;
+    selected: boolean;
+    onClick: () => void;
+    disabled?: boolean;
+    className?: string;
+}>;
+export declare function ColorSwatchButton({ hex, label, selected, onClick, disabled, className }: ColorSwatchButtonProps): import("react/jsx-runtime").JSX.Element;