@mvarble/mesearch-cms 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

@@ -0,0 +1,53 @@
+# @mvarble/mesearch-cms
+
+A content database for sites built from markdown and mdsvex documents. It is an in-memory store, rebuilt from the content on every change, holding:
+
+- documents and the pages they are shown on;
+- numbered equations and statements, scoped to a post or sequence;
+- references between documents, resolved by pluggable resolvers;
+- each document's outline;
+- KaTeX macros, folded down the tree of documents.
+
+A Vite plugin keeps it current during development and serves it to routes as a server-only virtual module of typed queries.
+
+```js
+// vite.config.ts
+import { createCms } from '@mvarble/mesearch-cms';
+import { blogPreset } from '@mvarble/mesearch-cms/presets/blog';
+import { markdownPreprocessors } from '@mvarble/mesearch-markdown';
+
+const cms = createCms({ preset: blogPreset(), virtualId: '$cms' });
+
+export default defineConfig({
+    plugins: [
+        ...cms.vite(),
+        sveltekit({
+            preprocess: markdownPreprocessors({
+                remarkPlugins: [cms.remark],
+                katex: { macros: cms.macrosFor },
+            }),
+        }),
+    ],
+});
+```
+
+```ts
+// +page.server.ts
+import { cms } from '$cms';
+export const load = () => ({ posts: cms.posts.list({ limit: 3 }) });
+```
+
+`$cms/loaders` default-exports a dynamic import of every document's component, keyed by filename, and is safe to use in the browser.
+
+## Presets
+
+- **`mesearchPreset`** --- `content/{concepts,writeups,sequences}/<slug>/index.{md,svx}`. It reads `depends_on` and sequence membership, takes dates from git, resolves links written as paths on disk, and builds the dependency graph. Equations and the statements a document shows share one count per document. Every `.bib` file under `content/` adds to one bibliography.
+- In both presets a `cite:` link points at the reference list at the end of its own page, and `cms.bibliography(page)` gives what that list holds: everything the page, its statements and its description cite.
+- Both presets share the statement registration (`core/statements.ts`) and the BibTeX reader (`core/bibtex.ts`). The reader decodes LaTeX accents and drops protective braces.
+- **`blogPreset`** --- the blog's `type: post | sequence | statement` documents and `.bib` bibliographies. Statements and equations share one counter per post or sequence, and the preset provides the `cite:`, `eq:` and `statement:` references and the `%title`, `%label`, `%sequence` and `%full` link text.
+
+A preset is a list of doctypes and resolvers (see `Doctype` and `Resolver`). A doctype registers what a file contributes in a first pass, then resolves what it refers to in a second, once every document is known, so the result never depends on the order the files are read in.
+
+## How changes propagate
+
+Every document has _facts_: everything the markdown plugins and module injection read for it, such as its labels, resolved references, headings and folded macros. When the content changes, the store is rebuilt and the facts compared. Only the documents whose facts changed are recompiled, even when the file that changed was a different one: inserting a statement renumbers every later statement in its scope.

package/dist/cms.d.ts

@@ -0,0 +1,22 @@
+import type { Plugin } from 'vite';
+import { type KatexMacros } from '@mvarble/mesearch-markdown/katex';
+import { type Preset } from './core/build.ts';
+import type { Store } from './core/store.ts';
+export interface CmsOptions {
+    preset: Preset;
+    root?: string;
+    macros?: KatexMacros;
+    virtualId?: string;
+    label?: string;
+    reload?: 'full' | 'data';
+}
+export interface Cms {
+    readonly root: string;
+    readonly preset: Preset;
+    readonly store: Store;
+    build(): Store;
+    vite(): Plugin[];
+    remark: () => (tree: unknown, vfile: unknown) => void;
+    macrosFor(vfile: unknown): KatexMacros;
+}
+export declare function createCms(options: CmsOptions): Cms;

package/dist/cms.js

