@riverbankcms/sdk 0.145.0 → 0.147.0

package/dist/server/theme-bridge.mjs

@@ -902,26 +902,21 @@ function isOnColorBackgroundCandidateToken(token) {
 	return BACKGROUND_ROLE_NAMES.has(role);
 }
 //#endregion
-//#region ../theme-core/src/surfaces/foregroundRoles.ts
-const SURFACE_FOREGROUND_ROLES = [
-	"text",
-	"heading",
-	"link",
-	"supporting"
-];
-//#endregion
 //#region ../theme-core/src/surfaces/foregroundContract.ts
 const SURFACE_FOREGROUND_CSS_VARS = {
 	text: "--rb-surface-text-color",
 	heading: "--rb-surface-heading-color",
 	link: "--rb-surface-link-color",
+	linkHover: "--rb-surface-link-hover-color",
 	supporting: "--rb-surface-supporting-color"
 };
 const DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
+const DEFAULT_SURFACE_LINK_COLOR = "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))";
 const DEFAULT_ROLE_FALLBACKS = {
 	text: DEFAULT_SURFACE_TEXT_COLOR,
 	heading: DEFAULT_SURFACE_TEXT_COLOR,
-	link: "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))",
+	link: DEFAULT_SURFACE_LINK_COLOR,
+	linkHover: DEFAULT_SURFACE_LINK_COLOR,
 	supporting: "rgb(var(--tb-mutedText, 100 116 139))"
 };
 function requireSurfaceColorValue(role, value) {
@@ -931,10 +926,12 @@ function requireSurfaceColorValue(role, value) {
 }
 function completeSurfaceForegrounds(input) {
 	const text = requireSurfaceColorValue("text", input.text);
+	const link = input.link === void 0 ? text : requireSurfaceColorValue("link", input.link);
 	return {
 		text,
 		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
-		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
+		link,
+		linkHover: input.linkHover === void 0 ? link : requireSurfaceColorValue("linkHover", input.linkHover),
 		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
 	};
 }
@@ -942,15 +939,30 @@ function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FAL
 	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
 	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
 	if (role === "text") return `var(${roleVariable}, ${fallback})`;
+	if (role === "linkHover") return `var(${roleVariable}, ${surfaceForegroundValue("link", fallback)})`;
 	return `var(${roleVariable}, var(${SURFACE_FOREGROUND_CSS_VARS.text}, ${fallback}))`;
 }
 function surfaceForegroundValueWithOpacity(role, opacityPercent) {
 	if (!Number.isFinite(opacityPercent) || opacityPercent < 0 || opacityPercent > 100) throw new RangeError("Surface foreground opacity must be between 0 and 100.");
 	return `color-mix(in srgb, ${surfaceForegroundValue(role)} ${opacityPercent}%, transparent)`;
 }
-function surfaceForegroundDeclarations(input) {
+function surfaceForegroundStyle(input) {
 	const foregrounds = completeSurfaceForegrounds(input);
-	return [`color: ${foregrounds.text}`, ...SURFACE_FOREGROUND_ROLES.map((role) => `${SURFACE_FOREGROUND_CSS_VARS[role]}: ${foregrounds[role]}`)];
+	return {
+		color: foregrounds.text,
+		[SURFACE_FOREGROUND_CSS_VARS.text]: foregrounds.text,
+		[SURFACE_FOREGROUND_CSS_VARS.heading]: foregrounds.heading,
+		[SURFACE_FOREGROUND_CSS_VARS.link]: foregrounds.link,
+		[SURFACE_FOREGROUND_CSS_VARS.linkHover]: foregrounds.linkHover,
+		[SURFACE_FOREGROUND_CSS_VARS.supporting]: foregrounds.supporting,
+		"--rb-surface-link-hover-decoration": hoverDecoration(input)
+	};
+}
+function surfaceForegroundDeclarations(input) {
+	return Object.entries(surfaceForegroundStyle(input)).map(([property, value]) => `${property}: ${value};`);
+}
+function hoverDecoration(input) {
+	return input.hoverDecoration ?? "underline";
 }
 //#endregion
 //#region ../theme-core/src/buttons/constants.ts
@@ -3902,6 +3914,12 @@ function cardDecorationPseudoRules(containerSelectors, decorations, resolveColor
 	});
 }
 //#endregion
