@mvarble/mesearch-markdown 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthew Varble
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,20 @@
-# Temporary Holding Version
+# @mvarble/mesearch-markdown
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The mdsvex pipeline shared by [mesearch](https://github.com/mvarble/mesearch), [mkdoc](https://github.com/mvarble/mkdoc) and [the blog](https://github.com/mvarble/blog).
+
+```js
+import { markdownPreprocessors } from '@mvarble/mesearch-markdown';
+
+// svelte.config.js, or vite-plugin-svelte's `preprocess`
+preprocess: markdownPreprocessors({
+    katex: { macros: { '\\PP': '\\mathbb{P}' } },
+    mathBox: { liftTags: true },
+}),
+```
+
+- **KaTeX**, rendered at build time by KaTeX itself, with the macros layered: the base table (`\bbR`, `\calF`, `\bfx`, `\rmd`, `\defeq`, … in `baseMacros`), then the site's, then the document's own frontmatter `katex_macros`. `macros` may instead be a function of the document, for a content layer that folds macros down a tree of documents. A formula that does not parse renders in KaTeX's error colour and is reported, and does not fail the build.
+- **Display math** wrapped in a scroll container, so a long equation slides sideways rather than overflowing. With `liftTags`, a `\tag` is moved out of the container to stay in view.
+- **Shiki** highlighting in a light and a dark theme at once, with grammars loaded on first use. A fence whose whole body is `{./file}` or `{./file:10..20}` is replaced by those lines of the file.
+- **Relative assets** --- `![](./figure.png)` --- turned into Vite imports, so they are hashed and emitted with the page.
+
+`styles/katex.css` styles all of it. It also keeps inline math from breaking across a line.

package/dist/assets.d.ts

@@ -0,0 +1,12 @@
+import type { Plugin } from 'unified';
+import type { Root } from 'hast';
+export declare const rehypeAssets: Plugin<[], Root>;
+export declare const hoistAssetImports: {
+    name: string;
+    markup({ content, filename }: {
+        content: string;
+        filename?: string;
+    }): {
+        code: string;
+    } | undefined;
+};

package/dist/assets.js

@@ -0,0 +1,108 @@
+// Vite rewrites relative URLs in `.html` entries, and Svelte resolves them in
+// `import` statements --- but nothing rewrites `src="./picture.png"` written in
+// a Svelte template, which is exactly what `![](./picture.png)` compiles to.
+// Such a document builds cleanly and then ships a broken image.
+//
+// So the rehype pass below turns the attribute into `src={__md_asset_0}` and
+// records the URL; the preprocessor that runs after mdsvex hoists a matching
+// `import __md_asset_0 from './picture.png'` into the document's script.
+// From there it is an ordinary Vite import: hashed, emitted, and correct in
+// both the dev server and the build.
+// Attributes that name a file, by tag. `<a href>` is deliberately absent: a
+// link to a neighbouring document is a link, not an asset to inline.
+const ASSET_ATTRIBUTES = {
+    img: ['src'],
+    source: ['src'],
+    video: ['src', 'poster'],
+    audio: ['src'],
+    track: ['src'],
+    embed: ['src'],
+    iframe: ['src'],
+    object: ['data'],
+    link: ['href'],
+};
+// URLs written relative to the document. Everything else --- absolute paths,
+// external URLs, fragments, data URIs --- is left exactly as the author wrote it.
+const isRelative = (url) => url.startsWith('./') || url.startsWith('../');
+// Keyed by absolute filename, because the rehype tree and the Svelte source it
+// becomes are handled by two different plugins with no channel between them.
+//
+// A build compiles the document twice --- once for the client, once for SSR ---
+// and both passes write here. That is safe only because the two passes are
+// sequential and see the same tree; running them concurrently would let one
+// pass's markup be hoisted against the other's URLs.
+const collected = new Map();
+export const rehypeAssets = () => {
+    return (tree, vfile) => {
+        // mdsvex puts the document's absolute path on the vfile as `filename`,
+        // which is not one of vfile's own fields.
+        const filename = vfile.filename;
+        if (!filename)
+            throw new Error('the document vfile has no filename.');
+        const urls = [];
+        const stack = [tree];
+        while (stack.length > 0) {
+            const node = stack.pop();
+            if (node.type == 'element') {
+                const properties = node.properties ?? {};
+                for (const attribute of ASSET_ATTRIBUTES[node.tagName] ?? []) {
+                    const value = properties[attribute];
+                    if (typeof value != 'string' || !isRelative(value))
+                        continue;
+                    properties[attribute] = `{__md_asset_${urls.length}}`;
+                    urls.push(value);
+                }
+            }
+            for (const child of node.children) {
+                if (child.type == 'element')
+                    stack.push(child);
+            }
+        }
+        collected.set(filename, urls);
+    };
+};
+// A document may already declare an instance `<script>`; a second one is a
+// compile error, so the imports go inside the existing block when there is one.
+//
+// Only the prologue is searched. mdsvex emits the module block it makes from the
+// frontmatter, then the document's own script, then the markup --- so a `<script`
+// that appears after any real content is something the author wrote *in* the
+// document, and injecting imports into it would corrupt the page.
+const SCRIPT_OPEN = /^<script\b([^>]*)>/;
+function instanceScriptEnd(content) {
+    let at = 0;
+    while (at < content.length) {
+        const rest = content.slice(at);
+        const leading = rest.length - rest.trimStart().length;
+        at += leading;
+        const open = SCRIPT_OPEN.exec(content.slice(at));
+        if (!open)
+            return null;
+        const attributes = open[1] ?? '';
+        const openEnd = at + open[0].length;
+        const close = content.indexOf('</script>', openEnd);
+        if (close < 0)
+            return null;
+        // The block mdsvex generates for the frontmatter is not the document's.
+        if (!/\b(?:context|module)\b/.test(attributes))
+            return openEnd;
+        at = close + '</script>'.length;
+    }
+    return null;
+}
+export const hoistAssetImports = {
+    name: 'markdown-assets',
+    markup({ content, filename }) {
+        const urls = filename ? collected.get(filename) : undefined;
+        if (!urls?.length)
+            return;
+        const imports = urls
+            .map((url, i) => `import __md_asset_${i} from ${JSON.stringify(url)};`)
+            .join('\n');
+        const at = instanceScriptEnd(content);
+        if (at == null)
+            return { code: `<script>\n${imports}\n</script>\n${content}` };
+        return { code: `${content.slice(0, at)}\n${imports}${content.slice(at)}` };
+    },
+};
+//# sourceMappingURL=assets.js.map

package/dist/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../src/assets.ts"],"names":[],"mappings":"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"}

package/dist/highlight.d.ts

@@ -0,0 +1 @@
+export declare function highlight(code: string, lang: string | null | undefined, _meta: string | null | undefined, filename: string | undefined): Promise<string>;

package/dist/highlight.js

@@ -0,0 +1,85 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createHighlighter, bundledLanguages } from 'shiki';
+import { escapeSvelte } from 'mdsvex';
+const THEMES = { light: 'vitesse-light', dark: 'vitesse-dark' };
+// Loading all of Shiki's grammars eagerly costs seconds, and a site cannot know
+// up front which ones its documents use, so a language is loaded the first time
+// a fence asks for one.
+//
+// Both caches hold the *promise* rather than what it settles to. mdsvex
+// highlights a document's fences concurrently, through `Promise.all`, so a
+// cache filled in after an `await` is empty for every call already in flight:
+// two fences would each build a highlighter, and the language one of them loaded
+// would be loaded into a highlighter the other never sees. That fails as
+// "Language `json` not found", on the second language a document uses.
+let highlighter;
+const loaded = new Map();
+const highlighterFor = () => (highlighter ??= createHighlighter({ themes: Object.values(THEMES), langs: [] }));
+async function languageFor(shiki, lang) {
+    if (!lang || !(lang in bundledLanguages))
+        return 'text';
+    const load = loaded.get(lang) ?? shiki.loadLanguage(lang);
+    loaded.set(lang, load);
+    await load;
+    return lang;
+}
+// A fence whose entire body is `{./path/to/file}` --- optionally with a line
+// range, as `{./path/to/file:10..20}` --- is replaced by that file's contents,
+// highlighted as its own extension suggests. Keeping a snippet in the file it
+// came from means it cannot drift from the code it is quoting.
+export async function highlight(code, lang, _meta, filename) {
+    if (!code.includes('\n') && code.startsWith('{') && code.endsWith('}')) {
+        if (!filename)
+            throw new Error('cannot resolve a fenced import without a filename.');
+        const [imported, start, end] = parseImportString(code.slice(1, -1), filename);
+        code = await fs.readFile(imported, 'utf8');
+        code = sliceLines(code, start, end);
+        lang = path.extname(imported).slice(1);
+    }
+    const shiki = await highlighterFor();
+    const html = escapeSvelte(shiki.codeToHtml(code, { lang: await languageFor(shiki, lang), themes: THEMES }));
+    return `{@html \`${html}\` }`;
+}
+function sliceLines(code, start, end) {
+    if (start == null && end == null)
+        return code;
+    const lines = code.split('\n');
+    return lines.slice(start ?? 0, end == null ? undefined : end + 1).join('\n');
+}
+// Parses the body of a fenced import: a path, optionally followed by `:` and a
+// range written as `start..`, `..end` or `start..end`. The path is resolved
+// relative to the document that wrote it.
+function parseImportString(importString, filename) {
+    let imported = importString;
+    let start = null;
+    let end = null;
+    if (importString.includes(':')) {
+        const parts = importString.split(':');
+        if (parts.length > 2) {
+            throw new Error('a fenced import cannot contain multiple `:` characters.');
+        }
+        imported = parts[0];
+        const range = parts[1];
+        if (range.startsWith('..')) {
+            end = Number(range.slice(2));
+            if (!Number.isFinite(end))
+                throw new Error(`\`${range}\` is not a range ..end.`);
+        }
+        else if (range.endsWith('..')) {
+            start = Number(range.slice(0, -2));
+            if (!Number.isFinite(start)) {
+                throw new Error(`\`${range}\` is not a range start..`);
+            }
+        }
+        else {
+            const match = /^([0-9]+)\.\.([0-9]+)$/.exec(range);
+            if (!match)
+                throw new Error(`\`${range}\` is not a range start..end.`);
+            start = Number(match[1]);
+            end = Number(match[2]);
+        }
+    }
+    return [path.resolve(path.dirname(filename), imported), start, end];
+}
+//# sourceMappingURL=highlight.js.map

