@ricsam/quickjs-path

POSIX path utilities (join, resolve, dirname, basename, etc.) for QuickJS runtime.

> Note: This is a low-level package. For most use cases, use @ricsam/quickjs-runtime with createRuntime() instead.

Installation

``bash
bun add @ricsam/quickjs-path
`

Setup

`typescript
import { setupPath } from "@ricsam/quickjs-path";

const handle = setupPath(context, {
cwd: "/home/user/project", // Current working directory for resolve()
});
`

Injected Globals

- path.join(...paths) - Join path segments
- path.resolve(...paths) - Resolve to absolute path
- path.dirname(path) - Get directory name
- path.basename(path, ext?) - Get base name
- path.extname(path) - Get extension
- path.normalize(path) - Normalize path
- path.isAbsolute(path) - Check if absolute
- path.relative(from, to) - Get relative path
- path.parse(path) - Parse into components
- path.format(pathObject) - Format from components
- path.sep - Path separator (/)
- path.delimiter - Path delimiter (:)

Usage in QuickJS

`javascript
// Join paths
path.join("/foo", "bar", "baz"); // "/foo/bar/baz"
path.join("/foo", "../bar"); // "/bar"

// Resolve to absolute path
path.resolve("foo", "bar"); // "/home/user/project/foo/bar"
path.resolve("/foo", "bar"); // "/foo/bar"

// Directory and base names
path.dirname("/foo/bar/baz.txt"); // "/foo/bar"
path.basename("/foo/bar/baz.txt"); // "baz.txt"
path.basename("/foo/bar/baz.txt", ".txt"); // "baz"

// Extension
path.extname("index.html"); // ".html"
path.extname("index."); // "."
path.extname("index"); // ""

// Normalize
path.normalize("/foo/bar//baz/./qux/../"); // "/foo/bar/baz"

// Check absolute
path.isAbsolute("/foo"); // true
path.isAbsolute("foo"); // false

// Relative path
path.relative("/foo/bar", "/foo/baz"); // "../baz"

// Parse and format
const parsed = path.parse("/foo/bar/baz.txt");
// { root: "/", dir: "/foo/bar", base: "baz.txt", ext: ".txt", name: "baz" }

path.format({ dir: "/foo/bar", base: "baz.txt" }); // "/foo/bar/baz.txt"
``