kitchen-simulator 3.4.0 → 3.5.0

package/es/index.js

@@ -166,6 +166,7 @@ function installGltfTracker() {
   }
   var subscribe = function subscribe(fn) {
     listeners.add(fn);
+    // IMPORTANT: emits synchronously
     fn(inFlight);
     return function () {
       return listeners["delete"](fn);
@@ -173,8 +174,8 @@ function installGltfTracker() {
   };
 
   /**
-   * Wait until GLTF network is idle (inFlight===0).
-   * Includes a grace window to catch loads that start slightly after the event.
+   * Wait until inFlight becomes 0 (with grace window).
+   * Safe even when already idle.
    */
   var waitForIdle = /*#__PURE__*/function () {
     var _ref2 = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee3() {
@@ -201,7 +202,7 @@ function installGltfTracker() {
               var unsub = null;
               var onChange = function onChange(count) {
                 if (count === 0) {
-                  if (unsub) unsub(); // ✅ safe
+                  if (unsub) unsub();
                   resolve(true);
                   return;
                 }
@@ -239,104 +240,168 @@ function installGltfTracker() {
   };
 }
 export function renderKitchenSimulator(container) {
-  var _props$framesPerEvent, _props$waitForGltfIdl, _props$gltfTimeoutMs, _props$gltfGraceMs;
+  var _props$framesPerEvent, _props$waitForGltfIdl, _props$gltfTimeoutMs, _props$gltfGraceMs, _props$syncGltfGraceM, _props$syncExtraFrame;
   var props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  if (!container) throw new Error('renderKitchenSimulator: container is required');
+
+  // ✅ Reuse existing API for same container
+  if (container[API_KEY]) {
+    var _container$API_KEY$__, _container$API_KEY;
+    // update render with latest props (safe)
+    (_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];
+  }
+
+  // ✅ Reuse root for same container
   var root = container[ROOT_KEY];
   if (!root) {
     root = createRoot(container);
     container[ROOT_KEY] = root;
   }
   var setExternalEventFn = null;
-  var queue = [];
-  var pendingMarkers = new Set();
-  var draining = false;
   var destroyed = false;
-  var FRAMES_PER_EVENT = (_props$framesPerEvent = props.framesPerEvent) !== null && _props$framesPerEvent !== void 0 ? _props$framesPerEvent : 2;
 
-  // ✅ assume all events may load gltfs
-  var WAIT_FOR_GLTF_IDLE_AFTER_EACH_EVENT = (_props$waitForGltfIdl = props.waitForGltfIdleAfterEachEvent) !== null && _props$waitForGltfIdl !== void 0 ? _props$waitForGltfIdl : true;
-  var GLTF_TIMEOUT_MS = (_props$gltfTimeoutMs = props.gltfTimeoutMs) !== null && _props$gltfTimeoutMs !== void 0 ? _props$gltfTimeoutMs : 30000;
-  var GLTF_GRACE_MS = (_props$gltfGraceMs = props.gltfGraceMs) !== null && _props$gltfGraceMs !== void 0 ? _props$gltfGraceMs : 50;
+  // queue + marker handling
+  var queue = [];
+  var pendingMarkers = new Set();
+  var MARKER = Symbol('marker');
   var gltfTracker = installGltfTracker();
-  function drain() {
-    return _drain.apply(this, arguments);
+
+  // defaults
+  var defaultFramesPerEvent = (_props$framesPerEvent = props.framesPerEvent) !== null && _props$framesPerEvent !== void 0 ? _props$framesPerEvent : 2;
+  var waitForGltf = (_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;
+  var defaultGrace = (_props$gltfGraceMs = props.gltfGraceMs) !== null && _props$gltfGraceMs !== void 0 ? _props$gltfGraceMs : 50;
+  var syncGrace = (_props$syncGltfGraceM = props.syncGltfGraceMs) !== null && _props$syncGltfGraceM !== void 0 ? _props$syncGltfGraceM : 250; // SyncScene uses larger grace
+  var syncExtraFrames = (_props$syncExtraFrame = props.syncExtraFrames) !== null && _props$syncExtraFrame !== void 0 ? _props$syncExtraFrame : 2;
+  var draining = false;
+  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' ||
+    // if you pass mode sometimes
+    (ev === null || ev === void 0 ? void 0 : ev.__sync) === true;
   }
-  function _drain() {
-    _drain = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee5() {
-      var _setExternalEventFn, ev, i, _ev$gltfTimeoutMs, _ev$gltfGraceMs;
+  function settle(_x) {
+    return _settle.apply(this, arguments);
+  }
+  function _settle() {
+    _settle = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee5(ev) {
+      var _ev$framesPerEvent, _ev$gltfGraceMs, _ev$gltfTimeoutMs;
+      var frames, i, graceMs, timeoutMs, _i;
       return _regeneratorRuntime.wrap(function (_context5) {
         while (1) switch (_context5.prev = _context5.next) {
           case 0:
-            if (!(draining || destroyed)) {
-              _context5.next = 1;
-              break;
-            }
-            return _context5.abrupt("return");
+            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
+            i = 0;
           case 1:
-            draining = true;
-            _context5.prev = 2;
-          case 3:
-            if (!(queue.length && !destroyed)) {
-              _context5.next = 12;
+            if (!(i < frames)) {
+              _context5.next = 3;
               break;
             }
-            ev = queue.shift(); // skip internal markers
-            if (!(ev && ev.__batchMarker)) {
+            _context5.next = 2;
+            return nextFrame();
+          case 2:
+            i += 1;
+            _context5.next = 1;
+            break;
+          case 3:
+            if (waitForGltf) {
               _context5.next = 4;
               break;
             }
-            pendingMarkers["delete"](ev.__batchMarker);
-            return _context5.abrupt("continue", 3);
+            return _context5.abrupt("return");
           case 4:
-            if (setExternalEventFn) {
-              _context5.next = 6;
-              break;
-            }
+            // 2) wait for gltf idle
+            graceMs = isSyncScene(ev) ? syncGrace : (_ev$gltfGraceMs = ev === null || ev === void 0 ? void 0 : ev.gltfGraceMs) !== null && _ev$gltfGraceMs !== void 0 ? _ev$gltfGraceMs : defaultGrace;
+            timeoutMs = (_ev$gltfTimeoutMs = ev === null || ev === void 0 ? void 0 : ev.gltfTimeoutMs) !== null && _ev$gltfTimeoutMs !== void 0 ? _ev$gltfTimeoutMs : defaultTimeout;
             _context5.next = 5;
-            return nextFrame();
+            return gltfTracker.waitForIdle({
+              graceMs: graceMs,
+              timeoutMs: timeoutMs
+            });
           case 5:
-            return _context5.abrupt("continue", 3);
+            _context5.next = 6;
+            return nextFrame();
           case 6:
-            (_setExternalEventFn = setExternalEventFn) === null || _setExternalEventFn === void 0 || _setExternalEventFn(ev);
-
-            // baseline spacing for react + legacy lifecycle
-            i = 0;
+            if (!isSyncScene(ev)) {
+              _context5.next = 9;
+              break;
+            }
+            _i = 0;
           case 7:
-            if (!(i < FRAMES_PER_EVENT)) {
+            if (!(_i < syncExtraFrames)) {
               _context5.next = 9;
               break;
             }
             _context5.next = 8;
             return nextFrame();
           case 8:
-            i += 1;
+            _i += 1;
             _context5.next = 7;
             break;
           case 9:
-            if (!WAIT_FOR_GLTF_IDLE_AFTER_EACH_EVENT) {
-              _context5.next = 11;
+          case "end":
+            return _context5.stop();
+        }
+      }, _callee5);
+    }));
+    return _settle.apply(this, arguments);
+  }
+  function drain() {
+    return _drain.apply(this, arguments);
+  }
+  function _drain() {
+    _drain = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee6() {
+      var item;
+      return _regeneratorRuntime.wrap(function (_context6) {
+        while (1) switch (_context6.prev = _context6.next) {
+          case 0:
+            if (!(draining || destroyed)) {
+              _context6.next = 1;
               break;
             }
-            _context5.next = 10;
-            return gltfTracker.waitForIdle({
-              timeoutMs: (_ev$gltfTimeoutMs = ev === null || ev === void 0 ? void 0 : ev.gltfTimeoutMs) !== null && _ev$gltfTimeoutMs !== void 0 ? _ev$gltfTimeoutMs : GLTF_TIMEOUT_MS,
-              graceMs: (_ev$gltfGraceMs = ev === null || ev === void 0 ? void 0 : ev.gltfGraceMs) !== null && _ev$gltfGraceMs !== void 0 ? _ev$gltfGraceMs : GLTF_GRACE_MS
-            });
-          case 10:
-            _context5.next = 11;
+            return _context6.abrupt("return");
+          case 1:
+            draining = true;
+            _context6.prev = 2;
+          case 3:
+            if (!(queue.length && !destroyed)) {
+              _context6.next = 8;
+              break;
+            }
+            item = queue.shift(); // marker?
+            if (!(item && item.__marker === MARKER)) {
+              _context6.next = 4;
+              break;
+            }
+            pendingMarkers["delete"](item.token);
+            return _context6.abrupt("continue", 3);
+          case 4:
+            if (setExternalEventFn) {
+              _context6.next = 6;
+              break;
+            }
+            _context6.next = 5;
             return nextFrame();
-          case 11:
-            _context5.next = 3;
+          case 5:
+            queue.unshift(item); // put back and retry
+            return _context6.abrupt("continue", 3);
+          case 6:
+            setExternalEventFn(item);
+            _context6.next = 7;
+            return settle(item);
+          case 7:
+            _context6.next = 3;
             break;
-          case 12:
-            _context5.prev = 12;
+          case 8:
+            _context6.prev = 8;
             draining = false;
-            return _context5.finish(12);
-          case 13:
+            return _context6.finish(8);
+          case 9:
           case "end":
-            return _context5.stop();
+            return _context6.stop();
         }
-      }, _callee5, null, [[2,, 12, 13]]);
+      }, _callee6, null, [[2,, 8, 9]]);
     }));
     return _drain.apply(this, arguments);
   }
@@ -358,7 +423,6 @@ export function renderKitchenSimulator(container) {
         var _this3 = this;
         this._mounted = true;
         setExternalEventFn = function setExternalEventFn(newEvent) {
-          // ✅ ensure we never setState during render
           if (!_this3._mounted) return;
           _this3.setState({
             externalEvent: newEvent
@@ -380,8 +444,15 @@ export function renderKitchenSimulator(container) {
       }
     }]);
   }(React.Component);
-  root.render(/*#__PURE__*/React.createElement(Wrapper, props));
-  return {
+  var api = {
+    // internal: rerender wrapper with latest props if host calls renderKitchenSimulator again
+    __render: function __render(nextProps) {
+      root.render(/*#__PURE__*/React.createElement(Wrapper, nextProps));
+    },
+    /**
+     * Send one or many events (in order).
+     * Resolves when this batch has been delivered + settled.
+     */
     sendExternalEvents: function sendExternalEvents(eventOrEvents) {
       var events = Array.isArray(eventOrEvents) ? eventOrEvents : [eventOrEvents];
       var _iterator2 = _createForOfIteratorHelper(events),
@@ -391,8 +462,6 @@ export function renderKitchenSimulator(container) {
           var e = _step2.value;
           queue.push(e);
         }
-
-        // marker for this batch
       } catch (err) {
         _iterator2.e(err);
       } finally {
@@ -401,7 +470,8 @@ export function renderKitchenSimulator(container) {
       var token = Symbol('batch');
       pendingMarkers.add(token);
       queue.push({
-        __batchMarker: token
+        __marker: MARKER,
+        token: token
       });
       drain();
       return new Promise(function (resolve) {
@@ -440,21 +510,28 @@ export function renderKitchenSimulator(container) {
         check();
       });
     },
-    updateExternalEvent: function updateExternalEvent(newExternalEvent) {
-      return this.sendExternalEvents(newExternalEvent);
+    updateExternalEvent: function updateExternalEvent(e) {
+      return api.sendExternalEvents(e);
     },
     clearQueue: function clearQueue() {
       queue.length = 0;
       pendingMarkers.clear();
     },
     unmount: function unmount() {
-      var _this$clearQueue;
       destroyed = true;
-      (_this$clearQueue = this.clearQueue) === null || _this$clearQueue === void 0 || _this$clearQueue.call(this);
+      api.clearQueue();
       gltfTracker.uninstall();
       root.unmount();
       container[ROOT_KEY] = null;
+      container[API_KEY] = null;
     }
   };
+
+  // first render
+  api.__render(props);
+
+  // store api on container so repeated calls reuse it
+  container[API_KEY] = api;
+  return api;
 }
 export default renderKitchenSimulator;

package/lib/index.js

@@ -174,6 +174,7 @@ function installGltfTracker() {
   }
   var subscribe = function subscribe(fn) {
     listeners.add(fn);
+    // IMPORTANT: emits synchronously
     fn(inFlight);
     return function () {
       return listeners["delete"](fn);
@@ -181,8 +182,8 @@ function installGltfTracker() {
   };
 
   /**
-   * Wait until GLTF network is idle (inFlight===0).
-   * Includes a grace window to catch loads that start slightly after the event.
+   * Wait until inFlight becomes 0 (with grace window).
+   * Safe even when already idle.
    */
   var waitForIdle = /*#__PURE__*/function () {
     var _ref2 = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee3() {
@@ -209,7 +210,7 @@ function installGltfTracker() {
               var unsub = null;
               var onChange = function onChange(count) {
                 if (count === 0) {
-                  if (unsub) unsub(); // ✅ safe
+                  if (unsub) unsub();
                   resolve(true);
                   return;
                 }
@@ -247,104 +248,168 @@ function installGltfTracker() {
   };
 }
 function renderKitchenSimulator(container) {
-  var _props$framesPerEvent, _props$waitForGltfIdl, _props$gltfTimeoutMs, _props$gltfGraceMs;
+  var _props$framesPerEvent, _props$waitForGltfIdl, _props$gltfTimeoutMs, _props$gltfGraceMs, _props$syncGltfGraceM, _props$syncExtraFrame;
   var props = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  if (!container) throw new Error('renderKitchenSimulator: container is required');
+
+  // ✅ Reuse existing API for same container
+  if (container[API_KEY]) {
+    var _container$API_KEY$__, _container$API_KEY;
+    // update render with latest props (safe)
+    (_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];
+  }
+
+  // ✅ Reuse root for same container
   var root = container[ROOT_KEY];
   if (!root) {
     root = (0, _client.createRoot)(container);
     container[ROOT_KEY] = root;
   }
   var setExternalEventFn = null;
-  var queue = [];
-  var pendingMarkers = new Set();
-  var draining = false;
   var destroyed = false;
-  var FRAMES_PER_EVENT = (_props$framesPerEvent = props.framesPerEvent) !== null && _props$framesPerEvent !== void 0 ? _props$framesPerEvent : 2;
 
-  // ✅ assume all events may load gltfs
-  var WAIT_FOR_GLTF_IDLE_AFTER_EACH_EVENT = (_props$waitForGltfIdl = props.waitForGltfIdleAfterEachEvent) !== null && _props$waitForGltfIdl !== void 0 ? _props$waitForGltfIdl : true;
-  var GLTF_TIMEOUT_MS = (_props$gltfTimeoutMs = props.gltfTimeoutMs) !== null && _props$gltfTimeoutMs !== void 0 ? _props$gltfTimeoutMs : 30000;
-  var GLTF_GRACE_MS = (_props$gltfGraceMs = props.gltfGraceMs) !== null && _props$gltfGraceMs !== void 0 ? _props$gltfGraceMs : 50;
+  // queue + marker handling
+  var queue = [];
+  var pendingMarkers = new Set();
+  var MARKER = Symbol('marker');
   var gltfTracker = installGltfTracker();
-  function drain() {
-    return _drain.apply(this, arguments);
+
+  // defaults
+  var defaultFramesPerEvent = (_props$framesPerEvent = props.framesPerEvent) !== null && _props$framesPerEvent !== void 0 ? _props$framesPerEvent : 2;
+  var waitForGltf = (_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;
+  var defaultGrace = (_props$gltfGraceMs = props.gltfGraceMs) !== null && _props$gltfGraceMs !== void 0 ? _props$gltfGraceMs : 50;
+  var syncGrace = (_props$syncGltfGraceM = props.syncGltfGraceMs) !== null && _props$syncGltfGraceM !== void 0 ? _props$syncGltfGraceM : 250; // SyncScene uses larger grace
+  var syncExtraFrames = (_props$syncExtraFrame = props.syncExtraFrames) !== null && _props$syncExtraFrame !== void 0 ? _props$syncExtraFrame : 2;
+  var draining = false;
+  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' ||
+    // if you pass mode sometimes
+    (ev === null || ev === void 0 ? void 0 : ev.__sync) === true;
   }
-  function _drain() {
-    _drain = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee5() {
-      var _setExternalEventFn, ev, i, _ev$gltfTimeoutMs, _ev$gltfGraceMs;
+  function settle(_x) {
+    return _settle.apply(this, arguments);
+  }
+  function _settle() {
+    _settle = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee5(ev) {
+      var _ev$framesPerEvent, _ev$gltfGraceMs, _ev$gltfTimeoutMs;
+      var frames, i, graceMs, timeoutMs, _i;
       return _regenerator["default"].wrap(function (_context5) {
         while (1) switch (_context5.prev = _context5.next) {
           case 0:
-            if (!(draining || destroyed)) {
-              _context5.next = 1;
-              break;
-            }
-            return _context5.abrupt("return");
+            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
+            i = 0;
           case 1:
-            draining = true;
-            _context5.prev = 2;
-          case 3:
-            if (!(queue.length && !destroyed)) {
-              _context5.next = 12;
+            if (!(i < frames)) {
+              _context5.next = 3;
               break;
             }
-            ev = queue.shift(); // skip internal markers
-            if (!(ev && ev.__batchMarker)) {
+            _context5.next = 2;
+            return nextFrame();
+          case 2:
+            i += 1;
+            _context5.next = 1;
+            break;
+          case 3:
+            if (waitForGltf) {
               _context5.next = 4;
               break;
             }
-            pendingMarkers["delete"](ev.__batchMarker);
-            return _context5.abrupt("continue", 3);
+            return _context5.abrupt("return");
           case 4:
-            if (setExternalEventFn) {
-              _context5.next = 6;
-              break;
-            }
+            // 2) wait for gltf idle
+            graceMs = isSyncScene(ev) ? syncGrace : (_ev$gltfGraceMs = ev === null || ev === void 0 ? void 0 : ev.gltfGraceMs) !== null && _ev$gltfGraceMs !== void 0 ? _ev$gltfGraceMs : defaultGrace;
+            timeoutMs = (_ev$gltfTimeoutMs = ev === null || ev === void 0 ? void 0 : ev.gltfTimeoutMs) !== null && _ev$gltfTimeoutMs !== void 0 ? _ev$gltfTimeoutMs : defaultTimeout;
             _context5.next = 5;
-            return nextFrame();
+            return gltfTracker.waitForIdle({
+              graceMs: graceMs,
+              timeoutMs: timeoutMs
+            });
           case 5:
-            return _context5.abrupt("continue", 3);
+            _context5.next = 6;
+            return nextFrame();
           case 6:
-            (_setExternalEventFn = setExternalEventFn) === null || _setExternalEventFn === void 0 || _setExternalEventFn(ev);
-
-            // baseline spacing for react + legacy lifecycle
-            i = 0;
+            if (!isSyncScene(ev)) {
+              _context5.next = 9;
+              break;
+            }
+            _i = 0;
           case 7:
-            if (!(i < FRAMES_PER_EVENT)) {
+            if (!(_i < syncExtraFrames)) {
               _context5.next = 9;
               break;
             }
             _context5.next = 8;
             return nextFrame();
           case 8:
-            i += 1;
+            _i += 1;
             _context5.next = 7;
             break;
           case 9:
-            if (!WAIT_FOR_GLTF_IDLE_AFTER_EACH_EVENT) {
-              _context5.next = 11;
+          case "end":
+            return _context5.stop();
+        }
+      }, _callee5);
+    }));
+    return _settle.apply(this, arguments);
+  }
+  function drain() {
+    return _drain.apply(this, arguments);
+  }
+  function _drain() {
+    _drain = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee6() {
+      var item;
+      return _regenerator["default"].wrap(function (_context6) {
+        while (1) switch (_context6.prev = _context6.next) {
+          case 0:
+            if (!(draining || destroyed)) {
+              _context6.next = 1;
               break;
             }
-            _context5.next = 10;
-            return gltfTracker.waitForIdle({
-              timeoutMs: (_ev$gltfTimeoutMs = ev === null || ev === void 0 ? void 0 : ev.gltfTimeoutMs) !== null && _ev$gltfTimeoutMs !== void 0 ? _ev$gltfTimeoutMs : GLTF_TIMEOUT_MS,
-              graceMs: (_ev$gltfGraceMs = ev === null || ev === void 0 ? void 0 : ev.gltfGraceMs) !== null && _ev$gltfGraceMs !== void 0 ? _ev$gltfGraceMs : GLTF_GRACE_MS
-            });
-          case 10:
-            _context5.next = 11;
+            return _context6.abrupt("return");
+          case 1:
+            draining = true;
+            _context6.prev = 2;
+          case 3:
+            if (!(queue.length && !destroyed)) {
+              _context6.next = 8;
+              break;
+            }
+            item = queue.shift(); // marker?
+            if (!(item && item.__marker === MARKER)) {
+              _context6.next = 4;
+              break;
+            }
+            pendingMarkers["delete"](item.token);
+            return _context6.abrupt("continue", 3);
+          case 4:
+            if (setExternalEventFn) {
+              _context6.next = 6;
+              break;
+            }
+            _context6.next = 5;
             return nextFrame();
-          case 11:
-            _context5.next = 3;
+          case 5:
+            queue.unshift(item); // put back and retry
+            return _context6.abrupt("continue", 3);
+          case 6:
+            setExternalEventFn(item);
+            _context6.next = 7;
+            return settle(item);
+          case 7:
+            _context6.next = 3;
             break;
-          case 12:
-            _context5.prev = 12;
+          case 8:
+            _context6.prev = 8;
             draining = false;
-            return _context5.finish(12);
-          case 13:
+            return _context6.finish(8);
+          case 9:
           case "end":
-            return _context5.stop();
+            return _context6.stop();
         }
-      }, _callee5, null, [[2,, 12, 13]]);
+      }, _callee6, null, [[2,, 8, 9]]);
     }));
     return _drain.apply(this, arguments);
   }
@@ -366,7 +431,6 @@ function renderKitchenSimulator(container) {
         var _this3 = this;
         this._mounted = true;
         setExternalEventFn = function setExternalEventFn(newEvent) {
-          // ✅ ensure we never setState during render
           if (!_this3._mounted) return;
           _this3.setState({
             externalEvent: newEvent
@@ -388,8 +452,15 @@ function renderKitchenSimulator(container) {
       }
     }]);
   }(_react["default"].Component);
-  root.render(/*#__PURE__*/_react["default"].createElement(Wrapper, props));
-  return {
+  var api = {
+    // internal: rerender wrapper with latest props if host calls renderKitchenSimulator again
+    __render: function __render(nextProps) {
+      root.render(/*#__PURE__*/_react["default"].createElement(Wrapper, nextProps));
+    },
+    /**
+     * Send one or many events (in order).
+     * Resolves when this batch has been delivered + settled.
+     */
     sendExternalEvents: function sendExternalEvents(eventOrEvents) {
       var events = Array.isArray(eventOrEvents) ? eventOrEvents : [eventOrEvents];
       var _iterator2 = _createForOfIteratorHelper(events),
@@ -399,8 +470,6 @@ function renderKitchenSimulator(container) {
           var e = _step2.value;
           queue.push(e);
         }
-
-        // marker for this batch
       } catch (err) {
         _iterator2.e(err);
       } finally {
@@ -409,7 +478,8 @@ function renderKitchenSimulator(container) {
       var token = Symbol('batch');
       pendingMarkers.add(token);
       queue.push({
-        __batchMarker: token
+        __marker: MARKER,
+        token: token
       });
       drain();
       return new Promise(function (resolve) {
@@ -448,21 +518,28 @@ function renderKitchenSimulator(container) {
         check();
       });
     },
-    updateExternalEvent: function updateExternalEvent(newExternalEvent) {
-      return this.sendExternalEvents(newExternalEvent);
+    updateExternalEvent: function updateExternalEvent(e) {
+      return api.sendExternalEvents(e);
     },
     clearQueue: function clearQueue() {
       queue.length = 0;
       pendingMarkers.clear();
     },
     unmount: function unmount() {
-      var _this$clearQueue;
       destroyed = true;
-      (_this$clearQueue = this.clearQueue) === null || _this$clearQueue === void 0 || _this$clearQueue.call(this);
+      api.clearQueue();
       gltfTracker.uninstall();
       root.unmount();
       container[ROOT_KEY] = null;
+      container[API_KEY] = null;
     }
   };
+
+  // first render
+  api.__render(props);
+
+  // store api on container so repeated calls reuse it
+  container[API_KEY] = api;
+  return api;
 }
 var _default = exports["default"] = renderKitchenSimulator;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitchen-simulator",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "It is a kitchen simulator (self-contained micro-frontend).",
   "license": "MIT",
   "main": "lib/index.js",