devframe 0.1.22 → 0.2.0

package/README.md

@@ -1,8 +1,8 @@
 # devframe
 
-Framework-neutral foundation for building generic DevTools. Describe one devframe — its RPC, its data, its SPA, its CLI shape — and deploy the same definition through any of seven adapters.
+Framework- and build-tool-agnostic foundation for building generic DevTools. Define your devtool once — its RPC, its data, its SPA, its CLI shape — and deploy the same definition anywhere through a set of pluggable adapters.
 
-Part of the [Vite DevTools](https://devtools.vite.dev) monorepo. Full documentation: [https://devfra.me/](https://devfra.me/).
+Full documentation: [https://devfra.me/](https://devfra.me/).
 
 ## Install
 
@@ -38,8 +38,7 @@ await createCli(devframe).parse()
 |---------|----------|
 | `cli` | Standalone CLI tool with `dev` / `build` / `mcp` subcommands. |
 | `build` | Generates a static, self-contained SPA snapshot. |
-| `vite` | Runs as a Vite plugin alongside the host app's dev server. |
-| `kit` | Mounts into the DevTools Kit aggregator. |
+| `vite` | Mounts the devframe into Vite DevTools (or any compatible host) via `@vitejs/devtools-kit`. |
 | `embedded` | Overlays inside another devtool's UI. |
 | `mcp` | Surfaces the devframe's RPC to coding agents over MCP. |
 

package/dist/{_shared-DcJX9-Az.mjs → _shared-BrKv3CYt.mjs}

@@ -1,9 +1,9 @@
 //#region src/adapters/_shared.ts
 /**
 * Resolve the mount base path for a devframe's SPA. Hosted adapters
-* (`vite`, `kit`, `embedded`) default to `/__<id>/` so they don't
-* collide with the host app; standalone adapters (`cli`, `spa`,
-* `build`) default to `/` because they own the origin.
+* (`vite`, `embedded`) default to `/__<id>/` so they don't collide
+* with the host app; standalone adapters (`cli`, `spa`, `build`)
+* default to `/` because they own the origin.
 *
 * The devframe author can override with `basePath` on the definition.
 */

package/dist/adapters/build.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition } from "../devframe-DulcIxwu.mjs";
+import { r as DevframeDefinition } from "../devframe-R5Ex5K5L.mjs";
 
 //#region src/adapters/build.d.ts
 interface CreateBuildOptions {

package/dist/adapters/build.mjs

@@ -1,11 +1,11 @@
 import { n as strictJsonStringify } from "../serialization-CwO31axa.mjs";
-import { i as structuredCloneStringify } from "../structured-clone-DcDc2Dds.mjs";
-import { t as colors } from "../colors-Bl4W18Mh.mjs";
-import { t as createHostContext } from "../context-DUibxhrR.mjs";
+import { i as structuredCloneStringify } from "../structured-clone-CD2l4fI3.mjs";
+import { t as colors } from "../colors-DS7k8ljB.mjs";
+import { t as createHostContext } from "../context-BBi2IQDm.mjs";
 import { t as createH3DevToolsHost } from "../host-h3-Dz8YnFgu.mjs";
 import { DEVTOOLS_CONNECTION_META_FILENAME, DEVTOOLS_RPC_DUMP_DIRNAME, DEVTOOLS_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
-import { t as collectStaticRpcDump } from "../static-dump-D7AvjrgL.mjs";
-import { n as resolveBasePath } from "../_shared-DcJX9-Az.mjs";
+import { t as collectStaticRpcDump } from "../static-dump-C67bCuse.mjs";
+import { n as resolveBasePath } from "../_shared-BrKv3CYt.mjs";
 import { existsSync } from "node:fs";
 import process from "node:process";
 import { dirname, resolve } from "pathe";

package/dist/adapters/cli.d.mts

@@ -1,5 +1,5 @@
-import { _t as InferCliFlags, gt as CliFlagsSchema, r as DevframeDefinition, vt as defineCliFlags, yt as parseCliFlags } from "../devframe-DulcIxwu.mjs";
-import { App } from "h3";
+import { ct as CliFlagsSchema, dt as parseCliFlags, lt as InferCliFlags, r as DevframeDefinition, ut as defineCliFlags } from "../devframe-R5Ex5K5L.mjs";
+import { H3 } from "h3";
 import { CAC } from "cac";
 
 //#region src/adapters/cli.d.ts
@@ -19,7 +19,7 @@ interface CreateCliOptions {
   onReady?: (info: {
     origin: string;
     port: number;
-    app: App;
+    app: H3;
   }) => void | Promise<void>;
 }
 interface CliHandle {

package/dist/adapters/cli.mjs

@@ -1,6 +1,6 @@
-import { t as colors } from "../colors-Bl4W18Mh.mjs";
+import { t as colors } from "../colors-DS7k8ljB.mjs";
 import { createBuild } from "./build.mjs";
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-BGpTpYiR.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-CewNNE2R.mjs";
 import process from "node:process";
 import cac from "cac";
 import { safeParse } from "valibot";

package/dist/adapters/dev.d.mts

@@ -1,6 +1,6 @@
-import { r as DevframeDefinition } from "../devframe-DulcIxwu.mjs";
-import { n as StartedServer } from "../server-zKEDxgqD.mjs";
-import { App } from "h3";
+import { r as DevframeDefinition } from "../devframe-R5Ex5K5L.mjs";
+import { n as StartedServer } from "../server-DzKz023G.mjs";
+import { H3 } from "h3";
 
 //#region src/adapters/dev.d.ts
 interface CreateDevServerOptions {
@@ -23,7 +23,7 @@ interface CreateDevServerOptions {
    * `def.cli?.distDir` is set, the dev server runs in **bridge mode** —
    * only `__connection.json` and the WS endpoint are mounted; the SPA
    * is expected to be hosted elsewhere (e.g. by a parent Vite/Nuxt
-   * dev server via `createVitePlugin({ devMiddleware })`).
+   * dev server via `viteDevBridge({ devMiddleware })`).
    */
   distDir?: string;
   /**
@@ -37,7 +37,7 @@ interface CreateDevServerOptions {
    * middleware (auth, logging, extra static assets) before devframe's
    * own handlers.
    */
-  app?: App;
+  app?: H3;
   /**
    * Auto-open the browser. When `undefined` the resolution falls
    * through to `flags.open` (incl. string path) and finally
@@ -52,7 +52,7 @@ interface CreateDevServerOptions {
   onReady?: (info: {
     origin: string;
     port: number;
-    app: App;
+    app: H3;
   }) => void | Promise<void>;
 }
 interface ResolveDevServerPortOptions {
@@ -78,7 +78,7 @@ declare function resolveDevServerPort(def: DevframeDefinition, options?: Resolve
  * server runs in **bridge mode**: only `__connection.json` and the WS
  * endpoint are mounted, with no SPA mount. The SPA is expected to be
  * hosted elsewhere (e.g. by a parent Vite/Nuxt dev server) — see
- * `createVitePlugin({ devMiddleware })`.
+ * `viteDevBridge({ devMiddleware })`.
  *
  * Returns the underlying {@link StartedServer} handle so callers can
  * close it gracefully (SIGINT, hot-reload, test teardown).

package/dist/adapters/dev.mjs

@@ -1,2 +1,2 @@
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-BGpTpYiR.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-CewNNE2R.mjs";
 export { createDevServer, resolveDevServerPort };

package/dist/adapters/embedded.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition, y as DevToolsNodeContext } from "../devframe-DulcIxwu.mjs";
+import { d as DevToolsNodeContext, r as DevframeDefinition } from "../devframe-R5Ex5K5L.mjs";
 
 //#region src/adapters/embedded.d.ts
 interface CreateEmbeddedOptions {

package/dist/adapters/mcp.d.mts

@@ -1,4 +1,4 @@
-import { r as DevframeDefinition } from "../devframe-DulcIxwu.mjs";
+import { r as DevframeDefinition } from "../devframe-R5Ex5K5L.mjs";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 
 //#region src/node/mcp/build-server.d.ts

package/dist/adapters/mcp.mjs

@@ -1,5 +1,5 @@
-import { n as logger } from "../diagnostics-BFhNNmST.mjs";
-import { t as createHostContext } from "../context-DUibxhrR.mjs";
+import { n as logger } from "../diagnostics-Cg9ycFIM.mjs";
+import { t as createHostContext } from "../context-BBi2IQDm.mjs";
 import { homedir } from "node:os";
 import process from "node:process";
 import { join } from "pathe";

package/dist/client/index.d.mts

@@ -1,4 +1,4 @@
-import { M as StreamReader, N as StreamSink, Q as DevToolsRpcServerFunctions, Z as DevToolsRpcClientFunctions, _ as ConnectionMeta, pt as EventEmitter, w as RpcSharedStateHost } from "../devframe-DulcIxwu.mjs";
+import { T as StreamSink, U as DevToolsRpcClientFunctions, W as DevToolsRpcServerFunctions, at as EventEmitter, g as RpcSharedStateHost, l as ConnectionMeta, w as StreamReader } from "../devframe-R5Ex5K5L.mjs";
 import { m as RpcCacheOptions, p as RpcCacheManager } from "../index-DB2Ie0Or.mjs";
 import { S as RpcFunctionsCollector } from "../types-4rdUEi2R.mjs";
 import { t as WsRpcChannelOptions } from "../ws-client-Bavoya6-.mjs";
@@ -133,7 +133,5 @@ declare function getDevToolsRpcClient(options?: DevToolsRpcClientOptions): Promi
 //#endregion
 //#region src/client/index.d.ts
 declare const connectDevframe: typeof getDevToolsRpcClient;
-/** @deprecated Use `connectDevframe`. */
-declare function connectDevtool(...args: Parameters<typeof getDevToolsRpcClient>): ReturnType<typeof getDevToolsRpcClient>;
 //#endregion
-export { DevToolsClientRpcHost, DevToolsRpcClient, DevToolsRpcClientCall, DevToolsRpcClientCallEvent, DevToolsRpcClientCallOptional, DevToolsRpcClientMode, DevToolsRpcClientOptions, DevToolsRpcContext, RpcClientEvents, RpcStreamingClientHost, StreamingSubscribeOptions, connectDevframe, connectDevtool, createRpcStreamingClientHost, getDevToolsRpcClient };
+export { DevToolsClientRpcHost, DevToolsRpcClient, DevToolsRpcClientCall, DevToolsRpcClientCallEvent, DevToolsRpcClientCallOptional, DevToolsRpcClientMode, DevToolsRpcClientOptions, DevToolsRpcContext, RpcClientEvents, RpcStreamingClientHost, StreamingSubscribeOptions, connectDevframe, createRpcStreamingClientHost, getDevToolsRpcClient };

package/dist/client/index.mjs

@@ -1,10 +1,10 @@
-import { t as hash } from "../hash-BHZbo80D.mjs";
-import { l as RpcCacheManager, o as RpcFunctionsCollectorBase } from "../rpc-CkZuoz-m.mjs";
+import { t as hash } from "../hash-CIBte1yS.mjs";
+import { l as RpcCacheManager, o as RpcFunctionsCollectorBase } from "../rpc-DAzoVCR0.mjs";
 import { createRpcClient } from "../rpc/client.mjs";
-import { t as structuredCloneDeserialize } from "../structured-clone-DcDc2Dds.mjs";
+import { t as structuredCloneDeserialize } from "../structured-clone-CD2l4fI3.mjs";
 import { createWsRpcChannel } from "../rpc/transports/ws-client.mjs";
 import { createEventEmitter } from "../utils/events.mjs";
-import { t as createSharedState } from "../shared-state-DCDs0e7y.mjs";
+import { t as createSharedState } from "../shared-state-q9-1EOSX.mjs";
 import { createStreamReader, createStreamSink } from "../utils/streaming-channel.mjs";
 import { DEVTOOLS_CONNECTION_META_FILENAME, DEVTOOLS_RPC_DUMP_MANIFEST_FILENAME } from "../constants.mjs";
 import { t as humanId } from "../human-id-adtUWQLr.mjs";
@@ -277,7 +277,7 @@ function createRpcStreamingClientHost(rpc) {
 	};
 }
 //#endregion
-//#region ../../../node_modules/.pnpm/ua-parser-modern@0.1.1/node_modules/ua-parser-modern/dist/index.mjs
+//#region ../../node_modules/.pnpm/ua-parser-modern@0.1.1/node_modules/ua-parser-modern/dist/index.mjs
 const EMPTY = "";
 const UNKNOWN = "?";
 const MAJOR = "major";
@@ -1500,7 +1500,7 @@ function createWsRpcClientMode(options) {
 		let clear = () => {};
 		await Promise.race([trustedPromise.promise.then(clear), new Promise((resolve, reject) => {
 			const id = setTimeout(() => {
-				reject(/* @__PURE__ */ new Error("[Vite DevTools] Timeout waiting for rpc to be trusted"));
+				reject(/* @__PURE__ */ new Error("[devframe] Timeout waiting for rpc to be trusted"));
 			}, timeout);
 			clear = () => clearTimeout(id);
 		})]);
@@ -1660,14 +1660,5 @@ async function getDevToolsRpcClient(options = {}) {
 //#endregion
 //#region src/client/index.ts
 const connectDevframe = getDevToolsRpcClient;
-let warnedConnectDevtool = false;
-/** @deprecated Use `connectDevframe`. */
-function connectDevtool(...args) {
-	if (!warnedConnectDevtool) {
-		warnedConnectDevtool = true;
-		console.warn("[devframe] `connectDevtool` is deprecated; use `connectDevframe` instead.");
-	}
-	return getDevToolsRpcClient(...args);
-}
 //#endregion
-export { connectDevframe, connectDevtool, createRpcStreamingClientHost, getDevToolsRpcClient };
+export { connectDevframe, createRpcStreamingClientHost, getDevToolsRpcClient };

package/dist/colors-DS7k8ljB.mjs

@@ -0,0 +1,123 @@
+import { r as __toESM, t as __commonJSMin } from "./chunk-e9Ob2GDo.mjs";
+//#endregion
+//#region ../../node_modules/.pnpm/ansis@4.3.0/node_modules/ansis/index.mjs
+var import_ansis = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
+	let e, r, { defineProperty: t, setPrototypeOf: n, create: l, keys: o } = Object, i = "", { round: s, max: f } = Math, u = (e) => {
+		let r = /([a-f\d]{3,6})/i.exec(e)?.[1], t = r?.length, n = parseInt(6 ^ t ? 3 ^ t ? "0" : r[0] + r[0] + r[1] + r[1] + r[2] + r[2] : r, 16);
+		return [
+			n >> 16 & 255,
+			n >> 8 & 255,
+			255 & n
+		];
+	}, a = (e, r, t) => e ^ r || r ^ t ? 16 + 36 * s(e / 51) + 6 * s(r / 51) + s(t / 51) : 8 > e ? 16 : e > 248 ? 231 : s(24 * (e - 8) / 247) + 232, c = (e) => {
+		let r, t, n, l, o;
+		return 8 > e ? 30 + e : 16 > e ? 82 + e : (232 > e ? (o = (e -= 16) % 36, r = (e / 36 | 0) / 5, t = (o / 6 | 0) / 5, n = o % 6 / 5) : r = t = n = (10 * (e - 232) + 8) / 255, l = 2 * f(r, t, n), l ? 30 + (s(n) << 2 | s(t) << 1 | s(r)) + (2 ^ l ? 0 : 60) : 30);
+	}, g = {
+		open: i,
+		close: i
+	}, b = 39, d = 49, p = {}, $ = ({ p: e }, { open: t = "", close: l = "", f: o }) => {
+		let s = (e, ...r) => {
+			if (!e) {
+				if (t && t === l) return t;
+				if ((e ?? i) === i) return i;
+			}
+			let n, f = s.p, u = f.o, a = f.c, c = o ? o(e, ...r) : e.raw ? String.raw({ raw: e }, ...r) : i + e;
+			if (c.includes("\x1B")) for (; f; f = f.p) {
+				let { t: e, l: r } = f, t = r.length, l = i, o = 0;
+				if (t) for (; ~(n = c.indexOf(r, o)); o = n + t) l += c.slice(o, n) + e;
+				c = l + c.slice(o);
+			}
+			return u + (c.includes("\n") ? c.replace(/(\r?\n)/g, a + "$1" + u) : c) + a;
+		}, f = t, u = l;
+		return e && (f = e.o + t, u = l + e.c), n(s, r), s.p = {
+			t,
+			l,
+			o: s.open = f,
+			c: s.close = u,
+			p: e
+		}, s;
+	};
+	const h = new function s(f = globalThis) {
+		let h, y, m = "number" == typeof f ? f : ((r) => {
+			let t = r.process ?? {}, n = t.argv ?? [], l = t.env ?? {}, i = 0;
+			try {
+				i = ((r, t, n) => (e = t.TERM, {
+					"24bit": 3,
+					truecolor: 3,
+					ansi256: 2,
+					ansi: 1
+				}[t.COLORTERM] || (t.CI ? /,GITHUB/.test(n) ? 3 : 1 : (t.PM2_HOME || /edge/.test(t.NEXT_RUNTIME) || r.stdout?.isTTY) && "dumb" !== e ? "win32" === r.platform ? 3 : /-256/.test(e) ? 2 : 1 : 0)))(t, l, "," + o(l).join(","));
+			} catch (e) {
+				l = {};
+			}
+			let s, f = i || 1, u = "FORCE_COLOR", a = {
+				false: 0,
+				0: 0,
+				1: 1,
+				2: 2,
+				3: 3
+			}[l[u]] ?? f, c = -1;
+			for (s of n) /^--color=?(true|always)?$/.test(s) && (c = f), /^--(no-color|color=(false|never))$/.test(s) && (c = 0);
+			return r.window?.chrome ? 3 : u in l ? a : ~c ? c : l.NO_COLOR ? 0 : i;
+		})(f), w = {
+			Ansis: s,
+			level: m,
+			isSupported: () => v,
+			strip: (e) => e.replace(/[›][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, i),
+			extend(e) {
+				for (let r in e) {
+					let t = e[r], n = (typeof t)[0];
+					"s" === n && (O(B(r), I(...u(t))), t = H(...u(t))), O(r, t, "f" === n);
+				}
+				return n(w, r = l({}, p)), w;
+			}
+		}, O = (e, r, n) => {
+			p[e] = { get() {
+				let l = n ? (...e) => $(this, r(...e)) : $(this, r);
+				return t(this, e, { value: l }), l;
+			} };
+		}, v = m > 0, _ = (e, r) => v ? {
+			open: `[${e}m`,
+			close: `[${r}m`
+		} : g, k = (e) => (r) => e(...u(r)), x = (e, r) => (t, n, l) => _(`${e}8;2;${t};${n};${l}`, r), R = (e) => (r, t, n) => e(a(r, t, n)), A = (e, r) => (t, n, l) => _(c(a(t, n, l)) + e, r), B = (e) => "bg" + e[0].toUpperCase() + e.slice(1), C = "Bright", H = x(3, b), I = x(4, d), P = (e) => _("38;5;" + e, b), S = (e) => _("48;5;" + e, d);
+		return 2 === m ? (H = R(P), I = R(S)) : 1 === m && (H = A(0, b), I = A(10, d), P = (e) => _(c(e), b), S = (e) => _(c(e) + 10, d)), y = {
+			fg: P,
+			bg: S,
+			rgb: H,
+			bgRgb: I,
+			hex: k(H),
+			bgHex: k(I),
+			visible: g,
+			reset: _(0, 0),
+			bold: _(1, 22),
+			dim: _(2, 22),
+			italic: _(3, 23),
+			underline: _(4, 24),
+			inverse: _(7, 27),
+			hidden: _(8, 28),
+			strikethrough: _(9, 29),
+			link: { f: (e, r = e) => v ? `]8;;${e}${r}]8;;` : r != e ? `${r} (​${e}​)` : e }
+		}, "gray,black,red,green,yellow,blue,magenta,cyan,white".split(",").map(((e, r) => {
+			h = B(e), r ? (y[e + C] = _(89 + r, b), y[h + C] = _(99 + r, d)) : r = 61, y[e] = _(29 + r, b), y[h] = _(39 + r, d);
+		})), w.extend(y);
+	}();
+	module.exports = h.default = h;
+})))(), 1);
+var ansis_default = import_ansis.default;
+const { Ansis, fg, bg, rgb, bgRgb, hex, bgHex, reset, inverse, hidden, visible, link, bold, dim, italic, underline, strikethrough, black, red, green, yellow, blue, magenta, cyan, white, gray, redBright, greenBright, yellowBright, blueBright, magentaBright, cyanBright, whiteBright, bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite, bgGray, bgRedBright, bgGreenBright, bgYellowBright, bgBlueBright, bgMagentaBright, bgCyanBright, bgWhiteBright } = import_ansis.default;
+//#endregion
+//#region src/utils/colors.ts
+const colors = {
+	blue: ansis_default.blue,
+	cyan: ansis_default.cyan,
+	gray: ansis_default.gray,
+	green: ansis_default.green,
+	red: ansis_default.red,
+	yellow: ansis_default.yellow,
+	bold: ansis_default.bold,
+	dim: ansis_default.dim,
+	reset: ansis_default.reset,
+	underline: ansis_default.underline
+};
+//#endregion
+export { colors as t };

package/dist/{context-DUibxhrR.mjs → context-BBi2IQDm.mjs}

@@ -1,10 +1,10 @@
-import { o as RpcFunctionsCollectorBase } from "./rpc-CkZuoz-m.mjs";
+import { o as RpcFunctionsCollectorBase } from "./rpc-DAzoVCR0.mjs";
 import { r as diagnostics } from "./serialization-CwO31axa.mjs";
 import { defineRpcFunction } from "./index.mjs";
-import { t as colors$1 } from "./colors-Bl4W18Mh.mjs";
-import { n as logger, t as diagnostics$1 } from "./diagnostics-BFhNNmST.mjs";
+import { t as colors$1 } from "./colors-DS7k8ljB.mjs";
+import { n as logger, t as diagnostics$1 } from "./diagnostics-Cg9ycFIM.mjs";
 import { createEventEmitter } from "./utils/events.mjs";
-import { t as createSharedState } from "./shared-state-DCDs0e7y.mjs";
+import { t as createSharedState } from "./shared-state-q9-1EOSX.mjs";
 import { createStreamReader, createStreamSink } from "./utils/streaming-channel.mjs";
 import { consoleReporter, createLogger, defineDiagnostics } from "logs-sdk";
 import { ansiFormatter } from "logs-sdk/formatters/ansi";
@@ -212,7 +212,7 @@ var DevToolsDiagnosticsHost = class {
 	}
 };
 //#endregion
-//#region ../../../node_modules/.pnpm/obug@2.1.1/node_modules/obug/dist/core.js
+//#region ../../node_modules/.pnpm/obug@2.1.1/node_modules/obug/dist/core.js
 function coerce(value) {
 	if (value instanceof Error) return value.stack || value.message;
 	return value;
@@ -325,7 +325,7 @@ function enabled(name) {
 	return false;
 }
 //#endregion
-//#region ../../../node_modules/.pnpm/obug@2.1.1/node_modules/obug/dist/node.js
+//#region ../../node_modules/.pnpm/obug@2.1.1/node_modules/obug/dist/node.js
 const colors = process.stderr.getColorDepth && process.stderr.getColorDepth() > 2 ? [
 	20,
 	21,
@@ -999,13 +999,12 @@ const BUILTIN_AGENT_RPC = [
 //#endregion
 //#region src/node/context.ts
 /**
-* Framework-neutral core of the DevTools node context. Wires the RPC
-* host, view (HTTP file-serving) host, diagnostics, and agent
-* subsystems. Hub-level subsystems (`docks`, `terminals`, `messages`,
-* `commands`, `createJsonRenderer`) are owned by
-* `@vitejs/devtools-kit` — its `createKitContext` wraps this and
-* attaches them when the devframe is mounted into a multi-integration
-* hub.
+* Framework- and build-tool-agnostic core of the DevTools node context.
+* Wires the RPC host, view (HTTP file-serving) host, diagnostics, and
+* agent subsystems. Host adapters can wrap this to augment `ctx` with
+* extra surfaces — for example, `@vitejs/devtools-kit`'s
+* `createKitContext` attaches `docks`, `terminals`, `messages`,
+* `commands`, and `createJsonRenderer` when mounted into Vite DevTools.
 */
 async function createHostContext(options) {
 	const { cwd, workspaceRoot = cwd, mode, host, builtinRpcDeclarations = [] } = options;

package/dist/{context-DBd794Rn.d.mts → context-DRa0wGsC.d.mts}

@@ -1,4 +1,4 @@
-import { H as SharedState, y as DevToolsNodeContext } from "./devframe-DulcIxwu.mjs";
+import { P as SharedState, d as DevToolsNodeContext } from "./devframe-R5Ex5K5L.mjs";
 
 //#region src/node/internal/context.d.ts
 interface InternalAnonymousAuthStorage {

package/dist/{dev-BGpTpYiR.mjs → dev-CewNNE2R.mjs}

@@ -1,16 +1,16 @@
-import { t as createHostContext } from "./context-DUibxhrR.mjs";
+import { t as createHostContext } from "./context-BBi2IQDm.mjs";
 import { t as createH3DevToolsHost } from "./host-h3-Dz8YnFgu.mjs";
-import { t as startHttpAndWs } from "./server-ma8-ZVyX.mjs";
+import { t as startHttpAndWs } from "./server-DOk4grlJ.mjs";
 import { DEVTOOLS_CONNECTION_META_FILENAME } from "./constants.mjs";
-import { n as resolveBasePath, t as normalizeBasePath } from "./_shared-DcJX9-Az.mjs";
-import { t as open } from "./open-DmFp0qZA.mjs";
-import { serveStaticHandler } from "./utils/serve-static.mjs";
+import { n as resolveBasePath, t as normalizeBasePath } from "./_shared-BrKv3CYt.mjs";
+import { t as open } from "./open-B2ah1IKK.mjs";
+import { mountStaticHandler } from "./utils/serve-static.mjs";
 import { networkInterfaces } from "node:os";
 import process$1 from "node:process";
 import { resolve } from "pathe";
-import { createApp, eventHandler } from "h3";
+import { H3 } from "h3";
 import { createServer } from "node:net";
-//#region ../../../node_modules/.pnpm/get-port-please@3.2.0/node_modules/get-port-please/dist/index.mjs
+//#region ../../node_modules/.pnpm/get-port-please@3.2.0/node_modules/get-port-please/dist/index.mjs
 const unsafePorts = /* @__PURE__ */ new Set([
 	1,
 	7,
@@ -254,7 +254,7 @@ async function resolveDevServerPort(def, options = {}) {
 * server runs in **bridge mode**: only `__connection.json` and the WS
 * endpoint are mounted, with no SPA mount. The SPA is expected to be
 * hosted elsewhere (e.g. by a parent Vite/Nuxt dev server) — see
-* `createVitePlugin({ devMiddleware })`.
+* `viteDevBridge({ devMiddleware })`.
 *
 * Returns the underlying {@link StartedServer} handle so callers can
 * close it gracefully (SIGINT, hot-reload, test teardown).
@@ -269,12 +269,12 @@ async function createDevServer(def, options = {}) {
 	const port = options.port ?? await resolveDevServerPort(def, { host });
 	const flags = options.flags ?? {};
 	const basePath = options.basePath ? normalizeBasePath(options.basePath) : resolveBasePath(def, "standalone");
-	const app = options.app ?? createApp();
+	const app = options.app ?? new H3();
 	const h3Host = createH3DevToolsHost({
 		origin: `http://${host}:${port}`,
 		appName: def.id,
 		mount: (base, dir) => {
-			app.use(base, serveStaticHandler(dir));
+			mountStaticHandler(app, base, dir);
 		}
 	});
 	const ctx = await createHostContext({
@@ -285,14 +285,11 @@ async function createDevServer(def, options = {}) {
 	const setupInfo = { flags };
 	await def.setup(ctx, setupInfo);
 	const connectionMetaPath = `${basePath}${DEVTOOLS_CONNECTION_META_FILENAME}`;
-	app.use(connectionMetaPath, eventHandler((event) => {
-		event.node.res.setHeader("Content-Type", "application/json");
-		return event.node.res.end(JSON.stringify({
-			backend: "websocket",
-			websocket: port
-		}));
+	app.use(connectionMetaPath, () => ({
+		backend: "websocket",
+		websocket: port
 	}));
-	if (distDir) app.use(basePath, serveStaticHandler(resolve(distDir)));
+	if (distDir) mountStaticHandler(app, basePath, resolve(distDir));
 	return startHttpAndWs({
 		context: ctx,
 		host,

package/dist/{devframe-DulcIxwu.d.mts → devframe-R5Ex5K5L.d.mts}

@@ -866,11 +866,11 @@ interface DevToolsCapabilities {
   views?: boolean;
 }
 /**
- * Framework-neutral node context — RPC + diagnostics + agent + the
- * view-host (HTTP file-serving). Hub-level subsystems (docks,
- * terminals, messages, commands) are not part of this surface; they are
- * added by `@vitejs/devtools-kit`'s `createKitContext` when the devtool
- * is mounted into a multi-integration hub.
+ * Framework- and build-tool-agnostic node context — RPC + diagnostics +
+ * agent + the view-host (HTTP file-serving). Host adapters can wrap this
+ * to add their own surfaces; for example, `@vitejs/devtools-kit`'s
+ * `createKitContext` adds `docks`, `terminals`, `messages`, and
+ * `commands` when mounted into Vite DevTools.
  */
 interface DevToolsNodeContext {
   readonly workspaceRoot: string;
@@ -924,11 +924,11 @@ interface ConnectionMeta {
 }
 //#endregion
 //#region src/types/devframe.d.ts
-type DevframeRuntime = 'cli' | 'build' | 'spa' | 'vite' | 'kit' | 'embedded';
+type DevframeRuntime = 'cli' | 'build' | 'spa' | 'vite' | 'embedded';
 /**
  * Classification of how a devframe is being deployed. Hosted adapters
- * (`vite`, `kit`, `embedded`) share their origin with a host app and
- * must namespace their mount path under `/__<id>/`. Standalone adapters
+ * (`vite`, `embedded`) share their origin with a host app and must
+ * namespace their mount path under `/__<id>/`. Standalone adapters
  * (`cli`, `spa`, `build`) own the origin and default to `/`.
  */
 type DevframeDeploymentKind = 'standalone' | 'hosted';
@@ -1030,7 +1030,7 @@ interface DevframeDefinition {
   /**
    * Mount path override. Defaults depend on the adapter:
    * `/` for standalone (`cli` / `spa` / `build`), `/__<id>/` for hosted
-   * (`vite` / `kit` / `embedded`).
+   * (`vite` / `embedded`).
    */
   basePath?: string;
   capabilities?: {
@@ -1046,21 +1046,5 @@ interface DevframeDefinition {
   spa?: DevframeSpaOptions;
 }
 declare function defineDevframe(d: DevframeDefinition): DevframeDefinition;
-/** @deprecated Use `DevframeRuntime`. */
-type DevtoolRuntime = DevframeRuntime;
-/** @deprecated Use `DevframeDeploymentKind`. */
-type DevtoolDeploymentKind = DevframeDeploymentKind;
-/** @deprecated Use `DevframeCliOptions`. */
-type DevtoolCliOptions = DevframeCliOptions;
-/** @deprecated Use `DevframeSpaOptions`. */
-type DevtoolSpaOptions = DevframeSpaOptions;
-/** @deprecated Use `DevframeBrowserContext`. */
-type DevtoolBrowserContext = DevframeBrowserContext;
-/** @deprecated Use `DevframeSetupInfo`. */
-type DevtoolSetupInfo = DevframeSetupInfo;
-/** @deprecated Use `DevframeDefinition`. */
-type DevtoolDefinition = DevframeDefinition;
-/** @deprecated Use `defineDevframe`. */
-declare function defineDevtool(d: DevframeDefinition): DevframeDefinition;
 //#endregion
-export { DevToolsRpcSharedStates as $, CreateStreamSinkOptions as A, ImmutableObject as B, RpcSharedStateGetOptions as C, RpcStreamingHost as D, RpcStreamingChannelOptions as E, createStreamReader as F, SharedStatePatch as G, SharedState as H, createStreamSink as I, EntriesToObject as J, createSharedState as K, Immutable as L, StreamReader as M, StreamSink as N, BufferedChunk as O, StreamSinkEvents as P, DevToolsRpcServerFunctions as Q, ImmutableArray as R, RpcFunctionsHost as S, RpcStreamingChannel as T, SharedStateEvents as U, ImmutableSet as V, SharedStateOptions as W, Thenable as X, PartialWithoutId as Y, DevToolsRpcClientFunctions as Z, ConnectionMeta as _, InferCliFlags as _t, DevframeRuntime as a, AgentManifest as at, DevToolsNodeRpcSession as b, DevtoolBrowserContext as c, AgentResourceInput as ct, DevtoolDeploymentKind as d, DevToolsAgentHost as dt, DevToolsHost as et, DevtoolRuntime as f, DevToolsAgentHostEvents as ft, defineDevtool as g, CliFlagsSchema as gt, defineDevframe as h, EventsMap as ht, DevframeDeploymentKind as i, AgentHandle as it, StreamErrorPayload as j, CreateStreamReaderOptions as k, DevtoolCliOptions as l, AgentTool as lt, DevtoolSpaOptions as m, EventUnsubscribe as mt, DevframeCliOptions as n, DevToolsDiagnosticsHost as nt, DevframeSetupInfo as o, AgentResource as ot, DevtoolSetupInfo as p, EventEmitter as pt, DevToolsViewHost as q, DevframeDefinition as r, DevToolsDiagnosticsLogger as rt, DevframeSpaOptions as s, AgentResourceContent as st, DevframeBrowserContext as t, DevToolsDiagnosticsDefinition as tt, DevtoolDefinition as u, AgentToolInput as ut, DevToolsCapabilities as v, defineCliFlags as vt, RpcSharedStateHost as w, RpcBroadcastOptions as x, DevToolsNodeContext as y, parseCliFlags as yt, ImmutableMap as z };
+export { AgentResourceContent as $, ImmutableArray as A, EntriesToObject as B, StreamErrorPayload as C, createStreamReader as D, StreamSinkEvents as E, SharedStateEvents as F, DevToolsRpcSharedStates as G, Thenable as H, SharedStateOptions as I, DevToolsDiagnosticsHost as J, DevToolsHost as K, SharedStatePatch as L, ImmutableObject as M, ImmutableSet as N, createStreamSink as O, SharedState as P, AgentResource as Q, createSharedState as R, CreateStreamSinkOptions as S, StreamSink as T, DevToolsRpcClientFunctions as U, PartialWithoutId as V, DevToolsRpcServerFunctions as W, AgentHandle as X, DevToolsDiagnosticsLogger as Y, AgentManifest as Z, RpcStreamingChannel as _, DevframeRuntime as a, EventEmitter as at, BufferedChunk as b, defineDevframe as c, CliFlagsSchema as ct, DevToolsNodeContext as d, parseCliFlags as dt, AgentResourceInput as et, DevToolsNodeRpcSession as f, RpcSharedStateHost as g, RpcSharedStateGetOptions as h, DevframeDeploymentKind as i, DevToolsAgentHostEvents as it, ImmutableMap as j, Immutable as k, ConnectionMeta as l, InferCliFlags as lt, RpcFunctionsHost as m, DevframeCliOptions as n, AgentToolInput as nt, DevframeSetupInfo as o, EventUnsubscribe as ot, RpcBroadcastOptions as p, DevToolsDiagnosticsDefinition as q, DevframeDefinition as r, DevToolsAgentHost as rt, DevframeSpaOptions as s, EventsMap as st, DevframeBrowserContext as t, AgentTool as tt, DevToolsCapabilities as u, defineCliFlags as ut, RpcStreamingChannelOptions as v, StreamReader as w, CreateStreamReaderOptions as x, RpcStreamingHost as y, DevToolsViewHost as z };

package/dist/{diagnostics-BFhNNmST.mjs → diagnostics-Cg9ycFIM.mjs}

@@ -1,4 +1,4 @@
-import { t as colors } from "./colors-Bl4W18Mh.mjs";
+import { t as colors } from "./colors-DS7k8ljB.mjs";
 import { consoleReporter, createLogger, defineDiagnostics } from "logs-sdk";
 import { ansiFormatter } from "logs-sdk/formatters/ansi";
 //#region src/node/diagnostics.ts
@@ -42,7 +42,7 @@ const diagnostics = defineDiagnostics({
 		},
 		DF0033: {
 			message: (p) => `Failed to start dev RPC bridge for "${p.id}": ${p.reason}`,
-			hint: "Verify the bridge port is free and the devframe setup function does not throw. Pin a port via `cli.port` / `cli.portRange` on the definition, or via `devMiddleware.port` on `createVitePlugin`.",
+			hint: "Verify the bridge port is free and the devframe setup function does not throw. Pin a port via `cli.port` / `cli.portRange` on the definition, or via `devMiddleware.port` on `viteDevBridge`.",
 			level: "warn"
 		}
 	}