@devframes/hub 0.9.0 → 0.9.2

package/dist/client/index.d.mts

@@ -1,11 +1,35 @@
-import { E as DevframeMessagesClient, x as DevframeMessageEntryInput } from "../context-D5TJIHwp.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-DfrRa9Wf.mjs";
-import "../index-coDmWngQ.mjs";
+import { E as DevframeMessagesClient, x as DevframeMessageEntryInput } from "../context-BVkxwz5k.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 { 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";
 import { WhenContext } from "devframe/utils/when";
 export * from "devframe/client";
+//#region src/client-modules.d.ts
+/**
+ * Resolve a dock client script's `importFrom` to the URL to import. URL
+ * specifiers pass through untouched; a **bare** specifier resolves through
+ * the explicit `resolveClientModule` callback (a viewer's own policy), then
+ * the host-advertised `template` (`ConnectionMeta.configs.dock.clientModuleResolution`,
+ * its `{specifier}` token replaced — e.g. Vite's `'/@id/{specifier}'`),
+ * resolved against `metaBaseUrl` so it targets the host's origin from any
+ * viewer. With neither, it stays unchanged — a page import map may still
+ * cover it.
+ */
+declare function resolveClientModuleSpecifier(specifier: string, options?: {
+  resolveClientModule?: (specifier: string) => string | undefined;
+  template?: string;
+  metaBaseUrl?: string;
+}): string;
+/**
+ * Diagnose a failed client-script import: name the likely cause instead of
+ * leaving only the browser's opaque `TypeError`. `importFrom` is the entry's
+ * declared specifier, `specifier` what was actually imported (after
+ * {@link resolveClientModuleSpecifier}).
+ */
+declare function clientScriptFailureHint(importFrom: string, specifier: string): string;
+//#endregion
 //#region src/client/renderers.d.ts
 /**
  * Options handed to a dock renderer when the client host mounts a dock entry.
@@ -478,7 +502,7 @@ declare function watchFrameLocation(options: WatchFrameLocationOptions): () => v
  * decoupled — the embedded app takes no hub/RPC dependency, only the shim.
  */
 /** `postMessage` channel tag shared by both halves of the protocol. */
-declare const FRAME_NAV_CHANNEL = "devframe:frame-nav";
+declare const FRAME_NAV_CHANNEL: string;
 /** Protocol version. */
 declare const FRAME_NAV_VERSION = 1;
 /** Envelope every frame-nav message carries. */
@@ -599,6 +623,15 @@ interface DevframeClientHostOptions {
    * `custom-render`, and iframe `clientScript`). Default `true`.
    */
   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
+   * 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:
+   * `resolveClientModule: s => `/@id/${s}``.
+   */
+  resolveClientModule?: (specifier: string) => string | undefined;
   /**
    * Dock renderers to register at boot, keyed by dock `type`. The host
    * application injects the ones it wants (e.g.
@@ -698,4 +731,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, connectRemoteDevframe, createDevframeClientHost, createDockRenderersContext, createMessagesClient, getDevframeClientContext, parseRemoteConnection, resolveDockIcon, resolveDockUrl, setDevframeClientContext, stripRemoteConnectionFromUrl, watchFrameLocation };
+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 };

package/dist/client/index.mjs

@@ -1,5 +1,5 @@
-import { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DOCK_RENDERERS_STATE_KEY } from "../constants.mjs";
-import { n as stripRemoteConnectionFromUrl, t as buildRemoteConnectionUrl } from "../remote-url-KVXtKP47.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-C2b2cACy.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";
 import { createEventEmitter } from "devframe/utils/events";
@@ -172,7 +172,7 @@ function watchFrameLocation(options) {
 * decoupled — the embedded app takes no hub/RPC dependency, only the shim.
 */
 /** `postMessage` channel tag shared by both halves of the protocol. */
