pathe 2.0.3: join

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify pathe.join in pkg:npm/pathe@2.0.3
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/pathe@2.0.3
Demonstrate these symbols/APIs:
  - pathe.join

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:d506a1fd963514d9c52da9c6343c457a9ad2549314e68684fa5484dc4efd948b","contract":["join joins path segments using POSIX forward slashes regardless of host platform","join normalizes Windows-style backslashes to forward slashes","join resolves relative navigation segments including dot and dot-dot parent directories","join preserves leading slash for absolute paths and joins absolute subsegments","join collapses redundant interior slashes while preserving trailing slashes on final segment","join returns a single dot for empty path inputs"],"goal":"verify pathe.join in pkg:npm/pathe@2.0.3","kind":"HOW","packages":["pkg:npm/pathe@2.0.3"],"schemaVersion":1,"symbols":["pathe.join"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/pathe@2.0.3"],"schemaVersion":1,"subject":"pkg:npm/pathe@2.0.3","symbols":["pathe.join"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-pathe-join",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-pathe-join",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "pathe": "2.0.3"
      }
    },
    "node_modules/pathe": {
      "version": "2.0.3",
      "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",
      "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==",
      "license": "MIT"
    }
  }
}

{
  "name": "sample-pathe-join",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification of pathe.join in pkg:npm/pathe@2.0.3",
  "main": "src/index.js",
  "license": "MIT-0",
  "dependencies": {
    "pathe": "2.0.3"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify pathe.join in pkg:npm/pathe@2.0.3",
  "kind": "HOW",
  "packages": [
    "pkg:npm/pathe@2.0.3"
  ],
  "symbols": [
    "pathe.join"
  ]
}

const { join } = require('pathe');

/**
 * Joins path segments into a normalized path string using forward slashes.
 *
 * @param {...string} paths - Path segments to join.
 * @returns {string} Normalized path string.
 */
function joinPaths(...paths) {
  return join(...paths);
}

/**
 * Joins a base directory path with one or more relative subpath segments.
 *
 * @param {string} base - Base directory.
 * @param {...string} segments - Additional path segments.
 * @returns {string} Normalized joined path.
 */
function joinSubpaths(base, ...segments) {
  return join(base, ...segments);
}

module.exports = {
  join,
  joinPaths,
  joinSubpaths
};

import assert from 'node:assert';
import { createRequire } from 'node:module';

const require = createRequire(import.meta.url);
const { join, joinPaths, joinSubpaths } = require('../src/index.js');

// 1. join joins path segments using POSIX forward slashes regardless of host platform
assert.strictEqual(join('a', 'b', 'c'), 'a/b/c');
assert.strictEqual(joinPaths('users', 'local', 'bin'), 'users/local/bin');
assert.strictEqual(joinSubpaths('project', 'src', 'index.js'), 'project/src/index.js');

// 2. join normalizes Windows-style backslashes to forward slashes
assert.strictEqual(join('dir\\\\subdir', 'file.txt'), 'dir/subdir/file.txt');
assert.strictEqual(join('foo\\\\bar', 'baz\\\\qux'), 'foo/bar/baz/qux');
assert.strictEqual(joinPaths('foo\\\\bar\\\\baz'), 'foo/bar/baz');

// 3. join resolves relative navigation segments including dot and dot-dot parent directories
assert.strictEqual(join('a', 'b', '..', 'c'), 'a/c');
assert.strictEqual(join('a', '.', 'b', 'c'), 'a/b/c');
assert.strictEqual(join('a/b/c', '../../d'), 'a/d');
assert.strictEqual(joinSubpaths('base/dir', '..', 'other', 'file.js'), 'base/other/file.js');

// 4. join preserves leading slash for absolute paths and joins absolute subsegments
assert.strictEqual(join('/a', 'b', 'c'), '/a/b/c');
assert.strictEqual(join('/', 'foo', 'bar'), '/foo/bar');
assert.strictEqual(join('/a', '/b'), '/a/b');
assert.strictEqual(joinPaths('/foo', 'bar'), '/foo/bar');

// 5. join collapses redundant interior slashes while preserving trailing slashes on final segment
assert.strictEqual(join('a///b//', 'c/'), 'a/b/c/');
assert.strictEqual(join('a///b//', 'c'), 'a/b/c');
assert.strictEqual(join('dir/', 'sub/'), 'dir/sub/');
assert.strictEqual(join('dir/', 'sub'), 'dir/sub');
assert.strictEqual(join('/'), '/');

// 6. join returns a single dot for empty path inputs
assert.strictEqual(join(), '.');
assert.strictEqual(join(''), '.');
assert.strictEqual(join('', ''), '.');
assert.strictEqual(joinPaths(''), '.');

console.log('Contract tests passed successfully.');