@bitmagic/cli 0.1.64-dev.9 → 0.1.64

package/dist/editor/game-info-panel.js

@@ -0,0 +1,179 @@
+/**
+ * The Game-info dialog's CSS and markup, composed into `shell-page.ts`.
+ *
+ * Split out for the reason `publish-panel.ts` and `asset-detail-panel.ts` were: the shell page is
+ * the busiest file in the package. Style and markup carry no closure state, so they can leave
+ * without threading anything across a boundary; the behaviour stays inline there, because it
+ * needs the enclosing IIFE's element lookups and its `closeMore` / Escape chain.
+ *
+ * What this surface is for: the bar spelled out the game's name, id and environment side by side
+ * and had no room left, while the two things that decide how the whole project LOOKS — the
+ * accepted reference image and the cover art — were visible only in a terminal. One click on the
+ * name now answers both: what this game is, and what it is supposed to look like.
+ *
+ * Same template-literal rules as its host: **no backticks**, and a backslash in a regex has to be
+ * doubled to survive the literal. Every colour is a `--bm-*` token; `shell-page.test.ts` fails the
+ * build on a hex that is not black or white.
+ */
+/**
+ * Styles for `#info-overlay` and for the bar control that opens it.
+ *
+ * The trigger is not a pill: a pill is a control, and this is the page's identity — the game's
+ * name, in the weight the bar already gave it, that happens to be clickable. Only the hover and
+ * focus treatments are added, so it reads as a control the moment a pointer is near it.
+ */
+export const GAME_INFO_PANEL_CSS = `
+  /* The name IS the button. Bold and white like the label it replaces, with the id and env it
+     absorbed now one click away rather than two more slots in the bar. */
+  #game-info-toggle {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    max-width: 26vw;
+    padding: 4px 8px;
+    background: transparent;
+    border: 1px solid transparent;
+    border-radius: 6px;
+    color: var(--bm-text);
+    font-family: var(--bm-font);
+    font-size: 14px;
+    font-weight: 700;
+    line-height: 1.2;
+    cursor: pointer;
+    transition: background .15s ease, border-color .15s ease;
+  }
+  #game-info-toggle:hover { background: var(--bm-surface-alt); border-color: var(--bm-border-muted); }
+  #game-info-toggle:focus-visible { outline: none; box-shadow: var(--bm-focus-ring); }
+  #game-info-toggle .name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  /* The affordance. Dim, so the name still reads as the name rather than as a menu. */
+  #game-info-toggle .chevron { flex: none; color: var(--bm-text-dim); font-size: 10px; }
+
+  /* Level with the other two dialogs: all three are opened from different controls and never
+     stack. */
+  #info-overlay { z-index: 10; }
+  #info-dialog { width: min(560px, 92vw); max-height: 86vh; overflow-y: auto; padding: 20px; }
+  #info-dialog h2 { margin-bottom: 16px; }
+  /* A definition list, because that is what this is: a fixed set of fields with one value each.
+     Two columns so the values line up and the whole block is scannable without reading it. */
+  #info-facts { display: grid; grid-template-columns: auto 1fr; gap: 8px 16px; margin: 0 0 20px; }
+  #info-facts dt { font-size: 12px; font-weight: 700; text-transform: uppercase;
+                   letter-spacing: 1.4px; color: var(--bm-text-muted); }
+  #info-facts dd { margin: 0; min-width: 0; color: var(--bm-text); overflow-wrap: anywhere; }
+  /* Ids, versions and modes are read character by character; names and genres are read as words. */
+  #info-facts dd.mono { font-family: var(--bm-font-mono); font-size: 12px; }
+  #info-facts dd .note { color: var(--bm-text-dim); }
+  /* The two pictures, side by side: they are the same kind of thing and are compared, not read
+     in order. They wrap to one column when the dialog is at its narrowest. */
+  #info-art { display: flex; flex-wrap: wrap; gap: 16px; }
+  .info-art-card { flex: 1 1 200px; min-width: 0; }
+  .info-art-card .bm-label { display: block; margin-bottom: 8px; }
+  /* A square frame either way, so a present picture and a missing one leave the dialog the same
+     height and the two cards stay level.
+
+     A button rather than a div, because with a picture in it that is what it is: the thumbnail is
+     a couple of hundred pixels of an image generated at 1024, which is not enough to judge the
+     look it is supposed to fix — clicking it opens the full size. Disabled while the card is
+     empty, so the control is dead exactly when there is nothing to open, and reachable by keyboard
+     for free either way. */
+  .info-art-frame {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 100%;
+    aspect-ratio: 1 / 1;
+    padding: 12px;
+    background: var(--bm-surface-alt);
+    border: 1px solid var(--bm-border-muted);
+    border-radius: 6px;
+    color: inherit;
+    font: inherit;
+    text-align: center;
+    cursor: zoom-in;
+    transition: border-color .15s ease;
+  }
+  .info-art-frame:hover:not(:disabled) { border-color: var(--bm-text-dim); }
+  .info-art-frame:focus-visible { outline: none; box-shadow: var(--bm-focus-ring); }
+  /* Not dimmed like an ordinary disabled control: there is nothing to enable here, and greying the
+     "not yet" copy would hide the command that fixes it. */
+  .info-art-frame:disabled { cursor: default; }
+  /* The frame holds the picture AND the "not yet" copy, and shows exactly one of them: the class
+     is applied by openInfo(), because a page assembled as a string has no inline styles to toggle
+     (DESIGN.md, and the same rule the Creator follows). */
+  .info-art-frame img { display: none; max-width: 100%; max-height: 100%; border-radius: 4px; }
+  .info-art-frame.has-image img { display: block; }
+  .info-art-frame.has-image .empty { display: none; }
+  /* What to run to make the missing one, rather than the bare fact that it is missing. */
+  .info-art-frame .empty { font-size: 12px; color: var(--bm-text-dim); }
+  .info-art-frame .empty code { display: block; margin-top: 6px; color: var(--bm-aqua);
+                                font-family: var(--bm-font-mono); }
+  .info-art-card .caption { margin-top: 8px; font-size: 12px; color: var(--bm-text-dim);
+                            overflow-wrap: anywhere; }
+  .info-art-card .caption a { color: var(--bm-aqua); text-decoration: none; }
+  .info-art-card .caption a:hover { text-decoration: underline; }
+  /* An expiring reference URL is the one thing on this card worth interrupting for. */
+  .info-art-card .caption .stale { color: var(--bm-pumpkin); }
+  /* === The full-size view ===================================================================
+     A layer of its own above the dialog rather than a new browser tab: the dev view is the window
+     the creator is already in, and a tab showing a bare image on a loopback port is a place they
+     then have to come back from. Click anywhere, or Escape, and the dialog is still underneath
+     exactly as it was. */
+  #info-zoom { z-index: 11; flex-direction: column; gap: 12px; cursor: zoom-out; }
+  #info-zoom img { max-width: 92vw; max-height: 84vh; border-radius: 6px;
+                   box-shadow: var(--bm-shadow-dialog); }
+  #info-zoom .hint { font-size: 12px; color: var(--bm-text-muted); }
+
+  /* The sidecar could not answer. Said in the dialog rather than in the bar's status line, which
+     belongs to the save state and would be overwritten by the next poll. */
+  #info-error { display: none; margin: 0 0 16px; font-size: 12px; color: var(--bm-pumpkin); }
+  #info-error.show { display: block; }
+  #info-actions { display: flex; justify-content: flex-end; margin-top: 20px; }
+`;
+/**
+ * Markup for the Game-info dialog.
+ *
+ * Every value is empty until `openInfo()` fills it from `/api/game-info`. Nothing may be
+ * interpolated at render time: this page is built once when the server starts, and `bitmagic
+ * cover` or `bitmagic reference accept` usually runs hours later in another terminal.
+ */
+export const GAME_INFO_PANEL_HTML = `  <div id="info-overlay" class="bm-overlay">
+    <div id="info-dialog" class="bm-dialog">
+      <h2 id="info-title"></h2>
+      <p id="info-error"></p>
+      <dl id="info-facts">
+        <dt>Game id</dt><dd id="info-game-id" class="mono"></dd>
+        <dt>Environment</dt><dd id="info-environment" class="mono"></dd>
+        <dt>Genre</dt><dd id="info-genre"></dd>
+        <dt>Physics</dt><dd id="info-physics" class="mono"></dd>
+        <dt>Art style</dt><dd id="info-art-style"></dd>
+        <dt>Platform</dt><dd id="info-platform"></dd>
+        <dt>Engine</dt><dd id="info-engine" class="mono"></dd>
+      </dl>
+      <div id="info-art">
+        <div class="info-art-card">
+          <span class="bm-label">Reference image</span>
+          <button id="info-reference-frame" class="info-art-frame" type="button" disabled title="See it full size">
+            <img id="info-reference-img" alt="This game's accepted reference image">
+            <span id="info-reference-empty" class="empty">No reference image yet.<code>bitmagic reference make</code></span>
+          </button>
+          <p id="info-reference-caption" class="caption"></p>
+        </div>
+        <div class="info-art-card">
+          <span class="bm-label">Cover art</span>
+          <button id="info-cover-frame" class="info-art-frame" type="button" disabled title="See it full size">
+            <img id="info-cover-img" alt="This game's cover art">
+            <span id="info-cover-empty" class="empty">No cover art yet.<code>bitmagic cover</code></span>
+          </button>
+          <p id="info-cover-caption" class="caption"></p>
+        </div>
+      </div>
+      <div id="info-actions">
+        <button id="info-close" class="bm-pill bm-pill--primary" type="button">Close</button>
+      </div>
+    </div>
+  </div>
+  <div id="info-zoom" class="bm-overlay">
+    <img id="info-zoom-img" alt="">
+    <span class="hint">Click anywhere to go back.</span>
+  </div>
+`;
+//# sourceMappingURL=game-info-panel.js.map

