@de-otio/bibcheck 0.1.0

package/dist/identifiers.js

@@ -0,0 +1,111 @@
+/**
+ * bibcheck identifiers — local, offline DOI / ISBN / URL well-formedness checks.
+ *
+ * A pure functional-core module: no I/O, all input passed as arguments. It runs
+ * BEFORE any network call and catches the large class of AI-fabricated citations
+ * that carry a malformed identifier (a transposed ISBN digit, a DOI with stray
+ * punctuation, a non-URL in `url:`) — the cheapest, highest-yield hallucination
+ * signal. Emits the `IdentifiersLayer` from the output schema.
+ *
+ * No runtime dependencies: ISBN check-digit validation and normalization are
+ * hand-rolled (both are small, well-specified algorithms).
+ */
+// ---------------------------------------------------------------------------
+// DOI
+// ---------------------------------------------------------------------------
+/** Matches a syntactically well-formed DOI after any resolver prefix is stripped. */
+const DOI_RE = /^10\.\d{4,}\/\S+$/i;
+/** Strip a leading resolver prefix (`https://doi.org/`, `http://dx.doi.org/`, `doi:`). */
+function stripDoiPrefix(doi) {
+    return doi
+        .trim()
+        .replace(/^https?:\/\/(dx\.)?doi\.org\//i, '')
+        .replace(/^doi:/i, '');
+}
+/** Validate a DOI string. */
+export function validateDoi(doi) {
+    return DOI_RE.test(stripDoiPrefix(doi)) ? 'ok' : 'malformed';
+}
+// ---------------------------------------------------------------------------
+// ISBN
+// ---------------------------------------------------------------------------
+/**
+ * Normalize an ISBN to its bare digit string (hyphens/spaces removed, upper-cased
+ * for a trailing `X`). Returns null when the input is not a 10- or 13-character
+ * ISBN shape. Exposed so callers (e.g. existence cache keys) can key on a
+ * canonical form rather than the raw, variably-hyphenated string.
+ */
+export function normalizeIsbn(raw) {
+    const stripped = raw.replace(/[\s-]/g, '').toUpperCase();
+    if (/^\d{9}[\dX]$/.test(stripped))
+        return stripped; // ISBN-10
+    if (/^\d{13}$/.test(stripped))
+        return stripped; // ISBN-13
+    return null;
+}
+/** True if a 10-char ISBN-10 string has a valid check digit. */
+function isbn10CheckOk(s) {
+    let sum = 0;
+    for (let i = 0; i < 9; i++) {
+        sum += (10 - i) * Number(s[i]);
+    }
+    const check = s[9] === 'X' ? 10 : Number(s[9]);
+    return (sum + check) % 11 === 0;
+}
+/** True if a 13-char ISBN-13 string has a valid check digit. */
+function isbn13CheckOk(s) {
+    let sum = 0;
+    for (let i = 0; i < 13; i++) {
+        sum += (i % 2 === 0 ? 1 : 3) * Number(s[i]);
+    }
+    return sum % 10 === 0;
+}
+/** Validate an ISBN string (10 or 13). */
+export function validateIsbn(isbn) {
+    const normalized = normalizeIsbn(isbn);
+    if (normalized === null)
+        return 'malformed';
+    const ok = normalized.length === 10 ? isbn10CheckOk(normalized) : isbn13CheckOk(normalized);
+    return ok ? 'ok' : 'bad-checksum';
+}
+// ---------------------------------------------------------------------------
+// URL
+// ---------------------------------------------------------------------------
+/** Validate that a string is a well-formed http/https URL. */
+export function validateUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return 'malformed';
+    }
+    return parsed.protocol === 'http:' || parsed.protocol === 'https:' ? 'ok' : 'malformed';
+}
+// ---------------------------------------------------------------------------
+// Per-entry layer + runner
+// ---------------------------------------------------------------------------
+/** True for a present, non-empty identifier string. */
+function present(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
+/** Compute the identifiers layer for one entry. */
+export function identifiersFor(entry) {
+    const doi = present(entry.doi) ? validateDoi(entry.doi) : 'not-applicable';
+    const isbn = present(entry.isbn) ? validateIsbn(entry.isbn) : 'not-applicable';
+    const url = present(entry.url) ? validateUrl(entry.url) : 'not-applicable';
+    return { doi, isbn, url };
+}
+/**
+ * Validate every entry's identifiers. Synchronous, deterministic, no I/O.
+ * Output order matches input order.
+ */
+export function runIdentifiers(deps) {
+    return {
+        entries: deps.bibliography.map((entry) => ({
+            citekey: entry.citekey,
+            identifiers: identifiersFor(entry),
+        })),
+    };
+}
+//# sourceMappingURL=identifiers.js.map

package/dist/identifiers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * bibcheck — humanities-aware citation verification for CSL-JSON bibliographies.
+ *
+ * Library entry point. Re-exports the output schema for programmatic consumers.
+ * For CLI use, see `cli.ts` and the `bibcheck` binary.
+ */
+export { SCHEMA_VERSION, ToolInfoSchema, SummarySchema, ExistenceCheckSourceSchema, ExistenceCheckResultSchema, ExistenceCheckSchema, ExistenceStatusSchema, ExistenceLayerSchema, CanonicalStatusSchema, CanonicalLayerSchema, EntrySchema, LinkageStatusSchema, LinkageReferenceSchema, LinkageEntrySchema, PhraseFlagStatusSchema, PhraseFlagSchema, WorklistItemTypeSchema, WorklistItemSchema, OutputSchema, } from './schema/output.js';
+export type { ToolInfo, Summary, ExistenceCheckSource, ExistenceCheckResult, ExistenceCheck, ExistenceStatus, ExistenceLayer, CanonicalStatus, CanonicalLayer, Entry, LinkageStatus, LinkageReference, LinkageEntry, PhraseFlagStatus, PhraseFlag, WorklistItemType, WorklistItem, Output, } from './schema/output.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":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,QAAQ,EACR,OAAO,EACP,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,KAAK,EACL,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,MAAM,GACP,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/**
+ * bibcheck — humanities-aware citation verification for CSL-JSON bibliographies.
+ *
+ * Library entry point. Re-exports the output schema for programmatic consumers.
+ * For CLI use, see `cli.ts` and the `bibcheck` binary.
+ */
+export { SCHEMA_VERSION, ToolInfoSchema, SummarySchema, ExistenceCheckSourceSchema, ExistenceCheckResultSchema, ExistenceCheckSchema, ExistenceStatusSchema, ExistenceLayerSchema, CanonicalStatusSchema, CanonicalLayerSchema, EntrySchema, LinkageStatusSchema, LinkageReferenceSchema, LinkageEntrySchema, PhraseFlagStatusSchema, PhraseFlagSchema, WorklistItemTypeSchema, WorklistItemSchema, OutputSchema, } from './schema/output.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;;;;;GAKG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAClB,YAAY,GACb,MAAM,oBAAoB,CAAC"}

package/dist/linkage.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Linkage subcommand: verify that every @citekey reference in the markdown
+ * documents resolves to an entry in the bibliography.
+ *
+ * For each citekey found in prose, emits a LinkageEntry with status
+ * 'resolved' or 'unresolved' and the full list of file:line references.
+ *
+ * Reverse linkage (H2): each bibliography citekey that is NEVER referenced in
+ * any doc is also emitted, with status 'orphan' and an empty `references`
+ * array. Orphans are INFORMATIONAL — an uncited bibliography entry is a smell
+ * (e.g. an LLM-padded reference list), not proof of fabrication — so they do
+ * NOT gate `bibcheck check`. They are excluded from `summary.linkageFailures`
+ * (which counts only 'unresolved'); see `summary.orphanedEntries`.
+ */
+import type { CslEntry } from './schema/csl.js';
+import type { LinkageEntry } from './schema/output.js';
+import type { Config } from './config.js';
+export interface RunLinkageDeps {
+    config: Config;
+    cwd: string;
+    bibliography: CslEntry[];
+    readFile: (path: string) => Promise<string>;
+    signal: AbortSignal;
+}
+export interface RunLinkageResult {
+    linkage: LinkageEntry[];
+}
+export declare function runLinkage(deps: RunLinkageDeps): Promise<RunLinkageResult>;
+//# sourceMappingURL=linkage.d.ts.map

package/dist/linkage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkage.d.ts","sourceRoot":"","sources":["../src/linkage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,QAAQ,EAAE,CAAC;IACzB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgEhF"}

package/dist/linkage.js

@@ -0,0 +1,73 @@
+/**
+ * Linkage subcommand: verify that every @citekey reference in the markdown
+ * documents resolves to an entry in the bibliography.
+ *
+ * For each citekey found in prose, emits a LinkageEntry with status
+ * 'resolved' or 'unresolved' and the full list of file:line references.
+ *
+ * Reverse linkage (H2): each bibliography citekey that is NEVER referenced in
+ * any doc is also emitted, with status 'orphan' and an empty `references`
+ * array. Orphans are INFORMATIONAL — an uncited bibliography entry is a smell
+ * (e.g. an LLM-padded reference list), not proof of fabrication — so they do
+ * NOT gate `bibcheck check`. They are excluded from `summary.linkageFailures`
+ * (which counts only 'unresolved'); see `summary.orphanedEntries`.
+ */
+import { discoverDocs } from './markdown/glob.js';
+import { extractCitekeys } from './markdown/citekeys.js';
+export async function runLinkage(deps) {
+    const { config, cwd, bibliography, readFile, signal } = deps;
+    // Step 1: Discover docs
+    const docs = await discoverDocs({
+        cwd,
+        include: config.docs.include,
+        exclude: config.docs.exclude,
+    });
+    // Step 2: Build bibliography citekey set
+    const bibKeys = new Set(bibliography.map((e) => e.citekey));
+    // Step 3: Process each doc, aggregate references by citekey
+    const referenceMap = new Map();
+    for (const doc of docs) {
+        if (signal.aborted) {
+            const err = new Error('runLinkage aborted');
+            err.name = 'AbortError';
+            throw err;
+        }
+        const content = await readFile(doc.path);
+        const citekeyRefs = extractCitekeys(content, doc.relativePath);
+        for (const ref of citekeyRefs) {
+            let refs = referenceMap.get(ref.citekey);
+            if (refs === undefined) {
+                refs = [];
+                referenceMap.set(ref.citekey, refs);
+            }
+            const linkRef = { file: ref.file, line: ref.line };
+            if (ref.locator !== null)
+                linkRef.locator = ref.locator;
+            if (ref.authorSuppressed)
+                linkRef.authorSuppressed = true;
+            refs.push(linkRef);
+        }
+    }
+    // Step 4: Build LinkageEntry array for every citekey referenced in prose.
+    const linkage = [];
+    for (const [citekey, references] of referenceMap) {
+        // Stable secondary sort: deterministic regardless of doc-discovery order.
+        references.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
+        linkage.push({
+            citekey,
+            status: bibKeys.has(citekey) ? 'resolved' : 'unresolved',
+            references,
+        });
+    }
+    // Step 5: Reverse linkage — emit an 'orphan' entry for every bibliography
+    // citekey that no doc referenced. Informational only; never gates.
+    for (const citekey of bibKeys) {
+        if (!referenceMap.has(citekey)) {
+            linkage.push({ citekey, status: 'orphan', references: [] });
+        }
+    }
+    // Step 6: Sort by citekey for deterministic output
+    linkage.sort((a, b) => a.citekey.localeCompare(b.citekey));
+    return { linkage };
+}
+//# sourceMappingURL=linkage.js.map

package/dist/linkage.js.map

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

package/dist/markdown/blocks.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Block extraction from markdown: blockquotes and direct (typographic) quotes.
+ *
+ * extractBlockquotes walks the mdast for blockquote nodes.
+ * extractDirectQuotes uses extractProseLines and searches each prose line
+ * for curly/typographic quote pairs or straight-quote pairs of length >= 4.
+ */
+export type Blockquote = {
+    text: string;
+    startLine: number;
+    endLine: number;
+};
+export type DirectQuote = {
+    text: string;
+    line: number;
+};
+export declare function extractBlockquotes(content: string): Blockquote[];
+export declare function extractDirectQuotes(content: string): DirectQuote[];
+//# sourceMappingURL=blocks.d.ts.map

package/dist/markdown/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/markdown/blocks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAmBhE;AAwBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAwBlE"}

package/dist/markdown/blocks.js

@@ -0,0 +1,69 @@
+/**
+ * Block extraction from markdown: blockquotes and direct (typographic) quotes.
+ *
+ * extractBlockquotes walks the mdast for blockquote nodes.
+ * extractDirectQuotes uses extractProseLines and searches each prose line
+ * for curly/typographic quote pairs or straight-quote pairs of length >= 4.
+ */
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import { toString as mdastToString } from 'mdast-util-to-string';
+import { extractProseLines } from './prose.js';
+export function extractBlockquotes(content) {
+    const tree = unified().use(remarkParse).parse(content);
+    const results = [];
+    for (const node of tree.children) {
+        if (node.type === 'blockquote') {
+            const bq = node;
+            const pos = bq.position;
+            if (pos !== undefined && pos !== null) {
+                results.push({
+                    text: mdastToString(bq),
+                    startLine: pos.start.line,
+                    endLine: pos.end.line,
+                });
+            }
+        }
+    }
+    return results;
+}
+// Opening typographic quote characters (Unicode):
+//   U+201C  LEFT DOUBLE QUOTATION MARK  "
+//   U+201E  DOUBLE LOW-9 QUOTATION MARK  „
+//   U+00AB  LEFT-POINTING DOUBLE ANGLE QUOTATION MARK  <<
+// Closing typographic quote characters (Unicode):
+//   U+201D  RIGHT DOUBLE QUOTATION MARK  "
+//   U+00BB  RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK  >>
+//
+// Negated inner class excludes both opening and closing curly quotes so the
+// match stops at the first closing typographic quote.
+//
+// Using \u escapes to avoid any editor/file-write smart-quote substitution.
+// eslint-disable-next-line no-misleading-character-class
+const TYPOGRAPHIC_RE = new RegExp('[“„«]([^“”„«»]{4,})[”»]', 'g');
+// Straight double-quote pairs: "..." where inner content is >= 4 chars.
+// Uses ASCII 0x22 for the quote characters — no smart-quote ambiguity.
+const STRAIGHT_RE = /"([^"]{4,})"/g;
+export function extractDirectQuotes(content) {
+    const proseLines = extractProseLines(content);
+    const results = [];
+    for (const { line, text } of proseLines) {
+        TYPOGRAPHIC_RE.lastIndex = 0;
+        let match;
+        while ((match = TYPOGRAPHIC_RE.exec(text)) !== null) {
+            const quoted = match[1];
+            if (quoted !== undefined) {
+                results.push({ text: quoted, line });
+            }
+        }
+        STRAIGHT_RE.lastIndex = 0;
+        while ((match = STRAIGHT_RE.exec(text)) !== null) {
+            const quoted = match[1];
+            if (quoted !== undefined) {
+                results.push({ text: quoted, line });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=blocks.js.map

package/dist/markdown/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../src/markdown/blocks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAa/C,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,CAAS,CAAC;IAC/D,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,MAAM,EAAE,GAAG,IAAuB,CAAC;YACnC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC;YACxB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACtC,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,aAAa,CAAC,EAAE,CAAC;oBACvB,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI;oBACzB,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI;iBACtB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,kDAAkD;AAClD,0CAA0C;AAC1C,2CAA2C;AAC3C,0DAA0D;AAC1D,kDAAkD;AAClD,2CAA2C;AAC3C,2DAA2D;AAC3D,EAAE;AACF,4EAA4E;AAC5E,sDAAsD;AACtD,EAAE;AACF,4EAA4E;AAC5E,yDAAyD;AACzD,MAAM,cAAc,GAAG,IAAI,MAAM,CAC/B,yBAAyB,EACzB,GAAG,CACJ,CAAC;AAEF,wEAAwE;AACxE,uEAAuE;AACvE,MAAM,WAAW,GAAG,eAAe,CAAC;AAEpC,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;QACxC,cAAc,CAAC,SAAS,GAAG,CAAC,CAAC;QAC7B,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,WAAW,CAAC,SAAS,GAAG,CAAC,CAAC;QAC1B,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/markdown/citekeys.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Citekey extraction from markdown prose.
+ *
+ * Uses extractProseLines to skip code blocks, inline code, and HTML, then
+ * parses Pandoc-style citations on each prose line. Handles:
+ *   - bracketed groups with multiple ;-separated items: `[@a; @b, pp. 33-35]`
+ *   - author-suppression: `-@key` / `[-@key]`
+ *   - locators (the suffix after a key within a bracket): `[@key, p. 42]`
+ *   - bare in-text citations: `@key`
+ *
+ * Hand-rolled (no citation-parser dependency). Locators are surfaced as the
+ * raw suffix string; page-range *validation* is out of scope.
+ */
+export type CitekeyReference = {
+    citekey: string;
+    file: string;
+    line: number;
+    locator: string | null;
+    authorSuppressed: boolean;
+};
+export declare function extractCitekeys(content: string, file: string): CitekeyReference[];
+//# sourceMappingURL=citekeys.d.ts.map

package/dist/markdown/citekeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"citekeys.d.ts","sourceRoot":"","sources":["../../src/markdown/citekeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAAC;AAkDF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAkDjF"}

package/dist/markdown/citekeys.js

@@ -0,0 +1,100 @@
+/**
+ * Citekey extraction from markdown prose.
+ *
+ * Uses extractProseLines to skip code blocks, inline code, and HTML, then
+ * parses Pandoc-style citations on each prose line. Handles:
+ *   - bracketed groups with multiple ;-separated items: `[@a; @b, pp. 33-35]`
+ *   - author-suppression: `-@key` / `[-@key]`
+ *   - locators (the suffix after a key within a bracket): `[@key, p. 42]`
+ *   - bare in-text citations: `@key`
+ *
+ * Hand-rolled (no citation-parser dependency). Locators are surfaced as the
+ * raw suffix string; page-range *validation* is out of scope.
+ */
+import { extractProseLines } from './prose.js';
+// Citekey grammar: starts with alpha/digit/underscore/colon; may contain dots
+// and hyphens internally; must end with an alphanumeric char, underscore, or
+// colon (trailing punctuation belongs to the surrounding sentence). Matches the
+// long-standing bibcheck/Pandoc behaviour.
+const KEY = '[a-zA-Z0-9_:][a-zA-Z0-9_:.-]*[a-zA-Z0-9_:]|[a-zA-Z0-9_:]';
+/** A citation token: optional author-suppression `-`, then `@`, then a key. */
+const CITE_TOKEN_RE = new RegExp(`(-?)@(${KEY})`, 'g');
+/** A bracketed group `[ ... ]`; the inner text is inspected for citations. */
+const BRACKET_RE = /\[([^\]]*)\]/g;
+/** Replace inline code spans (`` `...` ``) with equal-length blanks so their
+ *  contents are never parsed as citations. (prose.ts already strips fenced
+ *  code blocks and HTML; this covers inline spans within a prose line.) */
+function maskInlineCode(text) {
+    return text.replace(/`[^`\n]*`/g, (m) => ' '.repeat(m.length));
+}
+/** Strip a leading comma/whitespace and return the locator, or null if empty. */
+function extractLocator(suffix) {
+    const trimmed = suffix.replace(/^[\s,]+/, '').trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+/** Parse a single bracket item (e.g. `see @smith2020, pp. 33-35`). */
+function parseBracketItem(item, file, line, col) {
+    CITE_TOKEN_RE.lastIndex = 0;
+    const m = CITE_TOKEN_RE.exec(item);
+    if (m === null || m[2] === undefined)
+        return null;
+    const suffix = item.slice(m.index + m[0].length);
+    return {
+        citekey: m[2],
+        file,
+        line,
+        locator: extractLocator(suffix),
+        authorSuppressed: m[1] === '-',
+        col,
+    };
+}
+export function extractCitekeys(content, file) {
+    const proseLines = extractProseLines(content);
+    const results = [];
+    for (const { line, text: rawText } of proseLines) {
+        const text = maskInlineCode(rawText);
+        const lineRefs = [];
+        // 1. Bracketed citations. Record their spans so the bare-key pass below
+        //    does not double-count keys that live inside a bracket.
+        const spans = [];
+        BRACKET_RE.lastIndex = 0;
+        let bm;
+        while ((bm = BRACKET_RE.exec(text)) !== null) {
+            const inner = bm[1];
+            if (inner === undefined || !inner.includes('@'))
+                continue;
+            spans.push([bm.index, bm.index + bm[0].length]);
+            for (const rawItem of inner.split(';')) {
+                const ref = parseBracketItem(rawItem, file, line, bm.index);
+                if (ref !== null)
+                    lineRefs.push(ref);
+            }
+        }
+        // 2. Bare in-text citations, outside any bracket span.
+        let masked = text;
+        for (const [start, end] of spans) {
+            masked = masked.slice(0, start) + ' '.repeat(end - start) + masked.slice(end);
+        }
+        CITE_TOKEN_RE.lastIndex = 0;
+        let tm;
+        while ((tm = CITE_TOKEN_RE.exec(masked)) !== null) {
+            if (tm[2] === undefined)
+                continue;
+            lineRefs.push({
+                citekey: tm[2],
+                file,
+                line,
+                locator: null,
+                authorSuppressed: tm[1] === '-',
+                col: tm.index,
+            });
+        }
+        // Document order within the line.
+        lineRefs.sort((a, b) => a.col - b.col);
+        for (const { col: _col, ...ref } of lineRefs) {
+            results.push(ref);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=citekeys.js.map

package/dist/markdown/citekeys.js.map

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

package/dist/markdown/glob.d.ts

@@ -0,0 +1,18 @@
+/**
+ * File discovery using tinyglobby include/exclude patterns.
+ *
+ * Returns discovered markdown files as absolute paths with a relative path
+ * computed against the cwd. Results are sorted alphabetically by relativePath
+ * for deterministic ordering.
+ */
+export type DiscoverDocsOptions = {
+    cwd: string;
+    include: string[];
+    exclude?: string[];
+};
+export type DiscoveredDoc = {
+    path: string;
+    relativePath: string;
+};
+export declare function discoverDocs(opts: DiscoverDocsOptions): Promise<DiscoveredDoc[]>;
+//# sourceMappingURL=glob.d.ts.map

package/dist/markdown/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/markdown/glob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAsB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAkBtF"}

package/dist/markdown/glob.js

@@ -0,0 +1,26 @@
+/**
+ * File discovery using tinyglobby include/exclude patterns.
+ *
+ * Returns discovered markdown files as absolute paths with a relative path
+ * computed against the cwd. Results are sorted alphabetically by relativePath
+ * for deterministic ordering.
+ */
+import { glob } from 'tinyglobby';
+import { relative } from 'node:path';
+export async function discoverDocs(opts) {
+    if (opts.include.length === 0) {
+        return [];
+    }
+    const absolutePaths = await glob(opts.include, {
+        cwd: opts.cwd,
+        ignore: opts.exclude ?? [],
+        absolute: true,
+    });
+    const docs = absolutePaths.map((p) => ({
+        path: p,
+        relativePath: relative(opts.cwd, p),
+    }));
+    docs.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+    return docs;
+}
+//# sourceMappingURL=glob.js.map

package/dist/markdown/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/markdown/glob.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAarC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAyB;IAC1D,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;QAC7C,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;QAC1B,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,MAAM,IAAI,GAAoB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,IAAI,EAAE,CAAC;QACP,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;KACpC,CAAC,CAAC,CAAC;IAEJ,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/markdown/prose.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared helper: extract prose lines from markdown content.
+ *
+ * Parses the content via remark/unified to an mdast AST and walks the tree,
+ * skipping nodes whose content should not be treated as prose (code blocks,
+ * inline code, raw HTML, YAML/TOML front-matter). Returns one ProseLine per
+ * source line that contains prose, sorted and deduplicated by line number.
+ *
+ * YAML/TOML front-matter is stripped before AST parsing because remark-parse
+ * alone does not emit yaml/toml AST nodes — the remark-frontmatter plugin is
+ * required for that. Instead, we detect the standard --- / +++ delimiters
+ * manually and record which lines to exclude from the result.
+ */
+export type ProseLine = {
+    line: number;
+    text: string;
+};
+export declare function extractProseLines(content: string): ProseLine[];
+//# sourceMappingURL=prose.d.ts.map

package/dist/markdown/prose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.d.ts","sourceRoot":"","sources":["../../src/markdown/prose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AA6DF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAwB9D"}