@anja.codes/vitakit 0.1.0

package/dist/styles/vitakit-math.csl

@@ -0,0 +1,314 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  The vitakit default style for content/publications.bib on the website.
+
+  To change it, copy it into your project and edit the copy:
+
+      pnpm vitakit eject publications.csl    # -> content/publications.csl
+
+  content/publications.csl is picked up automatically, by the dev server, the
+  build and vitakit-check alike. Any CSL 1.0 style works there, for instance one
+  from https://www.zotero.org/styles saved under that name.
+
+  Links are not this file's job. vitakit links the title (to the url, doi or
+  arxiv field, in that order) and appends badges (DOI, arXiv, MR, zbMATH), and
+  it removes those identifiers from what the style sees, so that a style which
+  prints them does not repeat them as raw text. A <text variable="DOI"/> or
+  <text variable="URL"/> here therefore prints nothing for an entry whose DOI
+  or URL is already linked.
+
+  The PDF does not use this file: it is typeset by biblatex.
+-->
+<style xmlns="http://purl.org/net/xbiblio/csl" class="in-text" version="1.0" demote-non-dropping-particle="sort-only">
+  <info>
+    <title>vitakit (mathematics)</title>
+    <id>https://github.com/anja-codes/vitakit/styles/vitakit-math</id>
+    <author>
+      <name>Benjamin Hackl</name>
+    </author>
+    <summary>Numeric style for mathematics: author-year ordering, linked titles, short journal information.</summary>
+    <category citation-format="numeric"/>
+    <category field="engineering"/>
+    <category field="generic-base"/>
+    <updated>2026-09-25T00:00:00+00:00</updated>
+    <rights license="http://creativecommons.org/licenses/by-sa/3.0/">This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 License</rights>
+  </info>
+  <locale xml:lang="en">
+    <terms>
+      <term name="chapter" form="short">ch.</term>
+      <term name="presented at">presented at the</term>
+    </terms>
+  </locale>
+  <!-- Macros -->
+  <macro name="edition">
+    <choose>
+      <if type="bill book chapter graphic legal_case legislation motion_picture paper-conference report song" match="any">
+        <choose>
+          <if is-numeric="edition">
+            <group delimiter=" ">
+              <number variable="edition" form="ordinal"/>
+              <text term="edition" form="short"/>
+            </group>
+          </if>
+          <else>
+            <text variable="edition" text-case="capitalize-first" suffix="."/>
+          </else>
+        </choose>
+      </if>
+    </choose>
+  </macro>
+  <macro name="issued">
+    <choose>
+      <if type="article-journal report" match="any">
+        <date variable="issued">
+          <date-part name="month" form="short" suffix=" "/>
+          <date-part name="year" form="long"/>
+        </date>
+      </if>
+      <else-if type=" bill book chapter graphic legal_case legislation motion_picture paper-conference song thesis" match="any">
+        <date variable="issued">
+          <date-part name="year" form="long"/>
+        </date>
+      </else-if>
+      <else>
+        <date variable="issued">
+          <date-part name="day" form="numeric-leading-zeros" suffix="-"/>
+          <date-part name="month" form="short" suffix="-" strip-periods="true"/>
+          <date-part name="year" form="long"/>
+        </date>
+      </else>
+    </choose>
+  </macro>
+  <macro name="author">
+    <names variable="author">
+      <name delimiter=", " and="text"/>
+      <label form="short" prefix=", " text-case="capitalize-first"/>
+      <substitute>
+        <names variable="editor"/>
+        <names variable="translator"/>
+      </substitute>
+    </names>
+  </macro>
+  <macro name="editor">
+    <names variable="editor">
+      <name initialize-with=". " delimiter=", " and="text"/>
+      <label form="short" prefix=", " text-case="capitalize-first"/>
+    </names>
+  </macro>
+  <macro name="locators">
+    <group delimiter=", ">
+      <text macro="edition"/>
+      <group delimiter=" ">
+        <text term="volume" form="short"/>
+        <number variable="volume" form="numeric" font-weight="bold"/>
+      </group>
+      <group delimiter=" ">
+        <number variable="number-of-volumes" form="numeric"/>
+        <text term="volume" form="short" plural="true"/>
+      </group>
+      <group delimiter=" ">
+        <text term="issue" form="short"/>
+        <number variable="issue" form="numeric"/>
+      </group>
+    </group>
+  </macro>
+  <macro name="title">
+    <!-- Title linking is handled by @behackl/citation-js-extras at render time;
+         the CSL just outputs the plain italic title text. -->
+    <text variable="title" font-style="italic"/>
+  </macro>
+  <macro name="publisher">
+    <choose>
+      <if type=" bill book chapter graphic legal_case legislation motion_picture paper-conference song" match="any">
+        <group delimiter=": ">
+          <text variable="publisher-place"/>
+          <text variable="publisher"/>
+        </group>
+      </if>
+      <else>
+        <group delimiter=", ">
+          <text variable="publisher"/>
+          <text variable="publisher-place"/>
+        </group>
+      </else>
+    </choose>
+  </macro>
+  <macro name="event">
+    <choose>
+      <if type="paper-conference speech" match="any">
+        <choose>
+          <!-- Published Conference Paper -->
+          <if variable="container-title">
+            <group delimiter=", ">
+              <group delimiter=" ">
+                <text term="in"/>
+                <text variable="container-title" font-style="italic"/>
+              </group>
+              <text variable="event-place"/>
+            </group>
+          </if>
+          <!-- Unpublished Conference Paper -->
+          <else>
+            <group delimiter=", ">
+              <group delimiter=" ">
+                <text term="presented at"/>
+                <text variable="event"/>
+              </group>
+              <text variable="event-place"/>
+            </group>
+          </else>
+        </choose>
+      </if>
+    </choose>
+  </macro>
+  <macro name="page">
+    <group>
+      <label variable="page" form="short" suffix=" "/>
+      <text variable="page"/>
+    </group>
+  </macro>
+  <macro name="citation-locator">
+    <group delimiter=" ">
+      <choose>
+        <if locator="page">
+          <label variable="locator" form="short"/>
+        </if>
+        <else>
+          <label variable="locator" form="short" text-case="capitalize-first"/>
+        </else>
+      </choose>
+      <text variable="locator"/>
+    </group>
+  </macro>
+  <!-- Citation -->
+  <citation collapse="citation-number">
+    <sort>
+      <key variable="citation-number"/>
+    </sort>
+    <layout delimiter=", ">
+      <group prefix="[" suffix="]" delimiter=", ">
+        <text variable="citation-number"/>
+        <text macro="citation-locator"/>
+      </group>
+    </layout>
+  </citation>
+  <!-- Bibliography -->
+  <bibliography entry-spacing="0">
+    <layout>
+      <!-- Author(s) -->
+      <text macro="author" suffix=", "/>
+      <!-- Rest of Citation -->
+      <group suffix=". ">
+        <choose>
+          <!-- Specific Formats -->
+          <if type="article-journal">
+            <group delimiter=", ">
+              <text macro="title"/>
+              <text variable="container-title" font-style="italic" form="short"/>
+              <text macro="locators"/>
+              <text macro="page"/>
+              <text macro="issued"/>
+            </group>
+          </if>
+          <else-if type="paper-conference">
+            <group delimiter=", ">
+              <text macro="title"/>
+              <text macro="event"/>
+              <text macro="issued"/>
+              <text macro="locators"/>
+              <text macro="page"/>
+            </group>
+          </else-if>
+          <else-if type="report">
+            <group delimiter=", ">
+              <text macro="title"/>
+              <text macro="publisher"/>
+              <group delimiter=" ">
+                <text variable="genre"/>
+                <text variable="number"/>
+              </group>
+              <text macro="issued"/>
+            </group>
+          </else-if>
+          <else-if type="thesis">
+            <group delimiter=", ">
+              <text macro="title"/>
+              <text variable="genre"/>
+              <text macro="publisher"/>
+              <text macro="issued"/>
+            </group>
+          </else-if>
+          <else-if type="webpage">
+            <group delimiter=", ">
+              <text macro="title"/>
+              <text variable="container-title" font-style="italic"/>
+              <text macro="issued"/>
+            </group>
+          </else-if>
+          <else-if type="patent">
+            <group delimiter=", ">
+              <text macro="title"/>
+              <text variable="number"/>
+              <text macro="issued"/>
+            </group>
+          </else-if>
+          <!-- Generic/Fallback Formats -->
+          <else-if type="bill book graphic legal_case legislation motion_picture report song" match="any">
+            <group delimiter=", " suffix=". ">
+              <text macro="title"/>
+              <text macro="locators"/>
+            </group>
+            <group delimiter=", ">
+              <text macro="publisher"/>
+              <text macro="issued"/>
+              <text macro="page"/>
+            </group>
+          </else-if>
+          <else-if type="article-magazine article-newspaper broadcast interview manuscript map patent personal_communication song speech thesis webpage" match="any">
+            <group delimiter=", ">
+              <text macro="title"/>
+              <text variable="container-title" font-style="italic"/>
+              <text macro="locators"/>
+              <text macro="publisher"/>
+              <text macro="page"/>
+              <text macro="issued"/>
+            </group>
+          </else-if>
+          <else-if type="chapter paper-conference" match="any">
+            <group delimiter=", " suffix=", ">
+              <text macro="title"/>
+              <group delimiter=" ">
+                <text term="in"/>
+                <text variable="container-title" font-style="italic"/>
+              </group>
+              <text macro="locators"/>
+            </group>
+            <text macro="editor" suffix=" "/>
+            <group delimiter=", ">
+              <text macro="publisher"/>
+              <text macro="issued"/>
+              <text macro="page"/>
+            </group>
+          </else-if>
+          <else>
+            <group delimiter=", " suffix=". ">
+              <text macro="title"/>
+              <text variable="container-title" font-style="italic"/>
+              <text macro="locators"/>
+              <choose>
+                <if variable="note">
+                  <text variable="note"/>
+                </if>
+              </choose>
+            </group>
+            <group delimiter=", ">
+              <text macro="publisher"/>
+              <text macro="page"/>
+              <text macro="issued"/>
+            </group>
+          </else>
+        </choose>
+      </group>
+    </layout>
+  </bibliography>
+</style>

