@riverbankcms/sdk 0.146.0 → 0.148.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}`,
@@ -15030,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));
@@ -15459,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))
       )
     );
   }
@@ -16510,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);
@@ -16657,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%;
@@ -22636,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;
 }
 
@@ -22733,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);
@@ -22899,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));
 }
 
@@ -22976,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);
@@ -23125,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);
@@ -23142,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);
@@ -23382,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);
@@ -26045,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));
 }
 
@@ -26176,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%);
 }
 

package/dist/server/theme.mjs

@@ -1167,13 +1167,16 @@ 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) {
@@ -1185,6 +1188,7 @@ 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}))`;
 }
 //#endregion

package/dist/styles/index.css

@@ -1841,6 +1841,8 @@
     --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));
@@ -2268,14 +2270,18 @@
 
   :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))
       )
     );
   }
@@ -3309,6 +3315,8 @@
     --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);
@@ -3450,6 +3458,8 @@
   --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%;
@@ -9410,6 +9420,8 @@
   --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;
 }
 
@@ -9505,6 +9517,8 @@
   --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);
@@ -9669,6 +9683,8 @@
   --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));
 }
 
@@ -9745,6 +9761,8 @@
   --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);
@@ -9894,6 +9912,8 @@
   --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);
@@ -9911,6 +9931,8 @@
   --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);
@@ -10149,6 +10171,8 @@
   --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);
@@ -12810,6 +12834,8 @@
   --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));
 }
 
@@ -12939,6 +12965,8 @@
   --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%);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riverbankcms/sdk",
-  "version": "0.146.0",
+  "version": "0.148.0",
   "description": "Riverbank CMS SDK for headless content consumption",
   "main": "./dist/server/index.mjs",
   "module": "./dist/server/index.mjs",

package/dist/_dts/billing/src/plans/display.d.ts

@@ -1,15 +0,0 @@
-import { type BillingPlanId } from './types';
-/**
- * What each plan is called in front of a customer.
- *
- * It lives apart from the registry because the registry reaches Stripe on
- * import, and a name is the one thing a browser bundle needs. The registry
- * reads its `name` fields from here, so there is still one source.
- */
-export declare const BILLING_PLAN_NAMES: {
-    readonly free: "Free";
-    readonly core: "Core";
-    readonly solo: "Solo";
-    readonly studio: "Studio";
-};
-export declare function billingPlanName(planId: BillingPlanId): string;

package/dist/_dts/content-editor/src/controller/buildBlockPublishedBaselines.d.ts

@@ -1,4 +0,0 @@
-import { type EditorBlockPublishedBaselineInput } from '../../../core/src/index';
-import type { BlockItem } from '../../../editor-blocks/src/block-editor/types';
-export type BlockPublishedBaselineInput = EditorBlockPublishedBaselineInput;
-export declare function buildBlockPublishedBaselines(blocks: readonly BlockItem[]): BlockPublishedBaselineInput[];

package/dist/_dts/content-editor/src/controller/buildPublishSuccessTransition.d.ts

@@ -1,16 +0,0 @@
-import type { PublishedBlockBaseline } from "../../../api/src/content-editor";
-import { type ContentEntrySnapshot, type RoutingHelpers } from "../../../content-model/src/index";
-import type { BlockPublishedBaselineInput } from "./buildBlockPublishedBaselines";
-export type PublishSuccessTransition = Readonly<{
-    metadataPublishedBaseline: Record<string, unknown> | null;
-    contentPublishedBaseline: Record<string, unknown> | null;
-    blockPublishedBaselines: readonly BlockPublishedBaselineInput[] | null;
-}>;
-type BuildPublishSuccessTransitionInput = Readonly<{
-    nextEntry: ContentEntrySnapshot;
-    routing?: RoutingHelpers;
-    publishedContent: Record<string, unknown> | null;
-    publishedBlocks?: readonly PublishedBlockBaseline[] | undefined;
-}>;
-export declare function buildPublishSuccessTransition(input: BuildPublishSuccessTransitionInput): PublishSuccessTransition;
-export {};

package/dist/_dts/content-editor/src/controller/driver.d.ts

@@ -1,14 +0,0 @@
-export type EntryEditorDriver = {
-    fetchEntry?: (siteId: string, type: string, entryId: string) => Promise<unknown>;
-    listBlocks?: (siteId: string, pageId: string) => Promise<unknown[]>;
-    createBlock?: (siteId: string, pageId: string, input: Record<string, unknown>) => Promise<unknown>;
-    reorderBlocks?: (siteId: string, pageId: string, order: Array<{
-        id: string;
-        position: number;
-    }>) => Promise<void>;
-    deleteBlock?: (siteId: string, blockId: string) => Promise<void>;
-    saveBlockContent?: (siteId: string, blockId: string, content: Record<string, unknown>) => Promise<unknown>;
-    updateMetadata?: (siteId: string, type: string, entryId: string, payload: Record<string, unknown>) => Promise<unknown>;
-    publish?: (siteId: string, type: string, entryId: string, payload?: unknown) => Promise<void>;
-    discard?: (siteId: string, type: string, entryId: string) => Promise<void>;
-};

