@nielspeter/eess-md 0.1.0

package/dist/conditions/table-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-rows.js","sourceRoot":"","sources":["../../src/conditions/table-rows.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,cAAc,EAA+B,MAAM,kBAAkB,CAAA;AAkB9E;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA0B;IAChE,OAAO;QACL,WAAW,EAAE,8CAA8C;QAC3D,QAAQ,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAC3B,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CACxB,cAAc,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC,OAAO,CACpF,CAAC,GAAG,EAAE,EAAE,CACN,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,WAAW,CAAC;YACV,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,QAAQ,GAAG,CAAC,GAAG;YACpG,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI;YACpB,OAAO;YACP,UAAU,EAAE,GAAG,CAAC,IAAI;YACpB,OAAO,EAAE,GAAG;SACb,CAAC,CACH,CACJ,CACF;KACJ,CAAA;AACH,CAAC"}

package/dist/corpus.d.ts

@@ -0,0 +1,40 @@
+import { type MdDocument } from './model/document.js';
+/**
+ * Configuration for a markdown corpus.
+ */
+export interface CorpusOptions {
+    /** Globs (repo-relative, POSIX) selecting the markdown files to load, e.g. `['docs/**']`. */
+    readonly roots: readonly string[];
+    /**
+     * Globs marking frozen folders — historical records whose drift is reported
+     * but never failed. Defaults to the near-universal `completed`/`archived`;
+     * extend for your project's lifecycle folders (`delivered`, `wont-do`, …).
+     */
+    readonly frozen?: readonly string[];
+    /**
+     * Directories/globs never walked (build output, deps, VCS). Merged with a
+     * built-in set (`node_modules`, `.git`, `dist`, `coverage`).
+     */
+    readonly ignore?: readonly string[];
+    /** Repo root the globs and pointers resolve against. Defaults to `process.cwd()`. */
+    readonly cwd?: string;
+}
+/**
+ * A loaded markdown corpus — the "project" handle passed to `docs()`, `links()`,
+ * and `pointers()`. Analogous to `project()` (TS) and `diagram()` (Mermaid).
+ */
+export interface Corpus {
+    /** All loaded documents. */
+    documents(): MdDocument[];
+    /** Repo root the corpus resolves against. */
+    readonly root: string;
+    /** Every file path under the repo root (repo-relative, POSIX) — for pointer/link resolution. */
+    readonly fileIndex: ReadonlySet<string>;
+}
+/**
+ * Load a markdown corpus. Walks `roots` from `cwd`, parses each `.md` file with
+ * GFM enabled, and records frozen membership per file. The full repo file tree
+ * is indexed so later phases can resolve code pointers and cross-links.
+ */
+export declare function corpus(options: CorpusOptions): Corpus;
+//# sourceMappingURL=corpus.d.ts.map

package/dist/corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../src/corpus.ts"],"names":[],"mappings":"AAMA,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;;;;OAIG;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;AA4BD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAuCrD"}

package/dist/corpus.js

@@ -0,0 +1,73 @@
+import { readFileSync, readdirSync } from 'node:fs';
+import { join, relative, sep } 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';
+const DEFAULT_FROZEN = ['**/completed/**', '**/archived/**'];
+const BUILTIN_IGNORE = ['node_modules', '.git', 'dist', 'coverage', '.output', '.nuxt', '.vercel'];
+function toPosix(p) {
+    return sep === '/' ? p : p.split(sep).join('/');
+}
+function walk(dir, root, ignoreDirs, acc) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        void err; // unreadable dir (permissions, dangling symlink) — deliberately skipped
+        return;
+    }
+    for (const e of entries) {
+        const abs = join(dir, e.name);
+        if (e.isDirectory()) {
+            if (ignoreDirs.has(e.name))
+                continue;
+            walk(abs, root, ignoreDirs, acc);
+        }
+        else if (e.isFile()) {
+            acc.push(toPosix(relative(root, abs)));
+        }
+    }
+}
+/**
+ * Load a markdown corpus. Walks `roots` from `cwd`, parses each `.md` file with
+ * GFM enabled, and records frozen membership per file. The full repo file tree
+ * is indexed so later phases can resolve code pointers and cross-links.
+ */
+export function corpus(options) {
+    const root = options.cwd ?? process.cwd();
+    const ignoreDirs = new Set(BUILTIN_IGNORE);
+    const allFiles = [];
+    walk(root, root, ignoreDirs, allFiles);
+    const matchesRoot = picomatch([...options.roots]);
+    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],
+        });
+        return buildDocument({
+            file: abs,
+            relPath: rel,
+            frozen: matchesFrozen(rel),
+            text,
+            root: tree,
+        });
+    });
+    return {
+        documents: () => documents,
+        root,
+        fileIndex,
+    };
+}
+//# sourceMappingURL=corpus.js.map

