doc: improve fs.StatFs property descriptions and add examples

Add missing information to the fs.StatFs class documentation:

- Clarify that bsize and frsize values are in bytes
- Add ESM and CJS examples showing how to calculate disk space
- Explain the relationship between block counts and bsize
- Clarify the difference between bavail (unprivileged) and bfree (total)
- Document that type is a filesystem magic number with common values
- Add cross-references between related properties

Fixes: #50749

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: marcelsafin

doc/api/fs.md

@@ -7926,6 +7926,33 @@ StatFs {
 }
 ```
 
+To calculate disk space from a `StatFs` object, multiply the block count
+properties by `statfs.bsize` (the block size in bytes):
+
+```mjs
+import { statfs } from 'node:fs/promises';
+
+const stats = await statfs('/');
+const byteSize = stats.bsize;
+
+console.log(`Total: ${stats.blocks * byteSize} bytes`);
+console.log(`Free:  ${stats.bfree * byteSize} bytes`);
+console.log(`Available: ${stats.bavail * byteSize} bytes`);
+```
+
+```cjs
+const { statfs } = require('node:fs');
+
+statfs('/', (err, stats) => {
+  if (err) throw err;
+  const byteSize = stats.bsize;
+
+  console.log(`Total: ${stats.blocks * byteSize} bytes`);
+  console.log(`Free:  ${stats.bfree * byteSize} bytes`);
+  console.log(`Available: ${stats.bavail * byteSize} bytes`);
+});
+```
+
 #### `statfs.bavail`
 
 <!-- YAML
@@ -7936,7 +7963,9 @@ added:
 
 * Type: {number|bigint}
 
-Free blocks available to unprivileged users.
+Free blocks available to unprivileged users. This value accounts for
+space reserved by the operating system (unlike [`statfs.bfree`][]). Use
+`statfs.bavail * statfs.bsize` to get the available space in bytes.
 
 #### `statfs.bfree`
 
@@ -7948,7 +7977,10 @@ added:
 
 * Type: {number|bigint}
 
-Free blocks in file system.
+Free blocks in file system, including reserved blocks that are not
+available to unprivileged users. See [`statfs.bavail`][] for the
+unreserved count. Use `statfs.bfree * statfs.bsize` to get the free
+space in bytes.
 
 #### `statfs.blocks`
 
@@ -7960,7 +7992,8 @@ added:
 
 * Type: {number|bigint}
 
-Total data blocks in file system.
+Total data blocks in file system. Use `statfs.blocks * statfs.bsize`
+to get the total size in bytes.
 
 #### `statfs.bsize`
 
@@ -7972,7 +8005,9 @@ added:
 
 * Type: {number|bigint}
 
-Optimal transfer block size.
+Optimal transfer block size, in bytes. Multiply this value by block count
+properties (such as [`statfs.blocks`][], [`statfs.bfree`][], and
+[`statfs.bavail`][]) to convert them to bytes.
 
 #### `statfs.frsize`
 
@@ -7982,7 +8017,8 @@ added: REPLACEME
 
 * Type: {number|bigint}
 
-Fundamental file system block size.
+Fundamental file system block size, in bytes. On most POSIX systems this
+has the same value as [`statfs.bsize`][].
 
 #### `statfs.ffree`
 
@@ -7994,7 +8030,7 @@ added:
 
 * Type: {number|bigint}
 
-Free file nodes in file system.
+Free file nodes (inodes) in file system.
 
 #### `statfs.files`
 
@@ -8006,7 +8042,7 @@ added:
 
 * Type: {number|bigint}
 
-Total file nodes in file system.
+Total file nodes (inodes) in file system.
 
 #### `statfs.type`
 
@@ -8018,7 +8054,9 @@ added:
 
 * Type: {number|bigint}
 
-Type of file system.
+Type of file system, as a filesystem magic number. Common values include
+`0xEF53` (ext2/ext3/ext4), `0x5346544e` (NTFS), `0x01021994` (tmpfs),
+and `0x6969` (NFS). See the statfs(2) man page for more values.
 
 ### Class: `fs.Utf8Stream`
 
@@ -9052,6 +9090,10 @@ the file contents.
 [`fs.rmdir()`]: #fsrmdirpath-options-callback
 [`fs.stat()`]: #fsstatpath-options-callback
 [`fs.statfs()`]: #fsstatfspath-options-callback
+[`statfs.bavail`]: #statfsbavail
+[`statfs.bfree`]: #statfsbfree
+[`statfs.blocks`]: #statfsblocks
+[`statfs.bsize`]: #statfsbsize
 [`fs.symlink()`]: #fssymlinktarget-path-type-callback
 [`fs.utimes()`]: #fsutimespath-atime-mtime-callback
 [`fs.watch()`]: #fswatchfilename-options-listener