@riverbankcms/sdk 0.103.0 → 0.104.0

package/dist/_dts/theme-core/src/palette/{variants → curated}/index.d.ts

@@ -1,20 +1,19 @@
 /**
- * Palette variant library.
+ * Curated palette library.
  *
- * Each variant is a complete colour palette tagged on the four style axes
+ * Each palette 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 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`.
+ * Legacy `paletteOverrides` remain exported only as migration input.
  */
-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 [Readonly<{
-    id: PaletteVariantId<"brand-led-cool">;
+import type { CuratedPalette, CuratedPaletteId } from './types';
+export type { CuratedPalette, CuratedPaletteId, HexColor, PaletteColorEntry, PaletteColors, PaletteMode, PaletteOverrides, PaletteTokenName, } from './types';
+export { PALETTE_TOKEN_NAMES, asCuratedPaletteId, defineCuratedPalette, hexColorSchema, paletteColorsSchema, paletteModeSchema, paletteOverridesSchema, paletteTokenNameSchema, curatedPaletteIdSchema, curatedPaletteSchema, } from './types';
+export declare const curatedPalettes: readonly [Readonly<{
+    id: CuratedPaletteId<"brand-led-cool">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -23,13 +22,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"brand-led-warm">;
+    id: CuratedPaletteId<"brand-led-warm">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -38,13 +34,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"brand-led-jewel">;
+    id: CuratedPaletteId<"brand-led-jewel">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -53,13 +46,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"brand-led-burgundy-gold">;
+    id: CuratedPaletteId<"brand-led-burgundy-gold">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -68,13 +58,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"warm-neutral-clay">;
+    id: CuratedPaletteId<"warm-neutral-clay">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -83,13 +70,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"warm-neutral-cream">;
+    id: CuratedPaletteId<"warm-neutral-cream">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -98,13 +82,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"warm-neutral-soft-earth">;
+    id: CuratedPaletteId<"warm-neutral-soft-earth">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -113,13 +94,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"warm-neutral-forest">;
+    id: CuratedPaletteId<"warm-neutral-forest">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -128,13 +106,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"high-contrast-ink">;
+    id: CuratedPaletteId<"high-contrast-ink">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -143,13 +118,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"high-contrast-charcoal">;
+    id: CuratedPaletteId<"high-contrast-charcoal">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -158,13 +130,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"high-contrast-monochrome">;
+    id: CuratedPaletteId<"high-contrast-monochrome">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -173,13 +142,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"soft-natural-sage">;
+    id: CuratedPaletteId<"soft-natural-sage">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -188,13 +154,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"soft-natural-stone">;
+    id: CuratedPaletteId<"soft-natural-stone">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -203,13 +166,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"soft-natural-watercolor">;
+    id: CuratedPaletteId<"soft-natural-watercolor">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -218,13 +178,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"soft-natural-lilac">;
+    id: CuratedPaletteId<"soft-natural-lilac">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -233,13 +190,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"warm-dark-ember">;
+    id: CuratedPaletteId<"warm-dark-ember">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -248,13 +202,10 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>, Readonly<{
-    id: PaletteVariantId<"warm-dark-kirtan-gold">;
+    id: CuratedPaletteId<"warm-dark-kirtan-gold">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -263,26 +214,23 @@ export declare const paletteVariants: readonly [Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>];
-type UnbrandedPaletteVariantId<TValue> = TValue extends infer TRaw & {
-    readonly __brand: 'PaletteVariantId';
+type UnbrandedCuratedPaletteId<TValue> = TValue extends infer TRaw & {
+    readonly __brand: 'CuratedPaletteId';
 } ? 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<{
+export type KnownCuratedPaletteId = (typeof curatedPalettes)[number]['id'];
+export type KnownCuratedPaletteIdValue = UnbrandedCuratedPaletteId<KnownCuratedPaletteId>;
+export declare function findCuratedPalette(id: CuratedPaletteId): CuratedPalette | undefined;
+export declare function isKnownCuratedPaletteId(value: string): value is KnownCuratedPaletteId;
+export type PersistedCuratedPaletteIdParseResult = Readonly<{
     kind: 'known';
-    id: KnownPaletteVariantId;
+    id: KnownCuratedPaletteId;
 }> | Readonly<{
     kind: 'unknown';
     raw: string;
 }> | Readonly<{
     kind: 'empty';
 }>;
-export declare function parsePersistedPaletteVariantId(value: string | null | undefined): PersistedPaletteVariantIdParseResult;
+export declare function parsePersistedCuratedPaletteId(value: string | null | undefined): PersistedCuratedPaletteIdParseResult;

package/dist/_dts/theme-core/src/palette/{variants → curated}/soft-natural.d.ts

@@ -3,7 +3,7 @@
  * Studio, Modern Wellness, Warm Editorial site styles.
  */
 export declare const softNaturalSage: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"soft-natural-sage">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"soft-natural-sage">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -12,14 +12,11 @@ export declare const softNaturalSage: Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const softNaturalStone: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"soft-natural-stone">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"soft-natural-stone">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -28,14 +25,11 @@ export declare const softNaturalStone: Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const softNaturalWatercolor: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"soft-natural-watercolor">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"soft-natural-watercolor">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -44,14 +38,11 @@ export declare const softNaturalWatercolor: Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const softNaturalLilac: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"soft-natural-lilac">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"soft-natural-lilac">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -60,9 +51,6 @@ export declare const softNaturalLilac: Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>;

package/dist/_dts/theme-core/src/palette/{variants → curated}/types.d.ts

@@ -1,41 +1,24 @@
 import { z } from 'zod';
 import { type StyleTags } from '../../site-styles/styleTags';
 import { PALETTE_TOKEN_NAMES, paletteTokenNameSchema, type PaletteTokenName } from '../../tokens/themeColorTokens';
-export { PALETTE_TOKEN_NAMES, paletteTokenNameSchema, type PaletteTokenName, };
-/**
- * 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<T extends string = string> = T & {
-    readonly __brand: 'PaletteVariantId';
+import { hexColorSchema, paletteColorsSchema, paletteModeSchema, type HexColor, type PaletteColorEntry, type PaletteColors, type PaletteMode } from '../colors';
+export { PALETTE_TOKEN_NAMES, hexColorSchema, paletteColorsSchema, paletteModeSchema, paletteTokenNameSchema, type PaletteTokenName, };
+export type { HexColor, PaletteColorEntry, PaletteColors, PaletteMode };
+export type CuratedPaletteId<T extends string = string> = T & {
+    readonly __brand: 'CuratedPaletteId';
 };
-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>>;
-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<TId extends PaletteVariantId = PaletteVariantId> = Readonly<{
+export declare function asCuratedPaletteId<const T extends string>(value: T): CuratedPaletteId<T>;
+export declare const curatedPaletteIdSchema: z.ZodPipe<z.ZodString, z.ZodTransform<CuratedPaletteId<string>, string>>;
+export type CuratedPalette<TId extends CuratedPaletteId = CuratedPaletteId> = Readonly<{
     id: TId;
     name: string;
     description: string;
     tags: StyleTags;
-    mode: 'light' | 'dark';
-    colors: ReadonlyArray<PaletteColor>;
+    mode: PaletteMode;
+    colors: PaletteColors;
 }>;
-export declare const paletteVariantSchema: z.ZodObject<{
-    id: z.ZodPipe<z.ZodString, z.ZodTransform<PaletteVariantId<string>, string>>;
+export declare const curatedPaletteSchema: z.ZodObject<{
+    id: z.ZodPipe<z.ZodString, z.ZodTransform<CuratedPaletteId<string>, string>>;
     name: z.ZodString;
     description: z.ZodString;
     tags: z.ZodObject<{
@@ -65,45 +48,52 @@ export declare const paletteVariantSchema: z.ZodObject<{
         light: "light";
         dark: "dark";
     }>;
-    colors: z.ZodArray<z.ZodObject<{
-        hex: z.ZodString;
-        name: z.ZodEnum<{
-            surface: "surface";
-            success: "success";
-            text: "text";
-            warning: "warning";
-            background: "background";
-            accent: "accent";
-            muted: "muted";
-            border: "border";
-            primary: "primary";
-            secondary: "secondary";
-            destructive: "destructive";
-            surfaceAlt: "surfaceAlt";
-            primaryForeground: "primaryForeground";
-        }>;
-    }, z.core.$strip>>;
+    colors: z.ZodPipe<z.ZodObject<{
+        primary: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        primaryForeground: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        secondary: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        accent: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        success: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        warning: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        destructive: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        background: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        surface: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        surfaceAlt: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        muted: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        text: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+        border: z.ZodPipe<z.ZodString, z.ZodTransform<HexColor, string>>;
+    }, z.core.$strict>, z.ZodTransform<Readonly<Record<"surface" | "success" | "text" | "warning" | "background" | "accent" | "muted" | "border" | "primary" | "secondary" | "destructive" | "surfaceAlt" | "primaryForeground", HexColor>>, {
+        primary: HexColor;
+        primaryForeground: HexColor;
+        secondary: HexColor;
+        accent: HexColor;
+        success: HexColor;
+        warning: HexColor;
+        destructive: HexColor;
+        background: HexColor;
+        surface: HexColor;
+        surfaceAlt: HexColor;
+        muted: HexColor;
+        text: HexColor;
+        border: HexColor;
+    }>>;
 }, z.core.$strip>;
-export declare function definePaletteVariant<const TId extends string>(input: {
+export declare function defineCuratedPalette<const TId extends string>(input: {
     id: TId;
     name: string;
     description: string;
     tags: StyleTags;
-    mode: 'light' | 'dark';
-    colors: ReadonlyArray<PaletteColor>;
-}): PaletteVariant<PaletteVariantId<TId>>;
+    mode: PaletteMode;
+    colors: ReadonlyArray<Readonly<{
+        name: PaletteTokenName;
+        hex: string;
+    }>>;
+}): CuratedPalette<CuratedPaletteId<TId>>;
 /**
- * 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."
+ * Migration-only sparse colours from the legacy
+ * `site_theme_selections.palette_overrides` contract.
  */
 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>>>;

package/dist/_dts/theme-core/src/palette/{variants → curated}/warm-dark.d.ts

@@ -10,7 +10,7 @@
  * scale, `mutedText`, and derived on-colors invert correctly.
  */
 export declare const warmDarkEmber: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"warm-dark-ember">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-dark-ember">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -19,14 +19,11 @@ export declare const warmDarkEmber: Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const warmDarkKirtanGold: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"warm-dark-kirtan-gold">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-dark-kirtan-gold">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -35,9 +32,6 @@ export declare const warmDarkKirtanGold: Readonly<{
         motion: import("../../../../blocks/src/index").StyleMotion;
         era: import("../../../../blocks/src/index").StyleEra;
     }>>>;
-    mode: "light" | "dark";
-    colors: readonly Readonly<{
-        name: import("../../../../blocks/src/index").PaletteTokenName;
-        hex: string;
-    }>[];
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
 }>;