package/dist/tex/templates/_generic.eta

@@ -0,0 +1,6 @@
+<% for (const item of it.entries) { %>
+\vitaentry{<%~ it.date(item.date) %>}{<%~ it.rich(it.titleOf(item)) %>}{<%~ it.secondaryOf(item) %>}
+<% if (item.note) { %>
+  \vitanote{<%~ it.rich(item.note) %>}
+<% } %>
+<% } %>

package/dist/tex/templates/education.eta

@@ -0,0 +1,9 @@
+<% for (const item of it.entries) { %>
+\vitaentry{<%~ it.date(item.date) %>}{<%~ it.rich(item.degree) %>}{<%~ it.inst(item.institution) %>}
+<% if (item.thesis) { %>
+  \vitanote{<%~ it.tex(item.thesis.type ?? 'Thesis') %>: \emph{<%~ it.rich(item.thesis.title) %>}<% if (item.thesis.supervisor) { %>, supervised by <%~ it.linkOrText(item.thesis.supervisor) %><% } %>}
+<% } %>
+<% if (item.note) { %>
+  \vitanote{<%~ it.rich(item.note) %>}
+<% } %>
+<% } %>

package/dist/tex/templates/employment.eta

@@ -0,0 +1,9 @@
+<% for (const item of it.entries) { %>
+\vitaentry{<%~ it.date(item.date) %>}{<%~ it.rich(item.position) %>}{<%~ it.inst(item.institution) %>}
+<% if (item.project) { %>
+  \vitanote{Project <% if (item.project.url) { %>\href{<%~ it.url(item.project.url) %>}{\emph{<%~ it.rich(item.project.title) %>}}<% } else { %>\emph{<%~ it.rich(item.project.title) %>}<% } %><% if (item.project.funder) { %> (<%~ it.tex(item.project.funder) %><% if (item.project.grant) { %>~<%~ it.tex(item.project.grant) %><% } %>)<% } %>}
+<% } %>
+<% if (item.note) { %>
+  \vitanote{<%~ it.rich(item.note) %>}
+<% } %>
+<% } %>

