@devframes/hub 0.6.0 → 0.6.2

package/dist/client/index.d.mts

@@ -1,5 +1,5 @@
-import { b as DevframeMessagesClient, h as DevframeMessageEntryInput } from "../context-CXN9eDXS.mjs";
-import { h as DevframeDockEntry, i as DevframeCommandEntry, k as RemoteConnectionInfo, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, t as DevframeDocksUserSettings, y as DevframeDockUserEntry } from "../settings-DJs3n2p1.mjs";
+import { S as DevframeMessagesClient, _ as DevframeMessageEntryInput } from "../context-BVliVH77.mjs";
+import { O as RemoteConnectionInfo, i as DevframeCommandEntry, m as DevframeDockEntry, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockEntriesGrouped, t as DevframeDocksUserSettings, v as DevframeDockUserEntry } from "../settings-ZM591NEp.mjs";
 import { DevframeClientRpcHost, DevframeRpcClient, DevframeRpcClientOptions, DevframeRpcContext, RpcClientEvents } from "devframe/client";
 import { EventEmitter } from "devframe/types";
 import { SharedState } from "devframe/utils/shared-state";

package/dist/constants.d.mts

@@ -1,4 +1,4 @@
-import { t as DevframeDocksUserSettings } from "./settings-DJs3n2p1.mjs";
+import { t as DevframeDocksUserSettings } from "./settings-ZM591NEp.mjs";
 export * from "devframe/constants";
 
 //#region src/constants.d.ts

package/dist/{context-CXN9eDXS.d.mts → context-BVliVH77.d.mts}

@@ -1,4 +1,4 @@
-import { M as JsonRenderSpec, N as JsonRenderer, b as DevframeDocksHost, c as DevframeCommandsHost, f as BuiltinDocksOptions, v as DevframeDockEntryIcon } from "./settings-DJs3n2p1.mjs";
+import { M as JsonRenderer, _ as DevframeDockEntryIcon, c as DevframeCommandsHost, j as JsonRenderSpec, y as DevframeDocksHost } from "./settings-ZM591NEp.mjs";
 import { CreateHostContextOptions } from "devframe/node";
 import { DevframeHost, DevframeNodeContext, EventEmitter } from "devframe/types";
 import { ChildProcess } from "node:child_process";
@@ -245,10 +245,42 @@ interface DevframeChildProcessExecuteOptions {
   cwd?: string;
   env?: Record<string, string>;
 }
+/**
+ * The settled outcome of a {@link DevframeChildProcessTerminalSession} run —
+ * stdout/stderr captured separately (unlike the session's merged display
+ * `stream`), plus the process's exit code (`undefined` if it was killed by a
+ * signal before exiting).
+ */
+interface DevframeChildProcessOutput {
+  stdout: string;
+  stderr: string;
+  exitCode: number | undefined;
+}
+/**
+ * A live handle on a child process's outcome — mirrors the ergonomics of
+ * `tinyexec`'s `Result` (a promise-like paired with synchronous accessors) so
+ * callers migrating from a `tinyexec`/`execa`-based subprocess API (e.g.
+ * Nuxt DevTools' `startSubprocess().getResult()`) can adopt
+ * {@link DevframeTerminalsHost.startChildProcess} with minimal changes.
+ * `await`ing it (or calling `.then()`) resolves once the process exits, with
+ * the full captured {@link DevframeChildProcessOutput}.
+ */
+interface DevframeChildProcessResult extends PromiseLike<DevframeChildProcessOutput> {
+  readonly pid: number | undefined;
+  /** `undefined` while the process is still running. */
+  readonly exitCode: number | undefined;
+  readonly killed: boolean;
+  kill: (signal?: NodeJS.Signals | number) => boolean;
+}
 interface DevframeChildProcessTerminalSession extends DevframeTerminalSession {
   type: 'child-process';
   executeOptions: DevframeChildProcessExecuteOptions;
   getChildProcess: () => ChildProcess | undefined;
+  /**
+   * Get a live handle on the current run's outcome. Reflects the most recent
+   * `restart()` — call it again after restarting to track the new run.
+   */
+  getResult: () => DevframeChildProcessResult;
   terminate: () => Promise<void>;
   restart: () => Promise<void>;
 }
@@ -319,19 +351,12 @@ interface DevframeHubContext extends DevframeNodeContext {
    */
   createJsonRenderer: (spec: JsonRenderSpec) => JsonRenderer;
 }
