chore: 2026 upkeep (#182)

* chore: 2026 upkeep (#180)

Addresses the 2026 upkeep checklist from usethis::use_tidy_upkeep_issue().

* Add tidy GitHub labels
* Add Code of Conduct (use_tidy_coc)
* Add lifecycle infrastructure; deprecate export(verbose=) with lifecycle
* Add rlang standalone types-check; replace stop() with cli::cli_abort()
* Delegate assert_nzchar_string() to rlang::check_string()
* Replace hand-rolled check in assets_remove() with check_character()
* Add Air formatter config (air.toml) and format-r-code: true in GHA routine job
* Fix broken URL in README.md (shinylive Python docs link)
* Add class= to unclassed expect_error() calls in tests
* Add assertion unit tests (27 tests)
* Fix R CMD check NOTEs: missing rlang imports, spelling wordlist, .Rbuildignore
* Run use_tidy_description()
* Update .Rbuildignore for .context and .git (worktree support)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: Remove standalone types-check, simplify assertion helpers

Remove heavy rlang standalone files (import-standalone-types-check.R,
import-standalone-obj-type.R) and replace with simple inline checks.
Remove unused rlang imports.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* `air format` (GitHub Actions)

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: schloerke <schloerke@users.noreply.github.com>

Author: schloerke

.Rbuildignore

@@ -20,3 +20,5 @@
 ^node_modules$
 ^[.]?air[.]toml$
 ^\.vscode$
+^\.context$
+^\.git$

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,126 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at codeofconduct@posit.co. 
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+<https://www.contributor-covenant.org/version/2/1/code_of_conduct.html>.
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][https://github.com/mozilla/inclusion].
+
+For answers to common questions about this code of conduct, see the FAQ at
+<https://www.contributor-covenant.org/faq>. Translations are available at <https://www.contributor-covenant.org/translations>.
+
+[homepage]: https://www.contributor-covenant.org

.github/workflows/R-CMD-check.yaml

@@ -17,6 +17,8 @@ jobs:
     uses: rstudio/shiny-workflows/.github/workflows/website.yaml@v1
   routine:
     uses: rstudio/shiny-workflows/.github/workflows/routine.yaml@v1
+    with:
+      format-r-code: true
   R-CMD-check:
     uses: rstudio/shiny-workflows/.github/workflows/R-CMD-check.yaml@v1
 

DESCRIPTION

@@ -34,10 +34,11 @@ Imports:
     glue,
     httr2 (>= 1.0.0),
     jsonlite,
+    lifecycle,
     pkgdepends,
     rappdirs,
     renv,
-    rlang,
+    rlang (>= 1.1.0),
     tools,
     whisker,
     withr
@@ -48,6 +49,7 @@ Suggests:
     testthat (>= 3.0.0)
 Config/Needs/website: tidyverse/tidytemplate
 Config/testthat/edition: 3
+Config/usethis/last-upkeep: 2026-03-30
 Encoding: UTF-8
 Language: en-US
 Roxygen: list(markdown = TRUE)

NAMESPACE

@@ -9,5 +9,6 @@ export(assets_install_link)
 export(assets_remove)
 export(assets_version)
 export(export)
+importFrom(lifecycle,deprecated)
 importFrom(rlang,"%||%")
 importFrom(rlang,is_interactive)

R/app_json.R

@@ -13,10 +13,8 @@ file_content_obj <- function(name, content, type = c("text", "binary")) {
 
 APP_INFO_CLASS <- "shinylive_app_info"
 app_info_obj <- function(appdir, subdir, files) {
-  stopifnot(inherits(files, "list"))
-  lapply(files, function(file) {
-    stopifnot(inherits(file, FILE_CONTENT_CLASS))
-  })
+  assert_list(files, arg = "files")
+  assert_list_items(files, FILE_CONTENT_CLASS, arg = "files")
   structure(
     list(
       appdir = appdir,
@@ -66,7 +64,11 @@ read_app_files <- function(
   }
 
   inspect_dir <- function(curdur) {
-    stopifnot(fs::is_dir(curdur))
+    if (!fs::is_dir(curdur)) {
+      cli::cli_abort(
+        "{.arg curdur} must be an existing directory: {.path {curdur}}"
+      )
+    }
 
     # Check for excluded dirs
     curdur_basename <- basename(curdur)
@@ -161,9 +163,15 @@ write_app_json <- function(
 ) {
   local_quiet(quiet)
 
-  stopifnot(inherits(app_info, APP_INFO_CLASS))
+  if (!inherits(app_info, APP_INFO_CLASS)) {
+    cli::cli_abort("{.arg app_info} must be a {.cls {APP_INFO_CLASS}} object.")
+  }
   # stopifnot(fs::dir_exists(destdir))
-  stopifnot(fs::dir_exists(template_dir))
+  if (!fs::dir_exists(template_dir)) {
+    cli::cli_abort(
+      "{.arg template_dir} must be an existing directory: {.path {template_dir}}"
+    )
+  }
 
   app_destdir <- fs::path(destdir, app_info$subdir)
 

R/assets.R

@@ -96,7 +96,7 @@ assets_dir_impl <- function(
   dir = assets_cache_dir(),
   version = assets_version()
 ) {
-  stopifnot(length(list(...)) == 0)
+  rlang::check_dots_empty()
   fs::path(dir, paste0(shinylive_prefix, version))
 }
 
@@ -108,8 +108,12 @@ install_local_helper <- function(
   dir = assets_cache_dir(),
   version = package_json_version(assets_repo_dir)
 ) {
-  stopifnot(length(list(...)) == 0)
-  stopifnot(fs::dir_exists(assets_repo_dir))
+  rlang::check_dots_empty()
+  if (!fs::dir_exists(assets_repo_dir)) {
+    cli::cli_abort(
+      "Assets repo directory does not exist: {.path {assets_repo_dir}}"
+    )
+  }
   repo_build_dir <- fs::path(assets_repo_dir, "build")
   if (!fs::dir_exists(repo_build_dir)) {
     cli::cli_abort(c(
@@ -208,7 +212,7 @@ assets_ensure <- function(
   dir = assets_cache_dir(),
   url = assets_bundle_url(version)
 ) {
-  stopifnot(length(list(...)) == 0)
+  rlang::check_dots_empty()
   if (!fs::dir_exists(dir)) {
     cli_alert_info("Creating assets cache directory ", dir)
     fs::dir_create(dir)
@@ -241,7 +245,7 @@ assets_cleanup <- function(
   ...,
   dir = assets_cache_dir()
 ) {
-  stopifnot(length(list(...)) == 0)
+  rlang::check_dots_empty()
   versions <- vapply(
     assets_dirs(dir = dir),
     function(ver_path) {
@@ -283,8 +287,10 @@ assets_remove <- function(
   ...,
   dir = assets_cache_dir()
 ) {
-  stopifnot(length(list(...)) == 0)
-  stopifnot(length(versions) > 0 && is.character(versions))
+  rlang::check_dots_empty()
+  if (!is.character(versions) || length(versions) == 0) {
+    cli::cli_abort("{.arg versions} must be a non-empty character vector.")
+  }
 
   lapply(versions, function(version) {
     target_dir <- assets_dir_impl(dir = dir, version = version)
@@ -304,7 +310,7 @@ assets_dirs <- function(
   ...,
   dir = assets_cache_dir()
 ) {
-  stopifnot(length(list(...)) == 0)
+  rlang::check_dots_empty()
   if (!fs::dir_exists(dir)) {
     return(character(0))
   }

R/deps.R

@@ -5,7 +5,7 @@ html_dep_obj <- function(
   path,
   attribs = NULL
 ) {
-  stopifnot(length(list(...)) == 0)
+  rlang::check_dots_empty()
   assert_nzchar_string(name)
   assert_nzchar_string(path)
   is.null(attribs) || assert_list(attribs)
@@ -28,7 +28,7 @@ html_dep_serviceworker_obj <- function(
   source,
   destination
 ) {
-  stopifnot(length(list(...)) == 0)
+  rlang::check_dots_empty()
   assert_nzchar_string(source)
   assert_nzchar_string(destination)
   structure(
@@ -52,7 +52,7 @@ quarto_html_dependency_obj <- function(
   head = NULL,
   serviceworkers = NULL
 ) {
-  stopifnot(length(list(...)) == 0)
+  rlang::check_dots_empty()
   assert_nzchar_string(name)
   is.null(version) || assert_nzchar_string(version)
   is.null(scripts) || assert_list_items(scripts, HTML_DEP_ITEM_CLASS)

R/export.R

@@ -9,7 +9,7 @@
 #' @param quiet Suppress console output during export. Follows the global
 #'   `shinylive.quiet` option or defaults to `FALSE` in interactive sessions if
 #'   not set.
-#' @param verbose Deprecated, please use `quiet` instead.
+#' @param verbose `r lifecycle::badge('deprecated')` Use `quiet` instead.
 #' @param wasm_packages Download and include binary WebAssembly packages as part
 #'   of the output app's static assets. Logical, defaults to `TRUE`. The default
 #'   value can be changed by setting the environment variable
@@ -70,12 +70,10 @@ export <- function(
   assets_version = NULL,
   template_dir = NULL,
   template_params = list(),
-  verbose = NULL
+  verbose = deprecated()
 ) {
-  if (!is.null(verbose)) {
-    rlang::warn(
-      "The {.var verbose} argument is deprecated. Use {.var quiet} instead."
-    )
+  if (!missing(verbose)) {
+    lifecycle::deprecate_warn("0.2.0", "export(verbose)", "export(quiet)")
     if (missing(quiet)) {
       quiet <- !verbose
     }

R/quarto_ext.R

@@ -115,9 +115,11 @@ quarto_ext <- function(
   pretty = is_interactive(),
   con = "stdin"
 ) {
-  stopifnot(length(list(...)) == 0)
+  rlang::check_dots_empty()
   # This method should not print anything to stdout. Instead, it should return a JSON string that will be printed by the extension.
-  stopifnot(length(args) >= 1)
+  if (length(args) < 1) {
+    cli::cli_abort("{.arg args} must have at least one element.")
+  }
 
   followup_statement <- function() {
     c(
@@ -180,7 +182,6 @@ quarto_ext <- function(
       followup_statement()
     ))
   }
-  stopifnot(length(args) >= 2)
 
   ret <- switch(
     args[2],
@@ -197,11 +198,11 @@ quarto_ext <- function(
       sw_dir_pos <- which(args == "--sw-dir")
       if (length(sw_dir_pos) == 1) {
         if (sw_dir_pos == length(args)) {
-          stop("expected `--sw-dir` argument value")
+          cli::cli_abort("Expected {.arg --sw-dir} argument value.")
         }
         sw_dir <- args[sw_dir_pos + 1]
       } else {
-        stop("expected `--sw-dir` argument")
+        cli::cli_abort("Expected {.arg --sw-dir} argument.")
       }
       # Language agnostic files
       shinylive_base_deps_htmldep(sw_dir)
@@ -215,7 +216,7 @@ quarto_ext <- function(
       build_app_resources(app_json)
     },
     {
-      stop("Not implemented `extension` type: ", args[2])
+      cli::cli_abort("Not implemented {.arg extension} type: {.val {args[2]}}.")
     }
   )
   ret_null_free <- drop_nulls_rec(ret)