devframe 0.1.22 → 0.2.1

package/dist/{dev-BGpTpYiR.mjs → dev-CA0-8Amw.mjs}

@@ -1,16 +1,15 @@
-import { t as createHostContext } from "./context-DUibxhrR.mjs";
-import { t as createH3DevToolsHost } from "./host-h3-Dz8YnFgu.mjs";
-import { t as startHttpAndWs } from "./server-ma8-ZVyX.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 createHostContext, t as createH3DevToolsHost } from "./host-h3-CpYkiCIU.mjs";
+import { t as startHttpAndWs } from "./server-G1ymmN3_.mjs";
+import { n as resolveBasePath, t as normalizeBasePath } from "./_shared-C_yZKUmx.mjs";
+import { t as open } from "./open-CWL4Zasd.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 +253,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 +268,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 +284,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-BXZUBuy6.d.mts}

@@ -1,5 +1,5 @@
-import { f as RpcFunctionsCollectorBase } from "./index-DB2Ie0Or.mjs";
-import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-DjvlwLuM.mjs";
+import { S as RpcFunctionsCollectorBase } from "./index-BO4daMzR.mjs";
+import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-kW8RZXTw.mjs";
 import { Logger, createLogger, defineDiagnostics } from "logs-sdk";
 import { BirpcReturn } from "birpc";
 import { CAC } from "cac";
@@ -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"
 		}
 	}

package/dist/hash-CIBte1yS.mjs

