miaoda-game-devkit 0.1.0

package/dist/lint/setup.mjs

@@ -0,0 +1,125 @@
+// src/lint/setup.ts
+import { afterEach } from "vitest";
+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;
+}
+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;
+};
+var HeadlessImage = class {
+  onerror = null;
+  onload = null;
+  width = 2;
+  height = 2;
+  naturalWidth = 2;
+  naturalHeight = 2;
+  complete = false;
+  source = "";
+  get src() {
+    return this.source;
+  }
+  set src(value) {
+    this.source = value;
+    this.complete = true;
+    queueMicrotask(() => {
+      if (value.startsWith("data:image/")) {
+        this.onload?.(new Event("load"));
+      } else {
+        this.onerror?.(
+          new Event("error"),
+          "Image loading is unavailable in JSDOM",
+          0,
+          0,
+          void 0
+        );
+      }
+    });
+  }
+};
+globalThis.Image = HeadlessImage;
+var storageValues = /* @__PURE__ */ new Map();
+var headlessStorage = {
+  get length() {
+    return storageValues.size;
+  },
+  clear() {
+    storageValues.clear();
+  },
+  getItem(key) {
+    return storageValues.get(key) ?? null;
+  },
+  key(index) {
+    return [...storageValues.keys()][index] ?? null;
+  },
+  removeItem(key) {
+    storageValues.delete(key);
+  },
+  setItem(key, value) {
+    storageValues.set(key, value);
+  }
+};
+Object.defineProperty(globalThis, "localStorage", {
+  configurable: true,
+  value: headlessStorage
+});
+afterEach(() => {
+  document.body.replaceChildren();
+  headlessStorage.clear();
+});

package/dist/rules/check-image-import-plugin.js

@@ -0,0 +1,92 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/rules/check-image-import-plugin.ts
+var check_image_import_plugin_exports = {};
+__export(check_image_import_plugin_exports, {
+  default: () => check_image_import_plugin_default
+});
+module.exports = __toCommonJS(check_image_import_plugin_exports);
+var import_node_fs = __toESM(require("fs"));
+var import_node_path = __toESM(require("path"));
+var import_oxc_resolver = require("oxc-resolver");
+var IMAGE_EXTENSIONS = /\.(png|jpe?g|gif|webp|svg|bmp|ico)$/i;
+var resolverCache = /* @__PURE__ */ new Map();
+function getResolver(projectRoot) {
+  if (!resolverCache.has(projectRoot)) {
+    resolverCache.set(projectRoot, new import_oxc_resolver.ResolverFactory({
+      extensions: [".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg", ".bmp", ".ico"],
+      conditionNames: ["import", "require", "node", "default"],
+      tsconfig: {
+        configFile: import_node_path.default.join(projectRoot, "tsconfig.json"),
+        references: "auto"
+      }
+    }));
+  }
+  return resolverCache.get(projectRoot);
+}
+var checkImageImportRule = {
+  meta: {
+    type: "problem",
+    docs: { description: "Check if imported image files exist" },
+    messages: {
+      imageNotFound: "Image file '{{source}}' does not exist or cannot be resolved"
+    },
+    schema: []
+  },
+  create(context) {
+    let projectRoot = import_node_path.default.dirname(context.filename);
+    while (projectRoot !== import_node_path.default.dirname(projectRoot)) {
+      if (import_node_fs.default.existsSync(import_node_path.default.join(projectRoot, "package.json"))) break;
+      projectRoot = import_node_path.default.dirname(projectRoot);
+    }
+    const resolver = getResolver(projectRoot);
+    const currentDir = import_node_path.default.dirname(context.filename);
+    return {
+      ImportDeclaration(node) {
+        const source = node.source.value;
+        if (typeof source !== "string" || !IMAGE_EXTENSIONS.test(source)) return;
+        try {
+          const resolved = resolver.sync(currentDir, source);
+          if (!resolved.path || !import_node_fs.default.existsSync(resolved.path)) {
+            context.report({ node: node.source, messageId: "imageNotFound", data: { source } });
+          }
+        } catch {
+          context.report({ node: node.source, messageId: "imageNotFound", data: { source } });
+        }
+      }
+    };
+  }
+};
+var plugin = {
+  meta: { name: "check-image-exists" },
+  rules: { "no-missing-image": checkImageImportRule }
+};
+var check_image_import_plugin_default = plugin;
+module.exports = module.exports.default;

