pathe 1.1.2

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 pkg:npm/pathe@1.1.2
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/pathe@1.1.2

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:c8224c8fdd6926afd66707975434240fa2cc8144dfb23d43cf93ffbee4d69e79","constraints":{"executionContext":"node"},"contract":["normalize(path) normalizes backslashes to forward slashes and resolves relative segments","join(...paths) joins path segments with forward slashes and normalizes result","resolve(...paths) resolves sequence of paths into an absolute normalized path","relative(from, to) returns relative path using forward slashes","dirname, basename, and extname extract path components accurately","isAbsolute(path) determines whether a path is absolute on posix and windows formats","parse and format roundtrip path structures"],"goal":"verify pkg:npm/pathe@1.1.2","kind":"HOW","packages":["pkg:npm/pathe@1.1.2"],"schemaVersion":1},"contractCommand":["node","test/contract.js"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/pathe@1.1.2"],"schemaVersion":1,"subject":"pkg:npm/pathe@1.1.2","verifierAdapter":"node-typescript@1"}

'use strict';

const pathe = require('pathe');

function normalizePath(p) {
  return pathe.normalize(p);
}

function joinPaths(...paths) {
  return pathe.join(...paths);
}

function resolvePath(...paths) {
  return pathe.resolve(...paths);
}

function getRelativePath(from, to) {
  return pathe.relative(from, to);
}

function getPathInfo(p) {
  return {
    dir: pathe.dirname(p),
    base: pathe.basename(p),
    ext: pathe.extname(p),
    isAbs: pathe.isAbsolute(p),
  };
}

module.exports = {
  normalizePath,
  joinPaths,
  resolvePath,
  getRelativePath,
  getPathInfo,
  pathe,
};

{
  "name": "sample-4030221818",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-4030221818",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "pathe": "1.1.2"
      }
    },
    "node_modules/pathe": {
      "version": "1.1.2",
      "resolved": "https://registry.npmjs.org/pathe/-/pathe-1.1.2.tgz",
      "integrity": "sha512-whLdWMYL2TwI08hn8/ZqAbrVemu0LNaNNJZX73O6qaIdCTfXutsLhMkjdENX0qhsQ9uIimo4/aQOmXkoon2nDQ==",
      "license": "MIT"
    }
  }
}

{
  "name": "sample-4030221818",
  "version": "1.0.0",
  "description": "Minimal sample verifying pathe@1.1.2",
  "main": "index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "keywords": [],
  "author": "",
  "license": "MIT-0",
  "dependencies": {
    "pathe": "1.1.2"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/pathe@1.1.2",
  "kind": "HOW",
  "packages": [
    "pkg:npm/pathe@1.1.2"
  ]
}

'use strict';

const assert = require('assert');
const pathe = require('pathe');
const {
  normalizePath,
  joinPaths,
  resolvePath,
  getRelativePath,
  getPathInfo,
} = require('../index.js');

function runContract() {
  // 1. normalize(path) normalizes backslashes to forward slashes and resolves relative segments
  assert.strictEqual(pathe.normalize('foo\\bar\\baz'), 'foo/bar/baz');
  assert.strictEqual(normalizePath('foo\\bar\\baz'), 'foo/bar/baz');
  assert.strictEqual(pathe.normalize('foo/bar//baz/asdf/quux/..'), 'foo/bar/baz/asdf');
  assert.strictEqual(normalizePath('foo/bar//baz/asdf/quux/..'), 'foo/bar/baz/asdf');
  assert.strictEqual(pathe.normalize(''), '.');

  // 2. join(...paths) joins path segments with forward slashes and normalizes result
  assert.strictEqual(pathe.join('foo', 'bar', 'baz/asdf', 'quux', '..'), 'foo/bar/baz/asdf');
  assert.strictEqual(joinPaths('foo', 'bar', 'baz/asdf', 'quux', '..'), 'foo/bar/baz/asdf');
  assert.strictEqual(pathe.join('/foo', 'bar', 'baz'), '/foo/bar/baz');
  assert.strictEqual(joinPaths('/foo', 'bar', 'baz'), '/foo/bar/baz');
  assert.strictEqual(pathe.join('a', 'b', 'c'), 'a/b/c');

  // 3. resolve(...paths) resolves sequence of paths into an absolute normalized path
  assert.strictEqual(pathe.resolve('/foo/bar', './baz'), '/foo/bar/baz');
  assert.strictEqual(resolvePath('/foo/bar', './baz'), '/foo/bar/baz');
  assert.strictEqual(pathe.resolve('/foo/bar', '/app/file/'), '/app/file');
  assert.strictEqual(resolvePath('/foo/bar', '/app/file/'), '/app/file');
  assert.strictEqual(pathe.resolve('/a/b', '../c'), '/a/c');

  // 4. relative(from, to) returns relative path using forward slashes
  assert.strictEqual(
    pathe.relative('/data/project/test/aaa', '/data/project/impl/bbb'),
    '../../impl/bbb'
  );
  assert.strictEqual(
    getRelativePath('/data/project/test/aaa', '/data/project/impl/bbb'),
    '../../impl/bbb'
  );
  assert.strictEqual(pathe.relative('/data/project/test/aaa', '/data/project/test/aaa'), '');

  // 5. dirname, basename, and extname extract path components accurately
  assert.strictEqual(pathe.dirname('/foo/bar/baz/asdf/quux'), '/foo/bar/baz/asdf');
  assert.strictEqual(pathe.basename('/foo/bar/baz/asdf/quux.html'), 'quux.html');
  assert.strictEqual(pathe.basename('/foo/bar/baz/asdf/quux.html', '.html'), 'quux');
  assert.strictEqual(pathe.extname('index.html'), '.html');
  assert.strictEqual(pathe.extname('index'), '');

  const info = getPathInfo('/foo/bar/baz/quux.html');
  assert.deepStrictEqual(info, {
    dir: '/foo/bar/baz',
    base: 'quux.html',
    ext: '.html',
    isAbs: true,
  });

  // 6. isAbsolute(path) determines whether a path is absolute on posix and windows formats
  assert.strictEqual(pathe.isAbsolute('/foo/bar'), true);
  assert.strictEqual(pathe.isAbsolute('foo/bar'), false);
  assert.strictEqual(pathe.isAbsolute('//server/share'), true);

  // 7. parse and format roundtrip path structures
  const parsed = pathe.parse('/app/docs/dir/file.txt');
  assert.deepStrictEqual(parsed, {
    root: '/',
    dir: '/app/docs/dir',
    base: 'file.txt',
    ext: '.txt',
    name: 'file',
  });
  assert.strictEqual(pathe.format(parsed), '/app/docs/dir/file.txt');

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

runContract();