@bitmagic/cli 0.1.0

package/dist/scaffold/project-files.js

@@ -0,0 +1,225 @@
+import { tsconfigPaths, importMapEntries, viteAliasEntries } from './aliases.js';
+/** Mirrors game/package.json so the pro lane resolves exactly what CI builds against. */
+const DEPENDENCIES = {
+    '@dimforge/rapier2d-compat': '^0.19.3',
+    '@dimforge/rapier3d-compat': '^0.19.3',
+    '@msgpack/msgpack': '^3.1.3',
+    fflate: '^0.8.2',
+    i18next: '^24.2.3',
+    'i18next-browser-languagedetector': '^8.0.4',
+    jszip: '^3.10.1',
+    three: '^0.183.0',
+};
+const DEV_DEPENDENCIES = {
+    '@types/node': '^24.10.0',
+    '@types/three': '^0.183.0',
+    // engine/types/ammo.d.ts opens with a triple-slash reference to this package's ambient types.
+    'ammojs-typed': '^1.0.6',
+    typescript: '^5.9.2',
+    vite: '^7.3.1',
+};
+/** Resolved in the browser from a CDN, not from node_modules — see the design's import-map note. */
+const CDN_IMPORTS = {
+    three: 'https://esm.sh/three@0.182.0',
+    'three/': 'https://esm.sh/three@0.182.0/',
+    '@dimforge/rapier3d-compat': 'https://esm.sh/@dimforge/rapier3d-compat@0.19.3',
+    '@dimforge/rapier2d-compat': 'https://esm.sh/@dimforge/rapier2d-compat@0.19.3',
+    i18next: 'https://esm.sh/i18next@24.2.3',
+    'i18next-browser-languagedetector': 'https://esm.sh/i18next-browser-languagedetector@8.0.4',
+    '@msgpack/msgpack': 'https://esm.sh/@msgpack/msgpack@3.1.3',
+    fflate: 'https://esm.sh/fflate@0.8.2',
+};
+/** Every JSON file the scaffold writes is 2-space indented and newline-terminated. */
+function renderJson(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+export function renderPackageJson(name) {
+    return renderJson({
+        name,
+        version: '0.1.0',
+        private: true,
+        type: 'module',
+        scripts: {
+            build: 'tsc',
+            check: 'tsc --noEmit',
+            dev: 'vite',
+        },
+        dependencies: DEPENDENCIES,
+        devDependencies: DEV_DEPENDENCIES,
+    });
+}
+export function renderTsconfig() {
+    return renderJson({
+        compilerOptions: {
+            target: 'es2020',
+            module: 'es2020',
+            lib: ['es2020', 'dom'],
+            rootDir: '.',
+            outDir: 'dist',
+            baseUrl: '.',
+            paths: tsconfigPaths(),
+            moduleResolution: 'bundler',
+            strict: true,
+            noUncheckedIndexedAccess: true,
+            exactOptionalPropertyTypes: false,
+            verbatimModuleSyntax: true,
+            isolatedModules: true,
+            moduleDetection: 'force',
+            skipLibCheck: true,
+            esModuleInterop: true,
+            allowSyntheticDefaultImports: true,
+            forceConsistentCasingInFileNames: true,
+            noImplicitAny: true,
+            resolveJsonModule: true,
+            sourceMap: true,
+            types: [],
+            typeRoots: ['engine/types', 'node_modules/@types', 'node_modules/ammojs-typed/ammo/ambient'],
+        },
+        include: ['src/**/*', 'engine/**/*'],
+        // The vendored engine ships its own __tests__/ directories; a scaffolded project never
+        // installs jest, so compiling them fails on missing test-runner globals (describe/it).
+        // engine/bundle/**/* mirrors game/tsconfig.json's exclusion of src/bundle/**/*: the
+        // monorepo's own CI does not typecheck that tree, so the scaffold must not hold it to a
+        // stricter standard than the repo it was vendored from.
+        exclude: [
+            'node_modules',
+            'dist',
+            'engine/**/*.test.ts',
+            'engine/**/__tests__/**/*',
+            'src/**/*.test.ts',
+            'src/**/__tests__/**/*',
+            'engine/bundle/**/*',
+        ],
+    });
+}
+export function renderIndexHtml() {
+    const aliasImports = importMapEntries();
+    const imports = { ...CDN_IMPORTS, ...aliasImports };
+    // Derived from the same alias model as the import map above, not a hardcoded literal, so the
+    // two cannot drift: the entry point is the engine's import-map target plus its filename.
+    const engineEntryPoint = `${aliasImports['engine/']}GameTemplate.js`;
+    // The #game-container div below is required, not decorative: GameTemplate.ts (:196, :457)
+    // does document.getElementById('game-container') as HTMLElement, and GameEngine.ts (:557)
+    // appendChild()s into it. The "as HTMLElement" cast erases the null a missing div would
+    // produce, so its absence typechecks clean and only fails at runtime. The CSS rule mirrors
+    // game/index.html's #game-container rule verbatim.
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
+    <title>Bitmagic Game</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        html, body { width: 100%; height: 100%; overflow: hidden; background: #000; }
+        html, body { touch-action: none; }
+        canvas { display: block; }
+        #game-container {
+            position: fixed;
+            top: 0;
+            left: 0;
+            width: 100%;
+            height: 100%;
+            background: #000;
+        }
+    </style>
+</head>
+<body>
+    <div id="game-container"></div>
+
+    <!-- Static import map: must come before any module script. Third-party packages resolve
+         from a CDN at runtime; node_modules exists for tsc, not for the browser. -->
+    <script type="importmap">
+${JSON.stringify({ imports }, null, 8).replace(/^/gm, '    ')}
+    </script>
+
+    <script type="module" src="${engineEntryPoint}"></script>
+</body>
+</html>
+`;
+}
+export function renderViteConfig() {
+    const entries = Object.entries(viteAliasEntries())
+        .map(([key, target]) => `      '${key}': '${target}'`)
+        .join(',\n');
+    return `import { defineConfig } from 'vite';
+
+// Aliases mirror tsconfig paths but point at the COMPILED output: tsc emits to dist/ and the
+// browser loads the emitted JavaScript. Keep these in step with tsconfig.json.
+export default defineConfig({
+  root: '.',
+  base: '/',
+  cacheDir: '.vite-cache',
+  assetsInclude: ['**/*.wasm'],
+  resolve: {
+    alias: {
+${entries}
+    }
+  },
+  server: {
+    port: 3001
+  }
+});
+`;
+}
+export function renderGitignore() {
+    return ['dist/', 'node_modules/', '.bitmagic/', '.vite-cache/', ''].join('\n');
+}
+export function renderBitmagicJson(metadata) {
+    return renderJson(metadata);
+}
+export function renderAgentsMd() {
+    return `# Working on this Bitmagic game
+
+## Layout
+
+- \`src/work/\` — **your game.** Everything you write lives here. \`Game.ts\` is the entry
+  point; \`game.json\` and \`world.json\` hold configuration and scene data. The \`work\`
+  directory name is load-bearing: the engine loads game data by fetching the literal path
+  \`src/work/world.json\`, not through an import or an alias, so renaming or moving this
+  directory breaks the game at runtime even though it still typechecks.
+- \`engine/\` — **the Bitmagic engine, read-only.** It is vendored by the CLI and replaced
+  wholesale by \`bitmagic upgrade\`. Edits here are lost on upgrade and ignored on publish.
+- \`engine/docs/\` — the engine's deep-dive documentation. Read it before guessing.
+
+\`engine/types/work-game.d.ts\` declares \`module 'work/Game.js'\`, which is how the engine
+imports your game. Renaming or removing the \`VoxelGame\` export from \`src/work/Game.ts\` still
+typechecks against that declaration — it only fails at runtime, when the engine actually loads
+the module and finds the export missing.
+
+## Imports
+
+Engine code is reached through path aliases, not relative paths:
+
+\`\`\`ts
+import { PlayerController } from 'engine/PlayerController.js';
+import type { GameData } from 'types/game.js';
+\`\`\`
+
+Always include the \`.js\` extension, even in TypeScript.
+
+## Before you change movement, cameras or rotation
+
+Read \`engine/docs/coordinate-system.md\`. Gameplay faces **+Z** while cameras face **−Z**, and
+the two yaw conventions differ. Guessing produces code that compiles and moves the wrong way.
+
+## Checking your work
+
+\`\`\`
+bitmagic check     # typecheck against the vendored engine
+\`\`\`
+
+The engine is large; \`check\` is the fast way to find out whether an edit holds together.
+`;
+}
+export function renderClaudeMd() {
+    return '@AGENTS.md\n';
+}
+export function renderSkillsReadme() {
+    return `# Claude Code skills
+
+Claude Code skills placed in this directory apply to this project. See \`AGENTS.md\` at the
+project root for the guidance an agent should read before editing this game.
+`;
+}
+//# sourceMappingURL=project-files.js.map

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

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

package/dist/scaffold/project.d.ts

@@ -0,0 +1,28 @@
+import { type ProjectMetadata } from './project-files.js';
+export interface TemplateEntry {
+    id: string;
+    genre: string;
+    recommended?: boolean;
+}
+/**
+ * Directories moved out of the extracted tree into the project's vendored engine/.
+ *
+ * genres/ is vendored here for the engine's own debug tooling (see aliases.ts), which is a
+ * separate concern from src/ below, which is *derived* from genres/ for the creator's game.
+ * Both exist side by side, same as the real game project's src/genres/ and src/work/.
+ *
+ * Exported so tests can build their fixture from this list instead of hand-maintaining a
+ * parallel copy that silently goes stale when an entry is added here.
+ */
+export declare const VENDORED_DIRS: string[];
+export declare function resolveTemplate(templatesDir: string, requestedId?: string): TemplateEntry;
+export interface ScaffoldOptions {
+    targetDir: string;
+    /** Where extractEngine unpacked game/src/* and game/docs. */
+    extractedEngineDir: string;
+    templatesDir: string;
+    template: TemplateEntry;
+    metadata: ProjectMetadata;
+    projectName: string;
+}
+export declare function scaffoldProject(options: ScaffoldOptions): void;

package/dist/scaffold/project.js

@@ -0,0 +1,118 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { CliError } from '../errors.js';
+import { aliasSourceDir } from './aliases.js';
+import { renderPackageJson, renderTsconfig, renderIndexHtml, renderViteConfig, renderGitignore, renderBitmagicJson, renderAgentsMd, renderClaudeMd, renderSkillsReadme, } from './project-files.js';
+/**
+ * Directories moved out of the extracted tree into the project's vendored engine/.
+ *
+ * genres/ is vendored here for the engine's own debug tooling (see aliases.ts), which is a
+ * separate concern from src/ below, which is *derived* from genres/ for the creator's game.
+ * Both exist side by side, same as the real game project's src/genres/ and src/work/.
+ *
+ * Exported so tests can build their fixture from this list instead of hand-maintaining a
+ * parallel copy that silently goes stale when an entry is added here.
+ */
+export const VENDORED_DIRS = [
+    'engine',
+    'types',
+    'bundle',
+    'debug',
+    'editor',
+    'genres',
+    'docs',
+    'utils',
+    'core',
+];
+export function resolveTemplate(templatesDir, requestedId) {
+    const indexPath = path.join(templatesDir, 'index.json');
+    let raw;
+    try {
+        raw = fs.readFileSync(indexPath, 'utf-8');
+    }
+    catch {
+        throw new CliError(`The engine bundle has no template index at ${indexPath}.`);
+    }
+    const parsed = JSON.parse(raw);
+    const templates = parsed?.templates ?? [];
+    // One guard covers both "the index is empty" and "no template is marked recommended": `first`
+    // doubles as the fallback for the no-id case below.
+    const [first] = templates;
+    if (!first) {
+        throw new CliError('The engine bundle lists no templates.');
+    }
+    if (requestedId === undefined) {
+        return templates.find((t) => t.recommended) ?? first;
+    }
+    const match = templates.find((t) => t.id === requestedId);
+    if (!match) {
+        throw new CliError(`Unknown template "${requestedId}". Available templates: ${templates.map((t) => t.id).join(', ')}.`);
+    }
+    return match;
+}
+/** Copies a directory's CONTENTS into dest, creating dest if needed. */
+function copyContents(source, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(source)) {
+        fs.cpSync(path.join(source, entry), path.join(dest, entry), { recursive: true });
+    }
+}
+export function scaffoldProject(options) {
+    const { targetDir, extractedEngineDir, templatesDir, template, metadata, projectName } = options;
+    const engineDir = path.join(targetDir, 'engine');
+    fs.mkdirSync(engineDir, { recursive: true });
+    for (const dir of VENDORED_DIRS) {
+        const source = path.join(extractedEngineDir, dir);
+        if (!fs.existsSync(source)) {
+            throw new CliError(`The engine bundle has no "${dir}" directory at ${source}. The tarball is incomplete or corrupt.`);
+        }
+        fs.cpSync(source, path.join(engineDir, dir), { recursive: true });
+    }
+    // The game: the genre baseline, then the template overlaid on top. Contents are copied, not
+    // the directory itself — a nested src/work/<genre>/ would break every relative import in
+    // Game.ts. This is a second copy of the same baseline vendored above as engine/genres/: that
+    // copy feeds the engine's debug tooling, this one seeds the creator's game.
+    //
+    // Derived from the 'work' alias rather than restated as a literal, so this can't drift from
+    // aliases.ts's sourceDir — which must stay 'src/work' because worldDataLoader.ts fetches that
+    // literal path (see the comment there). copyContents creates parent directories, so the
+    // intermediate src/ appears for free.
+    const srcDir = path.join(targetDir, aliasSourceDir('work'));
+    const genreDir = path.join(extractedEngineDir, 'genres', template.genre);
+    if (!fs.existsSync(genreDir)) {
+        throw new CliError(`The engine bundle has no baseline for genre "${template.genre}".`);
+    }
+    copyContents(genreDir, srcDir);
+    const overlayDir = path.join(templatesDir, template.id, 'source');
+    if (fs.existsSync(overlayDir)) {
+        copyContents(overlayDir, srcDir);
+    }
+    // AutoCacheBuster.ts registers this service worker at the absolute path
+    // /sw-cache-buster.js, so it must be served from the project root, not vendored under
+    // engine/ — a service worker cannot control scopes above its own path. Unlike VENDORED_DIRS
+    // above, a missing file here is not treated as a corrupt tarball: every tarball published
+    // before this feature shipped lacks it, and `init` must keep scaffolding against those.
+    const serviceWorker = path.join(extractedEngineDir, 'sw-cache-buster.js');
+    if (fs.existsSync(serviceWorker)) {
+        fs.cpSync(serviceWorker, path.join(targetDir, 'sw-cache-buster.js'));
+    }
+    const files = [
+        ['package.json', renderPackageJson(projectName)],
+        ['tsconfig.json', renderTsconfig()],
+        ['vite.config.js', renderViteConfig()],
+        ['index.html', renderIndexHtml()],
+        ['bitmagic.json', renderBitmagicJson(metadata)],
+        ['AGENTS.md', renderAgentsMd()],
+        ['CLAUDE.md', renderClaudeMd()],
+        ['.gitignore', renderGitignore()],
+        ['.claude/skills/README.md', renderSkillsReadme()],
+    ];
+    for (const [name, contents] of files) {
+        const filePath = path.join(targetDir, name);
+        // .claude/skills/README.md nests two directories deep; every other entry is a top-level
+        // file, for which mkdir on the already-existing targetDir is a harmless no-op.
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, contents);
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/scaffold/project.js.map

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

package/dist/verify/browser.d.ts

@@ -0,0 +1,13 @@
+import type { VerifyObservations } from './classify.js';
+export interface HeadlessCheckOptions {
+    url: string;
+    screenshotPath: string;
+    consolePath: string;
+    /** How long to let the game settle after load before observing. */
+    settleMs: number;
+}
+/**
+ * Drives the creator's installed Chrome. `channel: 'chrome'` deliberately uses the system
+ * browser rather than a downloaded one, so installing the CLI stays a small, fast npm install.
+ */
+export declare function runHeadlessCheck(options: HeadlessCheckOptions): Promise<VerifyObservations>;

package/dist/verify/browser.js

@@ -0,0 +1,75 @@
+import * as fs from 'fs';
+import { chromium } from 'playwright-core';
+import { CliError } from '../errors.js';
+/**
+ * Drives the creator's installed Chrome. `channel: 'chrome'` deliberately uses the system
+ * browser rather than a downloaded one, so installing the CLI stays a small, fast npm install.
+ */
+export async function runHeadlessCheck(options) {
+    let browser;
+    try {
+        browser = await chromium.launch({ headless: true, channel: 'chrome' });
+    }
+    catch {
+        // Not a game failure. Saying so plainly matters: an agent told "verification failed" would
+        // start editing game code to fix a missing browser.
+        throw new CliError('Could not launch Google Chrome. `bitmagic verify` drives the Chrome installed on this ' +
+            'machine — install it from https://www.google.com/chrome/ and run verify again.');
+    }
+    // Declared outside the try so the `finally` below can write whatever was captured even if the
+    // browser phase throws (e.g. page.goto timing out) — artifacts are the point of a failing run.
+    const consoleLines = [];
+    const pageErrors = [];
+    try {
+        const context = await browser.newContext({ viewport: { width: 1280, height: 720 } });
+        const page = await context.newPage();
+        page.on('console', (message) => consoleLines.push(`${message.type()}: ${message.text()}`));
+        page.on('pageerror', (error) => pageErrors.push(error.message));
+        page.on('requestfailed', (request) => consoleLines.push(`requestfailed: ${request.url()} ${request.failure()?.errorText ?? ''}`));
+        try {
+            await page.goto(options.url, { waitUntil: 'load', timeout: 45_000 });
+        }
+        catch (error) {
+            // Best-effort screenshot of whatever the page shows right now — often still blank, but
+            // worth having. The console log (written in `finally` below) is the useful artifact here.
+            try {
+                fs.writeFileSync(options.screenshotPath, await page.screenshot());
+            }
+            catch {
+                // Page may already be unusable (closed context, crashed renderer) — nothing to save.
+            }
+            const detail = error instanceof Error ? error.message : String(error);
+            throw new CliError(`The page never finished loading at ${options.url}: ${detail}`);
+        }
+        await page.waitForTimeout(options.settleMs);
+        const canvas = await page.evaluate(() => {
+            // This callback runs inside the browser Playwright drives, not in the CLI's Node process,
+            // so `document` is a real global there even though the CLI's eslint config declares no
+            // DOM globals for the process it actually lints.
+            // eslint-disable-next-line no-undef
+            const element = document.querySelector('#game-container canvas');
+            if (!(element instanceof HTMLCanvasElement))
+                return null;
+            const rect = element.getBoundingClientRect();
+            return {
+                width: Math.round(rect.width),
+                height: Math.round(rect.height),
+                // The drawing-buffer attributes, not CSS size — see CanvasObservation in classify.ts for
+                // why this replaced a getContext() probe.
+                bufferWidth: element.width,
+                bufferHeight: element.height,
+            };
+        });
+        const screenshotBuffer = await page.screenshot();
+        fs.writeFileSync(options.screenshotPath, screenshotBuffer);
+        return { consoleLines, pageErrors, canvas, screenshotBytes: screenshotBuffer.length };
+    }
+    finally {
+        // Written on success and failure alike, including when the try block above threw before
+        // ever reaching the screenshot: the console log is the most useful thing a creator or their
+        // agent can look at when the page never came up at all.
+        fs.writeFileSync(options.consolePath, [...consoleLines, ...pageErrors.map((e) => `pageerror: ${e}`)].join('\n'));
+        await browser.close();
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/verify/browser.js.map

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

package/dist/verify/classify.d.ts

@@ -0,0 +1,29 @@
+export interface CanvasObservation {
+    /** CSS pixel size from getBoundingClientRect() — whether the canvas is visible/laid out. */
+    width: number;
+    height: number;
+    /**
+     * canvas.width / canvas.height — the drawing-buffer *attributes*, not CSS size. A `<canvas>`
+     * nobody has touched keeps the HTML defaults (300x150); a renderer that actually claims the
+     * canvas resizes these to the real framebuffer dimensions. This is deliberately not a
+     * getContext() probe: getContext() itself creates a context — even 'webgpu' on a page with no
+     * navigator.gpu — whether or not anything ever renders into it, which is why that used to be
+     * checked and always passed.
+     */
+    bufferWidth: number;
+    bufferHeight: number;
+}
+export interface VerifyObservations {
+    /** Console lines, each prefixed with its type, e.g. `error: …`. */
+    consoleLines: string[];
+    pageErrors: string[];
+    canvas: CanvasObservation | null;
+    /** Byte length of the PNG screenshot taken after settling. */
+    screenshotBytes: number;
+}
+export interface VerifyResult {
+    ok: boolean;
+    failures: string[];
+    warnings: string[];
+}
+export declare function classifyVerifyRun(observations: VerifyObservations): VerifyResult;

package/dist/verify/classify.js

@@ -0,0 +1,59 @@
+/** Engine messages that mean the game did not come up. */
+const FATAL_CONSOLE = [
+    'world.json not found',
+    'Invalid content type',
+    'Failed to load game in standalone mode',
+    'Failed to load game in template',
+];
+/** Present in a healthy boot. Absence is suspicious but not proof of failure — these strings are
+ *  engine-owned and may change between versions, so they warn rather than fail. */
+const EXPECTED_MARKERS = ['Loaded world.json', 'Merged game data ready'];
+/** An untouched <canvas> keeps these HTML defaults; a renderer that ever called setSize()
+ *  resizes the drawing buffer away from them. */
+const UNTOUCHED_CANVAS_WIDTH = 300;
+const UNTOUCHED_CANVAS_HEIGHT = 150;
+/**
+ * A uniformly black (or otherwise empty) 1280x720 PNG compresses to a few KB — measured at
+ * ~4.3KB for both an untouched 300x150 canvas and a canvas resized to 1280x720 but never drawn
+ * into. A real rendered frame from this engine is on the order of hundreds of KB (~245KB on a
+ * healthy `verify` run). 20KB sits with generous headroom above the blank case and well below a
+ * real frame — a smoke signal, not a pixel assertion.
+ */
+const MIN_SCREENSHOT_BYTES = 20_000;
+export function classifyVerifyRun(observations) {
+    const failures = [];
+    const warnings = [];
+    for (const error of observations.pageErrors) {
+        failures.push(`Uncaught error on the page: ${error}`);
+    }
+    const { canvas } = observations;
+    if (!canvas) {
+        failures.push('No <canvas> was rendered inside #game-container — the game did not start.');
+    }
+    else {
+        if (canvas.width === 0 || canvas.height === 0) {
+            failures.push(`The canvas has no size (${canvas.width}x${canvas.height}).`);
+        }
+        if (canvas.bufferWidth === UNTOUCHED_CANVAS_WIDTH && canvas.bufferHeight === UNTOUCHED_CANVAS_HEIGHT) {
+            failures.push(`The canvas was never resized by a renderer (still the ${UNTOUCHED_CANVAS_WIDTH}x` +
+                `${UNTOUCHED_CANVAS_HEIGHT} HTML default) — nothing claimed it.`);
+        }
+    }
+    if (observations.screenshotBytes < MIN_SCREENSHOT_BYTES) {
+        failures.push(`The screenshot is implausibly small (${observations.screenshotBytes} bytes) — the frame ` +
+            'looks blank.');
+    }
+    for (const line of observations.consoleLines) {
+        const fatal = FATAL_CONSOLE.find((f) => line.includes(f));
+        if (fatal)
+            failures.push(`The engine reported: ${line}`);
+    }
+    const joined = observations.consoleLines.join('\n');
+    for (const marker of EXPECTED_MARKERS) {
+        if (!joined.includes(marker)) {
+            warnings.push(`Expected "${marker}" in the console and did not see it.`);
+        }
+    }
+    return { ok: failures.length === 0, failures, warnings };
+}
+//# sourceMappingURL=classify.js.map

package/dist/verify/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/verify/classify.ts"],"names":[],"mappings":"AA+BA,0DAA0D;AAC1D,MAAM,aAAa,GAAG;IACpB,sBAAsB;IACtB,sBAAsB;IACtB,wCAAwC;IACxC,iCAAiC;CAClC,CAAC;AAEF;mFACmF;AACnF,MAAM,gBAAgB,GAAG,CAAC,mBAAmB,EAAE,wBAAwB,CAAC,CAAC;AAEzE;iDACiD;AACjD,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC,MAAM,UAAU,iBAAiB,CAAC,YAAgC;IAChE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,YAAY,CAAC,UAAU,EAAE,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,+BAA+B,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IAC7F,CAAC;SAAM,CAAC;QACN,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,KAAK,sBAAsB,IAAI,MAAM,CAAC,YAAY,KAAK,uBAAuB,EAAE,CAAC;YACrG,QAAQ,CAAC,IAAI,CACX,yDAAyD,sBAAsB,GAAG;gBAChF,GAAG,uBAAuB,sCAAsC,CACnE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,YAAY,CAAC,eAAe,GAAG,oBAAoB,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,CACX,wCAAwC,YAAY,CAAC,eAAe,sBAAsB;YACxF,cAAc,CACjB,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,KAAK;YAAE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,aAAa,MAAM,sCAAsC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC3D,CAAC"}

package/dist/verify/wait-for-server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Polls `http://localhost:<port>/` until it answers or `timeoutMs` elapses. Shared by `verify`
+ * (waiting on its throwaway vite instance) and `dev` (announcing its own once it's ready) — kept
+ * dependency-free so importing it doesn't pull playwright-core into `dev`, which never touches a
+ * browser.
+ */
+export declare function waitForServer(port: number, timeoutMs: number): Promise<void>;

package/dist/verify/wait-for-server.js

@@ -0,0 +1,25 @@
+import { CliError } from '../errors.js';
+/**
+ * Polls `http://localhost:<port>/` until it answers or `timeoutMs` elapses. Shared by `verify`
+ * (waiting on its throwaway vite instance) and `dev` (announcing its own once it's ready) — kept
+ * dependency-free so importing it doesn't pull playwright-core into `dev`, which never touches a
+ * browser.
+ */
+export async function waitForServer(port, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        try {
+            const response = await fetch(`http://localhost:${port}/`);
+            if (response.ok)
+                return;
+        }
+        catch {
+            // Not up yet; fall through to the retry delay.
+        }
+        if (Date.now() > deadline) {
+            throw new CliError(`The dev server did not start on port ${port} within ${timeoutMs}ms.`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, 250));
+    }
+}
+//# sourceMappingURL=wait-for-server.js.map

package/dist/verify/wait-for-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-server.js","sourceRoot":"","sources":["../../src/verify/wait-for-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,SAAiB;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAC;YAC1D,IAAI,QAAQ,CAAC,EAAE;gBAAE,OAAO;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,QAAQ,CAAC,wCAAwC,IAAI,WAAW,SAAS,KAAK,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}