-interface CreateHubContextOptions extends CreateHostContextOptions {
-  /**
-   * Gate the hub's synthesized built-in dock entries (`~terminals`,
-   * `~messages`, `~settings`). Each entry defaults to present; set one to
-   * `false` to suppress it — e.g. when mounting `@devframes/plugin-terminals`
-   * or `@devframes/plugin-messages`, which replace the built-in tabs.
-   *
-   * Omitting this option keeps all three built-ins.
-   *
-   * @default { terminals: true, messages: true, settings: true }
-   */
-  builtinDocks?: BuiltinDocksOptions;
-}
+/**
+ * Options for {@link createHubContext} — devframe's
+ * {@link CreateHostContextOptions} plus any hub-level additions kits layer on
+ * through declaration merging.
+ */
+interface CreateHubContextOptions extends CreateHostContextOptions {}
 /**
  * Create a hub-level node context: wraps devframe's `createHostContext`,
  * attaches the hub hosts (`docks`, `terminals`, `messages`, `commands`),
@@ -340,4 +365,4 @@ interface CreateHubContextOptions extends CreateHostContextOptions {
  */
 declare function createHubContext(options: CreateHubContextOptions): Promise<DevframeHubContext>;
 //#endregion
-export { DevframeMessagesListDelta as C, DevframeMessagesLevelShortcuts as S, DevframeMessageHandle as _, DevframeChildProcessTerminalSession as a, DevframeMessagesClient as b, DevframeTerminalSession as c, DevframeTerminalsHost as d, DevframeMessageElementPosition as f, DevframeMessageFilePosition as g, DevframeMessageEntryInput as h, DevframeChildProcessExecuteOptions as i, DevframeTerminalSessionBase as l, DevframeMessageEntryFrom as m, DevframeHubContext as n, DevframePtyExecuteOptions as o, DevframeMessageEntry as p, createHubContext as r, DevframePtyTerminalSession as s, CreateHubContextOptions as t, DevframeTerminalStatus as u, DevframeMessageLevel as v, DevframeMessagesHost as x, DevframeMessageShortcutInput as y };
+export { DevframeMessagesHost as C, DevframeMessagesClient as S, DevframeMessagesListDelta as T, DevframeMessageEntryInput as _, DevframeChildProcessOutput as a, DevframeMessageLevel as b, DevframePtyExecuteOptions as c, DevframeTerminalSessionBase as d, DevframeTerminalStatus as f, DevframeMessageEntryFrom as g, DevframeMessageEntry as h, DevframeChildProcessExecuteOptions as i, DevframePtyTerminalSession as l, DevframeMessageElementPosition as m, DevframeHubContext as n, DevframeChildProcessResult as o, DevframeTerminalsHost as p, createHubContext as r, DevframeChildProcessTerminalSession as s, CreateHubContextOptions as t, DevframeTerminalSession as u, DevframeMessageFilePosition as v, DevframeMessagesLevelShortcuts as w, DevframeMessageShortcutInput as x, DevframeMessageHandle as y };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as DevframeMessagesListDelta, S as DevframeMessagesLevelShortcuts, _ as DevframeMessageHandle, a as DevframeChildProcessTerminalSession, b as DevframeMessagesClient, c as DevframeTerminalSession, d as DevframeTerminalsHost, f as DevframeMessageElementPosition, g as DevframeMessageFilePosition, h as DevframeMessageEntryInput, i as DevframeChildProcessExecuteOptions, l as DevframeTerminalSessionBase, m as DevframeMessageEntryFrom, n as DevframeHubContext, o as DevframePtyExecuteOptions, p as DevframeMessageEntry, s as DevframePtyTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalStatus, v as DevframeMessageLevel, x as DevframeMessagesHost, y as DevframeMessageShortcutInput } from "./context-CXN9eDXS.mjs";
-import { A as RemoteDockOptions, C as DevframeViewCustomRender, D as DevframeViewLauncher, E as DevframeViewJsonRender, M as JsonRenderSpec, N as JsonRenderer, O as DevframeViewLauncherStatus, S as DevframeViewBuiltin, T as DevframeViewIframe, _ as DevframeDockEntryCategory, a as DevframeCommandHandle, b as DevframeDocksHost, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as BuiltinDocksOptions, g as DevframeDockEntryBase, h as DevframeDockEntry, i as DevframeCommandEntry, j as JsonRenderElement, k as RemoteConnectionInfo, l as DevframeCommandsHostEvents, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as ClientScriptEntry, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockEntryIcon, w as DevframeViewGroup, x as DevframeViewAction, y as DevframeDockUserEntry } from "./settings-DJs3n2p1.mjs";
+import { C as DevframeMessagesHost, S as DevframeMessagesClient, T as DevframeMessagesListDelta, _ as DevframeMessageEntryInput, a as DevframeChildProcessOutput, b as DevframeMessageLevel, c as DevframePtyExecuteOptions, d as DevframeTerminalSessionBase, f as DevframeTerminalStatus, g as DevframeMessageEntryFrom, h as DevframeMessageEntry, i as DevframeChildProcessExecuteOptions, l as DevframePtyTerminalSession, m as DevframeMessageElementPosition, n as DevframeHubContext, o as DevframeChildProcessResult, p as DevframeTerminalsHost, s as DevframeChildProcessTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalSession, v as DevframeMessageFilePosition, w as DevframeMessagesLevelShortcuts, x as DevframeMessageShortcutInput, y as DevframeMessageHandle } from "./context-BVliVH77.mjs";
+import { A as JsonRenderElement, C as DevframeViewGroup, D as DevframeViewLauncherStatus, E as DevframeViewLauncher, M as JsonRenderer, O as RemoteConnectionInfo, S as DevframeViewCustomRender, T as DevframeViewJsonRender, _ as DevframeDockEntryIcon, a as DevframeCommandHandle, b as DevframeViewAction, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as ClientScriptEntry, g as DevframeDockEntryCategory, h as DevframeDockEntryBase, i as DevframeCommandEntry, j as JsonRenderSpec, k as RemoteDockOptions, l as DevframeCommandsHostEvents, m as DevframeDockEntry, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockEntriesGrouped, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockUserEntry, w as DevframeViewIframe, x as DevframeViewBuiltin, y as DevframeDocksHost } from "./settings-ZM591NEp.mjs";
 import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "./index-Dic9q4eN.mjs";
 import { WhenContext, WhenExpression } from "devframe/utils/when";
 
