Import-meta-based path utilities for modern Node.js ESM applications.
- Features
- Requirements
- Setup
- Usage
- Development
- Testing
- Troubleshooting
- Security
- API
- Packaging
- Examples
- Support
- Links
- License
- Accept
import.metaor a directory path as input. - Join, resolve, and relativize paths with Node.js rules.
- Convert paths to file URLs and file URLs to paths.
- Use Node.js 26 or later.
- Use native ESM.
Install @eliware/path:
npm install @eliware/pathPass import.meta or a directory path to a helper:
import path, { pathUrl, relativePath, resolvePath } from "@eliware/path";
const filePath = path(import.meta, "config", "app.json");
const fileUrl = pathUrl(import.meta, "module.mjs");
const absolutePath = resolvePath(import.meta, "data", "input.json");
const relative = relativePath(import.meta, "data", "input.json");Read release notes for package changes.
Read the documentation index for user guides. Read the example index for runnable examples. Read the specifications index for repository rules.
Run aggregate validation:
npm test- Run
npm run lintfor lint checks. - Run
npm run auditfor dependency checks. - Run
npm run formatto format files. - Run
npm run format:checkto check file format. - Run
npm run typecheckto check declarations. - Run
npm run packto check package contents.
Read the troubleshooting guide for input and URL errors.
The helpers do not read files or use the network.
Absolute segments and .. can move outside the starting directory.
Check paths from user input before file access.
Read the API reference for all exported functions and their behavior.
The package uses native ESM and supports Node.js 26 or later.
It includes TypeScript declarations and has no runtime dependencies.
Use MAJOR.MINOR.PATCH for package versions.
The npm workflow publishes a tag only when it matches package.json.version and validation passes.
Follow Eliware Operations for release approval.
Read the package guide for package files.
Run an example from the repository root:
node examples/example.mjsRead the example index for all examples.
For help, questions, or to chat with the author and community, visit:
