@temelj/mdx 0.13.0 → 0.15.0

package/dist/plugins/shiki.mjs

@@ -0,0 +1,144 @@
+import { codeLineSelected } from "./code-block-metadata.mjs";
+import { isBoolean, isNumber, isString } from "@temelj/value";
+//#region src/plugins/shiki.ts
+const specialLanguages = /* @__PURE__ */ new Set([
+	"ansi",
+	"plain",
+	"plaintext",
+	"text",
+	"txt"
+]);
+/** Adapts a caller-owned, preloaded Shiki highlighter to Temelj's code highlighter. */
+function createShikiHighlighter(highlighter, options) {
+	const { commandLineClassName = "line-command", fallbackLanguage, highlightedLineClassName = "highlighted", includeDataAttributes = [], languageAliases = {}, lineNumberClassName = "line-number", lineNumberWidthProperty = "--line-number-width", ...codeOptions } = options;
+	const loadedLanguages = new Set(highlighter.getLoadedLanguages().map((language) => language.toLowerCase()));
+	const aliases = /* @__PURE__ */ new Map();
+	for (const [from, to] of Object.entries(languageAliases)) aliases.set(from.toLowerCase(), to.toLowerCase());
+	return {
+		kind: "synchronous",
+		highlight(request) {
+			request.signal?.throwIfAborted();
+			const language = resolveLanguage(request.language, aliases, fallbackLanguage, loadedLanguages);
+			if (language === void 0) return;
+			const root = highlighter.codeToHast(request.code, {
+				...codeOptions,
+				lang: language,
+				meta: request.metadata.raw === void 0 ? void 0 : { __raw: request.metadata.raw },
+				structure: "classic"
+			});
+			request.signal?.throwIfAborted();
+			const pre = onlyPreElement(root.children);
+			decorateCodeBlock(pre, request, {
+				commandLineClassName,
+				highlightedLineClassName,
+				includeDataAttributes,
+				lineNumberClassName,
+				lineNumberWidthProperty
+			});
+			return convertElement(pre);
+		}
+	};
+}
+function resolveLanguage(authored, aliases, fallback, loaded) {
+	const normalized = authored.toLowerCase();
+	const requested = aliases.get(normalized) ?? normalized;
+	if (isAvailableLanguage(requested, loaded)) return requested;
+	const normalizedFallback = fallback?.toLowerCase();
+	return normalizedFallback !== void 0 && isAvailableLanguage(normalizedFallback, loaded) ? normalizedFallback : void 0;
+}
+function isAvailableLanguage(language, loaded) {
+	return language.length > 0 && (loaded.has(language) || specialLanguages.has(language));
+}
+function onlyPreElement(children) {
+	const first = children[0];
+	if (children.length !== 1 || first?.type !== "element" || first.tagName !== "pre") throw new TypeError("Shiki must return one classic pre element");
+	return first;
+}
+function decorateCodeBlock(pre, request, options) {
+	const code = pre.children.find((node) => node.type === "element" && node.tagName === "code");
+	if (code === void 0) throw new TypeError("Shiki pre element does not contain code");
+	addClass(code, `language-${request.language}`);
+	const lines = code.children.filter((node) => node.type === "element" && hasClass(node, "line"));
+	let largestLineNumber = 1;
+	for (const [index, line] of lines.entries()) {
+		const physicalLine = index + 1;
+		const displayedLine = (request.metadata.lineNumbers?.start ?? 1) + index;
+		line.properties["data-line"] = displayedLine;
+		if (request.metadata.highlightedLines !== void 0 && codeLineSelected(request.metadata.highlightedLines, physicalLine)) addClass(line, options.highlightedLineClassName);
+		if (request.metadata.lineNumbers !== void 0 && codeLineSelected(request.metadata.lineNumbers.lines, physicalLine)) {
+			addClass(line, options.lineNumberClassName);
+			largestLineNumber = Math.max(largestLineNumber, displayedLine);
+		}
+		if (request.metadata.commandLines !== void 0 && codeLineSelected(request.metadata.commandLines, physicalLine)) addClass(line, options.commandLineClassName);
+	}
+	if (request.metadata.fileName !== void 0) pre.properties["data-file-name"] = request.metadata.fileName;
+	if (request.metadata.lineNumbers !== void 0) {
+		const declaration = `${options.lineNumberWidthProperty}:${String(largestLineNumber).length}ch`;
+		const current = pre.properties.style;
+		pre.properties.style = isString(current) && current.length > 0 ? `${current.replace(/;?$/u, ";")}${declaration}` : declaration;
+	}
+	for (const attribute of options.includeDataAttributes) switch (attribute) {
+		case "language":
+			pre.properties["data-language"] = request.language;
+			break;
+		case "line-count":
+			pre.properties["data-line-count"] = lines.length;
+			break;
+		case "meta":
+			if (request.metadata.raw !== void 0) pre.properties["data-meta"] = request.metadata.raw;
+			break;
+		case "source-code":
+			pre.properties["data-source-code"] = request.code;
+			break;
+		default: return attribute;
+	}
+}
+function hasClass(element, name) {
+	const value = element.properties.class;
+	return isString(value) ? value.split(/\s+/u).includes(name) : Array.isArray(value) && value.includes(name);
+}
+function addClass(element, name) {
+	const value = element.properties.class;
+	const classes = isString(value) ? value.split(/\s+/u).filter((item) => item.length > 0) : Array.isArray(value) ? value.filter((item) => isString(item)) : [];
+	if (!classes.includes(name)) classes.push(name);
+	element.properties.class = classes;
+}
+function convertNode(node) {
+	switch (node.type) {
+		case "element": return convertElement(node);
+		case "text": return {
+			kind: "text",
+			value: node.value
+		};
+		default: throw new TypeError(`Shiki returned unsupported ${node.type} content`);
+	}
+}
+function convertElement(node) {
+	return {
+		kind: "element",
+		tagName: node.tagName,
+		attributes: convertProperties(node.properties),
+		children: node.children.map(convertNode)
+	};
+}
+function convertProperties(properties) {
+	const attributes = {};
+	for (const [name, value] of Object.entries(properties)) {
+		if (value === null || value === void 0) continue;
+		const attributeName = name === "className" ? "class" : name;
+		if (isBoolean(value) || isNumber(value) || isString(value)) {
+			attributes[attributeName] = value;
+			continue;
+		}
+		if (Array.isArray(value) && value.every((item) => isNumber(item) || isString(item))) {
+			attributes[attributeName] = value;
+			continue;
+		}
+		throw new TypeError(`Shiki returned an unsupported ${JSON.stringify(name)} property`);
+	}
+	return attributes;
+}
+//#endregion
+export { createShikiHighlighter };
+
+//# sourceMappingURL=shiki.mjs.map