package/dist/corpus.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { corpus } from './corpus.js';
+export type { CorpusOptions, Corpus } from './corpus.js';
+export type { MdDocument, MdSection, MdTable, MdCodeBlock } from './model/document.js';
+export type { MdRow, ColumnSpec, RowMatchOptions, RowMatchMode } from './model/rows.js';
+export { matchTableRows } from './model/rows.js';
+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 { LinkResolveOptions } from './conditions/resolve.js';
+export { pointers, PointerRuleBuilder } from './builders/pointers.js';
+export type { MdPointer } from './builders/pointers.js';
+export { presentExternalRoots } from './conditions/pointer-resolve.js';
+export type { PointerResolveOptions } from './conditions/pointer-resolve.js';
+export { rows, RowsRuleBuilder } from './builders/rows.js';
+export { taskItems, TaskItemRuleBuilder } from './builders/task-items.js';
+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 type { Vocabulary, VocabularyOptions, MdTerm, TermsOptions } from './builders/vocabulary.js';
+export { haveSection, haveTable } from './conditions/structure.js';
+export type { HaveTableOptions } from './conditions/structure.js';
+export { haveTableRowsSatisfying } from './conditions/table-rows.js';
+export type { HaveTableRowsOptions, TableRowContext } from './conditions/table-rows.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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;AAGxD,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"}

package/dist/index.js

@@ -0,0 +1,22 @@
+// @nielspeter/eess-md — the Markdown dialect of the eess family.
+//
+// Validates a repo's markdown corpus against the shared @nielspeter/eess kernel:
+// documents have the sections/tables they should, cross-links resolve, and code
+// pointers ground against real files. The opinionated ADR gate ships separately
+// from `@nielspeter/eess-md/rules/adr`.
+// Corpus loader
+export { corpus } from './corpus.js';
+export { matchTableRows } from './model/rows.js';
+// Entry points
+export { docs, DocsRuleBuilder } from './builders/docs.js';
+export { links, LinkRuleBuilder } from './builders/links.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';
+// Conditions (for composing custom rules / presets)
+export { haveSection, haveTable } from './conditions/structure.js';
+export { haveTableRowsSatisfying } from './conditions/table-rows.js';
+//# 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,iEAAiE;AACjE,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,gFAAgF;AAChF,wCAAwC;AAExC,gBAAgB;AAChB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAMpC,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"}

package/dist/model/document.d.ts

@@ -0,0 +1,78 @@
+import type { Root } from 'mdast';
+/**
+ * A heading in a markdown document.
+ */
+export interface MdSection {
+    /** Heading text, e.g. "Enforcement" */
+    readonly name: string;
+    /** Heading level (1 = `#`, 2 = `##`, …) */
+    readonly depth: number;
+    /** 1-based line where the heading starts */
+    readonly line: number;
+}
+/**
+ * A GFM table in a markdown document.
+ */
+export interface MdTable {
+    /** Header cell texts, trimmed */
+    readonly header: readonly string[];
+    /** Body rows, each an array of trimmed cell texts */
+    readonly rows: readonly (readonly string[])[];
+    /**
+     * 1-based source line of each body row, parallel to `rows` (real mdast
+     * positions, not derived — the file:line a diagnostic points at must be
+     * exact). `rowLines[i]` is the line of `rows[i]`.
+     */
+    readonly rowLines: readonly number[];
+    /** 1-based line where the table starts */
+    readonly line: number;
+    /** Names of the enclosing headings, outermost first (nearest section is last) */
+    readonly sectionPath: readonly string[];
+}
+/** A fenced code block in a markdown document. */
+export interface MdCodeBlock {
+    /** The info-string language, e.g. `mermaid`, `typescript`, or `null`. */
+    readonly lang: string | null;
+    /** The block's contents. */
+    readonly value: string;
+    /** 1-based line where the fence starts. */
+    readonly line: number;
+}
+/**
+ * One markdown document in the corpus — the element type of `docs()`.
+ *
+ * The underlying mdast `Root` is exposed for advanced use, but the dialect's
+ * own abstractions (`sections`, `tables`, and — in later phases — links and
+ * pointers) are the intended surface.
+ */
+export interface MdDocument {
+    /** Absolute file path */
+    readonly file: string;
+    /** Repo-relative path (POSIX separators), e.g. `docs/adr/0001-x.md` */
+    readonly relPath: string;
+    /** In a frozen folder — historical record; drift is reported, never failed */
+    readonly frozen: boolean;
+    /** Raw source text */
+    readonly text: string;
+    readonly sections: readonly MdSection[];
+    readonly tables: readonly MdTable[];
+    /** Fenced code blocks (e.g. embedded `mermaid` diagrams). */
+    readonly codeBlocks: readonly MdCodeBlock[];
+    /** mdast root (internal / advanced) */
+    readonly root: Root;
+}
+/**
+ * Build an `MdDocument` from a parsed mdast `Root`.
+ *
+ * Walks top-level nodes once, collecting headings (as sections) and GFM tables.
+ * Tables record the heading path they sit under so a rule can scope to
+ * "the table in the `## Enforcement` section".
+ */
+export declare function buildDocument(args: {
+    file: string;
+    relPath: string;
+    frozen: boolean;
+    text: string;
+    root: Root;
+}): MdDocument;
+//# sourceMappingURL=document.d.ts.map

