rubico 2.7.6 → 2.7.7

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

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unionWith.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unionWith.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unionWith.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/uniq.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

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

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/uniq.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/uniq.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/uniq.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unless.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

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

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unless.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unless.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/unless.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/values.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

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

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/values.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/values.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/values.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/when.es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

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

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/when.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/when.min.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/dist/x/when.mjs

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/es.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/index.js

@@ -1,5 +1,5 @@
 /**
- * rubico v2.7.6
+ * rubico v2.7.7
  * https://github.com/a-synchronous/rubico
  * (c) 2019-2025 Richard Tong
  * rubico may be freely distributed under the MIT license.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rubico",
-  "version": "2.7.6",
+  "version": "2.7.7",
   "description": "[a]synchronous functional programming",
   "author": "Richard Tong",
   "license": "MIT",
@@ -93,7 +93,6 @@
     "test": "mocha test.js *.test.js */**.test.js",
     "test-coverage": "nyc mocha test.js x/*.test.js monad/*.test.js",
     "build": "npm run dts && ./build",
-    "bench": "./bench",
-    "dts": "del *.d.ts _internal/*.d.ts x/*.d.ts && tsc"
+    "bench": "./bench"
   }
 }

package/x/append.d.ts

@@ -1,38 +0,0 @@
-export = append;
-/**
- * @name append
- *
- * @synopsis
- * ```coffeescript [specscript]
- * append(
- *   element string|Array,
- * )(value string|Array) -> string|array
- * ```
- *
- * @description
- * Append a string or an array.
- *
- * ```javascript [playground]
- * import append from 'https://unpkg.com/rubico/dist/x/append.es.js'
- *
- * const myArray = ['orange', 'apple']
- *
- * {
- *   const result = append(['ananas'])(myArray)
- *   console.log(result) // ['orange', 'apple', 'ananas']
- * }
- *
- * {
- *   const result = append('ananas')(myArray)
- *   console.log(result) // ['orange', 'apple', 'ananas']
- * }
- *
- * {
- *   const result = append('world')('hello ')
- *   console.log(result) // 'hello world'
- * }
- * ```
- *
- * @since 1.7.3
- */
-declare function append(element: any): (value: any) => string | any[];

package/x/callProp.d.ts

@@ -1,20 +0,0 @@
-export = callProp;
-/**
- * @name callProp
- *
- * @synopsis
- * ```coffeescript [specscript]
- * callProp(property string, ...args)(object) -> object[property](...args)
- * ```
- *
- * @description
- * Calls a property on an object with arguments.
- *
- * ```javascript [playground]
- * import callProp from 'https://unpkg.com/rubico/dist/x/callProp.es.js'
- *
- * const priceRoundedDown = callProp('toFixed', 2)(5.992)
- * console.log('priceRoundedDown:', priceRoundedDown) // '5.99'
- * ```
- */
-declare function callProp(property: any, ...args: any[]): (object: any) => any;

package/x/defaultsDeep.d.ts

@@ -1,42 +0,0 @@
-export = defaultsDeep;
-/**
- * @name defaultsDeep
- *
- * @synopsis
- * ```coffeescript [specscript]
- * var defaultCollection Array|Object,
- *   value Array|Object
- *
- * defaultsDeep(defaultCollection)(value) -> Array|Object
- * ```
- *
- * @description
- * Deeply assign default values to an array or object by an array or object of possibly nested default values.
- *
- * ```javascript [playground]
- * import defaultsDeep from 'https://unpkg.com/rubico/dist/x/defaultsDeep.es.js'
- *
- * const defaultUser = defaultsDeep({
- *   name: 'placeholder',
- *   images: [
- *     { url: 'https://via.placeholder.com/150' },
- *     { url: 'https://via.placeholder.com/150' },
- *     { url: 'https://via.placeholder.com/150' },
- *   ],
- * })
- *
- * console.log(defaultUser({
- *   name: 'John',
- *   images: [{ url: 'https://via.placeholder.com/150/0000FF/808080%20?Text=Digital.com' }],
- * }))
- * // {
- * //   name: 'John',
- * //   images: [
- * //    { url: 'https://via.placeholder.com/150/0000FF/808080%20?Text=Digital.com' },
- * //    { url: 'https://via.placeholder.com/150' },
- * //    { url: 'https://via.placeholder.com/150' },
- * //   ],
- * // }
- * ```
- */
-declare function defaultsDeep(defaultCollection: any): (value: any) => any;

