@riverbankcms/sdk 0.60.1 → 0.60.3

package/dist/_dts/theme-core/src/palette/variants/brand-led.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Brand-led family — confident, modern, contemporary brand voices. Pairs
+ * with Clear Professional, Bright Community, Practical Services site styles.
+ */
+export declare const brandLedCool: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;
+export declare const brandLedWarm: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;
+export declare const brandLedJewel: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;

package/dist/_dts/theme-core/src/palette/variants/high-contrast.d.ts

@@ -0,0 +1,28 @@
+/**
+ * High-contrast family — editorial and minimal voices with high legibility.
+ * Pairs with Quiet Luxury, Bold Launch, Practical Services site styles.
+ */
+export declare const highContrastInk: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;
+export declare const highContrastCharcoal: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;
+export declare const highContrastMonochrome: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;

package/dist/_dts/theme-core/src/palette/variants/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Palette variant library.
+ *
+ * Each variant is a complete colour palette tagged on the four style axes
+ * (tone / energy / motion / era — motion is rarely used for palettes).
+ * Curated site styles declare a default palette + an acceptance region that
+ * filters the picker; the Style configurator UI uses `compatibleEntries`
+ * from `site-styles/compatibility.ts` to surface valid options.
+ *
+ * `paletteOverrides` carries per-token hex edits applied on top of the
+ * chosen variant; see the merge semantics in `compileSiteThemeFromSelections`.
+ */
+import type { PaletteVariant, PaletteVariantId } from './types';
+export type { HexColor, PaletteColor, PaletteOverrides, PaletteTokenName, PaletteVariant, PaletteVariantId } from './types';
+export { PALETTE_TOKEN_NAMES, asPaletteVariantId, definePaletteVariant, hexColorSchema, paletteOverridesSchema, paletteTokenNameSchema, paletteVariantIdSchema, paletteVariantSchema, } from './types';
+export declare const paletteVariants: readonly PaletteVariant[];
+export declare function findPaletteVariant(id: PaletteVariantId): PaletteVariant | undefined;

package/dist/_dts/theme-core/src/palette/variants/soft-natural.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Soft-natural family — calm, organic, plant-led voices. Pairs with Calm
+ * Studio, Modern Wellness, Warm Editorial site styles.
+ */
+export declare const softNaturalSage: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;
+export declare const softNaturalStone: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;
+export declare const softNaturalWatercolor: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;

