@riverbankcms/sdk 0.104.1 → 0.104.3

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

@@ -11,14 +11,38 @@ export declare const gradientStopSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type GradientStop = z.infer<typeof gradientStopSchema>;
 /**
- * Gradient configuration
+ * Radial gradient shape. Optional; defaults to `circle` (the historical shape)
+ * so existing radial gradients are byte-identical.
+ *
+ * Named `RadialGradientShape` to avoid clashing with `styles/gradients.ts`'s
+ * `GradientShape` (which names the gradient *kind*: linear/radial/conic).
+ */
+export declare const radialGradientShapeSchema: z.ZodEnum<{
+    circle: "circle";
+    ellipse: "ellipse";
+}>;
+export type RadialGradientShape = z.infer<typeof radialGradientShapeSchema>;
+/**
+ * Gradient configuration.
+ *
+ * `type` is optional and defaults to `'linear'` so gradients persisted without a
+ * type (or with an explicit `'linear'`) render exactly as before. `'radial'` and
+ * `'conic'` are additive kinds:
+ *   - linear: `angle` (degrees)
+ *   - radial: optional `shape` (circle/ellipse) + `position`
+ *   - conic:  optional `angle` (from-angle, degrees) + `position`
  */
 export declare const gradientConfigSchema: z.ZodObject<{
-    type: z.ZodEnum<{
+    type: z.ZodDefault<z.ZodEnum<{
         linear: "linear";
         radial: "radial";
-    }>;
+        conic: "conic";
+    }>>;
     angle: z.ZodOptional<z.ZodNumber>;
+    shape: z.ZodOptional<z.ZodEnum<{
+        circle: "circle";
+        ellipse: "ellipse";
+    }>>;
     position: z.ZodOptional<z.ZodString>;
     stops: z.ZodArray<z.ZodObject<{
         color: z.ZodString;

package/dist/_dts/theme-core/src/mock-themes/all.d.ts

@@ -100,6 +100,9 @@ export declare const mockThemes: {
                     underlineThickness?: "auto" | "medium" | "fromFont" | "thin" | "thick" | undefined;
                     underlineOffset?: "auto" | "tight" | "normal" | "loose" | undefined;
                 } | undefined;
+                eyebrow?: {
+                    family: string;
+                } | undefined;
             };
             space: "standard" | "comfortable" | "dense";
             border: {
@@ -110,6 +113,7 @@ export declare const mockThemes: {
                 elevation: "medium" | "none" | "high" | "low";
                 softness: "crisp" | "soft" | "hard" | null;
                 position: "bottom" | "bottom-right";
+                colorToken?: string | undefined;
             };
             motion: {
                 level: "medium" | "high" | "low" | "off";
@@ -126,12 +130,13 @@ export declare const mockThemes: {
                     contentOwner?: "site-chrome-editor" | undefined;
                     color?: string | null | undefined;
                     gradient?: {
-                        type: "linear" | "radial";
+                        type: "linear" | "radial" | "conic";
                         stops: {
                             color: string;
                             position: number;
                         }[];
                         angle?: number | undefined;
+                        shape?: "circle" | "ellipse" | undefined;
                         position?: string | undefined;
                     } | null | undefined;
                     image?: {
@@ -215,6 +220,7 @@ export declare const mockThemes: {
                 navColor?: string | null | undefined;
                 navTypography?: "body" | "heading" | undefined;
                 navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+                navPlacement?: "center" | "end" | undefined;
                 container?: {
                     rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
                     border: boolean;
@@ -309,12 +315,13 @@ export declare const mockThemes: {
                     contentOwner?: "site-chrome-editor" | undefined;
                     color?: string | null | undefined;
                     gradient?: {
-                        type: "linear" | "radial";
+                        type: "linear" | "radial" | "conic";
                         stops: {
                             color: string;
                             position: number;
                         }[];
                         angle?: number | undefined;
+                        shape?: "circle" | "ellipse" | undefined;
                         position?: string | undefined;
                     } | null | undefined;
                     image?: {
@@ -399,7 +406,7 @@ export declare const mockThemes: {
                 } | undefined;
                 navLayout?: {
                     layout?: "inline" | "stack" | "inline-wrap" | undefined;
-                    align?: "center" | "start" | "end" | "space-between" | undefined;
+                    align?: "center" | "end" | "start" | "space-between" | undefined;
                     gapX?: "default" | "none" | "compact" | "spacious" | "tight" | "relaxed" | undefined;
                     gapY?: "default" | "none" | "compact" | "spacious" | "tight" | "relaxed" | undefined;
                     columns?: number | undefined;
@@ -410,7 +417,7 @@ export declare const mockThemes: {
                     placement?: "left" | "right" | "above" | "below" | undefined;
                     size?: "sm" | "md" | "lg" | "xl" | undefined;
                     maxHeight?: "sm" | "md" | "lg" | "xl" | undefined;
-                    align?: "center" | "start" | "end" | undefined;
+                    align?: "center" | "end" | "start" | undefined;
                 } | undefined;
                 bottomBar?: {
                     enabled?: boolean | undefined;
@@ -420,12 +427,13 @@ export declare const mockThemes: {
                         contentOwner?: "site-chrome-editor" | undefined;
                         color?: string | null | undefined;
                         gradient?: {
-                            type: "linear" | "radial";
+                            type: "linear" | "radial" | "conic";
                             stops: {
                                 color: string;
                                 position: number;
                             }[];
                             angle?: number | undefined;
+                            shape?: "circle" | "ellipse" | undefined;
                             position?: string | undefined;
                         } | null | undefined;
                         image?: {
@@ -603,6 +611,10 @@ export declare const mockThemes: {
                             fontSize?: string | undefined;
                         } | undefined;
                     } | undefined;
+                    affordance?: {
+                        iconId: string;
+                        colorToken?: string | undefined;
+                    } | undefined;
                 }[];
                 sizes?: {
                     sm: {
@@ -1148,6 +1160,9 @@ export declare const mockThemes: {
                     underlineThickness?: "auto" | "medium" | "fromFont" | "thin" | "thick" | undefined;
                     underlineOffset?: "auto" | "tight" | "normal" | "loose" | undefined;
                 } | undefined;
+                eyebrow?: {
+                    family: string;
+                } | undefined;
             };
             space: "standard" | "comfortable" | "dense";
             border: {
@@ -1158,6 +1173,7 @@ export declare const mockThemes: {
                 elevation: "medium" | "none" | "high" | "low";
                 softness: "crisp" | "soft" | "hard" | null;
                 position: "bottom" | "bottom-right";
+                colorToken?: string | undefined;
             };
             motion: {
                 level: "medium" | "high" | "low" | "off";
@@ -1174,12 +1190,13 @@ export declare const mockThemes: {
                     contentOwner?: "site-chrome-editor" | undefined;
                     color?: string | null | undefined;
                     gradient?: {
-                        type: "linear" | "radial";
+                        type: "linear" | "radial" | "conic";
                         stops: {
                             color: string;
                             position: number;
                         }[];
                         angle?: number | undefined;
+                        shape?: "circle" | "ellipse" | undefined;
                         position?: string | undefined;
                     } | null | undefined;
                     image?: {
@@ -1263,6 +1280,7 @@ export declare const mockThemes: {
                 navColor?: string | null | undefined;
                 navTypography?: "body" | "heading" | undefined;
                 navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+                navPlacement?: "center" | "end" | undefined;
                 container?: {
                     rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
                     border: boolean;
@@ -1357,12 +1375,13 @@ export declare const mockThemes: {
                     contentOwner?: "site-chrome-editor" | undefined;
                     color?: string | null | undefined;
                     gradient?: {
-                        type: "linear" | "radial";
+                        type: "linear" | "radial" | "conic";
                         stops: {
                             color: string;
                             position: number;
                         }[];
                         angle?: number | undefined;
+                        shape?: "circle" | "ellipse" | undefined;
                         position?: string | undefined;
                     } | null | undefined;
                     image?: {
@@ -1447,7 +1466,7 @@ export declare const mockThemes: {
                 } | undefined;
                 navLayout?: {
                     layout?: "inline" | "stack" | "inline-wrap" | undefined;
-                    align?: "center" | "start" | "end" | "space-between" | undefined;
+                    align?: "center" | "end" | "start" | "space-between" | undefined;
                     gapX?: "default" | "none" | "compact" | "spacious" | "tight" | "relaxed" | undefined;
                     gapY?: "default" | "none" | "compact" | "spacious" | "tight" | "relaxed" | undefined;
                     columns?: number | undefined;
@@ -1458,7 +1477,7 @@ export declare const mockThemes: {
                     placement?: "left" | "right" | "above" | "below" | undefined;
                     size?: "sm" | "md" | "lg" | "xl" | undefined;
                     maxHeight?: "sm" | "md" | "lg" | "xl" | undefined;
-                    align?: "center" | "start" | "end" | undefined;
+                    align?: "center" | "end" | "start" | undefined;
                 } | undefined;
                 bottomBar?: {
                     enabled?: boolean | undefined;
@@ -1468,12 +1487,13 @@ export declare const mockThemes: {
                         contentOwner?: "site-chrome-editor" | undefined;
                         color?: string | null | undefined;
                         gradient?: {
-                            type: "linear" | "radial";
+                            type: "linear" | "radial" | "conic";
                             stops: {
                                 color: string;
                                 position: number;
                             }[];
                             angle?: number | undefined;
+                            shape?: "circle" | "ellipse" | undefined;
                             position?: string | undefined;
                         } | null | undefined;
                         image?: {
@@ -1651,6 +1671,10 @@ export declare const mockThemes: {
                             fontSize?: string | undefined;
                         } | undefined;
                     } | undefined;
+                    affordance?: {
+                        iconId: string;
+                        colorToken?: string | undefined;
+                    } | undefined;
                 }[];
                 sizes?: {
                     sm: {
@@ -2196,6 +2220,9 @@ export declare const mockThemes: {
                     underlineThickness?: "auto" | "medium" | "fromFont" | "thin" | "thick" | undefined;
                     underlineOffset?: "auto" | "tight" | "normal" | "loose" | undefined;
                 } | undefined;
+                eyebrow?: {
+                    family: string;
+                } | undefined;
             };
             space: "standard" | "comfortable" | "dense";
             border: {
@@ -2206,6 +2233,7 @@ export declare const mockThemes: {
                 elevation: "medium" | "none" | "high" | "low";
                 softness: "crisp" | "soft" | "hard" | null;
                 position: "bottom" | "bottom-right";
+                colorToken?: string | undefined;
             };
             motion: {
                 level: "medium" | "high" | "low" | "off";
@@ -2222,12 +2250,13 @@ export declare const mockThemes: {
                     contentOwner?: "site-chrome-editor" | undefined;
                     color?: string | null | undefined;
                     gradient?: {
-                        type: "linear" | "radial";
+                        type: "linear" | "radial" | "conic";
                         stops: {
                             color: string;
                             position: number;
                         }[];
                         angle?: number | undefined;
+                        shape?: "circle" | "ellipse" | undefined;
                         position?: string | undefined;
                     } | null | undefined;
                     image?: {
@@ -2311,6 +2340,7 @@ export declare const mockThemes: {
                 navColor?: string | null | undefined;
                 navTypography?: "body" | "heading" | undefined;
                 navTextSize?: "base" | "sm" | "lg" | "xl" | "xs" | undefined;
+                navPlacement?: "center" | "end" | undefined;
                 container?: {
                     rounded: "none" | "sm" | "md" | "lg" | "xl" | "2xl";
                     border: boolean;
@@ -2405,12 +2435,13 @@ export declare const mockThemes: {
                     contentOwner?: "site-chrome-editor" | undefined;
                     color?: string | null | undefined;
                     gradient?: {
-                        type: "linear" | "radial";
+                        type: "linear" | "radial" | "conic";
                         stops: {
                             color: string;
                             position: number;
                         }[];
                         angle?: number | undefined;
+                        shape?: "circle" | "ellipse" | undefined;
                         position?: string | undefined;
                     } | null | undefined;
                     image?: {
@@ -2495,7 +2526,7 @@ export declare const mockThemes: {
                 } | undefined;
                 navLayout?: {
                     layout?: "inline" | "stack" | "inline-wrap" | undefined;
-                    align?: "center" | "start" | "end" | "space-between" | undefined;
+                    align?: "center" | "end" | "start" | "space-between" | undefined;
                     gapX?: "default" | "none" | "compact" | "spacious" | "tight" | "relaxed" | undefined;
                     gapY?: "default" | "none" | "compact" | "spacious" | "tight" | "relaxed" | undefined;
                     columns?: number | undefined;
@@ -2506,7 +2537,7 @@ export declare const mockThemes: {
                     placement?: "left" | "right" | "above" | "below" | undefined;
                     size?: "sm" | "md" | "lg" | "xl" | undefined;
                     maxHeight?: "sm" | "md" | "lg" | "xl" | undefined;
-                    align?: "center" | "start" | "end" | undefined;
+                    align?: "center" | "end" | "start" | undefined;
                 } | undefined;
                 bottomBar?: {
                     enabled?: boolean | undefined;
@@ -2516,12 +2547,13 @@ export declare const mockThemes: {
                         contentOwner?: "site-chrome-editor" | undefined;
                         color?: string | null | undefined;
                         gradient?: {
-                            type: "linear" | "radial";
+                            type: "linear" | "radial" | "conic";
                             stops: {
                                 color: string;
                                 position: number;
                             }[];
                             angle?: number | undefined;
+                            shape?: "circle" | "ellipse" | undefined;
                             position?: string | undefined;
                         } | null | undefined;
                         image?: {
@@ -2699,6 +2731,10 @@ export declare const mockThemes: {
                             fontSize?: string | undefined;
                         } | undefined;
                     } | undefined;
+                    affordance?: {
+                        iconId: string;
+                        colorToken?: string | undefined;
+                    } | undefined;
                 }[];
                 sizes?: {
                     sm: {

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

@@ -41,6 +41,19 @@ export declare const brandLedJewel: Readonly<{
     mode: import("../../../../blocks/src/index").PaletteMode;
     colors: import("../../../../blocks/src/index").PaletteColors;
 }>;
+export declare const brandLedSpruce: Readonly<{
+    id: import("../../../../blocks/src/index").CuratedPaletteId<"brand-led-spruce">;
+    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 brandLedBurgundyGold: Readonly<{
     id: import("../../../../blocks/src/index").CuratedPaletteId<"brand-led-burgundy-gold">;
     name: string;

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

@@ -60,6 +60,18 @@ export declare const curatedPalettes: readonly [Readonly<{
     }>>>;
     mode: import("../../../../blocks/src/index").PaletteMode;
     colors: import("../../../../blocks/src/index").PaletteColors;
+}>, Readonly<{
+    id: CuratedPaletteId<"brand-led-spruce">;
+    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;

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

@@ -0,0 +1,44 @@
+import { type PaletteColors, type PaletteMode } from './colors';
+import type { PaletteOverrides } from './curated';
+import type { ThemePaletteCompatibilityError } from './themePaletteCompatibility';
+export type HistoricalThemePaletteEvidence = HistoricalArrayThemePaletteEvidence<'current-complete-array'> | HistoricalArrayThemePaletteEvidence<'legacy-danger-array'> | HistoricalArrayThemePaletteEvidence<'legacy-seven-role-array'> | HistoricalArrayThemePaletteEvidence<'legacy-destructive-white-array'> | HistoricalObjectMapThemePaletteEvidence;
+type HistoricalArrayThemePaletteEvidence<Kind extends string> = Readonly<{
+    kind: Kind;
+    persistedColors: PaletteOverrides;
+    mode: Readonly<{
+        kind: 'explicit';
+        value: PaletteMode;
+    }>;
+}>;
+type HistoricalObjectMapThemePaletteEvidence = Readonly<{
+    kind: 'legacy-object-map';
+    persistedColors: PaletteOverrides;
+    mode: Readonly<{
+        kind: 'inferred';
+        value: PaletteMode;
+    }>;
+}>;
+export type HistoricalThemePaletteMaterialization = Readonly<{
+    colors: PaletteColors;
+    mode: PaletteMode;
+}>;
+export type ParseHistoricalThemePaletteEvidenceResult = Readonly<{
+    ok: true;
+    evidence: HistoricalThemePaletteEvidence;
+}> | Readonly<{
+    ok: false;
+    error: ThemePaletteCompatibilityError;
+}>;
+/**
+ * Parses only the five production historical palette layouts that the backfill
+ * knows how to complete. Other sparse shapes remain generic editor input and
+ * are intentionally not migration evidence.
+ */
+export declare function parseHistoricalThemePaletteEvidence(input: unknown): ParseHistoricalThemePaletteEvidenceResult;
+/**
+ * Deterministically reconstructs a complete palette from closed historical
+ * evidence. Persisted semantic roles are never replaced; only absent modern
+ * roles and seven-role status values use documented historical defaults.
+ */
+export declare function materializeHistoricalThemePalette(evidence: HistoricalThemePaletteEvidence, completionBase?: PaletteColors): HistoricalThemePaletteMaterialization;
+export {};

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

@@ -3,6 +3,7 @@ export * from './classifyColor';
 export * from './expandPalette';
 export * from './generateCssVars';
 export * from './generateShades';
+export * from './historicalThemePalette';
 export * from './neutralScale';
 export * from './types';
 export * from './utils';

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

@@ -1,8 +1,8 @@
-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';
+import { type HistoricalThemePaletteEvidence } from './historicalThemePalette';
 export type LegacyPaletteClassification = Readonly<{
     kind: 'curated';
     paletteId: CuratedPaletteId;
@@ -28,7 +28,18 @@ export type LegacyOnboardingPaletteEvidence = Readonly<{
 export declare function classifyLegacyPaletteSelection(input: Readonly<{
     basePalette: CuratedPalette | null;
     overrides: PaletteOverrides | null;
-    savedThemePalette: Theme['palette'] | null;
+    savedThemePalette: unknown;
+    fallbackPaletteId: CuratedPaletteId | null;
+    onboardingEvidence: LegacyOnboardingPaletteEvidence;
+}>): LegacyPaletteClassification;
+/**
+ * Migration-only classifier entry. The caller owns the unknown boundary and
+ * passes closed historical evidence, so saved palette JSON is parsed once.
+ */
+export declare function classifyLegacyPaletteSelectionFromHistoricalEvidence(input: Readonly<{
+    basePalette: CuratedPalette | null;
+    overrides: PaletteOverrides | null;
+    savedThemePalette: HistoricalThemePaletteEvidence | null;
     fallbackPaletteId: CuratedPaletteId | null;
     onboardingEvidence: LegacyOnboardingPaletteEvidence;
 }>): LegacyPaletteClassification;

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

@@ -1,7 +1,7 @@
 import { type CuratedPaletteId, type PaletteOverrides } from './curated';
-import type { Theme } from '../schema';
 import type { PaletteSelection } from './selection';
 import { type SitePalette } from './selection';
+import { type HistoricalThemePaletteEvidence } from './historicalThemePalette';
 import { resolvedCuratedPaletteSelection, resolvedSitePaletteSelection, type ResolvedPaletteSelection } from './resolveSelection';
 import type { SitePaletteParseError } from './sitePalettePersistence';
 export type PalettePersistenceReadSource = Readonly<{
@@ -101,9 +101,24 @@ export type RuntimePaletteResolution = Readonly<{
 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: Theme['palette'];
+    savedThemePalette?: unknown;
     activeSitePaletteAuthority: ActiveSitePaletteAuthority;
 }>): RuntimePaletteState;
 /**

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

@@ -4,7 +4,7 @@ import type { PaletteOverrides } from './curated';
 /**
  * The persisted Theme palette boundary. It deliberately stays narrower than
  * the full Theme schema so consumers do not need to depend on another package
- * just to interpret old sparse palette entries.
+ * just to interpret current sparse palette entries.
  */
 export type ThemePaletteCompatibilityInput = Readonly<{
     palette?: Readonly<{
@@ -51,8 +51,7 @@ export type ParseCompatibleThemePaletteResult = Readonly<{
     error: ThemePaletteCompatibilityError;
 }>;
 /**
- * Parses both current complete Theme palettes and historical sparse palettes.
- * Sparse entries remain sparse so callers can overlay them onto their own
- * authoritative base without silently changing the persisted Theme shape.
+ * Parses current complete Theme palettes and sparse editor payloads. Historical
+ * migration-only completion lives in historicalThemePalette.ts.
  */
 export declare function parseCompatibleThemePalette(theme: ThemePaletteCompatibilityInput): ParseCompatibleThemePaletteResult;

package/dist/_dts/theme-core/src/runtime/themeCssVarNames.d.ts

@@ -2,6 +2,7 @@ export declare const THEME_RADIUS_CSS_VARS: {
     readonly block: "--rb-block-radius";
     readonly button: "--rb-button-radius";
     readonly input: "--rb-input-radius";
+    readonly panel: "--rb-panel-radius";
     readonly legacyCard: "--radius-card";
     readonly legacyControl: "--radius-control";
 };