docs update

Author: dake3601

_artifacts/domain_map.yaml

@@ -231,7 +231,7 @@ skills:
 
       - mistake: 'Source injection on spread props elements'
         mechanism: >
-          The Babel transform skips elements with {...props} spread to avoid
+          The AST transform skips elements with {...props} spread to avoid
           overwriting dynamic attributes. Agent might not realize source
           inspector wont work on those elements.
         source: 'packages/devtools-vite/src/inject-source.ts'

docs/architecture.md

@@ -194,7 +194,7 @@ Adapters do not re-implement the devtools UI, manage settings, handle events, or
 `@tanstack/devtools-vite` is a collection of Vite plugins that enhance the development experience and clean up production builds. It returns an array of Vite plugins, each handling a specific concern:
 
 ### Source injection (`@tanstack/devtools:inject-source`)
-Uses Babel to parse JSX/TSX files and injects `data-tsd-source` attributes on every JSX element. These attributes encode the file path, line number, and column number of each element in source code, which the source inspector feature uses to implement click-to-open-in-editor.
+Parses JSX/TSX files with oxc-parser and injects `data-tsd-source` attributes on every JSX element via MagicString. These attributes encode the file path, line number, and column number of each element in source code, which the source inspector feature uses to implement click-to-open-in-editor.
 
 ### Server event bus (`@tanstack/devtools:custom-server`)
 Starts a `ServerEventBus` on the Vite dev server. Also sets up middleware for the go-to-source editor integration and bidirectional console piping (client logs appear in the terminal, server logs appear in the browser).

docs/source-inspector.md

@@ -18,13 +18,13 @@ The feature only works in development. In production builds, source attributes a
 
 ```mermaid
 flowchart LR
-    A["Your JSX/TSX files"] -- "Babel transform" --> B["data-tsd-source<br/>attributes injected"]
+    A["Your JSX/TSX files"] -- "AST transform" --> B["data-tsd-source<br/>attributes injected"]
     B -- "Hold inspect hotkey<br/>+ click element" --> C["Devtools reads<br/>data-tsd-source"]
     C -- "HTTP request" --> D["Vite dev server"]
     D -- "launch-editor" --> E["Opens file in editor<br/>at exact line"]
 ```
 
-The Vite plugin uses Babel to parse your JSX/TSX files during development. It adds a `data-tsd-source="filepath:line:column"` attribute to every JSX element. When you activate the source inspector and click an element, the devtools reads this attribute and sends a request to the Vite dev server. The server then launches your editor at the specified file and line using `launch-editor`.
+The Vite plugin uses oxc-parser to parse your JSX/TSX files during development. It adds a `data-tsd-source="filepath:line:column"` attribute to every JSX element via MagicString. When you activate the source inspector and click an element, the devtools reads this attribute and sends a request to the Vite dev server. The server then launches your editor at the specified file and line using `launch-editor`.
 
 ## Activating the Inspector
 

docs/vite-plugin.md