package/dist/model/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/model/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAe,MAAM,OAAO,CAAA;AAE9C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAA;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,sBAAsB;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;IACnC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,SAAS,WAAW,EAAE,CAAA;IAC3C,uCAAuC;IACvC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CACpB;AAsBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,IAAI,CAAA;CACX,GAAG,UAAU,CAwCb"}

package/dist/model/document.js

@@ -0,0 +1,68 @@
+/**
+ * Recursively concatenate the text content of an mdast node. Inline code keeps
+ * its backticks, because a backtick-delimited `path.ts` or `it('…')` inside a
+ * table cell is a meaningful code citation, not plain prose.
+ */
+function nodeText(node) {
+    if (node.type === 'inlineCode' && typeof node.value === 'string') {
+        return '`' + node.value + '`';
+    }
+    if ('value' in node && typeof node.value === 'string')
+        return node.value;
+    if ('children' in node && Array.isArray(node.children)) {
+        return node.children.map((c) => nodeText(c)).join('');
+    }
+    return '';
+}
+function lineOf(node) {
+    return node.position?.start.line ?? 0;
+}
+/**
+ * Build an `MdDocument` from a parsed mdast `Root`.
+ *
+ * Walks top-level nodes once, collecting headings (as sections) and GFM tables.
+ * Tables record the heading path they sit under so a rule can scope to
+ * "the table in the `## Enforcement` section".
+ */
+export function buildDocument(args) {
+    const sections = [];
+    const tables = [];
+    const codeBlocks = [];
+    // Running heading stack: index i holds the current heading at depth i+1.
+    const headingStack = [];
+    for (const node of args.root.children) {
+        if (node.type === 'heading') {
+            const name = nodeText(node).trim();
+            sections.push({ name, depth: node.depth, line: lineOf(node) });
+            headingStack.length = node.depth - 1;
+            headingStack[node.depth - 1] = name;
+        }
+        else if (node.type === 'table') {
+            const rowsText = node.children.map((row) => row.children.map((cell) => nodeText(cell).trim()));
+            const [header = [], ...rows] = rowsText;
+            // Real per-row source lines (header row excluded), parallel to `rows`.
+            const rowLines = node.children.slice(1).map((row) => lineOf(row));
+            tables.push({
+                header,
+                rows,
+                rowLines,
+                line: lineOf(node),
+                sectionPath: headingStack.filter((h) => h !== undefined),
+            });
+        }
+        else if (node.type === 'code') {
+            codeBlocks.push({ lang: node.lang ?? null, value: node.value, line: lineOf(node) });
+        }
+    }
+    return {
+        file: args.file,
+        relPath: args.relPath,
+        frozen: args.frozen,
+        text: args.text,
+        sections,
+        tables,
+        codeBlocks,
+        root: args.root,
+    };
+}
+//# sourceMappingURL=document.js.map

package/dist/model/document.js.map

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

package/dist/model/links.d.ts