@@ -13,4 +13,4 @@ declare function defineDockEntry<const T extends DevframeDockUserEntry, const W
 }): T;
 declare function defineJsonRenderSpec(spec: JsonRenderSpec): JsonRenderSpec;
 //#endregion
-export { type BuiltinDocksOptions, type ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, type DevframeChildProcessExecuteOptions, type DevframeChildProcessTerminalSession, type DevframeClientCommand, type DevframeCommandBase, type DevframeCommandEntry, type DevframeCommandHandle, type DevframeCommandKeybinding, type DevframeCommandShortcutOverrides, type DevframeCommandsHost, type DevframeCommandsHostEvents, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockEntriesGrouped, type DevframeDockEntry, type DevframeDockEntryBase, type DevframeDockEntryCategory, type DevframeDockEntryIcon, type DevframeDockUserEntry, type DevframeDocksHost, type DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, type DevframeMessageElementPosition, type DevframeMessageEntry, type DevframeMessageEntryFrom, type DevframeMessageEntryInput, type DevframeMessageFilePosition, type DevframeMessageHandle, type DevframeMessageLevel, type DevframeMessageShortcutInput, type DevframeMessagesClient, type DevframeMessagesHost, type DevframeMessagesLevelShortcuts, type DevframeMessagesListDelta, type DevframeNodeRpcSession, type DevframePtyExecuteOptions, type DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeServerCommandEntry, type DevframeServerCommandInput, type DevframeTerminalSession, type DevframeTerminalSessionBase, type DevframeTerminalStatus, type DevframeTerminalsHost, type DevframeViewAction, type DevframeViewBuiltin, type DevframeViewCustomRender, type DevframeViewGroup, type DevframeViewHost, type DevframeViewIframe, type DevframeViewJsonRender, type DevframeViewLauncher, type DevframeViewLauncherStatus, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, type JsonRenderElement, type JsonRenderSpec, type JsonRenderer, type PartialWithoutId, type RemoteConnectionInfo, type RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type Thenable, defineCommand, defineDockEntry, defineHubRpcFunction, defineJsonRenderSpec };
+export { type ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, type DevframeChildProcessExecuteOptions, type DevframeChildProcessOutput, type DevframeChildProcessResult, type DevframeChildProcessTerminalSession, type DevframeClientCommand, type DevframeCommandBase, type DevframeCommandEntry, type DevframeCommandHandle, type DevframeCommandKeybinding, type DevframeCommandShortcutOverrides, type DevframeCommandsHost, type DevframeCommandsHostEvents, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockEntriesGrouped, type DevframeDockEntry, type DevframeDockEntryBase, type DevframeDockEntryCategory, type DevframeDockEntryIcon, type DevframeDockUserEntry, type DevframeDocksHost, type DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, type DevframeMessageElementPosition, type DevframeMessageEntry, type DevframeMessageEntryFrom, type DevframeMessageEntryInput, type DevframeMessageFilePosition, type DevframeMessageHandle, type DevframeMessageLevel, type DevframeMessageShortcutInput, type DevframeMessagesClient, type DevframeMessagesHost, type DevframeMessagesLevelShortcuts, type DevframeMessagesListDelta, type DevframeNodeRpcSession, type DevframePtyExecuteOptions, type DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeServerCommandEntry, type DevframeServerCommandInput, type DevframeTerminalSession, type DevframeTerminalSessionBase, type DevframeTerminalStatus, type DevframeTerminalsHost, type DevframeViewAction, type DevframeViewBuiltin, type DevframeViewCustomRender, type DevframeViewGroup, type DevframeViewHost, type DevframeViewIframe, type DevframeViewJsonRender, type DevframeViewLauncher, type DevframeViewLauncherStatus, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, type JsonRenderElement, type JsonRenderSpec, type JsonRenderer, type PartialWithoutId, type RemoteConnectionInfo, type RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type Thenable, defineCommand, defineDockEntry, defineHubRpcFunction, defineJsonRenderSpec };