package/dist/plugins/shiki.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shiki.mjs","names":["_exhaustive"],"sources":["../../src/plugins/shiki.ts"],"sourcesContent":["import type { CodeToHastOptions, HighlighterGeneric } from \"shiki/types\";\n\nimport { isString, isBoolean, isNumber } from \"@temelj/value\";\n\nimport type { HtmlAttributeValue, HtmlAttributes, HtmlElementNode, HtmlNode } from \"../html.ts\";\nimport type { SyntaxHighlighter, SyntaxHighlightRequest } from \"./syntax-highlight.ts\";\n\nimport { codeLineSelected } from \"./code-block-metadata.ts\";\n\ntype ShikiHighlighter = Pick<\n  HighlighterGeneric<string, string>,\n  \"codeToHast\" | \"getLoadedLanguages\"\n>;\n\ntype ShikiCodeToHastOptions<T> = T extends unknown ? Omit<T, \"lang\" | \"meta\" | \"structure\"> : never;\n\nexport type ShikiCodeOptions = ShikiCodeToHastOptions<CodeToHastOptions<string, string>>;\n\nexport type ShikiDataAttribute = \"language\" | \"line-count\" | \"meta\" | \"source-code\";\n\nexport type ShikiHighlighterOptions = ShikiCodeOptions &\n  Readonly<{\n    commandLineClassName?: string;\n    fallbackLanguage?: string;\n    highlightedLineClassName?: string;\n    includeDataAttributes?: readonly ShikiDataAttribute[];\n    languageAliases?: Readonly<Record<string, string>>;\n    lineNumberClassName?: string;\n    lineNumberWidthProperty?: string;\n  }>;\n\nconst specialLanguages = new Set([\"ansi\", \"plain\", \"plaintext\", \"text\", \"txt\"]);\n\n/** Adapts a caller-owned, preloaded Shiki highlighter to Temelj's code highlighter. */\nexport function createShikiHighlighter(\n  highlighter: ShikiHighlighter,\n  options: ShikiHighlighterOptions,\n): SyntaxHighlighter {\n  const {\n    commandLineClassName = \"line-command\",\n    fallbackLanguage,\n    highlightedLineClassName = \"highlighted\",\n    includeDataAttributes = [],\n    languageAliases = {},\n    lineNumberClassName = \"line-number\",\n    lineNumberWidthProperty = \"--line-number-width\",\n    ...codeOptions\n  } = options;\n\n  const loadedLanguages = new Set(\n    highlighter.getLoadedLanguages().map((language) => language.toLowerCase()),\n  );\n\n  const aliases = new Map<string, string>();\n\n  for (const [from, to] of Object.entries(languageAliases)) {\n    aliases.set(from.toLowerCase(), to.toLowerCase());\n  }\n\n  return {\n    kind: \"synchronous\",\n    highlight(request: SyntaxHighlightRequest) {\n      request.signal?.throwIfAborted();\n\n      const language = resolveLanguage(\n        request.language,\n        aliases,\n        fallbackLanguage,\n        loadedLanguages,\n      );\n\n      if (language === undefined) {\n        return;\n      }\n\n      const root = highlighter.codeToHast(request.code, {\n        ...codeOptions,\n        lang: language,\n        meta: request.metadata.raw === undefined ? undefined : { __raw: request.metadata.raw },\n        structure: \"classic\",\n      });\n\n      request.signal?.throwIfAborted();\n      const pre = onlyPreElement(root.children);\n      decorateCodeBlock(pre, request, {\n        commandLineClassName,\n        highlightedLineClassName,\n        includeDataAttributes,\n        lineNumberClassName,\n        lineNumberWidthProperty,\n      });\n\n      return convertElement(pre);\n    },\n  };\n}\n\ninterface DecorationOptions {\n  readonly commandLineClassName: string;\n  readonly highlightedLineClassName: string;\n  readonly includeDataAttributes: readonly ShikiDataAttribute[];\n  readonly lineNumberClassName: string;\n  readonly lineNumberWidthProperty: string;\n}\n\ntype ShikiRoot = ReturnType<ShikiHighlighter[\"codeToHast\"]>;\n\ntype ShikiNode = ShikiRoot[\"children\"][number];\n\ntype ShikiElement = Extract<ShikiNode, { type: \"element\" }>;\n\nfunction resolveLanguage(\n  authored: string,\n  aliases: ReadonlyMap<string, string>,\n  fallback: string | undefined,\n  loaded: ReadonlySet<string>,\n): string | undefined {\n  const normalized = authored.toLowerCase();\n  const requested = aliases.get(normalized) ?? normalized;\n\n  if (isAvailableLanguage(requested, loaded)) {\n    return requested;\n  }\n\n  const normalizedFallback = fallback?.toLowerCase();\n\n  return normalizedFallback !== undefined && isAvailableLanguage(normalizedFallback, loaded)\n    ? normalizedFallback\n    : undefined;\n}\n\nfunction isAvailableLanguage(language: string, loaded: ReadonlySet<string>): boolean {\n  return language.length > 0 && (loaded.has(language) || specialLanguages.has(language));\n}\n\nfunction onlyPreElement(children: ShikiRoot[\"children\"]): ShikiElement {\n  const first = children[0];\n\n  if (children.length !== 1 || first?.type !== \"element\" || first.tagName !== \"pre\") {\n    throw new TypeError(\"Shiki must return one classic pre element\");\n  }\n\n  return first;\n}\n\nfunction decorateCodeBlock(\n  pre: ShikiElement,\n  request: SyntaxHighlightRequest,\n  options: DecorationOptions,\n): void {\n  const code = pre.children.find(\n    (node): node is ShikiElement => node.type === \"element\" && node.tagName === \"code\",\n  );\n\n  if (code === undefined) {\n    throw new TypeError(\"Shiki pre element does not contain code\");\n  }\n\n  addClass(code, `language-${request.language}`);\n\n  const lines = code.children.filter(\n    (node): node is ShikiElement => node.type === \"element\" && hasClass(node, \"line\"),\n  );\n\n  let largestLineNumber = 1;\n\n  for (const [index, line] of lines.entries()) {\n    const physicalLine = index + 1;\n    const displayedLine = (request.metadata.lineNumbers?.start ?? 1) + index;\n    line.properties[\"data-line\"] = displayedLine;\n\n    if (\n      request.metadata.highlightedLines !== undefined &&\n      codeLineSelected(request.metadata.highlightedLines, physicalLine)\n    ) {\n      addClass(line, options.highlightedLineClassName);\n    }\n\n    if (\n      request.metadata.lineNumbers !== undefined &&\n      codeLineSelected(request.metadata.lineNumbers.lines, physicalLine)\n    ) {\n      addClass(line, options.lineNumberClassName);\n      largestLineNumber = Math.max(largestLineNumber, displayedLine);\n    }\n\n    if (\n      request.metadata.commandLines !== undefined &&\n      codeLineSelected(request.metadata.commandLines, physicalLine)\n    ) {\n      addClass(line, options.commandLineClassName);\n    }\n  }\n\n  if (request.metadata.fileName !== undefined) {\n    pre.properties[\"data-file-name\"] = request.metadata.fileName;\n  }\n\n  if (request.metadata.lineNumbers !== undefined) {\n    const declaration = `${options.lineNumberWidthProperty}:${String(largestLineNumber).length}ch`;\n    const current = pre.properties.style;\n    pre.properties.style =\n      isString(current) && current.length > 0\n        ? `${current.replace(/;?$/u, \";\")}${declaration}`\n        : declaration;\n  }\n\n  for (const attribute of options.includeDataAttributes) {\n    switch (attribute) {\n      case \"language\":\n        pre.properties[\"data-language\"] = request.language;\n        break;\n      case \"line-count\":\n        pre.properties[\"data-line-count\"] = lines.length;\n        break;\n      case \"meta\":\n        if (request.metadata.raw !== undefined) {\n          pre.properties[\"data-meta\"] = request.metadata.raw;\n        }\n\n        break;\n      case \"source-code\":\n        pre.properties[\"data-source-code\"] = request.code;\n        break;\n      default: {\n        const _exhaustive: never = attribute;\n\n        return _exhaustive;\n      }\n    }\n  }\n}\n\nfunction hasClass(element: ShikiElement, name: string): boolean {\n  const value = element.properties.class;\n\n  return isString(value)\n    ? value.split(/\\s+/u).includes(name)\n    : Array.isArray(value) && value.includes(name);\n}\n\nfunction addClass(element: ShikiElement, name: string): void {\n  const value = element.properties.class;\n\n  const classes = isString(value)\n    ? value.split(/\\s+/u).filter((item) => item.length > 0)\n    : Array.isArray(value)\n      ? value.filter((item): item is string => isString(item))\n      : [];\n\n  if (!classes.includes(name)) {\n    classes.push(name);\n  }\n\n  element.properties.class = classes;\n}\n\nfunction convertNode(node: ShikiNode): HtmlNode {\n  switch (node.type) {\n    case \"element\":\n      return convertElement(node);\n    case \"text\":\n      return { kind: \"text\", value: node.value };\n    default:\n      throw new TypeError(`Shiki returned unsupported ${node.type} content`);\n  }\n}\n\nfunction convertElement(node: ShikiElement): HtmlElementNode {\n  return {\n    kind: \"element\",\n    tagName: node.tagName,\n    attributes: convertProperties(node.properties),\n    children: node.children.map(convertNode),\n  };\n}\n\nfunction convertProperties(properties: ShikiElement[\"properties\"]): HtmlAttributes {\n  const attributes: Record<string, HtmlAttributeValue> = {};\n\n  for (const [name, value] of Object.entries(properties)) {\n    if (value === null || value === undefined) {\n      continue;\n    }\n\n    const attributeName = name === \"className\" ? \"class\" : name;\n\n    if (isBoolean(value) || isNumber(value) || isString(value)) {\n      attributes[attributeName] = value;\n      continue;\n    }\n\n    if (Array.isArray(value) && value.every((item) => isNumber(item) || isString(item))) {\n      attributes[attributeName] = value;\n      continue;\n    }\n\n    throw new TypeError(`Shiki returned an unsupported ${JSON.stringify(name)} property`);\n  }\n\n  return attributes;\n}\n"],"mappings":";;;AA+BA,MAAM,mCAAmB,IAAI,IAAI;CAAC;CAAQ;CAAS;CAAa;CAAQ;AAAK,CAAC;;AAG9E,SAAgB,uBACd,aACA,SACmB;CACnB,MAAM,EACJ,uBAAuB,gBACvB,kBACA,2BAA2B,eAC3B,wBAAwB,CAAC,GACzB,kBAAkB,CAAC,GACnB,sBAAsB,eACtB,0BAA0B,uBAC1B,GAAG,gBACD;CAEJ,MAAM,kBAAkB,IAAI,IAC1B,YAAY,mBAAmB,CAAC,CAAC,KAAK,aAAa,SAAS,YAAY,CAAC,CAC3E;CAEA,MAAM,0BAAU,IAAI,IAAoB;CAExC,KAAK,MAAM,CAAC,MAAM,OAAO,OAAO,QAAQ,eAAe,GACrD,QAAQ,IAAI,KAAK,YAAY,GAAG,GAAG,YAAY,CAAC;CAGlD,OAAO;EACL,MAAM;EACN,UAAU,SAAiC;GACzC,QAAQ,QAAQ,eAAe;GAE/B,MAAM,WAAW,gBACf,QAAQ,UACR,SACA,kBACA,eACF;GAEA,IAAI,aAAa,KAAA,GACf;GAGF,MAAM,OAAO,YAAY,WAAW,QAAQ,MAAM;IAChD,GAAG;IACH,MAAM;IACN,MAAM,QAAQ,SAAS,QAAQ,KAAA,IAAY,KAAA,IAAY,EAAE,OAAO,QAAQ,SAAS,IAAI;IACrF,WAAW;GACb,CAAC;GAED,QAAQ,QAAQ,eAAe;GAC/B,MAAM,MAAM,eAAe,KAAK,QAAQ;GACxC,kBAAkB,KAAK,SAAS;IAC9B;IACA;IACA;IACA;IACA;GACF,CAAC;GAED,OAAO,eAAe,GAAG;EAC3B;CACF;AACF;AAgBA,SAAS,gBACP,UACA,SACA,UACA,QACoB;CACpB,MAAM,aAAa,SAAS,YAAY;CACxC,MAAM,YAAY,QAAQ,IAAI,UAAU,KAAK;CAE7C,IAAI,oBAAoB,WAAW,MAAM,GACvC,OAAO;CAGT,MAAM,qBAAqB,UAAU,YAAY;CAEjD,OAAO,uBAAuB,KAAA,KAAa,oBAAoB,oBAAoB,MAAM,IACrF,qBACA,KAAA;AACN;AAEA,SAAS,oBAAoB,UAAkB,QAAsC;CACnF,OAAO,SAAS,SAAS,MAAM,OAAO,IAAI,QAAQ,KAAK,iBAAiB,IAAI,QAAQ;AACtF;AAEA,SAAS,eAAe,UAA+C;CACrE,MAAM,QAAQ,SAAS;CAEvB,IAAI,SAAS,WAAW,KAAK,OAAO,SAAS,aAAa,MAAM,YAAY,OAC1E,MAAM,IAAI,UAAU,2CAA2C;CAGjE,OAAO;AACT;AAEA,SAAS,kBACP,KACA,SACA,SACM;CACN,MAAM,OAAO,IAAI,SAAS,MACvB,SAA+B,KAAK,SAAS,aAAa,KAAK,YAAY,MAC9E;CAEA,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,UAAU,yCAAyC;CAG/D,SAAS,MAAM,YAAY,QAAQ,UAAU;CAE7C,MAAM,QAAQ,KAAK,SAAS,QACzB,SAA+B,KAAK,SAAS,aAAa,SAAS,MAAM,MAAM,CAClF;CAEA,IAAI,oBAAoB;CAExB,KAAK,MAAM,CAAC,OAAO,SAAS,MAAM,QAAQ,GAAG;EAC3C,MAAM,eAAe,QAAQ;EAC7B,MAAM,iBAAiB,QAAQ,SAAS,aAAa,SAAS,KAAK;EACnE,KAAK,WAAW,eAAe;EAE/B,IACE,QAAQ,SAAS,qBAAqB,KAAA,KACtC,iBAAiB,QAAQ,SAAS,kBAAkB,YAAY,GAEhE,SAAS,MAAM,QAAQ,wBAAwB;EAGjD,IACE,QAAQ,SAAS,gBAAgB,KAAA,KACjC,iBAAiB,QAAQ,SAAS,YAAY,OAAO,YAAY,GACjE;GACA,SAAS,MAAM,QAAQ,mBAAmB;GAC1C,oBAAoB,KAAK,IAAI,mBAAmB,aAAa;EAC/D;EAEA,IACE,QAAQ,SAAS,iBAAiB,KAAA,KAClC,iBAAiB,QAAQ,SAAS,cAAc,YAAY,GAE5D,SAAS,MAAM,QAAQ,oBAAoB;CAE/C;CAEA,IAAI,QAAQ,SAAS,aAAa,KAAA,GAChC,IAAI,WAAW,oBAAoB,QAAQ,SAAS;CAGtD,IAAI,QAAQ,SAAS,gBAAgB,KAAA,GAAW;EAC9C,MAAM,cAAc,GAAG,QAAQ,wBAAwB,GAAG,OAAO,iBAAiB,CAAC,CAAC,OAAO;EAC3F,MAAM,UAAU,IAAI,WAAW;EAC/B,IAAI,WAAW,QACb,SAAS,OAAO,KAAK,QAAQ,SAAS,IAClC,GAAG,QAAQ,QAAQ,QAAQ,GAAG,IAAI,gBAClC;CACR;CAEA,KAAK,MAAM,aAAa,QAAQ,uBAC9B,QAAQ,WAAR;EACE,KAAK;GACH,IAAI,WAAW,mBAAmB,QAAQ;GAC1C;EACF,KAAK;GACH,IAAI,WAAW,qBAAqB,MAAM;GAC1C;EACF,KAAK;GACH,IAAI,QAAQ,SAAS,QAAQ,KAAA,GAC3B,IAAI,WAAW,eAAe,QAAQ,SAAS;GAGjD;EACF,KAAK;GACH,IAAI,WAAW,sBAAsB,QAAQ;GAC7C;EACF,SAGE,OAAOA;CAEX;AAEJ;AAEA,SAAS,SAAS,SAAuB,MAAuB;CAC9D,MAAM,QAAQ,QAAQ,WAAW;CAEjC,OAAO,SAAS,KAAK,IACjB,MAAM,MAAM,MAAM,CAAC,CAAC,SAAS,IAAI,IACjC,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,IAAI;AACjD;AAEA,SAAS,SAAS,SAAuB,MAAoB;CAC3D,MAAM,QAAQ,QAAQ,WAAW;CAEjC,MAAM,UAAU,SAAS,KAAK,IAC1B,MAAM,MAAM,MAAM,CAAC,CAAC,QAAQ,SAAS,KAAK,SAAS,CAAC,IACpD,MAAM,QAAQ,KAAK,IACjB,MAAM,QAAQ,SAAyB,SAAS,IAAI,CAAC,IACrD,CAAC;CAEP,IAAI,CAAC,QAAQ,SAAS,IAAI,GACxB,QAAQ,KAAK,IAAI;CAGnB,QAAQ,WAAW,QAAQ;AAC7B;AAEA,SAAS,YAAY,MAA2B;CAC9C,QAAQ,KAAK,MAAb;EACE,KAAK,WACH,OAAO,eAAe,IAAI;EAC5B,KAAK,QACH,OAAO;GAAE,MAAM;GAAQ,OAAO,KAAK;EAAM;EAC3C,SACE,MAAM,IAAI,UAAU,8BAA8B,KAAK,KAAK,SAAS;CACzE;AACF;AAEA,SAAS,eAAe,MAAqC;CAC3D,OAAO;EACL,MAAM;EACN,SAAS,KAAK;EACd,YAAY,kBAAkB,KAAK,UAAU;EAC7C,UAAU,KAAK,SAAS,IAAI,WAAW;CACzC;AACF;AAEA,SAAS,kBAAkB,YAAwD;CACjF,MAAM,aAAiD,CAAC;CAExD,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,UAAU,GAAG;EACtD,IAAI,UAAU,QAAQ,UAAU,KAAA,GAC9B;EAGF,MAAM,gBAAgB,SAAS,cAAc,UAAU;EAEvD,IAAI,UAAU,KAAK,KAAK,SAAS,KAAK,KAAK,SAAS,KAAK,GAAG;GAC1D,WAAW,iBAAiB;GAC5B;EACF;EAEA,IAAI,MAAM,QAAQ,KAAK,KAAK,MAAM,OAAO,SAAS,SAAS,IAAI,KAAK,SAAS,IAAI,CAAC,GAAG;GACnF,WAAW,iBAAiB;GAC5B;EACF;EAEA,MAAM,IAAI,UAAU,iCAAiC,KAAK,UAAU,IAAI,EAAE,UAAU;CACtF;CAEA,OAAO;AACT"}

