emdash 0.35.0 → 0.37.0

package/dist/{menus-DSo5QeW0.mjs → menus-6qSwTNxG.mjs}

@@ -1,23 +1,26 @@
 import { t as validateIdentifier } from "./validate-BpwoDOgt.mjs";
-import { n as cachedQuery, t as CacheNamespace } from "./object-cache-71tPfV4A.mjs";
-import { n as chunks, t as SQL_BATCH_SIZE } from "./chunks-fiZ8G9RJ.mjs";
+import { n as cachedQuery, t as CacheNamespace } from "./object-cache-DVKnyOfy.mjs";
+import { n as chunks, t as SQL_BATCH_SIZE } from "./chunks-C4szrD8o.mjs";
 import { o as decodeCursor, s as encodeCursor } from "./types-CQPWhPxE.mjs";
-import { t as CommentRepository } from "./comment-Dxlep6cE.mjs";
-import { t as OptionsRepository } from "./options-CBXIHUoT.mjs";
-import { t as PluginContextFactory } from "./context-ZldbZcle.mjs";
-import { r as requestCached } from "./request-cache-BSUptuJR.mjs";
-import { i as resolveLocaleChain, r as resolveLocale } from "./resolve-DOhVEvty.mjs";
-import { s as getDb } from "./loader-CdG_Ci3H.mjs";
-import { a as normalizeCapabilities } from "./types-CP1CflWf.mjs";
-import { gt as sanitizeHref } from "./redirects-DTDHWH31.mjs";
-import { t as extractRequestMeta } from "./request-meta-DgZJh3zG.mjs";
-import { r as setCronTasksEnabled } from "./cron-Y9aLtgrA.mjs";
-import { t as MediaUsageActivationWriteBlockedError } from "./media-usage-write-fence-aHEgN1zB.mjs";
-import { t as CommentReactionRepository } from "./comment-reaction-D-2J84UE.mjs";
+import { t as CommentRepository } from "./comment-vxOzWbZN.mjs";
+import { t as OptionsRepository } from "./options-BHPeIbBd.mjs";
+import { t as PluginContextFactory } from "./context-CX6gxOLW.mjs";
+import { r as requestCached } from "./request-cache-DH9zdCOD.mjs";
+import { t as menuTag } from "./chrome-tags-D8fiZG94.mjs";
+import { i as resolveLocaleChain, r as resolveLocale } from "./resolve-prZ3mP7l.mjs";
+import { s as getDb } from "./loader-Z8vl7zTq.mjs";
+import { i as normalizeCapabilities } from "./types-DfuTR6dL.mjs";
+import { gt as sanitizeHref } from "./redirects-BLNOWQTn.mjs";
+import { t as extractRequestMeta } from "./request-meta-DYxLlnmz.mjs";
+import { r as setCronTasksEnabled } from "./cron-C6o7VppJ.mjs";
+import { t as MediaUsageActivationWriteBlockedError } from "./media-usage-write-fence-hjeD4u7s.mjs";
+import { t as CommentReactionRepository } from "./comment-reaction-BhrvSHml.mjs";
 import { sql } from "kysely";
 import { ulid } from "ulidx";
 import { AsyncLocalStorage } from "node:async_hooks";
 import { z } from "astro/zod";
