Generate \newcommand stubs for variable/factor names — emit_name

The report functions can emit variable and factor-level names as LaTeX commands (e.g. \Video) so their typography is controlled centrally. This writes the matching \newcommand definitions so those commands are never undefined – the classic "Undefined control sequence" that stops an Overleaf build. Only names that are valid LaTeX command names (letters only) get a macro; others are reported as skipped (the reporters emit those as escaped plain text instead).

Usage

emit_name_macros(vars, path = NULL, labels = NULL)

Arguments

vars: Character vector of variable/level names (e.g. the columns you pass as iv/dv), or a named character vector / list mapping a name to the display label it should expand to.
path: Optional .tex/.sty path to write the definitions to.
labels: Optional named character vector mapping a name to its display label (overrides names taken from vars).

Value

Invisibly, the \newcommand lines as a character vector; also emitted via message().

Examples

emit_name_macros(c("Video", "DriverPosition"))
#> \newcommand{\Video}{Video}
#> \newcommand{\DriverPosition}{DriverPosition}
emit_name_macros(c(tlxMental = "TLX Mental Demand"))
#> \newcommand{\tlxMental}{TLX Mental Demand}