@temelj/mdx 0.13.0 → 0.15.0

package/dist/plugins/code-block-metadata.d.mts

@@ -0,0 +1,42 @@
+import { MdxError } from "../errors.mjs";
+//#region src/plugins/code-block-metadata.d.ts
+export interface CodeLineRange {
+  readonly end: number;
+  readonly start: number;
+}
+export type CodeLineSelection = {
+  readonly kind: "all";
+} | {
+  readonly kind: "ranges";
+  readonly ranges: readonly CodeLineRange[];
+};
+export interface CodeLineNumbers {
+  readonly lines: CodeLineSelection;
+  readonly start: number;
+}
+export interface CodeBlockMetadata {
+  readonly commandLines?: CodeLineSelection;
+  readonly fileName?: string;
+  readonly highlightedLines?: CodeLineSelection;
+  readonly lineNumbers?: CodeLineNumbers;
+  readonly raw?: string;
+}
+export interface CodeBlockMetadataIssue {
+  readonly field?: "commandLines" | "fileName" | "highlightLines" | "lineNumbers";
+  readonly message: string;
+}
+export declare class CodeBlockMetadataError extends MdxError {
+  readonly issues: readonly CodeBlockMetadataIssue[];
+  readonly metadata: CodeBlockMetadata;
+  private constructor();
+  static invalidJson(this: void, raw: string, cause: unknown): CodeBlockMetadataError;
+  static invalidFields(this: void, issues: readonly CodeBlockMetadataIssue[], metadata: CodeBlockMetadata): CodeBlockMetadataError;
+}
+/**
+ * Parses JSON metadata for fenced code blocks without changing the authored value.
+ * @throws {CodeBlockMetadataError} Invalid metadata, with issues and partial metadata.
+ */
+export declare function parseCodeBlockMetadata(raw?: string): CodeBlockMetadata;
+export declare function codeLineSelected(selection: CodeLineSelection, line: number): boolean;
+//#endregion
+//# sourceMappingURL=code-block-metadata.d.mts.map

package/dist/plugins/code-block-metadata.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block-metadata.d.mts","names":[],"sources":["../../src/plugins/code-block-metadata.ts"],"mappings":";;iBAIiB;WACN;WACA;;YAGC;WACG;;WACA;WAAyB,iBAAiB;;iBAExC;WACN,OAAO;WACP;;iBAGM;WACN,eAAe;WACf;WACA,mBAAmB;WACnB,cAAc;WACd;;iBAKM;WACN;WACA;;qBAGE,+BAA+B;WAC1B,iBAAiB;WACjB,UAAU;UAEnB;SAgBO,YAAY,YAAY,aAAa,iBAAiB;SAStD,cACZ,YACA,iBAAiB,0BACjB,UAAU,oBACT;;;;;;wBAaW,uBAAuB,eAAe;wBAsEtC,iBAAiB,WAAW,mBAAmB"}

package/dist/plugins/code-block-metadata.mjs

