# Box-drawing characters live in BOX_CHARS (see zzz.R); the active set
# (unicode or ASCII fallback) is selected at load time in .onLoad().


#' Get the simple slopes of a SEM model
#'
#' This function calculates simple slopes (predicted values of the outcome variable)
#' at user-specified values of the focal predictor (\code{x}) and moderator (\code{z})
#' in a structural equation modeling (SEM) framework. It supports interaction terms
#' (\code{xz}), computes standard errors (SE), and optionally returns confidence or
#' prediction intervals for these predicted values. It also provides p-values for
#' hypothesis testing. This is useful for visualizing and interpreting moderation
#' effects or to see how the slope changes at different values of the moderator.
#'
#' @param x The name of the variable on the x-axis (focal predictor).
#' @param z The name of the moderator variable.
#' @param y The name of the outcome variable.
#' @param model An object of class \code{\link{modsem_pi}}, \code{\link{modsem_da}},
#'   \code{\link{modsem_mplus}}, or a \code{lavaan} object. This should be a fitted SEM
#'   model that includes paths for \code{y ~ x + z + x:z}.
#' @param vals_x Numeric vector of values of \code{x} at which to compute predicted
#'   slopes. Defaults to \code{-3:3}. If \code{rescale = TRUE}, these values are taken
#'   relative to the mean and standard deviation of \code{x}. A higher density of points
#'   (e.g., \code{seq(-3, 3, 0.1)}) will produce smoother curves and confidence bands.
#' @param vals_z Numeric vector of values of the moderator \code{z} at which to compute
#'   predicted slopes. Defaults to \code{-1:1}. If \code{rescale = TRUE}, these values
#'   are taken relative to the mean and standard deviation of \code{z}. Each unique value
#'   of \code{z} generates a separate regression line \code{y ~ x | z}.
#' @param rescale Logical. If \code{TRUE} (default), \code{x} and \code{z} are standardized
#'   according to their means and standard deviations in the model. The values in
#'   \code{vals_x} and \code{vals_z} are interpreted in those standardized units. The
#'   raw (unscaled) values corresponding to these standardized points will be displayed
#'   in the returned table.
#' @param ci_width A numeric value between 0 and 1 indicating the confidence (or
#'   prediction) interval width. The default is 0.95 (i.e., 95\% interval).
#' @param ci_type A string indicating whether to compute a \code{"confidence"} interval
#'   for the predicted mean (\emph{i.e.}, uncertainty in the regression line) or a
#'   \code{"prediction"} interval for individual outcomes. The default is
#'   \code{"confidence"}. If \code{"prediction"}, the residual variance is added to the
#'   variance of the fitted mean, resulting in a wider interval.
#' @param relative_h0 Logical. If \code{TRUE} (default), hypothesis tests for the
#'   predicted values (\code{predicted - h0}) assume \code{h0} is the model-estimated
#'   mean of \code{y}. If \code{FALSE}, the null hypothesis is \code{h0 = 0}.
#' @param standardized Should coefficients be standardized beforehand?
#' @param xz The name of the interaction term (\code{x:z}). If \code{NULL}, it will
#'   be created by combining \code{x} and \code{z} with a colon (e.g., \code{"x:z"}).
#'   Some backends may remove or alter the colon symbol, so the function tries to
#'   account for that internally.
#'
#' @param ... Additional arguments passed to lower-level functions or other internal
#'   helpers.
#'
#' @details
#' \strong{Computation Steps}
#' \enumerate{
#'    \item The function extracts parameter estimates (and, if necessary, their covariance
#'          matrix) from the fitted SEM model (\code{model}).
#'    \item It identifies the coefficients for \code{x}, \code{z}, and \code{x:z} in the model's
#'          parameter table, as well as the variance of \code{x}, \code{z} and the residual variance
#'          of \code{y}.
#'    \item If \code{xz} is not provided, it will be constructed by combining \code{x} and
#'          \code{z} with a colon (\code{":"}). Depending on the approach used to estimate the model,
#'          the colon may be removed or replaced internally; the function attempts to reconcile that.
#'
#'   \item A grid of \code{x} and \code{z} values is created from \code{vals_x} and
#'         \code{vals_z}. If \code{rescale = TRUE}, these values are transformed back into raw
#'         metric units for display in the output.
#'   \item For each point in the grid, a predicted value of \code{y} is computed via
#'         \code{(beta0 + beta_x * x + beta_z * z + beta_xz * x * z)} and, if included, a
#'         mean offset.
#'   \item The standard error (\code{std.error}) is derived from the covariance matrix of
#'         the relevant parameters, and if \code{ci_type = "prediction"}, adds the residual
#'         variance.
#'   \item Confidence (or prediction) intervals are formed using \code{ci_width} (defaulting
#'         to 95\%). The result is a table-like data frame with predicted values, CIs,
#'         standard errors, z-values, and p-values.
#' }
#'
#' @return A \code{data.frame} (invisibly inheriting class \code{"simple_slopes"})
#' with columns:
#' \itemize{
#'   \item \code{vals_x}, \code{vals_z}: The requested grid values of \code{x} and \code{z}.
#'   \item \code{predicted}: The predicted value of \code{y} at that combination of
#'         \code{x} and \code{z}.
#'   \item \code{std.error}: The standard error of the predicted value.
#'   \item \code{z.value}, \code{p.value}: The z-statistic and corresponding p-value
#'         for testing the null hypothesis that \code{predicted == h0}.
#'   \item \code{ci.lower}, \code{ci.upper}: Lower and upper bounds of the confidence
#'         (or prediction) interval.
#' }
#' An attribute \code{"variable_names"} (list of \code{x}, \code{z}, \code{y})
#' is attached for convenience.
#'
#' @export
#'
#' @examples
#' \dontrun{
#' library(modsem)
#'
#' m1 <- "
#' # Outer Model
#'   X =~ x1 + x2 + x3
#'   Z =~ z1 + z2 + z3
#'   Y =~ y1 + y2 + y3
#'
#' # Inner model
#'   Y ~ X + Z + X:Z
#' "
#' est1 <- modsem(m1, data = oneInt)
#'
#' # Simple slopes at X in [-3, 3] and Z in [-1, 1], rescaled to the raw metric.
#' simple_slopes(x = "X", z = "Z", y = "Y", model = est1)
#'
#' # If the data or user wants unscaled values, set rescale = FALSE, etc.
#' simple_slopes(x = "X", z = "Z", y = "Y", model = est1, rescale = FALSE)
#' }
simple_slopes <- function(x,
                          z,
                          y,
                          model,
                          vals_x = -3:3,
                          vals_z = -1:1,
                          rescale = TRUE,
                          ci_width = 0.95,
                          ci_type = "confidence",
                          relative_h0 = TRUE,
                          standardized = FALSE,
                          xz = NULL,
                          ...) {
  mod_stopif(!isModsemObject(model) && !isLavaanObject(model), paste0("model must be of class ",
         "'modsem_pi', 'modsem_da', 'modsem_mplus' or 'lavaan'"))

  if (standardized) {
    parTable <- standardized_estimates(model, correction = TRUE)
  } else {
    parTable <- parameter_estimates(
      object = model,
      label.renamed.prod = TRUE
    )
  }

  parTable <- getMissingLabels(addMissingGroups(parTable))

  out <- list()
  group.label <- tryCatch(modsem_inspect(model, what = "group.label"), error = \(e) NULL)

  for (g in getGroupsParTable(parTable)) {
    label <- tryCatch(group.label[[g]], error = \(e) NULL)
    label <- if (is.null(label)) as.character(g) else label

    parTable.g <- parTable[parTable$group == g, , drop = FALSE]

    out[[label]] <- simpleSlopesGroup(
      x = x, z = z, y = y, parTable = parTable.g, model = model, vals_x = vals_x,
      vals_z = vals_z, rescale = rescale, ci_width = ci_width, ci_type = ci_type,
      relative_h0 = relative_h0, xz = xz, standardized = standardized, ...
    )
  }

  structure(out, class = "simple_slopes")
}


