@bitmagic/cli 0.1.64-dev.9 → 0.1.65-dev.1

package/dist/editor/design.d.ts

@@ -35,6 +35,7 @@ export declare const BM: {
     readonly shadowDialog: "0 8px 24px rgba(0, 0, 0, 0.5)";
     readonly shadowCard: "0 8px 8px rgba(0, 0, 0, 0.3)";
     readonly glowAqua: "0 0 24px rgba(160, 218, 185, 0.45)";
+    readonly focusRing: "0 0 0 2px rgba(160, 218, 185, 0.45)";
     readonly glowPink: "0 0 24px rgba(224, 33, 138, 0.4)";
     readonly insetBorderDim: "inset 0 0 0 1px #7c7c7c";
     readonly insetBorderFocus: "inset 0 0 0 1px #ffffff, 0 0 0 2px rgba(160, 218, 185, 0.45)";

package/dist/editor/design.js

@@ -35,6 +35,9 @@ export const BM = {
     shadowDialog: '0 8px 24px rgba(0, 0, 0, 0.5)',
     shadowCard: '0 8px 8px rgba(0, 0, 0, 0.3)',
     glowAqua: '0 0 24px rgba(160, 218, 185, 0.45)',
+    /* The keyboard-focus ring every control here wears. A token because a page's own CSS may not
+       carry a colour literal (shell-page.test.ts), and a focusable control it adds needs this one. */
+    focusRing: '0 0 0 2px rgba(160, 218, 185, 0.45)',
     glowPink: '0 0 24px rgba(224, 33, 138, 0.4)',
     insetBorderDim: 'inset 0 0 0 1px #7c7c7c',
     insetBorderFocus: 'inset 0 0 0 1px #ffffff, 0 0 0 2px rgba(160, 218, 185, 0.45)',
@@ -78,6 +81,7 @@ export const BITMAGIC_TOKENS_CSS = `
     --bm-shadow-dialog: ${BM.shadowDialog};
     --bm-shadow-card: ${BM.shadowCard};
     --bm-glow-aqua: ${BM.glowAqua};
+    --bm-focus-ring: ${BM.focusRing};
     --bm-glow-pink: ${BM.glowPink};
     --bm-font: ${BM.font};
     --bm-font-mono: ${BM.fontMono};
@@ -110,7 +114,7 @@ export const BITMAGIC_CONTROLS_CSS = `
                 box-shadow .15s ease, transform .15s ease;
   }
   .bm-pill:hover:not(:disabled) { background: var(--bm-surface-card); border-color: var(--bm-text-dim); }
-  .bm-pill:focus-visible { outline: none; box-shadow: 0 0 0 2px rgba(160, 218, 185, .45); }
+  .bm-pill:focus-visible { outline: none; box-shadow: var(--bm-focus-ring); }
   .bm-pill:disabled { opacity: .5; cursor: default; }
 
   /* Primary — the one creative action on a surface. Dark text: DESIGN.md forbids white on the
@@ -172,7 +176,7 @@ export const BITMAGIC_CONTROLS_CSS = `
     transition: background .15s ease, border-color .15s ease, color .15s ease;
   }
   .bm-icon-btn:hover:not(:disabled) { background: var(--bm-surface-card); border-color: var(--bm-text-dim); }
-  .bm-icon-btn:focus-visible { outline: none; box-shadow: 0 0 0 2px rgba(160, 218, 185, .45); }
+  .bm-icon-btn:focus-visible { outline: none; box-shadow: var(--bm-focus-ring); }
 
   /* === Vertical separator (toolbar) ========================================================= */
   .bm-separator-v { width: 1px; align-self: stretch; margin: 12px 4px; background: var(--bm-border); }
@@ -214,7 +218,7 @@ export const BITMAGIC_CONTROLS_CSS = `
   }
   .bm-menu-item:hover:not(:disabled) { background: var(--bm-border-muted); }
   .bm-menu-item:focus-visible { outline: none; background: var(--bm-border-muted);
-                                box-shadow: 0 0 0 2px rgba(160, 218, 185, .45); }
+                                box-shadow: var(--bm-focus-ring); }
   .bm-menu-item:disabled { opacity: .5; cursor: default; }
 
   /* === Input ================================================================================ */

package/dist/editor/design.js.map

@@ -1 +1 @@
-{"version":3,"file":"design.js","sourceRoot":"","sources":["../../src/editor/design.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,EAAE,EAAE,SAAS;IACb,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,SAAS;IAEtB,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,SAAS;IAEvB,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,SAAS;IAEtB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IAEjB,YAAY,EAAE,+BAA+B;IAC7C,UAAU,EAAE,8BAA8B;IAC1C,QAAQ,EAAE,oCAAoC;IAC9C,QAAQ,EAAE,kCAAkC;IAC5C,cAAc,EAAE,yBAAyB;IACzC,gBAAgB,EAAE,8DAA8D;IAEhF,IAAI,EAAE,8EAA8E;IACpF,QAAQ,EAAE,gDAAgD;CAClD,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;0HAEwF,CAAC;AAE3H,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;eAGpB,EAAE,CAAC,EAAE;oBACA,EAAE,CAAC,OAAO;wBACN,EAAE,CAAC,UAAU;yBACZ,EAAE,CAAC,WAAW;iBACtB,EAAE,CAAC,WAAW;uBACR,EAAE,CAAC,SAAS;qBACd,EAAE,CAAC,OAAO;mBACZ,EAAE,CAAC,MAAM;yBACH,EAAE,CAAC,WAAW;iBACtB,EAAE,CAAC,IAAI;uBACD,EAAE,CAAC,SAAS;iBAClB,EAAE,CAAC,IAAI;uBACD,EAAE,CAAC,SAAS;oBACf,EAAE,CAAC,OAAO;mBACX,EAAE,CAAC,MAAM;;;;;;;0BAOF,EAAE,CAAC,YAAY;wBACjB,EAAE,CAAC,UAAU;sBACf,EAAE,CAAC,QAAQ;sBACX,EAAE,CAAC,QAAQ;iBAChB,EAAE,CAAC,IAAI;sBACF,EAAE,CAAC,QAAQ;;CAEhC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqInB,EAAE,CAAC,cAAc;;;;;;;kCAOD,EAAE,CAAC,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDpD,CAAC"}
+{"version":3,"file":"design.js","sourceRoot":"","sources":["../../src/editor/design.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,EAAE,EAAE,SAAS;IACb,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,SAAS;IAEtB,WAAW,EAAE,SAAS;IACtB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,SAAS;IAEvB,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,SAAS;IAEtB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,IAAI,EAAE,SAAS;IACf,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,SAAS;IACtB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IAEjB,YAAY,EAAE,+BAA+B;IAC7C,UAAU,EAAE,8BAA8B;IAC1C,QAAQ,EAAE,oCAAoC;IAC9C;sGACkG;IAClG,SAAS,EAAE,qCAAqC;IAChD,QAAQ,EAAE,kCAAkC;IAC5C,cAAc,EAAE,yBAAyB;IACzC,gBAAgB,EAAE,8DAA8D;IAEhF,IAAI,EAAE,8EAA8E;IACpF,QAAQ,EAAE,gDAAgD;CAClD,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;0HAEwF,CAAC;AAE3H,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;eAGpB,EAAE,CAAC,EAAE;oBACA,EAAE,CAAC,OAAO;wBACN,EAAE,CAAC,UAAU;yBACZ,EAAE,CAAC,WAAW;iBACtB,EAAE,CAAC,WAAW;uBACR,EAAE,CAAC,SAAS;qBACd,EAAE,CAAC,OAAO;mBACZ,EAAE,CAAC,MAAM;yBACH,EAAE,CAAC,WAAW;iBACtB,EAAE,CAAC,IAAI;uBACD,EAAE,CAAC,SAAS;iBAClB,EAAE,CAAC,IAAI;uBACD,EAAE,CAAC,SAAS;oBACf,EAAE,CAAC,OAAO;mBACX,EAAE,CAAC,MAAM;;;;;;;0BAOF,EAAE,CAAC,YAAY;wBACjB,EAAE,CAAC,UAAU;sBACf,EAAE,CAAC,QAAQ;uBACV,EAAE,CAAC,SAAS;sBACb,EAAE,CAAC,QAAQ;iBAChB,EAAE,CAAC,IAAI;sBACF,EAAE,CAAC,QAAQ;;CAEhC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqInB,EAAE,CAAC,cAAc;;;;;;;kCAOD,EAAE,CAAC,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDpD,CAAC"}

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

@@ -0,0 +1,33 @@
+/**
+ * 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 declare const GAME_INFO_PANEL_CSS = "\n  /* The name IS the button. Bold and white like the label it replaces, with the id and env it\n     absorbed now one click away rather than two more slots in the bar. */\n  #game-info-toggle {\n    display: flex;\n    align-items: center;\n    gap: 6px;\n    max-width: 26vw;\n    padding: 4px 8px;\n    background: transparent;\n    border: 1px solid transparent;\n    border-radius: 6px;\n    color: var(--bm-text);\n    font-family: var(--bm-font);\n    font-size: 14px;\n    font-weight: 700;\n    line-height: 1.2;\n    cursor: pointer;\n    transition: background .15s ease, border-color .15s ease;\n  }\n  #game-info-toggle:hover { background: var(--bm-surface-alt); border-color: var(--bm-border-muted); }\n  #game-info-toggle:focus-visible { outline: none; box-shadow: var(--bm-focus-ring); }\n  #game-info-toggle .name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n  /* The affordance. Dim, so the name still reads as the name rather than as a menu. */\n  #game-info-toggle .chevron { flex: none; color: var(--bm-text-dim); font-size: 10px; }\n\n  /* Level with the other two dialogs: all three are opened from different controls and never\n     stack. */\n  #info-overlay { z-index: 10; }\n  #info-dialog { width: min(560px, 92vw); max-height: 86vh; overflow-y: auto; padding: 20px; }\n  #info-dialog h2 { margin-bottom: 16px; }\n  /* A definition list, because that is what this is: a fixed set of fields with one value each.\n     Two columns so the values line up and the whole block is scannable without reading it. */\n  #info-facts { display: grid; grid-template-columns: auto 1fr; gap: 8px 16px; margin: 0 0 20px; }\n  #info-facts dt { font-size: 12px; font-weight: 700; text-transform: uppercase;\n                   letter-spacing: 1.4px; color: var(--bm-text-muted); }\n  #info-facts dd { margin: 0; min-width: 0; color: var(--bm-text); overflow-wrap: anywhere; }\n  /* Ids, versions and modes are read character by character; names and genres are read as words. */\n  #info-facts dd.mono { font-family: var(--bm-font-mono); font-size: 12px; }\n  #info-facts dd .note { color: var(--bm-text-dim); }\n  /* The two pictures, side by side: they are the same kind of thing and are compared, not read\n     in order. They wrap to one column when the dialog is at its narrowest. */\n  #info-art { display: flex; flex-wrap: wrap; gap: 16px; }\n  .info-art-card { flex: 1 1 200px; min-width: 0; }\n  .info-art-card .bm-label { display: block; margin-bottom: 8px; }\n  /* A square frame either way, so a present picture and a missing one leave the dialog the same\n     height and the two cards stay level.\n\n     A button rather than a div, because with a picture in it that is what it is: the thumbnail is\n     a couple of hundred pixels of an image generated at 1024, which is not enough to judge the\n     look it is supposed to fix \u2014 clicking it opens the full size. Disabled while the card is\n     empty, so the control is dead exactly when there is nothing to open, and reachable by keyboard\n     for free either way. */\n  .info-art-frame {\n    display: flex;\n    align-items: center;\n    justify-content: center;\n    width: 100%;\n    aspect-ratio: 1 / 1;\n    padding: 12px;\n    background: var(--bm-surface-alt);\n    border: 1px solid var(--bm-border-muted);\n    border-radius: 6px;\n    color: inherit;\n    font: inherit;\n    text-align: center;\n    cursor: zoom-in;\n    transition: border-color .15s ease;\n  }\n  .info-art-frame:hover:not(:disabled) { border-color: var(--bm-text-dim); }\n  .info-art-frame:focus-visible { outline: none; box-shadow: var(--bm-focus-ring); }\n  /* Not dimmed like an ordinary disabled control: there is nothing to enable here, and greying the\n     \"not yet\" copy would hide the command that fixes it. */\n  .info-art-frame:disabled { cursor: default; }\n  /* The frame holds the picture AND the \"not yet\" copy, and shows exactly one of them: the class\n     is applied by openInfo(), because a page assembled as a string has no inline styles to toggle\n     (DESIGN.md, and the same rule the Creator follows). */\n  .info-art-frame img { display: none; max-width: 100%; max-height: 100%; border-radius: 4px; }\n  .info-art-frame.has-image img { display: block; }\n  .info-art-frame.has-image .empty { display: none; }\n  /* What to run to make the missing one, rather than the bare fact that it is missing. */\n  .info-art-frame .empty { font-size: 12px; color: var(--bm-text-dim); }\n  .info-art-frame .empty code { display: block; margin-top: 6px; color: var(--bm-aqua);\n                                font-family: var(--bm-font-mono); }\n  .info-art-card .caption { margin-top: 8px; font-size: 12px; color: var(--bm-text-dim);\n                            overflow-wrap: anywhere; }\n  .info-art-card .caption a { color: var(--bm-aqua); text-decoration: none; }\n  .info-art-card .caption a:hover { text-decoration: underline; }\n  /* An expiring reference URL is the one thing on this card worth interrupting for. */\n  .info-art-card .caption .stale { color: var(--bm-pumpkin); }\n  /* === The full-size view ===================================================================\n     A layer of its own above the dialog rather than a new browser tab: the dev view is the window\n     the creator is already in, and a tab showing a bare image on a loopback port is a place they\n     then have to come back from. Click anywhere, or Escape, and the dialog is still underneath\n     exactly as it was. */\n  #info-zoom { z-index: 11; flex-direction: column; gap: 12px; cursor: zoom-out; }\n  #info-zoom img { max-width: 92vw; max-height: 84vh; border-radius: 6px;\n                   box-shadow: var(--bm-shadow-dialog); }\n  #info-zoom .hint { font-size: 12px; color: var(--bm-text-muted); }\n\n  /* The sidecar could not answer. Said in the dialog rather than in the bar's status line, which\n     belongs to the save state and would be overwritten by the next poll. */\n  #info-error { display: none; margin: 0 0 16px; font-size: 12px; color: var(--bm-pumpkin); }\n  #info-error.show { display: block; }\n  #info-actions { display: flex; justify-content: flex-end; margin-top: 20px; }\n";
+/**
+ * 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 declare const GAME_INFO_PANEL_HTML = "  <div id=\"info-overlay\" class=\"bm-overlay\">\n    <div id=\"info-dialog\" class=\"bm-dialog\">\n      <h2 id=\"info-title\"></h2>\n      <p id=\"info-error\"></p>\n      <dl id=\"info-facts\">\n        <dt>Game id</dt><dd id=\"info-game-id\" class=\"mono\"></dd>\n        <dt>Environment</dt><dd id=\"info-environment\" class=\"mono\"></dd>\n        <dt>Genre</dt><dd id=\"info-genre\"></dd>\n        <dt>Physics</dt><dd id=\"info-physics\" class=\"mono\"></dd>\n        <dt>Art style</dt><dd id=\"info-art-style\"></dd>\n        <dt>Platform</dt><dd id=\"info-platform\"></dd>\n        <dt>Engine</dt><dd id=\"info-engine\" class=\"mono\"></dd>\n      </dl>\n      <div id=\"info-art\">\n        <div class=\"info-art-card\">\n          <span class=\"bm-label\">Reference image</span>\n          <button id=\"info-reference-frame\" class=\"info-art-frame\" type=\"button\" disabled title=\"See it full size\">\n            <img id=\"info-reference-img\" alt=\"This game's accepted reference image\">\n            <span id=\"info-reference-empty\" class=\"empty\">No reference image yet.<code>bitmagic reference make</code></span>\n          </button>\n          <p id=\"info-reference-caption\" class=\"caption\"></p>\n        </div>\n        <div class=\"info-art-card\">\n          <span class=\"bm-label\">Cover art</span>\n          <button id=\"info-cover-frame\" class=\"info-art-frame\" type=\"button\" disabled title=\"See it full size\">\n            <img id=\"info-cover-img\" alt=\"This game's cover art\">\n            <span id=\"info-cover-empty\" class=\"empty\">No cover art yet.<code>bitmagic cover</code></span>\n          </button>\n          <p id=\"info-cover-caption\" class=\"caption\"></p>\n        </div>\n      </div>\n      <div id=\"info-actions\">\n        <button id=\"info-close\" class=\"bm-pill bm-pill--primary\" type=\"button\">Close</button>\n      </div>\n    </div>\n  </div>\n  <div id=\"info-zoom\" class=\"bm-overlay\">\n    <img id=\"info-zoom-img\" alt=\"\">\n    <span class=\"hint\">Click anywhere to go back.</span>\n  </div>\n";

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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AA+CxD,+FAA+F;AAC/F,SAAS,YAAY,CAAC,IAAY;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;IAClE,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5E,CAAC,CAAE,MAAkC;QACrC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,WAAW,CAAC,MAAsC,EAAE,GAAW;IACtE,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,IAAuB;IAC3D,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3C,CAAC;IACD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ,EAAE,SAAS;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACrE,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO;QACL,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,KAAK,EAAE,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,IAAI;QACjD,EAAE,EAAE,QAAQ,CAAC,UAAU;QACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAsB;IACjD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;QAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;QAClC,KAAK,EAAE,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK;QAC9D,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC;QAC7C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,iBAAiB;QAC7C,gBAAgB,EAAE,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC9C,eAAe,EAAE,QAAQ,CAAC,eAAe,IAAI,IAAI;QACjD,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC;QACtC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,IAAuB;IAEvB,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE,WAAW,IAAI,YAAY,EAAE,CAAC;AAC3F,CAAC"}

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',