@riverbankcms/sdk 0.143.0 → 0.145.0

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

@@ -0,0 +1,320 @@
+import { type BoundaryOptionId, type SiteStyleSectionTransitionIntent } from './types';
+import type { AngleSectionTransitionVariantId, GradientSectionTransitionVariantId, SectionBoundaryRuntimeSize, SectionBoundaryTreatment, WaveSectionTransitionVariantId } from './sectionTransitions';
+/**
+ * Every transition that draws something. `none` is deliberately outside the
+ * catalogue: it is the absence of a join, not a treatment (issue 1422).
+ */
+export type DecorativeTransitionIntent = Exclude<SiteStyleSectionTransitionIntent, 'none'>;
+export type DecorativeTransitionFamilyId = 'gradient' | 'wave' | 'angle';
+/** One SVG mask per wave variant, keyed so CSS never guesses by prefix. */
+export type WaveMaskId = 'classic' | 'balanced' | 'gentle' | 'bold' | 'drift';
+/**
+ * The sloped top edge of an angle shape, as percentages from the top of the
+ * shape layer at its left and right edges. The bottom edge is always flat, so
+ * `polygon(0 {start}%, 100% {end}%, 100% 100%, 0 100%)` is the full shape.
+ */
+export type AnglePolygon = Readonly<{
+    startTopPercent: number;
+    endTopPercent: number;
+}>;
+export type TransitionShape = 
+/** Every fade draws the same curve today; its height comes from the entry. */
+Readonly<{
+    kind: 'fade';
+}> | Readonly<{
+    kind: 'wave';
+    mask: WaveMaskId;
+}> | Readonly<{
+    kind: 'angle';
+    polygon: AnglePolygon;
+}>;
+type TransitionCatalogueEntryBase = Readonly<{
+    intent: DecorativeTransitionIntent;
+    optionId: BoundaryOptionId;
+    /** Flat label used by the persistence-facing option list. */
+    label: string;
+    /** Short label used inside a family picker ("Classic" under "Wave"). */
+    variantLabel: string;
+    size: SectionBoundaryRuntimeSize;
+    /** Unwrapped CSS length expression; metrics wrap it in `calc()` as needed. */
+    heightExpression: string;
+}>;
+/**
+ * Family, variant, treatment and shape are correlated per family, so a wave
+ * entry cannot carry an angle polygon or a soft-fade treatment.
+ */
+export type TransitionCatalogueEntry = TransitionCatalogueEntryBase & (Readonly<{
+    family: 'gradient';
+    variantId: GradientSectionTransitionVariantId;
+    treatment: Extract<SectionBoundaryTreatment, {
+        kind: 'soft-fade';
+    }>;
+    shape: Extract<TransitionShape, {
+        kind: 'fade';
+    }>;
+}> | Readonly<{
+    family: 'wave';
+    variantId: WaveSectionTransitionVariantId;
+    treatment: Extract<SectionBoundaryTreatment, {
+        kind: 'wave-edge';
+    }>;
+    shape: Extract<TransitionShape, {
+        kind: 'wave';
+    }>;
+}> | Readonly<{
+    family: 'angle';
+    variantId: AngleSectionTransitionVariantId;
+    treatment: Extract<SectionBoundaryTreatment, {
+        kind: 'angle-edge';
+    }>;
+    shape: Extract<TransitionShape, {
+        kind: 'angle';
+    }>;
+}>);
+export type TransitionCatalogueFamily = Readonly<{
+    id: DecorativeTransitionFamilyId;
+    label: string;
+}>;
+/**
+ * Family order for pickers. Entries below are listed family by family in this
+ * same order, so the flat option list and the grouped families agree.
+ */
+export declare const transitionCatalogueFamilies: readonly [{
+    readonly id: "gradient";
+    readonly label: "Gradient";
+}, {
+    readonly id: "wave";
+    readonly label: "Wave";
+}, {
+    readonly id: "angle";
+    readonly label: "Angle";
+}];
+/**
+ * The single source of transition vocabulary. Order is significant: it is the
+ * order of `boundaryOptions` (after `none`) and of each family's variants,
+ * which persisted pins, page-flow presets and the editor picker all rely on.
+ *
+ * Shapes match what `generateLayoutCss` draws today. Structured
+ * amplitude/frequency treatments (issue 826) extend this list later.
+ */
+export declare const transitionCatalogueEntries: readonly [{
+    readonly intent: "soft-fade-short";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "gradient";
+    readonly variantId: "soft";
+    readonly label: "Soft";
+    readonly variantLabel: "Soft";
+    readonly treatment: {
+        readonly kind: "soft-fade";
+        readonly height: "medium";
+        readonly curve: "soft";
+    };
+    readonly size: "medium";
+    readonly heightExpression: "6rem + 2px";
+    readonly shape: {
+        readonly kind: "fade";
+    };
+}, {
+    readonly intent: "soft-fade-long";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "gradient";
+    readonly variantId: "spacious";
+    readonly label: "Spacious";
+    readonly variantLabel: "Spacious";
+    readonly treatment: {
+        readonly kind: "soft-fade";
+        readonly height: "large";
+        readonly curve: "spacious";
+    };
+    readonly size: "spacious";
+    readonly heightExpression: "10rem";
+    readonly shape: {
+        readonly kind: "fade";
+    };
+}, {
+    readonly intent: "soft-fade-expansive";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "gradient";
+    readonly variantId: "expansive";
+    readonly label: "Expansive";
+    readonly variantLabel: "Expansive";
+    readonly treatment: {
+        readonly kind: "soft-fade";
+        readonly height: "expansive";
+        readonly curve: "expansive";
+    };
+    readonly size: "expansive";
+    readonly heightExpression: "14rem";
+    readonly shape: {
+        readonly kind: "fade";
+    };
+}, {
+    readonly intent: "wave-edge-balanced";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "wave";
+    readonly variantId: "balanced";
+    readonly label: "Balanced wave";
+    readonly variantLabel: "Balanced";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "medium";
+        readonly amplitude: "balanced";
+        readonly rhythm: "double";
+        readonly symmetry: "symmetrical";
+    };
+    readonly size: "medium";
+    readonly heightExpression: "6rem + 2px";
+    readonly shape: {
+        readonly kind: "wave";
+        readonly mask: "balanced";
+    };
+}, {
+    readonly intent: "wave-edge";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "wave";
+    readonly variantId: "classic";
+    readonly label: "Classic wave";
+    readonly variantLabel: "Classic";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "medium";
+        readonly amplitude: "balanced";
+        readonly rhythm: "double";
+        readonly symmetry: "asymmetrical";
+    };
+    readonly size: "medium";
+    readonly heightExpression: "6rem + 2px";
+    readonly shape: {
+        readonly kind: "wave";
+        readonly mask: "classic";
+    };
+}, {
+    readonly intent: "wave-edge-gentle";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "wave";
+    readonly variantId: "gentle";
+    readonly label: "Gentle wave";
+    readonly variantLabel: "Gentle";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "compact";
+        readonly amplitude: "subtle";
+        readonly rhythm: "single";
+        readonly symmetry: "symmetrical";
+    };
+    readonly size: "compact";
+    readonly heightExpression: "4.5rem + 2px";
+    readonly shape: {
+        readonly kind: "wave";
+        readonly mask: "gentle";
+    };
+}, {
+    readonly intent: "wave-edge-bold";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "wave";
+    readonly variantId: "bold";
+    readonly label: "Bold wave";
+    readonly variantLabel: "Bold";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "large";
+        readonly amplitude: "bold";
+        readonly rhythm: "double";
+        readonly symmetry: "symmetrical";
+    };
+    readonly size: "large";
+    readonly heightExpression: "7rem + 2px";
+    readonly shape: {
+        readonly kind: "wave";
+        readonly mask: "bold";
+    };
+}, {
+    readonly intent: "wave-edge-drift";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "wave";
+    readonly variantId: "drift";
+    readonly label: "Drift wave";
+    readonly variantLabel: "Drift";
+    readonly treatment: {
+        readonly kind: "wave-edge";
+        readonly height: "medium";
+        readonly amplitude: "balanced";
+        readonly rhythm: "double";
+        readonly symmetry: "drift";
+    };
+    readonly size: "medium";
+    readonly heightExpression: "6rem + 2px";
+    readonly shape: {
+        readonly kind: "wave";
+        readonly mask: "drift";
+    };
+}, {
+    readonly intent: "angle-edge-subtle";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "angle";
+    readonly variantId: "subtle";
+    readonly label: "Subtle angle";
+    readonly variantLabel: "Subtle";
+    readonly treatment: {
+        readonly kind: "angle-edge";
+        readonly height: "compact";
+        readonly slope: "subtle";
+        readonly direction: "forward";
+    };
+    readonly size: "compact";
+    readonly heightExpression: "4.5rem + 2px";
+    readonly shape: {
+        readonly kind: "angle";
+        readonly polygon: {
+            readonly startTopPercent: 34;
+            readonly endTopPercent: 18;
+        };
+    };
+}, {
+    readonly intent: "angle-edge";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "angle";
+    readonly variantId: "balanced";
+    readonly label: "Balanced angle";
+    readonly variantLabel: "Balanced";
+    readonly treatment: {
+        readonly kind: "angle-edge";
+        readonly height: "medium";
+        readonly slope: "balanced";
+        readonly direction: "forward";
+    };
+    readonly size: "medium";
+    readonly heightExpression: "6rem + 2px";
+    readonly shape: {
+        readonly kind: "angle";
+        readonly polygon: {
+            readonly startTopPercent: 42;
+            readonly endTopPercent: 8;
+        };
+    };
+}, {
+    readonly intent: "angle-edge-steep";
+    readonly optionId: BoundaryOptionId;
+    readonly family: "angle";
+    readonly variantId: "steep";
+    readonly label: "Steep angle";
+    readonly variantLabel: "Steep";
+    readonly treatment: {
+        readonly kind: "angle-edge";
+        readonly height: "large";
+        readonly slope: "steep";
+        readonly direction: "forward";
+    };
+    readonly size: "large";
+    readonly heightExpression: "7rem + 2px";
+    readonly shape: {
+        readonly kind: "angle";
+        readonly polygon: {
+            readonly startTopPercent: 54;
+            readonly endTopPercent: 0;
+        };
+    };
+}];
+/** CSS `clip-path` value for an angle shape, as `generateLayoutCss` draws it. */
+export declare function anglePolygonCss(polygon: AnglePolygon): string;
+export {};

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

