@riverbankcms/sdk 0.78.2 → 0.80.0

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";
+        };
+    }];
+};

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

@@ -12,6 +12,16 @@ export type Shadow = {
 };
 export type CardSpacing = 'none' | 'compact' | 'cozy' | 'medium' | 'comfortable' | 'spacious';
 export type GradientDirection = 'to-r' | 'to-l' | 'to-t' | 'to-b' | 'to-tr' | 'to-tl' | 'to-br' | 'to-bl';
+export declare const cardVariantRoleValues: readonly ["default", "alternative"];
+export declare const boxlessCardVariantValue: "none";
+export type CardVariantRole = (typeof cardVariantRoleValues)[number];
+export type BoxlessCardVariant = typeof boxlessCardVariantValue;
+export type BoxStylesCardVariant = CardVariantRole | BoxlessCardVariant;
+export declare const legacyCardVariantRoleAliases: {
+    readonly variant1: "alternative";
+    readonly variant2: "alternative";
+};
+export type LegacyCardVariantRoleAlias = keyof typeof legacyCardVariantRoleAliases;
 export type CardBackground = {
     type: 'solid';
     colorToken: string;
@@ -45,6 +55,18 @@ export declare const gradientDirectionSchema: z.ZodEnum<{
     "to-br": "to-br";
     "to-bl": "to-bl";
 }>;
+export declare const cardVariantRoleSchema: z.ZodEnum<{
+    default: "default";
+    alternative: "alternative";
+}>;
+export declare const boxStylesCardVariantSchema: z.ZodEnum<{
+    none: "none";
+    default: "default";
+    alternative: "alternative";
+}>;
+export declare function isCardVariantRole(value: unknown): value is CardVariantRole;
+export declare function normalizeCardVariantRole(value: unknown): CardVariantRole | null;
+export declare function normalizeBoxStylesCardVariant(value: unknown): BoxStylesCardVariant | null;
 export declare const cardBackgroundSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"solid">;
     colorToken: z.ZodString;
@@ -69,6 +91,66 @@ export declare const cardBorderSchema: z.ZodObject<{
     widthClass: z.ZodString;
     colorToken: z.ZodString;
 }, z.core.$strip>;
+/** Per-corner radius value. `expressive` is a large block-radius multiple. */
+export declare const cardCornerValueSchema: z.ZodEnum<{
+    rounded: "rounded";
+    square: "square";
+    pill: "pill";
+    soft: "soft";
+    expressive: "expressive";
+}>;
+export type CardCornerValue = z.infer<typeof cardCornerValueSchema>;
+/**
+ * A single accented card edge (e.g. a left accent bar). When set, it replaces
+ * the full `border` so the card reads as edge-accented rather than outlined.
+ */
+export declare const cardAccentEdgeSchema: z.ZodObject<{
+    edge: z.ZodEnum<{
+        left: "left";
+        right: "right";
+        top: "top";
+        bottom: "bottom";
+    }>;
+    colorToken: z.ZodString;
+    width: z.ZodEnum<{
+        medium: "medium";
+        thick: "thick";
+        thin: "thin";
+        heavy: "heavy";
+    }>;
+}, z.core.$strip>;
+export type CardAccentEdge = z.infer<typeof cardAccentEdgeSchema>;
+export declare const cardCornerRadiiSchema: z.ZodObject<{
+    topLeft: z.ZodOptional<z.ZodEnum<{
+        rounded: "rounded";
+        square: "square";
+        pill: "pill";
+        soft: "soft";
+        expressive: "expressive";
+    }>>;
+    topRight: z.ZodOptional<z.ZodEnum<{
+        rounded: "rounded";
+        square: "square";
+        pill: "pill";
+        soft: "soft";
+        expressive: "expressive";
+    }>>;
+    bottomLeft: z.ZodOptional<z.ZodEnum<{
+        rounded: "rounded";
+        square: "square";
+        pill: "pill";
+        soft: "soft";
+        expressive: "expressive";
+    }>>;
+    bottomRight: z.ZodOptional<z.ZodEnum<{
+        rounded: "rounded";
+        square: "square";
+        pill: "pill";
+        soft: "soft";
+        expressive: "expressive";
+    }>>;
+}, z.core.$strip>;
+export type CardCornerRadii = z.infer<typeof cardCornerRadiiSchema>;
 export declare const cardVariantSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
@@ -102,6 +184,7 @@ export declare const cardVariantSchema: z.ZodObject<{
         comfortable: "comfortable";
         spacious: "spacious";
     }>;
+    foregroundToken: z.ZodOptional<z.ZodString>;
     shadow: z.ZodOptional<z.ZodObject<{
         elevation: z.ZodEnum<{
             medium: "medium";
@@ -125,10 +208,55 @@ export declare const cardVariantSchema: z.ZodObject<{
         pill: "pill";
         soft: "soft";
     }>>;
+    cornerRadii: z.ZodOptional<z.ZodObject<{
+        topLeft: z.ZodOptional<z.ZodEnum<{
+            rounded: "rounded";
+            square: "square";
+            pill: "pill";
+            soft: "soft";
+            expressive: "expressive";
+        }>>;
+        topRight: z.ZodOptional<z.ZodEnum<{
+            rounded: "rounded";
+            square: "square";
+            pill: "pill";
+            soft: "soft";
+            expressive: "expressive";
+        }>>;
+        bottomLeft: z.ZodOptional<z.ZodEnum<{
+            rounded: "rounded";
+            square: "square";
+            pill: "pill";
+            soft: "soft";
+            expressive: "expressive";
+        }>>;
+        bottomRight: z.ZodOptional<z.ZodEnum<{
+            rounded: "rounded";
+            square: "square";
+            pill: "pill";
+            soft: "soft";
+            expressive: "expressive";
+        }>>;
+    }, z.core.$strip>>;
     border: z.ZodOptional<z.ZodObject<{
         widthClass: z.ZodString;
         colorToken: z.ZodString;
     }, z.core.$strip>>;
+    accentEdge: z.ZodOptional<z.ZodObject<{
+        edge: z.ZodEnum<{
+            left: "left";
+            right: "right";
+            top: "top";
+            bottom: "bottom";
+        }>;
+        colorToken: z.ZodString;
+        width: z.ZodEnum<{
+            medium: "medium";
+            thick: "thick";
+            thin: "thin";
+            heavy: "heavy";
+        }>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const cardSystemSchema: z.ZodObject<{
     variants: z.ZodArray<z.ZodObject<{
@@ -164,6 +292,7 @@ export declare const cardSystemSchema: z.ZodObject<{
             comfortable: "comfortable";
             spacious: "spacious";
         }>;
+        foregroundToken: z.ZodOptional<z.ZodString>;
         shadow: z.ZodOptional<z.ZodObject<{
             elevation: z.ZodEnum<{
                 medium: "medium";
@@ -187,10 +316,55 @@ export declare const cardSystemSchema: z.ZodObject<{
             pill: "pill";
             soft: "soft";
         }>>;
+        cornerRadii: z.ZodOptional<z.ZodObject<{
+            topLeft: z.ZodOptional<z.ZodEnum<{
+                rounded: "rounded";
+                square: "square";
+                pill: "pill";
+                soft: "soft";
+                expressive: "expressive";
+            }>>;
+            topRight: z.ZodOptional<z.ZodEnum<{
+                rounded: "rounded";
+                square: "square";
+                pill: "pill";
+                soft: "soft";
+                expressive: "expressive";
+            }>>;
+            bottomLeft: z.ZodOptional<z.ZodEnum<{
+                rounded: "rounded";
+                square: "square";
+                pill: "pill";
+                soft: "soft";
+                expressive: "expressive";
+            }>>;
+            bottomRight: z.ZodOptional<z.ZodEnum<{
+                rounded: "rounded";
+                square: "square";
+                pill: "pill";
+                soft: "soft";
+                expressive: "expressive";
+            }>>;
+        }, z.core.$strip>>;
         border: z.ZodOptional<z.ZodObject<{
             widthClass: z.ZodString;
             colorToken: z.ZodString;
         }, z.core.$strip>>;
+        accentEdge: z.ZodOptional<z.ZodObject<{
+            edge: z.ZodEnum<{
+                left: "left";
+                right: "right";
+                top: "top";
+                bottom: "bottom";
+            }>;
+            colorToken: z.ZodString;
+            width: z.ZodEnum<{
+                medium: "medium";
+                thick: "thick";
+                thin: "thin";
+                heavy: "heavy";
+            }>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export interface CardVariant {
@@ -200,9 +374,12 @@ export interface CardVariant {
     priority: 1 | 2 | 3;
     background: CardBackground;
     spacing: CardSpacing;
+    foregroundToken?: string;
     shadow?: Shadow;
     corners?: 'square' | 'soft' | 'rounded' | 'pill';
+    cornerRadii?: CardCornerRadii;
     border?: CardBorder;
+    accentEdge?: CardAccentEdge;
 }
 export interface CardSystem {
     variants: CardVariant[];