@ashstack/lint 0.1.1 → 0.2.0

package/README.md

@@ -53,7 +53,7 @@ Off by default, since they need a team decision first: `@ashstack/core/no-commen
 
 ## Rule reference
 
-[RULES.md](./RULES.md) covers every rule, with options and examples. It ships in this package, generated from the rules and CI-checked.
+[RULES.md](https://github.com/AlshehriAli0/ashStack/blob/main/packages/lint/RULES.md) covers every rule, with options and examples. It is generated from the rules and CI-checked.
 
 ## License
 

package/dist/core/index.js

@@ -1,222 +1 @@
-import { composeModules } from "../lib/module.js";
-import coreModule from "./rules/core/index.js";
-import zodModule from "./rules/zod/index.js";
-export const coreModules = [coreModule, zodModule];
-const BASE_RULES = {
-    "array-callback-return": "error",
-    "constructor-super": "error",
-    "default-param-last": "error",
-    eqeqeq: ["error", "always", { null: "ignore" }],
-    "for-direction": "error",
-    "getter-return": "error",
-    "func-style": ["error", "expression"],
-    "no-array-constructor": "error",
-    "no-async-promise-executor": "error",
-    "no-case-declarations": "error",
-    "no-class-assign": "error",
-    "no-compare-neg-zero": "error",
-    "no-cond-assign": "error",
-    "no-const-assign": "error",
-    "no-constant-condition": "error",
-    "no-control-regex": "error",
-    "no-debugger": "error",
-    "no-dupe-class-members": "error",
-    "no-dupe-else-if": "error",
-    "no-dupe-keys": "error",
-    "no-duplicate-case": "error",
-    "no-empty": "error",
-    "no-empty-character-class": "error",
-    "no-empty-pattern": "error",
-    "no-ex-assign": "error",
-    "no-extra-boolean-cast": "error",
-    "no-fallthrough": "error",
-    "no-func-assign": "error",
-    "no-global-assign": "error",
-    "no-import-assign": "error",
-    "no-irregular-whitespace": "error",
-    "no-loss-of-precision": "error",
-    "no-misleading-character-class": "error",
-    "no-negated-condition": "error",
-    "no-nested-ternary": "error",
-    "no-new-native-nonconstructor": "error",
-    "no-nonoctal-decimal-escape": "error",
-    "no-obj-calls": "error",
-    "no-param-reassign": "error",
-    "no-prototype-builtins": "error",
-    "no-redeclare": "off",
-    "no-regex-spaces": "error",
-    "no-self-assign": "error",
-    "no-setter-return": "error",
-    "no-shadow-restricted-names": "error",
-    "no-sparse-arrays": "error",
-    "no-this-before-super": "error",
-    "no-undef": "off",
-    "no-unreachable": "error",
-    "no-unsafe-finally": "error",
-    "no-unsafe-negation": "error",
-    "no-unsafe-optional-chaining": "error",
-    "no-unused-labels": "error",
-    "no-unused-private-class-members": "error",
-    "no-useless-catch": "error",
-    "no-useless-constructor": "error",
-    "no-useless-escape": "error",
-    "no-var": "error",
-    "no-with": "error",
-    "object-shorthand": ["error", "methods"],
-    "prefer-rest-params": "error",
-    "require-yield": "error",
-    "use-isnan": "error",
-    "valid-typeof": "error",
-    "no-unused-vars": [
-        "error",
-        {
-            args: "after-used",
-            argsIgnorePattern: "^_",
-            caughtErrors: "all",
-            caughtErrorsIgnorePattern: "^_",
-            varsIgnorePattern: "^_",
-            destructuredArrayIgnorePattern: "^_",
-            ignoreRestSiblings: true,
-            fix: { imports: "safe-fix" },
-        },
-    ],
-    "no-use-before-define": "off",
-    complexity: ["error", { max: 12 }],
-    "max-depth": ["error", 3],
-    "max-params": ["error", 4],
-    "max-lines": ["error", { max: 300, skipBlankLines: true, skipComments: true }],
-    "max-lines-per-function": ["error", { max: 250, skipBlankLines: true, skipComments: true }],
-    "eslint/no-await-in-loop": "error",
-    "eslint/no-console": "off",
-    "eslint/no-constant-binary-expression": "off",
-    "eslint/no-control-regex": "error",
-    "eslint/no-else-return": "error",
-    "eslint/no-empty": "error",
-    "eslint/no-empty-function": "error",
-    "eslint/no-new": "off",
-    "eslint/no-self-compare": "error",
-    "eslint/no-shadow": "error",
-    "eslint/no-template-curly-in-string": "error",
-    "eslint/no-unassigned-vars": "off",
-    "eslint/no-underscore-dangle": "off",
-    "eslint/no-unmodified-loop-condition": "off",
-    "eslint/no-unused-expressions": "off",
-    "eslint/no-useless-concat": "off",
-    "eslint/preserve-caught-error": "off",
-    "eslint/prefer-arrow-callback": "error",
-    "eslint/prefer-const": "error",
-    "eslint/prefer-template": "error",
-    "typescript/consistent-type-imports": "error",
-    "typescript/dot-notation": "error",
-    "typescript/no-confusing-void-expression": "error",
-    "typescript/no-empty-object-type": ["error", { allowInterfaces: "with-single-extends" }],
-    "typescript/no-explicit-any": "error",
-    "typescript/no-extra-non-null-assertion": "error",
-    "typescript/no-extraneous-class": "error",
-    "typescript/no-floating-promises": "error",
-    "typescript/no-import-type-side-effects": "error",
-    "typescript/no-misused-new": "error",
-    "typescript/no-misused-promises": ["error", { checksVoidReturn: false }],
-    "typescript/no-namespace": "error",
-    "typescript/no-non-null-asserted-optional-chain": "error",
-    "typescript/no-non-null-assertion": "error",
-    "typescript/no-unnecessary-boolean-literal-compare": "error",
-    "typescript/no-unnecessary-condition": "error",
-    "typescript/no-unnecessary-type-assertion": "error",
-    "typescript/no-unnecessary-type-constraint": "error",
-    "typescript/no-unsafe-declaration-merging": "error",
-    "typescript/no-unsafe-function-type": "error",
-    "typescript/no-unsafe-type-assertion": "error",
-    "typescript/no-wrapper-object-types": "error",
-    "typescript/prefer-as-const": "error",
-    "typescript/prefer-namespace-keyword": "error",
-    "typescript/prefer-nullish-coalescing": "error",
-    "typescript/require-await": "error",
-    "typescript/switch-exhaustiveness-check": ["error", { considerDefaultExhaustiveForUnions: true }],
-    "import/no-commonjs": "off",
-    "import/no-cycle": "error",
-    "import/no-duplicates": "error",
-    "import/no-named-as-default": "off",
-    "import/no-named-as-default-member": "off",
-    "import/no-self-import": "off",
-    "import/no-unassigned-import": "off",
-    "unicorn/consistent-function-scoping": "off",
-    "unicorn/no-array-reverse": "off",
-    "unicorn/no-array-sort": "off",
-    "unicorn/no-empty-file": "off",
-    "unicorn/no-new-array": "off",
-    "unicorn/no-useless-fallback-in-spread": "off",
-    "unicorn/no-useless-spread": "off",
-    "unicorn/prefer-add-event-listener": "off",
-    "unicorn/prefer-array-flat-map": "error",
-    "unicorn/prefer-date-now": "error",
-    "unicorn/prefer-logical-operator-over-ternary": "error",
-    "unicorn/prefer-node-protocol": "error",
-    "unicorn/prefer-optional-catch-binding": "error",
-    "unicorn/require-module-specifiers": "off",
-    "unicorn/throw-new-error": "error",
-    "promise/always-return": "off",
-    "promise/no-callback-in-promise": "off",
-    "promise/no-multiple-resolved": "off",
-    "promise/no-promise-in-callback": "off",
-    "oxc/no-async-endpoint-handlers": "off",
-};
-/** Test code is a different kind of code: long tables of cases, and assertions that know more than the type does. */
-export const TEST_FILES = [
-    "**/*.test.ts",
-    "**/*.test.tsx",
-    "**/*.spec.ts",
-    "**/*.spec.tsx",
-    "**/__tests__/**",
-    "**/tests/**",
-];
-/**
- * Base entry — strict TypeScript rules for any project (backend, CLI, library).
- * Library modules (zod) auto-enable when the consumer depends on the library;
- * pass an explicit boolean to force either way.
- *
- * Some of the enabled `typescript/` rules are type-aware (`no-floating-promises`,
- * `no-unnecessary-condition`, …): they only report when oxlint runs with
- * `--type-aware` and the `oxlint-tsgolint` peer installed.
- */
-const core = (options = {}) => {
-    const composed = composeModules(coreModules, options);
-    return {
-        plugins: ["eslint", "typescript", "import", "unicorn", "promise", "oxc"],
-        jsPlugins: composed.jsPlugins,
-        env: { builtin: true, es2024: true },
-        categories: {
-            correctness: "error",
-            suspicious: "error",
-            perf: "error",
-            pedantic: "off",
-            style: "off",
-            restriction: "off",
-            nursery: "off",
-        },
-        rules: { ...BASE_RULES, ...composed.rules },
-        overrides: [
-            {
-                files: ["**/*.tsx"],
-                rules: { "func-style": "off" },
-            },
-            {
-                files: ["**/*.d.ts"],
-                rules: { "typescript/no-explicit-any": "off" },
-            },
-            {
-                files: TEST_FILES,
-                rules: {
-                    "max-lines": "off",
-                    "max-lines-per-function": "off",
-                    "typescript/await-thenable": "off",
-                    "typescript/no-non-null-assertion": "off",
-                    "typescript/no-unsafe-type-assertion": "off",
-                    "typescript/require-await": "off",
-                    "typescript/unbound-method": "off",
-                },
-            },
-        ],
-    };
-};
-export default core;
+import{composeModules as o}from"../lib/module.js";import n from"./rules/core/index.js";import s from"./rules/zod/index.js";export const coreModules=[n,s];const t={"array-callback-return":"error","constructor-super":"error","default-param-last":"error",eqeqeq:["error","always",{null:"ignore"}],"for-direction":"error","getter-return":"error","func-style":["error","expression"],"no-array-constructor":"error","no-async-promise-executor":"error","no-case-declarations":"error","no-class-assign":"error","no-compare-neg-zero":"error","no-cond-assign":"error","no-const-assign":"error","no-constant-condition":"error","no-control-regex":"error","no-debugger":"error","no-dupe-class-members":"error","no-dupe-else-if":"error","no-dupe-keys":"error","no-duplicate-case":"error","no-empty":"error","no-empty-character-class":"error","no-empty-pattern":"error","no-ex-assign":"error","no-extra-boolean-cast":"error","no-fallthrough":"error","no-func-assign":"error","no-global-assign":"error","no-import-assign":"error","no-irregular-whitespace":"error","no-loss-of-precision":"error","no-misleading-character-class":"error","no-negated-condition":"error","no-nested-ternary":"error","no-new-native-nonconstructor":"error","no-nonoctal-decimal-escape":"error","no-obj-calls":"error","no-param-reassign":"error","no-prototype-builtins":"error","no-redeclare":"off","no-regex-spaces":"error","no-self-assign":"error","no-setter-return":"error","no-shadow-restricted-names":"error","no-sparse-arrays":"error","no-this-before-super":"error","no-undef":"off","no-unreachable":"error","no-unsafe-finally":"error","no-unsafe-negation":"error","no-unsafe-optional-chaining":"error","no-unused-labels":"error","no-unused-private-class-members":"error","no-useless-catch":"error","no-useless-constructor":"error","no-useless-escape":"error","no-var":"error","no-with":"error","object-shorthand":["error","methods"],"prefer-rest-params":"error","require-yield":"error","use-isnan":"error","valid-typeof":"error","no-unused-vars":["error",{args:"after-used",argsIgnorePattern:"^_",caughtErrors:"all",caughtErrorsIgnorePattern:"^_",varsIgnorePattern:"^_",destructuredArrayIgnorePattern:"^_",ignoreRestSiblings:!0,fix:{imports:"safe-fix"}}],"no-use-before-define":"off",complexity:["error",{max:12}],"max-depth":["error",3],"max-params":["error",4],"max-lines":["error",{max:300,skipBlankLines:!0,skipComments:!0}],"max-lines-per-function":["error",{max:250,skipBlankLines:!0,skipComments:!0}],"eslint/no-await-in-loop":"error","eslint/no-console":"off","eslint/no-constant-binary-expression":"off","eslint/no-control-regex":"error","eslint/no-else-return":"error","eslint/no-empty":"error","eslint/no-empty-function":"error","eslint/no-new":"off","eslint/no-self-compare":"error","eslint/no-shadow":"error","eslint/no-template-curly-in-string":"error","eslint/no-unassigned-vars":"off","eslint/no-underscore-dangle":"off","eslint/no-unmodified-loop-condition":"off","eslint/no-unused-expressions":"off","eslint/no-useless-concat":"off","eslint/preserve-caught-error":"off","eslint/prefer-arrow-callback":"error","eslint/prefer-const":"error","eslint/prefer-template":"error","typescript/consistent-type-imports":"error","typescript/dot-notation":"error","typescript/no-confusing-void-expression":"error","typescript/no-empty-object-type":["error",{allowInterfaces:"with-single-extends"}],"typescript/no-explicit-any":"error","typescript/no-extra-non-null-assertion":"error","typescript/no-extraneous-class":"error","typescript/no-floating-promises":"error","typescript/no-import-type-side-effects":"error","typescript/no-misused-new":"error","typescript/no-misused-promises":["error",{checksVoidReturn:!1}],"typescript/no-namespace":"error","typescript/no-non-null-asserted-optional-chain":"error","typescript/no-non-null-assertion":"error","typescript/no-unnecessary-boolean-literal-compare":"error","typescript/no-unnecessary-condition":"error","typescript/no-unnecessary-type-assertion":"error","typescript/no-unnecessary-type-constraint":"error","typescript/no-unsafe-declaration-merging":"error","typescript/no-unsafe-function-type":"error","typescript/no-unsafe-type-assertion":"error","typescript/no-wrapper-object-types":"error","typescript/prefer-as-const":"error","typescript/prefer-namespace-keyword":"error","typescript/prefer-nullish-coalescing":"error","typescript/require-await":"error","typescript/switch-exhaustiveness-check":["error",{considerDefaultExhaustiveForUnions:!0}],"import/no-commonjs":"off","import/no-cycle":"error","import/no-duplicates":"error","import/no-named-as-default":"off","import/no-named-as-default-member":"off","import/no-self-import":"off","import/no-unassigned-import":"off","unicorn/consistent-function-scoping":"off","unicorn/no-array-reverse":"off","unicorn/no-array-sort":"off","unicorn/no-empty-file":"off","unicorn/no-new-array":"off","unicorn/no-useless-fallback-in-spread":"off","unicorn/no-useless-spread":"off","unicorn/prefer-add-event-listener":"off","unicorn/prefer-array-flat-map":"error","unicorn/prefer-date-now":"error","unicorn/prefer-logical-operator-over-ternary":"error","unicorn/prefer-node-protocol":"error","unicorn/prefer-optional-catch-binding":"error","unicorn/require-module-specifiers":"off","unicorn/throw-new-error":"error","promise/always-return":"off","promise/no-callback-in-promise":"off","promise/no-multiple-resolved":"off","promise/no-promise-in-callback":"off","oxc/no-async-endpoint-handlers":"off"};export const TEST_FILES=["**/*.test.ts","**/*.test.tsx","**/*.spec.ts","**/*.spec.tsx","**/__tests__/**","**/tests/**"];const i=(e={})=>{const r=o(coreModules,e);return{plugins:["eslint","typescript","import","unicorn","promise","oxc"],jsPlugins:r.jsPlugins,env:{builtin:!0,es2024:!0},categories:{correctness:"error",suspicious:"error",perf:"error",pedantic:"off",style:"off",restriction:"off",nursery:"off"},rules:{...t,...r.rules},overrides:[{files:["**/*.tsx"],rules:{"func-style":"off"}},{files:["**/*.d.ts"],rules:{"typescript/no-explicit-any":"off"}},{files:TEST_FILES,rules:{"max-lines":"off","max-lines-per-function":"off","typescript/await-thenable":"off","typescript/no-non-null-assertion":"off","typescript/no-unsafe-type-assertion":"off","typescript/require-await":"off","typescript/unbound-method":"off"}}]}};export default i;

package/dist/core/rules/core/components-tsx-only.js

@@ -1,37 +1 @@
-import { optionsOf } from "../../../lib/ast.js";
-const COMPONENTS_TSX_ONLY = "Move this file to `src/utils` (helpers, pure logic), `src/hooks` (a hook), or `src/api/<feature>/` (data access). `components/` holds only files that render JSX, plus a barrel.";
-const DEFAULT_DIR = "src/components";
-const isBarrel = (body) => body.every(statement => statement.type === "ImportDeclaration" ||
-    statement.type === "ExportAllDeclaration" ||
-    (statement.type === "ExportNamedDeclaration" && statement.declaration == null));
-export const componentsTsxOnly = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: "Require every file under the components directory to render JSX or be a re-export barrel. `dir` says which directory, defaulting to `src/components`.",
-        },
-        schema: [{ type: "object", properties: { dir: { type: "string", minLength: 1 } }, additionalProperties: false }],
-        defaultOff: true,
-    },
-    createOnce(context) {
-        let rendersJsx = false;
-        return {
-            before() {
-                rendersJsx = false;
-                const { dir = DEFAULT_DIR } = optionsOf(context, {});
-                return context.filename.replaceAll("\\", "/").includes(`/${dir}/`);
-            },
-            JSXElement() {
-                rendersJsx = true;
-            },
-            JSXFragment() {
-                rendersJsx = true;
-            },
-            "Program:exit"(node) {
-                if (rendersJsx || isBarrel(node.body))
-                    return;
-                context.report({ node, message: COMPONENTS_TSX_ONLY });
-            },
-        };
-    },
-};
+import{optionsOf as t}from"../../../lib/ast.js";const s="Move this file to `src/utils` (helpers, pure logic), `src/hooks` (a hook), or `src/api/<feature>/` (data access). `components/` holds only files that render JSX, plus a barrel.",l="src/components",n=(r)=>r.every((e)=>e.type==="ImportDeclaration"||e.type==="ExportAllDeclaration"||e.type==="ExportNamedDeclaration"&&e.declaration==null);export const componentsTsxOnly={meta:{type:"problem",docs:{description:"Require every file under the components directory to render JSX or be a re-export barrel. `dir` says which directory, defaulting to `src/components`."},schema:[{type:"object",properties:{dir:{type:"string",minLength:1}},additionalProperties:!1}],defaultOff:!0},createOnce(r){let e=!1;return{before(){e=!1;const{dir:o=l}=t(r,{});return r.filename.replaceAll("\\","/").includes(`/${o}/`)},JSXElement(){e=!0},JSXFragment(){e=!0},"Program:exit"(o){if(e||n(o.body))return;r.report({node:o,message:s})}}}};

package/dist/core/rules/core/hoist-intl.js

@@ -1,32 +1 @@
-import { ancestors, calleeName, hasAncestor, isFunction, problem, subtreeHas } from "../../../lib/ast.js";
-const HOIST_INTL = "Move this `Intl` formatter to module scope when the locale and options are static, or wrap it in `useMemo` keyed on the locale — constructing one per render is expensive.";
-const MEMO_HOOKS = new Set(["useMemo", "useCallback"]);
-const rendersJsx = (node) => subtreeHas(node, current => current.type === "JSXElement" || current.type === "JSXFragment");
-/** Any enclosing function that renders JSX, not just the innermost one: a callback of a component is rebuilt too. */
-const insideAComponent = (node) => {
-    for (const current of ancestors(node)) {
-        if (isFunction(current) && rendersJsx(current))
-            return true;
-    }
-    return false;
-};
-export const hoistIntl = problem("Disallow `new Intl.*` inside a function that renders JSX, unless the call already sits in `useMemo` or `useCallback`.", {
-    createOnce(context) {
-        return {
-            NewExpression(node) {
-                const { callee } = node;
-                if (callee.type !== "MemberExpression")
-                    return;
-                const { object } = callee;
-                if (object.type !== "Identifier" || object.name !== "Intl")
-                    return;
-                if (hasAncestor(node, current => current.type === "CallExpression" && MEMO_HOOKS.has(calleeName(current)))) {
-                    return;
-                }
-                if (!insideAComponent(node))
-                    return;
-                context.report({ node, message: HOIST_INTL });
-            },
-        };
-    },
-});
+import{ancestors as o,calleeName as a,hasAncestor as i,isFunction as l,problem as c,subtreeHas as p}from"../../../lib/ast.js";const u="Move this `Intl` formatter to module scope when the locale and options are static, or wrap it in `useMemo` keyed on the locale — constructing one per render is expensive.",m=new Set(["useMemo","useCallback"]),f=(t)=>p(t,(e)=>e.type==="JSXElement"||e.type==="JSXFragment"),h=(t)=>{for(const e of o(t))if(l(e)&&f(e))return!0;return!1};export const hoistIntl=c("Disallow `new Intl.*` inside a function that renders JSX, unless the call already sits in `useMemo` or `useCallback`.",{createOnce(t){return{NewExpression(e){const{callee:n}=e;if(n.type!=="MemberExpression")return;const{object:s}=n;if(s.type!=="Identifier"||s.name!=="Intl")return;if(i(e,(r)=>r.type==="CallExpression"&&m.has(a(r))))return;if(!h(e))return;t.report({node:e,message:u})}}}});

package/dist/core/rules/core/index.js

@@ -1,18 +1 @@
-import { defineModule } from "../../../lib/module.js";
-import { componentsTsxOnly } from "./components-tsx-only.js";
-import { hoistIntl } from "./hoist-intl.js";
-import { noComments } from "./no-comments.js";
-import { noNamingConvention } from "./no-naming-convention.js";
-import { useDesignSystem } from "./use-design-system.js";
-export default defineModule({
-    meta: { name: "@ashstack/core" },
-    url: import.meta.url,
-    docsWhen: "always on via `core()` and every entry above it (opt-in rules noted per rule)",
-    rules: {
-        "no-comments": noComments,
-        "no-naming-convention": noNamingConvention,
-        "use-design-system": useDesignSystem,
-        "components-tsx-only": componentsTsxOnly,
-        "hoist-intl": hoistIntl,
-    },
-});
+import{defineModule as o}from"../../../lib/module.js";import{componentsTsxOnly as n}from"./components-tsx-only.js";import{hoistIntl as e}from"./hoist-intl.js";import{noComments as t}from"./no-comments.js";import{noNamingConvention as m}from"./no-naming-convention.js";import{useDesignSystem as r}from"./use-design-system.js";export default o({meta:{name:"@ashstack/core"},url:import.meta.url,docsWhen:"always on via `core()` and every entry above it (opt-in rules noted per rule)",rules:{"no-comments":t,"no-naming-convention":m,"use-design-system":r,"components-tsx-only":n,"hoist-intl":e}});

package/dist/core/rules/core/no-comments.js

@@ -1,194 +1 @@
-import { optionsOf } from "../../../lib/ast.js";
-const COMMENT_DIRECTIVES = [
-    "@ts-expect-error",
-    "@ts-ignore",
-    "@ts-nocheck",
-    "@ts-check",
-    "@jsx",
-    "@jsxRuntime",
-    "@jsxImportSource",
-    "prettier-ignore",
-    "eslint-disable",
-    "eslint-enable",
-    "oxlint-disable",
-    "oxlint-enable",
-    "oxfmt-ignore",
-    "react-doctor-disable",
-    "@type",
-    "<reference",
-    "#__PURE__",
-    "@__PURE__",
-    "v8 ignore",
-    "c8 ignore",
-    "istanbul ignore",
-    "@vitest-environment",
-    "EXPECT_PASS",
-    "EXPECT_FAIL",
-];
-const ESCAPE_HATCH = /^what:\s*(?<fact>[\s\S]+)$/i;
-const BLOCK_COMMENT_TYPES = new Set(["Block", "MultiLine"]);
-const IGNORED_COMMENT_TYPES = new Set(["Shebang", "Hashbang"]);
-const HATCH_MIN_FACT = 10;
-const HATCH_MAX_LENGTH = 120;
-const HATCH_DEFAULT_BUDGET = 2;
-const REFACTOR_MOVES = "Make the code say this, then delete the line — nearly every comment here is one rename or one refactor away from unnecessary. Reach for the move that fits: Rename the value, function or type to the plain word this sentence uses; Extract Function for the block it summarises, named after the claim it makes; Guard Clause for the nesting it walks the reader through; split the clever expression it decodes into named steps. You are done when the sentence's content is legible in an identifier, a signature or the control flow.";
-const HATCH_OPEN = " The `// what:` hatch carries one kind of fact: one that outlives this code — a platform bug, an upstream contract, a number measured on a device. A fact about what this code does fails that test, and the refactor is still owed.";
-const HATCH_CLOSED = " This project runs with the `// what:` hatch turned off, so the refactor is the only way out: there is no fact this file may state in prose.";
-const refactorFirst = (escapeHatch) => REFACTOR_MOVES + (escapeHatch ? HATCH_OPEN : HATCH_CLOSED);
-const FLOATING_JSDOC = "Attach this block to the declaration it documents, or Rename and Extract Function until the code reads without it. A `/** */` block earns its place as documentation of the symbol directly beneath it.";
-const HATCH_MESSAGES = {
-    block: "Rewrite this as a single `// what: <fact>` line comment. If the fact needs a paragraph, name the pieces in code until it fits on one line.",
-    shortFact: `Write the fact after \`what:\` (at least ${HATCH_MIN_FACT} characters), or delete the comment.`,
-    tooLong: `Trim this \`what:\` line under ${HATCH_MAX_LENGTH} characters, moving what is left into names in the code.`,
-    stacked: "Keep one `what:` line here — the single irreducible fact — and refactor what the others explain into named values and functions.",
-};
-const overBudget = (budget, count) => `Delete \`what:\` comments from this file until at most ${budget} remain (it has ${count}): move the logic each one annotates into a function whose name carries what the comment says.`;
-const DECLARATION_TYPES = new Set([
-    "ExportNamedDeclaration",
-    "ExportDefaultDeclaration",
-    "ExportAllDeclaration",
-    "FunctionDeclaration",
-    "VariableDeclaration",
-    "ClassDeclaration",
-    "MethodDefinition",
-    "PropertyDefinition",
-    "Property",
-    "TSInterfaceDeclaration",
-    "TSTypeAliasDeclaration",
-    "TSEnumDeclaration",
-    "TSEnumMember",
-    "TSModuleDeclaration",
-    "TSDeclareFunction",
-    "TSPropertySignature",
-    "TSMethodSignature",
-    "TSIndexSignature",
-    "TSCallSignatureDeclaration",
-    "TSConstructSignatureDeclaration",
-    "TSAbstractMethodDefinition",
-    "TSAbstractPropertyDefinition",
-    "AccessorProperty",
-    "ImportDeclaration",
-]);
-const commentBody = (comment) => (BLOCK_COMMENT_TYPES.has(comment.type) ? comment.value.replace(/^[*\s]+/, "") : comment.value).trim();
-const isDirective = (body) => COMMENT_DIRECTIVES.some(prefix => body.startsWith(prefix));
-const isJsdoc = (comment) => BLOCK_COMMENT_TYPES.has(comment.type) && comment.value.startsWith("*");
-/** Comments this rule judges: shebangs and tooling directives are none of its business. */
-const reviewedComments = (context) => {
-    const reviewed = [];
-    for (const comment of context.sourceCode.getAllComments()) {
-        if (IGNORED_COMMENT_TYPES.has(comment.type))
-            continue;
-        const body = commentBody(comment);
-        if (isDirective(body))
-            continue;
-        reviewed.push({ comment, body });
-    }
-    return reviewed;
-};
-/** offset of the first non-whitespace character at or after `from` */
-const nextTokenStart = (text, from) => {
-    let index = from;
-    while (/\s/.test(text.charAt(index)))
-        index += 1;
-    return index;
-};
-const shapeViolation = (comment, body, fact) => {
-    if (BLOCK_COMMENT_TYPES.has(comment.type))
-        return HATCH_MESSAGES.block;
-    if (fact.trim().length < HATCH_MIN_FACT)
-        return HATCH_MESSAGES.shortFact;
-    if (body.length > HATCH_MAX_LENGTH)
-        return HATCH_MESSAGES.tooLong;
-    return null;
-};
-const isStackedOn = (source, previous, comment) => source.slice(previous.end, comment.start).trim() === "";
-const hatchAllowed = (options) => options.escapeHatch !== false;
-export const noComments = {
-    meta: {
-        type: "problem",
-        docs: {
-            description: 'Disallow every comment that is neither a `// what: <fact>` line nor a tooling directive. The message names the refactoring that removes it: Rename, Extract Function, Guard Clause. Surviving `// what:` lines are held to one short line each, at most `budget` per file (default 2); `escapeHatch: false` removes the hatch entirely, so no prose survives at all. With `jsdoc: "allow"`, a `/** */` block documenting the declaration directly beneath it is kept, while a floating one still reports.',
-        },
-        schema: [
-            {
-                type: "object",
-                properties: {
-                    jsdoc: { enum: ["allow", "report"] },
-                    escapeHatch: { type: "boolean" },
-                    budget: { type: "integer", minimum: 0 },
-                },
-                additionalProperties: false,
-            },
-        ],
-        defaultOff: true,
-    },
-    createOnce(context) {
-        const declarationStarts = new Set();
-        const recordDeclaration = (node) => {
-            declarationStarts.add(node.start);
-        };
-        const declarationVisitors = {};
-        for (const type of DECLARATION_TYPES)
-            declarationVisitors[type] = recordDeclaration;
-        const report = (comment, message) => {
-            context.report({ node: comment, message });
-        };
-        const reportProse = (reviewed, options) => {
-            const { text } = context.sourceCode;
-            const escapeHatch = hatchAllowed(options);
-            for (const { comment, body } of reviewed) {
-                if (escapeHatch && ESCAPE_HATCH.test(body))
-                    continue;
-                if (options.jsdoc !== "allow" || !isJsdoc(comment))
-                    report(comment, refactorFirst(escapeHatch));
-                else if (!declarationStarts.has(nextTokenStart(text, comment.end)))
-                    report(comment, FLOATING_JSDOC);
-            }
-        };
-        const wellShapedHatches = (reviewed) => {
-            const accepted = [];
-            for (const { comment, body } of reviewed) {
-                const fact = body.match(ESCAPE_HATCH)?.groups?.fact;
-                if (fact === undefined)
-                    continue;
-                const violation = shapeViolation(comment, body, fact);
-                if (violation === null)
-                    accepted.push(comment);
-                else
-                    report(comment, violation);
-            }
-            return accepted;
-        };
-        const reportStacked = (accepted) => {
-            const source = context.sourceCode.getText();
-            for (const [index, comment] of accepted.entries()) {
-                const previous = accepted[index - 1];
-                if (previous && isStackedOn(source, previous, comment))
-                    report(comment, HATCH_MESSAGES.stacked);
-            }
-        };
-        const reportOverBudget = (accepted, options) => {
-            const budget = options.budget ?? HATCH_DEFAULT_BUDGET;
-            const overflow = accepted[budget];
-            if (overflow)
-                report(overflow, overBudget(budget, accepted.length));
-        };
-        return {
-            ...declarationVisitors,
-            before() {
-                declarationStarts.clear();
-                return true;
-            },
-            "Program:exit"() {
-                const options = optionsOf(context, {});
-                const reviewed = reviewedComments(context);
-                reportProse(reviewed, options);
-                if (!hatchAllowed(options))
-                    return;
-                const accepted = wellShapedHatches(reviewed);
-                reportStacked(accepted);
-                reportOverBudget(accepted, options);
-            },
-        };
-    },
-};
+import{optionsOf as y}from"../../../lib/ast.js";const E=["@ts-expect-error","@ts-ignore","@ts-nocheck","@ts-check","@jsx","@jsxRuntime","@jsxImportSource","prettier-ignore","eslint-disable","eslint-enable","oxlint-disable","oxlint-enable","oxfmt-ignore","react-doctor-disable","@type","<reference","#__PURE__","@__PURE__","v8 ignore","c8 ignore","istanbul ignore","@vitest-environment","EXPECT_PASS","EXPECT_FAIL"],f=/^what:\s*(?<fact>[\s\S]+)$/i,u=new Set(["Block","MultiLine"]),v=new Set(["Shebang","Hashbang"]),m=10,p=120,C=2,D="Make the code say this, then delete the line — nearly every comment here is one rename or one refactor away from unnecessary. Reach for the move that fits: Rename the value, function or type to the plain word this sentence uses; Extract Function for the block it summarises, named after the claim it makes; Guard Clause for the nesting it walks the reader through; split the clever expression it decodes into named steps. You are done when the sentence's content is legible in an identifier, a signature or the control flow.",A=" The `// what:` hatch carries one kind of fact: one that outlives this code — a platform bug, an upstream contract, a number measured on a device. A fact about what this code does fails that test, and the refactor is still owed.",_=" This project runs with the `// what:` hatch turned off, so the refactor is the only way out: there is no fact this file may state in prose.",H=(e)=>D+(e?A:_),k="Attach this block to the declaration it documents, or Rename and Extract Function until the code reads without it. A `/** */` block earns its place as documentation of the symbol directly beneath it.",d={block:"Rewrite this as a single `// what: <fact>` line comment. If the fact needs a paragraph, name the pieces in code until it fits on one line.",shortFact:`Write the fact after \`what:\` (at least ${m} characters), or delete the comment.`,tooLong:`Trim this \`what:\` line under ${p} characters, moving what is left into names in the code.`,stacked:"Keep one `what:` line here — the single irreducible fact — and refactor what the others explain into named values and functions."},x=(e,o)=>`Delete \`what:\` comments from this file until at most ${e} remain (it has ${o}): move the logic each one annotates into a function whose name carries what the comment says.`,P=new Set(["ExportNamedDeclaration","ExportDefaultDeclaration","ExportAllDeclaration","FunctionDeclaration","VariableDeclaration","ClassDeclaration","MethodDefinition","PropertyDefinition","Property","TSInterfaceDeclaration","TSTypeAliasDeclaration","TSEnumDeclaration","TSEnumMember","TSModuleDeclaration","TSDeclareFunction","TSPropertySignature","TSMethodSignature","TSIndexSignature","TSCallSignatureDeclaration","TSConstructSignatureDeclaration","TSAbstractMethodDefinition","TSAbstractPropertyDefinition","AccessorProperty","ImportDeclaration"]),M=(e)=>(u.has(e.type)?e.value.replace(/^[*\s]+/,""):e.value).trim(),O=(e)=>E.some((o)=>e.startsWith(o)),F=(e)=>u.has(e.type)&&e.value.startsWith("*"),R=(e)=>{const o=[];for(const a of e.sourceCode.getAllComments()){if(v.has(a.type))continue;const c=M(a);if(O(c))continue;o.push({comment:a,body:c})}return o},I=(e,o)=>{let a=o;while(/\s/.test(e.charAt(a)))a+=1;return a},L=(e,o,a)=>{if(u.has(e.type))return d.block;if(a.trim().length<m)return d.shortFact;if(o.length>p)return d.tooLong;return null},N=(e,o,a)=>e.slice(o.end,a.start).trim()==="",g=(e)=>e.escapeHatch!==!1;export const noComments={meta:{type:"problem",docs:{description:'Disallow every comment that is neither a `// what: <fact>` line nor a tooling directive. The message names the refactoring that removes it: Rename, Extract Function, Guard Clause. Surviving `// what:` lines are held to one short line each, at most `budget` per file (default 2); `escapeHatch: false` removes the hatch entirely, so no prose survives at all. With `jsdoc: "allow"`, a `/** */` block documenting the declaration directly beneath it is kept, while a floating one still reports.'},schema:[{type:"object",properties:{jsdoc:{enum:["allow","report"]},escapeHatch:{type:"boolean"},budget:{type:"integer",minimum:0}},additionalProperties:!1}],defaultOff:!0},createOnce(e){const o=new Set,a=(t)=>{o.add(t.start)},c={};for(const t of P)c[t]=a;const l=(t,n)=>{e.report({node:t,message:n})},S=(t,n)=>{const{text:r}=e.sourceCode,s=g(n);for(const{comment:i,body:h}of t){if(s&&f.test(h))continue;if(n.jsdoc!=="allow"||!F(i))l(i,H(s));else if(!o.has(I(r,i.end)))l(i,k)}},T=(t)=>{const n=[];for(const{comment:r,body:s}of t){const i=s.match(f)?.groups?.fact;if(i===void 0)continue;const h=L(r,s,i);if(h===null)n.push(r);else l(r,h)}return n},w=(t)=>{const n=e.sourceCode.getText();for(const[r,s]of t.entries()){const i=t[r-1];if(i&&N(n,i,s))l(s,d.stacked)}},b=(t,n)=>{const r=n.budget??C,s=t[r];if(s)l(s,x(r,t.length))};return{...c,before(){o.clear();return!0},"Program:exit"(){const t=y(e,{}),n=R(e);S(n,t);if(!g(t))return;const r=T(n);w(r);b(r,t)}}}};