@@ -436,7 +436,6 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
      * composition governs what the item looks like.
      */
     cardRole?: CardRole;
-    transitionAfter: SiteStyleSectionTransitionIntent;
     emphasis: SiteStyleEmphasis;
     sectionHeight?: SectionHeightIntent;
     heroLegibility?: HeroLegibilityStrategy;
@@ -453,7 +452,6 @@ export type BlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose ex
 export type ResolvedBlockDesignPlan<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<BlockDesignPlan<TBlockId, TPurpose> & {
     appliedSectionSurface: SiteStyleSurfaceIntent;
     appliedContentFrame: ContentFrameIntent;
-    appliedTransitionAfter: SiteStyleSectionTransitionIntent;
     /**
      * The card role after capability gating. `null` (or absent) means no
      * site-style card is applied; the block renders its own composition.
@@ -540,7 +538,7 @@ export type BlockDesignCapability = DesignedBlockDesignCapability | NoBlockDesig
 export type BlockDesignCapabilityMap = Readonly<Partial<Record<string, BlockDesignCapability>>>;
 export declare function defineBlockDesignCapability<const TCapability extends DesignedBlockDesignCapabilityInput>(capability: NoExtraKeys<TCapability, DesignedBlockDesignCapabilityInput>): DesignedBlockDesignCapability;
 export declare function defineNoBlockDesignCapability(reason: UnsupportedBlockDesignCapabilityReason): NoBlockDesignCapability;
-export type DesignRepairAction = 'fallback-block-design' | 'fallback-section-surface' | 'fallback-content-frame' | 'fallback-card-role' | 'fallback-section-height' | 'fallback-image-surface-treatment' | 'fallback-image-surface-motion' | 'fallback-tile-treatment' | 'fallback-event-list-treatment' | 'fallback-eyebrow-treatment' | 'fallback-accordion-icon-treatment' | 'remove-composition' | 'remove-hero-legibility' | 'remove-transition' | 'fallback-hero-legibility' | 'reduce-accent-density' | 'reduce-panel-density' | 'reduce-transition-mix' | 'reduce-primary-ctas' | 'reduce-media-density' | 'reduce-decorative-repetition';
+export type DesignRepairAction = 'fallback-block-design' | 'fallback-section-surface' | 'fallback-content-frame' | 'fallback-card-role' | 'fallback-section-height' | 'fallback-image-surface-treatment' | 'fallback-image-surface-motion' | 'fallback-tile-treatment' | 'fallback-event-list-treatment' | 'fallback-eyebrow-treatment' | 'fallback-accordion-icon-treatment' | 'remove-composition' | 'remove-hero-legibility' | 'fallback-hero-legibility' | 'reduce-accent-density' | 'reduce-panel-density' | 'reduce-transition-mix' | 'reduce-primary-ctas' | 'reduce-media-density' | 'reduce-decorative-repetition';
 export type UnsupportedSectionSurfaceIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'unsupported-section-surface';
     blockId: TBlockId;
@@ -704,7 +702,6 @@ export type BlockDesignCapabilityRequest = Readonly<{
     sectionSurface: SiteStyleSurfaceIntent;
     contentFrame: ContentFrameIntent;
     cardRole?: CardRole;
-    transitionAfter: SiteStyleSectionTransitionIntent;
     sectionHeight?: SectionHeightIntent;
     heroLegibility?: HeroLegibilityStrategy;
     heroComposition?: HeroCompositionIntent;
@@ -720,7 +717,6 @@ export type BlockDesignCapabilityRequest = Readonly<{
 export type BlockDesignCapabilityFallback = Readonly<{
     sectionSurface: 'base';
     contentFrame: PlainFrameIntent;
-    transitionAfter: 'none';
     sectionHeight: 'default';
     heroLegibility: 'none';
     imageSurfaceTreatment: Readonly<{
@@ -756,17 +752,6 @@ export type UnsupportedBlockDesignCapabilityIssue<TBlockId extends string = Desi
     severity: DesignIssueSeverity;
     allowedRepairActions: readonly ['fallback-block-design'];
 }>;
-export type RemovedTransitionForFlushFrameIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
-    kind: 'removed-transition-for-flush-frame';
-    blockId: TBlockId;
-    blockKind: string;
-    purpose: TPurpose;
-    requested: SiteStyleSectionTransitionIntent;
-    fallback: 'none';
-    policy: DesignResolutionPolicy;
-    severity: DesignIssueSeverity;
-    allowedRepairActions: readonly ['remove-transition'];
-}>;
 export type HeroImageWithoutLegibilityIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = Readonly<{
     kind: 'hero-image-without-legibility';
     blockId: TBlockId;
@@ -778,10 +763,10 @@ export type HeroImageWithoutLegibilityIssue<TBlockId extends string = DesignBloc
     severity: DesignIssueSeverity;
     allowedRepairActions: readonly ['fallback-hero-legibility'];
 }>;
-export type DesignResolutionIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = UnsupportedSectionSurfaceIssue<TBlockId, TPurpose> | UnsupportedContentFrameIssue<TBlockId, TPurpose> | UnsupportedCardRoleIssue<TBlockId, TPurpose> | UnsupportedSectionHeightIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceTreatmentIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceMotionIssue<TBlockId, TPurpose> | UnsupportedTileTreatmentIssue<TBlockId, TPurpose> | UnsupportedEventListTreatmentIssue<TBlockId, TPurpose> | UnsupportedEyebrowTreatmentIssue<TBlockId, TPurpose> | UnsupportedAccordionIconTreatmentIssue<TBlockId, TPurpose> | UnsupportedBlockCompositionIssue<TBlockId, TPurpose> | ImageSurfaceTreatmentWithoutImageSurfaceIssue<TBlockId, TPurpose> | ImageSurfaceMotionWithoutImageSurfaceIssue<TBlockId, TPurpose> | HeroLegibilityOverriddenByImageSurfaceTreatmentIssue<TBlockId, TPurpose> | MissingBlockDesignCapabilityIssue<TBlockId, TPurpose> | UnsupportedBlockDesignCapabilityIssue<TBlockId, TPurpose> | RemovedTransitionForFlushFrameIssue<TBlockId, TPurpose> | HeroImageWithoutLegibilityIssue<TBlockId, TPurpose>;
+export type DesignResolutionIssue<TBlockId extends string = DesignBlockId, TPurpose extends string = string> = UnsupportedSectionSurfaceIssue<TBlockId, TPurpose> | UnsupportedContentFrameIssue<TBlockId, TPurpose> | UnsupportedCardRoleIssue<TBlockId, TPurpose> | UnsupportedSectionHeightIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceTreatmentIssue<TBlockId, TPurpose> | UnsupportedImageSurfaceMotionIssue<TBlockId, TPurpose> | UnsupportedTileTreatmentIssue<TBlockId, TPurpose> | UnsupportedEventListTreatmentIssue<TBlockId, TPurpose> | UnsupportedEyebrowTreatmentIssue<TBlockId, TPurpose> | UnsupportedAccordionIconTreatmentIssue<TBlockId, TPurpose> | UnsupportedBlockCompositionIssue<TBlockId, TPurpose> | ImageSurfaceTreatmentWithoutImageSurfaceIssue<TBlockId, TPurpose> | ImageSurfaceMotionWithoutImageSurfaceIssue<TBlockId, TPurpose> | HeroLegibilityOverriddenByImageSurfaceTreatmentIssue<TBlockId, TPurpose> | MissingBlockDesignCapabilityIssue<TBlockId, TPurpose> | UnsupportedBlockDesignCapabilityIssue<TBlockId, TPurpose> | HeroImageWithoutLegibilityIssue<TBlockId, TPurpose>;
 export type DesignRepairResultForIssue<TIssue extends DesignResolutionIssue<string, string>> = {
     [TKind in TIssue['kind']]: Readonly<{
-        kind: TKind extends 'removed-transition-for-flush-frame' ? 'repaired' : 'fallbackApplied';
+        kind: 'fallbackApplied';
         issue: Extract<TIssue, {
             kind: TKind;
         }>;

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Whether a surface reads as light or dark, judged from the text foreground
+ * that was resolved for it: light text means a dark surface. `unknown` covers
+ * every foreground we cannot honestly classify.
+ */
+export type SurfaceTone = 'light' | 'dark' | 'unknown';
+/** Concrete hex behind a plain, opaque palette token, or null otherwise. */
+export declare function opaquePaletteHexForToken(expandedPalette: Readonly<Record<string, string>>, token: string | null | undefined): string | null;
+/**
+ * Tone of the surface a foreground token was resolved for.
+ *
+ * A token with opacity has no known underlay to composite against, and a raw
+ * or unrecognised token has no palette hex, so both are `unknown` rather than
+ * a guess.
+ */
+export declare function surfaceToneFromForegroundToken(expandedPalette: Readonly<Record<string, string>>, foregroundToken: string | null | undefined): SurfaceTone;
+export type LogoVariants<TLogo> = Readonly<{
+    forLightBackgrounds: TLogo | null;
+    forDarkBackgrounds: TLogo | null;
+}>;
+/**
+ * The logo to draw on a surface of the given tone. A missing variant falls
+ * back to the other one, and an unknown tone uses the light-backgrounds logo,
+ * which is what every site rendered before variants existed.
+ */
+export declare function selectLogoVariant<TLogo>(tone: SurfaceTone, variants: LogoVariants<TLogo>): TLogo | null;

package/dist/_dts/theme-core/src/utils/colorStyles.d.ts

@@ -58,6 +58,16 @@ export declare function cssVarValue(token: ThemeColorToken): string;
  * @returns CSSProperties with backgroundColor
  */
 export declare function backgroundColorStyle(token: ThemeColorToken): CSSProperties;
+/**
+ * Converts a text color token to a CSS color value that follows the enclosing
+ * surface. The semantic text tokens (`text`, `heading`, `mutedText`) resolve
+ * to the surface foreground variables, so text adapts when a section's
+ * background changes; any other token is a fixed theme color.
+ *
+ * @param token - Theme color token
+ * @returns CSS color value
+ */
+export declare function textColorValue(token: ThemeColorToken): string;
 /**
  * Creates a text color style object from a theme token.
  *

package/dist/_dts/ui/src/editor-item-card.d.ts

@@ -0,0 +1,116 @@
+import * as React from 'react';
+/**
+ * The card an editor uses for one item in an ordered list: a block on a page,
+ * a field on a form, an item in a repeater.
+ *
+ * It owns presentation only: the surface, the header layout, the disclosure
+ * and its accessibility contract, and how actions are drawn. Which actions an
+ * item offers, when they are available, reordering, drag state and focus
+ * restoration all belong to the editor that renders it.
+ */
+export type EditorItemCardControl = Readonly<{
+    label: string;
+    disabled?: boolean;
+    onSelect: () => void;
+    ref?: React.Ref<HTMLButtonElement>;
+}>;
+export type EditorItemCardInlineAction = EditorItemCardControl & Readonly<{
+    key: string;
+    icon: React.ReactNode;
+}>;
+export type EditorItemCardMenuItem = Readonly<{
+    key: string;
+    label: string;
+    icon: React.ReactNode;
+    tone?: 'default' | 'destructive';
+    disabled?: boolean;
+    onSelect: () => void;
+}>;
+export type EditorItemCardMenuGroup = Readonly<{
+    key: string;
+    items: readonly EditorItemCardMenuItem[];
+}>;
+export type EditorItemCardMenu = Readonly<{
+    /** Accessible name for the trigger, e.g. "More actions for Hero". */
+    label: string;
+    disabled?: boolean;
+    ref?: React.Ref<HTMLButtonElement>;
+    groups: readonly EditorItemCardMenuGroup[];
+}>;
+export type EditorItemCardActionsProps = Readonly<{
+    move?: Readonly<{
+        earlier: EditorItemCardControl;
+        later: EditorItemCardControl;
+    }>;
+    /** Controls that render their own trigger, such as a settings dialog. */
+    slot?: React.ReactNode;
+    inline?: readonly EditorItemCardInlineAction[];
+    menu?: EditorItemCardMenu;
+    className?: string;
+    testId?: string;
+}>;
+/**
+ * `locked` renders no drag handle and no actions at all. There is deliberately
+ * no way to show them disabled: a control that never works reads as broken.
+ */
+export type EditorItemCardAffordances = Readonly<{
+    kind: 'full';
+    dragHandle?: React.ReactNode;
+    actions?: EditorItemCardActionsProps;
+}> | Readonly<{
+    kind: 'locked';
+}>;
+export type EditorItemCardDisclosure = Readonly<{
+    kind: 'collapsible';
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Stable id for the content region; generated when omitted. */
+    contentId?: string;
+}> | Readonly<{
+    kind: 'static';
+}>;
+export type EditorItemCardState = 'default' | 'error' | 'highlighted';
+export type EditorItemCardProps = Omit<React.ComponentProps<'div'>, 'title' | 'children'> & Readonly<{
+    title: string;
+    subtitle?: React.ReactNode;
+    /** Status shown beside the title, e.g. a validation hint. */
+    titleAdornment?: React.ReactNode;
+    state?: EditorItemCardState;
+    disclosure: EditorItemCardDisclosure;
+    affordances: EditorItemCardAffordances;
+    /** When false the header's controls are inert, e.g. while handlers load. */
+    interactive?: boolean;
+    /** Prefix for the header's test ids. */
+    testIdPrefix?: string;
+    children?: React.ReactNode;
+}>;
+export declare function EditorItemCard({ title, subtitle, titleAdornment, state, disclosure: requestedDisclosure, affordances, interactive, testIdPrefix, children, className, ...rootProps }: EditorItemCardProps): React.ReactElement;
+/**
+ * The action row, usable on its own by item presentations that aren't a
+ * header card (for example a thumbnail tile).
+ */
+export declare function EditorItemCardActions({ move, slot, inline, menu, className, testId, }: EditorItemCardActionsProps): React.ReactElement;
+export type EditorItemCardDragHandleProps = React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    /**
+     * Keeps the handle's space so titles stay aligned down a list, but makes it
+     * invisible and inert — e.g. while the item is expanded.
+     */
+    concealed?: boolean;
+};
+export declare const EditorItemCardDragHandle: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    /**
+     * Keeps the handle's space so titles stay aligned down a list, but makes it
+     * invisible and inert — e.g. while the item is expanded.
+     */
+    concealed?: boolean;
+} & React.RefAttributes<HTMLButtonElement>>;
+export type EditorItemInsertDividerProps = Readonly<{
+    /** Visible action text, e.g. "Insert block" or "Insert field". */
+    label: string;
+    onSelect: () => void;
+}>;
+/**
+ * The gap between two items in an editor list. Its insert action appears
+ * when the gap is hovered or when keyboard focus reaches it.
+ */
+export declare function EditorItemInsertDivider({ label, onSelect }: EditorItemInsertDividerProps): React.ReactElement;

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

