Opaque file path type.

Build a path from a string. Accepts both / and \\ separators.

This normalizes the path to a stable representation:

• Converts \\ to /
• Collapses duplicate separators
• Removes . segments
• Resolves .. segments when possible
• Removes trailing separators (except for roots)

It accepts both relative and absolute paths.

Build a relative path from segments.

FilePath.relative [ "src", "Main.elm" ]
    |> FilePath.toString
--> "src/Main.elm"

Build an absolute path from segments.

FilePath.absolute [ "usr", "bin" ]
    |> FilePath.toString
--> "/usr/bin"

Convert a path to a string. Uses / separators.

Return path segments without root markers.

Append a path to a base path.

If nextPath has a root marker (absolute path, UNC path, or drive prefix), it replaces the base path.

Join many paths from left to right.

Parent directory of a path.

The final path segment, if any.

Filename without extension.

File extension without the dot.

Path to targetPath relative to basePath.

Returns Nothing when roots differ.

fromString "/foo/bar/qux"
    |> relativeTo (fromString "/foo")
    --> Just (fromString "bar/qux")

Resolve a file path to an absolute path using the OS-aware path.resolve from Node.js.

Relative paths are resolved against the current working directory.

import BackendTask exposing (BackendTask)
import FatalError exposing (FatalError)
import FilePath


resolveExample : BackendTask FatalError FilePath
resolveExample =
    FilePath.fromString "src/Main.elm"
        |> FilePath.resolve