+//#region ../theme-core/src/utils/cssDeclarations.ts
+/** Render CSS declarations whether callers provide terminators or fragments. */
+function renderCssDeclarations(declarations) {
+	return declarations.map((declaration) => declaration.endsWith(";") ? declaration : `${declaration};`).join("\n  ");
+}
+//#endregion
 //#region ../theme-core/src/cards/core.ts
 /**
 * Core Card CSS Generator
@@ -4004,6 +4022,9 @@ function generateCardCoreCss(scopeId, variants, settings, scope = "all") {
 * A variant's background and, when it owns one, the complete foreground
 * contract that goes with it. Opaque cards are surface providers; transparent
 * variants inherit the nearest outer surface atomically and declare nothing.
+* The SDK bridge has token references but no resolved palette or global prose
+* preference. It therefore publishes the conservative resting hover plus
+* underline through the shared contract instead of claiming measured contrast.
 */
 function cardSurfaceDeclarations(variant) {
 	if (variant.background === "solid" && variant.backgroundToken) return [`background: rgb(var(--tb-${variant.backgroundToken}))`, ...surfaceForegroundDeclarations({ text: `rgb(var(--tb-${variant.foregroundToken ?? "text"}))` })];
@@ -4039,7 +4060,7 @@ function generateVariantCss$1(scopeId, variant, settings, scope = "all") {
 	const mediaRules = mediaCornerRules(variant.cornerRadii, settings.corners);
 	const contentRules = [`padding: ${SPACING_MAP[variant.spacing]}`];
 	return [
-		`${containerSelector} {\n  ${containerRules.join(";\n  ")};\n}`,
+		`${containerSelector} {\n  ${renderCssDeclarations(containerRules)}\n}`,
 		...cardDecorationPseudoRules(containerSelectors, decorations, coreColor),
 		`${fallbackBackgroundSelector} {\n  background: transparent;\n}`,
 		`${mediaSelector} {\n  ${mediaRules.join(";\n  ")};\n}`,
@@ -11911,6 +11932,270 @@ const curatedSiteStyles = [
 ];
 new Map(curatedSiteStyles.map((style) => [style.id, style]));
 //#endregion
+//#region ../theme-core/src/inputs/checkable.ts
+/**
+* Checkbox and radio CSS shared by the full theme generator and the SDK
+* theme bridge, so both render the same customer-facing controls.
+*
+* Emits:
+* - .form-checkbox / .form-radio: the controls themselves. The tick and dot
+*   are drawn with ::before so their colour comes from theme tokens rather
+*   than a baked-in SVG.
+* - .form-check: a label row holding a control and its text. The control
+*   lines up with the first line of text, so long labels wrap cleanly.
+* - .form-check--tile: a bordered, fully clickable panel for agreements
+*   (booking consent, consent fields) that tints when ticked.
+*/
+const CHECKABLE_SIZE = "1.375rem";
+/** Never fully round: a round checkbox reads as a radio. */
+const CHECKBOX_RADIUS = {
+	square: "0",
+	soft: "0.25rem",
+	rounded: "0.375rem",
+	pill: "0.375rem"
+};
+/** Tiles hold wrapping text, so pill themes get a generous radius, not a capsule. */
+const TILE_RADIUS = {
+	square: "0",
+	soft: "0.5rem",
+	rounded: "0.75rem",
+	pill: "1rem"
+};
+const ON_ACCENT_TOKENS = {
+	primary: "onPrimary",
+	secondary: "onSecondary",
+	accent: "onAccent"
+};
+/**
+* Colour for the tick/dot drawn on top of the accent fill. Uses the palette's
+* matching "on" token where there is one, falling back to white.
+*/
+/** The accent at full strength: `primary/70` becomes `primary`. */
+function solidAccentToken(accentToken) {
+	const parsed = parseColorTokenParts(accentToken);
+	return parsed.kind === "token" ? parsed.token : accentToken;
+}
+function checkableMarkColor(accentToken) {
+	const parsed = parseColorTokenParts(accentToken);
+	const onToken = parsed.kind === "token" ? ON_ACCENT_TOKENS[parsed.token] : void 0;
+	return onToken ? `rgb(var(--tb-${onToken}, 255 255 255))` : "rgb(255 255 255)";
+}
+function checkableSelectors(root) {
+	return {
+		checkbox: `${root} .form-checkbox`,
+		radio: `${root} .form-radio`,
+		check: `${root} .form-check`,
+		tile: `${root} .form-check--tile`
+	};
+}
+/** The box and circle themselves, unchecked. */
+function controlBaseCss(sel, input) {
+	const border = input.borderWidth === "0" ? "1px" : input.borderWidth;
+	return [
+		`${sel.checkbox},
+${sel.radio} {
+  appearance: none;
+  display: inline-grid;
+  place-content: center;
+  width: ${CHECKABLE_SIZE};
+  height: ${CHECKABLE_SIZE};
+  margin: 0;
+  flex-shrink: 0;
+  border: ${border} solid ${input.borderColor};
+  background-color: ${input.background};
+  color: inherit;
+  cursor: pointer;
+  transition: background-color 0.15s ease, border-color 0.15s ease, box-shadow 0.15s ease;
+}`,
+		`${sel.checkbox} {
+  border-radius: ${CHECKBOX_RADIUS[input.corners]};
+}`,
+		`${sel.radio} {
+  border-radius: 9999px;
+}`
+	];
+}
+/** The tick and dot, drawn with ::before so their colour is a theme token. */
+function controlMarkCss(sel, accentToken) {
+	return [
+		`${sel.checkbox}::before,
+${sel.radio}::before {
+  content: "";
+  background-color: ${checkableMarkColor(accentToken)};
+  transform: scale(0);
+  transition: transform 0.12s ease;
+}`,
+		`${sel.checkbox}::before {
+  width: 0.75rem;
+  height: 0.75rem;
+  clip-path: polygon(14% 52%, 0 67%, 38% 100%, 100% 22%, 85% 8%, 37% 70%);
+}`,
+		`${sel.radio}::before {
+  width: 0.5rem;
+  height: 0.5rem;
+  border-radius: 9999px;
+}`
+	];
+}
+function controlStateCss(sel, input) {
+	const accent = rgbColorValue(solidAccentToken(input.accentToken));
+	return [
+		`${sel.checkbox}:hover,
+${sel.radio}:hover,
+${sel.check}:hover > .form-checkbox,
+${sel.check}:hover > .form-radio {
+  border-color: ${accent};
+}`,
+		`${sel.checkbox}:checked,
+${sel.radio}:checked {
+  background-color: ${accent};
+  border-color: ${accent};
+}`,
+		`${sel.checkbox}:checked::before,
+${sel.radio}:checked::before {
+  transform: scale(1);
+}`,
+		`${sel.checkbox}:focus-visible,
+${sel.radio}:focus-visible {
+  outline: 2px solid ${accent};
+  outline-offset: 2px;
+}`,
+		`${sel.checkbox}:disabled,
+${sel.radio}:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}`
+	];
+}
+/** Label row: control lined up with the first line of wrapping text. */
+function checkRowCss(sel) {
+	return [
+		`${sel.check} {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.75rem;
+  line-height: 1.5;
+  cursor: pointer;
+}`,
+		`${sel.check} > .form-checkbox,
+${sel.check} > .form-radio {
+  margin-top: 0.0625rem;
+  margin-top: max(0px, calc((1lh - ${CHECKABLE_SIZE}) / 2));
+}`,
+		`${sel.check}:has(> :disabled) {
+  cursor: not-allowed;
+}`
+	];
+}
+function agreementTileCss(sel, input) {
+	const accent = rgbColorValue(solidAccentToken(input.accentToken));
+	return [
+		`${sel.tile} {
+  padding: 0.875rem 1rem;
+  border: 1px solid color-mix(in srgb, currentColor 22%, transparent);
+  border-radius: ${TILE_RADIUS[input.corners]};
+  transition: border-color 0.15s ease, background-color 0.15s ease;
+}`,
+		`${sel.tile}:hover {
+  border-color: color-mix(in srgb, ${accent} 55%, transparent);
+}`,
+		`${sel.tile}:has(> .form-checkbox:checked) {
+  border-color: ${accent};
+  background-color: color-mix(in srgb, ${accent} 7%, transparent);
+}`,
+		`${sel.tile}:has(> .form-checkbox[aria-invalid="true"]) {
+  border-color: ${input.errorColor};
+}`
+	];
+}
+function checkableMediaCss(sel) {
+	return [`@media (prefers-reduced-motion: reduce) {
+  ${sel.checkbox}, ${sel.radio}, ${sel.checkbox}::before, ${sel.radio}::before, ${sel.tile} {
+    transition: none;
+  }
+}`, `@media (forced-colors: active) {
+  ${sel.checkbox}::before,
+  ${sel.radio}::before {
+    background-color: CanvasText;
+  }
+}`];
+}
+/**
+* Exposes the accent and mark colours so other choice controls (newsletter
+* topic chips) match the checkboxes without re-deriving the theme tokens.
+*/
+function checkableVarsCss(input) {
+	return [`${input.root} {
+  --rb-check-accent: ${rgbColorValue(solidAccentToken(input.accentToken))};
+  --rb-check-mark: ${checkableMarkColor(input.accentToken)};
+}`];
+}
+function generateCheckableCss(input) {
+	const sel = checkableSelectors(input.root);
+	return [
+		...checkableVarsCss(input),
+		...controlBaseCss(sel, input),
+		...controlMarkCss(sel, input.accentToken),
+		...controlStateCss(sel, input),
+		...checkRowCss(sel),
+		...agreementTileCss(sel, input),
+		...checkableMediaCss(sel)
+	].join("\n\n");
+}
+//#endregion
+//#region ../theme-core/src/inputs/inputGroup.ts
+/**
+* Input group: a field and an action (usually a themed button) sharing one
+* input-styled shell, e.g. the newsletter email + Sign up row.
+*
+* The shell `.form-input-group` takes the theme's `.form-input` rules (the
+* generators add it to that selector list, plus focus and error), so it
+* follows the site's input background, border, corners and shadow. This file
+* only adds the layout overrides and the borderless inner field.
+*/
+const INPUT_GROUP_SELECTOR = ".form-input-group";
+/** Shell focus ring follows the field only, not the button beside it. */
+const INPUT_GROUP_FOCUS_SELECTOR = ".form-input-group:has(> .form-input-group-field:focus-visible)";
+const INPUT_GROUP_ERROR_SELECTOR = ".form-input-group:has(> .form-input-group-field[aria-invalid=\"true\"])";
+const GROUP_INSET = "0.25rem";
+/**
+* @param root - scoped root selector
+* @param padding - the theme's input padding shorthand (`block inline`), so the
+*   inner field's text sits where a plain input's text would.
+*/
+function generateInputGroupCss(root, padding) {
+	const [block = padding, inline = block] = padding.trim().split(/\s+/);
+	return `${root} .form-input-group {
+  display: flex;
+  align-items: stretch;
+  gap: ${GROUP_INSET};
+  padding: ${GROUP_INSET};
+}
+
+${root} .form-input-group-field {
+  flex: 1 1 auto;
+  min-width: 0;
+  margin: 0;
+  border: 0;
+  border-radius: 0;
+  background: transparent;
+  box-shadow: none;
+  outline: none;
+  color: inherit;
+  font: inherit;
+  padding: calc(${block} - ${GROUP_INSET}) calc(${inline} - ${GROUP_INSET});
+}
+
+${root} .form-input-group-field::placeholder {
+  color: inherit;
+  opacity: 0.6;
+}
+
+${root} .form-input-group > :not(.form-input-group-field) {
+  flex-shrink: 0;
+}`;
+}
+//#endregion
 //#region ../theme-core/src/status/generateStatusCss.ts
 /**
 * Corner radius map - derives alert border-radius from theme.corners
@@ -13213,6 +13498,9 @@ const containerResponsiveThemeCss = `/*
   .rb-h-4 {
     height: 1rem;
   }
+  .rb-h-5 {
+    height: 1.25rem;
+  }
   .rb-h-8 {
     height: 2rem;
   }
@@ -14763,6 +15051,8 @@ const containerResponsiveThemeCss = `/*
     --rb-surface-text-color: var(--rb-modal-text, rgb(var(--tb-text, 17 24 39)));
     --rb-surface-heading-color: var(--rb-modal-heading, var(--rb-modal-text, rgb(var(--tb-text, 17 24 39))));
     --rb-surface-link-color: var(--rb-modal-link, var(--rb-modal-text, rgb(var(--tb-text, 17 24 39))));
+    --rb-surface-link-hover-color: var(--rb-modal-link, var(--rb-modal-text, rgb(var(--tb-text, 17 24 39))));
+    --rb-surface-link-hover-decoration: underline;
     --rb-surface-supporting-color: var(--rb-modal-supporting, var(--rb-modal-text, rgb(var(--tb-text, 17 24 39))));
     border: 1px solid var(--rb-modal-border, rgb(var(--tb-border)));
     border-radius: var(--rb-modal-radius, var(--radius-card));
@@ -15192,14 +15482,18 @@ const containerResponsiveThemeCss = `/*
 
   :where(.theme-scope) .rb-prose a:hover {
     color: var(
-      --rb-prose-link-hover-color,
-      var(--rb-prose-effective-link-color)
+      --rb-surface-link-hover-color,
+      var(--rb-prose-link-hover-color, var(--rb-prose-effective-link-color))
+    );
+    text-decoration-line: var(
+      --rb-surface-link-hover-decoration,
+      var(--rb-prose-link-decoration-line, underline)
     );
     text-decoration-color: var(
       --rb-prose-link-hover-decoration-color,
       var(
-        --rb-prose-link-hover-color,
-        var(--rb-prose-effective-link-color)
+        --rb-surface-link-hover-color,
+        var(--rb-prose-link-hover-color, var(--rb-prose-effective-link-color))
       )
     );
   }
@@ -16243,6 +16537,8 @@ const containerResponsiveThemeCss = `/*
     --rb-surface-text-color: rgb(var(--tb-onSurface, var(--tb-text)));
     --rb-surface-heading-color: rgb(var(--tb-onSurface, var(--tb-text)));
     --rb-surface-link-color: rgb(var(--tb-onSurface, var(--tb-text)));
+    --rb-surface-link-hover-color: rgb(var(--tb-onSurface, var(--tb-text)));
+    --rb-surface-link-hover-decoration: underline;
     --rb-surface-supporting-color: rgb(var(--tb-onSurface, var(--tb-text)));
     border: 1px solid rgb(var(--tb-border));
     border-radius: var(--radius-card);
@@ -16390,6 +16686,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: var(--rb-reg-on-surface, rgb(var(--tb-onSurface, var(--tb-text, 15 23 42))));
   --rb-surface-heading-color: var(--rb-reg-on-surface, rgb(var(--tb-onSurface, var(--tb-text, 15 23 42))));
   --rb-surface-link-color: var(--rb-reg-on-surface, rgb(var(--tb-onSurface, var(--tb-text, 15 23 42))));
+  --rb-surface-link-hover-color: var(--rb-reg-on-surface, rgb(var(--tb-onSurface, var(--tb-text, 15 23 42))));
+  --rb-surface-link-hover-decoration: underline;
   --rb-surface-supporting-color: var(--rb-reg-on-surface-muted, var(--rb-reg-on-surface, rgb(var(--tb-onSurface, var(--tb-text, 15 23 42)))));
   transition: border-color var(--rb-block-transition, 150ms) ease;
   width: 100%;
@@ -17178,6 +17476,10 @@ const containerResponsiveThemeCss = `/*
   margin-bottom: 0.25rem;
 }
 
+:where(.theme-scope) :where([data-block='event-registration']) .er-consent-check {
+  margin-top: 0.75rem;
+}
+
 :where(.theme-scope) :where([data-block='event-registration']) .er-required {
   color: var(--er-required);
 }
@@ -21897,13 +22199,6 @@ const containerResponsiveThemeCss = `/*
   margin: 0;
 }
 
-/* Inline field (checkbox, radio with label) */
-:where(.theme-scope) :where([data-block="form"]) .fb-inline {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-}
-
 /* Success state */
 :where(.theme-scope) :where([data-block="form"]) .fb-success {
   background-color: var(--fb-success-bg);
@@ -22372,6 +22667,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: inherit;
   --rb-surface-heading-color: inherit;
   --rb-surface-link-color: inherit;
+  --rb-surface-link-hover-color: inherit;
+  --rb-surface-link-hover-decoration: inherit;
   --rb-surface-supporting-color: inherit;
 }
 
@@ -22469,6 +22766,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: rgb(var(--tb-text, 17 24 39));
   --rb-surface-heading-color: rgb(var(--tb-text, 17 24 39));
   --rb-surface-link-color: rgb(var(--tb-primary, var(--tb-text, 17 24 39)));
+  --rb-surface-link-hover-color: var(--rb-prose-link-hover-color, rgb(var(--tb-primary, var(--tb-text, 17 24 39))));
+  --rb-surface-link-hover-decoration: initial;
   --rb-surface-supporting-color: rgb(var(--tb-mutedText, 100 116 139));
   border: 1px solid rgb(var(--tb-border));
   border-radius: var(--shop-card-radius);
@@ -22635,6 +22934,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: rgb(var(--tb-text, 17 24 39));
   --rb-surface-heading-color: rgb(var(--tb-text, 17 24 39));
   --rb-surface-link-color: rgb(var(--tb-primary, var(--tb-text, 17 24 39)));
+  --rb-surface-link-hover-color: var(--rb-prose-link-hover-color, rgb(var(--tb-primary, var(--tb-text, 17 24 39))));
+  --rb-surface-link-hover-decoration: initial;
   --rb-surface-supporting-color: rgb(var(--tb-mutedText, 100 116 139));
 }
 
@@ -22712,6 +23013,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: var(--cp-text);
   --rb-surface-heading-color: var(--cp-text);
   --rb-surface-link-color: var(--cp-primary);
+  --rb-surface-link-hover-color: var(--rb-prose-link-hover-color, var(--cp-primary));
+  --rb-surface-link-hover-decoration: initial;
   --rb-surface-supporting-color: var(--cp-muted);
   border: 1px solid var(--cp-card-border);
   border-radius: var(--cp-card-radius);
@@ -22861,6 +23164,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: var(--cp-text);
   --rb-surface-heading-color: var(--cp-text);
   --rb-surface-link-color: var(--cp-primary);
+  --rb-surface-link-hover-color: var(--rb-prose-link-hover-color, var(--cp-primary));
+  --rb-surface-link-hover-decoration: initial;
   --rb-surface-supporting-color: var(--cp-muted);
   border: 1px dashed var(--cp-card-border);
   border-radius: var(--cp-card-radius);
@@ -22878,6 +23183,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: var(--cp-text);
   --rb-surface-heading-color: var(--cp-text);
   --rb-surface-link-color: var(--cp-primary);
+  --rb-surface-link-hover-color: var(--rb-prose-link-hover-color, var(--cp-primary));
+  --rb-surface-link-hover-decoration: initial;
   --rb-surface-supporting-color: var(--cp-muted);
   border: 1px solid var(--cp-card-border);
   border-radius: var(--cp-card-radius);
@@ -23118,6 +23425,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: var(--cp-text);
   --rb-surface-heading-color: var(--cp-text);
   --rb-surface-link-color: var(--cp-primary);
+  --rb-surface-link-hover-color: var(--rb-prose-link-hover-color, var(--cp-primary));
+  --rb-surface-link-hover-decoration: initial;
   --rb-surface-supporting-color: var(--cp-muted);
   border: 1px solid var(--cp-card-border);
   border-radius: var(--cp-card-radius);
@@ -24020,9 +24329,11 @@ const containerResponsiveThemeCss = `/*
  */
 
 /* Newsletter copy styling */
+/* Size only: weight, family and colour come from the theme's heading styles */
 :where(.theme-scope) :where([data-block="newsletter-signup"]) .newsletter-copy-title {
-  font-size: 1.5rem;
-  font-weight: 600;
+  font-size: clamp(1.75rem, 1.35rem + 1.6vw, 2.5rem);
+  line-height: 1.15;
+  text-wrap: balance;
 }
 
 :where(.theme-scope) :where([data-block="newsletter-signup"]) .newsletter-copy-subtitle {
@@ -24046,37 +24357,150 @@ const containerResponsiveThemeCss = `/*
   gap: var(--rb-gap-sm, 0.75rem);
 }
 
-/* Individual field styling */
+/* Extra preset fields (name, company...). Labels are visually hidden, so
+   these sit in a row above the email entry. */
+:where(.theme-scope) .newsletter-extra-fields {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(min(12rem, 100%), 1fr));
+  gap: 0.5rem;
+}
+
 :where(.theme-scope) .newsletter-field {
   display: flex;
   flex-direction: column;
   gap: 0.25rem;
+  text-align: left;
 }
 
-/* Topic choices (visitor picks what to hear about). Same treatment as the
-   form block's .fb-fieldset / .fb-inline, defined here because the newsletter
-   form also renders inside contact-newsletter and the site footer. */
-:where(.theme-scope) .newsletter-topics {
+/* Email entry: the email field and the themed submit button share one shell.
+   The shell's look (background, border, corners, focus ring) comes from the
+   theme's input system via .form-input-group; this only handles layout. */
+:where(.theme-scope) .newsletter-entry {
+  container-type: inline-size;
   display: flex;
   flex-direction: column;
-  gap: 0.5rem;
+  gap: 0.375rem;
+  text-align: left;
+}
+
+:where(.theme-scope) .newsletter-entry-group > button {
+  white-space: nowrap;
+}
+
+/* Too narrow for field and button side by side (phones, footer columns):
+   stack them inside the shell and keep pill themes from turning the taller
+   shell into a capsule. */
+@container (max-width: 22rem) {
+  :where(.theme-scope) .newsletter-entry .newsletter-entry-group {
+    flex-direction: column;
+    border-radius: min(var(--rb-input-radius, 0.5rem), 1rem);
+  }
+
+  :where(.theme-scope) .newsletter-entry .newsletter-entry-group > button {
+    width: 100%;
+    justify-content: center;
+  }
+}
+
+/* Topic choices (visitor picks what to hear about) as toggle chips. Each chip
+   is a real checkbox underneath; the chip is its visible face. */
+:where(.theme-scope) .newsletter-topics {
   border: none;
   padding: 0;
   margin: 0;
   min-width: 0;
 }
 
-:where(.theme-scope) .newsletter-topics > legend {
+:where(.theme-scope) .newsletter-topics-legend {
   padding: 0;
-  margin-bottom: 0.25rem;
+  margin-bottom: 0.625rem;
+  font-size: 0.9375rem;
+  color: var(--rb-surface-text-color, rgb(var(--tb-text, 17 24 39)));
 }
 
-:where(.theme-scope) .newsletter-topic-choice {
+:where(.theme-scope) .newsletter-topic-chips {
   display: flex;
-  align-items: center;
+  flex-wrap: wrap;
   gap: 0.5rem;
 }
 
+:where(.theme-scope) .newsletter-stacked .newsletter-topics-legend {
+  width: 100%;
+}
+
+:where(.theme-scope) .newsletter-stacked .newsletter-topic-chips {
+  justify-content: center;
+}
+
+:where(.theme-scope) .newsletter-topic-chip {
+  position: relative;
+  display: inline-flex;
+}
+
+:where(.theme-scope) .newsletter-topic-chip > input {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  height: 100%;
+  margin: 0;
+  opacity: 0;
+  cursor: pointer;
+}
+
+:where(.theme-scope) .newsletter-topic-chip > span {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  padding: 0.4375rem 0.9375rem;
+  border: 1px solid color-mix(in srgb, currentColor 35%, transparent);
+  border-radius: var(--rb-button-radius, var(--rb-input-radius, 9999px));
+  font-size: 0.9375rem;
+  line-height: 1.3;
+  color: var(--rb-surface-text-color, rgb(var(--tb-text, 17 24 39)));
+  transition: background-color 0.15s ease, border-color 0.15s ease, color 0.15s ease;
+}
+
+/* Tick that grows in when the chip is on */
+:where(.theme-scope) .newsletter-topic-chip > span::before {
+  content: "";
+  width: 0;
+  height: 0.7em;
+  background-color: currentColor;
+  clip-path: polygon(14% 52%, 0 67%, 38% 100%, 100% 22%, 85% 8%, 37% 70%);
+  transition: width 0.15s ease;
+}
+
+:where(.theme-scope) .newsletter-topic-chip:hover > span {
+  border-color: currentColor;
+}
+
+/* Same accent and mark colours as the theme's checkboxes */
+:where(.theme-scope) .newsletter-topic-chip > input:checked + span {
+  background-color: var(--rb-check-accent, rgb(var(--tb-primary)));
+  border-color: var(--rb-check-accent, rgb(var(--tb-primary)));
+  color: var(--rb-check-mark, rgb(var(--tb-onPrimary, 255 255 255)));
+}
+
+:where(.theme-scope) .newsletter-topic-chip > input:checked + span::before {
+  width: 0.7em;
+}
+
+:where(.theme-scope) .newsletter-topic-chip > input:focus-visible + span {
+  outline: 2px solid var(--rb-check-accent, rgb(var(--tb-primary)));
+  outline-offset: 2px;
+}
+
+:where(.theme-scope) .newsletter-topic-chip > input:disabled + span {
+  opacity: 0.6;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  :where(.theme-scope) .newsletter-topic-chip > span,
+  :where(.theme-scope) .newsletter-topic-chip > span::before {
+    transition: none;
+  }
+}
+
 /* Error panel and field notes. The form block scopes these to its own
    data-block, so the newsletter form (which also renders in the footer)
    needs its own copy of the treatment. */
@@ -24094,13 +24518,7 @@ const containerResponsiveThemeCss = `/*
   color: var(--fb-error-text);
 }
 
-/* Required indicator */
-:where(.theme-scope) .newsletter-required {
-  color: rgb(var(--tb-primary));
-  margin-left: 0.125rem;
-}
-
-/* Submit button container */
+/* Submit button container (only when a preset has no email field) */
 :where(.theme-scope) .newsletter-submit {
   margin-top: 0.5rem;
 }
@@ -24112,52 +24530,29 @@ const containerResponsiveThemeCss = `/*
   justify-content: center;
 }
 
-/* Privacy note */
+/* Privacy note: quieter than the intro so the entry row leads */
 :where(.theme-scope) .newsletter-privacy-note {
   margin-top: 0.75rem;
-  font-size: 1rem;
-  line-height: 1.6;
-  color: var(--rb-surface-text-color, rgb(var(--tb-text, 17 24 39)));
+  font-size: 0.8125rem;
+  line-height: 1.5;
+  color: var(--rb-surface-supporting-color, var(--rb-surface-text-color, rgb(var(--tb-text, 17 24 39))));
+  opacity: 0.85;
   text-align: center;
 }
 
 /* =============================================================================
- * Inline Variant - Horizontal layout
+ * Inline Variant - left-aligned, wider entry row
  * =============================================================================
  */
 
-:where(.theme-scope) .newsletter-inline .newsletter-form-fields {
-  flex-direction: row;
-  align-items: flex-end;
-  flex-wrap: wrap;
-  gap: var(--rb-gap-sm, 0.75rem);
-}
-
-:where(.theme-scope) .newsletter-inline .newsletter-field {
-  flex: 1 1 auto;
-  min-width: 10rem;
-}
-
-:where(.theme-scope) .newsletter-inline .newsletter-submit {
-  margin-top: 0;
-  flex-shrink: 0;
-}
-
-:where(.theme-scope) .newsletter-inline .newsletter-topics {
-  flex-basis: 100%;
+:where(.theme-scope) .newsletter-inline .newsletter-form {
+  max-width: 40rem;
+  margin-left: 0;
+  margin-right: 0;
 }
 
-/* Mobile fallback for inline variant */
-@container rb-site (max-width: 640px) {
-@scope ([data-rb-responsive-mode="container"]) to (:scope [data-rb-responsive-mode]) {
-:where(.theme-scope) .newsletter-inline .newsletter-form-fields {
-    flex-direction: column;
-  }
-
-  :where(.theme-scope) .newsletter-inline .newsletter-field {
-    min-width: 100%;
-  }
-}
+:where(.theme-scope) .newsletter-inline .newsletter-privacy-note {
+  text-align: left;
 }
 
 /* =============================================================================
@@ -24295,12 +24690,6 @@ const containerResponsiveThemeCss = `/*
   margin: 0;
 }
 
-:where(.theme-scope) :where([data-block="contact-newsletter"]) .fb-inline {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-}
-
 :where(.theme-scope) :where([data-block="contact-newsletter"]) .fb-success,
 :where(.theme-scope) :where([data-block="contact-newsletter"]) .fb-error,
 :where(.theme-scope) :where([data-block="contact-newsletter"]) .fb-empty {
@@ -25701,6 +26090,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: rgb(var(--tb-onSecondary));
   --rb-surface-heading-color: rgb(var(--tb-onSecondary));
   --rb-surface-link-color: rgb(var(--tb-onSecondary));
+  --rb-surface-link-hover-color: rgb(var(--tb-onSecondary));
+  --rb-surface-link-hover-decoration: underline;
   --rb-surface-supporting-color: rgb(var(--tb-onSecondary));
 }
 
@@ -25832,6 +26223,8 @@ const containerResponsiveThemeCss = `/*
   --rb-surface-text-color: rgb(var(--tb-onPrimary));
   --rb-surface-heading-color: rgb(var(--tb-onPrimary));
   --rb-surface-link-color: rgb(var(--tb-onPrimary));
+  --rb-surface-link-hover-color: rgb(var(--tb-onPrimary));
+  --rb-surface-link-hover-decoration: underline;
   --rb-surface-supporting-color: color-mix(in oklab, rgb(var(--tb-onPrimary)), transparent 18%);
 }
 
@@ -26197,6 +26590,44 @@ const containerResponsiveThemeCss = `/*
     flex: 0 0 auto;
   }
 }
+}
+
+/* =============================================================================
+ * Site footer: social links
+ *
+ * Icon links get a 40px tap target with a hairline ring drawn from the link's
+ * own colour, so it follows the footer's text colour on any surface. Links
+ * without an icon (unknown platforms) stay plain text.
+ * =============================================================================
+ */
+
+:where(.theme-scope) .rb-footer-socials {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.75rem 1.25rem;
+}
+
+:where(.theme-scope) .rb-footer-social-link:has(> .rb-footer-social-icon) {
+  display: inline-grid;
+  place-items: center;
+  width: 2.5rem;
+  height: 2.5rem;
+  border: 1px solid color-mix(in srgb, currentColor 22%, transparent);
+  border-radius: 9999px;
+}
+
+:where(.theme-scope) .rb-footer-socials:has(.rb-footer-social-icon) {
+  gap: 0.5rem;
+}
+
+:where(.theme-scope) .rb-footer-social-link:has(> .rb-footer-social-icon):hover {
+  border-color: currentColor;
+}
+
+:where(.theme-scope) .rb-footer-social-icon {
+  width: 1.5rem;
+  height: 1.5rem;
 }`;
 //#endregion
 //#region ../theme-core/src/ThemeScopeCore.tsx
@@ -26446,6 +26877,7 @@ const BORDER_WIDTH_MAP = {
 	medium: "2px",
 	thick: "4px"
 };
+const INPUT_PADDING = "0.5rem 0.75rem";
 const SHADOW_VALUES = {
 	none: "none",
 	low: "0 1px 2px rgba(0,0,0,0.04)",
@@ -26479,16 +26911,18 @@ function generateInputCoreCss(scopeId, settings) {
   color: rgb(var(--tb-${settings.textToken}));
   border: ${borderWidth} solid rgb(var(--tb-${settings.borderToken}));
   border-radius: ${borderRadius};
-  padding: 0.5rem 0.75rem;
+  padding: ${INPUT_PADDING};
   font-size: 1rem;
   width: 100%;
   outline: none;
   transition: border-color 0.2s ease, box-shadow 0.2s ease;
   ${settings.shadow !== "none" ? `box-shadow: ${SHADOW_VALUES[settings.shadow]};` : ""}
 `.trim();
-	cssBlocks.push(`${root} .form-input {
+	cssBlocks.push(`${root} .form-input,
+${root} ${INPUT_GROUP_SELECTOR} {
   ${sharedInputRules}
 }`);
+	cssBlocks.push(generateInputGroupCss(root, INPUT_PADDING));
 	cssBlocks.push(`${root} .form-textarea {
   ${sharedInputRules}
   resize: vertical;
@@ -26505,14 +26939,16 @@ function generateInputCoreCss(scopeId, settings) {
 }`);
 	cssBlocks.push(`${root} .form-input:focus-visible,
 ${root} .form-textarea:focus-visible,
-${root} .form-select:focus-visible {
+${root} .form-select:focus-visible,
+${root} ${INPUT_GROUP_FOCUS_SELECTOR} {
   outline: none;
   box-shadow: 0 0 0 ${settings.focusRingWidth}px rgb(var(--tb-${settings.focusRingToken}));
   border-color: rgb(var(--tb-${settings.focusRingToken}));
 }`);
 	cssBlocks.push(`${root} .form-input[aria-invalid="true"],
 ${root} .form-textarea[aria-invalid="true"],
-${root} .form-select[aria-invalid="true"] {
+${root} .form-select[aria-invalid="true"],
+${root} ${INPUT_GROUP_ERROR_SELECTOR} {
   border-color: rgb(var(--tb-${settings.errorBorderToken}));
   color: rgb(var(--tb-${settings.errorTextToken}));
 }`);
@@ -26524,46 +26960,15 @@ ${root} .form-select:disabled {
   opacity: 0.6;
   cursor: not-allowed;
 }`);
-	cssBlocks.push(`${root} .form-checkbox {
-  appearance: none;
-  width: 1.125rem;
-  height: 1.125rem;
-  flex-shrink: 0;
-  border: ${borderWidth} solid rgb(var(--tb-${settings.borderToken}));
-  border-radius: 0.25rem;
-  background-color: rgb(var(--tb-${settings.backgroundToken}));
-  cursor: pointer;
-  transition: background-color 0.2s ease, border-color 0.2s ease;
-}`);
-	cssBlocks.push(`${root} .form-radio {
-  appearance: none;
-  width: 1.125rem;
-  height: 1.125rem;
-  flex-shrink: 0;
-  border: ${borderWidth} solid rgb(var(--tb-${settings.borderToken}));
-  border-radius: 9999px;
-  background-color: rgb(var(--tb-${settings.backgroundToken}));
-  cursor: pointer;
-  transition: background-color 0.2s ease, border-color 0.2s ease;
-}`);
-	cssBlocks.push(`${root} .form-checkbox:checked {
-  background-color: rgb(var(--tb-${settings.focusRingToken}));
-  border-color: rgb(var(--tb-${settings.focusRingToken}));
-  background-image: url("data:image/svg+xml,%3csvg viewBox='0 0 16 16' fill='white' xmlns='http://www.w3.org/2000/svg'%3e%3cpath d='M12.207 4.793a1 1 0 010 1.414l-5 5a1 1 0 01-1.414 0l-2-2a1 1 0 011.414-1.414L6.5 9.086l4.293-4.293a1 1 0 011.414 0z'/%3e%3c/svg%3e");
-  background-size: 100% 100%;
-  background-position: center;
-  background-repeat: no-repeat;
-}`);
-	cssBlocks.push(`${root} .form-radio:checked {
-  background-color: rgb(var(--tb-${settings.focusRingToken}));
-  border-color: rgb(var(--tb-${settings.focusRingToken}));
-  background-image: radial-gradient(circle, white 40%, transparent 40%);
-}`);
-	cssBlocks.push(`${root} .form-checkbox:focus-visible,
-${root} .form-radio:focus-visible {
-  outline: none;
-  box-shadow: 0 0 0 ${settings.focusRingWidth}px rgb(var(--tb-${settings.focusRingToken}));
-}`);
+	cssBlocks.push(generateCheckableCss({
+		root,
+		borderWidth,
+		borderColor: `rgb(var(--tb-${settings.borderToken}))`,
+		background: `rgb(var(--tb-${settings.backgroundToken}))`,
+		corners: settings.corners,
+		accentToken: settings.focusRingToken,
+		errorColor: `rgb(var(--tb-${settings.errorBorderToken}))`
+	}));
 	return cssBlocks.join("\n\n");
 }
 /**