@nielspeter/eess-md 0.8.0 → 0.10.0

package/dist/conditions/linked-back.d.ts

@@ -0,0 +1,17 @@
+import type { Condition } from '@nielspeter/eess';
+import type { Corpus } from '../corpus.js';
+import { type MdLink } from '../model/links.js';
+import { type LinkResolveOptions } from '../model/resolve-link.js';
+/**
+ * Condition (plan 0406): each link's target links back to the link's document.
+ * Any link back answers — several are one answer, and an incidental mention
+ * counts. The back-links are every internal link in the corpus, resolved with
+ * `resolveLink` and the same `options`, indexed on first evaluation.
+ *
+ * `examined` is the selected links: an empty selection fails with the
+ * zero-examined finding. A link that cannot answer — a frozen record, a file
+ * outside the corpus, a missing target — is one finding naming its cause, on
+ * the declaring link's line, with its remedy as the suggestion.
+ */
+export declare function linkedBack(corpus: Corpus, options?: LinkResolveOptions): Condition<MdLink>;
+//# sourceMappingURL=linked-back.d.ts.map

package/dist/conditions/linked-back.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-back.d.ts","sourceRoot":"","sources":["../../src/conditions/linked-back.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE7D,OAAO,EAIL,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAA;AAwFjC;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,SAAS,CAAC,MAAM,CAAC,CA8B9F"}

package/dist/conditions/linked-back.js

@@ -0,0 +1,122 @@
+import { collectLinks } from '../model/links.js';
+import { mdViolation } from '../model/violation.js';
+import { basenameIndex, movedLinkFix, resolveLink, } from '../model/resolve-link.js';
+/** Each document's repo path → the documents it links to, resolved as `options` resolves. */
+function linksFrom(corpus, options) {
+    const out = new Map();
+    for (const doc of corpus.documents()) {
+        const targets = new Set();
+        for (const link of collectLinks(doc.root, doc.text)) {
+            const target = resolveLink({ url: link.url, external: link.external, doc }, corpus, options);
+            if (target.kind === 'document')
+                targets.add(target.path);
+        }
+        out.set(doc.relPath, targets);
+    }
+    return out;
+}
+function unanswered(link, target) {
+    const source = link.doc.relPath;
+    switch (target.kind) {
+        case 'document':
+            return target.doc.frozen
+                ? {
+                    target: target.path,
+                    message: `${target.path} is frozen and cannot answer`,
+                    suggestion: `add .haveLiveTargets() to the rule, passing it the options you pass beLinkedBack(), or remove ${target.path} from the declaration`,
+                }
+                : {
+                    target: target.path,
+                    message: `${source} declares ${target.path}, and ${target.path} does not link back`,
+                    suggestion: `add a link to ${source} in ${target.path}, or remove ${target.path} from the declaration`,
+                };
+        case 'not-in-corpus': {
+            // One finding, for the reason whose remedy comes first: a file that is not a
+            // record is not fixed by widening the corpus.
+            if (target.reasons.includes('not-markdown')) {
+                return {
+                    target: target.path,
+                    message: `${target.path} is not a Markdown record`,
+                    suggestion: 'declare a record, not a file',
+                };
+            }
+            if (target.reasons.includes('ignored')) {
+                return {
+                    target: target.path,
+                    message: `${target.path} matches the corpus ignore option, so its links are not read`,
+                    suggestion: 'correct the link, or stop ignoring the path',
+                };
+            }
+            return {
+                target: target.path,
+                message: `${target.path} is outside the corpus, so its links are not read`,
+                suggestion: 'add its folder to the corpus roots, or correct the link',
+            };
+        }
+        case 'missing':
+            return {
+                target: link.url,
+                message: `${link.url} does not exist`,
+                suggestion: 'correct the link to the record it means — the same fix clears resolve()',
+            };
+        case 'directory':
+            return {
+                target: target.path,
+                message: `the link names a directory, ${target.path}, not a record`,
+                suggestion: "link the record's file",
+            };
+        case 'self':
+            return {
+                target: source,
+                message: 'the link points at this record',
+                suggestion: 'remove it; a record does not relate to itself',
+            };
+        case 'external':
+            return {
+                target: link.url,
+                message: `the declaration links outside the repository, to ${link.url}`,
+                suggestion: 'declare a record in the corpus',
+            };
+    }
+}
+/**
+ * Condition (plan 0406): each link's target links back to the link's document.
+ * Any link back answers — several are one answer, and an incidental mention
+ * counts. The back-links are every internal link in the corpus, resolved with
+ * `resolveLink` and the same `options`, indexed on first evaluation.
+ *
+ * `examined` is the selected links: an empty selection fails with the
+ * zero-examined finding. A link that cannot answer — a frozen record, a file
+ * outside the corpus, a missing target — is one finding naming its cause, on
+ * the declaring link's line, with its remedy as the suggestion.
+ */
+export function linkedBack(corpus, options = {}) {
+    let index;
+    let byBasename;
+    return {
+        description: 'be linked back by their targets',
+        evaluate: (links, ctx) => {
+            index ??= linksFrom(corpus, options);
+            const out = [];
+            for (const link of links) {
+                const target = resolveLink(link, corpus, options);
+                if (target.kind === 'document' && index.get(target.path)?.has(link.doc.relPath) === true) {
+                    continue;
+                }
+                const cause = unanswered(link, target);
+                byBasename ??= basenameIndex(corpus);
+                out.push(mdViolation({
+                    element: `${link.doc.relPath} → ${cause.target}`,
+                    file: link.doc.file,
+                    line: link.line,
+                    message: cause.message,
+                    sourceText: link.doc.text,
+                    fix: target.kind === 'missing' ? movedLinkFix(link, byBasename) : undefined,
+                    context: { ...ctx, suggestion: cause.suggestion },
+                }));
+            }
+            return out;
+        },
+    };
+}
+//# sourceMappingURL=linked-back.js.map