@@ -0,0 +1,133 @@
+import { MdxError } from "../errors.mjs";
+import { isNumber, isPlainObject, isString } from "@temelj/value";
+//#region src/plugins/code-block-metadata.ts
+var CodeBlockMetadataError = class CodeBlockMetadataError extends MdxError {
+	issues;
+	metadata;
+	constructor(issues, metadata, options, context) {
+		super("CodeBlockMetadataError", `Invalid code block metadata: ${issues.map((issue) => issue.message).join("; ")}`, options, context);
+		this.issues = Object.freeze([...issues]);
+		this.metadata = Object.freeze(metadata);
+	}
+	static invalidJson(raw, cause) {
+		return new CodeBlockMetadataError([{ message: "Code block metadata must be a valid JSON object" }], { raw }, { cause }, CodeBlockMetadataError.invalidJson);
+	}
+	static invalidFields(issues, metadata) {
+		return new CodeBlockMetadataError(issues, metadata, {}, CodeBlockMetadataError.invalidFields);
+	}
+};
+const allLines = { kind: "all" };
+const selectorPattern = /^\s*\d+(?:\s*-\s*\d+)?(?:\s*,\s*\d+(?:\s*-\s*\d+)?)*\s*$/u;
+/**
+* Parses JSON metadata for fenced code blocks without changing the authored value.
+* @throws {CodeBlockMetadataError} Invalid metadata, with issues and partial metadata.
+*/
+function parseCodeBlockMetadata(raw) {
+	if (raw === void 0 || raw.trim().length === 0) return { raw };
+	let input;
+	try {
+		input = JSON.parse(raw);
+	} catch (cause) {
+		throw CodeBlockMetadataError.invalidJson(raw, cause);
+	}
+	if (!isPlainObject(input)) throw CodeBlockMetadataError.invalidFields([{ message: "Code block metadata must be a JSON object" }], { raw });
+	const issues = [];
+	const metadata = { raw };
+	const fileName = "fileName" in input ? input.fileName : void 0;
+	if (fileName !== void 0) {
+		if (!isString(fileName) || fileName.trim().length === 0) issues.push({
+			field: "fileName",
+			message: "\"fileName\" must be a non-empty string"
+		});
+		else metadata.fileName = fileName.trim();
+	}
+	const highlighted = parseSelectionField("highlightLines" in input ? input.highlightLines : void 0, "highlightLines", issues);
+	if (highlighted !== void 0) metadata.highlightedLines = highlighted;
+	const commands = parseSelectionField("commandLines" in input ? input.commandLines : void 0, "commandLines", issues);
+	if (commands !== void 0) metadata.commandLines = commands;
+	const lineNumbers = parseLineNumbers("lineNumbers" in input ? input.lineNumbers : void 0, issues);
+	if (lineNumbers !== void 0) metadata.lineNumbers = lineNumbers;
+	if (issues.length > 0) throw CodeBlockMetadataError.invalidFields(issues, metadata);
+	return metadata;
+}
+function codeLineSelected(selection, line) {
+	return selection.kind === "all" || selection.ranges.some((range) => range.start <= line && line <= range.end);
+}
+function parseLineNumbers(value, issues) {
+	if (value === void 0 || value === false) return;
+	if (value === true) return {
+		lines: allLines,
+		start: 1
+	};
+	if (!isPlainObject(value)) {
+		issues.push({
+			field: "lineNumbers",
+			message: "\"lineNumbers\" must be a boolean or an object"
+		});
+		return;
+	}
+	const start = "start" in value ? value.start ?? 1 : 1;
+	const validStart = isNumber(start) && Number.isSafeInteger(start) && start >= 1;
+	if (!validStart) issues.push({
+		field: "lineNumbers",
+		message: "\"lineNumbers.start\" must be a positive safe integer"
+	});
+	const lines = parseSelectionField(("lines" in value ? value.lines : void 0) ?? true, "lineNumbers", issues);
+	if (!validStart || lines === void 0) return;
+	return {
+		lines,
+		start
+	};
+}
+function parseSelectionField(value, field, issues) {
+	if (value === void 0 || value === false) return;
+	if (value === true) return allLines;
+	if (!isString(value)) {
+		issues.push({
+			field,
+			message: `"${field}" must be a boolean or line selector string`
+		});
+		return;
+	}
+	if (!selectorPattern.test(value)) {
+		issues.push({
+			field,
+			message: `"${field}" contains an invalid line selector`
+		});
+		return;
+	}
+	const ranges = value.split(",").map((part) => {
+		const [startValue = "", endValue = startValue] = part.split("-");
+		return {
+			start: Number(startValue.trim()),
+			end: Number(endValue.trim())
+		};
+	});
+	ranges.sort((left, right) => left.start - right.start || left.end - right.end);
+	let previous;
+	for (const range of ranges) {
+		if (!Number.isSafeInteger(range.start) || !Number.isSafeInteger(range.end) || range.start < 1 || range.end < range.start) {
+			issues.push({
+				field,
+				message: `"${field}" contains an invalid line range`
+			});
+			return;
+		}
+		if (previous !== void 0 && range.start <= previous.end) {
+			issues.push({
+				field,
+				message: `"${field}" contains overlapping line ranges`
+			});
+			return;
+		}
+		previous = range;
+	}
+	return {
+		kind: "ranges",
+		ranges
+	};
+}
+//#endregion
+export { CodeBlockMetadataError, codeLineSelected, parseCodeBlockMetadata };
+
+//# sourceMappingURL=code-block-metadata.mjs.map