package/dist/plugins/syntax-highlight.d.mts

@@ -0,0 +1,38 @@
+import { HtmlElementNode, HtmlRootNode } from "../html.mjs";
+import { HtmlPlugin, HtmlPluginContext, PluginFailureMode } from "../plugin.mjs";
+import { CodeBlockMetadata } from "./code-block-metadata.mjs";
+//#region src/plugins/syntax-highlight.d.ts
+export interface SyntaxHighlightRequest {
+  readonly code: string;
+  readonly language: string;
+  readonly metadata: CodeBlockMetadata;
+  readonly signal?: AbortSignal;
+}
+export interface SynchronousSyntaxHighlighter {
+  readonly kind: "synchronous";
+  highlight(request: SyntaxHighlightRequest): HtmlElementNode | undefined;
+}
+export interface AsynchronousSyntaxHighlighter {
+  readonly kind: "asynchronous";
+  highlight(request: SyntaxHighlightRequest): Promise<HtmlElementNode | undefined>;
+}
+export type SyntaxHighlighter = SynchronousSyntaxHighlighter | AsynchronousSyntaxHighlighter;
+export interface SyntaxHighlightPluginOptions {
+  readonly highlighter: SyntaxHighlighter;
+  readonly maximumCacheEntries?: number;
+  readonly mode?: PluginFailureMode;
+}
+/** Highlights fenced code through a caller-supplied service and bounded cache. */
+export declare class SyntaxHighlightPlugin implements HtmlPlugin {
+  readonly name = "syntax-highlight";
+  private readonly cache;
+  private readonly highlighter;
+  private readonly maximumCacheEntries;
+  private readonly mode;
+  constructor(options: SyntaxHighlightPluginOptions);
+  transform(context: HtmlPluginContext): HtmlRootNode | Promise<HtmlRootNode>;
+  private highlight;
+  private highlightFailure;
+}
+//#endregion
+//# sourceMappingURL=syntax-highlight.d.mts.map

