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
@@ -513,8 +513,15 @@ declare module 'node:util' {
513
513
  value?: string;
514
514
  inlineValue?: boolean;
515
515
  }
516
- function parseArgs(config?: ParseArgsConfig): {
517
- values: Record<string, string | boolean | (string | boolean)[] | undefined>;
516
+ // The parsed value of an option: its type, an array of them when multiple
517
+ type ParseArgsOptionValue<O extends ParseArgsOptionConfig> = O['type'] extends 'string'
518
+ ? O['multiple'] extends true ? string[] : string
519
+ : O['multiple'] extends true ? boolean[] : boolean;
520
+ type ParseArgsValues<T extends ParseArgsConfig> = T['options'] extends Record<string, ParseArgsOptionConfig>
521
+ ? { -readonly [K in keyof T['options']]?: ParseArgsOptionValue<T['options'][K]> }
522
+ : Record<string, string | boolean | (string | boolean)[] | undefined>;
523
+ function parseArgs<T extends ParseArgsConfig>(config?: T): {
524
+ values: ParseArgsValues<T>;
518
525
  positionals: string[];
519
526
  tokens?: ParseArgsToken[];
520
527
  };
@@ -609,16 +616,18 @@ declare module 'node:assert/strict' {
609
616
  }
610
617
 
611
618
  declare module 'node:crypto' {
619
+ import { Transform } from 'node:stream';
612
620
  namespace crypto {
613
621
  type BinaryLike = string | Uint8Array;
614
622
  type BinaryToTextEncoding = 'base64' | 'base64url' | 'hex' | 'binary';
615
- interface Hash {
623
+ /** Hash / Hmac are also Transform streams: write, then read or pipe the digest */
624
+ interface Hash extends Transform {
616
625
  update(data: BinaryLike, inputEncoding?: BufferEncoding): Hash;
617
626
  digest(): Buffer;
618
627
  digest(encoding: BinaryToTextEncoding | BufferEncoding): string;
619
628
  copy(): Hash;
620
629
  }
621
- interface Hmac {
630
+ interface Hmac extends Transform {
622
631
  update(data: BinaryLike, inputEncoding?: BufferEncoding): Hmac;
623
632
  digest(): Buffer;
624
633
  digest(encoding: BinaryToTextEncoding | BufferEncoding): string;
@@ -1245,6 +1254,8 @@ declare module 'node:stream' {
1245
1254
  resume(): this;
1246
1255
  isPaused(): boolean;
1247
1256
  pipe<T extends Writable>(destination: T, options?: { end?: boolean }): T;
1257
+ /** A stream to pipe into, or a function given this stream (an async generator over its chunks, a node:test reporter) */
1258
+ compose(stream: Duplex | ((source: any) => any)): Duplex;
1248
1259
  destroy(error?: Error): this;
1249
1260
  [Symbol.asyncIterator](): AsyncIterator<any>;
1250
1261
  static toWeb(streamReadable: Readable, options?: { strategy?: QueuingStrategy }): ReadableStream;
@@ -1564,6 +1575,8 @@ declare module 'node:child_process' {
1564
1575
  shell?: boolean | string;
1565
1576
  stdio?: StdioOption | StdioOption[];
1566
1577
  input?: string | Uint8Array;
1578
+ /** spawn: run the child in its own session / process group, so it can outlive the parent (with unref()) */
1579
+ detached?: boolean;
1567
1580
  }
1568
1581
  interface ExecException extends Error {
1569
1582
  code?: number;
@@ -1594,6 +1607,9 @@ declare module 'node:child_process' {
1594
1607
  readonly spawnfile: string;
1595
1608
  readonly connected: boolean;
1596
1609
  kill(signal?: string | number): boolean;
1610
+ /** The parent no longer waits for the child */
1611
+ unref(): void;
1612
+ ref(): void;
1597
1613
  send(message: any, callback?: (error: Error | null) => void): boolean;
1598
1614
  disconnect(): void;
1599
1615
  }
@@ -1656,6 +1672,17 @@ declare module 'node:readline' {
1656
1672
  function moveCursor(stream: Writable, dx: number, dy: number, callback?: () => void): boolean;
1657
1673
  function clearLine(stream: Writable, dir: Direction, callback?: () => void): boolean;
1658
1674
  function clearScreenDown(stream: Writable, callback?: () => void): boolean;
1675
+ /** A decoded key ('keypress' events); missing fields are "" */
1676
+ interface Key {
1677
+ sequence?: string;
1678
+ name?: string;
1679
+ ctrl?: boolean;
1680
+ meta?: boolean;
1681
+ shift?: boolean;
1682
+ code?: string;
1683
+ }
1684
+ /** Makes the stream emit 'keypress' (str, key) events (str is "" for escape sequences) */
1685
+ function emitKeypressEvents(stream: Readable, readlineInterface?: Interface): void;
1659
1686
  const promises: typeof import('node:readline/promises');
1660
1687
  }
1661
1688
  export = readline;
@@ -1682,6 +1709,58 @@ declare module 'node:readline/promises' {
1682
1709
  export = promises;
1683
1710
  }
1684
1711
 
1712
+ declare module 'node:module' {
1713
+ namespace Module {
1714
+ /** Node's built-in module names (without the node:-only ones such as node:test) */
1715
+ const builtinModules: string[];
1716
+ /** Whether the specifier names a built-in module ('fs', 'node:fs', 'node:test') */
1717
+ function isBuiltin(moduleName: string): boolean;
1718
+ interface Require {
1719
+ /** require('./data.json'): JSON files only, read at compile time */
1720
+ (id: string): any;
1721
+ }
1722
+ /** const require = createRequire(import.meta.url): its require() loads JSON files */
1723
+ function createRequire(path: string | URL): Require;
1724
+ }
1725
+ export = Module;
1726
+ }
1727
+
1728
+ declare module 'node:v8' {
1729
+ namespace v8 {
1730
+ interface HeapInfo {
1731
+ total_heap_size: number;
1732
+ total_heap_size_executable: number;
1733
+ total_physical_size: number;
1734
+ total_available_size: number;
1735
+ used_heap_size: number;
1736
+ heap_size_limit: number;
1737
+ malloced_memory: number;
1738
+ peak_malloced_memory: number;
1739
+ does_zap_garbage: number;
1740
+ number_of_native_contexts: number;
1741
+ number_of_detached_contexts: number;
1742
+ total_global_handles_size: number;
1743
+ used_global_handles_size: number;
1744
+ external_memory: number;
1745
+ }
1746
+ /** From Go's runtime.MemStats; the limit is GOMEMLIMIT, else 4 GiB */
1747
+ function getHeapStatistics(): HeapInfo;
1748
+ /** The structured-clone codec workers use (not V8's wire format) */
1749
+ function serialize(value: any): Buffer;
1750
+ function deserialize(buffer: Uint8Array): any;
1751
+ }
1752
+ export = v8;
1753
+ }
1754
+
1755
+ declare module 'node:sea' {
1756
+ /** Always true: a TypeNative program is a single executable */
1757
+ export function isSea(): boolean;
1758
+ /** TypeNative binaries carry no assets yet: throws ERR_SINGLE_EXECUTABLE_APPLICATION_ASSET_NOT_FOUND */
1759
+ export function getAsset(key: string): ArrayBuffer;
1760
+ export function getAsset(key: string, encoding: string): string;
1761
+ export function getRawAsset(key: string): ArrayBuffer;
1762
+ }
1763
+
1685
1764
  declare module 'node:diagnostics_channel' {
1686
1765
  namespace diagnostics_channel {
1687
1766
  type ChannelListener = (message: unknown, name: string | symbol) => void;
@@ -1883,6 +1962,47 @@ declare module 'node:dns' {
1883
1962
  priority: number;
1884
1963
  weight: number;
1885
1964
  }
1965
+ interface RecordWithTtl {
1966
+ address: string;
1967
+ ttl: number;
1968
+ }
1969
+ interface ResolveWithTtlOptions {
1970
+ ttl: true;
1971
+ }
1972
+ interface SoaRecord {
1973
+ nsname: string;
1974
+ hostmaster: string;
1975
+ serial: number;
1976
+ refresh: number;
1977
+ retry: number;
1978
+ expire: number;
1979
+ minttl: number;
1980
+ }
1981
+ interface NaptrRecord {
1982
+ flags: string;
1983
+ service: string;
1984
+ regexp: string;
1985
+ replacement: string;
1986
+ order: number;
1987
+ preference: number;
1988
+ }
1989
+ interface CaaRecord {
1990
+ critical: number;
1991
+ issue?: string;
1992
+ issuewild?: string;
1993
+ iodef?: string;
1994
+ contactemail?: string;
1995
+ contactphone?: string;
1996
+ }
1997
+ type AnyRecord =
1998
+ | (RecordWithTtl & { type: 'A' | 'AAAA' })
1999
+ | { type: 'CNAME' | 'NS' | 'PTR'; value: string }
2000
+ | (MxRecord & { type: 'MX' })
2001
+ | (SoaRecord & { type: 'SOA' })
2002
+ | { type: 'TXT'; entries: string[] }
2003
+ | (SrvRecord & { type: 'SRV' })
2004
+ | (NaptrRecord & { type: 'NAPTR' })
2005
+ | (CaaRecord & { type: 'CAA' });
1886
2006
  function lookup(hostname: string, callback: (err: NodeJS.ErrnoException | null, address: string, family: number) => void): void;
1887
2007
  function lookup(hostname: string, family: number, callback: (err: NodeJS.ErrnoException | null, address: string, family: number) => void): void;
1888
2008
  function lookup(hostname: string, options: LookupOptions & { all: true }, callback: (err: NodeJS.ErrnoException | null, addresses: LookupAddress[]) => void): void;
@@ -1892,6 +2012,17 @@ declare module 'node:dns' {
1892
2012
  function resolve(hostname: string, rrtype: 'MX', callback: (err: NodeJS.ErrnoException | null, addresses: MxRecord[]) => void): void;
1893
2013
  function resolve(hostname: string, rrtype: 'TXT', callback: (err: NodeJS.ErrnoException | null, addresses: string[][]) => void): void;
1894
2014
  function resolve(hostname: string, rrtype: 'SRV', callback: (err: NodeJS.ErrnoException | null, addresses: SrvRecord[]) => void): void;
2015
+ function resolve(hostname: string, rrtype: 'ANY', callback: (err: NodeJS.ErrnoException | null, addresses: AnyRecord[]) => void): void;
2016
+ function resolve(hostname: string, rrtype: 'CAA', callback: (err: NodeJS.ErrnoException | null, addresses: CaaRecord[]) => void): void;
2017
+ function resolve(hostname: string, rrtype: 'NAPTR', callback: (err: NodeJS.ErrnoException | null, addresses: NaptrRecord[]) => void): void;
2018
+ function resolve(hostname: string, rrtype: 'SOA', callback: (err: NodeJS.ErrnoException | null, address: SoaRecord) => void): void;
2019
+ function resolve4(hostname: string, options: ResolveWithTtlOptions, callback: (err: NodeJS.ErrnoException | null, addresses: RecordWithTtl[]) => void): void;
2020
+ function resolve6(hostname: string, options: ResolveWithTtlOptions, callback: (err: NodeJS.ErrnoException | null, addresses: RecordWithTtl[]) => void): void;
2021
+ function resolveAny(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: AnyRecord[]) => void): void;
2022
+ function resolveCaa(hostname: string, callback: (err: NodeJS.ErrnoException | null, records: CaaRecord[]) => void): void;
2023
+ function resolveNaptr(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: NaptrRecord[]) => void): void;
2024
+ function resolvePtr(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
2025
+ function resolveSoa(hostname: string, callback: (err: NodeJS.ErrnoException | null, address: SoaRecord) => void): void;
1895
2026
  function resolve4(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
1896
2027
  function resolve6(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
1897
2028
  function resolveCname(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
@@ -1905,6 +2036,7 @@ declare module 'node:dns' {
1905
2036
  function lookupService(address: string, port: number, callback: (err: NodeJS.ErrnoException | null, hostname: string, service: string) => void): void;
1906
2037
  interface ResolverOptions {
1907
2038
  timeout?: number;
2039
+ /** Rounds over the servers for record queries (default 4) */
1908
2040
  tries?: number;
1909
2041
  }
1910
2042
  class Resolver {
@@ -1918,6 +2050,17 @@ declare module 'node:dns' {
1918
2050
  resolve(hostname: string, rrtype: 'MX', callback: (err: NodeJS.ErrnoException | null, addresses: MxRecord[]) => void): void;
1919
2051
  resolve(hostname: string, rrtype: 'TXT', callback: (err: NodeJS.ErrnoException | null, addresses: string[][]) => void): void;
1920
2052
  resolve(hostname: string, rrtype: 'SRV', callback: (err: NodeJS.ErrnoException | null, addresses: SrvRecord[]) => void): void;
2053
+ resolve(hostname: string, rrtype: 'ANY', callback: (err: NodeJS.ErrnoException | null, addresses: AnyRecord[]) => void): void;
2054
+ resolve(hostname: string, rrtype: 'CAA', callback: (err: NodeJS.ErrnoException | null, addresses: CaaRecord[]) => void): void;
2055
+ resolve(hostname: string, rrtype: 'NAPTR', callback: (err: NodeJS.ErrnoException | null, addresses: NaptrRecord[]) => void): void;
2056
+ resolve(hostname: string, rrtype: 'SOA', callback: (err: NodeJS.ErrnoException | null, address: SoaRecord) => void): void;
2057
+ resolve4(hostname: string, options: ResolveWithTtlOptions, callback: (err: NodeJS.ErrnoException | null, addresses: RecordWithTtl[]) => void): void;
2058
+ resolve6(hostname: string, options: ResolveWithTtlOptions, callback: (err: NodeJS.ErrnoException | null, addresses: RecordWithTtl[]) => void): void;
2059
+ resolveAny(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: AnyRecord[]) => void): void;
2060
+ resolveCaa(hostname: string, callback: (err: NodeJS.ErrnoException | null, records: CaaRecord[]) => void): void;
2061
+ resolveNaptr(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: NaptrRecord[]) => void): void;
2062
+ resolvePtr(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
2063
+ resolveSoa(hostname: string, callback: (err: NodeJS.ErrnoException | null, address: SoaRecord) => void): void;
1921
2064
  resolve4(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
1922
2065
  resolve6(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
1923
2066
  resolveCname(hostname: string, callback: (err: NodeJS.ErrnoException | null, addresses: string[]) => void): void;
@@ -1935,7 +2078,7 @@ declare module 'node:dns' {
1935
2078
  }
1936
2079
 
1937
2080
  declare module 'node:dns/promises' {
1938
- import { LookupOptions, LookupAddress, MxRecord, SrvRecord, ResolverOptions } from 'node:dns';
2081
+ import { LookupOptions, LookupAddress, MxRecord, SrvRecord, ResolverOptions, RecordWithTtl, ResolveWithTtlOptions, SoaRecord, NaptrRecord, CaaRecord, AnyRecord } from 'node:dns';
1939
2082
  namespace dnsPromises {
1940
2083
  function lookup(hostname: string, options: LookupOptions & { all: true }): Promise<LookupAddress[]>;
1941
2084
  function lookup(hostname: string, options?: number | LookupOptions): Promise<LookupAddress>;
@@ -1943,6 +2086,17 @@ declare module 'node:dns/promises' {
1943
2086
  function resolve(hostname: string, rrtype: 'MX'): Promise<MxRecord[]>;
1944
2087
  function resolve(hostname: string, rrtype: 'TXT'): Promise<string[][]>;
1945
2088
  function resolve(hostname: string, rrtype: 'SRV'): Promise<SrvRecord[]>;
2089
+ function resolve(hostname: string, rrtype: 'ANY'): Promise<AnyRecord[]>;
2090
+ function resolve(hostname: string, rrtype: 'CAA'): Promise<CaaRecord[]>;
2091
+ function resolve(hostname: string, rrtype: 'NAPTR'): Promise<NaptrRecord[]>;
2092
+ function resolve(hostname: string, rrtype: 'SOA'): Promise<SoaRecord>;
2093
+ function resolve4(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
2094
+ function resolve6(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
2095
+ function resolveAny(hostname: string): Promise<AnyRecord[]>;
2096
+ function resolveCaa(hostname: string): Promise<CaaRecord[]>;
2097
+ function resolveNaptr(hostname: string): Promise<NaptrRecord[]>;
2098
+ function resolvePtr(hostname: string): Promise<string[]>;
2099
+ function resolveSoa(hostname: string): Promise<SoaRecord>;
1946
2100
  function resolve4(hostname: string): Promise<string[]>;
1947
2101
  function resolve6(hostname: string): Promise<string[]>;
1948
2102
  function resolveCname(hostname: string): Promise<string[]>;
@@ -1964,6 +2118,17 @@ declare module 'node:dns/promises' {
1964
2118
  resolve(hostname: string, rrtype: 'MX'): Promise<MxRecord[]>;
1965
2119
  resolve(hostname: string, rrtype: 'TXT'): Promise<string[][]>;
1966
2120
  resolve(hostname: string, rrtype: 'SRV'): Promise<SrvRecord[]>;
2121
+ resolve(hostname: string, rrtype: 'ANY'): Promise<AnyRecord[]>;
2122
+ resolve(hostname: string, rrtype: 'CAA'): Promise<CaaRecord[]>;
2123
+ resolve(hostname: string, rrtype: 'NAPTR'): Promise<NaptrRecord[]>;
2124
+ resolve(hostname: string, rrtype: 'SOA'): Promise<SoaRecord>;
2125
+ resolve4(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
2126
+ resolve6(hostname: string, options: ResolveWithTtlOptions): Promise<RecordWithTtl[]>;
2127
+ resolveAny(hostname: string): Promise<AnyRecord[]>;
2128
+ resolveCaa(hostname: string): Promise<CaaRecord[]>;
2129
+ resolveNaptr(hostname: string): Promise<NaptrRecord[]>;
2130
+ resolvePtr(hostname: string): Promise<string[]>;
2131
+ resolveSoa(hostname: string): Promise<SoaRecord>;
1967
2132
  resolve4(hostname: string): Promise<string[]>;
1968
2133
  resolve6(hostname: string): Promise<string[]>;
1969
2134
  resolveCname(hostname: string): Promise<string[]>;
@@ -2028,6 +2193,8 @@ declare module 'node:http' {
2028
2193
  writeHead(statusCode: number, headers?: OutgoingHttpHeaders | string[]): this;
2029
2194
  writeContinue(): void;
2030
2195
  setTimeout(msecs: number, callback?: () => void): this;
2196
+ /** Trailing headers, sent after a chunked body (not with a Content-Length) */
2197
+ addTrailers(headers: OutgoingHttpHeaders | ReadonlyArray<[string, string]>): void;
2031
2198
  }
2032
2199
  class ClientRequest extends OutgoingMessage {
2033
2200
  readonly method: string;
@@ -2246,6 +2413,10 @@ declare module 'node:dgram' {
2246
2413
  setTTL(ttl: number): number;
2247
2414
  setMulticastTTL(ttl: number): number;
2248
2415
  setMulticastLoopback(flag: boolean): boolean;
2416
+ setMulticastInterface(multicastInterface: string): void;
2417
+ /** Joins a multicast group (an unbound socket binds first) */
2418
+ addMembership(multicastAddress: string, multicastInterface?: string): void;
2419
+ dropMembership(multicastAddress: string, multicastInterface?: string): void;
2249
2420
  setRecvBufferSize(size: number): void;
2250
2421
  setSendBufferSize(size: number): void;
2251
2422
  }
@@ -2301,6 +2472,7 @@ declare module 'node:async_hooks' {
2301
2472
  }
2302
2473
 
2303
2474
  declare module 'node:test' {
2475
+ import { Readable } from 'node:stream';
2304
2476
  function test(name?: string, fn?: test.TestFn): Promise<void>;
2305
2477
  function test(name?: string, options?: test.TestOptions, fn?: test.TestFn): Promise<void>;
2306
2478
  function test(fn?: test.TestFn): Promise<void>;
@@ -2337,9 +2509,22 @@ declare module 'node:test' {
2337
2509
  restore(): void;
2338
2510
  }
2339
2511
  export type Mock<F extends (...args: any[]) => any> = F & { mock: MockFunctionContext<F> };
2512
+ export interface MockFunctionOptions {
2513
+ times?: number;
2514
+ }
2515
+ export interface MockMethodOptions extends MockFunctionOptions {
2516
+ getter?: boolean;
2517
+ setter?: boolean;
2518
+ }
2519
+ type MockedMember<T> = T extends (...args: any[]) => any ? T : (...args: any[]) => any;
2340
2520
  export interface MockTracker {
2341
2521
  fn<F extends (...args: any[]) => any = (...args: any[]) => undefined>(original?: F): Mock<F>;
2342
2522
  fn<F extends (...args: any[]) => any, Implementation extends (...args: any[]) => any = F>(original: F, implementation: Implementation): Mock<F | Implementation>;
2523
+ /** Replaces object[methodName] (an object-literal method, a class instance's method, a namespace function such as console.log) until restore() */
2524
+ method<O extends object, K extends keyof O>(object: O, methodName: K, options?: MockMethodOptions): Mock<MockedMember<O[K]>>;
2525
+ method<O extends object, K extends keyof O>(object: O, methodName: K, implementation: (...args: any[]) => any, options?: MockMethodOptions): Mock<MockedMember<O[K]>>;
2526
+ getter<O extends object, K extends keyof O>(object: O, methodName: K, implementation?: (...args: any[]) => any, options?: MockFunctionOptions): Mock<() => O[K]>;
2527
+ setter<O extends object, K extends keyof O>(object: O, methodName: K, implementation?: (...args: any[]) => any, options?: MockFunctionOptions): Mock<(value: O[K]) => void>;
2343
2528
  reset(): void;
2344
2529
  restoreAll(): void;
2345
2530
  readonly timers: MockTimers;
@@ -2374,6 +2559,13 @@ declare module 'node:test' {
2374
2559
  doesNotMatch(value: string, regExp: RegExp, message?: string | Error): void;
2375
2560
  fail(message?: string | Error): never;
2376
2561
  ifError(value: unknown): void;
2562
+ /** Compares with (or, with --test-update-snapshots, writes) the test file's <file>.snapshot entry */
2563
+ snapshot(value: any, options?: AssertSnapshotOptions): void;
2564
+ /** Compares with (or, with --test-update-snapshots, writes) the file at path */
2565
+ fileSnapshot(value: any, path: string, options?: AssertSnapshotOptions): void;
2566
+ }
2567
+ export interface AssertSnapshotOptions {
2568
+ serializers?: ReadonlyArray<(value: any) => any>;
2377
2569
  }
2378
2570
  export interface TestContext {
2379
2571
  readonly name: string;
@@ -2430,10 +2622,114 @@ declare module 'node:test' {
2430
2622
  export function after(fn?: HookFn, options?: TestOptions): void;
2431
2623
  export function beforeEach(fn?: HookFn, options?: TestOptions): void;
2432
2624
  export function afterEach(fn?: HookFn, options?: TestOptions): void;
2625
+ export namespace snapshot {
2626
+ function setDefaultSnapshotSerializers(serializers: ReadonlyArray<(value: any) => any>): void;
2627
+ function setResolveSnapshotPath(fn: (path: string | undefined) => string): void;
2628
+ }
2629
+ /** Runs each file (a literal path, compiled into the program) in a child process */
2630
+ export function run(options?: RunOptions): TestsStream;
2631
+ export interface RunOptions {
2632
+ files?: readonly string[];
2633
+ concurrency?: number | boolean;
2634
+ timeout?: number;
2635
+ only?: boolean;
2636
+ testNamePatterns?: string | RegExp | ReadonlyArray<string | RegExp>;
2637
+ testSkipPatterns?: string | RegExp | ReadonlyArray<string | RegExp>;
2638
+ coverage?: boolean;
2639
+ updateSnapshots?: boolean;
2640
+ cwd?: string;
2641
+ argv?: readonly string[];
2642
+ setup?: (reporter: TestsStream) => void | Promise<void>;
2643
+ }
2644
+ export interface TestsStream extends Readable {
2645
+ on(event: 'test:pass' | 'test:fail' | 'test:start' | 'test:complete' | 'test:enqueue' | 'test:dequeue', listener: (data: EventData.Test) => void): this;
2646
+ on(event: 'test:plan', listener: (data: EventData.TestPlan) => void): this;
2647
+ on(event: 'test:diagnostic' | 'test:stdout' | 'test:stderr', listener: (data: EventData.TestMessage) => void): this;
2648
+ on(event: 'test:summary', listener: (data: EventData.TestSummary) => void): this;
2649
+ on(event: 'test:coverage', listener: (data: EventData.TestCoverage) => void): this;
2650
+ on(event: string, listener: (...args: any[]) => void): this;
2651
+ once(event: 'test:pass' | 'test:fail' | 'test:start' | 'test:complete', listener: (data: EventData.Test) => void): this;
2652
+ once(event: 'test:summary', listener: (data: EventData.TestSummary) => void): this;
2653
+ once(event: string, listener: (...args: any[]) => void): this;
2654
+ }
2655
+ export namespace EventData {
2656
+ interface Location {
2657
+ file?: string;
2658
+ line?: number;
2659
+ column?: number;
2660
+ }
2661
+ interface Test extends Location {
2662
+ name: string;
2663
+ nesting: number;
2664
+ testNumber: number;
2665
+ details: { duration_ms: number; type: 'suite' | 'test'; error?: Error; passed?: boolean };
2666
+ skip?: string | boolean;
2667
+ todo?: string | boolean;
2668
+ }
2669
+ interface TestPlan extends Location {
2670
+ nesting: number;
2671
+ count: number;
2672
+ }
2673
+ interface TestMessage extends Location {
2674
+ nesting: number;
2675
+ message: string;
2676
+ level?: 'info' | 'warn' | 'error';
2677
+ }
2678
+ interface TestSummary {
2679
+ counts: { tests: number; failed: number; passed: number; cancelled: number; skipped: number; todo: number; topLevel: number; suites: number };
2680
+ duration_ms: number;
2681
+ file: string | undefined;
2682
+ success: boolean;
2683
+ }
2684
+ interface CoverageCounts {
2685
+ totalLineCount: number;
2686
+ totalBranchCount: number;
2687
+ totalFunctionCount: number;
2688
+ coveredLineCount: number;
2689
+ coveredBranchCount: number;
2690
+ coveredFunctionCount: number;
2691
+ coveredLinePercent: number;
2692
+ coveredBranchPercent: number;
2693
+ coveredFunctionPercent: number;
2694
+ }
2695
+ interface CoverageFile extends CoverageCounts {
2696
+ path: string;
2697
+ functions: { name: string; line: number; count: number }[];
2698
+ branches: { line: number; count: number }[];
2699
+ lines: { line: number; count: number }[];
2700
+ }
2701
+ interface TestCoverage {
2702
+ nesting: number;
2703
+ summary: { files: CoverageFile[]; totals: CoverageCounts; workingDirectory: string };
2704
+ }
2705
+ }
2433
2706
  }
2434
2707
  export = test;
2435
2708
  }
2436
2709
 
2710
+ // The reporters of node:test (--test-reporter), over run() streams and event sources
2711
+ declare module 'node:test/reporters' {
2712
+ import { Duplex } from 'node:stream';
2713
+ import { EventData } from 'node:test';
2714
+ type TestEvent =
2715
+ | { type: 'test:pass' | 'test:fail' | 'test:start' | 'test:complete' | 'test:enqueue' | 'test:dequeue'; data: EventData.Test }
2716
+ | { type: 'test:plan'; data: EventData.TestPlan }
2717
+ | { type: 'test:diagnostic' | 'test:stdout' | 'test:stderr'; data: EventData.TestMessage }
2718
+ | { type: 'test:summary'; data: EventData.TestSummary }
2719
+ | { type: 'test:coverage'; data: EventData.TestCoverage };
2720
+ type TestEventSource = AsyncIterable<TestEvent> | Iterable<TestEvent>;
2721
+ function tap(source: TestEventSource): AsyncGenerator<string, void>;
2722
+ function dot(source: TestEventSource): AsyncGenerator<string, void>;
2723
+ function junit(source: TestEventSource): AsyncGenerator<string, void>;
2724
+ interface ReporterConstructor {
2725
+ new (): Duplex;
2726
+ (): Duplex;
2727
+ }
2728
+ const spec: ReporterConstructor;
2729
+ const lcov: ReporterConstructor;
2730
+ export { tap, dot, junit, spec, lcov, TestEvent };
2731
+ }
2732
+
2437
2733
  declare module 'node:worker_threads' {
2438
2734
  import { EventEmitter } from 'node:events';
2439
2735
  namespace worker_threads {
@@ -2551,8 +2847,8 @@ declare module 'node:sqlite' {
2551
2847
  allowUnknownNamedParameters?: boolean;
2552
2848
  }
2553
2849
  // SQLite runs as Wasm inside the program (github.com/ncruces/go-sqlite3):
2554
- // loadExtension, createSession / applyChangeset and serialize / deserialize
2555
- // throw
2850
+ // loadExtension and createSession / applyChangeset throw; serialize /
2851
+ // deserialize go through a temporary file
2556
2852
  class DatabaseSync {
2557
2853
  constructor(path: string | Uint8Array | URL, options?: DatabaseSyncOptions);
2558
2854
  readonly isOpen: boolean;
@@ -2692,6 +2988,8 @@ declare module 'fs/promises' { import m = require('node:fs/promises'); export =
2692
2988
  declare module 'url' { import m = require('node:url'); export = m; }
2693
2989
  declare module 'querystring' { import m = require('node:querystring'); export = m; }
2694
2990
  declare module 'punycode' { import m = require('node:punycode'); export = m; }
2991
+ declare module 'module' { import m = require('node:module'); export = m; }
2992
+ declare module 'v8' { import m = require('node:v8'); export = m; }
2695
2993
  declare module 'string_decoder' { import m = require('node:string_decoder'); export = m; }
2696
2994
  declare module 'os' { import m = require('node:os'); export = m; }
2697
2995
  declare module 'process' { import m = require('node:process'); export = m; }
@@ -2729,3 +3027,57 @@ declare module 'async_hooks' { import m = require('node:async_hooks'); export =
2729
3027
  declare module 'worker_threads' { import m = require('node:worker_threads'); export = m; }
2730
3028
  declare module 'cluster' { import m = require('node:cluster'); export = m; }
2731
3029
  declare module 'http2' { import m = require('node:http2'); export = m; }
3030
+
3031
+ // The npm package's API for native app windows, as far as compiled programs
3032
+ // implement it (under Node.js the real package runs). The real 'close' event can
3033
+ // be cancelled; compiled, the window is already gone, so preventDefault is absent.
3034
+ declare module '@webviewjs/webview' {
3035
+ interface ApplicationEvent {
3036
+ event: string;
3037
+ }
3038
+ interface WebContextOptions {
3039
+ // Where the webview keeps its profile. Needed under Node.js on Windows: the
3040
+ // default is beside node.exe, which Program Files makes read-only
3041
+ dataDirectory?: string;
3042
+ }
3043
+ interface BrowserWindowOptions {
3044
+ title?: string;
3045
+ width?: number;
3046
+ height?: number;
3047
+ // width and height in logical pixels, which follow the display's scaling, rather
3048
+ // than physical ones
3049
+ logical?: boolean;
3050
+ resizable?: boolean;
3051
+ }
3052
+ interface WebviewOptions {
3053
+ url?: string;
3054
+ html?: string;
3055
+ enableDevtools?: boolean;
3056
+ webContext?: WebContext | null;
3057
+ }
3058
+ class WebContext {}
3059
+ class Webview {
3060
+ loadUrl(url: string): void;
3061
+ loadHtml(html: string): void;
3062
+ evaluateScript(js: string): void;
3063
+ reload(): void;
3064
+ }
3065
+ class BrowserWindow {
3066
+ createWebview(options?: WebviewOptions): Webview;
3067
+ setTitle(title: string): void;
3068
+ close(): void;
3069
+ on(event: 'close', listener: (event: ApplicationEvent) => void): this;
3070
+ once(event: 'close', listener: (event: ApplicationEvent) => void): this;
3071
+ }
3072
+ type ApplicationEventName = 'ready' | 'window-close-requested' | 'application-close-requested';
3073
+ class Application {
3074
+ createWebContext(options?: WebContextOptions): WebContext;
3075
+ createBrowserWindow(options?: BrowserWindowOptions): BrowserWindow;
3076
+ isReady(): boolean;
3077
+ run(): void;
3078
+ whenReady(): Promise<void>;
3079
+ exit(): void;
3080
+ on(event: ApplicationEventName, listener: (event: ApplicationEvent) => void): this;
3081
+ once(event: ApplicationEventName, listener: (event: ApplicationEvent) => void): this;
3082
+ }
3083
+ }