@riverbankcms/sdk 0.60.3 → 0.60.6

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

@@ -1,9 +1,11 @@
-import type { ButtonPersonalityId } from '../buttons/personalities';
-import type { PaletteVariantId } from '../palette/variants';
-import type { AcceptanceRegion } from './compatibility';
-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;
@@ -11,26 +13,13 @@ 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;
+    /** 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
@@ -43,25 +32,10 @@ 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;
+    /** 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;
@@ -69,25 +43,10 @@ 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;
+    /** 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;
@@ -95,25 +54,10 @@ 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;
+    /** 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;
@@ -121,25 +65,10 @@ 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;
+    /** 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;
@@ -147,25 +76,10 @@ 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;
+    /** 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;
@@ -173,25 +87,10 @@ 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;
+    /** 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;
@@ -199,25 +98,10 @@ 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;
+    /** 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;
@@ -225,25 +109,10 @@ 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;
+    /** 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;
@@ -252,24 +121,9 @@ 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;
+    /** 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,7 +1,7 @@
 export * from './appearancePresets';
 export * from './blockFlow';
-export * from './compatibility';
 export * from './compositionBudget';
+export * from './curatedChoices';
 export * from './curatedSiteStyles';
 export * from './designState';
 export * from './generatedSchemas';
@@ -15,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/previewCompiler.d.ts

@@ -19,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";
 /**
@@ -33,21 +34,17 @@ export type CuratedSiteStyleTheme = Theme & Readonly<{
 /**
  * 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.
+ * `compileSiteThemeFromSelections({…, null, null, null})`.
  */
 export declare function compileCuratedSiteStyleTheme(siteStyle: CuratedSiteStyle): CuratedSiteStyleTheme;
 export declare function compileCuratedSiteStyleThemeById(siteStyleId: SiteStyleId): CuratedSiteStyleTheme | null;
-export type CompatibilityWarning = Readonly<{
+export type SelectionFallbackWarning = Readonly<{
     kind: 'rejected-personality';
-    requested: ButtonPersonalityId;
+    requested: string;
     fellBackTo: ButtonPersonalityId;
 }> | Readonly<{
     kind: 'rejected-palette';
-    requested: PaletteVariantId;
+    requested: string;
     fellBackTo: PaletteVariantId;
 }>;
 export type SiteThemeSelectionsInput = Readonly<{
@@ -62,16 +59,17 @@ export type SiteThemeSelectionsResult = Readonly<{
         buttonPersonalityId: ButtonPersonalityId;
         paletteVariantId: PaletteVariantId;
     }>;
-    warnings: ReadonlyArray<CompatibilityWarning>;
+    warnings: ReadonlyArray<SelectionFallbackWarning>;
 }>;
 /**
  * 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.
+ * 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 compatibility warnings the UI can surface as "we changed your selection"
+ * any fallback warnings the UI can surface as "we changed your selection"
  * notices.
  */
 export declare function compileSiteThemeFromSelections(input: SiteThemeSelectionsInput): SiteThemeSelectionsResult;

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

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

@@ -0,0 +1,50 @@
+/**
+ * One palette role slot. `name` is intentionally a free string here so the
+ * component can be reused for theme palettes that predate the closed
+ * `PaletteTokenName` union; callers pass the role-label mapping via `roles`.
+ */
+export type PaletteToken = Readonly<{
+    name: string;
+    hex: string;
+}>;
+export type PaletteRole = Readonly<{
+    key: string;
+    label: string;
+}>;
+export declare const DEFAULT_BRAND_ROLES: ReadonlyArray<PaletteRole>;
+export declare const DEFAULT_FEEDBACK_ROLES: ReadonlyArray<PaletteRole>;
+export declare const DEFAULT_SURFACE_ROLES: ReadonlyArray<PaletteRole>;
+export type PaletteTokenEditorProps = Readonly<{
+    /**
+     * Current palette colours. Only entries whose `name` matches one of the
+     * configured role keys are surfaced; extra entries pass through untouched.
+     */
+    palette: ReadonlyArray<PaletteToken>;
+    /**
+     * Called when the user edits a role's hex via the picker or the input
+     * field. The editor filters implausible strings and forwards a canonical
+     * lowercase `#RRGGBB` value via `normalizeHex`; the handler can merge
+     * the value into its store without further normalisation.
+     */
+    onChange: (role: string, hex: string) => void;
+    /**
+     * Optional invalid-palette banner — shown when the consumer wants to
+     * surface schema errors (e.g. from a Zod parse failure) without coupling
+     * the editor to a validation context.
+     */
+    hasInvalidValues?: boolean;
+    /** Override the default role groupings (e.g. to add `primaryForeground`). */
+    brandRoles?: ReadonlyArray<PaletteRole>;
+    feedbackRoles?: ReadonlyArray<PaletteRole>;
+    surfaceRoles?: ReadonlyArray<PaletteRole>;
+    showContrastChecks?: boolean;
+    className?: string;
+}>;
+/**
+ * Shared palette role grid + contrast checker. Self-contained: no theme-
+ * editor / validation context dependencies. Used by:
+ *   - Macadamia onboarding (advanced colour panel, planned)
+ *   - LiveThemeEditor's palette tab (via a thin context wrapper)
+ *   - Style configurator's brand-colours row
+ */
+export declare function PaletteTokenEditor({ palette, onChange, hasInvalidValues, brandRoles, feedbackRoles, surfaceRoles, showContrastChecks, className, }: PaletteTokenEditorProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,23 @@
+/**
+ * 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`.
+ *
+ * Pure functions; no DOM, no React.
+ */
+/**
+ * Coerces user input into a canonical lowercase `#RRGGBB` form. Accepts
+ * 3-digit shorthand, case-insensitive 6-digit hex, and the same forms with or
+ * 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.
+ */
+export declare function normalizeHex(input: string | null | undefined, fallback?: string): string;
+/**
+ * WCAG relative luminance + contrast ratio. Rounded to 2 decimal places so
+ * the result is stable for UI display.
+ */
+export declare function contrastRatio(hexA: string, hexB: string): number;

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

@@ -0,0 +1,14 @@
+/**
+ * @riverbankcms/ui/palette — shared palette-editing primitives.
+ *
+ * Consolidates three palette-editing surfaces that had drifted in the
+ * dashboard: Macadamia onboarding's colour chooser, the LiveThemeEditor's
+ * palette tab, and the Style configurator's brand-colours panel. Each
+ * component is self-contained (no context coupling) and built on
+ * Riverbank UI primitives so it works in any client tree.
+ */
+export { ColorSwatchButton, type ColorSwatchButtonProps } from './ColorSwatchButton';
+export { ColorSlotButton, type ColorSlotButtonProps } from './ColorSlotButton';
+export { ColorChooserDialog, type ColorChooserDialogProps, type ColorChooserSwatch, } from './ColorChooserDialog';
+export { PaletteTokenEditor, type PaletteTokenEditorProps, type PaletteToken, type PaletteRole, DEFAULT_BRAND_ROLES, DEFAULT_FEEDBACK_ROLES, DEFAULT_SURFACE_ROLES, } from './PaletteTokenEditor';
+export { contrastRatio, normalizeHex } from './hex';