@bitmagic/cli 0.1.83-dev.0 → 0.1.83-dev.2

package/dist/steam/specs.js

@@ -0,0 +1,103 @@
+/**
+ * Every image Steamworks asks for, at the size it asks for it, with the rule Valve reviews it
+ * against. One table, read by the renderer (what to draw), the check (what must exist) and the
+ * skill (what goes where) — a size that lived in three places would drift in one of them.
+ *
+ * Sizes and rules from partner.steamgames.com/doc/store/assets/standard and
+ * /doc/store/assets/libraryassets, as of 2026-10.
+ */
+export const STORE_IMAGE_SPECS = [
+    {
+        id: 'header_capsule', file: 'store/header_capsule_920x430.png', width: 920, height: 430, format: 'png',
+        art: 'wide', logo: 'required', required: true,
+        where: 'Store Admin → Graphical Assets → Header Capsule',
+        rule: 'Top of the store page and most lists. Key art and a legible logo; no text but the title.',
+    },
+    {
+        id: 'small_capsule', file: 'store/small_capsule_462x174.png', width: 462, height: 174, format: 'png',
+        art: 'wide', logo: 'required', required: true,
+        where: 'Store Admin → Graphical Assets → Small Capsule',
+        rule: 'Search results and lists, shown as small as 120x45: the logo should nearly fill it.',
+    },
+    {
+        id: 'main_capsule', file: 'store/main_capsule_1232x706.png', width: 1232, height: 706, format: 'png',
+        art: 'wide', logo: 'required', required: true,
+        where: 'Store Admin → Graphical Assets → Main Capsule',
+        rule: 'The front-page carousel. Key art first, logo legible; no text but the title.',
+    },
+    {
+        id: 'vertical_capsule', file: 'store/vertical_capsule_748x896.png', width: 748, height: 896, format: 'png',
+        art: 'tall', logo: 'required', required: true,
+        where: 'Store Admin → Graphical Assets → Vertical Capsule',
+        rule: 'Seasonal sale pages. Key art first, logo legible; no text but the title.',
+    },
+    {
+        id: 'page_background', file: 'store/page_background_1438x810.png', width: 1438, height: 810, format: 'png',
+        art: 'wide', logo: 'forbidden', required: false,
+        where: 'Store Admin → Graphical Assets → Page Background',
+        rule: 'Ambient, low-contrast art behind the store page; no logo, no text.',
+    },
+    {
+        id: 'library_capsule', file: 'library/library_capsule_600x900.png', width: 600, height: 900, format: 'png',
+        art: 'tall', logo: 'required', required: true,
+        where: 'Store Admin → Graphical Assets → Library Capsule',
+        rule: 'The library grid. Key art and a legible logo; no text but the title.',
+    },
+    {
+        id: 'library_header', file: 'library/library_header_920x430.png', width: 920, height: 430, format: 'png',
+        art: 'wide', logo: 'required', required: true,
+        where: 'Store Admin → Graphical Assets → Library Header',
+        rule: 'Library lists and recent games. Branding first; no text but the title.',
+    },
+    {
+        id: 'library_hero', file: 'library/library_hero_3840x1240.png', width: 3840, height: 1240, format: 'png',
+        art: 'hero', logo: 'forbidden', required: true,
+        where: 'Store Admin → Graphical Assets → Library Hero',
+        rule: 'Top of the game\'s library page. NO text and no logo — Steam draws the library logo over it. '
+            + 'Keep what matters inside the central 860x380 safe area.',
+    },
+    {
+        id: 'library_logo', file: 'library/library_logo.png', width: 1280, height: 720, format: 'png',
+        art: null, logo: 'only', required: true,
+        where: 'Store Admin → Graphical Assets → Library Logo',
+        rule: 'The logo alone on a transparent background, 1280 px wide and/or 720 px tall. No other words.',
+    },
+    {
+        id: 'app_icon', file: 'icons/app_icon_184x184.jpg', width: 184, height: 184, format: 'jpg',
+        art: 'icon', logo: 'forbidden', required: true,
+        where: 'Graphical Assets → App Icon',
+        rule: 'The square icon in the library list, chat, notifications and the Deck. Readable at 32 px.',
+    },
+    {
+        id: 'shortcut_icon', file: 'icons/shortcut_icon_256x256.png', width: 256, height: 256, format: 'png',
+        art: 'icon', logo: 'forbidden', required: true,
+        where: 'Graphical Assets → Shortcut Icon (the .ico beside it carries the same picture at every size)',
+        rule: 'The desktop shortcut Steam creates. 256x256 or 512x512, ICO or PNG.',
+    },
+];
+/** The multi-size Windows icon and the macOS icon, written next to the shortcut icon. */
+export const SHORTCUT_ICO_FILE = 'icons/shortcut_icon.ico';
+export const MAC_ICNS_FILE = 'icons/mac_icon.icns';
+/** The library logo is "1280 wide and/or 720 tall": it keeps its own aspect inside that box. */
+export const LIBRARY_LOGO_BOX = { width: 1280, height: 720 };
+export const SCREENSHOT_WIDTH = 1920;
+export const SCREENSHOT_HEIGHT = 1080;
+/** Fewer than five and the store page cannot be submitted. */
+export const MIN_SCREENSHOTS = 5;
+/** Enough for a varied gallery without padding it with near-duplicates. */
+export const RECOMMENDED_SCREENSHOTS = 8;
+/** The icon sizes the Windows .ico and the macOS .icns carry. */
+export const ICO_SIZES = [16, 24, 32, 48, 64, 128, 256];
+export const ICNS_SIZES = [16, 32, 64, 128, 256, 512, 1024];
+/** Steam's trailer rules (partner.steamgames.com/doc/store/trailer). */
+export const TRAILER_RULES = {
+    maxWidth: 1920,
+    maxHeight: 1080,
+    frameRates: [30, 29.97, 60, 59.94],
+    minBitrateKbps: 5000,
+    containers: ['mp4', 'mov', 'wmv'],
+};
+export function specById(id) {
+    return STORE_IMAGE_SPECS.find((spec) => spec.id === id);
+}
+//# sourceMappingURL=specs.js.map

