@casual-simulation/aux-common 3.0.0 → 3.0.1

package/runtime/AuxLibrary.js

@@ -11,7 +11,7 @@ import { DEBUG_STRING, debugStringifyFunction, } from './AuxGlobalContext';
 import { hasValue, trimTag, isBot, BOT_SPACE_TAG, toast as toastMessage, showJoinCode as calcShowJoinCode, requestFullscreen, exitFullscreen, html as htmlMessage, hideHtml as hideHtmlMessage, setClipboard as calcSetClipboard, tweenTo as calcTweenTo, showChat as calcShowChat, hideChat as calcHideChat, runScript, getMediaPermission as calcGetMediaPermission, enableAR as calcEnableAR, disableAR as calcDisableAR, enableVR as calcEnableVR, disableVR as calcDisableVR, arSupported as calcARSupported, vrSupported as calcVRSupported, showUploadAuxFile as calcShowUploadAuxFile, openQRCodeScanner as calcOpenQRCodeScanner, showQRCode as calcShowQRCode, openBarcodeScanner as calcOpenBarcodeScanner, showBarcode as calcShowBarcode, importAUX as calcImportAUX, showInputForTag as calcShowInputForTag, showInput as calcShowInput, replaceDragBot as calcReplaceDragBot, goToDimension as calcGoToDimension, goToURL as calcGoToURL, openURL as calcOpenURL, checkout as calcCheckout, playSound as calcPlaySound, bufferSound as calcBufferSound, cancelSound as calcCancelSound, setupServer as calcSetupServer, shell as calcShell, backupToGithub as calcBackupToGithub, backupAsDownload as calcBackupAsDownload, finishCheckout as calcFinishCheckout, markHistory as calcMarkHistory, browseHistory as calcBrowseHistory, restoreHistoryMark as calcRestoreHistoryMark, loadFile as calcLoadFile, saveFile as calcSaveFile, reject as calcReject, localFormAnimation as calcLocalFormAnimation, webhook as calcWebhook, superShout as calcSuperShout, share as calcShare, registerPrefix as calcRegisterPrefix, createCertificate as calcCreateCertificate, signTag as calcSignTag, revokeCertificate as calcRevokeCertificate, localPositionTween as calcLocalPositionTween, localRotationTween as calcLocalRotationTween, showUploadFiles as calcShowUploadFiles, download, loadSimulation, unloadSimulation, getUploadState, addState, getPortalTag, KNOWN_PORTALS, openConsole, tagsOnBot, getOriginalObject, getBotSpace, trimEvent, CREATE_ACTION_NAME, CREATE_ANY_ACTION_NAME, DESTROY_ACTION_NAME, ORIGINAL_OBJECT, unlockSpace, getRemoteCount, getServers, getRemotes, action, getServerStatuses, setSpacePassword, exportGpioPin, unexportGpioPin, setGpioPin, getGpioPin, rpioInitPin, rpioExitPin, rpioOpenPin, rpioModePin, rpioReadPin, rpioReadSequencePin, rpioWritePin, rpioWriteSequencePin, rpioReadpadPin, rpioWritepadPin, rpioPudPin, rpioPollPin, rpioClosePin, rpioI2CBeginPin, rpioI2CSetSlaveAddressPin, rpioI2CSetBaudRatePin, rpioI2CSetClockDividerPin, rpioI2CReadPin, rpioI2CWritePin, 
 // rpioI2CReadRegisterRestartPin,
 // rpioI2CWriteReadRestartPin,
-rpioI2CEndPin, rpioPWMSetClockDividerPin, rpioPWMSetRangePin, rpioPWMSetDataPin, rpioSPIBeginPin, rpioSPIChipSelectPin, rpioSPISetCSPolarityPin, rpioSPISetClockDividerPin, rpioSPISetDataModePin, rpioSPITransferPin, rpioSPIWritePin, rpioSPIEndPin, serialConnectPin, serialOpenPin, serialStreamPin, serialUpdatePin, serialWritePin, serialReadPin, serialClosePin, serialFlushPin, serialDrainPin, serialPausePin, serialResumePin, calculateAnchorPoint, calculateAnchorPointOffset, getBotPosition as calcGetBotPosition, isRuntimeBot, SET_TAG_MASK_SYMBOL, CLEAR_TAG_MASKS_SYMBOL, getBotScale, EDIT_TAG_SYMBOL, EDIT_TAG_MASK_SYMBOL, circleWipe, addDropSnap as calcAddDropSnap, animateToPosition, beginAudioRecording as calcBeginAudioRecording, endAudioRecording as calcEndAudioRecording, beginRecording as calcBeginRecording, endRecording as calcEndRecording, speakText as calcSpeakText, getVoices as calcGetVoices, getGeolocation as calcGetGeolocation, cancelAnimation, disablePOV, enablePOV, enableCustomDragging as calcEnableCustomDragging, MINI_PORTAL, registerCustomApp, setAppOutput, unregisterCustomApp, requestAuthData as calcRequestAuthData, createBot, defineGlobalBot as calcDefineGlobalBot, TEMPORARY_BOT_PARTITION_ID, convertToString, GET_TAG_MASKS_SYMBOL, isBotLink, parseBotLink, createBotLink, convertGeolocationToWhat3Words as calcConvertGeolocationToWhat3Words, getPublicRecordKey as calcGetPublicRecordKey, recordData as calcRecordData, getRecordData, eraseRecordData, recordFile as calcRecordFile, eraseFile as calcEraseFile, meetCommand as calcMeetCommand, listDataRecord, recordEvent as calcRecordEvent, getEventCount as calcGetEventCount, openImageClassifier as calcOpenImageClassifier, } from '../bots';
+rpioI2CEndPin, rpioPWMSetClockDividerPin, rpioPWMSetRangePin, rpioPWMSetDataPin, rpioSPIBeginPin, rpioSPIChipSelectPin, rpioSPISetCSPolarityPin, rpioSPISetClockDividerPin, rpioSPISetDataModePin, rpioSPITransferPin, rpioSPIWritePin, rpioSPIEndPin, serialConnectPin, serialOpenPin, serialStreamPin, serialUpdatePin, serialWritePin, serialReadPin, serialClosePin, serialFlushPin, serialDrainPin, serialPausePin, serialResumePin, calculateAnchorPoint, calculateAnchorPointOffset, getBotPosition as calcGetBotPosition, isRuntimeBot, SET_TAG_MASK_SYMBOL, CLEAR_TAG_MASKS_SYMBOL, getBotScale, EDIT_TAG_SYMBOL, EDIT_TAG_MASK_SYMBOL, circleWipe, addDropSnap as calcAddDropSnap, animateToPosition, beginAudioRecording as calcBeginAudioRecording, endAudioRecording as calcEndAudioRecording, beginRecording as calcBeginRecording, endRecording as calcEndRecording, speakText as calcSpeakText, getVoices as calcGetVoices, getGeolocation as calcGetGeolocation, cancelAnimation, disablePOV, enablePOV, enableCustomDragging as calcEnableCustomDragging, MINI_PORTAL, registerCustomApp, setAppOutput, unregisterCustomApp, requestAuthData as calcRequestAuthData, createBot, defineGlobalBot as calcDefineGlobalBot, TEMPORARY_BOT_PARTITION_ID, convertToString, GET_TAG_MASKS_SYMBOL, isBotLink, parseBotLink, createBotLink, convertGeolocationToWhat3Words as calcConvertGeolocationToWhat3Words, getPublicRecordKey as calcGetPublicRecordKey, recordData as calcRecordData, getRecordData, eraseRecordData, recordFile as calcRecordFile, eraseFile as calcEraseFile, meetCommand as calcMeetCommand, listDataRecord, recordEvent as calcRecordEvent, getEventCount as calcGetEventCount, openImageClassifier as calcOpenImageClassifier, isBotDate, DATE_TAG_PREFIX, parseBotDate, } from '../bots';
 import { sortBy, every, cloneDeep, union, isEqual, flatMap } from 'lodash';
 import { remote as calcRemote, } from '@casual-simulation/causal-trees';
 import { RanOutOfEnergyError } from './AuxResults';
