% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/catalogue.R
\name{hmrc_search}
\alias{hmrc_search}
\title{Search the HMRC dataset catalogue}
\usage{
hmrc_search(query = NULL, implemented = NULL, frequency = NULL)
}
\arguments{
\item{query}{Character. Keyword or regex pattern. Case-insensitive.
Matches anywhere in \code{dataset}, \code{publication}, \code{description}, or \code{tags}.
If \code{NULL} or empty, the full catalogue is returned.}

\item{implemented}{Logical or \code{NULL}. If \code{TRUE}, only rows with a
working \code{function_name} are returned. If \code{FALSE}, only roadmap rows.
\code{NULL} (default) returns both.}

\item{frequency}{Optional character vector to filter by frequency
(e.g. \code{"monthly"}, \code{"annual"}).}
}
\value{
A data frame, sorted with implemented datasets first.
}
\description{
Fuzzy keyword search across publication name, description, tags, and
dataset identifier. Returns a tidy table of matching rows so users can
discover what the package exposes (and what is on the roadmap).
}
\examples{
# Everything mentioning VAT
hmrc_search("vat")

# Only annual publications already implemented
hmrc_search(implemented = TRUE, frequency = "annual")

# Roadmap items mentioning capital gains
hmrc_search("capital gains", implemented = FALSE)

}
\seealso{
Other infrastructure: 
\code{\link{hmrc_cache_info}()},
\code{\link{hmrc_clear_cache}()},
\code{\link{hmrc_list_tax_heads}()},
\code{\link{hmrc_meta}()},
\code{\link{hmrc_publications}()}
}
\concept{infrastructure}
