@devframes/hub 0.9.10 → 0.9.11

package/dist/{assemble-Hj36CCzH.mjs → assemble-BvY5jfgi.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveClientModuleSpecifier } from "./remote-url-UClKLQ5_.mjs";
-import { b as diagnostics, v as prepareDevframe, y as skippedInStaticBuild } from "./context-BWaW6N53.mjs";
+import { v as prepareDevframe, y as diagnostics } from "./context-Cdrtg-Kk.mjs";
 import { joinURL, withTrailingSlash } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE, DEVFRAME_WS_ROUTE } from "devframe/constants";
 import { existsSync } from "node:fs";
@@ -77,9 +77,10 @@ function renderClientImportsModule(ctx) {
 /**
 * Pass 1: mount each devframe under `<base><id>/` (SPA, meta, iframe dock)
 * and queue its declared services, guarding the id against reserved hub
-* filenames and route-pattern characters. Returns the deferred setup thunks.
+* filenames and route-pattern characters. Returns the deferred setup thunks;
+* each mounted frame is recorded on `ctx.frames`.
 */
-async function mountDevframes(ctx, devframes, base, frames, hubMcpEnabled) {
+async function mountDevframes(ctx, devframes, base, hubMcpEnabled) {
 	const setups = [];
 	for (const { devframe: def, dock } of devframes) {
 		if (RESERVED_HUB_PATHS.includes(def.id)) throw diagnostics.DF8000({ id: def.id });
@@ -91,11 +92,6 @@ async function mountDevframes(ctx, devframes, base, frames, hubMcpEnabled) {
 			...dock ? { dock } : {}
 		});
 		if (run) setups.push(run);
-		if (!skippedInStaticBuild(ctx, def)) frames.push({
-			id: def.id,
-			base: frameBase,
-			title: def.name
-		});
 	}
 	return setups;
 }

package/dist/client/index.d.mts

@@ -1,6 +1,6 @@
-import { C as DevframeMessageEntryInput, O as DevframeMessagesClient } from "../context-Di-fhMKP.mjs";
+import { k as DevframeMessagesClient, w as DevframeMessageEntryInput } from "../context-BmHQp89a.mjs";
 import { A as DevframeViewIframe, C as DevframeDockUserEntry, F as RemoteConnectionInfo, P as NavTarget, S as DevframeDockPanelState, _ as DevframeDockEntry, a as DevframeCommandEntry, b as DevframeDockEntryIcon, g as DevframeDockEntriesGrouped, n as DevframeClientCommand, p as ClientScriptEntry, s as DevframeCommandKeybinding, t as DevframeDocksUserSettings } from "../settings-CWHPzCWS.mjs";
-import "../index-faD2d5iX.mjs";
+import "../index-Dv8iu9St.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";

package/dist/{context-Di-fhMKP.d.mts → context-BmHQp89a.d.mts}

@@ -476,6 +476,20 @@ declare module 'devframe/types' {
     'hub:terminals:resize': (id: string, cols: number, rows: number) => Promise<void>;
   }
 }
+/**
+ * A devframe mounted into a hub context, recorded as it is installed
+ * (whether through `initHub({ devframes })`, `buildHub`, or `ctx.install`).
+ * Enumerable via {@link DevframeHubContext.frames} so a host that mounted the
+ * context itself can still discover what to advertise in `__index.json`.
+ */
+interface HubMountedFrame {
+  /** Dock id the devframe mounted under (disambiguated for duplicates). */
+  id: string;
+  /** Hub-base-relative mount base of the frame's SPA (trailing slash). */
+  base: string;
+  /** Human title (the definition's `name`). */
+  title: string;
+}
 /**
  * Hub-augmented node context that extends devframe's framework-neutral
  * `DevframeNodeContext` with the hub-level subsystems (`docks`,
@@ -495,6 +509,13 @@ interface DevframeHubContext extends DevframeNodeContext {
   terminals: DevframeTerminalsHost;
   messages: DevframeMessagesHost;
   commands: DevframeCommandsHost;
+  /**
+   * Every devframe mounted into this context, in mount order. Populated by
+   * `ctx.install` (and the batch mount `initHub`/`buildHub` run through it),
+   * so a host that assembled and mounted the context itself can hand it to
+   * `buildHub({ context })` to emit the discovery documents.
+   */
+  readonly frames: readonly HubMountedFrame[];
   /**
    * Install a {@link DevframeDefinition} into this hub: serve its SPA at the
    * resolved base, synthesize an iframe dock from its metadata, and run its
@@ -518,4 +539,4 @@ interface CreateHubContextOptions extends CreateHostContextOptions {}
  */
 declare function createHubContext(options: CreateHubContextOptions): Promise<DevframeHubContext>;
 //#endregion
