path: add path/posix and path/win32 alias modules

Refs: #31553
Refs: #32953
Refs: #33950
Refs: #34001
Refs: #34002
Refs: #34055

PR-URL: #34962
Reviewed-By: Myles Borins <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>
Reviewed-By: Matteo Collina <[email protected]>
Reviewed-By: Rich Trott <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Gerhard Stöbich <[email protected]>

doc/api/path.md

@@ -434,13 +434,19 @@ A [`TypeError`][] is thrown if `path` is not a string.
 ## `path.posix`
 <!-- YAML
 added: v0.11.15
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/34962
+    description: Exposed as `require('path/posix')`.
 -->
 
 * {Object}
 
 The `path.posix` property provides access to POSIX specific implementations
 of the `path` methods.
 
+The API is accessible via `require('path').posix` or `require('path/posix')`.
+
 ## `path.relative(from, to)`
 <!-- YAML
 added: v0.5.0
@@ -568,13 +574,19 @@ method is non-operational and always returns `path` without modifications.
 ## `path.win32`
 <!-- YAML
 added: v0.11.15
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/34962
+    description: Exposed as `require('path/win32')`.
 -->
 
 * {Object}
 
 The `path.win32` property provides access to Windows-specific implementations
 of the `path` methods.
 
+The API is accessible via `require('path').win32` or `require('path/win32')`.
+
 [MSDN-Rel-Path]: https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file#fully-qualified-vs-relative-paths
 [`TypeError`]: errors.md#errors_class_typeerror
 [`path.parse()`]: #path_path_parse_path

lib/path/posix.js

@@ -0,0 +1,3 @@
+'use strict';
+
+module.exports = require('path').posix;

lib/path/win32.js

@@ -0,0 +1,3 @@
+'use strict';
+
+module.exports = require('path').win32;

node.gyp

@@ -73,6 +73,8 @@
       'lib/net.js',
       'lib/os.js',
       'lib/path.js',
+      'lib/path/posix.js',
+      'lib/path/win32.js',
       'lib/perf_hooks.js',
       'lib/process.js',
       'lib/punycode.js',

test/es-module/test-esm-path-posix.mjs

@@ -0,0 +1,6 @@
+import '../common/index.mjs';
+import assert from 'assert';
+import { posix } from 'path';
+import pathPosix from 'path/posix';
+
+assert.strictEqual(pathPosix, posix);

test/es-module/test-esm-path-win32.mjs

@@ -0,0 +1,6 @@
+import '../common/index.mjs';
+import assert from 'assert';
+import { win32 } from 'path';
+import pathWin32 from 'path/win32';
+
+assert.strictEqual(pathWin32, win32);

test/parallel/test-path-posix-exists.js

@@ -0,0 +1,6 @@
+'use strict';
+
+require('../common');
+const assert = require('assert');
+
+assert.strictEqual(require('path/posix'), require('path').posix);

test/parallel/test-path-win32-exists.js

@@ -0,0 +1,6 @@
+'use strict';
+
+require('../common');
+const assert = require('assert');
+
+assert.strictEqual(require('path/win32'), require('path').win32);