import type { ProjectEntry } from "@t3tools/contracts";
import { isWindowsAbsolutePath, isHostPath } from "@t3tools/shared/path";
export interface FileBreadcrumb {
label: string;
path: string;
kind: "project" | "directory" | "file";
}
export interface FileBreadcrumbChild extends ProjectEntry {
label: string;
}
export function fileBreadcrumbs(projectName: string, relativePath: string): FileBreadcrumb[] {
const hostPath = isHostPath(relativePath);
const separator = isWindowsAbsolutePath(relativePath) ? "\\" : "/";
const parts = relativePath.split(/[\\/]/).filter(Boolean);
const root = relativePath.startsWith("\\\\") ? "\\\\" : relativePath.startsWith("/") ? "/" : "";
return [
...(hostPath ? [] : [{ label: projectName, path: "", kind: "project" as const }]),
...parts.map((part, index) => {
const path = root + parts.slice(0, index + 1).join(separator);
return {
label: part,
// A bare drive (`C:`) means the drive's current directory; its root is `C:\`.
// A bare `~` is not a host path; the home folder is `~/`.
path: /^[A-Za-z]:$/.test(path) ? `${path}\\` : hostPath && path === "~" ? "~/" : path,
kind: index === parts.length - 1 ? ("file" as const) : ("directory" as const),
};
}),
];
}
/** Use the crumb's path spelling so trailing or repeated separators still match. */
export function breadcrumbPathOf(relativePath: string): string {
return fileBreadcrumbs("", relativePath).at(-1)?.path ?? relativePath;
}
/** UNC servers are not listable directories; their shares are. */
export function isListableHostFolder(path: string): boolean {
return isHostPath(path) && !/^\\\\[^\\/]+$/.test(path);
}
function trailCrumbIndex(trail: string, path: string): number {
const crumbPath = breadcrumbPathOf(path);
return fileBreadcrumbs("", trail).findIndex((crumb) => crumb.path === crumbPath);
}
/** Retain descendant crumbs when navigating up; other navigation resets the trail to path. */
export function retainedBreadcrumbTrail(trail: string | undefined, path: string): string {
return trail !== undefined && trailCrumbIndex(trail, path) >= 0 ? trail : path;
}
export function trailChildOf(folder: string, trail: string): string | null {
const index = trailCrumbIndex(trail, folder);
return index < 0 ? null : (fileBreadcrumbs("", trail)[index + 1]?.label ?? null);
}
export function joinHostPath(folder: string, relativePath: string): string {
const separator = isWindowsAbsolutePath(folder) ? "\\" : "/";
const base = folder.endsWith(separator) ? folder : `${folder}${separator}`;
return base + relativePath.split("/").join(separator);
}
export function fileBreadcrumbChildren(
entries: readonly ProjectEntry[],
directoryPath: string,
): FileBreadcrumbChild[] {
let collator: Intl.Collator | undefined;
const prefix = directoryPath ? `${directoryPath}/` : "";
return entries
.flatMap((entry) => {
if (!entry.path.startsWith(prefix)) return [];
const label = entry.path.slice(prefix.length);
if (!label || label.includes("/")) return [];
return [{ ...entry, label }];
})
.toSorted((left, right) => {
if (left.kind !== right.kind) return left.kind === "directory" ? -1 : 1;
collator ??= new Intl.Collator(undefined, {
numeric: true,
sensitivity: "base",
});
return collator.compare(left.label, right.label);
});
}
export function fileBreadcrumbParent(directoryPath: string): string | null {
if (!directoryPath) return null;
const separatorIndex = directoryPath.lastIndexOf("/");
return separatorIndex === -1 ? "" : directoryPath.slice(0, separatorIndex);
}