@riverbankcms/sdk 0.101.0 → 0.103.0

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

@@ -4,7 +4,7 @@ import { surfaceVariants } from './surface';
 export type CardVariant = VariantProps<typeof surfaceVariants>['variant'];
 export type CardRadius = VariantProps<typeof surfaceVariants>['radius'];
 declare const cardLayoutVariants: (props?: ({
-    size?: "none" | "compact" | "default" | "responsive" | null | undefined;
+    size?: "default" | "none" | "compact" | "responsive" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export type CardSize = VariantProps<typeof cardLayoutVariants>['size'];
 export type CardProps = React.ComponentProps<'div'> & {

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

@@ -2,11 +2,11 @@ import * as React from "react";
 import * as TogglePrimitive from "@radix-ui/react-toggle";
 import { type VariantProps } from "class-variance-authority";
 declare const toggleVariants: (props?: ({
-    variant?: "outline" | "default" | null | undefined;
+    variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare const Toggle: React.ForwardRefExoticComponent<Omit<TogglePrimitive.ToggleProps & React.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
-    variant?: "outline" | "default" | null | undefined;
+    variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string> & React.RefAttributes<HTMLButtonElement>>;
 export { Toggle, toggleVariants };

package/dist/cli/index.mjs

@@ -7459,7 +7459,9 @@ var DEFAULT_LOCALE, FALLBACK_TIMEZONE, DEFAULT_BOOKING_DATE_TIME_FORMAT, LOCAL_D
 	};
 	LOCAL_DATE_PATTERN = /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$/u;
 }));
-var init_person_records = __esmMin((() => {}));
+var init_person_records = __esmMin((() => {
+	init_result();
+}));
 var init_rectification = __esmMin((() => {}));
 //#endregion
 //#region ../core/src/location.ts
@@ -8178,15 +8180,19 @@ function slugifyMediaIdentifier(value) {
 function buildMediaIdentifierFromFilename(filename) {
 	return slugifyMediaIdentifier(stripFileExtension(filename));
 }
+function unsafeAsMediaIdentifier(value) {
+	return value;
+}
 function resolveMediaIdentifier(base, existing) {
 	const seed = slugifyMediaIdentifier(base) || FALLBACK_IDENTIFIER;
-	if (!existing.has(seed)) return seed;
+	if (!existing.has(seed)) return unsafeAsMediaIdentifier(seed);
 	let index = 1;
 	while (existing.has(`${seed}-${index}`)) index += 1;
-	return `${seed}-${index}`;
+	return unsafeAsMediaIdentifier(`${seed}-${index}`);
 }
 var FALLBACK_IDENTIFIER, extensionPattern;
 var init_identifiers = __esmMin((() => {
+	init_src$4();
 	FALLBACK_IDENTIFIER = "media";
 	extensionPattern = /\.[^/.]+$/;
 }));
@@ -18192,6 +18198,7 @@ var init_rawStyleFields = __esmMin((() => {
 		"_sectionStyles",
 		"_containerStyles",
 		"_cardStyles",
+		"_transitionStyles",
 		"styleGroup"
 	];
 	themeV2BlockSpecificRawStyleFieldNames = [
@@ -18956,6 +18963,8 @@ var init_schema = __esmMin((() => {
 		navStyle: headerNavStyle,
 		navColor: themeColorTokenSchema.nullable().optional(),
 		navWeight: navFontWeight.default("medium"),
+		navTypography: z$1.enum(["body", "heading"]).optional(),
+		navTextSize: navLinkStyleSchema.shape.textSize,
 		container: headerContainerSchema,
 		border: headerBorderSchema,
 		shadow: componentShadowSchema.optional(),
@@ -20620,9 +20629,22 @@ var init_backgroundAppearance = __esmMin((() => {
 }));
 var init_compositionBudget = __esmMin((() => {
 	init_types$17();
-})), init_schemaVersionedJson = __esmMin((() => {})), noneBoundaryOption, softBoundaryOption, spaciousBoundaryOption;
+}));
+var init_schemaVersionedJson = __esmMin((() => {}));
+//#endregion
+//#region ../theme-core/src/site-styles/sectionTransitions.ts
+function boundaryRuntimeMetrics(family, size, heightExpression) {
+	return {
+		family,
+		size,
+		heightCss: heightExpression.includes(" ") ? `calc(${heightExpression})` : heightExpression,
+		reserveCss: `calc((${heightExpression}) / 2)`
+	};
+}
+var noneBoundaryOption, softBoundaryOption, spaciousBoundaryOption;
 var init_sectionTransitions = __esmMin((() => {
 	init_types$17();
+	boundaryRuntimeMetrics("gradient", "medium", "6rem + 2px"), boundaryRuntimeMetrics("gradient", "spacious", "10rem"), boundaryRuntimeMetrics("gradient", "expansive", "14rem"), boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"), boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"), boundaryRuntimeMetrics("wave", "compact", "4.5rem + 2px"), boundaryRuntimeMetrics("wave", "large", "7rem + 2px"), boundaryRuntimeMetrics("wave", "medium", "6rem + 2px"), boundaryRuntimeMetrics("angle", "medium", "6rem + 2px"), boundaryRuntimeMetrics("angle", "compact", "4.5rem + 2px"), boundaryRuntimeMetrics("angle", "large", "7rem + 2px");
 	noneBoundaryOption = {
 		id: asBoundaryOptionId("break:none"),
 		label: "None",
@@ -20687,12 +20709,12 @@ function validateUniquePageDesignPins(intent, ctx) {
 		label: "block Look pin"
 	});
 	addDuplicateStringIssues(ctx, {
-		values: intent.boundaryPins.map((pin) => boundaryKey(pin.previousBlockId, pin.nextBlockId)),
+		values: intent.boundaryPins.map((pin) => boundaryKey$1(pin.previousBlockId, pin.nextBlockId)),
 		path: ["boundaryPins"],
 		label: "boundary pin"
 	});
 }
-function boundaryKey(previousBlockId, nextBlockId) {
+function boundaryKey$1(previousBlockId, nextBlockId) {
 	return makeBoundaryId(previousBlockId, nextBlockId);
 }
 var pageDesignUserPinnedAppearanceChoiceSchema, pageDesignUserPinnedBoundaryChoiceSchema, pageDesignBoundaryTreatmentSchema, pageDesignUserPinnedBoundaryTreatmentChoiceSchema, pageDesignBlockLookPinSchema, pageDesignBoundaryPinSchema, legacyPageDesignBoundaryPinSchema;
@@ -21140,7 +21162,7 @@ function asHeaderStyleId(value) {
 * optional nested styling fields that would otherwise leak from another Look.
 */
 function baseHeader(theme) {
-	const { navLinkStyle: _navLinkStyle, dropdownStyle: _dropdownStyle, ctaVariant: _ctaVariant, navContainer: _navContainer, container: _container, shadow: _shadow, logo: _logo, logoText: _logoText, border: _border, ...header } = theme.header;
+	const { navLinkStyle: _navLinkStyle, navTypography: _navTypography, navTextSize: _navTextSize, dropdownStyle: _dropdownStyle, ctaVariant: _ctaVariant, navContainer: _navContainer, container: _container, shadow: _shadow, logo: _logo, logoText: _logoText, border: _border, ...header } = theme.header;
 	return {
 		...header,
 		navContainer: {
@@ -21616,12 +21638,12 @@ var init_headerLooks = __esmMin((() => {
 		},
 		{
 			id: asHeaderStyleId("fine-line"),
-			label: "Fine Line",
-			description: "Light surface with a crisp lower rule and underline hover.",
+			label: "Seamless",
+			description: "Borderless surface with underline hover for a quieter page transition.",
 			supportedLayoutIds: supportedLayouts(["classic", "centered"]),
 			navInteraction: "underline-grow",
-			surface: "bordered",
-			defaultDepth: "line",
+			surface: "neutral",
+			defaultDepth: "none",
 			navTypography: "plain",
 			moods: [
 				"calm",
@@ -23291,6 +23313,7 @@ var init_runtimeCompiler = __esmMin((() => {
 	init_designState();
 	init_types$17();
 	init_accessibleSurfaces();
+	init_sectionTransitions();
 	defaultDesignRuntimeRules = defineDesignRuntimeRules({
 		sectionSurfaces: {
 			base: {},
@@ -25088,13 +25111,15 @@ function toSiteChromeBackgroundColorTokens(tokenNames) {
 		return token ? [token] : [];
 	});
 }
-var siteChromeBackgroundColorTokens, quickSiteChromeBackgroundColorTokens, init_siteChromeBackgrounds = __esmMin((() => {
+var siteChromeBackgroundColorTokens, quickSiteChromeBackgroundColorTokens;
+var init_siteChromeBackgrounds = __esmMin((() => {
 	init_backgroundAppearance();
 	init_rawStyleFields();
 	siteChromeBackgroundColorTokens = toSiteChromeBackgroundColorTokens(backgroundAppearanceColorTokenNames);
 	quickSiteChromeBackgroundColorTokens = toSiteChromeBackgroundColorTokens(backgroundAppearanceQuickColorTokenNames);
 	siteChromeBackgroundColorTokens.filter((token) => !quickSiteChromeBackgroundColorTokens.includes(token));
-})), themeTokenRecipeOptions;
+}));
+var init_siteChromeNavPreferences = __esmMin((() => {})), themeTokenRecipeOptions;
 var init_tokenRecipes = __esmMin((() => {
 	themeTokenRecipeOptions = {
 		palette: [
@@ -25179,6 +25204,7 @@ var init_site_styles = __esmMin((() => {
 	init_runtimeCompiler();
 	init_sectionTransitions();
 	init_siteChromeBackgrounds();
+	init_siteChromeNavPreferences();
 	init_siteStyleThemeCompiler();
 	init_siteStyleBlockPolicies();
 	init_sourceCatalogs();
@@ -41917,6 +41943,7 @@ const eventListingBlockDefinition = {
 					} },
 					seeAllUrl: { $bind: {
 						from: "content.seeAllUrl",
+						fallback: "",
 						transforms: [{ id: "links.resolve" }]
 					} },
 					loadMoreText: { $bind: {
@@ -42310,6 +42337,7 @@ const eventCalendarLayout = [styledSection({
 			} },
 			seeAllUrl: { $bind: {
 				from: "content.seeAllUrl",
+				fallback: "",
 				transforms: [{ id: "links.resolve" }]
 			} },
 			loadMoreText: { $bind: {
@@ -50005,15 +50033,15 @@ function Grid({ as: Comp = "div", cols = {
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/layout.tsx
-const SectionNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, allowOverflow, ...props }) => /* @__PURE__ */ jsx(Section, {
+const SectionNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, allowOverflow, ...props }) => /* @__PURE__ */ jsx(Section, {
 	...props,
 	allowOverflow
 });
-const StackNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Stack, { ...props });
-const InlineNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Inline, { ...props });
-const GridNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Grid, { ...props });
-const DivNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx("div", { ...props });
-const FigureNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx("figure", { ...props });
+const StackNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Stack, { ...props });
+const InlineNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Inline, { ...props });
+const GridNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx(Grid, { ...props });
+const DivNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx("div", { ...props });
+const FigureNode = ({ blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, previewAuthoring: _previewAuthoring, pathBase: _pathBase, ...props }) => /* @__PURE__ */ jsx("figure", { ...props });
 //#endregion
 //#region ../path-utils/src/index.ts
 const PATH_SEPARATOR_REGEX$1 = /\./g;
@@ -58359,6 +58387,7 @@ function applyTransformsAndFallback(value, binding, context) {
 		viewModel: context.viewModel
 	}, transforms);
 	if (binding.transforms && binding.transforms.length > 0 && transformed === null) {
+		if (binding.fallback !== void 0) return binding.fallback;
 		if (process.env.NODE_ENV === "development") console.warn("[block-system] Transform returned null for binding", {
 			bindingFrom: binding.from,
 			transforms: binding.transforms?.map((t) => t.id)
@@ -59449,6 +59478,7 @@ var init_navDropdownSizing = __esmMin((() => {
 //#endregion
 //#region ../theme-core/src/header/generateHeaderCss.ts
 init_resolver$1();
+init_siteChromeNavPreferences();
 init_shared$5();
 init_breakpoints();
 init_navDropdownSizing();
@@ -59458,6 +59488,7 @@ init_resolver$1();
 //#endregion
 //#region ../theme-core/src/layout/generateLayoutCss.ts
 init_breakpoints();
+init_sectionTransitions();
 svgDataUrl("<svg viewBox='0 0 1440 72' xmlns='http://www.w3.org/2000/svg' preserveAspectRatio='none'><path d='M0 72V46C130 55 260 24 420 30C590 36 690 62 860 42C1035 21 1160 47 1305 36C1365 31 1415 33 1440 38V72H0Z' fill='white'/></svg>");
 svgDataUrl("<svg viewBox='0 0 1440 72' xmlns='http://www.w3.org/2000/svg' preserveAspectRatio='none'><path d='M0 72V42C120 24 240 24 360 42C480 60 600 60 720 42C840 24 960 24 1080 42C1200 60 1320 60 1440 42V72H0Z' fill='white'/></svg>");
 svgDataUrl("<svg viewBox='0 0 1440 72' xmlns='http://www.w3.org/2000/svg' preserveAspectRatio='none'><path d='M0 72V43C180 32 300 32 480 43C660 54 780 54 960 43C1140 32 1260 32 1440 43V72H0Z' fill='white'/></svg>");
@@ -61350,7 +61381,7 @@ z$1.object({ acceptExtraSiteCharge: z$1.boolean().optional() });
 //#region ../surfaces/src/index.ts
 const SURFACE_IDS = ["core", "macadamia"];
 const DEFAULT_SURFACE_ID = "core";
-SURFACE_IDS.filter((surfaceId) => surfaceId !== DEFAULT_SURFACE_ID);
+[...SURFACE_IDS.filter((surfaceId) => surfaceId !== DEFAULT_SURFACE_ID)];
 //#endregion
 //#region ../api/src/url.ts
 /**
@@ -61899,6 +61930,7 @@ const VERTICAL_IDS = [
 	"training_provider",
 	"retreat_centre",
 	"music_school",
+	"voice_singing",
 	"performing_arts_school",
 	"community_wellbeing",
 	"venue_event_space"
@@ -61951,6 +61983,11 @@ const VERTICAL_BOOKING_PRESETS = [
 	preset("music_school.terms", "music_school", "course", "Term", "Terms", "Multi-week term blocks or fixed-date group courses."),
 	preset("music_school.workshops", "music_school", "workshop", "Workshop", "Workshops", "One-off workshops, masterclasses, or intensives."),
 	preset("music_school.performances", "music_school", "performance", "Performance", "Performances", "Concerts, recitals, showcases, or ticketed performances."),
+	preset("voice_singing.lessons", "voice_singing", "appointment", "Voice session", "Voice sessions", "One-to-one singing lessons, voice coaching, or private practice sessions."),
+	preset("voice_singing.classes", "voice_singing", "class", "Ongoing weekly session", "Ongoing weekly sessions", "Regular choirs, voice circles, community singing, or group practice."),
+	preset("voice_singing.terms", "voice_singing", "course", "Singing term", "Singing terms", "Multi-week choir terms, voice courses, or fixed-date group programmes."),
+	preset("voice_singing.workshops", "voice_singing", "workshop", "Workshop", "Workshops", "One-off singing workshops, voice journeys, or devotional singing sessions."),
+	preset("voice_singing.performances", "voice_singing", "performance", "Performance", "Performances", "Choir concerts, sharing events, recitals, or community performances."),
 	preset("performing_arts_school.classes", "performing_arts_school", "class", "Class", "Classes", "Regular group classes, rehearsals, or weekly sessions."),
 	preset("performing_arts_school.terms", "performing_arts_school", "course", "Term", "Terms", "Multi-week term blocks or fixed-date course groups."),
 	preset("performing_arts_school.workshops", "performing_arts_school", "workshop", "Workshop", "Workshops", "One-off workshops, masterclasses, or intensives."),
@@ -151442,7 +151479,7 @@ var SimpleCache = class {
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.101.0";
+const SDK_VERSION = "0.103.0";
 //#endregion
 //#region src/client/error.ts
 /**

package/dist/cli/init-docs/content/workflow-isr-revalidation.md

@@ -80,8 +80,11 @@ Create `src/app/api/revalidate/route.ts`:
 
 ```ts
 import { createRevalidateHandler } from '@riverbankcms/sdk/next/revalidate'
+import { getRiverbankClient } from '@/lib/riverbank-client'
 
-export const POST = createRevalidateHandler()
+export const POST = createRevalidateHandler({
+  getClient: getRiverbankClient,
+})
 ```
 
 The deployed site must have the CMS-generated webhook secret:
@@ -98,10 +101,13 @@ X-Riverbank-Signature: sha256=<hex HMAC-SHA256 digest>
 
 The digest is computed over the raw JSON body. The SDK handler rejects unsigned requests, plain hex signatures without the `sha256=` prefix, malformed digests, bad signatures, and invalid payloads. Malformed path entries are skipped and reported in the response metadata while valid tags and paths still revalidate.
 
+Passing `getClient: getRiverbankClient` also clears the current process's SDK client response cache after valid webhooks. This is useful in single-process deployments, `next dev`, `next start`, and runtimes where the revalidation route and render path share the same module instance. On serverless platforms such as Vercel, `/api/revalidate` and page rendering can run in separate functions and many warm containers, so this process-local cache clear is best-effort only. Use Next tag/path revalidation as the cross-instance freshness layer, and disable or shorten SDK response caching for force-dynamic deployments that need immediate freshness across serverless instances.
+
 Riverbank includes a `dispatchId` in signed payloads and sends matching `X-Riverbank-Dispatch-Id` / `X-Riverbank-Correlation-Id` headers. To join CMS delivery logs with this site's deployment logs, use the optional callback metadata:
 
 ```ts
 export const POST = createRevalidateHandler({
+  getClient: getRiverbankClient,
   onRevalidate: (_payload, _items, metadata) => {
     console.info('Riverbank ISR revalidated', metadata)
   },
@@ -122,6 +128,8 @@ riverbankcms webhooks setup \
 
 The command keeps the CMS as the source of truth for the webhook secret. It creates or updates the endpoint, ensures the full SDK revalidation event list is subscribed, writes a newly generated one-time secret to `.env.local` when one is returned, and prints hosted-environment and deploy/test steps. Existing endpoint secrets are not returned or changed unless you pass `--rotate-secret`.
 
+The deployed SDK site uses the returned one-time `RIVERBANK_WEBHOOK_SECRET`. The dashboard/CMS uses a separate `WEBHOOK_SIGNING_SECRET_KEYRING_JSON` environment variable to encrypt stored endpoint secrets; keep that keyring only in the dashboard environment.
+
 The same destination URL can also be configured from the Riverbank dashboard:
 
 ```text