fix(node/v24): update fs and fs/promises to Node v24.20 - #75474

Package in scope

@types/node — the v24 snapshot only (types/node/v24). types/node (v26) and types/node/v25 already ship all of these APIs.

What changes

Brings types/node/v24's fs and fs/promises modules up to date with the Node.js v24.20 API surface:

• fs.watch(): ignore option (v24.14, nodejs/node#61433) — new WatchIgnorePredicate type plus WatchOptions.ignore; fsPromises.watch() inherits it via _WatchOptions.
• fs.stat() / fs.promises.stat(): throwIfNoEntry option (v24.15, nodejs/node#61178). StatOptions gains the field (previously only on StatSyncOptions), and the async overloads now return Stats | undefined / BigIntStats | undefined when it is set to false.
• fs.statfs() family: frsize on StatsFs / BigIntStatsFs (v24.16, nodejs/node#62277).
• fs.glob() / fs.globSync() / fsPromises.glob(): followSymlinks option (v24.16, nodejs/node#62695).
• fs.readFile() / fs.readFileSync() / fsPromises.readFile() / filehandle.readFile(): buffer option accepting a pre-allocated view or a (size) => buffer factory (v24.19, nodejs/node#63634). Returns BufferView<T>, which required adding the BufferView type to buffer.buffer.d.ts (including the TS 5.6 fallback).

stat's signal option is intentionally not typed: in v24.20 the implementation only exists on callback fs.stat() while the docs also mention it on filehandle.stat(). types/node carries a TODO on StatOptions to revisit this once upstream sorts the behavior out, and this PR mirrors that decision.

Why v24 is missing these

types/node/v24 was cut while types/node tracked Node 24.13 (types/node/v24/package.json is still 24.13.9999). Every API above landed on the v24 line after that cut, and the vNN/ snapshots don't pick up new APIs automatically.

Tests

types/node/v24/test/fs.ts covers:

• all four accepted ignore shapes (glob string, RegExp, predicate, array) for fs.watch(), plus two fsPromises.watch() cases;
• throwIfNoEntry for fs.stat() and fs.promises.stat() (return-type widening for the false case), with existing statSync/lstatSync expectations kept;
• frsize on both StatsFs variants;
• followSymlinks for fs.glob() / fs.globSync() / fsPromises.glob();
• the buffer option for all four readFile variants (pre-allocated Uint8Array, SharedArrayBuffer-backed, Buffer, and factory function).

Notes for reviewers

• types/node/v24/package.json version is intentionally left at 24.13.9999: bumping that marker is what the periodic node: v24.x PRs do, together with the full multi-module sync.
• All changes are ports of the declarations already in types/node (v26), adjusted to the v24.20 API surface.
• Verified locally with pnpm run lint types/node/v24 (dtslint, TS 5.6 – 6.0) and dprint fmt; leaving the authoritative run to CI.

Context for the suggested changes:

• https://nodejs.org/docs/latest-v24.x/api/fs.html
• fs: add ignore option to fs.watch nodejs/node#61433
• fs: add throwIfNoEntry option for fs.stat and fs.promises.stat nodejs/node#61178
• fs: expose frsize field in statfs nodejs/node#62277
• fs: add followSymlinks option to glob nodejs/node#62695
• fs: support caller-supplied readFile() buffers nodejs/node#63634

Please fill in this template.

• Use a meaningful title for the pull request. Include the name of the package modified.
• Test the change in your own code. (Compile and run.)
• Add or edit tests to reflect the change.
• Follow the advice from the readme.
• Avoid common mistakes.
• Run pnpm test <package to test>.

If changing an existing definition:

• Provide a URL to documentation or source code which provides context for the suggested changes: https://nodejs.org/docs/latest-v24.x/api/fs.html
• If this PR brings the type definitions up to date with a new version of the JS library, update the version number in the package.json. (intentionally not bumped; see notes above)