typenative 0.4.1 → 0.5.0

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 (151) hide show
  1. package/CHANGELOG.md +171 -0
  2. package/README.md +62 -22
  3. package/ROUND2-HANDOFF.md +200 -0
  4. package/bin/cli.js +1 -0
  5. package/bin/index.js +13 -2
  6. package/bin/main.js +1 -0
  7. package/bin/node/assert.js +2 -2
  8. package/bin/node/async_hooks.js +1 -1
  9. package/bin/node/buffer.js +16 -5
  10. package/bin/node/child_process.js +7 -7
  11. package/bin/node/cluster.js +3 -3
  12. package/bin/node/crypto_keys.js +21 -21
  13. package/bin/node/dgram.js +1 -1
  14. package/bin/node/diagnostics_channel.js +3 -3
  15. package/bin/node/dns.js +2 -2
  16. package/bin/node/events.js +3 -3
  17. package/bin/node/fetch.js +2 -2
  18. package/bin/node/fs.js +3 -3
  19. package/bin/node/fs_watch.js +5 -5
  20. package/bin/node/http.js +3 -3
  21. package/bin/node/http2.js +3 -3
  22. package/bin/node/net.js +8 -8
  23. package/bin/node/path.js +17 -3
  24. package/bin/node/process.js +34 -11
  25. package/bin/node/readline.js +1 -1
  26. package/bin/node/registry.js +4 -1
  27. package/bin/node/sqlite.js +6 -6
  28. package/bin/node/stream.js +81 -15
  29. package/bin/node/stream_web.js +10 -10
  30. package/bin/node/system_extra.js +3 -3
  31. package/bin/node/test.js +674 -366
  32. package/bin/node/test_coverage.js +187 -0
  33. package/bin/node/test_report.js +1392 -0
  34. package/bin/node/test_run.js +575 -0
  35. package/bin/node/timers.js +4 -4
  36. package/bin/node/tls.js +5 -5
  37. package/bin/node/util.js +31 -7
  38. package/bin/node/util_extra.js +7 -7
  39. package/bin/node/webview.js +654 -0
  40. package/bin/node/worker_threads.js +1 -1
  41. package/bin/node/zlib.js +3 -3
  42. package/bin/parse-node.js +4 -0
  43. package/bin/transpiler.js +10390 -1178
  44. package/bin/version.js +1 -1
  45. package/conformance.md +468 -340
  46. package/examples/README.md +47 -10
  47. package/examples/desktop-notes/README.md +108 -0
  48. package/examples/desktop-notes/bench.mjs +125 -0
  49. package/examples/desktop-notes/main.ts +131 -0
  50. package/examples/desktop-notes/package-lock.json +726 -0
  51. package/examples/desktop-notes/package.json +9 -0
  52. package/examples/desktop-notes/ui.ts +176 -0
  53. package/examples/dupe-finder/README.md +76 -0
  54. package/examples/dupe-finder/bench.mjs +120 -0
  55. package/examples/dupe-finder/main.ts +87 -0
  56. package/examples/mandelbrot-png/README.md +65 -0
  57. package/examples/mandelbrot-png/bench.mjs +95 -0
  58. package/examples/mandelbrot-png/main.ts +98 -0
  59. package/examples/mandelbrot-png/preview.png +0 -0
  60. package/examples/marked-cli/README.md +159 -0
  61. package/examples/marked-cli/bench.mjs +178 -0
  62. package/examples/marked-cli/main.ts +292 -0
  63. package/examples/marked-cli/parity.mjs +185 -0
  64. package/examples/marked-cli/vendor/marked/LICENSE +44 -0
  65. package/examples/marked-cli/vendor/marked/VENDOR.md +26 -0
  66. package/examples/todo-cli/README.md +69 -0
  67. package/examples/todo-cli/bench.mjs +89 -0
  68. package/examples/todo-cli/main.ts +92 -0
  69. package/examples/yaml-cli/README.md +136 -0
  70. package/examples/yaml-cli/bench.mjs +265 -0
  71. package/examples/yaml-cli/main.ts +29 -0
  72. package/examples/yaml-cli/parity.mjs +156 -0
  73. package/examples/yaml-cli/vendor/yaml/LICENSE +13 -0
  74. package/examples/yaml-cli/vendor/yaml/VENDOR.md +25 -0
  75. package/govendor/github.com/jchv/go-webview2/LICENSE +22 -0
  76. package/govendor/github.com/jchv/go-webview2/README.md +21 -0
  77. package/govendor/github.com/jchv/go-webview2/common.go +84 -0
  78. package/govendor/github.com/jchv/go-webview2/go.mod +3 -0
  79. package/govendor/github.com/jchv/go-webview2/internal/w32/w32.go +194 -0
  80. package/govendor/github.com/jchv/go-webview2/internal/w32/w32_386.go +14 -0
  81. package/govendor/github.com/jchv/go-webview2/internal/w32/w32_64bit.go +15 -0
  82. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_COLOR.go +8 -0
  83. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_HOST_RESOURCE_ACCESS_KIND.go +9 -0
  84. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_KEY_EVENT_KIND.go +10 -0
  85. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_MOVE_FOCUS_REASON.go +9 -0
  86. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_PHYSICAL_KEY_STATUS.go +10 -0
  87. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_WEB_RESOURCE_CONTEXT.go +23 -0
  88. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2AcceleratorKeyPressedEventArgs.go +78 -0
  89. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2AcceleratorKeyPressedEventHandler.go +52 -0
  90. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2Controller.go +132 -0
  91. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2Controller2.go +74 -0
  92. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2CreateCoreWebView2ControllerCompletedHandler.go +48 -0
  93. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2NavigationCompletedEventArgs.go +17 -0
  94. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2NavigationCompletedEventHandler.go +48 -0
  95. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2Settings.go +270 -0
  96. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2WebResourceRequest.go +43 -0
  97. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2WebResourceRequestedEventArgs.go +51 -0
  98. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2WebResourceRequestedEventHandler.go +48 -0
  99. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2WebResourceResponse.go +21 -0
  100. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2_2.go +21 -0
  101. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2_3.go +60 -0
  102. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebViewSettings.go +396 -0
  103. package/govendor/github.com/jchv/go-webview2/pkg/edge/chromium.go +361 -0
  104. package/govendor/github.com/jchv/go-webview2/pkg/edge/chromium_386.go +24 -0
  105. package/govendor/github.com/jchv/go-webview2/pkg/edge/chromium_amd64.go +22 -0
  106. package/govendor/github.com/jchv/go-webview2/pkg/edge/chromium_arm64.go +26 -0
  107. package/govendor/github.com/jchv/go-webview2/pkg/edge/comproc.go +13 -0
  108. package/govendor/github.com/jchv/go-webview2/pkg/edge/comproc_go17.go +51 -0
  109. package/govendor/github.com/jchv/go-webview2/pkg/edge/comproc_go18.go +16 -0
  110. package/govendor/github.com/jchv/go-webview2/pkg/edge/corewebview2.go +411 -0
  111. package/govendor/github.com/jchv/go-webview2/pkg/edge/guid.go +223 -0
  112. package/govendor/github.com/jchv/go-webview2/webview.go +482 -0
  113. package/govendor/github.com/jchv/go-webview2/webviewloader/README.md +3 -0
  114. package/govendor/github.com/jchv/go-webview2/webviewloader/module.go +153 -0
  115. package/govendor/github.com/jchv/go-webview2/webviewloader/module_386.go +6 -0
  116. package/govendor/github.com/jchv/go-webview2/webviewloader/module_amd64.go +6 -0
  117. package/govendor/github.com/jchv/go-webview2/webviewloader/module_arm64.go +6 -0
  118. package/govendor/github.com/jchv/go-webview2/webviewloader/sdk/arm64/WebView2Loader.dll +0 -0
  119. package/govendor/github.com/jchv/go-webview2/webviewloader/sdk/x64/WebView2Loader.dll +0 -0
  120. package/govendor/github.com/jchv/go-webview2/webviewloader/sdk/x86/WebView2Loader.dll +0 -0
  121. package/govendor/github.com/jchv/go-winloader/LICENSE.md +7 -0
  122. package/govendor/github.com/jchv/go-winloader/README.md +124 -0
  123. package/govendor/github.com/jchv/go-winloader/common.go +11 -0
  124. package/govendor/github.com/jchv/go-winloader/go.mod +3 -0
  125. package/govendor/github.com/jchv/go-winloader/internal/loader/loader.go +25 -0
  126. package/govendor/github.com/jchv/go-winloader/internal/loader/machine.go +53 -0
  127. package/govendor/github.com/jchv/go-winloader/internal/memloader/cache.go +42 -0
  128. package/govendor/github.com/jchv/go-winloader/internal/memloader/loader.go +253 -0
  129. package/govendor/github.com/jchv/go-winloader/internal/pe/export.go +76 -0
  130. package/govendor/github.com/jchv/go-winloader/internal/pe/format.go +522 -0
  131. package/govendor/github.com/jchv/go-winloader/internal/pe/import.go +106 -0
  132. package/govendor/github.com/jchv/go-winloader/internal/pe/module.go +91 -0
  133. package/govendor/github.com/jchv/go-winloader/internal/pe/reloc.go +177 -0
  134. package/govendor/github.com/jchv/go-winloader/internal/pe/util.go +40 -0
  135. package/govendor/github.com/jchv/go-winloader/internal/vmem/common.go +55 -0
  136. package/govendor/github.com/jchv/go-winloader/internal/vmem/memory_other.go +71 -0
  137. package/govendor/github.com/jchv/go-winloader/internal/vmem/memory_windows.go +179 -0
  138. package/govendor/github.com/jchv/go-winloader/internal/winloader/hacks_other.go +17 -0
  139. package/govendor/github.com/jchv/go-winloader/internal/winloader/hacks_windows.go +73 -0
  140. package/govendor/github.com/jchv/go-winloader/internal/winloader/loader_windows.go +64 -0
  141. package/govendor/github.com/jchv/go-winloader/internal/winloader/machine_windows.go +32 -0
  142. package/govendor/github.com/jchv/go-winloader/internal/winloader/nativearch_386.go +9 -0
  143. package/govendor/github.com/jchv/go-winloader/internal/winloader/nativearch_amd64.go +9 -0
  144. package/govendor/github.com/jchv/go-winloader/internal/winloader/nativearch_arm64.go +9 -0
  145. package/govendor/github.com/jchv/go-winloader/loader_other.go +24 -0
  146. package/govendor/github.com/jchv/go-winloader/loader_windows.go +33 -0
  147. package/govendor/manifest.txt +3 -1
  148. package/package.json +1 -1
  149. package/tsparser/main.go +4 -0
  150. package/types/typenative-npm.d.ts +190 -2
  151. package/types/typenative.d.ts +98 -31