@@ -209,7 +209,7 @@ The Vite plugin is composed of several sub-plugins, each handling a specific con
 ```mermaid
 graph TD
     vite["@tanstack/devtools-vite"]
-    vite --> source["Source Injection<br/><i>Babel → data-tsd-source attrs</i>"]
+    vite --> source["Source Injection<br/><i>AST → data-tsd-source attrs</i>"]
     vite --> server["Server Event Bus<br/><i>WebSocket + SSE transport</i>"]
     vite --> strip["Production Stripping<br/><i>Remove devtools on build</i>"]
     vite --> pipe["Console Piping<br/><i>Client ↔ Server logs</i>"]
@@ -220,7 +220,7 @@ graph TD
 
 ### Go to Source
 
-The "Go to Source" feature lets you click on any element in your browser and open its source file in your editor at the exact line where it's defined. It works by injecting `data-tsd-source` attributes into your components via a Babel transformation during development. These attributes encode the file path and line number of each element.
+The "Go to Source" feature lets you click on any element in your browser and open its source file in your editor at the exact line where it's defined. It works by injecting `data-tsd-source` attributes into your components via an AST transformation during development. These attributes encode the file path and line number of each element.
 
 To use it, activate the source inspector by holding the inspect hotkey (default: Shift+Alt+Ctrl/Meta). An overlay will highlight elements under your cursor and display their source location. Clicking on a highlighted element opens the corresponding file in your editor at the exact line, powered by `launch-editor` under the hood.
 

packages/devtools-vite/skills/devtools-vite-plugin/SKILL.md

@@ -67,21 +67,21 @@ From `packages/devtools-vite/src/index.ts`:
 
 | Sub-plugin name                               | What it does                                                                                                       | When active                                                |
 | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------- |
-| `@tanstack/devtools:inject-source`            | Babel transform adding `data-tsd-source` attrs to JSX                                                              | dev mode + `injectSource.enabled`                          |
+| `@tanstack/devtools:inject-source`            | AST transform adding `data-tsd-source` attrs to JSX                                                              | dev mode + `injectSource.enabled`                          |
 | `@tanstack/devtools:config`                   | Reserved for future config modifications                                                                           | serve command only                                         |
 | `@tanstack/devtools:custom-server`            | Starts ServerEventBus, registers middleware for open-source/console-pipe endpoints                                 | dev mode                                                   |
 | `@tanstack/devtools:remove-devtools-on-build` | Strips devtools imports/JSX from production bundles                                                                | build command or production mode + `removeDevtoolsOnBuild` |
 | `@tanstack/devtools:event-client-setup`       | Marketplace: listens for install/add-plugin events via devtoolsEventClient                                         | dev mode + serve + not CI                                  |
 | `@tanstack/devtools:console-pipe-transform`   | Injects runtime console-pipe code into entry files                                                                 | dev mode + serve + `consolePiping.enabled`                 |
-| `@tanstack/devtools:better-console-logs`      | Babel transform prepending source location to `console.log`/`console.error`                                        | dev mode + `enhancedLogs.enabled`                          |
+| `@tanstack/devtools:better-console-logs`      | AST transform prepending source location to `console.log`/`console.error`                                        | dev mode + `enhancedLogs.enabled`                          |
 | `@tanstack/devtools:inject-plugin`            | Detects which file imports TanStackDevtools (for marketplace injection)                                            | dev mode + serve                                           |
 | `@tanstack/devtools:connection-injection`     | Replaces `__TANSTACK_DEVTOOLS_PORT__`, `__TANSTACK_DEVTOOLS_HOST__`, `__TANSTACK_DEVTOOLS_PROTOCOL__` placeholders | dev mode + serve                                           |
 
 ## Subsystem Details
 
 ### Source Injection
 
-Adds `data-tsd-source="<relative-path>:<line>:<column>"` attributes to every JSX opening element via Babel. This powers the "Go to Source" feature -- hold the inspect hotkey (default: Shift+Alt+Ctrl/Meta), hover over elements, click to open in editor.
+Adds `data-tsd-source="<relative-path>:<line>:<column>"` attributes to every JSX opening element via oxc-parser + MagicString. This powers the "Go to Source" feature -- hold the inspect hotkey (default: Shift+Alt+Ctrl/Meta), hover over elements, click to open in editor.
 
 **Key behaviors:**
 
@@ -137,7 +137,7 @@ devtools({
 
 ### Enhanced Logging
 
-Babel transform that prepends source location info to `console.log()` and `console.error()` calls. In the browser, this renders as a clickable "Go to Source" link. On the server, it shows `LOG <path>:<line>:<column>` in chalk colors.
+AST transform that prepends source location info to `console.log()` and `console.error()` calls. In the browser, this renders as a clickable "Go to Source" link. On the server, it shows `LOG <path>:<line>:<column>` in chalk colors.
 
 The transform inserts a spread of a conditional expression: `...(typeof window === 'undefined' ? serverLogMessage : browserLogMessage)` as the first argument of the console call.
 
@@ -261,7 +261,7 @@ Source injection, console piping, enhanced logging, the server event bus, and th
 
 ### 4. Source injection on spread-props elements (MEDIUM)
 
-The Babel transform in `inject-source.ts` explicitly skips any JSX element that has a `{...props}` spread where `props` is the component's parameter name. This is intentional -- the spread would overwrite the injected `data-tsd-source` attribute. If source inspection doesn't work for a specific component, check if it spreads its props parameter.
+The AST transform in `inject-source.ts` explicitly skips any JSX element that has a `{...props}` spread where `props` is the component's parameter name. This is intentional -- the spread would overwrite the injected `data-tsd-source` attribute. If source inspection doesn't work for a specific component, check if it spreads its props parameter.
 
 ```tsx
 // data-tsd-source will NOT be injected on <div> here
@@ -301,8 +301,8 @@ These are registered on the Vite dev server (not the event bus server):
 ## Key Source Files
 
 - `packages/devtools-vite/src/plugin.ts` -- Main plugin factory with all sub-plugins and config type
