@temelj/mdx 0.13.0 → 0.15.0

package/dist/compiler.mjs

@@ -1,441 +1,208 @@
-import { compile } from "@mdx-js/mdx";
-import { validateStandardSchema } from "@temelj/standard-schema";
-import remarkFrontmatterPlugin from "remark-frontmatter";
-import remarkGfmPlugin from "remark-gfm";
-import { VFile } from "vfile";
-import { matter } from "vfile-matter";
+import { createDiagnostic } from "./diagnostics.mjs";
+import { CompileError, ConfigurationError, FrontmatterError, LimitError, MdxError } from "./errors.mjs";
+import { javascriptPropertyName } from "./javascript-ast.mjs";
+import { parseJavaScriptProgram } from "./javascript.mjs";
+import { analyzeDocument } from "./compile-analysis.mjs";
+import { contentUsesAwait, emitContent } from "./compile-emit.mjs";
+import { documentFrontmatter } from "./model.mjs";
+import { lowerHtml } from "./html-lower.mjs";
+import { CodeWriter } from "./source-map.mjs";
+import { isBigInt, isBoolean, isNumber, isObject, isString } from "@temelj/value";
 //#region src/compiler.ts
-var MdxCompileError = class MdxCompileError extends Error {
-	reason;
-	source;
-	ruleId;
-	line;
-	column;
-	place;
-	sourceLine;
-	snippet;
-	sourcePointer;
-	hint;
-	diagnostics;
-	constructor(reason, options = {}, context) {
-		super(formatDiagnosticMessage(reason, {
-			source: options.source,
-			ruleId: options.ruleId,
-			line: options.line,
-			column: options.column,
-			sourceLine: options.sourceLine,
-			snippet: options.snippet,
-			sourcePointer: options.sourcePointer,
-			hint: options.hint,
-			causeMessage: options.causeMessage
-		}), 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.sourcePointer = options.sourcePointer;
-		this.hint = options.hint;
-		this.diagnostics = options.diagnostics ?? [];
-		if (Error.captureStackTrace !== void 0) Error.captureStackTrace(this, context ?? this.constructor);
-	}
-	static create(reason, options = {}) {
-		return new MdxCompileError(reason, options, MdxCompileError.create);
-	}
-};
-/**
-* A reusable compiler for compiling MDX.
-*/
-var MdxCompiler = class {
-	mdxOptions;
-	remarkPlugins;
-	rehypePlugins;
-	constructor(mdxOptions = {}) {
-		this.mdxOptions = mdxOptions;
-		this.remarkPlugins = [remarkFrontmatterPlugin, remarkGfmPlugin];
-		this.rehypePlugins = [];
-	}
-	withRemarkPlugin(plugin, options) {
-		if (options === void 0) this.remarkPlugins.push(plugin);
-		else this.remarkPlugins.push([plugin, options]);
-		return this;
-	}
-	withRehypePlugin(plugin, options) {
-		if (options === void 0) this.rehypePlugins.push(plugin);
-		else this.rehypePlugins.push([plugin, options]);
-		return this;
-	}
-	async compile(source, { frontmatterOnly = false, mdxOptions } = {}, frontmatterSchema) {
-		const sourceText = toSourceText(source);
-		const vfile = new VFile({
-			value: source,
-			cwd: "/",
-			path: "/source.mdx"
+const DEFAULT_MAXIMUM_GENERATED_CODE_BYTES = 10485760;
+const DEFAULT_MAXIMUM_SOURCE_MAP_BYTES = 5242880;
+/** Emits JavaScript for a strict document. Throws for configuration errors and compiler limits. */
+function emitArtifact(document, options, frontmatter) {
+	try {
+		if (options.maximumGeneratedCodeBytes !== void 0 && (!Number.isSafeInteger(options.maximumGeneratedCodeBytes) || options.maximumGeneratedCodeBytes < 0)) throw ConfigurationError.invalidCompilerLimit("maximumGeneratedCodeBytes", options.maximumGeneratedCodeBytes);
+		if (options.maximumSourceMapBytes !== void 0 && (!Number.isSafeInteger(options.maximumSourceMapBytes) || options.maximumSourceMapBytes < 0)) throw ConfigurationError.invalidCompilerLimit("maximumSourceMapBytes", options.maximumSourceMapBytes);
+		const content = lowerHtml(document, options);
+		const analysis = analyzeDocument(document, content, options);
+		const usesAwait = contentUsesAwait(content);
+		const format = options.outputFormat ?? "functionBody";
+		const writer = new CodeWriter(options.source);
+		emitModulePreamble(writer, analysis, options, format);
+		emitContentFunction(writer, content, analysis, options, usesAwait);
+		emitPublicComponent(writer, analysis, options, usesAwait, format);
+		if (analysis.scope.missingReferences.size > 0) emitMissingReferenceHelper(writer, analysis);
+		if (format === "functionBody") writer.write(`return {${[...analysis.esm.exports, `default: ${analysis.scope.names.get("Content")}`].join(", ")}};\n}\n`);
+		const code = writer.toString();
+		enforceGeneratedCodeLimit(options.source, code, options.maximumGeneratedCodeBytes);
+		try {
+			parseJavaScriptProgram(format === "program" ? code : `async function __evaluateMdx(){\n${code}\n}`);
+		} catch (cause) {
+			throw CompileError.generatedProgramInvalid(cause);
+		}
+		const map = writer.sourceMap(analysis.scope.sourceName, options.outputName);
+		enforceSourceMapLimit(options.source, map, options.maximumSourceMapBytes);
+		return format === "program" ? Object.freeze({
+			format,
+			code,
+			map,
+			frontmatter
+		}) : Object.freeze({
+			format,
+			code,
+			map,
+			imports: Object.freeze(options.providerImportSource === void 0 || analysis.esm.imports.includes(options.providerImportSource) ? [...analysis.esm.imports] : [...analysis.esm.imports, options.providerImportSource]),
+			frontmatter
 		});
-		matter(vfile, { strip: true });
-		const sourceContext = createDiagnosticSourceContext(sourceText, toSourceText(vfile.value));
-		const remarkPlugins = [
-			...this.remarkPlugins,
-			...this.mdxOptions?.remarkPlugins ?? [],
-			...mdxOptions?.remarkPlugins ?? []
-		];
-		const rehypePlugins = [
-			...this.rehypePlugins,
-			...this.mdxOptions?.rehypePlugins ?? [],
-			...mdxOptions?.rehypePlugins ?? []
-		];
-		let compiled;
-		if (!frontmatterOnly) try {
-			compiled = (await compile(vfile, {
-				outputFormat: "function-body",
-				...this.mdxOptions,
-				...mdxOptions,
-				remarkPlugins,
-				rehypePlugins
-			})).value.toString();
-		} catch (error) {
-			throw toMdxCompileError(error, sourceContext, vfile.messages);
+	} catch (cause) {
+		if (cause instanceof MdxError) throw cause;
+		throw CompileError.generationFailed(cause);
+	}
+}
+async function compile(input, options = {}) {
+	const frontmatterNode = documentFrontmatter(input.document);
+	let frontmatter = frontmatterNode?.data ?? Object.freeze({});
+	if (options.frontmatterSchema !== void 0) {
+		const validated = await options.frontmatterSchema["~standard"].validate(frontmatter);
+		if (validated.issues !== void 0) {
+			const diagnostics = validated.issues.map((issue) => createDiagnostic({
+				severity: "error",
+				code: "mdx.frontmatter.schema",
+				message: formatSchemaIssue(issue),
+				span: fileSpan(input.file, frontmatterNode?.origin)
+			}));
+			throw FrontmatterError.schemaValidationFailed(input.file, diagnostics, validated.issues);
 		}
-		const frontmatter = frontmatterSchema === void 0 ? vfile.data.matter ?? {} : await validateStandardSchema(frontmatterSchema, vfile.data.matter ?? {}, "Frontmatter validation failed");
-		return {
-			compiled,
-			frontmatter,
-			messages: normalizeMessages(vfile.messages, sourceContext)
-		};
+		frontmatter = validated.value;
 	}
-};
-function toMdxCompileError(error, sourceContext, diagnostics) {
-	const details = getDiagnosticDetails(sourceContext, getErrorPlace(error), error);
-	const cause = getErrorCause(error);
-	return MdxCompileError.create(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,
-		sourcePointer: details.sourcePointer,
-		hint: details.hint,
-		causeMessage: cause?.message,
-		diagnostics: normalizeMessages(diagnostics, sourceContext),
-		cause: error
+	const transported = copyTransportValue(frontmatter, "frontmatter", {
+		file: input.file,
+		origin: frontmatterNode?.origin,
+		ancestors: /* @__PURE__ */ new WeakSet()
 	});
-}
-function normalizeMessages(messages, sourceContext) {
-	return messages.map((message) => {
-		const details = getDiagnosticDetails(sourceContext, 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,
-				sourcePointer: details.sourcePointer,
-				hint: details.hint,
-				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,
-			sourcePointer: details.sourcePointer,
-			hint: details.hint,
-			cause
-		};
+	const artifact = emitArtifact(input.document, {
+		...options,
+		source: input.file
+	}, transported);
+	return Object.freeze({
+		file: input.file,
+		document: input.document,
+		diagnostics: input.diagnostics,
+		artifact,
+		frontmatter
 	});
 }
-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.sourcePointer !== void 0) lines.push(`      ${options.sourcePointer}`);
-	}
-	if (options.causeMessage !== void 0 && options.causeMessage !== "" && options.causeMessage !== reason) lines.push(`Cause: ${options.causeMessage}`);
-	if (options.hint !== void 0) lines.push(`Hint: ${options.hint}`);
-	return lines.join("\n");
-}
-function getDiagnosticDetails(sourceContext, place, error) {
-	const compileLine = place?.start?.line ?? getErrorNumberField(error, "line");
-	let line = compileLine === void 0 ? void 0 : compileLine + sourceContext.lineOffset;
-	let column = place?.start?.column ?? getErrorNumberField(error, "column");
-	let normalizedPlace = mapPlaceToOriginalSource(place === void 0 && compileLine === void 0 && column === void 0 ? void 0 : {
-		start: {
-			line: compileLine,
-			column,
-			offset: place?.start?.offset
-		},
-		end: place?.end === void 0 ? void 0 : {
-			line: place.end.line,
-			column: place.end.column,
-			offset: place.end.offset
+function formatSchemaIssue(issue) {
+	const path = issue.path?.map((part) => String(isObject(part) ? part.key : part)).join(".");
+	return path === void 0 || path.length === 0 ? issue.message : `${path}: ${issue.message}`;
+}
+function copyTransportValue(value, path, context) {
+	const { ancestors } = context;
+	if (value === null || isBoolean(value) || isNumber(value) || isBigInt(value) || isString(value)) return value;
+	if (!isObject(value)) throw FrontmatterError.nonTransportableValue(context.file, context.origin, `${path} contains unsupported ${Object.prototype.toString.call(value)}`);
+	if (ancestors.has(value)) throw FrontmatterError.nonTransportableValue(context.file, context.origin, `${path} contains a cycle`);
+	ancestors.add(value);
+	if (Array.isArray(value)) {
+		const output = [];
+		for (let index = 0; index < value.length; index++) {
+			const item = copyTransportValue(value[index], `${path}[${index}]`, context);
+			output.push(item);
 		}
-	}, sourceContext.lineOffset);
-	let sourceLine = getSourceLine(sourceContext.originalSourceText, line);
-	let snippet = getSourceSnippet(sourceContext.originalSourceText, normalizedPlace);
-	let sourcePointer = getSourcePointer(column);
-	let hint;
-	const refinedExpressionContext = getMdxExpressionContext(sourceContext.originalSourceText, {
-		line,
-		column,
-		sourceLine,
-		snippet,
-		error
-	});
-	if (refinedExpressionContext !== void 0) {
-		line = refinedExpressionContext.line;
-		column = refinedExpressionContext.column;
-		sourceLine = refinedExpressionContext.sourceLine;
-		snippet = refinedExpressionContext.snippet;
-		sourcePointer = refinedExpressionContext.sourcePointer;
-		hint = refinedExpressionContext.hint;
-		normalizedPlace = {
-			start: {
-				line,
-				column,
-				offset: void 0
-			},
-			end: void 0
-		};
-	}
-	return {
-		line,
-		column,
-		place: normalizedPlace,
-		sourceLine,
-		snippet,
-		sourcePointer,
-		hint
-	};
-}
-function getMdxExpressionContext(sourceText, options) {
-	if (!shouldRefineMdxExpressionContext(options)) return;
-	const candidate = findSuspiciousBraceExpression(sourceText, options.line, options.column);
-	if (candidate === void 0) return;
-	return {
-		line: candidate.line,
-		column: candidate.column,
-		sourceLine: candidate.sourceLine,
-		snippet: candidate.snippet,
-		sourcePointer: getSourcePointer(candidate.column) ?? "^",
-		hint: getErrorCause(options.error)?.message === "Unexpected content after expression" ? "MDX treats `{...}` as JavaScript. If you meant literal braces in text, escape them or wrap the text in code." : void 0
-	};
-}
-function shouldRefineMdxExpressionContext(options) {
-	const trimmedSourceLine = options.sourceLine?.trim();
-	return isMdxExpressionError(options.error) && getErrorCause(options.error)?.message === "Unexpected content after expression" && (options.sourceLine === void 0 || options.sourceLine.trim() === "" || options.snippet === void 0) && !(trimmedSourceLine?.startsWith("{") && trimmedSourceLine.endsWith("}"));
-}
-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;
-	if (place.end === void 0) {
-		const line = sourceText.split(/\r?\n/u)[place.start.line - 1];
-		if (line === void 0) return;
-		const character = line.at(place.start.column - 1);
-		return character === void 0 || character.trim() === "" ? void 0 : character;
+		ancestors.delete(value);
+		return Object.freeze(output);
 	}
-	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);
+	const prototype = Object.getPrototypeOf(value);
+	if (prototype !== Object.prototype && prototype !== null) throw FrontmatterError.nonTransportableValue(context.file, context.origin, `${path} contains a non-plain object`);
+	if (Object.getOwnPropertySymbols(value).length > 0) throw FrontmatterError.nonTransportableValue(context.file, context.origin, `${path} contains a symbol property`);
+	const output = {};
+	for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {
+		if (!descriptor.enumerable) continue;
+		if (!("value" in descriptor)) throw FrontmatterError.nonTransportableValue(context.file, context.origin, `${path}.${key} is an accessor property`);
+		const item = copyTransportValue(descriptor.value, `${path}.${key}`, context);
+		Object.defineProperty(output, key, {
+			enumerable: true,
+			value: item
+		});
 	}
-	return selectedLines.join("\n") || void 0;
-}
-function getSourcePointer(column) {
-	if (column === void 0 || column < 1) return;
-	return `${" ".repeat(column - 1)}^`;
-}
-function mapPlaceToOriginalSource(place, lineOffset) {
-	if (place === void 0) return;
-	return {
-		start: mapPointToOriginalSource(place.start, lineOffset),
-		end: mapPointToOriginalSource(place.end, lineOffset)
+	ancestors.delete(value);
+	return Object.freeze(output);
+}
+function fileSpan(file, range) {
+	return range === void 0 ? void 0 : {
+		file,
+		start: range.start,
+		end: range.end
 	};
 }
-function mapPointToOriginalSource(point, lineOffset) {
-	if (point === void 0) return;
-	return {
-		line: point.line === void 0 ? void 0 : point.line + lineOffset,
-		column: point.column,
-		offset: lineOffset === 0 ? point.offset : void 0
-	};
-}
-function findSuspiciousBraceExpression(sourceText, line, column) {
-	const lines = sourceText.split(/\r?\n/u);
-	const searchLines = getNearbyLineNumbers(line, lines.length, 2);
-	let bestMatch;
-	for (const lineNumber of searchLines) {
-		const sourceLine = lines[lineNumber - 1];
-		if (sourceLine === void 0 || sourceLine.trim() === "") continue;
-		const expression = findLineBraceExpression(sourceLine, lineNumber, column);
-		if (expression === void 0) continue;
-		const score = (line === void 0 ? 0 : Math.abs(lineNumber - line)) * 10 + expression.distance;
-		if (bestMatch === void 0 || score < bestMatch.score) bestMatch = {
-			...expression,
-			score
-		};
-	}
-	return bestMatch;
-}
-function getNearbyLineNumbers(line, totalLines, radius) {
-	if (line === void 0) return Array.from({ length: totalLines }, (_, index) => index + 1);
-	const lineNumbers = [];
-	for (let distance = 0; distance <= radius; distance++) {
-		const before = line - distance;
-		if (before >= 1) lineNumbers.push(before);
-		if (distance === 0) continue;
-		const after = line + distance;
-		if (after <= totalLines) lineNumbers.push(after);
-	}
-	return lineNumbers;
-}
-function findLineBraceExpression(sourceLine, line, column) {
-	let bestMatch;
-	for (const match of sourceLine.matchAll(/\{[^{}\n]+\}/gu)) {
-		const braceStart = match.index;
-		if (braceStart === void 0) continue;
-		const expanded = expandBraceExpression(sourceLine, braceStart);
-		if (expanded === void 0) continue;
-		const distance = column === void 0 ? 0 : Math.abs(braceStart + 1 - column);
-		if (bestMatch === void 0 || distance < bestMatch.distance) bestMatch = {
-			line,
-			column: braceStart + 1,
-			sourceLine,
-			snippet: expanded,
-			distance
-		};
-	}
-	return bestMatch;
-}
-function expandBraceExpression(sourceLine, braceStart) {
-	const braceEnd = sourceLine.indexOf("}", braceStart);
-	if (braceEnd === -1) return;
-	let start = braceStart;
-	while (start > 0 && /[A-Za-z0-9_]/u.test(sourceLine[start - 1])) start--;
-	let end = braceEnd + 1;
-	while (end < sourceLine.length) {
-		while (end < sourceLine.length && /[A-Za-z0-9_]/u.test(sourceLine[end])) end++;
-		if (sourceLine[end] !== "{") break;
-		const chainedEnd = sourceLine.indexOf("}", end);
-		if (chainedEnd === -1) break;
-		end = chainedEnd + 1;
+/**
+* Authored ESM, the JSX runtime, and the optional provider. A function body
+* receives the runtime as `__mdxRuntime` and resolves imports through
+* `__resolveMdxImport` instead of importing.
+*/
+function emitModulePreamble(writer, analysis, options, format) {
+	const names = analysis.scope.names;
+	const runtime = analysis.scope.development ? `{Fragment: ${names.get("_Fragment")}, jsxDEV: ${names.get("_jsxDEV")}}` : `{Fragment: ${names.get("_Fragment")}, jsx: ${names.get("_jsx")}, jsxs: ${names.get("_jsxs")}}`;
+	const importSource = `${options.jsxImportSource ?? "react"}/${analysis.scope.development ? "jsx-dev-runtime" : "jsx-runtime"}`;
+	writer.write(format === "program" ? `import ${runtime.replaceAll(": ", " as ")} from ${JSON.stringify(importSource)};\n` : `const ${runtime} = __mdxRuntime;\n`);
+	if (format === "functionBody") {
+		if (analysis.esm.imports.length > 0 || options.providerImportSource !== void 0) writer.write(`const ${names.get("_resolveMdxImport")} = __resolveMdxImport;\n`);
+		writer.write("{\n");
 	}
-	return sourceLine.slice(start, end) || void 0;
-}
-function isMdxExpressionError(error) {
-	return getErrorField(error, "source") === "micromark-extension-mdx-expression" && getErrorField(error, "ruleId") === "acorn";
-}
-function createDiagnosticSourceContext(originalSourceText, compileSourceText) {
-	return {
-		originalSourceText,
-		lineOffset: getSourceLineOffset(originalSourceText, compileSourceText)
-	};
-}
-function getSourceLineOffset(originalSourceText, compileSourceText) {
-	const originalLines = originalSourceText.split(/\r?\n/u);
-	const compileLines = compileSourceText.split(/\r?\n/u);
-	const maxOffset = originalLines.length - compileLines.length;
-	for (let offset = 0; offset <= maxOffset; offset++) {
-		let isMatch = true;
-		for (let index = 0; index < compileLines.length; index++) if (originalLines[offset + index] !== compileLines[index]) {
-			isMatch = false;
-			break;
-		}
-		if (isMatch) return offset;
+	for (const entry of analysis.esm.blocks) writer.write(`${entry.code.trimEnd()}\n`, entry.origin);
+	if (options.providerImportSource !== void 0) writer.write(format === "program" ? `import {useMDXComponents as ${names.get("_provideComponents")}} from ${JSON.stringify(options.providerImportSource)};\n` : `const {useMDXComponents: ${names.get("_provideComponents")}} = await ${names.get("_resolveMdxImport")}(${JSON.stringify(options.providerImportSource)});\n`);
+}
+function emitContentFunction(writer, content, analysis, options, usesAwait) {
+	const names = analysis.scope.names;
+	const props = analysis.propsName;
+	const componentsName = names.get("_components");
+	writer.write(`${usesAwait ? "async " : ""}function ${names.get("_createContent")}(${props}) {\n`);
+	writer.write(`  const ${componentsName} = {`);
+	const tags = [...analysis.intrinsicTags].sort();
+	tags.forEach((tag, index) => {
+		if (index > 0) writer.write(", ");
+		writer.write(`${javascriptPropertyName(tag)}:${JSON.stringify(tag)}`);
+	});
+	if (options.providerImportSource !== void 0) writer.write(`${tags.length === 0 ? "" : ", "}...${names.get("_provideComponents")}()`);
+	writer.write(`${tags.length === 0 && options.providerImportSource === void 0 ? "" : ", "}...${props}.components};\n`);
+	const components = [...analysis.scope.referencedComponents].sort();
+	for (const component of components) writer.write(`  const ${component} = ${componentsName}[${JSON.stringify(component)}];\n`);
+	for (const [reference, component] of analysis.scope.missingReferences) writer.write(`  if (!${reference}) ${names.get("_missingReference")}(${JSON.stringify(reference)}, ${component});\n`);
+	writer.write("  return ");
+	emitContent(writer, content, analysis);
+	writer.write(";\n}\n");
+}
+function emitPublicComponent(writer, analysis, options, usesAwait, format) {
+	const names = analysis.scope.names;
+	const props = analysis.propsName;
+	const layout = names.get("Layout");
+	writer.write(`${format === "program" ? "export default " : ""}${usesAwait ? "async " : ""}function ${names.get("Content")}(${props} = {}) {\n`);
+	const content = `${usesAwait ? "await " : ""}${names.get("_createContent")}(${props})`;
+	if (analysis.esm.hasLayout) writer.write(`  return ${runtimeCall(analysis, layout, `{...${props}, children: ${content}}`)};\n`);
+	else {
+		writer.write(`  const {wrapper: ${layout}} = {`);
+		if (options.providerImportSource !== void 0) writer.write(`...${names.get("_provideComponents")}(), `);
+		writer.write(`...${props}.components};\n`);
+		writer.write(`  return ${layout} ? ${runtimeCall(analysis, layout, `{...${props}, children: ${content}}`)} : ${content};\n`);
 	}
-	return maxOffset > 0 ? maxOffset : 0;
-}
-function getErrorPlace(error) {
-	if (typeof error !== "object" || error === null) return;
-	const candidate = error;
-	return toPlace(candidate.place) ?? toPlace(candidate.position);
+	writer.write("}\n");
 }
-function toMessagePlace(message) {
-	return toPlace(message.place);
+function emitMissingReferenceHelper(writer, analysis) {
+	const names = analysis.scope.names;
+	writer.write(`class ${names.get("ReferenceError")} extends Error {\n  constructor(id, component) {
+    super(\`Expected \${component ? "component" : "object"} \${id} to be defined: you likely forgot to import, pass, or provide it.\`);
+    this.name = "ReferenceError";
+  }
 }
-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 ${names.get("_missingReference")}(id, component) {\n  throw new ${names.get("ReferenceError")}(id, component);\n}
+`);
 }
-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 enforceGeneratedCodeLimit(file, code, configuredMaximum) {
+	const maximum = configuredMaximum ?? DEFAULT_MAXIMUM_GENERATED_CODE_BYTES;
+	const actual = new TextEncoder().encode(code).byteLength;
+	if (actual > maximum) throw LimitError.exceeded(file, "maximumGeneratedCodeBytes", maximum, void 0, actual);
 }
-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 enforceSourceMapLimit(file, map, configuredMaximum) {
+	const maximum = configuredMaximum ?? DEFAULT_MAXIMUM_SOURCE_MAP_BYTES;
+	const actual = new TextEncoder().encode(JSON.stringify(map)).byteLength;
+	if (actual > maximum) throw LimitError.exceeded(file, "maximumSourceMapBytes", maximum, void 0, actual);
 }
-function toSourceText(source) {
-	return typeof source === "string" ? source : new TextDecoder().decode(source);
+function runtimeCall(analysis, tag, properties) {
+	return analysis.scope.development ? `${analysis.scope.names.get("_jsxDEV")}(${tag}, ${properties}, undefined, false, undefined, undefined)` : `${analysis.scope.names.get("_jsx")}(${tag}, ${properties})`;
 }
 //#endregion
-export { MdxCompileError, MdxCompiler, remarkFrontmatterPlugin, remarkGfmPlugin };
+export { compile };
 
 //# sourceMappingURL=compiler.mjs.map