package/dist/conditions/linked-back.js.map

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

package/dist/conditions/resolve.d.ts

@@ -1,55 +1,23 @@
 import type { Condition } from '@nielspeter/eess';
 import type { Corpus } from '../corpus.js';
 import type { MdLink } from '../model/links.js';
+import { type LinkResolveOptions } from '../model/resolve-link.js';
 /**
  * Options for `linkResolves` — how a link URL is matched against the repo tree.
- * Covers static-site conventions (VitePress, Docusaurus, MkDocs, GitBook…)
- * generically instead of naming any tool: extensionless links resolve by
- * trying extensions and/or a directory index file.
+ * Defined beside `resolveLink` (`model/resolve-link.ts`), the one resolver both
+ * share (plan 0404); re-exported here so existing imports keep working.
  */
-export interface LinkResolveOptions {
-    /**
-     * Extensions to try when the URL as written doesn't resolve, e.g. `['.md']`
-     * for sites that link `./guide` meaning `./guide.md`. Tried in order.
-     */
-    readonly tryExtensions?: readonly string[];
-    /**
-     * Directory index filename to try, e.g. `'index.md'` for sites where
-     * `./guide/` (or `./guide`) means `./guide/index.md`.
-     */
-    readonly tryIndex?: string;
-    /**
-     * Content root for site-absolute links (leading `/`). Static-site generators
-     * resolve `/page` against the site's content root, not the repo root — e.g.
-     * `rootDir: 'docs'` makes `/guide` mean `docs/guide(.md)`. Repo-root
-     * resolution is still tried first, so plain repo-absolute links keep working.
-     */
-    readonly rootDir?: string;
-    /**
-     * Resolve a link naming a real directory (`./fixed/` or `./fixed`, with or
-     * without the trailing slash — both forms occur in this repo's own corpus)
-     * even when it has no index file. Correct for a repo-hosted corpus (GitHub,
-     * GitLab render a directory link as its listing); wrong for a static-site
-     * corpus where a bare directory is not itself a page — there, reach for
-     * {@link tryIndex} instead. Off by default: this widens what "resolves"
-     * means, and a link resolving that shouldn't is a false green, not a
-     * convenience. Default `false`.
-     *
-     * A link naming a real directory always wins over an unrelated typo — if
-     * `./foo` was meant as a deleted `foo.md` but a directory `foo/` happens to
-     * exist at that path, it resolves as the directory. Not a new failure mode:
-     * GitHub renders that link as the directory listing too, so this only
-     * closes the gap between the gate and what the link actually does when
-     * followed, it doesn't introduce a new way to be surprised by it.
-     */
-    readonly resolveDirectories?: boolean;
-}
+export type { LinkResolveOptions } from '../model/resolve-link.js';
 /**
  * Condition: every (internal) link resolves to a file in the corpus's repo tree.
  * Closes over the `Corpus` for the file index. External links and pure anchors
  * are skipped. `options` adds extensionless-link resolution (`tryExtensions`,
  * `tryIndex`) for static-site corpora, and directory resolution
  * (`resolveDirectories`) for repo-hosted ones.
+ *
+ * Resolution is `resolveLink`'s (plan 0404): this condition only decides which
+ * of its cases count as resolved — a loaded document, an existing file outside
+ * the corpus, and (with `resolveDirectories`) a directory.
  */
 export declare function linkResolves(corpus: Corpus, options?: LinkResolveOptions): Condition<MdLink>;
 //# sourceMappingURL=resolve.d.ts.map

