@freeappstore/compliance 0.1.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FreeAppStore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/checks/no-brand-overrides.d.ts

@@ -0,0 +1,24 @@
+import type { CheckResult } from '../types.js';
+/**
+ * Apps and games on the platform must look consistent with the storefront
+ * and with each other — brand colors, fonts, and layout rhythm come from
+ * the template, not the app. This check fails on the most common forms of
+ * brand-override drift:
+ *
+ *   1. Custom CSS variable overrides for the platform-defined tokens
+ *      (--paper, --ink, --accent, --line, --panel, --muted). These are
+ *      defined by the template; an app redefining them changes the brand.
+ *   2. Custom font-family declarations beyond the brand stack
+ *      (Manrope, Fraunces) and the system / monospace fallbacks.
+ *
+ * What's allowed:
+ *   - Using the variables (color: var(--accent)) — that's the whole point.
+ *   - Hardcoded colors for non-brand purposes (highlight states, error
+ *     red, etc.). We don't try to gate every hex literal — too noisy and
+ *     too many false positives.
+ */
+export declare function checkNoBrandOverrides(repoDir: string): Promise<CheckResult>;
+export declare function scanContent(filename: string, content: string, opts?: {
+    skipVarRedefs?: boolean;
+}): string[];
+//# sourceMappingURL=no-brand-overrides.d.ts.map

package/dist/checks/no-brand-overrides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-brand-overrides.d.ts","sourceRoot":"","sources":["../../src/checks/no-brand-overrides.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwCjF;AA2DD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACrC,MAAM,EAAE,CAyCV"}

package/dist/checks/no-brand-overrides.js

