@devframes/hub 0.9.5 → 0.9.7

package/dist/client/index.d.mts

@@ -1,6 +1,6 @@
-import { E as DevframeMessagesClient, x as DevframeMessageEntryInput } from "../context-BVkxwz5k.mjs";
+import { E as DevframeMessagesClient, x as DevframeMessageEntryInput } from "../context-D5JSW_X5.mjs";
 import { N as NavTarget, P as RemoteConnectionInfo, S as DevframeDockUserEntry, _ as DevframeDockEntry, a as DevframeCommandEntry, b as DevframeDockEntryIcon, g as DevframeDockEntriesGrouped, k as DevframeViewIframe, n as DevframeClientCommand, p as ClientScriptEntry, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings } from "../settings-D7whfcx2.mjs";
-import "../index-CyEyZHB3.mjs";
+import "../index-DhxIxS-Q.mjs";
 import { DevframeClientRpcHost, DevframeConnection, DevframeConnectionStatus, DevframeRpcClient, DevframeRpcClientOptions, DevframeRpcContext, RpcClientEvents, RpcClientEvents as RpcClientEvents$1 } from "devframe/client";
 import { EventEmitter } from "devframe/types";
 import { SharedState } from "devframe/utils/shared-state";
@@ -144,7 +144,7 @@ interface CreateDockRenderersContextOptions {
 }
 /**
  * Build the {@link DockRenderersContext} shared by every hub-aware client —
- * `createDevframeClientHost` and viewers that assemble their own context
+ * `createDevframeClientRuntime` and hub UI providers that assemble their own context
  * (`@devframes/hub-ui`) both delegate here so local-first resolution, lazy
  * manifest imports, and the typed mount result behave identically everywhere.
  */
@@ -162,7 +162,7 @@ interface DockPanelStorage {
 }
 /**
  * Per-tab UI state of the dock panel, distinct from the browser-shared geometry
- * in {@link DockPanelStorage}. A viewer persists this to `sessionStorage` so a
+ * in {@link DockPanelStorage}. A hub UI provider persists this to `sessionStorage` so a
  * reload (or the RPC auth handshake that follows one) restores the panel to
  * exactly where the developer left it — which dock was open, and the
  * address-bar route of that dock's iframe. Kept `sessionStorage`-scoped (not
@@ -181,6 +181,27 @@ interface DockSessionStorage {
    * reload. `null` when the selected dock has no iframe route to remember.
    */
   selectedDockRoute: string | null;
