rubico 2.8.2 → 2.8.4

package/dist/x/values.es.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/x/values.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/x/values.min.js

@@ -1,9 +1,9 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software
  * Rubico may be freely distributed under the CFOSS license.
  */
 
-!function(e,t){"object"==typeof module?module.exports=t:"function"==typeof define?define(()=>t):e.values=t}("object"==typeof globalThis?globalThis:this,function(){"use strict";const e=Object.values;return t=>null==t?[]:"function"==typeof t.values?[...t.values()]:e(t)}());
+!function(e,t){"object"==typeof module?module.exports=t:"function"==typeof define?define((()=>t)):e.values=t}("object"==typeof globalThis?globalThis:this,function(){"use strict";const e=Object.values;return t=>null==t?[]:"function"==typeof t.values?[...t.values()]:e(t)}());

package/dist/x/values.mjs

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/x/when.es.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/x/when.es.min.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/x/when.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/dist/x/when.min.js

@@ -1,9 +1,9 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software
  * Rubico may be freely distributed under the CFOSS license.
  */
 
-!function(n,t){"object"==typeof module?module.exports=t:"function"==typeof define?define(()=>t):n.when=t}("object"==typeof globalThis?globalThis:this,function(){"use strict";const n=Symbol.for("placeholder"),t=(n,t,e)=>n?t():e();return(e,o)=>function(u){const r=e(u);return(n=>null!=n&&"function"==typeof n.then)(r)?r.then((f=t,c=n,i=((n,t)=>function(){return n(t)})(o,u),l=(n=>function(){return n})(u),c==n?((n,t,e)=>function(o){return n(o,t,e)})(f,i,l):i==n?((n,t,e)=>function(o){return n(t,o,e)})(f,c,l):((n,t,e)=>function(o){return n(t,e,o)})(f,c,i))):r?o(u):u;var f,c,i,l}}());
+!function(n,t){"object"==typeof module?module.exports=t:"function"==typeof define?define((()=>t)):n.when=t}("object"==typeof globalThis?globalThis:this,function(){"use strict";const n=Symbol.for("placeholder"),t=(n,t,e)=>n?t():e();return(e,o)=>function(u){const r=e(u);return(n=>null!=n&&"function"==typeof n.then)(r)?r.then((f=t,c=n,i=((n,t)=>function(){return n(t)})(o,u),l=(n=>function(){return n})(u),c==n?((n,t,e)=>function(o){return n(o,t,e)})(f,i,l):i==n?((n,t,e)=>function(o){return n(t,o,e)})(f,c,l):((n,t,e)=>function(o){return n(t,e,o)})(f,c,i))):r?o(u):u;var f,c,i,l}}());

package/dist/x/when.mjs

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/es.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/index.js