package/dist/plugins/syntax-highlight.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-highlight.d.mts","names":[],"sources":["../../src/plugins/syntax-highlight.ts"],"mappings":";;;;iBAUiB;WACN;WACA;WACA,UAAU;WACV,SAAS;;iBAGH;WACN;EACT,UAAU,SAAS,yBAAyB;;iBAG7B;WACN;EACT,UAAU,SAAS,yBAAyB,QAAQ;;YAG1C,oBAAoB,+BAA+B;iBAE9C;WACN,aAAa;WACb;WACA,OAAO;;;qBAML,iCAAiC;WAC5B;mBACC;mBACA;mBACA;mBACA;EAEjB,YAAmB,SAAS;EAYrB,UAAU,SAAS,oBAAoB,eAAe,QAAQ;UAiD7D;UAoDA"}

package/dist/plugins/syntax-highlight.mjs

@@ -0,0 +1,106 @@
+import { ConfigurationError } from "../errors.mjs";
+import { replaceHtmlNodes } from "../plugin-internal.mjs";
+import { CodeBlockMetadataError, parseCodeBlockMetadata } from "./code-block-metadata.mjs";
+import { isPromise } from "@temelj/value";
+//#region src/plugins/syntax-highlight.ts
+/** Highlights fenced code through a caller-supplied service and bounded cache. */
+var SyntaxHighlightPlugin = class {
+	name = "syntax-highlight";
+	cache = /* @__PURE__ */ new Map();
+	highlighter;
+	maximumCacheEntries;
+	mode;
+	constructor(options) {
+		const maximum = options.maximumCacheEntries ?? 128;
+		if (!Number.isSafeInteger(maximum) || maximum < 0) throw ConfigurationError.invalidCacheCapacity("syntax-highlight", maximum);
+		this.highlighter = options.highlighter;
+		this.maximumCacheEntries = maximum;
+		this.mode = options.mode ?? "tolerant";
+	}
+	transform(context) {
+		return replaceHtmlNodes(context.root, (node) => {
+			if (node.kind !== "codeBlock") return;
+			let metadata;
+			try {
+				metadata = parseCodeBlockMetadata(node.meta);
+			} catch (error) {
+				if (!(error instanceof CodeBlockMetadataError) || this.mode === "strict") throw error;
+				metadata = error.metadata;
+				for (const issue of error.issues) context.diagnostics.add({
+					severity: "warning",
+					code: "mdx.plugin.syntax-highlight.meta",
+					message: issue.message,
+					span: span(node, context)
+				});
+			}
+			const request = {
+				code: node.code,
+				language: node.language,
+				metadata,
+				signal: context.signal
+			};
+			try {
+				const result = this.highlight(request);
+				return isPromise(result) ? result.then((element) => anchor(element, node), (cause) => this.highlightFailure(cause, node, context)) : anchor(result, node);
+			} catch (cause) {
+				return this.highlightFailure(cause, node, context);
+			}
+		});
+	}
+	highlight(request) {
+		if (this.maximumCacheEntries === 0 || request.signal !== void 0) return this.highlighter.highlight(request);
+		const key = JSON.stringify([
+			request.language,
+			request.metadata.raw,
+			request.code
+		]);
+		const cached = this.cache.get(key);
+		if (cached !== void 0) {
+			this.cache.delete(key);
+			this.cache.set(key, cached);
+			return cached;
+		}
+		const result = this.highlighter.highlight(request);
+		if (result === void 0) return;
+		const cachedResult = isPromise(result) ? result.then((element) => {
+			if (element === void 0) this.cache.delete(key);
+			return element;
+		}, (cause) => {
+			this.cache.delete(key);
+			throw cause;
+		}) : result;
+		this.cache.set(key, cachedResult);
+		if (this.cache.size > this.maximumCacheEntries) {
+			const oldest = this.cache.keys().next().value;
+			if (oldest !== void 0) this.cache.delete(oldest);
+		}
+		return cachedResult;
+	}
+	highlightFailure(cause, node, context) {
+		context.signal?.throwIfAborted();
+		if (this.mode === "strict") throw cause;
+		context.diagnostics.add({
+			severity: "warning",
+			code: "mdx.plugin.syntax-highlight",
+			message: `Could not highlight ${node.language} code: ${cause instanceof Error ? cause.message : String(cause)}`,
+			span: span(node, context)
+		});
+	}
+};
+function anchor(highlighted, source) {
+	return highlighted === void 0 ? void 0 : {
+		...highlighted,
+		origin: source.origin
+	};
+}
+function span(node, context) {
+	return node.origin === void 0 ? void 0 : {
+		file: context.file,
+		start: node.origin.start,
+		end: node.origin.end
+	};
+}
+//#endregion
+export { SyntaxHighlightPlugin };
+
+//# sourceMappingURL=syntax-highlight.mjs.map