@@ -4,6 +4,7 @@ export { SplitButton, type SplitButtonMenuItem, type SplitButtonProps, } from '.
 export { ButtonGroup, ButtonGroupSeparator, ButtonGroupText, buttonGroupVariants, } from './button-group';
 export { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, } from './card';
 export { Surface, surfaceVariants, type SurfaceProps } from './surface';
+export { EditorItemCard, EditorItemCardActions, EditorItemCardDragHandle, EditorItemInsertDivider, type EditorItemCardActionsProps, type EditorItemCardAffordances, type EditorItemCardControl, type EditorItemCardDisclosure, type EditorItemCardDragHandleProps, type EditorItemCardInlineAction, type EditorItemCardMenu, type EditorItemCardMenuGroup, type EditorItemCardMenuItem, type EditorItemCardProps, type EditorItemCardState, type EditorItemInsertDividerProps, } from './editor-item-card';
 export { Collapsible, CollapsibleTrigger, CollapsibleContent, } from './collapsible';
 export { Disclosure, DisclosureTrigger, DisclosureContent, } from './disclosure';
 export { Dialog, DialogTrigger, DialogPortal, DialogClose, DialogOverlay, DialogContent, DialogHeader, DialogFooter, DialogTitle, DialogDescription, } from './dialog';

