refactor(hub): reuse buildHub({ context }) instead of a bakeHubStatic concept

Rather than introduce a new "bake" verb/function, mirror initHub's existing
`context` option: buildHub now accepts an already-mounted DevframeHubContext
and bakes it (reading ctx.frames + ctx.views.buildStaticDirs), throwing DF8002
if both `context` and `devframes` are passed. The baking helpers fold back into
build.ts as module-private functions; the public surface stays just buildHub.

Author: antfubot

docs/content/1.guide/18.hub-initiate.md

@@ -127,4 +127,4 @@ const hub = initHub({ base: DEVFRAMES_HUB_BASE, context: ctx })
 
 It then serves only hub-level endpoints and transport; serve each mounted devframe's meta from `hub.connectionMeta()` yourself.
 
-The same context works for a static build: `bakeHubStatic(ctx, { outDir, base })` from `@devframes/hub/build` bakes an already-mounted context (`buildHub` is `createHubContext` + `mountDevframes` + `bakeHubStatic`). It reads `ctx.views.buildStaticDirs` for the statics to copy and `ctx.frames` for the frames to advertise, so a host that mounted its own context reuses the exact baker rather than reimplementing it. Pass `clean: false` to bake beside an app's own build output.
+The same `context` option works for a static build: `buildHub({ context: ctx, outDir })` bakes an already-mounted context instead of a `devframes` list, reading `ctx.frames` and `ctx.views.buildStaticDirs` for what to emit, so a host that mounted its own context reuses `buildHub` rather than reimplementing it. Pass `clean: false` to bake beside an app's own build output.

docs/content/6.errors/DF8002.md

@@ -1,15 +1,15 @@
 ---
-title: 'DF8002: Both devframes and context Passed to initHub'
-description: 'initHub received both devframes and context; the two assembly modes are mutually exclusive.'
+title: 'DF8002: Both devframes and context Passed to initHub/buildHub'
+description: 'initHub/buildHub received both devframes and context; the two assembly modes are mutually exclusive.'
 ---
 
 ## Message
 
-> initHub received both `devframes` and `context`; the two assembly modes are mutually exclusive.
+> `initHub`/`buildHub` received both `devframes` and `context`; the two assembly modes are mutually exclusive.
 
 ## Cause
 
-`initHub` assembles a hub two ways: **declaratively** (`devframes: [...]`, where the instance creates the hub context and mounts each devframe under `<base><id>/`), or **from a pre-built context** (`context: ctx`, where your host framework already mounted the devframes and the instance serves only the hub-level endpoints and transport). A `devframes` list cannot be mounted into a context the instance doesn't own, so passing both contradicts.
+`initHub` (and `buildHub`) assembles a hub two ways: **declaratively** (`devframes: [...]`, where it creates the hub context and mounts each devframe under `<base><id>/`), or **from a pre-built context** (`context: ctx`, where your host framework already mounted the devframes). A `devframes` list cannot be mounted into a context it doesn't own, so passing both contradicts.
 
 ## Example
 
