%% alchemy.cls
%% LaTeX class for the Journal of Alchemy family, published by ScholarLabs AI.
%% https://scholarlabs.ai/journals
%%
%% Usage:  \documentclass[ajcai]{alchemy}
%% Journal options: ajcai, ajeee, ajpre, ajbhs, ajacs, ajet, ajdsa, ajssh, ajbem, ajels
%% Other options:
%%   anonymous   hides authors, affiliations and emails (for double anonymous review)
%%   review      anonymous, plus double spacing and line numbers for reviewers
%%
%% Version 1.1, 2026. Follows the Elsevier research article guidance. Licence: LaTeX Project Public Licence 1.3c.
\NeedsTeXFormat{LaTeX2e}
\ProvidesClass{alchemy}[2026/11/14 v1.1 Journal of Alchemy article class]

% ── Options ─────────────────────────────────────────────────────────────
\newif\if@alc@anon \@alc@anonfalse
\newif\if@alc@review \@alc@reviewfalse
\def\alc@slug{ajcai}
\DeclareOption{ajcai}{\def\alc@slug{ajcai}}
\DeclareOption{ajeee}{\def\alc@slug{ajeee}}
\DeclareOption{ajpre}{\def\alc@slug{ajpre}}
\DeclareOption{ajbhs}{\def\alc@slug{ajbhs}}
\DeclareOption{ajacs}{\def\alc@slug{ajacs}}
\DeclareOption{ajet}{\def\alc@slug{ajet}}
\DeclareOption{ajdsa}{\def\alc@slug{ajdsa}}
\DeclareOption{ajssh}{\def\alc@slug{ajssh}}
\DeclareOption{ajbem}{\def\alc@slug{ajbem}}
\DeclareOption{ajels}{\def\alc@slug{ajels}}
\DeclareOption{anonymous}{\@alc@anontrue}
\DeclareOption{review}{\@alc@anontrue\@alc@reviewtrue}
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}}
\ProcessOptions\relax
\LoadClass[11pt,a4paper,twoside]{article}

% ── Packages ────────────────────────────────────────────────────────────
\RequirePackage[T1]{fontenc}
\RequirePackage[utf8]{inputenc}
\RequirePackage{lmodern}
\RequirePackage{amsmath,amssymb,bm}
\RequirePackage{graphicx}
\RequirePackage[table]{xcolor}
\RequirePackage{geometry}
\RequirePackage{fancyhdr}
\RequirePackage{titlesec}
\RequirePackage{booktabs}
\RequirePackage{caption}
\RequirePackage{enumitem}
\RequirePackage{etoolbox}
\RequirePackage{pgfkeys}
\RequirePackage{marvosym}
\RequirePackage{lastpage}
\RequirePackage{microtype}
\RequirePackage[authoryear,round]{natbib}
\RequirePackage{xurl}
\RequirePackage[hidelinks]{hyperref}
\RequirePackage{orcidlink}
\RequirePackage{setspace}
\if@alc@review \RequirePackage[pagewise]{lineno} \fi

