@casual-simulation/aux-common 3.1.8 → 3.1.9-alpha.3340590989

package/runtime/AuxLibrary.js

@@ -38,12 +38,32 @@ import SeedRandom from 'seedrandom';
 import { DateTime } from 'luxon';
 import * as hooks from 'preact/hooks';
 import { render } from 'preact';
+import { isGenerator, UNCOPIABLE, unwind, } from '@casual-simulation/js-interpreter/InterpreterUtils';
+import { INTERPRETABLE_FUNCTION } from './AuxCompiler';
 const _html = htm.bind(h);
 const html = ((...args) => {
     return _html(...args);
 });
 html.h = h;
 html.f = Fragment;
+/**
+ * Creates a new interpretable function based on the given function.
+ * @param interpretableFunc
+ */
+export function createInterpretableFunction(interpretableFunc) {
+    const normalFunc = ((...args) => unwind(interpretableFunc(...args)));
+    normalFunc[INTERPRETABLE_FUNCTION] = interpretableFunc;
+    return normalFunc;
+}
+/**
+ * Sets the INTERPRETABLE_FUNCTION property on the given object (semantically a function) to the given interpretable version and returns the object.
+ * @param interpretableFunc The version of the function that should be used as the interpretable version of the function.
+ * @param normalFunc The function that should be tagged.
+ */
+export function tagAsInterpretableFunction(interpretableFunc, normalFunc) {
+    normalFunc[INTERPRETABLE_FUNCTION] = interpretableFunc;
+    return normalFunc;
+}
 /**
  * The status codes that should be used to retry web requests.
  */
@@ -139,9 +159,25 @@ export function createDefaultLibrary(context) {
     };
     const webhookFunc = makeMockableFunction(webhook, 'webhook');
     webhookFunc.post = makeMockableFunction(webhook.post, 'webhook.post');
