feat!: url support

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Author: unicornware

.dictionary.txt

@@ -1,7 +1,9 @@
 abar
 attw
 barx
+cdir
 cefc
+cindex
 codecov
 commitlintrc
 dbar

.github/infrastructure.yml

@@ -32,7 +32,6 @@ branches:
           - context: gitguardian
           - context: lint
           - context: spelling
-          - context: test (22)
           - context: test (23)
           - context: typescript (5.6.3)
           - context: typescript (5.7.1-rc)

.github/workflows/ci.yml

@@ -309,7 +309,6 @@ jobs:
       matrix:
         node-version:
           - 23
-          - 22
     env:
       COVERAGE_SUMMARY: ./coverage/coverage-summary.json
       NODE_VERSION: ${{ matrix.node-version }}

README.md

@@ -25,7 +25,7 @@ Universal drop-in replacement for [`node:path`][node-path]
 This package is a universal drop-in replacement for Node.js' [`path`][node-path] module.
 
 It enforces consistency between POSIX and Windows operating systems and also provides additional utilities for working
-with file paths and extensions.
+with file URLs, paths, and extensions.
 
 ## When should I use this?
 
@@ -99,6 +99,7 @@ import {
   isAbsolute,
   isDeviceRoot,
   isSep,
+  isURL,
   join,
   matchesGlob,
   normalize,
@@ -111,6 +112,7 @@ import {
   root,
   sep,
   toNamespacedPath,
+  toPath,
   toPosix
 } from '@flex-development/pathe'
 ```
@@ -134,6 +136,7 @@ This package exports the following identifiers:
 - [`isAbsolute`](./src/lib/is-absolute.mts)
 - [`isDeviceRoot`](./src/lib/is-device-root.mts)
 - [`isSep`](./src/lib/is-sep.mts)
+- [`isURL`](./src/lib/is-url.mts)
 - [`join`](./src/lib/join.mts)
 - [`matchesGlob`](./src/lib/matches-glob.mts)
 - [`normalize`](./src/lib/normalize.mts)
@@ -147,6 +150,7 @@ This package exports the following identifiers:
 - [`root`](./src/lib/root.mts)
 - [`sep`](./src/lib/sep.mts)
 - [`toNamespacedPath`](./src/lib/to-namespaced-path.mts)
+- [`toPath`](./src/lib/to-path.mts)
 - [`toPosix`](./src/lib/to-posix.mts)
 - [`win32`](./src/pathe.mts)
 

__fixtures__/drive.mts

@@ -0,0 +1,15 @@
+/**
+ * @file Fixtures - DRIVE
+ * @module fixtures/drive
+ */
+
+import type { DriveLetter } from '@flex-development/pathe'
+
+/**
+ * Windows drive letter.
+ *
+ * @const {DriveLetter} DRIVE
+ */
+const DRIVE: DriveLetter = 'T:'
+
+export default DRIVE

__fixtures__/env.mts

@@ -0,0 +1,62 @@
+/**
+ * @file Plugins - chaiPath
+ * @module tests/plugins/chaiPath
+ */
+
+import type Chai from 'chai'
+import path from 'node:path'
+
+export default plugin
+
+/**
+ * Chai assertion plugin for the Node.js [path][node-path] API.
+ *
+ * [node-path]: https://nodejs.org/api/path.html
+ *
+ * @see {@linkcode Chai.ChaiStatic}
+ * @see {@linkcode Chai.ChaiUtils}
+ *
+ * @param {ChaiStatic} chai
+ *  `chai` export
+ * @param {Chai.ChaiUtils} utils
+ *  `chai` utilities
+ * @return {undefined}
+ */
+function plugin(chai: Chai.ChaiStatic, utils: Chai.ChaiUtils): undefined {
+  utils.addMethod(chai.Assertion.prototype, extname.name, extname)
+
+  return void 0
+
+  /**
+   * Assert the return value of {@linkcode path.extname}.
+   *
+   * @this {Chai.Assertion}
+   *
+   * @param {unknown} expected
+   *  Expected file extension
+   * @return {undefined}
+   */
+  function extname(this: Chai.Assertion, expected: unknown): undefined {
+    /**
+     * Subject of assertion.
+     *
+     * @const {string} subject
+     */
+    const subject: string = utils.flag(this, 'object')
+
+    /**
+     * File extension.
+     *
+     * @const {string} ext
+     */
+    const actual: string = path.extname(subject)
+
+    return void this.assert(
+      actual === expected,
+      'expected extname of #{this} to be #{exp} but got #{act}',
+      'expected extname of #{this} to not be #{act}',
+      expected,
+      actual
+    )
+  }
+}

__tests__/plugins/chai-path.mts

@@ -0,0 +1,17 @@
+/**
+ * @file Test Setup - chai
+ * @module tests/setup/chai
+ * @see https://chaijs.com
+ */
+
+import chaiPath from '#tests/plugins/chai-path'
+import chaiString from 'chai-string'
+import { chai } from 'vitest'
+
+/**
+ * initialize chai plugins.
+ *
+ * @see https://github.com/onechiporenko/chai-string
+ */
+chai.use(chaiPath)
+chai.use(chaiString)

__tests__/setup/chai.mts

@@ -0,0 +1,21 @@
+/**
+ * @file Test Utilities - cwdWindows
+ * @module tests/utils/cwdWindows
+ */
+
+import DRIVE from '#fixtures/drive'
+import { ok } from 'devlop'
+import { posix, win32 } from 'node:path'
+
+/**
+ * Get the path to the current working directory as a windows drive path.
+ *
+ * @return {string}
+ *  Absolute path to current working directory
+ */
+function cwdWindows(): string {
+  ok(typeof process.env['PWD'] === 'string', 'expected `process.env.PWD`')
+  return DRIVE + process.env['PWD'].replaceAll(posix.sep, win32.sep)
+}
+
+export default cwdWindows