@riverbankcms/sdk 0.102.0 → 0.104.0

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,48 +1,31 @@
 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';
-};
-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';
+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 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<{
         tone: z.ZodOptional<z.ZodEnum<{
-            classic: "classic";
             bold: "bold";
             minimal: "minimal";
+            classic: "classic";
         }>>;
         energy: z.ZodOptional<z.ZodEnum<{
             calm: "calm";
@@ -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";
-            accent: "accent";
-            primary: "primary";
-            secondary: "secondary";
-            warning: "warning";
-            background: "background";
-            muted: "muted";
-            border: "border";
-            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>>>;
@@ -118,7 +108,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<"surface" | "success" | "text" | "accent" | "primary" | "secondary" | "warning" | "background" | "muted" | "border" | "destructive" | "surfaceAlt" | "primaryForeground", HexColor>>>, {
+}, z.core.$strict>, z.ZodTransform<Readonly<Partial<Record<"surface" | "success" | "text" | "warning" | "background" | "accent" | "muted" | "border" | "primary" | "secondary" | "destructive" | "surfaceAlt" | "primaryForeground", HexColor>>>, {
     primary?: HexColor | undefined;
     primaryForeground?: HexColor | undefined;
     secondary?: HexColor | undefined;

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

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

@@ -3,7 +3,7 @@
  * Warm Editorial, Modern Wellness, Calm Studio site styles.
  */
 export declare const warmNeutralClay: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"warm-neutral-clay">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-neutral-clay">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -12,14 +12,11 @@ export declare const warmNeutralClay: 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 warmNeutralCream: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"warm-neutral-cream">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-neutral-cream">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -28,14 +25,11 @@ export declare const warmNeutralCream: 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 warmNeutralSoftEarth: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"warm-neutral-soft-earth">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-neutral-soft-earth">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -44,14 +38,11 @@ export declare const warmNeutralSoftEarth: 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 warmNeutralForest: Readonly<{
-    id: import("../../../../blocks/src/index").PaletteVariantId<"warm-neutral-forest">;
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"warm-neutral-forest">;
     name: string;
     description: string;
     tags: Readonly<Partial<Readonly<{
@@ -60,9 +51,6 @@ export declare const warmNeutralForest: 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/editorState.d.ts

@@ -0,0 +1,45 @@
+import type { PaletteColors, PaletteMode } from './colors';
+import type { CuratedPaletteId } from './curated/types';
+import type { ResolvedPaletteSelection } from './resolveSelection';
+import type { PaletteCommand, SitePaletteId, SitePaletteVersion } from './selection';
+export type PalettePreview = Readonly<{
+    kind: 'clean';
+    resolved: ResolvedPaletteSelection;
+}> | Readonly<{
+    kind: 'selected';
+    resolved: ResolvedPaletteSelection;
+}> | Readonly<{
+    kind: 'edited-curated';
+    sourcePaletteId: CuratedPaletteId;
+    colors: PaletteColors;
+    mode: PaletteMode;
+}> | Readonly<{
+    kind: 'edited-site';
+    paletteId: SitePaletteId;
+    expectedVersion: SitePaletteVersion;
+    colors: PaletteColors;
+    mode: PaletteMode;
+}> | Readonly<{
+    kind: 'new-site';
+    colors: PaletteColors;
+    mode: PaletteMode;
+}>;
+export type PaletteEditorState = Readonly<{
+    committed: ResolvedPaletteSelection;
+    preview: PalettePreview;
+}>;
+export type PaletteEditorAction = Readonly<{
+    kind: 'select';
+    resolved: ResolvedPaletteSelection;
+}> | Readonly<{
+    kind: 'edit';
+    colors: PaletteColors;
+    mode: PaletteMode;
+}> | Readonly<{
+    kind: 'create';
+}> | Readonly<{
+    kind: 'cancel';
+}>;
+export declare function createPaletteEditorState(committed: ResolvedPaletteSelection): PaletteEditorState;
+export declare function reducePaletteEditorState(state: PaletteEditorState, action: PaletteEditorAction): PaletteEditorState;
+export declare function planPaletteCommand(state: PaletteEditorState): PaletteCommand;

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

@@ -1,14 +1,25 @@
-export * from "../mock-themes/all";
-export * from "./classifyColor";
-export * from "./expandPalette";
-export * from "./generateCssVars";
-export * from "./generateShades";
-export * from "./neutralScale";
-export * from "./types";
-export * from "./utils";
-export * from "./utils/paletteAccess";
-export * from "./extractPalette";
-export * from "./utils/fromVibrant";
-export * from "./utils/suggestRecipes";
-export * from "./recipes/allRecipes";
-export * from "./variants";
+export * from '../mock-themes/all';
+export * from './classifyColor';
+export * from './expandPalette';
+export * from './generateCssVars';
+export * from './generateShades';
+export * from './neutralScale';
+export * from './types';
+export * from './utils';
+export * from './utils/paletteAccess';
+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';
+export * from './sitePalettePersistence';
+export * from './themePaletteCompatibility';
+export * from './utils/fromVibrant';
+export * from './utils/suggestRecipes';
+export * from './recipes/allRecipes';
+export * from './curated';

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

@@ -0,0 +1,38 @@
+import type { CuratedPaletteId, PaletteOverrides } from './curated';
+import type { PaletteColors, PaletteMode } from './colors';
+import type { PalettePersistenceReadResult, RuntimePaletteState } from './persistenceReadSource';
+import type { PaletteCompatibilityState } from './paletteCompatibilityTransition';
+import type { PaletteSelection } from './selection';
+export type LegacyPaletteResponseProjection = Readonly<{
+    paletteVariantId: CuratedPaletteId | null;
+    paletteOverrides: PaletteOverrides | null;
+}>;
+type ResolvedPaletteForLegacyProjection = Readonly<{
+    selection: PaletteSelection;
+    colors: PaletteColors;
+    mode: PaletteMode;
+}>;
+/**
+ * Projects a resolved authoritative selection to the bounded legacy
+ * curated-plus-overrides wire shape. Site palettes retain their complete
+ * colours, using a stable curated palette in the same mode as the base.
+ */
+export declare function projectResolvedPaletteForLegacyResponse(input: ResolvedPaletteForLegacyProjection & Readonly<{
+    preferredCuratedPaletteId?: CuratedPaletteId | null;
+}>): LegacyPaletteResponseProjection;
+/**
+ * One-way egress adapter for stale clients. It accepts canonical compatibility
+ * state only; its lossy curated-plus-overrides response is never a transition
+ * input.
+ */
+export declare function projectPaletteCompatibilityStateForLegacyResponse(state: PaletteCompatibilityState, preferredCuratedPaletteId?: CuratedPaletteId | null): LegacyPaletteResponseProjection;
+/**
+ * Projects runtime state without letting stale legacy columns override an
+ * explicit new authority. Unmigrated rows preserve their validated legacy
+ * identity so mixed-version clients do not receive an unnecessary rewrite.
+ */
+export declare function projectRuntimePaletteStateForLegacyResponse(input: Readonly<{
+    runtimePaletteState: RuntimePaletteState | null;
+    persistenceRead: PalettePersistenceReadResult | null;
+}>): LegacyPaletteResponseProjection;
+export {};

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

@@ -0,0 +1,34 @@
+import type { Theme } from '../schema';
+import { type PaletteTokenName } from '../tokens/themeColorTokens';
+import { type HexColor, type PaletteColors, type PaletteMode } from './colors';
+import type { CuratedPalette, CuratedPaletteId, PaletteOverrides } from './curated/types';
+import type { SitePaletteOrigin } from './selection';
+export type LegacyPaletteClassification = Readonly<{
+    kind: 'curated';
+    paletteId: CuratedPaletteId;
+}> | Readonly<{
+    kind: 'site';
+    colors: PaletteColors;
+    mode: PaletteMode;
+    origin: Extract<SitePaletteOrigin, {
+        kind: 'onboarding' | 'legacy-customized';
+    }>;
+}> | Readonly<{
+    kind: 'defaulted-curated';
+    paletteId: CuratedPaletteId;
+    reason: 'no-valid-legacy-palette';
+}> | Readonly<{
+    kind: 'unresolved';
+    reason: 'missing-palette-sources' | 'invalid-saved-theme-palette' | 'overrides-without-base-palette';
+}>;
+export type LegacyOnboardingPaletteEvidence = Readonly<{
+    sourceKey: string | null;
+    candidateColors: Readonly<Partial<Record<PaletteTokenName, HexColor>>> | null;
+}>;
+export declare function classifyLegacyPaletteSelection(input: Readonly<{
+    basePalette: CuratedPalette | null;
+    overrides: PaletteOverrides | null;
+    savedThemePalette: Theme['palette'] | null;
+    fallbackPaletteId: CuratedPaletteId | null;
+    onboardingEvidence: LegacyOnboardingPaletteEvidence;
+}>): LegacyPaletteClassification;

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

@@ -0,0 +1,58 @@
+import type { CuratedPalette, CuratedPaletteId } from './curated/types';
+import type { PaletteColors, PaletteMode } from './colors';
+import type { PaletteSelection, SitePalette, SitePaletteId, SitePaletteOrigin, SitePaletteVersion } from './selection';
+export type PaletteSwatch = readonly [
+    PaletteColors['background'],
+    PaletteColors['surface'],
+    PaletteColors['primary'],
+    PaletteColors['secondary'],
+    PaletteColors['accent']
+];
+export type CuratedPaletteLibraryItem = Readonly<{
+    kind: 'curated';
+    paletteId: CuratedPaletteId;
+    colors: PaletteColors;
+    mode: PaletteMode;
+    swatch: PaletteSwatch;
+    accessibleLabel: string;
+    selected: boolean;
+}>;
+export type SitePaletteLibraryItem = Readonly<{
+    kind: 'site';
+    paletteId: SitePaletteId;
+    colors: PaletteColors;
+    mode: PaletteMode;
+    origin: SitePaletteOrigin;
+    version: SitePaletteVersion;
+    swatch: PaletteSwatch;
+    accessibleLabel: string;
+    selected: boolean;
+}>;
+export type PaletteLibraryItem = CuratedPaletteLibraryItem | SitePaletteLibraryItem;
+export type PaletteLibraryReadModel = Readonly<{
+    activeSelection: PaletteSelection;
+    yours: readonly SitePaletteLibraryItem[];
+    suggested: readonly CuratedPaletteLibraryItem[];
+    more: readonly CuratedPaletteLibraryItem[];
+}>;
+export type PaletteLibraryReadModelError = Readonly<{
+    kind: 'active-curated-palette-missing';
+    paletteId: CuratedPaletteId;
+}> | Readonly<{
+    kind: 'active-site-palette-missing';
+    paletteId: SitePaletteId;
+}>;
+export type PaletteLibraryReadModelResult = Readonly<{
+    ok: true;
+    model: PaletteLibraryReadModel;
+}> | Readonly<{
+    ok: false;
+    error: PaletteLibraryReadModelError;
+}>;
+export declare function buildPaletteLibraryReadModel(input: Readonly<{
+    activeSelection: PaletteSelection;
+    sitePalettes: readonly SitePalette[];
+    curatedPalettes: readonly CuratedPalette[];
+    recommendations: readonly CuratedPaletteId[];
+}>): PaletteLibraryReadModelResult;
+export declare function paletteSelectionForItem(item: PaletteLibraryItem): PaletteSelection;