feat!: remove per-plugin vite wrappers; export hub base constants from @devframes/hub/constants

Deletes three drift-prone hand-copy clusters:

- plugins/{a11y,assets,data-inspector,inspect,messages,og}/src/vite.ts
  — each an 8-25 line rename over devframeVite(def, options) from
  @devframes/vite/dev-spa, and the sole reason those plugins depended
  on @devframes/vite. Consumers now call devframeVite() directly
  against the plugin's default export; @devframes/vite moves to
  devDependencies where it's still needed for the plugin's own SPA
  dev config. plugin-code-server's codeServerVite and
  plugin-terminals's terminalsVite are unaffected — they compose a
  bridge + static plugin and build their devframe from options, which
  is real behaviour beyond delegation, not a mirror.

- DEVFRAMES_HUB_BASE hand-copied across packages/{vite,nuxt,next}'s
  hub-client wrappers (each commented "mirrors @devframes/hub's").
  Now defined once in the client-safe packages/hub/src/constants.ts
  and imported everywhere; packages/hub/src/node/initiate.ts
  re-exports it for existing importers of that entry.

- normalizeBase reimplemented ×4 with two different mechanisms (ufo
  vs hand-rolled). One canonical normalizeHubBase (ufo-based, hub
  already depends on ufo) now lives next to the constant and is used
  by @devframes/hub itself and all three framework adapters.

Also deletes packages/hub-ui/src/client/state/renderers.ts, a
30-line shim that only delegated to createDockRenderersContext; its
one call site now calls that directly.

Breaking: the six plugins' /vite export subpath is gone. Migration
documented in docs/guide/migration-0.9.md.

Created with the help of an agent.

Author: antfubot

docs/guide/migration-0.9.md

