@riverbankcms/sdk 0.77.1 → 0.78.0

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

@@ -12,8 +12,10 @@ export * from "./responsive/breakpoints";
 export { ThemeFontLoader, ThemeFontLoaderFromTheme, getThemeFontLoadingOptions, type ThemeFontLoadingOptions, type ThemeFontLoaderFromThemeProps, } from "./ThemeFontLoader";
 export { ThemeScopeCore, type ThemeScopeCoreProps } from "./ThemeScopeCore";
 export { type ThemeDataAttrs } from "./themeScopeUtils";
-export { getStandaloneHeaderShellClassName, planSiteTopShell, renderSiteTopChrome, type SiteChromeLayoutNodes, type SiteTopShellPlan, type SiteTopShellBehavior, } from "./siteChrome";
+export { SITE_CHROME_CLASS_NAMES, getStandaloneHeaderShellClassName, planSiteDocument, planSiteTopShell, renderSiteTopChrome, SITE_CHROME_VISIBLE_HEADER_ATTR, SITE_CHROME_VISIBLE_HEADER_SELECTOR, SITE_OVERLAY_HEADER_CLEARANCE_CSS_VAR, SITE_OVERLAY_HEADER_CLEARANCE_FALLBACK, visibleHeaderClearancePx, type HeaderMeasurementBox, type SiteChromeLayoutNodes, type SiteDocumentLayoutMode, type SiteDocumentPlan, type SiteDocumentPlanInput, type SiteTopShellPlan, type SiteTopShellBehavior, type SiteOverlayHeaderClearancePlan, } from "./siteChrome";
+export { SITE_CHROME_PLACEMENT_CLASSES, isHeaderPositioning, parseHeaderPositioning, planSiteChromePlacement, splitSiteChromePlacementClasses, type SiteChromePlacementPlan, } from "./siteChromePlacement";
 export { buildThemeRuntime } from "./runtime/buildThemeRuntime";
+export { THEME_RADIUS_CSS_VARS } from "./runtime/themeCssVarNames";
 export { buildThemeBridgeRuntime, buildThemeRuntimeFromBridge, THEME_BRIDGE_SCOPE_ID, type ThemeBridgeRuntime, type ThemeBridgeConfigMinimal, } from "./runtime/buildThemeRuntimeFromBridge";
 export type { CornerStyle, ShadowSize, TextTransform, FontWeight, HoverTransform, HoverColor, GradientStyle, GradientSharpness, GradientDirection, ButtonVariant, ButtonSystem, } from "./buttons/types";
 export { mockThemes } from "./mock-themes/all";

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

@@ -9,7 +9,7 @@ export declare const mockThemes: {
                 tone: "classic" | "bold" | "minimal";
                 energy: "calm" | "vibrant";
                 density: "compact" | "airy" | "regular";
-                mediaBias: "media" | "text" | "mixed";
+                mediaBias: "text" | "media" | "mixed";
                 conversionBias: "high" | "low" | "med";
                 motion: "standard" | "subtle" | "expressive";
             };
