emdash 1.1.0 → 1.3.0

package/dist/portable-text-BH4zgkSm.mjs

@@ -0,0 +1,311 @@
+//#region src/client/portable-text.ts
+/**
+* Convert Portable Text blocks to Markdown.
+* Unknown block types are serialized as opaque fences.
+*/
+function portableTextToMarkdown(blocks) {
+	const lines = [];
+	let prevWasList = false;
+	for (let i = 0; i < blocks.length; i++) {
+		const block = blocks[i];
+		if (block._type === "block") {
+			const isList = !!block.listItem;
+			if (i > 0 && (!isList || !prevWasList)) lines.push("");
+			lines.push(renderStandardBlock(block));
+			prevWasList = isList;
+		} else if (block._type === "code") {
+			if (i > 0) lines.push("");
+			const lang = block.language || "";
+			const code = block.code || "";
+			lines.push("```" + lang);
+			lines.push(code);
+			lines.push("```");
+			prevWasList = false;
+		} else if (block._type === "image") {
+			if (i > 0) lines.push("");
+			const alt = block.alt || "";
+			const url = block.asset?.url || "";
+			lines.push(`![${alt}](${url})`);
+			prevWasList = false;
+		} else {
+			if (i > 0) lines.push("");
+			lines.push(`<!--ec:block ${JSON.stringify(block)} -->`);
+			prevWasList = false;
+		}
+	}
+	return lines.join("\n") + "\n";
+}
+function renderStandardBlock(block) {
+	const text = renderSpans(block.children ?? [], block.markDefs ?? []);
+	if (block.listItem) return `${"  ".repeat(Math.max(0, (block.level ?? 1) - 1))}${block.listItem === "number" ? "1." : "-"} ${text}`;
+	if (block.style && block.style.startsWith("h")) {
+		const level = parseInt(block.style.substring(1), 10);
+		if (level >= 1 && level <= 6) return `${"#".repeat(level)} ${text}`;
+	}
+	if (block.style === "blockquote") return `> ${text}`;
+	return text;
+}
+function renderSpans(spans, markDefs) {
+	let result = "";
+	for (const span of spans) {
+		if (span._type !== "span") continue;
+		let text = span.text ?? "";
+		const marks = span.marks ?? [];
+		for (const mark of marks) {
+			const def = markDefs.find((d) => d._key === mark);
+			if (def) {
+				if (def._type === "link") text = `[${text}](${def.href ?? ""})`;
+			} else switch (mark) {
+				case "strong":
+					text = `**${text}**`;
+					break;
+				case "em":
+					text = `_${text}_`;
+					break;
+				case "code":
+					text = `\`${text}\``;
+					break;
+				case "strike-through":
+				case "strikethrough":
+					text = `~~${text}~~`;
+					break;
+			}
+		}
+		result += text;
+	}
+	return result;
+}
+const OPAQUE_FENCE_PATTERN = /^<!--ec:block (.+) -->$/;
+const HEADING_PATTERN = /^(#{1,6})\s+(.+)$/;
+const UNORDERED_LIST_PATTERN = /^(\s*)[-*+]\s+(.+)$/;
+const ORDERED_LIST_PATTERN = /^(\s*)\d+\.\s+(.+)$/;
+const IMAGE_PATTERN = /^!\[([^\]]*)\]\(([^)]+)\)$/;
+const INLINE_MARKDOWN_PATTERN = /(\*\*(.+?)\*\*)|(_(.+?)_)|(`(.+?)`)|(\[(.+?)\]\((.+?)\))|(~~(.+?)~~)/g;
+/**
+* Convert Markdown to Portable Text blocks.
+* Opaque fences (<!--ec:block ... -->) are deserialized and spliced back in.
+*/
+function markdownToPortableText(markdown) {
+	const blocks = [];
+	const lines = markdown.split("\n");
+	let i = 0;
+	while (i < lines.length) {
+		const line = lines[i];
+		const opaqueMatch = line.match(OPAQUE_FENCE_PATTERN);
+		if (opaqueMatch) {
+			try {
+				blocks.push(JSON.parse(opaqueMatch[1]));
+			} catch {
+				blocks.push(makeBlock(line));
+			}
+			i++;
+			continue;
+		}
+		if (line.startsWith("```")) {
+			const lang = line.slice(3).trim();
+			const codeLines = [];
+			i++;
+			while (i < lines.length && !lines[i].startsWith("```")) {
+				codeLines.push(lines[i]);
+				i++;
+			}
+			blocks.push({
+				_type: "code",
+				_key: generateKey(),
+				language: lang || void 0,
+				code: codeLines.join("\n")
+			});
+			i++;
+			continue;
+		}
+		if (line.trim() === "") {
+			i++;
+			continue;
+		}
+		const headingMatch = line.match(HEADING_PATTERN);
+		if (headingMatch) {
+			blocks.push(makeBlock(headingMatch[2], `h${headingMatch[1].length}`));
+			i++;
+			continue;
+		}
+		if (line.startsWith("> ")) {
+			blocks.push(makeBlock(line.slice(2), "blockquote"));
+			i++;
+			continue;
+		}
+		const ulMatch = line.match(UNORDERED_LIST_PATTERN);
+		if (ulMatch) {
+			const level = Math.floor(ulMatch[1].length / 2) + 1;
+			blocks.push(makeListBlock(ulMatch[2], "bullet", level));
+			i++;
+			continue;
+		}
+		const olMatch = line.match(ORDERED_LIST_PATTERN);
+		if (olMatch) {
+			const level = Math.floor(olMatch[1].length / 2) + 1;
+			blocks.push(makeListBlock(olMatch[2], "number", level));
+			i++;
+			continue;
+		}
+		const imgMatch = line.match(IMAGE_PATTERN);
+		if (imgMatch) {
+			blocks.push({
+				_type: "image",
+				_key: generateKey(),
+				alt: imgMatch[1],
+				asset: { url: imgMatch[2] }
+			});
+			i++;
+			continue;
+		}
+		blocks.push(makeBlock(line));
+		i++;
+	}
+	return blocks;
+}
+function makeBlock(text, style = "normal") {
+	const { spans, markDefs } = parseInline(text);
+	return {
+		_type: "block",
+		_key: generateKey(),
+		style,
+		markDefs,
+		children: spans
+	};
+}
+function makeListBlock(text, listItem, level) {
+	const { spans, markDefs } = parseInline(text);
+	return {
+		_type: "block",
+		_key: generateKey(),
+		style: "normal",
+		listItem,
+		level,
+		markDefs,
+		children: spans
+	};
+}
+/**
+* Parse inline markdown (bold, italic, code, links, strikethrough) into PT spans + markDefs.
+*/
+function parseInline(text) {
+	const spans = [];
+	const markDefs = [];
+	const regex = INLINE_MARKDOWN_PATTERN;
+	let lastIndex = 0;
+	let match;
+	while ((match = regex.exec(text)) !== null) {
+		if (match.index > lastIndex) spans.push({
+			_type: "span",
+			_key: generateKey(),
+			text: text.slice(lastIndex, match.index),
+			marks: []
+		});
+		if (match[2] != null) spans.push({
+			_type: "span",
+			_key: generateKey(),
+			text: match[2],
+			marks: ["strong"]
+		});
+		else if (match[4] != null) spans.push({
+			_type: "span",
+			_key: generateKey(),
+			text: match[4],
+			marks: ["em"]
+		});
+		else if (match[6] != null) spans.push({
+			_type: "span",
+			_key: generateKey(),
+			text: match[6],
+			marks: ["code"]
+		});
+		else if (match[8] != null && match[9] != null) {
+			const key = generateKey();
+			markDefs.push({
+				_key: key,
+				_type: "link",
+				href: match[9]
+			});
+			spans.push({
+				_type: "span",
+				_key: generateKey(),
+				text: match[8],
+				marks: [key]
+			});
+		} else if (match[11] != null) spans.push({
+			_type: "span",
+			_key: generateKey(),
+			text: match[11],
+			marks: ["strike-through"]
+		});
+		lastIndex = match.index + match[0].length;
+	}
+	if (lastIndex < text.length) spans.push({
+		_type: "span",
+		_key: generateKey(),
+		text: text.slice(lastIndex),
+		marks: []
+	});
+	if (spans.length === 0) spans.push({
+		_type: "span",
+		_key: generateKey(),
+		text,
+		marks: []
+	});
+	return {
+		spans,
+		markDefs
+	};
+}
+let keyCounter = 0;
+function generateKey() {
+	return `k${(keyCounter++).toString(36)}`;
+}
+function convertNestedBlockPortableText(value, field, direction) {
+	if (!Array.isArray(value)) return value;
+	const validation = field.validation;
+	const allowedTypes = validation && typeof validation === "object" && "allowedTypes" in validation ? validation.allowedTypes : void 0;
+	return value.map((block) => {
+		if (!block || typeof block !== "object" || Array.isArray(block)) return block;
+		const record = { ...block };
+		const type = record._type === void 0 && direction === "write" && Array.isArray(allowedTypes) && allowedTypes.length === 1 ? allowedTypes[0] : record._type;
+		const version = typeof record._version === "number" ? record._version : void 0;
+		const blockType = field.blockTypes?.find((candidate) => candidate.slug === type);
+		const definition = blockType?.versions.find((candidate) => candidate.version === (version ?? blockType.currentVersion));
+		if (!definition) return block;
+		for (const nestedField of definition.fields) {
+			if (nestedField.type !== "portableText") continue;
+			const nestedValue = record[nestedField.slug];
+			if (direction === "read" && Array.isArray(nestedValue)) record[nestedField.slug] = portableTextToMarkdown(nestedValue);
+			else if (direction === "write" && typeof nestedValue === "string") record[nestedField.slug] = markdownToPortableText(nestedValue);
+		}
+		return record;
+	});
+}
+/**
+* Convert content data for reading: Portable Text arrays -> Markdown strings.
+* Converts top-level `portableText` arrays and nested `portableText` arrays
+* inside `blocks` arrays.
+*/
+function convertDataForRead(data, fields, raw = false) {
+	if (raw) return data;
+	const result = { ...data };
+	for (const field of fields) if (field.type === "portableText" && Array.isArray(result[field.slug])) result[field.slug] = portableTextToMarkdown(result[field.slug]);
+	else if (field.type === "blocks" && Array.isArray(result[field.slug])) result[field.slug] = convertNestedBlockPortableText(result[field.slug], field, "read");
+	return result;
+}
+/**
+* Convert content data for writing: Markdown strings -> Portable Text arrays.
+* Converts top-level `portableText` strings and nested Markdown strings
+* in `portableText` fields inside `blocks` arrays.
+*/
+function convertDataForWrite(data, fields) {
+	const result = { ...data };
+	for (const field of fields) if (field.type === "portableText" && typeof result[field.slug] === "string") result[field.slug] = markdownToPortableText(result[field.slug]);
+	else if (field.type === "blocks" && Array.isArray(result[field.slug])) result[field.slug] = convertNestedBlockPortableText(result[field.slug], field, "write");
+	return result;
+}
+
+//#endregion
+export { portableTextToMarkdown as i, convertDataForWrite as n, markdownToPortableText as r, convertDataForRead as t };
+//# sourceMappingURL=portable-text-BH4zgkSm.mjs.map