package/dist/plugins/code-block-metadata.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block-metadata.mjs","names":[],"sources":["../../src/plugins/code-block-metadata.ts"],"sourcesContent":["import { isString, isNumber, isPlainObject } from \"@temelj/value\";\n\nimport { MdxError } from \"../errors.ts\";\n\nexport interface CodeLineRange {\n  readonly end: number;\n  readonly start: number;\n}\n\nexport type CodeLineSelection =\n  | { readonly kind: \"all\" }\n  | { readonly kind: \"ranges\"; readonly ranges: readonly CodeLineRange[] };\n\nexport interface CodeLineNumbers {\n  readonly lines: CodeLineSelection;\n  readonly start: number;\n}\n\nexport interface CodeBlockMetadata {\n  readonly commandLines?: CodeLineSelection;\n  readonly fileName?: string;\n  readonly highlightedLines?: CodeLineSelection;\n  readonly lineNumbers?: CodeLineNumbers;\n  readonly raw?: string;\n}\n\ntype MutableCodeBlockMetadata = { -readonly [K in keyof CodeBlockMetadata]: CodeBlockMetadata[K] };\n\nexport interface CodeBlockMetadataIssue {\n  readonly field?: \"commandLines\" | \"fileName\" | \"highlightLines\" | \"lineNumbers\";\n  readonly message: string;\n}\n\nexport class CodeBlockMetadataError extends MdxError {\n  public readonly issues: readonly CodeBlockMetadataIssue[];\n  public readonly metadata: CodeBlockMetadata;\n\n  private constructor(\n    issues: readonly CodeBlockMetadataIssue[],\n    metadata: CodeBlockMetadata,\n    options: ErrorOptions,\n    context: Function,\n  ) {\n    super(\n      \"CodeBlockMetadataError\",\n      `Invalid code block metadata: ${issues.map((issue) => issue.message).join(\"; \")}`,\n      options,\n      context,\n    );\n    this.issues = Object.freeze([...issues]);\n    this.metadata = Object.freeze(metadata);\n  }\n\n  public static invalidJson(this: void, raw: string, cause: unknown): CodeBlockMetadataError {\n    return new CodeBlockMetadataError(\n      [{ message: \"Code block metadata must be a valid JSON object\" }],\n      { raw },\n      { cause },\n      CodeBlockMetadataError.invalidJson,\n    );\n  }\n\n  public static invalidFields(\n    this: void,\n    issues: readonly CodeBlockMetadataIssue[],\n    metadata: CodeBlockMetadata,\n  ): CodeBlockMetadataError {\n    return new CodeBlockMetadataError(issues, metadata, {}, CodeBlockMetadataError.invalidFields);\n  }\n}\n\nconst allLines: CodeLineSelection = { kind: \"all\" };\n\nconst selectorPattern = /^\\s*\\d+(?:\\s*-\\s*\\d+)?(?:\\s*,\\s*\\d+(?:\\s*-\\s*\\d+)?)*\\s*$/u;\n\n/**\n * Parses JSON metadata for fenced code blocks without changing the authored value.\n * @throws {CodeBlockMetadataError} Invalid metadata, with issues and partial metadata.\n */\nexport function parseCodeBlockMetadata(raw?: string): CodeBlockMetadata {\n  if (raw === undefined || raw.trim().length === 0) {\n    return { raw };\n  }\n\n  let input: unknown;\n\n  try {\n    input = JSON.parse(raw);\n  } catch (cause) {\n    throw CodeBlockMetadataError.invalidJson(raw, cause);\n  }\n\n  if (!isPlainObject(input)) {\n    throw CodeBlockMetadataError.invalidFields(\n      [{ message: \"Code block metadata must be a JSON object\" }],\n      { raw },\n    );\n  }\n\n  const issues: CodeBlockMetadataIssue[] = [];\n\n  const metadata: MutableCodeBlockMetadata = { raw };\n\n  const fileName = \"fileName\" in input ? input.fileName : undefined;\n\n  if (fileName !== undefined) {\n    if (!isString(fileName) || fileName.trim().length === 0) {\n      issues.push({ field: \"fileName\", message: '\"fileName\" must be a non-empty string' });\n    } else {\n      metadata.fileName = fileName.trim();\n    }\n  }\n\n  const highlighted = parseSelectionField(\n    \"highlightLines\" in input ? input.highlightLines : undefined,\n    \"highlightLines\",\n    issues,\n  );\n\n  if (highlighted !== undefined) {\n    metadata.highlightedLines = highlighted;\n  }\n\n  const commands = parseSelectionField(\n    \"commandLines\" in input ? input.commandLines : undefined,\n    \"commandLines\",\n    issues,\n  );\n\n  if (commands !== undefined) {\n    metadata.commandLines = commands;\n  }\n\n  const lineNumbers = parseLineNumbers(\n    \"lineNumbers\" in input ? input.lineNumbers : undefined,\n    issues,\n  );\n\n  if (lineNumbers !== undefined) {\n    metadata.lineNumbers = lineNumbers;\n  }\n\n  if (issues.length > 0) {\n    throw CodeBlockMetadataError.invalidFields(issues, metadata);\n  }\n\n  return metadata;\n}\n\nexport function codeLineSelected(selection: CodeLineSelection, line: number): boolean {\n  return (\n    selection.kind === \"all\" ||\n    selection.ranges.some((range) => range.start <= line && line <= range.end)\n  );\n}\n\nfunction parseLineNumbers(\n  // oxlint-disable-next-line anti-slop/no-unknown-parameters -- Validates a field from parsed code-block JSON before exposing typed metadata.\n  value: unknown,\n  issues: CodeBlockMetadataIssue[],\n): CodeLineNumbers | undefined {\n  if (value === undefined || value === false) {\n    return;\n  }\n\n  if (value === true) {\n    return { lines: allLines, start: 1 };\n  }\n\n  if (!isPlainObject(value)) {\n    issues.push({\n      field: \"lineNumbers\",\n      message: '\"lineNumbers\" must be a boolean or an object',\n    });\n\n    return;\n  }\n\n  const start = \"start\" in value ? (value.start ?? 1) : 1;\n  const validStart = isNumber(start) && Number.isSafeInteger(start) && start >= 1;\n\n  if (!validStart) {\n    issues.push({\n      field: \"lineNumbers\",\n      message: '\"lineNumbers.start\" must be a positive safe integer',\n    });\n  }\n\n  const lines = parseSelectionField(\n    (\"lines\" in value ? value.lines : undefined) ?? true,\n    \"lineNumbers\",\n    issues,\n  );\n\n  if (!validStart || lines === undefined) {\n    return;\n  }\n\n  return { lines, start };\n}\n\nfunction parseSelectionField(\n  // oxlint-disable-next-line anti-slop/no-unknown-parameters -- Validates a field from parsed code-block JSON before exposing typed metadata.\n  value: unknown,\n  field: \"commandLines\" | \"highlightLines\" | \"lineNumbers\",\n  issues: CodeBlockMetadataIssue[],\n): CodeLineSelection | undefined {\n  if (value === undefined || value === false) {\n    return;\n  }\n\n  if (value === true) {\n    return allLines;\n  }\n\n  if (!isString(value)) {\n    issues.push({ field, message: `\"${field}\" must be a boolean or line selector string` });\n\n    return;\n  }\n\n  if (!selectorPattern.test(value)) {\n    issues.push({ field, message: `\"${field}\" contains an invalid line selector` });\n\n    return;\n  }\n\n  const ranges = value.split(\",\").map((part) => {\n    const [startValue = \"\", endValue = startValue] = part.split(\"-\");\n\n    return { start: Number(startValue.trim()), end: Number(endValue.trim()) };\n  });\n\n  ranges.sort((left, right) => left.start - right.start || left.end - right.end);\n  let previous: CodeLineRange | undefined;\n\n  for (const range of ranges) {\n    if (\n      !Number.isSafeInteger(range.start) ||\n      !Number.isSafeInteger(range.end) ||\n      range.start < 1 ||\n      range.end < range.start\n    ) {\n      issues.push({ field, message: `\"${field}\" contains an invalid line range` });\n\n      return;\n    }\n\n    if (previous !== undefined && range.start <= previous.end) {\n      issues.push({ field, message: `\"${field}\" contains overlapping line ranges` });\n\n      return;\n    }\n\n    previous = range;\n  }\n\n  return { kind: \"ranges\", ranges };\n}\n"],"mappings":"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"}