simpleSlopesGroup <- function(x, z, y, parTable, model, vals_x, vals_z, rescale,
                              ci_width, ci_type, relative_h0, xz,
                              standardized, ...) {
  if (is.null(xz))
    xz <- paste(x, z, sep = ":")

  checkInputsSimpleSlopes(x = x, z = z, y = y, xz = xz, parTable = parTable)

  xz <- c(xz, reverseIntTerm(xz))

  xx <- paste(x, x, sep = ":")
  xx <- c(xx, reverseIntTerm(xx))

  zz <- paste(z, z, sep = ":")
  zz <- c(zz, reverseIntTerm(zz))

  if (!inherits(model, c("modsem_da", "modsem_mplus")) &&
      !isLavaanObject(model)) {
    xz <- stringr::str_remove_all(xz, ":")
    xx <- stringr::str_remove_all(xx, ":")
    zz <- stringr::str_remove_all(zz, ":")
  }

  if (inherits(model, "lavaan")) {
    vcov <- lavaan::vcov
    coef <- lavaan::coef
    nobs <- lavaan::nobs
  }

  n     <- nobs(model)
  VCOV  <- getVcovSimpleSlopes(model, standardized = standardized)

  if (length(n) > 1) {
    # this won't work for multigroup models
    warning("simple_slopes/plot_interaction does not support multigroup models, be vary of results!")
    n <- n[1]
  }

  # Extract coefficients
  beta_x  <- parTable[parTable$lhs == y & parTable$rhs == x & parTable$op == "~", "est"]
  beta_z  <- parTable[parTable$lhs == y & parTable$rhs == z & parTable$op == "~", "est"]
  beta_xz <- parTable[parTable$lhs == y & parTable$rhs %in% xz & parTable$op == "~", "est"]
  beta_xx <- parTable[parTable$lhs == y & parTable$rhs %in% xx & parTable$op == "~", "est"]
  beta_zz <- parTable[parTable$lhs == y & parTable$rhs %in% zz & parTable$op == "~", "est"]
  beta0_y <- parTable[parTable$lhs == y & parTable$op == "~1", "est"]
  res_y   <- parTable[parTable$lhs == y & parTable$rhs == y & parTable$op == "~~", "est"]

  var_x   <- calcCovParTable(x, x, parTable)
  var_z   <- calcCovParTable(z, z, parTable)

  mod_stopif(is.na(var_x), "Variance for x not found in model")
  mod_stopif(is.na(var_z), "Variance for z not found in model")
  mod_stopif(length(beta_x) == 0, "Coefficient for x not found in model")
  mod_stopif(length(beta_z) == 0, "Coefficient for z not found in model")
  mod_warnif(length(beta_xz) == 0, "Coefficient for interaction term not found in model")

  if (!length(beta_xx)) beta_xx <- 0
  if (!length(beta_xz)) beta_xz <- 0
  if (!length(beta_zz)) beta_zz <- 0

  label_beta_x  <- parTable[parTable$lhs == y & parTable$rhs == x & parTable$op == "~", "label"]
  label_beta_z  <- parTable[parTable$lhs == y & parTable$rhs == z & parTable$op == "~", "label"]
  label_beta_xz <- parTable[parTable$lhs == y & parTable$rhs %in% xz & parTable$op == "~", "label"]
  label_beta_xx <- parTable[parTable$lhs == y & parTable$rhs %in% xx & parTable$op == "~", "label"]
  label_beta_zz <- parTable[parTable$lhs == y & parTable$rhs %in% zz & parTable$op == "~", "label"]
  label_beta0_y <- parTable[parTable$lhs == y & parTable$op == "~1", "label"]

  label_beta_x  <- ifelse(length(label_beta_x) == 0, "y~x", label_beta_x)
  label_beta_z  <- ifelse(length(label_beta_z) == 0, "y~z", label_beta_z)
  label_beta_xz <- ifelse(length(label_beta_xz) == 0, "y~xz", label_beta_xz)
  label_beta_xx <- ifelse(length(label_beta_xx) == 0, "y~xx", label_beta_xx)
  label_beta_zz <- ifelse(length(label_beta_zz) == 0, "y~zz", label_beta_zz)
  label_beta0_y <- ifelse(length(label_beta0_y) == 0, "y~1", label_beta0_y)

  labels <- c(label_beta0_y, label_beta_x, label_beta_z, label_beta_xz,
              label_beta_xx, label_beta_zz)
  VCOV   <- expandVCOV(VCOV, labels)

  mean_x <- getMean(x, parTable = parTable)
  mean_z <- getMean(z, parTable = parTable)
  mean_y <- getIntercept(y, parTable = parTable)
  h0     <- if (relative_h0) mean_y else 0

  if (rescale) {
    vals_x <- vals_x * sqrt(var_x) + mean_x
    vals_z <- vals_z * sqrt(var_z) + mean_z
  }

  alpha  <- 1 - ci_width
  ci.sig <- stats::qnorm(1 - alpha / 2) # two-tailed

  # creating margins
  df <- structure(expand.grid(x = vals_x, z = vals_z), names= c("vals_x", "vals_z"))

  df$predicted <-
    mean_y +
    beta_x * df$vals_x +
    beta_z * df$vals_z +
    beta_xx * df$vals_x ^ 2 +
    beta_zz * df$vals_z ^ 2 +
    beta_xz * df$vals_x * df$vals_z

  df$std.error <- calc_se(df, e = res_y, VCOV = VCOV, se_type = ci_type)
  df$z.value   <- (df$predicted - h0) / df$std.error # H0 = mean_y
  df$p.value   <- 2 * stats::pnorm(-abs(df$z.value))
  df$ci.upper  <- df$predicted + ci.sig * df$std.error
  df$ci.lower  <- df$predicted - ci.sig * df$std.error

  # significance test of slopes (not margins)
  k <- length(vals_z)
  slopeLabels <- c(label_beta_x, label_beta_xz)
  slopesVCOV <- VCOV[slopeLabels, slopeLabels]
  slopes <- beta_x + vals_z * beta_xz

  d_beta_x  <- rep(1, k) # d(beta_x)/d(beta_x) = 1
  d_beta_xz <- vals_z    # d(vals_z * beta_xz) / d(beta_xz) = vals_z
  jacobian <- matrix(c(d_beta_x, d_beta_xz),
                     nrow=k, ncol=2, byrow=FALSE)
  slopesVCOV <- jacobian %*% slopesVCOV %*% t(jacobian) # delta method
  std.error <- sqrt(diag(slopesVCOV))
  z.value <- slopes / std.error

  sig.slopes <- data.frame(
    param = paste0(y, "~", x),
    moderator = z,
    slope.predictor = slopes,
    value.moderator = vals_z,
    std.error = std.error,
    z.value = z.value,
    p.value = 2 * stats::pnorm(-abs(z.value)),
    ci.lower = slopes - ci.sig * std.error,
    ci.upper = slopes + ci.sig * std.error
  )

  # significance test min/max
  var_beta_xz <- VCOV[label_beta_xz, label_beta_xz]
  min_z <- min(vals_z)
  max_z <- max(vals_z)
  diff <- max_z * beta_xz - min_z * beta_xz
  grad_diff <- max_z - min_z # with respect to beta_xz
  std.error_diff <- sqrt(grad_diff^2 * var_beta_xz) # delta method
  z_diff <- diff / std.error_diff
  p_diff <- 2 * stats::pnorm(-abs(z_diff))

  sig.diff_min_max <- data.frame(
    min.z = min_z,
    max.z = max_z,
    diff = diff,
    std.error = std.error_diff,
    z.value = z_diff,
    p.value = p_diff,
    ci.lower = diff - ci.sig * std.error_diff,
    ci.upper = diff + ci.sig * std.error_diff
  )

  list(
    variable_names = c(x = x, z = z, y = y),
    margins = df,
    sig.slopes = sig.slopes,
    sig.diff_min_max = sig.diff_min_max
  )
}


