paperlint 8.0.0 → 9.0.0

package/dist/eslint-rules/bib-reachable-entry.js

@@ -1,75 +0,0 @@
-/**
- * `bib/reachable-entry` — a bibliography entry a reader cannot follow: no doi, no url, no arXiv
- * id. Reported ON THE ENTRY, one finding per entry; there is no fix, because the link has to be
- * looked up. Default severity: warn.
- *
- * Provenance: Reviewer A on HotCRP #20 (2026-08-23), "not every entry has a DOI/link" — one
- * paper had 0 of 47 entries reachable. Until 3.0.0 this was one count inside `paper/typography`,
- * silenced per paper by a declared debt; now each entry is its own finding, and an entry that
- * genuinely has no link (a talk, a personal communication) carries a disable directive with its
- * reason, in the bibliography itself:
- *
- *   % eslint-disable-next-line bib/reachable-entry -- an invited talk, no recording exists
- *   @misc{smith2024talk, …}
- *
- * ⚠️ NOT "no doi". Measured 2026-08-24: ICLR/NeurIPS/TMLR issue no DOIs at all, so a doi-only
- * rule would demand something that does not exist and get muted for lying. A url or an arXiv id
- * counts.
- *
- * The bibliography read is the one INSIDE `paper.tex` (`filecontents`), where the papers this
- * package targets keep it. The entry boundaries and fields are found by a line-anchored `@` and
- * a field name followed by `=` — BibTeX's own lexical shape, one lexeme at a time, not a parse:
- * the parser (`@retorquere/bibtex-parser`) is an OPTIONAL peer of this package.
- */
-import { bibRange } from "./paper-typography.js";
-/** Entry types that are not references. */
-const NOT_AN_ENTRY = /^@(comment|string|preamble)\b/i;
-const HAS_LINK = /\b(doi|url)\s*=/i;
-const HAS_ARXIV = /arxiv[:\s]*\d{4}\.\d{4,5}/i;
-export default {
-    rules: {
-        "reachable-entry": {
-            meta: {
-                type: "suggestion",
-                docs: {
-                    description: "a bibliography entry carries a doi, a url or an arXiv id — something a reader can follow",
-                },
-                schema: [],
-                messages: {
-                    unreachable: "`{{key}}` has no doi, url or arXiv id — a reader has nothing to follow. If none exists, keep the exception with `% eslint-disable-next-line bib/reachable-entry -- <why>` above the entry",
-                },
-            },
-            create(context) {
-                return {
-                    "root:exit"() {
-                        const sc = context.sourceCode;
-                        const raw = sc.raw ?? sc.text;
-                        const bib = typeof raw === "string" ? bibRange(raw) : null;
-                        if (!bib)
-                            return;
-                        const starts = [...bib.body.matchAll(/^@/gm)].map((m) => m.index);
-                        starts.forEach((s, i) => {
-                            const entry = bib.body.slice(s, starts[i + 1] ?? bib.body.length);
-                            if (NOT_AN_ENTRY.test(entry))
-                                return;
-                            if (HAS_LINK.test(entry) || HAS_ARXIV.test(entry))
-                                return;
-                            const [head = ""] = entry.split("\n");
-                            const key = /\{\s*([^,\s]+)/.exec(head)?.[1] ?? "?";
-                            const from = bib.bodyStart + s;
-                            context.report({
-                                loc: {
-                                    start: sc.getLocFromIndex(from),
-                                    end: sc.getLocFromIndex(from + head.length),
-                                },
-                                messageId: "unreachable",
-                                data: { key },
-                            });
-                        });
-                    },
-                };
-            },
-        },
-    },
-};
-//# sourceMappingURL=bib-reachable-entry.js.map

package/dist/eslint-rules/bib-reachable-entry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bib-reachable-entry.js","sourceRoot":"","sources":["../../eslint-rules/bib-reachable-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,2CAA2C;AAC3C,MAAM,YAAY,GAAG,gCAAgC,CAAC;AACtD,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AACpC,MAAM,SAAS,GAAG,4BAA4B,CAAC;AAE/C,eAAe;IACb,KAAK,EAAE;QACL,iBAAiB,EAAE;YACjB,IAAI,EAAE;gBACJ,IAAI,EAAE,YAAqB;gBAC3B,IAAI,EAAE;oBACJ,WAAW,EACT,0FAA0F;iBAC7F;gBACD,MAAM,EAAE,EAAE;gBACV,QAAQ,EAAE;oBACR,WAAW,EACT,2LAA2L;iBAC9L;aACF;YACD,MAAM,CAAC,OAAoB;gBACzB,OAAO;oBACL,WAAW;wBACT,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;wBAC9B,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC;wBAC9B,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;wBAC3D,IAAI,CAAC,GAAG;4BAAE,OAAO;wBACjB,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;wBAClE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;4BACtB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;4BAClE,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC;gCAAE,OAAO;4BACrC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;gCAAE,OAAO;4BAC1D,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;4BACtC,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;4BACpD,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;4BAC/B,OAAO,CAAC,MAAM,CAAC;gCACb,GAAG,EAAE;oCACH,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;oCAC/B,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;iCAC5C;gCACD,SAAS,EAAE,aAAa;gCACxB,IAAI,EAAE,EAAE,GAAG,EAAE;6BACd,CAAC,CAAC;wBACL,CAAC,CAAC,CAAC;oBACL,CAAC;iBACF,CAAC;YACJ,CAAC;SACF;KACF;CACF,CAAC"}

package/eslint-rules/bib-reachable-entry.ts

@@ -1,76 +0,0 @@
-/**
- * `bib/reachable-entry` — a bibliography entry a reader cannot follow: no doi, no url, no arXiv
- * id. Reported ON THE ENTRY, one finding per entry; there is no fix, because the link has to be
- * looked up. Default severity: warn.
- *
- * Provenance: Reviewer A on HotCRP #20 (2026-08-23), "not every entry has a DOI/link" — one
- * paper had 0 of 47 entries reachable. Until 3.0.0 this was one count inside `paper/typography`,
- * silenced per paper by a declared debt; now each entry is its own finding, and an entry that
- * genuinely has no link (a talk, a personal communication) carries a disable directive with its
- * reason, in the bibliography itself:
- *
- *   % eslint-disable-next-line bib/reachable-entry -- an invited talk, no recording exists
- *   @misc{smith2024talk, …}
- *
- * ⚠️ NOT "no doi". Measured 2026-08-24: ICLR/NeurIPS/TMLR issue no DOIs at all, so a doi-only
- * rule would demand something that does not exist and get muted for lying. A url or an arXiv id
- * counts.
- *
- * The bibliography read is the one INSIDE `paper.tex` (`filecontents`), where the papers this
- * package targets keep it. The entry boundaries and fields are found by a line-anchored `@` and
- * a field name followed by `=` — BibTeX's own lexical shape, one lexeme at a time, not a parse:
- * the parser (`@retorquere/bibtex-parser`) is an OPTIONAL peer of this package.
- */
-import { bibRange } from "./paper-typography.ts";
-import type { RuleContext } from "./rule-context.ts";
-
-/** Entry types that are not references. */
-const NOT_AN_ENTRY = /^@(comment|string|preamble)\b/i;
-const HAS_LINK = /\b(doi|url)\s*=/i;
-const HAS_ARXIV = /arxiv[:\s]*\d{4}\.\d{4,5}/i;
-
-export default {
-  rules: {
-    "reachable-entry": {
-      meta: {
-        type: "suggestion" as const,
-        docs: {
-          description:
-            "a bibliography entry carries a doi, a url or an arXiv id — something a reader can follow",
-        },
-        schema: [],
-        messages: {
-          unreachable:
-            "`{{key}}` has no doi, url or arXiv id — a reader has nothing to follow. If none exists, keep the exception with `% eslint-disable-next-line bib/reachable-entry -- <why>` above the entry",
-        },
-      },
-      create(context: RuleContext) {
-        return {
-          "root:exit"() {
-            const sc = context.sourceCode;
-            const raw = sc.raw ?? sc.text;
-            const bib = typeof raw === "string" ? bibRange(raw) : null;
-            if (!bib) return;
-            const starts = [...bib.body.matchAll(/^@/gm)].map((m) => m.index);
-            starts.forEach((s, i) => {
-              const entry = bib.body.slice(s, starts[i + 1] ?? bib.body.length);
-              if (NOT_AN_ENTRY.test(entry)) return;
-              if (HAS_LINK.test(entry) || HAS_ARXIV.test(entry)) return;
-              const [head = ""] = entry.split("\n");
-              const key = /\{\s*([^,\s]+)/.exec(head)?.[1] ?? "?";
-              const from = bib.bodyStart + s;
-              context.report({
-                loc: {
-                  start: sc.getLocFromIndex(from),
-                  end: sc.getLocFromIndex(from + head.length),
-                },
-                messageId: "unreachable",
-                data: { key },
-              });
-            });
-          },
-        };
-      },
-    },
-  },
-};