Align Flow lib defs for Node.js path with v24

[robhogan]

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

New APIs:

1. matchesGlob(path, pattern) - Glob pattern matching (added in Node.js v22.5.0)

   • Returns boolean indicating if path matches the glob pattern
   • Supports standard glob syntax: *, ?, [...], **, etc.
   • Example: path.matchesGlob('/foo/bar', '/foo/*') returns true
   • https://nodejs.org/api/path.html#pathmatchesglobpath-pattern

2. toNamespacedPath(path) - Windows namespace-prefixed path conversion

   • On Windows: converts path to namespace-prefixed path (e.g., \\?\C:\path)
   • On POSIX: returns path unchanged
   • Enables access to paths longer than 260 characters on Windows
   • https://nodejs.org/api/path.html#pathtonamespacedpathpath

Type Safety Improvements:

3. Replaced any types - Proper typed interfaces

   • Changed posix: any → posix: path$PlatformPath
   • Changed win32: any → win32: path$PlatformPath
   • Added path$PlatformPath type definition with all methods and properties

4. Modern Readonly syntax for inputs - Following readonly rules

   • format() input: Changed to Readonly<{root?, dir?, base?, ext?, name?}>
   • Allows passing readonly types safely (inputs should be readonly)

5. Made parse() return type exact - Removed spread operator

   • Return type is now exact: {root: string, dir: string, base: string, ext: string, name: string}
   • Previously had ... spread operator allowing extra properties
   • Note: Return type is NOT readonly (outputs are mutable so consumers can modify)

6. PlatformPath includes parse return as readonly - Consistency

   • Within path$PlatformPath type, the parse method returns Readonly<{...}>
   • This is for the type definition itself, not the actual module export

References:

• Node.js path module docs: https://nodejs.org/api/path.html
• Modern Flow syntax: exact-by-default, Readonly<T> for input parameters

Changelog: [Internal]

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

Differential Revision: D89932753

[meta-codesync]

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

[meta-codesync]

This pull request has been merged in 07d2255.

[react-native-bot]

This pull request was successfully merged by @robhogan in 07d2255

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