@casual-simulation/aux-common - npm Package Versions

V0.7.5

Date: 05/21/2019

Changes:

• Improvements
  • Tag compression to the table for tags with 3 or more similar starting sections(The series of characters before the first period in the tag).
  • Made switching contexts in AUX Player via player.goToContext() fast by not triggering a page reload.
  • Forced each channel in AUX Player to display the same context as the primary context.
  • Added in ability to drag a block out of the sheet's ID value.
  • Added the diff.create(file, ...tags) function.
    • This creates a diff that takes the specified tags from the given file.
    • Tags can be strings or regex.
    • The result can be used in applyDiff() or in create().
    • Example:
      • diff.create(this, /aux\..+/, 'fun')
      • Creates a new diff that copies all the aux.* and fun tags.
  • Added the player.currentContext() function.
    • This returns the context that is currently loaded into AUX Player.
  • Added the onPlayerContextEnter() event.
    • This is triggered whenever AUX Player loads or changes a context.
    • The that variable is an object containing the following properties:
      • context - the context that was loaded.
  • Added convenience functions for accessing the first and last elements on an array.
    • array.first() will get the first element.
    • array.last() will get the last element.
• Changes
  • Changed the @ and # formula expressions to always return a list of values.
    • The values will always be sorted by the ID of the file that it came from.
      • For @ expressions this means that the files will be sorted by ID.
      • For # expressions this means that the values will be sorted by which file they came from.
    • Because of this change, users should now use the .first() function to get the first file returned from a query.
• Bug Fixes
  • Fixed the wording when adding and removing channels.

V0.7.0

Date: 05/20/2019

Changes:

• Improvements
  • Search bar will now always remain across the top of builder.
  • Made the aux.context.grid tag not use objects for hex heights.
  • Made auxplayer.com/channel load AUX Builder and auxplayer.com/channel/context load AUX Player.
  • Added onConnected() and onDisconnected() events to notify scripts when the user becomes connected for disconnected from the server.
  • Added player.isConnected() to help formulas easily determine if the player is currently connected.
    • Works by checking the aux.connected tag on the user's file.
• Bug Fixes
  • Allow for the expansion and shrinking of hexes after they have been raised or lowered.
  • Clicking on the diff bursh in builder will now make the sheets appear correctly.
  • Selecting the file ID in builder will now no longer change the zoom that sent the camera too far away.
  • Upon shrinking the hex grid, hexes will now remain if a file is on top of it.
  • Clicking on a non centeral hex did not show correct raise and lower options, now it does.
  • Fixed an issue that would cause a formula to error if evaluating an array which referenced a non-existant tag.
    • In the test scenario, this made it appear as if some blocks were able to be moved through and other blocks were not.
    • In reality, the filter was breaking before it was able to evaluate the correct block.
    • This is why re-creating a file sometimes worked - because the new file might have a lower file ID which would cause it to be evaluated before the broken file was checked.
  • Fixed an issue that would cause the formula recursion counter to trigger in non-recursive scenarios.

V0.6.5

Date: 05/10/2019

• Improvements
  • Added aux.iframe tag that allows you to embed HTML pages inside an AUX.
    • Related iframe tags:
      • aux.iframe: URL of the page to embed
      • aux.iframe.x: X local position
      • aux.iframe.y: Y local position
      • aux.iframe.z: Z local position
      • aux.iframe.size.x: Width of the iframe plane geometry
      • aux.iframe.size.y: Height of the iframe plane geometry
      • aux.iframe.rotation.x: X local rotation
      • aux.iframe.rotation.y: Y local rotation
      • aux.iframe.rotation.z: Z local rotation
      • aux.iframe.element.width: The pixel width of the iframe DOM element
      • aux.iframe.scale: The uniform scale of the iframe plane geometry

V0.6.2

Date: 05/09/2019

Changes:

