@freegamestore/compliance 0.6.1 → 0.8.0

package/dist/checks/pwa-maskable-icon.js

@@ -0,0 +1,91 @@
+import { extractInlineManifest } from '../lib/inline-manifest.js';
+const STATIC_MANIFEST_PATH = 'web/public/manifest.json';
+const VITE_CONFIG_PATH = 'web/vite.config.ts';
+/**
+ * Verifies the PWA manifest declares at least one icon with
+ * `purpose: "maskable"` (or a combined value containing "maskable" such
+ * as "any maskable").
+ *
+ * Why this matters: on Android, Chrome's installability heuristics
+ * downgrade a PWA to a launcher *shortcut* (just a bookmark with the
+ * site favicon) when no maskable icon is declared. With a maskable
+ * icon, the same install becomes a real PWA — its own task slot, app
+ * drawer entry, and adaptive icon shape.
+ *
+ * Detection is intentionally lenient: we look for a `purpose:` value
+ * containing the substring `maskable` anywhere in the icons array.
+ * That catches `'maskable'`, `'any maskable'`, `"maskable any"`, and
+ * separate-entry styles alike.
+ */
+export async function checkMaskableIcon(source) {
+    const staticRaw = await source.read(STATIC_MANIFEST_PATH);
+    if (staticRaw !== null) {
+        return validateStatic(staticRaw);
+    }
+    const viteConfig = await source.read(VITE_CONFIG_PATH);
+    if (viteConfig !== null && /\bVitePWA\s*\(/.test(viteConfig)) {
+        return validateInline(viteConfig);
+    }
+    // No manifest source found at all — the `checkManifest` rule will
+    // already fail loudly. Pass here so we don't double-report the same
+    // root cause as two failures.
+    return {
+        name: 'PWA maskable icon',
+        status: 'pass',
+        detail: 'no manifest source (already reported by PWA manifest check)',
+    };
+}
+function validateStatic(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return {
+            name: 'PWA maskable icon',
+            status: 'fail',
+            detail: `${STATIC_MANIFEST_PATH} is not valid JSON`,
+        };
+    }
+    const icons = Array.isArray(parsed.icons) ? parsed.icons : [];
+    const hasMaskable = icons.some((icon) => typeof icon?.purpose === 'string' && /\bmaskable\b/.test(icon.purpose));
+    if (hasMaskable) {
+        return { name: 'PWA maskable icon', status: 'pass', detail: STATIC_MANIFEST_PATH };
+    }
+    return buildFail(STATIC_MANIFEST_PATH);
+}
+function validateInline(viteConfig) {
+    const inline = extractInlineManifest(viteConfig);
+    if (!inline || !inline.iconsRaw) {
+        return {
+            name: 'PWA maskable icon',
+            status: 'fail',
+            detail: `inline manifest in ${VITE_CONFIG_PATH} has no parsable icons array`,
+            suggestions: [
+                'Add an icons array to the manifest:{...} block in VitePWA({...}).',
+            ],
+        };
+    }
+    // Lenient string-level check — see the doc-comment on `checkMaskableIcon`.
+    const hasMaskable = /purpose\s*:\s*['"`][^'"`]*\bmaskable\b[^'"`]*['"`]/.test(inline.iconsRaw);
+    if (hasMaskable) {
+        return {
+            name: 'PWA maskable icon',
+            status: 'pass',
+            detail: `inline manifest in ${VITE_CONFIG_PATH}`,
+        };
+    }
+    return buildFail(`inline manifest in ${VITE_CONFIG_PATH}`);
+}
+function buildFail(where) {
+    return {
+        name: 'PWA maskable icon',
+        status: 'fail',
+        detail: `no icon declares purpose containing "maskable" (${where})`,
+        suggestions: [
+            "Add `purpose: 'any maskable'` to each icon entry (or a dedicated 512×512 icon with `purpose: 'maskable'`).",
+            'Without it, Android Chrome installs the app as a launcher shortcut, not a real PWA.',
+        ],
+    };
+}
+//# sourceMappingURL=pwa-maskable-icon.js.map

package/dist/checks/pwa-maskable-icon.js.map

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

