@riverbankcms/sdk 0.138.0 → 0.140.0

package/dist/_dts/theme-core/src/site-styles/backgroundAppearance.d.ts

@@ -2,6 +2,6 @@ import { type ThemeColorToken } from '../tokens';
 export declare const backgroundAppearanceQuickColorTokenNames: readonly ["background", "surface", "muted", "primary", "secondary", "accent"];
 export declare const backgroundAppearanceBaseColorTokenNames: readonly ["background", "surface", "surfaceAlt", "muted", "primary", "secondary", "accent", "neutral"];
 export declare const backgroundAppearanceShadeableColorTokenNames: readonly ["primary", "secondary", "accent", "neutral"];
-export declare const backgroundAppearanceColorTokenNames: readonly ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-600" | "neutral-500" | "neutral-800" | "neutral-700" | "neutral-900" | "primary-500" | "primary-400" | "neutral-950" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "secondary-500" | "accent-400" | "neutral-50" | "neutral-100" | "neutral-200" | "neutral-300" | "secondary-400" | "neutral-400" | "primary-100" | "primary-800" | "primary-900" | "primary-700" | "primary-50" | "secondary-50" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
-export declare const backgroundAppearanceAdvancedColorTokenNames: ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-600" | "neutral-500" | "neutral-800" | "neutral-700" | "neutral-900" | "primary-500" | "primary-400" | "neutral-950" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "secondary-500" | "accent-400" | "neutral-50" | "neutral-100" | "neutral-200" | "neutral-300" | "secondary-400" | "neutral-400" | "primary-100" | "primary-800" | "primary-900" | "primary-700" | "primary-50" | "secondary-50" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
+export declare const backgroundAppearanceColorTokenNames: readonly ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-600" | "neutral-500" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "primary-100" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
+export declare const backgroundAppearanceAdvancedColorTokenNames: ("surface" | "background" | "primary" | "secondary" | "accent" | "surfaceAlt" | "muted" | "neutral" | "neutral-600" | "neutral-500" | "neutral-50" | "neutral-900" | "primary-50" | "primary-500" | "primary-900" | "secondary-50" | "secondary-500" | "secondary-900" | "accent-50" | "accent-500" | "accent-900" | "neutral-100" | "primary-400" | "neutral-300" | "neutral-950" | "neutral-800" | "neutral-700" | "primary-300" | "primary-600" | "secondary-600" | "accent-600" | "accent-400" | "neutral-200" | "secondary-400" | "neutral-400" | "primary-100" | "primary-800" | "primary-700" | "primary-200" | "primary-950" | "secondary-100" | "secondary-200" | "secondary-300" | "secondary-700" | "secondary-800" | "secondary-950" | "accent-100" | "accent-200" | "accent-300" | "accent-700" | "accent-800" | "accent-950")[];
 export declare function parseBackgroundAppearanceColorToken(value: unknown): ThemeColorToken | null;

package/dist/_dts/theme-core/src/surfaces/foregroundInteraction.d.ts