-    const shoutImpl = shout;
+    const shoutImpl = ((name, arg) => unwind(shout(name, arg)));
     const shoutProxy = new Proxy(shoutImpl, {
         get(target, name, reciever) {
+            if (typeof name === 'symbol' ||
+                (typeof target === 'function' && name in Function.prototype)) {
+                return Reflect.get(target, name, reciever);
+            }
+            return (arg) => {
+                return unwind(shout(name, arg));
+            };
+        },
+    });
+    const interpretableShoutImpl = shout;
+    const interpretableShoutProxy = new Proxy(interpretableShoutImpl, {
+        get(target, name, reciever) {
+            if (typeof name === 'symbol' ||
+                (typeof target === 'function' && name in Function.prototype)) {
+                return Reflect.get(target, name, reciever);
+            }
             return (arg) => {
                 return shout(name, arg);
             };
@@ -173,8 +209,8 @@ export function createDefaultLibrary(context) {
             renameTag,
             applyMod,
             subtractMods,
-            destroy,
-            changeState,
+            destroy: createInterpretableFunction(destroy),
+            changeState: createInterpretableFunction(changeState),
             getLink: createBotLinkApi,
             getBotLinks,
             updateBotLinks,
@@ -185,9 +221,9 @@ export function createDefaultLibrary(context) {
             Quaternion,
             Rotation,
             superShout,
-            priorityShout,
-            shout: shoutProxy,
-            whisper,
+            priorityShout: createInterpretableFunction(priorityShout),
+            shout: tagAsInterpretableFunction(interpretableShoutProxy, shoutProxy),
+            whisper: createInterpretableFunction(whisper),
             byTag,
             byID,
             byMod,
@@ -219,6 +255,7 @@ export function createDefaultLibrary(context) {
             expect,
             html,
             os: {
+                [UNCOPIABLE]: true,
                 sleep,
                 toast,
                 tip,
@@ -566,7 +603,7 @@ export function createDefaultLibrary(context) {
             },
         },
         tagSpecificApi: {
-            create: (options) => (...args) => { var _a; return create((_a = options.bot) === null || _a === void 0 ? void 0 : _a.id, ...args); },
+            create: tagAsInterpretableFunction((options) => (...args) => { var _a; return create((_a = options.bot) === null || _a === void 0 ? void 0 : _a.id, ...args); }, (options) => (...args) => { var _a; return unwind(create((_a = options.bot) === null || _a === void 0 ? void 0 : _a.id, ...args)); }),
             setTimeout: botTimer('timeout', setTimeout, true),
             setInterval: botTimer('interval', setInterval, false),
             watchPortal: watchPortalBots(),
@@ -578,19 +615,26 @@ export function createDefaultLibrary(context) {
             if (!options.bot) {
                 throw new Error(`Timers are not supported when there is no current bot.`);
             }
+            if (typeof handler !== 'function') {
+                throw new Error('A handler function must be provided.');
+            }
             let timer;
             if (clearAfterHandlerIsRun) {
                 timer = func(function () {
+                    let result;
                     try {
-                        handler(...arguments);
+                        result = handler(...arguments);
                     }
                     finally {
                         context.removeBotTimer(options.bot.id, type, timer);
                     }
+                    context.processBotTimerResult(result);
                 }, timeout, ...args);
             }
             else {
-                timer = func(handler, timeout, ...args);
+                timer = func(function () {
+                    context.processBotTimerResult(handler(...arguments));
+                }, timeout, ...args);
             }
             context.recordBotTimer(options.bot.id, {
                 timerId: timer,
@@ -609,12 +653,21 @@ export function createDefaultLibrary(context) {
         let timerId = 0;
         return (options) => function (portalId, handler) {
             let id = timerId++;
+            const finalHandler = () => {
+                try {
+                    let result = handler();
+                    return wrapGenerator(result);
+                }
+                catch (err) {
+                    context.enqueueError(err);
+                }
+            };
             context.recordBotTimer(options.bot.id, {
                 type: 'watch_portal',
                 timerId: id,
                 portalId,
                 tag: options.tag,
-                handler,
+                handler: finalHandler,
             });
             return id;
         };
@@ -628,7 +681,8 @@ export function createDefaultLibrary(context) {
                 : [getID(bot)];
             const finalHandler = () => {
                 try {
-                    return handler();
+                    let result = handler();
+                    return wrapGenerator(result);
                 }
                 catch (err) {
                     context.enqueueError(err);
@@ -646,6 +700,76 @@ export function createDefaultLibrary(context) {
             return id;
         };
     }
+    function wrapGenerator(result) {
+        if (isGenerator(result)) {
+            const gen = result;
+            let valid = true;
+            const generatorWrapper = {
+                [Symbol.iterator]: () => generatorWrapper,
+                next(value) {
+                    if (!valid) {
+                        return {
+                            done: true,
+                            value: undefined,
+                        };
+                    }
+                    try {
+                        return gen.next(value);
+                    }
+                    catch (err) {
+                        valid = false;
+                        context.enqueueError(err);
+                        return {
+                            done: true,
+                            value: undefined,
+                        };
+                    }
+                },
+                return(value) {
+                    if (!valid) {
+                        return {
+                            done: true,
+                            value: undefined,
+                        };
+                    }
+                    try {
+                        return gen.return(value);
+                    }
+                    catch (err) {
+                        valid = false;
+                        context.enqueueError(err);
+                        return {
+                            done: true,
+                            value: undefined,
+                        };
+                    }
+                },
+                throw(e) {
+                    if (!valid) {
+                        return {
+                            done: true,
+                            value: undefined,
+                        };
+                    }
+                    try {
+                        return gen.throw(e);
+                    }
+                    catch (err) {
+                        valid = false;
+                        context.enqueueError(err);
+                        return {
+                            done: true,
+                            value: undefined,
+                        };
+                    }
+                },
+            };
+            return generatorWrapper;
+        }
+        else {
+            return result;
+        }
+    }
     function clearWatchBot(id) {
         context.cancelAndRemoveTimers(id, 'watch_bot');
     }
@@ -5101,15 +5225,15 @@ export function createDefaultLibrary(context) {
     function create(botId, ...mods) {
         return createBase(botId, () => context.uuid(), ...mods);
     }
-    function createBase(botId, idFactory, ...datas) {
+    function* createBase(botId, idFactory, ...datas) {
         let parentDiff = botId ? { creator: botId } : {};
-        return createFromMods(idFactory, parentDiff, ...datas);
+        return yield* createFromMods(idFactory, parentDiff, ...datas);
     }
     /**
      * Creates a new bot that contains the given tags.
      * @param mods The mods that specify what tags to set on the bot.
      */
-    function createFromMods(idFactory, ...mods) {
+    function* createFromMods(idFactory, ...mods) {
         let variants = new Array(1);
         variants[0] = [];
         for (let i = 0; i < mods.length; i++) {
@@ -5180,9 +5304,9 @@ export function createDefaultLibrary(context) {
         for (let i = 0; i < bots.length; i++) {
             ret[i] = context.createBot(bots[i]);
         }
-        event(CREATE_ACTION_NAME, ret);
+        yield* event(CREATE_ACTION_NAME, ret);
         for (let bot of ret) {
-            event(CREATE_ANY_ACTION_NAME, null, {
+            yield* event(CREATE_ANY_ACTION_NAME, null, {
                 bot: bot,
             });
         }
@@ -5197,19 +5321,21 @@ export function createDefaultLibrary(context) {
      * Destroys the given bot, bot ID, or list of bots.
      * @param bot The bot, bot ID, or list of bots to destroy.
      */
-    function destroy(bot) {
+    function* destroy(bot) {
         if (typeof bot === 'object' && Array.isArray(bot)) {
-            bot.forEach((f) => destroyBot(f));
+            for (let b of bot) {
+                yield* destroyBot(b);
+            }
         }
         else {
-            destroyBot(bot);
+            yield* destroyBot(bot);
         }
     }
     /**
      * Removes the given bot or bot ID from the simulation.
      * @param bot The bot or bot ID to remove from the simulation.
      */
-    function destroyBot(bot) {
+    function* destroyBot(bot) {
         let realBot;
         let id;
         if (!hasValue(bot)) {
@@ -5247,15 +5373,15 @@ export function createDefaultLibrary(context) {
             return;
         }
         if (id) {
-            event(DESTROY_ACTION_NAME, [id]);
+            yield* event(DESTROY_ACTION_NAME, [id]);
             context.destroyBot(realBot);
         }
-        destroyChildren(id);
+        yield* destroyChildren(id);
     }
-    function destroyChildren(id) {
+    function* destroyChildren(id) {
         const children = getBots(byTag('creator', createBotLink([id])));
         for (let child of children) {
-            destroyBot(child);
+            yield* destroyBot(child);
         }
     }
     /**
@@ -5264,7 +5390,7 @@ export function createDefaultLibrary(context) {
      * @param stateName The state that the bot should move to.
      * @param groupName The group of states that the bot's state should change in. (Defaults to "state")
      */
-    function changeState(bot, stateName, groupName = 'state') {
+    function* changeState(bot, stateName, groupName = 'state') {
         const previousState = getTag(bot, groupName);
         if (previousState === stateName) {
             return;
@@ -5275,9 +5401,9 @@ export function createDefaultLibrary(context) {
             from: previousState,
         };
         if (hasValue(previousState)) {
-            whisper(bot, `${groupName}${previousState}OnExit`, arg);
+            yield* whisper(bot, `${groupName}${previousState}OnExit`, arg);
         }
-        whisper(bot, `${groupName}${stateName}OnEnter`, arg);
+        yield* whisper(bot, `${groupName}${stateName}OnEnter`, arg);
     }
     /**
      * Creates a tag value that can be used to link to the given bots.
@@ -5403,9 +5529,9 @@ export function createDefaultLibrary(context) {
      * @param eventNames The names of the events to shout.
      * @param arg The argument to shout.
      */
-    function priorityShout(eventNames, arg) {
+    function* priorityShout(eventNames, arg) {
         for (let name of eventNames) {
-            let results = event(name, null, arg, undefined, true);
+            let results = yield* event(name, null, arg, undefined, true);
             if (results.hasResult) {
                 return results[results.length - 1];
             }
@@ -5432,11 +5558,11 @@ export function createDefaultLibrary(context) {
      * // Tell every bot say "Hi" to you.
      * shout("sayHi()", "My Name");
      */
-    function shout(name, arg) {
+    function* shout(name, arg) {
         if (!hasValue(name) || typeof name !== 'string') {
             throw new Error('shout() name must be a string.');
         }
-        return event(name, null, arg);
+        return yield* event(name, null, arg);
     }
     /**
      * Asks the given bots to run the given action.
@@ -5459,7 +5585,7 @@ export function createDefaultLibrary(context) {
      * // Tell every friendly bot to say "Hi" to you.
      * whisper(getBots("friendly", true), "sayHi()", "My Name");
      */
-    function whisper(bot, eventName, arg) {
+    function* whisper(bot, eventName, arg) {
         if (!hasValue(eventName) || typeof eventName !== 'string') {
             throw new Error('whisper() eventName must be a string.');
         }
@@ -5473,7 +5599,7 @@ export function createDefaultLibrary(context) {
         else {
             return [];
         }
-        return event(eventName, bots, arg);
+        return yield* event(eventName, bots, arg);
     }
     /**
      * Gets whether the player is in the sheet dimension.
@@ -5683,7 +5809,7 @@ export function createDefaultLibrary(context) {
      * @param sort Whether to sort the Bots before processing. Defaults to true.
      * @param shortCircuit Whether to stop processing bots when one returns a value.
      */
-    function event(name, bots, arg, sendListenEvents = true, shortCircuit = false) {
+    function* event(name, bots, arg, sendListenEvents = true, shortCircuit = false) {
         const startTime = globalThis.performance.now();
         let tag = trimEvent(name);
         let ids = !!bots
@@ -5723,7 +5849,16 @@ export function createDefaultLibrary(context) {
                     __energyCheck();
                 }
                 try {
-                    const result = listener(arg);
+                    let result;
+                    if (INTERPRETABLE_FUNCTION in listener) {
+                        result = yield* listener[INTERPRETABLE_FUNCTION](arg);
+                    }
+                    else {
+                        result = listener(arg);
+                    }
+                    if (isGenerator(result)) {
+                        result = yield* result;
+                    }
                     if (result instanceof Promise) {
                         result.catch((ex) => {
                             context.enqueueError(ex);
@@ -5752,8 +5887,8 @@ export function createDefaultLibrary(context) {
                 targets,
                 listeners,
             };
-            event('onListen', listeners, listenArg, false);
-            event('onAnyListen', null, listenArg, false);
+            yield* event('onListen', listeners, listenArg, false);
+            yield* event('onAnyListen', null, listenArg, false);
         }
         if (shortCircuit && stop) {
             results.hasResult = true;