package/dist/rules/check-style-import-plugin.js

@@ -0,0 +1,92 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/rules/check-style-import-plugin.ts
+var check_style_import_plugin_exports = {};
+__export(check_style_import_plugin_exports, {
+  default: () => check_style_import_plugin_default
+});
+module.exports = __toCommonJS(check_style_import_plugin_exports);
+var import_node_fs = __toESM(require("fs"));
+var import_node_path = __toESM(require("path"));
+var import_oxc_resolver = require("oxc-resolver");
+var STYLE_EXTENSIONS = /\.(css|scss|sass|less|styl)$/i;
+var resolverCache = /* @__PURE__ */ new Map();
+function getResolver(projectRoot) {
+  if (!resolverCache.has(projectRoot)) {
+    resolverCache.set(projectRoot, new import_oxc_resolver.ResolverFactory({
+      extensions: [".css", ".scss", ".sass", ".less", ".styl"],
+      conditionNames: ["import", "require", "node", "default"],
+      tsconfig: {
+        configFile: import_node_path.default.join(projectRoot, "tsconfig.json"),
+        references: "auto"
+      }
+    }));
+  }
+  return resolverCache.get(projectRoot);
+}
+var checkStyleImportRule = {
+  meta: {
+    type: "problem",
+    docs: { description: "Check if imported style files exist" },
+    messages: {
+      styleNotFound: "Style file '{{source}}' does not exist or cannot be resolved"
+    },
+    schema: []
+  },
+  create(context) {
+    let projectRoot = import_node_path.default.dirname(context.filename);
+    while (projectRoot !== import_node_path.default.dirname(projectRoot)) {
+      if (import_node_fs.default.existsSync(import_node_path.default.join(projectRoot, "package.json"))) break;
+      projectRoot = import_node_path.default.dirname(projectRoot);
+    }
+    const resolver = getResolver(projectRoot);
+    const currentDir = import_node_path.default.dirname(context.filename);
+    return {
+      ImportDeclaration(node) {
+        const source = node.source.value;
+        if (typeof source !== "string" || !STYLE_EXTENSIONS.test(source)) return;
+        try {
+          const resolved = resolver.sync(currentDir, source);
+          if (!resolved.path || !import_node_fs.default.existsSync(resolved.path)) {
+            context.report({ node: node.source, messageId: "styleNotFound", data: { source } });
+          }
+        } catch {
+          context.report({ node: node.source, messageId: "styleNotFound", data: { source } });
+        }
+      }
+    };
+  }
+};
+var plugin = {
+  meta: { name: "check-style-exists" },
+  rules: { "no-missing-style": checkStyleImportRule }
+};
+var check_style_import_plugin_default = plugin;
+module.exports = module.exports.default;

package/dist/vitest-config.d.mts

@@ -0,0 +1,23 @@
+import { ViteUserConfig } from 'vitest/config';
+
+interface GameVitestConfigOptions {
+    /** 模板项目的绝对根目录，通常传入 `import.meta.dirname`。 */
+    projectRoot: string;
+    /** 项目需要的额外路径别名；`@` 和 `phaser` 由 devkit 统一维护。 */
+    aliases?: Record<string, string>;
+    /** 在 devkit 基础 setup 之后执行的项目级 setup 文件。 */
+    additionalSetupFiles?: string[];
+    /** 单个游戏运行时测试的超时时间。 */
+    testTimeout?: number;
+    /** 单个游戏测试钩子的超时时间。 */
+    hookTimeout?: number;
+}
+/**
+ * 创建妙搭 Phaser 游戏的 Vitest 配置。
+ *
+ * HEADLESS 环境、游戏测试范围、Scene coverage 和 mock 隔离均由 devkit
+ * 固定；模板只传入项目根目录及少量安全扩展。
+ */
+declare function defineGameVitestConfig(options: GameVitestConfigOptions): ViteUserConfig;
+
+export { type GameVitestConfigOptions, defineGameVitestConfig };

