@riverbankcms/sdk 0.60.3 → 0.60.7

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

@@ -8,21 +8,21 @@ import { z } from 'zod';
  * Padding preset options for nav links
  */
 export declare const navLinkPaddingSchema: z.ZodEnum<{
+    default: "default";
     none: "none";
     compact: "compact";
-    default: "default";
 }>;
 /**
  * Horizontal padding override for nav links.
  * When set, overrides only the horizontal component of the `padding` preset.
  */
 export declare const navLinkPaddingXSchema: z.ZodEnum<{
+    default: "default";
     none: "none";
     compact: "compact";
-    spacious: "spacious";
-    default: "default";
     tight: "tight";
     relaxed: "relaxed";
+    spacious: "spacious";
 }>;
 /**
  * Border radius options for nav links
@@ -30,24 +30,24 @@ export declare const navLinkPaddingXSchema: z.ZodEnum<{
 export declare const navLinkBorderRadiusSchema: z.ZodEnum<{
     full: "full";
     none: "none";
-    sm: "sm";
     md: "md";
+    sm: "sm";
 }>;
 /**
  * Typography size options for nav links.
  */
 export declare const navLinkTextSizeSchema: z.ZodEnum<{
-    base: "base";
-    sm: "sm";
     lg: "lg";
     xs: "xs";
+    sm: "sm";
+    base: "base";
 }>;
 /**
  * Letter spacing options for nav links.
  */
 export declare const navLinkLetterSpacingSchema: z.ZodEnum<{
-    wide: "wide";
     normal: "normal";
+    wide: "wide";
     wider: "wider";
     widest: "widest";
 }>;
@@ -59,36 +59,36 @@ export declare const navLinkLetterSpacingSchema: z.ZodEnum<{
 export declare const navLinkStyleSchema: z.ZodObject<{
     colorToken: z.ZodDefault<z.ZodString>;
     textSize: z.ZodOptional<z.ZodEnum<{
-        base: "base";
-        sm: "sm";
         lg: "lg";
         xs: "xs";
+        sm: "sm";
+        base: "base";
     }>>;
     letterSpacing: z.ZodOptional<z.ZodEnum<{
-        wide: "wide";
         normal: "normal";
+        wide: "wide";
         wider: "wider";
         widest: "widest";
     }>>;
     hoverColorToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     padding: z.ZodDefault<z.ZodEnum<{
+        default: "default";
         none: "none";
         compact: "compact";
-        default: "default";
     }>>;
     paddingX: z.ZodOptional<z.ZodEnum<{
+        default: "default";
         none: "none";
         compact: "compact";
-        spacious: "spacious";
-        default: "default";
         tight: "tight";
         relaxed: "relaxed";
+        spacious: "spacious";
     }>>;
     borderRadius: z.ZodDefault<z.ZodEnum<{
         full: "full";
         none: "none";
-        sm: "sm";
         md: "md";
+        sm: "sm";
     }>>;
     effects: z.ZodOptional<z.ZodObject<{
         base: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -113,15 +113,15 @@ export declare const navLinkStyleSchema: z.ZodObject<{
         heading: "heading";
     }>>;
     fontWeight: z.ZodDefault<z.ZodEnum<{
-        medium: "medium";
         bold: "bold";
         regular: "regular";
+        medium: "medium";
         semibold: "semibold";
     }>>;
     textTransform: z.ZodDefault<z.ZodEnum<{
         none: "none";
-        capitalize: "capitalize";
         uppercase: "uppercase";
+        capitalize: "capitalize";
     }>>;
     italic: z.ZodDefault<z.ZodBoolean>;
     name: z.ZodOptional<z.ZodString>;

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.
@@ -19,17 +19,17 @@ export type PaletteTokenName = (typeof PALETTE_TOKEN_NAMES)[number];
 export declare const paletteTokenNameSchema: z.ZodEnum<{
     success: "success";
     text: "text";
+    surface: "surface";
+    warning: "warning";
+    border: "border";
+    background: "background";
     primary: "primary";
+    primaryForeground: "primaryForeground";
     secondary: "secondary";
-    background: "background";
-    surface: "surface";
     accent: "accent";
-    muted: "muted";
-    border: "border";
-    warning: "warning";
     destructive: "destructive";
-    primaryForeground: "primaryForeground";
     surfaceAlt: "surfaceAlt";
+    muted: "muted";
 }>;
 export type HexColor = string & {
     readonly __brand: 'HexColor';
@@ -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,14 +54,14 @@ 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<{
         tone: z.ZodOptional<z.ZodEnum<{
-            classic: "classic";
             bold: "bold";
             minimal: "minimal";
+            classic: "classic";
         }>>;
         energy: z.ZodOptional<z.ZodEnum<{
             calm: "calm";
@@ -81,36 +81,36 @@ export declare const paletteVariantSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>;
     mode: z.ZodEnum<{
-        dark: "dark";
         light: "light";
+        dark: "dark";
     }>;
     colors: z.ZodArray<z.ZodObject<{
         hex: z.ZodString;
         name: z.ZodEnum<{
             success: "success";
             text: "text";
+            surface: "surface";
+            warning: "warning";
+            border: "border";
+            background: "background";
             primary: "primary";
+            primaryForeground: "primaryForeground";
             secondary: "secondary";
-            background: "background";
-            surface: "surface";
             accent: "accent";
-            muted: "muted";
-            border: "border";
-            warning: "warning";
             destructive: "destructive";
-            primaryForeground: "primaryForeground";
             surfaceAlt: "surfaceAlt";
+            muted: "muted";
         }>;
     }, 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
@@ -137,7 +137,7 @@ export declare const paletteOverridesSchema: z.ZodPipe<z.ZodObject<{
     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>>>, {
+}, z.core.$strict>, z.ZodTransform<Readonly<Partial<Record<"success" | "text" | "surface" | "warning" | "border" | "background" | "primary" | "primaryForeground" | "secondary" | "accent" | "destructive" | "surfaceAlt" | "muted", HexColor>>>, {
     primary?: HexColor | undefined;
     primaryForeground?: HexColor | undefined;
     secondary?: HexColor | undefined;