package/dist/tex/templates/publications.eta

@@ -0,0 +1,7 @@
+\begin{refsection}
+\nocite{*}
+<% for (const group of it.groups) { %>
+<%~ it.bibgroup(group) %>
+\printbibliography[check=vita-<%~ group.id %>, title={<%~ it.tex(group.label) %>}, heading=subbibliography]
+<% } %>
+\end{refsection}

package/dist/tex/templates/supervision.eta

@@ -0,0 +1,4 @@
+<% for (const item of it.entries) { %>
+\vitaentry{<%~ it.date(item.date) %><% if (item.ongoing) { %>--<% } %>}{<%~ it.tex(item.student) %>}{<%~ [item.degree && it.tex(item.degree), it.inst(item.institution)].filter(Boolean).join(', ') %>}
+  \vitanote{\emph{<%~ it.rich(item.title) %>}<% if (item.coSupervisor) { %>, with <%~ it.tex(item.coSupervisor) %><% } %><% if (item.ongoing) { %> (in progress)<% } %>}
+<% } %>

package/dist/tex/templates/talks.eta

@@ -0,0 +1,3 @@
+<% for (const item of it.entries) { %>
+\vitaentry{<%~ it.date(item.date) %>}{<%~ it.rich(item.title) %>}{<%~ [item.event && it.tex(item.event), item.location && it.tex(item.location)].filter(Boolean).join(', ') %>}
+<% } %>