calc_se <- function(df, e, VCOV, se_type = "confidence") {
  if (se_type == "prediction")
    return(sqrt(rep(e, nrow(df))))
  else if (se_type != "confidence")
    warning("se_type must be 'confidence' or 'prediction', using 'confidence'!")

  vals_x <- df$vals_x
  vals_z <- df$vals_z

  n <- nrow(df)
  i <- rep(1, n)
  X <- matrix(c(i, vals_x, vals_z, vals_x * vals_z, vals_x^2, vals_z^2), nrow=n)
  V <- calcSESimpleSlopes(X, VCOV)

  sqrt(as.vector(V))
}



printTable <- function(x) {
  if (!NROW(x)) return(NULL)

  box <- BOX_CHARS$chars

  header <- paste0(paste(x[1, ], collapse = paste0(" ", box$V_LINE, " ")), " ")
  header_vec <- unlist(stringr::str_split(header, ""))

  sep_thin_vec <- rep(box$H_LINE, nchar(header))
  sep_thin_vec[header_vec == box$V_LINE] <- box$D_CROSS
  sep_thin <- paste0(sep_thin_vec, collapse="")
  sep_thin <- paste0(box$LU_CORNER, sep_thin, box$RU_CORNER, "\n")

  sep_thick_vec <- rep(box$H_DLINE, nchar(header))
  sep_thick_vec[header_vec == box$V_LINE] <- box$F_DCROSS
  sep_thick <- paste0(sep_thick_vec, collapse="")
  sep_thick <- paste0(box$L_DCROSS, sep_thick, box$R_DCROSS, "\n")

  sep_bottom_vec <- sep_thin_vec
  sep_bottom_vec[header_vec == box$V_LINE] <- box$U_CROSS
  sep_bottom <- paste0(sep_bottom_vec, collapse="")
  sep_bottom <- paste0(box$LL_CORNER, sep_bottom, box$RL_CORNER, "\n")

  for (i in seq_len(nrow(x))) {
    str <- paste(x[i, ], collapse = paste0(" ", box$V_LINE, " "))
    str <- paste0(box$V_LINE, str, " ", box$V_LINE, "\n")

    if (i == 1) {
      cat(sep_thin, str, sep_thick, sep = "")
    } else cat(str)
  }

  cat(sep_bottom)
}


