@riverbankcms/sdk 0.111.0 → 0.118.0

package/dist/client/client.mjs

@@ -6667,6 +6667,63 @@ const API_ENDPOINTS$1 = {
 		auth: "service",
 		responseKind: "json"
 	},
+	sdkListEventOccurrences: {
+		path: "/sdk/{siteId}/events/{identifier}/occurrences",
+		method: "GET",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"server:internal_error"
+		]
+	},
+	sdkAddEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/occurrences",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkUpdateEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/occurrences/{occurrenceId}",
+		method: "PATCH",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"validation:invalid_input",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkCancelEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/occurrences/{occurrenceId}/cancel",
+		method: "POST",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
+	sdkDeleteEventOccurrence: {
+		path: "/sdk/{siteId}/events/{identifier}/occurrences/{occurrenceId}",
+		method: "DELETE",
+		auth: "service",
+		responseKind: "json",
+		errors: [
+			"resource:not_found",
+			"resource:conflict",
+			"server:internal_error"
+		]
+	},
 	sdkListCourses: {
 		path: "/sdk/{siteId}/courses",
 		method: "GET",
@@ -7222,20 +7279,20 @@ function isApiError(result) {
 function isApiSuccess(result) {
 	return result.success === true;
 }
-function isRecord$32(value) {
+function isRecord$35(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isFieldError(value) {
-	return isRecord$32(value) && typeof value.field === "string" && typeof value.code === "string" && typeof value.message === "string";
+	return isRecord$35(value) && typeof value.field === "string" && typeof value.code === "string" && typeof value.message === "string";
 }
 function fieldErrorsFromUnknown(value) {
 	if (!Array.isArray(value)) return null;
 	return value.every(isFieldError) ? value : null;
 }
 function extractEnvelopeErrorObject(body) {
-	if (!isRecord$32(body)) return null;
+	if (!isRecord$35(body)) return null;
 	const error = body.error;
-	if (!isRecord$32(error)) return null;
+	if (!isRecord$35(error)) return null;
 	if ("success" in body && body.success !== false) return null;
 	return error;
 }
@@ -7499,7 +7556,7 @@ var init_event_pricing = __esmMin((() => {
 //#endregion
 //#region ../core/src/event-page-surface-subject.ts
 function parseEventPageSurfaceSubject(value) {
-	if (!isRecord$31(value)) return err$2({ kind: "notObject" });
+	if (!isRecord$34(value)) return err$2({ kind: "notObject" });
 	switch (value.kind) {
 		case "eventSeries": {
 			const eventSeriesId = parseEventSeriesId(value.eventSeriesId);
@@ -7542,7 +7599,7 @@ function parseEventPageSurfaceSubject(value) {
 		});
 	}
 }
-function isRecord$31(value) {
+function isRecord$34(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 var init_event_page_surface_subject = __esmMin((() => {
@@ -7956,8 +8013,40 @@ var init_public_url_validation = __esmMin((() => {}));
 var init_public_profile = __esmMin((() => {
 	init_public_url_validation();
 	init_result();
+}));
+//#endregion
+//#region ../core/src/rich-text.ts
+function isRecord$32(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasOnlyKeys(value, allowed) {
+	return Object.keys(value).every((key) => allowed.has(key));
+}
+function isDenseArrayOf(value, predicate) {
+	for (let index = 0; index < value.length; index += 1) if (!(index in value) || !predicate(value[index])) return false;
+	return true;
+}
+function isTipTapMark(value) {
+	return isRecord$32(value) && hasOnlyKeys(value, markKeys) && typeof value.type === "string" && value.type.length > 0 && (value.attrs === void 0 || isRecord$32(value.attrs));
+}
+function isTipTapNode(value) {
+	if (!isRecord$32(value) || !hasOnlyKeys(value, nodeKeys) || typeof value.type !== "string" || value.type.length === 0 || value.type === "doc" || value.attrs !== void 0 && !isRecord$32(value.attrs) || value.marks !== void 0 && (!Array.isArray(value.marks) || !isDenseArrayOf(value.marks, isTipTapMark)) || value.content !== void 0 && (!Array.isArray(value.content) || !isDenseArrayOf(value.content, isTipTapNode))) return false;
+	if (value.type === "text") return typeof value.text === "string" && value.text.length > 0 && value.content === void 0;
+	return value.text === void 0;
+}
+var nodeKeys, markKeys;
+var init_rich_text = __esmMin((() => {
+	nodeKeys = /* @__PURE__ */ new Set([
+		"type",
+		"content",
+		"text",
+		"attrs",
+		"marks"
+	]);
+	markKeys = /* @__PURE__ */ new Set(["type", "attrs"]);
 })), sectionKinds;
 var init_footer_composition = __esmMin((() => {
+	init_rich_text();
 	init_result();
 	sectionKinds = [
 		"brand",
@@ -8070,6 +8159,7 @@ var init_src$3 = __esmMin((() => {
 	init_participant_identity();
 	init_public_url_validation();
 	init_public_profile();
+	init_rich_text();
 	init_footer_composition();
 	init_number_input();
 	init_field_errors();
@@ -8369,7 +8459,7 @@ function formatKeyAsLabel(key) {
 	return key.replace(/([A-Z])/g, " $1").replace(/[-_]/g, " ").trim().split(" ").map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join(" ");
 }
 var init_augmentManifest = __esmMin((() => {}));
-var init_types$17 = __esmMin((() => {}));
+var init_types$16 = __esmMin((() => {}));
 //#endregion
 //#region ../media-core/src/fileSafety.ts
 function containsUnsafePathSegmentCharacter(value) {
@@ -8494,11 +8584,11 @@ var init_storagePathDomain = __esmMin((() => {}));
 var init_fileAssetLegacyProjection = __esmMin((() => {}));
 //#endregion
 //#region ../media-core/src/typeGuards.ts
-function isRecord$27(value) {
+function isRecord$29(value) {
 	return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
 function asRecord$3(value) {
-	return isRecord$27(value) ? value : void 0;
+	return isRecord$29(value) ? value : void 0;
 }
 var init_typeGuards$1 = __esmMin((() => {}));
 function isFileJsonObject(value) {
@@ -8508,7 +8598,7 @@ function isFileJsonValue(value) {
 	if (value === null || typeof value === "string" || typeof value === "boolean") return true;
 	if (typeof value === "number") return Number.isFinite(value);
 	if (Array.isArray(value)) return value.every(isFileJsonValue);
-	return isRecord$27(value) && isFileJsonObject(value);
+	return isRecord$29(value) && isFileJsonObject(value);
 }
 var init_filePersistence = __esmMin((() => {
 	init_src$3();
@@ -8873,7 +8963,7 @@ function isCmsMediaObjectType(value) {
 	return typeof value === "string" && CMS_MEDIA_OBJECT_TYPES.includes(value);
 }
 function isCmsMediaObject(value) {
-	if (!isRecord$27(value)) return false;
+	if (!isRecord$29(value)) return false;
 	const type = value.type;
 	if (!isCmsMediaObjectType(type)) return false;
 	if ("attrs" in value) return false;
@@ -8884,13 +8974,25 @@ function collectMediaObjects(value, out, location = "") {
 		value.forEach((item, index) => collectMediaObjects(item, out, `${location}[${index}]`));
 		return;
 	}
-	if (!isRecord$27(value)) return;
+	if (!isRecord$29(value)) return;
 	if (isCmsMediaObject(value)) out.push({
 		obj: value,
 		location
 	});
 	for (const [key, child] of Object.entries(value)) collectMediaObjects(child, out, location ? `${location}.${key}` : key);
 }
+/**
+* Strip environment-specific keys from a CMS media object.
+* @mutates Mutates the passed object in-place.
+*/
+function deleteEnvSpecificKeys(obj) {
+	delete obj.assetId;
+	delete obj.storageBucket;
+	delete obj.storagePath;
+	delete obj.src;
+	delete obj.mimeType;
+	if (looksLikeUuid(obj.id)) delete obj.id;
+}
 var CMS_MEDIA_OBJECT_TYPES;
 var init_mediaRefNormalizer = __esmMin((() => {
 	init_typeGuards$1();
@@ -8918,8 +9020,8 @@ function walkAndCollectImageAttrs(value, out, location = "") {
 		value.forEach((item, index) => walkAndCollectImageAttrs(item, out, `${location}[${index}]`));
 		return;
 	}
-	if (!isRecord$27(value)) return;
-	if (value.type === "image" && isRecord$27(value.attrs)) out.push({
+	if (!isRecord$29(value)) return;
+	if (value.type === "image" && isRecord$29(value.attrs)) out.push({
 		attrs: value.attrs,
 		location: location ? `${location}.attrs` : "attrs"
 	});
@@ -8978,25 +9080,239 @@ function mediaIdentifierOrFallback(current, fallback) {
 }
 var init_renderableMediaAsset = __esmMin((() => {}));
 //#endregion
-//#region ../media-core/src/legacyMediaValue.ts
-function legacyStringMediaTypeForField(field) {
-	if (field.type === "file") return field.fileKinds?.[0] ?? "document";
-	return field.mediaKinds?.[0] ?? "image";
+//#region ../media-core/src/contentMediaAudit.ts
+function isRecord$28(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-function normalizeLegacyStringMediaValueForField(value, field) {
-	if (typeof value !== "string") return value;
-	const src = value.trim();
-	if (!src) return value;
-	return {
-		type: legacyStringMediaTypeForField(field),
-		src
-	};
+function summarizeContentMediaValue(value) {
+	if (typeof value === "string") {
+		const trimmed = value.trim();
+		if (!trimmed) return "blank string";
+		return trimmed.length <= 160 ? trimmed : `${trimmed.slice(0, 157)}...`;
+	}
+	if (value === null) return "null";
+	if (Array.isArray(value)) return `array(${value.length})`;
+	if (isRecord$28(value)) return `object(${Object.keys(value).sort().join(",")})`;
+	return typeof value;
 }
-var init_legacyMediaValue = __esmMin((() => {}));
+function auditMediaValue(context, path, allowedMediaTypes, value) {
+	const expectedMediaType = allowedMediaTypes[0];
+	if (value === void 0 || value === null) return [];
+	if (typeof value === "string") {
+		if (!value.trim()) return [{
+			tag: "blank-string",
+			context,
+			path,
+			valueSummary: summarizeContentMediaValue(value),
+			expectedMediaType
+		}];
+		return [{
+			tag: "legacy-string",
+			context,
+			path,
+			valueSummary: summarizeContentMediaValue(value),
+			originalValue: value,
+			expectedMediaType,
+			allowedMediaTypes
+		}];
+	}
+	const hasValidIdentifier = isRecord$28(value) && typeof value.identifier === "string" && value.identifier.trim().length > 0;
+	const hasValidExplicitType = isRecord$28(value) && (!("type" in value) || typeof value.type === "string" && allowedMediaTypes.includes(value.type));
+	const hasRetiredEnvironmentField = isRecord$28(value) && ("assetId" in value || "storagePath" in value || "storageBucket" in value || "src" in value || "mimeType" in value || looksLikeUuid(value.id));
+	if (hasValidIdentifier && hasValidExplicitType && !hasRetiredEnvironmentField) return [];
+	return [{
+		tag: "malformed-object",
+		context,
+		path,
+		valueSummary: summarizeContentMediaValue(value),
+		expectedMediaType
+	}];
+}
+function auditFields(context, fields, value, parentPath) {
+	if (!isRecord$28(value)) return [];
+	const findings = [];
+	for (const field of fields) {
+		if (!(field.id in value)) continue;
+		const fieldValue = value[field.id];
+		const fieldPath = [...parentPath, field.id];
+		switch (field.kind) {
+			case "media":
+				findings.push(...auditMediaValue(context, fieldPath, field.allowedMediaTypes, fieldValue));
+				break;
+			case "object":
+				findings.push(...auditFields(context, field.fields, fieldValue, fieldPath));
+				break;
+			case "repeater":
+				if (!Array.isArray(fieldValue)) break;
+				for (const [index, item] of fieldValue.entries()) {
+					const itemPath = [...fieldPath, index];
+					if (!isRecord$28(item)) {
+						findings.push({
+							tag: "missing-schema",
+							context,
+							path: itemPath,
+							valueSummary: summarizeContentMediaValue(item)
+						});
+						continue;
+					}
+					if (field.mode === "fields") {
+						findings.push(...auditFields(context, field.fields, item, itemPath));
+						continue;
+					}
+					const discriminator = field.discriminator ?? "_type";
+					const typeId = item[discriminator];
+					const variant = typeof typeId === "string" ? field.variants.find((candidate) => candidate.typeId === typeId) : void 0;
+					if (variant) findings.push(...auditFields(context, variant.fields, item, itemPath));
+					else findings.push({
+						tag: "missing-schema",
+						context,
+						path: [...itemPath, discriminator],
+						valueSummary: summarizeContentMediaValue(typeId)
+					});
+				}
+				break;
+		}
+	}
+	return findings;
+}
+var init_contentMediaAudit = __esmMin((() => {
+	init_mediaRefNormalizer();
+}));
+//#endregion
+//#region ../media-core/src/contentMediaAuditFieldAdapter.ts
+function isRecord$27(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function unknownArray(value) {
+	return Array.isArray(value) ? value : null;
+}
+function fieldsArray(value) {
+	const directFields = unknownArray(value);
+	if (directFields) return directFields;
+	if (!isRecord$27(value)) return null;
+	return unknownArray(value.fields);
+}
+function nestedFields(field) {
+	const directFields = unknownArray(field.fields);
+	if (directFields) return directFields;
+	return fieldsArray(field.schema) ?? [];
+}
+function allowedMediaTypes(field, fieldType, defaultFileKinds) {
+	const configured = fieldType === "media" ? field.mediaKinds : field.fileKinds;
+	const parsed = Array.isArray(configured) ? configured.filter((value) => typeof value === "string" && contentMediaTypes.has(value)) : [];
+	if (parsed.length > 0) return parsed;
+	return fieldType === "media" ? ["image"] : defaultFileKinds;
+}
+function mergeVariants(variants) {
+	const merged = /* @__PURE__ */ new Map();
+	for (const variant of variants) merged.set(variant.typeId, mergeFields([...merged.get(variant.typeId) ?? [], ...variant.fields]));
+	return [...merged].map(([typeId, fields]) => ({
+		typeId,
+		fields
+	}));
+}
+function mergeFields(fields) {
+	const merged = [];
+	for (const field of fields) {
+		const index = merged.findIndex((candidate) => candidate.kind === field.kind && candidate.id === field.id);
+		const existing = index === -1 ? void 0 : merged[index];
+		if (!existing) {
+			merged.push(field);
+			continue;
+		}
+		if (existing.kind === "media" && field.kind === "media") {
+			merged[index] = {
+				...existing,
+				allowedMediaTypes: [.../* @__PURE__ */ new Set([...existing.allowedMediaTypes, ...field.allowedMediaTypes])]
+			};
+			continue;
+		}
+		if (existing.kind === "object" && field.kind === "object") {
+			merged[index] = {
+				...existing,
+				fields: mergeFields([...existing.fields, ...field.fields])
+			};
+			continue;
+		}
+		if (existing.kind === "repeater" && field.kind === "repeater" && existing.mode === "fields" && field.mode === "fields") {
+			merged[index] = {
+				...existing,
+				fields: mergeFields([...existing.fields, ...field.fields])
+			};
+			continue;
+		}
+		if (existing.kind === "repeater" && field.kind === "repeater" && existing.mode === "variants" && field.mode === "variants") {
+			merged[index] = {
+				...existing,
+				variants: mergeVariants([...existing.variants, ...field.variants])
+			};
+			continue;
+		}
+		merged.push(field);
+	}
+	return merged;
+}
+function adaptFields(rawFields, flattenRepeaterGroups = false, defaultFileKinds = ["document"]) {
+	return mergeFields(rawFields.flatMap((rawField) => {
+		if (!isRecord$27(rawField)) return [];
+		const { id, type } = rawField;
+		if (typeof id !== "string" || !id || typeof type !== "string") return [];
+		if (type === "media" || type === "file") return [{
+			kind: "media",
+			id,
+			allowedMediaTypes: allowedMediaTypes(rawField, type, defaultFileKinds)
+		}];
+		if (flattenRepeaterGroups && type === "group" && isRecord$27(rawField.ui) && rawField.ui.flattenInRepeater === true) return adaptFields(nestedFields(rawField), false, defaultFileKinds);
+		if (type === "group" || type === "modal") return [{
+			kind: "object",
+			id,
+			fields: adaptFields(nestedFields(rawField), false, defaultFileKinds)
+		}];
+		if (type === "tabGroup") return [{
+			kind: "object",
+			id,
+			fields: adaptFields((unknownArray(rawField.tabs) ?? []).flatMap((tab) => isRecord$27(tab) ? unknownArray(tab.fields) ?? [] : []), false, defaultFileKinds)
+		}];
+		if (type !== "repeater") return [];
+		if (isRecord$27(rawField.itemTypes)) return [{
+			kind: "repeater",
+			id,
+			mode: "variants",
+			variants: Object.entries(rawField.itemTypes).flatMap(([typeId, itemType]) => isRecord$27(itemType) && Array.isArray(itemType.fields) ? [{
+				typeId,
+				fields: adaptFields(itemType.fields, true, defaultFileKinds)
+			}] : []),
+			discriminator: "_type"
+		}];
+		return [{
+			kind: "repeater",
+			id,
+			mode: "fields",
+			fields: adaptFields(nestedFields(rawField), true, defaultFileKinds)
+		}];
+	}));
+}
+var contentMediaTypes;
+var init_contentMediaAuditFieldAdapter = __esmMin((() => {
+	contentMediaTypes = /* @__PURE__ */ new Set([
+		"image",
+		"video",
+		"audio",
+		"document",
+		"spreadsheet",
+		"archive"
+	]);
+}));
+var init_contentMediaSnapshotAudit = __esmMin((() => {
+	init_src$3();
+	init_contentMediaAudit();
+	init_contentMediaAuditFieldAdapter();
+	init_identifiers();
+}));
 //#endregion
 //#region ../media-core/src/index.ts
 var init_src$2 = __esmMin((() => {
-	init_types$17();
+	init_types$16();
 	init_fileDomain();
 	init_fileStorage();
 	init_storagePathDomain();
@@ -9042,7 +9358,9 @@ var init_src$2 = __esmMin((() => {
 	init_mediaUsageProjection();
 	init_portableMediaReferences();
 	init_renderableMediaAsset();
-	init_legacyMediaValue();
+	init_contentMediaAudit();
+	init_contentMediaAuditFieldAdapter();
+	init_contentMediaSnapshotAudit();
 }));
 //#endregion
 //#region ../blocks/src/system/types/link.ts
@@ -9373,6 +9691,16 @@ function isDisplayMediaKind(kind) {
 function assertNeverSelectSource(value) {
 	throw new Error(`Unhandled select source: ${JSON.stringify(value)}`);
 }
+function hasMediaDefaultIdentifier(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value) && typeof value.identifier === "string" && value.identifier.trim().length > 0;
+}
+function validateMediaFieldDefault(field, ctx) {
+	if (field.defaultValue !== void 0 && field.defaultValue !== null && !hasMediaDefaultIdentifier(field.defaultValue)) ctx.addIssue({
+		code: z$1.ZodIssueCode.custom,
+		path: ["defaultValue"],
+		message: `${field.type} defaultValue must be null or an object with a non-empty identifier`
+	});
+}
 function getFieldSchemaInternal() {
 	if (_fieldSchemaInternal) return _fieldSchemaInternal;
 	_fieldSchemaInternal = z$1.discriminatedUnion("type", [
@@ -9449,7 +9777,7 @@ function createSdkSelectField(input) {
 		}
 	}));
 }
-var visibilityLevels, MEDIA_KINDS, DISPLAY_MEDIA_KINDS, PUBLIC_FILE_FIELD_KINDS, siteOptionSources, mediaDeliverySchema, selectOptionSchema, selectSourceSchema, visibleWhenPredicateSchema, visibleWhenSchema, uiSchema, baseFieldSchema, textFieldSchema, richTextFieldSchema, inlineTextFieldSchema, mediaFieldSchema, fileFieldSchema, booleanFieldSchema, dateFieldSchema, timeFieldSchema, dateTimeFieldSchema, slugFieldSchema, urlFieldSchema, linkFieldSchema, selectFieldSchema, referenceFieldSchema, itemTypeSchema, repeaterFieldSchema, groupFieldSchema, modalFieldSchema, numberFieldSchema, tabDefinitionSchema, tabGroupFieldSchema, presetOptionSchema, presetOrCustomFieldSchema, contentTypeSelectFieldSchema, entryPickerFieldSchema, _fieldSchemaInternal, fieldSchema, slotSchema, typographyTokens$1, colorTokens$1, spacingTokens$1, radiusTokens$1, styleTokenSchema, behaviourSchema, quickFieldPrioritySchema, previewCustomizeManifestCurationSchema, blockCategoryEnum, blockContentSourceKinds, blockContentSourceSchema;
+var visibilityLevels, MEDIA_KINDS, DISPLAY_MEDIA_KINDS, DEFAULT_MEDIA_FIELD_KINDS, PUBLIC_FILE_FIELD_KINDS, siteOptionSources, mediaDeliverySchema, selectOptionSchema, selectSourceSchema, visibleWhenPredicateSchema, visibleWhenSchema, uiSchema, baseFieldSchema, textFieldSchema, richTextFieldSchema, inlineTextFieldSchema, mediaFieldSchema, fileFieldSchema, booleanFieldSchema, dateFieldSchema, timeFieldSchema, dateTimeFieldSchema, slugFieldSchema, urlFieldSchema, linkFieldSchema, selectFieldSchema, referenceFieldSchema, itemTypeSchema, repeaterFieldSchema, groupFieldSchema, modalFieldSchema, numberFieldSchema, tabDefinitionSchema, tabGroupFieldSchema, presetOptionSchema, presetOrCustomFieldSchema, contentTypeSelectFieldSchema, entryPickerFieldSchema, _fieldSchemaInternal, fieldSchema, slotSchema, typographyTokens$1, colorTokens$1, spacingTokens$1, radiusTokens$1, styleTokenSchema, behaviourSchema, quickFieldPrioritySchema, previewCustomizeManifestCurationSchema, blockCategoryEnum, blockContentSourceKinds, blockContentSourceSchema;
 var init_schema$1 = __esmMin((() => {
 	init_node();
 	init_repeaterGrid();
@@ -9472,6 +9800,7 @@ var init_schema$1 = __esmMin((() => {
 		"video",
 		"audio"
 	];
+	DEFAULT_MEDIA_FIELD_KINDS = ["image"];
 	PUBLIC_FILE_FIELD_KINDS = [
 		"document",
 		"spreadsheet",
@@ -9668,16 +9997,16 @@ var init_schema$1 = __esmMin((() => {
 	});
 	mediaFieldSchema = baseFieldSchema.extend({
 		type: z$1.literal("media"),
-		mediaKinds: z$1.array(z$1.enum(MEDIA_KINDS)).default(["image"]).transform((kinds) => {
+		mediaKinds: z$1.array(z$1.enum(MEDIA_KINDS)).default([...DEFAULT_MEDIA_FIELD_KINDS]).transform((kinds) => {
 			const displayKinds = kinds.filter(isDisplayMediaKind);
-			return displayKinds.length > 0 ? displayKinds : ["image"];
+			return displayKinds.length > 0 ? displayKinds : [...DEFAULT_MEDIA_FIELD_KINDS];
 		}),
 		aspectRatio: z$1.string().optional()
-	});
+	}).superRefine(validateMediaFieldDefault);
 	fileFieldSchema = baseFieldSchema.extend({
 		type: z$1.literal("file"),
 		fileKinds: z$1.array(z$1.enum(PUBLIC_FILE_FIELD_KINDS)).default([...PUBLIC_FILE_FIELD_KINDS])
-	});
+	}).superRefine(validateMediaFieldDefault);
 	booleanFieldSchema = baseFieldSchema.extend({ type: z$1.literal("boolean") });
 	dateFieldSchema = baseFieldSchema.extend({ type: z$1.literal("date") });
 	timeFieldSchema = baseFieldSchema.extend({ type: z$1.literal("time") });
@@ -11301,8 +11630,83 @@ function resolveBlockIconRenderValue(value, generatedAssets = /* @__PURE__ */ ne
 	}
 }
 //#endregion
+//#region ../blocks/src/lib/typeGuards.ts
+/**
+* Strict record guard: excludes null, primitives, and arrays.
+*/
+function isRecord$25(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Non-null object guard: includes arrays for behavior parity with legacy helpers.
+*
+* NOTE: This intentionally narrows to UnknownRecord for compatibility with existing
+* callsites even though arrays pass at runtime. Follow-up cleanup should replace
+* this API with a more precise predicate type and migrate consumers.
+*/
+function isObjectRecord$1(value) {
+	return typeof value === "object" && value !== null;
+}
+var init_typeGuards = __esmMin((() => {}));
+//#endregion
+//#region ../blocks/src/system/manifest/richTextSchema.ts
+/**
+* Type guard for {@link RichTextDoc}.
+*
+* Returns `true` only for the canonical unwrapped form. The shared structural
+* contract lives in `@riverbankcms/core`; parity tests keep its dependency-free
+* guard aligned with this detailed Zod validator.
+*/
+function isRichTextDoc(value) {
+	return RichTextDocSchema.safeParse(value).success;
+}
+var TipTapMarkSchema, TipTapNodeSchema, RichTextDocSchema;
+var init_richTextSchema = __esmMin((() => {
+	init_typeGuards();
+	TipTapMarkSchema = z$1.object({
+		type: z$1.string().min(1),
+		attrs: z$1.record(z$1.string(), z$1.unknown()).optional()
+	}).strict();
+	TipTapNodeSchema = z$1.lazy(() => z$1.object({
+		type: z$1.string().min(1),
+		content: z$1.array(TipTapNodeSchema).optional(),
+		text: z$1.string().optional(),
+		attrs: z$1.record(z$1.string(), z$1.unknown()).optional(),
+		marks: z$1.array(TipTapMarkSchema).optional()
+	}).strict().superRefine((node, ctx) => {
+		if (node.type === "doc") ctx.addIssue({
+			code: "custom",
+			path: ["type"],
+			message: "Document nodes are only valid at the rich-text root"
+		});
+		if (node.type === "text") {
+			if (node.text === void 0 || node.text.length === 0) ctx.addIssue({
+				code: "custom",
+				path: ["text"],
+				message: "Text nodes require a non-empty text value"
+			});
+			if (node.content !== void 0) ctx.addIssue({
+				code: "custom",
+				path: ["content"],
+				message: "Text nodes cannot contain child nodes"
+			});
+			return;
+		}
+		if (node.text !== void 0) ctx.addIssue({
+			code: "custom",
+			path: ["text"],
+			message: "Only text nodes can contain a text value"
+		});
+	}));
+	RichTextDocSchema = z$1.object({
+		type: z$1.literal("doc"),
+		content: z$1.array(TipTapNodeSchema)
+	}).strict();
+}));
+//#endregion
 //#region ../blocks/src/system/manifest/fieldValidation/index.ts
 init_src$2();
+init_richTextSchema();
 const TEL_RE = /^[+()0-9\s-]{3,}$/;
 const SLUG_PATTERN = /^(?:[a-z0-9]+(?:-[a-z0-9]+)*)(?:\/(?:[a-z0-9]+(?:-[a-z0-9]+)*))*$/;
 const ALLOWED_URL_PROTOCOLS = ["http:", "https:"];
@@ -11359,7 +11763,7 @@ function fieldIssueToMessage(issue) {
 		case "tooManyItems": return `${issue.label} must have at most ${issue.maximum} ${pluralize(issue.itemLabel, issue.maximum)}`;
 		case "invalidRichText": return `${issue.label} must be valid rich text`;
 		case "invalidInlineText": return `${issue.label} must be valid styled text`;
-		case "invalidMedia": return `${issue.label} must be a valid media item`;
+		case "invalidMedia": return `${issue.label} must be a media object with an identifier`;
 		case "invalidLink": return `${issue.label} must be a valid link`;
 		case "invalidReference": return `${issue.label} must reference a valid item`;
 		default: return assertNever$17(issue);
@@ -11447,7 +11851,7 @@ function deriveFieldValidationPlan(field, path = [field.id]) {
 		case "media":
 		case "file": return {
 			...makePlan("media", "object", field, path, required, commonConstraints(required, { kind: "mediaObject" })),
-			legacyStringType: legacyStringMediaTypeForField(field)
+			allowedMediaTypes: field.type === "media" ? field.mediaKinds ?? DEFAULT_MEDIA_FIELD_KINDS : field.fileKinds ?? PUBLIC_FILE_FIELD_KINDS
 		};
 		case "link": return makePlan("link", "object", field, path, required, commonConstraints(required, { kind: "linkObject" }));
 		case "boolean": return makePlan("boolean", "boolean", field, path, required, requiredConstraints(required));
@@ -11459,12 +11863,25 @@ function deriveFieldValidationPlan(field, path = [field.id]) {
 		case "group":
 		case "modal": return {
 			...makePlan("group", "object", field, path, required, requiredConstraints(required)),
-			children: deriveNestedFieldPlans(field.schema?.fields ?? [], path),
+			childSelection: {
+				kind: "all",
+				fields: deriveNestedFieldPlans(field.schema?.fields ?? [], path)
+			},
 			allowNullChildren: field.type === "group" && field.ui?.widget === "locationPicker"
 		};
 		case "tabGroup": return {
 			...makePlan("group", "object", field, path, required, requiredConstraints(required)),
-			children: field.tabs.flatMap((tab) => deriveNestedFieldPlans(tab.fields, path))
+			childSelection: field.activeTabField ? {
+				kind: "discriminatedTabs",
+				activeTabField: field.activeTabField,
+				tabs: field.tabs.map((tab) => ({
+					typeId: tab.id,
+					fields: deriveNestedFieldPlans(tab.fields, path)
+				}))
+			} : {
+				kind: "all",
+				fields: field.tabs.flatMap((tab) => deriveNestedFieldPlans(tab.fields, path))
+			}
 		};
 		case "presetOrCustom":
 		case "contentTypeSelect":
@@ -11559,10 +11976,59 @@ function normalizeStoredContentValues(plans, content, options = {}) {
 	normalizeInlineTextFallbacks(plans, normalized, ctx);
 	return normalized;
 }
+function allGroupChildPlans(plan) {
+	switch (plan.childSelection.kind) {
+		case "all": return plan.childSelection.fields;
+		case "discriminatedTabs": return plan.childSelection.tabs.flatMap((tab) => tab.fields);
+		default: return assertNever$17(plan.childSelection);
+	}
+}
+function selectedGroupChildPlans(plan, value) {
+	if (plan.childSelection.kind === "all") return plan.childSelection.fields;
+	if (!isPlainObject$4(value)) return [];
+	const selectedType = value[plan.childSelection.activeTabField];
+	return plan.childSelection.tabs.find((tab) => tab.typeId === selectedType)?.fields ?? [];
+}
+function canonicalizeFieldValueForWrite(plan, value) {
+	switch (plan.kind) {
+		case "media": {
+			if (!isPlainObject$4(value)) return value;
+			const canonical = { ...value };
+			if (typeof canonical.identifier === "string" && canonical.identifier.trim().length > 0) deleteEnvSpecificKeys(canonical);
+			return canonical;
+		}
+		case "group": return canonicalizeObjectForWrite(selectedGroupChildPlans(plan, value), value);
+		case "repeater":
+			if (!isUnknownArray$3(value)) return value;
+			return value.map((item) => {
+				if (!isPlainObject$4(item)) return item;
+				const childPlans = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((variant) => variant.typeId === item._type)?.fields : plan.repeatedItemPlan;
+				return childPlans ? canonicalizeObjectForWrite(childPlans, item) : item;
+			});
+		case "string":
+		case "number":
+		case "boolean":
+		case "richText":
+		case "inlineText":
+		case "link":
+		case "select":
+		case "passthrough": return value;
+		default: return assertNever$17(plan);
+	}
+}
+function canonicalizeObjectForWrite(plans, value) {
+	if (!isPlainObject$4(value)) return value;
+	const canonical = { ...value };
+	for (const plan of plans) {
+		if (!(plan.fieldId in canonical)) continue;
+		canonical[plan.fieldId] = canonicalizeFieldValueForWrite(plan, canonical[plan.fieldId]);
+	}
+	return canonical;
+}
 function normalizeStoredFieldValueWithContext(plan, value, ctx) {
 	if (value === null && !plan.required) return;
 	switch (plan.kind) {
-		case "group": return normalizeStoredObjectChildren(plan.children, value, childValidationContext(plan, ctx));
+		case "group": return normalizeStoredObjectChildren(selectedGroupChildPlans(plan, value), value, childValidationContext(plan, ctx));
 		case "repeater": return normalizeStoredRepeaterItems(plan, value, ctx);
 		case "string":
 		case "number":
@@ -11584,7 +12050,7 @@ function normalizeStoredObjectChildren(children, value, ctx) {
 	return normalized;
 }
 function normalizeStoredRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$4(value)) return value;
+	if (!isUnknownArray$3(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -11601,7 +12067,7 @@ function normalizeFieldValue(plan, value, ctx) {
 	switch (plan.kind) {
 		case "number": return normalizeNumberInput(value, ctx.allowNull);
 		case "string": return acceptsOptionalBlankAsMissing(plan, value) ? void 0 : value;
-		case "group": return normalizeObjectChildren(plan.children, value, childValidationContext(plan, ctx));
+		case "group": return normalizeObjectChildren(selectedGroupChildPlans(plan, value), value, childValidationContext(plan, ctx));
 		case "repeater": return normalizeRepeaterItems(plan, value, ctx);
 		case "boolean":
 		case "richText":
@@ -11609,17 +12075,10 @@ function normalizeFieldValue(plan, value, ctx) {
 		case "link":
 		case "select":
 		case "passthrough": return value;
-		case "media": return normalizeMediaInput(plan, value);
+		case "media": return value;
 		default: return assertNever$17(plan);
 	}
 }
-function normalizeMediaInput(plan, value) {
-	return normalizeLegacyStringMediaValueForField(value, {
-		type: plan.fieldType,
-		mediaKinds: plan.fieldType === "media" ? [plan.legacyStringType] : void 0,
-		fileKinds: plan.fieldType === "file" ? [plan.legacyStringType] : void 0
-	});
-}
 function normalizeObjectChildren(children, value, ctx) {
 	if (!value || typeof value !== "object" || Array.isArray(value)) return value;
 	const normalized = { ...value };
@@ -11643,7 +12102,7 @@ function getAtFieldPath(source, path) {
 	}, source);
 }
 function normalizeRepeaterItems(plan, value, ctx) {
-	if (!isUnknownArray$4(value)) return value;
+	if (!isUnknownArray$3(value)) return value;
 	return value.map((item) => {
 		if (!item || typeof item !== "object" || Array.isArray(item)) return item;
 		const itemRecord = item;
@@ -11671,7 +12130,7 @@ function validateNormalizedFieldValue(plan, value, ctx) {
 		case "select": return validateSelectPlan(plan, value);
 		case "richText": return isValidRichTextDoc(value) ? [] : [issue(plan, "invalidRichText")];
 		case "inlineText": return validateInlineTextPlan(plan, value);
-		case "media": return isPlainObject$4(value) ? [] : [issue(plan, "invalidMedia")];
+		case "media": return isPlainObject$4(value) && typeof value.identifier === "string" && value.identifier.trim().length > 0 && (value.type === void 0 || typeof value.type === "string" && plan.allowedMediaTypes.includes(value.type)) ? [] : [issue(plan, "invalidMedia")];
 		case "link": return linkSchema.safeParse(value).success ? [] : [issue(plan, "invalidLink")];
 		case "repeater": return validateRepeaterPlan(plan, value, ctx);
 		case "group": return validateGroupPlan(plan, value, ctx);
@@ -11764,9 +12223,26 @@ function validateRepeaterPlan(plan, value, ctx) {
 	}), ...value.flatMap((item, index) => validateRepeaterItem(plan, item, index, ctx))];
 }
 function validateRepeaterItem(plan, item, index, ctx) {
-	if (!isPlainObject$4(item)) return [];
+	if (!isPlainObject$4(item)) return [{
+		kind: "wrongType",
+		path: [...plan.path, index],
+		fieldId: plan.fieldId,
+		label: plan.label,
+		expected: "an object"
+	}];
 	const itemType = item._type;
-	const fields = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((variant) => variant.typeId === itemType)?.fields : plan.repeatedItemPlan;
+	const variant = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((candidate) => candidate.typeId === itemType) : void 0;
+	if (plan.repeatedItemVariants && !variant) return [{
+		kind: "invalidOption",
+		path: [
+			...plan.path,
+			index,
+			"_type"
+		],
+		fieldId: "_type",
+		label: `${plan.label} item type`
+	}];
+	const fields = variant?.fields ?? plan.repeatedItemPlan;
 	if (!fields) return [];
 	return fields.flatMap((childPlan) => {
 		return validateNormalizedFieldValue(materializeRepeaterItemPlan(childPlan, plan.path, index), item[childPlan.fieldId], ctx);
@@ -11774,8 +12250,17 @@ function validateRepeaterItem(plan, item, index, ctx) {
 }
 function validateGroupPlan(plan, value, ctx) {
 	if (!isPlainObject$4(value)) return [issue(plan, "wrongType", { expected: "an object" })];
+	if (plan.childSelection.kind === "discriminatedTabs") {
+		const selectedType = value[plan.childSelection.activeTabField];
+		if (selectedType !== void 0 && selectedType !== null && !plan.childSelection.tabs.some((tab) => tab.typeId === selectedType)) return [{
+			kind: "invalidOption",
+			path: [...plan.path, plan.childSelection.activeTabField],
+			fieldId: plan.childSelection.activeTabField,
+			label: `${plan.label} type`
+		}];
+	}
 	const childCtx = childValidationContext(plan, ctx);
-	return plan.children.flatMap((childPlan) => validateNormalizedFieldValue(childPlan, value[childPlan.fieldId], childCtx));
+	return selectedGroupChildPlans(plan, value).flatMap((childPlan) => validateNormalizedFieldValue(childPlan, value[childPlan.fieldId], childCtx));
 }
 function childValidationContext(plan, ctx) {
 	return plan.allowNullChildren ? {
@@ -11792,7 +12277,16 @@ function rebaseFieldPlanPath(plan, fromPrefix, toPrefix) {
 		case "group": return {
 			...plan,
 			path,
-			children: plan.children.map((childPlan) => rebaseFieldPlanPath(childPlan, fromPrefix, toPrefix))
+			childSelection: plan.childSelection.kind === "all" ? {
+				kind: "all",
+				fields: plan.childSelection.fields.map((childPlan) => rebaseFieldPlanPath(childPlan, fromPrefix, toPrefix))
+			} : {
+				...plan.childSelection,
+				tabs: plan.childSelection.tabs.map((tab) => ({
+					...tab,
+					fields: tab.fields.map((childPlan) => rebaseFieldPlanPath(childPlan, fromPrefix, toPrefix))
+				}))
+			}
 		};
 		case "repeater": return {
 			...plan,
@@ -11948,7 +12442,7 @@ function findFieldValidationPlan(plans, path) {
 }
 function findNestedFieldValidationPlan(plan, path) {
 	switch (plan.kind) {
-		case "group": return findFieldValidationPlan(plan.children, path);
+		case "group": return findFieldValidationPlan(allGroupChildPlans(plan), path);
 		case "repeater": {
 			const index = path[plan.path.length];
 			if (typeof index !== "number") return null;
@@ -11976,7 +12470,7 @@ function validateExplicitNullsForPush(plans, content, ctx) {
 function validateExplicitNullForPushPlan(plan, value, ctx) {
 	if (value === null) return !plan.required && !ctx.allowNull && !acceptsOptionalNullValue(plan) ? validateFieldValue(plan, value, { allowNull: false }) : [];
 	switch (plan.kind) {
-		case "group": return validateExplicitNullsForPush(plan.children, value, childValidationContext(plan, ctx));
+		case "group": return validateExplicitNullsForPush(selectedGroupChildPlans(plan, value), value, childValidationContext(plan, ctx));
 		case "repeater": return validateExplicitNullsForPushRepeater(plan, value, ctx);
 		case "string":
 		case "number":
@@ -11991,7 +12485,7 @@ function validateExplicitNullForPushPlan(plan, value, ctx) {
 	}
 }
 function validateExplicitNullsForPushRepeater(plan, value, ctx) {
-	if (!isUnknownArray$4(value)) return [];
+	if (!isUnknownArray$3(value)) return [];
 	return value.flatMap((item, index) => {
 		if (!isPlainObject$4(item)) return [];
 		const childPlans = plan.repeatedItemVariants ? plan.repeatedItemVariants.find((variant) => variant.typeId === item._type)?.fields : plan.repeatedItemPlan;
@@ -12079,27 +12573,21 @@ function isEmptyValue$1(value) {
 function isPlainObject$4(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-function isUnknownArray$4(value) {
+function isUnknownArray$3(value) {
 	return Array.isArray(value);
 }
 function isValidRichTextDoc(value) {
-	const doc = richTextDoc(value);
-	return Boolean(isPlainObject$4(doc) && doc.type === "doc");
+	return isRichTextDoc(value);
 }
 function isEmptyRichTextDoc(value) {
-	const doc = richTextDoc(value);
-	if (!isPlainObject$4(doc)) return false;
-	if (doc.type !== "doc") return false;
-	const content = doc.content;
+	if (!isPlainObject$4(value)) return false;
+	if (value.type !== "doc") return false;
+	const content = value.content;
 	if (!Array.isArray(content) || content.length === 0) return true;
 	if (content.length !== 1) return false;
 	const first = content[0];
 	return first?.type === "paragraph" && (!Array.isArray(first.content) || first.content.length === 0);
 }
-function richTextDoc(value) {
-	if (!isPlainObject$4(value)) return value;
-	return isPlainObject$4(value.doc) ? value.doc : value;
-}
 //#endregion
 //#region ../blocks/src/system/manifest/registry.ts
 const REGISTRY_SYMBOL$1 = Symbol.for("@riverbankcms/blocks/manifest-registry");
@@ -12123,11 +12611,14 @@ function preprocessEmptyValues(content) {
 	return result;
 }
 function createManifestValidator(manifestOrFields, options = {}) {
+	return createManifestValidatorWithNormalizer(manifestOrFields, options, normalizeStoredContentValues);
+}
+function createManifestValidatorWithNormalizer(manifestOrFields, options, normalize) {
 	const isDraft = options.mode === "draft";
 	const plans = derivePlansFromManifestOrFields(manifestOrFields);
 	const baseSchema = deriveContentZodFromPlans(plans, options);
-	if (isDraft) return z$1.preprocess((content) => preprocessEmptyValues(normalizeStoredContentValues(plans, content, options)), baseSchema);
-	return z$1.preprocess((content) => normalizeStoredContentValues(plans, content, options), baseSchema);
+	if (isDraft) return z$1.preprocess((content) => preprocessEmptyValues(normalize(plans, content, options)), baseSchema);
+	return z$1.preprocess((content) => normalize(plans, content, options), baseSchema);
 }
 function deriveContentZodFromPlans(plans, options) {
 	const shape = {};
@@ -12468,7 +12959,7 @@ function defineBlockDesignCapability(capability) {
 	};
 }
 var plainFrame, tileTreatmentValues, eventListTreatmentValues, eyebrowTreatmentValues, visibleHeadingDecorationFamilyValues, headingDecorationOverrideValues, headingDecorationColorTokenValues, noHeadingDecoration, accordionIconSetValues, accordionIconColorTokenValues, accordionIconMotionValues;
-var init_types$16 = __esmMin((() => {
+var init_types$15 = __esmMin((() => {
 	plainFrame = { kind: "plain" };
 	tileTreatmentValues = [
 		"default",
@@ -12533,14 +13024,14 @@ function defineBlockAppearancePreset(preset) {
 	return preset;
 }
 var init_appearancePresetResolution = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 }));
 //#endregion
 //#region ../theme-core/src/site-styles/blockAppearancePresets.ts
 var blockAppearancePresets;
 var init_blockAppearancePresets = __esmMin((() => {
 	init_appearancePresetResolution();
-	init_types$16();
+	init_types$15();
 	blockAppearancePresets = [
 		defineBlockAppearancePreset({
 			kind: "block-design",
@@ -13353,168 +13844,10 @@ function assertUniqueLayoutProfileKeys(profiles) {
 	if (duplicates.length > 0) throw new Error(`Duplicate block layout design profiles: ${duplicates.join(", ")}`);
 }
 var init_blockFlow = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 }));
 var init_classic_professional = __esmMin((() => {}));
-//#endregion
-//#region ../theme-core/src/mock-themes/modern-minimal.ts
-var modernMinimalTheme;
-var init_modern_minimal = __esmMin((() => {
-	modernMinimalTheme = {
-		name: "Modern Minimal",
-		description: "Clean, monochromatic design with subtle styling and modern typography",
-		rationale: "Perfect for professional services, portfolios, and content-focused sites that need a clean, trustworthy appearance",
-		axes: {
-			tone: "minimal",
-			energy: "calm",
-			density: "airy",
-			mediaBias: "text",
-			conversionBias: "low",
-			motion: "subtle"
-		},
-		palette: {
-			colors: [
-				{
-					name: "primary",
-					hex: "#1f2937"
-				},
-				{
-					name: "primaryForeground",
-					hex: "#ffffff"
-				},
-				{
-					name: "secondary",
-					hex: "#6b7280"
-				},
-				{
-					name: "accent",
-					hex: "#3b82f6"
-				},
-				{
-					name: "success",
-					hex: "#10b981"
-				},
-				{
-					name: "warning",
-					hex: "#f59e0b"
-				},
-				{
-					name: "destructive",
-					hex: "#ef4444"
-				},
-				{
-					name: "background",
-					hex: "#ffffff"
-				},
-				{
-					name: "surface",
-					hex: "#ffffff"
-				},
-				{
-					name: "surfaceAlt",
-					hex: "#f9fafb"
-				},
-				{
-					name: "muted",
-					hex: "#f3f4f6"
-				},
-				{
-					name: "text",
-					hex: "#1f2937"
-				},
-				{
-					name: "border",
-					hex: "#e5e7eb"
-				}
-			],
-			meta: { mode: "light" }
-		},
-		typography: {
-			headings: {
-				default: {
-					family: "Inter, system-ui, sans-serif",
-					weight: "medium",
-					letterSpacing: "tight",
-					lineHeight: "normal",
-					case: "normal",
-					italic: null
-				},
-				h1: {
-					weight: "semibold",
-					letterSpacing: "tight",
-					size: "xl",
-					lineHeight: "normal",
-					italic: null
-				},
-				h2: {
-					weight: "medium",
-					letterSpacing: "normal",
-					size: "lg",
-					lineHeight: "normal",
-					italic: null
-				},
-				h3: {
-					weight: "medium",
-					letterSpacing: "normal",
-					size: "md",
-					lineHeight: "normal",
-					italic: null
-				}
-			},
-			body: {
-				family: "Inter, system-ui, sans-serif",
-				weight: "regular",
-				size: "md",
-				letterSpacing: "normal",
-				lineHeight: "relaxed"
-			},
-			scale: "minorThird"
-		},
-		space: "comfortable",
-		corners: "rounded",
-		border: {
-			width: "hairline",
-			style: "solid"
-		},
-		shadow: {
-			elevation: "low",
-			softness: "soft",
-			position: "bottom"
-		},
-		motion: {
-			level: "low",
-			easing: "standard"
-		},
-		header: {
-			variant: "classic",
-			positioning: "static",
-			shrinkOnScroll: false,
-			maxWidth: "container",
-			logoOverride: null,
-			background: {
-				type: "color",
-				color: "surface"
-			},
-			navStyle: "minimal",
-			navWeight: "medium",
-			navContainer: {
-				type: "none",
-				opacity: 0,
-				tint: null
-			}
-		},
-		footer: {
-			variant: "simple",
-			maxWidth: "container",
-			background: {
-				type: "color",
-				color: "surface"
-			},
-			navStyle: "minimal",
-			navWeight: "medium"
-		}
-	};
-}));
+var init_modern_minimal = __esmMin((() => {}));
 var init_vibrant_creative = __esmMin((() => {}));
 //#endregion
 //#region ../theme-core/src/palette/generateCssVars.ts
@@ -13840,7 +14173,7 @@ var init_all = __esmMin((() => {
 }));
 //#endregion
 //#region ../theme-core/src/palette/types.ts
-var init_types$15 = __esmMin((() => {}));
+var init_types$14 = __esmMin((() => {}));
 //#endregion
 //#region ../../node_modules/.pnpm/@vibrant+image@4.0.4/node_modules/@vibrant/image/dist/esm/histogram.js
 var Histogram;
@@ -15293,7 +15626,7 @@ function defineCuratedPalette(input) {
 	};
 }
 var curatedPaletteAuthoringKeySchema;
-var init_types$14 = __esmMin((() => {
+var init_types$13 = __esmMin((() => {
 	init_styleTags();
 	init_themeColorTokens();
 	init_colors();
@@ -15334,7 +15667,7 @@ var init_types$14 = __esmMin((() => {
 //#region ../theme-core/src/palette/curated/brand-led.ts
 var brandLedCool, brandLedWarm, brandLedJewel, brandLedSpruce, brandLedBurgundyGold;
 var init_brand_led = __esmMin((() => {
-	init_types$14();
+	init_types$13();
 	brandLedCool = defineCuratedPalette({
 		authoringKey: "brand-led-cool",
 		name: "Brand-led — Cool",
@@ -15665,7 +15998,7 @@ var init_brand_led = __esmMin((() => {
 //#region ../theme-core/src/palette/curated/high-contrast.ts
 var highContrastInk, highContrastCharcoal, highContrastMonochrome;
 var init_high_contrast = __esmMin((() => {
-	init_types$14();
+	init_types$13();
 	highContrastInk = defineCuratedPalette({
 		authoringKey: "high-contrast-ink",
 		name: "High Contrast — Ink",
@@ -15866,7 +16199,7 @@ var init_high_contrast = __esmMin((() => {
 //#region ../theme-core/src/palette/curated/soft-natural.ts
 var softNaturalSage, softNaturalStone, softNaturalWatercolor, softNaturalLilac;
 var init_soft_natural = __esmMin((() => {
-	init_types$14();
+	init_types$13();
 	softNaturalSage = defineCuratedPalette({
 		authoringKey: "soft-natural-sage",
 		name: "Soft Natural — Sage",
@@ -16132,7 +16465,7 @@ var init_soft_natural = __esmMin((() => {
 //#region ../theme-core/src/palette/curated/warm-neutral.ts
 var warmNeutralClay, warmNeutralCream, warmNeutralSoftEarth, warmNeutralForest;
 var init_warm_neutral = __esmMin((() => {
-	init_types$14();
+	init_types$13();
 	warmNeutralClay = defineCuratedPalette({
 		authoringKey: "warm-neutral-clay",
 		name: "Warm Neutral — Clay",
@@ -16398,7 +16731,7 @@ var init_warm_neutral = __esmMin((() => {
 //#region ../theme-core/src/palette/curated/warm-dark.ts
 var warmDarkEmber, warmDarkKirtanGold;
 var init_warm_dark = __esmMin((() => {
-	init_types$14();
+	init_types$13();
 	warmDarkEmber = defineCuratedPalette({
 		authoringKey: "warm-dark-ember",
 		name: "Warm Dark — Ember",
@@ -16564,7 +16897,7 @@ var init_curated = __esmMin((() => {
 	init_soft_natural();
 	init_warm_neutral();
 	init_warm_dark();
-	init_types$14();
+	init_types$13();
 	curatedPalettes = [
 		admitCuratedPaletteDefinition(brandLedCool),
 		admitCuratedPaletteDefinition(brandLedWarm),
@@ -16696,7 +17029,7 @@ var init_palette$1 = __esmMin((() => {
 	init_generateCssVars();
 	init_generateShades();
 	init_neutralScale();
-	init_types$15();
+	init_types$14();
 	init_utils$6();
 	init_paletteAccess();
 	init_extractPalette();
@@ -16937,7 +17270,7 @@ var init_backgroundAppearance = __esmMin((() => {
 	backgroundAppearanceColorTokenNameSet = new Set(backgroundAppearanceColorTokenNames);
 }));
 var init_compositionBudget = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 }));
 var init_schemaVersionedJson = __esmMin((() => {}));
 //#endregion
@@ -16955,7 +17288,7 @@ function boundaryRuntimeMetricsForTransition(transition) {
 }
 var sectionBoundaryRuntimeMetricsByTransition, noneBoundaryOption, softBoundaryOption, spaciousBoundaryOption;
 var init_sectionTransitions = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 	sectionBoundaryRuntimeMetricsByTransition = {
 		none: null,
 		"soft-fade-short": boundaryRuntimeMetrics("gradient", "medium", "6rem + 2px"),
@@ -17044,7 +17377,7 @@ function boundaryKey$1(previousBlockId, nextBlockId) {
 }
 var pageDesignUserPinnedAppearanceChoiceSchema, pageDesignUserPinnedBoundaryChoiceSchema, pageDesignBoundaryTreatmentSchema, pageDesignUserPinnedBoundaryTreatmentChoiceSchema, pageDesignBlockLookPinSchema, pageDesignBoundaryPinSchema, legacyPageDesignBoundaryPinSchema;
 var init_pageDesignIntent = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 	init_schemaVersionedJson();
 	init_sectionTransitions();
 	asBoundaryOptionId("break:unknown");
@@ -17149,109 +17482,7 @@ var init_pageDesignIntent = __esmMin((() => {
 var init_contentTemplateDesignIntent = __esmMin((() => {
 	init_pageDesignIntent();
 	init_sectionTransitions();
-	init_types$16();
-}));
-//#endregion
-//#region ../theme-core/src/buttons/effectClassification.ts
-function getButtonEffectPolicy(effectId) {
-	return Object.prototype.hasOwnProperty.call(BUTTON_EFFECT_POLICIES, effectId) ? BUTTON_EFFECT_POLICIES[effectId] : null;
-}
-function classifyButtonEffectId(effectId) {
-	return getButtonEffectPolicy(effectId)?.classification ?? "unknown";
-}
-var BUTTON_EFFECT_POLICIES;
-var init_effectClassification = __esmMin((() => {
-	BUTTON_EFFECT_POLICIES = {
-		"darken-background": {
-			classification: "colour-transition",
-			transition: {
-				kind: "adjust-shade",
-				direction: "darker"
-			}
-		},
-		"lighten-background": {
-			classification: "colour-transition",
-			transition: {
-				kind: "adjust-shade",
-				direction: "lighter"
-			}
-		},
-		"background-on-hover": {
-			classification: "colour-transition",
-			transition: { kind: "replace-background" }
-		},
-		"background-on-hover-alpha": {
-			classification: "unsupported-colour",
-			reason: "alpha_requires_surface"
-		},
-		"fade-background": {
-			classification: "unsupported-colour",
-			reason: "changes_element_opacity"
-		},
-		"opacity-reduce": {
-			classification: "unsupported-colour",
-			reason: "changes_element_opacity"
-		},
-		"gradient-text": {
-			classification: "unsupported-colour",
-			reason: "changes_foreground"
-		},
-		"text-color-change": {
-			classification: "unsupported-colour",
-			reason: "changes_foreground"
-		},
-		"border-color-change": {
-			classification: "unsupported-colour",
-			reason: "changes_border"
-		},
-		"aurora-glow": {
-			classification: "unsupported-background-overlay",
-			reason: "unresolved_background_overlay"
-		},
-		"cosmic-stardust": {
-			classification: "unsupported-background-overlay",
-			reason: "unresolved_background_overlay"
-		},
-		"gradient-border-fill": {
-			classification: "unsupported-background-overlay",
-			reason: "unresolved_background_overlay"
-		},
-		"animated-gradient-border-fill": {
-			classification: "unsupported-background-overlay",
-			reason: "unresolved_background_overlay"
-		},
-		"nav-underline": {
-			classification: "not-button",
-			reason: "not_button_effect"
-		},
-		"nav-frosted-base": {
-			classification: "not-button",
-			reason: "not_button_effect"
-		},
-		"nav-frosted-hover": {
-			classification: "not-button",
-			reason: "not_button_effect"
-		},
-		"nav-frosted-active": {
-			classification: "not-button",
-			reason: "not_button_effect"
-		},
-		"animated-gradient": { classification: "non-colour" },
-		"border-glow": { classification: "non-colour" },
-		"drop-shadow": { classification: "non-colour" },
-		"inner-shadow": { classification: "non-colour" },
-		"neumorphic-shadow": { classification: "non-colour" },
-		"outer-glow": { classification: "non-colour" },
-		"retro-3d-shadow": { classification: "non-colour" },
-		"scale-up": { classification: "non-colour" },
-		"scale-down": { classification: "non-colour" },
-		lift: { classification: "non-colour" },
-		"press-down": { classification: "non-colour" },
-		pop: { classification: "non-colour" },
-		"border-bottom-grow": { classification: "non-colour" },
-		"sketchy-border": { classification: "non-colour" },
-		"pulse-animation": { classification: "non-colour" }
-	};
+	init_types$15();
 }));
 //#endregion
 //#region ../theme-core/src/buttons/types.ts
@@ -17259,8 +17490,9 @@ function isVariantRole(value) {
 	return VARIANT_ROLES.includes(value);
 }
 function asSpecialVariantId(value) {
-	if (value.length === 0) throw new Error("SpecialVariantId must be a non-empty string");
-	return value;
+	const parsed = buttonVariantIdSchema.safeParse(value);
+	if (!parsed.success) throw new Error("SpecialVariantId must be a CSS-safe button variant ID");
+	return parsed.data;
 }
 function parseOpaqueButtonColourToken(value) {
 	const token = parseThemeColorToken(value);
@@ -17271,144 +17503,8 @@ function parseOpaqueButtonColourToken(value) {
 function unsafeAsOpaqueButtonColourToken(value) {
 	return value;
 }
-function normalizeLegacyButtonVariantInput(input) {
-	if (!isUnknownRecord(input)) return input;
-	const background = input.background;
-	if (!isUnknownRecord(background)) return input;
-	if (!(background.type === "transparent" || Object.prototype.hasOwnProperty.call(input, "textColorToken") || isUnknownRecord(input.border) && Object.prototype.hasOwnProperty.call(input.border, "colorToken") || hasLegacyButtonEffects(input.effects) || hasLegacyAlphaToken(input, background))) return input;
-	const { textColorToken, ...withoutLegacyText } = input;
-	const normalizedBorder = isUnknownRecord(input.border) && typeof input.border.widthClass === "string" ? { widthClass: input.border.widthClass } : input.border;
-	const normalizedAffordance = isUnknownRecord(input.affordance) && typeof input.affordance.iconId === "string" ? { iconId: input.affordance.iconId } : input.affordance;
-	const normalizedEffects = normalizeLegacyButtonEffects(input.effects, background.type);
-	const hoverBackgroundToken = stripLegacyTokenAlpha(input.hoverBackgroundToken);
-	if (background.type === "transparent") return {
-		...withoutLegacyText,
-		background: {
-			type: "surface",
-			role: "link"
-		},
-		border: normalizedBorder,
-		affordance: normalizedAffordance,
-		effects: normalizedEffects,
-		hoverBackgroundToken
-	};
-	if (background.type === "gradient") {
-		const stops = Array.isArray(background.stops) ? background.stops.map(stripLegacyTokenAlpha) : background.stops;
-		return {
-			...withoutLegacyText,
-			background: {
-				...background,
-				stops,
-				foregroundToken: stripLegacyTokenAlpha(background.foregroundToken ?? textColorToken)
-			},
-			border: normalizedBorder,
-			affordance: normalizedAffordance,
-			effects: normalizedEffects,
-			hoverBackgroundToken
-		};
-	}
-	return {
-		...withoutLegacyText,
-		background: background.type === "solid" ? {
-			...background,
-			colorToken: stripLegacyTokenAlpha(background.colorToken)
-		} : background,
-		border: normalizedBorder,
-		affordance: normalizedAffordance,
-		effects: normalizedEffects,
-		hoverBackgroundToken
-	};
-}
-function normalizeLegacyButtonGlobalInput(input) {
-	if (!isUnknownRecord(input)) return input;
-	const hoverColorToken = stripLegacyTokenAlpha(input.hoverColorToken);
-	return hoverColorToken === input.hoverColorToken ? input : {
-		...input,
-		hoverColorToken
-	};
-}
-function hasLegacyAlphaToken(input, background) {
-	const stops = isUnknownArray$3(background.stops) ? background.stops : [];
-	return [
-		input.hoverBackgroundToken,
-		background.colorToken,
-		background.foregroundToken,
-		...stops
-	].some((token) => stripLegacyTokenAlpha(token) !== token);
-}
-function stripLegacyTokenAlpha(value) {
-	if (typeof value !== "string") return value;
-	const slashIndex = value.indexOf("/");
-	return slashIndex < 0 ? value : value.slice(0, slashIndex);
-}
-function hasLegacyButtonEffects(input) {
-	if (!isUnknownRecord(input)) return false;
-	return [
-		"base",
-		"hover",
-		"active",
-		"focus"
-	].some((state) => {
-		const effects = input[state];
-		return Array.isArray(effects) && effects.some((effect) => {
-			if (!isUnknownRecord(effect) || typeof effect.effectId !== "string") return true;
-			const classification = classifyButtonEffectId(effect.effectId);
-			if (classification !== "colour-transition" && classification !== "non-colour") return true;
-			return effect.effectId === "background-on-hover" && isUnknownRecord(effect.options) && stripLegacyTokenAlpha(effect.options.colorToken) !== effect.options.colorToken;
-		});
-	});
-}
-function normalizeLegacyButtonEffects(input, backgroundType) {
-	if (!isUnknownRecord(input)) return input;
-	const normalized = {};
-	for (const state of [
-		"base",
-		"hover",
-		"active",
-		"focus"
-	]) {
-		const effects = input[state];
-		if (!Array.isArray(effects)) continue;
-		const safeEffects = effects.flatMap((effect) => {
-			if (!isUnknownRecord(effect) || typeof effect.effectId !== "string") return [];
-			const classification = classifyButtonEffectId(effect.effectId);
-			if (classification === "non-colour") return [effect];
-			if (classification !== "colour-transition") return [];
-			if (effect.effectId === "background-on-hover") {
-				const options = isUnknownRecord(effect.options) ? effect.options : null;
-				const colorToken = options === null ? null : parseOpaqueButtonColourToken(stripLegacyTokenAlpha(options.colorToken));
-				return colorToken === null ? [] : [{
-					...effect,
-					options: {
-						...options,
-						colorToken
-					}
-				}];
-			}
-			if (backgroundType !== "solid") return [];
-			const rawAmount = isUnknownRecord(effect.options) ? effect.options.amount : void 0;
-			const amount = typeof rawAmount === "number" && rawAmount > 0 ? Math.max(100, Math.round(rawAmount / 100) * 100) : 100;
-			return [{
-				...effect,
-				options: {
-					...isUnknownRecord(effect.options) ? effect.options : {},
-					amount
-				}
-			}];
-		});
-		if (safeEffects.length > 0) normalized[state] = safeEffects;
-	}
-	return Object.keys(normalized).length === 0 ? void 0 : normalized;
-}
-function isUnknownRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isUnknownArray$3(value) {
-	return Array.isArray(value);
-}
-var VARIANT_ROLES, DEFAULT_VARIANT_ALIAS_ID, opaqueButtonColourTokenSchema, cornerStyleSchema, shadowSizeSchema, textTransformSchema, fontWeightSchema, buttonTypographySchema, letterSpacingSchema, hoverTransformSchema, hoverColorSchema, buttonPaddingPresetSchema, gradientStyleSchema, gradientSharpnessSchema, prioritySchema, buttonSizeNameSchema, PADDING_TOKEN_PATTERN, paddingShorthandSchema, buttonSizeConfigSchema, buttonSizesSchema, canonicalButtonGlobalSettingsSchema, buttonGlobalSettingsSchema, gradientDirectionSchema$1, buttonColourTreatmentSchema, buttonBackgroundSchema, effectApplicationSchema$1, buttonBorderSchema, buttonVariantAffordanceSchema, variantShadowSchema, variantEffectsSchema, variantSizeOverridesSchema, canonicalButtonVariantSchema, buttonVariantSchema, buttonSystemSchema;
-var init_types$13 = __esmMin((() => {
-	init_effectClassification();
+var VARIANT_ROLES, buttonVariantIdSchema, DEFAULT_VARIANT_ALIAS_ID, opaqueButtonColourTokenSchema, buttonShadeAmountSchema, buttonShadowIntensitySchema, buttonEffectApplicationSchema, cornerStyleSchema, shadowSizeSchema, textTransformSchema, fontWeightSchema, buttonTypographySchema, letterSpacingSchema, hoverTransformSchema, buttonPaddingPresetSchema, gradientStyleSchema, gradientSharpnessSchema, prioritySchema, buttonSizeNameSchema, PADDING_TOKEN_PATTERN, paddingShorthandSchema, buttonSizeConfigSchema, buttonSizesSchema, buttonGlobalSettingsBaseSchema, buttonGlobalSettingsSchema, gradientDirectionSchema$1, buttonColourTreatmentSchema, buttonBackgroundSchema, buttonBorderSchema, buttonVariantAffordanceSchema, variantShadowSchema, variantEffectsSchema, variantSizeOverridesSchema, buttonVariantSchema, buttonSystemSchema;
+var init_types$12 = __esmMin((() => {
 	init_themeColorTokens();
 	init_colorTokenParts();
 	VARIANT_ROLES = [
@@ -17420,12 +17516,109 @@ var init_types$13 = __esmMin((() => {
 		"tertiary",
 		"accent"
 	];
+	buttonVariantIdSchema = z$1.string().min(1).max(50).regex(/^[a-z0-9-]+$/, "Button variant IDs may contain lowercase letters, numbers, and hyphens only");
 	DEFAULT_VARIANT_ALIAS_ID = "default";
 	opaqueButtonColourTokenSchema = themeColorTokenSchema.refine((value) => parseOpaqueButtonColourToken(value) !== null, "Button colour tokens must be opaque").transform((value) => {
 		const token = parseOpaqueButtonColourToken(value);
 		if (token === null) throw new Error("Invariant: opaque button token passed its schema");
 		return token;
 	});
+	buttonShadeAmountSchema = z$1.number().finite().min(0).max(900).multipleOf(100);
+	buttonShadowIntensitySchema = z$1.enum([
+		"subtle",
+		"medium",
+		"strong"
+	]);
+	buttonEffectApplicationSchema = z$1.discriminatedUnion("effectId", [
+		z$1.strictObject({
+			effectId: z$1.literal("darken-background"),
+			options: z$1.strictObject({ amount: buttonShadeAmountSchema.optional() }).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("lighten-background"),
+			options: z$1.strictObject({ amount: buttonShadeAmountSchema.optional() }).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("background-on-hover"),
+			options: z$1.strictObject({ colorToken: opaqueButtonColourTokenSchema.optional() }).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("animated-gradient"),
+			options: z$1.strictObject({ direction: z$1.enum(["horizontal", "vertical"]).optional() }).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("drop-shadow"),
+			options: z$1.strictObject({ intensity: buttonShadowIntensitySchema.optional() }).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("inner-shadow"),
+			options: z$1.strictObject({}).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("neumorphic-shadow"),
+			options: z$1.strictObject({
+				mode: z$1.enum(["raised", "pressed"]).optional(),
+				intensity: buttonShadowIntensitySchema.optional()
+			}).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("retro-3d-shadow"),
+			options: z$1.strictObject({}).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("scale-up"),
+			options: z$1.strictObject({ scale: z$1.enum([
+				"1.02",
+				"1.03",
+				"1.05",
+				"1.10"
+			]).optional() }).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("scale-down"),
+			options: z$1.strictObject({ scale: z$1.enum([
+				"0.90",
+				"0.95",
+				"0.97",
+				"0.98"
+			]).optional() }).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("lift"),
+			options: z$1.strictObject({ amount: z$1.enum([
+				"0.25",
+				"0.5",
+				"1"
+			]).optional() }).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("press-down"),
+			options: z$1.strictObject({}).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("pop"),
+			options: z$1.strictObject({ intensity: z$1.enum([
+				"subtle",
+				"medium",
+				"dramatic"
+			]).optional() }).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("border-bottom-grow"),
+			options: z$1.strictObject({
+				height: z$1.union([z$1.literal(1), z$1.literal(2)]).optional(),
+				origin: z$1.enum([
+					"left",
+					"center",
+					"right"
+				]).optional()
+			}).optional()
+		}),
+		z$1.strictObject({
+			effectId: z$1.literal("sketchy-border"),
+			options: z$1.strictObject({ intensity: buttonShadowIntensitySchema.optional() }).optional()
+		})
+	]);
 	cornerStyleSchema = z$1.enum([
 		"square",
 		"rounded",
@@ -17460,13 +17653,7 @@ var init_types$13 = __esmMin((() => {
 		"scale",
 		"press"
 	]);
-	hoverColorSchema = z$1.enum([
-		"none",
-		"brighten",
-		"darken",
-		"saturate",
-		"token"
-	]);
+	z$1.enum(["none", "token"]);
 	buttonPaddingPresetSchema = z$1.enum([
 		"compact",
 		"default",
@@ -17514,7 +17701,7 @@ var init_types$13 = __esmMin((() => {
 		lg,
 		xl: xl ?? lg
 	}));
-	canonicalButtonGlobalSettingsSchema = z$1.object({
+	buttonGlobalSettingsBaseSchema = z$1.strictObject({
 		cornerStyle: cornerStyleSchema,
 		cornerRadius: z$1.number().min(0).max(24).optional(),
 		/**
@@ -17527,30 +17714,23 @@ var init_types$13 = __esmMin((() => {
 		shadow: shadowSizeSchema.optional(),
 		textTransform: textTransformSchema,
 		fontWeight: fontWeightSchema,
-		/**
-		* @deprecated Set per-variant via `variant.border.widthClass` instead.
-		* Schema field is preserved so existing presets parse; the value is unread
-		* by the current generator and will be removed once the legacy
-		* `primitives/content/components/Button.tsx` slot exports are deleted.
-		*/
-		borderWidth: z$1.union([
-			z$1.literal(1),
-			z$1.literal(2),
-			z$1.literal(3)
-		]),
 		typography: buttonTypographySchema.optional(),
 		fontSize: z$1.string().optional(),
 		letterSpacing: letterSpacingSchema.optional(),
 		italic: z$1.boolean().optional(),
 		paddingPreset: buttonPaddingPresetSchema.optional(),
 		hoverTransform: hoverTransformSchema,
-		hoverColor: hoverColorSchema,
-		hoverColorToken: opaqueButtonColourTokenSchema.optional(),
 		gradientStyle: gradientStyleSchema.optional(),
 		gradientAngle: z$1.number().min(0).max(360).optional(),
 		gradientSharpness: gradientSharpnessSchema.optional()
 	});
-	buttonGlobalSettingsSchema = z$1.preprocess(normalizeLegacyButtonGlobalInput, canonicalButtonGlobalSettingsSchema);
+	buttonGlobalSettingsSchema = z$1.discriminatedUnion("hoverColor", [buttonGlobalSettingsBaseSchema.extend({
+		hoverColor: z$1.literal("none"),
+		hoverColorToken: z$1.never().optional()
+	}), buttonGlobalSettingsBaseSchema.extend({
+		hoverColor: z$1.literal("token"),
+		hoverColorToken: opaqueButtonColourTokenSchema
+	})]);
 	gradientDirectionSchema$1 = z$1.enum([
 		"to-r",
 		"to-l",
@@ -17562,11 +17742,11 @@ var init_types$13 = __esmMin((() => {
 		"to-bl"
 	]);
 	buttonColourTreatmentSchema = z$1.discriminatedUnion("type", [
-		z$1.object({
+		z$1.strictObject({
 			type: z$1.literal("solid"),
 			colorToken: opaqueButtonColourTokenSchema
 		}),
-		z$1.object({
+		z$1.strictObject({
 			type: z$1.literal("gradient"),
 			stops: z$1.array(opaqueButtonColourTokenSchema).min(2).transform((stops) => {
 				const [first, second, ...rest] = stops;
@@ -17580,19 +17760,15 @@ var init_types$13 = __esmMin((() => {
 			direction: gradientDirectionSchema$1,
 			foregroundToken: opaqueButtonColourTokenSchema
 		}),
-		z$1.object({
+		z$1.strictObject({
 			type: z$1.literal("surface"),
 			role: z$1.literal("link")
 		})
 	]);
 	buttonBackgroundSchema = buttonColourTreatmentSchema;
-	effectApplicationSchema$1 = z$1.object({
-		effectId: z$1.string(),
-		options: z$1.record(z$1.string(), z$1.json()).optional()
-	});
-	buttonBorderSchema = z$1.object({ widthClass: z$1.string() });
-	buttonVariantAffordanceSchema = z$1.object({ iconId: z$1.string().min(1) });
-	variantShadowSchema = z$1.object({
+	buttonBorderSchema = z$1.strictObject({ widthClass: z$1.string() });
+	buttonVariantAffordanceSchema = z$1.strictObject({ iconId: z$1.string().min(1) });
+	variantShadowSchema = z$1.strictObject({
 		elevation: z$1.enum([
 			"none",
 			"low",
@@ -17605,13 +17781,13 @@ var init_types$13 = __esmMin((() => {
 			"hard"
 		]).nullable(),
 		position: z$1.enum(["bottom", "bottom-right"]).default("bottom"),
-		colorToken: themeColorTokenSchema.optional()
+		colorToken: opaqueButtonColourTokenSchema.optional()
 	});
-	variantEffectsSchema = z$1.object({
-		base: z$1.array(effectApplicationSchema$1).optional(),
-		hover: z$1.array(effectApplicationSchema$1).optional(),
-		active: z$1.array(effectApplicationSchema$1).optional(),
-		focus: z$1.array(effectApplicationSchema$1).optional()
+	variantEffectsSchema = z$1.strictObject({
+		base: z$1.array(buttonEffectApplicationSchema).optional(),
+		hover: z$1.array(buttonEffectApplicationSchema).optional(),
+		active: z$1.array(buttonEffectApplicationSchema).optional(),
+		focus: z$1.array(buttonEffectApplicationSchema).optional()
 	});
 	variantSizeOverridesSchema = z$1.object({
 		sm: buttonSizeConfigSchema.optional(),
@@ -17619,8 +17795,8 @@ var init_types$13 = __esmMin((() => {
 		lg: buttonSizeConfigSchema.optional(),
 		xl: buttonSizeConfigSchema.optional()
 	});
-	canonicalButtonVariantSchema = z$1.object({
-		id: z$1.string(),
+	buttonVariantSchema = z$1.strictObject({
+		id: buttonVariantIdSchema,
 		name: z$1.string().min(1).max(20),
 		enabled: z$1.boolean(),
 		priority: prioritySchema,
@@ -17634,11 +17810,24 @@ var init_types$13 = __esmMin((() => {
 		sizes: variantSizeOverridesSchema.optional(),
 		affordance: buttonVariantAffordanceSchema.optional()
 	});
-	buttonVariantSchema = z$1.preprocess(normalizeLegacyButtonVariantInput, canonicalButtonVariantSchema);
-	buttonSystemSchema = z$1.object({
+	buttonSystemSchema = z$1.strictObject({
 		global: buttonGlobalSettingsSchema,
 		variants: z$1.array(buttonVariantSchema).min(1).max(6),
 		sizes: buttonSizesSchema.optional()
+	}).superRefine((system, ctx) => {
+		const seen = /* @__PURE__ */ new Set();
+		system.variants.forEach((variant, index) => {
+			if (seen.has(variant.id)) ctx.addIssue({
+				code: "custom",
+				path: [
+					"variants",
+					index,
+					"id"
+				],
+				message: `Duplicate button variant ID: ${variant.id}`
+			});
+			seen.add(variant.id);
+		});
 	});
 }));
 //#endregion
@@ -17722,7 +17911,7 @@ function rolePriority(role) {
 }
 var PUBLIC_BUTTON_ROLES;
 var init_domain = __esmMin((() => {
-	init_types$13();
+	init_types$12();
 	PUBLIC_BUTTON_ROLES = [
 		"primary",
 		"secondary",
@@ -17778,7 +17967,7 @@ var init_selection = __esmMin((() => {
 var quietArrowRecipe;
 var init_quietArrow = __esmMin((() => {
 	init_domain();
-	init_types$13();
+	init_types$12();
 	init_selection();
 	quietArrowRecipe = defineButtonStyleRecipe({
 		id: "quiet-arrow",
@@ -17808,7 +17997,6 @@ var init_quietArrow = __esmMin((() => {
 				cornerStyle: "rounded",
 				textTransform: "uppercase",
 				fontWeight: 500,
-				borderWidth: 1,
 				typography: "body",
 				fontSize: "text-sm",
 				letterSpacing: "loose",
@@ -17872,7 +18060,7 @@ var init_quietArrow = __esmMin((() => {
 						affordance: { iconId: "ArrowRight" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surfaceAlt" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surfaceAlt") }
 						}] }
 					}
 				},
@@ -17968,7 +18156,7 @@ function normalizeAppearanceOverrides(overrides) {
 }
 var emptyParametersSchema;
 var init_defineStaticButtonStyleRecipe = __esmMin((() => {
-	init_types$13();
+	init_types$12();
 	init_domain();
 	emptyParametersSchema = z$1.object({}).strict();
 }));
@@ -17977,6 +18165,7 @@ var init_defineStaticButtonStyleRecipe = __esmMin((() => {
 var softPillRecipe, earthPillRecipe, confidentChipRecipe, editorialSizes, editorialLinkRecipe, pebbleRecipe, brushedWashRecipe, inkStampRecipe, flatInkRecipe, showtimePillRecipe, joyStampRecipe, ornateGhostSizes, ornateRitualRecipe;
 var init_staticRecipes = __esmMin((() => {
 	init_defineStaticButtonStyleRecipe();
+	init_types$12();
 	softPillRecipe = defineStaticButtonStyleRecipe({
 		id: "soft-pill",
 		accessibilityLabel: "Rounded pill buttons with a gentle hover lift",
@@ -17992,7 +18181,6 @@ var init_staticRecipes = __esmMin((() => {
 				shadow: "low",
 				textTransform: "none",
 				fontWeight: 500,
-				borderWidth: 2,
 				hoverTransform: "lift",
 				hoverColor: "none"
 			},
@@ -18011,10 +18199,7 @@ var init_staticRecipes = __esmMin((() => {
 							position: "bottom"
 						},
 						effects: {
-							hover: [{
-								effectId: "lift",
-								options: { translateY: "-1px" }
-							}],
+							hover: [{ effectId: "lift" }],
 							active: [{
 								effectId: "scale-down",
 								options: { scale: "0.98" }
@@ -18033,7 +18218,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border-2" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18048,7 +18233,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18062,7 +18247,7 @@ var init_staticRecipes = __esmMin((() => {
 						borderRadius: "rounded-full",
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18092,7 +18277,6 @@ var init_staticRecipes = __esmMin((() => {
 				shadow: "low",
 				textTransform: "none",
 				fontWeight: 500,
-				borderWidth: 1,
 				hoverTransform: "lift",
 				hoverColor: "none",
 				typography: "body",
@@ -18128,12 +18312,9 @@ var init_staticRecipes = __esmMin((() => {
 							position: "bottom"
 						},
 						effects: {
-							hover: [{
-								effectId: "lift",
-								options: { translateY: "-1px" }
-							}, {
+							hover: [{ effectId: "lift" }, {
 								effectId: "background-on-hover",
-								options: { colorToken: "accent" }
+								options: { colorToken: unsafeAsOpaqueButtonColourToken("accent") }
 							}],
 							active: [{
 								effectId: "scale-down",
@@ -18153,7 +18334,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "muted" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("muted") }
 						}] }
 					}
 				},
@@ -18168,7 +18349,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surfaceAlt" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surfaceAlt") }
 						}] }
 					}
 				},
@@ -18228,7 +18409,6 @@ var init_staticRecipes = __esmMin((() => {
 				shadow: "medium",
 				textTransform: "none",
 				fontWeight: 600,
-				borderWidth: 1,
 				hoverTransform: "none",
 				hoverColor: "none"
 			},
@@ -18269,7 +18449,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "background" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("background") }
 						}] }
 					}
 				},
@@ -18284,7 +18464,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18298,7 +18478,7 @@ var init_staticRecipes = __esmMin((() => {
 						borderRadius: "rounded-md",
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18333,7 +18513,6 @@ var init_staticRecipes = __esmMin((() => {
 				cornerStyle: "square",
 				textTransform: "none",
 				fontWeight: 500,
-				borderWidth: 1,
 				hoverTransform: "none",
 				hoverColor: "none"
 			},
@@ -18351,7 +18530,6 @@ var init_staticRecipes = __esmMin((() => {
 							effectId: "border-bottom-grow",
 							options: {
 								height: 2,
-								colorToken: "text",
 								origin: "left"
 							}
 						}] }
@@ -18370,7 +18548,6 @@ var init_staticRecipes = __esmMin((() => {
 							effectId: "border-bottom-grow",
 							options: {
 								height: 1,
-								colorToken: "mutedText",
 								origin: "left"
 							}
 						}] }
@@ -18389,7 +18566,6 @@ var init_staticRecipes = __esmMin((() => {
 							effectId: "border-bottom-grow",
 							options: {
 								height: 1,
-								colorToken: "accent",
 								origin: "left"
 							}
 						}] }
@@ -18413,7 +18589,6 @@ var init_staticRecipes = __esmMin((() => {
 						effectId: "border-bottom-grow",
 						options: {
 							height: 2,
-							colorToken: "accent",
 							origin: "left"
 						}
 					}] } }
@@ -18435,7 +18610,6 @@ var init_staticRecipes = __esmMin((() => {
 				cornerStyle: "pill",
 				textTransform: "none",
 				fontWeight: 500,
-				borderWidth: 2,
 				hoverTransform: "none",
 				hoverColor: "none"
 			},
@@ -18480,7 +18654,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border-2" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "accent" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("accent") }
 						}] }
 					}
 				},
@@ -18495,7 +18669,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18550,7 +18724,6 @@ var init_staticRecipes = __esmMin((() => {
 				shadow: "low",
 				textTransform: "none",
 				fontWeight: 500,
-				borderWidth: 1,
 				hoverTransform: "none",
 				hoverColor: "none"
 			},
@@ -18615,7 +18788,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18629,7 +18802,7 @@ var init_staticRecipes = __esmMin((() => {
 						borderRadius: "rounded-lg",
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18658,7 +18831,6 @@ var init_staticRecipes = __esmMin((() => {
 				cornerStyle: "rounded",
 				textTransform: "uppercase",
 				fontWeight: 600,
-				borderWidth: 1,
 				hoverTransform: "none",
 				hoverColor: "none",
 				letterSpacing: "loose"
@@ -18716,7 +18888,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border-2" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18731,7 +18903,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border-2" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -18765,7 +18937,6 @@ var init_staticRecipes = __esmMin((() => {
 							effectId: "border-bottom-grow",
 							options: {
 								height: 1,
-								colorToken: "accent",
 								origin: "left"
 							}
 						}] }
@@ -18796,7 +18967,6 @@ var init_staticRecipes = __esmMin((() => {
 				cornerStyle: "rounded",
 				textTransform: "none",
 				fontWeight: 600,
-				borderWidth: 1,
 				typography: "body",
 				letterSpacing: "tight",
 				paddingPreset: "default",
@@ -18828,12 +18998,9 @@ var init_staticRecipes = __esmMin((() => {
 						},
 						borderRadius: "rounded-lg",
 						affordance: { iconId: "ArrowRight" },
-						effects: { hover: [{
-							effectId: "lift",
-							options: { translateY: "-2px" }
-						}, {
+						effects: { hover: [{ effectId: "lift" }, {
 							effectId: "background-on-hover",
-							options: { colorToken: "secondary" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("secondary") }
 						}] }
 					}
 				},
@@ -18846,12 +19013,9 @@ var init_staticRecipes = __esmMin((() => {
 						},
 						borderRadius: "rounded-lg",
 						border: { widthClass: "border" },
-						effects: { hover: [{
-							effectId: "lift",
-							options: { translateY: "-2px" }
-						}, {
+						effects: { hover: [{ effectId: "lift" }, {
 							effectId: "background-on-hover",
-							options: { colorToken: "surfaceAlt" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surfaceAlt") }
 						}] }
 					}
 				},
@@ -18864,12 +19028,9 @@ var init_staticRecipes = __esmMin((() => {
 						},
 						borderRadius: "rounded-lg",
 						border: { widthClass: "border" },
-						effects: { hover: [{
-							effectId: "lift",
-							options: { translateY: "-2px" }
-						}, {
+						effects: { hover: [{ effectId: "lift" }, {
 							effectId: "background-on-hover",
-							options: { colorToken: "surfaceAlt" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surfaceAlt") }
 						}] }
 					}
 				},
@@ -18881,10 +19042,7 @@ var init_staticRecipes = __esmMin((() => {
 							role: "link"
 						},
 						borderRadius: "rounded-lg",
-						effects: { hover: [{
-							effectId: "lift",
-							options: { translateY: "-2px" }
-						}] }
+						effects: { hover: [{ effectId: "lift" }] }
 					}
 				},
 				accent: {
@@ -18896,10 +19054,7 @@ var init_staticRecipes = __esmMin((() => {
 						},
 						borderRadius: "rounded-lg",
 						affordance: { iconId: "ArrowRight" },
-						effects: { hover: [{
-							effectId: "lift",
-							options: { translateY: "-2px" }
-						}] }
+						effects: { hover: [{ effectId: "lift" }] }
 					}
 				}
 			}
@@ -18920,9 +19075,8 @@ var init_staticRecipes = __esmMin((() => {
 				shadow: "low",
 				textTransform: "uppercase",
 				fontWeight: 700,
-				borderWidth: 2,
 				hoverTransform: "lift",
-				hoverColor: "darken",
+				hoverColor: "none",
 				typography: "body",
 				paddingPreset: "spacious",
 				italic: false
@@ -18980,7 +19134,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border-2" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "background" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("background") }
 						}] }
 					}
 				},
@@ -18994,7 +19148,7 @@ var init_staticRecipes = __esmMin((() => {
 						borderRadius: "rounded-full",
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -19029,7 +19183,6 @@ var init_staticRecipes = __esmMin((() => {
 				typography: "heading",
 				fontWeight: 700,
 				fontSize: "text-lg",
-				borderWidth: 2,
 				hoverTransform: "none",
 				hoverColor: "none"
 			},
@@ -19064,7 +19217,7 @@ var init_staticRecipes = __esmMin((() => {
 							elevation: "high",
 							softness: "hard",
 							position: "bottom-right",
-							colorToken: "text"
+							colorToken: unsafeAsOpaqueButtonColourToken("text")
 						},
 						effects: { hover: [{ effectId: "press-down" }] }
 					}
@@ -19082,7 +19235,7 @@ var init_staticRecipes = __esmMin((() => {
 							elevation: "high",
 							softness: "hard",
 							position: "bottom-right",
-							colorToken: "secondary"
+							colorToken: unsafeAsOpaqueButtonColourToken("secondary")
 						},
 						effects: { hover: [{ effectId: "press-down" }] }
 					}
@@ -19145,7 +19298,6 @@ var init_staticRecipes = __esmMin((() => {
 				cornerStyle: "rounded",
 				textTransform: "uppercase",
 				fontWeight: 600,
-				borderWidth: 1,
 				hoverTransform: "none",
 				hoverColor: "none",
 				letterSpacing: "loose"
@@ -19181,7 +19333,7 @@ var init_staticRecipes = __esmMin((() => {
 						effects: {
 							hover: [{
 								effectId: "background-on-hover",
-								options: { colorToken: "primary-100" }
+								options: { colorToken: unsafeAsOpaqueButtonColourToken("primary-100") }
 							}],
 							active: [{
 								effectId: "scale-down",
@@ -19201,7 +19353,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "surface" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("surface") }
 						}] }
 					}
 				},
@@ -19216,7 +19368,7 @@ var init_staticRecipes = __esmMin((() => {
 						border: { widthClass: "border" },
 						effects: { hover: [{
 							effectId: "background-on-hover",
-							options: { colorToken: "muted" }
+							options: { colorToken: unsafeAsOpaqueButtonColourToken("muted") }
 						}] }
 					}
 				},
@@ -19233,7 +19385,6 @@ var init_staticRecipes = __esmMin((() => {
 							effectId: "border-bottom-grow",
 							options: {
 								height: 1,
-								colorToken: "accent",
 								origin: "left"
 							}
 						}] }
@@ -19634,7 +19785,7 @@ var init_testimonialQuotePresets = __esmMin((() => {
 * Gradient configuration types and schemas
 */
 var gradientStopSchema, radialGradientShapeSchema, gradientConfigSchema;
-var init_types$12 = __esmMin((() => {
+var init_types$11 = __esmMin((() => {
 	init_themeColorTokens();
 	gradientStopSchema = z$1.object({
 		color: themeColorTokenSchema,
@@ -19894,15 +20045,15 @@ var init_utils$4 = __esmMin((() => {}));
 //#endregion
 //#region ../theme-core/src/gradients/index.ts
 var init_gradients = __esmMin((() => {
-	init_types$12();
+	init_types$11();
 	init_presets$1();
 	init_utils$4();
 }));
 var init_customizableSurfaces = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 })), logoTextConfidenceValues, logoAssetShapeValues, logoKindValues, logoDensityValues, logoContainsTextSchema, logoAnalysisSourceSchema, brandDisplayModeValues, logoAccommodationPatternValues, logoSizePolicyValues;
 var init_logoBranding = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 	logoTextConfidenceValues = [
 		"low",
 		"medium",
@@ -20375,7 +20526,7 @@ var init_headerLooks = __esmMin((() => {
 	init_headerCtaVariants();
 	init_customizableSurfaces();
 	init_logoBranding();
-	init_types$16();
+	init_types$15();
 	titleOnlyLogoAccommodation = {
 		pattern: "title-only",
 		supportedShapes: [
@@ -21051,7 +21202,7 @@ function emphasizedFooterLinks(theme) {
 }
 var footerLookCatalog;
 var init_footerLooks = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 	footerLookCatalog = defineExactCatalog()([{
 		id: asFooterLookId("footer-links-quiet"),
 		label: "Quiet links",
@@ -21067,7 +21218,7 @@ var init_footerLooks = __esmMin((() => {
 }));
 var init_curatedChoices = __esmMin((() => {})), generatedContentFrames, userContentFrames, generatedDesignOptionCatalog, userDesignOptionCatalog;
 var init_sourceCatalogs = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 	generatedContentFrames = [
 		plainFrame,
 		panelFrame("inset"),
@@ -21652,6 +21803,713 @@ var init_media$2 = __esmMin((() => {
 	});
 }));
 //#endregion
+//#region ../theme-core/src/surfaces/foregroundRoles.ts
+var SURFACE_FOREGROUND_ROLES;
+var init_foregroundRoles = __esmMin((() => {
+	SURFACE_FOREGROUND_ROLES = [
+		"text",
+		"heading",
+		"link",
+		"supporting"
+	];
+}));
+//#endregion
+//#region ../theme-core/src/surfaces/foregroundContract.ts
+function requireSurfaceColorValue(role, value) {
+	const normalized = value.trim();
+	if (normalized.length === 0) throw new RangeError(`Surface foreground ${role} must be a non-empty CSS color.`);
+	return normalized;
+}
+function completeSurfaceForegrounds(input) {
+	const text = requireSurfaceColorValue("text", input.text);
+	return {
+		text,
+		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
+		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
+		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
+	};
+}
+function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FALLBACKS[role]) {
+	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
+	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
+	if (role === "text") return `var(${roleVariable}, ${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 surfaceForegroundStyle(input) {
+	const foregrounds = completeSurfaceForegrounds(input);
+	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.supporting]: foregrounds.supporting
+	};
+}
+function surfaceForegroundDeclarations(input) {
+	const foregrounds = completeSurfaceForegrounds(input);
+	return [`color: ${foregrounds.text}`, ...SURFACE_FOREGROUND_ROLES.map((role) => `${SURFACE_FOREGROUND_CSS_VARS[role]}: ${foregrounds[role]}`)];
+}
+var SURFACE_FOREGROUND_CSS_VARS, DEFAULT_SURFACE_TEXT_COLOR, DEFAULT_SURFACE_LINK_COLOR, DEFAULT_SURFACE_SUPPORTING_COLOR, DEFAULT_ROLE_FALLBACKS;
+var init_foregroundContract = __esmMin((() => {
+	init_foregroundRoles();
+	SURFACE_FOREGROUND_CSS_VARS = {
+		text: "--rb-surface-text-color",
+		heading: "--rb-surface-heading-color",
+		link: "--rb-surface-link-color",
+		supporting: "--rb-surface-supporting-color"
+	};
+	DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
+	DEFAULT_SURFACE_LINK_COLOR = "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))";
+	DEFAULT_SURFACE_SUPPORTING_COLOR = "rgb(var(--tb-mutedText, 100 116 139))";
+	DEFAULT_ROLE_FALLBACKS = {
+		text: DEFAULT_SURFACE_TEXT_COLOR,
+		heading: DEFAULT_SURFACE_TEXT_COLOR,
+		link: DEFAULT_SURFACE_LINK_COLOR,
+		supporting: DEFAULT_SURFACE_SUPPORTING_COLOR
+	};
+}));
+//#endregion
+//#region ../theme-core/src/buttons/constants.ts
+/**
+* Generate shadow CSS value dynamically based on elevation, softness, and position
+*
+* This replaces the static shadow maps with a single dynamic function.
+* Benefits: single source of truth, easy to adjust algorithm, no redundancy.
+*
+* @param elevation - Shadow elevation level
+* @param softness - Shadow softness/blur style
+* @param position - Shadow position (bottom or bottom-right diagonal)
+* @returns CSS box-shadow value
+*/
+function generateShadowValue$1(elevation, softness, position = "bottom", color) {
+	if (elevation === "none") return "none";
+	const config = {
+		low: {
+			blur: 4,
+			spread: 0
+		},
+		medium: {
+			blur: 8,
+			spread: -1
+		},
+		high: {
+			blur: 12,
+			spread: -2
+		}
+	}[elevation];
+	const baseOffset = ELEVATION_OFFSET[elevation];
+	const xOffset = position === "bottom-right" ? baseOffset : 0;
+	const yOffset = baseOffset;
+	switch (softness) {
+		case null:
+		case "soft": return `${xOffset}px ${yOffset}px ${config.blur}px ${config.spread}px ${color ?? "rgb(0 0 0 / 0.3)"}`;
+		case "hard": return `${xOffset}px ${yOffset}px 0 0 ${color ?? "rgb(0 0 0 / 1)"}`;
+		case "crisp": return `${xOffset}px ${yOffset}px ${baseOffset}px ${config.spread}px ${color ?? "rgb(0 0 0 / 0.4)"}`;
+	}
+}
+var GRADIENT_DIRECTION_MAP$2, BORDER_RADIUS_MAP, ELEVATION_OFFSET, BORDER_WIDTH_MAP$4, FONT_SIZE_MAP, DEFAULT_BUTTON_SIZES;
+var init_constants$2 = __esmMin((() => {
+	GRADIENT_DIRECTION_MAP$2 = {
+		"to-r": "to right",
+		"to-l": "to left",
+		"to-t": "to top",
+		"to-b": "to bottom",
+		"to-br": "to bottom right",
+		"to-bl": "to bottom left",
+		"to-tr": "to top right",
+		"to-tl": "to top left"
+	};
+	BORDER_RADIUS_MAP = {
+		"rounded-none": "0",
+		"rounded-sm": "0.125rem",
+		"rounded": "0.25rem",
+		"rounded-md": "0.375rem",
+		"rounded-lg": "0.5rem",
+		"rounded-xl": "0.75rem",
+		"rounded-2xl": "1rem",
+		"rounded-3xl": "1.5rem",
+		"rounded-full": "9999px"
+	};
+	ELEVATION_OFFSET = {
+		none: 0,
+		low: 2,
+		medium: 4,
+		high: 6
+	};
+	BORDER_WIDTH_MAP$4 = {
+		"border-0": "0px",
+		"border": "1px",
+		"border-2": "2px",
+		"border-4": "4px",
+		"border-8": "8px"
+	};
+	FONT_SIZE_MAP = {
+		"text-xs": "0.75rem",
+		"text-sm": "0.875rem",
+		"text-base": "1rem",
+		"text-lg": "1.125rem",
+		"text-xl": "1.25rem",
+		"text-2xl": "1.5rem"
+	};
+	DEFAULT_BUTTON_SIZES = {
+		sm: {
+			padding: "0.5rem 1rem",
+			fontSize: "text-sm"
+		},
+		md: { padding: "0.75rem 1.5rem" },
+		lg: {
+			padding: "1rem 2rem",
+			fontSize: "text-lg"
+		},
+		xl: {
+			padding: "1.25rem 2.5rem",
+			fontSize: "text-xl"
+		}
+	};
+}));
+//#endregion
+//#region ../theme-core/src/buttons/effectClassification.ts
+function validateButtonEffectOptions(effect) {
+	const parsed = buttonEffectApplicationSchema.safeParse(effect);
+	if (parsed.success) return { ok: true };
+	const firstIssue = parsed.error.issues[0];
+	const firstPathPart = firstIssue?.path[firstIssue.path.length - 1];
+	return {
+		ok: false,
+		option: (firstIssue?.code === "unrecognized_keys" ? firstIssue.keys[0] : void 0) ?? (typeof firstPathPart === "string" ? firstPathPart : "options")
+	};
+}
+function getButtonEffectPolicy(effectId) {
+	return Object.prototype.hasOwnProperty.call(BUTTON_EFFECT_POLICIES, effectId) ? BUTTON_EFFECT_POLICIES[effectId] : null;
+}
+var BUTTON_EFFECT_POLICIES;
+var init_effectClassification = __esmMin((() => {
+	init_types$12();
+	BUTTON_EFFECT_POLICIES = {
+		"darken-background": {
+			classification: "colour-transition",
+			transition: {
+				kind: "adjust-shade",
+				direction: "darker"
+			}
+		},
+		"lighten-background": {
+			classification: "colour-transition",
+			transition: {
+				kind: "adjust-shade",
+				direction: "lighter"
+			}
+		},
+		"background-on-hover": {
+			classification: "colour-transition",
+			transition: { kind: "replace-background" }
+		},
+		"background-on-hover-alpha": {
+			classification: "unsupported-colour",
+			reason: "alpha_requires_surface"
+		},
+		"fade-background": {
+			classification: "unsupported-colour",
+			reason: "changes_element_opacity"
+		},
+		"opacity-reduce": {
+			classification: "unsupported-colour",
+			reason: "changes_element_opacity"
+		},
+		"gradient-text": {
+			classification: "unsupported-colour",
+			reason: "changes_foreground"
+		},
+		"text-color-change": {
+			classification: "unsupported-colour",
+			reason: "changes_foreground"
+		},
+		"border-color-change": {
+			classification: "unsupported-colour",
+			reason: "changes_border"
+		},
+		"aurora-glow": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"cosmic-stardust": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"gradient-border-fill": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"animated-gradient-border-fill": {
+			classification: "unsupported-background-overlay",
+			reason: "unresolved_background_overlay"
+		},
+		"nav-underline": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-base": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-hover": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"nav-frosted-active": {
+			classification: "not-button",
+			reason: "not_button_effect"
+		},
+		"animated-gradient": { classification: "non-colour" },
+		"border-glow": {
+			classification: "unsupported-colour",
+			reason: "changes_shadow_colour"
+		},
+		"drop-shadow": { classification: "decorative-colour" },
+		"inner-shadow": { classification: "decorative-colour" },
+		"neumorphic-shadow": { classification: "decorative-colour" },
+		"outer-glow": {
+			classification: "unsupported-colour",
+			reason: "changes_shadow_colour"
+		},
+		"retro-3d-shadow": { classification: "decorative-colour" },
+		"scale-up": { classification: "non-colour" },
+		"scale-down": { classification: "non-colour" },
+		lift: { classification: "non-colour" },
+		"press-down": { classification: "non-colour" },
+		pop: { classification: "non-colour" },
+		"border-bottom-grow": { classification: "non-colour" },
+		"sketchy-border": { classification: "decorative-colour" },
+		"pulse-animation": {
+			classification: "unsupported-colour",
+			reason: "changes_element_opacity"
+		}
+	};
+}));
+//#endregion
+//#region ../theme-core/src/buttons/resolveButtonColourStates.ts
+function compileButtonColourStates(input) {
+	const baseTransition = applyColourEffects({
+		variantId: input.variant.id,
+		state: "base",
+		treatment: input.variant.background,
+		effects: input.variant.effects?.base,
+		palette: input.palette
+	});
+	if (!baseTransition.ok) return baseTransition;
+	const stateTreatments = {
+		base: baseTransition.treatment,
+		hover: hoverTreatment(input.variant, input.global, baseTransition.treatment),
+		focus: baseTransition.treatment,
+		active: baseTransition.treatment,
+		disabled: baseTransition.treatment
+	};
+	const nonColourEffects = { ...baseTransition.nonColourEffects.length > 0 ? { base: [...baseTransition.nonColourEffects] } : {} };
+	for (const state of [
+		"hover",
+		"focus",
+		"active"
+	]) {
+		const transition = applyColourEffects({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			effects: input.variant.effects?.[state],
+			palette: input.palette
+		});
+		if (!transition.ok) return transition;
+		stateTreatments[state] = transition.treatment;
+		if (transition.nonColourEffects.length > 0) nonColourEffects[state] = [...transition.nonColourEffects];
+	}
+	const resolved = {};
+	for (const state of BUTTON_VISUAL_STATES) {
+		const result = resolveTreatment$1({
+			variantId: input.variant.id,
+			state,
+			treatment: stateTreatments[state],
+			palette: input.palette
+		});
+		if (!result.ok) return result;
+		resolved[state] = result.colour;
+	}
+	return {
+		ok: true,
+		states: resolved,
+		focusIndicator: resolveFocusIndicator(resolved.focus),
+		nonColourEffects
+	};
+}
+function formatButtonColourContractError(error) {
+	switch (error.tag) {
+		case "unknown_palette_token": return `Button "${error.variantId}" ${error.state} state uses unknown palette token "${error.token}".`;
+		case "missing_on_colour": return `Button "${error.variantId}" ${error.state} state cannot derive ${error.foregroundToken} from ${error.backgroundToken}.`;
+		case "insufficient_contrast": return `Button "${error.variantId}" ${error.state} state has ${error.ratio.toFixed(2)}:1 contrast (${error.requiredRatio}:1 required).`;
+		case "unsupported_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" is not contrast-safe (${error.reason}).`;
+		case "invalid_colour_effect_options": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" has an invalid ${error.option} option.`;
+		case "inapplicable_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" cannot apply to a ${error.treatment} treatment.`;
+		case "unknown_button_effect": return `Button "${error.variantId}" ${error.state} uses unknown effect "${error.effectId}".`;
+	}
+}
+function hoverTreatment(variant, global, fallback) {
+	const token = variant.hoverBackgroundToken ?? (global.hoverColor === "token" ? global.hoverColorToken : void 0);
+	return token === void 0 ? fallback : {
+		type: "solid",
+		colorToken: token
+	};
+}
+function applyColourEffects(input) {
+	let treatment = input.treatment;
+	const nonColourEffects = [];
+	for (const effect of input.effects ?? []) {
+		const policy = getButtonEffectPolicy(effect.effectId);
+		if (policy === null) return unknownEffect(input, effect);
+		if (policy.classification === "unsupported-colour" || policy.classification === "unsupported-background-overlay" || policy.classification === "not-button") return unsupportedEffect(input, effect, policy.reason);
+		const options = validateButtonEffectOptions(effect);
+		if (!options.ok) return invalidEffectOption(input, effect, options.option);
+		switch (policy.classification) {
+			case "non-colour":
+			case "decorative-colour":
+				nonColourEffects.push(effect);
+				break;
+			case "colour-transition":
+				if (policy.transition.kind === "adjust-shade") {
+					if (effect.effectId !== "darken-background" && effect.effectId !== "lighten-background") return unknownEffect(input, effect);
+					if (treatment.type !== "solid") return inapplicableEffect(input, effect, treatment);
+					const amount = readShadeAmount(effect);
+					if (amount === null) return invalidEffectOption(input, effect, "amount");
+					const signedAmount = policy.transition.direction === "darker" ? amount : -amount;
+					treatment = {
+						type: "solid",
+						colorToken: adjustShade(treatment.colorToken, signedAmount, input.palette)
+					};
+					break;
+				}
+				if (policy.transition.kind === "replace-background") {
+					if (effect.effectId !== "background-on-hover") return unknownEffect(input, effect);
+					const colorToken = readOpaqueToken(effect);
+					if (colorToken === null) return invalidEffectOption(input, effect, "colorToken");
+					treatment = {
+						type: "solid",
+						colorToken
+					};
+					break;
+				}
+				return unknownEffect(input, effect);
+		}
+	}
+	return {
+		ok: true,
+		treatment,
+		nonColourEffects
+	};
+}
+function resolveTreatment$1(input) {
+	const treatment = input.treatment;
+	switch (treatment.type) {
+		case "surface": return {
+			ok: true,
+			colour: {
+				kind: "surface",
+				role: treatment.role,
+				backgroundCss: "transparent",
+				foregroundCss: surfaceForegroundValue(treatment.role)
+			}
+		};
+		case "solid": return resolveSolid(input, treatment.colorToken);
+		case "gradient": return resolveGradient$2(input, treatment);
+	}
+}
+function resolveFocusIndicator(colour) {
+	switch (colour.kind) {
+		case "solid": return {
+			kind: "two-tone",
+			innerCss: colour.foregroundCss,
+			outerCss: colour.backgroundCss,
+			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		};
+		case "gradient": return {
+			kind: "two-tone",
+			innerCss: colour.foregroundCss,
+			outerCss: tokenCss(colour.backgroundTokens[0]),
+			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		};
+		case "surface": return {
+			kind: "surface-role",
+			colorCss: colour.foregroundCss,
+			minimumSurfaceContrast: BUTTON_CONTRAST_POLICY.nonTextMinimumRatio
+		};
+	}
+}
+function resolveSolid(input, backgroundToken) {
+	const backgroundHex = paletteHex(input, backgroundToken);
+	if (!backgroundHex.ok) return backgroundHex;
+	const foregroundToken = unsafeAsOpaqueButtonColourToken(onColorTokenName(backgroundToken));
+	const foregroundHex = input.palette[foregroundToken];
+	if (typeof foregroundHex !== "string") return {
+		ok: false,
+		error: {
+			tag: "missing_on_colour",
+			variantId: input.variantId,
+			state: input.state,
+			backgroundToken,
+			foregroundToken
+		}
+	};
+	const contrast = validateContrast({
+		...input,
+		background: backgroundToken,
+		backgroundHex: backgroundHex.hex,
+		foreground: foregroundToken,
+		foregroundHex
+	});
+	if (!contrast.ok) return contrast;
+	return {
+		ok: true,
+		colour: {
+			kind: "solid",
+			backgroundToken,
+			foregroundToken,
+			backgroundCss: tokenCss(backgroundToken),
+			foregroundCss: tokenCss(foregroundToken)
+		}
+	};
+}
+function resolveGradient$2(input, treatment) {
+	const foregroundHex = paletteHex(input, treatment.foregroundToken);
+	if (!foregroundHex.ok) return foregroundHex;
+	const stopHexes = [];
+	for (const token of treatment.stops) {
+		const stop = paletteHex(input, token);
+		if (!stop.ok) return stop;
+		stopHexes.push(stop.hex);
+	}
+	for (let segment = 0; segment < stopHexes.length - 1; segment += 1) {
+		const start = stopHexes[segment];
+		const end = stopHexes[segment + 1];
+		const startToken = treatment.stops[segment];
+		const endToken = treatment.stops[segment + 1];
+		if (start === void 0 || end === void 0 || startToken === void 0 || endToken === void 0) continue;
+		for (let sample = 0; sample <= BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment; sample += 1) {
+			const position = sample / BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment;
+			const sampleHex = interpolateHex(start, end, position);
+			const contrast = validateContrast({
+				...input,
+				background: `${startToken}→${endToken}@${position.toFixed(2)}`,
+				backgroundHex: sampleHex,
+				foreground: treatment.foregroundToken,
+				foregroundHex: foregroundHex.hex
+			});
+			if (!contrast.ok) return contrast;
+		}
+	}
+	const direction = GRADIENT_DIRECTION_MAP$2[treatment.direction] ?? "to right";
+	return {
+		ok: true,
+		colour: {
+			kind: "gradient",
+			backgroundTokens: treatment.stops,
+			foregroundToken: treatment.foregroundToken,
+			backgroundCss: `linear-gradient(${direction}, ${treatment.stops.map(tokenCss).join(", ")})`,
+			foregroundCss: tokenCss(treatment.foregroundToken)
+		}
+	};
+}
+function paletteHex(input, token) {
+	const hex = input.palette[token];
+	return typeof hex === "string" ? {
+		ok: true,
+		hex
+	} : {
+		ok: false,
+		error: {
+			tag: "unknown_palette_token",
+			variantId: input.variantId,
+			state: input.state,
+			token
+		}
+	};
+}
+function validateContrast(input) {
+	const ratio = contrastRatio(input.backgroundHex, input.foregroundHex);
+	return ratio >= BUTTON_CONTRAST_POLICY.textMinimumRatio ? { ok: true } : {
+		ok: false,
+		error: {
+			tag: "insufficient_contrast",
+			variantId: input.variantId,
+			state: input.state,
+			background: input.background,
+			foreground: input.foreground,
+			ratio,
+			requiredRatio: BUTTON_CONTRAST_POLICY.textMinimumRatio
+		}
+	};
+}
+function tokenCss(token) {
+	return `rgb(var(--tb-${token}))`;
+}
+function adjustShade(token, amount, palette) {
+	const match = token.match(/^(.*)-(\d{2,3})$/);
+	const base = match?.[1] ?? token;
+	const currentShade = match?.[2] === void 0 ? 500 : Number(match[2]);
+	const availableShades = [
+		50,
+		100,
+		200,
+		300,
+		400,
+		500,
+		600,
+		700,
+		800,
+		900,
+		950
+	].filter((shade) => typeof palette[`${base}-${shade}`] === "string");
+	if (availableShades.length === 0) return token;
+	const firstShade = availableShades[0];
+	if (firstShade === void 0) return token;
+	const exactIndex = availableShades.indexOf(currentShade);
+	const startingIndex = exactIndex >= 0 ? exactIndex : availableShades.indexOf(availableShades.reduce((closestShade, shade) => Math.abs(shade - currentShade) < Math.abs(closestShade - currentShade) ? shade : closestShade, firstShade));
+	const stepCount = Math.abs(amount) / 100;
+	const direction = amount < 0 ? -1 : 1;
+	const targetShade = availableShades[Math.max(0, Math.min(availableShades.length - 1, startingIndex + direction * stepCount))];
+	return targetShade === void 0 ? token : unsafeAsOpaqueButtonColourToken(`${base}-${targetShade}`);
+}
+function readShadeAmount(effect) {
+	const value = effect.options?.amount ?? 100;
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 && value % 100 === 0 ? value : null;
+}
+function readOpaqueToken(effect) {
+	return parseOpaqueButtonColourToken(effect.options?.colorToken ?? "neutral-800");
+}
+function unsupportedEffect(input, effect, reason) {
+	return {
+		ok: false,
+		error: {
+			tag: "unsupported_colour_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			reason
+		}
+	};
+}
+function invalidEffectOption(input, effect, option) {
+	return {
+		ok: false,
+		error: {
+			tag: "invalid_colour_effect_options",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			option
+		}
+	};
+}
+function inapplicableEffect(input, effect, treatment) {
+	return {
+		ok: false,
+		error: {
+			tag: "inapplicable_colour_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId,
+			treatment: treatment.type
+		}
+	};
+}
+function unknownEffect(input, effect) {
+	return {
+		ok: false,
+		error: {
+			tag: "unknown_button_effect",
+			variantId: input.variantId,
+			state: input.state,
+			effectId: effect.effectId
+		}
+	};
+}
+function interpolateHex(startHex, endHex, position) {
+	const start = hexToRgb$1(startHex);
+	const end = hexToRgb$1(endHex);
+	const channel = (from, to) => Math.round(from + (to - from) * position).toString(16).padStart(2, "0");
+	return `#${channel(start.r, end.r)}${channel(start.g, end.g)}${channel(start.b, end.b)}`;
+}
+var BUTTON_VISUAL_STATES, BUTTON_CONTRAST_POLICY;
+var init_resolveButtonColourStates = __esmMin((() => {
+	init_contrast$1();
+	init_colorConversion();
+	init_onColor();
+	init_foregroundContract();
+	init_types$12();
+	init_constants$2();
+	init_effectClassification();
+	BUTTON_VISUAL_STATES = [
+		"base",
+		"hover",
+		"focus",
+		"active",
+		"disabled"
+	];
+	BUTTON_CONTRAST_POLICY = {
+		textMinimumRatio: 4.5,
+		nonTextMinimumRatio: 3,
+		gradientSamplesPerSegment: 20,
+		alphaBackgrounds: "reject-without-known-surface",
+		disabled: "retain-full-colour-contract"
+	};
+}));
+//#endregion
+//#region ../theme-core/src/buttons/parseThemeForPersistence.ts
+/**
+* Proves that every persisted button variant compiles against the theme's
+* concrete palette. Public rendering may still recover from malformed
+* external/runtime input, but persistence boundaries must reject it.
+*/
+function parseThemeForPersistence(value) {
+	const parsed = themeSchema.safeParse(value);
+	if (!parsed.success) return {
+		ok: false,
+		error: {
+			kind: "invalid-theme-schema",
+			issues: parsed.error.issues
+		}
+	};
+	const theme = parsed.data;
+	if (!theme.buttons) return {
+		ok: true,
+		value: theme
+	};
+	const palette = expandPalette(theme.palette);
+	for (const variant of theme.buttons.variants) {
+		const result = compileButtonColourStates({
+			variant,
+			global: theme.buttons.global,
+			palette
+		});
+		if (!result.ok) return {
+			ok: false,
+			error: {
+				kind: "invalid-button-colour-contract",
+				variantId: variant.id,
+				cause: result.error
+			}
+		};
+	}
+	return {
+		ok: true,
+		value: theme
+	};
+}
+var init_parseThemeForPersistence = __esmMin((() => {
+	init_schema();
+	init_expandPalette();
+	init_resolveButtonColourStates();
+}));
+//#endregion
 //#region ../theme-core/src/buttons/classNames.ts
 /**
 * Parse content/runtime variant identifiers into the closed theme-button class
@@ -21661,6 +22519,7 @@ var init_media$2 = __esmMin((() => {
 function parseThemeButtonVariantId(value) {
 	const normalized = value?.trim() ?? "";
 	if (normalized.length === 0) return null;
+	if (!buttonVariantIdSchema.safeParse(normalized).success) return null;
 	if (normalized === "default") return DEFAULT_VARIANT_ALIAS_ID;
 	return isVariantRole(normalized) ? normalized : asSpecialVariantId(normalized);
 }
@@ -21684,7 +22543,7 @@ function themeButtonClassName(spec) {
 	].filter(Boolean).join(" ");
 }
 var init_classNames = __esmMin((() => {
-	init_types$13();
+	init_types$12();
 }));
 //#endregion
 //#region ../theme-core/src/interactive/generateBaseCSS.ts
@@ -21755,9 +22614,21 @@ var init_background$2 = __esmMin((() => {
 		applicableTo: ["button"],
 		customizableOption: {
 			name: "amount",
-			type: "number",
+			type: "select",
 			label: "Darken Amount (shade step)",
-			default: 100
+			default: 100,
+			options: [
+				0,
+				100,
+				200,
+				300,
+				400,
+				500,
+				600,
+				700,
+				800,
+				900
+			]
 		},
 		isApplicable: (buttonConfig) => {
 			return buttonConfig.background.type === "solid";
@@ -21784,9 +22655,21 @@ var init_background$2 = __esmMin((() => {
 		applicableTo: ["button"],
 		customizableOption: {
 			name: "amount",
-			type: "number",
+			type: "select",
 			label: "Lighten Amount (shade step)",
-			default: 100
+			default: 100,
+			options: [
+				0,
+				100,
+				200,
+				300,
+				400,
+				500,
+				600,
+				700,
+				800,
+				900
+			]
 		},
 		isApplicable: (buttonConfig) => {
 			return buttonConfig.background.type === "solid";
@@ -21810,7 +22693,7 @@ var init_background$2 = __esmMin((() => {
 		description: "Reduces background opacity on hover",
 		category: "background",
 		pseudoElement: "none",
-		applicableTo: ["button", "nav-link"],
+		applicableTo: ["nav-link"],
 		customizableOption: {
 			name: "opacity",
 			type: "percentage",
@@ -21829,10 +22712,10 @@ var init_background$2 = __esmMin((() => {
 	opacityReduceEffect = {
 		id: "opacity-reduce",
 		name: "Reduce Opacity",
-		description: "Reduces button opacity on hover by a percentage",
+		description: "Reduces navigation-link opacity on hover by a percentage",
 		category: "background",
 		pseudoElement: "none",
-		applicableTo: ["button", "nav-link"],
+		applicableTo: ["nav-link"],
 		customizableOption: {
 			name: "reduction",
 			type: "percentage",
@@ -21920,7 +22803,7 @@ var init_background$2 = __esmMin((() => {
 		description: "Adds semi-transparent background on hover",
 		category: "background",
 		pseudoElement: "none",
-		applicableTo: ["button", "nav-link"],
+		applicableTo: ["nav-link"],
 		customizableOption: {
 			name: "opacity",
 			type: "percentage",
@@ -21994,7 +22877,7 @@ var init_shadow = __esmMin((() => {
 		description: "Adds a glowing shadow on hover",
 		category: "shadow",
 		pseudoElement: "none",
-		applicableTo: ["button", "nav-link"],
+		applicableTo: ["nav-link"],
 		customizableOption: {
 			name: "glowColorToken",
 			type: "colorToken",
@@ -22093,10 +22976,10 @@ var init_shadow = __esmMin((() => {
 	outerGlowEffect = {
 		id: "outer-glow",
 		name: "Outer Glow",
-		description: "Creates an outer glow around the button",
+		description: "Creates an outer glow around a navigation link",
 		category: "shadow",
 		pseudoElement: "none",
-		applicableTo: ["button", "nav-link"],
+		applicableTo: ["nav-link"],
 		customizableOption: {
 			name: "spread",
 			type: "number",
@@ -22152,105 +23035,6 @@ var init_shadow = __esmMin((() => {
 	};
 }));
 //#endregion
-//#region ../theme-core/src/buttons/constants.ts
-/**
-* Generate shadow CSS value dynamically based on elevation, softness, and position
-*
-* This replaces the static shadow maps with a single dynamic function.
-* Benefits: single source of truth, easy to adjust algorithm, no redundancy.
-*
-* @param elevation - Shadow elevation level
-* @param softness - Shadow softness/blur style
-* @param position - Shadow position (bottom or bottom-right diagonal)
-* @returns CSS box-shadow value
-*/
-function generateShadowValue$1(elevation, softness, position = "bottom", color) {
-	if (elevation === "none") return "none";
-	const config = {
-		low: {
-			blur: 4,
-			spread: 0
-		},
-		medium: {
-			blur: 8,
-			spread: -1
-		},
-		high: {
-			blur: 12,
-			spread: -2
-		}
-	}[elevation];
-	const baseOffset = ELEVATION_OFFSET[elevation];
-	const xOffset = position === "bottom-right" ? baseOffset : 0;
-	const yOffset = baseOffset;
-	switch (softness) {
-		case null:
-		case "soft": return `${xOffset}px ${yOffset}px ${config.blur}px ${config.spread}px ${color ?? "rgb(0 0 0 / 0.3)"}`;
-		case "hard": return `${xOffset}px ${yOffset}px 0 0 ${color ?? "rgb(0 0 0 / 1)"}`;
-		case "crisp": return `${xOffset}px ${yOffset}px ${baseOffset}px ${config.spread}px ${color ?? "rgb(0 0 0 / 0.4)"}`;
-	}
-}
-var GRADIENT_DIRECTION_MAP$2, BORDER_RADIUS_MAP, ELEVATION_OFFSET, BORDER_WIDTH_MAP$4, FONT_SIZE_MAP, DEFAULT_BUTTON_SIZES;
-var init_constants$2 = __esmMin((() => {
-	GRADIENT_DIRECTION_MAP$2 = {
-		"to-r": "to right",
-		"to-l": "to left",
-		"to-t": "to top",
-		"to-b": "to bottom",
-		"to-br": "to bottom right",
-		"to-bl": "to bottom left",
-		"to-tr": "to top right",
-		"to-tl": "to top left"
-	};
-	BORDER_RADIUS_MAP = {
-		"rounded-none": "0",
-		"rounded-sm": "0.125rem",
-		"rounded": "0.25rem",
-		"rounded-md": "0.375rem",
-		"rounded-lg": "0.5rem",
-		"rounded-xl": "0.75rem",
-		"rounded-2xl": "1rem",
-		"rounded-3xl": "1.5rem",
-		"rounded-full": "9999px"
-	};
-	ELEVATION_OFFSET = {
-		none: 0,
-		low: 2,
-		medium: 4,
-		high: 6
-	};
-	BORDER_WIDTH_MAP$4 = {
-		"border-0": "0px",
-		"border": "1px",
-		"border-2": "2px",
-		"border-4": "4px",
-		"border-8": "8px"
-	};
-	FONT_SIZE_MAP = {
-		"text-xs": "0.75rem",
-		"text-sm": "0.875rem",
-		"text-base": "1rem",
-		"text-lg": "1.125rem",
-		"text-xl": "1.25rem",
-		"text-2xl": "1.5rem"
-	};
-	DEFAULT_BUTTON_SIZES = {
-		sm: {
-			padding: "0.5rem 1rem",
-			fontSize: "text-sm"
-		},
-		md: { padding: "0.75rem 1.5rem" },
-		lg: {
-			padding: "1rem 2rem",
-			fontSize: "text-lg"
-		},
-		xl: {
-			padding: "1.25rem 2.5rem",
-			fontSize: "text-xl"
-		}
-	};
-}));
-//#endregion
 //#region ../theme-core/src/buttons/effects/presets/transform.ts
 var scaleUpEffect, scaleDownEffect, liftEffect, pressDownEffect, popEffect;
 var init_transform = __esmMin((() => {
@@ -22270,6 +23054,7 @@ var init_transform = __esmMin((() => {
 			default: "1.05",
 			options: [
 				"1.02",
+				"1.03",
 				"1.05",
 				"1.10"
 			]
@@ -22394,7 +23179,7 @@ var init_overlay = __esmMin((() => {
 		description: "Blurred gradient glow that appears on hover",
 		category: "overlay",
 		pseudoElement: "before",
-		applicableTo: ["button"],
+		applicableTo: [],
 		customizableOption: {
 			name: "intensity",
 			type: "percentage",
@@ -22452,7 +23237,7 @@ var init_overlay = __esmMin((() => {
 		description: "Rotating rainbow gradient glow (always visible, intensifies on hover)",
 		category: "overlay",
 		pseudoElement: "before",
-		applicableTo: ["button"],
+		applicableTo: [],
 		customizableOption: {
 			name: "speed",
 			type: "select",
@@ -22519,7 +23304,7 @@ var init_overlay = __esmMin((() => {
 		description: "Gradient border that fills on hover using ::before pseudo-element",
 		category: "overlay",
 		pseudoElement: "before",
-		applicableTo: ["button"],
+		applicableTo: [],
 		customizableOption: {
 			name: "borderWidth",
 			type: "number",
@@ -22568,7 +23353,7 @@ var init_overlay = __esmMin((() => {
 		description: "Rotating gradient border that fills on hover",
 		category: "overlay",
 		pseudoElement: "before",
-		applicableTo: ["button"],
+		applicableTo: [],
 		customizableOption: {
 			name: "speed",
 			type: "select",
@@ -22642,15 +23427,13 @@ var init_overlay = __esmMin((() => {
 		applicableTo: ["button", "nav-link"],
 		customizableOption: {
 			name: "height",
-			type: "number",
+			type: "select",
 			label: "Border Height (px)",
-			default: 1
+			default: 1,
+			options: [1, 2]
 		},
 		generateCSS: (ctx) => {
-			const { themeId, variantId, options, tokens } = ctx;
-			const height = options.height || 1;
-			const colorToken = options.colorToken || "neutral-400";
-			const origin = options.origin || "left";
+			const { themeId, variantId, options } = ctx;
 			return `
       /* Setup button for pseudo-element */
       :where([data-theme-scope="${themeId}"]) .${variantId} {
@@ -22664,10 +23447,10 @@ var init_overlay = __esmMin((() => {
         bottom: 0;
         left: 0;
         width: 100%;
-        height: ${height}px;
-        background: ${tokens.getColor(colorToken)};
+        height: ${options.height || 1}px;
+        background: currentColor;
         transform: scaleX(0);
-        transform-origin: ${origin};
+        transform-origin: ${options.origin || "left"};
         transition: transform 300ms ease-in-out;
       }
 
@@ -22689,7 +23472,7 @@ var init_text = __esmMin((() => {
 		description: "Gradient text using background-clip",
 		category: "text",
 		pseudoElement: "none",
-		applicableTo: ["button"],
+		applicableTo: [],
 		customizableOption: {
 			name: "solidOnHover",
 			type: "select",
@@ -22732,7 +23515,7 @@ var init_text = __esmMin((() => {
 		description: "Changes text color on hover",
 		category: "text",
 		pseudoElement: "none",
-		applicableTo: ["button", "nav-link"],
+		applicableTo: ["nav-link"],
 		customizableOption: {
 			name: "hoverColorToken",
 			type: "select",
@@ -22768,7 +23551,7 @@ var init_border = __esmMin((() => {
 		description: "Changes border color on hover",
 		category: "border",
 		pseudoElement: "none",
-		applicableTo: ["button", "nav-link"],
+		applicableTo: ["nav-link"],
 		customizableOption: {
 			name: "hoverColorToken",
 			type: "select",
@@ -22822,8 +23605,7 @@ var init_border = __esmMin((() => {
 				medium: "rotate(-1deg)",
 				strong: "rotate(-1.5deg)"
 			}[intensity]};
-        filter: contrast(0.95) brightness(1.02);
-        transition: transform 0.2s ease, filter 0.2s ease;
+        transition: transform 0.2s ease;
       }
 
       :where([data-theme-scope="${themeId}"]) .${variantId}:hover {
@@ -22832,7 +23614,6 @@ var init_border = __esmMin((() => {
 				medium: "rotate(1deg)",
 				strong: "rotate(1.5deg)"
 			}[intensity]} scale(1.02);
-        filter: contrast(1) brightness(1);
       }
 
       :where([data-theme-scope="${themeId}"]) .${variantId}:active {
@@ -22852,7 +23633,7 @@ var init_animation = __esmMin((() => {
 		description: "Continuous pulse animation (opacity fade)",
 		category: "animation",
 		pseudoElement: "none",
-		applicableTo: ["button", "nav-link"],
+		applicableTo: ["nav-link"],
 		customizableOption: {
 			name: "speed",
 			type: "select",
@@ -23048,6 +23829,7 @@ var init_registry$1 = __esmMin((() => {
 	init_border();
 	init_animation();
 	init_effects();
+	init_effectClassification();
 	EFFECT_PRESETS = [
 		darkenBackgroundEffect,
 		lightenBackgroundEffect,
@@ -23149,11 +23931,11 @@ function narrowCornerStyle(corners) {
 /**
 * Generate default button system from theme settings.
 *
-* Creates 4 sized variants when theme.buttons is not defined:
-* 1. Primary - primary color background with opacity-reduce hover effect
-* 2. Secondary - neutral-700 background with opacity-reduce hover effect
-* 3. Outline - transparent background with primary border and opacity-reduce hover effect
-* 4. Ghost - transparent background, no border, with opacity-reduce hover effect
+* Creates 4 sized canonical variants when theme.buttons is not defined:
+* 1. Primary - solid primary treatment
+* 2. Secondary - solid neutral treatment
+* 3. Outline - surface treatment with a border
+* 4. Ghost - surface treatment without a border
 *
 * All four are sized variants — they inherit padding/fontSize from the theme's
 * `sizes` config (or the system defaults) so they're consistent at any size.
@@ -23230,7 +24012,6 @@ function generateDefaultButtonSystem(theme) {
 			cornerStyle: narrowCornerStyle(theme.corners),
 			textTransform: "none",
 			fontWeight: 500,
-			borderWidth: theme.border.width === "none" ? 1 : theme.border.width === "thick" ? 3 : 2,
 			hoverTransform: "none",
 			hoverColor: "none"
 		},
@@ -23239,7 +24020,7 @@ function generateDefaultButtonSystem(theme) {
 }
 var BORDER_WIDTH_TO_CLASS_MAP, VALID_CORNER_STYLES;
 var init_generateDefaultButtonSystem = __esmMin((() => {
-	init_types$13();
+	init_types$12();
 	BORDER_WIDTH_TO_CLASS_MAP = {
 		none: "border-0",
 		hairline: "border",
@@ -23275,445 +24056,6 @@ var init_affordanceIcons = __esmMin((() => {
 	};
 }));
 //#endregion
-//#region ../theme-core/src/surfaces/foregroundRoles.ts
-var SURFACE_FOREGROUND_ROLES;
-var init_foregroundRoles = __esmMin((() => {
-	SURFACE_FOREGROUND_ROLES = [
-		"text",
-		"heading",
-		"link",
-		"supporting"
-	];
-}));
-//#endregion
-//#region ../theme-core/src/surfaces/foregroundContract.ts
-function requireSurfaceColorValue(role, value) {
-	const normalized = value.trim();
-	if (normalized.length === 0) throw new RangeError(`Surface foreground ${role} must be a non-empty CSS color.`);
-	return normalized;
-}
-function completeSurfaceForegrounds(input) {
-	const text = requireSurfaceColorValue("text", input.text);
-	return {
-		text,
-		heading: input.heading === void 0 ? text : requireSurfaceColorValue("heading", input.heading),
-		link: input.link === void 0 ? text : requireSurfaceColorValue("link", input.link),
-		supporting: input.supporting === void 0 ? text : requireSurfaceColorValue("supporting", input.supporting)
-	};
-}
-function surfaceForegroundValue(role, outsideProviderFallback = DEFAULT_ROLE_FALLBACKS[role]) {
-	const roleVariable = SURFACE_FOREGROUND_CSS_VARS[role];
-	const fallback = requireSurfaceColorValue("fallback", outsideProviderFallback);
-	if (role === "text") return `var(${roleVariable}, ${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 surfaceForegroundStyle(input) {
-	const foregrounds = completeSurfaceForegrounds(input);
-	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.supporting]: foregrounds.supporting
-	};
-}
-function surfaceForegroundDeclarations(input) {
-	const foregrounds = completeSurfaceForegrounds(input);
-	return [`color: ${foregrounds.text}`, ...SURFACE_FOREGROUND_ROLES.map((role) => `${SURFACE_FOREGROUND_CSS_VARS[role]}: ${foregrounds[role]}`)];
-}
-var SURFACE_FOREGROUND_CSS_VARS, DEFAULT_SURFACE_TEXT_COLOR, DEFAULT_SURFACE_LINK_COLOR, DEFAULT_SURFACE_SUPPORTING_COLOR, DEFAULT_ROLE_FALLBACKS;
-var init_foregroundContract = __esmMin((() => {
-	init_foregroundRoles();
-	SURFACE_FOREGROUND_CSS_VARS = {
-		text: "--rb-surface-text-color",
-		heading: "--rb-surface-heading-color",
-		link: "--rb-surface-link-color",
-		supporting: "--rb-surface-supporting-color"
-	};
-	DEFAULT_SURFACE_TEXT_COLOR = "rgb(var(--tb-text, 17 24 39))";
-	DEFAULT_SURFACE_LINK_COLOR = "rgb(var(--tb-primary, var(--tb-text, 17 24 39)))";
-	DEFAULT_SURFACE_SUPPORTING_COLOR = "rgb(var(--tb-mutedText, 100 116 139))";
-	DEFAULT_ROLE_FALLBACKS = {
-		text: DEFAULT_SURFACE_TEXT_COLOR,
-		heading: DEFAULT_SURFACE_TEXT_COLOR,
-		link: DEFAULT_SURFACE_LINK_COLOR,
-		supporting: DEFAULT_SURFACE_SUPPORTING_COLOR
-	};
-}));
-//#endregion
-//#region ../theme-core/src/buttons/resolveButtonColourStates.ts
-function compileButtonColourStates(input) {
-	const baseTransition = applyColourEffects({
-		variantId: input.variant.id,
-		state: "base",
-		treatment: input.variant.background,
-		effects: input.variant.effects?.base,
-		palette: input.palette
-	});
-	if (!baseTransition.ok) return baseTransition;
-	const stateTreatments = {
-		base: baseTransition.treatment,
-		hover: hoverTreatment(input.variant, input.global, baseTransition.treatment),
-		focus: baseTransition.treatment,
-		active: baseTransition.treatment,
-		disabled: baseTransition.treatment
-	};
-	const nonColourEffects = { ...baseTransition.nonColourEffects.length > 0 ? { base: [...baseTransition.nonColourEffects] } : {} };
-	for (const state of [
-		"hover",
-		"focus",
-		"active"
-	]) {
-		const transition = applyColourEffects({
-			variantId: input.variant.id,
-			state,
-			treatment: stateTreatments[state],
-			effects: input.variant.effects?.[state],
-			palette: input.palette
-		});
-		if (!transition.ok) return transition;
-		stateTreatments[state] = transition.treatment;
-		if (transition.nonColourEffects.length > 0) nonColourEffects[state] = [...transition.nonColourEffects];
-	}
-	const resolved = {};
-	for (const state of BUTTON_VISUAL_STATES) {
-		const result = resolveTreatment$1({
-			variantId: input.variant.id,
-			state,
-			treatment: stateTreatments[state],
-			palette: input.palette
-		});
-		if (!result.ok) return result;
-		resolved[state] = result.colour;
-	}
-	return {
-		ok: true,
-		states: resolved,
-		focusIndicator: resolveFocusIndicator(resolved.focus),
-		nonColourEffects
-	};
-}
-function formatButtonColourContractError(error) {
-	switch (error.tag) {
-		case "unknown_palette_token": return `Button "${error.variantId}" ${error.state} state uses unknown palette token "${error.token}".`;
-		case "missing_on_colour": return `Button "${error.variantId}" ${error.state} state cannot derive ${error.foregroundToken} from ${error.backgroundToken}.`;
-		case "insufficient_contrast": return `Button "${error.variantId}" ${error.state} state has ${error.ratio.toFixed(2)}:1 contrast (${error.requiredRatio}:1 required).`;
-		case "unsupported_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" is not contrast-safe (${error.reason}).`;
-		case "invalid_colour_effect_options": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" has an invalid ${error.option} option.`;
-		case "inapplicable_colour_effect": return `Button "${error.variantId}" ${error.state} effect "${error.effectId}" cannot apply to a ${error.treatment} treatment.`;
-		case "unknown_button_effect": return `Button "${error.variantId}" ${error.state} uses unknown effect "${error.effectId}".`;
-	}
-}
-function hoverTreatment(variant, global, fallback) {
-	const token = variant.hoverBackgroundToken ?? (global.hoverColor === "token" ? global.hoverColorToken : void 0);
-	return token === void 0 ? fallback : {
-		type: "solid",
-		colorToken: token
-	};
-}
-function applyColourEffects(input) {
-	let treatment = input.treatment;
-	const nonColourEffects = [];
-	for (const effect of input.effects ?? []) {
-		const policy = getButtonEffectPolicy(effect.effectId);
-		if (policy === null) return unknownEffect(input, effect);
-		switch (policy.classification) {
-			case "non-colour":
-				nonColourEffects.push(effect);
-				break;
-			case "unsupported-colour":
-			case "unsupported-background-overlay":
-			case "not-button": return unsupportedEffect(input, effect, policy.reason);
-			case "colour-transition":
-				if (policy.transition.kind === "adjust-shade") {
-					if (treatment.type !== "solid") return inapplicableEffect(input, effect, treatment);
-					const amount = readShadeAmount(effect);
-					if (amount === null) return invalidEffectOption(input, effect, "amount");
-					const signedAmount = policy.transition.direction === "darker" ? amount : -amount;
-					treatment = {
-						type: "solid",
-						colorToken: adjustShade(treatment.colorToken, signedAmount, input.palette)
-					};
-					break;
-				}
-				if (policy.transition.kind === "replace-background") {
-					const colorToken = readOpaqueToken(effect, "colorToken", "neutral-800");
-					if (colorToken === null) return invalidEffectOption(input, effect, "colorToken");
-					treatment = {
-						type: "solid",
-						colorToken
-					};
-					break;
-				}
-				return unknownEffect(input, effect);
-		}
-	}
-	return {
-		ok: true,
-		treatment,
-		nonColourEffects
-	};
-}
-function resolveTreatment$1(input) {
-	const treatment = input.treatment;
-	switch (treatment.type) {
-		case "surface": return {
-			ok: true,
-			colour: {
-				kind: "surface",
-				role: treatment.role,
-				backgroundCss: "transparent",
-				foregroundCss: surfaceForegroundValue(treatment.role)
-			}
-		};
-		case "solid": return resolveSolid(input, treatment.colorToken);
-		case "gradient": return resolveGradient$2(input, treatment);
-	}
-}
-function resolveFocusIndicator(colour) {
-	switch (colour.kind) {
-		case "solid": return {
-			kind: "two-tone",
-			innerCss: colour.foregroundCss,
-			outerCss: colour.backgroundCss,
-			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
-		};
-		case "gradient": return {
-			kind: "two-tone",
-			innerCss: colour.foregroundCss,
-			outerCss: tokenCss(colour.backgroundTokens[0]),
-			minimumPairContrast: BUTTON_CONTRAST_POLICY.textMinimumRatio
-		};
-		case "surface": return {
-			kind: "surface-role",
-			colorCss: colour.foregroundCss,
-			minimumSurfaceContrast: BUTTON_CONTRAST_POLICY.nonTextMinimumRatio
-		};
-	}
-}
-function resolveSolid(input, backgroundToken) {
-	const backgroundHex = paletteHex(input, backgroundToken);
-	if (!backgroundHex.ok) return backgroundHex;
-	const foregroundToken = unsafeAsOpaqueButtonColourToken(onColorTokenName(backgroundToken));
-	const foregroundHex = input.palette[foregroundToken];
-	if (typeof foregroundHex !== "string") return {
-		ok: false,
-		error: {
-			tag: "missing_on_colour",
-			variantId: input.variantId,
-			state: input.state,
-			backgroundToken,
-			foregroundToken
-		}
-	};
-	const contrast = validateContrast({
-		...input,
-		background: backgroundToken,
-		backgroundHex: backgroundHex.hex,
-		foreground: foregroundToken,
-		foregroundHex
-	});
-	if (!contrast.ok) return contrast;
-	return {
-		ok: true,
-		colour: {
-			kind: "solid",
-			backgroundToken,
-			foregroundToken,
-			backgroundCss: tokenCss(backgroundToken),
-			foregroundCss: tokenCss(foregroundToken)
-		}
-	};
-}
-function resolveGradient$2(input, treatment) {
-	const foregroundHex = paletteHex(input, treatment.foregroundToken);
-	if (!foregroundHex.ok) return foregroundHex;
-	const stopHexes = [];
-	for (const token of treatment.stops) {
-		const stop = paletteHex(input, token);
-		if (!stop.ok) return stop;
-		stopHexes.push(stop.hex);
-	}
-	for (let segment = 0; segment < stopHexes.length - 1; segment += 1) {
-		const start = stopHexes[segment];
-		const end = stopHexes[segment + 1];
-		const startToken = treatment.stops[segment];
-		const endToken = treatment.stops[segment + 1];
-		if (start === void 0 || end === void 0 || startToken === void 0 || endToken === void 0) continue;
-		for (let sample = 0; sample <= BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment; sample += 1) {
-			const position = sample / BUTTON_CONTRAST_POLICY.gradientSamplesPerSegment;
-			const sampleHex = interpolateHex(start, end, position);
-			const contrast = validateContrast({
-				...input,
-				background: `${startToken}→${endToken}@${position.toFixed(2)}`,
-				backgroundHex: sampleHex,
-				foreground: treatment.foregroundToken,
-				foregroundHex: foregroundHex.hex
-			});
-			if (!contrast.ok) return contrast;
-		}
-	}
-	const direction = GRADIENT_DIRECTION_MAP$2[treatment.direction] ?? "to right";
-	return {
-		ok: true,
-		colour: {
-			kind: "gradient",
-			backgroundTokens: treatment.stops,
-			foregroundToken: treatment.foregroundToken,
-			backgroundCss: `linear-gradient(${direction}, ${treatment.stops.map(tokenCss).join(", ")})`,
-			foregroundCss: tokenCss(treatment.foregroundToken)
-		}
-	};
-}
-function paletteHex(input, token) {
-	const hex = input.palette[token];
-	return typeof hex === "string" ? {
-		ok: true,
-		hex
-	} : {
-		ok: false,
-		error: {
-			tag: "unknown_palette_token",
-			variantId: input.variantId,
-			state: input.state,
-			token
-		}
-	};
-}
-function validateContrast(input) {
-	const ratio = contrastRatio(input.backgroundHex, input.foregroundHex);
-	return ratio >= BUTTON_CONTRAST_POLICY.textMinimumRatio ? { ok: true } : {
-		ok: false,
-		error: {
-			tag: "insufficient_contrast",
-			variantId: input.variantId,
-			state: input.state,
-			background: input.background,
-			foreground: input.foreground,
-			ratio,
-			requiredRatio: BUTTON_CONTRAST_POLICY.textMinimumRatio
-		}
-	};
-}
-function tokenCss(token) {
-	return `rgb(var(--tb-${token}))`;
-}
-function adjustShade(token, amount, palette) {
-	const match = token.match(/^(.*)-(\d{2,3})$/);
-	const base = match?.[1] ?? token;
-	const currentShade = match?.[2] === void 0 ? 500 : Number(match[2]);
-	const availableShades = [
-		50,
-		100,
-		200,
-		300,
-		400,
-		500,
-		600,
-		700,
-		800,
-		900,
-		950
-	].filter((shade) => typeof palette[`${base}-${shade}`] === "string");
-	if (availableShades.length === 0) return token;
-	const firstShade = availableShades[0];
-	if (firstShade === void 0) return token;
-	const exactIndex = availableShades.indexOf(currentShade);
-	const startingIndex = exactIndex >= 0 ? exactIndex : availableShades.indexOf(availableShades.reduce((closestShade, shade) => Math.abs(shade - currentShade) < Math.abs(closestShade - currentShade) ? shade : closestShade, firstShade));
-	const stepCount = Math.abs(amount) / 100;
-	const direction = amount < 0 ? -1 : 1;
-	const targetShade = availableShades[Math.max(0, Math.min(availableShades.length - 1, startingIndex + direction * stepCount))];
-	return targetShade === void 0 ? token : unsafeAsOpaqueButtonColourToken(`${base}-${targetShade}`);
-}
-function readShadeAmount(effect) {
-	const value = effect.options?.amount ?? 100;
-	return typeof value === "number" && Number.isFinite(value) && value >= 0 && value % 100 === 0 ? value : null;
-}
-function readOpaqueToken(effect, key, fallback) {
-	return parseOpaqueButtonColourToken(effect.options?.[key] ?? fallback);
-}
-function unsupportedEffect(input, effect, reason) {
-	return {
-		ok: false,
-		error: {
-			tag: "unsupported_colour_effect",
-			variantId: input.variantId,
-			state: input.state,
-			effectId: effect.effectId,
-			reason
-		}
-	};
-}
-function invalidEffectOption(input, effect, option) {
-	return {
-		ok: false,
-		error: {
-			tag: "invalid_colour_effect_options",
-			variantId: input.variantId,
-			state: input.state,
-			effectId: effect.effectId,
-			option
-		}
-	};
-}
-function inapplicableEffect(input, effect, treatment) {
-	return {
-		ok: false,
-		error: {
-			tag: "inapplicable_colour_effect",
-			variantId: input.variantId,
-			state: input.state,
-			effectId: effect.effectId,
-			treatment: treatment.type
-		}
-	};
-}
-function unknownEffect(input, effect) {
-	return {
-		ok: false,
-		error: {
-			tag: "unknown_button_effect",
-			variantId: input.variantId,
-			state: input.state,
-			effectId: effect.effectId
-		}
-	};
-}
-function interpolateHex(startHex, endHex, position) {
-	const start = hexToRgb$1(startHex);
-	const end = hexToRgb$1(endHex);
-	const channel = (from, to) => Math.round(from + (to - from) * position).toString(16).padStart(2, "0");
-	return `#${channel(start.r, end.r)}${channel(start.g, end.g)}${channel(start.b, end.b)}`;
-}
-var BUTTON_VISUAL_STATES, BUTTON_CONTRAST_POLICY;
-var init_resolveButtonColourStates = __esmMin((() => {
-	init_contrast$1();
-	init_colorConversion();
-	init_onColor();
-	init_foregroundContract();
-	init_types$13();
-	init_constants$2();
-	init_effectClassification();
-	BUTTON_VISUAL_STATES = [
-		"base",
-		"hover",
-		"focus",
-		"active",
-		"disabled"
-	];
-	BUTTON_CONTRAST_POLICY = {
-		textMinimumRatio: 4.5,
-		nonTextMinimumRatio: 3,
-		gradientSamplesPerSegment: 20,
-		alphaBackgrounds: "reject-without-known-surface",
-		disabled: "retain-full-colour-contract"
-	};
-}));
-//#endregion
 //#region ../theme-core/src/buttons/resolvedButtonCss.ts
 /**
 * Canonical colour declaration mapping shared by full themes and ThemeBridge.
@@ -23922,8 +24264,8 @@ function variantChunks(variant, global, themeSizes, themeId, tokens, theme, colo
 * Only variants that declare `affordance` with a known icon id produce a rule —
 * every other variant is byte-identical to before. The `:not(.rb-affordance-off)`
 * guard lets a `button` node that renders its own trailing icon suppress this
-* one (node overrides personality). Colour comes from the affordance token, or
-* `currentColor` (the button text colour) when no token is given.
+* one. The mask uses `currentColor`, so the icon always shares the canonical
+* button foreground.
 */
 function variantAffordanceRule(variant, selector) {
 	const affordance = variant.affordance;
@@ -24083,7 +24425,7 @@ function resolveBoxShadow(variant, global, theme, tokens) {
 }
 var AFFORDANCE_SUPPRESS_CLASS, BUTTON_SIZE_NAMES, LETTER_SPACING_MAP, STRUCTURAL_DECLARATIONS;
 var init_generateButtonCss = __esmMin((() => {
-	init_types$13();
+	init_types$12();
 	init_classNames();
 	init_resolver$1();
 	init_generateBaseCSS();
@@ -24140,17 +24482,10 @@ var init_presets = __esmMin((() => {
 	});
 }));
 //#endregion
-//#region ../theme-core/src/buttons/effects/types.ts
-var init_types$11 = __esmMin((() => {}));
-var init_core$2 = __esmMin((() => {
-	init_resolveButtonColourStates();
-	init_resolvedButtonCss();
-	init_types$13();
-}));
-//#endregion
 //#region ../theme-core/src/buttons/index.ts
 var init_buttons = __esmMin((() => {
-	init_types$13();
+	init_types$12();
+	init_parseThemeForPersistence();
 	init_classNames();
 	init_generateButtonCss();
 	init_resolveButtonColourStates();
@@ -24159,10 +24494,6 @@ var init_buttons = __esmMin((() => {
 	init_constants$2();
 	init_presets();
 	init_styles();
-	init_types$11();
-	init_registry$1();
-	init_transform();
-	init_core$2();
 }));
 //#endregion
 //#region ../theme-core/src/cards/types.ts
@@ -24311,9 +24642,9 @@ function generateShadowValue(shadow) {
 		case "high": return soft ? `${xOffset}px 25px 50px rgba(0,0,0,.18)` : `${xOffset}px 20px 30px rgba(0,0,0,.28)`;
 	}
 }
-var CORNER_RADIUS_MAP$2, GRADIENT_DIRECTION_MAP$1;
+var CORNER_RADIUS_MAP$3, GRADIENT_DIRECTION_MAP$1;
 var init_constants$1 = __esmMin((() => {
-	CORNER_RADIUS_MAP$2 = {
+	CORNER_RADIUS_MAP$3 = {
 		square: "0px",
 		soft: "8px",
 		rounded: "16px",
@@ -24403,7 +24734,7 @@ var init_surfaces = __esmMin((() => {
 //#endregion
 //#region ../theme-core/src/cards/generateCardCss.ts
 function resolveCornerRadiiCss$1(cornerRadii, fallback) {
-	const fallbackValue = CORNER_RADIUS_MAP$2[fallback];
+	const fallbackValue = CORNER_RADIUS_MAP$3[fallback];
 	const at = (value) => value ? PER_CORNER_RADIUS_MAP$1[value] : fallbackValue;
 	return `${at(cornerRadii.topLeft)} ${at(cornerRadii.topRight)} ${at(cornerRadii.bottomRight)} ${at(cornerRadii.bottomLeft)}`;
 }
@@ -24461,7 +24792,7 @@ function generateVariantCSS(variant, themeId, tokens, theme) {
 		rules.push(`border: ${borderWidth} solid ${borderColor}`);
 	}
 	const corners = variant.corners ?? theme.corners;
-	const radius = variant.cornerRadii ? resolveCornerRadiiCss$1(variant.cornerRadii, corners) : CORNER_RADIUS_MAP$2[corners];
+	const radius = variant.cornerRadii ? resolveCornerRadiiCss$1(variant.cornerRadii, corners) : CORNER_RADIUS_MAP$3[corners];
 	rules.push(`border-radius: ${radius}`);
 	const shadow = variant.shadow ?? theme.shadow;
 	if (shadow.elevation !== "none") {
@@ -25485,12 +25816,12 @@ var init_schema = __esmMin((() => {
 	init_cards();
 	init_types$9();
 	init_types$8();
-	init_types$12();
+	init_types$11();
 	init_types$7();
 	init_validation$2();
 	init_atRuleValidation();
 	init_shared$5();
-	init_types$16();
+	init_types$15();
 	init_logoBranding();
 	init_rawStyleFields();
 	init_themeColorTokens();
@@ -26348,7 +26679,7 @@ function uniqueNonEmpty$1(values) {
 var designResolutionPolicySchema, runtimeStyleFieldNameSchema, nonEmptyRuntimeStyleFieldNamesSchema, heroLegibilityStrategySchema, heroCompositionIntentSchema, heroTypographyScaleIntentSchema, sectionHeightIntentSchema, imageSurfaceTreatmentIntensitySchema, imageSurfaceMotionSchema, imageSurfaceTreatmentSchema, testimonialCardTreatmentSchema, tileTreatmentSchema, eventListTreatmentSchema, eyebrowTreatmentSchema, userPanelTreatments, userFlushTreatments, userFlushBleeds, contentFrameIntentSchema, blockDesignPlanSchema, styleAuthoritySchema, blockRuntimeStyleAuthoritySchema;
 var init_designState = __esmMin((() => {
 	init_sourceCatalogs();
-	init_types$16();
+	init_types$15();
 	init_schemaVersionedJson();
 	init_rawStyleFields();
 	designResolutionPolicySchema = z$1.enum([
@@ -26527,7 +26858,7 @@ var init_runtimeCompiler = __esmMin((() => {
 	init_styles();
 	init_colors();
 	init_designState();
-	init_types$16();
+	init_types$15();
 	init_accessibleSurfaces();
 	init_sectionTransitions();
 	init_tokens();
@@ -26946,7 +27277,7 @@ var init_curatedSiteStyles = __esmMin((() => {
 	init_footerLooks();
 	init_curatedChoices();
 	init_sourceCatalogs();
-	init_types$16();
+	init_types$15();
 	init_siteStyleTypography();
 	init_runtimeCompiler();
 	SOFT_EARTH_SITE_STYLE_ID_VALUE = "site-style:soft-earth";
@@ -28360,13 +28691,13 @@ var init_curatedSiteStyles = __esmMin((() => {
 	curatedSiteStylesById = new Map(curatedSiteStyles.map((style) => [style.id, style]));
 })), init_lookResolution = __esmMin((() => {
 	init_appearancePresets();
-	init_types$16();
+	init_types$15();
 }));
 var init_siteStyleBlockPolicies = __esmMin((() => {
 	init_lookResolution();
 	init_appearancePresets();
 	init_pageDesignIntent();
-	init_types$16();
+	init_types$15();
 	init_sectionTransitions();
 	asPageFlowPresetId("generated-default");
 	asSiteStyleId("site-style:south-west-twerk-school");
@@ -28379,12 +28710,12 @@ var init_siteStyleBlockPolicies = __esmMin((() => {
 	init_lookResolution();
 	init_siteStyleBlockPolicies();
 	init_pageDesignIntent();
-	init_types$16();
+	init_types$15();
 	init_sectionTransitions();
 	asPageFlowPresetId("flow:quiet"), noneBoundaryOption.id, asPageFlowPresetId("flow:balanced"), softBoundaryOption.id, asPageFlowPresetId("flow:expressive"), spaciousBoundaryOption.id;
 }));
 var init_resolver = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 }));
 var init_siteStyleThemeCompiler = __esmMin((() => {
 	init_schema();
@@ -28394,7 +28725,7 @@ var init_siteStyleThemeCompiler = __esmMin((() => {
 	init_resolveSelection();
 }));
 var init_previewCustomization = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 }));
 var init_previewCompiler = __esmMin((() => {
 	init_schema();
@@ -28404,7 +28735,7 @@ var init_previewCompiler = __esmMin((() => {
 	init_resolveSelection();
 	init_curatedSiteStyles();
 	init_resolver();
-	init_types$16();
+	init_types$15();
 	init_footerLooks();
 	init_headerLooks();
 	init_runtimeCompiler();
@@ -28443,7 +28774,7 @@ var generatedPanelTreatments, generatedFlushTreatments, generatedFlushBleeds, ge
 var init_generatedSchemas = __esmMin((() => {
 	init_curatedSiteStyles();
 	init_sourceCatalogs();
-	init_types$16();
+	init_types$15();
 	generatedPanelTreatments = uniqueNonEmpty(generatedDesignOptionCatalog.contentFrames.filter((frame) => frame.kind === "panel").map((frame) => frame.treatment));
 	generatedFlushTreatments = uniqueNonEmpty(generatedDesignOptionCatalog.contentFrames.filter((frame) => frame.kind === "flush-panel").map((frame) => frame.treatment));
 	generatedFlushBleeds = uniqueNonEmpty(generatedDesignOptionCatalog.contentFrames.filter((frame) => frame.kind === "flush-panel").map((frame) => frame.bleed));
@@ -28510,7 +28841,7 @@ var init_generatedDesignPipeline = __esmMin((() => {
 	init_headerOpeningSection();
 	init_resolver();
 	init_runtimeCompiler();
-	init_types$16();
+	init_types$15();
 }));
 function validateBlockSequence(snapshots, ctx) {
 	for (const issue of collectBlockSequenceIssues(snapshots)) ctx.addIssue(issue);
@@ -28545,7 +28876,7 @@ function collectBlockSequenceIssues(snapshots) {
 }
 var nonEmptyStringSchema, blockContentVersionIdSchema, designBlockIdSchema, designPageIdSchema, designEntryIdSchema, blockOrderIndexSchema, publishedPageBlockSnapshotSchema, draftPageBlockSnapshotSchema, missingPageBlockSnapshotSchema, pageBlockSnapshotSchema, publishedPageBlockSequenceSchema, draftPageBlockSequenceSchema, publishedPageDesignVersionDataV1Schema, draftPageDesignVersionDataV1Schema;
 var init_pageDesignAuthority = __esmMin((() => {
-	init_types$16();
+	init_types$15();
 	init_pageDesignIntent();
 	nonEmptyStringSchema = z$1.string().min(1);
 	blockContentVersionIdSchema = nonEmptyStringSchema.transform(asBlockContentVersionId);
@@ -28841,7 +29172,7 @@ var init_site_styles = __esmMin((() => {
 	init_tokenRecipes();
 	init_siteStyleTypography();
 	init_themeParity();
-	init_types$16();
+	init_types$15();
 }));
 //#endregion
 //#region ../blocks/src/system/designCapabilities.ts
@@ -32562,45 +32893,6 @@ var init_formEmbed = __esmMin((() => {
 	});
 }));
 //#endregion
-//#region ../blocks/src/system/fragments/library/footerBottomText.ts
-var footerBottomTextFragment;
-var init_footerBottomText = __esmMin((() => {
-	init_types$5();
-	init_builder$1();
-	init_colorStyles();
-	footerBottomTextFragment = defineFragment({
-		id: "footerBottomText",
-		title: "Footer Text",
-		description: "Rich text content for the main footer body and optional bottom bar.",
-		fields: [{
-			id: "bodyText",
-			type: "richText",
-			label: "Body text",
-			description: "Appears in the main footer area.",
-			ui: { variant: "limited" }
-		}, {
-			id: "bottomText",
-			type: "richText",
-			label: "Bottom bar text",
-			description: "Appears in the optional footer bottom bar.",
-			ui: { variant: "limited" }
-		}],
-		layout: [richText({
-			className: "rb-prose rb-prose-sm rb-mx-auto rb-max-w-3xl rb-text-center",
-			style: textColorStyle("text/80")
-		}, when("bodyText"), bind("bodyText", { transforms: [{
-			id: "content.interpolateRichTextTokens",
-			options: { tokens: ["year", "site_name"] }
-		}] })), richText({
-			className: "rb-prose rb-prose-sm rb-mx-auto rb-max-w-3xl rb-text-center",
-			style: textColorStyle("text/80")
-		}, when("bottomText"), bind("bottomText", { transforms: [{
-			id: "content.interpolateRichTextTokens",
-			options: { tokens: ["year", "site_name"] }
-		}] }))]
-	});
-}));
-//#endregion
 //#region ../blocks/src/system/fragments/library/headerCta.ts
 var headerCtaFragment;
 var init_headerCta = __esmMin((() => {
@@ -33114,7 +33406,6 @@ var init_lazyInit = __esmMin((() => {
 	init_testimonialsCarousel();
 	init_formCopy();
 	init_formEmbed();
-	init_footerBottomText();
 	init_headerCta();
 	init_singleButton();
 	init_blogFeaturedPost();
@@ -33134,7 +33425,6 @@ var init_lazyInit = __esmMin((() => {
 		testimonialsCarouselFragment,
 		formCopyFragment,
 		formEmbedFragment,
-		footerBottomTextFragment,
 		headerCtaFragment,
 		singleButtonFragment,
 		blogFeaturedPostFragment,
@@ -33951,7 +34241,6 @@ function ensureFragmentsRegistered() {
 	registerFragment(formCopyFragment);
 	registerFragment(formEmbedFragment);
 	registerFragment(bookingFormFragment);
-	registerFragment(footerBottomTextFragment);
 	registerFragment(headerCtaFragment);
 	registerFragment(singleButtonFragment);
 	registerFragment(blogFeaturedPostFragment);
@@ -33981,7 +34270,6 @@ var init_init = __esmMin((() => {
 	init_formCopy();
 	init_formEmbed();
 	init_bookingForm$1();
-	init_footerBottomText();
 	init_headerCta();
 	init_singleButton();
 	init_blogFeaturedPost();
@@ -34274,7 +34562,6 @@ var init_fragments = __esmMin((() => {
 	init_formCopy();
 	init_formEmbed();
 	init_bookingForm$1();
-	init_footerBottomText();
 	init_headerCta();
 	init_singleButton();
 	init_blogFeaturedPost();
@@ -35514,14 +35801,14 @@ function defineClientOwnedBlockRuntime(runtime) {
 var init_runtime = __esmMin((() => {}));
 //#endregion
 //#region ../blocks/src/contracts/islands.ts
-function isObjectRecord$1(value) {
+function isObjectRecord(value) {
 	return typeof value === "object" && value !== null;
 }
 function pickRecordKeys(source, keys) {
 	return Object.fromEntries(keys.map((key) => [key, source[key]]));
 }
 function expectEncodedRecord(value, label) {
-	if (isObjectRecord$1(value)) return value;
+	if (isObjectRecord(value)) return value;
 	throw new Error(`Expected ${label} codec to encode an object`);
 }
 function prefixIssues(prefix, issues) {
@@ -35562,7 +35849,7 @@ function createInteractiveIslandCodec(options) {
 			};
 		},
 		decode: (input) => {
-			if (!isObjectRecord$1(input)) return decodeFailure([{
+			if (!isObjectRecord(input)) return decodeFailure([{
 				path: [],
 				message: "Expected island props object"
 			}]);
@@ -35573,7 +35860,7 @@ function createInteractiveIslandCodec(options) {
 				message: `Expected renderKind "${options.runtime.kind}"`
 			});
 			const renderInput = input.render;
-			if (!isObjectRecord$1(renderInput)) renderIssues.push({
+			if (!isObjectRecord(renderInput)) renderIssues.push({
 				path: ["render"],
 				message: "Expected render object"
 			});
@@ -36802,7 +37089,7 @@ const uiTransforms = [
 ];
 //#endregion
 //#region ../theme-core/src/siteChromePlacement.ts
-init_types$16();
+init_types$15();
 const SITE_CHROME_PLACEMENT_CLASSES = [
 	"rb-sticky",
 	"rb-fixed",
@@ -37444,25 +37731,6 @@ const mediaTransforms = [{
 	}
 }];
 //#endregion
-//#region ../blocks/src/lib/typeGuards.ts
-/**
-* Strict record guard: excludes null, primitives, and arrays.
-*/
-function isRecord$24(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
-* Non-null object guard: includes arrays for behavior parity with legacy helpers.
-*
-* NOTE: This intentionally narrows to UnknownRecord for compatibility with existing
-* callsites even though arrays pass at runtime. Follow-up cleanup should replace
-* this API with a more precise predicate type and migrate consumers.
-*/
-function isObjectRecord(value) {
-	return typeof value === "object" && value !== null;
-}
-var init_typeGuards = __esmMin((() => {}));
-//#endregion
 //#region ../blocks/src/system/transforms/registry/content.ts
 init_typeGuards();
 const supportedRichTextTokenSchema = z$1.enum(["year", "site_name"]);
@@ -37470,16 +37738,16 @@ const interpolateRichTextTokensOptionsSchema = z$1.object({ tokens: z$1.array(su
 const richTextTokenPattern = /\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g;
 function getSiteName(context) {
 	const viewModel = context.viewModel;
-	if (!isRecord$24(viewModel)) return null;
+	if (!isRecord$25(viewModel)) return null;
 	const site = viewModel.site;
-	if (isRecord$24(site) && typeof site.title === "string") {
+	if (isRecord$25(site) && typeof site.title === "string") {
 		const title = site.title.trim();
 		return title.length > 0 ? title : null;
 	}
 	const root = viewModel.$root;
-	if (isRecord$24(root)) {
+	if (isRecord$25(root)) {
 		const rootSite = root.site;
-		if (isRecord$24(rootSite) && typeof rootSite.title === "string") {
+		if (isRecord$25(rootSite) && typeof rootSite.title === "string") {
 			const title = rootSite.title.trim();
 			if (title.length > 0) return title;
 		}
@@ -37501,7 +37769,7 @@ function replaceTokenText(input, allowedTokens, tokenValues) {
 	});
 }
 function visitRichTextNode(node, allowedTokens, tokenValues) {
-	if (!isRecord$24(node)) return node;
+	if (!isRecord$25(node)) return node;
 	let changed = false;
 	const nextNode = { ...node };
 	if (nextNode.type === "text" && typeof nextNode.text === "string") {
@@ -37522,21 +37790,11 @@ function visitRichTextNode(node, allowedTokens, tokenValues) {
 	return changed ? nextNode : node;
 }
 function interpolateRichTextTokens(value, options, context) {
-	if (!isRecord$24(value)) return value;
-	const allowedTokens = new Set(options.tokens);
-	const tokenValues = {
+	if (!isRecord$25(value)) return value;
+	return visitRichTextNode(value, new Set(options.tokens), {
 		year: String((/* @__PURE__ */ new Date()).getFullYear()),
 		site_name: getSiteName(context)
-	};
-	if (isRecord$24(value.doc)) {
-		const nextDoc = visitRichTextNode(value.doc, allowedTokens, tokenValues);
-		if (nextDoc === value.doc) return value;
-		return {
-			...value,
-			doc: nextDoc
-		};
-	}
-	return visitRichTextNode(value, allowedTokens, tokenValues);
+	});
 }
 const contentTransforms = [{
 	id: "content.interpolateRichTextTokens",
@@ -40055,124 +40313,6 @@ var init_media$1 = __esmMin((() => {
 		archiveMediaSchema
 	]);
 }));
-/**
-* Permissive unwrap for a value known to be the root of a rich-text field.
-*
-* Producers should emit the canonical unwrapped form `{ type: 'doc', content: [...] }`,
-* but two legacy shapes still appear in older data and pre-Phase-1 fixtures:
-*
-*   - `{ doc: <typed-doc> }` — pre-migration DB storage.
-*   - `{ doc: <typed-doc>, html, plain }` — pre-Phase-1 dummy-content output.
-*
-* This helper is the single right place to tolerate either shape at a known
-* rich-text root (transforms, coercion, validators that operate on rich text).
-* The strictness sits on the inner node's `type === 'doc'`, which prevents
-* misidentifying random objects that happen to carry a field named `doc`.
-*
-* Returns the inner doc node when the input matches a legacy shape, otherwise
-* returns the input unchanged.
-*
-* For deep structural traversal where any nested key might be named `doc`
-* (and unwrapping would be incorrect), use the strict `isDocWrapper` private
-* helper inside `@riverbankcms/blocks/bindings`.
-*/
-function unwrapRichTextRoot(value) {
-	if (!isRecord$24(value)) return value;
-	if (!("doc" in value)) return value;
-	const inner = value.doc;
-	if (isRecord$24(inner) && inner.type === "doc") return inner;
-	return value;
-}
-function createHardBreakNode() {
-	return { type: "hardBreak" };
-}
-/**
-* Parse a small markdown subset into TipTap inline nodes.
-*
-* This intentionally supports only bold (`**text**`) because the SDK/content
-* import paths use it for lightweight default content, not full markdown.
-*/
-function parseRichTextInlineMarkdown(text) {
-	const out = [];
-	const pushText = (value, marks) => {
-		if (!value) return;
-		out.push(marks && marks.length > 0 ? {
-			type: "text",
-			text: value,
-			marks
-		} : {
-			type: "text",
-			text: value
-		});
-	};
-	let rest = text;
-	while (rest.length > 0) {
-		const start = rest.indexOf("**");
-		if (start === -1) {
-			pushText(rest);
-			break;
-		}
-		const end = rest.indexOf("**", start + 2);
-		if (end === -1) {
-			pushText(rest);
-			break;
-		}
-		pushText(rest.slice(0, start));
-		pushText(rest.slice(start + 2, end), [{ type: "bold" }]);
-		rest = rest.slice(end + 2);
-	}
-	return out;
-}
-function parseRichTextParagraphInlineMarkdown(text) {
-	return text.split("\n").flatMap((line, index) => {
-		const lineNodes = parseRichTextInlineMarkdown(line.trim());
-		return index === 0 ? lineNodes : [createHardBreakNode(), ...lineNodes];
-	});
-}
-/**
-* Convert a plain string with a tiny markdown subset to canonical TipTap JSON.
-*
-* Double newlines create semantic paragraphs. Single newlines remain inside the
-* current paragraph as TipTap `hardBreak` nodes for line-oriented content such
-* as addresses, opening hours, and contact details.
-*/
-function createRichTextDocFromMarkdown(markdown) {
-	const normalized = markdown.replace(/\r\n/g, "\n").trim();
-	if (!normalized) return {
-		type: "doc",
-		content: []
-	};
-	return {
-		type: "doc",
-		content: normalized.split(/\n{2,}/).map((paragraph) => paragraph.trim()).filter(Boolean).map((paragraph) => {
-			const inline = parseRichTextParagraphInlineMarkdown(paragraph);
-			return inline.length > 0 ? {
-				type: "paragraph",
-				content: inline
-			} : { type: "paragraph" };
-		})
-	};
-}
-var TipTapMarkSchema, TipTapNodeSchema, RichTextDocSchema;
-var init_richTextSchema = __esmMin((() => {
-	init_typeGuards();
-	TipTapMarkSchema = z$1.object({
-		type: z$1.string(),
-		attrs: z$1.record(z$1.string(), z$1.unknown()).optional()
-	});
-	TipTapNodeSchema = z$1.lazy(() => z$1.object({
-		type: z$1.string(),
-		content: z$1.array(TipTapNodeSchema).optional(),
-		text: z$1.string().optional(),
-		attrs: z$1.record(z$1.string(), z$1.unknown()).optional(),
-		marks: z$1.array(TipTapMarkSchema).optional()
-	}));
-	z$1.union([TipTapNodeSchema, z$1.object({ doc: TipTapNodeSchema })]);
-	RichTextDocSchema = z$1.object({
-		type: z$1.literal("doc"),
-		content: z$1.array(TipTapNodeSchema)
-	});
-}));
 //#endregion
 //#region ../blocks/src/system/blocks/shared/bookingPaymentTerms.ts
 var bookingDepositRefundPolicySchema, bookingInstalmentPlanSchema, bookingFlexibleBalanceDueDateRuleSchema, bookingFlexibleBalanceConfigSchema, blockBookingPaymentCollectionOptionSchema, blockBookingPaymentTermsSchema;
@@ -55083,42 +55223,54 @@ function normalize(value) {
 	return trimmed.length > 0 ? trimmed : null;
 }
 /**
-* Resolve the trailing affordance a button should render. Node overrides
-* personality; returns `null` when nothing is configured.
+* Resolve the node-authored trailing affordance, or `null` when no icon exists.
 */
 function resolveButtonAffordance(input) {
 	const nodeIcon = normalize(input.trailingIcon);
-	if (nodeIcon) {
-		const colorToken = normalize(input.trailingIconColorToken);
-		return {
-			iconId: nodeIcon,
-			source: "node",
-			...colorToken ? { colorToken } : {}
-		};
-	}
-	const personality = input.personalityAffordance;
-	const personalityIcon = normalize(personality?.iconId);
-	if (personality && personalityIcon) {
-		const colorToken = normalize(personality.colorToken);
-		return {
-			iconId: personalityIcon,
-			source: "personality",
-			...colorToken ? { colorToken } : {}
-		};
-	}
+	if (nodeIcon) return { iconId: nodeIcon };
 	return null;
 }
 //#endregion
+//#region ../logger/src/noop.ts
+var noop, logger;
+var init_noop = __esmMin((() => {
+	noop = () => {};
+	logger = {
+		debug: noop,
+		info: noop,
+		warn: noop,
+		error: noop,
+		withFields: (_) => logger
+	};
+}));
+//#endregion
 //#region ../blocks/src/system/runtime/nodes/richText-coerce.ts
-function coerceRichTextDoc(value) {
-	const raw = unwrapRichTextRoot(value);
-	if (typeof raw === "string") return createRichTextDocFromMarkdown(raw);
-	if (isRecord$24(raw) && typeof raw.type === "string") return raw;
+function parseRichTextDoc(value) {
+	const parsed = RichTextDocSchema.safeParse(value);
+	if (parsed.success) return {
+		kind: "valid",
+		doc: parsed.data
+	};
+	return {
+		kind: "invalid",
+		issues: parsed.error.issues.map((issue) => ({
+			path: issue.path.map((segment) => String(segment)),
+			message: issue.message
+		}))
+	};
+}
+function coerceRichTextDoc(value, source) {
+	const parsed = parseRichTextDoc(value);
+	if (parsed.kind === "valid") return parsed.doc;
+	if (value !== null && value !== void 0) logger.warn("blocks:rich-text:invalid-document", {
+		source,
+		issues: parsed.issues.slice(0, 3)
+	});
 	return null;
 }
 var init_richText_coerce = __esmMin((() => {
+	init_noop();
 	init_richTextSchema();
-	init_typeGuards();
 }));
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/renderInlineText.tsx
@@ -55170,13 +55322,12 @@ function readStringPath(source, path) {
 }
 const RichTextNode = ({ value, blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, ...rest }) => {
 	return /* @__PURE__ */ jsx(RichText$1, {
-		doc: coerceRichTextDoc(value) ?? void 0,
+		doc: coerceRichTextDoc(value, `block-runtime:${_blockKind ?? "unknown"}:${rest.path ?? "richText"}`) ?? void 0,
 		...rest
 	});
 };
 /**
-* Render the resolved trailing affordance icon. Colour is applied via a theme
-* CSS var so it recolours with the palette; the icon stroke uses `currentColor`.
+* Render the resolved trailing affordance icon using the button's foreground.
 */
 function renderTrailingAffordanceIcon(affordance) {
 	if (!affordance) return null;
@@ -55184,21 +55335,16 @@ function renderTrailingAffordanceIcon(affordance) {
 	if (!Icon) return null;
 	return /* @__PURE__ */ jsx(Icon, {
 		"aria-hidden": true,
-		className: "rb-ml-2 rb-h-4 rb-w-4 rb-inline-block",
-		style: affordance.colorToken ? { color: `rgb(var(--tb-${affordance.colorToken}))` } : void 0
+		className: "rb-ml-2 rb-h-4 rb-w-4 rb-inline-block"
 	});
 }
-const ButtonNode = ({ value, children, href, variantId = "primary", size = "md", disabled, type = "button", target, rel, linkRequired = false, trailingIcon, trailingIconColorToken, personalityAffordance, blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, className, ...rest }) => {
+const ButtonNode = ({ value, children, href, variantId = "primary", size = "md", disabled, type = "button", target, rel, linkRequired = false, trailingIcon, blockId: _blockId, blockKind: _blockKind, blockContent: _blockContent, fragmentRegistry: _fragmentRegistry, pathBase: _pathBase, className, ...rest }) => {
 	const content = value ?? children;
 	if (!content) {
 		console.warn("[ButtonNode] No content to render - value and children are both empty");
 		return null;
 	}
-	const affordanceIcon = renderTrailingAffordanceIcon(resolveButtonAffordance({
-		trailingIcon,
-		trailingIconColorToken,
-		personalityAffordance
-	}));
+	const affordanceIcon = renderTrailingAffordanceIcon(resolveButtonAffordance({ trailingIcon }));
 	const resolvedHref = typeof href === "string" ? href.trim() : "";
 	if (linkRequired && resolvedHref.length === 0) {
 		console.warn("[ButtonNode] Missing href for link-required button");
@@ -55864,9 +56010,9 @@ const AccordionItemNodeSSR = ({ className, value, trigger, content, question, an
 };
 function resolveNode$1(value) {
 	if (typeof value === "string" || typeof value === "number") return String(value);
-	const doc = coerceRichTextDoc(value);
+	const doc = coerceRichTextDoc(value, "block-runtime:accordion:item-content");
 	if (doc) return /* @__PURE__ */ jsx(RichText$1, { doc });
-	return value;
+	return React.isValidElement(value) ? value : null;
 }
 //#endregion
 //#region ../blocks/src/system/runtime/nodes/header-section.server.tsx
@@ -56611,19 +56757,6 @@ var init_booking_form_state = __esmMin((() => {
 	init_src$3();
 	init_booking_form_reserved_fields();
 }));
-//#endregion
-//#region ../logger/src/noop.ts
-var noop, logger;
-var init_noop = __esmMin((() => {
-	noop = () => {};
-	logger = {
-		debug: noop,
-		info: noop,
-		warn: noop,
-		error: noop,
-		withFields: (_) => logger
-	};
-}));
 var bookingFieldOptionSchema, bookingFieldSchema, bookingSettingsSchema, bookingSourceFormSchema;
 var init_booking_runtime_sources = __esmMin((() => {
 	init_noop();
@@ -57608,7 +57741,7 @@ function CourseDetailsView(props) {
 	const sortedSessions = [...course.sessions ?? []].sort((a, b) => Date.parse(a.startsAt) - Date.parse(b.startsAt));
 	const visibleSessions = sessionLimit === "all" ? sortedSessions : sortedSessions.slice(0, sessionLimit);
 	const hasMoreSessions = sessionLimit !== "all" && sortedSessions.length > sessionLimit;
-	const descriptionDoc = showDescription ? coerceRichTextDoc(course.description) : null;
+	const descriptionDoc = showDescription ? coerceRichTextDoc(course.description, "block-runtime:course-details:description") : null;
 	const teamMembers = course.teamMembers ?? [];
 	return /* @__PURE__ */ jsxs("div", {
 		className: "rb-flex rb-flex-col rb-gap-6",
@@ -59294,7 +59427,7 @@ function ProductDetailServerContent(props) {
 		actions: props.render.display.state === "ready" ? renderServerPendingAction(props.render.display.actionLabel, props.render.display.soldOut) : null,
 		body: props.render.display.state === "ready" && props.render.display.body ? /* @__PURE__ */ jsx("div", {
 			className: "rb-prose rb-max-w-none",
-			children: /* @__PURE__ */ jsx(RichText$1, { doc: coerceRichTextDoc(props.render.display.body) })
+			children: /* @__PURE__ */ jsx(RichText$1, { doc: coerceRichTextDoc(props.render.display.body, "block-runtime:product-detail:body") })
 		}) : null
 	});
 }
@@ -61003,8 +61136,8 @@ function extractAlignmentClassName(className) {
 //#region ../blocks/src/system/runtime/resolver.ts
 init_src$3();
 init_node();
-init_richTextSchema();
 init_headingDecoration();
+init_richText_coerce();
 /**
 * Maps meta binding paths to their actual store keys.
 * The metadata store uses 'draft' prefixed keys (e.g., draftTitle, draftSlug)
@@ -61328,13 +61461,9 @@ function isTextConditionValueEmpty(value) {
 	return !value;
 }
 function isRichTextConditionValueEmpty(value) {
-	const root = unwrapRichTextRoot(value);
-	if (typeof root === "string") return root.trim().length === 0;
-	if (!isTipTapNode(root)) return root === null || root === void 0 || !root;
-	return richTextStructuralPresence(root).kind === "empty";
-}
-function isTipTapNode(value) {
-	return isPlainObject$2(value) && typeof value.type === "string";
+	const doc = coerceRichTextDoc(value, "block-runtime:condition:richText");
+	if (!doc) return true;
+	return richTextStructuralPresence(doc).kind === "empty";
 }
 function richTextStructuralPresence(node) {
 	if (typeof node.text === "string" && node.text.trim().length > 0) return {
@@ -66088,7 +66217,7 @@ function hydrateValue(value, context) {
 			const resolvedItems = value.map((item) => hydrateValue(item, context));
 			return resolvedItems.every((item, index) => item === value[index]) ? value : resolvedItems;
 		}
-		if (isRecord$24(value)) {
+		if (isRecord$25(value)) {
 			if (isInternalLink$1(value)) return hydrateInternalLink(value, context.routes);
 			if (isPageLink$1(value)) return hydratePageLink(value, context);
 			if (isEntryLink$1(value)) return hydrateEntryLink(value, context);
@@ -66428,8 +66557,8 @@ function boundaryReserveValueForTreatment(boundary) {
 	return boundary.metrics.reserveCss;
 }
 function transitionCssVarsStyle(content) {
-	const transitionStyles = isObjectRecord(content._transitionStyles) ? content._transitionStyles : null;
-	const cssVars = isObjectRecord(transitionStyles?.cssVars) ? transitionStyles.cssVars : null;
+	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;
@@ -66749,7 +66878,7 @@ function shouldDebugCustomBlocks() {
 function resolveBlockData({ block, definition, dataContext }) {
 	const blockId = block.id ?? null;
 	const raw = blockId ? dataContext?.resolvedData?.[blockId] : void 0;
-	if (isObjectRecord(raw)) return { ...raw };
+	if (isObjectRecord$1(raw)) return { ...raw };
 	return definition.dataLoaders && Object.keys(definition.dataLoaders).length > 0 ? {} : void 0;
 }
 /**
@@ -66760,7 +66889,7 @@ function resolveBlockData({ block, definition, dataContext }) {
 */
 function getRenderableContent(block, previewStage = "published") {
 	const source = previewStage === "preview" && block.draftContent ? block.draftContent : block.content ?? {};
-	if (!isObjectRecord(source)) return {};
+	if (!isObjectRecord$1(source)) return {};
 	return source;
 }
 function summarizeValue(value) {
@@ -66775,11 +66904,8 @@ function summarizeValue(value) {
 			const preview = {};
 			for (const k of keys.slice(0, 8)) {
 				const v = rec[k];
-				if (k === "body" || k === "content") {
-					const isDocWrapper = !!(v && typeof v === "object" && isObjectRecord(v) && "doc" in v);
-					const isDoc = !!(v && typeof v === "object" && isObjectRecord(v) && v.type === "doc");
-					preview[k] = isDocWrapper ? "{doc}" : isDoc ? "{type:doc}" : summarizeValue(v);
-				} else preview[k] = summarizeValue(v);
+				if (k === "body" || k === "content") preview[k] = !!(v && typeof v === "object" && isObjectRecord$1(v) && v.type === "doc") ? "{type:doc}" : summarizeValue(v);
+				else preview[k] = summarizeValue(v);
 			}
 			return {
 				keys,
@@ -66796,16 +66922,6 @@ function summarizeValue(value) {
 //#region ../blocks/src/subroutes/fold.ts
 init_src$3();
 //#endregion
-//#region ../theme-core/src/styles/gradients.ts
-init_paletteAccess();
-init_colorConversion();
-//#endregion
-//#region ../theme-core/src/styles/glow.ts
-init_palette$1();
-//#endregion
-//#region ../theme-core/src/styles/buttons.ts
-init_colorStyles();
-//#endregion
 //#region ../blocks/src/structure/schema.ts
 const BlockKind = z.string();
 const blockSchema = z.object({
@@ -66824,8 +66940,9 @@ z.object({
 	blocks: z.array(blockSchema).min(1)
 });
 //#endregion
-//#region ../theme-core/src/recommend/generateThemes.ts
-init_expandPalette();
+//#region ../theme-core/src/styles/gradients.ts
+init_paletteAccess();
+init_colorConversion();
 //#endregion
 //#region ../theme-core/src/generated/containerResponsiveThemeCss.ts
 /**
@@ -79881,6 +79998,11 @@ function ResponsiveScope({ children, responsiveMode = DEFAULT_THEME_RESPONSIVE_M
 	});
 }
 //#endregion
+//#region ../theme-core/src/buttons/core.ts
+init_resolveButtonColourStates();
+init_resolvedButtonCss();
+init_types$12();
+//#endregion
 //#region ../theme-core/src/runtime/buildThemeRuntimeFromBridge.ts
 /**
 * Build Theme Runtime from ThemeBridge Config
@@ -79892,7 +80014,6 @@ function ResponsiveScope({ children, responsiveMode = DEFAULT_THEME_RESPONSIVE_M
 init_colorConversion();
 init_textColor();
 init_onColor();
-init_core$2();
 init_core$1();
 z$1.object({
 	tokens: z$1.record(z$1.string(), z$1.string()),
@@ -79937,7 +80058,7 @@ z$1.object({
 }).passthrough();
 //#endregion
 //#region ../theme-core/src/siteChrome.tsx
-init_types$16();
+init_types$15();
 //#endregion
 //#region ../blocks/src/system/runtime/bindings.ts
 init_node();
@@ -80068,10 +80189,10 @@ function normalizeDataLoaders(def) {
 */
 function normalizeContent(block) {
 	const source = block.draftContent ?? block.content ?? block.publishedContent ?? {};
-	if (!isObjectRecord(source)) return {};
+	if (!isObjectRecord$1(source)) return {};
 	if ("data" in source) {
 		const data = source.data;
-		if (isObjectRecord(data)) return data;
+		if (isObjectRecord$1(data)) return data;
 		if (data === null || data === void 0) return {};
 	}
 	return source;
@@ -80264,7 +80385,7 @@ function stableNormalize(value) {
 //#region ../blocks/src/system/data/normalizeLoaderParams.ts
 init_typeGuards();
 function toStringParams(value) {
-	if (!isObjectRecord(value)) return {};
+	if (!isObjectRecord$1(value)) return {};
 	const out = {};
 	for (const [k, v] of Object.entries(value)) if (typeof v === "string") out[k] = v;
 	return out;
@@ -81098,6 +81219,7 @@ const CANONICAL_REFUND_PLANNER_ERROR_CODES = [
 		"idempotency_amount_mismatch",
 		"idempotency_method_mismatch",
 		"idempotency_receipt_mismatch",
+		"idempotency_scope_mismatch",
 		"refund_in_progress"
 	],
 	"invalid_amount",
@@ -81477,6 +81599,7 @@ BOOKING_QUESTION_ANSWER_EXPORT_SCOPES.site, BOOKING_QUESTION_ANSWER_EXPORT_SCOPE
 init_src$3();
 //#endregion
 //#region ../api/src/siteBanner.ts
+init_richTextSchema();
 const SITE_BANNER_SCOPE_VALUES = ["homepage", "all-pages"];
 const SITE_BANNER_TONE_VALUES = [
 	"announcement",
@@ -81486,7 +81609,7 @@ const SITE_BANNER_TONE_VALUES = [
 ];
 const siteBannerScopeSchema = z$1.enum(SITE_BANNER_SCOPE_VALUES);
 const siteBannerToneSchema = z$1.enum(SITE_BANNER_TONE_VALUES);
-const siteBannerBodySchema = z$1.unknown().transform(unwrapRichTextValue);
+const siteBannerBodySchema = RichTextDocSchema;
 const siteBannerCtaSchema = z$1.object({
 	label: z$1.string().trim().min(1),
 	link: linkPayloadSchema
@@ -81514,7 +81637,8 @@ const EMPTY_SITE_BANNER_BODY = {
 	}]
 };
 function analyzeSiteBannerBody(body) {
-	const sanitizedBody = sanitizeSiteBannerBodyInternal(body, { limitParagraphs: false });
+	const parsed = RichTextDocSchema.safeParse(body);
+	const sanitizedBody = parsed.success ? sanitizeSiteBannerBodyInternal(parsed.data, { limitParagraphs: false }) : EMPTY_SITE_BANNER_BODY;
 	const paragraphs = collectParagraphs(sanitizedBody);
 	const textLength = paragraphs.reduce((total, paragraph) => total + paragraphTextLength(paragraph), 0);
 	const issues = [];
@@ -81536,7 +81660,7 @@ function siteBannerBodyIssueMessage(issue) {
 	}
 }
 function sanitizeSiteBannerBodyInternal(input, options) {
-	const content = normalizeTopLevelNodes(unwrapRichTextValue(input).content ?? [], options);
+	const content = normalizeTopLevelNodes(input.content, options);
 	return {
 		type: "doc",
 		content: content.length > 0 ? content : EMPTY_SITE_BANNER_BODY.content
@@ -81617,28 +81741,6 @@ function sanitizeMarks(marks) {
 	});
 	return sanitized.length > 0 ? sanitized : void 0;
 }
-function unwrapRichTextValue(value) {
-	if (isRecord$5(value) && isRecord$5(value.doc)) return unwrapRichTextValue(value.doc);
-	if (isRecord$5(value) && value.type === "doc") return {
-		type: "doc",
-		content: Array.isArray(value.content) ? value.content.filter(isTipTapNodeLike).map(coerceTipTapNode) : []
-	};
-	return EMPTY_SITE_BANNER_BODY;
-}
-function isTipTapNodeLike(value) {
-	return isRecord$5(value) && typeof value.type === "string";
-}
-function coerceTipTapNode(value) {
-	return {
-		type: value.type,
-		...Array.isArray(value.content) ? { content: value.content.filter(isTipTapNodeLike).map(coerceTipTapNode) } : {},
-		...typeof value.text === "string" ? { text: value.text } : {},
-		...Array.isArray(value.marks) ? { marks: value.marks.filter((mark) => isRecord$5(mark) && typeof mark.type === "string").map((mark) => ({
-			type: mark.type,
-			...isRecord$5(mark.attrs) ? { attrs: mark.attrs } : {}
-		})) } : {}
-	};
-}
 function paragraphTextLength(paragraph) {
 	return collectText(paragraph).length;
 }
@@ -152970,7 +153072,7 @@ var init_event_registration_client = __esmMin((() => {
 * Loads Leaflet CSS/JS from CDN to avoid bundling in the blocks package.
 */
 function isLeafletApi(value) {
-	if (!isRecord$24(value)) return false;
+	if (!isRecord$25(value)) return false;
 	return typeof value.map === "function" && typeof value.tileLayer === "function" && typeof value.marker === "function";
 }
 function loadLeaflet() {
@@ -158116,7 +158218,7 @@ function ProductDetailController(props) {
 		selectedProduct,
 		variantId
 	]);
-	const bodyDoc = display.state === "ready" && props.render.hydration.showBody ? coerceRichTextDoc(display.body) : null;
+	const bodyDoc = display.state === "ready" && props.render.hydration.showBody ? coerceRichTextDoc(display.body, "block-runtime:product-detail:body") : null;
 	return /* @__PURE__ */ jsx(ProductDetailView, {
 		display,
 		gallery: display.state === "ready" ? /* @__PURE__ */ jsx(ProductGalleryFrameView, {
@@ -159711,41 +159813,11 @@ init_classic_professional();
 init_vibrant_creative();
 //#endregion
 //#region src/rendering/blocks-theme-runtime.ts
-const AXES_TONE_OPTIONS = [
-	"minimal",
-	"classic",
-	"bold"
-];
-const DEFAULT_AXES_TONE = AXES_TONE_OPTIONS[0];
-const AXES_TONE_SET = new Set(AXES_TONE_OPTIONS);
-const THEME_NAME_MAX_LENGTH = 30;
-function normalizeThemeForBlocks(theme) {
-	if (!theme || typeof theme !== "object") return theme;
-	const cloned = JSON.parse(JSON.stringify(theme));
-	if (typeof cloned.name === "string" && cloned.name.length > THEME_NAME_MAX_LENGTH) cloned.name = cloned.name.slice(0, THEME_NAME_MAX_LENGTH);
-	if (cloned.axes && typeof cloned.axes === "object") {
-		const axes = cloned.axes;
-		const tone = axes.tone;
-		if (typeof tone === "string" && !AXES_TONE_SET.has(tone)) axes.tone = DEFAULT_AXES_TONE;
-	}
-	return cloned;
-}
+init_buttons();
 function parseBlocksTheme(theme) {
-	const schema = themeSchema;
-	if (typeof schema.safeParse !== "function") {
-		console.warn("[sdk/rendering] themeSchema.safeParse is unavailable; skipping theme validation and using normalized theme data directly.");
-		return normalizeThemeForBlocks(theme);
-	}
-	const parsed = schema.safeParse(theme);
-	if (parsed.success) return parsed.data;
-	const normalized = normalizeThemeForBlocks(theme);
-	const reparsed = schema.safeParse(normalized);
-	if (reparsed.success) {
-		console.warn("[sdk/rendering] Repaired invalid theme to satisfy blocks schema:", parsed.error.issues);
-		return reparsed.data;
-	}
-	console.warn("[sdk/rendering] Failed to parse theme; falling back to modernMinimalTheme:", reparsed.error.issues);
-	return modernMinimalTheme;
+	const parsed = parseThemeForPersistence(theme);
+	if (!parsed.ok) throw new Error(`Theme does not satisfy the canonical runtime contract: ${parsed.error.kind}`);
+	return parsed.value;
 }
 function buildThemeRuntime(theme) {
 	return { tokens: buildThemeRuntime$1(parseBlocksTheme(theme)).tokens };
@@ -160044,7 +160116,7 @@ var SimpleCache = class {
 * 1. This constant
 * 2. The "version" field in package.json
 */
-const SDK_VERSION = "0.111.0";
+const SDK_VERSION = "0.118.0";
 //#endregion
 //#region src/client/error.ts
 let _Symbol$for;