-- `packages/devtools-vite/src/inject-source.ts` -- Babel transform for data-tsd-source injection
-- `packages/devtools-vite/src/enhance-logs.ts` -- Babel transform for enhanced console logs
+- `packages/devtools-vite/src/inject-source.ts` -- AST transform for data-tsd-source injection
+- `packages/devtools-vite/src/enhance-logs.ts` -- AST transform for enhanced console logs
 - `packages/devtools-vite/src/remove-devtools.ts` -- Production stripping transform
 - `packages/devtools-vite/src/virtual-console.ts` -- Console pipe runtime code generator
 - `packages/devtools-vite/src/editor.ts` -- Editor config type and launch-editor integration

packages/devtools-vite/skills/devtools-vite-plugin/references/vite-options.md

@@ -43,7 +43,7 @@ declare function defineDevtoolsConfig(
 
 ## `injectSource`
 
-Controls source injection -- the Babel transform that adds `data-tsd-source` attributes to JSX elements for the "Go to Source" feature.
+Controls source injection -- the AST transform that adds `data-tsd-source` attributes to JSX elements for the "Go to Source" feature.
 
 | Field               | Type                      | Default     | Description                                                                                                                                                                                              |
 | ------------------- | ------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
@@ -117,7 +117,7 @@ devtools({
 
 ## `enhancedLogs`
 
-Controls the Babel transform that prepends source location information to `console.log()` and `console.error()` calls.
+Controls the AST transform that prepends source location information to `console.log()` and `console.error()` calls.
 
 | Field     | Type      | Default | Description                                                                                                                                                                                           |
 | --------- | --------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

packages/devtools-vite/src/offset-to-loc.ts

@@ -1,7 +1,7 @@
 export interface Loc {
-  /** 1-based line number (matches Babel convention) */
+  /** 1-based line number */
   line: number
-  /** 0-based column offset (matches Babel convention) */
+  /** 0-based column offset */
   column: number
 }
 

packages/devtools/skills/devtools-marketplace/SKILL.md

@@ -222,7 +222,7 @@ The auto-install pipeline lives in `packages/devtools-vite/src/inject-plugin.ts`
 
 1. **Package installation** -- The Vite plugin detects the project's package manager and runs the appropriate install command.
 2. **File detection** -- It scans project files for imports from `@tanstack/react-devtools`, `@tanstack/solid-devtools`, `@tanstack/vue-devtools`, etc.
-3. **AST transformation** -- It parses the file with Babel, finds the `<TanStackDevtools />` JSX element, and modifies the `plugins` prop.
+3. **AST transformation** -- It parses the file with oxc-parser, finds the `<TanStackDevtools />` JSX element, and modifies the `plugins` prop via MagicString.
 4. **Import insertion** -- It adds `import { <importName> } from '<packageName>'` after the last existing import.
 5. **Plugin injection** -- Based on `pluginImport.type`:
    - `'function'`: Appends `ImportName()` directly to the plugins array

packages/devtools/skills/devtools-production/SKILL.md

@@ -31,7 +31,7 @@ TanStack Devtools has two independent mechanisms for keeping devtools out of pro
 
 The `@tanstack/devtools-vite` plugin includes a sub-plugin named `@tanstack/devtools:remove-devtools-on-build`. When `removeDevtoolsOnBuild` is `true` (the default), this plugin runs during `vite build` and any non-`serve` command where the mode is `production`.
 
-It uses Babel to parse every source file, find imports from these packages, and remove them along with any JSX elements they produce:
+It uses oxc-parser to parse every source file, find imports from these packages, and remove them along with any JSX elements they produce:
 
 - `@tanstack/react-devtools`
 - `@tanstack/preact-devtools`
@@ -452,7 +452,7 @@ For staging/preview environments where you want devtools but not in the final pr
 ## Key Source Files
 
 - `packages/devtools-vite/src/plugin.ts` -- Vite plugin entry, `removeDevtoolsOnBuild` option, sub-plugin registration
-- `packages/devtools-vite/src/remove-devtools.ts` -- AST-based stripping logic (Babel parse, traverse, codegen)
+- `packages/devtools-vite/src/remove-devtools.ts` -- AST-based stripping logic (oxc-parser + MagicString)
 - `packages/devtools/package.json` -- Conditional exports (`browser.development` -> `dev.js`, `browser` -> `index.js`, `node`/`workerd` -> `server.js`)
 - `packages/devtools/tsup.config.ts` -- Build config producing `dev.js`, `index.js`, `server.js` via `tsup-preset-solid`
 - `packages/devtools-utils/src/react/plugin.tsx` -- `createReactPlugin` returning `[Plugin, NoOpPlugin]`