@temelj/mdx 0.14.0 → 0.16.0

package/dist/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","names":["exhaustive"],"sources":["../src/format.ts"],"sourcesContent":["import type {\n  BlockQuoteNode,\n  CodeBlockNode,\n  DefinitionNode,\n  FootnoteDefinitionNode,\n  FootnoteReferenceNode,\n  HeadingNode,\n  ImageNode,\n  ImageReferenceNode,\n  LinkNode,\n  LinkReferenceNode,\n  ListItemNode,\n  ListNode,\n  MdxNode,\n  ParagraphNode,\n} from \"./model.ts\";\n\nimport { encodeNumericCharacterReference } from \"./character-reference.ts\";\nimport {\n  indentLines,\n  longestRun,\n  rootInfo,\n  type FormatContext,\n  type FormatInfo,\n  type FormatOptions,\n} from \"./format-context.ts\";\nimport {\n  formatContainerDirective,\n  formatDirective,\n  formatDirectiveLabel,\n  containsDirective,\n} from \"./format-directive.ts\";\nimport { formatJsxFlowElement, formatJsxTextElement, indentExpression } from \"./format-jsx.ts\";\nimport { formatDisplayMath, formatInlineMath, mathFormats } from \"./format-math.ts\";\nimport {\n  UNSAFE_PATTERNS,\n  compileUnsafePattern,\n  safeSource,\n  type FormatConstruct,\n  type FormatSafeInfo,\n  type FormatSafetyState,\n  type FormatUnsafePattern,\n} from \"./format-safe.ts\";\nimport { formatTable, formatTableCell, formatTableRow } from \"./format-table.ts\";\nimport { FormatTracker } from \"./format-track.ts\";\nimport { normalizeIdentifier } from \"./identifier.ts\";\nimport { mdxChildren } from \"./model.ts\";\nimport {\n  frontmatterFence,\n  resolveSyntaxOptions,\n  type MathFormat,\n  type ResolvedSyntaxOptions,\n} from \"./syntax-options.ts\";\n\n/** Formats a node as canonical MDX for the enabled syntax. */\nexport function formatMdx(node: MdxNode, options: FormatOptions = {}): string {\n  return new Formatter(options, containsDirective(node), mathFormats(node)).format(node, rootInfo);\n}\n\nclass Formatter implements FormatSafetyState, FormatContext {\n  public readonly stack: FormatConstruct[] = [];\n  public readonly unsafe: readonly FormatUnsafePattern[];\n  private readonly compiledPatterns = new Map<FormatUnsafePattern, RegExp>();\n  public readonly options: FormatOptions;\n  public readonly syntax: ResolvedSyntaxOptions;\n  private bulletLastUsed: \"*\" | \"+\" | \"-\" | \".\" | \")\" | undefined;\n\n  public constructor(\n    options: FormatOptions,\n    containsDirectives: boolean,\n    nodeMathFormats: ReadonlySet<MathFormat>,\n  ) {\n    this.options = { ...options };\n    this.syntax = resolveSyntaxOptions(options.syntax);\n    this.unsafe = [\n      ...UNSAFE_PATTERNS,\n      { character: \"{\", inConstruct: \"phrasing\" },\n      { atBreak: true, character: \"{\" },\n      { character: \"<\", inConstruct: \"phrasing\" },\n      { atBreak: true, character: \"<\" },\n      ...(containsDirectives || this.syntax.directives\n        ? ([\n            {\n              before: \"[^:]\",\n              character: \":\",\n              after: \"[A-Za-z]\",\n              inConstruct: \"phrasing\",\n            },\n            { atBreak: true, character: \":\", after: \":\" },\n          ] satisfies FormatUnsafePattern[])\n        : []),\n      ...(nodeMathFormats.has(\"dollar\") || this.syntax.math.includes(\"dollar\")\n        ? ([\n            {\n              character: \"$\",\n              inConstruct: \"phrasing\",\n            },\n            { character: \"$\", inConstruct: \"mathFlowMeta\" },\n            { atBreak: true, character: \"$\", after: \"\\\\$\" },\n          ] satisfies FormatUnsafePattern[])\n        : []),\n      ...this.syntax.frontmatter.map(\n        (format) =>\n          ({\n            atBreak: true,\n            character: frontmatterFence(format).charAt(0),\n            after: escapeRegularExpression(frontmatterFence(format).slice(1)),\n          }) satisfies FormatUnsafePattern,\n      ),\n    ];\n  }\n\n  public compilePattern(pattern: FormatUnsafePattern): RegExp {\n    const cached = this.compiledPatterns.get(pattern);\n\n    if (cached !== undefined) {\n      return cached;\n    }\n\n    const expression = compileUnsafePattern(pattern);\n    this.compiledPatterns.set(pattern, expression);\n\n    return expression;\n  }\n\n  public format(node: MdxNode, info: FormatInfo): string {\n    switch (node.kind) {\n      case \"document\":\n        return this.flow(node.children, info);\n      case \"paragraph\":\n        return this.paragraph(node, info);\n      case \"heading\":\n        return this.heading(node, info);\n      case \"thematicBreak\":\n        return this.thematicBreak();\n      case \"codeBlock\":\n        return this.codeBlock(node, info);\n      case \"blockquote\":\n        return this.blockQuote(node, info);\n      case \"list\":\n        return this.list(node, info);\n      case \"listItem\":\n        return this.flow(node.children, info, node.spread);\n      case \"table\":\n        return formatTable(this, node, info);\n      case \"tableRow\":\n        return formatTableRow(this, node, info);\n      case \"tableCell\":\n        return formatTableCell(this, node, info);\n      case \"definition\":\n        return this.definition(node, info);\n      case \"footnoteDefinition\":\n        return this.footnoteDefinition(node, info);\n      case \"frontmatter\":\n        return `${frontmatterFence(node.format)}${node.value.length === 0 ? \"\" : `\\n${node.value}`}\\n${frontmatterFence(node.format)}`;\n      case \"directiveLabel\":\n        return formatDirectiveLabel(this, node, info);\n      case \"textDirective\":\n        return formatDirective(this, node, info, \":\");\n      case \"leafDirective\":\n        return formatDirective(this, node, info, \"::\");\n      case \"containerDirective\":\n        return formatContainerDirective(this, node, info);\n      case \"displayMath\":\n        return formatDisplayMath(this, node, info);\n      case \"rawHtmlBlock\":\n      case \"rawHtmlInline\":\n        return node.value;\n      case \"text\":\n        return this.safe(node.value, info);\n      case \"emphasis\":\n        return this.attention(\n          node.children,\n          info,\n          this.attentionMarker(this.options.emphasis ?? \"*\", false),\n          false,\n        );\n      case \"strong\":\n        return this.attention(\n          node.children,\n          info,\n          this.attentionMarker(this.options.strong ?? \"*\", true),\n          true,\n        );\n      case \"delete\":\n        return this.strikethrough(node.children, info);\n      case \"inlineCode\":\n        return this.stack.includes(\"tableCell\")\n          ? formatInlineCode(node.value).replaceAll(\"|\", \"\\\\|\")\n          : formatInlineCode(node.value);\n      case \"inlineMath\":\n        return formatInlineMath(this, node);\n      case \"hardBreak\":\n        return \"\\\\\\n\";\n      case \"link\":\n        return this.link(node, info);\n      case \"image\":\n        return this.image(node, info);\n      case \"linkReference\":\n        return this.linkReference(node, info);\n      case \"imageReference\":\n        return this.imageReference(node, info);\n      case \"footnoteReference\":\n        return this.footnoteReference(node);\n      case \"inlineExpression\":\n      case \"blockExpression\":\n        return `{${indentExpression(node.code)}}`;\n      case \"esm\":\n        return node.code;\n      case \"jsxTextElement\":\n        return formatJsxTextElement(this, node, info);\n      case \"jsxFlowElement\":\n        return formatJsxFlowElement(this, node, info);\n      default: {\n        const exhaustive: never = node;\n\n        return exhaustive;\n      }\n    }\n  }\n\n  public flow(nodes: readonly MdxNode[], info: FormatInfo, spread?: boolean): string {\n    const tracker = new FormatTracker(info);\n    const output: string[] = [];\n\n    for (let index = 0; index < nodes.length; index++) {\n      const node = nodes[index];\n      output.push(\n        tracker.move(this.format(node, { after: \"\\n\", before: \"\\n\", ...tracker.current() })),\n      );\n      const next = nodes[index + 1];\n\n      if (next !== undefined) {\n        output.push(tracker.move(this.join(node, next, spread)));\n      }\n\n      if (node.kind !== \"list\") {\n        this.bulletLastUsed = undefined;\n      }\n    }\n\n    return output.join(\"\");\n  }\n\n  private join(left: MdxNode, right: MdxNode, spread?: boolean): string {\n    if (\n      this.options.tightDefinitions === true &&\n      left.kind === \"definition\" &&\n      right.kind === \"definition\"\n    ) {\n      return \"\\n\";\n    }\n\n    if (spread !== undefined) {\n      return spread ? \"\\n\\n\" : \"\\n\";\n    }\n\n    return \"\\n\\n\";\n  }\n\n  private paragraph(node: ParagraphNode, info: FormatInfo): string {\n    const exit = this.enter(\"paragraph\");\n    const exitPhrasing = this.enter(\"phrasing\");\n    const value = this.phrasing(node.children, info);\n    exitPhrasing();\n    exit();\n\n    return value;\n  }\n\n  public phrasing(nodes: readonly MdxNode[], info: FormatInfo): string {\n    let tracker = new FormatTracker(info);\n    const output: string[] = [];\n    let before = info.before;\n\n    for (let index = 0; index < nodes.length; index++) {\n      const node = nodes[index];\n      let nextIndex = index + 1;\n      let text = node.kind === \"text\" ? node.value : undefined;\n      let nextText = nodes.at(nextIndex);\n\n      while (text !== undefined && nextText?.kind === \"text\") {\n        text += nextText.value;\n        nextIndex++;\n        nextText = nodes.at(nextIndex);\n      }\n\n      const next = nodes[nextIndex];\n      const after = next === undefined ? info.after : peek(next, this.options);\n\n      if (\n        output.length > 0 &&\n        (before === \"\\r\" || before === \"\\n\") &&\n        node.kind === \"rawHtmlInline\"\n      ) {\n        output[output.length - 1] = output[output.length - 1].replace(/(?:\\r\\n?|\\n)$/u, (ending) =>\n          encodeLineEnding(ending),\n        );\n        before = \";\";\n        tracker = new FormatTracker(info);\n        tracker.move(output.join(\"\"));\n      }\n\n      let value =\n        text === undefined\n          ? this.format(node, { after, before, ...tracker.current() })\n          : encodeBlankLineEndings(\n              this.safe(text, {\n                after,\n                before,\n                ...tracker.current(),\n              }),\n            );\n\n      if (text !== undefined && after === \"[\" && value.endsWith(\"!\") && !value.endsWith(\"\\\\!\")) {\n        value = `${value.slice(0, -1)}\\\\!`;\n      }\n\n      tracker.move(value);\n      output.push(value);\n      before = value.slice(-1);\n      index = nextIndex - 1;\n    }\n\n    return output.join(\"\");\n  }\n\n  private heading(node: HeadingNode, info: FormatInfo): string {\n    if (node.depth < 3 && node.children.some(containsLineEnding)) {\n      const exit = this.enter(\"headingSetext\");\n      const exitPhrasing = this.enter(\"phrasing\");\n      const content = this.phrasing(node.children, { ...info, after: \"\\n\", before: \"\\n\" });\n      exitPhrasing();\n      exit();\n      const lastLineStart = Math.max(content.lastIndexOf(\"\\r\"), content.lastIndexOf(\"\\n\")) + 1;\n\n      return `${content}\\n${(node.depth === 1 ? \"=\" : \"-\").repeat(\n        Math.max(1, content.length - lastLineStart),\n      )}`;\n    }\n\n    const sequence = \"#\".repeat(node.depth);\n    const exit = this.enter(\"headingAtx\");\n    const exitPhrasing = this.enter(\"phrasing\");\n    const tracker = new FormatTracker(info);\n    tracker.move(`${sequence} `);\n\n    let content = this.phrasing(node.children, {\n      after: \"\\n\",\n      before: \"# \",\n      ...tracker.current(),\n    });\n\n    if (/^[\\t ]/u.test(content)) {\n      content = encodeNumericCharacterReference(content.codePointAt(0) ?? 32) + content.slice(1);\n    }\n\n    if (content.endsWith(\"#\")) {\n      content = `${content.slice(0, -1)}${encodeNumericCharacterReference(35)}`;\n    }\n\n    exitPhrasing();\n    exit();\n\n    if (content.length === 0) {\n      return sequence;\n    }\n\n    return `${sequence} ${content}${this.options.closeAtx === true ? ` ${sequence}` : \"\"}`;\n  }\n\n  private thematicBreak(): string {\n    const marker = this.options.rule ?? \"-\";\n    const repetition = Math.max(3, this.options.ruleRepetition ?? 3);\n    const value = `${marker}${this.options.ruleSpaces === true ? \" \" : \"\"}`.repeat(repetition);\n    const rule = this.options.ruleSpaces === true ? value.slice(0, -1) : value;\n    const frontmatterFences = new Set<string>(this.syntax.frontmatter.map(frontmatterFence));\n\n    if (!frontmatterFences.has(rule)) {\n      return rule;\n    }\n\n    let separator = \" \";\n    let safeRule = Array.from({ length: repetition }, () => marker).join(separator);\n\n    while (frontmatterFences.has(safeRule)) {\n      separator += \" \";\n      safeRule = Array.from({ length: repetition }, () => marker).join(separator);\n    }\n\n    return safeRule;\n  }\n\n  private codeBlock(node: CodeBlockNode, info: FormatInfo): string {\n    const marker = this.options.fence ?? \"`\";\n    const suffix = marker === \"`\" ? \"GraveAccent\" : \"Tilde\";\n    const sequence = marker.repeat(Math.max(3, longestRun(node.value, marker) + 1));\n    const tracker = new FormatTracker(info);\n    let value = tracker.move(sequence);\n\n    if (node.language !== undefined && node.language.length > 0) {\n      const exitLanguage = this.enter(`codeFencedLang${suffix}`);\n      value += tracker.move(this.safe(node.language, { after: \" \", before: value, encode: [\"`\"] }));\n      exitLanguage();\n    }\n\n    if (node.meta !== undefined && node.meta.length > 0) {\n      const exitMeta = this.enter(`codeFencedMeta${suffix}`);\n      value += tracker.move(\n        ` ${this.safe(node.meta, { after: \"\\n\", before: value, encode: [\"`\"] })}`,\n      );\n      exitMeta();\n    }\n\n    value += tracker.move(\"\\n\");\n\n    if (node.value.length > 0) {\n      value += tracker.move(`${node.value}\\n`);\n    }\n\n    return value + sequence;\n  }\n\n  private blockQuote(node: BlockQuoteNode, info: FormatInfo): string {\n    const exit = this.enter(\"blockquote\");\n    const tracker = new FormatTracker(info);\n    tracker.move(\"> \");\n    tracker.shift(2);\n\n    const value = indentLines(\n      this.flow(node.children, { after: \"\\n\", before: \"\\n\", ...tracker.current() }),\n      (line, blank) => `>${blank ? \"\" : \" \"}${line}`,\n    );\n\n    exit();\n\n    return value;\n  }\n\n  private list(node: ListNode, info: FormatInfo): string {\n    const exit = this.enter(\"list\");\n\n    let marker: \"*\" | \"+\" | \"-\" | \".\" | \")\" = node.ordered\n      ? (this.options.bulletOrdered ?? \".\")\n      : (this.options.bullet ?? \"-\");\n\n    if (\n      this.bulletLastUsed === marker ||\n      (!node.ordered &&\n        marker === (this.options.rule ?? \"-\") &&\n        node.children.some((item) => item.children[0]?.kind === \"thematicBreak\"))\n    ) {\n      marker = alternateListMarker(marker);\n    }\n\n    const values = node.children.map((item, index) =>\n      this.listItem(item, node, index, marker, info),\n    );\n\n    this.bulletLastUsed = marker;\n    exit();\n\n    return values.join(node.spread ? \"\\n\\n\" : \"\\n\");\n  }\n\n  private listItem(\n    item: ListItemNode,\n    parent: ListNode,\n    index: number,\n    listMarker: \"*\" | \"+\" | \"-\" | \".\" | \")\",\n    info: FormatInfo,\n  ): string {\n    const marker = parent.ordered\n      ? `${parent.start + (this.options.incrementListMarker === false ? 0 : index)}${listMarker}`\n      : listMarker;\n\n    let size = marker.length + 1;\n    const indentation = this.options.listItemIndent ?? \"one\";\n\n    if (indentation === \"tab\" || (indentation === \"mixed\" && (parent.spread || item.spread))) {\n      size = Math.ceil(size / 4) * 4;\n    }\n\n    const prefix = `${marker}${\" \".repeat(size - marker.length)}`;\n    const tracker = new FormatTracker(info);\n    tracker.move(prefix);\n    tracker.shift(size);\n    const exit = this.enter(\"listItem\");\n\n    let body = this.flow(\n      item.children,\n      { after: \"\\n\", before: \"\\n\", ...tracker.current() },\n      parent.spread || item.spread,\n    );\n\n    if (item.checked !== undefined && item.children[0]?.kind === \"paragraph\") {\n      body = `[${item.checked ? \"x\" : \" \"}] ${body}`;\n    }\n\n    const value = indentLines(body, (line, blank, lineIndex) =>\n      lineIndex === 0\n        ? `${blank ? marker : prefix}${line}`\n        : `${blank ? \"\" : \" \".repeat(size)}${line}`,\n    );\n\n    exit();\n\n    return value;\n  }\n\n  private definition(node: DefinitionNode, info: FormatInfo): string {\n    const exit = this.enter(\"definition\");\n    const tracker = new FormatTracker(info);\n    const exitLabel = this.enter(\"label\");\n    let value = tracker.move(\"[\");\n    value += tracker.move(formatAssociationIdentifier(node.identifier));\n    value += tracker.move(\"]: \");\n    exitLabel();\n    value += tracker.move(this.destination(node.url, value, node.title === undefined ? \"\\n\" : \" \"));\n\n    if (node.title !== undefined) {\n      value += tracker.move(this.title(node.title, value));\n    }\n\n    exit();\n\n    return value;\n  }\n\n  private footnoteDefinition(node: FootnoteDefinitionNode, info: FormatInfo): string {\n    const exit = this.enter(\"footnoteDefinition\");\n    const tracker = new FormatTracker(info);\n    const exitLabel = this.enter(\"label\");\n    let value = tracker.move(\"[^\");\n    value += tracker.move(this.safe(node.label, { before: value, after: \"]\" }));\n    value += tracker.move(\"]:\");\n    exitLabel();\n\n    if (node.children.length > 0) {\n      tracker.shift(4);\n\n      const content = this.flow(node.children, {\n        after: \"\\n\",\n        before: \"\\n\",\n        ...tracker.current(),\n      });\n\n      const blankFirst = this.options.footnoteFirstLineBlank === true;\n      value +=\n        (blankFirst ? \"\\n\" : \" \") +\n        indentLines(content, (line, blank, lineIndex) =>\n          !blankFirst && lineIndex === 0 ? line : `${blank ? \"\" : \"    \"}${line}`,\n        );\n    }\n\n    exit();\n\n    return value;\n  }\n\n  private footnoteReference(node: FootnoteReferenceNode): string {\n    const exit = this.enter(\"footnoteReference\");\n    const exitReference = this.enter(\"reference\");\n    const value = `[^${this.safe(node.label, { before: \"[^\", after: \"]\" })}]`;\n    exitReference();\n    exit();\n\n    return value;\n  }\n\n  private attention(\n    children: readonly MdxNode[],\n    info: FormatInfo,\n    marker: \"*\" | \"_\",\n    strong: boolean,\n  ): string {\n    const sequence = strong ? marker + marker : marker;\n    const exit = this.enter(strong ? \"strong\" : \"emphasis\");\n    const tracker = new FormatTracker(info);\n    const before = tracker.move(sequence);\n\n    const content = tracker.move(\n      this.phrasing(children, { after: marker, before, ...tracker.current() }),\n    );\n\n    exit();\n\n    return before + content + sequence;\n  }\n\n  private attentionMarker(marker: \"*\" | \"_\", strong: boolean): \"*\" | \"_\" {\n    return this.stack.includes(strong ? \"strong\" : \"emphasis\")\n      ? marker === \"*\"\n        ? \"_\"\n        : \"*\"\n      : marker;\n  }\n\n  private strikethrough(children: readonly MdxNode[], info: FormatInfo): string {\n    const exit = this.enter(\"strikethrough\");\n    const tracker = new FormatTracker(info);\n    const before = tracker.move(\"~~\");\n\n    const content = tracker.move(\n      this.phrasing(children, { after: \"~\", before, ...tracker.current() }),\n    );\n\n    exit();\n\n    return before + content + \"~~\";\n  }\n\n  private link(node: LinkNode, info: FormatInfo): string {\n    const exit = this.enter(\"link\");\n    const tracker = new FormatTracker(info);\n    const exitLabel = this.enter(\"label\");\n    let value = tracker.move(\"[\");\n    value += tracker.move(\n      this.phrasing(node.children, { after: \"]\", before: value, ...tracker.current() }),\n    );\n    value += tracker.move(\"](\");\n    exitLabel();\n    value += tracker.move(this.destination(node.url, value, node.title === undefined ? \")\" : \" \"));\n\n    if (node.title !== undefined) {\n      value += tracker.move(this.title(node.title, value));\n    }\n\n    exit();\n\n    return value + \")\";\n  }\n\n  private image(node: ImageNode, info: FormatInfo): string {\n    const exit = this.enter(\"image\");\n    const tracker = new FormatTracker(info);\n    const exitLabel = this.enter(\"label\");\n    let value = tracker.move(\"![\");\n    value += tracker.move(this.safe(node.alt, { before: value, after: \"]\" }));\n    value += tracker.move(\"](\");\n    exitLabel();\n    value += tracker.move(this.destination(node.url, value, node.title === undefined ? \")\" : \" \"));\n\n    if (node.title !== undefined) {\n      value += tracker.move(this.title(node.title, value));\n    }\n\n    exit();\n\n    return value + \")\";\n  }\n\n  private linkReference(node: LinkReferenceNode, info: FormatInfo): string {\n    const exit = this.enter(\"linkReference\");\n    const exitLabel = this.enter(\"label\");\n    const label = this.phrasing(node.children, { ...info, before: \"[\", after: \"]\" });\n    exitLabel();\n    const value = `[${label}]${this.referenceSuffix(node.referenceKind, node.identifier, label)}`;\n    exit();\n\n    return value;\n  }\n\n  private imageReference(node: ImageReferenceNode, _info: FormatInfo): string {\n    const exit = this.enter(\"imageReference\");\n    const exitLabel = this.enter(\"label\");\n    const alt = this.safe(node.alt, { before: \"![\", after: \"]\" });\n    exitLabel();\n    const value = `![${alt}]${this.referenceSuffix(node.referenceKind, node.identifier, alt)}`;\n    exit();\n\n    return value;\n  }\n\n  private referenceSuffix(\n    kind: LinkReferenceNode[\"referenceKind\"],\n    identifier: string,\n    label: string,\n  ): string {\n    const reference = this.referenceIdentifier(identifier);\n\n    if (label.length > 0 && normalizeIdentifier(label) === normalizeIdentifier(reference)) {\n      if (kind === \"shortcut\") {\n        return \"\";\n      }\n\n      if (kind === \"collapsed\") {\n        return \"[]\";\n      }\n    }\n\n    return `[${reference}]`;\n  }\n\n  private referenceIdentifier(identifier: string): string {\n    return formatAssociationIdentifier(identifier);\n  }\n\n  private destination(value: string, before: string, after: string): string {\n    if (value.length === 0 || /[\\0- \\u007F]/u.test(value)) {\n      const exit = this.enter(\"destinationLiteral\");\n      const result = `<${this.safe(value, { before: `${before}<`, after: \">\" })}>`;\n      exit();\n\n      return result;\n    }\n\n    const exit = this.enter(\"destinationRaw\");\n    const result = this.safe(value, { before, after });\n    exit();\n\n    return result;\n  }\n\n  private title(value: string, before: string): string {\n    const quote = this.options.quote ?? '\"';\n    const exit = this.enter(quote === '\"' ? \"titleQuote\" : \"titleApostrophe\");\n    const result = ` ${quote}${this.safe(value, { before: `${before} ${quote}`, after: quote })}${quote}`;\n    exit();\n\n    return result;\n  }\n\n  public safe(value: string, info: FormatSafeInfo): string {\n    return safeSource(this, value, info);\n  }\n\n  public enter(construct: FormatConstruct): () => void {\n    this.stack.push(construct);\n\n    return (): void => {\n      this.stack.pop();\n    };\n  }\n}\n\nfunction peek(node: MdxNode, options: FormatOptions): string {\n  switch (node.kind) {\n    case \"textDirective\":\n      return \":\";\n    case \"inlineMath\":\n      return node.format === \"dollar\" ? \"$\" : \"\\\\\";\n    case \"image\":\n    case \"imageReference\":\n      return \"!\";\n    case \"footnoteReference\":\n    case \"link\":\n    case \"linkReference\":\n      return \"[\";\n    case \"emphasis\":\n      return options.emphasis ?? \"*\";\n    case \"strong\":\n      return options.strong ?? \"*\";\n    case \"delete\":\n      return \"~\";\n    case \"inlineCode\":\n      return \"`\";\n    case \"rawHtmlInline\":\n    case \"jsxTextElement\":\n      return \"<\";\n    case \"hardBreak\":\n      return \"\\\\\";\n    case \"inlineExpression\":\n      return \"{\";\n    case \"text\":\n      return node.value.charAt(0);\n    default:\n      return \"\";\n  }\n}\n\nfunction formatInlineCode(input: string): string {\n  const value = input.replace(/\\r\\n?|\\n/gu, \" \");\n  let sequence = \"`\";\n\n  while (new RegExp(`(^|[^\\`])${sequence}([^\\`]|$)`, \"u\").test(value)) {\n    sequence += \"`\";\n  }\n\n  const padded =\n    /[^ \\r\\n]/u.test(value) &&\n    ((/^[ \\r\\n]/u.test(value) && /[ \\r\\n]$/u.test(value)) || /^`|`$/u.test(value))\n      ? ` ${value} `\n      : value;\n\n  return `${sequence}${padded}${sequence}`;\n}\n\nfunction alternateListMarker(marker: \"*\" | \"+\" | \"-\" | \".\" | \")\"): \"*\" | \"-\" | \".\" | \")\" {\n  if (marker === \".\") {\n    return \")\";\n  }\n\n  if (marker === \")\") {\n    return \".\";\n  }\n\n  return marker === \"*\" ? \"-\" : \"*\";\n}\n\nfunction containsLineEnding(node: MdxNode): boolean {\n  if (node.kind === \"hardBreak\") {\n    return true;\n  }\n\n  if ((node.kind === \"text\" || node.kind === \"rawHtmlInline\") && /\\r\\n?|\\n/u.test(node.value)) {\n    return true;\n  }\n\n  return mdxChildren(node).some(containsLineEnding);\n}\n\nfunction encodeBlankLineEndings(value: string): string {\n  return value.replace(/(?:(?:\\r\\n?|\\n)){2,}/gu, encodeLineEnding);\n}\n\nfunction encodeLineEnding(value: string): string {\n  let result = \"\";\n\n  for (const character of value) {\n    result += encodeNumericCharacterReference(character.codePointAt(0) ?? 0);\n  }\n\n  return result;\n}\n\nfunction formatAssociationIdentifier(value: string): string {\n  return value.replace(/[!-/:-@[-`{-~]/gu, \"\\\\$&\");\n}\n\nfunction escapeRegularExpression(value: string): string {\n  return value.replace(/[|\\\\{}()[\\]^$+*?.]/gu, \"\\\\$&\");\n}\n"],"mappings":"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"}

