@riverbankcms/sdk 0.104.3 → 0.108.0

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

@@ -1,28 +1,11 @@
-import { type CuratedPaletteId, type PaletteOverrides } from './curated';
-import type { PaletteSelection } from './selection';
-import { type SitePalette } from './selection';
-import { type HistoricalThemePaletteEvidence } from './historicalThemePalette';
+import { type PaletteValueKey } from './curated';
 import { resolvedCuratedPaletteSelection, resolvedSitePaletteSelection, type ResolvedPaletteSelection } from './resolveSelection';
+import { type PaletteSelection, type SitePalette } from './selection';
 import type { SitePaletteParseError } from './sitePalettePersistence';
-export type PalettePersistenceReadSource = Readonly<{
-    kind: 'new-selection';
-    selection: PaletteSelection;
-}> | Readonly<{
-    kind: 'legacy-selection';
-    paletteVariant: LegacyPaletteVariantEvidence;
-    paletteOverrides: PaletteOverrides | null;
-}>;
-/** Legacy catalog IDs are migration evidence, not authoritative references. */
-export type LegacyPaletteVariantEvidence = Readonly<{
-    kind: 'known';
-    paletteId: CuratedPaletteId;
-}> | Readonly<{
-    kind: 'unknown';
-    value: string;
+/** The post-backfill product boundary: exactly one active reference is required. */
+export type AuthoritativePaletteSelectionParseError = Readonly<{
+    kind: 'missing-active-palette-reference';
 }> | Readonly<{
-    kind: 'missing';
-}>;
-export type PalettePersistenceReadError = Readonly<{
     kind: 'dual-active-reference';
 }> | Readonly<{
     kind: 'unknown-active-curated-palette';
@@ -30,21 +13,19 @@ export type PalettePersistenceReadError = Readonly<{
 }> | Readonly<{
     kind: 'invalid-active-site-palette-id';
     value: string;
-}> | Readonly<{
-    kind: 'invalid-legacy-overrides';
 }>;
-export type PalettePersistenceReadResult = Readonly<{
+export type AuthoritativePaletteSelectionParseResult = Readonly<{
     ok: true;
-    source: PalettePersistenceReadSource;
+    selection: PaletteSelection;
 }> | Readonly<{
     ok: false;
-    error: PalettePersistenceReadError;
+    error: AuthoritativePaletteSelectionParseError;
 }>;
-/**
- * Transport state remains flat for existing runtime consumers. Its migrated
- * variants are nevertheless correlated: `authority`, selection, and version
- * cannot describe independent sources of truth.
- */
+export declare function parseAuthoritativePaletteSelection(input: Readonly<{
+    activePaletteValueKey: string | null;
+    activeSitePaletteId: string | null;
+}>): AuthoritativePaletteSelectionParseResult;
+/** Runtime state is authority-backed or explicitly invalid; legacy is migration-only. */
 export type RuntimePaletteState = Readonly<{
     kind: 'migrated';
     authority: 'curated';
@@ -63,14 +44,11 @@ export type RuntimePaletteState = Readonly<{
     colors: ReturnType<typeof resolvedSitePaletteSelection>['colors'];
     mode: ReturnType<typeof resolvedSitePaletteSelection>['mode'];
     sitePaletteVersion: ReturnType<typeof resolvedSitePaletteSelection>['version'];
-}> | Readonly<{
-    kind: 'legacy-unmigrated';
-    colors: ResolvedPaletteSelection['colors'];
-    mode: ResolvedPaletteSelection['mode'];
 }> | Readonly<{
     kind: 'invalid';
-    reason: PalettePersistenceReadError['kind'] | 'invalid-saved-theme-palette' | 'active-site-palette-missing' | 'invalid-active-site-palette' | 'active-site-palette-mismatch' | 'active-curated-palette-missing';
+    reason: AuthoritativePaletteSelectionParseError['kind'] | 'invalid-saved-theme-palette' | 'active-site-palette-missing' | 'invalid-active-site-palette' | 'active-site-palette-mismatch' | 'active-curated-palette-missing';
 }>;
+export type AuthoritativeRuntimePaletteState = RuntimePaletteState;
 export type ActiveSitePaletteAuthority = Readonly<{
     kind: 'missing';
 }> | Readonly<{
@@ -82,10 +60,10 @@ export type ActiveSitePaletteAuthority = Readonly<{
 }>;
 export type RuntimePaletteResolutionError = Readonly<{
     kind: 'runtime-curated-palette-missing';
-    paletteId: CuratedPaletteId;
+    paletteId: PaletteValueKey;
 }> | Readonly<{
     kind: 'runtime-curated-palette-mismatch';
-    paletteId: CuratedPaletteId;
+    paletteId: PaletteValueKey;
 }>;
 export type RuntimePaletteResolution = Readonly<{
     ok: true;
@@ -94,40 +72,10 @@ export type RuntimePaletteResolution = Readonly<{
     ok: false;
     error: RuntimePaletteResolutionError;
 }>;
-/**
- * Rehydrates a runtime transport payload through the core-owned constructors.
- * It is intentionally checked, and replaces the old unsafe brand cast bridge.
- */
 export declare function resolveMigratedRuntimePaletteState(state: Extract<RuntimePaletteState, {
     kind: 'migrated';
 }>): RuntimePaletteResolution;
-export type RuntimePaletteStateFromHistoricalEvidenceInput = Readonly<{
-    parsed: PalettePersistenceReadResult;
-    savedThemePalette: HistoricalThemePaletteEvidence | null;
-    activeSitePaletteAuthority: ActiveSitePaletteAuthority;
-}>;
-/**
- * Uses already-parsed historical evidence for the legacy branch. Migrated
- * authority never reads saved Theme data, so callers can omit it entirely by
- * passing null.
- */
-export declare function runtimePaletteStateFromHistoricalEvidence(input: RuntimePaletteStateFromHistoricalEvidenceInput): RuntimePaletteState;
-/**
- * Raw persistence boundary for existing runtime callers. It parses saved Theme
- * palette JSON only for legacy selections, then delegates to the typed entry.
- */
-export declare function runtimePaletteStateFromPersisted(input: Readonly<{
-    parsed: PalettePersistenceReadResult;
-    savedThemePalette?: unknown;
+export declare function runtimePaletteStateFromAuthoritativeSelection(input: Readonly<{
+    selection: PaletteSelection;
     activeSitePaletteAuthority: ActiveSitePaletteAuthority;
-}>): RuntimePaletteState;
-/**
- * Bounded rollout adapter. New active references are authoritative whenever
- * present; legacy fields are parsed only while both references are absent.
- */
-export declare function parsePalettePersistenceReadSource(input: Readonly<{
-    activeCuratedPaletteId: string | null;
-    activeSitePaletteId: string | null;
-    legacyPaletteVariantId: string | null;
-    legacyPaletteOverrides: unknown;
-}>): PalettePersistenceReadResult;
+}>): AuthoritativeRuntimePaletteState;

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

@@ -1,5 +1,5 @@
-import type { PaletteColors, PaletteMode } from './colors';
-import { type CuratedPalette, type CuratedPaletteId } from './curated';
+import type { PaletteColors, PaletteMode, PaletteValueKey } from './colors';
+import { type CuratedPalette } from './curated';
 import type { PaletteSelection, SitePalette, SitePaletteId } from './selection';
 declare const resolvedPaletteSelectionBrand: unique symbol;
 export type ResolvedCuratedPaletteSelection = Readonly<{
@@ -22,9 +22,23 @@ export type ResolvedSitePaletteSelection = Readonly<{
     [resolvedPaletteSelectionBrand]: true;
 }>;
 export type ResolvedPaletteSelection = ResolvedCuratedPaletteSelection | ResolvedSitePaletteSelection;
+/**
+ * A complete palette that exists only in an editor preview. It deliberately
+ * has no persisted selection: a new palette must not pretend to be the first
+ * curated recommendation merely to satisfy a renderer.
+ */
+export type ResolvedDraftPaletteSelection = Readonly<{
+    kind: 'draft';
+    selection: null;
+    colors: PaletteColors;
+    mode: PaletteMode;
+    [resolvedPaletteSelectionBrand]: true;
+}>;
+/** A persisted palette selection or a complete, unsaved editor draft. */
+export type CompleteResolvedPaletteSelection = ResolvedPaletteSelection | ResolvedDraftPaletteSelection;
 export type PaletteSelectionResolutionError = Readonly<{
     kind: 'curated-palette-not-found';
-    paletteId: CuratedPaletteId;
+    valueKey: PaletteValueKey;
 }> | Readonly<{
     kind: 'site-palette-not-found';
     paletteId: SitePaletteId;
@@ -39,6 +53,17 @@ export type PaletteSelectionResolution = Readonly<{
 /** Core-owned constructors keep the resolved marker out of application code. */
 export declare function resolvedCuratedPaletteSelection(palette: CuratedPalette): ResolvedCuratedPaletteSelection;
 export declare function resolvedSitePaletteSelection(palette: SitePalette): ResolvedSitePaletteSelection;
+/** Builds a resolved site-owned preview from the record fields it owns. */
+export declare function resolvedSitePaletteSelectionFromPreview(input: Readonly<{
+    paletteId: SitePalette['id'];
+    colors: PaletteColors;
+    mode: PaletteMode;
+    version: SitePalette['version'];
+}>): ResolvedSitePaletteSelection;
+export declare function resolvedDraftPaletteSelection(input: Readonly<{
+    colors: PaletteColors;
+    mode: PaletteMode;
+}>): ResolvedDraftPaletteSelection;
 /** Resolves a persisted selection against the records that actually own it. */
 export declare function resolvePaletteSelection(input: Readonly<{
     selection: PaletteSelection;
@@ -46,5 +71,5 @@ export declare function resolvePaletteSelection(input: Readonly<{
     sitePalettes: readonly SitePalette[];
 }>): PaletteSelectionResolution;
 /** Resolves catalog authority without asking callers to manufacture a brand. */
-export declare function resolveCuratedPaletteSelection(paletteId: CuratedPaletteId): PaletteSelectionResolution;
+export declare function resolveCuratedPaletteSelection(valueKey: PaletteValueKey): PaletteSelectionResolution;
 export {};

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { type CuratedPaletteId } from './curated/types';
+import { type PaletteValueKey } from './colors';
+import { type KnownCuratedPaletteValueKey } from './curated';
 import { type PaletteColors, type PaletteMode } from './colors';
 export type SitePaletteId = string & {
     readonly __brand: 'SitePaletteId';
@@ -13,7 +14,7 @@ export declare function parseSitePaletteId(value: unknown): SitePaletteId | null
 export declare function parseSitePaletteVersion(value: unknown): SitePaletteVersion | null;
 export type PaletteSelection = Readonly<{
     kind: 'curated';
-    paletteId: CuratedPaletteId;
+    valueKey: KnownCuratedPaletteValueKey;
 }> | Readonly<{
     kind: 'site';
     paletteId: SitePaletteId;
@@ -24,7 +25,7 @@ export type SitePaletteOrigin = Readonly<{
     sourceKey: string | null;
 }> | Readonly<{
     kind: 'curated-fork';
-    sourcePaletteId: CuratedPaletteId;
+    sourceValueKey: PaletteValueKey;
 }> | Readonly<{
     kind: 'manual';
 }> | Readonly<{
@@ -32,8 +33,9 @@ export type SitePaletteOrigin = Readonly<{
     sourceKey: string | null;
 }>;
 export declare const sitePaletteOriginSchema: z.ZodType<SitePaletteOrigin>;
-export type EditorSitePaletteOrigin = Extract<SitePaletteOrigin, {
+export type EditorSitePaletteOrigin = Readonly<{
     kind: 'curated-fork';
+    sourceValueKey: KnownCuratedPaletteValueKey;
 }> | Extract<SitePaletteOrigin, {
     kind: 'manual';
 }>;