package/dist/conditions/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/conditions/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAG/C;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CACtC;AA8DD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,SAAS,CAAC,MAAM,CAAC,CAyEhG"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/conditions/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAA;AAEjC;;;;GAIG;AACH,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAElE;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,SAAS,CAAC,MAAM,CAAC,CA+ChG"}

package/dist/conditions/resolve.js

@@ -1,125 +1,45 @@
-import { posix } from 'node:path';
 import { mdViolation } from '../model/violation.js';
-/**
- * Resolve an internal link's URL to its base repo-relative target(s), or `[]`
- * if it is a pure fragment (`#anchor`) or otherwise not a file reference.
- * Site-absolute links (leading `/`) yield the repo-root target plus, when
- * `rootDir` is set, the content-root target.
- */
-function resolveTargets(link, options) {
-    const withoutFragment = link.url.split('#')[0] ?? '';
-    if (withoutFragment === '')
-        return []; // same-document anchor
-    const decoded = decodeURIComponent(withoutFragment);
-    if (decoded.startsWith('/')) {
-        const repoRooted = posix.normalize(decoded.replace(/^\/+/, ''));
-        return options.rootDir !== undefined
-            ? [repoRooted, posix.normalize(posix.join(options.rootDir, repoRooted))]
-            : [repoRooted];
-    }
-    const base = posix.dirname(link.doc.relPath);
-    return [posix.normalize(posix.join(base, decoded))];
-}
-/** All repo-relative candidates for a target under the given options. */
-function candidates(target, options) {
-    const out = [target];
-    const bare = target.replace(/\/+$/, '');
-    for (const ext of options.tryExtensions ?? []) {
-        out.push(bare + ext);
-    }
-    if (options.tryIndex !== undefined) {
-        out.push(posix.join(bare, options.tryIndex));
-    }
-    return out;
-}
-/**
- * Every known directory reachable from `fileIndex`'s files, derived from it
- * rather than new I/O: each indexed file's ancestors are known directories.
- * `fileIndex` itself spans the whole physical repo walk from `cwd`, not just
- * the corpus's configured `roots` (`roots` only filters which files become
- * *documents* — see `corpus()`), so a directory link can resolve against
- * something outside any configured root. Built only when `resolveDirectories`
- * is on — the cost of a directory-shaped link resolving is opt-in, so is the
- * cost of computing it.
- *
- * The repo root itself (`.`) is deliberately excluded — `[root](/)` still
- * won't resolve even with the option on. Nobody links "the whole repo," and
- * `resolveTargets` never had a resolvable shape for it before this option
- * existed either.
- */
-function directoryIndex(corpus) {
-    const dirs = new Set();
-    for (const rel of corpus.fileIndex) {
-        let dir = posix.dirname(rel);
-        while (dir !== '.' && dir !== '/' && !dirs.has(dir)) {
-            dirs.add(dir);
-            dir = posix.dirname(dir);
-        }
-    }
-    return dirs;
-}
+import { basenameIndex, linkTargets, movedLinkFix, resolveLink, } from '../model/resolve-link.js';
 /**
  * Condition: every (internal) link resolves to a file in the corpus's repo tree.
  * Closes over the `Corpus` for the file index. External links and pure anchors
  * are skipped. `options` adds extensionless-link resolution (`tryExtensions`,
  * `tryIndex`) for static-site corpora, and directory resolution
  * (`resolveDirectories`) for repo-hosted ones.
+ *
+ * Resolution is `resolveLink`'s (plan 0404): this condition only decides which
+ * of its cases count as resolved — a loaded document, an existing file outside
+ * the corpus, and (with `resolveDirectories`) a directory.
  */
 export function linkResolves(corpus, options = {}) {
     // Basename → repo files, for finding a uniquely-moved target of a broken link.
-    const byBasename = new Map();
-    for (const rel of corpus.fileIndex) {
-        const base = rel.slice(rel.lastIndexOf('/') + 1);
-        const list = byBasename.get(base);
-        if (list)
-            list.push(rel);
-        else
-            byBasename.set(base, [rel]);
-    }
-    const dirIndex = options.resolveDirectories === true ? directoryIndex(corpus) : undefined;
-    // Bug 0137: a link that names a real directory and one that names nothing
-    // at all both reported the identical "does not resolve" message — no hint
-    // that `resolveDirectories` exists, or that this specific target would
-    // resolve with it on. Built lazily (at most once, memoized) rather than
-    // unconditionally alongside `dirIndex`, so the happy path (no violations)
-    // never pays for it, and only when `resolveDirectories` is already off —
-    // when it's on, a real directory already resolved above and can't reach
-    // this branch at all.
-    //
-    // A site-absolute link with `rootDir` set yields two candidates
-    // (repo-root, then content-root — see `resolveTargets`), and either can
-    // independently be a real directory. Reporting whichever comes first
-    // unlabelled can name the *wrong* one: a repo-root directory that happens
-    // to share a name with the intended content-root page sends the author to
-    // toggle `resolveDirectories`, which would resolve the unrelated
-    // repo-root directory, not fix their actual (still-missing) page. Labelled
-    // only when there are two candidates to disambiguate between — the common,
-    // single-target case (no `rootDir`) is unaffected.
-    let diagnosticDirIndex;
-    const directoryHint = (target, label) => {
-        diagnosticDirIndex ??= directoryIndex(corpus);
-        const bare = target.replace(/\/+$/, '');
-        return diagnosticDirIndex.has(bare)
-            ? ` — "${bare}"${label} is a real directory; this check runs with resolveDirectories off`
-            : '';
+    const byBasename = basenameIndex(corpus);
+    // Bug 0137: a link that names a real directory and one that names nothing at
+    // all both reported the identical "does not resolve" message — no hint that
+    // `resolveDirectories` exists, or that this specific target would resolve
+    // with it on. A site-absolute link with `rootDir` set has two candidates
+    // (repo-root, then content-root), and either can be a real directory.
+    // Reporting it unlabelled could name the *wrong* one: a repo-root directory
+    // sharing a name with the intended content-root page would send the author
+    // to toggle `resolveDirectories`, which resolves the unrelated directory, not
+    // their missing page. Labelled only when there are two candidates.
+    const directoryHint = (link, path) => {
+        const targets = linkTargets(link, options).map((t) => t.replace(/\/+$/, ''));
+        const label = targets.length > 1 ? (targets.indexOf(path) === 0 ? ' (repo-root)' : ' (content-root)') : '';
+        return ` — "${path}"${label} is a real directory; this check runs with resolveDirectories off`;
     };
     return {
         description: 'resolve to an existing file',
         evaluate: (links, ctx) => links.flatMap((link) => {
-            if (link.external)
-                return [];
-            const targets = resolveTargets(link, options);
-            if (targets.length === 0)
+            const target = resolveLink(link, corpus, options);
+            if (target.kind === 'external' ||
+                target.kind === 'self' ||
+                target.kind === 'document' ||
+                target.kind === 'not-in-corpus')
                 return [];
-            if (targets.some((t) => candidates(t, options).some((c) => corpus.fileIndex.has(c))))
+            if (target.kind === 'directory' && options.resolveDirectories === true)
                 return [];
-            if (dirIndex !== undefined && targets.some((t) => dirIndex.has(t.replace(/\/+$/, ''))))
-                return [];
-            const hint = options.resolveDirectories === true
-                ? ''
-                : (targets
-                    .map((t, i) => directoryHint(t, targets.length > 1 ? (i === 0 ? ' (repo-root)' : ' (content-root)') : ''))
-                    .find((h) => h) ?? '');
+            const hint = target.kind === 'directory' ? directoryHint(link, target.path) : '';
             return [
                 mdViolation({
                     element: `${link.doc.relPath} → ${link.url}`,
@@ -134,36 +54,4 @@ export function linkResolves(corpus, options = {}) {
         }),
     };
 }
-/**
- * If a broken link's basename uniquely names one file in the repo (the target
- * moved, not renamed), emit a deterministic autofix rewriting the URL to a path
- * relative to the linking document (plan 0066). Ambiguous basename, or a URL
- * whose exact span isn't known, → no fix.
- */
-function movedLinkFix(link, byBasename) {
-    if (link.urlStart === undefined || link.urlEnd === undefined)
-        return undefined;
-    const path = link.url.split('#')[0] ?? '';
-    const fragment = link.url.slice(path.length); // '' or '#anchor'
-    const base = path.slice(path.replace(/\/+$/, '').lastIndexOf('/') + 1);
-    const matches = byBasename.get(base) ?? [];
-    if (matches.length !== 1)
-        return undefined; // renamed (no match) or ambiguous → no fix
-    const target = matches[0];
-    if (target === undefined)
-        return undefined;
-    let rel = posix.relative(posix.dirname(link.doc.relPath), target);
-    if (!rel.startsWith('.'))
-        rel = './' + rel;
-    const replacement = rel + fragment;
-    if (replacement === link.url)
-        return undefined;
-    return {
-        file: link.doc.file,
-        start: link.urlStart,
-        end: link.urlEnd,
-        replacement,
-        describe: `rewrite link "${link.url}" → "${replacement}"`,
-    };
-}
 //# sourceMappingURL=resolve.js.map

package/dist/conditions/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/conditions/resolve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/conditions/resolve.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,WAAW,GAEZ,MAAM,0BAA0B,CAAA;AASjC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,UAA8B,EAAE;IAC3E,+EAA+E;IAC/E,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAExC,6EAA6E;IAC7E,4EAA4E;IAC5E,0EAA0E;IAC1E,yEAAyE;IACzE,sEAAsE;IACtE,4EAA4E;IAC5E,2EAA2E;IAC3E,8EAA8E;IAC9E,mEAAmE;IACnE,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,IAAY,EAAU,EAAE;QAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;QAC5E,MAAM,KAAK,GACT,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC9F,OAAO,OAAO,IAAI,IAAI,KAAK,mEAAmE,CAAA;IAChG,CAAC,CAAA;IAED,OAAO;QACL,WAAW,EAAE,6BAA6B;QAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CACvB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACrB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;YACjD,IACE,MAAM,CAAC,IAAI,KAAK,UAAU;gBAC1B,MAAM,CAAC,IAAI,KAAK,MAAM;gBACtB,MAAM,CAAC,IAAI,KAAK,UAAU;gBAC1B,MAAM,CAAC,IAAI,KAAK,eAAe;gBAE/B,OAAO,EAAE,CAAA;YACX,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,kBAAkB,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAA;YACjF,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YAChF,OAAO;gBACL,WAAW,CAAC;oBACV,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,MAAM,IAAI,CAAC,GAAG,EAAE;oBAC5C,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;oBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,OAAO,EAAE,iBAAiB,IAAI,CAAC,GAAG,2CAA2C,IAAI,EAAE;oBACnF,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI;oBACzB,GAAG,EAAE,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC;oBACnC,OAAO,EAAE,GAAG;iBACb,CAAC;aACH,CAAA;QACH,CAAC,CAAC;KACL,CAAA;AACH,CAAC"}

package/dist/corpus.d.ts

@@ -13,6 +13,9 @@ export interface CorpusOptions {
      * false (bug 0253): a frozen document's LINKS are still checked, and its code
      * pointers are excluded from `pointers().areLive()` — so they are not examined
      * at all. They are not "reported but never failed"; nothing reports them.
+     * A frozen record also cannot answer a declared relation: `links().haveLiveTargets()`
+     * drops a link into one, and `beLinkedBack()` reports it as frozen without it
+     * (plan 0406).
      *
      * Defaults to the near-universal `completed`/`archived`; extend for your
      * project's lifecycle folders (`delivered`, `wont-do`, …).

package/dist/corpus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../src/corpus.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,qFAAqF;IACrF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,4BAA4B;IAC5B,SAAS,IAAI,UAAU,EAAE,CAAA;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gGAAgG;IAChG,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACxC;AAKD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAwCrD"}
+{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../src/corpus.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAIpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,qFAAqF;IACrF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,4BAA4B;IAC5B,SAAS,IAAI,UAAU,EAAE,CAAA;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,gGAAgG;IAChG,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACxC;AAKD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAsCrD"}

package/dist/corpus.js

@@ -1,11 +1,10 @@
 import { walkFiles } from '@nielspeter/eess/internal';
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { fromMarkdown } from 'mdast-util-from-markdown';
-import { gfm } from 'micromark-extension-gfm';
-import { gfmFromMarkdown } from 'mdast-util-gfm';
 import picomatch from 'picomatch';
 import { buildDocument } from './model/document.js';
+import { parseMarkdown } from './model/prose.js';
+import { registerCorpusMatchers } from './model/resolve-link.js';
 const DEFAULT_FROZEN = ['**/completed/**', '**/archived/**'];
 const BUILTIN_IGNORE = ['node_modules', '.git', 'dist', 'coverage', '.output', '.nuxt', '.vercel'];
 /**
@@ -23,17 +22,12 @@ export function corpus(options) {
     const matchesFrozen = picomatch([...(options.frozen ?? DEFAULT_FROZEN)]);
     const matchesIgnore = options.ignore && options.ignore.length > 0 ? picomatch([...options.ignore]) : () => false;
     const fileIndex = new Set(allFiles);
-    const gfmExt = gfm();
-    const gfmMdast = gfmFromMarkdown();
     const documents = allFiles
         .filter((rel) => rel.endsWith('.md') && matchesRoot(rel) && !matchesIgnore(rel))
         .map((rel) => {
         const abs = join(root, rel);
         const text = readFileSync(abs, 'utf8');
-        const tree = fromMarkdown(text, {
-            extensions: [gfmExt],
-            mdastExtensions: [gfmMdast],
-        });
+        const tree = parseMarkdown(text);
         return buildDocument({
             file: abs,
             relPath: rel,
@@ -42,10 +36,13 @@ export function corpus(options) {
             root: tree,
         });
     });
-    return {
+    const loaded = {
         documents: () => documents,
         root,
         fileIndex,
     };
+    // Kept so `resolveLink` can say why an existing file was not loaded (plan 0404).
+    registerCorpusMatchers(loaded, { inRoots: matchesRoot, ignored: matchesIgnore });
+    return loaded;
 }
 //# sourceMappingURL=corpus.js.map

package/dist/corpus.js.map

@@ -1 +1 @@
-{"version":3,"file":"corpus.js","sourceRoot":"","sources":["../src/corpus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,SAAS,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,aAAa,EAAmB,MAAM,qBAAqB,CAAA;AA2CpE,MAAM,cAAc,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;AAC5D,MAAM,cAAc,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;AAElG;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,OAAsB;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IACzC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAA;IAE1C,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAA;IACxD,QAAQ,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAA;IAEhC,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IACjD,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,CAAA;IACxE,MAAM,aAAa,GACjB,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAA;IAE5F,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAA;IACnC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAA;IACpB,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAA;IAElC,MAAM,SAAS,GAAiB,QAAQ;SACrC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;SAC/E,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACtC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE;YAC9B,UAAU,EAAE,CAAC,MAAM,CAAC;YACpB,eAAe,EAAE,CAAC,QAAQ,CAAC;SAC5B,CAAC,CAAA;QACF,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,GAAG;YACZ,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC;YAC1B,IAAI;YACJ,IAAI,EAAE,IAAI;SACX,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEJ,OAAO;QACL,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;QAC1B,IAAI;QACJ,SAAS;KACV,CAAA;AACH,CAAC"}
+{"version":3,"file":"corpus.js","sourceRoot":"","sources":["../src/corpus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,SAAS,MAAM,WAAW,CAAA;AACjC,OAAO,EAAE,aAAa,EAAmB,MAAM,qBAAqB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AA8ChE,MAAM,cAAc,GAAG,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAA;AAC5D,MAAM,cAAc,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;AAElG;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,OAAsB;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IACzC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAA;IAE1C,MAAM,QAAQ,GAAa,EAAE,CAAA;IAC7B,MAAM,cAAc,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAA;IACxD,QAAQ,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAA;IAEhC,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;IACjD,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,CAAA;IACxE,MAAM,aAAa,GACjB,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAA;IAE5F,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAA;IAEnC,MAAM,SAAS,GAAiB,QAAQ;SACrC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;SAC/E,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC3B,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QACtC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO,aAAa,CAAC;YACnB,IAAI,EAAE,GAAG;YACT,OAAO,EAAE,GAAG;YACZ,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC;YAC1B,IAAI;YACJ,IAAI,EAAE,IAAI;SACX,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEJ,MAAM,MAAM,GAAW;QACrB,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;QAC1B,IAAI;QACJ,SAAS;KACV,CAAA;IACD,iFAAiF;IACjF,sBAAsB,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAA;IAChF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { corpus } from './corpus.js';
 export type { CorpusOptions, Corpus } from './corpus.js';
 export type { Predicate, Condition, ConditionContext, ArchFix, PresetReportOptions, PresetBaseOptions, } from '@nielspeter/eess';
-export { RuleBuilder, finishPreset, generateCodeFrame, not, dispatchRule, validateOverrides, reportViolations, isArchConfigError, } from '@nielspeter/eess';
+export { RuleBuilder, finishPreset, generateCodeFrame, not, dispatchRule, validateOverrides, reportViolations, isArchConfigError, ArchConfigError, } from '@nielspeter/eess';
 export { correspondence, CorrespondenceBuilder } from '@nielspeter/eess';
 export { collectResult, mergeCollectResults, hasEvidence } from '@nielspeter/eess';
 export type { CollectResult } from '@nielspeter/eess';
@@ -13,7 +13,10 @@ export type { ArchViolation } from './model/violation.js';
 export { docs, DocsRuleBuilder } from './builders/docs.js';
 export { links, LinkRuleBuilder } from './builders/links.js';
 export type { MdLink } from './builders/links.js';
+export type { MdLinkBlock } from './model/links.js';
 export type { LinkResolveOptions } from './conditions/resolve.js';
+export { resolveLink } from './model/resolve-link.js';
+export type { LinkTarget, LinkToResolve, NotInCorpusReason } from './model/resolve-link.js';
 export { pointers, PointerRuleBuilder } from './builders/pointers.js';
 export type { MdPointer } from './builders/pointers.js';
 export { presentExternalRoots } from './conditions/pointer-resolve.js';
@@ -24,6 +27,9 @@ export type { MdTaskItem } from './builders/task-items.js';
 export { collectTaskItems } from './model/task-items.js';
 export type { MdTaskItemRef } from './model/task-items.js';
 export { vocabulary, terms, TermRuleBuilder } from './builders/vocabulary.js';
+export { parseCodeBlocks, DEFAULT_CODE_BLOCK_BUDGET } from './model/code-block-parse.js';
+export type { CodeBlockVerdict, CodeBlockCanary, CodeBlockParser, CodeBlockBudget, ParseCodeBlocksOptions, ParsedCodeBlock, ParsedCodeBlocks, CodeBlockInstrumentFailure, NearMissTag, } from './model/code-block-parse.js';
+export { codeBlocks, CodeBlockRuleBuilder, CODE_BLOCK_PARSER_INSTRUMENT, } from './builders/code-blocks.js';
 export type { Vocabulary, VocabularyOptions, MdTerm, TermsOptions } from './builders/vocabulary.js';
 export { haveSection, haveTable } from './conditions/structure.js';
 export type { HaveTableOptions } from './conditions/structure.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAOxD,YAAY,EACV,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,GAAG,EACH,YAAY,EACZ,iBAAiB,EAMjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AASzB,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAOxE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAClF,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAMrD,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAGlF,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtF,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzD,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC5D,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AACrE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AACtE,YAAY,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC7E,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAGnG,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACpE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -12,7 +12,9 @@ export { RuleBuilder, finishPreset, generateCodeFrame, not, dispatchRule, valida
 // without throwing nor catch what the seam throws. ADR-008 names
 // `reportViolations` as the one emitter, and ADR-014's configuration findings
 // arrive as an `ArchConfigError` a caller has to recognise.
-reportViolations, isArchConfigError, } from '@nielspeter/eess';
+reportViolations, isArchConfigError, 
+// Bug 0284: `honestyAtClose` throws it for a half-declared vocabulary.
+ArchConfigError, } from '@nielspeter/eess';
 // `correspondence`/`CorrespondenceBuilder`: not touched by this package's
 // OWN source (so the family.rules.ts code-import scan can't see this gap —
 // review found it manually), but this README's own "Binding a spec table to
@@ -33,12 +35,16 @@ export { matchTableRows } from './model/rows.js';
 // Entry points
 export { docs, DocsRuleBuilder } from './builders/docs.js';
 export { links, LinkRuleBuilder } from './builders/links.js';
+export { resolveLink } from './model/resolve-link.js';
 export { pointers, PointerRuleBuilder } from './builders/pointers.js';
 export { presentExternalRoots } from './conditions/pointer-resolve.js';
 export { rows, RowsRuleBuilder } from './builders/rows.js';
 export { taskItems, TaskItemRuleBuilder } from './builders/task-items.js';
 export { collectTaskItems } from './model/task-items.js';
 export { vocabulary, terms, TermRuleBuilder } from './builders/vocabulary.js';
+// Plan 0412: a code block parses with the parser the caller names.
+export { parseCodeBlocks, DEFAULT_CODE_BLOCK_BUDGET } from './model/code-block-parse.js';
+export { codeBlocks, CodeBlockRuleBuilder, CODE_BLOCK_PARSER_INSTRUMENT, } from './builders/code-blocks.js';
 // Conditions (for composing custom rules / presets)
 export { haveSection, haveTable } from './conditions/structure.js';
 export { haveTableRowsSatisfying } from './conditions/table-rows.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,gFAAgF;AAChF,wCAAwC;AAExC,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAgBpC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,GAAG,EACH,YAAY,EACZ,iBAAiB;AACjB,4EAA4E;AAC5E,yEAAyE;AACzE,iEAAiE;AACjE,8EAA8E;AAC9E,4DAA4D;AAC5D,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,kBAAkB,CAAA;AACzB,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,+DAA+D;AAC/D,6EAA6E;AAC7E,qEAAqE;AACrE,2EAA2E;AAC3E,wBAAwB;AACxB,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACxE,6EAA6E;AAC7E,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,iFAAiF;AACjF,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAYlF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD,eAAe;AACf,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAG5D,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAErE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAG7E,oDAAoD;AACpD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,gFAAgF;AAChF,wCAAwC;AAExC,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAgBpC,OAAO,EACL,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,GAAG,EACH,YAAY,EACZ,iBAAiB;AACjB,4EAA4E;AAC5E,yEAAyE;AACzE,iEAAiE;AACjE,8EAA8E;AAC9E,4DAA4D;AAC5D,gBAAgB,EAChB,iBAAiB;AACjB,uEAAuE;AACvE,eAAe,GAChB,MAAM,kBAAkB,CAAA;AACzB,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,+DAA+D;AAC/D,6EAA6E;AAC7E,qEAAqE;AACrE,2EAA2E;AAC3E,wBAAwB;AACxB,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACxE,6EAA6E;AAC7E,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,iFAAiF;AACjF,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAYlF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGhD,eAAe;AACf,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAI5D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAErD,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAErE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC7E,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAYxF,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAA;AAGlC,oDAAoD;AACpD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA"}