# aftables 2.0.1

 * Bug fix: added rlang import for backwards compatibility with R versions < 4.4.0 (#147)

# aftables 2.0.0

 * Major update of package back-end to use openxlsx2 functions to build and format workbook (#70).
 * Bug fix: ensured columns containing both numbers/currencies and shorthand have numeric formatting applied to prevent Excel warning of numbers formatted as characters. (#93)
 * Bug fix: numeric formatting applies thousand separators by default. (#51)
 * Added new feature to set document properties and text formatting in a config.yaml file. The new function `create_config_yaml()` exports an example `config.yaml` file for users to amend. New arguments `config_path` and `config_name` in `generate_workbook()` are available to users to specify configurations. Alternative arguments `author`, `title` and `keywords` are available to set minimum recommended workbook properties without using a `config.yaml` file. (#55, #138)

 * Internal: Added code to generate aftables hex logo using {gex} (#134)

# aftables 1.0.2

* Updated package name to aftables. Function names have been updated to remove references to a11ytables.

# a11ytables 0.3.2

* Bug fix: ensured factors are converted to character before assessing whether the column needs to be widened (#110, #113).

# a11ytables 0.3.1

* Bug fix: made it an error if tab names are started with a numeric value (#124).
* Reduced gif file size, include additional frame (#121).

# a11ytables 0.3.0

## Breaking changes

* The new `custom_rows` argument is the third-to-last argument to `create_a11ytable()` (it's been inserted before `sources` and `tables`) so that the argument order reflects the order of the pre-table rows that appear above tables in the spreadsheet output; this will be a problem for users of {a11ytables} before v0.3 who might have previously specified arguments _by place_ rather than _by name_ (I assume most will have specified arguments by name, so I expect this won't be much of a problem).

## New features

* Added the `custom_rows` argument to the `create_a11ytables()` function to supply arbitrary sentences to separate rows above a table in contents, cover and notes sheets (#74).
* Allowed custom rows to be hyperlinks if the user provides them in Markdown-style (#74).
* Added the datasets `demo_df` ('data.frame' class) and `demo_a11ytable` ('a11ytables' class) to help demo the new `custom_rows` argument (and do a better job of showcasing other features of the package), superseding `mtcars_df` and `mtcars_df2`.

## Bugfixes

* Adjusted Markdown-link detection in cases where the text portion contained parentheses (#119).
* Ensured the summary method printed table dimensions of cover list items (#79).

## Documentation

* Updated {roxygen2} function documentation given the introduction of `custom_rows`.
* Updated vignettes to include detail on how to use `custom_rows`.
* Updated accessibility checklist vignette to include 'sensible column width' item (#117).

## Miscellaneous

* Simplified the output of the summary method (#79).
* Updated tests to use `demo_*` datasets.
* Updated RStudio Addin given `custom_rows` and simplified to data.frame example only.
* Added internal `.vector_to_sentence()` function to help construct comma-separated lists from a vector.

# a11ytables 0.2.1

* Bugfix: corrected spelling error in installation instructions in README (#111).
* Accessibility fix: display number of tables with text rather than a numeral (#109).

# a11ytables 0.2.0

## New features

* Allowed the cover information passed to `create_a11ytable()` to be supplied as a list rather than a data.frame, which means you can have an arbitrary number of rows under each section (#102).
* Allowed the user to supply links in Markdown format (e.g. `[GOV.UK](https://www.gov.uk)`) when passing the cover information to the `tables` argument of `create_a11ytables()` (#47).
* Allowed the user to supply links in Markdown format (e.g. `[GOV.UK](https://gov.uk)`) when passing the data source reference to the `source` argument of `create_a11ytables()` (#47).
* Added an `mtcars_df2` demo data set that contains a list input for the cover page, which itself contains Markdown-formatted hyperlinks.

## Bugfixes

* Ensured `stringsAsFactors` is set explicitly to `FALSE` in the `data.frame` call within `create_a11ytable()`, given that this default behaviour changed in R version 4 (#85).

## Docs

* Updated the 'a11ytables' vignette given the new features.
* Updated function documentation given the new features.

# a11ytables 0.1.0

## Breaking changes

* Renamed the `new_a11ytable()` function to `create_a11ytable()` (#27).
* Renamed the `create_a11y_wb()` function to `generate_workbook()` and changed the main argument from 'content' to 'a11ytable' (#27).
* Removed the 'table_names' argument to `create_a11ytable()` and instead autogenerate them from the user-provided 'tab_title' (#61).
* Introduced the `blank_cells` argument to `create_a11ytable()` so the user can provide a table-by-table reason for why cells might be empty (#62).
* Adjusted the in-built `mtcars_df` data set to better fit the changes to the functions.

## Bugfixes

* Provided a warning, rather than error, if you don't provide any 'source' argument to `create_a11ytable()`.

## Docs

* Added a vignette to provide an overview of the code underlying the package so that it's easier for developers to contribute (#58).
* Added a vignette to explain the terminology of a spreadsheet, as used in the package (#58).
* Referred to the updated gptables Python package and the best practice spreadsheet guidance on the Analysis Function website (#73).
* Added hex logo (#81).
* Updated README and other vignettes to reflect changes to the function API.
* Corrected various typos.

## Miscellaneous

* Increased test coverage (#63).
* Updated user-input sanitising: it now removes punctuation in 'tab_title', inserts underscores in place of spaces and adds full-stops to blank_cells and source data (#78).
* Consolidated all a11ytable-class-related functioning into `as_a11ytable()` so that `create_a11ytable()` only has to build a data.frame from supplied arguments and apply `as_a11ytable()` to it (#80).
* Added warning for user if the 'blank_cells' argument is provided to `create_a11ytable()` but there are no blank cells in the table, and vice versa.
* Updated content of RStudio Addins to reflect function and argument changes.
* Adjusted default column widths in notes and contents.
* Renamed files in R/ for consistency and clarity.
* Switched to `inherits()` for class detection in `if()` statements.

# a11ytables 0.0.0.90015

* Added and improved warnings and errors (#34).
* Simplified the in-built data set so it matches the 'get started' vignette.
* Updated the gif used in the 'get started' vignette.

# a11ytables 0.0.0.90014

* Added explanations to the accessibility checklist vignette.
* Converted the 'quickstart' vignette to 'get started', used a simpler example, added gif.
* Removed the 'construct' vignette.
* Used 'reference' in _pkgdown.yaml to better separate functions on the site.

# a11ytables 0.0.0.90013

* Added an RStudio Addin to insert code for an {a11ytables} workflow (#54).

# a11ytables 0.0.0.90012

* Made source, notes and table insertion dynamic, so the row of insertion of each is dependent on the others (#33).
* Applied table styling based on dynamic table placement (#33).

# a11ytables 0.0.0.90011

* Prevented the tab title being pasted into the titles of tables sheets (#48).
* Made sure to wrap non-header cells in tables sheets (#41).
* Provided an auto-column-width adjustment in tables where cell content or headers is long (#41).

# a11ytables 0.0.0.90010

* Added warnings if issues are detected when making an a11ytables-class object (#34).
* Added a modified mtcars example data set, `mtcars_df` (#20).
* Expunged `lfs_tables` (#20).
* Added 'Crown Copyright' to authors as the copyright holder .
* Updated README and vignettes given these changes.
* Added new quickstart vignette and simplified README (#43).
* Handled plurals and periods in meta sheet elements, update detection of notes in column headers.

# a11ytables 0.0.0.9009

* HOTFIX: corrected `.detect_notes()` so it actually works.
* Converted the `print` method to a `summary` method, as suggested by @TimTaylor (#23).
* Imported {pillar} for {tibble}-style printing, as suggested by @TimTaylor (#26).
* Added @TimTaylor as a contributor.
* Updated vignettes and README.

# a11ytables 0.0.0.9008

* Ensured numeric columns (even if they contain a string like '[c]' to indicate a suppressed value) are right-aligned (#32).
* Isolated out `.insert_*()` functions for table count and note presence from `.insert_prelim_a11y()`, for clarity.

# a11ytables 0.0.0.9007

* BREAKING CHANGE: removed subtables because they're not being used for now and are confusing.
* Added the first draft vignettes on how to create an a11ytable and an accessibility guidance checklist (#22).

# a11ytables 0.0.0.9006

* HOTFIX: fixed a problem where the `tab_title` was being used to filter when it should have been `sheet_type`.

# a11ytables 0.0.0.9005

* BREAKING CHANGE: the user-supplied table for the cover sheet should now be supplied as a tidy two-column data.frame with a row per subsection, with columns for the 'subsection title' and 'subsection body'.
* Updated the `lfs_tables` and `lfs_subtables` example data sets given the above; for an example see `lfs_tables[lfs_tables$sheet_type == "cover", "table"][[1]]`.

# a11ytables 0.0.0.9004

* BREAKING CHANGE: switched to using the `sheet_type` column of an a11ytable-class object to infer the sheet type as 'cover', 'contents', 'notes' or 'tables' (replacing 'meta'); it's no longer the `tab_title` that serves this role (#18).
* Ensured styles and `.add_*()` now make internal references to `sheet_type` rather than `tab_title`.

# a11ytables 0.0.0.9003

* BREAKING CHANGE: retired fully the `add_*()` function family for building a workbook 'by hand', given the introduction of `create_a11y_wb()`.
* Introduced S3 class 'a11ytable', including exported functions to generate (`new_a11ytable()`, `as_a11ytable()`) and test (`is_a11ytable()`) objects of this class.

# a11ytables 0.0.0.9002

* Simplified all `add_*()` functions to a single `create_a11y_wb()` function (moving towards #15), though `add_*()` functions are all still exported.
* Split supplied data into two, with and without sub-table examples: `lfs_tables` and `lfs_subtables`, respectively.
* Updated README to detail simplified approach.

# a11ytables 0.0.0.9001

* Added un-exported `.style_*()` utils functions to style worksheets (#1).
* Incorporated style functions into `add_*table()*` functions.
* Updated README.
* Added basic tests, defensive stops (#10, #11).
* Added GitHub Actions for RMD check, coverage and {pkgdown} (#7).
* Transferred ownership from matt-dray to co-analysis (#9).

# a11ytables 0.0.0.9000

* Added a `NEWS.md`, `CODE_OF_CONDUCT.md`, `README.Rmd`.
* Added exported `add_*()` functions to create different tab types (cover, contents, notes, tables).
* Added un-exported `.insert_*()` utils functions to insert within-sheet elements.
* Added MIT license with `LICENSE.md`.
