projen 0.28.19 → 0.28.23

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 (128) hide show
  1. package/.jsii +3 -3
  2. package/API.md +2 -2
  3. package/lib/awscdk-app-ts.js +1 -1
  4. package/lib/awscdk-construct.d.ts +2 -2
  5. package/lib/awscdk-construct.js +5 -5
  6. package/lib/cdk8s-app-ts.js +1 -1
  7. package/lib/cdk8s-construct.js +1 -1
  8. package/lib/cdktf-construct.js +1 -1
  9. package/lib/cli/cmds/new.js +6 -20
  10. package/lib/component.js +1 -1
  11. package/lib/construct-lib.js +1 -1
  12. package/lib/deps/dependencies.js +1 -1
  13. package/lib/dev-env.js +1 -1
  14. package/lib/docker-compose.js +2 -2
  15. package/lib/eslint.js +1 -1
  16. package/lib/file.js +1 -1
  17. package/lib/git/gitattributes.js +1 -1
  18. package/lib/github/auto-approve.js +1 -1
  19. package/lib/github/auto-merge.js +1 -1
  20. package/lib/github/dependabot.js +1 -1
  21. package/lib/github/github.js +1 -1
  22. package/lib/github/mergify.js +1 -1
  23. package/lib/github/pr-template.js +1 -1
  24. package/lib/github/stale.js +1 -1
  25. package/lib/github/task-workflow.js +1 -1
  26. package/lib/github/workflows.js +1 -1
  27. package/lib/gitpod.js +1 -1
  28. package/lib/ignore-file.js +1 -1
  29. package/lib/ini.js +1 -1
  30. package/lib/java/java-project.js +1 -1
  31. package/lib/java/junit.js +1 -1
  32. package/lib/java/maven-compile.js +1 -1
  33. package/lib/java/maven-packaging.js +1 -1
  34. package/lib/java/maven-sample.js +1 -1
  35. package/lib/java/pom.js +1 -1
  36. package/lib/java/projenrc.js +3 -3
  37. package/lib/javascript/npm-config.js +1 -1
  38. package/lib/javascript/projenrc.js +1 -1
  39. package/lib/jest.js +1 -1
  40. package/lib/jsii-project.js +1 -1
  41. package/lib/json/projenrc.js +1 -1
  42. package/lib/json.js +1 -1
  43. package/lib/license.js +1 -1
  44. package/lib/logger.js +1 -1
  45. package/lib/makefile.js +1 -1
  46. package/lib/node-package.js +1 -1
  47. package/lib/node-project.js +2 -2
  48. package/lib/object-file.js +1 -1
  49. package/lib/project.js +2 -2
  50. package/lib/python/pip.js +1 -1
  51. package/lib/python/poetry.js +2 -2
  52. package/lib/python/projenrc.js +1 -1
  53. package/lib/python/pytest.js +1 -1
  54. package/lib/python/python-project.js +1 -1
  55. package/lib/python/python-sample.js +1 -1
  56. package/lib/python/requirements-file.js +1 -1
  57. package/lib/python/setuppy.js +1 -1
  58. package/lib/python/setuptools.js +1 -1
  59. package/lib/python/venv.js +1 -1
  60. package/lib/readme.js +1 -1
  61. package/lib/release/publisher.js +1 -1
  62. package/lib/release/release.js +1 -1
  63. package/lib/sample-file.js +2 -2
  64. package/lib/semver.js +1 -1
  65. package/lib/source-code.js +1 -1
  66. package/lib/tasks/runtime.js +1 -1
  67. package/lib/tasks/task.js +1 -1
  68. package/lib/tasks/tasks.js +1 -1
  69. package/lib/textfile.js +1 -1
  70. package/lib/toml.js +1 -1
  71. package/lib/typescript/projenrc.js +1 -1
  72. package/lib/typescript-config.js +1 -1
  73. package/lib/typescript.js +3 -3
  74. package/lib/upgrade-dependencies.js +2 -2
  75. package/lib/version.js +1 -1
  76. package/lib/vscode/devcontainer.js +1 -1
  77. package/lib/vscode/launch-config.js +1 -1
  78. package/lib/vscode/vscode.js +1 -1
  79. package/lib/web/next.js +3 -3
  80. package/lib/web/postcss.js +1 -1
  81. package/lib/web/react.js +4 -4
  82. package/lib/web/tailwind.js +1 -1
  83. package/lib/xmlfile.js +1 -1
  84. package/lib/yaml.js +1 -1
  85. package/node_modules/xmlbuilder2/node_modules/@types/node/README.md +1 -1
  86. package/node_modules/xmlbuilder2/node_modules/@types/node/assert.d.ts +1 -1
  87. package/node_modules/xmlbuilder2/node_modules/@types/node/async_hooks.d.ts +1 -1
  88. package/node_modules/xmlbuilder2/node_modules/@types/node/buffer.d.ts +3 -3
  89. package/node_modules/xmlbuilder2/node_modules/@types/node/child_process.d.ts +12 -4
  90. package/node_modules/xmlbuilder2/node_modules/@types/node/cluster.d.ts +1 -1
  91. package/node_modules/xmlbuilder2/node_modules/@types/node/console.d.ts +1 -1
  92. package/node_modules/xmlbuilder2/node_modules/@types/node/crypto.d.ts +34 -18
  93. package/node_modules/xmlbuilder2/node_modules/@types/node/dgram.d.ts +2 -2
  94. package/node_modules/xmlbuilder2/node_modules/@types/node/diagnostics_channel.d.ts +1 -1
  95. package/node_modules/xmlbuilder2/node_modules/@types/node/dns/promises.d.ts +1 -1
  96. package/node_modules/xmlbuilder2/node_modules/@types/node/dns.d.ts +2 -2
  97. package/node_modules/xmlbuilder2/node_modules/@types/node/domain.d.ts +1 -1
  98. package/node_modules/xmlbuilder2/node_modules/@types/node/events.d.ts +2 -2
  99. package/node_modules/xmlbuilder2/node_modules/@types/node/fs/promises.d.ts +17 -10
  100. package/node_modules/xmlbuilder2/node_modules/@types/node/fs.d.ts +15 -7
  101. package/node_modules/xmlbuilder2/node_modules/@types/node/http.d.ts +1 -1
  102. package/node_modules/xmlbuilder2/node_modules/@types/node/http2.d.ts +2 -2
  103. package/node_modules/xmlbuilder2/node_modules/@types/node/https.d.ts +1 -1
  104. package/node_modules/xmlbuilder2/node_modules/@types/node/inspector.d.ts +2 -2
  105. package/node_modules/xmlbuilder2/node_modules/@types/node/net.d.ts +1 -1
  106. package/node_modules/xmlbuilder2/node_modules/@types/node/os.d.ts +5 -5
  107. package/node_modules/xmlbuilder2/node_modules/@types/node/package.json +2 -2
  108. package/node_modules/xmlbuilder2/node_modules/@types/node/path.d.ts +1 -1
  109. package/node_modules/xmlbuilder2/node_modules/@types/node/perf_hooks.d.ts +3 -3
  110. package/node_modules/xmlbuilder2/node_modules/@types/node/process.d.ts +3 -3
  111. package/node_modules/xmlbuilder2/node_modules/@types/node/punycode.d.ts +3 -3
  112. package/node_modules/xmlbuilder2/node_modules/@types/node/querystring.d.ts +9 -9
  113. package/node_modules/xmlbuilder2/node_modules/@types/node/readline.d.ts +1 -1
  114. package/node_modules/xmlbuilder2/node_modules/@types/node/repl.d.ts +1 -1
  115. package/node_modules/xmlbuilder2/node_modules/@types/node/stream.d.ts +12 -1
  116. package/node_modules/xmlbuilder2/node_modules/@types/node/string_decoder.d.ts +1 -1
  117. package/node_modules/xmlbuilder2/node_modules/@types/node/timers.d.ts +1 -1
  118. package/node_modules/xmlbuilder2/node_modules/@types/node/tls.d.ts +6 -6
  119. package/node_modules/xmlbuilder2/node_modules/@types/node/trace_events.d.ts +2 -2
  120. package/node_modules/xmlbuilder2/node_modules/@types/node/tty.d.ts +1 -1
  121. package/node_modules/xmlbuilder2/node_modules/@types/node/url.d.ts +1 -1
  122. package/node_modules/xmlbuilder2/node_modules/@types/node/util.d.ts +11 -12
  123. package/node_modules/xmlbuilder2/node_modules/@types/node/v8.d.ts +2 -2
  124. package/node_modules/xmlbuilder2/node_modules/@types/node/vm.d.ts +3 -4
  125. package/node_modules/xmlbuilder2/node_modules/@types/node/wasi.d.ts +9 -4
  126. package/node_modules/xmlbuilder2/node_modules/@types/node/worker_threads.d.ts +4 -4
  127. package/node_modules/xmlbuilder2/node_modules/@types/node/zlib.d.ts +1 -1
  128. package/package.json +3 -3
