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

package/dist/steam/raster.js

@@ -0,0 +1,285 @@
+import { launchSystemChrome } from '../chrome-launch.js';
+import { CliError } from '../errors.js';
+import { readImageInfo, mimeForImage } from './image-info.js';
+export function dataUrlFor(bytes) {
+    const info = readImageInfo(bytes);
+    if (info === null)
+        throw new CliError('Not a PNG, JPEG or WebP image.');
+    return `data:${mimeForImage(info)};base64,${bytes.toString('base64')}`;
+}
+function bytesFromDataUrl(dataUrl) {
+    const comma = dataUrl.indexOf(',');
+    if (comma < 0)
+        throw new CliError('The browser returned no image data.');
+    return Buffer.from(dataUrl.slice(comma + 1), 'base64');
+}
+export class RasterSession {
+    browser;
+    page;
+    constructor(browser, page) {
+        this.browser = browser;
+        this.page = page;
+    }
+    static async open(command) {
+        const browser = await launchSystemChrome({ headless: true, args: ['--mute-audio'], command });
+        try {
+            const context = await browser.newContext({ viewport: { width: 1280, height: 720 }, deviceScaleFactor: 1 });
+            const page = await context.newPage();
+            return new RasterSession(browser, page);
+        }
+        catch (error) {
+            await browser.close();
+            throw error;
+        }
+    }
+    async close() {
+        await this.browser.close();
+    }
+    /**
+     * Lay `html` out at exactly `width`x`height` CSS pixels and capture it. `transparent` keeps the
+     * page background clear (the library logo); otherwise the page paints black under the art.
+     */
+    async render(html, width, height, options = {}) {
+        await this.page.setViewportSize({ width, height });
+        await this.page.setContent(html, { waitUntil: 'load' });
+        // Web fonts and decoded images both arrive after `load` in the worst case.
+        await this.page.evaluate(`Promise.all([
+      document.fonts.ready,
+      ...Array.from(document.images).map((img) => img.decode().catch(() => undefined)),
+    ]).then(() => true)`);
+        const format = options.format ?? 'png';
+        return this.page.screenshot({
+            type: format,
+            clip: { x: 0, y: 0, width, height },
+            omitBackground: options.transparent === true,
+            ...(format === 'jpeg' ? { quality: options.quality ?? 92 } : {}),
+        });
+    }
+    /** Decode any supported image and re-encode it as PNG, with its size. */
+    async toPng(bytes) {
+        const result = await this.page.evaluate(async (src) => {
+            /* eslint-disable no-undef -- browser callback */
+            const img = new Image();
+            img.src = src;
+            await img.decode();
+            const canvas = document.createElement('canvas');
+            canvas.width = img.naturalWidth;
+            canvas.height = img.naturalHeight;
+            const ctx = canvas.getContext('2d');
+            if (!ctx)
+                throw new Error('no 2d context');
+            ctx.drawImage(img, 0, 0);
+            return { dataUrl: canvas.toDataURL('image/png'), width: canvas.width, height: canvas.height };
+            /* eslint-enable no-undef */
+        }, dataUrlFor(bytes));
+        return { png: bytesFromDataUrl(result.dataUrl), width: result.width, height: result.height };
+    }
+    /**
+     * Remove a flat background colour and trim to what is left, plus `pad` pixels. Partially
+     * keyed edge pixels are un-mixed from the key colour (c = (observed - (1-a)·key) / a), so an
+     * anti-aliased outline keeps its own colour instead of a green or magenta fringe.
+     */
+    async keyAndTrim(bytes, options) {
+        const result = await this.page.evaluate(async (args) => {
+            /* eslint-disable no-undef -- browser callback */
+            const img = new Image();
+            img.src = args.src;
+            await img.decode();
+            const w = img.naturalWidth;
+            const h = img.naturalHeight;
+            const canvas = document.createElement('canvas');
+            canvas.width = w;
+            canvas.height = h;
+            const ctx = canvas.getContext('2d', { willReadFrequently: true });
+            if (!ctx)
+                throw new Error('no 2d context');
+            ctx.drawImage(img, 0, 0);
+            const data = ctx.getImageData(0, 0, w, h);
+            const px = data.data;
+            let kr, kg, kb;
+            if (args.key === 'auto') {
+                // The median of the border pixels: robust to a stray corner of artwork.
+                const rs = [], gs = [], bs = [];
+                const sample = (x, y) => {
+                    const i = (y * w + x) * 4;
+                    rs.push(px[i]);
+                    gs.push(px[i + 1]);
+                    bs.push(px[i + 2]);
+                };
+                for (let x = 0; x < w; x += 4) {
+                    sample(x, 0);
+                    sample(x, h - 1);
+                }
+                for (let y = 0; y < h; y += 4) {
+                    sample(0, y);
+                    sample(w - 1, y);
+                }
+                const median = (values) => values.sort((a, b) => a - b)[Math.floor(values.length / 2)];
+                kr = median(rs);
+                kg = median(gs);
+                kb = median(bs);
+            }
+            else {
+                const hex = args.key.replace('#', '');
+                kr = parseInt(hex.slice(0, 2), 16);
+                kg = parseInt(hex.slice(2, 4), 16);
+                kb = parseInt(hex.slice(4, 6), 16);
+            }
+            let minX = w, minY = h, maxX = -1, maxY = -1;
+            for (let y = 0; y < h; y++) {
+                for (let x = 0; x < w; x++) {
+                    const i = (y * w + x) * 4;
+                    const dr = px[i] - kr, dg = px[i + 1] - kg, db = px[i + 2] - kb;
+                    const distance = Math.sqrt(dr * dr + dg * dg + db * db);
+                    let alpha = 1;
+                    if (distance <= args.tol)
+                        alpha = 0;
+                    else if (distance < args.tol + args.soft)
+                        alpha = (distance - args.tol) / args.soft;
+                    if (alpha < 1) {
+                        if (alpha > 0) {
+                            px[i] = Math.max(0, Math.min(255, (px[i] - (1 - alpha) * kr) / alpha));
+                            px[i + 1] = Math.max(0, Math.min(255, (px[i + 1] - (1 - alpha) * kg) / alpha));
+                            px[i + 2] = Math.max(0, Math.min(255, (px[i + 2] - (1 - alpha) * kb) / alpha));
+                        }
+                        px[i + 3] = Math.round(px[i + 3] * alpha);
+                    }
+                    if (px[i + 3] > 8) {
+                        if (x < minX)
+                            minX = x;
+                        if (x > maxX)
+                            maxX = x;
+                        if (y < minY)
+                            minY = y;
+                        if (y > maxY)
+                            maxY = y;
+                    }
+                }
+            }
+            ctx.putImageData(data, 0, 0);
+            if (maxX < 0)
+                throw new Error('Keying removed the whole image — the key colour matches the artwork.');
+            const left = Math.max(0, minX - args.pad);
+            const top = Math.max(0, minY - args.pad);
+            const right = Math.min(w - 1, maxX + args.pad);
+            const bottom = Math.min(h - 1, maxY + args.pad);
+            const out = document.createElement('canvas');
+            out.width = right - left + 1;
+            out.height = bottom - top + 1;
+            const outCtx = out.getContext('2d');
+            if (!outCtx)
+                throw new Error('no 2d context');
+            outCtx.drawImage(canvas, left, top, out.width, out.height, 0, 0, out.width, out.height);
+            const hex2 = (v) => Math.round(v).toString(16).padStart(2, '0');
+            return {
+                dataUrl: out.toDataURL('image/png'),
+                width: out.width,
+                height: out.height,
+                keyColor: `#${hex2(kr)}${hex2(kg)}${hex2(kb)}`,
+            };
+            /* eslint-enable no-undef */
+        }, { src: dataUrlFor(bytes), key: options.keyColor, tol: options.tolerance, soft: options.softness, pad: options.pad ?? 8 });
+        return { png: bytesFromDataUrl(result.dataUrl), width: result.width, height: result.height, keyColor: result.keyColor };
+    }
+    /** Trim fully transparent margins off a PNG, keeping `pad` pixels. */
+    async trimTransparent(png, pad = 8) {
+        const result = await this.page.evaluate(async (args) => {
+            /* eslint-disable no-undef -- browser callback */
+            const img = new Image();
+            img.src = args.src;
+            await img.decode();
+            const w = img.naturalWidth, h = img.naturalHeight;
+            const canvas = document.createElement('canvas');
+            canvas.width = w;
+            canvas.height = h;
+            const ctx = canvas.getContext('2d', { willReadFrequently: true });
+            if (!ctx)
+                throw new Error('no 2d context');
+            ctx.drawImage(img, 0, 0);
+            const px = ctx.getImageData(0, 0, w, h).data;
+            let minX = w, minY = h, maxX = -1, maxY = -1;
+            for (let y = 0; y < h; y++) {
+                for (let x = 0; x < w; x++) {
+                    if (px[(y * w + x) * 4 + 3] > 8) {
+                        if (x < minX)
+                            minX = x;
+                        if (x > maxX)
+                            maxX = x;
+                        if (y < minY)
+                            minY = y;
+                        if (y > maxY)
+                            maxY = y;
+                    }
+                }
+            }
+            if (maxX < 0)
+                throw new Error('The image is fully transparent.');
+            const left = Math.max(0, minX - args.pad), top = Math.max(0, minY - args.pad);
+            const right = Math.min(w - 1, maxX + args.pad), bottom = Math.min(h - 1, maxY + args.pad);
+            const out = document.createElement('canvas');
+            out.width = right - left + 1;
+            out.height = bottom - top + 1;
+            const outCtx = out.getContext('2d');
+            if (!outCtx)
+                throw new Error('no 2d context');
+            outCtx.drawImage(canvas, left, top, out.width, out.height, 0, 0, out.width, out.height);
+            return { dataUrl: out.toDataURL('image/png'), width: out.width, height: out.height };
+            /* eslint-enable no-undef */
+        }, { src: dataUrlFor(png), pad });
+        return { png: bytesFromDataUrl(result.dataUrl), width: result.width, height: result.height };
+    }
+    /**
+     * Square PNGs of `bytes` at each size, cover-cropped to the centre (or to `focus`, as fractions).
+     * Downscaling halves step by step before the last draw — one big drawImage from 1024 to 16 would
+     * alias badly even with high-quality smoothing.
+     */
+    async squareIcons(bytes, sizes, focus = [0.5, 0.5]) {
+        const results = await this.page.evaluate(async (args) => {
+            /* eslint-disable no-undef -- browser callback */
+            const img = new Image();
+            img.src = args.src;
+            await img.decode();
+            const side = Math.min(img.naturalWidth, img.naturalHeight);
+            const sx = Math.round((img.naturalWidth - side) * args.fx);
+            const sy = Math.round((img.naturalHeight - side) * args.fy);
+            let source = document.createElement('canvas');
+            source.width = side;
+            source.height = side;
+            const sctx = source.getContext('2d');
+            if (!sctx)
+                throw new Error('no 2d context');
+            sctx.drawImage(img, sx, sy, side, side, 0, 0, side, side);
+            const out = [];
+            for (const size of [...args.sizes].sort((a, b) => b - a)) {
+                let current = source;
+                while (current.width / 2 >= size) {
+                    const half = document.createElement('canvas');
+                    half.width = Math.max(size, Math.floor(current.width / 2));
+                    half.height = half.width;
+                    const hctx = half.getContext('2d');
+                    if (!hctx)
+                        throw new Error('no 2d context');
+                    hctx.imageSmoothingQuality = 'high';
+                    hctx.drawImage(current, 0, 0, half.width, half.height);
+                    current = half;
+                }
+                const final = document.createElement('canvas');
+                final.width = size;
+                final.height = size;
+                const fctx = final.getContext('2d');
+                if (!fctx)
+                    throw new Error('no 2d context');
+                fctx.imageSmoothingQuality = 'high';
+                fctx.drawImage(current, 0, 0, size, size);
+                out.push({ size, dataUrl: final.toDataURL('image/png') });
+                source = current;
+            }
+            return out;
+            /* eslint-enable no-undef */
+        }, { src: dataUrlFor(bytes), sizes: [...sizes], fx: focus[0], fy: focus[1] });
+        return results
+            .map((entry) => ({ size: entry.size, png: bytesFromDataUrl(entry.dataUrl) }))
+            .sort((a, b) => a.size - b.size);
+    }
+}
+//# sourceMappingURL=raster.js.map