package/dist/editor/game-info-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-info-panel.js","sourceRoot":"","sources":["../../src/editor/game-info-panel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyGlC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCnC,CAAC"}

package/dist/editor/game-info.d.ts

@@ -0,0 +1,55 @@
+import type { ProjectMetadata } from '../project/context.js';
+/** The two pictures a project carries. Both are local files under `.bitmagic/`, both re-hostable. */
+export type GameInfoImageKind = 'reference' | 'cover';
+export interface GameInfoImage {
+    /** The public URL the record names — where this picture lives for everyone but this machine. */
+    url: string;
+    /** Whether the sidecar can serve local bytes. False means the dialog falls back to `url`. */
+    local: boolean;
+    /** When it was accepted (reference) or generated (cover), ISO. */
+    at: string;
+    /** Reference only: false when re-hosting failed, so `url` is the source and will expire. */
+    hosted?: boolean;
+    /** Reference only, and only when a generated candidate rather than a bare URL was accepted. */
+    candidateId?: string;
+}
+export interface GameInfo {
+    gameName: string;
+    gameId: string;
+    environment: string;
+    engineVersion: string;
+    template: string;
+    /** `gameGenre` from the work copy, falling back to what `bitmagic.json` recorded at scaffold. */
+    genre: string;
+    /** `physicsMode` from the work copy. Null on the genres that declare none. */
+    physicsMode: string | null;
+    /** What every generation in this project inherits — `voxel` when game.json declares nothing. */
+    artStyle: string;
+    /** False when that style is the default rather than a declaration, which is worth saying. */
+    artStyleDeclared: boolean;
+    /** `desktop` unless the project says otherwise; null when it declares nothing at all. */
+    primaryPlatform: string | null;
+    reference: GameInfoImage | null;
+    cover: GameInfoImage | null;
+}
+export interface GameInfoSource {
+    root: string;
+    metadata: ProjectMetadata;
+    gameId: string;
+    gameName: string;
+    environment: string;
+}
+export declare function readGameInfo(source: GameInfoSource): GameInfo;
+/**
+ * The bytes of one picture, for the dialog's thumbnail.
+ *
+ * Served from disk rather than linked to the public URL because the local copy is the one that is
+ * always there: an accepted reference whose re-host failed carries an Asset Forger URL that
+ * expires, and a cover's URL is on whichever environment generated it. The content type is
+ * sniffed rather than taken from the extension — both files are written as `.webp` whatever the
+ * generator actually returned.
+ */
+export declare function readGameInfoImage(root: string, kind: GameInfoImageKind): {
+    bytes: Buffer;
+    contentType: string;
+} | null;

