eslint-plugin-legion 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# eslint-plugin-legion
+
+## 0.1.0
+
+### Minor Changes
+
+- ecc18df: Initial release: nine grade A rules with tolerance levels, the oxlint/ESLint plugin, the audit CLI with the `directives` subcommand, the Prettier and TypeScript configs, and the umbrella package.
+
+### Patch Changes
+
+- Updated dependencies [ecc18df]
+  - legion-rules@0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Veracium LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# eslint-plugin-legion
+
+[LEGION-STANDARDS](https://github.com/Kprince1101/legion-toolkit#readme) as a
+lint plugin. One package, two runtimes: it is an ESLint v9+ plugin, and
+oxlint's `jsPlugins` runs ESLint plugins as-is, so the same rules with the
+same diagnostics run under either. CI on this repo proves the two agree on
+every fixture.
+
+What it enforces: components that render and never think (no state,
+effects, fetching, handler bodies or projections in a component), zero
+comments, no `React.FC`, no `enum`, no ternaries, no `function` keyword,
+guarded context hooks, hydration-safe `useState`, server-first
+`page`/`layout` files, no literal conditions in JSX, no manual memoization
+when the React Compiler is on, no service-role client in browser code, a 180-line
+component cap, `any` only on declared boundary paths, and lint bypasses
+that are scoped, named, explained, and impossible for locked rules. See
+[`legion-rules`](https://www.npmjs.com/package/legion-rules) for the rule
+table and the tolerance levels.
+
+## oxlint
+
+```sh
+yarn add -D eslint-plugin-legion oxlint
+```
+
+```jsonc
+// .oxlintrc.json
+{
+  "jsPlugins": ["eslint-plugin-legion"],
+  "rules": {
+    "legion/no-narrative-comments": "error",
+    "legion/no-enum": "error",
+  },
+}
+```
+
+To get a full preset instead of listing rules, generate the config from
+`legion-rules`:
+
+```js
+// scripts/sync-oxlintrc.ts
+import { writeFileSync } from 'node:fs';
+import { strict } from 'legion-rules';
+
+writeFileSync('.oxlintrc.json', JSON.stringify(strict.oxlint, null, 2));
+```
+
+## ESLint
+
+```sh
+yarn add -D eslint-plugin-legion eslint @typescript-eslint/parser
+```
+
+```js
+// eslint.config.mjs
+import legion from 'eslint-plugin-legion';
+import * as tsParser from '@typescript-eslint/parser';
+
+export default [
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: { ecmaFeatures: { jsx: true } },
+    },
+  },
+  ...legion.configs.strict,
+];
+```
+
+`legion.configs.recommended` is the softer preset. For your own levels:
+
+```js
+import { legionEslintConfig } from 'eslint-plugin-legion';
+
+export default [
+  ...legionEslintConfig({ rules: { 'no-enum': 3 }, noTernary: 2 }),
+];
+```
+
+Pass `{ typescriptEslint: tsPlugin }` as the second argument to also wire
+`@typescript-eslint/no-explicit-any` with the boundary overrides.
+
+## The bypass
+
+A rule at level 2 can be bypassed on one line, and only like this:
+
+```ts
+// oxlint-disable-next-line legion/no-enum -- generated by the API client
+```
+
+File-wide disables, unnamed disables, disables without a reason, and any
+disable of a rule at level 3 fail lint through `legion/scoped-disables`. The
+one shape no lint rule can see, a bare `/* eslint-disable */` at the top of a
+file, is caught by
+[`legion-audit directives`](https://www.npmjs.com/package/legion-audit); put
+it in front of your linter in the `lint` script.
+
+## Requirements
+
+Node 22 or newer. Peer: `oxlint >= 1.53` (JS plugins) or `eslint >= 9`, both
+optional. No runtime dependencies beyond `legion-rules`.
+
+MIT, Copyright (c) 2026 Veracium LLC.

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import { recommended as recommendedConfig, rules, strict as strictConfig } from 'legion-rules';
+import type { EslintExtras, EslintFlatConfig, LegionConfig, LegionConfigInput } from 'legion-rules';
+export interface LegionPlugin {
+    meta: {
+        name: string;
+        version: string;
+    };
+    rules: typeof rules;
+    configs: {
+        recommended: EslintFlatConfig[];
+        strict: EslintFlatConfig[];
+    };
+}
+declare const plugin: LegionPlugin;
+export declare const legionEslintConfig: (config: LegionConfig | LegionConfigInput, extras?: EslintExtras) => EslintFlatConfig[];
+export declare const legionOxlintConfig: (config: LegionConfigInput) => import("legion-rules").OxlintConfig;
+export { recommendedConfig as recommended, strictConfig as strict, rules };
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,IAAI,iBAAiB,EAChC,KAAK,EACL,MAAM,IAAI,YAAY,EACvB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAKtB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,OAAO,EAAE;QACP,WAAW,EAAE,gBAAgB,EAAE,CAAC;QAChC,MAAM,EAAE,gBAAgB,EAAE,CAAC;KAC5B,CAAC;CACH;AAED,QAAA,MAAM,MAAM,EAAE,YAIb,CAAC;AAKF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,YAAY,GAAG,iBAAiB,EACxC,SAAS,YAAY,KACpB,gBAAgB,EAKlB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,iBAAiB,wCACzB,CAAC;AAEpC,OAAO,EAAE,iBAAiB,IAAI,WAAW,EAAE,YAAY,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;AAE3E,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+import { createRequire } from 'node:module';
+import { defineLegionConfig, recommended as recommendedConfig, rules, strict as strictConfig, } from 'legion-rules';
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+const plugin = {
+    meta: { name: 'legion', version },
+    rules,
+    configs: { recommended: [], strict: [] },
+};
+plugin.configs.recommended = recommendedConfig.eslint(plugin);
+plugin.configs.strict = strictConfig.eslint(plugin);
+export const legionEslintConfig = (config, extras) => {
+    if ('eslint' in config && typeof config.eslint === 'function') {
+        return config.eslint(plugin, extras);
+    }
+    return defineLegionConfig(config).eslint(plugin, extras);
+};
+export const legionOxlintConfig = (config) => defineLegionConfig(config).oxlint;
+export { recommendedConfig as recommended, strictConfig as strict, rules };
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,WAAW,IAAI,iBAAiB,EAChC,KAAK,EACL,MAAM,IAAI,YAAY,GACvB,MAAM,cAAc,CAAC;AAQtB,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAWtE,MAAM,MAAM,GAAiB;IAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE;IACjC,KAAK;IACL,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;CACzC,CAAC;AAEF,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC9D,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAwC,EACxC,MAAqB,EACD,EAAE;IACtB,IAAI,QAAQ,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC9D,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,kBAAkB,CAAC,MAA2B,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAChF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAyB,EAAE,EAAE,CAC9D,kBAAkB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AAEpC,OAAO,EAAE,iBAAiB,IAAI,WAAW,EAAE,YAAY,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;AAE3E,eAAe,MAAM,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "eslint-plugin-legion",
+  "version": "0.1.0",
+  "description": "LEGION-STANDARDS as a lint plugin. Runs under oxlint (jsPlugins) and ESLint v9+. Zero comments, no React.FC, no enum, no ternaries, no function keyword, guarded context hooks, hydration-safe state, server-first pages, scoped lint bypasses.",
+  "license": "MIT",
+  "author": "Veracium LLC",
+  "homepage": "https://github.com/Kprince1101/legion-toolkit/tree/main/packages/eslint-plugin#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kprince1101/legion-toolkit.git",
+    "directory": "packages/eslint-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/Kprince1101/legion-toolkit/issues"
+  },
+  "keywords": [
+    "eslint",
+    "eslintplugin",
+    "eslint-plugin",
+    "oxlint",
+    "oxlint-plugin",
+    "react",
+    "nextjs",
+    "react-native",
+    "legion"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/__tests__",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "legion-rules": "^0.1.0"
+  },
+  "peerDependencies": {
+    "eslint": ">=9",
+    "oxlint": ">=1.53"
+  },
+  "peerDependenciesMeta": {
+    "eslint": {
+      "optional": true
+    },
+    "oxlint": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "node ../../scripts/copy-license.ts && tsc -p tsconfig.build.json",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true}); require('node:fs').rmSync('LICENSE',{force:true})\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "node ../../scripts/require-ci.ts"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}