@bitmagic/cli 0.1.55-dev.0 → 0.1.55-dev.1

package/dist/commands/reference.js

@@ -0,0 +1,398 @@
+/**
+ * `bitmagic reference` — the concept image of the game's world the creator iterates on, and the
+ * accept that makes one picture the visual reference every later generation inherits.
+ *
+ * The loop this command exists for: the creator's agent proposes a picture (`make`), the CREATOR
+ * looks at it and decides — iterate (`make --from <id>`), or accept (`accept <id>`). From then on
+ * `generate skybox|background|block-type|image`, `bitmagic cover` and `bitmagic forge` all use the
+ * accepted image as their reference by default (see project/reference.ts), which is what keeps a
+ * game's sky, blocks, cover and forged levels looking like the same place.
+ *
+ * Candidates deliberately touch NOTHING: no world.json entry, no upload, no billing beyond the
+ * one image call. Only `accept` has consequences, and its first act is to re-host the picture to
+ * the game's own bucket — Asset Forger URLs are not contractually long-lived, and the accepted
+ * reference must outlive them (the same reason cover variants are re-hosted in the web lane).
+ *
+ * Built on the `generate image` lane's plumbing (`requestAssetWithJobRecord`) exactly as
+ * `bitmagic cover` is, so ownership, spark billing, the SSE keepalive and the server-side
+ * deadline all behave identically — but through the `reference` wire type, whose whole result is
+ * a URL on the terminal frame rather than a world.json patch.
+ */
+import { defineCommand } from 'citty';
+import { Buffer } from 'buffer';
+import { createHash } from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import { buildReferenceImagePrompt } from '@bitmagic/asset-core';
+import { CliError } from '../errors.js';
+import { loadProjectContext } from '../project/context.js';
+import { acceptedReferencePath, candidateImagePath, isSafeCandidateId, listCandidates, newCandidateId, readAcceptedReference, readCandidate, clearAcceptedReference, writeAcceptedReference, writeCandidate, } from '../project/reference.js';
+import { resolveEnvironmentForCommand, resolveAuth0ClientId } from '../config/environments.js';
+import { getAccessToken } from '../auth/session.js';
+import { uploadProjectFile } from '../http/signed-upload.js';
+import { requestAssetWithJobRecord } from './generate.js';
+import { creatorPromptField, ORIGINAL_PROMPT_FLAG } from '../telemetry/creator-prompt.js';
+import { renderInlineImage } from '../render/inline-image.js';
+import { createOutput } from '../output.js';
+import { commandRunDeps } from './run-deps.js';
+import { GAME_DESIGN_FILE } from './cover.js';
+import { REFERENCE_FILE_FLAG, REFERENCE_IMAGE_FLAG } from '../project/reference.js';
+import { sniffImageContentType, uploadReferenceImageFile } from '../project/reference-file.js';
+/** How much of the composed prompt the candidate record keeps — enough to recognise it in a list. */
+const RECORD_PROMPT_CHARS = 300;
+const JSON_FLAG = {
+    type: 'boolean',
+    description: 'Print the result as JSON on stdout; all progress goes to stderr.',
+};
+function defaultDeps(json) {
+    const output = createOutput(json);
+    return {
+        ...commandRunDeps(json),
+        result: output.result,
+        generate: (type, label, body, deps) => requestAssetWithJobRecord(type, label, body, deps, (outcome) => outcome),
+        renderImage: (bytes) => renderInlineImage(bytes),
+    };
+}
+// ============================================================================
+// Shared helpers
+// ============================================================================
+/**
+ * The prose the picture is drawn from: `--prompt` when given, otherwise GAME-DESIGN.md. The same
+ * source `bitmagic cover` reads, because the two pictures describe the same game — but the error
+ * paths name THIS command, since "write the design or pass --prompt" must say which command to
+ * re-run.
+ */
+export function resolveReferenceDesignText(options) {
+    const flag = options.promptFlag?.trim();
+    if (flag)
+        return flag;
+    const designPath = path.join(options.root, GAME_DESIGN_FILE);
+    let contents;
+    try {
+        contents = fs.readFileSync(designPath, 'utf-8');
+    }
+    catch {
+        throw new CliError(`No ${GAME_DESIGN_FILE} at ${designPath}, and no --prompt given. A reference image is drawn ` +
+            'from the game design, so there must be one or the other.\n' +
+            `Write ${GAME_DESIGN_FILE} describing the world and its look, then run \`bitmagic reference ` +
+            'make` again — or describe the world directly with `bitmagic reference make --prompt "..."`.');
+    }
+    if (!contents.trim()) {
+        throw new CliError(`${designPath} is empty. Describe the game's world and look there, or pass ` +
+            '`bitmagic reference make --prompt "..."`.');
+    }
+    return contents;
+}
+/** Best-effort download of a generated candidate, exactly `saveCoverImage`'s contract. */
+async function downloadImage(url, deps) {
+    try {
+        const response = await deps.fetch(url);
+        if (!response.ok) {
+            deps.log(`  could not download the image for a local copy (HTTP ${response.status}).`);
+            return null;
+        }
+        return Buffer.from(await response.arrayBuffer());
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        deps.log(`  could not download the image for a local copy: ${message}`);
+        return null;
+    }
+}
+function saveCandidateBytes(root, id, bytes) {
+    const file = candidateImagePath(root, id);
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, bytes);
+    return path.relative(root, file);
+}
+/** The three formats the platform round-trips; anything else uploads as webp and still displays. */
+function sniffContentType(bytes) {
+    return sniffImageContentType(bytes)?.contentType ?? 'image/webp';
+}
+export async function runReferenceMake(args, deps = defaultDeps(args.json === true)) {
+    const context = loadProjectContext(deps.startDir);
+    const root = context.root;
+    const designText = resolveReferenceDesignText({ promptFlag: args.prompt, root });
+    // What the image model iterates FROM. Any two of --from, --reference-image-url and
+    // --reference-image together would be two answers to the same question, so a pair is refused
+    // rather than ranked. The accepted project reference is deliberately NOT a default here —
+    // `make` explores; only these flags say "stay close to this picture".
+    const explicitUrl = args['reference-image-url'];
+    const filePath = args['reference-image']?.trim();
+    const fromId = args.from?.trim();
+    const named = [
+        fromId ? '--from' : null,
+        explicitUrl !== undefined ? '--reference-image-url' : null,
+        filePath ? '--reference-image' : null,
+    ].filter((flag) => flag !== null);
+    if (named.length > 1) {
+        throw new CliError(`${named.join(' and ')} both name an image to iterate from — pass one of them.`);
+    }
+    let from = null;
+    if (fromId) {
+        from = readCandidate(root, fromId);
+        if (!from) {
+            throw new CliError(`No reference candidate "${fromId}" in this project. \`bitmagic reference show\` lists the ones that exist.`);
+        }
+    }
+    let uploadedUrl;
+    if (filePath) {
+        uploadedUrl = (await uploadReferenceImageFile({ root, gameId: context.metadata.gameId, filePath, deps })).url;
+        deps.log(`Uploaded ${filePath} as the image to iterate from: ${uploadedUrl}`);
+    }
+    const referenceImageUrl = explicitUrl ?? uploadedUrl ?? from?.url;
+    const prompt = buildReferenceImagePrompt(designText);
+    const body = {
+        prompt,
+        ...(referenceImageUrl !== undefined ? { referenceImageUrl } : {}),
+        ...creatorPromptField(),
+    };
+    const outcome = await deps.generate('reference', 'reference image', body, deps);
+    const url = outcome.imageUrl;
+    if (url === undefined) {
+        throw new CliError('The reference image was generated, but the response carried no image URL, so there is ' +
+            'nothing to save or accept. Re-run `bitmagic reference make`; if it happens again, report it.');
+    }
+    const id = newCandidateId();
+    const bytes = await downloadImage(url, deps);
+    const imagePath = bytes ? saveCandidateBytes(root, id, bytes) : null;
+    writeCandidate(root, {
+        id,
+        url,
+        prompt: prompt.slice(0, RECORD_PROMPT_CHARS),
+        createdAt: new Date().toISOString(),
+        ...(from ? { from: from.id } : {}),
+        ...(explicitUrl !== undefined || uploadedUrl !== undefined
+            ? { referenceImageUrl: explicitUrl ?? uploadedUrl }
+            : {}),
+    });
+    deps.log(`Reference candidate ${id}: ${imagePath ?? '(no local copy)'}`);
+    deps.log(`  ${url}`);
+    // Plain lines first, always: they are what an agent reads, and the image is strictly extra.
+    if (bytes)
+        deps.renderImage(bytes);
+    deps.log(`Happy with it?  bitmagic reference accept ${id}`);
+    deps.log(`Not quite?      bitmagic reference make --from ${id} --prompt "what to change"`);
+    deps.result({ ok: true, id, url, imagePath, from: from?.id ?? null });
+}
+async function resolveAcceptSource(root, raw, deps) {
+    const value = raw.trim();
+    if (isSafeCandidateId(value)) {
+        const candidate = readCandidate(root, value);
+        if (candidate) {
+            let bytes = null;
+            try {
+                bytes = fs.readFileSync(candidateImagePath(root, value));
+            }
+            catch {
+                bytes = await downloadImage(candidate.url, deps);
+            }
+            return { id: value, sourceUrl: candidate.url, candidateId: value, bytes, mustHost: false };
+        }
+    }
+    if (/^https?:\/\//.test(value)) {
+        // The re-accept path: a fresh clone holding only the URL from GAME-DESIGN.md.
+        const id = `ref-url-${createHash('sha256').update(value).digest('hex').slice(0, 8)}`;
+        return { id, sourceUrl: value, bytes: await downloadImage(value, deps), mustHost: false };
+    }
+    // The creator's own picture — "use this image as the game's reference". Checked after the
+    // candidate ids so an id can never be shadowed by a file of the same name.
+    if (fs.existsSync(value)) {
+        let bytes;
+        try {
+            bytes = fs.readFileSync(value);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new CliError(`Could not read ${value}: ${message}`);
+        }
+        if (!sniffImageContentType(bytes)) {
+            throw new CliError(`${value} is not a PNG, JPEG or WebP image — those are the formats the generators accept as a reference.`);
+        }
+        const id = `ref-file-${createHash('sha256').update(bytes).digest('hex').slice(0, 8)}`;
+        return { id, sourceUrl: value, bytes, mustHost: true };
+    }
+    throw new CliError(`"${value}" is not a reference candidate in this project, a URL, or a file that exists. ` +
+        '`bitmagic reference show` lists the candidates; an image of your own is accepted by its ' +
+        'file path or https URL.');
+}
+export async function runReferenceAccept(args, deps = defaultDeps(args.json === true)) {
+    const context = loadProjectContext(deps.startDir);
+    const root = context.root;
+    const source = await resolveAcceptSource(root, args.candidate, deps);
+    // Re-host to the game's own bucket, so the accepted reference outlives the Asset Forger URL it
+    // came from. Failure records the source URL instead (`hosted: false`) rather than failing the
+    // accept: the creator's decision stands either way, and a re-accept later retries the upload.
+    let url = source.sourceUrl;
+    let hosted = false;
+    if (source.bytes) {
+        try {
+            const environment = resolveEnvironmentForCommand({ cwd: root, baseDir: deps.baseDir });
+            const clientId = resolveAuth0ClientId(environment);
+            const token = await getAccessToken(environment, clientId, { fetch: deps.fetch, sleep: deps.sleep, now: deps.now }, deps.baseDir);
+            const contentType = sniffContentType(source.bytes);
+            const upload = await uploadProjectFile(environment, token, {
+                gameId: context.metadata.gameId,
+                filename: `reference-${source.id}.${contentType === 'image/png' ? 'png' : contentType === 'image/jpeg' ? 'jpg' : 'webp'}`,
+                contentType,
+                bytes: source.bytes,
+            }, { fetch: deps.fetch });
+            url = upload.url;
+            hosted = true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (source.mustHost) {
+                // A local file has no URL to fall back to — recording its path would hand the
+                // generators an address none of them can fetch.
+                throw new CliError(`Could not upload ${args.candidate} to the game's storage (${message}), and a local file ` +
+                    'is only usable as a reference once hosted. Fix that and re-run the accept.');
+            }
+            deps.log(`  Could not re-host the image (${message}); recording its current URL instead, which may expire.`);
+            deps.log(`  Re-run \`bitmagic reference accept ${args.candidate}\` later to retry.`);
+        }
+    }
+    else {
+        deps.log('  No image bytes to re-host; recording the URL as-is — it may expire.');
+    }
+    // Keep a local copy under the candidate id, so `show` can draw it and a later accept can retry
+    // the upload without a download.
+    const imagePath = source.bytes ? saveCandidateBytes(root, source.id, source.bytes) : undefined;
+    const accepted = {
+        url,
+        hosted,
+        sourceUrl: source.sourceUrl,
+        acceptedAt: new Date().toISOString(),
+        ...(source.candidateId !== undefined ? { candidateId: source.candidateId } : {}),
+        ...(imagePath !== undefined ? { imagePath } : {}),
+    };
+    writeAcceptedReference(root, accepted);
+    deps.log(`Accepted ${source.candidateId ?? source.sourceUrl} as the project's reference image.`);
+    deps.log(`  ${url}`);
+    deps.log('This is now the default reference for `generate skybox|background|block-type|image`, ' +
+        '`bitmagic cover` and `bitmagic forge`. Pass --no-reference to skip it for one call; ' +
+        '`bitmagic reference clear` removes it.');
+    deps.log("Paste the URL above into GAME-DESIGN.md's world/look section — `.bitmagic/` is not committed, " +
+        'and that line is how a fresh clone re-accepts the same image (`bitmagic reference accept <url>`).');
+    deps.result({ ok: true, url, hosted, candidateId: source.candidateId ?? null, imagePath: imagePath ?? null });
+}
+export async function runReferenceShow(args, deps = defaultDeps(args.json === true)) {
+    const context = loadProjectContext(deps.startDir);
+    const root = context.root;
+    const accepted = readAcceptedReference(root);
+    const candidates = listCandidates(root);
+    if (accepted) {
+        deps.log(`Accepted reference${accepted.candidateId ? ` (${accepted.candidateId})` : ''}, ${accepted.acceptedAt}:`);
+        deps.log(`  ${accepted.url}`);
+        if (!accepted.hosted) {
+            deps.log('  Not re-hosted yet — this URL may expire. Re-run `bitmagic reference accept` to retry the upload.');
+        }
+        if (accepted.imagePath) {
+            deps.log(`  ${accepted.imagePath}`);
+            try {
+                deps.renderImage(fs.readFileSync(path.join(root, accepted.imagePath)));
+            }
+            catch {
+                // The local copy is a convenience; the URL above is the reference.
+            }
+        }
+    }
+    else {
+        deps.log('No accepted reference image. `bitmagic reference make` creates candidates to choose from.');
+    }
+    if (candidates.length > 0) {
+        deps.log(`Candidates (${candidates.length}):`);
+        for (const candidate of candidates) {
+            const marks = [
+                candidate.id === accepted?.candidateId ? 'accepted' : null,
+                candidate.from ? `from ${candidate.from}` : null,
+            ].filter((mark) => mark !== null);
+            deps.log(`  ${candidate.id}${marks.length > 0 ? ` (${marks.join(', ')})` : ''} — ${candidate.createdAt}`);
+        }
+    }
+    deps.result({ ok: true, accepted, candidates });
+}
+export async function runReferenceClear(args, deps = defaultDeps(args.json === true)) {
+    const context = loadProjectContext(deps.startDir);
+    const cleared = clearAcceptedReference(context.root);
+    deps.log(cleared
+        ? 'Cleared the accepted reference image. Candidates are kept — accept one again any time.'
+        : `No accepted reference image to clear (${path.relative(context.root, acceptedReferencePath(context.root))} does not exist).`);
+    deps.result({ ok: true, cleared });
+}
+// ============================================================================
+// The command
+// ============================================================================
+const makeCommand = defineCommand({
+    meta: {
+        name: 'make',
+        description: "Make a concept image of the game's world to look at, iterate on, and maybe accept.",
+    },
+    args: {
+        prompt: {
+            type: 'string',
+            description: `Describe the world for this call only, instead of reading ${GAME_DESIGN_FILE}.`,
+        },
+        from: {
+            type: 'string',
+            description: 'Iterate from an earlier candidate: its image steers this one (say what to change in --prompt).',
+        },
+        'reference-image-url': REFERENCE_IMAGE_FLAG,
+        'reference-image': REFERENCE_FILE_FLAG,
+        'original-prompt': ORIGINAL_PROMPT_FLAG,
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        await runReferenceMake({
+            prompt: args.prompt,
+            from: args.from,
+            'reference-image-url': args['reference-image-url'],
+            'reference-image': args['reference-image'],
+            json: args.json,
+        });
+    },
+});
+const acceptCommand = defineCommand({
+    meta: {
+        name: 'accept',
+        description: "Make one candidate (or your own image file/URL) the project's reference — every later generation inherits it.",
+    },
+    args: {
+        candidate: {
+            type: 'positional',
+            required: true,
+            description: 'A candidate id from `bitmagic reference show`, a local image file, or an https image URL.',
+        },
+        json: JSON_FLAG,
+    },
+    async run({ args }) {
+        await runReferenceAccept({ candidate: args.candidate, json: args.json });
+    },
+});
+const showCommand = defineCommand({
+    meta: { name: 'show', description: 'Show the accepted reference image and the candidates made so far.' },
+    args: { json: JSON_FLAG },
+    async run({ args }) {
+        await runReferenceShow({ json: args.json });
+    },
+});
+const clearCommand = defineCommand({
+    meta: { name: 'clear', description: 'Stop using the accepted reference image. Candidates are kept.' },
+    args: { json: JSON_FLAG },
+    async run({ args }) {
+        await runReferenceClear({ json: args.json });
+    },
+});
+export const referenceCommand = defineCommand({
+    meta: {
+        name: 'reference',
+        description: "Make and accept the reference image of the game's world that other generations follow.",
+    },
+    subCommands: {
+        make: makeCommand,
+        accept: acceptCommand,
+        show: showCommand,
+        clear: clearCommand,
+    },
+});
+//# sourceMappingURL=reference.js.map

