Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

wetbox

Onitz31ISC0.3.5

A collection of prototype tools

prototype, sandbox, wetbox, wet, box, array helpers, shuffle, sequence, zeros, randInt, leftPad, clear empty array elements, choose, combination, ordering, iteration, ith combination, ith iteration, ith ordering, inverse combination, getUrl, call API, toRadians, toDegrees, randomizeArray, randomize array, game, keylistener

readme

alt text

Setup

npm install wetbox
let WET = require( 'wetbox' )

Functions

getVersion()
Returns the current in-use version of the library

getUrl( url, callback )
Fetches an external API url (typically json) and performs callback( status, response ) when loaded.
Status being a nubmer (ie 400), and response being the data.

zeros( n )
Returns an array of zeros of lenth n

sequence( n )
Returns an array of numbers from 0 .. n-1

randInt( n )
Returns a random int from 0 .. n-1

clearEmptyElements( array )
Remove all zero and falsy values from an array

randomizeArray( array )
Returns array with random-ordered elements using the Fisher-Yates-Knuth shuffle.

leftPad( str, len, fillerChar )
Pads a string up to length len, with single-char: fillerChar (defaults to space character)

toRadians( x )
Convert x degrees to radians

toDegrees( x )
Convert x radians to degrees

hasDuplicates( n ) Returns true if array contains duplicates

choose( n, k ) The mathematical choose function. One-indexed

ithIteration( n, k, i ) Alias for ithCombination( n, k, i )

inverseIthIteration( n, combinationArray ) Alias for inverseIthCombination( n, combinationArray )

ithCombination( n, k, i ) Given a set of n items, k choices, and an index i, give me a k-sized array of the ith combination. 0 <= i < n.

inverseIthCombination( n, combinationArray ) Given a number n and combinationArray, convert the array into an ith ordering. k is infered from combinationArrays length.

Classes

new WET.game( THREE, gameTitle )
Given a three.js library let THREE = require( 'three' ), initialize a basic game environment using threejs. ie in index.js

WET = require( 'wetbox' )
THREE = require( 'three' )
game = new WET.Game( THREE, 'Wizzy boi' )

Window lickers listeners

keyListen( isEnable, up, left, down, right, crouch, space, esc, tab, enter )
Adds some keyboard listeners to the page for typical game commands. All input params are callback functions, first 5 are mandatory.

WET.keyListen( 
  enabled => { return true },
  up      => { console.log( 'up' ) },
  left    => { console.log( 'left' ) },
  down    => { console.log( 'down' ) },
  right   => { console.log( 'right' ) },
  crouch  => { console.log( 'crouch' ) },
  space   => { console.log( 'space' ) },
  esc     => { console.log( 'esc' ) },
  tab     => { console.log( 'tab' ) },
  enter   => { console.log( 'enter' ) },
)

keyUpListen( up, left, down, right, crouch )
Adds key-release listeners for switch-keys, all args are callbacks and always enabled.

WET.keyUpListen(
  releaseUp     => { console.log( 'release up' ) },
  releaseLeft   => { console.log( 'release left' ) },
  releaseDown   => { console.log( 'release down' ) },
  releaseRight  => { console.log( 'release right' ) },
  releaseCrouch => { console.log( 'release crouch' ) },
)

Administration

Updating npm publish --dry-run npm publish