package/dist/_dts/content-editor/src/controller/seedDraftBaselinesFromBlocks.d.ts

@@ -1,7 +0,0 @@
-import { type BlockItem } from '../../../editor-blocks/src/index';
-import type { EditorUiState } from '../ui/editorUiStore';
-type StoreApi<T> = {
-    getState: () => T;
-};
-export declare function seedDraftBaselinesFromBlocks(uiStore: StoreApi<EditorUiState>, blocks: readonly BlockItem[]): void;
-export {};

package/dist/_dts/content-editor/src/controller/useEntrySyncHelpers.d.ts

@@ -1,29 +0,0 @@
-import type { ContentEntrySnapshot } from '../../../content-model/src/index';
-import type { EditorUiStoreInstance } from '../ui/editorUiStore';
-type UseEntrySyncHelpersProps = {
-    uiStore: EditorUiStoreInstance;
-    setErrorMessage: (msg: string | null) => void;
-};
-/**
- * Hook that provides helpers for synchronizing entry snapshots with store state.
- *
- * Responsibilities:
- * - Create metadata snapshots from entry data
- * - Update store to match new snapshot
- * - Handle autosave success/error callbacks
- */
-export declare function useEntrySyncHelpers({ uiStore, setErrorMessage, }: UseEntrySyncHelpersProps): {
-    syncEntry: (nextEntry: ContentEntrySnapshot, opts?: {
-        clearError?: boolean;
-    }) => {
-        values: import("../../../content-model/src/index").RoutableMetadataValues | Record<string, never>;
-        baseline: import("../../../content-model/src/index").RoutableMetadataValues | Record<string, never>;
-    };
-    resetFromSnapshot: (snapshot: {
-        baseline: Record<string, unknown>;
-        values: Record<string, unknown>;
-    }) => void;
-    handleMetadataAutosaveSuccess: (nextEntry: ContentEntrySnapshot) => void;
-    markAutosaveError: (error: unknown) => string;
-};
-export {};

package/dist/_dts/content-editor/src/hooks/autosaveScopePlanning.d.ts

@@ -1,26 +0,0 @@
-import type { EditorSyncState } from '../../../core/src/index';
-import type { LinkedContentEntryId } from '../linkedEntries/domain';
-import type { AutosaveStatus } from '../ui/stores/types';
-export { unsafeAsLinkedContentEntryId, type LinkedContentEntryId, } from '../linkedEntries/domain';
-export type EditorAutosaveScope = Readonly<{
-    kind: 'metadata';
-}> | Readonly<{
-    kind: 'content';
-}> | Readonly<{
-    kind: 'blocks';
-}> | Readonly<{
-    kind: 'linkedEntry';
-    entryId: LinkedContentEntryId;
-}>;
-export type EditorAutosaveSchedulerKey = 'metadata' | 'content' | 'blocks' | 'linkedEntries';
-export type AutosaveScopeSnapshot = Readonly<{
-    scope: EditorAutosaveScope;
-    syncState: EditorSyncState;
-}>;
-export type AutosaveStatusByScheduler = Readonly<Record<EditorAutosaveSchedulerKey, AutosaveStatus>>;
-export declare function autosaveScopeKey(scope: EditorAutosaveScope): string;
-export declare function autosaveSchedulerKey(scope: EditorAutosaveScope): EditorAutosaveSchedulerKey;
-export declare function uniqueAutosaveSchedulerKeys(scopes: readonly EditorAutosaveScope[]): EditorAutosaveSchedulerKey[];
-export declare function deriveDirtyAutosaveScopes(snapshots: readonly AutosaveScopeSnapshot[]): EditorAutosaveScope[];
-export declare function hasAutosaveStatusFailure(statuses: AutosaveStatusByScheduler): boolean;
-export declare function allAutosaveStatusesComplete(statuses: AutosaveStatusByScheduler): boolean;

package/dist/_dts/content-editor/src/hooks/useSimpleAutosave.d.ts

