% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/api-reports.R
\name{plot.mfrm_summary_table_bundle}
\alias{plot.mfrm_summary_table_bundle}
\title{Plot a summary-table bundle for manuscript QC}
\usage{
\method{plot}{mfrm_summary_table_bundle}(
  x,
  y = NULL,
  type = c("table_rows", "role_tables", "appendix_roles", "appendix_sections",
    "appendix_presets", "selection_handoff_presets", "selection_tables",
    "selection_handoff", "selection_handoff_bundles", "selection_handoff_roles",
    "selection_handoff_role_sections", "selection_bundles", "selection_roles",
    "selection_sections", "numeric_profile", "first_numeric"),
  which = NULL,
  selection_value = c("count", "fraction"),
  appendix_preset = c("recommended", "compact", "all", "methods", "results",
    "diagnostics", "reporting"),
  main = NULL,
  palette = NULL,
  label_angle = 45,
  draw = TRUE,
  ...
)
}
\arguments{
\item{x}{Output from \code{\link[=build_summary_table_bundle]{build_summary_table_bundle()}}.}

\item{y}{Reserved for generic compatibility.}

\item{type}{Plot type: \code{"table_rows"} for returned-table sizes,
\code{"role_tables"} for returned-table counts by reporting role,
\code{"appendix_roles"} for returned-table counts by reporting role under the
bundle's appendix-routing contract,
\code{"appendix_sections"} for returned-table counts by manuscript-facing
appendix section,
\code{"appendix_presets"} for conservative appendix-preset counts,
\code{"selection_handoff_presets"} for workflow-only preset-level appendix
handoff counts,
\code{"selection_tables"} / \code{"selection_handoff"} /
\code{"selection_handoff_bundles"} /
\code{"selection_handoff_roles"} / \code{"selection_bundles"} /
\code{"selection_roles"} / \code{"selection_sections"} for workflow-only appendix
selection surfaces when present in the bundle,
\code{"numeric_profile"} for column means from a selected numeric table, or
\code{"first_numeric"} for the distribution of the first numeric column in a
selected table.}

\item{which}{Optional table selector used for numeric plot types.}

\item{selection_value}{For \verb{selection_*} plot types, whether to plot exact
counts (\code{"count"}) or the corresponding exact fraction (\code{"fraction"})
when that surface exposes one.}

\item{appendix_preset}{Appendix preset used for \verb{selection_*} plot types.}

\item{main}{Optional title override.}

\item{palette}{Optional named color overrides.}

\item{label_angle}{Axis-label rotation angle for bar-type plots.}

\item{draw}{If \code{TRUE}, draw using base graphics.}

\item{...}{Reserved for generic compatibility.}
}
\value{
A plotting-data object of class \code{mfrm_plot_data}.
}
\description{
Plot a summary-table bundle for manuscript QC
}
\details{
This helper keeps summary-bundle plotting conservative. It either visualizes
the bundle's own bundle-level indexes (\code{"table_rows"}, \code{"role_tables"},
\code{"appendix_roles"}, \code{"appendix_sections"}, \code{"appendix_presets"}) or routes a
selected table through \code{\link[=apa_table]{apa_table()}} and \code{\link[=plot.apa_table]{plot.apa_table()}} for numeric QC.
}
\section{Interpreting output}{

\itemize{
\item \code{"table_rows"}: compares returned table sizes to show where reporting mass sits.
\item \code{"role_tables"}: shows how many returned tables belong to each reporting role.
\item \code{"appendix_roles"}: shows how returned tables contribute to conservative
appendix routing by reporting role.
\item \code{"appendix_sections"}: shows how returned tables are distributed across
methods/results/diagnostics/reporting sections.
\item \code{"appendix_presets"}: shows how many tables the current bundle contributes
to the conservative appendix presets.
\item \code{"selection_handoff_presets"}: shows plot-ready appendix handoff counts by
preset for workflow-only appendix routing surfaces in the bundle.
\item \code{"selection_tables"} / \code{"selection_handoff"} /
\code{"selection_handoff_bundles"} /
\code{"selection_handoff_roles"} / \code{"selection_handoff_role_sections"} /
\code{"selection_bundles"} /
\code{"selection_roles"} / \code{"selection_sections"}: show workflow-only appendix
selection surfaces already materialized inside the bundle.
\item \code{"numeric_profile"} / \code{"first_numeric"}: reuse the same numeric QC logic as
\code{\link[=plot.apa_table]{plot.apa_table()}} but start from a summary-table bundle.
}
}

\examples{
\donttest{
toy <- load_mfrmr_data("example_core")
fit <- fit_mfrm(toy, "Person", c("Rater", "Criterion"), "Score",
                method = "JML", maxit = 30)
bundle <- build_summary_table_bundle(fit)
plot(bundle, draw = FALSE)
plot(bundle, type = "numeric_profile", which = "facet_overview", draw = FALSE)
}
}
\seealso{
\code{\link[=build_summary_table_bundle]{build_summary_table_bundle()}}, \code{\link[=apa_table]{apa_table()}}, \code{\link[=plot.apa_table]{plot.apa_table()}}
}
