@freegamestore/cli 0.1.4

package/dist/commands/publish.test.js

@@ -0,0 +1,166 @@
+import { describe, it, expect } from 'vitest';
+import { parseGitHubRepo, buildSubmissionUrl, resolveCategory, resolveType, resolveFromFlags, buildPromptList, } from './publish.js';
+describe('parseGitHubRepo', () => {
+    it('parses HTTPS clone URLs', () => {
+        expect(parseGitHubRepo('https://github.com/foo/bar')).toBe('foo/bar');
+        expect(parseGitHubRepo('https://github.com/foo/bar.git')).toBe('foo/bar');
+        expect(parseGitHubRepo('https://github.com/foo/bar/')).toBe('foo/bar');
+        expect(parseGitHubRepo('https://github.com/foo/bar.git/')).toBe('foo/bar');
+    });
+    it('parses SSH clone URLs', () => {
+        expect(parseGitHubRepo('git@github.com:foo/bar.git')).toBe('foo/bar');
+        expect(parseGitHubRepo('git@github.com:foo/bar')).toBe('foo/bar');
+    });
+    it('allows dots in repo names (e.g. node.js, foo.config)', () => {
+        expect(parseGitHubRepo('https://github.com/nodejs/node.js')).toBe('nodejs/node.js');
+        expect(parseGitHubRepo('git@github.com:nodejs/node.js.git')).toBe('nodejs/node.js');
+    });
+    it('allows hyphens, underscores, and digits', () => {
+        expect(parseGitHubRepo('https://github.com/foo-bar/baz_qux-2')).toBe('foo-bar/baz_qux-2');
+    });
+    it('returns null for non-GitHub URLs', () => {
+        expect(parseGitHubRepo('https://gitlab.com/foo/bar')).toBeNull();
+        expect(parseGitHubRepo('https://example.com/repo')).toBeNull();
+        expect(parseGitHubRepo('not a url')).toBeNull();
+        expect(parseGitHubRepo('')).toBeNull();
+    });
+});
+describe('buildSubmissionUrl', () => {
+    const baseInput = {
+        name: 'my-app',
+        category: 'Productivity',
+        type: 'Standalone (no backend, localStorage only)',
+        oneliner: 'A quick way to track tasks',
+        description: 'Detailed description here.',
+        repo: null,
+        demo: null,
+    };
+    it('builds a github.com submission URL with the right template', () => {
+        const url = new URL(buildSubmissionUrl(baseInput));
+        expect(url.host).toBe('github.com');
+        expect(url.pathname).toBe('/freeappstore-online/submissions/issues/new');
+        expect(url.searchParams.get('template')).toBe('app-submission.yml');
+    });
+    it('prefills every required template field', () => {
+        const url = new URL(buildSubmissionUrl(baseInput));
+        expect(url.searchParams.get('name')).toBe('my-app');
+        expect(url.searchParams.get('category')).toBe('Productivity');
+        expect(url.searchParams.get('type')).toBe(baseInput.type);
+        expect(url.searchParams.get('oneliner')).toBe('A quick way to track tasks');
+        expect(url.searchParams.get('description')).toBe('Detailed description here.');
+        expect(url.searchParams.get('title')).toBe('[Submission] my-app');
+    });
+    it('includes repo when present, omits when null', () => {
+        const withRepo = new URL(buildSubmissionUrl({ ...baseInput, repo: 'https://github.com/me/x' }));
+        expect(withRepo.searchParams.get('repo')).toBe('https://github.com/me/x');
+        const without = new URL(buildSubmissionUrl(baseInput));
+        expect(without.searchParams.has('repo')).toBe(false);
+    });
+    it('includes demo when present, omits when null', () => {
+        const withDemo = new URL(buildSubmissionUrl({ ...baseInput, demo: 'https://demo.example' }));
+        expect(withDemo.searchParams.get('demo')).toBe('https://demo.example');
+        const without = new URL(buildSubmissionUrl(baseInput));
+        expect(without.searchParams.has('demo')).toBe(false);
+    });
+    it('properly URL-encodes special characters in description', () => {
+        const url = new URL(buildSubmissionUrl({
+            ...baseInput,
+            description: 'A "quoted" thing & more (with parens)',
+        }));
+        expect(url.searchParams.get('description')).toBe('A "quoted" thing & more (with parens)');
+    });
+});
+describe('resolveCategory', () => {
+    it('matches exact label', () => {
+        expect(resolveCategory('Productivity')).toBe('Productivity');
+    });
+    it('matches case-insensitive', () => {
+        expect(resolveCategory('utilities')).toBe('Utilities');
+        expect(resolveCategory('UTILITIES')).toBe('Utilities');
+        expect(resolveCategory('  Brain Training  ')).toBe('Brain Training');
+    });
+    it('matches "other" short form', () => {
+        expect(resolveCategory('other')).toBe('Other (specify in description)');
+    });
+    it('returns null for unknown', () => {
+        expect(resolveCategory('nope')).toBeNull();
+        expect(resolveCategory('')).toBeNull();
+    });
+});
+describe('resolveType', () => {
+    it('matches short forms', () => {
+        expect(resolveType('standalone')).toBe('Standalone (no backend, localStorage only)');
+        expect(resolveType('connected')).toBe('Connected (Firebase/Supabase backend, shared with Pro version)');
+    });
+    it('matches case-insensitive full label', () => {
+        expect(resolveType('STANDALONE')).toBe('Standalone (no backend, localStorage only)');
+    });
+    it('returns null for unknown', () => {
+        expect(resolveType('something')).toBeNull();
+    });
+});
+describe('resolveFromFlags', () => {
+    it('returns empty values when no flags supplied', () => {
+        const r = resolveFromFlags({});
+        expect(r.values).toEqual({});
+        expect(r.errors).toEqual([]);
+    });
+    it('resolves valid combinations', () => {
+        const r = resolveFromFlags({
+            name: 'my-app',
+            category: 'utilities',
+            type: 'standalone',
+            oneliner: 'Does a thing',
+            demo: 'https://demo.example',
+        });
+        expect(r.errors).toEqual([]);
+        expect(r.values.name).toBe('my-app');
+        expect(r.values.category).toBe('Utilities');
+        expect(r.values.type).toBe('Standalone (no backend, localStorage only)');
+        expect(r.values.oneliner).toBe('Does a thing');
+        expect(r.values.demo).toBe('https://demo.example');
+    });
+    it('treats blank --demo as null', () => {
+        const r = resolveFromFlags({ demo: '   ' });
+        expect(r.values.demo).toBeNull();
+    });
+    it('rejects invalid app id', () => {
+        const r = resolveFromFlags({ name: 'BadName' });
+        expect(r.errors[0]).toMatch(/--name/);
+        expect(r.values.name).toBeUndefined();
+    });
+    it('rejects unknown category and type', () => {
+        const r = resolveFromFlags({ category: 'nope', type: 'foo' });
+        expect(r.errors).toHaveLength(2);
+    });
+    it('rejects empty oneliner', () => {
+        const r = resolveFromFlags({ oneliner: '   ' });
+        expect(r.errors[0]).toMatch(/oneliner/);
+    });
+});
+describe('buildPromptList', () => {
+    const defaults = { appName: null, description: null };
+    it('returns all 5 prompts when nothing resolved', () => {
+        expect(buildPromptList({}, defaults).map((p) => p.name)).toEqual([
+            'name',
+            'category',
+            'type',
+            'oneliner',
+            'demo',
+        ]);
+    });
+    it('skips a prompt when its value is already resolved', () => {
+        const list = buildPromptList({ name: 'my-app', category: 'Utilities', type: 'Standalone (no backend, localStorage only)' }, defaults);
+        expect(list.map((p) => p.name)).toEqual(['oneliner', 'demo']);
+    });
+    it('returns empty list when everything resolved', () => {
+        expect(buildPromptList({
+            name: 'x',
+            category: 'Utilities',
+            type: 'Standalone (no backend, localStorage only)',
+            oneliner: 'y',
+            demo: null,
+        }, defaults)).toEqual([]);
+    });
+});
+//# sourceMappingURL=publish.test.js.map