@@ -0,0 +1,164 @@
+import { readFile } from 'node:fs/promises';
+import { extname, relative } from 'node:path';
+import { walk } from '../lib/walk.js';
+/**
+ * Apps and games on the platform must look consistent with the storefront
+ * and with each other — brand colors, fonts, and layout rhythm come from
+ * the template, not the app. This check fails on the most common forms of
+ * brand-override drift:
+ *
+ *   1. Custom CSS variable overrides for the platform-defined tokens
+ *      (--paper, --ink, --accent, --line, --panel, --muted). These are
+ *      defined by the template; an app redefining them changes the brand.
+ *   2. Custom font-family declarations beyond the brand stack
+ *      (Manrope, Fraunces) and the system / monospace fallbacks.
+ *
+ * What's allowed:
+ *   - Using the variables (color: var(--accent)) — that's the whole point.
+ *   - Hardcoded colors for non-brand purposes (highlight states, error
+ *     red, etc.). We don't try to gate every hex literal — too noisy and
+ *     too many false positives.
+ */
+export async function checkNoBrandOverrides(repoDir) {
+    const issues = [];
+    for await (const file of walk(repoDir)) {
+        const ext = extname(file).toLowerCase();
+        if (!SCANNED_EXTS.has(ext))
+            continue;
+        const content = await readFile(file, 'utf8').catch(() => '');
+        if (!content)
+            continue;
+        const rel = relative(repoDir, file);
+        // Canonical theme file: the platform's CSS variables ARE defined here.
+        // Apps own this file post-scaffold (they can technically modify token
+        // values, and we accept the imperfection — the loud places where a
+        // brand override actually causes inconsistency are inline styles +
+        // per-component CSS, which this check still covers).
+        const isThemeFile = rel === 'web/src/index.css' || rel === 'web/src/main.css';
+        const fileIssues = scanContent(rel, content, { skipVarRedefs: isThemeFile });
+        issues.push(...fileIssues);
+        // Cap at 10 — beyond that the user has bigger problems and we don't
+        // want a 200-line failure report.
+        if (issues.length >= 10)
+            break;
+    }
+    if (issues.length === 0) {
+        return {
+            name: 'No brand overrides',
+            status: 'pass',
+            detail: 'apps inherit colors + fonts from the template',
+        };
+    }
+    return {
+        name: 'No brand overrides',
+        status: 'fail',
+        detail: `${issues.length} apparent override${issues.length === 1 ? '' : 's'}`,
+        suggestions: [
+            ...issues.slice(0, 5),
+            ...(issues.length > 5 ? [`...and ${issues.length - 5} more`] : []),
+            'Use the template tokens (var(--accent), var(--ink), etc.) instead of redefining them.',
+            'Brand fonts are Manrope (body) + Fraunces (display). Stick to those + system / monospace.',
+        ],
+    };
+}
+const SCANNED_EXTS = new Set(['.css', '.scss', '.tsx', '.ts', '.jsx', '.js', '.html']);
+const PROTECTED_VARS = new Set([
+    '--paper',
+    '--ink',
+    '--muted',
+    '--accent',
+    '--line',
+    '--line-strong',
+    '--panel',
+]);
+/**
+ * Whitelist of font-family declarations we accept. Anything outside this
+ * set — for ANY font name not in the brand stack and not a generic /
+ * system fallback — flags. The check is case-insensitive.
+ */
+const ALLOWED_FONT_TOKENS = new Set([
+    // Brand stack
+    'manrope',
+    'fraunces',
+    // Generic/system fallbacks (CSS keywords)
+    'serif',
+    'sans-serif',
+    'monospace',
+    'system-ui',
+    'ui-monospace',
+    'ui-serif',
+    'ui-sans-serif',
+    'inherit',
+    'initial',
+    'unset',
+    'revert',
+    // Common system stack names — these are aliases, not custom fonts.
+    '-apple-system',
+    'blinkmacsystemfont',
+    'segoe ui',
+    'roboto',
+    'helvetica',
+    'helvetica neue',
+    'arial',
+    'sf mono',
+    'sf pro',
+    'menlo',
+    'monaco',
+    'consolas',
+    'liberation mono',
+    'courier',
+    'courier new',
+    'georgia',
+    'noto sans',
+    'noto color emoji',
+    'apple color emoji',
+    'segoe ui emoji',
+    'segoe ui symbol',
+]);
+export function scanContent(filename, content, opts = {}) {
+    const out = [];
+    // 1. CSS variable overrides for protected tokens.
+    // Match `--accent: <something>;` outside of var() invocations.
+    // The regex looks for "<two dashes><name>:" near the start of a line,
+    // which is how CSS declarations look. var(--accent) won't match because
+    // there's a `(` not a `:`.
+    if (!opts.skipVarRedefs) {
+        const varDeclRe = /(?:^|[\s;{,])(--[a-z-]+)\s*:/gim;
+        let m;
+        while ((m = varDeclRe.exec(content)) !== null) {
+            const name = m[1];
+            if (PROTECTED_VARS.has(name)) {
+                const line = lineNumberAt(content, m.index);
+                out.push(`${filename}:${line} redefines ${name} (template owns this token)`);
+            }
+        }
+    }
+    // 2. font-family overrides. Pull every string after `font-family:` (in
+    // CSS) or `fontFamily:` (in JSX/TS), parse the comma-separated list,
+    // and flag any quoted token not in ALLOWED_FONT_TOKENS.
+    const fontRe = /(?:font-family|fontFamily)\s*[:=]\s*["'`]?([^;"'`}\n]+)["'`]?/g;
+    let m;
+    while ((m = fontRe.exec(content)) !== null) {
+        const list = m[1];
+        const tokens = list
+            .split(',')
+            .map((t) => t.trim().replace(/^["']|["']$/g, '').toLowerCase())
+            .filter(Boolean);
+        for (const t of tokens) {
+            if (!ALLOWED_FONT_TOKENS.has(t)) {
+                const line = lineNumberAt(content, m.index);
+                out.push(`${filename}:${line} non-brand font "${t}"`);
+                break; // one warning per declaration is plenty
+            }
+        }
+    }
+    return out;
+}
+function lineNumberAt(content, index) {
+    let n = 1;
+    for (let i = 0; i < index; i++)
+        if (content.charCodeAt(i) === 10)
+            n++;
+    return n;
+}
+//# sourceMappingURL=no-brand-overrides.js.map

package/dist/checks/no-brand-overrides.js.map

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

package/dist/checks/no-brand-overrides.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=no-brand-overrides.test.d.ts.map

package/dist/checks/no-brand-overrides.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-brand-overrides.test.d.ts","sourceRoot":"","sources":["../../src/checks/no-brand-overrides.test.ts"],"names":[],"mappings":""}

package/dist/checks/no-brand-overrides.test.js

@@ -0,0 +1,102 @@
+import { describe, it, expect } from 'vitest';
+import { mkdtemp, mkdir, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { checkNoBrandOverrides, scanContent } from './no-brand-overrides.js';
+async function fixture(files) {
+    const dir = await mkdtemp(join(tmpdir(), 'fas-brand-'));
+    for (const [path, content] of Object.entries(files)) {
+        const full = join(dir, path);
+        await mkdir(join(full, '..'), { recursive: true });
+        await writeFile(full, content);
+    }
+    return dir;
+}
+describe('scanContent (unit)', () => {
+    it('flags an override of a protected CSS variable', () => {
+        const issues = scanContent('web/src/index.css', `
+      :root { --accent: hotpink; }
+    `);
+        expect(issues).toHaveLength(1);
+        expect(issues[0]).toMatch(/--accent/);
+    });
+    it('does NOT flag using the variable via var()', () => {
+        const issues = scanContent('web/src/App.tsx', `
+      <div style={{ color: 'var(--accent)' }} />
+    `);
+        expect(issues).toEqual([]);
+    });
+    it('does not flag a non-protected custom variable (apps can have their own)', () => {
+        const issues = scanContent('web/src/index.css', `
+      :root { --my-shadow: 0 0 4px black; }
+    `);
+        expect(issues).toEqual([]);
+    });
+    it('flags a non-brand font-family in CSS', () => {
+        const issues = scanContent('web/src/index.css', `
+      h1 { font-family: "Cormorant Garamond", serif; }
+    `);
+        expect(issues).toHaveLength(1);
+        expect(issues[0]).toMatch(/cormorant garamond/);
+    });
+    it('flags a non-brand font in inline JSX styles', () => {
+        const issues = scanContent('web/src/App.tsx', `
+      <h1 style={{ fontFamily: "Sora, sans-serif" }} />
+    `);
+        expect(issues).toHaveLength(1);
+        expect(issues[0]).toMatch(/sora/);
+    });
+    it('accepts brand fonts and system fallbacks', () => {
+        const issues = scanContent('web/src/index.css', `
+      body { font-family: "Manrope", system-ui, sans-serif; }
+      h1 { font-family: Fraunces, Georgia, serif; }
+      code { font-family: "SF Mono", Menlo, monospace; }
+    `);
+        expect(issues).toEqual([]);
+    });
+    it('reports line numbers', () => {
+        const issues = scanContent('web/src/index.css', `\n\n:root { --paper: red; }\n`);
+        expect(issues[0]).toMatch(/:3 /);
+    });
+});
+describe('checkNoBrandOverrides (integration)', () => {
+    it('passes when all CSS uses brand tokens', async () => {
+        const dir = await fixture({
+            'web/src/index.css': `
+        :root { --my-extra: 4px; }
+        body { font-family: Manrope, system-ui, sans-serif; }
+        h1 { font-family: Fraunces, serif; color: var(--accent); }
+      `,
+        });
+        const r = await checkNoBrandOverrides(dir);
+        expect(r.status).toBe('pass');
+    });
+    it('fails when an app overrides a protected variable in a non-theme CSS file', async () => {
+        // web/src/index.css is the canonical theme file (exempt). Per-component
+        // CSS like this isn't.
+        const dir = await fixture({
+            'web/src/components/Branding.css': `:root { --accent: deeppink; }`,
+        });
+        const r = await checkNoBrandOverrides(dir);
+        expect(r.status).toBe('fail');
+        expect(r.detail).toMatch(/override/);
+        expect(r.suggestions?.join(' ')).toMatch(/var\(--accent\)/);
+    });
+    it('does NOT fail when web/src/index.css legitimately defines tokens (template-owned)', async () => {
+        const dir = await fixture({
+            'web/src/index.css': `:root { --paper: #ffffff; --ink: #1a1a1a; --accent: #2563eb; }`,
+        });
+        const r = await checkNoBrandOverrides(dir);
+        expect(r.status).toBe('pass');
+    });
+    it('fails when an app uses non-brand fonts', async () => {
+        const dir = await fixture({
+            'web/src/App.tsx': `
+        const h1 = <h1 style={{ fontFamily: "Cormorant Garamond, serif" }} />;
+      `,
+        });
+        const r = await checkNoBrandOverrides(dir);
+        expect(r.status).toBe('fail');
+    });
+});
+//# sourceMappingURL=no-brand-overrides.test.js.map