package/dist/vitest-config.d.ts

@@ -0,0 +1,23 @@
+import { ViteUserConfig } from 'vitest/config';
+
+interface GameVitestConfigOptions {
+    /** 模板项目的绝对根目录，通常传入 `import.meta.dirname`。 */
+    projectRoot: string;
+    /** 项目需要的额外路径别名；`@` 和 `phaser` 由 devkit 统一维护。 */
+    aliases?: Record<string, string>;
+    /** 在 devkit 基础 setup 之后执行的项目级 setup 文件。 */
+    additionalSetupFiles?: string[];
+    /** 单个游戏运行时测试的超时时间。 */
+    testTimeout?: number;
+    /** 单个游戏测试钩子的超时时间。 */
+    hookTimeout?: number;
+}
+/**
+ * 创建妙搭 Phaser 游戏的 Vitest 配置。
+ *
+ * HEADLESS 环境、游戏测试范围、Scene coverage 和 mock 隔离均由 devkit
+ * 固定；模板只传入项目根目录及少量安全扩展。
+ */
+declare function defineGameVitestConfig(options: GameVitestConfigOptions): ViteUserConfig;
+
+export { type GameVitestConfigOptions, defineGameVitestConfig };

package/dist/vitest-config.js

@@ -0,0 +1,83 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vitest-config.ts
+var vitest_config_exports = {};
+__export(vitest_config_exports, {
+  defineGameVitestConfig: () => defineGameVitestConfig
+});
+module.exports = __toCommonJS(vitest_config_exports);
+var import_node_module = require("module");
+var import_node_path = require("path");
+var import_config = require("vitest/config");
+function defineGameVitestConfig(options) {
+  const projectRequire = (0, import_node_module.createRequire)((0, import_node_path.resolve)(options.projectRoot, "package.json"));
+  const phaserPackageRoot = (0, import_node_path.dirname)(projectRequire.resolve("phaser/package.json"));
+  const phaserBrowserBuild = (0, import_node_path.resolve)(phaserPackageRoot, "dist/phaser.js");
+  return (0, import_config.defineConfig)({
+    resolve: {
+      alias: {
+        ...options.aliases,
+        "@": (0, import_node_path.resolve)(options.projectRoot, "src"),
+        phaser: phaserBrowserBuild
+      }
+    },
+    test: {
+      include: ["tests/**/*.test.ts"],
+      testTimeout: options.testTimeout,
+      hookTimeout: options.hookTimeout,
+      server: {
+        deps: {
+          inline: [/miaoda-game-/]
+        }
+      },
+      environment: "jsdom",
+      environmentOptions: {
+        jsdom: {
+          url: "http://localhost/"
+        }
+      },
+      setupFiles: [
+        "miaoda-game-devkit/vitest-setup",
+        ...options.additionalSetupFiles ?? []
+      ],
+      restoreMocks: true,
+      clearMocks: true,
+      coverage: {
+        provider: "v8",
+        include: ["src/scenes/**/*.{ts,tsx}"],
+        exclude: [
+          "src/scenes/**/*.d.ts",
+          "src/scenes/**/*.{spec,test}.{ts,tsx}"
+        ],
+        reporter: ["text"],
+        thresholds: {
+          perFile: true,
+          lines: 1,
+          functions: 1,
+          statements: 1
+        }
+      }
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineGameVitestConfig
+});

package/dist/vitest-config.mjs

@@ -0,0 +1,60 @@
+// src/vitest-config.ts
+import { createRequire } from "module";
+import { dirname, resolve } from "path";
+import {
+  defineConfig
+} from "vitest/config";
+function defineGameVitestConfig(options) {
+  const projectRequire = createRequire(resolve(options.projectRoot, "package.json"));
+  const phaserPackageRoot = dirname(projectRequire.resolve("phaser/package.json"));
+  const phaserBrowserBuild = resolve(phaserPackageRoot, "dist/phaser.js");
+  return defineConfig({
+    resolve: {
+      alias: {
+        ...options.aliases,
+        "@": resolve(options.projectRoot, "src"),
+        phaser: phaserBrowserBuild
+      }
+    },
+    test: {
+      include: ["tests/**/*.test.ts"],
+      testTimeout: options.testTimeout,
+      hookTimeout: options.hookTimeout,
+      server: {
+        deps: {
+          inline: [/miaoda-game-/]
+        }
+      },
+      environment: "jsdom",
+      environmentOptions: {
+        jsdom: {
+          url: "http://localhost/"
+        }
+      },
+      setupFiles: [
+        "miaoda-game-devkit/vitest-setup",
+        ...options.additionalSetupFiles ?? []
+      ],
+      restoreMocks: true,
+      clearMocks: true,
+      coverage: {
+        provider: "v8",
+        include: ["src/scenes/**/*.{ts,tsx}"],
+        exclude: [
+          "src/scenes/**/*.d.ts",
+          "src/scenes/**/*.{spec,test}.{ts,tsx}"
+        ],
+        reporter: ["text"],
+        thresholds: {
+          perFile: true,
+          lines: 1,
+          functions: 1,
+          statements: 1
+        }
+      }
+    }
+  });
+}
+export {
+  defineGameVitestConfig
+};

package/oxlint-config.json

@@ -0,0 +1,14 @@
+{
+  "plugins": [],
+  "categories": {
+    "correctness": "off"
+  },
+  "jsPlugins": [
+    "./dist/rules/check-image-import-plugin.js",
+    "./dist/rules/check-style-import-plugin.js"
+  ],
+  "rules": {
+    "check-image-exists/no-missing-image": "error",
+    "check-style-exists/no-missing-style": "error"
+  }
+}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "miaoda-game-devkit",
+  "version": "0.1.0",
+  "description": "Shared lint and deterministic Phaser HEADLESS 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"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./vitest-config": {
+      "import": {
+        "types": "./dist/vitest-config.d.mts",
+        "default": "./dist/vitest-config.mjs"
+      },
+      "require": {
+        "types": "./dist/vitest-config.d.ts",
+        "default": "./dist/vitest-config.js"
+      }
+    },
+    "./vitest-setup": "./dist/lint/setup.mjs",
+    "./biome": "./biome-config.json",
+    "./tsconfig-base": "./tsconfig-base.json"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "biome-config.json",
+    "oxlint-config.json",
+    "tsconfig-base.json",
+    "!dist/**/*.map",
+    "!dist/lint/**/*.test.*"
+  ],
+  "nx": {
+    "tags": [
+      "type:package",
+      "scope:devkit"
+    ],
+    "targets": {
+      "build": {
+        "inputs": [
+          "default",
+          "^production",
+          {
+            "env": "NODE_ENV"
+          }
+        ]
+      },
+      "test": {
+        "executor": "nx:run-commands",
+        "dependsOn": [
+          "build"
+        ],
+        "options": {
+          "command": "./bin/miaoda-game-lint.js --contracts-only",
+          "cwd": "packages/game-devkit"
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@biomejs/biome": "2.5.6",
+    "@typescript/native-preview": "7.0.0-dev.20260707.2",
+    "jsdom": "29.1.1",
+    "oxc-resolver": "11.24.2",
+    "oxlint": "1.76.0",
+    "tailwindcss": "3.4.19",
+    "vitest": "^4.1.10"
+  },
+  "peerDependencies": {
+    "phaser": ">=3.90.0 <5"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  }
+}

package/tsconfig-base.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "noEmit": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedSideEffectImports": true,
+    "skipLibCheck": true
+  }
+}