@temelj/mdx 0.10.2 → 0.11.1

package/README.md

@@ -116,5 +116,4 @@ assertEquals(artifact.frontmatter, {
 
 ## About
 
-This package is part of [Temelj](https://github.com/tinrab/temelj) - a big
-standard library for TypeScript.
+This package is part of [Temelj](https://github.com/tinrab/temelj) - a core library for TypeScript.

package/dist/compiler.d.mts

@@ -17,6 +17,31 @@ interface MdxCompileOptions {
   frontmatterOnly?: boolean | undefined;
   mdxOptions?: CompileOptions;
 }
+interface MdxMessagePoint {
+  line?: number | undefined;
+  column?: number | undefined;
+  offset?: number | undefined;
+}
+interface MdxMessagePlace {
+  start?: MdxMessagePoint | undefined;
+  end?: MdxMessagePoint | undefined;
+}
+interface MdxMessage {
+  message: string;
+  reason: string;
+  source?: string | undefined;
+  ruleId?: string | undefined;
+  fatal?: boolean | undefined;
+  line?: number | undefined;
+  column?: number | undefined;
+  place?: MdxMessagePlace | undefined;
+  sourceLine?: string | undefined;
+  snippet?: string | undefined;
+  cause?: {
+    name?: string | undefined;
+    message: string;
+  };
+}
 /**
  * The result of compiling an MDX document.
  * Compiled content is optional, because sometimes we only need the frontmatter.
@@ -24,6 +49,29 @@ interface MdxCompileOptions {
 interface MdxArtifact<TFrontmatter = Record<string, unknown>> {
   compiled?: string | undefined;
   frontmatter: TFrontmatter;
+  messages: MdxMessage[];
+}
+declare class MdxCompileError extends Error {
+  readonly reason: string;
+  readonly source?: string | undefined;
+  readonly ruleId?: string | undefined;
+  readonly line?: number | undefined;
+  readonly column?: number | undefined;
+  readonly place?: MdxMessagePlace | undefined;
+  readonly sourceLine?: string | undefined;
+  readonly snippet?: string | undefined;
+  readonly diagnostics: MdxMessage[];
+  constructor(reason: string, options?: {
+    source?: string | undefined;
+    ruleId?: string | undefined;
+    line?: number | undefined;
+    column?: number | undefined;
+    place?: MdxMessagePlace | undefined;
+    sourceLine?: string | undefined;
+    snippet?: string | undefined;
+    diagnostics?: MdxMessage[] | undefined;
+    cause?: unknown;
+  });
 }
 /**
  * A reusable compiler for compiling MDX.
@@ -41,5 +89,5 @@ declare class MdxCompiler {
   }?: MdxCompileOptions, frontmatterSchema?: TFrontmatterSchema): Promise<MdxArtifact<z.output<TFrontmatterSchema>>>;
 }
 //#endregion
-export { MdxArtifact, MdxCompileOptions, MdxCompiler, MdxSource, remarkFrontmatterPlugin, remarkGfmPlugin };
+export { MdxArtifact, MdxCompileError, MdxCompileOptions, MdxCompiler, MdxMessage, MdxMessagePlace, MdxMessagePoint, MdxSource, remarkFrontmatterPlugin, remarkGfmPlugin };
 //# sourceMappingURL=compiler.d.mts.map

package/dist/compiler.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.mts","names":[],"sources":["../src/compiler.ts"],"mappings":";;;;;;;;;AAkBA;;KAAY,SAAA,YAAqB,UAAA;;;AAKjC;UAAiB,iBAAA;EACf,eAAA;EACA,UAAA,GAAa,cAAA;AAAA;;;;;UAOE,WAAA,gBAA2B,MAAA;EAC1C,QAAA;EACA,WAAA,EAAa,YAAA;AAAA;;;;cAMF,WAAA;EAAA,iBACM,UAAA;EAAA,iBACA,aAAA;EAAA,iBACA,aAAA;cAEE,UAAA,GAAY,cAAA;EAMxB,gBAAA,UAAA,CACL,MAAA,EAAQ,MAAA,EAAQ,QAAA,IAAY,IAAA,EAAU,IAAA,GACtC,OAAA,GAAU,QAAA,GACT,WAAA;EASI,gBAAA,UAAA,CACL,MAAA,EAAQ,MAAA,EAAQ,QAAA,IAAY,IAAA,EAAU,IAAA,GACtC,OAAA,GAAU,QAAA,GACT,WAAA;EASU,OAAA,4BAAmC,CAAA,CAAE,SAAA,CAAA,CAChD,MAAA,EAAQ,SAAA;IACN,eAAA;IAAyB;EAAA,IAAc,iBAAA,EACzC,iBAAA,GAAoB,kBAAA,GACnB,OAAA,CAAQ,WAAA,CAAY,CAAA,CAAE,MAAA,CAAO,kBAAA;AAAA"}
+{"version":3,"file":"compiler.d.mts","names":[],"sources":["../src/compiler.ts"],"mappings":";;;;;;;;;AAkBA;;KAAY,SAAA,YAAqB,UAAA;;;AAKjC;UAAiB,iBAAA;EACf,eAAA;EACA,UAAA,GAAa,cAAA;AAAA;AAAA,UAGE,eAAA;EACf,IAAA;EACA,MAAA;EACA,MAAA;AAAA;AAAA,UAGe,eAAA;EACf,KAAA,GAAQ,eAAA;EACR,GAAA,GAAM,eAAA;AAAA;AAAA,UAGS,UAAA;EACf,OAAA;EACA,MAAA;EACA,MAAA;EACA,MAAA;EACA,KAAA;EACA,IAAA;EACA,MAAA;EACA,KAAA,GAAQ,eAAA;EACR,UAAA;EACA,OAAA;EACA,KAAA;IACE,IAAA;IACA,OAAA;EAAA;AAAA;;;;;UAUa,WAAA,gBAA2B,MAAA;EAC1C,QAAA;EACA,WAAA,EAAa,YAAA;EACb,QAAA,EAAU,UAAA;AAAA;AAAA,cAGC,eAAA,SAAwB,KAAA;EAAA,SACnB,MAAA;EAAA,SACA,MAAA;EAAA,SACA,MAAA;EAAA,SACA,IAAA;EAAA,SACA,MAAA;EAAA,SACA,KAAA,GAAQ,eAAA;EAAA,SACR,UAAA;EAAA,SACA,OAAA;EAAA,SACA,WAAA,EAAa,UAAA;cAG3B,MAAA,UACA,OAAA;IACE,MAAA;IACA,MAAA;IACA,IAAA;IACA,MAAA;IACA,KAAA,GAAQ,eAAA;IACR,UAAA;IACA,OAAA;IACA,WAAA,GAAc,UAAA;IACd,KAAA;EAAA;AAAA;;;;cA+BO,WAAA;EAAA,iBACM,UAAA;EAAA,iBACA,aAAA;EAAA,iBACA,aAAA;cAEE,UAAA,GAAY,cAAA;EAMxB,gBAAA,UAAA,CACL,MAAA,EAAQ,MAAA,EAAQ,QAAA,IAAY,IAAA,EAAU,IAAA,GACtC,OAAA,GAAU,QAAA,GACT,WAAA;EASI,gBAAA,UAAA,CACL,MAAA,EAAQ,MAAA,EAAQ,QAAA,IAAY,IAAA,EAAU,IAAA,GACtC,OAAA,GAAU,QAAA,GACT,WAAA;EASU,OAAA,4BAAmC,CAAA,CAAE,SAAA,CAAA,CAChD,MAAA,EAAQ,SAAA;IACN,eAAA;IAAyB;EAAA,IAAc,iBAAA,EACzC,iBAAA,GAAoB,kBAAA,GACnB,OAAA,CAAQ,WAAA,CAAY,CAAA,CAAE,MAAA,CAAO,kBAAA;AAAA"}

package/dist/compiler.mjs

@@ -3,8 +3,38 @@ import remarkFrontmatterPlugin from "remark-frontmatter";
 import remarkGfmPlugin from "remark-gfm";
 import { VFile } from "vfile";
 import { matter } from "vfile-matter";
-
 //#region src/compiler.ts
+var MdxCompileError = class extends Error {
+	reason;
+	source;
+	ruleId;
+	line;
+	column;
+	place;
+	sourceLine;
+	snippet;
+	diagnostics;
+	constructor(reason, options = {}) {
+		super(formatDiagnosticMessage(reason, {
+			source: options.source,
+			ruleId: options.ruleId,
+			line: options.line,
+			column: options.column,
+			sourceLine: options.sourceLine,
+			snippet: options.snippet
+		}), options.cause === void 0 ? void 0 : { cause: options.cause });
+		this.name = "MdxCompileError";
+		this.reason = reason;
+		this.source = options.source;
+		this.ruleId = options.ruleId;
+		this.line = options.line;
+		this.column = options.column;
+		this.place = options.place;
+		this.sourceLine = options.sourceLine;
+		this.snippet = options.snippet;
+		this.diagnostics = options.diagnostics ?? [];
+	}
+};
 /**
 * A reusable compiler for compiling MDX.
 */
@@ -28,12 +58,11 @@ var MdxCompiler = class {
 		return this;
 	}
 	async compile(source, { frontmatterOnly = false, mdxOptions } = {}, frontmatterSchema) {
+		const sourceText = toSourceText(source);
 		const vfile = new VFile({
 			value: source,
 			cwd: "/",
-			path: "/",
-			message: {},
-			messages: {}
+			path: "/source.mdx"
 		});
 		matter(vfile, { strip: true });
 		const remarkPlugins = [
@@ -47,21 +76,184 @@ var MdxCompiler = class {
 			...mdxOptions?.rehypePlugins ?? []
 		];
 		let compiled;
-		if (!frontmatterOnly) compiled = (await compile(vfile, {
-			outputFormat: "function-body",
-			...this.mdxOptions ?? {},
-			...mdxOptions ?? {},
-			remarkPlugins,
-			rehypePlugins
-		})).value.toString();
+		if (!frontmatterOnly) try {
+			compiled = (await compile(vfile, {
+				outputFormat: "function-body",
+				...this.mdxOptions ?? {},
+				...mdxOptions ?? {},
+				remarkPlugins,
+				rehypePlugins
+			})).value.toString();
+		} catch (error) {
+			throw toMdxCompileError(error, sourceText, vfile.messages);
+		}
 		const frontmatter = frontmatterSchema === void 0 ? vfile.data.matter ?? {} : frontmatterSchema.parse(vfile.data.matter ?? {});
 		return {
 			compiled,
-			frontmatter
+			frontmatter,
+			messages: normalizeMessages(vfile.messages, sourceText)
 		};
 	}
 };
-
+function toMdxCompileError(error, sourceText, diagnostics) {
+	const details = getDiagnosticDetails(sourceText, getErrorPlace(error), error);
+	return new MdxCompileError(getErrorReason(error), {
+		source: getErrorField(error, "source"),
+		ruleId: getErrorField(error, "ruleId"),
+		line: details.line,
+		column: details.column,
+		place: details.place,
+		sourceLine: details.sourceLine,
+		snippet: details.snippet,
+		diagnostics: normalizeMessages(diagnostics, sourceText),
+		cause: error
+	});
+}
+function normalizeMessages(messages, sourceText) {
+	return messages.map((message) => {
+		const details = getDiagnosticDetails(sourceText, toMessagePlace(message), message);
+		const reason = getErrorReason(message);
+		const source = getErrorField(message, "source");
+		const ruleId = getErrorField(message, "ruleId");
+		const cause = getErrorCause(message);
+		return {
+			message: formatDiagnosticMessage(reason, {
+				source,
+				ruleId,
+				line: details.line,
+				column: details.column,
+				sourceLine: details.sourceLine,
+				snippet: details.snippet,
+				causeMessage: cause?.message
+			}),
+			reason,
+			source,
+			ruleId,
+			fatal: typeof message.fatal === "boolean" ? message.fatal : void 0,
+			line: details.line,
+			column: details.column,
+			place: details.place,
+			sourceLine: details.sourceLine,
+			snippet: details.snippet,
+			cause
+		};
+	});
+}
+function formatDiagnosticMessage(reason, options) {
+	const lines = [[
+		reason,
+		options.source === void 0 ? void 0 : options.ruleId === void 0 ? options.source : `${options.source}:${options.ruleId}`,
+		options.line === void 0 ? void 0 : options.column === void 0 ? `at ${options.line}` : `at ${options.line}:${options.column}`
+	].filter(Boolean).join(" ")];
+	if (options.snippet !== void 0) lines.push(`Source: ${options.snippet}`);
+	if (options.sourceLine !== void 0 && options.sourceLine !== options.snippet) lines.push(`Line: ${options.sourceLine}`);
+	if (options.causeMessage !== void 0 && options.causeMessage !== "" && options.causeMessage !== reason) lines.push(`Cause: ${options.causeMessage}`);
+	return lines.join("\n");
+}
+function getDiagnosticDetails(sourceText, place, error) {
+	const line = place?.start?.line ?? getErrorNumberField(error, "line");
+	const column = place?.start?.column ?? getErrorNumberField(error, "column");
+	const normalizedPlace = line === void 0 && column === void 0 && place === void 0 ? void 0 : {
+		start: {
+			line,
+			column,
+			offset: place?.start?.offset
+		},
+		end: place?.end === void 0 ? void 0 : {
+			line: place.end.line,
+			column: place.end.column,
+			offset: place.end.offset
+		}
+	};
+	return {
+		line,
+		column,
+		place: normalizedPlace,
+		sourceLine: getSourceLine(sourceText, line),
+		snippet: getSourceSnippet(sourceText, normalizedPlace)
+	};
+}
+function getSourceLine(sourceText, line) {
+	if (line === void 0 || line < 1) return;
+	return sourceText.split(/\r?\n/u)[line - 1];
+}
+function getSourceSnippet(sourceText, place) {
+	if (place?.start?.offset !== void 0 && place.end?.offset !== void 0) return sourceText.slice(place.start.offset, place.end.offset) || void 0;
+	if (place?.start?.line === void 0 || place.start.column === void 0) return;
+	const lines = sourceText.split(/\r?\n/u);
+	const startLineIndex = place.start.line - 1;
+	const endLineIndex = (place.end?.line ?? place.start.line) - 1;
+	if (startLineIndex < 0 || startLineIndex >= lines.length) return;
+	const selectedLines = lines.slice(startLineIndex, endLineIndex + 1);
+	if (selectedLines.length === 0) return;
+	selectedLines[0] = selectedLines[0].slice(place.start.column - 1);
+	const endColumn = place.end?.column;
+	if (endColumn !== void 0) {
+		const lastIndex = selectedLines.length - 1;
+		selectedLines[lastIndex] = selectedLines[lastIndex].slice(0, endColumn - 1);
+	}
+	return selectedLines.join("\n") || void 0;
+}
+function getErrorPlace(error) {
+	if (typeof error !== "object" || error === null) return;
+	const candidate = error;
+	return toPlace(candidate.place) ?? toPlace(candidate.position);
+}
+function toMessagePlace(message) {
+	return toPlace(message.place);
+}
+function toPlace(value) {
+	if (typeof value !== "object" || value === null) return;
+	const candidate = value;
+	if (candidate.start !== void 0 || candidate.end !== void 0) return {
+		start: toPoint(candidate.start),
+		end: toPoint(candidate.end)
+	};
+	const point = toPoint(candidate);
+	return point === void 0 ? void 0 : { start: point };
+}
+function toPoint(value) {
+	if (typeof value !== "object" || value === null) return;
+	const candidate = value;
+	const line = typeof candidate.line === "number" ? candidate.line : void 0;
+	const column = typeof candidate.column === "number" ? candidate.column : void 0;
+	const offset = typeof candidate.offset === "number" ? candidate.offset : void 0;
+	if (line === void 0 && column === void 0 && offset === void 0) return;
+	return {
+		line,
+		column,
+		offset
+	};
+}
+function getErrorReason(error) {
+	if (error instanceof Error && error.message !== "") return error.message;
+	const reason = getErrorField(error, "reason");
+	if (reason !== void 0 && reason !== "") return reason;
+	return String(error);
+}
+function getErrorCause(error) {
+	if (typeof error !== "object" || error === null || !("cause" in error)) return;
+	const cause = error.cause;
+	if (cause instanceof Error) return {
+		name: cause.name,
+		message: cause.message
+	};
+	if (typeof cause === "string" && cause !== "") return { message: cause };
+}
+function getErrorField(error, field) {
+	if (typeof error !== "object" || error === null || !(field in error)) return;
+	const value = error[field];
+	return typeof value === "string" && value !== "" ? value : void 0;
+}
+function getErrorNumberField(error, field) {
+	if (typeof error !== "object" || error === null || !(field in error)) return;
+	const value = error[field];
+	return typeof value === "number" ? value : void 0;
+}
+function toSourceText(source) {
+	return typeof source === "string" ? source : new TextDecoder().decode(source);
+}
 //#endregion
-export { MdxCompiler, remarkFrontmatterPlugin, remarkGfmPlugin };
+export { MdxCompileError, MdxCompiler, remarkFrontmatterPlugin, remarkGfmPlugin };
+
 //# sourceMappingURL=compiler.mjs.map

package/dist/compiler.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.mjs","names":["compileMdxJs"],"sources":["../src/compiler.ts"],"sourcesContent":["import {\n  compile as compileMdxJs,\n  type CompileOptions as MdxJsCompileOptions,\n} from \"@mdx-js/mdx\";\nimport remarkFrontmatterPlugin from \"remark-frontmatter\";\nimport remarkGfmPlugin from \"remark-gfm\";\nimport type { Pluggable, PluggableList, Plugin } from \"unified\";\nimport { VFile } from \"vfile\";\nimport { matter } from \"vfile-matter\";\nimport type { z } from \"zod\";\n\nimport type { HastNode } from \"./types\";\n\nexport { remarkFrontmatterPlugin, remarkGfmPlugin };\n\n/**\n * Represents the source content for an MDX document.\n */\nexport type MdxSource = string | Uint8Array;\n\n/**\n * Options for compiling an MDX document.\n */\nexport interface MdxCompileOptions {\n  frontmatterOnly?: boolean | undefined;\n  mdxOptions?: MdxJsCompileOptions;\n}\n\n/**\n * The result of compiling an MDX document.\n * Compiled content is optional, because sometimes we only need the frontmatter.\n */\nexport interface MdxArtifact<TFrontmatter = Record<string, unknown>> {\n  compiled?: string | undefined;\n  frontmatter: TFrontmatter;\n}\n\n/**\n * A reusable compiler for compiling MDX.\n */\nexport class MdxCompiler {\n  private readonly mdxOptions: MdxJsCompileOptions;\n  private readonly remarkPlugins: PluggableList;\n  private readonly rehypePlugins: PluggableList;\n\n  public constructor(mdxOptions: MdxJsCompileOptions = {}) {\n    this.mdxOptions = mdxOptions;\n    this.remarkPlugins = [remarkFrontmatterPlugin, remarkGfmPlugin];\n    this.rehypePlugins = [];\n  }\n\n  public withRemarkPlugin<TOptions>(\n    plugin: Plugin<[TOptions?], HastNode, HastNode>,\n    options?: TOptions,\n  ): MdxCompiler {\n    if (options === undefined) {\n      this.remarkPlugins.push(plugin as Pluggable);\n    } else {\n      this.remarkPlugins.push([plugin, options] as Pluggable);\n    }\n    return this;\n  }\n\n  public withRehypePlugin<TOptions>(\n    plugin: Plugin<[TOptions?], HastNode, HastNode>,\n    options?: TOptions,\n  ): MdxCompiler {\n    if (options === undefined) {\n      this.rehypePlugins.push(plugin as Pluggable);\n    } else {\n      this.rehypePlugins.push([plugin, options] as Pluggable);\n    }\n    return this;\n  }\n\n  public async compile<TFrontmatterSchema extends z.ZodSchema>(\n    source: MdxSource,\n    { frontmatterOnly = false, mdxOptions }: MdxCompileOptions = {},\n    frontmatterSchema?: TFrontmatterSchema,\n  ): Promise<MdxArtifact<z.output<TFrontmatterSchema>>> {\n    const vfile = new VFile({\n      value: source,\n      // Needed so vfile doesn't need to access fs.\n      cwd: \"/\",\n      path: \"/\",\n      message: {},\n      messages: {},\n    });\n    matter(vfile, { strip: true });\n\n    const remarkPlugins = [\n      ...this.remarkPlugins,\n      ...(this.mdxOptions?.remarkPlugins ?? []),\n      ...(mdxOptions?.remarkPlugins ?? []),\n    ];\n    const rehypePlugins = [\n      ...this.rehypePlugins,\n      ...(this.mdxOptions?.rehypePlugins ?? []),\n      ...(mdxOptions?.rehypePlugins ?? []),\n    ];\n\n    let compiled: string | undefined;\n    if (!frontmatterOnly) {\n      const compiledFile = await compileMdxJs(vfile, {\n        outputFormat: \"function-body\",\n        ...(this.mdxOptions ?? {}),\n        ...(mdxOptions ?? {}),\n        remarkPlugins,\n        rehypePlugins,\n      });\n      compiled = compiledFile.value.toString();\n    }\n\n    const frontmatter =\n      frontmatterSchema === undefined\n        ? (vfile.data.matter ?? {})\n        : frontmatterSchema.parse(vfile.data.matter ?? {});\n\n    return {\n      compiled,\n      frontmatter: frontmatter as z.output<TFrontmatterSchema>,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;AAwCA,IAAa,cAAb,MAAyB;CACvB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,AAAO,YAAY,aAAkC,EAAE,EAAE;AACvD,OAAK,aAAa;AAClB,OAAK,gBAAgB,CAAC,yBAAyB,gBAAgB;AAC/D,OAAK,gBAAgB,EAAE;;CAGzB,AAAO,iBACL,QACA,SACa;AACb,MAAI,YAAY,OACd,MAAK,cAAc,KAAK,OAAoB;MAE5C,MAAK,cAAc,KAAK,CAAC,QAAQ,QAAQ,CAAc;AAEzD,SAAO;;CAGT,AAAO,iBACL,QACA,SACa;AACb,MAAI,YAAY,OACd,MAAK,cAAc,KAAK,OAAoB;MAE5C,MAAK,cAAc,KAAK,CAAC,QAAQ,QAAQ,CAAc;AAEzD,SAAO;;CAGT,MAAa,QACX,QACA,EAAE,kBAAkB,OAAO,eAAkC,EAAE,EAC/D,mBACoD;EACpD,MAAM,QAAQ,IAAI,MAAM;GACtB,OAAO;GAEP,KAAK;GACL,MAAM;GACN,SAAS,EAAE;GACX,UAAU,EAAE;GACb,CAAC;AACF,SAAO,OAAO,EAAE,OAAO,MAAM,CAAC;EAE9B,MAAM,gBAAgB;GACpB,GAAG,KAAK;GACR,GAAI,KAAK,YAAY,iBAAiB,EAAE;GACxC,GAAI,YAAY,iBAAiB,EAAE;GACpC;EACD,MAAM,gBAAgB;GACpB,GAAG,KAAK;GACR,GAAI,KAAK,YAAY,iBAAiB,EAAE;GACxC,GAAI,YAAY,iBAAiB,EAAE;GACpC;EAED,IAAI;AACJ,MAAI,CAAC,gBAQH,aAPqB,MAAMA,QAAa,OAAO;GAC7C,cAAc;GACd,GAAI,KAAK,cAAc,EAAE;GACzB,GAAI,cAAc,EAAE;GACpB;GACA;GACD,CAAC,EACsB,MAAM,UAAU;EAG1C,MAAM,cACJ,sBAAsB,SACjB,MAAM,KAAK,UAAU,EAAE,GACxB,kBAAkB,MAAM,MAAM,KAAK,UAAU,EAAE,CAAC;AAEtD,SAAO;GACL;GACa;GACd"}
+{"version":3,"file":"compiler.mjs","names":["compileMdxJs"],"sources":["../src/compiler.ts"],"sourcesContent":["import {\n  compile as compileMdxJs,\n  type CompileOptions as MdxJsCompileOptions,\n} from \"@mdx-js/mdx\";\nimport remarkFrontmatterPlugin from \"remark-frontmatter\";\nimport remarkGfmPlugin from \"remark-gfm\";\nimport type { Pluggable, PluggableList, Plugin } from \"unified\";\nimport { VFile } from \"vfile\";\nimport { matter } from \"vfile-matter\";\nimport type { z } from \"zod\";\n\nimport type { HastNode } from \"./types\";\n\nexport { remarkFrontmatterPlugin, remarkGfmPlugin };\n\n/**\n * Represents the source content for an MDX document.\n */\nexport type MdxSource = string | Uint8Array;\n\n/**\n * Options for compiling an MDX document.\n */\nexport interface MdxCompileOptions {\n  frontmatterOnly?: boolean | undefined;\n  mdxOptions?: MdxJsCompileOptions;\n}\n\nexport interface MdxMessagePoint {\n  line?: number | undefined;\n  column?: number | undefined;\n  offset?: number | undefined;\n}\n\nexport interface MdxMessagePlace {\n  start?: MdxMessagePoint | undefined;\n  end?: MdxMessagePoint | undefined;\n}\n\nexport interface MdxMessage {\n  message: string;\n  reason: string;\n  source?: string | undefined;\n  ruleId?: string | undefined;\n  fatal?: boolean | undefined;\n  line?: number | undefined;\n  column?: number | undefined;\n  place?: MdxMessagePlace | undefined;\n  sourceLine?: string | undefined;\n  snippet?: string | undefined;\n  cause?: {\n    name?: string | undefined;\n    message: string;\n  };\n}\n\ntype VFileLikeMessage = VFile[\"messages\"][number];\n\n/**\n * The result of compiling an MDX document.\n * Compiled content is optional, because sometimes we only need the frontmatter.\n */\nexport interface MdxArtifact<TFrontmatter = Record<string, unknown>> {\n  compiled?: string | undefined;\n  frontmatter: TFrontmatter;\n  messages: MdxMessage[];\n}\n\nexport class MdxCompileError extends Error {\n  public readonly reason: string;\n  public readonly source?: string | undefined;\n  public readonly ruleId?: string | undefined;\n  public readonly line?: number | undefined;\n  public readonly column?: number | undefined;\n  public readonly place?: MdxMessagePlace | undefined;\n  public readonly sourceLine?: string | undefined;\n  public readonly snippet?: string | undefined;\n  public readonly diagnostics: MdxMessage[];\n\n  public constructor(\n    reason: string,\n    options: {\n      source?: string | undefined;\n      ruleId?: string | undefined;\n      line?: number | undefined;\n      column?: number | undefined;\n      place?: MdxMessagePlace | undefined;\n      sourceLine?: string | undefined;\n      snippet?: string | undefined;\n      diagnostics?: MdxMessage[] | undefined;\n      cause?: unknown;\n    } = {},\n  ) {\n    super(\n      formatDiagnosticMessage(reason, {\n        source: options.source,\n        ruleId: options.ruleId,\n        line: options.line,\n        column: options.column,\n        sourceLine: options.sourceLine,\n        snippet: options.snippet,\n      }),\n      options.cause === undefined ? undefined : { cause: options.cause },\n    );\n\n    this.name = \"MdxCompileError\";\n    this.reason = reason;\n    this.source = options.source;\n    this.ruleId = options.ruleId;\n    this.line = options.line;\n    this.column = options.column;\n    this.place = options.place;\n    this.sourceLine = options.sourceLine;\n    this.snippet = options.snippet;\n    this.diagnostics = options.diagnostics ?? [];\n  }\n}\n\n/**\n * A reusable compiler for compiling MDX.\n */\nexport class MdxCompiler {\n  private readonly mdxOptions: MdxJsCompileOptions;\n  private readonly remarkPlugins: PluggableList;\n  private readonly rehypePlugins: PluggableList;\n\n  public constructor(mdxOptions: MdxJsCompileOptions = {}) {\n    this.mdxOptions = mdxOptions;\n    this.remarkPlugins = [remarkFrontmatterPlugin, remarkGfmPlugin];\n    this.rehypePlugins = [];\n  }\n\n  public withRemarkPlugin<TOptions>(\n    plugin: Plugin<[TOptions?], HastNode, HastNode>,\n    options?: TOptions,\n  ): MdxCompiler {\n    if (options === undefined) {\n      this.remarkPlugins.push(plugin as Pluggable);\n    } else {\n      this.remarkPlugins.push([plugin, options] as Pluggable);\n    }\n    return this;\n  }\n\n  public withRehypePlugin<TOptions>(\n    plugin: Plugin<[TOptions?], HastNode, HastNode>,\n    options?: TOptions,\n  ): MdxCompiler {\n    if (options === undefined) {\n      this.rehypePlugins.push(plugin as Pluggable);\n    } else {\n      this.rehypePlugins.push([plugin, options] as Pluggable);\n    }\n    return this;\n  }\n\n  public async compile<TFrontmatterSchema extends z.ZodSchema>(\n    source: MdxSource,\n    { frontmatterOnly = false, mdxOptions }: MdxCompileOptions = {},\n    frontmatterSchema?: TFrontmatterSchema,\n  ): Promise<MdxArtifact<z.output<TFrontmatterSchema>>> {\n    const sourceText = toSourceText(source);\n    const vfile = new VFile({\n      value: source,\n      // Needed so vfile doesn't need to access fs.\n      cwd: \"/\",\n      path: \"/source.mdx\",\n    });\n    matter(vfile, { strip: true });\n\n    const remarkPlugins = [\n      ...this.remarkPlugins,\n      ...(this.mdxOptions?.remarkPlugins ?? []),\n      ...(mdxOptions?.remarkPlugins ?? []),\n    ];\n    const rehypePlugins = [\n      ...this.rehypePlugins,\n      ...(this.mdxOptions?.rehypePlugins ?? []),\n      ...(mdxOptions?.rehypePlugins ?? []),\n    ];\n\n    let compiled: string | undefined;\n    if (!frontmatterOnly) {\n      try {\n        const compiledFile = await compileMdxJs(vfile, {\n          outputFormat: \"function-body\",\n          ...(this.mdxOptions ?? {}),\n          ...(mdxOptions ?? {}),\n          remarkPlugins,\n          rehypePlugins,\n        });\n        compiled = compiledFile.value.toString();\n      } catch (error) {\n        throw toMdxCompileError(error, sourceText, vfile.messages);\n      }\n    }\n\n    const frontmatter =\n      frontmatterSchema === undefined\n        ? (vfile.data.matter ?? {})\n        : (frontmatterSchema as z.ZodSchema).parse(vfile.data.matter ?? {});\n\n    return {\n      compiled,\n      frontmatter: frontmatter as z.output<TFrontmatterSchema>,\n      messages: normalizeMessages(vfile.messages, sourceText),\n    };\n  }\n}\n\nfunction toMdxCompileError(\n  error: unknown,\n  sourceText: string,\n  diagnostics: readonly VFileLikeMessage[],\n): MdxCompileError {\n  const details = getDiagnosticDetails(sourceText, getErrorPlace(error), error);\n\n  return new MdxCompileError(getErrorReason(error), {\n    source: getErrorField(error, \"source\"),\n    ruleId: getErrorField(error, \"ruleId\"),\n    line: details.line,\n    column: details.column,\n    place: details.place,\n    sourceLine: details.sourceLine,\n    snippet: details.snippet,\n    diagnostics: normalizeMessages(diagnostics, sourceText),\n    cause: error,\n  });\n}\n\nfunction normalizeMessages(\n  messages: readonly VFileLikeMessage[],\n  sourceText: string,\n): MdxMessage[] {\n  return messages.map((message) => {\n    const details = getDiagnosticDetails(\n      sourceText,\n      toMessagePlace(message),\n      message,\n    );\n    const reason = getErrorReason(message);\n    const source = getErrorField(message, \"source\");\n    const ruleId = getErrorField(message, \"ruleId\");\n    const cause = getErrorCause(message);\n\n    return {\n      message: formatDiagnosticMessage(reason, {\n        source,\n        ruleId,\n        line: details.line,\n        column: details.column,\n        sourceLine: details.sourceLine,\n        snippet: details.snippet,\n        causeMessage: cause?.message,\n      }),\n      reason,\n      source,\n      ruleId,\n      fatal: typeof message.fatal === \"boolean\" ? message.fatal : undefined,\n      line: details.line,\n      column: details.column,\n      place: details.place,\n      sourceLine: details.sourceLine,\n      snippet: details.snippet,\n      cause,\n    };\n  });\n}\n\nfunction formatDiagnosticMessage(\n  reason: string,\n  options: {\n    source?: string | undefined;\n    ruleId?: string | undefined;\n    line?: number | undefined;\n    column?: number | undefined;\n    sourceLine?: string | undefined;\n    snippet?: string | undefined;\n    causeMessage?: string | undefined;\n  },\n): string {\n  const origin =\n    options.source === undefined\n      ? undefined\n      : options.ruleId === undefined\n        ? options.source\n        : `${options.source}:${options.ruleId}`;\n  const location =\n    options.line === undefined\n      ? undefined\n      : options.column === undefined\n        ? `at ${options.line}`\n        : `at ${options.line}:${options.column}`;\n\n  const lines = [[reason, origin, location].filter(Boolean).join(\" \")];\n\n  if (options.snippet !== undefined) {\n    lines.push(`Source: ${options.snippet}`);\n  }\n  if (\n    options.sourceLine !== undefined &&\n    options.sourceLine !== options.snippet\n  ) {\n    lines.push(`Line: ${options.sourceLine}`);\n  }\n  if (\n    options.causeMessage !== undefined &&\n    options.causeMessage !== \"\" &&\n    options.causeMessage !== reason\n  ) {\n    lines.push(`Cause: ${options.causeMessage}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction getDiagnosticDetails(\n  sourceText: string,\n  place: MdxMessagePlace | undefined,\n  error: unknown,\n): {\n  line?: number | undefined;\n  column?: number | undefined;\n  place?: MdxMessagePlace | undefined;\n  sourceLine?: string | undefined;\n  snippet?: string | undefined;\n} {\n  const line = place?.start?.line ?? getErrorNumberField(error, \"line\");\n  const column = place?.start?.column ?? getErrorNumberField(error, \"column\");\n  const normalizedPlace =\n    line === undefined && column === undefined && place === undefined\n      ? undefined\n      : {\n          start: {\n            line,\n            column,\n            offset: place?.start?.offset,\n          },\n          end:\n            place?.end === undefined\n              ? undefined\n              : {\n                  line: place.end.line,\n                  column: place.end.column,\n                  offset: place.end.offset,\n                },\n        };\n\n  return {\n    line,\n    column,\n    place: normalizedPlace,\n    sourceLine: getSourceLine(sourceText, line),\n    snippet: getSourceSnippet(sourceText, normalizedPlace),\n  };\n}\n\nfunction getSourceLine(\n  sourceText: string,\n  line: number | undefined,\n): string | undefined {\n  if (line === undefined || line < 1) {\n    return undefined;\n  }\n  return sourceText.split(/\\r?\\n/u)[line - 1];\n}\n\nfunction getSourceSnippet(\n  sourceText: string,\n  place: MdxMessagePlace | undefined,\n): string | undefined {\n  if (place?.start?.offset !== undefined && place.end?.offset !== undefined) {\n    return sourceText.slice(place.start.offset, place.end.offset) || undefined;\n  }\n\n  if (place?.start?.line === undefined || place.start.column === undefined) {\n    return undefined;\n  }\n\n  const lines = sourceText.split(/\\r?\\n/u);\n  const startLineIndex = place.start.line - 1;\n  const endLineIndex = (place.end?.line ?? place.start.line) - 1;\n\n  if (startLineIndex < 0 || startLineIndex >= lines.length) {\n    return undefined;\n  }\n\n  const selectedLines = lines.slice(startLineIndex, endLineIndex + 1);\n  if (selectedLines.length === 0) {\n    return undefined;\n  }\n\n  selectedLines[0] = selectedLines[0].slice(place.start.column - 1);\n\n  const endColumn = place.end?.column;\n  if (endColumn !== undefined) {\n    const lastIndex = selectedLines.length - 1;\n    selectedLines[lastIndex] = selectedLines[lastIndex].slice(0, endColumn - 1);\n  }\n\n  return selectedLines.join(\"\\n\") || undefined;\n}\n\nfunction getErrorPlace(error: unknown): MdxMessagePlace | undefined {\n  if (typeof error !== \"object\" || error === null) {\n    return undefined;\n  }\n\n  const candidate = error as {\n    place?: unknown;\n    position?: unknown;\n  };\n\n  return toPlace(candidate.place) ?? toPlace(candidate.position);\n}\n\nfunction toMessagePlace(\n  message: VFileLikeMessage,\n): MdxMessagePlace | undefined {\n  return toPlace(message.place);\n}\n\nfunction toPlace(value: unknown): MdxMessagePlace | undefined {\n  if (typeof value !== \"object\" || value === null) {\n    return undefined;\n  }\n\n  const candidate = value as {\n    start?: unknown;\n    end?: unknown;\n    line?: unknown;\n    column?: unknown;\n    offset?: unknown;\n  };\n\n  if (candidate.start !== undefined || candidate.end !== undefined) {\n    return {\n      start: toPoint(candidate.start),\n      end: toPoint(candidate.end),\n    };\n  }\n\n  const point = toPoint(candidate);\n  return point === undefined ? undefined : { start: point };\n}\n\nfunction toPoint(value: unknown): MdxMessagePoint | undefined {\n  if (typeof value !== \"object\" || value === null) {\n    return undefined;\n  }\n\n  const candidate = value as {\n    line?: unknown;\n    column?: unknown;\n    offset?: unknown;\n  };\n  const line = typeof candidate.line === \"number\" ? candidate.line : undefined;\n  const column =\n    typeof candidate.column === \"number\" ? candidate.column : undefined;\n  const offset =\n    typeof candidate.offset === \"number\" ? candidate.offset : undefined;\n\n  if (line === undefined && column === undefined && offset === undefined) {\n    return undefined;\n  }\n\n  return { line, column, offset };\n}\n\nfunction getErrorReason(error: unknown): string {\n  if (error instanceof Error && error.message !== \"\") {\n    return error.message;\n  }\n\n  const reason = getErrorField(error, \"reason\");\n  if (reason !== undefined && reason !== \"\") {\n    return reason;\n  }\n\n  return String(error);\n}\n\nfunction getErrorCause(\n  error: unknown,\n): { name?: string | undefined; message: string } | undefined {\n  if (typeof error !== \"object\" || error === null || !(\"cause\" in error)) {\n    return undefined;\n  }\n\n  const cause = (error as { cause?: unknown }).cause;\n  if (cause instanceof Error) {\n    return {\n      name: cause.name,\n      message: cause.message,\n    };\n  }\n  if (typeof cause === \"string\" && cause !== \"\") {\n    return {\n      message: cause,\n    };\n  }\n\n  return undefined;\n}\n\nfunction getErrorField(\n  error: unknown,\n  field: \"source\" | \"ruleId\" | \"reason\",\n): string | undefined {\n  if (typeof error !== \"object\" || error === null || !(field in error)) {\n    return undefined;\n  }\n\n  const value = (error as Record<string, unknown>)[field];\n  return typeof value === \"string\" && value !== \"\" ? value : undefined;\n}\n\nfunction getErrorNumberField(\n  error: unknown,\n  field: \"line\" | \"column\",\n): number | undefined {\n  if (typeof error !== \"object\" || error === null || !(field in error)) {\n    return undefined;\n  }\n\n  const value = (error as Record<string, unknown>)[field];\n  return typeof value === \"number\" ? value : undefined;\n}\n\nfunction toSourceText(source: MdxSource): string {\n  return typeof source === \"string\" ? source : new TextDecoder().decode(source);\n}\n"],"mappings":"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"}

package/dist/mod.d.mts

@@ -1,8 +1,7 @@
 import { HastElement as Element, HastNode as Node } from "./types.mjs";
-import { MdxArtifact, MdxCompileOptions, MdxCompiler, MdxSource, remarkFrontmatterPlugin, remarkGfmPlugin } from "./compiler.mjs";
+import { MdxArtifact, MdxCompileError, MdxCompileOptions, MdxCompiler, MdxMessage, MdxMessagePlace, MdxMessagePoint, MdxSource, remarkFrontmatterPlugin, remarkGfmPlugin } from "./compiler.mjs";
 import { HeadingIdPluginOptions, headingIdPlugin } from "./plugins/heading-id/plugin.mjs";
 import { removeImportsExportsPlugin } from "./plugins/remove-imports-exports.mjs";
 import { SyntaxHighlightPluginOptions, syntaxHighlightPlugin } from "./plugins/syntax-highlight/plugin.mjs";
 import { MdxTreeProcessor, treeProcessorPlugin } from "./plugins/tree-processor/plugin.mjs";
-import "./plugins/mod.mjs";
-export { Element as HastElement, Node as HastNode, HeadingIdPluginOptions, MdxArtifact, MdxCompileOptions, MdxCompiler, MdxSource, MdxTreeProcessor, SyntaxHighlightPluginOptions, headingIdPlugin, remarkFrontmatterPlugin, remarkGfmPlugin, removeImportsExportsPlugin, syntaxHighlightPlugin, treeProcessorPlugin };
+export { Element as HastElement, Node as HastNode, HeadingIdPluginOptions, MdxArtifact, MdxCompileError, MdxCompileOptions, MdxCompiler, MdxMessage, MdxMessagePlace, MdxMessagePoint, MdxSource, MdxTreeProcessor, SyntaxHighlightPluginOptions, headingIdPlugin, remarkFrontmatterPlugin, remarkGfmPlugin, removeImportsExportsPlugin, syntaxHighlightPlugin, treeProcessorPlugin };

package/dist/mod.mjs

@@ -1,8 +1,7 @@
-import { MdxCompiler, remarkFrontmatterPlugin, remarkGfmPlugin } from "./compiler.mjs";
+import { MdxCompileError, MdxCompiler, remarkFrontmatterPlugin, remarkGfmPlugin } from "./compiler.mjs";
 import { headingIdPlugin } from "./plugins/heading-id/plugin.mjs";
 import { removeImportsExportsPlugin } from "./plugins/remove-imports-exports.mjs";
 import { syntaxHighlightPlugin } from "./plugins/syntax-highlight/plugin.mjs";
 import { treeProcessorPlugin } from "./plugins/tree-processor/plugin.mjs";
 import "./plugins/mod.mjs";
-
-export { MdxCompiler, headingIdPlugin, remarkFrontmatterPlugin, remarkGfmPlugin, removeImportsExportsPlugin, syntaxHighlightPlugin, treeProcessorPlugin };
+export { MdxCompileError, MdxCompiler, headingIdPlugin, remarkFrontmatterPlugin, remarkGfmPlugin, removeImportsExportsPlugin, syntaxHighlightPlugin, treeProcessorPlugin };

package/dist/plugins/heading-id/plugin.mjs

@@ -1,7 +1,6 @@
 import GithubSlugger from "github-slugger";
 import { toString } from "hast-util-to-string";
 import { visit } from "unist-util-visit";
-
 //#region src/plugins/heading-id/plugin.ts
 /**
 * A rehype plugin that adds IDs to heading tags.
@@ -18,7 +17,7 @@ const headingIdPlugin = ({ prefix } = {}) => {
 		return tree;
 	};
 };
-
 //#endregion
 export { headingIdPlugin };
+
 //# sourceMappingURL=plugin.mjs.map

package/dist/plugins/heading-id/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":["hastToString"],"sources":["../../../src/plugins/heading-id/plugin.ts"],"sourcesContent":["import GithubSlugger from \"github-slugger\";\nimport { toString as hastToString } from \"hast-util-to-string\";\nimport type { Plugin } from \"unified\";\nimport { visit } from \"unist-util-visit\";\n\nimport type { HastElement, HastNode } from \"../../types\";\n\n/**\n * Options for {@linkcode headingIdPlugin}.\n */\nexport interface HeadingIdPluginOptions {\n  /** Prefix for title slugs. */\n  prefix?: string;\n}\n\n/**\n * A rehype plugin that adds IDs to heading tags.\n */\nexport const headingIdPlugin: Plugin<\n  [HeadingIdPluginOptions?],\n  HastNode,\n  HastNode\n> = ({ prefix } = {}) => {\n  const slugger = new GithubSlugger();\n  return (tree) => {\n    slugger.reset();\n    visit(\n      tree,\n      \"element\",\n      function visitor(\n        node: HastElement,\n        index: number,\n        parent: HastElement,\n      ): void {\n        if (!parent || index === null || !node.tagName.startsWith(\"h\")) return;\n        const id = (prefix ?? \"\") + slugger.slug(hastToString(node));\n        node.properties.id = id;\n      },\n    );\n    return tree;\n  };\n};\n"],"mappings":";;;;;;;;AAkBA,MAAa,mBAIR,EAAE,WAAW,EAAE,KAAK;CACvB,MAAM,UAAU,IAAI,eAAe;AACnC,SAAQ,SAAS;AACf,UAAQ,OAAO;AACf,QACE,MACA,WACA,SAAS,QACP,MACA,OACA,QACM;AACN,OAAI,CAAC,UAAU,UAAU,QAAQ,CAAC,KAAK,QAAQ,WAAW,IAAI,CAAE;GAChE,MAAM,MAAM,UAAU,MAAM,QAAQ,KAAKA,SAAa,KAAK,CAAC;AAC5D,QAAK,WAAW,KAAK;IAExB;AACD,SAAO"}
+{"version":3,"file":"plugin.mjs","names":["hastToString"],"sources":["../../../src/plugins/heading-id/plugin.ts"],"sourcesContent":["import GithubSlugger from \"github-slugger\";\nimport { toString as hastToString } from \"hast-util-to-string\";\nimport type { Plugin } from \"unified\";\nimport { visit } from \"unist-util-visit\";\n\nimport type { HastElement, HastNode } from \"../../types\";\n\n/**\n * Options for {@linkcode headingIdPlugin}.\n */\nexport interface HeadingIdPluginOptions {\n  /** Prefix for title slugs. */\n  prefix?: string;\n}\n\n/**\n * A rehype plugin that adds IDs to heading tags.\n */\nexport const headingIdPlugin: Plugin<\n  [HeadingIdPluginOptions?],\n  HastNode,\n  HastNode\n> = ({ prefix } = {}) => {\n  const slugger = new GithubSlugger();\n  return (tree) => {\n    slugger.reset();\n    visit(\n      tree,\n      \"element\",\n      function visitor(\n        node: HastElement,\n        index: number,\n        parent: HastElement,\n      ): void {\n        if (!parent || index === null || !node.tagName.startsWith(\"h\")) return;\n        const id = (prefix ?? \"\") + slugger.slug(hastToString(node));\n        node.properties.id = id;\n      },\n    );\n    return tree;\n  };\n};\n"],"mappings":";;;;;;;AAkBA,MAAa,mBAIR,EAAE,WAAW,EAAE,KAAK;CACvB,MAAM,UAAU,IAAI,eAAe;AACnC,SAAQ,SAAS;AACf,UAAQ,OAAO;AACf,QACE,MACA,WACA,SAAS,QACP,MACA,OACA,QACM;AACN,OAAI,CAAC,UAAU,UAAU,QAAQ,CAAC,KAAK,QAAQ,WAAW,IAAI,CAAE;GAChE,MAAM,MAAM,UAAU,MAAM,QAAQ,KAAKA,SAAa,KAAK,CAAC;AAC5D,QAAK,WAAW,KAAK;IAExB;AACD,SAAO"}

package/dist/plugins/mod.mjs

@@ -2,5 +2,4 @@ import { headingIdPlugin } from "./heading-id/plugin.mjs";
 import { removeImportsExportsPlugin } from "./remove-imports-exports.mjs";
 import { syntaxHighlightPlugin } from "./syntax-highlight/plugin.mjs";
 import { treeProcessorPlugin } from "./tree-processor/plugin.mjs";
-
-export { headingIdPlugin, removeImportsExportsPlugin, syntaxHighlightPlugin, treeProcessorPlugin };
+export { headingIdPlugin, removeImportsExportsPlugin, syntaxHighlightPlugin, treeProcessorPlugin };

package/dist/plugins/remove-imports-exports.mjs

@@ -1,5 +1,4 @@
 import { remove } from "unist-util-remove";
-
 //#region src/plugins/remove-imports-exports.ts
 /**
 * A remark plugin which removes all import and export statements.
@@ -10,7 +9,7 @@ const removeImportsExportsPlugin = () => {
 		return tree;
 	};
 };
-
 //#endregion
 export { removeImportsExportsPlugin };
+
 //# sourceMappingURL=remove-imports-exports.mjs.map

package/dist/plugins/remove-imports-exports.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"remove-imports-exports.mjs","names":[],"sources":["../../src/plugins/remove-imports-exports.ts"],"sourcesContent":["import type { Plugin } from \"unified\";\nimport { remove } from \"unist-util-remove\";\n\nimport type { HastNode } from \"../types\";\n\n/**\n * A remark plugin which removes all import and export statements.\n */\nexport const removeImportsExportsPlugin: Plugin<\n  [unknown],\n  HastNode,\n  HastNode\n> = () => {\n  return (tree: HastNode) => {\n    remove(tree, \"mdxjsEsm\");\n    return tree;\n  };\n};\n"],"mappings":";;;;;;AAQA,MAAa,mCAIH;AACR,SAAQ,SAAmB;AACzB,SAAO,MAAM,WAAW;AACxB,SAAO"}
+{"version":3,"file":"remove-imports-exports.mjs","names":[],"sources":["../../src/plugins/remove-imports-exports.ts"],"sourcesContent":["import type { Plugin } from \"unified\";\nimport { remove } from \"unist-util-remove\";\n\nimport type { HastNode } from \"../types\";\n\n/**\n * A remark plugin which removes all import and export statements.\n */\nexport const removeImportsExportsPlugin: Plugin<\n  [unknown],\n  HastNode,\n  HastNode\n> = () => {\n  return (tree: HastNode) => {\n    remove(tree, \"mdxjsEsm\");\n    return tree;\n  };\n};\n"],"mappings":";;;;;AAQA,MAAa,mCAIH;AACR,SAAQ,SAAmB;AACzB,SAAO,MAAM,WAAW;AACxB,SAAO"}

package/dist/plugins/syntax-highlight/code-meta.mjs

@@ -1,6 +1,5 @@
 import { parseNumericRange } from "@temelj/iterator";
 import * as z$1 from "zod";
-
 //#region src/plugins/syntax-highlight/code-meta.ts
 function extractCodeMeta(node) {
 	return parseMetaString(node?.data?.meta ?? node?.properties?.metastring ?? "");
@@ -32,7 +31,7 @@ function parseMetaString(meta) {
 	if (parsed.fileName !== void 0) options.fileName = parsed.fileName.trim();
 	return options;
 }
-
 //#endregion
 export { extractCodeMeta };
+
 //# sourceMappingURL=code-meta.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"code-meta.mjs","names":["z"],"sources":["../../../src/plugins/syntax-highlight/code-meta.ts"],"sourcesContent":["import { type NumericRange, parseNumericRange } from \"@temelj/iterator\";\nimport * as z from \"zod\";\n\nimport type { HastElement } from \"../../types\";\n\nexport interface MdxCodeMeta {\n  highlight?: MdxCodeMetaHighlightLine;\n  showLineNumbers?: MdxCodeMetaLineNumbers;\n  commandLine?: MdxCodeMetaCommandLine;\n  fileName?: string;\n}\n\nexport type MdxCodeMetaHighlightLine = {\n  lineRange: NumericRange;\n};\n\nexport type MdxCodeMetaLineNumbers = {\n  lineRange: NumericRange;\n};\n\nexport type MdxCodeMetaCommandLine = {\n  commandRange: NumericRange;\n};\n\nexport function extractCodeMeta(node: HastElement): MdxCodeMeta {\n  const meta = node?.data?.meta ?? node?.properties?.metastring ?? \"\";\n  return parseMetaString(meta as string);\n}\n\nconst metaSchema = z.object({\n  highlight: z.optional(z.string()),\n  showLineNumbers: z.optional(z.union([z.boolean(), z.string()])),\n  commandLine: z.optional(z.union([z.boolean(), z.string()])),\n  fileName: z.optional(z.string()),\n});\n\nfunction parseMetaString(meta: string): MdxCodeMeta {\n  let raw: unknown;\n  try {\n    raw = JSON.parse(meta.trim());\n  } catch {\n    return {};\n  }\n  const parsed = metaSchema.parse(raw);\n  const options: MdxCodeMeta = {};\n\n  if (parsed.highlight !== undefined) {\n    options.highlight = { lineRange: parseNumericRange(parsed.highlight) };\n  }\n\n  if (parsed.showLineNumbers !== undefined) {\n    if (typeof parsed.showLineNumbers === \"string\") {\n      options.showLineNumbers = {\n        lineRange: parseNumericRange(parsed.showLineNumbers),\n      };\n    } else if (parsed.showLineNumbers) {\n      options.showLineNumbers = { lineRange: [] };\n    }\n  }\n\n  if (parsed.commandLine !== undefined) {\n    if (typeof parsed.commandLine === \"string\") {\n      options.commandLine = {\n        commandRange: parseNumericRange(parsed.commandLine),\n      };\n    } else if (parsed.commandLine) {\n      options.commandLine = { commandRange: [] };\n    }\n  }\n\n  if (parsed.fileName !== undefined) {\n    options.fileName = parsed.fileName.trim();\n  }\n\n  return options;\n}\n"],"mappings":";;;;AAwBA,SAAgB,gBAAgB,MAAgC;AAE9D,QAAO,gBADM,MAAM,MAAM,QAAQ,MAAM,YAAY,cAAc,GAC3B;;AAGxC,MAAM,aAAaA,IAAE,OAAO;CAC1B,WAAWA,IAAE,SAASA,IAAE,QAAQ,CAAC;CACjC,iBAAiBA,IAAE,SAASA,IAAE,MAAM,CAACA,IAAE,SAAS,EAAEA,IAAE,QAAQ,CAAC,CAAC,CAAC;CAC/D,aAAaA,IAAE,SAASA,IAAE,MAAM,CAACA,IAAE,SAAS,EAAEA,IAAE,QAAQ,CAAC,CAAC,CAAC;CAC3D,UAAUA,IAAE,SAASA,IAAE,QAAQ,CAAC;CACjC,CAAC;AAEF,SAAS,gBAAgB,MAA2B;CAClD,IAAI;AACJ,KAAI;AACF,QAAM,KAAK,MAAM,KAAK,MAAM,CAAC;SACvB;AACN,SAAO,EAAE;;CAEX,MAAM,SAAS,WAAW,MAAM,IAAI;CACpC,MAAM,UAAuB,EAAE;AAE/B,KAAI,OAAO,cAAc,OACvB,SAAQ,YAAY,EAAE,WAAW,kBAAkB,OAAO,UAAU,EAAE;AAGxE,KAAI,OAAO,oBAAoB,QAC7B;MAAI,OAAO,OAAO,oBAAoB,SACpC,SAAQ,kBAAkB,EACxB,WAAW,kBAAkB,OAAO,gBAAgB,EACrD;WACQ,OAAO,gBAChB,SAAQ,kBAAkB,EAAE,WAAW,EAAE,EAAE;;AAI/C,KAAI,OAAO,gBAAgB,QACzB;MAAI,OAAO,OAAO,gBAAgB,SAChC,SAAQ,cAAc,EACpB,cAAc,kBAAkB,OAAO,YAAY,EACpD;WACQ,OAAO,YAChB,SAAQ,cAAc,EAAE,cAAc,EAAE,EAAE;;AAI9C,KAAI,OAAO,aAAa,OACtB,SAAQ,WAAW,OAAO,SAAS,MAAM;AAG3C,QAAO"}
+{"version":3,"file":"code-meta.mjs","names":["z"],"sources":["../../../src/plugins/syntax-highlight/code-meta.ts"],"sourcesContent":["import { type NumericRange, parseNumericRange } from \"@temelj/iterator\";\nimport * as z from \"zod\";\n\nimport type { HastElement } from \"../../types\";\n\nexport interface MdxCodeMeta {\n  highlight?: MdxCodeMetaHighlightLine;\n  showLineNumbers?: MdxCodeMetaLineNumbers;\n  commandLine?: MdxCodeMetaCommandLine;\n  fileName?: string;\n}\n\nexport type MdxCodeMetaHighlightLine = {\n  lineRange: NumericRange;\n};\n\nexport type MdxCodeMetaLineNumbers = {\n  lineRange: NumericRange;\n};\n\nexport type MdxCodeMetaCommandLine = {\n  commandRange: NumericRange;\n};\n\nexport function extractCodeMeta(node: HastElement): MdxCodeMeta {\n  const meta = node?.data?.meta ?? node?.properties?.metastring ?? \"\";\n  return parseMetaString(meta as string);\n}\n\nconst metaSchema = z.object({\n  highlight: z.optional(z.string()),\n  showLineNumbers: z.optional(z.union([z.boolean(), z.string()])),\n  commandLine: z.optional(z.union([z.boolean(), z.string()])),\n  fileName: z.optional(z.string()),\n});\n\nfunction parseMetaString(meta: string): MdxCodeMeta {\n  let raw: unknown;\n  try {\n    raw = JSON.parse(meta.trim());\n  } catch {\n    return {};\n  }\n  const parsed = metaSchema.parse(raw);\n  const options: MdxCodeMeta = {};\n\n  if (parsed.highlight !== undefined) {\n    options.highlight = { lineRange: parseNumericRange(parsed.highlight) };\n  }\n\n  if (parsed.showLineNumbers !== undefined) {\n    if (typeof parsed.showLineNumbers === \"string\") {\n      options.showLineNumbers = {\n        lineRange: parseNumericRange(parsed.showLineNumbers),\n      };\n    } else if (parsed.showLineNumbers) {\n      options.showLineNumbers = { lineRange: [] };\n    }\n  }\n\n  if (parsed.commandLine !== undefined) {\n    if (typeof parsed.commandLine === \"string\") {\n      options.commandLine = {\n        commandRange: parseNumericRange(parsed.commandLine),\n      };\n    } else if (parsed.commandLine) {\n      options.commandLine = { commandRange: [] };\n    }\n  }\n\n  if (parsed.fileName !== undefined) {\n    options.fileName = parsed.fileName.trim();\n  }\n\n  return options;\n}\n"],"mappings":";;;AAwBA,SAAgB,gBAAgB,MAAgC;AAE9D,QAAO,gBADM,MAAM,MAAM,QAAQ,MAAM,YAAY,cAAc,GAC3B;;AAGxC,MAAM,aAAaA,IAAE,OAAO;CAC1B,WAAWA,IAAE,SAASA,IAAE,QAAQ,CAAC;CACjC,iBAAiBA,IAAE,SAASA,IAAE,MAAM,CAACA,IAAE,SAAS,EAAEA,IAAE,QAAQ,CAAC,CAAC,CAAC;CAC/D,aAAaA,IAAE,SAASA,IAAE,MAAM,CAACA,IAAE,SAAS,EAAEA,IAAE,QAAQ,CAAC,CAAC,CAAC;CAC3D,UAAUA,IAAE,SAASA,IAAE,QAAQ,CAAC;CACjC,CAAC;AAEF,SAAS,gBAAgB,MAA2B;CAClD,IAAI;AACJ,KAAI;AACF,QAAM,KAAK,MAAM,KAAK,MAAM,CAAC;SACvB;AACN,SAAO,EAAE;;CAEX,MAAM,SAAS,WAAW,MAAM,IAAI;CACpC,MAAM,UAAuB,EAAE;AAE/B,KAAI,OAAO,cAAc,KAAA,EACvB,SAAQ,YAAY,EAAE,WAAW,kBAAkB,OAAO,UAAU,EAAE;AAGxE,KAAI,OAAO,oBAAoB,KAAA;MACzB,OAAO,OAAO,oBAAoB,SACpC,SAAQ,kBAAkB,EACxB,WAAW,kBAAkB,OAAO,gBAAgB,EACrD;WACQ,OAAO,gBAChB,SAAQ,kBAAkB,EAAE,WAAW,EAAE,EAAE;;AAI/C,KAAI,OAAO,gBAAgB,KAAA;MACrB,OAAO,OAAO,gBAAgB,SAChC,SAAQ,cAAc,EACpB,cAAc,kBAAkB,OAAO,YAAY,EACpD;WACQ,OAAO,YAChB,SAAQ,cAAc,EAAE,cAAc,EAAE,EAAE;;AAI9C,KAAI,OAAO,aAAa,KAAA,EACtB,SAAQ,WAAW,OAAO,SAAS,MAAM;AAG3C,QAAO"}

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

@@ -4,7 +4,6 @@ import { visit } from "unist-util-visit";
 import { transformerNotationHighlight } from "@shikijs/transformers";
 import { numericRangeContains } from "@temelj/iterator";
 import { ShikiError, codeToHast } from "shiki";
-
 //#region src/plugins/syntax-highlight/plugin.ts
 /**
 * A plugin that highlights code blocks using Shiki.
@@ -88,7 +87,7 @@ function getNodeLanguage(node) {
 	if (typeof language === "string") return language.slice(9);
 	return language;
 }
-
 //#endregion
 export { syntaxHighlightPlugin };
+
 //# sourceMappingURL=plugin.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":["hastToString"],"sources":["../../../src/plugins/syntax-highlight/plugin.ts"],"sourcesContent":["import {\n  type TransformerNotationHighlightOptions,\n  transformerNotationHighlight,\n} from \"@shikijs/transformers\";\nimport { numericRangeContains } from \"@temelj/iterator\";\nimport type { Properties } from \"hast\";\nimport { toString as hastToString } from \"hast-util-to-string\";\nimport {\n  type BundledLanguage,\n  type BundledTheme,\n  type CodeToHastOptions,\n  codeToHast,\n  ShikiError,\n} from \"shiki\";\nimport type { Plugin } from \"unified\";\nimport { visit } from \"unist-util-visit\";\n\nimport type { HastElement, HastNode } from \"../../types\";\nimport { extractCodeMeta } from \"./code-meta\";\n\ntype ShikiHastOptions = Partial<\n  CodeToHastOptions<BundledLanguage, BundledTheme>\n>;\n\ntype SyntaxDataAttribute = \"source-code\" | \"language\" | \"line-count\";\n\n/**\n * Options for {@linkcode syntaxHighlightPlugin}.\n */\nexport interface SyntaxHighlightPluginOptions {\n  /**\n   * Include these data attributes on the `<pre>` element.\n   * These might be useful to have when building custom code components.\n   */\n  includeDataAttributes?: SyntaxDataAttribute[];\n\n  /**\n   * Options for the highlight transformer.\n   */\n  highlight?: {\n    transformer?: TransformerNotationHighlightOptions;\n  };\n\n  /**\n   * Options for line numbers.\n   */\n  lineNumbers?: {\n    /**\n     * The name of the variable that contains the line number width.\n     * This is used for padding the line numbers so that they align.\n     */\n    widthVariableName?: string;\n    /**\n     * A class name to be added to the line numbers.\n     */\n    className?: string;\n  };\n\n  /**\n   * Options for command line.\n   */\n  commandLine?: {\n    /**\n     * A class name to be added to the prompt line.\n     */\n    className?: string;\n  };\n\n  /**\n   * Extra options for the Shiki hast transformer.\n   */\n  shikiHastOptions?: ShikiHastOptions;\n}\n\n/**\n * A plugin that highlights code blocks using Shiki.\n */\nexport const syntaxHighlightPlugin: Plugin<\n  [SyntaxHighlightPluginOptions?],\n  HastNode,\n  HastNode\n> = (options: SyntaxHighlightPluginOptions = {}) => {\n  return async (tree) => {\n    const promises: Promise<void>[] = [];\n\n    async function visitor(\n      node: HastElement,\n      index: number,\n      parent: HastElement,\n    ): Promise<void> {\n      if (!parent || index === null || node.tagName !== \"pre\") {\n        return;\n      }\n\n      const codeNode = node.children[0];\n      if (\n        !codeNode ||\n        codeNode.type !== \"element\" ||\n        codeNode.tagName !== \"code\" ||\n        !codeNode.properties\n      ) {\n        return;\n      }\n\n      const lang = getNodeLanguage(codeNode);\n      if (typeof lang !== \"string\") {\n        return;\n      }\n\n      const meta = extractCodeMeta(codeNode);\n\n      const sourceCode = hastToString(codeNode).trim();\n\n      const hastOptions: CodeToHastOptions<BundledLanguage, BundledTheme> = {\n        tokenizeTimeLimit: 10_000,\n        lang,\n        themes: {\n          light: \"github-light-default\",\n          dark: \"github-dark-default\",\n        },\n        ...(options.shikiHastOptions ?? {}),\n      };\n      if (hastOptions.transformers === undefined) {\n        hastOptions.transformers = [];\n      }\n\n      if (options.highlight) {\n        hastOptions.transformers.push(\n          transformerNotationHighlight({\n            ...(options.highlight.transformer ?? {}),\n            matchAlgorithm: \"v3\",\n          }),\n        );\n      }\n\n      let lineCount = 0;\n      hastOptions.transformers.push({\n        code(node): void {\n          let lineIndex = 0;\n          for (const line of node.children.filter(\n            (node: HastNode) => node.type === \"element\",\n          ) as HastElement[]) {\n            line.properties[\"data-line\"] = lineIndex + 1;\n\n            if (options.highlight) {\n              if (\n                meta.highlight &&\n                numericRangeContains(meta.highlight.lineRange, lineIndex)\n              ) {\n                this.addClassToHast(\n                  line,\n                  options.highlight.transformer?.classActiveLine ??\n                    \"highlighted\",\n                );\n              }\n            }\n\n            if (\n              options.lineNumbers &&\n              meta.showLineNumbers &&\n              (meta.showLineNumbers.lineRange.length === 0 ||\n                numericRangeContains(meta.showLineNumbers.lineRange, lineIndex))\n            ) {\n              this.addClassToHast(\n                line,\n                options.lineNumbers.className ?? \"line-number\",\n              );\n            }\n\n            if (\n              options.commandLine &&\n              meta.commandLine &&\n              (meta.commandLine.commandRange.length === 0 ||\n                numericRangeContains(meta.commandLine.commandRange, lineIndex))\n            ) {\n              this.addClassToHast(\n                line,\n                options.commandLine.className ?? \"line-command\",\n              );\n            }\n\n            lineIndex++;\n          }\n\n          lineCount = lineIndex;\n\n          if (meta.showLineNumbers) {\n            if (typeof node.properties.style !== \"string\") {\n              node.properties.style = \"\";\n            }\n            node.properties.style += `--${\n              options.lineNumbers?.widthVariableName ?? \"line-number-width\"\n            }:${1 + Math.floor(Math.log10(this.lines.length))}ch;`;\n          }\n        },\n      });\n\n      try {\n        const hast = await codeToHast(sourceCode, hastOptions);\n\n        // Insert highlighted code into parent\n        const hastPre = hast.children[0] as HastElement;\n\n        const properties: Properties = {\n          ...hastPre.properties,\n          dataFileName: meta.fileName,\n        };\n        if (options.includeDataAttributes) {\n          if (options.includeDataAttributes.includes(\"language\")) {\n            properties.dataLanguage = lang;\n          }\n          if (options.includeDataAttributes.includes(\"source-code\")) {\n            properties.dataSourceCode = sourceCode;\n          }\n          if (options.includeDataAttributes.includes(\"line-count\")) {\n            properties.dataLineCount = lineCount;\n          }\n        }\n\n        parent.children.splice(index, 1, {\n          ...hastPre,\n          properties,\n        });\n      } catch (error) {\n        if (error instanceof ShikiError) {\n          if (\n            error.message.includes(\n              \"Language `math` is not included in this bundle\",\n            )\n          ) {\n            // Skip if the block is math block.\n            return;\n          }\n        }\n        throw error;\n      }\n    }\n\n    visit(\n      tree,\n      \"element\",\n      (node: HastElement, index: number, parent: HastElement) => {\n        promises.push(visitor(node, index, parent));\n      },\n    );\n\n    await Promise.all(promises);\n\n    return tree;\n  };\n};\n\nfunction getNodeLanguage(node: HastElement): string | undefined {\n  if (!Array.isArray(node.properties.className)) {\n    return undefined;\n  }\n  const prefix = \"language-\";\n  const language = node.properties.className.find(\n    (name) => typeof name === \"string\" && name.startsWith(prefix),\n  ) as string | undefined;\n  if (typeof language === \"string\") {\n    return language.slice(prefix.length);\n  }\n  return language;\n}\n"],"mappings":";;;;;;;;;;;AA6EA,MAAa,yBAIR,UAAwC,EAAE,KAAK;AAClD,QAAO,OAAO,SAAS;EACrB,MAAM,WAA4B,EAAE;EAEpC,eAAe,QACb,MACA,OACA,QACe;AACf,OAAI,CAAC,UAAU,UAAU,QAAQ,KAAK,YAAY,MAChD;GAGF,MAAM,WAAW,KAAK,SAAS;AAC/B,OACE,CAAC,YACD,SAAS,SAAS,aAClB,SAAS,YAAY,UACrB,CAAC,SAAS,WAEV;GAGF,MAAM,OAAO,gBAAgB,SAAS;AACtC,OAAI,OAAO,SAAS,SAClB;GAGF,MAAM,OAAO,gBAAgB,SAAS;GAEtC,MAAM,aAAaA,SAAa,SAAS,CAAC,MAAM;GAEhD,MAAM,cAAgE;IACpE,mBAAmB;IACnB;IACA,QAAQ;KACN,OAAO;KACP,MAAM;KACP;IACD,GAAI,QAAQ,oBAAoB,EAAE;IACnC;AACD,OAAI,YAAY,iBAAiB,OAC/B,aAAY,eAAe,EAAE;AAG/B,OAAI,QAAQ,UACV,aAAY,aAAa,KACvB,6BAA6B;IAC3B,GAAI,QAAQ,UAAU,eAAe,EAAE;IACvC,gBAAgB;IACjB,CAAC,CACH;GAGH,IAAI,YAAY;AAChB,eAAY,aAAa,KAAK,EAC5B,KAAK,MAAY;IACf,IAAI,YAAY;AAChB,SAAK,MAAM,QAAQ,KAAK,SAAS,QAC9B,SAAmB,KAAK,SAAS,UACnC,EAAmB;AAClB,UAAK,WAAW,eAAe,YAAY;AAE3C,SAAI,QAAQ,WACV;UACE,KAAK,aACL,qBAAqB,KAAK,UAAU,WAAW,UAAU,CAEzD,MAAK,eACH,MACA,QAAQ,UAAU,aAAa,mBAC7B,cACH;;AAIL,SACE,QAAQ,eACR,KAAK,oBACJ,KAAK,gBAAgB,UAAU,WAAW,KACzC,qBAAqB,KAAK,gBAAgB,WAAW,UAAU,EAEjE,MAAK,eACH,MACA,QAAQ,YAAY,aAAa,cAClC;AAGH,SACE,QAAQ,eACR,KAAK,gBACJ,KAAK,YAAY,aAAa,WAAW,KACxC,qBAAqB,KAAK,YAAY,cAAc,UAAU,EAEhE,MAAK,eACH,MACA,QAAQ,YAAY,aAAa,eAClC;AAGH;;AAGF,gBAAY;AAEZ,QAAI,KAAK,iBAAiB;AACxB,SAAI,OAAO,KAAK,WAAW,UAAU,SACnC,MAAK,WAAW,QAAQ;AAE1B,UAAK,WAAW,SAAS,KACvB,QAAQ,aAAa,qBAAqB,oBAC3C,GAAG,IAAI,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,OAAO,CAAC,CAAC;;MAGvD,CAAC;AAEF,OAAI;IAIF,MAAM,WAHO,MAAM,WAAW,YAAY,YAAY,EAGjC,SAAS;IAE9B,MAAM,aAAyB;KAC7B,GAAG,QAAQ;KACX,cAAc,KAAK;KACpB;AACD,QAAI,QAAQ,uBAAuB;AACjC,SAAI,QAAQ,sBAAsB,SAAS,WAAW,CACpD,YAAW,eAAe;AAE5B,SAAI,QAAQ,sBAAsB,SAAS,cAAc,CACvD,YAAW,iBAAiB;AAE9B,SAAI,QAAQ,sBAAsB,SAAS,aAAa,CACtD,YAAW,gBAAgB;;AAI/B,WAAO,SAAS,OAAO,OAAO,GAAG;KAC/B,GAAG;KACH;KACD,CAAC;YACK,OAAO;AACd,QAAI,iBAAiB,YACnB;SACE,MAAM,QAAQ,SACZ,iDACD,CAGD;;AAGJ,UAAM;;;AAIV,QACE,MACA,YACC,MAAmB,OAAe,WAAwB;AACzD,YAAS,KAAK,QAAQ,MAAM,OAAO,OAAO,CAAC;IAE9C;AAED,QAAM,QAAQ,IAAI,SAAS;AAE3B,SAAO;;;AAIX,SAAS,gBAAgB,MAAuC;AAC9D,KAAI,CAAC,MAAM,QAAQ,KAAK,WAAW,UAAU,CAC3C;CAEF,MAAM,SAAS;CACf,MAAM,WAAW,KAAK,WAAW,UAAU,MACxC,SAAS,OAAO,SAAS,YAAY,KAAK,WAAW,OAAO,CAC9D;AACD,KAAI,OAAO,aAAa,SACtB,QAAO,SAAS,MAAM,EAAc;AAEtC,QAAO"}
+{"version":3,"file":"plugin.mjs","names":["hastToString"],"sources":["../../../src/plugins/syntax-highlight/plugin.ts"],"sourcesContent":["import {\n  type TransformerNotationHighlightOptions,\n  transformerNotationHighlight,\n} from \"@shikijs/transformers\";\nimport { numericRangeContains } from \"@temelj/iterator\";\nimport type { Properties } from \"hast\";\nimport { toString as hastToString } from \"hast-util-to-string\";\nimport {\n  type BundledLanguage,\n  type BundledTheme,\n  type CodeToHastOptions,\n  codeToHast,\n  ShikiError,\n} from \"shiki\";\nimport type { Plugin } from \"unified\";\nimport { visit } from \"unist-util-visit\";\n\nimport type { HastElement, HastNode } from \"../../types\";\nimport { extractCodeMeta } from \"./code-meta\";\n\ntype ShikiHastOptions = Partial<\n  CodeToHastOptions<BundledLanguage, BundledTheme>\n>;\n\ntype SyntaxDataAttribute = \"source-code\" | \"language\" | \"line-count\";\n\n/**\n * Options for {@linkcode syntaxHighlightPlugin}.\n */\nexport interface SyntaxHighlightPluginOptions {\n  /**\n   * Include these data attributes on the `<pre>` element.\n   * These might be useful to have when building custom code components.\n   */\n  includeDataAttributes?: SyntaxDataAttribute[];\n\n  /**\n   * Options for the highlight transformer.\n   */\n  highlight?: {\n    transformer?: TransformerNotationHighlightOptions;\n  };\n\n  /**\n   * Options for line numbers.\n   */\n  lineNumbers?: {\n    /**\n     * The name of the variable that contains the line number width.\n     * This is used for padding the line numbers so that they align.\n     */\n    widthVariableName?: string;\n    /**\n     * A class name to be added to the line numbers.\n     */\n    className?: string;\n  };\n\n  /**\n   * Options for command line.\n   */\n  commandLine?: {\n    /**\n     * A class name to be added to the prompt line.\n     */\n    className?: string;\n  };\n\n  /**\n   * Extra options for the Shiki hast transformer.\n   */\n  shikiHastOptions?: ShikiHastOptions;\n}\n\n/**\n * A plugin that highlights code blocks using Shiki.\n */\nexport const syntaxHighlightPlugin: Plugin<\n  [SyntaxHighlightPluginOptions?],\n  HastNode,\n  HastNode\n> = (options: SyntaxHighlightPluginOptions = {}) => {\n  return async (tree) => {\n    const promises: Promise<void>[] = [];\n\n    async function visitor(\n      node: HastElement,\n      index: number,\n      parent: HastElement,\n    ): Promise<void> {\n      if (!parent || index === null || node.tagName !== \"pre\") {\n        return;\n      }\n\n      const codeNode = node.children[0];\n      if (\n        !codeNode ||\n        codeNode.type !== \"element\" ||\n        codeNode.tagName !== \"code\" ||\n        !codeNode.properties\n      ) {\n        return;\n      }\n\n      const lang = getNodeLanguage(codeNode);\n      if (typeof lang !== \"string\") {\n        return;\n      }\n\n      const meta = extractCodeMeta(codeNode);\n\n      const sourceCode = hastToString(codeNode).trim();\n\n      const hastOptions: CodeToHastOptions<BundledLanguage, BundledTheme> = {\n        tokenizeTimeLimit: 10_000,\n        lang,\n        themes: {\n          light: \"github-light-default\",\n          dark: \"github-dark-default\",\n        },\n        ...(options.shikiHastOptions ?? {}),\n      };\n      if (hastOptions.transformers === undefined) {\n        hastOptions.transformers = [];\n      }\n\n      if (options.highlight) {\n        hastOptions.transformers.push(\n          transformerNotationHighlight({\n            ...(options.highlight.transformer ?? {}),\n            matchAlgorithm: \"v3\",\n          }),\n        );\n      }\n\n      let lineCount = 0;\n      hastOptions.transformers.push({\n        code(node): void {\n          let lineIndex = 0;\n          for (const line of node.children.filter(\n            (node: HastNode) => node.type === \"element\",\n          ) as HastElement[]) {\n            line.properties[\"data-line\"] = lineIndex + 1;\n\n            if (options.highlight) {\n              if (\n                meta.highlight &&\n                numericRangeContains(meta.highlight.lineRange, lineIndex)\n              ) {\n                this.addClassToHast(\n                  line,\n                  options.highlight.transformer?.classActiveLine ??\n                    \"highlighted\",\n                );\n              }\n            }\n\n            if (\n              options.lineNumbers &&\n              meta.showLineNumbers &&\n              (meta.showLineNumbers.lineRange.length === 0 ||\n                numericRangeContains(meta.showLineNumbers.lineRange, lineIndex))\n            ) {\n              this.addClassToHast(\n                line,\n                options.lineNumbers.className ?? \"line-number\",\n              );\n            }\n\n            if (\n              options.commandLine &&\n              meta.commandLine &&\n              (meta.commandLine.commandRange.length === 0 ||\n                numericRangeContains(meta.commandLine.commandRange, lineIndex))\n            ) {\n              this.addClassToHast(\n                line,\n                options.commandLine.className ?? \"line-command\",\n              );\n            }\n\n            lineIndex++;\n          }\n\n          lineCount = lineIndex;\n\n          if (meta.showLineNumbers) {\n            if (typeof node.properties.style !== \"string\") {\n              node.properties.style = \"\";\n            }\n            node.properties.style += `--${\n              options.lineNumbers?.widthVariableName ?? \"line-number-width\"\n            }:${1 + Math.floor(Math.log10(this.lines.length))}ch;`;\n          }\n        },\n      });\n\n      try {\n        const hast = await codeToHast(sourceCode, hastOptions);\n\n        // Insert highlighted code into parent\n        const hastPre = hast.children[0] as HastElement;\n\n        const properties: Properties = {\n          ...hastPre.properties,\n          dataFileName: meta.fileName,\n        };\n        if (options.includeDataAttributes) {\n          if (options.includeDataAttributes.includes(\"language\")) {\n            properties.dataLanguage = lang;\n          }\n          if (options.includeDataAttributes.includes(\"source-code\")) {\n            properties.dataSourceCode = sourceCode;\n          }\n          if (options.includeDataAttributes.includes(\"line-count\")) {\n            properties.dataLineCount = lineCount;\n          }\n        }\n\n        parent.children.splice(index, 1, {\n          ...hastPre,\n          properties,\n        });\n      } catch (error) {\n        if (error instanceof ShikiError) {\n          if (\n            error.message.includes(\n              \"Language `math` is not included in this bundle\",\n            )\n          ) {\n            // Skip if the block is math block.\n            return;\n          }\n        }\n        throw error;\n      }\n    }\n\n    visit(\n      tree,\n      \"element\",\n      (node: HastElement, index: number, parent: HastElement) => {\n        promises.push(visitor(node, index, parent));\n      },\n    );\n\n    await Promise.all(promises);\n\n    return tree;\n  };\n};\n\nfunction getNodeLanguage(node: HastElement): string | undefined {\n  if (!Array.isArray(node.properties.className)) {\n    return undefined;\n  }\n  const prefix = \"language-\";\n  const language = node.properties.className.find(\n    (name) => typeof name === \"string\" && name.startsWith(prefix),\n  ) as string | undefined;\n  if (typeof language === \"string\") {\n    return language.slice(prefix.length);\n  }\n  return language;\n}\n"],"mappings":"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"}

package/dist/plugins/tree-processor/plugin.mjs

@@ -1,5 +1,4 @@
 import { visit } from "unist-util-visit";
-
 //#region src/plugins/tree-processor/plugin.ts
 /**
 * A plugin that allows to process MDX tree nodes.
@@ -16,7 +15,7 @@ const treeProcessorPlugin = ({ process } = { process: () => {} }) => {
 		return tree;
 	};
 };
-
 //#endregion
 export { treeProcessorPlugin };
+
 //# sourceMappingURL=plugin.mjs.map

package/dist/plugins/tree-processor/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../../src/plugins/tree-processor/plugin.ts"],"sourcesContent":["import type { Plugin } from \"unified\";\nimport { visit } from \"unist-util-visit\";\n\nimport type { HastElement, HastNode } from \"../../types\";\n\nexport type MdxTreeProcessor = (\n  node: HastElement,\n  index: number,\n  parent: HastElement,\n) => void | Promise<void>;\n\n/**\n * Options for {@linkcode treeProcessorPlugin}.\n */\ntype TreeProcessorPluginOptions = {\n  /** The processor. */\n  process: MdxTreeProcessor;\n};\n\n/**\n * A plugin that allows to process MDX tree nodes.\n * It can be async or sync.\n */\nexport const treeProcessorPlugin: Plugin<\n  [TreeProcessorPluginOptions?],\n  HastNode,\n  HastNode\n> = ({ process } = { process: () => {} }) => {\n  return async (tree) => {\n    const promises: Promise<void>[] = [];\n\n    visit(\n      tree,\n      \"element\",\n      function visitor(\n        node: HastElement,\n        index: number,\n        parent: HastElement,\n      ): void {\n        const p = process(node, index, parent);\n        if (\n          p instanceof Promise ||\n          Object.prototype.toString.call(p) === \"[object Promise]\"\n        ) {\n          promises.push(p as Promise<void>);\n        }\n      },\n    );\n\n    await Promise.allSettled(promises);\n\n    return tree;\n  };\n};\n"],"mappings":";;;;;;;AAuBA,MAAa,uBAIR,EAAE,YAAY,EAAE,eAAe,IAAI,KAAK;AAC3C,QAAO,OAAO,SAAS;EACrB,MAAM,WAA4B,EAAE;AAEpC,QACE,MACA,WACA,SAAS,QACP,MACA,OACA,QACM;GACN,MAAM,IAAI,QAAQ,MAAM,OAAO,OAAO;AACtC,OACE,aAAa,WACb,OAAO,UAAU,SAAS,KAAK,EAAE,KAAK,mBAEtC,UAAS,KAAK,EAAmB;IAGtC;AAED,QAAM,QAAQ,WAAW,SAAS;AAElC,SAAO"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../../src/plugins/tree-processor/plugin.ts"],"sourcesContent":["import type { Plugin } from \"unified\";\nimport { visit } from \"unist-util-visit\";\n\nimport type { HastElement, HastNode } from \"../../types\";\n\nexport type MdxTreeProcessor = (\n  node: HastElement,\n  index: number,\n  parent: HastElement,\n) => void | Promise<void>;\n\n/**\n * Options for {@linkcode treeProcessorPlugin}.\n */\ntype TreeProcessorPluginOptions = {\n  /** The processor. */\n  process: MdxTreeProcessor;\n};\n\n/**\n * A plugin that allows to process MDX tree nodes.\n * It can be async or sync.\n */\nexport const treeProcessorPlugin: Plugin<\n  [TreeProcessorPluginOptions?],\n  HastNode,\n  HastNode\n> = ({ process } = { process: () => {} }) => {\n  return async (tree) => {\n    const promises: Promise<void>[] = [];\n\n    visit(\n      tree,\n      \"element\",\n      function visitor(\n        node: HastElement,\n        index: number,\n        parent: HastElement,\n      ): void {\n        const p = process(node, index, parent);\n        if (\n          p instanceof Promise ||\n          Object.prototype.toString.call(p) === \"[object Promise]\"\n        ) {\n          promises.push(p as Promise<void>);\n        }\n      },\n    );\n\n    await Promise.allSettled(promises);\n\n    return tree;\n  };\n};\n"],"mappings":";;;;;;AAuBA,MAAa,uBAIR,EAAE,YAAY,EAAE,eAAe,IAAI,KAAK;AAC3C,QAAO,OAAO,SAAS;EACrB,MAAM,WAA4B,EAAE;AAEpC,QACE,MACA,WACA,SAAS,QACP,MACA,OACA,QACM;GACN,MAAM,IAAI,QAAQ,MAAM,OAAO,OAAO;AACtC,OACE,aAAa,WACb,OAAO,UAAU,SAAS,KAAK,EAAE,KAAK,mBAEtC,UAAS,KAAK,EAAmB;IAGtC;AAED,QAAM,QAAQ,WAAW,SAAS;AAElC,SAAO"}

package/dist/types.mjs

@@ -1 +1 @@
-export {  };
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temelj/mdx",
-  "version": "0.10.2",
+  "version": "0.11.1",
   "description": "MDX processing utilities.",
   "license": "MIT",
   "repository": {
@@ -20,30 +20,32 @@
   },
   "dependencies": {
     "@mdx-js/mdx": "^3.1.1",
-    "@shikijs/transformers": "^3.22.0",
+    "@shikijs/transformers": "^4.0.2",
     "@types/hast": "^3.0.4",
     "github-slugger": "^2.0.0",
     "hast": "^1.0.0",
     "hast-util-to-string": "^3.0.1",
     "remark-frontmatter": "^5.0.0",
     "remark-gfm": "^4.0.1",
+    "remark-math": "^6.0.0",
     "remark-parse": "^11.0.0",
-    "shiki": "^3.22.0",
+    "rehype-katex": "^7.0.1",
+    "shiki": "^4.0.2",
     "unified": "^11.0.5",
     "unist-util-remove": "^4.0.0",
     "unist-util-visit": "^5.1.0",
     "vfile": "^6.0.3",
     "vfile-matter": "^5.0.1",
     "zod": "^4.3.6",
-    "@temelj/iterator": "0.10.2"
+    "@temelj/iterator": "0.11.0"
   },
   "devDependencies": {
     "@types/mdast": "^4.0.4",
-    "@types/node": "25.2.1",
+    "@types/node": "25.5.0",
     "shx": "^0.4.0",
-    "tsdown": "^0.20.3",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "tsdown": "^0.21.7",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
   },
   "scripts": {
     "build": "tsdown",