From 32d9268d4a2ecca241b8a40f96b1e95852c2c053 Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Sun, 12 Jul 2026 23:41:59 +0800
Subject: [PATCH] docs: preserve concise config rationale

---
 eslint.config.mjs | 3 ---
 vitest.config.ts  | 4 ++--
 2 files changed, 2 insertions(+), 5 deletions(-)

diff --git a/eslint.config.mjs b/eslint.config.mjs
index 2789644283..2714f66ac3 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -1,9 +1,6 @@
 import stylistic from '@stylistic/eslint-plugin'
 import tseslint from 'typescript-eslint'
 
-/**
- * ESLint flat config. Two layers.
- */
 export default tseslint.config(
   {
     ignores: [
diff --git a/vitest.config.ts b/vitest.config.ts
index b55b6b25d9..b4bfbbbef3 100644
--- a/vitest.config.ts
+++ b/vitest.config.ts
@@ -2,8 +2,8 @@ import tsconfigPaths from 'vite-tsconfig-paths'
 import { defineConfig } from 'vitest/config'
 
 export default defineConfig({
-  // Vite ≥8 warns that this plugin can be replaced by the native (experimental)
-  // `resolve.tsconfigPaths: true`.
+  // Native path resolution reads each package's nearest tsconfig, but only the root defines
+  // workspace paths. Keep this plugin pinned to the root map.
   plugins: [tsconfigPaths({ projects: ['./tsconfig.json'] })],
   test: {
     include: ['packages/*/*/tests/**/*.spec.ts', 'examples/*/tests/**/*.spec.ts'],