% ==============================================================================
% preamble/packages.tex
% Modular LaTeX Architecture - External Packages
% ==============================================================================

\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}

% --- Mathematical AMS Ecosystem ---
\usepackage{amsmath}
\usepackage{amssymb}
\usepackage{amsfonts}
\usepackage{amsthm}
\usepackage{mathtools}
\usepackage{bm}

% --- Page Layout & Typographic Hygiene ---
\usepackage[a4paper,top=2.8cm,bottom=2.8cm,left=2.8cm,right=2.8cm]{geometry}
\usepackage[expansion=false]{microtype}
\usepackage{graphicx}
\usepackage{booktabs}
\usepackage{array}
\usepackage{makecell}
\usepackage{enumitem}

% --- Color Palette (Subtle Academic Tones) ---
\usepackage{xcolor}
\definecolor{NavyBlue}{RGB}{11, 60, 116}
\definecolor{AcademicPurple}{RGB}{92, 37, 102}
\definecolor{LeanBlue}{RGB}{24, 76, 120}
\definecolor{PythonGreen}{RGB}{20, 90, 50}
\definecolor{PythonSlate}{RGB}{35, 95, 70}
\definecolor{PythonMuted}{RGB}{95, 110, 125}
\definecolor{BadgeGray}{RGB}{245, 247, 250}
\definecolor{BorderGray}{RGB}{210, 215, 224}
\definecolor{DarkSlate}{RGB}{35, 45, 55}

% --- Code Listings & Advanced Typographic Boxes ---
\usepackage{tikz}
\usetikzlibrary{positioning}
\usepackage[skins,breakable]{tcolorbox}
\usepackage{varwidth}

% --- Hyperlinks & Metadata ---
% Note arXiv FAQ: If automated processing reports ps2pdf failure on deep section/appendix counts,
% switch bookmarks=true to bookmarks=false below while keeping colorlinks active.
\usepackage[
    colorlinks=true,
    linkcolor=NavyBlue,
    citecolor=AcademicPurple,
    urlcolor=NavyBlue,
    bookmarks=true,
    bookmarksnumbered=true,
    pdfstartview=FitH
]{hyperref}
\usepackage{bookmark}

% --- Bibliography Management (BibTeX compatible) ---
\usepackage[numbers,sort&compress]{natbib}