@uzuhq/code-sdk 0.8.2 → 0.8.3

package/dist/index.js

@@ -848,7 +848,8 @@ function replaceRoot(doc, value) {
 //#region src/dev-prediction-traps.ts
 /** 描画経路の警告に使う擬似 action 名。 */
 const RENDER_CONTEXT = "(render)";
-const CLOCK_TRAPS = [{ install: (report) => {
+/** 実時刻。先読みでも描画でもサーバーとズレる。 */
+const WALL_CLOCK_TRAPS = [{ install: (report) => {
 	const RealDate = Date;
 	const realNow = Date.now;
 	globalThis.Date = new Proxy(RealDate, { construct: (target, args) => {
@@ -863,7 +864,22 @@ const CLOCK_TRAPS = [{ install: (report) => {
 		Date.now = realNow;
 		globalThis.Date = RealDate;
 	};
-} }, { install: (report) => {
+} }];
+/**
+* 単調時計。**描画では張らない。**
+*
+* `gameTime()` の実装がこれを使っている。描画から毎フレーム呼ぶ前提の公開 API なので、
+* 描画でも張ると「時刻は gameTime() から取れ」という指示どおりに書いたコードが
+* そのまま警告される。誤検知が常時出ると本物の `Date.now()` 混入まで無視される。
+*
+* 代償として、生の `performance.now()` を描画で締切に混ぜる誤りは拾えない。実時刻ほど
+* 桁が飛ばず (どちらも小さい数なので静かに少しズレる)、かつ作家が書くのは圧倒的に
+* `Date.now()` の方なので、この取りこぼしを受け入れる。
+*
+* 先読みでは張る。`gameTime()` の値を state に書けばサーバーの結果とズレるので、
+* これは正しい検出になる。
+*/
+const MONOTONIC_TRAPS = [{ install: (report) => {
 	const real = globalThis.performance?.now;
 	if (!real) return () => {};
 	const bound = real.bind(globalThis.performance);
@@ -897,7 +913,12 @@ const RANDOM_TRAPS = [{ install: (report) => {
 		globalThis.crypto.randomUUID = real;
 	};
 } }];
-const TRAPS = [...CLOCK_TRAPS, ...RANDOM_TRAPS];
+const PREDICTION_TRAPS = [
+	...WALL_CLOCK_TRAPS,
+	...MONOTONIC_TRAPS,
+	...RANDOM_TRAPS
+];
+const RENDER_TRAPS = WALL_CLOCK_TRAPS;
 const warnings = [];
 const reported = /* @__PURE__ */ new Set();
 const printWarning = (action, api) => {
@@ -957,7 +978,8 @@ const runPredicted = (action, run) => {
 /**
 * `onState` から同期で走る描画を計装する。
 *
-* 乱数は描画で使ってよいので、時刻の罠だけ張る。ここで拾えるのは同期の描画だけで、
+* 張るのは実時刻だけ。乱数は演出に使ってよく、単調時計は `gameTime()` の実装が
+* 使っているので張れない (`MONOTONIC_TRAPS` を見よ)。ここで拾えるのは同期の描画だけで、
 * `requestAnimationFrame` の中は原理的に拾えない。
 */
 const runRendered = (run) => {
@@ -979,7 +1001,7 @@ const runInstrumented = (action, run) => {
 		printWarning(action, api);
 		notifyParent(action, api);
 	};
-	const restores = (action === RENDER_CONTEXT ? CLOCK_TRAPS : TRAPS).map((trap) => trap.install(report));
+	const restores = (action === RENDER_CONTEXT ? RENDER_TRAPS : PREDICTION_TRAPS).map((trap) => trap.install(report));
 	try {
 		run();
 	} finally {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uzuhq/code-sdk",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "UZU PlayScreen SDK - Flutter ↔ JS ゲーム通信ライブラリ",
   "type": "module",
   "exports": {