package/dist/plugins/syntax-highlight.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"syntax-highlight.mjs","names":[],"sources":["../../src/plugins/syntax-highlight.ts"],"sourcesContent":["import { isPromise } from \"@temelj/value\";\n\nimport type { HtmlCodeBlockNode, HtmlElementNode, HtmlRootNode } from \"../html.ts\";\nimport type { HtmlPlugin, HtmlPluginContext, PluginFailureMode } from \"../plugin.ts\";\nimport type { CodeBlockMetadata } from \"./code-block-metadata.ts\";\n\nimport { ConfigurationError } from \"../errors.ts\";\nimport { replaceHtmlNodes } from \"../plugin-internal.ts\";\nimport { CodeBlockMetadataError, parseCodeBlockMetadata } from \"./code-block-metadata.ts\";\n\nexport interface SyntaxHighlightRequest {\n  readonly code: string;\n  readonly language: string;\n  readonly metadata: CodeBlockMetadata;\n  readonly signal?: AbortSignal;\n}\n\nexport interface SynchronousSyntaxHighlighter {\n  readonly kind: \"synchronous\";\n  highlight(request: SyntaxHighlightRequest): HtmlElementNode | undefined;\n}\n\nexport interface AsynchronousSyntaxHighlighter {\n  readonly kind: \"asynchronous\";\n  highlight(request: SyntaxHighlightRequest): Promise<HtmlElementNode | undefined>;\n}\n\nexport type SyntaxHighlighter = SynchronousSyntaxHighlighter | AsynchronousSyntaxHighlighter;\n\nexport interface SyntaxHighlightPluginOptions {\n  readonly highlighter: SyntaxHighlighter;\n  readonly maximumCacheEntries?: number;\n  readonly mode?: PluginFailureMode;\n}\n\ntype CachedHighlight = HtmlElementNode | Promise<HtmlElementNode | undefined>;\n\n/** Highlights fenced code through a caller-supplied service and bounded cache. */\nexport class SyntaxHighlightPlugin implements HtmlPlugin {\n  public readonly name = \"syntax-highlight\";\n  private readonly cache = new Map<string, CachedHighlight>();\n  private readonly highlighter: SyntaxHighlighter;\n  private readonly maximumCacheEntries: number;\n  private readonly mode: PluginFailureMode;\n\n  public constructor(options: SyntaxHighlightPluginOptions) {\n    const maximum = options.maximumCacheEntries ?? 128;\n\n    if (!Number.isSafeInteger(maximum) || maximum < 0) {\n      throw ConfigurationError.invalidCacheCapacity(\"syntax-highlight\", maximum);\n    }\n\n    this.highlighter = options.highlighter;\n    this.maximumCacheEntries = maximum;\n    this.mode = options.mode ?? \"tolerant\";\n  }\n\n  public transform(context: HtmlPluginContext): HtmlRootNode | Promise<HtmlRootNode> {\n    return replaceHtmlNodes(context.root, (node) => {\n      if (node.kind !== \"codeBlock\") {\n        return;\n      }\n\n      let metadata: CodeBlockMetadata;\n\n      try {\n        metadata = parseCodeBlockMetadata(node.meta);\n      } catch (error) {\n        if (!(error instanceof CodeBlockMetadataError) || this.mode === \"strict\") {\n          throw error;\n        }\n\n        metadata = error.metadata;\n\n        for (const issue of error.issues) {\n          context.diagnostics.add({\n            severity: \"warning\",\n            code: \"mdx.plugin.syntax-highlight.meta\",\n            message: issue.message,\n            span: span(node, context),\n          });\n        }\n      }\n\n      const request: SyntaxHighlightRequest = {\n        code: node.code,\n        language: node.language,\n        metadata,\n        signal: context.signal,\n      };\n\n      try {\n        const result = this.highlight(request);\n\n        return isPromise(result)\n          ? result.then(\n              (element) => anchor(element, node),\n              (cause: unknown) => this.highlightFailure(cause, node, context),\n            )\n          : anchor(result, node);\n      } catch (cause) {\n        return this.highlightFailure(cause, node, context);\n      }\n    });\n  }\n\n  private highlight(\n    request: SyntaxHighlightRequest,\n  ): HtmlElementNode | undefined | Promise<HtmlElementNode | undefined> {\n    if (this.maximumCacheEntries === 0 || request.signal !== undefined) {\n      return this.highlighter.highlight(request);\n    }\n\n    const key = JSON.stringify([request.language, request.metadata.raw, request.code]);\n    const cached = this.cache.get(key);\n\n    if (cached !== undefined) {\n      this.cache.delete(key);\n      this.cache.set(key, cached);\n\n      return cached;\n    }\n\n    const result = this.highlighter.highlight(request);\n\n    if (result === undefined) {\n      return;\n    }\n\n    const cachedResult = isPromise(result)\n      ? result.then(\n          (element) => {\n            if (element === undefined) {\n              this.cache.delete(key);\n            }\n\n            return element;\n          },\n          (cause: unknown) => {\n            this.cache.delete(key);\n            throw cause;\n          },\n        )\n      : result;\n\n    this.cache.set(key, cachedResult);\n\n    if (this.cache.size > this.maximumCacheEntries) {\n      const oldest = this.cache.keys().next().value;\n\n      if (oldest !== undefined) {\n        this.cache.delete(oldest);\n      }\n    }\n\n    return cachedResult;\n  }\n\n  private highlightFailure(\n    cause: unknown,\n    node: HtmlCodeBlockNode,\n    context: HtmlPluginContext,\n  ): undefined {\n    context.signal?.throwIfAborted();\n\n    if (this.mode === \"strict\") {\n      throw cause;\n    }\n\n    context.diagnostics.add({\n      severity: \"warning\",\n      code: \"mdx.plugin.syntax-highlight\",\n      message: `Could not highlight ${node.language} code: ${cause instanceof Error ? cause.message : String(cause)}`,\n      span: span(node, context),\n    });\n  }\n}\n\nfunction anchor(\n  highlighted: HtmlElementNode | undefined,\n  source: HtmlCodeBlockNode,\n): HtmlElementNode | undefined {\n  return highlighted === undefined ? undefined : { ...highlighted, origin: source.origin };\n}\n\nfunction span(\n  node: HtmlCodeBlockNode,\n  context: HtmlPluginContext,\n): Readonly<{ file: HtmlPluginContext[\"file\"]; start: number; end: number }> | undefined {\n  return node.origin === undefined\n    ? undefined\n    : { file: context.file, start: node.origin.start, end: node.origin.end };\n}\n"],"mappings":"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"}