package/dist/plugins/heading-id.d.mts

@@ -0,0 +1,15 @@
+import { HtmlRootNode } from "../html.mjs";
+import { HtmlPlugin, HtmlPluginContext } from "../plugin.mjs";
+//#region src/plugins/heading-id.d.ts
+export interface HeadingIdPluginOptions {
+  readonly prefix?: string;
+}
+/** Adds unique slug IDs to rendered headings that have none. */
+export declare class HeadingIdPlugin implements HtmlPlugin {
+  readonly name = "heading-id";
+  private readonly prefix;
+  constructor(options?: HeadingIdPluginOptions);
+  transform(context: HtmlPluginContext): HtmlRootNode;
+}
+//#endregion
+//# sourceMappingURL=heading-id.d.mts.map

package/dist/plugins/heading-id.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-id.d.mts","names":[],"sources":["../../src/plugins/heading-id.ts"],"mappings":";;;iBAQiB;WACN;;;qBAIE,2BAA2B;WACtB;mBACC;EAEjB,YAAmB,UAAS;EAIrB,UAAU,SAAS,oBAAoB"}

package/dist/plugins/heading-id.mjs

@@ -0,0 +1,45 @@
+import { htmlText } from "../html.mjs";
+import { selectHtml } from "../traversal.mjs";
+import { isString } from "@temelj/value";
+//#region src/plugins/heading-id.ts
+/** Adds unique slug IDs to rendered headings that have none. */
+var HeadingIdPlugin = class {
+	name = "heading-id";
+	prefix;
+	constructor(options = {}) {
+		this.prefix = options.prefix ?? "user-content-";
+	}
+	transform(context) {
+		const used = /* @__PURE__ */ new Set();
+		for (const { node } of selectHtml(context.root, "element")) {
+			const id = node.attributes.id;
+			if (isString(id)) used.add(id);
+		}
+		return context.rewrite({ element: ({ node }) => {
+			if (!/^h[1-6]$/u.test(node.tagName) || node.attributes.id !== void 0) return;
+			const id = uniqueSlug(this.prefix + slug(htmlText(node)), used);
+			return {
+				...node,
+				attributes: {
+					...node.attributes,
+					id
+				}
+			};
+		} });
+	}
+};
+function slug(value) {
+	const result = value.trim().toLowerCase().replace(/[^\p{Letter}\p{Number}\s_-]/gu, "").replace(/[\s_-]+/gu, "-").replace(/^-|-$/gu, "");
+	return result.length === 0 ? "section" : result;
+}
+function uniqueSlug(base, used) {
+	let value = base;
+	let index = 0;
+	while (used.has(value)) value = `${base}-${++index}`;
+	used.add(value);
+	return value;
+}
+//#endregion
+export { HeadingIdPlugin };
+
+//# sourceMappingURL=heading-id.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"heading-id.mjs","names":[],"sources":["../../src/plugins/heading-id.ts"],"sourcesContent":["import { isString } from \"@temelj/value\";\n\nimport type { HtmlRootNode } from \"../html.ts\";\nimport type { HtmlPlugin, HtmlPluginContext } from \"../plugin.ts\";\n\nimport { htmlText } from \"../html.ts\";\nimport { selectHtml } from \"../traversal.ts\";\n\nexport interface HeadingIdPluginOptions {\n  readonly prefix?: string;\n}\n\n/** Adds unique slug IDs to rendered headings that have none. */\nexport class HeadingIdPlugin implements HtmlPlugin {\n  public readonly name = \"heading-id\";\n  private readonly prefix: string;\n\n  public constructor(options: HeadingIdPluginOptions = {}) {\n    this.prefix = options.prefix ?? \"user-content-\";\n  }\n\n  public transform(context: HtmlPluginContext): HtmlRootNode {\n    const used = new Set<string>();\n\n    for (const { node } of selectHtml(context.root, \"element\")) {\n      const id = node.attributes.id;\n\n      if (isString(id)) {\n        used.add(id);\n      }\n    }\n\n    return context.rewrite({\n      element: ({ node }) => {\n        if (!/^h[1-6]$/u.test(node.tagName) || node.attributes.id !== undefined) {\n          return;\n        }\n\n        const id = uniqueSlug(this.prefix + slug(htmlText(node)), used);\n\n        return { ...node, attributes: { ...node.attributes, id } };\n      },\n    });\n  }\n}\n\nfunction slug(value: string): string {\n  const result = value\n    .trim()\n    .toLowerCase()\n    .replace(/[^\\p{Letter}\\p{Number}\\s_-]/gu, \"\")\n    .replace(/[\\s_-]+/gu, \"-\")\n    .replace(/^-|-$/gu, \"\");\n\n  return result.length === 0 ? \"section\" : result;\n}\n\nfunction uniqueSlug(base: string, used: Set<string>): string {\n  let value = base;\n  let index = 0;\n\n  while (used.has(value)) {\n    value = `${base}-${++index}`;\n  }\n\n  used.add(value);\n\n  return value;\n}\n"],"mappings":";;;;;AAaA,IAAa,kBAAb,MAAmD;CACjD,OAAuB;CACvB;CAEA,YAAmB,UAAkC,CAAC,GAAG;EACvD,KAAK,SAAS,QAAQ,UAAU;CAClC;CAEA,UAAiB,SAA0C;EACzD,MAAM,uBAAO,IAAI,IAAY;EAE7B,KAAK,MAAM,EAAE,UAAU,WAAW,QAAQ,MAAM,SAAS,GAAG;GAC1D,MAAM,KAAK,KAAK,WAAW;GAE3B,IAAI,SAAS,EAAE,GACb,KAAK,IAAI,EAAE;EAEf;EAEA,OAAO,QAAQ,QAAQ,EACrB,UAAU,EAAE,WAAW;GACrB,IAAI,CAAC,YAAY,KAAK,KAAK,OAAO,KAAK,KAAK,WAAW,OAAO,KAAA,GAC5D;GAGF,MAAM,KAAK,WAAW,KAAK,SAAS,KAAK,SAAS,IAAI,CAAC,GAAG,IAAI;GAE9D,OAAO;IAAE,GAAG;IAAM,YAAY;KAAE,GAAG,KAAK;KAAY;IAAG;GAAE;EAC3D,EACF,CAAC;CACH;AACF;AAEA,SAAS,KAAK,OAAuB;CACnC,MAAM,SAAS,MACZ,KAAK,CAAC,CACN,YAAY,CAAC,CACb,QAAQ,iCAAiC,EAAE,CAAC,CAC5C,QAAQ,aAAa,GAAG,CAAC,CACzB,QAAQ,WAAW,EAAE;CAExB,OAAO,OAAO,WAAW,IAAI,YAAY;AAC3C;AAEA,SAAS,WAAW,MAAc,MAA2B;CAC3D,IAAI,QAAQ;CACZ,IAAI,QAAQ;CAEZ,OAAO,KAAK,IAAI,KAAK,GACnB,QAAQ,GAAG,KAAK,GAAG,EAAE;CAGvB,KAAK,IAAI,KAAK;CAEd,OAAO;AACT"}

