@riverbankcms/sdk 0.130.2 → 0.132.0

package/dist/_dts/theme-core/src/buttons/styles/selection.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { type VariantRole } from '../types';
 export declare const BUTTON_STYLE_IDS: readonly ["soft-pill", "earth-pill", "confident-chip", "editorial-link", "pebble", "ink-stamp", "flat-ink", "brushed-wash", "showtime-pill", "joy-stamp", "ornate-ritual", "quiet-arrow"];
 export type ButtonStyleId = (typeof BUTTON_STYLE_IDS)[number];
 export declare const quietArrowParametersSchema: z.ZodObject<{
@@ -8,6 +9,38 @@ export declare const quietArrowParametersSchema: z.ZodObject<{
     }>;
 }, z.core.$strict>;
 export type QuietArrowParameters = z.infer<typeof quietArrowParametersSchema>;
+export declare const FLAT_INK_HOVER_TREATMENT_VALUES: readonly ["contextual", "secondary", "accent"];
+export declare const flatInkHoverTreatmentSchema: z.ZodEnum<{
+    accent: "accent";
+    secondary: "secondary";
+    contextual: "contextual";
+}>;
+export declare const flatInkHoverPreferencesSchema: z.ZodObject<Record<"outline" | "accent" | "primary" | "secondary" | "ghost", z.ZodOptional<z.ZodEnum<{
+    accent: "accent";
+    secondary: "secondary";
+    contextual: "contextual";
+}>>>, z.core.$strict>;
+export declare const flatInkParametersSchema: z.ZodObject<{
+    hoverPreferences: z.ZodOptional<z.ZodObject<Record<"outline" | "accent" | "primary" | "secondary" | "ghost", z.ZodOptional<z.ZodEnum<{
+        accent: "accent";
+        secondary: "secondary";
+        contextual: "contextual";
+    }>>>, z.core.$strict>>;
+}, z.core.$strict>;
+export type FlatInkHoverTreatment = z.infer<typeof flatInkHoverTreatmentSchema>;
+export type FlatInkParameters = z.infer<typeof flatInkParametersSchema>;
+export type ButtonHoverTreatmentPreference = Readonly<{
+    kind: 'recommended';
+}> | Readonly<{
+    kind: 'explicit';
+    treatment: Readonly<{
+        kind: 'contextual-shade-shift';
+    }> | Readonly<{
+        kind: 'palette-role';
+        role: 'secondary' | 'accent';
+    }>;
+}>;
+export type ButtonHoverPreferences = Readonly<Record<VariantRole, ButtonHoverTreatmentPreference>>;
 export declare const buttonStyleSelectionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     styleId: z.ZodLiteral<"soft-pill">;
     parameters: z.ZodObject<{}, z.core.$strict>;