#' @export
print.simple_slopes <- function(x, digits = 2, scientific.p = FALSE, ...) {
  if (length(x) <= 1L)
    return(printSimpleSlopesGroup(x = x[[1L]], digits = digits, scientific.p = scientific.p, ...))

  box <- BOX_CHARS$chars
  for (g in names(x)) {
    printf("%s\n", strrep(box$H_LINE, getOption("width")))
    printf("  Group: %s\n", g)
    printf("%s\n", strrep(box$H_DLINE, getOption("width")))
    printSimpleSlopesGroup(x = x[[g]], digits = digits, scientific.p = scientific.p, ...)
  }

  invisible(x)
}


printSimpleSlopesGroup <- function(x, digits = 2, scientific.p = FALSE, ...) {
  fstring <- paste0("%.", digits, "f")
  digits.p <- max(3, digits)

  fformat <- \(x, justify = "right", ...) format(sprintf(fstring, x), justify = justify, ...)
  pformat <- \(x) formatPval(x, scientific = scientific.p, digits = digits.p)

  variables  <- x$variable_names
  margins    <- x$margins
  sig.slopes <- x$sig.slopes
  sig.diff_min_max <- x$sig.diff_min_max

  var_x <- variables[[1]]
  var_z <- variables[[2]]
  var_y <- variables[[3]]

  # Difference test ----------------------------------------------------------
  header <- c("Difference", "Std.Error",
              "z.value", "p.value", "Conf.Interval")
  ci.lower <- fformat(sig.diff_min_max$ci.lower)
  ci.upper <- fformat(sig.diff_min_max$ci.upper)

  X <- data.frame(
    diff      = fformat(sig.diff_min_max$diff),
    std.error = fformat(sig.diff_min_max$std.error),
    z.value   = fformat(sig.diff_min_max$z.value),
    p.value   = pformat(sig.diff_min_max$p.value),
    ci        = paste0("[", ci.lower, ", ", ci.upper, "]")
  )

  X1 <- matrix(header, nrow = 1)
  X2 <- padCharMatrix(as.matrix(X), n=1) # pad atleast one space to the left
  X <- apply(rbind(X1, X2), MARGIN = 2, format, digits = digits, justify = "right")

  cat(sprintf("\nDifference test of %s~%s|%s at %s = %s and %s:\n",
              var_y, var_x, var_z, var_z, fformat(sig.diff_min_max$min.z),
              fformat(sig.diff_min_max$max.z)))
  printTable(X)
  cat("\n")

  # Slope test -----------------------------------------------------------------
  header <- c(sig.slopes$param[1], sig.slopes$moderator[1], "Std.Error",
              "z.value", "p.value", "Conf.Interval")
  ci.lower <- fformat(sig.slopes$ci.lower)
  ci.upper <- fformat(sig.slopes$ci.upper)

  X <- data.frame(
    slope     = fformat(sig.slopes$slope.predictor),
    val_z     = fformat(sig.slopes$value.moderator),
    std.error = fformat(sig.slopes$std.error),
    z.value   = fformat(sig.slopes$z.value),
    p.value   = pformat(sig.slopes$p.value),
    ci        = paste0("[", ci.lower, ", ", ci.upper, "]")
  )

  X1 <- matrix(header, nrow = 1)
  X2 <- padCharMatrix(as.matrix(X), n=1) # pad atleast one space to the left
  X <- apply(rbind(X1, X2), MARGIN = 2, format, digits = digits, justify = "right")

  cat(sprintf("Effect of %s~%s|%s given values of %s:\n", var_y, var_x, var_z, var_z))
  printTable(X)
  cat("\n")

  # Margins --------------------------------------------------------------------
  predictors <- variables[1:2]
  outcome    <- variables[3]
  header     <- c(predictors[1], sprintf("Predicted %s", outcome), "Std.Error",
                  "z.value", "p.value", "Conf.Interval")
  ci.lower   <- fformat(margins$ci.lower)
  ci.upper   <- fformat(margins$ci.upper)
  cat_z      <- as.factor(fformat(round(margins$vals_z, digits)))

  X <- data.frame(vals_x    = fformat(margins$vals_x),
                  predicted = fformat(margins$predicted),
                  std.error = fformat(margins$std.error),
                  z.value   = fformat(margins$z.value),
                  p.value   = pformat(margins$p.value),
                  ci        = paste0("[", ci.lower, ", ", ci.upper, "]"))

  X1 <- matrix(header, nrow = 1)
  X2 <- padCharMatrix(as.matrix(X), n=1) # pad atleast one space to the left

  X <- apply(rbind(X1, X2), MARGIN = 2, format, digits = digits, justify = "right")

  for (z_i in unique(cat_z)) {
    Z1 <- X[1, ]
    Z2 <- X[2:nrow(X),][cat_z == z_i,]
    Z  <- rbind(Z1, Z2)

    printf("\nPredicted %s, given %s = %s:\n", outcome, predictors[2], z_i)
    printTable(Z)
    cat("\n")
  }

  invisible(x)
}


