@bitmagic/cli 0.1.83-dev.1 → 0.1.83-dev.3

package/dist/steam/art-generate.d.ts

@@ -0,0 +1,55 @@
+import { styleLead } from '@bitmagic/asset-core';
+import { type GenerateRunDeps } from '../commands/generate.js';
+import type { SteamPaths } from './paths.js';
+export type ArtKind = 'wide' | 'tall' | 'hero' | 'logo' | 'icon';
+export declare const ART_KINDS: readonly ArtKind[];
+/**
+ * Generation sizes: the Asset Forger takes at most 2048 px on either side, in multiples of 16.
+ * Every Steam asset but one fits inside that at 1:1 or better; the library hero (3840x1240) is
+ * drawn from a 2048-wide 3:1 picture, which Steam's own half-size copy (1920x620, the one most
+ * screens show) uses at native resolution.
+ */
+export declare const KIND_SIZES: Record<ArtKind, {
+    width: number;
+    height: number;
+}>;
+/** The flat colour the logo is drawn on, so `steam art use --as logo` can key it out. */
+export declare const LOGO_KEY_COLORS: Record<string, string>;
+export declare function buildArtPrompt(options: {
+    kind: ArtKind;
+    designText: string;
+    artStyle: Parameters<typeof styleLead>[0];
+    gameName: string;
+    /** The agent's own description — replaces the design excerpt, never the framing rules. */
+    prompt?: string;
+    keyColorName?: string;
+}): string;
+export interface CandidateRecord {
+    id: string;
+    kind: ArtKind;
+    file: string;
+    url: string;
+    prompt: string;
+    width: number;
+    height: number;
+    reference?: string;
+    createdAt: string;
+}
+export declare function readCandidateRecord(paths: SteamPaths, id: string): CandidateRecord | null;
+export declare function listCandidateRecords(paths: SteamPaths): CandidateRecord[];
+/**
+ * The reference this kind is drawn against, when the caller named none: the accepted project
+ * reference if there is one, else the cover — the picture that already defines the game's look.
+ * The logo gets no default reference: a scene would only pull scenery into it.
+ */
+export declare function defaultArtReference(root: string, kind: ArtKind, projectReference: string | undefined): string | undefined;
+export declare function generateArtCandidate(options: {
+    root: string;
+    paths: SteamPaths;
+    kind: ArtKind;
+    gameName: string;
+    prompt?: string;
+    referenceUrl?: string;
+    keyColorName?: string;
+    deps: GenerateRunDeps;
+}): Promise<CandidateRecord>;

package/dist/steam/art-generate.js

