docs: add explanatory comments for dependency compatibility workarounds

Agent-Logs-Url: https://github.com/xebia/github-copilot-premium-reqs-usage/sessions/c52c160a-59a0-4df8-bebb-c23200b4428f

Co-authored-by: rajbos <6085745+rajbos@users.noreply.github.com>

Author: Copilot

tsconfig.json

@@ -20,6 +20,8 @@
     /* Linting */
     "noFallthroughCasesInSwitch": true,
     "noUncheckedSideEffectImports": true,
+    // Required for TypeScript 6.0: baseUrl is deprecated in TS6 but still needed for path aliases.
+    // Remove when migrating to moduleResolution: "bundler" with explicit path mappings.
     "ignoreDeprecations": "6.0",
     "baseUrl": ".",
     "paths": {

vite.config.js

@@ -60,6 +60,10 @@ export default defineConfig({
       ])
     ),
   },
+  // Workaround: Tailwind CSS 4.x generates CSS patterns (e.g. @media container queries) that
+  // lightningcss (Vite 8's default CSS minifier) cannot parse. errorRecovery allows the build
+  // to succeed by skipping unrecognised CSS rather than failing. Monitor lightningcss/Tailwind
+  // releases for when this can be removed.
   css: {
     lightningcss: {
       errorRecovery: true,

vite.github-pages.config.ts

@@ -32,6 +32,10 @@ export default defineConfig({
     react(),
     tailwindcss(),
   ],
+  // Workaround: Tailwind CSS 4.x generates CSS patterns (e.g. @media container queries) that
+  // lightningcss (Vite 8's default CSS minifier) cannot parse. errorRecovery allows the build
+  // to succeed by skipping unrecognised CSS rather than failing. Monitor lightningcss/Tailwind
+  // releases for when this can be removed.
   css: {
     lightningcss: {
       errorRecovery: true,