@spec build_order([map()]) :: [String.t()]

Returns the topological build order for workspace packages.

Packages with no inter-workspace dependencies come first.

@spec dep_graph([map()]) :: %{required(String.t()) => [String.t()]}

Returns a dependency graph of inter-workspace dependencies.

Finds which workspace packages depend on other workspace packages.

@spec discover(String.t()) :: {:ok, [map()]} | {:error, term()}

Discovers workspace packages from the root package.json.

Reads the workspaces field and resolves glob patterns to actual package directories. Returns a list of workspace info maps.

@spec names(String.t()) :: {:ok, [String.t()]} | {:error, term()}

Returns a list of workspace package names.

@spec workspace_root?(String.t()) :: boolean()

Checks if a directory is a workspace root (has workspaces field).