package/dist/tex/templates/teaching.eta

@@ -0,0 +1,6 @@
+<% for (const item of it.entries) { %>
+\vitaentry{<%~ it.term(item) %>}{<%~ it.rich(item.title) %>}{<%~ [item.role, it.inst(item.institution)].filter(Boolean).join(', ') %>}
+<% if (item.note) { %>
+  \vitanote{<%~ it.rich(item.note) %>}
+<% } %>
+<% } %>

package/dist/tex/vitakit-cv.cls

@@ -0,0 +1,119 @@
+%% vitakit-cv.cls -- document class for CVs generated by vitakit.
+%%
+%% The generated section files only ever use the macros defined here, so the
+%% entire visual design can be changed by redefining them in preamble.tex
+%% without touching anything vitakit produces.
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesClass{vitakit-cv}[2026/01/01 vitakit CV class]
+
+%% Options must be declared and processed before the base class is loaded.
+\newif\ifvita@bib \vita@bibtrue
+\DeclareOption{nobib}{\vita@bibfalse}
+\DeclareOption*{\PassOptionsToClass{\CurrentOption}{article}}
+\ProcessOptions\relax
+\LoadClass[11pt,a4paper]{article}
+
+\RequirePackage[margin=2.5cm]{geometry}
+\RequirePackage{enumitem}
+\RequirePackage{xcolor}
+\RequirePackage{titlesec}
+\RequirePackage{amsmath,amssymb}
+\RequirePackage{hyperref}
+
+%% --- bibliography ---------------------------------------------------------
+%% biblatex is loaded here so that a CV needs no bibliography setup at all.
+%% Pass [nobib] to the class and load it yourself to use a different style.
+\ifvita@bib
+  \RequirePackage[backend=biber, style=numeric, sorting=ydnt,
+                  defernumbers=true, maxbibnames=99, giveninits=true]{biblatex}
+  %% \vitabibgroup{id}{key,key,...} defines the bibliography check `vita-id`,
+  %% which keeps exactly the listed entries. The generated publications.tex
+  %% uses one per group: vitakit decides the groups, with the website's rules
+  %% (a missing `status` is `published`, case does not matter), so the PDF
+  %% lists what the website lists. Keys are compared as strings.
+  \newcommand{\vitabibgroup}[2]{%
+    \defbibcheck{vita-#1}{%
+      \edef\vita@bibkey{\thefield{entrykey}}%
+      \def\vita@bibfound{0}%
+      \forcsvlist{\vita@bibmatch}{#2}%
+      \ifnum\vita@bibfound=0 \skipentry\fi}}
+  \newcommand{\vita@bibmatch}[1]{%
+    \expandafter\ifstrequal\expandafter{\vita@bibkey}{#1}{\def\vita@bibfound{1}}{}}
+  %% `status` is also copied to `keywords`, for hand-written
+  %% \printbibliography[keyword=...] calls.
+  \DeclareSourcemap{\maps[datatype=bibtex]{
+    \map{\step[fieldsource=status, fieldtarget=keywords]}
+    %% The same custom fields the website turns into badges. `final` stops the
+    %% map for entries without the field, which must not become arXiv eprints.
+    \map{\step[fieldsource=arxiv, final]
+         \step[fieldsource=arxiv, fieldtarget=eprint]
+         \step[fieldset=eprinttype, fieldvalue=arxiv]}
+    %% biblatex expects a bare DOI; exports also write doi:10... or a URL.
+    \map{\step[fieldsource=doi,
+               match=\regexp{\A(doi:\s*|https?://(dx\.)?doi\.org/)}, replace={}]}
+  }}
+\fi
+
+\definecolor{vitalink}{HTML}{1D4ED8}
+\definecolor{vitamuted}{HTML}{555555}
+\hypersetup{colorlinks=true, urlcolor=vitalink, linkcolor=vitalink, pdfborder={0 0 0}}
+
+%% --- document selection --------------------------------------------------
+%% \vitadocument{name} points \vitasection at cv-tex/generated/<name>/.
+\newcommand{\vitadocument}[1]{\def\vita@document{#1}}
+\vitadocument{cv}
+
+%% --- data from content/profile.yml ---------------------------------------
+\newcommand{\vitaname}[1]{\def\vita@name{#1}}
+\newcommand{\vitatagline}[1]{\def\vita@tagline{#1}}
+\newcommand{\vitacontact}[1]{\def\vita@contact{#1}}
+\vitaname{} \vitatagline{} \vitacontact{}
+
+\newcommand{\vitaheader}{%
+  \begingroup
+  \noindent{\LARGE\bfseries\vita@name}\par
+  \ifx\vita@tagline\empty\else\vspace{0.2em}\noindent{\color{vitamuted}\vita@tagline}\par\fi
+  \ifx\vita@contact\empty\else\vspace{0.2em}\noindent{\small\vita@contact}\par\fi
+  \vspace{1em}\hrule\vspace{1.5em}
+  \endgroup}
+
+%% --- sections ------------------------------------------------------------
+%% Section headings are real \section commands, so the table of contents and
+%% PDF bookmarks work as usual.
+\titleformat{\section}{\large\bfseries}{}{0pt}{}
+\titlespacing*{\section}{0pt}{1.4em}{0.6em}
+
+%% Per-document heading overrides: \vitasectiontitle{teaching}{Courses taught}
+\newcommand{\vitasectiontitle}[2]{\expandafter\def\csname vita@title@#1\endcsname{#2}}
+\newcommand{\vita@titlefor}[1]{%
+  \ifcsname vita@title@#1\endcsname\csname vita@title@#1\endcsname\else#1\fi}
+
+\newenvironment{vitaentries}
+  {\begin{list}{}{%
+     \setlength{\leftmargin}{7em}\setlength{\labelwidth}{6.4em}%
+     \setlength{\labelsep}{0.6em}\setlength{\itemsep}{0.5em}%
+     \setlength{\parsep}{0pt}\setlength{\topsep}{0.3em}%
+     \renewcommand{\makelabel}[1]{\small\color{vitamuted}##1\hfill}}}
+  {\end{list}}
+
+%% \vitaentry{date}{title}{context}
+\newcommand{\vitaentry}[3]{%
+  \item[#1]{\bfseries #2}%
+  \ifx\relax#3\relax\else\par{\small #3}\fi}
+
+%% A continuation line inside the current entry. Uses \par rather than \\ so
+%% that it is safe after any preceding content, including none.
+\newcommand{\vitanote}[1]{\par{\small\color{vitamuted}#1}}
+
+%% \vitasection{id} -- heading plus the generated file for this document.
+\newcommand{\vitasection}[1]{%
+  \section{\vita@titlefor{#1}}%
+  \begin{vitaentries}%
+  \input{generated/\vita@document/#1.tex}%
+  \end{vitaentries}}
+
+%% \vitainput{id} -- the generated file without heading or list wrapper,
+%% for sections that bring their own structure (publications).
+\newcommand{\vitainput}[1]{\input{generated/\vita@document/#1.tex}}
+
+\endinput

package/dist/tex.d.mts

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { Entry, PublicationGroup } from './index.mjs';
+
+interface BuildOptions {
+    rootDir: string;
+    /** Build only these documents; all of them when empty. */
+    only?: string[];
+    /** Emit .tex but skip latexmk. */
+    noPdf?: boolean;
+}
+declare function buildCv(options: BuildOptions): Promise<string[]>;
+/** Read a generated file, for tests and diagnostics. */
+declare function readGenerated(rootDir: string, document: string, section: string): Promise<string>;
+
+declare const documentSchema: z.ZodObject<{
+    visibility: z.ZodDefault<z.ZodEnum<{
+        public: "public";
+        cv: "cv";
+        private: "private";
+    }>>;
+    sections: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        where: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        since: z.ZodOptional<z.ZodNumber>;
+        until: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    publications: z.ZodDefault<z.ZodObject<{
+        groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type DocumentOptions = z.infer<typeof documentSchema>;
+interface DocumentSource {
+    /** Base name, e.g. `cv` for `cv-tex/cv.tex`. */
+    name: string;
+    texFile: string;
+    options: DocumentOptions;
+}
+/** Read every `cv-tex/*.tex` and its options. */
+declare function discoverDocuments(cvDir: string): Promise<DocumentSource[]>;
+/** Select the entries of one section for one document. */
+declare function selectEntries(entries: Entry[], options: DocumentOptions, sectionId: string): Entry[];
+
+/** `tex/` in the installed package: templates and the document class. */
+declare const bundledTexDir: string;
+interface EmitOptions {
+    sections: Record<string, Entry[]>;
+    publications: PublicationGroup[];
+    options: DocumentOptions;
+    /** `cv-tex/templates/`, where user overrides live. */
+    templateDir: string;
+    /** `cv-tex/generated/<document>/`. */
+    outDir: string;
+    /** `profile.url`: where the website is published, for links to paths on it. */
+    siteUrl?: string;
+    /** Path of the .bib file, relative to the generated directory. */
+    bibPath?: string;
+}
+/** Write one `.tex` file per section, plus `publications.tex`. */
+declare function emitDocument(emit: EmitOptions): Promise<string[]>;
+
+/**
+ * LaTeX escaping.
+ *
+ * This is the single most error-prone part of generating `.tex` from data, so
+ * it is centralised, tested, and applied by every helper a template can call
+ * (see `emit.ts`).
+ *
+ * Content fields may contain inline mathematics (`$k$-ary`), which must survive
+ * unescaped while the surrounding prose is escaped.
+ */
+interface EscapeOptions {
+    typography?: boolean;
+    /**
+     * Original field value, set by `escapeRichTex`. A `$` reaching this function
+     * from rich text means a formula was never closed, which would otherwise
+     * produce silently wrong output.
+     */
+    source?: string;
+}
+/** Escape a string for LaTeX text mode, without touching mathematics. */
+declare function escapeTex(value: string, { typography, source }?: EscapeOptions): string;
+/**
+ * Escape prose while preserving `$...$` and `$$...$$` spans verbatim.
+ *
+ * Used for `richText` fields, where a mathematician writes `Random $k$-ary
+ * trees` and expects the formula to reach LaTeX untouched.
+ */
+declare function escapeRichTex(value: string): string;
+declare function escapeUrl(value: string): string;
+
+export { buildCv, bundledTexDir, discoverDocuments, documentSchema, emitDocument, escapeRichTex, escapeTex, escapeUrl, readGenerated, selectEntries };
+export type { BuildOptions, DocumentOptions, DocumentSource, EmitOptions, EscapeOptions };