feat: Eslint disposable test hooks (#49)

* add eslint rule to prefer disposables over test hooks

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

* fix lint order and rule test harness paths

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

* Fix hook detection for known test hooks

* Fix outer write detection for destructuring

* Fix known framework hooks for suite hooks

* document dispose rule and migrate tests to RuleTester

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

* organize eslint rule assets under eslint-rules

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

* optimize custom rule for oxlint js plugins

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

* handle null context options in oxlint compat path

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

* compute source and options in before hook for compat

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

* rename eslint-rules directory to lint-rules

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

* align prefer-dispose docs and plugin with main lint-rules layout

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

* enable prefer-dispose rule in oxlint config

Co-authored-by: Kent C. Dodds <me+github@kentcdodds.com>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>

Author: kentcdodds

eslint-plugin-epic-web.js

@@ -0,0 +1,3 @@
+export { default } from './lint-rules/epic-web-plugin.js'
+export { default as noManualDisposeRule } from './lint-rules/no-manual-dispose.js'
+export { default as preferDisposeInTestsRule } from './lint-rules/prefer-dispose-in-tests.js'

eslint.js

@@ -251,6 +251,13 @@ export const config = [
 		},
 	},
 
+	{
+		files: testFiles,
+		rules: {
+			'epic-web/prefer-dispose-in-tests': WARN,
+		},
+	},
+
 	hasTestingLibrary
 		? {
 				files: testFiles,

lint-rules/epic-web-plugin.js

@@ -1,13 +1,16 @@
 import { eslintCompatPlugin } from '@oxlint/plugins'
 import noManualDispose from './no-manual-dispose.js'
+import preferDisposeInTests from './prefer-dispose-in-tests.js'
 
 const plugin = eslintCompatPlugin({
 	meta: {
 		name: 'epic-web',
 	},
 	rules: {
 		'no-manual-dispose': noManualDispose,
+		'prefer-dispose-in-tests': preferDisposeInTests,
 	},
 })
 
 export default plugin
+export { noManualDispose, preferDisposeInTests }

lint-rules/index.md

@@ -15,3 +15,4 @@ remaining ESLint-compatible.
 ## Rules
 
 - [`epic-web/no-manual-dispose`](./no-manual-dispose.md)
+- [`epic-web/prefer-dispose-in-tests`](./prefer-dispose-in-tests.md)