@@ -0,0 +1,263 @@
+//#region ../../node_modules/.pnpm/ohash@2.0.11/node_modules/ohash/dist/shared/ohash.D__AXeF1.mjs
+function serialize(o) {
+	return typeof o == "string" ? `'${o}'` : new c().serialize(o);
+}
+const c = /* @__PURE__ */ function() {
+	class o {
+		#t = /* @__PURE__ */ new Map();
+		compare(t, r) {
+			const e = typeof t, n = typeof r;
+			return e === "string" && n === "string" ? t.localeCompare(r) : e === "number" && n === "number" ? t - r : String.prototype.localeCompare.call(this.serialize(t, true), this.serialize(r, true));
+		}
+		serialize(t, r) {
+			if (t === null) return "null";
+			switch (typeof t) {
+				case "string": return r ? t : `'${t}'`;
+				case "bigint": return `${t}n`;
+				case "object": return this.$object(t);
+				case "function": return this.$function(t);
+			}
+			return String(t);
+		}
+		serializeObject(t) {
+			const r = Object.prototype.toString.call(t);
+			if (r !== "[object Object]") return this.serializeBuiltInType(r.length < 10 ? `unknown:${r}` : r.slice(8, -1), t);
+			const e = t.constructor, n = e === Object || e === void 0 ? "" : e.name;
+			if (n !== "" && globalThis[n] === e) return this.serializeBuiltInType(n, t);
+			if (typeof t.toJSON == "function") {
+				const i = t.toJSON();
+				return n + (i !== null && typeof i == "object" ? this.$object(i) : `(${this.serialize(i)})`);
+			}
+			return this.serializeObjectEntries(n, Object.entries(t));
+		}
+		serializeBuiltInType(t, r) {
+			const e = this["$" + t];
+			if (e) return e.call(this, r);
+			if (typeof r?.entries == "function") return this.serializeObjectEntries(t, r.entries());
+			throw new Error(`Cannot serialize ${t}`);
+		}
+		serializeObjectEntries(t, r) {
+			const e = Array.from(r).sort((i, a) => this.compare(i[0], a[0]));
+			let n = `${t}{`;
+			for (let i = 0; i < e.length; i++) {
+				const [a, l] = e[i];
+				n += `${this.serialize(a, true)}:${this.serialize(l)}`, i < e.length - 1 && (n += ",");
+			}
+			return n + "}";
+		}
+		$object(t) {
+			let r = this.#t.get(t);
+			return r === void 0 && (this.#t.set(t, `#${this.#t.size}`), r = this.serializeObject(t), this.#t.set(t, r)), r;
+		}
+		$function(t) {
+			const r = Function.prototype.toString.call(t);
+			return r.slice(-15) === "[native code] }" ? `${t.name || ""}()[native]` : `${t.name}(${t.length})${r.replace(/\s*\n\s*/g, "")}`;
+		}
+		$Array(t) {
+			let r = "[";
+			for (let e = 0; e < t.length; e++) r += this.serialize(t[e]), e < t.length - 1 && (r += ",");
+			return r + "]";
+		}
+		$Date(t) {
+			try {
+				return `Date(${t.toISOString()})`;
+			} catch {
+				return "Date(null)";
+			}
+		}
+		$ArrayBuffer(t) {
+			return `ArrayBuffer[${new Uint8Array(t).join(",")}]`;
+		}
+		$Set(t) {
+			return `Set${this.$Array(Array.from(t).sort((r, e) => this.compare(r, e)))}`;
+		}
+		$Map(t) {
+			return this.serializeObjectEntries("Map", t.entries());
+		}
+	}
+	for (const s of [
+		"Error",
+		"RegExp",
+		"URL"
+	]) o.prototype["$" + s] = function(t) {
+		return `${s}(${t})`;
+	};
+	for (const s of [
+		"Int8Array",
+		"Uint8Array",
+		"Uint8ClampedArray",
+		"Int16Array",
+		"Uint16Array",
+		"Int32Array",
+		"Uint32Array",
+		"Float32Array",
+		"Float64Array"
+	]) o.prototype["$" + s] = function(t) {
+		return `${s}[${t.join(",")}]`;
+	};
+	for (const s of ["BigInt64Array", "BigUint64Array"]) o.prototype["$" + s] = function(t) {
+		return `${s}[${t.join("n,")}${t.length > 0 ? "n" : ""}]`;
+	};
+	return o;
+}();
+//#endregion
+//#region ../../node_modules/.pnpm/ohash@2.0.11/node_modules/ohash/dist/crypto/js/index.mjs
+const z = [
+	1779033703,
+	-1150833019,
+	1013904242,
+	-1521486534,
+	1359893119,
+	-1694144372,
+	528734635,
+	1541459225
+], R = [
+	1116352408,
+	1899447441,
+	-1245643825,
+	-373957723,
+	961987163,
+	1508970993,
+	-1841331548,
+	-1424204075,
+	-670586216,
+	310598401,
+	607225278,
+	1426881987,
+	1925078388,
+	-2132889090,
+	-1680079193,
+	-1046744716,
+	-459576895,
+	-272742522,
+	264347078,
+	604807628,
+	770255983,
+	1249150122,
+	1555081692,
+	1996064986,
+	-1740746414,
+	-1473132947,
+	-1341970488,
+	-1084653625,
+	-958395405,
+	-710438585,
+	113926993,
+	338241895,
+	666307205,
+	773529912,
+	1294757372,
+	1396182291,
+	1695183700,
+	1986661051,
+	-2117940946,
+	-1838011259,
+	-1564481375,
+	-1474664885,
+	-1035236496,
+	-949202525,
+	-778901479,
+	-694614492,
+	-200395387,
+	275423344,
+	430227734,
+	506948616,
+	659060556,
+	883997877,
+	958139571,
+	1322822218,
+	1537002063,
+	1747873779,
+	1955562222,
+	2024104815,
+	-2067236844,
+	-1933114872,
+	-1866530822,
+	-1538233109,
+	-1090935817,
+	-965641998
+], S = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_", r = [];
+var k = class {
+	_data = new l();
+	_hash = new l([...z]);
+	_nDataBytes = 0;
+	_minBufferSize = 0;
+	finalize(e) {
+		e && this._append(e);
+		const s = this._nDataBytes * 8, t = this._data.sigBytes * 8;
+		return this._data.words[t >>> 5] |= 128 << 24 - t % 32, this._data.words[(t + 64 >>> 9 << 4) + 14] = Math.floor(s / 4294967296), this._data.words[(t + 64 >>> 9 << 4) + 15] = s, this._data.sigBytes = this._data.words.length * 4, this._process(), this._hash;
+	}
+	_doProcessBlock(e, s) {
+		const t = this._hash.words;
+		let i = t[0], o = t[1], a = t[2], c = t[3], h = t[4], g = t[5], f = t[6], y = t[7];
+		for (let n = 0; n < 64; n++) {
+			if (n < 16) r[n] = e[s + n] | 0;
+			else {
+				const d = r[n - 15], j = (d << 25 | d >>> 7) ^ (d << 14 | d >>> 18) ^ d >>> 3, B = r[n - 2], x = (B << 15 | B >>> 17) ^ (B << 13 | B >>> 19) ^ B >>> 10;
+				r[n] = j + r[n - 7] + x + r[n - 16];
+			}
+			const m = h & g ^ ~h & f, p = i & o ^ i & a ^ o & a, u = (i << 30 | i >>> 2) ^ (i << 19 | i >>> 13) ^ (i << 10 | i >>> 22), b = (h << 26 | h >>> 6) ^ (h << 21 | h >>> 11) ^ (h << 7 | h >>> 25), w = y + b + m + R[n] + r[n], M = u + p;
+			y = f, f = g, g = h, h = c + w | 0, c = a, a = o, o = i, i = w + M | 0;
+		}
+		t[0] = t[0] + i | 0, t[1] = t[1] + o | 0, t[2] = t[2] + a | 0, t[3] = t[3] + c | 0, t[4] = t[4] + h | 0, t[5] = t[5] + g | 0, t[6] = t[6] + f | 0, t[7] = t[7] + y | 0;
+	}
+	_append(e) {
+		typeof e == "string" && (e = l.fromUtf8(e)), this._data.concat(e), this._nDataBytes += e.sigBytes;
+	}
+	_process(e) {
+		let s, t = this._data.sigBytes / 64;
+		e ? t = Math.ceil(t) : t = Math.max((t | 0) - this._minBufferSize, 0);
+		const i = t * 16, o = Math.min(i * 4, this._data.sigBytes);
+		if (i) {
+			for (let a = 0; a < i; a += 16) this._doProcessBlock(this._data.words, a);
+			s = this._data.words.splice(0, i), this._data.sigBytes -= o;
+		}
+		return new l(s, o);
+	}
+};
+var l = class l {
+	words;
+	sigBytes;
+	constructor(e, s) {
+		e = this.words = e || [], this.sigBytes = s === void 0 ? e.length * 4 : s;
+	}
+	static fromUtf8(e) {
+		const s = unescape(encodeURIComponent(e)), t = s.length, i = [];
+		for (let o = 0; o < t; o++) i[o >>> 2] |= (s.charCodeAt(o) & 255) << 24 - o % 4 * 8;
+		return new l(i, t);
+	}
+	toBase64() {
+		const e = [];
+		for (let s = 0; s < this.sigBytes; s += 3) {
+			const t = this.words[s >>> 2] >>> 24 - s % 4 * 8 & 255, i = this.words[s + 1 >>> 2] >>> 24 - (s + 1) % 4 * 8 & 255, o = this.words[s + 2 >>> 2] >>> 24 - (s + 2) % 4 * 8 & 255, a = t << 16 | i << 8 | o;
+			for (let c = 0; c < 4 && s * 8 + c * 6 < this.sigBytes * 8; c++) e.push(S.charAt(a >>> 6 * (3 - c) & 63));
+		}
+		return e.join("");
+	}
+	concat(e) {
+		if (this.words[this.sigBytes >>> 2] &= 4294967295 << 32 - this.sigBytes % 4 * 8, this.words.length = Math.ceil(this.sigBytes / 4), this.sigBytes % 4) for (let s = 0; s < e.sigBytes; s++) {
+			const t = e.words[s >>> 2] >>> 24 - s % 4 * 8 & 255;
+			this.words[this.sigBytes + s >>> 2] |= t << 24 - (this.sigBytes + s) % 4 * 8;
+		}
+		else for (let s = 0; s < e.sigBytes; s += 4) this.words[this.sigBytes + s >>> 2] = e.words[s >>> 2];
+		this.sigBytes += e.sigBytes;
+	}
+};
+function digest(_) {
+	return new k().finalize(_).toBase64();
+}
+//#endregion
+//#region ../../node_modules/.pnpm/ohash@2.0.11/node_modules/ohash/dist/index.mjs
+function hash$1(input) {
+	return digest(serialize(input));
+}
+//#endregion
+//#region src/utils/hash.ts
+/**
+* Stable, deterministic hash of any structured-cloneable value.
+*/
+function hash(value) {
+	return hash$1(value);
+}
+//#endregion
+export { hash as t };

package/dist/{adapters → helpers}/vite.d.mts

@@ -1,7 +1,7 @@
-import { r as DevframeDefinition } from "../devframe-DulcIxwu.mjs";
+import { r as DevframeDefinition } from "../devframe-BXZUBuy6.mjs";
 
-//#region src/adapters/vite.d.ts
-interface CreateVitePluginOptions {
+//#region src/helpers/vite.d.ts
+interface ViteDevBridgeOptions {
   /**
    * Mount base. Defaults to `def.basePath ?? '/__<id>/'` for this hosted
    * adapter — the devframe shares the origin with the host Vite app.
@@ -43,9 +43,8 @@ interface DevframeVitePlugin {
   closeBundle?: () => void | Promise<void>;
 }
 /**
- * Vite plugin for hosting a devframe inside a Vite dev server.
- *
- * Two modes, picked via `options.devMiddleware`:
+ * Bridge a devframe into an existing Vite dev server. Returns a Vite
+ * plugin with two modes, picked via `options.devMiddleware`:
  *
  *   - **static-mount mode** (default) — mounts `def.cli.distDir` at
  *     `options.base` with SPA fallback enabled. No RPC server is started.
@@ -61,6 +60,6 @@ interface DevframeVitePlugin {
  * (Nuxt, Astro, SolidStart, plain Vite apps). For the all-in-one
  * `dev` / `build` / `mcp` shell, reach for {@link createCli} instead.
  */
-declare function createVitePlugin(d: DevframeDefinition, options?: CreateVitePluginOptions): DevframeVitePlugin;
+declare function viteDevBridge(d: DevframeDefinition, options?: ViteDevBridgeOptions): DevframeVitePlugin;
 //#endregion
-export { CreateVitePluginOptions, DevframeVitePlugin, createVitePlugin };
+export { DevframeVitePlugin, ViteDevBridgeOptions, viteDevBridge };

package/dist/{adapters → helpers}/vite.mjs

@@ -1,14 +1,13 @@
-import { n as logger } from "../diagnostics-BFhNNmST.mjs";
 import { DEVTOOLS_CONNECTION_META_FILENAME } from "../constants.mjs";
-import { n as resolveBasePath } from "../_shared-DcJX9-Az.mjs";
+import { n as logger } from "../diagnostics-Cg9ycFIM.mjs";
+import { n as resolveBasePath } from "../_shared-C_yZKUmx.mjs";
 import { serveStaticNodeMiddleware } from "../utils/serve-static.mjs";
-import { n as resolveDevServerPort, t as createDevServer } from "../dev-BGpTpYiR.mjs";
+import { n as resolveDevServerPort, t as createDevServer } from "../dev-CA0-8Amw.mjs";
 import { resolve } from "pathe";
-//#region src/adapters/vite.ts
+//#region src/helpers/vite.ts
 /**
-* Vite plugin for hosting a devframe inside a Vite dev server.
-*
-* Two modes, picked via `options.devMiddleware`:
+* Bridge a devframe into an existing Vite dev server. Returns a Vite
+* plugin with two modes, picked via `options.devMiddleware`:
 *
 *   - **static-mount mode** (default) — mounts `def.cli.distDir` at
 *     `options.base` with SPA fallback enabled. No RPC server is started.
@@ -24,7 +23,7 @@ import { resolve } from "pathe";
 * (Nuxt, Astro, SolidStart, plain Vite apps). For the all-in-one
 * `dev` / `build` / `mcp` shell, reach for {@link createCli} instead.
 */
-function createVitePlugin(d, options = {}) {
+function viteDevBridge(d, options = {}) {
 	const base = normalizeMountBase(options.base ?? resolveBasePath(d, "hosted"));
 	if (!options.devMiddleware) {
 		const distDir = d.cli?.distDir;
@@ -92,4 +91,4 @@ function normalizeMountBase(base) {
 	return out.replace(/\/+/g, "/");
 }
 //#endregion
-export { createVitePlugin };
+export { viteDevBridge };

package/dist/{context-DUibxhrR.mjs → host-h3-CpYkiCIU.mjs}

@@ -1,16 +1,19 @@
-import { o as RpcFunctionsCollectorBase } from "./rpc-CkZuoz-m.mjs";
+import { l as RpcFunctionsCollectorBase } from "./rpc-BlVCyk9W.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";
 import { isatty } from "node:tty";
 import { formatWithOptions, inspect } from "node:util";
 import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import process$1 from "node:process";
+import { join } from "pathe";
 //#region src/node/host-agent.ts
 /**
 * Framework-neutral host aggregating the agent-exposed surface of a
@@ -212,7 +215,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 +328,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 +1002,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;
@@ -1031,4 +1033,24 @@ async function createHostContext(options) {
 	return context;
 }
 //#endregion
-export { createRpcSharedStateServerHost as a, createRpcStreamingServerHost as i, DevToolsViewHost as n, DevToolsDiagnosticsHost as o, RpcFunctionsHost as r, DevToolsAgentHost as s, createHostContext as t };
+//#region src/node/host-h3.ts
+/**
+* h3-backed {@link DevToolsHost} — used by the standalone CLI adapter.
+*/
+function createH3DevToolsHost(options) {
+	const workspaceRoot = options.workspaceRoot ?? process$1.cwd();
+	return {
+		mountStatic(base, distDir) {
+			return options.mount?.(base, distDir);
+		},
+		resolveOrigin() {
+			return options.origin;
+		},
+		getStorageDir(scope) {
+			const namespace = `.${options.appName}/devtools`;
+			return scope === "workspace" ? join(workspaceRoot, "node_modules", namespace) : join(homedir(), namespace);
+		}
+	};
+}
+//#endregion
+export { createRpcStreamingServerHost as a, DevToolsAgentHost as c, RpcFunctionsHost as i, createHostContext as n, createRpcSharedStateServerHost as o, DevToolsViewHost as r, DevToolsDiagnosticsHost as s, createH3DevToolsHost as t };

package/dist/{index-DB2Ie0Or.d.mts → index-BO4daMzR.d.mts}

@@ -1,4 +1,4 @@
-import { C as RpcReturnSchema, S as RpcFunctionsCollector, b as RpcFunctionSetupResult, c as RpcDumpClientOptions, g as RpcFunctionDefinitionAny, h as RpcFunctionDefinition, i as RpcArgsSchema, l as RpcDumpCollectionOptions, n as BirpcReturn, o as RpcDefinitionsToFunctions, p as RpcDumpStore, x as RpcFunctionType } from "./types-4rdUEi2R.mjs";
+import { C as RpcFunctionsCollector, S as RpcFunctionType, _ as RpcFunctionDefinitionAny, c as RpcDumpClientOptions, g as RpcFunctionDefinition, i as RpcArgsSchema, l as RpcDumpCollectionOptions, m as RpcDumpStore, n as BirpcReturn, o as RpcDefinitionsToFunctions, p as RpcDumpRecordError, w as RpcReturnSchema, x as RpcFunctionSetupResult } from "./types-ip8THGH1.mjs";
 
 //#region src/rpc/cache.d.ts
 interface RpcCacheOptions {
@@ -47,7 +47,7 @@ declare class RpcFunctionsCollectorBase<LocalFunctions extends Record<string, an
 declare function defineRpcFunction<NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS>): RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS>;
 declare function createDefineWrapperWithContext<CONTEXT>(): <NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, CONTEXT>) => RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, CONTEXT>;
 //#endregion
-//#region src/rpc/dumps.d.ts
+//#region src/rpc/dump/index.d.ts
 /**
  * Collects pre-computed dumps by executing functions with their defined input combinations.
  * Static functions without dump config automatically get `{ inputs: [[]] }`.
@@ -75,6 +75,54 @@ declare function createClientFromDump<T extends Record<string, any>>(store: RpcD
  */
 declare function getDefinitionsWithDumps<T extends readonly RpcFunctionDefinitionAny[]>(definitions: T): RpcFunctionDefinitionAny[];
 //#endregion
+//#region src/rpc/dump/error.d.ts
+/**
+ * Normalize a thrown value into a plain object suitable for storage in
+ * a dump record. Preserves `message`, `name`, `cause`, and any own
+ * enumerable properties of an `Error` so consumers reading the dump can
+ * reconstruct a richer Error than just `{ message, name }`.
+ *
+ * Non-`Error` throws are wrapped as `{ name: 'Error', message: String(thrown) }`.
+ */
+declare function serializeDumpError(error: unknown): RpcDumpRecordError;
+/**
+ * Inverse of {@link serializeDumpError}: rebuild a thrown `Error` from
+ * the plain object stored in a dump record. Preserves `cause`, restores
+ * the original `name`, and re-attaches any custom own properties.
+ */
+declare function reviveDumpError(stored: RpcDumpRecordError): Error;
+//#endregion
+//#region src/rpc/dump/static.d.ts
+type StaticRpcDumpSerialization = 'json' | 'structured-clone';
+interface StaticRpcDumpManifestStaticEntry {
+  type: 'static';
+  path: string;
+  /** Encoder used when this entry's file was written. Default: `'json'`. */
+  serialization?: StaticRpcDumpSerialization;
+}
+interface StaticRpcDumpManifestQueryEntry {
+  type: 'query';
+  records: Record<string, string>;
+  fallback?: string;
+  /** Encoder used when each record/fallback file was written. Default: `'json'`. */
+  serialization?: StaticRpcDumpSerialization;
+}
+type StaticRpcDumpManifestValue = StaticRpcDumpManifestStaticEntry | StaticRpcDumpManifestQueryEntry | any;
+type StaticRpcDumpManifest = Record<string, StaticRpcDumpManifestValue>;
+interface StaticRpcDumpFile {
+  /** Whether this file was written via `JSON.stringify` or `structured-clone-es.stringify`. */
+  serialization: StaticRpcDumpSerialization;
+  /** Function name the file belongs to — used to scope `DF0019` errors during write. */
+  fnName: string;
+  /** Payload to encode. */
+  data: unknown;
+}
+interface StaticRpcDumpCollection {
+  manifest: StaticRpcDumpManifest;
+  files: Record<string, StaticRpcDumpFile>;
+}
+declare function collectStaticRpcDump(definitions: Iterable<RpcFunctionDefinitionAny>, context: any): Promise<StaticRpcDumpCollection>;
+//#endregion
 //#region src/rpc/handler.d.ts
 declare function getRpcResolvedSetupResult<NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, CONTEXT = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, any, any, CONTEXT>, context: CONTEXT): Promise<RpcFunctionSetupResult<ARGS, RETURN>>;
 declare function getRpcHandler<NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, CONTEXT = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, any, any, CONTEXT>, context: CONTEXT): Promise<(...args: ARGS) => RETURN>;
@@ -136,4 +184,4 @@ declare function validateDefinitions(definitions: readonly RpcFunctionDefinition
  */
 declare function validateDefinition(definition: RpcFunctionDefinitionAny): void;
 //#endregion
-export { getRpcHandler as a, dumpFunctions as c, defineRpcFunction as d, RpcFunctionsCollectorBase as f, strictJsonStringify as i, getDefinitionsWithDumps as l, RpcCacheOptions as m, validateDefinitions as n, getRpcResolvedSetupResult as o, RpcCacheManager as p, STRUCTURED_CLONE_PREFIX as r, createClientFromDump as s, validateDefinition as t, createDefineWrapperWithContext as u };
+export { RpcCacheManager as C, RpcFunctionsCollectorBase as S, createClientFromDump as _, getRpcHandler as a, createDefineWrapperWithContext as b, StaticRpcDumpFile as c, StaticRpcDumpManifestStaticEntry as d, StaticRpcDumpManifestValue as f, serializeDumpError as g, reviveDumpError as h, strictJsonStringify as i, StaticRpcDumpManifest as l, collectStaticRpcDump as m, validateDefinitions as n, getRpcResolvedSetupResult as o, StaticRpcDumpSerialization as p, STRUCTURED_CLONE_PREFIX as r, StaticRpcDumpCollection as s, validateDefinition as t, StaticRpcDumpManifestQueryEntry as u, dumpFunctions as v, RpcCacheOptions as w, defineRpcFunction as x, getDefinitionsWithDumps as y };