@spec check_accounts([map()], %{required(String.t()) => atom() | String.t()}) ::
  :ok | {:error, String.t()}

Checks that all accounts in transactions are declared.

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

Checks that all commodities in transactions are declared.

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

Checks that all payees in transactions are declared.

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

Checks that all tags in transactions and comments are declared.

@spec extract_commodity_declarations(String.t()) :: MapSet.t(String.t())

Extracts commodity declarations from input (symbols only).

@spec extract_full_commodity_declarations(String.t()) :: %{
  required(String.t()) => map()
}

Extracts full commodity definitions from input.

Parses commodity declarations with their subdirectives:

• format: Display format string
• note: Description
• alias: Alternative symbol
• default: Whether this is the default commodity
• nomarket: Whether to exclude from market value calculations

Example

commodity CHF
    format CHF 1'000.00
    note Swiss Franc

Returns a map of symbol => commodity_definition.

@spec extract_payee_declarations(String.t()) :: MapSet.t(String.t())

Extracts payee declarations from input.

@spec extract_tag_declarations(String.t()) :: MapSet.t(String.t())

Extracts tag declarations from input.

@spec first_transaction([map()]) :: map() | nil

Returns the first transaction by date.

@spec last_transaction([map()]) :: map() | nil

Returns the last transaction by date.

@spec list_accounts([map()], %{required(String.t()) => atom() | String.t()}) :: [
  String.t()
]

Lists all unique accounts from transactions.

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

Lists all unique commodities (currencies) from transactions.

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

Lists all unique payees from transactions.

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

Lists all unique tags from transaction postings.