-export { DevframeMessagesLevelShortcuts as A, DevframeMessageEntryInput as C, DevframeMessageShortcutInput as D, DevframeMessageLevel as E, DevframeMessagesClient as O, DevframeMessageEntryFrom as S, DevframeMessageHandle as T, DevframeMessageAction as _, DevframeChildProcessExecuteOptions as a, DevframeMessageElementPosition as b, DevframeChildProcessTerminalSession as c, DevframePtyResult as d, DevframePtyTerminalSession as f, DevframeTerminalsHost as g, DevframeTerminalStatus as h, InstallDevframeOptions as i, DevframeMessagesListDelta as j, DevframeMessagesHost as k, DevframePtyExecuteOptions as l, DevframeTerminalSessionBase as m, DevframeHubContext as n, DevframeChildProcessOutput as o, DevframeTerminalSession as p, createHubContext as r, DevframeChildProcessResult as s, CreateHubContextOptions as t, DevframePtyOutput as u, DevframeMessageActivateAction as v, DevframeMessageFilePosition as w, DevframeMessageEntry as x, DevframeMessageCommandAction as y };
+export { DevframeMessagesHost as A, DevframeMessageEntryFrom as C, DevframeMessageLevel as D, DevframeMessageHandle as E, DevframeMessagesListDelta as M, DevframeMessageShortcutInput as O, DevframeMessageEntry as S, DevframeMessageFilePosition as T, DevframeTerminalsHost as _, InstallDevframeOptions as a, DevframeMessageCommandAction as b, DevframeChildProcessResult as c, DevframePtyOutput as d, DevframePtyResult as f, DevframeTerminalStatus as g, DevframeTerminalSessionBase as h, createHubContext as i, DevframeMessagesLevelShortcuts as j, DevframeMessagesClient as k, DevframeChildProcessTerminalSession as l, DevframeTerminalSession as m, DevframeHubContext as n, DevframeChildProcessExecuteOptions as o, DevframePtyTerminalSession as p, HubMountedFrame as r, DevframeChildProcessOutput as s, CreateHubContextOptions as t, DevframePtyExecuteOptions as u, DevframeMessageAction as v, DevframeMessageEntryInput as w, DevframeMessageElementPosition as x, DevframeMessageActivateAction as y };

package/dist/{context-BWaW6N53.mjs → context-Cdrtg-Kk.mjs}