package/dist/editor/game-info.js

@@ -0,0 +1,126 @@
+/**
+ * What this project IS — the facts the dev view's bar used to spell out, plus the two pictures
+ * that decide how it looks.
+ *
+ * The bar carried the game's name, its id and its environment as three separate slots in a row
+ * that had run out of them. They answer one question — "which game is this?" — so they collapsed
+ * behind the name, and the dialog that opens has room for the rest of the answer: the genre and
+ * physics the engine boots with, the art style every generation inherits, and the accepted
+ * reference and cover art. The reference in particular had no window anywhere: `bitmagic
+ * reference show` draws it in a terminal, which is not where the creator is looking.
+ *
+ * Read on every open, never captured at startup. `bitmagic dev` runs for hours and the commands
+ * that write these files (`reference accept`, `cover`) run in another terminal — often an agent's
+ * — so anything cached here would answer with the project as it was this morning.
+ *
+ * Best effort throughout, exactly like every other reader of these files: a missing or corrupt
+ * record reads as "none yet", never as an error. This is a window onto the project, and a window
+ * must not be the thing that fails.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { DEFAULT_ART_STYLE } from '@bitmagic/asset-core/art-style';
+import { readArtStyleDeclaration } from '../project/art-style.js';
+import { readPlatformDeclaration } from '../project/platform-declaration.js';
+import { readAcceptedReference, referenceDirPath } from '../project/reference.js';
+import { sniffImageContentType } from '../project/reference-file.js';
+import { coverImagePath, readCoverRecord } from '../commands/cover.js';
+import { aliasSourceDir } from '../scaffold/aliases.js';
+/** One work-copy field, or undefined when the file is missing, unreadable or not an object. */
+function workGameJson(root) {
+    const file = path.join(root, aliasSourceDir('work'), 'game.json');
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+    return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
+        ? parsed
+        : null;
+}
+function stringField(source, key) {
+    const value = source?.[key];
+    return typeof value === 'string' && value !== '' ? value : null;
+}
+/**
+ * The local copy of one of the two pictures, when there is one.
+ *
+ * The reference's path comes out of a JSON file, so it is checked against the directory it is
+ * supposed to be in rather than trusted: this server serves whatever it returns, and
+ * `.bitmagic/reference.json` is a file a creator can hand-edit.
+ */
+function localImagePath(root, kind) {
+    if (kind === 'cover') {
+        const file = coverImagePath(root);
+        return fs.existsSync(file) ? file : null;
+    }
+    const accepted = readAcceptedReference(root);
+    if (!accepted?.imagePath)
+        return null;
+    const file = path.resolve(root, accepted.imagePath);
+    if (!file.startsWith(referenceDirPath(root) + path.sep))
+        return null;
+    return fs.existsSync(file) ? file : null;
+}
+function referenceImage(root) {
+    const accepted = readAcceptedReference(root);
+    if (!accepted)
+        return null;
+    return {
+        url: accepted.url,
+        local: localImagePath(root, 'reference') !== null,
+        at: accepted.acceptedAt,
+        hosted: accepted.hosted,
+        ...(accepted.candidateId !== undefined ? { candidateId: accepted.candidateId } : {}),
+    };
+}
+function coverImage(root) {
+    const record = readCoverRecord(root);
+    if (!record)
+        return null;
+    return { url: record.url, local: localImagePath(root, 'cover') !== null, at: record.generatedAt };
+}
+export function readGameInfo(source) {
+    const game = workGameJson(source.root);
+    const style = readArtStyleDeclaration(source.root);
+    const platform = readPlatformDeclaration(source.root);
+    return {
+        gameName: source.gameName,
+        gameId: source.gameId,
+        environment: source.environment,
+        engineVersion: source.metadata.engineVersion,
+        template: source.metadata.template,
+        genre: stringField(game, 'gameGenre') ?? source.metadata.genre,
+        physicsMode: stringField(game, 'physicsMode'),
+        artStyle: style.artStyle ?? DEFAULT_ART_STYLE,
+        artStyleDeclared: style.artStyle !== undefined,
+        primaryPlatform: platform.primaryPlatform ?? null,
+        reference: referenceImage(source.root),
+        cover: coverImage(source.root),
+    };
+}
+/**
+ * The bytes of one picture, for the dialog's thumbnail.
+ *
+ * Served from disk rather than linked to the public URL because the local copy is the one that is
+ * always there: an accepted reference whose re-host failed carries an Asset Forger URL that
+ * expires, and a cover's URL is on whichever environment generated it. The content type is
+ * sniffed rather than taken from the extension — both files are written as `.webp` whatever the
+ * generator actually returned.
+ */
+export function readGameInfoImage(root, kind) {
+    const file = localImagePath(root, kind);
+    if (file === null)
+        return null;
+    let bytes;
+    try {
+        bytes = fs.readFileSync(file);
+    }
+    catch {
+        return null;
+    }
+    return { bytes, contentType: sniffImageContentType(bytes)?.contentType ?? 'image/webp' };
+}
+//# sourceMappingURL=game-info.js.map

