Path Utilities

function normalize(path: string): string

import { normalize } from '@core/utils/path';

normalize('/foo/bar/../baz'); // '/foo/baz'
normalize('./foo//bar/'); // 'foo/bar'
normalize('foo/./bar'); // 'foo/bar'
normalize(''); // '.'
normalize('/'); // '/'

function isAbsolute(path: string): boolean

import { isAbsolute } from '@core/utils/path';

isAbsolute('/foo/bar'); // true
isAbsolute('foo/bar'); // false
isAbsolute('../foo'); // false

function join(...segments: string[]): string

import { join } from '@core/utils/path';

join('/foo', 'bar', 'baz'); // '/foo/bar/baz'
join('foo', '../bar'); // 'bar'
join('foo', '', 'bar'); // 'foo/bar' (empty segments ignored)
join('foo', './bar'); // 'foo/bar'

function resolve(cwd: string, ...segments: string[]): string

import { resolve } from '@core/utils/path';

resolve('/home/user', 'docs', 'file.txt'); // '/home/user/docs/file.txt'
resolve('/home/user', '../other'); // '/home/other'
resolve('/home/user', '/absolute/path'); // '/absolute/path'
resolve('/home/user', 'foo', '../bar'); // '/home/user/bar'

function dirname(path: string): string

import { dirname } from '@core/utils/path';

dirname('/foo/bar/baz.txt'); // '/foo/bar'
dirname('/foo/bar/'); // '/foo/bar'
dirname('/foo'); // '/'
dirname('foo/bar'); // 'foo'
dirname('foo'); // '.'

function basename(path: string, ext?: string): string

import { basename } from '@core/utils/path';

basename('/foo/bar/baz.txt'); // 'baz.txt'
basename('/foo/bar/baz.txt', '.txt'); // 'baz'
basename('/foo/bar/'); // 'bar'
basename('baz.txt', '.txt'); // 'baz'

function extname(path: string): string

import { extname } from '@core/utils/path';

extname('file.txt'); // '.txt'
extname('file.tar.gz'); // '.gz'
extname('file'); // ''
extname('.bashrc'); // ''
extname('/path/to/file.txt'); // '.txt'

function split(path: string): string[]

import { split } from '@core/utils/path';

split('/foo/bar/baz'); // ['/', 'foo', 'bar', 'baz']
split('foo/bar/baz'); // ['foo', 'bar', 'baz']
split('/'); // ['/']
split('foo'); // ['foo']

import * as path from '@core/utils/path';

// Build file path
const projectRoot = '/home/user/project';
const srcDir = path.join(projectRoot, 'src');
const filePath = path.resolve(srcDir, 'components', 'Button.tsx');
console.log(filePath); // '/home/user/project/src/components/Button.tsx'

// Extract path components
const dir = path.dirname(filePath); // '/home/user/project/src/components'
const file = path.basename(filePath); // 'Button.tsx'
const name = path.basename(filePath, '.tsx'); // 'Button'
const ext = path.extname(filePath); // '.tsx'

// Navigate paths
const parentDir = path.resolve(dir, '..');
console.log(parentDir); // '/home/user/project/src'

// Check path type
if (path.isAbsolute(filePath)) {
  console.log('Absolute path');
}

// Split path into segments
const segments = path.split(filePath);
console.log(segments);
// ['/', 'home', 'user', 'project', 'src', 'components', 'Button.tsx']

const cwd = '/home/user';
const relative = '../other/file.txt';
const absolute = path.resolve(cwd, relative);
// '/home/other/file.txt'

const filePath = '/path/to/document.pdf';
const name = path.basename(filePath, path.extname(filePath));
// 'document'

const original = '/path/to/file.ts';
const dir = path.dirname(original);
const base = path.basename(original, '.ts');
const newPath = path.join(dir, base + '.js');
// '/path/to/file.js'

const userPath = 'foo//bar/../baz/./file.txt';
const normalized = path.normalize(userPath);
// 'foo/baz/file.txt'