package/dist/commands/publish.test.js.map

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

package/dist/commands/screencheck.d.ts

@@ -0,0 +1,36 @@
+import { Command } from 'commander';
+interface ViewportTest {
+    label: string;
+    width: number;
+    height: number;
+}
+export declare const screencheckCommand: Command;
+interface ViewportTestExpanded extends ViewportTest {
+    share: number;
+    orientation: 'portrait' | 'landscape';
+}
+/**
+ * Pick the full reference matrix to test, gated by manifest orientation.
+ * For orientation='any', test both. For 'portrait'/'landscape', test only
+ * that side. Sizes below `minWidth` are still tested — failing below the
+ * declared min is *expected*, but if it passes, the creator can claim a
+ * wider device coverage than they declared.
+ */
+export declare function pickTests(minWidth: number, orientation: string): ViewportTest[];
+export declare function pickMatrix(_minWidth: number, orientation: string): ViewportTestExpanded[];
+/**
+ * Given the matrix and pass/fail per size, compute device coverage.
+ * Coverage = max share among passing widths, per orientation.
+ *
+ * Why max(share): share is cumulative-from-this-width-up. The smallest
+ * passing width has the highest share; passing larger widths is implied
+ * by passing the smallest. We pick the lowest passing width's share.
+ */
+export declare function computeCoverage(matrix: ViewportTestExpanded[], passing: Set<string>): {
+    portrait: number;
+    landscape: number;
+    overall: number;
+    brokenSizes: ViewportTestExpanded[];
+};
+export {};
+//# sourceMappingURL=screencheck.d.ts.map

