miaoda-game-devkit 0.2.13 → 0.2.15

package/README.md

@@ -4,7 +4,7 @@
 
 该开发工具包提供：
 
-- React 游戏的生产/手动时钟、Strict Mode 安全 Session ownership、JSDOM
+- React 游戏的生产/手动时钟、Strict Mode 安全 Controller ownership、JSDOM
   Vitest 配置和自动收集运行错误的 Testing Library setup，分别从 `miaoda-game-devkit/react`、
   `miaoda-game-devkit/react/testing` 和 `miaoda-game-devkit/react/vitest-config` 导入；
 
@@ -139,7 +139,9 @@ DOM 到 Phaser 的输入、命中测试和游戏状态变化，不验证 Canvas/
 
 ## 发布顺序
 
-1. 在开发工具包中运行类型检查和测试。
+1. 在开发工具包中运行类型检查和测试。`pnpm test` 会额外生成经过
+   `clean-publish` 清理的 tarball，在隔离项目中按发布目录结构解包，并以
+   `NODE_ENV=production` 运行真实 React DOM 输入测试。
 2. 使用 `pnpm run release:dry-run` 检查将要发布的文件和清理后的 `package.json`。
 3. 根据版本类型运行 `pnpm run release:patch`、`release:minor` 或 `release:major`。
    发布脚本会先测试和构建，再通过 `clean-publish` 从临时目录发布；发布包会移除

package/dist/react/index.d.mts

@@ -1,13 +1,13 @@
 export { G as GameClock, a as GameFrameCallback, b as browserGameClock } from '../game-clock-suUidZdT.mjs';
 
-interface DisposableGameSession {
+interface DisposableGameController {
     destroy(): void;
 }
 /**
- * 创建由当前组件拥有的 Session，并在真实卸载后销毁。
- * 微任务检查避免 React Strict Mode 的 effect 探测误销毁仍在使用的 Session。
- * createSession 必须只创建内存状态；监听器、定时器等外部资源应在订阅或操作时启用。
+ * Creates a Controller owned by the current component and destroys it after a
+ * real unmount. The microtask check ignores React Strict Mode effect probing.
+ * Construction must not start external work; controls or subscriptions may do so.
  */
-declare function useOwnedGameSession<TSession extends DisposableGameSession>(createSession: () => TSession): TSession;
+declare function useOwnedGameController<TController extends DisposableGameController>(createController: () => TController): TController;
 
-export { type DisposableGameSession, useOwnedGameSession };
+export { type DisposableGameController, useOwnedGameController };

package/dist/react/index.d.ts

@@ -1,13 +1,13 @@
 export { G as GameClock, a as GameFrameCallback, b as browserGameClock } from '../game-clock-suUidZdT.js';
 
-interface DisposableGameSession {
+interface DisposableGameController {
     destroy(): void;
 }
 /**
- * 创建由当前组件拥有的 Session，并在真实卸载后销毁。
- * 微任务检查避免 React Strict Mode 的 effect 探测误销毁仍在使用的 Session。
- * createSession 必须只创建内存状态；监听器、定时器等外部资源应在订阅或操作时启用。
+ * Creates a Controller owned by the current component and destroys it after a
+ * real unmount. The microtask check ignores React Strict Mode effect probing.
+ * Construction must not start external work; controls or subscriptions may do so.
  */
-declare function useOwnedGameSession<TSession extends DisposableGameSession>(createSession: () => TSession): TSession;
+declare function useOwnedGameController<TController extends DisposableGameController>(createController: () => TController): TController;
 
-export { type DisposableGameSession, useOwnedGameSession };
+export { type DisposableGameController, useOwnedGameController };

package/dist/react/index.js

@@ -21,7 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var react_exports = {};
 __export(react_exports, {
   browserGameClock: () => browserGameClock,
-  useOwnedGameSession: () => useOwnedGameSession
+  useOwnedGameController: () => useOwnedGameController
 });
 module.exports = __toCommonJS(react_exports);
 
@@ -34,24 +34,24 @@ var browserGameClock = {
   clearTimeout: (id) => window.clearTimeout(id)
 };
 
-// src/react/use-owned-game-session.ts
+// src/react/use-owned-game-controller.ts
 var import_react = require("react");
-function useOwnedGameSession(createSession) {
-  const [session] = (0, import_react.useState)(createSession);
+function useOwnedGameController(createController) {
+  const [controller] = (0, import_react.useState)(createController);
   const mounted = (0, import_react.useRef)(false);
   (0, import_react.useEffect)(() => {
     mounted.current = true;
     return () => {
       mounted.current = false;
       queueMicrotask(() => {
-        if (!mounted.current) session.destroy();
+        if (!mounted.current) controller.destroy();
       });
     };
-  }, [session]);
-  return session;
+  }, [controller]);
+  return controller;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   browserGameClock,
-  useOwnedGameSession
+  useOwnedGameController
 });

package/dist/react/index.mjs

@@ -7,23 +7,23 @@ var browserGameClock = {
   clearTimeout: (id) => window.clearTimeout(id)
 };
 
-// src/react/use-owned-game-session.ts
+// src/react/use-owned-game-controller.ts
 import { useEffect, useRef, useState } from "react";
-function useOwnedGameSession(createSession) {
-  const [session] = useState(createSession);
+function useOwnedGameController(createController) {
+  const [controller] = useState(createController);
   const mounted = useRef(false);
   useEffect(() => {
     mounted.current = true;
     return () => {
       mounted.current = false;
       queueMicrotask(() => {
-        if (!mounted.current) session.destroy();
+        if (!mounted.current) controller.destroy();
       });
     };
-  }, [session]);
-  return session;
+  }, [controller]);
+  return controller;
 }
 export {
   browserGameClock,
-  useOwnedGameSession
+  useOwnedGameController
 };

package/dist/react/vitest-config.js

@@ -60,6 +60,9 @@ function defineReactGameVitestConfig(options) {
       }
     },
     test: {
+      env: {
+        NODE_ENV: "test"
+      },
       include: [
         "src/**/*.{test,spec}.{ts,tsx}",
         "tests/**/*.{test,spec}.{ts,tsx}"

package/dist/react/vitest-config.mjs

@@ -36,6 +36,9 @@ function defineReactGameVitestConfig(options) {
       }
     },
     test: {
+      env: {
+        NODE_ENV: "test"
+      },
       include: [
         "src/**/*.{test,spec}.{ts,tsx}",
         "tests/**/*.{test,spec}.{ts,tsx}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miaoda-game-devkit",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "Shared React and Phaser game lint plus deterministic testing tools for Miaoda games",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -108,7 +108,7 @@
           "build"
         ],
         "options": {
-          "command": "vitest run --config dist/lint/contracts.config.mjs",
+          "command": "pnpm run test:contracts && pnpm run test:published",
           "cwd": "packages/game-devkit"
         }
       }