Align Flow lib defs for Node.js util with v24

[robhogan]

Summary:
This is an AI-assisted change to align the Flow definitions for the util module with the Node.js docs as at v24.

New v20-v24 APIs:

1. parseEnv(content) - Environment file (.env) parser (added in v20.12.0)

   • Parses .env file content into key-value object
   • Last value wins for duplicate keys
   • https://nodejs.org/api/util.html#utilparseenvcontent

2. diff(actual, expected) - String/array comparison (added in v22.15.0) 🧪

   • Uses Myers diff algorithm for comparison
   • Returns array of tuples: [operation: -1 | 0 | 1, value: string]
     • -1 = expected only (deletion)
     • 0 = both (unchanged)
     • 1 = actual only (insertion)
   • Experimental API
   • https://nodejs.org/api/util.html#utildiffactual-expected

3. getSystemErrorMessage(err) - Error code to message (added in v22.12.0)

   • Returns the error message string for a numeric error code
   • https://nodejs.org/api/util.html#utilgetsystemerrormessageerr

4. getCallSites([frameCount | options]) - Call stack capture (added in v22.9.0)

   • Captures call stack as CallSiteObject instances with:
     • functionName, scriptName, scriptId, lineNumber, columnNumber
   • scriptId property added in v22.14.0
   • https://nodejs.org/api/util.html#utilgetcallsitesframecount

5. types.isFloat16Array() - Type check for Float16Array (added in v24.0.0)

   • Checks if value is a Float16Array instance
   • https://nodejs.org/api/util.html#utiltypesisfloat16arrayvalue

New Classes (v19):

6. MIMEType class - MIME type parsing and manipulation (added in v19.1.0, v18.13.0)

   • Properties: type, subtype, essence, params
   • Methods: toString()
   • Implements MIMEType proposal spec
   • https://nodejs.org/api/util.html#class-utilmimetype

7. MIMEParams class - MIME parameters handler (added in v19.1.0, v18.13.0)

   • Methods: delete(), get(), has(), set(), entries(), keys(), values()
   • https://nodejs.org/api/util.html#class-utilmimeparams

Updated APIs:

8. parseArgs() - Added allowNegative option (added in v22.4.0)
   • Allows explicitly setting boolean options to false with --no- prefix
   • Example: --no-verbose sets verbose: false
   • https://nodejs.org/api/util.html#utilparseargsconfig

Type Safety Improvements:

9. Exact-by-default syntax - Simplified object types

   • Changed {|...|} {} in parseArgs types (Flow configured with exact-by-default)
   • Changed default generic types from {||} → {}

10. styleText() already present with full type definitions

    • 18 foreground colors, 18 background colors, 12 modifiers
    • https://nodejs.org/api/util.html#utilstyletextformat-text

References:

• Node.js util module docs: https://nodejs.org/api/util.html
• MIMEType proposal: https://bmeck.github.io/node-proposal-mime-api/

Changelog: [Internal]

Generated by Confucius Code Assist (CCA)
Confucius Session, Trace

Reviewed By: vzaidman

Differential Revision: D89942136

[meta-codesync]

@robhogan has exported this pull request. If you are a Meta employee, you can view the originating Diff in D89942136.

[meta-codesync]

This pull request has been merged in f5c1126.

[react-native-bot]

This pull request was successfully merged by @robhogan in f5c1126

^{When will my fix make it into a release? | How to file a pick request?}