Changelog

Source: NEWS.md

fundsr (development version)

General

• add new structured error/state-checking framework; improve error messages, standardize classes
• add session management to all functions requiring state via session parameter (not specifying it uses a default session fo backwards compatibility / simple use cases)

Importing

• validate imported time series have unique dates (also check for this during tracking difference calculations)
• add a provider wrapper for BNP Paribas ETFs
• support/fix numeric sheet selection for Excel 2003 XML files

Examples

• add cash funds
• fix Japan gross index import

fundsr 0.4.0

Breaking changes

• reorder arguments in msci() to match package convention

Importing

• add postprocess param to store_timeseries()
• add ... param to import wrappers, passing it upstream to store_timeseries()
• add line_filter param to read_timeseries()
• add Avantis CSV NAV history support

Examples

• add Eurozone and EURO STOXX 50
• add Japan

fundsr 0.3.0

Breaking changes

• rename clear_storage() argument clear_fund_index_map to clear_map to avoid name clash with clear_fund_index_map()
• change join_env() full join order to alphabetical

Importing

• add support for unabbreviated month names (specify with capital M in date_order parameters, e.g. "Mdy")
• add download checks, retries, temp + atomic rename for download_fund_data(); also prefer curl when available (curl added to Suggests:)

Documentation

• add categories to function reference; improve docs, doc-examples, vignettes
• add a logo

Fixes

• fix unset fundsr.data_dir behavior (stop writing to working directory; use tools::R_user_dir("fundsr", which = "data"))

fundsr 0.2.1

Documentation

• add Importing vignette and improve docs and vignettes

Rolling diffs

• add Excel reader function read_timeseries_excel()
• improve read_timeseries(): support text dates, any column name for date
• add fund_index_map merge/clean functions add_fund_index_map(), clean_fund_index_map()
• add example Excel + CSV dataset in extdata
• late_join parameter to join_env()
• param rename/depr.: data_sheet -> sheet, coalesce_suffixed -> join_precedence

Plot output

• add automatic Inkscape detection

Fixes

• add various join_env() df and column checks to make errors easier to understand

Vignettes, examples, translations

• fix examples to use system.file()

fundsr 0.2.0

Rolling diffs

• improve gross/net index handling (no state resets needed; index_level and gross_suffix parameters to roll_diffs())
• add build_all_series() (wrapping around run_data_loaders() and join_env())
• refactor roll_diffs() for speed / better interface

Survival plots

• add survival curve plots using Human Mortality Database (HMD) empirical data and EUROPOP2023 projections

Fixes

• skip unavailable funds, indices when calculating differences
• ensure y-limits in rolling-difference plots include the last 30 days (even if outside quantiles)
• make roll_diffs() skip benchmarks (in addition to funds) that are not found in supplied df
• more robust gg_params list flattening
• date breaks on fixed months, quarter or biannual (once plot >3 yrs)

Tests

• add rolling test

Vignettes, examples, translations

• add life vignette
• add more example scripts; translate more index names in common_spec
• fix glob_funds example to include EUR indices
• fix Bulgarian translation: wrong y-axis label on log-return charts
• translate all examples to Bulgarian

fundsr 0.1.0

Configuration

• fundsr_options() provides a validated wrapper around options() for setting common fundsr.* options (data directories, export settings, URL registry, and more).
• add_fund_urls() adds/updates the fund download registry (option fundsr.fund_urls).

Import and storage

• Internal caching/storage for imported time series via a storage environment (get_storage(), clear_storage(), store_timeseries()), with optional forced refresh via options(fundsr.reload = TRUE).
• Extensible data-loader framework for imports (add_data_loader(), run_data_loaders(), clear_data_loaders()).
• Download and import helpers:
  • Download configured fund files to a local data directory (download_fund_data()).
  • Read generic delimited time series with epoch timestamps (read_timeseries()).
  • Read MSCI TSV files (read_msci_tsv()) and import MSCI Excel data via msci().
  • Import fund NAV (and optional benchmark series) from Excel and register fund→benchmark mappings (load_fund(), get_fund_index_map()).
  • Fallback parser for Excel 2003 XML (SpreadsheetML) files.
• Convenience helpers for provider-specific Excel formats: ishs() (iShares), spdr() (SPDR), xtra() (Xtrackers), amun() (Amundi), inve() (Invesco), vang() (Vanguard), ubs() (UBS), hsbc() (HSBC).
• join_env() combines multiple tables stored in an environment, with optional “late” left-joins and optional coalescing of .x/.y join columns.

Rolling differences

• roll_diffs() computes rolling, annualized tracking differences for fund–index pairs with either log-return or CAGR-style variants, producing <fund>_rd columns.

Plotting and export

• plot_roll_diffs() visualizes rolling tracking-difference series with quantile-based y-limits and bps axis labeling.
• run_plots() generates plot sets from a specification, producing both CAGR and log-return variants.
• SVG-first export pipeline: save_plot() writes SVG files and queues PNG exports for batch conversion via Inkscape (export_pngs()), with clear_inkscape_queue() to reset the queue.
• Optional direct PNG export via ggplot2::ggsave() without Inkscape (lower quality; controlled by fundsr.internal_png).
• Xetra Liquidity Measure (XLM) support: read and plot XLM time series (read_xlm_directory(), plot_xlms()), with optional back-translation of displayed tickers using options(fundsr.xetra_map).

Internationalization

• Chart elements are available in two languages (English and Bulgarian), with language selection based on LANGUAGE / LC_MESSAGES.
• Language-aware user-supplied strings are supported via named vectors keyed by language code.

Utilities

• reset_state() clears cached storage, loader registry, queued exports, and XLM bookkeeping for the current session.