@timmo001/oxlint-rules 0.4.0 → 0.5.0

package/README.md

@@ -79,15 +79,46 @@ The recommended configs disable
 `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.
+  returns `null` when the element is missing or has the wrong type. Assertions
+  that `prefer-event-parameter-type` reports are skipped here.
 
 ### `timmo-effect`
 
@@ -96,6 +127,11 @@ explicit use.
   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