@bitmagic/cli 0.1.83-dev.5 → 0.1.83-dev.7

package/dist/publish/bundle.js

@@ -7,6 +7,9 @@ import { projectBin } from '../project/context.js';
 import { spawnBinSync } from '../project/spawn-bin.js';
 import { computeFingerprint } from './fingerprint.js';
 import { describeDevOnlyThreeUses, scanWorkForDevOnlyThree } from '../project/published-three.js';
+import { readEngineCapabilities } from '../scaffold/engine-capabilities.js';
+import { PAGES_OUTPUT_DIR, pagesAssetHostMeta, requireStaticPageEngine, } from '../scaffold/github-pages.js';
+import { renderIndexHtml } from '../scaffold/project-files.js';
 /**
  * The configs the scaffold vendors alongside `engine/`, one per bundle mode.
  *
@@ -103,38 +106,22 @@ export function isCurrentBundle(root, fingerprint, singleFile) {
     return createHash('sha256').update(contents).digest('hex') === manifest.sha256;
 }
 /**
- * Compile and bundle the project into one HTML file, and record what was built.
- *
- * One file either way — `bitmagic publish` PUTs a single object and api-server range-reads that
- * same object to confirm the meta block, so there is nowhere for a second file to go. What the
- * mode changes is what is INSIDE it: by default the engine, the game and its data are inlined
- * while three.js, Rapier and the other CDN packages are fetched at runtime, matching what the
- * Creator publishes; `singleFile` inlines those too, for a game that must run with no network.
- *
- * Exit code 1 on failure, matching the table in the spec: a build failure is the creator's own
- * code, and the compiler's output has already been printed.
- *
- * The pre-flight below runs BEFORE `tsc`, not after: a project scaffolded before the config it
- * needs existed has none for vite to load, and without this check the creator pays a full
- * type-check and then reads a raw vite "config not found" that names no remedy. `bitmagic upgrade`
- * is the remedy — it vendors the file without touching game code — so the error says so. It names
- * the config for the mode actually asked for, since a project can easily have one and not the
- * other: the standalone config was added later than the default one.
- */
-export function runBuild(root, engineVersion, 
-/**
- * `stderr: true` sends the compiler's and bundler's own chatter to stderr instead of inheriting
- * stdout — a `--json` run must keep stdout clean for its single result document.
+ * The pre-flight every bundle mode shares. It runs BEFORE `tsc`, not after: a project scaffolded
+ * before the config it needs existed has none for vite to load, and without this check the creator
+ * pays a full type-check and then reads a raw vite "config not found" that names no remedy.
  */
-options = {}) {
-    const singleFile = options.singleFile === true;
-    const configFile = publishConfigFor(singleFile);
+function requirePublishConfig(root, configFile) {
     if (!fs.existsSync(path.join(root, configFile))) {
         throw new CliError(`This project has no ${configFile}, which \`bitmagic build\` needs to bundle it. ` +
             'It was added to the scaffold after this project was created — run `bitmagic upgrade` to ' +
             'vendor it (your game code is not touched), then build again.', 1);
     }
-    const stdio = options.stderr === true ? ['ignore', 2, 2] : 'inherit';
+}
+function buildStdio(options) {
+    return options.stderr === true ? ['ignore', 2, 2] : 'inherit';
+}
+/** `tsc`, then the dev-only three.js scan: what has to pass before anything is bundled. */
+function compileForBundle(root, stdio) {
     const tsc = projectBin(root, 'tsc');
     const compile = spawnBinSync(tsc, [], { cwd: root, stdio });
     if (compile.error)
@@ -146,8 +133,8 @@ options = {}) {
     const devOnlyThree = scanWorkForDevOnlyThree(root);
     if (devOnlyThree.length > 0)
         throw new CliError(`Build failed. ${describeDevOnlyThreeUses(devOnlyThree)}`, 1);
-    const { dir, htmlPath } = buildBundlePaths(root);
-    fs.mkdirSync(dir, { recursive: true });
+}
+function bundleWithVite(root, configFile, outDir, stdio) {
     const vite = projectBin(root, 'vite');
     // Covers `bitmagic build`, `bitmagic publish` and `bitmagic ios` in one
     // place: the vendored configs read BUNDLE_RAPIER_FLAVOR and stub the Rapier
@@ -155,7 +142,7 @@ options = {}) {
     // variable is OWNED here — an inherited value from the caller's shell never
     // overrides the game's own physics mode.
     const bundleEnv = { ...process.env, BUNDLE_RAPIER_FLAVOR: resolveRapierFlavor(root) };
-    const bundle = spawnBinSync(vite, ['build', '--config', configFile, '--outDir', dir, '--emptyOutDir'], {
+    const bundle = spawnBinSync(vite, ['build', '--config', configFile, '--outDir', outDir, '--emptyOutDir'], {
         cwd: root,
         stdio,
         env: bundleEnv,
@@ -164,6 +151,40 @@ options = {}) {
         throw new CliError(`Could not run vite: ${bundle.error.message}`, 1);
     if (bundle.status !== 0)
         throw new CliError('Build failed: the bundle did not complete.', 1);
+}
+/**
+ * Compile and bundle the project into one HTML file, and record what was built.
+ *
+ * One file either way — `bitmagic publish` PUTs a single object and api-server range-reads that
+ * same object to confirm the meta block, so there is nowhere for a second file to go. What the
+ * mode changes is what is INSIDE it: by default the engine, the game and its data are inlined
+ * while three.js, Rapier and the other CDN packages are fetched at runtime, matching what the
+ * Creator publishes; `singleFile` inlines those too, for a game that must run with no network.
+ *
+ * Exit code 1 on failure, matching the table in the spec: a build failure is the creator's own
+ * code, and the compiler's output has already been printed.
+ *
+ * The pre-flight below runs BEFORE `tsc`, not after: a project scaffolded before the config it
+ * needs existed has none for vite to load, and without this check the creator pays a full
+ * type-check and then reads a raw vite "config not found" that names no remedy. `bitmagic upgrade`
+ * is the remedy — it vendors the file without touching game code — so the error says so. It names
+ * the config for the mode actually asked for, since a project can easily have one and not the
+ * other: the standalone config was added later than the default one.
+ */
+export function runBuild(root, engineVersion, 
+/**
+ * `stderr: true` sends the compiler's and bundler's own chatter to stderr instead of inheriting
+ * stdout — a `--json` run must keep stdout clean for its single result document.
+ */
+options = {}) {
+    const singleFile = options.singleFile === true;
+    const configFile = publishConfigFor(singleFile);
+    requirePublishConfig(root, configFile);
+    const stdio = buildStdio(options);
+    compileForBundle(root, stdio);
+    const { dir, htmlPath } = buildBundlePaths(root);
+    fs.mkdirSync(dir, { recursive: true });
+    bundleWithVite(root, configFile, dir, stdio);
     if (!fs.existsSync(htmlPath)) {
         throw new CliError(`Build produced no ${path.relative(root, htmlPath)}. Check ${configFile}.`, 1);
     }
@@ -179,4 +200,89 @@ options = {}) {
     writeBuildManifest(root, manifest);
     return manifest;
 }
+/** Where `bitmagic build --pages` puts its page, and the scratch directory it builds it from. */
+export function pagesBundlePaths(root) {
+    const dir = path.join(root, PAGES_OUTPUT_DIR);
+    return { dir, htmlPath: path.join(dir, 'index.html'), sourceDir: path.join(root, '.bitmagic', 'pages-src') };
+}
+/**
+ * The Vite config a Pages build runs: the project's own vendored publish config, with the static
+ * page as its input instead of the project's `index.html`. Everything else (aliases, the CDN
+ * table, `__BUNDLED__`, the Rapier stub, the licence banner, single-file output) is the vendored
+ * config's, so a Pages page ships exactly what a publish ships around a different entry module.
+ *
+ * Generated next to the page for each build rather than vendored, so the vendored configs stay
+ * byte-identical in every project and a project on an older scaffold needs no upgrade for it. Vite
+ * bundles a config's relative imports, which is how this file reaches the vendored one.
+ */
+export function renderPagesViteConfig(baseConfigFile, inputHtml) {
+    return `// Generated by \`bitmagic build --pages\` for one build; never edit it, it is rewritten every time.
+// The project's vendored ${baseConfigFile}, with the static GitHub Pages page as the input.
+import base from '../../${baseConfigFile}';
+
+export default {
+  ...base,
+  build: {
+    ...base.build,
+    rollupOptions: {
+      ...base.build.rollupOptions,
+      input: ${JSON.stringify(inputHtml)},
+    },
+  },
+};
+`;
+}
+/**
+ * `bitmagic build --pages`: compile and bundle the project into `.bitmagic/pages/index.html`, the
+ * STATIC page the GitHub Pages workflow deploys (`scaffold/github-pages.ts`).
+ *
+ * The page differs from the publish bundle in its entry and its metas only: it boots
+ * `bitmagic/boot-static.js` (no platform services, so nothing calls api-server or game-server from
+ * a `*.github.io` origin) and declares `bm:platform` `bitmagic-static`, plus `bm:asset-host` for a
+ * non-default `pagesHosting`. It never touches `.bitmagic/build/`, whose manifest `publish` reuses.
+ *
+ * An engine without `staticPage` is refused before the compile, as is an unreadable `pagesHosting`.
+ */
+export function runPagesBuild(root, options = {}) {
+    const capabilities = readEngineCapabilities(path.join(root, 'engine'));
+    requireStaticPageEngine(capabilities);
+    const assetHost = pagesAssetHostMeta(options.pagesHosting);
+    const singleFile = options.singleFile === true;
+    const configFile = publishConfigFor(singleFile);
+    requirePublishConfig(root, configFile);
+    const stdio = buildStdio(options);
+    compileForBundle(root, stdio);
+    const { dir, htmlPath, sourceDir } = pagesBundlePaths(root);
+    fs.rmSync(sourceDir, { recursive: true, force: true });
+    fs.mkdirSync(sourceDir, { recursive: true });
+    const inputHtml = path.join(sourceDir, 'index.html');
+    fs.writeFileSync(inputHtml, renderIndexHtml({ capabilities, staticPage: { assetHost } }));
+    const pagesConfig = path.join(sourceDir, 'vite.pages.config.mjs');
+    fs.writeFileSync(pagesConfig, renderPagesViteConfig(configFile, inputHtml));
+    try {
+        bundleWithVite(root, path.relative(root, pagesConfig), dir, stdio);
+        // Vite writes an HTML input under its path relative to the root, so the page lands at
+        // <outDir>/.bitmagic/pages-src/index.html; Pages serves the directory's own index.html.
+        const emitted = path.join(dir, path.relative(root, inputHtml));
+        if (!fs.existsSync(emitted)) {
+            throw new CliError(`Build produced no ${path.relative(root, emitted)}. Check ${configFile}.`, 1);
+        }
+        fs.renameSync(emitted, htmlPath);
+        fs.rmSync(path.join(dir, path.relative(root, inputHtml).split(path.sep)[0]), {
+            recursive: true,
+            force: true,
+        });
+    }
+    finally {
+        fs.rmSync(sourceDir, { recursive: true, force: true });
+    }
+    const contents = fs.readFileSync(htmlPath);
+    return {
+        htmlPath,
+        singleFile,
+        assetHost,
+        bytes: contents.byteLength,
+        sha256: createHash('sha256').update(contents).digest('hex'),
+    };
+}
 //# sourceMappingURL=bundle.js.map

package/dist/publish/bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../src/publish/bundle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../src/publish/bundle.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/engine-capabilities.d.ts

@@ -15,6 +15,16 @@
  *    it the page loads `engine/GameTemplate.js` as it always has (`renderIndexHtml`).
  *  - `gameExchange`: the engine can show Game Exchange tiles. Older engines are recognised by
  *    their exchange module instead; see `vendoredEngineSupportsExchange`.
+ *  - `hostingSeam`: asset hosting is a platform slice. The engine's `AnimationAssets` exports a
+ *    pure `createAnimationAssets(hosting)`, and the Bitmagic package carries its own preset in
+ *    `bitmagic/hosting/BitmagicCdnHosting.js` (`bitmagicCdn()`). Node readers of the engine's
+ *    URL tables (`loadAnimationAssets`) pass that preset explicitly instead of taking the engine's
+ *    default, which stops being Bitmagic's. Without it they import the module's `animationAssets`
+ *    as they always have.
+ *  - `staticPage`: the engine carries `bitmagic/boot-static.js`, the entry of the static page
+ *    `bitmagic build --pages` builds for GitHub Pages (no platform services, the engine's files
+ *    on the Bitmagic CDN). Without it `bitmagic pages init` and `build --pages` refuse with an
+ *    upgrade hint (`requireStaticPageEngine` in `github-pages.ts`).
  */
 export interface EngineCapabilities {
     readonly [name: string]: number | undefined;

package/dist/scaffold/engine-capabilities.js

@@ -18,10 +18,7 @@ export function readEngineCapabilities(engineDir) {
     catch {
         return NO_ENGINE_CAPABILITIES;
     }
-    if (typeof parsed !== 'object' || parsed === null || !('capabilities' in parsed)) {
-        return NO_ENGINE_CAPABILITIES;
-    }
-    const raw = parsed.capabilities;
+    const raw = typeof parsed === 'object' && parsed !== null && 'capabilities' in parsed ? parsed.capabilities : null;
     if (typeof raw !== 'object' || raw === null)
         return NO_ENGINE_CAPABILITIES;
     const capabilities = {};

package/dist/scaffold/engine-capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-capabilities.js","sourceRoot":"","sources":["../../src/scaffold/engine-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAwB7B,2FAA2F;AAC3F,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;AAEpF,oFAAoF;AACpF,MAAM,CAAC,MAAM,sBAAsB,GAAuB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAChG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,cAAc,IAAI,MAAM,CAAC,EAAE,CAAC;QACjF,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC;IAChC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,sBAAsB,CAAC;IAC3E,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACpG,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CACjC,YAAgC,EAChC,IAAY,EACZ,OAAO,GAAG,CAAC;IAEX,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,OAAO,CAAC;AACjD,CAAC"}
+{"version":3,"file":"engine-capabilities.js","sourceRoot":"","sources":["../../src/scaffold/engine-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAkC7B,2FAA2F;AAC3F,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;AAEpF,oFAAoF;AACpF,MAAM,CAAC,MAAM,sBAAsB,GAAuB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAiB;IACtD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAChG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,sBAAsB,CAAC;IAChC,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,cAAc,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IACnH,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,sBAAsB,CAAC;IAC3E,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACpG,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB,CACjC,YAAgC,EAChC,IAAY,EACZ,OAAO,GAAG,CAAC;IAEX,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,IAAI,OAAO,CAAC;AACjD,CAAC"}

package/dist/scaffold/github-pages.d.ts

@@ -0,0 +1,83 @@
+import type { PackageManager } from '../project/package-manager.js';
+import { type EngineCapabilities } from './engine-capabilities.js';
+/**
+ * The GitHub Pages target for a standalone project (engine OSS audit W5.6 §2.6, decision H-h):
+ * `bitmagic pages init` writes the workflow below, and the workflow runs `bitmagic build --pages`
+ * on every push to the default branch and deploys `.bitmagic/pages/` with GitHub's own Pages
+ * actions.
+ *
+ * What `build --pages` makes is a STATIC page: it boots through `bitmagic/boot-static.js`, which
+ * registers no platform services, so a `*.github.io` page never calls api-server, game-server or
+ * GTM. Only the engine's own files still come from Bitmagic: the Bitmagic CDN, until the open
+ * engine's asset site exists (`pagesHosting` in `bitmagic.json` switches that).
+ */
+/** Where `bitmagic pages init` writes the workflow, relative to the project root. */
+export declare const PAGES_WORKFLOW_PATH = ".github/workflows/bitmagic-pages.yml";
+/** The directory `bitmagic build --pages` writes and the workflow uploads, relative to the root. */
+export declare const PAGES_OUTPUT_DIR = ".bitmagic/pages";
+/** The engine capability a vendored engine advertises once it carries `bitmagic/boot-static.ts`. */
+export declare const STATIC_PAGE_CAPABILITY = "staticPage";
+/** The `bm:platform` id the static page declares and `bitmagic/register-static.ts` registers. */
+export declare const BITMAGIC_STATIC_PLATFORM_ID = "bitmagic-static";
+/**
+ * Refuses an engine without the static page, before anything is written or built. The page boots
+ * `bitmagic/boot-static.js`; on an engine that has none, the build would compile clean and then
+ * fail in Vite on an unresolved entry, naming a file the creator never wrote.
+ */
+export declare function requireStaticPageEngine(capabilities: EngineCapabilities): void;
+/** The values `pagesHosting` in `bitmagic.json` takes, besides a root URL. */
+export declare const PAGES_HOSTING_PRESETS: readonly ["bitmagic-cdn", "github-pages"];
+export type PagesHostingPreset = (typeof PAGES_HOSTING_PRESETS)[number];
+/** The default: the engine's files from the Bitmagic CDN, which is where they all are today. */
+export declare const DEFAULT_PAGES_HOSTING: PagesHostingPreset;
+/**
+ * The `<meta name="bm:asset-host">` content the static page carries for `bitmagic.json`'s
+ * `pagesHosting`, or null for none.
+ *
+ * - absent, or `"bitmagic-cdn"`: no meta. The static platform registers the Bitmagic CDN preset,
+ *   and a page with no meta takes the platform's hosting (`resolveHosting` in the engine's
+ *   `runtime/hosting.ts`).
+ * - `"github-pages"`: the meta `github-pages`, the open engine's own asset site. That site does
+ *   not exist yet, so a page built this way loads no engine assets until it does.
+ * - a root URL (`https://…`, `http://…`, or a page-relative `./…`, `../…` or `/…` path): the meta
+ *   names that root, which the engine reads as a self-hosted copy of the engine's files.
+ *
+ * Anything else is refused: the engine would read an unknown name as an unregistered provider and
+ * silently fall back to the platform's hosting, which is the opposite of what the creator asked.
+ */
+export declare function pagesAssetHostMeta(pagesHosting: unknown): string | null;
+export interface GithubPagesWorkflowOptions {
+    /**
+     * The CLI version the workflow runs, pinned: the version that scaffolded it. An unpinned `npx`
+     * would build with whatever was published last, against an engine this project may not have.
+     */
+    cliVersion: string;
+    /** The project's package manager, from its lockfile (`detectPackageManager`). */
+    packageManager: PackageManager;
+    /**
+     * The branch whose pushes deploy: the repository's default branch (`detectDefaultBranch`).
+     * Named literally, because `$default-branch` only works in GitHub's workflow templates; in a
+     * repository's own workflow file it is a branch called `$default-branch`, and nothing deploys.
+     */
+    branch: string;
+}
+/**
+ * `.github/workflows/bitmagic-pages.yml`.
+ *
+ * Action majors follow this repository's own workflows (`actions/checkout@v6`,
+ * `actions/setup-node@v6`, `pnpm/action-setup@v5`); the two Pages actions, which the repository
+ * does not otherwise use, are pinned to their current majors. Checkout fetches LFS objects,
+ * because a project may keep large models there and the bundle inlines nothing it cannot read.
+ */
+export declare function renderGithubPagesWorkflow(options: GithubPagesWorkflowOptions): string;
+/**
+ * What `bitmagic pages init` prints after writing the workflow: the one step only the creator can
+ * take, the limits GitHub sets, and the terms note. Lines, so `--json` can carry them as an array.
+ */
+export declare function pagesSetupNotes(): string[];
+/**
+ * The repository's default branch, for the workflow's push trigger: the remote's `HEAD` when the
+ * clone knows it, else the branch checked out now, else `main` (GitHub's default for a new
+ * repository). `bitmagic pages init --branch` overrides it.
+ */
+export declare function detectDefaultBranch(root: string): string;

package/dist/scaffold/github-pages.js

@@ -0,0 +1,200 @@
+import { CliError } from '../errors.js';
+import { spawnPathCommandSync } from '../project/spawn-bin.js';
+import { hasEngineCapability } from './engine-capabilities.js';
+/**
+ * The GitHub Pages target for a standalone project (engine OSS audit W5.6 §2.6, decision H-h):
+ * `bitmagic pages init` writes the workflow below, and the workflow runs `bitmagic build --pages`
+ * on every push to the default branch and deploys `.bitmagic/pages/` with GitHub's own Pages
+ * actions.
+ *
+ * What `build --pages` makes is a STATIC page: it boots through `bitmagic/boot-static.js`, which
+ * registers no platform services, so a `*.github.io` page never calls api-server, game-server or
+ * GTM. Only the engine's own files still come from Bitmagic: the Bitmagic CDN, until the open
+ * engine's asset site exists (`pagesHosting` in `bitmagic.json` switches that).
+ */
+/** Where `bitmagic pages init` writes the workflow, relative to the project root. */
+export const PAGES_WORKFLOW_PATH = '.github/workflows/bitmagic-pages.yml';
+/** The directory `bitmagic build --pages` writes and the workflow uploads, relative to the root. */
+export const PAGES_OUTPUT_DIR = '.bitmagic/pages';
+/** The engine capability a vendored engine advertises once it carries `bitmagic/boot-static.ts`. */
+export const STATIC_PAGE_CAPABILITY = 'staticPage';
+/** The `bm:platform` id the static page declares and `bitmagic/register-static.ts` registers. */
+export const BITMAGIC_STATIC_PLATFORM_ID = 'bitmagic-static';
+/**
+ * Refuses an engine without the static page, before anything is written or built. The page boots
+ * `bitmagic/boot-static.js`; on an engine that has none, the build would compile clean and then
+ * fail in Vite on an unresolved entry, naming a file the creator never wrote.
+ */
+export function requireStaticPageEngine(capabilities) {
+    if (hasEngineCapability(capabilities, STATIC_PAGE_CAPABILITY))
+        return;
+    throw new CliError('This project\'s engine predates the GitHub Pages target: it has no static page '
+        + '(`staticPage` in engine/engine/engine-manifest.json). Run `bitmagic upgrade` to update the '
+        + 'engine (your game code is not touched), then try again.', 1);
+}
+/** The values `pagesHosting` in `bitmagic.json` takes, besides a root URL. */
+export const PAGES_HOSTING_PRESETS = ['bitmagic-cdn', 'github-pages'];
+/** The default: the engine's files from the Bitmagic CDN, which is where they all are today. */
+export const DEFAULT_PAGES_HOSTING = 'bitmagic-cdn';
+/**
+ * The `<meta name="bm:asset-host">` content the static page carries for `bitmagic.json`'s
+ * `pagesHosting`, or null for none.
+ *
+ * - absent, or `"bitmagic-cdn"`: no meta. The static platform registers the Bitmagic CDN preset,
+ *   and a page with no meta takes the platform's hosting (`resolveHosting` in the engine's
+ *   `runtime/hosting.ts`).
+ * - `"github-pages"`: the meta `github-pages`, the open engine's own asset site. That site does
+ *   not exist yet, so a page built this way loads no engine assets until it does.
+ * - a root URL (`https://…`, `http://…`, or a page-relative `./…`, `../…` or `/…` path): the meta
+ *   names that root, which the engine reads as a self-hosted copy of the engine's files.
+ *
+ * Anything else is refused: the engine would read an unknown name as an unregistered provider and
+ * silently fall back to the platform's hosting, which is the opposite of what the creator asked.
+ */
+export function pagesAssetHostMeta(pagesHosting) {
+    if (pagesHosting === undefined || pagesHosting === DEFAULT_PAGES_HOSTING)
+        return null;
+    if (pagesHosting === 'github-pages')
+        return 'github-pages';
+    if (typeof pagesHosting === 'string' && /^(https?:\/\/[^\s"<>]+|\.{0,2}\/[^\s"<>]*)$/.test(pagesHosting)) {
+        return pagesHosting;
+    }
+    throw new CliError(`bitmagic.json's "pagesHosting" is ${JSON.stringify(pagesHosting)}, which is not one of `
+        + `${PAGES_HOSTING_PRESETS.map((p) => `"${p}"`).join(', ')} or a root URL (https://… or ./…). `
+        + 'Remove the field to keep the default, the Bitmagic CDN.', 1);
+}
+/** A branch name the workflow can carry unquoted in a YAML flow sequence. */
+const PLAIN_BRANCH = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;
+/**
+ * The install steps for the project's lockfile, indented to sit in the build job's `steps:`.
+ *
+ * pnpm needs its own setup action (a scaffolded package.json has no `packageManager` field, so the
+ * major version is named here) and must come before setup-node's cache. The frozen-lockfile
+ * installs are deliberate: CI must build what was committed, not re-resolve it.
+ */
+function installSteps(manager) {
+    if (manager === 'pnpm') {
+        return `      - uses: pnpm/action-setup@v5
+        with:
+          version: 10
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile`;
+    }
+    if (manager === 'yarn') {
+        return `      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: yarn
+      - run: yarn install --frozen-lockfile`;
+    }
+    return `      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: npm
+      - run: npm ci`;
+}
+/**
+ * `.github/workflows/bitmagic-pages.yml`.
+ *
+ * Action majors follow this repository's own workflows (`actions/checkout@v6`,
+ * `actions/setup-node@v6`, `pnpm/action-setup@v5`); the two Pages actions, which the repository
+ * does not otherwise use, are pinned to their current majors. Checkout fetches LFS objects,
+ * because a project may keep large models there and the bundle inlines nothing it cannot read.
+ */
+export function renderGithubPagesWorkflow(options) {
+    if (!/^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?$/.test(options.cliVersion)) {
+        throw new CliError(`Cannot pin the workflow to this CLI's version (${JSON.stringify(options.cliVersion)}). `
+            + 'Reinstall the CLI with `bitmagic self-update` and run `bitmagic pages init` again.', 1);
+    }
+    if (!PLAIN_BRANCH.test(options.branch)) {
+        throw new CliError(`Cannot deploy from the branch ${JSON.stringify(options.branch)}: name a plain branch with --branch.`, 1);
+    }
+    return `# Builds this Bitmagic game and deploys it to GitHub Pages on every push to ${options.branch}.
+# Written by \`bitmagic pages init\`; run it again to refresh this file.
+#
+# One-time setup: Settings -> Pages -> Build and deployment -> Source: GitHub Actions.
+#
+# The page is static: no Bitmagic sign-in, cloud saves, leaderboards, multiplayer or runtime AI.
+# The engine's own files load from the Bitmagic CDN (\`pagesHosting\` in bitmagic.json).
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [${options.branch}]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          lfs: true
+${installSteps(options.packageManager)}
+      - run: npx --yes @bitmagic/cli@${options.cliVersion} build --pages
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: ${PAGES_OUTPUT_DIR}/
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: \${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v5
+`;
+}
+/**
+ * What `bitmagic pages init` prints after writing the workflow: the one step only the creator can
+ * take, the limits GitHub sets, and the terms note. Lines, so `--json` can carry them as an array.
+ */
+export function pagesSetupNotes() {
+    return [
+        'One manual step: on GitHub, open the repository\'s Settings -> Pages -> Build and deployment, '
+            + 'and set Source to "GitHub Actions". Then push to the default branch (or run the workflow from '
+            + 'the Actions tab) and the game deploys.',
+        'The page is static: no Bitmagic sign-in, cloud saves, leaderboards, multiplayer or runtime AI. '
+            + 'The engine\'s own files (characters, animations) load from the Bitmagic CDN.',
+        'GitHub Pages limits: 1 GB per site, and a soft bandwidth limit of 100 GB per month.',
+        'GitHub Pages is not meant to run a commercial business. A game run mainly as one fits the '
+            + 'Bitmagic CDN (`bitmagic publish`) or another host better. Your game\'s licence terms are in '
+            + 'engine/LICENSE.md.',
+    ];
+}
+/**
+ * The repository's default branch, for the workflow's push trigger: the remote's `HEAD` when the
+ * clone knows it, else the branch checked out now, else `main` (GitHub's default for a new
+ * repository). `bitmagic pages init --branch` overrides it.
+ */
+export function detectDefaultBranch(root) {
+    const git = (args) => {
+        const result = spawnPathCommandSync('git', ['-C', root, ...args], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+        if (result.error !== undefined || result.status !== 0)
+            return null;
+        const out = String(result.stdout).trim();
+        return out.length > 0 ? out : null;
+    };
+    const remoteHead = git(['symbolic-ref', '--short', 'refs/remotes/origin/HEAD']);
+    if (remoteHead !== null && remoteHead.startsWith('origin/'))
+        return remoteHead.slice('origin/'.length);
+    const current = git(['symbolic-ref', '--short', 'HEAD']);
+    if (current !== null)
+        return current;
+    return 'main';
+}
+//# sourceMappingURL=github-pages.js.map

package/dist/scaffold/github-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-pages.js","sourceRoot":"","sources":["../../src/scaffold/github-pages.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/project-files.d.ts

@@ -63,6 +63,17 @@ export interface IndexHtmlOptions {
      * directory to load.
      */
     capabilities: EngineCapabilities;
+    /**
+     * Render the STATIC page `bitmagic build --pages` bundles for GitHub Pages instead of the
+     * project's own page: it boots through `bitmagic/boot-static.js` (no platform services, the
+     * engine's files on the Bitmagic CDN) and declares `<meta name="bm:platform"
+     * content="bitmagic-static">`, plus `<meta name="bm:asset-host">` when `assetHost` is a string
+     * (`pagesAssetHostMeta` in `github-pages.ts`). Only for an engine that advertises `staticPage`.
+     * Absent, the page is byte for byte the one every project is scaffolded with.
+     */
+    staticPage?: {
+        assetHost: string | null;
+    };
 }
 /** The `bm:platform` value a page carries when it boots through the Bitmagic platform package. */
 export declare const BITMAGIC_PLATFORM_ID = "bitmagic";

package/dist/scaffold/project-files.js

@@ -2,6 +2,7 @@ import { FAVICON_LINK_ID } from '@bitmagic/asset-core/favicon';
 import { describeArtStyle } from '@bitmagic/asset-core/art-style';
 import { tsconfigPaths, importMapEntries, viteAliasEntries } from './aliases.js';
 import { hasEngineCapability } from './engine-capabilities.js';
+import { BITMAGIC_STATIC_PLATFORM_ID } from './github-pages.js';
 import { currentPortLane } from '../port-lane.js';
 import { AGENTS_MD_REFERENCE_SECTION, GAME_DESIGN_REFERENCE_HINT, GENERATE_SKILL_REFERENCE_SECTION, PLANNING_SKILL_REFERENCE_STEP1, PLANNING_SKILL_REFERENCE_STEP4, } from './reference-guidance.js';
 import { ALWAYS_AGENTS, PRIMARY_SKILLS_DIR, joinWithAnd, skillDirsFor, } from './agent-targets.js';
@@ -273,14 +274,20 @@ export function renderIndexHtml(options) {
     const imports = { ...CDN_IMPORTS, ...aliasImports };
     // Derived from the same alias model as the import map above, not a hardcoded literal, so the
     // two cannot drift: the entry point is an alias's import-map target plus its filename.
-    const engineEntryPoint = platformEntry
-        ? `${aliasImports['bitmagic/']}boot.js`
-        : `${aliasImports['engine/']}GameTemplate.js`;
+    const staticPage = options.staticPage;
+    const engineEntryPoint = staticPage !== undefined
+        ? `${aliasImports['bitmagic/']}boot-static.js`
+        : platformEntry
+            ? `${aliasImports['bitmagic/']}boot.js`
+            : `${aliasImports['engine/']}GameTemplate.js`;
     // Only on a page that registers the platform: the engine logs an error when a page declares a
     // platform that never registered, so an older engine's page must not carry it.
-    const platformMeta = platformEntry
-        ? `\n    <meta name="bm:platform" content="${BITMAGIC_PLATFORM_ID}">`
-        : '';
+    const platformMeta = staticPage !== undefined
+        ? `\n    <meta name="bm:platform" content="${BITMAGIC_STATIC_PLATFORM_ID}">`
+            + (staticPage.assetHost === null ? '' : `\n    <meta name="bm:asset-host" content="${staticPage.assetHost}">`)
+        : platformEntry
+            ? `\n    <meta name="bm:platform" content="${BITMAGIC_PLATFORM_ID}">`
+            : '';
     // The #game-container div below is required, not decorative: GameTemplate.ts
     // does document.getElementById('game-container') as HTMLElement, and GameEngine.ts
     // appendChild()s into it. The "as HTMLElement" cast erases the null a missing div would