@@ -0,0 +1,32 @@
+import type { Root } from 'mdast';
+import type { MdDocument } from './document.js';
+/** A markdown link occurrence within a document (before doc back-reference). */
+export interface MdLinkRef {
+    /** Raw URL as written, e.g. `./other.md#section` or `https://example.com`. */
+    readonly url: string;
+    /** Link text. */
+    readonly text: string;
+    /** 1-based line in the source document. */
+    readonly line: number;
+    /** True for `scheme:` / protocol-relative URLs (http, https, mailto, //…). */
+    readonly external: boolean;
+    /**
+     * Char offset span of the URL within the document source, for autofix
+     * (plan 0066). Present only when the URL is locatable in the raw source
+     * (plain paths; percent-encoded/entity URLs may be absent) — a fix is emitted
+     * only when the exact span is known.
+     */
+    readonly urlStart?: number;
+    readonly urlEnd?: number;
+}
+/**
+ * Collect inline markdown links (`[text](url)`) from a document tree. Links
+ * inside fenced code are not parsed as `link` nodes by mdast, so they are
+ * naturally excluded.
+ */
+export declare function collectLinks(root: Root, source?: string): MdLinkRef[];
+/** A link with its owning document attached — the element the builders and conditions operate on. */
+export interface MdLink extends MdLinkRef {
+    readonly doc: MdDocument;
+}
+//# sourceMappingURL=links.d.ts.map

package/dist/model/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/model/links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAS,MAAM,OAAO,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAWD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAoCrE;AAED,qGAAqG;AACrG,MAAM,WAAW,MAAO,SAAQ,SAAS;IACvC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;CACzB"}

package/dist/model/links.js

@@ -0,0 +1,53 @@
+// A URL is external if it has a scheme (`https:`, `mailto:`) or is protocol-relative.
+const EXTERNAL_RE = /^([a-z][a-z0-9+.-]*:|\/\/)/i;
+function textOf(node) {
+    if ('value' in node && typeof node.value === 'string')
+        return node.value;
+    if ('children' in node)
+        return node.children.map((c) => textOf(c)).join('');
+    return '';
+}
+/**
+ * Collect inline markdown links (`[text](url)`) from a document tree. Links
+ * inside fenced code are not parsed as `link` nodes by mdast, so they are
+ * naturally excluded.
+ */
+export function collectLinks(root, source) {
+    const out = [];
+    const visit = (node) => {
+        if (node.type === 'link') {
+            // Locate the URL's exact char span in the source (for autofix). The link
+            // node's raw text is `[text](url …)`; the URL is the last occurrence of
+            // `node.url` within it (a URL in the link text would come earlier). If the
+            // source form differs from the decoded `node.url`, leave the span absent —
+            // no fix is emitted without an exact span.
+            let urlStart;
+            let urlEnd;
+            const startOff = node.position?.start.offset;
+            const endOff = node.position?.end.offset;
+            if (source !== undefined && startOff !== undefined && endOff !== undefined) {
+                const raw = source.slice(startOff, endOff);
+                const rel = raw.lastIndexOf(node.url);
+                if (rel >= 0) {
+                    urlStart = startOff + rel;
+                    urlEnd = urlStart + node.url.length;
+                }
+            }
+            out.push({
+                url: node.url,
+                text: textOf(node),
+                line: node.position?.start.line ?? 0,
+                external: EXTERNAL_RE.test(node.url),
+                urlStart,
+                urlEnd,
+            });
+        }
+        if ('children' in node) {
+            for (const child of node.children)
+                visit(child);
+        }
+    };
+    visit(root);
+    return out;
+}
+//# sourceMappingURL=links.js.map

package/dist/model/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/model/links.ts"],"names":[],"mappings":"AAuBA,sFAAsF;AACtF,MAAM,WAAW,GAAG,6BAA6B,CAAA;AAEjD,SAAS,MAAM,CAAC,IAAW;IACzB,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,KAAK,CAAA;IACxE,IAAI,UAAU,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC3E,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,MAAe;IACtD,MAAM,GAAG,GAAgB,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAG,CAAC,IAAW,EAAQ,EAAE;QAClC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,yEAAyE;YACzE,wEAAwE;YACxE,2EAA2E;YAC3E,2EAA2E;YAC3E,2CAA2C;YAC3C,IAAI,QAA4B,CAAA;YAChC,IAAI,MAA0B,CAAA;YAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAA;YAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAA;YACxC,IAAI,MAAM,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC3E,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;gBAC1C,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACrC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;oBACb,QAAQ,GAAG,QAAQ,GAAG,GAAG,CAAA;oBACzB,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAA;gBACrC,CAAC;YACH,CAAC;YACD,GAAG,CAAC,IAAI,CAAC;gBACP,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;gBACpC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;gBACpC,QAAQ;gBACR,MAAM;aACP,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;gBAAE,KAAK,CAAC,KAAK,CAAC,CAAA;QACjD,CAAC;IACH,CAAC,CAAA;IACD,KAAK,CAAC,IAAI,CAAC,CAAA;IACX,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/model/pointers.d.ts

