extra-utils 5.15.0 → 5.17.0

package/README.md

@@ -87,6 +87,28 @@ function remap(
 , [newMin, newMax]: readonly [newMin: number, newMax: number]
 ): number
 
+function remapToItem<T>(
+  value: number
+, range: readonly [min: number, max: number]
+, items: NonEmptyArray<T>
+): T
+
+interface IWeightedItem {
+  weight: number
+}
+
+function remapToWeightedItem<T>(
+  value: number
+, range: readonly [min: number, max: number]
+, items: NonEmptyArray<T>
+, weights: NonEmptyArray<number>
+): T
+function remapToWeightedItem<T extends IWeightedItem>(
+  value: number
+, range: readonly [min: number, max: number]
+, items: NonEmptyArray<T>
+): T
+
 function remapToIndex(
   value: number
 , range: readonly [min: number, max: number]
@@ -277,15 +299,15 @@ function isSymbol(val: unknown): val is symbol
 function isntSymbol<T>(val: T): val is Exclude<T, symbol>
 ```
 
-### Reducers
+### Functional programming
+#### not
 ```ts
-function max(result: number, current: number): number
-function min(result: number, current: number): number
-function sum(result: number, current: number): number
-function product(result: number, current: number): number
+function not<Args extends unknown[]>(
+  predicate: (...args: Args) => boolean
+): (...args: Args) => boolean
 ```
 
-### pipe
+#### pipe
 ```ts
 function pipe<A, B, C, D, E, F, G, H>(
   value: A
@@ -356,7 +378,7 @@ function pipe<T, U>(
 ): U
 ```
 
-### pipeAsync
+#### pipeAsync
 ```ts
 function pipeAsync<A, B, C, D, E, F, G, H>(
   value: Awaitable<A>
@@ -426,3 +448,11 @@ function pipeAsync<T, U>(
 , ...operators: Array<(value: any) => Awaitable<unknown>>
 ): Promise<U>
 ```
+
+#### Reducers
+```ts
+function max(result: number, current: number): number
+function min(result: number, current: number): number
+function sum(result: number, current: number): number
+function product(result: number, current: number): number
+```

package/lib/fp/index.d.ts

@@ -0,0 +1,4 @@
+export * from './reducers/index.js';
+export * from './not.js';
+export * from './pipe.js';
+export * from './pipe-async.js';

package/lib/fp/index.js

@@ -0,0 +1,5 @@
+export * from './reducers/index.js';
+export * from './not.js';
+export * from './pipe.js';
+export * from './pipe-async.js';
+//# sourceMappingURL=index.js.map

package/lib/fp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fp/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA"}

package/lib/fp/not.d.ts

@@ -0,0 +1 @@
+export declare function not<Args extends unknown[]>(predicate: (...args: Args) => boolean): (...args: Args) => boolean;

package/lib/fp/not.js

@@ -0,0 +1,4 @@
+export function not(predicate) {
+    return (...args) => !predicate(...args);
+}
+//# sourceMappingURL=not.js.map

package/lib/fp/not.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"not.js","sourceRoot":"","sources":["../../src/fp/not.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CACjB,SAAqC;IAErC,OAAO,CAAC,GAAG,IAAU,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAA;AAC/C,CAAC"}

package/lib/fp/pipe-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe-async.js","sourceRoot":"","sources":["../../src/fp/pipe-async.ts"],"names":[],"mappings":"AAqEA,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAmB,EACnB,GAAG,SAAyC;IAE5C,IAAI,MAAM,GAAU,MAAM,KAAK,CAAA;IAC/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;QAChC,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;KAChC;IACD,OAAO,MAAW,CAAA;AACpB,CAAC"}

package/lib/fp/pipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../../src/fp/pipe.ts"],"names":[],"mappings":"AAmEA,MAAM,UAAU,IAAI,CAClB,KAAQ,EACR,GAAG,SAAyC;IAE5C,IAAI,MAAM,GAAU,KAAK,CAAA;IACzB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;QAChC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;KAC1B;IACD,OAAO,MAAW,CAAA;AACpB,CAAC"}

package/lib/fp/reducers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fp/reducers/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA"}

package/lib/fp/reducers/max.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"max.js","sourceRoot":"","sources":["../../../src/fp/reducers/max.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe;IACjD,OAAO,OAAO,GAAG,MAAM;QAClB,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,MAAM,CAAA;AACf,CAAC"}

package/lib/fp/reducers/min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"min.js","sourceRoot":"","sources":["../../../src/fp/reducers/min.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe;IACjD,OAAO,OAAO,GAAG,MAAM;QAClB,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,MAAM,CAAA;AACf,CAAC"}

package/lib/fp/reducers/product.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"product.js","sourceRoot":"","sources":["../../../src/fp/reducers/product.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,OAAe;IACrD,OAAO,MAAM,GAAG,OAAO,CAAA;AACzB,CAAC"}

package/lib/fp/reducers/sum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sum.js","sourceRoot":"","sources":["../../../src/fp/reducers/sum.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe;IACjD,OAAO,MAAM,GAAG,OAAO,CAAA;AACzB,CAAC"}

package/lib/index.d.ts

@@ -11,6 +11,4 @@ export * from './is-regexp.js';
 export * from './is-symbol.js';
 export * from './is-date.js';
 export * from './is-function.js';
-export * from './reducers/index.js';
-export * from './pipe.js';
-export * from './pipe-async.js';
+export * from './fp/index.js';

package/lib/index.js

@@ -11,7 +11,5 @@ export * from './is-regexp.js';
 export * from './is-symbol.js';
 export * from './is-date.js';
 export * from './is-function.js';
-export * from './reducers/index.js';
-export * from './pipe.js';
-export * from './pipe-async.js';
+export * from './fp/index.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA"}

package/lib/number/index.d.ts

@@ -5,6 +5,8 @@ export * from './is-nan.js';
 export * from './is-number.js';
 export * from './clamp.js';
 export * from './remap.js';
+export * from './remap-to-item.js';
+export * from './remap-to-weighted-item.js';
 export * from './remap-to-index.js';
 export * from './remap-to-weighted-index.js';
 export * from './lerp.js';

package/lib/number/index.js

@@ -5,6 +5,8 @@ export * from './is-nan.js';
 export * from './is-number.js';
 export * from './clamp.js';
 export * from './remap.js';
+export * from './remap-to-item.js';
+export * from './remap-to-weighted-item.js';
 export * from './remap-to-index.js';
 export * from './remap-to-weighted-index.js';
 export * from './lerp.js';

package/lib/number/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/number/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,qBAAqB,CAAA;AACnC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/number/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,WAAW,CAAA"}

package/lib/number/remap-to-item.d.ts

@@ -0,0 +1,2 @@
+import { NonEmptyArray } from 'justypes';
+export declare function remapToItem<T>(value: number, range: readonly [min: number, max: number], items: NonEmptyArray<T>): T;

package/lib/number/remap-to-item.js

@@ -0,0 +1,6 @@
+import { remapToIndex } from './remap-to-index.js';
+export function remapToItem(value, range, items) {
+    const index = remapToIndex(value, range, items);
+    return items[index];
+}
+//# sourceMappingURL=remap-to-item.js.map

package/lib/number/remap-to-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remap-to-item.js","sourceRoot":"","sources":["../../src/number/remap-to-item.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,KAA0C,EAC1C,KAAuB;IAEvB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IAC/C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC"}

package/lib/number/remap-to-weighted-item.d.ts

@@ -0,0 +1,6 @@
+import { NonEmptyArray } from 'justypes';
+export interface IWeightedItem {
+    weight: number;
+}
+export declare function remapToWeightedItem<T>(value: number, range: readonly [min: number, max: number], items: NonEmptyArray<T>, weights: NonEmptyArray<number>): T;
+export declare function remapToWeightedItem<T extends IWeightedItem>(value: number, range: readonly [min: number, max: number], items: NonEmptyArray<T>): T;

package/lib/number/remap-to-weighted-item.js

@@ -0,0 +1,17 @@
+import { remapToWeightedIndex } from './remap-to-weighted-index.js';
+export function remapToWeightedItem(...args) {
+    let value;
+    let range;
+    let items;
+    let weights;
+    if (args.length === 3) {
+        [value, range, items] = args;
+        weights = items.map(item => item.weight);
+    }
+    else {
+        [value, range, items, weights] = args;
+    }
+    const index = remapToWeightedIndex(value, range, weights);
+    return items[index];
+}
+//# sourceMappingURL=remap-to-weighted-item.js.map

package/lib/number/remap-to-weighted-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remap-to-weighted-item.js","sourceRoot":"","sources":["../../src/number/remap-to-weighted-item.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAiBnE,MAAM,UAAU,mBAAmB,CAA0B,GAAG,IAW7D;IAED,IAAI,KAAa,CAAA;IACjB,IAAI,KAA0C,CAAA;IAC9C,IAAI,KAAuB,CAAA;IAC3B,IAAI,OAA8B,CAAA;IAElC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;QACrB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,CAAA;QAC5B,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAA0B,CAAA;KAClE;SAAM;QACL,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KACtC;IAED,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IACzD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "extra-utils",
-  "version": "5.15.0",
+  "version": "5.17.0",
   "description": "Utilities for JavaScript and Typescript",
   "files": [
     "src",

package/src/fp/index.ts

@@ -0,0 +1,4 @@
+export * from './reducers/index.js'
+export * from './not.js'
+export * from './pipe.js'
+export * from './pipe-async.js'

package/src/fp/not.ts

@@ -0,0 +1,5 @@
+export function not<Args extends unknown[]>(
+  predicate: (...args: Args) => boolean
+): (...args: Args) => boolean {
+  return (...args: Args) => !predicate(...args)
+}

package/src/index.ts

@@ -11,6 +11,4 @@ export * from './is-regexp.js'
 export * from './is-symbol.js'
 export * from './is-date.js'
 export * from './is-function.js'
-export * from './reducers/index.js'
-export * from './pipe.js'
-export * from './pipe-async.js'
+export * from './fp/index.js'

package/src/number/index.ts

@@ -5,6 +5,8 @@ export * from './is-nan.js'
 export * from './is-number.js'
 export * from './clamp.js'
 export * from './remap.js'
+export * from './remap-to-item.js'
+export * from './remap-to-weighted-item.js'
 export * from './remap-to-index.js'
 export * from './remap-to-weighted-index.js'
 export * from './lerp.js'

package/src/number/remap-to-item.ts

@@ -0,0 +1,11 @@
+import { NonEmptyArray } from 'justypes'
+import { remapToIndex } from './remap-to-index.js'
+
+export function remapToItem<T>(
+  value: number
+, range: readonly [min: number, max: number]
+, items: NonEmptyArray<T>
+): T {
+  const index = remapToIndex(value, range, items)
+  return items[index]
+}

package/src/number/remap-to-weighted-item.ts

@@ -0,0 +1,46 @@
+import { NonEmptyArray } from 'justypes'
+import { remapToWeightedIndex } from './remap-to-weighted-index.js'
+
+export interface IWeightedItem {
+  weight: number
+}
+
+export function remapToWeightedItem<T>(
+  value: number
+, range: readonly [min: number, max: number]
+, items: NonEmptyArray<T>
+, weights: NonEmptyArray<number>
+): T
+export function remapToWeightedItem<T extends IWeightedItem>(
+  value: number
+, range: readonly [min: number, max: number]
+, items: NonEmptyArray<T>
+): T
+export function remapToWeightedItem<T extends IWeightedItem>(...args:
+| [
+    value: number
+  , range: readonly [min: number, max: number]
+  , items: NonEmptyArray<T>
+  , weights: NonEmptyArray<number>
+  ]
+| [
+    value: number
+  , range: readonly [min: number, max: number]
+  , items: NonEmptyArray<T>
+  ]
+): T {
+  let value: number
+  let range: readonly [min: number, max: number]
+  let items: NonEmptyArray<T>
+  let weights: NonEmptyArray<number>
+
+  if (args.length === 3) {
+    [value, range, items] = args
+    weights = items.map(item => item.weight) as NonEmptyArray<number>
+  } else {
+    [value, range, items, weights] = args
+  }
+
+  const index = remapToWeightedIndex(value, range, weights)
+  return items[index]
+}

package/lib/pipe-async.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pipe-async.js","sourceRoot":"","sources":["../src/pipe-async.ts"],"names":[],"mappings":"AAqEA,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,KAAmB,EACnB,GAAG,SAAyC;IAE5C,IAAI,MAAM,GAAU,MAAM,KAAK,CAAA;IAC/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;QAChC,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAA;KAChC;IACD,OAAO,MAAW,CAAA;AACpB,CAAC"}

package/lib/pipe.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pipe.js","sourceRoot":"","sources":["../src/pipe.ts"],"names":[],"mappings":"AAmEA,MAAM,UAAU,IAAI,CAClB,KAAQ,EACR,GAAG,SAAyC;IAE5C,IAAI,MAAM,GAAU,KAAK,CAAA;IACzB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;QAChC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAA;KAC1B;IACD,OAAO,MAAW,CAAA;AACpB,CAAC"}

package/lib/reducers/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/reducers/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA"}

package/lib/reducers/max.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"max.js","sourceRoot":"","sources":["../../src/reducers/max.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe;IACjD,OAAO,OAAO,GAAG,MAAM;QAClB,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,MAAM,CAAA;AACf,CAAC"}

package/lib/reducers/min.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"min.js","sourceRoot":"","sources":["../../src/reducers/min.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe;IACjD,OAAO,OAAO,GAAG,MAAM;QAClB,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,MAAM,CAAA;AACf,CAAC"}

package/lib/reducers/product.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"product.js","sourceRoot":"","sources":["../../src/reducers/product.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,OAAe;IACrD,OAAO,MAAM,GAAG,OAAO,CAAA;AACzB,CAAC"}

package/lib/reducers/sum.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sum.js","sourceRoot":"","sources":["../../src/reducers/sum.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe;IACjD,OAAO,MAAM,GAAG,OAAO,CAAA;AACzB,CAAC"}