@@ -13,7 +13,7 @@
13
13
  * // Prints:
14
14
  * // c0fa1bc00531bd78ef38c628449c5102aeabd49b5dc3a2a516ea6ea959d6658e
15
15
  * ```
16
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/crypto.js)
16
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/crypto.js)
17
17
  */
18
18
  declare module 'crypto' {
19
19
  import * as stream from 'node:stream';
@@ -548,6 +548,22 @@ declare module 'crypto' {
548
548
  class KeyObject {
549
549
  private constructor();
550
550
  /**
551
+ * Example: Converting a `CryptoKey` instance to a `KeyObject`:
552
+ *
553
+ * ```js
554
+ * const { webcrypto, KeyObject } = await import('crypto');
555
+ * const { subtle } = webcrypto;
556
+ *
557
+ * const key = await subtle.generateKey({
558
+ * name: 'HMAC',
559
+ * hash: 'SHA-256',
560
+ * length: 256
561
+ * }, true, ['sign', 'verify']);
562
+ *
563
+ * const keyObject = KeyObject.from(key);
564
+ * console.log(keyObject.symmetricKeySize);
565
+ * // Prints: 32 (symmetric key size in bytes)
566
+ * ```
551
567
  * @since v15.0.0
552
568
  */
553
569
  static from(key: webcrypto.CryptoKey): KeyObject;
@@ -660,7 +676,7 @@ declare module 'crypto' {
660
676
  * non-cryptographically secure hash algorithm allow passwords to be tested very
661
677
  * rapidly.
662
678
  *
663
- * In line with OpenSSL's recommendation to use a more modern algorithm instead of[`EVP_BytesToKey`](https://www.openssl.org/docs/man1.1.0/crypto/EVP_BytesToKey.html) it is recommended that
679
+ * In line with OpenSSL's recommendation to use a more modern algorithm instead of [`EVP_BytesToKey`](https://www.openssl.org/docs/man1.1.0/crypto/EVP_BytesToKey.html) it is recommended that
664
680
  * developers derive a key and IV on
665
681
  * their own using {@link scrypt} and to use {@link createCipheriv} to create the `Cipher` object. Users should not use ciphers with counter mode
666
682
  * (e.g. CTR, GCM, or CCM) in `crypto.createCipher()`. A warning is emitted when
@@ -688,7 +704,7 @@ declare module 'crypto' {
688
704
  * recent OpenSSL releases, `openssl list -cipher-algorithms`(`openssl list-cipher-algorithms` for older versions of OpenSSL) will
689
705
  * display the available cipher algorithms.
690
706
  *
691
- * The `key` is the raw key used by the `algorithm` and `iv` is an[initialization vector](https://en.wikipedia.org/wiki/Initialization_vector). Both arguments must be `'utf8'` encoded
707
+ * The `key` is the raw key used by the `algorithm` and `iv` is an [initialization vector](https://en.wikipedia.org/wiki/Initialization_vector). Both arguments must be `'utf8'` encoded
692
708
  * strings,`Buffers`, `TypedArray`, or `DataView`s. The `key` may optionally be
693
709
  * a `KeyObject` of type `secret`. If the cipher does not need
694
710
  * an initialization vector, `iv` may be `null`.
@@ -905,7 +921,7 @@ declare module 'crypto' {
905
921
  * non-cryptographically secure hash algorithm allow passwords to be tested very
906
922
  * rapidly.
907
923
  *
908
- * In line with OpenSSL's recommendation to use a more modern algorithm instead of[`EVP_BytesToKey`](https://www.openssl.org/docs/man1.1.0/crypto/EVP_BytesToKey.html) it is recommended that
924
+ * In line with OpenSSL's recommendation to use a more modern algorithm instead of [`EVP_BytesToKey`](https://www.openssl.org/docs/man1.1.0/crypto/EVP_BytesToKey.html) it is recommended that
909
925
  * developers derive a key and IV on
910
926
  * their own using {@link scrypt} and to use {@link createDecipheriv} to create the `Decipher` object.
911
927
  * @since v0.1.94
@@ -929,7 +945,7 @@ declare module 'crypto' {
929
945
  * recent OpenSSL releases, `openssl list -cipher-algorithms`(`openssl list-cipher-algorithms` for older versions of OpenSSL) will
930
946
  * display the available cipher algorithms.
931
947
  *
932
- * The `key` is the raw key used by the `algorithm` and `iv` is an[initialization vector](https://en.wikipedia.org/wiki/Initialization_vector). Both arguments must be `'utf8'` encoded
948
+ * The `key` is the raw key used by the `algorithm` and `iv` is an [initialization vector](https://en.wikipedia.org/wiki/Initialization_vector). Both arguments must be `'utf8'` encoded
933
949
  * strings,`Buffers`, `TypedArray`, or `DataView`s. The `key` may optionally be
934
950
  * a `KeyObject` of type `secret`. If the cipher does not need
935
951
  * an initialization vector, `iv` may be `null`.
@@ -1524,7 +1540,7 @@ declare module 'crypto' {
1524
1540
  }
1525
1541
  /**
1526
1542
  * Creates a predefined `DiffieHellmanGroup` key exchange object. The
1527
- * supported groups are: `'modp1'`, `'modp2'`, `'modp5'` (defined in[RFC 2412](https://www.rfc-editor.org/rfc/rfc2412.txt), but see `Caveats`) and `'modp14'`, `'modp15'`,`'modp16'`, `'modp17'`,
1543
+ * supported groups are: `'modp1'`, `'modp2'`, `'modp5'` (defined in [RFC 2412](https://www.rfc-editor.org/rfc/rfc2412.txt), but see `Caveats`) and `'modp14'`, `'modp15'`,`'modp16'`, `'modp17'`,
1528
1544
  * `'modp18'` (defined in [RFC 3526](https://www.rfc-editor.org/rfc/rfc3526.txt)). The
1529
1545
  * returned object mimics the interface of objects created by {@link createDiffieHellman}, but will not allow changing
1530
1546
  * the keys (with `diffieHellman.setPublicKey()`, for example). The
@@ -2209,7 +2225,7 @@ declare module 'crypto' {
2209
2225
  * This function is based on a constant-time algorithm.
2210
2226
  * Returns true if `a` is equal to `b`, without leaking timing information that
2211
2227
  * would allow an attacker to guess one of the values. This is suitable for
2212
- * comparing HMAC digests or secret values like authentication cookies or[capability urls](https://www.w3.org/TR/capability-urls/).
2228
+ * comparing HMAC digests or secret values like authentication cookies or [capability urls](https://www.w3.org/TR/capability-urls/).
2213
2229
  *
2214
2230
  * `a` and `b` must both be `Buffer`s, `TypedArray`s, or `DataView`s, and they
2215
2231
  * must have the same byte length.
@@ -2382,8 +2398,8 @@ declare module 'crypto' {
2382
2398
  privateKey: T2;
2383
2399
  }
2384
2400
  /**
2385
- * Generates a new asymmetric key pair of the given `type`. RSA, DSA, EC, Ed25519,
2386
- * Ed448, X25519, X448, and DH are currently supported.
2401
+ * Generates a new asymmetric key pair of the given `type`. RSA, RSA-PSS, DSA, EC,
2402
+ * Ed25519, Ed448, X25519, X448, and DH are currently supported.
2387
2403
  *
2388
2404
  * If a `publicKeyEncoding` or `privateKeyEncoding` was specified, this function
2389
2405
  * behaves as if `keyObject.export()` had been called on its result. Otherwise,
@@ -2463,8 +2479,8 @@ declare module 'crypto' {
2463
2479
  function generateKeyPairSync(type: 'x448', options: X448KeyPairOptions<'der', 'der'>): KeyPairSyncResult<Buffer, Buffer>;
2464
2480
  function generateKeyPairSync(type: 'x448', options?: X448KeyPairKeyObjectOptions): KeyPairKeyObjectResult;
2465
2481
  /**
2466
- * Generates a new asymmetric key pair of the given `type`. RSA, DSA, EC, Ed25519,
2467
- * Ed448, X25519, X448, and DH are currently supported.
2482
+ * Generates a new asymmetric key pair of the given `type`. RSA, RSA-PSS, DSA, EC,
2483
+ * Ed25519, Ed448, X25519, X448, and DH are currently supported.
2468
2484
  *
2469
2485
  * If a `publicKeyEncoding` or `privateKeyEncoding` was specified, this function
2470
2486
  * behaves as if `keyObject.export()` had been called on its result. Otherwise,
@@ -2499,7 +2515,7 @@ declare module 'crypto' {
2499
2515
  * If this method is invoked as its `util.promisify()` ed version, it returns
2500
2516
  * a `Promise` for an `Object` with `publicKey` and `privateKey` properties.
2501
2517
  * @since v10.12.0
2502
- * @param type Must be `'rsa'`, `'dsa'`, `'ec'`, `'ed25519'`, `'ed448'`, `'x25519'`, `'x448'`, or `'dh'`.
2518
+ * @param type Must be `'rsa'`, `'rsa-pss'`, `'dsa'`, `'ec'`, `'ed25519'`, `'ed448'`, `'x25519'`, `'x448'`, or `'dh'`.
2503
2519
  */
2504
2520
  function generateKeyPair(type: 'rsa', options: RSAKeyPairOptions<'pem', 'pem'>, callback: (err: Error | null, publicKey: string, privateKey: string) => void): void;
2505
2521
  function generateKeyPair(type: 'rsa', options: RSAKeyPairOptions<'pem', 'der'>, callback: (err: Error | null, publicKey: string, privateKey: Buffer) => void): void;
@@ -2880,7 +2896,7 @@ declare module 'crypto' {
2880
2896
  *
2881
2897
  * The supplied `callback` function is called with two arguments: `err` and`derivedKey`. If an errors occurs while deriving the key, `err` will be set;
2882
2898
  * otherwise `err` will be `null`. The successfully generated `derivedKey` will
2883
- * be passed to the callback as an [&lt;ArrayBuffer&gt;](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer). An error will be thrown if any
2899
+ * be passed to the callback as an [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer). An error will be thrown if any
2884
2900
  * of the input arguments specify invalid values or types.
2885
2901
  *
2886
2902
  * ```js
