@riverbankcms/sdk 0.130.0 → 0.132.0

package/dist/_dts/theme-core/src/header/legacyHeaderVariant.d.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+/**
+ * The header variants the system actually renders.
+ *
+ * Each one has a layout row in the site-header block and a paint target in
+ * `paintTargets.ts`. This is the canonical list: the block transform's variant
+ * class allowlist and the AI theme generator's enum both derive from it, so
+ * they cannot drift.
+ */
+export declare const headerVariantValues: readonly ["classic", "centered", "floating"];
+export declare const headerVariantSchema: z.ZodEnum<{
+    classic: "classic";
+    centered: "centered";
+    floating: "floating";
+}>;
+export type HeaderVariant = z.infer<typeof headerVariantSchema>;
+/**
+ * Header variant spellings that were once authorable but no longer name a
+ * layout of their own, and the variant they read as now.
+ *
+ * `transparent` was an overlay header with no CSS of its own: everything it
+ * did (transparent root background, overlay content flow) is what `floating`
+ * already does, and it had zero persisted usage in production or locally when
+ * it was retired. It survives here as a one-boundary alias so a theme authored
+ * against the old vocabulary still parses.
+ *
+ * This matters because the theme schema is strict and has no per-field
+ * `.catch()`: an out-of-enum variant fails `themeSchema.safeParse` for the
+ * *whole* theme, which silently swaps the site's theme for
+ * `modernMinimalTheme`. Aliasing here keeps that from happening.
+ */
+export declare const legacyHeaderVariants: {
+    readonly transparent: "floating";
+};
+export type LegacyHeaderVariantValue = keyof typeof legacyHeaderVariants;
+/**
+ * The header variant boundary for themes that go through `themeSchema`:
+ * canonical variants pass through, legacy spellings normalize to the variant
+ * they meant, everything else fails the parse.
+ *
+ * Deliberately an enum plus a transform rather than a `z.preprocess`, so the
+ * schema's *input* type stays an accurate union (the legacy spelling is still
+ * accepted on the wire) instead of widening to `unknown`. `SdkThemeWire` in
+ * `@riverbankcms/api` is `z.input<typeof themeSchema>`, so a widened input here
+ * would leak straight into a public type.
+ *
+ * Not every read of a persisted theme goes through the schema:
+ * `resolveRuntimeTheme` in
+ * `apps/dashboard/src/server/services/sites/runtimeSiteResponse.ts` returns the
+ * raw database JSON asserted as `Theme` with no parse, so a theme still
+ * carrying a legacy spelling reaches the theme editor un-aliased. That gap
+ * predates this alias and is harmless while persisted usage is zero.
+ */
+export declare const headerVariantWithLegacyAliasSchema: z.ZodPipe<z.ZodEnum<{
+    classic: "classic";
+    centered: "centered";
+    floating: "floating";
+    transparent: "transparent";
+}>, z.ZodTransform<"classic" | "centered" | "floating", "classic" | "centered" | "floating" | "transparent">>;

package/dist/_dts/theme-core/src/header/paintTargets.d.ts

@@ -1,4 +1,4 @@
-type HeaderLayoutVariant = 'classic' | 'centered' | 'transparent' | 'floating';
+import type { HeaderVariant } from './legacyHeaderVariant';
 type ElementBoxPaintTarget = Readonly<{
     kind: 'element-box';
     selector: string;
@@ -26,6 +26,6 @@ type ViewportBandPaintTarget = Readonly<{
 }>;
 export type HeaderPaintTarget = ElementBoxPaintTarget | ViewportBandPaintTarget;
 /** Resolve the element that owns the visible header surface for each layout. */
-export declare function getHeaderPaintTargets(variant: HeaderLayoutVariant, themeId: string, state?: 'base' | 'scrolled'): readonly HeaderPaintTarget[];
+export declare function getHeaderPaintTargets(variant: HeaderVariant, themeId: string, state?: 'base' | 'scrolled'): readonly HeaderPaintTarget[];
 export declare function renderHeaderPaintTargetRules(targets: readonly HeaderPaintTarget[], rules: readonly string[]): string;
 export {};

package/dist/_dts/theme-core/src/header/scrollTreatment.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import type { HeaderVariant } from './legacyHeaderVariant';
 export declare const headerScrollTreatmentSchema: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"contrast-glass">;
     backgroundTone: z.ZodEnum<{
@@ -7,5 +8,5 @@ export declare const headerScrollTreatmentSchema: z.ZodOptional<z.ZodDiscriminat
     }>;
 }, z.core.$strip>], "kind">>;
 export type HeaderScrollTreatment = z.infer<typeof headerScrollTreatmentSchema>;
