typenative 0.4.0 → 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 (167) hide show
  1. package/.github/workflows/ci.yml +2 -0
  2. package/CHANGELOG.md +372 -0
  3. package/CONTRIBUTION.md +1 -1
  4. package/README.md +62 -22
  5. package/ROUND2-HANDOFF.md +200 -0
  6. package/bin/cli.js +2 -0
  7. package/bin/go/bridge.js +74 -14
  8. package/bin/go/convert.js +48 -0
  9. package/bin/go/metadata.js +13 -4
  10. package/bin/go/overrides.js +4 -6
  11. package/bin/go/stdlib.generated.js +2 -0
  12. package/bin/index.js +130 -2
  13. package/bin/main.js +2 -0
  14. package/bin/node/assert.js +2 -2
  15. package/bin/node/async_hooks.js +1 -1
  16. package/bin/node/buffer.js +16 -5
  17. package/bin/node/child_process.js +57 -9
  18. package/bin/node/cluster.js +44 -6
  19. package/bin/node/core.js +1 -1
  20. package/bin/node/crypto.js +205 -4
  21. package/bin/node/crypto_keys.js +21 -21
  22. package/bin/node/dgram.js +231 -7
  23. package/bin/node/diagnostics_channel.js +3 -3
  24. package/bin/node/dns.js +472 -9
  25. package/bin/node/errno_tables.js +445 -0
  26. package/bin/node/events.js +3 -3
  27. package/bin/node/fetch.js +2 -2
  28. package/bin/node/fs.js +24 -17
  29. package/bin/node/fs_watch.js +5 -5
  30. package/bin/node/http.js +131 -33
  31. package/bin/node/http2.js +7 -4
  32. package/bin/node/module_v8.js +142 -0
  33. package/bin/node/net.js +17 -14
  34. package/bin/node/path.js +17 -3
  35. package/bin/node/process.js +274 -9
  36. package/bin/node/readline.js +272 -1
  37. package/bin/node/registry.js +5 -1
  38. package/bin/node/sqlite.js +65 -17
  39. package/bin/node/stream.js +220 -22
  40. package/bin/node/stream_web.js +10 -10
  41. package/bin/node/system_extra.js +3 -3
  42. package/bin/node/test.js +834 -234
  43. package/bin/node/test_coverage.js +187 -0
  44. package/bin/node/test_report.js +1392 -0
  45. package/bin/node/test_run.js +575 -0
  46. package/bin/node/timers.js +4 -4
  47. package/bin/node/tls.js +5 -5
  48. package/bin/node/url.js +23 -5
  49. package/bin/node/util.js +49 -8
  50. package/bin/node/util_extra.js +13 -37
  51. package/bin/node/webview.js +654 -0
  52. package/bin/node/worker_threads.js +80 -20
  53. package/bin/node/zlib.js +3 -3
  54. package/bin/parse-node.js +4 -0
  55. package/bin/transpiler.js +14457 -1723
  56. package/bin/typecheck-node.js +1 -0
  57. package/bin/version.js +1 -1
  58. package/conformance.md +1153 -884
  59. package/examples/README.md +47 -10
  60. package/examples/desktop-notes/README.md +108 -0
  61. package/examples/desktop-notes/bench.mjs +125 -0
  62. package/examples/desktop-notes/main.ts +131 -0
  63. package/examples/desktop-notes/package-lock.json +726 -0
  64. package/examples/desktop-notes/package.json +9 -0
  65. package/examples/desktop-notes/ui.ts +176 -0
  66. package/examples/dupe-finder/README.md +76 -0
  67. package/examples/dupe-finder/bench.mjs +120 -0
  68. package/examples/dupe-finder/main.ts +87 -0
  69. package/examples/json-server/README.md +31 -29
  70. package/examples/json-server/bench.mjs +130 -38
  71. package/examples/mandelbrot-png/README.md +65 -0
  72. package/examples/mandelbrot-png/bench.mjs +95 -0
  73. package/examples/mandelbrot-png/main.ts +98 -0
  74. package/examples/mandelbrot-png/preview.png +0 -0
  75. package/examples/marked-cli/README.md +159 -0
  76. package/examples/marked-cli/bench.mjs +178 -0
  77. package/examples/marked-cli/main.ts +292 -0
  78. package/examples/marked-cli/parity.mjs +185 -0
  79. package/examples/marked-cli/vendor/marked/LICENSE +44 -0
  80. package/examples/marked-cli/vendor/marked/VENDOR.md +26 -0
  81. package/examples/todo-cli/README.md +69 -0
  82. package/examples/todo-cli/bench.mjs +89 -0
  83. package/examples/todo-cli/main.ts +92 -0
  84. package/examples/yaml-cli/README.md +136 -0
  85. package/examples/yaml-cli/bench.mjs +265 -0
  86. package/examples/yaml-cli/main.ts +29 -0
  87. package/examples/yaml-cli/parity.mjs +156 -0
  88. package/examples/yaml-cli/vendor/yaml/LICENSE +13 -0
  89. package/examples/yaml-cli/vendor/yaml/VENDOR.md +25 -0
  90. package/govendor/github.com/jchv/go-webview2/LICENSE +22 -0
  91. package/govendor/github.com/jchv/go-webview2/README.md +21 -0
  92. package/govendor/github.com/jchv/go-webview2/common.go +84 -0
  93. package/govendor/github.com/jchv/go-webview2/go.mod +3 -0
  94. package/govendor/github.com/jchv/go-webview2/internal/w32/w32.go +194 -0
  95. package/govendor/github.com/jchv/go-webview2/internal/w32/w32_386.go +14 -0
  96. package/govendor/github.com/jchv/go-webview2/internal/w32/w32_64bit.go +15 -0
  97. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_COLOR.go +8 -0
  98. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_HOST_RESOURCE_ACCESS_KIND.go +9 -0
  99. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_KEY_EVENT_KIND.go +10 -0
  100. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_MOVE_FOCUS_REASON.go +9 -0
  101. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_PHYSICAL_KEY_STATUS.go +10 -0
  102. package/govendor/github.com/jchv/go-webview2/pkg/edge/COREWEBVIEW2_WEB_RESOURCE_CONTEXT.go +23 -0
  103. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2AcceleratorKeyPressedEventArgs.go +78 -0
  104. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2AcceleratorKeyPressedEventHandler.go +52 -0
  105. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2Controller.go +132 -0
  106. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2Controller2.go +74 -0
  107. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2CreateCoreWebView2ControllerCompletedHandler.go +48 -0
  108. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2NavigationCompletedEventArgs.go +17 -0
  109. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2NavigationCompletedEventHandler.go +48 -0
  110. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2Settings.go +270 -0
  111. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2WebResourceRequest.go +43 -0
  112. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2WebResourceRequestedEventArgs.go +51 -0
  113. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2WebResourceRequestedEventHandler.go +48 -0
  114. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2WebResourceResponse.go +21 -0
  115. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2_2.go +21 -0
  116. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebView2_3.go +60 -0
  117. package/govendor/github.com/jchv/go-webview2/pkg/edge/ICoreWebViewSettings.go +396 -0
  118. package/govendor/github.com/jchv/go-webview2/pkg/edge/chromium.go +361 -0
  119. package/govendor/github.com/jchv/go-webview2/pkg/edge/chromium_386.go +24 -0
  120. package/govendor/github.com/jchv/go-webview2/pkg/edge/chromium_amd64.go +22 -0
  121. package/govendor/github.com/jchv/go-webview2/pkg/edge/chromium_arm64.go +26 -0
  122. package/govendor/github.com/jchv/go-webview2/pkg/edge/comproc.go +13 -0
  123. package/govendor/github.com/jchv/go-webview2/pkg/edge/comproc_go17.go +51 -0
  124. package/govendor/github.com/jchv/go-webview2/pkg/edge/comproc_go18.go +16 -0
  125. package/govendor/github.com/jchv/go-webview2/pkg/edge/corewebview2.go +411 -0
  126. package/govendor/github.com/jchv/go-webview2/pkg/edge/guid.go +223 -0
  127. package/govendor/github.com/jchv/go-webview2/webview.go +482 -0
  128. package/govendor/github.com/jchv/go-webview2/webviewloader/README.md +3 -0
  129. package/govendor/github.com/jchv/go-webview2/webviewloader/module.go +153 -0
  130. package/govendor/github.com/jchv/go-webview2/webviewloader/module_386.go +6 -0
  131. package/govendor/github.com/jchv/go-webview2/webviewloader/module_amd64.go +6 -0
  132. package/govendor/github.com/jchv/go-webview2/webviewloader/module_arm64.go +6 -0
  133. package/govendor/github.com/jchv/go-webview2/webviewloader/sdk/arm64/WebView2Loader.dll +0 -0
  134. package/govendor/github.com/jchv/go-webview2/webviewloader/sdk/x64/WebView2Loader.dll +0 -0
  135. package/govendor/github.com/jchv/go-webview2/webviewloader/sdk/x86/WebView2Loader.dll +0 -0
  136. package/govendor/github.com/jchv/go-winloader/LICENSE.md +7 -0
  137. package/govendor/github.com/jchv/go-winloader/README.md +124 -0
  138. package/govendor/github.com/jchv/go-winloader/common.go +11 -0
  139. package/govendor/github.com/jchv/go-winloader/go.mod +3 -0
  140. package/govendor/github.com/jchv/go-winloader/internal/loader/loader.go +25 -0
  141. package/govendor/github.com/jchv/go-winloader/internal/loader/machine.go +53 -0
  142. package/govendor/github.com/jchv/go-winloader/internal/memloader/cache.go +42 -0
  143. package/govendor/github.com/jchv/go-winloader/internal/memloader/loader.go +253 -0
  144. package/govendor/github.com/jchv/go-winloader/internal/pe/export.go +76 -0
  145. package/govendor/github.com/jchv/go-winloader/internal/pe/format.go +522 -0
  146. package/govendor/github.com/jchv/go-winloader/internal/pe/import.go +106 -0
  147. package/govendor/github.com/jchv/go-winloader/internal/pe/module.go +91 -0
  148. package/govendor/github.com/jchv/go-winloader/internal/pe/reloc.go +177 -0
  149. package/govendor/github.com/jchv/go-winloader/internal/pe/util.go +40 -0
  150. package/govendor/github.com/jchv/go-winloader/internal/vmem/common.go +55 -0
  151. package/govendor/github.com/jchv/go-winloader/internal/vmem/memory_other.go +71 -0
  152. package/govendor/github.com/jchv/go-winloader/internal/vmem/memory_windows.go +179 -0
  153. package/govendor/github.com/jchv/go-winloader/internal/winloader/hacks_other.go +17 -0
  154. package/govendor/github.com/jchv/go-winloader/internal/winloader/hacks_windows.go +73 -0
  155. package/govendor/github.com/jchv/go-winloader/internal/winloader/loader_windows.go +64 -0
  156. package/govendor/github.com/jchv/go-winloader/internal/winloader/machine_windows.go +32 -0
  157. package/govendor/github.com/jchv/go-winloader/internal/winloader/nativearch_386.go +9 -0
  158. package/govendor/github.com/jchv/go-winloader/internal/winloader/nativearch_amd64.go +9 -0
  159. package/govendor/github.com/jchv/go-winloader/internal/winloader/nativearch_arm64.go +9 -0
  160. package/govendor/github.com/jchv/go-winloader/loader_other.go +24 -0
  161. package/govendor/github.com/jchv/go-winloader/loader_windows.go +33 -0
  162. package/govendor/manifest.txt +3 -1
  163. package/package.json +1 -1
  164. package/tsparser/main.go +4 -0
  165. package/types/typenative-go.d.ts +23 -0
  166. package/types/typenative-npm.d.ts +359 -7
  167. package/types/typenative.d.ts +283 -42