package/dist/steam/raster.js.map

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

package/dist/steam/shell-files.d.ts

@@ -0,0 +1,17 @@
+export declare const SHELL_SCHEME = "bitmagic";
+export declare const SHELL_HOST = "game";
+export interface ShellIdentity {
+    /** Window title, About panel. */
+    displayName: string;
+    /** Stable per game: names the saves directory, so it must never follow a rename. */
+    packageName: string;
+    version: string;
+}
+export declare function shellPackageName(gameId: string): string;
+export declare function buildShellPackageJson(identity: ShellIdentity): string;
+export declare function buildShellMainJs(identity: ShellIdentity): string;
+/**
+ * The page's view of the shell: feature-detectable as `window.bitmagicDesktop`, so a game can
+ * offer "Quit" and a fullscreen toggle only where they mean something.
+ */
+export declare const SHELL_PRELOAD_JS = "// Generated by `bitmagic steam build`.\n'use strict';\n\nconst { contextBridge, ipcRenderer } = require('electron');\n\ncontextBridge.exposeInMainWorld('bitmagicDesktop', {\n  platform: process.platform,\n  store: 'steam',\n  quit: () => ipcRenderer.send('bitmagic:quit'),\n  setFullscreen: (on) => ipcRenderer.send('bitmagic:fullscreen', on === true),\n  isFullscreen: () => ipcRenderer.sendSync('bitmagic:is-fullscreen'),\n});\n";

