rambda 10.0.0-alpha.0 → 10.0.0-beta.3

package/package.json

@@ -1,21 +1,19 @@
 {
   "name": "rambda",
-  "version": "10.0.0-alpha.0",
+  "version": "10.0.0-beta.3",
   "scripts": {
     "out": "yarn populatedocs && yarn populatereadme && yarn immutable && yarn build && yarn create-docsify",
     "build": "yarn build:main && yarn build:web && yarn build:esm",
-    "build:main": "rollup rambda.js --file dist/rambda.js --format cjs",
-    "build:esm": "rollup rambda.js --file dist/rambda.esm.js --format es",
+    "build:main": "rollup rambda.js --file dist/rambda.cjs --format cjs",
+    "build:esm": "rollup rambda.js --file dist/rambda.js --format es",
     "build:web": "rollup rambda.js --file dist/rambda.umd.js --format umd --name \"R\"",
-    "immutable": "cd ../rambda-scripts && yarn immutable:rambda",
+    "immutable": "cd ../rambda-scripts && yarn immutable",
     "populatedocs": "cd ../rambda-scripts && yarn populate:docs",
     "populatereadme": "cd ../rambda-scripts && yarn populate:readme",
     "lint": "cd source && run lint:folder > lint-output.txt",
     "test:file": "node scripts/tasks/run/run-test.js",
     "test:ci": "vitest run",
     "test": "vitest run --watch -u",
-    "x": "vitest run --watch source/and.spec.js",
-    "test:cover": "vitest run --coverage",
     "test:typings": "dtslint --localTs ./node_modules/typescript/lib --expectOnly ./source",
     "create-docsify": "cd ../rambda-scripts && yarn create-docsify",
     "deps": "run dep:next",
@@ -27,20 +25,32 @@
   "depFn": [
     "@definitelytyped/dtslint"
   ],
+  "type": "module",
+  "exports": {
+    "require": {
+      "types": "./index.d.ts",
+      "default": "./dist/rambda.cjs"
+    },
+    "types": "./index.d.ts",
+    "default": "./dist/rambda.js"
+  },
+  "main": "dist/rambda.cjs",
+  "module": "dist/rambda.js",
   "dependencies": {},
   "devDependencies": {
     "@definitelytyped/dtslint": "0.0.182",
     "@types/mocha": "10.0.10",
-    "@vitest/coverage-v8": "^3.0.5",
+    "@vitest/coverage-v8": "3.1.0-beta.2",
     "helpers-fn": "2.0.0",
     "lodash": "4.17.21",
+    "radashi": "^12.4.0",
     "rambdax": "11.3.1",
     "ramda": "0.30.1",
-    "remeda": "^2.21.0",
-    "rollup": "4.34.4",
+    "remeda": "2.21.2",
+    "rollup": "4.36.0",
     "types-ramda": "0.30.1",
-    "typescript": "5.8.0-dev.20250206",
-    "vitest": "3.0.5"
+    "typescript": "5.9.0-dev.20250321",
+    "vitest": "3.1.0-beta.2"
   },
   "jest": {
     "testEnvironment": "node",
@@ -68,13 +78,12 @@
     "generics",
     "lodash",
     "ramda",
+    "remeda",
     "stdlib",
     "toolkit",
     "ts",
     "types",
     "typescript",
-    "underscore",
-    "util",
     "utilities",
     "utility",
     "utils"
@@ -90,8 +99,6 @@
     "immutable.js"
   ],
   "sideEffects": false,
-  "main": "./dist/rambda.js",
   "umd": "./dist/rambda.umd.js",
-  "module": "./rambda.js",
   "types": "./index.d.ts"
 }

package/rambda.js

@@ -1,15 +1,21 @@
 /// <reference types="./index.d.ts" />
+export * from './src/addProp.js'
+export * from './src/addPropToObjects.js'
 export * from './src/all.js'
 export * from './src/allPass.js'
 export * from './src/any.js'
 export * from './src/anyPass.js'
 export * from './src/append.js'
+export * from './src/ascend.js'
 export * from './src/checkObjectWithSpec.js'
+export * from './src/compact.js'
 export * from './src/complement.js'
 export * from './src/concat.js'
 export * from './src/count.js'
 export * from './src/countBy.js'
+export * from './src/createObjectFromKeys.js'
 export * from './src/defaultTo.js'
+export * from './src/descend.js'
 export * from './src/drop.js'
 export * from './src/dropLast.js'
 export * from './src/dropLastWhile.js'
@@ -25,14 +31,17 @@ export * from './src/find.js'
 export * from './src/findIndex.js'
 export * from './src/findLast.js'
 export * from './src/findLastIndex.js'
+export * from './src/findNth.js'
 export * from './src/flatMap.js'
 export * from './src/flatten.js'
+export * from './src/flattenObject.js'
 export * from './src/groupBy.js'
 export * from './src/head.js'
 export * from './src/includes.js'
 export * from './src/indexOf.js'
 export * from './src/init.js'
 export * from './src/innerJoin.js'
+export * from './src/interpolate.js'
 export * from './src/intersection.js'
 export * from './src/intersperse.js'
 export * from './src/join.js'
@@ -40,19 +49,26 @@ export * from './src/last.js'
 export * from './src/lastIndexOf.js'
 export * from './src/map.js'
 export * from './src/mapAsync.js'
+export * from './src/mapKeys.js'
 export * from './src/mapObject.js'
 export * from './src/mapObjectAsync.js'
+export * from './src/mapParallelAsync.js'
 export * from './src/match.js'
 export * from './src/maxBy.js'
 export * from './src/merge.js'
 export * from './src/mergeTypes.js'
 export * from './src/minBy.js'
-export * from './src/modifyPath.js'
+export * from './src/modifyItemAtIndex.js'
+export * from './src/modifyProp.js'
 export * from './src/none.js'
 export * from './src/objOf.js'
+export * from './src/objectIncludes.js'
 export * from './src/omit.js'
 export * from './src/partition.js'
+export * from './src/partitionObject.js'
 export * from './src/path.js'
+export * from './src/pathSatisfies.js'
+export * from './src/permutations.js'
 export * from './src/pick.js'
 export * from './src/pipe.js'
 export * from './src/pipeAsync.js'
@@ -65,10 +81,15 @@ export * from './src/propSatisfies.js'
 export * from './src/range.js'
 export * from './src/reduce.js'
 export * from './src/reject.js'
+export * from './src/rejectObject.js'
 export * from './src/replace.js'
-export * from './src/replaceItemAtIndex.js'
+export * from './src/shuffle.js'
 export * from './src/sort.js'
 export * from './src/sortBy.js'
+export * from './src/sortByDescending.js'
+export * from './src/sortByPath.js'
+export * from './src/sortByPathDescending.js'
+export * from './src/sortObject.js'
 export * from './src/sortWith.js'
 export * from './src/split.js'
 export * from './src/splitEvery.js'

package/src/addProp.js

@@ -0,0 +1,3 @@
+export function addProp(key, value) {
+  return obj => ({ ...obj, [key]: value })
+}

package/src/addPropToObjects.js

@@ -0,0 +1,14 @@
+import { mapFn } from './map.js'
+
+export function addPropToObjects (
+	property, 
+	fn
+){
+	return listOfObjects => mapFn(
+		(obj) => ({
+			...(obj),
+			[property]: fn(obj)
+		}), 
+		listOfObjects
+	)
+}

package/src/append.js

@@ -1,10 +1,10 @@
 import { cloneList } from './_internals/cloneList.js'
 
 export function append(x) {
-  return list=> {
-		const clone = cloneList(list)
-  clone.push(x)
+  return list => {
+    const clone = cloneList(list)
+    clone.push(x)
 
-  return clone
-	}
+    return clone
+  }
 }

package/src/ascend.js

@@ -0,0 +1,16 @@
+export function createCompareFunction(a, b, winner, loser) {
+  if (a === b) {
+    return 0
+  }
+
+  return a < b ? winner : loser
+}
+
+export function ascend(getFunction) {
+	return (a, b) => {
+  const aValue = getFunction(a)
+  const bValue = getFunction(b)
+
+  return createCompareFunction(aValue, bValue, -1, 1)
+}
+}

package/src/compact.js

@@ -0,0 +1,12 @@
+import { isArray } from './_internals/isArray.js'
+import { reject } from './reject.js'
+import { rejectObject } from './rejectObject.js'
+
+const isNullOrUndefined = x => x === null || x === undefined
+
+export function compact(input){
+	if(isArray(input)){
+		return reject(isNullOrUndefined)(input)
+	}
+	return rejectObject(isNullOrUndefined)(input)
+}

package/src/concat.js

@@ -1,3 +1,3 @@
 export function concat(x) {
-  return y => typeof x === 'string' ? `${x}${y}` : [...x, ...y]
+  return y => (typeof x === 'string' ? `${x}${y}` : [...x, ...y])
 }

package/src/count.js

@@ -1,11 +1,11 @@
 import { isArray } from './_internals/isArray.js'
 
-export function count(predicate, ) {
- return list => {
-  if (!isArray(list)) {
-    return 0
-  }
+export function count(predicate) {
+  return list => {
+    if (!isArray(list)) {
+      return 0
+    }
 
-  return list.filter(x => predicate(x)).length
-}
+    return list.filter(x => predicate(x)).length
+  }
 }

package/src/countBy.js

@@ -1,16 +1,16 @@
 export function countBy(fn) {
-	return list => {
-  const willReturn = {}
+  return list => {
+    const willReturn = {}
 
-  list.forEach(item => {
-    const key = fn(item)
-    if (!willReturn[key]) {
-      willReturn[key] = 1
-    } else {
-      willReturn[key]++
-    }
-  })
+    list.forEach(item => {
+      const key = fn(item)
+      if (!willReturn[key]) {
+        willReturn[key] = 1
+      } else {
+        willReturn[key]++
+      }
+    })
 
-  return willReturn
-}
+    return willReturn
+  }
 }

package/src/createObjectFromKeys.js

@@ -0,0 +1,10 @@
+export function createObjectFromKeys(keys) {
+	return fn => {
+		const result = {}
+		keys.forEach((key, index) => {
+			result[key] = fn(key, index)
+		})
+
+		return result
+	}
+}

package/src/defaultTo.js

@@ -2,10 +2,6 @@ function isFalsy(input) {
   return input === undefined || input === null || Number.isNaN(input) === true
 }
 
-export function defaultTo(defaultArgument, input) {
-  if (arguments.length === 1) {
-    return _input => defaultTo(defaultArgument, _input)
-  }
-
-  return isFalsy(input) ? defaultArgument : input
+export function defaultTo(defaultArgument) {
+  return input => isFalsy(input) ? defaultArgument : input
 }

package/src/descend.js

@@ -0,0 +1,10 @@
+import { createCompareFunction } from './ascend.js'
+
+export function descend(getFunction) {
+  return (a, b) => {
+    const aValue = getFunction(a)
+    const bValue = getFunction(b)
+
+    return createCompareFunction(aValue, bValue, 1, -1)
+  }
+}

package/src/drop.js

@@ -1,7 +1,3 @@
-export function drop(howManyToDrop, listOrString) {
-  if (arguments.length === 1) {
-    return _list => drop(howManyToDrop, _list)
-  }
-
-  return listOrString.slice(howManyToDrop > 0 ? howManyToDrop : 0)
+export function drop(howManyToDrop, ) {
+  return list => list.slice(howManyToDrop > 0 ? howManyToDrop : 0)
 }

package/src/dropLast.js

@@ -1,5 +1,3 @@
 export function dropLast(numberItems) {
-	return list => numberItems > 0
-    ? list.slice(0, -numberItems)
-    : list.slice()
+  return list => (numberItems > 0 ? list.slice(0, -numberItems) : list.slice())
 }

package/src/eqProps.js

@@ -1,6 +1,5 @@
 import { equalsFn } from './equals.js'
-import { prop } from './prop.js'
 
 export function eqProps(property, objA) {
-  return objB => equalsFn(prop(property)(objA), prop(property)(objB))
+  return objB => equalsFn( objA[property], objB[property] )
 }

package/src/equals.js

@@ -98,7 +98,7 @@ function parseRegex(maybeRegex) {
 }
 
 export function equalsFn(a, b) {
-	if (Object.is(a, b)) {
+  if (Object.is(a, b)) {
     return true
   }
 
@@ -207,5 +207,5 @@ export function equalsFn(a, b) {
   return false
 }
 export function equals(a) {
-	return b => equalsFn(a, b)
+  return b => equalsFn(a, b)
 }

package/src/evolve.js

@@ -1,27 +1,6 @@
 import { mapObject } from './mapObject.js'
 import { type } from './type.js'
 
-export function evolveFn(rules, obj) {
-    return mapObject((x, prop) => {
-      if (type(x) === 'Object') {
-        const typeRule = type(rules[prop])
-        if (typeRule === 'Function') {
-          return rules[prop](x)
-        }
-        if (typeRule === 'Object') {
-          return evolveFn(rules[prop], x)
-        }
-
-        return x
-      }
-      if (type(rules[prop]) === 'Function') {
-        return rules[prop](x)
-      }
-
-      return x
-    })(obj)
-}
-
 export function evolve(rules) {
-  return obj =>	evolveFn(rules, obj)
-		}
+  return mapObject((x, prop) => type(rules[prop]) === 'Function' ? rules[prop](x): x)
+}

package/src/filter.js

@@ -1,20 +1,20 @@
 export function filter(predicate) {
-	return list => {
-  if (!list) {
-    throw new Error('Incorrect iterable input')
-  }
-	let index = 0
-  const len = list.length
-  const willReturn = []
+  return list => {
+    if (!list) {
+      throw new Error('Incorrect iterable input')
+    }
+    let index = 0
+    const len = list.length
+    const willReturn = []
+
+    while (index < len) {
+      if (predicate(list[index], index)) {
+        willReturn.push(list[index])
+      }
 
-  while (index < len) {
-    if (predicate(list[index], index)) {
-      willReturn.push(list[index])
+      index++
     }
 
-    index++
+    return willReturn
   }
-	
-  return willReturn
-	}
 }

package/src/find.js

@@ -1,15 +1,15 @@
 export function find(predicate) {
-	return list => {
-  let index = 0
-  const len = list.length
+  return list => {
+    let index = 0
+    const len = list.length
 
-  while (index < len) {
-    const x = list[index]
-    if (predicate(x)) {
-      return x
-    }
+    while (index < len) {
+      const x = list[index]
+      if (predicate(x)) {
+        return x
+      }
 
-    index++
+      index++
+    }
   }
 }
-}

package/src/findIndex.js

@@ -1,14 +1,14 @@
 export function findIndex(predicate) {
-	return list => {
-  const len = list.length
-  let index = -1
+  return list => {
+    const len = list.length
+    let index = -1
 
-  while (++index < len) {
-    if (predicate(list[index])) {
-      return index
+    while (++index < len) {
+      if (predicate(list[index])) {
+        return index
+      }
     }
-  }
 
-  return -1
-}
+    return -1
+  }
 }

package/src/findLast.js

@@ -1,13 +1,13 @@
 export function findLast(predicate) {
-	return list => {
-  let index = list.length
+  return list => {
+    let index = list.length
 
-  while (--index >= 0) {
-    if (predicate(list[index])) {
-      return list[index]
+    while (--index >= 0) {
+      if (predicate(list[index])) {
+        return list[index]
+      }
     }
-  }
 
-  return undefined
-}
+    return undefined
+  }
 }

package/src/findLastIndex.js

@@ -1,13 +1,13 @@
 export function findLastIndex(fn) {
-	return list => {
-  let index = list.length
+  return list => {
+    let index = list.length
 
-  while (--index >= 0) {
-    if (fn(list[index])) {
-      return index
+    while (--index >= 0) {
+      if (fn(list[index])) {
+        return index
+      }
     }
-  }
 
-  return -1
-}
+    return -1
+  }
 }

package/src/findNth.js

@@ -0,0 +1,16 @@
+export function findNth(predicate, nth) {
+  return list => {
+    let index = 0
+    const len = list.length
+
+    while (index < len) {
+      const x = list[index]
+      if (predicate(x)) {
+				if (nth === 0) return x
+				nth--
+      }
+
+      index++
+    }
+  }
+}

package/src/flattenObject.js

@@ -0,0 +1,76 @@
+import { type } from './type.js'
+
+export function flattenObjectHelper(obj, accumulator = []){
+  const willReturn = {}
+  Object.keys(obj).forEach(key => {
+    const typeIs = type(obj[ key ])
+    if (typeIs === 'Object'){
+      const [ flatResultValue, flatResultPath ] = flattenObjectHelper(obj[ key ],
+        [ ...accumulator, key ])
+      willReturn[ flatResultPath.join('.') ] = flatResultValue
+
+      return
+    } else if (accumulator.length > 0){
+      const finalKey = [ ...accumulator, key ].join('.')
+      willReturn[ finalKey ] = obj[ key ]
+
+      return
+    }
+    willReturn[ key ] = obj[ key ]
+  })
+  if (accumulator.length > 0) return [ willReturn, accumulator ]
+
+  return willReturn
+}
+
+export function transformFlatObject(obj){
+  const willReturn = {}
+
+  const transformFlatObjectFn = objLocal => {
+    const willReturnLocal = {}
+    Object.keys(objLocal).forEach(key => {
+      const typeIs = type(objLocal[ key ])
+      if (typeIs === 'Object'){
+        transformFlatObjectFn(objLocal[ key ])
+
+        return
+      }
+      willReturnLocal[ key ] = objLocal[ key ]
+      willReturn[ key ] = objLocal[ key ]
+    })
+
+    return willReturnLocal
+  }
+
+  Object.keys(obj).forEach(key => {
+    const typeIs = type(obj[ key ])
+    if (typeIs === 'Object'){
+      transformFlatObjectFn(obj[ key ], key)
+
+      return
+    }
+    willReturn[ key ] = obj[ key ]
+  })
+
+  return willReturn
+}
+
+export function flattenObject(obj){
+  const willReturn = {}
+
+  Object.keys(obj).forEach(key => {
+    const typeIs = type(obj[ key ])
+    if (typeIs === 'Object'){
+      const flatObject = flattenObjectHelper(obj[ key ])
+      const transformed = transformFlatObject(flatObject)
+
+      Object.keys(transformed).forEach(keyTransformed => {
+        willReturn[ `${ key }.${ keyTransformed }` ] = transformed[ keyTransformed ]
+      })
+    } else {
+      willReturn[ key ] = obj[ key ]
+    }
+  })
+
+  return willReturn
+}

package/src/groupBy.js

@@ -1,19 +1,20 @@
-export function groupBy(groupFn, list) {
-  if (arguments.length === 1) {
-    return _list => groupBy(groupFn, _list)
-  }
+export function groupByFallback(groupFn, list) {
+    const result = {}
+    for (let i = 0; i < list.length; i++) {
+      const item = list[i]
+      const key = groupFn(item)
 
-  const result = {}
-  for (let i = 0; i < list.length; i++) {
-    const item = list[i]
-    const key = groupFn(item)
+      if (!result[key]) {
+        result[key] = []
+      }
 
-    if (!result[key]) {
-      result[key] = []
+      result[key].push(item)
     }
 
-    result[key].push(item)
-  }
+    return result
+}
+
 
-  return result
+export function groupBy(groupFn) {
+  return iterable => Object.groupBy ? Object.groupBy(iterable,groupFn) : groupByFallback(groupFn, iterable)
 }