package/dist/processor.d.mts

@@ -0,0 +1,60 @@
+import { HtmlRootNode } from "./html.mjs";
+import { SourceFile } from "./source.mjs";
+import { HtmlRenderOptions } from "./html-lower.mjs";
+import { ParseOptions, ParseResult } from "./parser.mjs";
+import { DocumentPlugin, HtmlPlugin } from "./plugin.mjs";
+//#region src/processor.d.ts
+export interface ProcessorOptions extends ParseOptions {
+  /** Run on the semantic document before lowering and before compilation. */
+  readonly documentPlugins?: readonly DocumentPlugin[];
+  /** Run on lowered HTML. They do not affect compiled output. */
+  readonly htmlPlugins?: readonly HtmlPlugin[];
+  readonly html?: Omit<HtmlRenderOptions, "source">;
+}
+export interface ProcessResult extends ParseResult {
+  readonly html: HtmlRootNode;
+}
+export interface ProcessOptions {
+  readonly signal?: AbortSignal;
+}
+/** Strict input: a source string, a `SourceFile`, or an existing parse result. */
+export type ProcessInput = string | SourceFile | ParseResult;
+/**
+ * Parses, transforms, and lowers MDX with one configuration.
+ * Operations throw ParseError, LimitError, or TransformError on failure.
+ */
+export declare class Processor {
+  readonly options: ProcessorOptions;
+  constructor(options?: ProcessorOptions);
+  /** @throws {ParseError | LimitError | ConfigurationError} Parsing fails. */
+  parse(source: string | SourceFile): ParseResult;
+  /** @throws {MdxError} Parsing, transformation, or configuration fails. */
+  process(input: ProcessInput, options?: ProcessOptions): Promise<ProcessResult>;
+  /**
+   * Processes synchronously.
+   * @throws {MdxError} Parsing, transformation, or configuration fails.
+   * @throws {ConfigurationError} A plugin returns a promise.
+   */
+  processSync(input: ProcessInput): ProcessResult;
+  /**
+   * Parses and runs document plugins without lowering. Pass the result to
+   * `compile` to emit JavaScript from the transformed document.
+   * @throws {MdxError} Parsing, transformation, or configuration fails.
+   */
+  transform(input: ProcessInput, options?: ProcessOptions): Promise<ParseResult>;
+  /**
+   * Transforms synchronously.
+   * @throws {MdxError} Parsing, transformation, or configuration fails.
+   * @throws {ConfigurationError} A plugin returns a promise.
+   */
+  transformSync(input: ProcessInput): ParseResult;
+  /** Lowers transformed documents and runs HTML plugins with the same diagnostics. */
+  private processStages;
+  private transformStage;
+  /** Parses and runs document plugins: the stage shared by transforming and processing. */
+  private documentStage;
+  private get documentPlugins();
+  private get htmlPlugins();
+}
+//#endregion
+//# sourceMappingURL=processor.d.mts.map

package/dist/processor.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.mts","names":[],"sources":["../src/processor.ts"],"mappings":";;;;;;iBAeiB,yBAAyB;;WAE/B,2BAA2B;;WAE3B,uBAAuB;WACvB,OAAO,KAAK;;iBAGN,sBAAsB;WAC5B,MAAM;;iBAGA;WACN,SAAS;;;YAIR,wBAAwB,aAAa;;;;;qBAMpC;WACK,SAAS;EAEzB,YAAmB,UAAS;;EAUrB,MAAM,iBAAiB,aAAa;;EAK9B,QAAQ,OAAO,cAAc,UAAS,iBAAsB,QAAQ;;;;;;EAS1E,YAAY,OAAO,eAAe;;;;;;EAS5B,UAAU,OAAO,cAAc,UAAS,iBAAsB,QAAQ;;;;;;EAS5E,cAAc,OAAO,eAAe;;UAKnC;UAuBA;;UAeA;cAsBI;cAIA"}

package/dist/processor.mjs

@@ -0,0 +1,106 @@
+import { DiagnosticBag } from "./diagnostics.mjs";
+import { SourceFile } from "./source.mjs";
+import { lowerHtml } from "./html-lower.mjs";
+import { parse } from "./parser.mjs";
+import { runDocumentPlugins, runHtmlPlugins } from "./plugin-internal.mjs";
+import { isPromise, isString } from "@temelj/value";
+//#region src/processor.ts
+/**
+* Parses, transforms, and lowers MDX with one configuration.
+* Operations throw ParseError, LimitError, or TransformError on failure.
+*/
+var Processor = class {
+	options;
+	constructor(options = {}) {
+		this.options = {
+			...options,
+			documentPlugins: [...options.documentPlugins ?? []],
+			htmlPlugins: [...options.htmlPlugins ?? []]
+		};
+	}
+	/** @throws {ParseError | LimitError | ConfigurationError} Parsing fails. */
+	parse(source) {
+		return parse(source, this.options);
+	}
+	/** @throws {MdxError} Parsing, transformation, or configuration fails. */
+	async process(input, options = {}) {
+		return this.processStages(input, false, options.signal);
+	}
+	/**
+	* Processes synchronously.
+	* @throws {MdxError} Parsing, transformation, or configuration fails.
+	* @throws {ConfigurationError} A plugin returns a promise.
+	*/
+	processSync(input) {
+		return settled(this.processStages(input, true));
+	}
+	/**
+	* Parses and runs document plugins without lowering. Pass the result to
+	* `compile` to emit JavaScript from the transformed document.
+	* @throws {MdxError} Parsing, transformation, or configuration fails.
+	*/
+	async transform(input, options = {}) {
+		return this.transformStage(input, false, options.signal);
+	}
+	/**
+	* Transforms synchronously.
+	* @throws {MdxError} Parsing, transformation, or configuration fails.
+	* @throws {ConfigurationError} A plugin returns a promise.
+	*/
+	transformSync(input) {
+		return settled(this.transformStage(input, true));
+	}
+	/** Lowers transformed documents and runs HTML plugins with the same diagnostics. */
+	processStages(input, synchronous, signal) {
+		return chain(this.documentStage(input, synchronous, signal), (stage) => chain(runHtmlPlugins(lowerHtml(stage.document, {
+			...this.options.html,
+			source: stage.file
+		}), this.htmlPlugins, stage.run), (html) => Object.freeze({
+			file: stage.file,
+			document: stage.document,
+			html,
+			diagnostics: stage.run.diagnostics.snapshot()
+		})));
+	}
+	transformStage(input, synchronous, signal) {
+		return chain(this.documentStage(input, synchronous, signal), (stage) => Object.freeze({
+			file: stage.file,
+			document: stage.document,
+			diagnostics: stage.run.diagnostics.snapshot()
+		}));
+	}
+	/** Parses and runs document plugins: the stage shared by transforming and processing. */
+	documentStage(input, synchronous, signal) {
+		signal?.throwIfAborted();
+		const parsed = input instanceof SourceFile || isString(input) ? this.parse(input) : input;
+		const run = {
+			diagnostics: new DiagnosticBag(parsed.diagnostics),
+			file: parsed.file,
+			signal,
+			syntax: this.options.syntax ?? {},
+			synchronous
+		};
+		return chain(runDocumentPlugins(parsed.document, this.documentPlugins, run), (document) => ({
+			file: parsed.file,
+			document,
+			run
+		}));
+	}
+	get documentPlugins() {
+		return this.options.documentPlugins ?? [];
+	}
+	get htmlPlugins() {
+		return this.options.htmlPlugins ?? [];
+	}
+};
+function chain(value, step) {
+	return isPromise(value) ? value.then(step) : step(value);
+}
+function settled(value) {
+	if (isPromise(value)) throw new TypeError("Synchronous plugin run returned a promise");
+	return value;
+}
+//#endregion
+export { Processor };
+
+//# sourceMappingURL=processor.mjs.map