package/dist/steam/shell-files.js

@@ -0,0 +1,268 @@
+/**
+ * The desktop shell's own files — `main.js`, `preload.js`, `package.json` — written into the
+ * Electron app next to the game payload.
+ *
+ * Deliberately dependency-free: the pinned Electron is the shell's whole attack surface. No
+ * self-updater, ever: Steam updates the game through its depots, and a second updater would fight
+ * it.
+ *
+ * The game is served from a privileged `bitmagic://game/` scheme rather than `file://`: the
+ * payload is a page plus a vendor tree of assets the engine `fetch`es, which Chromium refuses over
+ * file://, and a standard secure scheme also gives the page a stable origin — localStorage and
+ * IndexedDB (the game's saves) live under it, and WebGPU needs the secure context. The MIME table
+ * is generated from the SAME map the offline validation server uses (package/local-server.ts), so
+ * the shipped app answers exactly as the browser that validated the payload did — the iOS lane's
+ * rule for its Swift handler.
+ */
+import { MIME_TYPES, FALLBACK_MIME } from '../package/local-server.js';
+export const SHELL_SCHEME = 'bitmagic';
+export const SHELL_HOST = 'game';
+export function shellPackageName(gameId) {
+    return `bitmagic-${gameId.toLowerCase().replace(/[^a-z0-9-]/g, '') || 'game'}`;
+}
+export function buildShellPackageJson(identity) {
+    return `${JSON.stringify({
+        name: identity.packageName,
+        productName: identity.displayName,
+        version: identity.version,
+        private: true,
+        main: 'main.js',
+    }, null, 2)}\n`;
+}
+export function buildShellMainJs(identity) {
+    const mime = JSON.stringify(Object.fromEntries(MIME_TYPES), null, 2);
+    return `// Generated by \`bitmagic steam build\`. The desktop shell for a Bitmagic game.
+'use strict';
+
+const { app, BrowserWindow, Menu, ipcMain, protocol, session, shell } = require('electron');
+const fs = require('fs');
+const path = require('path');
+
+const DISPLAY_NAME = ${JSON.stringify(identity.displayName)};
+const PACKAGE_NAME = ${JSON.stringify(identity.packageName)};
+const SCHEME = ${JSON.stringify(SHELL_SCHEME)};
+const HOST = ${JSON.stringify(SHELL_HOST)};
+const GAME_DIR = path.join(__dirname, 'game');
+const MIME = ${mime};
+const FALLBACK_MIME = ${JSON.stringify(FALLBACK_MIME)};
+
+// Saves live in localStorage/IndexedDB under userData. Pinned to the game's id, not its display
+// name, so renaming the game on Steam never strands a player's progress.
+// BITMAGIC_SHELL_CHECK is set only by \`bitmagic steam build\` when it launches the finished app to
+// prove it reaches gameplay: that run gets a throwaway profile and a window instead of fullscreen.
+const CHECK_DIR = process.env.BITMAGIC_SHELL_CHECK || '';
+app.setPath('userData', CHECK_DIR || path.join(app.getPath('appData'), PACKAGE_NAME));
+app.setName(DISPLAY_NAME);
+
+protocol.registerSchemesAsPrivileged([{
+  scheme: SCHEME,
+  privileges: { standard: true, secure: true, supportFetchAPI: true, corsEnabled: true, stream: true, codeCache: true },
+}]);
+
+// A game renders every frame, focused or not.
+app.commandLine.appendSwitch('disable-renderer-backgrounding');
+app.commandLine.appendSwitch('disable-background-timer-throttling');
+// Chromium's GPU blocklist would put an older driver on the software rasterizer, which no 3D game
+// survives; a game wants the GPU it was given.
+app.commandLine.appendSwitch('ignore-gpu-blocklist');
+// Under Proton (Steam Deck, Linux) the Windows build runs in Wine, where Chromium's sandbox cannot
+// start. Steam sets these variables for every game it launches through Proton.
+if (process.platform === 'win32' && (process.env.STEAM_COMPAT_DATA_PATH || process.env.SteamDeck === '1')) {
+  app.commandLine.appendSwitch('no-sandbox');
+}
+
+if (!app.requestSingleInstanceLock()) {
+  app.quit();
+}
+
+function resolveGameFile(url) {
+  let pathname;
+  try {
+    const parsed = new URL(url);
+    if (parsed.host !== HOST) return null;
+    pathname = decodeURIComponent(parsed.pathname);
+  } catch (err) {
+    return null;
+  }
+  const file = path.resolve(GAME_DIR, '.' + pathname);
+  if (file !== GAME_DIR && !file.startsWith(GAME_DIR + path.sep)) return null;
+  try {
+    return fs.statSync(file).isDirectory() ? path.join(file, 'index.html') : file;
+  } catch (err) {
+    return null;
+  }
+}
+
+function mimeFor(file) {
+  const ext = path.extname(file).slice(1).toLowerCase();
+  return MIME[ext] || FALLBACK_MIME;
+}
+
+async function serve(request) {
+  const file = resolveGameFile(request.url);
+  if (file === null) return new Response('not found', { status: 404 });
+  let bytes;
+  try {
+    bytes = await fs.promises.readFile(file);
+  } catch (err) {
+    return new Response('not found', { status: 404 });
+  }
+  const headers = { 'content-type': mimeFor(file), 'cache-control': 'no-store', 'accept-ranges': 'bytes' };
+  const range = /^bytes=(\\d*)-(\\d*)$/.exec(request.headers.get('range') || '');
+  if (range && (range[1] !== '' || range[2] !== '')) {
+    const size = bytes.length;
+    const start = range[1] === '' ? Math.max(0, size - Number(range[2])) : Number(range[1]);
+    const end = range[1] === '' || range[2] === '' ? size - 1 : Math.min(size - 1, Number(range[2]));
+    if (start > end || start >= size) return new Response('', { status: 416, headers: { 'content-range': 'bytes */' + size } });
+    return new Response(bytes.subarray(start, end + 1), {
+      status: 206,
+      headers: Object.assign(headers, { 'content-range': 'bytes ' + start + '-' + end + '/' + size }),
+    });
+  }
+  return new Response(bytes, { status: 200, headers });
+}
+
+function stateFile() {
+  return path.join(app.getPath('userData'), 'window-state.json');
+}
+
+function loadState() {
+  try {
+    return JSON.parse(fs.readFileSync(stateFile(), 'utf8'));
+  } catch (err) {
+    return {};
+  }
+}
+
+function saveState(win) {
+  try {
+    const bounds = win.getNormalBounds();
+    fs.writeFileSync(stateFile(), JSON.stringify({
+      x: bounds.x, y: bounds.y, width: bounds.width, height: bounds.height,
+      fullscreen: win.isFullScreen(),
+    }));
+  } catch (err) {
+    // Window placement is a convenience.
+  }
+}
+
+function buildMenu() {
+  if (process.platform !== 'darwin') return null;
+  return Menu.buildFromTemplate([
+    {
+      label: DISPLAY_NAME,
+      submenu: [
+        { role: 'about' },
+        { type: 'separator' },
+        { role: 'hide' },
+        { role: 'hideOthers' },
+        { role: 'unhide' },
+        { type: 'separator' },
+        { role: 'quit' },
+      ],
+    },
+    { label: 'View', submenu: [{ role: 'togglefullscreen' }] },
+    { role: 'windowMenu' },
+  ]);
+}
+
+function createWindow() {
+  const state = loadState();
+  const win = new BrowserWindow({
+    title: DISPLAY_NAME,
+    width: state.width || 1280,
+    height: state.height || 720,
+    x: typeof state.x === 'number' ? state.x : undefined,
+    y: typeof state.y === 'number' ? state.y : undefined,
+    minWidth: 640,
+    minHeight: 360,
+    show: false,
+    backgroundColor: '#000000',
+    autoHideMenuBar: true,
+    // Games open fullscreen; the player's own choice is remembered from then on.
+    fullscreen: CHECK_DIR ? false : state.fullscreen !== false,
+    webPreferences: {
+      preload: path.join(__dirname, 'preload.js'),
+      contextIsolation: true,
+      nodeIntegration: false,
+      sandbox: true,
+      backgroundThrottling: false,
+      autoplayPolicy: 'no-user-gesture-required',
+      spellcheck: false,
+    },
+  });
+  win.setMenuBarVisibility(false);
+  win.once('ready-to-show', () => win.show());
+
+  win.webContents.on('before-input-event', (event, input) => {
+    if (input.type !== 'keyDown') return;
+    if (input.key === 'F11' || (input.key === 'Enter' && input.alt)) {
+      win.setFullScreen(!win.isFullScreen());
+      event.preventDefault();
+    }
+  });
+  // Links leave the game for the system browser; nothing navigates the game's own window away.
+  win.webContents.setWindowOpenHandler(({ url }) => {
+    if (/^https?:\\/\\//.test(url)) shell.openExternal(url);
+    return { action: 'deny' };
+  });
+  win.webContents.on('will-navigate', (event, url) => {
+    if (!url.startsWith(SCHEME + '://')) {
+      event.preventDefault();
+      if (/^https?:\\/\\//.test(url)) shell.openExternal(url);
+    }
+  });
+  win.on('close', () => saveState(win));
+  win.loadURL(SCHEME + '://' + HOST + '/index.html');
+  return win;
+}
+
+app.on('second-instance', () => {
+  const win = BrowserWindow.getAllWindows()[0];
+  if (win) {
+    if (win.isMinimized()) win.restore();
+    win.focus();
+  }
+});
+
+app.whenReady().then(() => {
+  protocol.handle(SCHEME, serve);
+  // The game asks for nothing beyond fullscreen, pointer lock and gamepads.
+  session.defaultSession.setPermissionRequestHandler((_wc, permission, callback) => {
+    callback(['fullscreen', 'pointerLock', 'clipboard-sanitized-write'].includes(permission));
+  });
+  Menu.setApplicationMenu(buildMenu());
+  app.setAboutPanelOptions({ applicationName: DISPLAY_NAME, applicationVersion: ${JSON.stringify(identity.version)} });
+  ipcMain.on('bitmagic:quit', () => app.quit());
+  ipcMain.on('bitmagic:fullscreen', (event, on) => {
+    const win = BrowserWindow.fromWebContents(event.sender);
+    if (win) win.setFullScreen(on === true);
+  });
+  ipcMain.on('bitmagic:is-fullscreen', (event) => {
+    const win = BrowserWindow.fromWebContents(event.sender);
+    event.returnValue = win ? win.isFullScreen() : false;
+  });
+  createWindow();
+});
+
+app.on('window-all-closed', () => app.quit());
+`;
+}
+/**
+ * The page's view of the shell: feature-detectable as `window.bitmagicDesktop`, so a game can
+ * offer "Quit" and a fullscreen toggle only where they mean something.
+ */
+export const SHELL_PRELOAD_JS = `// Generated by \`bitmagic steam build\`.
+'use strict';
+
+const { contextBridge, ipcRenderer } = require('electron');
+
+contextBridge.exposeInMainWorld('bitmagicDesktop', {
+  platform: process.platform,
+  store: 'steam',
+  quit: () => ipcRenderer.send('bitmagic:quit'),
+  setFullscreen: (on) => ipcRenderer.send('bitmagic:fullscreen', on === true),
+  isFullscreen: () => ipcRenderer.sendSync('bitmagic:is-fullscreen'),
+});
+`;
+//# sourceMappingURL=shell-files.js.map