@@ -0,0 +1,77 @@
+import { type ThemeColorToken } from '../tokens';
+/**
+ * How far a hover state softens away from its resting foreground, as a
+ * percentage of full opacity.
+ *
+ * Softening — rather than brightening — is forced by the token vocabulary
+ * rather than chosen for taste. A resolved foreground is frequently an
+ * `on*` token, which `expandPalette` emits as pure `#FFFFFF` or `#000000`
+ * with no shade ramp: over a primary-painted section the resolved text role
+ * is `onPrimary`, and white has no headroom left to move further from its
+ * background. Moving *toward* the mid-range always has headroom, whatever
+ * the resting colour, and it keeps the hue exactly.
+ *
+ * 85% is the measured floor, not a round number. Softening costs contrast, and
+ * the binding case is a scrolled overlay header: `contrast-glass` paints 60%
+ * black or white, which composites the backdrop into a known band whatever the
+ * page content underneath happens to be. The lightest backdrop a dark glass can
+ * present is 60% black over white, `#666666`; a white foreground softened to
+ * 85% reads 4.69:1 there, against 4.07:1 at 75%, which fails. Nav links are
+ * 18px regular (`textSize: 'lg'`), so the bar is WCAG AA's 4.5:1 rather than
+ * the large-text 3:1.
+ *
+ * The mirror case — a light glass over dark content, `#999999` — cannot be met
+ * by any softening, because the *resting* colour is already only about 4.6:1
+ * there. That is a property of the glass rather than of this derivation, and
+ * it wants fixing where the glass tone is chosen.
+ */
+export declare const FOREGROUND_HOVER_OPACITY_PERCENT = 85;
+/**
+ * Derive the hover foreground that belongs with a resolved resting foreground.
+ *
+ * A resting foreground is chosen to be legible against a known surface. A hover
+ * state derived from it stays within a bounded distance of that colour, so it
+ * inherits most of the resting colour's contrast margin instead of asserting
+ * an unrelated brand colour that no one checked against the surface.
+ *
+ * That bounded-distance property is what lets this be used on a transparent
+ * overlay header, where the backdrop is only partly knowable: the scrolled
+ * state composites a 60% glass tint over arbitrary page content, so no
+ * compile-time contrast proof is available there. Staying near a colour that
+ * is already trusted in both states is a weaker claim than a contrast proof,
+ * and it is one this function can actually keep.
+ *
+ * Returns `null` when the resting token is not a plain palette token — an
+ * already-faded or raw value has no well-defined softening, and the caller
+ * should leave hover alone rather than guess.
+ */
+export declare function deriveForegroundHoverToken(restingToken: ThemeColorToken): ThemeColorToken | null;
+/** Flatten `foreground` at `alpha` over `background` into an opaque hex. */
+export declare function compositeHex(foreground: string, background: string, alpha: number): string;
+export type ForegroundHoverPlan = 
+/** Soften the resting colour; the derived token clears the conservative bound. */
+Readonly<{
+    kind: 'softened';
+    token: ThemeColorToken;
+}>
+/**
+ * Keep the resting colour. Softening it would drop below the ordinary-text
+ * ratio somewhere the glass can reach, so the hover affordance has to come
+ * from something other than colour.
+ */
+ | Readonly<{
+    kind: 'resting';
+}>;
+/**
+ * Decide whether the resting foreground can safely be softened for hover.
+ *
+ * `glassTone` is the scroll treatment's compiled tone, or `null` when the style
+ * has no glass. Without one there is no bound on what the header can end up
+ * over, so this declines to soften rather than guess.
+ *
+ * The light-glass end cannot be satisfied by any softening: against `#999999`
+ * a dark resting foreground is already close to the 4.5:1 line, so every step
+ * away from it fails. That is why this returns a plan rather than a colour —
+ * the caller has to have a non-colour affordance to fall back on.
+ */
+export declare function planForegroundHover(restingToken: ThemeColorToken, restingHex: string | null, glassTone: 'light' | 'dark' | null): ForegroundHoverPlan;

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

@@ -1,3 +1,4 @@
 export * from './foregroundContract';
+export * from './foregroundInteraction';
 export * from './foregroundRoles';
 export * from './resolveSurfaceForeground';

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

@@ -1,3 +1,4 @@
+import type { ExpandedPalette } from "../palette/expandPalette";
 export declare const colorTokens: readonly ["background/base", "background/elevated", "surface/base", "surface/subtle", "surface/inverted", "content/primary", "content/secondary", "accent/primary", "accent/secondary", "border/base"];
 export declare const typographyTokens: readonly ["display/hero", "display/section", "heading/large", "heading/medium", "heading/small", "body/normal", "body/small", "caption"];
 export declare const spacingTokens: readonly ["none", "3xs", "2xs", "xs", "sm", "md", "lg", "xl", "2xl", "3xl"];
@@ -16,3 +17,9 @@ export type ThemeTokens = {
     palette: Record<string, string>;
 };
 export declare const defaultThemeTokens: ThemeTokens;
+/**
+ * Project the expanded semantic palette into the token buckets consumed by
+ * runtime transforms. Keep this mapping shared by full themes and the
+ * tokens-only hosted-booking runtime so the two paths cannot drift.
+ */
+export declare function buildThemeTokens(palette: ExpandedPalette): ThemeTokens;

package/dist/_dts/theme-core/src/typography/generateTypographyCss.d.ts