@@ -33,3 +33,4 @@ Pick one mode. Use `configure(ctx)` on the declarative mode when you need post-m
 ## Source
 
 - [`packages/hub/src/node/initiate.ts`](https://github.com/devframes/devframe/blob/main/packages/hub/src/node/initiate.ts): `initHub` throws this during initialization when both options are present.
+- [`packages/hub/src/node/build.ts`](https://github.com/devframes/devframe/blob/main/packages/hub/src/node/build.ts): `buildHub` throws this when both options are present.

docs/content/6.errors/DF8006.md

@@ -9,7 +9,7 @@ description: 'A static hub build can only write mounts under its own base: "{url
 
 ## Cause
 
-`bakeHubStatic` (which `buildHub` runs) maps every mounted URL base to a directory under its `outDir` (which corresponds to the hub `base` at serve time), so a mount whose base lies outside the hub base has no on-disk location in the output. This happens when a devframe is installed with an explicit base outside the hub base, e.g. `ctx.install(devframe, { base: '/elsewhere/' })` from `configure`.
+`buildHub` maps every mounted URL base to a directory under its `outDir` (which corresponds to the hub `base` at serve time), so a mount whose base lies outside the hub base has no on-disk location in the output. This happens when a devframe is installed with an explicit base outside the hub base, e.g. `ctx.install(devframe, { base: '/elsewhere/' })` from `configure`.
 
 ## Example
 
@@ -30,4 +30,4 @@ await buildHub({
 
 ## Source
 
-- [`packages/hub/src/node/bake.ts`](https://github.com/devframes/devframe/blob/main/packages/hub/src/node/bake.ts): `bakeHubStatic()`'s mount-to-disk mapping throws this for any mount base outside the hub base.
+- [`packages/hub/src/node/build.ts`](https://github.com/devframes/devframe/blob/main/packages/hub/src/node/build.ts): `buildHub()`'s mount-to-disk mapping throws this for any mount base outside the hub base.

docs/content/8.references/6.hub-api.md

@@ -92,13 +92,10 @@ The options of `buildHub()` from `@devframes/hub/build`: [Static builds](/guide/
 |---|---|
 | `outDir` | Output directory for the hub subtree; corresponds to `base` at serve time (build `base: '/__devframes/'` into `dist/__devframes`). |
 | `base` | Mount base baked into every absolute URL the build emits. Default `/__devframes/`. |
+| `context` | An already-mounted `DevframeHubContext` to bake instead of `devframes` (the build counterpart of `initHub({ context })`); reads `ctx.frames` and `ctx.views.buildStaticDirs`. Mutually exclusive with `devframes`. |
 | `clean` | Remove `outDir` before writing. Default `true`; set `false` to bake beside an app's own build output. |
 | `pretty` | Pretty-print RPC dump JSON shards. Default `false` (minified). |
 
-## `bakeHubStatic` options
-
-`bakeHubStatic(ctx, options)` from `@devframes/hub/build` is the second half of `buildHub`: it bakes an already-mounted `DevframeHubContext` a caller assembled itself (`createHubContext` + `ctx.install`, or a framework kit's own context), reading `ctx.views.buildStaticDirs` for the statics to copy and `ctx.frames` for the frames to advertise. `buildHub` is `createHubContext` + `mountDevframes` + `bakeHubStatic`. Options: `outDir`, `base`, `ui`, `renderers`, `name`, `version`, `pretty`, and `clean`, same contracts as their `buildHub` counterparts.
-
 ## Client runtime options
 
 The options of `createDevframeClientRuntime()`: [The client runtime](/guide/client-context#the-client-runtime).

packages/hub/src/node/__tests__/build.test.ts

@@ -5,7 +5,6 @@ import { join } from 'node:path'
 import { createH3DevframeHost } from 'devframe/internal'
 import { describe, expect, it } from 'vitest'
 import { HUB_EVENTS } from '../../events'
-import { bakeHubStatic } from '../bake'
 import { buildHub } from '../build'
 import { createHubContext } from '../context'
 
@@ -139,22 +138,22 @@ describe('buildHub', () => {
     expect(readFileSync(join(outDir, 'beta/index.html'), 'utf-8')).toContain('beta')
   })
 
-  it('bakes an externally-mounted context via bakeHubStatic', async () => {
-    const outDir = join(mkdtempSync(join(tmpdir(), 'hub-bake-out-')), 'hub')
-    const cwd = mkdtempSync(join(tmpdir(), 'hub-bake-cwd-'))
+  it('bakes an externally-mounted context passed as `context`', async () => {
+    const outDir = join(mkdtempSync(join(tmpdir(), 'hub-ctx-out-')), 'hub')
+    const cwd = mkdtempSync(join(tmpdir(), 'hub-ctx-cwd-'))
 
     // A host assembling the context itself: create + mount via `ctx.install`,
-    // then hand the already-mounted context to the baker.
+    // then hand the already-mounted context to `buildHub`.
     const host = createH3DevframeHost({ origin: 'http://localhost', appName: 'devframes', workspaceRoot: cwd, mount: () => {} })
     const ctx = await createHubContext({ cwd, workspaceRoot: cwd, mode: 'build', host })
     await ctx.install(makeFrame('alpha', { distDir: makeDist('<h1>alpha</h1>') }), { base: '/__hub/alpha/' })
 
     expect(ctx.frames.map(frame => frame.id)).toEqual(['alpha'])
 
-    await bakeHubStatic(ctx, { outDir, base: '/__hub/' })
+    await buildHub({ context: ctx, outDir, base: '/__hub/' })
 
-    // The baker copied the SPA from `ctx.views.buildStaticDirs`, wrote the
-    // index from `ctx.frames`, and emitted the per-frame meta + shared dump.
+    // The SPA was copied from `ctx.views.buildStaticDirs`, the index written
+    // from `ctx.frames`, and the per-frame meta + shared dump emitted.
     expect(readFileSync(join(outDir, 'alpha/index.html'), 'utf-8')).toContain('alpha')
     const index = JSON.parse(readFileSync(join(outDir, '__index.json'), 'utf-8'))
     expect(index.frames.map((frame: { id: string }) => frame.id)).toEqual(['alpha'])