package/dist/highlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.js","sourceRoot":"","sources":["../src/highlight.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import type { PreprocessorGroup } from 'svelte/compiler';
+import { type RehypeKatexOptions } from './katex.ts';
+import { type MathBoxOptions } from './mathbox.ts';
+export { baseMacros, documentMacros, frontmatterMacros, rehypeKatex, renderMath, type KatexMacros, type RehypeKatexOptions, type RenderOptions, } from './katex.ts';
+export { rehypeMathBox, type MathBoxOptions } from './mathbox.ts';
+export { rehypeAssets, hoistAssetImports } from './assets.ts';
+export { highlight } from './highlight.ts';
+export declare const DOCUMENT_EXTENSIONS: string[];
+export type PluginEntry = any;
+export interface PreprocessorOptions {
+    extensions?: string[];
+    /** Run after frontmatter and math are parsed. */
+    remarkPlugins?: PluginEntry[];
+    /** Run before the math is rendered, so they see the TeX source. */
+    rehypePlugins?: PluginEntry[];
+    katex?: RehypeKatexOptions;
+    mathBox?: MathBoxOptions;
+    /** Hoist relative `src`s into Vite imports. On by default. */
+    assets?: boolean;
+    /** Set while a dev server is running: diagnostics repeat on every rebuild. */
+    watch?: boolean;
+}
+export declare function markdownPreprocessors(options?: PreprocessorOptions): PreprocessorGroup[];