@@ -15,9 +15,19 @@ interface Function {
15
15
  bind(thisArg: any, ...argArray: any[]): any;
16
16
  }
17
17
 
18
- interface CallableFunction extends Function {}
18
+ // With strict, f.call / f.apply / f.bind are checked against f's signature
19
+ // (strictBindCallApply), as in TypeScript's own lib
20
+ interface CallableFunction extends Function {
21
+ apply<T, R>(this: (this: T) => R, thisArg: T): R;
22
+ apply<T, A extends any[], R>(this: (this: T, ...args: A) => R, thisArg: T, args: A): R;
23
+ call<T, A extends any[], R>(this: (this: T, ...args: A) => R, thisArg: T, ...args: A): R;
24
+ }
19
25
  interface NewableFunction extends Function {}
20
26
 
27
+ /** The global `Function` as a value: an opaque constructor (`x instanceof Function` checks for a function); calling it compiles code, which a native binary cannot */
28
+ interface FunctionConstructor extends Function {}
29
+ declare var Function: FunctionConstructor;
30
+
21
31
  interface IArguments {
22
32
  [index: number]: any;
23
33
  length: number;
@@ -33,6 +43,8 @@ interface Number {
33
43
  interface Object {
34
44
  constructor: Function;
35
45
  toString(): string;
46
+ valueOf(): Object;
47
+ hasOwnProperty(v: PropertyKey): boolean;
36
48
  }
37
49
 
38
50
  // --- Iteration protocol (also unlocks for..of / spread over Map, Set, string) ---
@@ -109,11 +121,14 @@ interface Disposable {
109
121
  [Symbol.dispose](): void;
110
122
  }
111
123
 
112
- // await unwraps one thenable layer at a time
124
+ // await unwraps one thenable layer at a time (TypeScript's own definition,
125
+ // which the checker relates to T for generic T)
113
126
  type Awaited<T> = T extends null | undefined
114
127
  ? T
115
- : T extends { then(onfulfilled: (value: infer U) => any): any }
116
- ? Awaited<U>
128
+ : T extends object & { then(onfulfilled: infer F, ...args: infer _): any }
129
+ ? F extends (value: infer V, ...args: infer _) => any
130
+ ? Awaited<V>
131
+ : never
117
132
  : T;
118
133
 
119
134
  // Tagged template functions: tag`a${x}b`
@@ -140,6 +155,8 @@ type NonNullable<T> = T & {};
140
155
  type Record<K extends keyof any, T> = { [P in K]: T };
141
156
  type Parameters<T extends (...args: any) => any> = T extends (...args: infer P) => any ? P : never;
142
157
  type ReturnType<T extends (...args: any) => any> = T extends (...args: any) => infer R ? R : any;
158
+ type Exclude<T, U> = T extends U ? never : T;
159
+ type Extract<T, U> = T extends U ? T : never;
143
160
 
144
161
  // --- RegExp ---
145
162
 
@@ -206,35 +223,37 @@ interface Array<T> extends IterableIterator<T> {
206
223
  /**
207
224
  * Calls a defined callback function on each element of an array, and returns an array that contains the results.
208
225
  */
209
- map<U>(callback: (value: T, index?: number, array?: T[]) => U): U[];
226
+ map<U>(callback: (value: T, index: number, array: T[]) => U): U[];
210
227
  /**
211
228
  * Returns the elements of an array that meet the condition specified in a callback function.
212
229
  */
213
- filter(callback: (value: T, index?: number, array?: T[]) => boolean): T[];
230
+ filter<S extends T>(callback: (value: T, index: number, array: T[]) => value is S): S[];
231
+ filter(callback: (value: T, index: number, array: T[]) => unknown): T[];
214
232
  /**
215
233
  * Determines whether the specified callback function returns true for any element of an array.
216
234
  */
217
- some(callback: (value: T, index?: number, array?: T[]) => boolean): boolean;
235
+ some(callback: (value: T, index: number, array: T[]) => unknown): boolean;
218
236
  /**
219
237
  * Returns the value of the first element in the array where callback is true, and undefined otherwise.
220
238
  */
221
- find(callback: (value: T, index?: number, array?: T[]) => boolean): T | undefined;
239
+ find<S extends T>(callback: (value: T, index: number, array: T[]) => value is S): S | undefined;
240
+ find(callback: (value: T, index: number, array: T[]) => unknown): T | undefined;
222
241
  /**
223
242
  * Returns the index of the first element that satisfies the callback, or -1.
224
243
  */
225
- findIndex(callback: (value: T, index?: number, array?: T[]) => boolean): number;
244
+ findIndex(callback: (value: T, index: number, array: T[]) => unknown): number;
226
245
  /**
227
246
  * Returns the value of the last element where callback is true, and undefined otherwise.
228
247
  */
229
- findLast(callback: (value: T, index?: number, array?: T[]) => boolean): T | undefined;
248
+ findLast(callback: (value: T, index: number, array: T[]) => unknown): T | undefined;
230
249
  /**
231
250
  * Returns the index of the last element that satisfies the callback, or -1.
232
251
  */
233
- findLastIndex(callback: (value: T, index?: number, array?: T[]) => boolean): number;
252
+ findLastIndex(callback: (value: T, index: number, array: T[]) => unknown): number;
234
253
  /**
235
254
  * Determines whether all elements satisfy the callback.
236
255
  */
237
- every(callback: (value: T, index?: number, array?: T[]) => boolean): boolean;
256
+ every(callback: (value: T, index: number, array: T[]) => unknown): boolean;
238
257
  /**
239
258
  * Performs the callback for each element.
240
259
  */
@@ -282,7 +301,7 @@ interface Array<T> extends IterableIterator<T> {
282
301
  /**
283
302
  * Reverses the elements of an array in place.
284
303
  */
285
- reverse(): T[];
304
+ reverse(): this;
286
305
  /**
287
306
  * Returns a reversed copy of the array.
288
307
  */
@@ -290,7 +309,7 @@ interface Array<T> extends IterableIterator<T> {
290
309
  /**
291
310
  * Sorts the elements of an array in place.
292
311
  */
293
- sort(compareFn?: (a: T, b: T) => number): T[];
312
+ sort(compareFn?: (a: T, b: T) => number): this;
294
313
  /**
295
314
  * Returns a sorted copy of the array.
296
315
  */
@@ -315,11 +334,11 @@ interface Array<T> extends IterableIterator<T> {
315
334
  /**
316
335
  * Returns a copy of a section of an array with the fill value applied.
317
336
  */
318
- fill(value: T, start?: number, end?: number): T[];
337
+ fill(value: T, start?: number, end?: number): this;
319
338
  /**
320
339
  * Copies within the array in place (overlap-safe) and returns it.
321
340
  */
322
- copyWithin(target: number, start: number, end?: number): T[];
341
+ copyWithin(target: number, start: number, end?: number): this;
323
342
  /**
324
343
  * Merges two or more arrays (array arguments are flattened one level).
325
344
  */
@@ -342,10 +361,12 @@ interface Array<T> extends IterableIterator<T> {
342
361
 
343
362
  interface ArrayConstructor {
344
363
  new <T>(length: number): T[];
364
+ new <T>(...items: T[]): T[];
345
365
  isArray(arg: any): arg is any[];
346
- from<T>(arrayLike: ArrayLike<T>): T[];
347
- from<T, U>(arrayLike: ArrayLike<T>, mapFn: (value: T, index: number) => U): U[];
366
+ from<T>(arrayLike: ArrayLike<T> | Iterable<T>): T[];
367
+ from<T, U>(arrayLike: ArrayLike<T> | Iterable<T>, mapFn: (value: T, index: number) => U): U[];
348
368
  of<T>(...items: T[]): T[];
369
+ readonly prototype: any[];
349
370
  }
350
371
 
351
372
  declare var Array: ArrayConstructor;
@@ -438,9 +459,9 @@ declare var String: StringConstructor;
438
459
 
439
460
  interface NumberConstructor {
440
461
  (value?: any): number;
441
- isNaN(value: number): boolean;
442
- isFinite(value: number): boolean;
443
- isInteger(value: number): boolean;
462
+ isNaN(value: unknown): boolean;
463
+ isFinite(value: unknown): boolean;
464
+ isInteger(value: unknown): boolean;
444
465
  readonly MAX_SAFE_INTEGER: number;
445
466
  readonly MIN_SAFE_INTEGER: number;
446
467
  readonly MAX_VALUE: number;
@@ -534,6 +555,8 @@ declare function isNaN(number: number): boolean;
534
555
  declare function isFinite(number: number): boolean;
535
556
  declare function encodeURIComponent(uriComponent: string): string;
536
557
  declare function decodeURIComponent(uriComponent: string): string;
558
+ declare function encodeURI(uri: string): string;
559
+ declare function decodeURI(encodedURI: string): string;
537
560
  declare function structuredClone<T>(value: T): T;
538
561
 
539
562
  // The running program (a native binary has no separate script file)
@@ -573,7 +596,26 @@ interface JSON {
573
596
  }
574
597
  declare var JSON: JSON;
575
598
 
599
+ interface PropertyDescriptor {
600
+ value?: any;
601
+ writable?: boolean;
602
+ enumerable?: boolean;
603
+ configurable?: boolean;
604
+ get?(): any;
605
+ set?(v: any): void;
606
+ }
607
+ interface PropertyDescriptorMap {
608
+ [key: string]: PropertyDescriptor;
609
+ }
610
+
576
611
  interface ObjectConstructor {
612
+ /** Object(x) returns x (primitives are not boxed) */
613
+ (value?: any): any;
614
+ new (value?: any): any;
615
+ /** A class value stands in for its prototype (Object.create(C.prototype)) */
616
+ readonly prototype: Object;
617
+ /** Only `Object.setPrototypeOf(this, …)` in a constructor (the Error-subclassing idiom), as a no-op */
618
+ setPrototypeOf(o: any, proto: object | null): any;
577
619
  /** SameValue: NaN is NaN, +0 is not -0 */
578
620
  is(a: any, b: any): boolean;
579
621
  groupBy<T>(items: T[], keySelector: (item: T, index: number) => string | number): Record<string, T[]>;
@@ -583,11 +625,14 @@ interface ObjectConstructor {
583
625
  assign(target: any, ...sources: any[]): any;
584
626
  fromEntries(entries: Iterable<readonly [string, any]>): any;
585
627
  hasOwn(obj: any, key: string): boolean;
586
- defineProperty<T>(
587
- obj: T,
588
- key: string,
589
- descriptor: { value: any; enumerable?: boolean; writable?: boolean; configurable?: boolean }
590
- ): T;
628
+ /** Data descriptors set the value; attributes and accessors have no effect */
629
+ defineProperty<T>(obj: T, key: string, descriptor: PropertyDescriptor): T;
630
+ defineProperties<T>(obj: T, descriptors: PropertyDescriptorMap): T;
631
+ /** An instance of the prototype's class without running its constructor */
632
+ create(proto: object | null, descriptors?: PropertyDescriptorMap): any;
633
+ /** An instance's class (null for other values) */
634
+ getPrototypeOf(obj: any): any;
635
+ getOwnPropertyDescriptors<T>(obj: T): { [P in keyof T]: PropertyDescriptor } & { [key: string]: PropertyDescriptor };
591
636
  getOwnPropertyNames(obj: any): string[];
592
637
  freeze<T>(obj: T): T;
593
638
  seal<T>(obj: T): T;
@@ -632,7 +677,7 @@ interface Process {
632
677
  };
633
678
  nextTick<A extends any[]>(callback: (...args: A) => void, ...args: A): void;
634
679
  kill(pid: number, signal?: string | number): true;
635
- emitWarning(warning: string | Error): void;
680
+ emitWarning(warning: string | Error, type?: string): void;
636
681
  getuid(): number;
637
682
  getgid(): number;
638
683
  geteuid(): number;
@@ -827,12 +872,12 @@ interface PromiseLike<T> {
827
872
 
828
873
  interface PromiseConstructor {
829
874
  new <T>(
830
- executor: (resolve: (value: T) => void, reject?: (reason?: any) => void) => void
875
+ executor: (resolve: (value: T) => void, reject: (reason?: any) => void) => void
831
876
  ): Promise<T>;
832
877
  resolve(): Promise<void>;
833
878
  resolve<T>(value: T): Promise<T>;
834
879
  reject(reason?: any): Promise<never>;
835
- all<T>(values: Promise<T>[]): Promise<T[]>;
880
+ all<T>(values: (T | PromiseLike<T>)[]): Promise<Awaited<T>[]>;
836
881
  race<T>(values: Promise<T>[]): Promise<T>;
837
882
  any<T>(values: Promise<T>[]): Promise<T>;
838
883
  allSettled<T>(values: Promise<T>[]): Promise<{ status: string; value?: T; reason?: any }[]>;
@@ -891,7 +936,7 @@ interface Map<K, V> {
891
936
 
892
937
  interface MapConstructor {
893
938
  new <K, V>(): Map<K, V>;
894
- new <K, V>(entries: [K, V][]): Map<K, V>;
939
+ new <K, V>(entries?: readonly (readonly [K, V])[] | Iterable<readonly [K, V]> | null): Map<K, V>;
895
940
  groupBy<K, T>(items: T[], keySelector: (item: T, index: number) => K): Map<K, T[]>;
896
941
  }
897
942
 
@@ -925,7 +970,7 @@ interface Set<T> {
925
970
 
926
971
  interface SetConstructor {
927
972
  new <T>(): Set<T>;
928
- new <T>(values?: T[] | Set<T>): Set<T>;
973
+ new <T>(values?: readonly T[] | Set<T> | Iterable<T> | null): Set<T>;
929
974
  }
930
975
 
931
976
  declare var Set: SetConstructor;
@@ -1038,6 +1083,8 @@ interface Uint8Array {
1038
1083
  slice(start?: number, end?: number): Uint8Array;
1039
1084
  set(array: ArrayLike<number>, offset?: number): void;
1040
1085
  at(index: number): number | undefined;
1086
+ /** Base64 of the bytes (ES2026) */
1087
+ toBase64(): string;
1041
1088
  [Symbol.iterator](): IterableIterator<number>;
1042
1089
  }
1043
1090
 
@@ -1047,6 +1094,8 @@ interface Uint8ArrayConstructor {
1047
1094
  // A view sharing the buffer's memory
1048
1095
  new (buffer: ArrayBuffer, byteOffset?: number, length?: number): Uint8Array;
1049
1096
  from(arrayLike: ArrayLike<number> | Iterable<number>): Uint8Array;
1097
+ /** The bytes a base64 string encodes (ES2026) */
1098
+ fromBase64(base64: string): Uint8Array;
1050
1099
  }
1051
1100
 
1052
1101
  declare var Uint8Array: Uint8ArrayConstructor;
@@ -1239,6 +1288,8 @@ interface Buffer extends Uint8Array {
1239
1288
  }
1240
1289
 
1241
1290
  interface BufferConstructor {
1291
+ /** @deprecated use Buffer.alloc / Buffer.from (lets `typeof Buffer === 'function'` narrow) */
1292
+ new (size: number): Buffer;
1242
1293
  from(data: string, encoding?: BufferEncoding): Buffer;
1243
1294
  from(data: ArrayLike<number> | Uint8Array | ArrayBuffer): Buffer;
1244
1295
  alloc(size: number, fill?: string | number | Uint8Array, encoding?: BufferEncoding): Buffer;
@@ -1627,6 +1678,22 @@ declare function setImmediate<A extends any[]>(callback: (...args: A) => void, .
1627
1678
  declare function clearImmediate(immediate?: NodeJS.Immediate | number): void;
1628
1679
 
1629
1680
  declare namespace NodeJS {
1681
+ // A readable stream, as Node's typings describe it (process.stdin is one)
1682
+ interface ReadableStream {
1683
+ readonly readable: boolean;
1684
+ read(size?: number): any;
1685
+ setEncoding(encoding: BufferEncoding): this;
1686
+ pause(): this;
1687
+ resume(): this;
1688
+ isPaused(): boolean;
1689
+ on(event: string, listener: (...args: any[]) => void): this;
1690
+ once(event: string, listener: (...args: any[]) => void): this;
1691
+ }
1692
+ interface WritableStream {
1693
+ readonly writable: boolean;
1694
+ write(chunk: any, callback?: (error?: Error | null) => void): boolean;
1695
+ on(event: string, listener: (...args: any[]) => void): this;
1696
+ }
1630
1697
  // Timer handles: an unref'ed timer does not keep the process alive
1631
1698
  interface Timeout {
1632
1699
  ref(): this;