package/dist/checks/react-strict-mode.d.ts

@@ -0,0 +1,4 @@
+import type { FileSource } from '../lib/file-source.js';
+import type { CheckResult } from '../types.js';
+export declare function checkReactStrictMode(source: FileSource): Promise<CheckResult>;
+//# sourceMappingURL=react-strict-mode.d.ts.map

package/dist/checks/react-strict-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-strict-mode.d.ts","sourceRoot":"","sources":["../../src/checks/react-strict-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAkB/C,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CA8BnF"}

package/dist/checks/react-strict-mode.js

@@ -0,0 +1,43 @@
+/**
+ * Checks that the React app renders inside `<React.StrictMode>` or
+ * `<StrictMode>`. StrictMode catches common bugs: double renders in
+ * development, deprecated API usage, and side effects in the render
+ * phase.
+ *
+ * Reads `web/src/main.tsx` (or `web/src/main.ts`). If neither exists,
+ * the project is not a React app — pass silently.
+ *
+ * WARN level — StrictMode is a best practice, not a hard requirement.
+ */
+const MAIN_PATHS = ['web/src/main.tsx', 'web/src/main.ts'];
+const STRICT_MODE_RE = /<(?:React\.)?StrictMode\s*>/;
+export async function checkReactStrictMode(source) {
+    for (const path of MAIN_PATHS) {
+        const content = await source.read(path);
+        if (content === null)
+            continue;
+        if (STRICT_MODE_RE.test(content)) {
+            return {
+                name: 'React StrictMode',
+                status: 'pass',
+                detail: `${path} wraps the app in <StrictMode>`,
+            };
+        }
+        return {
+            name: 'React StrictMode',
+            status: 'warn',
+            detail: `${path} does not use <React.StrictMode> or <StrictMode>`,
+            suggestions: [
+                'Wrap the root component in <React.StrictMode> to catch common React bugs during development.',
+                'Example: createRoot(el).render(<React.StrictMode><App /></React.StrictMode>)',
+            ],
+        };
+    }
+    // Neither main.tsx nor main.ts exists — not a React project.
+    return {
+        name: 'React StrictMode',
+        status: 'pass',
+        detail: 'no web/src/main.tsx found (not a React project)',
+    };
+}
+//# sourceMappingURL=react-strict-mode.js.map

package/dist/checks/react-strict-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-strict-mode.js","sourceRoot":"","sources":["../../src/checks/react-strict-mode.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AAEH,MAAM,UAAU,GAAG,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;AAE3D,MAAM,cAAc,GAAG,6BAA6B,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAkB;IAC3D,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,IAAI;YAAE,SAAS;QAE/B,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,OAAO;gBACL,IAAI,EAAE,kBAAkB;gBACxB,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,GAAG,IAAI,gCAAgC;aAChD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,GAAG,IAAI,kDAAkD;YACjE,WAAW,EAAE;gBACX,8FAA8F;gBAC9F,8EAA8E;aAC/E;SACF,CAAC;IACJ,CAAC;IAED,6DAA6D;IAC7D,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,iDAAiD;KAC1D,CAAC;AACJ,CAAC"}

package/dist/checks/sdk-version.d.ts

@@ -0,0 +1,4 @@
+import type { FileSource } from '../lib/file-source.js';
+import type { CheckResult } from '../types.js';
+export declare function checkSdkVersion(source: FileSource): Promise<CheckResult>;
+//# sourceMappingURL=sdk-version.d.ts.map

package/dist/checks/sdk-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-version.d.ts","sourceRoot":"","sources":["../../src/checks/sdk-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AA0B/C,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CA8D9E"}

package/dist/checks/sdk-version.js