@@ -32,8 +32,8 @@ const diagnostics = defineDiagnostics({
 			fix: "The filenames directly under the hub base (`__connection.json`, `__ws`, `__index.json`, `__client-imports.js`, `__mcp`, `embedded.js`) are reserved for the hub protocol. Rename the devframe id, or override its mount with a non-colliding `basePath`."
 		},
 		DF8002: {
-			why: "initHub received both `devframes` and `context`; the two assembly modes are mutually exclusive.",
-			fix: "Pass `devframes` to let the instance create the hub context and mount each frame itself, or pass a pre-built `context` (your host already mounted the frames), but never both."
+			why: "`initHub`/`buildHub` received both `devframes` and `context`; the two assembly modes are mutually exclusive.",
+			fix: "Pass `devframes` to let it create the hub context and mount each frame itself, or pass a pre-built `context` (your host already mounted the frames), but never both."
 		},
 		DF8003: {
 			why: "connectionMeta() was called before initHub finished initializing.",
@@ -155,7 +155,7 @@ async function resolvePageScriptClientScript(ctx, clientScript, base) {
 	const { importFrom } = clientScript;
 	if (!isAbsolute(importFrom) || !existsSync(importFrom)) return clientScript;
 	const scriptBase = withTrailingSlash(joinURL(base, "__page-script"));
-	await ctx.host.mountStatic(scriptBase, dirname(importFrom));
+	ctx.views.hostStatic(scriptBase, dirname(importFrom));
 	return {
 		...clientScript,
 		importFrom: joinURL(scriptBase, basename(importFrom))
@@ -235,6 +235,11 @@ async function prepareDevframe(ctx, d, options = {}) {
 	const clientScript = await resolvePageScriptClientScript(ctx, dockDefaults.clientScript, base);
 	if (clientScript) dockDefaults.clientScript = clientScript;
 	await serveDevframeAssets(ctx, d, id, base);
+	ctx.frames.push({
+		id,
+		base,
+		title: d.name
+	});
 	ctx.docks.register({
 		id,
 		title: d.name,
@@ -1288,6 +1293,7 @@ async function createHubContext(options) {
 	context.terminals = terminals;
 	context.messages = messages;
 	context.commands = commands;
+	context.frames = [];
 	context.install = (devframe, options) => installDevframe(context, devframe, options);
 	await docks.init();
 	const debounceMs = options.mode === "build" ? 0 : 10;
@@ -1337,4 +1343,4 @@ async function createHubContext(options) {
 	return context;
 }
 //#endregion
-export { DevframeCommandsHost as _, hubMessagesAdd as a, diagnostics as b, 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, prepareDevframe as v, skippedInStaticBuild as y };
+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, prepareDevframe as v, diagnostics as y };

package/dist/{index-faD2d5iX.d.mts → index-Dv8iu9St.d.mts}

@@ -1,4 +1,4 @@
-import "./context-Di-fhMKP.mjs";
+import "./context-BmHQp89a.mjs";
 import "./settings-CWHPzCWS.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";

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { A as DevframeMessagesLevelShortcuts, C as DevframeMessageEntryInput, D as DevframeMessageShortcutInput, E as DevframeMessageLevel, O as DevframeMessagesClient, S as DevframeMessageEntryFrom, T as DevframeMessageHandle, _ as DevframeMessageAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageElementPosition, c as DevframeChildProcessTerminalSession, d as DevframePtyResult, f as DevframePtyTerminalSession, g as DevframeTerminalsHost, h as DevframeTerminalStatus, j as DevframeMessagesListDelta, k as DevframeMessagesHost, l as DevframePtyExecuteOptions, m as DevframeTerminalSessionBase, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalSession, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyOutput, v as DevframeMessageActivateAction, w as DevframeMessageFilePosition, x as DevframeMessageEntry, y as DevframeMessageCommandAction } from "./context-Di-fhMKP.mjs";
+import { A as DevframeMessagesHost, C as DevframeMessageEntryFrom, D as DevframeMessageLevel, E as DevframeMessageHandle, M as DevframeMessagesListDelta, O as DevframeMessageShortcutInput, S as DevframeMessageEntry, T as DevframeMessageFilePosition, _ as DevframeTerminalsHost, b as DevframeMessageCommandAction, c as DevframeChildProcessResult, d as DevframePtyOutput, f as DevframePtyResult, g as DevframeTerminalStatus, h as DevframeTerminalSessionBase, j as DevframeMessagesLevelShortcuts, k as DevframeMessagesClient, l as DevframeChildProcessTerminalSession, m as DevframeTerminalSession, n as DevframeHubContext, o as DevframeChildProcessExecuteOptions, p as DevframePtyTerminalSession, s as DevframeChildProcessOutput, t as CreateHubContextOptions, u as DevframePtyExecuteOptions, v as DevframeMessageAction, w as DevframeMessageEntryInput, x as DevframeMessageElementPosition, y as DevframeMessageActivateAction } from "./context-BmHQp89a.mjs";
 import { A as DevframeViewIframe, C as DevframeDockUserEntry, D as DevframeViewBuiltin, E as DevframeViewAction, F as RemoteConnectionInfo, I as RemoteDockOptions, M as DevframeViewLauncherStatus, N as FrameSubTabsConfig, O as DevframeViewCustomRender, P as NavTarget, S as DevframeDockPanelState, T as DevframeDocksHost, _ 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 DevframeViewLauncher, k as DevframeViewGroup, 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 DevframeDocksActiveState, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "./settings-CWHPzCWS.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-faD2d5iX.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-Dv8iu9St.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/build.d.mts

@@ -1,4 +1,4 @@
-import { n as DevframeHubContext, t as CreateHubContextOptions } from "../context-Di-fhMKP.mjs";
+import { n as DevframeHubContext, t as CreateHubContextOptions } from "../context-BmHQp89a.mjs";
 import { DevframeHubUi, DevframesInput, DockRendererRegistration } from "./initiate.mjs";
 import { DevframeServiceInput, DevframeStorageScope } from "devframe/types";
 //#region src/node/build.d.ts
@@ -18,6 +18,17 @@ interface BuildHubOptions {
   base?: string;
   /** Devframes to bake as docks, same input as `initHub({ devframes })`. */
   devframes?: DevframesInput;
+  /**
+   * Bring your own already-mounted hub context instead of `devframes`, the
+   * build counterpart of `initHub({ context })`: a host that assembled
+   * `createHubContext` + `ctx.install` itself (Vite DevTools' kit-augmented
+   * context, devframes mounted from Vite plugins) hands the mounted context
+   * here and `buildHub` bakes it, reading `ctx.frames` and
+   * `ctx.views.buildStaticDirs` for what to emit. `configure` and the UI
+   * slot's `setup` still run against it, so pass them here rather than running
+   * them yourself. Mutually exclusive with `devframes`.
+   */
+  context?: DevframeHubContext;
   /** Host-level wire services, same contract as `initHub({ services })`. */
   services?: DevframeServiceInput[];
   /** Extra RPC declarations registered at context creation. */
@@ -47,14 +58,22 @@ interface BuildHubOptions {
   getStorageDir?: (scope: DevframeStorageScope) => string;
   /** Pretty-print RPC dump JSON files. Default: `false` (minified shards). */
   pretty?: boolean;
+  /**
+   * Remove {@link BuildHubOptions.outDir} before writing. Default `true`,
+   * matching a from-scratch build. Pass `false` to bake into a directory that
+   * already holds sibling output (an app's own `dist/` the hub subtree lives
+   * beside).
+   */
+  clean?: boolean;
 }
 /**
  * Produce a self-contained static deploy of a whole hub, the multi-devframe
  * counterpart of devframe's `createBuild`:
  *
- *   - Build a `mode: 'build'` hub context and mount every devframe: each
- *     SPA is copied to `<outDir>/<id>/`, an absolute-path page script to
- *     `<outDir>/<id>/__page-script/`, and its `setup(ctx)` runs.
+ *   - Build a `mode: 'build'` hub context and mount every devframe (or reuse a
+ *     `context` a host mounted itself): each SPA is copied to `<outDir>/<id>/`,
+ *     an absolute-path page script to `<outDir>/<id>/__page-script/`, and its
+ *     `setup(ctx)` runs.
  *   - Copy the UI slot's viewer SPA, `embedded.js`, and the renderer
  *     modules, and write the discovery documents (`__index.json`,
  *     `__client-imports.js`).
@@ -66,8 +85,8 @@ interface BuildHubOptions {
  *     (docks, commands, renderer manifest), so `createDevframeClientRuntime`
  *     and every frame SPA boot from the dump with no live server.
  *
- * Reads work from the baked dump; live writes (messages, terminals,
- * commands execution) have no server and degrade to no-ops in the clients.
+ * Reads work from the baked dump; live writes (messages, terminals, commands
+ * execution) have no server and degrade to no-ops in the clients.
  */
 declare function buildHub(options: BuildHubOptions): Promise<void>;
 //#endregion

package/dist/node/build.mjs

@@ -1,6 +1,6 @@
 import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY } from "../constants-Da23JxCZ.mjs";
-import { b as diagnostics, t as createHubContext } from "../context-BWaW6N53.mjs";
-import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-Hj36CCzH.mjs";
+import { t as createHubContext, y as diagnostics } from "../context-Cdrtg-Kk.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-BvY5jfgi.mjs";
 import { joinURL } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME } from "devframe/constants";
 import { existsSync } from "node:fs";
@@ -9,15 +9,17 @@ import process from "node:process";
 import { createH3DevframeHost } from "devframe/internal";
 import { collectStaticRpcDump, writeStaticRpcDump } from "devframe/rpc/dump";
 import { colors } from "devframe/utils/colors";
+import { resolveStaticAssetsSource } from "devframe/utils/remote-assets";
 import { dirname, resolve } from "pathe";
 //#region src/node/build.ts
 /**
 * Produce a self-contained static deploy of a whole hub, the multi-devframe
 * counterpart of devframe's `createBuild`:
 *
-*   - Build a `mode: 'build'` hub context and mount every devframe: each
-*     SPA is copied to `<outDir>/<id>/`, an absolute-path page script to
-*     `<outDir>/<id>/__page-script/`, and its `setup(ctx)` runs.
+*   - Build a `mode: 'build'` hub context and mount every devframe (or reuse a
+*     `context` a host mounted itself): each SPA is copied to `<outDir>/<id>/`,
+*     an absolute-path page script to `<outDir>/<id>/__page-script/`, and its
+*     `setup(ctx)` runs.
 *   - Copy the UI slot's viewer SPA, `embedded.js`, and the renderer
 *     modules, and write the discovery documents (`__index.json`,
 *     `__client-imports.js`).
@@ -29,46 +31,56 @@ import { dirname, resolve } from "pathe";
 *     (docks, commands, renderer manifest), so `createDevframeClientRuntime`
 *     and every frame SPA boot from the dump with no live server.
 *
-* Reads work from the baked dump; live writes (messages, terminals,
-* commands execution) have no server and degrade to no-ops in the clients.
+* Reads work from the baked dump; live writes (messages, terminals, commands
+* execution) have no server and degrade to no-ops in the clients.
 */
 async function buildHub(options) {
+	if (options.context && options.devframes?.length) throw diagnostics.DF8002();
 	const base = normalizeHubBase(options.base ?? "/__devframes/");
 	const cwd = options.cwd ?? process.cwd();
 	const outDir = resolve(cwd, options.outDir);
 	const rendererRegistrations = resolveRendererRegistrations(options.renderers ?? []);
-	if (existsSync(outDir)) await fs.rm(outDir, { recursive: true });
+	const ctx = options.context ?? await createAndMountContext(options, base, cwd);
+	await options.configure?.(ctx);
+	await options.ui?.setup?.(ctx);
+	if (options.clean !== false && existsSync(outDir)) await fs.rm(outDir, { recursive: true });
 	await fs.mkdir(outDir, { recursive: true });
 	/** Map a hub-base-relative URL base to its on-disk location under `outDir`. */
-	function resolveOutPath(urlBase) {
+	const resolveOutPath = (urlBase) => {
 		if (!urlBase.startsWith(base)) throw diagnostics.DF8006({
 			urlBase,
 			base
 		});
 		return resolve(outDir, urlBase.slice(base.length));
-	}
-	const frameMetaBases = [];
+	};
+	await copyBuildStatics(ctx, resolveOutPath);
+	await publishRendererManifest(ctx, rendererRegistrations, base, outDir);
+	await writeUiArtifacts(options.ui, outDir);
+	await fs.writeFile(resolve(outDir, DEVFRAME_DOCK_IMPORTS_FILENAME), renderClientImportsModule(ctx), "utf-8");
+	await writeHubIndex(ctx, base, outDir, options);
+	await writeConnectionMetas(ctx, base, outDir, resolveOutPath);
+	console.log(colors.cyan`[devframes-hub] writing RPC dump to ${resolve(outDir, "__rpc-dump")}`);
+	const dump = await collectStaticRpcDump(ctx.rpc.definitions.values(), ctx);
+	await writeStaticRpcDump(dump, outDir, { pretty: options.pretty });
+	const count = ctx.frames.length;
+	console.log(colors.green`[devframes-hub] built ${count} devframe${count === 1 ? "" : "s"} -> ${outDir}`);
+}
+/**
+* Build a `mode: 'build'` hub context and mount the `devframes` input. The host
+* copies nothing live (`mountStatic`/`mountConnectionMeta` are no-ops): every
+* static is copied afterwards from `ctx.views.buildStaticDirs`, and each frame's
+* meta is written from `ctx.frames`.
+*/
+async function createAndMountContext(options, base, cwd) {
 	const host = {
 		...createH3DevframeHost({
 			origin: "http://localhost",
 			appName: "devframes",
 			workspaceRoot: cwd,
-			/**
-			* A static build "serves" by copying: a local dist verbatim, a remote
-			* assets source by materializing every listed file.
-			*/
-			mount: async (mountBase, source) => {
-				const target = resolveOutPath(mountBase);
-				await fs.mkdir(dirname(target), { recursive: true });
-				if (typeof source === "string") await fs.cp(source, target, { recursive: true });
-				else await source.materialize(target);
-			}
+			mount: () => {}
 		}),
 		...options.getStorageDir ? { getStorageDir: options.getStorageDir } : {},
-		mountConnectionMeta: (frameBase) => {
-			resolveOutPath(frameBase);
-			frameMetaBases.push(frameBase);
-		}
+		mountConnectionMeta: () => {}
 	};
 	const ctx = await createHubContext({
 		cwd,
@@ -79,32 +91,30 @@ async function buildHub(options) {
 	});
 	const devframes = await resolveDevframesInput(options.devframes ?? []);
 	for (const input of options.services ?? []) ctx.services.install(input);
-	const frames = [];
-	const setups = await mountDevframes(ctx, devframes, base, frames, false);
+	const setups = await mountDevframes(ctx, devframes, base, false);
 	await ctx.services.ready();
 	for (const run of setups) await run();
-	await options.configure?.(ctx);
-	await options.ui?.setup?.(ctx);
-	await publishRendererManifest(ctx, rendererRegistrations, base, outDir);
-	await writeUiArtifacts(options.ui, outDir);
-	await fs.writeFile(resolve(outDir, DEVFRAME_DOCK_IMPORTS_FILENAME), renderClientImportsModule(ctx), "utf-8");
-	await fs.writeFile(resolve(outDir, "__index.json"), `${JSON.stringify({
-		name: options.name,
-		version: options.version,
-		base,
-		frames,
-		endpoints: {
-			connection: DEVFRAME_CONNECTION_META_FILENAME,
-			clientImports: DEVFRAME_DOCK_IMPORTS_FILENAME,
-			index: "__index.json",
-			...options.ui?.embedded ? { embedded: "embedded.js" } : {}
-		}
-	}, null, 2)}\n`, "utf-8");
-	await writeConnectionMetas(ctx, base, outDir, frameMetaBases.map(resolveOutPath));
-	console.log(colors.cyan`[devframes-hub] writing RPC dump to ${resolve(outDir, "__rpc-dump")}`);
-	const dump = await collectStaticRpcDump(ctx.rpc.definitions.values(), ctx);
-	await writeStaticRpcDump(dump, outDir, { pretty: options.pretty });
-	console.log(colors.green`[devframes-hub] built ${frames.length} devframe${frames.length === 1 ? "" : "s"} -> ${outDir}`);
+	return ctx;
+}
+/**
+* Copy every static the context registered through `ctx.views.hostStatic`
+* (recorded in `ctx.views.buildStaticDirs`): a local dir verbatim, a remote
+* source by materializing every listed file. Reads the list rather than
+* relying on a live host `mountStatic`, so a context whose host copied no
+* statics at mount time (the build host, or a kit's) still gets its assets in.
+* Each source re-resolves with the `resolveFrom` it was mounted with, so a
+* remote source (e.g. a plugin's `--assets` package) resolves to the same
+* locally-installed copy it would serve live.
+*/
+async function copyBuildStatics(ctx, resolveOutPath) {
+	const storageDir = ctx.host.getStorageDir("project");
+	for (const { baseUrl, source, resolveFrom } of ctx.views.buildStaticDirs) {
+		const target = resolveOutPath(baseUrl);
+		const resolved = resolveStaticAssetsSource(source, storageDir, resolveFrom);
+		await fs.mkdir(dirname(target), { recursive: true });
+		if (typeof resolved === "string") await fs.cp(resolved, target, { recursive: true });
+		else await resolved.materialize(target);
+	}
 }
 /**
 * Publish the renderer manifest exactly like `initHub` does, so it is baked
@@ -137,14 +147,33 @@ async function writeUiArtifacts(ui, outDir) {
 		await fs.writeFile(target, produce());
 	}
 }
+/** Write `<base>__index.json`: the discovery document listing every frame. */
+async function writeHubIndex(ctx, base, outDir, options) {
+	await fs.writeFile(resolve(outDir, "__index.json"), `${JSON.stringify({
+		name: options.name,
+		version: options.version,
+		base,
+		frames: ctx.frames.map(({ id, base, title }) => ({
+			id,
+			base,
+			title
+		})),
+		endpoints: {
+			connection: DEVFRAME_CONNECTION_META_FILENAME,
+			clientImports: DEVFRAME_DOCK_IMPORTS_FILENAME,
+			index: "__index.json",
+			...options.ui?.embedded ? { embedded: "embedded.js" } : {}
+		}
+	}, null, 2)}\n`, "utf-8");
+}
 /**
-* Write the `backend: 'static'` connection meta at the hub base, and a copy
-* at every frame base whose `baseUrl` points relative resolution (the RPC
-* dump) back at the hub's own meta, so a frame SPA that fetched its
-* per-frame copy (instead of inheriting the host page's connection) still
-* finds the shared dump.
+* Write the `backend: 'static'` connection meta at the hub base, and a copy at
+* every frame base that served its own SPA (i.e. registered a static mount at
+* that base) whose `baseUrl` points relative resolution (the RPC dump) back at
+* the hub's own meta, so a frame SPA that fetched its per-frame copy (instead
+* of inheriting the host page's connection) still finds the shared dump.
 */
-async function writeConnectionMetas(ctx, base, outDir, frameDirs) {
+async function writeConnectionMetas(ctx, base, outDir, resolveOutPath) {
 	const jsonSerializableMethods = [];
 	for (const def of ctx.rpc.definitions.values()) if (def.jsonSerializable === true) jsonSerializableMethods.push(def.name);
 	const meta = {
@@ -157,8 +186,10 @@ async function writeConnectionMetas(ctx, base, outDir, frameDirs) {
 		...meta,
 		baseUrl: joinURL(base, DEVFRAME_CONNECTION_META_FILENAME)
 	};
-	for (const frameDir of frameDirs) {
-		const target = resolve(frameDir, DEVFRAME_CONNECTION_META_FILENAME);
+	const servedBases = new Set(ctx.views.buildStaticDirs.map((dir) => dir.baseUrl));
+	for (const frame of ctx.frames) {
+		if (!servedBases.has(frame.base)) continue;
+		const target = resolve(resolveOutPath(frame.base), DEVFRAME_CONNECTION_META_FILENAME);
 		await fs.mkdir(dirname(target), { recursive: true });
 		await fs.writeFile(target, JSON.stringify(frameMeta, null, 2), "utf-8");
 	}

package/dist/node/index.d.mts

@@ -1,4 +1,4 @@
-import { C as DevframeMessageEntryInput, D as DevframeMessageShortcutInput, T as DevframeMessageHandle, a as DevframeChildProcessExecuteOptions, c as DevframeChildProcessTerminalSession, f as DevframePtyTerminalSession, g as DevframeTerminalsHost$1, i as InstallDevframeOptions, j as DevframeMessagesListDelta, k as DevframeMessagesHost$1, l as DevframePtyExecuteOptions, m as DevframeTerminalSessionBase, n as DevframeHubContext, p as DevframeTerminalSession, r as createHubContext, t as CreateHubContextOptions, x as DevframeMessageEntry } from "../context-Di-fhMKP.mjs";
+import { A as DevframeMessagesHost$1, E as DevframeMessageHandle, M as DevframeMessagesListDelta, O as DevframeMessageShortcutInput, S as DevframeMessageEntry, _ as DevframeTerminalsHost$1, a as InstallDevframeOptions, h as DevframeTerminalSessionBase, i as createHubContext, l as DevframeChildProcessTerminalSession, m as DevframeTerminalSession, n as DevframeHubContext, o as DevframeChildProcessExecuteOptions, p as DevframePtyTerminalSession, r as HubMountedFrame, t as CreateHubContextOptions, u as DevframePtyExecuteOptions, w as DevframeMessageEntryInput } from "../context-BmHQp89a.mjs";
 import { C as DevframeDockUserEntry, T as DevframeDocksHost$1, _ as DevframeDockEntry, d as DevframeServerCommandEntry, f as DevframeServerCommandInput, l as DevframeCommandsHost$1, o as DevframeCommandHandle, p as ClientScriptEntry, t as DevframeDocksUserSettings } from "../settings-CWHPzCWS.mjs";
 import { RpcFunctionDefinitionAny } from "devframe/rpc";
 import { SharedState } from "devframe/utils/shared-state";
@@ -388,4 +388,4 @@ declare const builtinHubRpcDeclarations: readonly RpcFunctionDefinitionAny[];
  */
 declare function createSimpleClientScript(fn: string | ((ctx: any) => void)): ClientScriptEntry;
 //#endregion
-export { CreateHubContextOptions, DevframeCommandsHost, DevframeDocksHost, DevframeHubContext, DevframeMessagesHost, DevframeTerminalsHost, type InstallDevframeOptions, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, hubDocksActivate, hubMessagesAdd, hubMessagesClear, hubMessagesRemove, hubMessagesUpdate, hubTerminalsRemove, hubTerminalsResize, hubTerminalsRestart, hubTerminalsTerminate, hubTerminalsWrite };
+export { CreateHubContextOptions, DevframeCommandsHost, DevframeDocksHost, DevframeHubContext, DevframeMessagesHost, DevframeTerminalsHost, HubMountedFrame, type InstallDevframeOptions, builtinHubRpcDeclarations, createHubContext, createSimpleClientScript, hubCommandsExecute, hubDocksActivate, hubMessagesAdd, hubMessagesClear, hubMessagesRemove, hubMessagesUpdate, hubTerminalsRemove, hubTerminalsResize, hubTerminalsRestart, hubTerminalsTerminate, hubTerminalsWrite };

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-BWaW6N53.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-Cdrtg-Kk.mjs";
 import "ufo";
 import "node:fs";
 import "node:process";

package/dist/node/initiate.d.mts

@@ -1,4 +1,4 @@
-import { i as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-Di-fhMKP.mjs";
+import { a as InstallDevframeOptions, n as DevframeHubContext, t as CreateHubContextOptions } from "../context-BmHQp89a.mjs";
 import { r as DEVFRAMES_HUB_BASE } from "../constants-Bz4yclHo.mjs";
 import { DevframeInstanceRecord } from "devframe/internal";
 import { ConnectionMeta, DevframeDefinition, DevframeServiceInput, DevframeSseOptions, DevframeStorageScope, DevframeWsOptions, McpSetting } from "devframe/types";

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-Da23JxCZ.mjs";
-import { b as diagnostics, t as createHubContext } from "../context-BWaW6N53.mjs";
-import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-Hj36CCzH.mjs";
+import { t as createHubContext, y as diagnostics } from "../context-Cdrtg-Kk.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-BvY5jfgi.mjs";
 import { joinURL, withoutLeadingSlash } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE } from "devframe/constants";
 import { readFile } from "node:fs/promises";
@@ -75,7 +75,6 @@ function initHub(options) {
 	const baseNoSlash = base.slice(0, -1);
 	const app = new H3();
 	const cwd = options.cwd ?? process.cwd();
-	const frames = [];
 	const rendererRegistrations = resolveRendererRegistrations(options.renderers ?? []);
 	const shell = createInstanceShell({
 		base,
@@ -118,7 +117,7 @@ function initHub(options) {
 			};
 			const devframes = await resolveDevframesInput(options.devframes ?? []);
 			for (const input of options.services ?? []) ctx.services.install(input);
-			const setups = await mountDevframes(ctx, devframes, base, frames, options.mcp !== false);
+			const setups = await mountDevframes(ctx, devframes, base, options.mcp !== false);
 			await ctx.services.ready();
 			for (const run of setups) await run();
 			await options.configure?.(ctx);
@@ -158,7 +157,11 @@ function initHub(options) {
 				name: options.name,
 				version: options.version,
 				base,
-				frames,
+				frames: ctx.frames.map(({ id, base, title }) => ({
+					id,
+					base,
+					title
+				})),
 				endpoints: {
 					connection: DEVFRAME_CONNECTION_META_FILENAME,
 					clientImports: DEVFRAME_DOCK_IMPORTS_FILENAME,

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-import { A as DevframeMessagesLevelShortcuts, C as DevframeMessageEntryInput, D as DevframeMessageShortcutInput, E as DevframeMessageLevel, O as DevframeMessagesClient, S as DevframeMessageEntryFrom, T as DevframeMessageHandle, _ as DevframeMessageAction, a as DevframeChildProcessExecuteOptions, b as DevframeMessageElementPosition, c as DevframeChildProcessTerminalSession, d as DevframePtyResult, f as DevframePtyTerminalSession, g as DevframeTerminalsHost, h as DevframeTerminalStatus, j as DevframeMessagesListDelta, k as DevframeMessagesHost, l as DevframePtyExecuteOptions, m as DevframeTerminalSessionBase, n as DevframeHubContext, o as DevframeChildProcessOutput, p as DevframeTerminalSession, s as DevframeChildProcessResult, t as CreateHubContextOptions, u as DevframePtyOutput, v as DevframeMessageActivateAction, w as DevframeMessageFilePosition, x as DevframeMessageEntry, y as DevframeMessageCommandAction } from "../context-Di-fhMKP.mjs";
+import { A as DevframeMessagesHost, C as DevframeMessageEntryFrom, D as DevframeMessageLevel, E as DevframeMessageHandle, M as DevframeMessagesListDelta, O as DevframeMessageShortcutInput, S as DevframeMessageEntry, T as DevframeMessageFilePosition, _ as DevframeTerminalsHost, b as DevframeMessageCommandAction, c as DevframeChildProcessResult, d as DevframePtyOutput, f as DevframePtyResult, g as DevframeTerminalStatus, h as DevframeTerminalSessionBase, j as DevframeMessagesLevelShortcuts, k as DevframeMessagesClient, l as DevframeChildProcessTerminalSession, m as DevframeTerminalSession, n as DevframeHubContext, o as DevframeChildProcessExecuteOptions, p as DevframePtyTerminalSession, s as DevframeChildProcessOutput, t as CreateHubContextOptions, u as DevframePtyExecuteOptions, v as DevframeMessageAction, w as DevframeMessageEntryInput, x as DevframeMessageElementPosition, y as DevframeMessageActivateAction } from "../context-BmHQp89a.mjs";
 import { A as DevframeViewIframe, C as DevframeDockUserEntry, D as DevframeViewBuiltin, E as DevframeViewAction, F as RemoteConnectionInfo, I as RemoteDockOptions, M as DevframeViewLauncherStatus, N as FrameSubTabsConfig, O as DevframeViewCustomRender, P as NavTarget, S as DevframeDockPanelState, T as DevframeDocksHost, _ 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 DevframeViewLauncher, k as DevframeViewGroup, 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 DevframeDocksActiveState, x as DevframeDockEntryRegistry, y as DevframeDockEntryCategory } from "../settings-CWHPzCWS.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-faD2d5iX.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-Dv8iu9St.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, DevframeDockPanelState, 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, DevframePtyOutput, DevframePtyResult, 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.10",
+  "version": "0.9.11",
   "description": "Hub layer that orchestrates devframe docks, terminals, messages, and commands on any host.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -35,7 +35,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.9.10"
+    "devframe": "0.9.11"
   },
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -49,7 +49,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
-    "devframe": "0.9.10",
+    "devframe": "0.9.11",
     "get-port-please": "^3.2.0",
     "mlly": "^1.8.2",
     "tsdown": "^0.22.14",