@@ -0,0 +1,174 @@
+/**
+ * `bitmagic steam art generate <kind>` — one AI-generated candidate for the store kit's key art,
+ * logo or icon, saved under `.bitmagic/steam/art/candidates/` for the agent to look at.
+ *
+ * Built on the `generate image` lane exactly as `bitmagic cover` is (ownership, spark billing,
+ * the server-side deadline), but through `requestAssetWithJobRecord` so the patch the image
+ * generator returns is READ for its URL and never applied: store art is not a game asset, and
+ * writing it into world.json would invalidate a passing verify for nothing.
+ *
+ * The images are drafts by construction — the agent looks at each one, iterates with `--prompt`
+ * or a reference, and only `steam art use` makes one part of the kit.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { VOXEL_ART_IMAGE_MODEL, styleLead, styleTail } from '@bitmagic/asset-core';
+import { CliError } from '../errors.js';
+import { readJsonFile, writeJsonAtomic } from '../atomic-json.js';
+import { resolveArtStyle } from '../project/art-style.js';
+import { readCoverRecord, resolveDesignText, coverUrlFromPatches } from '../commands/cover.js';
+import { requestAssetWithJobRecord } from '../commands/generate.js';
+import { creatorPromptField } from '../telemetry/creator-prompt.js';
+import { readImageInfo } from './image-info.js';
+export const ART_KINDS = ['wide', 'tall', 'hero', 'logo', 'icon'];
+/**
+ * Generation sizes: the Asset Forger takes at most 2048 px on either side, in multiples of 16.
+ * Every Steam asset but one fits inside that at 1:1 or better; the library hero (3840x1240) is
+ * drawn from a 2048-wide 3:1 picture, which Steam's own half-size copy (1920x620, the one most
+ * screens show) uses at native resolution.
+ */
+export const KIND_SIZES = {
+    wide: { width: 2048, height: 1152 },
+    tall: { width: 1344, height: 2016 },
+    hero: { width: 2048, height: 688 },
+    logo: { width: 2048, height: 1024 },
+    icon: { width: 1024, height: 1024 },
+};
+const FRAMING = {
+    wide: 'Steam store key art in a wide 16:9 cinematic composition: the hero and the world\'s most '
+        + 'recognisable landmark, bold readable shapes, a strong silhouette, depth and atmosphere. Leave '
+        + 'the centre of the frame calm enough for a title logo to sit over it later.',
+    tall: 'Steam store key art in a tall 2:3 portrait composition: the hero large in the middle third, '
+        + 'open sky or calm space in the top quarter and quiet ground in the bottom fifth, where a title '
+        + 'logo will sit later.',
+    hero: 'An ultra-wide 3:1 panoramic banner of the game\'s world: the hero and the main landmarks inside '
+        + 'the central third, the scene continuing naturally to both edges, nothing important near the '
+        + 'top and bottom edges.',
+    icon: 'A square app icon: the hero alone, large and centred, one bold silhouette on a simple '
+        + 'contrasting background, readable even at 32 pixels.',
+};
+/** The flat colour the logo is drawn on, so `steam art use --as logo` can key it out. */
+export const LOGO_KEY_COLORS = {
+    green: '#00FF00',
+    magenta: '#FF00FF',
+    blue: '#0000FF',
+};
+export function buildArtPrompt(options) {
+    const scene = (options.prompt ?? options.designText).trim().slice(0, 1500);
+    if (options.kind === 'logo') {
+        const keyName = options.keyColorName ?? 'green';
+        const keyHex = LOGO_KEY_COLORS[keyName] ?? LOGO_KEY_COLORS.green;
+        return [
+            `A video game title logo that reads exactly "${options.gameName}" — every letter spelled exactly like that, nothing added.`,
+            'Chunky, highly legible display lettering with a thick dark outline around the whole logo and a slight 3D bevel, '
+                + 'designed to read at small sizes on a store page.',
+            scene ? `The game: ${scene}` : '',
+            `The logo is centred with generous empty margins on every side and sits on a perfectly flat, uniform pure ${keyName} `
+                + `(${keyHex}) background: no gradient, no shadow cast on the background, no scenery, no frame, no other text. `
+                + `Do not use ${keyName} anywhere in the logo itself.`,
+        ].filter((line) => line !== '').join('\n');
+    }
+    return [
+        styleLead(options.artStyle),
+        FRAMING[options.kind],
+        `The game: ${scene}`,
+        styleTail(options.artStyle),
+    ].join('\n');
+}
+function nextCandidateId(dir, kind) {
+    let max = 0;
+    if (fs.existsSync(dir)) {
+        const pattern = new RegExp(`^${kind}-(\\d+)\\.json$`);
+        for (const name of fs.readdirSync(dir)) {
+            const match = pattern.exec(name);
+            if (match)
+                max = Math.max(max, Number(match[1]));
+        }
+    }
+    return `${kind}-${String(max + 1).padStart(2, '0')}`;
+}
+export function readCandidateRecord(paths, id) {
+    if (!/^[a-z]+-\d+$/.test(id))
+        return null;
+    const parsed = readJsonFile(path.join(paths.candidatesDir, `${id}.json`));
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const record = parsed;
+    return typeof record.file === 'string' ? record : null;
+}
+export function listCandidateRecords(paths) {
+    if (!fs.existsSync(paths.candidatesDir))
+        return [];
+    return fs.readdirSync(paths.candidatesDir)
+        .filter((name) => name.endsWith('.json'))
+        .map((name) => readCandidateRecord(paths, name.slice(0, -5)))
+        .filter((record) => record !== null)
+        .sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+}
+/**
+ * The reference this kind is drawn against, when the caller named none: the accepted project
+ * reference if there is one, else the cover — the picture that already defines the game's look.
+ * The logo gets no default reference: a scene would only pull scenery into it.
+ */
+export function defaultArtReference(root, kind, projectReference) {
+    if (kind === 'logo')
+        return undefined;
+    if (projectReference !== undefined)
+        return projectReference;
+    return readCoverRecord(root)?.url;
+}
+export async function generateArtCandidate(options) {
+    const { root, paths, kind, deps } = options;
+    if (options.keyColorName !== undefined && LOGO_KEY_COLORS[options.keyColorName] === undefined) {
+        throw new CliError(`--key-color must be one of ${Object.keys(LOGO_KEY_COLORS).join(', ')}.`);
+    }
+    const designText = options.prompt !== undefined ? '' : resolveDesignText({ root });
+    const prompt = buildArtPrompt({
+        kind,
+        designText,
+        artStyle: resolveArtStyle(root),
+        gameName: options.gameName,
+        ...(options.prompt !== undefined ? { prompt: options.prompt } : {}),
+        ...(options.keyColorName !== undefined ? { keyColorName: options.keyColorName } : {}),
+    });
+    const size = KIND_SIZES[kind];
+    const body = {
+        name: `steam_${kind}`,
+        prompt,
+        width: size.width,
+        height: size.height,
+        model: VOXEL_ART_IMAGE_MODEL,
+        ...(options.referenceUrl !== undefined ? { referenceImageUrl: options.referenceUrl } : {}),
+        ...creatorPromptField(),
+    };
+    const outcome = await requestAssetWithJobRecord('image', `Steam ${kind} art`, body, deps, (result) => result);
+    const url = coverUrlFromPatches(outcome.patches);
+    if (url === null) {
+        throw new CliError('The image was generated but the response carried no URL. Run the command again; nothing was saved.');
+    }
+    const response = await deps.fetch(url);
+    if (!response.ok)
+        throw new CliError(`Could not download the generated image (HTTP ${response.status}): ${url}`);
+    const bytes = Buffer.from(await response.arrayBuffer());
+    const info = readImageInfo(bytes);
+    if (info === null)
+        throw new CliError(`The generated file is not an image: ${url}`);
+    fs.mkdirSync(paths.candidatesDir, { recursive: true });
+    const id = nextCandidateId(paths.candidatesDir, kind);
+    const file = path.join(paths.candidatesDir, `${id}.${info.format}`);
+    fs.writeFileSync(file, bytes);
+    const record = {
+        id,
+        kind,
+        file,
+        url,
+        prompt,
+        width: info.width,
+        height: info.height,
+        ...(options.referenceUrl !== undefined ? { reference: options.referenceUrl } : {}),
+        createdAt: new Date().toISOString(),
+    };
+    writeJsonAtomic(path.join(paths.candidatesDir, `${id}.json`), record);
+    return record;
+}
+//# sourceMappingURL=art-generate.js.map

