@devframes/hub 0.7.9 → 0.7.10

package/dist/client/index.d.mts

@@ -1,6 +1,7 @@
-import { S as DevframeMessagesClient, _ as DevframeMessageEntryInput } from "../context-CNKFzYdA.mjs";
-import { b as DevframeDockUserEntry, h as DevframeDockEntry, i as DevframeCommandEntry, j as RemoteConnectionInfo, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, t as DevframeDocksUserSettings } from "../settings-C5cAtNdE.mjs";
-import "../index-BeoLMW0z.mjs";
+import { b as DevframeDockUserEntry, h as DevframeDockEntry, i as DevframeCommandEntry, j as RemoteConnectionInfo, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, t as DevframeDocksUserSettings } from "../settings-Chx2aDL_.mjs";
+import { DEFAULT_CATEGORIES_ORDER } from "../constants.mjs";
+import { S as DevframeMessagesClient, _ as DevframeMessageEntryInput } from "../context-BBf7f_8F.mjs";
+import "../index-CREpXwAf.mjs";
 import { DevframeClientRpcHost, DevframeConnectionStatus, DevframeRpcClient, DevframeRpcClientOptions, DevframeRpcContext, RpcClientEvents, RpcClientEvents as RpcClientEvents$1 } from "devframe/client";
 import { EventEmitter } from "devframe/types";
 import { SharedState } from "devframe/utils/shared-state";
@@ -150,6 +151,34 @@ interface DocksEntriesContext {
    * @returns Whether the selection was changed successfully
    */
   toggleEntry: (id: string) => Promise<boolean>;
+  /**
+   * Register a **client-only** dock entry, live in this page and merged with
+   * the server-provided docks (`devframe:docks` shared state) into
+   * {@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.
+   *
+   * 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
+   * merge. Returns a handle to {@link DockRegistration.update patch} or
+   * {@link DockRegistration.dispose remove} it.
+   */
+  register: <T extends DevframeDockEntry>(entry: T, force?: boolean) => DockRegistration<T>;
+  /**
+   * Replace a previously {@link register client-registered} dock entry, keyed
+   * by `id`. Throws when no client dock owns that id.
+   */
+  update: (entry: DevframeDockUserEntry) => void;
+}
+interface DockRegistration<T extends DevframeDockEntry = DevframeDockEntry> {
+  /**
+   * Patch the registered client dock in place. The `id` is immutable — passing
+   * a differing `id` throws.
+   */
+  update: (patch: Partial<T>) => void;
+  /** Remove the client dock from the local merge. */
+  dispose: () => void;
 }
 interface DockEntryState {
   entryMeta: DevframeDockEntry;
@@ -312,4 +341,4 @@ declare function parseRemoteConnection(input?: string): RemoteConnectionInfo | n
  */
 declare function connectRemoteDevframe(options?: ConnectRemoteDevframeOptions): Promise<DevframeRpcClient>;
 //#endregion
-export { CLIENT_CONTEXT_KEY, CommandsContext, ConnectRemoteDevframeOptions, DevframeClientContext, DevframeClientHost, DevframeClientHostOptions, type DevframeClientRpcHost, DockClientScriptContext, DockClientType, DockEntryState, DockEntryStateEvents, DockPanelStorage, DockRenderer, DockRendererInstance, DockRendererMountOptions, DockRenderersContext, DocksConnectionContext, DocksContext, DocksEntriesContext, DocksPanelContext, MessagesClientOptions, type RpcClientEvents, WhenClauseContext, connectRemoteDevframe, createDevframeClientHost, createMessagesClient, getDevframeClientContext, parseRemoteConnection, setDevframeClientContext };
+export { CLIENT_CONTEXT_KEY, CommandsContext, ConnectRemoteDevframeOptions, DEFAULT_CATEGORIES_ORDER, DevframeClientContext, DevframeClientHost, DevframeClientHostOptions, type DevframeClientRpcHost, DockClientScriptContext, DockClientType, DockEntryState, DockEntryStateEvents, DockPanelStorage, DockRegistration, DockRenderer, DockRendererInstance, DockRendererMountOptions, DockRenderersContext, DocksConnectionContext, DocksContext, DocksEntriesContext, DocksPanelContext, MessagesClientOptions, type RpcClientEvents, WhenClauseContext, connectRemoteDevframe, createDevframeClientHost, createMessagesClient, getDevframeClientContext, parseRemoteConnection, setDevframeClientContext };

package/dist/client/index.mjs

@@ -98,6 +98,8 @@ async function createDevframeClientHost(options = {}) {
 	]);
 	let selectedId = null;
 	const entryToStateMap = /* @__PURE__ */ new Map();