package/x/differenceWith.d.ts

@@ -1,25 +0,0 @@
-export = differenceWith;
-/**
- * @name differenceWith
- *
- * @synopsis
- * ```coffeescript [specscript]
- * differenceWith(
- *   comparator (any, any)=>Promise|boolean,
- *   allValues Array,
- * )(values Array) -> someOrAllValues Array
- * ```
- *
- * @description
- * 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'
- *
- * console.log(
- *   differenceWith(isDeepEqual, [{ a: 1 }, { b: 2 }, { c: 3 }])([{ b: 2 }]),
- * ) // [{ a: 1 }, { c: 3 }]
- * ```
- */
-declare function differenceWith(comparator: any, allValues: any): (values: any) => any;

package/x/filterOut.d.ts

@@ -1,39 +0,0 @@
-export = filterOut;
-/**
- * @name filterOut
- *
- * @synopsis
- * ```coffeescript [specscript]
- * filterOut(
- *   arrayPredicate (value any, index number, array Array)=>Promise|boolean
- * )(array) -> rejectedArray Promise|Array
- *
- * filterOut(
- *   objectPredicate (value any, key string, object Object)=>Promise|boolean
- * )(object) -> rejectedObject Promise|Object
- *
- * filterOut(
- *   setPredicate (value any, value, set Set)=>Promise|boolean
- * )(set) -> rejectedSet Promise|Set
- *
- * filterOut(
- *   mapPredicate (value any, key any, map Map)=>Promise|boolean
- * )(map) -> rejectedMap Promise|Map
- *
- * filterOut(
- *   predicate (value any)=>Promise|boolean
- * )(generatorFunction GeneratorFunction) -> rejectingGeneratorFunction GeneratorFunction
- *
- * filterOut(
- *   predicate (value any)=>Promise|boolean
- * )(asyncGeneratorFunction AsyncGeneratorFunction) -> rejectingAsyncGeneratorFunction AsyncGeneratorFunction
- *
- * filterOut(
- *   predicate (value any)=>Promise|boolean
- * )(reducer Reducer) -> rejectingReducer Reducer
- * ```
- *
- * @description
- * The inverse of `filter`. Values that test true by the predicate are filtered out, or "rejected".
- */
-declare function filterOut(predicate: any): any;

package/x/find.d.ts

@@ -1,34 +0,0 @@
-export = find;
-/**
- * @name find
- *
- * @synopsis
- * ```coffeescript [specscript]
- * Foldable<T> = Iterable<T>|AsyncIterable<T>|{ reduce: (any, T)=>any }|Object<T>
- *
- * var T any,
- *   predicate T=>Promise|boolean,
- *   foldable Foldable<T>,
- *   result Promise|T|undefined
- *
- * find(predicate)(foldable) -> result
- * ```
- *
- * @description
- * 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'
- *
- * const users = [
- *   { name: 'John', age: 16 },
- *   { name: 'Jill', age: 32 },
- *   { name: 'John', age: 51 },
- * ]
- *
- * console.log(
- *   find(user => user.age > 50)(users),
- * ) // { name: 'John', age: 51 }
- * ```
- */
-declare function find(predicate: any): (value: any) => any;

package/x/findIndex.d.ts

@@ -1,25 +0,0 @@
-export = findIndex;
-/**
- * @name findIndex
- *
- * @synopsis
- * ```coffeescript [specscript]
- * findIndex(predicate function)(array Array) -> index Promise|number
- * ```
- *
- * @description
- * 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'
- *
- * const oddNumberIndex = findIndex(function isOdd(number) {
- *   return number % 2 == 1
- * })([2, 3, 5])
- *
- * console.log(oddNumberIndex) // 1
- * ```
- *
- * @since 1.6.26
- */
-declare function findIndex(predicate: any): (array: any) => any;

package/x/first.d.ts

@@ -1,23 +0,0 @@
-export = first;
-/**
- * @name first
- *
- * @synopsis
- * ```coffeescript [specscript]
- * var value Array|string
- *
- * first(value) -> any
- * ```
- *
- * @description
- * Get the first element of a collection
- *
- * ```javascript [playground]
- * import first from 'https://unpkg.com/rubico/dist/x/first.es.js'
- *
- * console.log(first([1, 2, 3])) // 1
- * console.log(first('abc')) // 'a'
- * console.log(first([])) // undefined
- * ```
- */
-declare function first(value: any): any;

package/x/flatten.d.ts