• Improvements
  • Allow users to determine which side of the file they have clicked on by using that.face variable on an onClick tag.
  • Removed aux.pickupable and replaced it with special values for aux.movable.
    • Setting aux.movable to true means it can be moved anywhere.
    • Setting aux.movable to false means it cannot be moved.
    • Setting aux.movable to clone means that dragging it will create a clone that can be placed anywhere.
    • Setting aux.movable to pickup means it can be moved into any other context but not moved within the context it is currently in (only applies to AUX Player).
    • Setting aux.movable to drag means it can be moved anywhere within the context it is currently in but not moved to another context. (only applies to AUX Player).
  • Added the ability to destroy files from the file sheet.
  • Added the ability to display a QR Code from formula actions.
    • Use showQRCode(data) and hideQRCode() from formula actions.
  • Added the ability to create a new empty file from the file sheet.
    • Doing so will automatically select the new file and kick the user into multi-select mode.
  • Added the ability to whitelist or blacklist users by using aux.whitelist and aux.blacklist.
    • For example, setting aux.whitelist to Kal will ensure that only users named Kal can access the session.
    • Similarly, setting aux.blacklist to Kal will ensure that users named Kal cannot access the session.
    • In the case of a name being listed in both, the whitelist wins.
• Bug Fixes
  • Fixed an issue where long tapping on a file would register as a click on mobile.
  • Dragging a minimized workspace will no longer change its z value for depth, only its x and y.

V0.6.0

Date: 05/07/2019

Changes:

