chore: migrate from eslint to oxlint and update configurations

- Added .oxlintrc.json for oxlint configuration, disabling unused variable checks.
- Removed eslint.config.js as it is no longer needed.
- Updated package.json and package-lock.json to use oxlint and the latest dependencies.
- Adjusted GitHub Actions workflow to reflect the change from eslint to oxlint.
- Introduced new TypeScript files for setup and testing functionalities.
- Updated TypeScript configurations in example exercises to include node types.

Author: kentcdodds

.github/workflows/validate.yml

@@ -35,7 +35,7 @@ jobs:
         run: npm run typecheck
         working-directory: ./workshop
 
-      - name: ⬣ ESLint
+      - name: ⬣ Oxlint
         run: npm run lint
         working-directory: ./workshop
 
@@ -60,7 +60,7 @@ jobs:
 
       - name: 🧪 Run tests
         id: run_tests
-        run: node ./epicshop/test.js ..s
+        run: node ./epicshop/test.ts ..s
 
   deploy:
     name: 🚀 Deploy

.oxlintrc.json

@@ -0,0 +1,6 @@
+{
+  "extends": ["./node_modules/@epic-web/config/oxlint-config.json"],
+  "rules": {
+    "eslint/no-unused-vars": "off"
+  }
+}

epicshop/fix-watch.js epicshop/fix-watch.tsepicshop/fix-watch.js renamed to epicshop/fix-watch.ts

@@ -4,15 +4,15 @@ import chokidar from 'chokidar'
 import { $ } from 'execa'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const here = (...p) => path.join(__dirname, ...p)
+const here = (...p: Array<string>) => path.join(__dirname, ...p)
 
 const workshopRoot = here('..')
 
 // Watch the exercises directory
 const watcher = chokidar.watch(path.join(workshopRoot, 'exercises'), {
 	ignored: [
-		/(^|[\/\\])\../, // ignore dotfiles
-		(path) => {
+		/(^|[/\\])\./, // ignore dotfiles
+		(path: string) => {
 			// Only watch directories up to depth 2
 			const relativePath = path.slice(workshopRoot.length + 1)
 			return relativePath.split('/').length > 4
@@ -26,20 +26,20 @@ const debouncedRun = debounce(run, 200)
 
 // Add event listeners.
 watcher
-	.on('addDir', (path) => {
+	.on('addDir', (_path: string) => {
 		debouncedRun()
 	})
-	.on('unlinkDir', (path) => {
+	.on('unlinkDir', (_path: string) => {
 		debouncedRun()
 	})
-	.on('error', (error) => console.log(`Watcher error: ${error}`))
+	.on('error', (error: unknown) => console.log(`Watcher error: ${error}`))
 
 /**
  * Simple debounce implementation
  */
-function debounce(fn, delay) {
-	let timer = null
-	return (...args) => {
+function debounce(fn: (...args: Array<unknown>) => unknown, delay: number) {
+	let timer: ReturnType<typeof setTimeout> | null = null
+	return (...args: Array<unknown>) => {
 		if (timer) clearTimeout(timer)
 		timer = setTimeout(() => {
 			fn(...args)
@@ -59,9 +59,7 @@ async function run() {
 		await $({
 			stdio: 'inherit',
 			cwd: workshopRoot,
-		})`node ./epicshop/fix.js`
-	} catch (error) {
-		throw error
+		})`node ./epicshop/fix.ts`
 	} finally {
 		running = false
 	}

epicshop/fix.js epicshop/fix.tsepicshop/fix.js renamed to epicshop/fix.ts

@@ -1,15 +1,12 @@
 // This should run by node without any dependencies
 // because you may need to run it without deps.
 
-import cp from 'node:child_process'
 import fs from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const here = (...p) => path.join(__dirname, ...p)
-const VERBOSE = false
-const logVerbose = (...args) => (VERBOSE ? console.log(...args) : undefined)
+const here = (...p: Array<string>) => path.join(__dirname, ...p)
 
 const workshopRoot = here('..')
 const examples = (await readDir(here('../examples'))).map(dir =>
@@ -44,7 +41,7 @@ const appsWithPkgJson = [...examples, ...apps].filter(app => {
 // e.g. exercises/01-goo/problem.01-great
 // name: "exercises__sep__01-goo.problem__sep__01-great"
 
-function relativeToWorkshopRoot(dir) {
+function relativeToWorkshopRoot(dir: string) {
 	return dir.replace(`${workshopRoot}${path.sep}`, '')
 }
 
@@ -90,25 +87,25 @@ async function updateTsconfig() {
 	}
 }
 
-async function writeIfNeeded(filepath, content) {
+async function writeIfNeeded(filepath: string, content: string, _opts?: { parser: string }) {
 	const oldContent = await fs.promises.readFile(filepath, 'utf8')
 	if (oldContent !== content) {
 		await fs.promises.writeFile(filepath, content)
 	}
 	return oldContent !== content
 }
 
-function exists(p) {
+function exists(p: string) {
 	if (!p) return false
 	try {
 		fs.statSync(p)
 		return true
-	} catch (error) {
+	} catch {
 		return false
 	}
 }
 
-async function readDir(dir) {
+async function readDir(dir: string) {
 	if (exists(dir)) {
 		return fs.promises.readdir(dir)
 	}