+	const clientDocks = /* @__PURE__ */ new Map();
+	const loadScriptsEnabled = options.loadClientScripts ?? true;
 	const panel = createPanelContext(clientType);
 	const docks = createDocksContext();
 	const commands = createCommandsContext();
@@ -147,7 +149,7 @@ async function createDevframeClientHost(options = {}) {
 	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).");
 	setDevframeClientContext(context);
 	const loadedScripts = /* @__PURE__ */ new Set();
-	if (options.loadClientScripts ?? true) {
+	if (loadScriptsEnabled) {
 		loadClientScripts();
 		disposers.push(docksState.on("updated", loadClientScripts));
 	}
@@ -169,8 +171,24 @@ async function createDevframeClientHost(options = {}) {
 			events: createEventEmitter()
 		};
 	}
+	function currentEntries() {
+		const server = docksState.value();
+		if (clientDocks.size === 0) return server;
+		const merged = [];
+		const seen = /* @__PURE__ */ new Set();
+		for (const entry of server) {
+			merged.push(clientDocks.get(entry.id) ?? entry);
+			seen.add(entry.id);
+		}
+		for (const [id, entry] of clientDocks) if (!seen.has(id)) merged.push(entry);
+		return merged;
+	}
+	function refreshEntries() {
+		reconcileEntries();
+		if (loadScriptsEnabled) loadClientScripts();
+	}
 	function reconcileEntries() {
-		const entries = docksState.value();
+		const entries = currentEntries();
 		const seen = /* @__PURE__ */ new Set();
 		for (const meta of entries) {
 			seen.add(meta.id);
@@ -203,7 +221,32 @@ async function createDevframeClientHost(options = {}) {
 			settings,
 			getStateById: (id) => entryToStateMap.get(id),
 			switchEntry,
-			toggleEntry: (id) => selectedId === id ? switchEntry(null) : switchEntry(id)
+			toggleEntry: (id) => selectedId === id ? switchEntry(null) : switchEntry(id),
+			register(entry, force) {
+				if (clientDocks.has(entry.id) && !force) throw new Error(`[@devframes/hub] a client dock "${entry.id}" is already registered — pass force to overwrite`);
+				clientDocks.set(entry.id, entry);
+				refreshEntries();
+				return {
+					update: (patch) => {
+						if (patch.id && patch.id !== entry.id) throw new Error(`[@devframes/hub] cannot change a dock id ("${entry.id}" → "${patch.id}")`);
+						const existing = clientDocks.get(entry.id);
+						if (!existing) throw new Error(`[@devframes/hub] client dock "${entry.id}" was removed — register it again to update`);
+						clientDocks.set(entry.id, {
+							...existing,
+							...patch
+						});
+						refreshEntries();
+					},
+					dispose: () => {
+						if (clientDocks.delete(entry.id)) refreshEntries();
+					}
+				};
+			},
+			update(entry) {
+				if (!clientDocks.has(entry.id)) throw new Error(`[@devframes/hub] no client dock "${entry.id}" to update — register it first`);
+				clientDocks.set(entry.id, entry);
+				refreshEntries();
+			}
 		};
 	}
 	async function switchEntry(id) {
@@ -293,7 +336,7 @@ async function createDevframeClientHost(options = {}) {
 		return entry.action ?? entry.renderer ?? entry.clientScript;
 	}
 	function loadClientScripts() {
-		for (const entry of docksState.value()) {
+		for (const entry of currentEntries()) {
 			const script = clientScriptOf(entry);
 			if (!script?.importFrom || loadedScripts.has(entry.id)) continue;
 			loadedScripts.add(entry.id);
@@ -344,9 +387,12 @@ function createPanelContext(clientType) {
 	};
 }
 function groupByCategory(entries) {
+	const groupsById = /* @__PURE__ */ new Map();
+	for (const entry of entries) if (entry.type === "group") groupsById.set(entry.id, entry);
 	const groups = /* @__PURE__ */ new Map();
 	for (const entry of entries) {
-		const category = entry.category ?? "default";
+		const resolvedGroup = entry.groupId ? groupsById.get(entry.groupId) : void 0;
+		const category = resolvedGroup ? resolvedGroup.category ?? "default" : entry.category ?? "default";
 		let list = groups.get(category);
 		if (!list) {
 			list = [];
@@ -442,4 +488,4 @@ async function connectRemoteDevframe(options = {}) {
 	});
 }
 //#endregion
-export { CLIENT_CONTEXT_KEY, connectRemoteDevframe, createDevframeClientHost, createMessagesClient, getDevframeClientContext, parseRemoteConnection, setDevframeClientContext };
+export { CLIENT_CONTEXT_KEY, DEFAULT_CATEGORIES_ORDER, connectRemoteDevframe, createDevframeClientHost, createMessagesClient, getDevframeClientContext, parseRemoteConnection, setDevframeClientContext };

package/dist/constants.d.mts

@@ -1,6 +1,16 @@
-import { t as DevframeDocksUserSettings } from "./settings-C5cAtNdE.mjs";
+import { t as DevframeDocksUserSettings } from "./settings-Chx2aDL_.mjs";
 export * from "devframe/constants";
 //#region src/constants.d.ts
+/**
+ * The default ordering weight for each known dock category — lower sorts
+ * earlier. Downstream viewers (e.g. `@vitejs/devtools-kit`) import this as the
+ * single source of truth so the hub and its viewers agree on category order.
+ * `framework` sorts first; `~builtin` (the viewer's own built-in views) last.
+ *
+ * The buckets read from "closest to your app" → "platform / analysis" →
+ * "peripheral". Gaps between the weights are intentional: a kit can interleave
+ * its own categories (or override these) without editing this table.
+ */
 declare const DEFAULT_CATEGORIES_ORDER: Record<string, number>;
 declare const DEFAULT_STATE_USER_SETTINGS: () => DevframeDocksUserSettings;
 //#endregion

package/dist/constants.mjs

@@ -1,11 +1,25 @@
 export * from "devframe/constants";
 //#region src/constants.ts
+/**
+* The default ordering weight for each known dock category — lower sorts
+* earlier. Downstream viewers (e.g. `@vitejs/devtools-kit`) import this as the
+* single source of truth so the hub and its viewers agree on category order.
+* `framework` sorts first; `~builtin` (the viewer's own built-in views) last.
+*
+* The buckets read from "closest to your app" → "platform / analysis" →
+* "peripheral". Gaps between the weights are intentional: a kit can interleave
+* its own categories (or override these) without editing this table.
+*/
 const DEFAULT_CATEGORIES_ORDER = {
+	"framework": -100,
 	"default": 0,
 	"app": 100,
-	"framework": 200,
+	"ui": 150,
+	"data": 250,
 	"web": 300,
+	"performance": 350,
 	"advanced": 400,
+	"docs": 500,
 	"~builtin": 1e3
 };
 const DEFAULT_STATE_USER_SETTINGS = () => ({

package/dist/{context-CNKFzYdA.d.mts → context-BBf7f_8F.d.mts}

@@ -1,4 +1,4 @@
-import { F as JsonRenderer, P as JsonRenderSpec, S as DevframeDocksHost, c as DevframeCommandsHost, p as DevframeDockActivation, v as DevframeDockEntryIcon } from "./settings-C5cAtNdE.mjs";
+import { F as JsonRenderer, P as JsonRenderSpec, S as DevframeDocksHost, c as DevframeCommandsHost, p as DevframeDockActivation, v as DevframeDockEntryIcon } from "./settings-Chx2aDL_.mjs";
 import { CreateHostContextOptions } from "devframe/node";
 import { DevframeHost, DevframeNodeContext, EventEmitter } from "devframe/types";
 import { ChildProcess } from "node:child_process";

package/dist/{index-BeoLMW0z.d.mts → index-CREpXwAf.d.mts}

@@ -1,5 +1,5 @@
-import "./context-CNKFzYdA.mjs";
-import "./settings-C5cAtNdE.mjs";
+import "./settings-Chx2aDL_.mjs";
+import "./context-BBf7f_8F.mjs";
 import { RpcDefinitionsFilter, RpcDefinitionsToFunctions } from "devframe/rpc";
 import { ConnectionMeta as ConnectionMeta$1, DevframeCapabilities, DevframeDiagnosticsDefinition, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeHost as DevframeHost$1, DevframeNodeRpcSession, DevframeRpcClientFunctions, DevframeRpcServerFunctions, DevframeRpcSharedStates, DevframeViewHost, EntriesToObject, EventEmitter as EventEmitter$1, EventUnsubscribe, EventsMap, PartialWithoutId, RpcBroadcastOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, Thenable } from "devframe/types";
 export { RpcStreamingChannel as C, Thenable as E, RpcSharedStateHost as S, RpcStreamingHost as T, RpcBroadcastOptions as _, DevframeDiagnosticsLogger as a, RpcFunctionsHost as b, DevframeRpcClientFunctions as c, DevframeViewHost as d, EntriesToObject as f, PartialWithoutId as g, EventsMap as h, DevframeDiagnosticsHost as i, DevframeRpcServerFunctions as l, EventUnsubscribe as m, DevframeCapabilities as n, DevframeHost$1 as o, EventEmitter$1 as p, DevframeDiagnosticsDefinition as r, DevframeNodeRpcSession as s, ConnectionMeta$1 as t, DevframeRpcSharedStates as u, RpcDefinitionsFilter as v, RpcStreamingChannelOptions as w, RpcSharedStateGetOptions as x, RpcDefinitionsToFunctions as y };

package/dist/index.d.mts

@@ -1,6 +1,7 @@
-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-CNKFzYdA.mjs";
-import { A as DevframeViewLauncherStatus, C as DevframeViewAction, D as DevframeViewIframe, E as DevframeViewGroup, F as JsonRenderer, M as RemoteDockOptions, N as JsonRenderElement, O as DevframeViewJsonRender, P as JsonRenderSpec, S as DevframeDocksHost, T as DevframeViewCustomRender, _ as DevframeDockEntryCategory, a as DevframeCommandHandle, b as DevframeDockUserEntry, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as ClientScriptEntry, g as DevframeDockEntryBase, h as DevframeDockEntry, i as DevframeCommandEntry, j as RemoteConnectionInfo, k as DevframeViewLauncher, l as DevframeCommandsHostEvents, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockActivation, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockEntryIcon, w as DevframeViewBuiltin, x as DevframeDocksActiveState, y as DevframeDockEntryRegistry } from "./settings-C5cAtNdE.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-BeoLMW0z.mjs";
+import { A as DevframeViewLauncherStatus, C as DevframeViewAction, D as DevframeViewIframe, E as DevframeViewGroup, F as JsonRenderer, M as RemoteDockOptions, N as JsonRenderElement, O as DevframeViewJsonRender, P as JsonRenderSpec, S as DevframeDocksHost, T as DevframeViewCustomRender, _ as DevframeDockEntryCategory, a as DevframeCommandHandle, b as DevframeDockUserEntry, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as ClientScriptEntry, g as DevframeDockEntryBase, h as DevframeDockEntry, i as DevframeCommandEntry, j as RemoteConnectionInfo, k as DevframeViewLauncher, l as DevframeCommandsHostEvents, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockActivation, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockEntryIcon, w as DevframeViewBuiltin, x as DevframeDocksActiveState, y as DevframeDockEntryRegistry } from "./settings-Chx2aDL_.mjs";
+import { DEFAULT_CATEGORIES_ORDER } from "./constants.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-BBf7f_8F.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-CREpXwAf.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>;
@@ -19,4 +20,4 @@ declare function defineDockEntry<const T extends DevframeDockUserEntry, const W
  */
 declare function defineJsonRenderSpec(spec: JsonRenderSpec): JsonRenderSpec;
 //#endregion
-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 DevframeDockActivation, type DevframeDockEntriesGrouped, type DevframeDockEntry, type DevframeDockEntryBase, type DevframeDockEntryCategory, type DevframeDockEntryIcon, type DevframeDockEntryRegistry, type DevframeDockUserEntry, type DevframeDocksActiveState, 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, DEFAULT_CATEGORIES_ORDER, 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 DevframeDockActivation, type DevframeDockEntriesGrouped, type DevframeDockEntry, type DevframeDockEntryBase, type DevframeDockEntryCategory, type DevframeDockEntryIcon, type DevframeDockEntryRegistry, type DevframeDockUserEntry, type DevframeDocksActiveState, 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/index.mjs

@@ -1,2 +1,3 @@
+import { DEFAULT_CATEGORIES_ORDER } from "./constants.mjs";
 import { i as defineJsonRenderSpec, n as defineDockEntry, r as defineHubRpcFunction, t as defineCommand } from "./define-Pbx8dsKz.mjs";
-export { defineCommand, defineDockEntry, defineHubRpcFunction, defineJsonRenderSpec };
+export { DEFAULT_CATEGORIES_ORDER, defineCommand, defineDockEntry, defineHubRpcFunction, defineJsonRenderSpec };

package/dist/node/index.d.mts

@@ -1,5 +1,6 @@
-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-CNKFzYdA.mjs";
-import { D as DevframeViewIframe, S as DevframeDocksHost$1, a as DevframeCommandHandle, b as DevframeDockUserEntry, c as DevframeCommandsHost$1, d as DevframeServerCommandInput, f as ClientScriptEntry, h as DevframeDockEntry, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry } from "../settings-C5cAtNdE.mjs";
+import { D as DevframeViewIframe, S as DevframeDocksHost$1, a as DevframeCommandHandle, b as DevframeDockUserEntry, c as DevframeCommandsHost$1, d as DevframeServerCommandInput, f as ClientScriptEntry, h as DevframeDockEntry, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry } from "../settings-Chx2aDL_.mjs";
+import { DEFAULT_CATEGORIES_ORDER } from "../constants.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-BBf7f_8F.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { DevframeDefinition } from "devframe/types";
 import { SharedState } from "devframe/utils/shared-state";
@@ -382,4 +383,4 @@ declare const builtinHubRpcDeclarations: readonly RpcFunctionDefinitionAny[];
  */
 declare function createSimpleClientScript(fn: string | ((ctx: any) => void)): ClientScriptEntry;
 //#endregion
-export { CreateHubContextOptions, DevframeCommandsHost, DevframeDocksHost, DevframeHubContext, DevframeMessagesHost, DevframeTerminalsHost, MountDevframeOptions, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, hubDocksActivate, hubMessagesAdd, hubMessagesClear, hubMessagesRemove, hubMessagesUpdate, hubTerminalsRemove, hubTerminalsResize, hubTerminalsRestart, hubTerminalsTerminate, hubTerminalsWrite, mountDevframe };
+export { CreateHubContextOptions, DEFAULT_CATEGORIES_ORDER, DevframeCommandsHost, DevframeDocksHost, DevframeHubContext, DevframeMessagesHost, DevframeTerminalsHost, MountDevframeOptions, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, hubDocksActivate, hubMessagesAdd, hubMessagesClear, hubMessagesRemove, hubMessagesUpdate, hubTerminalsRemove, hubTerminalsResize, hubTerminalsRestart, hubTerminalsTerminate, hubTerminalsWrite, mountDevframe };

package/dist/node/index.mjs

@@ -1,5 +1,5 @@
+import { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS } from "../constants.mjs";
 import { r as defineHubRpcFunction } from "../define-Pbx8dsKz.mjs";
-import { DEFAULT_STATE_USER_SETTINGS } from "../constants.mjs";
 import { REMOTE_CONNECTION_KEY } from "devframe/constants";
 import { createEventEmitter } from "devframe/utils/events";
 import { createHostContext, createStorage } from "devframe/node";
@@ -6611,4 +6611,4 @@ function createSimpleClientScript(fn) {
 	};
 }
 //#endregion
-export { DevframeCommandsHost, DevframeDocksHost, DevframeMessagesHost, DevframeTerminalsHost, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, hubDocksActivate, hubMessagesAdd, hubMessagesClear, hubMessagesRemove, hubMessagesUpdate, hubTerminalsRemove, hubTerminalsResize, hubTerminalsRestart, hubTerminalsTerminate, hubTerminalsWrite, mountDevframe };
+export { DEFAULT_CATEGORIES_ORDER, DevframeCommandsHost, DevframeDocksHost, DevframeMessagesHost, DevframeTerminalsHost, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, hubDocksActivate, hubMessagesAdd, hubMessagesClear, hubMessagesRemove, hubMessagesUpdate, hubTerminalsRemove, hubTerminalsResize, hubTerminalsRestart, hubTerminalsTerminate, hubTerminalsWrite, mountDevframe };

package/dist/{settings-C5cAtNdE.d.mts → settings-Chx2aDL_.d.mts}

@@ -76,7 +76,7 @@ interface DevframeDockActivation {
 interface DevframeDocksActiveState {
   activation: DevframeDockActivation | null;
 }
-type DevframeDockEntryCategory = 'app' | 'framework' | 'web' | 'advanced' | 'default' | '~builtin' | (string & {});
+type DevframeDockEntryCategory = 'framework' | 'app' | 'ui' | 'data' | 'web' | 'performance' | 'advanced' | 'docs' | 'default' | '~builtin' | (string & {});
 type DevframeDockEntryIcon = string | {
   light: string;
   dark: string;
@@ -92,7 +92,19 @@ interface DevframeDockEntryBase {
    */
   defaultOrder?: number;
   /**
-   * The category of the entry
+   * The category of the entry — a field with a dual role that depends on
+   * whether {@link groupId} resolves to a registered {@link DevframeViewGroup}:
+   *
+   * - **Ungrouped (or orphan) entry** — `category` is the entry's OUTER bucket
+   *   on the dock bar, ordered by {@link import('../constants').DEFAULT_CATEGORIES_ORDER}.
+   * - **Grouped entry** (a `groupId` that resolves to a registered group) —
+   *   the OUTER bucket is instead the group's own `category`, and this field is
+   *   reinterpreted as the entry's IN-GROUP sub-category, used to sub-divide and
+   *   sort members inside the group's popover / sub-navigation.
+   *
+   * Falls back to `'default'` when omitted — both as an outer bucket and, for a
+   * grouped member, as its in-group sub-bucket.
+   *
    * @default 'default'
    */
   category?: DevframeDockEntryCategory;
@@ -118,8 +130,14 @@ interface DevframeDockEntryBase {
    *
    * This is a flat pointer — membership, not containment. The entry stays an
    * independently-registered, top-level entry; only its rendering is grouped
-   * downstream. If the referenced group is never registered, the entry renders
-   * as a normal top-level entry (orphan tolerance).
+   * downstream.
+   *
+   * When the referenced group **is** registered, it supplies the entry's OUTER
+   * dock-bar category (the group's own {@link category}), and this entry's own
+   * {@link category} is reinterpreted as its IN-GROUP sub-category. When the
+   * referenced group is **never** registered, the entry renders as a normal
+   * top-level entry and falls back to using its own {@link category} as the
+   * outer bucket (orphan tolerance).
    *
    * @see {@link DevframeViewGroup}
    */
@@ -282,6 +300,12 @@ interface DevframeViewJsonRender extends DevframeDockEntryBase {
  * through the same `register`/`update`/`values` machinery as every other entry,
  * keyed by `id`.
  *
+ * The group's `category` is the OUTER bucket for the group button itself AND
+ * for every one of its members — a member's own `category` no longer decides
+ * its outer bucket, but is reinterpreted as an in-group sub-category that
+ * sub-divides and sorts members inside this group. A group with no `category`
+ * buckets itself and its members under `'default'`.
+ *
  * Grouping is one level deep: a group entry must not itself set `groupId`.
  */
 interface DevframeViewGroup extends DevframeDockEntryBase {

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-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-CNKFzYdA.mjs";
-import { A as DevframeViewLauncherStatus, C as DevframeViewAction, D as DevframeViewIframe, E as DevframeViewGroup, F as JsonRenderer, M as RemoteDockOptions, N as JsonRenderElement, O as DevframeViewJsonRender, P as JsonRenderSpec, S as DevframeDocksHost, T as DevframeViewCustomRender, _ as DevframeDockEntryCategory, a as DevframeCommandHandle, b as DevframeDockUserEntry, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as ClientScriptEntry, g as DevframeDockEntryBase, h as DevframeDockEntry, i as DevframeCommandEntry, j as RemoteConnectionInfo, k as DevframeViewLauncher, l as DevframeCommandsHostEvents, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockActivation, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockEntryIcon, w as DevframeViewBuiltin, x as DevframeDocksActiveState, y as DevframeDockEntryRegistry } from "../settings-C5cAtNdE.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-BeoLMW0z.mjs";
+import { A as DevframeViewLauncherStatus, C as DevframeViewAction, D as DevframeViewIframe, E as DevframeViewGroup, F as JsonRenderer, M as RemoteDockOptions, N as JsonRenderElement, O as DevframeViewJsonRender, P as JsonRenderSpec, S as DevframeDocksHost, T as DevframeViewCustomRender, _ as DevframeDockEntryCategory, a as DevframeCommandHandle, b as DevframeDockUserEntry, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as ClientScriptEntry, g as DevframeDockEntryBase, h as DevframeDockEntry, i as DevframeCommandEntry, j as RemoteConnectionInfo, k as DevframeViewLauncher, l as DevframeCommandsHostEvents, m as DevframeDockEntriesGrouped, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockActivation, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockEntryIcon, w as DevframeViewBuiltin, x as DevframeDocksActiveState, y as DevframeDockEntryRegistry } from "../settings-Chx2aDL_.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-BBf7f_8F.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-CREpXwAf.mjs";
 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, DevframeDockActivation, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockEntryRegistry, DevframeDockUserEntry, DevframeDocksActiveState, 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.7.9",
+  "version": "0.7.10",
   "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.7.9"
+    "devframe": "0.7.10"
   },
   "dependencies": {
     "birpc": "^4.0.0",
@@ -48,7 +48,7 @@
     "@types/node": "^26.1.1",
     "mlly": "^1.8.2",
     "tsdown": "^0.22.12",
-    "devframe": "0.7.9"
+    "devframe": "0.7.10"
   },
   "scripts": {
     "build": "tsdown",