-const FRAME_NAV_CHANNEL = "devframe:frame-nav";
+const FRAME_NAV_CHANNEL = HUB_EVENTS.postMessage.frameNav;
 /** Protocol version. */
 const FRAME_NAV_VERSION = 1;
 /**
@@ -203,16 +203,14 @@ function attachFrameNavClient(options) {
 		if (disposed) return;
 		if (expectedOrigin !== "*" && ev.origin !== expectedOrigin) return;
 		const data = ev.data;
-		if (!data || data.channel !== "devframe:frame-nav" || data.v !== 1 || data.frameId !== frameId || data.from !== "frame") return;
+		if (!data || data.channel !== FRAME_NAV_CHANNEL || data.v !== 1 || data.frameId !== frameId || data.from !== "frame") return;
 		switch (data.type) {
 			case "ready":
 			case "manifest":
 				markReady();
 				reconcileManifest(data.tabs ?? [], data.current);
 				break;
-			case "navigated":
-				onNavigated(data.tabId);
-				break;
+			case "navigated": onNavigated(data.tabId);
 		}
 	}
 	function markReady() {
@@ -498,10 +496,10 @@ function createDockRenderersContext(options) {
 }
 //#endregion
 //#region src/client/host.ts
-const DOCKS_STATE_KEY = "devframe:docks";
-const COMMANDS_STATE_KEY = "devframe:commands";
-const USER_SETTINGS_STATE_KEY = "devframe:user-settings";
-const DOCKS_ACTIVATE_EVENT = "devframe:docks:activate";
+const DOCKS_STATE_KEY = HUB_EVENTS.sharedState.docks;
+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
 * {@link DevframeClientContext} (panel, docks, commands, when) from the hub's
@@ -798,12 +796,17 @@ async function createDevframeClientHost(options = {}) {
 		}
 	}
 	async function runClientScript(entryId, script) {
+		const specifier = resolveClientModuleSpecifier(script.importFrom, {
+			resolveClientModule: options.resolveClientModule,
+			template: rpc.connectionMeta?.configs?.dock?.clientModuleResolution,
+			metaBaseUrl: rpc.connection?.metaBaseUrl
+		});
 		try {
 			const fn = (await import(
 				/* @vite-ignore */
 				/* webpackIgnore: true */
 				/* turbopackIgnore: true */
-				script.importFrom
+				specifier
 ))[script.importName ?? "default"];
 			if (typeof fn !== "function") return;
 			const current = entryToStateMap.get(entryId);
@@ -816,7 +819,7 @@ async function createDevframeClientHost(options = {}) {
 			});
 		} catch (error) {
 			loadedScripts.delete(entryId);
-			console.error(`[@devframes/hub] failed to load client script for "${entryId}" from ${script.importFrom}`, error);
+			console.error(`[@devframes/hub] failed to load client script for "${entryId}" from ${specifier}${clientScriptFailureHint(script.importFrom, specifier)}`, error);
 		}
 	}
 }
@@ -883,10 +886,11 @@ function buildRemoteDevframeUrl(url, connection) {
 	} catch {
 		return url;
 	}
+	const websocket = resolveWsUrl(connection.connectionMeta.websocket, connection.metaBaseUrl, base);
 	return buildRemoteConnectionUrl(url, {
 		v: 1,
 		backend: "websocket",
-		websocket: resolveWsUrl(connection.connectionMeta.websocket, connection.metaBaseUrl, base),
+		websocket,
 		authToken: connection.authToken,
 		origin: base.origin
 	});
@@ -967,4 +971,4 @@ async function connectRemoteDevframe(options = {}) {
 	});
 }
 //#endregion
-export { CLIENT_CONTEXT_KEY, FRAME_NAV_CHANNEL, FRAME_NAV_VERSION, attachFrameNavClient, buildRemoteDevframeUrl, connectRemoteDevframe, createDevframeClientHost, createDockRenderersContext, createMessagesClient, getDevframeClientContext, parseRemoteConnection, resolveDockIcon, resolveDockUrl, setDevframeClientContext, stripRemoteConnectionFromUrl, watchFrameLocation };
+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 };

package/dist/constants-C2b2cACy.mjs