@@ -255,6 +255,7 @@ export declare const mockThemes: {
                     italic: boolean;
                     textSize?: "base" | "sm" | "lg" | "xs" | undefined;
                     letterSpacing?: "wide" | "normal" | "wider" | "widest" | undefined;
+                    contrastTreatment?: "none" | "soft-glow" | undefined;
                     hoverColorToken?: string | null | undefined;
                     paddingX?: "none" | "compact" | "spacious" | "default" | "tight" | "relaxed" | undefined;
                     effects?: {
@@ -360,6 +361,7 @@ export declare const mockThemes: {
                     italic: boolean;
                     textSize?: "base" | "sm" | "lg" | "xs" | undefined;
                     letterSpacing?: "wide" | "normal" | "wider" | "widest" | undefined;
+                    contrastTreatment?: "none" | "soft-glow" | undefined;
                     hoverColorToken?: string | null | undefined;
                     paddingX?: "none" | "compact" | "spacious" | "default" | "tight" | "relaxed" | undefined;
                     effects?: {
@@ -514,8 +516,8 @@ export declare const mockThemes: {
                     cornerStyle: "rounded" | "square" | "pill";
                     shadow: "medium" | "none" | "high" | "low";
                     textTransform: "none" | "capitalize" | "lowercase" | "uppercase";
-                    fontWeight: 600 | 500 | 700;
-                    borderWidth: 1 | 2 | 3;
+                    fontWeight: 500 | 600 | 700;
+                    borderWidth: 1 | 3 | 2;
                     hoverTransform: "none" | "scale" | "lift" | "press";
                     hoverColor: "none" | "token" | "darken" | "brighten" | "saturate";
                     cornerRadius?: number | undefined;
@@ -533,7 +535,7 @@ export declare const mockThemes: {
                     id: string;
                     name: string;
                     enabled: boolean;
-                    priority: 1 | 2 | 3;
+                    priority: 1 | 3 | 2;
                     background: {
                         type: "solid";
                         colorToken: string;
@@ -617,7 +619,7 @@ export declare const mockThemes: {
                     id: string;
                     name: string;
                     enabled: boolean;
-                    priority: 1 | 2 | 3;
+                    priority: 1 | 3 | 2;
                     background: {
                         type: "solid";
                         colorToken: string;
@@ -662,6 +664,7 @@ export declare const mockThemes: {
                     style: "caret" | "plus-minus" | "chevron" | "arrow" | "circle-plus-minus";
                     position: "left" | "right";
                     size: "sm" | "md" | "lg";
+                    colorToken?: string | undefined;
                 };
                 trigger: {
                     textColorToken: string;
@@ -781,7 +784,7 @@ export declare const mockThemes: {
                                     rotation?: 0 | 90 | 180 | 270 | undefined;
                                 } | undefined;
                             } | null | undefined;
-                            objectFit?: "fill" | "fit" | "original" | "custom" | null | undefined;
+                            objectFit?: "fill" | "custom" | "fit" | "original" | null | undefined;
                             scale?: string | null | undefined;
                             position?: string | null | undefined;
                             opacity?: number | null | undefined;
@@ -798,6 +801,7 @@ export declare const mockThemes: {
                         spacing?: "medium" | "none" | "compact" | "cozy" | "comfortable" | "spacious" | null | undefined;
                         minHeight?: "none" | "hero" | "banner" | "immersive" | null | undefined;
                         tileTreatment?: "default" | "quiet" | "brand-depth" | null | undefined;
+                        eventListTreatment?: "plain" | "lined-panel" | null | undefined;
                         eyebrowTreatment?: "pill" | "plain" | "accent-pill" | "pill-bounce" | "accent-pill-bounce" | null | undefined;
                         headingDecoration?: {
                             family: "none";
@@ -854,7 +858,7 @@ export declare const mockThemes: {
                                     rotation?: 0 | 90 | 180 | 270 | undefined;
                                 } | undefined;
                             } | null | undefined;
-                            objectFit?: "fill" | "fit" | "original" | "custom" | null | undefined;
+                            objectFit?: "fill" | "custom" | "fit" | "original" | null | undefined;
                             scale?: string | null | undefined;
                             position?: string | null | undefined;
                             opacity?: number | null | undefined;
@@ -912,7 +916,7 @@ export declare const mockThemes: {
                                     rotation?: 0 | 90 | 180 | 270 | undefined;
                                 } | undefined;
                             } | null | undefined;
-                            objectFit?: "fill" | "fit" | "original" | "custom" | null | undefined;
+                            objectFit?: "fill" | "custom" | "fit" | "original" | null | undefined;
                             scale?: string | null | undefined;
                             position?: string | null | undefined;
                             opacity?: number | null | undefined;
@@ -995,7 +999,7 @@ export declare const mockThemes: {
                 tone: "classic" | "bold" | "minimal";
                 energy: "calm" | "vibrant";
                 density: "compact" | "airy" | "regular";
-                mediaBias: "media" | "text" | "mixed";
+                mediaBias: "text" | "media" | "mixed";
                 conversionBias: "high" | "low" | "med";
                 motion: "standard" | "subtle" | "expressive";
             };
@@ -1241,6 +1245,7 @@ export declare const mockThemes: {
                     italic: boolean;
                     textSize?: "base" | "sm" | "lg" | "xs" | undefined;
                     letterSpacing?: "wide" | "normal" | "wider" | "widest" | undefined;
+                    contrastTreatment?: "none" | "soft-glow" | undefined;
                     hoverColorToken?: string | null | undefined;
                     paddingX?: "none" | "compact" | "spacious" | "default" | "tight" | "relaxed" | undefined;
                     effects?: {
@@ -1346,6 +1351,7 @@ export declare const mockThemes: {
                     italic: boolean;
                     textSize?: "base" | "sm" | "lg" | "xs" | undefined;
                     letterSpacing?: "wide" | "normal" | "wider" | "widest" | undefined;
+                    contrastTreatment?: "none" | "soft-glow" | undefined;
                     hoverColorToken?: string | null | undefined;
                     paddingX?: "none" | "compact" | "spacious" | "default" | "tight" | "relaxed" | undefined;
                     effects?: {
@@ -1500,8 +1506,8 @@ export declare const mockThemes: {
                     cornerStyle: "rounded" | "square" | "pill";
                     shadow: "medium" | "none" | "high" | "low";
                     textTransform: "none" | "capitalize" | "lowercase" | "uppercase";
-                    fontWeight: 600 | 500 | 700;
-                    borderWidth: 1 | 2 | 3;
+                    fontWeight: 500 | 600 | 700;
+                    borderWidth: 1 | 3 | 2;
                     hoverTransform: "none" | "scale" | "lift" | "press";
                     hoverColor: "none" | "token" | "darken" | "brighten" | "saturate";
                     cornerRadius?: number | undefined;
@@ -1519,7 +1525,7 @@ export declare const mockThemes: {
                     id: string;
                     name: string;
                     enabled: boolean;
-                    priority: 1 | 2 | 3;
+                    priority: 1 | 3 | 2;
                     background: {
                         type: "solid";
                         colorToken: string;
@@ -1603,7 +1609,7 @@ export declare const mockThemes: {
                     id: string;
                     name: string;
                     enabled: boolean;
-                    priority: 1 | 2 | 3;
+                    priority: 1 | 3 | 2;
                     background: {
                         type: "solid";
                         colorToken: string;
@@ -1648,6 +1654,7 @@ export declare const mockThemes: {
                     style: "caret" | "plus-minus" | "chevron" | "arrow" | "circle-plus-minus";
                     position: "left" | "right";
                     size: "sm" | "md" | "lg";
+                    colorToken?: string | undefined;
                 };
                 trigger: {
                     textColorToken: string;
@@ -1767,7 +1774,7 @@ export declare const mockThemes: {
                                     rotation?: 0 | 90 | 180 | 270 | undefined;
                                 } | undefined;
                             } | null | undefined;
-                            objectFit?: "fill" | "fit" | "original" | "custom" | null | undefined;
+                            objectFit?: "fill" | "custom" | "fit" | "original" | null | undefined;
                             scale?: string | null | undefined;
                             position?: string | null | undefined;
                             opacity?: number | null | undefined;
@@ -1784,6 +1791,7 @@ export declare const mockThemes: {
                         spacing?: "medium" | "none" | "compact" | "cozy" | "comfortable" | "spacious" | null | undefined;
                         minHeight?: "none" | "hero" | "banner" | "immersive" | null | undefined;
                         tileTreatment?: "default" | "quiet" | "brand-depth" | null | undefined;
+                        eventListTreatment?: "plain" | "lined-panel" | null | undefined;
                         eyebrowTreatment?: "pill" | "plain" | "accent-pill" | "pill-bounce" | "accent-pill-bounce" | null | undefined;
                         headingDecoration?: {
                             family: "none";
@@ -1840,7 +1848,7 @@ export declare const mockThemes: {
                                     rotation?: 0 | 90 | 180 | 270 | undefined;
                                 } | undefined;
                             } | null | undefined;
-                            objectFit?: "fill" | "fit" | "original" | "custom" | null | undefined;
+                            objectFit?: "fill" | "custom" | "fit" | "original" | null | undefined;
                             scale?: string | null | undefined;
                             position?: string | null | undefined;
                             opacity?: number | null | undefined;
@@ -1898,7 +1906,7 @@ export declare const mockThemes: {
                                     rotation?: 0 | 90 | 180 | 270 | undefined;
                                 } | undefined;
                             } | null | undefined;
-                            objectFit?: "fill" | "fit" | "original" | "custom" | null | undefined;
+                            objectFit?: "fill" | "custom" | "fit" | "original" | null | undefined;
                             scale?: string | null | undefined;
                             position?: string | null | undefined;
                             opacity?: number | null | undefined;
@@ -1981,7 +1989,7 @@ export declare const mockThemes: {
                 tone: "classic" | "bold" | "minimal";
                 energy: "calm" | "vibrant";
                 density: "compact" | "airy" | "regular";
-                mediaBias: "media" | "text" | "mixed";
+                mediaBias: "text" | "media" | "mixed";
                 conversionBias: "high" | "low" | "med";
                 motion: "standard" | "subtle" | "expressive";
             };
@@ -2227,6 +2235,7 @@ export declare const mockThemes: {
                     italic: boolean;
                     textSize?: "base" | "sm" | "lg" | "xs" | undefined;
                     letterSpacing?: "wide" | "normal" | "wider" | "widest" | undefined;
+                    contrastTreatment?: "none" | "soft-glow" | undefined;
                     hoverColorToken?: string | null | undefined;
                     paddingX?: "none" | "compact" | "spacious" | "default" | "tight" | "relaxed" | undefined;
                     effects?: {
@@ -2332,6 +2341,7 @@ export declare const mockThemes: {
                     italic: boolean;
                     textSize?: "base" | "sm" | "lg" | "xs" | undefined;
                     letterSpacing?: "wide" | "normal" | "wider" | "widest" | undefined;
+                    contrastTreatment?: "none" | "soft-glow" | undefined;
                     hoverColorToken?: string | null | undefined;
                     paddingX?: "none" | "compact" | "spacious" | "default" | "tight" | "relaxed" | undefined;
                     effects?: {
@@ -2486,8 +2496,8 @@ export declare const mockThemes: {
                     cornerStyle: "rounded" | "square" | "pill";
                     shadow: "medium" | "none" | "high" | "low";
                     textTransform: "none" | "capitalize" | "lowercase" | "uppercase";
-                    fontWeight: 600 | 500 | 700;
-                    borderWidth: 1 | 2 | 3;
+                    fontWeight: 500 | 600 | 700;
+                    borderWidth: 1 | 3 | 2;
                     hoverTransform: "none" | "scale" | "lift" | "press";
                     hoverColor: "none" | "token" | "darken" | "brighten" | "saturate";
                     cornerRadius?: number | undefined;
@@ -2505,7 +2515,7 @@ export declare const mockThemes: {
                     id: string;
                     name: string;
                     enabled: boolean;
-                    priority: 1 | 2 | 3;
+                    priority: 1 | 3 | 2;
                     background: {
                         type: "solid";
                         colorToken: string;
@@ -2589,7 +2599,7 @@ export declare const mockThemes: {
                     id: string;
                     name: string;
                     enabled: boolean;
-                    priority: 1 | 2 | 3;
+                    priority: 1 | 3 | 2;
                     background: {
                         type: "solid";
                         colorToken: string;
@@ -2634,6 +2644,7 @@ export declare const mockThemes: {
                     style: "caret" | "plus-minus" | "chevron" | "arrow" | "circle-plus-minus";
                     position: "left" | "right";
                     size: "sm" | "md" | "lg";
+                    colorToken?: string | undefined;
                 };
                 trigger: {
                     textColorToken: string;
@@ -2753,7 +2764,7 @@ export declare const mockThemes: {
                                     rotation?: 0 | 90 | 180 | 270 | undefined;
                                 } | undefined;
                             } | null | undefined;
-                            objectFit?: "fill" | "fit" | "original" | "custom" | null | undefined;
+                            objectFit?: "fill" | "custom" | "fit" | "original" | null | undefined;
                             scale?: string | null | undefined;
                             position?: string | null | undefined;
                             opacity?: number | null | undefined;
@@ -2770,6 +2781,7 @@ export declare const mockThemes: {
                         spacing?: "medium" | "none" | "compact" | "cozy" | "comfortable" | "spacious" | null | undefined;
                         minHeight?: "none" | "hero" | "banner" | "immersive" | null | undefined;
                         tileTreatment?: "default" | "quiet" | "brand-depth" | null | undefined;
+                        eventListTreatment?: "plain" | "lined-panel" | null | undefined;
                         eyebrowTreatment?: "pill" | "plain" | "accent-pill" | "pill-bounce" | "accent-pill-bounce" | null | undefined;
                         headingDecoration?: {
                             family: "none";
@@ -2826,7 +2838,7 @@ export declare const mockThemes: {
                                     rotation?: 0 | 90 | 180 | 270 | undefined;
                                 } | undefined;
                             } | null | undefined;
-                            objectFit?: "fill" | "fit" | "original" | "custom" | null | undefined;
+                            objectFit?: "fill" | "custom" | "fit" | "original" | null | undefined;
                             scale?: string | null | undefined;
                             position?: string | null | undefined;
                             opacity?: number | null | undefined;
@@ -2884,7 +2896,7 @@ export declare const mockThemes: {
                                     rotation?: 0 | 90 | 180 | 270 | undefined;
                                 } | undefined;
                             } | null | undefined;
-                            objectFit?: "fill" | "fit" | "original" | "custom" | null | undefined;
+                            objectFit?: "fill" | "custom" | "fit" | "original" | null | undefined;
                             scale?: string | null | undefined;
                             position?: string | null | undefined;
                             opacity?: number | null | undefined;

package/dist/_dts/theme-core/src/navigation/generateNavLinkCSS.d.ts

@@ -6,7 +6,7 @@
  */
 import type { Theme } from '../schema';
 import type { TokenResolver } from '../tokens/resolver';
-import type { NavLinkStyle } from './types';
+import type { NavLinkStyle, NavLinkContrastTreatment } from './types';
 export interface GenerateNavLinkCSSOptions {
     /** Theme ID for CSS scoping */
     themeId: string;
@@ -23,3 +23,8 @@ export interface GenerateNavLinkCSSOptions {
  * Generate complete CSS for nav links from a NavLinkStyle configuration
  */
 export declare function generateNavLinkCSS(options: GenerateNavLinkCSSOptions): string;
+export declare function buildTextContrastShadow(input: Readonly<{
+    theme: Theme;
+    colorToken: string | null | undefined;
+    treatment: NavLinkContrastTreatment | null | undefined;
+}>): string | null;

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

@@ -51,6 +51,13 @@ export declare const navLinkLetterSpacingSchema: z.ZodEnum<{
     wider: "wider";
     widest: "widest";
 }>;
+/**
+ * Optional legibility aid for nav text that floats over uncertain imagery or color.
+ */
+export declare const navLinkContrastTreatmentSchema: z.ZodEnum<{
+    none: "none";
+    "soft-glow": "soft-glow";
+}>;
 /**
  * Nav link style schema
  *
@@ -70,6 +77,10 @@ export declare const navLinkStyleSchema: z.ZodObject<{
         wider: "wider";
         widest: "widest";
     }>>;
+    contrastTreatment: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        "soft-glow": "soft-glow";
+    }>>;
     hoverColorToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     padding: z.ZodDefault<z.ZodEnum<{
         none: "none";
@@ -131,6 +142,7 @@ export type NavLinkPaddingX = z.infer<typeof navLinkPaddingXSchema>;
 export type NavLinkBorderRadius = z.infer<typeof navLinkBorderRadiusSchema>;
 export type NavLinkTextSize = z.infer<typeof navLinkTextSizeSchema>;
 export type NavLinkLetterSpacing = z.infer<typeof navLinkLetterSpacingSchema>;
+export type NavLinkContrastTreatment = z.infer<typeof navLinkContrastTreatmentSchema>;
 export type NavLinkStyle = z.infer<typeof navLinkStyleSchema>;
 /**
  * Padding values for nav link padding presets

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

@@ -68,16 +68,16 @@ export declare const paletteVariantSchema: z.ZodObject<{
     colors: z.ZodArray<z.ZodObject<{
         hex: z.ZodString;
         name: z.ZodEnum<{
+            surface: "surface";
             success: "success";
             text: "text";
             primary: "primary";
             secondary: "secondary";
+            warning: "warning";
             border: "border";
             background: "background";
             muted: "muted";
-            surface: "surface";
             accent: "accent";
-            warning: "warning";
             destructive: "destructive";
             primaryForeground: "primaryForeground";
             surfaceAlt: "surfaceAlt";
@@ -118,7 +118,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<"success" | "text" | "primary" | "secondary" | "border" | "background" | "muted" | "surface" | "accent" | "warning" | "destructive" | "primaryForeground" | "surfaceAlt", HexColor>>>, {
+}, z.core.$strict>, z.ZodTransform<Readonly<Partial<Record<"surface" | "success" | "text" | "primary" | "secondary" | "warning" | "border" | "background" | "muted" | "accent" | "destructive" | "primaryForeground" | "surfaceAlt", HexColor>>>, {
     primary?: HexColor | undefined;
     primaryForeground?: HexColor | undefined;
     secondary?: HexColor | undefined;

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

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