\documentclass[11pt]{article}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage[margin=1.25in]{geometry}
\usepackage{hyperref}
\usepackage{xcolor}

\hypersetup{
    colorlinks=true,
    linkcolor=blue!70!black,
    urlcolor=blue!70!black,
}

\title{\textbf{The \texttt{jiffy} Package}\\ \Large A Modern, TikZ-based Page-Layout Diagnostic}
\author{Scot David Parker (in collaboration with Gemini Pro)}
\date{Version 0.2a \quad August 29, 2026}

\begin{document}

\maketitle

\section{Introduction}
The \texttt{jiffy} package provides a highly robust, mathematically accurate, and visually clean miniaturized map of a document's physical page geometry. It serves as a modern alternative to the classic \texttt{layout} package.

Built on top of PGF/TikZ, \texttt{jiffy} solves several historical limitations of layout diagnostics by offering:
\begin{itemize}
    \item \textbf{Mathematical Accuracy:} Direct access to TeX primitives ensures flawless conversion between points, millimeters, and inches.
    \item \textbf{Dynamic Anti-Collision:} Metric labels are dynamically staggered, preventing visual overlap even on highly customized or extreme paper sizes.
    \item \textbf{Active Diagnostics:} The package mathematically checks for out-of-bounds geometry (e.g., text blocks extending off the page) and generates automated diagnostic warnings.
    \item \textbf{Native Localization:} Built-in language support for English, Vietnamese, Spanish, German, French, and Dutch makes the output accessible to the global publishing community.
\end{itemize}

\section{Usage}
To use the package, simply include it in your preamble and call the \verb|\jiffy| command anywhere in your document environment. It will generate a three-page signature containing the Verso diagram, Recto diagram, and a comprehensive Data Sheet.

\begin{verbatim}
\documentclass[twoside]{book}
\usepackage[
  precision=3,
  display-language=english-us
]{jiffy}

\begin{document}
\jiffy
\end{document}
\end{verbatim}

\section{Package Options}
The package accepts options via the standard \texttt{key=value} interface.

\subsection{\texttt{precision}}
Controls the number of decimal places displayed for the inch and millimeter conversions on the layout map and Data Sheet. The default is \texttt{3}.
\begin{verbatim}
\usepackage[precision=4]{jiffy}
\end{verbatim}

\subsection{\texttt{display-language}}
Translates all diagram labels, table headers, and diagnostic warnings into the selected language. This allows publishers and editors to review physical layout diagnostics in their native vocabulary while the underlying LaTeX code remains untouched.
\begin{verbatim}
\usepackage[display-language=vietnamese]{jiffy}
\end{verbatim}

\noindent Supported languages include:
\begin{itemize}
    \item \texttt{english-us} (default)
    \item \texttt{vietnamese}
    \item \texttt{spanish}
    \item \texttt{german}
    \item \texttt{french}
    \item \texttt{dutch}
\end{itemize}

\section{Requirements}
The \texttt{jiffy} package requires the following standard packages, all of which are included in modern TeX distributions: \texttt{tikz}, \texttt{xcolor}, \texttt{nextpage}, \texttt{iftex}, \texttt{pgfopts}, and \texttt{pdflscape}. It is compatible with pdfTeX, XeTeX, and LuaTeX.

\end{document}