@casual-simulation/aux-custom-portals - npm Package Versions

V1.5.10

Date: 4/8/2021

:boom: Breaking Changes

• Renamed onStreamData to onSerialData.
• Serial functions now require a "friendly" name to keep track of each device: serialConnect, serialStream, serialOpen, serialUpdate, serialWrite, serialRead, serialClose, serialFlush,serialDrain, serialPause, serialResume
• serialStream now requires a bot id to send the stream to that bot.

:rocket: Improvements

• Improved the IDE Portal to support showing all tags by setting the idePortal tag on the config bot to true.
• Added a search tab to the IDE Portal which makes it easy to search within tags that are loaded in the IDE Portal.
  • It can be focused from the idePortal by using the Ctrl+Shift+F hotkey.
• Added the sheetPortalAddedTags tag for the sheetPortalBot which specifies additional tags that should always be shown in the sheet portal.
• Added support for auxcli v2.0.0 to retain current functionality.
• Added support for multiple serial connections simultaneously.

:bug: Bug Fixes

• Fixed an issue where the url tag would not be created on initial load unless the URL was updated.

V1.5.9

Date: 4/7/2021

:rocket: Improvements

• Added the ability to jump to a tag while in the IDE Portal using Ctrl+P.

:bug: Bug Fixes

• Fixed an issue where the imuPortal would return values that were incorrect for usage on the camera.
  • Now, the imuPortal sets the deviceRotationX, deviceRotationY, deviceRotationZ and deviceRotationW values which is the rotation of the device represented as a quaternion.
  • The pagePortal also now supports setting cameraRotationOffsetW to indicate that the offset should be applied as a quaternion.
  • Try the imuExample01 auxCode for an example.
• Fixed an issue where CasualOS would fail to load on browsers that do not support speech synthesis.
• Fixed an issue where bot updates that were executed via action.perform() would be treated like they were being performed by the user themselves.
  • In particular, this issue affected text edits which were originally created by the multiline text editor but were then replayed via action.perform().
  • The effect of this bug would be that while the data was updated correctly, the multiline text editor would ignore the new data because it assumed it already had the changes.

V1.5.7

Date: 4/2/2021

:rocket: Improvements

• Improved imuPortal to support Safari on iOS.
• Added the crypto.isEncrypted(cyphertext), crypto.asymmetric.isEncrypted(cyphertext), and crypto.asymmetric.isKeypair(keypair) functions.
  • These can help in determining if a string is supposed to be a asymmetric keypair or if it has been encrypted with symmetric or asymmetric encryption.

:bug: Bug Fixes

• Fixed an issue where the configBot would appear to be in the shared space but was actually in the tempLocal space.

V1.5.6

Date: 4/1/2021

:rocket: Improvements

• Added the "bots" snap target for os.addDropSnap() and os.addBotDropSnap().
  • This will cause the dragged bot to snap to other bots.
• Added the experiment.speakText(text, options?) and experiment.getVoices() functions.
  • See the documentation for more information.
• Added the os.getGeolocation() function.
  • Returns a promise that resolves with the geolocation of the device.
• Added the imuPortal to be able to stream IMU data into CasualOS.
  • When defined on the config bot, the imuPortalBot will be updated with IMU data from the device.
  • The following tags are used:
    • imuSupported - Whether reading from the IMU is supported. This will be shortly after the imuPortal is defined.
    • deviceRotationX, deviceRotationY, deviceRotationZ - The X, Y, and Z values that represent the orientation of the device.
• Added the portalCameraType tag to allow switching between perspective and orthographic projections.
  • Camera projections act similarly to real world camera lenses except that they avoid certain limitations like focal lengths.
  • orthographic - This projection preserves parallel lines from the 3D scene in the output 2D image. As a result, same-sized objects appear the same size on the screen, regardless of how far away they are from the camera.
  • perspective - This projection makes same-sized objects appear larger or smaller based on how far away they are from the camera. Closer objects appear larger and vice versa.
• Added the os.enablePointOfView(center?) and os.disablePointOfView() functions.
  • These are similar to os.enableVR() or os.enableAR() and can be used to give the player a "ground level" perspective in the page portal.
  • os.enablePointOfView(center?) - Enables POV mode by moving the camera to the given position, setting the camera type to perspective, and changing the controls so that it is only possible to rotate the camera.
  • os.disablePointOfView() - Disables POV mode by resetting the camera, camera type, and controls.

