@adatechnology/game-contracts 0.21.0 → 0.23.0

package/dist/testing-CJY18EZK.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Warns on the console the first time `key` is seen, and only outside production and when `globalThis.__GAME_KIT_QUIET__` is not `true`: for a silent fallback that keeps working (an adapter that made its own effects
+ * world or audio engine because the host lent none). The seen keys live on `globalThis`, so several bundles of the kit on one page warn once together.
+ */
+declare const warnOnce: (key: string, message: string) => void;
+/** Forgets what `warnOnce` has seen (tests that count warnings). */
+declare const resetWarnOnce: () => void;
+
+export { resetWarnOnce as r, warnOnce as w };

package/dist/testing.d.ts

@@ -0,0 +1 @@
+export { r as resetWarnOnce } from './testing-CJY18EZK.js';

package/dist/testing.js

@@ -0,0 +1,11 @@
+// src/warn.ts
+var WARNED_KEY = /* @__PURE__ */ Symbol.for("@adatechnology/game-contracts.warned");
+var warnedKeys = () => {
+  const holder = globalThis;
+  return holder[WARNED_KEY] ?? (holder[WARNED_KEY] = /* @__PURE__ */ new Set());
+};
+var resetWarnOnce = () => warnedKeys().clear();
+export {
+  resetWarnOnce
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/warn.ts"],"sourcesContent":["const WARNED_KEY = Symbol.for('@adatechnology/game-contracts.warned')\n\ntype WarnedHolder = { [WARNED_KEY]?: Set<string> }\n\nconst warnedKeys = (): Set<string> => {\n  const holder = globalThis as WarnedHolder\n  return (holder[WARNED_KEY] ??= new Set<string>())\n}\n\ndeclare const process: { readonly env: { readonly NODE_ENV?: string } }\n\n// The literal `process.env.NODE_ENV` is what bundlers replace; where there is no `process` the reference throws and counts as development.\nconst isProduction = (): boolean => {\n  try {\n    return process.env.NODE_ENV === 'production'\n  } catch {\n    return false\n  }\n}\n\nconst isQuiet = (): boolean => (globalThis as { __GAME_KIT_QUIET__?: unknown }).__GAME_KIT_QUIET__ === true\n\n/**\n * Warns on the console the first time `key` is seen, and only outside production and when `globalThis.__GAME_KIT_QUIET__` is not `true`: for a silent fallback that keeps working (an adapter that made its own effects\n * world or audio engine because the host lent none). The seen keys live on `globalThis`, so several bundles of the kit on one page warn once together.\n */\nexport const warnOnce = (key: string, message: string): void => {\n  if (isQuiet() || isProduction()) return\n  const seen = warnedKeys()\n  if (seen.has(key)) return\n  seen.add(key)\n  console.warn(`[game-kit] ${message}`)\n}\n\n/** Forgets what `warnOnce` has seen (tests that count warnings). */\nexport const resetWarnOnce = (): void => warnedKeys().clear()\n"],"mappings":";AAAA,IAAM,aAAa,uBAAO,IAAI,sCAAsC;AAIpE,IAAM,aAAa,MAAmB;AACpC,QAAM,SAAS;AACf,SAAQ,4CAAuB,oBAAI,IAAY;AACjD;AA4BO,IAAM,gBAAgB,MAAY,WAAW,EAAE,MAAM;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adatechnology/game-contracts",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "license": "MIT",
   "description": "The contracts every game module depends on, and nothing else: destruction (parts, hits, events, DestructibleImpl), weapons (shots), fluids (containers, item uses), item animations and the TestableModule a module hands the test room. Types plus tiny checkers, no runtime dependencies.",
   "keywords": [
@@ -33,6 +33,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "import": "./dist/testing.js"
+    },
     "./global": "./dist/index.global.js"
   },
   "files": [