@riverbankcms/sdk 0.79.0 → 0.80.0

package/dist/_dts/theme-core/src/accordions/siteStyleDefaults.d.ts

@@ -1,3 +1,218 @@
+/**
+ * Reusable accordion "looks" for curated site styles.
+ *
+ * Each curated site style should declare one of these (or a bespoke variant)
+ * via `themeOverrides.accordions` so its FAQ accordions carry the style's
+ * personality instead of falling back to the generic generated default. The
+ * looks vary the things that make an accordion read as designed vs. cheap:
+ * box vs. boxless, question typography (body vs. heading font + scale), icon,
+ * and how an open item is emphasised.
+ */
+/**
+ * Boxless editorial list: transparent root, hairline dividers between rows,
+ * generous spacing, heading-font questions, plus/minus marks, and an accented
+ * tinted band on the open row. The reference "expensive" FAQ look.
+ */
+export declare const editorialDividedAccordionSystem: {
+    readonly background: null;
+    readonly spacing: "comfortable";
+    readonly corners: "square";
+    readonly border: null;
+    readonly shadow: null;
+    readonly icon: {
+        readonly style: "plus-minus";
+        readonly position: "right";
+        readonly size: "md";
+        readonly colorToken: "primary";
+    };
+    readonly trigger: {
+        readonly textColorToken: "text";
+        readonly fontWeight: "regular";
+        readonly fontFamily: "heading";
+        readonly fontScale: "lg";
+    };
+    readonly hover: {
+        readonly textColorToken: "primary";
+    };
+    readonly openState: {
+        readonly backgroundColorToken: "surfaceAlt";
+        readonly triggerColorToken: "primary";
+        readonly accent: {
+            readonly edge: "left";
+            readonly colorToken: "primary";
+            readonly thickness: "medium";
+        };
+    };
+    readonly content: {
+        readonly textColorToken: "neutral-700";
+    };
+};
+/**
+ * Quiet, airy underlined rows: transparent, spacious, large calm heading-font
+ * questions, a small subtle chevron, and open emphasis carried only by the
+ * question recolouring. For minimal / premium / wellness styles.
+ */
+export declare const quietUnderlinedAccordionSystem: {
+    readonly background: null;
+    readonly spacing: "spacious";
+    readonly corners: "square";
+    readonly border: null;
+    readonly shadow: null;
+    readonly icon: {
+        readonly style: "chevron";
+        readonly position: "right";
+        readonly size: "sm";
+        readonly colorToken: "muted";
+    };
+    readonly trigger: {
+        readonly textColorToken: "text";
+        readonly fontWeight: "regular";
+        readonly fontFamily: "heading";
+        readonly fontScale: "lg";
+    };
+    readonly hover: {
+        readonly textColorToken: "primary";
+    };
+    readonly openState: {
+        readonly triggerColorToken: "primary";
+    };
+    readonly content: {
+        readonly textColorToken: "neutral-700";
+    };
+};
+/**
+ * Soft contained panel: a gentle surface box with soft corners, a hairline
+ * border and a low shadow, heading-font questions at a moderate size, chevron,
+ * and a tinted open state. For clean, trustworthy, appointment-led styles.
+ */
+export declare const calmPanelAccordionSystem: {
+    readonly background: {
+        readonly type: "solid";
+        readonly colorToken: "surface";
+    };
+    readonly spacing: "comfortable";
+    readonly corners: "soft";
+    readonly border: {
+        readonly widthClass: "border";
+        readonly colorToken: "border";
+    };
+    readonly shadow: {
+        readonly elevation: "low";
+        readonly softness: "soft";
+        readonly position: "bottom";
+    };
+    readonly icon: {
+        readonly style: "chevron";
+        readonly position: "right";
+        readonly size: "md";
+        readonly colorToken: "primary";
+    };
+    readonly trigger: {
+        readonly textColorToken: "text";
+        readonly fontWeight: "medium";
+        readonly fontFamily: "heading";
+        readonly fontScale: "md";
+    };
+    readonly hover: {
+        readonly backgroundColorToken: "primary/5";
+        readonly textColorToken: "primary";
+    };
+    readonly openState: {
+        readonly backgroundColorToken: "primary/5";
+        readonly triggerColorToken: "primary";
+    };
+    readonly content: {
+        readonly textColorToken: "neutral-700";
+    };
+};
+/**
+ * Bold bordered panel: a strong-bordered surface box, bold heading-font
+ * questions, large plus/minus marks, and a high-emphasis tinted + accented
+ * open state. For confident, conversion-led, high-energy styles.
+ */
+export declare const boldBorderedAccordionSystem: {
+    readonly background: {
+        readonly type: "solid";
+        readonly colorToken: "surface";
+    };
+    readonly spacing: "comfortable";
+    readonly corners: "soft";
+    readonly border: {
+        readonly widthClass: "border-2";
+        readonly colorToken: "border";
+    };
+    readonly shadow: null;
+    readonly icon: {
+        readonly style: "plus-minus";
+        readonly position: "right";
+        readonly size: "lg";
+        readonly colorToken: "primary";
+    };
+    readonly trigger: {
+        readonly textColorToken: "text";
+        readonly fontWeight: "bold";
+        readonly fontFamily: "heading";
+        readonly fontScale: "md";
+    };
+    readonly hover: {
+        readonly backgroundColorToken: "primary/10";
+        readonly textColorToken: "primary";
+    };
+    readonly openState: {
+        readonly backgroundColorToken: "primary/10";
+        readonly triggerColorToken: "primary";
+        readonly accent: {
+            readonly edge: "left";
+            readonly colorToken: "primary";
+            readonly thickness: "thick";
+        };
+    };
+    readonly content: {
+        readonly textColorToken: "neutral-700";
+    };
+};
+/**
+ * Warm inset tiles: a tinted (surfaceAlt) root with rounded corners and no
+ * border; the open row lifts to the lighter surface colour. Friendly,
+ * hands-on, community styles.
+ */
+export declare const warmInsetAccordionSystem: {
+    readonly background: {
+        readonly type: "solid";
+        readonly colorToken: "surfaceAlt";
+    };
+    readonly spacing: "comfortable";
+    readonly corners: "rounded";
+    readonly border: null;
+    readonly shadow: null;
+    readonly icon: {
+        readonly style: "circle-plus-minus";
+        readonly position: "right";
+        readonly size: "md";
+        readonly colorToken: "primary";
+    };
+    readonly trigger: {
+        readonly textColorToken: "text";
+        readonly fontWeight: "semibold";
+        readonly fontFamily: "heading";
+        readonly fontScale: "md";
+    };
+    readonly hover: {
+        readonly backgroundColorToken: "primary/5";
+        readonly textColorToken: "primary";
+    };
+    readonly openState: {
+        readonly backgroundColorToken: "surface";
+        readonly triggerColorToken: "primary";
+    };
+    readonly content: {
+        readonly textColorToken: "neutral-700";
+    };
+};
+/**
+ * Soft Earth's grounded look: boxless, plus/minus, heading-font questions on
+ * a warm ground, with a quiet open recolour.
+ */
 export declare const softEarthAccordionSystem: {
     readonly background: {
         readonly type: "solid";
@@ -16,10 +231,15 @@ export declare const softEarthAccordionSystem: {
     readonly trigger: {
         readonly textColorToken: "text";
         readonly fontWeight: "medium";
+        readonly fontFamily: "heading";
+        readonly fontScale: "md";
     };
     readonly hover: {
         readonly textColorToken: "primary";
     };
+    readonly openState: {
+        readonly triggerColorToken: "primary";
+    };
     readonly content: {
         readonly textColorToken: "neutral-700";
     };

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

@@ -20,10 +20,10 @@ export type AccordionLucideIcon = 'Plus' | 'Minus' | 'ChevronDown' | 'ArrowDown'
  * Single style per theme (no variants needed)
  */
 export declare const accordionSystemSchema: z.ZodObject<{
-    background: z.ZodObject<{
+    background: z.ZodNullable<z.ZodObject<{
         type: z.ZodLiteral<"solid">;
         colorToken: z.ZodString;
-    }, z.core.$strip>;
+    }, z.core.$strip>>;
     spacing: z.ZodEnum<{
         medium: "medium";
         none: "none";
@@ -86,12 +86,47 @@ export declare const accordionSystemSchema: z.ZodObject<{
             regular: "regular";
             semibold: "semibold";
         }>>;
+        fontFamily: z.ZodOptional<z.ZodEnum<{
+            body: "body";
+            heading: "heading";
+        }>>;
+        fontScale: z.ZodOptional<z.ZodEnum<{
+            body: "body";
+            md: "md";
+            lg: "lg";
+        }>>;
+        letterSpacing: z.ZodOptional<z.ZodEnum<{
+            wide: "wide";
+            normal: "normal";
+            tight: "tight";
+        }>>;
+        textTransform: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            uppercase: "uppercase";
+        }>>;
     }, z.core.$strip>;
     hover: z.ZodObject<{
         backgroundColorToken: z.ZodOptional<z.ZodString>;
         textColorToken: z.ZodOptional<z.ZodString>;
         borderColorToken: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
+    openState: z.ZodOptional<z.ZodObject<{
+        backgroundColorToken: z.ZodOptional<z.ZodString>;
+        triggerColorToken: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodObject<{
+            edge: z.ZodEnum<{
+                left: "left";
+                top: "top";
+                bottom: "bottom";
+            }>;
+            colorToken: z.ZodString;
+            thickness: z.ZodEnum<{
+                medium: "medium";
+                thick: "thick";
+                thin: "thin";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     content: z.ZodObject<{
         textColorToken: z.ZodString;
     }, z.core.$strip>;
@@ -114,3 +149,11 @@ export declare const ICON_SIZE_PX: Record<AccordionSystem['icon']['size'], strin
  * Spacing map for accordion content padding
  */
 export declare const ACCORDION_SPACING_MAP: Record<AccordionSystem['spacing'], string>;
+/**
+ * Question (trigger) font-size by scale step. Kept as self-contained clamps
+ * rather than the heading-scale CSS vars so question size stays predictable
+ * even when a theme configures very large headings.
+ */
+export declare const ACCORDION_TRIGGER_FONT_SCALE: Record<NonNullable<AccordionSystem['trigger']['fontScale']>, string>;
+export declare const ACCORDION_TRIGGER_LETTER_SPACING: Record<NonNullable<AccordionSystem['trigger']['letterSpacing']>, string>;
+export declare const ACCORDION_OPEN_ACCENT_THICKNESS: Record<NonNullable<NonNullable<AccordionSystem['openState']>['accent']>['thickness'], string>;

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

@@ -1,4 +1,12 @@
 import type { BlockThemeOverride, Theme } from "./schema";
+import type { HeadingDecorationOverride, VisibleHeadingDecoration } from "./site-styles/types";
 export declare function normalizeBlockKind(blockKind: string): string;
+export type EffectiveHeadingDecoration = Readonly<{
+    kind: "none";
+}> | Readonly<{
+    kind: "visible";
+    decoration: VisibleHeadingDecoration;
+}>;
+export declare function resolveEffectiveHeadingDecoration(themeDecoration: Theme["headingDecoration"], override: HeadingDecorationOverride | null | undefined): EffectiveHeadingDecoration;
 export declare function resolveBlockThemeOverride(theme: Theme | undefined, blockKind: string | undefined): BlockThemeOverride | undefined;
 export declare function mergeContentWithBlockStyleOverrides<TContent extends Record<string, unknown>>(content: TContent, theme: Theme | undefined, blockKind: string | undefined): TContent;

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

@@ -4,7 +4,7 @@
  * Type definitions for Tier 3 (block-specific) CSS variable generation.
  */
 import type { Theme } from '../schema';
-export type BlockVarGeneratorTheme = Pick<Theme, 'corners' | 'motion'>;
+export type BlockVarGeneratorTheme = Pick<Theme, 'corners' | 'motion' | 'testimonialQuote'>;
 /**
  * Context passed to block var generators.
  * Contains the theme read surface and themeId for scoped CSS generation.

package/dist/_dts/theme-core/src/blocks/vars/testimonials.d.ts

@@ -4,6 +4,9 @@
  * Tier 3 variables for the testimonials block:
  * - Applies to [data-block="testimonials"]
  * - Intended for theme overrides via blockCustomVars/blockCustomCss
+ *
+ * The quote-mark vars are driven by the site-style-owned quote treatment
+ * (theme.testimonialQuote); see resolveTestimonialQuoteVars.
  */
 import type { BlockVarGeneratorContext } from '../types';
-export declare function generateTestimonialsVars({ themeId }: BlockVarGeneratorContext): string;
+export declare function generateTestimonialsVars({ themeId, theme, }: BlockVarGeneratorContext): string;

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

@@ -40,8 +40,8 @@ export declare const buttonPersonalitySchema: z.ZodObject<{
         }>>;
         motion: z.ZodOptional<z.ZodEnum<{
             standard: "standard";
-            subtle: "subtle";
             expressive: "expressive";
+            subtle: "subtle";
         }>>;
         era: z.ZodOptional<z.ZodEnum<{
             editorial: "editorial";

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

@@ -6,6 +6,20 @@
  */
 export type CardBackgroundType = 'solid' | 'transparent' | 'gradient';
 export type CardSpacingCore = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
+export type CardCornerValueCore = 'square' | 'soft' | 'rounded' | 'pill' | 'expressive';
+export type CardEdgeCore = 'left' | 'top' | 'right' | 'bottom';
+export type CardEdgeWidthCore = 'thin' | 'medium' | 'thick' | 'heavy';
+export interface CardCornerRadiiCore {
+    topLeft?: CardCornerValueCore;
+    topRight?: CardCornerValueCore;
+    bottomLeft?: CardCornerValueCore;
+    bottomRight?: CardCornerValueCore;
+}
+export interface CardAccentEdgeCore {
+    edge: CardEdgeCore;
+    colorToken: string;
+    width: CardEdgeWidthCore;
+}
 export interface CardVariantCore {
     /** Unique variant identifier (e.g., 'default', 'elevated') */
     id: string;
@@ -21,10 +35,16 @@ export interface CardVariantCore {
     gradientDirection?: 'to-r' | 'to-l' | 'to-t' | 'to-b' | 'to-tr' | 'to-tl' | 'to-br' | 'to-bl';
     /** Content padding */
     spacing: CardSpacingCore;
+    /** Card text (foreground) color token, for cards on a strong fill */
+    foregroundToken?: string;
     /** Border color token */
     borderToken?: string;
     /** Border width */
     borderWidth?: 'none' | 'thin' | 'medium' | 'thick';
+    /** Single accent edge; replaces the full border when set */
+    accentEdge?: CardAccentEdgeCore;
+    /** Per-corner radius override; wins over the global corners setting */
+    cornerRadii?: CardCornerRadiiCore;
 }
 export interface CardCoreSettings {
     /** Corner radius style */

package/dist/_dts/theme-core/src/cards/generateDefaultCardSystem.d.ts

@@ -3,9 +3,12 @@ import type { CardSystem } from './types';
 /**
  * Generate a default card system from theme settings
  *
- * Creates a single "default" variant that intelligently uses theme settings:
- * - Explicitly sets theme.shadow and theme.corners (for runtime transform access)
- * - Uses theme.border if defined and has meaningful width
+ * Creates the baseline card roles that blocks can request:
+ * - `default` for everyday surfaced cards
+ * - `alternative` for emphasised cards
+ *
+ * Both variants explicitly set theme.shadow and theme.corners for runtime
+ * transform access, and both use theme.border when it has meaningful width.
  *
  * This ensures cards have sensible defaults even when theme.cards is undefined.
  *

package/dist/_dts/theme-core/src/cards/siteStyleDefaults.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Reusable card systems for curated site styles.
+ *
+ * generateCardCss emits a `.card-{id}` class per enabled variant. The
+ * intended convention (block-level role selection is wired in a follow-up) is
+ * a role pair:
+ *   - `default`     — the quiet, everyday card (most blocks, most of the time)
+ *   - `alternative` — the prominent "statement" card for sections that pop
+ * A card-heavy site style may add a third; the schema allows up to three
+ * variants. The planned fallback when a block references a missing variant is
+ * `alternative`, then `default`.
+ *
+ * Keep `default` close to the generated baseline so shared consumers (event
+ * cards, testimonials) stay stable; put the personality in `alternative`.
+ */
+/**
+ * South West Twerk School: a quiet default surface card plus a high-impact
+ * "statement" card that reproduces the legacy accent-quote testimonial surface
+ * — burgundy fill, light text, a heavy gold left accent bar, and an expressive
+ * asymmetric top-right corner.
+ */
+export declare const southWestCardSystem: {
+    readonly variants: [{
+        readonly id: "default";
+        readonly name: "Default";
+        readonly enabled: true;
+        readonly priority: 1;
+        readonly background: {
+            readonly type: "solid";
+            readonly colorToken: "surface";
+        };
+        readonly foregroundToken: "text";
+        readonly spacing: "comfortable";
+        readonly corners: "soft";
+        readonly shadow: {
+            readonly elevation: "low";
+            readonly softness: "soft";
+            readonly position: "bottom";
+        };
+    }, {
+        readonly id: "alternative";
+        readonly name: "Statement";
+        readonly enabled: true;
+        readonly priority: 2;
+        readonly background: {
+            readonly type: "solid";
+            readonly colorToken: "primary-700";
+        };
+        readonly foregroundToken: "primaryForeground";
+        readonly spacing: "comfortable";
+        readonly shadow: {
+            readonly elevation: "none";
+            readonly softness: null;
+            readonly position: "bottom";
+        };
+        readonly accentEdge: {
+            readonly edge: "left";
+            readonly colorToken: "secondary";
+            readonly width: "heavy";
+        };
+        readonly cornerRadii: {
+            readonly topLeft: "square";
+            readonly topRight: "expressive";
+            readonly bottomLeft: "square";
+            readonly bottomRight: "square";
+        };
+    }];
+};
+export declare const clarityZenCardSystem: {
+    readonly variants: [{
+        readonly id: "default";
+        readonly name: "Default";
+        readonly enabled: true;
+        readonly priority: 1;
+        readonly background: {
+            readonly type: "solid";
+            readonly colorToken: "surface";
+        };
+        readonly foregroundToken: "text";
+        readonly spacing: "comfortable";
+        readonly corners: "rounded";
+        readonly shadow: {
+            readonly elevation: "low";
+            readonly softness: "soft";
+            readonly position: "bottom";
+        };
+    }, {
+        readonly id: "alternative";
+        readonly name: "Statement";
+        readonly enabled: true;
+        readonly priority: 2;
+        readonly background: {
+            readonly type: "solid";
+            readonly colorToken: "surfaceAlt";
+        };
+        readonly foregroundToken: "text";
+        readonly spacing: "comfortable";
+        readonly corners: "rounded";
+        readonly shadow: {
+            readonly elevation: "medium";
+            readonly softness: "soft";
+            readonly position: "bottom";
+        };
+    }];
+};