package/dist/commands/reference.js.map

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

package/dist/generate/stream.d.ts

@@ -18,6 +18,12 @@ export interface GenerationOutcome {
      * came back is what tells the caller which one to send.
      */
     masterUrl?: string;
+    /**
+     * Only the `reference` type sets this: the concept image `bitmagic reference make` iterates on.
+     * That generator returns NO patches — a candidate must not touch the project until the creator
+     * accepts it — so this field is its whole result.
+     */
+    imageUrl?: string;
     /**
      * Only the `vehicle` type sets this: the bake settings its GLB was authored for. `minVoxelSize`
      * is derived from the vehicle's own proportions rather than fixed, so the CLI cannot pick it —

package/dist/generate/stream.js

@@ -39,7 +39,7 @@ function asVehicleOutcome(value) {
 function asGenerationOutcome(data) {
     if (!isRecord(data))
         return null;
-    const { success, message, patches, glbUrl, masterUrl, vehicle } = data;
+    const { success, message, patches, glbUrl, masterUrl, imageUrl, vehicle } = data;
     if (typeof success !== 'boolean' || typeof message !== 'string' || !Array.isArray(patches)) {
         return null;
     }
@@ -50,6 +50,7 @@ function asGenerationOutcome(data) {
         patches: patches,
         ...(typeof glbUrl === 'string' ? { glbUrl } : {}),
         ...(typeof masterUrl === 'string' ? { masterUrl } : {}),
+        ...(typeof imageUrl === 'string' ? { imageUrl } : {}),
         ...(vehicleOutcome ? { vehicle: vehicleOutcome } : {}),
     };
 }

package/dist/generate/stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/generate/stream.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAQnE,gGAAgG;AAChG,gGAAgG;AAChG,qCAAqC;AACrC,OAAO,EAAE,cAAc,EAAiB,MAAM,gBAAgB,CAAC;AAwC/D,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC1D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrG,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,IAAI;QACJ,YAAY;QACZ,YAAY;QACZ,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;KAC3F,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAa;IACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACvE,IAAI,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3F,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,cAAc,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO;QACL,OAAO;QACP,OAAO;QACP,OAAO,EAAE,OAAuB;QAChC,GAAG,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,QAAuB;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAA6B;IAC/C,OAAO,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;AACpG,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,UAAU,CAAC,QAAuB,EAAE,IAAY,EAAE,IAA6B;IAC5F,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAExF,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,QAAQ,CACjB,wBAAwB,UAAU,CAAC,IAAI,CAAC,8BAA8B,IAAI,gBAAgB,CAC3F,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,0EAA0E;QAC1E,4EAA4E;QAC5E,uEAAuE;QACvE,oDAAoD;QACpD,MAAM,IAAI,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,qBAAqB,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,QAAQ,CAAC,mBAAmB,CAAC,mBAAmB,IAAI,QAAQ,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC;QAClC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;QACpC,MAAM,MAAM,GACV,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;YACzD,CAAC,CAAC,aAAa,OAAO,4BAA4B,IAAI,mBAAmB,QAAQ,GAAG;YACpF,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,IAAI,QAAQ,CAAC,sCAAsC,IAAI,UAAU,MAAM,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,OAAO,IAAI,QAAQ,CAAC,aAAa,IAAI,4BAA4B,IAAI,sBAAsB,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO,IAAI,QAAQ,CACjB,4BAA4B,QAAQ,CAAC,MAAM,iBAAiB,IAAI,QAAQ;QACtE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAwB,EACxB,WAAmB,EACnB,IAAY,EACZ,IAA6B,EAC7B,IAAgB;IAEhB,MAAM,GAAG,GAAG,GAAG,WAAW,CAAC,MAAM,sBAAsB,IAAI,SAAS,CAAC;IAErE,IAAI,QAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YAC/B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,GAAG,gBAAgB,EAAE;gBACrB,aAAa,EAAE,UAAU,WAAW,EAAE;gBACtC,MAAM,EAAE,mBAAmB;gBAC3B,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,gFAAgF;QAChF,MAAM,IAAI,QAAQ,CAAC,8BAA8B,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,UAAU,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,QAAQ,CAAC,8DAA8D,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAE3C,SAAS,CAAC;QACR,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI;YAAE,MAAM;QAEhB,uFAAuF;QACvF,4FAA4F;QAC5F,uEAAuE;QACvE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC/B,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,OAAO,KAAK,IAAI;oBAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC/C,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACxD,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,IAAI,OAAO;oBAAE,OAAO,OAAO,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,iDAAiD,IAAI,wBAAwB;QAC3E,oFAAoF;QACpF,8EAA8E,CACjF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../../src/generate/stream.ts"],"names":[],"mappings":"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"}

package/dist/ios/app-config.d.ts

@@ -0,0 +1,54 @@
+import { type MobileOrientation } from '../project/platform-declaration.js';
+/** What `.bitmagic/ios.json` may hold. Every field optional — absent means "derive". */
+export interface IosConfigFile {
+    bundleId?: string;
+    displayName?: string;
+    version?: string;
+    teamId?: string;
+}
+export interface IosAppConfig {
+    /** Reverse-DNS id, `ai.bitmagic.game.<gameid>` unless overridden. */
+    bundleId: string;
+    /** What the home screen shows — any unicode, from game.json's gameName. */
+    displayName: string;
+    /** PRODUCT_NAME / the .app filename — sanitized ASCII (Steam export §4 rules). */
+    productName: string;
+    /** CFBundleShortVersionString. */
+    version: string;
+    /** CFBundleVersion — a UTC yyyyMMddHHmm stamp, so store uploads always increase. */
+    buildNumber: string;
+    /** Apple Developer team, required only for the device/store lane. */
+    teamId?: string;
+    /** From the project's own declaration; decides the Info.plist orientation mask. */
+    orientation?: MobileOrientation;
+}
+/**
+ * The default bundle id. Game ids are uppercase alphanumerics; lowercased they are valid
+ * reverse-DNS segments. Anything else (a hand-edited id) is filtered to the characters Apple
+ * accepts rather than rejected — the id only has to be stable and valid, not pretty.
+ */
+export declare function deriveBundleId(gameId: string): string;
+/**
+ * PRODUCT_NAME under the Steam export's filename rules: ASCII letters, digits, space, dash;
+ * whitespace collapsed; max 40 chars. The pretty, unsanitized name still ships as
+ * CFBundleDisplayName — this only names the executable and the .app on disk.
+ */
+export declare function sanitizeProductName(name: string, gameId: string): string;
+/** The moment's UTC yyyyMMddHHmm — monotonic across builds, which App Store uploads require. */
+export declare function buildNumberNow(now?: Date): string;
+export interface ResolveAppConfigOptions {
+    root: string;
+    gameId: string;
+    configPath: string;
+    /** `--name` for this build only — never persisted, mirroring publish's override semantics. */
+    nameOverride?: string;
+    /** `--team` — persisted to ios.json so the device lane needs it only once. */
+    teamOverride?: string;
+    now?: Date;
+}
+/**
+ * Resolve the app identity, persisting `--team` (the one flag worth remembering) back to
+ * `.bitmagic/ios.json`. Everything else derives fresh each build so the wrapper follows the
+ * project: rename the game in game.json and the next build renames the app.
+ */
+export declare function resolveAppConfig(options: ResolveAppConfigOptions): IosAppConfig;

package/dist/ios/app-config.js

@@ -0,0 +1,109 @@
+/**
+ * The packaged app's identity: bundle id, names, version — resolved from the project with
+ * `.bitmagic/ios.json` as the persistent override file.
+ *
+ * The file is deliberately OUTSIDE the project source (`.bitmagic` is excluded from the publish
+ * fingerprint), because nothing here changes the game: it names the wrapper. Defaults are
+ * derived deterministically from the project, so a deleted ios.json regenerates the same app
+ * identity — the file only needs to exist once the creator overrides something (or a `--team`
+ * is worth remembering).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { CliError } from '../errors.js';
+import { readPlatformDeclaration } from '../project/platform-declaration.js';
+import { aliasSourceDir } from '../scaffold/aliases.js';
+/**
+ * The default bundle id. Game ids are uppercase alphanumerics; lowercased they are valid
+ * reverse-DNS segments. Anything else (a hand-edited id) is filtered to the characters Apple
+ * accepts rather than rejected — the id only has to be stable and valid, not pretty.
+ */
+export function deriveBundleId(gameId) {
+    const segment = gameId.toLowerCase().replace(/[^a-z0-9-]/g, '');
+    if (segment.length === 0) {
+        throw new CliError(`Cannot derive a bundle id from gameId ${JSON.stringify(gameId)}.`);
+    }
+    return `ai.bitmagic.game.${segment}`;
+}
+/**
+ * PRODUCT_NAME under the Steam export's filename rules: ASCII letters, digits, space, dash;
+ * whitespace collapsed; max 40 chars. The pretty, unsanitized name still ships as
+ * CFBundleDisplayName — this only names the executable and the .app on disk.
+ */
+export function sanitizeProductName(name, gameId) {
+    const cleaned = name
+        .replace(/[^A-Za-z0-9 -]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 40)
+        .trim();
+    return cleaned.length > 0 ? cleaned : `Bitmagic Game ${gameId}`;
+}
+/** The moment's UTC yyyyMMddHHmm — monotonic across builds, which App Store uploads require. */
+export function buildNumberNow(now = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return (`${now.getUTCFullYear()}${pad(now.getUTCMonth() + 1)}${pad(now.getUTCDate())}`
+        + `${pad(now.getUTCHours())}${pad(now.getUTCMinutes())}`);
+}
+function readConfigFile(configPath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+        return {};
+    const record = parsed;
+    const str = (key) => typeof record[key] === 'string' && record[key].length > 0
+        ? record[key]
+        : undefined;
+    return {
+        bundleId: str('bundleId'),
+        displayName: str('displayName'),
+        version: str('version'),
+        teamId: str('teamId'),
+    };
+}
+/** The game's display name as game.json declares it, or null when the file doesn't say. */
+function readGameName(root) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(path.join(root, aliasSourceDir('work'), 'game.json'), 'utf-8'));
+        if (typeof parsed !== 'object' || parsed === null)
+            return null;
+        const name = parsed.gameName;
+        return typeof name === 'string' && name.trim().length > 0 ? name.trim() : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the app identity, persisting `--team` (the one flag worth remembering) back to
+ * `.bitmagic/ios.json`. Everything else derives fresh each build so the wrapper follows the
+ * project: rename the game in game.json and the next build renames the app.
+ */
+export function resolveAppConfig(options) {
+    const file = readConfigFile(options.configPath);
+    if (options.teamOverride !== undefined && options.teamOverride !== file.teamId) {
+        const updated = { ...file, teamId: options.teamOverride };
+        fs.mkdirSync(path.dirname(options.configPath), { recursive: true });
+        fs.writeFileSync(options.configPath, `${JSON.stringify(updated, null, 2)}\n`);
+        file.teamId = options.teamOverride;
+    }
+    const displayName = options.nameOverride ?? file.displayName ?? readGameName(options.root) ?? `Bitmagic Game ${options.gameId}`;
+    const declaration = readPlatformDeclaration(options.root);
+    return {
+        bundleId: file.bundleId ?? deriveBundleId(options.gameId),
+        displayName,
+        productName: sanitizeProductName(displayName, options.gameId),
+        version: file.version ?? '1.0.0',
+        buildNumber: buildNumberNow(options.now),
+        ...(file.teamId !== undefined ? { teamId: file.teamId } : {}),
+        ...(declaration.mobileOrientation !== undefined
+            ? { orientation: declaration.mobileOrientation }
+            : {}),
+    };
+}
+//# sourceMappingURL=app-config.js.map