package/dist/portable-text-BH4zgkSm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable-text-BH4zgkSm.mjs","names":[],"sources":["../src/client/portable-text.ts"],"sourcesContent":["/**\n * Portable Text <-> Markdown conversion layer.\n *\n * Three tiers of block handling:\n *   Tier 1: Standard PT blocks <-> standard Markdown (headings, paragraphs, lists, etc.)\n *   Tier 2: EmDash custom blocks <-> Markdown directives (future)\n *   Tier 3: Unknown blocks <-> opaque HTML comment fences (preserved, not editable)\n */\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** Minimal Portable Text block shape */\nexport interface PortableTextBlock {\n\t_type: string;\n\t_key?: string;\n\tstyle?: string;\n\tlevel?: number;\n\tlistItem?: string;\n\tmarkDefs?: MarkDef[];\n\tchildren?: PortableTextSpan[];\n\t[key: string]: unknown;\n}\n\ninterface PortableTextSpan {\n\t_type: string;\n\t_key?: string;\n\ttext?: string;\n\tmarks?: string[];\n\t[key: string]: unknown;\n}\n\ninterface MarkDef {\n\t_key: string;\n\t_type: string;\n\thref?: string;\n\t[key: string]: unknown;\n}\n\ninterface ParsedInline {\n\tspans: PortableTextSpan[];\n\tmarkDefs: MarkDef[];\n}\n\n// ---------------------------------------------------------------------------\n// PT -> Markdown\n// ---------------------------------------------------------------------------\n\n/**\n * Convert Portable Text blocks to Markdown.\n * Unknown block types are serialized as opaque fences.\n */\nexport function portableTextToMarkdown(blocks: PortableTextBlock[]): string {\n\tconst lines: string[] = [];\n\tlet prevWasList = false;\n\n\tfor (let i = 0; i < blocks.length; i++) {\n\t\tconst block = blocks[i];\n\n\t\tif (block._type === \"block\") {\n\t\t\tconst isList = !!block.listItem;\n\n\t\t\t// Blank line between non-contiguous block types\n\t\t\tif (i > 0 && (!isList || !prevWasList)) {\n\t\t\t\tlines.push(\"\");\n\t\t\t}\n\n\t\t\tlines.push(renderStandardBlock(block));\n\t\t\tprevWasList = isList;\n\t\t} else if (block._type === \"code\") {\n\t\t\tif (i > 0) lines.push(\"\");\n\t\t\tconst lang = (block.language as string) || \"\";\n\t\t\tconst code = (block.code as string) || \"\";\n\t\t\tlines.push(\"```\" + lang);\n\t\t\tlines.push(code);\n\t\t\tlines.push(\"```\");\n\t\t\tprevWasList = false;\n\t\t} else if (block._type === \"image\") {\n\t\t\tif (i > 0) lines.push(\"\");\n\t\t\tconst alt = (block.alt as string) || \"\";\n\t\t\tconst url = (block.asset as { url?: string })?.url || \"\";\n\t\t\tlines.push(`![${alt}](${url})`);\n\t\t\tprevWasList = false;\n\t\t} else {\n\t\t\t// Tier 3: Unknown block -> opaque fence\n\t\t\tif (i > 0) lines.push(\"\");\n\t\t\tlines.push(`<!--ec:block ${JSON.stringify(block)} -->`);\n\t\t\tprevWasList = false;\n\t\t}\n\t}\n\n\treturn lines.join(\"\\n\") + \"\\n\";\n}\n\nfunction renderStandardBlock(block: PortableTextBlock): string {\n\tconst text = renderSpans(block.children ?? [], block.markDefs ?? []);\n\n\t// List items\n\tif (block.listItem) {\n\t\tconst indent = \"  \".repeat(Math.max(0, (block.level ?? 1) - 1));\n\t\tconst marker = block.listItem === \"number\" ? \"1.\" : \"-\";\n\t\treturn `${indent}${marker} ${text}`;\n\t}\n\n\t// Headings\n\tif (block.style && block.style.startsWith(\"h\")) {\n\t\tconst level = parseInt(block.style.substring(1), 10);\n\t\tif (level >= 1 && level <= 6) {\n\t\t\treturn `${\"#\".repeat(level)} ${text}`;\n\t\t}\n\t}\n\n\t// Blockquote\n\tif (block.style === \"blockquote\") {\n\t\treturn `> ${text}`;\n\t}\n\n\treturn text;\n}\n\nfunction renderSpans(spans: PortableTextSpan[], markDefs: MarkDef[]): string {\n\tlet result = \"\";\n\n\tfor (const span of spans) {\n\t\tif (span._type !== \"span\") continue;\n\n\t\tlet text = span.text ?? \"\";\n\t\tconst marks = span.marks ?? [];\n\n\t\tfor (const mark of marks) {\n\t\t\tconst def = markDefs.find((d) => d._key === mark);\n\t\t\tif (def) {\n\t\t\t\tif (def._type === \"link\") {\n\t\t\t\t\ttext = `[${text}](${def.href ?? \"\"})`;\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tswitch (mark) {\n\t\t\t\t\tcase \"strong\":\n\t\t\t\t\t\ttext = `**${text}**`;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase \"em\":\n\t\t\t\t\t\ttext = `_${text}_`;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase \"code\":\n\t\t\t\t\t\ttext = `\\`${text}\\``;\n\t\t\t\t\t\tbreak;\n\t\t\t\t\tcase \"strike-through\":\n\t\t\t\t\tcase \"strikethrough\":\n\t\t\t\t\t\ttext = `~~${text}~~`;\n\t\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tresult += text;\n\t}\n\n\treturn result;\n}\n\n// ---------------------------------------------------------------------------\n// Markdown -> PT\n// ---------------------------------------------------------------------------\n\n// Regex patterns for markdown parsing\nconst OPAQUE_FENCE_PATTERN = /^<!--ec:block (.+) -->$/;\nconst HEADING_PATTERN = /^(#{1,6})\\s+(.+)$/;\nconst UNORDERED_LIST_PATTERN = /^(\\s*)[-*+]\\s+(.+)$/;\nconst ORDERED_LIST_PATTERN = /^(\\s*)\\d+\\.\\s+(.+)$/;\nconst IMAGE_PATTERN = /^!\\[([^\\]]*)\\]\\(([^)]+)\\)$/;\nconst INLINE_MARKDOWN_PATTERN =\n\t/(\\*\\*(.+?)\\*\\*)|(_(.+?)_)|(`(.+?)`)|(\\[(.+?)\\]\\((.+?)\\))|(~~(.+?)~~)/g;\n\n/**\n * Convert Markdown to Portable Text blocks.\n * Opaque fences (<!--ec:block ... -->) are deserialized and spliced back in.\n */\nexport function markdownToPortableText(markdown: string): PortableTextBlock[] {\n\tconst blocks: PortableTextBlock[] = [];\n\tconst lines = markdown.split(\"\\n\");\n\tlet i = 0;\n\n\twhile (i < lines.length) {\n\t\tconst line = lines[i];\n\n\t\t// Opaque fence\n\t\tconst opaqueMatch = line.match(OPAQUE_FENCE_PATTERN);\n\t\tif (opaqueMatch) {\n\t\t\ttry {\n\t\t\t\tblocks.push(JSON.parse(opaqueMatch[1]) as PortableTextBlock);\n\t\t\t} catch {\n\t\t\t\tblocks.push(makeBlock(line));\n\t\t\t}\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Code fence\n\t\tif (line.startsWith(\"```\")) {\n\t\t\tconst lang = line.slice(3).trim();\n\t\t\tconst codeLines: string[] = [];\n\t\t\ti++;\n\t\t\twhile (i < lines.length && !lines[i].startsWith(\"```\")) {\n\t\t\t\tcodeLines.push(lines[i]);\n\t\t\t\ti++;\n\t\t\t}\n\t\t\tblocks.push({\n\t\t\t\t_type: \"code\",\n\t\t\t\t_key: generateKey(),\n\t\t\t\tlanguage: lang || undefined,\n\t\t\t\tcode: codeLines.join(\"\\n\"),\n\t\t\t});\n\t\t\ti++; // skip closing ```\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Blank line\n\t\tif (line.trim() === \"\") {\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Heading\n\t\tconst headingMatch = line.match(HEADING_PATTERN);\n\t\tif (headingMatch) {\n\t\t\tblocks.push(makeBlock(headingMatch[2], `h${headingMatch[1].length}`));\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Blockquote\n\t\tif (line.startsWith(\"> \")) {\n\t\t\tblocks.push(makeBlock(line.slice(2), \"blockquote\"));\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Unordered list\n\t\tconst ulMatch = line.match(UNORDERED_LIST_PATTERN);\n\t\tif (ulMatch) {\n\t\t\tconst level = Math.floor(ulMatch[1].length / 2) + 1;\n\t\t\tblocks.push(makeListBlock(ulMatch[2], \"bullet\", level));\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Ordered list\n\t\tconst olMatch = line.match(ORDERED_LIST_PATTERN);\n\t\tif (olMatch) {\n\t\t\tconst level = Math.floor(olMatch[1].length / 2) + 1;\n\t\t\tblocks.push(makeListBlock(olMatch[2], \"number\", level));\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Image\n\t\tconst imgMatch = line.match(IMAGE_PATTERN);\n\t\tif (imgMatch) {\n\t\t\tblocks.push({\n\t\t\t\t_type: \"image\",\n\t\t\t\t_key: generateKey(),\n\t\t\t\talt: imgMatch[1],\n\t\t\t\tasset: { url: imgMatch[2] },\n\t\t\t});\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Paragraph\n\t\tblocks.push(makeBlock(line));\n\t\ti++;\n\t}\n\n\treturn blocks;\n}\n\n// ---------------------------------------------------------------------------\n// Block builders\n// ---------------------------------------------------------------------------\n\nfunction makeBlock(text: string, style: string = \"normal\"): PortableTextBlock {\n\tconst { spans, markDefs } = parseInline(text);\n\treturn { _type: \"block\", _key: generateKey(), style, markDefs, children: spans };\n}\n\nfunction makeListBlock(text: string, listItem: string, level: number): PortableTextBlock {\n\tconst { spans, markDefs } = parseInline(text);\n\treturn {\n\t\t_type: \"block\",\n\t\t_key: generateKey(),\n\t\tstyle: \"normal\",\n\t\tlistItem,\n\t\tlevel,\n\t\tmarkDefs,\n\t\tchildren: spans,\n\t};\n}\n\n/**\n * Parse inline markdown (bold, italic, code, links, strikethrough) into PT spans + markDefs.\n */\nfunction parseInline(text: string): ParsedInline {\n\tconst spans: PortableTextSpan[] = [];\n\tconst markDefs: MarkDef[] = [];\n\tconst regex = INLINE_MARKDOWN_PATTERN;\n\n\tlet lastIndex = 0;\n\tlet match: RegExpExecArray | null;\n\n\twhile ((match = regex.exec(text)) !== null) {\n\t\tif (match.index > lastIndex) {\n\t\t\tspans.push({\n\t\t\t\t_type: \"span\",\n\t\t\t\t_key: generateKey(),\n\t\t\t\ttext: text.slice(lastIndex, match.index),\n\t\t\t\tmarks: [],\n\t\t\t});\n\t\t}\n\n\t\tif (match[2] != null) {\n\t\t\tspans.push({ _type: \"span\", _key: generateKey(), text: match[2], marks: [\"strong\"] });\n\t\t} else if (match[4] != null) {\n\t\t\tspans.push({ _type: \"span\", _key: generateKey(), text: match[4], marks: [\"em\"] });\n\t\t} else if (match[6] != null) {\n\t\t\tspans.push({ _type: \"span\", _key: generateKey(), text: match[6], marks: [\"code\"] });\n\t\t} else if (match[8] != null && match[9] != null) {\n\t\t\tconst key = generateKey();\n\t\t\tmarkDefs.push({ _key: key, _type: \"link\", href: match[9] });\n\t\t\tspans.push({ _type: \"span\", _key: generateKey(), text: match[8], marks: [key] });\n\t\t} else if (match[11] != null) {\n\t\t\tspans.push({\n\t\t\t\t_type: \"span\",\n\t\t\t\t_key: generateKey(),\n\t\t\t\ttext: match[11],\n\t\t\t\tmarks: [\"strike-through\"],\n\t\t\t});\n\t\t}\n\n\t\tlastIndex = match.index + match[0].length;\n\t}\n\n\tif (lastIndex < text.length) {\n\t\tspans.push({ _type: \"span\", _key: generateKey(), text: text.slice(lastIndex), marks: [] });\n\t}\n\n\tif (spans.length === 0) {\n\t\tspans.push({ _type: \"span\", _key: generateKey(), text, marks: [] });\n\t}\n\n\treturn { spans, markDefs };\n}\n\n// ---------------------------------------------------------------------------\n// Key generation\n// ---------------------------------------------------------------------------\n\nlet keyCounter = 0;\n\nfunction generateKey(): string {\n\treturn `k${(keyCounter++).toString(36)}`;\n}\n\n/** Reset key counter (useful for testing) */\nexport function resetKeyCounter(): void {\n\tkeyCounter = 0;\n}\n\n// ---------------------------------------------------------------------------\n// Schema-aware conversion helpers\n// ---------------------------------------------------------------------------\n\nexport interface FieldSchema {\n\tslug: string;\n\ttype: string;\n\tvalidation?: unknown;\n\tblockTypes?: Array<{\n\t\tslug: string;\n\t\tcurrentVersion: number;\n\t\tversions: Array<{\n\t\t\tversion: number;\n\t\t\tfields: Array<{ slug: string; type: string }>;\n\t\t}>;\n\t}>;\n}\n\nfunction convertNestedBlockPortableText(\n\tvalue: unknown,\n\tfield: FieldSchema,\n\tdirection: \"read\" | \"write\",\n): unknown {\n\tif (!Array.isArray(value)) return value;\n\tconst validation = field.validation;\n\tconst allowedTypes =\n\t\tvalidation && typeof validation === \"object\" && \"allowedTypes\" in validation\n\t\t\t? validation.allowedTypes\n\t\t\t: undefined;\n\treturn value.map((block) => {\n\t\tif (!block || typeof block !== \"object\" || Array.isArray(block)) return block;\n\t\tconst record = { ...block };\n\t\tconst type =\n\t\t\trecord._type === undefined &&\n\t\t\tdirection === \"write\" &&\n\t\t\tArray.isArray(allowedTypes) &&\n\t\t\tallowedTypes.length === 1\n\t\t\t\t? allowedTypes[0]\n\t\t\t\t: record._type;\n\t\tconst version = typeof record._version === \"number\" ? record._version : undefined;\n\t\tconst blockType = field.blockTypes?.find((candidate) => candidate.slug === type);\n\t\tconst definition = blockType?.versions.find(\n\t\t\t(candidate) => candidate.version === (version ?? blockType.currentVersion),\n\t\t);\n\t\tif (!definition) return block;\n\t\tfor (const nestedField of definition.fields) {\n\t\t\tif (nestedField.type !== \"portableText\") continue;\n\t\t\tconst nestedValue = record[nestedField.slug];\n\t\t\tif (direction === \"read\" && Array.isArray(nestedValue)) {\n\t\t\t\trecord[nestedField.slug] = portableTextToMarkdown(nestedValue as PortableTextBlock[]);\n\t\t\t} else if (direction === \"write\" && typeof nestedValue === \"string\") {\n\t\t\t\trecord[nestedField.slug] = markdownToPortableText(nestedValue);\n\t\t\t}\n\t\t}\n\t\treturn record;\n\t});\n}\n\n/**\n * Convert content data for reading: Portable Text arrays -> Markdown strings.\n * Converts top-level `portableText` arrays and nested `portableText` arrays\n * inside `blocks` arrays.\n */\nexport function convertDataForRead(\n\tdata: Record<string, unknown>,\n\tfields: FieldSchema[],\n\traw: boolean = false,\n): Record<string, unknown> {\n\tif (raw) return data;\n\n\tconst result = { ...data };\n\tfor (const field of fields) {\n\t\tif (field.type === \"portableText\" && Array.isArray(result[field.slug])) {\n\t\t\tresult[field.slug] = portableTextToMarkdown(result[field.slug] as PortableTextBlock[]);\n\t\t} else if (field.type === \"blocks\" && Array.isArray(result[field.slug])) {\n\t\t\tresult[field.slug] = convertNestedBlockPortableText(result[field.slug], field, \"read\");\n\t\t}\n\t}\n\treturn result;\n}\n\n/**\n * Convert content data for writing: Markdown strings -> Portable Text arrays.\n * Converts top-level `portableText` strings and nested Markdown strings\n * in `portableText` fields inside `blocks` arrays.\n */\nexport function convertDataForWrite(\n\tdata: Record<string, unknown>,\n\tfields: FieldSchema[],\n): Record<string, unknown> {\n\tconst result = { ...data };\n\tfor (const field of fields) {\n\t\tif (field.type === \"portableText\" && typeof result[field.slug] === \"string\") {\n\t\t\tresult[field.slug] = markdownToPortableText(result[field.slug] as string);\n\t\t} else if (field.type === \"blocks\" && Array.isArray(result[field.slug])) {\n\t\t\tresult[field.slug] = convertNestedBlockPortableText(result[field.slug], field, \"write\");\n\t\t}\n\t}\n\treturn result;\n}\n"],"mappings":"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"}