:bug: Bug Fixes

• Fixed an issue where tag edits would appear duplicated when running CasualOS in the non-collaborative mode.

V1.5.5

Date: 3/25/2021

:rocket: Improvements

• Changed CasualOS to not show the server URL parameter when loaded in non-collaborative mode.
• CasualOS will now throw an error when trying to save a bot to a tag during creation.

V1.5.4

Date: 3/25/2021

:rocket: Improvements

• Improved os.download() to add the correct file extension if one is omitted from the given filename.
• Added the 📖 emoji has a builtin tag prefix.
  • This is a useful default prefix for custom portals.
• Added the ability to load CasualOS in a non-collaborative mode.
  • This will make the shared spaces (shared, tempShared, and remoteTempShared) act like they are tempLocal spaces.
  • As a result, CasualOS needs no persistent network connection to run an experience when loaded in this mode.
• Added the os.isCollaborative() function to get whether CasualOS was loaded in a collaborative mode or non-collaborative mode.

:bug: Bug Fixes

• Fixed the "Docs" link when linking to a listen tag.

V1.5.3

Date: 3/23/2021

:boom: Breaking Changes

• Removed bot stacking.
  • Bots will no longer automatically stack on each other based on position. Instead, they need to be stacked manually.
  • The {dimension}SortOrder tags still exist and are used by the menu portal to order bots.
• Drag events are now sent for bots that are not draggable.
  • This means you can set #draggable to false and still get a @onDrag or @onAnyBotDrag event for it.
  • This change makes it easier to write your own custom dragging logic because it prevents the bot(s) from being automatically moved but still sends the correct events.
  • If you don't want drag events sent to a bot, you can make it not pointable or you can use your own custom logic on @onDrag/@onDrop.
• The #draggableMode and #positioningMode tags have been removed.
  • #draggableMode can be emulated by setting #draggable to false and adding custom @onDrag events to limit which dimensions the bot can be moved to.
  • #positioningMode has been replaced with the os.addDropSnap() and os.addBotDropSnap() functions.

:rocket: Improvements

• Added the @onAnyBotDropEnter and @onAnyBotDropExit shouts.
• Added the @onAnyBotPointerDown and @onAnyBotPointerUp shouts.
• Added the os.addDropSnap(...targets) and os.addBotDropSnap(bot, ...targets) functions.
  • These can be used to customize the behavior of a drag operation.
  • Each function accepts one or more "targets" which are positions that the bot can be dropped at. There are 4 possible values:
    • "ground" - The bot will snap to the ground as it is being dragged. (Default when not in VR)
    • "grid" - The bot will snap to individual grid tiles as it is being dragged.
    • "face" - The bot will snap to the face of other bots as it is being dragged.
    • A snap point object. The bot will snap to the point when the mouse is within a specified distance. It should be an object with the following properties:
      • position - An object with x, y, and z values representing the world position of the snap point.
      • distance - The distance that the pointer ray should be from the position in order to trigger snapping to the position.
  • The os.addBotDropSnap(bot, ...targets) function accepts a bot as its first parameter which limits the specified snap targets to when the given bot is being dropped on.
• Added the experiment.beginRecording(options?) and experiment.endRecording() functions.
  • These can be used to record both audio and video at the same time.
  • See the documentation for more details.

:bug: Bug Fixes

• Fixed an issue where dragging a parent bot onto a child bot would cause the bot to rapidly snap back and forth.
• Fixed an issue where negative sort orders could not be used on menu bots.

V1.5.19

Date: 5/13/2021

:rocket: Improvements

• Added the labelPaddingX and labelPaddingY tags to allow controlling the padding along the width and height of labels separately.
• Added the ability to use a URL for the cursor and portalCursor tags.
• Added the cursorHotspotX, cursorHotspotY, portalCursorHotspotX, and portalCursorHotspotY tags to allow specifying the location that clicks should happen at in the custom cursor image. For example, a cursor that is a circle would have the hotspot in the middle but the default cursor has the hotspot at the top left.