package/dist/checks/no-brand-overrides.test.js.map

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

package/dist/checks/no-scroll.d.ts

@@ -0,0 +1,24 @@
+import type { CheckResult } from '../types.js';
+/**
+ * Games on FreeGameStore must fit the viewport — no horizontal or
+ * vertical scroll at the document level. Static analysis catches the
+ * common CSS / inline-style anti-patterns:
+ *
+ *   - `overflow: scroll` or `overflow: auto` on `html` or `body`.
+ *   - `min-height: 100vh` on `html` / `body` (creates page that's at
+ *     least viewport-tall, but content + topbar = > 100vh = scroll).
+ *   - Missing the `100svh` / `100vh` height constraint on the layout
+ *     wrapper (loose check — "at least one root element should hard-cap
+ *     to viewport height").
+ *
+ * Runtime guarantees (real DOM measurement) live in the e2e Playwright
+ * suite; this check exists as a fast pre-publish gate so creators
+ * don't ship trivially-scrolling games.
+ *
+ * Apps (FreeAppStore) are not subject to this check — the apps Shell
+ * wraps them in a sidebar+main layout that legitimately scrolls. We
+ * detect "is this a game project" by looking for the @freeappstore/games
+ * dep, the canonical signal that the app uses GameShell.
+ */
+export declare function checkNoScroll(repoDir: string): Promise<CheckResult>;
+//# sourceMappingURL=no-scroll.d.ts.map

