rambda 10.0.1 → 10.1.0

package/index.d.ts

@@ -206,6 +206,11 @@ export function append<T>(el: T): (list: readonly T[]) => T[];
  */
 export function ascend<T>(fn: (obj: T) => Ord): (a: T, b: T)=> Ordering;
 
+/**
+ * It helps to make sure that input is from specific type. Similar to `R.convertToType`, but it actually checks the type of the input value. If `fn` input returns falsy value, then the function will throw an error.
+ */
+export function assertType<T, U extends T>(fn: (x: T) => x is U) : (x: T) => U;
+
 /**
  * It returns `true` if all each property in `conditions` returns `true` when applied to corresponding property in `input` object.
  */
@@ -235,6 +240,12 @@ export function complement<T extends any[]>(predicate: (...args: T) => unknown):
 export function concat<T>(x: T[]): (y: T[]) => T[];
 export function concat(x: string): (y: string) => string;
 
+/**
+ * It helps to convert a value to a specific type.
+ * It is useful when you have to overcome TypeScript's type inference.
+ */
+export function convertToType<T>(x: unknown) : T;
+
 /**
  * It counts how many times `predicate` function returns `true`, when supplied with iteration of `list`.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rambda",
-  "version": "10.0.1",
+  "version": "10.1.0",
   "scripts": {
     "out": "yarn populatedocs && yarn populatereadme && yarn build && yarn create-docsify",
     "build": "yarn build:main && yarn build:web && yarn build:esm",
@@ -28,7 +28,7 @@
   "type": "module",
   "exports": {
     "require": {
-      "types": "./index.d.ts",
+      "types": "./index.d.cts",
       "default": "./dist/rambda.cjs"
     },
     "types": "./index.d.ts",
@@ -95,9 +95,10 @@
     "src",
     "CHANGELOG.md",
     "index.d.ts",
+    "index.d.cts",
     "rambda.js"
   ],
   "sideEffects": false,
   "umd": "./dist/rambda.umd.js",
-  "types": "./index.d.ts"
+  "types": "./index.d.cts"
 }

package/rambda.js

@@ -7,10 +7,12 @@ export * from './src/any.js'
 export * from './src/anyPass.js'
 export * from './src/append.js'
 export * from './src/ascend.js'
+export * from './src/assertType.js'
 export * from './src/checkObjectWithSpec.js'
 export * from './src/compact.js'
 export * from './src/complement.js'
 export * from './src/concat.js'
+export * from './src/convertToType.js'
 export * from './src/count.js'
 export * from './src/countBy.js'
 export * from './src/createObjectFromKeys.js'

package/src/assertType.js

@@ -0,0 +1,8 @@
+export function assertType(fn) {
+  return (x) => {
+    if (fn(x)) {
+      return x
+    }
+    throw new Error('type assertion failed in R.assertType')
+  }
+}

package/src/convertToType.js

@@ -0,0 +1,3 @@
+export function convertToType(x) {
+  return x
+}