@@ -0,0 +1,120 @@
+import { cleanDoubleSlashes, withLeadingSlash, withTrailingSlash } from "ufo";
+//#region src/events.ts
+/**
+* Centralized registry of every event, broadcast, RPC method, shared-state
+* 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/guide/events.md`](../../../docs/guide/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
+* instead of re-typing a literal.
+*
+* The `.events` EventEmitter maps in `types/{docks,terminals,messages,commands}.ts`
+* and the RPC augmentation interfaces in `node/context.ts` declare these same
+* names as type-level keys (a literal is unavoidable in a type position); those
+* declarations mirror this map and move with it.
+*/
+const HUB_EVENTS = {
+	/**
+	* Internal node `EventEmitter` events on `ctx.<subsystem>.events`. Emitted
+	* and consumed inside the node process (chiefly by `createHubContext`, which
+	* fans them out onto the wire); they never cross to the browser.
+	*/
+	bus: {
+		docksEntryUpdated: "docks:entry:updated",
+		docksActivate: "docks:activate",
+		terminalsSessionUpdated: "terminals:session:updated",
+		messagesAdded: "messages:added",
+		messagesUpdated: "messages:updated",
+		messagesRemoved: "messages:removed",
+		messagesCleared: "messages:cleared",
+		commandsRegistered: "commands:registered",
+		commandsUnregistered: "commands:unregistered"
+	},
+	/** Server RPC methods a connected client calls (client → server), `hub:` prefix. */
+	rpc: {
+		docksActivate: "hub:docks:activate",
+		commandsExecute: "hub:commands:execute",
+		messagesAdd: "hub:messages:add",
+		messagesUpdate: "hub:messages:update",
+		messagesRemove: "hub:messages:remove",
+		messagesClear: "hub:messages:clear",
+		terminalsWrite: "hub:terminals:write",
+		terminalsResize: "hub:terminals:resize",
+		terminalsTerminate: "hub:terminals:terminate",
+		terminalsRestart: "hub:terminals:restart",
+		terminalsRemove: "hub:terminals:remove"
+	},
+	/** Broadcast notifications the server pushes to clients (server → client), `devframe:` prefix. */
+	broadcast: {
+		docksActivate: "devframe:docks:activate",
+		terminalsUpdated: "devframe:terminals:updated",
+		messagesUpdated: "devframe:messages:updated"
+	},
+	/** Shared-state slot keys a hub-aware client reads (server → client), `devframe:` prefix. */
+	sharedState: {
+		docks: "devframe:docks",
+		docksActive: "devframe:docks:active",
+		commands: "devframe:commands",
+		userSettings: "devframe:user-settings",
+		dockRenderers: "devframe:dock-renderers"
+	},
+	/** Streaming channel ids (server → client), `devframe:` prefix. */
+	stream: { terminals: "devframe:terminals" },
+	/** `postMessage` channels for host ↔ iframe protocols, `devframe:` prefix. */
+	postMessage: { frameNav: "devframe:frame-nav" }
+};
+//#endregion
+//#region src/constants.ts
+/** Default mount base for a hub instance — one namespace, one catch-all. */
+const DEVFRAMES_HUB_BASE = "/__devframes/";
+/**
+* Normalize a hub mount base to an absolute path with leading and trailing
+* slashes (e.g. `devframes` → `/devframes/`), collapsing any doubled
+* slashes the input introduced. The one implementation every hub-aware
+* host (`@devframes/hub` itself, and the Vite/Nuxt/Next adapters) resolves
+* `options.base` through.
+*/
+function normalizeHubBase(base) {
+	return cleanDoubleSlashes(withTrailingSlash(withLeadingSlash(base)));
+}
+/**
+* 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,
+	"ui": 150,
+	"data": 250,
+	"web": 300,
+	"performance": 350,
+	"advanced": 400,
+	"docs": 500,
+	"~builtin": 1e3
+};
+/**
+* Shared-state slot carrying the hub's renderer manifest — one
+* {@link import('./client/renderers').DockRendererManifest} entry per dock
+* `type`, published by `initHub({ renderers })` and consumed by every
+* hub-aware client (the headless client host and viewers alike).
+*/
+const DOCK_RENDERERS_STATE_KEY = HUB_EVENTS.sharedState.dockRenderers;
+const DEFAULT_STATE_USER_SETTINGS = () => ({
+	docksHidden: [],
+	docksCategoriesHidden: [],
+	docksPinned: [],
+	docksCustomOrder: {},
+	commandShortcuts: {}
+});
+//#endregion
+export { normalizeHubBase as a, DOCK_RENDERERS_STATE_KEY as i, DEFAULT_STATE_USER_SETTINGS as n, HUB_EVENTS as o, DEVFRAMES_HUB_BASE as r, DEFAULT_CATEGORIES_ORDER as t };

package/dist/constants-CmESZCBq.d.mts

