@spec append_extractor_diag(map(), map()) :: map()

Append an extractor/analyzer diagnostic entry.

@spec decode(binary()) :: {:ok, map()} | {:error, Whiff.Error.t()}

Decode JSON bytes from the NIF into a string-keyed map.

@spec native_covered?(map()) :: boolean()

True when native extraction appears to have run a covering extractor for the identified format (not mere magic detection).

Low-confidence heuristic text hits without extension_matches are not treated as covered — proprietary extensions often look like plain text to upstream, and Elixir :fallback Whiffers must still run for those.

@spec schema_version() :: String.t()

The schema identifier written to whiff.schema.

@spec top_level_sections() :: [String.t()]

Stable top-level section names.