devframe 0.1.21 → 0.1.22

package/dist/client/index.mjs

@@ -1,14 +1,14 @@
-import { t as import_dist } from "../human-id-BLoGo_e5.mjs";
-import { l as RpcCacheManager, o as RpcFunctionsCollectorBase } from "../rpc-INbWfHoX.mjs";
-import { r as structuredCloneDeserialize } from "../serialization-DwKi05Pn.mjs";
+import { t as hash } from "../hash-BHZbo80D.mjs";
+import { l as RpcCacheManager, o as RpcFunctionsCollectorBase } from "../rpc-CkZuoz-m.mjs";
 import { createRpcClient } from "../rpc/client.mjs";
+import { t as structuredCloneDeserialize } from "../structured-clone-DcDc2Dds.mjs";
 import { createWsRpcChannel } from "../rpc/transports/ws-client.mjs";
 import { createEventEmitter } from "../utils/events.mjs";
-import { createSharedState } from "../utils/shared-state.mjs";
+import { t as createSharedState } from "../shared-state-DCDs0e7y.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";
 import { promiseWithResolver } from "../utils/promise.mjs";
-import { hash } from "ohash";
 //#region src/client/rpc-shared-state.ts
 function createRpcSharedStateClientHost(rpc) {
 	const sharedState = /* @__PURE__ */ new Map();
@@ -1541,10 +1541,7 @@ function getConnectionAuthTokenFromWindows(userAuthToken) {
 		value = getter();
 		if (value) break;
 	} catch {}
-	if (!value) value = (0, import_dist.humanId)({
-		separator: "-",
-		capitalize: false
-	});
+	if (!value) value = humanId();
 	localStorage.setItem(CONNECTION_AUTH_TOKEN_KEY, value);
 	globalThis[CONNECTION_AUTH_TOKEN_KEY] = value;
 	return value;
@@ -1661,4 +1658,16 @@ async function getDevToolsRpcClient(options = {}) {
 	return rpc;
 }
 //#endregion
-export { getDevToolsRpcClient as connectDevtool, getDevToolsRpcClient, createRpcStreamingClientHost };
+//#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 };

package/dist/colors-Bl4W18Mh.mjs

@@ -0,0 +1,123 @@
+import { r as __toESM, t as __commonJSMin } from "./chunk-e9Ob2GDo.mjs";
+//#endregion
+//#region ../../../node_modules/.pnpm/ansis@4.2.0/node_modules/ansis/index.mjs
+var import_ansis = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
+	let e, t, r, { defineProperty: l, setPrototypeOf: n, create: o, keys: s } = Object, i = "", { round: c, max: a } = Math, p = (e) => {
+		let t = /([a-f\d]{3,6})/i.exec(e)?.[1], r = t?.length, l = parseInt(6 ^ r ? 3 ^ r ? "0" : t[0] + t[0] + t[1] + t[1] + t[2] + t[2] : t, 16);
+		return [
+			l >> 16 & 255,
+			l >> 8 & 255,
+			255 & l
+		];
+	}, u = (e, t, r) => e ^ t || t ^ r ? 16 + 36 * c(e / 51) + 6 * c(t / 51) + c(r / 51) : 8 > e ? 16 : e > 248 ? 231 : c(24 * (e - 8) / 247) + 232, d = (e) => {
+		let t, r, l, n, o;
+		return 8 > e ? 30 + e : 16 > e ? e - 8 + 90 : (232 > e ? (o = (e -= 16) % 36, t = (e / 36 | 0) / 5, r = (o / 6 | 0) / 5, l = o % 6 / 5) : t = r = l = (10 * (e - 232) + 8) / 255, n = 2 * a(t, r, l), n ? 30 + (c(l) << 2 | c(r) << 1 | c(t)) + (2 ^ n ? 0 : 60) : 30);
+	}, f = (() => {
+		let r = (e) => o.some(((t) => e.test(t))), l = globalThis, n = l.process ?? {}, o = n.argv ?? [], i = n.env ?? {}, c = -1;
+		try {
+			e = "," + s(i).join(",");
+		} catch (e) {
+			i = {}, c = 0;
+		}
+		let a = "FORCE_COLOR", p = {
+			false: 0,
+			0: 0,
+			1: 1,
+			2: 2,
+			3: 3
+		}[i[a]] ?? -1, u = a in i && p || r(/^--color=?(true|always)?$/);
+		return u && (c = p), ~c || (c = ((r, l, n) => (t = r.TERM, {
+			"24bit": 3,
+			truecolor: 3,
+			ansi256: 2,
+			ansi: 1
+		}[r.COLORTERM] || (r.CI ? /,GITHUB/.test(e) ? 3 : 1 : l && "dumb" !== t ? n ? 3 : /-256/.test(t) ? 2 : 1 : 0)))(i, !!i.PM2_HOME || i.NEXT_RUNTIME?.includes("edge") || !!n.stdout?.isTTY, "win32" === n.platform)), !p || i.NO_COLOR || r(/^--(no-color|color=(false|never))$/) ? 0 : l.window?.chrome || u && !c ? 3 : c;
+	})(), g = {
+		open: i,
+		close: i
+	}, h = 39, b = 49, O = {}, m = ({ p: e }, { open: t, close: l }) => {
+		let o = (e, ...r) => {
+			if (!e) {
+				if (t && t === l) return t;
+				if ((e ?? i) === i) return i;
+			}
+			let n, s = e.raw ? String.raw({ raw: e }, ...r) : i + e, c = o.p, a = c.o, p = c.c;
+			if (s.includes("\x1B")) for (; c; c = c.p) {
+				let { open: e, close: t } = c, r = t.length, l = i, o = 0;
+				if (r) for (; ~(n = s.indexOf(t, o)); o = n + r) l += s.slice(o, n) + e;
+				s = l + s.slice(o);
+			}
+			return a + (s.includes("\n") ? s.replace(/(\r?\n)/g, p + "$1" + a) : s) + p;
+		}, s = t, c = l;
+		return e && (s = e.o + t, c = l + e.c), n(o, r), o.p = {
+			open: t,
+			close: l,
+			o: s,
+			c,
+			p: e
+		}, o.open = s, o.close = c, o;
+	};
+	const w = new function e(t = f) {
+		let s = {
+			Ansis: e,
+			level: t,
+			isSupported: () => a,
+			strip: (e) => e.replace(/[›][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, i),
+			extend(e) {
+				for (let t in e) {
+					let r = e[t], l = (typeof r)[0];
+					"s" === l ? (c(t, T(...p(r))), c(_(t), v(...p(r)))) : c(t, r, "f" === l);
+				}
+				return r = o({}, O), n(s, r), s;
+			}
+		}, c = (e, t, r) => {
+			O[e] = { get() {
+				let n = r ? (...e) => m(this, t(...e)) : m(this, t);
+				return l(this, e, { value: n }), n;
+			} };
+		}, a = t > 0, w = (e, t) => a ? {
+			open: `[${e}m`,
+			close: `[${t}m`
+		} : g, y = (e) => (t) => e(...p(t)), R = (e, t) => (r, l, n) => w(`${e}8;2;${r};${l};${n}`, t), $ = (e, t) => (r, l, n) => w(((e, t, r) => d(u(e, t, r)))(r, l, n) + e, t), x = (e) => (t, r, l) => e(u(t, r, l)), T = R(3, h), v = R(4, b), C = (e) => w("38;5;" + e, h), E = (e) => w("48;5;" + e, b);
+		2 === t ? (T = x(C), v = x(E)) : 1 === t && (T = $(0, h), v = $(10, b), C = (e) => w(d(e), h), E = (e) => w(d(e) + 10, b));
+		let M, I = {
+			fg: C,
+			bg: E,
+			rgb: T,
+			bgRgb: v,
+			hex: y(T),
+			bgHex: y(v),
+			visible: g,
+			reset: w(0, 0),
+			bold: w(1, 22),
+			dim: w(2, 22),
+			italic: w(3, 23),
+			underline: w(4, 24),
+			inverse: w(7, 27),
+			hidden: w(8, 28),
+			strikethrough: w(9, 29)
+		}, _ = (e) => "bg" + e[0].toUpperCase() + e.slice(1), k = "Bright";
+		return "black,red,green,yellow,blue,magenta,cyan,white,gray".split(",").map(((e, t) => {
+			M = _(e), 8 > t ? (I[e + k] = w(90 + t, h), I[M + k] = w(100 + t, b)) : t = 60, I[e] = w(30 + t, h), I[M] = w(40 + t, b);
+		})), s.extend(I);
+	}();
+	module.exports = w, w.default = w;
+})))(), 1);
+var ansis_default = import_ansis.default;
+const { Ansis, fg, bg, rgb, bgRgb, hex, bgHex, reset, inverse, hidden, visible, 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-internal-saIAfNVw.d.mts → context-DBd794Rn.d.mts}

