miaoda-game-devkit 0.10.0 → 0.10.1

package/dist/lint/setup.mjs

@@ -1,8 +1,92 @@
 // src/lint/setup.ts
 import { afterEach } from "vitest";
 
-// src/testing/jsdom-canvas.ts
+// src/testing/jsdom-webgl.ts
+var CONSTANT_NAME = /^[A-Z][A-Z0-9_]*$/;
+var TEXTURE_UNIT_LIMIT = 32;
+var TEXTURE_SIZE_LIMIT = 4096;
+var VIEWPORT_LIMIT = 4096;
+function parameterValue(name) {
+  if (name === "VERSION") return "WebGL 2.0 (miaoda-game-devkit stub)";
+  if (name === "SHADING_LANGUAGE_VERSION") return "WebGL GLSL ES 3.00 (stub)";
+  if (name === "VENDOR" || name === "RENDERER") return "miaoda-game-devkit";
+  if (name === "MAX_VIEWPORT_DIMS") {
+    return new Int32Array([VIEWPORT_LIMIT, VIEWPORT_LIMIT]);
+  }
+  if (name === "VIEWPORT" || name === "SCISSOR_BOX") {
+    return new Int32Array([0, 0, VIEWPORT_LIMIT, VIEWPORT_LIMIT]);
+  }
+  if (name.includes("MAX_") && name.includes("SIZE")) return TEXTURE_SIZE_LIMIT;
+  if (name.startsWith("MAX_")) return TEXTURE_UNIT_LIMIT;
+  if (name.endsWith("_BITS")) return 8;
+  return 0;
+}
+function createWebGLContext(canvas, attributes) {
+  const constants = /* @__PURE__ */ new Map();
+  const constantNames = /* @__PURE__ */ new Map();
+  const state = {
+    canvas,
+    drawingBufferWidth: canvas.width,
+    drawingBufferHeight: canvas.height
+  };
+  const method = (name) => {
+    if (name === "getContextAttributes") return () => attributes;
+    if (name === "getExtension") return () => null;
+    if (name === "getSupportedExtensions") return () => [];
+    if (name === "getParameter") {
+      return (pname) => parameterValue(constantNames.get(pname) ?? "UNKNOWN");
+    }
+    if (name === "getShaderPrecisionFormat") {
+      return () => ({ rangeMin: 127, rangeMax: 127, precision: 23 });
+    }
+    if (name === "getShaderInfoLog" || name === "getProgramInfoLog") return () => "";
+    if (name === "getError") return () => 0;
+    if (name === "isContextLost") return () => false;
+    if (name.startsWith("get") && name.endsWith("Parameter")) return () => true;
+    if (name.startsWith("get")) return () => null;
+    if (name.startsWith("create") || name.startsWith("getUniformLocation")) {
+      return () => ({});
+    }
+    return () => void 0;
+  };
+  return new Proxy(state, {
+    get(target, property) {
+      if (property in target) return target[property];
+      if (typeof property !== "string") return void 0;
+      if (CONSTANT_NAME.test(property)) {
+        const existing = constants.get(property);
+        if (existing !== void 0) return existing;
+        const value = constants.size + 1;
+        constants.set(property, value);
+        constantNames.set(value, property);
+        return value;
+      }
+      const implementation = method(property);
+      target[property] = implementation;
+      return implementation;
+    }
+  });
+}
 var contexts = /* @__PURE__ */ new WeakMap();
