vest-utils 0.0.2-rc → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +5 -0
  3. package/dist/cjs/package.json +1 -0
  4. package/dist/cjs/vest-utils.development.js +342 -0
  5. package/dist/cjs/vest-utils.js +7 -0
  6. package/dist/cjs/vest-utils.production.js +1 -0
  7. package/dist/es/package.json +1 -0
  8. package/dist/es/vest-utils.development.js +299 -0
  9. package/dist/es/vest-utils.production.js +1 -0
  10. package/dist/umd/vest-utils.development.js +348 -0
  11. package/dist/umd/vest-utils.production.js +1 -0
  12. package/package.json +4 -662
  13. package/src/__tests__/bindNot.test.ts +37 -0
  14. package/src/__tests__/bus.test.ts +81 -0
  15. package/src/__tests__/cache.test.ts +113 -0
  16. package/src/__tests__/defaultTo.test.ts +50 -0
  17. package/src/__tests__/deferThrow.test.ts +24 -0
  18. package/src/__tests__/greaterThan.test.ts +59 -0
  19. package/src/__tests__/invariant.test.ts +45 -0
  20. package/src/__tests__/isArray.test.ts +15 -0
  21. package/src/__tests__/isNull.test.ts +25 -0
  22. package/src/__tests__/isNumeric.test.ts +26 -0
  23. package/src/__tests__/isUndefined.test.ts +26 -0
  24. package/src/__tests__/lengthEquals.test.ts +56 -0
  25. package/src/__tests__/longerThan.test.ts +56 -0
  26. package/src/__tests__/mapFirst.test.ts +29 -0
  27. package/src/__tests__/numberEquals.test.ts +59 -0
  28. package/src/__tests__/optionalFunctionValue.test.ts +27 -0
  29. package/src/__tests__/seq.test.ts +12 -0
  30. package/src/asArray.ts +3 -0
  31. package/src/assign.ts +1 -0
  32. package/src/bindNot.ts +3 -0
  33. package/src/bus.ts +32 -0
  34. package/src/cache.ts +49 -0
  35. package/src/callEach.ts +5 -0
  36. package/src/defaultTo.ts +8 -0
  37. package/src/deferThrow.ts +5 -0
  38. package/src/either.ts +3 -0
  39. package/src/globals.d.ts +3 -0
  40. package/src/greaterThan.ts +8 -0
  41. package/src/hasOwnProperty.ts +9 -0
  42. package/src/invariant.ts +24 -0
  43. package/src/isArrayValue.ts +11 -0
  44. package/src/isBooleanValue.ts +3 -0
  45. package/src/isEmpty.ts +17 -0
  46. package/src/isFunction.ts +5 -0
  47. package/src/isNull.ts +7 -0
  48. package/src/isNullish.ts +9 -0
  49. package/src/isNumeric.ts +11 -0
  50. package/src/isPositive.ts +5 -0
  51. package/src/isPromise.ts +5 -0
  52. package/src/isStringValue.ts +3 -0
  53. package/src/isUndefined.ts +7 -0
  54. package/src/last.ts +7 -0
  55. package/src/lengthEquals.ts +11 -0
  56. package/src/longerThan.ts +8 -0
  57. package/src/mapFirst.ts +25 -0
  58. package/src/nestedArray.ts +69 -0
  59. package/src/numberEquals.ts +11 -0
  60. package/src/optionalFunctionValue.ts +8 -0
  61. package/src/seq.ts +10 -0
  62. package/src/utilityTypes.ts +9 -0
  63. package/src/vest-utils.ts +31 -0
  64. package/tsconfig.json +3 -1
  65. package/types/vest-utils.d.ts +92 -0