@@ -0,0 +1,80 @@
+/**
+ * Checks that `@freegamestore/games` is present in `web/package.json`
+ * and meets the minimum version (^0.14.0). Older SDK versions lack
+ * newer components (GameOverScreen, GameModal, etc.) and platform
+ * integration hooks.
+ *
+ * If the dependency is entirely absent, this check passes with a
+ * "checked elsewhere" note — the `uses-game-sdk` check covers that
+ * case. This check only fires when the SDK IS present but outdated.
+ */
+const SDK_PKG = '@freegamestore/games';
+const MIN_MINOR = 14; // 0.14.0
+/**
+ * Parse the minor version from a ^0.x.y range. Returns null if the
+ * range can't be trivially parsed or the major isn't 0.
+ */
+function parseMinor(range) {
+    const cleaned = range.replace(/^[\^~>=<\s]+/, '');
+    const match = cleaned.match(/^0\.(\d+)/);
+    return match ? parseInt(match[1], 10) : null;
+}
+export async function checkSdkVersion(source) {
+    const raw = await source.read('web/package.json');
+    if (!raw) {
+        return {
+            name: 'Games SDK version',
+            status: 'pass',
+            detail: 'web/package.json not found — deferring to uses-game-sdk check',
+        };
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return {
+            name: 'Games SDK version',
+            status: 'warn',
+            detail: 'web/package.json is not valid JSON',
+        };
+    }
+    const deps = {
+        ...(typeof pkg.dependencies === 'object' && pkg.dependencies !== null ? pkg.dependencies : {}),
+        ...(typeof pkg.devDependencies === 'object' && pkg.devDependencies !== null ? pkg.devDependencies : {}),
+    };
+    const range = deps[SDK_PKG];
+    if (!range) {
+        return {
+            name: 'Games SDK version',
+            status: 'pass',
+            detail: `${SDK_PKG} not in dependencies — deferring to uses-game-sdk check`,
+        };
+    }
+    const minor = parseMinor(range);
+    if (minor === null) {
+        // Can't parse — might be `latest`, `*`, a git URL, etc. Don't block.
+        return {
+            name: 'Games SDK version',
+            status: 'pass',
+            detail: `${SDK_PKG}: ${range} (unparseable range — skipping version check)`,
+        };
+    }
+    if (minor >= MIN_MINOR) {
+        return {
+            name: 'Games SDK version',
+            status: 'pass',
+            detail: `${SDK_PKG}: ${range}`,
+        };
+    }
+    return {
+        name: 'Games SDK version',
+        status: 'warn',
+        detail: `${SDK_PKG}: ${range} — minimum recommended is ^0.${MIN_MINOR}.0`,
+        suggestions: [
+            `Run \`npm install ${SDK_PKG}@latest\` to get the newest SDK with GameOverScreen, GameModal, and other platform components.`,
+            'See the SDK changelog for what shipped since your current version.',
+        ],
+    };
+}
+//# sourceMappingURL=sdk-version.js.map

package/dist/checks/sdk-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-version.js","sourceRoot":"","sources":["../../src/checks/sdk-version.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,MAAM,OAAO,GAAG,sBAAsB,CAAC;AACvC,MAAM,SAAS,GAAG,EAAE,CAAC,CAAC,SAAS;AAE/B;;;GAGG;AACH,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAkB;IACtD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAClD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,+DAA+D;SACxE,CAAC;IACJ,CAAC;IAED,IAAI,GAA4B,CAAC;IACjC,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,oCAAoC;SAC7C,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG;QACX,GAAG,CAAC,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,GAAG,CAAC,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,IAAI,GAAG,CAAC,eAAe,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9E,CAAC;IAE5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,GAAG,OAAO,yDAAyD;SAC5E,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,qEAAqE;QACrE,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,GAAG,OAAO,KAAK,KAAK,+CAA+C;SAC5E,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,GAAG,OAAO,KAAK,KAAK,EAAE;SAC/B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,GAAG,OAAO,KAAK,KAAK,gCAAgC,SAAS,IAAI;QACzE,WAAW,EAAE;YACX,qBAAqB,OAAO,gGAAgG;YAC5H,oEAAoE;SACrE;KACF,CAAC;AACJ,CAAC"}

package/dist/checks/tech-versions.d.ts

@@ -0,0 +1,4 @@
+import type { FileSource } from '../lib/file-source.js';
+import type { CheckResult } from '../types.js';
+export declare function checkTechVersions(source: FileSource): Promise<CheckResult>;
+//# sourceMappingURL=tech-versions.d.ts.map