package/dist/steam/art-generate.js.map

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

package/dist/steam/art-render.d.ts

@@ -0,0 +1,25 @@
+import type { SteamPaths } from './paths.js';
+export interface RenderedAsset {
+    id: string;
+    file: string;
+    width: number;
+    height: number;
+}
+export interface ArtRenderResult {
+    rendered: RenderedAsset[];
+    /** One labelled sheet of every rendered asset, for looking at the whole kit at once. */
+    overview: string | null;
+    /** Assets that could not be drawn, and why. */
+    skipped: {
+        id: string;
+        reason: string;
+    }[];
+    /** Fallbacks taken — a tall capsule cut from the wide art, and so on. */
+    notes: string[];
+}
+export declare function renderArt(options: {
+    paths: SteamPaths;
+    /** Only these asset ids; every asset when absent. */
+    only?: readonly string[];
+    log: (message: string) => void;
+}): Promise<ArtRenderResult>;

package/dist/steam/art-render.js

@@ -0,0 +1,157 @@
+/**
+ * `bitmagic steam art render`: draw every image in the store kit from art.json, at Steamworks'
+ * exact sizes, plus the executable icons the builds embed.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { CliError } from '../errors.js';
+import { assetHtml, libraryLogoSize, logoOnlyHtml, readArtConfig, resolveSource, } from './art.js';
+import { buildIcns, buildIco } from './icon-files.js';
+import { RasterSession, dataUrlFor } from './raster.js';
+import { ICNS_SIZES, ICO_SIZES, LIBRARY_LOGO_BOX, MAC_ICNS_FILE, SHORTCUT_ICO_FILE, STORE_IMAGE_SPECS, } from './specs.js';
+/** Which source each art kind falls back to when art.json names none. */
+const FALLBACKS = {
+    wide: [],
+    tall: ['wide'],
+    hero: ['wide'],
+    icon: ['tall', 'wide'],
+};
+export async function renderArt(options) {
+    const { paths } = options;
+    const config = readArtConfig(paths.artConfigPath);
+    const result = { rendered: [], overview: null, skipped: [], notes: [] };
+    const wanted = STORE_IMAGE_SPECS.filter((spec) => options.only === undefined || options.only.includes(spec.id));
+    for (const id of options.only ?? []) {
+        if (!STORE_IMAGE_SPECS.some((spec) => spec.id === id) && id !== 'icons') {
+            throw new CliError(`--only names "${id}", which is not a Steam asset. Known: ${STORE_IMAGE_SPECS.map((s) => s.id).join(', ')}, icons.`);
+        }
+    }
+    if (resolveSource(paths.steamDir, config, 'wide') === null) {
+        throw new CliError('No wide key art yet. Generate one with `bitmagic steam art generate wide` and choose it with '
+            + '`bitmagic steam art use <candidate> --as wide` (or point art.json\'s sources.wide at your own image).', 3);
+    }
+    const session = await RasterSession.open('bitmagic steam art render');
+    try {
+        const cache = new Map();
+        const load = async (name) => {
+            const file = resolveSource(paths.steamDir, config, name);
+            if (file === null)
+                return null;
+            const cached = cache.get(file);
+            if (cached)
+                return cached;
+            const converted = await session.toPng(fs.readFileSync(file));
+            const loaded = { path: file, dataUrl: dataUrlFor(converted.png), width: converted.width, height: converted.height };
+            cache.set(file, loaded);
+            return loaded;
+        };
+        const artFor = async (kind) => {
+            const own = await load(kind);
+            if (own !== null)
+                return own;
+            for (const fallback of FALLBACKS[kind]) {
+                const used = await load(fallback);
+                if (used !== null) {
+                    const note = `No ${kind} art — ${kind} assets are cut from the ${fallback} art.`;
+                    if (!result.notes.includes(note))
+                        result.notes.push(note);
+                    return used;
+                }
+            }
+            return null;
+        };
+        const logo = await load('logo');
+        const write = (spec, bytes, width, height) => {
+            const target = path.join(paths.kitDir, spec.file);
+            fs.mkdirSync(path.dirname(target), { recursive: true });
+            fs.writeFileSync(target, bytes);
+            result.rendered.push({ id: spec.id, file: target, width, height });
+            options.log(`  ${spec.file} (${width}x${height})`);
+        };
+        for (const spec of wanted) {
+            if (spec.logo === 'only') {
+                if (logo === null) {
+                    result.skipped.push({ id: spec.id, reason: 'no logo — `bitmagic steam art use <file> --as logo`' });
+                    continue;
+                }
+                const size = libraryLogoSize(logo, LIBRARY_LOGO_BOX);
+                const bytes = await session.render(logoOnlyHtml(logo.dataUrl, size), size.width, size.height, { transparent: true });
+                write(spec, bytes, size.width, size.height);
+                continue;
+            }
+            const layout = config.layouts[spec.id];
+            const kind = layout.source ?? spec.art;
+            if (kind === null)
+                continue;
+            const art = await artFor(kind);
+            if (art === null) {
+                result.skipped.push({ id: spec.id, reason: `no ${kind} art` });
+                continue;
+            }
+            if (spec.logo === 'required' && layout.logo !== null && logo === null) {
+                result.skipped.push({ id: spec.id, reason: 'needs the logo — `bitmagic steam art use <file> --as logo`' });
+                continue;
+            }
+            const html = assetHtml({
+                spec,
+                layout,
+                artUrl: art.dataUrl,
+                logo: spec.logo === 'forbidden' || logo === null ? null : { url: logo.dataUrl, width: logo.width, height: logo.height },
+            });
+            const bytes = await session.render(html, spec.width, spec.height, { format: spec.format === 'jpg' ? 'jpeg' : 'png' });
+            write(spec, bytes, spec.width, spec.height);
+        }
+        if (options.only === undefined || options.only.includes('icons') || options.only.includes('shortcut_icon')) {
+            const icon = await artFor('icon');
+            if (icon !== null) {
+                const layout = config.layouts.shortcut_icon;
+                const pngs = await session.squareIcons(fs.readFileSync(icon.path), [...new Set([...ICO_SIZES, ...ICNS_SIZES])], layout.focus);
+                const ico = buildIco(pngs.filter((p) => ICO_SIZES.includes(p.size)));
+                const icns = buildIcns(pngs.filter((p) => ICNS_SIZES.includes(p.size)));
+                for (const [rel, bytes] of [[SHORTCUT_ICO_FILE, ico], [MAC_ICNS_FILE, icns]]) {
+                    const target = path.join(paths.kitDir, rel);
+                    fs.mkdirSync(path.dirname(target), { recursive: true });
+                    fs.writeFileSync(target, bytes);
+                    options.log(`  ${rel}`);
+                }
+            }
+        }
+        if (result.rendered.length > 0) {
+            const overview = path.join(paths.checkDir, 'kit-overview.png');
+            fs.mkdirSync(paths.checkDir, { recursive: true });
+            const html = overviewHtml(result.rendered.map((asset) => ({
+                label: `${asset.id} — ${asset.width}x${asset.height}`,
+                url: dataUrlFor(fs.readFileSync(asset.file)),
+                width: asset.width,
+                height: asset.height,
+            })));
+            fs.writeFileSync(overview, await session.render(html, OVERVIEW_WIDTH, overviewHeight(result.rendered)));
+            result.overview = overview;
+            options.log(`  overview: ${overview}`);
+        }
+    }
+    finally {
+        await session.close();
+    }
+    return result;
+}
+const OVERVIEW_WIDTH = 1600;
+const OVERVIEW_TILE = { width: 365, height: 230 };
+function overviewHeight(assets) {
+    const columns = Math.floor((OVERVIEW_WIDTH - 20) / (OVERVIEW_TILE.width + 20));
+    return 20 + Math.ceil(assets.length / columns) * (OVERVIEW_TILE.height + 50);
+}
+/** Every asset scaled into a tile on a checkerboard (so a transparent logo reads as transparent). */
+function overviewHtml(tiles) {
+    const cells = tiles.map((tile) => `<figure><div class="box"><img src="${tile.url}"></div><figcaption>${tile.label}</figcaption></figure>`).join('');
+    return `<!doctype html><html><head><meta charset="utf-8"><style>
+html,body{margin:0;background:#16141c;font:600 14px system-ui,sans-serif;color:#e8e4f0}
+main{display:flex;flex-wrap:wrap;gap:20px;padding:20px;width:${OVERVIEW_WIDTH - 40}px}
+figure{margin:0;width:${OVERVIEW_TILE.width}px}
+.box{width:${OVERVIEW_TILE.width}px;height:${OVERVIEW_TILE.height}px;display:flex;align-items:center;justify-content:center;
+background:repeating-conic-gradient(#2a2733 0 25%,#221f2a 0 50%) 0 0/16px 16px;border-radius:6px;overflow:hidden}
+img{max-width:100%;max-height:100%}
+figcaption{margin-top:6px;opacity:.85}
+</style></head><body><main>${cells}</main></body></html>`;
+}
+//# sourceMappingURL=art-render.js.map