@@ -7,7 +7,7 @@
 import type { Theme } from '../schema';
 export interface GenerateTypographyCssParams {
     themeId: string;
-    theme: Theme;
+    theme?: Theme;
 }
 /**
  * Generate typography CSS for heading elements.
@@ -19,4 +19,4 @@ export interface GenerateTypographyCssParams {
  *
  * Selectors use :where() for zero specificity, allowing site styles to override easily.
  */
-export declare function generateTypographyCss({ themeId }: GenerateTypographyCssParams): string;
+export declare function generateTypographyCss({ themeId, }: GenerateTypographyCssParams): string;

package/dist/_dts/ui/src/badge.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
 declare const badgeVariants: (props?: ({
-    variant?: "success" | "warning" | "default" | "secondary" | "destructive" | "outline" | null | undefined;
+    variant?: "success" | "default" | "warning" | "secondary" | "destructive" | "outline" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface BadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
 }

package/dist/_dts/ui/src/callout.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { type VariantProps } from 'class-variance-authority';
 declare const calloutVariants: (props?: ({
-    tone?: "success" | "warning" | "info" | "default" | "danger" | null | undefined;
+    tone?: "success" | "default" | "warning" | "info" | "danger" | null | undefined;
     layout?: "inline" | "banner" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type CalloutProps = React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof calloutVariants> & {

package/dist/_dts/ui/src/lib/use-delayed-flag.d.ts

@@ -0,0 +1,9 @@
+/**
+ * True once `active` has held for `delay` milliseconds.
+ *
+ * This is what keeps a spinner from flashing on an action that finishes
+ * quickly. It lives on its own so that anything drawing its own pending
+ * indicator gets the same timing rather than reimplementing it, and so the two
+ * cannot drift apart.
+ */
+export declare function useDelayedFlag(active: boolean, delay: number): boolean;

package/dist/_dts/ui/src/pending-button.d.ts

@@ -6,5 +6,15 @@ export interface PendingButtonProps extends ButtonProps {
     pendingLabel?: ReactNode;
     spinnerDelay?: number;
     spinnerProps?: Omit<DelayedSpinnerProps, 'active' | 'delay'>;
+    /**
+     * Draws the pending indicator instead of the default spinner, for surfaces
+     * with their own loading language.
+     *
+     * `visible` already has `spinnerDelay` applied, so a slot does not have to
+     * reimplement the delay and cannot flash on a fast action.
+     */
+    renderSpinner?: (state: Readonly<{
+        visible: boolean;
+    }>) => ReactNode;
 }
 export declare const PendingButton: import("react").ForwardRefExoticComponent<PendingButtonProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist/client/{BookingConsentAgreement-DQUik1Mx.mjs → BookingConsentAgreement-CuKa82V4.mjs}

@@ -1,8 +1,8 @@
 "use client";
-import { D as clsx } from "./colorStyles-CrxJrPjJ.mjs";
-import { Nt as assertNever$2, un as formatCurrencyAmount } from "./propsDecoder-CY9gGEF7.mjs";
-import { a as CheckIcon } from "./scrollToBlock--BFV6kl-.mjs";
-import { n as RichText } from "./checkoutUrls-BuseL0dw.mjs";
+import { O as clsx } from "./colorStyles-3013aRAY.mjs";
+import { Pt as assertNever$2, fn as formatCurrencyAmount } from "./propsDecoder-CB2KS_ko.mjs";
+import { a as CheckIcon } from "./scrollToBlock-B1IS1_ua.mjs";
+import { n as RichText } from "./checkoutUrls-FL6lRkrt.mjs";
 import { useCallback, useEffect, useReducer, useRef } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region ../core/src/date-math.ts

package/dist/client/{DiscountCodeDisclosure-CU67Q4vH.mjs → DiscountCodeDisclosure-BbYieKWB.mjs}

@@ -1,5 +1,5 @@
 "use client";
-import { ut as themeButtonClassName } from "./propsDecoder-CY9gGEF7.mjs";
+import { dt as themeButtonClassName } from "./propsDecoder-CB2KS_ko.mjs";
 import { useId } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region ../blocks/src/system/runtime/api/types/discounts.ts