Update dependencies, drop Node.js < 20 support and switch to ESM

.github/workflows/ci.yml

@@ -22,7 +22,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest]
-        node: [18, 20, 22, 24]
+        node: [20, 22, 24]
 
     steps:
       - name: Clone repository

README.md

@@ -12,8 +12,10 @@ npm install resolve-dependency-path
 
 ## Usage
 
+### ESM
+
 ```js
-const resolvePath = require('resolve-dependency-path');
+import resolvePath from 'resolve-dependency-path';
 
 const resolved = resolvePath({
   dependency: './foobar',
@@ -22,6 +24,12 @@ const resolved = resolvePath({
 });
 ```
 
+### CommonJS
+
+```js
+const { default: resolvePath } = require('resolve-dependency-path');
+```
+
 ### Options
 
 | Option | Type | Required | Description |

index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Resolve a dependency specifier to an absolute file path.
+ *
+ * @param  {object} options
+ * @param  {string} options.dependency - The dependency specifier (e.g. `'./bar'` or `'lodash'`)
+ * @param  {string} options.filename   - Absolute or relative path of the file that contains the dependency
+ * @param  {string} options.directory  - Root directory used to resolve non-relative dependencies
+ * @returns {string} Resolved absolute path including the inferred file extension
+ * @throws {Error} When any of the required options is missing or falsy
+ */
+export default function resolveDependencyPath({ dependency, filename, directory }?: {
+    dependency: string;
+    filename: string;
+    directory: string;
+}): string;

index.js

@@ -1,6 +1,4 @@
-'use strict';
-
-const path = require('path');
+import path from 'node:path';
 
 /**
  * Resolve a dependency specifier to an absolute file path.
@@ -12,7 +10,7 @@ const path = require('path');
  * @returns {string} Resolved absolute path including the inferred file extension
  * @throws {Error} When any of the required options is missing or falsy
  */
-module.exports = function({ dependency, filename, directory } = {}) {
+export default function resolveDependencyPath({ dependency, filename, directory } = {}) {
   if (!dependency) throw new Error('dependency path not given');
   if (!filename) throw new Error('filename not given');
   if (!directory) throw new Error('directory not given');
@@ -21,7 +19,7 @@ module.exports = function({ dependency, filename, directory } = {}) {
   const extension = getDependencyExtension(dependency, filename);
 
   return filepath + extension;
-};
+}
 
 /**
  * @param  {string} dependency
@@ -61,7 +59,7 @@ function getDependencyExtension(dependency, filename) {
 
   // If using a SystemJS style plugin
   if (dependencyExtension.includes('!')) {
-    return dependencyExtension.substring(0, dependencyExtension.indexOf('!'));
+    return dependencyExtension.slice(0, dependencyExtension.indexOf('!'));
   }
 
   return '';