@@ -0,0 +1,270 @@
+import { fileURLToPath } from 'node:url';
+import { uneval } from 'devalue';
+import { documentMacros } from '@mvarble/mesearch-markdown/katex';
+import { buildStore } from "./core/build.js";
+import { allFacts, diffFacts } from "./core/facts.js";
+import { toAbsolute, toId } from "./core/paths.js";
+import { matchLink } from "./core/resolver.js";
+const RUNTIME_ID = 'virtual:mesearch-cms/runtime';
+const here = fileURLToPath(import.meta.url);
+// What was last printed for each root, so that the several passes of one build
+// --- and the several copies of the config a SvelteKit build evaluates --- do
+// not repeat themselves.
+const lastReported = new Map();
+export function createCms(options) {
+    const root = options.root ?? process.cwd();
+    const { preset } = options;
+    const virtualId = options.virtualId ?? 'virtual:mesearch-cms';
+    const resolvedVirtualId = `\0${virtualId}`;
+    const loadersId = `${virtualId}/loaders`;
+    const resolvedLoadersId = `\0${loadersId}`;
+    const label = options.label ?? 'cms';
+    // The dev server's queries read the live snapshot through here: the module
+    // runner evaluates the virtual module in this same process, but in its own
+    // module instance, so a shared global is the one thing both can see.
+    const bridge = Symbol.for(`mesearch-cms:${root}:${virtualId}`);
+    let store;
+    let facts = new Map();
+    let snapshot;
+    let snapshotCode = '';
+    let watching = false;
+    function build() {
+        store = buildStore({ root, preset, macros: options.macros });
+        facts = allFacts(store);
+        snapshot = preset.snapshot(store);
+        snapshotCode = uneval(snapshot);
+        report(store);
+        return store;
+    }
+    const current = () => store ?? build();
+    function report(store) {
+        const messages = [...new Set(store.diagnostics.map((d) => d.message))];
+        const signature = messages.join('\n');
+        const previous = lastReported.get(root);
+        lastReported.set(root, signature);
+        if (signature == previous && !(watching && messages.length))
+            return;
+        if (messages.length == 0) {
+            if (previous)
+                console.log(`${label}: content is consistent again`);
+            return;
+        }
+        for (const message of messages)
+            console.error(`${label}: ${message}`);
+    }
+    globalThis[bridge] = () => {
+        current();
+        return snapshot;
+    };
+    const isContent = (id) => {
+        const rel = toId(root, id);
+        return (!rel.startsWith('..') &&
+            (rel + '/').startsWith(preset.contentDir.replace(/\/?$/, '/')) &&
+            preset.include(rel));
+    };
+    function vite() {
+        let server;
+        let command = 'build';
+        let pending;
+        // Re-transform the documents whose output depends on what just changed.
+        // Vite only invalidates the file that was edited, but a label is a
+        // function of position, and a page's title is substituted into every
+        // link to it: comparing each document's facts before and after says
+        // exactly which documents those are.
+        function rebuild() {
+            const before = facts;
+            const beforeSnapshot = snapshotCode;
+            const beforeDocs = [...facts.keys()].join('\n');
+            build();
+            const changed = diffFacts(before, facts);
+            const docsChanged = beforeDocs != [...facts.keys()].join('\n');
+            if (!server || (changed.length == 0 && beforeSnapshot == snapshotCode))
+                return;
+            const inPlace = options.reload == 'data' && !docsChanged;
+            for (const environment of Object.values(server.environments)) {
+                const graph = environment.moduleGraph;
+                for (const id of changed) {
+                    const module = graph.getModuleById(toAbsolute(root, id));
+                    if (!module)
+                        continue;
+                    // Hot-updated where the browser has it, and recompiled on
+                    // next use everywhere else.
+                    const reload = environment.reloadModule;
+                    if (inPlace && environment.name == 'client' && reload) {
+                        void reload.call(environment, module);
+                    }
+                    else {
+                        graph.invalidateModule(module);
+                    }
+                }
+                const virtual = graph.getModuleById(resolvedVirtualId);
+                if (virtual)
+                    graph.invalidateModule(virtual);
+                const loaders = graph.getModuleById(resolvedLoadersId);
+                if (loaders && docsChanged)
+                    graph.invalidateModule(loaders);
+            }
+            if (inPlace)
+                server.hot.send({ type: 'custom', event: 'mesearch-cms:update' });
+            else
+                server.hot.send({ type: 'full-reload' });
+        }
+        return [
+            {
+                name: 'mesearch-cms',
+                enforce: 'pre',
+                configResolved(config) {
+                    command = config.command;
+                    watching = command == 'serve';
+                },
+                configureServer(devServer) {
+                    server = devServer;
+                    server.watcher.add(toAbsolute(root, preset.contentDir));
+                },
+                buildStart() {
+                    current();
+                },
+                // `watchChange` rather than `handleHotUpdate`: Vite only
+                // dispatches the latter for edits, so a created or deleted
+                // document would never reach the content layer. A single save
+                // can emit several events --- adding a statement is usually a
+                // create plus an edit to the page importing it --- so they are
+                // coalesced into one rebuild.
+                watchChange(id) {
+                    if (!isContent(id))
+                        return;
+                    if (pending)
+                        clearTimeout(pending);
+                    pending = setTimeout(() => {
+                        pending = undefined;
+                        rebuild();
+                    }, 10);
+                },
+                async resolveId(id) {
+                    if (id == virtualId)
+                        return resolvedVirtualId;
+                    if (id == loadersId)
+                        return resolvedLoadersId;
+                    // Resolved from inside this package, so a site need not
+                    // depend on it directly for the import to be found.
+                    if (id == RUNTIME_ID)
+                        return this.resolve(preset.runtime, here, { skipSelf: true });
+                    return null;
+                },
+                load(id) {
+                    if (id == resolvedLoadersId) {
+                        const entries = [...current().docs.keys()]
+                            .sort()
+                            .map((doc) => `    ${JSON.stringify(doc)}: () => import(${JSON.stringify(toAbsolute(root, doc))}),`);
+                        return `export default {\n${entries.join('\n')}\n};\n`;
+                    }
+                    if (id != resolvedVirtualId)
+                        return null;
+                    // An SSR build that Vite runs the legacy way is still
+                    // called the client environment, so `build.ssr` decides.
+                    const environment = this.environment?.config;
+                    if (environment?.consumer == 'client' && !environment.build?.ssr) {
+                        throw new Error(`${label}: \`${virtualId}\` is server-only; import it from a ` +
+                            '`+page.server` or `+layout.server` module.');
+                    }
+                    current();
+                    if (command == 'serve') {
+                        return (`import { bindLive } from ${JSON.stringify(RUNTIME_ID)};\n` +
+                            `export const cms = bindLive(() => globalThis[Symbol.for(${JSON.stringify(bridge.description)})]());\n`);
+                    }
+                    return (`import { bind } from ${JSON.stringify(RUNTIME_ID)};\n` +
+                        `export const cms = bind(${snapshotCode});\n`);
+                },
+            },
+            {
+                name: 'mesearch-cms:inject',
+                enforce: 'post',
+                transform(code, id) {
+                    if (id.includes('?') || !isContent(id))
+                        return null;
+                    const injection = current().injection(toId(root, id));
+                    if (!injection)
+                        return null;
+                    return {
+                        code: `${code}\nexport const cms = ${JSON.stringify(injection)};\n`,
+                        map: null,
+                    };
+                },
+            },
+        ];
+    }
+    const remark = () => (tree, vfile) => {
+        const filename = vfile.filename;
+        if (!filename)
+            return;
+        const store = current();
+        const id = toId(root, filename);
+        const doc = store.docs.get(id);
+        if (!doc)
+            return;
+        const top = tree.children ?? [];
+        // Headings get their ids by position among the same top-level headings
+        // the store recorded. The two texts need not agree --- a heading with
+        // math in it reaches the renderer as KaTeX markup --- so matching by
+        // text would quietly produce anchors nothing links to.
+        const headings = top.filter((node) => node.type == 'heading' && (node.depth ?? 0) <= preset.headingDepth);
+        if (headings.length != doc.headings.length && doc.headings.length) {
+            console.warn(`${label}: ${id}\n    found ${headings.length} headings to anchor, expected ` +
+                `${doc.headings.length}; some table-of-contents links may miss`);
+        }
+        headings.forEach((node, i) => {
+            const heading = doc.headings[i];
+            if (!heading)
+                return;
+            node.data ??= {};
+            node.data.hProperties = { ...node.data.hProperties, id: heading.slug };
+        });
+        const nodes = top.toReversed();
+        while (nodes.length > 0) {
+            const node = nodes.pop();
+            if (node.children?.length)
+                nodes.push(...node.children.toReversed());
+            if (node.type == 'math') {
+                const math = node;
+                for (const resolver of preset.resolvers) {
+                    if (!resolver.rewriteMath)
+                        continue;
+                    for (const written of resolver.matchMath?.(math.value) ?? []) {
+                        const ref = store.ref(id, resolver.name, written);
+                        if (ref)
+                            resolver.rewriteMath(math, written, ref.target);
+                    }
+                }
+            }
+            if (node.type == 'link') {
+                const link = node;
+                const match = matchLink(preset.resolvers, link.url, store, doc);
+                if (!match?.resolver.rewriteLink)
+                    continue;
+                const ref = store.ref(id, match.resolver.name, match.written);
+                if (ref)
+                    match.resolver.rewriteLink(link, ref.target);
+            }
+        }
+    };
+    function macrosFor(vfile) {
+        const filename = vfile.filename;
+        const store = current();
+        const id = filename ? toId(root, filename) : undefined;
+        if (id && store.docs.has(id))
+            return store.foldedMacros(id);
+        return { ...store.siteMacros, ...documentMacros(vfile) };
+    }
+    return {
+        root,
+        preset,
+        get store() {
+            return current();
+        },
+        build,
+        vite,
+        remark,
+        macrosFor,
+    };
+}
+//# sourceMappingURL=cms.js.map

