@timmo001/oxlint-rules 0.3.6 → 0.5.0

package/README.md

@@ -74,12 +74,51 @@ replace an existing destination unless `--force` is passed.
 ### `anti-slop` and `anti-slop-effect`
 
 See the upstream [rule documentation](https://github.com/dmmulroy/anti-slop#rules).
+The recommended configs disable
+`anti-slop/require-safety-comment-for-type-assertion` in favour of
+`timmo/prefer-types-over-assertions`. The upstream rule remains available for
+explicit use.
+
+### Oxlint built-in rules
+
+The recommended configs also enable `typescript/no-non-null-assertion`,
+`typescript/no-unnecessary-type-arguments`,
+`typescript/no-unnecessary-type-assertion`, and
+`typescript/no-unnecessary-type-parameters`. The last three are type-aware, so
+they only run when the consumer enables `typeAware`.
 
 ### `timmo`
 
+- `no-explicit-inferable-type-predicate`: reports explicit `x is T` predicates on
+  non-exported functions whose whole body is a null or `undefined` exclusion, a
+  `typeof` comparison, or an `instanceof` check. TypeScript 5.5 and later infer
+  those predicates, and an explicit predicate is never checked against the
+  body. Methods, exported functions, and `asserts` predicates are left alone.
+- `no-unchecked-query-selector-type`: reports type arguments on
+  `querySelector`, `querySelectorAll`, and `closest`, which cast the result
+  without checking it. Check the element with `instanceof`, use a checked lookup
+  helper, or query a tag name so TypeScript infers the type. Static render-root
+  queries in Lit elements are left to `prefer-lit-query-decorators`.
+- `no-untyped-custom-event`: reports `CustomEvent` used as a type without a
+  detail type, which leaves `detail` as `any`. Reuse the project's typed event
+  helper or add one.
 - `prefer-event-parameter-type`: reports assertions on a handler parameter's
-  `target` or `currentTarget`. Express the target type in the function signature
-  instead so every use sees the same contract.
+  `target`, `currentTarget`, or `detail` (including nested `detail` members).
+  Express the type in the function signature instead so every use sees the same
+  contract.
+- `prefer-lit-query-decorators`: follows eslint-plugin-lit's
+  [`prefer-query-decorators`](https://github.com/43081j/eslint-plugin-lit/blob/master/docs/rules/prefer-query-decorators.md),
+  including its options and `settings.lit.elementBaseClasses`. It also catches
+  non-null, optional, and asserted render roots such as
+  `this.shadowRoot!.querySelector(...)`, and resolves `this` so nested classes
+  and plain functions are not reported. Only static selectors are reported,
+  because a query decorator cannot express a selector built at runtime. Turn
+  off `lit/prefer-query-decorators` when using this rule.
+- `prefer-types-over-assertions`: reports non-`const` TypeScript assertions,
+  even when preceded by a `SAFETY:` comment. Type values where they enter the
+  code, for example in function parameters or a checked DOM lookup helper that
+  returns `null` when the element is missing or has the wrong type. Assertions
+  that `prefer-event-parameter-type` reports are skipped here.
 
 ### `timmo-effect`
 
@@ -88,6 +127,11 @@ See the upstream [rule documentation](https://github.com/dmmulroy/anti-slop#rule
   form. It leaves ordinary async polling, nested callback boundaries,
   non-Effect generators, and `try/finally` cleanup alone. The rule is
   diagnostic-only because catch bodies cannot be rewritten safely in general.
+- `prefer-platform-services`: in modules that import `effect`, `effect/*`, or
+  `@effect/*`, reports Node `child_process` and `fs` imports and Bun's `spawn`,
+  `spawnSync`, `$`, `file`, and `write`. Use `ChildProcessSpawner` from
+  `effect/process` and the `FileSystem` service so cleanup, interruption, typed
+  failures, and test layers apply. `fetch` is not reported.
 
 ## Development
 
@@ -104,8 +148,9 @@ bunx jsr@0.14.3 publish --dry-run --allow-dirty
 
 `bun run lint` builds the local plugins before linting all maintained code,
 including tests, tooling, the root config and packaged skill scripts. The root
-config extends the local `recommended-effect` source config, enabling every
-registered rule in `anti-slop`, `timmo`, `anti-slop-effect` and `timmo-effect`.
+config extends the local `recommended-effect` source config, enabling registered
+rules in `anti-slop`, `timmo`, `anti-slop-effect` and `timmo-effect` except for
+the upstream safety-comment requirement described above.
 Plugin imports resolve through this package's exports to the fresh `dist` build.
 
 Lint disables nested configs so the vendored submodule's config cannot override