@freegamestore/compliance 0.7.0 → 0.8.0

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":"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"}

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"}

package/dist/checks/uses-game-sdk.js

@@ -0,0 +1,82 @@
+import { stripCommentsForExt } from '../lib/strip.js';
+const PACKAGE_JSON = 'web/package.json';
+const SDK_PACKAGE = '@freegamestore/games';
+const SCAN_EXTS = new Set(['.ts', '.tsx', '.js', '.jsx']);
+/**
+ * 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 async function checkUsesGameSdk(source) {
+    // Check 1: SDK in package.json dependencies.
+    const pkgRaw = await source.read(PACKAGE_JSON);
+    let hasDependency = false;
+    if (pkgRaw !== null) {
+        try {
+            const pkg = JSON.parse(pkgRaw);
+            hasDependency =
+                (typeof pkg.dependencies === 'object' && SDK_PACKAGE in pkg.dependencies) ||
+                    (typeof pkg.devDependencies === 'object' && SDK_PACKAGE in pkg.devDependencies);
+        }
+        catch {
+            // Invalid JSON — will fail the dependency check below.
+        }
+    }
+    // Check 2: GameShell import in source files under web/src/.
+    let hasGameShellImport = false;
+    for await (const path of source.list()) {
+        if (!path.startsWith('web/src/'))
+            continue;
+        const ext = extOf(path);
+        if (!SCAN_EXTS.has(ext))
+            continue;
+        const raw = await source.read(path);
+        if (!raw)
+            continue;
+        const content = stripCommentsForExt(raw, ext);
+        // Match: import { GameShell } from '@freegamestore/games'
+        //        import { GameShell, ... } from '@freegamestore/games'
+        //        import { ..., GameShell } from '@freegamestore/games'
+        if (/import\s+\{[^}]*\bGameShell\b[^}]*\}\s+from\s+['"]@freegamestore\/games['"]/i.test(content)) {
+            hasGameShellImport = true;
+            break;
+        }
+    }
+    if (hasDependency && hasGameShellImport) {
+        return {
+            name: 'Uses GameShell SDK',
+            status: 'pass',
+            detail: '@freegamestore/games dependency present and GameShell imported',
+        };
+    }
+    const issues = [];
+    const suggestions = [];
+    if (!hasDependency) {
+        issues.push(`${SDK_PACKAGE} not in web/package.json dependencies`);
+        suggestions.push(`Run \`cd web && npm install ${SDK_PACKAGE}\` to add the platform SDK.`);
+    }
+    if (!hasGameShellImport) {
+        issues.push('no GameShell import found in web/src/');
+        suggestions.push('Import and use GameShell in your entry point: `import { GameShell } from \'@freegamestore/games\';`');
+        suggestions.push('GameShell provides the standard game chrome (back, fullscreen, mute), lifecycle hooks, and platform integration.');
+    }
+    return {
+        name: 'Uses GameShell SDK',
+        status: 'fail',
+        detail: issues.join('; '),
+        suggestions,
+    };
+}
+function extOf(path) {
+    const dot = path.lastIndexOf('.');
+    const slash = path.lastIndexOf('/');
+    return dot > slash ? path.slice(dot).toLowerCase() : '';
+}
+//# sourceMappingURL=uses-game-sdk.js.map

package/dist/checks/uses-game-sdk.js.map

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

package/dist/checks/uses-localstorage.d.ts

@@ -0,0 +1,14 @@
+import type { FileSource } from '../lib/file-source.js';
+import type { CheckResult } from '../types.js';
+/**
+ * Games should save progress and/or high scores locally so players feel
+ * rewarded for returning. This check looks for `localStorage` usage or
+ * the `useHighScore` hook import (from the games SDK) anywhere under
+ * `web/src/`.
+ *
+ * WARN level — not every game needs persistence. Short-session games
+ * (Flappy Bird, reaction timers) are perfectly valid without saves. The
+ * guideline is "Saves progress/high scores locally," not a hard gate.
+ */
+export declare function checkUsesLocalStorage(source: FileSource): Promise<CheckResult>;
+//# sourceMappingURL=uses-localstorage.d.ts.map

package/dist/checks/uses-localstorage.d.ts.map

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

package/dist/checks/uses-localstorage.js

@@ -0,0 +1,45 @@
+/**
+ * Games should save progress and/or high scores locally so players feel
+ * rewarded for returning. This check looks for `localStorage` usage or
+ * the `useHighScore` hook import (from the games SDK) anywhere under
+ * `web/src/`.
+ *
+ * WARN level — not every game needs persistence. Short-session games
+ * (Flappy Bird, reaction timers) are perfectly valid without saves. The
+ * guideline is "Saves progress/high scores locally," not a hard gate.
+ */
+export async function checkUsesLocalStorage(source) {
+    for await (const path of source.list()) {
+        if (!path.startsWith('web/src/'))
+            continue;
+        const content = await source.read(path);
+        if (!content)
+            continue;
+        // Direct localStorage usage
+        if (/\blocalStorage\b/.test(content)) {
+            return {
+                name: 'Local storage for progress/scores',
+                status: 'pass',
+                detail: `localStorage usage found in ${path}`,
+            };
+        }
+        // SDK high-score hook
+        if (/\buseHighScore\b/.test(content)) {
+            return {
+                name: 'Local storage for progress/scores',
+                status: 'pass',
+                detail: `useHighScore hook found in ${path}`,
+            };
+        }
+    }
+    return {
+        name: 'Local storage for progress/scores',
+        status: 'warn',
+        detail: 'no localStorage usage or useHighScore hook found in web/src/',
+        suggestions: [
+            'Consider saving high scores or progress with localStorage so returning players feel rewarded.',
+            'The games SDK provides a useHighScore() hook that handles serialisation and leaderboard formatting.',
+        ],
+    };
+}
+//# sourceMappingURL=uses-localstorage.js.map

package/dist/checks/uses-localstorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uses-localstorage.js","sourceRoot":"","sources":["../../src/checks/uses-localstorage.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAkB;IAC5D,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAS;QAE3C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,4BAA4B;QAC5B,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,OAAO;gBACL,IAAI,EAAE,mCAAmC;gBACzC,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,+BAA+B,IAAI,EAAE;aAC9C,CAAC;QACJ,CAAC;QAED,sBAAsB;QACtB,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,OAAO;gBACL,IAAI,EAAE,mCAAmC;gBACzC,MAAM,EAAE,MAAM;gBACd,MAAM,EAAE,8BAA8B,IAAI,EAAE;aAC7C,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,mCAAmC;QACzC,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,8DAA8D;QACtE,WAAW,EAAE;YACX,+FAA+F;YAC/F,qGAAqG;SACtG;KACF,CAAC;AACJ,CAAC"}