rambda 10.0.0-beta.1 → 10.0.0

package/package.json

@@ -1,13 +1,12 @@
 {
   "name": "rambda",
-  "version": "10.0.0-beta.1",
+  "version": "10.0.0",
   "scripts": {
-    "out": "yarn populatedocs && yarn populatereadme && yarn immutable && yarn build && yarn create-docsify",
+    "out": "yarn populatedocs && yarn populatereadme && yarn build && yarn create-docsify",
     "build": "yarn build:main && yarn build:web && yarn build:esm",
     "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",
     "populatedocs": "cd ../rambda-scripts && yarn populate:docs",
     "populatereadme": "cd ../rambda-scripts && yarn populate:readme",
     "lint": "cd source && run lint:folder > lint-output.txt",
@@ -27,10 +26,12 @@
   ],
   "type": "module",
   "exports": {
-    ".": {
-      "import": "./dist/rambda.js",
-      "require": "./dist/rambda.cjs"
-    }
+    "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",
@@ -82,8 +83,6 @@
     "ts",
     "types",
     "typescript",
-    "underscore",
-    "util",
     "utilities",
     "utility",
     "utils"
@@ -94,9 +93,7 @@
     "src",
     "CHANGELOG.md",
     "index.d.ts",
-    "immutable.d.ts",
-    "rambda.js",
-    "immutable.js"
+    "rambda.js"
   ],
   "sideEffects": false,
   "umd": "./dist/rambda.umd.js",

package/rambda.js

@@ -1,5 +1,6 @@
 /// <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'
@@ -33,6 +34,7 @@ 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'
@@ -56,6 +58,7 @@ export * from './src/maxBy.js'
 export * from './src/merge.js'
 export * from './src/mergeTypes.js'
 export * from './src/minBy.js'
+export * from './src/modifyItemAtIndex.js'
 export * from './src/modifyProp.js'
 export * from './src/none.js'
 export * from './src/objOf.js'
@@ -64,6 +67,7 @@ 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'
@@ -79,10 +83,12 @@ 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'

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/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/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/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/map.js

@@ -1,11 +1,15 @@
+export function mapFn(
+	fn, list
+){
+	let index = 0
+	const willReturn = Array(list.length)
+	while (index < list.length) {
+		willReturn[index] = fn(list[index], index)
+		index++
+	}
+	return willReturn
+}
+
 export function map(fn) {
-  return list => {
-    let index = 0
-    const willReturn = Array(list.length)
-    while (index < list.length) {
-      willReturn[index] = fn(list[index], index)
-      index++
-    }
-    return willReturn
-  }
+  return list => mapFn(fn, list)
 }

package/src/{replaceItemAtIndex.js → modifyItemAtIndex.js}

@@ -1,6 +1,6 @@
 import { cloneList } from './_internals/cloneList.js'
 
-export function replaceItemAtIndex(index, replaceFn) {
+export function modifyItemAtIndex(index, replaceFn) {
   return list => {
     const actualIndex = index < 0 ? list.length + index : index
     if (index >= list.length || actualIndex < 0) {

package/src/path.js

@@ -1,29 +1,27 @@
 import { createPath } from './_internals/createPath.js'
 
-export function path(pathInput, obj) {
-  if (arguments.length === 1) {
-    return _obj => path(pathInput, _obj)
-  }
-
-  if (!obj) {
-    return undefined
-  }
-  let willReturn = obj
-  let counter = 0
-
-  const pathArrValue = createPath(pathInput)
-
-  while (counter < pathArrValue.length) {
-    if (willReturn === null || willReturn === undefined) {
-      return undefined
-    }
-    if (willReturn[pathArrValue[counter]] === null) {
-      return undefined
-    }
-
-    willReturn = willReturn[pathArrValue[counter]]
-    counter++
-  }
-
-  return willReturn
+export function path(pathInput) {
+	return (obj)  => {
+		if (!obj) {
+			return undefined
+		}
+		let willReturn = obj
+		let counter = 0
+	
+		const pathArrValue = createPath(pathInput)
+	
+		while (counter < pathArrValue.length) {
+			if (willReturn === null || willReturn === undefined) {
+				return undefined
+			}
+			if (willReturn[pathArrValue[counter]] === null) {
+				return undefined
+			}
+	
+			willReturn = willReturn[pathArrValue[counter]]
+			counter++
+		}
+	
+		return willReturn
+	}
 }

package/src/pathSatisfies.js

@@ -0,0 +1,5 @@
+import { path } from './path.js'
+
+export function pathSatisfies(fn, pathInput) {
+  return obj => Boolean(fn(path(pathInput)(obj)))
+}

package/src/propOr.js

@@ -6,6 +6,6 @@ export function propOr(defaultValue, property) {
       return defaultValue
     }
 
-    return defaultTo(defaultValue, obj[property])
+    return defaultTo(defaultValue)(obj[property])
   }
 }

package/src/range.js

@@ -1,17 +1,29 @@
+function rangeDescending(start, end) {
+	const len = start - end
+	const willReturn = Array(len)
+
+	for (let i = 0; i < len; i++) {
+		willReturn[i] = start - i
+	}
+
+	return willReturn
+}
+
 export function range(start) {
   return end => {
     if (Number.isNaN(Number(start)) || Number.isNaN(Number(end))) {
       throw new TypeError('Both arguments to range must be numbers')
     }
 
-    if (end <= start) {
+    if (end === start) {
       return []
     }
+		if (end < start) return rangeDescending(start,end)
 
     const len = end - start
     const willReturn = Array(len)
 
-    for (let i = 0; i < len + 1; i++) {
+    for (let i = 0; i < len; i++) {
       willReturn[i] = start + i
     }
 
@@ -19,23 +31,4 @@ export function range(start) {
   }
 }
 
-export function rangeDescending(start) {
-  return end => {
-    if (Number.isNaN(Number(start)) || Number.isNaN(Number(end))) {
-      throw new TypeError('Both arguments to range must be numbers')
-    }
-
-    if (end >= start) {
-      return []
-    }
 
-    const len = start - end
-    const willReturn = Array(len)
-
-    for (let i = 0; i < len + 1; i++) {
-      willReturn[i] = start - i
-    }
-
-    return willReturn
-  }
-}

package/src/shuffle.js

@@ -1,3 +1,5 @@
+import { cloneList } from './_internals/cloneList.js'
+
 export function shuffle(listInput) {
   const list = cloneList(listInput)
   let counter = list.length

package/src/sortBy.js

@@ -1,18 +1,27 @@
 import { cloneList } from './_internals/cloneList.js'
 
-export function sortBy(sortFn) {
-  return list => {
-    const clone = cloneList(list)
+export function sortByFn (
+	sortFn,
+	list,
+	descending
+){
+	const clone = cloneList(list)
+
+	return clone.sort((a, b) => {
+		const aSortResult = sortFn(a)
+		const bSortResult = sortFn(b)
 
-    return clone.sort((a, b) => {
-      const aSortResult = sortFn(a)
-      const bSortResult = sortFn(b)
+		if (aSortResult === bSortResult) {
+			return 0
+		}
+		if(
+			descending
+		) return aSortResult > bSortResult ? -1 : 1
 
-      if (aSortResult === bSortResult) {
-        return 0
-      }
+		return aSortResult < bSortResult ? -1 : 1
+	})
+}
 
-      return aSortResult < bSortResult ? -1 : 1
-    })
-  }
+export function sortBy(sortFn) {
+  return list => sortByFn(sortFn, list, false)
 }

package/src/sortByDescending.js

@@ -0,0 +1,5 @@
+import { sortByFn } from "./sortBy.js";
+
+export function sortByDescending(sortFn) {
+  return list => sortByFn(sortFn, list, true)
+}

package/src/sortByPath.js

@@ -0,0 +1,6 @@
+import { path } from './path.js'
+import { sortBy } from './sortBy.js'
+
+export function sortByPath(sortPath) {
+  return list => sortBy(path(sortPath))(list)
+}

package/src/sortByPathDescending.js

@@ -0,0 +1,6 @@
+import { path } from './path.js'
+import { sortByDescending } from './sortByDescending.js'
+
+export function sortByPathDescending(sortPath) {
+  return list => sortByDescending(path(sortPath))(list)
+}