package/dist/checks/tech-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-versions.d.ts","sourceRoot":"","sources":["../../src/checks/tech-versions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoD/C,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CA+EhF"}

package/dist/checks/tech-versions.js

@@ -0,0 +1,100 @@
+const EXPECTATIONS = [
+    { packages: ['react'], label: 'React', minMajor: 19 },
+    { packages: ['vite'], label: 'Vite', minMajor: 6 },
+    { packages: ['typescript'], label: 'TypeScript', minMajor: 5, minMinor: 7 },
+    { packages: ['tailwindcss', '@tailwindcss/vite'], label: 'Tailwind CSS', minMajor: 4, optional: true },
+];
+/**
+ * Extract the major (and optionally minor) version from a semver range
+ * string. Handles common range prefixes: ^, ~, >=, =, bare.
+ * Returns null for ranges that can't be trivially parsed (e.g. `*`, `latest`).
+ */
+function parseMajorMinor(range) {
+    // Strip leading range operator
+    const cleaned = range.replace(/^[\^~>=<\s]+/, '');
+    const match = cleaned.match(/^(\d+)(?:\.(\d+))?/);
+    if (!match)
+        return null;
+    return {
+        major: parseInt(match[1], 10),
+        minor: match[2] !== undefined ? parseInt(match[2], 10) : 0,
+    };
+}
+export async function checkTechVersions(source) {
+    const raw = await source.read('web/package.json');
+    if (!raw) {
+        return {
+            name: 'Tech stack versions',
+            status: 'warn',
+            detail: 'web/package.json not found — cannot check dependency versions',
+        };
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(raw);
+    }
+    catch {
+        return {
+            name: 'Tech stack versions',
+            status: 'warn',
+            detail: 'web/package.json is not valid JSON',
+        };
+    }
+    const deps = {
+        ...(typeof pkg.dependencies === 'object' && pkg.dependencies !== null ? pkg.dependencies : {}),
+        ...(typeof pkg.devDependencies === 'object' && pkg.devDependencies !== null ? pkg.devDependencies : {}),
+    };
+    const outdated = [];
+    const missing = [];
+    for (const exp of EXPECTATIONS) {
+        let found = false;
+        for (const pkgName of exp.packages) {
+            const range = deps[pkgName];
+            if (!range)
+                continue;
+            found = true;
+            const ver = parseMajorMinor(range);
+            if (!ver)
+                continue; // unparseable range — skip silently
+            let isOutdated = false;
+            if (ver.major < exp.minMajor) {
+                isOutdated = true;
+            }
+            else if (ver.major === exp.minMajor && exp.minMinor !== undefined && ver.minor < exp.minMinor) {
+                isOutdated = true;
+            }
+            if (isOutdated) {
+                const minStr = exp.minMinor !== undefined
+                    ? `^${exp.minMajor}.${exp.minMinor}`
+                    : `^${exp.minMajor}`;
+                outdated.push(`${exp.label}: ${range} (expected ${minStr}+)`);
+            }
+            break; // first matching package wins
+        }
+        if (!found && !exp.optional) {
+            missing.push(exp.label);
+        }
+    }
+    if (outdated.length === 0 && missing.length === 0) {
+        return {
+            name: 'Tech stack versions',
+            status: 'pass',
+            detail: 'all checked dependencies meet minimum platform versions',
+        };
+    }
+    const parts = [];
+    if (outdated.length > 0)
+        parts.push(`outdated: ${outdated.join(', ')}`);
+    if (missing.length > 0)
+        parts.push(`missing: ${missing.join(', ')}`);
+    return {
+        name: 'Tech stack versions',
+        status: 'warn',
+        detail: parts.join('; '),
+        suggestions: [
+            'Run `npm outdated` and update to the latest majors listed above.',
+            'The platform templates ship with the recommended versions — check template-game-3d or template-game-canvas for reference.',
+        ],
+    };
+}
+//# sourceMappingURL=tech-versions.js.map

package/dist/checks/tech-versions.js.map

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

package/dist/checks/typescript-strict.d.ts

