pathe 2.0.3: dirname

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.dirname 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.dirname

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:b04fc5371585776e5fffd41a8cc2e2bd908b88ef9356f667a5bffe9510fabc79","contract":["pathe.dirname returns the directory name of a POSIX path","pathe.dirname ignores trailing slashes when determining parent directory","pathe.dirname returns root slash for top-level absolute paths and root itself","pathe.dirname returns a dot for single relative segments or empty string","pathe.dirname normalizes backslashes to forward slashes in path arguments","pathe.dirname handles parent and current relative directory navigation segments"],"goal":"verify pathe.dirname in pkg:npm/pathe@2.0.3","kind":"HOW","packages":["pkg:npm/pathe@2.0.3"],"schemaVersion":1,"symbols":["pathe.dirname"]},"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.dirname"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-pathe-dirname",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-pathe-dirname",
      "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-dirname",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room code sample for pathe.dirname in pathe@2.0.3",
  "main": "src/index.js",
  "license": "MIT-0",
  "dependencies": {
    "pathe": "2.0.3"
  }
}

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

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

/**
 * Returns the directory name of a path in normalized POSIX format.
 *
 * @param {string} path - Input path string.
 * @returns {string} Directory name in POSIX format.
 */
function getDirname(path) {
  return dirname(path);
}

module.exports = {
  pathe,
  dirname,
  getDirname
};

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

const require = createRequire(import.meta.url);
const { pathe, dirname, getDirname } = require('../src/index.js');

async function runTests() {
  // 1. pathe.dirname returns the directory name of a POSIX path
  assert.equal(typeof pathe.dirname, 'function', 'pathe.dirname must be a function');
  assert.equal(typeof dirname, 'function', 'dirname must be a function');
  assert.equal(dirname('/foo/bar/baz'), '/foo/bar', 'dirname should return parent directory');
  assert.equal(getDirname('/foo/bar'), '/foo', 'getDirname helper should return directory');

  // 2. pathe.dirname ignores trailing slashes when determining parent directory
  assert.equal(dirname('/foo/bar/baz/'), '/foo/bar', 'trailing slash should be ignored when resolving parent directory');
  assert.equal(dirname('foo/bar/'), 'foo', 'trailing slash on relative path should return parent');

  // 3. pathe.dirname returns root slash for top-level absolute paths and root itself
  assert.equal(dirname('/foo'), '/', 'dirname of top-level file should return root slash');
  assert.equal(dirname('/'), '/', 'dirname of root slash should return root slash');

  // 4. pathe.dirname returns a dot for single relative segments or empty string
  assert.equal(dirname('file.txt'), '.', 'single filename should return dot');
  assert.equal(dirname('foo'), '.', 'single segment should return dot');
  assert.equal(dirname(''), '.', 'empty string should return dot');

  // 5. pathe.dirname normalizes backslashes to forward slashes in path arguments
  assert.equal(dirname('foo\\bar\\baz'), 'foo/bar', 'backslashes should normalize to forward slashes');
  assert.equal(dirname('foo\\bar'), 'foo', 'relative path with backslash should normalize to forward slashes');

  // 6. pathe.dirname handles parent and current relative directory navigation segments
  assert.equal(dirname('../foo/bar'), '../foo', 'parent directory navigation should be preserved');
  assert.equal(dirname('../foo'), '..', 'relative parent should return double-dot');
  assert.equal(dirname('./foo/bar'), './foo', 'relative dot prefix should be preserved');

  console.log('All contract assertions for pathe.dirname passed successfully.');
}

runTests().catch((err) => {
  console.error('Contract test failed:', err);
  process.exit(1);
});