@sister.software/oxlint-config 9.3.0 → 11.0.0

package/README.md

@@ -31,16 +31,43 @@ export default createOxlintConfig({
 
 ### Options
 
-| Option                  | Default                  | Purpose                                            |
-| ----------------------- | ------------------------ | -------------------------------------------------- |
-| `packageNamespace`      | `@sister.software`       | Namespace the runtime-boundary rules apply to.     |
-| `copyrightHolder`       | `Sister Software`        | `@copyright` value stamped into file headers.      |
-| `spdxLicenseIdentifier` | `UNLICENSED`             | `@license` value stamped into file headers.        |
-| `author`                | `Teffen Ellis, et al.`   | `@author` value stamped into file headers.         |
-| `react`                 | `false`                  | Enable oxlint's React plugin.                      |
-| `headers`               | `true`                   | Enforce file headers (error severity, auto-fixed). |
-| `ignorePatterns`        | build/output dirs        | Replace the default ignore list.                   |
-| `overrides`             | `{}`                     | Extra config merged last (escape hatch).           |
+| Option                   | Default                   | Purpose                                                     |
+| ------------------------ | ------------------------- | ----------------------------------------------------------- |
+| `packageNamespace`       | `@sister.software`        | Namespace the runtime-boundary rules apply to.              |
+| `copyrightHolder`        | `Sister Software`         | `@copyright` value stamped into file headers.               |
+| `spdxLicenseIdentifier`  | `UNLICENSED`              | `@license` value stamped into file headers.                 |
+| `author`                 | `Teffen Ellis, et al.`    | `@author` value stamped into file headers.                  |
+| `react`                  | `false`                   | Enable oxlint's React plugin.                               |
+| `headers`                | `true`                    | Enforce file headers (error severity, auto-fixed).          |
+| `padding`                | `true`                    | Blank line before `return`/block-like statements.           |
+| `consolePadding`         | `true`                    | Blank line on each side of a `console.*` call.               |
+| `multilineStatementPadding` | `true`                 | Blank line on each side of a multi-line statement.           |
+| `braces`                 | `true`                    | Braces around single-statement bodies.                      |
+| `restrictProcessGlobals` | `false`                   | Forbid direct `process.env` / `process.argv` access.        |
+| `limits`                 | calibrated defaults       | Override individual legibility ceilings.                    |
+| `testFilePatterns`       | `**/*.test.ts`, …         | Globs where the size and constant rules switch off.         |
+| `generatedFilePatterns`  | `**/*.gen.ts`, …          | Globs where only the size ceilings switch off.              |
+| `untypedFilePatterns`    | `**/*.js`, `**/*.mjs`, …  | Globs where the multi-line JSDoc requirement switches off.  |
+| `unnamedThresholds`      | `false`                   | Flag numeric literals used as comparison thresholds.        |
+| `constantDocs`           | `false`                   | Require JSDoc on exported / `SCREAMING_CASE` constants.     |
+| `lengthTruthiness`       | `true`                    | Rewrite explicit length comparisons to truthiness.          |
+| `multilineJSDoc`         | `true`                    | Require JSDoc blocks to span multiple lines.                |
+| `sectionMarkers`         | `true`                    | Enforce the banner → MARK → region → split ladder.          |
+| `ignorePatterns`         | build output, `.yarn`     | Replace the default ignore list.                            |
+| `overrides`              | `{}`                      | Extra config merged last (escape hatch).                    |
+
+`limits` takes any subset of the ceilings; unspecified keys keep their calibrated default:
+
+```ts
+createOxlintConfig({
+	spdxLicenseIdentifier: "AGPL-3.0",
+	limits: { maxStatements: 60, complexity: 40 },
+})
+```
+
+Generated files are exempt from the size ceilings only — every correctness rule still applies, because
+generated code ships. Point `generatedFilePatterns` at your own globs if they differ from the defaults
+(`**/*.gen.ts(x)`, `**/*.generated.ts`, `**/generated/**`).
 
 ## Features
 
@@ -62,3 +89,164 @@ files may not import Node built-ins at all.
 A bundled oxlint JS plugin (`sister-software/require-file-header`) reports and auto-fixes the
 `@copyright`/`@license`/`@author` header, preserving any other JSDoc tags already in the leading
 comment block. Run `oxlint --fix` to stamp headers.
+
+### Statement padding
+
+`padding-lines` (warn, autofixed) puts a blank line before the statements that end a path or a step —
+`return`, `continue`, `break`, a bare `x++`/`x--` — and before block-like statements. An `interface`,
+`type`, `enum` or `namespace` with a body counts as block-like: same braces, same weight on the page.
+
+`multiline-statement-padding` (warn, autofixed) puts one on each side of a statement that spans lines,
+so a reader sees where it starts and stops without matching brackets:
+
+```ts
+const canonical = {          const canonical = {
+	raw,                            raw,
+	source,                         source,
+}                     →      }
+const aligned = align()
+                             const aligned = align()
+```
+
+An exported declaration is padded exactly like the unexported form — both rules look through the
+`export` wrapper.
+
+Neither edge is required at a block boundary, where the brace already separates. `console.*` calls are
+left to the rule below, which groups consecutive ones — this one would split a run that happens to
+contain a tall call, and a run of output is one thing.
+
+### Console padding
+
+`console-padding` (warn, autofixed) puts a blank line on each side of a `console.*` call, so the lines
+that produce output stand apart from the lines that compute it:
+
+```ts
+const total = sum(stats)
+console.log(`${total} shards`)      const total = sum(stats)
+const headers = ["source"]
+console.log(headers)          →     console.log(`${total} shards`)
+
+                                    const headers = ["source"]
+
+                                    console.log(headers)
+```
+
+A RUN of calls is one group — no blank lines inside it, one before the first and one after the last,
+because consecutive calls are one block of output. Neither edge is required where a block boundary
+already separates them: nothing before a call that opens a block, nothing after one that closes it.
+
+### Section markers
+
+Four rules over the comments people use to carve a file into sections. They form one ladder, and each
+rung is a smaller file than the last:
+
+```ts
+// ---------------------------------------------------------------
+// Second section                     →  // MARK: Second section
+// ---------------------------------------------------------------
+```
+
+1. **`prefer-mark-comment`** (error, autofixed) — a `----` banner is three lines of decoration
+   carrying one label. It becomes `// MARK: <label>`, with a blank line on each side. A banner
+   wrapping more than one line of prose is reported but never collapsed — that prose is content.
+2. **`concise-section-marker`** (error) — a marker's label is a label, not a paragraph. Past
+   `maxBodyLength` (60), the detail belongs in the JSDoc of what it describes, or the file wants
+   splitting and an `@file` block.
+3. **`prefer-region-over-marks`** (warn) — past one marker, a file has sections, and sections have
+   ENDS. `//#region` / `//#endregion` fold, so a reader can collapse what they are not reading.
+4. **`max-regions`** (warn) — past `maxRegions` (10), the sections want to be files. Deliberately
+   high: four well-named regions are usually fine, and splitting can separate a type from its
+   helpers. This is a runaway detector, not a style nudge.
+
+Rungs 3 and 4 warn rather than error: where a section ends, and whether it should move, are judgment
+calls no fixer gets to make. Both switch off in test files, where the suite's shape is dictated by the
+code under test.
+
+```ts
+createOxlintConfig({ sectionMarkers: { maxBodyLength: 80, maxRegions: 6 } })
+```
+
+### Multi-line JSDoc
+
+`multiline-jsdoc` (error, autofixed) expands a one-line block:
+
+```ts
+/** The answer. */          →     /**
+                                   * The answer.
+                                   */
+```
+
+A one-line block reads as an aside; the multi-line form reads as documentation, and it leaves
+somewhere to put the second sentence. Only blocks that lead their line are rewritten — one sharing a
+line with code is a type cast, and expanding it changes what the line means. Off for
+`untypedFilePatterns`, where a JSDoc block often IS the type annotation.
+
+### Legibility tiers
+
+v10 turns on four tiers of upstream rules by default:
+
+1. **Structural guardrails** — nesting depth, function and file size, parameter count, cyclomatic
+   complexity. The numbers are ceilings, calibrated so considered code stays silent and runaway
+   generation does not. Tune them with `limits`.
+2. **Defect classes `correctness` misses** — import cycles, in-place `.sort()`/`.reverse()` on
+   arrays that may be shared, hook-order violations, `.then()` without a return, dead stores.
+3. **Test discipline** — the vitest plugin, including `expect-expect`, which catches a test that
+   runs, passes, and asserts nothing.
+4. **Mechanical hygiene** — literal form, import discipline, modern-API preference. All autofixable
+   via `oxlint --fix`.
+
+The design record lives in `docs/superpowers/specs/2026-07-28-oxlint-legibility-tiers-design.md`,
+including a register of the rules that were measured and **turned down**. Check it before enabling
+something that looks like an oversight — `no-magic-numbers` in particular is off on purpose, and
+`verify-fixtures.mjs` fails the build if it or eleven others are switched on.
+
+### Named thresholds and documented constants
+
+Two opt-in rules, complements rather than duplicates:
+
+- `unnamedThresholds` flags a number used as a comparison threshold — `if (entries.length > 12)`.
+  Numbers inside array and object literals are untouched, so a bounding box or a codepoint table
+  stays silent. Radix-prefixed literals are exempt by default: `cp >= 0x3040` already reads as a
+  codepoint boundary.
+- `constantDocs` requires a JSDoc block on module-level constants that are exported or
+  `SCREAMING_CASE` — the two signals that a constant is public surface or a tuning knob.
+  Function-valued constants are out of scope.
+
+The first says a threshold needs a name; the second says a name needs an explanation. A data table
+satisfies both by documenting the table, rather than extracting a constant per row.
+
+Write provenance in those blocks — what the value means and where it came from:
+
+```ts
+/** Entries above this count mean the surface is too ambiguous to disambiguate; set by the 2026-03 sweep. */
+const AMBIGUITY_CEILING = 12
+```
+
+Not `/** The ambiguity ceiling. */`, which leaves the reader exactly where they started.
+
+### Length checks
+
+The house convention is truthiness — `if (items.length)`, not `if (items.length > 0)`.
+`sister-software/prefer-length-truthiness` enforces it and autofixes, which is why
+`unicorn/explicit-length-check` (which enforces the opposite) is off.
+
+It only rewrites where the value is already coerced to a boolean — a condition, a ternary test, the
+operand of `!`, or a `&&`/`||` inside one of those. Elsewhere the comparison *is* the value, and
+rewriting it would change the type:
+
+```ts
+if (items.length > 0) { … }              // → if (items.length)
+if (items.length === 0) { … }            // → if (!items.length)
+const hasItems = items.length > 0        // untouched — this is a boolean, not a condition
+if (items.length === 2) { … }            // untouched — not an emptiness check
+```
+
+### Escape hatch
+
+Both rules, and every tier rule, take a scoped disable with a stated reason:
+
+```ts
+// oxlint-disable-next-line max-statements -- generated dispatch table; splitting it hides the shape.
+```
+
+Prefer that over a config-level exemption, which silently widens to every future file.

package/out/browser-globals.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The browser globals whose bare use is ambiguous, and the rule entry built from them. A list
+ *   this long is reference data — it belongs beside the code that consumes it, not inside the file
+ *   that assembles the platform-layering overrides.
+ */
+/**
+ * Browser globals whose bare use is ambiguous (they collide with common identifiers). Browser- and node-runtime files
+ * warn on these, nudging toward an explicit `window.` access.
+ */
+export declare const BROWSER_GLOBALS: readonly ["addEventListener", "blur", "close", "closed", "confirm", "defaultStatus", "defaultstatus", "event", "external", "find", "focus", "frameElement", "frames", "history", "innerHeight", "innerWidth", "length", "location", "locationbar", "menubar", "moveBy", "moveTo", "name", "onblur", "onerror", "onfocus", "onload", "onresize", "onunload", "open", "opener", "opera", "outerHeight", "outerWidth", "pageXOffset", "pageYOffset", "parent", "print", "removeEventListener", "resizeBy", "resizeTo", "screen", "screenLeft", "screenTop", "screenX", "screenY", "scroll", "scrollbars", "scrollBy", "scrollTo", "scrollX", "scrollY", "self", "status", "statusbar", "stop", "toolbar", "top"];
+export declare function restrictedBrowserGlobalsRule(): unknown;
+//# sourceMappingURL=browser-globals.d.ts.map

package/out/browser-globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-globals.d.ts","sourceRoot":"","sources":["../src/browser-globals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,+qBA2DlB,CAAA;AAEV,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD"}

package/out/browser-globals.js

@@ -0,0 +1,76 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The browser globals whose bare use is ambiguous, and the rule entry built from them. A list
+ *   this long is reference data — it belongs beside the code that consumes it, not inside the file
+ *   that assembles the platform-layering overrides.
+ */
+/**
+ * Browser globals whose bare use is ambiguous (they collide with common identifiers). Browser- and node-runtime files
+ * warn on these, nudging toward an explicit `window.` access.
+ */
+export const BROWSER_GLOBALS = [
+    "addEventListener",
+    "blur",
+    "close",
+    "closed",
+    "confirm",
+    "defaultStatus",
+    "defaultstatus",
+    "event",
+    "external",
+    "find",
+    "focus",
+    "frameElement",
+    "frames",
+    "history",
+    "innerHeight",
+    "innerWidth",
+    "length",
+    "location",
+    "locationbar",
+    "menubar",
+    "moveBy",
+    "moveTo",
+    "name",
+    "onblur",
+    "onerror",
+    "onfocus",
+    "onload",
+    "onresize",
+    "onunload",
+    "open",
+    "opener",
+    "opera",
+    "outerHeight",
+    "outerWidth",
+    "pageXOffset",
+    "pageYOffset",
+    "parent",
+    "print",
+    "removeEventListener",
+    "resizeBy",
+    "resizeTo",
+    "screen",
+    "screenLeft",
+    "screenTop",
+    "screenX",
+    "screenY",
+    "scroll",
+    "scrollbars",
+    "scrollBy",
+    "scrollTo",
+    "scrollX",
+    "scrollY",
+    "self",
+    "status",
+    "statusbar",
+    "stop",
+    "toolbar",
+    "top",
+];
+export function restrictedBrowserGlobalsRule() {
+    return ["warn", ...BROWSER_GLOBALS.map((name) => ({ name, message: `Ambiguous: did you mean \`window.${name}\`?` }))];
+}
+//# sourceMappingURL=browser-globals.js.map

package/out/browser-globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-globals.js","sourceRoot":"","sources":["../src/browser-globals.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,kBAAkB;IAClB,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,eAAe;IACf,eAAe;IACf,OAAO;IACP,UAAU;IACV,MAAM;IACN,OAAO;IACP,cAAc;IACd,QAAQ;IACR,SAAS;IACT,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,aAAa;IACb,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;IACR,UAAU;IACV,UAAU;IACV,MAAM;IACN,QAAQ;IACR,OAAO;IACP,aAAa;IACb,YAAY;IACZ,aAAa;IACb,aAAa;IACb,QAAQ;IACR,OAAO;IACP,qBAAqB;IACrB,UAAU;IACV,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,WAAW;IACX,SAAS;IACT,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,UAAU;IACV,UAAU;IACV,SAAS;IACT,SAAS;IACT,MAAM;IACN,QAAQ;IACR,WAAW;IACX,MAAM;IACN,SAAS;IACT,KAAK;CACI,CAAA;AAEV,MAAM,UAAU,4BAA4B;IAC3C,OAAO,CAAC,MAAM,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,oCAAoC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;AACtH,CAAC"}

package/out/console-padding-plugin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The `sister-software/console-padding` rule: a `console.*` call gets a blank line on each
+ *   side, so the lines that produce output stand apart from the lines that compute it. Scanning a
+ *   long procedural script for "what does this print" then works visually.
+ *
+ *   A RUN of console calls is one group — no blank lines inside it, one before the first and one
+ *   after the last, because consecutive calls are one block of output. Neither edge is required
+ *   where the block boundary already provides the separation: nothing is needed before a call that
+ *   opens a block, or after one that closes it.
+ */
+import type { Rule } from "./plugin-types.js";
+export declare const consolePaddingRule: Rule;
+//# sourceMappingURL=console-padding-plugin.d.ts.map

package/out/console-padding-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-padding-plugin.d.ts","sourceRoot":"","sources":["../src/console-padding-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAsBtD,eAAO,MAAM,kBAAkB,EAAE,IAsChC,CAAA"}

package/out/console-padding-plugin.js

@@ -0,0 +1,68 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file The `sister-software/console-padding` rule: a `console.*` call gets a blank line on each
+ *   side, so the lines that produce output stand apart from the lines that compute it. Scanning a
+ *   long procedural script for "what does this print" then works visually.
+ *
+ *   A RUN of console calls is one group — no blank lines inside it, one before the first and one
+ *   after the last, because consecutive calls are one block of output. Neither edge is required
+ *   where the block boundary already provides the separation: nothing is needed before a call that
+ *   opens a block, or after one that closes it.
+ */
+import { createPaddingHelpers } from "./padding-utils.js";
+/**
+ * The object whose method calls this rule treats as output.
+ */
+const CONSOLE_OBJECT = "console";
+/**
+ * Is this statement a bare `console.<method>(…)` call?
+ */
+function isConsoleStatement(node) {
+    if (node?.type !== "ExpressionStatement")
+        return false;
+    const call = node.expression;
+    if (call?.type !== "CallExpression")
+        return false;
+    const callee = call.callee;
+    return (callee?.type === "MemberExpression" && callee.object?.type === "Identifier" && callee.object.name === CONSOLE_OBJECT);
+}
+export const consolePaddingRule = {
+    meta: {
+        name: "console-padding",
+        type: "layout",
+        fixable: "whitespace",
+        schema: [{ type: "object", additionalProperties: true }],
+    },
+    create(context) {
+        const sourceCode = context.sourceCode ?? context.getSourceCode();
+        const text = sourceCode.getText();
+        const { requirePadding } = createPaddingHelpers(context);
+        return {
+            ExpressionStatement(node) {
+                if (!isConsoleStatement(node))
+                    return;
+                const parent = node.parent;
+                // Only statements in a statement list have neighbours to pad against.
+                if (!parent || !Array.isArray(parent.body))
+                    return;
+                const body = parent.body;
+                const index = body.indexOf(node);
+                if (index === -1)
+                    return;
+                const previous = body[index - 1];
+                const next = body[index + 1];
+                // Nothing before a call that opens the block, and nothing between calls in one run.
+                if (previous && !isConsoleStatement(previous)) {
+                    requirePadding(previous, node, node, "Expected a blank line before this console call.");
+                }
+                // Nothing after a call that closes the block — the brace already separates it.
+                if (next && !isConsoleStatement(next)) {
+                    requirePadding(node, next, node, "Expected a blank line after this console call.");
+                }
+            },
+        };
+    },
+};
+//# sourceMappingURL=console-padding-plugin.js.map

package/out/console-padding-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-padding-plugin.js","sourceRoot":"","sources":["../src/console-padding-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAGzD;;GAEG;AACH,MAAM,cAAc,GAAG,SAAS,CAAA;AAEhC;;GAEG;AACH,SAAS,kBAAkB,CAAC,IAAyB;IACpD,IAAI,IAAI,EAAE,IAAI,KAAK,qBAAqB;QAAE,OAAO,KAAK,CAAA;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAA;IAE5B,IAAI,IAAI,EAAE,IAAI,KAAK,gBAAgB;QAAE,OAAO,KAAK,CAAA;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAE1B,OAAO,CACN,MAAM,EAAE,IAAI,KAAK,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,KAAK,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,cAAc,CACpH,CAAA;AACF,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACvC,IAAI,EAAE;QACL,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,YAAY;QACrB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;KACxD;IACD,MAAM,CAAC,OAAO;QACb,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,aAAc,EAAE,CAAA;QACjE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,CAAA;QACjC,MAAM,EAAE,cAAc,EAAE,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAA;QAExD,OAAO;YACN,mBAAmB,CAAC,IAAa;gBAChC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC;oBAAE,OAAM;gBACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;gBAE1B,sEAAsE;gBACtE,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;oBAAE,OAAM;gBAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;gBACxB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBAEhC,IAAI,KAAK,KAAK,CAAC,CAAC;oBAAE,OAAM;gBACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;gBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;gBAE5B,oFAAoF;gBACpF,IAAI,QAAQ,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC/C,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,iDAAiD,CAAC,CAAA;gBACxF,CAAC;gBAED,+EAA+E;gBAC/E,IAAI,IAAI,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvC,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gDAAgD,CAAC,CAAA;gBACnF,CAAC;YACF,CAAC;SACD,CAAA;IACF,CAAC;CACD,CAAA"}

package/out/constant-doc-plugin.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file A require-constant-doc rule, authored as an oxlint JS plugin (ESLint v9-compatible API). A
+ *   module-level constant that is exported or SCREAMING_CASE is either public surface or a tuning
+ *   knob, and in both cases a reader needs to know what the value means and where it came from. A
+ *   documented table also answers for every number inside it, which is why data-heavy files satisfy
+ *   this rule without extracting a constant per row.
+ */
+import type { Rule } from "./plugin-types.js";
+/**
+ * Which module-level constants the rule applies to.
+ */
+export type ConstantDocScope = "exported" | "screaming" | "exported-or-screaming";
+/**
+ * Options accepted by {@link requireConstantDocRule}.
+ */
+export interface ConstantDocOptions {
+    /**
+     * Defaults to `"exported-or-screaming"`.
+     */
+    scope?: ConstantDocScope;
+    /**
+     * Export names a framework requires and gives meaning to, which a JSDoc block cannot improve on — Pastel's
+     * `description` (whose value IS the help text), a route module's `loader`, and so on.
+     */
+    ignoreNames?: string[];
+}
+export declare const requireConstantDocRule: Rule;
+export default requireConstantDocRule;
+//# sourceMappingURL=constant-doc-plugin.d.ts.map

package/out/constant-doc-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant-doc-plugin.d.ts","sourceRoot":"","sources":["../src/constant-doc-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAY7C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,WAAW,GAAG,uBAAuB,CAAA;AAEjF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,eAAO,MAAM,sBAAsB,EAAE,IA8EpC,CAAA;AAED,eAAe,sBAAsB,CAAA"}

package/out/constant-doc-plugin.js

@@ -0,0 +1,91 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file A require-constant-doc rule, authored as an oxlint JS plugin (ESLint v9-compatible API). A
+ *   module-level constant that is exported or SCREAMING_CASE is either public surface or a tuning
+ *   knob, and in both cases a reader needs to know what the value means and where it came from. A
+ *   documented table also answers for every number inside it, which is why data-heavy files satisfy
+ *   this rule without extracting a constant per row.
+ */
+/**
+ * Names in SCREAMING_SNAKE_CASE, the convention for a tuning knob.
+ */
+const SCREAMING_CASE = /^[A-Z][A-Z0-9_]*$/;
+/**
+ * Initializers that make the binding a function rather than a constant value.
+ */
+const FUNCTION_INITIALIZERS = new Set(["ArrowFunctionExpression", "FunctionExpression"]);
+export const requireConstantDocRule = {
+    meta: {
+        name: "require-constant-doc",
+        type: "suggestion",
+        schema: [{ type: "object", additionalProperties: true }],
+    },
+    create(context) {
+        const options = (context.options[0] ?? {});
+        const scope = options.scope ?? "exported-or-screaming";
+        const ignoreNames = new Set(options.ignoreNames);
+        const sourceCode = context.sourceCode ?? context.getSourceCode();
+        const text = sourceCode.getText();
+        const comments = sourceCode.getAllComments();
+        /**
+         * True when a JSDoc block documents the declaration starting at `start`.
+         *
+         * Attachment requires the comment to be directly above it — whitespace spanning a single newline. A blank line in
+         * between means the comment belongs to something else, which is what separates a declaration's own JSDoc from the
+         * file header block that precedes the first declaration in every file.
+         */
+        function hasJSDocBefore(start) {
+            for (const comment of comments) {
+                if (comment.range[1] > start)
+                    continue;
+                if (comment.type !== "Block" || !comment.value.startsWith("*"))
+                    continue;
+                const gap = text.slice(comment.range[1], start);
+                if (/^\s*$/.test(gap) && (gap.match(/\n/g) ?? []).length <= 1)
+                    return true;
+            }
+            return false;
+        }
+        function inScope(exported, screaming) {
+            if (scope === "exported")
+                return exported;
+            if (scope === "screaming")
+                return screaming;
+            return exported || screaming;
+        }
+        return {
+            VariableDeclaration(node) {
+                if (node.kind !== "const")
+                    return;
+                const exported = node.parent?.type === "ExportNamedDeclaration";
+                const container = exported ? node.parent : node;
+                // Module level only: the declaration (or its export wrapper) sits directly in Program.
+                if (container.parent?.type !== "Program")
+                    return;
+                if (hasJSDocBefore(container.range[0]))
+                    return;
+                for (const declarator of node.declarations ?? []) {
+                    const id = declarator.id;
+                    if (id?.type !== "Identifier" || !id.name)
+                        continue;
+                    if (ignoreNames.has(id.name))
+                        continue;
+                    const initializer = declarator.init;
+                    if (initializer && FUNCTION_INITIALIZERS.has(initializer.type))
+                        continue;
+                    if (!inScope(exported, SCREAMING_CASE.test(id.name)))
+                        continue;
+                    context.report({
+                        node: declarator,
+                        message: `\`${id.name}\` is ${exported ? "exported" : "a named constant"} but undocumented — add a ` +
+                            `JSDoc block saying what the value means and where it came from.`,
+                    });
+                }
+            },
+        };
+    },
+};
+export default requireConstantDocRule;
+//# sourceMappingURL=constant-doc-plugin.js.map

package/out/constant-doc-plugin.js.map

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

package/out/headers-plugin.d.ts

@@ -7,14 +7,18 @@
  *   while preserving any other JSDoc tags already present in the leading comment block.
  */
 import type { Plugin, Rule } from "./plugin-types.js";
-/** Options accepted by the header rule. */
+/**
+ * Options accepted by the header rule.
+ */
 export interface HeaderRuleOptions {
     copyrightHolder?: string;
     spdxLicenseIdentifier?: string;
     author?: string;
 }
 export declare const headerRule: Rule;
-/** The Sister Software oxlint header plugin. Registers the `sister-software/require-file-header` rule. */
+/**
+ * The Sister Software oxlint header plugin. Registers the `sister-software/require-file-header` rule.
+ */
 declare const headerPlugin: Plugin;
 export default headerPlugin;
 //# sourceMappingURL=headers-plugin.d.ts.map

package/out/headers-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"headers-plugin.d.ts","sourceRoot":"","sources":["../src/headers-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAW,MAAM,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE9D,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAeD,eAAO,MAAM,UAAU,EAAE,IAiExB,CAAA;AAED,0GAA0G;AAC1G,QAAA,MAAM,YAAY,EAAE,MAGnB,CAAA;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"headers-plugin.d.ts","sourceRoot":"","sources":["../src/headers-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAW,MAAM,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAeD,eAAO,MAAM,UAAU,EAAE,IAiExB,CAAA;AAED;;GAEG;AACH,QAAA,MAAM,YAAY,EAAE,MAGnB,CAAA;AAED,eAAe,YAAY,CAAA"}

package/out/headers-plugin.js

@@ -49,7 +49,7 @@ export const headerRule = {
                 if (leading) {
                     const existing = parseInnerLines(leading);
                     const missing = headerLines.filter((line) => !existing.includes(line));
-                    if (missing.length === 0)
+                    if (!missing.length)
                         return;
                     const preserved = existing.filter((line) => !HEADER_TAG_PATTERN.test(line));
                     const block = buildBlock(preserved);
@@ -76,7 +76,9 @@ export const headerRule = {
         };
     },
 };
-/** The Sister Software oxlint header plugin. Registers the `sister-software/require-file-header` rule. */
+/**
+ * The Sister Software oxlint header plugin. Registers the `sister-software/require-file-header` rule.
+ */
 const headerPlugin = {
     meta: { name: "sister-software" },
     rules: { "require-file-header": headerRule },

package/out/headers-plugin.js.map

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