package/dist/node/index.d.mts

@@ -1,5 +1,5 @@
-import { C as DevframeMessagesListDelta, _ as DevframeMessageHandle, a as DevframeChildProcessTerminalSession, c as DevframeTerminalSession, d as DevframeTerminalsHost$1, h as DevframeMessageEntryInput, i as DevframeChildProcessExecuteOptions, l as DevframeTerminalSessionBase, n as DevframeHubContext, o as DevframePtyExecuteOptions, p as DevframeMessageEntry, r as createHubContext, s as DevframePtyTerminalSession, t as CreateHubContextOptions, x as DevframeMessagesHost$1, y as DevframeMessageShortcutInput } from "../context-CXN9eDXS.mjs";
-import { T as DevframeViewIframe, a as DevframeCommandHandle, b as DevframeDocksHost$1, c as DevframeCommandsHost$1, d as DevframeServerCommandInput, f as BuiltinDocksOptions, h as DevframeDockEntry, p as ClientScriptEntry, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, y as DevframeDockUserEntry } from "../settings-DJs3n2p1.mjs";
+import { C as DevframeMessagesHost$1, T as DevframeMessagesListDelta, _ as DevframeMessageEntryInput, c as DevframePtyExecuteOptions, d as DevframeTerminalSessionBase, h as DevframeMessageEntry, i as DevframeChildProcessExecuteOptions, l as DevframePtyTerminalSession, n as DevframeHubContext, p as DevframeTerminalsHost$1, r as createHubContext, s as DevframeChildProcessTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalSession, x as DevframeMessageShortcutInput, y as DevframeMessageHandle } from "../context-BVliVH77.mjs";
+import { a as DevframeCommandHandle, c as DevframeCommandsHost$1, d as DevframeServerCommandInput, f as ClientScriptEntry, m as DevframeDockEntry, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockUserEntry, w as DevframeViewIframe, y as DevframeDocksHost$1 } from "../settings-ZM591NEp.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { DevframeDefinition } from "devframe/types";
 import { SharedState } from "devframe/utils/shared-state";
