@riverbankcms/sdk 0.129.0 → 0.130.0

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

@@ -58,6 +58,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "earth-pill";
@@ -116,6 +117,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "confident-chip";
@@ -174,6 +176,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "editorial-link";
@@ -232,6 +235,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "pebble";
@@ -290,6 +294,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "ink-stamp";
@@ -348,6 +353,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "flat-ink";
@@ -406,6 +412,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "brushed-wash";
@@ -464,6 +471,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "showtime-pill";
@@ -522,6 +530,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "joy-stamp";
@@ -580,6 +589,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "ornate-ritual";
@@ -638,6 +648,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>, Readonly<{
     id: "quiet-arrow";
@@ -704,6 +715,7 @@ export declare const buttonStyleRecipes: readonly [Readonly<{
                 overrides?: Partial<import("./domain").ButtonVariantAppearance>;
             }>;
         }>;
+        surfacePolicy?: import("..").ButtonSurfacePolicy;
     }>;
 }>];
 export type RegisteredButtonStyleRecipe = (typeof buttonStyleRecipes)[number];

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

@@ -60,6 +60,11 @@ export declare const DEFAULT_BUTTON_STYLE_SELECTION: {
 };
 export declare function createDefaultButtonStyleSelection(styleId: ButtonStyleId): ButtonStyleSelection;
 export declare function isButtonStyleId(value: string): value is ButtonStyleId;
+export type PersistedButtonStyleSelectionResult = Readonly<{
+    selection: ButtonStyleSelection;
+    warning: 'invalid-persisted-button-style-selection' | null;
+}>;
+export declare function parsePersistedButtonStyleSelection(value: unknown, fallback?: ButtonStyleSelection): PersistedButtonStyleSelectionResult;
 /**
  * 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

@@ -6,9 +6,9 @@ import { type ThemeColorToken } from '../tokens/themeColorTokens';
  * Defines the type-safe configuration for site button styles.
  */
 export type Shadow = {
-    elevation: "none" | "low" | "medium" | "high";
-    softness: "crisp" | "soft" | "hard" | null;
-    position: "bottom" | "bottom-right";
+    elevation: 'none' | 'low' | 'medium' | 'high';
+    softness: 'crisp' | 'soft' | 'hard' | null;
+    position: 'bottom' | 'bottom-right';
     /**
      * Optional palette token for the shadow colour. When omitted the shadow
      * falls back to the historical neutral black (`rgb(0 0 0 / …)`), so existing
@@ -105,7 +105,11 @@ export type ButtonColourTreatment = {
     colorToken: OpaqueButtonColourToken;
 } | {
     type: 'gradient';
-    stops: [OpaqueButtonColourToken, OpaqueButtonColourToken, ...OpaqueButtonColourToken[]];
+    stops: [
+        OpaqueButtonColourToken,
+        OpaqueButtonColourToken,
+        ...OpaqueButtonColourToken[]
+    ];
     direction: GradientDirection;
     foregroundToken: OpaqueButtonColourToken;
 } | {
@@ -313,6 +317,35 @@ export declare const variantRoleSchema: z.ZodEnum<{
     secondary: "secondary";
     ghost: "ghost";
 }>;
+export declare const buttonSurfaceFallbackSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"surface-outline">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"variant">;
+    role: z.ZodEnum<{
+        outline: "outline";
+        accent: "accent";
+        primary: "primary";
+        secondary: "secondary";
+        ghost: "ghost";
+    }>;
+}, z.core.$strict>], "kind">;
+export type ButtonSurfaceFallback = z.infer<typeof buttonSurfaceFallbackSchema>;
+export type ButtonSurfacePolicy = Record<VariantRole, ButtonSurfaceFallback[]>;
+type ReadonlyButtonSurfacePolicy = Readonly<Record<VariantRole, readonly ButtonSurfaceFallback[]>>;
+export declare const STANDARD_BUTTON_SURFACE_POLICY: ReadonlyButtonSurfacePolicy;
+export declare function createStandardButtonSurfacePolicy(): ButtonSurfacePolicy;
+export declare const buttonSurfacePolicySchema: z.ZodObject<Record<"outline" | "accent" | "primary" | "secondary" | "ghost", z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"surface-outline">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"variant">;
+    role: z.ZodEnum<{
+        outline: "outline";
+        accent: "accent";
+        primary: "primary";
+        secondary: "secondary";
+        ghost: "ghost";
+    }>;
+}, z.core.$strict>], "kind">>>, z.core.$strict>;
 export declare const buttonSizeNameSchema: z.ZodEnum<{
     sm: "sm";
     md: "md";
@@ -2240,6 +2273,18 @@ export declare const buttonSystemSchema: z.ZodObject<{
             fontSize?: string | undefined;
         } | undefined;
     }>>>;
+    surfacePolicy: z.ZodOptional<z.ZodObject<Record<"outline" | "accent" | "primary" | "secondary" | "ghost", z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"surface-outline">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"variant">;
+        role: z.ZodEnum<{
+            outline: "outline";
+            accent: "accent";
+            primary: "primary";
+            secondary: "secondary";
+            ghost: "ghost";
+        }>;
+    }, z.core.$strict>], "kind">>>, z.core.$strict>>;
 }, z.core.$strict>;
 export type Priority = 1 | 2 | 3;
 interface ButtonGlobalSettingsBase {
@@ -2315,5 +2360,7 @@ export interface ButtonSystem {
     global: ButtonGlobalSettings;
     variants: ButtonVariant[];
     sizes?: ButtonSizes;
+    /** Optional only for pre-policy in-memory fixtures; persistence canonicalizes it. */
+    surfacePolicy?: ButtonSurfacePolicy;
 }
 export {};