package/dist/cms.js.map

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

package/dist/core/bibtex.d.ts

@@ -0,0 +1,6 @@
+import { type Citation } from '../resolvers/citation.ts';
+import type { SourceFile } from './source.ts';
+import type { Store } from './store.ts';
+export declare function readBibliography(store: Store, file: SourceFile, collection?: string): void;
+export declare function bibliographies(store: Store, collection?: string): Record<string, Citation[]>;
+export declare function detex(text: string): string;

package/dist/core/bibtex.js

@@ -0,0 +1,129 @@
+import bibtex from 'bibtex';
+import { citationLabel } from "../resolvers/citation.js";
+// Every entry of a `.bib` file, into the bibliography. Keys are site-wide.
+export function readBibliography(store, file, collection = 'citations') {
+    const entries = store.collection(collection);
+    let parsed;
+    try {
+        parsed = bibtex.parseBibFile(file.raw);
+    }
+    catch (error) {
+        store.error(file.id, `${file.id}: the bibliography does not parse.\n${error}`);
+        return;
+    }
+    for (const [key, entry] of Object.entries(parsed.entries$)) {
+        const field = (name) => {
+            const value = entry.getFieldAsString(name);
+            return value === undefined ? undefined : detex(String(value));
+        };
+        const existing = sources.get(store)?.get(key);
+        if (existing && existing != file.id) {
+            store.error(file.id, `${file.id}: '${key}' is also in ${existing}; this one wins.`);
+        }
+        if (!sources.has(store))
+            sources.set(store, new Map());
+        sources.get(store).set(key, file.id);
+        entries.set(key, {
+            kind: entry.type,
+            key,
+            title: field('title') ?? '',
+            year: field('year') ?? '',
+            doi: field('doi'),
+            publisher: field('publisher'),
+            issn: field('issn'),
+            isbn: field('isbn'),
+            journal: field('journal'),
+            number: field('number'),
+            pages: field('pages'),
+            volume: field('volume'),
+            institution: field('institution'),
+            edition: field('edition'),
+            url: field('url'),
+            series: field('series'),
+            authors: (entry.getAuthors()?.authors$ ?? []).map((author) => ({
+                lastname: detex(String(author.lastNames$.at(-1))),
+                fullname: detex(fullname(author)),
+            })),
+        });
+    }
+}
+// What each page cites --- in its own text, in the statements it shows, and in
+// its description --- by pathname, in the order of the labels.
+export function bibliographies(store, collection = 'citations') {
+    const cited = new Map();
+    const all = store.collection(collection);
+    for (const id of store.docs.keys()) {
+        const page = store.pathnameOf(id);
+        if (!page)
+            continue;
+        for (const ref of store.refsOf(id)) {
+            if (ref.resolver != 'citation')
+                continue;
+            const citation = all.get(ref.target.key);
+            if (!citation)
+                continue;
+            if (!cited.has(page))
+                cited.set(page, new Map());
+            cited.get(page).set(citation.key, citation);
+        }
+    }
+    return Object.fromEntries([...cited].map(([page, citations]) => [
+        page,
+        [...citations.values()].sort((a, b) => citationLabel(a).localeCompare(citationLabel(b)) || a.key.localeCompare(b.key)),
+    ]));
+}
+// Which file each key came from, per build, to report a key defined twice.
+const sources = new WeakMap();
+function fullname(name) {
+    const append = (str, add) => `${str.trim()} ${add.trim()}`;
+    let out = name.firstNames.join(' ');
+    out = append(out, name.vons.join(' '));
+    out = append(out, name.lastNames.join(' '));
+    out = append(out, name.jrs.join(' '));
+    return out;
+}
+const ACCENTS = {
+    '"': '\u0308',
+    "'": '\u0301',
+    '`': '\u0300',
+    '^': '\u0302',
+    '~': '\u0303',
+    '=': '\u0304',
+    '.': '\u0307',
+    c: '\u0327',
+    v: '\u030c',
+    u: '\u0306',
+    H: '\u030b',
+};
+const LETTERS = {
+    ss: 'ß',
+    o: 'ø',
+    O: 'Ø',
+    l: 'ł',
+    L: 'Ł',
+    ae: 'æ',
+    AE: 'Æ',
+    oe: 'œ',
+    OE: 'Œ',
+    aa: 'å',
+    AA: 'Å',
+    i: 'ı',
+};
+// BibTeX's text as a reader sees it: `{\"u}` is ü, `{\ss}` is ß, and braces
+// that only protect capitals go. Math, between dollar signs, is left alone.
+export function detex(text) {
+    return text
+        .split(/(\$[^$]*\$)/g)
+        .map((part, i) => i % 2
+        ? part
+        : part
+            .replace(/\\(["'`^~=.]|[cvuH](?![a-zA-Z]))\s*\{?([a-zA-Z]|\\i)\}?/g, (_, accent, letter) => ((letter == '\\i' ? 'i' : letter) + ACCENTS[accent]).normalize('NFC'))
+            .replace(/\\(ss|ae|AE|oe|OE|aa|AA|o|O|l|L|i)(?![a-zA-Z])\s?/g, (_, name) => LETTERS[name])
+            .replace(/[{}]/g, '')
+            .replace(/---/g, '—')
+            .replace(/--/g, '–'))
+        .join('')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=bibtex.js.map

package/dist/core/bibtex.js.map

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

package/dist/core/build.d.ts

@@ -0,0 +1,29 @@
+import type { KatexMacros } from '@mvarble/mesearch-markdown/katex';
+import { Store, type DocRecord } from './store.ts';
+import { type SourceFile } from './source.ts';
+import { type Resolver } from './resolver.ts';
+export interface Doctype {
+    name: string;
+    claims(file: SourceFile): boolean;
+    initialize?(store: Store, file: SourceFile): void;
+    crossReference?(store: Store, file: SourceFile): void;
+    finalize?(store: Store): void;
+}
+export interface Preset {
+    name: string;
+    contentDir: string;
+    include(id: string): boolean;
+    doctypes: Doctype[];
+    resolvers: Resolver[];
+    headingDepth: number;
+    runtime: string;
+    snapshot(store: Store): unknown;
+}
+export interface BuildOptions {
+    root: string;
+    preset: Preset;
+    macros?: KatexMacros;
+}
+export declare function buildStore({ root, preset, macros }: BuildOptions): Store;
+export declare function defaultCrossReference(store: Store, preset: Preset, file: SourceFile): void;
+export declare const docRecord: (id: string, doctype: string, fields?: Partial<Omit<DocRecord, "id" | "doctype">>) => DocRecord;

package/dist/core/build.js

@@ -0,0 +1,41 @@
+import { Store } from "./store.js";
+import { scan } from "./source.js";
+import { resolveReferences } from "./resolver.js";
+export function buildStore({ root, preset, macros }) {
+    const store = new Store(root, macros);
+    const files = scan(root, preset.contentDir, preset.include).map((id) => store.file(id));
+    const claimed = files.map((file) => ({
+        file,
+        doctype: preset.doctypes.find((doctype) => doctype.claims(file)),
+    }));
+    for (const { file, doctype } of claimed)
+        doctype?.initialize?.(store, file);
+    for (const { file, doctype } of claimed) {
+        if (doctype?.crossReference)
+            doctype.crossReference(store, file);
+        else
+            defaultCrossReference(store, preset, file);
+    }
+    for (const doctype of preset.doctypes)
+        doctype.finalize?.(store);
+    return store;
+}
+// Anything the first pass registered gets its references resolved --- a page,
+// and anything shown on one.
+export function defaultCrossReference(store, preset, file) {
+    const doc = store.docs.get(file.id);
+    if (!doc || store.pathnameOf(doc.id) === undefined)
+        return;
+    resolveReferences(store, doc, file, preset.resolvers);
+}
+// A document with nothing of its own yet, for doctypes to fill in.
+export const docRecord = (id, doctype, fields = {}) => ({
+    id,
+    doctype,
+    scope: fields.scope ?? id,
+    host: fields.host,
+    macroParent: fields.macroParent,
+    macros: fields.macros ?? {},
+    headings: fields.headings ?? [],
+});
+//# sourceMappingURL=build.js.map

package/dist/core/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,IAAI,EAAmB,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAiB,MAAM,eAAe,CAAC;AA6CjE,MAAM,UAAU,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAgB;IAC7D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjC,IAAI;QACJ,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;KACnE,CAAC,CAAC,CAAC;IAEJ,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,OAAO;QAAE,OAAO,EAAE,UAAU,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC5E,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,CAAC;QACtC,IAAI,OAAO,EAAE,cAAc;YAAE,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;;YAC5D,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;IACjE,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,6BAA6B;AAC7B,MAAM,UAAU,qBAAqB,CAAC,KAAY,EAAE,MAAc,EAAE,IAAgB;IAChF,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,SAAS;QAAE,OAAO;IAC3D,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,MAAM,SAAS,GAAG,CACrB,EAAU,EACV,OAAe,EACf,SAAqD,EAAE,EAC9C,EAAE,CAAC,CAAC;IACb,EAAE;IACF,OAAO;IACP,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;IACzB,IAAI,EAAE,MAAM,CAAC,IAAI;IACjB,WAAW,EAAE,MAAM,CAAC,WAAW;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;IAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;CAClC,CAAC,CAAC"}

package/dist/core/facts.d.ts

@@ -0,0 +1,4 @@
+import type { Store } from './store.ts';
+export declare function documentFacts(store: Store, id: string): string;
+export declare function allFacts(store: Store): Map<string, string>;
+export declare function diffFacts(before: Map<string, string>, after: Map<string, string>): string[];

package/dist/core/facts.js

@@ -0,0 +1,39 @@
+// A digest of everything the markdown plugins and the module injection read for
+// a single document --- and nothing else. When a rebuild changes a document's
+// facts its compiled module is stale, even if the file itself was not touched:
+// inserting one statement renumbers every later one, in other files too.
+export function documentFacts(store, id) {
+    return JSON.stringify({
+        pathname: store.pathnameOf(id) ?? null,
+        macros: store.foldedMacros(id),
+        refs: store
+            .refsOf(id)
+            .map(({ resolver, written, target }) => [resolver, written, target])
+            .sort((a, b) => JSON.stringify(a).localeCompare(JSON.stringify(b))),
+        headings: (store.docs.get(id)?.headings ?? []).map(({ depth, title, slug }) => [
+            depth,
+            title,
+            slug,
+        ]),
+        inject: store.injection(id) ?? null,
+    });
+}
+export function allFacts(store) {
+    const facts = new Map();
+    for (const id of [...store.docs.keys()].sort())
+        facts.set(id, documentFacts(store, id));
+    return facts;
+}
+// Documents whose facts differ between two builds, including documents that
+// appeared or disappeared.
+export function diffFacts(before, after) {
+    const changed = [];
+    for (const [id, facts] of after)
+        if (before.get(id) !== facts)
+            changed.push(id);
+    for (const id of before.keys())
+        if (!after.has(id))
+            changed.push(id);
+    return changed;
+}
+//# sourceMappingURL=facts.js.map