package/dist/_dts/theme-core/src/palette/variants/types.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { type StyleTags } from '../../site-styles/compatibility';
+/**
+ * Branded ID for a palette variant in the curated library. Shape matches the
+ * `Brand<T, TBrand>` convention in `site-styles/types.ts`. Use the helper at
+ * the parse/construction boundary.
+ */
+export type PaletteVariantId = string & {
+    readonly __brand: 'PaletteVariantId';
+};
+export declare function asPaletteVariantId(value: string): PaletteVariantId;
+export declare const paletteVariantIdSchema: z.ZodPipe<z.ZodString, z.ZodTransform<PaletteVariantId, string>>;
+/**
+ * Known palette role token names. Closed union so unknown tokens can't be
+ * persisted via `paletteOverrides`. Add a new role here intentionally.
+ */
+export declare const PALETTE_TOKEN_NAMES: readonly ["primary", "primaryForeground", "secondary", "accent", "success", "warning", "destructive", "background", "surface", "surfaceAlt", "muted", "text", "border"];
+export type PaletteTokenName = (typeof PALETTE_TOKEN_NAMES)[number];
+export declare const paletteTokenNameSchema: z.ZodEnum<{
+    success: "success";
+    text: "text";
+    primary: "primary";
+    secondary: "secondary";
+    background: "background";
+    surface: "surface";
+    accent: "accent";
+    muted: "muted";
+    border: "border";
+    warning: "warning";
+    destructive: "destructive";
+    primaryForeground: "primaryForeground";
+    surfaceAlt: "surfaceAlt";
+}>;
+export type HexColor = string & {
+    readonly __brand: 'HexColor';
+};
+export declare const hexColorSchema: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+/**
+ * One slot in a palette variant. `name` is restricted to the closed
+ * `PaletteTokenName` union so authoring typos (`'priamry'`) are caught at
+ * compile time; the value side stays as raw `string` (validated by
+ * `paletteColorSchema`'s less-strict regex for back-compat with existing data).
+ */
+export type PaletteColor = Readonly<{
+    name: PaletteTokenName;
+    hex: string;
+}>;
+export type PaletteVariant = Readonly<{
+    id: PaletteVariantId;
+    name: string;
+    description: string;
+    tags: StyleTags;
+    mode: 'light' | 'dark';
+    colors: ReadonlyArray<PaletteColor>;
+}>;
+export declare const paletteVariantSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<PaletteVariantId, string>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    tags: 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>;
+    mode: z.ZodEnum<{
+        dark: "dark";
+        light: "light";
+    }>;
+    colors: z.ZodArray<z.ZodObject<{
+        hex: z.ZodString;
+        name: z.ZodEnum<{
+            success: "success";
+            text: "text";
+            primary: "primary";
+            secondary: "secondary";
+            background: "background";
+            surface: "surface";
+            accent: "accent";
+            muted: "muted";
+            border: "border";
+            warning: "warning";
+            destructive: "destructive";
+            primaryForeground: "primaryForeground";
+            surfaceAlt: "surfaceAlt";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function definePaletteVariant(input: {
+    id: string;
+    name: string;
+    description: string;
+    tags: StyleTags;
+    mode: 'light' | 'dark';
+    colors: ReadonlyArray<PaletteColor>;
+}): PaletteVariant;
+/**
+ * Sparse per-token override map. Loaded from / persisted to
+ * `site_theme_selections.palette_overrides`. Empty / null means "no overrides
+ * applied; the palette variant's own colours render unchanged."
+ */
+export type PaletteOverrides = Readonly<Partial<Record<PaletteTokenName, HexColor>>>;
+/**
+ * Sparse object of known token names → hex colours. Unknown keys are
+ * rejected at parse time; missing keys mean "no override for that token".
+ * Built as an explicit partial-object schema (rather than `z.record(enum, …)`)
+ * for unambiguous closure under Zod 4.
+ */
+export declare const paletteOverridesSchema: z.ZodPipe<z.ZodObject<{
+    primary: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    primaryForeground: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    secondary: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    accent: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    success: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    warning: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    destructive: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    background: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    surface: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    surfaceAlt: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    muted: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    text: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+    border: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>>;
+}, z.core.$strict>, z.ZodTransform<Readonly<Partial<Record<"success" | "text" | "primary" | "secondary" | "background" | "surface" | "accent" | "muted" | "border" | "warning" | "destructive" | "primaryForeground" | "surfaceAlt", HexColor>>>, {
+    primary?: HexColor | undefined;
+    primaryForeground?: HexColor | undefined;
+    secondary?: HexColor | undefined;
+    accent?: HexColor | undefined;
+    success?: HexColor | undefined;
+    warning?: HexColor | undefined;
+    destructive?: HexColor | undefined;
+    background?: HexColor | undefined;
+    surface?: HexColor | undefined;
+    surfaceAlt?: HexColor | undefined;
+    muted?: HexColor | undefined;
+    text?: HexColor | undefined;
+    border?: HexColor | undefined;
+}>>;

package/dist/_dts/theme-core/src/palette/variants/warm-neutral.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Warm-neutral family — earthy, organic, hand-made brand voices. Pairs with
+ * Warm Editorial, Modern Wellness, Calm Studio site styles.
+ */
+export declare const warmNeutralClay: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;
+export declare const warmNeutralCream: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;
+export declare const warmNeutralForest: Readonly<{
+    id: import("@riverbankcms/blocks").PaletteVariantId;
+    name: string;
+    description: string;
+    tags: import("../../site-styles").StyleTags;
+    mode: "light" | "dark";
+    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+}>;

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