@@ -33,6 +33,8 @@ import htm from 'htm';
 import { fromByteArray, toByteArray } from 'base64-js';
 import expect, { iterableEquality } from '@casual-simulation/expect';
 import { parseRecordKey, isRecordKey as calcIsRecordKey, } from '@casual-simulation/aux-records';
+import SeedRandom from 'seedrandom';
+import { DateTime } from 'luxon';
 const _html = htm.bind(h);
 const html = ((...args) => {
     return _html(...args);
@@ -169,6 +171,8 @@ export function createDefaultLibrary(context) {
             getLink: createBotLinkApi,
             getBotLinks,
             updateBotLinks,
+            getDateTime,
+            DateTime,
             superShout,
             priorityShout,
             shout: shoutProxy,
@@ -424,6 +428,8 @@ export function createDefaultLibrary(context) {
                 sqrt,
                 abs,
                 stdDev,
+                getSeededRandomNumberGenerator,
+                setRandomSeed,
                 randomInt,
                 random,
                 getForwardDirection,
@@ -3567,21 +3573,49 @@ export function createDefaultLibrary(context) {
         let standardMean = avg(numbersMinusMean);
         return sqrt(standardMean);
     }
+    /**
+     * Creates a new random number generator and returns it.
+     * @param seed The value that should be used to seed the random number generator.
+     */
+    function getSeededRandomNumberGenerator(seed) {
+        if (hasValue(seed)) {
+            let s = typeof seed !== 'string' ? seed.toString() : seed;
+            return _wrapPrng(seed, SeedRandom(s));
+        }
+        return _wrapPrng(null, SeedRandom());
+    }
+    function _wrapPrng(seed, prng) {
+        return {
+            seed: seed,
+            random(min, max) {
+                return randomBase(min, max, prng);
+            },
+            randomInt(min, max) {
+                return randomIntBase(min, max, prng);
+            },
+        };
+    }
+    /**
+     * Sets the seed that should be used for random numbers.
+     * @param seed The seed that should be used. If given null, then the numbers will be unseeded.
+     */
+    function setRandomSeed(seed) {
+        if (!hasValue(seed)) {
+            context.pseudoRandomNumberGenerator = null;
+            return;
+        }
+        if (typeof seed !== 'string') {
+            seed = seed.toString();
+        }
+        context.pseudoRandomNumberGenerator = SeedRandom(seed);
+    }
     /**
      * Generates a random integer number between min and max.
      * @param min The smallest allowed value.
      * @param max The largest allowed value.
      */
     function randomInt(min = 0, max) {
-        min = Math.ceil(min);
-        max = Math.floor(max);
-        const rand = Math.random();
-        if (max) {
-            return Math.floor(rand * (max - min)) + min;
-        }
-        else {
-            return Math.floor(rand) + min;
-        }
+        return randomIntBase(min, max, context.pseudoRandomNumberGenerator);
     }
     /**
      * Generates a random number between min and max.
@@ -3589,7 +3623,10 @@ export function createDefaultLibrary(context) {
      * @param max The largest allowed value.
      */
     function random(min = 0, max) {
-        const rand = Math.random();
+        return randomBase(min, max, context.pseudoRandomNumberGenerator);
+    }
+    function randomBase(min = 0, max, prng) {
+        const rand = _random(prng);
         if (max) {
             return rand * (max - min) + min;
         }
@@ -3597,6 +3634,23 @@ export function createDefaultLibrary(context) {
             return rand + min;
         }
     }
+    function randomIntBase(min, max, prng) {
+        min = Math.ceil(min);
+        max = Math.floor(max);
+        const rand = _random(prng);
+        if (max) {
+            return Math.floor(rand * (max - min)) + min;
+        }
+        else {
+            return Math.floor(rand) + min;
+        }
+    }
+    function _random(prng) {
+        if (prng) {
+            return prng();
+        }
+        return Math.random();
+    }
     /**
      * Gets the forward direction for the given rotation.
      * @param pointerRotation The rotation that the pointer has represented in radians.
@@ -4697,6 +4751,28 @@ export function createDefaultLibrary(context) {
             }
         }
     }
+    /**
+     * Parses the given value into a date time object.
+     * Returns null if the value could not be parsed into a date time.
+     * @param value The value to parse.
+     */
+    function getDateTime(value) {
+        if (typeof value === 'string') {
+            if (!isBotDate(value)) {
+                value = DATE_TAG_PREFIX + value;
+            }
+            return parseBotDate(value);
+        }
+        else if (value instanceof DateTime) {
+            return value;
+        }
+        else if (value instanceof Date) {
+            return DateTime.fromJSDate(value);
+        }
+        else {
+            return null;
+        }
+    }
     /**
      * Shouts the given event to every bot in every loaded simulation.
      * @param eventName The name of the event to shout.