@devframes/hub 0.9.1 → 0.9.3

package/dist/{context-90I4t0S3.mjs → context-TgU_TKiY.mjs}

@@ -904,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") {
@@ -916,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({
@@ -932,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,
@@ -943,8 +954,21 @@ async function installDevframe(ctx, d, options = {}) {
 		type: "iframe",
 		url: base
 	});
-	for (const input of d.services ?? []) ctx.services.install(input, { resolveFrom: d.packageName });
-	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
@@ -1200,4 +1224,4 @@ async function createHubContext(options) {
 	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/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-90I4t0S3.mjs";
+import { _ as DevframeDocksHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeMessagesHost, h as DevframeTerminalsHost, i as hubDocksActivate, l as hubTerminalsRemove, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize, v as DevframeCommandsHost } from "../context-TgU_TKiY.mjs";
 import "ufo";
 import "pathe";
 import "node:process";

package/dist/node/initiate.d.mts

@@ -1,7 +1,7 @@
 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 { ConnectionMeta, DevframeDefinition, DevframeServiceInput, DevframeSseOptions, DevframeStorageScope, DevframeWsOptions, McpRouteOptions } from "devframe/types";
 import { DevframeAuthHandler } from "devframe/node/auth";
 import { WsOriginRegistry } from "devframe/rpc/transports/ws-server";
 import { Buffer } from "node:buffer";
@@ -114,6 +114,14 @@ interface InitHubOptions {
    * (category, icon, a `clientScript` to run in the host page, …).
    */
   devframes?: DevframesInput;
+  /**
+   * Host-level wire services to install, on top of whatever the mounted
+   * devframes declare. Constructed (option sets merged) at the pre-setup
+   * barrier, so every devframe's `setup` sees them ready. Reach for this to
+   * configure a shared service centrally — e.g.
+   * `services: [createShikiService({ themes })]`.
+   */
+  services?: DevframeServiceInput[];
   /**
    * Extra RPC declarations registered at context creation, alongside the
    * hub built-ins — forwarded to `createHubContext`'s

package/dist/node/initiate.mjs

@@ -1,6 +1,6 @@
 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 { m as prepareDevframe, t as createHubContext, y as diagnostics } from "../context-TgU_TKiY.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";
@@ -171,23 +171,27 @@ function initHub(options) {
 				clientModuleResolution: options.clientModuleResolution
 			};
 			const devframes = await resolveDevframesInput(options.devframes ?? []);
+			for (const input of options.services ?? []) ctx.services.install(input);
+			const setups = [];
 			for (const { devframe: def, dock } of devframes) {
 				if (RESERVED_HUB_PATHS.includes(def.id)) throw diagnostics.DF8000({ id: def.id });
 				if (!/^[\w.-]+$/.test(def.id)) throw diagnostics.DF8004({ id: def.id });
 				const frameBase = withTrailingSlash(joinURL(base, def.id));
-				await ctx.install(def, {
+				const run = await prepareDevframe(ctx, def, {
 					base: frameBase,
 					...dock ? { dock } : {}
 				});
+				if (run) setups.push(run);
 				frames.push({
 					id: def.id,
 					base: frameBase,
 					title: def.name
 				});
 			}
+			await ctx.services.ready();
+			for (const run of setups) await run();
 			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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub",
   "type": "module",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "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.1"
+    "devframe": "0.9.3"
   },
   "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.1"
+    "devframe": "0.9.3"
   },
   "scripts": {
     "build": "tsdown",