miaoda-game-devkit 0.2.12 → 0.2.13

package/dist/lint/vitest-config.contract.mjs

@@ -1,1028 +0,0 @@
-// src/lint/vitest-config.test.ts
-import { resolve as resolve4 } from "path";
-import { describe, expect, it } from "vitest";
-
-// src/react/manual-game-clock.ts
-var ManualGameClock = class {
-  time = 0;
-  nextId = 1;
-  frames = /* @__PURE__ */ new Map();
-  timers = /* @__PURE__ */ new Map();
-  now() {
-    return this.time;
-  }
-  requestFrame(callback) {
-    const id = this.nextId++;
-    this.frames.set(id, callback);
-    return id;
-  }
-  cancelFrame(id) {
-    this.frames.delete(id);
-  }
-  setTimeout(callback, delayMs) {
-    const id = this.nextId++;
-    this.timers.set(id, { callback, dueAt: this.time + delayMs });
-    return id;
-  }
-  clearTimeout(id) {
-    this.timers.delete(id);
-  }
-  advanceBy(deltaMs) {
-    if (!Number.isFinite(deltaMs) || deltaMs < 0) {
-      throw new RangeError("deltaMs must be a non-negative finite number");
-    }
-    this.time += deltaMs;
-    const dueTimers = [...this.timers.entries()].filter(([, timer]) => timer.dueAt <= this.time).sort((left, right) => left[1].dueAt - right[1].dueAt);
-    for (const [id, timer] of dueTimers) {
-      if (timer.dueAt <= this.time && this.timers.delete(id)) timer.callback();
-    }
-  }
-  stepFrame(deltaMs = 16) {
-    this.advanceBy(deltaMs);
-    const callbacks = [...this.frames.values()];
-    this.frames.clear();
-    for (const callback of callbacks) callback(this.time);
-  }
-  stepFrames(count, deltaMs = 16) {
-    if (!Number.isInteger(count) || count < 0) {
-      throw new RangeError("count must be a non-negative integer");
-    }
-    for (let index = 0; index < count; index += 1) this.stepFrame(deltaMs);
-  }
-  pendingFrameCount() {
-    return this.frames.size;
-  }
-  pendingTimerCount() {
-    return this.timers.size;
-  }
-};
-
-// src/react-vitest-config.ts
-import { resolve } from "path";
-import { defineConfig } from "vitest/config";
-function defineReactGameVitestConfig(options) {
-  return defineConfig({
-    resolve: {
-      alias: { ...options.aliases, "@": resolve(options.projectRoot, "src") }
-    },
-    test: {
-      include: [
-        "src/**/*.{test,spec}.{ts,tsx}",
-        "tests/**/*.{test,spec}.{ts,tsx}"
-      ],
-      environment: "jsdom",
-      environmentOptions: {
-        jsdom: { url: "http://localhost/", pretendToBeVisual: true }
-      },
-      setupFiles: [
-        "miaoda-game-devkit/react/vitest-setup",
-        ...options.additionalSetupFiles ?? []
-      ],
-      reporters: ["minimal"],
-      restoreMocks: true,
-      clearMocks: true,
-      testTimeout: options.testTimeout,
-      hookTimeout: options.hookTimeout
-    }
-  });
-}
-
-// src/vite.ts
-import { existsSync } from "fs";
-import { createRequire } from "module";
-import { dirname, join, normalize, resolve as resolve2, sep } from "path";
-var PHASER_MODULE_ID = "phaser";
-var REXUI_OPTIMIZE_ENTRIES = [
-  "phaser4-rex-plugins/templates/ui/ui-plugin.js"
-];
-function isPromiseLike(value) {
-  return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
-}
-function resolvePhaserFacade(projectRoot2) {
-  const requireFromProject = createRequire(join(projectRoot2, "package.json"));
-  const viteEntry = requireFromProject.resolve("miaoda-game-devkit/vite");
-  const facade = join(dirname(viteEntry), "phaser-facade.mjs");
-  if (!existsSync(facade)) {
-    throw new Error(
-      `miaoda-game-devkit \u7F3A\u5C11 Phaser facade\uFF1A${facade}`
-    );
-  }
-  return facade;
-}
-function isInsideDirectory(filePath, directory) {
-  const normalizedFile = normalize(filePath);
-  const normalizedDirectory = `${normalize(directory)}${sep}`;
-  return normalizedFile.startsWith(normalizedDirectory);
-}
-function phaserRexUIScenePlugin(projectRoot2) {
-  let scenesRoot = projectRoot2 ? resolve2(projectRoot2, "src/scenes") : void 0;
-  let phaserFacade = projectRoot2 ? resolvePhaserFacade(projectRoot2) : void 0;
-  return {
-    name: "miaoda-phaser-rexui-scene",
-    enforce: "pre",
-    configResolved(config) {
-      const resolvedProjectRoot = projectRoot2 ?? config.root;
-      scenesRoot ??= resolve2(resolvedProjectRoot, "src/scenes");
-      phaserFacade ??= resolvePhaserFacade(resolvedProjectRoot);
-    },
-    /** 查询参数属于构建工具元数据，去除后才能稳定判断真实源码位置。 */
-    resolveId(source, importer) {
-      if (source !== PHASER_MODULE_ID || !importer || !scenesRoot) {
-        return null;
-      }
-      const cleanImporter = importer.split("?", 1)[0] ?? importer;
-      return isInsideDirectory(cleanImporter, scenesRoot) ? phaserFacade ?? null : null;
-    }
-  };
-}
-function withGameDefaults(config) {
-  const optimizeDeps = config.optimizeDeps ?? {};
-  return {
-    ...config,
-    optimizeDeps: {
-      ...optimizeDeps,
-      include: [
-        .../* @__PURE__ */ new Set([
-          ...optimizeDeps.include ?? [],
-          ...REXUI_OPTIMIZE_ENTRIES
-        ])
-      ]
-    },
-    plugins: [
-      phaserRexUIScenePlugin(),
-      ...config.plugins ?? []
-    ]
-  };
-}
-function defineGameViteConfig(config) {
-  if (typeof config === "function") {
-    return (env) => {
-      const resolved = config(env);
-      return isPromiseLike(resolved) ? resolved.then(withGameDefaults) : withGameDefaults(resolved);
-    };
-  }
-  return isPromiseLike(config) ? config.then(withGameDefaults) : withGameDefaults(config);
-}
-
-// src/vitest-config.ts
-import { resolve as resolve3 } from "path";
-import { defineConfig as defineConfig2 } from "vitest/config";
-
-// src/gameplay-audit.ts
-import { readdirSync, readFileSync, statSync } from "fs";
-import { join as join2 } from "path";
-function normalizeList(value) {
-  if (value === void 0) return [];
-  const values = typeof value === "string" ? [value] : value;
-  return [...new Set(values.map((item) => item.trim()).filter(Boolean))];
-}
-function normalizeSet(values) {
-  return [
-    ...new Set(values.map((value) => value.trim()).filter(Boolean))
-  ].sort();
-}
-function sameSet(left, right) {
-  return JSON.stringify(normalizeSet(left)) === JSON.stringify(normalizeSet(right));
-}
-function normalizeGameplayRequirements(requirements, scenes) {
-  const requiredScenes = normalizeSet([
-    ...scenes,
-    ...normalizeList(requirements.requireScene)
-  ]);
-  return {
-    requireInput: requirements.requireInput || void 0,
-    requireFrameAdvance: requirements.requireFrameAdvance || void 0,
-    requirePhysicsStep: requirements.requirePhysicsStep || void 0,
-    requireTransition: normalizeList(requirements.requireTransition),
-    requireScene: requiredScenes,
-    requireRestart: normalizeList(requirements.requireRestart),
-    requireCheckpoint: normalizeList(requirements.requireCheckpoint),
-    requireDestroy: true
-  };
-}
-function createGameplayContractMetadata(contract) {
-  const scenes = normalizeSet(contract.scenes);
-  return {
-    id: contract.id.trim(),
-    kind: contract.kind,
-    scenes,
-    requirements: normalizeGameplayRequirements(contract, scenes),
-    verified: false
-  };
-}
-function validateGameplayAuditOptions(options, projectRoot2) {
-  const issues = [];
-  const contracts = options.contracts;
-  const scenes = [...new Set(options.scenes.map((scene) => scene.trim()).filter(Boolean))];
-  const mode = options.mode ?? "interactive";
-  if (mode === "non-interactive") {
-    const justification = options.nonInteractiveJustification?.trim() ?? "";
-    if (justification.length < 20) {
-      issues.push(
-        "non-interactive \u6A21\u5F0F\u5FC5\u987B\u63D0\u4F9B\u81F3\u5C11 20 \u4E2A\u5B57\u7B26\u7684 nonInteractiveJustification\u3002"
-      );
-    }
-  }
-  if (mode !== "interactive" && mode !== "non-interactive") {
-    issues.push("gameplayAudit.mode \u5FC5\u987B\u662F interactive \u6216 non-interactive\u3002");
-  }
-  if (scenes.length === 0) issues.push("gameplayAudit.scenes \u4E0D\u80FD\u4E3A\u7A7A\u3002");
-  if (scenes.length !== options.scenes.length) {
-    issues.push("gameplayAudit.scenes \u4E0D\u80FD\u5305\u542B\u7A7A\u503C\u6216\u91CD\u590D Scene key\u3002");
-  }
-  const contractIds = /* @__PURE__ */ new Set();
-  const coveredScenes = /* @__PURE__ */ new Set();
-  const kinds = /* @__PURE__ */ new Map();
-  const invalidKindContracts = [];
-  for (const contract of contracts ?? []) {
-    const id = contract.id.trim();
-    if (!id) {
-      issues.push("gameplayAudit.contracts \u4E2D\u5B58\u5728\u7A7A contract id\u3002");
-    } else if (id !== contract.id) {
-      issues.push(`contract id "${contract.id}" \u4E0D\u80FD\u5305\u542B\u9996\u5C3E\u7A7A\u767D\u3002`);
-    } else if (contractIds.has(id)) {
-      issues.push(`gameplayAudit.contracts \u5305\u542B\u91CD\u590D contract id\uFF1A${id}\u3002`);
-    } else {
-      contractIds.add(id);
-    }
-    const testFile = contract.testFile.replaceAll("\\", "/");
-    if (!/^tests\/.+\.test\.ts$/.test(testFile) || testFile.split("/").includes("..")) {
-      issues.push(
-        `contract "${id || "<empty>"}" \u7684 testFile \u5FC5\u987B\u5339\u914D tests/**/*.test.ts\u3002`
-      );
-    }
-    const contractScenes = normalizeSet(contract.scenes);
-    if (!["boot", "playthrough", "transition", "recovery"].includes(contract.kind)) {
-      invalidKindContracts.push(id || "<empty>");
-    } else {
-      const list = kinds.get(contract.kind) ?? [];
-      list.push(contract);
-      kinds.set(contract.kind, list);
-    }
-    if (contract.kind === "playthrough") {
-      if (!contract.requireFrameAdvance) issues.push(`playthrough contract "${id}" \u5FC5\u987B requireFrameAdvance: true\u3002`);
-      if (normalizeList(contract.requireCheckpoint).length === 0) issues.push(`playthrough contract "${id}" \u5FC5\u987B\u58F0\u660E requireCheckpoint\u3002`);
-    }
-    if (contract.kind === "transition" && normalizeList(contract.requireTransition).length === 0) {
-      issues.push(`transition contract "${id}" \u5FC5\u987B\u58F0\u660E requireTransition\u3002`);
-    }
-    if (contract.kind === "recovery") {
-      if (!contract.requireFrameAdvance) issues.push(`recovery contract "${id}" \u5FC5\u987B requireFrameAdvance: true\u3002`);
-      if (normalizeList(contract.requireRestart).length === 0) issues.push(`recovery contract "${id}" \u5FC5\u987B\u58F0\u660E requireRestart\u3002`);
-      if (normalizeList(contract.requireCheckpoint).length < 2) issues.push(`recovery contract "${id}" \u81F3\u5C11\u9700\u8981\u4E24\u4E2A checkpoint\uFF08\u91CD\u7F6E\u524D\u540E\uFF09\u3002`);
-    }
-    if (contractScenes.length === 0) {
-      issues.push(`contract "${id || "<empty>"}" \u5FC5\u987B\u58F0\u660E\u81F3\u5C11\u4E00\u4E2A Scene\u3002`);
-    }
-    for (const scene of contractScenes) {
-      coveredScenes.add(scene);
-      if (!scenes.includes(scene)) {
-        issues.push(
-          `contract "${id}" \u5F15\u7528\u4E86\u672A\u5217\u5165 gameplayAudit.scenes \u7684 Scene\uFF1A${scene}\u3002`
-        );
-      }
-    }
-  }
-  if (invalidKindContracts.length > 0) {
-    issues.push(
-      `\u4EE5\u4E0B contract \u7F3A\u5C11\u6709\u6548 kind\uFF1A${invalidKindContracts.map((id) => `"${id}"`).join("\u3001")}\u3002\u8BF7\u4E3A\u6BCF\u4E2A contract \u8BBE\u7F6E kind: "boot"\u3001"playthrough"\u3001"transition" \u6216 "recovery"\u3002`
-    );
-  }
-  if (contracts) {
-    for (const scene of scenes) {
-      if (!coveredScenes.has(scene)) {
-        issues.push(`Scene "${scene}" \u6CA1\u6709\u4EFB\u4F55 gameplay contract \u8D1F\u8D23\u9A8C\u8BC1\u3002`);
-      }
-    }
-    if (contracts.length === 0)
-      issues.push("gameplayAudit.contracts \u5B58\u5728\u65F6\u4E0D\u80FD\u4E3A\u7A7A\uFF1B\u4E0D\u4F7F\u7528\u663E\u5F0F\u6E05\u5355\u8BF7\u7701\u7565\u8BE5\u5B57\u6BB5\u3002");
-  }
-  if (mode === "interactive" && contracts) {
-    const hasPlaythrough = (kinds.get("playthrough") ?? []).some(
-      (contract) => Boolean(contract.requireFrameAdvance) && normalizeList(contract.requireCheckpoint).length > 0
-    );
-    const hasInput = contracts.some((contract) => contract.requireInput);
-    if (!hasPlaythrough || !hasInput) {
-      issues.push(
-        "\u4EA4\u4E92\u9879\u76EE\u7F3A\u5C11\u6700\u4F4E\u73A9\u6CD5\u57FA\u7EBF\uFF1A\u81F3\u5C11\u4E00\u4E2A playthrough contract \u5FC5\u987B\u58F0\u660E requireFrameAdvance \u548C checkpoint\uFF0C\u4E14\u81F3\u5C11\u4E00\u4E2A contract \u5FC5\u987B\u58F0\u660E requireInput: true\u3002"
-      );
-    }
-    const restartSignal = projectRoot2 ? containsProductionRestart(projectRoot2) : false;
-    if (restartSignal && options.flows?.restart !== true) {
-      issues.push("\u68C0\u6D4B\u5230\u751F\u4EA7 Scene \u4F7F\u7528 scene.restart()\uFF1B\u5FC5\u987B\u58F0\u660E flows.restart: true \u5E76\u63D0\u4F9B kind: recovery contract\u3002");
-    } else if (restartSignal && (kinds.get("recovery") ?? []).length === 0) {
-      issues.push("\u68C0\u6D4B\u5230\u751F\u4EA7 Scene \u4F7F\u7528 scene.restart()\uFF0C\u4F46\u7F3A\u5C11 kind: recovery contract\u3002");
-    } else if ((options.flows?.restart || options.flows?.reset) && (kinds.get("recovery") ?? []).length === 0) {
-      issues.push("\u9879\u76EE\u58F0\u660E\u6216\u5B9E\u73B0\u4E86 restart/reset \u6D41\u7A0B\uFF0C\u4F46\u7F3A\u5C11 kind: recovery contract\u3002");
-    }
-  }
-  return issues;
-}
-function containsProductionRestart(projectRoot2) {
-  const sceneRoot = join2(projectRoot2, "src", "scenes");
-  const visit = (directory) => {
-    let entries;
-    try {
-      entries = readdirSync(directory);
-    } catch {
-      return false;
-    }
-    for (const entry of entries) {
-      const path = join2(directory, entry);
-      let stats;
-      try {
-        stats = statSync(path);
-      } catch {
-        continue;
-      }
-      if (stats.isDirectory() && visit(path)) return true;
-      if (!stats.isFile() || !/\.(ts|tsx)$/.test(entry)) continue;
-      try {
-        const source = readFileSync(path, "utf8").replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
-        if (/\bscene\s*\.\s*restart\s*\(/.test(source)) return true;
-      } catch {
-      }
-    }
-    return false;
-  };
-  return visit(sceneRoot);
-}
-function getDefinitionIssues(expected, actual) {
-  const issues = [];
-  const expectedMetadata = createGameplayContractMetadata(expected);
-  if (expectedMetadata.kind !== actual.kind) {
-    issues.push(`contract "${expected.id}" \u7684 kind \u4E0E gameplayAudit \u6E05\u5355\u4E0D\u4E00\u81F4\u3002`);
-  }
-  if (!sameSet(expectedMetadata.scenes, actual.scenes)) {
-    issues.push(
-      `contract "${expected.id}" \u58F0\u660E\u7684 Scene \u4E0E gameplayAudit \u6E05\u5355\u4E0D\u4E00\u81F4\u3002`
-    );
-  }
-  if (JSON.stringify(expectedMetadata.requirements) !== JSON.stringify(actual.requirements)) {
-    issues.push(
-      `contract "${expected.id}" \u7684 evidence requirements \u4E0E gameplayAudit \u6E05\u5355\u4E0D\u4E00\u81F4\u3002`
-    );
-  }
-  return issues;
-}
-function auditGameplayCollection(options, file, tests) {
-  const normalizedFile = file.replaceAll("\\", "/");
-  const expected = (options.contracts ?? []).filter(
-    (contract) => contract.testFile.replaceAll("\\", "/") === normalizedFile
-  );
-  const actual = tests.filter((test) => test.metadata);
-  const issues = [];
-  if (!options.contracts) {
-    const actualIds = /* @__PURE__ */ new Set();
-    for (const test of actual) {
-      const id = test.metadata?.id;
-      if (!id) continue;
-      if (actualIds.has(id)) issues.push(`contract "${id}" \u5728 ${normalizedFile} \u4E2D\u91CD\u590D\u5B9A\u4E49\u3002`);
-      actualIds.add(id);
-    }
-    return { passed: issues.length === 0, issues };
-  }
-  for (const contract of expected) {
-    const matches = actual.filter((test) => test.metadata?.id === contract.id);
-    if (matches.length === 0) {
-      issues.push(
-        `\u6CA1\u6709\u627E\u5230\u68C0\u67E5\u9879 "${contract.id}" \u7684\u53EF\u6267\u884C\u6D4B\u8BD5\uFF08${normalizedFile}\uFF09\u3002`
-      );
-    } else if (matches.length > 1) {
-      issues.push(
-        `contract "${contract.id}" \u5728 ${normalizedFile} \u4E2D\u91CD\u590D\u5B9A\u4E49\u3002`
-      );
-    } else if (matches[0]?.metadata) {
-      issues.push(...getDefinitionIssues(contract, matches[0].metadata));
-    }
-  }
-  for (const test of actual) {
-    const id = test.metadata?.id;
-    if (!id) continue;
-    const expectedContract = options.contracts.find(
-      (contract) => contract.id === id
-    );
-    if (!expectedContract) {
-      issues.push(
-        `\u6D4B\u8BD5 "${test.name}" \u58F0\u660E\u4E86\u672A\u5217\u5165 gameplayAudit \u6E05\u5355\u7684 contract "${id}"\u3002`
-      );
-    } else if (expectedContract.testFile.replaceAll("\\", "/") !== normalizedFile) {
-      issues.push(
-        `contract "${id}" \u5FC5\u987B\u4F4D\u4E8E ${expectedContract.testFile}\uFF0C\u5B9E\u9645\u4F4D\u4E8E ${normalizedFile}\u3002`
-      );
-    }
-  }
-  return { passed: issues.length === 0, issues };
-}
-function getGameplayEvidenceIssues(id, requirements, evidence) {
-  const issues = [];
-  const inputEvents = evidence.mouseEvents + evidence.keyboardEvents + evidence.touchEvents;
-  if (requirements.requireInput && inputEvents === 0) {
-    issues.push(`contract "${id}" \u672A\u8BB0\u5F55\u771F\u5B9E DOM \u8F93\u5165\u3002`);
-  }
-  if (requirements.requireFrameAdvance && evidence.frames === 0) {
-    issues.push(`contract "${id}" \u672A\u63A8\u8FDB\u5B8C\u6574 Phaser \u5E27\u3002`);
-  }
-  if (requirements.requirePhysicsStep && evidence.physicsSteps === 0) {
-    issues.push(`contract "${id}" \u672A\u63A8\u8FDB Arcade Physics\u3002`);
-  }
-  for (const target of normalizeList(requirements.requireTransition)) {
-    if (!evidence.transitions.some((transition) => transition.to === target)) {
-      issues.push(`contract "${id}" \u672A\u8BB0\u5F55\u5230 ${target} \u7684 Scene \u8F6C\u573A\u3002`);
-    }
-  }
-  for (const scene of normalizeList(requirements.requireScene)) {
-    if (!evidence.visitedScenes.includes(scene))
-      issues.push(`contract "${id}" \u672A\u8BBF\u95EE Scene "${scene}"\u3002`);
-  }
-  for (const scene of normalizeList(requirements.requireRestart)) {
-    if (!evidence.restartedScenes.includes(scene)) {
-      issues.push(`contract "${id}" \u672A\u91CD\u542F Scene "${scene}"\u3002`);
-    }
-  }
-  for (const checkpoint of normalizeList(requirements.requireCheckpoint)) {
-    if (!evidence.checkpoints.includes(checkpoint)) {
-      issues.push(`contract "${id}" \u7F3A\u5C11 checkpoint "${checkpoint}"\u3002`);
-    }
-  }
-  if (requirements.requireDestroy && !evidence.destroyed) {
-    issues.push(`contract "${id}" \u672A\u5B8C\u6210 HEADLESS host \u9500\u6BC1\u3002`);
-  }
-  return issues;
-}
-function auditGameplayRun(options, tests) {
-  const issues = [];
-  const actualContracts = tests.filter((test) => test.metadata);
-  const observedEvidence = [];
-  const discoveredContracts = actualContracts.flatMap((test) => {
-    const metadata = test.metadata;
-    if (!metadata) return [];
-    return [{
-      id: metadata.id,
-      kind: metadata.kind,
-      testFile: test.file,
-      scenes: metadata.scenes,
-      ...metadata.requirements
-    }];
-  });
-  const expectedContracts = options.contracts ?? discoveredContracts;
-  if (!options.contracts) {
-    const discoveredIssues = validateGameplayAuditOptions(
-      { ...options, contracts: discoveredContracts }
-    );
-    issues.push(...discoveredIssues);
-  }
-  for (const expected of expectedContracts) {
-    const matches = actualContracts.filter(
-      (test2) => test2.metadata?.id === expected.id
-    );
-    if (matches.length === 0) {
-      issues.push(`\u7F3A\u5C11 gameplay contract "${expected.id}"\u3002`);
-      continue;
-    }
-    if (matches.length > 1) {
-      issues.push(`gameplay contract "${expected.id}" \u88AB\u591A\u4E2A\u6D4B\u8BD5\u91CD\u590D\u58F0\u660E\u3002`);
-      continue;
-    }
-    const test = matches[0];
-    const metadata = test?.metadata;
-    if (!test || !metadata) continue;
-    if (metadata.evidence) observedEvidence.push(metadata.evidence);
-    if (test.file.replaceAll("\\", "/") !== expected.testFile.replaceAll("\\", "/")) {
-      issues.push(
-        `contract "${expected.id}" \u5FC5\u987B\u4F4D\u4E8E ${expected.testFile}\uFF0C\u5B9E\u9645\u4F4D\u4E8E ${test.file}\u3002`
-      );
-    }
-    issues.push(...getDefinitionIssues(expected, metadata));
-    if (test.state !== "passed") {
-      if (test.error) {
-        issues.push(`\u73A9\u6CD5\u6D4B\u8BD5 "${expected.id}" \u6D4B\u8BD5\u5931\u8D25\uFF1A${test.error}`);
-      } else {
-        issues.push(`\u73A9\u6CD5\u6D4B\u8BD5 "${expected.id}" \u7684\u6D4B\u8BD5\u72B6\u6001\u4E3A ${test.state}\u3002`);
-      }
-      continue;
-    }
-    if (!metadata.verified || !metadata.evidence) {
-      issues.push(`contract "${expected.id}" \u672A\u5B8C\u6210 onTestFinished \u8BC1\u636E\u6821\u9A8C\u3002`);
-      continue;
-    }
-    const evidenceIssues = getGameplayEvidenceIssues(
-      expected.id,
-      metadata.requirements,
-      metadata.evidence
-    );
-    issues.push(...evidenceIssues);
-  }
-  for (const test of actualContracts) {
-    const id = test.metadata?.id;
-    if (id && options.contracts && !options.contracts.some((contract) => contract.id === id)) {
-      issues.push(
-        `\u53D1\u73B0\u672A\u5217\u5165 gameplayAudit \u6E05\u5355\u7684 contract "${id}"\uFF08${test.file}\uFF09\u3002`
-      );
-    }
-  }
-  const registeredScenes = normalizeSet(
-    observedEvidence.flatMap((evidence) => evidence.registeredScenes)
-  );
-  const expectedScenes = normalizeSet(options.scenes);
-  if (observedEvidence.length > 0) {
-    for (const scene of expectedScenes) {
-      if (!registeredScenes.includes(scene)) {
-        issues.push(
-          `\u751F\u4EA7 Scene "${scene}" \u672A\u51FA\u73B0\u5728\u6D4B\u8BD5\u5B9E\u9645\u8BB0\u5F55\u7684 host registry \u4E2D\u3002`
-        );
-      }
-    }
-    for (const scene of registeredScenes) {
-      if (!expectedScenes.includes(scene)) {
-        issues.push(
-          `host registry \u51FA\u73B0\u672A\u5217\u5165 gameplayAudit.scenes \u7684\u751F\u4EA7 Scene "${scene}"\u3002`
-        );
-      }
-    }
-  }
-  return { passed: issues.length === 0, issues: [...new Set(issues)] };
-}
-
-// src/gameplay-audit-reporter.ts
-import { relative } from "path";
-function normalizePath(path) {
-  return path.replaceAll("\\", "/").replace(/^\.\//, "");
-}
-function isGameplayContractMetadata(value) {
-  if (!value || typeof value !== "object") return false;
-  const record = value;
-  return typeof record.id === "string" && Array.isArray(record.scenes) && Boolean(record.requirements) && typeof record.requirements === "object";
-}
-function toAuditTest(test) {
-  const metadata = test.meta().gameplayContract;
-  const firstError = test.result().errors?.[0];
-  return {
-    file: normalizePath(test.module.relativeModuleId),
-    name: test.fullName,
-    state: test.result().state,
-    metadata: isGameplayContractMetadata(metadata) ? metadata : void 0,
-    error: firstError?.message?.replaceAll(/\s+/g, " ").trim().slice(0, 360) || void 0
-  };
-}
-function formatGameplayIssues(issues) {
-  const groups = /* @__PURE__ */ new Map();
-  const repairKeys = /* @__PURE__ */ new Set();
-  const repairs = [];
-  const missingByFile = /* @__PURE__ */ new Map();
-  const missingIds = /* @__PURE__ */ new Set();
-  for (const issue of issues) {
-    const match = issue.match(
-      /没有找到检查项 "([^"]+)" 的可执行测试（(.+)）。/
-    );
-    if (!match) continue;
-    const [, id, file] = match;
-    missingIds.add(id);
-    const ids = missingByFile.get(file) ?? [];
-    if (!ids.includes(id)) ids.push(id);
-    missingByFile.set(file, ids);
-  }
-  const repairText = {
-    input: "\u8F93\u5165\uFF1A\u5148\u63A8\u8FDB\u4E00\u5E27\uFF0C\u518D\u901A\u8FC7 host.input.mouse\u3001host.input.keyboard \u6216 host.input.touch \u9A71\u52A8\u771F\u5B9E\u751F\u4EA7\u8F93\u5165\u3002",
-    frames: "\u5E27\u63A8\u8FDB\uFF1A\u5728\u8F93\u5165\u6216\u751F\u4EA7\u547D\u4EE4\u540E\u8C03\u7528 host.stepFrames()\uFF0C\u5F02\u6B65 update \u4F7F\u7528 host.stepFramesAsync()\u3002",
-    physics: "\u7269\u7406\uFF1A\u4EC5\u5728\u751F\u4EA7\u4F7F\u7528 Arcade Physics \u65F6\u8C03\u7528 host.stepPhysics()\uFF1B\u5176\u4ED6\u7269\u7406\u7CFB\u7EDF\u4F7F\u7528\u5B8C\u6574\u5E27\u3002",
-    transition: "\u573A\u666F\u5207\u6362\uFF1A\u542F\u52A8\u6E38\u620F\u524D\u6CE8\u518C\u76EE\u6807 Scene\uFF0C\u8C03\u7528\u6E38\u620F\u4E2D\u7684\u5207\u6362\u903B\u8F91\uFF0C\u518D\u7528 host.stepUntil() \u7B49\u5F85\u76EE\u6807\u6FC0\u6D3B\u5E76\u68C0\u67E5\u5207\u6362\u7ED3\u679C\u3002",
-    visit: "Scene\uFF1A\u786E\u8BA4\u6D4B\u8BD5\u901A\u8FC7\u771F\u5B9E\u5165\u53E3\u6216\u5408\u6CD5\u8F6C\u573A\u8BBF\u95EE\u8BE5 Scene\uFF0C\u5E76\u4F7F\u7528\u771F\u5B9E\u914D\u7F6E\u542F\u52A8\u3002",
-    restart: "\u6062\u590D\uFF1A\u901A\u8FC7\u771F\u5B9E\u8F93\u5165\u6216\u751F\u4EA7 controls \u89E6\u53D1 restart\uFF0C\u7B49\u5F85\u5B8C\u6574\u5E27\u5E76\u65AD\u8A00\u72B6\u6001\u5DF2\u6062\u590D\u3002",
-    checkpoint: "\u8FDB\u5EA6\u6807\u8BB0\uFF1A\u5148\u68C0\u67E5\u6E38\u620F\u81EA\u8EAB\u7684\u72B6\u6001\uFF08\u4F8B\u5982\u5206\u6570\u3001\u751F\u547D\u503C\u6216\u5F53\u524D\u5173\u5361\uFF09\uFF0C\u518D\u8C03\u7528 host.checkpoint()\u3002",
-    destroy: "\u6E05\u7406\uFF1A\u5728 afterEach \u4E2D\u8C03\u7528 host.destroy()\uFF0C\u5E76\u4FDD\u6301\u9500\u6BC1\u5E42\u7B49\u3002",
-    registry: "Scene \u6CE8\u518C\uFF1A\u786E\u8BA4\u6E38\u620F\u6E90\u7801\u6CE8\u518C\u4E86\u8BE5 Scene\uFF1B\u6D4B\u8BD5\u9700\u8981\u5207\u6362\u5230\u5B83\u65F6\uFF0C\u5728\u521B\u5EFA host \u65F6\u901A\u8FC7 additionalScenes \u63D0\u4F9B Scene \u7C7B\u3002",
-    missing: "\u6253\u5F00\u4E0A\u8FF0\u6587\u4EF6\uFF0C\u7528 gameplayTest \u6DFB\u52A0\u8FD9\u4E9B\u73A9\u6CD5\u6D4B\u8BD5\uFF1Bid \u5FC5\u987B\u4E0E vitest.config.ts \u4E2D\u7684\u914D\u7F6E\u5B8C\u5168\u4E00\u81F4\uFF0C\u521B\u5EFA host \u540E\u8C03\u7528 contract.attachHost(host)\u3002",
-    test: "\u5148\u4FEE\u590D\u5BF9\u5E94\u6D4B\u8BD5\u4E0A\u65B9\u663E\u793A\u7684\u7B2C\u4E00\u6761\u539F\u59CB\u9519\u8BEF\uFF0C\u7136\u540E\u91CD\u65B0\u8FD0\u884C pnpm test\u3002",
-    unhandled: "\u5F02\u6B65\u9519\u8BEF\uFF1A\u5148\u4FEE\u590D\u4E0A\u65B9\u663E\u793A\u7684\u7B2C\u4E00\u6761\u9519\u8BEF\uFF1B\u8F93\u5165\u3001\u5E27\u63A8\u8FDB\u548C\u751F\u547D\u5468\u671F\u64CD\u4F5C\u90FD\u8981\u5728\u6B63\u786E\u7684 host \u751F\u547D\u5468\u671F\u5185\u5E76\u4F7F\u7528 await\u3002"
-  };
-  const getCategory = (issue) => {
-    if (issue.includes("\u672A\u8BB0\u5F55\u771F\u5B9E DOM \u8F93\u5165")) return { category: "input", key: "input" };
-    if (issue.includes("\u672A\u63A8\u8FDB\u5B8C\u6574 Phaser \u5E27")) return { category: "frames", key: "frames" };
-    if (issue.includes("\u672A\u63A8\u8FDB Arcade Physics")) return { category: "physics", key: "physics" };
-    if (issue.includes("\u672A\u8BB0\u5F55\u5230 ") && issue.includes("Scene \u8F6C\u573A")) {
-      const target = issue.match(/未记录到 (.+?) 的 Scene 转场/)?.[1] ?? "unknown";
-      return { category: "transition", key: `transition:${target}` };
-    }
-    if (issue.includes("\u672A\u8BBF\u95EE Scene")) {
-      const scene = issue.match(/未访问 Scene "([^"]+)"/)?.[1] ?? "unknown";
-      return { category: "visit", key: `visit:${scene}` };
-    }
-    if (issue.includes("\u672A\u91CD\u542F Scene")) {
-      const scene = issue.match(/未重启 Scene "([^"]+)"/)?.[1] ?? "unknown";
-      return { category: "restart", key: `restart:${scene}` };
-    }
-    if (issue.includes("\u7F3A\u5C11 checkpoint")) return { category: "checkpoint", key: `checkpoint:${issue.match(/checkpoint "([^"]+)"/)?.[1] ?? issue}` };
-    if (issue.includes("\u672A\u5B8C\u6210 HEADLESS host \u9500\u6BC1")) return { category: "destroy", key: "destroy" };
-    if (issue.includes("\u672A\u51FA\u73B0\u5728\u6D4B\u8BD5\u5B9E\u9645\u8BB0\u5F55\u7684 host registry")) {
-      const scene = issue.match(/生产 Scene "([^"]+)"/)?.[1] ?? "unknown";
-      return { category: "registry", key: `registry:${scene}` };
-    }
-    if (issue.includes("\u7F3A\u5C11 gameplay contract")) return { category: "missing", key: "missing" };
-    if (issue.includes("\u6D4B\u8BD5\u5931\u8D25\uFF1A")) {
-      const message = issue.split("\u6D4B\u8BD5\u5931\u8D25\uFF1A")[1] ?? issue;
-      return { category: "test", key: `test:${message}` };
-    }
-    if (issue.includes("\u6D4B\u8BD5\u8FD0\u884C\u671F\u95F4\u53D1\u751F\u5F02\u6B65\u9519\u8BEF\uFF1A")) {
-      const message = issue.split("\u6D4B\u8BD5\u8FD0\u884C\u671F\u95F4\u53D1\u751F\u5F02\u6B65\u9519\u8BEF\uFF1A")[1] ?? issue;
-      return { category: "unhandled", key: `test:${message}` };
-    }
-    if (issue.includes("\u7684\u6D4B\u8BD5\u72B6\u6001\u4E3A")) return { category: "test", key: "test" };
-    return { category: "other", key: `other:${issue}` };
-  };
-  for (const [file, ids] of missingByFile) {
-    groups.set(`missing:${file}`, {
-      text: `${file} \u4E2D\u6CA1\u6709\u627E\u5230\u914D\u7F6E\u8981\u6C42\u7684\u73A9\u6CD5\u6D4B\u8BD5\uFF1A${ids.join("\u3001")}\u3002`,
-      ids: [],
-      key: `missing:${file}`
-    });
-  }
-  if (missingByFile.size > 0) {
-    repairKeys.add("missing");
-    repairs.push(repairText.missing);
-  }
-  for (const rawIssue of [...new Set(issues)]) {
-    const compact = rawIssue.replaceAll(/\s+/g, " ").trim();
-    if (compact.startsWith("\u6CA1\u6709\u627E\u5230\u68C0\u67E5\u9879 ")) continue;
-    const missingContract = compact.match(/缺少 (?:gameplay )?contract "([^"]+)"/)?.[1];
-    if (missingContract && missingIds.has(missingContract)) continue;
-    if (missingIds.size > 0 && compact.includes("\u672A\u51FA\u73B0\u5728\u6D4B\u8BD5\u5B9E\u9645\u8BB0\u5F55\u7684 host registry")) {
-      continue;
-    }
-    const readable = compact.replaceAll(/(?:gameplay )?contract "([^"]+)"/g, '\u73A9\u6CD5\u6D4B\u8BD5 "$1"').replaceAll("evidence requirements", "\u8981\u6C42\u9A8C\u8BC1\u7684\u6E38\u620F\u884C\u4E3A").replaceAll("metadata", "\u6D4B\u8BD5\u914D\u7F6E").replaceAll("host registry", "\u6D4B\u8BD5\u8BB0\u5F55\u7684 Scene \u5217\u8868");
-    const id = compact.match(/(?:contract|玩法测试) "([^"]+)"/)?.[1];
-    const { category, key } = getCategory(compact);
-    const group = groups.get(key);
-    if (group) {
-      if (id && !group.ids.includes(id)) group.ids.push(id);
-    } else {
-      groups.set(key, { text: readable, ids: id ? [id] : [], key });
-    }
-    if (repairText[category] && !repairKeys.has(category)) {
-      repairKeys.add(category);
-      repairs.push(repairText[category]);
-    }
-  }
-  const grouped = [...groups.values()];
-  const visible = grouped.slice(0, 8).map((group) => {
-    if (group.ids.length <= 1) return group.text;
-    return `${group.text}\uFF08\u540C\u7C7B\u95EE\u9898\u8FD8\u51FA\u73B0\u5728\uFF1A${group.ids.slice(1).join("\u3001")}\uFF09`;
-  });
-  return {
-    issues: visible.map(
-      (issue) => issue.length > 360 ? `${issue.slice(0, 357)}...` : issue
-    ),
-    repairs: repairs.slice(0, 8),
-    omitted: Math.max(0, grouped.length - visible.length)
-  };
-}
-function printIssues(stage, issues) {
-  if (issues.length === 0) return;
-  console.error(`
-GAMEPLAY_AUDIT: ${stage} FAILED`);
-  console.error("\u73A9\u6CD5\u6D4B\u8BD5\u672A\u901A\u8FC7\u3002\u8BF7\u5148\u5904\u7406\u7B2C\u4E00\u7C7B\u95EE\u9898\uFF0C\u91CD\u65B0\u8FD0\u884C\u540E\u518D\u5904\u7406\u540E\u7EED\u95EE\u9898\u3002");
-  const formatted = formatGameplayIssues(issues);
-  for (const issue of formatted.issues) console.error(`- ${issue}`);
-  if (formatted.repairs.length > 0) {
-    console.error("\u4FEE\u590D\u5EFA\u8BAE\uFF08\u540C\u7C7B\u95EE\u9898\u53EA\u5217\u4E00\u6B21\uFF09\uFF1A");
-    for (const repair of formatted.repairs) console.error(`- ${repair}`);
-  }
-  if (formatted.omitted > 0) {
-    console.error(
-      `- \u5176\u4F59 ${formatted.omitted} \u7C7B\u95EE\u9898\u5DF2\u7701\u7565\uFF1B\u5148\u4FEE\u590D\u4EE5\u4E0A\u95EE\u9898\u540E\u91CD\u65B0\u8FD0\u884C pnpm test\u3002`
-    );
-  }
-}
-var GameplayAuditReporter = class {
-  projectRoot;
-  options;
-  preflightIssues = /* @__PURE__ */ new Set();
-  /** 创建绑定到单个游戏项目根目录和权威清单的 reporter。 */
-  constructor(projectRoot2, options) {
-    this.projectRoot = projectRoot2;
-    this.options = options;
-  }
-  /** 每次 Vitest 运行开始时重置预检状态，并检查清单中的测试文件是否会执行。 */
-  onTestRunStart(specifications) {
-    this.preflightIssues.clear();
-    const scheduledFiles = new Set(
-      specifications.map(
-        (specification) => normalizePath(relative(this.projectRoot, specification.moduleId))
-      )
-    );
-    for (const contract of this.options.contracts ?? []) {
-      const testFile = normalizePath(contract.testFile);
-      if (!scheduledFiles.has(testFile)) {
-        this.reportPreflightIssue(
-          `contract "${contract.id}" \u7684\u6D4B\u8BD5\u6587\u4EF6\u672A\u8FDB\u5165\u672C\u6B21 Vitest \u8FD0\u884C\uFF1A${testFile}\u3002`
-        );
-      }
-    }
-  }
-  /** 在测试文件执行前检查静态 metadata 是否声明了该文件负责的全部 contract。 */
-  onTestModuleCollected(testModule) {
-    const file = normalizePath(testModule.relativeModuleId);
-    const tests = [...testModule.children.allTests()].map(toAuditTest);
-    const result = auditGameplayCollection(this.options, file, tests);
-    for (const issue of result.issues) this.reportPreflightIssue(issue);
-  }
-  /** 在测试运行结束后汇总全部 contract、Ledger 和 Scene registry，并决定命令退出码。 */
-  onTestRunEnd(testModules, unhandledErrors = [], reason = "passed") {
-    const collectionFailed = reason === "failed" && testModules.some(
-      (testModule) => testModule.state() === "failed" && [...testModule.children.allTests()].length === 0
-    );
-    if (collectionFailed) {
-      console.error(
-        "\nGAMEPLAY_AUDIT: NOT RUN\n\u73A9\u6CD5\u6D4B\u8BD5\u6587\u4EF6\u65E0\u6CD5\u52A0\u8F7D\uFF0C\u56E0\u6B64\u65E0\u6CD5\u68C0\u67E5\u6E38\u620F\u884C\u4E3A\u3002\u8BF7\u5148\u4FEE\u590D Vitest \u4E0A\u65B9\u663E\u793A\u7684\u8BED\u6CD5\u6216\u5BFC\u5165\u9519\u8BEF\uFF0C\u518D\u8FD0\u884C pnpm test\u3002"
-      );
-      process.exitCode = 1;
-      return;
-    }
-    const tests = testModules.flatMap(
-      (testModule) => [...testModule.children.allTests()].map(toAuditTest)
-    );
-    const result = auditGameplayRun(this.options, tests);
-    const runtimeIssues = unhandledErrors.map((error) => error.message?.replaceAll(/\s+/g, " ").trim()).filter(Boolean).map((message) => `\u6D4B\u8BD5\u8FD0\u884C\u671F\u95F4\u53D1\u751F\u5F02\u6B65\u9519\u8BEF\uFF1A${message}`);
-    const combinedIssues = [
-      ...this.preflightIssues,
-      ...result.issues,
-      ...runtimeIssues
-    ];
-    if (combinedIssues.length > 0) {
-      printIssues("FINAL", [...new Set(combinedIssues)]);
-      process.exitCode = 1;
-    } else {
-      console.log(
-        `
-GAMEPLAY_AUDIT: ALL CONTRACTS PASSED (${tests.filter((test) => test.metadata).length} contracts, ${this.options.scenes.length} scenes)`
-      );
-      console.log(
-        "GAMEPLAY_AUDIT_NOTE: \u73A9\u6CD5\u68C0\u67E5\u5DF2\u901A\u8FC7\uFF1B\u4ECD\u9700\u4EE5\u6700\u540E\u7684 TEST_RESULT \u5224\u65AD\u6574\u4F53\u6210\u529F\u3002"
-      );
-    }
-  }
-  /** 立即输出一个此前未报告过的预检缺口，并让本次测试命令失败。 */
-  reportPreflightIssue(issue) {
-    if (this.preflightIssues.has(issue)) return;
-    this.preflightIssues.add(issue);
-    process.exitCode = 1;
-  }
-};
-
-// src/vitest-config.ts
-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);
-  if (auditIssues.length > 0) {
-    throw new Error(
-      `\u65E0\u6548\u7684 gameplayAudit \u914D\u7F6E\uFF1A
-- ${auditIssues.join("\n- ")}`
-    );
-  }
-  return defineConfig2({
-    plugins: [phaserRexUIScenePlugin(options.projectRoot)],
-    resolve: {
-      alias: {
-        ...options.aliases,
-        "@": resolve3(options.projectRoot, "src")
-      }
-    },
-    // devkit 作为 external ESM 加载时，应用测试也必须 externalize Phaser，
-    // 否则 Vite alias 与 Node 条件导出会创建两个 Phaser 单例，Scene 无法启动。
-    ssr: {
-      external: ["phaser"]
-    },
-    test: {
-      include: ["tests/**/*.test.ts"],
-      testTimeout: options.testTimeout,
-      hookTimeout: options.hookTimeout,
-      server: {
-        deps: {
-          // devkit 模块需要在配置和审计阶段使用 Node 内置模块。
-          // 如果强制内联，Vite 会把这些模块按浏览器模块转换，
-          // 最终触发 "No such built-in module: node:"。
-          external: [/miaoda-game-devkit/],
-          inline: [
-            PHASER_FACADE_DEPENDENCY,
-            REXUI_DEPENDENCY,
-            ...options.inlineDependencies ?? []
-          ]
-        }
-      },
-      environment: "jsdom",
-      environmentOptions: {
-        jsdom: {
-          url: "http://localhost/"
-        }
-      },
-      setupFiles: [
-        "miaoda-game-devkit/vitest-setup",
-        ...options.additionalSetupFiles ?? []
-      ],
-      reporters: [
-        // Vitest's minimal reporter is optimized for AI output: passing tests
-        // stay quiet while failed tests retain their useful error message.
-        "minimal",
-        new GameplayAuditReporter(options.projectRoot, options.gameplayAudit)
-      ],
-      restoreMocks: true,
-      clearMocks: true,
-      coverage: {
-        provider: "v8",
-        include: ["src/scenes/**/*.{ts,tsx}"],
-        exclude: [
-          "src/scenes/**/*.d.ts",
-          "src/scenes/**/*.{spec,test}.{ts,tsx}"
-        ],
-        // Per-file threshold errors still identify omitted Scene files; the
-        // summary avoids printing a large coverage table on every successful run.
-        reporter: ["text-summary"],
-        thresholds: {
-          perFile: true,
-          lines: 1,
-          functions: 1,
-          statements: 1
-        }
-      }
-    }
-  });
-}
-
-// src/lint/vitest-config.test.ts
-var projectRoot = resolve4(import.meta.dirname, "../..");
-var gameplayAudit = {
-  mode: "non-interactive",
-  nonInteractiveJustification: "\u56FA\u5B9A\u5939\u5177\u53EA\u9A8C\u8BC1\u5171\u4EAB host \u57FA\u7EBF\uFF0C\u4E0D\u5305\u542B\u73A9\u6CD5\u8F93\u5165\u3002",
-  scenes: ["InputScene"],
-  contracts: [
-    {
-      id: "InputScene.boot",
-      kind: "boot",
-      testFile: "tests/input.test.ts",
-      scenes: ["InputScene"],
-      requireFrameAdvance: true
-    }
-  ]
-};
-describe("defineGameVitestConfig", () => {
-  it("defineGameViteConfig \u4FDD\u6301 Vite defineConfig \u7684\u5E38\u7528\u8F93\u5165\u5F62\u5F0F", async () => {
-    const objectConfig = defineGameViteConfig({ plugins: [] });
-    expect(objectConfig.plugins?.[0]).toMatchObject({
-      name: "miaoda-phaser-rexui-scene"
-    });
-    const promiseConfig = await defineGameViteConfig(Promise.resolve({}));
-    expect(promiseConfig.plugins?.[0]).toMatchObject({
-      name: "miaoda-phaser-rexui-scene"
-    });
-    const functionConfig = defineGameViteConfig(() => ({ resolve: {} }));
-    const resolvedFunctionConfig = functionConfig({ command: "serve", mode: "test" });
-    expect(resolvedFunctionConfig.plugins?.[0]).toMatchObject({
-      name: "miaoda-phaser-rexui-scene"
-    });
-  });
-  it("defineGameViteConfig \u9884\u6784\u5EFA\u52A8\u6001 RexUI \u5165\u53E3\u5E76\u4FDD\u7559\u9879\u76EE\u914D\u7F6E", () => {
-    const config = defineGameViteConfig({
-      optimizeDeps: {
-        include: ["application-dependency"],
-        exclude: ["excluded-dependency"]
-      }
-    });
-    expect(config.optimizeDeps).toEqual({
-      include: [
-        "application-dependency",
-        "phaser4-rex-plugins/templates/ui/ui-plugin.js"
-      ],
-      exclude: ["excluded-dependency"]
-    });
-  });
-  it("\u63D0\u4F9B Phaser \u8FD0\u884C\u65F6\u6D4B\u8BD5\u9700\u8981\u7684\u56FA\u5B9A\u57FA\u7EBF", () => {
-    const config = defineGameVitestConfig({ projectRoot, gameplayAudit });
-    expect(config.resolve?.alias).toMatchObject({
-      "@": resolve4(projectRoot, "src")
-    });
-    expect(config.plugins).toEqual([
-      expect.objectContaining({ name: "miaoda-phaser-rexui-scene" })
-    ]);
-    expect(config.resolve?.alias).not.toHaveProperty("phaser");
-    expect(config.ssr).toMatchObject({ external: ["phaser"] });
-    expect(config.test).toMatchObject({
-      include: ["tests/**/*.test.ts"],
-      server: {
-        deps: {
-          external: [/miaoda-game-devkit/],
-          inline: [
-            /miaoda-game-devkit[\\/]dist[\\/]phaser-facade\.mjs$/,
-            /phaser4-rex-plugins/
-          ]
-        }
-      },
-      environment: "jsdom",
-      environmentOptions: { jsdom: { url: "http://localhost/" } },
-      setupFiles: ["miaoda-game-devkit/vitest-setup"],
-      reporters: ["minimal", expect.any(Object)],
-      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-summary"],
-        thresholds: {
-          perFile: true,
-          lines: 1,
-          functions: 1,
-          statements: 1
-        }
-      }
-    });
-  });
-  it("\u4FDD\u7559\u5B89\u5168\u6269\u5C55\u5E76\u5728\u57FA\u7840 setup \u4E4B\u540E\u8FFD\u52A0\u9879\u76EE setup", () => {
-    const config = defineGameVitestConfig({
-      projectRoot,
-      gameplayAudit,
-      inlineDependencies: [/project-specific-inline-dependency/],
-      additionalSetupFiles: ["tests/custom-setup.ts"],
-      testTimeout: 5e3,
-      hookTimeout: 2e3
-    });
-    expect(config.test).toMatchObject({
-      include: ["tests/**/*.test.ts"],
-      setupFiles: ["miaoda-game-devkit/vitest-setup", "tests/custom-setup.ts"],
-      server: {
-        deps: {
-          inline: [
-            /miaoda-game-devkit[\\/]dist[\\/]phaser-facade\.mjs$/,
-            /phaser4-rex-plugins/,
-            /project-specific-inline-dependency/
-          ]
-        }
-      },
-      testTimeout: 5e3,
-      hookTimeout: 2e3
-    });
-  });
-  it("\u62D2\u7EDD\u7F3A\u5C11 Scene contract \u7684\u5BA1\u8BA1\u6E05\u5355", () => {
-    expect(
-      () => defineGameVitestConfig({
-        projectRoot,
-        gameplayAudit: {
-          scenes: ["InputScene", "ResultScene"],
-          contracts: gameplayAudit.contracts
-        }
-      })
-    ).toThrow(/ResultScene.*没有任何 gameplay contract/s);
-  });
-  it("\u62D2\u7EDD\u4EA4\u4E92\u9879\u76EE\u53EA\u6709 boot smoke test", () => {
-    expect(
-      () => defineGameVitestConfig({
-        projectRoot,
-        gameplayAudit: {
-          mode: "interactive",
-          scenes: ["InputScene"],
-          contracts: gameplayAudit.contracts
-        }
-      })
-    ).toThrow(/缺少最低玩法基线/);
-  });
-});
-describe("React game devkit", () => {
-  it("\u63D0\u4F9B\u9694\u79BB\u4E8E Phaser \u5BA1\u8BA1\u7684 JSDOM \u914D\u7F6E", () => {
-    const config = defineReactGameVitestConfig({ projectRoot });
-    expect(config.resolve?.alias).toMatchObject({
-      "@": resolve4(projectRoot, "src")
-    });
-    expect(config.ssr).toBeUndefined();
-    expect(config.test).toMatchObject({
-      environment: "jsdom",
-      environmentOptions: {
-        jsdom: { url: "http://localhost/", pretendToBeVisual: true }
-      },
-      include: [
-        "src/**/*.{test,spec}.{ts,tsx}",
-        "tests/**/*.{test,spec}.{ts,tsx}"
-      ],
-      setupFiles: ["miaoda-game-devkit/react/vitest-setup"],
-      reporters: ["minimal"],
-      restoreMocks: true,
-      clearMocks: true
-    });
-  });
-  it("\u624B\u52A8\u65F6\u949F\u786E\u5B9A\u6027\u63A8\u8FDB\u5E76\u6E05\u7406\u5E27\u548C\u5B9A\u65F6\u5668", () => {
-    const clock = new ManualGameClock();
-    let frames = 0;
-    const timers = [];
-    clock.requestFrame(() => frames++);
-    clock.setTimeout(() => timers.push("late"), 20);
-    clock.setTimeout(() => timers.push("early"), 10);
-    clock.stepFrame(10);
-    expect({ frames, timers }).toEqual({ frames: 1, timers: ["early"] });
-    clock.advanceBy(10);
-    expect({ frames, timers }).toEqual({ frames: 1, timers: ["early", "late"] });
-    expect(clock.pendingFrameCount()).toBe(0);
-    expect(clock.pendingTimerCount()).toBe(0);
-  });
-});