@temelj/mdx 0.15.0 → 0.16.0

package/dist/frontmatter.mjs

@@ -1,187 +1,109 @@
-import { isBigInt, isBoolean, isFunction, isNumber, isObject, isPlainObject, isString, isSymbol } from "@temelj/value";
-import { TomlDate, TomlError, parse } from "smol-toml";
-import { parseDocument } from "yaml";
+import { DiagnosticBag } from "./diagnostics.mjs";
+import { LimitError, ParseError } from "./errors.mjs";
+import { frontmatterSchemaValue } from "./frontmatter-schema.mjs";
+import { SourceFile, sourceText } from "./source.mjs";
+import { decodeFrontmatter } from "./frontmatter-decode.mjs";
+import { resolveParserLimits } from "./parser/config.mjs";
+import { isPromise } from "@temelj/value";
+import { StandardSchemaAsyncValidationError } from "@temelj/standard-schema";
 //#region src/frontmatter.ts
-const maximumYamlAliases = 100;
-const maximumTomlDepth = 256;
-function decodeFrontmatter(options) {
-	return options.format === "yaml" ? decodeYaml(options) : decodeToml(options);
-}
-function decodeYaml(options) {
-	let document;
-	try {
-		document = parseDocument(options.source, {
-			customTags: [],
-			intAsBigInt: true,
-			logLevel: "silent",
-			prettyErrors: false,
-			resolveKnownTags: false,
-			schema: "core",
-			strict: true,
-			stringKeys: true,
-			uniqueKeys: true,
-			version: "1.2"
-		});
-	} catch (cause) {
-		addParserFailure(options, cause);
-		return;
-	}
-	for (const warning of document.warnings) options.diagnostics.add({
-		code: yamlCode(warning.code),
-		message: warning.message,
-		severity: "warning",
-		span: relativeSpan(options.span, warning.pos[0], warning.pos[1])
-	});
-	for (const error of document.errors) options.diagnostics.add({
-		code: yamlCode(error.code),
-		message: error.message,
-		severity: "error",
-		span: relativeSpan(options.span, error.pos[0], error.pos[1])
-	});
-	if (document.errors.length > 0) return;
-	let parsed;
-	try {
-		parsed = document.contents === null ? {} : document.toJS({ maxAliasCount: maximumYamlAliases });
-	} catch (cause) {
-		addParserFailure(options, cause);
-		return;
-	}
-	return convertRoot(parsed, options);
-}
-function decodeToml(options) {
-	let parsed;
-	try {
-		parsed = parse(options.source, {
-			integersAsBigInt: "asNeeded",
-			maxDepth: maximumTomlDepth
-		});
-	} catch (cause) {
-		if (cause instanceof TomlError) {
-			const offset = lineColumnOffset(options.source, cause.line, cause.column);
-			options.diagnostics.add({
-				code: "mdx.frontmatter.toml",
-				message: cause.message,
-				severity: "error",
-				span: relativeSpan(options.span, offset, offset + 1)
-			});
-		} else addParserFailure(options, cause);
-		return;
-	}
-	return convertRoot(parsed, options);
-}
-function convertRoot(value, options) {
-	if (!isPlainObject(value)) {
-		options.diagnostics.add({
-			code: "mdx.frontmatter.root",
-			message: "FrontmatterNode must contain a mapping at its root",
-			severity: "error",
-			span: options.span
-		});
-		return;
-	}
-	return convertObject(value, options, "$", /* @__PURE__ */ new WeakSet());
-}
-function convertValue(value, options, path, active) {
-	if (value === null || isBoolean(value) || isNumber(value) || isString(value)) return value;
-	if (isBigInt(value)) return value >= BigInt(Number.MIN_SAFE_INTEGER) && value <= BigInt(Number.MAX_SAFE_INTEGER) ? Number(value) : value;
-	if (value instanceof TomlDate) return convertTemporal(value);
-	if (Array.isArray(value)) {
-		if (active.has(value)) return invalidValue(options, path, "cyclic alias");
-		active.add(value);
-		const converted = [];
-		for (const [index, item] of value.entries()) {
-			const result = convertValue(item, options, `${path}[${index}]`, active);
-			if (result === void 0) return;
-			converted.push(result);
-		}
-		active.delete(value);
-		Object.freeze(converted);
-		return converted;
-	}
-	if (isPlainObject(value)) return convertObject(value, options, path, active);
-	return invalidValue(options, path, describeValue(value));
-}
-function convertObject(value, options, path, active) {
-	if (active.has(value)) return invalidValue(options, path, "cyclic alias");
-	active.add(value);
-	const converted = {};
-	for (const [key, item] of Object.entries(value)) {
-		const result = convertValue(item, options, propertyPath(path, key), active);
-		if (result === void 0) return;
-		Object.defineProperty(converted, key, {
-			configurable: false,
-			enumerable: true,
-			value: result,
-			writable: false
-		});
-	}
-	active.delete(value);
-	Object.freeze(converted);
-	return converted;
-}
-function convertTemporal(value) {
-	const type = value.isDateTime() ? value.isLocal() ? "local-date-time" : "offset-date-time" : value.isDate() ? "local-date" : "local-time";
+async function parseFrontmatter(input, options = {}) {
+	const { result, origin } = readFrontmatter(input, options);
+	if (options.frontmatterSchema === void 0) return result;
+	const validated = await options.frontmatterSchema["~standard"].validate(result.frontmatter);
 	return Object.freeze({
-		kind: "temporal",
-		type,
-		value: value.toISOString()
-	});
-}
-function invalidValue(options, path, description) {
-	options.diagnostics.add({
-		code: "mdx.frontmatter.value",
-		message: `Unsupported frontmatter value at ${path}: ${description}`,
-		severity: "error",
-		span: options.span
+		...result,
+		frontmatter: frontmatterSchemaValue(validated, result.file, origin)
 	});
 }
-function addParserFailure(options, cause) {
-	const message = cause instanceof Error ? cause.message : String(cause);
-	options.diagnostics.add({
-		code: `mdx.frontmatter.${options.format}`,
-		message,
-		severity: "error",
-		span: options.span
-	});
-}
-function yamlCode(code) {
-	return code === "RESOURCE_EXHAUSTION" ? "mdx.frontmatter.resource" : "mdx.frontmatter.yaml";
-}
-function relativeSpan(span, start, end) {
-	const length = span.end - span.start;
-	const relativeStart = Math.max(0, Math.min(start, length));
-	const relativeEnd = Math.max(relativeStart, Math.min(end, length));
+function parseFrontmatterSync(input, options = {}) {
+	const { result, origin } = readFrontmatter(input, options);
+	if (options.frontmatterSchema === void 0) return result;
+	const validated = options.frontmatterSchema["~standard"].validate(result.frontmatter);
+	if (isPromise(validated)) StandardSchemaAsyncValidationError.unsupported();
 	return Object.freeze({
-		file: span.file,
-		start: span.start + relativeStart,
-		end: span.start + relativeEnd
+		...result,
+		frontmatter: frontmatterSchemaValue(validated, result.file, origin)
 	});
 }
-function lineColumnOffset(source, line, column) {
-	const lineStart = lineStartOffsets(source)[Math.max(0, line - 1)] ?? source.length;
-	return Math.min(source.length, lineStart + Math.max(0, column - 1));
-}
-function propertyPath(path, key) {
-	return /^[A-Za-z_$][\w$]*$/u.test(key) ? `${path}.${key}` : `${path}[${JSON.stringify(key)}]`;
-}
-function describeValue(value) {
-	if (value === void 0) return "undefined";
-	if (isFunction(value)) return "function";
-	if (isSymbol(value)) return "symbol";
-	if (value instanceof Map) return "Map";
-	if (value instanceof Set) return "Set";
-	if (value instanceof Date) return "Date";
-	return isObject(value) ? value.constructor?.name ?? "object" : String(value);
+function readFrontmatter(input, options) {
+	const file = input instanceof SourceFile ? input : new SourceFile(input);
+	const { maximumSourceLength } = resolveParserLimits(options.limits);
+	if (file.length > maximumSourceLength) throw LimitError.exceeded(file, "maximumSourceLength", maximumSourceLength, void 0, file.length);
+	const source = sourceText(file);
+	const opening = readLine(source, 0);
+	const fence = source.slice(0, opening.contentEnd).trim();
+	const format = fence === "---" ? "yaml" : fence === "+++" ? "toml" : void 0;
+	if (format !== void 0 && (options.format === void 0 || options.format === "auto" || options.format === format)) {
+		const valueStart = opening.end;
+		for (let start = valueStart; start < source.length;) {
+			const line = readLine(source, start);
+			if (source.slice(start, line.contentEnd).trim() === fence) {
+				let valueEnd = start;
+				if (valueEnd > valueStart && source.char(valueEnd - 1) === "\n") valueEnd--;
+				if (valueEnd > valueStart && source.char(valueEnd - 1) === "\r") valueEnd--;
+				const diagnostics = new DiagnosticBag();
+				const frontmatter = decodeFrontmatter({
+					diagnostics,
+					format,
+					source: source.slice(valueStart, valueEnd),
+					span: {
+						file,
+						start: valueStart,
+						end: valueEnd
+					}
+				});
+				if (frontmatter === void 0) {
+					const [first, ...rest] = diagnostics.snapshot().filter((diagnostic) => diagnostic.severity === "error");
+					if (first === void 0) throw new Error("Invalid frontmatter did not produce an error diagnostic");
+					throw ParseError.invalidSyntax(file, [first, ...rest]);
+				}
+				return {
+					result: Object.freeze({
+						file,
+						frontmatter,
+						format,
+						diagnostics: diagnostics.snapshot()
+					}),
+					origin: {
+						start: source.char(0) === "" ? 1 : 0,
+						end: line.end
+					}
+				};
+			}
+			start = line.end;
+		}
+	}
+	return {
+		result: Object.freeze({
+			file,
+			frontmatter: Object.freeze({}),
+			format: void 0,
+			diagnostics: Object.freeze([])
+		}),
+		origin: void 0
+	};
 }
-function lineStartOffsets(source) {
-	const offsets = [0];
-	for (let index = 0; index < source.length; index++) if (source[index] === "\r") {
-		if (source[index + 1] === "\n") index++;
-		offsets.push(index + 1);
-	} else if (source[index] === "\n") offsets.push(index + 1);
-	return offsets;
+/** Reads one physical line without indexing or normalizing the rest of the document. */
+function readLine(source, start) {
+	let end = start;
+	while (end < source.length) {
+		const character = source.char(end);
+		if (character === "\n" || character === "\r") {
+			const endingLength = character === "\r" && source.char(end + 1) === "\n" ? 2 : 1;
+			return {
+				contentEnd: end,
+				end: end + endingLength
+			};
+		}
+		end++;
+	}
+	return {
+		contentEnd: end,
+		end
+	};
 }
 //#endregion
-export { decodeFrontmatter };
+export { parseFrontmatter, parseFrontmatterSync };
 
 //# sourceMappingURL=frontmatter.mjs.map

package/dist/frontmatter.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.mjs","names":["parseToml"],"sources":["../src/frontmatter.ts"],"sourcesContent":["import {\n  isBoolean,\n  isNumber,\n  isString,\n  isBigInt,\n  isFunction,\n  isSymbol,\n  isObject,\n  isPlainObject,\n} from \"@temelj/value\";\nimport { parse as parseToml, TomlDate, TomlError } from \"smol-toml\";\nimport { parseDocument } from \"yaml\";\n\nimport type { DiagnosticReporter } from \"./diagnostics.ts\";\nimport type { FrontmatterObject, FrontmatterTemporal, FrontmatterValue } from \"./model.ts\";\nimport type { SourceSpan } from \"./source.ts\";\nimport type { FrontmatterFormat } from \"./syntax-options.ts\";\n\ninterface DecodeOptions {\n  readonly diagnostics: DiagnosticReporter;\n  readonly format: FrontmatterFormat;\n  readonly source: string;\n  readonly span: SourceSpan;\n}\n\nconst maximumYamlAliases = 100;\n\nconst maximumTomlDepth = 256;\n\nexport function decodeFrontmatter(options: DecodeOptions): FrontmatterObject | undefined {\n  return options.format === \"yaml\" ? decodeYaml(options) : decodeToml(options);\n}\n\nfunction decodeYaml(options: DecodeOptions): FrontmatterObject | undefined {\n  let document: ReturnType<typeof parseDocument>;\n\n  try {\n    document = parseDocument(options.source, {\n      customTags: [],\n      intAsBigInt: true,\n      logLevel: \"silent\",\n      prettyErrors: false,\n      resolveKnownTags: false,\n      schema: \"core\",\n      strict: true,\n      stringKeys: true,\n      uniqueKeys: true,\n      version: \"1.2\",\n    });\n  } catch (cause) {\n    addParserFailure(options, cause);\n\n    return undefined;\n  }\n\n  for (const warning of document.warnings) {\n    options.diagnostics.add({\n      code: yamlCode(warning.code),\n      message: warning.message,\n      severity: \"warning\",\n      span: relativeSpan(options.span, warning.pos[0], warning.pos[1]),\n    });\n  }\n\n  for (const error of document.errors) {\n    options.diagnostics.add({\n      code: yamlCode(error.code),\n      message: error.message,\n      severity: \"error\",\n      span: relativeSpan(options.span, error.pos[0], error.pos[1]),\n    });\n  }\n\n  if (document.errors.length > 0) {\n    return undefined;\n  }\n\n  let parsed: unknown;\n\n  try {\n    parsed = document.contents === null ? {} : document.toJS({ maxAliasCount: maximumYamlAliases });\n  } catch (cause) {\n    addParserFailure(options, cause);\n\n    return undefined;\n  }\n\n  return convertRoot(parsed, options);\n}\n\nfunction decodeToml(options: DecodeOptions): FrontmatterObject | undefined {\n  let parsed: unknown;\n\n  try {\n    parsed = parseToml(options.source, {\n      integersAsBigInt: \"asNeeded\",\n      maxDepth: maximumTomlDepth,\n    });\n  } catch (cause) {\n    if (cause instanceof TomlError) {\n      const offset = lineColumnOffset(options.source, cause.line, cause.column);\n      options.diagnostics.add({\n        code: \"mdx.frontmatter.toml\",\n        message: cause.message,\n        severity: \"error\",\n        span: relativeSpan(options.span, offset, offset + 1),\n      });\n    } else {\n      addParserFailure(options, cause);\n    }\n\n    return undefined;\n  }\n\n  return convertRoot(parsed, options);\n}\n\n// oxlint-disable-next-line anti-slop/no-unknown-parameters -- YAML/TOML root input is validated here.\nfunction convertRoot(value: unknown, options: DecodeOptions): FrontmatterObject | undefined {\n  if (!isPlainObject(value)) {\n    options.diagnostics.add({\n      code: \"mdx.frontmatter.root\",\n      message: \"FrontmatterNode must contain a mapping at its root\",\n      severity: \"error\",\n      span: options.span,\n    });\n\n    return undefined;\n  }\n\n  return convertObject(value, options, \"$\", new WeakSet<object>());\n}\n\nfunction convertValue(\n  // oxlint-disable-next-line anti-slop/no-unknown-parameters -- Recursively validates parser values before producing FrontmatterValue.\n  value: unknown,\n  options: DecodeOptions,\n  path: string,\n  active: WeakSet<object>,\n): FrontmatterValue | undefined {\n  if (value === null || isBoolean(value) || isNumber(value) || isString(value)) {\n    return value;\n  }\n\n  if (isBigInt(value)) {\n    return value >= BigInt(Number.MIN_SAFE_INTEGER) && value <= BigInt(Number.MAX_SAFE_INTEGER)\n      ? Number(value)\n      : value;\n  }\n\n  if (value instanceof TomlDate) {\n    return convertTemporal(value);\n  }\n\n  if (Array.isArray(value)) {\n    if (active.has(value)) {\n      return invalidValue(options, path, \"cyclic alias\");\n    }\n\n    active.add(value);\n    const converted: FrontmatterValue[] = [];\n\n    for (const [index, item] of value.entries()) {\n      const result = convertValue(item, options, `${path}[${index}]`, active);\n\n      if (result === undefined) {\n        return undefined;\n      }\n\n      converted.push(result);\n    }\n\n    active.delete(value);\n    Object.freeze(converted);\n\n    return converted;\n  }\n\n  if (isPlainObject(value)) {\n    return convertObject(value, options, path, active);\n  }\n\n  return invalidValue(options, path, describeValue(value));\n}\n\nfunction convertObject(\n  // oxlint-disable-next-line anti-slop/no-object-parameters -- YAML/TOML mapping boundary; every entry is converted to FrontmatterValue below.\n  value: object,\n  options: DecodeOptions,\n  path: string,\n  active: WeakSet<object>,\n): FrontmatterObject | undefined {\n  if (active.has(value)) {\n    return invalidValue(options, path, \"cyclic alias\");\n  }\n\n  active.add(value);\n  const converted: Record<string, FrontmatterValue> = {};\n\n  for (const [key, item] of Object.entries(value)) {\n    const itemPath = propertyPath(path, key);\n    const result = convertValue(item, options, itemPath, active);\n\n    if (result === undefined) {\n      return undefined;\n    }\n\n    Object.defineProperty(converted, key, {\n      configurable: false,\n      enumerable: true,\n      value: result,\n      writable: false,\n    });\n  }\n\n  active.delete(value);\n  Object.freeze(converted);\n\n  return converted;\n}\n\nfunction convertTemporal(value: TomlDate): FrontmatterTemporal {\n  const type = value.isDateTime()\n    ? value.isLocal()\n      ? \"local-date-time\"\n      : \"offset-date-time\"\n    : value.isDate()\n      ? \"local-date\"\n      : \"local-time\";\n\n  return Object.freeze({ kind: \"temporal\", type, value: value.toISOString() });\n}\n\nfunction invalidValue(options: DecodeOptions, path: string, description: string): undefined {\n  options.diagnostics.add({\n    code: \"mdx.frontmatter.value\",\n    message: `Unsupported frontmatter value at ${path}: ${description}`,\n    severity: \"error\",\n    span: options.span,\n  });\n\n  return undefined;\n}\n\nfunction addParserFailure(options: DecodeOptions, cause: unknown): void {\n  const message = cause instanceof Error ? cause.message : String(cause);\n  options.diagnostics.add({\n    code: `mdx.frontmatter.${options.format}`,\n    message,\n    severity: \"error\",\n    span: options.span,\n  });\n}\n\nfunction yamlCode(code: string): string {\n  return code === \"RESOURCE_EXHAUSTION\" ? \"mdx.frontmatter.resource\" : \"mdx.frontmatter.yaml\";\n}\n\nfunction relativeSpan(span: SourceSpan, start: number, end: number): SourceSpan {\n  const length = span.end - span.start;\n  const relativeStart = Math.max(0, Math.min(start, length));\n  const relativeEnd = Math.max(relativeStart, Math.min(end, length));\n\n  return Object.freeze({\n    file: span.file,\n    start: span.start + relativeStart,\n    end: span.start + relativeEnd,\n  });\n}\n\nfunction lineColumnOffset(source: string, line: number, column: number): number {\n  const lineStart = lineStartOffsets(source)[Math.max(0, line - 1)] ?? source.length;\n\n  return Math.min(source.length, lineStart + Math.max(0, column - 1));\n}\n\nfunction propertyPath(path: string, key: string): string {\n  return /^[A-Za-z_$][\\w$]*$/u.test(key) ? `${path}.${key}` : `${path}[${JSON.stringify(key)}]`;\n}\n\n// oxlint-disable-next-line anti-slop/no-unknown-parameters -- Describes a rejected value at the YAML/TOML validation boundary.\nfunction describeValue(value: unknown): string {\n  if (value === undefined) {\n    return \"undefined\";\n  }\n\n  if (isFunction(value)) {\n    return \"function\";\n  }\n\n  if (isSymbol(value)) {\n    return \"symbol\";\n  }\n\n  if (value instanceof Map) {\n    return \"Map\";\n  }\n\n  if (value instanceof Set) {\n    return \"Set\";\n  }\n\n  if (value instanceof Date) {\n    return \"Date\";\n  }\n\n  return isObject(value) ? (value.constructor?.name ?? \"object\") : String(value);\n}\n\nfunction lineStartOffsets(source: string): readonly number[] {\n  const offsets = [0];\n\n  for (let index = 0; index < source.length; index++) {\n    if (source[index] === \"\\r\") {\n      if (source[index + 1] === \"\\n\") {\n        index++;\n      }\n\n      offsets.push(index + 1);\n    } else if (source[index] === \"\\n\") {\n      offsets.push(index + 1);\n    }\n  }\n\n  return offsets;\n}\n"],"mappings":"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"}
+{"version":3,"file":"frontmatter.mjs","names":[],"sources":["../src/frontmatter.ts"],"sourcesContent":["import type { Schema, SchemaOutput } from \"@temelj/standard-schema\";\n\nimport { StandardSchemaAsyncValidationError } from \"@temelj/standard-schema\";\nimport { isPromise } from \"@temelj/value\";\n\nimport type { Diagnostic } from \"./diagnostics.ts\";\nimport type { FrontmatterObject } from \"./model.ts\";\nimport type { ParserLimits } from \"./parser/config.ts\";\nimport type { SourceRange } from \"./ranges.ts\";\nimport type { SourceText } from \"./source-text.ts\";\nimport type { FrontmatterFormat, FrontmatterMode } from \"./syntax-options.ts\";\n\nimport { DiagnosticBag } from \"./diagnostics.ts\";\nimport { LimitError, ParseError } from \"./errors.ts\";\nimport { decodeFrontmatter } from \"./frontmatter-decode.ts\";\nimport { frontmatterSchemaValue } from \"./frontmatter-schema.ts\";\nimport { resolveParserLimits } from \"./parser/config.ts\";\nimport { SourceFile, sourceText } from \"./source.ts\";\n\nexport interface FrontmatterParseOptions {\n  /** Formats to recognize. Defaults to both YAML and TOML. */\n  readonly format?: FrontmatterMode;\n  /** Limits the entire input length in UTF-16 code units, without scanning its body. */\n  readonly limits?: Pick<ParserLimits, \"maximumSourceLength\">;\n}\n\nexport interface FrontmatterParseSchemaOptions<\n  TSchema extends Schema,\n> extends FrontmatterParseOptions {\n  readonly frontmatterSchema: TSchema;\n}\n\nexport interface FrontmatterParseResult<T = FrontmatterObject> {\n  readonly file: SourceFile;\n  readonly frontmatter: T;\n  /** Undefined when no complete, enabled frontmatter block was found. */\n  readonly format: FrontmatterFormat | undefined;\n  readonly diagnostics: readonly Diagnostic[];\n}\n\n/**\n * Reads only the opening frontmatter block and optionally validates its metadata.\n * @throws {ParseError} Invalid YAML or TOML.\n * @throws {FrontmatterError} Schema validation fails.\n * @throws {LimitError | ConfigurationError} Invalid or exceeded source-length limit.\n */\nexport function parseFrontmatter<TSchema extends Schema>(\n  input: string | SourceFile,\n  options: FrontmatterParseSchemaOptions<TSchema>,\n): Promise<FrontmatterParseResult<SchemaOutput<TSchema>>>;\nexport function parseFrontmatter(\n  input: string | SourceFile,\n  options?: FrontmatterParseOptions,\n): Promise<FrontmatterParseResult>;\nexport async function parseFrontmatter(\n  input: string | SourceFile,\n  options: FrontmatterParseOptions & { readonly frontmatterSchema?: Schema } = {},\n): Promise<FrontmatterParseResult<unknown>> {\n  const { result, origin } = readFrontmatter(input, options);\n\n  if (options.frontmatterSchema === undefined) {\n    return result;\n  }\n\n  const validated = await options.frontmatterSchema[\"~standard\"].validate(result.frontmatter);\n\n  return Object.freeze({\n    ...result,\n    frontmatter: frontmatterSchemaValue(validated, result.file, origin),\n  });\n}\n\n/**\n * Reads frontmatter synchronously, including synchronous schema validation.\n * @throws {StandardSchemaAsyncValidationError} The schema returns a promise.\n * @throws {ParseError | FrontmatterError | LimitError | ConfigurationError} Parsing fails.\n */\nexport function parseFrontmatterSync<TSchema extends Schema>(\n  input: string | SourceFile,\n  options: FrontmatterParseSchemaOptions<TSchema>,\n): FrontmatterParseResult<SchemaOutput<TSchema>>;\nexport function parseFrontmatterSync(\n  input: string | SourceFile,\n  options?: FrontmatterParseOptions,\n): FrontmatterParseResult;\nexport function parseFrontmatterSync(\n  input: string | SourceFile,\n  options: FrontmatterParseOptions & { readonly frontmatterSchema?: Schema } = {},\n): FrontmatterParseResult<unknown> {\n  const { result, origin } = readFrontmatter(input, options);\n\n  if (options.frontmatterSchema === undefined) {\n    return result;\n  }\n\n  const validated = options.frontmatterSchema[\"~standard\"].validate(result.frontmatter);\n\n  if (isPromise(validated)) {\n    StandardSchemaAsyncValidationError.unsupported();\n  }\n\n  return Object.freeze({\n    ...result,\n    frontmatter: frontmatterSchemaValue(validated, result.file, origin),\n  });\n}\n\ninterface ReadFrontmatterResult {\n  readonly result: FrontmatterParseResult;\n  readonly origin: SourceRange | undefined;\n}\n\nfunction readFrontmatter(\n  input: string | SourceFile,\n  options: FrontmatterParseOptions,\n): ReadFrontmatterResult {\n  const file = input instanceof SourceFile ? input : new SourceFile(input);\n  const { maximumSourceLength } = resolveParserLimits(options.limits);\n\n  if (file.length > maximumSourceLength) {\n    throw LimitError.exceeded(\n      file,\n      \"maximumSourceLength\",\n      maximumSourceLength,\n      undefined,\n      file.length,\n    );\n  }\n\n  const source = sourceText(file);\n  const opening = readLine(source, 0);\n  const fence = source.slice(0, opening.contentEnd).trim();\n  const format = fence === \"---\" ? \"yaml\" : fence === \"+++\" ? \"toml\" : undefined;\n\n  if (\n    format !== undefined &&\n    (options.format === undefined || options.format === \"auto\" || options.format === format)\n  ) {\n    const valueStart = opening.end;\n\n    for (let start = valueStart; start < source.length;) {\n      const line = readLine(source, start);\n\n      if (source.slice(start, line.contentEnd).trim() === fence) {\n        let valueEnd = start;\n\n        if (valueEnd > valueStart && source.char(valueEnd - 1) === \"\\n\") {\n          valueEnd--;\n        }\n\n        if (valueEnd > valueStart && source.char(valueEnd - 1) === \"\\r\") {\n          valueEnd--;\n        }\n\n        const diagnostics = new DiagnosticBag();\n\n        const frontmatter = decodeFrontmatter({\n          diagnostics,\n          format,\n          source: source.slice(valueStart, valueEnd),\n          span: { file, start: valueStart, end: valueEnd },\n        });\n\n        if (frontmatter === undefined) {\n          const [first, ...rest] = diagnostics\n            .snapshot()\n            .filter((diagnostic) => diagnostic.severity === \"error\");\n\n          if (first === undefined) {\n            throw new Error(\"Invalid frontmatter did not produce an error diagnostic\");\n          }\n\n          throw ParseError.invalidSyntax(file, [first, ...rest]);\n        }\n\n        return {\n          result: Object.freeze({ file, frontmatter, format, diagnostics: diagnostics.snapshot() }),\n          origin: { start: source.char(0) === \"\\uFEFF\" ? 1 : 0, end: line.end },\n        };\n      }\n\n      start = line.end;\n    }\n  }\n\n  return {\n    result: Object.freeze({\n      file,\n      frontmatter: Object.freeze({}),\n      format: undefined,\n      diagnostics: Object.freeze([]),\n    }),\n    origin: undefined,\n  };\n}\n\ninterface FrontmatterLine {\n  readonly contentEnd: number;\n  readonly end: number;\n}\n\n/** Reads one physical line without indexing or normalizing the rest of the document. */\nfunction readLine(source: SourceText, start: number): FrontmatterLine {\n  let end = start;\n\n  while (end < source.length) {\n    const character = source.char(end);\n\n    if (character === \"\\n\" || character === \"\\r\") {\n      const endingLength = character === \"\\r\" && source.char(end + 1) === \"\\n\" ? 2 : 1;\n\n      return { contentEnd: end, end: end + endingLength };\n    }\n\n    end++;\n  }\n\n  return { contentEnd: end, end };\n}\n"],"mappings":"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"}

package/dist/mod.d.mts

@@ -13,6 +13,7 @@ import { CompileArtifact, CompileOptions, CompileOutputFormat, CompileResult, Co
 import { CompilationInvariant, CompilationIssue, CompileError, CompileLimit, ConfigurationError, ConfigurationIssue, FrontmatterError, FrontmatterIssue, InputError, InputIssue, LimitError, MdxError, ParseError, TransformError, TransformIssue, TransformTarget } from "./errors.mjs";
 import { FormatOptions } from "./format-context.mjs";
 import { formatMdx } from "./format.mjs";
+import { FrontmatterParseOptions, FrontmatterParseResult, FrontmatterParseSchemaOptions, parseFrontmatter, parseFrontmatterSync } from "./frontmatter.mjs";
 import { HtmlFormatOptions, formatHtml } from "./html-format.mjs";
 import { BlockId, CompletedBlock, MdxEdit, MdxPreview, MdxStreamChange, MdxStreamCompletion, MdxStreamLimits, MdxStreamOptions, MdxStreamSnapshot, PreviewBlock, StreamBlock, StreamDependencies } from "./stream-types.mjs";
 import { MdxStream } from "./stream.mjs";
@@ -22,4 +23,4 @@ import { TreeCursor } from "./tree.mjs";
 import { HtmlRewriteHandlers, MdxRewriteHandlers, rewriteHtml, rewriteMdx, selectHtml, selectMdx, walkHtml, walkMdx } from "./traversal.mjs";
 import { ProcessInput, ProcessOptions, ProcessResult, Processor, ProcessorOptions } from "./processor.mjs";
 import { MdxBlockEvent, MdxEventDiagnostic, StreamBlockEventsOptions, applyBlockEvent, blockEvent, completionEvent, previewDocument, streamBlockEvents } from "./stream-events.mjs";
-export { type BlockExpressionNode, type BlockId, type BlockQuoteNode, type CodeBlockNode, type CompilationInvariant, type CompilationIssue, type CompileArtifact, CompileError, type CompileLimit, type CompileOptions, type CompileOutputFormat, type CompileResult, type CompileSchemaOptions, type CompiledComponents, type CompletedBlock, ConfigurationError, type ConfigurationIssue, type ContainerDirectiveNode, type DefinitionNode, type DeleteNode, type Diagnostic, type DiagnosticFormatOptions, type DiagnosticReporter, type DiagnosticSeverity, type DirectiveAttribute, type DirectiveLabelNode, type DisplayMathNode, type DocumentIndex, type DocumentNode, type EmphasisNode, type EsmNode, type FlowContent, type FootnoteDefinitionNode, type FootnoteReferenceNode, type FormatOptions, FrontmatterError, type FrontmatterFormat, type FrontmatterIssue, type FrontmatterMode, type FrontmatterNode, type FrontmatterObject, type FrontmatterTemporal, type FrontmatterTemporalType, type FrontmatterValue, type FunctionBodyCompileArtifact, type HardBreakNode, type HeadingDepth, type HeadingNode, type HtmlAttributeList, type HtmlAttributeValue, type HtmlAttributes, type HtmlCodeBlockNode, type HtmlCommentNode, type HtmlDoctypeNode, type HtmlElementNode, type HtmlExpressionNode, type HtmlFootnoteReferenceNode, type HtmlFootnoteSectionNode, type HtmlFormatOptions, type HtmlJsxNode, type HtmlKind, type HtmlMathNode, type HtmlNode, type HtmlNodeForKind, type HtmlPendingConstruct, type HtmlPendingNode, type HtmlRawNode, type HtmlRenderOptions, type HtmlRewriteHandlers, type HtmlRootNode, type HtmlSemanticNode, HtmlStreamRenderer, type HtmlTextNode, type HtmlUnresolvedReferenceNode, type ImageNode, type ImageReferenceNode, type InlineCodeNode, type InlineExpressionNode, type InlineMathNode, InputError, type InputIssue, type JsxAttribute, type JsxAttributeLike, type JsxAttributeValue, type JsxAttributeValueExpression, type JsxFlowElementNode, type JsxSpreadAttribute, type JsxTextElementNode, type LeafDirectiveNode, LimitError, type LinkNode, type LinkReferenceNode, type ListItemNode, type ListNode, type MathFormat, type MathMode, type MathRenderStyle, type MdxBlockEvent, type MdxEdit, MdxError, type MdxEventDiagnostic, type MdxKind, type MdxNode, type MdxNodeForKind, type MdxPreview, type MdxRewriteHandlers, MdxStream, type MdxStreamChange, type MdxStreamCompletion, type MdxStreamLimits, type MdxStreamOptions, type MdxStreamSnapshot, type MdxTransportValue, type ParagraphNode, ParseError, type ParseOptions, type ParseResult, type ParserLimit, type ParserLimits, type PhrasingContent, type PreviewBlock, type ProcessInput, type ProcessOptions, type ProcessResult, Processor, type ProcessorOptions, type ProgramCompileArtifact, type RawHtmlBlockNode, type RawHtmlInlineNode, type ReferenceKind, type RelatedInformation, SourceBuffer, SourceFile, type SourceFileInput, type SourceLocation, type SourceMap, type SourceRange, type SourceSpan, type StreamBlock, type StreamBlockEventsOptions, type StreamDependencies, type StrongNode, type SyntaxOptions, type TableAlignment, type TableCellNode, type TableNode, type TableRowNode, type TextDirectiveNode, type TextNode, type ThematicBreakNode, TransformError, type TransformIssue, type TransformTarget, TreeCursor, applyBlockEvent, blockEvent, compile, completionEvent, defaultParserLimits, documentFrontmatter, formatDiagnostic, formatHtml, formatMdx, hasErrorDiagnostics, htmlChildren, htmlClassNames, htmlFallback, htmlText, indexDocument, isFlowContent, isHtmlAttributeList, isPhrasingContent, lowerHtml, mdxChildren, nodeText, normalizeIdentifier, parse, pendingFallback, previewDocument, rewriteHtml, rewriteMdx, selectHtml, selectMdx, streamBlockEvents, walkHtml, walkMdx };
+export { type BlockExpressionNode, type BlockId, type BlockQuoteNode, type CodeBlockNode, type CompilationInvariant, type CompilationIssue, type CompileArtifact, CompileError, type CompileLimit, type CompileOptions, type CompileOutputFormat, type CompileResult, type CompileSchemaOptions, type CompiledComponents, type CompletedBlock, ConfigurationError, type ConfigurationIssue, type ContainerDirectiveNode, type DefinitionNode, type DeleteNode, type Diagnostic, type DiagnosticFormatOptions, type DiagnosticReporter, type DiagnosticSeverity, type DirectiveAttribute, type DirectiveLabelNode, type DisplayMathNode, type DocumentIndex, type DocumentNode, type EmphasisNode, type EsmNode, type FlowContent, type FootnoteDefinitionNode, type FootnoteReferenceNode, type FormatOptions, FrontmatterError, type FrontmatterFormat, type FrontmatterIssue, type FrontmatterMode, type FrontmatterNode, type FrontmatterObject, FrontmatterParseOptions, FrontmatterParseResult, FrontmatterParseSchemaOptions, type FrontmatterTemporal, type FrontmatterTemporalType, type FrontmatterValue, type FunctionBodyCompileArtifact, type HardBreakNode, type HeadingDepth, type HeadingNode, type HtmlAttributeList, type HtmlAttributeValue, type HtmlAttributes, type HtmlCodeBlockNode, type HtmlCommentNode, type HtmlDoctypeNode, type HtmlElementNode, type HtmlExpressionNode, type HtmlFootnoteReferenceNode, type HtmlFootnoteSectionNode, type HtmlFormatOptions, type HtmlJsxNode, type HtmlKind, type HtmlMathNode, type HtmlNode, type HtmlNodeForKind, type HtmlPendingConstruct, type HtmlPendingNode, type HtmlRawNode, type HtmlRenderOptions, type HtmlRewriteHandlers, type HtmlRootNode, type HtmlSemanticNode, HtmlStreamRenderer, type HtmlTextNode, type HtmlUnresolvedReferenceNode, type ImageNode, type ImageReferenceNode, type InlineCodeNode, type InlineExpressionNode, type InlineMathNode, InputError, type InputIssue, type JsxAttribute, type JsxAttributeLike, type JsxAttributeValue, type JsxAttributeValueExpression, type JsxFlowElementNode, type JsxSpreadAttribute, type JsxTextElementNode, type LeafDirectiveNode, LimitError, type LinkNode, type LinkReferenceNode, type ListItemNode, type ListNode, type MathFormat, type MathMode, type MathRenderStyle, type MdxBlockEvent, type MdxEdit, MdxError, type MdxEventDiagnostic, type MdxKind, type MdxNode, type MdxNodeForKind, type MdxPreview, type MdxRewriteHandlers, MdxStream, type MdxStreamChange, type MdxStreamCompletion, type MdxStreamLimits, type MdxStreamOptions, type MdxStreamSnapshot, type MdxTransportValue, type ParagraphNode, ParseError, type ParseOptions, type ParseResult, type ParserLimit, type ParserLimits, type PhrasingContent, type PreviewBlock, type ProcessInput, type ProcessOptions, type ProcessResult, Processor, type ProcessorOptions, type ProgramCompileArtifact, type RawHtmlBlockNode, type RawHtmlInlineNode, type ReferenceKind, type RelatedInformation, SourceBuffer, SourceFile, type SourceFileInput, type SourceLocation, type SourceMap, type SourceRange, type SourceSpan, type StreamBlock, type StreamBlockEventsOptions, type StreamDependencies, type StrongNode, type SyntaxOptions, type TableAlignment, type TableCellNode, type TableNode, type TableRowNode, type TextDirectiveNode, type TextNode, type ThematicBreakNode, TransformError, type TransformIssue, type TransformTarget, TreeCursor, applyBlockEvent, blockEvent, compile, completionEvent, defaultParserLimits, documentFrontmatter, formatDiagnostic, formatHtml, formatMdx, hasErrorDiagnostics, htmlChildren, htmlClassNames, htmlFallback, htmlText, indexDocument, isFlowContent, isHtmlAttributeList, isPhrasingContent, lowerHtml, mdxChildren, nodeText, normalizeIdentifier, parse, parseFrontmatter, parseFrontmatterSync, pendingFallback, previewDocument, rewriteHtml, rewriteMdx, selectHtml, selectMdx, streamBlockEvents, walkHtml, walkMdx };

package/dist/mod.mjs

@@ -7,8 +7,9 @@ import { formatMdx } from "./format.mjs";
 import { SourceBuffer, SourceFile } from "./source.mjs";
 import { lowerHtml } from "./html-lower.mjs";
 import { compile } from "./compiler.mjs";
-import { formatHtml } from "./html-format.mjs";
 import { defaultParserLimits } from "./parser/config.mjs";
+import { parseFrontmatter, parseFrontmatterSync } from "./frontmatter.mjs";
+import { formatHtml } from "./html-format.mjs";
 import { TreeCursor } from "./tree.mjs";
 import { rewriteHtml, rewriteMdx, selectHtml, selectMdx, walkHtml, walkMdx } from "./traversal.mjs";
 import { MdxStream } from "./stream.mjs";
@@ -16,4 +17,4 @@ import { applyBlockEvent, blockEvent, completionEvent, previewDocument, streamBl
 import { HtmlStreamRenderer } from "./html-stream.mjs";
 import { parse } from "./parser.mjs";
 import { Processor } from "./processor.mjs";
-export { CompileError, ConfigurationError, FrontmatterError, HtmlStreamRenderer, InputError, LimitError, MdxError, MdxStream, ParseError, Processor, SourceBuffer, SourceFile, TransformError, TreeCursor, applyBlockEvent, blockEvent, compile, completionEvent, defaultParserLimits, documentFrontmatter, formatDiagnostic, formatHtml, formatMdx, hasErrorDiagnostics, htmlChildren, htmlClassNames, htmlFallback, htmlText, indexDocument, isFlowContent, isHtmlAttributeList, isPhrasingContent, lowerHtml, mdxChildren, nodeText, normalizeIdentifier, parse, pendingFallback, previewDocument, rewriteHtml, rewriteMdx, selectHtml, selectMdx, streamBlockEvents, walkHtml, walkMdx };
+export { CompileError, ConfigurationError, FrontmatterError, HtmlStreamRenderer, InputError, LimitError, MdxError, MdxStream, ParseError, Processor, SourceBuffer, SourceFile, TransformError, TreeCursor, applyBlockEvent, blockEvent, compile, completionEvent, defaultParserLimits, documentFrontmatter, formatDiagnostic, formatHtml, formatMdx, hasErrorDiagnostics, htmlChildren, htmlClassNames, htmlFallback, htmlText, indexDocument, isFlowContent, isHtmlAttributeList, isPhrasingContent, lowerHtml, mdxChildren, nodeText, normalizeIdentifier, parse, parseFrontmatter, parseFrontmatterSync, pendingFallback, previewDocument, rewriteHtml, rewriteMdx, selectHtml, selectMdx, streamBlockEvents, walkHtml, walkMdx };

package/dist/parser/materialize.mjs

@@ -2,7 +2,7 @@ import { DiagnosticBag, createDiagnostic } from "../diagnostics.mjs";
 import { normalizeIdentifier } from "../identifier.mjs";
 import { nodeText } from "../model.mjs";
 import { sourceText } from "../source.mjs";
-import { decodeFrontmatter } from "../frontmatter.mjs";
+import { decodeFrontmatter } from "../frontmatter-decode.mjs";
 import { parseFlowRange } from "./block-parser.mjs";
 import { InlineInput } from "./inline-input.mjs";
 import { parseInline } from "./inline-parser.mjs";