package/dist/index.js

@@ -0,0 +1,34 @@
+import { mdsvex } from 'mdsvex';
+import remarkMath from 'remark-math';
+import remarkFrontmatter from 'remark-frontmatter';
+import { rehypeKatex } from "./katex.js";
+import { rehypeAssets, hoistAssetImports } from "./assets.js";
+import { rehypeMathBox } from "./mathbox.js";
+import { highlight } from "./highlight.js";
+export { baseMacros, documentMacros, frontmatterMacros, rehypeKatex, renderMath, } from "./katex.js";
+export { rehypeMathBox } from "./mathbox.js";
+export { rehypeAssets, hoistAssetImports } from "./assets.js";
+export { highlight } from "./highlight.js";
+export const DOCUMENT_EXTENSIONS = ['.svx', '.md'];
+// One parser configuration, shared by everything that renders these documents.
+// Order matters: `rehypeAssets` has to see the tree after KaTeX has run, so that
+// nothing it rewrote is mistaken for an asset.
+export function markdownPreprocessors(options = {}) {
+    const extensions = options.extensions ?? DOCUMENT_EXTENSIONS;
+    const assets = options.assets ?? true;
+    return [
+        mdsvex({
+            extensions,
+            remarkPlugins: [remarkFrontmatter, remarkMath, ...(options.remarkPlugins ?? [])],
+            rehypePlugins: [
+                ...(options.rehypePlugins ?? []),
+                [rehypeKatex, { watch: options.watch, ...options.katex }],
+                [rehypeMathBox, options.mathBox ?? {}],
+                ...(assets ? [rehypeAssets] : []),
+            ],
+            highlight: { highlighter: highlight },
+        }),
+        ...(assets ? [hoistAssetImports] : []),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,QAAQ,CAAC;AAEpD,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,iBAAiB,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAA2B,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAuB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACH,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,UAAU,GAIb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAuB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAsBnD,+EAA+E;AAC/E,iFAAiF;AACjF,+CAA+C;AAC/C,MAAM,UAAU,qBAAqB,CAAC,UAA+B,EAAE;IACnE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;IACtC,OAAO;QACH,MAAM,CAAC;YACH,UAAU;YACV,aAAa,EAAE,CAAC,iBAAiB,EAAE,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;YAChF,aAAa,EAAE;gBACX,GAAG,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC;gBAChC,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;gBACzD,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;gBACtC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC;YACD,SAAS,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE;SACvB,CAAsB;QACxC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACzC,CAAC;AACN,CAAC"}

package/dist/katex.d.ts

@@ -0,0 +1,28 @@
+import { type KatexOptions } from 'katex';
+import type { Plugin } from 'unified';
+import type { Root } from 'hast';
+export type KatexMacros = NonNullable<KatexOptions['macros']>;
+export declare const baseMacros: KatexMacros;
+export declare function frontmatterMacros(frontmatter: unknown): KatexMacros;
+export declare const documentMacros: (vfile: unknown) => KatexMacros;
+export interface RenderOptions {
+    katex?: KatexOptions;
+    /** Prefixes every report, so the reader knows which tool is talking. */
+    label?: string;
+    /** Re-report on every recompile, rather than only when something changes. */
+    watch?: boolean;
+}
+export declare function renderMath(tree: Root, filename: string, options?: RenderOptions): void;
+export interface RehypeKatexOptions extends Omit<RenderOptions, 'katex'> {
+    /** Start from `baseMacros`. On by default. */
+    base?: boolean;
+    /**
+     * The macros layered over the base table. A plain table is folded under the
+     * document's own frontmatter macros. A function is asked per document and
+     * its answer is used as given --- which is how a content layer that already
+     * knows each document's ancestry supplies the whole fold itself.
+     */
+    macros?: KatexMacros | ((vfile: unknown) => KatexMacros);
+    katex?: Omit<KatexOptions, 'macros'>;
+}
+export declare const rehypeKatex: Plugin<[RehypeKatexOptions?], Root>;

package/dist/katex.js

@@ -0,0 +1,186 @@
+import katex, {} from 'katex';
+const alphabet = 'abcdefghijklmnopqrstuvwxyz';
+const greeks = [
+    ['α', 'alpha'],
+    ['β', 'beta'],
+    ['γ', 'gamma'],
+    ['δ', 'delta'],
+    ['ϵ', 'epsilon'],
+    ['ζ', 'zeta'],
+    ['η', 'eta'],
+    ['θ', 'theta'],
+    ['ι', 'iota'],
+    ['κ', 'kappa'],
+    ['λ', 'lambda'],
+    ['μ', 'mu'],
+    ['ν', 'nu'],
+    ['ξ', 'xi'],
+    ['π', 'pi'],
+    ['ρ', 'rho'],
+    ['σ', 'sigma'],
+    ['τ', 'tau'],
+    ['ϕ', 'phi'],
+    ['ψ', 'psi'],
+    ['χ', 'chi'],
+    ['ω', 'omega'],
+];
+const titleCase = (str) => (str.length ? str.at(0).toUpperCase() + str.slice(1) : '');
+// Macros every document gets for free: `\bfx` for a bold `x`, `\calF` for a
+// script `F`, `\bbR` for the reals, and the same for the Greek letters. A site
+// adds to these from its configuration and a document from its frontmatter,
+// and the nearer definition of a name wins.
+export const baseMacros = {
+    ...Object.fromEntries([
+        ...alphabet.split('').flatMap((char) => [
+            [`\\rm${char}`, `{\\rm ${char}}`],
+            [`\\bf${char}`, `\\boldsymbol{${char}}`],
+            [`\\rm${char.toUpperCase()}`, `\\mathrm{${char.toUpperCase()}}`],
+            [`\\cal${char.toUpperCase()}`, `\\mathcal{${char.toUpperCase()}}`],
+            [`\\scr${char.toUpperCase()}`, `\\mathscr{${char.toUpperCase()}}`],
+            [`\\bb${char.toUpperCase()}`, `\\mathbb{${char.toUpperCase()}}`],
+            [`\\bf${char.toUpperCase()}`, `\\mathbf{${char.toUpperCase()}}`],
+        ]),
+        ...greeks.flatMap(([char, ident]) => [
+            [`\\rm${ident}`, `{\\rm ${char}}`],
+            [`\\bf${ident}`, `\\boldsymbol{${char}}`],
+            [`\\rm${titleCase(ident)}`, `\\mathrm{${char.toUpperCase()}}`],
+            [`\\cal${titleCase(ident)}`, `\\mathcal{${char.toUpperCase()}}`],
+            [`\\bf${titleCase(ident)}`, `\\mathbf{${char.toUpperCase()}}`],
+        ]),
+    ]),
+    '\\im': '\\rmi',
+    '\\defeq': '\\coloneqq',
+    '\\eqdef': '\\eqqcolon',
+};
+// Both spellings are accepted. `katex_macros` is the documented one; documents
+// written for other tools reach for the camelCase form often enough that
+// rejecting it only produces a confusing wall of undefined-control-sequence
+// errors.
+const MACRO_FIELDS = ['katex_macros', 'katexMacros'];
+// The macros a frontmatter mapping declares, in either spelling.
+export function frontmatterMacros(frontmatter) {
+    if (!frontmatter || typeof frontmatter != 'object')
+        return {};
+    const macros = {};
+    for (const field of MACRO_FIELDS) {
+        const value = frontmatter[field];
+        if (value && typeof value == 'object')
+            Object.assign(macros, value);
+    }
+    return macros;
+}
+// mdsvex parks the parsed frontmatter on the vfile as `data.fm`.
+export const documentMacros = (vfile) => frontmatterMacros(vfile.data?.fm);
+const isMath = (node) => {
+    const classes = node.properties?.className;
+    if (!Array.isArray(classes))
+        return null;
+    if (classes.includes('math-display'))
+        return 'display';
+    if (classes.includes('math-inline'))
+        return 'inline';
+    return null;
+};
+// The TeX source, which `remark-math` leaves as the element's text content.
+function textOf(node) {
+    let text = '';
+    const stack = [...node.children].reverse();
+    while (stack.length > 0) {
+        const child = stack.pop();
+        if (child.type == 'text')
+            text += child.value;
+        else if (child.type == 'element')
+            stack.push(...[...child.children].reverse());
+    }
+    return text;
+}
+// What was last reported for each document. A build compiles each document
+// twice, once per Vite pass, so without this the same broken equation is
+// reported twice for one command.
+const lastReported = new Map();
+// Renders every `.math-inline` / `.math-display` element in place, replacing its
+// children with the one text node mdsvex needs.
+//
+// KaTeX is called directly rather than through `rehype-katex`: the escaping a
+// Svelte template needs is a one-liner, and going through a wrapper meant the
+// math was rendered by whichever KaTeX that wrapper depended on rather than the
+// one whose stylesheet and fonts ship with the page. Skewed versions render
+// markup the stylesheet does not fully cover.
+export function renderMath(tree, filename, options = {}) {
+    // One copy per document: KaTeX writes `\gdef`s back into this object, so a
+    // definition made in one equation is visible to later ones, while the table
+    // it was copied from stays intact for the next document.
+    const settings = { ...options.katex, macros: { ...(options.katex?.macros ?? {}) } };
+    const failures = [];
+    const stack = [tree];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        for (const child of node.children) {
+            if (child.type != 'element')
+                continue;
+            const mode = isMath(child);
+            if (!mode) {
+                stack.push(child);
+                continue;
+            }
+            const tex = textOf(child);
+            const displayMode = mode == 'display';
+            let html;
+            try {
+                html = katex.renderToString(tex, { ...settings, displayMode, throwOnError: true });
+            }
+            catch (error) {
+                // Rendered anyway, in KaTeX's error colour: a document being
+                // drafted should still produce a page, with the broken formula
+                // visible in place rather than a failed build.
+                html = katex.renderToString(tex, { ...settings, displayMode, throwOnError: false });
+                failures.push(`${summarise(error)}\n      in: ${tex.trim().split('\n')[0]}`);
+            }
+            // `JSON.stringify` is what makes this Svelte rather than HTML, and
+            // `rehypeMathBox` reads the escaping it produces back out again.
+            child.children = [{ type: 'text', value: `{@html ${JSON.stringify(html)}}` }];
+        }
+    }
+    report(options.label ?? 'katex', filename, failures, options.watch ?? false);
+}
+// Every failure the document currently has, every time it is recompiled ---
+// not just the ones that are new. While you are editing macros to fix an
+// expression, an error that is still there is the thing you most need to be
+// told about, and silence reads as success.
+//
+// Outside watch mode the same report would be printed once per build pass, so
+// there it is emitted only when the set of failures actually changes.
+function report(label, filename, failures, watch) {
+    const signature = failures.join('\n');
+    const previous = lastReported.get(filename);
+    lastReported.set(filename, signature);
+    if (!watch && signature == previous)
+        return;
+    if (failures.length == 0) {
+        // Only worth saying when it is news: the document had errors a moment
+        // ago and now does not.
+        if (watch && previous)
+            console.log(`${label}: ${filename}\n    math renders cleanly`);
+        return;
+    }
+    for (const failure of failures)
+        console.warn(`${label}: ${filename}\n    ${failure}`);
+}
+const summarise = (error) => (error instanceof Error ? error.message : String(error)).replace(/ at position \d+.*$/s, '');
+export const rehypeKatex = (options = {}) => {
+    const base = options.base === false ? {} : baseMacros;
+    return (tree, vfile) => {
+        const macros = typeof options.macros == 'function'
+            ? { ...base, ...options.macros(vfile) }
+            : { ...base, ...(options.macros ?? {}), ...documentMacros(vfile) };
+        // mdsvex puts the document's absolute path on the vfile as `filename`,
+        // which is not one of vfile's own fields.
+        const filename = vfile.filename ?? 'document';
+        renderMath(tree, filename, {
+            katex: { ...options.katex, macros },
+            label: options.label,
+            watch: options.watch,
+        });
+    };
+};
+//# sourceMappingURL=katex.js.map

package/dist/katex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"katex.js","sourceRoot":"","sources":["../src/katex.ts"],"names":[],"mappings":"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"}

