@riverbankcms/sdk 0.104.1 → 0.107.0

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

@@ -3,7 +3,8 @@
  * with Clear Professional, Bright Community, Practical Services site styles.
  */
 export declare const brandLedCool: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"brand-led-cool">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"brand-led-cool">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -16,7 +17,8 @@ export declare const brandLedCool: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const brandLedWarm: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"brand-led-warm">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"brand-led-warm">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -29,7 +31,22 @@ export declare const brandLedWarm: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const brandLedJewel: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"brand-led-jewel">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"brand-led-jewel">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
+    name: string;
+    description: string;
+    tags: Readonly<Partial<Readonly<{
+        tone: import("../../../../blocks/src/index").StyleTone;
+        energy: import("../../../../blocks/src/index").StyleEnergy;
+        motion: import("../../../../blocks/src/index").StyleMotion;
+        era: import("../../../../blocks/src/index").StyleEra;
+    }>>>;
+    mode: import("../../../../blocks/src/index").PaletteMode;
+    colors: import("../../../../blocks/src/index").PaletteColors;
+}>;
+export declare const brandLedSpruce: Readonly<{
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"brand-led-spruce">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -42,7 +59,8 @@ export declare const brandLedJewel: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const brandLedBurgundyGold: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"brand-led-burgundy-gold">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"brand-led-burgundy-gold">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{

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

@@ -3,7 +3,8 @@
  * Pairs with Quiet Luxury, Bold Launch, Practical Services site styles.
  */
 export declare const highContrastInk: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"high-contrast-ink">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"high-contrast-ink">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -16,7 +17,8 @@ export declare const highContrastInk: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const highContrastCharcoal: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"high-contrast-charcoal">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"high-contrast-charcoal">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -29,7 +31,8 @@ export declare const highContrastCharcoal: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const highContrastMonochrome: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"high-contrast-monochrome">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"high-contrast-monochrome">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{

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

@@ -1,236 +1,43 @@
 /**
  * Curated palette library.
  *
- * 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.
- *
- * Legacy `paletteOverrides` remain exported only as migration input.
+ * Authoring keys are readable source aliases. Value keys are derived from the
+ * complete mode and semantic colours and are the only curated identity used at
+ * persistence and runtime boundaries.
  */
-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<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"brand-led-warm">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"brand-led-jewel">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"brand-led-burgundy-gold">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"warm-neutral-clay">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"warm-neutral-cream">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"warm-neutral-soft-earth">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"warm-neutral-forest">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"high-contrast-ink">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"high-contrast-charcoal">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"high-contrast-monochrome">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"soft-natural-sage">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"soft-natural-stone">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"soft-natural-watercolor">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"soft-natural-lilac">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"warm-dark-ember">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>, Readonly<{
-    id: CuratedPaletteId<"warm-dark-kirtan-gold">;
-    name: string;
-    description: string;
-    tags: Readonly<Partial<Readonly<{
-        tone: import("../../../../blocks/src/index").StyleTone;
-        energy: import("../../../../blocks/src/index").StyleEnergy;
-        motion: import("../../../../blocks/src/index").StyleMotion;
-        era: import("../../../../blocks/src/index").StyleEra;
-    }>>>;
-    mode: import("../../../../blocks/src/index").PaletteMode;
-    colors: import("../../../../blocks/src/index").PaletteColors;
-}>];
-type UnbrandedCuratedPaletteId<TValue> = TValue extends infer TRaw & {
-    readonly __brand: 'CuratedPaletteId';
+import { z } from 'zod';
+import { type PaletteValueKey } from '../colors';
+import type { CuratedPaletteAuthoringKey, CuratedPaletteDefinition } from './types';
+export type { CuratedPaletteAuthoringKey, CuratedPaletteDefinition, HexColor, PaletteColorEntry, PaletteColors, PaletteMode, PaletteOverrides, PaletteTokenName, } from './types';
+export type { PaletteValueKey } from '../colors';
+export { PALETTE_TOKEN_NAMES, asCuratedPaletteAuthoringKey, curatedPaletteAuthoringKeySchema, curatedPaletteSchema, defineCuratedPalette, hexColorSchema, paletteColorsSchema, paletteModeSchema, paletteOverridesSchema, paletteTokenNameSchema, } from './types';
+declare const knownCuratedPaletteValueKeyBrand: unique symbol;
+/** A canonical value key admitted to this module's curated catalogue. */
+export type KnownCuratedPaletteValueKey = PaletteValueKey & {
+    readonly [knownCuratedPaletteValueKeyBrand]: true;
+};
+export type CuratedPalette<TAuthoringKey extends CuratedPaletteAuthoringKey = CuratedPaletteAuthoringKey> = Omit<CuratedPaletteDefinition<TAuthoringKey>, 'valueKey'> & Readonly<{
+    valueKey: KnownCuratedPaletteValueKey;
+}>;
+export declare const curatedPalettes: readonly [CuratedPalette<CuratedPaletteAuthoringKey<"brand-led-cool">>, CuratedPalette<CuratedPaletteAuthoringKey<"brand-led-warm">>, CuratedPalette<CuratedPaletteAuthoringKey<"brand-led-jewel">>, CuratedPalette<CuratedPaletteAuthoringKey<"brand-led-burgundy-gold">>, CuratedPalette<CuratedPaletteAuthoringKey<"brand-led-spruce">>, CuratedPalette<CuratedPaletteAuthoringKey<"warm-neutral-clay">>, CuratedPalette<CuratedPaletteAuthoringKey<"warm-neutral-cream">>, CuratedPalette<CuratedPaletteAuthoringKey<"warm-neutral-soft-earth">>, CuratedPalette<CuratedPaletteAuthoringKey<"warm-neutral-forest">>, CuratedPalette<CuratedPaletteAuthoringKey<"high-contrast-ink">>, CuratedPalette<CuratedPaletteAuthoringKey<"high-contrast-charcoal">>, CuratedPalette<CuratedPaletteAuthoringKey<"high-contrast-monochrome">>, CuratedPalette<CuratedPaletteAuthoringKey<"soft-natural-sage">>, CuratedPalette<CuratedPaletteAuthoringKey<"soft-natural-stone">>, CuratedPalette<CuratedPaletteAuthoringKey<"soft-natural-watercolor">>, CuratedPalette<CuratedPaletteAuthoringKey<"soft-natural-lilac">>, CuratedPalette<CuratedPaletteAuthoringKey<"warm-dark-ember">>, CuratedPalette<CuratedPaletteAuthoringKey<"warm-dark-kirtan-gold">>];
+type Unbrand<TValue, TBrand extends string> = TValue extends infer TRaw & {
+    readonly __brand: TBrand;
 } ? TRaw extends string ? TRaw : never : never;
-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<{
+export type KnownCuratedPaletteAuthoringKey = (typeof curatedPalettes)[number]['authoringKey'];
+export type KnownCuratedPaletteAuthoringKeyValue = Unbrand<KnownCuratedPaletteAuthoringKey, 'CuratedPaletteAuthoringKey'>;
+export declare function findCuratedPalette(valueKey: PaletteValueKey): CuratedPalette | undefined;
+export declare function findCuratedPaletteByAuthoringKey(authoringKey: CuratedPaletteAuthoringKey): CuratedPalette | undefined;
+export declare function requireCuratedPaletteValueKey(authoringKey: CuratedPaletteAuthoringKey): KnownCuratedPaletteValueKey;
+export declare function isKnownCuratedPaletteValueKey(value: unknown): value is KnownCuratedPaletteValueKey;
+/** Parses a raw persisted key into catalogue-proven curated membership. */
+export declare const knownCuratedPaletteValueKeySchema: z.ZodPipe<z.ZodString, z.ZodTransform<KnownCuratedPaletteValueKey, string>>;
+export type PersistedCuratedPaletteValueKeyParseResult = Readonly<{
     kind: 'known';
-    id: KnownCuratedPaletteId;
+    valueKey: KnownCuratedPaletteValueKey;
 }> | Readonly<{
     kind: 'unknown';
     raw: string;
 }> | Readonly<{
     kind: 'empty';
 }>;
-export declare function parsePersistedCuratedPaletteId(value: string | null | undefined): PersistedCuratedPaletteIdParseResult;
+export declare function parsePersistedCuratedPaletteValueKey(value: string | null | undefined): PersistedCuratedPaletteValueKeyParseResult;

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

@@ -3,7 +3,8 @@
  * Studio, Modern Wellness, Warm Editorial site styles.
  */
 export declare const softNaturalSage: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"soft-natural-sage">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"soft-natural-sage">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -16,7 +17,8 @@ export declare const softNaturalSage: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const softNaturalStone: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"soft-natural-stone">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"soft-natural-stone">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -29,7 +31,8 @@ export declare const softNaturalStone: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const softNaturalWatercolor: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"soft-natural-watercolor">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"soft-natural-watercolor">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -42,7 +45,8 @@ export declare const softNaturalWatercolor: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const softNaturalLilac: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"soft-natural-lilac">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"soft-natural-lilac">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{

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

@@ -1,16 +1,17 @@
 import { z } from 'zod';
 import { type StyleTags } from '../../site-styles/styleTags';
 import { PALETTE_TOKEN_NAMES, paletteTokenNameSchema, type PaletteTokenName } from '../../tokens/themeColorTokens';
-import { hexColorSchema, paletteColorsSchema, paletteModeSchema, type HexColor, type PaletteColorEntry, type PaletteColors, type PaletteMode } from '../colors';
+import { hexColorSchema, paletteColorsSchema, paletteModeSchema, type HexColor, type PaletteColorEntry, type PaletteColors, type PaletteMode, type PaletteValueKey } 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 type { HexColor, PaletteColorEntry, PaletteColors, PaletteMode, PaletteValueKey, };
+export type CuratedPaletteAuthoringKey<T extends string = string> = T & {
+    readonly __brand: 'CuratedPaletteAuthoringKey';
 };
-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;
+export declare function asCuratedPaletteAuthoringKey<const T extends string>(value: T): CuratedPaletteAuthoringKey<T>;
+export declare const curatedPaletteAuthoringKeySchema: z.ZodPipe<z.ZodString, z.ZodTransform<CuratedPaletteAuthoringKey<string>, string>>;
+export type CuratedPaletteDefinition<TAuthoringKey extends CuratedPaletteAuthoringKey = CuratedPaletteAuthoringKey> = Readonly<{
+    authoringKey: TAuthoringKey;
+    valueKey: PaletteValueKey;
     name: string;
     description: string;
     tags: StyleTags;
@@ -18,7 +19,8 @@ export type CuratedPalette<TId extends CuratedPaletteId = CuratedPaletteId> = Re
     colors: PaletteColors;
 }>;
 export declare const curatedPaletteSchema: z.ZodObject<{
-    id: z.ZodPipe<z.ZodString, z.ZodTransform<CuratedPaletteId<string>, string>>;
+    authoringKey: z.ZodPipe<z.ZodString, z.ZodTransform<CuratedPaletteAuthoringKey<string>, string>>;
+    valueKey: z.ZodPipe<z.ZodString, z.ZodTransform<PaletteValueKey, string>>;
     name: z.ZodString;
     description: z.ZodString;
     tags: z.ZodObject<{
@@ -78,8 +80,8 @@ export declare const curatedPaletteSchema: z.ZodObject<{
         border: HexColor;
     }>>;
 }, z.core.$strip>;
-export declare function defineCuratedPalette<const TId extends string>(input: {
-    id: TId;
+export declare function defineCuratedPalette<const TAuthoringKey extends string>(input: {
+    authoringKey: TAuthoringKey;
     name: string;
     description: string;
     tags: StyleTags;
@@ -88,7 +90,7 @@ export declare function defineCuratedPalette<const TId extends string>(input: {
         name: PaletteTokenName;
         hex: string;
     }>>;
-}): CuratedPalette<CuratedPaletteId<TId>>;
+}): CuratedPaletteDefinition<CuratedPaletteAuthoringKey<TAuthoringKey>>;
 /**
  * Migration-only sparse colours from the legacy
  * `site_theme_selections.palette_overrides` contract.

package/dist/_dts/theme-core/src/palette/curated/warm-dark.d.ts

@@ -10,7 +10,8 @@
  * scale, `mutedText`, and derived on-colors invert correctly.
  */
 export declare const warmDarkEmber: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-dark-ember">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"warm-dark-ember">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -23,7 +24,8 @@ export declare const warmDarkEmber: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const warmDarkKirtanGold: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-dark-kirtan-gold">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"warm-dark-kirtan-gold">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{

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

@@ -3,7 +3,8 @@
  * Warm Editorial, Modern Wellness, Calm Studio site styles.
  */
 export declare const warmNeutralClay: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-neutral-clay">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"warm-neutral-clay">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -16,7 +17,8 @@ export declare const warmNeutralClay: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const warmNeutralCream: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-neutral-cream">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"warm-neutral-cream">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -29,7 +31,8 @@ export declare const warmNeutralCream: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const warmNeutralSoftEarth: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-neutral-soft-earth">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"warm-neutral-soft-earth">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -42,7 +45,8 @@ export declare const warmNeutralSoftEarth: Readonly<{
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
 export declare const warmNeutralForest: Readonly<{
-    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-neutral-forest">;
+    authoringKey: import("../../../../blocks/src/index").CuratedPaletteAuthoringKey<"warm-neutral-forest">;
+    valueKey: import("../../../../blocks/src/index").PaletteValueKey;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{

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

@@ -1,7 +1,7 @@
 import type { PaletteColors, PaletteMode } from './colors';
-import type { CuratedPaletteId } from './curated/types';
+import type { KnownCuratedPaletteValueKey } from './curated';
 import type { ResolvedPaletteSelection } from './resolveSelection';
-import type { PaletteCommand, SitePaletteId, SitePaletteVersion } from './selection';
+import type { PaletteCommand, PaletteSelection, SitePaletteId, SitePaletteVersion } from './selection';
 export type PalettePreview = Readonly<{
     kind: 'clean';
     resolved: ResolvedPaletteSelection;
@@ -10,7 +10,7 @@ export type PalettePreview = Readonly<{
     resolved: ResolvedPaletteSelection;
 }> | Readonly<{
     kind: 'edited-curated';
-    sourcePaletteId: CuratedPaletteId;
+    sourceValueKey: KnownCuratedPaletteValueKey;
     colors: PaletteColors;
     mode: PaletteMode;
 }> | Readonly<{
@@ -28,6 +28,35 @@ export type PaletteEditorState = Readonly<{
     committed: ResolvedPaletteSelection;
     preview: PalettePreview;
 }>;
+/**
+ * A complete palette projection for consumers which render a draft. Unlike a
+ * command, this is always enough to compile the preview without reaching back
+ * to a curated base plus a sparse overrides map.
+ */
+export type CompletePaletteEditorPreview = Readonly<{
+    kind: 'selected';
+    selection: PaletteSelection;
+    colors: PaletteColors;
+    mode: PaletteMode;
+    version: SitePaletteVersion | null;
+}> | Readonly<{
+    kind: 'edited-curated';
+    sourceValueKey: KnownCuratedPaletteValueKey;
+    colors: PaletteColors;
+    mode: PaletteMode;
+}> | Readonly<{
+    kind: 'edited-site';
+    selection: Extract<PaletteSelection, {
+        kind: 'site';
+    }>;
+    expectedVersion: SitePaletteVersion;
+    colors: PaletteColors;
+    mode: PaletteMode;
+}> | Readonly<{
+    kind: 'new-site';
+    colors: PaletteColors;
+    mode: PaletteMode;
+}>;
 export type PaletteEditorAction = Readonly<{
     kind: 'select';
     resolved: ResolvedPaletteSelection;
@@ -43,3 +72,4 @@ export type PaletteEditorAction = Readonly<{
 export declare function createPaletteEditorState(committed: ResolvedPaletteSelection): PaletteEditorState;
 export declare function reducePaletteEditorState(state: PaletteEditorState, action: PaletteEditorAction): PaletteEditorState;
 export declare function planPaletteCommand(state: PaletteEditorState): PaletteCommand;
+export declare function completePaletteEditorPreview(state: PaletteEditorState): CompletePaletteEditorPreview;

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

@@ -11,9 +11,6 @@ export * from './extractPalette';
 export * from './colors';
 export * from './editorState';
 export * from './libraryModel';
-export * from './legacySelection';
-export * from './legacyRuntimeProjection';
-export * from './paletteCompatibilityTransition';
 export * from './persistenceReadSource';
 export * from './resolveSelection';
 export * from './selection';

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

@@ -1,4 +1,4 @@
-import type { CuratedPalette, CuratedPaletteId } from './curated/types';
+import type { CuratedPalette, KnownCuratedPaletteValueKey } from './curated';
 import type { PaletteColors, PaletteMode } from './colors';
 import type { PaletteSelection, SitePalette, SitePaletteId, SitePaletteOrigin, SitePaletteVersion } from './selection';
 export type PaletteSwatch = readonly [
@@ -10,7 +10,7 @@ export type PaletteSwatch = readonly [
 ];
 export type CuratedPaletteLibraryItem = Readonly<{
     kind: 'curated';
-    paletteId: CuratedPaletteId;
+    valueKey: KnownCuratedPaletteValueKey;
     colors: PaletteColors;
     mode: PaletteMode;
     swatch: PaletteSwatch;
@@ -30,14 +30,20 @@ export type SitePaletteLibraryItem = Readonly<{
 }>;
 export type PaletteLibraryItem = CuratedPaletteLibraryItem | SitePaletteLibraryItem;
 export type PaletteLibraryReadModel = Readonly<{
-    activeSelection: PaletteSelection;
+    active: PaletteLibraryAuthority;
     yours: readonly SitePaletteLibraryItem[];
     suggested: readonly CuratedPaletteLibraryItem[];
     more: readonly CuratedPaletteLibraryItem[];
 }>;
+export type PaletteLibraryAuthority = Readonly<{
+    kind: 'available';
+    selection: PaletteSelection;
+}> | Readonly<{
+    kind: 'invalid';
+}>;
 export type PaletteLibraryReadModelError = Readonly<{
     kind: 'active-curated-palette-missing';
-    paletteId: CuratedPaletteId;
+    valueKey: KnownCuratedPaletteValueKey;
 }> | Readonly<{
     kind: 'active-site-palette-missing';
     paletteId: SitePaletteId;
@@ -50,9 +56,9 @@ export type PaletteLibraryReadModelResult = Readonly<{
     error: PaletteLibraryReadModelError;
 }>;
 export declare function buildPaletteLibraryReadModel(input: Readonly<{
-    activeSelection: PaletteSelection;
+    active: PaletteLibraryAuthority;
     sitePalettes: readonly SitePalette[];
     curatedPalettes: readonly CuratedPalette[];
-    recommendations: readonly CuratedPaletteId[];
+    recommendations: readonly KnownCuratedPaletteValueKey[];
 }>): PaletteLibraryReadModelResult;
 export declare function paletteSelectionForItem(item: PaletteLibraryItem): PaletteSelection;