package/dist/commands/screencheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screencheck.d.ts","sourceRoot":"","sources":["../../src/commands/screencheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkDpC,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAoCD,eAAO,MAAM,kBAAkB,SAyI3B,CAAC;AAgCL,UAAU,oBAAqB,SAAQ,YAAY;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAM/E;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,oBAAoB,EAAE,CA4BzF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,oBAAoB,EAAE,EAC9B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,oBAAoB,EAAE,CAAA;CAAE,CAsB/F"}

package/dist/commands/screencheck.js

@@ -0,0 +1,428 @@
+import { Command } from 'commander';
+import { spawn } from 'node:child_process';
+import { createServer } from 'node:http';
+import { readFile, stat } from 'node:fs/promises';
+import { extname, join, resolve, normalize } from 'node:path';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+const DEFAULT_PORT = 4571;
+const MIME = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'application/javascript; charset=utf-8',
+    '.mjs': 'application/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+    '.txt': 'text/plain; charset=utf-8',
+    '.webp': 'image/webp',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+};
+export const screencheckCommand = new Command('screencheck')
+    .description('Run a real browser at the manifest-declared viewport in portrait + landscape and verify the app fits without scrolling.')
+    .option('--dir <path>', 'Repo dir to check (defaults to cwd).', process.cwd())
+    .option('--port <n>', `Static-server port (default ${DEFAULT_PORT}).`, String(DEFAULT_PORT))
+    .option('--skip-build', 'Skip `pnpm build` — assume web/dist is current.', false)
+    .option('--screenshots', 'Save a PNG per viewport to ./screencheck-out/ for visual review.', false)
+    .option('--url <url>', 'Check a live URL instead of the local build.')
+    .action(async (raw) => {
+    const opts = {
+        dir: raw.dir,
+        port: Number(raw.port),
+        skipBuild: Boolean(raw.skipBuild),
+        screenshots: Boolean(raw.screenshots),
+        url: raw.url ?? null,
+    };
+    const playwright = await loadPlaywright(opts.dir);
+    if (!playwright) {
+        process.stdout.write('\n⚠  Playwright not installed.\n' +
+            '   Run: pnpm add -D playwright && npx playwright install chromium\n' +
+            '   Then re-run: fas screencheck\n');
+        process.exit(1);
+    }
+    // For --url, skip the manifest read and use safe defaults.
+    let minWidth;
+    let orientation;
+    if (opts.url) {
+        minWidth = 320;
+        orientation = 'any';
+        process.stdout.write(`\nChecking ${opts.url} (live URL — manifest not consulted).\n`);
+    }
+    else {
+        const manifest = await readManifest(opts.dir);
+        if (!manifest) {
+            process.stdout.write('\n✗ web/public/manifest.json not found or unparseable.\n');
+            process.exit(1);
+        }
+        minWidth = typeof manifest['min_viewport_width'] === 'number' ? manifest['min_viewport_width'] : 320;
+        orientation = typeof manifest['orientation'] === 'string' ? manifest['orientation'] : 'any';
+        process.stdout.write(`\nManifest: orientation=${orientation} · min ${minWidth}px wide\n`);
+    }
+    const matrix = pickMatrix(minWidth, orientation);
+    if (matrix.length === 0) {
+        process.stdout.write('\n✗ Manifest orientation is invalid or no test sizes apply.\n');
+        process.exit(1);
+    }
+    process.stdout.write(`Testing ${matrix.length} reference viewports across the device matrix.\n`);
+    let url;
+    let server = null;
+    if (opts.url) {
+        url = opts.url;
+    }
+    else {
+        if (!opts.skipBuild) {
+            process.stdout.write('\nBuilding web/dist…\n');
+            await runShell('pnpm', ['build'], opts.dir);
+        }
+        const distDir = resolve(opts.dir, 'web', 'dist');
+        if (!existsSync(distDir)) {
+            process.stdout.write(`\n✗ ${distDir} doesn't exist. Run \`pnpm build\` first.\n`);
+            process.exit(1);
+        }
+        server = await startServer(distDir, opts.port);
+        url = `http://localhost:${opts.port}/`;
+        process.stdout.write(`Serving ${distDir} at ${url}\n\n`);
+    }
+    const shotsDir = resolve(opts.dir, 'screencheck-out');
+    if (opts.screenshots) {
+        const { mkdirSync } = await import('node:fs');
+        mkdirSync(shotsDir, { recursive: true });
+        process.stdout.write(`Saving screenshots to ${shotsDir}\n\n`);
+    }
+    let exitCode = 0;
+    try {
+        const browser = await playwright.launch();
+        const results = [];
+        const passing = new Set();
+        for (const t of matrix) {
+            const r = await measure(browser, url, t, opts.screenshots ? shotsDir : null);
+            results.push(r);
+            renderResult(r);
+            // Pass = no document scroll AND no inner clipping.
+            if (!r.scrollsX && !r.scrollsY && r.clippingElements.length === 0) {
+                passing.add(t.label);
+            }
+        }
+        await browser.close();
+        const cov = computeCoverage(matrix, passing);
+        const failed = results.filter((r) => r.scrollsX || r.scrollsY || r.clippingElements.length > 0).length;
+        process.stdout.write('\n');
+        renderCoverage(cov, matrix);
+        process.stdout.write('\n');
+        if (failed > 0) {
+            process.stdout.write(`✗ ${failed}/${results.length} reference viewports have layout issues.\n`);
+            // Coverage failure is a fail. But: failing only at the very
+            // top end of the matrix (1024+ desktop) above what the manifest
+            // claims doesn't necessarily warrant a non-zero exit; the
+            // creator can opt out via orientation=portrait, and the badge
+            // already conveys reality. So we exit non-zero only if the
+            // *declared* min fails.
+            const declaredMinFails = matrix.some((t) => t.width === minWidth && !passing.has(t.label));
+            if (declaredMinFails) {
+                process.stdout.write(`  At least one failing viewport is at or below your declared min_viewport_width (${minWidth}px).\n`);
+                process.stdout.write('  Either fix the layout or raise min_viewport_width in your manifest.\n');
+                exitCode = 1;
+            }
+            else {
+                process.stdout.write(`  All failures are above your declared min (${minWidth}px). Consider raising it to claim coverage that's actually true.\n`);
+            }
+        }
+        else {
+            process.stdout.write(`✓ All ${results.length} reference viewports fit cleanly.\n`);
+            const minPassing = Math.min(...matrix.filter((t) => passing.has(t.label)).map((t) => t.width));
+            if (minPassing < minWidth) {
+                process.stdout.write(`  You could lower min_viewport_width to ${minPassing} — your app actually fits there.\n`);
+            }
+        }
+    }
+    finally {
+        server?.close();
+    }
+    process.exit(exitCode);
+});
+/**
+ * The reference device matrix. Each entry pairs a width with a real-world
+ * device class and the *cumulative device share* at that width — used to
+ * answer "what % of users does this break for?". Numbers match the
+ * storefront's viewport-coverage badge so the CLI and the badge agree.
+ *
+ * Cumulative means: `share` is the % of devices whose viewport is at
+ * LEAST this wide. So 360px = 96% means 96% of devices have ≥360px
+ * available; if the app fails at 360, you've lost those 96%.
+ *
+ * Source: blended StatCounter + caniuse share-of-screens, rounded.
+ */
+const REFERENCE_PORTRAIT = [
+    { width: 320, height: 568, label: 'iPhone SE (1st gen)', share: 99 },
+    { width: 360, height: 800, label: 'Android baseline', share: 96 },
+    { width: 414, height: 896, label: 'iPhone 11/Pro Max', share: 88 },
+    { width: 600, height: 800, label: 'Small tablet', share: 60 },
+    { width: 768, height: 1024, label: 'iPad portrait', share: 35 },
+    { width: 1024, height: 1366, label: 'iPad Pro portrait', share: 20 },
+];
+const REFERENCE_LANDSCAPE = [
+    { width: 568, height: 320, label: 'iPhone SE landscape', share: 99 },
+    { width: 667, height: 375, label: 'iPhone 8 landscape', share: 96 },
+    { width: 736, height: 414, label: 'iPhone Plus landscape', share: 88 },
+    { width: 800, height: 600, label: 'Small tablet landscape', share: 60 },
+    { width: 1024, height: 768, label: 'iPad landscape', share: 35 },
+    { width: 1366, height: 1024, label: 'iPad Pro landscape', share: 20 },
+];
+/**
+ * Pick the full reference matrix to test, gated by manifest orientation.
+ * For orientation='any', test both. For 'portrait'/'landscape', test only
+ * that side. Sizes below `minWidth` are still tested — failing below the
+ * declared min is *expected*, but if it passes, the creator can claim a
+ * wider device coverage than they declared.
+ */
+export function pickTests(minWidth, orientation) {
+    return pickMatrix(minWidth, orientation).map(({ orientation: o, ...t }) => ({
+        label: t.label,
+        width: t.width,
+        height: t.height,
+    }));
+}
+export function pickMatrix(_minWidth, orientation) {
+    const isPortrait = orientation === 'portrait' || orientation === 'portrait-primary';
+    const isLandscape = orientation === 'landscape' || orientation === 'landscape-primary';
+    const isAny = orientation === 'any' || orientation === 'unspecified' || !orientation;
+    const matrix = [];
+    if (isPortrait || isAny) {
+        for (const r of REFERENCE_PORTRAIT) {
+            matrix.push({
+                label: `portrait ${r.width}×${r.height} (${r.label})`,
+                width: r.width,
+                height: r.height,
+                share: r.share,
+                orientation: 'portrait',
+            });
+        }
+    }
+    if (isLandscape || isAny) {
+        for (const r of REFERENCE_LANDSCAPE) {
+            matrix.push({
+                label: `landscape ${r.width}×${r.height} (${r.label})`,
+                width: r.width,
+                height: r.height,
+                share: r.share,
+                orientation: 'landscape',
+            });
+        }
+    }
+    return matrix;
+}
+/**
+ * Given the matrix and pass/fail per size, compute device coverage.
+ * Coverage = max share among passing widths, per orientation.
+ *
+ * Why max(share): share is cumulative-from-this-width-up. The smallest
+ * passing width has the highest share; passing larger widths is implied
+ * by passing the smallest. We pick the lowest passing width's share.
+ */
+export function computeCoverage(matrix, passing) {
+    let portrait = 0;
+    let landscape = 0;
+    const broken = [];
+    for (const t of matrix) {
+        if (passing.has(t.label)) {
+            if (t.orientation === 'portrait')
+                portrait = Math.max(portrait, t.share);
+            else
+                landscape = Math.max(landscape, t.share);
+        }
+        else {
+            broken.push(t);
+        }
+    }
+    // For 'any' orientation, the user needs BOTH to work, so coverage is
+    // the lower of the two. For one-orientation apps, only that side
+    // matters.
+    const hasPortrait = matrix.some((t) => t.orientation === 'portrait');
+    const hasLandscape = matrix.some((t) => t.orientation === 'landscape');
+    let overall = 0;
+    if (hasPortrait && hasLandscape)
+        overall = Math.min(portrait, landscape);
+    else if (hasPortrait)
+        overall = portrait;
+    else
+        overall = landscape;
+    return { portrait, landscape, overall, brokenSizes: broken };
+}
+async function measure(browser, url, t, shotsDir) {
+    // Cast through unknown — we only call a tiny subset of the Page API
+    // and don't want to take a Playwright type dep at module load time.
+    const page = (await browser.newPage({ viewport: { width: t.width, height: t.height } }));
+    await page.goto(url, { waitUntil: 'networkidle' });
+    // Small settle delay — fonts, images, late-load JS.
+    await page.evaluate(() => new Promise((r) => setTimeout(r, 250)));
+    // Bundle the document-level metrics + inner-clipping scan into one
+    // page.evaluate, written as a string so TS doesn't try to type-check
+    // browser globals like `document` and `getComputedStyle`. This catches
+    // the common case where a layout uses `overflow:hidden` on a parent
+    // to mask an oversized child — visually content is cropped, but the
+    // document doesn't scroll, so a naive scrollWidth check passes.
+    const dim = await page.evaluate(new Function(`
+      const root = document.documentElement;
+      const TOL = 1;
+      const clipping = [];
+      const elements = document.querySelectorAll('*');
+      for (let i = 0; i < elements.length; i++) {
+        const el = elements[i];
+        const cs = getComputedStyle(el);
+        const ovx = cs.overflowX;
+        const ovy = cs.overflowY;
+        const xClipped = (ovx === 'hidden' || ovx === 'clip') && el.scrollWidth > el.clientWidth + TOL;
+        const yClipped = (ovy === 'hidden' || ovy === 'clip') && el.scrollHeight > el.clientHeight + TOL;
+        if (xClipped || yClipped) {
+          clipping.push({
+            tag: el.tagName.toLowerCase(),
+            cls: (el.className || '').toString().slice(0, 50),
+            id: el.id || null,
+            scrollW: el.scrollWidth,
+            scrollH: el.scrollHeight,
+            clientW: el.clientWidth,
+            clientH: el.clientHeight,
+            clipsX: xClipped,
+            clipsY: yClipped,
+          });
+        }
+      }
+      return {
+        scrollWidth: root.scrollWidth,
+        scrollHeight: root.scrollHeight,
+        clientWidth: root.clientWidth,
+        clientHeight: root.clientHeight,
+        clipping: clipping,
+      };
+    `));
+    if (shotsDir) {
+        const safe = t.label.replace(/[^a-z0-9-]+/gi, '-').toLowerCase();
+        await page.screenshot({ path: join(shotsDir, `${safe}.png`) });
+    }
+    await page.close();
+    // Use a 1px tolerance — sub-pixel rounding and CSS-zoom quirks can
+    // make scrollWidth = clientWidth + 1 even when nothing visibly
+    // overflows.
+    const TOLERANCE = 1;
+    return {
+        label: t.label,
+        width: t.width,
+        height: t.height,
+        scrollWidth: dim.scrollWidth,
+        scrollHeight: dim.scrollHeight,
+        scrollsX: dim.scrollWidth > dim.clientWidth + TOLERANCE,
+        scrollsY: dim.scrollHeight > dim.clientHeight + TOLERANCE,
+        clippingElements: dim.clipping,
+    };
+}
+function renderCoverage(cov, matrix) {
+    const isTTY = Boolean(process.stdout.isTTY) && process.env['NO_COLOR'] !== '1';
+    const c = (open) => (s) => (isTTY ? `\x1b[${open}m${s}\x1b[39m` : s);
+    const ok = c('32');
+    const warn = c('33');
+    const bad = c('31');
+    const colorize = (pct) => pct >= 95 ? ok : pct >= 80 ? warn : bad;
+    const hasPortrait = matrix.some((t) => t.orientation === 'portrait');
+    const hasLandscape = matrix.some((t) => t.orientation === 'landscape');
+    process.stdout.write('Device coverage:\n');
+    if (hasPortrait) {
+        process.stdout.write(`  portrait:  ${colorize(cov.portrait)(`~${cov.portrait}%`)} of devices\n`);
+    }
+    if (hasLandscape) {
+        process.stdout.write(`  landscape: ${colorize(cov.landscape)(`~${cov.landscape}%`)} of devices\n`);
+    }
+    if (hasPortrait && hasLandscape) {
+        process.stdout.write(`  overall:   ${colorize(cov.overall)(`~${cov.overall}%`)} (worst-case across orientations)\n`);
+    }
+}
+function renderResult(r) {
+    const isTTY = Boolean(process.stdout.isTTY) && process.env['NO_COLOR'] !== '1';
+    const c = (open) => (s) => (isTTY ? `\x1b[${open}m${s}\x1b[39m` : s);
+    const ok = c('32');
+    const bad = c('31');
+    const dim = (s) => (isTTY ? `\x1b[2m${s}\x1b[22m` : s);
+    const hasIssue = r.scrollsX || r.scrollsY || r.clippingElements.length > 0;
+    if (!hasIssue) {
+        process.stdout.write(`  ${ok('✓')} ${r.label.padEnd(40)} ${dim(`fits cleanly`)}\n`);
+        return;
+    }
+    const issues = [];
+    if (r.scrollsX)
+        issues.push(`scrolls horizontally (${r.scrollWidth}px > ${r.width}px)`);
+    if (r.scrollsY)
+        issues.push(`scrolls vertically (${r.scrollHeight}px > ${r.height}px)`);
+    if (r.clippingElements.length > 0) {
+        issues.push(`${r.clippingElements.length} element(s) clip content`);
+    }
+    process.stdout.write(`  ${bad('✗')} ${r.label.padEnd(40)} ${dim(issues.join(' · '))}\n`);
+    // Show the worst clipping offenders. Cap at 3 per viewport to keep
+    // output readable; the screenshot is the receipt for the rest.
+    for (const el of r.clippingElements.slice(0, 3)) {
+        const sel = el.id ? `#${el.id}` : el.cls ? `.${el.cls.split(/\s+/)[0]}` : '';
+        const detail = [];
+        if (el.clipsX)
+            detail.push(`x:${el.scrollW}>${el.clientW}`);
+        if (el.clipsY)
+            detail.push(`y:${el.scrollH}>${el.clientH}`);
+        process.stdout.write(`      ${dim(`<${el.tag}${sel}>`)} ${dim(detail.join(' '))}\n`);
+    }
+}
+async function readManifest(dir) {
+    try {
+        const raw = await readFile(join(dir, 'web', 'public', 'manifest.json'), 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function loadPlaywright(targetDir) {
+    // playwright is an OPTIONAL peer dep installed in the user's project,
+    // not in the CLI's own node_modules. Resolve from the target dir so
+    // the user can `pnpm add -D playwright` in their app and have it Just
+    // Work, rather than needing it co-located with a globally-installed CLI.
+    try {
+        const require = createRequire(join(targetDir, 'package.json'));
+        const resolved = require.resolve('playwright');
+        const mod = (await import(pathToFileURL(resolved).href));
+        return mod.chromium ?? mod.default?.chromium ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function runShell(cmd, args, cwd) {
+    return new Promise((res, rej) => {
+        const child = spawn(cmd, args, { cwd, stdio: 'inherit' });
+        child.on('exit', (code) => (code === 0 ? res() : rej(new Error(`${cmd} exited ${code}`))));
+        child.on('error', rej);
+    });
+}
+async function startServer(rootDir, port) {
+    const server = createServer(async (req, res) => {
+        const url = new URL(req.url ?? '/', 'http://x');
+        let p = decodeURIComponent(url.pathname);
+        if (p.endsWith('/'))
+            p += 'index.html';
+        const safe = normalize(p).replace(/^(\.\.[/\\])+/, '');
+        const filePath = join(rootDir, safe);
+        try {
+            const s = await stat(filePath);
+            if (s.isDirectory())
+                throw new Error('is dir');
+            const body = await readFile(filePath);
+            res.writeHead(200, { 'Content-Type': MIME[extname(filePath).toLowerCase()] ?? 'application/octet-stream' });
+            res.end(body);
+        }
+        catch {
+            res.writeHead(404);
+            res.end('not found');
+        }
+    });
+    await new Promise((resolve) => server.listen(port, '127.0.0.1', resolve));
+    return { close: () => server.close() };
+}
+//# sourceMappingURL=screencheck.js.map