@riverbankcms/sdk 0.139.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/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/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-CZvTDtsK.mjs → BookingConsentAgreement-CuKa82V4.mjs}

@@ -1,8 +1,8 @@
 "use client";
-import { D as clsx } from "./colorStyles-CrxJrPjJ.mjs";
-import { Nt as assertNever$2, dn as formatCurrencyAmount } from "./propsDecoder-DYzafZb2.mjs";
-import { a as CheckIcon } from "./scrollToBlock-CvXszexS.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-D-DsLCMU.mjs → DiscountCodeDisclosure-BbYieKWB.mjs}

@@ -1,5 +1,5 @@
 "use client";
-import { ut as themeButtonClassName } from "./propsDecoder-DYzafZb2.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

package/dist/client/{EventCombined.client-dWqgd5ZO.mjs → EventCombined.client-LTfR1Aby.mjs}

@@ -1,10 +1,10 @@
 "use client";
-import { D as clsx } from "./colorStyles-CrxJrPjJ.mjs";
-import { $ as getOrderedDayNames, B as buildEventRuntimeFilters, F as calendarWindowBounds, G as getCardOrientation, I as calendarWindowMonths$1, K as getContainerClass, M as calendarMonthDate, N as calendarPageResponseError, P as calendarQueryKey, Q as getDayOfWeek, R as planCalendarMonthRanges, V as getEventRuntimeFiltersKey, X as buildCalendarViewport, Y as addMonths, Yt as formatLocalScheduleDate, Z as formatDateKey, Zt as getLocalScheduleDate, nt as isToday, q as MONTH_NAMES, rt as shiftCalendarAnchorDate, tt as isSameCalendarDay, ut as themeButtonClassName } from "./propsDecoder-DYzafZb2.mjs";
-import { a as EventCardClient, i as EventPaginatedListView, n as useEventPagination, o as EventFilters, r as toError, s as formatEventTeacherLine, t as useEventFilters } from "./useEventFilters-oMoTw_JE.mjs";
-import { o as formatEventRemainingPlaces, p as isEventFull, t as formatEventPrice } from "./pricing-Uzw-GQ6Y.mjs";
-import { a as formatTime, d as resolveEventLinkProps, o as groupEventsByDate, s as resolveEventTimeZone, t as formatDate, u as resolveEventCta } from "./dates-wnPMiRl5.mjs";
-import { n as useBlockApi } from "./context-DvU_WUmd.mjs";
+import { O as clsx } from "./colorStyles-3013aRAY.mjs";
+import { $ as getDayOfWeek, F as calendarQueryKey, H as getEventRuntimeFiltersKey, I as calendarWindowBounds, J as MONTH_NAMES, K as getCardOrientation, L as calendarWindowMonths$1, N as calendarMonthDate, P as calendarPageResponseError, Q as formatDateKey, Qt as getLocalScheduleDate, V as buildEventRuntimeFilters, X as addMonths, Xt as formatLocalScheduleDate, Z as buildCalendarViewport, dt as themeButtonClassName, et as getOrderedDayNames, it as shiftCalendarAnchorDate, nt as isSameCalendarDay, q as getContainerClass, rt as isToday, z as planCalendarMonthRanges } from "./propsDecoder-CB2KS_ko.mjs";
+import { a as EventCardClient, i as EventPaginatedListView, n as useEventPagination, o as EventFilters, r as toError, s as formatEventTeacherLine, t as useEventFilters } from "./useEventFilters-DzIUcS9n.mjs";
+import { o as formatEventRemainingPlaces, p as isEventFull, t as formatEventPrice } from "./pricing-Copadu-2.mjs";
+import { a as formatTime, d as resolveEventLinkProps, o as groupEventsByDate, s as resolveEventTimeZone, t as formatDate, u as resolveEventCta } from "./dates-aDcfoLHr.mjs";
+import { n as useBlockApi } from "./context-Cy1OayHx.mjs";
 import { t as createBodyThemePortalRoot } from "./themePortalRoot-AGs4cE7t.mjs";
 import { t as ModalShell } from "./ModalShell-CqkBvBIC.mjs";
 import React, { createContext, useCallback, useContext, useEffect, useId, useMemo, useRef, useState } from "react";

