\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{kaggpreprint}[2026/08/15 v1.0 Kaggleyes Academy e-Print class]

\LoadClass[10pt,a4paper]{article}

\RequirePackage{fontspec}
\RequirePackage{xcolor}
\RequirePackage{geometry}
\RequirePackage{graphicx}
\RequirePackage{eso-pic}
\RequirePackage{fancyhdr}
\RequirePackage{titlesec}
\RequirePackage{microtype}
\RequirePackage{booktabs}
\RequirePackage{tabularx}
\RequirePackage{array}
\RequirePackage{colortbl}
\RequirePackage{enumitem}
\RequirePackage{hyperref}
\RequirePackage{lastpage}
\RequirePackage{amsmath}
\RequirePackage{amssymb}
\RequirePackage{caption}

\defaultfontfeatures{Ligatures=TeX,Scale=MatchLowercase}
\setmainfont{Liberation Serif}
\setsansfont{Liberation Sans}

\definecolor{KaggCrimson}{HTML}{941D36}
\definecolor{KaggInk}{HTML}{18181B}
\definecolor{KaggMuted}{HTML}{6C6870}
\definecolor{KaggWarm}{HTML}{F3F0EA}
\definecolor{KaggLine}{HTML}{D9D4CC}
\definecolor{KaggLink}{HTML}{244F6B}

\geometry{
  a4paper,
  top=17mm,
  bottom=20mm,
  inner=21mm,
  outer=17mm,
  headheight=21pt,
  headsep=5mm,
  footskip=10mm,
  columnsep=7mm
}

\hypersetup{
  colorlinks=true,
  linkcolor=KaggCrimson,
  citecolor=KaggCrimson,
  urlcolor=KaggLink,
  pdfborder={0 0 0}
}
\urlstyle{same}
\microtypesetup{protrusion=true,expansion=false}
\setlength{\parindent}{1em}
\setlength{\parskip}{0pt}
\setlength{\emergencystretch}{1.5em}
\clubpenalty=10000
\widowpenalty=10000
\displaywidowpenalty=10000

\newcommand{\kagg@id}{KAGG:UNASSIGNED}
\newcommand{\kagg@type}{Preprint}
\newcommand{\kagg@published}{Unpublished}
\newcommand{\kagg@registered}{Unregistered}
\newcommand{\kagg@license}{All rights reserved}
\newcommand{\kagg@url}{}
\newcommand{\kagg@affiliation}{}
\newcommand{\kagg@keywords}{}
\newcommand{\kagg@abstract}{}
\newcommand{\kagg@claim}{}
\newcommand{\kagg@shorttitle}{Kaggleyes Academy e-Print}
\newcommand{\kagg@version}{KAGG Preprint Style v1.0}