-export declare function generateMobileOverlayBackdropFilterFix(themeId: string, variant: 'classic' | 'centered' | 'transparent' | 'floating'): string;
-export declare function generateHeaderScrollTreatmentStyles(treatment: HeaderScrollTreatment, themeId: string, variant: 'classic' | 'centered' | 'transparent' | 'floating', surfaceRules?: readonly string[]): string;
+export declare function generateMobileOverlayBackdropFilterFix(themeId: string, variant: HeaderVariant): string;
+export declare function generateHeaderScrollTreatmentStyles(treatment: HeaderScrollTreatment, themeId: string, variant: HeaderVariant, surfaceRules?: readonly string[]): string;

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

@@ -120,12 +120,12 @@ export declare const mockThemes: {
                 colorToken?: string | undefined;
             };
             motion: {
-                level: "medium" | "high" | "low" | "off";
+                level: "medium" | "off" | "high" | "low";
                 easing: "standard" | "snappy" | "gentle" | null;
             };
             corners: "soft" | "square" | "rounded" | "pill";
             header: {
-                variant: "classic" | "centered" | "transparent" | "floating";
+                variant: "classic" | "centered" | "floating";
                 positioning: "fixed" | "static" | "sticky";
                 shrinkOnScroll: boolean;
                 maxWidth: "full" | "container";
@@ -1501,6 +1501,12 @@ export declare const mockThemes: {
                         widthClass: string;
                     } | undefined;
                     hoverBackgroundToken?: import("../buttons").OpaqueButtonColourToken | undefined;
+                    contextualHover?: {
+                        kind: "shade-shift";
+                        seedToken: import("../buttons").OpaqueButtonColourToken;
+                        fallbackDirection: "lighter" | "darker";
+                        preferredToken?: import("../buttons").OpaqueButtonColourToken | undefined;
+                    } | undefined;
                     effects?: {
                         base?: ({
                             effectId: "darken-background";
@@ -1864,48 +1870,7 @@ export declare const mockThemes: {
                     })[];
                 } | undefined;
             } | undefined;
-            cards?: {
-                variants: {
-                    id: string;
-                    name: string;
-                    enabled: boolean;
-                    priority: 1 | 3 | 2;
-                    background: {
-                        type: "solid";
-                        colorToken: string;
-                    } | {
-                        type: "gradient";
-                        fromToken: string;
-                        toToken: string;
-                        direction: "to-r" | "to-l" | "to-t" | "to-b" | "to-tr" | "to-tl" | "to-br" | "to-bl";
-                    } | {
-                        type: "transparent";
-                    };
-                    spacing: "medium" | "none" | "compact" | "comfortable" | "spacious" | "cozy";
-                    foregroundToken?: string | undefined;
-                    shadow?: {
-                        elevation: "medium" | "none" | "high" | "low";
-                        softness: "crisp" | "soft" | "hard" | null;
-                        position: "bottom" | "bottom-right";
-                    } | undefined;
-                    corners?: "soft" | "square" | "rounded" | "pill" | undefined;
-                    cornerRadii?: {
-                        topLeft?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                        topRight?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                        bottomLeft?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                        bottomRight?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                    } | undefined;
-                    border?: {
-                        widthClass: string;
-                        colorToken: string;
-                    } | undefined;
-                    accentEdge?: {
-                        edge: "left" | "right" | "bottom" | "top";
-                        colorToken: string;
-                        width: "medium" | "thin" | "thick" | "heavy";
-                    } | undefined;
-                }[];
-            } | undefined;
+            cards?: import("../../../blocks/src/index").CardSystem | undefined;
             accordions?: {
                 background: {
                     type: "solid";
@@ -2527,8 +2492,7 @@ export declare const mockThemes: {
                         spacing?: "medium" | "none" | "compact" | "comfortable" | "spacious" | "cozy" | null | undefined;
                         raised?: boolean | null | undefined;
                         rounded?: "full" | "none" | "sm" | "md" | "lg" | "xl" | "2xl" | null | undefined;
-                        treatment?: "accent-quote" | "editorial-rule" | "soft-panel" | "editorial-serif-quote" | "editorial-open" | "color-blocked" | null | undefined;
-                        cardVariant?: "default" | "none" | "alternative" | null | undefined;
+                        role?: "open" | "default" | "none" | "alternative" | null | undefined;
                     } | null | undefined;
                 } | undefined;
             }> | undefined;
@@ -2706,12 +2670,12 @@ export declare const mockThemes: {
                 colorToken?: string | undefined;
             };
             motion: {
-                level: "medium" | "high" | "low" | "off";
+                level: "medium" | "off" | "high" | "low";
                 easing: "standard" | "snappy" | "gentle" | null;
             };
             corners: "soft" | "square" | "rounded" | "pill";
             header: {
-                variant: "classic" | "centered" | "transparent" | "floating";
+                variant: "classic" | "centered" | "floating";
                 positioning: "fixed" | "static" | "sticky";
                 shrinkOnScroll: boolean;
                 maxWidth: "full" | "container";
@@ -4087,6 +4051,12 @@ export declare const mockThemes: {
                         widthClass: string;
                     } | undefined;
                     hoverBackgroundToken?: import("../buttons").OpaqueButtonColourToken | undefined;
+                    contextualHover?: {
+                        kind: "shade-shift";
+                        seedToken: import("../buttons").OpaqueButtonColourToken;
+                        fallbackDirection: "lighter" | "darker";
+                        preferredToken?: import("../buttons").OpaqueButtonColourToken | undefined;
+                    } | undefined;
                     effects?: {
                         base?: ({
                             effectId: "darken-background";
@@ -4450,48 +4420,7 @@ export declare const mockThemes: {
                     })[];
                 } | undefined;
             } | undefined;
-            cards?: {
-                variants: {
-                    id: string;
-                    name: string;
-                    enabled: boolean;
-                    priority: 1 | 3 | 2;
-                    background: {
-                        type: "solid";
-                        colorToken: string;
-                    } | {
-                        type: "gradient";
-                        fromToken: string;
-                        toToken: string;
-                        direction: "to-r" | "to-l" | "to-t" | "to-b" | "to-tr" | "to-tl" | "to-br" | "to-bl";
-                    } | {
-                        type: "transparent";
-                    };
-                    spacing: "medium" | "none" | "compact" | "comfortable" | "spacious" | "cozy";
-                    foregroundToken?: string | undefined;
-                    shadow?: {
-                        elevation: "medium" | "none" | "high" | "low";
-                        softness: "crisp" | "soft" | "hard" | null;
-                        position: "bottom" | "bottom-right";
-                    } | undefined;
-                    corners?: "soft" | "square" | "rounded" | "pill" | undefined;
-                    cornerRadii?: {
-                        topLeft?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                        topRight?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                        bottomLeft?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                        bottomRight?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                    } | undefined;
-                    border?: {
-                        widthClass: string;
-                        colorToken: string;
-                    } | undefined;
-                    accentEdge?: {
-                        edge: "left" | "right" | "bottom" | "top";
-                        colorToken: string;
-                        width: "medium" | "thin" | "thick" | "heavy";
-                    } | undefined;
-                }[];
-            } | undefined;
+            cards?: import("../../../blocks/src/index").CardSystem | undefined;
             accordions?: {
                 background: {
                     type: "solid";
@@ -5113,8 +5042,7 @@ export declare const mockThemes: {
                         spacing?: "medium" | "none" | "compact" | "comfortable" | "spacious" | "cozy" | null | undefined;
                         raised?: boolean | null | undefined;
                         rounded?: "full" | "none" | "sm" | "md" | "lg" | "xl" | "2xl" | null | undefined;
-                        treatment?: "accent-quote" | "editorial-rule" | "soft-panel" | "editorial-serif-quote" | "editorial-open" | "color-blocked" | null | undefined;
-                        cardVariant?: "default" | "none" | "alternative" | null | undefined;
+                        role?: "open" | "default" | "none" | "alternative" | null | undefined;
                     } | null | undefined;
                 } | undefined;
             }> | undefined;
@@ -5292,12 +5220,12 @@ export declare const mockThemes: {
                 colorToken?: string | undefined;
             };
             motion: {
-                level: "medium" | "high" | "low" | "off";
+                level: "medium" | "off" | "high" | "low";
                 easing: "standard" | "snappy" | "gentle" | null;
             };
             corners: "soft" | "square" | "rounded" | "pill";
             header: {
-                variant: "classic" | "centered" | "transparent" | "floating";
+                variant: "classic" | "centered" | "floating";
                 positioning: "fixed" | "static" | "sticky";
                 shrinkOnScroll: boolean;
                 maxWidth: "full" | "container";
@@ -6673,6 +6601,12 @@ export declare const mockThemes: {
                         widthClass: string;
                     } | undefined;
                     hoverBackgroundToken?: import("../buttons").OpaqueButtonColourToken | undefined;
+                    contextualHover?: {
+                        kind: "shade-shift";
+                        seedToken: import("../buttons").OpaqueButtonColourToken;
+                        fallbackDirection: "lighter" | "darker";
+                        preferredToken?: import("../buttons").OpaqueButtonColourToken | undefined;
+                    } | undefined;
                     effects?: {
                         base?: ({
                             effectId: "darken-background";
@@ -7036,48 +6970,7 @@ export declare const mockThemes: {
                     })[];
                 } | undefined;
             } | undefined;
-            cards?: {
-                variants: {
-                    id: string;
-                    name: string;
-                    enabled: boolean;
-                    priority: 1 | 3 | 2;
-                    background: {
-                        type: "solid";
-                        colorToken: string;
-                    } | {
-                        type: "gradient";
-                        fromToken: string;
-                        toToken: string;
-                        direction: "to-r" | "to-l" | "to-t" | "to-b" | "to-tr" | "to-tl" | "to-br" | "to-bl";
-                    } | {
-                        type: "transparent";
-                    };
-                    spacing: "medium" | "none" | "compact" | "comfortable" | "spacious" | "cozy";
-                    foregroundToken?: string | undefined;
-                    shadow?: {
-                        elevation: "medium" | "none" | "high" | "low";
-                        softness: "crisp" | "soft" | "hard" | null;
-                        position: "bottom" | "bottom-right";
-                    } | undefined;
-                    corners?: "soft" | "square" | "rounded" | "pill" | undefined;
-                    cornerRadii?: {
-                        topLeft?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                        topRight?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                        bottomLeft?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                        bottomRight?: "soft" | "square" | "rounded" | "pill" | "expressive" | undefined;
-                    } | undefined;
-                    border?: {
-                        widthClass: string;
-                        colorToken: string;
-                    } | undefined;
-                    accentEdge?: {
-                        edge: "left" | "right" | "bottom" | "top";
-                        colorToken: string;
-                        width: "medium" | "thin" | "thick" | "heavy";
-                    } | undefined;
-                }[];
-            } | undefined;
+            cards?: import("../../../blocks/src/index").CardSystem | undefined;
             accordions?: {
                 background: {
                     type: "solid";
@@ -7699,8 +7592,7 @@ export declare const mockThemes: {
                         spacing?: "medium" | "none" | "compact" | "comfortable" | "spacious" | "cozy" | null | undefined;
                         raised?: boolean | null | undefined;
                         rounded?: "full" | "none" | "sm" | "md" | "lg" | "xl" | "2xl" | null | undefined;
-                        treatment?: "accent-quote" | "editorial-rule" | "soft-panel" | "editorial-serif-quote" | "editorial-open" | "color-blocked" | null | undefined;
-                        cardVariant?: "default" | "none" | "alternative" | null | undefined;
+                        role?: "open" | "default" | "none" | "alternative" | null | undefined;
                     } | null | undefined;
                 } | undefined;
             }> | undefined;

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

@@ -1,3 +1,4 @@
+export declare const ORDINARY_TEXT_MIN_CONTRAST_RATIO = 4.5;
 export declare function relativeLuminance(r: number, g: number, b: number): number;
 export declare function contrastRatio(hex1: string, hex2: string): number;
 export declare function raiseContrastText(bgHex: string, preferred: "light" | "dark"): string;

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

@@ -0,0 +1,6 @@
+type Palette = Readonly<Record<string, string>>;
+/** Resolve an opaque colour, compositing alpha against an explicit underlay. */
+export declare function resolveOpaqueSurfaceHex(reference: string, palette: Palette, underlayReference?: string | null): string | null;
+/** Resolve a colour reference only when it is already fully opaque. */
+export declare function resolveConcreteColorHex(reference: string, palette: Palette): string | null;
+export {};

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

@@ -28,7 +28,7 @@ export interface ThemeBridgeConfigMinimal {
             variants?: Array<'primary' | 'secondary' | 'outline' | 'ghost'>;
         };
         cards?: boolean | {
-            variants?: Array<'default' | 'elevated' | 'outlined'>;
+            variants?: Array<'default' | 'alternative' | 'open' | 'elevated' | 'outlined'>;
         };
         inputs?: boolean;
     };