@@ -1,64 +0,0 @@
-import type { DraftWorkflowStatus } from '../types';
-import type { EditorUiStoreInstance } from '../ui/editorUiStore';
-/**
- * Autosave hook backed by the shared debounced-latest-save scheduler.
- * New changes made while a save is in flight queue one follow-up save with the
- * latest snapshot instead of blocking the editor or starting parallel writes.
- *
- * Status is stored in the Zustand uiStore instead of local state, allowing
- * components to subscribe granularly via selectors.
- */
-type AutosaveConfig<TValues, TPayload> = {
-    /** Function to call to save the data */
-    saveFn: (payload: TPayload) => Promise<unknown>;
-    /** Build the save payload from current values */
-    buildPayload: (values: TValues) => TPayload;
-    /** Get current values (e.g., from form) */
-    getValues: () => TValues;
-    /** Check if save should be skipped (e.g., empty title) */
-    shouldSkip?: (values: TValues) => boolean;
-    /** Callback after successful save - receives result AND ref to the values that were sent */
-    onSuccess?: (result: unknown, sentValuesRef: {
-        current: TValues | null;
-    }) => void;
-    /** Callback after failed save */
-    onError?: (error: unknown) => void;
-    /** Debounce delay in ms (default: 1500) */
-    delay?: number;
-    /** Maximum wait time in ms (default: 10000) */
-    maxWait?: number;
-    /** Whether autosave is enabled */
-    enabled?: boolean;
-    /** UI store instance for updating autosave status */
-    uiStore: EditorUiStoreInstance;
-    /** Which autosave scheduler this hook updates */
-    type: 'metadata' | 'blocks' | 'content' | 'linkedEntries';
-};
-export type AutosaveHandle = {
-    trigger: () => void;
-    cancel: () => void;
-    flush: () => void | Promise<void>;
-    isPending: () => boolean;
-};
-export declare function useSimpleAutosave<TValues = Record<string, unknown>, TPayload = unknown>(config: AutosaveConfig<TValues, TPayload>): AutosaveHandle;
-/**
- * Hook for aggregating autosave status from the uiStore.
- * Reads metadata + blocks status and combines them for display.
- *
- * @deprecated Use useEditorUiStore with selector instead:
- * ```tsx
- * const status = useEditorUiStore(state => {
- *   const meta = state.autosave.metadata
- *   const blocks = state.autosave.blocks
- *   // ... combine logic
- * })
- * ```
- */
-export declare function useMultiAutosave(instances: Array<{
-    status: DraftWorkflowStatus;
-    hasFailedSaves: boolean;
-}>): {
-    status: DraftWorkflowStatus;
-    hasFailedSaves: boolean;
-};
-export {};

package/dist/_dts/content-editor/src/hooks/useStoreAutosave.d.ts

@@ -1,48 +0,0 @@
-import { type RefObject } from 'react';
-import type { EditorBlockId } from '../../../core/src/index';
-import { type AutosaveHandle } from './useSimpleAutosave';
-import type { EditorUiStoreInstance } from '../ui/editorUiStore';
-/**
- * Scope for store-backed autosave.
- * Can be a string for simple scopes ('metadata', 'content') or an object for scoped instances (blocks).
- */
-export type AutosaveScope = 'metadata' | 'content' | {
-    type: 'block';
-    blockId: EditorBlockId;
-};
-/**
- * Configuration for unified store-backed autosave.
- */
-export type StoreAutosaveConfig<TPayload extends Record<string, unknown>, TResponse> = {
-    /** Store scope to autosave (metadata, content, or block) */
-    scope: AutosaveScope;
-    /** UI store instance */
-    uiStore: EditorUiStoreInstance;
-    /** Function to save data to the server */
-    saveFn: (payload: TPayload) => Promise<TResponse>;
-    /** Extract saved values from server response for store update */
-    extractSavedValues: (response: TResponse) => Record<string, unknown> | null;
-    /** Optional error handler (called in addition to store.autosaveFailed) */
-    onError?: (error: unknown) => void;
-    /** Debounce delay in ms (default: 1500) */
-    delay?: number;
-    /** Maximum wait time in ms (default: 10000) */
-    maxWait?: number;
-    /** Optional ref to skip autosave (e.g., during initial hydration) */
-    skipInitialRef?: RefObject<boolean>;
-    /** Optional function to check if save should be skipped based on current values */
-    shouldSkip?: (values: Record<string, unknown>) => boolean;
-};
-/**
- * Unified autosave hook for store-backed forms.
- *
- * Handles the common pattern:
- * 1. Get current values from store scope
- * 2. Save to server
- * 3. Extract saved values from response
- * 4. Update store baseline via autosaveSucceeded
- * 5. Handle concurrent edit detection
- *
- * This eliminates code duplication between metadata, content, and block autosave flows.
- */
-export declare function useStoreAutosave<TPayload extends Record<string, unknown>, TResponse>(config: StoreAutosaveConfig<TPayload, TResponse>): AutosaveHandle;