devframe 0.1.21 → 0.2.0

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-BJ4r2SmR.mjs → context-BBi2IQDm.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-DAzoVCR0.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-DS7k8ljB.mjs";
+import { n as logger, t as diagnostics$1 } from "./diagnostics-Cg9ycFIM.mjs";
 import { createEventEmitter } from "./utils/events.mjs";
-import { createSharedState } from "./utils/shared-state.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 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,13 +206,13 @@ var DevToolsDiagnosticsHost = class {
 	_rebuild() {
 		this._logger = createLogger({
 			diagnostics: this._definitions,
-			formatter: ansiFormatter(c),
+			formatter: ansiFormatter(colors$1),
 			reporters: consoleReporter
 		});
 	}
 };
 //#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;
@@ -323,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,
@@ -921,6 +923,7 @@ var RpcFunctionsHost = class extends RpcFunctionsCollectorBase {
 //#endregion
 //#region src/node/host-views.ts
 var DevToolsViewHost = class {
+	context;
 	/**
 	* @internal
 	*/
@@ -996,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 plus the JSON-render factory. Hub-level subsystems
-* (`docks`, `terminals`, `messages`, `commands`) are owned by
-* `@vitejs/devtools-kit` — its `createKitContext` wraps this and
-* attaches them when the devtool 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;
@@ -1014,8 +1016,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 +1025,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/{context-internal-saIAfNVw.d.mts → context-DRa0wGsC.d.mts}

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

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

@@ -1,15 +1,16 @@
-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-BBi2IQDm.mjs";
+import { t as createH3DevToolsHost } from "./host-h3-Dz8YnFgu.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-iZy45oG3.mjs";
-import { resolve } from "pathe";
+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 { createApp, eventHandler, fromNodeMiddleware } from "h3";
+import { resolve } from "pathe";
+import { H3 } 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
+//#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,
@@ -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
+* `viteDevBridge({ devMiddleware })`.
 *
 * Returns the underlying {@link StartedServer} handle so callers can
 * close it gracefully (SIGINT, hot-reload, test teardown).
@@ -258,20 +265,16 @@ 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 ?? {};
 	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, fromNodeMiddleware(sirv(dir, {
-				dev: true,
-				single: true
-			})));
+			mountStaticHandler(app, base, dir);
 		}
 	});
 	const ctx = await createHostContext({
@@ -282,17 +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
 	}));
-	app.use(basePath, fromNodeMiddleware(sirv(resolve(distDir), {
-		dev: true,
-		single: true
-	})));
+	if (distDir) mountStaticHandler(app, basePath, resolve(distDir));
 	return startHttpAndWs({
 		context: ctx,
 		host,
@@ -312,7 +309,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-R5Ex5K5L.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
 /**
@@ -887,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;
@@ -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' | 'embedded';
 /**
- * Classification of how a devtool 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
+ * Classification of how a devframe is being deployed. Hosted 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 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 | {
@@ -1055,7 +1030,7 @@ interface DevtoolDefinition {
   /**
    * Mount path override. Defaults depend on the adapter:
    * `/` for standalone (`cli` / `spa` / `build`), `/__<id>/` for hosted
-   * (`vite` / `kit` / `embedded`).
+   * (`vite` / `embedded`).
    */
   basePath?: string;
   capabilities?: {
@@ -1064,12 +1039,12 @@ 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;
 //#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 { 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-DxPnRoXO.mjs → diagnostics-Cg9ycFIM.mjs}

@@ -1,5 +1,5 @@
+import { t as colors } from "./colors-DS7k8ljB.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 `viteDevBridge`.",
+			level: "warn"
 		}
 	}
 });
 const logger = createLogger({
 	diagnostics: [diagnostics],
-	formatter: ansiFormatter(c),
+	formatter: ansiFormatter(colors),
 	reporters: consoleReporter
 });
 //#endregion