@devframes/hub 0.9.0 → 0.9.2

package/dist/{context-DzqMQ2mI.mjs → context-TgU_TKiY.mjs}

@@ -1,6 +1,6 @@
 import { r as defineHubRpcFunction } from "./define-Ceekw2EO.mjs";
-import { DEFAULT_STATE_USER_SETTINGS } from "./constants.mjs";
-import { t as buildRemoteConnectionUrl } from "./remote-url-KVXtKP47.mjs";
+import { n as DEFAULT_STATE_USER_SETTINGS, o as HUB_EVENTS } from "./constants-C2b2cACy.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";
 import { getInternalContext, resolveBasePath } from "devframe/node/hub-internals";
@@ -74,6 +74,10 @@ const diagnostics = defineDiagnostics({
 			why: (p) => `Dock type "${p.type}" is not a servable renderer-module name — the hub serves each module at \`<base>__renderers/<type>.mjs\``,
 			fix: "Renderer types become URL segments, so they may only contain letters, digits, `_`, `-`, and `.`. Use a route-safe dock type (e.g. `json-render`)."
 		},
+		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)."
+		},
 		DF8200: { why: (p) => `Terminal session with id "${p.id}" already registered` },
 		DF8201: { why: (p) => `Terminal session with id "${p.id}" not registered` },
 		DF8202: {
@@ -152,7 +156,7 @@ var DevframeCommandsHost = class {
 		validateCommandIds(this.commands, command);
 		this.validateAgentExposure(command);
 		this.commands.set(command.id, command);
-		this.events.emit("command:registered", this.toSerializable(command));
+		this.events.emit(HUB_EVENTS.bus.commandsRegistered, this.toSerializable(command));
 		this.agentProvider?.notifyChanged();
 		return {
 			id: command.id,
@@ -168,7 +172,7 @@ var DevframeCommandsHost = class {
 				validateCommandIds(this.commands, next, existing.id);
 				this.validateAgentExposure(next);
 				Object.assign(existing, patch);
-				this.events.emit("command:registered", this.toSerializable(existing));
+				this.events.emit(HUB_EVENTS.bus.commandsRegistered, this.toSerializable(existing));
 				this.agentProvider?.notifyChanged();
 			},
 			unregister: () => this.unregister(command.id)
@@ -177,7 +181,7 @@ var DevframeCommandsHost = class {
 	unregister(id) {
 		const deleted = this.commands.delete(id);
 		if (deleted) {
-			this.events.emit("command:unregistered", id);
+			this.events.emit(HUB_EVENTS.bus.commandsUnregistered, id);
 			this.agentProvider?.notifyChanged();
 		}
 		return deleted;
@@ -259,7 +263,7 @@ var DevframeDocksHost = class {
 		this.context = context;
 	}
 	async init() {
-		this.userSettings = await this.context.rpc.sharedState.get("devframe:user-settings", { sharedState: createStorage({
+		this.userSettings = await this.context.rpc.sharedState.get(HUB_EVENTS.sharedState.userSettings, { sharedState: createStorage({
 			filepath: join(this.context.host.getStorageDir("project"), "settings.json"),
 			initialValue: DEFAULT_STATE_USER_SETTINGS()
 		}) });
@@ -290,9 +294,10 @@ var DevframeDocksHost = class {
 	register(view, force) {
 		if (this.views.has(view.id) && !force) throw diagnostics.DF8100({ id: view.id });
 		this.validateGroupMembership(view);
+		this.warnUnresolvableClientScript(view);
 		this.prepareRemoteRegistration(view);
 		this.views.set(view.id, view);
-		this.events.emit("dock:entry:updated", view);
+		this.events.emit(HUB_EVENTS.bus.docksEntryUpdated, view);
 		return { update: (patch) => {
 			if (patch.id && patch.id !== view.id) throw diagnostics.DF8101({
 				id: view.id,
@@ -309,15 +314,30 @@ var DevframeDocksHost = class {
 		this.validateGroupMembership(view);
 		this.prepareRemoteRegistration(view);
 		this.views.set(view.id, view);
-		this.events.emit("dock:entry:updated", view);
+		this.events.emit(HUB_EVENTS.bus.docksEntryUpdated, view);
 	}
 	activate(dockId, params) {
 		if (!this.views.has(dockId)) diagnostics.DF8107({ id: dockId });
-		this.events.emit("dock:activate", {
+		this.events.emit(HUB_EVENTS.bus.docksActivate, {
 			dockId,
 			params
 		});
 	}
+	/**
+	* Warn (don't throw — a viewer-side `resolveClientModule` 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
+	* doomed to fail there.
+	*/
+	warnUnresolvableClientScript(view) {
+		if (this.context.staticConfig?.dock?.clientModuleResolution) return;
+		const script = view.clientScript ?? view.action ?? view.renderer;
+		if (script?.importFrom && isBareModuleSpecifier(script.importFrom)) diagnostics.DF8111({
+			id: view.id,
+			specifier: script.importFrom
+		});
+	}
 	validateGroupMembership(view) {
 		if (view.groupId === void 0) return;
 		if (view.groupId === view.id) throw diagnostics.DF8103({ id: view.id });
@@ -395,7 +415,7 @@ var DevframeMessagesHost = class {
 		}
 		this.entries.set(entry.id, entry);
 		this.lastModified.set(entry.id, this._tick());
-		this.events.emit("message:added", entry);
+		this.events.emit(HUB_EVENTS.bus.messagesAdded, entry);
 		if (entry.autoDelete) this._autoDeleteTimers.set(entry.id, setTimeout(() => {
 			this.remove(entry.id);
 		}, entry.autoDelete));
@@ -413,7 +433,7 @@ var DevframeMessagesHost = class {
 		};
 		this.entries.set(id, updated);
 		this.lastModified.set(id, this._tick());
-		this.events.emit("message:updated", updated);
+		this.events.emit(HUB_EVENTS.bus.messagesUpdated, updated);
 		if (patch.autoDelete !== void 0) {
 			const timer = this._autoDeleteTimers.get(id);
 			if (timer) {
@@ -435,7 +455,7 @@ var DevframeMessagesHost = class {
 		this.entries.delete(id);
 		this.lastModified.delete(id);
 		this._recordRemoval(id, this._tick());
-		this.events.emit("message:removed", id);
+		this.events.emit(HUB_EVENTS.bus.messagesRemoved, id);
 	}
 	info(message, extra) {
 		return this.add({
@@ -479,7 +499,7 @@ var DevframeMessagesHost = class {
 		for (const id of this.entries.keys()) this._recordRemoval(id, tick);
 		this.entries.clear();
 		this.lastModified.clear();
-		this.events.emit("message:cleared");
+		this.events.emit(HUB_EVENTS.bus.messagesCleared);
 	}
 	listSince(since) {
 		const version = this._clock;
@@ -523,7 +543,7 @@ var DevframeMessagesHost = class {
 * Channel name used for terminal stream output. Stable, well-known so
 * hub-aware clients can subscribe by name.
 */
-const TERMINAL_STREAM_CHANNEL = "devframe:terminals";
+const TERMINAL_STREAM_CHANNEL = HUB_EVENTS.stream.terminals;
 const TERMINAL_REPLAY_WINDOW = 1e3;
 /** Max chunks retained in the per-session scrollback buffer (bounded like the replay window). */
 const TERMINAL_BUFFER_LIMIT = 1e3;
@@ -553,7 +573,7 @@ var DevframeTerminalsHost = class {
 		if (this.sessions.has(session.id)) throw diagnostics.DF8200({ id: session.id });
 		this.sessions.set(session.id, session);
 		this.bindStream(session);
-		this.events.emit("terminal:session:updated", session);
+		this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 		return session;
 	}
 	update(patch) {
@@ -562,12 +582,12 @@ var DevframeTerminalsHost = class {
 		Object.assign(session, patch);
 		this.sessions.set(patch.id, session);
 		this.bindStream(session);
-		this.events.emit("terminal:session:updated", session);
+		this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 	}
 	remove(session) {
 		this._boundStreams.get(session.id)?.dispose();
 		this.sessions.delete(session.id);
-		this.events.emit("terminal:session:updated", session);
+		this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 		this._boundStreams.delete(session.id);
 	}
 	bindStream(session) {
@@ -621,7 +641,7 @@ var DevframeTerminalsHost = class {
 		const markStatus = (next) => {
 			if (session.status === next) return;
 			session.status = next;
-			this.events.emit("terminal:session:updated", session);
+			this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 		};
 		const closeStream = () => {
 			if (streamClosed) return;
@@ -755,7 +775,7 @@ var DevframeTerminalsHost = class {
 		const markStatus = (next) => {
 			if (session.status === next) return;
 			session.status = next;
-			this.events.emit("terminal:session:updated", session);
+			this.events.emit(HUB_EVENTS.bus.terminalsSessionUpdated, session);
 		};
 		const closeStream = () => {
 			if (streamClosed) return;
@@ -884,7 +904,18 @@ function nextAvailableDockId(views, baseId) {
 * machinery — e.g. `@vitejs/devtools-kit`'s `createPluginFromDevframe`
 * returns a Vite `Plugin` whose `devtools.setup` ultimately delegates here.
 */
-async function installDevframe(ctx, d, options = {}) {
+/**
+* Phase one of an install: run the duplication guard, serve the SPA + meta,
+* register the iframe dock, and queue the definition's declarative wire
+* services — everything up to (but not including) `setup(ctx)`. Returns a
+* deferred setup thunk, or `null` when the devframe was deduplicated.
+*
+* The hub's initial batch uses this to collect every devframe's services
+* across the whole hub, `ready()` them once, and only then run the setups —
+* so services are ready before any setup, and a plugin can consume a service
+* another plugin declared regardless of mount order.
+*/
+async function prepareDevframe(ctx, d, options = {}) {
 	const strategy = d.duplicationStrategy ?? "warn";
 	const isDuplicate = ctx.docks.views.has(d.id);
 	if (isDuplicate && strategy !== "duplicate") {
@@ -896,7 +927,7 @@ async function installDevframe(ctx, d, options = {}) {
 			id: d.id,
 			name: d.name
 		});
-		return;
+		return null;
 	}
 	const id = isDuplicate ? nextAvailableDockId(ctx.docks.views, d.id) : d.id;
 	const base = options.base ?? (id === d.id ? resolveBasePath(d, "hosted") : resolveBasePath({
@@ -912,7 +943,7 @@ async function installDevframe(ctx, d, options = {}) {
 			base
 		});
 		const distSource = d.cli.distDir;
-		ctx.views.hostStatic(base, typeof distSource === "string" ? resolve(distSource) : distSource);
+		ctx.views.hostStatic(base, typeof distSource === "string" ? resolve(distSource) : distSource, d.importMetaUrl);
 	}
 	ctx.docks.register({
 		id,
@@ -923,7 +954,21 @@ async function installDevframe(ctx, d, options = {}) {
 		type: "iframe",
 		url: base
 	});
-	await d.setup(ctx);
+	for (const input of d.services ?? []) ctx.services.install(input, { resolveFrom: d.importMetaUrl });
+	return () => Promise.resolve(d.setup(ctx));
+}
+/**
+* Install a {@link DevframeDefinition} into a hub in one call — serve its SPA,
+* register its dock, ready its services, and run `setup(ctx)`. The imperative
+* counterpart to the hub's declarative `devframes` list (which batches the
+* phases via {@link prepareDevframe}); use it from `configure(ctx)` or
+* wherever you hold the context to plug in an extra devframe after startup.
+*/
+async function installDevframe(ctx, d, options = {}) {
+	const run = await prepareDevframe(ctx, d, options);
+	if (!run) return;
+	await ctx.services.ready();
+	await run();
 }
 //#endregion
 //#region src/node/rpc-builtins.ts
@@ -957,7 +1002,7 @@ function resolveControllableSession(sessions, id) {
 * from the shared state and dispatch by id via this RPC.
 */
 const hubCommandsExecute = defineHubRpcFunction({
-	name: "hub:commands:execute",
+	name: HUB_EVENTS.rpc.commandsExecute,
 	type: "action",
 	setup: (context) => ({ async handler(id, ...args) {
 		return context.commands.execute(id, ...args);
@@ -973,7 +1018,7 @@ const hubCommandsExecute = defineHubRpcFunction({
 * dock client script can report into the same feed the server writes to.
 */
 const hubMessagesAdd = defineHubRpcFunction({
-	name: "hub:messages:add",
+	name: HUB_EVENTS.rpc.messagesAdd,
 	type: "action",
 	jsonSerializable: true,
 	setup: (context) => ({ async handler(input) {
@@ -985,7 +1030,7 @@ const hubMessagesAdd = defineHubRpcFunction({
 });
 /** `hub:messages:update` — Patch a message by id; returns the updated entry (or `undefined`). */
 const hubMessagesUpdate = defineHubRpcFunction({
-	name: "hub:messages:update",
+	name: HUB_EVENTS.rpc.messagesUpdate,
 	type: "action",
 	jsonSerializable: true,
 	setup: (context) => ({ async handler(id, patch) {
@@ -994,7 +1039,7 @@ const hubMessagesUpdate = defineHubRpcFunction({
 });
 /** `hub:messages:remove` — Remove a message by id. */
 const hubMessagesRemove = defineHubRpcFunction({
-	name: "hub:messages:remove",
+	name: HUB_EVENTS.rpc.messagesRemove,
 	type: "action",
 	setup: (context) => ({ async handler(id) {
 		await context.messages.remove(id);
@@ -1002,7 +1047,7 @@ const hubMessagesRemove = defineHubRpcFunction({
 });
 /** `hub:messages:clear` — Remove every message. */
 const hubMessagesClear = defineHubRpcFunction({
-	name: "hub:messages:clear",
+	name: HUB_EVENTS.rpc.messagesClear,
 	type: "action",
 	setup: (context) => ({ async handler() {
 		await context.messages.clear();
@@ -1014,7 +1059,7 @@ const hubMessagesClear = defineHubRpcFunction({
 * terminals plugin) drive a session owned by another plugin.
 */
 const hubTerminalsWrite = defineHubRpcFunction({
-	name: "hub:terminals:write",
+	name: HUB_EVENTS.rpc.terminalsWrite,
 	type: "action",
 	setup: (context) => ({ async handler(id, data) {
 		resolveInteractiveSession(context.terminals.sessions, id).write(data);
@@ -1022,7 +1067,7 @@ const hubTerminalsWrite = defineHubRpcFunction({
 });
 /** `hub:terminals:resize` — Resize an interactive PTY session by id. */
 const hubTerminalsResize = defineHubRpcFunction({
-	name: "hub:terminals:resize",
+	name: HUB_EVENTS.rpc.terminalsResize,
 	type: "action",
 	setup: (context) => ({ async handler(id, cols, rows) {
 		resolveInteractiveSession(context.terminals.sessions, id).resize(cols, rows);
@@ -1035,7 +1080,7 @@ const hubTerminalsResize = defineHubRpcFunction({
 * force-kill a session owned by another plugin.
 */
 const hubTerminalsTerminate = defineHubRpcFunction({
-	name: "hub:terminals:terminate",
+	name: HUB_EVENTS.rpc.terminalsTerminate,
 	type: "action",
 	setup: (context) => ({ async handler(id) {
 		await resolveControllableSession(context.terminals.sessions, id).terminate();
@@ -1047,7 +1092,7 @@ const hubTerminalsTerminate = defineHubRpcFunction({
 * elsewhere.
 */
 const hubTerminalsRestart = defineHubRpcFunction({
-	name: "hub:terminals:restart",
+	name: HUB_EVENTS.rpc.terminalsRestart,
 	type: "action",
 	setup: (context) => ({ async handler(id) {
 		const session = resolveControllableSession(context.terminals.sessions, id);
@@ -1061,7 +1106,7 @@ const hubTerminalsRestart = defineHubRpcFunction({
 * terminal UI discard a stopped aggregated session.
 */
 const hubTerminalsRemove = defineHubRpcFunction({
-	name: "hub:terminals:remove",
+	name: HUB_EVENTS.rpc.terminalsRemove,
 	type: "action",
 	setup: (context) => ({ async handler(id) {
 		const session = context.terminals.sessions.get(id);
@@ -1084,7 +1129,7 @@ const hubTerminalsRemove = defineHubRpcFunction({
 * mounts in response still converges on it).
 */
 const hubDocksActivate = defineHubRpcFunction({
-	name: "hub:docks:activate",
+	name: HUB_EVENTS.rpc.docksActivate,
 	type: "action",
 	setup: (context) => ({ async handler(input) {
 		context.docks.activate(input.dockId, input.params);
@@ -1133,50 +1178,50 @@ async function createHubContext(options) {
 	context.install = (devframe, options) => installDevframe(context, devframe, options);
 	await docks.init();
 	const debounceMs = options.mode === "build" ? 0 : 10;
-	const docksSharedState = await context.rpc.sharedState.get("devframe:docks", { initialValue: [] });
+	const docksSharedState = await context.rpc.sharedState.get(HUB_EVENTS.sharedState.docks, { initialValue: [] });
 	const refreshDocks = debounce(() => {
 		docksSharedState.mutate(() => docks.values());
 	}, debounceMs);
-	docks.events.on("dock:entry:updated", refreshDocks);
+	docks.events.on(HUB_EVENTS.bus.docksEntryUpdated, refreshDocks);
 	getInternalContext(context).onWsEndpointChange(refreshDocks);
 	docksSharedState.mutate(() => docks.values());
-	const activeDockSharedState = await context.rpc.sharedState.get("devframe:docks:active", { initialValue: { activation: null } });
-	docks.events.on("dock:activate", (activation) => {
+	const activeDockSharedState = await context.rpc.sharedState.get(HUB_EVENTS.sharedState.docksActive, { initialValue: { activation: null } });
+	docks.events.on(HUB_EVENTS.bus.docksActivate, (activation) => {
 		activeDockSharedState.mutate((state) => {
 			state.activation = activation;
 		});
 		context.rpc.broadcast({
-			method: "devframe:docks:activate",
+			method: HUB_EVENTS.broadcast.docksActivate,
 			args: [activation]
 		});
 	});
 	const broadcastTerminals = debounce(() => {
 		context.rpc.broadcast({
-			method: "devframe:terminals:updated",
+			method: HUB_EVENTS.broadcast.terminalsUpdated,
 			args: []
 		});
 		docksSharedState.mutate(() => docks.values());
 	}, debounceMs);
-	terminals.events.on("terminal:session:updated", broadcastTerminals);
+	terminals.events.on(HUB_EVENTS.bus.terminalsSessionUpdated, broadcastTerminals);
 	const broadcastMessages = debounce(() => {
 		context.rpc.broadcast({
-			method: "devframe:messages:updated",
+			method: HUB_EVENTS.broadcast.messagesUpdated,
 			args: []
 		});
 		docksSharedState.mutate(() => docks.values());
 	}, debounceMs);
-	messages.events.on("message:added", broadcastMessages);
-	messages.events.on("message:updated", broadcastMessages);
-	messages.events.on("message:removed", broadcastMessages);
-	messages.events.on("message:cleared", broadcastMessages);
-	const commandsSharedState = await context.rpc.sharedState.get("devframe:commands", { initialValue: [] });
+	messages.events.on(HUB_EVENTS.bus.messagesAdded, broadcastMessages);
+	messages.events.on(HUB_EVENTS.bus.messagesUpdated, broadcastMessages);
+	messages.events.on(HUB_EVENTS.bus.messagesRemoved, broadcastMessages);
+	messages.events.on(HUB_EVENTS.bus.messagesCleared, broadcastMessages);
+	const commandsSharedState = await context.rpc.sharedState.get(HUB_EVENTS.sharedState.commands, { initialValue: [] });
 	const syncCommands = debounce(() => {
 		commandsSharedState.mutate(() => commands.list());
 	}, debounceMs);
-	commands.events.on("command:registered", syncCommands);
-	commands.events.on("command:unregistered", syncCommands);
+	commands.events.on(HUB_EVENTS.bus.commandsRegistered, syncCommands);
+	commands.events.on(HUB_EVENTS.bus.commandsUnregistered, syncCommands);
 	commandsSharedState.mutate(() => commands.list());
 	return context;
 }
 //#endregion
-export { DevframeCommandsHost as _, hubMessagesAdd as a, hubMessagesUpdate as c, hubTerminalsRestart as d, hubTerminalsTerminate as f, DevframeDocksHost as g, DevframeMessagesHost as h, hubDocksActivate as i, hubTerminalsRemove as l, DevframeTerminalsHost as m, builtinHubRpcDeclarations as n, hubMessagesClear as o, hubTerminalsWrite as p, hubCommandsExecute as r, hubMessagesRemove as s, createHubContext as t, hubTerminalsResize as u, diagnostics as v };
+export { DevframeDocksHost as _, hubMessagesAdd as a, hubMessagesUpdate as c, hubTerminalsRestart as d, hubTerminalsTerminate as f, DevframeMessagesHost as g, DevframeTerminalsHost as h, hubDocksActivate as i, hubTerminalsRemove as l, prepareDevframe as m, builtinHubRpcDeclarations as n, hubMessagesClear as o, hubTerminalsWrite as p, hubCommandsExecute as r, hubMessagesRemove as s, createHubContext as t, hubTerminalsResize as u, DevframeCommandsHost as v, diagnostics as y };

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

@@ -1,5 +1,5 @@
-import "./context-D5TJIHwp.mjs";
-import "./settings-DfrRa9Wf.mjs";
+import "./context-BVkxwz5k.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";
 export { RpcStreamingHost as S, RpcFunctionsHost as _, DevframeHost$1 as a, RpcStreamingChannel as b, DevframeRpcServerFunctions as c, EventEmitter$1 as d, EventUnsubscribe as f, RpcDefinitionsToFunctions as g, RpcDefinitionsFilter as h, DevframeDiagnosticsLogger as i, DevframeRpcSharedStates as l, RpcBroadcastOptions as m, DevframeCapabilities as n, DevframeNodeRpcSession as o, EventsMap as p, DevframeDiagnosticsHost as r, DevframeRpcClientFunctions as s, ConnectionMeta$1 as t, DevframeViewHost as u, RpcSharedStateGetOptions as v, RpcStreamingChannelOptions as x, RpcSharedStateHost as y };

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-D5TJIHwp.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-DfrRa9Wf.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-coDmWngQ.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-BVkxwz5k.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 { 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,5 +1,5 @@
-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-D5TJIHwp.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-DfrRa9Wf.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-BVkxwz5k.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";
 //#region src/node/host-commands.d.ts
@@ -51,6 +51,14 @@ 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
+   * 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
+   * doomed to fail there.
+   */
+  private warnUnresolvableClientScript;
   private validateGroupMembership;
   private prepareRemoteRegistration;
 }