package/dist/plugins/lower-heading.d.mts

@@ -0,0 +1,16 @@
+import { HtmlRootNode } from "../html.mjs";
+import { HtmlPlugin, HtmlPluginContext } from "../plugin.mjs";
+//#region src/plugins/lower-heading.d.ts
+export interface LowerHeadingPluginOptions {
+  /** Number of levels by which to lower each rendered heading. */
+  readonly offset?: number;
+}
+/** Lowers rendered HTML headings without changing the authored MDX heading depth. */
+export declare class LowerHeadingPlugin implements HtmlPlugin {
+  readonly name = "lower-heading";
+  private readonly offset;
+  constructor(options?: LowerHeadingPluginOptions);
+  transform(context: HtmlPluginContext): HtmlRootNode;
+}
+//#endregion
+//# sourceMappingURL=lower-heading.d.mts.map

package/dist/plugins/lower-heading.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lower-heading.d.mts","names":[],"sources":["../../src/plugins/lower-heading.ts"],"mappings":";;;iBAMiB;;WAEN;;;qBAIE,8BAA8B;WACzB;mBACC;EAEjB,YAAmB,UAAS;EAUrB,UAAU,SAAS,oBAAoB"}

package/dist/plugins/lower-heading.mjs

@@ -0,0 +1,28 @@
+import { ConfigurationError } from "../errors.mjs";
+import { headingDepthForTag } from "../heading.mjs";
+//#region src/plugins/lower-heading.ts
+/** Lowers rendered HTML headings without changing the authored MDX heading depth. */
+var LowerHeadingPlugin = class {
+	name = "lower-heading";
+	offset;
+	constructor(options = {}) {
+		const offset = options.offset ?? 1;
+		if (!Number.isSafeInteger(offset) || offset < 1) throw ConfigurationError.invalidPluginIntegerOption("lower-heading", "offset", offset, 1);
+		this.offset = offset;
+	}
+	transform(context) {
+		return context.rewrite({ element: ({ node }) => {
+			const depth = headingDepthForTag(node.tagName);
+			if (depth === void 0) return;
+			const lowered = Math.min(depth + this.offset, 6);
+			return lowered === depth ? void 0 : {
+				...node,
+				tagName: `h${lowered}`
+			};
+		} });
+	}
+};
+//#endregion
+export { LowerHeadingPlugin };
+
+//# sourceMappingURL=lower-heading.mjs.map

package/dist/plugins/lower-heading.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lower-heading.mjs","names":[],"sources":["../../src/plugins/lower-heading.ts"],"sourcesContent":["import type { HtmlRootNode } from \"../html.ts\";\nimport type { HtmlPlugin, HtmlPluginContext } from \"../plugin.ts\";\n\nimport { ConfigurationError } from \"../errors.ts\";\nimport { headingDepthForTag } from \"../heading.ts\";\n\nexport interface LowerHeadingPluginOptions {\n  /** Number of levels by which to lower each rendered heading. */\n  readonly offset?: number;\n}\n\n/** Lowers rendered HTML headings without changing the authored MDX heading depth. */\nexport class LowerHeadingPlugin implements HtmlPlugin {\n  public readonly name = \"lower-heading\";\n  private readonly offset: number;\n\n  public constructor(options: LowerHeadingPluginOptions = {}) {\n    const offset = options.offset ?? 1;\n\n    if (!Number.isSafeInteger(offset) || offset < 1) {\n      throw ConfigurationError.invalidPluginIntegerOption(\"lower-heading\", \"offset\", offset, 1);\n    }\n\n    this.offset = offset;\n  }\n\n  public transform(context: HtmlPluginContext): HtmlRootNode {\n    return context.rewrite({\n      element: ({ node }) => {\n        const depth = headingDepthForTag(node.tagName);\n\n        if (depth === undefined) {\n          return;\n        }\n\n        const lowered = Math.min(depth + this.offset, 6);\n\n        return lowered === depth ? undefined : { ...node, tagName: `h${lowered}` };\n      },\n    });\n  }\n}\n"],"mappings":";;;;AAYA,IAAa,qBAAb,MAAsD;CACpD,OAAuB;CACvB;CAEA,YAAmB,UAAqC,CAAC,GAAG;EAC1D,MAAM,SAAS,QAAQ,UAAU;EAEjC,IAAI,CAAC,OAAO,cAAc,MAAM,KAAK,SAAS,GAC5C,MAAM,mBAAmB,2BAA2B,iBAAiB,UAAU,QAAQ,CAAC;EAG1F,KAAK,SAAS;CAChB;CAEA,UAAiB,SAA0C;EACzD,OAAO,QAAQ,QAAQ,EACrB,UAAU,EAAE,WAAW;GACrB,MAAM,QAAQ,mBAAmB,KAAK,OAAO;GAE7C,IAAI,UAAU,KAAA,GACZ;GAGF,MAAM,UAAU,KAAK,IAAI,QAAQ,KAAK,QAAQ,CAAC;GAE/C,OAAO,YAAY,QAAQ,KAAA,IAAY;IAAE,GAAG;IAAM,SAAS,IAAI;GAAU;EAC3E,EACF,CAAC;CACH;AACF"}

