@riverbankcms/sdk 0.60.3 → 0.60.6

package/dist/_dts/theme-core/src/buttons/personalities/types.d.ts

@@ -1,31 +1,31 @@
 import { z } from 'zod';
 import { type ButtonSystem } from '../types';
-import { type StyleTags } from '../../site-styles/compatibility';
+import { type StyleTags } from '../../site-styles/styleTags';
 /**
  * Branded ID for a button personality entry in the curated library.
  * Shape matches the `Brand<T, TBrand>` convention in `site-styles/types.ts`
  * (kept structurally compatible until that alias is hoisted to a shared file).
  * Use `asButtonPersonalityId` at the parse/construction boundary.
  */
-export type ButtonPersonalityId = string & {
+export type ButtonPersonalityId<T extends string = string> = T & {
     readonly __brand: 'ButtonPersonalityId';
 };
-export declare function asButtonPersonalityId(value: string): ButtonPersonalityId;
-export declare const buttonPersonalityIdSchema: z.ZodPipe<z.ZodString, z.ZodTransform<ButtonPersonalityId, string>>;
+export declare function asButtonPersonalityId<const T extends string>(value: T): ButtonPersonalityId<T>;
+export declare const buttonPersonalityIdSchema: z.ZodPipe<z.ZodString, z.ZodTransform<ButtonPersonalityId<string>, string>>;
 /**
  * A button personality is a complete `ButtonSystem` plus the tags that decide
  * which curated site styles will accept it. The `name` and `description` are
  * surfaced in the Style configurator UI.
  */
-export type ButtonPersonality = Readonly<{
-    id: ButtonPersonalityId;
+export type ButtonPersonality<TId extends ButtonPersonalityId = ButtonPersonalityId> = Readonly<{
+    id: TId;
     name: string;
     description: string;
     tags: StyleTags;
     buttonSystem: ButtonSystem;
 }>;
 export declare const buttonPersonalitySchema: z.ZodObject<{
-    id: z.ZodPipe<z.ZodString, z.ZodTransform<ButtonPersonalityId, string>>;
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<ButtonPersonalityId<string>, string>>;
     name: z.ZodString;
     description: z.ZodString;
     tags: z.ZodObject<{
@@ -259,10 +259,10 @@ export declare const buttonPersonalitySchema: z.ZodObject<{
  * type-safe. `as const satisfies ...` would also work but produces wider
  * types at use sites.
  */
-export declare function defineButtonPersonality(input: {
-    id: string;
+export declare function defineButtonPersonality<const TId extends string>(input: {
+    id: TId;
     name: string;
     description: string;
     tags: StyleTags;
     buttonSystem: ButtonSystem;
-}): ButtonPersonality;
+}): ButtonPersonality<ButtonPersonalityId<TId>>;

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

@@ -3,26 +3,50 @@
  * with Clear Professional, Bright Community, Practical Services site styles.
  */
 export declare const brandLedCool: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"brand-led-cool">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;
 export declare const brandLedWarm: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"brand-led-warm">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;
 export declare const brandLedJewel: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"brand-led-jewel">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;

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

@@ -3,26 +3,50 @@
  * Pairs with Quiet Luxury, Bold Launch, Practical Services site styles.
  */
 export declare const highContrastInk: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"high-contrast-ink">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;
 export declare const highContrastCharcoal: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"high-contrast-charcoal">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;
 export declare const highContrastMonochrome: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"high-contrast-monochrome">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;

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

@@ -3,9 +3,9 @@
  *
  * 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.
+ * Curated site styles declare ordered palette choices for the picker. Tags
+ * stay available as authoring/audit metadata; they no longer drive the Style
+ * configurator's option shape.
  *
  * `paletteOverrides` carries per-token hex edits applied on top of the
  * chosen variant; see the merge semantics in `compileSiteThemeFromSelections`.
@@ -13,5 +13,201 @@
 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 const paletteVariants: readonly [Readonly<{
+    id: PaletteVariantId<"brand-led-cool">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"brand-led-warm">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"brand-led-jewel">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"warm-neutral-clay">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"warm-neutral-cream">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"warm-neutral-forest">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"high-contrast-ink">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"high-contrast-charcoal">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"high-contrast-monochrome">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"soft-natural-sage">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"soft-natural-stone">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>, Readonly<{
+    id: PaletteVariantId<"soft-natural-watercolor">;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
+    mode: "light" | "dark";
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
+}>];
+type UnbrandedPaletteVariantId<TValue> = TValue extends infer TRaw & {
+    readonly __brand: 'PaletteVariantId';
+} ? TRaw extends string ? TRaw : never : never;
+export type KnownPaletteVariantId = (typeof paletteVariants)[number]['id'];
+export type KnownPaletteVariantIdValue = UnbrandedPaletteVariantId<KnownPaletteVariantId>;
 export declare function findPaletteVariant(id: PaletteVariantId): PaletteVariant | undefined;
+export declare function isKnownPaletteVariantId(value: string): value is KnownPaletteVariantId;
+export type PersistedPaletteVariantIdParseResult = Readonly<{
+    kind: 'known';
+    id: KnownPaletteVariantId;
+}> | Readonly<{
+    kind: 'unknown';
+    raw: string;
+}> | Readonly<{
+    kind: 'empty';
+}>;
+export declare function parsePersistedPaletteVariantId(value: string | null | undefined): PersistedPaletteVariantIdParseResult;

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

@@ -3,26 +3,50 @@
  * Studio, Modern Wellness, Warm Editorial site styles.
  */
 export declare const softNaturalSage: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"soft-natural-sage">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;
 export declare const softNaturalStone: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"soft-natural-stone">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;
 export declare const softNaturalWatercolor: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"soft-natural-watercolor">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;

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

@@ -1,15 +1,15 @@
 import { z } from 'zod';
-import { type StyleTags } from '../../site-styles/compatibility';
+import { type StyleTags } from '../../site-styles/styleTags';
 /**
  * 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 & {
+export type PaletteVariantId<T extends string = string> = T & {
     readonly __brand: 'PaletteVariantId';
 };
-export declare function asPaletteVariantId(value: string): PaletteVariantId;
-export declare const paletteVariantIdSchema: z.ZodPipe<z.ZodString, z.ZodTransform<PaletteVariantId, string>>;
+export declare function asPaletteVariantId<const T extends string>(value: T): PaletteVariantId<T>;
+export declare const paletteVariantIdSchema: z.ZodPipe<z.ZodString, z.ZodTransform<PaletteVariantId<string>, string>>;
 /**
  * Known palette role token names. Closed union so unknown tokens can't be
  * persisted via `paletteOverrides`. Add a new role here intentionally.
@@ -45,8 +45,8 @@ export type PaletteColor = Readonly<{
     name: PaletteTokenName;
     hex: string;
 }>;
-export type PaletteVariant = Readonly<{
-    id: PaletteVariantId;
+export type PaletteVariant<TId extends PaletteVariantId = PaletteVariantId> = Readonly<{
+    id: TId;
     name: string;
     description: string;
     tags: StyleTags;
@@ -54,7 +54,7 @@ export type PaletteVariant = Readonly<{
     colors: ReadonlyArray<PaletteColor>;
 }>;
 export declare const paletteVariantSchema: z.ZodObject<{
-    id: z.ZodPipe<z.ZodString, z.ZodTransform<PaletteVariantId, string>>;
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<PaletteVariantId<string>, string>>;
     name: z.ZodString;
     description: z.ZodString;
     tags: z.ZodObject<{
@@ -103,14 +103,14 @@ export declare const paletteVariantSchema: z.ZodObject<{
         }>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export declare function definePaletteVariant(input: {
-    id: string;
+export declare function definePaletteVariant<const TId extends string>(input: {
+    id: TId;
     name: string;
     description: string;
     tags: StyleTags;
     mode: 'light' | 'dark';
     colors: ReadonlyArray<PaletteColor>;
-}): PaletteVariant;
+}): PaletteVariant<PaletteVariantId<TId>>;
 /**
  * Sparse per-token override map. Loaded from / persisted to
  * `site_theme_selections.palette_overrides`. Empty / null means "no overrides

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

@@ -3,26 +3,50 @@
  * Warm Editorial, Modern Wellness, Calm Studio site styles.
  */
 export declare const warmNeutralClay: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"warm-neutral-clay">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;
 export declare const warmNeutralCream: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"warm-neutral-cream">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;
 export declare const warmNeutralForest: Readonly<{
-    id: import("@riverbankcms/blocks").PaletteVariantId;
+    id: import("@riverbankcms/blocks").PaletteVariantId<"warm-neutral-forest">;
     name: string;
     description: string;
-    tags: import("../../site-styles").StyleTags;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../site-styles").StyleTone;
+        energy: import("../../site-styles").StyleEnergy;
+        motion: import("../../site-styles").StyleMotion;
+        era: import("../../site-styles").StyleEra;
+    }>>>;
     mode: "light" | "dark";
-    colors: ReadonlyArray<import("@riverbankcms/blocks").PaletteColor>;
+    colors: readonly Readonly<{
+        name: import("@riverbankcms/blocks").PaletteTokenName;
+        hex: string;
+    }>[];
 }>;

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