package/dist/frontmatter-decode.d.mts

@@ -0,0 +1,15 @@
+import { FrontmatterFormat } from "./syntax-options.mjs";
+import { FrontmatterObject } from "./model.mjs";
+import { SourceSpan } from "./source.mjs";
+import { DiagnosticReporter } from "./diagnostics.mjs";
+//#region src/frontmatter-decode.d.ts
+interface DecodeOptions {
+  readonly diagnostics: DiagnosticReporter;
+  readonly format: FrontmatterFormat;
+  readonly source: string;
+  readonly span: SourceSpan;
+}
+export declare function decodeFrontmatter(options: DecodeOptions): FrontmatterObject | undefined;
+//#endregion
+export {};
+//# sourceMappingURL=frontmatter-decode.d.mts.map

package/dist/frontmatter-decode.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-decode.d.mts","names":[],"sources":["../src/frontmatter-decode.ts"],"mappings":";;;;;UAkBU;WACC,aAAa;WACb,QAAQ;WACR;WACA,MAAM;;wBAOD,kBAAkB,SAAS,gBAAgB"}

package/dist/frontmatter-decode.mjs

@@ -0,0 +1,187 @@
+import { isBigInt, isBoolean, isFunction, isNumber, isObject, isPlainObject, isString, isSymbol } from "@temelj/value";
+import { TomlDate, TomlError, parse } from "smol-toml";
+import { parseDocument } from "yaml";
+//#region src/frontmatter-decode.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";
+	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
+	});
+}
+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));
+	return Object.freeze({
+		file: span.file,
+		start: span.start + relativeStart,
+		end: span.start + relativeEnd
+	});
+}
+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 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;
+}
+//#endregion
+export { decodeFrontmatter };
+
+//# sourceMappingURL=frontmatter-decode.mjs.map

