@riverbankcms/sdk 0.128.0 → 0.129.0

package/dist/server/rendering/server.mjs

@@ -50985,6 +50985,213 @@ function renderBlock(manifest, content, options = {}) {
 	}, componentElement);
 }
 //#endregion
+//#region ../blocks/src/system/manifest/hydrateLinks.ts
+/**
+* Hydrates link objects within block content using the provided route map. Returns
+* the original content reference when no mutations are required to avoid unnecessary renders.
+*/
+function hydrateManifestLinks(manifest, content, routes, pagesByIdentifier, entriesByIdentifier) {
+	if (!routes || !manifest?.fields?.length) return content;
+	return hydrateValue(content, {
+		routes,
+		pagesByIdentifier,
+		entriesByIdentifier
+	});
+}
+function hydrateValue(value, context) {
+	try {
+		if (Array.isArray(value)) {
+			const resolvedItems = value.map((item) => hydrateValue(item, context));
+			return resolvedItems.every((item, index) => item === value[index]) ? value : resolvedItems;
+		}
+		if (isRecord$13(value)) {
+			if (isInternalLink(value)) return hydrateInternalLink(value, context.routes);
+			if (isPageLink(value)) return hydratePageLink(value, context);
+			if (isEntryLink(value)) return hydrateEntryLink(value, context);
+			const resolvedEntries = Object.entries(value).map(([key, entry]) => [key, hydrateValue(entry, context)]);
+			return resolvedEntries.every(([key, entry]) => entry === value[key]) ? value : Object.fromEntries(resolvedEntries);
+		}
+		return value;
+	} catch (err) {
+		console.error("[hydrateLinks] Error hydrating value:", err, value);
+		return value;
+	}
+}
+function hydrateInternalLink(link, routes) {
+	const resolved = resolveRouteTarget(link.routeId, routes);
+	if (!resolved) return link;
+	const nextHref = resolved.href;
+	const currentHref = typeof link.href === "string" && link.href.length > 0 ? link.href : null;
+	const nextUpdatedAt = resolved.updatedAt;
+	const updates = {};
+	if (nextHref && nextHref !== currentHref) updates.href = nextHref;
+	if (nextUpdatedAt && link.updatedAt !== nextUpdatedAt) updates.updatedAt = nextUpdatedAt;
+	return Object.keys(updates).length > 0 ? {
+		...link,
+		...updates
+	} : link;
+}
+function isInternalLink(value) {
+	if (value.kind !== "internal") return false;
+	if (typeof value.routeId !== "string" || value.routeId.length === 0) return false;
+	return true;
+}
+function isPageLink(value) {
+	if (value.kind !== "page") return false;
+	if (typeof value.identifier !== "string" || value.identifier.length === 0) return false;
+	return true;
+}
+function hydratePageLink(link, context) {
+	const resolved = resolvePageRouteTarget(link, context);
+	if (!resolved) return link;
+	return {
+		...link,
+		href: resolved.href,
+		routeId: resolved.routeId
+	};
+}
+function isEntryLink(value) {
+	if (value.kind !== "entry") return false;
+	if (typeof value.contentType !== "string" || value.contentType.length === 0) return false;
+	if (typeof value.identifier !== "string" || value.identifier.length === 0) return false;
+	return true;
+}
+function hydrateEntryLink(link, context) {
+	const resolved = resolveEntryRouteTarget(link, context);
+	if (!resolved) return link;
+	return {
+		...link,
+		href: resolved.href,
+		routeId: resolved.routeId
+	};
+}
+//#endregion
+//#region ../blocks/src/sdkBlockTransform.ts
+/**
+* Transforms an SDK custom block into a BlockManifest.
+*
+* If the block has a `layout`, it can be rendered declaratively without React code.
+* If no layout, the block MUST use blockOverrides for rendering.
+*/
+function transformSdkBlockToManifest(sdkBlock) {
+	const hasLayout = Boolean(sdkBlock.layout) || Boolean(sdkBlock.variants && Object.keys(sdkBlock.variants).length > 0);
+	return augmentManifest({
+		name: sdkBlock.id,
+		version: "1.0.0",
+		title: sdkBlock.title,
+		titleSource: sdkBlock.titleSource,
+		description: sdkBlock.description,
+		component: sdkBlock.id,
+		fields: sdkBlock.fields,
+		slots: [],
+		category: sdkBlock.category,
+		tags: sdkBlock.tags,
+		icon: sdkBlock.icon,
+		layout: sdkBlock.layout,
+		variants: sdkBlock.variants,
+		defaultVariant: sdkBlock.defaultVariant,
+		variantOptions: sdkBlock.variantOptions,
+		previewCustomize: sdkBlock.previewCustomize,
+		behaviours: {
+			supportsThemeSwitching: true,
+			inlineEditing: hasLayout,
+			animation: hasLayout,
+			paletteHidden: false
+		}
+	});
+}
+/**
+* Transforms an SDK custom block into a SystemBlockDefinition.
+*
+* This creates a minimal definition with just the manifest - no data loaders
+* or content normalizers since SDK blocks handle their own rendering.
+*/
+function transformSdkBlockToDefinition(sdkBlock) {
+	return {
+		manifest: transformSdkBlockToManifest(sdkBlock),
+		dataLoaders: sdkBlock.dataLoaders
+	};
+}
+//#endregion
+//#region ../blocks/src/customBlockRegistry.ts
+const defaultCustomBlockSourcePolicy = { kind: "canonical-db-fallback-sdk" };
+function isCustomBlockKind(blockKind) {
+	return blockKind.startsWith("custom.");
+}
+function transformToBlockDescriptor(sdkBlock, source = "sdk") {
+	return {
+		name: sdkBlock.id,
+		title: sdkBlock.title,
+		description: sdkBlock.description,
+		category: sdkBlock.category,
+		tags: sdkBlock.tags,
+		icon: sdkBlock.icon,
+		definition: transformSdkBlockToDefinition(sdkBlock),
+		source
+	};
+}
+function toResolvedCustomBlock(manifest, source) {
+	return {
+		blockKind: manifest.id,
+		manifest: transformSdkBlockToManifest(manifest),
+		source,
+		descriptor: transformToBlockDescriptor(manifest, source.kind === "managed-database" ? "database" : "sdk")
+	};
+}
+function planCustomBlockRegistryResolution({ sdkConfig, customBlocks = [], policy = defaultCustomBlockSourcePolicy }) {
+	switch (policy.kind) {
+		case "canonical-db-fallback-sdk": {
+			const entriesByKind = /* @__PURE__ */ new Map();
+			const conflicts = [];
+			for (const customBlock of customBlocks) entriesByKind.set(customBlock.manifest.id, toResolvedCustomBlock(customBlock.manifest, customBlock.source));
+			for (const sdkBlock of sdkConfig?.customBlocks ?? []) {
+				const existing = entriesByKind.get(sdkBlock.id);
+				if (existing) {
+					conflicts.push({
+						kind: "conflict",
+						blockKind: existing.blockKind,
+						winner: existing.source,
+						loser: { kind: "sdk-config" },
+						reason: "db-canonical-sdk-fallback"
+					});
+					continue;
+				}
+				entriesByKind.set(sdkBlock.id, toResolvedCustomBlock(sdkBlock, { kind: "sdk-config" }));
+			}
+			return {
+				policy,
+				entries: Array.from(entriesByKind.values()),
+				conflicts
+			};
+		}
+	}
+}
+function createCustomBlockRegistry({ sdkConfig, customBlocks = [], policy = defaultCustomBlockSourcePolicy, onConflict }) {
+	const plan = planCustomBlockRegistryResolution({
+		sdkConfig,
+		customBlocks,
+		policy
+	});
+	const entriesByKind = new Map(plan.entries.map((entry) => [entry.blockKind, entry]));
+	for (const conflict of plan.conflicts) onConflict?.(`Using ${sourceLabel(conflict.winner)} custom block "${conflict.blockKind}" - ${sourceLabel(conflict.loser)} block is fallback only`);
+	return {
+		entries: plan.entries,
+		conflicts: plan.conflicts,
+		findManifest: (blockKind) => {
+			if (!isCustomBlockKind(blockKind)) return void 0;
+			return entriesByKind.get(blockKind);
+		}
+	};
+}
+function sourceLabel(source) {
+	switch (source.kind) {
+		case "managed-database": return "DB";
+		case "sdk-synced": return "SDK-synced DB";
+		case "sdk-config": return "SDK config";
+		default: return assertNever$4(source);
+	}
+}
+//#endregion
 //#region ../theme-core/src/runtime/fontFamily.ts
 /**
 * Font Family Formatting Utilities
@@ -54722,215 +54929,115 @@ function mapFontStyle(italic) {
 	return italic ? "italic" : "normal";
 }
 //#endregion
-//#region ../blocks/src/system/manifest/hydrateLinks.ts
-/**
-* Hydrates link objects within block content using the provided route map. Returns
-* the original content reference when no mutations are required to avoid unnecessary renders.
-*/
-function hydrateManifestLinks(manifest, content, routes, pagesByIdentifier, entriesByIdentifier) {
-	if (!routes || !manifest?.fields?.length) return content;
-	return hydrateValue(content, {
-		routes,
-		pagesByIdentifier,
-		entriesByIdentifier
-	});
-}
-function hydrateValue(value, context) {
-	try {
-		if (Array.isArray(value)) {
-			const resolvedItems = value.map((item) => hydrateValue(item, context));
-			return resolvedItems.every((item, index) => item === value[index]) ? value : resolvedItems;
-		}
-		if (isRecord$13(value)) {
-			if (isInternalLink(value)) return hydrateInternalLink(value, context.routes);
-			if (isPageLink(value)) return hydratePageLink(value, context);
-			if (isEntryLink(value)) return hydrateEntryLink(value, context);
-			const resolvedEntries = Object.entries(value).map(([key, entry]) => [key, hydrateValue(entry, context)]);
-			return resolvedEntries.every(([key, entry]) => entry === value[key]) ? value : Object.fromEntries(resolvedEntries);
-		}
-		return value;
-	} catch (err) {
-		console.error("[hydrateLinks] Error hydrating value:", err, value);
-		return value;
+//#region ../blocks/src/pageRenderingMode.ts
+var MissingBlockOverrideError$1 = class extends Error {
+	constructor(blockKind) {
+		super(`Override-only rendering requires an override for block kind "${blockKind}".`);
+		this.blockKind = blockKind;
+		this.code = "missing_block_override";
+		this.name = "MissingBlockOverrideError";
 	}
+};
+function isOverrideOnlyResourceInput(props) {
+	return props.rendering?.kind === "overrides-only";
 }
-function hydrateInternalLink(link, routes) {
-	const resolved = resolveRouteTarget(link.routeId, routes);
-	if (!resolved) return link;
-	const nextHref = resolved.href;
-	const currentHref = typeof link.href === "string" && link.href.length > 0 ? link.href : null;
-	const nextUpdatedAt = resolved.updatedAt;
-	const updates = {};
-	if (nextHref && nextHref !== currentHref) updates.href = nextHref;
-	if (nextUpdatedAt && link.updatedAt !== nextUpdatedAt) updates.updatedAt = nextUpdatedAt;
-	return Object.keys(updates).length > 0 ? {
-		...link,
-		...updates
-	} : link;
-}
-function isInternalLink(value) {
-	if (value.kind !== "internal") return false;
-	if (typeof value.routeId !== "string" || value.routeId.length === 0) return false;
-	return true;
-}
-function isPageLink(value) {
-	if (value.kind !== "page") return false;
-	if (typeof value.identifier !== "string" || value.identifier.length === 0) return false;
-	return true;
-}
-function hydratePageLink(link, context) {
-	const resolved = resolvePageRouteTarget(link, context);
-	if (!resolved) return link;
+function resolvePageThemeResources(props) {
+	if (isOverrideOnlyResourceInput(props)) return { kind: "unavailable" };
 	return {
-		...link,
-		href: resolved.href,
-		routeId: resolved.routeId
+		kind: "available",
+		tokens: props.themeTokens ?? buildThemeRuntime$1(props.theme).tokens,
+		config: props.theme
 	};
 }
-function isEntryLink(value) {
-	if (value.kind !== "entry") return false;
-	if (typeof value.contentType !== "string" || value.contentType.length === 0) return false;
-	if (typeof value.identifier !== "string" || value.identifier.length === 0) return false;
-	return true;
+function requireBlockOverride(resources, override, blockKind) {
+	if (resources.kind === "unavailable" && !override) throw new MissingBlockOverrideError$1(blockKind);
 }
-function hydrateEntryLink(link, context) {
-	const resolved = resolveEntryRouteTarget(link, context);
-	if (!resolved) return link;
-	return {
-		...link,
-		href: resolved.href,
-		routeId: resolved.routeId
-	};
+function overrideThemeProps(resources) {
+	return resources.kind === "available" ? {
+		theme: resources.tokens,
+		themeConfig: resources.config
+	} : {};
+}
+function requireThemeResources(resources, blockKind) {
+	if (resources.kind === "unavailable") throw new MissingBlockOverrideError$1(blockKind);
+	return resources;
 }
 //#endregion
-//#region ../blocks/src/sdkBlockTransform.ts
-/**
-* Transforms an SDK custom block into a BlockManifest.
-*
-* If the block has a `layout`, it can be rendered declaratively without React code.
-* If no layout, the block MUST use blockOverrides for rendering.
-*/
-function transformSdkBlockToManifest(sdkBlock) {
-	const hasLayout = Boolean(sdkBlock.layout) || Boolean(sdkBlock.variants && Object.keys(sdkBlock.variants).length > 0);
-	return augmentManifest({
-		name: sdkBlock.id,
-		version: "1.0.0",
-		title: sdkBlock.title,
-		titleSource: sdkBlock.titleSource,
-		description: sdkBlock.description,
-		component: sdkBlock.id,
-		fields: sdkBlock.fields,
-		slots: [],
-		category: sdkBlock.category,
-		tags: sdkBlock.tags,
-		icon: sdkBlock.icon,
-		layout: sdkBlock.layout,
-		variants: sdkBlock.variants,
-		defaultVariant: sdkBlock.defaultVariant,
-		variantOptions: sdkBlock.variantOptions,
-		previewCustomize: sdkBlock.previewCustomize,
-		behaviours: {
-			supportsThemeSwitching: true,
-			inlineEditing: hasLayout,
-			animation: hasLayout,
-			paletteHidden: false
-		}
-	});
+//#region ../blocks/src/pageRendererBoundaries.tsx
+const boundaryKey = (previousBlockId, nextBlockId) => `${previousBlockId}\u0000${nextBlockId}`;
+function isSiteStyleTransitionStyleGroup(value) {
+	return value?.startsWith("site-style-transition-") === true;
+}
+function boundaryMapForAdjacentBlockIds(boundaries) {
+	return new Map(boundaries.map((boundary) => [boundaryKey(boundary.previousBlockId, boundary.nextBlockId), boundary]));
+}
+function boundaryBetweenBlocks(previousBlock, nextBlock, boundaries) {
+	const previousBlockId = previousBlock?.id ?? null;
+	const nextBlockId = nextBlock?.id ?? null;
+	if (!previousBlockId || !nextBlockId) return null;
+	return boundaries.get(boundaryKey(previousBlockId, nextBlockId)) ?? null;
+}
+function renderBoundaryAfterBlock(input) {
+	const previousBlockId = input.block.id;
+	const nextBlockId = input.nextBlock?.id ?? null;
+	if (!previousBlockId || !nextBlockId) return null;
+	const boundary = input.boundaryByAdjacentBlockIds.get(boundaryKey(previousBlockId, nextBlockId));
+	if (!boundary) return null;
+	const rendered = /* @__PURE__ */ jsx("div", {
+		"aria-hidden": "true",
+		"data-block-boundary": "",
+		"data-boundary-id": boundary.boundaryId,
+		"data-boundary-previous-block-id": boundary.previousBlockId,
+		"data-boundary-next-block-id": boundary.nextBlockId,
+		"data-style-group": boundary.styleGroup,
+		style: boundaryCssVarsStyle(boundary)
+	}, `${input.blockKey}:boundary`);
+	return input.wrapBoundary ? input.wrapBoundary(boundary, rendered) : rendered;
 }
-/**
-* Transforms an SDK custom block into a SystemBlockDefinition.
-*
-* This creates a minimal definition with just the manifest - no data loaders
-* or content normalizers since SDK blocks handle their own rendering.
-*/
-function transformSdkBlockToDefinition(sdkBlock) {
+function boundaryCssVarsStyle(boundary) {
 	return {
-		manifest: transformSdkBlockToManifest(sdkBlock),
-		dataLoaders: sdkBlock.dataLoaders
+		"--site-style-transition-from": boundary.cssVars.from,
+		"--site-style-transition-to": boundary.cssVars.to
 	};
 }
-//#endregion
-//#region ../blocks/src/customBlockRegistry.ts
-const defaultCustomBlockSourcePolicy = { kind: "canonical-db-fallback-sdk" };
-function isCustomBlockKind(blockKind) {
-	return blockKind.startsWith("custom.");
-}
-function transformToBlockDescriptor(sdkBlock, source = "sdk") {
+function boundaryReserveCssVarsStyle(input) {
+	const before = input.before?.metrics.reserveCss ?? null;
+	const after = input.after?.metrics.reserveCss ?? null;
+	if (!before && !after) return void 0;
 	return {
-		name: sdkBlock.id,
-		title: sdkBlock.title,
-		description: sdkBlock.description,
-		category: sdkBlock.category,
-		tags: sdkBlock.tags,
-		icon: sdkBlock.icon,
-		definition: transformSdkBlockToDefinition(sdkBlock),
-		source
+		...before ? { "--site-style-boundary-before-reserve": before } : {},
+		...after ? { "--site-style-boundary-after-reserve": after } : {}
 	};
 }
-function toResolvedCustomBlock(manifest, source) {
+function transitionCssVarsStyle(content) {
+	const transitionStyles = isObjectRecord$1(content._transitionStyles) ? content._transitionStyles : null;
+	const cssVars = isObjectRecord$1(transitionStyles?.cssVars) ? transitionStyles.cssVars : null;
+	const from = typeof cssVars?.from === "string" ? cssVars.from : null;
+	const to = typeof cssVars?.to === "string" ? cssVars.to : null;
+	if (!from && !to) return void 0;
 	return {
-		blockKind: manifest.id,
-		manifest: transformSdkBlockToManifest(manifest),
-		source,
-		descriptor: transformToBlockDescriptor(manifest, source.kind === "managed-database" ? "database" : "sdk")
+		...from ? { "--site-style-transition-from": from } : {},
+		...to ? { "--site-style-transition-to": to } : {}
 	};
 }
-function planCustomBlockRegistryResolution({ sdkConfig, customBlocks = [], policy = defaultCustomBlockSourcePolicy }) {
-	switch (policy.kind) {
-		case "canonical-db-fallback-sdk": {
-			const entriesByKind = /* @__PURE__ */ new Map();
-			const conflicts = [];
-			for (const customBlock of customBlocks) entriesByKind.set(customBlock.manifest.id, toResolvedCustomBlock(customBlock.manifest, customBlock.source));
-			for (const sdkBlock of sdkConfig?.customBlocks ?? []) {
-				const existing = entriesByKind.get(sdkBlock.id);
-				if (existing) {
-					conflicts.push({
-						kind: "conflict",
-						blockKind: existing.blockKind,
-						winner: existing.source,
-						loser: { kind: "sdk-config" },
-						reason: "db-canonical-sdk-fallback"
-					});
-					continue;
-				}
-				entriesByKind.set(sdkBlock.id, toResolvedCustomBlock(sdkBlock, { kind: "sdk-config" }));
-			}
-			return {
-				policy,
-				entries: Array.from(entriesByKind.values()),
-				conflicts
-			};
-		}
-	}
-}
-function createCustomBlockRegistry({ sdkConfig, customBlocks = [], policy = defaultCustomBlockSourcePolicy, onConflict }) {
-	const plan = planCustomBlockRegistryResolution({
-		sdkConfig,
-		customBlocks,
-		policy
-	});
-	const entriesByKind = new Map(plan.entries.map((entry) => [entry.blockKind, entry]));
-	for (const conflict of plan.conflicts) onConflict?.(`Using ${sourceLabel(conflict.winner)} custom block "${conflict.blockKind}" - ${sourceLabel(conflict.loser)} block is fallback only`);
+function mergeStyleObjects(left, right) {
+	if (!left) return right;
+	if (!right) return left;
 	return {
-		entries: plan.entries,
-		conflicts: plan.conflicts,
-		findManifest: (blockKind) => {
-			if (!isCustomBlockKind(blockKind)) return void 0;
-			return entriesByKind.get(blockKind);
-		}
+		...left,
+		...right
 	};
 }
-function sourceLabel(source) {
-	switch (source.kind) {
-		case "managed-database": return "DB";
-		case "sdk-synced": return "SDK-synced DB";
-		case "sdk-config": return "SDK config";
-		default: return assertNever$4(source);
-	}
+function pageBlockPosition(index, blockCount) {
+	if (blockCount <= 1) return "only";
+	if (index === 0) return "first";
+	if (index === blockCount - 1) return "last";
+	return "middle";
 }
 //#endregion
 //#region ../blocks/src/PageRenderer.tsx
-function PageRenderer$1({ theme, page, runtimeBoundaries, usePlaceholders = false, dataContext, wrapBlock, wrapBoundary, registry, themeTokens: providedThemeTokens, routeMap, blockOverrides, sdkConfig, customBlocks, previewAuthoring }) {
+function PageRenderer$1(props) {
+	const { page, runtimeBoundaries, usePlaceholders = false, dataContext, wrapBlock, wrapBoundary, registry, routeMap, blockOverrides, sdkConfig, customBlocks, previewAuthoring } = props;
 	const imageResolveContext = React$1.useMemo(() => resolvePageRendererImageResolveContext(dataContext), [
 		dataContext?.imageResolveContext,
 		dataContext?.mediaAssets,
@@ -54939,12 +55046,16 @@ function PageRenderer$1({ theme, page, runtimeBoundaries, usePlaceholders = fals
 	]);
 	const boundaryByAdjacentBlockIds = React$1.useMemo(() => boundaryMapForAdjacentBlockIds(runtimeBoundaries ?? []), [runtimeBoundaries]);
 	const usesRuntimeBoundaries = runtimeBoundaries !== void 0;
+	const themeResources = React$1.useMemo(() => resolvePageThemeResources(props), [
+		props.rendering,
+		props.theme,
+		props.themeTokens
+	]);
 	if (!page || page.blocks.length === 0) return /* @__PURE__ */ jsx("div", {
 		className: "rb-p-6 rb-caption",
 		style: textColorStyle("mutedText"),
 		children: "No blocks found."
 	});
-	const themeTokens = providedThemeTokens ?? buildThemeRuntime$1(theme).tokens;
 	const resolvedRegistry = registry ?? getDefaultComponentRegistry();
 	setContextResolveImageUrlContext(imageResolveContext);
 	return /* @__PURE__ */ jsx("div", { children: page.blocks.map((block, index) => {
@@ -54967,22 +55078,14 @@ function PageRenderer$1({ theme, page, runtimeBoundaries, usePlaceholders = fals
 		const renderableContent = getRenderableContent(block, dataContext?.previewStage);
 		const variantKey = definition?.manifest ? resolveVariantKey(definition.manifest, renderableContent) : null;
 		const shouldUseWrapper = !managesOwnWrapper || Boolean(wrapBlock);
-		const blockSectionProps = {
-			themeTokens,
-			themeConfig: theme,
+		const blockSectionProps = buildBlockSectionProps({
+			props,
+			themeResources,
 			block,
-			usePlaceholders,
-			dataContext,
 			blockKey,
-			registry: resolvedRegistry,
-			routeMap,
-			wrapBlock,
-			blockOverrides,
-			sdkConfig,
-			customBlocks,
 			imageResolveContext,
-			previewAuthoring
-		};
+			registry: resolvedRegistry
+		});
 		if (!shouldUseWrapper) {
 			const rendered = /* @__PURE__ */ jsx(MemoBlockSection, { ...blockSectionProps }, `${blockKey}:block`);
 			return boundaryElement ? /* @__PURE__ */ jsxs(React$1.Fragment, { children: [rendered, boundaryElement] }, blockKey) : rendered;
@@ -55024,81 +55127,6 @@ function PageRenderer$1({ theme, page, runtimeBoundaries, usePlaceholders = fals
 		})] }, blockKey);
 	}) });
 }
-function isSiteStyleTransitionStyleGroup(value) {
-	return value?.startsWith("site-style-transition-") === true;
-}
-function boundaryMapForAdjacentBlockIds(boundaries) {
-	return new Map(boundaries.map((boundary) => [boundaryKey(boundary.previousBlockId, boundary.nextBlockId), boundary]));
-}
-function boundaryKey(previousBlockId, nextBlockId) {
-	return `${previousBlockId}\u0000${nextBlockId}`;
-}
-function boundaryBetweenBlocks(previousBlock, nextBlock, boundaryByAdjacentBlockIds) {
-	const previousBlockId = previousBlock?.id ?? null;
-	const nextBlockId = nextBlock?.id ?? null;
-	if (!previousBlockId || !nextBlockId) return null;
-	return boundaryByAdjacentBlockIds.get(boundaryKey(previousBlockId, nextBlockId)) ?? null;
-}
-function renderBoundaryAfterBlock(input) {
-	const previousBlockId = input.block.id;
-	const nextBlockId = input.nextBlock?.id ?? null;
-	if (!previousBlockId || !nextBlockId) return null;
-	const boundary = input.boundaryByAdjacentBlockIds.get(boundaryKey(previousBlockId, nextBlockId));
-	if (!boundary) return null;
-	const rendered = /* @__PURE__ */ jsx("div", {
-		"aria-hidden": "true",
-		"data-block-boundary": "",
-		"data-boundary-id": boundary.boundaryId,
-		"data-boundary-previous-block-id": boundary.previousBlockId,
-		"data-boundary-next-block-id": boundary.nextBlockId,
-		"data-style-group": boundary.styleGroup,
-		style: boundaryCssVarsStyle(boundary)
-	}, `${input.blockKey}:boundary`);
-	return input.wrapBoundary ? input.wrapBoundary(boundary, rendered) : rendered;
-}
-function boundaryCssVarsStyle(boundary) {
-	return {
-		"--site-style-transition-from": boundary.cssVars.from,
-		"--site-style-transition-to": boundary.cssVars.to
-	};
-}
-function boundaryReserveCssVarsStyle(input) {
-	const before = input.before ? boundaryReserveValueForTreatment(input.before) : null;
-	const after = input.after ? boundaryReserveValueForTreatment(input.after) : null;
-	if (!before && !after) return void 0;
-	return {
-		...before ? { "--site-style-boundary-before-reserve": before } : {},
-		...after ? { "--site-style-boundary-after-reserve": after } : {}
-	};
-}
-function boundaryReserveValueForTreatment(boundary) {
-	return boundary.metrics.reserveCss;
-}
-function transitionCssVarsStyle(content) {
-	const transitionStyles = isObjectRecord$1(content._transitionStyles) ? content._transitionStyles : null;
-	const cssVars = isObjectRecord$1(transitionStyles?.cssVars) ? transitionStyles.cssVars : null;
-	const from = typeof cssVars?.from === "string" ? cssVars.from : null;
-	const to = typeof cssVars?.to === "string" ? cssVars.to : null;
-	if (!from && !to) return void 0;
-	return {
-		...from ? { "--site-style-transition-from": from } : {},
-		...to ? { "--site-style-transition-to": to } : {}
-	};
-}
-function mergeStyleObjects(left, right) {
-	if (!left) return right;
-	if (!right) return left;
-	return {
-		...left,
-		...right
-	};
-}
-function pageBlockPosition(index, blockCount) {
-	if (blockCount <= 1) return "only";
-	if (index === 0) return "first";
-	if (index === blockCount - 1) return "last";
-	return "middle";
-}
 function resolvePageRendererImageResolveContext(dataContext) {
 	const input = dataContext?.imageResolveContext;
 	return buildResolveImageUrlContext({
@@ -55108,6 +55136,23 @@ function resolvePageRendererImageResolveContext(dataContext) {
 		mediaAssets: input?.mediaAssets ?? dataContext?.mediaAssets
 	});
 }
+function buildBlockSectionProps(input) {
+	return {
+		themeResources: input.themeResources,
+		block: input.block,
+		usePlaceholders: input.props.usePlaceholders ?? false,
+		dataContext: input.props.dataContext,
+		blockKey: input.blockKey,
+		registry: input.registry,
+		routeMap: input.props.routeMap,
+		wrapBlock: input.props.wrapBlock,
+		blockOverrides: input.props.blockOverrides,
+		sdkConfig: input.props.sdkConfig,
+		customBlocks: input.props.customBlocks,
+		imageResolveContext: input.imageResolveContext,
+		previewAuthoring: input.props.previewAuthoring
+	};
+}
 /**
 * Look up a block override component by block kind.
 * Supports both full ("block.hero") and short ("hero") keys.
@@ -55174,7 +55219,7 @@ function getCachedValidator(manifest, flavour) {
 * referential equality of all props that affect rendering. Standard React.memo
 * wouldn't catch all the render triggers from the editor store.
 */
-const MemoBlockSection = React$1.memo(function MemoBlockSection({ themeTokens, themeConfig, block, usePlaceholders, dataContext, registry, routeMap, wrapBlock, blockOverrides, sdkConfig, customBlocks, imageResolveContext, previewAuthoring }) {
+const MemoBlockSection = React$1.memo(function MemoBlockSection({ themeResources, block, usePlaceholders, dataContext, registry, routeMap, wrapBlock, blockOverrides, sdkConfig, customBlocks, imageResolveContext, previewAuthoring }) {
 	const perfStart = globalThis.process?.env?.DEBUG_PERF === "1" && typeof window === "undefined" ? Date.now() : 0;
 	const fallbackImageResolveContext = getCurrentResolveImageUrlContext();
 	const resolvedImageResolveContext = imageResolveContext ?? fallbackImageResolveContext;
@@ -55195,6 +55240,7 @@ const MemoBlockSection = React$1.memo(function MemoBlockSection({ themeTokens, t
 		return node;
 	}
 	const OverrideComponent = getBlockOverride(block.kind, blockOverrides);
+	requireBlockOverride(themeResources, OverrideComponent, block.kind);
 	let definition = getBlockDefinition(block.kind);
 	if (!definition && block.kind.startsWith("custom.")) definition = createCustomBlockRegistry({
 		sdkConfig,
@@ -55207,8 +55253,7 @@ const MemoBlockSection = React$1.memo(function MemoBlockSection({ themeTokens, t
 		if (OverrideComponent) {
 			const rendered = /* @__PURE__ */ jsx(OverrideComponent, {
 				content: getRenderableContent(block, dataContext?.previewStage),
-				theme: themeTokens,
-				themeConfig,
+				...overrideThemeProps(themeResources),
 				data: void 0,
 				siteId: dataContext?.siteId,
 				apiBaseUrl: dataContext?.apiBaseUrl,
@@ -55307,8 +55352,7 @@ const MemoBlockSection = React$1.memo(function MemoBlockSection({ themeTokens, t
 		const hasResolvedData = !!resolved && typeof resolved === "object" && Object.keys(resolved).length > 0;
 		const baseProps = {
 			content: hydratedContent,
-			theme: themeTokens,
-			themeConfig,
+			...overrideThemeProps(themeResources),
 			data: resolved,
 			siteId: dataContext?.siteId,
 			apiBaseUrl: dataContext?.apiBaseUrl,
@@ -55328,6 +55372,7 @@ const MemoBlockSection = React$1.memo(function MemoBlockSection({ themeTokens, t
 		let rendered;
 		if (OverrideComponent) rendered = /* @__PURE__ */ jsx(OverrideComponent, { ...baseProps });
 		else {
+			requireThemeResources(themeResources, block.kind);
 			const BlockComponent = getCachedBlockComponent(definition.manifest);
 			const pathBase = typeof block.id === "string" && block.id.length > 0 ? `blocks.${block.id}.` : void 0;
 			const rootContext = { $root: {
@@ -55377,7 +55422,7 @@ const MemoBlockSection = React$1.memo(function MemoBlockSection({ themeTokens, t
 		});
 	}
 }, (prev, next) => {
-	return prev.block === next.block && prev.registry === next.registry && prev.dataContext === next.dataContext && prev.themeTokens === next.themeTokens && prev.themeConfig === next.themeConfig && prev.routeMap === next.routeMap && prev.usePlaceholders === next.usePlaceholders && prev.wrapBlock === next.wrapBlock && prev.blockOverrides === next.blockOverrides && prev.sdkConfig === next.sdkConfig && prev.customBlocks === next.customBlocks && prev.imageResolveContext === next.imageResolveContext && prev.previewAuthoring === next.previewAuthoring;
+	return prev.block === next.block && prev.registry === next.registry && prev.dataContext === next.dataContext && prev.themeResources === next.themeResources && prev.routeMap === next.routeMap && prev.usePlaceholders === next.usePlaceholders && prev.wrapBlock === next.wrapBlock && prev.blockOverrides === next.blockOverrides && prev.sdkConfig === next.sdkConfig && prev.customBlocks === next.customBlocks && prev.imageResolveContext === next.imageResolveContext && prev.previewAuthoring === next.previewAuthoring;
 });
 function fallback(message) {
 	return /* @__PURE__ */ jsx("div", {
@@ -68596,6 +68641,10 @@ function toBlocksImageResolveContextInput(context) {
 }
 //#endregion
 //#region src/rendering/blocks-page-renderer.ts
+const MissingBlockOverrideError = MissingBlockOverrideError$1;
+function isOverrideOnlyPageRenderer(props) {
+	return props.rendering?.kind === "overrides-only";
+}
 function normalizeSdkCustomBlocks(customBlocks) {
 	if (!customBlocks) return void 0;
 	return customBlocks.map((block) => {
@@ -68626,15 +68675,23 @@ function toBlocksPageRendererDataContext(dataContext) {
 }
 function PageRenderer(props) {
 	const blocksSdkConfig = props.sdkConfig ? { customBlocks: normalizeSdkCustomBlocks(props.sdkConfig.customBlocks) } : props.sdkConfig;
-	const blocksTheme = parseBlocksTheme(props.theme);
-	const blocksProps = {
-		...props,
-		theme: blocksTheme,
+	const { rendering: _rendering, theme: _theme, themeTokens: _themeTokens, ...commonProps } = props;
+	const commonBlocksProps = {
+		...commonProps,
 		dataContext: props.dataContext ? toBlocksPageRendererDataContext(props.dataContext) : void 0,
 		blockOverrides: toBlocksBlockOverrides(props.blockOverrides),
 		sdkConfig: blocksSdkConfig,
 		customBlocks: normalizeSdkCustomBlocks(props.customBlocks)
 	};
+	const blocksProps = isOverrideOnlyPageRenderer(props) ? {
+		...commonBlocksProps,
+		rendering: { kind: "overrides-only" },
+		blockOverrides: toBlocksBlockOverrides(props.blockOverrides) ?? {}
+	} : {
+		...commonBlocksProps,
+		theme: parseBlocksTheme(props.theme),
+		themeTokens: props.themeTokens
+	};
 	return React$1.createElement(PageRenderer$1, blocksProps);
 }
 //#endregion
@@ -68676,57 +68733,85 @@ function renderWithSdkThemeRuntime({ themeRuntime, theme, children }) {
 		default: return assertNever$4(themeRuntime);
 	}
 }
+function renderWithOverrideOnlyRuntime({ runtime, children }) {
+	switch (runtime.kind) {
+		case "responsive-only": return /* @__PURE__ */ jsx(ResponsiveScope, {
+			responsiveMode: runtime.responsiveMode,
+			children
+		});
+		case "none": return /* @__PURE__ */ jsx(Fragment, { children });
+		default: return assertNever$4(runtime);
+	}
+}
 //#endregion
 //#region src/rendering/components/pageShared.tsx
-function PageContent({ page, runtimeBoundaries, theme, themeTokens: providedTokens, siteId, resolvedData, bookingOfferingPresets, routeMap, pagesByIdentifier, entriesByIdentifier, wrapBlock, registry, usePlaceholders = false, blockOverrides, sdkConfig, customBlocks, supabaseUrl, mediaAssets, apiBaseUrl, portalToken, previewToken, dataContext, themeRuntime = defaultPageThemeRuntime }) {
-	const baseTokens = providedTokens ?? buildThemeRuntime(theme).tokens;
-	return renderWithSdkThemeRuntime({
-		themeRuntime,
-		theme,
-		children: /* @__PURE__ */ jsx(PageRenderer, {
-			theme,
-			page,
-			runtimeBoundaries,
-			themeTokens: sdkConfig?.theme?.palette ? {
-				...baseTokens,
-				palette: {
-					...baseTokens.palette,
-					...sdkConfig.theme.palette
-				}
-			} : baseTokens,
-			usePlaceholders,
-			dataContext: {
+function isOverrideOnlyPage(props) {
+	return props.rendering?.kind === "overrides-only";
+}
+function resolvePageThemeTokens(props) {
+	const baseTokens = props.themeTokens ?? buildThemeRuntime(props.theme).tokens;
+	return props.sdkConfig?.theme?.palette ? {
+		...baseTokens,
+		palette: {
+			...baseTokens.palette,
+			...props.sdkConfig.theme.palette
+		}
+	} : baseTokens;
+}
+function PageContent(props) {
+	const { page, runtimeBoundaries, siteId, resolvedData, bookingOfferingPresets, routeMap, pagesByIdentifier, entriesByIdentifier, wrapBlock, registry, usePlaceholders = false, blockOverrides, sdkConfig, customBlocks, supabaseUrl, mediaAssets, apiBaseUrl, portalToken, previewToken, dataContext } = props;
+	const rendererCommonProps = {
+		page,
+		runtimeBoundaries,
+		usePlaceholders,
+		dataContext: {
+			siteId,
+			apiBaseUrl,
+			portalToken,
+			previewToken,
+			resolvedData,
+			bookingOfferingPresets: bookingOfferingPresets ?? [],
+			routes: routeMap,
+			pagesByIdentifier,
+			entriesByIdentifier,
+			occurrenceContext: dataContext?.occurrenceContext ?? null,
+			entrySubrouteContext: dataContext?.entrySubrouteContext ?? null,
+			contentEntry: dataContext?.contentEntry ?? null,
+			pageSurface: dataContext?.pageSurface ?? null,
+			subject: dataContext?.subject ?? null,
+			editableRouteMetadataFieldIds: dataContext?.editableRouteMetadataFieldIds ?? null,
+			previewStage: dataContext?.previewStage,
+			supabaseUrl,
+			mediaAssets,
+			imageResolveContext: {
 				siteId,
-				apiBaseUrl,
-				portalToken,
-				previewToken,
-				resolvedData,
-				bookingOfferingPresets: bookingOfferingPresets ?? [],
-				routes: routeMap,
-				pagesByIdentifier,
-				entriesByIdentifier,
-				occurrenceContext: dataContext?.occurrenceContext ?? null,
-				entrySubrouteContext: dataContext?.entrySubrouteContext ?? null,
-				contentEntry: dataContext?.contentEntry ?? null,
-				pageSurface: dataContext?.pageSurface ?? null,
-				subject: dataContext?.subject ?? null,
-				editableRouteMetadataFieldIds: dataContext?.editableRouteMetadataFieldIds ?? null,
-				previewStage: dataContext?.previewStage,
 				supabaseUrl,
-				mediaAssets,
-				imageResolveContext: {
-					siteId,
-					supabaseUrl,
-					mediaAssets
-				}
-			},
-			routeMap,
-			wrapBlock,
-			registry,
-			blockOverrides,
-			sdkConfig: sdkConfig ? { customBlocks: sdkConfig.customBlocks } : null,
-			customBlocks
-		})
+				mediaAssets
+			}
+		},
+		routeMap,
+		wrapBlock,
+		registry,
+		sdkConfig: sdkConfig ? { customBlocks: sdkConfig.customBlocks } : null,
+		customBlocks
+	};
+	const content = isOverrideOnlyPage(props) ? /* @__PURE__ */ jsx(PageRenderer, {
+		...rendererCommonProps,
+		rendering: { kind: "overrides-only" },
+		blockOverrides: props.blockOverrides
+	}) : /* @__PURE__ */ jsx(PageRenderer, {
+		...rendererCommonProps,
+		theme: props.theme,
+		themeTokens: resolvePageThemeTokens(props),
+		blockOverrides
+	});
+	return isOverrideOnlyPage(props) ? renderWithOverrideOnlyRuntime({
+		runtime: props.rendering.runtime,
+		children: content
+	}) : renderWithSdkThemeRuntime({
+		themeRuntime: props.themeRuntime ?? defaultPageThemeRuntime,
+		theme: props.theme,
+		children: content
 	});
 }
 //#endregion
@@ -69205,12 +69290,48 @@ function buildLogo(logo, fallbackAlt) {
 	return result;
 }
 //#endregion
+//#region src/rendering/renderingMode.ts
+const defaultOverrideOnlyRuntime = { kind: "responsive-only" };
+//#endregion
 //#region src/rendering/components/Layout.tsx
 /**
 * Layout component with header and footer
 *
 * Renders site header and footer around content. Fetches site data if not provided.
 */
+function isOverrideOnlyLayout(props) {
+	return props.rendering?.kind === "overrides-only";
+}
+var UnsupportedOverrideOnlyLayoutChromeError = class extends Error {
+	constructor(surface) {
+		super(`Override-only Layout requires a custom or disabled ${surface}; SDK default chrome is unavailable.`);
+		this.surface = surface;
+		this.code = "unsupported_override_only_layout_chrome";
+		this.name = "UnsupportedOverrideOnlyLayoutChromeError";
+	}
+};
+async function resolveLayoutSiteData(props) {
+	if (props.siteData) return props.siteData;
+	if (!props.client) throw new Error("Layout: must provide either siteData or client");
+	if (!props.siteId && !props.slug && !props.domain) throw new Error("Layout: must provide siteId, slug, or domain when using client");
+	return props.client.getSite({
+		id: props.siteId,
+		slug: props.slug,
+		domain: props.domain
+	});
+}
+function renderOverrideOnlyLayout(props, data) {
+	if (data.header === true) throw new UnsupportedOverrideOnlyLayoutChromeError("header");
+	if (data.footer === true) throw new UnsupportedOverrideOnlyLayoutChromeError("footer");
+	return renderWithOverrideOnlyRuntime({
+		runtime: props.rendering.runtime ?? defaultOverrideOnlyRuntime,
+		children: /* @__PURE__ */ jsxs(Fragment, { children: [
+			typeof props.header === "function" ? props.header(data.headerData) : null,
+			props.children,
+			typeof props.footer === "function" ? props.footer(data.footerData) : null
+		] })
+	});
+}
 /**
 * Layout component that wraps content with site header and footer.
 *
@@ -69246,20 +69367,13 @@ function buildLogo(logo, fallbackAlt) {
 * </Layout>
 * ```
 */
-async function Layout({ siteData: providedSiteData, client, siteId, slug, domain, children, header = true, footer = true, headerVariant, hasPortalSession = false, previewStage = "published", themeRuntime }) {
-	let siteData = providedSiteData;
-	if (!siteData) {
-		if (!client) throw new Error("Layout: must provide either siteData or client");
-		if (!siteId && !slug && !domain) throw new Error("Layout: must provide siteId, slug, or domain when using client");
-		siteData = await client.getSite({
-			id: siteId,
-			slug,
-			domain
-		});
-	}
-	const { site, theme, navigation, layout, routes } = siteData;
+async function Layout(props) {
+	const { children, hasPortalSession = false, previewStage = "published" } = props;
+	const header = props.header ?? true;
+	const footer = props.footer ?? true;
+	const siteData = await resolveLayoutSiteData(props);
+	const { site, navigation, layout, routes } = siteData;
 	const footerBlocks = siteData.footerBlocks ?? [];
-	const builtThemeRuntime = buildThemeRuntime(theme);
 	const navigationOptions = {
 		hasPortalSession,
 		previewStage,
@@ -69273,22 +69387,38 @@ async function Layout({ siteData: providedSiteData, client, siteId, slug, domain
 	const footerMenuViewModel = buildFooterMenu(navigation, routes, navigationOptions);
 	const legalFooterMenuViewModel = buildFooterMenuForRole(navigation, routes, "legal-policy", navigationOptions);
 	const logoViewModel = buildLogo(layout.logo ?? null, site.title);
-	const headerData = {
+	const customHeaderData = {
 		menu: menuViewModel,
 		logo: logoViewModel,
 		site,
-		theme,
 		routes
 	};
-	const footerData = {
+	const customFooterData = {
 		menu: menuViewModel,
 		footerMenu: footerMenuViewModel,
 		legalFooterMenu: legalFooterMenuViewModel,
 		logo: logoViewModel,
 		site,
-		theme,
 		routes
 	};
+	if (isOverrideOnlyLayout(props)) return renderOverrideOnlyLayout(props, {
+		header: props.header ?? true,
+		footer: props.footer ?? true,
+		headerData: customHeaderData,
+		footerData: customFooterData
+	});
+	const { theme } = siteData;
+	const builtThemeRuntime = buildThemeRuntime(theme);
+	const headerVariant = props.headerVariant;
+	const themeRuntime = props.themeRuntime;
+	const headerData = {
+		...customHeaderData,
+		theme
+	};
+	const footerData = {
+		...customFooterData,
+		theme
+	};
 	const headerContent = headerVariant ? {
 		...layout.header,
 		variant: headerVariant
@@ -72353,6 +72483,17 @@ async function prefetchBlockDataWithDeps(deps, page, context, client, options) {
 }
 //#endregion
 //#region src/rendering/components/Block.shared.tsx
+function isOverrideOnlyBlock(props) {
+	return props.rendering?.kind === "overrides-only";
+}
+var MissingStandaloneBlockOverrideError = class extends Error {
+	constructor(blockKind) {
+		super(`Override-only standalone rendering requires an override for block kind "${blockKind}".`);
+		this.blockKind = blockKind;
+		this.code = "missing_standalone_block_override";
+		this.name = "MissingStandaloneBlockOverrideError";
+	}
+};
 function renderUnknownBlock(blockKind) {
 	return /* @__PURE__ */ jsx("div", {
 		className: "p-4 border border-red-300 bg-red-50 rounded",
@@ -72415,14 +72556,16 @@ function buildStandaloneBlockViewModel({ siteId, pageId, previewStage, apiBaseUr
 function renderBlockOverride({ OverrideComponent, props, runtime, resolvedData }) {
 	return /* @__PURE__ */ jsx(OverrideComponent, {
 		content: props.content,
-		theme: runtime.themeRuntime.tokens,
-		themeConfig: props.theme,
+		...runtime && "theme" in props ? {
+			theme: runtime.themeRuntime.tokens,
+			themeConfig: props.theme
+		} : {},
 		data: resolvedData,
 		siteId: props.siteId,
 		apiBaseUrl: props.apiBaseUrl,
 		portalToken: props.portalToken ?? null,
 		supabaseUrl: props.supabaseUrl,
-		imageResolveContext: runtime.imageResolveContext,
+		imageResolveContext: runtime?.imageResolveContext,
 		blockId: props.blockId ?? null,
 		blockKind: props.blockKind
 	});
@@ -72451,8 +72594,8 @@ function renderManifestBlock({ definition, props, runtime, resolvedData }) {
 async function BlockContent(props) {
 	const definition = getBlockDefinition(props.blockKind);
 	const OverrideComponent = props.override;
+	if (isOverrideOnlyBlock(props) && !OverrideComponent) throw new MissingStandaloneBlockOverrideError(props.blockKind);
 	if (!definition && !OverrideComponent) return renderUnknownBlock(props.blockKind);
-	const runtime = buildBlockContentRuntime(props);
 	const resolvedData = await loadStandaloneBlockData({
 		...props,
 		hasDefinition: Boolean(definition)
@@ -72460,13 +72603,14 @@ async function BlockContent(props) {
 	if (OverrideComponent) return renderBlockOverride({
 		OverrideComponent,
 		props,
-		runtime,
+		runtime: isOverrideOnlyBlock(props) ? void 0 : buildBlockContentRuntime(props),
 		resolvedData
 	});
+	if (isOverrideOnlyBlock(props)) throw new MissingStandaloneBlockOverrideError(props.blockKind);
 	return renderManifestBlock({
 		definition,
 		props,
-		runtime,
+		runtime: buildBlockContentRuntime(props),
 		resolvedData
 	});
 }
@@ -72583,4 +72727,4 @@ async function resolveBlockOverridesForPage(registrations, page) {
 	return resolved;
 }
 //#endregion
-export { Block, Layout, Page, buildPageBlockKindIndex, collectUsedBlockKindsFromPageOutline, defineBlockOverrideRegistrations, defineBlockOverrides, defineLazyBlockOverride, resolveBlockOverridesForPage };
+export { Block, Layout, MissingBlockOverrideError, Page, UnsupportedOverrideOnlyLayoutChromeError, buildPageBlockKindIndex, collectUsedBlockKindsFromPageOutline, defineBlockOverrideRegistrations, defineBlockOverrides, defineLazyBlockOverride, resolveBlockOverridesForPage };