miaoda-game-devkit 0.6.1 → 0.6.3

package/dist/react/vitest-setup.js

@@ -5,6 +5,87 @@ var import_vitest = require("@testing-library/jest-dom/vitest");
 var import_react = require("@testing-library/react");
 var import_vitest2 = require("vitest");
 
+// src/react/react-error-diagnostics.ts
+var MAX_DIAGNOSTIC_LENGTH = 1e3;
+function truncate(value) {
+  const trimmed = value.trim();
+  if (trimmed.length <= MAX_DIAGNOSTIC_LENGTH) return trimmed;
+  return `${trimmed.slice(0, MAX_DIAGNOSTIC_LENGTH - 1)}\u2026`;
+}
+function safeJson(value) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  try {
+    return JSON.stringify(value, (_key, nested) => {
+      if (typeof nested === "bigint") return `${nested}n`;
+      if (typeof nested === "function") {
+        return `Function<${nested.name || "anonymous"}>`;
+      }
+      if (typeof nested === "symbol") return nested.toString();
+      if (nested && typeof nested === "object") {
+        if (seen.has(nested)) return "[Circular]";
+        seen.add(nested);
+      }
+      return nested;
+    });
+  } catch {
+    return void 0;
+  }
+}
+function collectEntries(value, fallbackCode, seen) {
+  if (typeof value === "string") {
+    return value.trim() ? [{ code: fallbackCode, message: truncate(value) }] : [];
+  }
+  if (value === null || value === void 0 || typeof value === "number" || typeof value === "boolean" || typeof value === "bigint" || typeof value === "symbol") {
+    return [{ code: fallbackCode, message: String(value) }];
+  }
+  if (typeof value === "function") {
+    return [
+      { code: fallbackCode, message: `Function<${value.name || "anonymous"}>` }
+    ];
+  }
+  if (seen.has(value)) return [];
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => collectEntries(item, fallbackCode, seen));
+  }
+  const record = value;
+  const code = typeof record.code === "string" && record.code.trim() ? record.code.trim() : fallbackCode;
+  const entries = [];
+  if (typeof record.message === "string" && record.message.trim()) {
+    entries.push({ code, message: truncate(record.message) });
+  }
+  if (record.cause !== void 0) {
+    entries.push(...collectEntries(record.cause, fallbackCode, seen));
+  }
+  if (Array.isArray(record.errors)) {
+    entries.push(...collectEntries(record.errors, fallbackCode, seen));
+  }
+  if (entries.length > 0) return entries;
+  if (typeof record.stack === "string" && record.stack.trim()) {
+    return [{ code, message: truncate(record.stack) }];
+  }
+  const json = safeJson(value);
+  return json && json !== "{}" ? [{ code, message: truncate(json) }] : [];
+}
+function extractFailureEntries(value, fallbackCode = "TEST_FAILURE") {
+  const entries = collectEntries(value, fallbackCode, /* @__PURE__ */ new WeakSet());
+  const keys = /* @__PURE__ */ new Set();
+  return entries.filter((entry) => {
+    const key = `${entry.code}\0${entry.message}`;
+    if (keys.has(key)) return false;
+    keys.add(key);
+    return true;
+  });
+}
+function runtimeFailureError(code, value) {
+  const entries = extractFailureEntries(value, code);
+  const error = new Error(
+    entries.map((entry) => entry.message).join(" | ") || "No readable runtime error value"
+  );
+  error.code = code;
+  return error;
+}
+
 // src/testing/jsdom-canvas.ts
 var contexts = /* @__PURE__ */ new WeakMap();
 function createCanvasContext(canvas) {
@@ -73,21 +154,23 @@ function clearJSDOMStorage() {
 installJSDOMCanvasContext();
 var failures = [];
 var consoleError;
-var onError = (event) => failures.push(event.error ?? event.message);
-var onRejection = (event) => failures.push(event.reason);
+var onError = (event) => failures.push(
+  runtimeFailureError("WINDOW_ERROR", event.error ?? event.message)
+);
+var onRejection = (event) => failures.push(runtimeFailureError("UNHANDLED_REJECTION", event.reason));
 (0, import_vitest2.beforeEach)(() => {
   failures = [];
   window.addEventListener("error", onError);
   window.addEventListener("unhandledrejection", onRejection);
   consoleError = import_vitest2.vi.spyOn(console, "error").mockImplementation((...args) => {
-    failures.push(args);
+    failures.push(runtimeFailureError("CONSOLE_ERROR", args));
   });
 });
 (0, import_vitest2.afterEach)(() => {
   try {
     (0, import_react.cleanup)();
   } catch (error) {
-    failures.push(error);
+    failures.push(runtimeFailureError("CLEANUP_ERROR", error));
   } finally {
     clearJSDOMStorage();
     window.removeEventListener("error", onError);

package/dist/react/vitest-setup.mjs

@@ -3,6 +3,87 @@ import "@testing-library/jest-dom/vitest";
 import { cleanup } from "@testing-library/react";
 import { afterEach, beforeEach, vi } from "vitest";
 
+// src/react/react-error-diagnostics.ts
+var MAX_DIAGNOSTIC_LENGTH = 1e3;
+function truncate(value) {
+  const trimmed = value.trim();
+  if (trimmed.length <= MAX_DIAGNOSTIC_LENGTH) return trimmed;
+  return `${trimmed.slice(0, MAX_DIAGNOSTIC_LENGTH - 1)}\u2026`;
+}
+function safeJson(value) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  try {
+    return JSON.stringify(value, (_key, nested) => {
+      if (typeof nested === "bigint") return `${nested}n`;
+      if (typeof nested === "function") {
+        return `Function<${nested.name || "anonymous"}>`;
+      }
+      if (typeof nested === "symbol") return nested.toString();
+      if (nested && typeof nested === "object") {
+        if (seen.has(nested)) return "[Circular]";
+        seen.add(nested);
+      }
+      return nested;
+    });
+  } catch {
+    return void 0;
+  }
+}
+function collectEntries(value, fallbackCode, seen) {
+  if (typeof value === "string") {
+    return value.trim() ? [{ code: fallbackCode, message: truncate(value) }] : [];
+  }
+  if (value === null || value === void 0 || typeof value === "number" || typeof value === "boolean" || typeof value === "bigint" || typeof value === "symbol") {
+    return [{ code: fallbackCode, message: String(value) }];
+  }
+  if (typeof value === "function") {
+    return [
+      { code: fallbackCode, message: `Function<${value.name || "anonymous"}>` }
+    ];
+  }
+  if (seen.has(value)) return [];
+  seen.add(value);
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => collectEntries(item, fallbackCode, seen));
+  }
+  const record = value;
+  const code = typeof record.code === "string" && record.code.trim() ? record.code.trim() : fallbackCode;
+  const entries = [];
+  if (typeof record.message === "string" && record.message.trim()) {
+    entries.push({ code, message: truncate(record.message) });
+  }
+  if (record.cause !== void 0) {
+    entries.push(...collectEntries(record.cause, fallbackCode, seen));
+  }
+  if (Array.isArray(record.errors)) {
+    entries.push(...collectEntries(record.errors, fallbackCode, seen));
+  }
+  if (entries.length > 0) return entries;
+  if (typeof record.stack === "string" && record.stack.trim()) {
+    return [{ code, message: truncate(record.stack) }];
+  }
+  const json = safeJson(value);
+  return json && json !== "{}" ? [{ code, message: truncate(json) }] : [];
+}
+function extractFailureEntries(value, fallbackCode = "TEST_FAILURE") {
+  const entries = collectEntries(value, fallbackCode, /* @__PURE__ */ new WeakSet());
+  const keys = /* @__PURE__ */ new Set();
+  return entries.filter((entry) => {
+    const key = `${entry.code}\0${entry.message}`;
+    if (keys.has(key)) return false;
+    keys.add(key);
+    return true;
+  });
+}
+function runtimeFailureError(code, value) {
+  const entries = extractFailureEntries(value, code);
+  const error = new Error(
+    entries.map((entry) => entry.message).join(" | ") || "No readable runtime error value"
+  );
+  error.code = code;
+  return error;
+}
+
 // src/testing/jsdom-canvas.ts
 var contexts = /* @__PURE__ */ new WeakMap();
 function createCanvasContext(canvas) {
@@ -71,21 +152,23 @@ function clearJSDOMStorage() {
 installJSDOMCanvasContext();
 var failures = [];
 var consoleError;
-var onError = (event) => failures.push(event.error ?? event.message);
-var onRejection = (event) => failures.push(event.reason);
+var onError = (event) => failures.push(
+  runtimeFailureError("WINDOW_ERROR", event.error ?? event.message)
+);
+var onRejection = (event) => failures.push(runtimeFailureError("UNHANDLED_REJECTION", event.reason));
 beforeEach(() => {
   failures = [];
   window.addEventListener("error", onError);
   window.addEventListener("unhandledrejection", onRejection);
   consoleError = vi.spyOn(console, "error").mockImplementation((...args) => {
-    failures.push(args);
+    failures.push(runtimeFailureError("CONSOLE_ERROR", args));
   });
 });
 afterEach(() => {
   try {
     cleanup();
   } catch (error) {
-    failures.push(error);
+    failures.push(runtimeFailureError("CLEANUP_ERROR", error));
   } finally {
     clearJSDOMStorage();
     window.removeEventListener("error", onError);

package/dist/rules/react-test-boundary-plugin.js

@@ -40,6 +40,12 @@ function internalGameImports(node) {
     return importKind === "type" ? [] : [specifier.local.name];
   });
 }
+function isStepProperty(node) {
+  return node.key.type === "Identifier" && node.key.name === "step" || node.key.type === "Literal" && node.key.value === "step";
+}
+function isEmptyFunction(value) {
+  return (value.type === "ArrowFunctionExpression" || value.type === "FunctionExpression") && value.body.type === "BlockStatement" && value.body.body.length === 0;
+}
 var rule = {
   meta: {
     type: "problem",
@@ -50,7 +56,8 @@ var rule = {
       boundExpect: "Use the expect provided by playthroughTest. An imported Vitest expect may belong to a different module instance and cannot provide reliable assertion evidence.",
       providedUser: "Use the user provided by playthroughTest; do not import or create another userEvent instance in the production playthrough.",
       productionTestingImport: "Production source must not import miaoda-game-devkit/react/testing. Inject test clocks and observers through the production App factory boundary.",
-      productionEntry: "Render <App /> from the production playthrough. Import Controller and Telemetry helpers when needed, but do not render an internal game component directly."
+      productionEntry: "Render <App /> from the production playthrough. Import Controller and Telemetry helpers when needed, but do not render an internal game component directly.",
+      emptyStep: "A deterministic step must advance production-owned time, frames, or queued work. An empty step is not gameplay evidence. Inject ManualGameClock through <App /> and call clock.stepFrame(...)."
     },
     schema: []
   },
@@ -85,6 +92,12 @@ var rule = {
         if (opening.name?.type === "JSXIdentifier" && opening.name.name && internalGameBindings.has(opening.name.name)) {
           context.report({ node, messageId: "productionEntry" });
         }
+      },
+      Property(node) {
+        if (!isProductionPlaythrough) return;
+        if (isStepProperty(node) && isEmptyFunction(node.value)) {
+          context.report({ node, messageId: "emptyStep" });
+        }
       }
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miaoda-game-devkit",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Shared React and Phaser game lint plus deterministic testing tools for Miaoda games",
   "license": "MIT",
   "main": "./dist/index.js",