@@ -0,0 +1,105 @@
+import { t as DevframeDocksUserSettings } from "./settings-D7whfcx2.mjs";
+//#region src/events.d.ts
+/**
+ * Centralized registry of every event, broadcast, RPC method, shared-state
+ * 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/guide/events.md`](../../../docs/guide/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
+ * instead of re-typing a literal.
+ *
+ * The `.events` EventEmitter maps in `types/{docks,terminals,messages,commands}.ts`
+ * and the RPC augmentation interfaces in `node/context.ts` declare these same
+ * names as type-level keys (a literal is unavoidable in a type position); those
+ * declarations mirror this map and move with it.
+ */
+declare const HUB_EVENTS: {
+  /**
+   * Internal node `EventEmitter` events on `ctx.<subsystem>.events`. Emitted
+   * and consumed inside the node process (chiefly by `createHubContext`, which
+   * fans them out onto the wire); they never cross to the browser.
+   */
+  readonly bus: {
+    readonly docksEntryUpdated: "docks:entry:updated";
+    readonly docksActivate: "docks:activate";
+    readonly terminalsSessionUpdated: "terminals:session:updated";
+    readonly messagesAdded: "messages:added";
+    readonly messagesUpdated: "messages:updated";
+    readonly messagesRemoved: "messages:removed";
+    readonly messagesCleared: "messages:cleared";
+    readonly commandsRegistered: "commands:registered";
+    readonly commandsUnregistered: "commands:unregistered";
+  };
+  /** Server RPC methods a connected client calls (client → server), `hub:` prefix. */
+  readonly rpc: {
+    readonly docksActivate: "hub:docks:activate";
+    readonly commandsExecute: "hub:commands:execute";
+    readonly messagesAdd: "hub:messages:add";
+    readonly messagesUpdate: "hub:messages:update";
+    readonly messagesRemove: "hub:messages:remove";
+    readonly messagesClear: "hub:messages:clear";
+    readonly terminalsWrite: "hub:terminals:write";
+    readonly terminalsResize: "hub:terminals:resize";
+    readonly terminalsTerminate: "hub:terminals:terminate";
+    readonly terminalsRestart: "hub:terminals:restart";
+    readonly terminalsRemove: "hub:terminals:remove";
+  };
+  /** Broadcast notifications the server pushes to clients (server → client), `devframe:` prefix. */
+  readonly broadcast: {
+    readonly docksActivate: "devframe:docks:activate";
+    readonly terminalsUpdated: "devframe:terminals:updated";
+    readonly messagesUpdated: "devframe:messages:updated";
+  };
+  /** Shared-state slot keys a hub-aware client reads (server → client), `devframe:` prefix. */
+  readonly sharedState: {
+    readonly docks: "devframe:docks";
+    readonly docksActive: "devframe:docks:active";
+    readonly commands: "devframe:commands";
+    readonly userSettings: "devframe:user-settings";
+    readonly dockRenderers: "devframe:dock-renderers";
+  };
+  /** Streaming channel ids (server → client), `devframe:` prefix. */
+  readonly stream: {
+    readonly terminals: "devframe:terminals";
+  };
+  /** `postMessage` channels for host ↔ iframe protocols, `devframe:` prefix. */
+  readonly postMessage: {
+    readonly frameNav: "devframe:frame-nav";
+  };
+};
+//#endregion
+//#region src/constants.d.ts
+/** Default mount base for a hub instance — one namespace, one catch-all. */
+declare const DEVFRAMES_HUB_BASE = "/__devframes/";
+/**
+ * Normalize a hub mount base to an absolute path with leading and trailing
+ * slashes (e.g. `devframes` → `/devframes/`), collapsing any doubled
+ * slashes the input introduced. The one implementation every hub-aware
+ * host (`@devframes/hub` itself, and the Vite/Nuxt/Next adapters) resolves
+ * `options.base` through.
+ */
+declare function normalizeHubBase(base: string): string;
+/**
+ * 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>;
+/**
+ * Shared-state slot carrying the hub's renderer manifest — one
+ * {@link import('./client/renderers').DockRendererManifest} entry per dock
+ * `type`, published by `initHub({ renderers })` and consumed by every
+ * hub-aware client (the headless client host and viewers alike).
+ */
+declare const DOCK_RENDERERS_STATE_KEY: string;
+declare const DEFAULT_STATE_USER_SETTINGS: () => DevframeDocksUserSettings;
+//#endregion
+export { normalizeHubBase as a, DOCK_RENDERERS_STATE_KEY as i, DEFAULT_STATE_USER_SETTINGS as n, HUB_EVENTS as o, DEVFRAMES_HUB_BASE as r, DEFAULT_CATEGORIES_ORDER as t };

package/dist/constants.d.mts

@@ -1,34 +1,3 @@
-import { t as DevframeDocksUserSettings } from "./settings-DfrRa9Wf.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-CmESZCBq.mjs";
 export * from "devframe/constants";
