@noeldemartin/utils 0.7.0 → 0.7.1-next.0d36c8fed1ba2a01a88ca0fae01752b1cdee5f32
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.
- package/dist/noeldemartin-utils.d.ts +50 -10
- package/dist/noeldemartin-utils.js +509 -453
- package/dist/noeldemartin-utils.js.map +1 -1
- package/package.json +9 -3
- package/src/fluent/FluentArray.test.ts +3 -2
- package/src/fluent/FluentString.test.ts +3 -1
- package/src/fluent/index.test.ts +3 -1
- package/src/fluent/tap.test.ts +3 -2
- package/src/helpers/ListenersManager.test.ts +3 -1
- package/src/helpers/MagicObject.test.ts +2 -1
- package/src/helpers/array_helpers.test.ts +23 -3
- package/src/helpers/array_helpers.ts +20 -11
- package/src/helpers/caching_helpers.ts +32 -0
- package/src/helpers/env.ts +5 -5
- package/src/helpers/mixin_helpers.test.ts +3 -2
- package/src/helpers/object_helpers.test.ts +29 -1
- package/src/helpers/object_helpers.ts +34 -2
- package/src/helpers/time_helpers.ts +15 -12
- package/src/helpers/url_helpers.test.ts +8 -0
- package/src/helpers/url_helpers.ts +2 -1
- package/src/types/arrays.test.ts +3 -2
- package/src/types/arrays.ts +2 -0
- package/src/types/env.d.ts +2 -4
- package/src/types/helpers.test.ts +3 -2
- package/src/types/index.ts +1 -0
- package/src/types/objects.test.ts +79 -0
- package/src/types/objects.ts +51 -0
|
@@ -1,12 +1,16 @@
|
|
|
1
|
-
export declare function after(
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
s: number;
|
|
5
|
-
seconds: number;
|
|
6
|
-
}>): Promise<void>;
|
|
1
|
+
export declare function after(ms: number): Promise<void>;
|
|
2
|
+
|
|
3
|
+
export declare function after(options?: AfterOptions): Promise<void>;
|
|
7
4
|
|
|
8
5
|
export declare function afterAnimationFrame(): Promise<void>;
|
|
9
6
|
|
|
7
|
+
export declare interface AfterOptions {
|
|
8
|
+
ms?: number;
|
|
9
|
+
milliseconds?: number;
|
|
10
|
+
s?: number;
|
|
11
|
+
seconds?: number;
|
|
12
|
+
}
|
|
13
|
+
|
|
10
14
|
export declare function applyMixins<Base extends Constructor>(baseClass: Base, mixinClasses?: Constructor[]): void;
|
|
11
15
|
|
|
12
16
|
export declare function applyStrictChecks(): boolean;
|
|
@@ -21,6 +25,8 @@ export declare function arrayChunk<T>(items: T[], chunkSize: number): T[][];
|
|
|
21
25
|
|
|
22
26
|
export declare function arrayClear(items: unknown[]): void;
|
|
23
27
|
|
|
28
|
+
export declare type ArrayDeepItem<Array> = Array extends (infer TItem)[] ? ArrayDeepItem<TItem> : Array;
|
|
29
|
+
|
|
24
30
|
export declare function arrayDiff<T>(original: T[], updated: T[], compareValues?: (a: T, b: T) => boolean): {
|
|
25
31
|
added: T[];
|
|
26
32
|
removed: T[];
|
|
@@ -46,6 +52,8 @@ export declare function arrayGroupBy<TItem, TKey extends string>(items: TItem[],
|
|
|
46
52
|
|
|
47
53
|
export declare function arrayGroupBy<TItem, TKey extends keyof TItem>(items: TItem[], groupBy: TKey): Record<string, TItem[]>;
|
|
48
54
|
|
|
55
|
+
export declare type ArrayIncludes<Array extends unknown[], Item> = Item extends Array[number] ? true : false;
|
|
56
|
+
|
|
49
57
|
export declare function arrayIsEmpty(items: unknown[]): boolean;
|
|
50
58
|
|
|
51
59
|
export declare type ArrayItem<Array> = Array extends (infer Item)[] ? Item : never;
|
|
@@ -70,9 +78,9 @@ export declare function arraySorted<T>(items: T[], direction: 'asc' | 'desc'): T
|
|
|
70
78
|
|
|
71
79
|
export declare function arraySorted<T>(items: T[], compareValues: (a: T, b: T) => number): T[];
|
|
72
80
|
|
|
73
|
-
export declare function arraySorted<T>(items: T[], field:
|
|
81
|
+
export declare function arraySorted<T>(items: T[], field: DeepKeyOf<T>, direction?: 'asc' | 'desc'): T[];
|
|
74
82
|
|
|
75
|
-
export declare function arraySorted<T>(items: T[], fields:
|
|
83
|
+
export declare function arraySorted<T>(items: T[], fields: DeepKeyOf<T>[], direction?: 'asc' | 'desc'): T[];
|
|
76
84
|
|
|
77
85
|
export declare function arraySwap(items: unknown[], firstIndex: number, secondIndex: number): void;
|
|
78
86
|
|
|
@@ -133,6 +141,20 @@ export declare interface DebouncedFunction<Args extends ClosureArgs> {
|
|
|
133
141
|
|
|
134
142
|
export declare function deepEquals(a: unknown, b: unknown): boolean;
|
|
135
143
|
|
|
144
|
+
export declare type DeepKeyOf<T, TRequired extends DeepRequired<T> = DeepRequired<T>> = NonNullable<TRequired extends object ? {
|
|
145
|
+
[K in keyof TRequired]: TRequired[K] extends Function ? never : TRequired[K] extends Array<unknown> ? `${Exclude<K, symbol>}` : TRequired[K] extends object ? {
|
|
146
|
+
[KK in keyof TRequired[K]]: TRequired[K][KK] extends Function ? never : TRequired[K][KK] extends Array<unknown> ? `${Exclude<K, symbol>}.${Exclude<KK, symbol>}` : TRequired[K][KK] extends object ? {
|
|
147
|
+
[KKK in keyof TRequired[K][KK]]: TRequired[K][KK][KKK] extends Function ? never : `${Exclude<K, symbol>}.${Exclude<KK, symbol>}.${Exclude<KKK, symbol>}`;
|
|
148
|
+
}[keyof TRequired[K][KK]] | `${Exclude<K, symbol>}.${Exclude<KK, symbol>}` : `${Exclude<K, symbol>}.${Exclude<KK, symbol>}`;
|
|
149
|
+
}[keyof TRequired[K]] | `${Exclude<K, symbol>}` : `${Exclude<K, symbol>}`;
|
|
150
|
+
}[keyof TRequired] : never>;
|
|
151
|
+
|
|
152
|
+
export declare type DeepRequired<T> = T extends object ? {
|
|
153
|
+
[K in keyof T]-?: NonNullable<T[K]> extends Function ? NonNullable<T[K]> : NonNullable<T[K]> extends object ? DeepRequired<NonNullable<T[K]>> : NonNullable<T[K]>;
|
|
154
|
+
} : T;
|
|
155
|
+
|
|
156
|
+
export declare type DeepValue<T extends object, K> = K extends `${infer Key}.${infer Rest}` ? Key extends keyof T ? T[Key] extends object ? DeepValue<T[Key], Rest> : T[Key] : never : K extends keyof T ? T[K] : never;
|
|
157
|
+
|
|
136
158
|
export declare function deleteLocationQueryParameters(parameters: string[]): Promise<void>;
|
|
137
159
|
|
|
138
160
|
export declare function downloadFile(filename: string, content: string, mediaType: string): void;
|
|
@@ -267,6 +289,8 @@ export declare interface FormatCodeBlockOptions {
|
|
|
267
289
|
indent?: number;
|
|
268
290
|
}
|
|
269
291
|
|
|
292
|
+
export declare function getAsyncMemo<T>(key: string): Promise<T | null>;
|
|
293
|
+
|
|
270
294
|
export declare function getClassMethods(target: object): string[];
|
|
271
295
|
|
|
272
296
|
export declare type GetClosureArgs<T extends Closure> = T extends (...args: infer Args) => ClosureResult ? Args : never;
|
|
@@ -285,10 +309,16 @@ export declare function getLocationQueryParameters<T extends string = string>():
|
|
|
285
309
|
[key in T]: string;
|
|
286
310
|
}>;
|
|
287
311
|
|
|
312
|
+
export declare function getMemo<T>(key: string): T | null;
|
|
313
|
+
|
|
314
|
+
export declare type GetObjectKeys<T> = T extends Record<infer Key, any> ? Key : keyof T;
|
|
315
|
+
|
|
288
316
|
export declare type GetObjectMethods<T> = {
|
|
289
317
|
[K in keyof T]: T[K] extends (...args: ClosureArgs) => ClosureResult ? K : never;
|
|
290
318
|
}[keyof T];
|
|
291
319
|
|
|
320
|
+
export declare type GetObjectValues<T> = T extends Record<any, infer Value> ? Value : never;
|
|
321
|
+
|
|
292
322
|
export declare type GetOptionalKeys<T> = {
|
|
293
323
|
[K in keyof T]-?: Record<string, never> extends Pick<T, K> ? K : never;
|
|
294
324
|
}[keyof T];
|
|
@@ -319,6 +349,8 @@ export declare type GetRequiredKeysWithoutEmpty<T, U extends Record<keyof T, unk
|
|
|
319
349
|
[K in keyof T]: Record<string, never> extends Pick<T, K> ? never : U[K] extends never ? never : Equals<T[K], U[K]> extends true ? K : never;
|
|
320
350
|
}[keyof T];
|
|
321
351
|
|
|
352
|
+
export declare function getWeakMemo<T>(name: string, key: object): T | null;
|
|
353
|
+
|
|
322
354
|
export declare function hasLocationQueryParameter(parameter: string): boolean;
|
|
323
355
|
|
|
324
356
|
export declare type Helper<Primitive = unknown> = (value: Primitive, ...args: any[]) => unknown;
|
|
@@ -494,9 +526,9 @@ export declare type Obj = Record<string, unknown>;
|
|
|
494
526
|
|
|
495
527
|
export declare function objectDeepClone<T extends Obj>(object: T): T;
|
|
496
528
|
|
|
497
|
-
export declare
|
|
529
|
+
export declare function objectDeepValue<T extends object, K extends DeepKeyOf<T>>(object: T, key: K): DeepValue<T, K>;
|
|
498
530
|
|
|
499
|
-
export declare
|
|
531
|
+
export declare const objectEntries: <T extends GetClosureArgs<typeof Object.entries>[0]>(obj: T) => [GetObjectKeys<T>, GetObjectValues<T>][];
|
|
500
532
|
|
|
501
533
|
export declare function objectHasOwnProperty(object: Obj, property: string): boolean;
|
|
502
534
|
|
|
@@ -576,6 +608,8 @@ export declare type OnlyKnownProperties<TGeneric, TKnown> = {
|
|
|
576
608
|
[K in keyof TGeneric]: K extends keyof TKnown ? TGeneric[K] : never;
|
|
577
609
|
};
|
|
578
610
|
|
|
611
|
+
export declare function overridePrototypeMethod<T, K extends GetObjectMethods<T>>(target: Constructor<T>, method: K, implementation: T[K]): void;
|
|
612
|
+
|
|
579
613
|
export declare function parseBoolean(value: unknown): boolean;
|
|
580
614
|
|
|
581
615
|
export declare function parseDate(value?: unknown): Date | null;
|
|
@@ -664,6 +698,8 @@ export declare function resetAsyncMemo(key?: string): void;
|
|
|
664
698
|
|
|
665
699
|
export declare function resetMemo(key?: string): void;
|
|
666
700
|
|
|
701
|
+
export declare function resetWeakMemo(name: string, key: object): void;
|
|
702
|
+
|
|
667
703
|
export declare function round(value: number, places?: number): number;
|
|
668
704
|
|
|
669
705
|
export declare const RuntimeErrorClass: ErrorConstructor;
|
|
@@ -688,6 +724,8 @@ export declare function setAsyncMemo(key: string, value: unknown): void;
|
|
|
688
724
|
|
|
689
725
|
export declare function setMemo(key: string, value: unknown): void;
|
|
690
726
|
|
|
727
|
+
export declare function setWeakMemo(name: string, key: object, value: unknown): void;
|
|
728
|
+
|
|
691
729
|
export declare function shortId(length?: number): string;
|
|
692
730
|
|
|
693
731
|
export declare function silenced<Args extends ClosureArgs, Result>(operation: Closure<Args, Promise<Result>>): Closure<Args, Promise<Result | null>>;
|
|
@@ -812,6 +850,8 @@ export declare type ValueWithoutEmpty<T> = T extends null | undefined ? never :
|
|
|
812
850
|
|
|
813
851
|
export declare type VoidClosure<T> = T extends (...args: infer A) => ClosureResult ? (...args: A) => void : never;
|
|
814
852
|
|
|
853
|
+
export declare function weakMemo<T>(name: string, key: object, operation: () => T): T;
|
|
854
|
+
|
|
815
855
|
export declare function when<T extends object>(target: T, condition: () => boolean): T;
|
|
816
856
|
|
|
817
857
|
export declare function when<T extends object>(target: T, condition: boolean): T;
|