package/dist/mathbox.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from 'unified';
+import type { Root } from 'hast';
+export interface MathBoxOptions {
+    /** Move a `\tag` out of the scroll box, so the number stays in view. */
+    liftTags?: boolean;
+}
+export declare const rehypeMathBox: Plugin<[MathBoxOptions?], Root>;

package/dist/mathbox.js

@@ -0,0 +1,88 @@
+const isDisplayMath = (node) => node.type == 'element' &&
+    node.tagName == 'div' &&
+    Array.isArray(node.properties?.className) &&
+    node.properties.className.includes('math-display');
+const div = (className, children) => ({
+    type: 'element',
+    tagName: 'div',
+    properties: { className: [className] },
+    children,
+});
+// A display equation is one unbreakable box: on a narrow screen it either
+// overflows the page or gets clipped. Wrapping it in a scroll container lets the
+// equation slide sideways on its own while the prose around it stays put.
+const scrollBox = (math) => div('math-scroll-container', [div('math-container', [math])]);
+// The KaTeX markup of a `\tag`, cut out of the rendered equation so that it can
+// sit beside the scroll box rather than scroll away with the equation.
+//
+// The equation reaches here as the `{@html "..."}` text node `rehypeKatex`
+// leaves, so this works on the escaped string: it finds the tag's opening span,
+// walks to the span that closes it, and drops the tag's first child --- a
+// `katex-strut` that sizes the line for the equation it no longer sits in.
+function liftTag(math) {
+    const text = math.children[0];
+    if (math.children.length != 1 || text?.type != 'text' || !text.value.startsWith('{@html')) {
+        return undefined;
+    }
+    const start = text.value.indexOf('<span class=\\"katex-tag\\"');
+    if (start <= 0)
+        return undefined;
+    const rest = text.value.slice(start);
+    let length = 0;
+    let depth = 0;
+    let strutStart = 0;
+    let strutStop = 0;
+    while (length < rest.length) {
+        if (rest.slice(length, length + 5) === '<span') {
+            if (depth == 1 && strutStart == 0)
+                strutStart = length;
+            depth++;
+            length += 5;
+            while (length < rest.length && rest[length] !== '>')
+                length++;
+            length++;
+        }
+        else if (rest.slice(length, length + 7) === '</span>') {
+            depth--;
+            length += 7;
+            if (strutStart != 0 && strutStop == 0)
+                strutStop = length;
+            if (depth === 0)
+                break;
+        }
+        else {
+            length++;
+        }
+    }
+    text.value = text.value.slice(0, start) + text.value.slice(start + length);
+    return rest.slice(0, strutStart) + rest.slice(strutStop, length);
+}
+export const rehypeMathBox = (options = {}) => {
+    return (tree) => {
+        const stack = [tree];
+        while (stack.length > 0) {
+            const children = stack.pop().children;
+            for (let i = 0; i < children.length; i++) {
+                const child = children[i];
+                if (child.type != 'element')
+                    continue;
+                // The wrapper is not descended into: it still contains the
+                // display-math node, and revisiting it would wrap it again,
+                // forever.
+                if (!isDisplayMath(child)) {
+                    stack.push(child);
+                    continue;
+                }
+                const tag = options.liftTags ? liftTag(child) : undefined;
+                const box = scrollBox(child);
+                children[i] = tag
+                    ? div('math-tag-container', [
+                        box,
+                        div('math-tag', [{ type: 'text', value: `{@html "${tag}"}` }]),
+                    ])
+                    : box;
+            }
+        }
+    };
+};
+//# sourceMappingURL=mathbox.js.map