package/dist/plugins/math-render.d.mts

@@ -0,0 +1,26 @@
+import { HtmlMathNode, HtmlNode, HtmlRootNode } from "../html.mjs";
+import { HtmlPlugin, HtmlPluginContext, PluginFailureMode } from "../plugin.mjs";
+//#region src/plugins/math-render.d.ts
+export interface MathRenderRequest {
+  readonly node: HtmlMathNode;
+  readonly signal?: AbortSignal;
+}
+export interface MathRenderer {
+  /** Returns the node that replaces the math fallback. */
+  render(request: MathRenderRequest): HtmlNode | Promise<HtmlNode>;
+}
+export interface MathRenderPluginOptions {
+  readonly mode?: PluginFailureMode;
+  readonly renderer: MathRenderer;
+}
+/** Renders math nodes through a caller-supplied renderer. */
+export declare class MathRenderPlugin implements HtmlPlugin {
+  readonly name = "math-render";
+  private readonly mode;
+  private readonly renderer;
+  constructor(options: MathRenderPluginOptions);
+  transform(context: HtmlPluginContext): HtmlRootNode | Promise<HtmlRootNode>;
+  private renderFailure;
+}
+//#endregion
+//# sourceMappingURL=math-render.d.mts.map

package/dist/plugins/math-render.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-render.d.mts","names":[],"sources":["../../src/plugins/math-render.ts"],"mappings":";;;iBAOiB;WACN,MAAM;WACN,SAAS;;iBAGH;;EAEf,OAAO,SAAS,oBAAoB,WAAW,QAAQ;;iBAGxC;WACN,OAAO;WACP,UAAU;;;qBAIR,4BAA4B;WACvB;mBACC;mBACA;EAEjB,YAAmB,SAAS;EAKrB,UAAU,SAAS,oBAAoB,eAAe,QAAQ;UAuB7D"}

package/dist/plugins/math-render.mjs

@@ -0,0 +1,51 @@
+import { replaceHtmlNodes } from "../plugin-internal.mjs";
+import { isPromise } from "@temelj/value";
+//#region src/plugins/math-render.ts
+/** Renders math nodes through a caller-supplied renderer. */
+var MathRenderPlugin = class {
+	name = "math-render";
+	mode;
+	renderer;
+	constructor(options) {
+		this.renderer = options.renderer;
+		this.mode = options.mode ?? "tolerant";
+	}
+	transform(context) {
+		return replaceHtmlNodes(context.root, (node) => {
+			if (node.kind !== "math") return;
+			const request = {
+				node,
+				signal: context.signal
+			};
+			try {
+				const result = this.renderer.render(request);
+				return isPromise(result) ? result.then((rendered) => ({
+					...rendered,
+					origin: node.origin
+				}), (cause) => this.renderFailure(cause, node, context)) : {
+					...result,
+					origin: node.origin
+				};
+			} catch (cause) {
+				return this.renderFailure(cause, node, context);
+			}
+		});
+	}
+	renderFailure(cause, node, context) {
+		if (this.mode === "strict") throw cause;
+		context.diagnostics.add({
+			severity: "warning",
+			code: "mdx.plugin.math-render",
+			message: `Could not render ${node.style} math: ${cause instanceof Error ? cause.message : String(cause)}`,
+			span: node.origin === void 0 ? void 0 : {
+				file: context.file,
+				start: node.origin.start,
+				end: node.origin.end
+			}
+		});
+	}
+};
+//#endregion
+export { MathRenderPlugin };
+
+//# sourceMappingURL=math-render.mjs.map

