Bump to eslint 10 + typescript 6

.github/workflows/build.yml

@@ -28,7 +28,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '>=22.18.0'
+          node-version: '>=24.0.0'
           cache: 'npm'
 
       - name: Setup Rust

.npmrc

@@ -0,0 +1 @@
+engine-strict=true

.nvmrc

@@ -0,0 +1 @@
+24

eslint.config.js

@@ -91,7 +91,6 @@ export default [
     },
     rules: {
       ...astro.configs.recommended.rules,
-      ...astro.configs["jsx-a11y-strict"].rules,
       "no-undef": "off", // TypeScript handles this
     },
   },

package.json

@@ -2,10 +2,16 @@
   "name": "astro-nano",
   "type": "module",
   "version": "1.0.0",
+  "engines": {
+    "node": ">=24.0.0"
+  },
   "scripts": {
     "dev": "astro dev",
     "dev:network": "astro dev --host",
     "build": "astro check && astro build",
+    "typecheck": "npm run typecheck:app && npm run typecheck:playwright",
+    "typecheck:app": "tsc -p tsconfig.json --noEmit",
+    "typecheck:playwright": "tsc -p tsconfig.playwright.json --noEmit",
     "preview": "astro preview",
     "preview:network": "astro preview --host",
     "astro": "astro",
@@ -33,6 +39,7 @@
     "@astrojs/rss": "^4.0.18",
     "@astrojs/sitemap": "^3.7.2",
     "@astrojs/tailwind": "^5.1.5",
+    "@eslint/js": "^10.0.1",
     "@fontsource/inter": "^5.2.8",
     "@fontsource/lora": "^5.2.8",
     "@tailwindcss/typography": "^0.5.19",
@@ -46,14 +53,14 @@
     "astro-icon": "^1.1.5",
     "astro-seo": "^0.8.4",
     "clsx": "^2.1.1",
-    "eslint": "^9.39.4",
+    "eslint": "^10.2.1",
     "eslint-plugin-astro": "^1.7.0",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "sharp": "^0.34.5",
     "tailwind-merge": "^2.6.1",
     "tailwindcss": "^3.4.19",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.3",
     "yaml": "^2.8.3"
   },
   "devDependencies": {
@@ -62,9 +69,14 @@
     "@cspell/dict-npm": "^5.2.38",
     "@cspell/dict-typescript": "^3.2.3",
     "@playwright/test": "^1.59.1",
+    "@types/node": "^22.19.17",
     "cspell": "^10.0.0",
-    "eslint-plugin-jsx-a11y": "^6.10.2",
     "markdownlint-cli2": "^0.22.0",
     "prettier": "^3.8.3"
+  },
+  "overrides": {
+    "@astrojs/check": {
+      "typescript": "$typescript"
+    }
   }
 }

planning/typescript6-item4-subpath-imports-migration.md

