Cross-Platform Asset Path Normalizer

Normalize mixed operating-system file paths into consistent forward-slash absolute paths anchored to a project root, removing duplicates while preserving order.

Capabilities

Normalizes mixed separators

• With paths = ["C:\\\\project\\\\styles\\\\main.css", "styles/theme.css"] and projectRoot = "C:\\\\project", return ["C:/project/styles/main.css", "C:/project/styles/theme.css"]. @test

Resolves dot segments

• With paths = ["./styles/../styles/core.css", "../shared/reset.css"] and projectRoot = "/home/app", return ["/home/app/styles/core.css", "/home/shared/reset.css"]. @test

Preserves UNC shares

• With paths = ["\\\\\\\\Server\\\\Share\\\\assets\\\\img.png", "//Server/Share/assets/img.png"], return ["//Server/Share/assets/img.png"], keeping the UNC share prefix intact while de-duplicating. @test

Deduplicates after normalization

• With paths = ["C:\\\\Project\\\\assets\\\\logo.png", "C:/Project/assets/logo.png", "assets\\\\logo.png"] and projectRoot = "C:\\\\Project", return ["C:/Project/assets/logo.png"], keeping only the first occurrence after normalization. @test

Implementation

@generates

API

export type NormalizedPath = string;

/**
 * Converts a list of file paths into normalized absolute paths anchored to the provided project root.
 * - Relative paths are resolved against projectRoot.
 * - Path separators use forward slashes across platforms, including Windows and UNC inputs.
 * - Dot segments (`.` and `..`) are resolved.
 * - Duplicates (after normalization) are removed while preserving the order of first appearance.
 *
 * @param paths List of file paths from mixed operating systems.
 * @param projectRoot Absolute path for resolving relative entries.
 * @returns Ordered list of unique normalized absolute paths.
 */
export function normalizeAssetPaths(paths: string[], projectRoot: string): NormalizedPath[];

Dependencies { .dependencies }

@tailwindcss/node { .dependency }

Provides cross-platform path normalization utilities needed to normalize Windows, POSIX, and UNC paths.