+function getJSDOMWebGLContext(canvas, options) {
+  const existing = contexts.get(canvas);
+  if (existing) return existing;
+  const attributes = {
+    alpha: true,
+    antialias: false,
+    depth: true,
+    premultipliedAlpha: true,
+    preserveDrawingBuffer: false,
+    stencil: false,
+    ...typeof options === "object" && options !== null ? options : {}
+  };
+  const context = createWebGLContext(canvas, attributes);
+  contexts.set(canvas, context);
+  return context;
+}
+
+// src/testing/jsdom-canvas.ts
+var contexts2 = /* @__PURE__ */ new WeakMap();
 function createCanvasContext(canvas) {
   const imageData = (width = 1, height = 1) => ({
     data: new Uint8ClampedArray(width * height * 4),
@@ -49,12 +133,15 @@ function createCanvasContext(canvas) {
   return context;
 }
 function installJSDOMCanvasContext() {
-  HTMLCanvasElement.prototype.getContext = function getContext(contextId) {
+  HTMLCanvasElement.prototype.getContext = function getContext(contextId, options) {
+    if (contextId === "webgl" || contextId === "webgl2") {
+      return getJSDOMWebGLContext(this, options);
+    }
     if (contextId !== "2d") return null;
-    const existing = contexts.get(this);
+    const existing = contexts2.get(this);
     if (existing) return existing;
     const context = createCanvasContext(this);
-    contexts.set(this, context);
+    contexts2.set(this, context);
     return context;
   };
 }

package/dist/react/vitest-config.js

@@ -1452,7 +1452,36 @@ function resolvePhaser3BrowserEntry(projectRoot) {
     return void 0;
   }
 }
+var COVERAGE_INCLUDE = [
+  "src/game/core/**/*.{ts,tsx}",
+  "src/game/runtime/**/*.{ts,tsx}"
+];
+var COVERAGE_EXCLUDE = [
+  "src/game/{core,runtime}/**/*.d.ts",
+  "src/game/{core,runtime}/**/*.{spec,test}.{ts,tsx}"
+];
+var GATE_SCAN_EXCLUDE = [
+  "src/**/*.d.ts",
+  "src/**/*.{spec,test}.{ts,tsx}",
+  "src/game/example/**"
+];
+function assertCoverageScopeIsPopulated(projectRoot) {
+  const scan = (pattern) => (0, import_node_fs3.globSync)(pattern, { cwd: projectRoot, exclude: GATE_SCAN_EXCLUDE });
+  if (COVERAGE_INCLUDE.flatMap(scan).length > 0) return;
+  const misplaced = scan("src/**/{core,runtime}/**/*.{ts,tsx}");
+  if (misplaced.length === 0) return;
+  throw new Error(
+    [
+      "The coverage gate matched no source file, so it proves nothing.",
+      "Deterministic rules belong in src/game/core/; the loop, scheduling,",
+      "Controller, and Telemetry belong in src/game/runtime/.",
+      "Move these files under those two directories:",
+      ...misplaced.slice(0, 10).map((file) => `  ${file}`)
+    ].join("\n")
+  );
+}
 function defineReactGameVitestConfig(options) {
+  assertCoverageScopeIsPopulated(options.projectRoot);
   const phaser3BrowserEntry = resolvePhaser3BrowserEntry(options.projectRoot);
   return (0, import_config.defineConfig)({
     // Keep discovery and dependency resolution anchored to the generated app even
@@ -1495,14 +1524,8 @@ function defineReactGameVitestConfig(options) {
       clearMocks: true,
       coverage: {
         provider: "v8",
-        include: [
-          "src/game/core/**/*.{ts,tsx}",
-          "src/game/runtime/**/*.{ts,tsx}"
-        ],
-        exclude: [
-          "src/game/{core,runtime}/**/*.d.ts",
-          "src/game/{core,runtime}/**/*.{spec,test}.{ts,tsx}"
-        ],
+        include: COVERAGE_INCLUDE,
+        exclude: COVERAGE_EXCLUDE,
         reporter: ["text-summary"],
         thresholds: {
           perFile: true,

package/dist/react/vitest-config.mjs

@@ -1,5 +1,5 @@
 // src/react-vitest-config.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
+import { existsSync as existsSync3, globSync, readFileSync as readFileSync2 } from "fs";
 import { dirname as dirname2, resolve as resolve3 } from "path";
 import { defineConfig } from "vitest/config";
 
@@ -1418,7 +1418,36 @@ function resolvePhaser3BrowserEntry(projectRoot) {
     return void 0;
   }
 }
+var COVERAGE_INCLUDE = [
+  "src/game/core/**/*.{ts,tsx}",
+  "src/game/runtime/**/*.{ts,tsx}"
+];
+var COVERAGE_EXCLUDE = [
+  "src/game/{core,runtime}/**/*.d.ts",
+  "src/game/{core,runtime}/**/*.{spec,test}.{ts,tsx}"
+];
+var GATE_SCAN_EXCLUDE = [
+  "src/**/*.d.ts",
+  "src/**/*.{spec,test}.{ts,tsx}",
+  "src/game/example/**"
+];
+function assertCoverageScopeIsPopulated(projectRoot) {
+  const scan = (pattern) => globSync(pattern, { cwd: projectRoot, exclude: GATE_SCAN_EXCLUDE });
+  if (COVERAGE_INCLUDE.flatMap(scan).length > 0) return;
+  const misplaced = scan("src/**/{core,runtime}/**/*.{ts,tsx}");
+  if (misplaced.length === 0) return;
+  throw new Error(
+    [
+      "The coverage gate matched no source file, so it proves nothing.",
+      "Deterministic rules belong in src/game/core/; the loop, scheduling,",
+      "Controller, and Telemetry belong in src/game/runtime/.",
+      "Move these files under those two directories:",
+      ...misplaced.slice(0, 10).map((file) => `  ${file}`)
+    ].join("\n")
+  );
+}
 function defineReactGameVitestConfig(options) {
+  assertCoverageScopeIsPopulated(options.projectRoot);
   const phaser3BrowserEntry = resolvePhaser3BrowserEntry(options.projectRoot);
   return defineConfig({
     // Keep discovery and dependency resolution anchored to the generated app even
@@ -1461,14 +1490,8 @@ function defineReactGameVitestConfig(options) {
       clearMocks: true,
       coverage: {
         provider: "v8",
-        include: [
-          "src/game/core/**/*.{ts,tsx}",
-          "src/game/runtime/**/*.{ts,tsx}"
-        ],
-        exclude: [
-          "src/game/{core,runtime}/**/*.d.ts",
-          "src/game/{core,runtime}/**/*.{spec,test}.{ts,tsx}"
-        ],
+        include: COVERAGE_INCLUDE,
+        exclude: COVERAGE_EXCLUDE,
         reporter: ["text-summary"],
         thresholds: {
           perFile: true,

package/dist/react/vitest-setup.js

@@ -184,8 +184,92 @@ function runtimeFailureError(code, value) {
   return error;
 }
 
-// src/testing/jsdom-canvas.ts
+// src/testing/jsdom-webgl.ts
+var CONSTANT_NAME = /^[A-Z][A-Z0-9_]*$/;
+var TEXTURE_UNIT_LIMIT = 32;
+var TEXTURE_SIZE_LIMIT = 4096;
+var VIEWPORT_LIMIT = 4096;
+function parameterValue(name) {
+  if (name === "VERSION") return "WebGL 2.0 (miaoda-game-devkit stub)";
+  if (name === "SHADING_LANGUAGE_VERSION") return "WebGL GLSL ES 3.00 (stub)";
+  if (name === "VENDOR" || name === "RENDERER") return "miaoda-game-devkit";
+  if (name === "MAX_VIEWPORT_DIMS") {
+    return new Int32Array([VIEWPORT_LIMIT, VIEWPORT_LIMIT]);
+  }
+  if (name === "VIEWPORT" || name === "SCISSOR_BOX") {
+    return new Int32Array([0, 0, VIEWPORT_LIMIT, VIEWPORT_LIMIT]);
+  }
+  if (name.includes("MAX_") && name.includes("SIZE")) return TEXTURE_SIZE_LIMIT;
+  if (name.startsWith("MAX_")) return TEXTURE_UNIT_LIMIT;
+  if (name.endsWith("_BITS")) return 8;
+  return 0;
+}
+function createWebGLContext(canvas, attributes) {
+  const constants = /* @__PURE__ */ new Map();
+  const constantNames = /* @__PURE__ */ new Map();
+  const state = {
+    canvas,
+    drawingBufferWidth: canvas.width,
+    drawingBufferHeight: canvas.height
+  };
+  const method = (name) => {
+    if (name === "getContextAttributes") return () => attributes;
+    if (name === "getExtension") return () => null;
+    if (name === "getSupportedExtensions") return () => [];
+    if (name === "getParameter") {
+      return (pname) => parameterValue(constantNames.get(pname) ?? "UNKNOWN");
+    }
+    if (name === "getShaderPrecisionFormat") {
+      return () => ({ rangeMin: 127, rangeMax: 127, precision: 23 });
+    }
+    if (name === "getShaderInfoLog" || name === "getProgramInfoLog") return () => "";
+    if (name === "getError") return () => 0;
+    if (name === "isContextLost") return () => false;
+    if (name.startsWith("get") && name.endsWith("Parameter")) return () => true;
+    if (name.startsWith("get")) return () => null;
+    if (name.startsWith("create") || name.startsWith("getUniformLocation")) {
+      return () => ({});
+    }
+    return () => void 0;
+  };
+  return new Proxy(state, {
+    get(target, property) {
+      if (property in target) return target[property];
+      if (typeof property !== "string") return void 0;
+      if (CONSTANT_NAME.test(property)) {
+        const existing = constants.get(property);
+        if (existing !== void 0) return existing;
+        const value = constants.size + 1;
+        constants.set(property, value);
+        constantNames.set(value, property);
+        return value;
+      }
+      const implementation = method(property);
+      target[property] = implementation;
+      return implementation;
+    }
+  });
+}
 var contexts = /* @__PURE__ */ new WeakMap();
+function getJSDOMWebGLContext(canvas, options) {
+  const existing = contexts.get(canvas);
+  if (existing) return existing;
+  const attributes = {
+    alpha: true,
+    antialias: false,
+    depth: true,
+    premultipliedAlpha: true,
+    preserveDrawingBuffer: false,
+    stencil: false,
+    ...typeof options === "object" && options !== null ? options : {}
+  };
+  const context = createWebGLContext(canvas, attributes);
+  contexts.set(canvas, context);
+  return context;
+}
+
+// src/testing/jsdom-canvas.ts
+var contexts2 = /* @__PURE__ */ new WeakMap();
 function createCanvasContext(canvas) {
   const imageData = (width = 1, height = 1) => ({
     data: new Uint8ClampedArray(width * height * 4),
@@ -232,12 +316,15 @@ function createCanvasContext(canvas) {
   return context;
 }
 function installJSDOMCanvasContext() {
-  HTMLCanvasElement.prototype.getContext = function getContext(contextId) {
+  HTMLCanvasElement.prototype.getContext = function getContext(contextId, options) {
+    if (contextId === "webgl" || contextId === "webgl2") {
+      return getJSDOMWebGLContext(this, options);
+    }
     if (contextId !== "2d") return null;
-    const existing = contexts.get(this);
+    const existing = contexts2.get(this);
     if (existing) return existing;
     const context = createCanvasContext(this);
-    contexts.set(this, context);
+    contexts2.set(this, context);
     return context;
   };
 }

package/dist/react/vitest-setup.mjs

@@ -182,8 +182,92 @@ function runtimeFailureError(code, value) {
   return error;
 }
 
-// src/testing/jsdom-canvas.ts
+// src/testing/jsdom-webgl.ts
+var CONSTANT_NAME = /^[A-Z][A-Z0-9_]*$/;
+var TEXTURE_UNIT_LIMIT = 32;
+var TEXTURE_SIZE_LIMIT = 4096;
+var VIEWPORT_LIMIT = 4096;
+function parameterValue(name) {
+  if (name === "VERSION") return "WebGL 2.0 (miaoda-game-devkit stub)";
+  if (name === "SHADING_LANGUAGE_VERSION") return "WebGL GLSL ES 3.00 (stub)";
+  if (name === "VENDOR" || name === "RENDERER") return "miaoda-game-devkit";
+  if (name === "MAX_VIEWPORT_DIMS") {
+    return new Int32Array([VIEWPORT_LIMIT, VIEWPORT_LIMIT]);
+  }
+  if (name === "VIEWPORT" || name === "SCISSOR_BOX") {
+    return new Int32Array([0, 0, VIEWPORT_LIMIT, VIEWPORT_LIMIT]);
+  }
+  if (name.includes("MAX_") && name.includes("SIZE")) return TEXTURE_SIZE_LIMIT;
+  if (name.startsWith("MAX_")) return TEXTURE_UNIT_LIMIT;
+  if (name.endsWith("_BITS")) return 8;
+  return 0;
+}
+function createWebGLContext(canvas, attributes) {
+  const constants = /* @__PURE__ */ new Map();
+  const constantNames = /* @__PURE__ */ new Map();
+  const state = {
+    canvas,
+    drawingBufferWidth: canvas.width,
+    drawingBufferHeight: canvas.height
+  };
+  const method = (name) => {
+    if (name === "getContextAttributes") return () => attributes;
+    if (name === "getExtension") return () => null;
+    if (name === "getSupportedExtensions") return () => [];
+    if (name === "getParameter") {
+      return (pname) => parameterValue(constantNames.get(pname) ?? "UNKNOWN");
+    }
+    if (name === "getShaderPrecisionFormat") {
+      return () => ({ rangeMin: 127, rangeMax: 127, precision: 23 });
+    }
+    if (name === "getShaderInfoLog" || name === "getProgramInfoLog") return () => "";
+    if (name === "getError") return () => 0;
+    if (name === "isContextLost") return () => false;
+    if (name.startsWith("get") && name.endsWith("Parameter")) return () => true;
+    if (name.startsWith("get")) return () => null;
+    if (name.startsWith("create") || name.startsWith("getUniformLocation")) {
+      return () => ({});
+    }
+    return () => void 0;
+  };
+  return new Proxy(state, {
+    get(target, property) {
+      if (property in target) return target[property];
+      if (typeof property !== "string") return void 0;
+      if (CONSTANT_NAME.test(property)) {
+        const existing = constants.get(property);
+        if (existing !== void 0) return existing;
+        const value = constants.size + 1;
+        constants.set(property, value);
+        constantNames.set(value, property);
+        return value;
+      }
+      const implementation = method(property);
+      target[property] = implementation;
+      return implementation;
+    }
+  });
+}
 var contexts = /* @__PURE__ */ new WeakMap();
+function getJSDOMWebGLContext(canvas, options) {
+  const existing = contexts.get(canvas);
+  if (existing) return existing;
+  const attributes = {
+    alpha: true,
+    antialias: false,
+    depth: true,
+    premultipliedAlpha: true,
+    preserveDrawingBuffer: false,
+    stencil: false,
+    ...typeof options === "object" && options !== null ? options : {}
+  };
+  const context = createWebGLContext(canvas, attributes);
+  contexts.set(canvas, context);
+  return context;
+}
+
+// src/testing/jsdom-canvas.ts
+var contexts2 = /* @__PURE__ */ new WeakMap();
 function createCanvasContext(canvas) {
   const imageData = (width = 1, height = 1) => ({
     data: new Uint8ClampedArray(width * height * 4),
@@ -230,12 +314,15 @@ function createCanvasContext(canvas) {
   return context;
 }
 function installJSDOMCanvasContext() {
-  HTMLCanvasElement.prototype.getContext = function getContext(contextId) {
+  HTMLCanvasElement.prototype.getContext = function getContext(contextId, options) {
+    if (contextId === "webgl" || contextId === "webgl2") {
+      return getJSDOMWebGLContext(this, options);
+    }
     if (contextId !== "2d") return null;
-    const existing = contexts.get(this);
+    const existing = contexts2.get(this);
     if (existing) return existing;
     const context = createCanvasContext(this);
-    contexts.set(this, context);
+    contexts2.set(this, context);
     return context;
   };
 }

package/package.json

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