@rdjperron/lint 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Romain Perron
+
+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,88 @@
+# @rdjperron/lint
+
+Oxlint JS plugins in four packs. Each pack is one plugin, registered on its own, so a project
+enables only what it wants.
+
+| Pack        | Plugin name    | Rules                                                                                                                                                       |
+| ----------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `anti-slop` | `anti-slop`    | 17 rules that reject low-evidence patterns: `unknown` contracts, unjustified type assertions, `Reflect` calls, runtime `typeof`, module mocking, and so on. |
+| `react`     | `react-policy` | `no-use-effect`: reports every `useEffect` and `useLayoutEffect` call or import.                                                                            |
+| `i18n`      | `i18n`         | `no-hardcoded-jsx-text`: reports words written straight into JSX children.                                                                                  |
+| `expo`      | `expo`         | `static-public-env`: allows only `process.env.NAME` reads, the one form Expo inlines at bundle time.                                                        |
+
+`anti-slop` is a copy of [dmmulroy/anti-slop](https://github.com/dmmulroy/anti-slop), owned and
+edited here (see `src/anti-slop/VENDORED.md` in the source repo). The plugin name is `react-policy`
+and not `react` because oxlint has a built-in plugin called `react`.
+
+## Install
+
+```bash
+npm install --save-dev --save-exact @rdjperron/lint @oxlint/plugins@<version>
+```
+
+The rules import `defineRule` and the AST types from `@oxlint/plugins`, a peer dependency. Its
+version has to match the plugin API of the linter that loads the rules. Under Vite+ that linter
+is inside the `vp` binary, and the authority is the version `vite-plus` declares, not npm latest
+and not the bundled oxlint version:
+
+```bash
+vp why @oxlint/plugins
+# or: node -p "require('vite-plus/package.json').dependencies['@oxlint/plugins']"
+```
+
+Pin `@oxlint/plugins` exactly to that number. The peer range in this package is a caret so an
+exact pin anywhere in the same major satisfies it. Move the pin every time `vp` moves.
+
+## Register a pack
+
+Each pack is a `jsPlugins` entry with its name and its specifier, then rules by `<name>/<rule>`:
+
+```ts
+// vite.config.ts (or .oxlintrc.json, same shape)
+export default defineConfig({
+  lint: {
+    jsPlugins: [
+      { name: "anti-slop", specifier: "@rdjperron/lint/anti-slop" },
+      { name: "react-policy", specifier: "@rdjperron/lint/react" },
+      { name: "i18n", specifier: "@rdjperron/lint/i18n" },
+      { name: "expo", specifier: "@rdjperron/lint/expo" },
+    ],
+    rules: {
+      "anti-slop/no-reflect-get": "error",
+      "react-policy/no-use-effect": [
+        "error",
+        { hint: "The one sanctioned wrapper is useMountEffect." },
+      ],
+      "i18n/no-hardcoded-jsx-text": "error",
+      "expo/static-public-env": "error",
+    },
+  },
+});
+```
+
+Measure before promoting: land a new rule at `warn`, fix or scope what fires, then move it to
+`error`. The anti-slop severities this package's own repo settled on are in its root
+`vite.config.ts`.
+
+### Rule options
+
+- `react-policy/no-use-effect` takes `{ hint?: string }`. The hint is appended to every finding,
+  so a project can name its one sanctioned wrapper. Exempt that wrapper's file with an override.
+- `i18n/no-hardcoded-jsx-text` takes `{ pattern?: string }`, a regex source compiled with the
+  `u` flag. The default `\p{L}{3,}` says three letters in a row is a word; digits, separators and
+  bullets are not. It looks at JSX text and at string literals placed as children, never at
+  attribute values.
+- `expo/static-public-env` has no options. It reports destructuring of `process.env`, computed
+  access, and `process.env` used as a value (assigned, passed, spread, returned).
+
+## The fixtures ship with the package
+
+`fixtures/<pack>/<rule>.fixture.ts(x)` is one deliberately violating file per rule. A rule can
+go silently dead (a linter upgrade, a plugin API skew, an ignore pattern that swallows the wrong
+path), and "reports nothing" looks exactly like "no violations". The consumer's verify script
+lints each fixture directory through its own pipeline and asserts that every rule fired on the
+file named after it. The source repo's `scripts/verify-lint-fixtures.mjs` is the reference
+implementation; copy it and point its suites at
+`node_modules/@rdjperron/lint/fixtures/<pack>`. oxlint skips `node_modules`, so the script lints
+through a symlinked view outside it, and that view must never be gitignored (oxlint honours
+`.gitignore`, and a gitignored view silently disables the whole check).

package/dist/anti-slop.d.mts

@@ -0,0 +1,6 @@
+//#region src/anti-slop/index.d.ts
+/** Generic Oxlint rules that reject low-evidence and low-signal implementation patterns. */
+declare const antiSlopPlugin: import("@oxlint/plugins").Plugin;
+//#endregion
+export { antiSlopPlugin as default };
+//# sourceMappingURL=anti-slop.d.mts.map