package/dist/mathbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mathbox.js","sourceRoot":"","sources":["../src/mathbox.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@mvarble/mesearch-markdown",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "The mdsvex pipeline shared by mesearch, mkdoc and the blog: KaTeX with layered macros, scrollable display math, Shiki highlighting and relative assets.",
+  "license": "MIT",
+  "author": "Matthew Varble <matthew@rodent.club>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mvarble/mesearch.git",
+    "directory": "packages/markdown"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./katex": {
+      "types": "./dist/katex.d.ts",
+      "import": "./dist/katex.js"
+    },
+    "./styles/katex.css": "./styles/katex.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "styles"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "dependencies": {
+    "katex": "^0.18.4",
+    "mdsvex": "^0.12.8",
+    "remark-frontmatter": "^2.0.0",
+    "remark-math": "3.0.0",
+    "shiki": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/hast": "^3.0.5",
+    "@types/katex": "^0.16.7",
+    "@types/node": "^22.14.0",
+    "svelte": "^5.57.1",
+    "typescript": "^6.0.3",
+    "unified": "^11.0.5",
+    "vfile": "^6.0.3"
+  },
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test 'test/**/*.test.mjs'"
+  }
 }

package/styles/katex.css

@@ -0,0 +1,71 @@
+/* How rendered math sits in prose. `katex/dist/katex.min.css` itself is
+ * imported by each site's entry, which is what makes the bundler emit the KaTeX
+ * fonts alongside the page.
+ *
+ * Sizes are variables so that a site can tune them to its body font:
+ *   --katex-font-size         (default 1rem)
+ *   --katex-font-size-hidpi   (default 1.32rem, on screens of 1.75x and up) */
+
+/* Display math is one unbreakable box. `rehypeMathBox` wraps it in these two
+ * containers so a long equation slides sideways on its own, fading out at the
+ * edges rather than being clipped. */
+.math-scroll-container {
+    overflow-x: auto;
+    flex-grow: 1;
+    --fading-size: 3em;
+    mask-image: linear-gradient(
+        to right,
+        transparent 0%,
+        black var(--fading-size),
+        black calc(100% - var(--fading-size)),
+        transparent
+    );
+    -webkit-mask-image: linear-gradient(
+        to right,
+        transparent 0%,
+        black var(--fading-size),
+        black calc(100% - var(--fading-size)),
+        transparent
+    );
+}
+
+/* A `\tag` lifted out of the scroll box by `rehypeMathBox({ liftTags: true })`
+ * stays in view beside it. */
+.math-tag-container {
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+}
+
+.math-tag {
+    margin-left: 2em !important;
+}
+
+/* An inline expression never breaks across lines: justified prose stretches
+ * the spaces around it instead. */
+.katex-html {
+    display: inline-block;
+}
+
+.katex {
+    line-height: 1;
+    font-size: var(--katex-font-size, 1rem);
+}
+
+.katex-display {
+    margin: 0.5em 0 !important;
+
+    & .katex-base:first-child {
+        margin-left: var(--fading-size) !important;
+    }
+
+    & .katex-base:last-child {
+        margin-right: var(--fading-size) !important;
+    }
+}
+
+@media (min-resolution: 1.75x) {
+    .katex {
+        font-size: var(--katex-font-size-hidpi, 1.32rem);
+    }
+}