-//#region src/constants.d.ts
-/** Default mount base for a hub instance — one namespace, one catch-all. */
-declare const DEVFRAMES_HUB_BASE = "/__devframes/";
-/**
- * Normalize a hub mount base to an absolute path with leading and trailing
- * slashes (e.g. `devframes` → `/devframes/`), collapsing any doubled
- * slashes the input introduced. The one implementation every hub-aware
- * host (`@devframes/hub` itself, and the Vite/Nuxt/Next adapters) resolves
- * `options.base` through.
- */
-declare function normalizeHubBase(base: string): string;
-/**
- * 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>;
-/**
- * Shared-state slot carrying the hub's renderer manifest — one
- * {@link import('./client/renderers').DockRendererManifest} entry per dock
- * `type`, published by `initHub({ renderers })` and consumed by every
- * hub-aware client (the headless client host and viewers alike).
- */
-declare const DOCK_RENDERERS_STATE_KEY = "devframe:dock-renderers";
-declare const DEFAULT_STATE_USER_SETTINGS: () => DevframeDocksUserSettings;
-//#endregion
-export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, normalizeHubBase };
+export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, HUB_EVENTS, normalizeHubBase };

package/dist/constants.mjs

@@ -1,53 +1,3 @@
-import { cleanDoubleSlashes, withLeadingSlash, withTrailingSlash } from "ufo";
+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-C2b2cACy.mjs";
 export * from "devframe/constants";
-//#region src/constants.ts
-/** Default mount base for a hub instance — one namespace, one catch-all. */
-const DEVFRAMES_HUB_BASE = "/__devframes/";
-/**
-* Normalize a hub mount base to an absolute path with leading and trailing
-* slashes (e.g. `devframes` → `/devframes/`), collapsing any doubled
-* slashes the input introduced. The one implementation every hub-aware
-* host (`@devframes/hub` itself, and the Vite/Nuxt/Next adapters) resolves
-* `options.base` through.
-*/
-function normalizeHubBase(base) {
-	return cleanDoubleSlashes(withTrailingSlash(withLeadingSlash(base)));
-}
-/**
-* 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,
-	"ui": 150,
-	"data": 250,
-	"web": 300,
-	"performance": 350,
-	"advanced": 400,
-	"docs": 500,
-	"~builtin": 1e3
-};
-/**
-* Shared-state slot carrying the hub's renderer manifest — one
-* {@link import('./client/renderers').DockRendererManifest} entry per dock
-* `type`, published by `initHub({ renderers })` and consumed by every
-* hub-aware client (the headless client host and viewers alike).
-*/
-const DOCK_RENDERERS_STATE_KEY = "devframe:dock-renderers";
-const DEFAULT_STATE_USER_SETTINGS = () => ({
-	docksHidden: [],
-	docksCategoriesHidden: [],
-	docksPinned: [],
-	docksCustomOrder: {},
-	commandShortcuts: {}
-});
-//#endregion
-export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, normalizeHubBase };
+export { DEFAULT_CATEGORIES_ORDER, DEFAULT_STATE_USER_SETTINGS, DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, HUB_EVENTS, normalizeHubBase };

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

@@ -1,4 +1,4 @@
-import { b as DevframeDockEntryIcon, k as DevframeViewIframe, l as DevframeCommandsHost, m as DevframeDockActivation, w as DevframeDocksHost } from "./settings-DfrRa9Wf.mjs";
+import { b as DevframeDockEntryIcon, k as DevframeViewIframe, l as DevframeCommandsHost, m as DevframeDockActivation, w as DevframeDocksHost } from "./settings-D7whfcx2.mjs";
 import { CreateHostContextOptions } from "devframe/node";
 import { DevframeDefinition, DevframeHost, DevframeNodeContext, EventEmitter } from "devframe/types";
 import { ChildProcess } from "node:child_process";
@@ -207,10 +207,10 @@ interface DevframeMessagesListDelta {
 interface DevframeMessagesHost extends DevframeMessagesLevelShortcuts {
   readonly entries: Map<string, DevframeMessageEntry>;
   readonly events: EventEmitter<{
-    'message:added': (entry: DevframeMessageEntry) => void;
-    'message:updated': (entry: DevframeMessageEntry) => void;
-    'message:removed': (id: string) => void;
-    'message:cleared': () => void;
+    'messages:added': (entry: DevframeMessageEntry) => void;
+    'messages:updated': (entry: DevframeMessageEntry) => void;
+    'messages:removed': (id: string) => void;
+    'messages:cleared': () => void;
   }>;
   /**
    * Add a new message entry. If an entry with the same `id` already exists, it will be updated instead.
@@ -244,7 +244,7 @@ interface DevframeMessagesHost extends DevframeMessagesLevelShortcuts {
 interface DevframeTerminalsHost {
   readonly sessions: Map<string, DevframeTerminalSession>;
   readonly events: EventEmitter<{
-    'terminal:session:updated': (session: DevframeTerminalSession) => void;
+    'terminals:session:updated': (session: DevframeTerminalSession) => void;
   }>;
   register: (session: DevframeTerminalSession) => DevframeTerminalSession;
   update: (session: DevframeTerminalSession) => void;