@bitmagic/cli 0.1.52-dev.10 → 0.1.52-dev.12

package/dist/project/platform-declaration.d.ts

@@ -0,0 +1,51 @@
+/**
+ * What a project's work copy DECLARES about the platform it is for: `primaryPlatform` at the top
+ * level of `src/work/game.json`, and `worldProfileData.mobileOrientation`.
+ *
+ * One reader, because two commands now act on the same two fields and must never disagree about
+ * them. `bitmagic publish` syncs them to the catalogue (`publish/platform.ts`), and `bitmagic
+ * verify` / `bitmagic judge` use them to decide which platform to BOOT and whether a mobile
+ * parity gap is a warning or a failure. A second copy of this parse would drift the day one of
+ * those files moves.
+ *
+ * This module reports what the files SAY and nothing about what to do with it: a value that is
+ * present but unusable lands in `rejected` rather than in a sentence, because "leaving the stored
+ * platform alone" and "verifying on the desktop viewport instead" are different consequences of
+ * the same bad value and only the caller knows which one applies.
+ *
+ * Best effort throughout: a missing, unreadable or malformed file means "the project declares
+ * nothing", never an error. A declaration must not be able to fail a command whose real work
+ * succeeded.
+ */
+export type PrimaryPlatform = 'desktop' | 'mobile';
+export type MobileOrientation = 'portrait' | 'landscape';
+export interface PlatformDeclaration {
+    /**
+     * `undefined` means the project declares nothing, which is NOT the same as declaring
+     * 'desktop': publish's catalogue columns are sticky, so "says nothing" must leave the stored
+     * value alone while "says desktop" must overwrite it. Verify treats both as desktop, but it
+     * has to be able to tell them apart to explain WHY it picked a platform.
+     */
+    primaryPlatform?: PrimaryPlatform;
+    mobileOrientation?: MobileOrientation;
+    /** Whether either work-copy file could be read at all. */
+    workCopyReadable: boolean;
+    /** Values that were present but not one of the accepted ones, verbatim, for the caller's message. */
+    rejected: {
+        primaryPlatform?: unknown;
+        mobileOrientation?: unknown;
+    };
+}
+/**
+ * Parse the platform declaration out of `src/work/`.
+ *
+ * `mobileOrientation` resolves world.json first, game.json second, matching the web lane's own
+ * resolution (`game-storage-backend.ts`'s `getListingFieldsSync`). Note this is the OPPOSITE
+ * order to `readFaviconOverride` in publish/favicon.ts, which reads game.json first — the
+ * favicon override's home is game.json, the orientation's is world.json, and neither order is a
+ * house style.
+ *
+ * The legacy `mainPlatform` spelling is NOT honoured: it predates the CLI lane entirely, so no
+ * project this reads can carry it.
+ */
+export declare function readPlatformDeclaration(root: string): PlatformDeclaration;

package/dist/project/platform-declaration.js