package/dist/steam/specs.js.map

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

package/dist/steam/steampipe.d.ts

@@ -0,0 +1,46 @@
+export declare function steamcmdDir(baseDir?: string): string;
+export declare function steamcmdExecutable(dir?: string): string;
+/** steamcmd on this machine, downloaded from Valve on first use. */
+export declare function ensureSteamcmd(log: (message: string) => void): Promise<string>;
+/**
+ * steamcmd for macOS is an Intel binary. On Apple Silicon it needs Rosetta 2, which the creator
+ * installs once (it asks for their agreement to Apple's licence).
+ */
+export declare function rosettaMissing(): boolean;
+export interface DepotContent {
+    depotId: number;
+    /** Absolute content root: the folder whose contents become the depot. */
+    contentRoot: string;
+}
+/** One depot's build script. Pure. */
+export declare function depotBuildVdf(depot: DepotContent): string;
+/**
+ * The app build script. `setLive` only for a beta branch: Valve does not let a build script set
+ * the default branch live — that is a click in Steamworks, and the creator's to approve. Pure.
+ */
+export declare function appBuildVdf(options: {
+    appId: number;
+    description: string;
+    buildOutput: string;
+    depotScripts: {
+        depotId: number;
+        file: string;
+    }[];
+    setLive?: string;
+    preview?: boolean;
+}): string;
+export interface SteamcmdRun {
+    ok: boolean;
+    output: string;
+    needsLogin: boolean;
+    buildId?: string;
+}
+/** Pull the BuildID out of steamcmd's report. Pure. */
+export declare function parseBuildId(output: string): string | undefined;
+/**
+ * Run steamcmd with no terminal attached. The moment it asks for a password or a Steam Guard
+ * code, it is stopped: that means the cached login is gone, and only the creator can renew it.
+ */
+export declare function runSteamcmd(executable: string, args: string[], log: (line: string) => void, timeoutMs?: number): Promise<SteamcmdRun>;
+/** The interactive login: steamcmd owns the terminal so the creator types into it directly. */
+export declare function runSteamcmdInteractive(executable: string, args: string[]): number;

package/dist/steam/steampipe.js