package/dist/plugins/math-render.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"math-render.mjs","names":[],"sources":["../../src/plugins/math-render.ts"],"sourcesContent":["import { isPromise } from \"@temelj/value\";\n\nimport type { HtmlMathNode, HtmlNode, HtmlRootNode } from \"../html.ts\";\nimport type { HtmlPlugin, HtmlPluginContext, PluginFailureMode } from \"../plugin.ts\";\n\nimport { replaceHtmlNodes } from \"../plugin-internal.ts\";\n\nexport interface MathRenderRequest {\n  readonly node: HtmlMathNode;\n  readonly signal?: AbortSignal;\n}\n\nexport interface MathRenderer {\n  /** Returns the node that replaces the math fallback. */\n  render(request: MathRenderRequest): HtmlNode | Promise<HtmlNode>;\n}\n\nexport interface MathRenderPluginOptions {\n  readonly mode?: PluginFailureMode;\n  readonly renderer: MathRenderer;\n}\n\n/** Renders math nodes through a caller-supplied renderer. */\nexport class MathRenderPlugin implements HtmlPlugin {\n  public readonly name = \"math-render\";\n  private readonly mode: PluginFailureMode;\n  private readonly renderer: MathRenderer;\n\n  public constructor(options: MathRenderPluginOptions) {\n    this.renderer = options.renderer;\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 !== \"math\") {\n        return;\n      }\n\n      const request: MathRenderRequest = { node, signal: context.signal };\n\n      try {\n        const result = this.renderer.render(request);\n\n        return isPromise(result)\n          ? result.then(\n              (rendered) => ({ ...rendered, origin: node.origin }),\n              (cause: unknown) => this.renderFailure(cause, node, context),\n            )\n          : { ...result, origin: node.origin };\n      } catch (cause) {\n        return this.renderFailure(cause, node, context);\n      }\n    });\n  }\n\n  private renderFailure(cause: unknown, node: HtmlMathNode, context: HtmlPluginContext): undefined {\n    if (this.mode === \"strict\") {\n      throw cause;\n    }\n\n    context.diagnostics.add({\n      severity: \"warning\",\n      code: \"mdx.plugin.math-render\",\n      message: `Could not render ${node.style} math: ${cause instanceof Error ? cause.message : String(cause)}`,\n      span:\n        node.origin === undefined\n          ? undefined\n          : { file: context.file, start: node.origin.start, end: node.origin.end },\n    });\n  }\n}\n"],"mappings":";;;;AAuBA,IAAa,mBAAb,MAAoD;CAClD,OAAuB;CACvB;CACA;CAEA,YAAmB,SAAkC;EACnD,KAAK,WAAW,QAAQ;EACxB,KAAK,OAAO,QAAQ,QAAQ;CAC9B;CAEA,UAAiB,SAAkE;EACjF,OAAO,iBAAiB,QAAQ,OAAO,SAAS;GAC9C,IAAI,KAAK,SAAS,QAChB;GAGF,MAAM,UAA6B;IAAE;IAAM,QAAQ,QAAQ;GAAO;GAElE,IAAI;IACF,MAAM,SAAS,KAAK,SAAS,OAAO,OAAO;IAE3C,OAAO,UAAU,MAAM,IACnB,OAAO,MACJ,cAAc;KAAE,GAAG;KAAU,QAAQ,KAAK;IAAO,KACjD,UAAmB,KAAK,cAAc,OAAO,MAAM,OAAO,CAC7D,IACA;KAAE,GAAG;KAAQ,QAAQ,KAAK;IAAO;GACvC,SAAS,OAAO;IACd,OAAO,KAAK,cAAc,OAAO,MAAM,OAAO;GAChD;EACF,CAAC;CACH;CAEA,cAAsB,OAAgB,MAAoB,SAAuC;EAC/F,IAAI,KAAK,SAAS,UAChB,MAAM;EAGR,QAAQ,YAAY,IAAI;GACtB,UAAU;GACV,MAAM;GACN,SAAS,oBAAoB,KAAK,MAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GACtG,MACE,KAAK,WAAW,KAAA,IACZ,KAAA,IACA;IAAE,MAAM,QAAQ;IAAM,OAAO,KAAK,OAAO;IAAO,KAAK,KAAK,OAAO;GAAI;EAC7E,CAAC;CACH;AACF"}

package/dist/plugins/mod.d.mts

@@ -1,5 +1,9 @@
-import { HeadingIdPluginOptions, headingIdPlugin } from "./heading-id/plugin.mjs";
-import { removeImportsExportsPlugin } from "./remove-imports-exports.mjs";
-import { SyntaxHighlightPluginOptions, syntaxHighlightPlugin } from "./syntax-highlight/plugin.mjs";
-import { MdxTreeProcessor, treeProcessorPlugin } from "./tree-processor/plugin.mjs";
-export { HeadingIdPluginOptions, MdxTreeProcessor, SyntaxHighlightPluginOptions, headingIdPlugin, removeImportsExportsPlugin, syntaxHighlightPlugin, treeProcessorPlugin };
+import { DocumentPlugin, DocumentPluginContext, HtmlPlugin, HtmlPluginContext, PluginFailureMode } from "../plugin.mjs";
+import { CodeBlockMetadata, CodeBlockMetadataError, CodeBlockMetadataIssue, CodeLineNumbers, CodeLineRange, CodeLineSelection, codeLineSelected, parseCodeBlockMetadata } from "./code-block-metadata.mjs";
+import { HeadingIdPlugin, HeadingIdPluginOptions } from "./heading-id.mjs";
+import { LowerHeadingPlugin, LowerHeadingPluginOptions } from "./lower-heading.mjs";
+import { MathRenderPlugin, MathRenderPluginOptions, MathRenderRequest, MathRenderer } from "./math-render.mjs";
+import { RemoveEsmPlugin } from "./remove-esm.mjs";
+import { AsynchronousSyntaxHighlighter, SynchronousSyntaxHighlighter, SyntaxHighlightPlugin, SyntaxHighlightPluginOptions, SyntaxHighlightRequest, SyntaxHighlighter } from "./syntax-highlight.mjs";
+import { ShikiCodeOptions, ShikiDataAttribute, ShikiHighlighterOptions, createShikiHighlighter } from "./shiki.mjs";
+export { AsynchronousSyntaxHighlighter, CodeBlockMetadata, CodeBlockMetadataError, CodeBlockMetadataIssue, CodeLineNumbers, CodeLineRange, CodeLineSelection, DocumentPlugin, DocumentPluginContext, HeadingIdPlugin, HeadingIdPluginOptions, HtmlPlugin, HtmlPluginContext, LowerHeadingPlugin, LowerHeadingPluginOptions, MathRenderPlugin, MathRenderPluginOptions, MathRenderRequest, MathRenderer, PluginFailureMode, RemoveEsmPlugin, ShikiCodeOptions, ShikiDataAttribute, ShikiHighlighterOptions, SynchronousSyntaxHighlighter, SyntaxHighlightPlugin, SyntaxHighlightPluginOptions, SyntaxHighlightRequest, SyntaxHighlighter, codeLineSelected, createShikiHighlighter, parseCodeBlockMetadata };

