vantage-md 0.1.0

package/README.md

@@ -0,0 +1,123 @@
+# vantage-md
+
+Markdown rendering pipeline with GitHub-style line anchors (`#L42`, `#L42-L50`), mermaid diagrams, KaTeX math, and syntax highlighting.
+
+Extracted from [Vantage](https://github.com/mschulkind-oss/vantage), a markdown documentation viewer.
+
+## Install
+
+```bash
+npm install vantage-md
+```
+
+## Usage
+
+### Framework-agnostic: markdown string to HTML
+
+```typescript
+import { renderMarkdown } from "vantage-md";
+
+const { html, frontmatter } = await renderMarkdown("# Hello\n\nSome **bold** text");
+// html: '<h1 data-source-line="1">Hello</h1>\n<p data-source-line="3">Some <strong>bold</strong> text</p>'
+```
+
+Every rendered block element gets a `data-source-line` attribute, enabling GitHub-style line anchors.
+
+### Options
+
+All features are enabled by default. Disable what you don't need:
+
+```typescript
+const { html } = await renderMarkdown(content, {
+  gfm: true,          // GFM tables, strikethrough, task lists
+  math: true,         // KaTeX rendering
+  highlight: true,    // Syntax highlighting
+  sourceLines: true,  // data-source-line attributes
+  sanitize: true,     // XSS sanitization
+  frontmatter: true,  // Parse and strip YAML/TOML frontmatter
+});
+```
+
+### Line anchors
+
+Scroll to and highlight lines in rendered markdown:
+
+```typescript
+import { scrollToLineAnchor } from "vantage-md";
+import "vantage-md/styles";
+
+// Highlight lines 42-50 and scroll to them
+const cleanup = scrollToLineAnchor(container, "#L42-L50");
+
+// Remove highlights
+cleanup?.();
+```
+
+### React component
+
+```tsx
+import { MarkdownViewer } from "vantage-md/react";
+import "vantage-md/styles";
+
+function Docs({ content, path }) {
+  return (
+    <MarkdownViewer
+      content={content}
+      currentPath={path}
+      hash={window.location.hash}
+      onNavigate={(path) => navigate(path)}
+    />
+  );
+}
+```
+
+The React component includes mermaid diagram rendering (lazy-loaded), frontmatter display, and syntax highlighting out of the box.
+
+### Rehype plugin (bring your own pipeline)
+
+```typescript
+import { rehypeSourceLines } from "vantage-md";
+
+const processor = unified()
+  .use(remarkParse)
+  .use(remarkRehype)
+  .use(rehypeSourceLines)  // adds data-source-line to block elements
+  .use(rehypeStringify);
+```
+
+### Svelte / Vue / plain HTML
+
+```svelte
+<script>
+  import { renderMarkdown } from "vantage-md";
+  import "vantage-md/styles";
+
+  let html = "";
+  renderMarkdown(content).then((result) => (html = result.html));
+</script>
+
+{@html html}
+```
+
+## Exports
+
+| Entry point | Description |
+|-------------|-------------|
+| `vantage-md` | `renderMarkdown`, `rehypeSourceLines`, `scrollToLineAnchor`, `parseLineAnchor`, `parseFrontmatter`, `sanitizeSchema` |
+| `vantage-md/react` | `MarkdownViewer`, `useLineAnchor`, `MermaidDiagram`, `FrontmatterDisplay` + all core exports |
+| `vantage-md/styles` | Line-anchor highlight CSS (light + dark mode) |
+
+## Features
+
+- **Line anchors** — `data-source-line` attributes on every block element, with scroll/highlight utilities
+- **GFM** — tables, strikethrough, task lists, autolinks
+- **KaTeX** — `$$...$$` math blocks
+- **Mermaid** — diagram rendering (client-side, lazy-loaded)
+- **Syntax highlighting** — via highlight.js
+- **Frontmatter** — YAML (`---`) and TOML (`+++`) parsing
+- **Sanitization** — XSS-safe with allowlisted KaTeX/MathML elements
+- **Dark mode** — all styles support `.dark` class
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,271 @@
+'use strict';
+
+var unified = require('unified');
+var remarkParse = require('remark-parse');
+var remarkGfm = require('remark-gfm');
+var remarkMath = require('remark-math');
+var remarkRehype = require('remark-rehype');
+var rehypeRaw = require('rehype-raw');
+var rehypeSanitize = require('rehype-sanitize');
+var rehypeHighlight = require('rehype-highlight');
+var rehypeKatex = require('rehype-katex');
+var rehypeSlug = require('rehype-slug');
+var rehypeStringify = require('rehype-stringify');
+var YAML = require('yaml');
+var smolToml = require('smol-toml');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var remarkParse__default = /*#__PURE__*/_interopDefault(remarkParse);
+var remarkGfm__default = /*#__PURE__*/_interopDefault(remarkGfm);
+var remarkMath__default = /*#__PURE__*/_interopDefault(remarkMath);
+var remarkRehype__default = /*#__PURE__*/_interopDefault(remarkRehype);
+var rehypeRaw__default = /*#__PURE__*/_interopDefault(rehypeRaw);
+var rehypeSanitize__default = /*#__PURE__*/_interopDefault(rehypeSanitize);
+var rehypeHighlight__default = /*#__PURE__*/_interopDefault(rehypeHighlight);
+var rehypeKatex__default = /*#__PURE__*/_interopDefault(rehypeKatex);
+var rehypeSlug__default = /*#__PURE__*/_interopDefault(rehypeSlug);
+var rehypeStringify__default = /*#__PURE__*/_interopDefault(rehypeStringify);
+var YAML__default = /*#__PURE__*/_interopDefault(YAML);
+
+// src/renderMarkdown.ts
+
+// src/rehypeSourceLines.ts
+var BLOCK_TAGS = /* @__PURE__ */ new Set([
+  "p",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "li",
+  "blockquote",
+  "pre",
+  "table",
+  "tr",
+  "ul",
+  "ol",
+  "hr",
+  "div"
+]);
+function visit(node) {
+  if ("children" in node) {
+    for (const child of node.children) {
+      if (child.type === "element") {
+        if (BLOCK_TAGS.has(child.tagName) && child.position?.start?.line) {
+          child.properties = child.properties || {};
+          child.properties["dataSourceLine"] = child.position.start.line;
+        }
+        visit(child);
+      }
+    }
+  }
+}
+var rehypeSourceLines = () => {
+  return (tree) => {
+    visit(tree);
+  };
+};
+var rehypeSourceLines_default = rehypeSourceLines;
+var sanitizeSchema = {
+  ...rehypeSanitize.defaultSchema,
+  tagNames: [
+    ...rehypeSanitize.defaultSchema.tagNames || [],
+    // KaTeX MathML elements
+    "math",
+    "semantics",
+    "mrow",
+    "mi",
+    "mo",
+    "mn",
+    "msup",
+    "msub",
+    "mfrac",
+    "mover",
+    "munder",
+    "msqrt",
+    "mroot",
+    "mtable",
+    "mtr",
+    "mtd",
+    "mtext",
+    "mspace",
+    "annotation",
+    // Other
+    "figure",
+    "figcaption",
+    "summary",
+    "details"
+  ],
+  attributes: {
+    ...rehypeSanitize.defaultSchema.attributes,
+    "*": [
+      ...rehypeSanitize.defaultSchema.attributes?.["*"] || [],
+      "className",
+      "style",
+      "dataSourceLine"
+    ],
+    code: [...rehypeSanitize.defaultSchema.attributes?.code || [], "className"],
+    span: [...rehypeSanitize.defaultSchema.attributes?.span || [], "className", "style"],
+    div: [...rehypeSanitize.defaultSchema.attributes?.div || [], "className", "style"],
+    a: [...rehypeSanitize.defaultSchema.attributes?.a || [], "id", "className"],
+    math: ["xmlns"],
+    annotation: ["encoding"],
+    img: [...rehypeSanitize.defaultSchema.attributes?.img || [], "loading"],
+    td: [...rehypeSanitize.defaultSchema.attributes?.td || [], "style"],
+    th: [...rehypeSanitize.defaultSchema.attributes?.th || [], "style"]
+  }
+};
+function parseFrontmatter(content) {
+  if (content.startsWith("+++")) {
+    return parseFrontmatterWithDelimiter(content, "+++", "toml");
+  }
+  if (content.startsWith("---")) {
+    return parseFrontmatterWithDelimiter(content, "---", "yaml");
+  }
+  return { frontmatter: {}, body: content, format: "none" };
+}
+function parseFrontmatterWithDelimiter(content, delimiter, format) {
+  const searchStart = delimiter.length;
+  const endIndex = content.indexOf(`
+${delimiter}`, searchStart);
+  if (endIndex === -1) {
+    return { frontmatter: {}, body: content, format: "none" };
+  }
+  const raw = content.slice(searchStart + 1, endIndex).trim();
+  const bodyStart = endIndex + 1 + delimiter.length;
+  const body = content.slice(bodyStart).replace(/^\n/, "");
+  try {
+    const frontmatter = format === "toml" ? smolToml.parse(raw) : YAML__default.default.parse(raw);
+    return { frontmatter: frontmatter || {}, body, format };
+  } catch {
+    return { frontmatter: {}, body: content, format: "none" };
+  }
+}
+
+// src/renderMarkdown.ts
+async function renderMarkdown(content, options = {}) {
+  const {
+    gfm = true,
+    math = true,
+    highlight = true,
+    sourceLines = true,
+    sanitize = true,
+    frontmatter: parseFm = true
+  } = options;
+  let parsed;
+  if (parseFm) {
+    parsed = parseFrontmatter(content);
+  } else {
+    parsed = { frontmatter: {}, body: content, format: "none" };
+  }
+  const remarkPlugins = [];
+  const rehypePlugins = [];
+  if (gfm) remarkPlugins.push([remarkGfm__default.default, { singleTilde: false }]);
+  if (math) remarkPlugins.push([remarkMath__default.default, { singleDollarTextMath: false }]);
+  rehypePlugins.push([rehypeRaw__default.default]);
+  if (sourceLines) rehypePlugins.push([rehypeSourceLines_default]);
+  if (sanitize) rehypePlugins.push([rehypeSanitize__default.default, sanitizeSchema]);
+  rehypePlugins.push([rehypeSlug__default.default]);
+  if (highlight) rehypePlugins.push([rehypeHighlight__default.default]);
+  if (math) rehypePlugins.push([rehypeKatex__default.default]);
+  let processor = unified.unified().use(remarkParse__default.default);
+  for (const [plugin, ...args] of remarkPlugins) {
+    processor = processor.use(plugin, ...args);
+  }
+  processor = processor.use(remarkRehype__default.default, { allowDangerousHtml: true });
+  for (const [plugin, ...args] of rehypePlugins) {
+    processor = processor.use(plugin, ...args);
+  }
+  processor = processor.use(rehypeStringify__default.default);
+  const result = await processor.process(parsed.body);
+  return {
+    html: String(result),
+    frontmatter: parsed.frontmatter,
+    body: parsed.body
+  };
+}
+
+// src/scrollToLineAnchor.ts
+var HIGHLIGHT_CLASS = "line-anchor-highlight";
+function parseLineAnchor(hash) {
+  if (!hash) return null;
+  const frag = hash.startsWith("#") ? hash.slice(1) : hash;
+  const match = frag.match(/^L(\d+)(?:-L?(\d+))?$/);
+  if (!match) return null;
+  const start = parseInt(match[1], 10);
+  const end = match[2] ? parseInt(match[2], 10) : start;
+  return { start: Math.min(start, end), end: Math.max(start, end) };
+}
+function clearLineAnchorHighlights(container) {
+  container.querySelectorAll(`.${HIGHLIGHT_CLASS}`).forEach((node) => {
+    node.classList.remove(HIGHLIGHT_CLASS);
+  });
+}
+function scrollToLineAnchor(container, hash) {
+  clearLineAnchorHighlights(container);
+  const range = parseLineAnchor(hash);
+  if (!range) return null;
+  const blocks = container.querySelectorAll("[data-source-line]");
+  let firstMatch = null;
+  for (const block of blocks) {
+    const line = parseInt(
+      block.dataset.sourceLine || "0",
+      10
+    );
+    if (line >= range.start && line <= range.end) {
+      block.classList.add(HIGHLIGHT_CLASS);
+      if (!firstMatch) firstMatch = block;
+    }
+  }
+  if (!firstMatch) {
+    let closest = null;
+    let closestLine = 0;
+    for (const block of blocks) {
+      const line = parseInt(
+        block.dataset.sourceLine || "0",
+        10
+      );
+      if (line <= range.start && line > closestLine) {
+        closestLine = line;
+        closest = block;
+      }
+    }
+    if (closest) {
+      closest.classList.add(HIGHLIGHT_CLASS);
+      firstMatch = closest;
+    }
+  }
+  if (firstMatch) {
+    requestAnimationFrame(() => {
+      const scrollParent = findScrollParent(container);
+      if (scrollParent) {
+        const offset = firstMatch.getBoundingClientRect().top - scrollParent.getBoundingClientRect().top + scrollParent.scrollTop;
+        scrollParent.scrollTo({ top: offset - 32, behavior: "smooth" });
+      } else {
+        firstMatch.scrollIntoView({ behavior: "smooth", block: "start" });
+      }
+    });
+  }
+  return () => clearLineAnchorHighlights(container);
+}
+function findScrollParent(el) {
+  let node = el;
+  while (node) {
+    const overflow = getComputedStyle(node).overflowY;
+    if (overflow === "auto" || overflow === "scroll") return node;
+    node = node.parentElement;
+  }
+  return null;
+}
+
+exports.clearLineAnchorHighlights = clearLineAnchorHighlights;
+exports.parseFrontmatter = parseFrontmatter;
+exports.parseLineAnchor = parseLineAnchor;
+exports.rehypeSourceLines = rehypeSourceLines_default;
+exports.renderMarkdown = renderMarkdown;
+exports.sanitizeSchema = sanitizeSchema;
+exports.scrollToLineAnchor = scrollToLineAnchor;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rehypeSourceLines.ts","../src/sanitize.ts","../src/frontmatter.ts","../src/renderMarkdown.ts","../src/scrollToLineAnchor.ts"],"names":["defaultSchema","parseTOML","YAML","remarkGfm","remarkMath","rehypeRaw","rehypeSanitize","rehypeSlug","rehypeHighlight","rehypeKatex","unified","remarkParse","remarkRehype","rehypeStringify"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Rehype plugin that adds `data-source-line` attributes to block-level\n * elements based on their position in the original markdown source.\n *\n * This enables GitHub-style line anchors (#L42, #L42-L50) by giving\n * each rendered block a traceable line number from the source.\n */\n\nimport type { Root, Element } from \"hast\";\nimport type { Plugin } from \"unified\";\n\nconst BLOCK_TAGS = new Set([\n  \"p\",\n  \"h1\",\n  \"h2\",\n  \"h3\",\n  \"h4\",\n  \"h5\",\n  \"h6\",\n  \"li\",\n  \"blockquote\",\n  \"pre\",\n  \"table\",\n  \"tr\",\n  \"ul\",\n  \"ol\",\n  \"hr\",\n  \"div\",\n]);\n\nfunction visit(node: Root | Element) {\n  if (\"children\" in node) {\n    for (const child of node.children) {\n      if (child.type === \"element\") {\n        if (BLOCK_TAGS.has(child.tagName) && child.position?.start?.line) {\n          child.properties = child.properties || {};\n          child.properties[\"dataSourceLine\"] = child.position.start.line;\n        }\n        visit(child);\n      }\n    }\n  }\n}\n\nconst rehypeSourceLines: Plugin<[], Root> = () => {\n  return (tree: Root) => {\n    visit(tree);\n  };\n};\n\nexport default rehypeSourceLines;\n","/**\n * Sanitization schema for the rendering pipeline.\n * Allows GFM, KaTeX MathML, syntax highlighting classes, and\n * data-source-line attributes while blocking XSS vectors.\n */\n\nimport { defaultSchema } from \"rehype-sanitize\";\n\ntype Schema = typeof defaultSchema;\n\nexport const sanitizeSchema: Schema = {\n  ...defaultSchema,\n  tagNames: [\n    ...(defaultSchema.tagNames || []),\n    // KaTeX MathML elements\n    \"math\",\n    \"semantics\",\n    \"mrow\",\n    \"mi\",\n    \"mo\",\n    \"mn\",\n    \"msup\",\n    \"msub\",\n    \"mfrac\",\n    \"mover\",\n    \"munder\",\n    \"msqrt\",\n    \"mroot\",\n    \"mtable\",\n    \"mtr\",\n    \"mtd\",\n    \"mtext\",\n    \"mspace\",\n    \"annotation\",\n    // Other\n    \"figure\",\n    \"figcaption\",\n    \"summary\",\n    \"details\",\n  ],\n  attributes: {\n    ...defaultSchema.attributes,\n    \"*\": [\n      ...(defaultSchema.attributes?.[\"*\"] || []),\n      \"className\",\n      \"style\",\n      \"dataSourceLine\",\n    ],\n    code: [...(defaultSchema.attributes?.code || []), \"className\"],\n    span: [...(defaultSchema.attributes?.span || []), \"className\", \"style\"],\n    div: [...(defaultSchema.attributes?.div || []), \"className\", \"style\"],\n    a: [...(defaultSchema.attributes?.a || []), \"id\", \"className\"],\n    math: [\"xmlns\"],\n    annotation: [\"encoding\"],\n    img: [...(defaultSchema.attributes?.img || []), \"loading\"],\n    td: [...(defaultSchema.attributes?.td || []), \"style\"],\n    th: [...(defaultSchema.attributes?.th || []), \"style\"],\n  },\n};\n","/**\n * Frontmatter parser for YAML (---) and TOML (+++) delimited content.\n * Works in both browser and server environments.\n */\n\nimport YAML from \"yaml\";\nimport { parse as parseTOML } from \"smol-toml\";\n\nexport type FrontmatterFormat = \"yaml\" | \"toml\" | \"none\";\n\nexport interface ParsedFrontmatter {\n  frontmatter: Record<string, unknown>;\n  body: string;\n  format: FrontmatterFormat;\n}\n\n/**\n * Parse frontmatter from markdown content.\n * Supports YAML (delimited by ---) and TOML (delimited by +++).\n */\nexport function parseFrontmatter(content: string): ParsedFrontmatter {\n  if (content.startsWith(\"+++\")) {\n    return parseFrontmatterWithDelimiter(content, \"+++\", \"toml\");\n  }\n  if (content.startsWith(\"---\")) {\n    return parseFrontmatterWithDelimiter(content, \"---\", \"yaml\");\n  }\n  return { frontmatter: {}, body: content, format: \"none\" };\n}\n\nfunction parseFrontmatterWithDelimiter(\n  content: string,\n  delimiter: string,\n  format: \"yaml\" | \"toml\",\n): ParsedFrontmatter {\n  const searchStart = delimiter.length;\n  const endIndex = content.indexOf(`\\n${delimiter}`, searchStart);\n  if (endIndex === -1) {\n    return { frontmatter: {}, body: content, format: \"none\" };\n  }\n\n  const raw = content.slice(searchStart + 1, endIndex).trim();\n  const bodyStart = endIndex + 1 + delimiter.length;\n  const body = content.slice(bodyStart).replace(/^\\n/, \"\");\n\n  try {\n    const frontmatter =\n      format === \"toml\"\n        ? (parseTOML(raw) as Record<string, unknown>)\n        : (YAML.parse(raw) as Record<string, unknown>);\n    return { frontmatter: frontmatter || {}, body, format };\n  } catch {\n    return { frontmatter: {}, body: content, format: \"none\" };\n  }\n}\n","/**\n * Framework-agnostic markdown -> HTML rendering pipeline.\n * Uses the same remark/rehype chain as the Vantage viewer.\n */\n\nimport { unified } from \"unified\";\nimport remarkParse from \"remark-parse\";\nimport remarkGfm from \"remark-gfm\";\nimport remarkMath from \"remark-math\";\nimport remarkRehype from \"remark-rehype\";\nimport rehypeRaw from \"rehype-raw\";\nimport rehypeSanitize from \"rehype-sanitize\";\nimport rehypeHighlight from \"rehype-highlight\";\nimport rehypeKatex from \"rehype-katex\";\nimport rehypeSlug from \"rehype-slug\";\nimport rehypeStringify from \"rehype-stringify\";\nimport rehypeSourceLines from \"./rehypeSourceLines.js\";\nimport { sanitizeSchema } from \"./sanitize.js\";\nimport { parseFrontmatter } from \"./frontmatter.js\";\nimport type { ParsedFrontmatter } from \"./frontmatter.js\";\n\nexport interface RenderOptions {\n  /** Enable GFM tables, strikethrough, task lists (default: true) */\n  gfm?: boolean;\n  /** Enable KaTeX math rendering (default: true) */\n  math?: boolean;\n  /** Enable syntax highlighting (default: true) */\n  highlight?: boolean;\n  /** Add data-source-line attributes for line anchors (default: true) */\n  sourceLines?: boolean;\n  /** Enable XSS sanitization (default: true) */\n  sanitize?: boolean;\n  /** Parse and strip frontmatter (default: true) */\n  frontmatter?: boolean;\n}\n\nexport interface RenderResult {\n  /** The rendered HTML string */\n  html: string;\n  /** Parsed frontmatter (empty object if none or disabled) */\n  frontmatter: Record<string, unknown>;\n  /** The markdown body with frontmatter stripped */\n  body: string;\n}\n\n/**\n * Render a markdown string to HTML using the full Vantage pipeline.\n *\n * Features (all enabled by default):\n * - GitHub Flavored Markdown (tables, strikethrough, task lists)\n * - KaTeX math rendering ($$...$$ blocks)\n * - Syntax highlighting via highlight.js\n * - `data-source-line` attributes for line anchors\n * - XSS sanitization\n * - Heading slugs/anchors\n * - YAML/TOML frontmatter parsing\n *\n * Mermaid diagrams are NOT rendered server-side (they require a browser).\n * Mermaid code blocks are preserved as `<pre><code class=\"language-mermaid\">`.\n * Use the React `<MarkdownViewer>` component for client-side mermaid rendering.\n */\nexport async function renderMarkdown(\n  content: string,\n  options: RenderOptions = {},\n): Promise<RenderResult> {\n  const {\n    gfm = true,\n    math = true,\n    highlight = true,\n    sourceLines = true,\n    sanitize = true,\n    frontmatter: parseFm = true,\n  } = options;\n\n  // Parse frontmatter\n  let parsed: ParsedFrontmatter;\n  if (parseFm) {\n    parsed = parseFrontmatter(content);\n  } else {\n    parsed = { frontmatter: {}, body: content, format: \"none\" };\n  }\n\n  // Build the unified pipeline using a single chain.\n  // We use `any` for the processor to avoid unified's strict generic\n  // type constraints that make conditional plugin registration painful.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const remarkPlugins: [any, ...any[]][] = [];\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const rehypePlugins: [any, ...any[]][] = [];\n\n  if (gfm) remarkPlugins.push([remarkGfm, { singleTilde: false }]);\n  if (math) remarkPlugins.push([remarkMath, { singleDollarTextMath: false }]);\n\n  rehypePlugins.push([rehypeRaw]);\n  if (sourceLines) rehypePlugins.push([rehypeSourceLines]);\n  if (sanitize) rehypePlugins.push([rehypeSanitize, sanitizeSchema]);\n  rehypePlugins.push([rehypeSlug]);\n  if (highlight) rehypePlugins.push([rehypeHighlight]);\n  if (math) rehypePlugins.push([rehypeKatex]);\n\n  // Build the processor. We type as `any` because unified's generic\n  // Processor type changes shape with every .use() call, making\n  // conditional plugin registration impractical with strict types.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let processor: any = unified().use(remarkParse);\n  for (const [plugin, ...args] of remarkPlugins) {\n    processor = processor.use(plugin, ...args);\n  }\n  processor = processor.use(remarkRehype, { allowDangerousHtml: true });\n  for (const [plugin, ...args] of rehypePlugins) {\n    processor = processor.use(plugin, ...args);\n  }\n  processor = processor.use(rehypeStringify);\n\n  const result = await processor.process(parsed.body);\n\n  return {\n    html: String(result),\n    frontmatter: parsed.frontmatter,\n    body: parsed.body,\n  };\n}\n","/**\n * Framework-agnostic line anchor utilities.\n * Parse GitHub-style line anchors (#L42, #L42-L50) and scroll/highlight\n * matching elements in a container.\n */\n\nconst HIGHLIGHT_CLASS = \"line-anchor-highlight\";\n\n/**\n * Parse a GitHub-style line anchor hash.\n * Supports: #L42, #L42-L50, #L42-50\n * Returns null if the hash is not a line anchor.\n */\nexport function parseLineAnchor(\n  hash: string,\n): { start: number; end: number } | null {\n  if (!hash) return null;\n  const frag = hash.startsWith(\"#\") ? hash.slice(1) : hash;\n  const match = frag.match(/^L(\\d+)(?:-L?(\\d+))?$/);\n  if (!match) return null;\n\n  const start = parseInt(match[1], 10);\n  const end = match[2] ? parseInt(match[2], 10) : start;\n  return { start: Math.min(start, end), end: Math.max(start, end) };\n}\n\n/**\n * Clear all line anchor highlights from a container.\n */\nexport function clearLineAnchorHighlights(container: HTMLElement): void {\n  container.querySelectorAll(`.${HIGHLIGHT_CLASS}`).forEach((node) => {\n    (node as HTMLElement).classList.remove(HIGHLIGHT_CLASS);\n  });\n}\n\n/**\n * Scroll to and highlight line-anchored elements in a container.\n *\n * @param container - The DOM element containing rendered markdown\n * @param hash - The URL hash (e.g. \"#L42\" or \"#L42-L50\")\n * @returns A cleanup function that removes the highlights\n */\nexport function scrollToLineAnchor(\n  container: HTMLElement,\n  hash: string,\n): (() => void) | null {\n  clearLineAnchorHighlights(container);\n\n  const range = parseLineAnchor(hash);\n  if (!range) return null;\n\n  const blocks = container.querySelectorAll(\"[data-source-line]\");\n  let firstMatch: HTMLElement | null = null;\n\n  for (const block of blocks) {\n    const line = parseInt(\n      (block as HTMLElement).dataset.sourceLine || \"0\",\n      10,\n    );\n    if (line >= range.start && line <= range.end) {\n      (block as HTMLElement).classList.add(HIGHLIGHT_CLASS);\n      if (!firstMatch) firstMatch = block as HTMLElement;\n    }\n  }\n\n  // If exact line not found, find the nearest block before the target line\n  if (!firstMatch) {\n    let closest: HTMLElement | null = null;\n    let closestLine = 0;\n    for (const block of blocks) {\n      const line = parseInt(\n        (block as HTMLElement).dataset.sourceLine || \"0\",\n        10,\n      );\n      if (line <= range.start && line > closestLine) {\n        closestLine = line;\n        closest = block as HTMLElement;\n      }\n    }\n    if (closest) {\n      closest.classList.add(HIGHLIGHT_CLASS);\n      firstMatch = closest;\n    }\n  }\n\n  // Scroll to the first highlighted element\n  if (firstMatch) {\n    requestAnimationFrame(() => {\n      // Find the nearest scrollable ancestor\n      const scrollParent = findScrollParent(container);\n      if (scrollParent) {\n        const offset =\n          firstMatch!.getBoundingClientRect().top -\n          scrollParent.getBoundingClientRect().top +\n          scrollParent.scrollTop;\n        scrollParent.scrollTo({ top: offset - 32, behavior: \"smooth\" });\n      } else {\n        firstMatch!.scrollIntoView({ behavior: \"smooth\", block: \"start\" });\n      }\n    });\n  }\n\n  return () => clearLineAnchorHighlights(container);\n}\n\nfunction findScrollParent(el: HTMLElement): HTMLElement | null {\n  let node: HTMLElement | null = el;\n  while (node) {\n    const overflow = getComputedStyle(node).overflowY;\n    if (overflow === \"auto\" || overflow === \"scroll\") return node;\n    node = node.parentElement;\n  }\n  return null;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,111 @@
+import { Root } from 'hast';
+import { Plugin } from 'unified';
+import { defaultSchema } from 'rehype-sanitize';
+
+/**
+ * Framework-agnostic markdown -> HTML rendering pipeline.
+ * Uses the same remark/rehype chain as the Vantage viewer.
+ */
+interface RenderOptions {
+    /** Enable GFM tables, strikethrough, task lists (default: true) */
+    gfm?: boolean;
+    /** Enable KaTeX math rendering (default: true) */
+    math?: boolean;
+    /** Enable syntax highlighting (default: true) */
+    highlight?: boolean;
+    /** Add data-source-line attributes for line anchors (default: true) */
+    sourceLines?: boolean;
+    /** Enable XSS sanitization (default: true) */
+    sanitize?: boolean;
+    /** Parse and strip frontmatter (default: true) */
+    frontmatter?: boolean;
+}
+interface RenderResult {
+    /** The rendered HTML string */
+    html: string;
+    /** Parsed frontmatter (empty object if none or disabled) */
+    frontmatter: Record<string, unknown>;
+    /** The markdown body with frontmatter stripped */
+    body: string;
+}
+/**
+ * Render a markdown string to HTML using the full Vantage pipeline.
+ *
+ * Features (all enabled by default):
+ * - GitHub Flavored Markdown (tables, strikethrough, task lists)
+ * - KaTeX math rendering ($$...$$ blocks)
+ * - Syntax highlighting via highlight.js
+ * - `data-source-line` attributes for line anchors
+ * - XSS sanitization
+ * - Heading slugs/anchors
+ * - YAML/TOML frontmatter parsing
+ *
+ * Mermaid diagrams are NOT rendered server-side (they require a browser).
+ * Mermaid code blocks are preserved as `<pre><code class="language-mermaid">`.
+ * Use the React `<MarkdownViewer>` component for client-side mermaid rendering.
+ */
+declare function renderMarkdown(content: string, options?: RenderOptions): Promise<RenderResult>;
+
+/**
+ * Rehype plugin that adds `data-source-line` attributes to block-level
+ * elements based on their position in the original markdown source.
+ *
+ * This enables GitHub-style line anchors (#L42, #L42-L50) by giving
+ * each rendered block a traceable line number from the source.
+ */
+
+declare const rehypeSourceLines: Plugin<[], Root>;
+
+/**
+ * Framework-agnostic line anchor utilities.
+ * Parse GitHub-style line anchors (#L42, #L42-L50) and scroll/highlight
+ * matching elements in a container.
+ */
+/**
+ * Parse a GitHub-style line anchor hash.
+ * Supports: #L42, #L42-L50, #L42-50
+ * Returns null if the hash is not a line anchor.
+ */
+declare function parseLineAnchor(hash: string): {
+    start: number;
+    end: number;
+} | null;
+/**
+ * Clear all line anchor highlights from a container.
+ */
+declare function clearLineAnchorHighlights(container: HTMLElement): void;
+/**
+ * Scroll to and highlight line-anchored elements in a container.
+ *
+ * @param container - The DOM element containing rendered markdown
+ * @param hash - The URL hash (e.g. "#L42" or "#L42-L50")
+ * @returns A cleanup function that removes the highlights
+ */
+declare function scrollToLineAnchor(container: HTMLElement, hash: string): (() => void) | null;
+
+/**
+ * Frontmatter parser for YAML (---) and TOML (+++) delimited content.
+ * Works in both browser and server environments.
+ */
+type FrontmatterFormat = "yaml" | "toml" | "none";
+interface ParsedFrontmatter {
+    frontmatter: Record<string, unknown>;
+    body: string;
+    format: FrontmatterFormat;
+}
+/**
+ * Parse frontmatter from markdown content.
+ * Supports YAML (delimited by ---) and TOML (delimited by +++).
+ */
+declare function parseFrontmatter(content: string): ParsedFrontmatter;
+
+/**
+ * Sanitization schema for the rendering pipeline.
+ * Allows GFM, KaTeX MathML, syntax highlighting classes, and
+ * data-source-line attributes while blocking XSS vectors.
+ */
+
+type Schema = typeof defaultSchema;
+declare const sanitizeSchema: Schema;
+
+export { type FrontmatterFormat, type ParsedFrontmatter, type RenderOptions, type RenderResult, clearLineAnchorHighlights, parseFrontmatter, parseLineAnchor, rehypeSourceLines, renderMarkdown, sanitizeSchema, scrollToLineAnchor };

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+import { Root } from 'hast';
+import { Plugin } from 'unified';
+import { defaultSchema } from 'rehype-sanitize';
+
+/**
+ * Framework-agnostic markdown -> HTML rendering pipeline.
+ * Uses the same remark/rehype chain as the Vantage viewer.
+ */
+interface RenderOptions {
+    /** Enable GFM tables, strikethrough, task lists (default: true) */
+    gfm?: boolean;
+    /** Enable KaTeX math rendering (default: true) */
+    math?: boolean;
+    /** Enable syntax highlighting (default: true) */
+    highlight?: boolean;
+    /** Add data-source-line attributes for line anchors (default: true) */
+    sourceLines?: boolean;
+    /** Enable XSS sanitization (default: true) */
+    sanitize?: boolean;
+    /** Parse and strip frontmatter (default: true) */
+    frontmatter?: boolean;
+}
+interface RenderResult {
+    /** The rendered HTML string */
+    html: string;
+    /** Parsed frontmatter (empty object if none or disabled) */
+    frontmatter: Record<string, unknown>;
+    /** The markdown body with frontmatter stripped */
+    body: string;
+}
+/**
+ * Render a markdown string to HTML using the full Vantage pipeline.
+ *
+ * Features (all enabled by default):
+ * - GitHub Flavored Markdown (tables, strikethrough, task lists)
+ * - KaTeX math rendering ($$...$$ blocks)
+ * - Syntax highlighting via highlight.js
+ * - `data-source-line` attributes for line anchors
+ * - XSS sanitization
+ * - Heading slugs/anchors
+ * - YAML/TOML frontmatter parsing
+ *
+ * Mermaid diagrams are NOT rendered server-side (they require a browser).
+ * Mermaid code blocks are preserved as `<pre><code class="language-mermaid">`.
+ * Use the React `<MarkdownViewer>` component for client-side mermaid rendering.
+ */
+declare function renderMarkdown(content: string, options?: RenderOptions): Promise<RenderResult>;
+
+/**
+ * Rehype plugin that adds `data-source-line` attributes to block-level
+ * elements based on their position in the original markdown source.
+ *
+ * This enables GitHub-style line anchors (#L42, #L42-L50) by giving
+ * each rendered block a traceable line number from the source.
+ */
+
+declare const rehypeSourceLines: Plugin<[], Root>;
+
+/**
+ * Framework-agnostic line anchor utilities.
+ * Parse GitHub-style line anchors (#L42, #L42-L50) and scroll/highlight
+ * matching elements in a container.
+ */
+/**
+ * Parse a GitHub-style line anchor hash.
+ * Supports: #L42, #L42-L50, #L42-50
+ * Returns null if the hash is not a line anchor.
+ */
+declare function parseLineAnchor(hash: string): {
+    start: number;
+    end: number;
+} | null;
+/**
+ * Clear all line anchor highlights from a container.
+ */
+declare function clearLineAnchorHighlights(container: HTMLElement): void;
+/**
+ * Scroll to and highlight line-anchored elements in a container.
+ *
+ * @param container - The DOM element containing rendered markdown
+ * @param hash - The URL hash (e.g. "#L42" or "#L42-L50")
+ * @returns A cleanup function that removes the highlights
+ */
+declare function scrollToLineAnchor(container: HTMLElement, hash: string): (() => void) | null;
+
+/**
+ * Frontmatter parser for YAML (---) and TOML (+++) delimited content.
+ * Works in both browser and server environments.
+ */
+type FrontmatterFormat = "yaml" | "toml" | "none";
+interface ParsedFrontmatter {
+    frontmatter: Record<string, unknown>;
+    body: string;
+    format: FrontmatterFormat;
+}
+/**
+ * Parse frontmatter from markdown content.
+ * Supports YAML (delimited by ---) and TOML (delimited by +++).
+ */
+declare function parseFrontmatter(content: string): ParsedFrontmatter;
+
+/**
+ * Sanitization schema for the rendering pipeline.
+ * Allows GFM, KaTeX MathML, syntax highlighting classes, and
+ * data-source-line attributes while blocking XSS vectors.
+ */
+
+type Schema = typeof defaultSchema;
+declare const sanitizeSchema: Schema;
+
+export { type FrontmatterFormat, type ParsedFrontmatter, type RenderOptions, type RenderResult, clearLineAnchorHighlights, parseFrontmatter, parseLineAnchor, rehypeSourceLines, renderMarkdown, sanitizeSchema, scrollToLineAnchor };