package/dist/steam/art-render.js.map

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

package/dist/steam/art-use.d.ts

@@ -0,0 +1,20 @@
+import { type SourceName } from './art.js';
+import type { SteamPaths } from './paths.js';
+export interface UseArtResult {
+    source: SourceName;
+    file: string;
+    width: number;
+    height: number;
+    /** Set when a flat background was keyed out of a logo. */
+    keyColor?: string;
+}
+export declare function resolveArtInput(paths: SteamPaths, input: string, cwd: string): string;
+export declare function useArtSource(options: {
+    paths: SteamPaths;
+    file: string;
+    source: SourceName;
+    /** `auto`, `#rrggbb`, or `none` to keep the background. Logos only. */
+    keyColor?: string;
+    tolerance?: number;
+    softness?: number;
+}): Promise<UseArtResult>;

package/dist/steam/art-use.js

@@ -0,0 +1,84 @@
+/**
+ * `bitmagic steam art use <candidate|file> --as <source>` — make one picture part of the store kit.
+ *
+ * Every source is stored as a PNG under `.bitmagic/steam/art/` and recorded in art.json, so the
+ * kit never depends on a generator URL staying alive. The logo is the one source that changes on
+ * the way in: a generated logo arrives on a flat colour and is keyed to transparency, an
+ * agent-authored `.html`/`.svg` logo is rendered on a transparent page, and both are trimmed to
+ * their own bounds so every layout can size them by their real aspect.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { CliError } from '../errors.js';
+import { DEFAULT_SOURCE_FILES, setArtSource } from './art.js';
+import { readCandidateRecord } from './art-generate.js';
+import { readImageInfo } from './image-info.js';
+import { RasterSession } from './raster.js';
+/** The canvas an HTML or SVG logo is laid out on before trimming. */
+const LOGO_PAGE = { width: 2400, height: 1200 };
+export function resolveArtInput(paths, input, cwd) {
+    const candidate = readCandidateRecord(paths, input);
+    if (candidate !== null) {
+        if (!fs.existsSync(candidate.file))
+            throw new CliError(`Candidate ${input} is recorded but its file is gone: ${candidate.file}`);
+        return candidate.file;
+    }
+    const file = path.resolve(cwd, input);
+    if (!fs.existsSync(file)) {
+        throw new CliError(`No candidate called ${input} and no file at ${file}. \`bitmagic steam art list\` shows the candidates.`);
+    }
+    return file;
+}
+export async function useArtSource(options) {
+    const { paths, file, source } = options;
+    const ext = path.extname(file).toLowerCase();
+    const session = await RasterSession.open('bitmagic steam art use');
+    try {
+        let png;
+        let width;
+        let height;
+        let keyColor;
+        if (ext === '.html' || ext === '.htm' || ext === '.svg') {
+            if (source !== 'logo')
+                throw new CliError('Only the logo can come from an .html or .svg file.');
+            const markup = fs.readFileSync(file, 'utf-8');
+            const html = ext === '.svg'
+                ? `<!doctype html><html><body style="margin:0;background:transparent;display:flex;align-items:center;justify-content:center;width:${LOGO_PAGE.width}px;height:${LOGO_PAGE.height}px">`
+                    + `<img style="max-width:94%;max-height:94%" src="data:image/svg+xml;base64,${Buffer.from(markup).toString('base64')}"></body></html>`
+                : markup;
+            const rendered = await session.render(html, LOGO_PAGE.width, LOGO_PAGE.height, { transparent: true });
+            ({ png, width, height } = await session.trimTransparent(rendered));
+        }
+        else {
+            const bytes = fs.readFileSync(file);
+            const info = readImageInfo(bytes);
+            if (info === null)
+                throw new CliError(`${file} is not a PNG, JPEG or WebP image.`);
+            if (source === 'logo' && options.keyColor !== 'none' && !(info.alpha && options.keyColor === undefined)) {
+                const keyed = await session.keyAndTrim(bytes, {
+                    keyColor: options.keyColor ?? 'auto',
+                    tolerance: options.tolerance ?? 70,
+                    softness: options.softness ?? 60,
+                });
+                ({ png, width, height } = keyed);
+                keyColor = keyed.keyColor;
+            }
+            else if (source === 'logo') {
+                ({ png, width, height } = await session.trimTransparent((await session.toPng(bytes)).png));
+            }
+            else {
+                ({ png, width, height } = await session.toPng(bytes));
+            }
+        }
+        const rel = DEFAULT_SOURCE_FILES[source];
+        const target = path.join(paths.steamDir, rel);
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        fs.writeFileSync(target, png);
+        setArtSource(paths.artConfigPath, source, rel);
+        return { source, file: target, width, height, ...(keyColor !== undefined ? { keyColor } : {}) };
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=art-use.js.map

package/dist/steam/art-use.js.map

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

package/dist/steam/art.d.ts

@@ -0,0 +1,98 @@
+import { type ArtSource, type SteamImageSpec } from './specs.js';
+export type SourceName = ArtSource | 'logo';
+export declare const SOURCE_NAMES: readonly SourceName[];
+/** Where each source lands when a candidate is chosen, relative to `.bitmagic/steam/`. */
+export declare const DEFAULT_SOURCE_FILES: Record<SourceName, string>;
+export type Scrim = 'none' | 'bottom' | 'top' | 'left' | 'right' | 'radial';
+export interface LogoPlacement {
+    /** Centre of the logo, as fractions of the canvas. */
+    x: number;
+    y: number;
+    /** Largest width, as a fraction of the canvas width. */
+    width: number;
+    /** Largest height, as a fraction of the canvas height — whichever limit binds first wins. */
+    maxHeight: number;
+}
+export interface AssetLayout {
+    /** Which source to cut from; the spec's own when absent. */
+    source?: ArtSource;
+    /** The point of the art kept in view, as fractions (CSS background-position). */
+    focus: [number, number];
+    /** Scale beyond cover-fit, about `focus`. 1 = just covers the canvas. */
+    zoom: number;
+    /** null: no logo on this asset. */
+    logo: LogoPlacement | null;
+    scrim: Scrim;
+    /** 0..1 — how dark the scrim gets at its darkest. */
+    scrimStrength: number;
+    /** 0..1 — a flat darkening over the whole art. */
+    dim: number;
+    /** Gaussian blur of the art, in pixels. */
+    blur: number;
+}
+export interface ArtConfig {
+    /** Paths relative to `.bitmagic/steam/`. A missing source is reported, not guessed. */
+    sources: Partial<Record<SourceName, string>>;
+    layouts: Record<string, AssetLayout>;
+}
+/**
+ * Defaults per asset, tuned for a key art with its subject near the centre. The small capsule's
+ * logo nearly fills it because Valve asks for exactly that (it is shown as small as 120x45); the
+ * tall capsules put the logo where the art is usually emptiest — sky above, ground below.
+ */
+export declare const DEFAULT_LAYOUTS: Record<string, AssetLayout>;
+/** One asset's layout: the file's fields over the default, each clamped to a sane range. */
+export declare function readLayout(id: string, value: unknown): AssetLayout;
+export declare function readArtConfig(file: string): ArtConfig;
+/** Write the file with every layout spelled out, so the agent sees every knob it can turn. */
+export declare function writeArtConfig(file: string, config: ArtConfig): void;
+/** Record `relPath` as the `name` source, keeping everything else in the file. */
+export declare function setArtSource(file: string, name: SourceName, relPath: string): ArtConfig;
+/** The absolute path of a source, or null when art.json names none or the file is gone. */
+export declare function resolveSource(steamDir: string, config: ArtConfig, name: SourceName): string | null;
+export interface PlacedLogo {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** Where the logo lands on a `width`x`height` canvas, keeping its aspect inside both limits. */
+export declare function placeLogo(placement: LogoPlacement, canvas: {
+    width: number;
+    height: number;
+}, logo: {
+    width: number;
+    height: number;
+}): PlacedLogo;
+/**
+ * The page that draws one asset. Images arrive as data URLs; `logo` is null for assets that must
+ * carry none (the hero, the background, the icons).
+ */
+export declare function assetHtml(options: {
+    spec: SteamImageSpec;
+    layout: AssetLayout;
+    artUrl: string;
+    logo: {
+        url: string;
+        width: number;
+        height: number;
+    } | null;
+}): string;
+/**
+ * The library logo: the logo alone, transparent, scaled to touch the 1280x720 box on one side —
+ * "1280 px wide and/or 720 px tall", in Valve's words — with its own aspect kept.
+ */
+export declare function libraryLogoSize(logo: {
+    width: number;
+    height: number;
+}, box: {
+    width: number;
+    height: number;
+}): {
+    width: number;
+    height: number;
+};
+export declare function logoOnlyHtml(logoUrl: string, size: {
+    width: number;
+    height: number;
+}): string;