@@ -1,6 +1,6 @@
-import { P as SharedState, d as DevToolsNodeContext } from "./devtool-CNvLs2_Y.mjs";
+import { H as SharedState, y as DevToolsNodeContext } from "./devframe-DulcIxwu.mjs";
 
-//#region src/node/context-internal.d.ts
+//#region src/node/internal/context.d.ts
 interface InternalAnonymousAuthStorage {
   trusted: Record<string, {
     authToken: string;

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

@@ -1,12 +1,12 @@
-import { o as RpcFunctionsCollectorBase } from "./rpc-INbWfHoX.mjs";
-import { s as diagnostics } from "./serialization-DwKi05Pn.mjs";
+import { o as RpcFunctionsCollectorBase } from "./rpc-CkZuoz-m.mjs";
+import { r as diagnostics } from "./serialization-CwO31axa.mjs";
 import { defineRpcFunction } from "./index.mjs";
-import { n as logger, t as diagnostics$1 } from "./diagnostics-DxPnRoXO.mjs";
+import { t as colors$1 } from "./colors-Bl4W18Mh.mjs";
+import { n as logger, t as diagnostics$1 } from "./diagnostics-BFhNNmST.mjs";
 import { createEventEmitter } from "./utils/events.mjs";
-import { createSharedState } from "./utils/shared-state.mjs";
+import { t as createSharedState } from "./shared-state-DCDs0e7y.mjs";
 import { createStreamReader, createStreamSink } from "./utils/streaming-channel.mjs";
 import { consoleReporter, createLogger, defineDiagnostics } from "logs-sdk";
-import c from "ansis";
 import { ansiFormatter } from "logs-sdk/formatters/ansi";
 import { isatty } from "node:tty";
 import { formatWithOptions, inspect } from "node:util";
@@ -14,13 +14,14 @@ import { existsSync } from "node:fs";
 //#region src/node/host-agent.ts
 /**
 * Framework-neutral host aggregating the agent-exposed surface of a
-* devtool. Auto-discovers RPC functions with an `agent` field from
+* devframe. Auto-discovers RPC functions with an `agent` field from
 * `ctx.rpc.definitions`, and accepts plugin-registered tools /
 * resources via `registerTool` / `registerResource`.
 *
 * @experimental
 */
 var DevToolsAgentHost = class {
+	context;
 	events = createEventEmitter();
 	tools = /* @__PURE__ */ new Map();
 	resources = /* @__PURE__ */ new Map();
@@ -185,6 +186,7 @@ function hasPositionalKeys(obj) {
 //#endregion
 //#region src/node/host-diagnostics.ts
 var DevToolsDiagnosticsHost = class {
+	context;
 	_definitions = [];
 	_logger;
 	defineDiagnostics = defineDiagnostics;
@@ -204,7 +206,7 @@ var DevToolsDiagnosticsHost = class {
 	_rebuild() {
 		this._logger = createLogger({
 			diagnostics: this._definitions,
-			formatter: ansiFormatter(c),
+			formatter: ansiFormatter(colors$1),
 			reporters: consoleReporter
 		});
 	}
@@ -921,6 +923,7 @@ var RpcFunctionsHost = class extends RpcFunctionsCollectorBase {
 //#endregion
 //#region src/node/host-views.ts
 var DevToolsViewHost = class {
+	context;
 	/**
 	* @internal
 	*/
@@ -998,10 +1001,10 @@ const BUILTIN_AGENT_RPC = [
 /**
 * Framework-neutral core of the DevTools node context. Wires the RPC
 * host, view (HTTP file-serving) host, diagnostics, and agent
-* subsystems plus the JSON-render factory. Hub-level subsystems
-* (`docks`, `terminals`, `messages`, `commands`) are owned by
+* subsystems. Hub-level subsystems (`docks`, `terminals`, `messages`,
+* `commands`, `createJsonRenderer`) are owned by
 * `@vitejs/devtools-kit` — its `createKitContext` wraps this and
-* attaches them when the devtool is mounted into a multi-integration
+* attaches them when the devframe is mounted into a multi-integration
 * hub.
 */
 async function createHostContext(options) {
@@ -1014,8 +1017,7 @@ async function createHostContext(options) {
 		rpc: void 0,
 		views: void 0,
 		diagnostics: void 0,
-		agent: void 0,
-		createJsonRenderer: void 0
+		agent: void 0
 	};
 	const rpcHost = new RpcFunctionsHost(context);
 	const viewsHost = new DevToolsViewHost(context);
@@ -1024,25 +1026,6 @@ async function createHostContext(options) {
 	context.views = viewsHost;
 	context.diagnostics = diagnosticsHost;
 	context.agent = new DevToolsAgentHost(context);
-	let jrCounter = 0;
-	context.createJsonRenderer = (initialSpec) => {
-		const stateKey = `devframe:json-render:${jrCounter++}`;
-		const statePromise = rpcHost.sharedState.get(stateKey, { initialValue: initialSpec });
-		return {
-			_stateKey: stateKey,
-			async updateSpec(spec) {
-				(await statePromise).mutate(() => spec);
-			},
-			async updateState(newState) {
-				(await statePromise).mutate((draft) => {
-					draft.state = {
-						...draft.state,
-						...newState
-					};
-				});
-			}
-		};
-	};
 	for (const fn of BUILTIN_AGENT_RPC) rpcHost.register(fn);
 	for (const fn of builtinRpcDeclarations) rpcHost.register(fn);
 	return context;

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

@@ -1,14 +1,15 @@
-import { t as createHostContext } from "./context-BJ4r2SmR.mjs";
-import { t as createH3DevToolsHost } from "./host-h3-9jeHcltx.mjs";
-import { t as startHttpAndWs } from "./server-CBsxXIH5.mjs";
+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-iZy45oG3.mjs";
-import { resolve } from "pathe";
+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 { networkInterfaces } from "node:os";
 import process$1 from "node:process";
-import { createApp, eventHandler, fromNodeMiddleware } from "h3";
+import { resolve } from "pathe";
+import { createApp, eventHandler } from "h3";
 import { createServer } from "node:net";
-import sirv from "sirv";
 //#region ../../../node_modules/.pnpm/get-port-please@3.2.0/node_modules/get-port-please/dist/index.mjs
 const unsafePorts = /* @__PURE__ */ new Set([
 	1,
@@ -245,9 +246,15 @@ async function resolveDevServerPort(def, options = {}) {
 	return getPort(portOptions);
 }
 /**
-* Start a devframe dev server for a {@link DevtoolDefinition} —
-* h3 + WebSocket RPC + the author's SPA mounted at the resolved base
-* path.
+* Start a devframe dev server for a {@link DevframeDefinition} —
+* h3 + WebSocket RPC + (optionally) the author's SPA mounted at the
+* resolved base path.
+*
+* When `distDir` is omitted (and `def.cli?.distDir` is unset) the
+* 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 })`.
 *
 * Returns the underlying {@link StartedServer} handle so callers can
 * close it gracefully (SIGINT, hot-reload, test teardown).
@@ -258,7 +265,6 @@ async function resolveDevServerPort(def, options = {}) {
 */
 async function createDevServer(def, options = {}) {
 	const distDir = options.distDir ?? def.cli?.distDir;
-	if (!distDir) throw new Error(`[devframe] createDevServer: no distDir for "${def.id}". Set \`cli.distDir\` on the definition or pass it as an option.`);
 	const host = options.host ?? def.cli?.host ?? "localhost";
 	const port = options.port ?? await resolveDevServerPort(def, { host });
 	const flags = options.flags ?? {};
@@ -268,10 +274,7 @@ async function createDevServer(def, options = {}) {
 		origin: `http://${host}:${port}`,
 		appName: def.id,
 		mount: (base, dir) => {
-			app.use(base, fromNodeMiddleware(sirv(dir, {
-				dev: true,
-				single: true
-			})));
+			app.use(base, serveStaticHandler(dir));
 		}
 	});
 	const ctx = await createHostContext({
@@ -289,10 +292,7 @@ async function createDevServer(def, options = {}) {
 			websocket: port
 		}));
 	}));
-	app.use(basePath, fromNodeMiddleware(sirv(resolve(distDir), {
-		dev: true,
-		single: true
-	})));
+	if (distDir) app.use(basePath, serveStaticHandler(resolve(distDir)));
 	return startHttpAndWs({
 		context: ctx,
 		host,
@@ -312,7 +312,6 @@ async function maybeOpenBrowser(def, flags, origin, override) {
 	if (resolved === void 0 || resolved === false) return;
 	const target = typeof resolved === "string" ? resolveOpenTarget(origin, resolved) : origin;
 	try {
-		const { default: open } = await import("./open-Dede_w9r.mjs");
 		await open(target);
 	} catch {}
 }

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

@@ -1,8 +1,7 @@
-import { g as RpcFunctionsCollectorBase } from "./index-CuLRIMto.mjs";
-import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-C7LnhOHi.mjs";
+import { f as RpcFunctionsCollectorBase } from "./index-DB2Ie0Or.mjs";
+import { t as DevToolsNodeRpcSessionMeta } from "./ws-server-DjvlwLuM.mjs";
 import { Logger, createLogger, defineDiagnostics } from "logs-sdk";
 import { BirpcReturn } from "birpc";
-import { Objectish, Patch, Patch as SharedStatePatch } from "immer";
 import { CAC } from "cac";
 import { GenericSchema, InferOutput } from "valibot";
 
@@ -25,7 +24,7 @@ type CliFlagsSchema = Record<string, GenericSchema>;
  *   config: v.optional(v.string()),
  * })
  *
- * defineDevtool({
+ * defineDevframe({
  *   cli: { flags: appFlags },
  *   setup(ctx, info) {
  *     const flags = info.flags as InferCliFlags<typeof appFlags>
@@ -387,35 +386,6 @@ interface DevToolsHost {
   getStorageDir: (scope: 'workspace' | 'global') => string;
 }
 //#endregion
-//#region src/types/json-render.d.ts
-interface JsonRenderElement {
-  type: string;
-  props?: Record<string, unknown>;
-  children?: string[];
-  /** json-render event bindings (e.g. `{ press: { action: "my:action" } }`) */
-  on?: Record<string, unknown>;
-  /** json-render visibility condition */
-  visible?: unknown;
-  /** json-render repeat binding */
-  repeat?: unknown;
-  /** Allow additional json-render element fields */
-  [key: string]: unknown;
-}
-interface JsonRenderSpec {
-  root: string;
-  elements: Record<string, JsonRenderElement>;
-  /** Initial client-side state model for $state/$bindState expressions */
-  state?: Record<string, unknown>;
-}
-interface JsonRenderer {
-  /** Replace the entire spec */
-  updateSpec: (spec: JsonRenderSpec) => void | Promise<void>;
-  /** Update json-render state values (shallow merge into spec.state) */
-  updateState: (state: Record<string, unknown>) => void | Promise<void>;
-  /** Internal: shared state key used by the client to subscribe */
-  readonly _stateKey: string;
-}
-//#endregion
 //#region src/types/rpc-augments.d.ts
 /**
  * To be extended
@@ -557,6 +527,15 @@ type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
 type ImmutableMap<K, V> = ReadonlyMap<Immutable<K>, Immutable<V>>;
 type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
 type ImmutableObject<T> = { readonly [K in keyof T]: Immutable<T[K]> };
+/**
+ * Serializable patch describing a single mutation to a `SharedState`.
+ * Structurally compatible with JSON-Patch and is safe to send over RPC.
+ */
+interface SharedStatePatch {
+  op: 'add' | 'remove' | 'replace';
+  path: readonly (string | number)[];
+  value?: unknown;
+}
 /**
  * State host that is immutable by default with explicit mutate.
  */
@@ -576,14 +555,14 @@ interface SharedState<T> {
   /**
    * Apply patches to the state.
    */
-  patch: (patches: Patch[], syncId?: string) => void;
+  patch: (patches: SharedStatePatch[], syncId?: string) => void;
   /**
    * Sync IDs that have been applied to the state.
    */
   syncIds: Set<string>;
 }
 interface SharedStateEvents<T> {
-  updated: (fullState: T, patches: Patch[] | undefined, syncId: string) => void;
+  updated: (fullState: T, patches: SharedStatePatch[] | undefined, syncId: string) => void;
 }
 interface SharedStateOptions<T> {
   /**
@@ -597,7 +576,7 @@ interface SharedStateOptions<T> {
    */
   enablePatches?: boolean;
 }
-declare function createSharedState<T extends Objectish>(options: SharedStateOptions<T>): SharedState<T>;
+declare function createSharedState<T extends object>(options: SharedStateOptions<T>): SharedState<T>;
 //#endregion
 //#region src/utils/streaming-channel.d.ts
 /**
@@ -929,10 +908,6 @@ interface DevToolsNodeContext {
    * @experimental
    */
   agent: DevToolsAgentHost;
-  /**
-   * Create a JsonRenderer handle for building json-render powered UIs.
-   */
-  createJsonRenderer: (spec: JsonRenderSpec) => JsonRenderer;
 }
 interface ConnectionMeta {
   backend: 'websocket' | 'static';
@@ -948,17 +923,17 @@ interface ConnectionMeta {
   jsonSerializableMethods?: string[];
 }
 //#endregion
-//#region src/types/devtool.d.ts
-type DevtoolRuntime = 'cli' | 'build' | 'spa' | 'vite' | 'kit' | 'embedded';
+//#region src/types/devframe.d.ts
+type DevframeRuntime = 'cli' | 'build' | 'spa' | 'vite' | 'kit' | 'embedded';
 /**
- * Classification of how a devtool is being deployed. Hosted adapters
+ * 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
  * (`cli`, `spa`, `build`) own the origin and default to `/`.
  */
-type DevtoolDeploymentKind = 'standalone' | 'hosted';
-interface DevtoolCliOptions {
-  /** Binary name; default: the devtool's `id`. */
+type DevframeDeploymentKind = 'standalone' | 'hosted';
+interface DevframeCliOptions {
+  /** Binary name; default: the devframe's `id`. */
   command?: string;
   /** Preferred port for the dev server (default 9999). */
   port?: number;
@@ -983,7 +958,7 @@ interface DevtoolCliOptions {
    * `devtools.clientAuth` today.
    */
   auth?: boolean;
-  /** Author's SPA dist directory (served as the devtool's UI). */
+  /** Author's SPA dist directory (served as the devframe's UI). */
   distDir?: string;
   /**
    * Capability-side CAC hook. Called with the CAC instance after the
@@ -1009,7 +984,7 @@ interface DevtoolCliOptions {
    *   config: v.optional(v.string()),
    * })
    *
-   * defineDevtool({
+   * defineDevframe({
    *   cli: { flags: appFlags },
    *   setup(ctx, info) {
    *     const flags = info.flags as InferCliFlags<typeof appFlags>
@@ -1019,7 +994,7 @@ interface DevtoolCliOptions {
    */
   flags?: CliFlagsSchema;
 }
-interface DevtoolSpaOptions {
+interface DevframeSpaOptions {
   base?: string;
   /**
    * How the deployed SPA loads its data.
@@ -1029,7 +1004,7 @@ interface DevtoolSpaOptions {
    */
   loader?: 'query' | 'upload' | 'none';
 }
-interface DevtoolBrowserContext {
+interface DevframeBrowserContext {
   /**
    * The connected RPC client (may be write-disabled in static/spa modes).
    */
@@ -1040,11 +1015,11 @@ interface DevtoolBrowserContext {
  * populate the fields that make sense for their deployment. In
  * particular, `createCli` fills `flags` with the parsed CAC bag.
  */
-interface DevtoolSetupInfo {
+interface DevframeSetupInfo {
   /** Parsed CLI flags, populated by the CLI adapter. */
   flags?: Record<string, unknown>;
 }
-interface DevtoolDefinition {
+interface DevframeDefinition {
   id: string;
   name: string;
   icon?: string | {
@@ -1064,12 +1039,28 @@ interface DevtoolDefinition {
     spa?: boolean | Record<string, boolean>;
   };
   /** Server-side setup — the primary entrypoint. Runs in every runtime. */
-  setup: (ctx: DevToolsNodeContext, info?: DevtoolSetupInfo) => void | Promise<void>;
+  setup: (ctx: DevToolsNodeContext, info?: DevframeSetupInfo) => void | Promise<void>;
   /** Browser-only setup for the SPA adapter (bundled into the client). */
-  setupBrowser?: (ctx: DevtoolBrowserContext) => void | Promise<void>;
-  cli?: DevtoolCliOptions;
-  spa?: DevtoolSpaOptions;
+  setupBrowser?: (ctx: DevframeBrowserContext) => void | Promise<void>;
+  cli?: DevframeCliOptions;
+  spa?: DevframeSpaOptions;
 }
-declare function defineDevtool(d: DevtoolDefinition): DevtoolDefinition;
+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 { AgentHandle 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, JsonRenderer as J, JsonRenderElement as K, SharedStatePatch as L, ImmutableObject as M, ImmutableSet as N, createStreamSink as O, SharedState as P, DevToolsDiagnosticsLogger as Q, createSharedState as R, CreateStreamSinkOptions as S, StreamSink as T, DevToolsRpcClientFunctions as U, PartialWithoutId as V, DevToolsRpcServerFunctions as W, DevToolsDiagnosticsDefinition as X, DevToolsHost as Y, DevToolsDiagnosticsHost as Z, RpcStreamingChannel as _, DevtoolRuntime as a, AgentToolInput as at, BufferedChunk as b, defineDevtool as c, EventEmitter as ct, DevToolsNodeContext as d, CliFlagsSchema as dt, AgentManifest as et, DevToolsNodeRpcSession as f, InferCliFlags as ft, RpcSharedStateHost as g, RpcSharedStateGetOptions as h, DevtoolDeploymentKind as i, AgentTool as it, ImmutableMap as j, Immutable as k, ConnectionMeta as l, EventUnsubscribe as lt, RpcFunctionsHost as m, parseCliFlags as mt, DevtoolCliOptions as n, AgentResourceContent as nt, DevtoolSetupInfo as o, DevToolsAgentHost as ot, RpcBroadcastOptions as p, defineCliFlags as pt, JsonRenderSpec as q, DevtoolDefinition as r, AgentResourceInput as rt, DevtoolSpaOptions as s, DevToolsAgentHostEvents as st, DevtoolBrowserContext as t, AgentResource as tt, DevToolsCapabilities as u, EventsMap as ut, RpcStreamingChannelOptions as v, StreamReader as w, CreateStreamReaderOptions as x, RpcStreamingHost as y, DevToolsViewHost as z };
+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 };

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

@@ -1,5 +1,5 @@
+import { t as colors } from "./colors-Bl4W18Mh.mjs";
 import { consoleReporter, createLogger, defineDiagnostics } from "logs-sdk";
-import c from "ansis";
 import { ansiFormatter } from "logs-sdk/formatters/ansi";
 //#region src/node/diagnostics.ts
 const diagnostics = defineDiagnostics({
@@ -39,12 +39,17 @@ const diagnostics = defineDiagnostics({
 		DF0032: {
 			message: (p) => `Streaming channel "${p.channel}" is already registered.`,
 			hint: "Each channel name must be unique within a context. Pick a different name or reuse the existing channel handle."
+		},
+		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`.",
+			level: "warn"
 		}
 	}
 });
 const logger = createLogger({
 	diagnostics: [diagnostics],
-	formatter: ansiFormatter(c),
+	formatter: ansiFormatter(colors),
 	reporters: consoleReporter
 });
 //#endregion