@devframes/hub 0.9.0 → 0.9.1

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-import { _ as DevframeCommandsHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeDocksHost, h as DevframeMessagesHost, i as hubDocksActivate, l as hubTerminalsRemove, m as DevframeTerminalsHost, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize } from "../context-DzqMQ2mI.mjs";
+import { _ as DevframeCommandsHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeDocksHost, h as DevframeMessagesHost, i as hubDocksActivate, l as hubTerminalsRemove, m as DevframeTerminalsHost, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize } from "../context-90I4t0S3.mjs";
 import "ufo";
 import "pathe";
 import "node:process";
@@ -1753,9 +1753,11 @@ pp$8.parseForStatement = function(node) {
 };
 pp$8.parseForAfterInit = function(node, init, awaitAt) {
 	if ((this.type === types$1._in || this.options.ecmaVersion >= 6 && this.isContextual("of")) && init.declarations.length === 1) {
-		if (this.options.ecmaVersion >= 9) if (this.type === types$1._in) {
-			if (awaitAt > -1) this.unexpected(awaitAt);
-		} else node.await = awaitAt > -1;
+		if (this.options.ecmaVersion >= 9) {
+			if (this.type === types$1._in) {
+				if (awaitAt > -1) this.unexpected(awaitAt);
+			} else node.await = awaitAt > -1;
+		}
 		return this.parseForIn(node, init);
 	}
 	if (awaitAt > -1) this.unexpected(awaitAt);
@@ -2036,13 +2038,17 @@ pp$8.parseClassElement = function(constructorAllowsSuper) {
 		else keyName = "static";
 	}
 	node.static = isStatic;
-	if (!keyName && ecmaVersion >= 8 && this.eatContextual("async")) if ((this.isClassElementNameStart() || this.type === types$1.star) && !this.canInsertSemicolon()) isAsync = true;
-	else keyName = "async";
+	if (!keyName && ecmaVersion >= 8 && this.eatContextual("async")) {
+		if ((this.isClassElementNameStart() || this.type === types$1.star) && !this.canInsertSemicolon()) isAsync = true;
+		else keyName = "async";
+	}
 	if (!keyName && (ecmaVersion >= 9 || !isAsync) && this.eat(types$1.star)) isGenerator = true;
 	if (!keyName && !isAsync && !isGenerator) {
 		var lastValue = this.value;
-		if (this.eatContextual("get") || this.eatContextual("set")) if (this.isClassElementNameStart()) kind = lastValue;
-		else keyName = lastValue;
+		if (this.eatContextual("get") || this.eatContextual("set")) {
+			if (this.isClassElementNameStart()) kind = lastValue;
+			else keyName = lastValue;
+		}
 	}
 	if (keyName) {
 		node.computed = false;
@@ -2135,8 +2141,10 @@ pp$8.exitClassBody = function() {
 	var parent = len === 0 ? null : this.privateNameStack[len - 1];
 	for (var i = 0; i < used.length; ++i) {
 		var id = used[i];
-		if (!hasOwn(declared, id.name)) if (parent) parent.used.push(id);
-		else this.raiseRecoverable(id.start, "Private field '#" + id.name + "' must be declared in an enclosing class");
+		if (!hasOwn(declared, id.name)) {
+			if (parent) parent.used.push(id);
+			else this.raiseRecoverable(id.start, "Private field '#" + id.name + "' must be declared in an enclosing class");
+		}
 	}
 };
 function isPrivateNameConflicted(privateNameMap, element) {
@@ -2158,10 +2166,12 @@ function checkKeyName(node, name) {
 	return !computed && (key.type === "Identifier" && key.name === name || key.type === "Literal" && key.value === name);
 }
 pp$8.parseExportAllDeclaration = function(node, exports) {
-	if (this.options.ecmaVersion >= 11) if (this.eatContextual("as")) {
-		node.exported = this.parseModuleExportName();
-		this.checkExport(exports, node.exported, this.lastTokStart);
-	} else node.exported = null;
+	if (this.options.ecmaVersion >= 11) {
+		if (this.eatContextual("as")) {
+			node.exported = this.parseModuleExportName();
+			this.checkExport(exports, node.exported, this.lastTokStart);
+		} else node.exported = null;
+	}
 	this.expectContextual("from");
 	if (this.type !== types$1.string) this.unexpected();
 	node.source = this.parseExprAtom();
@@ -2679,9 +2689,11 @@ pp$5.checkPropClash = function(prop, propHash, refDestructuringErrors) {
 	var kind = prop.kind;
 	if (this.options.ecmaVersion >= 6) {
 		if (name === "__proto__" && kind === "init") {
-			if (propHash.proto) if (refDestructuringErrors) {
-				if (refDestructuringErrors.doubleProto < 0) refDestructuringErrors.doubleProto = key.start;
-			} else this.raiseRecoverable(key.start, "Redefinition of __proto__ property");
+			if (propHash.proto) {
+				if (refDestructuringErrors) {
+					if (refDestructuringErrors.doubleProto < 0) refDestructuringErrors.doubleProto = key.start;
+				} else this.raiseRecoverable(key.start, "Redefinition of __proto__ property");
+			}
 			propHash.proto = true;
 		}
 		return;
@@ -2712,8 +2724,10 @@ pp$5.parseExpression = function(forInit, refDestructuringErrors) {
 	return expr;
 };
 pp$5.parseMaybeAssign = function(forInit, refDestructuringErrors, afterLeftParse) {
-	if (this.isContextual("yield")) if (this.inGenerator) return this.parseYield(forInit);
-	else this.exprAllowed = false;
+	if (this.isContextual("yield")) {
+		if (this.inGenerator) return this.parseYield(forInit);
+		else this.exprAllowed = false;
+	}
 	var ownDestructuringErrors = false, oldParenAssign = -1, oldTrailingComma = -1, oldDoubleProto = -1;
 	if (refDestructuringErrors) {
 		oldParenAssign = refDestructuringErrors.parenthesizedAssign;
@@ -2829,9 +2843,10 @@ pp$5.parseMaybeUnary = function(refDestructuringErrors, sawUnary, incDec, forIni
 			expr = this.finishNode(node$1, "UpdateExpression");
 		}
 	}
-	if (!incDec && this.eat(types$1.starstar)) if (sawUnary) this.unexpected(this.lastTokStart);
-	else return this.buildBinary(startPos, startLoc, expr, this.parseMaybeUnary(null, false, false, forInit), "**", false);
-	else return expr;
+	if (!incDec && this.eat(types$1.starstar)) {
+		if (sawUnary) this.unexpected(this.lastTokStart);
+		else return this.buildBinary(startPos, startLoc, expr, this.parseMaybeUnary(null, false, false, forInit), "**", false);
+	} else return expr;
 };
 function isLocalVariableAccess(node) {
 	return node.type === "Identifier" || node.type === "ParenthesizedExpression" && isLocalVariableAccess(node.expression);
@@ -3017,17 +3032,18 @@ pp$5.parseExprImport = function(forNew) {
 pp$5.parseDynamicImport = function(node) {
 	this.next();
 	node.source = this.parseMaybeAssign();
-	if (this.options.ecmaVersion >= 16) if (!this.eat(types$1.parenR)) {
-		this.expect(types$1.comma);
-		if (!this.afterTrailingComma(types$1.parenR)) {
-			node.options = this.parseMaybeAssign();
-			if (!this.eat(types$1.parenR)) {
-				this.expect(types$1.comma);
-				if (!this.afterTrailingComma(types$1.parenR)) this.unexpected();
-			}
+	if (this.options.ecmaVersion >= 16) {
+		if (!this.eat(types$1.parenR)) {
+			this.expect(types$1.comma);
+			if (!this.afterTrailingComma(types$1.parenR)) {
+				node.options = this.parseMaybeAssign();
+				if (!this.eat(types$1.parenR)) {
+					this.expect(types$1.comma);
+					if (!this.afterTrailingComma(types$1.parenR)) this.unexpected();
+				}
+			} else node.options = null;
 		} else node.options = null;
-	} else node.options = null;
-	else if (!this.eat(types$1.parenR)) {
+	} else if (!this.eat(types$1.parenR)) {
 		var errorPos = this.start;
 		if (this.eat(types$1.comma) && this.eat(types$1.parenR)) this.raiseRecoverable(errorPos, "Trailing comma is not allowed in import()");
 		else this.unexpected(errorPos);
@@ -3260,12 +3276,14 @@ pp$5.parsePropertyValue = function(prop, isPattern, isGenerator, isAsync, startP
 	} else this.unexpected();
 };
 pp$5.parsePropertyName = function(prop) {
-	if (this.options.ecmaVersion >= 6) if (this.eat(types$1.bracketL)) {
-		prop.computed = true;
-		prop.key = this.parseMaybeAssign();
-		this.expect(types$1.bracketR);
-		return prop.key;
-	} else prop.computed = false;
+	if (this.options.ecmaVersion >= 6) {
+		if (this.eat(types$1.bracketL)) {
+			prop.computed = true;
+			prop.key = this.parseMaybeAssign();
+			this.expect(types$1.bracketR);
+			return prop.key;
+		} else prop.computed = false;
+	}
 	return prop.key = this.type === types$1.num || this.type === types$1.string ? this.parseExprAtom() : this.parseIdent(this.options.allowReserved !== "never");
 };
 pp$5.initFunction = function(node) {
@@ -3400,8 +3418,10 @@ pp$5.parsePrivateIdent = function() {
 	else this.unexpected();
 	this.next();
 	this.finishNode(node, "PrivateIdentifier");
-	if (this.options.checkPrivateFields) if (this.privateNameStack.length === 0) this.raise(node.start, "Private field '#" + node.name + "' must be declared in an enclosing class");
-	else this.privateNameStack[this.privateNameStack.length - 1].used.push(node);
+	if (this.options.checkPrivateFields) {
+		if (this.privateNameStack.length === 0) this.raise(node.start, "Private field '#" + node.name + "' must be declared in an enclosing class");
+		else this.privateNameStack[this.privateNameStack.length - 1].used.push(node);
+	}
 	return node;
 };
 pp$5.parseYield = function(forInit) {
@@ -3936,9 +3956,11 @@ pp$1.regexp_groupSpecifier = function(state) {
 		if (!this.regexp_eatGroupName(state)) state.raise("Invalid group");
 		var trackDisjunction = this.options.ecmaVersion >= 16;
 		var known = state.groupNames[state.lastStringValue];
-		if (known) if (trackDisjunction) {
-			for (var i = 0, list = known; i < list.length; i += 1) if (!list[i].separatedFrom(state.branchID)) state.raise("Duplicate capture group name");
-		} else state.raise("Duplicate capture group name");
+		if (known) {
+			if (trackDisjunction) {
+				for (var i = 0, list = known; i < list.length; i += 1) if (!list[i].separatedFrom(state.branchID)) state.raise("Duplicate capture group name");
+			} else state.raise("Duplicate capture group name");
+		}
 		if (trackDisjunction) (known || (state.groupNames[state.lastStringValue] = [])).push(state.branchID);
 		else state.groupNames[state.lastStringValue] = true;
 	}
@@ -4952,12 +4974,14 @@ pp.readTmplToken = function() {
 		if (this.pos >= this.input.length) this.raise(this.start, "Unterminated template");
 		var ch = this.input.charCodeAt(this.pos);
 		if (ch === 96 || ch === 36 && this.input.charCodeAt(this.pos + 1) === 123) {
-			if (this.pos === this.start && (this.type === types$1.template || this.type === types$1.invalidTemplate)) if (ch === 36) {
-				this.pos += 2;
-				return this.finishToken(types$1.dollarBraceL);
-			} else {
-				++this.pos;
-				return this.finishToken(types$1.backQuote);
+			if (this.pos === this.start && (this.type === types$1.template || this.type === types$1.invalidTemplate)) {
+				if (ch === 36) {
+					this.pos += 2;
+					return this.finishToken(types$1.dollarBraceL);
+				} else {
+					++this.pos;
+					return this.finishToken(types$1.backQuote);
+				}
 			}
 			out += this.input.slice(chunkStart, this.pos);
 			return this.finishToken(types$1.template, out);
@@ -4974,9 +4998,7 @@ pp.readTmplToken = function() {
 				case 10:
 					out += "\n";
 					break;
-				default:
-					out += String.fromCharCode(ch);
-					break;
+				default: out += String.fromCharCode(ch);
 			}
 			if (this.options.locations) {
 				++this.curLine;
@@ -4999,7 +5021,6 @@ pp.readInvalidTemplateToken = function() {
 		case "\u2029":
 			++this.curLine;
 			this.lineStart = this.pos + 1;
-			break;
 	}
 	this.raise(this.start, "Unterminated template");
 };
@@ -5197,10 +5218,12 @@ codes.ERR_INVALID_ARG_TYPE = createError(
 			message += `an instance of ${formatList(instances, "or")}`;
 			if (other.length > 0) message += " or ";
 		}
-		if (other.length > 0) if (other.length > 1) message += `one of ${formatList(other, "or")}`;
-		else {
-			if (other[0].toLowerCase() !== other[0]) message += "an ";
-			message += `${other[0]}`;
+		if (other.length > 0) {
+			if (other.length > 1) message += `one of ${formatList(other, "or")}`;
+			else {
+				if (other[0].toLowerCase() !== other[0]) message += "an ";
+				message += `${other[0]}`;
+			}
 		}
 		message += `. Received ${determineSpecificType(actual)}`;
 		return message;

package/dist/node/initiate.d.mts

@@ -1,5 +1,5 @@
-import { i as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-D5TJIHwp.mjs";
-import { DEVFRAMES_HUB_BASE } from "../constants.mjs";
+import { i as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-BVkxwz5k.mjs";
+import { r as DEVFRAMES_HUB_BASE } from "../constants-CmESZCBq.mjs";
 import { DevframeInstanceRecord } from "devframe/internal";
 import { ConnectionMeta, DevframeDefinition, DevframeSseOptions, DevframeStorageScope, DevframeWsOptions, McpRouteOptions } from "devframe/types";
 import { DevframeAuthHandler } from "devframe/node/auth";
@@ -207,6 +207,19 @@ interface InitHubOptions {
    * (`id`, `name`, `basePath`, …).
    */
   register?: boolean | Partial<DevframeInstanceRecord>;
+  /**
+   * Advertise that this host runtime resolves **bare-specifier** client
+   * scripts (`ClientScriptEntry.importFrom` naming an npm module) — a URL
+   * template whose `{specifier}` token is replaced with the specifier,
+   * published as `ConnectionMeta.configs.dock.clientModuleResolution` and
+   * applied by every client-script loader. Declare it only when the host can
+   * actually serve npm modules to the browser — a Vite host passes
+   * `'/@id/{specifier}'` to route imports through its own module graph
+   * (`@devframes/vite/hub` does). Left undeclared, registering a
+   * bare-specifier client script warns `DF8111` — ship a self-contained
+   * bundle and pass its URL instead.
+   */
+  clientModuleResolution?: string;
   /** Working directory for the hub context. Default: `process.cwd()`. */
   cwd?: string;
   /** Override where persisted devframe state lives. */

package/dist/node/initiate.mjs

@@ -1,5 +1,6 @@
-import { DEVFRAMES_HUB_BASE, DOCK_RENDERERS_STATE_KEY, normalizeHubBase } from "../constants.mjs";
-import { t as createHubContext, v as diagnostics } from "../context-DzqMQ2mI.mjs";
+import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, r as DEVFRAMES_HUB_BASE } from "../constants-C2b2cACy.mjs";
+import { a as resolveClientModuleSpecifier } from "../remote-url-Bgc7gtsP.mjs";
+import { t as createHubContext, v as diagnostics } from "../context-90I4t0S3.mjs";
 import { joinURL, withTrailingSlash, withoutLeadingSlash } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE, DEVFRAME_WS_ROUTE } from "devframe/constants";
 import { createH3DevframeHost, createInstanceShell, resolveInstanceRegister } from "devframe/internal";
@@ -70,9 +71,11 @@ function resolveRendererRegistrations(registrations) {
 * import thunk per dock that carries a client script (`clientScript` on
 * iframe docks, `action`, `renderer`). External viewers import this module
 * from `<base>__client-imports.js` to load per-dock client code into the
-* host page; `importFrom` values must be URL paths the host serves.
+* host page; `importFrom` values are URL paths the host serves, or bare npm
+* specifiers resolved through the host's `clientModuleResolution` template.
 */
 function renderClientImportsModule(ctx) {
+	const template = ctx.staticConfig.dock?.clientModuleResolution;
 	const entries = [];
 	for (const [id, view] of ctx.docks.views) {
 		const scripts = [];
@@ -81,7 +84,7 @@ function renderClientImportsModule(ctx) {
 		if (anyView.action) scripts.push(anyView.action);
 		if (anyView.renderer) scripts.push(anyView.renderer);
 		if (scripts.length === 0) continue;
-		const thunks = scripts.map((script) => `() => import(${JSON.stringify(script.importFrom)})`);
+		const thunks = scripts.map((script) => `() => import(${JSON.stringify(resolveClientModuleSpecifier(script.importFrom, { template }))})`);
 		entries.push(`  ${JSON.stringify(id)}: [${thunks.join(", ")}],`);
 	}
 	return `// Generated by @devframes/hub — dock client-script import map.\nexport const clientImports = {\n${entries.join("\n")}\n}\nexport default clientImports\n`;
@@ -163,6 +166,10 @@ function initHub(options) {
 					...options.rpcDeclarations ? { builtinRpcDeclarations: options.rpcDeclarations } : {}
 				});
 			}
+			if (options.clientModuleResolution) ctx.staticConfig.dock = {
+				...ctx.staticConfig.dock,
+				clientModuleResolution: options.clientModuleResolution
+			};
 			const devframes = await resolveDevframesInput(options.devframes ?? []);
 			for (const { devframe: def, dock } of devframes) {
 				if (RESERVED_HUB_PATHS.includes(def.id)) throw diagnostics.DF8000({ id: def.id });
@@ -180,6 +187,7 @@ function initHub(options) {
 			}
 			await options.configure?.(ctx);
 			await options.ui?.setup?.(ctx);
+			await ctx.services.ready();
 			if (rendererRegistrations.length > 0) {
 				const manifest = {};
 				for (const registration of rendererRegistrations) manifest[registration.type] = {

package/dist/{remote-url-KVXtKP47.mjs → remote-url-Bgc7gtsP.mjs}

@@ -1,4 +1,49 @@
 import { REMOTE_CONNECTION_KEY } from "devframe/constants";
+//#region src/client-modules.ts
+const URL_SCHEME_RE = /^[a-z][a-z\d+.-]*:/i;
+/**
+* Whether a client-script `importFrom` is a **bare module specifier** — an
+* npm-style name (`vite-plugin-vue-tracer/client/vite-devtools`) rather than
+* a URL the browser can resolve natively.
+*/
+function isBareModuleSpecifier(specifier) {
+	const value = specifier.trim();
+	return !!value && !value.startsWith("/") && !value.startsWith("./") && !value.startsWith("../") && !URL_SCHEME_RE.test(value);
+}
+/**
+* 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.
+*/
+function resolveClientModuleSpecifier(specifier, options = {}) {
+	if (!isBareModuleSpecifier(specifier)) return specifier;
+	const custom = options.resolveClientModule?.(specifier);
+	if (custom) return custom;
+	if (!options.template) return specifier;
+	const applied = options.template.includes("{specifier}") ? options.template.replaceAll("{specifier}", specifier) : options.template + specifier;
+	try {
+		return new URL(applied, options.metaBaseUrl).href;
+	} catch {
+		return applied;
+	}
+}
+/**
+* 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}).
+*/
+function clientScriptFailureHint(importFrom, specifier) {
+	if (!isBareModuleSpecifier(importFrom)) return "";
+	if (specifier === importFrom) return " — the specifier is a bare npm specifier and this host advertises no client-module resolution (`ConnectionMeta.configs.dock.clientModuleResolution`). Serve the script as a self-contained bundle by URL, pass `resolveClientModule` to this client host, or run under a host that resolves bare specifiers (e.g. Vite: `/@id/{specifier}`).";
+	return ` — the host resolved the bare specifier "${importFrom}" to this URL but could not serve the module. Check the package is installed and resolvable from the host project's root (and built, if its exports point at build output).`;
+}
+//#endregion
 //#region src/remote-url.ts
 function base64UrlEncode(value) {
 	const bytes = new TextEncoder().encode(value);
@@ -15,7 +60,8 @@ function setRemoteConnectionParam(value, param) {
 }
 /** Encode a remote connection descriptor into an external viewer URL. */
 function buildRemoteConnectionUrl(baseUrl, payload, transport = "fragment") {
-	const param = `${REMOTE_CONNECTION_KEY}=${base64UrlEncode(JSON.stringify(payload))}`;
+	const encoded = base64UrlEncode(JSON.stringify(payload));
+	const param = `${REMOTE_CONNECTION_KEY}=${encoded}`;
 	if (transport === "fragment") {
 		const hashIdx = baseUrl.indexOf("#");
 		if (hashIdx === -1) return `${baseUrl}#${param}`;
@@ -70,4 +116,4 @@ function stripRemoteConnectionFromUrl(input) {
 	return hash ? `${beforeHash}#${hash}` : beforeHash;
 }
 //#endregion
-export { stripRemoteConnectionFromUrl as n, buildRemoteConnectionUrl as t };
+export { resolveClientModuleSpecifier as a, isBareModuleSpecifier as i, stripRemoteConnectionFromUrl as n, clientScriptFailureHint as r, buildRemoteConnectionUrl as t };

package/dist/{settings-DfrRa9Wf.d.mts → settings-D7whfcx2.d.mts}

@@ -4,8 +4,8 @@ import { StandardSchemaV1 } from "@standard-schema/spec";
 interface DevframeDocksHost {
   readonly views: Map<string, DevframeDockUserEntry>;
   readonly events: EventEmitter<{
-    'dock:entry:updated': (entry: DevframeDockUserEntry) => void;
-    'dock:activate': (activation: DevframeDockActivation) => void;
+    'docks:entry:updated': (entry: DevframeDockUserEntry) => void;
+    'docks:activate': (activation: DevframeDockActivation) => void;
   }>;
   register: <T extends DevframeDockUserEntry>(entry: T, force?: boolean) => {
     update: (patch: Partial<T>) => void;
@@ -143,7 +143,14 @@ interface DevframeDockEntryBase {
 }
 interface ClientScriptEntry {
   /**
-   * The filepath or module name to import from
+   * What to import — either a **URL the host serves** (a self-contained ES
+   * module, e.g. `/@fs/<abs path>` under Vite or a statically-mounted bundle
+   * path), or a **bare npm specifier** (e.g.
+   * `'vite-plugin-vue-tracer/client/vite-devtools'`), a host-runtime
+   * capability resolved through the host-advertised
+   * `ConnectionMeta.configs.dock.clientModuleResolution` template. On a host
+   * that declares no template, ship a self-contained bundle and pass its URL
+   * instead (see `DF8111`).
    */
   importFrom: string;
   /**
@@ -153,6 +160,23 @@ interface ClientScriptEntry {
    */
   importName?: string;
 }
+declare module 'devframe/types' {
+  interface DevframeConnectionConfigsRegistry {
+    /** Static dock-layer config a hub host publishes through the connection handshake (`initHub({ clientModuleResolution })` → `ctx.staticConfig.dock`). */
+    dock: {
+      /**
+       * URL template resolving a **bare-specifier** client script to an
+       * importable URL on this host — `{specifier}` replaced with the bare
+       * specifier (a token-less template is used as a prefix). Declaring it
+       * advertises the host runtime can serve npm modules to the browser:
+       * Vite hosts declare `'/@id/{specifier}'`, routing the import (and its
+       * transitive bare imports) through the app's own module graph. Hosts
+       * without such a runtime (e.g. Next.js) leave it undeclared.
+       */
+      clientModuleResolution?: string;
+    };
+  }
+}
 interface DevframeViewIframe extends DevframeDockEntryBase {
   type: 'iframe';
   url: string;
@@ -543,8 +567,8 @@ interface DevframeCommandHandle {
   unregister: () => void;
 }
 interface DevframeCommandsHostEvents {
-  'command:registered': (command: DevframeServerCommandEntry) => void;
-  'command:unregistered': (id: string) => void;
+  'commands:registered': (command: DevframeServerCommandEntry) => void;
+  'commands:unregistered': (id: string) => void;
 }
 interface DevframeCommandsHost {
   readonly commands: Map<string, DevframeServerCommandInput>;

package/dist/types/index.d.mts

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

package/package.json

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