package/dist/client/{BookingConsentAgreement-BoCtvzzu.mjs → BookingConsentAgreement-DlVOmpW4.mjs}

@@ -1,8 +1,7 @@
 "use client";
-import { O as clsx } from "./colorStyles-3013aRAY.mjs";
-import { Ft as assertNever$2, pn as formatCurrencyAmount } from "./propsDecoder-CIZ-hbIG.mjs";
-import { a as CheckIcon } from "./scrollToBlock-BPZl0gPZ.mjs";
-import { n as RichText } from "./checkoutUrls-FL6lRkrt.mjs";
+import { _n as formatCurrencyAmount, zt as assertNever$2 } from "./propsDecoder-C3TP_z4x.mjs";
+import { a as CheckIcon } from "./scrollToBlock-CWs8EIdo.mjs";
+import { n as RichText } from "./checkoutUrls-CW3-78uu.mjs";
 import { useCallback, useEffect, useReducer, useRef } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region ../core/src/date-math.ts
@@ -613,56 +612,6 @@ function usePolling(config) {
 	};
 }
 //#endregion
-//#region ../blocks/src/system/runtime/nodes/spinner.tsx
-function resolveColorStyle(color) {
-	switch (color) {
-		case void 0: return;
-		case "inherit": return { color: "inherit" };
-		case "foreground": return { color: "rgb(var(--tb-foreground))" };
-		case "text": return { color: "rgb(var(--tb-text))" };
-		default: return;
-	}
-}
-function SpinnerNode({ className, size = "md", color, strokeWidth = 3, srLabel, style, ...rest }) {
-	const hasExplicitAriaLabel = typeof rest["aria-label"] === "string" && rest["aria-label"].trim().length > 0;
-	const accessibilityProps = srLabel ? {
-		role: "status",
-		"aria-live": "polite"
-	} : hasExplicitAriaLabel ? {} : { "aria-hidden": true };
-	const trackStroke = color === "inherit" ? "currentColor" : "var(--rb-spinner-track-color)";
-	const trackOpacity = color === "inherit" ? .25 : 1;
-	return /* @__PURE__ */ jsxs("span", {
-		...accessibilityProps,
-		className: clsx("rb-spinner", size ? `rb-spinner--${size}` : null, color === "inherit" ? "rb-spinner--inherit" : null, className),
-		style: {
-			...resolveColorStyle(color),
-			...style ?? {}
-		},
-		...rest,
-		children: [/* @__PURE__ */ jsxs("svg", {
-			viewBox: "0 0 24 24",
-			fill: "none",
-			"aria-hidden": "true",
-			children: [/* @__PURE__ */ jsx("circle", {
-				cx: "12",
-				cy: "12",
-				r: "10",
-				stroke: trackStroke,
-				strokeWidth,
-				opacity: trackOpacity
-			}), /* @__PURE__ */ jsx("path", {
-				d: "M12 2a10 10 0 0 1 10 10",
-				stroke: "currentColor",
-				strokeWidth,
-				strokeLinecap: "round"
-			})]
-		}), srLabel ? /* @__PURE__ */ jsx("span", {
-			className: "rb-sr-only",
-			children: srLabel
-		}) : null]
-	});
-}
-//#endregion
 //#region ../blocks/src/system/runtime/shared/components/StepIndicator.tsx
 /**
 * Shared step indicator component for registration wizards.
@@ -748,4 +697,4 @@ function BookingConsentAgreement({ agreement, showTitle = true, title, titleId }
 	})] });
 }
 //#endregion
-export { buildBookingPaymentSelectionViewModel as a, usePolling as i, StepIndicator as n, resolveBookingPaymentDueNowCents as o, SpinnerNode as r, formatPrice as s, BookingConsentAgreement as t };
+export { resolveBookingPaymentDueNowCents as a, buildBookingPaymentSelectionViewModel as i, StepIndicator as n, formatPrice as o, usePolling as r, BookingConsentAgreement as t };