package/dist/preview-DLexxwp3.mjs

@@ -0,0 +1,107 @@
+import { t as generatePreviewToken } from "./tokens-BnhSnGwJ.mjs";
+
+//#region src/preview/urls.ts
+/**
+* Preview URL generation
+*
+* Creates preview URLs that include a signed token for accessing draft content.
+*/
+const REPEATED_SLASHES = /\/{2,}/g;
+/**
+* Generate a preview URL for content
+*
+* The URL includes a `_preview` query parameter with a signed token.
+*
+* @example
+* ```ts
+* const url = await getPreviewUrl({
+*   collection: "posts",
+*   id: "hello-world",
+*   secret: process.env.PREVIEW_SECRET!,
+* });
+* // Returns: /posts/hello-world?_preview=eyJj...
+*
+* // With base URL:
+* const fullUrl = await getPreviewUrl({
+*   collection: "posts",
+*   id: "hello-world",
+*   secret: process.env.PREVIEW_SECRET!,
+*   baseUrl: "https://example.com",
+* });
+* // Returns: https://example.com/posts/hello-world?_preview=eyJj...
+*
+* // Custom path pattern:
+* const customUrl = await getPreviewUrl({
+*   collection: "posts",
+*   id: "hello-world",
+*   secret: process.env.PREVIEW_SECRET!,
+*   pathPattern: "/blog/{id}",
+* });
+* // Returns: /blog/hello-world?_preview=eyJj...
+* ```
+*/
+async function getPreviewUrl(options) {
+	const { collection, id, secret, expiresIn = "1h", baseUrl, pathPattern = "/{collection}/{id}", locale = "" } = options;
+	const token = await generatePreviewToken({
+		contentId: `${collection}:${id}`,
+		expiresIn,
+		secret
+	});
+	let path = pathPattern.replace("{collection}", collection).replace("{id}", id).replace("{locale}", locale);
+	path = path.replace(REPEATED_SLASHES, "/");
+	if (path.length > 1 && path.endsWith("/")) path = path.slice(0, -1);
+	const url = new URL(path, baseUrl || "http://placeholder");
+	url.searchParams.set("_preview", token);
+	if (!baseUrl) return `${url.pathname}${url.search}`;
+	return url.toString();
+}
+/**
+* Build a preview URL from a token (when you already have the token)
+*
+* @example
+* ```ts
+* const url = buildPreviewUrl({
+*   path: "/posts/hello-world",
+*   token: existingToken,
+* });
+* ```
+*/
+function buildPreviewUrl(options) {
+	const { path, token, baseUrl } = options;
+	const url = new URL(path, baseUrl || "http://placeholder");
+	url.searchParams.set("_preview", token);
+	if (!baseUrl) return `${url.pathname}${url.search}`;
+	return url.toString();
+}
+
+//#endregion
+//#region src/preview/helpers.ts
+/**
+* Preview helpers for Astro pages
+*/
+/**
+* Check if a request is a preview request
+*
+* @example
+* ```ts
+* const isPreview = isPreviewRequest(Astro.url);
+* ```
+*/
+function isPreviewRequest(url) {
+	return url.searchParams.has("_preview");
+}
+/**
+* Get the preview token from a URL
+*
+* @example
+* ```ts
+* const token = getPreviewToken(Astro.url);
+* ```
+*/
+function getPreviewToken(url) {
+	return url.searchParams.get("_preview");
+}
+
+//#endregion
+export { getPreviewUrl as i, isPreviewRequest as n, buildPreviewUrl as r, getPreviewToken as t };
+//# sourceMappingURL=preview-DLexxwp3.mjs.map

