% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/help_facets_coverage.R
\name{facets_feature_coverage}
\alias{facets_feature_coverage}
\title{FACETS Feature Coverage Matrix}
\usage{
facets_feature_coverage(
  status = c("all", "implemented", "partial", "not_implemented", "not_targeted")
)
}
\arguments{
\item{status}{Which rows to return. \code{"all"} returns the full matrix.
Other values filter by the \code{Status} column.}
}
\value{
A data.frame with columns:
\itemize{
\item \code{FACETSArea}
\item \code{FACETSFeature}
\item \code{FACETSReference}
\item \code{mfrmrRoute}
\item \code{Status}
\item \code{Scope}
\item \code{GapOrBoundary}
\item \code{Priority}
}
}
\description{
\code{facets_feature_coverage()} summarizes how the current \code{mfrmr} release maps
the main FACETS output-table, output-file, and graph-menu surface to package
functions.

Use this helper before migration work when you need a public, user-facing
answer to three questions:
\itemize{
\item which FACETS outputs have a close \code{mfrmr} route,
\item which outputs are only partially covered by structured R objects,
\item which FACETS-specific outputs are not implemented or intentionally outside
the current package scope.
}
}
\details{
The matrix is based on the FACETS 64-bit output index, which lists output
Tables 1--14, DIF/bias plots, R/Web plots, output files, and graph-menu
curves. \code{mfrmr} intentionally prioritizes structured R tables and reusable
plot data over exact FACETS line-printer output.

Status meanings:
\itemize{
\item \code{implemented}: a package-native route covers the substantive output.
\item \code{partial}: the concept is covered, but not the full FACETS formatting,
option surface, file type, or external integration.
\item \code{not_implemented}: a FACETS feature has no direct package-native route in
the current release.
\item \code{not_targeted}: the feature is tied to FACETS UI, Web/Excel handoff, or
another external program format and is not a release goal.
}
}
\examples{
facets_feature_coverage()
facets_feature_coverage("partial")
facets_feature_coverage("not_implemented")
}
\references{
Linacre, J. M. (2026). \emph{A user's guide to FACETS, version 4.5.0}.
Output tables - files - plots - graphs:
\url{https://www.winsteps.com/facetman64/outputtableindex.htm}.
}
\seealso{
\code{\link[=facets_positioning_guide]{facets_positioning_guide()}}, \code{\link[=mfrmr_output_guide]{mfrmr_output_guide()}},
\code{\link[=facets_fit_df_guide]{facets_fit_df_guide()}}, \code{\link[=read_facets_fit_table]{read_facets_fit_table()}}, \code{\link[=facets_fit_review]{facets_fit_review()}},
\code{\link[=gpcm_capability_matrix]{gpcm_capability_matrix()}}
}