@@ -0,0 +1,92 @@
1
+ /**
2
+ * Creates a cache function
3
+ */
4
+ declare function createCache(maxSize?: number): {
5
+ <T>(deps: unknown[], cacheAction: (...args: unknown[]) => T): T;
6
+ get(deps: unknown[]): any;
7
+ invalidate(item: any): void;
8
+ };
9
+ declare function isNullish(value: any): value is null | undefined;
10
+ declare const isNotNullish: (value: any) => boolean;
11
+ declare namespace nestedArray {
12
+ type NestedArray<T> = Array<NestedArray<T> | T>;
13
+ // This is kind of a map/filter in one function.
14
+ // Normally, behaves like a nested-array map,
15
+ // but returning `null` will drop the element from the array
16
+ function transform<T>(array: NestedArray<T>, cb: (value: T) => NestedArray<T> | T | null): NestedArray<T>;
17
+ function valueAtPath<T>(array: NestedArray<T>, path: number[]): T | NestedArray<T>;
18
+ function setValueAtPath<T>(array: NestedArray<T>, path: number[], value: NestedArray<T> | T): NestedArray<T>;
19
+ function flatten<T>(values: NestedArray<T> | T): T[];
20
+ function getCurrent<T>(array: NestedArray<T>, path: number[]): NestedArray<T>;
21
+ }
22
+ declare function asArray<T>(possibleArg: T | T[]): T[];
23
+ type Stringable = string | ((...args: any[]) => string);
24
+ type CB = (...args: any[]) => any;
25
+ declare function callEach(arr: CB[]): void;
26
+ /**
27
+ * A safe hasOwnProperty access
28
+ */
29
+ declare function hasOwnProperty<T>(obj: T, key: string | number | symbol): key is keyof T;
30
+ declare function isPromise(value: any): value is Promise<unknown>;
31
+ declare function optionalFunctionValue<T>(value: T | ((...args: any[]) => T), ...args: unknown[]): T;
32
+ declare const _default: {
33
+ <T extends {}, U>(target: T, source: U): T & U;
34
+ <T_1 extends {}, U_1, V>(target: T_1, source1: U_1, source2: V): T_1 & U_1 & V;
35
+ <T_2 extends {}, U_2, V_1, W>(target: T_2, source1: U_2, source2: V_1, source3: W): T_2 & U_2 & V_1 & W;
36
+ (target: object, ...sources: any[]): any;
37
+ };
38
+ declare function defaultTo<T>(value: T | ((...args: any[]) => T), defaultValue: T | (() => T)): T;
39
+ declare function invariant(condition: any,
40
+ // eslint-disable-next-line @typescript-eslint/ban-types
41
+ message?: String | Stringable): asserts condition;
42
+ // eslint-disable-next-line @typescript-eslint/ban-types
43
+ declare function StringObject(value?: Stringable): String;
44
+ declare function isStringValue(v: unknown): v is string;
45
+ declare function bindNot<T extends (...args: any[]) => unknown>(fn: T): (...args: Parameters<T>) => boolean;
46
+ declare function either(a: unknown, b: unknown): boolean;
47
+ declare function isBoolean(value: unknown): value is boolean;
48
+ declare function last<T>(values: T | T[]): T;
49
+ declare function deferThrow(message?: string): void;
50
+ declare namespace bus {
51
+ type DropFirst<T extends unknown[]> = T extends [
52
+ unknown,
53
+ ...infer U
54
+ ] ? U : never;
55
+ type Stringable = string | ((...args: any[]) => string);
56
+ type CB = (...args: any[]) => any;
57
+ type ValueOf<T> = T[keyof T];
58
+ function createBus(): {
59
+ on: (event: string, handler: CB) => OnReturn;
60
+ emit: (event: string, ...args: any[]) => void;
61
+ };
62
+ type OnReturn = {
63
+ off: () => void;
64
+ };
65
+ }
66
+ /**
67
+ * @returns a unique numeric id.
68
+ */
69
+ declare const seq: () => string;
70
+ declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
71
+ declare function mapFirst<T>(array: T[], callback: (item: T, breakout: (conditional: boolean, value: unknown) => void, index: number) => unknown): any;
72
+ declare function greaterThan(value: number | string, gt: number | string): boolean;
73
+ declare function longerThan(value: string | unknown[], arg1: string | number): boolean;
74
+ declare function isNumeric(value: string | number): boolean;
75
+ declare const isNotNumeric: (value: string | number) => boolean;
76
+ declare function lengthEquals(value: string | unknown[], arg1: string | number): boolean;
77
+ declare const lengthNotEquals: (value: string | unknown[], arg1: string | number) => boolean;
78
+ declare function numberEquals(value: string | number, eq: string | number): boolean;
79
+ declare const numberNotEquals: (value: string | number, eq: string | number) => boolean;
80
+ declare function isNull(value: unknown): value is null;
81
+ declare const isNotNull: (value: unknown) => boolean;
82
+ declare function isUndefined(value?: unknown): value is undefined;
83
+ declare const isNotUndefined: (value?: unknown) => boolean;
84
+ // The module is named "isArrayValue" since it
85
+ // is conflicting with a nested npm dependency.
86
+ // We may need to revisit this in the future.
87
+ declare function isArray(value: unknown): value is Array<unknown>;
88
+ declare const isNotArray: (value: unknown) => boolean;
89
+ declare function isEmpty(value: unknown): boolean;
90
+ declare const isNotEmpty: (value: unknown) => boolean;
91
+ declare function isPositive(value: number | string): boolean;
92
+ export { createCache as cache, isNullish, isNotNullish, nestedArray, asArray, callEach, hasOwnProperty, isPromise, optionalFunctionValue, _default as assign, defaultTo, invariant, StringObject, isStringValue, bindNot, either, isBoolean, last, deferThrow, bus, seq, isFunction, mapFirst, greaterThan, longerThan, isNumeric, isNotNumeric, lengthEquals, lengthNotEquals, numberEquals, numberNotEquals, isNull, isNotNull, isUndefined, isNotUndefined, isArray, isNotArray, isEmpty, isNotEmpty, isPositive };