chore: Maintenance updates (#143)

Signed-off-by: Dave Skender <8432125+DaveSkender@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

Author: DaveSkender

.github/instructions/code-completion.instructions.md

@@ -7,7 +7,7 @@ description: "Repo-specific code completion checklist extensions for uswds-desig
 
 ## Commands
 
-- Package manager: npm (Node >= 22.17)
+- Package manager: npm (Node >= 24)
 - Install: npm install (use npm ci in CI)
 - Lint: npm run lint
 - Lint (fix): npm run lint:fix
@@ -22,7 +22,7 @@ description: "Repo-specific code completion checklist extensions for uswds-desig
 ## Policies
 
 - Zero-warning policy: lint must pass without errors; warnings allowed but should be addressed before merge.
-- Coverage thresholds (from jest.config.ts): branches 60%, functions 70%, lines 85%, statements 85%
+- Coverage thresholds (from vitest.config.ts): branches 60%, functions 70%, lines 85%, statements 85%
 - PR titles: Conventional but not enforced; prefer feat:, fix:, chore:, docs:, test:, refactor:
 - Required CI checks: build, lint, unit tests, and e2e must pass locally before PR.
 
@@ -55,5 +55,5 @@ npm run e2e
 ## Documentation updates
 
 - Update README.md if commands, minimum Node version, or scripts change.
-- Cross-reference: package.json scripts, angular.json configurations, jest.config.ts, playwright.config.ts.
+- Cross-reference: package.json scripts, angular.json configurations, vitest.config.ts, playwright.config.ts.
 - Exclusions: none.

.github/workflows/deploy-website.yml

@@ -25,7 +25,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: "22"
+          node-version: "24"
           cache: "npm"
           cache-dependency-path: package-lock.json
 

.github/workflows/test-website.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: "22"
+          node-version: "24"
           cache: "npm"
           cache-dependency-path: package-lock.json
 

.markdownlint-cli2.jsonc

@@ -0,0 +1,26 @@
+{
+  "globs": ["**/*.md"],
+  "gitignore": true,
+  "ignores": [
+    "**/node_modules/**",
+    "dist/**",
+    "out/**",
+    "coverage/**",
+    ".angular/**",
+    ".build/**",
+    ".tmp/**"
+  ],
+  "config": {
+    "default": true,
+    "MD003": { "style": "atx" },
+    "MD004": { "style": "dash" },
+    "MD007": { "indent": 2 },
+    "MD013": false, // allow long lines
+    "MD024": { "siblings_only": true },
+    "MD033": true,
+    "MD041": false,
+    "MD046": { "style": "fenced" },
+    "MD048": { "style": "backtick" },
+    "MD060": false
+  }
+}

.markdownlint.json

@@ -8,6 +8,5 @@ node_modules/
 **/*.md
 **/*.markdown
 
-# Keep VS Code workspace JSON/JSONC readable (multiline arrays)
 .vscode/*.json
 .vscode/*.jsonc

.markdownlintignore

@@ -5,8 +5,10 @@
   "useTabs": false,
   "semi": true,
   "singleQuote": false,
-  "trailingComma": "es5",
+  "trailingComma": "none",
   "bracketSpacing": true,
   "arrowParens": "always",
-  "endOfLine": "lf"
+  "endOfLine": "lf",
+  "proseWrap": "preserve",
+  "embeddedLanguageFormatting": "off"
 }

.prettierignore

@@ -0,0 +1,13 @@
+{
+  "servers": {
+    "angular-cli": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "-y",
+        "@angular/cli@latest",
+        "mcp"
+      ]
+    }
+  }
+}

.prettierrc .prettierrc.json.prettierrc renamed to .prettierrc.json

@@ -1,10 +1,164 @@
 {
-  // For more information, visit: https://go.microsoft.com/fwlink/?LinkId=733558
+  // See https://go.microsoft.com/fwlink/?LinkId=733558
+  // for the documentation about the tasks.json format.
+  // Schema: https://code.visualstudio.com/docs/reference/tasks-appendix
+  "$schema": "vscode://schemas/tasks",
   "version": "2.0.0",
+  "presentation": {
+    "clear": true,
+    "panel": "dedicated",
+    "showReuseMessage": false
+  },
+  "problemMatcher": [],
+  "options": {
+    "cwd": "${workspaceFolder}"
+  },
   "tasks": [
+    // ===================================
+    // Install and update dependencies
+    // ===================================
     {
-      // Local dev server (ng serve)
-      "label": "local start",
+      "label": "Install: Node packages",
+      "detail": "Install npm workspace dependencies (npm packages)",
+      "type": "shell",
+      "command": "npm install"
+    },
+    {
+      "label": "Clean: Node packages",
+      "detail": "Delete node_modules and lock files",
+      "type": "npm",
+      "script": "clean"
+    },
+    {
+      "label": "Check: Angular packages",
+      "detail": "Check for dependency updates using Angular CLI for the client website.",
+      "type": "shell",
+      "command": "npx ng update"
+    },
+    {
+      "label": "Update: Angular packages",
+      "detail": "Update dependencies using Angular CLI for the client website.",
+      "type": "shell",
+      "command": "npx ng update @angular/cli @angular/core angular-eslint --allow-dirty"
+    },
+    {
+      "label": "Check: Node packages",
+      "detail": "Check for dependency updates in root and all workspace packages",
+      "type": "shell",
+      "command": "npx npm-check-updates --deep --peer"
+    },
+    {
+      "label": "Update: Node packages",
+      "detail": "Update dependencies in root and all workspace packages to latest versions",
+      "type": "shell",
+      "command": "npx npm-check-updates --deep --peer --upgrade && npm install",
+      "dependsOn": "Update: Angular packages",
+      "dependsOrder": "sequence"
+    },
+    // ===================================
+    // Lint and format
+    // ===================================
+    {
+      "label": "Test",
+      "detail": "Run vitest test suite",
+      "type": "npm",
+      "script": "test",
+      "group": {
+        "kind": "test",
+        "isDefault": true
+      }
+    },
+    {
+      "label": "Lint: All (verify)",
+      "detail": "Run all linters, checks, and tests across the workspace (prettier + markdown + TypeScript + typecheck + tests)",
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "dependsOn": [
+        "Lint: Markdown (verify)",
+        "Lint: Prettier (verify)",
+        "Lint: TypeScript (verify)",
+        "Lint: Typecheck (verify)",
+        "Test"
+      ],
+      "dependsOrder": "parallel",
+      "problemMatcher": [
+        "$markdownlint",
+        "$eslint-stylish",
+        "$tsc"
+      ]
+    },
+    {
+      "label": "Lint: All (fix)",
+      "detail": "Run all linters with auto-fix across the workspace (prettier + markdown + TypeScript)",
+      "dependsOn": [
+        "Install: Node packages",
+        "Lint: Prettier (fix)",
+        "Lint: Markdown (fix)",
+        "Lint: TypeScript (fix)"
+      ],
+      "dependsOrder": "sequence",
+      "problemMatcher": [
+        "$markdownlint",
+        "$eslint-stylish",
+        "$tsc"
+      ]
+    },
+    {
+      "label": "Lint: Markdown (verify)",
+      "detail": "Verify formatting for all markdown files",
+      "type": "shell",
+      "command": "npx markdownlint-cli2",
+      "problemMatcher": "$markdownlint"
+    },
+    {
+      "label": "Lint: Markdown (fix)",
+      "detail": "Auto-fix formatting for all markdown files",
+      "type": "shell",
+      "command": "npx markdownlint-cli2 --fix",
+      "problemMatcher": "$markdownlint"
+    },
+    {
+      "label": "Lint: Prettier (verify)",
+      "detail": "Run Prettier check across the workspace",
+      "type": "npm",
+      "script": "lint:prettier"
+    },
+    {
+      "label": "Lint: Prettier (fix)",
+      "detail": "Run Prettier write across the workspace",
+      "type": "npm",
+      "script": "lint:prettier:fix",
+      "dependsOn": "Install: Node packages",
+      "dependsOrder": "sequence"
+    },
+    {
+      "label": "Lint: TypeScript (verify)",
+      "detail": "Run ESLint on TypeScript files",
+      "type": "npm",
+      "script": "lint:ts",
+      "problemMatcher": "$eslint-stylish"
+    },
+    {
+      "label": "Lint: TypeScript (fix)",
+      "detail": "Auto-fix ESLint issues in TypeScript files",
+      "type": "npm",
+      "script": "lint:ts:fix",
+      "problemMatcher": "$eslint-stylish"
+    },
+    {
+      "label": "Lint: Typecheck (verify)",
+      "detail": "Run TypeScript type checking without emitting files",
+      "type": "npm",
+      "script": "typecheck",
+      "problemMatcher": "$tsc"
+    },
+    // ===================================
+    // Serve application
+    // ===================================
+    {
+      "label": "Run: Website dev server",
       "type": "npm",
       "script": "start",
       "isBackground": true,