Skip to contents

Changelog

Source: NEWS.md

jsplyr 0.1.0

Initial CRAN release.

Core interface:

  • Added a dplyr interface for manipulating data in JavaScript with tbl(), copy_to(), collect(), compute(), and show_query().
  • Added a promise-based collect() decoupled from shiny’s reactive input system. compute() uses session$registerDataObj() to create a session-scoped HTTP callback; the JS side POSTs the result to it, resolving a promise. collect() does not require a reactive context.
  • Embedded compute() within collect() so it runs automatically when not called earlier in the pipeline.
  • Re-exported the promise pipe operators %...>%, %...!%, and %...T>% from promises, so collect() results can be consumed in reactive contexts without attaching promises.

Verbs:

  • Added the filter() verb to subset rows by predicate expressions, evaluated client-side. Comparisons (==, >, <, etc.) combined with &/| are supported. Values referenced from input or the calling environment are resolved on the R side; column references are evaluated in the browser.
  • Added the select() verb to choose columns by name.
  • Added the distinct() verb to keep unique rows. When columns are supplied in ... only those determine uniqueness and the first row per unique combination is kept; with no columns all columns are used. Supports .keep_all to retain all columns in the output.
  • Added the mutate() verb for adding or modifying columns using expressions. Supports both non-standard evaluation and character string inputs.
  • Added ifelse() support in mutate() expressions, translated to JavaScript ternary operators. Nested ifelse() calls are supported.
  • Added if_else() as an alias for ifelse() in mutate() expressions; both translate to JavaScript ternary operators.
  • Added case_when() support in mutate() expressions, translated to chained JavaScript ternary operators. Clauses without a TRUE ~ ... catch-all yield null for unmatched rows, matching dplyr’s NA default.
  • Added group_by() and summarise() verbs with support for mean(), sum(), min(), max(), n(), sd(), and median() aggregation functions.
  • Added join verbs left_join(), right_join(), inner_join(), full_join(), semi_join(), and anti_join(). Joining two tbl_lazy_json tables is performed in the browser. Supports by as a natural join (default), a shared key, or a named vector for differing key names. Colliding non-key columns get .x/.y suffixes.
  • Added is.na(), between(), and across()/if_all()/if_any() support in filter() expressions. is.na() and between() are translated to JavaScript on the browser side, while across()/if_all()/if_any() are expanded over the selected columns (combined with & for across()/if_all() and | for if_any()). Column selections accept c(...), a bare column, a character vector, and all_of()/any_of().
  • Added across() support to mutate() and summarise(), and all_of()/any_of()/across() column resolution to group_by(). across() is expanded on the R side over the selected columns and accepts a single function, a formula lambda (~ .x * 2), or a named list of functions, with optional .names glue ({.col}/{.fn}). if_any()/if_all() remain filter()-only.
  • Added ungroup() to remove grouping set by group_by(). With no arguments all grouping is dropped; supplying column names removes only those columns from the grouping set (partial ungroup), matching dplyr::ungroup().
  • Added arrange() to sort rows client-side by one or more columns. Wrap a column in desc() for descending order; multiple keys break ties left to right and the sort is stable. NA/null values sort last.
  • Added rename() to rename columns with new = old pairs, preserving column order.
  • Added the slice() family: slice() (integer positions, negative positions drop rows), slice_head()/slice_tail() (first/last n or prop), and slice_min()/slice_max() (rows with the smallest/largest values of a column). Slicing is group-aware when the data is grouped with group_by().
  • Added pull() to extract a single column as a vector. Like collect(), it returns a promises::promise() resolving to the vector. Supports selection by name and by position, including negative indices counting from the last column.
  • Added count() and tally(). count() groups by the given columns and counts rows per group; tally() counts within an existing group_by(). Both honour the name (default "n") and sort arguments and reuse the group_by()/summarise() machinery.
  • Added relocate() to reorder columns using .before/.after placement, defaulting to moving the selected columns to the front.
  • Added a print() method for tbl_lazy_json that shows the JSON source, a lazy (not-yet-computed) status, and the pending pipeline rendered as dplyr-like calls. Mirrors dbplyr’s lazy tbl print, without retrieving data from the browser.

Documentation:

CI/CD:

  • Added GitHub Actions workflows for linting (lintr::lint_package()), a standalone testthat run for fast PR feedback, test coverage reporting via covr with Codecov upload, and a version-bump check that fails PRs which do not bump the DESCRIPTION Version.
  • Added a pkgdown workflow that builds the documentation site and deploys it to GitHub Pages.
  • Added R-CMD-check, Lint, Codecov, and CRAN downloads badges to the README.