package/dist/preview-DLexxwp3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-DLexxwp3.mjs","names":[],"sources":["../src/preview/urls.ts","../src/preview/helpers.ts"],"sourcesContent":["/**\n * Preview URL generation\n *\n * Creates preview URLs that include a signed token for accessing draft content.\n */\n\nimport { generatePreviewToken } from \"./tokens.js\";\n\nconst REPEATED_SLASHES = /\\/{2,}/g;\n\n/**\n * Options for generating a preview URL\n */\nexport interface GetPreviewUrlOptions {\n\t/** Collection slug (e.g., \"posts\") */\n\tcollection: string;\n\t/** Content ID or slug */\n\tid: string;\n\t/** Secret key for signing the token */\n\tsecret: string;\n\t/** How long the preview URL is valid. Default: \"1h\" */\n\texpiresIn?: string | number;\n\t/** Base URL of the site. If not provided, returns a relative URL. */\n\tbaseUrl?: string;\n\t/**\n\t * Custom path pattern. Supports `{collection}`, `{id}` and `{locale}`\n\t * placeholders. Default: `\"/{collection}/{id}\"`.\n\t */\n\tpathPattern?: string;\n\t/**\n\t * Locale segment substituted for the `{locale}` placeholder in `pathPattern`.\n\t * Pass an empty string to omit the locale prefix (e.g. for the default locale\n\t * when `prefixDefaultLocale` is `false`); adjacent slashes left by an empty\n\t * value are collapsed and any trailing slash is trimmed.\n\t */\n\tlocale?: string;\n}\n\n/**\n * Generate a preview URL for content\n *\n * The URL includes a `_preview` query parameter with a signed token.\n *\n * @example\n * ```ts\n * const url = await getPreviewUrl({\n *   collection: \"posts\",\n *   id: \"hello-world\",\n *   secret: process.env.PREVIEW_SECRET!,\n * });\n * // Returns: /posts/hello-world?_preview=eyJj...\n *\n * // With base URL:\n * const fullUrl = await getPreviewUrl({\n *   collection: \"posts\",\n *   id: \"hello-world\",\n *   secret: process.env.PREVIEW_SECRET!,\n *   baseUrl: \"https://example.com\",\n * });\n * // Returns: https://example.com/posts/hello-world?_preview=eyJj...\n *\n * // Custom path pattern:\n * const customUrl = await getPreviewUrl({\n *   collection: \"posts\",\n *   id: \"hello-world\",\n *   secret: process.env.PREVIEW_SECRET!,\n *   pathPattern: \"/blog/{id}\",\n * });\n * // Returns: /blog/hello-world?_preview=eyJj...\n * ```\n */\nexport async function getPreviewUrl(options: GetPreviewUrlOptions): Promise<string> {\n\tconst {\n\t\tcollection,\n\t\tid,\n\t\tsecret,\n\t\texpiresIn = \"1h\",\n\t\tbaseUrl,\n\t\tpathPattern = \"/{collection}/{id}\",\n\t\tlocale = \"\",\n\t} = options;\n\n\t// Generate the signed token\n\tconst token = await generatePreviewToken({\n\t\tcontentId: `${collection}:${id}`,\n\t\texpiresIn,\n\t\tsecret,\n\t});\n\n\t// Build the path. `{locale}` may resolve to an empty string (default locale\n\t// without a prefix); collapse the resulting double slashes and trim a\n\t// trailing slash so the URL stays clean.\n\tlet path = pathPattern\n\t\t.replace(\"{collection}\", collection)\n\t\t.replace(\"{id}\", id)\n\t\t.replace(\"{locale}\", locale);\n\tpath = path.replace(REPEATED_SLASHES, \"/\");\n\tif (path.length > 1 && path.endsWith(\"/\")) path = path.slice(0, -1);\n\n\t// Add token as query parameter\n\tconst url = new URL(path, baseUrl || \"http://placeholder\");\n\turl.searchParams.set(\"_preview\", token);\n\n\t// Return relative URL if no baseUrl provided\n\tif (!baseUrl) {\n\t\treturn `${url.pathname}${url.search}`;\n\t}\n\n\treturn url.toString();\n}\n\n/**\n * Build a preview URL from a token (when you already have the token)\n *\n * @example\n * ```ts\n * const url = buildPreviewUrl({\n *   path: \"/posts/hello-world\",\n *   token: existingToken,\n * });\n * ```\n */\nexport function buildPreviewUrl(options: {\n\tpath: string;\n\ttoken: string;\n\tbaseUrl?: string;\n}): string {\n\tconst { path, token, baseUrl } = options;\n\n\tconst url = new URL(path, baseUrl || \"http://placeholder\");\n\turl.searchParams.set(\"_preview\", token);\n\n\tif (!baseUrl) {\n\t\treturn `${url.pathname}${url.search}`;\n\t}\n\n\treturn url.toString();\n}\n","/**\n * Preview helpers for Astro pages\n */\n\n/**\n * Check if a request is a preview request\n *\n * @example\n * ```ts\n * const isPreview = isPreviewRequest(Astro.url);\n * ```\n */\nexport function isPreviewRequest(url: URL): boolean {\n\treturn url.searchParams.has(\"_preview\");\n}\n\n/**\n * Get the preview token from a URL\n *\n * @example\n * ```ts\n * const token = getPreviewToken(Astro.url);\n * ```\n */\nexport function getPreviewToken(url: URL): string | null {\n\treturn url.searchParams.get(\"_preview\");\n}\n"],"mappings":";;;;;;;;AAQA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+DzB,eAAsB,cAAc,SAAgD;CACnF,MAAM,EACL,YACA,IACA,QACA,YAAY,MACZ,SACA,cAAc,sBACd,SAAS,OACN;CAGJ,MAAM,QAAQ,MAAM,qBAAqB;EACxC,WAAW,GAAG,WAAW,GAAG;EAC5B;EACA;EACA,CAAC;CAKF,IAAI,OAAO,YACT,QAAQ,gBAAgB,WAAW,CACnC,QAAQ,QAAQ,GAAG,CACnB,QAAQ,YAAY,OAAO;AAC7B,QAAO,KAAK,QAAQ,kBAAkB,IAAI;AAC1C,KAAI,KAAK,SAAS,KAAK,KAAK,SAAS,IAAI,CAAE,QAAO,KAAK,MAAM,GAAG,GAAG;CAGnE,MAAM,MAAM,IAAI,IAAI,MAAM,WAAW,qBAAqB;AAC1D,KAAI,aAAa,IAAI,YAAY,MAAM;AAGvC,KAAI,CAAC,QACJ,QAAO,GAAG,IAAI,WAAW,IAAI;AAG9B,QAAO,IAAI,UAAU;;;;;;;;;;;;;AActB,SAAgB,gBAAgB,SAIrB;CACV,MAAM,EAAE,MAAM,OAAO,YAAY;CAEjC,MAAM,MAAM,IAAI,IAAI,MAAM,WAAW,qBAAqB;AAC1D,KAAI,aAAa,IAAI,YAAY,MAAM;AAEvC,KAAI,CAAC,QACJ,QAAO,GAAG,IAAI,WAAW,IAAI;AAG9B,QAAO,IAAI,UAAU;;;;;;;;;;;;;;;;AC5HtB,SAAgB,iBAAiB,KAAmB;AACnD,QAAO,IAAI,aAAa,IAAI,WAAW;;;;;;;;;;AAWxC,SAAgB,gBAAgB,KAAyB;AACxD,QAAO,IAAI,aAAa,IAAI,WAAW"}