package/dist/client/{EventListing.client-BMRa9IYp.mjs → EventListing.client-DUHpYSuo.mjs}

@@ -1,6 +1,6 @@
 "use client";
-import { B as buildEventRuntimeFilters } from "./propsDecoder-DYzafZb2.mjs";
-import { i as EventPaginatedListView, n as useEventPagination, o as EventFilters, t as useEventFilters } from "./useEventFilters-oMoTw_JE.mjs";
+import { V as buildEventRuntimeFilters } from "./propsDecoder-CB2KS_ko.mjs";
+import { i as EventPaginatedListView, n as useEventPagination, o as EventFilters, t as useEventFilters } from "./useEventFilters-DzIUcS9n.mjs";
 import { useId, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region ../blocks/src/system/runtime/nodes/events/EventListing.client.tsx

package/dist/client/{LeafletStaticMap-D21W9kBZ.mjs → LeafletStaticMap-CHRupL6m.mjs}

@@ -1,5 +1,5 @@
 "use client";
-import { Mt as isRecord } from "./propsDecoder-DYzafZb2.mjs";
+import { Nt as isRecord } from "./propsDecoder-CB2KS_ko.mjs";
 import { useEffect, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region ../blocks/src/system/runtime/nodes/shared/LeafletStaticMap.tsx

package/dist/client/{accordion-FxF_ta47.mjs → accordion-6HiIFxNL.mjs}

@@ -1,4 +1,4 @@
-import { t as defineIslandPropsDecoder } from "./propsDecoder-DYzafZb2.mjs";
+import { t as defineIslandPropsDecoder } from "./propsDecoder-CB2KS_ko.mjs";
 //#region src/rendering/islands/enhancers/accordion.ts
 const decode = defineIslandPropsDecoder("accordion");
 function parseDefaultValues(value) {

package/dist/client/{bookingForm-YnwW4TGw.mjs → bookingForm-Dlmid43H.mjs}

@@ -1,14 +1,14 @@
 "use client";
-import { S as unsafeAsPassId, _ as unsafeAsAppointmentResourceId, b as unsafeAsFormId, v as unsafeAsAppointmentServiceId, y as unsafeAsCustomerPassId } from "./colorStyles-CrxJrPjJ.mjs";
-import { a as buildBookingPaymentSelectionViewModel, i as usePolling, n as StepIndicator, r as SpinnerNode, t as BookingConsentAgreement } from "./BookingConsentAgreement-CZvTDtsK.mjs";
-import { $t as resolveBookingTimeZoneId, At as isBookingRequirementConsentFieldId, Ct as resolveBookingPaymentStep, Dt as projectSelectedAppointmentConsentIntoForm, Et as toSelectedCollectionOptionKind, Ft as err, Lt as okWith, Nt as assertNever, Ot as resolveSelectedAppointmentConsent, Pt as clearWorkflowFeedback, Qt as parseBookingLocalDate, Rt as reportWorkflowError, St as resolveAppointmentCheckoutVerificationState, Tt as resolveDefaultBookingServiceId, Ut as addLocalScheduleDays, Yt as formatLocalScheduleDate, _t as getBookingServiceSlidingScale, bt as parseBookingCurrencyInputToCents, dn as formatCurrencyAmount, ft as logger, gt as getBookingRedirectStateFromLocation, ht as formatBookingSubmissionPreparationError, kt as BOOKING_FORM_DATA_RESERVED_KEYS, mt as formatBookingCentsAsCurrencyInput, pt as deriveBookingFormViewState, qt as formatBookingInstant, t as defineIslandPropsDecoder, ut as themeButtonClassName, vt as getBookingSuccessMessage, wt as resolveBookingSiteId, xt as prepareBookingSubmission, yt as isBookingServiceSlidingAmountInRange, zt as reportWorkflowSuccess } from "./propsDecoder-DYzafZb2.mjs";
-import { n as useBlockApi, t as BlockApiProvider } from "./context-DvU_WUmd.mjs";
+import { C as unsafeAsPassId, b as unsafeAsCustomerPassId, v as unsafeAsAppointmentResourceId, x as unsafeAsFormId, y as unsafeAsAppointmentServiceId } from "./colorStyles-3013aRAY.mjs";
+import { a as buildBookingPaymentSelectionViewModel, i as usePolling, n as StepIndicator, r as SpinnerNode, t as BookingConsentAgreement } from "./BookingConsentAgreement-CuKa82V4.mjs";
+import { $t as parseBookingLocalDate, At as BOOKING_FORM_DATA_RESERVED_KEYS, Bt as reportWorkflowSuccess, Ct as resolveAppointmentCheckoutVerificationState, Dt as toSelectedCollectionOptionKind, Et as resolveDefaultBookingServiceId, Ft as clearWorkflowFeedback, It as err, Jt as formatBookingInstant, Ot as projectSelectedAppointmentConsentIntoForm, Pt as assertNever, Rt as okWith, St as prepareBookingSubmission, Tt as resolveBookingSiteId, Wt as addLocalScheduleDays, Xt as formatLocalScheduleDate, _t as getBookingRedirectStateFromLocation, bt as isBookingServiceSlidingAmountInRange, dt as themeButtonClassName, en as resolveBookingTimeZoneId, fn as formatCurrencyAmount, gt as formatBookingSubmissionPreparationError, ht as formatBookingCentsAsCurrencyInput, jt as isBookingRequirementConsentFieldId, kt as resolveSelectedAppointmentConsent, mt as deriveBookingFormViewState, pt as logger, t as defineIslandPropsDecoder, vt as getBookingServiceSlidingScale, wt as resolveBookingPaymentStep, xt as parseBookingCurrencyInputToCents, yt as getBookingSuccessMessage, zt as reportWorkflowError } from "./propsDecoder-CB2KS_ko.mjs";
+import { n as useBlockApi, t as BlockApiProvider } from "./context-Cy1OayHx.mjs";
 import { n as isSpamProtectionEnabled, r as AltchaWidget, t as getChallengeUrl } from "./src-B833rYRr.mjs";
-import { a as CheckIcon, i as StateIcon, n as useDiscountCodeUi, r as TerminalPanel, t as scrollToBlock } from "./scrollToBlock-CvXszexS.mjs";
-import { t as DiscountCodeDisclosure } from "./DiscountCodeDisclosure-D-DsLCMU.mjs";
+import { a as CheckIcon, i as StateIcon, n as useDiscountCodeUi, r as TerminalPanel, t as scrollToBlock } from "./scrollToBlock-B1IS1_ua.mjs";
+import { t as DiscountCodeDisclosure } from "./DiscountCodeDisclosure-BbYieKWB.mjs";
 import { t as FeedbackMessage } from "./FeedbackMessage-CtLvvS_d.mjs";
 import { n as getFieldValidationControlProps, t as FieldValidationMessage } from "./FieldValidationMessage-AYanWFb-.mjs";
-import { t as buildCheckoutReturnUrls } from "./checkoutUrls-BuseL0dw.mjs";
+import { t as buildCheckoutReturnUrls } from "./checkoutUrls-FL6lRkrt.mjs";
 import { t as mountReactIsland } from "./reactMount-SY8AVRof.mjs";
 import { t as buildRouteIslandApiConfig } from "./routeIslandApiConfig-UNsfPcYq.mjs";
 import React, { useCallback, useEffect, useLayoutEffect, useMemo, useReducer, useRef, useState } from "react";