@bitmagic/cli 0.1.53-dev.5 → 0.1.53-dev.6

package/dist/editor/shell-page.js

@@ -51,6 +51,7 @@
 import { decodeForgeMapHeights, renderForgeMapRgba, } from '@bitmagic/world-forger/pipeline/forge-map-render.js';
 import { FORGE_MAP_PALETTE } from '@bitmagic/world-forger/pipeline/layout-map.js';
 import { ASSET_DETAIL_CSS, ASSET_DETAIL_HTML } from './asset-detail-panel.js';
+import { PUBLISH_PANEL_CSS, PUBLISH_PANEL_HTML } from './publish-panel.js';
 import { BOOT_LOADER_CSS, BOOT_LOADER_HTML } from './boot-loader.js';
 import { BITMAGIC_CONTROLS_CSS, BITMAGIC_FONT_LINK, BITMAGIC_TOKENS_CSS } from './design.js';
 /** How often the shell asks the engine whether anything changed. A `Set` read; effectively free. */
@@ -228,6 +229,7 @@ ${BITMAGIC_CONTROLS_CSS}
   #hq-note code { display: block; margin-top: 6px; color: var(--bm-aqua);
                   font-family: var(--bm-font-mono); word-break: break-all; }
 ${ASSET_DETAIL_CSS}
+${PUBLISH_PANEL_CSS}
 ${BOOT_LOADER_CSS}
 </style>
 </head>
@@ -244,7 +246,8 @@ ${BOOT_LOADER_CSS}
       <input id="auto-toggle" type="checkbox" checked> Auto-reload
     </label>
     <span id="status"><span id="dot"></span><span id="status-text">Loading…</span></span>
-    <button id="assets-toggle" class="bm-pill" type="button" title="Show the assets in this project and what is being made">Assets</button>
+    <button id="publish-toggle" class="bm-pill" type="button" title="Where this game is published" disabled>Published</button>
+<button id="assets-toggle" class="bm-pill" type="button" title="Show the assets in this project and what is being made">Assets</button>
     <button id="shot" class="bm-pill" type="button" title="Copy the current frame to the clipboard">Screenshot</button>
     <button id="reload" class="bm-pill" type="button">Reload</button>
   </div>
@@ -293,6 +296,7 @@ ${BOOT_LOADER_HTML}
       </div>
     </div>
   </div>