@@ -1,5 +1,5 @@
 /**
- * Rubico v2.8.2
+ * Rubico v2.8.4
  * https://rubico.land/
  *
  * © Richard Yufei Tong, King of Software

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "rubico",
-  "version": "2.8.2",
+  "version": "2.8.4",
   "description": "[a]synchronous functional programming",
   "author": "Richard Tong",
-  "license": "MIT",
+  "license": "CFOSS",
   "main": "index.js",
   "repository": {
     "type": "git",

package/thunkify.js

@@ -65,6 +65,7 @@ const thunkify = function thunkify(func, ...args) {
  * thunkify.call(func function, context object, ...args) -> thunk ()=>func(...args)
  * ```
  *
+ * @description
  * Creates a thunk that calls a function with the specified context and arguments.
  *
  * ```javascript [playground]
@@ -74,12 +75,17 @@ const thunkify = function thunkify(func, ...args) {
  *     this.y = y
  *   }
  *
- *   toString() {
- *     return `(${this.x}, ${this.y})`
+ *   distanceTo() {
+ *     const x2 = (point.x - this.x) ** 2
+ *     const y2 = (point.y - this.y) ** 2
+ *     return (x2 + y2) ** 0.5
  *   }
  * }
  *
- * const thunk = thunkify.call(toString, point)
+ * const point0 = new Point(0, 0)
+ * const point = new Point(3, 4)
+ *
+ * const thunk = thunkify.call(point0.distanceTo, point0, point)
  *
  * console.log(thunk())
  * ```

package/x/append.js

@@ -15,7 +15,7 @@ const isArray = require('../_internal/isArray')
  * Append a string or an array.
  *
  * ```javascript [playground]
- * import append from 'https://unpkg.com/rubico/dist/x/append.es.js'
+ * import append from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/append.es.js'
  *
  * const myArray = ['orange', 'apple']
  *

package/x/callProp.js

@@ -10,7 +10,7 @@
  * Calls a property on an object with arguments.
  *
  * ```javascript [playground]
- * import callProp from 'https://unpkg.com/rubico/dist/x/callProp.es.js'
+ * import callProp from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/callProp.es.js'
  *
  * const priceRoundedDown = callProp('toFixed', 2)(5.992)
  * console.log('priceRoundedDown:', priceRoundedDown) // '5.99'

package/x/defaultsDeep.js

@@ -106,7 +106,7 @@ function _defaultsDeep(data, defaults) {
  * Deeply assign default values to an object or array `data` using an array or object of default values `defaults`. The keys or indices of each element of `defaults` are used to extend `data` where there is no existing value. Both `data` and `defaults` may have nested arrays or objects.
  *
  * ```javascript [playground]
- * import defaultsDeep from 'https://unpkg.com/rubico/dist/x/defaultsDeep.es.js'
+ * import defaultsDeep from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/defaultsDeep.es.js'
  *
  * const user = {
  *   name: 'John',

package/x/differenceWith.js

@@ -89,8 +89,8 @@ const differenceWithArray = function (comparator, allValues, array) {
  * Create an array of all the values in an array that are not in another array as dictated by a comparator.
  *
  * ```javascript [playground]
- * import differenceWith from 'https://unpkg.com/rubico/dist/x/differenceWith.es.js'
- * import isDeepEqual from 'https://unpkg.com/rubico/dist/x/isDeepEqual.es.js'
+ * import differenceWith from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/differenceWith.es.js'
+ * import isDeepEqual from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isDeepEqual.es.js'
  *
  * console.log(
  *   differenceWith(isDeepEqual, [{ a: 1 }, { b: 2 }, { c: 3 }])([{ b: 2 }]),

package/x/find.js

@@ -25,7 +25,7 @@ const asyncIteratorFind = require('../_internal/asyncIteratorFind')
  * Get the first element in a foldable collection that matches a predicate.
  *
  * ```javascript [playground]
- * import find from 'https://unpkg.com/rubico/dist/x/find.es.js'
+ * import find from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/find.es.js'
  *
  * const users = [
  *   { name: 'John', age: 16 },

package/x/findIndex.js

@@ -44,7 +44,7 @@ const findIndexAsync = async function (predicate, array, index) {
  * Returns the index of the first element in an array that satisfies the predicate. Returns -1 if no element satisfies the predicate.
  *
  * ```javascript [playground]
- * import findIndex from 'https://unpkg.com/rubico/dist/x/findIndex.es.js'
+ * import findIndex from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/findIndex.es.js'
  *
  * const oddNumberIndex = findIndex(function isOdd(number) {
  *   return number % 2 == 1

package/x/first.js

@@ -12,7 +12,7 @@
  * Get the first element of a collection
  *
  * ```javascript [playground]
- * import first from 'https://unpkg.com/rubico/dist/x/first.es.js'
+ * import first from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/first.es.js'
  *
  * console.log(first([1, 2, 3])) // 1
  * console.log(first('abc')) // 'a'

package/x/flatten.js

@@ -37,7 +37,7 @@ const flatMap = require('../flatMap')
  * Flatten a collection. Works in transducer position.
  *
  * ```javascript [playground]
- * import flatten from 'https://unpkg.com/rubico/dist/x/flatten.es.js'
+ * import flatten from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/flatten.es.js'
  *
  * flatten([
  *   [1, 1],

package/x/groupBy.js

@@ -55,7 +55,7 @@ const groupByResolver = resolver => function groupByResolverReducer(
  * Group a foldable collection into a Map of arrays by a property on each of its elements.
  *
  * ```javascript [playground]
- * import groupBy from 'https://unpkg.com/rubico/dist/x/groupBy.es.js'
+ * import groupBy from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/groupBy.es.js'
  *
  * console.log(
  *   groupBy('age')([
@@ -73,7 +73,7 @@ const groupByResolver = resolver => function groupByResolverReducer(
  * Additionally, pass a resolver in property position to resolve a value for group membership for each element.
  *
  * ```javascript [playground]
- * import groupBy from 'https://unpkg.com/rubico/dist/x/groupBy.es.js'
+ * import groupBy from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/groupBy.es.js'
  *
  * console.log(
  *   groupBy(

package/x/has.js

@@ -15,7 +15,7 @@ const objectHas = function (object, key) {
  * Check if a collection has a key.
  *
  * ```javascript [playground]
- * import has from 'https://unpkg.com/rubico/dist/x/has.es.js'
+ * import has from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/has.es.js'
  *
  * console.log(
  *   has('a')({ a: 1, b: 2, c: 3 }),

package/x/identity.js

@@ -10,7 +10,7 @@
  * Pass a value and receive the same value back.
  *
  * ```javascript [playground]
- * import identity from 'https://unpkg.com/rubico/dist/x/identity.es.js'
+ * import identity from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/identity.es.js'
  *
  * console.log(
  *   identity(1),

package/x/includes.js

@@ -23,7 +23,7 @@ const objectIncludes = function (object, value) {
  * Check if a collection includes another value by [SameValueZero](http://ecma-international.org/ecma-262/7.0/#sec-samevaluezero).
  *
  * ```javascript [playground]
- * import includes from 'https://unpkg.com/rubico/dist/x/includes.es.js'
+ * import includes from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/includes.es.js'
  *
  * console.log(
  *   includes(5)([1, 2, 3, 4, 5])

package/x/isDeepEqual.js

@@ -127,7 +127,7 @@ const areValuesDeepEqual = function (left, right) {
  * Check two values for deep [SameValueZero](http://ecma-international.org/ecma-262/7.0/#sec-samevaluezero) equality.
  *
  * ```javascript [playground]
- * import isDeepEqual from 'https://unpkg.com/rubico/dist/x/isDeepEqual.es.js'
+ * import isDeepEqual from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isDeepEqual.es.js'
  *
  * console.log(
  *   isDeepEqual({ a: 1, b: 2, c: [3] }, { a: 1, b: 2, c: [3] }),
@@ -141,7 +141,7 @@ const areValuesDeepEqual = function (left, right) {
  * When passed a resolver function as the left or right argument or resolvers as both arguments, returns a function that resolves the value by the resolver before performing the deep equal comparison.
  *
  * ```javascript [playground]
- * import isDeepEqual from 'https://unpkg.com/rubico/dist/x/isDeepEqual.es.js'
+ * import isDeepEqual from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isDeepEqual.es.js'
  *
  * const isPropADeepEqualTo123Array = isDeepEqual(object => object.a, [1, 2, 3])
  *

package/x/isEmpty.js

@@ -12,7 +12,7 @@ const objectKeysLength = require('../_internal/objectKeysLength')
  * Check if a value is empty.
  *
  * ```javascript [playground]
- * import isEmpty from 'https://unpkg.com/rubico/dist/x/isEmpty.es.js'
+ * import isEmpty from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isEmpty.es.js'
  *
  * console.log('', isEmpty('')) // true
  * console.log([], isEmpty([])) // true

package/x/isFunction.js

@@ -10,7 +10,7 @@
  * Determine whether a value is a function.
  *
  * ```javascript [playground]
- * import isFunction from 'https://unpkg.com/rubico/dist/x/isFunction.es.js'
+ * import isFunction from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isFunction.es.js'
  *
  * const add = (a, b) => a + b
  *

package/x/isIn.js

@@ -14,7 +14,7 @@ const __ = require('../_internal/placeholder')
  * Counterpart to includes. Check if a collection includes another value.
  *
  * ```javascript [playground]
- * import isIn from 'https://unpkg.com/rubico/dist/x/isIn.es.js'
+ * import isIn from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isIn.es.js'
  *
  * console.log(
  *   isIn(1, [1, 2, 3])
@@ -88,7 +88,7 @@ const _isIn = function (value, container) {
  * Counterpart to includes. Check if a collection includes another value.
  *
  * ```javascript [playground]
- * import isIn from 'https://unpkg.com/rubico/dist/x/isIn.es.js'
+ * import isIn from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isIn.es.js'
  *
  * console.log(
  *   isIn([1, 2, 3](1)

package/x/isObject.js

@@ -12,7 +12,7 @@ const isObject = require('../_internal/isObject')
  * Determine whether a value has the [language type](http://www.ecma-international.org/ecma-262/7.0/#sec-ecmascript-language-types) of `Object`.
  *
  * ```javascript [playground]
- * import isObject from 'https://unpkg.com/rubico/dist/x/isObject.es.js'
+ * import isObject from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isObject.es.js'
  *
  * console.log(
  *   isObject({ a: 1, b: 2, c: 3 }),

package/x/isString.js

@@ -10,7 +10,7 @@
  * Determine whether a value is a string.
  *
  * ```javascript [playground]
- * import isString from 'https://unpkg.com/rubico/dist/x/isString.es.js'
+ * import isString from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isString.es.js'
  *
  * console.log(
  *   isString('hey'),

package/x/keys.js

@@ -12,7 +12,7 @@ const objectKeys = require('../_internal/objectKeys')
  * Get an array of keys from an instance.
  *
  * ```javascript [playground]
- * import keys from 'https://unpkg.com/rubico/dist/x/keys.es.js'
+ * import keys from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/keys.es.js'
  *
  * console.log(keys({ a: 1, b: 2, c: 3 })) // ['a', 'b', 'c']
  * console.log(keys(['hello', 'world'])) // [0, 1]

package/x/last.js

@@ -12,7 +12,7 @@
  * Get the last element of a collection
  *
  * ```javascript [playground]
- * import last from 'https://unpkg.com/rubico/dist/x/last.es.js'
+ * import last from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/last.es.js'
  *
  * console.log(last([1, 2, 3])) // 3
  * console.log(last([])) // undefined

package/x/maxBy.js

@@ -38,7 +38,7 @@ const _maxBy = function (array, path) {
  * Finds the element that is the max by a property denoted by path.
  *
  * ```javascript [playground]
- * import maxBy from 'https://unpkg.com/rubico/dist/x/maxBy.es.js'
+ * import maxBy from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/maxBy.es.js'
  *
  * const array = [{ a: 1 }, { a: 2 }, { a: 3 }]
  *
@@ -50,7 +50,7 @@ const _maxBy = function (array, path) {
  * `maxBy` composes in a lazy way.
  *
  * ```javascript [playground]
- * import maxBy from 'https://unpkg.com/rubico/dist/x/maxBy.es.js'
+ * import maxBy from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/maxBy.es.js'
  *
  * const numbers = [1, 2, 3]
  *

package/x/noop.js

@@ -10,7 +10,7 @@
  * Doesn't do anything.
  *
  * ```javascript [playground]
- * import noop from 'https://unpkg.com/rubico/dist/x/noop.es.js'
+ * import noop from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/noop.es.js'
  *
  * console.log(
  *   noop(),

package/x/pluck.js

@@ -22,7 +22,7 @@ const get = require('../get')
  *  * an array of keys or indices - `['a', 0, 'value']`
  *
  * ```javascript [playground]
- * import pluck from 'https://unpkg.com/rubico/dist/x/pluck.es.js'
+ * import pluck from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/pluck.es.js'
  *
  * const users = [
  *   { name: 'John', age: 33 },

package/x/prepend.js

@@ -15,7 +15,7 @@ const isArray = require('../_internal/isArray')
  * Prepend a string or an array.
  *
  * ```javascript [playground]
- * import prepend from 'https://unpkg.com/rubico/dist/x/prepend.es.js'
+ * import prepend from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/prepend.es.js'
  *
  * const myArray = ['orange', 'apple']
  *

package/x/size.js

@@ -12,7 +12,7 @@ const objectKeysLength = require('../_internal/objectKeysLength')
  * Get the count of elements in a value.
  *
  * ```javascript [playground]
- * import size from 'https://unpkg.com/rubico/dist/x/size.es.js'
+ * import size from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/size.es.js'
  *
  * console.log(size([1, 2, 3])) // 3
  * console.log(size('hey')) // 3

package/x/trace.js

@@ -22,7 +22,7 @@ const consoleLog = console.log
  * Log a value out to the console, returning the value. If the value is a function, treat it as a resolver.
  *
  * ```javascript [playground]
- * import trace from 'https://unpkg.com/rubico/dist/x/trace.es.js'
+ * import trace from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/trace.es.js'
  *
  * pipe([
  *   trace,

package/x/unionWith.js

@@ -115,8 +115,8 @@ const arrayUniqWith = function (array, comparator) {
  * Create an array of unique values from an array of arrays with uniqueness determined by a comparator. The comparator is a function that returns a boolean value, `true` if two given values are distinct.
  *
  * ```javascript [playground]
- * import isDeepEqual from 'https://unpkg.com/rubico/dist/x/isDeepEqual.es.js'
- * import unionWith from 'https://unpkg.com/rubico/dist/x/unionWith.es.js'
+ * import isDeepEqual from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/isDeepEqual.es.js'
+ * import unionWith from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/unionWith.es.js'
  *
  * console.log(
  *   unionWith(isDeepEqual)([

package/x/uniq.js

@@ -15,7 +15,7 @@ const isArray = require('../_internal/isArray')
  * Get an array of unique values from an array.
  *
  * ```javascript [playground]
- * import uniq from 'https://unpkg.com/rubico/dist/x/uniq.es.js'
+ * import uniq from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/uniq.es.js'
  *
  * console.log(
  *   uniq([1, 2, 2, 3]),

package/x/unless.js

@@ -20,7 +20,7 @@ const thunkConditional = require('../_internal/thunkConditional')
  * Execute a function and return the result unless a condition is true, otherwise return the original value.
  *
  * ```javascript [playground]
- * import unless from 'https://unpkg.com/rubico/dist/x/unless.es.js'
+ * import unless from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/unless.es.js'
  *
  * const isEven = num => num % 2 === 0
  * const doubleIfOdd = unless(isEven, num => num * 2)

package/x/values.js

@@ -14,7 +14,7 @@ const objectValues = require('../_internal/objectValues')
  * Get an array of values from an instance.
  *
  * ```javascript [playground]
- * import values from 'https://unpkg.com/rubico/dist/x/values.es.js'
+ * import values from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/values.es.js'
  *
  * console.log(values({ a: 1, b: 2, c: 3 })) // [1, 2, 3]
  * console.log(values('abc')) // ['a', 'b', 'c']

package/x/when.js

@@ -20,7 +20,7 @@ const thunkConditional = require('../_internal/thunkConditional')
  * Execute a function and return the result when a condition is true, otherwise return the original value.
  *
  * ```javascript [playground]
- * import when from 'https://unpkg.com/rubico/dist/x/when.es.js'
+ * import when from 'https://cdn.jsdelivr.net/npm/rubico/dist/x/when.es.js'
  *
  * const isEven = num => num % 2 === 0
  * const doubleIfEven = when(isEven, num => num * 2)