+import { z as z$1 } from "zod";
+import { Extension, Mark, Node } from "@tiptap/core";
 
 //#region src/database/repositories/audit.ts
 /**
@@ -142,7 +145,7 @@ var AuditRepository = class {
 
 //#endregion
 //#region src/fields/image.ts
-const imageSchema = z.object({
+const mediaSchema = z.object({
 	id: z.string(),
 	src: z.string().optional(),
 	alt: z.string().optional(),
@@ -156,6 +159,7 @@ const imageSchema = z.object({
 	previewUrl: z.string().optional(),
 	meta: z.record(z.string(), z.unknown()).optional()
 });
+const imageSchema = mediaSchema.extend({ darkVariant: mediaSchema.optional() });
 function image(options = {}) {
 	const validation = options.allowedTypes && options.allowedTypes.length > 0 ? { allowedMimeTypes: [...options.allowedTypes] } : void 0;
 	return {
@@ -223,7 +227,7 @@ function reference(collection, options) {
 const portableTextBlockSchema = z.object({
 	_type: z.string(),
 	_key: z.string()
-}).passthrough();
+}).loose();
 /**
 * Portable Text field
 * Stores structured content in Portable Text format
@@ -251,10 +255,10 @@ function sanitizeGalleryImages(value, generateKey) {
 	if (!Array.isArray(value)) return [];
 	const images = [];
 	for (const entry of value) {
-		if (!isRecord$2(entry)) continue;
+		if (!isRecord$4(entry)) continue;
 		const record = entry;
 		const asset = record.asset;
-		if (!isRecord$2(asset)) continue;
+		if (!isRecord$4(asset)) continue;
 		const assetRecord = asset;
 		const image = {
 			_type: "image",
@@ -270,13 +274,15 @@ function sanitizeGalleryImages(value, generateKey) {
 		if (typeof record.caption === "string" && record.caption) image.caption = record.caption;
 		if (typeof record.width === "number") image.width = record.width;
 		if (typeof record.height === "number") image.height = record.height;
+		if (typeof record.focalX === "number") image.focalX = record.focalX;
+		if (typeof record.focalY === "number") image.focalY = record.focalY;
 		if (typeof record.blurhash === "string" && record.blurhash) image.blurhash = record.blurhash;
 		if (typeof record.dominantColor === "string" && record.dominantColor) image.dominantColor = record.dominantColor;
 		images.push(image);
 	}
 	return images;
 }
-function isRecord$2(value) {
+function isRecord$4(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -302,9 +308,10 @@ const SUPPORTED_PROSEMIRROR_MARKS = new Set([
 	"subscript",
 	"superscript",
 	"code",
-	"link"
+	"link",
+	"emdashPortableTextSpan"
 ]);
-function isRecord$1(value) {
+function isRecord$3(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function collectPortableTextMarks(value, inheritedMarkDefs, unsupported) {
@@ -312,11 +319,11 @@ function collectPortableTextMarks(value, inheritedMarkDefs, unsupported) {
 		for (const item of value) collectPortableTextMarks(item, inheritedMarkDefs, unsupported);
 		return;
 	}
-	if (!isRecord$1(value)) return;
+	if (!isRecord$3(value)) return;
 	let markDefs = inheritedMarkDefs;
 	if (Array.isArray(value.markDefs)) {
 		const localMarkDefs = new Map(inheritedMarkDefs);
-		for (const markDef of value.markDefs) if (isRecord$1(markDef) && typeof markDef._key === "string") localMarkDefs.set(markDef._key, markDef);
+		for (const markDef of value.markDefs) if (isRecord$3(markDef) && typeof markDef._key === "string") localMarkDefs.set(markDef._key, markDef);
 		markDefs = localMarkDefs;
 	}
 	if (value._type === "span" && Array.isArray(value.marks)) for (const mark of value.marks) {
@@ -471,6 +478,125 @@ function normalizeProseMirrorOrderedListJson(doc) {
 	return normalized;
 }
 
+//#endregion
+//#region src/content/converters/portable-text-identity.ts
+const PORTABLE_TEXT_BLOCK_NODE = "emdashPortableTextBlock";
+const PORTABLE_TEXT_BLOCK_ATTR = "emdashPortableTextBlock";
+const PORTABLE_TEXT_KEY_ATTR = "emdashPortableTextKey";
+const PORTABLE_TEXT_SPAN_MARK = "emdashPortableTextSpan";
+function isRecord$2(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function attrsWithPortableTextKey(attrs, key) {
+	return {
+		...attrs,
+		[PORTABLE_TEXT_KEY_ATTR]: key
+	};
+}
+function portableTextKeyFromAttrs(attrs) {
+	const key = attrs?.[PORTABLE_TEXT_KEY_ATTR];
+	return typeof key === "string" && key ? key : void 0;
+}
+function portableTextSpanKeyFromMarks(marks) {
+	for (const mark of marks ?? []) {
+		if (!isRecord$2(mark) || mark.type !== PORTABLE_TEXT_SPAN_MARK || !isRecord$2(mark.attrs)) continue;
+		const key = mark.attrs.key;
+		if (typeof key === "string" && key) return key;
+	}
+}
+function portableTextMarkDefsFromMarks(marks) {
+	const identity = (marks ?? []).find((mark) => isRecord$2(mark) && mark.type === PORTABLE_TEXT_SPAN_MARK && isRecord$2(mark.attrs));
+	if (!isRecord$2(identity) || !isRecord$2(identity.attrs) || !Array.isArray(identity.attrs.markDefs)) return [];
+	return identity.attrs.markDefs.filter((markDef) => isRecord$2(markDef) && typeof markDef._type === "string" && typeof markDef._key === "string");
+}
+function portableTextBlockFromAttrs(attrs) {
+	const block = attrs?.[PORTABLE_TEXT_BLOCK_ATTR];
+	if (!isRecord$2(block) || typeof block._type !== "string" || typeof block._key !== "string") return;
+	return {
+		...block,
+		_type: block._type,
+		_key: block._key
+	};
+}
+const PortableTextIdentityExtension = Extension.create({
+	name: "emdashPortableTextIdentity",
+	addGlobalAttributes() {
+		const hiddenAttribute = {
+			default: null,
+			rendered: false
+		};
+		return [{
+			types: [
+				"paragraph",
+				"heading",
+				"blockquote",
+				"codeBlock",
+				"htmlBlock",
+				"image",
+				"horizontalRule",
+				"gallery",
+				PORTABLE_TEXT_BLOCK_NODE
+			],
+			attributes: { [PORTABLE_TEXT_KEY_ATTR]: hiddenAttribute }
+		}];
+	}
+});
+const PortableTextSpanIdentity = Mark.create({
+	name: PORTABLE_TEXT_SPAN_MARK,
+	inclusive: false,
+	spanning: false,
+	addAttributes() {
+		return {
+			key: {
+				default: null,
+				rendered: false
+			},
+			markDefs: {
+				default: [],
+				rendered: false
+			}
+		};
+	},
+	parseHTML() {
+		return [];
+	},
+	renderHTML() {
+		return ["span", 0];
+	}
+});
+const PortableTextOpaqueBlock = Node.create({
+	name: PORTABLE_TEXT_BLOCK_NODE,
+	group: "block",
+	atom: true,
+	selectable: true,
+	draggable: true,
+	addAttributes() {
+		return { [PORTABLE_TEXT_BLOCK_ATTR]: {
+			default: null,
+			rendered: false
+		} };
+	},
+	parseHTML() {
+		return [{ tag: "div[data-emdash-portable-text-block]" }];
+	},
+	renderHTML({ node }) {
+		const blockType = portableTextBlockFromAttrs(node.attrs)?._type ?? "unknown";
+		return [
+			"div",
+			{
+				"data-emdash-portable-text-block": blockType,
+				contenteditable: "false"
+			},
+			`[Unknown block type: ${blockType}]`
+		];
+	}
+});
+const portableTextIdentityExtensions = [
+	PortableTextIdentityExtension,
+	PortableTextSpanIdentity,
+	PortableTextOpaqueBlock
+];
+
 //#endregion
 //#region src/content/converters/prosemirror-to-portable-text.ts
 /**
@@ -491,18 +617,33 @@ function prosemirrorToPortableText(doc) {
 	if (!doc || doc.type !== "doc" || !doc.content) return [];
 	assertProseMirrorMarksSupported(doc);
 	const blocks = [];
+	const usedBlockKeys = /* @__PURE__ */ new Set();
 	for (const [i, node] of doc.content.entries()) {
+		if (i === doc.content.length - 1 && isUnkeyedEmptyParagraph(node)) continue;
 		const converted = convertNode(node, `root:${i}`);
-		if (converted) if (Array.isArray(converted)) blocks.push(...converted);
-		else blocks.push(converted);
+		for (const block of converted ? Array.isArray(converted) ? converted : [converted] : []) {
+			let key = block._key;
+			if (usedBlockKeys.has(key)) do
+				key = generateKey();
+			while (usedBlockKeys.has(key));
+			usedBlockKeys.add(key);
+			blocks.push(key === block._key ? block : {
+				...block,
+				_key: key
+			});
+		}
 	}
 	return blocks;
 }