@@ -8,13 +8,26 @@ interface Boolean {}
8
8
 
9
9
  interface Function {
10
10
  readonly name: string;
11
+ readonly length: number;
11
12
  apply(thisArg: any, argArray?: any): any;
12
13
  call(thisArg: any, ...argArray: any[]): any;
14
+ /** `thisArg` is ignored for plain functions; the bound arguments are fixed */
15
+ bind(thisArg: any, ...argArray: any[]): any;
13
16
  }
14
17
 
15
- 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
+ }
16
25
  interface NewableFunction extends Function {}
17
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
+
18
31
  interface IArguments {
19
32
  [index: number]: any;
20
33
  length: number;
@@ -24,11 +37,14 @@ interface Number {
24
37
  toString(radix?: number): string;
25
38
  toFixed(fractionDigits?: number): string;
26
39
  toPrecision(precision?: number): string;
40
+ toExponential(fractionDigits?: number): string;
27
41
  }
28
42
 
29
43
  interface Object {
30
44
  constructor: Function;
31
45
  toString(): string;
46
+ valueOf(): Object;
47
+ hasOwnProperty(v: PropertyKey): boolean;
32
48
  }
33
49
 
34
50
  // --- Iteration protocol (also unlocks for..of / spread over Map, Set, string) ---
@@ -61,7 +77,26 @@ interface IterableIterator<T, TReturn = any, TNext = undefined> extends Iterator
61
77
 
62
78
  interface Generator<T = any, TReturn = any, TNext = any> extends Iterator<T, TReturn, TNext> {
63
79
  [Symbol.iterator](): Generator<T, TReturn, TNext>;
64
- }
80
+ // ES2025 iterator helpers (lazy)
81
+ map<U>(callbackfn: (value: T, index: number) => U): Generator<U>;
82
+ filter(predicate: (value: T, index: number) => unknown): Generator<T>;
83
+ flatMap<U>(callback: (value: T, index: number) => U[]): Generator<U>;
84
+ take(limit: number): Generator<T>;
85
+ drop(count: number): Generator<T>;
86
+ toArray(): T[];
87
+ forEach(callbackfn: (value: T, index: number) => void): void;
88
+ some(predicate: (value: T, index: number) => unknown): boolean;
89
+ every(predicate: (value: T, index: number) => unknown): boolean;
90
+ find(predicate: (value: T, index: number) => unknown): T | undefined;
91
+ reduce<U>(callbackfn: (accumulator: U, value: T, index: number) => U, initialValue: U): U;
92
+ reduce(callbackfn: (accumulator: T, value: T, index: number) => T): T;
93
+ }
94
+
95
+ interface IteratorConstructor {
96
+ /** An iterator over an array or generator (with the iterator helpers) */
97
+ from<T>(source: T[] | Generator<T>): Generator<T>;
98
+ }
99
+ declare var Iterator: IteratorConstructor;
65
100
 