@@ -21,37 +21,26 @@ declare class DevframeCommandsHost implements DevframeCommandsHost$1 {
 //#region src/node/host-docks.d.ts
 declare class DevframeDocksHost implements DevframeDocksHost$1 {
   readonly context: DevframeHubContext;
-  /**
-   * Per-entry toggles for the synthesized built-in dock entries. An omitted
-   * (or `undefined`) flag keeps that built-in; only an explicit `false`
-   * suppresses it.
-   */
-  private readonly builtinDocks;
   readonly views: DevframeDocksHost$1['views'];
   readonly events: DevframeDocksHost$1['events'];
   userSettings: SharedState<DevframeDocksUserSettings>;
   /** Dock-id → allocated remote token + resolved options. */
   private readonly remoteDocks;
-  constructor(context: DevframeHubContext,
-  /**
-   * Per-entry toggles for the synthesized built-in dock entries. An omitted
-   * (or `undefined`) flag keeps that built-in; only an explicit `false`
-   * suppresses it.
-   */
-
-  builtinDocks?: BuiltinDocksOptions);
+  constructor(context: DevframeHubContext);
   init(): Promise<void>;
-  values({
-    includeBuiltin
-  }?: {
-    includeBuiltin?: boolean;
-  }): DevframeDockEntry[];
+  values(): DevframeDockEntry[];
   private projectView;
   private resolveDevServerOrigin;
   register<T extends DevframeDockUserEntry>(view: T, force?: boolean): {
     update: (patch: Partial<T>) => void;
   };
   update(view: DevframeDockUserEntry): void;
+  /**
+   * `~builtin` views default their category to `~builtin` so the viewer's
+   * native views group together and sort last — a high-level integration
+   * registering one needn't repeat the category.
+   */
+  private withBuiltinCategory;
   private validateGroupMembership;
   private prepareRemoteRegistration;
 }

package/dist/node/index.mjs

@@ -207,15 +207,13 @@ function buildRemoteUrl(baseUrl, payload, transport) {
 }
 var DevframeDocksHost = class {
 	context;
-	builtinDocks;
 	views = /* @__PURE__ */ new Map();
 	events = createEventEmitter();
 	userSettings = void 0;
 	/** Dock-id → allocated remote token + resolved options. */
 	remoteDocks = /* @__PURE__ */ new Map();
-	constructor(context, builtinDocks = {}) {
+	constructor(context) {
 		this.context = context;
-		this.builtinDocks = builtinDocks;
 	}
 	async init() {
 		this.userSettings = await this.context.rpc.sharedState.get("devframe:user-settings", { sharedState: createStorage({
@@ -223,39 +221,8 @@ var DevframeDocksHost = class {
 			initialValue: DEFAULT_STATE_USER_SETTINGS()
 		}) });
 	}
-	values({ includeBuiltin = true } = {}) {
-		const context = this.context;
-		const { terminals = true, messages = true, settings = true } = this.builtinDocks;
-		const builtinDocksEntries = [];
-		if (terminals) builtinDocksEntries.push({
-			type: "~builtin",
-			id: "~terminals",
-			title: "Terminals",
-			icon: "ph:terminal-duotone",
-			category: "~builtin",
-			get when() {
-				return context.terminals.sessions.size === 0 ? "false" : void 0;
-			}
-		});
-		if (messages) builtinDocksEntries.push({
-			type: "~builtin",
-			id: "~messages",
-			title: "Messages & Notifications",
-			icon: "ph:notification-duotone",
-			category: "~builtin",
-			get badge() {
-				const size = context.messages.entries.size;
-				return size > 0 ? String(size) : void 0;
-			}
-		});
-		if (settings) builtinDocksEntries.push({
-			type: "~builtin",
-			id: "~settings",
-			title: "Settings",
-			category: "~builtin",
-			icon: "ph:gear-duotone"
-		});
-		return [...Array.from(this.views.values(), (view) => this.projectView(view)), ...includeBuiltin ? builtinDocksEntries : []];
+	values() {
+		return Array.from(this.views.values(), (view) => this.projectView(view));
 	}
 	projectView(view) {
 		if (view.type !== "iframe" || !view.remote) return view;
@@ -281,8 +248,9 @@ var DevframeDocksHost = class {
 		if (this.views.has(view.id) && !force) throw diagnostics.DF8100({ id: view.id });
 		this.validateGroupMembership(view);
 		this.prepareRemoteRegistration(view);
-		this.views.set(view.id, view);
-		this.events.emit("dock:entry:updated", view);
+		const entry = this.withBuiltinCategory(view);
+		this.views.set(entry.id, entry);
+		this.events.emit("dock:entry:updated", entry);
 		return { update: (patch) => {
 			if (patch.id && patch.id !== view.id) throw diagnostics.DF8101({
 				id: view.id,
@@ -295,8 +263,21 @@ var DevframeDocksHost = class {
 		if (!this.views.has(view.id)) throw diagnostics.DF8102({ id: view.id });
 		this.validateGroupMembership(view);
 		this.prepareRemoteRegistration(view);
-		this.views.set(view.id, view);
-		this.events.emit("dock:entry:updated", view);
+		const entry = this.withBuiltinCategory(view);
+		this.views.set(entry.id, entry);
+		this.events.emit("dock:entry:updated", entry);
+	}
+	/**
+	* `~builtin` views default their category to `~builtin` so the viewer's
+	* native views group together and sort last — a high-level integration
+	* registering one needn't repeat the category.
+	*/
+	withBuiltinCategory(view) {
+		if (view.type === "~builtin" && view.category === void 0) return {
+			...view,
+			category: "~builtin"
+		};
+		return view;
 	}
 	validateGroupMembership(view) {
 		if (view.groupId === void 0) return;
@@ -594,6 +575,7 @@ var DevframeTerminalsHost = class {
 		const { exec } = await import("tinyexec");
 		let controller;
 		let cp;
+		let currentResult;
 		let runId = 0;
 		let streamClosed = false;
 		const closeStream = () => {
@@ -631,17 +613,56 @@ var DevframeTerminalsHost = class {
 				cwd: executeOptions.cwd ?? process$1.cwd(),
 				stdio: "pipe"
 			} });
-			(async () => {
-				try {
-					for await (const chunk of cp) {
-						if (streamClosed || currentRun !== runId) return;
-						controller?.enqueue(chunk);
-					}
-					if (currentRun === runId) closeStream();
-				} catch (error) {
-					if (currentRun === runId) errorStream(error);
-				}
-			})();
+			const stdoutChunks = [];
+			const stderrChunks = [];
+			let settled = false;
+			let resolveOutput;
+			const outputPromise = new Promise((resolve) => {
+				resolveOutput = resolve;
+			});
+			const settle = (exitCode) => {
+				if (settled || currentRun !== runId) return;
+				settled = true;
+				resolveOutput({
+					stdout: stdoutChunks.join(""),
+					stderr: stderrChunks.join(""),
+					exitCode
+				});
+			};
+			cp.process?.stdout?.on("data", (chunk) => {
+				if (currentRun !== runId) return;
+				const text = chunk.toString();
+				stdoutChunks.push(text);
+				if (!streamClosed) controller?.enqueue(text);
+			});
+			cp.process?.stderr?.on("data", (chunk) => {
+				if (currentRun !== runId) return;
+				const text = chunk.toString();
+				stderrChunks.push(text);
+				if (!streamClosed) controller?.enqueue(text);
+			});
+			cp.process?.once("error", (error) => {
+				if (currentRun !== runId) return;
+				settle(cp.process?.exitCode ?? void 0);
+				errorStream(error);
+			});
+			cp.process?.once("close", (code) => {
+				settle(code ?? void 0);
+				if (currentRun === runId) closeStream();
+			});
+			currentResult = {
+				get pid() {
+					return cp.process?.pid;
+				},
+				get exitCode() {
+					return cp.process?.exitCode ?? void 0;
+				},
+				get killed() {
+					return cp.process?.killed === true;
+				},
+				kill: (signal) => cp.kill(signal),
+				then: (onfulfilled, onrejected) => outputPromise.then(onfulfilled, onrejected)
+			};
 			return cp;
 		}
 		cp = createChildProcess();
@@ -662,6 +683,7 @@ var DevframeTerminalsHost = class {
 			type: "child-process",
 			executeOptions,
 			getChildProcess: () => cp?.process,
+			getResult: () => currentResult,
 			terminate,
 			restart
 		};
@@ -893,7 +915,7 @@ async function createHubContext(options) {
 		...options,
 		builtinRpcDeclarations: [...builtinHubRpcDeclarations, ...options.builtinRpcDeclarations ?? []]
 	});
-	const docks = new DevframeDocksHost(context, options.builtinDocks);
+	const docks = new DevframeDocksHost(context);
 	const terminals = new DevframeTerminalsHost(context);
 	const messages = new DevframeMessagesHost(context);
 	const commands = new DevframeCommandsHost(context);

package/dist/{settings-DJs3n2p1.d.mts → settings-ZM591NEp.d.mts}

@@ -39,34 +39,7 @@ interface DevframeDocksHost {
     update: (patch: Partial<T>) => void;
   };
   update: (entry: DevframeDockUserEntry) => void;
-  values: (options?: {
-    includeBuiltin?: boolean;
-  }) => DevframeDockEntry[];
-}
-/**
- * Per-entry toggles for the hub's synthesized built-in dock entries.
- *
- * Each flag defaults to `true` (the entry is present). Set one to `false` to
- * suppress that built-in everywhere it would otherwise appear — useful when a
- * host mounts a plugin that supersedes the built-in tab (e.g.
- * `@devframes/plugin-terminals` replacing the `~terminals` entry).
- */
-interface BuiltinDocksOptions {
-  /**
-   * Include the built-in `~terminals` dock entry.
-   * @default true
-   */
-  terminals?: boolean;
-  /**
-   * Include the built-in `~messages` dock entry.
-   * @default true
-   */
-  messages?: boolean;
-  /**
-   * Include the built-in `~settings` dock entry.
-   * @default true
-   */
-  settings?: boolean;
+  values: () => DevframeDockEntry[];
 }
 type DevframeDockEntryCategory = 'app' | 'framework' | 'web' | 'advanced' | 'default' | '~builtin' | (string & {});
 type DevframeDockEntryIcon = string | {
@@ -207,6 +180,16 @@ interface DevframeViewCustomRender extends DevframeDockEntryBase {
   type: 'custom-render';
   renderer: ClientScriptEntry;
 }
+/**
+ * A view rendered natively by the viewer rather than by a plugin — the
+ * settings panel, the terminals feed, the messages feed, etc. A high-level
+ * integration registers the built-in views it wants; the viewer recognizes the
+ * reserved `id` and renders its own UI for it.
+ *
+ * Its {@link DevframeDockEntryBase.category} defaults to `'~builtin'` when
+ * omitted, so built-in views group together and sort last without every
+ * integration repeating it.
+ */
 interface DevframeViewBuiltin extends DevframeDockEntryBase {
   type: '~builtin';
   id: '~terminals' | '~messages' | '~client-auth-notice' | '~settings' | '~popup';
@@ -237,8 +220,8 @@ interface DevframeViewGroup extends DevframeDockEntryBase {
    */
   defaultChildId?: string;
 }
-type DevframeDockUserEntry = DevframeViewIframe | DevframeViewAction | DevframeViewCustomRender | DevframeViewLauncher | DevframeViewJsonRender | DevframeViewGroup;
-type DevframeDockEntry = DevframeDockUserEntry | DevframeViewBuiltin;
+type DevframeDockUserEntry = DevframeViewIframe | DevframeViewAction | DevframeViewCustomRender | DevframeViewLauncher | DevframeViewJsonRender | DevframeViewGroup | DevframeViewBuiltin;
+type DevframeDockEntry = DevframeDockUserEntry;
 type DevframeDockEntriesGrouped = [category: string, entries: DevframeDockEntry[]][];
 //#endregion
 //#region src/types/commands.d.ts
@@ -370,4 +353,4 @@ interface DevframeDocksUserSettings {
   commandShortcuts: DevframeCommandShortcutOverrides;
 }
 //#endregion
-export { RemoteDockOptions as A, DevframeViewCustomRender as C, DevframeViewLauncher as D, DevframeViewJsonRender as E, JsonRenderSpec as M, JsonRenderer as N, DevframeViewLauncherStatus as O, DevframeViewBuiltin as S, DevframeViewIframe as T, DevframeDockEntryCategory as _, DevframeCommandHandle as a, DevframeDocksHost as b, DevframeCommandsHost as c, DevframeServerCommandInput as d, BuiltinDocksOptions as f, DevframeDockEntryBase as g, DevframeDockEntry as h, DevframeCommandEntry as i, JsonRenderElement as j, RemoteConnectionInfo as k, DevframeCommandsHostEvents as l, DevframeDockEntriesGrouped as m, DevframeClientCommand as n, DevframeCommandKeybinding as o, ClientScriptEntry as p, DevframeCommandBase as r, DevframeCommandShortcutOverrides as s, DevframeDocksUserSettings as t, DevframeServerCommandEntry as u, DevframeDockEntryIcon as v, DevframeViewGroup as w, DevframeViewAction as x, DevframeDockUserEntry as y };
+export { JsonRenderElement as A, DevframeViewGroup as C, DevframeViewLauncherStatus as D, DevframeViewLauncher as E, JsonRenderer as M, RemoteConnectionInfo as O, DevframeViewCustomRender as S, DevframeViewJsonRender as T, DevframeDockEntryIcon as _, DevframeCommandHandle as a, DevframeViewAction as b, DevframeCommandsHost as c, DevframeServerCommandInput as d, ClientScriptEntry as f, DevframeDockEntryCategory as g, DevframeDockEntryBase as h, DevframeCommandEntry as i, JsonRenderSpec as j, RemoteDockOptions as k, DevframeCommandsHostEvents as l, DevframeDockEntry as m, DevframeClientCommand as n, DevframeCommandKeybinding as o, DevframeDockEntriesGrouped as p, DevframeCommandBase as r, DevframeCommandShortcutOverrides as s, DevframeDocksUserSettings as t, DevframeServerCommandEntry as u, DevframeDockUserEntry as v, DevframeViewIframe as w, DevframeViewBuiltin as x, DevframeDocksHost as y };

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-import { C as DevframeMessagesListDelta, S as DevframeMessagesLevelShortcuts, _ as DevframeMessageHandle, a as DevframeChildProcessTerminalSession, b as DevframeMessagesClient, c as DevframeTerminalSession, d as DevframeTerminalsHost, f as DevframeMessageElementPosition, g as DevframeMessageFilePosition, h as DevframeMessageEntryInput, i as DevframeChildProcessExecuteOptions, l as DevframeTerminalSessionBase, m as DevframeMessageEntryFrom, n as DevframeHubContext, o as DevframePtyExecuteOptions, p as DevframeMessageEntry, s as DevframePtyTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalStatus, v as DevframeMessageLevel, x as DevframeMessagesHost, y as DevframeMessageShortcutInput } from "../context-CXN9eDXS.mjs";
-import { A as RemoteDockOptions, C as DevframeViewCustomRender, D as DevframeViewLauncher, E as DevframeViewJsonRender, M as JsonRenderSpec, N as JsonRenderer, O as DevframeViewLauncherStatus, S as DevframeViewBuiltin, T as DevframeViewIframe, _ as DevframeDockEntryCategory, a as DevframeCommandHandle, b as DevframeDocksHost, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as BuiltinDocksOptions, g as DevframeDockEntryBase, h as DevframeDockEntry, i as DevframeCommandEntry, j as JsonRenderElement, k as RemoteConnectionInfo, l as DevframeCommandsHostEvents, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as ClientScriptEntry, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockEntryIcon, w as DevframeViewGroup, x as DevframeViewAction, y as DevframeDockUserEntry } from "../settings-DJs3n2p1.mjs";
+import { C as DevframeMessagesHost, S as DevframeMessagesClient, T as DevframeMessagesListDelta, _ as DevframeMessageEntryInput, a as DevframeChildProcessOutput, b as DevframeMessageLevel, c as DevframePtyExecuteOptions, d as DevframeTerminalSessionBase, f as DevframeTerminalStatus, g as DevframeMessageEntryFrom, h as DevframeMessageEntry, i as DevframeChildProcessExecuteOptions, l as DevframePtyTerminalSession, m as DevframeMessageElementPosition, n as DevframeHubContext, o as DevframeChildProcessResult, p as DevframeTerminalsHost, s as DevframeChildProcessTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalSession, v as DevframeMessageFilePosition, w as DevframeMessagesLevelShortcuts, x as DevframeMessageShortcutInput, y as DevframeMessageHandle } from "../context-BVliVH77.mjs";
+import { A as JsonRenderElement, C as DevframeViewGroup, D as DevframeViewLauncherStatus, E as DevframeViewLauncher, M as JsonRenderer, O as RemoteConnectionInfo, S as DevframeViewCustomRender, T as DevframeViewJsonRender, _ as DevframeDockEntryIcon, a as DevframeCommandHandle, b as DevframeViewAction, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as ClientScriptEntry, g as DevframeDockEntryCategory, h as DevframeDockEntryBase, i as DevframeCommandEntry, j as JsonRenderSpec, k as RemoteDockOptions, l as DevframeCommandsHostEvents, m as DevframeDockEntry, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockEntriesGrouped, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockUserEntry, w as DevframeViewIframe, x as DevframeViewBuiltin, y as DevframeDocksHost } from "../settings-ZM591NEp.mjs";
 import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "../index-Dic9q4eN.mjs";
-export { BuiltinDocksOptions, ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockUserEntry, DevframeDocksHost, DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, DevframeMessageElementPosition, DevframeMessageEntry, DevframeMessageEntryFrom, DevframeMessageEntryInput, DevframeMessageFilePosition, DevframeMessageHandle, DevframeMessageLevel, DevframeMessageShortcutInput, DevframeMessagesClient, DevframeMessagesHost, DevframeMessagesLevelShortcuts, DevframeMessagesListDelta, type DevframeNodeRpcSession, DevframePtyExecuteOptions, DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, DevframeServerCommandEntry, DevframeServerCommandInput, DevframeTerminalSession, DevframeTerminalSessionBase, DevframeTerminalStatus, DevframeTerminalsHost, DevframeViewAction, DevframeViewBuiltin, DevframeViewCustomRender, DevframeViewGroup, type DevframeViewHost, DevframeViewIframe, DevframeViewJsonRender, DevframeViewLauncher, DevframeViewLauncherStatus, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, JsonRenderElement, JsonRenderSpec, JsonRenderer, type PartialWithoutId, RemoteConnectionInfo, RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type Thenable };
+export { ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessOutput, DevframeChildProcessResult, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, type DevframeDiagnosticsDefinition, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockUserEntry, DevframeDocksHost, DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, DevframeMessageElementPosition, DevframeMessageEntry, DevframeMessageEntryFrom, DevframeMessageEntryInput, DevframeMessageFilePosition, DevframeMessageHandle, DevframeMessageLevel, DevframeMessageShortcutInput, DevframeMessagesClient, DevframeMessagesHost, DevframeMessagesLevelShortcuts, DevframeMessagesListDelta, type DevframeNodeRpcSession, DevframePtyExecuteOptions, DevframePtyTerminalSession, type DevframeRpcClientFunctions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, DevframeServerCommandEntry, DevframeServerCommandInput, DevframeTerminalSession, DevframeTerminalSessionBase, DevframeTerminalStatus, DevframeTerminalsHost, DevframeViewAction, DevframeViewBuiltin, DevframeViewCustomRender, DevframeViewGroup, type DevframeViewHost, DevframeViewIframe, DevframeViewJsonRender, DevframeViewLauncher, DevframeViewLauncherStatus, type EntriesToObject, type EventEmitter, type EventUnsubscribe, type EventsMap, JsonRenderElement, JsonRenderSpec, JsonRenderer, type PartialWithoutId, RemoteConnectionInfo, RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type Thenable };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub",
   "type": "module",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Framework-neutral hub layer for devframe — docks, terminals, messages, commands.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.6.0"
+    "devframe": "0.6.2"
   },
   "dependencies": {
     "birpc": "^4.0.0",
@@ -48,7 +48,7 @@
     "@types/node": "^26.1.0",
     "mlly": "^1.8.2",
     "tsdown": "^0.22.3",
-    "devframe": "0.6.0"
+    "devframe": "0.6.2"
   },
   "scripts": {
     "build": "tsdown",