vestjs-runtime 0.1.0-dev-ae6b14 → 0.1.0-next-cc6009

package/README.md

@@ -1,3 +1,3 @@
 # vestjs-runtime
 
-Internal runtime module used by Vest. This module is not intended to be used directly, but rather used by the `vest` package.
+Internal Runtime module used by Vest. This module is not intended to be used directly, but rather used by the `vest` package.

package/dist/cjs/vestjs-runtime.development.js

@@ -3,6 +3,37 @@
 var vestUtils = require('vest-utils');
 var context = require('context');
 
+class IsolateMutator {
+    static setParent(isolate, parent) {
+        isolate.parent = parent;
+        return isolate;
+    }
+    static saveOutput(isolate, output) {
+        isolate.output = output;
+        return isolate;
+    }
+    static setKey(isolate, key) {
+        isolate.key = key;
+        return isolate;
+    }
+    static addChild(isolate, child) {
+        vestUtils.invariant(isolate.children);
+        isolate.children.push(child);
+        IsolateMutator.setParent(child, isolate);
+    }
+    static removeChild(isolate, node) {
+        var _a, _b;
+        isolate.children =
+            (_b = (_a = isolate.children) === null || _a === void 0 ? void 0 : _a.filter(child => child !== node)) !== null && _b !== void 0 ? _b : null;
+    }
+    static slice(isolate, at) {
+        if (vestUtils.isNullish(isolate.children)) {
+            return;
+        }
+        isolate.children.length = at;
+    }
+}
+
 // eslint-disable-next-line
 function walk(startNode, callback, visitOnly) {
     // If the startNode has no children, there is nothing to walk.
@@ -84,7 +115,7 @@ function every(startNode, predicate, visitOnly) {
 function pluck(startNode, predicate, visitOnly) {
     walk(startNode, node => {
         if (predicate(node) && node.parent) {
-            node.parent.removeChild(node);
+            IsolateMutator.removeChild(node.parent, node);
         }
     }, visitOnly);
 }
@@ -92,12 +123,12 @@ function pluck(startNode, predicate, visitOnly) {
 //startNode that satisfies the given predicate function.
 function closest(startNode, predicate) {
     let current = startNode;
-    while (current.parent) {
+    do {
         if (predicate(current)) {
             return current;
         }
         current = current.parent;
-    }
+    } while (current);
     return null;
 }
 // This function returns true if the closest ancestor Isolates of the
@@ -118,6 +149,46 @@ var IsolateWalker = /*#__PURE__*/Object.freeze({
   walk: walk
 });
 
+class IsolateInspector {
+    static at(isolate, at) {
+        var _a, _b;
+        if (vestUtils.isNullish(isolate)) {
+            return null;
+        }
+        return (_b = (_a = isolate.children) === null || _a === void 0 ? void 0 : _a[at]) !== null && _b !== void 0 ? _b : null;
+    }
+    static cursor(isolate) {
+        var _a, _b;
+        if (vestUtils.isNullish(isolate)) {
+            return 0;
+        }
+        return (_b = (_a = isolate.children) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+    }
+    static shouldAllowReorder(isolate) {
+        if (vestUtils.isNullish(isolate)) {
+            return false;
+        }
+        return closestExists(isolate, node => node.allowReorder);
+    }
+    static usesKey(isolate) {
+        if (vestUtils.isNullish(isolate)) {
+            return false;
+        }
+        return vestUtils.isNotNullish(isolate.key);
+    }
+    static dump(isolate) {
+        if (vestUtils.isNullish(isolate)) {
+            return '';
+        }
+        return JSON.stringify(isolate, (key, value) => {
+            if (key === 'parent') {
+                return undefined;
+            }
+            return value;
+        });
+    }
+}
+
 var ErrorStrings;
 (function (ErrorStrings) {
     ErrorStrings["NO_ACTIVE_ISOLATE"] = "Not within an active isolate";
@@ -142,30 +213,14 @@ const PersistedContext = context.createCascade((stateRef, parentContext) => {
 const Run = PersistedContext.run;
 const RuntimeApi = {
     Run,
+    addNodeToHistory,
     createRef,
     persist,
     reset,
     useAvailableRoot,
-    useBus,
     useCurrentCursor,
-    useEmit,
-    usePrepareEmitter,
     useXAppData,
 };
-function useBus() {
-    return useX().stateRef.Bus;
-}
-/*
-  Returns an emitter, but it also has a shortcut for emitting an event immediately
-  by passing an event name.
-*/
-function useEmit() {
-    return persist(useBus().emit);
-}
-function usePrepareEmitter(event) {
-    const emit = useEmit();
-    return (arg) => emit(event, arg);
-}
 function useXAppData() {
     return useX().stateRef.appData;
 }
@@ -193,6 +248,16 @@ function useHistoryRoot() {
 function useHistoryNode() {
     return useX().historyNode;
 }
+function addNodeToHistory(node) {
+    const parent = useIsolate();
+    if (parent) {
+        useSetNextIsolateChild(node);
+    }
+    else {
+        useSetHistory(node);
+    }
+    IsolateMutator.setParent(node, parent);
+}
 function useSetHistory(history) {
     const [, setHistoryRoot] = useHistoryRoot();
     setHistoryRoot(history);
@@ -210,8 +275,8 @@ function useIsolate() {
     return (_a = useX().runtimeNode) !== null && _a !== void 0 ? _a : null;
 }
 function useCurrentCursor() {
-    var _a, _b;
-    return (_b = (_a = useIsolate()) === null || _a === void 0 ? void 0 : _a.cursor()) !== null && _b !== void 0 ? _b : 0;
+    const isolate = useIsolate();
+    return isolate ? IsolateInspector.cursor(isolate) : 0;
 }
 function useRuntimeRoot() {
     return useX().runtimeRoot;
@@ -219,7 +284,7 @@ function useRuntimeRoot() {
 function useSetNextIsolateChild(child) {
     const currentIsolate = useIsolate();
     vestUtils.invariant(currentIsolate, ErrorStrings.NO_ACTIVE_ISOLATE);
-    currentIsolate.addChild(child);
+    IsolateMutator.addChild(currentIsolate, child);
 }
 function useSetIsolateKey(key, value) {
     if (!key) {
@@ -254,15 +319,13 @@ function BaseReconciler(currentNode, historicNode) {
 }
 class Reconciler {
     static reconcile(reconciler, node, callback) {
-        var _a;
         const parent = useIsolate();
         const historyNode = useHistoryNode();
         let localHistoryNode = historyNode;
         if (parent) {
             // If we have a parent, we need to get the history node from the parent's children
             // We take the history node from the cursor of the active node's children
-            localHistoryNode =
-                (_a = historyNode === null || historyNode === void 0 ? void 0 : historyNode.at(useCurrentCursor())) !== null && _a !== void 0 ? _a : null;
+            localHistoryNode = IsolateInspector.at(historyNode, IsolateInspector.cursor(parent));
         }
         const nextNode = reconciler(node, localHistoryNode);
         vestUtils.invariant(nextNode);
@@ -277,12 +340,13 @@ class Reconciler {
         if (!historyNode || !testIsolate) {
             // This is probably unreachable, but TS is not convinced.
             // Let's play it safe.
+            /* istanbul ignore next */
             return;
         }
-        historyNode.slice(useCurrentCursor());
+        IsolateMutator.slice(historyNode, IsolateInspector.cursor(testIsolate));
     }
     static handleIsolateNodeWithKey(node) {
-        vestUtils.invariant(node.usesKey());
+        vestUtils.invariant(IsolateInspector.usesKey(node));
         const prevNodeByKey = useHistoryKey(node.key);
         let nextNode = node;
         if (!vestUtils.isNullish(prevNodeByKey)) {
@@ -309,80 +373,49 @@ class Isolate {
         this.parent = null;
         this.key = null;
         this.allowReorder = false;
-    }
-    setParent(parent) {
-        this.parent = parent;
-        return this;
-    }
-    saveOutput(output) {
-        this.output = output;
-        return this;
-    }
-    setKey(key) {
-        this.key = key;
-        return this;
-    }
-    usesKey() {
-        return vestUtils.isNotNullish(this.key);
-    }
-    addChild(child) {
-        vestUtils.invariant(this.children);
-        this.children.push(child);
-    }
-    removeChild(node) {
-        var _a, _b;
-        this.children = (_b = (_a = this.children) === null || _a === void 0 ? void 0 : _a.filter(child => child !== node)) !== null && _b !== void 0 ? _b : null;
-    }
-    slice(at) {
-        if (vestUtils.isNullish(this.children)) {
-            return;
-        }
-        this.children.length = at;
-    }
-    at(at) {
-        var _a, _b;
-        return (_b = (_a = this.children) === null || _a === void 0 ? void 0 : _a[at]) !== null && _b !== void 0 ? _b : null;
-    }
-    cursor() {
-        var _a, _b;
-        return (_b = (_a = this.children) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
-    }
-    shouldAllowReorder() {
-        var _a;
-        return (_a = closestExists(this, node => node.allowReorder)) !== null && _a !== void 0 ? _a : false;
-    }
-    get rootNode() {
-        var _a;
-        return (_a = closest(this, node => vestUtils.isNullish(node.parent))) !== null && _a !== void 0 ? _a : this;
+        this.type = 'Isolate';
     }
     static create(callback, data) {
-        return this.createImplementation(callback, data);
-    }
-    static createImplementation(callback, data) {
         const parent = useIsolate();
-        const newCreatedNode = new this(data).setParent(parent);
+        const newCreatedNode = IsolateMutator.setParent(new this(data), parent);
         const [nextIsolateChild, output] = Reconciler.reconcile(this.reconciler, newCreatedNode, callback);
-        nextIsolateChild.saveOutput(output);
-        this.setNode(nextIsolateChild);
+        IsolateMutator.saveOutput(nextIsolateChild, output);
+        addNodeToHistory(nextIsolateChild);
         return nextIsolateChild;
     }
-    static setNode(node) {
-        const parent = useIsolate();
-        if (parent) {
-            useSetNextIsolateChild(node);
-        }
-        else {
-            useSetHistory(node);
-        }
-        node.setParent(parent);
-    }
-    static is(node) {
-        return node instanceof Isolate;
-    }
 }
 Isolate.reconciler = BaseReconciler;
 
+function useBus() {
+    return useX().stateRef.Bus;
+}
+/*
+  Returns an emitter, but it also has a shortcut for emitting an event immediately
+  by passing an event name.
+*/
+function useEmit(event, data) {
+    const emit = useBus().emit;
+    if (!vestUtils.isNullish(event)) {
+        emit(event, data);
+    }
+    return persist(emit);
+}
+function usePrepareEmitter(event) {
+    const emit = useEmit();
+    return (arg) => emit(event, arg);
+}
+
+var Bus = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  useBus: useBus,
+  useEmit: useEmit,
+  usePrepareEmitter: usePrepareEmitter
+});
+
+exports.Bus = Bus;
 exports.Isolate = Isolate;
+exports.IsolateInspector = IsolateInspector;
+exports.IsolateMutator = IsolateMutator;
 exports.Reconciler = Reconciler;
 exports.VestRuntime = RuntimeApi;
 exports.Walker = IsolateWalker;

package/dist/cjs/vestjs-runtime.js

@@ -1,5 +1,4 @@
 'use strict'
-
 if (process.env.NODE_ENV === 'production') {
   module.exports = require('./vestjs-runtime.production.js');
 } else {

package/dist/cjs/vestjs-runtime.production.js

@@ -1 +1 @@
-"use strict";var t=require("vest-utils"),e=require("context");function n(e,r,i){if(t.isNullish(e.children))return;let s=!1;for(const o of e.children){if(s)return;if((t.isNullish(i)||t.optionalFunctionValue(i,o))&&r(o,u),s)return;n(o,((t,e)=>{r(t,(()=>{e(),u()}))}),i)}function u(){s=!0}}function r(t,e,r){let i=!1;return n(t,((t,n)=>{e(t)&&(n(),i=!0)}),r),i}function i(t,e){let n=t;for(;n.parent;){if(e(n))return n;n=n.parent}return null}function s(t,e){return!!i(t,e)}var u,o=Object.freeze({__proto__:null,closest:i,closestExists:s,every:function(t,e,r){let i=!0;return n(t,((t,n)=>{e(t)||(n(),i=!1)}),r),i},find:function(t,e,r){let i=null;return n(t,((t,n)=>{e(t)&&(n(),i=t)}),r),i},has:function(t,e){return r(t,(()=>!0),e)},pluck:function(t,e,r){n(t,(t=>{e(t)&&t.parent&&t.parent.removeChild(t)}),r)},some:r,walk:n});!function(t){t.NO_ACTIVE_ISOLATE="Not within an active isolate",t.ENCOUNTERED_THE_SAME_KEY_TWICE='Encountered the same test key "{key}" twice. This may lead to tests overriding each other\'s results, or to tests being unexpectedly omitted.'}(u||(u={}));const l=e.createCascade(((e,n)=>{if(n)return null;t.invariant(e.historyRoot);const[r]=e.historyRoot(),i={};return t.assign(i,{historyNode:r,runtimeNode:null,runtimeRoot:null,stateRef:e}),i})),c=l.run,a={Run:c,createRef:function(e){return Object.freeze({historyRoot:t.tinyState.createTinyState(null),Bus:t.bus.createBus(),appData:t.optionalFunctionValue(e)})},persist:f,reset:function(){const[,,t]=p();t()},useAvailableRoot:function(){const t=R();if(t)return t;const[e]=p();return e},useBus:h,useCurrentCursor:E,useEmit:d,usePrepareEmitter:function(t){const e=d();return n=>e(t,n)},useXAppData:function(){return v().stateRef.appData}};function h(){return v().stateRef.Bus}function d(){return f(h().emit)}function f(t){const e=l.useX();return(...n)=>{var r;const i=null!==(r=l.use())&&void 0!==r?r:e;return l.run(i.stateRef,(()=>t(...n)))}}function v(){return l.useX()}function p(){return v().stateRef.historyRoot()}function N(){return v().historyNode}function y(){var t;return null!==(t=v().runtimeNode)&&void 0!==t?t:null}function E(){var t,e;return null!==(e=null===(t=y())||void 0===t?void 0:t.cursor())&&void 0!==e?e:0}function R(){return v().runtimeRoot}class m{static reconcile(e,n,r){var i;const s=y(),u=N();let o=u;s&&(o=null!==(i=null==u?void 0:u.at(E()))&&void 0!==i?i:null);const l=e(n,o);return t.invariant(l),Object.is(l,n)?[n,_(o,n,r)]:[l,l.output]}static removeAllNextNodesInIsolate(){const t=y(),e=N();e&&t&&e.slice(E())}static handleIsolateNodeWithKey(e){t.invariant(e.usesKey());const n=function(e){var n;if(t.isNullish(e))return null;const r=v().historyNode;return null!==(n=null==r?void 0:r.keys[e])&&void 0!==n?n:null}(e.key);let r=e;return t.isNullish(n)||(r=n),function(e,n){if(!e)return;const r=y();t.invariant(r,u.NO_ACTIVE_ISOLATE),t.isNullish(r.keys[e])?r.keys[e]=n:t.deferThrow(t.text(u.ENCOUNTERED_THE_SAME_KEY_TWICE,{key:e}))}(e.key,e),r}}function _(t,e,n){const r=R(),i=c(Object.assign({historyNode:t,runtimeNode:e},!r&&{runtimeRoot:e}),(()=>n(e)));return e.output=i,i}class k{constructor(t){this.children=[],this.keys={},this.parent=null,this.key=null,this.allowReorder=!1}setParent(t){return this.parent=t,this}saveOutput(t){return this.output=t,this}setKey(t){return this.key=t,this}usesKey(){return t.isNotNullish(this.key)}addChild(e){t.invariant(this.children),this.children.push(e)}removeChild(t){var e,n;this.children=null!==(n=null===(e=this.children)||void 0===e?void 0:e.filter((e=>e!==t)))&&void 0!==n?n:null}slice(e){t.isNullish(this.children)||(this.children.length=e)}at(t){var e,n;return null!==(n=null===(e=this.children)||void 0===e?void 0:e[t])&&void 0!==n?n:null}cursor(){var t,e;return null!==(e=null===(t=this.children)||void 0===t?void 0:t.length)&&void 0!==e?e:0}shouldAllowReorder(){var t;return null!==(t=s(this,(t=>t.allowReorder)))&&void 0!==t&&t}get rootNode(){var e;return null!==(e=i(this,(e=>t.isNullish(e.parent))))&&void 0!==e?e:this}static create(t,e){return this.createImplementation(t,e)}static createImplementation(t,e){const n=y(),r=new this(e).setParent(n),[i,s]=m.reconcile(this.reconciler,r,t);return i.saveOutput(s),this.setNode(i),i}static setNode(e){const n=y();n?function(e){const n=y();t.invariant(n,u.NO_ACTIVE_ISOLATE),n.addChild(e)}(e):function(t){const[,e]=p();e(t)}(e),e.setParent(n)}static is(t){return t instanceof k}}k.reconciler=function(e,n){return t.isNullish(n),e},exports.Isolate=k,exports.Reconciler=m,exports.VestRuntime=a,exports.Walker=o;
+"use strict";var t=require("vest-utils"),e=require("context");class n{static setParent(t,e){return t.parent=e,t}static saveOutput(t,e){return t.output=e,t}static setKey(t,e){return t.key=e,t}static addChild(e,r){t.invariant(e.children),e.children.push(r),n.setParent(r,e)}static removeChild(t,e){var n,r;t.children=null!==(r=null===(n=t.children)||void 0===n?void 0:n.filter((t=>t!==e)))&&void 0!==r?r:null}static slice(e,n){t.isNullish(e.children)||(e.children.length=n)}}function r(e,n,i){if(t.isNullish(e.children))return;let s=!1;for(const o of e.children){if(s)return;if((t.isNullish(i)||t.optionalFunctionValue(i,o))&&n(o,u),s)return;r(o,((t,e)=>{n(t,(()=>{e(),u()}))}),i)}function u(){s=!0}}function i(t,e,n){let i=!1;return r(t,((t,n)=>{e(t)&&(n(),i=!0)}),n),i}function s(t,e){let n=t;do{if(e(n))return n;n=n.parent}while(n);return null}function u(t,e){return!!s(t,e)}var o,l=Object.freeze({__proto__:null,closest:s,closestExists:u,every:function(t,e,n){let i=!0;return r(t,((t,n)=>{e(t)||(n(),i=!1)}),n),i},find:function(t,e,n){let i=null;return r(t,((t,n)=>{e(t)&&(n(),i=t)}),n),i},has:function(t,e){return i(t,(()=>!0),e)},pluck:function(t,e,i){r(t,(t=>{e(t)&&t.parent&&n.removeChild(t.parent,t)}),i)},some:i,walk:r});class c{static at(e,n){var r,i;return t.isNullish(e)?null:null!==(i=null===(r=e.children)||void 0===r?void 0:r[n])&&void 0!==i?i:null}static cursor(e){var n,r;return t.isNullish(e)?0:null!==(r=null===(n=e.children)||void 0===n?void 0:n.length)&&void 0!==r?r:0}static shouldAllowReorder(e){return!t.isNullish(e)&&u(e,(t=>t.allowReorder))}static usesKey(e){return!t.isNullish(e)&&t.isNotNullish(e.key)}static dump(e){return t.isNullish(e)?"":JSON.stringify(e,((t,e)=>{if("parent"!==t)return e}))}}!function(t){t.NO_ACTIVE_ISOLATE="Not within an active isolate",t.ENCOUNTERED_THE_SAME_KEY_TWICE='Encountered the same test key "{key}" twice. This may lead to tests overriding each other\'s results, or to tests being unexpectedly omitted.'}(o||(o={}));const a=e.createCascade(((e,n)=>{if(n)return null;t.invariant(e.historyRoot);const[r]=e.historyRoot(),i={};return t.assign(i,{historyNode:r,runtimeNode:null,runtimeRoot:null,stateRef:e}),i})),d=a.run,h={Run:d,addNodeToHistory:y,createRef:function(e){return Object.freeze({historyRoot:t.tinyState.createTinyState(null),Bus:t.bus.createBus(),appData:t.optionalFunctionValue(e)})},persist:f,reset:function(){const[,,t]=p();t()},useAvailableRoot:function(){const t=R();if(t)return t;const[e]=p();return e},useCurrentCursor:function(){const t=E();return t?c.cursor(t):0},useXAppData:function(){return v().stateRef.appData}};function f(t){const e=a.useX();return(...n)=>{var r;const i=null!==(r=a.use())&&void 0!==r?r:e;return a.run(i.stateRef,(()=>t(...n)))}}function v(){return a.useX()}function p(){return v().stateRef.historyRoot()}function N(){return v().historyNode}function y(e){const r=E();r?function(e){const r=E();t.invariant(r,o.NO_ACTIVE_ISOLATE),n.addChild(r,e)}(e):function(t){const[,e]=p();e(t)}(e),n.setParent(e,r)}function E(){var t;return null!==(t=v().runtimeNode)&&void 0!==t?t:null}function R(){return v().runtimeRoot}class _{static reconcile(e,n,r){const i=E(),s=N();let u=s;i&&(u=c.at(s,c.cursor(i)));const o=e(n,u);return t.invariant(o),Object.is(o,n)?[n,m(u,n,r)]:[o,o.output]}static removeAllNextNodesInIsolate(){const t=E(),e=N();e&&t&&n.slice(e,c.cursor(t))}static handleIsolateNodeWithKey(e){t.invariant(c.usesKey(e));const n=function(e){var n;if(t.isNullish(e))return null;const r=v().historyNode;return null!==(n=null==r?void 0:r.keys[e])&&void 0!==n?n:null}(e.key);let r=e;return t.isNullish(n)||(r=n),function(e,n){if(!e)return;const r=E();t.invariant(r,o.NO_ACTIVE_ISOLATE),t.isNullish(r.keys[e])?r.keys[e]=n:t.deferThrow(t.text(o.ENCOUNTERED_THE_SAME_KEY_TWICE,{key:e}))}(e.key,e),r}}function m(t,e,n){const r=R(),i=d(Object.assign({historyNode:t,runtimeNode:e},!r&&{runtimeRoot:e}),(()=>n(e)));return e.output=i,i}class I{constructor(t){this.children=[],this.keys={},this.parent=null,this.key=null,this.allowReorder=!1,this.type="Isolate"}static create(t,e){const r=E(),i=n.setParent(new this(e),r),[s,u]=_.reconcile(this.reconciler,i,t);return n.saveOutput(s,u),y(s),s}}function O(){return v().stateRef.Bus}function T(e,n){const r=O().emit;return t.isNullish(e)||r(e,n),f(r)}I.reconciler=function(e,n){return t.isNullish(n),e};var k=Object.freeze({__proto__:null,useBus:O,useEmit:T,usePrepareEmitter:function(t){const e=T();return n=>e(t,n)}});exports.Bus=k,exports.Isolate=I,exports.IsolateInspector=c,exports.IsolateMutator=n,exports.Reconciler=_,exports.VestRuntime=h,exports.Walker=l;

package/dist/es/vestjs-runtime.development.js

@@ -1,6 +1,37 @@
-import { isNullish, optionalFunctionValue, invariant, assign, tinyState, bus, deferThrow, text, isNotNullish } from 'vest-utils';
+import { invariant, isNullish, optionalFunctionValue, isNotNullish, assign, tinyState, bus, deferThrow, text } from 'vest-utils';
 import { createCascade } from 'context';
 
+class IsolateMutator {
+    static setParent(isolate, parent) {
+        isolate.parent = parent;
+        return isolate;
+    }
+    static saveOutput(isolate, output) {
+        isolate.output = output;
+        return isolate;
+    }
+    static setKey(isolate, key) {
+        isolate.key = key;
+        return isolate;
+    }
+    static addChild(isolate, child) {
+        invariant(isolate.children);
+        isolate.children.push(child);
+        IsolateMutator.setParent(child, isolate);
+    }
+    static removeChild(isolate, node) {
+        var _a, _b;
+        isolate.children =
+            (_b = (_a = isolate.children) === null || _a === void 0 ? void 0 : _a.filter(child => child !== node)) !== null && _b !== void 0 ? _b : null;
+    }
+    static slice(isolate, at) {
+        if (isNullish(isolate.children)) {
+            return;
+        }
+        isolate.children.length = at;
+    }
+}
+
 // eslint-disable-next-line
 function walk(startNode, callback, visitOnly) {
     // If the startNode has no children, there is nothing to walk.
@@ -82,7 +113,7 @@ function every(startNode, predicate, visitOnly) {
 function pluck(startNode, predicate, visitOnly) {
     walk(startNode, node => {
         if (predicate(node) && node.parent) {
-            node.parent.removeChild(node);
+            IsolateMutator.removeChild(node.parent, node);
         }
     }, visitOnly);
 }
@@ -90,12 +121,12 @@ function pluck(startNode, predicate, visitOnly) {
 //startNode that satisfies the given predicate function.
 function closest(startNode, predicate) {
     let current = startNode;
-    while (current.parent) {
+    do {
         if (predicate(current)) {
             return current;
         }
         current = current.parent;
-    }
+    } while (current);
     return null;
 }
 // This function returns true if the closest ancestor Isolates of the
@@ -116,6 +147,46 @@ var IsolateWalker = /*#__PURE__*/Object.freeze({
   walk: walk
 });
 
+class IsolateInspector {
+    static at(isolate, at) {
+        var _a, _b;
+        if (isNullish(isolate)) {
+            return null;
+        }
+        return (_b = (_a = isolate.children) === null || _a === void 0 ? void 0 : _a[at]) !== null && _b !== void 0 ? _b : null;
+    }
+    static cursor(isolate) {
+        var _a, _b;
+        if (isNullish(isolate)) {
+            return 0;
+        }
+        return (_b = (_a = isolate.children) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+    }
+    static shouldAllowReorder(isolate) {
+        if (isNullish(isolate)) {
+            return false;
+        }
+        return closestExists(isolate, node => node.allowReorder);
+    }
+    static usesKey(isolate) {
+        if (isNullish(isolate)) {
+            return false;
+        }
+        return isNotNullish(isolate.key);
+    }
+    static dump(isolate) {
+        if (isNullish(isolate)) {
+            return '';
+        }
+        return JSON.stringify(isolate, (key, value) => {
+            if (key === 'parent') {
+                return undefined;
+            }
+            return value;
+        });
+    }
+}
+
 var ErrorStrings;
 (function (ErrorStrings) {
     ErrorStrings["NO_ACTIVE_ISOLATE"] = "Not within an active isolate";
@@ -140,30 +211,14 @@ const PersistedContext = createCascade((stateRef, parentContext) => {
 const Run = PersistedContext.run;
 const RuntimeApi = {
     Run,
+    addNodeToHistory,
     createRef,
     persist,
     reset,
     useAvailableRoot,
-    useBus,
     useCurrentCursor,
-    useEmit,
-    usePrepareEmitter,
     useXAppData,
 };
-function useBus() {
-    return useX().stateRef.Bus;
-}
-/*
-  Returns an emitter, but it also has a shortcut for emitting an event immediately
-  by passing an event name.
-*/
-function useEmit() {
-    return persist(useBus().emit);
-}
-function usePrepareEmitter(event) {
-    const emit = useEmit();
-    return (arg) => emit(event, arg);
-}
 function useXAppData() {
     return useX().stateRef.appData;
 }
@@ -191,6 +246,16 @@ function useHistoryRoot() {
 function useHistoryNode() {
     return useX().historyNode;
 }
+function addNodeToHistory(node) {
+    const parent = useIsolate();
+    if (parent) {
+        useSetNextIsolateChild(node);
+    }
+    else {
+        useSetHistory(node);
+    }
+    IsolateMutator.setParent(node, parent);
+}
 function useSetHistory(history) {
     const [, setHistoryRoot] = useHistoryRoot();
     setHistoryRoot(history);
@@ -208,8 +273,8 @@ function useIsolate() {
     return (_a = useX().runtimeNode) !== null && _a !== void 0 ? _a : null;
 }
 function useCurrentCursor() {
-    var _a, _b;
-    return (_b = (_a = useIsolate()) === null || _a === void 0 ? void 0 : _a.cursor()) !== null && _b !== void 0 ? _b : 0;
+    const isolate = useIsolate();
+    return isolate ? IsolateInspector.cursor(isolate) : 0;
 }
 function useRuntimeRoot() {
     return useX().runtimeRoot;
@@ -217,7 +282,7 @@ function useRuntimeRoot() {
 function useSetNextIsolateChild(child) {
     const currentIsolate = useIsolate();
     invariant(currentIsolate, ErrorStrings.NO_ACTIVE_ISOLATE);
-    currentIsolate.addChild(child);
+    IsolateMutator.addChild(currentIsolate, child);
 }
 function useSetIsolateKey(key, value) {
     if (!key) {
@@ -252,15 +317,13 @@ function BaseReconciler(currentNode, historicNode) {
 }
 class Reconciler {
     static reconcile(reconciler, node, callback) {
-        var _a;
         const parent = useIsolate();
         const historyNode = useHistoryNode();
         let localHistoryNode = historyNode;
         if (parent) {
             // If we have a parent, we need to get the history node from the parent's children
             // We take the history node from the cursor of the active node's children
-            localHistoryNode =
-                (_a = historyNode === null || historyNode === void 0 ? void 0 : historyNode.at(useCurrentCursor())) !== null && _a !== void 0 ? _a : null;
+            localHistoryNode = IsolateInspector.at(historyNode, IsolateInspector.cursor(parent));
         }
         const nextNode = reconciler(node, localHistoryNode);
         invariant(nextNode);
@@ -275,12 +338,13 @@ class Reconciler {
         if (!historyNode || !testIsolate) {
             // This is probably unreachable, but TS is not convinced.
             // Let's play it safe.
+            /* istanbul ignore next */
             return;
         }
-        historyNode.slice(useCurrentCursor());
+        IsolateMutator.slice(historyNode, IsolateInspector.cursor(testIsolate));
     }
     static handleIsolateNodeWithKey(node) {
-        invariant(node.usesKey());
+        invariant(IsolateInspector.usesKey(node));
         const prevNodeByKey = useHistoryKey(node.key);
         let nextNode = node;
         if (!isNullish(prevNodeByKey)) {
@@ -307,77 +371,43 @@ class Isolate {
         this.parent = null;
         this.key = null;
         this.allowReorder = false;
-    }
-    setParent(parent) {
-        this.parent = parent;
-        return this;
-    }
-    saveOutput(output) {
-        this.output = output;
-        return this;
-    }
-    setKey(key) {
-        this.key = key;
-        return this;
-    }
-    usesKey() {
-        return isNotNullish(this.key);
-    }
-    addChild(child) {
-        invariant(this.children);
-        this.children.push(child);
-    }
-    removeChild(node) {
-        var _a, _b;
-        this.children = (_b = (_a = this.children) === null || _a === void 0 ? void 0 : _a.filter(child => child !== node)) !== null && _b !== void 0 ? _b : null;
-    }
-    slice(at) {
-        if (isNullish(this.children)) {
-            return;
-        }
-        this.children.length = at;
-    }
-    at(at) {
-        var _a, _b;
-        return (_b = (_a = this.children) === null || _a === void 0 ? void 0 : _a[at]) !== null && _b !== void 0 ? _b : null;
-    }
-    cursor() {
-        var _a, _b;
-        return (_b = (_a = this.children) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
-    }
-    shouldAllowReorder() {
-        var _a;
-        return (_a = closestExists(this, node => node.allowReorder)) !== null && _a !== void 0 ? _a : false;
-    }
-    get rootNode() {
-        var _a;
-        return (_a = closest(this, node => isNullish(node.parent))) !== null && _a !== void 0 ? _a : this;
+        this.type = 'Isolate';
     }
     static create(callback, data) {
-        return this.createImplementation(callback, data);
-    }
-    static createImplementation(callback, data) {
         const parent = useIsolate();
-        const newCreatedNode = new this(data).setParent(parent);
+        const newCreatedNode = IsolateMutator.setParent(new this(data), parent);
         const [nextIsolateChild, output] = Reconciler.reconcile(this.reconciler, newCreatedNode, callback);
-        nextIsolateChild.saveOutput(output);
-        this.setNode(nextIsolateChild);
+        IsolateMutator.saveOutput(nextIsolateChild, output);
+        addNodeToHistory(nextIsolateChild);
         return nextIsolateChild;
     }
-    static setNode(node) {
-        const parent = useIsolate();
-        if (parent) {
-            useSetNextIsolateChild(node);
-        }
-        else {
-            useSetHistory(node);
-        }
-        node.setParent(parent);
-    }
-    static is(node) {
-        return node instanceof Isolate;
-    }
 }
 Isolate.reconciler = BaseReconciler;
 
-export { Isolate, Reconciler, RuntimeApi as VestRuntime, IsolateWalker as Walker };
+function useBus() {
+    return useX().stateRef.Bus;
+}
+/*
+  Returns an emitter, but it also has a shortcut for emitting an event immediately
+  by passing an event name.
+*/
+function useEmit(event, data) {
+    const emit = useBus().emit;
+    if (!isNullish(event)) {
+        emit(event, data);
+    }
+    return persist(emit);
+}
+function usePrepareEmitter(event) {
+    const emit = useEmit();
+    return (arg) => emit(event, arg);
+}
+
+var Bus = /*#__PURE__*/Object.freeze({
+  __proto__: null,
+  useBus: useBus,
+  useEmit: useEmit,
+  usePrepareEmitter: usePrepareEmitter
+});
+
+export { Bus, Isolate, IsolateInspector, IsolateMutator, Reconciler, RuntimeApi as VestRuntime, IsolateWalker as Walker };

package/dist/es/vestjs-runtime.production.js

@@ -1 +1 @@
-import{isNullish as t,optionalFunctionValue as e,invariant as n,assign as r,tinyState as o,bus as i,deferThrow as u,text as s,isNotNullish as l}from"vest-utils";import{createCascade as c}from"context";function a(n,r,o){if(t(n.children))return;let i=!1;for(const s of n.children){if(i)return;if((t(o)||e(o,s))&&r(s,u),i)return;a(s,((t,e)=>{r(t,(()=>{e(),u()}))}),o)}function u(){i=!0}}function d(t,e,n){let r=!1;return a(t,((t,n)=>{e(t)&&(n(),r=!0)}),n),r}function h(t,e){let n=t;for(;n.parent;){if(e(n))return n;n=n.parent}return null}function f(t,e){return!!h(t,e)}var v,p=Object.freeze({__proto__:null,closest:h,closestExists:f,every:function(t,e,n){let r=!0;return a(t,((t,n)=>{e(t)||(n(),r=!1)}),n),r},find:function(t,e,n){let r=null;return a(t,((t,n)=>{e(t)&&(n(),r=t)}),n),r},has:function(t,e){return d(t,(()=>!0),e)},pluck:function(t,e,n){a(t,(t=>{e(t)&&t.parent&&t.parent.removeChild(t)}),n)},some:d,walk:a});!function(t){t.NO_ACTIVE_ISOLATE="Not within an active isolate",t.ENCOUNTERED_THE_SAME_KEY_TWICE='Encountered the same test key "{key}" twice. This may lead to tests overriding each other\'s results, or to tests being unexpectedly omitted.'}(v||(v={}));const y=c(((t,e)=>{if(e)return null;n(t.historyRoot);const[o]=t.historyRoot(),i={};return r(i,{historyNode:o,runtimeNode:null,runtimeRoot:null,stateRef:t}),i})),m=y.run,E={Run:m,createRef:function(t){return Object.freeze({historyRoot:o.createTinyState(null),Bus:i.createBus(),appData:e(t)})},persist:_,reset:function(){const[,,t]=O();t()},useAvailableRoot:function(){const t=A();if(t)return t;const[e]=O();return e},useBus:N,useCurrentCursor:I,useEmit:R,usePrepareEmitter:function(t){const e=R();return n=>e(t,n)},useXAppData:function(){return k().stateRef.appData}};function N(){return k().stateRef.Bus}function R(){return _(N().emit)}function _(t){const e=y.useX();return(...n)=>{var r;const o=null!==(r=y.use())&&void 0!==r?r:e;return y.run(o.stateRef,(()=>t(...n)))}}function k(){return y.useX()}function O(){return k().stateRef.historyRoot()}function T(){return k().historyNode}function C(){var t;return null!==(t=k().runtimeNode)&&void 0!==t?t:null}function I(){var t,e;return null!==(e=null===(t=C())||void 0===t?void 0:t.cursor())&&void 0!==e?e:0}function A(){return k().runtimeRoot}class w{static reconcile(t,e,r){var o;const i=C(),u=T();let s=u;i&&(s=null!==(o=null==u?void 0:u.at(I()))&&void 0!==o?o:null);const l=t(e,s);return n(l),Object.is(l,e)?[e,b(s,e,r)]:[l,l.output]}static removeAllNextNodesInIsolate(){const t=C(),e=T();e&&t&&e.slice(I())}static handleIsolateNodeWithKey(e){n(e.usesKey());const r=function(e){var n;if(t(e))return null;const r=k().historyNode;return null!==(n=null==r?void 0:r.keys[e])&&void 0!==n?n:null}(e.key);let o=e;return t(r)||(o=r),function(e,r){if(!e)return;const o=C();n(o,v.NO_ACTIVE_ISOLATE),t(o.keys[e])?o.keys[e]=r:u(s(v.ENCOUNTERED_THE_SAME_KEY_TWICE,{key:e}))}(e.key,e),o}}function b(t,e,n){const r=A(),o=m(Object.assign({historyNode:t,runtimeNode:e},!r&&{runtimeRoot:e}),(()=>n(e)));return e.output=o,o}class g{constructor(t){this.children=[],this.keys={},this.parent=null,this.key=null,this.allowReorder=!1}setParent(t){return this.parent=t,this}saveOutput(t){return this.output=t,this}setKey(t){return this.key=t,this}usesKey(){return l(this.key)}addChild(t){n(this.children),this.children.push(t)}removeChild(t){var e,n;this.children=null!==(n=null===(e=this.children)||void 0===e?void 0:e.filter((e=>e!==t)))&&void 0!==n?n:null}slice(e){t(this.children)||(this.children.length=e)}at(t){var e,n;return null!==(n=null===(e=this.children)||void 0===e?void 0:e[t])&&void 0!==n?n:null}cursor(){var t,e;return null!==(e=null===(t=this.children)||void 0===t?void 0:t.length)&&void 0!==e?e:0}shouldAllowReorder(){var t;return null!==(t=f(this,(t=>t.allowReorder)))&&void 0!==t&&t}get rootNode(){var e;return null!==(e=h(this,(e=>t(e.parent))))&&void 0!==e?e:this}static create(t,e){return this.createImplementation(t,e)}static createImplementation(t,e){const n=C(),r=new this(e).setParent(n),[o,i]=w.reconcile(this.reconciler,r,t);return o.saveOutput(i),this.setNode(o),o}static setNode(t){const e=C();e?function(t){const e=C();n(e,v.NO_ACTIVE_ISOLATE),e.addChild(t)}(t):function(t){const[,e]=O();e(t)}(t),t.setParent(e)}static is(t){return t instanceof g}}g.reconciler=function(e,n){return t(n),e};export{g as Isolate,w as Reconciler,E as VestRuntime,p as Walker};
+import{invariant as t,isNullish as e,optionalFunctionValue as n,isNotNullish as r,assign as o,tinyState as u,bus as i,deferThrow as s,text as c}from"vest-utils";import{createCascade as l}from"context";class a{static setParent(t,e){return t.parent=e,t}static saveOutput(t,e){return t.output=e,t}static setKey(t,e){return t.key=e,t}static addChild(e,n){t(e.children),e.children.push(n),a.setParent(n,e)}static removeChild(t,e){var n,r;t.children=null!==(r=null===(n=t.children)||void 0===n?void 0:n.filter((t=>t!==e)))&&void 0!==r?r:null}static slice(t,n){e(t.children)||(t.children.length=n)}}function d(t,r,o){if(e(t.children))return;let u=!1;for(const s of t.children){if(u)return;if((e(o)||n(o,s))&&r(s,i),u)return;d(s,((t,e)=>{r(t,(()=>{e(),i()}))}),o)}function i(){u=!0}}function f(t,e,n){let r=!1;return d(t,((t,n)=>{e(t)&&(n(),r=!0)}),n),r}function h(t,e){let n=t;do{if(e(n))return n;n=n.parent}while(n);return null}function v(t,e){return!!h(t,e)}var y,p=Object.freeze({__proto__:null,closest:h,closestExists:v,every:function(t,e,n){let r=!0;return d(t,((t,n)=>{e(t)||(n(),r=!1)}),n),r},find:function(t,e,n){let r=null;return d(t,((t,n)=>{e(t)&&(n(),r=t)}),n),r},has:function(t,e){return f(t,(()=>!0),e)},pluck:function(t,e,n){d(t,(t=>{e(t)&&t.parent&&a.removeChild(t.parent,t)}),n)},some:f,walk:d});class E{static at(t,n){var r,o;return e(t)?null:null!==(o=null===(r=t.children)||void 0===r?void 0:r[n])&&void 0!==o?o:null}static cursor(t){var n,r;return e(t)?0:null!==(r=null===(n=t.children)||void 0===n?void 0:n.length)&&void 0!==r?r:0}static shouldAllowReorder(t){return!e(t)&&v(t,(t=>t.allowReorder))}static usesKey(t){return!e(t)&&r(t.key)}static dump(t){return e(t)?"":JSON.stringify(t,((t,e)=>{if("parent"!==t)return e}))}}!function(t){t.NO_ACTIVE_ISOLATE="Not within an active isolate",t.ENCOUNTERED_THE_SAME_KEY_TWICE='Encountered the same test key "{key}" twice. This may lead to tests overriding each other\'s results, or to tests being unexpectedly omitted.'}(y||(y={}));const m=l(((e,n)=>{if(n)return null;t(e.historyRoot);const[r]=e.historyRoot(),u={};return o(u,{historyNode:r,runtimeNode:null,runtimeRoot:null,stateRef:e}),u})),_=m.run,R={Run:_,addNodeToHistory:C,createRef:function(t){return Object.freeze({historyRoot:u.createTinyState(null),Bus:i.createBus(),appData:n(t)})},persist:N,reset:function(){const[,,t]=k();t()},useAvailableRoot:function(){const t=I();if(t)return t;const[e]=k();return e},useCurrentCursor:function(){const t=A();return t?E.cursor(t):0},useXAppData:function(){return O().stateRef.appData}};function N(t){const e=m.useX();return(...n)=>{var r;const o=null!==(r=m.use())&&void 0!==r?r:e;return m.run(o.stateRef,(()=>t(...n)))}}function O(){return m.useX()}function k(){return O().stateRef.historyRoot()}function T(){return O().historyNode}function C(e){const n=A();n?function(e){const n=A();t(n,y.NO_ACTIVE_ISOLATE),a.addChild(n,e)}(e):function(t){const[,e]=k();e(t)}(e),a.setParent(e,n)}function A(){var t;return null!==(t=O().runtimeNode)&&void 0!==t?t:null}function I(){return O().runtimeRoot}class w{static reconcile(e,n,r){const o=A(),u=T();let i=u;o&&(i=E.at(u,E.cursor(o)));const s=e(n,i);return t(s),Object.is(s,n)?[n,b(i,n,r)]:[s,s.output]}static removeAllNextNodesInIsolate(){const t=A(),e=T();e&&t&&a.slice(e,E.cursor(t))}static handleIsolateNodeWithKey(n){t(E.usesKey(n));const r=function(t){var n;if(e(t))return null;const r=O().historyNode;return null!==(n=null==r?void 0:r.keys[t])&&void 0!==n?n:null}(n.key);let o=n;return e(r)||(o=r),function(n,r){if(!n)return;const o=A();t(o,y.NO_ACTIVE_ISOLATE),e(o.keys[n])?o.keys[n]=r:s(c(y.ENCOUNTERED_THE_SAME_KEY_TWICE,{key:n}))}(n.key,n),o}}function b(t,e,n){const r=I(),o=_(Object.assign({historyNode:t,runtimeNode:e},!r&&{runtimeRoot:e}),(()=>n(e)));return e.output=o,o}class S{constructor(t){this.children=[],this.keys={},this.parent=null,this.key=null,this.allowReorder=!1,this.type="Isolate"}static create(t,e){const n=A(),r=a.setParent(new this(e),n),[o,u]=w.reconcile(this.reconciler,r,t);return a.saveOutput(o,u),C(o),o}}function g(){return O().stateRef.Bus}function K(t,n){const r=g().emit;return e(t)||r(t,n),N(r)}S.reconciler=function(t,n){return e(n),t};var j=Object.freeze({__proto__:null,useBus:g,useEmit:K,usePrepareEmitter:function(t){const e=K();return n=>e(t,n)}});export{j as Bus,S as Isolate,E as IsolateInspector,a as IsolateMutator,w as Reconciler,R as VestRuntime,p as Walker};

package/dist/umd/vestjs-runtime.development.js

@@ -4,6 +4,37 @@
   (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["vestjs-runtime"] = {}, global["vest-utils"], global.context));
 })(this, (function (exports, vestUtils, context) { 'use strict';
 
+  class IsolateMutator {
+      static setParent(isolate, parent) {
+          isolate.parent = parent;
+          return isolate;
+      }
+      static saveOutput(isolate, output) {
+          isolate.output = output;
+          return isolate;
+      }
+      static setKey(isolate, key) {
+          isolate.key = key;
+          return isolate;
+      }
+      static addChild(isolate, child) {
+          vestUtils.invariant(isolate.children);
+          isolate.children.push(child);
+          IsolateMutator.setParent(child, isolate);
+      }
+      static removeChild(isolate, node) {
+          var _a, _b;
+          isolate.children =
+              (_b = (_a = isolate.children) === null || _a === void 0 ? void 0 : _a.filter(child => child !== node)) !== null && _b !== void 0 ? _b : null;
+      }
+      static slice(isolate, at) {
+          if (vestUtils.isNullish(isolate.children)) {
+              return;
+          }
+          isolate.children.length = at;
+      }
+  }
+
   // eslint-disable-next-line
   function walk(startNode, callback, visitOnly) {
       // If the startNode has no children, there is nothing to walk.
@@ -85,7 +116,7 @@
   function pluck(startNode, predicate, visitOnly) {
       walk(startNode, node => {
           if (predicate(node) && node.parent) {
-              node.parent.removeChild(node);
+              IsolateMutator.removeChild(node.parent, node);
           }
       }, visitOnly);
   }
@@ -93,12 +124,12 @@
   //startNode that satisfies the given predicate function.
   function closest(startNode, predicate) {
       let current = startNode;
-      while (current.parent) {
+      do {
           if (predicate(current)) {
               return current;
           }
           current = current.parent;
-      }
+      } while (current);
       return null;
   }
   // This function returns true if the closest ancestor Isolates of the
@@ -119,6 +150,46 @@
     walk: walk
   });
 
+  class IsolateInspector {
+      static at(isolate, at) {
+          var _a, _b;
+          if (vestUtils.isNullish(isolate)) {
+              return null;
+          }
+          return (_b = (_a = isolate.children) === null || _a === void 0 ? void 0 : _a[at]) !== null && _b !== void 0 ? _b : null;
+      }
+      static cursor(isolate) {
+          var _a, _b;
+          if (vestUtils.isNullish(isolate)) {
+              return 0;
+          }
+          return (_b = (_a = isolate.children) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+      }
+      static shouldAllowReorder(isolate) {
+          if (vestUtils.isNullish(isolate)) {
+              return false;
+          }
+          return closestExists(isolate, node => node.allowReorder);
+      }
+      static usesKey(isolate) {
+          if (vestUtils.isNullish(isolate)) {
+              return false;
+          }
+          return vestUtils.isNotNullish(isolate.key);
+      }
+      static dump(isolate) {
+          if (vestUtils.isNullish(isolate)) {
+              return '';
+          }
+          return JSON.stringify(isolate, (key, value) => {
+              if (key === 'parent') {
+                  return undefined;
+              }
+              return value;
+          });
+      }
+  }
+
   var ErrorStrings;
   (function (ErrorStrings) {
       ErrorStrings["NO_ACTIVE_ISOLATE"] = "Not within an active isolate";
@@ -143,30 +214,14 @@
   const Run = PersistedContext.run;
   const RuntimeApi = {
       Run,
+      addNodeToHistory,
       createRef,
       persist,
       reset,
       useAvailableRoot,
-      useBus,
       useCurrentCursor,
-      useEmit,
-      usePrepareEmitter,
       useXAppData,
   };
-  function useBus() {
-      return useX().stateRef.Bus;
-  }
-  /*
-    Returns an emitter, but it also has a shortcut for emitting an event immediately
-    by passing an event name.
-  */
-  function useEmit() {
-      return persist(useBus().emit);
-  }
-  function usePrepareEmitter(event) {
-      const emit = useEmit();
-      return (arg) => emit(event, arg);
-  }
   function useXAppData() {
       return useX().stateRef.appData;
   }
@@ -194,6 +249,16 @@
   function useHistoryNode() {
       return useX().historyNode;
   }
+  function addNodeToHistory(node) {
+      const parent = useIsolate();
+      if (parent) {
+          useSetNextIsolateChild(node);
+      }
+      else {
+          useSetHistory(node);
+      }
+      IsolateMutator.setParent(node, parent);
+  }
   function useSetHistory(history) {
       const [, setHistoryRoot] = useHistoryRoot();
       setHistoryRoot(history);
@@ -211,8 +276,8 @@
       return (_a = useX().runtimeNode) !== null && _a !== void 0 ? _a : null;
   }
   function useCurrentCursor() {
-      var _a, _b;
-      return (_b = (_a = useIsolate()) === null || _a === void 0 ? void 0 : _a.cursor()) !== null && _b !== void 0 ? _b : 0;
+      const isolate = useIsolate();
+      return isolate ? IsolateInspector.cursor(isolate) : 0;
   }
   function useRuntimeRoot() {
       return useX().runtimeRoot;
@@ -220,7 +285,7 @@
   function useSetNextIsolateChild(child) {
       const currentIsolate = useIsolate();
       vestUtils.invariant(currentIsolate, ErrorStrings.NO_ACTIVE_ISOLATE);
-      currentIsolate.addChild(child);
+      IsolateMutator.addChild(currentIsolate, child);
   }
   function useSetIsolateKey(key, value) {
       if (!key) {
@@ -255,15 +320,13 @@
   }
   class Reconciler {
       static reconcile(reconciler, node, callback) {
-          var _a;
           const parent = useIsolate();
           const historyNode = useHistoryNode();
           let localHistoryNode = historyNode;
           if (parent) {
               // If we have a parent, we need to get the history node from the parent's children
               // We take the history node from the cursor of the active node's children
-              localHistoryNode =
-                  (_a = historyNode === null || historyNode === void 0 ? void 0 : historyNode.at(useCurrentCursor())) !== null && _a !== void 0 ? _a : null;
+              localHistoryNode = IsolateInspector.at(historyNode, IsolateInspector.cursor(parent));
           }
           const nextNode = reconciler(node, localHistoryNode);
           vestUtils.invariant(nextNode);
@@ -278,12 +341,13 @@
           if (!historyNode || !testIsolate) {
               // This is probably unreachable, but TS is not convinced.
               // Let's play it safe.
+              /* istanbul ignore next */
               return;
           }
-          historyNode.slice(useCurrentCursor());
+          IsolateMutator.slice(historyNode, IsolateInspector.cursor(testIsolate));
       }
       static handleIsolateNodeWithKey(node) {
-          vestUtils.invariant(node.usesKey());
+          vestUtils.invariant(IsolateInspector.usesKey(node));
           const prevNodeByKey = useHistoryKey(node.key);
           let nextNode = node;
           if (!vestUtils.isNullish(prevNodeByKey)) {
@@ -310,80 +374,49 @@
           this.parent = null;
           this.key = null;
           this.allowReorder = false;
-      }
-      setParent(parent) {
-          this.parent = parent;
-          return this;
-      }
-      saveOutput(output) {
-          this.output = output;
-          return this;
-      }
-      setKey(key) {
-          this.key = key;
-          return this;
-      }
-      usesKey() {
-          return vestUtils.isNotNullish(this.key);
-      }
-      addChild(child) {
-          vestUtils.invariant(this.children);
-          this.children.push(child);
-      }
-      removeChild(node) {
-          var _a, _b;
-          this.children = (_b = (_a = this.children) === null || _a === void 0 ? void 0 : _a.filter(child => child !== node)) !== null && _b !== void 0 ? _b : null;
-      }
-      slice(at) {
-          if (vestUtils.isNullish(this.children)) {
-              return;
-          }
-          this.children.length = at;
-      }
-      at(at) {
-          var _a, _b;
-          return (_b = (_a = this.children) === null || _a === void 0 ? void 0 : _a[at]) !== null && _b !== void 0 ? _b : null;
-      }
-      cursor() {
-          var _a, _b;
-          return (_b = (_a = this.children) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
-      }
-      shouldAllowReorder() {
-          var _a;
-          return (_a = closestExists(this, node => node.allowReorder)) !== null && _a !== void 0 ? _a : false;
-      }
-      get rootNode() {
-          var _a;
-          return (_a = closest(this, node => vestUtils.isNullish(node.parent))) !== null && _a !== void 0 ? _a : this;
+          this.type = 'Isolate';
       }
       static create(callback, data) {
-          return this.createImplementation(callback, data);
-      }
-      static createImplementation(callback, data) {
           const parent = useIsolate();
-          const newCreatedNode = new this(data).setParent(parent);
+          const newCreatedNode = IsolateMutator.setParent(new this(data), parent);
           const [nextIsolateChild, output] = Reconciler.reconcile(this.reconciler, newCreatedNode, callback);
-          nextIsolateChild.saveOutput(output);
-          this.setNode(nextIsolateChild);
+          IsolateMutator.saveOutput(nextIsolateChild, output);
+          addNodeToHistory(nextIsolateChild);
           return nextIsolateChild;
       }
-      static setNode(node) {
-          const parent = useIsolate();
-          if (parent) {
-              useSetNextIsolateChild(node);
-          }
-          else {
-              useSetHistory(node);
-          }
-          node.setParent(parent);
-      }
-      static is(node) {
-          return node instanceof Isolate;
-      }
   }
   Isolate.reconciler = BaseReconciler;
 
+  function useBus() {
+      return useX().stateRef.Bus;
+  }
+  /*
+    Returns an emitter, but it also has a shortcut for emitting an event immediately
+    by passing an event name.
+  */
+  function useEmit(event, data) {
+      const emit = useBus().emit;
+      if (!vestUtils.isNullish(event)) {
+          emit(event, data);
+      }
+      return persist(emit);
+  }
+  function usePrepareEmitter(event) {
+      const emit = useEmit();
+      return (arg) => emit(event, arg);
+  }
+
+  var Bus = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    useBus: useBus,
+    useEmit: useEmit,
+    usePrepareEmitter: usePrepareEmitter
+  });
+
+  exports.Bus = Bus;
   exports.Isolate = Isolate;
+  exports.IsolateInspector = IsolateInspector;
+  exports.IsolateMutator = IsolateMutator;
   exports.Reconciler = Reconciler;
   exports.VestRuntime = RuntimeApi;
   exports.Walker = IsolateWalker;

package/dist/umd/vestjs-runtime.production.js

@@ -1 +1 @@
-!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("vest-utils"),require("context")):"function"==typeof define&&define.amd?define(["exports","vest-utils","context"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self)["vestjs-runtime"]={},t["vest-utils"],t.context)}(this,(function(t,e,n){"use strict";function i(t,n,r){if(e.isNullish(t.children))return;let o=!1;for(const u of t.children){if(o)return;if((e.isNullish(r)||e.optionalFunctionValue(r,u))&&n(u,s),o)return;i(u,((t,e)=>{n(t,(()=>{e(),s()}))}),r)}function s(){o=!0}}function r(t,e,n){let r=!1;return i(t,((t,n)=>{e(t)&&(n(),r=!0)}),n),r}function o(t,e){let n=t;for(;n.parent;){if(e(n))return n;n=n.parent}return null}function s(t,e){return!!o(t,e)}var u,l=Object.freeze({__proto__:null,closest:o,closestExists:s,every:function(t,e,n){let r=!0;return i(t,((t,n)=>{e(t)||(n(),r=!1)}),n),r},find:function(t,e,n){let r=null;return i(t,((t,n)=>{e(t)&&(n(),r=t)}),n),r},has:function(t,e){return r(t,(()=>!0),e)},pluck:function(t,e,n){i(t,(t=>{e(t)&&t.parent&&t.parent.removeChild(t)}),n)},some:r,walk:i});!function(t){t.NO_ACTIVE_ISOLATE="Not within an active isolate",t.ENCOUNTERED_THE_SAME_KEY_TWICE='Encountered the same test key "{key}" twice. This may lead to tests overriding each other\'s results, or to tests being unexpectedly omitted.'}(u||(u={}));const c=n.createCascade(((t,n)=>{if(n)return null;e.invariant(t.historyRoot);const[i]=t.historyRoot(),r={};return e.assign(r,{historyNode:i,runtimeNode:null,runtimeRoot:null,stateRef:t}),r})),a=c.run,h={Run:a,createRef:function(t){return Object.freeze({historyRoot:e.tinyState.createTinyState(null),Bus:e.bus.createBus(),appData:e.optionalFunctionValue(t)})},persist:v,reset:function(){const[,,t]=y();t()},useAvailableRoot:function(){const t=R();if(t)return t;const[e]=y();return e},useBus:d,useCurrentCursor:E,useEmit:f,usePrepareEmitter:function(t){const e=f();return n=>e(t,n)},useXAppData:function(){return p().stateRef.appData}};function d(){return p().stateRef.Bus}function f(){return v(d().emit)}function v(t){const e=c.useX();return(...n)=>{var i;const r=null!==(i=c.use())&&void 0!==i?i:e;return c.run(r.stateRef,(()=>t(...n)))}}function p(){return c.useX()}function y(){return p().stateRef.historyRoot()}function N(){return p().historyNode}function m(){var t;return null!==(t=p().runtimeNode)&&void 0!==t?t:null}function E(){var t,e;return null!==(e=null===(t=m())||void 0===t?void 0:t.cursor())&&void 0!==e?e:0}function R(){return p().runtimeRoot}class _{static reconcile(t,n,i){var r;const o=m(),s=N();let u=s;o&&(u=null!==(r=null==s?void 0:s.at(E()))&&void 0!==r?r:null);const l=t(n,u);return e.invariant(l),Object.is(l,n)?[n,T(u,n,i)]:[l,l.output]}static removeAllNextNodesInIsolate(){const t=m(),e=N();e&&t&&e.slice(E())}static handleIsolateNodeWithKey(t){e.invariant(t.usesKey());const n=function(t){var n;if(e.isNullish(t))return null;const i=p().historyNode;return null!==(n=null==i?void 0:i.keys[t])&&void 0!==n?n:null}(t.key);let i=t;return e.isNullish(n)||(i=n),function(t,n){if(!t)return;const i=m();e.invariant(i,u.NO_ACTIVE_ISOLATE),e.isNullish(i.keys[t])?i.keys[t]=n:e.deferThrow(e.text(u.ENCOUNTERED_THE_SAME_KEY_TWICE,{key:t}))}(t.key,t),i}}function T(t,e,n){const i=R(),r=a(Object.assign({historyNode:t,runtimeNode:e},!i&&{runtimeRoot:e}),(()=>n(e)));return e.output=r,r}class k{constructor(t){this.children=[],this.keys={},this.parent=null,this.key=null,this.allowReorder=!1}setParent(t){return this.parent=t,this}saveOutput(t){return this.output=t,this}setKey(t){return this.key=t,this}usesKey(){return e.isNotNullish(this.key)}addChild(t){e.invariant(this.children),this.children.push(t)}removeChild(t){var e,n;this.children=null!==(n=null===(e=this.children)||void 0===e?void 0:e.filter((e=>e!==t)))&&void 0!==n?n:null}slice(t){e.isNullish(this.children)||(this.children.length=t)}at(t){var e,n;return null!==(n=null===(e=this.children)||void 0===e?void 0:e[t])&&void 0!==n?n:null}cursor(){var t,e;return null!==(e=null===(t=this.children)||void 0===t?void 0:t.length)&&void 0!==e?e:0}shouldAllowReorder(){var t;return null!==(t=s(this,(t=>t.allowReorder)))&&void 0!==t&&t}get rootNode(){var t;return null!==(t=o(this,(t=>e.isNullish(t.parent))))&&void 0!==t?t:this}static create(t,e){return this.createImplementation(t,e)}static createImplementation(t,e){const n=m(),i=new this(e).setParent(n),[r,o]=_.reconcile(this.reconciler,i,t);return r.saveOutput(o),this.setNode(r),r}static setNode(t){const n=m();n?function(t){const n=m();e.invariant(n,u.NO_ACTIVE_ISOLATE),n.addChild(t)}(t):function(t){const[,e]=y();e(t)}(t),t.setParent(n)}static is(t){return t instanceof k}}k.reconciler=function(t,n){return e.isNullish(n),t},t.Isolate=k,t.Reconciler=_,t.VestRuntime=h,t.Walker=l}));
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports,require("vest-utils"),require("context")):"function"==typeof define&&define.amd?define(["exports","vest-utils","context"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self)["vestjs-runtime"]={},t["vest-utils"],t.context)}(this,(function(t,e,n){"use strict";class r{static setParent(t,e){return t.parent=e,t}static saveOutput(t,e){return t.output=e,t}static setKey(t,e){return t.key=e,t}static addChild(t,n){e.invariant(t.children),t.children.push(n),r.setParent(n,t)}static removeChild(t,e){var n,r;t.children=null!==(r=null===(n=t.children)||void 0===n?void 0:n.filter((t=>t!==e)))&&void 0!==r?r:null}static slice(t,n){e.isNullish(t.children)||(t.children.length=n)}}function i(t,n,r){if(e.isNullish(t.children))return;let s=!1;for(const o of t.children){if(s)return;if((e.isNullish(r)||e.optionalFunctionValue(r,o))&&n(o,u),s)return;i(o,((t,e)=>{n(t,(()=>{e(),u()}))}),r)}function u(){s=!0}}function s(t,e,n){let r=!1;return i(t,((t,n)=>{e(t)&&(n(),r=!0)}),n),r}function u(t,e){let n=t;do{if(e(n))return n;n=n.parent}while(n);return null}function o(t,e){return!!u(t,e)}var l,c=Object.freeze({__proto__:null,closest:u,closestExists:o,every:function(t,e,n){let r=!0;return i(t,((t,n)=>{e(t)||(n(),r=!1)}),n),r},find:function(t,e,n){let r=null;return i(t,((t,n)=>{e(t)&&(n(),r=t)}),n),r},has:function(t,e){return s(t,(()=>!0),e)},pluck:function(t,e,n){i(t,(t=>{e(t)&&t.parent&&r.removeChild(t.parent,t)}),n)},some:s,walk:i});class a{static at(t,n){var r,i;return e.isNullish(t)?null:null!==(i=null===(r=t.children)||void 0===r?void 0:r[n])&&void 0!==i?i:null}static cursor(t){var n,r;return e.isNullish(t)?0:null!==(r=null===(n=t.children)||void 0===n?void 0:n.length)&&void 0!==r?r:0}static shouldAllowReorder(t){return!e.isNullish(t)&&o(t,(t=>t.allowReorder))}static usesKey(t){return!e.isNullish(t)&&e.isNotNullish(t.key)}static dump(t){return e.isNullish(t)?"":JSON.stringify(t,((t,e)=>{if("parent"!==t)return e}))}}!function(t){t.NO_ACTIVE_ISOLATE="Not within an active isolate",t.ENCOUNTERED_THE_SAME_KEY_TWICE='Encountered the same test key "{key}" twice. This may lead to tests overriding each other\'s results, or to tests being unexpectedly omitted.'}(l||(l={}));const d=n.createCascade(((t,n)=>{if(n)return null;e.invariant(t.historyRoot);const[r]=t.historyRoot(),i={};return e.assign(i,{historyNode:r,runtimeNode:null,runtimeRoot:null,stateRef:t}),i})),f=d.run,h={Run:f,addNodeToHistory:E,createRef:function(t){return Object.freeze({historyRoot:e.tinyState.createTinyState(null),Bus:e.bus.createBus(),appData:e.optionalFunctionValue(t)})},persist:v,reset:function(){const[,,t]=y();t()},useAvailableRoot:function(){const t=_();if(t)return t;const[e]=y();return e},useCurrentCursor:function(){const t=R();return t?a.cursor(t):0},useXAppData:function(){return p().stateRef.appData}};function v(t){const e=d.useX();return(...n)=>{var r;const i=null!==(r=d.use())&&void 0!==r?r:e;return d.run(i.stateRef,(()=>t(...n)))}}function p(){return d.useX()}function y(){return p().stateRef.historyRoot()}function N(){return p().historyNode}function E(t){const n=R();n?function(t){const n=R();e.invariant(n,l.NO_ACTIVE_ISOLATE),r.addChild(n,t)}(t):function(t){const[,e]=y();e(t)}(t),r.setParent(t,n)}function R(){var t;return null!==(t=p().runtimeNode)&&void 0!==t?t:null}function _(){return p().runtimeRoot}class m{static reconcile(t,n,r){const i=R(),s=N();let u=s;i&&(u=a.at(s,a.cursor(i)));const o=t(n,u);return e.invariant(o),Object.is(o,n)?[n,T(u,n,r)]:[o,o.output]}static removeAllNextNodesInIsolate(){const t=R(),e=N();e&&t&&r.slice(e,a.cursor(t))}static handleIsolateNodeWithKey(t){e.invariant(a.usesKey(t));const n=function(t){var n;if(e.isNullish(t))return null;const r=p().historyNode;return null!==(n=null==r?void 0:r.keys[t])&&void 0!==n?n:null}(t.key);let r=t;return e.isNullish(n)||(r=n),function(t,n){if(!t)return;const r=R();e.invariant(r,l.NO_ACTIVE_ISOLATE),e.isNullish(r.keys[t])?r.keys[t]=n:e.deferThrow(e.text(l.ENCOUNTERED_THE_SAME_KEY_TWICE,{key:t}))}(t.key,t),r}}function T(t,e,n){const r=_(),i=f(Object.assign({historyNode:t,runtimeNode:e},!r&&{runtimeRoot:e}),(()=>n(e)));return e.output=i,i}class I{constructor(t){this.children=[],this.keys={},this.parent=null,this.key=null,this.allowReorder=!1,this.type="Isolate"}static create(t,e){const n=R(),i=r.setParent(new this(e),n),[s,u]=m.reconcile(this.reconciler,i,t);return r.saveOutput(s,u),E(s),s}}function O(){return p().stateRef.Bus}function k(t,n){const r=O().emit;return e.isNullish(t)||r(t,n),v(r)}I.reconciler=function(t,n){return e.isNullish(n),t};var C=Object.freeze({__proto__:null,useBus:O,useEmit:k,usePrepareEmitter:function(t){const e=k();return n=>e(t,n)}});t.Bus=C,t.Isolate=I,t.IsolateInspector=a,t.IsolateMutator=r,t.Reconciler=m,t.VestRuntime=h,t.Walker=c}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vestjs-runtime",
-  "version": "0.1.0-dev-ae6b14",
+  "version": "0.1.0-next-cc6009",
   "description": "Internal runtime module used by Vest",
   "license": "MIT",
   "author": "ealush",
@@ -18,8 +18,8 @@
     "url": "https://github.com/ealush/vest.git/issues"
   },
   "dependencies": {
-    "context": "3.0.9-dev-ae6b14",
-    "vest-utils": "1.0.0-dev-ae6b14"
+    "context": "3.0.9-next-cc6009",
+    "vest-utils": "1.0.0-next-cc6009"
   },
   "exports": {
     ".": {
@@ -44,5 +44,6 @@
     },
     "./package.json": "./package.json",
     "./*": "./*"
-  }
+  },
+  "vxAllowResolve": []
 }

package/types/vestjs-runtime.d.ts

@@ -1,81 +1,61 @@
-import { CB, TinyState, BusType } from "vest-utils";
-interface IRecociler {
-    (currentNode: Isolate, historicNode: Isolate | null): Isolate;
+import { CB, Nullable, TinyState, BusType, DynamicValue } from "vest-utils";
+// I would rather not use `any` here, but instead use `Isolate`.
+// The problem is that it breaks the actual implementation of `Isolate` in `IsolateTest`
+// As it is not properly extending `Isolate`.
+interface IRecociler<I = any> {
+    (currentNode: I, historicNode: Nullable<Isolate>): I;
 }
 declare class Reconciler {
-    static reconcile<Callback extends CB = CB>(reconciler: IRecociler, node: Isolate, callback: Callback): [
+    static reconcile<Callback extends CB = CB>(reconciler: IRecociler<Isolate>, node: Isolate, callback: Callback): [
         Isolate,
         ReturnType<Callback>
     ];
     static removeAllNextNodesInIsolate(): void;
     static handleIsolateNodeWithKey(node: Isolate): Isolate;
 }
-type IsolateKey = null | string;
+type IsolateKey = Nullable<string>;
 declare class Isolate<_D = any> {
-    children: Isolate[] | null;
+    children: Nullable<Isolate[]>;
     keys: Record<string, Isolate>;
-    parent: Isolate | null;
-    output?: any;
+    parent: Nullable<Isolate>;
+    output: any;
     key: IsolateKey;
     allowReorder: boolean;
-    static reconciler: IRecociler;
+    type: string;
     // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-empty-function
     constructor(_data?: _D);
-    setParent(parent: Isolate | null): this;
-    saveOutput(output: any): this;
-    setKey(key: string | null): this;
-    usesKey(): boolean;
-    addChild(child: Isolate): void;
-    removeChild(node: Isolate): void;
-    slice(at: number): void;
-    at(at: number): Isolate | null;
-    cursor(): number;
-    shouldAllowReorder(): boolean;
-    get rootNode(): Isolate;
+    static reconciler: IRecociler;
     static create<Callback extends CB = CB>(callback: Callback, data?: any): Isolate;
-    private static createImplementation;
-    static setNode(node: Isolate): void;
-    static is(node: any): boolean;
 }
 declare namespace Walker {
-    interface IRecociler {
-        (currentNode: Isolate, historicNode: Isolate | null): Isolate;
+    // I would rather not use `any` here, but instead use `Isolate`.
+    // The problem is that it breaks the actual implementation of `Isolate` in `IsolateTest`
+    // As it is not properly extending `Isolate`.
+    interface IRecociler<I = any> {
+        (currentNode: I, historicNode: Nullable<Isolate>): I;
     }
-    function BaseReconciler(currentNode: Isolate, historicNode: Isolate | null): Isolate;
+    function BaseReconciler(currentNode: Isolate, historicNode: Nullable<Isolate>): Isolate;
     class Reconciler {
-        static reconcile<Callback extends CB = CB>(reconciler: IRecociler, node: Isolate, callback: Callback): [
+        static reconcile<Callback extends CB = CB>(reconciler: IRecociler<Isolate>, node: Isolate, callback: Callback): [
             Isolate,
             ReturnType<Callback>
         ];
         static removeAllNextNodesInIsolate(): void;
         static handleIsolateNodeWithKey(node: Isolate): Isolate;
     }
-    type IsolateKey = null | string;
+    type IsolateKey = Nullable<string>;
     class Isolate<_D = any> {
-        children: Isolate[] | null;
+        children: Nullable<Isolate[]>;
         keys: Record<string, Isolate>;
-        parent: Isolate | null;
-        output?: any;
+        parent: Nullable<Isolate>;
+        output: any;
         key: IsolateKey;
         allowReorder: boolean;
-        static reconciler: IRecociler;
+        type: string;
         // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-empty-function
         constructor(_data?: _D);
-        setParent(parent: Isolate | null): this;
-        saveOutput(output: any): this;
-        setKey(key: string | null): this;
-        usesKey(): boolean;
-        addChild(child: Isolate): void;
-        removeChild(node: Isolate): void;
-        slice(at: number): void;
-        at(at: number): Isolate | null;
-        cursor(): number;
-        shouldAllowReorder(): boolean;
-        get rootNode(): Isolate;
+        static reconciler: IRecociler;
         static create<Callback extends CB = CB>(callback: Callback, data?: any): Isolate;
-        private static createImplementation;
-        static setNode(node: Isolate): void;
-        static is(node: any): boolean;
     }
     type VisitOnlyPredicate = (isolate: Isolate) => boolean;
     // eslint-disable-next-line
@@ -88,7 +68,7 @@ declare namespace Walker {
     function has(startNode: Isolate, match: VisitOnlyPredicate): boolean;
     // This function returns the first Isolate object in the tree that satisfies the given predicate function.
     // If visitOnly is provided, only Isolate objects that satisfy the predicate are visited.
-    function find(startNode: Isolate, predicate: (node: Isolate) => boolean, visitOnly?: VisitOnlyPredicate): Isolate | null;
+    function find(startNode: Isolate, predicate: (node: Isolate) => boolean, visitOnly?: VisitOnlyPredicate): Nullable<Isolate>;
     // This function returns true if the given predicate function returns true for every Isolate object in the tree.
     // If visitOnly is provided, only Isolate objects that satisfy the predicate are visited.
     function every(startNode: Isolate, predicate: (node: Isolate) => boolean, visitOnly?: VisitOnlyPredicate): boolean;
@@ -98,46 +78,62 @@ declare namespace Walker {
     function pluck(startNode: Isolate, predicate: (node: Isolate) => boolean, visitOnly?: VisitOnlyPredicate): void;
     // Returns the closest ancestor Isolate object of the given
     //startNode that satisfies the given predicate function.
-    function closest(startNode: Isolate, predicate: (node: Isolate) => boolean): Isolate | null;
+    function closest(startNode: Isolate, predicate: (node: Isolate) => boolean): Nullable<Isolate>;
     // This function returns true if the closest ancestor Isolates of the
     // given startNode that satisfies the given predicate function exists.
     function closestExists(startNode: Isolate, predicate: (node: Isolate) => boolean): boolean;
 }
 type CTXType = StateRefType & {
-    historyNode: Isolate | null;
-    runtimeNode: Isolate | null;
-    runtimeRoot: Isolate | null;
+    historyNode: Nullable<Isolate>;
+    runtimeNode: Nullable<Isolate>;
+    runtimeRoot: Nullable<Isolate>;
     stateRef: StateRefType;
 };
 type StateRefType = {
-    historyRoot: TinyState<Isolate | null>;
+    historyRoot: TinyState<Nullable<Isolate>>;
     Bus: BusType;
     appData: Record<string, any>;
 };
 declare const RuntimeApi: {
     Run: <R>(value: Partial<CTXType>, fn: () => R) => R;
+    addNodeToHistory: typeof addNodeToHistory;
     createRef: typeof createRef;
     persist: typeof persist;
     reset: typeof reset;
     useAvailableRoot: typeof useAvailableRoot;
-    useBus: typeof useBus;
     useCurrentCursor: typeof useCurrentCursor;
-    useEmit: typeof useEmit;
-    usePrepareEmitter: typeof usePrepareEmitter;
     useXAppData: typeof useXAppData;
 };
-declare function useBus(): BusType;
-/*
-Returns an emitter, but it also has a shortcut for emitting an event immediately
-by passing an event name.
-*/
-declare function useEmit(): (event: string, ...args: any[]) => void;
-declare function usePrepareEmitter<T = void>(event: string): (arg: T) => void;
 declare function useXAppData<T = object>(): T;
-declare function createRef(setter: Record<string, any> | (() => Record<string, any>)): StateRefType;
-declare function persist<T extends CB>(cb: T): T;
+declare function createRef(setter: DynamicValue<Record<string, any>>): StateRefType;
+declare function persist<T extends (...args: any[]) => any>(cb: T): T;
+declare function addNodeToHistory(node: Isolate): void;
 declare function useCurrentCursor(): number;
 declare function useAvailableRoot<I extends Isolate = Isolate>(): I;
 declare function reset(): void;
-export { Isolate, IsolateKey, Reconciler, IRecociler, Walker, RuntimeApi as VestRuntime };
+declare class IsolateInspector {
+    static at(isolate: Nullable<Isolate>, at: number): Nullable<Isolate>;
+    static cursor(isolate: Nullable<Isolate>): number;
+    static shouldAllowReorder(isolate: Nullable<Isolate>): boolean;
+    static usesKey(isolate: Nullable<Isolate>): boolean;
+    static dump(isolate: Isolate): string;
+}
+declare class IsolateMutator {
+    static setParent(isolate: Isolate, parent: Nullable<Isolate>): Isolate;
+    static saveOutput(isolate: Isolate, output: any): Isolate;
+    static setKey(isolate: Isolate, key: Nullable<string>): Isolate;
+    static addChild(isolate: Isolate, child: Isolate): void;
+    static removeChild(isolate: Isolate, node: Isolate): void;
+    static slice(isolate: Isolate, at: number): void;
+}
+declare namespace Bus {
+    function useBus(): import("vest-utils").BusType;
+    /*
+    Returns an emitter, but it also has a shortcut for emitting an event immediately
+    by passing an event name.
+    */
+    function useEmit(event?: string, data?: any): (event: string, data?: any) => void;
+    function usePrepareEmitter<T = void>(event: string): (arg: T) => void;
+}
+export { IsolateKey, Isolate, Reconciler, IRecociler, Walker, RuntimeApi as VestRuntime, IsolateInspector, IsolateMutator, Bus };
 //# sourceMappingURL=vestjs-runtime.d.ts.map

package/types/vestjs-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vestjs-runtime.d.ts","sourceRoot":"","sources":["../src/vestjs-runtime.ts","../src/IsolateWalker.ts","../src/errors/ErrorStrings.ts","../src/VestRuntime.ts","../src/Reconciler.ts","../src/Isolate.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,kFAAuB,CAAgB"}
+{"version":3,"file":"vestjs-runtime.d.ts","sourceRoot":"","sources":["../src/vestjs-runtime.ts","../src/Isolate/IsolateMutator.ts","../src/IsolateWalker.ts","../src/Isolate/IsolateInspector.ts","../src/errors/ErrorStrings.ts","../src/VestRuntime.ts","../src/Reconciler.ts","../src/Isolate/Isolate.ts","../src/Bus.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,yHAAuB,CAAgB"}