refactor: rename devtools APIs to devframe

Author: antfu

.github/workflows/ecosystem-ci.yml

@@ -27,7 +27,7 @@ jobs:
       - run: pnpm install --frozen-lockfile
       - run: pnpm test:ecosystem
         env:
-          ECOSYSTEM_DEVTOOLS_REF: ${{ inputs.ref }}
+          ECOSYSTEM_DEVFRAME_REF: ${{ inputs.ref }}
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       - if: failure()
         uses: actions/upload-artifact@v4

AGENTS.md

@@ -4,7 +4,7 @@
 
 **`devframe`** is the framework-neutral container for one devtool integration, portable across viewers. Build a single tool (its RPC, its SPA, its diagnostics, its CLI/build/spa/embedded outputs) without caring how it'll be displayed. A devframe app runs standalone (CLI, static deploy, embedded SPA) just as well as it mounts inside a hub.
 
-**`@devframes/hub`** is the framework-neutral hub layer that sits on top of devframe and provides the multi-integration orchestration (docks, terminals, messages, commands). It does not ship UI — implementers (e.g. `@vitejs/devtools-kit`) provide their own UI on top of the hub's RPC + shared-state protocol. See `examples/minimal-vite-devtools-hub/` for a working ~120-line Vite host demonstrating the protocol end to end.
+**`@devframes/hub`** is the framework-neutral hub layer that sits on top of devframe and provides the multi-integration orchestration (docks, terminals, messages, commands). It does not ship UI — implementers (e.g. `@vitejs/devtools-kit`) provide their own UI on top of the hub's RPC + shared-state protocol. See `examples/minimal-vite-devframe-hub/` for a working ~120-line Vite host demonstrating the protocol end to end.
 
 ## Stack & Structure
 

README.md

@@ -15,7 +15,7 @@
 </p>
 
 <p align="center">
-Framework-neutral foundation for building generic DevTools.
+Framework-neutral foundation for building devframes.
 </p>
 
 <p align="center">

docs/.vitepress/config.ts

@@ -99,7 +99,7 @@ export function devframeNav(prefix = ''): DefaultTheme.NavItem[] {
 
 export default withMermaid(defineConfig({
   title: 'Devframe',
-  description: 'Framework-neutral foundation for building generic DevTools — RPC layer, hosts, and adapters.',
+  description: 'Framework-neutral foundation for building generic devframes — RPC layer, hosts, and adapters.',
   head: [
     ['link', { rel: 'icon', type: 'image/svg+xml', href: '/logo.svg' }],
     ['link', { rel: 'apple-touch-icon', href: '/logo.svg' }],

docs/adapters/cli.md

@@ -26,11 +26,11 @@ Running the resulting binary:
 my-devframe                     # dev server at http://localhost:9999/
 my-devframe --port 8080
 my-devframe build --out-dir dist-static
-my-devframe build --out-dir dist-static --base /devtools/
+my-devframe build --out-dir dist-static --base /devframe/
 my-devframe mcp                 # stdio MCP server (experimental)
 ```
 
-Standalone CLI serves the SPA at `/` by default. The `/__devtools/` prefix is for *hosted* adapters where devframe mounts alongside an existing app — see [Mount paths](./#mount-paths).
+Standalone CLI serves the SPA at `/` by default. The `/__devframe/` prefix is for *hosted* adapters where devframe mounts alongside an existing app — see [Mount paths](./#mount-paths).
 
 ## Options
 

docs/adapters/embedded.md

@@ -15,6 +15,6 @@ await createEmbedded(devframe, { ctx: existingCtx })
 
 | Option | Required | Description |
 |--------|----------|-------------|
-| `ctx` | ✓ | Target `DevToolsNodeContext` the devframe is registered into. |
+| `ctx` | ✓ | Target `DevframeNodeContext` the devframe is registered into. |
 
 Useful when a host loads devframes based on runtime conditions (feature flags, user opt-in, dynamic discovery) rather than static config.

docs/errors/DF0006.md

@@ -18,4 +18,4 @@ Register the function with `ctx.rpc.register(defineRpcFunction({ name }))` befor
 
 ## Source
 
-- [`packages/devframe/src/node/host-functions.ts`](https://github.com/vitejs/devtools/blob/main/devframe/packages/devframe/src/node/host-functions.ts) — `RpcFunctionsHost.invokeLocal()` throws `DF0006` when the requested method has not been registered on this host.
+- [`packages/devframe/src/node/host-functions.ts`](https://github.com/vitejs/devframe/blob/main/devframe/packages/devframe/src/node/host-functions.ts) — `RpcFunctionsHost.invokeLocal()` throws `DF0006` when the requested method has not been registered on this host.

docs/errors/DF0007.md

@@ -6,7 +6,7 @@ outline: deep
 
 ## Message
 
-> AsyncLocalStorage is not set, it likely to be an internal bug of the DevTools foundation
+> AsyncLocalStorage is not set, it likely to be an internal bug of the Devframe foundation
 
 ## Cause
 
@@ -18,4 +18,4 @@ Only call `getCurrentRpcSession()` from RPC handlers executed by the server. Rep
 
 ## Source
 
-- [`packages/devframe/src/node/host-functions.ts`](https://github.com/vitejs/devtools/blob/main/devframe/packages/devframe/src/node/host-functions.ts) — `getCurrentRpcSession()` throws `DF0007` when called outside the RPC dispatch async context.
+- [`packages/devframe/src/node/host-functions.ts`](https://github.com/vitejs/devframe/blob/main/devframe/packages/devframe/src/node/host-functions.ts) — `getCurrentRpcSession()` throws `DF0007` when called outside the RPC dispatch async context.

docs/errors/DF0008.md

@@ -10,12 +10,12 @@ outline: deep
 
 ## Cause
 
-`DevToolsViewHost.hostStatic()` was asked to mount a directory that doesn't exist on disk.
+`DevframeViewHost.hostStatic()` was asked to mount a directory that doesn't exist on disk.
 
 ## Fix
 
 Verify the `distDir` path resolves correctly (run your SPA build first, and check the resolved absolute path).
 
 ## Source
 
-- [`packages/devframe/src/node/host-views.ts`](https://github.com/vitejs/devtools/blob/main/devframe/packages/devframe/src/node/host-views.ts) — `DevToolsViewHost.hostStatic()` throws `DF0008` when the resolved `distDir` does not exist on disk.
+- [`packages/devframe/src/node/host-views.ts`](https://github.com/vitejs/devframe/blob/main/devframe/packages/devframe/src/node/host-views.ts) — `DevframeViewHost.hostStatic()` throws `DF0008` when the resolved `distDir` does not exist on disk.

docs/errors/DF0012.md

@@ -18,4 +18,4 @@ Delete the file to reset to defaults, or investigate how it became malformed.
 
 ## Source
 
-- [`packages/devframe/src/node/storage.ts`](https://github.com/vitejs/devtools/blob/main/devframe/packages/devframe/src/node/storage.ts) — `createStorage()` catches `JSON.parse` errors and logs `DF0012` (with the cause attached) before falling back to `initialValue`.
+- [`packages/devframe/src/node/storage.ts`](https://github.com/vitejs/devframe/blob/main/devframe/packages/devframe/src/node/storage.ts) — `createStorage()` catches `JSON.parse` errors and logs `DF0012` (with the cause attached) before falling back to `initialValue`.