package/dist/editor/game-info.js.map

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

package/dist/editor/server.js

@@ -25,10 +25,12 @@ import { applyModificationsToWorld } from '../forge/apply-modifications.js';
 import { readProjectGameData } from '../forge/browser-host.js';
 import { projectWorldJsonPath } from '../forge/run-pipeline.js';
 import { renderEditorShell } from './shell-page.js';
+import { readGameInfo, readGameInfoImage } from './game-info.js';
 import { createCliUpdateReader } from './cli-update.js';
 import { renderAssetPreviewPage } from './asset-preview-page.js';
 import { renderAnimationPreviewPage } from './animation-preview-page.js';
 import { readPublishRecord } from '../publish/record.js';
+import { promotedPublishUrl } from '../publish/urls.js';
 import { encodeQr } from '../render/qr.js';
 import { encodeQrPng } from '../render/qr-png.js';
 import { buildSceneModifications } from './save.js';
@@ -1040,6 +1042,56 @@ export async function startEditorServer(options) {
                 }
                 return;
             }
+            /**
+             * Who this project is, and what it is supposed to look like — the bar's name button opens
+             * this.
+             *
+             * Read per request rather than captured at startup for the same reason `/api/state` reads
+             * the publish record every poll: `bitmagic dev` runs for hours, and `bitmagic cover` or
+             * `bitmagic reference accept` almost always runs later, in another terminal — often an
+             * agent's. Cheap enough not to need a poll of its own: nothing reads it until the creator
+             * opens the dialog.
+             */
+            if (req.method === 'GET' && url === '/api/game-info') {
+                sendJson(res, 200, {
+                    ok: true,
+                    info: readGameInfo({
+                        root: options.root,
+                        metadata: options.metadata,
+                        gameId: options.gameId,
+                        gameName: options.gameName,
+                        environment: options.environment,
+                    }),
+                });
+                return;
+            }
+            /**
+             * The local copy of the reference or the cover, for the dialog's thumbnails.
+             *
+             * Local bytes rather than the public URL, because the local copy is the one that is always
+             * reachable: a reference whose re-host failed carries an expiring Asset Forger URL, and a
+             * cover's URL lives on whichever environment generated it. No caching — `bitmagic cover`
+             * and `reference accept` rewrite these paths in place, and a browser holding the previous
+             * picture would show a creator the art they just replaced.
+             */
+            if (req.method === 'GET' && url === '/api/game-info/image') {
+                const kind = query.get('kind');
+                if (kind !== 'reference' && kind !== 'cover') {
+                    sendJson(res, 400, { ok: false, error: 'kind must be reference or cover' });
+                    return;
+                }
+                const image = readGameInfoImage(options.root, kind);
+                if (image === null) {
+                    sendJson(res, 404, { ok: false, error: `No local ${kind} image in this project` });
+                    return;
+                }
+                res.writeHead(200, {
+                    'Content-Type': image.contentType,
+                    'Content-Length': image.bytes.length,
+                    'Cache-Control': 'no-store',
+                }).end(image.bytes);
+                return;
+            }
             // Long-lived: the shell holds this open for its whole session. Must be checked before any
             // route that would end the response.
             if (req.method === 'GET' && url === '/api/events/stream') {
@@ -1237,13 +1289,17 @@ export async function startEditorServer(options) {
              */
             if (req.method === 'GET' && url === '/api/publish/qr.png') {
                 const record = readPublishRecord(options.root);
-                const matrix = record === null ? null : encodeQr(record.url);
+                // The shareable URL, matching both the panel's link and what the publishing terminal
+                // drew — see `promotedPublishUrl`. Encoding `record.url` here would put a phone on one
+                // frozen build while the link beside the code pointed at the newest.
+                const matrix = record === null ? null : encodeQr(promotedPublishUrl(record));
                 if (matrix === null) {
                     sendJson(res, 404, { ok: false, error: 'This project has not been published yet.' });
                     return;
                 }
-                // No caching: publishing again keeps the same URL for an alias publish but not for a
-                // versioned one, and a stale code would send a phone to the previous build.
+                // No caching: the shareable URL is stable across ordinary re-publishes, but a publish
+                // that flips visibility moves it between the `/play/` page and the `/games/` form, and a
+                // stale code would send a phone to the one that is no longer right.
                 res.writeHead(200, {
                     'Content-Type': 'image/png',
                     'Cache-Control': 'no-store',