#' @export
as.data.frame.simple_slopes <- function(x, ...) {
  if (length(x) <= 1L)
    return(x[[1L]]$margins)

  purrr::list_rbind(
    lapply(X = names(x), FUN = \(g)
           cbind(x[[g]]$margins, data.frame(group = g)))
  )
}


checkInputsSimpleSlopes <- function(..., parTable) {
  varmask   <- parTable$op %in% c("=~", "~1", "~~", "~")
  variables <- c(parTable[varmask, "lhs"], parTable[varmask, "rhs"])
  variables <- unique(variables[variables != ""])

  checkLength <- \(x, nm) mod_stopif(length(x) != 1L, paste0(nm, " must be of length 1!"))
  checkExists <- \(x) mod_stopif(!x %in% variables && !grepl(":", x),
                             paste0("Unrecognized variable: ", x, "!"))

  params <- list(...)
  for (nm in names(params)) {
    checkLength(x = params[[nm]], nm = nm)
    checkExists(x = params[[nm]])
  }
}


getVcovSimpleSlopes <- function(model, standardized = FALSE) {
  if (inherits(model, "modsem_da")) {
    return(modsem_inspect(model, what = "vcov.all", standardized = standardized))

  } else if (inherits(model, "modsem_pi")) {
    what <- if (standardized) "vcov.std.all" else "vcov"
    return(modsem_inspect(model, what = what))

  } else if (inherits(model, "lavaan")) {
    what <- if (standardized) "vcov.std.all" else "vcov"
    return(lavaan::lavInspect(model, what = what))

  } else {
    mod_msg_warn(paste0("standardized vcov is not available for model of class: ",
             class(model)[[1L]]))
    return(vcov(model))
  }
}