package/dist/frontmatter-decode.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-decode.mjs","names":["parseToml"],"sources":["../src/frontmatter-decode.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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"}

package/dist/frontmatter-schema.d.mts

@@ -0,0 +1,8 @@
+import { SourceRange } from "./ranges.mjs";
+import { SourceFile } from "./source.mjs";
+import { SchemaResult } from "@temelj/standard-schema";
+//#region src/frontmatter-schema.d.ts
+/** Converts Standard Schema failures to the shared frontmatter diagnostics. */
+export declare function frontmatterSchemaValue<T>(result: SchemaResult<T>, file: SourceFile, origin: SourceRange | undefined): T;
+//#endregion
+//# sourceMappingURL=frontmatter-schema.d.mts.map

package/dist/frontmatter-schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-schema.d.mts","names":[],"sources":["../src/frontmatter-schema.ts"],"mappings":";;;;;wBAWgB,uBAAuB,GACrC,QAAQ,aAAa,IACrB,MAAM,YACN,QAAQ,0BACP"}

package/dist/frontmatter-schema.mjs

@@ -0,0 +1,28 @@
+import { createDiagnostic } from "./diagnostics.mjs";
+import { FrontmatterError } from "./errors.mjs";
+import { isObject } from "@temelj/value";
+//#region src/frontmatter-schema.ts
+/** Converts Standard Schema failures to the shared frontmatter diagnostics. */
+function frontmatterSchemaValue(result, file, origin) {
+	if (result.issues !== void 0) {
+		const diagnostics = result.issues.map((issue) => createDiagnostic({
+			severity: "error",
+			code: "mdx.frontmatter.schema",
+			message: formatSchemaIssue(issue),
+			span: origin === void 0 ? void 0 : {
+				file,
+				...origin
+			}
+		}));
+		throw FrontmatterError.schemaValidationFailed(file, diagnostics, result.issues);
+	}
+	return result.value;
+}
+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}`;
+}
+//#endregion
+export { frontmatterSchemaValue };
+
+//# sourceMappingURL=frontmatter-schema.mjs.map

package/dist/frontmatter-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-schema.mjs","names":[],"sources":["../src/frontmatter-schema.ts"],"sourcesContent":["import type { SchemaIssue, SchemaResult } from \"@temelj/standard-schema\";\n\nimport { isObject } from \"@temelj/value\";\n\nimport type { SourceRange } from \"./ranges.ts\";\nimport type { SourceFile } from \"./source.ts\";\n\nimport { createDiagnostic } from \"./diagnostics.ts\";\nimport { FrontmatterError } from \"./errors.ts\";\n\n/** Converts Standard Schema failures to the shared frontmatter diagnostics. */\nexport function frontmatterSchemaValue<T>(\n  result: SchemaResult<T>,\n  file: SourceFile,\n  origin: SourceRange | undefined,\n): T {\n  if (result.issues !== undefined) {\n    const diagnostics = result.issues.map((issue) =>\n      createDiagnostic({\n        severity: \"error\",\n        code: \"mdx.frontmatter.schema\",\n        message: formatSchemaIssue(issue),\n        span: origin === undefined ? undefined : { file, ...origin },\n      }),\n    );\n\n    throw FrontmatterError.schemaValidationFailed(file, diagnostics, result.issues);\n  }\n\n  return result.value;\n}\n\nfunction formatSchemaIssue(issue: SchemaIssue): string {\n  const path = issue.path?.map((part) => String(isObject(part) ? part.key : part)).join(\".\");\n\n  return path === undefined || path.length === 0 ? issue.message : `${path}: ${issue.message}`;\n}\n"],"mappings":";;;;;AAWA,SAAgB,uBACd,QACA,MACA,QACG;CACH,IAAI,OAAO,WAAW,KAAA,GAAW;EAC/B,MAAM,cAAc,OAAO,OAAO,KAAK,UACrC,iBAAiB;GACf,UAAU;GACV,MAAM;GACN,SAAS,kBAAkB,KAAK;GAChC,MAAM,WAAW,KAAA,IAAY,KAAA,IAAY;IAAE;IAAM,GAAG;GAAO;EAC7D,CAAC,CACH;EAEA,MAAM,iBAAiB,uBAAuB,MAAM,aAAa,OAAO,MAAM;CAChF;CAEA,OAAO,OAAO;AAChB;AAEA,SAAS,kBAAkB,OAA4B;CACrD,MAAM,OAAO,MAAM,MAAM,KAAK,SAAS,OAAO,SAAS,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;CAEzF,OAAO,SAAS,KAAA,KAAa,KAAK,WAAW,IAAI,MAAM,UAAU,GAAG,KAAK,IAAI,MAAM;AACrF"}

package/dist/frontmatter.d.mts

@@ -0,0 +1,40 @@
+import { FrontmatterFormat, FrontmatterMode } from "./syntax-options.mjs";
+import { FrontmatterObject } from "./model.mjs";
+import { SourceFile } from "./source.mjs";
+import { Diagnostic } from "./diagnostics.mjs";
+import { ParserLimits } from "./parser/config.mjs";
+import { Schema, SchemaOutput } from "@temelj/standard-schema";
+//#region src/frontmatter.d.ts
+export interface FrontmatterParseOptions {
+  /** Formats to recognize. Defaults to both YAML and TOML. */
+  readonly format?: FrontmatterMode;
+  /** Limits the entire input length in UTF-16 code units, without scanning its body. */
+  readonly limits?: Pick<ParserLimits, "maximumSourceLength">;
+}
+export interface FrontmatterParseSchemaOptions<TSchema extends Schema> extends FrontmatterParseOptions {
+  readonly frontmatterSchema: TSchema;
+}
+export interface FrontmatterParseResult<T = FrontmatterObject> {
+  readonly file: SourceFile;
+  readonly frontmatter: T;
+  /** Undefined when no complete, enabled frontmatter block was found. */
+  readonly format: FrontmatterFormat | undefined;
+  readonly diagnostics: readonly Diagnostic[];
+}
+/**
+ * Reads only the opening frontmatter block and optionally validates its metadata.
+ * @throws {ParseError} Invalid YAML or TOML.
+ * @throws {FrontmatterError} Schema validation fails.
+ * @throws {LimitError | ConfigurationError} Invalid or exceeded source-length limit.
+ */
+export declare function parseFrontmatter<TSchema extends Schema>(input: string | SourceFile, options: FrontmatterParseSchemaOptions<TSchema>): Promise<FrontmatterParseResult<SchemaOutput<TSchema>>>;
+export declare function parseFrontmatter(input: string | SourceFile, options?: FrontmatterParseOptions): Promise<FrontmatterParseResult>;
+/**
+ * Reads frontmatter synchronously, including synchronous schema validation.
+ * @throws {StandardSchemaAsyncValidationError} The schema returns a promise.
+ * @throws {ParseError | FrontmatterError | LimitError | ConfigurationError} Parsing fails.
+ */
+export declare function parseFrontmatterSync<TSchema extends Schema>(input: string | SourceFile, options: FrontmatterParseSchemaOptions<TSchema>): FrontmatterParseResult<SchemaOutput<TSchema>>;
+export declare function parseFrontmatterSync(input: string | SourceFile, options?: FrontmatterParseOptions): FrontmatterParseResult;
+//#endregion
+//# sourceMappingURL=frontmatter.d.mts.map

package/dist/frontmatter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.mts","names":[],"sources":["../src/frontmatter.ts"],"mappings":";;;;;;;iBAmBiB;;WAEN,SAAS;;WAET,SAAS,KAAK;;iBAGR,8BACf,gBAAgB,gBACR;WACC,mBAAmB;;iBAGb,uBAAuB,IAAI;WACjC,MAAM;WACN,aAAa;;WAEb,QAAQ;WACR,sBAAsB;;;;;;;;wBASjB,iBAAiB,gBAAgB,QAC/C,gBAAgB,YAChB,SAAS,8BAA8B,WACtC,QAAQ,uBAAuB,aAAa;wBAC/B,iBACd,gBAAgB,YAChB,UAAU,0BACT,QAAQ;;;;;;wBAwBK,qBAAqB,gBAAgB,QACnD,gBAAgB,YAChB,SAAS,8BAA8B,WACtC,uBAAuB,aAAa;wBACvB,qBACd,gBAAgB,YAChB,UAAU,0BACT"}

package/dist/frontmatter.mjs

@@ -0,0 +1,109 @@
+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
+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({
+		...result,
+		frontmatter: frontmatterSchemaValue(validated, result.file, origin)
+	});
+}
+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({
+		...result,
+		frontmatter: frontmatterSchemaValue(validated, result.file, origin)
+	});
+}
+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
+	};
+}
+/** 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 { parseFrontmatter, parseFrontmatterSync };
+
+//# sourceMappingURL=frontmatter.mjs.map

package/dist/frontmatter.mjs.map

@@ -0,0 +1 @@
+{"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/heading.d.mts

@@ -0,0 +1,6 @@
+//#region src/heading.d.ts
+export type HeadingDepth = 1 | 2 | 3 | 4 | 5 | 6;
+export declare function isHeadingDepth(value: unknown): value is HeadingDepth;
+export declare function headingDepthForTag(tagName: string): HeadingDepth | undefined;
+//#endregion
+//# sourceMappingURL=heading.d.mts.map

package/dist/heading.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.d.mts","names":[],"sources":["../src/heading.ts"],"mappings":";YAAY;wBAEI,eAAe,iBAAiB,SAAS;wBAIzC,mBAAmB,kBAAkB"}

package/dist/heading.mjs

@@ -0,0 +1,19 @@
+//#region src/heading.ts
+function isHeadingDepth(value) {
+	return value === 1 || value === 2 || value === 3 || value === 4 || value === 5 || value === 6;
+}
+function headingDepthForTag(tagName) {
+	switch (tagName) {
+		case "h1": return 1;
+		case "h2": return 2;
+		case "h3": return 3;
+		case "h4": return 4;
+		case "h5": return 5;
+		case "h6": return 6;
+		default: return;
+	}
+}
+//#endregion
+export { headingDepthForTag, isHeadingDepth };
+
+//# sourceMappingURL=heading.mjs.map

package/dist/heading.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.mjs","names":[],"sources":["../src/heading.ts"],"sourcesContent":["export type HeadingDepth = 1 | 2 | 3 | 4 | 5 | 6;\n\nexport function isHeadingDepth(value: unknown): value is HeadingDepth {\n  return value === 1 || value === 2 || value === 3 || value === 4 || value === 5 || value === 6;\n}\n\nexport function headingDepthForTag(tagName: string): HeadingDepth | undefined {\n  switch (tagName) {\n    case \"h1\":\n      return 1;\n    case \"h2\":\n      return 2;\n    case \"h3\":\n      return 3;\n    case \"h4\":\n      return 4;\n    case \"h5\":\n      return 5;\n    case \"h6\":\n      return 6;\n    default:\n      return undefined;\n  }\n}\n"],"mappings":";AAEA,SAAgB,eAAe,OAAuC;CACpE,OAAO,UAAU,KAAK,UAAU,KAAK,UAAU,KAAK,UAAU,KAAK,UAAU,KAAK,UAAU;AAC9F;AAEA,SAAgB,mBAAmB,SAA2C;CAC5E,QAAQ,SAAR;EACE,KAAK,MACH,OAAO;EACT,KAAK,MACH,OAAO;EACT,KAAK,MACH,OAAO;EACT,KAAK,MACH,OAAO;EACT,KAAK,MACH,OAAO;EACT,KAAK,MACH,OAAO;EACT,SACE;CACJ;AACF"}

package/dist/html-format.d.mts

@@ -0,0 +1,32 @@
+import { HtmlAttributes, HtmlNode } from "./html.mjs";
+//#region src/html-format.d.ts
+export interface HtmlFormatOptions {
+  readonly closeSelfClosing?: boolean;
+  readonly collapseEmptyAttributes?: boolean;
+  readonly preferUnquotedAttributes?: boolean;
+  readonly quote?: '"' | "'";
+  readonly quoteSmart?: boolean;
+  /** Raw HTML is escaped unless it is explicitly trusted. */
+  readonly rawHtml?: "escape" | "trusted";
+  readonly tightSelfClosing?: boolean;
+  readonly voidElements?: readonly string[];
+}
+/** Serializes an HTML tree. JSX renders as its escaped authored fallback. */
+export declare function formatHtml(node: HtmlNode, options?: HtmlFormatOptions): string;
+declare class HtmlFormatter {
+  private readonly options;
+  private readonly voids;
+  constructor(options: HtmlFormatOptions);
+  format(node: HtmlNode): string;
+  element(tagName: string, values: HtmlAttributes, content: string): string;
+  private children;
+  private attribute;
+}
+/** Internal formatter for immutable nodes owned by one stream. */
+export declare class CachedHtmlFormatter extends HtmlFormatter {
+  #private;
+  format(node: HtmlNode): string;
+}
+//#endregion
+export {};
+//# sourceMappingURL=html-format.d.mts.map

package/dist/html-format.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-format.d.mts","names":[],"sources":["../src/html-format.ts"],"mappings":";;iBAQiB;WACN;WACA;WACA;WACA;WACA;;WAEA;WACA;WACA;;;wBAIK,WAAW,MAAM,UAAU,UAAS;cAmC9C;mBACa;mBACA;EAEjB,YAAmB,SAAS;EAQrB,OAAO,MAAM;EAiCb,QAAQ,iBAAiB,QAAQ,gBAAgB;UA8BhD;UAUA;;;qBA0CG,4BAA4B;;EAGvB,OAAO,MAAM"}