fix: address review round 3 for #7

DESCRIPTION

@@ -1,7 +1,7 @@
 Package: civilytics
 Type: Package
 Title: Brand Themes, Color Palettes, and Utility Functions for Civilytics
-Version: 0.3.1
+Version: 0.2.0
 Authors@R:
     person("Jared", "E. Knowles", email = "jared@civilytics.com",
            role = c("aut", "cre"))
@@ -31,10 +31,7 @@ Encoding: UTF-8
 Suggests:
     testthat (>= 3.0.0),
     tidycensus,
-    quarto,
+    quarto
-    flextable,
-    officer,
-    ragg
 Config/testthat/edition: 3
 Config/roxygen2/version: 8.0.0
 RoxygenNote: 7.3.3

NAMESPACE

@@ -39,13 +39,11 @@ export(rnh)
 export(round_to_nearest_half)
 export(safe_max)
 export(safe_ratio)
-export(save_branded_flextable_png)
 export(scale_color_civilytics)
 export(scale_fill_civilytics)
 export(simpleCap)
 export(stamp_logo_png)
 export(star_subs)
-export(style_flextable_civilytics)
 export(theme_civilytics)
 export(theme_civilytics_dark)
 export(theme_civilytics_dark_map)

R/db.R

@@ -111,7 +111,9 @@ nvals <- function(x){
 #' simpleCap(my_string)
 simpleCap <- function(x) {
   stopifnot(class(x) == "character")
-  s <- strsplit(x, " ")[[1]]
+  sapply(x, function(word) {
-  paste(toupper(substring(s, 1,1)), substring(s, 2),
+    s <- strsplit(word, " ")[[1]]
+    paste(toupper(substring(s, 1, 1)), substring(s, 2),
           sep = "", collapse = " ")
+  })
 }

R/flextable.R

@@ -1,175 +0,0 @@
-#' Apply the Civilytics brand styling to a flextable
-#'
-#' Applies *only* the visual Civilytics brand to an already-structured
-#' [flextable::flextable()] — header fill and color, body font and size,
-#' zebra striping, borders, footer styling, and a fixed table layout. The
-#' caller remains responsible for table *structure*: labels
-#' ([flextable::set_header_labels()]), header/title lines
-#' ([flextable::add_header_lines()]), column widths ([flextable::width()]),
-#' alignment ([flextable::align()]), and footer text
-#' ([flextable::add_footer_lines()]). This separation keeps styling reusable
-#' across projects while leaving content decisions where they belong.
-#'
-#' `flextable`, `officer`, and `ragg` are Suggested (not Imported) to keep the
-#' base install light, so this function errors with an install hint if
-#' `flextable` is unavailable.
-#'
-#' @param ft A [flextable::flextable()] object.
-#' @param header_bg Character. Header background fill. Default `"#2c3e50"`.
-#' @param header_color Character. Header text color. Default `"white"`.
-#' @param title_fontsize Numeric. Font size for the first header line (the
-#'   title row, `i = 1`). Default `14`.
-#' @param body_fontsize Numeric. Body font size. Default `11`.
-#' @param font_name Character. Font family applied to all parts. Default
-#'   `"Arial"`.
-#' @param zebra Logical. Apply alternating-row striping to even body rows.
-#'   Default `TRUE`. Safely skipped for tables with fewer than two body rows.
-#' @param zebra_bg Character. Fill color for striped (even) body rows.
-#'   Default `"#f0f0eb"`.
-#' @param outer_border_color Character. Outer border color. Default
-#'   `"#888888"`.
-#' @param outer_border_width Numeric. Outer border width. Default `1`.
-#' @param inner_border_color Character. Inner horizontal border color (body).
-#'   Default `"#cccccc"`.
-#' @param inner_border_width Numeric. Inner horizontal border width. Default
-#'   `0.5`.
-#' @param footer_fontsize Numeric. Footer font size (applied only if a footer
-#'   part exists). Default `9`.
-#' @param footer_color Character. Footer text color. Default `"#555555"`.
-#'
-#' @return The styled [flextable::flextable()] object.
-#' @export
-#' @seealso [save_branded_flextable_png()] to export the styled table to a
-#'   logo-stamped PNG.
-#' @examples
-#' \dontrun{
-#' library(flextable)
-#' ft <- flextable(head(mtcars)) |>
-#'   add_header_lines("Motor Trend Cars") |>
-#'   add_footer_lines("Source: mtcars") |>
-#'   style_flextable_civilytics()
-#' }
-style_flextable_civilytics <- function(ft,
-                                       header_bg = "#2c3e50",
-                                       header_color = "white",
-                                       title_fontsize = 14,
-                                       body_fontsize = 11,
-                                       font_name = "Arial",
-                                       zebra = TRUE,
-                                       zebra_bg = "#f0f0eb",
-                                       outer_border_color = "#888888",
-                                       outer_border_width = 1,
-                                       inner_border_color = "#cccccc",
-                                       inner_border_width = 0.5,
-                                       footer_fontsize = 9,
-                                       footer_color = "#555555") {
-  if (!requireNamespace("flextable", quietly = TRUE)) {
-    stop("Install 'flextable' to use this function.", call. = FALSE)
-  }
-  if (!requireNamespace("officer", quietly = TRUE)) {
-    stop("Install 'officer' to use this function.", call. = FALSE)
-  }
-
-  # Header: navy fill, white bold text, larger title line.
-  ft <- flextable::bg(ft, bg = header_bg, part = "header")
-  ft <- flextable::color(ft, color = header_color, part = "header")
-  ft <- flextable::bold(ft, part = "header")
-  ft <- flextable::fontsize(ft, i = 1, size = title_fontsize, part = "header")
-
-  # Body: readable size, brand font across all parts.
-  ft <- flextable::fontsize(ft, size = body_fontsize, part = "body")
-  ft <- flextable::font(ft, fontname = font_name, part = "all")
-
-  # Zebra striping on even body rows, guarded for tables with < 2 rows.
-  nrow_body <- flextable::nrow_part(ft, part = "body")
-  if (zebra && nrow_body >= 2) {
-    ft <- flextable::bg(ft, i = seq(2, nrow_body, 2), bg = zebra_bg,
-                        part = "body")
-  }
-
-  # Borders: outer frame on all parts, light horizontal rules in the body.
-  ft <- flextable::border_outer(
-    ft,
-    border = officer::fp_border(color = outer_border_color,
-                                width = outer_border_width),
-    part = "all"
-  )
-  ft <- flextable::border_inner_h(
-    ft,
-    border = officer::fp_border(color = inner_border_color,
-                                width = inner_border_width),
-    part = "body"
-  )
-
-  # Footer styling — only if the table actually has a footer part.
-  if (flextable::nrow_part(ft, part = "footer") > 0) {
-    ft <- flextable::fontsize(ft, size = footer_fontsize, part = "footer")
-    ft <- flextable::color(ft, color = footer_color, part = "footer")
-  }
-
-  flextable::set_table_properties(ft, layout = "fixed")
-}
-
-
-#' Save a branded flextable to a logo-stamped PNG
-#'
-#' Exports a styled [flextable::flextable()] to a PNG via
-#' [ragg::agg_png()] (sized to the table's own dimensions plus a little
-#' headroom for the logo), then optionally stamps the Civilytics logo onto the
-#' file with [stamp_logo_png()] so file-based tables stay visually consistent
-#' with [civilytics_logo()]-branded plots.
-#'
-#' `ragg` and `flextable` are Suggested (not Imported); this function errors
-#' with an install hint if either is unavailable.
-#'
-#' @param ft A [flextable::flextable()] object, typically already styled with
-#'   [style_flextable_civilytics()].
-#' @param path Character. Output PNG path. Returned invisibly.
-#' @param logo Logical. Stamp the Civilytics logo onto the saved PNG via
-#'   [stamp_logo_png()]. Default `TRUE`.
-#' @param res Numeric. Output resolution in PPI passed to [ragg::agg_png()].
-#'   Default `300`.
-#' @param extra_height Numeric. Additional height in inches added to the
-#'   table's natural height to leave room for the stamped logo. Default `0.4`.
-#' @param ... Additional arguments forwarded to [stamp_logo_png()] (e.g.
-#'   `type`, `variant`, `position`, `width_frac`, `margin_frac`).
-#'
-#' @return `path`, invisibly.
-#' @export
-#' @seealso [style_flextable_civilytics()] to apply the brand styling, and
-#'   [stamp_logo_png()] for the underlying logo compositing.
-#' @examples
-#' \dontrun{
-#' library(flextable)
-#' ft <- flextable(head(mtcars)) |>
-#'   add_footer_lines("Source: mtcars") |>
-#'   style_flextable_civilytics()
-#' save_branded_flextable_png(ft, "table.png")
-#' save_branded_flextable_png(ft, "table.png", position = "bottom-left")
-#' knitr::include_graphics("table.png")
-#' }
-save_branded_flextable_png <- function(ft, path, logo = TRUE, res = 300,
-                                       extra_height = 0.4, ...) {
-  if (!requireNamespace("flextable", quietly = TRUE)) {
-    stop("Install 'flextable' to use this function.", call. = FALSE)
-  }
-  if (!requireNamespace("ragg", quietly = TRUE)) {
-    stop("Install 'ragg' to use this function.", call. = FALSE)
-  }
-
-  d <- flextable::flextable_dim(ft)
-  ragg::agg_png(path, width = d$width, height = d$height + extra_height,
-                units = "in", res = res)
-  on.exit(grDevices::dev.off(), add = TRUE)
-  plot(ft)
-
-  if (logo) {
-    # dev.off() must run before stamp_logo_png() re-reads the file. Flush the
-    # device now and clear the on.exit handler so it does not fire twice.
-    grDevices::dev.off()
-    on.exit()
-    stamp_logo_png(path, ...)
-  }
-
-  invisible(path)
-}

R/fonts.R

@@ -5,45 +5,32 @@ CV_FONT_SANS    <- "Inter"           # axis text, legends, UI elements
 CV_FONT_SERIF   <- "Source Serif 4"  # body prose / editorial long-form
 CV_FONT_MONO    <- "JetBrains Mono"  # code, data tables, numeric callouts
 
-# Mutable package state held in an environment so the binding itself stays
+# Internal flag so civilytics_load_fonts() is idempotent within a session.
-# locked (R locks all namespace bindings at load time) while the contents
+.cv_fonts_loaded <- FALSE
-# remain writable. See https://adv-r.hadley.nz/environments.html#environments-as-containers
-.cv_state <- new.env(parent = emptyenv())
-.cv_state$fonts_loaded <- FALSE
 
 #' Load Civilytics brand fonts
 #'
-#' Downloads Inter, Libre Franklin, Source Serif 4 and JetBrains Mono from
+#' Downloads Inter and Libre Franklin from Google Fonts via
-#' Google Fonts via [sysfonts::font_add_google()], then calls
+#' [sysfonts::font_add_google()], then calls [showtext::showtext_auto()] so
-#' [showtext::showtext_auto()] so that all graphics devices render text with
+#' that all graphics devices render text with those fonts. This is called
-#' those fonts. This is called automatically when the package loads; use this
+#' automatically when the package loads; use this function to retry if the
-#' function to retry if the initial load failed (e.g., the machine was offline
+#' initial load failed (e.g., the machine was offline at load time).
-#' at load time).
 #'
-#' Subsequent calls within the same session are no-ops unless `force = TRUE`.
+#' @return Invisibly returns `NULL`.
-#'
-#' @param force Logical. If `TRUE`, reload fonts even if they were already
-#'   loaded in this session. Default `FALSE`.
-#'
-#' @return Invisibly returns `TRUE` if fonts were loaded, `FALSE` if skipped
-#'   (already loaded and `force = FALSE`).
 #' @export
 #'
 #' @examples
 #' \dontrun{
 #' civilytics_load_fonts()
 #' }
-civilytics_load_fonts <- function(force = FALSE) {
+civilytics_load_fonts <- function() {
-  if (.cv_state$fonts_loaded && !force) return(invisible(FALSE))
-
   sysfonts::font_add_google("Inter",          family = "Inter")
   sysfonts::font_add_google("Libre Franklin", family = "Libre Franklin")
   sysfonts::font_add_google("Source Serif 4", family = "Source Serif 4")
   sysfonts::font_add_google("JetBrains Mono", family = "JetBrains Mono")
   showtext::showtext_auto()
-
+  .cv_fonts_loaded <<- TRUE
-  .cv_state$fonts_loaded <- TRUE
+  invisible(NULL)
-  invisible(TRUE)
 }
 
 .onLoad <- function(libname, pkgname) {

R/quarto.R

@@ -135,12 +135,12 @@ use_civilytics_theme <- function(path = ".", force = FALSE) {
     .copy_pkg_file(file.path("quarto/latex", f), file.path("latex", f), path, force)
   }
 
-  # Typst — shipped as template-partials so Quarto keeps its Skylighting
+  # Typst
-  # definitions and syntax-highlighted code blocks render (see issue #12)
+  .copy_pkg_file(
-  typst_files <- c("typst-template.typ", "typst-show.typ")
+    "quarto/typst/civilytics-typst.typ",
-  for (f in typst_files) {
+    "typst/civilytics-typst.typ",
-    .copy_pkg_file(file.path("quarto/typst", f), file.path("typst", f), path, force)
+    path, force
-  }
+  )
 
   # Logos — for _brand.yml (expects assets/logo/)
   .copy_logos("assets/logo", path, force)
@@ -158,9 +158,7 @@ use_civilytics_theme <- function(path = ".", force = FALSE) {
   message("    include-in-header: latex/civilytics.tex")
   message("    include-before-body: latex/civilytics-title.tex")
   message("  typst:")
-  message("    template-partials:")
+  message("    template: typst/civilytics-typst.typ")
-  message("      - typst/typst-template.typ")
-  message("      - typst/typst-show.typ")
   message("---")
   message("\nSee examples/report.qmd for a complete example.")
   invisible(NULL)

R/theme.R

@@ -36,12 +36,9 @@
 #'   to [civilytics_colors]`["paper_2"]` (`#F2EDE4`).
 #' @param grid Character. Which major gridlines to draw: `"y"` (default,
 #'   horizontal only), `"x"` (vertical only), `"both"`, or `"none"`.
-#' @param paper_bg Logical. If `TRUE`, fill the plot and panel backgrounds
+#' @param paper_bg Logical. If `FALSE` (default), the plot and panel
-#'   with the warm `paper` color (Civilytics cream). Default is `FALSE`
+#'   backgrounds are transparent (`fill = NA`). Set to `TRUE` to fill them
-#'   (transparent) so that figures composite cleanly onto any background.
+#'   with the warm `paper` color (the Civilytics cream canvas).
-#'   Set to `TRUE` for the branded cream canvas. Note: a transparent device
-#'   background (e.g., `dev = "ragg_png"`, `dev.args = list(background =
-#'   "transparent")`) is also needed for fully-transparent PNG exports.
 #'
 #' @section Font size hierarchy:
 #' All text sizes are derived from `font_size` using relative scale factors.
@@ -70,26 +67,29 @@
 #' \dontrun{
 #' library(ggplot2)
 #'
-#' # Default — transparent background for embedding
+#' # Transparent background (default) — composites cleanly onto any surface
 #' ggplot(mpg, aes(displ, hwy)) +
 #'   geom_point() +
 #'   theme_civilytics()
 #'
+#' # Warm paper canvas (opt-in)
+#' ggplot(mpg, aes(displ, hwy)) +
+#'   geom_point() +
+#'   theme_civilytics(paper_bg = TRUE)
+#'
 #' # With both gridlines and brand colors
 #' ggplot(mpg, aes(displ, hwy, colour = class)) +
 #'   geom_point() +
 #'   scale_color_civilytics() +
 #'   theme_civilytics(grid = "both")
 #'
-#' # Branded cream background (opt-in)
-#' ggplot(mpg, aes(displ, hwy)) +
-#'   geom_point() +
-#'   theme_civilytics(paper_bg = TRUE)
-#'
 #' # Larger text for poster or display
 #' ggplot(mpg, aes(displ, hwy)) +
 #'   geom_point() +
 #'   theme_civilytics(font_size = 18)
+#'
+#' # Note: for fully-transparent PNGs, also set a transparent device
+#' # background (e.g. `ggsave("plot.png", bg = NA)`).
 #' }
 theme_civilytics <- function(
     font_size    = 14,

R/utils.R

@@ -31,7 +31,7 @@ safe_max <- function(x) {
 #' pretty_per(0.2, ndigit = 1)
 #' pretty_per(c(0.2, 0.332423, 0.4, 0.342342), ndigit = 2)
 pretty_per <- function(x, ndigit = 1) {
-  if (any(x >= 100) & !all(is.na(x))) {
+  if (any(x >= 100) && !all(is.na(x))) {
     message("Values over 100 found, did you mean to use proportions?")
   }
   x <- format(round(x, digits = ndigit + 2) * 100, nsmall = ndigit)
@@ -283,7 +283,7 @@ get_stabbr <- function(fips) {
   fips_codes <- fips_codes[!duplicated(fips_codes),]
   if (length(fips) != 1) {
     out <- rep(NA, length(fips))
-    for (i in length(fips)) {
+    for (i in seq_along(fips)) {
       out[i] <- fips_codes[fips_codes$state_code == fips, 1]
 
     }
@@ -375,7 +375,7 @@ random_round <- function(x) {
   add = rep(as.integer(0),length(r))
   add[r>test] <- as.integer(1)
   value = v + add
-  ifelse(is.na(value) | value<0, 0, value)
+  value <- ifelse(is.na(value) | value < 0, 0, value)
   return(value)
 }
 

inst/quarto/examples/report.qmd

@@ -2,7 +2,7 @@
 title: "Who pays when rent outpaces wages?"
 subtitle: "A 12-county analysis of cost-burdened renter households, 2019–2024."
 author:
-  - name: "Jared Knowles"
+  - name: "Civilytics Research"
     affiliation: "Civilytics Consulting"
 date: "2026-04-15"
 abstract: |
@@ -19,9 +19,7 @@ format:
     toc: true
     toc-location: right
   typst:
-    template-partials:
+    template: ../typst/civilytics-typst.typ
-      - ../typst/typst-template.typ
-      - ../typst/typst-show.typ
   pdf:
     include-in-header: ../latex/civilytics.tex
     include-before-body: ../latex/civilytics-title.tex

inst/quarto/examples/slides.qmd

@@ -55,11 +55,11 @@ Big idea goes here.
 
 > Rent has outpaced wages in every county we studied.
 
-Civilytics Consulting, 2026
+Civilytics Research, 2026
 
 ## Thank you {.thank-you}
 
 Questions?
 
 - jared@civilytics.com
-- civilytics.com
+- civilytics.consulting

inst/quarto/latex/civilytics-title.tex

@@ -2,16 +2,11 @@
 % Replaces Quarto's default \maketitle. Uses values from YAML
 % (\thetitle, \theauthor, \thedate) plus an \ifabstract block.
 
-% Guard: \thesubtitle is normally defined by civilytics.tex's subtitle
-% capture; provide a fallback so this partial degrades gracefully if used
-% without that preamble. See civilyticsR issue #13.
-\providecommand{\thesubtitle}{}
-
 \begin{titlepage}
   \pagecolor{paper}
   \color{ink}
   \vspace*{0.5in}
-  {\sffamily\bfseries\scriptsize\color{ember}\MakeUppercase{— Civilytics Consulting}\par}
+  {\sffamily\bfseries\scriptsize\color{ember}\MakeUppercase{— Civilytics Research}\par}
   \vspace{12pt}
   {\displayfont\fontsize{32pt}{34pt}\selectfont\bfseries\color{ink}\thetitle\par}
   \vspace{8pt}
@@ -38,6 +33,8 @@
 
   % Pulse mark, in ember
   \begin{center}
+    \begin{tikzpicture}[overlay, remember picture]
+    \end{tikzpicture}
     {\color{ember}\rule{40pt}{2pt}}
   \end{center}
 \end{titlepage}

inst/quarto/latex/civilytics.tex

@@ -40,40 +40,17 @@
 \color{ink}
 
 % --- Fonts (require local install or fontspec lookup) ---
-% Bold uses the family's native Bold weight (present in every Source Serif 4
-% install). Do NOT hard-require a "SemiBold" face: the package installs no
-% system fonts for the PDF path, and standard Source Serif 4 ships only
-% Regular/Bold/Italic/BoldItalic. See civilyticsR issue #14.
 \setmainfont{Source Serif 4}[
   UprightFont = *,
   ItalicFont = * Italic,
+  BoldFont = * SemiBold,
+  BoldItalicFont = * SemiBold Italic,
   Ligatures = TeX,
 ]
 \setsansfont{Inter}[Ligatures = TeX]
 \setmonofont{JetBrains Mono}[Scale = 0.92]
 \newfontfamily\displayfont{Libre Franklin}[Ligatures = TeX]
 
-% --- Subtitle capture ---
-% Quarto/pandoc defines \subtitle (which appends to \@title) but never
-% \thesubtitle, which the title page uses. This preamble is emitted before
-% pandoc's \providecommand{\subtitle}, so our definition wins: capture the
-% subtitle into \thesubtitle instead. See civilyticsR issue #13.
-\makeatletter
-\providecommand{\thesubtitle}{}
-\def\subtitle#1{\renewcommand{\thesubtitle}{#1}}
-\makeatother
-
-% --- Use the Civilytics title page, not pandoc's default ---
-% civilytics-title.tex (include-before-body) IS the title page. Quarto emits
-% its default \maketitle + abstract *before* include-before-body, which would
-% print a second, unstyled title. Neutralise both here, in the preamble
-% (runs at \begin{document}, before the default title). The branded title page
-% does not display the abstract. See civilyticsR issue #13.
-\AtBeginDocument{%
-  \renewcommand{\maketitle}{}%
-  \renewenvironment{abstract}{\setbox0=\vbox\bgroup}{\egroup}%
-}
-
 % --- Hyperlinks ---
 \hypersetup{
   colorlinks = true,
@@ -100,7 +77,7 @@
 \renewcommand{\footrulewidth}{0pt}
 \fancyhead[L]{\sffamily\scriptsize\color{ink3}\MakeUppercase{Civilytics Consulting}}
 \fancyhead[R]{\sffamily\scriptsize\color{ink3}\thetitle}
-\fancyfoot[L]{\sffamily\scriptsize\color{ink3}civilytics.com}
+\fancyfoot[L]{\sffamily\scriptsize\color{ink3}civilytics.consulting}
 \fancyfoot[C]{\sffamily\scriptsize\color{ink3}\thepage}
 \fancyfoot[R]{\sffamily\scriptsize\color{ink3}\textcopyright\ 2026}
 

inst/quarto/typst/civilytics-typst.typ

@@ -1,15 +1,9 @@
 // =============================================================
-// Civilytics — Typst template partial for Quarto PDF (typst-template.typ).
+// Civilytics — Typst template for Quarto PDF
-// Shipped as a Quarto template-partial (paired with typst-show.typ) rather
-// than a full `template:` so Quarto keeps its own `definitions` partial —
-// which defines Skylighting/token functions needed for syntax-highlighted
-// code blocks. See civilyticsR issue #12.
 // Usage in YAML:
 //   format:
 //     typst:
-//       template-partials:
+//       template: quarto/typst/civilytics-typst.typ
-//         - quarto/typst/typst-template.typ
-//         - quarto/typst/typst-show.typ
 // =============================================================
 
 #let paper-bg   = rgb("#FAF7F2")
@@ -60,7 +54,7 @@
       grid(
         columns: (1fr, auto, 1fr),
         align: (left, center, right),
-        [civilytics.com],
+        [civilytics.consulting],
         counter(page).display("1 / 1", both: true),
         [© 2026]
       )
@@ -164,7 +158,7 @@
   if title != none {
     block[
       #set text(font: sans-stack, size: 8pt, weight: 600, fill: ember, tracking: 0.1em)
-      #upper[— Civilytics Consulting]
+      #upper[— Civilytics Research]
     ]
     v(8pt)
     block[
@@ -235,3 +229,16 @@
 
   doc
 }
+
+// Quarto entry point
+#show: doc => civilytics(
+  title: $title$,
+  $if(subtitle)$subtitle: $subtitle$,$endif$
+  $if(by-author)$authors: ($for(by-author)$"$it.name.literal$",$endfor$),$endif$
+  $if(date)$date: $date$,$endif$
+  $if(abstract)$abstract: [$abstract$],$endif$
+  toc: $if(toc)$true$else$false$endif$,
+  doc
+)
+
+$body$

inst/quarto/typst/typst-show.typ

@@ -1,17 +0,0 @@
-// Civilytics — Typst show/entry partial for Quarto (typst-show.typ).
-// Pairs with typst-template.typ. Quarto appends the rendered document body
-// after this partial, so this file intentionally ends with the show rule and
-// no trailing body token. (Do not write that token in a comment here: Quarto
-// interpolates its template variables even inside comments.)
-// Title/subtitle/date are wrapped in [ ] so arbitrary text (including words
-// that are Typst keywords like "for"/"in") is treated as content, not code.
-// See civilyticsR issue #12.
-#show: doc => civilytics(
-  title: [$title$],
-  $if(subtitle)$subtitle: [$subtitle$],$endif$
-  $if(by-author)$authors: ($for(by-author)$"$it.name.literal$",$endfor$),$endif$
-  $if(date)$date: [$date$],$endif$
-  $if(abstract)$abstract: [$abstract$],$endif$
-  toc: $if(toc)$true$else$false$endif$,
-  doc
-)

man/civilytics_load_fonts.Rd

@@ -4,25 +4,17 @@
 \alias{civilytics_load_fonts}
 \title{Load Civilytics brand fonts}
 \usage{
-civilytics_load_fonts(force = FALSE)
+civilytics_load_fonts()
-}
-\arguments{
-\item{force}{Logical. If \code{TRUE}, reload fonts even if they were already
-loaded in this session. Default \code{FALSE}.}
 }
 \value{
-Invisibly returns \code{TRUE} if fonts were loaded, \code{FALSE} if skipped
+Invisibly returns `NULL`.
-(already loaded and \code{force = FALSE}).
 }
 \description{
-Downloads Inter, Libre Franklin, Source Serif 4 and JetBrains Mono from
+Downloads Inter and Libre Franklin from Google Fonts via
-Google Fonts via \code{sysfonts::font_add_google()}, then calls
+[sysfonts::font_add_google()], then calls [showtext::showtext_auto()] so
-\code{showtext::showtext_auto()} so that all graphics devices render text with
+that all graphics devices render text with those fonts. This is called
-those fonts. This is called automatically when the package loads; use this
+automatically when the package loads; use this function to retry if the
-function to retry if the initial load failed (e.g., the machine was offline
+initial load failed (e.g., the machine was offline at load time).
-at load time).
-
-Subsequent calls within the same session are no-ops unless \code{force = TRUE}.
 }
 \examples{
 \dontrun{

man/save_branded_flextable_png.Rd

@@ -1,62 +0,0 @@
-% Generated by roxygen2: do not edit by hand
-% Please edit documentation in R/flextable.R
-\name{save_branded_flextable_png}
-\alias{save_branded_flextable_png}
-\title{Save a branded flextable to a logo-stamped PNG}
-\usage{
-save_branded_flextable_png(
-  ft,
-  path,
-  logo = TRUE,
-  res = 300,
-  extra_height = 0.4,
-  ...
-)
-}
-\arguments{
-\item{ft}{A [flextable::flextable()] object, typically already styled with
-[style_flextable_civilytics()].}
-
-\item{path}{Character. Output PNG path. Returned invisibly.}
-
-\item{logo}{Logical. Stamp the Civilytics logo onto the saved PNG via
-[stamp_logo_png()]. Default `TRUE`.}
-
-\item{res}{Numeric. Output resolution in PPI passed to [ragg::agg_png()].
-Default `300`.}
-
-\item{extra_height}{Numeric. Additional height in inches added to the
-table's natural height to leave room for the stamped logo. Default `0.4`.}
-
-\item{...}{Additional arguments forwarded to [stamp_logo_png()] (e.g.
-`type`, `variant`, `position`, `width_frac`, `margin_frac`).}
-}
-\value{
-`path`, invisibly.
-}
-\description{
-Exports a styled [flextable::flextable()] to a PNG via
-[ragg::agg_png()] (sized to the table's own dimensions plus a little
-headroom for the logo), then optionally stamps the Civilytics logo onto the
-file with [stamp_logo_png()] so file-based tables stay visually consistent
-with [civilytics_logo()]-branded plots.
-}
-\details{
-`ragg` and `flextable` are Suggested (not Imported); this function errors
-with an install hint if either is unavailable.
-}
-\examples{
-\dontrun{
-library(flextable)
-ft <- flextable(head(mtcars)) |>
-  add_footer_lines("Source: mtcars") |>
-  style_flextable_civilytics()
-save_branded_flextable_png(ft, "table.png")
-save_branded_flextable_png(ft, "table.png", position = "bottom-left")
-knitr::include_graphics("table.png")
-}
-}
-\seealso{
-[style_flextable_civilytics()] to apply the brand styling, and
-  [stamp_logo_png()] for the underlying logo compositing.
-}

man/style_flextable_civilytics.Rd

@@ -1,92 +0,0 @@
-% Generated by roxygen2: do not edit by hand
-% Please edit documentation in R/flextable.R
-\name{style_flextable_civilytics}
-\alias{style_flextable_civilytics}
-\title{Apply the Civilytics brand styling to a flextable}
-\usage{
-style_flextable_civilytics(
-  ft,
-  header_bg = "#2c3e50",
-  header_color = "white",
-  title_fontsize = 14,
-  body_fontsize = 11,
-  font_name = "Arial",
-  zebra = TRUE,
-  zebra_bg = "#f0f0eb",
-  outer_border_color = "#888888",
-  outer_border_width = 1,
-  inner_border_color = "#cccccc",
-  inner_border_width = 0.5,
-  footer_fontsize = 9,
-  footer_color = "#555555"
-)
-}
-\arguments{
-\item{ft}{A [flextable::flextable()] object.}
-
-\item{header_bg}{Character. Header background fill. Default `"#2c3e50"`.}
-
-\item{header_color}{Character. Header text color. Default `"white"`.}
-
-\item{title_fontsize}{Numeric. Font size for the first header line (the
-title row, `i = 1`). Default `14`.}
-
-\item{body_fontsize}{Numeric. Body font size. Default `11`.}
-
-\item{font_name}{Character. Font family applied to all parts. Default
-`"Arial"`.}
-
-\item{zebra}{Logical. Apply alternating-row striping to even body rows.
-Default `TRUE`. Safely skipped for tables with fewer than two body rows.}
-
-\item{zebra_bg}{Character. Fill color for striped (even) body rows.
-Default `"#f0f0eb"`.}
-
-\item{outer_border_color}{Character. Outer border color. Default
-`"#888888"`.}
-
-\item{outer_border_width}{Numeric. Outer border width. Default `1`.}
-
-\item{inner_border_color}{Character. Inner horizontal border color (body).
-Default `"#cccccc"`.}
-
-\item{inner_border_width}{Numeric. Inner horizontal border width. Default
-`0.5`.}
-
-\item{footer_fontsize}{Numeric. Footer font size (applied only if a footer
-part exists). Default `9`.}
-
-\item{footer_color}{Character. Footer text color. Default `"#555555"`.}
-}
-\value{
-The styled [flextable::flextable()] object.
-}
-\description{
-Applies *only* the visual Civilytics brand to an already-structured
-[flextable::flextable()] — header fill and color, body font and size,
-zebra striping, borders, footer styling, and a fixed table layout. The
-caller remains responsible for table *structure*: labels
-([flextable::set_header_labels()]), header/title lines
-([flextable::add_header_lines()]), column widths ([flextable::width()]),
-alignment ([flextable::align()]), and footer text
-([flextable::add_footer_lines()]). This separation keeps styling reusable
-across projects while leaving content decisions where they belong.
-}
-\details{
-`flextable`, `officer`, and `ragg` are Suggested (not Imported) to keep the
-base install light, so this function errors with an install hint if
-`flextable` is unavailable.
-}
-\examples{
-\dontrun{
-library(flextable)
-ft <- flextable(head(mtcars)) |>
-  add_header_lines("Motor Trend Cars") |>
-  add_footer_lines("Source: mtcars") |>
-  style_flextable_civilytics()
-}
-}
-\seealso{
-[save_branded_flextable_png()] to export the styled table to a
-  logo-stamped PNG.
-}

man/theme_civilytics.Rd

@@ -17,7 +17,7 @@ theme_civilytics(
   accent = unname(civilytics_colors["ember_600"]),
   strip_color = unname(civilytics_colors["paper_2"]),
   grid = c("y", "x", "both", "none"),
-  paper_bg = FALSE
+  paper_bg = TRUE
 )
 }
 \arguments{
@@ -56,12 +56,10 @@ to [civilytics_colors]`["paper_2"]` (`#F2EDE4`).}
 \item{grid}{Character. Which major gridlines to draw: `"y"` (default,
 horizontal only), `"x"` (vertical only), `"both"`, or `"none"`.}
 
-\item{paper_bg}{Logical. If `TRUE`, fill the plot and panel backgrounds
+\item{paper_bg}{Logical. If `TRUE` (default), fill the plot and panel
-with the warm `paper` color (Civilytics cream). Default is `FALSE`
+backgrounds with the warm `paper` color. Set to `FALSE` for a
-(transparent) so that figures composite cleanly onto any background.
+transparent background (useful for slides or overlay on colored
-Set to `TRUE` for the branded cream canvas. Note: a transparent device
+surfaces).}
-background (e.g., `dev = "ragg_png"`, `dev.args = list(background =
-"transparent")`) is also needed for fully-transparent PNG exports.}
 }
 \value{
 A complete ggplot2 [ggplot2::theme()] object.
@@ -107,7 +105,7 @@ shrinkage.
 \dontrun{
 library(ggplot2)
 
-# Default — transparent background for embedding
+# Default editorial theme
 ggplot(mpg, aes(displ, hwy)) +
   geom_point() +
   theme_civilytics()
@@ -118,10 +116,10 @@ ggplot(mpg, aes(displ, hwy, colour = class)) +
   scale_color_civilytics() +
   theme_civilytics(grid = "both")
 
-# Branded cream background (opt-in)
+# Transparent background for embedding
 ggplot(mpg, aes(displ, hwy)) +
   geom_point() +
-  theme_civilytics(paper_bg = TRUE)
+  theme_civilytics(paper_bg = FALSE)
 
 # Larger text for poster or display
 ggplot(mpg, aes(displ, hwy)) +

man/theme_civilytics_dark.Rd

@@ -56,10 +56,10 @@ to [civilytics_colors]`["paper_2"]` (`#F2EDE4`).}
 \item{grid}{Character. Which major gridlines to draw: `"y"` (default,
 horizontal only), `"x"` (vertical only), `"both"`, or `"none"`.}
 
-\item{paper_bg}{Logical. If `TRUE`, fill the plot and panel backgrounds
+\item{paper_bg}{Logical. If `TRUE` (default), fill the plot and panel
-with the warm `paper` color (Civilytics cream). Default is `FALSE`
+backgrounds with the warm `paper` color. Set to `FALSE` for a
-(transparent) so that figures composite cleanly onto any background.
+transparent background (useful for slides or overlay on colored
-Set to `TRUE` for the branded cream canvas.}
+surfaces).}
 }
 \value{
 A complete ggplot2 [ggplot2::theme()] object.

man/theme_civilytics_dark_map.Rd

@@ -52,10 +52,10 @@ design system.}
 \item{strip_color}{Character. Hex code for facet strip background. Defaults
 to [civilytics_colors]`["paper_2"]` (`#F2EDE4`).}
 
-\item{paper_bg}{Logical. If `TRUE`, fill the plot and panel backgrounds
+\item{paper_bg}{Logical. If `TRUE` (default), fill the plot and panel
-with the warm `paper` color (Civilytics cream). Default is `FALSE`
+backgrounds with the warm `paper` color. Set to `FALSE` for a
-(transparent) so that figures composite cleanly onto any background.
+transparent background (useful for slides or overlay on colored
-Set to `TRUE` for the branded cream canvas.}
+surfaces).}
 }
 \value{
 A complete ggplot2 [ggplot2::theme()] object.

man/theme_civilytics_map.Rd

@@ -52,10 +52,10 @@ design system.}
 \item{strip_color}{Character. Hex code for facet strip background. Defaults
 to [civilytics_colors]`["paper_2"]` (`#F2EDE4`).}
 
-\item{paper_bg}{Logical. If `TRUE`, fill the plot and panel backgrounds
+\item{paper_bg}{Logical. If `TRUE` (default), fill the plot and panel
-with the warm `paper` color (Civilytics cream). Default is `FALSE`
+backgrounds with the warm `paper` color. Set to `FALSE` for a
-(transparent) so that figures composite cleanly onto any background.
+transparent background (useful for slides or overlay on colored
-Set to `TRUE` for the branded cream canvas.}
+surfaces).}
 }
 \value{
 A complete ggplot2 [ggplot2::theme()] object.

man/theme_civilytics_slide.Rd

@@ -56,10 +56,10 @@ to [civilytics_colors]`["paper_2"]` (`#F2EDE4`).}
 \item{grid}{Character. Which major gridlines to draw: `"y"` (default,
 horizontal only), `"x"` (vertical only), `"both"`, or `"none"`.}
 
-\item{paper_bg}{Logical. If `TRUE`, fill the plot and panel backgrounds
+\item{paper_bg}{Logical. If `TRUE` (default), fill the plot and panel
-with the warm `paper` color (Civilytics cream). Default is `FALSE`
+backgrounds with the warm `paper` color. Set to `FALSE` for a
-(transparent) so that figures composite cleanly onto any background.
+transparent background (useful for slides or overlay on colored
-Set to `TRUE` for the branded cream canvas.}
+surfaces).}
 }
 \value{
 A complete ggplot2 [ggplot2::theme()] object.

man/theme_civilytics_slide_map.Rd

@@ -52,10 +52,10 @@ design system.}
 \item{strip_color}{Character. Hex code for facet strip background. Defaults
 to [civilytics_colors]`["paper_2"]` (`#F2EDE4`).}
 
-\item{paper_bg}{Logical. If `TRUE`, fill the plot and panel backgrounds
+\item{paper_bg}{Logical. If `TRUE` (default), fill the plot and panel
-with the warm `paper` color (Civilytics cream). Default is `FALSE`
+backgrounds with the warm `paper` color. Set to `FALSE` for a
-(transparent) so that figures composite cleanly onto any background.
+transparent background (useful for slides or overlay on colored
-Set to `TRUE` for the branded cream canvas.}
+surfaces).}
 }
 \value{
 A complete ggplot2 [ggplot2::theme()] object.

tests/testthat/test_flextable.R

@@ -1,89 +0,0 @@
-test_that("style_flextable_civilytics returns a styled flextable", {
-  skip_if_not_installed("flextable")
-  skip_if_not_installed("officer")
-
-  ft <- flextable::flextable(head(mtcars, 4))
-  ft <- flextable::add_footer_lines(ft, "Source: mtcars")
-  styled <- style_flextable_civilytics(ft)
-
-  expect_s3_class(styled, "flextable")
-  # Fixed layout is the documented end-state of the styling.
-  expect_identical(styled$properties$layout, "fixed")
-})
-
-test_that("style_flextable_civilytics is idempotent on a 1-row table (no zebra error)", {
-  skip_if_not_installed("flextable")
-  skip_if_not_installed("officer")
-
-  ft <- flextable::flextable(head(mtcars, 1))
-  expect_no_error(once <- style_flextable_civilytics(ft))
-  # Re-styling an already-styled table must not error either.
-  expect_no_error(twice <- style_flextable_civilytics(once))
-  expect_s3_class(twice, "flextable")
-})
-
-test_that("zebra = FALSE still returns a valid flextable", {
-  skip_if_not_installed("flextable")
-  skip_if_not_installed("officer")
-
-  ft <- flextable::flextable(head(mtcars, 6))
-  expect_s3_class(style_flextable_civilytics(ft, zebra = FALSE), "flextable")
-})
-
-test_that("save_branded_flextable_png writes a PNG with plausible dimensions", {
-  skip_if_not_installed("flextable")
-  skip_if_not_installed("officer")
-  skip_if_not_installed("ragg")
-  skip_if_not_installed("png")
-
-  ft <- flextable::flextable(head(mtcars, 4))
-  ft <- flextable::add_footer_lines(ft, "Source: mtcars")
-  ft <- style_flextable_civilytics(ft)
-
-  path <- tempfile(fileext = ".png")
-  on.exit(unlink(path), add = TRUE)
-
-  out <- save_branded_flextable_png(ft, path)
-
-  expect_identical(out, path)
-  expect_true(file.exists(path))
-
-  dims <- dim(png::readPNG(path))
-  # height x width x channels — a real table is at least a few hundred px each.
-  expect_gt(dims[1], 50)
-  expect_gt(dims[2], 50)
-})
-
-test_that("save_branded_flextable_png with logo = FALSE skips stamping but still writes", {
-  skip_if_not_installed("flextable")
-  skip_if_not_installed("officer")
-  skip_if_not_installed("ragg")
-  skip_if_not_installed("png")
-
-  ft <- style_flextable_civilytics(flextable::flextable(head(mtcars, 3)))
-
-  path <- tempfile(fileext = ".png")
-  on.exit(unlink(path), add = TRUE)
-
-  save_branded_flextable_png(ft, path, logo = FALSE)
-  expect_true(file.exists(path))
-  expect_gt(file.info(path)$size, 0)
-})
-
-test_that("extra_height increases the exported PNG height", {
-  skip_if_not_installed("flextable")
-  skip_if_not_installed("officer")
-  skip_if_not_installed("ragg")
-  skip_if_not_installed("png")
-
-  ft <- style_flextable_civilytics(flextable::flextable(head(mtcars, 4)))
-
-  path_small <- tempfile(fileext = ".png")
-  path_big <- tempfile(fileext = ".png")
-  on.exit(unlink(c(path_small, path_big)), add = TRUE)
-
-  save_branded_flextable_png(ft, path_small, logo = FALSE, extra_height = 0)
-  save_branded_flextable_png(ft, path_big, logo = FALSE, extra_height = 2)
-
-  expect_gt(dim(png::readPNG(path_big))[1], dim(png::readPNG(path_small))[1])
-})

tests/testthat/test_theme.R

@@ -136,11 +136,14 @@ test_that("theme_civilytics uses brand ink color for text", {
 test_that("theme_civilytics has transparent background by default", {
   th <- theme_civilytics()
   expect_true(is.na(th$plot.background$fill))
+  expect_true(is.na(th$panel.background$fill))
+  expect_null(th$legend.background$fill)
 })
 
-test_that("theme_civilytics uses brand paper color when paper_bg = TRUE", {
+test_that("theme_civilytics paper_bg=TRUE opt-in fills with cream", {
   th <- theme_civilytics(paper_bg = TRUE)
   expect_equal(th$plot.background$fill, unname(civilytics_colors["paper"]))
+  expect_equal(th$panel.background$fill, unname(civilytics_colors["paper"]))
 })
 
 test_that("theme_civilytics uses paper_2 for strip background by default", {