package/dist/processor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.mjs","names":[],"sources":["../src/processor.ts"],"sourcesContent":["import { isPromise, isString } from \"@temelj/value\";\n\nimport type { HtmlRenderOptions } from \"./html-lower.ts\";\nimport type { HtmlRootNode } from \"./html.ts\";\nimport type { DocumentNode } from \"./model.ts\";\nimport type { ParseOptions, ParseResult } from \"./parser.ts\";\nimport type { PluginRun } from \"./plugin-internal.ts\";\nimport type { DocumentPlugin, HtmlPlugin } from \"./plugin.ts\";\n\nimport { DiagnosticBag } from \"./diagnostics.ts\";\nimport { lowerHtml } from \"./html-lower.ts\";\nimport { parse } from \"./parser.ts\";\nimport { runDocumentPlugins, runHtmlPlugins } from \"./plugin-internal.ts\";\nimport { SourceFile } from \"./source.ts\";\n\nexport interface ProcessorOptions extends ParseOptions {\n  /** Run on the semantic document before lowering and before compilation. */\n  readonly documentPlugins?: readonly DocumentPlugin[];\n  /** Run on lowered HTML. They do not affect compiled output. */\n  readonly htmlPlugins?: readonly HtmlPlugin[];\n  readonly html?: Omit<HtmlRenderOptions, \"source\">;\n}\n\nexport interface ProcessResult extends ParseResult {\n  readonly html: HtmlRootNode;\n}\n\nexport interface ProcessOptions {\n  readonly signal?: AbortSignal;\n}\n\n/** Strict input: a source string, a `SourceFile`, or an existing parse result. */\nexport type ProcessInput = string | SourceFile | ParseResult;\n\n/**\n * Parses, transforms, and lowers MDX with one configuration.\n * Operations throw ParseError, LimitError, or TransformError on failure.\n */\nexport class Processor {\n  public readonly options: ProcessorOptions;\n\n  public constructor(options: ProcessorOptions = {}) {\n    // Later changes to the caller's plugin arrays do not reconfigure the processor.\n    this.options = {\n      ...options,\n      documentPlugins: [...(options.documentPlugins ?? [])],\n      htmlPlugins: [...(options.htmlPlugins ?? [])],\n    };\n  }\n\n  /** @throws {ParseError | LimitError | ConfigurationError} Parsing fails. */\n  public parse(source: string | SourceFile): ParseResult {\n    return parse(source, this.options);\n  }\n\n  /** @throws {MdxError} Parsing, transformation, or configuration fails. */\n  public async process(input: ProcessInput, options: ProcessOptions = {}): Promise<ProcessResult> {\n    return this.processStages(input, false, options.signal);\n  }\n\n  /**\n   * Processes synchronously.\n   * @throws {MdxError} Parsing, transformation, or configuration fails.\n   * @throws {ConfigurationError} A plugin returns a promise.\n   */\n  public processSync(input: ProcessInput): ProcessResult {\n    return settled(this.processStages(input, true));\n  }\n\n  /**\n   * Parses and runs document plugins without lowering. Pass the result to\n   * `compile` to emit JavaScript from the transformed document.\n   * @throws {MdxError} Parsing, transformation, or configuration fails.\n   */\n  public async transform(input: ProcessInput, options: ProcessOptions = {}): Promise<ParseResult> {\n    return this.transformStage(input, false, options.signal);\n  }\n\n  /**\n   * Transforms synchronously.\n   * @throws {MdxError} Parsing, transformation, or configuration fails.\n   * @throws {ConfigurationError} A plugin returns a promise.\n   */\n  public transformSync(input: ProcessInput): ParseResult {\n    return settled(this.transformStage(input, true));\n  }\n\n  /** Lowers transformed documents and runs HTML plugins with the same diagnostics. */\n  private processStages(\n    input: ProcessInput,\n    synchronous: boolean,\n    signal?: AbortSignal,\n  ): Settling<ProcessResult> {\n    return chain(this.documentStage(input, synchronous, signal), (stage) =>\n      chain(\n        runHtmlPlugins(\n          lowerHtml(stage.document, { ...this.options.html, source: stage.file }),\n          this.htmlPlugins,\n          stage.run,\n        ),\n        (html): ProcessResult =>\n          Object.freeze({\n            file: stage.file,\n            document: stage.document,\n            html,\n            diagnostics: stage.run.diagnostics.snapshot(),\n          }),\n      ),\n    );\n  }\n\n  private transformStage(\n    input: ProcessInput,\n    synchronous: boolean,\n    signal?: AbortSignal,\n  ): Settling<ParseResult> {\n    return chain(this.documentStage(input, synchronous, signal), (stage): ParseResult =>\n      Object.freeze({\n        file: stage.file,\n        document: stage.document,\n        diagnostics: stage.run.diagnostics.snapshot(),\n      }),\n    );\n  }\n\n  /** Parses and runs document plugins: the stage shared by transforming and processing. */\n  private documentStage(\n    input: ProcessInput,\n    synchronous: boolean,\n    signal?: AbortSignal,\n  ): Settling<DocumentStage> {\n    signal?.throwIfAborted();\n    const parsed = input instanceof SourceFile || isString(input) ? this.parse(input) : input;\n\n    const run: PluginRun = {\n      diagnostics: new DiagnosticBag(parsed.diagnostics),\n      file: parsed.file,\n      signal,\n      syntax: this.options.syntax ?? {},\n      synchronous,\n    };\n\n    return chain(\n      runDocumentPlugins(parsed.document, this.documentPlugins, run),\n      (document): DocumentStage => ({ file: parsed.file, document, run }),\n    );\n  }\n\n  private get documentPlugins(): readonly DocumentPlugin[] {\n    return this.options.documentPlugins ?? [];\n  }\n\n  private get htmlPlugins(): readonly HtmlPlugin[] {\n    return this.options.htmlPlugins ?? [];\n  }\n}\n\ninterface DocumentStage {\n  readonly file: SourceFile;\n  readonly document: DocumentNode;\n  readonly run: PluginRun;\n}\n\n/** A value now, or later when an asynchronous plugin is involved. */\ntype Settling<TValue> = TValue | Promise<TValue>;\n\nfunction chain<TValue, TResult>(\n  value: Settling<TValue>,\n  step: (value: TValue) => Settling<TResult>,\n): Settling<TResult> {\n  return isPromise(value) ? value.then(step) : step(value);\n}\n\nfunction settled<T>(value: Settling<T>): T {\n  // A synchronous run rejects asynchronous plugins before returning a promise.\n  if (isPromise(value)) {\n    throw new TypeError(\"Synchronous plugin run returned a promise\");\n  }\n\n  return value;\n}\n"],"mappings":";;;;;;;;;;;AAsCA,IAAa,YAAb,MAAuB;CACrB;CAEA,YAAmB,UAA4B,CAAC,GAAG;EAEjD,KAAK,UAAU;GACb,GAAG;GACH,iBAAiB,CAAC,GAAI,QAAQ,mBAAmB,CAAC,CAAE;GACpD,aAAa,CAAC,GAAI,QAAQ,eAAe,CAAC,CAAE;EAC9C;CACF;;CAGA,MAAa,QAA0C;EACrD,OAAO,MAAM,QAAQ,KAAK,OAAO;CACnC;;CAGA,MAAa,QAAQ,OAAqB,UAA0B,CAAC,GAA2B;EAC9F,OAAO,KAAK,cAAc,OAAO,OAAO,QAAQ,MAAM;CACxD;;;;;;CAOA,YAAmB,OAAoC;EACrD,OAAO,QAAQ,KAAK,cAAc,OAAO,IAAI,CAAC;CAChD;;;;;;CAOA,MAAa,UAAU,OAAqB,UAA0B,CAAC,GAAyB;EAC9F,OAAO,KAAK,eAAe,OAAO,OAAO,QAAQ,MAAM;CACzD;;;;;;CAOA,cAAqB,OAAkC;EACrD,OAAO,QAAQ,KAAK,eAAe,OAAO,IAAI,CAAC;CACjD;;CAGA,cACE,OACA,aACA,QACyB;EACzB,OAAO,MAAM,KAAK,cAAc,OAAO,aAAa,MAAM,IAAI,UAC5D,MACE,eACE,UAAU,MAAM,UAAU;GAAE,GAAG,KAAK,QAAQ;GAAM,QAAQ,MAAM;EAAK,CAAC,GACtE,KAAK,aACL,MAAM,GACR,IACC,SACC,OAAO,OAAO;GACZ,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB;GACA,aAAa,MAAM,IAAI,YAAY,SAAS;EAC9C,CAAC,CACL,CACF;CACF;CAEA,eACE,OACA,aACA,QACuB;EACvB,OAAO,MAAM,KAAK,cAAc,OAAO,aAAa,MAAM,IAAI,UAC5D,OAAO,OAAO;GACZ,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,aAAa,MAAM,IAAI,YAAY,SAAS;EAC9C,CAAC,CACH;CACF;;CAGA,cACE,OACA,aACA,QACyB;EACzB,QAAQ,eAAe;EACvB,MAAM,SAAS,iBAAiB,cAAc,SAAS,KAAK,IAAI,KAAK,MAAM,KAAK,IAAI;EAEpF,MAAM,MAAiB;GACrB,aAAa,IAAI,cAAc,OAAO,WAAW;GACjD,MAAM,OAAO;GACb;GACA,QAAQ,KAAK,QAAQ,UAAU,CAAC;GAChC;EACF;EAEA,OAAO,MACL,mBAAmB,OAAO,UAAU,KAAK,iBAAiB,GAAG,IAC5D,cAA6B;GAAE,MAAM,OAAO;GAAM;GAAU;EAAI,EACnE;CACF;CAEA,IAAY,kBAA6C;EACvD,OAAO,KAAK,QAAQ,mBAAmB,CAAC;CAC1C;CAEA,IAAY,cAAqC;EAC/C,OAAO,KAAK,QAAQ,eAAe,CAAC;CACtC;AACF;AAWA,SAAS,MACP,OACA,MACmB;CACnB,OAAO,UAAU,KAAK,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK;AACzD;AAEA,SAAS,QAAW,OAAuB;CAEzC,IAAI,UAAU,KAAK,GACjB,MAAM,IAAI,UAAU,2CAA2C;CAGjE,OAAO;AACT"}