+function isUnkeyedEmptyParagraph(node) {
+	return node.type === "paragraph" && (node.content?.length ?? 0) === 0 && portableTextKeyFromAttrs(node.attrs) === void 0;
+}
 /**
 * Convert a single ProseMirror node to Portable Text block(s)
 */
 function convertNode(node, path) {
 	switch (node.type) {
+		case PORTABLE_TEXT_BLOCK_NODE: return portableTextBlockFromAttrs(node.attrs) ?? null;
 		case "paragraph": return convertParagraph(node);
 		case "heading": return convertHeading(node);
 		case "bulletList": return convertList$1(node, "bullet", path);
@@ -514,7 +655,7 @@ function convertNode(node, path) {
 		case "gallery": return convertGallery(node);
 		case "horizontalRule": return {
 			_type: "break",
-			_key: generateKey(),
+			_key: portableTextKeyFromAttrs(node.attrs) ?? generateKey(),
 			style: "lineBreak"
 		};
 		default: return {
@@ -535,10 +676,10 @@ function convertParagraph(node) {
 	const textAlign = ta === "center" || ta === "right" || ta === "justify" ? ta : void 0;
 	return {
 		_type: "block",
-		_key: generateKey(),
+		_key: portableTextKeyFromAttrs(node.attrs) ?? generateKey(),
 		style: "normal",
 		children,
-		markDefs: markDefs.length > 0 ? markDefs : void 0,
+		...markDefs.length > 0 ? { markDefs } : {},
 		...textAlign ? { textAlign } : {}
 	};
 }
@@ -565,7 +706,7 @@ function convertHeading(node) {
 	const textAlign = ta === "center" || ta === "right" || ta === "justify" ? ta : void 0;
 	return {
 		_type: "block",
-		_key: generateKey(),
+		_key: portableTextKeyFromAttrs(node.attrs) ?? generateKey(),
 		style,
 		children,
 		markDefs: markDefs.length > 0 ? markDefs : void 0,
@@ -593,7 +734,7 @@ function convertListItem$1(item, listItem, level, path, metadata) {
 		const { children, markDefs } = convertInlineContent(child.content || []);
 		if (children.length > 0) blocks.push({
 			_type: "block",
-			_key: generateKey(),
+			_key: portableTextKeyFromAttrs(child.attrs) ?? generateKey(),
 			style: "normal",
 			listItem,
 			level,
@@ -623,7 +764,7 @@ function convertBlockquote(node) {
 		const { children, markDefs } = convertInlineContent(child.content || []);
 		if (children.length > 0) blocks.push({
 			_type: "block",
-			_key: generateKey(),
+			_key: portableTextKeyFromAttrs(child.attrs) ?? portableTextKeyFromAttrs(node.attrs) ?? generateKey(),
 			style: "blockquote",
 			children,
 			markDefs: markDefs.length > 0 ? markDefs : void 0
@@ -639,7 +780,7 @@ function convertCodeBlock$1(node) {
 	const language = typeof node.attrs?.language === "string" ? node.attrs.language : void 0;
 	return {
 		_type: "code",
-		_key: generateKey(),
+		_key: portableTextKeyFromAttrs(node.attrs) ?? generateKey(),
 		code,
 		language: language || void 0
 	};
@@ -651,7 +792,7 @@ function convertHtmlBlock(node) {
 	const rawHtml = node.attrs?.html;
 	return {
 		_type: "htmlBlock",
-		_key: generateKey(),
+		_key: portableTextKeyFromAttrs(node.attrs) ?? generateKey(),
 		html: typeof rawHtml === "string" ? rawHtml : ""
 	};
 }
@@ -669,9 +810,10 @@ function convertImage$1(node) {
 	const height = typeof attrs?.height === "number" ? attrs.height : void 0;
 	const displayWidth = typeof attrs?.displayWidth === "number" ? attrs.displayWidth : void 0;
 	const displayHeight = typeof attrs?.displayHeight === "number" ? attrs.displayHeight : void 0;
+	const alignment = attrs?.alignment;
 	return {
 		_type: "image",
-		_key: generateKey(),
+		_key: portableTextKeyFromAttrs(node.attrs) ?? generateKey(),
 		asset: {
 			_ref: mediaId || src || "",
 			url: src || "",
@@ -682,7 +824,8 @@ function convertImage$1(node) {
 		width: width || void 0,
 		height: height || void 0,
 		displayWidth: displayWidth || void 0,
-		displayHeight: displayHeight || void 0
+		displayHeight: displayHeight || void 0,
+		alignment: alignment === "left" || alignment === "center" || alignment === "right" || alignment === "wide" || alignment === "full" ? alignment : void 0
 	};
 }
 /**
@@ -692,7 +835,7 @@ function convertGallery(node) {
 	const columns = node.attrs?.columns;
 	return {
 		_type: "gallery",
-		_key: generateKey(),
+		_key: portableTextKeyFromAttrs(node.attrs) ?? generateKey(),
 		images: sanitizeGalleryImages(node.attrs?.images, generateKey),
 		...typeof columns === "number" ? { columns } : {}
 	};
@@ -704,29 +847,50 @@ function convertInlineContent(nodes) {
 	const children = [];
 	const markDefs = [];
 	const markDefMap = /* @__PURE__ */ new Map();
+	const usedSpanKeys = /* @__PURE__ */ new Set();
+	const claimSpanKey = (preferred) => {
+		if (preferred && !usedSpanKeys.has(preferred)) {
+			usedSpanKeys.add(preferred);
+			return preferred;
+		}
+		let key;
+		do
+			key = generateKey();
+		while (usedSpanKeys.has(key));
+		usedSpanKeys.add(key);
+		return key;
+	};
 	for (const node of nodes) if (node.type === "text" && node.text) {
 		const marks = [];
+		const originalMarkDefs = portableTextMarkDefsFromMarks(node.marks);
 		for (const mark of node.marks || []) {
-			const markType = convertMark(mark, markDefs, markDefMap);
+			const markType = convertMark(mark, markDefs, markDefMap, originalMarkDefs);
 			if (markType) marks.push(markType);
 		}
+		const preferredKey = portableTextSpanKeyFromMarks(node.marks) ?? portableTextKeyFromAttrs(node.attrs);
+		const normalizedMarks = marks.length > 0 ? marks : void 0;
+		const previous = children.at(-1);
+		if (preferredKey && previous?._key === preferredKey && JSON.stringify(previous.marks) === JSON.stringify(normalizedMarks)) {
+			previous.text += node.text;
+			continue;
+		}
 		children.push({
 			_type: "span",
-			_key: generateKey(),
+			_key: claimSpanKey(preferredKey),
 			text: node.text,
-			marks: marks.length > 0 ? marks : void 0
+			marks: normalizedMarks
 		});
 	} else if (node.type === "hardBreak") if (children.length > 0) {
 		const lastChild = children.at(-1);
 		lastChild.text += "\n";
 	} else children.push({
 		_type: "span",
-		_key: generateKey(),
+		_key: claimSpanKey(portableTextSpanKeyFromMarks(node.marks) ?? portableTextKeyFromAttrs(node.attrs)),
 		text: "\n"
 	});
 	if (children.length === 0) children.push({
 		_type: "span",
-		_key: generateKey(),
+		_key: claimSpanKey(),
 		text: ""
 	});
 	return {
@@ -737,7 +901,7 @@ function convertInlineContent(nodes) {
 /**
 * Convert a ProseMirror mark to Portable Text mark
 */
-function convertMark(mark, markDefs, markDefMap) {
+function convertMark(mark, markDefs, markDefMap, originalMarkDefs) {
 	switch (mark.type) {
 		case "bold":
 		case "strong": return "strong";
@@ -749,17 +913,22 @@ function convertMark(mark, markDefs, markDefMap) {
 		case "subscript": return "subscript";
 		case "superscript": return "superscript";
 		case "code": return "code";
+		case PORTABLE_TEXT_SPAN_MARK: return null;
 		case "link": {
 			const href = (typeof mark.attrs?.href === "string" ? mark.attrs.href : "") || "";
-			if (markDefMap.has(href)) return markDefMap.get(href);
-			const key = generateKey();
+			const originalMarkDef = originalMarkDefs.find((markDef) => markDef._type === "link");
+			const mapKey = originalMarkDef ? `key:${originalMarkDef._key}` : `href:${href}`;
+			if (markDefMap.has(mapKey)) return markDefMap.get(mapKey);
+			const key = originalMarkDef?._key || generateKey();
+			const blank = mark.attrs?.target === "_blank";
 			markDefs.push({
+				...originalMarkDef,
 				_type: "link",
 				_key: key,
 				href,
-				blank: mark.attrs?.target === "_blank"
+				...blank || originalMarkDef && Object.hasOwn(originalMarkDef, "blank") ? { blank } : {}
 			});
-			markDefMap.set(href, key);
+			markDefMap.set(mapKey, key);
 			return key;
 		}
 		default: throw new UnsupportedPortableTextMarksError([mark.type]);
@@ -773,15 +942,14 @@ function convertMark(mark, markDefs, markDefMap) {
 *
 * Converts Portable Text to TipTap's ProseMirror JSON format for editing.
 */
-/**
-* Convert Portable Text to ProseMirror document
-*/
-function portableTextToProsemirror(blocks) {
+/** Convert Portable Text to a ProseMirror document. */
+function portableTextToProsemirror(blocks, options = {}) {
 	if (!blocks || blocks.length === 0) return {
 		type: "doc",
 		content: [{ type: "paragraph" }]
 	};
 	assertPortableTextMarksSupported(blocks);
+	const preserveIdentity = options.preserveIdentity === true;
 	const content = [];
 	let i = 0;
 	while (i < blocks.length) {
@@ -802,7 +970,7 @@ function portableTextToProsemirror(blocks) {
 					i++;
 				} else break;
 			}
-			content.push(convertList(listBlocks, listType, `root:${runStart}`));
+			content.push(convertList(listBlocks, listType, `root:${runStart}`, preserveIdentity));
 		} else if (isTextBlock(block) && block.style === "blockquote") {
 			const quoteBlocks = [];
 			while (i < blocks.length) {
@@ -814,15 +982,16 @@ function portableTextToProsemirror(blocks) {
 			content.push({
 				type: "blockquote",
 				content: quoteBlocks.map((quoteBlock) => {
-					const paragraph = convertSpans(quoteBlock.children, quoteBlock.markDefs || []);
+					const paragraph = convertSpans(quoteBlock.children, quoteBlock.markDefs || [], preserveIdentity);
 					return {
 						type: "paragraph",
+						attrs: identityAttrs(void 0, quoteBlock._key, preserveIdentity),
 						content: paragraph.length > 0 ? paragraph : void 0
 					};
 				})
 			});
 		} else {
-			const converted = convertBlock(block);
+			const converted = convertBlock(block, preserveIdentity);
 			if (converted) content.push(converted);
 			i++;
 		}
@@ -832,6 +1001,9 @@ function portableTextToProsemirror(blocks) {
 		content: content.length > 0 ? content : [{ type: "paragraph" }]
 	});
 }
+function identityAttrs(attrs, key, preserveIdentity) {
+	return preserveIdentity ? attrsWithPortableTextKey(attrs, key) : attrs;
+}
 function getListMetadata(item, fallbackSeed) {
 	const listId = normalizeListId(item.listId) ?? deriveLegacyListId(fallbackSeed);
 	const listStart = normalizeListStart(item.listStart);
@@ -863,8 +1035,8 @@ function isImageBlock(block) {
 	return block._type === "image" && "asset" in block && typeof block.asset === "object" && block.asset !== null;
 }
 /**
-* Type guard for gallery blocks. Requires an `images` array — a gallery
-* without one is malformed and falls through to the unknown-block path.
+* Type guard for gallery blocks that carry a usable `images` array.
+* Galleries without one are handled separately in `convertBlock`.
 */
 function isGalleryBlock(block) {
 	return block._type === "gallery" && "images" in block && Array.isArray(block.images);
@@ -878,23 +1050,44 @@ function isCodeBlock(block) {
 /**
 * Convert a single Portable Text block to ProseMirror node
 */
-function convertBlock(block) {
-	if (isTextBlock(block)) return convertTextBlock(block);
-	if (isImageBlock(block)) return convertImage(block);
-	if (block._type === "image") return convertMalformedImage(block);
+function convertBlock(block, preserveIdentity) {
+	if (isTextBlock(block)) return convertTextBlock(block, preserveIdentity);
+	if (isImageBlock(block)) return convertImage(block, preserveIdentity);
+	if (block._type === "image") return convertMalformedImage(block, preserveIdentity);
 	if (isGalleryBlock(block)) return {
 		type: "gallery",
-		attrs: {
+		attrs: identityAttrs({
 			images: sanitizeGalleryImages(block.images),
 			columns: typeof block.columns === "number" ? block.columns : void 0
-		}
+		}, block._key, preserveIdentity)
 	};
-	if (isCodeBlock(block)) return convertCodeBlock(block);
+	if (isCodeBlock(block)) return convertCodeBlock(block, preserveIdentity);
 	if (block._type === "htmlBlock") return {
 		type: "htmlBlock",
-		attrs: { html: block.html || "" }
+		attrs: identityAttrs({ html: block.html || "" }, block._key, preserveIdentity)
+	};
+	if (block._type === "break") return {
+		type: "horizontalRule",
+		attrs: identityAttrs(void 0, block._key, preserveIdentity)
+	};
+	if (block._type === "gallery") {
+		if (preserveIdentity) return {
+			type: PORTABLE_TEXT_BLOCK_NODE,
+			attrs: { [PORTABLE_TEXT_BLOCK_ATTR]: block }
+		};
+		return {
+			type: "paragraph",
+			content: [{
+				type: "text",
+				text: `[Unknown block type: ${block._type}]`,
+				marks: [{ type: "code" }]
+			}]
+		};
+	}
+	if (preserveIdentity) return {
+		type: PORTABLE_TEXT_BLOCK_NODE,
+		attrs: { [PORTABLE_TEXT_BLOCK_ATTR]: block }
 	};
-	if (block._type === "break") return { type: "horizontalRule" };
 	return {
 		type: "paragraph",
 		content: [{
@@ -907,9 +1100,9 @@ function convertBlock(block) {
 /**
 * Convert text block to ProseMirror paragraph or heading
 */
-function convertTextBlock(block) {
+function convertTextBlock(block, preserveIdentity) {
 	const { style = "normal", children, markDefs = [] } = block;
-	const content = convertSpans(children, markDefs);
+	const content = convertSpans(children, markDefs, preserveIdentity);
 	switch (style) {
 		case "h1":
 		case "h2":
@@ -918,14 +1111,15 @@ function convertTextBlock(block) {
 		case "h5":
 		case "h6": return {
 			type: "heading",
-			attrs: {
+			attrs: identityAttrs({
 				level: parseInt(style.substring(1), 10),
 				...block.textAlign ? { textAlign: block.textAlign } : {}
-			},
+			}, block._key, preserveIdentity),
 			content: content.length > 0 ? content : void 0
 		};
 		case "blockquote": return {
 			type: "blockquote",
+			attrs: identityAttrs(void 0, block._key, preserveIdentity),
 			content: [{
 				type: "paragraph",
 				content: content.length > 0 ? content : void 0
@@ -933,7 +1127,7 @@ function convertTextBlock(block) {
 		};
 		default: return {
 			type: "paragraph",
-			attrs: block.textAlign ? { textAlign: block.textAlign } : void 0,
+			attrs: identityAttrs(block.textAlign ? { textAlign: block.textAlign } : void 0, block._key, preserveIdentity),
 			content: content.length > 0 ? content : void 0
 		};
 	}
@@ -941,7 +1135,7 @@ function convertTextBlock(block) {
 /**
 * Convert list items to ProseMirror list
 */
-function convertList(items, listType, context) {
+function convertList(items, listType, context, preserveIdentity) {
 	const rootItems = [];
 	let i = 0;
 	while (i < items.length) {
@@ -953,9 +1147,9 @@ function convertList(items, listType, context) {
 				nestedItems.push(items[i]);
 				i++;
 			}
-			rootItems.push(convertListItem(item, nestedItems, listType, `${context}:${rootItems.length}`));
+			rootItems.push(convertListItem(item, nestedItems, listType, `${context}:${rootItems.length}`, preserveIdentity));
 		} else {
-			rootItems.push(convertListItem(item, [], listType, `${context}:${rootItems.length}`));
+			rootItems.push(convertListItem(item, [], listType, `${context}:${rootItems.length}`, preserveIdentity));
 			i++;
 		}
 	}
@@ -972,11 +1166,12 @@ function convertList(items, listType, context) {
 /**
 * Convert a single list item to ProseMirror
 */
-function convertListItem(item, nestedItems, parentListType, context) {
+function convertListItem(item, nestedItems, parentListType, context, preserveIdentity) {
 	const content = [];
-	const spans = convertSpans(item.children, item.markDefs || []);
+	const spans = convertSpans(item.children, item.markDefs || [], preserveIdentity);
 	content.push({
 		type: "paragraph",
+		attrs: identityAttrs(void 0, item._key, preserveIdentity),
 		content: spans.length > 0 ? spans : void 0
 	});
 	if (nestedItems.length > 0) {
@@ -999,7 +1194,7 @@ function convertListItem(item, nestedItems, parentListType, context) {
 					...ni,
 					level: (ni.level || 2) - 1
 				}));
-				content.push(convertList(adjustedGroup, anchorType, `${context}:nested:${j - nestedGroup.length}`));
+				content.push(convertList(adjustedGroup, anchorType, `${context}:nested:${j - nestedGroup.length}`, preserveIdentity));
 			}
 		}
 	}
@@ -1011,16 +1206,24 @@ function convertListItem(item, nestedItems, parentListType, context) {
 /**
 * Convert Portable Text spans to ProseMirror text nodes
 */
-function convertSpans(spans, markDefs) {
+function convertSpans(spans, markDefs, preserveIdentity) {
 	const nodes = [];
 	const markDefsMap = new Map(markDefs.map((md) => [md._key, md]));
 	for (const span of spans) {
 		if (span._type !== "span") continue;
+		const referencedMarkDefs = markDefs.filter((markDef) => span.marks?.includes(markDef._key));
 		const parts = span.text.split("\n");
 		for (let i = 0; i < parts.length; i++) {
 			const text = parts[i];
 			if (text.length > 0) {
 				const marks = convertMarks(span.marks || [], markDefsMap);
+				if (preserveIdentity) marks.push({
+					type: PORTABLE_TEXT_SPAN_MARK,
+					attrs: {
+						key: span._key,
+						markDefs: referencedMarkDefs
+					}
+				});
 				const node = {
 					type: "text",
 					text
@@ -1028,7 +1231,16 @@ function convertSpans(spans, markDefs) {
 				if (marks.length > 0) node.marks = marks;
 				nodes.push(node);
 			}
-			if (i < parts.length - 1) nodes.push({ type: "hardBreak" });
+			if (i < parts.length - 1) nodes.push(preserveIdentity ? {
+				type: "hardBreak",
+				marks: [{
+					type: PORTABLE_TEXT_SPAN_MARK,
+					attrs: {
+						key: span._key,
+						markDefs: referencedMarkDefs
+					}
+				}]
+			} : { type: "hardBreak" });
 		}
 	}
 	return nodes;
@@ -1075,13 +1287,16 @@ function convertMarks(marks, markDefs) {
 	}
 	return pmMarks;
 }
+function imageAlignment(value) {
+	return value === "left" || value === "center" || value === "right" || value === "wide" || value === "full" ? value : void 0;
+}
 /**
 * Convert image block to ProseMirror
 */
-function convertImage(block) {
+function convertImage(block, preserveIdentity) {
 	return {
 		type: "image",
-		attrs: {
+		attrs: identityAttrs({
 			src: block.asset.url || block.asset._ref,
 			alt: block.alt || "",
 			title: block.caption || "",
@@ -1090,8 +1305,9 @@ function convertImage(block) {
 			width: block.width,
 			height: block.height,
 			displayWidth: block.displayWidth,
-			displayHeight: block.displayHeight
-		}
+			displayHeight: block.displayHeight,
+			alignment: imageAlignment(block.alignment)
+		}, block._key, preserveIdentity)
 	};
 }
 /**
@@ -1099,10 +1315,10 @@ function convertImage(block) {
 * Handles blocks like `{ _type: "image", url: "...", alt: "..." }` that may
 * originate from migrations or third-party imports.
 */
-function convertMalformedImage(block) {
+function convertMalformedImage(block, preserveIdentity) {
 	return {
 		type: "image",
-		attrs: {
+		attrs: identityAttrs({
 			src: "url" in block && typeof block.url === "string" ? block.url : "",
 			alt: "alt" in block && typeof block.alt === "string" ? block.alt : "",
 			title: "caption" in block && typeof block.caption === "string" ? block.caption : "",
@@ -1111,17 +1327,18 @@ function convertMalformedImage(block) {
 			width: "width" in block && typeof block.width === "number" ? block.width : void 0,
 			height: "height" in block && typeof block.height === "number" ? block.height : void 0,
 			displayWidth: "displayWidth" in block && typeof block.displayWidth === "number" ? block.displayWidth : void 0,
-			displayHeight: "displayHeight" in block && typeof block.displayHeight === "number" ? block.displayHeight : void 0
-		}
+			displayHeight: "displayHeight" in block && typeof block.displayHeight === "number" ? block.displayHeight : void 0,
+			alignment: imageAlignment("alignment" in block ? block.alignment : void 0)
+		}, block._key, preserveIdentity)
 	};
 }
 /**
 * Convert code block to ProseMirror
 */
-function convertCodeBlock(block) {
+function convertCodeBlock(block, preserveIdentity) {
 	return {
 		type: "codeBlock",
-		attrs: { language: block.language || null },
+		attrs: identityAttrs({ language: block.language || null }, block._key, preserveIdentity),
 		content: block.code ? [{
 			type: "text",
 			text: block.code
@@ -1566,9 +1783,10 @@ var HookPipeline = class HookPipeline {
 	}
 	/**
 	* Run content:beforeSave hooks
-	* Returns modified content from the pipeline
+	* Returns modified content from the pipeline. `id` is the existing item's
+	* ID when updating.
 	*/
-	async runContentBeforeSave(content, collection, isNew) {
+	async runContentBeforeSave(content, collection, isNew, id) {
 		const hooks = this.getTypedHooks("content:beforeSave");
 		const results = [];
 		let currentContent = content;
@@ -1579,6 +1797,7 @@ var HookPipeline = class HookPipeline {
 				collection,
 				isNew
 			};
+			if (id !== void 0) event.id = id;
 			const ctx = this.getContext(hook.pluginId);
 			const start = Date.now();
 			try {
@@ -2246,6 +2465,28 @@ async function resolveExclusiveHooks(opts) {
 	}
 }
 
+//#endregion
+//#region src/plugins/save-rejection.ts
+/**
+* Thrown by a `content:beforeSave` hook to reject a save with a message
+* that is safe to show to the editor. The runtime converts it into a
+* structured `SAVE_REJECTED` API error; any other exception thrown by the
+* hook cancels the save with a generic error that hides the exception
+* message.
+*/
+var ContentSaveRejectedError = class extends Error {
+	name = "ContentSaveRejectedError";
+};
+/**
+* Matches by name as well as by prototype: bundlers can duplicate this
+* module across SSR chunks, and an `instanceof` against the wrong copy of
+* the class would misreport a rejection as a plugin crash.
+*/
+function isContentSaveRejection(error) {
+	if (error instanceof ContentSaveRejectedError) return true;
+	return error instanceof Error && error.name === "ContentSaveRejectedError";
+}
+
 //#endregion
 //#region src/plugins/email.ts
 /**
@@ -2514,7 +2755,7 @@ var PluginRouteHandler = class {
 				error: {
 					code: "VALIDATION_ERROR",
 					message: "Invalid request body",
-					details: parseResult.error.format()
+					details: z$1.formatError(parseResult.error)
 				},
 				status: 400
 			};
@@ -2821,9 +3062,9 @@ var PluginManager = class {
 	/**
 	* Run content:beforeSave hooks across all active plugins
 	*/
-	async runContentBeforeSave(content, collection, isNew) {
+	async runContentBeforeSave(content, collection, isNew, id) {
 		this.ensureInitialized();
-		return this.hookPipeline.runContentBeforeSave(content, collection, isNew);
+		return this.hookPipeline.runContentBeforeSave(content, collection, isNew, id);
 	}
 	/**
 	* Run content:afterSave hooks across all active plugins
@@ -3089,16 +3330,12 @@ var NodeCronScheduler = class {
 	timer = null;
 	running = false;
 	systemCleanup = null;
-	mediaUsageMaintenance = null;
 	constructor(executor) {
 		this.executor = executor;
 	}
 	setSystemCleanup(fn) {
 		this.systemCleanup = fn;
 	}
-	setMediaUsageMaintenance(fn) {
-		this.mediaUsageMaintenance = fn;
-	}
 	start() {
 		this.running = true;
 		this.arm();
@@ -3145,13 +3382,8 @@ var NodeCronScheduler = class {
 		if (!this.running) return;
 		const tasks = [this.executor.tick(), this.executor.recoverStaleLocks()];
 		if (this.systemCleanup) tasks.push(this.systemCleanup());
-		Promise.allSettled(tasks).then(async (results) => {
+		Promise.allSettled(tasks).then((results) => {
 			for (const r of results) if (r.status === "rejected") console.error("[cron:node] Tick task failed:", r.reason);
-			if (this.mediaUsageMaintenance) try {
-				await this.mediaUsageMaintenance();
-			} catch (error) {
-				console.error("[cron:node] Media Usage maintenance failed:", error);
-			}
 		}).finally(() => {
 			if (this.running) this.arm();
 		});
@@ -3226,14 +3458,14 @@ const SANDBOX_ROUTE_ERROR_DEFINITIONS = {
 		status: 503
 	}
 };
-function isRecord(value) {
+function isRecord$1(value) {
 	return typeof value === "object" && value !== null;
 }
 function isSandboxRouteErrorCode(value) {
 	return typeof value === "string" && value in SANDBOX_ROUTE_ERROR_DEFINITIONS;
 }
 function getSandboxRouteErrorDetails(error) {
-	if (!isRecord(error)) return null;
+	if (!isRecord$1(error)) return null;
 	const propertyCode = isSandboxRouteErrorCode(error.code) ? error.code : null;
 	const nameCode = error instanceof Error && isSandboxRouteErrorCode(error.name) ? error.name : null;
 	if (propertyCode && nameCode && propertyCode !== nameCode) return null;
@@ -3259,7 +3491,7 @@ function createSandboxRouteErrorEnvelope(error) {
 	} : null;
 }
 function getSandboxRouteErrorEnvelope(value) {
-	if (!isRecord(value) || value.__emdashSandboxRouteError !== true) return null;
+	if (!isRecord$1(value) || value.__emdashSandboxRouteError !== true) return null;
 	const details = getSandboxRouteErrorDetails(value.error);
 	return details ? {
 		__emdashSandboxRouteError: true,
@@ -3277,6 +3509,30 @@ var SandboxUnavailableError = class extends Error {
 	}
 };
 
+//#endregion
+//#region src/plugins/sandbox/hook-result.ts
+/** Current wire-format version for sandbox hook result envelopes. */
+const SANDBOX_HOOK_RESULT_VERSION = 1;
+/** Maximum editor-facing rejection reason accepted from a sandboxed plugin. */
+const MAX_SANDBOX_SAVE_REJECTION_REASON_LENGTH = 500;
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Validate and normalize an untrusted value returned across the sandbox boundary. */
+function inspectSandboxHookResult(value) {
+	if (!isRecord(value) || !Object.hasOwn(value, "__emdashSandboxHookResult")) return { kind: "value" };
+	if (value.__emdashSandboxHookResult !== true || value.version !== SANDBOX_HOOK_RESULT_VERSION || !isRecord(value.error) || value.error.code !== "SAVE_REJECTED" || typeof value.error.reason !== "string") return { kind: "malformed" };
+	const reason = value.error.reason.trim();
+	if (reason.length === 0 || reason.length > MAX_SANDBOX_SAVE_REJECTION_REASON_LENGTH) return { kind: "malformed" };
+	return {
+		kind: "error",
+		error: {
+			code: "SAVE_REJECTED",
+			reason
+		}
+	};
+}
+
 //#endregion
 //#region src/comments/ranking.ts
 /**
@@ -3507,6 +3763,18 @@ async function getMenusWithDb(db, options = {}) {
 	return query.execute();
 }
 /**
+* Get a menu by name with a Workers edge-cache hint.
+*
+* Use the returned `cacheHint` with `Astro.cache.set()` so pages that render
+* this menu can be purged automatically when the menu is edited.
+*/
+async function getMenuWithCacheHint(name, options = {}) {
+	return {
+		data: await getMenu(name, options),
+		cacheHint: { tags: [menuTag(name)] }
+	};
+}
+/**
 * Build a hierarchical menu tree from a flat list of items. Items are
 * resolved against the given `locale` so references land on the right
 * per-locale content rows.
@@ -3738,5 +4006,5 @@ function resolveTaxonomyUrl(referenceGroup, taxonomyLookup) {
 }
 
 //#endregion
-export { file as A, createHookPipeline as C, prosemirrorToPortableText as D, portableTextToProsemirror as E, AuditRepository as M, portableText as O, HookPipeline as S, definePlugin as T, PluginRouteRegistry as _, SandboxUnavailableError as a, toRouteCallerInfo as b, getSandboxRouteErrorDetails as c, SandboxNotAvailableError as d, createNoopSandboxRunner as f, PluginRouteError as g, createPluginManager as h, getComments as i, image as j, reference as k, getSandboxRouteErrorEnvelope as l, PluginManager as m, getMenus as n, createSandboxRouteError as o, NodeCronScheduler as p, getCommentCount as r, createSandboxRouteErrorEnvelope as s, getMenu as t, NoopSandboxRunner as u, buildRouteMeta as v, resolveExclusiveHooks as w, EmailPipeline as x, parseRouteInput as y };
-//# sourceMappingURL=menus-DSo5QeW0.mjs.map
+export { resolveExclusiveHooks as A, parseRouteInput as C, isContentSaveRejection as D, ContentSaveRejectedError as E, portableText as F, reference as I, file as L, portableTextToProsemirror as M, prosemirrorToPortableText as N, HookPipeline as O, portableTextIdentityExtensions as P, image as R, buildRouteMeta as S, EmailPipeline as T, NodeCronScheduler as _, getComments as a, PluginRouteError as b, inspectSandboxHookResult as c, createSandboxRouteErrorEnvelope as d, getSandboxRouteErrorDetails as f, createNoopSandboxRunner as g, SandboxNotAvailableError as h, getCommentCount as i, definePlugin as j, createHookPipeline as k, SandboxUnavailableError as l, NoopSandboxRunner as m, getMenuWithCacheHint as n, MAX_SANDBOX_SAVE_REJECTION_REASON_LENGTH as o, getSandboxRouteErrorEnvelope as p, getMenus as r, SANDBOX_HOOK_RESULT_VERSION as s, getMenu as t, createSandboxRouteError as u, PluginManager as v, toRouteCallerInfo as w, PluginRouteRegistry as x, createPluginManager as y, AuditRepository as z };
+//# sourceMappingURL=menus-6qSwTNxG.mjs.map