@@ -0,0 +1,170 @@
+/**
+ * SteamPipe: Valve's command-line uploader (steamcmd) and the build scripts it runs.
+ *
+ * steamcmd is downloaded from Valve's CDN into `~/.bitmagic/tools/steamcmd/` the first time it is
+ * needed. Logging it in is the CREATOR's step, once per machine, in their own terminal
+ * (`bitmagic steam login`): it asks for the Steam password and a Steam Guard code, and an agent
+ * must never be the one typing those. After that, steamcmd keeps its own cached login, and
+ * `bitmagic steam upload` runs it non-interactively — refusing, with that remedy, the moment it
+ * asks for a password again.
+ *
+ * The depots are uploaded straight from `.bitmagic/steam/build/` — never through a zip — so the
+ * macOS app's symlinks and executable bits reach the depot exactly as signed.
+ */
+import { spawn, spawnSync } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { unzipSync } from 'fflate';
+import * as tar from 'tar';
+import { CliError } from '../errors.js';
+const STEAMCMD_DOWNLOADS = {
+    darwin: 'https://steamcdn-a.akamaihd.net/client/installer/steamcmd_osx.tar.gz',
+    linux: 'https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz',
+    win32: 'https://steamcdn-a.akamaihd.net/client/installer/steamcmd.zip',
+};
+export function steamcmdDir(baseDir = path.join(os.homedir(), '.bitmagic')) {
+    return path.join(baseDir, 'tools', 'steamcmd');
+}
+export function steamcmdExecutable(dir = steamcmdDir()) {
+    return process.platform === 'win32' ? path.join(dir, 'steamcmd.exe') : path.join(dir, 'steamcmd.sh');
+}
+/** steamcmd on this machine, downloaded from Valve on first use. */
+export async function ensureSteamcmd(log) {
+    const dir = steamcmdDir();
+    const executable = steamcmdExecutable(dir);
+    if (fs.existsSync(executable))
+        return executable;
+    const url = STEAMCMD_DOWNLOADS[process.platform];
+    if (url === undefined)
+        throw new CliError(`steamcmd has no build for ${process.platform}.`, 3);
+    log(`Downloading steamcmd from Valve (${url})…`);
+    const response = await fetch(url, { signal: AbortSignal.timeout(5 * 60_000) });
+    if (!response.ok)
+        throw new CliError(`Could not download steamcmd (HTTP ${response.status}).`);
+    const bytes = Buffer.from(await response.arrayBuffer());
+    fs.mkdirSync(dir, { recursive: true });
+    if (url.endsWith('.zip')) {
+        for (const [name, data] of Object.entries(unzipSync(new Uint8Array(bytes)))) {
+            if (name.endsWith('/'))
+                continue;
+            const target = path.join(dir, ...name.split('/'));
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            fs.writeFileSync(target, data);
+        }
+    }
+    else {
+        const archive = path.join(dir, 'steamcmd.tar.gz');
+        fs.writeFileSync(archive, bytes);
+        await tar.x({ file: archive, cwd: dir });
+        fs.rmSync(archive, { force: true });
+    }
+    if (!fs.existsSync(executable))
+        throw new CliError(`The steamcmd download did not contain ${path.basename(executable)}.`);
+    if (process.platform !== 'win32')
+        fs.chmodSync(executable, 0o755);
+    return executable;
+}
+/**
+ * steamcmd for macOS is an Intel binary. On Apple Silicon it needs Rosetta 2, which the creator
+ * installs once (it asks for their agreement to Apple's licence).
+ */
+export function rosettaMissing() {
+    if (process.platform !== 'darwin' || os.arch() !== 'arm64')
+        return false;
+    return spawnSync('/usr/bin/arch', ['-x86_64', '/usr/bin/true']).status !== 0;
+}
+function vdfString(value) {
+    return `"${value.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+/** One depot's build script. Pure. */
+export function depotBuildVdf(depot) {
+    return `"DepotBuild"
+{
+\t"DepotID" ${vdfString(String(depot.depotId))}
+\t"ContentRoot" ${vdfString(depot.contentRoot)}
+\t"FileMapping"
+\t{
+\t\t"LocalPath" "*"
+\t\t"DepotPath" "."
+\t\t"recursive" "1"
+\t}
+\t// Finder and Explorer litter; never part of a game.
+\t"FileExclusion" ".DS_Store"
+\t"FileExclusion" "Thumbs.db"
+}
+`;
+}
+/**
+ * The app build script. `setLive` only for a beta branch: Valve does not let a build script set
+ * the default branch live — that is a click in Steamworks, and the creator's to approve. Pure.
+ */
+export function appBuildVdf(options) {
+    if (options.setLive !== undefined && (options.setLive === '' || options.setLive === 'default' || options.setLive === 'public')) {
+        throw new CliError('Steam does not allow a build script to set the default branch live; do that in Steamworks (SteamPipe → Builds).');
+    }
+    const depots = options.depotScripts.map((depot) => `\t\t${vdfString(String(depot.depotId))} ${vdfString(depot.file)}`).join('\n');
+    return `"AppBuild"
+{
+\t"AppID" ${vdfString(String(options.appId))}
+\t"Desc" ${vdfString(options.description)}
+\t"BuildOutput" ${vdfString(options.buildOutput)}
+${options.setLive !== undefined ? `\t"SetLive" ${vdfString(options.setLive)}\n` : ''}${options.preview === true ? '\t"Preview" "1"\n' : ''}\t"Depots"
+\t{
+${depots}
+\t}
+}
+`;
+}
+// ============================================================================
+// Running steamcmd
+// ============================================================================
+/** Lines that mean steamcmd wants a password or a code — the creator's to give, not ours. */
+const NEEDS_LOGIN = /password:|steam guard|two-factor|twofactor|cached credentials not found|invalid password|login failure|account logon denied|ENTER.*CODE/i;
+/** Pull the BuildID out of steamcmd's report. Pure. */
+export function parseBuildId(output) {
+    return /BuildID\s+(\d+)/i.exec(output)?.[1] ?? /build\s+id[^0-9]*(\d+)/i.exec(output)?.[1];
+}
+/**
+ * Run steamcmd with no terminal attached. The moment it asks for a password or a Steam Guard
+ * code, it is stopped: that means the cached login is gone, and only the creator can renew it.
+ */
+export function runSteamcmd(executable, args, log, timeoutMs = 60 * 60_000) {
+    return new Promise((resolve) => {
+        const child = spawn(executable, args, { stdio: ['ignore', 'pipe', 'pipe'], cwd: path.dirname(executable) });
+        let output = '';
+        let needsLogin = false;
+        const onData = (chunk) => {
+            const text = chunk.toString('utf-8');
+            output = (output + text).slice(-200_000);
+            for (const line of text.split(/\r?\n/)) {
+                const trimmed = line.trim();
+                if (trimmed !== '')
+                    log(`  steamcmd: ${trimmed}`);
+            }
+            if (NEEDS_LOGIN.test(text)) {
+                needsLogin = true;
+                child.kill('SIGTERM');
+            }
+        };
+        child.stdout.on('data', onData);
+        child.stderr.on('data', onData);
+        const timer = setTimeout(() => child.kill('SIGTERM'), timeoutMs);
+        child.on('close', (code) => {
+            clearTimeout(timer);
+            const buildId = parseBuildId(output);
+            resolve({
+                ok: code === 0 && !needsLogin,
+                output,
+                needsLogin,
+                ...(buildId !== undefined ? { buildId } : {}),
+            });
+        });
+    });
+}
+/** The interactive login: steamcmd owns the terminal so the creator types into it directly. */
+export function runSteamcmdInteractive(executable, args) {
+    const result = spawnSync(executable, args, { stdio: 'inherit', cwd: path.dirname(executable) });
+    return result.status ?? 1;
+}
+//# sourceMappingURL=steampipe.js.map

package/dist/steam/steampipe.js.map

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

package/dist/steam/store-copy.d.ts

@@ -0,0 +1,89 @@
+export declare const SHORT_DESCRIPTION_MAX = 300;
+export declare const MAX_TAGS = 20;
+/** Below this the "About" reads as a stub to a reviewer. Valve asks for "detailed and coherent". */
+export declare const ABOUT_MIN_CHARS = 400;
+export interface Requirements {
+    os: string;
+    processor: string;
+    memory: string;
+    graphics: string;
+    storage: string;
+    additional?: string;
+}
+export interface LanguageSupport {
+    name: string;
+    interface: boolean;
+    fullAudio: boolean;
+    subtitles: boolean;
+}
+export interface StoreCopy {
+    name: string;
+    shortDescription: string;
+    /** "About This Game", in Steam's BBCode. */
+    about: string;
+    /** Steam user tags, most important first. */
+    tags: string[];
+    /** Steamworks' genre checkboxes (Action, Casual, Indie, ...). */
+    genres: string[];
+    developer: string;
+    publisher: string;
+    /** Public player-support destination, entered separately from the store description. */
+    supportUrl?: string;
+    supportEmail?: string;
+    languages: LanguageSupport[];
+    controllerSupport: 'full' | 'partial' | 'none';
+    /** USD; 0 is free. The creator's decision — the agent only records it. */
+    priceUsd?: number;
+    /** `YYYY-MM-DD`, or empty while the date is "Coming soon". */
+    releaseDate?: string;
+    /** Steam's AI Generated Content Disclosure, in the developer's words. */
+    ai: {
+        /** Content made with AI tools during development: art, code, sound, text. */
+        preGenerated: string;
+        /** Content AI generates while the game runs, and the guardrails on it; empty when none. */
+        liveGenerated: string;
+    };
+    /** Draft answers to the mature-content survey, for the creator to confirm. */
+    contentNotes: string;
+    systemRequirements: {
+        windows: {
+            minimum: Requirements;
+            recommended?: Requirements;
+        };
+        macos: {
+            minimum: Requirements;
+            recommended?: Requirements;
+        };
+    };
+    /** The copyright line under the store page, e.g. "© 2026 Studio Name". */
+    legalLine?: string;
+}
+export interface CopyFinding {
+    level: 'error' | 'warning';
+    field: string;
+    message: string;
+}
+/** Unknown or unbalanced BBCode, as findings. Pure. */
+export declare function checkBbcode(text: string): string[];
+/** Links a reviewer will reject: anything off Steam. Pure. */
+export declare function externalLinks(text: string): string[];
+/** Words that sell the game somewhere else, or price it, inside Steam copy. Pure. */
+export declare function offStoreMentions(text: string): string[];
+/**
+ * Every rule `steam check` holds the copy to. `knownTags` is Steam's current tag list, or null
+ * when it could not be fetched — then tag names go unchecked rather than failing offline.
+ */
+export declare function checkStoreCopy(copy: StoreCopy, knownTags: ReadonlySet<string> | null): CopyFinding[];
+/**
+ * The defaults the scaffold writes: the game's own name and description, desktop-shell system
+ * requirements, English, and empty fields where only the agent and creator can know the answer.
+ */
+export declare function scaffoldStoreCopy(options: {
+    name: string;
+    description: string;
+    installMb: number;
+    webgpu: boolean;
+}): StoreCopy;
+export declare function readStoreCopy(file: string): StoreCopy | null;
+export declare function writeStoreCopy(file: string, copy: StoreCopy): void;
+export declare function requireStoreCopy(file: string): StoreCopy;

package/dist/steam/store-copy.js

@@ -0,0 +1,221 @@
+/**
+ * `.bitmagic/steam/store.json` — the store page's words: the name, the short description, the
+ * "About This Game" text, tags, languages, the AI-content disclosure, system requirements.
+ *
+ * The agent writes this file (it is the one who knows the game), the creator approves it, and
+ * `bitmagic steam check` holds it to Valve's rules before anyone pastes it into Steamworks. The
+ * same split the ads lane uses for ads.json: the CLI scaffolds and validates, it does not write
+ * marketing copy.
+ */
+import { readJsonFile, writeJsonAtomic } from '../atomic-json.js';
+import { CliError } from '../errors.js';
+export const SHORT_DESCRIPTION_MAX = 300;
+export const MAX_TAGS = 20;
+/** Below this the "About" reads as a stub to a reviewer. Valve asks for "detailed and coherent". */
+export const ABOUT_MIN_CHARS = 400;
+/**
+ * Steam's BBCode for store descriptions. `*` and `hr` stand alone; everything else must close.
+ */
+const PAIRED_TAGS = new Set([
+    'h1', 'h2', 'h3', 'b', 'u', 'i', 'strike', 'spoiler', 'noparse', 'url', 'list', 'olist',
+    'img', 'table', 'tr', 'th', 'td', 'quote', 'code', 'p',
+]);
+const SINGLE_TAGS = new Set(['*', 'hr']);
+/** Unknown or unbalanced BBCode, as findings. Pure. */
+export function checkBbcode(text) {
+    const problems = [];
+    const stack = [];
+    for (const match of text.matchAll(/\[(\/?)([a-z0-9*]+)(?:=[^\]]*)?\]/gi)) {
+        const closing = match[1] === '/';
+        const tag = match[2].toLowerCase();
+        if (SINGLE_TAGS.has(tag)) {
+            if (closing && tag !== '*')
+                problems.push(`[/${tag}] has no opening form.`);
+            continue;
+        }
+        if (!PAIRED_TAGS.has(tag)) {
+            problems.push(`[${tag}] is not Steam BBCode.`);
+            continue;
+        }
+        if (!closing) {
+            stack.push(tag);
+        }
+        else if (stack[stack.length - 1] === tag) {
+            stack.pop();
+        }
+        else {
+            problems.push(`[/${tag}] closes ${stack.length > 0 ? `[${stack[stack.length - 1]}]` : 'nothing'}.`);
+        }
+    }
+    for (const tag of stack)
+        problems.push(`[${tag}] is never closed.`);
+    return problems;
+}
+/** Links a reviewer will reject: anything off Steam. Pure. */
+export function externalLinks(text) {
+    const links = [...text.matchAll(/https?:\/\/[^\s\]"'<>]+/gi)].map((match) => match[0]);
+    return links.filter((link) => !/^https?:\/\/([a-z0-9-]+\.)?(steampowered\.com|steamcommunity\.com)\//i.test(link));
+}
+/** Words that sell the game somewhere else, or price it, inside Steam copy. Pure. */
+export function offStoreMentions(text) {
+    const hits = [];
+    for (const pattern of [/bitmagic\.ai/i, /play (it )?(for )?free (at|on)/i, /\bpoki\b/i, /app store/i, /google play/i, /itch\.io/i]) {
+        const match = pattern.exec(text);
+        if (match)
+            hits.push(match[0]);
+    }
+    return hits;
+}
+const REQUIREMENT_FIELDS = ['os', 'processor', 'memory', 'graphics', 'storage'];
+function str(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+/**
+ * Every rule `steam check` holds the copy to. `knownTags` is Steam's current tag list, or null
+ * when it could not be fetched — then tag names go unchecked rather than failing offline.
+ */
+export function checkStoreCopy(copy, knownTags) {
+    const findings = [];
+    const error = (field, message) => { findings.push({ level: 'error', field, message }); };
+    const warn = (field, message) => { findings.push({ level: 'warning', field, message }); };
+    if (str(copy.name) === '')
+        error('name', 'The game needs a name.');
+    const short = str(copy.shortDescription);
+    if (short === '')
+        error('shortDescription', 'Empty. One or two sentences on what the player does and why it is fun.');
+    else if ([...short].length > SHORT_DESCRIPTION_MAX) {
+        error('shortDescription', `${[...short].length} characters; Steam allows ${SHORT_DESCRIPTION_MAX}.`);
+    }
+    if (/\[[a-z/*]/i.test(short))
+        error('shortDescription', 'BBCode is not rendered in the short description — plain text only.');
+    const about = str(copy.about);
+    if (about === '')
+        error('about', 'Empty. "About This Game" is the body of the store page.');
+    else if (about.length < ABOUT_MIN_CHARS) {
+        warn('about', `${about.length} characters reads as a stub; describe the modes, the content and what makes it different.`);
+    }
+    for (const problem of checkBbcode(about))
+        error('about', problem);
+    for (const [field, text] of [['shortDescription', short], ['about', about]]) {
+        for (const link of externalLinks(text))
+            error(field, `Links off Steam are rejected in review: ${link}`);
+        for (const hit of offStoreMentions(text))
+            warn(field, `"${hit}" points players away from Steam; reviewers flag that.`);
+    }
+    if ((copy.priceUsd ?? 0) > 0 && /\bfree\b/i.test(`${short} ${about}`)) {
+        warn('about', 'The copy says "free" but the game has a price.');
+    }
+    const tags = Array.isArray(copy.tags) ? copy.tags.map(str).filter((tag) => tag !== '') : [];
+    if (tags.length === 0)
+        warn('tags', 'No tags. Steamworks asks for up to 20; the first few decide where the game is shown.');
+    if (tags.length > MAX_TAGS)
+        error('tags', `${tags.length} tags; Steam allows ${MAX_TAGS}.`);
+    if (knownTags !== null) {
+        for (const tag of tags) {
+            if (!knownTags.has(tag.toLowerCase()))
+                error('tags', `"${tag}" is not one of Steam's tags.`);
+        }
+    }
+    if (new Set(tags.map((t) => t.toLowerCase())).size !== tags.length)
+        error('tags', 'A tag is listed twice.');
+    if (str(copy.developer) === '')
+        error('developer', 'Name the developer as it should appear on the store page.');
+    if (str(copy.publisher) === '')
+        error('publisher', 'Name the publisher (often the developer again).');
+    const languages = Array.isArray(copy.languages) ? copy.languages : [];
+    if (languages.length === 0)
+        error('languages', 'List at least one language with interface support.');
+    for (const language of languages) {
+        if (str(language?.name) === '')
+            error('languages', 'A language entry has no name.');
+    }
+    if (str(copy.ai?.preGenerated) === '') {
+        error('ai.preGenerated', 'Steam requires disclosing content made with AI tools. A Bitmagic game always has some — the '
+            + 'engine generates code, models, textures and sound — so say what, in the creator\'s words.');
+    }
+    for (const platform of ['windows', 'macos']) {
+        const minimum = copy.systemRequirements?.[platform]?.minimum;
+        for (const field of REQUIREMENT_FIELDS) {
+            if (str(minimum?.[field]) === '')
+                error(`systemRequirements.${platform}.minimum.${field}`, 'Missing.');
+        }
+    }
+    if (copy.releaseDate !== undefined && copy.releaseDate !== '' && !/^\d{4}-\d{2}-\d{2}$/.test(copy.releaseDate)) {
+        error('releaseDate', 'Use YYYY-MM-DD, or leave it empty while the date is "Coming soon".');
+    }
+    if (copy.priceUsd !== undefined && (typeof copy.priceUsd !== 'number' || copy.priceUsd < 0)) {
+        error('priceUsd', 'A price in US dollars, 0 for free.');
+    }
+    return findings;
+}
+/**
+ * The defaults the scaffold writes: the game's own name and description, desktop-shell system
+ * requirements, English, and empty fields where only the agent and creator can know the answer.
+ */
+export function scaffoldStoreCopy(options) {
+    const storage = `${Math.max(500, Math.ceil(options.installMb / 100) * 100)} MB available space`;
+    return {
+        name: options.name,
+        shortDescription: options.description.slice(0, SHORT_DESCRIPTION_MAX),
+        about: '',
+        tags: [],
+        genres: [],
+        developer: '',
+        publisher: '',
+        languages: [{ name: 'English', interface: true, fullAudio: false, subtitles: false }],
+        controllerSupport: 'none',
+        ai: { preGenerated: '', liveGenerated: '' },
+        contentNotes: '',
+        systemRequirements: {
+            windows: {
+                minimum: {
+                    os: 'Windows 10 64-bit',
+                    processor: 'Dual-core 2.0 GHz',
+                    memory: '4 GB RAM',
+                    graphics: options.webgpu ? 'DirectX 12 capable GPU' : 'DirectX 11 capable GPU',
+                    storage,
+                },
+                recommended: {
+                    os: 'Windows 11 64-bit',
+                    processor: 'Quad-core 3.0 GHz',
+                    memory: '8 GB RAM',
+                    graphics: 'Dedicated GPU with DirectX 12 support',
+                    storage,
+                },
+            },
+            macos: {
+                minimum: {
+                    os: 'macOS 13 Ventura',
+                    processor: 'Apple Silicon or Intel Core i5',
+                    memory: '8 GB RAM',
+                    graphics: 'Metal capable GPU',
+                    storage,
+                },
+                recommended: {
+                    os: 'macOS 14 Sonoma',
+                    processor: 'Apple M1 or newer',
+                    memory: '16 GB RAM',
+                    graphics: 'Apple Silicon GPU',
+                    storage,
+                },
+            },
+        },
+    };
+}
+export function readStoreCopy(file) {
+    const parsed = readJsonFile(file);
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return null;
+    return parsed;
+}
+export function writeStoreCopy(file, copy) {
+    writeJsonAtomic(file, copy);
+}
+export function requireStoreCopy(file) {
+    const copy = readStoreCopy(file);
+    if (copy === null) {
+        throw new CliError(`No store copy at ${file}. Run \`bitmagic steam init\` to scaffold it, then write the copy.`, 3);
+    }
+    return copy;
+}
+//# sourceMappingURL=store-copy.js.map