\newcommand{\kaggid}[1]{\gdef\kagg@id{#1}}
\newcommand{\kaggtype}[1]{\gdef\kagg@type{#1}}
\newcommand{\kaggdate}[1]{\gdef\kagg@published{#1}}
\newcommand{\kaggregistered}[1]{\gdef\kagg@registered{#1}}
\newcommand{\kagglicense}[1]{\gdef\kagg@license{#1}}
\newcommand{\kaggurl}[1]{\gdef\kagg@url{#1}}
\newcommand{\affiliation}[1]{\gdef\kagg@affiliation{#1}}
\newcommand{\keywords}[1]{\gdef\kagg@keywords{#1}}
\newcommand{\abstracttext}[1]{\long\gdef\kagg@abstract{#1}}
\newcommand{\kaggclaim}[1]{\long\gdef\kagg@claim{#1}}
\newcommand{\shorttitle}[1]{\gdef\kagg@shorttitle{#1}}

% Signature registry spine: a persistent visual identifier on every page.
\AddToShipoutPictureBG{%
  \AtPageLowerLeft{\color{KaggCrimson}\rule{1.35mm}{\paperheight}}%
  \AtPageLowerLeft{%
    \put(4.6mm,20mm){%
      \rotatebox{90}{%
        \sffamily\fontsize{6.3}{7}\selectfont\color{KaggMuted}%
        KAGGLEYEs ACADEMY \textbullet\ E-PRINT REGISTRY \textbullet\ \kagg@id%
      }%
    }%
  }%
}

\newcommand{\kagg@headerbrand}{%
  {\sffamily\fontsize{6.5}{7.5}\selectfont\bfseries\color{KaggCrimson}%
  KAGGLEYEs ACADEMY}\hspace{0.45em}%
  {\sffamily\fontsize{6.5}{7.5}\selectfont\color{KaggMuted}E-PRINT REGISTRY}%
}

\fancypagestyle{kagg}{%
  \fancyhf{}
  \fancyhead[L]{\kagg@headerbrand}
  \fancyhead[R]{\sffamily\fontsize{6.5}{7.5}\selectfont\color{KaggMuted}\kagg@shorttitle}
  \fancyfoot[L]{\sffamily\fontsize{6.5}{7.5}\selectfont\color{KaggMuted}\kagg@id}
  \fancyfoot[C]{\sffamily\fontsize{6.5}{7.5}\selectfont\color{KaggMuted}\kagg@version}
  \fancyfoot[R]{\sffamily\fontsize{6.5}{7.5}\selectfont\color{KaggInk}\thepage\,/\,\pageref*{LastPage}}
  \renewcommand{\headrulewidth}{0.25pt}
  \renewcommand{\footrulewidth}{0pt}
  \renewcommand{\headrule}{\hbox to\headwidth{\color{KaggLine}\leaders\hrule height \headrulewidth\hfill}}
}
\fancypagestyle{kaggfirst}{%
  \fancyhf{}
  \fancyfoot[L]{\sffamily\fontsize{6.5}{7.5}\selectfont\color{KaggMuted}\kagg@id}
  \fancyfoot[C]{\sffamily\fontsize{6.5}{7.5}\selectfont\color{KaggMuted}\kagg@version}
  \fancyfoot[R]{\sffamily\fontsize{6.5}{7.5}\selectfont\color{KaggInk}\thepage\,/\,\pageref*{LastPage}}
  \renewcommand{\headrulewidth}{0pt}
}
\pagestyle{kagg}
\renewcommand{\and}{\quad\textcolor{KaggMuted}{\textbullet}\quad}

\newcommand{\kagg@metacell}[2]{%
  \begin{minipage}[t]{\linewidth}
    {\sffamily\fontsize{6.5}{7.5}\selectfont\bfseries\color{KaggCrimson}\MakeUppercase{#1}}\par
    \vspace{1.5pt}
    {\sffamily\fontsize{7.5}{9}\selectfont\color{KaggInk}#2}
  \end{minipage}
}

\renewcommand{\maketitle}{%
  \twocolumn[{%
    \begin{@twocolumnfalse}
      \thispagestyle{kaggfirst}
      \vspace*{-6mm}
      \noindent
      \begin{minipage}[t]{0.64\textwidth}
        \kagg@headerbrand\\[-1pt]
        {\sffamily\fontsize{7}{8}\selectfont\color{KaggMuted}%
        ARCHIVAL PREPRINT / OPEN SCHOLARLY RECORD}
      \end{minipage}%
      \hfill
      \begin{minipage}[t]{0.31\textwidth}
        \raggedleft
        \colorbox{KaggCrimson}{%
          \parbox{0.88\linewidth}{%
            \raggedleft\color{white}\sffamily
            {\fontsize{6.5}{7.5}\selectfont\bfseries KAGG RECORD}\\[2pt]
            {\fontsize{9.2}{10}\selectfont\bfseries\kagg@id}
          }%
        }
      \end{minipage}

      \vspace{5.5mm}
      {\color{KaggCrimson}\rule{\textwidth}{1.25pt}}\par
      \vspace{4.5mm}

      {\raggedright\fontsize{21.5}{23.5}\selectfont\bfseries\color{KaggInk}\@title\par}
      \vspace{3mm}
      {\raggedright\sffamily\fontsize{10.4}{12}\selectfont\bfseries\color{KaggInk}\@author\par}
      \ifx\kagg@affiliation\@empty\else
        \vspace{1mm}
        {\raggedright\sffamily\fontsize{8}{9.5}\selectfont\color{KaggMuted}\kagg@affiliation\par}
      \fi

      \vspace{4.5mm}
      \noindent
      \begin{minipage}[t]{0.30\textwidth}\kagg@metacell{Published}{\kagg@published}\end{minipage}%
      \hfill
      \begin{minipage}[t]{0.30\textwidth}\kagg@metacell{Registered}{\kagg@registered}\end{minipage}%
      \hfill
      \begin{minipage}[t]{0.30\textwidth}\kagg@metacell{Record type}{\kagg@type}\end{minipage}
      \vspace{3mm}
      {\color{KaggLine}\rule{\textwidth}{0.5pt}}\par
      \vspace{3.2mm}

      \noindent
      \colorbox{KaggWarm}{%
        \begin{minipage}{\dimexpr\textwidth-2\fboxsep\relax}
          \vspace{1.5mm}
          {\sffamily\fontsize{7.3}{8.3}\selectfont\bfseries\color{KaggCrimson}ABSTRACT}\par
          \vspace{1.2mm}
          {\fontsize{9.25}{11.2}\selectfont\color{KaggInk}\kagg@abstract\par}
          \vspace{1.7mm}
          \ifx\kagg@keywords\@empty\else
            {\sffamily\fontsize{7.2}{8.6}\selectfont\color{KaggMuted}%
              \textbf{\color{KaggInk}INDEX TERMS}\quad \kagg@keywords\par}
          \fi
          \vspace{1.5mm}
        \end{minipage}
      }\par

      \ifx\kagg@claim\@empty\else
        \vspace{2.8mm}
        \noindent
        {\color{KaggCrimson}\rule{2.4mm}{10mm}}\hspace{2.2mm}%
        \begin{minipage}[b]{\dimexpr\textwidth-4.8mm\relax}
          {\sffamily\fontsize{7.5}{9.2}\selectfont\color{KaggInk}%
          \textbf{\color{KaggCrimson}KAGG NOTE}\quad\kagg@claim}
        \end{minipage}
      \fi

      \vspace{4mm}
      {\color{KaggCrimson}\rule{\textwidth}{0.85pt}}\par
      \vspace{3mm}
    \end{@twocolumnfalse}
  }]%
}

\newcommand{\kagg@sectionnumber}{%
  \ifnum\value{section}<10 0\fi\arabic{section}%
}
\titleformat{\section}
  {\sffamily\large\bfseries\color{KaggInk}}
  {\color{KaggCrimson}\fontsize{9}{10}\selectfont\bfseries\kagg@sectionnumber}
  {0.65em}
  {}
  [\vspace{1pt}{\color{KaggLine}\titlerule[0.45pt]}]
\titlespacing*{\section}{0pt}{2.0ex plus .4ex minus .2ex}{0.8ex}

\titleformat{\subsection}
  {\sffamily\normalsize\bfseries\color{KaggInk}}
  {\color{KaggCrimson}\thesubsection}
  {0.55em}
  {}
\titlespacing*{\subsection}{0pt}{1.5ex plus .3ex minus .2ex}{0.45ex}

\titleformat{\subsubsection}
  {\sffamily\small\bfseries\itshape\color{KaggInk}}
  {}
  {0pt}
  {}
\titlespacing*{\subsubsection}{0pt}{1.2ex}{0.35ex}

\captionsetup{
  font={small,sf},
  labelfont={bf,color=KaggCrimson},
  textfont={color=KaggInk},
  justification=raggedright,
  singlelinecheck=false,
  skip=4pt
}

\newenvironment{kaggnote}[1][KAGG NOTE]{%
  \par\medskip
  \noindent{\color{KaggCrimson}\rule{\columnwidth}{0.7pt}}\par
  \vspace{2pt}
  {\sffamily\fontsize{7.2}{8.2}\selectfont\bfseries\color{KaggCrimson}\MakeUppercase{#1}}\par
  \vspace{1pt}
  \begin{list}{}{\setlength{\leftmargin}{0.7em}\setlength{\rightmargin}{0.7em}}
  \item\relax\fontsize{8.6}{10.3}\selectfont\color{KaggInk}
}{%
  \end{list}
  \vspace{-2pt}
  \noindent{\color{KaggLine}\rule{\columnwidth}{0.45pt}}\par
  \medskip
}

\newenvironment{kaggwidetable}[1][]{%
  \begin{table*}[t]
  \centering
  \caption{#1}
  \renewcommand{\arraystretch}{1.14}
  \sffamily\fontsize{7.3}{8.5}\selectfont
}{%
  \end{table*}
}

\setlist[itemize]{leftmargin=1.2em,itemsep=1.5pt,topsep=2pt}
\setlist[enumerate]{leftmargin=1.35em,itemsep=1.8pt,topsep=2pt}
\setlist[description]{leftmargin=0pt,itemsep=1.5pt,topsep=2pt,font=\sffamily\bfseries}

\AtBeginEnvironment{thebibliography}{%
  \small
  \setlength{\itemsep}{1pt}
  \setlength{\parskip}{0pt}
}
\renewcommand{\refname}{References}

\newcommand{\KaggRecordURL}{\kagg@url}
\newcommand{\KaggLicense}{\kagg@license}
\newcommand{\KaggTemplateVersion}{\kagg@version}

\endinput