package/dist/ranges.d.mts

@@ -0,0 +1,10 @@
+//#region src/ranges.d.ts
+export interface SourceRange {
+  readonly start: number;
+  readonly end: number;
+}
+export declare function sourceRange(start: number, end: number): SourceRange;
+export declare function rangesIntersect(left: SourceRange, right: SourceRange): boolean;
+export declare function shiftRange(range: SourceRange, offset: number): SourceRange;
+//#endregion
+//# sourceMappingURL=ranges.d.mts.map

package/dist/ranges.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranges.d.mts","names":[],"sources":["../src/ranges.ts"],"mappings":";iBAAiB;WACN;WACA;;wBAGK,YAAY,eAAe,cAAc;wBAQzC,gBAAgB,MAAM,aAAa,OAAO;wBAQ1C,WAAW,OAAO,aAAa,iBAAiB"}

package/dist/ranges.mjs

@@ -0,0 +1,22 @@
+//#region src/ranges.ts
+function sourceRange(start, end) {
+	if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start < 0 || end < start) throw new RangeError(`Invalid source range ${start}..${end}`);
+	return Object.freeze({
+		start,
+		end
+	});
+}
+function rangesIntersect(left, right) {
+	if (right.start === right.end) return left.start < right.start && right.start < left.end;
+	return left.start < right.end && right.start < left.end;
+}
+function shiftRange(range, offset) {
+	return {
+		start: range.start + offset,
+		end: range.end + offset
+	};
+}
+//#endregion
+export { rangesIntersect, shiftRange, sourceRange };
+
+//# sourceMappingURL=ranges.mjs.map

package/dist/ranges.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ranges.mjs","names":[],"sources":["../src/ranges.ts"],"sourcesContent":["export interface SourceRange {\n  readonly start: number;\n  readonly end: number;\n}\n\nexport function sourceRange(start: number, end: number): SourceRange {\n  if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start < 0 || end < start) {\n    throw new RangeError(`Invalid source range ${start}..${end}`);\n  }\n\n  return Object.freeze({ start, end });\n}\n\nexport function rangesIntersect(left: SourceRange, right: SourceRange): boolean {\n  if (right.start === right.end) {\n    return left.start < right.start && right.start < left.end;\n  }\n\n  return left.start < right.end && right.start < left.end;\n}\n\nexport function shiftRange(range: SourceRange, offset: number): SourceRange {\n  return { start: range.start + offset, end: range.end + offset };\n}\n"],"mappings":";AAKA,SAAgB,YAAY,OAAe,KAA0B;CACnE,IAAI,CAAC,OAAO,cAAc,KAAK,KAAK,CAAC,OAAO,cAAc,GAAG,KAAK,QAAQ,KAAK,MAAM,OACnF,MAAM,IAAI,WAAW,wBAAwB,MAAM,IAAI,KAAK;CAG9D,OAAO,OAAO,OAAO;EAAE;EAAO;CAAI,CAAC;AACrC;AAEA,SAAgB,gBAAgB,MAAmB,OAA6B;CAC9E,IAAI,MAAM,UAAU,MAAM,KACxB,OAAO,KAAK,QAAQ,MAAM,SAAS,MAAM,QAAQ,KAAK;CAGxD,OAAO,KAAK,QAAQ,MAAM,OAAO,MAAM,QAAQ,KAAK;AACtD;AAEA,SAAgB,WAAW,OAAoB,QAA6B;CAC1E,OAAO;EAAE,OAAO,MAAM,QAAQ;EAAQ,KAAK,MAAM,MAAM;CAAO;AAChE"}

package/dist/source-map.d.mts

@@ -0,0 +1,28 @@
+import { SourceRange } from "./ranges.mjs";
+import { SourceFile } from "./source.mjs";
+//#region src/source-map.d.ts
+export interface SourceMap {
+  readonly file?: string;
+  readonly mappings: string;
+  readonly names: readonly string[];
+  readonly sources: readonly string[];
+  readonly sourcesContent: readonly string[];
+  readonly version: 3;
+}
+/** Private generated-text builder that records original MDX locations. */
+export declare class CodeWriter {
+  private readonly chunks;
+  private readonly points;
+  private column;
+  private line;
+  private size;
+  private readonly sourceFile;
+  constructor(sourceFile: SourceFile | undefined);
+  get length(): number;
+  /** Writes generated code. `origin` maps it to a range in the source file. */
+  write(value: string, origin?: SourceRange): void;
+  toString(): string;
+  sourceMap(sourceName: string, outputName?: string): SourceMap;
+}
+//#endregion
+//# sourceMappingURL=source-map.d.mts.map

package/dist/source-map.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-map.d.mts","names":[],"sources":["../src/source-map.ts"],"mappings":";;;iBAKiB;WACN;WACA;WACA;WACA;WACA;WACA;;;qBAWE;mBACM;mBACA;UACT;UACA;UACA;mBACS;EAEjB,YAAmB,YAAY;MAIpB;;EAKJ,MAAM,eAAe,SAAS;EA8B9B;EAIA,UAAU,oBAAoB,sBAAsB"}