miaoda-game-devkit 0.2.12 → 0.2.13

package/dist/react/vitest-setup.js

@@ -4,6 +4,73 @@
 var import_vitest = require("@testing-library/jest-dom/vitest");
 var import_react = require("@testing-library/react");
 var import_vitest2 = require("vitest");
+
+// src/testing/jsdom-canvas.ts
+var contexts = /* @__PURE__ */ new WeakMap();
+function createCanvasContext(canvas) {
+  const imageData = (width = 1, height = 1) => ({
+    data: new Uint8ClampedArray(width * height * 4),
+    width,
+    height,
+    colorSpace: "srgb"
+  });
+  const state = {
+    canvas,
+    font: "16px sans-serif"
+  };
+  const context = new Proxy(state, {
+    get(target, property) {
+      if (property in target) return target[property];
+      if (property === "createImageData" || property === "getImageData") {
+        return (...args) => imageData(args.at(-2), args.at(-1));
+      }
+      if (property === "measureText") {
+        return (value) => {
+          const font = String(target.font ?? "16px sans-serif");
+          const size = Number.parseFloat(font.match(/([\d.]+)px/)?.[1] ?? "16");
+          const width = [...String(value)].reduce((total, character) => {
+            if (/\s/.test(character)) return total + size * 0.33;
+            if (/[^\u0000-\u00ff]/.test(character)) return total + size;
+            if (/[MW@#%&]/.test(character)) return total + size * 0.9;
+            if (/[ilI1.,'`]/.test(character)) return total + size * 0.32;
+            if (/[A-Z0-9]/.test(character)) return total + size * 0.64;
+            return total + size * 0.56;
+          }, 0);
+          return {
+            width,
+            actualBoundingBoxAscent: size * 0.8,
+            actualBoundingBoxDescent: size * 0.2
+          };
+        };
+      }
+      if (property === "createLinearGradient" || property === "createRadialGradient") {
+        return () => ({ addColorStop() {
+        } });
+      }
+      return () => void 0;
+    }
+  });
+  return context;
+}
+function installJSDOMCanvasContext() {
+  HTMLCanvasElement.prototype.getContext = function getContext(contextId) {
+    if (contextId !== "2d") return null;
+    const existing = contexts.get(this);
+    if (existing) return existing;
+    const context = createCanvasContext(this);
+    contexts.set(this, context);
+    return context;
+  };
+}
+
+// src/testing/jsdom-storage.ts
+function clearJSDOMStorage() {
+  window.localStorage.clear();
+  window.sessionStorage.clear();
+}
+
+// src/react-vitest-setup.ts
+installJSDOMCanvasContext();
 var failures = [];
 var consoleError;
 var onError = (event) => failures.push(event.error ?? event.message);
@@ -22,6 +89,7 @@ var onRejection = (event) => failures.push(event.reason);
   } catch (error) {
     failures.push(error);
   } finally {
+    clearJSDOMStorage();
     window.removeEventListener("error", onError);
     window.removeEventListener("unhandledrejection", onRejection);
     consoleError?.mockRestore();
@@ -30,6 +98,9 @@ var onRejection = (event) => failures.push(event.reason);
   if (failures.length > 0) {
     const captured = failures;
     failures = [];
-    throw new AggregateError(captured, "Unexpected React/JSDOM runtime failures");
+    throw new AggregateError(
+      captured,
+      "Unexpected React/JSDOM runtime failures"
+    );
   }
 });

package/dist/react/vitest-setup.mjs

@@ -2,6 +2,73 @@
 import "@testing-library/jest-dom/vitest";
 import { cleanup } from "@testing-library/react";
 import { afterEach, beforeEach, vi } from "vitest";
+
+// src/testing/jsdom-canvas.ts
+var contexts = /* @__PURE__ */ new WeakMap();
+function createCanvasContext(canvas) {
+  const imageData = (width = 1, height = 1) => ({
+    data: new Uint8ClampedArray(width * height * 4),
+    width,
+    height,
+    colorSpace: "srgb"
+  });
+  const state = {
+    canvas,
+    font: "16px sans-serif"
+  };
+  const context = new Proxy(state, {
+    get(target, property) {
+      if (property in target) return target[property];
+      if (property === "createImageData" || property === "getImageData") {
+        return (...args) => imageData(args.at(-2), args.at(-1));
+      }
+      if (property === "measureText") {
+        return (value) => {
+          const font = String(target.font ?? "16px sans-serif");
+          const size = Number.parseFloat(font.match(/([\d.]+)px/)?.[1] ?? "16");
+          const width = [...String(value)].reduce((total, character) => {
+            if (/\s/.test(character)) return total + size * 0.33;
+            if (/[^\u0000-\u00ff]/.test(character)) return total + size;
+            if (/[MW@#%&]/.test(character)) return total + size * 0.9;
+            if (/[ilI1.,'`]/.test(character)) return total + size * 0.32;
+            if (/[A-Z0-9]/.test(character)) return total + size * 0.64;
+            return total + size * 0.56;
+          }, 0);
+          return {
+            width,
+            actualBoundingBoxAscent: size * 0.8,
+            actualBoundingBoxDescent: size * 0.2
+          };
+        };
+      }
+      if (property === "createLinearGradient" || property === "createRadialGradient") {
+        return () => ({ addColorStop() {
+        } });
+      }
+      return () => void 0;
+    }
+  });
+  return context;
+}
+function installJSDOMCanvasContext() {
+  HTMLCanvasElement.prototype.getContext = function getContext(contextId) {
+    if (contextId !== "2d") return null;
+    const existing = contexts.get(this);
+    if (existing) return existing;
+    const context = createCanvasContext(this);
+    contexts.set(this, context);
+    return context;
+  };
+}
+
+// src/testing/jsdom-storage.ts
+function clearJSDOMStorage() {
+  window.localStorage.clear();
+  window.sessionStorage.clear();
+}
+
+// src/react-vitest-setup.ts
+installJSDOMCanvasContext();
 var failures = [];
 var consoleError;
 var onError = (event) => failures.push(event.error ?? event.message);
@@ -20,6 +87,7 @@ afterEach(() => {
   } catch (error) {
     failures.push(error);
   } finally {
+    clearJSDOMStorage();
     window.removeEventListener("error", onError);
     window.removeEventListener("unhandledrejection", onRejection);
     consoleError?.mockRestore();
@@ -28,6 +96,9 @@ afterEach(() => {
   if (failures.length > 0) {
     const captured = failures;
     failures = [];
-    throw new AggregateError(captured, "Unexpected React/JSDOM runtime failures");
+    throw new AggregateError(
+      captured,
+      "Unexpected React/JSDOM runtime failures"
+    );
   }
 });

package/dist/vitest-config.js

@@ -627,6 +627,12 @@ GAMEPLAY_AUDIT: ALL CONTRACTS PASSED (${tests.filter((test) => test.metadata).le
   }
 };
 
+// src/testing/vitest-node-args.ts
+function getJSDOMWorkerExecArgv() {
+  const nodeMajor = Number.parseInt(process.versions.node, 10);
+  return nodeMajor >= 25 ? ["--no-experimental-webstorage"] : [];
+}
+
 // src/vite.ts
 var import_node_fs2 = require("fs");
 var import_node_module = require("module");
@@ -674,7 +680,10 @@ function phaserRexUIScenePlugin(projectRoot) {
 var PHASER_FACADE_DEPENDENCY = /miaoda-game-devkit[\\/]dist[\\/]phaser-facade\.mjs$/;
 var REXUI_DEPENDENCY = /phaser4-rex-plugins/;
 function defineGameVitestConfig(options) {
-  const auditIssues = validateGameplayAuditOptions(options.gameplayAudit, options.projectRoot);
+  const auditIssues = validateGameplayAuditOptions(
+    options.gameplayAudit,
+    options.projectRoot
+  );
   if (auditIssues.length > 0) {
     throw new Error(
       `\u65E0\u6548\u7684 gameplayAudit \u914D\u7F6E\uFF1A
@@ -696,6 +705,7 @@ function defineGameVitestConfig(options) {
     },
     test: {
       include: ["tests/**/*.test.ts"],
+      execArgv: getJSDOMWorkerExecArgv(),
       testTimeout: options.testTimeout,
       hookTimeout: options.hookTimeout,
       server: {
@@ -721,6 +731,11 @@ function defineGameVitestConfig(options) {
         "miaoda-game-devkit/vitest-setup",
         ...options.additionalSetupFiles ?? []
       ],
+      sequence: {
+        // Vitest 默认并行执行多个 setup file；这里保证项目 setup
+        // 始终在 devkit 完成环境边界后运行。
+        setupFiles: "list"
+      },
       reporters: [
         // Vitest's minimal reporter is optimized for AI output: passing tests
         // stay quiet while failed tests retain their useful error message.

package/dist/vitest-config.mjs

@@ -603,6 +603,12 @@ GAMEPLAY_AUDIT: ALL CONTRACTS PASSED (${tests.filter((test) => test.metadata).le
   }
 };
 
+// src/testing/vitest-node-args.ts
+function getJSDOMWorkerExecArgv() {
+  const nodeMajor = Number.parseInt(process.versions.node, 10);
+  return nodeMajor >= 25 ? ["--no-experimental-webstorage"] : [];
+}
+
 // src/vite.ts
 import { existsSync } from "fs";
 import { createRequire } from "module";
@@ -650,7 +656,10 @@ function phaserRexUIScenePlugin(projectRoot) {
 var PHASER_FACADE_DEPENDENCY = /miaoda-game-devkit[\\/]dist[\\/]phaser-facade\.mjs$/;
 var REXUI_DEPENDENCY = /phaser4-rex-plugins/;
 function defineGameVitestConfig(options) {
-  const auditIssues = validateGameplayAuditOptions(options.gameplayAudit, options.projectRoot);
+  const auditIssues = validateGameplayAuditOptions(
+    options.gameplayAudit,
+    options.projectRoot
+  );
   if (auditIssues.length > 0) {
     throw new Error(
       `\u65E0\u6548\u7684 gameplayAudit \u914D\u7F6E\uFF1A
@@ -672,6 +681,7 @@ function defineGameVitestConfig(options) {
     },
     test: {
       include: ["tests/**/*.test.ts"],
+      execArgv: getJSDOMWorkerExecArgv(),
       testTimeout: options.testTimeout,
       hookTimeout: options.hookTimeout,
       server: {
@@ -697,6 +707,11 @@ function defineGameVitestConfig(options) {
         "miaoda-game-devkit/vitest-setup",
         ...options.additionalSetupFiles ?? []
       ],
+      sequence: {
+        // Vitest 默认并行执行多个 setup file；这里保证项目 setup
+        // 始终在 devkit 完成环境边界后运行。
+        setupFiles: "list"
+      },
       reporters: [
         // Vitest's minimal reporter is optimized for AI output: passing tests
         // stay quiet while failed tests retain their useful error message.

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "miaoda-game-devkit",
-  "version": "0.2.12",
-  "description": "Shared lint and deterministic Phaser HEADLESS testing tools for Miaoda games",
+  "version": "0.2.13",
+  "description": "Shared React and Phaser game lint plus deterministic testing tools for Miaoda games",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "bin": {
-    "miaoda-game-lint": "bin/miaoda-game-lint.js"
+    "miaoda-phaser-game-lint": "bin/miaoda-phaser-game-lint.js",
+    "miaoda-react-game-lint": "bin/miaoda-react-game-lint.js"
   },
   "exports": {
     ".": {
@@ -82,6 +83,8 @@
     "oxlint-config.json",
     "tsconfig-base.json",
     "!dist/**/*.map",
+    "!dist/lint/*.contract.mjs",
+    "!dist/lint/contracts.config.mjs",
     "!dist/lint/**/*.test.*"
   ],
   "nx": {
@@ -105,7 +108,7 @@
           "build"
         ],
         "options": {
-          "command": "./bin/miaoda-game-lint.js --contracts-only",
+          "command": "vitest run --config dist/lint/contracts.config.mjs",
           "cwd": "packages/game-devkit"
         }
       }

package/bin/miaoda-game-lint.js

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-
-require('../dist/cli/lint.js');

package/dist/cli/lint.js

@@ -1,127 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-
-// src/cli/lint.ts
-var import_node_child_process = require("child_process");
-var import_node_fs = require("fs");
-var import_node_module = require("module");
-var import_node_os = require("os");
-var import_node_path = require("path");
-var devkitRoot = (0, import_node_path.resolve)(__dirname, "../..");
-var projectRoot = process.cwd();
-var requireFromDevkit = (0, import_node_module.createRequire)((0, import_node_path.join)(devkitRoot, "package.json"));
-var contractsOnly = process.argv.slice(2).includes("--contracts-only");
-var projectBiomeConfig = (0, import_node_path.join)(projectRoot, "biome.json");
-var biomeConfig = (0, import_node_fs.existsSync)(projectBiomeConfig) ? projectBiomeConfig : (0, import_node_path.join)(devkitRoot, "biome-config.json");
-function resolveBin(packageName, binName) {
-  const packageJsonPath = requireFromDevkit.resolve(`${packageName}/package.json`);
-  const packageJson = JSON.parse((0, import_node_fs.readFileSync)(packageJsonPath, "utf8"));
-  const relativeBin = typeof packageJson.bin === "string" ? packageJson.bin : packageJson.bin?.[binName];
-  if (!relativeBin) {
-    throw new Error(`${packageName} does not expose the ${binName} executable`);
-  }
-  return (0, import_node_path.resolve)((0, import_node_path.dirname)(packageJsonPath), relativeBin);
-}
-function run(name, packageName, binName, args) {
-  return new Promise((resolveResult) => {
-    const child = (0, import_node_child_process.spawn)(process.execPath, [resolveBin(packageName, binName), ...args], {
-      cwd: projectRoot,
-      env: process.env,
-      stdio: "inherit"
-    });
-    child.once("error", (error) => {
-      console.error(`[${name}] ${error.message}`);
-      resolveResult({ name, ok: false });
-    });
-    child.once("close", (code, signal) => {
-      if (signal) {
-        console.error(`[${name}] terminated by ${signal}`);
-      }
-      resolveResult({ name, ok: code === 0 && signal === null });
-    });
-  });
-}
-async function runContracts() {
-  return run(
-    "vitest",
-    "vitest",
-    "vitest",
-    ["run", "--config", (0, import_node_path.join)(devkitRoot, "dist/lint/contracts.config.mjs")]
-  );
-}
-function checkGameViteConfig() {
-  const viteConfigPath = (0, import_node_path.join)(projectRoot, "vite.config.ts");
-  if (!(0, import_node_fs.existsSync)(viteConfigPath)) {
-    console.error(
-      "[vite-config] \u7F3A\u5C11\u6A21\u677F\u5FC5\u9700\u7684 vite.config.ts\u3002\u8BF7\u6062\u590D\u6A21\u677F\u539F\u6587\u4EF6\u540E\u91CD\u65B0\u8FD0\u884C pnpm lint\u3002"
-    );
-    return { name: "vite-config", ok: false };
-  }
-  const source = (0, import_node_fs.readFileSync)(viteConfigPath, "utf8");
-  const hasDevkitImport = /from\s+["']miaoda-game-devkit\/vite["']/.test(source);
-  const hasConfigCall = /defineGameViteConfig\s*\(/.test(source);
-  if (!hasDevkitImport || !hasConfigCall) {
-    console.error(
-      "[vite-config] vite.config.ts \u672A\u4F7F\u7528\u6A21\u677F\u89C4\u5B9A\u7684\u914D\u7F6E\u5165\u53E3\u3002\n\u8BF7\u4ECE miaoda-game-devkit/vite \u5BFC\u5165 defineGameViteConfig\uFF0C\u5E76\u7528 defineGameViteConfig({ ... }) \u5305\u4F4F\u5F53\u524D\u7684\u914D\u7F6E\u5BF9\u8C61\u3002\n\u53EA\u66FF\u6362\u914D\u7F6E\u51FD\u6570\uFF0C\u4FDD\u7559\u73B0\u6709 plugins\u3001resolve \u7B49\u5BF9\u8C61\u5185\u5BB9\u4E0D\u53D8\u3002"
-    );
-    return { name: "vite-config", ok: false };
-  }
-  return { name: "vite-config", ok: true };
-}
-function projectUsesPhaser4() {
-  const manifestPath = (0, import_node_path.join)(projectRoot, "package.json");
-  if (!(0, import_node_fs.existsSync)(manifestPath)) return false;
-  try {
-    const manifest = JSON.parse((0, import_node_fs.readFileSync)(manifestPath, "utf8"));
-    const version = manifest.dependencies?.phaser ?? manifest.devDependencies?.phaser;
-    return typeof version === "string" && /(?:^|[^0-9])4(?:\.|$)/.test(version);
-  } catch {
-    return false;
-  }
-}
-async function runAllChecks() {
-  if (contractsOnly) {
-    return [await runContracts()];
-  }
-  const viteConfig = projectUsesPhaser4() ? [checkGameViteConfig()] : [];
-  const [tsgo, biome] = await Promise.all([
-    run("tsgo", "@typescript/native-preview", "tsgo", ["-p", "tsconfig.json"]),
-    run("biome", "@biomejs/biome", "biome", [
-      "lint",
-      "--config-path",
-      biomeConfig,
-      "src"
-    ])
-  ]);
-  const tailwindOutput = (0, import_node_path.join)((0, import_node_os.tmpdir)(), `miaoda-game-devkit-${process.pid}.css`);
-  const tailwind = await run("tailwind", "tailwindcss", "tailwindcss", [
-    "-i",
-    (0, import_node_path.join)(projectRoot, "src/index.css"),
-    "-o",
-    tailwindOutput
-  ]);
-  (0, import_node_fs.rmSync)(tailwindOutput, { force: true });
-  const oxlint = await run("oxlint", "oxlint", "oxlint", [
-    "-c",
-    (0, import_node_path.join)(devkitRoot, "oxlint-config.json"),
-    "src"
-  ]);
-  const contracts = await runContracts();
-  return [...viteConfig, tsgo, biome, tailwind, oxlint, contracts];
-}
-async function main() {
-  const results = await runAllChecks();
-  const failed = results.filter((result) => !result.ok);
-  console.log("");
-  if (failed.length === 0) {
-    console.log("RESULT: ALL CHECKS PASSED - Finished with 0 errors. Found no issues.");
-    return;
-  }
-  console.error(`RESULT: FAILED - Found errors in: ${failed.map(({ name }) => name).join(", ")}`);
-  console.error("Fix all lint errors, then re-run 'pnpm lint'.");
-  process.exitCode = 1;
-}
-main().catch((error) => {
-  console.error(error);
-  process.exitCode = 1;
-});

package/dist/lint/contracts.config.mjs

@@ -1,38 +0,0 @@
-// src/lint/vitest.config.ts
-import { dirname, resolve } from "path";
-import { fileURLToPath } from "url";
-import { defineConfig } from "vitest/config";
-var phaserPackageRoot = dirname(
-  fileURLToPath(import.meta.resolve("phaser/package.json"))
-);
-var vitest_config_default = defineConfig({
-  resolve: {
-    alias: {
-      phaser: resolve(phaserPackageRoot, "dist/phaser.js")
-    }
-  },
-  test: {
-    server: {
-      deps: {
-        // 合约文件运行在 Vitest 的 Node worker 中，不能被 Vite
-        // 按浏览器模块转换。
-        external: [/miaoda-game-devkit/]
-      }
-    },
-    environment: "jsdom",
-    environmentOptions: {
-      jsdom: {
-        url: "http://localhost/"
-      }
-    },
-    include: [resolve(import.meta.dirname, "*.contract.mjs")],
-    // 发布后的契约位于使用方的 node_modules 目录中。
-    exclude: [],
-    setupFiles: [resolve(import.meta.dirname, "setup.mjs")],
-    restoreMocks: true,
-    clearMocks: true
-  }
-});
-export {
-  vitest_config_default as default
-};