@@ -0,0 +1,14 @@
+import type { FileSource } from '../lib/file-source.js';
+import type { CheckResult } from '../types.js';
+/**
+ * Every game must compile under TypeScript strict mode. This check reads
+ * `web/tsconfig.json` and `web/tsconfig.app.json`, follows `extends`
+ * references (one level deep), and verifies that `"strict": true` is set
+ * — either directly or via the extended base config.
+ *
+ * The individual strict flags (`strictNullChecks`, `noImplicitAny`, etc.)
+ * are also accepted as a collective substitute for `"strict": true`, but
+ * only if all of them are present.
+ */
+export declare function checkTypescriptStrict(source: FileSource): Promise<CheckResult>;
+//# sourceMappingURL=typescript-strict.d.ts.map

package/dist/checks/typescript-strict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-strict.d.ts","sourceRoot":"","sources":["../../src/checks/typescript-strict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CA2GpF"}

package/dist/checks/typescript-strict.js

@@ -0,0 +1,155 @@
+const TSCONFIG_PATHS = ['web/tsconfig.json', 'web/tsconfig.app.json'];
+/**
+ * Every game must compile under TypeScript strict mode. This check reads
+ * `web/tsconfig.json` and `web/tsconfig.app.json`, follows `extends`
+ * references (one level deep), and verifies that `"strict": true` is set
+ * — either directly or via the extended base config.
+ *
+ * The individual strict flags (`strictNullChecks`, `noImplicitAny`, etc.)
+ * are also accepted as a collective substitute for `"strict": true`, but
+ * only if all of them are present.
+ */
+export async function checkTypescriptStrict(source) {
+    // Try each candidate config in order. The first one that exists and
+    // has strict mode wins. tsconfig.app.json typically extends
+    // tsconfig.json, so check it first (it's the more specific one Vite
+    // actually uses).
+    for (const path of TSCONFIG_PATHS) {
+        const raw = await source.read(path);
+        if (raw === null)
+            continue;
+        const config = tryParseJson(raw);
+        if (config === null) {
+            return {
+                name: 'TypeScript strict mode',
+                status: 'fail',
+                detail: `${path} is not valid JSON`,
+                suggestions: ['Fix the JSON syntax errors in the tsconfig file.'],
+            };
+        }
+        const compilerOptions = config.compilerOptions;
+        // Solution-style tsconfig (only `references`, no `compilerOptions`).
+        // Skip to the next candidate — the actual config lives in the
+        // referenced files (typically tsconfig.app.json).
+        if (!compilerOptions && config.references) {
+            continue;
+        }
+        // Direct "strict": true in this file.
+        if (compilerOptions?.strict === true) {
+            return {
+                name: 'TypeScript strict mode',
+                status: 'pass',
+                detail: `${path} has "strict": true`,
+            };
+        }
+        // Check if all individual strict flags are enabled.
+        if (hasAllStrictFlags(compilerOptions)) {
+            return {
+                name: 'TypeScript strict mode',
+                status: 'pass',
+                detail: `${path} enables all individual strict flags`,
+            };
+        }
+        // Follow "extends" one level deep.
+        const extendsPath = config.extends;
+        if (typeof extendsPath === 'string') {
+            const basePath = resolveExtends(path, extendsPath);
+            const baseRaw = await source.read(basePath);
+            if (baseRaw !== null) {
+                const baseConfig = tryParseJson(baseRaw);
+                if (baseConfig !== null) {
+                    const baseCompilerOptions = baseConfig.compilerOptions;
+                    if (baseCompilerOptions?.strict === true) {
+                        // Base has strict, but check if this config explicitly overrides it.
+                        if (compilerOptions?.strict === false) {
+                            return {
+                                name: 'TypeScript strict mode',
+                                status: 'fail',
+                                detail: `${path} extends ${basePath} which has "strict": true, but ${path} overrides it with "strict": false`,
+                                suggestions: ['Remove the `"strict": false` override from compilerOptions.'],
+                            };
+                        }
+                        return {
+                            name: 'TypeScript strict mode',
+                            status: 'pass',
+                            detail: `${path} inherits "strict": true from ${basePath}`,
+                        };
+                    }
+                    if (hasAllStrictFlags(baseCompilerOptions)) {
+                        return {
+                            name: 'TypeScript strict mode',
+                            status: 'pass',
+                            detail: `${path} inherits all strict flags from ${basePath}`,
+                        };
+                    }
+                }
+            }
+        }
+        // Found a tsconfig but strict is not enabled.
+        return {
+            name: 'TypeScript strict mode',
+            status: 'fail',
+            detail: `${path} does not enable strict mode`,
+            suggestions: [
+                'Add `"strict": true` to compilerOptions in your tsconfig.',
+                'Strict mode catches null/undefined errors, implicit any types, and other common bugs at compile time.',
+            ],
+        };
+    }
+    // No tsconfig found at all.
+    return {
+        name: 'TypeScript strict mode',
+        status: 'fail',
+        detail: 'no web/tsconfig.json or web/tsconfig.app.json found',
+        suggestions: [
+            'Create a tsconfig.json in web/ with `"strict": true` in compilerOptions.',
+            'The game template includes a pre-configured tsconfig — run `fgs create` to scaffold one.',
+        ],
+    };
+}
+/** The individual flags that `"strict": true` enables. */
+const STRICT_FLAGS = [
+    'strictNullChecks',
+    'strictFunctionTypes',
+    'strictBindCallApply',
+    'strictPropertyInitialization',
+    'noImplicitAny',
+    'noImplicitThis',
+    'alwaysStrict',
+];
+function hasAllStrictFlags(compilerOptions) {
+    if (!compilerOptions)
+        return false;
+    return STRICT_FLAGS.every((flag) => compilerOptions[flag] === true);
+}
+/**
+ * Resolve an `extends` path relative to the directory of the tsconfig
+ * that contains it. Handles relative paths and bare package names that
+ * point into node_modules.
+ */
+function resolveExtends(tsconfigPath, extendsValue) {
+    const dir = tsconfigPath.slice(0, tsconfigPath.lastIndexOf('/') + 1);
+    if (extendsValue.startsWith('.')) {
+        // Relative path — resolve against the tsconfig's directory.
+        const combined = dir + extendsValue;
+        // Append .json if not already present (tsc resolves it automatically).
+        return combined.endsWith('.json') ? combined : `${combined}.json`;
+    }
+    // Bare specifier like "@tsconfig/strictest" — resolve into node_modules.
+    // Try with and without .json extension.
+    const candidate = `web/node_modules/${extendsValue}`;
+    return candidate.endsWith('.json') ? candidate : `${candidate}/tsconfig.json`;
+}
+function tryParseJson(raw) {
+    try {
+        // Strip JSON comments (tsconfig allows them) — simplistic removal
+        // of // and /* */ style comments outside strings.
+        const cleaned = raw.replace(/\/\/.*$/gm, '').replace(/\/\*[\s\S]*?\*\//g, '');
+        const parsed = JSON.parse(cleaned);
+        return typeof parsed === 'object' && parsed !== null ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=typescript-strict.js.map

package/dist/checks/typescript-strict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-strict.js","sourceRoot":"","sources":["../../src/checks/typescript-strict.ts"],"names":[],"mappings":"AAGA,MAAM,cAAc,GAAG,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,CAAC;AAEtE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAkB;IAC5D,oEAAoE;IACpE,4DAA4D;IAC5D,oEAAoE;IACpE,kBAAkB;IAClB,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,GAAG,KAAK,IAAI;YAAE,SAAS;QAE3B,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO;gBACL,IAAI,EAAE,wBAAwB;gBAC9B,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,GAAG,IAAI,oBAAoB;gBACnC,WAAW,EAAE,CAAC,kDAAkD,CAAC;aAClE,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,CAAC,eAAsD,CAAC;QAEtF,qEAAqE;QACrE,8DAA8D;QAC9D,kDAAkD;QAClD,IAAI,CAAC,eAAe,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QAED,sCAAsC;QACtC,IAAI,eAAe,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;YACrC,OAAO;gBACL,IAAI,EAAE,wBAAwB;gBAC9B,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,GAAG,IAAI,qBAAqB;aACrC,CAAC;QACJ,CAAC;QAED,oDAAoD;QACpD,IAAI,iBAAiB,CAAC,eAAe,CAAC,EAAE,CAAC;YACvC,OAAO;gBACL,IAAI,EAAE,wBAAwB;gBAC9B,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,GAAG,IAAI,sCAAsC;aACtD,CAAC;QACJ,CAAC;QAED,mCAAmC;QACnC,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC;QACnC,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;gBACzC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;oBACxB,MAAM,mBAAmB,GAAG,UAAU,CAAC,eAE1B,CAAC;oBACd,IAAI,mBAAmB,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC;wBACzC,qEAAqE;wBACrE,IAAI,eAAe,EAAE,MAAM,KAAK,KAAK,EAAE,CAAC;4BACtC,OAAO;gCACL,IAAI,EAAE,wBAAwB;gCAC9B,MAAM,EAAE,MAAM;gCACd,MAAM,EAAE,GAAG,IAAI,YAAY,QAAQ,kCAAkC,IAAI,oCAAoC;gCAC7G,WAAW,EAAE,CAAC,6DAA6D,CAAC;6BAC7E,CAAC;wBACJ,CAAC;wBACD,OAAO;4BACL,IAAI,EAAE,wBAAwB;4BAC9B,MAAM,EAAE,MAAM;4BACd,MAAM,EAAE,GAAG,IAAI,iCAAiC,QAAQ,EAAE;yBAC3D,CAAC;oBACJ,CAAC;oBAED,IAAI,iBAAiB,CAAC,mBAAmB,CAAC,EAAE,CAAC;wBAC3C,OAAO;4BACL,IAAI,EAAE,wBAAwB;4BAC9B,MAAM,EAAE,MAAM;4BACd,MAAM,EAAE,GAAG,IAAI,mCAAmC,QAAQ,EAAE;yBAC7D,CAAC;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,OAAO;YACL,IAAI,EAAE,wBAAwB;YAC9B,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,GAAG,IAAI,8BAA8B;YAC7C,WAAW,EAAE;gBACX,2DAA2D;gBAC3D,uGAAuG;aACxG;SACF,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,qDAAqD;QAC7D,WAAW,EAAE;YACX,0EAA0E;YAC1E,0FAA0F;SAC3F;KACF,CAAC;AACJ,CAAC;AAED,0DAA0D;AAC1D,MAAM,YAAY,GAAG;IACnB,kBAAkB;IAClB,qBAAqB;IACrB,qBAAqB;IACrB,8BAA8B;IAC9B,eAAe;IACf,gBAAgB;IAChB,cAAc;CACN,CAAC;AAEX,SAAS,iBAAiB,CAAC,eAAoD;IAC7E,IAAI,CAAC,eAAe;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,YAAoB,EAAE,YAAoB;IAChE,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,GAAG,GAAG,YAAY,CAAC;QACpC,uEAAuE;QACvE,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,OAAO,CAAC;IACpE,CAAC;IACD,yEAAyE;IACzE,wCAAwC;IACxC,MAAM,SAAS,GAAG,oBAAoB,YAAY,EAAE,CAAC;IACrD,OAAO,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,gBAAgB,CAAC;AAChF,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,kEAAkE;QAClE,kDAAkD;QAClD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/checks/uses-game-sdk.d.ts

@@ -0,0 +1,16 @@
+import type { FileSource } from '../lib/file-source.js';
+import type { CheckResult } from '../types.js';
+/**
+ * Every game on freegamestore.online must use the platform SDK's
+ * `GameShell` wrapper from `@freegamestore/games`. GameShell provides
+ * the standard chrome (back button, fullscreen, mute), lifecycle hooks,
+ * and platform integration (analytics, KV, rooms) that the storefront
+ * relies on.
+ *
+ * Two things are checked:
+ *   1. `@freegamestore/games` appears in `web/package.json` dependencies.
+ *   2. At least one source file in `web/src/` imports `GameShell` from
+ *      the SDK.
+ */
+export declare function checkUsesGameSdk(source: FileSource): Promise<CheckResult>;
+//# sourceMappingURL=uses-game-sdk.d.ts.map

package/dist/checks/uses-game-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uses-game-sdk.d.ts","sourceRoot":"","sources":["../../src/checks/uses-game-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAqE/E"}