@@ -2907,7 +2923,7 @@ declare module 'crypto' {
2907
2923
  * Provides a synchronous HKDF key derivation function as defined in RFC 5869\. The
2908
2924
  * given `ikm`, `salt` and `info` are used with the `digest` to derive a key of`keylen` bytes.
2909
2925
  *
2910
- * The successfully generated `derivedKey` will be returned as an [&lt;ArrayBuffer&gt;](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer).
2926
+ * The successfully generated `derivedKey` will be returned as an [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer).
2911
2927
  *
2912
2928
  * An error will be thrown if any of the input arguments specify invalid values or
2913
2929
  * types, or if the derived key cannot be generated.
@@ -3169,8 +3185,8 @@ declare module 'crypto' {
3169
3185
  * if given as an `ArrayBuffer`, `SharedArrayBuffer`, `TypedArray`, `Buffer`, or`DataView`.
3170
3186
  *
3171
3187
  * By default, the prime is encoded as a big-endian sequence of octets
3172
- * in an [&lt;ArrayBuffer&gt;](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer). If the `bigint` option is `true`, then a
3173
- * [&lt;bigint&gt;](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)is provided.
3188
+ * in an [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer). If the `bigint` option is `true`, then a
3189
+ * [bigint](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt) is provided.
3174
3190
  * @since v15.8.0
3175
3191
  * @param size The size (in bits) of the prime to generate.
3176
3192
  */
@@ -3200,8 +3216,8 @@ declare module 'crypto' {
3200
3216
  * if given as an `ArrayBuffer`, `SharedArrayBuffer`, `TypedArray`, `Buffer`, or`DataView`.
3201
3217
  *
3202
3218
  * By default, the prime is encoded as a big-endian sequence of octets
3203
- * in an [&lt;ArrayBuffer&gt;](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer). If the `bigint` option is `true`, then a
3204
- * [&lt;bigint&gt;](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt)is provided.
3219
+ * in an [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer). If the `bigint` option is `true`, then a
3220
+ * [bigint](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/BigInt) is provided.
3205
3221
  * @since v15.8.0
3206
3222
  * @param size The size (in bits) of the prime to generate.
3207
3223
  */
@@ -23,7 +23,7 @@
23
23
  * server.bind(41234);
24
24
  * // Prints: server listening 0.0.0.0:41234
25
25
  * ```
26
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/dgram.js)
26
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/dgram.js)
27
27
  */
28
28
  declare module 'dgram' {
29
29
  import { AddressInfo } from 'node:net';
@@ -350,7 +350,7 @@ declare module 'dgram' {
350
350
  */
351
351
  setBroadcast(flag: boolean): void;
352
352
  /**
353
- * _All references to scope in this section are referring to[IPv6 Zone Indices](https://en.wikipedia.org/wiki/IPv6_address#Scoped_literal_IPv6_addresses), which are defined by [RFC
353
+ * _All references to scope in this section are referring to [IPv6 Zone Indices](https://en.wikipedia.org/wiki/IPv6_address#Scoped_literal_IPv6_addresses), which are defined by [RFC
354
354
  * 4007](https://tools.ietf.org/html/rfc4007). In string form, an IP_
355
355
  * _with a scope index is written as `'IP%scope'` where scope is an interface name_
356
356
  * _or interface number._
@@ -20,7 +20,7 @@
20
20
  * should generally include the module name to avoid collisions with data from
21
21
  * other modules.
22
22
  * @experimental
23
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/diagnostics_channel.js)
23
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/diagnostics_channel.js)
24
24
  */
25
25
  declare module 'diagnostics_channel' {
26
26
  /**
@@ -323,7 +323,7 @@ declare module 'dns/promises' {
323
323
  * The `dnsPromises.setServers()` method must not be called while a DNS query is in
324
324
  * progress.
325
325
  *
326
- * This method works much like[resolve.conf](https://man7.org/linux/man-pages/man5/resolv.conf.5.html).
326
+ * This method works much like [resolve.conf](https://man7.org/linux/man-pages/man5/resolv.conf.5.html).
327
327
  * That is, if attempting to resolve with the first server provided results in a`NOTFOUND` error, the `resolve()` method will _not_ attempt to resolve with
328
328
  * subsequent servers provided. Fallback DNS servers will only be used if the
329
329
  * earlier ones time out or result in some other error.
@@ -42,7 +42,7 @@
42
42
  * ```
43
43
  *
44
44
  * See the `Implementation considerations section` for more information.
45
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/dns.js)
45
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/dns.js)
46
46
  */
47
47
  declare module 'dns' {
48
48
  import * as dnsPromises from 'node:dns/promises';
@@ -502,7 +502,7 @@ declare module 'dns' {
502
502
  *
503
503
  * The {@link setServers} method affects only {@link resolve},`dns.resolve*()` and {@link reverse} (and specifically _not_ {@link lookup}).
504
504
  *
505
- * This method works much like[resolve.conf](https://man7.org/linux/man-pages/man5/resolv.conf.5.html).
505
+ * This method works much like [resolve.conf](https://man7.org/linux/man-pages/man5/resolv.conf.5.html).
506
506
  * That is, if attempting to resolve with the first server provided results in a`NOTFOUND` error, the `resolve()` method will _not_ attempt to resolve with
507
507
  * subsequent servers provided. Fallback DNS servers will only be used if the
508
508
  * earlier ones time out or result in some other error.
@@ -11,7 +11,7 @@
11
11
  * will be notified, rather than losing the context of the error in the`process.on('uncaughtException')` handler, or causing the program to
12
12
  * exit immediately with an error code.
13
13
  * @deprecated Since v1.4.2 - Deprecated
14
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/domain.js)
14
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/domain.js)
15
15
  */
16
16
  declare module 'domain' {
17
17
  import EventEmitter = require('node:events');
@@ -32,7 +32,7 @@
32
32
  * });
33
33
  * myEmitter.emit('event');
34
34
  * ```
35
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/events.js)
35
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/events.js)
36
36
  */
37
37
  declare module 'events' {
38
38
  interface EventEmitterOptions {
@@ -78,7 +78,7 @@ declare module 'events' {
78
78
  * The `Promise` will resolve with an array of all the arguments emitted to the
79
79
  * given event.
80
80
  *
81
- * This method is intentionally generic and works with the web platform[EventTarget](https://dom.spec.whatwg.org/#interface-eventtarget) interface, which has no special`'error'` event
81
+ * This method is intentionally generic and works with the web platform [EventTarget](https://dom.spec.whatwg.org/#interface-eventtarget) interface, which has no special`'error'` event
82
82
  * semantics and does not listen to the `'error'` event.
83
83
  *
84
84
  * ```js
@@ -92,7 +92,7 @@ declare module 'fs/promises' {
92
92
  chmod(mode: Mode): Promise<void>;
93
93
  /**
94
94
  * Forces all currently queued I/O operations associated with the file to the
95
- * operating system's synchronized I/O completion state. Refer to the POSIX[`fdatasync(2)`](http://man7.org/linux/man-pages/man2/fdatasync.2.html) documentation for details.
95
+ * operating system's synchronized I/O completion state. Refer to the POSIX [`fdatasync(2)`](http://man7.org/linux/man-pages/man2/fdatasync.2.html) documentation for details.
96
96
  *
97
97
  * Unlike `filehandle.sync` this method does not flush modified metadata.
98
98
  * @since v10.0.0
@@ -220,7 +220,10 @@ declare module 'fs/promises' {
220
220
  */
221
221
  utimes(atime: string | number | Date, mtime: string | number | Date): Promise<void>;
222
222
  /**
223
- * Asynchronously writes data to a file, replacing the file if it already exists.`data` can be a string, a buffer, or an object with an own `toString` function
223
+ * Asynchronously writes data to a file, replacing the file if it already exists.`data` can be a string, a buffer, an
224
+ * [AsyncIterable](https://tc39.github.io/ecma262/#sec-asynciterable-interface) or
225
+ * [Iterable](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#The_iterable_protocol) object, or an
226
+ * object with an own `toString` function
224
227
  * property. The promise is resolved with no arguments upon success.
225
228
  *
226
229
  * If `options` is a string, then it specifies the `encoding`.
@@ -274,7 +277,7 @@ declare module 'fs/promises' {
274
277
  buffer: string;
275
278
  }>;
276
279
  /**
277
- * Write an array of [&lt;ArrayBufferView&gt;](https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView)s to the file.
280
+ * Write an array of [ArrayBufferView](https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView) s to the file.
278
281
  *
279
282
  * The promise is resolved with an object containing a two properties:
280
283
  *
@@ -290,7 +293,7 @@ declare module 'fs/promises' {
290
293
  */
291
294
  writev(buffers: ReadonlyArray<NodeJS.ArrayBufferView>, position?: number): Promise<WriteVResult>;
292
295
  /**
293
- * Read from a file and write to an array of [&lt;ArrayBufferView&gt;](https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView)s
296
+ * Read from a file and write to an array of [ArrayBufferView](https://developer.mozilla.org/en-US/docs/Web/API/ArrayBufferView) s
294
297
  * @since v13.13.0, v12.17.0
295
298
  * @param position The offset from the beginning of the file where the data should be read from. If `position` is not a `number`, the data will be read from the current position.
296
299
  * @return Fulfills upon success an object containing two properties:
@@ -324,7 +327,7 @@ declare module 'fs/promises' {
324
327
  *
325
328
  * If the accessibility check is successful, the promise is resolved with no
326
329
  * value. If any of the accessibility checks fail, the promise is rejected
327
- * with an [&lt;Error&gt;](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) object. The following example checks if the file`/etc/passwd` can be read and
330
+ * with an [Error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error) object. The following example checks if the file`/etc/passwd` can be read and
328
331
  * written by the current process.
329
332
  *
330
333
  * ```js
@@ -391,7 +394,7 @@ declare module 'fs/promises' {
391
394
  *
392
395
  * Some characters (`< > : " / \ | ? *`) are reserved under Windows as documented
393
396
  * by [Naming Files, Paths, and Namespaces](https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file). Under NTFS, if the filename contains
394
- * a colon, Node.js will open a file system stream, as described by[this MSDN page](https://docs.microsoft.com/en-us/windows/desktop/FileIO/using-streams).
397
+ * a colon, Node.js will open a file system stream, as described by [this MSDN page](https://docs.microsoft.com/en-us/windows/desktop/FileIO/using-streams).
395
398
  * @since v10.0.0
396
399
  * @param [flags='r'] See `support of file system `flags``.
397
400
  * @param [mode=0o666] Sets the file mode (permission and sticky bits) if the file is created.
@@ -539,7 +542,7 @@ declare module 'fs/promises' {
539
542
  }
540
543
  ): Promise<Dirent[]>;
541
544
  /**
542
- * Reads the contents of the symbolic link referred to by `path`. See the POSIX[`readlink(2)`](http://man7.org/linux/man-pages/man2/readlink.2.html) documentation for more detail. The promise is
545
+ * Reads the contents of the symbolic link referred to by `path`. See the POSIX [`readlink(2)`](http://man7.org/linux/man-pages/man2/readlink.2.html) documentation for more detail. The promise is
543
546
  * resolved with the`linkString` upon success.
544
547
  *
545
548
  * The optional `options` argument can be a string specifying an encoding, or an
@@ -611,7 +614,7 @@ declare module 'fs/promises' {
611
614
  ): Promise<BigIntStats>;
612
615
  function stat(path: PathLike, opts?: StatOptions): Promise<Stats | BigIntStats>;
613
616
  /**
614
- * Creates a new link from the `existingPath` to the `newPath`. See the POSIX[`link(2)`](http://man7.org/linux/man-pages/man2/link.2.html) documentation for more detail.
617
+ * Creates a new link from the `existingPath` to the `newPath`. See the POSIX [`link(2)`](http://man7.org/linux/man-pages/man2/link.2.html) documentation for more detail.
615
618
  * @since v10.0.0
616
619
  * @return Fulfills with `undefined` upon success.
617
620
  */
@@ -619,7 +622,7 @@ declare module 'fs/promises' {
619
622
  /**
620
623
  * If `path` refers to a symbolic link, then the link is removed without affecting
621
624
  * the file or directory to which that link refers. If the `path` refers to a file
622
- * path that is not a symbolic link, the file is deleted. See the POSIX [`unlink(2)`](http://man7.org/linux/man-pages/man2/unlink.2.html)documentation for more detail.
625
+ * path that is not a symbolic link, the file is deleted. See the POSIX [`unlink(2)`](http://man7.org/linux/man-pages/man2/unlink.2.html) documentation for more detail.
623
626
  * @since v10.0.0
624
627
  * @return Fulfills with `undefined` upon success.
625
628
  */
@@ -746,6 +749,8 @@ declare module 'fs/promises' {
746
749
  *
747
750
  * If `options` is a string, then it specifies the encoding.
748
751
  *
752
+ * The `mode` option only affects the newly created file. See `fs.open()` for more details.
753
+ *
749
754
  * Any specified `FileHandle` has to support writing.
750
755
  *
751
756
  * It is unsafe to use `fsPromises.writeFile()` multiple times on the same file
@@ -802,6 +807,8 @@ declare module 'fs/promises' {
802
807
  *
803
808
  * If `options` is a string, then it specifies the `encoding`.
804
809
  *
810
+ * The `mode` option only affects the newly created file. See `fs.open()` for more details.
811
+ *
805
812
  * The `path` may be specified as a `FileHandle` that has been opened
806
813
  * for appending (using `fsPromises.open()`).
807
814
  * @since v10.0.0
@@ -894,7 +901,7 @@ declare module 'fs/promises' {
894
901
  | null
895
902
  ): Promise<string | Buffer>;
896
903
  /**
897
- * Asynchronously open a directory for iterative scanning. See the POSIX[`opendir(3)`](http://man7.org/linux/man-pages/man3/opendir.3.html) documentation for more detail.
904
+ * Asynchronously open a directory for iterative scanning. See the POSIX [`opendir(3)`](http://man7.org/linux/man-pages/man3/opendir.3.html) documentation for more detail.
898
905
  *
899
906
  * Creates an `fs.Dir`, which contains all further functions for reading from
900
907
  * and cleaning up the directory.
@@ -16,7 +16,7 @@
16
16
  *
17
17
  * All file system operations have synchronous, callback, and promise-based
18
18
  * forms, and are accessible using both CommonJS syntax and ES6 Modules (ESM).
19
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/fs.js)
19
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/fs.js)
20
20
  */
21
21
  declare module 'fs' {
22
22
  import * as stream from 'node:stream';
@@ -1045,8 +1045,8 @@ declare module 'fs' {
1045
1045
  */
1046
1046
  export const lstatSync: StatSyncFn;
1047
1047
  /**
1048
- * Creates a new link from the `existingPath` to the `newPath`. See the POSIX[`link(2)`](http://man7.org/linux/man-pages/man2/link.2.html) documentation for more detail. No arguments other than a
1049
- * possible
1048
+ * Creates a new link from the `existingPath` to the `newPath`. See the POSIX [`link(2)`](http://man7.org/linux/man-pages/man2/link.2.html) documentation for more detail. No arguments other than
1049
+ * a possible
1050
1050
  * exception are given to the completion callback.
1051
1051
  * @since v0.1.31
1052
1052
  */
@@ -1060,7 +1060,7 @@ declare module 'fs' {
1060
1060
  function __promisify__(existingPath: PathLike, newPath: PathLike): Promise<void>;
1061
1061
  }
1062
1062
  /**
1063
- * Creates a new link from the `existingPath` to the `newPath`. See the POSIX[`link(2)`](http://man7.org/linux/man-pages/man2/link.2.html) documentation for more detail. Returns `undefined`.
1063
+ * Creates a new link from the `existingPath` to the `newPath`. See the POSIX [`link(2)`](http://man7.org/linux/man-pages/man2/link.2.html) documentation for more detail. Returns `undefined`.
1064
1064
  * @since v0.1.31
1065
1065
  */
1066
1066
  export function linkSync(existingPath: PathLike, newPath: PathLike): void;
@@ -1949,7 +1949,7 @@ declare module 'fs' {
1949
1949
  *
1950
1950
  * Some characters (`< > : " / \ | ? *`) are reserved under Windows as documented
1951
1951
  * by [Naming Files, Paths, and Namespaces](https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file). Under NTFS, if the filename contains
1952
- * a colon, Node.js will open a file system stream, as described by[this MSDN page](https://docs.microsoft.com/en-us/windows/desktop/FileIO/using-streams).
1952
+ * a colon, Node.js will open a file system stream, as described by [this MSDN page](https://docs.microsoft.com/en-us/windows/desktop/FileIO/using-streams).
1953
1953
  *
1954
1954
  * Functions based on `fs.open()` exhibit this behavior as well:`fs.writeFile()`, `fs.readFile()`, etc.
1955
1955
  * @since v0.0.2
@@ -2510,6 +2510,8 @@ declare module 'fs' {
2510
2510
  *
2511
2511
  * The `encoding` option is ignored if `data` is a buffer.
2512
2512
  *
2513
+ * The `mode` option only affects the newly created file. See {@link open} for more details.
2514
+ *
2513
2515
  * If `data` is a plain object, it must have an own (not inherited) `toString`function property.
2514
2516
  *
2515
2517
  * ```js
@@ -2590,6 +2592,8 @@ declare module 'fs' {
2590
2592
  *
2591
2593
  * If `data` is a plain object, it must have an own (not inherited) `toString`function property.
2592
2594
  *
2595
+ * The `mode` option only affects the newly created file. See {@link open} for more details.
2596
+ *
2593
2597
  * For detailed information, see the documentation of the asynchronous version of
2594
2598
  * this API: {@link writeFile}.
2595
2599
  * @since v0.1.29
@@ -2600,6 +2604,8 @@ declare module 'fs' {
2600
2604
  * Asynchronously append data to a file, creating the file if it does not yet
2601
2605
  * exist. `data` can be a string or a `Buffer`.
2602
2606
  *
2607
+ * The `mode` option only affects the newly created file. See {@link open} for more details.
2608
+ *
2603
2609
  * ```js
2604
2610
  * import { appendFile } from 'fs';
2605
2611
  *
@@ -2674,6 +2680,8 @@ declare module 'fs' {
2674
2680
  * Synchronously append data to a file, creating the file if it does not yet
2675
2681
  * exist. `data` can be a string or a `Buffer`.
2676
2682
  *
2683
+ * The `mode` option only affects the newly created file. See {@link open} for more details.
2684
+ *
2677
2685
  * ```js
2678
2686
  * import { appendFileSync } from 'fs';
2679
2687
  *
@@ -3433,7 +3441,7 @@ declare module 'fs' {
3433
3441
  export function createWriteStream(path: PathLike, options?: BufferEncoding | StreamOptions): WriteStream;
3434
3442
  /**
3435
3443
  * Forces all currently queued I/O operations associated with the file to the
3436
- * operating system's synchronized I/O completion state. Refer to the POSIX[`fdatasync(2)`](http://man7.org/linux/man-pages/man2/fdatasync.2.html) documentation for details. No arguments other
3444
+ * operating system's synchronized I/O completion state. Refer to the POSIX [`fdatasync(2)`](http://man7.org/linux/man-pages/man2/fdatasync.2.html) documentation for details. No arguments other
3437
3445
  * than a possible
3438
3446
  * exception are given to the completion callback.
3439
3447
  * @since v0.1.96
@@ -3448,7 +3456,7 @@ declare module 'fs' {
3448
3456
  }
3449
3457
  /**
3450
3458
  * Forces all currently queued I/O operations associated with the file to the
3451
- * operating system's synchronized I/O completion state. Refer to the POSIX[`fdatasync(2)`](http://man7.org/linux/man-pages/man2/fdatasync.2.html) documentation for details. Returns `undefined`.
3459
+ * operating system's synchronized I/O completion state. Refer to the POSIX [`fdatasync(2)`](http://man7.org/linux/man-pages/man2/fdatasync.2.html) documentation for details. Returns `undefined`.
3452
3460
  * @since v0.1.96
3453
3461
  */
3454
3462
  export function fdatasyncSync(fd: number): void;
@@ -37,7 +37,7 @@
37
37
  * 'Host', 'mysite.com',
38
38
  * 'accepT', '*' ]
39
39
  * ```
40
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/http.js)
40
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/http.js)
41
41
  */
42
42
  declare module 'http' {
43
43
  import * as stream from 'node:stream';
@@ -6,7 +6,7 @@
6
6
  * const http2 = require('http2');
7
7
  * ```
8
8
  * @since v8.4.0
9
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/http2.js)
9
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/http2.js)
10
10
  */
11
11
  declare module 'http2' {
12
12
  import EventEmitter = require('node:events');
@@ -2014,7 +2014,7 @@ declare module 'http2' {
2014
2014
  /**
2015
2015
  * Returns a `net.Server` instance that creates and manages `Http2Session`instances.
2016
2016
  *
2017
- * Since there are no browsers known that support[unencrypted HTTP/2](https://http2.github.io/faq/#does-http2-require-encryption), the use of {@link createSecureServer} is necessary when
2017
+ * Since there are no browsers known that support [unencrypted HTTP/2](https://http2.github.io/faq/#does-http2-require-encryption), the use of {@link createSecureServer} is necessary when
2018
2018
  * communicating
2019
2019
  * with browser clients.
2020
2020
  *
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * HTTPS is the HTTP protocol over TLS/SSL. In Node.js this is implemented as a
3
3
  * separate module.
4
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/https.js)
4
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/https.js)
5
5
  */
6
6
  declare module 'https' {
7
7
  import { Duplex } from 'node:stream';
@@ -15,7 +15,7 @@
15
15
  * ```js
16
16
  * const inspector = require('inspector');
17
17
  * ```
18
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/inspector.js)
18
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/inspector.js)
19
19
  */
20
20
  declare module 'inspector' {
21
21
  import EventEmitter = require('node:events');
@@ -1797,7 +1797,7 @@ declare module 'inspector' {
1797
1797
  * // Output: { type: 'number', value: 4, description: '4' }
1798
1798
  * ```
1799
1799
  *
1800
- * The latest version of the V8 inspector protocol is published on the[Chrome DevTools Protocol Viewer](https://chromedevtools.github.io/devtools-protocol/v8/).
1800
+ * The latest version of the V8 inspector protocol is published on the [Chrome DevTools Protocol Viewer](https://chromedevtools.github.io/devtools-protocol/v8/).
1801
1801
  *
1802
1802
  * Node.js inspector supports all the Chrome DevTools Protocol domains declared
1803
1803
  * by V8\. Chrome DevTools Protocol domain provides an interface for interacting
@@ -10,7 +10,7 @@
10
10
  * ```js
11
11
  * const net = require('net');
12
12
  * ```
13
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/net.js)
13
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/net.js)
14
14
  */
15
15
  declare module 'net' {
16
16
  import * as stream from 'node:stream';
@@ -5,7 +5,7 @@
5
5
  * ```js
6
6
  * const os = require('os');
7
7
  * ```
8
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/os.js)
8
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/os.js)
9
9
  */
10
10
  declare module 'os' {
11
11
  interface CpuInfo {
@@ -143,8 +143,8 @@ declare module 'os' {
143
143
  /**
144
144
  * Returns the operating system as a string.
145
145
  *
146
- * On POSIX systems, the operating system release is determined by calling[`uname(3)`](https://linux.die.net/man/3/uname). On Windows, `GetVersionExW()` is used.
147
- * See[https://en.wikipedia.org/wiki/Uname#Examples](https://en.wikipedia.org/wiki/Uname#Examples) for more information.
146
+ * On POSIX systems, the operating system release is determined by calling [`uname(3)`](https://linux.die.net/man/3/uname). On Windows, `GetVersionExW()` is used. See
147
+ * [https://en.wikipedia.org/wiki/Uname#Examples](https://en.wikipedia.org/wiki/Uname#Examples) for more information.
148
148
  * @since v0.3.3
149
149
  */
150
150
  function release(): string;
@@ -396,8 +396,8 @@ declare module 'os' {
396
396
  /**
397
397
  * Returns a string identifying the kernel version.
398
398
  *
399
- * On POSIX systems, the operating system release is determined by calling[`uname(3)`](https://linux.die.net/man/3/uname). On Windows, `RtlGetVersion()` is used, and if it is not
400
- * available, `GetVersionExW()` will be used. See[https://en.wikipedia.org/wiki/Uname#Examples](https://en.wikipedia.org/wiki/Uname#Examples) for more information.
399
+ * On POSIX systems, the operating system release is determined by calling [`uname(3)`](https://linux.die.net/man/3/uname). On Windows, `RtlGetVersion()` is used, and if it is not
400
+ * available, `GetVersionExW()` will be used. See [https://en.wikipedia.org/wiki/Uname#Examples](https://en.wikipedia.org/wiki/Uname#Examples) for more information.
401
401
  * @since v13.11.0, v12.17.0
402
402
  */
403
403
  function version(): string;
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@types/node",
3
- "version": "16.9.2",
3
+ "version": "16.9.4",
4
4
  "description": "TypeScript definitions for Node.js",
5
5
  "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node",
6
6
  "license": "MIT",
@@ -230,6 +230,6 @@
230
230
  },
231
231
  "scripts": {},
232
232
  "dependencies": {},
233
- "typesPublisherContentHash": "7ac745248f781ac1d3209d00dc718167ba1fb626b648061d112f72002ea39945",
233
+ "typesPublisherContentHash": "3a9ba9eedbc5a775925dde51f42ad45be2e4e6d760b8d1d2e767e82f91cc4d92",
234
234
  "typeScriptVersion": "3.7"
235
235
  }
@@ -13,7 +13,7 @@ declare module 'path/win32' {
13
13
  * ```js
14
14
  * const path = require('path');
15
15
  * ```
16
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/path.js)
16
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/path.js)
17
17
  */
18
18
  declare module 'path' {
19
19
  namespace path {
@@ -1,5 +1,5 @@
1
1
  /**
2
- * This module provides an implementation of a subset of the W3C[Web Performance APIs](https://w3c.github.io/perf-timing-primer/) as well as additional APIs for
2
+ * This module provides an implementation of a subset of the W3C [Web Performance APIs](https://w3c.github.io/perf-timing-primer/) as well as additional APIs for
3
3
  * Node.js-specific performance measurements.
4
4
  *
5
5
  * Node.js supports the following [Web Performance APIs](https://w3c.github.io/perf-timing-primer/):
@@ -26,7 +26,7 @@
26
26
  * performance.measure('A to B', 'A', 'B');
27
27
  * });
28
28
  * ```
29
- * @see [source](https://github.com/nodejs/node/blob/v16.7.0/lib/perf_hooks.js)
29
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/perf_hooks.js)
30
30
  */
31
31
  declare module 'perf_hooks' {
32
32
  import { AsyncResource } from 'node:async_hooks';
@@ -84,7 +84,7 @@ declare module 'perf_hooks' {
84
84
  * Additional detail specific to the `entryType`.
85
85
  * @since v16.0.0
86
86
  */
87
- readonly details?: NodeGCPerformanceDetail | unknown | undefined; // TODO: Narrow this based on entry type.
87
+ readonly detail?: NodeGCPerformanceDetail | unknown | undefined; // TODO: Narrow this based on entry type.
88
88
  }
89
89
  /**
90
90
  * _This property is an extension by Node.js. It is not available in Web browsers._
@@ -639,7 +639,7 @@ declare module 'process' {
639
639
  */
640
640
  getgid(): number;
641
641
  /**
642
- * The `process.setgid()` method sets the group identity of the process. (See[`setgid(2)`](http://man7.org/linux/man-pages/man2/setgid.2.html).) The `id` can be passed as either a
642
+ * The `process.setgid()` method sets the group identity of the process. (See [`setgid(2)`](http://man7.org/linux/man-pages/man2/setgid.2.html).) The `id` can be passed as either a
643
643
  * numeric ID or a group name
644
644
  * string. If a group name is specified, this method blocks while resolving the
645
645
  * associated numeric ID.
@@ -683,7 +683,7 @@ declare module 'process' {
683
683
  */
684
684
  getuid(): number;
685
685
  /**
686
- * The `process.setuid(id)` method sets the user identity of the process. (See[`setuid(2)`](http://man7.org/linux/man-pages/man2/setuid.2.html).) The `id` can be passed as either a
686
+ * The `process.setuid(id)` method sets the user identity of the process. (See [`setuid(2)`](http://man7.org/linux/man-pages/man2/setuid.2.html).) The `id` can be passed as either a
687
687
  * numeric ID or a username string.
688
688
  * If a username is specified, the method blocks while resolving the associated
689
689
  * numeric ID.
@@ -1067,7 +1067,7 @@ declare module 'process' {
1067
1067
  * ```
1068
1068
  *
1069
1069
  * The value `'android'` may also be returned if the Node.js is built on the
1070
- * Android operating system. However, Android support in Node.js[is experimental](https://github.com/nodejs/node/blob/HEAD/BUILDING.md#androidandroid-based-devices-eg-firefox-os).
1070
+ * Android operating system. However, Android support in Node.js [is experimental](https://github.com/nodejs/node/blob/HEAD/BUILDING.md#androidandroid-based-devices-eg-firefox-os).
1071
1071
  * @since v0.1.16
1072
1072
  */
1073
1073
  readonly platform: Platform;