58 lines
1.8 KiB
TypeScript
58 lines
1.8 KiB
TypeScript
import { realpathSync } from "node:fs";
|
|
import { isAbsolute, relative, resolve as resolvePath, sep } from "node:path";
|
|
|
|
/**
|
|
* Resolve a path to its canonical (real) form, following symlinks.
|
|
* Falls back to the raw path if resolution fails (e.g. the target does
|
|
* not exist yet), so that callers never crash on missing filesystem
|
|
* entries.
|
|
*/
|
|
export function canonicalizePath(path: string): string {
|
|
try {
|
|
return realpathSync(path);
|
|
} catch {
|
|
return path;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns true if the value is NOT a package source (npm:, git:, etc.)
|
|
* or a URL protocol. Bare names and relative paths without ./ prefix
|
|
* are considered local.
|
|
*/
|
|
export function isLocalPath(value: string): boolean {
|
|
const trimmed = value.trim();
|
|
// Known non-local prefixes
|
|
if (
|
|
trimmed.startsWith("npm:") ||
|
|
trimmed.startsWith("git:") ||
|
|
trimmed.startsWith("github:") ||
|
|
trimmed.startsWith("http:") ||
|
|
trimmed.startsWith("https:") ||
|
|
trimmed.startsWith("ssh:")
|
|
) {
|
|
return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
function resolveAgainstCwd(filePath: string, cwd: string): string {
|
|
return isAbsolute(filePath) ? resolvePath(filePath) : resolvePath(cwd, filePath);
|
|
}
|
|
|
|
export function getCwdRelativePath(filePath: string, cwd: string): string | undefined {
|
|
const resolvedCwd = resolvePath(cwd);
|
|
const resolvedPath = resolveAgainstCwd(filePath, resolvedCwd);
|
|
const relativePath = relative(resolvedCwd, resolvedPath);
|
|
const isInsideCwd =
|
|
relativePath === "" ||
|
|
(relativePath !== ".." && !relativePath.startsWith(`..${sep}`) && !isAbsolute(relativePath));
|
|
|
|
return isInsideCwd ? relativePath || "." : undefined;
|
|
}
|
|
|
|
export function formatPathRelativeToCwdOrAbsolute(filePath: string, cwd: string): string {
|
|
const absolutePath = resolveAgainstCwd(filePath, cwd);
|
|
return (getCwdRelativePath(absolutePath, cwd) ?? absolutePath).split(sep).join("/");
|
|
}
|