• Improvements

  • Added an aux.progressBar tag that generates a progressbar above the file, this tag can be set to any value form 0 to 1.
    • This new tag also has additionally: aux.progressBar.color and aux.progressBar.backgroundColor to color the progressbar's components.
    • This tag also has: aux.progressBar.anchor to set the facing direction of the progress bar relative to the file.
  • Added aux.pickupable to control whether files can be placed into the inventory in the player or not, will be true (able to be put in inventory) by default.
    • If aux.pickupable is true but aux.movable is false, the file can still be dragged into the inventory without moving the file position. It can also be dragged out of the inventory by setting the file position only until is is placed, then not allowing position changes again as aux.movable is still false.
  • Added the ability to load additional channels into an AUX Player channel.
    • Channels can be loaded from any reachable instance of AUX Server. (auxplayer.com, a boobox, etc.)
    • To add a channel to your AUX Player, simply open the hamburger menu and click "Add Channel".
      • Enter in the ID of the channel you want to load.
      • There are several options:
        • A URL (https://auxplayer.com/channel/context)
        • A remote context ID (auxplayer.com/channel/context)
        • A local context ID (channel/context)
        • A local channel ID (channel)
    • To remove a channel, open the hamburger menu and click on the one you want to remove.
    • Channels can also be loaded by putting them in the query string of the URL.
      • This is done by adding a parameter named channels set to the ID of the channel that you want to load.
      • For example, channels=abc/test will load the abc/test channel.
      • As a result, the URL ends up looking something like this https://auxplayer.com/channel/context?channels=abc/test&channels=other/channel.
      • Note that you can only add channels this way. You must go to the hamburger menu to remove a channel.
        • Sharing URLs will cause all the channels you have loaded to show up for someone else but it won't remove any channels they already have loaded.
    • Added several new formula functions:
      • superShout(event, arg) performs a shout that goes to every loaded channel. This is the only way for channels to communicate with each other.
      • player.loadChannel(id) loads the channel with the given ID.
      • player.unloadChannel(id) unloads the channel with the given ID.
    • Additionally, the following events are always sent to every channel:
      • onQRCodeScannerOpened()
      • onQRCodeScannerClosed()
      • onQRCodeScanned()
      • onTapCode()
    • How it works
      • Channels are loaded by creating files in the user's "simulation context".
        • You can get the user's simulation context by using player.getFile().aux._userSimulationsContext.
      • AUX Player looks for these files and checks if they have a aux.channel tag.
        • For files that do, then the aux.channel tag value is used as a channel ID and then AUX Player loads it for each file.
        • Files that don't are ignored.
      • Note that because we have multiple channels loaded there are multiple user files and global files.
        • This is fine because channels cannot lookup files that other channels have.
        • Because of this, a user also has multiple simulation contexts.
        • This works out though, because we merge all the simulation contexts and remove duplicate channels.
        • When player.unloadChannel(id) is called, we only remove simulation files that are in the channel that the script is running in.
        • As a result, if another channel has called player.loadChannel(id) with the same ID the channel will remain loaded because at least one channel has requested that it be loaded.
  • Added in a tween for the zoom that fires once a file has been focused on, it will tween to file position then zoom to the set zoom value.
  • Added whisper(file, event, argument) formula function that sends shouts to a single file.
  • Added a aux.version tag to the globals file which will be used to help determine when breaking changes in the AUX file format occur.
  • Added the ability to copy and paste file selections in AUX Builder.
    • Pressing Ctrl+C or Cmd+C will cause the currently selected files to be copied to the user's clipboard.
    • Pressing Ctrl+V or Cmd+V will cause the currently selected files to be pasted into the world where the user's cursor is.
    • Does not interfere with normal copy/paste operations like copying/pasting in input boxes.
    • If a worksurface is included in the user's selection the new worksurface will be duplicated from it.
      • This allows you to do things like copy the context color.
      • Any files that are being copied from the old worksurface to the new one will also maintain their positions.
  • Added the ability to copy worksurfaces AUX Builder using the new "Copy" option in the context menu.
    • Using the Ctrl+V keybinding after copying the worksurface will paste a duplicate worksurface with duplicates of all the files that were on the surface.
  • Added the ability to drag .aux files into AUX Builder.
    • This will upload them just like the upload option in the hamburger menu.
  • Added player.hasFileInInventory(file) formula function that determines if the given file or list of files are in the current player's inventory.
    • As a part of this change, it is now possible to use the other user-related functions in formulas.
  • Moved the handlePointerEnter and handlePointerExit function logic to only work in PlayerInteractionManager.
  • Added the handlePointerDown to PlayerInteractionManager so down events in general can be collected on the player.
  • Clicking on the Raise and Lower options on the workspace dropdown will now effect the entrire workspace if it has been expanded.

V0.5.4

Date: 04/29/2019

Changes:

• Improvements
  • Changed AUX Player's default background color to match the dark background color that AUX Builder uses.
  • Changed the globals file to look like a normal file when created and be labeled as "Global".
  • Updated all the formula functions to use the new naming scheme.
  • Added the ability to drag worksurfaces when they are minimized.
    • Setting aux.context.movable to false will prevent this behavior.
  • Selecting an item in the inventory no longer shows a selection indicator.
• Bug Fixes
  • The inventory placeholders should now always appear square.
  • Dragging an item out of the inventory will now always remove the image of that item in the inventory.

V0.5.2

Date: 04/26/2019

Changes:

• Improvements
  • Set builder's default background color to dark gray. Player remains the light blue.
  • Changed the onDragAny/onDropAny actions to be onAnyDrag/onAnyDrop.
  • formula-lib.ts has changed isPlayerInContext export to player.isInContext.
  • formula-lib.ts has changed makeDiff export to diff.
  • Made the mini file dots much smaller.
  • Added the ability to show and hide a QR Code Scanner using the openQRCodeScanner() and closeQRCodeScanner() functions.
    • Upon scanning a QR Code the onQRCodeScanned() event is triggered with the that variable bound to the scanned QR code.
    • The onQRCodeScannerOpened() event is triggered whenever the QR Code Scanner is opened.
    • The onQRCodeScannerClosed() event is triggered whenever the QR Code Scanner is closed.
  • Moved the file sheet to the right side of the screen.
• Bug Fixes
  • Fixed an issue with trying to load a WebP version of the "add tag" icon in Safari.
    • Safari doesn't support WebP - so we instead have to load it as a PNG.
  • Fixed the proxy to return the original content type of images to Safari.
    • Because Safari doesn't support WebP we can't automatically optimize the images.

V0.5.1

Date: 04/25/2019

Changes:

• Improvements
  • Automatically log in the user as a guest if they attempt to got to as context without being logged in.
• Bug Fixes
  • Stopped a new Guest's username from saying guest_### upon logging into a new guest account for the first time.
  • Fixed highlighting issues when dragging files around.
  • Totally removed the AUX Player toolbar so that it doesn't get in the way of input events. (Was previously just transparent)
  • Fixed an issue with files not responding to height changes on a hex when the config file wasn't in the same context.

V0.5.0

Date: 04/25/2019

Changes:

• Improvements
  • Restricted onCombine feature to only fire in aux-player and restrict it from happening on aux-builder.
  • Removed the clone() function.
  • Improved the create() function to be able to accept lists of diffs/files.
    • This allows you to quickly create every combination of a set of diffs.
    • For example, create(this, [ { hello: true }, { hello: false } ]) will create two files. One with #hello: true and one with #hello: false.
    • More complicated scenarios can be created as well:
      • create(this, [ { row: 1 }, { row: 2 } ], [ { column: 1 }, { column: 2 } ]) will create four files for every possible combination between row: 1|2 and column: 1|2.
      • create(this, { 'aux.color': 'red' }, [ makeDiff.addToContext('context_1'), makeDiff.addToContext('context_2') ]) will create two files that are both red but are on different contexts.
      • create(this, @aux.color('red'), { 'aux.color': 'green' }) will find every file that is red, duplicate them, and set the new files' colors to green.
  • Improved how we position files to prevent two files from appearing at the same index.
    • Creating new files at the same position will now automatically stack them.
    • Stacking is determined first by the index and second by the file ID.
  • Added a zoom property to the tweenPlayerTo function to set a consistent zoom on file focus.
  • Moved the worksurface context menu options to files mode.
  • Moved the channel name to the hamburger menu and added the QR Code to the menu as well.
  • Worksurface improvements
    • Removed the header in AUX Player so that only the hamburger menu is shown.
    • Removed the option to enter into worksurfaces mode.
      • If users are already in worksurfaces mode then they can still exit.
    • Removed the ability to snap or drag worksurfaces.
    • Removed the ability to change the worksurface color.
  • Removed the change background color context menu.
  • Made the globals file generate as a worksurface.
  • File Sheet/Search improvements
    • Removed the edit icon and replaced it with a search icon at the top right of the top bar.
    • Added the ability to save a .aux file from the current selection/search.
    • Moved the "+tag" button to the left side of the panel and added an icon for it.
    • Added another "Add Tag" button to the bottom of the tags list.
    • Added the ability to show the list of selected file IDs in the search bar.
• Bug Fixes
  • Stopped sheet closing bug from taking multiple clicks to reopen.

V0.4.15

Date: 04/22/2019

Changes:

• Improvements

  • Added a basic proxy to the server so that external web requests can be cached for offline use.
    • Only works when the app is served over HTTPS.
    • Uses service workers to redirect external requests to the server which can then download and cache the resources.
      • Shouldn't be a security/privacy issue because all cookies and headers are stripped from the client requests.
      • As a result this prevents users from adding resources which require the use of cookies for authorization.
      • A nice side-effect is that it also helps prevent advertisers/publishers from tracking users that are using AUX. (Cookie tracking and Browser Fingerprinting are prevented)
    • Currently, only the following image types are cached:
      • PNG
      • JPG
      • GIF
      • WEBP
      • BMP
      • TIFF
      • ICO
    • Upon caching an image, we also optimize it to WEBP format to reduce file size while preserving quality.
  • Added onPointerEnter() and onPointerExit() events that are triggered on files that the user's cursor hovers.
  • Added a pre-commit task to automatically format files.
  • Formatted all of the source files. (TS, JS, Vue, JSON, HTML, CSS)
  • Added an option to the dropdown in aux-builder to jump to aux-player for the current context
  • formula-lib.ts has added a isPlayerInContext function to determine if path is in the expected context in aux-player.
  • formula-lib.ts has changed tweenTo function to tweenPlayerTo for better clarity on the function's use.