package/dist/checks/no-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-scroll.d.ts","sourceRoot":"","sources":["../../src/checks/no-scroll.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA6EzE"}

package/dist/checks/no-scroll.js

@@ -0,0 +1,143 @@
+import { readFile } from 'node:fs/promises';
+import { extname, relative } from 'node:path';
+import { walk } from '../lib/walk.js';
+/**
+ * Games on FreeGameStore must fit the viewport — no horizontal or
+ * vertical scroll at the document level. Static analysis catches the
+ * common CSS / inline-style anti-patterns:
+ *
+ *   - `overflow: scroll` or `overflow: auto` on `html` or `body`.
+ *   - `min-height: 100vh` on `html` / `body` (creates page that's at
+ *     least viewport-tall, but content + topbar = > 100vh = scroll).
+ *   - Missing the `100svh` / `100vh` height constraint on the layout
+ *     wrapper (loose check — "at least one root element should hard-cap
+ *     to viewport height").
+ *
+ * Runtime guarantees (real DOM measurement) live in the e2e Playwright
+ * suite; this check exists as a fast pre-publish gate so creators
+ * don't ship trivially-scrolling games.
+ *
+ * Apps (FreeAppStore) are not subject to this check — the apps Shell
+ * wraps them in a sidebar+main layout that legitimately scrolls. We
+ * detect "is this a game project" by looking for the @freeappstore/games
+ * dep, the canonical signal that the app uses GameShell.
+ */
+export async function checkNoScroll(repoDir) {
+    // Skip apps — only games are subject to no-scroll.
+    if (!(await isGame(repoDir))) {
+        return {
+            name: 'No scroll (games only)',
+            status: 'pass',
+            detail: 'not a game project — check skipped',
+        };
+    }
+    const issues = [];
+    let sawViewportLock = false;
+    for await (const file of walk(repoDir)) {
+        const ext = extname(file).toLowerCase();
+        if (!SCAN_EXTS.has(ext))
+            continue;
+        const content = await readFile(file, 'utf8').catch(() => '');
+        if (!content)
+            continue;
+        const rel = relative(repoDir, file);
+        // 1. Forbidden overflow declarations on root elements.
+        for (const re of FORBIDDEN_OVERFLOW) {
+            const m = re.exec(content);
+            if (m) {
+                const line = lineNumberAt(content, m.index);
+                issues.push(`${rel}:${line} ${m[0]} — root scrolling not allowed in games`);
+            }
+        }
+        // 2. min-height on root elements (creates pages taller than viewport).
+        for (const re of FORBIDDEN_MIN_HEIGHT) {
+            const m = re.exec(content);
+            if (m) {
+                const line = lineNumberAt(content, m.index);
+                issues.push(`${rel}:${line} ${m[0]} — use exact viewport height (100svh) instead`);
+            }
+        }
+        // 3. Look for at least one viewport-lock pattern. GameShell sets
+        // `height: 100svh` on a fixed wrapper; we accept any 100svh / 100vh
+        // declaration as evidence the game considered viewport sizing.
+        if (VIEWPORT_LOCK.test(content))
+            sawViewportLock = true;
+        if (issues.length >= 8)
+            break;
+    }
+    if (issues.length > 0) {
+        return {
+            name: 'No scroll (games only)',
+            status: 'fail',
+            detail: `${issues.length} scroll-enabling pattern${issues.length === 1 ? '' : 's'}`,
+            suggestions: [
+                ...issues.slice(0, 5),
+                ...(issues.length > 5 ? [`...and ${issues.length - 5} more`] : []),
+                'Use <GameShell> from @freeappstore/games — it locks layout to 100svh.',
+                'Inside the play area, use overflow: hidden instead of overflow: auto.',
+            ],
+        };
+    }
+    if (!sawViewportLock) {
+        return {
+            name: 'No scroll (games only)',
+            status: 'warn',
+            detail: 'no 100svh/100vh viewport lock detected — game may scroll on small viewports',
+            suggestions: [
+                'Wrap your game in <GameShell> from @freeappstore/games, or',
+                'Add `height: 100svh` to your root container.',
+            ],
+        };
+    }
+    return {
+        name: 'No scroll (games only)',
+        status: 'pass',
+        detail: 'viewport-locked layout detected',
+    };
+}
+const SCAN_EXTS = new Set(['.css', '.scss', '.tsx', '.ts', '.jsx', '.js', '.html']);
+// Match `overflow: scroll` and `overflow: auto` on html/body selectors,
+// or as bare global rules in CSS. Conservative: only flags when paired
+// with html/body — avoids false positives for component-scoped overflow.
+//
+// IMPORTANT: no `g` flag. Module-scoped regexes with `g` share lastIndex
+// across parallel test runs and produce flaky matches; we only need
+// first-match-per-file anyway.
+const FORBIDDEN_OVERFLOW = [
+    /(?:^|[\s,{])(?:html|body)\s*\{[^}]*overflow\s*:\s*(?:scroll|auto)/im,
+    /(?:^|[\s,{])(?:html|body)\s*\{[^}]*overflow-(?:x|y)\s*:\s*(?:scroll|auto)/im,
+];
+const FORBIDDEN_MIN_HEIGHT = [
+    /(?:^|[\s,{])(?:html|body)\s*\{[^}]*min-height\s*:\s*100vh/im,
+];
+const VIEWPORT_LOCK = /(?:height|max-height)\s*:\s*100(?:s?vh)|GameShell|@freeappstore\/games/i;
+async function isGame(repoDir) {
+    // Fast path: look for the explicit games-sdk dep in any package.json.
+    // Falls back to scanning JSX for GameShell import — catches cases
+    // where the dep is hoisted to a workspace root.
+    for await (const file of walk(repoDir)) {
+        const base = file.split('/').pop() ?? '';
+        if (base !== 'package.json')
+            continue;
+        const content = await readFile(file, 'utf8').catch(() => '');
+        if (/@freeappstore\/games/.test(content))
+            return true;
+    }
+    for await (const file of walk(repoDir)) {
+        const ext = extname(file).toLowerCase();
+        if (ext !== '.tsx' && ext !== '.ts')
+            continue;
+        const content = await readFile(file, 'utf8').catch(() => '');
+        if (/from\s+['"]@freeappstore\/games['"]/.test(content))
+            return true;
+    }
+    return false;
+}
+function lineNumberAt(content, index) {
+    let n = 1;
+    for (let i = 0; i < index; i++)
+        if (content.charCodeAt(i) === 10)
+            n++;
+    return n;
+}
+//# sourceMappingURL=no-scroll.js.map

package/dist/checks/no-scroll.js.map

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

package/dist/checks/no-scroll.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=no-scroll.test.d.ts.map

package/dist/checks/no-scroll.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-scroll.test.d.ts","sourceRoot":"","sources":["../../src/checks/no-scroll.test.ts"],"names":[],"mappings":""}

package/dist/checks/no-scroll.test.js

@@ -0,0 +1,105 @@
+import { describe, it, expect } from 'vitest';
+import { mkdtemp, mkdir, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { checkNoScroll } from './no-scroll.js';
+async function fixture(files) {
+    const dir = await mkdtemp(join(tmpdir(), 'fas-noscroll-'));
+    for (const [path, content] of Object.entries(files)) {
+        const full = join(dir, path);
+        await mkdir(join(full, '..'), { recursive: true });
+        await writeFile(full, content);
+    }
+    return dir;
+}
+const GAME_DEPS = JSON.stringify({
+    name: 'my-game',
+    dependencies: { '@freeappstore/games': '^0.1.0' },
+});
+describe('checkNoScroll', () => {
+    it('passes (skipped) when the project is not a game', async () => {
+        const dir = await fixture({
+            'package.json': JSON.stringify({ name: 'my-app' }),
+            'web/src/index.css': 'body { overflow: scroll; }',
+        });
+        const r = await checkNoScroll(dir);
+        expect(r.status).toBe('pass');
+        expect(r.detail).toMatch(/not a game/);
+    });
+    it('detects @freeappstore/games dep as the game signal', async () => {
+        const dir = await fixture({
+            'package.json': GAME_DEPS,
+            'web/src/index.css': 'body { height: 100svh; }',
+            'web/src/App.tsx': 'import { GameShell } from "@freeappstore/games";',
+        });
+        const r = await checkNoScroll(dir);
+        // Should at least run the check, not skip.
+        expect(r.detail).not.toMatch(/not a game/);
+    });
+    it('fails when html/body declares overflow: scroll', async () => {
+        const dir = await fixture({
+            'package.json': GAME_DEPS,
+            'web/src/index.css': 'html { overflow: scroll; }',
+        });
+        const r = await checkNoScroll(dir);
+        expect(r.status).toBe('fail');
+        expect(r.suggestions?.join(' ')).toMatch(/GameShell/);
+    });
+    it('fails when html/body declares overflow: auto', async () => {
+        const dir = await fixture({
+            'package.json': GAME_DEPS,
+            'web/src/index.css': 'body { overflow: auto; }',
+        });
+        const r = await checkNoScroll(dir);
+        expect(r.status).toBe('fail');
+    });
+    it('fails on overflow-y: scroll on body', async () => {
+        const dir = await fixture({
+            'package.json': GAME_DEPS,
+            'web/src/index.css': 'body { overflow-y: scroll; padding: 0; }',
+        });
+        const r = await checkNoScroll(dir);
+        expect(r.status).toBe('fail');
+    });
+    it('fails on min-height: 100vh on body (creates page taller than viewport)', async () => {
+        const dir = await fixture({
+            'package.json': GAME_DEPS,
+            'web/src/index.css': 'body { min-height: 100vh; }',
+        });
+        const r = await checkNoScroll(dir);
+        expect(r.status).toBe('fail');
+        expect(r.suggestions?.join(' ')).toMatch(/100svh/);
+    });
+    it('warns when there is no viewport-lock evidence', async () => {
+        const dir = await fixture({
+            'package.json': GAME_DEPS,
+            'web/src/index.css': 'body { padding: 0; }',
+            'web/src/App.tsx': 'export default function App() { return <div>game</div>; }',
+        });
+        const r = await checkNoScroll(dir);
+        expect(r.status).toBe('warn');
+        expect(r.detail).toMatch(/viewport lock/);
+    });
+    it('passes when GameShell is imported (the canonical viewport lock)', async () => {
+        const dir = await fixture({
+            'package.json': GAME_DEPS,
+            'web/src/App.tsx': `
+        import { GameShell, GameTopbar } from "@freeappstore/games";
+        export default function App() {
+          return <GameShell topbar={<GameTopbar score={0} />}>game</GameShell>;
+        }
+      `,
+        });
+        const r = await checkNoScroll(dir);
+        expect(r.status).toBe('pass');
+    });
+    it('passes when CSS has explicit 100svh height lock', async () => {
+        const dir = await fixture({
+            'package.json': GAME_DEPS,
+            'web/src/index.css': '.game-root { height: 100svh; overflow: hidden; }',
+        });
+        const r = await checkNoScroll(dir);
+        expect(r.status).toBe('pass');
+    });
+});
+//# sourceMappingURL=no-scroll.test.js.map

package/dist/checks/no-scroll.test.js.map

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