% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/theme.R
\name{hd_theme}
\alias{hd_theme}
\title{Build a Highcharts Theme Object}
\usage{
hd_theme(name = NULL, colors = NULL, ...)
}
\arguments{
\item{name}{Character or \code{NULL}. Theme name; \code{NULL} reads from
\code{getOption("highdir.hc_theme")}.}

\item{colors}{Character vector or \code{NULL}. Colour override for this call.}

\item{...}{Named arguments forwarded to \code{\link[highcharter:hc_theme]{highcharter::hc_theme()}} as
extra overrides on top of the base theme.}
}
\value{
A highcharter theme object (\code{hc_theme}).
}
\description{
Constructs a highcharter theme by merging a named base theme with colour
and font overrides from the current \code{\link[=hd_set_theme]{hd_set_theme()}} session defaults and
any per-figure \code{opts}.
}
\details{
Called automatically inside the highcharter engine; useful when you want to
apply a theme to a highchart built outside highdir.
}
\examples{
if(interactive()) {
t <- hd_theme("darkunica")
highcharter::highchart() |> highcharter::hc_add_theme(t)
}

}