66
101
  interface AsyncIterator<T, TReturn = any, TNext = any> {
67
102
  next(...[value]: [] | [TNext]): Promise<IteratorResult<T, TReturn>>;
@@ -86,11 +121,14 @@ interface Disposable {
86
121
  [Symbol.dispose](): void;
87
122
  }
88
123
 
89
- // 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)
90
126
  type Awaited<T> = T extends null | undefined
91
127
  ? T
92
- : T extends { then(onfulfilled: (value: infer U) => any): any }
93
- ? 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
94
132
  : T;
95
133
 
96
134
  // Tagged template functions: tag`a${x}b`
@@ -117,6 +155,8 @@ type NonNullable<T> = T & {};
117
155
  type Record<K extends keyof any, T> = { [P in K]: T };
118
156
  type Parameters<T extends (...args: any) => any> = T extends (...args: infer P) => any ? P : never;
119
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;
120
160
 
121
161
  // --- RegExp ---
122
162
 
@@ -140,6 +180,12 @@ interface RegExpExecArray extends Array<string> {
140
180
  readonly groups: Record<string, string> | undefined;
141
181
  }
142
182
 
183
+ // match() result: .index is set unless the regex is /g (that returns every match)
184
+ interface RegExpMatchArray extends Array<string> {
185
+ index?: number;
186
+ readonly groups?: Record<string, string> | undefined;
187
+ }
188
+
143
189
  interface RegExpConstructor {
144
190
  new (pattern: string | RegExp, flags?: string): RegExp;
145
191
  (pattern: string | RegExp, flags?: string): RegExp;
@@ -149,6 +195,14 @@ declare var RegExp: RegExpConstructor;
149
195
 
150
196
  // --- Array ---
151
197
 
198
+ /** import data from './data.json' with { type: 'json' } */
199
+ interface ImportAttributes {
200
+ [key: string]: string;
201
+ }
202
+
203
+ /** readonly T[] / ReadonlyArray<T> (mutating methods are not hidden) */
204
+ interface ReadonlyArray<T> extends Array<T> {}
205
+
152
206
  interface Array<T> extends IterableIterator<T> {
153
207
  /**
154
208
  * Gets or sets the length of the array. This is a number one higher than the highest index in the array.
@@ -169,35 +223,37 @@ interface Array<T> extends IterableIterator<T> {
169
223
  /**
170
224
  * Calls a defined callback function on each element of an array, and returns an array that contains the results.
171
225
  */
172
- map<U>(callback: (value: T, index?: number, array?: T[]) => U): U[];
226
+ map<U>(callback: (value: T, index: number, array: T[]) => U): U[];
173
227
  /**
174
228
  * Returns the elements of an array that meet the condition specified in a callback function.
175
229
  */
176
- 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[];
177
232
  /**
178
233
  * Determines whether the specified callback function returns true for any element of an array.
179
234
  */
180
- some(callback: (value: T, index?: number, array?: T[]) => boolean): boolean;
235
+ some(callback: (value: T, index: number, array: T[]) => unknown): boolean;
181
236
  /**
182
237
  * Returns the value of the first element in the array where callback is true, and undefined otherwise.
183
238
  */
184
- 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;
185
241
  /**
186
242
  * Returns the index of the first element that satisfies the callback, or -1.
187
243
  */
188
- findIndex(callback: (value: T, index?: number, array?: T[]) => boolean): number;
244
+ findIndex(callback: (value: T, index: number, array: T[]) => unknown): number;
189
245
  /**
190
246
  * Returns the value of the last element where callback is true, and undefined otherwise.
191
247
  */
192
- findLast(callback: (value: T, index?: number, array?: T[]) => boolean): T | undefined;
248
+ findLast(callback: (value: T, index: number, array: T[]) => unknown): T | undefined;
193
249
  /**
194
250
  * Returns the index of the last element that satisfies the callback, or -1.
195
251
  */
196
- findLastIndex(callback: (value: T, index?: number, array?: T[]) => boolean): number;
252
+ findLastIndex(callback: (value: T, index: number, array: T[]) => unknown): number;
197
253
  /**
198
254
  * Determines whether all elements satisfy the callback.
199
255
  */
200
- every(callback: (value: T, index?: number, array?: T[]) => boolean): boolean;
256
+ every(callback: (value: T, index: number, array: T[]) => unknown): boolean;
201
257
  /**
202
258
  * Performs the callback for each element.
203
259
  */
@@ -245,7 +301,7 @@ interface Array<T> extends IterableIterator<T> {
245
301
  /**
246
302
  * Reverses the elements of an array in place.
247
303
  */
248
- reverse(): T[];
304
+ reverse(): this;
249
305
  /**
250
306
  * Returns a reversed copy of the array.
251
307
  */
@@ -253,7 +309,7 @@ interface Array<T> extends IterableIterator<T> {
253
309
  /**
254
310
  * Sorts the elements of an array in place.
255
311
  */
256
- sort(compareFn?: (a: T, b: T) => number): T[];
312
+ sort(compareFn?: (a: T, b: T) => number): this;
257
313
  /**
258
314
  * Returns a sorted copy of the array.
259
315
  */
@@ -278,11 +334,11 @@ interface Array<T> extends IterableIterator<T> {
278
334
  /**
279
335
  * Returns a copy of a section of an array with the fill value applied.
280
336
  */
281
- fill(value: T, start?: number, end?: number): T[];
337
+ fill(value: T, start?: number, end?: number): this;
282
338
  /**
283
339
  * Copies within the array in place (overlap-safe) and returns it.
284
340
  */
285
- copyWithin(target: number, start: number, end?: number): T[];
341
+ copyWithin(target: number, start: number, end?: number): this;
286
342
  /**
287
343
  * Merges two or more arrays (array arguments are flattened one level).
288
344
  */
@@ -305,9 +361,12 @@ interface Array<T> extends IterableIterator<T> {
305
361
 
306
362
  interface ArrayConstructor {
307
363
  new <T>(length: number): T[];
364
+ new <T>(...items: T[]): T[];
308
365
  isArray(arg: any): arg is any[];
309
- from<T>(arrayLike: ArrayLike<T>): T[];
310
- 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[];
368
+ of<T>(...items: T[]): T[];
369
+ readonly prototype: any[];
311
370
  }
312
371
 
313
372
  declare var Array: ArrayConstructor;
@@ -324,7 +383,17 @@ interface String {
324
383
  /** Returns the position of the first occurrence of a substring. */
325
384
  indexOf(searchString: string, position?: number): number;
326
385
  /** Returns the position of the last occurrence of a substring. */
327
- lastIndexOf(searchString: string): number;
386
+ lastIndexOf(searchString: string, position?: number): number;
387
+ /** The code point at a (code point) index; NaN past the end */
388
+ codePointAt(pos: number): number;
389
+ /** Deprecated: `length` characters from `from` */
390
+ substr(from: number, length?: number): string;
391
+ trimLeft(): string;
392
+ trimRight(): string;
393
+ toLocaleUpperCase(locales?: string | string[]): string;
394
+ toLocaleLowerCase(locales?: string | string[]): string;
395
+ isWellFormed(): boolean;
396
+ toWellFormed(): string;
328
397
  /** Determines whether a string contains the specified substring. */
329
398
  includes(searchString: string): boolean;
330
399
  /** Determines whether a string begins with the specified characters. */
@@ -332,7 +401,7 @@ interface String {
332
401
  /** Determines whether a string ends with the specified characters. */
333
402
  endsWith(searchString: string): boolean;
334
403
  /** Splits a string into substrings using the specified separator. */
335
- split(separator: string | RegExp): string[];
404
+ split(separator: string | RegExp, limit?: number): string[];
336
405
  /** Removes whitespace from both ends of a string. */
337
406
  trim(): string;
338
407
  /** Removes whitespace from the beginning of a string. */
@@ -361,9 +430,9 @@ interface String {
361
430
  /** Pads the end of a string with another string to a total length. */
362
431
  padEnd(targetLength: number, padString?: string): string;
363
432
  /** Matches a string against a regex and returns the matches. */
364
- match(regexp: string | RegExp): string[] | null;
433
+ match(regexp: string | RegExp): RegExpMatchArray | null;
365
434
  /** Matches all occurrences of a regex. */
366
- matchAll(regexp: string | RegExp): string[][];
435
+ matchAll(regexp: string | RegExp): RegExpExecArray[];
367
436
  /** Searches for a match and returns the index. */
368
437
  search(regexp: string | RegExp): number;
369
438
  /** Returns the character at the given index (supports negative indices). */
@@ -382,6 +451,7 @@ interface String {
382
451
  interface StringConstructor {
383
452
  (value?: any): string;
384
453
  fromCharCode(...charCodes: number[]): string;
454
+ fromCodePoint(...codePoints: number[]): string;
385
455
  raw(strings: TemplateStringsArray, ...values: any[]): string;
386
456
  }
387
457
 
@@ -389,13 +459,18 @@ declare var String: StringConstructor;
389
459
 
390
460
  interface NumberConstructor {
391
461
  (value?: any): number;
392
- isNaN(value: number): boolean;
393
- isFinite(value: number): boolean;
394
- isInteger(value: number): boolean;
462
+ isNaN(value: unknown): boolean;
463
+ isFinite(value: unknown): boolean;
464
+ isInteger(value: unknown): boolean;
395
465
  readonly MAX_SAFE_INTEGER: number;
396
466
  readonly MIN_SAFE_INTEGER: number;
397
467
  readonly MAX_VALUE: number;
468
+ readonly MIN_VALUE: number;
398
469
  readonly POSITIVE_INFINITY: number;
470
+ readonly NEGATIVE_INFINITY: number;
471
+ isSafeInteger(value: number): boolean;
472
+ parseInt(string: string, radix?: number): number;
473
+ parseFloat(string: string): number;
399
474
  readonly EPSILON: number;
400
475
  readonly NaN: number;
401
476
  }
@@ -459,6 +534,13 @@ interface Math {
459
534
  sinh(x: number): number;
460
535
  cosh(x: number): number;
461
536
  tanh(x: number): number;
537
+ asinh(x: number): number;
538
+ acosh(x: number): number;
539
+ atanh(x: number): number;
540
+ fround(x: number): number;
541
+ imul(a: number, b: number): number;
542
+ clz32(x: number): number;
543
+ sumPrecise(values: number[]): number;
462
544
  cbrt(x: number): number;
463
545
  hypot(...values: number[]): number;
464
546
  trunc(x: number): number;
@@ -473,6 +555,8 @@ declare function isNaN(number: number): boolean;
473
555
  declare function isFinite(number: number): boolean;
474
556
  declare function encodeURIComponent(uriComponent: string): string;
475
557
  declare function decodeURIComponent(uriComponent: string): string;
558
+ declare function encodeURI(uri: string): string;
559
+ declare function decodeURI(encodedURI: string): string;
476
560
  declare function structuredClone<T>(value: T): T;
477
561
 
478
562
  // The running program (a native binary has no separate script file)
@@ -503,23 +587,52 @@ declare function queueMicrotask(callback: () => void): void;
503
587
  // --- JSON / Object / process ---
504
588
 
505
589
  interface JSON {
506
- stringify(value: any, replacer?: any, space?: number | string): string;
507
- parse(text: string): any;
590
+ stringify(
591
+ value: any,
592
+ replacer?: ((key: string, value: any) => any) | (string | number)[] | null,
593
+ space?: number | string
594
+ ): string;
595
+ parse(text: string, reviver?: (key: string, value: any) => any): any;
508
596
  }
509
597
  declare var JSON: JSON;
510
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
+
511
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;
619
+ /** SameValue: NaN is NaN, +0 is not -0 */
620
+ is(a: any, b: any): boolean;
621
+ groupBy<T>(items: T[], keySelector: (item: T, index: number) => string | number): Record<string, T[]>;
512
622
  keys(obj: any): string[];
513
623
  values(obj: any): any[];
514
624
  entries(obj: any): [string, any][];
515
625
  assign(target: any, ...sources: any[]): any;
516
626
  fromEntries(entries: Iterable<readonly [string, any]>): any;
517
627
  hasOwn(obj: any, key: string): boolean;
518
- defineProperty<T>(
519
- obj: T,
520
- key: string,
521
- descriptor: { value: any; enumerable?: boolean; writable?: boolean; configurable?: boolean }
522
- ): 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 };
523
636
  getOwnPropertyNames(obj: any): string[];
524
637
  freeze<T>(obj: T): T;
525
638
  seal<T>(obj: T): T;
@@ -530,6 +643,15 @@ interface ObjectConstructor {
530
643
  }
531
644
  declare var Object: ObjectConstructor;
532
645
 
646
+ /** process.stdout / stderr terminal info: 0 columns and rows when not a terminal */
647
+ interface TnTtyOutput {
648
+ readonly isTTY?: boolean;
649
+ readonly columns: number;
650
+ readonly rows: number;
651
+ /** [columns, rows] */
652
+ getWindowSize(): [number, number];
653
+ }
654
+
533
655
  interface Process {
534
656
  argv: string[];
535
657
  readonly argv0: string;
@@ -555,7 +677,7 @@ interface Process {
555
677
  };
556
678
  nextTick<A extends any[]>(callback: (...args: A) => void, ...args: A): void;
557
679
  kill(pid: number, signal?: string | number): true;
558
- emitWarning(warning: string | Error): void;
680
+ emitWarning(warning: string | Error, type?: string): void;
559
681
  getuid(): number;
560
682
  getgid(): number;
561
683
  geteuid(): number;
@@ -585,9 +707,22 @@ interface Process {
585
707
  on(event: 'uncaughtException' | 'uncaughtExceptionMonitor', listener: (error: Error, origin: 'uncaughtException' | 'unhandledRejection') => void): this;
586
708
  on(event: 'unhandledRejection', listener: (reason: unknown, promise: Promise<unknown>) => void): this;
587
709
  on(event: 'beforeExit', listener: (code: number) => void): this;
588
- readonly stdout: import('node:stream').Writable & { readonly isTTY?: boolean; readonly fd: 1 };
589
- readonly stderr: import('node:stream').Writable & { readonly isTTY?: boolean; readonly fd: 2 };
590
- readonly stdin: import('node:stream').Readable & { readonly isTTY?: boolean; readonly fd: 0 };
710
+ readonly stdout: import('node:stream').Writable & TnTtyOutput & { readonly fd: 1 };
711
+ readonly stderr: import('node:stream').Writable & TnTtyOutput & { readonly fd: 2 };
712
+ readonly stdin: {
713
+ /** After readline.emitKeypressEvents(process.stdin) */
714
+ on(event: 'keypress', listener: (str: string, key: import('node:readline').Key) => void): import('node:stream').Readable;
715
+ once(event: 'keypress', listener: (str: string, key: import('node:readline').Key) => void): import('node:stream').Readable;
716
+ } & import('node:stream').Readable & {
717
+ readonly isTTY?: boolean;
718
+ readonly fd: 0;
719
+ /** Whether raw mode is on */
720
+ readonly isRaw: boolean;
721
+ /** Raw mode (no echo, no line buffering, Ctrl+C as a byte); throws when stdin is not a terminal */
722
+ setRawMode(mode: boolean): void;
723
+ };
724
+ /** The file mode creation mask; with an argument sets it and returns the previous one (0 on Windows) */
725
+ umask(mask?: number | string): number;
591
726
  on(event: 'exit', listener: (code: number) => void): this;
592
727
  on(event: string, listener: (...args: any[]) => void): this;
593
728
  once(event: 'exit', listener: (code: number) => void): this;
@@ -634,6 +769,17 @@ type TypeError = Error;
634
769
  type RangeError = Error;
635
770
  type SyntaxError = Error;
636
771
 
772
+ interface AggregateError extends Error {
773
+ errors: any[];
774
+ }
775
+
776
+ interface AggregateErrorConstructor {
777
+ new (errors: Iterable<any>, message?: string, options?: ErrorOptions): AggregateError;
778
+ (errors: Iterable<any>, message?: string, options?: ErrorOptions): AggregateError;
779
+ }
780
+
781
+ declare var AggregateError: AggregateErrorConstructor;
782
+
637
783
  interface Date {
638
784
  getTime(): number;
639
785
  valueOf(): number;
@@ -658,11 +804,45 @@ interface Date {
658
804
  toString(): string;
659
805
  toDateString(): string;
660
806
  toTimeString(): string;
807
+ toUTCString(): string;
808
+ toGMTString(): string;
809
+ /** en-US format; locales and options are ignored */
810
+ toLocaleDateString(locales?: string | string[], options?: any): string;
811
+ /** en-US format; locales and options are ignored */
812
+ toLocaleTimeString(locales?: string | string[], options?: any): string;
813
+ /** en-US format; locales and options are ignored */
814
+ toLocaleString(locales?: string | string[], options?: any): string;
815
+ getTimezoneOffset(): number;
816
+ setTime(time: number): number;
817
+ setFullYear(year: number, month?: number, date?: number): number;
818
+ setMonth(month: number, date?: number): number;
819
+ setDate(date: number): number;
820
+ setHours(hours: number, min?: number, sec?: number, ms?: number): number;
821
+ setMinutes(min: number, sec?: number, ms?: number): number;
822
+ setSeconds(sec: number, ms?: number): number;
823
+ setMilliseconds(ms: number): number;
824
+ setUTCFullYear(year: number, month?: number, date?: number): number;
825
+ setUTCMonth(month: number, date?: number): number;
826
+ setUTCDate(date: number): number;
827
+ setUTCHours(hours: number, min?: number, sec?: number, ms?: number): number;
828
+ setUTCMinutes(min: number, sec?: number, ms?: number): number;
829
+ setUTCSeconds(sec: number, ms?: number): number;
830
+ setUTCMilliseconds(ms: number): number;
661
831
  }
662
832
 
663
833
  interface DateConstructor {
664
834
  new (): Date;
665
- new (ms: number): Date;
835
+ new (value: number | string | Date): Date;
836
+ new (
837
+ year: number,
838
+ monthIndex: number,
839
+ date?: number,
840
+ hours?: number,
841
+ minutes?: number,
842
+ seconds?: number,
843
+ ms?: number
844
+ ): Date;
845
+ parse(s: string): number;
666
846
  now(): number;
667
847
  UTC(
668
848
  year: number,
@@ -692,15 +872,37 @@ interface PromiseLike<T> {
692
872
 
693
873
  interface PromiseConstructor {
694
874
  new <T>(
695
- executor: (resolve: (value: T) => void, reject?: (reason?: any) => void) => void
875
+ executor: (resolve: (value: T) => void, reject: (reason?: any) => void) => void
696
876
  ): Promise<T>;
697
877
  resolve(): Promise<void>;
698
878
  resolve<T>(value: T): Promise<T>;
699
879
  reject(reason?: any): Promise<never>;
700
- all<T>(values: Promise<T>[]): Promise<T[]>;
880
+ all<T>(values: (T | PromiseLike<T>)[]): Promise<Awaited<T>[]>;
701
881
  race<T>(values: Promise<T>[]): Promise<T>;
702
882
  any<T>(values: Promise<T>[]): Promise<T>;
703
883
  allSettled<T>(values: Promise<T>[]): Promise<{ status: string; value?: T; reason?: any }[]>;
884
+ withResolvers<T>(): PromiseWithResolvers<T>;
885
+ try<T>(fn: (...args: any[]) => T | Promise<T>, ...args: any[]): Promise<T>;
886
+ }
887
+
888
+ interface WeakRef<T extends object> {
889
+ /** The target, or undefined once it was garbage-collected */
890
+ deref(): T | undefined;
891
+ }
892
+ declare var WeakRef: { new <T extends object>(target: T): WeakRef<T> };
893
+
894
+ interface FinalizationRegistry<T> {
895
+ register(target: object, heldValue: T, unregisterToken?: object): void;
896
+ unregister(unregisterToken: object): boolean;
897
+ }
898
+ declare var FinalizationRegistry: {
899
+ new <T>(cleanupCallback: (heldValue: T) => void): FinalizationRegistry<T>;
900
+ };
901
+
902
+ interface PromiseWithResolvers<T> {
903
+ promise: Promise<T>;
904
+ resolve: (value: T) => void;
905
+ reject: (reason?: any) => void;
704
906
  }
705
907
 
706
908
  declare var Promise: PromiseConstructor;
@@ -726,13 +928,16 @@ interface Map<K, V> {
726
928
  keys(): K[];
727
929
  /** The values, in insertion order. */
728
930
  values(): V[];
931
+ /** The [key, value] pairs, in insertion order. */
932
+ entries(): [K, V][];
729
933
  /** Iterates [key, value] pairs in insertion order. */
730
934
  [Symbol.iterator](): IterableIterator<[K, V]>;
731
935
  }
732
936
 
733
937
  interface MapConstructor {
734
938
  new <K, V>(): Map<K, V>;
735
- 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>;
940
+ groupBy<K, T>(items: T[], keySelector: (item: T, index: number) => K): Map<K, T[]>;
736
941
  }
737
942
 
738
943
  declare var Map: MapConstructor;
@@ -765,7 +970,7 @@ interface Set<T> {
765
970
 
766
971
  interface SetConstructor {
767
972
  new <T>(): Set<T>;
768
- new <T>(values?: T[] | Set<T>): Set<T>;
973
+ new <T>(values?: readonly T[] | Set<T> | Iterable<T> | null): Set<T>;
769
974
  }
770
975
 
771
976
  declare var Set: SetConstructor;
@@ -805,10 +1010,16 @@ interface SymbolConstructor {
805
1010
  readonly iterator: unique symbol;
806
1011
  readonly asyncIterator: unique symbol;
807
1012
  readonly dispose: unique symbol;
1013
+ for(key: string): symbol;
1014
+ keyFor(sym: symbol): string | undefined;
808
1015
  }
809
1016
 
810
1017
  declare var Symbol: SymbolConstructor;
811
1018
 
1019
+ interface Symbol {
1020
+ readonly description: string;
1021
+ }
1022
+
812
1023
  // --- Decorators (class and class-method decorators are lowered) ---
813
1024
 
814
1025
  interface ClassDecoratorContext<Class extends abstract new (...args: any) => any = abstract new (...args: any) => any> {
@@ -837,6 +1048,14 @@ interface BigInt {
837
1048
  toString(radix?: number): string;
838
1049
  }
839
1050
 
1051
+ interface BigIntConstructor {
1052
+ (value: bigint | boolean | number | string): bigint;
1053
+ asIntN(bits: number, int: bigint): bigint;
1054
+ asUintN(bits: number, int: bigint): bigint;
1055
+ }
1056
+
1057
+ declare var BigInt: BigIntConstructor;
1058
+
840
1059
  // --- Node.js globals (Buffer, URL, TextEncoder, AbortController, performance, …) ---
841
1060
 
842
1061
  type BufferEncoding =
@@ -864,6 +1083,8 @@ interface Uint8Array {
864
1083
  slice(start?: number, end?: number): Uint8Array;
865
1084
  set(array: ArrayLike<number>, offset?: number): void;
866
1085
  at(index: number): number | undefined;
1086
+ /** Base64 of the bytes (ES2026) */
1087
+ toBase64(): string;
867
1088
  [Symbol.iterator](): IterableIterator<number>;
868
1089
  }
869
1090
 
@@ -873,6 +1094,8 @@ interface Uint8ArrayConstructor {
873
1094
  // A view sharing the buffer's memory
874
1095
  new (buffer: ArrayBuffer, byteOffset?: number, length?: number): Uint8Array;
875
1096
  from(arrayLike: ArrayLike<number> | Iterable<number>): Uint8Array;
1097
+ /** The bytes a base64 string encodes (ES2026) */
1098
+ fromBase64(base64: string): Uint8Array;
876
1099
  }
877
1100
 
878
1101
  declare var Uint8Array: Uint8ArrayConstructor;
@@ -1065,6 +1288,8 @@ interface Buffer extends Uint8Array {
1065
1288
  }
1066
1289
 
1067
1290
  interface BufferConstructor {
1291
+ /** @deprecated use Buffer.alloc / Buffer.from (lets `typeof Buffer === 'function'` narrow) */
1292
+ new (size: number): Buffer;
1068
1293
  from(data: string, encoding?: BufferEncoding): Buffer;
1069
1294
  from(data: ArrayLike<number> | Uint8Array | ArrayBuffer): Buffer;
1070
1295
  alloc(size: number, fill?: string | number | Uint8Array, encoding?: BufferEncoding): Buffer;
@@ -1453,6 +1678,22 @@ declare function setImmediate<A extends any[]>(callback: (...args: A) => void, .
1453
1678
  declare function clearImmediate(immediate?: NodeJS.Immediate | number): void;
1454
1679
 
1455
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
+ }
1456
1697
  // Timer handles: an unref'ed timer does not keep the process alive
1457
1698
  interface Timeout {
1458
1699
  ref(): this;