docs: resolve #4 (dontrun audit, missing examples, related cleanup)

Audit of \dontrun{} usage:

- Remove wrappers from aep2stage, stage2aep, bootstrap_vfc, flow_frequency_sampler_expected, hydrograph_setup

- Add @details to stage2aep documenting expected approx() ties warning

- Add inline GEV/LP3 comments to bootstrap_vfc

- Keep wrapper on rfa_simulate with runtime comment

Bug fix: rfa_simulate Expected-mode example used jmd_vfc_parameters (single posterior mode row) where Nbin*Mevent rows are required. Swapped to jmd_bf_parameter_sets across all three modes.

Missing examples: added example and @return to theme_rfar_conceptual (was rendering blank). Internal helpers (interpolate_aep_matrix, interpolate_stage_matrix, stage_frequency_curve) intentionally left unexposed per @Keywords i

Author: danmcgraw94

DESCRIPTION

@@ -44,12 +44,10 @@ Depends:
 LazyData: true
 Suggests: 
     gt,
-    ggplot2,
     knitr,
     rmarkdown,
     scales,
     testthat (>= 3.0.0),
-    tidyverse,
     dplyr,
     tidyr,
     kableExtra,
@@ -60,6 +58,7 @@ Imports:
     cli,
     future,
     future.apply,
+    ggplot2,
     lmom,
     lubridate,
     progressr,

R/data.R

@@ -206,15 +206,15 @@
 #'
 #' Inflow hydrograph shape from May 1955 flood event.
 #'
-#' @format A data frame with 241 rows and 2 columns:
+#' @format A data frame with 241 rows and 4 columns:
 #' \describe{
 #'   \item{Ordinate}{Timeseries Ordinate}
 #'   \item{Date}{Date mm/dd/yyyy}
 #'   \item{Time}{Time in 00:00}
 #'   \item{Flow}{Inflow (cfs)}
 #' }
 #' @examples
-#' sapply(jmd_hydro_may1955,class)
+#' sapply(jmd_hydro_may1955, class)
 #' head(jmd_hydro_may1955)
 #' plot(jmd_hydro_may1955$Ordinate, jmd_hydro_may1955$Flow,
 #'      xlab = "Hour", ylab = "Inflow (cfs)",
@@ -225,15 +225,15 @@
 #'
 #' Inflow hydrograph shape for Probable Maximum Flood (PMF).
 #'
-#' @format A data frame with 192 rows and 2 columns:
+#' @format A data frame with 192 rows and 4 columns:
 #' \describe{
 #'   \item{Ordinate}{Timeseries Ordinate}
 #'   \item{Date}{Date mm/dd/yyyy}
 #'   \item{Time}{Time in 00:00}
 #'   \item{Flow}{Inflow (cfs)}
 #' }
 #' @examples
-#' sapply(jmd_hydro_pmf,class)
+#' sapply(jmd_hydro_pmf, class)
 #' head(jmd_hydro_pmf)
 #' plot(jmd_hydro_pmf$Ordinate, jmd_hydro_pmf$Flow,
 #'      xlab = "Hour", ylab = "Inflow (cfs)",
@@ -244,15 +244,15 @@
 #'
 #' Inflow hydrograph shape for Spillway Design Flood (SDF).
 #'
-#' @format A data frame with 337 rows and 2 columns:
+#' @format A data frame with 337 rows and 4 columns:
 #' \describe{
 #'   \item{Ordinate}{Timeseries Ordinate}
 #'   \item{Date}{Date mm/dd/yyyy}
 #'   \item{Time}{Time in 00:00}
 #'   \item{Flow}{Inflow (cfs)}
 #' }
 #' @examples
-#' sapply(jmd_hydro_sdf,class)
+#' sapply(jmd_hydro_sdf, class)
 #' head(jmd_hydro_sdf)
 #' plot(jmd_hydro_sdf$Ordinate, jmd_hydro_sdf$Flow,
 #'      xlab = "Hour", ylab = "Inflow (cfs)",

R/plotting_utils.R

@@ -1,7 +1,26 @@
-#' rfaR ggplot theme for conceptual example
+#' rfaR ggplot2 Theme for Conceptual Plots
+#'
+#' A custom \pkg{ggplot2} theme used in the rfaR conceptual realization
+#' vignette. Based on \code{\link[ggplot2]{theme_bw}} with tightened text
+#' sizes, italic titles, and the legend suppressed. Intended for figures
+#' that emphasize curves over annotation density.
+#'
+#' @return A \pkg{ggplot2} theme object that can be added to a \code{ggplot}
+#'   via \code{+}.
 #'
-#' custom ggplot2 theme for rfaR-Realization-Conceptual.Rmd
 #' @export
+#'
+#' @seealso \code{\link[ggplot2]{theme_bw}}
+#'
+#' @examples
+#' library(ggplot2)
+#' ggplot(jmd_rfa_expected, aes(x = AEP, y = Expected)) +
+#'   geom_line() +
+#'   scale_x_continuous(transform = c("log10", "reverse")) +
+#'   labs(title = "JMD Expected Stage-Frequency",
+#'        subtitle = "Demonstrating theme_rfar_conceptual()",
+#'        x = "AEP", y = "Stage (ft)") +
+#'   theme_rfar_conceptual()
 theme_rfar_conceptual <- function(){
   ggplot2::theme_bw() +
     ggplot2::theme(legend.position = "none",