+  /**
+   * The dock entry most recently selected from beyond the float bar's inline
+   * capacity — from the overflow popover or from inside a dock group. A hub UI
+   * provider raises this entry into a dedicated slot between the bar's visible
+   * items and the overflow button, so deselecting it (or selecting a visible
+   * neighbour) keeps it one click away instead of folding it straight back
+   * into the overflow. `null` (or absent, for stores persisted before this
+   * field existed) when no entry has been raised.
+   */
+  recentDockId?: string | null;
+  /**
+   * The member most recently opened in each dock group, keyed by group id.
+   * Recorded whenever a grouped member is selected (from the group popover,
+   * the group sidebar, the command palette, or an RPC activation), and read
+   * back when the group is activated again: the remembered member reopens
+   * directly, taking precedence over the group's own
+   * {@link import('../types/docks').DevframeViewGroup.defaultChildId defaultChildId}.
+   * A group is only listed once one of its members has been opened this tab
+   * (absent for stores persisted before this field existed).
+   */
+  groupLastChildIds?: Record<string, string>;
 }
 type DockClientType = 'embedded' | 'standalone';
 interface DocksContext extends DevframeRpcContext {
@@ -208,7 +229,7 @@ interface DocksContext extends DevframeRpcContext {
    */
   readonly when: WhenClauseContext;
   /**
-   * The live connection status of the underlying devframe client, so a viewer
+   * The live connection status of the underlying RPC client, so a hub UI provider
    * can render one central connection indicator for every docked plugin
    * instead of each plugin surfacing its own.
    */
@@ -244,7 +265,7 @@ interface DocksPanelContext {
   /**
    * Per-tab session UI state — whether the panel is open, which dock is
    * selected, and that dock's iframe route. Restored across reloads (and the
-   * auth handshake that follows one) by a viewer that persists it to
+   * auth handshake that follows one) by a hub UI provider that persists it to
    * `sessionStorage`.
    */
   session: DockSessionStorage;
@@ -272,7 +293,7 @@ interface DocksEntriesContext {
    * The resolved top-level category ordering — `DEFAULT_CATEGORIES_ORDER`,
    * overridden by every installed devframe's own `dock.categoryOrder`
    * (`ConnectionMeta.configs.dock.categoryOrder`), overridden again by the
-   * host page's own `createDevframeClientHost({ categoryOrder })`. Fixed
+   * host page's own `createDevframeClientRuntime({ categoryOrder })`. Fixed
    * for the life of the session — resolved once at boot.
    */
   readonly categoryOrder: Record<string, number>;
@@ -299,7 +320,7 @@ interface DocksEntriesContext {
    * {@link entries}. Unlike a dock registered on the node
    * {@link import('../types/docks').DevframeDocksHost}, it never flows into
    * shared state, so it stays local to this client instead of syncing to the
-   * hub or other viewers — for a view a client host synthesizes itself.
+   * hub or other hub UI providers — for a view the client runtime synthesizes itself.
    *
    * Throws when `id` already names a client dock, unless `force` is set. A
    * client dock sharing an id with a server dock overrides it in the local
@@ -393,8 +414,8 @@ declare const CLIENT_CONTEXT_KEY = "__DEVFRAME_HUB_CLIENT_CONTEXT__";
 declare function getDevframeClientContext(): DevframeClientContext | undefined;
 /**
  * Publish the global Devframe client context (or clear it with `undefined`).
- * Called by {@link import('./host').createDevframeClientHost}; a dock client
- * script or a viewer reads it back with {@link getDevframeClientContext}.
+ * Called by {@link import('./host').createDevframeClientRuntime}; a dock client
+ * script or a hub UI provider reads it back with {@link getDevframeClientContext}.
  */
 declare function setDevframeClientContext(ctx: DevframeClientContext | undefined): void;
 //#endregion
@@ -483,7 +504,7 @@ declare function watchFrameLocation(options: WatchFrameLocationOptions): () => v
 //#endregion
 //#region src/client/frame-nav.d.ts
 /**
- * Shared-iframe soft navigation — the viewer-side half of a host↔iframe
+ * Shared-iframe soft navigation — the hub-UI-provider-side half of a host-page↔iframe
  * `postMessage` protocol.
  *
  * An {@link DevframeViewIframe.subTabs anchor} iframe dock owns one live iframe
@@ -603,7 +624,7 @@ interface FrameNavClient {
 declare function attachFrameNavClient(options: FrameNavClientOptions): FrameNavClient;
 //#endregion
 //#region src/client/host.d.ts
-interface DevframeClientHostOptions {
+interface DevframeClientRuntimeOptions {
   /**
    * An already-connected RPC client. When omitted, one is created via
    * `connectDevframe(connect)` — pass `connect.baseURL` to point at the hub's
@@ -625,7 +646,7 @@ interface DevframeClientHostOptions {
   loadClientScripts?: boolean;
   /**
    * Resolve a **bare-specifier** client script (`importFrom` naming an npm
-   * module) to a URL this page can import — a viewer's own policy, winning
+   * module) to a URL this page can import — a hub UI provider's own policy, winning
    * over the host-advertised `ConnectionMeta.configs.dock.clientModuleResolution`
    * template (return `undefined` to fall through to it). URL specifiers never
    * reach this hook. E.g. on a Vite-served page:
@@ -660,28 +681,34 @@ interface DevframeClientHostOptions {
    * @example
    * ```ts
    * // Surface `data` tools ahead of `app` tools, hub-wide.
-   * createDevframeClientHost({ categoryOrder: { data: 50 } })
+   * createDevframeClientRuntime({ categoryOrder: { data: 50 } })
    * ```
    */
   categoryOrder?: Record<string, number>;
 }
-interface DevframeClientHost {
-  /** The assembled, globally-registered client host context. */
+interface DevframeClientRuntime {
+  /** The assembled, globally-registered client context. */
   context: DevframeClientContext;
   /** Tear down listeners and stop tracking newly-registered client scripts. */
   dispose: () => void;
 }
 /**
- * Boot the framework-level client host: connect RPC, assemble the full
+ * Boot the client runtime: connect RPC, assemble the full
  * {@link DevframeClientContext} (panel, docks, commands, when) from the hub's
  * shared state, publish it at `__DEVFRAME_HUB_CLIENT_CONTEXT__`, and load every
  * dock entry's client script into this page — the devframe equivalent of the
  * runtime `@vitejs/devtools-kit` injects into a host app.
  *
- * A viewer keeps rendering its own dock UI (reading the same shared state); this
+ * A hub UI provider keeps rendering its own dock UI (reading the same shared state); this
  * runtime is what gives plugin client scripts a live host context to run in.
  */
-declare function createDevframeClientHost(options?: DevframeClientHostOptions): Promise<DevframeClientHost>;
+declare function createDevframeClientRuntime(options?: DevframeClientRuntimeOptions): Promise<DevframeClientRuntime>;
+/** @deprecated Renamed — use {@link DevframeClientRuntimeOptions}. */
+type DevframeClientHostOptions = DevframeClientRuntimeOptions;
+/** @deprecated Renamed — use {@link DevframeClientRuntime}. */
+type DevframeClientHost = DevframeClientRuntime;
+/** @deprecated Renamed — use {@link createDevframeClientRuntime}. */
+declare const createDevframeClientHost: typeof createDevframeClientRuntime;
 //#endregion
 //#region src/client/messages.d.ts
 interface MessagesClientOptions {
@@ -731,4 +758,4 @@ declare function parseRemoteConnection(input?: string): RemoteConnectionInfo | n
  */
 declare function connectRemoteDevframe(options?: ConnectRemoteDevframeOptions): Promise<DevframeRpcClient>;
 //#endregion
-export { CLIENT_CONTEXT_KEY, CommandsContext, ConnectRemoteDevframeOptions, CreateDockRenderersContextOptions, DevframeClientContext, DevframeClientHost, DevframeClientHostOptions, type DevframeClientRpcHost, DockClientScriptContext, DockClientType, DockEntryState, DockEntryStateEvents, DockPanelStorage, DockRegistration, DockRenderer, DockRendererInstance, DockRendererManifest, DockRendererMountOptions, DockRendererMountResult, DockRenderersContext, DockSessionStorage, DocksConnectionContext, DocksContext, DocksEntriesContext, DocksPanelContext, FRAME_NAV_CHANNEL, FRAME_NAV_VERSION, FrameLocationHistory, FrameLocationTarget, FrameLocationWindow, FrameNavClient, FrameNavClientOptions, FrameNavEnvelope, FrameNavFrameMessage, FrameNavHostMessage, FrameNavHostPayload, FrameNavListenTarget, FrameTab, MessagesClientOptions, type RpcClientEvents, WatchFrameLocationOptions, WhenClauseContext, attachFrameNavClient, buildRemoteDevframeUrl, clientScriptFailureHint, connectRemoteDevframe, createDevframeClientHost, createDockRenderersContext, createMessagesClient, getDevframeClientContext, parseRemoteConnection, resolveClientModuleSpecifier, resolveDockIcon, resolveDockUrl, setDevframeClientContext, stripRemoteConnectionFromUrl, watchFrameLocation };
+export { CLIENT_CONTEXT_KEY, CommandsContext, ConnectRemoteDevframeOptions, CreateDockRenderersContextOptions, DevframeClientContext, DevframeClientHost, DevframeClientHostOptions, type DevframeClientRpcHost, DevframeClientRuntime, DevframeClientRuntimeOptions, DockClientScriptContext, DockClientType, DockEntryState, DockEntryStateEvents, DockPanelStorage, DockRegistration, DockRenderer, DockRendererInstance, DockRendererManifest, DockRendererMountOptions, DockRendererMountResult, DockRenderersContext, DockSessionStorage, DocksConnectionContext, DocksContext, DocksEntriesContext, DocksPanelContext, FRAME_NAV_CHANNEL, FRAME_NAV_VERSION, FrameLocationHistory, FrameLocationTarget, FrameLocationWindow, FrameNavClient, FrameNavClientOptions, FrameNavEnvelope, FrameNavFrameMessage, FrameNavHostMessage, FrameNavHostPayload, FrameNavListenTarget, FrameTab, MessagesClientOptions, type RpcClientEvents, WatchFrameLocationOptions, WhenClauseContext, attachFrameNavClient, buildRemoteDevframeUrl, clientScriptFailureHint, connectRemoteDevframe, createDevframeClientHost, createDevframeClientRuntime, createDockRenderersContext, createMessagesClient, getDevframeClientContext, parseRemoteConnection, resolveClientModuleSpecifier, resolveDockIcon, resolveDockUrl, setDevframeClientContext, stripRemoteConnectionFromUrl, watchFrameLocation };

package/dist/client/index.mjs

@@ -1,4 +1,4 @@
-import { i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, t as DEFAULT_CATEGORIES_ORDER } from "../constants-fpJMWBtH.mjs";
+import { i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, t as DEFAULT_CATEGORIES_ORDER } from "../constants-DrF61GFx.mjs";
 import { a as resolveClientModuleSpecifier, n as stripRemoteConnectionFromUrl, r as clientScriptFailureHint, t as buildRemoteConnectionUrl } from "../remote-url-Bgc7gtsP.mjs";
 import { REMOTE_CONNECTION_KEY } from "devframe/constants";
 import { connectDevframe, getDevframeRpcClient, resolveWsUrl } from "devframe/client";
@@ -15,8 +15,8 @@ function getDevframeClientContext() {
 }
 /**
 * Publish the global Devframe client context (or clear it with `undefined`).
-* Called by {@link import('./host').createDevframeClientHost}; a dock client
-* script or a viewer reads it back with {@link getDevframeClientContext}.
+* Called by {@link import('./host').createDevframeClientRuntime}; a dock client
+* script or a hub UI provider reads it back with {@link getDevframeClientContext}.
 */
 function setDevframeClientContext(ctx) {
 	globalThis[CLIENT_CONTEXT_KEY] = ctx;
@@ -153,7 +153,7 @@ function watchFrameLocation(options) {
 //#endregion
 //#region src/client/frame-nav.ts
 /**
-* Shared-iframe soft navigation — the viewer-side half of a host↔iframe
+* Shared-iframe soft navigation — the hub-UI-provider-side half of a host-page↔iframe
 * `postMessage` protocol.
 *
 * An {@link DevframeViewIframe.subTabs anchor} iframe dock owns one live iframe
@@ -407,7 +407,7 @@ function createMessagesClient(rpc, options = {}) {
 //#region src/client/renderers.ts
 /**
 * Build the {@link DockRenderersContext} shared by every hub-aware client —
-* `createDevframeClientHost` and viewers that assemble their own context
+* `createDevframeClientRuntime` and hub UI providers that assemble their own context
 * (`@devframes/hub-ui`) both delegate here so local-first resolution, lazy
 * manifest imports, and the typed mount result behave identically everywhere.
 */
@@ -501,16 +501,16 @@ const COMMANDS_STATE_KEY = HUB_EVENTS.sharedState.commands;
 const USER_SETTINGS_STATE_KEY = HUB_EVENTS.sharedState.userSettings;
 const DOCKS_ACTIVATE_EVENT = HUB_EVENTS.broadcast.docksActivate;
 /**
-* Boot the framework-level client host: connect RPC, assemble the full
+* Boot the client runtime: connect RPC, assemble the full
 * {@link DevframeClientContext} (panel, docks, commands, when) from the hub's
 * shared state, publish it at `__DEVFRAME_HUB_CLIENT_CONTEXT__`, and load every
 * dock entry's client script into this page — the devframe equivalent of the
 * runtime `@vitejs/devtools-kit` injects into a host app.
 *
-* A viewer keeps rendering its own dock UI (reading the same shared state); this
+* A hub UI provider keeps rendering its own dock UI (reading the same shared state); this
 * runtime is what gives plugin client scripts a live host context to run in.
 */
-async function createDevframeClientHost(options = {}) {
+async function createDevframeClientRuntime(options = {}) {
 	const clientType = options.clientType ?? "standalone";
 	const rpc = options.rpc ?? await connectDevframe(options.connect);
 	let mountedRenderers;
@@ -575,7 +575,7 @@ async function createDevframeClientHost(options = {}) {
 		type: "action",
 		handler: (activation) => activateHandler(activation)
 	});
-	if (getDevframeClientContext()) console.warn("[@devframes/hub] A client host context is already published on this page — replacing it. Boot createDevframeClientHost() once per page (e.g. HTML injection combined with a manual import boots it twice).");
+	if (getDevframeClientContext()) console.warn("[@devframes/hub] A client context is already published on this page — replacing it. Boot createDevframeClientRuntime() once per page (e.g. HTML injection combined with a manual import boots it twice).");
 	setDevframeClientContext(context);
 	const loadedScripts = /* @__PURE__ */ new Set();
 	if (loadScriptsEnabled) {
@@ -863,6 +863,8 @@ function groupByCategory(entries, categoryOrder) {
 	}
 	return [...groups.entries()].sort(([a], [b]) => (categoryOrder[a] ?? 0) - (categoryOrder[b] ?? 0));
 }
+/** @deprecated Renamed — use {@link createDevframeClientRuntime}. */
+const createDevframeClientHost = createDevframeClientRuntime;
 //#endregion
 //#region src/client/remote.ts
 function base64UrlDecode(value) {
@@ -971,4 +973,4 @@ async function connectRemoteDevframe(options = {}) {
 	});
 }
 //#endregion
-export { CLIENT_CONTEXT_KEY, FRAME_NAV_CHANNEL, FRAME_NAV_VERSION, attachFrameNavClient, buildRemoteDevframeUrl, clientScriptFailureHint, connectRemoteDevframe, createDevframeClientHost, createDockRenderersContext, createMessagesClient, getDevframeClientContext, parseRemoteConnection, resolveClientModuleSpecifier, resolveDockIcon, resolveDockUrl, setDevframeClientContext, stripRemoteConnectionFromUrl, watchFrameLocation };
+export { CLIENT_CONTEXT_KEY, FRAME_NAV_CHANNEL, FRAME_NAV_VERSION, attachFrameNavClient, buildRemoteDevframeUrl, clientScriptFailureHint, connectRemoteDevframe, createDevframeClientHost, createDevframeClientRuntime, createDockRenderersContext, createMessagesClient, getDevframeClientContext, parseRemoteConnection, resolveClientModuleSpecifier, resolveDockIcon, resolveDockUrl, setDevframeClientContext, stripRemoteConnectionFromUrl, watchFrameLocation };

package/dist/{constants-BrffEYRZ.d.mts → constants-C5t0DeZ0.d.mts}

@@ -5,7 +5,7 @@ import { t as DevframeDocksUserSettings } from "./settings-D7whfcx2.mjs";
  * key, and channel name the hub uses — the single source of truth that keeps
  * these names out of scattered string literals.
  *
- * **Keep this in sync with [`docs/content/1.guide/20.events.md`](../../../docs/content/1.guide/20.events.md)**
+ * **Keep this in sync with [`docs/content/8.references/3.events.md`](../../../docs/content/8.references/3.events.md)**
  * (the Hub Events Reference): every name here appears in that page's tables, and
  * every name there resolves to an entry here. Add, rename, or remove a name in
  * both places in the same change, and reference `HUB_EVENTS.*` from call sites

package/dist/{constants-fpJMWBtH.mjs → constants-DrF61GFx.mjs}

@@ -5,7 +5,7 @@ import { cleanDoubleSlashes, withLeadingSlash, withTrailingSlash } from "ufo";
 * key, and channel name the hub uses — the single source of truth that keeps
 * these names out of scattered string literals.
 *
-* **Keep this in sync with [`docs/content/1.guide/20.events.md`](../../../docs/content/1.guide/20.events.md)**
+* **Keep this in sync with [`docs/content/8.references/3.events.md`](../../../docs/content/8.references/3.events.md)**
 * (the Hub Events Reference): every name here appears in that page's tables, and
 * every name there resolves to an entry here. Add, rename, or remove a name in
 * both places in the same change, and reference `HUB_EVENTS.*` from call sites

package/dist/constants.d.mts

@@ -1,3 +1,3 @@
-import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, r as DEVFRAMES_HUB_BASE, t as DEFAULT_CATEGORIES_ORDER } from "./constants-BrffEYRZ.mjs";
+import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, r as DEVFRAMES_HUB_BASE, t as DEFAULT_CATEGORIES_ORDER } from "./constants-C5t0DeZ0.mjs";
 export * from "devframe/constants";
 export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, HUB_EVENTS, normalizeHubBase };

package/dist/constants.mjs

@@ -1,3 +1,3 @@
-import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, r as DEVFRAMES_HUB_BASE, t as DEFAULT_CATEGORIES_ORDER } from "./constants-fpJMWBtH.mjs";
+import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS, r as DEVFRAMES_HUB_BASE, t as DEFAULT_CATEGORIES_ORDER } from "./constants-DrF61GFx.mjs";
 export * from "devframe/constants";
 export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, HUB_EVENTS, normalizeHubBase };

package/dist/{context-CqHxHlNV.mjs → context-C3hUUCC1.mjs}

@@ -1,5 +1,5 @@
 import { r as defineHubRpcFunction } from "./define-Ceekw2EO.mjs";
-import { n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS } from "./constants-fpJMWBtH.mjs";
+import { n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS } from "./constants-DrF61GFx.mjs";
 import { i as isBareModuleSpecifier, t as buildRemoteConnectionUrl } from "./remote-url-Bgc7gtsP.mjs";
 import { createEventEmitter } from "devframe/utils/events";
 import { createHostContext, createStorage } from "devframe/node";
@@ -61,7 +61,7 @@ const diagnostics = defineDiagnostics({
 		},
 		DF8107: {
 			why: (p) => `Dock activation requested for unknown dock id "${p.id}"`,
-			fix: "Pass a `dockId` that matches a registered dock entry. The activation is still broadcast, but no viewer will switch to it. Ids are case-sensitive — check for typos, and ensure the target dock is registered before activating it."
+			fix: "Pass a `dockId` that matches a registered dock entry. The activation is still broadcast, but no hub UI provider will switch to it. Ids are case-sensitive — check for typos, and ensure the target dock is registered before activating it."
 		},
 		DF8108: {
 			why: (p) => `A renderer module is already registered for dock type "${p.type}"`,
@@ -77,7 +77,7 @@ const diagnostics = defineDiagnostics({
 		},
 		DF8111: {
 			why: (p) => `Dock "${p.id}" declares the bare-specifier client script "${p.specifier}", but this host advertises no client-module resolution — the browser cannot resolve a bare npm specifier natively, so the script will fail to load.`,
-			fix: "Run under a host that declares `initHub({ clientModuleResolution })` (e.g. Vite's `'/@id/{specifier}'`), ship the script as a self-contained bundle served by URL, or resolve it in the viewer via `createDevframeClientHost({ resolveClientModule })` (then disregard this warning)."
+			fix: "Run under a host framework that declares `initHub({ clientModuleResolution })` (e.g. Vite's `'/@id/{specifier}'`), ship the script as a self-contained bundle served by URL, or resolve it in the hub UI provider via `createDevframeClientRuntime({ resolveClientModule })` (then disregard this warning)."
 		},
 		DF8200: { why: (p) => `Terminal session with id "${p.id}" already registered` },
 		DF8201: { why: (p) => `Terminal session with id "${p.id}" not registered` },
@@ -325,7 +325,7 @@ var DevframeDocksHost = class {
 		});
 	}
 	/**
-	* Warn (don't throw — a viewer-side `resolveClientModule` may still cover
+	* Warn (don't throw — a client-runtime `resolveClientModule` override may still cover
 	* it) when a dock declares a **bare-specifier** client script on a host
 	* that advertises no `staticConfig.dock.clientModuleResolution`: the
 	* browser cannot resolve a bare npm specifier natively, so the script is
@@ -1015,7 +1015,7 @@ const hubCommandsExecute = defineHubRpcFunction({
 * messages subsystem. Marked `from: 'browser'`. Returns the serializable
 * entry (the mutation handle stays server-side).
 *
-* Pairs with the client-side {@link import('../client').createDevframeClientHost}
+* Pairs with the client-side {@link import('../client').createDevframeClientRuntime}
 * context, whose `messages` client dispatches through these built-ins so a
 * dock client script can report into the same feed the server writes to.
 */

package/dist/{context-BVkxwz5k.d.mts → context-D5JSW_X5.d.mts}

@@ -117,9 +117,10 @@ interface DevframeMessageEntry {
    */
   actions?: DevframeMessageAction[];
   /**
-   * Time in ms to auto-dismiss the toast notification (client-side)
+   * Time in ms to auto-dismiss the toast notification (client-side) or
+   * `false` to keep it indefinitely.
    */
-  autoDismiss?: number;
+  autoDismiss?: number | false;
   /**
    * Time in ms to auto-delete this message entry (server-side)
    */

package/dist/{index-CyEyZHB3.d.mts → index-DhxIxS-Q.d.mts}

@@ -1,4 +1,4 @@
-import "./context-BVkxwz5k.mjs";
+import "./context-D5JSW_X5.mjs";
 import "./settings-D7whfcx2.mjs";
 import { RpcDefinitionsFilter, RpcDefinitionsToFunctions } from "devframe/rpc";
 import { ConnectionMeta as ConnectionMeta$1, DevframeCapabilities, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeHost as DevframeHost$1, DevframeNodeRpcSession, DevframeRpcClientFunctions, DevframeRpcServerFunctions, DevframeRpcSharedStates, DevframeViewHost, EventEmitter as EventEmitter$1, EventUnsubscribe, EventsMap, RpcBroadcastOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost } from "devframe/types";

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { C as DevframeMessageHandle, D as DevframeMessagesHost, E as DevframeMessagesClient, O as DevframeMessagesLevelShortcuts, S as DevframeMessageFilePosition, T as DevframeMessageShortcutInput, _ as DevframeMessageCommandAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageEntryFrom, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, g as DevframeMessageActivateAction, h as DevframeMessageAction, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalStatus, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyTerminalSession, v as DevframeMessageElementPosition, w as DevframeMessageLevel, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "./context-BVkxwz5k.mjs";
+import { C as DevframeMessageHandle, D as DevframeMessagesHost, E as DevframeMessagesClient, O as DevframeMessagesLevelShortcuts, S as DevframeMessageFilePosition, T as DevframeMessageShortcutInput, _ as DevframeMessageCommandAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageEntryFrom, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, g as DevframeMessageActivateAction, h as DevframeMessageAction, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalStatus, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyTerminalSession, v as DevframeMessageElementPosition, w as DevframeMessageLevel, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "./context-D5JSW_X5.mjs";
 import { A as DevframeViewLauncher, C as DevframeDocksActiveState, D as DevframeViewCustomRender, E as DevframeViewBuiltin, F as RemoteDockOptions, M as FrameSubTabsConfig, N as NavTarget, O as DevframeViewGroup, P as RemoteConnectionInfo, S as DevframeDockUserEntry, T as DevframeViewAction, _ as DevframeDockEntry, a as DevframeCommandEntry, b as DevframeDockEntryIcon, c as DevframeCommandShortcutOverrides, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, g as DevframeDockEntriesGrouped, h as DevframeDockBadgeVariant, i as DevframeCommandBase, j as DevframeViewLauncherStatus, k as DevframeViewIframe, l as DevframeCommandsHost, m as DevframeDockActivation, n as DevframeClientCommand, o as DevframeCommandHandle, p as ClientScriptEntry, r as DevframeCommandAgentOptions, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings, u as DevframeCommandsHostEvents, v as DevframeDockEntryBase, w as DevframeDocksHost, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "./settings-D7whfcx2.mjs";
-import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "./index-CyEyZHB3.mjs";
+import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "./index-DhxIxS-Q.mjs";
 import { WhenContext, WhenExpression } from "devframe/utils/when";
 //#region src/define.d.ts
 declare const defineHubRpcFunction: <NAME extends string, TYPE extends import("devframe/rpc").RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends import("devframe/rpc").RpcArgsSchema | undefined = undefined, const RS extends import("devframe/rpc").RpcReturnSchema | undefined = undefined>(definition: import("devframe/rpc").RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeHubContext>) => import("devframe/rpc").RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeHubContext>;

package/dist/node/index.d.mts

@@ -1,4 +1,4 @@
-import { C as DevframeMessageHandle, D as DevframeMessagesHost$1, T as DevframeMessageShortcutInput, a as DevframeChildProcessExecuteOptions, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, i as InstallDevframeOptions, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost$1, n as DevframeHubContext, r as createHubContext, t as CreateHubContextOptions, u as DevframePtyTerminalSession, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "../context-BVkxwz5k.mjs";
+import { C as DevframeMessageHandle, D as DevframeMessagesHost$1, T as DevframeMessageShortcutInput, a as DevframeChildProcessExecuteOptions, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, i as InstallDevframeOptions, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost$1, n as DevframeHubContext, r as createHubContext, t as CreateHubContextOptions, u as DevframePtyTerminalSession, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "../context-D5JSW_X5.mjs";
 import { S as DevframeDockUserEntry, _ as DevframeDockEntry, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, l as DevframeCommandsHost$1, o as DevframeCommandHandle, p as ClientScriptEntry, t as DevframeDocksUserSettings, w as DevframeDocksHost$1 } from "../settings-D7whfcx2.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { SharedState } from "devframe/utils/shared-state";
@@ -52,7 +52,7 @@ declare class DevframeDocksHost implements DevframeDocksHost$1 {
   update(view: DevframeDockUserEntry): void;
   activate(dockId: string, params?: Record<string, unknown>): void;
   /**
-   * Warn (don't throw — a viewer-side `resolveClientModule` may still cover
+   * Warn (don't throw — a client-runtime `resolveClientModule` override may still cover
    * it) when a dock declares a **bare-specifier** client script on a host
    * that advertises no `staticConfig.dock.clientModuleResolution`: the
    * browser cannot resolve a bare npm specifier natively, so the script is
@@ -155,7 +155,7 @@ declare const hubCommandsExecute: {
  * messages subsystem. Marked `from: 'browser'`. Returns the serializable
  * entry (the mutation handle stays server-side).
  *
- * Pairs with the client-side {@link import('../client').createDevframeClientHost}
+ * Pairs with the client-side {@link import('../client').createDevframeClientRuntime}
  * context, whose `messages` client dispatches through these built-ins so a
  * dock client script can report into the same feed the server writes to.
  */

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-import { _ as DevframeDocksHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeMessagesHost, h as DevframeTerminalsHost, i as hubDocksActivate, l as hubTerminalsRemove, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize, v as DevframeCommandsHost } from "../context-CqHxHlNV.mjs";
+import { _ as DevframeDocksHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeMessagesHost, h as DevframeTerminalsHost, i as hubDocksActivate, l as hubTerminalsRemove, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize, v as DevframeCommandsHost } from "../context-C3hUUCC1.mjs";
 import "ufo";
 import "pathe";
 import "node:process";

package/dist/node/initiate.d.mts

@@ -1,5 +1,5 @@
-import { i as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-BVkxwz5k.mjs";
-import { r as DEVFRAMES_HUB_BASE } from "../constants-BrffEYRZ.mjs";
+import { i as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-D5JSW_X5.mjs";
+import { r as DEVFRAMES_HUB_BASE } from "../constants-C5t0DeZ0.mjs";
 import { DevframeInstanceRecord } from "devframe/internal";
 import { ConnectionMeta, DevframeDefinition, DevframeServiceInput, DevframeSseOptions, DevframeStorageScope, DevframeWsOptions, McpRouteOptions } from "devframe/types";
 import { DevframeAuthHandler } from "devframe/node/auth";
@@ -152,7 +152,7 @@ interface InitHubOptions {
    * `<base>__renderers/<type>.mjs` and published in the renderer manifest;
    * clients import a module lazily the first time a dock of its `type`
    * mounts. Renderers registered directly in client code
-   * (`createDevframeClientHost({ renderers })`) take precedence.
+   * (`createDevframeClientRuntime({ renderers })`) take precedence.
    *
    * ```ts
    * import { jsonRenderUiRenderer } from '@devframes/json-render-ui/hub'
@@ -272,7 +272,7 @@ interface HubInstance {
   context: Promise<DevframeHubContext>;
   /** The `ConnectionMeta` served at `<base>__connection.json` (and every frame base). */
   connectionMeta: () => ConnectionMeta;
-  /** Tear down: WS transport/side-car, MCP sessions. */
+  /** Tear down: WS transport/side-car, MCP handler. */
   close: () => Promise<void>;
 }
 /**

package/dist/node/initiate.mjs

@@ -1,9 +1,9 @@
-import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, r as DEVFRAMES_HUB_BASE } from "../constants-fpJMWBtH.mjs";
+import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, r as DEVFRAMES_HUB_BASE } from "../constants-DrF61GFx.mjs";
 import { a as resolveClientModuleSpecifier } from "../remote-url-Bgc7gtsP.mjs";
-import { m as prepareDevframe, t as createHubContext, y as diagnostics } from "../context-CqHxHlNV.mjs";
+import { m as prepareDevframe, t as createHubContext, y as diagnostics } from "../context-C3hUUCC1.mjs";
 import { joinURL, withTrailingSlash, withoutLeadingSlash } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE, DEVFRAME_WS_ROUTE } from "devframe/constants";
-import { createH3DevframeHost, createInstanceShell, resolveInstanceRegister } from "devframe/internal";
+import { createH3DevframeHost, createInstanceShell, importRuntimeModule, resolveInstanceRegister } from "devframe/internal";
 import { resolve } from "pathe";
 import process from "node:process";
 import { existsSync } from "node:fs";
@@ -201,7 +201,7 @@ function initHub(options) {
 			const mcpConfig = options.mcp === true ? {} : options.mcp;
 			if (!mcpConfig) return { context: ctx };
 			const mcpRoute = withoutLeadingSlash(mcpConfig.path ?? DEVFRAME_MCP_ROUTE);
-			const { mountMcpHttp } = await import("devframe/adapters/mcp");
+			const { mountMcpHttp } = await importRuntimeModule("devframe/adapters/mcp");
 			const mounted = mountMcpHttp(app, ctx, joinURL(base, mcpRoute), {
 				serverName: options.name ?? "devframes-hub",
 				serverVersion: options.version ?? "0.0.0",

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-import { C as DevframeMessageHandle, D as DevframeMessagesHost, E as DevframeMessagesClient, O as DevframeMessagesLevelShortcuts, S as DevframeMessageFilePosition, T as DevframeMessageShortcutInput, _ as DevframeMessageCommandAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageEntryFrom, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, g as DevframeMessageActivateAction, h as DevframeMessageAction, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalStatus, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyTerminalSession, v as DevframeMessageElementPosition, w as DevframeMessageLevel, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "../context-BVkxwz5k.mjs";
+import { C as DevframeMessageHandle, D as DevframeMessagesHost, E as DevframeMessagesClient, O as DevframeMessagesLevelShortcuts, S as DevframeMessageFilePosition, T as DevframeMessageShortcutInput, _ as DevframeMessageCommandAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageEntryFrom, c as DevframeChildProcessTerminalSession, d as DevframeTerminalSession, f as DevframeTerminalSessionBase, g as DevframeMessageActivateAction, h as DevframeMessageAction, k as DevframeMessagesListDelta, l as DevframePtyExecuteOptions, m as DevframeTerminalsHost, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalStatus, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyTerminalSession, v as DevframeMessageElementPosition, w as DevframeMessageLevel, x as DevframeMessageEntryInput, y as DevframeMessageEntry } from "../context-D5JSW_X5.mjs";
 import { A as DevframeViewLauncher, C as DevframeDocksActiveState, D as DevframeViewCustomRender, E as DevframeViewBuiltin, F as RemoteDockOptions, M as FrameSubTabsConfig, N as NavTarget, O as DevframeViewGroup, P as RemoteConnectionInfo, S as DevframeDockUserEntry, T as DevframeViewAction, _ as DevframeDockEntry, a as DevframeCommandEntry, b as DevframeDockEntryIcon, c as DevframeCommandShortcutOverrides, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, g as DevframeDockEntriesGrouped, h as DevframeDockBadgeVariant, i as DevframeCommandBase, j as DevframeViewLauncherStatus, k as DevframeViewIframe, l as DevframeCommandsHost, m as DevframeDockActivation, n as DevframeClientCommand, o as DevframeCommandHandle, p as ClientScriptEntry, r as DevframeCommandAgentOptions, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings, u as DevframeCommandsHostEvents, v as DevframeDockEntryBase, w as DevframeDocksHost, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "../settings-D7whfcx2.mjs";
-import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "../index-CyEyZHB3.mjs";
+import { S as RpcStreamingHost, _ as RpcFunctionsHost, a as DevframeHost, b as RpcStreamingChannel, c as DevframeRpcServerFunctions, d as EventEmitter, f as EventUnsubscribe, g as RpcDefinitionsToFunctions, h as RpcDefinitionsFilter, i as DevframeDiagnosticsLogger, l as DevframeRpcSharedStates, m as RpcBroadcastOptions, n as DevframeCapabilities, o as DevframeNodeRpcSession, p as EventsMap, r as DevframeDiagnosticsHost, s as DevframeRpcClientFunctions, t as ConnectionMeta, u as DevframeViewHost, v as RpcSharedStateGetOptions, x as RpcStreamingChannelOptions, y as RpcSharedStateHost } from "../index-DhxIxS-Q.mjs";
 export { ClientScriptEntry, type ConnectionMeta, type CreateHubContextOptions, type DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessOutput, DevframeChildProcessResult, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandAgentOptions, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, DevframeDockActivation, DevframeDockBadgeVariant, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockEntryRegistry, DevframeDockUserEntry, DevframeDocksActiveState, DevframeDocksHost, DevframeDocksUserSettings, type DevframeHost, type DevframeHubContext, DevframeMessageAction, DevframeMessageActivateAction, DevframeMessageCommandAction, 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, DevframeViewLauncher, DevframeViewLauncherStatus, type EventEmitter, type EventUnsubscribe, type EventsMap, FrameSubTabsConfig, NavTarget, RemoteConnectionInfo, RemoteDockOptions, type RpcBroadcastOptions, type RpcDefinitionsFilter, type RpcDefinitionsToFunctions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub",
   "type": "module",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "description": "Hub layer that orchestrates devframe docks, terminals, messages, and commands on any host.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -34,7 +34,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.9.5"
+    "devframe": "0.9.7"
   },
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -52,7 +52,7 @@
     "mlly": "^1.8.2",
     "tsdown": "^0.22.14",
     "valibot": "^1.4.2",
-    "devframe": "0.9.5"
+    "devframe": "0.9.7"
   },
   "scripts": {
     "build": "tsdown",