update doc

Author: Brooooooklyn

packages/test/BUNDLING.md

@@ -284,21 +284,22 @@ When upgrading the vitest version:
 ### Build Flow
 
 ```
-1. bundleVitest()           Copy vitest-dev dist/ -> dist/
-2. copyVitestPackages()     Copy @vitest/* -> dist/@vitest/
-3. convertTabsToSpaces()    Normalize formatting for patches
-4. collectLeafDependencies() Parse imports with oxc-parser
-5. bundleLeafDeps()         Bundle chai, pathe, etc -> dist/vendor/
-6. rewriteVitestImports()   Rewrite @vitest/*, vitest/*, vite
-7. patchVitestPkgRootPaths() Fix distRoot for relocated files
+1. bundleVitest()              Copy vitest-dev dist/ -> dist/
+2. copyVitestPackages()        Copy @vitest/* -> dist/@vitest/
+3. convertTabsToSpaces()       Normalize formatting for patches
+4. collectLeafDependencies()   Parse imports with oxc-parser
+5. bundleLeafDeps()            Bundle chai, pathe, etc -> dist/vendor/
+6. rewriteVitestImports()      Rewrite @vitest/*, vitest/*, vite
+7. patchVitestPkgRootPaths()   Fix distRoot for relocated files
 8. patchVitestBrowserPackage() Inject vendor-aliases plugin
-9. patchPlaywrightLocators() Fix browser-safe imports
+9. patchBrowserProviderLocators() Fix browser-safe imports
 10. Post-processing:
     - patchVendorPaths()
     - createBrowserCompatShim()
     - createModuleRunnerStub()   Browser-safe stub
     - createNodeEntry()          index-node.js with browser-provider
     - copyBrowserClientFiles()
+    - createBrowserEntryFiles()  browser/ entry files at package root
     - createPluginExports()      dist/plugins/* for pnpm overrides
     - mergePackageJson()
     - validateExternalDeps()
@@ -307,6 +308,9 @@ When upgrading the vitest version:
 ### Output Structure
 
 ```
+browser/                       # Entry files for ./browser export
+├── context.js                 # Runtime guard (throws if not in browser)
+└── context.d.ts               # Re-exports from dist/@vitest/browser/context.d.ts
 dist/
 ├── @vitest/                    # Copied packages (browser/Node.js safe)
 │   ├── runner/
@@ -355,6 +359,7 @@ This is achieved through:
 4. `vendor-aliases` plugin injection to resolve imports at runtime:
    - Handles `@vitest/*` imports → resolves to copied `dist/@vitest/` files
    - Handles `vitest/*` subpaths → resolves to dist files (enables `vitest/browser-playwright` usage)
+   - Handles `vitest/browser-playwright`, `vitest/browser-webdriverio`, `vitest/browser-preview` → resolves to bundled browser providers
    - Handles `@voidzero-dev/vite-plus-test/*` subpaths → maps to equivalent vitest paths
    - Handles `@voidzero-dev/vite-plus/test/*` subpaths → maps to equivalent vitest paths (CLI package)
    - Intercepts `vitest/browser`, `@voidzero-dev/vite-plus-test/browser`, `@voidzero-dev/vite-plus/test/browser` → returns virtual module ID for BrowserContext plugin

packages/test/build.ts

@@ -1213,6 +1213,10 @@ async function patchVitestBrowserPackage() {
         'vitest/reporters': resolve(packageRoot, 'reporters.js'),
         'vitest/snapshot': resolve(packageRoot, 'snapshot.js'),
         'vitest/mocker': resolve(packageRoot, 'mocker.js'),
+        // Browser providers - resolve to our bundled @vitest/browser-* packages
+        'vitest/browser-playwright': resolve(packageRoot, '@vitest/browser-playwright/index.js'),
+        'vitest/browser-webdriverio': resolve(packageRoot, '@vitest/browser-webdriverio/index.js'),
+        'vitest/browser-preview': resolve(packageRoot, '@vitest/browser-preview/index.js'),
       };
       if (vitestSubpathMap[id]) {
         return vitestSubpathMap[id];
@@ -1298,7 +1302,7 @@ async function patchVitestBrowserPackage() {
 
   // 4. Patch BrowserContext to also handle our package aliases as fallback
   // This allows direct imports from our package without requiring vitest override
-  // Supports: @voidzero-dev/vite-plus-test/browser, @voidzero-dev/vite-plus/test/browser
+  // Supports: vitest/browser, @voidzero-dev/vite-plus-test/browser, @voidzero-dev/vite-plus/test/browser
   const browserContextPattern = /if \(id === ID_CONTEXT\) \{/;
   if (browserContextPattern.test(content)) {
     content = content.replace(
@@ -1373,7 +1377,7 @@ async function patchBrowserProviderLocators() {
       // webdriverio/preview: import page from context.js, keep other imports from index.js
       const extraImportsStr = provider.extraImports.join(', ');
       const importPattern = new RegExp(
-        `import \\{ page, server, ${extraImportsStr.replace(/, /g, ', ')} \\} from ['"]\\.\\.\/browser\/index\\.js['"];?`,
+        `import \\{ page, server, ${extraImportsStr} \\} from ['"]\\.\\.\/browser\/index\\.js['"];?`,
       );
       if (importPattern.test(content)) {
         const replacement = `import { page } from '../browser/context.js';\nimport { ${extraImportsStr} } from '../browser/index.js';`;