@@ -0,0 +1,29 @@
+import type { Root } from 'mdast';
+import type { MdDocument } from './document.js';
+/** A `path.ext:line[-end]` code pointer occurrence within a document. */
+export interface MdPointerRef {
+    /** The cited path, e.g. `server/routers/admin.ts` or `[id].vue`. */
+    readonly path: string;
+    /** First referenced code line. */
+    readonly startLine: number;
+    /** Last referenced code line (== startLine when no range). */
+    readonly endLine: number;
+    /** Verbatim pointer text, e.g. `admin.ts:493-495`. */
+    readonly raw: string;
+    /** 1-based line in the source document where the pointer appears. */
+    readonly line: number;
+    /** Char offset span of the `path` portion within the document source (for autofix, plan 0066). */
+    readonly pathStart: number;
+    readonly pathEnd: number;
+}
+/**
+ * Extract code pointers from a document. Pointers inside fenced/indented code
+ * are ignored (illustrative, not live claims); pointers in prose and inline
+ * code are collected.
+ */
+export declare function extractPointers(text: string, root: Root): MdPointerRef[];
+/** A pointer with its owning document attached — the element the builders and conditions operate on. */
+export interface MdPointer extends MdPointerRef {
+    readonly doc: MdDocument;
+}
+//# sourceMappingURL=pointers.d.ts.map

package/dist/model/pointers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointers.d.ts","sourceRoot":"","sources":["../../src/model/pointers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAS,MAAM,OAAO,CAAA;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kGAAkG;IAClG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AA4BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,YAAY,EAAE,CAkCxE;AAED,wGAAwG;AACxG,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;CACzB"}

package/dist/model/pointers.js

@@ -0,0 +1,65 @@
+/** Code file extensions a pointer may target — web stack plus the JVM/legacy
+ * languages an external-root traceability matrix cites (plan 0069 Phase 5). */
+const CODE_EXT = 'ts|tsx|js|mjs|cjs|vue|json|sql|sh|ya?ml|groovy|java|kt|kts|cs|py|rb|go|rs|php';
+// `path.ext:line` or `path.ext:start-end`. Path class includes `[` `]` so Nuxt
+// dynamic routes like `[id].vue` match. Backticks aren't in the class, so
+// `` `admin.ts:493` `` delimits naturally.
+const POINTER_RE = new RegExp(String.raw `([A-Za-z0-9_./\[\]-]+\.(?:${CODE_EXT})):(\d+)(?:-(\d+))?`, 'g');
+/** Line ranges [start,end] of fenced/indented code blocks (inline code kept). */
+function fencedRanges(root) {
+    const ranges = [];
+    const visit = (node) => {
+        if (node.type === 'code' && node.position) {
+            ranges.push([node.position.start.line, node.position.end.line]);
+        }
+        if ('children' in node) {
+            for (const child of node.children)
+                visit(child);
+        }
+    };
+    visit(root);
+    return ranges;
+}
+/**
+ * Extract code pointers from a document. Pointers inside fenced/indented code
+ * are ignored (illustrative, not live claims); pointers in prose and inline
+ * code are collected.
+ */
+export function extractPointers(text, root) {
+    const ranges = fencedRanges(root);
+    const inFence = (line) => ranges.some(([s, e]) => line >= s && line <= e);
+    const out = [];
+    const lines = text.split('\n');
+    let lineStartOffset = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const lineNo = i + 1;
+        const lineText = lines[i];
+        if (lineText === undefined)
+            continue;
+        if (!inFence(lineNo)) {
+            for (const m of lineText.matchAll(POINTER_RE)) {
+                const path = m[1];
+                const startStr = m[2];
+                if (path === undefined || startStr === undefined || m.index === undefined)
+                    continue;
+                const startLine = Number(startStr);
+                const endLine = m[3] !== undefined ? Number(m[3]) : startLine;
+                // The match begins with the path (group 1), so its doc offset is the
+                // line's start offset plus the match index.
+                const pathStart = lineStartOffset + m.index;
+                out.push({
+                    path,
+                    startLine,
+                    endLine,
+                    raw: m[0],
+                    line: lineNo,
+                    pathStart,
+                    pathEnd: pathStart + path.length,
+                });
+            }
+        }
+        lineStartOffset += lineText.length + 1; // + the '\n'
+    }
+    return out;
+}
+//# sourceMappingURL=pointers.js.map