package/dist/steam/shell-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-files.js","sourceRoot":"","sources":["../../src/steam/shell-files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEvE,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC;AAUjC,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,YAAY,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAuB;IAC3D,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QACvB,IAAI,EAAE,QAAQ,CAAC,WAAW;QAC1B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,SAAS;KAChB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAuB;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO;;;;;;;uBAOc,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC;uBACpC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC;iBAC1C,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;eAC9B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;;eAE1B,IAAI;wBACK,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kFA4L6B,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;;;;;;;;;;;;;;CAcjH,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;CAY/B,CAAC"}

package/dist/steam/specs.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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.
+ */
+/** Which source picture an asset is cut from. */
+export type ArtSource = 'wide' | 'tall' | 'hero' | 'icon';
+export type LogoRule = 
+/** The game's logo must be on it and legible — every capsule. */
+'required'
+/** No text or logo at all — the library hero, the page background. */
+ | 'forbidden'
+/** The asset IS the logo, on a transparent background. */
+ | 'only';
+export interface SteamImageSpec {
+    id: string;
+    /** Relative to the store kit directory. */
+    file: string;
+    width: number;
+    height: number;
+    format: 'png' | 'jpg';
+    /** The picture it is cut from; null for the logo, which is the logo itself. */
+    art: ArtSource | null;
+    logo: LogoRule;
+    /** Required before the store page can be reviewed. */
+    required: boolean;
+    /** Where it is uploaded in Steamworks. */
+    where: string;
+    /** Valve's rule for it, in a line. */
+    rule: string;
+}
+export declare const STORE_IMAGE_SPECS: readonly SteamImageSpec[];
+/** The multi-size Windows icon and the macOS icon, written next to the shortcut icon. */
+export declare const SHORTCUT_ICO_FILE = "icons/shortcut_icon.ico";
+export declare 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 declare const LIBRARY_LOGO_BOX: {
+    readonly width: 1280;
+    readonly height: 720;
+};
+export declare const SCREENSHOT_WIDTH = 1920;
+export declare const SCREENSHOT_HEIGHT = 1080;
+/** Fewer than five and the store page cannot be submitted. */
+export declare const MIN_SCREENSHOTS = 5;
+/** Enough for a varied gallery without padding it with near-duplicates. */
+export declare const RECOMMENDED_SCREENSHOTS = 8;
+/** The icon sizes the Windows .ico and the macOS .icns carry. */
+export declare const ICO_SIZES: readonly [16, 24, 32, 48, 64, 128, 256];
+export declare const ICNS_SIZES: readonly [16, 32, 64, 128, 256, 512, 1024];
+/** Steam's trailer rules (partner.steamgames.com/doc/store/trailer). */
+export declare const TRAILER_RULES: {
+    readonly maxWidth: 1920;
+    readonly maxHeight: 1080;
+    readonly frameRates: readonly [30, 29.97, 60, 59.94];
+    readonly minBitrateKbps: 5000;
+    readonly containers: readonly ["mp4", "mov", "wmv"];
+};
+export declare function specById(id: string): SteamImageSpec | undefined;