feat: extract viteDevBridge into a standalone @devframes/vite package

Move packages/devframe/src/helpers/vite.ts into its own package,
@devframes/vite, mirroring the existing @devframes/next/@devframes/nuxt
integration-package pattern. Being a separate package, it can now depend
on vite directly — viteDevBridge's return type and configureServer hook
are typed against vite's real Plugin/ViteDevServer surface instead of a
hand-rolled duck-typed interface, while devframe core stays free of any
vite dependency.

- devframe/internal gains diagnostics/resolveBasePath/normalizeBasePath
  re-exports so the new package reuses core's DF0033 diagnostic and
  mount-base logic instead of duplicating it.
- The 8 built-in plugins with a vite.ts (inspect, messages, terminals,
  code-server, og, assets, data-inspector, a11y) and @devframes/nuxt now
  import viteDevBridge from @devframes/vite.
- Updates turbo.json's build graph, alias.ts/tsconfig.base.json,
  vitest.config.ts projects, knip.jsonc, docs, and the tsnapi API
  snapshots accordingly.

This PR was created with the help of an agent.

Author: antfubot

alias.ts

@@ -39,7 +39,6 @@ export const alias = {
   'devframe/adapters/cac': r('devframe/src/adapters/cac.ts'),
   'devframe/adapters/dev': r('devframe/src/adapters/dev.ts'),
   'devframe/adapters/build': r('devframe/src/adapters/build.ts'),
-  'devframe/helpers/vite': r('devframe/src/helpers/vite.ts'),
   'devframe/adapters/embedded': r('devframe/src/adapters/embedded.ts'),
   'devframe/initiate': r('devframe/src/adapters/initiate.ts'),
   'devframe/adapters/mcp': r('devframe/src/adapters/mcp/index.ts'),
@@ -54,6 +53,7 @@ export const alias = {
   '@devframes/nuxt': r('nuxt/src/index.ts'),
   '@devframes/next/client': r('next/src/client.tsx'),
   '@devframes/next': r('next/src/index.ts'),
+  '@devframes/vite': r('vite/src/index.ts'),
   '@devframes/json-render/core': r('json-render/src/core.ts'),
   '@devframes/json-render/hub': r('json-render/src/hub.ts'),
   '@devframes/json-render/node': r('json-render/src/node/index.ts'),

docs/errors/DF0033.md

@@ -10,7 +10,7 @@ outline: deep
 
 ## Cause
 
-`viteDevBridge({ devMiddleware })` could not bring up the bridge dev server that pairs a host-served SPA (Vite, Nuxt, Astro, etc.) with devframe's RPC backend. Common reasons:
+`viteDevBridge({ devMiddleware })` (from `@devframes/vite`) could not bring up the bridge dev server that pairs a host-served SPA (Vite, Nuxt, Astro, etc.) with devframe's RPC backend. Common reasons:
 
 - The preferred port is in use and no fallback range was configured.
 - Calling `def.setup(ctx)` threw — the devframe's own setup logic surfaced an error.
@@ -26,4 +26,4 @@ This is a soft warning — the surrounding Vite dev server keeps running, but th
 
 ## Source
 
-- [`packages/devframe/src/helpers/vite.ts`](https://github.com/devframes/devframe/blob/main/packages/devframe/src/helpers/vite.ts) — `viteDevBridge({ devMiddleware })` logs `DF0033` when port resolution or `createDevServer` throws during `configureServer`.
+- [`packages/vite/src/index.ts`](https://github.com/devframes/devframe/blob/main/packages/vite/src/index.ts) — `viteDevBridge({ devMiddleware })` logs `DF0033` when port resolution or `createDevServer` throws during `configureServer`.

docs/helpers/index.md

@@ -9,7 +9,7 @@ Helpers are the optional, opt-in surface around the core `defineDevframe` API: s
 | Helper | Entry | What it does |
 |--------|-------|--------------|
 | [Utilities](./utilities) | `devframe/utils/*` | Bundled small utilities — terminal colors, hashing, editor launch, structured-clone serialization, and more. |
-| [Vite Bridge](./vite-bridge) | `devframe/helpers/vite` | Vite plugin for mounting a devframe inside any Vite-based host (Astro, SolidStart, plain Vite). |
+| [Vite Bridge](./vite-bridge) | `@devframes/vite` | Vite plugin for mounting a devframe inside any Vite-based host (Astro, SolidStart, plain Vite). |
 | [Nuxt Module](./nuxt) | `@devframes/nuxt` | Nuxt module that wires a Nuxt SPA as a devframe client and serves the dev-time RPC bridge. |
 | [Next Helper](./next) | `@devframes/next` | Route-handler host + React client for mounting devframes inside a Next.js App Router app (experimental). |
 | [Common RPC Functions](./common-rpc-functions) | `devframe/recipes/common-rpc-functions` | Prebuilt RPC actions for "open in editor" and "reveal in Finder". |

docs/helpers/vite-bridge.md

@@ -9,7 +9,7 @@ A thin Vite plugin for mounting a devframe inside an existing Vite dev server. U
 This sits below the [`vite` adapter](/adapters/vite) on the abstraction ladder: the adapter targets the full Vite DevTools dock; the bridge is the lower-level Vite plugin you reach for when you want a devframe to ride along with an existing app's dev server without the DevTools dock.
 
 ```ts
-import { viteDevBridge } from 'devframe/helpers/vite'
+import { viteDevBridge } from '@devframes/vite'
 import { defineConfig } from 'vite'
 import devframe from './devframe'
 

knip.jsonc

@@ -90,7 +90,6 @@
       // listed explicitly instead. Keep this in sync with the `exports` map.
       "entry": [
         "src/{index,constants}.ts",
-        "src/helpers/vite.ts",
         "src/adapters/{build,cac,dev,embedded,initiate}.ts",
         "src/adapters/mcp/index.ts",
         "src/client/index.ts",

packages/devframe/package.json

@@ -27,7 +27,6 @@
     "./adapters/mcp": "./dist/adapters/mcp.mjs",
     "./client": "./dist/client/index.mjs",
     "./constants": "./dist/constants.mjs",
-    "./helpers/vite": "./dist/helpers/vite.mjs",
     "./initiate": "./dist/adapters/initiate.mjs",
     "./internal": "./dist/internal/index.mjs",
     "./node": "./dist/node/index.mjs",

packages/devframe/scripts/check-client-dist.ts

@@ -14,7 +14,6 @@ const FORBIDDEN: ForbiddenRule[] = [
   { name: 'devframe/rpc/transports/*', match: id => id.startsWith('devframe/rpc/transports/') },
   { name: 'devframe/node*', match: id => id === 'devframe/node' || id.startsWith('devframe/node/') },
   { name: 'devframe/adapters/*', match: id => id.startsWith('devframe/adapters/') },
-  { name: 'devframe/helpers/*', match: id => id.startsWith('devframe/helpers/') },
   { name: 'devframe/recipes/*', match: id => id.startsWith('devframe/recipes/') },
   { name: 'devframe/utils/launch-editor', match: id => id === 'devframe/utils/launch-editor' },
   { name: 'devframe/utils/open', match: id => id === 'devframe/utils/open' },

packages/devframe/src/internal/index.ts

@@ -26,8 +26,16 @@
 //   transport"), the fetch/connect handler pair, and teardown. `StartedServer`
 //   is the live handle its bound tiers produce and `createDevServer` re-exposes.
 // - `normalizeHttpServerUrl` — a small host-side URL helper.
+// - `resolveBasePath` / `normalizeBasePath` — the mount-base resolution
+//   `initDevframe` itself uses; a bridge (`@devframes/vite`) that mounts a
+//   devframe onto a host it doesn't own reuses the exact same defaulting.
+// - `diagnostics` — devframe core's structured diagnostics instance
+//   (`DF00xx`), so a first-party integration built outside this package can
+//   report against the same registered codes instead of minting its own.
+export { normalizeBasePath, resolveBasePath } from '../adapters/_shared'
 export { coerceAgentPositionalArgs } from '../node/agent-args'
 export type { AgentArgsFallback } from '../node/agent-args'
+export { diagnostics } from '../node/diagnostics'
 export { DevframeAgentHost } from '../node/host-agent'
 export * from '../node/host-h3'
 export { listLiveDevframeInstances, registerDevframeInstance } from '../node/instance-registry'

packages/devframe/tsdown.config.ts

@@ -110,7 +110,6 @@ const serverEntries = {
   'adapters/initiate': 'src/adapters/initiate.ts',
   'adapters/mcp': 'src/adapters/mcp/index.ts',
   'cli/main': 'src/cli/main.ts',
-  'helpers/vite': 'src/helpers/vite.ts',
   'recipes/common-rpc-functions': 'src/recipes/common-rpc-functions.ts',
   'recipes/interactive-auth': 'src/recipes/interactive-auth.ts',
 }

packages/nuxt/package.json

@@ -39,6 +39,9 @@
     "@nuxt/kit": "^3.0.0 || ^4.0.0 || ^5.0.0-0",
     "devframe": "workspace:*"
   },
+  "dependencies": {
+    "@devframes/vite": "workspace:*"
+  },
   "devDependencies": {
     "@nuxt/kit": "catalog:build",
     "@types/node": "catalog:types",