@noeldemartin/utils 0.7.0 → 0.7.1-next.1d773c8a8bb25494976809bee0d970c7341e0342

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.
@@ -1,12 +1,16 @@
1
- export declare function after(time?: Partial<{
2
- ms: number;
3
- milliseconds: number;
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: keyof T, direction?: 'asc' | 'desc'): T[];
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: (keyof T)[], direction?: 'asc' | 'desc'): T[];
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;
@@ -342,6 +374,10 @@ export declare class IndexedDBMap<TItem> {
342
374
 
343
375
  export declare function invert(map: Record<string, string>): Record<string, string>;
344
376
 
377
+ export declare type IsAny<T> = {
378
+ __: 'never';
379
+ } extends T ? true : false;
380
+
345
381
  export declare const isArray: (arg: any) => arg is any[];
346
382
 
347
383
  export declare function isConstructor(value: object): value is Constructor;
@@ -494,9 +530,9 @@ export declare type Obj = Record<string, unknown>;
494
530
 
495
531
  export declare function objectDeepClone<T extends Obj>(object: T): T;
496
532
 
497
- export declare const objectEntries: <T extends Obj>(obj: T) => ObjectEntry<T, keyof T>[];
533
+ export declare function objectDeepValue<T extends object, K extends DeepKeyOf<T>>(object: T, key: K): DeepValue<T, K>;
498
534
 
499
- export declare type ObjectEntry<T extends Obj, K extends keyof T> = [K, T[K]];
535
+ export declare const objectEntries: <T extends GetClosureArgs<typeof Object.entries>[0]>(obj: T) => [GetObjectKeys<T>, GetObjectValues<T>][];
500
536
 
501
537
  export declare function objectHasOwnProperty(object: Obj, property: string): boolean;
502
538
 
@@ -576,6 +612,8 @@ export declare type OnlyKnownProperties<TGeneric, TKnown> = {
576
612
  [K in keyof TGeneric]: K extends keyof TKnown ? TGeneric[K] : never;
577
613
  };
578
614
 
615
+ export declare function overridePrototypeMethod<T, K extends GetObjectMethods<T>>(target: Constructor<T>, method: K, implementation: T[K]): void;
616
+
579
617
  export declare function parseBoolean(value: unknown): boolean;
580
618
 
581
619
  export declare function parseDate(value?: unknown): Date | null;
@@ -664,6 +702,8 @@ export declare function resetAsyncMemo(key?: string): void;
664
702
 
665
703
  export declare function resetMemo(key?: string): void;
666
704
 
705
+ export declare function resetWeakMemo(name: string, key: object): void;
706
+
667
707
  export declare function round(value: number, places?: number): number;
668
708
 
669
709
  export declare const RuntimeErrorClass: ErrorConstructor;
@@ -688,6 +728,8 @@ export declare function setAsyncMemo(key: string, value: unknown): void;
688
728
 
689
729
  export declare function setMemo(key: string, value: unknown): void;
690
730
 
731
+ export declare function setWeakMemo(name: string, key: object, value: unknown): void;
732
+
691
733
  export declare function shortId(length?: number): string;
692
734
 
693
735
  export declare function silenced<Args extends ClosureArgs, Result>(operation: Closure<Args, Promise<Result>>): Closure<Args, Promise<Result | null>>;
@@ -812,6 +854,8 @@ export declare type ValueWithoutEmpty<T> = T extends null | undefined ? never :
812
854
 
813
855
  export declare type VoidClosure<T> = T extends (...args: infer A) => ClosureResult ? (...args: A) => void : never;
814
856
 
857
+ export declare function weakMemo<T>(name: string, key: object, operation: () => T): T;
858
+
815
859
  export declare function when<T extends object>(target: T, condition: () => boolean): T;
816
860
 
817
861
  export declare function when<T extends object>(target: T, condition: boolean): T;