@kubric/utils

@kubric/utils contains some commonly used util functions

Installation

``Javascript
yarn add @kubric/utils
`
`Javascript
npm i @kubric/utils
`

Usage

`Javascript
import {isUndefined, get, mapValues} from "@kubric/utils";
`

Functions

$3

* isNull(val): returns true if val is null
* isUndefined(val): returns true if val is undefined
* isNullOrUndefined(val): returns true if val is null or undefined
* isFunction(val): returns true if val is a function
* isString(val): returns true if val is a string
* isValidString(val): returns true if val is a non-empty string
* isObjectLike(val): returns true if val is not null and is of type object
* isObject(val): returns true if val is object-like or is a function
* isPlainObject(val): returns true if val is an object created by the Object constructor or one with a [
[Prototype]] of null.
* isNumber(val): returns true if val is a number, or a value that can be parsed into a number.

$3

* get(object, path, defaultValue): returns value from object at path. If the value at path is found to be
undefined, the defaultValue(is any) is returned
* set(object, path, value, options): Sets value in object in the path specified. If options.create is
true, all objects along the path will be created
* getAsNumbers(object, paths, defaults): Accepts any object and an array of paths. For every path in index "pathIndex", it will be resolved against the object and an array of values will be returned as per the following rules
- If the value is a number or a value that can be coerced into a number, the parsed number is returned
- If the value exists but is not a number or a value that can be parsed into a number, the value is returned as such
- If the value exists and "defaults" is a non array value, "defaults" is passed back
- If the value exists and "defaults" is as array value, "defaults[pathIndex]" is passed back

$3

* capitalize(str): Capitalizes str i.e. makes the first letter capital
* getStringHash(str): Returns a number hash for str
* getJSONHash(json): Returns a number hash for the json object

$3

* mapValues(object, func): Creates an object with the same keys as object and values generated by running each
of it's properies through func. func is invoked with 2 arguments value and key.
* filterObject(object, func): To create a new object that contains keys/values filtered from the object that is
passed in. Value of every key in obj is passed to the function. If the function returns true, the resultant object
will have that key and its value, otherwise it is omitted in the returned object.

$3

* debounce(func, wait): Creates a debounced function that delays invoking func until after wait milliseconds
have elapsed since the last time the debounced function was invoked.
* throttle(func, wait, options): Creates a throttled function that only invokes func at most once per wait
milliseconds. Provide options.leading and options.trailing to indicate whether func should be invoked on the
leading and/or trailing edge of the wait timeout. The func is invoked with the last arguments provided to the
throttled function. Subsequent calls to the throttled function return the result of the last func invocation. If
options.leading and options.trailing options are both true, func is invoked on the trailing edge of the
timeout only if the throttled function is invoked more than once during the wait timeout. If wait is 0 and
options.leading is false, func invocation is deferred until to the next tick, similar to setTimeout with a
timeout of 0.
* bindFunctions(funcMap, bindBefore, bindAfter): Creates an object with the same keys as funcMap whose values
are obtained by binding the corresponding functions with values from the arrays bindBefore and bindAfter. If
any of the functions from the resultant map is called with say arg1 and arg2, the function's arguments
object will be have the value [...bindBefore, arg1, arg2, ...bindAfter]
* pipeline(funcArray, initialState): Returns a function that invokes the given array of functions sequentially by
passing the output of the function at index n to the function at index n+1. The function returns the value
returned by the last function in the array.

$3

* resolvePromises(promises): If provided with an array of promises, it returns a promise that resolves when all
the promises in the array has resolved. The returned promise will resolve with an array of results with the result
in index i corresponding to promise i in the input array. If provided with a map of promises, it returns a promise
that resolves when all the promises in the object has resolved. The returned promise will resolve with a map of
results with the result in key i corresponding to promise at the key i in the input object. If anything else is
provided, the input value is returned as such.



$3


Style extractor does concatenation of CSS class names from a style object and theme object. Refer to the test cases
at tests/StyleExtractor.test.js` for examples