@spec detect_format(Path.t()) :: format()

Detects the config format from a file extension.

@spec encode(map(), format()) :: {:ok, String.t()} | {:error, term()}

Serializes a map to a config string.

@spec get(map(), String.t()) :: term()

Gets a nested value from a config map using dot-separated key path.

Examples

iex> Conf.get(%{retrieval: %{vector_weight: 0.5}}, "retrieval.vector_weight")
0.5

iex> Conf.get(%{foo: 1}, "bar")
nil

@spec load(
  Path.t(),
  keyword()
) :: {:ok, map()} | {:error, term()}

Loads a config file. Format is auto-detected from extension.

@spec merge([map()]) :: map()

Merges a list of config maps. Later entries override earlier ones.

@spec parse(String.t(), format()) :: {:ok, map()} | {:error, term()}

Parses a config string in the given format.

@spec print_summary(map(), String.t()) :: :ok

Prints a formatted summary of a config map to the terminal.

@spec set(map(), String.t(), term()) :: map()

Sets a nested value in a config map using dot-separated key path.

Returns an updated config map (immutable — original is not modified).

Examples

iex> Conf.set(%{retrieval: %{vector_weight: 0.5}}, "retrieval.vector_weight", 0.8)
%{retrieval: %{vector_weight: 0.8}}

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

Validates a config map against a schema map (shallow key-type check).

@spec write(Path.t(), map(), keyword()) :: :ok | {:error, term()}

Writes a map to a config file.