@@ -0,0 +1,81 @@
+/**
+ * What a project's work copy DECLARES about the platform it is for: `primaryPlatform` at the top
+ * level of `src/work/game.json`, and `worldProfileData.mobileOrientation`.
+ *
+ * One reader, because two commands now act on the same two fields and must never disagree about
+ * them. `bitmagic publish` syncs them to the catalogue (`publish/platform.ts`), and `bitmagic
+ * verify` / `bitmagic judge` use them to decide which platform to BOOT and whether a mobile
+ * parity gap is a warning or a failure. A second copy of this parse would drift the day one of
+ * those files moves.
+ *
+ * This module reports what the files SAY and nothing about what to do with it: a value that is
+ * present but unusable lands in `rejected` rather than in a sentence, because "leaving the stored
+ * platform alone" and "verifying on the desktop viewport instead" are different consequences of
+ * the same bad value and only the caller knows which one applies.
+ *
+ * Best effort throughout: a missing, unreadable or malformed file means "the project declares
+ * nothing", never an error. A declaration must not be able to fail a command whose real work
+ * succeeded.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { aliasSourceDir } from '../scaffold/aliases.js';
+/**
+ * Parse the platform declaration out of `src/work/`.
+ *
+ * `mobileOrientation` resolves world.json first, game.json second, matching the web lane's own
+ * resolution (`game-storage-backend.ts`'s `getListingFieldsSync`). Note this is the OPPOSITE
+ * order to `readFaviconOverride` in publish/favicon.ts, which reads game.json first — the
+ * favicon override's home is game.json, the orientation's is world.json, and neither order is a
+ * house style.
+ *
+ * The legacy `mainPlatform` spelling is NOT honoured: it predates the CLI lane entirely, so no
+ * project this reads can carry it.
+ */
+export function readPlatformDeclaration(root) {
+    const workDir = path.join(root, aliasSourceDir('work'));
+    const game = readJsonObject(path.join(workDir, 'game.json'));
+    const world = readJsonObject(path.join(workDir, 'world.json'));
+    const declaration = {
+        workCopyReadable: game !== null || world !== null,
+        rejected: {},
+    };
+    const declared = game?.primaryPlatform;
+    if (declared === 'desktop' || declared === 'mobile') {
+        declaration.primaryPlatform = declared;
+    }
+    else if (declared !== undefined) {
+        declaration.rejected.primaryPlatform = declared;
+    }
+    const orientation = worldProfileValue(world, 'mobileOrientation')
+        ?? worldProfileValue(game, 'mobileOrientation');
+    if (orientation === 'portrait' || orientation === 'landscape') {
+        declaration.mobileOrientation = orientation;
+    }
+    else if (orientation !== undefined) {
+        declaration.rejected.mobileOrientation = orientation;
+    }
+    return declaration;
+}
+/** Parse one work-copy JSON file, or null when it is missing, unreadable or not an object. */
+function readJsonObject(filePath) {
+    let parsed;
+    try {
+        if (!fs.existsSync(filePath))
+            return null;
+        parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+    return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
+        ? parsed
+        : null;
+}
+function worldProfileValue(source, key) {
+    const profile = source?.worldProfileData;
+    if (typeof profile !== 'object' || profile === null || Array.isArray(profile))
+        return undefined;
+    return profile[key];
+}
+//# sourceMappingURL=platform-declaration.js.map

package/dist/project/platform-declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-declaration.js","sourceRoot":"","sources":["../../src/project/platform-declaration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAuBxD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAE/D,MAAM,WAAW,GAAwB;QACvC,gBAAgB,EAAE,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI;QACjD,QAAQ,EAAE,EAAE;KACb,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,EAAE,eAAe,CAAC;IACvC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpD,WAAW,CAAC,eAAe,GAAG,QAAQ,CAAC;IACzC,CAAC;SAAM,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,WAAW,CAAC,QAAQ,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClD,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC;WAC5D,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;IAClD,IAAI,WAAW,KAAK,UAAU,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;QAC9D,WAAW,CAAC,iBAAiB,GAAG,WAAW,CAAC;IAC9C,CAAC;SAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QACrC,WAAW,CAAC,QAAQ,CAAC,iBAAiB,GAAG,WAAW,CAAC;IACvD,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,8FAA8F;AAC9F,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,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,iBAAiB,CAAC,MAAsC,EAAE,GAAW;IAC5E,MAAM,OAAO,GAAG,MAAM,EAAE,gBAAgB,CAAC;IACzC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAChG,OAAQ,OAAmC,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC"}

package/dist/publish/platform.d.ts

@@ -15,6 +15,10 @@ export interface PlatformIndicatorsResult {
  * game is FOR (`primaryPlatform`, top level of game.json) and, for a phone game that only makes
  * sense one way up, `worldProfileData.mobileOrientation`.
  *
+ * The parse itself lives in `project/platform-declaration.ts`, shared with `bitmagic verify`,
+ * which boots the platform the same two fields declare. What stays HERE is the wire semantics,
+ * which are publish's alone.
+ *
  * The project files are the source of truth, exactly as they are in the web lane — the columns
  * are "indicators synced from game.json at publish, like `genre`" (migration 048). So a value
  * changed anywhere else is reverted by the creator's next publish, and the way to make a game
@@ -31,14 +35,6 @@ export interface PlatformIndicatorsResult {
  *    the key instead would make an orientation impossible to remove from here. Only a work copy
  *    neither of whose files can be read omits the key.
  *
- * world.json wins over game.json for the orientation, matching the web lane's own resolution
- * (`game-storage-backend.ts`'s `getListingFieldsSync`). Note this is the OPPOSITE order to
- * `readFaviconOverride` in favicon.ts, which reads game.json first — the favicon override's home
- * is game.json, the orientation's is world.json, and neither order is a house style.
- *
- * The legacy `mainPlatform` spelling is NOT honoured: it predates the CLI lane entirely, so no
- * project this reads can carry it.
- *
  * Best effort throughout, like `readFaviconOverride`: a missing, unreadable or malformed file
  * means "the project declares nothing", never an error. A catalog indicator must not be able to
  * fail a publish whose bundle is already uploaded.

package/dist/publish/platform.js

@@ -1,11 +1,13 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { aliasSourceDir } from '../scaffold/aliases.js';
+import { readPlatformDeclaration } from '../project/platform-declaration.js';
 /**
  * The platform indicators a publish syncs from the project's own work copy: which platform the
  * game is FOR (`primaryPlatform`, top level of game.json) and, for a phone game that only makes
  * sense one way up, `worldProfileData.mobileOrientation`.
  *
+ * The parse itself lives in `project/platform-declaration.ts`, shared with `bitmagic verify`,
+ * which boots the platform the same two fields declare. What stays HERE is the wire semantics,
+ * which are publish's alone.
+ *
  * The project files are the source of truth, exactly as they are in the web lane — the columns
  * are "indicators synced from game.json at publish, like `genre`" (migration 048). So a value
  * changed anywhere else is reverted by the creator's next publish, and the way to make a game
@@ -22,44 +24,29 @@ import { aliasSourceDir } from '../scaffold/aliases.js';
  *    the key instead would make an orientation impossible to remove from here. Only a work copy
  *    neither of whose files can be read omits the key.
  *
- * world.json wins over game.json for the orientation, matching the web lane's own resolution
- * (`game-storage-backend.ts`'s `getListingFieldsSync`). Note this is the OPPOSITE order to
- * `readFaviconOverride` in favicon.ts, which reads game.json first — the favicon override's home
- * is game.json, the orientation's is world.json, and neither order is a house style.
- *
- * The legacy `mainPlatform` spelling is NOT honoured: it predates the CLI lane entirely, so no
- * project this reads can carry it.
- *
  * Best effort throughout, like `readFaviconOverride`: a missing, unreadable or malformed file
  * means "the project declares nothing", never an error. A catalog indicator must not be able to
  * fail a publish whose bundle is already uploaded.
  */
 export function readPlatformIndicators(root) {
-    const workDir = path.join(root, aliasSourceDir('work'));
-    const game = readJsonObject(path.join(workDir, 'game.json'));
-    const world = readJsonObject(path.join(workDir, 'world.json'));
+    const declaration = readPlatformDeclaration(root);
     const fields = {};
     const notes = [];
-    const declared = game?.primaryPlatform;
-    if (declared === 'desktop' || declared === 'mobile') {
-        fields.primaryPlatform = declared;
+    if (declaration.primaryPlatform !== undefined) {
+        fields.primaryPlatform = declaration.primaryPlatform;
+    }
+    if (declaration.workCopyReadable) {
+        // Explicit null when the work copy is readable but declares nothing — see the doc comment.
+        fields.mobileOrientation = declaration.mobileOrientation ?? null;
     }
-    else if (declared !== undefined) {
-        notes.push(`game.json primaryPlatform ${JSON.stringify(declared)} is not "desktop" or "mobile" — ` +
-            'leaving the stored platform alone.');
+    const { rejected } = declaration;
+    if ('primaryPlatform' in rejected) {
+        notes.push(`game.json primaryPlatform ${JSON.stringify(rejected.primaryPlatform)} is not "desktop" `
+            + 'or "mobile" — leaving the stored platform alone.');
     }
-    if (world !== null || game !== null) {
-        const orientation = worldProfileValue(world, 'mobileOrientation') ?? worldProfileValue(game, 'mobileOrientation');
-        if (orientation === 'portrait' || orientation === 'landscape') {
-            fields.mobileOrientation = orientation;
-        }
-        else {
-            if (orientation !== undefined) {
-                notes.push(`worldProfileData.mobileOrientation ${JSON.stringify(orientation)} is not "portrait" ` +
-                    'or "landscape" — publishing with no orientation lock.');
-            }
-            fields.mobileOrientation = null;
-        }
+    if ('mobileOrientation' in rejected) {
+        notes.push(`worldProfileData.mobileOrientation ${JSON.stringify(rejected.mobileOrientation)} is not `
+            + '"portrait" or "landscape" — publishing with no orientation lock.');
     }
     if (fields.primaryPlatform === 'mobile') {
         notes.push(fields.mobileOrientation
@@ -68,25 +55,4 @@ export function readPlatformIndicators(root) {
     }
     return { fields, notes };
 }
-/** Parse one work-copy JSON file, or null when it is missing, unreadable or not an object. */
-function readJsonObject(filePath) {
-    let parsed;
-    try {
-        if (!fs.existsSync(filePath))
-            return null;
-        parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-    return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
-        ? parsed
-        : null;
-}
-function worldProfileValue(source, key) {
-    const profile = source?.worldProfileData;
-    if (typeof profile !== 'object' || profile === null || Array.isArray(profile))
-        return undefined;
-    return profile[key];
-}
 //# sourceMappingURL=platform.js.map

package/dist/publish/platform.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/publish/platform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAG,IAAI,EAAE,eAAe,CAAC;IACvC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,CAAC,eAAe,GAAG,QAAQ,CAAC;IACpC,CAAC;SAAM,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,6BAA6B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,kCAAkC;YACrF,oCAAoC,CACvC,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACpC,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,CAAC,IAAI,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAClH,IAAI,WAAW,KAAK,UAAU,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAC9D,MAAM,CAAC,iBAAiB,GAAG,WAAW,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CACR,sCAAsC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,qBAAqB;oBACpF,uDAAuD,CAC1D,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAClC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,iBAAiB;YACtB,CAAC,CAAC,yCAAyC,MAAM,CAAC,iBAAiB,GAAG;YACtE,CAAC,CAAC,6BAA6B,CAClC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED,8FAA8F;AAC9F,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,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,iBAAiB,CAAC,MAAsC,EAAE,GAAW;IAC5E,MAAM,OAAO,GAAG,MAAM,EAAE,gBAAgB,CAAC;IACzC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAChG,OAAQ,OAAmC,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/publish/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAgB7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,WAAW,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAElD,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,WAAW,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC9C,MAAM,CAAC,eAAe,GAAG,WAAW,CAAC,eAAe,CAAC;IACvD,CAAC;IAED,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;QACjC,2FAA2F;QAC3F,MAAM,CAAC,iBAAiB,GAAG,WAAW,CAAC,iBAAiB,IAAI,IAAI,CAAC;IACnE,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;IACjC,IAAI,iBAAiB,IAAI,QAAQ,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,6BAA6B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,oBAAoB;cACrF,kDAAkD,CACvD,CAAC;IACJ,CAAC;IACD,IAAI,mBAAmB,IAAI,QAAQ,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CACR,sCAAsC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,UAAU;cACtF,kEAAkE,CACvE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,iBAAiB;YACtB,CAAC,CAAC,yCAAyC,MAAM,CAAC,iBAAiB,GAAG;YACtE,CAAC,CAAC,6BAA6B,CAClC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/scaffold/project-files.js

@@ -647,11 +647,17 @@ are configured in **code** — there is no panel for them.
   …)\` for a gameplay action. The first strands phone players and the engine logs a
   \`[mobile-parity]\` error on game start; the raw listener strands them **silently** — the parity
   check cannot see a listener that never went through the engine.
+- **\`bitmagic verify\` enforces this.** Every run reports the parity gaps, naming the key and the
+  system that registered it — a warning normally, and a **failure** on a game whose
+  \`primaryPlatform\` is \`mobile\`. \`bitmagic verify --platform mobile\` goes further and boots
+  the game as a phone: touch controls, phone viewport, the engine's real mobile branch.
 - **Say which platform the game is for.** \`"primaryPlatform": "mobile"\` at the top level of
   \`src/work/game.json\` is what bitmagic.ai catalogs it as, and \`bitmagic publish\` sends it —
-  editing that file is the only way to set it. For a game that only works one way up, add
-  \`"mobileOrientation": "portrait"\` (or \`"landscape"\`) to \`worldProfileData\` in
-  \`src/work/world.json\`; published mobile builds lock to it.
+  editing that file is the only way to set it. It also decides what \`verify\` boots and \`judge\`
+  grades by default, so setting it is how a phone game gets checked as one. For a game that only
+  works one way up, add \`"mobileOrientation": "portrait"\` (or \`"landscape"\`) to
+  \`worldProfileData\` in \`src/work/world.json\`; published mobile builds lock to it, and the
+  mobile verify run turns the phone the same way.
 
 Details — button slots, icons, the joystick, the parity check: \`engine/agent-docs/control-system.md\`.
 
@@ -661,6 +667,7 @@ Details — button slots, icons, the joystick, the parity check: \`engine/agent-
 bitmagic check     # typecheck against the vendored engine
 bitmagic reload    # tell the open browser you have finished a round of edits
 bitmagic verify    # boot the game in a real browser and report what broke
+bitmagic verify --platform mobile   # boot it as a phone: touch controls, phone viewport
 bitmagic judge     # grade the verify screenshot against a quality rubric (paid, cheap)
 \`\`\`
 
@@ -751,7 +758,8 @@ bitmagic publish    # verify-gate, build if needed, and ship to bitmagic.ai
 Follow this order; \`publish\` enforces it and refuses otherwise:
 
 1. Run \`bitmagic verify\` and get it passing. It writes \`.bitmagic/verify/result.json\`,
-   \`.bitmagic/verify/screenshot.png\` and \`.bitmagic/verify/console.log\`.
+   \`.bitmagic/verify/screenshot.png\` and \`.bitmagic/verify/console.log\` — or the
+   \`.mobile\`-suffixed names when the run was a phone one.
 
    The publish thumbnail is \`.bitmagic/cover.webp\` when \`bitmagic cover\` has produced one, and
    that screenshot otherwise. The output names which one it used.
@@ -1005,7 +1013,8 @@ that I would otherwise have defaulted differently.
 
 ## Platform
 \`primaryPlatform\` in \`game.json\` — \`desktop\` or \`mobile\`. Plus \`worldProfileData.mobileOrientation\`
-in \`world.json\` when the game only works one way up.
+in \`world.json\` when the game only works one way up. If \`mobile\`: every action needs a touch
+button, and \`bitmagic verify\` fails the run otherwise.
 
 ## Slice 1 — the smallest playable thing
 - Core verb:          the ONE thing the player does
@@ -1468,6 +1477,7 @@ description: Use after finishing a milestone — a mechanics-plan slice shipped,
 bitmagic verify              # first: captures the screenshot the judge grades (no --fast)
 bitmagic judge               # one vision-model call; prints a scorecard, exits 0
 bitmagic judge --genre platformer   # sharpen the rubric: platformer, racing, shooter, combat, driving, tower-defense
+bitmagic judge --platform mobile   # grade the phone frame: touch-HUD legibility, thumb reach, portrait framing
 bitmagic judge --min-score 7 # exit 4 when the overall score is below the bar
 bitmagic judge --json        # the scorecard as one JSON document on stdout
 \`\`\`
@@ -1478,6 +1488,10 @@ model and prints back four dimension scores (visual-quality, readability, design
 and at most three findings — each naming what to change, most severe first. The scorecard is also
 written to \`.bitmagic/judge.json\`.
 
+A mobile-primary game is graded on its phone frame by default — the one
+\`bitmagic verify --platform mobile\` captured — with the rubric re-pointed at what a phone player
+sees. Pass \`--platform desktop\` to grade the other one.
+
 It is paid (sparks, roughly the cost of one small model call) and deliberate — which is why it is
 a command you run, not something verify does for you.
 

package/dist/scaffold/project-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-files.js","sourceRoot":"","sources":["../../src/scaffold/project-files.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project-files.js","sourceRoot":"","sources":["../../src/scaffold/project-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKjF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;IAkBnC,CAAC;AAEL;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,2BAA2B,EAAE,SAAS;IACtC,2BAA2B,EAAE,SAAS;IACtC,kBAAkB,EAAE,QAAQ;IAC5B,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,kCAAkC,EAAE,QAAQ;IAC5C,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,UAAU;IACjB,4FAA4F;IAC5F,6FAA6F;IAC7F,4CAA4C;CACZ,CAAC;AAEnC,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,aAAa,EAAE,UAAU;IACzB,cAAc,EAAE,UAAU;IAC1B,8FAA8F;IAC9F,cAAc,EAAE,QAAQ;IACxB,4FAA4F;IAC5F,mFAAmF;IACnF,eAAe,EAAE,SAAS;IAC1B,UAAU,EAAE,QAAQ;IACpB,IAAI,EAAE,QAAQ;IACd,wBAAwB,EAAE,QAAQ;CACnC,CAAC;AAEF,qEAAqE;AACrE,SAAS,aAAa,CAAC,IAA+B;IACpD,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAS,MAAM,CAAC,IAA+B;IAC7C,OAAO,kBAAkB,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AAElC;;;GAGG;AACH,MAAM,kBAAkB,GAAG,yBAAyB,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;AAE7E;;;;GAIG;AACH,MAAM,YAAY,GAAG,GAAG,SAAS,SAAS,CAAC;AAE3C;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG;IACjB,uBAAuB;IACvB,eAAe,YAAY,IAAI;IAC/B,6BAA6B,SAAS,2CAA2C;IACjF,yBAAyB,SAAS,uCAAuC;IACzE,2BAA2B,SAAS,wCAAwC;CAC7E,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,2FAA2F;IAC3F,4FAA4F;IAC5F,4FAA4F;IAC5F,KAAK,EAAE,UAAU;IACjB,cAAc,EAAE,YAAY;IAC5B,WAAW,EAAE,GAAG,SAAS,MAAM;IAC/B,2FAA2F;IAC3F,6FAA6F;IAC7F,+FAA+F;IAC/F,4FAA4F;IAC5F,6FAA6F;IAC7F,6FAA6F;IAC7F,eAAe,EAAE,GAAG,kBAAkB,UAAU;IAChD,qBAAqB,EAAE,GAAG,kBAAkB,gBAAgB;IAC5D,QAAQ,EAAE,GAAG,SAAS,GAAG;IACzB,2BAA2B,EAAE,MAAM,CAAC,2BAA2B,CAAC;IAChE,2BAA2B,EAAE,MAAM,CAAC,2BAA2B,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC;IAC1B,kCAAkC,EAAE,MAAM,CAAC,kCAAkC,CAAC;IAC9E,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC;CACzB,CAAC;AAEF,sFAAsF;AACtF,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,UAAU,CAAC;QAChB,IAAI;QACJ,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE;YACP,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,cAAc;YACrB,GAAG,EAAE,MAAM;SACZ;QACD,YAAY,EAAE,YAAY;QAC1B,eAAe,EAAE,gBAAgB;QACjC,2FAA2F;QAC3F,8FAA8F;QAC9F,6FAA6F;QAC7F,qFAAqF;QACrF,EAAE;QACF,8EAA8E;QAC9E,2FAA2F;QAC3F,yFAAyF;QACzF,IAAI,EAAE,EAAE,wBAAwB,EAAE,CAAC,SAAS,CAAC,EAAE;KAChD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,UAAU,CAAC;QAChB,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC;YACtB,OAAO,EAAE,GAAG;YACZ,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,aAAa,EAAE;YACtB,gBAAgB,EAAE,SAAS;YAC3B,MAAM,EAAE,IAAI;YACZ,wBAAwB,EAAE,IAAI;YAC9B,0BAA0B,EAAE,KAAK;YACjC,oBAAoB,EAAE,IAAI;YAC1B,eAAe,EAAE,IAAI;YACrB,eAAe,EAAE,OAAO;YACxB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,4BAA4B,EAAE,IAAI;YAClC,gCAAgC,EAAE,IAAI;YACtC,aAAa,EAAE,IAAI;YACnB,iBAAiB,EAAE,IAAI;YACvB,SAAS,EAAE,IAAI;YACf,wFAAwF;YACxF,yFAAyF;YACzF,wFAAwF;YACxF,0FAA0F;YAC1F,sFAAsF;YACtF,yFAAyF;YACzF,gFAAgF;YAChF,KAAK,EAAE,CAAC,eAAe,CAAC;YACxB,SAAS,EAAE,CAAC,cAAc,EAAE,qBAAqB,EAAE,wCAAwC,CAAC;SAC7F;QACD,OAAO,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC;QACpC,uFAAuF;QACvF,uFAAuF;QACvF,oFAAoF;QACpF,wFAAwF;QACxF,wDAAwD;QACxD,OAAO,EAAE;YACP,cAAc;YACd,MAAM;YACN,qBAAqB;YACrB,0BAA0B;YAC1B,kBAAkB;YAClB,uBAAuB;YACvB,oBAAoB;YACpB,2FAA2F;YAC3F,6FAA6F;YAC7F,2FAA2F;YAC3F,2FAA2F;YAC3F,gEAAgE;YAChE,wBAAwB;SACzB;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,gBAAgB,GACpB,iGAAiG;IACjG,+FAA+F;IAC/F,+FAA+F;IAC/F,gGAAgG;IAChG,gGAAgG;IAChG,gGAAgG;IAChG,gGAAgG;IAChG,uEAAuE,CAAC;AAE1E,MAAM,UAAU,eAAe;IAC7B,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,YAAY,EAAE,CAAC;IACpD,6FAA6F;IAC7F,yFAAyF;IACzF,MAAM,gBAAgB,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,iBAAiB,CAAC;IACrE,0FAA0F;IAC1F,0FAA0F;IAC1F,wFAAwF;IACxF,2FAA2F;IAC3F,mDAAmD;IACnD,OAAO;;;;;;gBAMO,eAAe,uCAAuC,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAqBpF,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;;;iCAG5B,gBAAgB;;;CAGhD,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,SAAS,kBAAkB;IACzB,OAAO,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,UAAU,GAAG,OAAO,MAAM,GAAG,CAAC;SACrD,IAAI,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;EAWP,kBAAkB,EAAE;;;;;;;CAOrB,CAAC;AACF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BP,kBAAkB,EAAE;;;;;;;;;;;;;;kBAcJ,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC;;;;;;CAMxD,CAAC;AACF,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AA6BD,MAAM,UAAU,kBAAkB,CAAC,QAAyB;IAC1D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,sBAAsB,CAAC,WAAwC;IACtE,MAAM,OAAO,GAAG,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,4BAA4B,CAAC;IAEjG,MAAM,IAAI,GACR,WAAW,KAAK,SAAS;QACvB,CAAC,CAAC;;mEAE2D;QAC7D,CAAC,CAAC,4BAA4B,WAAW;;;;EAI7C,OAAO;OACF,CAAC;IAEN,OAAO;;EAEP,IAAI;;;;;;;;gGAQ0F,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,WAAwC;IACrE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAucP,sBAAsB,CAAC,WAAW,CAAC;CACpC,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoLR,CAAC;AACF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2JR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyHR,CAAC;AACF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8DR,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CR,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3B,OAAO;;EAEP,KAAK;QACH,CAAC,CAAC,8GAA8G;QAChH,CAAC,CAAC,0KAA0K;;;;EAI9K,KAAK,IAAI,iEAAiE;;;;;;;;;;;;;;CAc3E,CAAC;AACF,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;CAwBR,CAAC;AACF,CAAC"}

package/dist/verify/artifacts.d.ts

@@ -0,0 +1,19 @@
+import type { VerifyPlatform } from './platform.js';
+export interface VerifyArtifactPaths {
+    /** The publish thumbnail candidate on desktop. Not written by a `--fast` run. */
+    screenshotPath: string;
+    consolePath: string;
+    /** Where the automatic software-GL re-run's console goes, so the first run's evidence survives. */
+    retryConsolePath: string;
+}
+export declare function verifyArtifactPaths(artifactDir: string, platform: VerifyPlatform): VerifyArtifactPaths;
+export declare const VERIFY_PLATFORMS: VerifyPlatform[];
+/**
+ * Every screenshot any platform could write.
+ *
+ * A run deletes the ones it is not going to produce, extending the rule `--fast` already follows:
+ * a stale screenshot beside a fresh `result.json` is worse than none, because publish would ship
+ * a picture of some earlier state of the game — and after this change "earlier state" includes
+ * "the other platform, from an older run".
+ */
+export declare function allVerifyScreenshotPaths(artifactDir: string): string[];

package/dist/verify/artifacts.js

@@ -0,0 +1,34 @@
+/**
+ * What a verify run writes, per platform.
+ *
+ * One place, because a `both` run writes two of everything and the desktop names are a contract
+ * with two other commands: `bitmagic publish` reads `screenshot.png` as its thumbnail fallback
+ * and `bitmagic judge` grades it. Desktop therefore keeps exactly the names it has always had,
+ * and mobile infixes `.mobile` before the extension.
+ *
+ * A per-platform CONSOLE log is not cosmetic. Without it a `both` run would overwrite the desktop
+ * console — by far the most useful artifact when something breaks — with the mobile one, and the
+ * run would look like it only ever booted a phone.
+ */
+import * as path from 'path';
+export function verifyArtifactPaths(artifactDir, platform) {
+    const suffix = platform === 'mobile' ? '.mobile' : '';
+    return {
+        screenshotPath: path.join(artifactDir, `screenshot${suffix}.png`),
+        consolePath: path.join(artifactDir, `console${suffix}.log`),
+        retryConsolePath: path.join(artifactDir, `console.retry${suffix}.log`),
+    };
+}
+export const VERIFY_PLATFORMS = ['desktop', 'mobile'];
+/**
+ * Every screenshot any platform could write.
+ *
+ * A run deletes the ones it is not going to produce, extending the rule `--fast` already follows:
+ * a stale screenshot beside a fresh `result.json` is worse than none, because publish would ship
+ * a picture of some earlier state of the game — and after this change "earlier state" includes
+ * "the other platform, from an older run".
+ */
+export function allVerifyScreenshotPaths(artifactDir) {
+    return VERIFY_PLATFORMS.map((platform) => verifyArtifactPaths(artifactDir, platform).screenshotPath);
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/verify/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/verify/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAW7B,MAAM,UAAU,mBAAmB,CACjC,WAAmB,EACnB,QAAwB;IAExB,MAAM,MAAM,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,MAAM,MAAM,CAAC;QACjE,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,MAAM,MAAM,CAAC;QAC3D,gBAAgB,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,MAAM,MAAM,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAC;AACvG,CAAC"}

package/dist/verify/browser.d.ts

@@ -1,5 +1,6 @@
 import { type BrowserLaunchPlan, type RendererChoice } from '../browser-gl.js';
 import { type VerifyObservations } from './classify.js';
+import type { VerifyDeviceOptions } from './device.js';
 export interface StartInteractionOptions {
     /** Selector for the engine Play button. Its label is localizable and per-game overridable, so
      *  never match by text. */
@@ -56,6 +57,15 @@ export interface HeadlessCheckOptions {
      * `browserGlArgs(process.env)`. `--mute-audio` is always added here, not by callers.
      */
     launch?: BrowserLaunchPlan;
+    /**
+     * Emulate a phone for this check — viewport, screen, deviceScaleFactor, `isMobile` and
+     * `hasTouch` from `verify/device.ts`. Absent means the desktop 1280x720 context, byte-identical
+     * to what every run did before this existed, which is what `publish`'s smoke check keeps using.
+     *
+     * Pair it with a `?platform=mobile` URL: this side makes the BROWSER a phone, that side makes
+     * the ENGINE take its mobile branch, and only both together verify what a player gets.
+     */
+    device?: VerifyDeviceOptions;
     /**
      * Capture the screenshot and measure its pixels (default true). `bitmagic verify --fast`
      * turns this off for the inner loop: `screenshotBytes`/`canvasFrame` come back null and