@@ -1,57 +0,0 @@
-export = flatten;
-/**
- * @name flatten
- *
- * @synopsis
- * ```coffeescript [specscript]
- * Stream<T> = { read: ()=>T, write: T=>() }
- * Monad<T> = Array<T>|String<T>|Set<T>
- *   |TypedArray<T>|Stream<T>|Iterator<T>|AsyncIterator<T>
- *   |{ chain: T=>Monad<T> }|{ flatMap: T=>Monad<T> }|Object<T>
- * Reducer<T> = (any, T)=>Promise|any
- * Foldable<T> = Iterable<T>|AsyncIterable<T>|{ reduce: Reducer<T>=>any }|Object<T>
- *
- * var T any,
- *   monad Monad<Monad<T>|Foldable<T>|T>,
- *   args ...any,
- *   generatorFunction ...args=>Generator<Monad<T>|Foldable<T>|T>,
- *   asyncGeneratorFunction ...args=>AsyncGenerator<Monad<T>|Foldable<T>|T>,
- *   reducer Reducer<Monad<T>|Foldable<T>|T>
- *
- * flatten(monad) -> Monad<T>
- *
- * flatten(generatorFunction) -> ...args=>Generator<T>
- *
- * flatten(asyncGeneratorFunction) -> ...args=>AsyncGenerator<T>
- *
- * flatten(reducer) -> Reducer<T>
- * ```
- *
- * @description
- * Flatten a collection. Works in transducer position.
- *
- * ```javascript [playground]
- * import flatten from 'https://unpkg.com/rubico/dist/x/flatten.es.js'
- *
- * flatten([
- *   [1, 1],
- *   new Set([2, 2]),
- *   (function* () { yield 3; yield 3 })(),
- *   (async function* () { yield 4; yield 4 })(),
- *   { a: 5, b: 5 },
- *   6,
- *   Promise.resolve(7),
- *   new Uint8Array([8]),
- * ]).then(console.log)
- * // [1, 1, 2, 3, 3, 5, 5, 6, 7, 8, 4, 4]
- *
- * const add = (a, b) => a + b
- *
- * console.log(
- *   [[1], [2], [3], [4], [5]].reduce(flatten(add), 0),
- * ) // 15
- * ```
- *
- * @TODO flatten for each type
- */
-declare function flatten(value: any): any;

package/x/groupBy.d.ts

@@ -1,50 +0,0 @@
-export = groupBy;
-/**
- * @name groupBy
- *
- * @synopsis
- * ```coffeescript [specscript]
- * Reducer<T> = (any, T)=>Promise|any
- * Foldable<T> = Iterable<T>|AsyncIterable<T>|{ reduce: Reducer<T>=>any }|Object<T>
- *
- * var property any,
- *   resolver any=>Promise|any,
- *   value Foldable
- *
- * groupBy(property)(value) -> groupedByProperty Map<any=>Array>
- *
- * groupBy(resolver)(value) -> groupedByResolver Promise|Map<any=>Array>
- * ```
- *
- * @description
- * 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'
- *
- * console.log(
- *   groupBy('age')([
- *     { name: 'John', age: 22 },
- *     { name: 'Jane', age: 22 },
- *     { name: 'Henry', age: 23 },
- *   ]),
- * )
- * // Map {
- * //   22 => [{ name: 'John', age: 22 }, { name: 'Jane', age: 22 }],
- * //   23 => [{ name: 'Henry', age: 23 }],
- * // }
- * ```
- *
- * 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'
- *
- * console.log(
- *   groupBy(
- *     word => word.toLowerCase(),
- *   )(['Hello', 'hello', 'Hey']),
- * ) // Map { 'hello' => ['Hello', 'hello'], 'hey' => ['Hey'] }
- * ```
- */
-declare function groupBy(propertyOrResolver: any): any;

package/x/has.d.ts

@@ -1,25 +0,0 @@
-export = has;
-/**
- * @name has
- *
- * @synopsis
- * ```coffeescript [specscript]
- * has(key any)(container Set|Map|{ has: function }|Object) -> Promise|boolean
- * ```
- *
- * @description
- * Check if a collection has a key.
- *
- * ```javascript [playground]
- * import has from 'https://unpkg.com/rubico/dist/x/has.es.js'
- *
- * console.log(
- *   has('a')({ a: 1, b: 2, c: 3 }),
- * ) // true
- *
- * console.log(
- *   has('a')({}),
- * ) // false
- * ```
- */
-declare function has(key: any): (container: any) => any;