@@ -43,6 +43,12 @@ Each splits into two scoped subpaths — `.../dev-spa` (author one devframe's SP
 | `@devframes/next/client` | `@devframes/next/dev-spa/client` |
 | mount a hub inside a tool | `@devframes/{vite,nuxt,next}/hub` (+ `/hub/client`) |
 
+**Built-in plugins**
+
+| Removed / moved | Replacement |
+|---|---|
+| `@devframes/plugin-{a11y,assets,data-inspector,inspect,messages,og}/vite` | `devframeVite(def, options)` from `@devframes/vite/dev-spa`, against the plugin's default export |
+
 ## `devframe/adapters/cli` is removed
 
 The CLI adapter was renamed to `cac` in 0.7. The `devframe/adapters/cli` entry - `createCli`, `CreateCliOptions`, and `CliHandle` - is now gone. Import from `devframe/adapters/cac` instead:
@@ -281,6 +287,31 @@ export default defineConfig({
 
 `@devframes/vite` (and `@devframes/nuxt` / `@devframes/next`) take `@devframes/hub` and `@devframes/hub-ui` as **optional** peers — only the `/hub` scope needs them. Install `vite` as a peer as before. See [`@devframes/vite`](/frameworks/vite) for the full reference.
 
+## Built-in plugins' `/vite` subpath is removed
+
+`a11yVitePlugin`, `assetsVitePlugin`, `dataInspectorVitePlugin`, `inspectVitePlugin`, `messagesVitePlugin`, and `ogVitePlugin` — each plugin's `@devframes/plugin-<name>/vite` export — were one-line renames over `devframeVite(def, options)`. Call `devframeVite` directly against the plugin's default export instead:
+
+```ts
+// 0.8.x
+import { a11yVitePlugin } from '@devframes/plugin-a11y/vite'
+
+export default defineConfig({
+  plugins: [a11yVitePlugin()],
+})
+```
+
+```ts
+// 0.9
+import a11yDevframe from '@devframes/plugin-a11y'
+import { devframeVite } from '@devframes/vite/dev-spa'
+
+export default defineConfig({
+  plugins: [devframeVite(a11yDevframe)],
+})
+```
+
+`@devframes/plugin-code-server`'s `codeServerVite` and `@devframes/plugin-terminals`'s `terminalsVite` are unaffected — they mount a bridge and a static plugin together (and build their devframe from the passed options), not a plain `devframeVite` delegation.
+
 ## `@devframes/nuxt` and `@devframes/next` split into `/dev-spa` and `/hub`
 
 Both packages now serve their single-devframe surface from a `.../dev-spa` subpath, and the bare package root throws with a pointer to the two scopes.

docs/plugins/a11y.md

@@ -56,12 +56,13 @@ Runs the panel alone, without a host page to scan — serves at `/__devframes_pl
 
 ```ts
 // vite.config.ts
-import { a11yVitePlugin } from '@devframes/plugin-a11y/vite'
+import a11yDevframe from '@devframes/plugin-a11y'
+import { devframeVite } from '@devframes/vite/dev-spa'
 import { defineConfig } from 'vite'
 
 export default defineConfig({
   plugins: [
-    a11yVitePlugin(),
+    devframeVite(a11yDevframe),
   ],
 })
 ```

docs/plugins/assets.md

@@ -30,12 +30,13 @@ pnpx @devframes/plugin-assets --read-only # disable upload / rename / delete / m
 
 ```ts
 // vite.config.ts
-import { assetsVitePlugin } from '@devframes/plugin-assets/vite'
+import assetsDevframe from '@devframes/plugin-assets'
+import { devframeVite } from '@devframes/vite/dev-spa'
 import { defineConfig } from 'vite'
 
 export default defineConfig({
   plugins: [
-    assetsVitePlugin(),
+    devframeVite(assetsDevframe),
   ],
 })
 ```

docs/plugins/data-inspector.md

@@ -107,14 +107,15 @@ pnpx @devframes/plugin-data-inspector attach               # attach to a process
 ## Mount into a Vite host
 
 ```ts
+import dataInspectorDevframe from '@devframes/plugin-data-inspector'
 import { registerDataSource } from '@devframes/plugin-data-inspector/registry'
 // vite.config.ts
-import { dataInspectorVitePlugin } from '@devframes/plugin-data-inspector/vite'
+import { devframeVite } from '@devframes/vite/dev-spa'
 import { defineConfig } from 'vite'
 
 export default defineConfig({
   plugins: [
-    dataInspectorVitePlugin(),
+    devframeVite(dataInspectorDevframe),
     {
       name: 'my-app:data-sources',
       configureServer(server) {

docs/plugins/inspect.md

@@ -44,12 +44,13 @@ Opens the inspector against a fresh standalone devframe connection — handy as
 
 ```ts
 // vite.config.ts
-import { inspectVitePlugin } from '@devframes/plugin-inspect/vite'
+import inspectDevframe from '@devframes/plugin-inspect'
+import { devframeVite } from '@devframes/vite/dev-spa'
 import { defineConfig } from 'vite'
 
 export default defineConfig({
   plugins: [
-    inspectVitePlugin(),
+    devframeVite(inspectDevframe),
   ],
 })
 ```

docs/plugins/og.md

@@ -24,12 +24,13 @@ pnpx @devframes/plugin-og
 
 ```ts
 // vite.config.ts
-import { ogVitePlugin } from '@devframes/plugin-og/vite'
+import ogDevframe from '@devframes/plugin-og'
+import { devframeVite } from '@devframes/vite/dev-spa'
 import { defineConfig } from 'vite'
 
 export default defineConfig({
   plugins: [
-    ogVitePlugin(),
+    devframeVite(ogDevframe),
   ],
 })
 ```

packages/hub-ui/src/client/state/context.ts

@@ -1,10 +1,10 @@
 import type { DevframeClientCommand, DevframeDockEntry, DevframeDockUserEntry, DevframeRpcClientFunctions, DevframeViewIframe } from '@devframes/hub'
-import type { CommandsContext, DevframeRpcClient, DockClientScriptContext, DockEntryState, DockPanelStorage, DockRegistration, DockRendererManifest, DocksContext } from '@devframes/hub/client'
+import type { CommandsContext, DevframeClientContext, DevframeRpcClient, DockClientScriptContext, DockEntryState, DockPanelStorage, DockRegistration, DockRendererManifest, DocksContext } from '@devframes/hub/client'
 import type { SharedState } from 'devframe/utils/shared-state'
 import type { WhenContext } from 'devframe/utils/when'
 import type { Ref } from 'vue'
 import type { DevframeDocksUserSettings } from './dock-settings'
-import { attachFrameNavClient } from '@devframes/hub/client'
+import { attachFrameNavClient, createDockRenderersContext } from '@devframes/hub/client'
 import { DEFAULT_STATE_USER_SETTINGS, DOCK_RENDERERS_STATE_KEY } from '@devframes/hub/constants'
 import { computed, markRaw, reactive, ref, toRefs, watch, watchEffect } from 'vue'
 import { BUILTIN_ENTRIES, BUILTIN_ENTRY_SETTINGS, DEFAULT_CATEGORIES_ORDER, HUB_UI_HIDE_EVENT } from '../constants'
@@ -14,7 +14,6 @@ import { docksGroupByCategories, getCategoryLabel, getGroupMembers, getGroupMemb
 import { createDockEntryState, DEFAULT_DOCK_PANEL_STORE, sharedStateToRef, useDocksEntries } from './docks'
 import { createClientMessagesClient } from './messages-client'
 import { registerMainFrameDockActionHandler, triggerMainFrameDockAction, useIsDockPopupOpen } from './popup'
-import { createDockRenderers } from './renderers'
 import { executeSetupScript } from './setup-script'
 
 const docksContextByRpc = new WeakMap<DevframeRpcClient, DocksContext>()
@@ -538,7 +537,10 @@ export async function createDocksContext(
       },
       events: rpc.events,
     },
-    renderers: markRaw(createDockRenderers(() => docksContext, () => rendererManifest.value)),
+    renderers: markRaw(createDockRenderersContext({
+      context: () => docksContext as DevframeClientContext,
+      manifest: () => rendererManifest.value,
+    })),
     rpc: markRaw(rpc),
     clientType,
   })

packages/hub-ui/src/client/state/renderers.ts

@@ -1,7 +1,22 @@
 import type { DevframeDocksUserSettings } from './types/settings'
+import { cleanDoubleSlashes, withLeadingSlash, withTrailingSlash } from 'ufo'
 
 export * from 'devframe/constants'
 
+/** Default mount base for a hub instance — one namespace, one catch-all. */
+export const DEVFRAMES_HUB_BASE = '/__devframes/'
+
+/**
+ * Normalize a hub mount base to an absolute path with leading and trailing
+ * slashes (e.g. `devframes` → `/devframes/`), collapsing any doubled
+ * slashes the input introduced. The one implementation every hub-aware
+ * host (`@devframes/hub` itself, and the Vite/Nuxt/Next adapters) resolves
+ * `options.base` through.
+ */
+export function normalizeHubBase(base: string): string {
+  return cleanDoubleSlashes(withTrailingSlash(withLeadingSlash(base)))
+}
+
 /**
  * The default ordering weight for each known dock category — lower sorts
  * earlier. Downstream viewers (e.g. `@vitejs/devtools-kit`) import this as the

packages/hub/src/constants.ts

@@ -16,8 +16,8 @@ import { createH3DevframeHost, createInstanceShell, resolveInstanceRegister } fr
 import { mountStaticHandler } from 'devframe/utils/serve-static'
 import { H3 } from 'h3'
 import { resolve } from 'pathe'
-import { cleanDoubleSlashes, joinURL, withLeadingSlash, withoutLeadingSlash, withTrailingSlash } from 'ufo'
-import { DOCK_RENDERERS_STATE_KEY } from '../constants'
+import { joinURL, withoutLeadingSlash, withTrailingSlash } from 'ufo'
+import { DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, normalizeHubBase } from '../constants'
 import { createHubContext } from './context'
 import { diagnostics } from './diagnostics'
 
@@ -35,8 +35,8 @@ function normalizeDevframeEntry(entry: DevframeDefinition | HubDevframeEntry): H
   return 'devframe' in entry ? entry : { devframe: entry }
 }
 
-/** Default mount base for a hub instance — one namespace, one catch-all. */
-export const DEVFRAMES_HUB_BASE = '/__devframes/'
+/** Default mount base for a hub instance — re-exported from `../constants` (the client-safe home) for existing importers of this node entry. */
+export { DEVFRAMES_HUB_BASE }
 
 /** Content-type for a UI asset key, inferred from its file extension. */
 function assetContentType(key: string): string {
@@ -333,10 +333,6 @@ function resolveDevframesInput(input: DevframesInput): Promise<HubDevframeEntry[
     .then(arrays => arrays.flat())
 }
 
-function normalizeBase(base: string): string {
-  return cleanDoubleSlashes(withTrailingSlash(withLeadingSlash(base)))
-}
-
 /**
  * Validate the renderer-module registrations fail-fast: route-safe types
  * (each becomes the `<base>__renderers/<type>.mjs` URL segment), one module
@@ -401,7 +397,7 @@ function renderClientImportsModule(ctx: DevframeHubContext): string {
  * through {@link HubInstance.attach}.
  */
 export function initHub(options: InitHubOptions): HubInstance {
-  const base = normalizeBase(options.base)
+  const base = normalizeHubBase(options.base)
   const baseNoSlash = base.slice(0, -1)
   const app = new H3()
   const cwd = options.cwd ?? process.cwd()