package/dist/plugins/mod.mjs

@@ -1,5 +1,8 @@
-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 };
+import { CodeBlockMetadataError, codeLineSelected, parseCodeBlockMetadata } from "./code-block-metadata.mjs";
+import { HeadingIdPlugin } from "./heading-id.mjs";
+import { LowerHeadingPlugin } from "./lower-heading.mjs";
+import { MathRenderPlugin } from "./math-render.mjs";
+import { RemoveEsmPlugin } from "./remove-esm.mjs";
+import { createShikiHighlighter } from "./shiki.mjs";
+import { SyntaxHighlightPlugin } from "./syntax-highlight.mjs";
+export { CodeBlockMetadataError, HeadingIdPlugin, LowerHeadingPlugin, MathRenderPlugin, RemoveEsmPlugin, SyntaxHighlightPlugin, codeLineSelected, createShikiHighlighter, parseCodeBlockMetadata };

package/dist/plugins/remove-esm.d.mts

@@ -0,0 +1,10 @@
+import { DocumentNode } from "../model.mjs";
+import { DocumentPlugin, DocumentPluginContext } from "../plugin.mjs";
+//#region src/plugins/remove-esm.d.ts
+/** Removes authored imports and exports while retaining all renderable content. */
+export declare class RemoveEsmPlugin implements DocumentPlugin {
+  readonly name = "remove-esm";
+  transform(context: DocumentPluginContext): DocumentNode;
+}
+//#endregion
+//# sourceMappingURL=remove-esm.d.mts.map

package/dist/plugins/remove-esm.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-esm.d.mts","names":[],"sources":["../../src/plugins/remove-esm.ts"],"mappings":";;;;qBAIa,2BAA2B;WACtB;EAET,UAAU,SAAS,wBAAwB"}

package/dist/plugins/remove-esm.mjs

@@ -0,0 +1,12 @@
+//#region src/plugins/remove-esm.ts
+/** Removes authored imports and exports while retaining all renderable content. */
+var RemoveEsmPlugin = class {
+	name = "remove-esm";
+	transform(context) {
+		return context.rewrite({ esm: () => null });
+	}
+};
+//#endregion
+export { RemoveEsmPlugin };
+
+//# sourceMappingURL=remove-esm.mjs.map

package/dist/plugins/remove-esm.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-esm.mjs","names":[],"sources":["../../src/plugins/remove-esm.ts"],"sourcesContent":["import type { DocumentNode } from \"../model.ts\";\nimport type { DocumentPlugin, DocumentPluginContext } from \"../plugin.ts\";\n\n/** Removes authored imports and exports while retaining all renderable content. */\nexport class RemoveEsmPlugin implements DocumentPlugin {\n  public readonly name = \"remove-esm\";\n\n  public transform(context: DocumentPluginContext): DocumentNode {\n    return context.rewrite({ esm: () => null });\n  }\n}\n"],"mappings":";;AAIA,IAAa,kBAAb,MAAuD;CACrD,OAAuB;CAEvB,UAAiB,SAA8C;EAC7D,OAAO,QAAQ,QAAQ,EAAE,WAAW,KAAK,CAAC;CAC5C;AACF"}

package/dist/plugins/shiki.d.mts

@@ -0,0 +1,21 @@
+import { SyntaxHighlighter } from "./syntax-highlight.mjs";
+import { CodeToHastOptions, HighlighterGeneric } from "shiki/types";
+//#region src/plugins/shiki.d.ts
+type ShikiHighlighter = Pick<HighlighterGeneric<string, string>, "codeToHast" | "getLoadedLanguages">;
+type ShikiCodeToHastOptions<T> = T extends unknown ? Omit<T, "lang" | "meta" | "structure"> : never;
+export type ShikiCodeOptions = ShikiCodeToHastOptions<CodeToHastOptions<string, string>>;
+export type ShikiDataAttribute = "language" | "line-count" | "meta" | "source-code";
+export type ShikiHighlighterOptions = ShikiCodeOptions & Readonly<{
+  commandLineClassName?: string;
+  fallbackLanguage?: string;
+  highlightedLineClassName?: string;
+  includeDataAttributes?: readonly ShikiDataAttribute[];
+  languageAliases?: Readonly<Record<string, string>>;
+  lineNumberClassName?: string;
+  lineNumberWidthProperty?: string;
+}>;
+/** Adapts a caller-owned, preloaded Shiki highlighter to Temelj's code highlighter. */
+export declare function createShikiHighlighter(highlighter: ShikiHighlighter, options: ShikiHighlighterOptions): SyntaxHighlighter;
+//#endregion
+export {};
+//# sourceMappingURL=shiki.d.mts.map

package/dist/plugins/shiki.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shiki.d.mts","names":[],"sources":["../../src/plugins/shiki.ts"],"mappings":";;;KASK,mBAAmB,KACtB;KAIG,uBAAuB,KAAK,oBAAoB,KAAK;YAE9C,mBAAmB,uBAAuB;YAE1C;YAEA,0BAA0B,mBACpC;EACE;EACA;EACA;EACA,iCAAiC;EACjC,kBAAkB,SAAS;EAC3B;EACA;;;wBAMY,uBACd,aAAa,kBACb,SAAS,0BACR"}