package/dist/protocol-79kUO7jP.d.mts

@@ -0,0 +1,65 @@
+import { t as I18nConfig } from "./config-CFMojMFK.mjs";
+
+//#region src/migrations/protocol.d.ts
+type MigrationAction = "check" | "apply" | "release-lock" | "take-over-lock";
+interface MigrationRequest {
+  action: MigrationAction;
+  i18n: I18nConfig | null;
+  artifact: {
+    emdashVersion: string;
+    migrationSetFingerprint: string;
+  };
+  /**
+   * For `release-lock` and `take-over-lock`: the lock id a `check` reported.
+   * Another lock is left alone. `take-over-lock` applies pending migrations
+   * under that lock without freeing it first.
+   */
+  lockId?: string;
+}
+interface MigrationLockReport {
+  id: string;
+  /** ISO 8601 time the lock was taken. */
+  heldSince: string;
+}
+interface MigrationTarget {
+  kind: string;
+  label: string;
+  fingerprint: string;
+  accountId?: string;
+  environment?: string;
+  resourceId?: string;
+}
+interface MigrationReport {
+  target: MigrationTarget;
+  knownApplied: string[];
+  pending: string[];
+  unknownApplied: string[];
+  executed: string[];
+  /** Present on `check` while a migration lock is held. */
+  lock?: MigrationLockReport;
+}
+interface MigrationExecutor {
+  target: MigrationTarget;
+  execute(request: MigrationRequest): Promise<MigrationReport>;
+  dispose?(): Promise<void>;
+}
+interface MigrationTargetOverrides {
+  database?: string;
+  databaseUrlEnv?: string;
+  d1?: string;
+  accountId?: string;
+  wranglerConfig?: string;
+  wranglerEnv?: string;
+}
+interface MigrationExecutorFactoryContext {
+  projectRoot: string;
+  env: Readonly<Record<string, string | undefined>>;
+  overrides?: Readonly<MigrationTargetOverrides>;
+}
+type MigrationExecutorFactory<ManifestConfig = unknown> = (manifestConfig: ManifestConfig, context: MigrationExecutorFactoryContext) => MigrationExecutor | Promise<MigrationExecutor>;
+interface MigrationExecutorModule<ManifestConfig = unknown> {
+  createMigrationExecutor: MigrationExecutorFactory<ManifestConfig>;
+}
+//#endregion
+export { MigrationExecutorModule as a, MigrationRequest as c, MigrationExecutorFactoryContext as i, MigrationTarget as l, MigrationExecutor as n, MigrationLockReport as o, MigrationExecutorFactory as r, MigrationReport as s, MigrationAction as t, MigrationTargetOverrides as u };
+//# sourceMappingURL=protocol-79kUO7jP.d.mts.map

