kitchen-simulator 5.10.7-react.18 → 5.10.9-react.18

package/es/index.js

@@ -1,3 +1,4 @@
+import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
 import _extends from "@babel/runtime/helpers/esm/extends";
 import _classCallCheck from "@babel/runtime/helpers/esm/classCallCheck";
 import _createClass from "@babel/runtime/helpers/esm/createClass";
@@ -5,6 +6,9 @@ import _possibleConstructorReturn from "@babel/runtime/helpers/esm/possibleConst
 import _getPrototypeOf from "@babel/runtime/helpers/esm/getPrototypeOf";
 import _inherits from "@babel/runtime/helpers/esm/inherits";
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
+import _toConsumableArray from "@babel/runtime/helpers/esm/toConsumableArray";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
 function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
@@ -17,6 +21,66 @@ import LiteRenderer from "./LiteRenderer";
 import { createRoot } from 'react-dom/client';
 var ROOT_KEY = '__kitchenSimulatorRoot__';
 var API_KEY = '__kitchenSimulatorApi__';
+
+/**
+ * Debug logging
+ * - Enable via:
+ *   - window.__kitchenSimulatorDebug__ = true
+ *   - or pass props.debug = true to renderKitchenSimulator(container, { debug: true })
+ */
+function makeLogger(getEnabled) {
+  var prefix = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '[kitchen-simulator]';
+  var now = function now() {
+    return (typeof performance !== 'undefined' && performance.now ? performance.now() : Date.now()).toFixed(1);
+  };
+  var safe = function safe(v) {
+    try {
+      if (v == null) return v;
+      if (typeof v === 'string') return v;
+      if (typeof v === 'number' || typeof v === 'boolean') return v;
+      // avoid huge logs
+      return JSON.stringify(v, function (k, val) {
+        if (k === 'children' || k === 'parent') return '[omitted]';
+        if (typeof val === 'function') return '[fn]';
+        return val;
+      });
+    } catch (_unused) {
+      return '[unserializable]';
+    }
+  };
+  var log = function log() {
+    var _console;
+    if (!getEnabled()) return;
+    // eslint-disable-next-line no-console
+    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+      args[_key] = arguments[_key];
+    }
+    (_console = console).log.apply(_console, ["".concat(prefix, " ").concat(now(), "ms")].concat(_toConsumableArray(args.map(safe))));
+  };
+  var warn = function warn() {
+    var _console2;
+    if (!getEnabled()) return;
+    // eslint-disable-next-line no-console
+    for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
+      args[_key2] = arguments[_key2];
+    }
+    (_console2 = console).warn.apply(_console2, ["".concat(prefix, " ").concat(now(), "ms")].concat(_toConsumableArray(args.map(safe))));
+  };
+  var error = function error() {
+    var _console3;
+    if (!getEnabled()) return;
+    // eslint-disable-next-line no-console
+    for (var _len3 = arguments.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
+      args[_key3] = arguments[_key3];
+    }
+    (_console3 = console).error.apply(_console3, ["".concat(prefix, " ").concat(now(), "ms")].concat(_toConsumableArray(args.map(safe))));
+  };
+  return {
+    log: log,
+    warn: warn,
+    error: error
+  };
+}
 function nextFrame() {
   return new Promise(function (resolve) {
     return requestAnimationFrame(resolve);
@@ -40,6 +104,7 @@ Three.TextureLoader.prototype.load = function (url, onLoad, onProgress, onError)
  * Ref-counted global install so multiple instances don't clobber each other.
  */
 function installGltfTracker() {
+  var debug = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
   if (typeof window === 'undefined') {
     var _subscribe = function _subscribe() {
       return function () {};
@@ -70,6 +135,7 @@ function installGltfTracker() {
     };
   }
   var GLOBAL_KEY = '__kitchenSimulatorGltfTracker__';
+  var TRACKER_DEBUG_KEY = '__kitchenSimulatorDebug__';
   if (!window[GLOBAL_KEY]) {
     window[GLOBAL_KEY] = {
       refCount: 0,
@@ -82,13 +148,20 @@ function installGltfTracker() {
     };
   }
   var g = window[GLOBAL_KEY];
+  var isDebug = function isDebug() {
+    return !!debug || !!window[TRACKER_DEBUG_KEY];
+  };
+  var _makeLogger = makeLogger(isDebug, '[kitchen-simulator:gltf]'),
+    log = _makeLogger.log,
+    warn = _makeLogger.warn,
+    error = _makeLogger.error;
   var is3dAssetUrl = function is3dAssetUrl(url) {
     try {
       var _url$toString, _url$toString2;
       var s = typeof url === 'string' ? url : (_url$toString = url === null || url === void 0 || (_url$toString2 = url.toString) === null || _url$toString2 === void 0 ? void 0 : _url$toString2.call(url)) !== null && _url$toString !== void 0 ? _url$toString : '';
       var u = s.toLowerCase().split('?')[0]; // ignore cache params
       return u.endsWith('.gltf') || u.endsWith('.glb') || u.endsWith('.bin') || u.endsWith('.ktx2') || u.endsWith('.hdr') || u.endsWith('.exr') || u.endsWith('.png') || u.endsWith('.jpg') || u.endsWith('.jpeg') || u.endsWith('.webp');
-    } catch (_unused) {
+    } catch (_unused2) {
       return false;
     }
   };
@@ -116,6 +189,7 @@ function installGltfTracker() {
   var installIfNeeded = function installIfNeeded() {
     var _XHR$prototype, _XHR$prototype2;
     if (g.installed) return;
+    log('Installing GLTF tracker hooks');
 
     // ---- XHR hook ----
     var XHR = window.XMLHttpRequest;
@@ -125,8 +199,14 @@ function installGltfTracker() {
       XHR.prototype.open = function (method, url) {
         var _g$originalOpen;
         this.__is3dAssetRequest = is3dAssetUrl(url);
-        for (var _len = arguments.length, rest = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) {
-          rest[_key - 2] = arguments[_key];
+        if (this.__is3dAssetRequest) {
+          log('XHR open (3D asset)', {
+            method: method,
+            url: url
+          });
+        }
+        for (var _len4 = arguments.length, rest = new Array(_len4 > 2 ? _len4 - 2 : 0), _key4 = 2; _key4 < _len4; _key4++) {
+          rest[_key4 - 2] = arguments[_key4];
         }
         return (_g$originalOpen = g.originalOpen).call.apply(_g$originalOpen, [this, method, url].concat(rest));
       };
@@ -134,10 +214,12 @@ function installGltfTracker() {
         var _this = this;
         if (this.__is3dAssetRequest) {
           g.inFlight += 1;
+          log('XHR send -> inFlight++', g.inFlight);
           notify();
           var _done = function done() {
             g.inFlight -= 1;
             if (g.inFlight < 0) g.inFlight = 0;
+            log('XHR done -> inFlight--', g.inFlight);
             notify();
             _this.removeEventListener('loadend', _done);
             _this.removeEventListener('error', _done);
@@ -149,30 +231,38 @@ function installGltfTracker() {
           this.addEventListener('abort', _done);
           this.addEventListener('timeout', _done);
         }
-        for (var _len2 = arguments.length, args = new Array(_len2), _key2 = 0; _key2 < _len2; _key2++) {
-          args[_key2] = arguments[_key2];
+        for (var _len5 = arguments.length, args = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) {
+          args[_key5] = arguments[_key5];
         }
         return g.originalSend.apply(this, args);
       };
+    } else {
+      warn('XHR hooks not installed (missing open/send)');
     }
 
     // ---- fetch hook ----
     g.originalFetch = window.fetch;
     if (typeof g.originalFetch === 'function') {
       window.fetch = /*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee2() {
-        var _len3,
+        var _input;
+        var _len6,
           args,
-          _key3,
+          _key6,
           input,
           init,
           newUrl,
           track,
-          _args2 = arguments;
+          _input2,
+          res,
+          _input3,
+          _e$message,
+          _args2 = arguments,
+          _t;
         return _regeneratorRuntime.wrap(function (_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
-              for (_len3 = _args2.length, args = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) {
-                args[_key3] = _args2[_key3];
+              for (_len6 = _args2.length, args = new Array(_len6), _key6 = 0; _key6 < _len6; _key6++) {
+                args[_key6] = _args2[_key6];
               }
               input = args[0], init = args[1]; // DIY-714 [Temp Fix] Rewrite API URLs
               if (typeof input === 'string') {
@@ -189,24 +279,44 @@ function installGltfTracker() {
               return _context2.abrupt("return", g.originalFetch.call(this, input, init));
             case 1:
               g.inFlight += 1;
+              log('fetch (3D asset) -> inFlight++', g.inFlight, {
+                url: typeof input === 'string' ? input : (_input = input) === null || _input === void 0 ? void 0 : _input.url
+              });
               notify();
               _context2.prev = 2;
               _context2.next = 3;
               return g.originalFetch.call(this, input, init);
             case 3:
-              return _context2.abrupt("return", _context2.sent);
+              res = _context2.sent;
+              log('fetch response (3D asset)', {
+                url: typeof input === 'string' ? input : (_input2 = input) === null || _input2 === void 0 ? void 0 : _input2.url,
+                ok: res === null || res === void 0 ? void 0 : res.ok,
+                status: res === null || res === void 0 ? void 0 : res.status
+              });
+              return _context2.abrupt("return", res);
             case 4:
               _context2.prev = 4;
+              _t = _context2["catch"](2);
+              error('fetch error (3D asset)', {
+                url: typeof input === 'string' ? input : (_input3 = input) === null || _input3 === void 0 ? void 0 : _input3.url,
+                error: (_e$message = _t === null || _t === void 0 ? void 0 : _t.message) !== null && _e$message !== void 0 ? _e$message : _t
+              });
+              throw _t;
+            case 5:
+              _context2.prev = 5;
               g.inFlight -= 1;
               if (g.inFlight < 0) g.inFlight = 0;
+              log('fetch finally -> inFlight--', g.inFlight);
               notify();
-              return _context2.finish(4);
-            case 5:
+              return _context2.finish(5);
+            case 6:
             case "end":
               return _context2.stop();
           }
-        }, _callee2, this, [[2,, 4, 5]]);
+        }, _callee2, this, [[2, 4, 5, 6]]);
       }));
+    } else {
+      warn('fetch hook not installed (window.fetch not a function)');
     }
     g.installed = true;
   };
@@ -251,6 +361,12 @@ function installGltfTracker() {
         while (1) switch (_context4.prev = _context4.next) {
           case 0:
             _ref3 = _args4.length > 0 && _args4[0] !== undefined ? _args4[0] : {}, _ref3$timeoutMs = _ref3.timeoutMs, timeoutMs = _ref3$timeoutMs === void 0 ? 30000 : _ref3$timeoutMs;
+            log('waitForIdle start', {
+              timeoutMs: timeoutMs,
+              inFlight: g.inFlight
+            });
+
+            // Fast path
             _context4.next = 1;
             return waitStableIdle2Frames();
           case 1:
@@ -258,6 +374,7 @@ function installGltfTracker() {
               _context4.next = 2;
               break;
             }
+            log('waitForIdle fast-path resolved');
             return _context4.abrupt("return", true);
           case 2:
             return _context4.abrupt("return", new Promise(function (resolve, reject) {
@@ -268,13 +385,16 @@ function installGltfTracker() {
                 finished = true;
                 if (unsub) unsub();
                 clearTimeout(timer);
+                log('waitForIdle resolved');
                 resolve(true);
               };
               var finishErr = function finishErr(err) {
+                var _err$message;
                 if (finished) return;
                 finished = true;
                 if (unsub) unsub();
                 clearTimeout(timer);
+                error('waitForIdle timeout/reject', (_err$message = err === null || err === void 0 ? void 0 : err.message) !== null && _err$message !== void 0 ? _err$message : err);
                 reject(err);
               };
 
@@ -294,6 +414,9 @@ function installGltfTracker() {
                         }
                         return _context3.abrupt("return");
                       case 1:
+                        log('waitForIdle inFlight change', count);
+
+                        // Only care when it hits zero; otherwise we just wait
                         if (!(count !== 0)) {
                           _context3.next = 2;
                           break;
@@ -304,6 +427,7 @@ function installGltfTracker() {
                         return waitStableIdle2Frames();
                       case 3:
                         stable = _context3.sent;
+                        log('waitForIdle stable check', stable);
                         if (stable) finishOk();
                         // else keep waiting
                       case 4:
@@ -331,7 +455,9 @@ function installGltfTracker() {
   var uninstall = function uninstall() {
     var _XHR$prototype3, _XHR$prototype4;
     g.refCount -= 1;
+    log('uninstall tracker refCount--', g.refCount);
     if (g.refCount > 0) return;
+    log('uninstall tracker (final) restoring hooks');
     var XHR = window.XMLHttpRequest;
     if (XHR !== null && XHR !== void 0 && (_XHR$prototype3 = XHR.prototype) !== null && _XHR$prototype3 !== void 0 && _XHR$prototype3.open && g.originalOpen) XHR.prototype.open = g.originalOpen;
     if (XHR !== null && XHR !== void 0 && (_XHR$prototype4 = XHR.prototype) !== null && _XHR$prototype4 !== void 0 && _XHR$prototype4.send && g.originalSend) XHR.prototype.send = g.originalSend;
@@ -344,6 +470,7 @@ function installGltfTracker() {
     g.originalSend = null;
   };
   g.refCount += 1;
+  log('install tracker refCount++', g.refCount);
   installIfNeeded();
   return {
     getInFlight: function getInFlight() {
@@ -358,10 +485,19 @@ export function renderKitchenSimulator(container) {
   var _props$framesPerEvent, _props$waitForGltfIdl, _props$gltfTimeoutMs;
   var props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
   if (!container) throw new Error('renderKitchenSimulator: container is required');
+  var DEBUG_KEY = '__kitchenSimulatorDebug__';
+  var debugEnabled = !!props.debug || typeof window !== 'undefined' && !!window[DEBUG_KEY];
+  var _makeLogger2 = makeLogger(function () {
+      return debugEnabled;
+    }),
+    log = _makeLogger2.log,
+    warn = _makeLogger2.warn,
+    error = _makeLogger2.error;
 
   // ✅ Reuse existing API
   if (container[API_KEY]) {
     var _container$API_KEY$__, _container$API_KEY;
+    log('Reusing existing API; calling __render with new props');
     (_container$API_KEY$__ = (_container$API_KEY = container[API_KEY]).__render) === null || _container$API_KEY$__ === void 0 || _container$API_KEY$__.call(_container$API_KEY, props);
     return container[API_KEY];
   }
@@ -371,38 +507,83 @@ export function renderKitchenSimulator(container) {
   if (!root) {
     root = createRoot(container);
     container[ROOT_KEY] = root;
+    log('Created new React root');
+  } else {
+    log('Reusing existing React root');
   }
   var setExternalEventFn = null;
   var destroyed = false;
   var queue = [];
   var pendingMarkers = new Set();
   var MARKER = Symbol('marker');
-  var gltfTracker = installGltfTracker();
+  var gltfTracker = installGltfTracker(debugEnabled);
 
   // FAST defaults (safe)
   var defaultFramesPerEvent = (_props$framesPerEvent = props.framesPerEvent) !== null && _props$framesPerEvent !== void 0 ? _props$framesPerEvent : 1;
   var waitForAssets = (_props$waitForGltfIdl = props.waitForGltfIdleAfterEachEvent) !== null && _props$waitForGltfIdl !== void 0 ? _props$waitForGltfIdl : true;
   var defaultTimeout = (_props$gltfTimeoutMs = props.gltfTimeoutMs) !== null && _props$gltfTimeoutMs !== void 0 ? _props$gltfTimeoutMs : 30000;
-
-  // If you want ultra-fast UI responsiveness, you can disable waiting per-event
-  // and only wait on “important” events, see comment in settle() below.
-
   var draining = false;
+
+  // ---- Loop detection / profiling helpers ----
+  var drainRunId = 0;
+  var eventSeq = 0;
+  var lastEvents = [];
+  var LAST_N = 40;
+  function summarizeEvent(ev) {
+    var _ref5, _ref6, _ev$type, _ev$payload, _ref7, _ev$id, _ev$payload2;
+    if (!ev) return ev;
+    var t = (_ref5 = (_ref6 = (_ev$type = ev === null || ev === void 0 ? void 0 : ev.type) !== null && _ev$type !== void 0 ? _ev$type : ev === null || ev === void 0 || (_ev$payload = ev.payload) === null || _ev$payload === void 0 ? void 0 : _ev$payload.mode) !== null && _ref6 !== void 0 ? _ref6 : ev === null || ev === void 0 ? void 0 : ev.name) !== null && _ref5 !== void 0 ? _ref5 : 'unknown';
+    var id = (_ref7 = (_ev$id = ev === null || ev === void 0 ? void 0 : ev.id) !== null && _ev$id !== void 0 ? _ev$id : ev === null || ev === void 0 || (_ev$payload2 = ev.payload) === null || _ev$payload2 === void 0 ? void 0 : _ev$payload2.id) !== null && _ref7 !== void 0 ? _ref7 : null;
+    return {
+      type: t,
+      id: id,
+      framesPerEvent: ev === null || ev === void 0 ? void 0 : ev.framesPerEvent,
+      waitForGltfIdleAfterEachEvent: ev === null || ev === void 0 ? void 0 : ev.waitForGltfIdleAfterEachEvent,
+      gltfTimeoutMs: ev === null || ev === void 0 ? void 0 : ev.gltfTimeoutMs
+    };
+  }
+  function recordEvent(ev) {
+    var s = summarizeEvent(ev);
+    lastEvents.push(s);
+    if (lastEvents.length > LAST_N) lastEvents.shift();
+  }
+  function dumpLoopHint() {
+    var context = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
+    warn('Possible infinite loop / stall detected', {
+      context: context,
+      destroyed: destroyed,
+      draining: draining,
+      queueLength: queue.length,
+      pendingMarkers: pendingMarkers.size,
+      gltfInFlight: gltfTracker.getInFlight(),
+      lastEvents: lastEvents
+    });
+  }
   function isSyncScene(ev) {
-    var _ev$payload;
-    return (ev === null || ev === void 0 ? void 0 : ev.type) === 'EXTERNAL_EVENT_SYNC_SCENE' || (ev === null || ev === void 0 || (_ev$payload = ev.payload) === null || _ev$payload === void 0 ? void 0 : _ev$payload.mode) === 'sync-scene' || (ev === null || ev === void 0 ? void 0 : ev.__sync) === true;
+    var _ev$payload3;
+    return (ev === null || ev === void 0 ? void 0 : ev.type) === 'EXTERNAL_EVENT_SYNC_SCENE' || (ev === null || ev === void 0 || (_ev$payload3 = ev.payload) === null || _ev$payload3 === void 0 ? void 0 : _ev$payload3.mode) === 'sync-scene' || (ev === null || ev === void 0 ? void 0 : ev.__sync) === true;
   }
-  function settle(_x2) {
+  function settle(_x2, _x3) {
     return _settle.apply(this, arguments);
   }
   function _settle() {
-    _settle = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee7(ev) {
-      var _ev$framesPerEvent, _ev$waitForGltfIdleAf;
-      var frames, i, shouldWait, _ev$gltfTimeoutMs, timeoutMs;
+    _settle = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee7(ev, meta) {
+      var _ev$framesPerEvent, _ev$waitForGltfIdleAf, _ev$gltfTimeoutMs;
+      var frames, shouldWait, timeoutMs, i, start, _e$message2, _t2;
       return _regeneratorRuntime.wrap(function (_context7) {
         while (1) switch (_context7.prev = _context7.next) {
           case 0:
-            frames = (_ev$framesPerEvent = ev === null || ev === void 0 ? void 0 : ev.framesPerEvent) !== null && _ev$framesPerEvent !== void 0 ? _ev$framesPerEvent : defaultFramesPerEvent; // (1) allow react/reducers to run (fixes “must zoom to see updates”)
+            frames = (_ev$framesPerEvent = ev === null || ev === void 0 ? void 0 : ev.framesPerEvent) !== null && _ev$framesPerEvent !== void 0 ? _ev$framesPerEvent : defaultFramesPerEvent;
+            shouldWait = (_ev$waitForGltfIdleAf = ev === null || ev === void 0 ? void 0 : ev.waitForGltfIdleAfterEachEvent) !== null && _ev$waitForGltfIdleAf !== void 0 ? _ev$waitForGltfIdleAf : waitForAssets;
+            timeoutMs = (_ev$gltfTimeoutMs = ev === null || ev === void 0 ? void 0 : ev.gltfTimeoutMs) !== null && _ev$gltfTimeoutMs !== void 0 ? _ev$gltfTimeoutMs : defaultTimeout;
+            log('settle:start', _objectSpread(_objectSpread({}, meta), {}, {
+              frames: frames,
+              shouldWait: shouldWait,
+              timeoutMs: timeoutMs,
+              gltfInFlight: gltfTracker.getInFlight()
+            }));
+
+            // (1) allow react/reducers to run (fixes “must zoom to see updates”)
             i = 0;
           case 1:
             if (!(i < frames)) {
@@ -416,34 +597,52 @@ export function renderKitchenSimulator(container) {
             _context7.next = 1;
             break;
           case 3:
-            // (2) optionally wait for assets
-            // fastest safe approach: keep ON for events that add/replace/load models
-            // You can override per-event via ev.waitForGltfIdleAfterEachEvent = false
-            shouldWait = (_ev$waitForGltfIdleAf = ev === null || ev === void 0 ? void 0 : ev.waitForGltfIdleAfterEachEvent) !== null && _ev$waitForGltfIdleAf !== void 0 ? _ev$waitForGltfIdleAf : waitForAssets;
             if (!shouldWait) {
-              _context7.next = 4;
+              _context7.next = 8;
               break;
             }
-            timeoutMs = (_ev$gltfTimeoutMs = ev === null || ev === void 0 ? void 0 : ev.gltfTimeoutMs) !== null && _ev$gltfTimeoutMs !== void 0 ? _ev$gltfTimeoutMs : defaultTimeout;
-            _context7.next = 4;
+            start = Date.now();
+            _context7.prev = 4;
+            _context7.next = 5;
             return gltfTracker.waitForIdle({
               timeoutMs: timeoutMs
             });
-          case 4:
-            _context7.next = 5;
-            return nextFrame();
           case 5:
+            _context7.next = 7;
+            break;
+          case 6:
+            _context7.prev = 6;
+            _t2 = _context7["catch"](4);
+            error('settle:waitForIdle failed', _objectSpread(_objectSpread({}, meta), {}, {
+              err: (_e$message2 = _t2 === null || _t2 === void 0 ? void 0 : _t2.message) !== null && _e$message2 !== void 0 ? _e$message2 : _t2,
+              waitedMs: Date.now() - start,
+              gltfInFlight: gltfTracker.getInFlight()
+            }));
+            // Don’t throw unless you want the whole queue to stop.
+            // Keeping behavior: let it bubble so caller catches and continues.
+            throw _t2;
+          case 7:
+            log('settle:waitForIdle done', _objectSpread(_objectSpread({}, meta), {}, {
+              waitedMs: Date.now() - start,
+              gltfInFlight: gltfTracker.getInFlight()
+            }));
+          case 8:
+            _context7.next = 9;
+            return nextFrame();
+          case 9:
             if (!isSyncScene(ev)) {
-              _context7.next = 6;
+              _context7.next = 10;
               break;
             }
-            _context7.next = 6;
+            _context7.next = 10;
             return nextFrame();
-          case 6:
+          case 10:
+            log('settle:done', _objectSpread({}, meta));
+          case 11:
           case "end":
             return _context7.stop();
         }
-      }, _callee7);
+      }, _callee7, null, [[4, 6]]);
     }));
     return _settle.apply(this, arguments);
   }
@@ -452,7 +651,7 @@ export function renderKitchenSimulator(container) {
   }
   function _drain() {
     _drain = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee8() {
-      var item, _t;
+      var myRunId, start, watchdogEveryMs, watchdog, MAX_ITERATIONS, iterations, item, seq, meta, _err$message2, _t3;
       return _regeneratorRuntime.wrap(function (_context8) {
         while (1) switch (_context8.prev = _context8.next) {
           case 0:
@@ -460,57 +659,131 @@ export function renderKitchenSimulator(container) {
               _context8.next = 1;
               break;
             }
+            log('drain:skip', {
+              draining: draining,
+              destroyed: destroyed,
+              queueLength: queue.length
+            });
             return _context8.abrupt("return");
           case 1:
             draining = true;
+            myRunId = drainRunId += 1;
+            start = Date.now();
+            log('drain:start', {
+              runId: myRunId,
+              queueLength: queue.length,
+              pendingMarkers: pendingMarkers.size,
+              gltfInFlight: gltfTracker.getInFlight()
+            });
+
+            // Watchdog: if drain runs too long, dump state (helps spot infinite loops)
+            watchdogEveryMs = 4000;
+            watchdog = setInterval(function () {
+              dumpLoopHint("drain watchdog runId=".concat(myRunId));
+            }, watchdogEveryMs); // Hard cap of iterations in one drain call (fail-open) to prevent true infinite loops
+            MAX_ITERATIONS = 5000;
+            iterations = 0;
             _context8.prev = 2;
           case 3:
             if (!(!destroyed && queue.length)) {
-              _context8.next = 10;
+              _context8.next = 12;
+              break;
+            }
+            iterations += 1;
+            if (!(iterations >= MAX_ITERATIONS)) {
+              _context8.next = 4;
               break;
             }
+            dumpLoopHint("MAX_ITERATIONS reached runId=".concat(myRunId));
+            // fail-open: stop draining; future drain() calls can continue
+            return _context8.abrupt("continue", 12);
+          case 4:
             if (setExternalEventFn) {
-              _context8.next = 5;
+              _context8.next = 6;
               break;
             }
-            _context8.next = 4;
+            log('drain:waiting for setExternalEventFn');
+            _context8.next = 5;
             return nextFrame();
-          case 4:
-            return _context8.abrupt("continue", 3);
           case 5:
+            return _context8.abrupt("continue", 3);
+          case 6:
             item = queue.shift();
             if (!(item && item.__marker === MARKER)) {
-              _context8.next = 6;
+              _context8.next = 7;
               break;
             }
             pendingMarkers["delete"](item.token);
+            log('drain:marker consumed', {
+              runId: myRunId,
+              pendingMarkers: pendingMarkers.size,
+              queueLength: queue.length
+            });
             return _context8.abrupt("continue", 3);
-          case 6:
-            _context8.prev = 6;
-            setExternalEventFn(item);
-            _context8.next = 7;
-            return settle(item);
           case 7:
-            _context8.next = 9;
-            break;
-          case 8:
+            seq = eventSeq += 1;
+            recordEvent(item);
+            meta = {
+              runId: myRunId,
+              seq: seq,
+              queueLengthAfterShift: queue.length,
+              pendingMarkers: pendingMarkers.size,
+              gltfInFlightBefore: gltfTracker.getInFlight(),
+              event: summarizeEvent(item)
+            };
+            log('drain:event begin', meta);
             _context8.prev = 8;
-            _t = _context8["catch"](6);
-            console.error('[kitchen-simulator] event failed:', item, _t);
-            // IMPORTANT: continue so we can eventually consume the marker
-            // Optionally you can decide to clear remaining queue here.
+            setExternalEventFn(item);
+            log('drain:setExternalEventFn called', meta);
+            _context8.next = 9;
+            return settle(item, meta);
           case 9:
-            _context8.next = 3;
+            log('drain:event done', _objectSpread(_objectSpread({}, meta), {}, {
+              gltfInFlightAfter: gltfTracker.getInFlight()
+            }));
+            _context8.next = 11;
             break;
           case 10:
             _context8.prev = 10;
-            draining = false;
-            return _context8.finish(10);
+            _t3 = _context8["catch"](8);
+            error('drain:event failed', _objectSpread(_objectSpread({}, meta), {}, {
+              err: (_err$message2 = _t3 === null || _t3 === void 0 ? void 0 : _t3.message) !== null && _err$message2 !== void 0 ? _err$message2 : _t3,
+              gltfInFlight: gltfTracker.getInFlight()
+            }));
+            // IMPORTANT: continue so we can eventually consume the marker
           case 11:
+            // If queue never drains (e.g. events enqueue more events endlessly),
+            // these logs help identify repeating patterns:
+            if (debugEnabled && seq % 50 === 0) {
+              warn('drain:progress snapshot', {
+                runId: myRunId,
+                processedEvents: seq,
+                queueLength: queue.length,
+                pendingMarkers: pendingMarkers.size,
+                gltfInFlight: gltfTracker.getInFlight(),
+                lastEvents: lastEvents
+              });
+            }
+            _context8.next = 3;
+            break;
+          case 12:
+            _context8.prev = 12;
+            clearInterval(watchdog);
+            draining = false;
+            log('drain:done', {
+              runId: myRunId,
+              ms: Date.now() - start,
+              destroyed: destroyed,
+              queueLength: queue.length,
+              pendingMarkers: pendingMarkers.size,
+              gltfInFlight: gltfTracker.getInFlight()
+            });
+            return _context8.finish(12);
+          case 13:
           case "end":
             return _context8.stop();
         }
-      }, _callee8, null, [[2,, 10, 11], [6, 8]]);
+      }, _callee8, null, [[2,, 12, 13], [8, 10]]);
     }));
     return _drain.apply(this, arguments);
   }
@@ -531,8 +804,14 @@ export function renderKitchenSimulator(container) {
       value: function componentDidMount() {
         var _this3 = this;
         this._mounted = true;
+        log('Wrapper mounted');
         setExternalEventFn = function setExternalEventFn(newEvent) {
-          if (!_this3._mounted) return;
+          if (!_this3._mounted) {
+            warn('setExternalEventFn called while unmounted (ignored)');
+            return;
+          }
+          // This is the most important log to see if you’re triggering re-renders endlessly:
+          log('Wrapper setState(externalEvent)', summarizeEvent(newEvent));
           _this3.setState({
             externalEvent: newEvent
           });
@@ -541,12 +820,18 @@ export function renderKitchenSimulator(container) {
     }, {
       key: "componentWillUnmount",
       value: function componentWillUnmount() {
+        log('Wrapper will unmount');
         this._mounted = false;
         setExternalEventFn = null;
       }
     }, {
       key: "render",
       value: function render() {
+        // Render spam can indicate infinite render loop; keep it lightweight
+        if (debugEnabled) log('Wrapper render', {
+          hasExternalEvent: !!this.state.externalEvent,
+          externalEvent: summarizeEvent(this.state.externalEvent)
+        });
         return /*#__PURE__*/React.createElement(LiteRenderer, _extends({}, this.props, {
           externalEvent: this.state.externalEvent
         }));
@@ -555,21 +840,40 @@ export function renderKitchenSimulator(container) {
   }(React.Component);
   var api = {
     __render: function __render(nextProps) {
+      log('__render called', {
+        debug: !!(nextProps !== null && nextProps !== void 0 && nextProps.debug),
+        framesPerEvent: nextProps === null || nextProps === void 0 ? void 0 : nextProps.framesPerEvent,
+        waitForGltfIdleAfterEachEvent: nextProps === null || nextProps === void 0 ? void 0 : nextProps.waitForGltfIdleAfterEachEvent,
+        gltfTimeoutMs: nextProps === null || nextProps === void 0 ? void 0 : nextProps.gltfTimeoutMs
+      });
       root.render(/*#__PURE__*/React.createElement(Wrapper, nextProps));
     },
     // ✅ host can query current inFlight
     getGltfInFlight: function getGltfInFlight() {
-      return gltfTracker.getInFlight();
+      var v = gltfTracker.getInFlight();
+      log('getGltfInFlight', v);
+      return v;
     },
     // ✅ host can subscribe to inFlight changes (loader)
     subscribeGltfInFlight: function subscribeGltfInFlight(cb) {
-      return gltfTracker.subscribe(cb);
+      log('subscribeGltfInFlight');
+      return gltfTracker.subscribe(function (count) {
+        if (debugEnabled) log('gltf inFlight changed', count);
+        cb(count);
+      });
     },
     sendExternalEvents: function sendExternalEvents(eventOrEvents) {
-      var _ref5 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
-        _ref5$timeoutMs = _ref5.timeoutMs,
-        timeoutMs = _ref5$timeoutMs === void 0 ? 60000 : _ref5$timeoutMs;
+      var _ref8 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+        _ref8$timeoutMs = _ref8.timeoutMs,
+        timeoutMs = _ref8$timeoutMs === void 0 ? 60000 : _ref8$timeoutMs;
       var events = Array.isArray(eventOrEvents) ? eventOrEvents : [eventOrEvents];
+      var batchId = Math.random().toString(16).slice(2);
+      log('sendExternalEvents:enqueue', {
+        batchId: batchId,
+        count: events.length,
+        timeoutMs: timeoutMs,
+        events: events.map(summarizeEvent)
+      });
       var _iterator2 = _createForOfIteratorHelper(events),
         _step2;
       try {
@@ -588,73 +892,112 @@ export function renderKitchenSimulator(container) {
         __marker: MARKER,
         token: token
       });
+      log('sendExternalEvents:marker added', {
+        batchId: batchId,
+        queueLength: queue.length,
+        pendingMarkers: pendingMarkers.size
+      });
       drain();
 
       // resolve when marker cleared
       return new Promise(function (resolve) {
         var start = Date.now();
         var check = /*#__PURE__*/function () {
-          var _ref6 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee6() {
+          var _ref9 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee6() {
+            var spins;
             return _regeneratorRuntime.wrap(function (_context6) {
               while (1) switch (_context6.prev = _context6.next) {
                 case 0:
+                  spins = 0;
+                case 1:
                   if (destroyed) {
-                    _context6.next = 4;
+                    _context6.next = 5;
                     break;
                   }
+                  spins += 1;
                   if (pendingMarkers.has(token)) {
-                    _context6.next = 1;
+                    _context6.next = 2;
                     break;
                   }
+                  log('sendExternalEvents:resolved', {
+                    batchId: batchId,
+                    ms: Date.now() - start,
+                    spins: spins,
+                    queueLength: queue.length
+                  });
                   resolve(true);
                   return _context6.abrupt("return");
-                case 1:
+                case 2:
                   if (!(Date.now() - start > timeoutMs)) {
-                    _context6.next = 2;
+                    _context6.next = 3;
                     break;
                   }
-                  console.error('[kitchen-simulator] sendExternalEvents timed out');
+                  error('sendExternalEvents timed out', {
+                    batchId: batchId,
+                    timeoutMs: timeoutMs,
+                    ms: Date.now() - start,
+                    spins: spins,
+                    queueLength: queue.length,
+                    pendingMarkers: pendingMarkers.size,
+                    gltfInFlight: gltfTracker.getInFlight(),
+                    lastEvents: lastEvents
+                  });
                   pendingMarkers["delete"](token); // fail-open
                   resolve(false);
                   return _context6.abrupt("return");
-                case 2:
-                  _context6.next = 3;
-                  return nextFrame();
                 case 3:
-                  _context6.next = 0;
-                  break;
+                  // Periodic “I might be stuck” hint
+                  if (debugEnabled && spins % 240 === 0) {
+                    dumpLoopHint("sendExternalEvents waiting batchId=".concat(batchId));
+                  }
+                  _context6.next = 4;
+                  return nextFrame();
                 case 4:
-                  resolve(false);
+                  _context6.next = 1;
+                  break;
                 case 5:
+                  warn('sendExternalEvents:destroyed while waiting', {
+                    batchId: batchId
+                  });
+                  resolve(false);
+                case 6:
                 case "end":
                   return _context6.stop();
               }
             }, _callee6);
           }));
           return function check() {
-            return _ref6.apply(this, arguments);
+            return _ref9.apply(this, arguments);
           };
         }();
         check();
       });
     },
     updateExternalEvent: function updateExternalEvent(e) {
+      log('updateExternalEvent', summarizeEvent(e));
       return api.sendExternalEvents(e);
     },
     clearQueue: function clearQueue() {
+      log('clearQueue', {
+        queueLength: queue.length,
+        pendingMarkers: pendingMarkers.size
+      });
       queue.length = 0;
       pendingMarkers.clear();
     },
     unmount: function unmount() {
+      log('unmount called');
       destroyed = true;
       api.clearQueue();
       gltfTracker.uninstall();
       var doUnmount = function doUnmount() {
         try {
+          log('root.unmount()');
           root.unmount();
         } finally {
           container[ROOT_KEY] = null;
           container[API_KEY] = null;
+          log('unmounted + cleared container keys');
         }
       };
       if (typeof queueMicrotask === 'function') queueMicrotask(doUnmount);else setTimeout(doUnmount, 0);
@@ -662,6 +1005,11 @@ export function renderKitchenSimulator(container) {
   };
   api.__render(props);
   container[API_KEY] = api;
+
+  // Helpful: show how to enable debug quickly at runtime
+  if (debugEnabled) {
+    log('Debug enabled. Tip: window.__kitchenSimulatorDebug__ = true (global)');
+  }
   return api;
 }
 export default renderKitchenSimulator;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitchen-simulator",
-  "version": "5.10.7-react.18",
+  "version": "5.10.9-react.18",
   "description": "It is a kitchen simulator (self-contained micro-frontend).",
   "license": "MIT",
   "module": "es/index.js",