@sister.software/oxlint-config 9.3.0 → 10.0.0

package/out/index.js

@@ -6,7 +6,54 @@
  */
 import { createRuntimeOverrides } from "./restrictions.js";
 export * from "./restrictions.js";
-/** Default ignore patterns for generated/build output. */
+/**
+ * Calibrated against the mailwoman corpus (1,048 non-test source files). Each value sits just past the knee in that
+ * repo's distribution, so considered human code stays silent and runaway generation does not. See the design spec for
+ * the full sweep.
+ *
+ * The four SIZE ceilings are deliberately looser than the knee. Adopting v10 surfaced 172 pre-existing violations, and
+ * splitting that many functions across a parser — with no accuracy gate available to verify the result — is a larger
+ * risk than the legibility it buys. They are set at the p90 of the measured overage instead, so the worst decile had to
+ * be fixed at adoption while the body was grandfathered:
+ *
+ *     max-statements          n=88  median= 73  p90= 115  max= 272
+ *     complexity              n=32  median= 49  p90=  84  max= 173
+ *     max-lines-per-function  n=26  median=283  p90= 829  max=1329
+ *     max-params              n=15  median=  7  p90=   8  max=  10
+ *
+ * RATCHET THESE DOWN as the grandfathered functions are split. They exist to stop new code drifting, and every step
+ * toward the knee makes them do more of that job.
+ */
+export const DefaultLimits = {
+    maxDepth: 5,
+    maxParams: 8,
+    maxStatements: 115,
+    maxLinesPerFunction: 830,
+    maxLines: 750,
+    maxNestedCallbacks: 4,
+    maxNestedCalls: 4,
+    complexity: 85,
+};
+/** Globs treated as test files, where the size and named-constant rules are switched off. */
+export const DefaultTestFilePatterns = [
+    "**/*.test.ts",
+    "**/*.test.tsx",
+    "**/test/**",
+    "**/fixtures/**",
+    "**/*.bench.ts",
+    // Storybook stories are fixtures in the same sense: each export is a rendered case, and its NAME is
+    // the label shown in the sidebar. A JSDoc block on `export const Default: Story = {}` says nothing
+    // the name does not.
+    "**/*.stories.ts",
+    "**/*.stories.tsx",
+];
+/**
+ * Globs whose contents are emitted by a generator, not written by hand. The size ceilings are meaningless there — the
+ * file is as long as its input is wide, and no reviewer reads it top to bottom — but every correctness rule still
+ * applies, because generated code ships.
+ */
+export const DefaultGeneratedFilePatterns = ["**/*.gen.ts", "**/*.gen.tsx", "**/*.generated.ts", "**/generated/**"];
+/** Default ignore patterns for generated/build output and vendored tooling. */
 export const DefaultIgnorePatterns = [
     "**/out",
     "**/dist",
@@ -14,6 +61,9 @@ export const DefaultIgnorePatterns = [
     "**/node_modules",
     "**/coverage",
     "**/storybook-static",
+    // Yarn 4 vendors its own release bundle and plugin code here. It is third-party, minified, and
+    // not ours to lint — Tier 2's `no-abusive-eslint-disable` fires on it otherwise.
+    "**/.yarn/**",
 ];
 /**
  * Builds the complete oxlint configuration for a Sister Software package.
@@ -30,14 +80,14 @@ export const DefaultIgnorePatterns = [
  * @returns A complete oxlint config object (no `extends` required).
  */
 export function createOxlintConfig(options = {}) {
-    const { packageNamespace = "@sister.software", copyrightHolder = "Sister Software", spdxLicenseIdentifier = "UNLICENSED", author = "Teffen Ellis, et al.", react = false, headers = true, padding = true, braces = true, restrictProcessGlobals = false, ignorePatterns = DefaultIgnorePatterns, overrides = {}, } = options;
-    const plugins = ["typescript", "unicorn", "oxc", ...(react ? ["react"] : [])];
+    const { packageNamespace = "@sister.software", copyrightHolder = "Sister Software", spdxLicenseIdentifier = "UNLICENSED", author = "Teffen Ellis, et al.", react = false, headers = true, padding = true, braces = true, restrictProcessGlobals = false, unnamedThresholds = false, constantDocs = false, lengthTruthiness = true, limits: limitOverrides = {}, testFilePatterns = DefaultTestFilePatterns, generatedFilePatterns = DefaultGeneratedFilePatterns, ignorePatterns = DefaultIgnorePatterns, overrides = {}, } = options;
+    const limits = { ...DefaultLimits, ...limitOverrides };
+    const plugins = ["typescript", "unicorn", "oxc", "import", "promise", "vitest", ...(react ? ["react"] : [])];
     const rules = {
         // JavaScript
         eqeqeq: ["error", "always", { null: "ignore" }],
         "prefer-const": "warn",
         "object-shorthand": ["warn", "always"],
-        "no-shadow": "off",
         "no-undef": "off",
         "no-unused-vars": [
             "warn",
@@ -62,7 +112,186 @@ export function createOxlintConfig(options = {}) {
         "typescript/no-non-null-assertion": "off",
         "typescript/no-var-requires": "off",
         "typescript/no-require-imports": "off",
+        // Tier 1 — legibility guardrails. Thresholds are ceilings past the knee of the calibration
+        // corpus's distribution: they stay silent on considered code and fire on runaway generation.
+        "max-depth": ["error", { max: limits.maxDepth }],
+        "max-params": ["error", { max: limits.maxParams }],
+        "max-statements": ["error", { max: limits.maxStatements }],
+        "max-lines-per-function": ["error", { max: limits.maxLinesPerFunction, skipBlankLines: true, skipComments: true }],
+        "max-lines": ["error", { max: limits.maxLines, skipBlankLines: true, skipComments: true }],
+        "max-nested-callbacks": ["error", { max: limits.maxNestedCallbacks }],
+        "unicorn/max-nested-calls": ["error", { max: limits.maxNestedCalls }],
+        complexity: ["error", limits.complexity],
+        "unicorn/no-array-reduce": "error",
+        "unicorn/no-unreadable-array-destructuring": "error",
+        // Tier 2 — defect classes that `correctness` does not cover. Every rule here corresponds to a
+        // way working-looking code is wrong at runtime.
+        "no-shadow": "error",
+        "no-promise-executor-return": "error",
+        "no-useless-assignment": "error",
+        "no-unreachable-loop": "error",
+        "no-unmodified-loop-condition": "error",
+        "no-loop-func": "error",
+        // `.sort()` and `.reverse()` mutate in place; on a shared or cached array that is a bug at a
+        // distance. The fixes are `toSorted()` / `toReversed()`.
+        "unicorn/no-array-sort": "error",
+        "unicorn/no-array-reverse": "error",
+        "unicorn/no-immediate-mutation": "error",
+        "unicorn/no-array-method-this-argument": "error",
+        "unicorn/no-typeof-undefined": "error",
+        "unicorn/no-useless-promise-resolve-reject": "error",
+        "unicorn/prefer-type-error": "error",
+        // Global `isNaN` coerces its argument; `Number.isNaN` does not.
+        "unicorn/prefer-number-properties": "error",
+        "unicorn/no-abusive-eslint-disable": "error",
+        // Off despite the name: it fires on `.map(x => ({ ...x, field }))`, which is O(n·k) overall and the
+        // ordinary way to add a field. The quadratic accumulation worth catching is `acc = { ...acc, x }`
+        // inside a reduce, which this does not distinguish. 14 sites, 14 false positives.
+        "oxc/no-map-spread": "off",
+        "oxc/bad-bitwise-operator": "error",
+        "oxc/branches-sharing-code": "error",
+        "typescript/no-dynamic-delete": "error",
+        "typescript/prefer-ts-expect-error": "error",
+        // A cycle here is not a style issue: it leaves bindings unevaluated at import time, which
+        // surfaces as a base class that is `undefined` at class-definition time.
+        "import/no-cycle": "error",
+        // `ignoreLastCallback` keeps the rule pointed at CHAINS, where a missing return silently feeds
+        // undefined to the next link. A terminal `.then(…)` doing side effects has nothing downstream
+        // to starve, and rewriting those adds a return whose value no one reads.
+        "promise/always-return": ["error", { ignoreLastCallback: true }],
+        // Off: it cannot see that a ternary settles exactly once. `cb((err) => (err ? reject(err) : resolve()))`
+        // is the standard way to bridge a node-style callback to a promise, and the rule flagged every
+        // instance of it on the calibration corpus — 6 sites, 6 false positives, no real double-settle.
+        "promise/no-multiple-resolved": "off",
+        // Tier 3 — test discipline. `expect-expect` is the one that matters most: it catches a test
+        // that runs, passes, and asserts nothing.
+        "vitest/expect-expect": "error",
+        // vitest's `expect(value, message)` takes an optional assertion message as a second argument —
+        // the rule's default of one would flag the API's own signature.
+        "vitest/valid-expect": ["error", { maxArgs: 2 }],
+        "vitest/valid-title": "error",
+        "vitest/valid-describe-callback": "error",
+        // Off: the dominant shape it flags is a parameterized assertion helper, where the conditional IS
+        // the contract — `expectProposal(out, { kind, body, minConfidence? })` asserts only what the
+        // caller specified. 33 sites on the calibration corpus, none a hidden never-running assertion.
+        "vitest/no-conditional-expect": "off",
+        "vitest/no-conditional-tests": "error",
+        "vitest/no-disabled-tests": "error",
+        "vitest/no-commented-out-tests": "error",
+        "vitest/no-alias-methods": "error",
+        "vitest/prefer-to-be": "error",
+        "vitest/prefer-to-have-length": "error",
+        "vitest/prefer-to-contain": "error",
+        "vitest/require-to-throw-message": "error",
+        // Playwright names its e2e specs `*.spec.ts`; vitest unit tests are `*.test.ts`. A repo running
+        // both has two legitimate conventions, so the rule is scoped to the vitest ones.
+        "vitest/consistent-test-filename": ["error", { allTestPattern: String.raw `.*\.test\.[tj]sx?$` }],
+        // Enabling a plugin also activates its `correctness`-category rules, so a rule this tier turned
+        // down must be switched off explicitly rather than merely left out of the list above.
+        "vitest/require-mock-type-parameters": "off",
+        "vitest/no-conditional-in-test": "off",
+        // Tier 4 — mechanical hygiene. All autofixable, none requiring judgment.
+        // Literal form.
+        "unicorn/numeric-separators-style": "error",
+        "unicorn/no-zero-fractions": "error",
+        "unicorn/text-encoding-identifier-case": "error",
+        "unicorn/escape-case": "error",
+        "unicorn/no-hex-escape": "error",
+        // Import discipline.
+        // `disallowTypeAnnotations: false` keeps the valuable half — a type-only import must be written
+        // `import type` — while allowing `typeof import("…")` in an annotation. That form is how a
+        // guarded dynamic import is typed: the module is optional and loaded at runtime, and the inline
+        // annotation is what says so. `import type` would erase to nothing and read as a hard dep.
+        "typescript/consistent-type-imports": ["error", { disallowTypeAnnotations: false }],
+        "typescript/no-import-type-side-effects": "error",
+        "unicorn/prefer-export-from": "error",
+        "import/no-duplicates": "error",
+        "import/first": "error",
+        "import/newline-after-import": "error",
+        // Modern API preference.
+        "unicorn/prefer-string-replace-all": "error",
+        // `caught` is permitted alongside `error`: when a catch sits inside a scope that already binds
+        // `error` (a React component's error state, say), no-shadow requires a different name and this
+        // rule would otherwise demand the shadowing one. The two rules are in direct conflict without it.
+        "unicorn/catch-error-name": ["error", { ignore: ["caught"] }],
+        "unicorn/prefer-at": "error",
+        "unicorn/prefer-global-this": "error",
+        "unicorn/consistent-existence-index-check": "error",
+        "unicorn/new-for-builtins": "error",
+        "unicorn/prefer-array-find": "error",
+        "unicorn/prefer-structured-clone": "error",
+        "unicorn/prefer-negative-index": "error",
+        "unicorn/prefer-math-min-max": "error",
+        "unicorn/no-useless-collection-argument": "error",
+        "unicorn/throw-new-error": "error",
+        // Two rules that look mechanical but are not type-safe, so they stay off:
+        //
+        // `unicorn/prefer-code-point` rewrites `charCodeAt` to `codePointAt`, which returns
+        // `number | undefined`. It exists for surrogate-pair correctness, but on the ASCII arithmetic
+        // where it usually fires it buys nothing and forces an undefined branch at every site.
+        //
+        // `unicorn/no-useless-undefined` drops an explicitly-passed `undefined` argument. oxlint has no
+        // type information, so it cannot tell an optional parameter from a required one and will
+        // silently turn `f(a, undefined)` into a call that no longer type-checks.
+        //
+        // `unicorn/prefer-string-raw` rewrites a string literal to a String.raw template. That is
+        // runtime-identical but not type-identical: the literal type is lost, so any template-literal
+        // type built from the value collapses. It widens types silently, which is worse than the
+        // escaped backslashes it removes.
+        "unicorn/prefer-code-point": "off",
+        "unicorn/no-useless-undefined": "off",
+        "unicorn/prefer-string-raw": "off",
+        //
+        // `unicorn/prefer-math-trunc` is the one that is not merely type-unsafe but semantically wrong.
+        // `x | 0` and `x >>> 0` are int32/uint32 coercion, and the wrapping is the point — every site on
+        // the calibration corpus was a hash function, a PRNG, or a seeded evaluation harness.
+        // `Math.trunc` does not wrap, so taking its suggestion silently changes what those produce.
+        "unicorn/prefer-math-trunc": "off",
+        //
+        // `unicorn/prefer-number-coercion` rewrites `Number.parseInt(x, 10)` to
+        // `Math.trunc(Number(x))`. parseInt parses a numeric PREFIX; Number is strict, so
+        // `parseInt("12px", 10)` is 12 where `Number("12px")` is NaN. On the calibration corpus the
+        // inputs included CLI options and an HTTP status of uncertain type — exactly where the
+        // difference bites. It also reintroduces Math.trunc, disabled just above.
+        "unicorn/prefer-number-coercion": "off",
+        //
+        // These two are not unsafe — they are unsatisfiable. oxfmt reverts both fixes on its next run:
+        // it lowercases hex digits, and it strips the parentheses unicorn/no-nested-ternary adds. Lint
+        // and format are both CI gates, so a rule the formatter undoes can never go green. Neither
+        // behaviour is configurable in oxfmt today.
+        "unicorn/number-literal-case": "off",
+        "unicorn/no-nested-ternary": "off",
+        //
+        // `unicorn/explicit-length-check` enforces `x.length > 0`, the opposite of the house
+        // convention. `sister-software/prefer-length-truthiness` enforces ours.
+        "unicorn/explicit-length-check": "off",
+        //
+        // Core `no-duplicate-imports` is not TypeScript-aware: it counts a value import and an
+        // `import type` from the same module as a duplicate, which is the split
+        // `typescript/consistent-type-imports` exists to create. On the calibration corpus it reported
+        // 71 sites where the TS-aware `import/no-duplicates` reported 1, and that 1 was real.
+        "no-duplicate-imports": "off",
+        // TS style.
+        "typescript/consistent-type-definitions": "error",
+        "typescript/consistent-indexed-object-style": "error",
+        "typescript/prefer-for-of": "error",
+        "typescript/no-inferrable-types": "error",
+        // Small structural.
+        "unicorn/prefer-ternary": "error",
+        "unicorn/prefer-logical-operator-over-ternary": "error",
+        "unicorn/no-lonely-if": "error",
+        "unicorn/no-console-spaces": "error",
+        "unicorn/no-static-only-class": "error",
+        "no-useless-return": "error",
     };
+    if (react) {
+        rules["react-hooks/rules-of-hooks"] = "error";
+        rules["react/no-unstable-nested-components"] = "error";
+        rules["react/no-object-type-as-default-prop"] = "error";
+        rules["react/jsx-no-constructed-context-values"] = "error";
+        // The automatic JSX runtime made this obsolete; the rule predates it.
+        rules["react/react-in-jsx-scope"] = "off";
+    }
     if (headers) {
         // Error severity: missing headers should fail `oxlint` (a real CI gate) and surface as an
         // editor error. The rule is auto-fixable, so `oxlint --fix` keeps the friction low.
@@ -80,15 +309,60 @@ export function createOxlintConfig(options = {}) {
         // Error severity: a governance gate — direct env/argv access should fail the lint.
         rules["sister-software/no-process-globals"] = "error";
     }
+    if (unnamedThresholds) {
+        // Error severity: an unnamed threshold is a legibility defect, not a style preference.
+        rules["sister-software/no-unnamed-threshold"] = [
+            "error",
+            typeof unnamedThresholds === "object" ? unnamedThresholds : {},
+        ];
+    }
+    if (constantDocs) {
+        // Error severity: an undocumented public constant or tuning knob is a legibility defect.
+        rules["sister-software/require-constant-doc"] = ["error", typeof constantDocs === "object" ? constantDocs : {}];
+    }
+    if (lengthTruthiness) {
+        rules["sister-software/prefer-length-truthiness"] = "error";
+    }
+    // Rules switched off inside test files. Table-driven test bodies are legitimately long, and
+    // expected values are legitimately unnamed numbers. oxlint validates override entries against the
+    // registered rule set, so an entry may only name a rule this config actually turned on.
+    const testFileRules = {
+        "max-lines-per-function": "off",
+        "max-statements": "off",
+        "max-lines": "off",
+    };
+    if (react) {
+        // A Storybook `render` IS a component — React calls it as one — but it is not NAMED like one, so
+        // the hook rules read it as a plain function. Test files that render hooks go through a
+        // testing-library wrapper for the same reason.
+        testFileRules["react-hooks/rules-of-hooks"] = "off";
+    }
+    if (unnamedThresholds) {
+        testFileRules["sister-software/no-unnamed-threshold"] = "off";
+    }
+    if (constantDocs) {
+        testFileRules["sister-software/require-constant-doc"] = "off";
+    }
+    /** Generated files: size ceilings only. Everything else still applies — generated code ships. */
+    const generatedFileRules = {
+        "max-lines": "off",
+        "max-lines-per-function": "off",
+        "max-statements": "off",
+        complexity: "off",
+    };
     return {
         plugins,
-        ...(headers || padding || braces || restrictProcessGlobals
+        ...(headers || padding || braces || restrictProcessGlobals || unnamedThresholds || constantDocs || lengthTruthiness
             ? { jsPlugins: ["@sister.software/oxlint-config/plugin"] }
             : {}),
         categories: { correctness: "error" },
         ignorePatterns,
         rules,
-        overrides: createRuntimeOverrides(packageNamespace),
+        overrides: [
+            ...createRuntimeOverrides(packageNamespace),
+            { files: testFilePatterns, rules: testFileRules },
+            { files: generatedFilePatterns, rules: generatedFileRules },
+        ],
         ...overrides,
     };
 }

package/out/index.js.map

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

package/out/length-truthiness-plugin.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file A prefer-length-truthiness rule, authored as an oxlint JS plugin (ESLint v9-compatible API).
+ *   It is the house counterpart to `unicorn/explicit-length-check`, which enforces the opposite
+ *   convention and is therefore off: `if (items.length)` reads better here than
+ *   `if (items.length > 0)`.
+ *
+ *   The rule only fires where the value is ALREADY coerced to a boolean — a condition, a ternary
+ *   test, or the operand of `!` — including through `&&`/`||` nested inside one. Outside those
+ *   positions the comparison is the value itself, and rewriting `const hasItems = items.length > 0`
+ *   would silently change its type from boolean to number.
+ */
+import type { Rule } from "./plugin-types.js";
+export declare const preferLengthTruthinessRule: Rule;
+export default preferLengthTruthinessRule;
+//# sourceMappingURL=length-truthiness-plugin.d.ts.map

package/out/length-truthiness-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"length-truthiness-plugin.d.ts","sourceRoot":"","sources":["../src/length-truthiness-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAkB,IAAI,EAAe,MAAM,mBAAmB,CAAA;AA2C1E,eAAO,MAAM,0BAA0B,EAAE,IAuExC,CAAA;AAED,eAAe,0BAA0B,CAAA"}

package/out/length-truthiness-plugin.js

@@ -0,0 +1,113 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file A prefer-length-truthiness rule, authored as an oxlint JS plugin (ESLint v9-compatible API).
+ *   It is the house counterpart to `unicorn/explicit-length-check`, which enforces the opposite
+ *   convention and is therefore off: `if (items.length)` reads better here than
+ *   `if (items.length > 0)`.
+ *
+ *   The rule only fires where the value is ALREADY coerced to a boolean — a condition, a ternary
+ *   test, or the operand of `!` — including through `&&`/`||` nested inside one. Outside those
+ *   positions the comparison is the value itself, and rewriting `const hasItems = items.length > 0`
+ *   would silently change its type from boolean to number.
+ */
+/** Comparisons meaning "non-empty", which become the bare length. */
+const TRUTHY_FORMS = new Set(["> 0", "!== 0", "!= 0", ">= 1"]);
+/** Comparisons meaning "empty", which become a negated length. */
+const FALSY_FORMS = new Set(["=== 0", "== 0", "< 1"]);
+/** Members whose length-ness the rule understands. */
+const LENGTH_PROPERTIES = new Set(["length", "size"]);
+/** The comparison rendered as `<operator> <literal>`, or null when it is not a length comparison. */
+function classify(node) {
+    if (node.type !== "BinaryExpression" || !node.operator || !node.left || !node.right)
+        return null;
+    // Accept both `x.length > 0` and the flipped `0 < x.length`.
+    const flipped = { "<": ">", ">": "<", "<=": ">=", ">=": "<=" };
+    let { left, right, operator } = { left: node.left, right: node.right, operator: node.operator };
+    if (left.type === "Literal" || left.type === "NumericLiteral") {
+        ;
+        [left, right] = [right, left];
+        operator = flipped[operator] ?? operator;
+    }
+    if (left.type !== "MemberExpression" && left.type !== "StaticMemberExpression")
+        return null;
+    const property = left.property;
+    if (!property || property.type !== "Identifier" || !LENGTH_PROPERTIES.has(property.name ?? ""))
+        return null;
+    if (right.type !== "Literal" && right.type !== "NumericLiteral")
+        return null;
+    if (typeof right.value !== "number")
+        return null;
+    const form = `${operator} ${right.value}`;
+    if (TRUTHY_FORMS.has(form))
+        return { member: left, negate: false };
+    if (FALSY_FORMS.has(form))
+        return { member: left, negate: true };
+    return null;
+}
+export const preferLengthTruthinessRule = {
+    meta: {
+        name: "prefer-length-truthiness",
+        type: "suggestion",
+        fixable: "code",
+        schema: [{ type: "object", additionalProperties: true }],
+    },
+    create(context) {
+        const sourceCode = context.sourceCode ?? context.getSourceCode();
+        const text = sourceCode.getText();
+        function report(node) {
+            const hit = classify(node);
+            if (!hit)
+                return;
+            const member = text.slice(hit.member.range[0], hit.member.range[1]);
+            const replacement = hit.negate ? `!${member}` : member;
+            context.report({
+                node,
+                message: `Prefer \`${replacement}\` over an explicit length comparison — the house convention is truthiness.`,
+                fix(fixer) {
+                    return fixer.replaceTextRange(node.range, replacement);
+                },
+            });
+        }
+        /** Walk into a boolean context: logical operands and `!` arguments stay boolean. */
+        function visitCondition(node) {
+            if (!node)
+                return;
+            if (node.type === "LogicalExpression") {
+                visitCondition(node.left);
+                visitCondition(node.right);
+                return;
+            }
+            if (node.type === "UnaryExpression" && node.operator === "!") {
+                visitCondition(node.argument);
+                return;
+            }
+            report(node);
+        }
+        return {
+            IfStatement(node) {
+                visitCondition(node.test);
+            },
+            WhileStatement(node) {
+                visitCondition(node.test);
+            },
+            DoWhileStatement(node) {
+                visitCondition(node.test);
+            },
+            ForStatement(node) {
+                visitCondition(node.test);
+            },
+            ConditionalExpression(node) {
+                visitCondition(node.test);
+            },
+            UnaryExpression(node) {
+                if (node.operator === "!") {
+                    visitCondition(node.argument);
+                }
+            },
+        };
+    },
+};
+export default preferLengthTruthinessRule;
+//# sourceMappingURL=length-truthiness-plugin.js.map

package/out/length-truthiness-plugin.js.map

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

package/out/plugin-types.d.ts

@@ -20,6 +20,29 @@ export interface AstNode {
     /** `if`/`else` branches, for the require-braces rule. */
     consequent?: AstNode;
     alternate?: AstNode | null;
+    /** Binary/unary operator text, for the threshold rule. */
+    operator?: string;
+    /** Binary-expression operands. */
+    left?: AstNode;
+    right?: AstNode;
+    /** Unary-expression operand. */
+    argument?: AstNode;
+    /** A literal's value, and its verbatim source text (`raw` preserves a `0x` prefix). */
+    value?: unknown;
+    raw?: string;
+    /** `const` / `let` / `var`, for the constant-doc rule. */
+    kind?: string;
+    /** Declarators of a variable declaration. */
+    declarations?: AstNode[];
+    /** A declarator's binding identifier and initializer. */
+    id?: AstNode;
+    init?: AstNode | null;
+    /** An identifier's name. */
+    name?: string;
+    /** The condition of an `if`/`while`/`for`/ternary, for the length-truthiness rule. */
+    test?: AstNode | null;
+    /** A member expression's accessed property. */
+    property?: AstNode;
 }
 export interface SourceCode {
     getText(): string;

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

@@ -1 +1 @@
-{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../src/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACvB;AAED,yEAAyE;AACzE,MAAM,WAAW,OAAO;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,4FAA4F;IAC5F,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,IAAI,MAAM,CAAA;IACjB,cAAc,IAAI,OAAO,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,KAAK;IACrB,qBAAqB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACrE,oBAAoB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACpE,gBAAgB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAChE;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,aAAa,CAAC,IAAI,UAAU,CAAA;IAC5B,MAAM,CAAC,UAAU,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CACzF;AAED,MAAM,WAAW,IAAI;IACpB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;QAAC,MAAM,EAAE,OAAO,EAAE,CAAA;KAAE,CAAA;IACxF,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC,CAAA;CACrE;AAED,MAAM,WAAW,MAAM;IACtB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CAC3B"}
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../src/plugin-types.ts"],"names":[],"mappings":"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"}

package/out/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAG/C,QAAA,MAAM,oBAAoB,EAAE,MAQ3B,CAAA;AAED,eAAe,oBAAoB,CAAA"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAI/C,QAAA,MAAM,oBAAoB,EAAE,MAW3B,CAAA;AAED,eAAe,oBAAoB,CAAA"}

package/out/plugin.js

@@ -6,9 +6,12 @@
  *   names) exposing all of Sister Software's custom rules under the `sister-software/` namespace.
  */
 import { bracesRule } from "./braces-plugin.js";
+import { requireConstantDocRule } from "./constant-doc-plugin.js";
 import { headerRule } from "./headers-plugin.js";
+import { preferLengthTruthinessRule } from "./length-truthiness-plugin.js";
 import { paddingRule } from "./padding-plugin.js";
 import { noProcessGlobalsRule } from "./process-globals-plugin.js";
+import { noUnnamedThresholdRule } from "./threshold-plugin.js";
 const sisterSoftwarePlugin = {
     meta: { name: "sister-software" },
     rules: {
@@ -16,6 +19,9 @@ const sisterSoftwarePlugin = {
         "padding-lines": paddingRule,
         "require-braces": bracesRule,
         "no-process-globals": noProcessGlobalsRule,
+        "no-unnamed-threshold": noUnnamedThresholdRule,
+        "require-constant-doc": requireConstantDocRule,
+        "prefer-length-truthiness": preferLengthTruthinessRule,
     },
 };
 export default sisterSoftwarePlugin;

package/out/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,MAAM,oBAAoB,GAAW;IACpC,IAAI,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;IACjC,KAAK,EAAE;QACN,qBAAqB,EAAE,UAAU;QACjC,eAAe,EAAE,WAAW;QAC5B,gBAAgB,EAAE,UAAU;QAC5B,oBAAoB,EAAE,oBAAoB;KAC1C;CACD,CAAA;AAED,eAAe,oBAAoB,CAAA"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAA;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,MAAM,oBAAoB,GAAW;IACpC,IAAI,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;IACjC,KAAK,EAAE;QACN,qBAAqB,EAAE,UAAU;QACjC,eAAe,EAAE,WAAW;QAC5B,gBAAgB,EAAE,UAAU;QAC5B,oBAAoB,EAAE,oBAAoB;QAC1C,sBAAsB,EAAE,sBAAsB;QAC9C,sBAAsB,EAAE,sBAAsB;QAC9C,0BAA0B,EAAE,0BAA0B;KACtD;CACD,CAAA;AAED,eAAe,oBAAoB,CAAA"}

package/out/threshold-plugin.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file A no-unnamed-threshold rule, authored as an oxlint JS plugin (ESLint v9-compatible API). It
+ *   flags a numeric literal used as a threshold — an operand of a comparison — and nothing else.
+ *   Numbers inside array and object literals are left alone, because a bounding box or a codepoint
+ *   table is data rather than a tuning knob. That distinction is why this exists instead of
+ *   `no-magic-numbers`, which cannot express it.
+ */
+import type { Rule } from "./plugin-types.js";
+/** Options accepted by {@link noUnnamedThresholdRule}. */
+export interface ThresholdOptions {
+    /** Values that may appear unnamed. Replaces the default list rather than extending it. */
+    ignore?: number[];
+    /** Exempt radix-prefixed literals, which already read as codepoints or bit masks. */
+    allowHex?: boolean;
+}
+export declare const noUnnamedThresholdRule: Rule;
+export default noUnnamedThresholdRule;
+//# sourceMappingURL=threshold-plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threshold-plugin.d.ts","sourceRoot":"","sources":["../src/threshold-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAW,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAWtD,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAChC,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,eAAO,MAAM,sBAAsB,EAAE,IA4DpC,CAAA;AAED,eAAe,sBAAsB,CAAA"}