package/dist/model/pointers.js.map

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

package/dist/model/query.d.ts

@@ -0,0 +1,6 @@
+import type { MdDocument, MdTable } from './document.js';
+/** Does the document have a heading matching `name`? */
+export declare function hasSection(doc: MdDocument, name: string | RegExp): boolean;
+/** Is the table under a heading matching `section` (or is no section required)? */
+export declare function tableInSection(table: MdTable, section?: string | RegExp): boolean;
+//# sourceMappingURL=query.d.ts.map

package/dist/model/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/model/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAOxD,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAE1E;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAGjF"}

package/dist/model/query.js

@@ -0,0 +1,15 @@
+/** Match a string against a name matcher (exact string or regex). */
+function matchName(value, name) {
+    return typeof name === 'string' ? value === name : name.test(value);
+}
+/** Does the document have a heading matching `name`? */
+export function hasSection(doc, name) {
+    return doc.sections.some((s) => matchName(s.name, name));
+}
+/** Is the table under a heading matching `section` (or is no section required)? */
+export function tableInSection(table, section) {
+    if (section === undefined)
+        return true;
+    return table.sectionPath.some((h) => matchName(h, section));
+}
+//# sourceMappingURL=query.js.map

package/dist/model/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/model/query.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,SAAS,SAAS,CAAC,KAAa,EAAE,IAAqB;IACrD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACrE,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,GAAe,EAAE,IAAqB;IAC/D,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,OAAyB;IACtE,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACtC,OAAO,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;AAC7D,CAAC"}

package/dist/model/rows.d.ts

@@ -0,0 +1,52 @@
+import type { MdDocument, MdTable } from './document.js';
+/**
+ * A single body row of a GFM table, as a first-class element.
+ *
+ * This is the element type of the `rows()` entry point and the context passed
+ * to `haveTableRowsSatisfying`'s row validator — one type, two consumers. A row
+ * carries its located-column accessor (`get`), its real source line, and back
+ * references to the document and table it came from.
+ */
+export interface MdRow {
+    /** The row's cells, trimmed. */
+    readonly cells: readonly string[];
+    /** Cell text for a located column role (`''` if the role's column wasn't found). */
+    readonly get: (role: string) => string;
+    /** 0-based data-row index within its table (header excluded). */
+    readonly rowIndex: number;
+    /** 1-based source line of this row — the exact file:line for diagnostics. */
+    readonly line: number;
+    /** The document this row belongs to. */
+    readonly doc: MdDocument;
+    /** The table this row belongs to. */
+    readonly table: MdTable;
+}
+/** How role names map to header-column patterns. Every role must be present. */
+export type ColumnSpec = Readonly<Record<string, RegExp>>;
+/** Options shared by `rows()` and `haveTableRowsSatisfying`. */
+export interface RowMatchOptions {
+    /** Restrict to tables under a heading matching this. */
+    readonly section?: string | RegExp;
+    /**
+     * role → header pattern. A table participates only if its header matches
+     * every pattern; the row's `get(role)` then reads the located cell.
+     */
+    readonly columns: ColumnSpec;
+}
+/**
+ * How many matching tables to draw rows from:
+ * - `all` (default) — every matching table contributes rows. A correspondence
+ *   source (`rows()`) must not silently ignore a second matching table.
+ * - `first` — only the first matching table, preserving the historical
+ *   `haveTableRowsSatisfying` semantics.
+ */
+export type RowMatchMode = 'all' | 'first';
+/**
+ * Extract table rows as first-class `MdRow` elements.
+ *
+ * Finds the tables in the document that sit under the requested section (if
+ * any) and have all the requested columns (`mode` decides all vs. first), then
+ * yields one `MdRow` per body row with its real source line.
+ */
+export declare function matchTableRows(doc: MdDocument, opts: RowMatchOptions, mode?: RowMatchMode): MdRow[];
+//# sourceMappingURL=rows.d.ts.map