package/dist/protocol-79kUO7jP.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol-79kUO7jP.d.mts","names":[],"sources":["../src/migrations/protocol.ts"],"mappings":";;;KAEY,eAAA;AAAA,UAEK,gBAAA;EAChB,MAAA,EAAQ,eAAA;EACR,IAAA,EAAM,UAAA;EACN,QAAA;IACC,aAAA;IACA,uBAAA;EAAA;EAL+B;;;;;EAYhC,MAAA;AAAA;AAAA,UAGgB,mBAAA;EAChB,EAAA;EAXC;EAaD,SAAA;AAAA;AAAA,UAGgB,eAAA;EAChB,IAAA;EACA,KAAA;EACA,WAAA;EACA,SAAA;EACA,WAAA;EACA,UAAA;AAAA;AAAA,UAGgB,eAAA;EAChB,MAAA,EAAQ,eAAA;EACR,YAAA;EACA,OAAA;EACA,cAAA;EACA,QAAA;EATA;EAWA,IAAA,GAAO,mBAAA;AAAA;AAAA,UAGS,iBAAA;EAChB,MAAA,EAAQ,eAAA;EACR,OAAA,CAAQ,OAAA,EAAS,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAC5C,OAAA,KAAY,OAAA;AAAA;AAAA,UAGI,wBAAA;EAChB,QAAA;EACA,cAAA;EACA,EAAA;EACA,SAAA;EACA,cAAA;EACA,WAAA;AAAA;AAAA,UAGgB,+BAAA;EAChB,WAAA;EACA,GAAA,EAAK,QAAA,CAAS,MAAA;EACd,SAAA,GAAY,QAAA,CAAS,wBAAA;AAAA;AAAA,KAGV,wBAAA,8BACX,cAAA,EAAgB,cAAA,EAChB,OAAA,EAAS,+BAAA,KACL,iBAAA,GAAoB,OAAA,CAAQ,iBAAA;AAAA,UAEhB,uBAAA;EAChB,uBAAA,EAAyB,wBAAA,CAAyB,cAAA;AAAA"}