+${PUBLISH_PANEL_HTML}
 ${ASSET_DETAIL_HTML}
 <script>
 (function () {
@@ -311,6 +315,16 @@ ${ASSET_DETAIL_HTML}
   var dot = document.getElementById('dot');
   var statusText = document.getElementById('status-text');
   var banner = document.getElementById('banner');
+  var publishToggle = document.getElementById('publish-toggle');
+  var publishOverlay = document.getElementById('publish-overlay');
+  var publishUrl = document.getElementById('publish-url');
+  var publishVisibility = document.getElementById('publish-visibility');
+  var publishVersion = document.getElementById('publish-version');
+  var publishManage = document.getElementById('publish-manage');
+  var publishQr = document.getElementById('publish-qr');
+  var publishClose = document.getElementById('publish-close');
+  /** The last publish the poll saw, or null until this project has had one. */
+  var lastPublish = null;
   var terrainBanner = document.getElementById('terrain-banner');
   var buildBanner = document.getElementById('build-banner');
   var cliBanner = document.getElementById('cli-banner');
@@ -947,10 +961,17 @@ ${ASSET_DETAIL_HTML}
    * there is no replay. This poll is what closes that hole, and it costs one stat() per tick.
    */
   async function checkExternalEdits() {
-    if (!loaded || saving) return;
+    if (saving) return;
     try {
       var state = await (await fetch('/api/state')).json();
       showCliUpdate(state.cliUpdate);
+      showPublish(state.publish);
+      // Only the mtime comparison below needs the game to have booted — it is what establishes
+      // lastKnownMtime, and without it every tick would read as someone else's edit. The two
+      // surfaces above need nothing from the game, and a game that will not boot is exactly when
+      // a creator most wants the published link and the update banner: the last good build is
+      // still live at that URL, and this is where they can reach it.
+      if (!loaded) return;
       // Anything other than the mtime our own last write produced is someone else's edit — most
       // likely the creator's agent.
       if (state.worldMtimeMs && state.worldMtimeMs !== lastKnownMtime
@@ -978,6 +999,67 @@ ${ASSET_DETAIL_HTML}
     cliBanner.classList.add('show');
   }
 
+  /**
+   * Where this game is published, if it is.
+   *
+   * Driven by the poll for the same reason the banner above is: this page is rendered once when the
+   * server starts, and the publish it should show almost always happens later, in another terminal
+   * \u2014 often an agent's, which the creator never looks at. Polling means the pill lights up on
+   * its own within a tick of the publish finishing, with no reload.
+   *
+   * The record is only stored, never rendered here, so a session that never opens the dialog never
+   * asks the sidecar to encode a QR.
+   */
+  function showPublish(record) {
+    lastPublish = record || null;
+    publishToggle.disabled = !lastPublish;
+    publishToggle.title = lastPublish
+      ? 'Where this game is published'
+      : 'Publish the game to get a link and a QR code';
+    if (!lastPublish && publishOverlay.classList.contains('show')) closePublish();
+  }
+
+  function openPublish() {
+    if (!lastPublish) return;
+    publishUrl.textContent = lastPublish.url;
+    publishUrl.href = lastPublish.url;
+    publishVisibility.textContent = lastPublish.visibility;
+    // Public is the state a creator chose and can be pleased about; private is the honest
+    // reminder that nobody else can find it yet.
+    publishVisibility.className = lastPublish.visibility === 'public'
+      ? 'bm-badge bm-badge--success'
+      : 'bm-badge';
+    publishVersion.textContent = 'publish ' + lastPublish.publishVersion + describeAge(lastPublish.at);
+    publishManage.style.display = lastPublish.manageUrl ? '' : 'none';
+    if (lastPublish.manageUrl) publishManage.href = lastPublish.manageUrl;
+    // Cache-busted per open: a later publish keeps the same URL for an alias but not for a
+    // versioned one, and a browser holding the old code would send a phone to the previous build.
+    publishQr.src = '/api/publish/qr.png?v=' + encodeURIComponent(lastPublish.at);
+    publishOverlay.classList.add('show');
+    publishClose.focus();
+  }
+
+  function closePublish() {
+    publishOverlay.classList.remove('show');
+    // Drop the image so a session that publishes repeatedly does not keep every code it drew.
+    publishQr.removeAttribute('src');
+    publishToggle.focus();
+  }
+
+  /** ', 4 minutes ago' and so on. Empty when the stamp is unreadable rather than a wrong claim. */
+  function describeAge(at) {
+    var then = Date.parse(at);
+    if (!then) return '';
+    var seconds = Math.max(0, Math.round((Date.now() - then) / 1000));
+    if (seconds < 90) return ', just now';
+    var minutes = Math.round(seconds / 60);
+    if (minutes < 60) return ', ' + minutes + ' minutes ago';
+    var hours = Math.round(minutes / 60);
+    if (hours < 24) return hours === 1 ? ', an hour ago' : ', ' + hours + ' hours ago';
+    var days = Math.round(hours / 24);
+    return days === 1 ? ', yesterday' : ', ' + days + ' days ago';
+  }
+
   /**
    * Something changed on disk. Reload, or explain why we did not.
    *
@@ -1939,6 +2021,12 @@ ${ASSET_DETAIL_HTML}
     if (autoReload) banner.classList.remove('show');
   });
 
+  publishToggle.addEventListener('click', openPublish);
+  publishClose.addEventListener('click', closePublish);
+  // Click the backdrop to dismiss, like every other dialog on this page.
+  publishOverlay.addEventListener('click', function (event) {
+    if (event.target === publishOverlay) closePublish();
+  });
   assetsToggle.addEventListener('click', function () { setAssetsOpen(!assetsOpen); });
 
   autoReload = readPref(AUTO_KEY, '1') !== '0';

package/dist/editor/shell-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell-page.js","sourceRoot":"","sources":["../../src/editor/shell-page.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqnD3B,CAAC;AACF,CAAC"}
+{"version":3,"file":"shell-page.js","sourceRoot":"","sources":["../../src/editor/shell-page.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAysD3B,CAAC;AACF,CAAC"}

package/dist/publish/record.d.ts

@@ -0,0 +1,22 @@
+export declare function publishRecordPath(root: string): string;
+export interface PublishRecord {
+    /** The public URL of the game, exactly as api-server issued it. */
+    url: string;
+    visibility: string;
+    publishVersion: number;
+    gameId: string;
+    /** ISO 8601, so a reader can say how long ago without a second field. */
+    at: string;
+    /** The My games page. Absent against an older api-server that does not send one. */
+    manageUrl?: string;
+    /** The name this publish shipped under, when the publish knew it. */
+    name?: string;
+}
+export declare function writePublishRecord(root: string, record: PublishRecord): void;
+/**
+ * The last publish, or null when there has not been one this reader can trust.
+ *
+ * Every field is checked rather than assumed: this file survives across CLI versions, and a reader
+ * that trusted a half-written or older-shaped record would put a broken link in front of a creator.
+ */
+export declare function readPublishRecord(root: string): PublishRecord | null;

package/dist/publish/record.js

@@ -0,0 +1,62 @@
+/**
+ * The on-disk record of the last successful `bitmagic publish`.
+ *
+ * Publishing used to print the game's URL and forget it. That was fine while the terminal was the
+ * only place the URL was ever wanted, and stopped being fine as soon as anything else needed to
+ * answer "where is this game?" — the `bitmagic dev` view being the first, since it is the window
+ * the creator already has open while they work.
+ *
+ * Lives at `.bitmagic/publish/last.json`, beside `source.zip`, which is where the rest of a
+ * publish's local artifacts already are. Inside `.bitmagic` means gitignored and excluded from the
+ * publish fingerprint (`EXCLUDED_DIRS` in `@bitmagic/asset-core/publish-source`), so recording a
+ * publish cannot invalidate the verify that gated it — the same reason the QR image lives there.
+ *
+ * Written only after `complete`, so its presence means the game really is live at that URL. It is
+ * NOT a cache and nothing gates on it: a missing or unreadable record costs a link in a panel, and
+ * every reader here treats that as normal rather than as an error.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const PUBLISH_RECORD_FILE = path.join('.bitmagic', 'publish', 'last.json');
+export function publishRecordPath(root) {
+    return path.join(root, PUBLISH_RECORD_FILE);
+}
+export function writePublishRecord(root, record) {
+    fs.mkdirSync(path.dirname(publishRecordPath(root)), { recursive: true });
+    fs.writeFileSync(publishRecordPath(root), `${JSON.stringify(record, null, 2)}\n`);
+}
+/**
+ * The last publish, or null when there has not been one this reader can trust.
+ *
+ * Every field is checked rather than assumed: this file survives across CLI versions, and a reader
+ * that trusted a half-written or older-shaped record would put a broken link in front of a creator.
+ */
+export function readPublishRecord(root) {
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(publishRecordPath(root), 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const record = parsed;
+    if (typeof record.url !== 'string'
+        || typeof record.visibility !== 'string'
+        || typeof record.publishVersion !== 'number'
+        || typeof record.gameId !== 'string'
+        || typeof record.at !== 'string') {
+        return null;
+    }
+    return {
+        url: record.url,
+        visibility: record.visibility,
+        publishVersion: record.publishVersion,
+        gameId: record.gameId,
+        at: record.at,
+        ...(typeof record.manageUrl === 'string' ? { manageUrl: record.manageUrl } : {}),
+        ...(typeof record.name === 'string' ? { name: record.name } : {}),
+    };
+}
+//# sourceMappingURL=record.js.map

package/dist/publish/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/publish/record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAE3E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AAC9C,CAAC;AAgBD,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,MAAqB;IACpE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,EAAE,CAAC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,IACE,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;WAC3B,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;WACrC,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;WACzC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;WACjC,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,EAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,GAAG,CAAC,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/dist/render/qr-output.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Where a publish's QR code goes: the terminal when someone is looking at it, a file when nobody
+ * is.
+ *
+ * This module exists because the two are one decision, not two. `qr-terminal.ts` refuses a
+ * non-TTY for a good reason — escape sequences in a captured stream are noise — but refusing to
+ * DRAW is not the same as having nothing to offer, and for this CLI the captured stream is the
+ * common case. The pro lane is driven by an agent, so stdout is a pipe on almost every real
+ * publish, and the creator who would scan the code never sees the terminal at all. Gating the
+ * feature on `isTTY` alone turned it off exactly where the URL is most worth handing over.
+ *
+ * So: draw it if it can be drawn, and write `.bitmagic/publish-qr.png` whenever it cannot. That
+ * covers the pipe, and also the two smaller cases with the same shape — `TERM=dumb`, and a
+ * terminal too narrow to hold the code unwrapped — where a person is present but still has nothing
+ * to scan. A terminal that draws successfully writes no file: it already did the job.
+ *
+ * `.bitmagic/` is excluded from the publish fingerprint (`EXCLUDED_DIRS` in
+ * `@bitmagic/asset-core/publish-source`), so writing here cannot invalidate the verify the gate
+ * just checked.
+ */
+import { type TerminalQrEnv } from './qr-terminal.js';
+/** Where a publish leaves its QR image. One per project, overwritten each publish. */
+export declare function publishQrPath(root: string): string;
+export interface EmitQrOptions {
+    /** The project root. The image lands in its `.bitmagic/`. */
+    root: string;
+    /** `--json`: stdout carries exactly one document, so nothing is ever drawn. */
+    json: boolean;
+    /** `--no-qr`. Suppresses the drawing AND the file — it means "not this time", not "not here". */
+    disabled: boolean;
+    env?: TerminalQrEnv;
+    isTTY?: boolean;
+    columns?: number | undefined;
+    write?: (chunk: string) => void;
+    /** Seam for the test; production writes to disk. */
+    writeFile?: (file: string, bytes: Buffer) => void;
+}
+/**
+ * Show `url` as a QR code however this run can, and return the image path when one was written.
+ *
+ * Never throws and never reports failure as an error: the caller has already printed the URL, and
+ * a code that could not be produced costs the creator a retype, not a publish.
+ */
+export declare function emitQr(url: string, options: EmitQrOptions): string | null;

package/dist/render/qr-output.js

@@ -0,0 +1,71 @@
+/**
+ * Where a publish's QR code goes: the terminal when someone is looking at it, a file when nobody
+ * is.
+ *
+ * This module exists because the two are one decision, not two. `qr-terminal.ts` refuses a
+ * non-TTY for a good reason — escape sequences in a captured stream are noise — but refusing to
+ * DRAW is not the same as having nothing to offer, and for this CLI the captured stream is the
+ * common case. The pro lane is driven by an agent, so stdout is a pipe on almost every real
+ * publish, and the creator who would scan the code never sees the terminal at all. Gating the
+ * feature on `isTTY` alone turned it off exactly where the URL is most worth handing over.
+ *
+ * So: draw it if it can be drawn, and write `.bitmagic/publish-qr.png` whenever it cannot. That
+ * covers the pipe, and also the two smaller cases with the same shape — `TERM=dumb`, and a
+ * terminal too narrow to hold the code unwrapped — where a person is present but still has nothing
+ * to scan. A terminal that draws successfully writes no file: it already did the job.
+ *
+ * `.bitmagic/` is excluded from the publish fingerprint (`EXCLUDED_DIRS` in
+ * `@bitmagic/asset-core/publish-source`), so writing here cannot invalidate the verify the gate
+ * just checked.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { encodeQr } from './qr.js';
+import { encodeQrPng } from './qr-png.js';
+import { renderTerminalQr } from './qr-terminal.js';
+/** Where a publish leaves its QR image. One per project, overwritten each publish. */
+export function publishQrPath(root) {
+    return path.join(root, '.bitmagic', 'publish-qr.png');
+}
+/**
+ * Show `url` as a QR code however this run can, and return the image path when one was written.
+ *
+ * Never throws and never reports failure as an error: the caller has already printed the URL, and
+ * a code that could not be produced costs the creator a retype, not a publish.
+ */
+export function emitQr(url, options) {
+    const env = options.env ?? process.env;
+    if (options.disabled || env.BITMAGIC_NO_QR)
+        return null;
+    // Drawing is tried first and, when it works, is the whole answer — a file nobody opens is
+    // clutter in a directory the creator does read.
+    if (!options.json) {
+        const drawn = renderTerminalQr(url, {
+            env,
+            ...(options.isTTY === undefined ? {} : { isTTY: options.isTTY }),
+            columns: options.columns,
+            ...(options.write === undefined ? {} : { write: options.write }),
+        });
+        if (drawn)
+            return null;
+    }
+    const matrix = encodeQr(url);
+    if (matrix === null)
+        return null;
+    const file = publishQrPath(options.root);
+    try {
+        if (options.writeFile) {
+            options.writeFile(file, encodeQrPng(matrix));
+        }
+        else {
+            fs.mkdirSync(path.dirname(file), { recursive: true });
+            fs.writeFileSync(file, encodeQrPng(matrix));
+        }
+        return file;
+    }
+    catch {
+        // A read-only or full disk is not worth failing a successful publish over.
+        return null;
+    }
+}
+//# sourceMappingURL=qr-output.js.map

package/dist/render/qr-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-output.js","sourceRoot":"","sources":["../../src/render/qr-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAExE,sFAAsF;AACtF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;AACxD,CAAC;AAiBD;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,OAAsB;IACxD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,IAAI,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAExD,0FAA0F;IAC1F,gDAAgD;IAChD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,EAAE;YAClC,GAAG;YACH,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAChE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;SACjE,CAAC,CAAC;QACH,IAAI,KAAK;YAAE,OAAO,IAAI,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,2EAA2E;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/render/qr-png.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A QR code as PNG bytes, for the creator who cannot scan the terminal.
+ *
+ * `qr-terminal.ts` covers the case where a person is looking at the output. That is not the common
+ * case for this CLI: the pro lane is driven by an agent, so stdout is a pipe, and the human who
+ * would do the scanning is on the far side of it. A file crosses that boundary where escape
+ * sequences cannot — an agent can hand an image to its creator, and cannot hand them a repainted
+ * terminal.
+ *
+ * Greyscale, one byte per pixel. A QR carries one bit per module, so colour would be three bytes of
+ * nothing; and at this size the whole image deflates to a few hundred bytes either way. The
+ * encoder is hand-rolled for the same reason `qr.ts` is — `@bitmagic/cli` ships four runtime
+ * dependencies on purpose, and node's own `zlib` (already used in `publish/` and `assets/`) does
+ * the only part that is genuinely hard.
+ *
+ * Two other hand-rolled PNG encoders exist in this repo — `world-forger-internal`'s vehicle atlas
+ * and `game-play-agent`'s solid-colour tile — and neither is reachable from here: the first is in a
+ * `private: true` package the CLI does not depend on, the second is server code. A shared home
+ * would have to be `@bitmagic/asset-core`; that is worth doing when something needs the third copy,
+ * not for the second.
+ */
+import { Buffer } from 'buffer';
+export interface QrPngOptions {
+    /** Pixels per module. Defaults to `MODULE_PIXELS`. */
+    scale?: number;
+    /** Quiet zone in modules. Defaults to `QUIET_MODULES`. */
+    quietZone?: number;
+}
+/** The pixel width (and height) `encodeQrPng` produces for a matrix of this size. */
+export declare function qrPngDimension(matrix: boolean[][], options?: QrPngOptions): number;
+/**
+ * Encode a module matrix as a greyscale PNG: dark modules black, everything else white.
+ *
+ * White is 0xff and dark is 0x00, never inverted — a scanner wants dark on light, and unlike the
+ * terminal there is no theme here to fight about it.
+ */
+export declare function encodeQrPng(matrix: boolean[][], options?: QrPngOptions): Buffer;

package/dist/render/qr-png.js

@@ -0,0 +1,111 @@
+/**
+ * A QR code as PNG bytes, for the creator who cannot scan the terminal.
+ *
+ * `qr-terminal.ts` covers the case where a person is looking at the output. That is not the common
+ * case for this CLI: the pro lane is driven by an agent, so stdout is a pipe, and the human who
+ * would do the scanning is on the far side of it. A file crosses that boundary where escape
+ * sequences cannot — an agent can hand an image to its creator, and cannot hand them a repainted
+ * terminal.
+ *
+ * Greyscale, one byte per pixel. A QR carries one bit per module, so colour would be three bytes of
+ * nothing; and at this size the whole image deflates to a few hundred bytes either way. The
+ * encoder is hand-rolled for the same reason `qr.ts` is — `@bitmagic/cli` ships four runtime
+ * dependencies on purpose, and node's own `zlib` (already used in `publish/` and `assets/`) does
+ * the only part that is genuinely hard.
+ *
+ * Two other hand-rolled PNG encoders exist in this repo — `world-forger-internal`'s vehicle atlas
+ * and `game-play-agent`'s solid-colour tile — and neither is reachable from here: the first is in a
+ * `private: true` package the CLI does not depend on, the second is server code. A shared home
+ * would have to be `@bitmagic/asset-core`; that is worth doing when something needs the third copy,
+ * not for the second.
+ */
+import { Buffer } from 'buffer';
+import * as zlib from 'zlib';
+/** Pixels per QR module. Large enough that a phone camera reads it off a normal screen. */
+const MODULE_PIXELS = 8;
+/**
+ * Quiet zone in modules. Four, the value the spec asks for, rather than the two `qr-terminal.ts`
+ * uses — that one is trading margin for terminal columns, and a file has no such constraint.
+ */
+const QUIET_MODULES = 4;
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+/** The standard CRC-32 table (PNG spec annex D), built once. */
+function buildCrcTable() {
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n += 1) {
+        let c = n;
+        for (let k = 0; k < 8; k += 1) {
+            c = (c & 1) !== 0 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        }
+        table[n] = c >>> 0;
+    }
+    return table;
+}
+const CRC_TABLE = buildCrcTable();
+function crc32(bytes) {
+    let crc = 0xffffffff;
+    for (const byte of bytes) {
+        crc = CRC_TABLE[(crc ^ byte) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** One PNG chunk: length, type, data, and the CRC over type+data (never over the length). */
+function chunk(type, data) {
+    const length = Buffer.alloc(4);
+    length.writeUInt32BE(data.length, 0);
+    const typeAndData = Buffer.concat([Buffer.from(type, 'ascii'), data]);
+    const crc = Buffer.alloc(4);
+    crc.writeUInt32BE(crc32(typeAndData), 0);
+    return Buffer.concat([length, typeAndData, crc]);
+}
+/** The pixel width (and height) `encodeQrPng` produces for a matrix of this size. */
+export function qrPngDimension(matrix, options = {}) {
+    const scale = options.scale ?? MODULE_PIXELS;
+    const quiet = options.quietZone ?? QUIET_MODULES;
+    return (matrix.length + quiet * 2) * scale;
+}
+/**
+ * Encode a module matrix as a greyscale PNG: dark modules black, everything else white.
+ *
+ * White is 0xff and dark is 0x00, never inverted — a scanner wants dark on light, and unlike the
+ * terminal there is no theme here to fight about it.
+ */
+export function encodeQrPng(matrix, options = {}) {
+    const scale = options.scale ?? MODULE_PIXELS;
+    const quiet = options.quietZone ?? QUIET_MODULES;
+    const dimension = qrPngDimension(matrix, options);
+    // One filter byte per scanline (0 = None: a QR is flat colour, so the other filters buy nothing
+    // that deflate does not already get from the runs), then one byte per pixel.
+    const raw = Buffer.alloc(dimension * (dimension + 1), 0xff);
+    for (let y = 0; y < dimension; y += 1) {
+        const rowStart = y * (dimension + 1);
+        raw[rowStart] = 0;
+        const moduleRow = Math.floor(y / scale) - quiet;
+        if (moduleRow < 0 || moduleRow >= matrix.length)
+            continue;
+        for (let x = 0; x < dimension; x += 1) {
+            const moduleCol = Math.floor(x / scale) - quiet;
+            if (moduleCol < 0 || moduleCol >= matrix.length)
+                continue;
+            if (matrix[moduleRow][moduleCol])
+                raw[rowStart + 1 + x] = 0x00;
+        }
+    }
+    const ihdr = Buffer.alloc(13);
+    ihdr.writeUInt32BE(dimension, 0);
+    ihdr.writeUInt32BE(dimension, 4);
+    ihdr[8] = 8; // bit depth
+    ihdr[9] = 0; // colour type 0 — greyscale
+    ihdr[10] = 0; // compression: deflate, the only value PNG defines
+    ihdr[11] = 0; // filter method: adaptive, the only value PNG defines
+    ihdr[12] = 0; // interlace: none
+    return Buffer.concat([
+        PNG_SIGNATURE,
+        chunk('IHDR', ihdr),
+        // deflateSync, not fflate's — fflate's `deflateSync` emits RAW deflate with no zlib header,
+        // and an IDAT must carry the zlib wrapper. (fflate's `zlibSync` would also do.)
+        chunk('IDAT', zlib.deflateSync(raw)),
+        chunk('IEND', Buffer.alloc(0)),
+    ]);
+}
+//# sourceMappingURL=qr-png.js.map

package/dist/render/qr-png.js.map

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

package/dist/render/qr-terminal.d.ts

@@ -10,6 +10,11 @@
  * never replaces a line and it never reports failure as an error, because an agent tool is usually
  * what reads this output.
  *
+ * That last clause is also why nothing should call this module directly. Refusing to DRAW into a
+ * pipe is right; having nothing to offer when there is one is not, and since an agent drives most
+ * publishes, the pipe is the common case rather than the edge. `qr-output.ts` owns that decision —
+ * it asks this module first and falls back to a PNG file — and `bitmagic publish` goes through it.
+ *
  * Where it DIVERGES from that file is the gate. `supportsInlineImage` is an allowlist of terminals
  * known to implement the iTerm2 protocol, because the ones that do not print a screenful of raw
  * base64. Nothing here is exotic: half-block characters and SGR colour are universal, and tmux
@@ -24,7 +29,9 @@ export interface TerminalQrEnv {
  * Whether this terminal can show a scannable code at all.
  *
  * Not an allowlist — see the file header. `TERM=dumb` is the one terminal that answers no on its
- * own behalf, and a non-TTY means something is reading this rather than looking at it.
+ * own behalf, and a non-TTY means something is reading this rather than looking at it — which is a
+ * reason not to paint escape sequences, NOT a reason to withhold the code. `qr-output.ts` writes an
+ * image for every case this function turns down.
  */
 export declare function supportsTerminalQr(env: TerminalQrEnv, isTTY: boolean): boolean;
 /** How many columns the drawn code occupies, quiet zone included. */

package/dist/render/qr-terminal.js

@@ -10,6 +10,11 @@
  * never replaces a line and it never reports failure as an error, because an agent tool is usually
  * what reads this output.
  *
+ * That last clause is also why nothing should call this module directly. Refusing to DRAW into a
+ * pipe is right; having nothing to offer when there is one is not, and since an agent drives most
+ * publishes, the pipe is the common case rather than the edge. `qr-output.ts` owns that decision —
+ * it asks this module first and falls back to a PNG file — and `bitmagic publish` goes through it.
+ *
  * Where it DIVERGES from that file is the gate. `supportsInlineImage` is an allowlist of terminals
  * known to implement the iTerm2 protocol, because the ones that do not print a screenful of raw
  * base64. Nothing here is exotic: half-block characters and SGR colour are universal, and tmux
@@ -51,7 +56,9 @@ const BOTH_LIGHT = ' ';
  * Whether this terminal can show a scannable code at all.
  *
  * Not an allowlist — see the file header. `TERM=dumb` is the one terminal that answers no on its
- * own behalf, and a non-TTY means something is reading this rather than looking at it.
+ * own behalf, and a non-TTY means something is reading this rather than looking at it — which is a
+ * reason not to paint escape sequences, NOT a reason to withhold the code. `qr-output.ts` writes an
+ * image for every case this function turns down.
  */
 export function supportsTerminalQr(env, isTTY) {
     if (!isTTY)

package/dist/render/qr-terminal.js.map

@@ -1 +1 @@
-{"version":3,"file":"qr-terminal.js","sourceRoot":"","sources":["../../src/render/qr-terminal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"qr-terminal.js","sourceRoot":"","sources":["../../src/render/qr-terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,8FAA8F;AAC9F,MAAM,GAAG,GAAG,QAAQ,CAAC;AAErB;;;;;;;;GAQG;AACH,MAAM,KAAK,GAAG,GAAG,GAAG,UAAU,CAAC;AAC/B,MAAM,KAAK,GAAG,GAAG,GAAG,KAAK,CAAC;AAE1B;;;;GAIG;AACH,MAAM,UAAU,GAAG,CAAC,CAAC;AAErB;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,aAAa;AACpC,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,mBAAmB;AACzC,MAAM,WAAW,GAAG,GAAG,CAAC,CAAC,mBAAmB;AAC5C,MAAM,UAAU,GAAG,GAAG,CAAC;AAOvB;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAkB,EAAE,KAAc;IACnE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,GAAG,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC;AAC7B,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,OAAO,MAAM,CAAC,MAAM,GAAG,UAAU,GAAG,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IACjD,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC;IACrB,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,GAAW,EAAW,EAAE;QACjD,MAAM,CAAC,GAAG,GAAG,GAAG,UAAU,CAAC;QAC3B,MAAM,CAAC,GAAG,GAAG,GAAG,UAAU,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC7E,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3B,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YACtD,IAAI,GAAG,IAAI,MAAM;gBAAE,IAAI,IAAI,SAAS,CAAC;iBAChC,IAAI,GAAG;gBAAE,IAAI,IAAI,QAAQ,CAAC;iBAC1B,IAAI,MAAM;gBAAE,IAAI,IAAI,WAAW,CAAC;;gBAChC,IAAI,IAAI,UAAU,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAWD;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,UAAmC,EAAE;IAClF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;IAC7D,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAElD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAElC,4FAA4F;IAC5F,wEAAwE;IACxE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAC1D,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAEnF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,6BAA6B,CAAC;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAChF,IAAI,CAAC;QACH,KAAK,CAAC,KAAK,OAAO,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,kFAAkF;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/scaffold/project-files.js

@@ -778,6 +778,11 @@ Follow this order; \`publish\` enforces it and refuses otherwise:
 3. Run \`bitmagic publish\`. It rebuilds automatically if the project changed since the last
    build, so a manual \`bitmagic build\` first is optional.
 
+**Show your creator the QR code.** Publish turns the game's URL into a scannable image. Your
+output is a pipe, so it cannot be drawn in the terminal: publish writes \`.bitmagic/publish-qr.png\`
+and names it (\`qrPath\` under \`--json\`). Surface that image like any artifact you made — scanning
+it opens the game on a phone, and a bare URL leaves your creator retyping a game id into a browser.
+
 **A bare \`bitmagic publish\` does not make the game public.** Every publish uploads and
 registers the game, but \`visibility\` defaults to \`private\` — reachable by URL, not listed on
 bitmagic.ai. Pass \`--visibility public\` explicitly, on that call, to list it; omit it on a later