@@ -0,0 +1,131 @@
+# Mini-Spec: Migrate TS Path Aliases from `@*` to `#/*` (TypeScript 6)
+
+## Context
+
+This project currently uses a TypeScript path alias pattern based on `@*` in `tsconfig.json`, with imports like `@components/Container.astro`.
+
+TypeScript 6.0 adds support for Node subpath imports starting with `#/` under modern module resolution modes (notably `bundler` and `nodenext`).
+
+This migration standardizes import aliasing on the `#/*` convention so TypeScript, runtime tooling, and ecosystem behavior stay aligned going into TypeScript 7.
+
+## Goals
+
+- Replace internal `@...` import aliases with `#/...` across source files.
+- Configure `package.json#imports` to define the alias at runtime/tooling level.
+- Update TypeScript path mapping to match `#/*`.
+- Preserve existing behavior (no functional app changes).
+
+## Non-Goals
+
+- No content changes.
+- No routing changes.
+- No refactors unrelated to module resolution.
+- No runtime feature or dependency upgrades beyond what is required for alias resolution.
+
+## Scope
+
+In scope:
+
+- `tsconfig.json` path mapping for aliases.
+- `package.json` `imports` field.
+- All internal source imports that currently use `@...`.
+- Validation scripts/build/test commands to ensure alias resolution remains correct.
+
+Out of scope:
+
+- External dependency import style.
+- Renaming directories or moving files.
+
+## Current State
+
+- Alias is configured in TypeScript via:
+  - `compilerOptions.paths`: `"@*": ["./src/*"]`
+- Many source files import through `@...` aliases.
+- Module resolution is already modern (`bundler` via Astro strict config), which is compatible with TS 6 support for `#/` subpath imports.
+
+## Target State
+
+- Imports use `#/...` for internal source paths.
+- `package.json` defines:
+
+```json
+{
+  "imports": {
+    "#/*": "./src/*"
+  }
+}
+```
+
+- `tsconfig.json` defines equivalent `paths` mapping for editor/type-check alignment.
+- Build, checks, and tests pass with no runtime resolution regressions.
+
+## Design
+
+### Configuration
+
+1. Add `imports` mapping in `package.json` for `#/* -> ./src/*`.
+2. Update `tsconfig.json` `paths` from `@*` to `#/*` (or equivalent explicit mapping).
+
+### Code Migration
+
+1. Bulk-rewrite imports from:
+   - `from "@..."` to `from "#/..."`
+2. Verify no remaining `@...` aliases in source/config.
+
+### Validation
+
+Run at minimum:
+
+- `npm run lint`
+- `npm run build`
+- `npm run validate:links`
+- `npm run qa` (if Playwright/browser availability is present)
+
+## Risks and Mitigations
+
+### Risk: Incomplete import rewrite
+
+- Mitigation: grep-based verification for remaining `from "@` occurrences.
+
+### Risk: Tooling mismatch (`imports` vs `paths`)
+
+- Mitigation: keep `package.json#imports` and `tsconfig.json#paths` in lockstep; validate via `tsc -p` and `astro check`/build.
+
+### Risk: Runtime resolution differences in scripts/tests
+
+- Mitigation: validate build and node-executed paths; avoid aliasing in places not covered by configured resolution.
+
+## Rollout Plan
+
+1. Add config changes (`package.json`, `tsconfig.json`).
+2. Rewrite imports in source files.
+3. Run full validation.
+4. Merge as one focused PR/commit series.
+
+## Rollback Plan
+
+If any critical resolution issue appears:
+
+1. Revert migration commit(s).
+2. Restore previous alias mappings and import forms.
+3. Re-run baseline validation.
+
+## Acceptance Criteria
+
+- No source files import internal modules via `@...` aliases.
+- `package.json#imports` contains `#/*` mapping.
+- `tsconfig` path mapping resolves `#/*`.
+- `npm run build` passes.
+- Link validation and lint pass.
+- No observable behavior change in generated site output.
+
+## Estimated Effort
+
+- Implementation: ~1-2 hours
+- Validation/fixes: ~30-60 minutes
+
+## Suggested Commit Strategy
+
+- Commit 1: config updates (`package.json`, `tsconfig.json`)
+- Commit 2: bulk import rewrite
+- Commit 3: any follow-up fixes from validation

tsconfig.json

@@ -2,7 +2,9 @@
   "extends": "astro/tsconfigs/strict",
   "compilerOptions": {
     "strictNullChecks": true,
-    "baseUrl": ".",
+    "types": [
+      "astro/client"
+    ],
     "paths": {
       "@*": [
         "./src/*"
@@ -11,4 +13,4 @@
     "jsx": "react-jsx",
     "jsxImportSource": "react"
   }
-}
+}

tsconfig.playwright.json

@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "types": [
+      "node",
+      "@playwright/test"
+    ]
+  },
+  "include": [
+    "playwright.config.ts",
+    "tests/**/*.ts"
+  ]
+}