% ── The ten journals ────────────────────────────────────────────────────
% \alc@define{slug}{full name}{abbreviation}{subject}{colour hex}
\newcommand\alc@define[5]{%
  \expandafter\def\csname alc@name@#1\endcsname{#2}%
  \expandafter\def\csname alc@abbr@#1\endcsname{#3}%
  \expandafter\def\csname alc@subj@#1\endcsname{#4}%
  \expandafter\def\csname alc@col@#1\endcsname{#5}}
\alc@define{ajcai}{Alchemy of Computer Science and Artificial Intelligence}{ACAI}{Computer Science}{1F52E0}
\alc@define{ajeee}{Alchemy of Electrical and Electronic Engineering}{AEEE}{Electrical and Electronic Engineering}{0E7490}
\alc@define{ajpre}{Alchemy of Power Systems and Renewable Energy}{APRE}{Power and Energy}{A16207}
\alc@define{ajbhs}{Alchemy of Biomedical and Health Sciences}{ABHS}{Medicine and Health}{DC2626}
\alc@define{ajacs}{Alchemy of Agriculture and Climate Science}{AACS}{Agriculture and Environment}{059669}
\alc@define{ajet}{Alchemy of Engineering and Technology}{AET}{Engineering}{C2410C}
\alc@define{ajdsa}{Alchemy of Data Science and Analytics}{ADSA}{Data Science}{7C3AED}
\alc@define{ajssh}{Alchemy of Social Sciences and Humanities}{ASSH}{Social Sciences}{0F766E}
\alc@define{ajbem}{Alchemy of Business, Economics and Management}{ABEM}{Business Studies}{334155}
\alc@define{ajels}{Alchemy of Education and Learning Sciences}{AELS}{Education}{2563EB}
\edef\journalname{\csname alc@name@\alc@slug\endcsname}
\edef\journalabbr{\csname alc@abbr@\alc@slug\endcsname}
\edef\journalsubject{\csname alc@subj@\alc@slug\endcsname}
\definecolor{alcjc}{HTML}{\csname alc@col@\alc@slug\endcsname}
\definecolor{alcink}{HTML}{14192B}
\definecolor{alcgrey}{HTML}{5B6476}
\definecolor{alcrule}{HTML}{C9CED8}
\definecolor{alclink}{HTML}{1F52E0}
\hypersetup{colorlinks=true,linkcolor=alcink,citecolor=alclink,urlcolor=alclink,
  pdfcreator={alchemy.cls (ScholarLabs AI)}}

% ── Article metadata (most are filled by the editorial office) ──────────
\def\alc@doi{10.xxxxx/\journalabbr.YYYY.NNNN}
\def\alc@volume{1}\def\alc@issue{1}\def\alc@year{\the\year}
\def\alc@received{dd Month yyyy}\def\alc@revised{dd Month yyyy}
\def\alc@accepted{dd Month yyyy}\def\alc@published{dd Month yyyy}
\def\alc@type{Research Article}
\def\alc@runningtitle{}\def\alc@runningauthor{}
\def\alc@keywords{}
\newcommand\doi[1]{\def\alc@doi{#1}}
\newcommand\volume[1]{\def\alc@volume{#1}}
\newcommand\issue[1]{\def\alc@issue{#1}}
\newcommand\pubyear[1]{\def\alc@year{#1}}
\newcommand\articletype[1]{\def\alc@type{#1}}
\newcommand\received[1]{\def\alc@received{#1}}
\newcommand\revised[1]{\def\alc@revised{#1}}
\newcommand\accepted[1]{\def\alc@accepted{#1}}
\newcommand\published[1]{\def\alc@published{#1}}
\newcommand\runningtitle[1]{\def\alc@runningtitle{#1}}
\newcommand\runningauthor[1]{\def\alc@runningauthor{#1}}
\newcommand\keywords[1]{\def\alc@keywords{#1}}
% \doi{...} inside the bibliography prints a DOI link.
\newcommand\alc@doilink[1]{\href{https://doi.org/#1}{doi:\,\nolinkurl{#1}}}

% ── Authors and affiliations ────────────────────────────────────────────
% \author[affil={a,b}, orcid=0000-0000-0000-0000, email=name@uni.edu, corresponding]{Given Family}
% \affiliation[a]{Department, Institution, Full postal address, Country}
\newcounter{alc@nauth}
\def\alc@authorlist{}\def\alc@emaillist{}\def\alc@affillist{}\def\alc@firstsurname{}
\pgfkeys{/alc/author/.is family,/alc/author,
  affil/.store in=\alc@k@affil, orcid/.store in=\alc@k@orcid,
  email/.store in=\alc@k@email, corresponding/.code={\def\alc@k@corr{1}}}
\renewcommand\author[2][]{%
  \def\alc@k@affil{}\def\alc@k@orcid{}\def\alc@k@email{}\def\alc@k@corr{}%
  \pgfkeys{/alc/author,#1}%
  \stepcounter{alc@nauth}%
  \ifnum\value{alc@nauth}=1 \def\alc@firstsurname{#2}\fi
  \edef\alc@tmpaffil{\alc@k@affil}\edef\alc@tmporcid{\alc@k@orcid}%
  \edef\alc@tmpemail{\alc@k@email}\edef\alc@tmpcorr{\alc@k@corr}%
  \xappto\alc@authorlist{\noexpand\alc@oneauthor{\unexpanded{#2}}{\alc@tmpaffil}{\alc@tmporcid}{\alc@tmpcorr}}%
  \ifx\alc@tmpemail\@empty\else
    \xappto\alc@emaillist{\noexpand\alc@oneemail{\unexpanded{#2}}{\alc@tmpemail}{\alc@tmpcorr}}%
  \fi}
\newcommand\affiliation[2][]{\appto\alc@affillist{\alc@oneaffil{#1}{#2}}}
\newif\if@alc@firstauthor
\newcommand\alc@oneauthor[4]{%
  \if@alc@firstauthor\@alc@firstauthorfalse\else\,\textperiodcentered\space\fi
  \mbox{#1\textsuperscript{#2}%
  \ifx\relax#4\relax\else\textsuperscript{\,\Letter}\fi
  \ifx\relax#3\relax\else\,\orcidlink{#3}\fi}}
\newcommand\alc@oneemail[3]{%
  \par\noindent\makebox[1.4em][l]{\ifx\relax#3\relax\else\Letter\fi}#1\\
  \hspace*{1.4em}\href{mailto:#2}{\nolinkurl{#2}}}
\newcommand\alc@oneaffil[2]{%
  \par\noindent\makebox[1.4em][l]{\textsuperscript{#1}}%
  \parbox[t]{\dimexpr\linewidth-1.4em}{\raggedright #2}}

% ── Page layout ─────────────────────────────────────────────────────────
\geometry{a4paper,top=30mm,bottom=28mm,inner=27mm,outer=27mm,headsep=9mm,footskip=12mm}
\setlength{\parindent}{1.2em}
\setlength{\parskip}{0pt}
\linespread{1.08}
\if@alc@review \doublespacing \linenumbers \fi
\if@alc@review \renewcommand\linenumberfont{\normalfont\tiny\sffamily\color{alcgrey}}\fi
\setlist{itemsep=2pt,topsep=4pt,leftmargin=1.6em}

% Running heads: even pages author, odd pages short title; footer journal and page.
\pagestyle{fancy}
\fancyhf{}
\renewcommand\headrulewidth{0.5pt}
\renewcommand\headrule{{\color{alcink}\hrule height\headrulewidth width\headwidth}\vspace{-\headrulewidth}}
\fancyhead[LE]{\small\color{alcink}\ifx\alc@runningauthor\@empty\alc@firstsurname\ et al.\else\alc@runningauthor\fi}
\fancyhead[RE]{\small\color{alcgrey}\journalabbr\ \alc@volume\,(\alc@issue), \alc@year}
\fancyhead[LO]{\small\color{alcgrey}\textit{\journalname}}
\fancyhead[RO]{\small\color{alcink}\ifx\alc@runningtitle\@empty Article\else\alc@runningtitle\fi}
\fancyfoot[LE,RO]{\small\color{alcink}\textbf{\thepage}\ \color{alcgrey}of \pageref*{LastPage}}
\fancyfoot[RE,LO]{\footnotesize\color{alcgrey}\href{https://doi.org/\alc@doi}{\nolinkurl{https://doi.org/\alc@doi}}}
\fancypagestyle{alcfirst}{%
  \fancyhf{}\renewcommand\headrulewidth{0pt}%
  \fancyfoot[R]{\small\color{alcink}\textbf{\thepage}\ \color{alcgrey}of \pageref*{LastPage}}%
  \fancyfoot[L]{\footnotesize\color{alcgrey}\copyright\ The author(s) \alc@year. Published by ScholarLabs AI under CC BY 4.0.}}
\if@alc@anon
  \fancyhead[LE]{\small\color{alcink}Anonymous manuscript}
\fi

% ── Section headings ────────────────────────────────────────────────────
\titleformat{\section}{\normalfont\large\bfseries\color{alcink}}{\thesection.}{0.6em}{}
\titleformat{\subsection}{\normalfont\normalsize\bfseries\color{alcink}}{\thesubsection.}{0.6em}{}
\titleformat{\subsubsection}{\normalfont\normalsize\itshape\color{alcink}}{\thesubsubsection.}{0.5em}{}
\titleformat{\paragraph}[runin]{\normalfont\normalsize\bfseries\color{alcink}}{}{0pt}{}[.]
\titlespacing*{\section}{0pt}{2.2ex plus .5ex minus .2ex}{1.2ex plus .2ex}
\titlespacing*{\subsection}{0pt}{1.8ex plus .4ex minus .2ex}{0.9ex plus .2ex}
\titlespacing*{\subsubsection}{0pt}{1.5ex plus .3ex minus .2ex}{0.7ex plus .2ex}
\titlespacing*{\paragraph}{0pt}{1.2ex plus .3ex}{0.6em}

% Appendix: lettered sections, figures and tables numbered A1, A2 ...
\g@addto@macro\appendix{%
  \section*{Appendix}%
  \renewcommand\thefigure{\thesection\arabic{figure}}%
  \renewcommand\thetable{\thesection\arabic{table}}%
  \renewcommand\theequation{\thesection\arabic{equation}}%
  \setcounter{figure}{0}\setcounter{table}{0}\setcounter{equation}{0}%
  \pretocmd{\section}{\setcounter{figure}{0}\setcounter{table}{0}\setcounter{equation}{0}}{}{}}

% A missing image prints a labelled placeholder instead of stopping the build,
% so main.tex compiles even when the figures folder was not downloaded.
\let\alc@includegraphics\includegraphics
\renewcommand\includegraphics[2][]{%
  \IfFileExists{#2}{\alc@includegraphics[#1]{#2}}{%
    \fcolorbox{alcrule}{alcrule!25}{\parbox[c][0.28\linewidth][c]{0.55\linewidth}{\centering\footnotesize\color{alcgrey}Figure file\\\texttt{\detokenize{#2}}}}}}

% ── Floats ──────────────────────────────────────────────────────────────
\captionsetup{font=footnotesize,labelfont={bf,color=alcink},labelsep=period,justification=justified,singlelinecheck=true}
\captionsetup[table]{position=top,skip=4pt}
\captionsetup[figure]{skip=6pt}
\renewcommand\figurename{Figure}
\renewcommand\tablename{Table}
\setlength{\abovecaptionskip}{6pt}
\renewcommand\arraystretch{1.12}

% ── Title block ─────────────────────────────────────────────────────────
\renewcommand\maketitle{%
  \thispagestyle{alcfirst}%
  \begingroup
  % Journal masthead
  \noindent{\color{alcjc}\rule{\linewidth}{3pt}}\par\vspace{5pt}
  \noindent\begin{minipage}[t]{0.68\linewidth}\raggedright
    {\small\bfseries\color{alcink}\journalname}\\[1pt]
    {\footnotesize\color{alcgrey}\journalabbr\ \textperiodcentered\ Volume \alc@volume, Issue \alc@issue\ \textperiodcentered\ \alc@year}\\[1pt]
    {\footnotesize\color{alcgrey}DOI:\ \href{https://doi.org/\alc@doi}{\nolinkurl{\alc@doi}}}
  \end{minipage}\hfill
  \begin{minipage}[t]{0.3\linewidth}\raggedleft
    {\footnotesize\bfseries\color{alcjc}\MakeUppercase{\alc@type}}\\[1pt]
    {\footnotesize\color{alcgrey}Open access \textperiodcentered\ Peer reviewed}\\[1pt]
    {\footnotesize\color{alcgrey}ScholarLabs AI}
  \end{minipage}\par
  \vspace{4pt}{\color{alcink}\hrule height .5pt}\par
  \vspace{18pt}
  % Title
  {\raggedright\LARGE\bfseries\color{alcink}\@title\par}
  \vspace{12pt}
  % Authors
  \if@alc@anon
    {\large\color{alcgrey}Authors removed for double anonymous review\par}
  \else
    {\normalsize\bfseries\color{alcink}\raggedright\@alc@firstauthortrue\alc@authorlist\par}
  \fi
  \vspace{8pt}
  % Dates and licence
  {\footnotesize\color{alcgrey}
   Received:\ \alc@received\quad Revised:\ \alc@revised\quad Accepted:\ \alc@accepted\quad Published:\ \alc@published\par
   \vspace{2pt}\copyright\ The author(s) \alc@year. This article is open access under the
   \href{https://creativecommons.org/licenses/by/4.0/}{Creative Commons Attribution 4.0 International licence (CC BY 4.0)}.\par}
  \vspace{14pt}
  \endgroup
  % Corresponding author, emails and affiliations at the foot of page one
  \if@alc@anon\else
  \begingroup
    \let\thefootnote\relax
    \footnotetext{\footnotesize\setlength{\parskip}{3pt}%
      \alc@emaillist\par\vspace{5pt}\alc@affillist}%
  \endgroup
  \fi
  \setcounter{footnote}{0}}

\renewcommand\footnoterule{\noindent{\color{alcink}\rule{0.32\linewidth}{0.4pt}}\vspace{6pt}}

% Abstract with Keywords underneath
\renewenvironment{abstract}{%
  \par\noindent{\color{alcjc}\vrule width 2.5pt}\hspace{10pt}%
  \begin{minipage}{\dimexpr\linewidth-12.5pt}\small
  \noindent\textbf{\color{alcink}Abstract}\quad\ignorespaces}%
 {\ifx\alc@keywords\@empty\else\par\vspace{6pt}\noindent\textbf{\color{alcink}Keywords:}\ \alc@keywords\fi
  \end{minipage}\par\vspace{14pt}}

% ── Back matter: declarations required by the journal ──────────────────
% Short labelled statements set in a smaller size, as in the reference style.
\newcommand\alc@statement[2]{\par\vspace{5pt}\noindent{\small\textbf{\color{alcink}#1}\quad #2}\par}
\newenvironment{acknowledgements}{\par\vspace{8pt}\noindent\small\textbf{\color{alcink}Acknowledgements}\quad}{\par\normalsize}
\newcommand\declarations{\section*{Declarations}}
\newenvironment{authorcontributions}{\par\vspace{5pt}\noindent\small\textbf{\color{alcink}Author statement (CRediT)}\quad}{\par\normalsize}
\newenvironment{funding}{\par\vspace{5pt}\noindent\small\textbf{\color{alcink}Funding}\quad}{\par\normalsize}
\newenvironment{conflict}{\par\vspace{5pt}\noindent\small\textbf{\color{alcink}Conflict of interest}\quad}{\par\normalsize}
\newenvironment{ethics}{\par\vspace{5pt}\noindent\small\textbf{\color{alcink}Ethics approval and consent}\quad}{\par\normalsize}
\newenvironment{dataavailability}{\par\vspace{5pt}\noindent\small\textbf{\color{alcink}Data availability}\quad}{\par\normalsize}
\newenvironment{codeavailability}{\par\vspace{5pt}\noindent\small\textbf{\color{alcink}Code availability}\quad}{\par\normalsize}
\newenvironment{materialsavailability}{\par\vspace{5pt}\noindent\small\textbf{\color{alcink}Materials availability}\quad}{\par\normalsize}
\newenvironment{aiuse}{\par\vspace{5pt}\noindent\small\textbf{\color{alcink}Use of AI tools}\quad}{\par\normalsize}

% Highlights: 3 to 5 bullets of at most 85 characters. Shown on the first page of the
% example; for submission, also send them as a separate file named "Highlights".
\newenvironment{highlights}{%
  \par\noindent\begin{minipage}{\linewidth}\small
  \textbf{\color{alcink}Highlights}\vspace{2pt}
  \begin{itemize}[leftmargin=1.2em,itemsep=1pt,topsep=2pt,label={\color{alcjc}\textbullet}]}%
 {\end{itemize}\end{minipage}\par\vspace{12pt}}

% ── References ──────────────────────────────────────────────────────────
\renewcommand\bibname{References}
\renewcommand\refname{References}
\setlength{\bibsep}{2pt plus 1pt}
\setlength{\bibhang}{1.2em}
\renewcommand\bibfont{\footnotesize}
\AtBeginDocument{\let\doi\alc@doilink}
\bibliographystyle{alchemy}

\endinput