@@ -28,7 +61,13 @@ export declare const buttonStyleSelectionSchema: z.ZodDiscriminatedUnion<[z.ZodO
     parameters: z.ZodObject<{}, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     styleId: z.ZodLiteral<"flat-ink">;
-    parameters: z.ZodObject<{}, z.core.$strict>;
+    parameters: z.ZodObject<{
+        hoverPreferences: z.ZodOptional<z.ZodObject<Record<"outline" | "accent" | "primary" | "secondary" | "ghost", z.ZodOptional<z.ZodEnum<{
+            accent: "accent";
+            secondary: "secondary";
+            contextual: "contextual";
+        }>>>, z.core.$strict>>;
+    }, z.core.$strict>;
 }, z.core.$strict>, z.ZodObject<{
     styleId: z.ZodLiteral<"brushed-wash">;
     parameters: z.ZodObject<{}, z.core.$strict>;
@@ -62,9 +101,18 @@ export declare function createDefaultButtonStyleSelection(styleId: ButtonStyleId
 export declare function isButtonStyleId(value: string): value is ButtonStyleId;
 export type PersistedButtonStyleSelectionResult = Readonly<{
     selection: ButtonStyleSelection;
-    warning: 'invalid-persisted-button-style-selection' | null;
+    warning: 'invalid-persisted-button-style-selection' | 'repaired-persisted-button-style-selection' | null;
+    repairs: readonly ButtonStyleSelectionRepair[];
+}>;
+export type ButtonStyleSelectionRepair = Readonly<{
+    kind: 'repaired-option';
+    styleId: ButtonStyleId;
+    parameter: string;
+    role: VariantRole | null;
+    reason: 'invalid-option-shape' | 'unsupported-option';
 }>;
 export declare function parsePersistedButtonStyleSelection(value: unknown, fallback?: ButtonStyleSelection): PersistedButtonStyleSelectionResult;
+export declare function normalizeFlatInkHoverPreferences(parameters: FlatInkParameters): ButtonHoverPreferences;
 /**
  * Stable identity for a validated style selection. Parsing first canonicalises
  * parameter key order, so future recipe parameters do not require editor-core

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

@@ -117,6 +117,16 @@ export type ButtonColourTreatment = {
     role: 'link';
 };
 export type ButtonBackground = ButtonColourTreatment;
+export declare const contextualButtonHoverSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"shade-shift">;
+    seedToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
+    fallbackDirection: z.ZodEnum<{
+        lighter: "lighter";
+        darker: "darker";
+    }>;
+    preferredToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+}, z.core.$strict>;
+export type ContextualButtonHover = z.infer<typeof contextualButtonHoverSchema>;
 /**
  * The complete persisted button-effect contract.
  *
@@ -1115,6 +1125,15 @@ export declare const buttonVariantSchema: z.ZodObject<{
         widthClass: z.ZodString;
     }, z.core.$strict>>;
     hoverBackgroundToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+    contextualHover: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"shade-shift">;
+        seedToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
+        fallbackDirection: z.ZodEnum<{
+            lighter: "lighter";
+            darker: "darker";
+        }>;
+        preferredToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+    }, z.core.$strict>>;
     effects: z.ZodOptional<z.ZodObject<{
         base: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             effectId: z.ZodLiteral<"darken-background">;
@@ -1749,6 +1768,15 @@ export declare const buttonSystemSchema: z.ZodObject<{
             widthClass: z.ZodString;
         }, z.core.$strict>>;
         hoverBackgroundToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+        contextualHover: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"shade-shift">;
+            seedToken: z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>;
+            fallbackDirection: z.ZodEnum<{
+                lighter: "lighter";
+                darker: "darker";
+            }>;
+            preferredToken: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<OpaqueButtonColourToken, string>>>;
+        }, z.core.$strict>>;
         effects: z.ZodOptional<z.ZodObject<{
             base: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 effectId: z.ZodLiteral<"darken-background">;
@@ -2350,6 +2378,7 @@ export interface ButtonVariant {
     shadow?: Shadow;
     border?: ButtonBorder;
     hoverBackgroundToken?: OpaqueButtonColourToken;
+    contextualHover?: ContextualButtonHover;
     effects?: VariantEffects;
     /** Per-variant size overrides. See VariantSizeOverrides. */
     sizes?: VariantSizeOverrides;

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

@@ -17,7 +17,6 @@ export declare const boxlessCardVariantValue: "none";
 export declare const openCardRoleValue: "open";
 export type CardVariantRole = (typeof cardVariantRoleValues)[number];
 export type BoxlessCardVariant = typeof boxlessCardVariantValue;
-export type BoxStylesCardVariant = CardVariantRole | BoxlessCardVariant;
 /**
  * The roles a site style implements with an actual card variant. `none` is
  * deliberately absent: it is a role value only, never a variant.
@@ -25,8 +24,8 @@ export type BoxStylesCardVariant = CardVariantRole | BoxlessCardVariant;
 export declare const surfaceCardRoleValues: readonly ["default", "alternative", "open"];
 export type SurfaceCardRole = (typeof surfaceCardRoleValues)[number];
 /**
- * The closed card-role vocabulary Looks and blocks address cards by — this is
- * `BoxStylesCardVariant` widened with `open`, not a parallel enum.
+ * The closed role vocabulary Looks and blocks use for surfaced and boxless
+ * card choices.
  *
  * - `none`        — no site-style card surface; the block's own composition and
  *                   the author's own card fields govern the item. This is *not*
@@ -39,12 +38,6 @@ export type SurfaceCardRole = (typeof surfaceCardRoleValues)[number];
  */
 export declare const cardRoleValues: readonly ["default", "alternative", "open", "none"];
 export type CardRole = (typeof cardRoleValues)[number];
-export declare const legacyCardVariantRoleAliases: {
-    readonly variant1: "alternative";
-    readonly variant2: "alternative";
-    readonly statement: "alternative";
-};
-export type LegacyCardVariantRoleAlias = keyof typeof legacyCardVariantRoleAliases;
 export type CardBackground = {
     type: 'solid';
     colorToken: string;
@@ -144,25 +137,10 @@ export declare const cardRoleSchema: z.ZodEnum<{
     none: "none";
     alternative: "alternative";
 }>;
-/**
- * Historical name for the role vocabulary as it reaches box styles. Widened to
- * the full `CardRole` set — old values keep parsing, `open` now parses too.
- */
-export declare const boxStylesCardVariantSchema: z.ZodEnum<{
-    open: "open";
-    default: "default";
-    none: "none";
-    alternative: "alternative";
-}>;
 export declare function isCardVariantRole(value: unknown): value is CardVariantRole;
 export declare function normalizeCardVariantRole(value: unknown): CardVariantRole | null;
-/**
- * The one untrusted-input boundary for the role vocabulary. Legacy alias values
- * (`variant1`, `variant2`, `statement`) normalize here and nowhere else.
- */
+/** The one untrusted-input boundary for the closed role vocabulary. */
 export declare function normalizeCardRole(value: unknown): CardRole | null;
-/** Historical name for {@link normalizeCardRole}. */
-export declare const normalizeBoxStylesCardVariant: typeof normalizeCardRole;
 /**
  * Role inference for legacy card systems authored before variants carried a
  * `role`. Priority 1 is the everyday card, priority 2 the statement card —