@riverbankcms/sdk 0.130.0 → 0.132.0

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/eventCollectionContract.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { type CardRole } from "../../../../../../../theme-core/src/cards/index";
 import type { ButtonVariant, CalendarTabViews, CalendarView, ColumnOption, EventLayout, EventScheduleScope, EventSurfaceScope, FilterAutoShow, PublicEvent, WeekStart } from "../../../../blocks/events/shared/types";
 import { type EventListPaginationAction, type EventListPaginationMode, type EventPageSize } from "./listOptions";
 import type { EventListingDisplay } from "../EventListing.interactive";
@@ -29,6 +30,7 @@ export type EventCollectionSourceProps = Readonly<{
     showVenue?: boolean | null;
     showMap?: boolean | null;
     showCapacity?: boolean | null;
+    cardRole?: CardRole;
     buttonVariant?: ButtonVariant;
     buttonText?: string;
     emptyMessage?: string;
@@ -56,6 +58,7 @@ export type EventCollectionDisplay = Readonly<{
     showVenue: boolean;
     showMap: boolean;
     showCapacity: boolean;
+    cardRole: CardRole;
     buttonVariant: ButtonVariant;
     buttonText: string;
     emptyMessage: string;
@@ -97,6 +100,12 @@ export declare const eventCollectionSourceSchemaShape: {
     readonly showVenue: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showMap: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     readonly showCapacity: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    readonly cardRole: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        default: "default";
+        none: "none";
+        alternative: "alternative";
+    }>>;
     readonly buttonVariant: z.ZodOptional<z.ZodEnum<{
         outline: "outline";
         accent: "accent";
@@ -138,10 +147,11 @@ export declare const eventCollectionSourceSchemaShape: {
         eventPreset: z.ZodOptional<z.ZodEnum<{
             course: "course";
             event: "event";
-            performance: "performance";
             class: "class";
+            term: "term";
             workshop: "workshop";
             retreat: "retreat";
+            performance: "performance";
         }>>;
         eventDestinationMode: z.ZodOptional<z.ZodEnum<{
             "cms-managed": "cms-managed";
@@ -452,6 +462,24 @@ export declare const eventCollectionSourceSchemaShape: {
             label: z.ZodString;
         }, z.core.$strip>], "kind">;
         requiresRegistration: z.ZodBoolean;
+        bookingAvailability: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"open">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"closed">;
+            reason: z.ZodEnum<{
+                occurrence_cancelled: "occurrence_cancelled";
+                occurrence_completed: "occurrence_completed";
+                series_draft: "series_draft";
+                series_cancelled: "series_cancelled";
+                series_completed: "series_completed";
+                series_archived: "series_archived";
+                parent_archived: "parent_archived";
+                parent_inconsistent: "parent_inconsistent";
+                not_public: "not_public";
+                already_started: "already_started";
+                enrollment_closed: "enrollment_closed";
+            }>;
+        }, z.core.$strip>], "kind">;
         deliveryMode: z.ZodEnum<{
             in_person: "in_person";
             hybrid: "hybrid";
@@ -498,6 +526,8 @@ export declare const eventCollectionSourceSchemaShape: {
             active: "active";
             draft: "draft";
             archived: "archived";
+            completed: "completed";
+            cancelled: "cancelled";
         }>>;
         timeZone: z.ZodString;
         pricing: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -845,10 +875,11 @@ export declare const eventCollectionDisplaySchemaShape: {
         eventPreset: z.ZodOptional<z.ZodEnum<{
             course: "course";
             event: "event";
-            performance: "performance";
             class: "class";
+            term: "term";
             workshop: "workshop";
             retreat: "retreat";
+            performance: "performance";
         }>>;
         eventDestinationMode: z.ZodOptional<z.ZodEnum<{
             "cms-managed": "cms-managed";
@@ -1159,6 +1190,24 @@ export declare const eventCollectionDisplaySchemaShape: {
             label: z.ZodString;
         }, z.core.$strip>], "kind">;
         requiresRegistration: z.ZodBoolean;
+        bookingAvailability: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"open">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"closed">;
+            reason: z.ZodEnum<{
+                occurrence_cancelled: "occurrence_cancelled";
+                occurrence_completed: "occurrence_completed";
+                series_draft: "series_draft";
+                series_cancelled: "series_cancelled";
+                series_completed: "series_completed";
+                series_archived: "series_archived";
+                parent_archived: "parent_archived";
+                parent_inconsistent: "parent_inconsistent";
+                not_public: "not_public";
+                already_started: "already_started";
+                enrollment_closed: "enrollment_closed";
+            }>;
+        }, z.core.$strip>], "kind">;
         deliveryMode: z.ZodEnum<{
             in_person: "in_person";
             hybrid: "hybrid";
@@ -1205,6 +1254,8 @@ export declare const eventCollectionDisplaySchemaShape: {
             active: "active";
             draft: "draft";
             archived: "archived";
+            completed: "completed";
+            cancelled: "cancelled";
         }>>;
         timeZone: z.ZodString;
         pricing: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -1557,6 +1608,12 @@ export declare const eventCollectionDisplaySchemaShape: {
     readonly showVenue: z.ZodBoolean;
     readonly showMap: z.ZodBoolean;
     readonly showCapacity: z.ZodBoolean;
+    readonly cardRole: z.ZodEnum<{
+        open: "open";
+        default: "default";
+        none: "none";
+        alternative: "alternative";
+    }>;
     readonly buttonVariant: z.ZodEnum<{
         outline: "outline";
         accent: "accent";

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/utils.d.ts

@@ -6,7 +6,10 @@ import type { CardOrientation, EventLayout, PublicEvent } from '../../../../bloc
 /** Day names starting from Sunday — kept for back-compat re-export. */
 export { DAY_NAMES, MONTH_NAMES } from '../../../../../../../calendar/src/index';
 export type { WeekStart } from '../../../../../../../calendar/src/index';
-/** Column class mappings for grid layouts */
+/**
+ * Column class mappings for grid layouts, derived from the canonical
+ * responsive column ladder (see gridUserColumnLadder).
+ */
 export declare const COLUMN_CLASSES: Record<string, string>;
 /**
  * Build container class based on layout mode

package/dist/_dts/blocks/src/system/runtime/nodes/shared/MagicLinkForm.d.ts

@@ -13,7 +13,7 @@ export type MagicLinkFormProps = {
     /** Called when successfully sent (optional) */
     onSuccess?: () => void;
     /** CSS class prefix for styling (e.g., 'cp' for customer portal, 'er' for event registration, 'cr' for course registration) */
-    classPrefix?: 'cp' | 'er' | 'cr';
+    classPrefix?: 'cp' | 'er' | 'cr' | 'er-whole-series';
     /** Whether to show compact/inline styling */
     compact?: boolean;
 };

package/dist/_dts/blocks/src/system/runtime/shared/components/DiscountCodeDisclosure.d.ts

@@ -1,18 +1,18 @@
 import type React from 'react';
-type BlockDiscountCodeSurface = 'course-registration' | 'event-registration';
+type BlockDiscountCodeSurface = 'event-registration' | 'whole-series-registration';
 export type DiscountCodeDisclosureSurface = BlockDiscountCodeSurface | 'theme-form';
 export declare const BLOCK_DISCOUNT_CODE_DISCLOSURE_CLASSES: {
-    readonly 'course-registration': {
-        readonly root: "cr-discount";
-        readonly toggle: "cr-discount__toggle";
-        readonly form: "cr-discount__form";
-        readonly label: "cr-discount__label";
-        readonly row: "cr-discount__row";
-        readonly input: "cr-discount__input";
-        readonly apply: "cr-discount__apply";
-        readonly remove: "cr-discount__remove";
-        readonly hint: "cr-discount__hint";
-        readonly feedback: "cr-discount__feedback";
+    readonly 'whole-series-registration': {
+        readonly root: "er-whole-series-discount";
+        readonly toggle: "er-whole-series-discount__toggle";
+        readonly form: "er-whole-series-discount__form";
+        readonly label: "er-whole-series-discount__label";
+        readonly row: "er-whole-series-discount__row";
+        readonly input: "er-whole-series-discount__input";
+        readonly apply: "er-whole-series-discount__apply";
+        readonly remove: "er-whole-series-discount__remove";
+        readonly hint: "er-whole-series-discount__hint";
+        readonly feedback: "er-whole-series-discount__feedback";
     };
     readonly 'event-registration': {
         readonly root: "er-discount";

package/dist/_dts/blocks/src/system/runtime/shared/components/FeedbackMessage.d.ts

@@ -1,8 +1,24 @@
 import type { ReactNode } from 'react';
 export type FeedbackTone = 'info' | 'success' | 'warning' | 'error';
 export type FeedbackLiveMode = 'off' | 'polite' | 'assertive';
+/**
+ * How loudly a feedback message presents itself. Orthogonal to tone: tone says
+ * what kind of message it is, treatment says how much room it takes up.
+ *
+ * - `panel` — the alert box. The default, and what every existing call site
+ *   gets. Suits a genuine failure: a declined payment, a lost submission.
+ * - `field-note` — a quiet margin note attached to the control or group it
+ *   describes. Suits inline validation, where the user has simply not finished
+ *   something yet.
+ *
+ * Site styles own each treatment's appearance; the CSS is generated in
+ * theme-core (`status/generateStatusCss.ts`) from theme tokens, so a block
+ * only ever names the treatment.
+ */
+export type FeedbackTreatment = 'panel' | 'field-note';
 export type FeedbackMessageProps = Readonly<{
     tone: FeedbackTone;
+    treatment?: FeedbackTreatment;
     children: ReactNode;
     className?: string;
     id?: string;
@@ -12,4 +28,4 @@ export type FeedbackMessageProps = Readonly<{
     role?: 'alert' | 'status';
     live?: FeedbackLiveMode;
 }>;
-export declare function FeedbackMessage({ tone, children, className, id, title, titleClassName, bodyClassName, role, live, }: FeedbackMessageProps): import("react").JSX.Element;
+export declare function FeedbackMessage({ tone, treatment, children, className, id, title, titleClassName, bodyClassName, role, live, }: FeedbackMessageProps): import("react").JSX.Element;

package/dist/_dts/blocks/src/system/runtime/shared/components/index.d.ts

@@ -15,7 +15,7 @@ export type { BookingOptionGroupViewModel, BookingOptionListProps, } from './Boo
 export { FieldValidationMessage, getFieldValidationControlProps, } from './FieldValidationMessage';
 export type { FieldValidationControlInput, FieldValidationControlProps, FieldValidationMessageProps, } from './FieldValidationMessage';
 export { FeedbackMessage } from './FeedbackMessage';
-export type { FeedbackLiveMode, FeedbackMessageProps, FeedbackTone } from './FeedbackMessage';
+export type { FeedbackLiveMode, FeedbackMessageProps, FeedbackTone, FeedbackTreatment, } from './FeedbackMessage';
 export { LoggedInAsUser } from './LoggedInAsUser';
 export { StateIcon } from './StateIcon';
 export type { LoggedInAsUserProps } from './LoggedInAsUser';

package/dist/_dts/blocks/src/system/runtime/shared/useWaitlistClaim.d.ts

@@ -13,4 +13,5 @@ export type UseWaitlistClaimDeps = Readonly<{
     useBlockApi: typeof useBlockApi;
 }>;
 export declare function useWaitlistClaim(): UseWaitlistClaimResult;
+export declare function useWaitlistClaimForToken(token: string | null): UseWaitlistClaimResult;
 export declare function useWaitlistClaimWithDeps(deps: UseWaitlistClaimDeps): UseWaitlistClaimResult;

package/dist/_dts/blocks/src/system/spacing.d.ts

@@ -21,7 +21,7 @@
  * 2. TypeScript will error until you update both spacing maps
  * 3. No way to get out of sync
  */
-declare const SEMANTIC_SPACING_VALUES: readonly ["none", "compact", "cozy", "medium", "comfortable", "spacious"];
+export declare const SEMANTIC_SPACING_VALUES: readonly ["none", "compact", "cozy", "medium", "comfortable", "spacious"];
 /**
  * Semantic spacing values used across the block system.
  * These abstract away the specific CSS classes and provide a consistent vocabulary.

package/dist/_dts/blocks/src/system/transforms/registry/_utils/boxStyleClassNames.d.ts

@@ -0,0 +1,109 @@
+import { type CardRole } from "../../../../../../theme-core/src/cards/index";
+/**
+ * @file The one place box-style content becomes CSS classes.
+ *
+ * `boxStyles.all` runs this for the binding pipeline, and the React nodes that
+ * render a card outside that pipeline (offerings-preview) call it directly, so
+ * there is a single card-class emission path rather than copies that drift.
+ */
+/** The elevation class an elevated box gets when the theme defines a shadow. */
+export declare const RAISED_SHADOW_CLASS = "rb-shadow-md";
+/** Radius values to their `rb-*` classes (defined in `rb-utilities.css`). */
+export declare const ROUNDED_CLASSES: Readonly<Record<string, string>>;
+export declare const fixedFrameScopeClass = "rb-bg-motion-fixed-frame-scope";
+export declare function hasFixedFrameBackgroundMotion(value: unknown): boolean;
+/**
+ * The stable per-theme class for a card role. Generated card CSS emits these
+ * aliases alongside each `.card-{id}` rule, so content addresses "this site
+ * style's open card" without knowing which variant implements it.
+ */
+export declare function cardRoleClass(role: Exclude<CardRole, "none">): string;
+/**
+ * The role class for a card slot the *block* owns structurally, where a Look
+ * may still name the surface.
+ *
+ * Some layouts have more than one card slot and decide themselves which one is
+ * the statement — the featured-editorial testimonials field is a lead voice
+ * beside its supporting voices, and that is structure, not composition. Those
+ * slots still have to honour a Look that picks a surface, or a role-picking
+ * Look would silently no-op under the layout. So the slot carries a default
+ * role and the Look's compiled role wins over it when there is one.
+ *
+ * An explicit `none` is honoured as boxlessness and emits no class, matching
+ * how the composite emitter reads it.
+ */
+/**
+ * The role a card renders with, and the one place a set of card styles becomes
+ * a role.
+ *
+ * Precedence: a per-item override, then the `role` a Look or semantic field
+ * compiled onto the block's card styles. Persisted inputs are normalized at
+ * this boundary because raw block records do not pass through the theme schema.
+ */
+export declare function resolveCardRoleForBoxStyles(input: Record<string, unknown>, override: CardRole | null | undefined): CardRole | null;
+/**
+ * Parse a block's own per-item surface vocabulary into a card role. The alias
+ * map is declared by the block (its persisted values are its own history), and
+ * `normalizeCardRole` remains the one untrusted-input boundary after that.
+ */
+export declare function resolveItemCardRole(value: unknown, aliases: Readonly<Record<string, string>> | undefined): CardRole | null;
+/** The border widths `CardStylesContent['border']` can carry. */
+export type BoxBorderWidth = "none" | "1" | "2" | "3";
+/**
+ * A box border after the one legacy shape has been normalized away, parsed
+ * into the vocabulary the field actually declares. The record arrives here as
+ * raw persisted JSON, so parsing is this function's job and no reader
+ * downstream repeats it.
+ */
+export type NormalizedBoxBorder = Readonly<{
+    /** `null` means the box expresses no opinion and inherits its border. */
+    enabled: boolean | null;
+    width: BoxBorderWidth | undefined;
+    colorToken: string | undefined;
+}>;
+/**
+ * A box's border record with `{ width: 'none' }`-without-`enabled` resolved.
+ *
+ * That shape used to mean two different things to two different readers: the
+ * old private offerings emitter read it as border-off, while the shared
+ * emitter read it as "no opinion" and left the caller's base `rb-border` in
+ * place. Same persisted bytes, opposite answers. A width of `none` says there
+ * is no border, so it is read as `enabled: false` here — once, at the one
+ * place box-style content is interpreted — and every reader downstream now
+ * agrees.
+ *
+ * Nothing persisted carries the shape (the #1297 usage audit found zero rows;
+ * the authoring UI cannot produce it, since the width control is gated on
+ * `enabled === true`), so this is boundary hygiene rather than a migration.
+ */
+export declare function normalizeBoxStylesBorder(value: unknown): NormalizedBoxBorder | null;
+/**
+ * The class list for a set of box styles: the caller's base class, the border /
+ * spacing / elevation / radius overrides the box carries, and its card surface.
+ *
+ * Pure, so the React nodes that render a card outside the binding pipeline
+ * (offerings-preview) share this one emission path with `boxStyles.all` instead
+ * of keeping a copy that drifts.
+ */
+export declare function boxStyleClassNames(value: unknown, options: Readonly<{
+    axis?: "y" | "all";
+    baseClass?: string;
+    includeSpacing?: boolean;
+    /**
+     * A card role that wins over the one compiled into the box styles — the
+     * per-item override in blocks that let individual cards pick their surface.
+     */
+    cardRoleOverride?: CardRole | null;
+    /**
+     * A structural slot's default surface when neither the item nor compiled
+     * card styles names one. An explicit `none` still wins over this fallback.
+     */
+    cardRoleFallback?: Exclude<CardRole, "none">;
+    /**
+     * The elevation class an elevated box gets. Defaults to the standard raised
+     * shadow; pass `null` to opt out explicitly (the binding pipeline does that
+     * for a theme whose medium shadow is `none`). Omitting it must never
+     * silently flatten a raised card, hence the default.
+     */
+    raisedClass?: string | null;
+}>): string;

package/dist/_dts/blocks/src/system/transforms/registry/_utils/surfaceForegroundStyles.d.ts

@@ -1,4 +1,8 @@
+import { resolveSurfaceForeground, type ResolvedSurfaceForeground } from '../../../../../../theme-core/src/surfaces/index';
+import type { ThemeHeader } from '../../../../../../theme-core/src/schema';
 import type { TransformContext } from '../core';
+export declare function resolveHeaderLeafTextColor(header: Partial<ThemeHeader> | undefined): NonNullable<ThemeHeader['textColor']>;
+export declare function resolveHeaderRootForeground(header: Partial<ThemeHeader> | undefined, palette: Parameters<typeof resolveSurfaceForeground>[1], isTransparent: boolean): ResolvedSurfaceForeground;
 export declare function resolveSurfaceForegroundStyles(value: unknown, context: TransformContext, options?: Readonly<{
     fallbackToken?: string;
 }>): Record<string, string>;

package/dist/_dts/blocks/src/system/transforms/registry/boxStyles.d.ts

@@ -1,5 +1,6 @@
 import { type TransformDefinition } from "./core";
 import type { SemanticSpacing } from "../../spacing";
+import type { CardRole } from "../../../../../theme-core/src/cards/index";
 /**
  * Maps semantic spacing values to CSS-only `rb-*` spacing classes.
  *
@@ -59,14 +60,50 @@ export declare const boxStylesCompositeTransform: TransformDefinition<{
     axis?: "y" | "all";
     baseClass?: string;
     includeSpacing?: boolean;
+    cardRoleOverride?: CardRole | null;
 }>;
-export declare const cardVariantClassTransform: TransformDefinition<{
+type CardRoleClassOptions = {
     baseClass?: string;
+    axis?: "y" | "all";
+    /** Where the block's compiled card styles live on the view model. */
+    stylesPath?: string;
+    /** The block's own per-item surface vocabulary, mapped onto card roles. */
+    itemRoleAliases?: Readonly<Record<string, string>>;
+    /**
+     * `surface` renders the card container (box styles plus the role class);
+     * `media` / `content` render the shared child hooks generated card CSS
+     * targets, and only while a role is actually in play.
+     */
+    emit?: "surface" | "media" | "content";
+};
+/**
+ * Card classes for a block whose items may each pick their own surface.
+ *
+ * Bound from the per-item role so it can see the repeated item, and reads the
+ * block's compiled card styles off the view model — the two live in different
+ * binding scopes. Precedence: the Look's block-level role is the base, an
+ * explicit per-item role overrides it, and the user's own card fields (border,
+ * background, radius) ride along on top as they always have.
+ */
+export declare const cardRoleClassTransform: TransformDefinition<CardRoleClassOptions>;
+/**
+ * The role class for a layout's own card slot, bound from the block's compiled
+ * card styles so a Look that picks a surface still reaches a slot the layout
+ * assigned a default role to.
+ */
+export declare const cardSlotRoleTransform: TransformDefinition<{
+    baseClass?: string;
+    slotDefault: Exclude<CardRole, "none">;
 }>;
-export declare const boxStylesBorderColorTransform: TransformDefinition<{
+type BoxStylesBorderColorOptions = {
     fallbackToken?: string;
     returnEmptyForDefault?: boolean;
-}>;
+    /** Read card styles here when the bound value is a per-item role. */
+    stylesPath?: string;
+    /** Map a block's per-item surface vocabulary onto canonical card roles. */
+    itemRoleAliases?: Readonly<Record<string, string>>;
+};
+export declare const boxStylesBorderColorTransform: TransformDefinition<BoxStylesBorderColorOptions>;
 type SectionClassNameOptions = {
     baseClass?: string;
     containerStylesPath?: string;

package/dist/_dts/blocks/src/system/transforms/registry/index.d.ts

@@ -9,4 +9,5 @@ import { contentTransforms } from "./content";
 import { headerRuntimeTransforms } from "./headerRuntime";
 export declare const builtinTransformDefinitions: import("./core").TransformDefinition<unknown>[];
 export declare const defaultTransforms: import("./core").TransformRegistry;
+export { boxStyleClassNames } from "./_utils/boxStyleClassNames";
 export { formattingTransforms, layoutTransforms, uiTransforms, mediaTransforms, backgroundTransforms, linksTransforms, boxStylesTransforms, contentTransforms, headerRuntimeTransforms, };

package/dist/_dts/blocks/src/system/transforms/registry/layout.d.ts

@@ -1,6 +1,5 @@
 import { z } from 'zod';
-import type { ThemeHeader } from '../../../../../theme-core/src/schema';
-import type { ThemeTokens } from '../../theme';
+import { type ThemeHeader } from '../../../../../theme-core/src/schema';
 import { type TransformDefinition } from './core';
 declare const headerLogoClassSchema: z.ZodObject<{
     base: z.ZodOptional<z.ZodString>;
@@ -13,7 +12,7 @@ export declare const headerLogoTextVisibleTransform: TransformDefinition;
  *
  * - `'inline'`  → classic variant with the historical logo-left / nav-right row
  * - `'centered'`→ classic variant with a centred (flex-1) nav and a right CTA
- * - `'other'`   → not a classic variant (centered/floating/transparent handle it)
+ * - `'other'`   → not a classic variant (centered/floating handle it)
  *
  * Consumed by the site-header block's `$when` gates so the two classic rows are
  * mutually exclusive without introducing a new top-level header variant.
@@ -32,47 +31,15 @@ declare const headerRootClassSchema: z.ZodObject<{
     invert: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type HeaderRootOptions = z.infer<typeof headerRootClassSchema>;
-export type HeaderVisualStyles = ReturnType<typeof resolveHeaderVisualStyles>;
-export declare function resolveBackgroundVisualStyles(backgroundColor: string | undefined, tokens: ThemeTokens, defaultToken?: string): {
+export declare function resolveBackgroundVisualStyles(backgroundColor: string | undefined, defaultToken?: string): {
     backgroundToken: string;
-    paletteHex: string | null;
-    backgroundHex: string | null;
-    isBackgroundDark: boolean;
-    textColorToken: "text";
-    textColorOverride: string | null;
-    isTransparent: boolean;
-} | {
-    backgroundToken: string;
-    paletteHex: string | undefined;
-    backgroundHex: string;
-    isBackgroundDark: boolean;
-    textColorToken: "text" | undefined;
-    textColorOverride: string | null;
     isTransparent: boolean;
 };
-export declare function resolveHeaderVisualStyles(header: Partial<ThemeHeader> | undefined, tokens: ThemeTokens): {
-    backgroundToken: string;
-    paletteHex: string | null;
-    backgroundHex: string | null;
-    isBackgroundDark: boolean;
-    textColorToken: "text";
-    textColorOverride: string | null;
-    isTransparent: boolean;
-} | {
+export declare function resolveHeaderVisualStyles(header: Partial<ThemeHeader> | undefined): {
     backgroundToken: string;
-    paletteHex: string | undefined;
-    backgroundHex: string;
-    isBackgroundDark: boolean;
-    textColorToken: "text" | undefined;
-    textColorOverride: string | null;
     isTransparent: boolean;
 } | {
     readonly backgroundToken: "transparent";
-    readonly paletteHex: null;
-    readonly backgroundHex: null;
-    readonly isBackgroundDark: false;
-    readonly textColorToken: "text";
-    readonly textColorOverride: null;
     readonly isTransparent: true;
 };
 export declare const headerRootClassTransform: TransformDefinition<HeaderRootOptions>;

package/dist/_dts/blocks/src/system/transforms/typed.d.ts

@@ -100,9 +100,6 @@ export declare const transformDefinitions: {
     readonly 'boxStyles.semanticGapValue': TransformDefinition<{
         fallback?: import("../spacing").SemanticSpacing;
     }>;
-    readonly 'boxStyles.cardVariantClass': TransformDefinition<{
-        baseClass?: string;
-    }>;
 };
 export type TransformId = keyof typeof transformDefinitions;
 type OptionsOf<T> = T extends TransformDefinition<infer O> ? O : never;
@@ -123,7 +120,7 @@ export declare function bindProp(from: string, opts?: {
     readonly $bind: {
         readonly pick?: "value" | "context" | "collection" | undefined;
         readonly fallback?: {} | null | undefined;
-        readonly transforms?: TransformStep<"string.uppercase" | "value.fallback" | "date.formatShort" | "value.csv" | "layout.maxWidthClass" | "layout.headerRootClass" | "layout.footerRootClass" | "layout.headerRootStyle" | "layout.headerSectionBackground" | "layout.footerRootStyle" | "ui.headerNavLinkClass" | "ui.headingClassFromAlignment" | "ui.bodyClassFromAlignment" | "ui.stackAlignFromAlignment" | "ui.sectionStateTone" | "ui.heroContentWrapperClass" | "ui.heroCtaJustify" | "ui.heroStackJustifyFromVerticalAlignment" | "ui.heroGridClassFromVerticalAlignment" | "ui.conditionalClass" | "ui.twoColumnContainerClass" | "ui.twoColumnFlexBasis" | "media.fromUrl" | "content.interpolateRichTextTokens" | "boxStyles.semanticGap" | "boxStyles.semanticGapValue" | "boxStyles.cardVariantClass" | "layout.headerLogoClass" | "layout.headerLogoMediaClass" | "layout.headerLogoTextVisible" | "layout.footerBottomBarClass" | "layout.footerBottomBarContainerClass" | "layout.footerBottomBarStyle" | "layout.footerSplitMainClass" | "layout.footerLogoClass" | "layout.footerLogoMediaClass" | "layout.footerLogoTextVisible" | "layout.headerRuntimeContract">[] | undefined;
+        readonly transforms?: TransformStep<"string.uppercase" | "value.fallback" | "date.formatShort" | "value.csv" | "layout.maxWidthClass" | "layout.headerRootClass" | "layout.footerRootClass" | "layout.headerRootStyle" | "layout.headerSectionBackground" | "layout.footerRootStyle" | "ui.headerNavLinkClass" | "ui.headingClassFromAlignment" | "ui.bodyClassFromAlignment" | "ui.stackAlignFromAlignment" | "ui.sectionStateTone" | "ui.heroContentWrapperClass" | "ui.heroCtaJustify" | "ui.heroStackJustifyFromVerticalAlignment" | "ui.heroGridClassFromVerticalAlignment" | "ui.conditionalClass" | "ui.twoColumnContainerClass" | "ui.twoColumnFlexBasis" | "media.fromUrl" | "content.interpolateRichTextTokens" | "boxStyles.semanticGap" | "boxStyles.semanticGapValue" | "layout.headerLogoClass" | "layout.headerLogoMediaClass" | "layout.headerLogoTextVisible" | "layout.footerBottomBarClass" | "layout.footerBottomBarContainerClass" | "layout.footerBottomBarStyle" | "layout.footerSplitMainClass" | "layout.footerLogoClass" | "layout.footerLogoMediaClass" | "layout.footerLogoTextVisible" | "layout.headerRuntimeContract">[] | undefined;
         readonly from: string;
     };
 };

package/dist/_dts/commerce/src/purchase/bookingInstalmentSchedule.d.ts

@@ -0,0 +1,13 @@
+import { type BookingInstalmentPlanConfig } from '../../../core/src/index';
+export type BookingInstalmentScheduleRow = Readonly<{
+    id: string;
+    sequence: number;
+    stateAtBooking: 'paid_today' | 'scheduled';
+    dueAt: string;
+    amountCents: number;
+}>;
+export declare function buildBookingInstalmentSchedule(input: Readonly<{
+    anchorAt: string;
+    totalAmountCents: number;
+    plan: BookingInstalmentPlanConfig;
+}>): readonly BookingInstalmentScheduleRow[];

package/dist/_dts/commerce/src/purchase/cancellationPolicy.d.ts

@@ -0,0 +1,7 @@
+import type { OrderStatus } from './orderTypes';
+/**
+ * Whether an order in the given status can be cancelled.
+ *
+ * `cancelled` orders cannot be cancelled again.
+ */
+export declare function isCancellableStatus(status: OrderStatus): boolean;

package/dist/_dts/commerce/src/purchase/canonicalRefundPlanner.d.ts

@@ -0,0 +1,48 @@
+import type { NonNegativeCents } from '../../../core/src/index';
+import type { OrderRefundMode } from './orderRefundPolicy';
+export type CanonicalRefundMethod = 'cash' | 'credit';
+export type OrderRefundRail = 'cash' | 'credit' | 'mixed';
+export type CanonicalRefundPlannerErrorCode = 'already_refunded' | 'idempotency_amount_mismatch' | 'idempotency_method_mismatch' | 'refund_in_progress' | 'invalid_amount' | 'amount_exceeds_remaining' | 'pass_revoke_requires_full_refund' | 'refund_failed';
+export type CanonicalRefundSnapshot = Readonly<{
+    id: string;
+    status: 'pending' | 'succeeded' | 'failed' | 'reconciliation_needed';
+    amountCents: NonNegativeCents;
+    refundRail: OrderRefundRail;
+    refundMode: OrderRefundMode;
+    failureCode: string | null;
+    failureMessage: string | null;
+    isStale: boolean;
+}>;
+export type CanonicalRefundPlannerInput = Readonly<{
+    refundMethod: CanonicalRefundMethod;
+    refundMode: OrderRefundMode;
+    requestedAmountCents: NonNegativeCents | undefined;
+    remainingRefundableCents: NonNegativeCents;
+    refundedSoFarCents: NonNegativeCents;
+    requireFullRemainingRefund: boolean;
+    acceptableExistingRails: readonly OrderRefundRail[];
+    existingByIdempotency: CanonicalRefundSnapshot | null;
+    latestPending: CanonicalRefundSnapshot | null;
+}>;
+export type CanonicalRefundPlannerDecision = Readonly<{
+    kind: 'existing_succeeded';
+    refund: CanonicalRefundSnapshot;
+    totalRefundedCents: NonNegativeCents;
+    remainingRefundableCents: NonNegativeCents;
+}> | Readonly<{
+    kind: 'resume_pending';
+    refund: CanonicalRefundSnapshot;
+    requestedAmountCents: NonNegativeCents;
+}> | Readonly<{
+    kind: 'create_pending';
+    requestedAmountCents: NonNegativeCents;
+}> | Readonly<{
+    kind: 'failed';
+    errorCode: CanonicalRefundPlannerErrorCode;
+    errorMessage: string;
+    refund: CanonicalRefundSnapshot | null;
+    amountCents: NonNegativeCents | null;
+    totalRefundedCents: NonNegativeCents;
+    remainingRefundableCents: NonNegativeCents;
+}>;
+export declare function planCanonicalRefundRequest(input: CanonicalRefundPlannerInput): CanonicalRefundPlannerDecision;

package/dist/_dts/commerce/src/purchase/checkoutCollectionPlan.d.ts

@@ -0,0 +1,39 @@
+import { type NonEmptyArray, type Result } from '../../../core/src/index';
+export type CheckoutCollectionPlanningError = Readonly<{
+    _tag: 'CheckoutCollectionPlanningError';
+    code: 'shop_shipping_not_configured';
+    message: string;
+}>;
+export type CheckoutCollectionPlan<TCountryCode extends string = string> = Readonly<{
+    kind: 'digital_only';
+    automaticTaxEnabled: boolean;
+    billingAddressCollection: 'auto';
+}> | Readonly<{
+    kind: 'requires_shipping';
+    automaticTaxEnabled: boolean;
+    billingAddressCollection: 'auto';
+    allowedShippingCountries: NonEmptyArray<TCountryCode>;
+}>;
+export type CheckoutCollectionItemKind = 'event_ticket' | 'product' | 'pass' | 'course_enrollment' | 'appointment';
+export type CheckoutCollectionProductItem = Readonly<{
+    validated: Readonly<{
+        type: 'product';
+        product: Readonly<{
+            requiresShipping: boolean;
+        }>;
+    }>;
+}>;
+export type CheckoutCollectionNonProductItem = Readonly<{
+    validated: Readonly<{
+        type: Exclude<CheckoutCollectionItemKind, 'product'>;
+    }>;
+}>;
+export type CheckoutCollectionItem = CheckoutCollectionProductItem | CheckoutCollectionNonProductItem;
+export type CheckoutCollectionCart<TItem extends CheckoutCollectionItem = CheckoutCollectionItem> = Readonly<{
+    items: readonly TItem[];
+}>;
+export declare function buildCheckoutCollectionPlan<TCountryCode extends string, TItem extends CheckoutCollectionItem>(options: Readonly<{
+    settledCart: CheckoutCollectionCart<TItem>;
+    automaticTaxEnabled: boolean;
+    allowedShippingCountries: readonly TCountryCode[];
+}>): Result<CheckoutCollectionPlan<TCountryCode>, CheckoutCollectionPlanningError>;