% \iffalse meta-comment
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% lua-font-config.dtx
% Additions and changes Copyright (C) 2024-2026 Clea F. Rees.
% Code from skeleton.dtx Copyright (C) 2015-2024 Scott Pakin (see below).
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3c
% of this license or (at your option) any later version.
% The latest version of this license is in
%   https://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions of LaTeX
% version 2008-05-04 or later.
%
% This work has the LPPL maintenance status \muaintained'.
%
% The Current Maintainer of this work is Clea F. Rees.
%
% This work consists of all files listed in manifest.txt.
%
% The file lua-font-config.dtx is a derived work under the terms of the
% LPPL. It is based on version 2.4 of skeleton.dtx which is part of
% dtxtut by Scott Pakin. A copy of dtxtut, including the
% unmodified version of skeleton.dtx is available from
% https://www.ctan.org/pkg/dtxtut and released under the LPPL.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% \fi
%
% \iffalse
%<*driver>
\directlua{
  pdf.setmajorversion(2)
  pdf.setminorversion(0)
}
\RequirePackage{svn-prov}
\ProvidesFileSVN{$Id: lua-font-config.dtx 12127 2026-10-15 06:49:18Z cfrees $}[v0.1 \revinfo][\filename: \filebase]
\DefineFileInfoSVN[lfc]
\GetFileInfoSVN*
\begingroup
\makeatletter
\def\first@of@some#1 (#2){#1}
\xdef\lfc@semanticver{%
  \expandafter\first@of@some\lfc@version\relax
}
\endgroup
% ref. ateb Max Chernoff: https://tex.stackexchange.com/a/723294/ 
\def\MyMakePrivateLetters{\makeatletter\ExplSyntaxOn\endlinechar13}
\documentclass[british,a4paper]{ltxdoc}
% ltnews42 / ateb David Carlisle: https://tex.stackexchange.com/a/754799/ (sylwad Ulrike Fischer rhywle ond alla i ddim canfod o hyd iddo fe)
\let\OrigMakePrivateLetters\MakePrivateLetters
\let\MakePrivateLetters\MyMakePrivateLetters
\partokencontext=0
\usepackage{babel}
\usepackage{lua-font-config}
\fontconfig{%
  rm    = kproman,
  sf    = kpsans,
  tt    = {%
    name  = kpmono,
    fea   = {mode=node;script=dflt;language=dflt;-tlig},
  },
  math  = kpmath,
}
\usepackage{xcolor}
\usepackage{graphicx}
\usepackage{parskip}
\usepackage{changepage}
\usepackage{xurl}
% sicrhau hyperindex=false: llwytho CYN bookmark
\usepackage{hypdoc}% ateb Ulrike Fischer: https://tex.stackexchange.com/a/695555/
\usepackage{bookmark}
\usepackage{minted}
\usepackage{csquotes}
\MakeAutoQuote{‘}{’}
\MakeAutoQuote*{“}{”}
\usepackage{cleveref}
\EnableCrossrefs
\CodelineIndex
\RecordChanges
%^^A \OnlyDescription
%^^A \ExplSyntaxOn
% Note that some things are here because doc gets confused and erroneously thinks them macros.
\DoNotIndex{\verb,\ProvidesPackageSVN,\NeedsTeXFormat,\ProcessKeyOptions,\ExplSyntaxOn,\ExplSyntaxOff,\RequirePackage,\DefineFileInfoSVN,\GetInfoSVN,\@ifundefined,\@ifl@t@r,\ExplLoaderFileDate,\endinput,\PackageError,\PackageWarning,\PackageInfo,\author,\title,\maketitle,\date,\revinfo,\ProcessKeysOptions,\MessageBreak,\fmtversion,\filebase,\fileversion,\fileinfo,\filebase:,\filedate,\documentclass,\begin,\end,\item,\IfFormatAtLeastTF,\msg}
%^^A \ExplSyntaxOff
\definecolor{strawberry}{rgb}{1.000,0.000,0.502}
\definecolor{blueberry}{rgb}{0.000,0.000,1.000}
\definecolor{moss}{rgb}{0.000,0.502,0.251}
\hypersetup{%
  colorlinks=true,
  citecolor={moss},
  extension=pdf,
  linkcolor={strawberry},
  linktocpage=true,
  pdfcreator={TeX},
  pdfproducer={LuaTeX},
  urlcolor={blueberry}%
}
\NewDocElement[%
  idxtype=key,
  idxgroup=keys,
  printtype=\textit{key},
]{Key}{keyname}
\NewDocElement[%
  idxtype=fn.,
  idxgroup=functions,
  printtype=\textit{fn.},
  macrolike=true,
]{Fn}{function}
\NewDocElement[%
  idxtype=var.,
  idxgroup=variables,
  printtype=\textit{var.},
  macrolike=true,
]{Var}{variable}
\NewDocumentCommand \val { m }
{%
  {\ttfamily =\,\meta{#1}}%
}
\ExplSyntaxOn
\NewDocumentCommand \vals { m }
{
  {
    \ttfamily = \, 
    \clist_use:nn { #1 } { \textbar }
  }
} 
\keys_define:nn { lfc / doc }
{
  unknown .code:n = {
    \cs_if_free:cT { \l_keys_key_str }
    {
      \tl_gset:cn { \l_keys_key_str } { #1 }
    }
  },
}
\NewDocumentCommand \lfcdocset { +m }
{
  \keys_set:nn { lfc / doc } { #1 }
}
\setminted     {style=sas,breaklines=true,breakafter={\,},
  frame=single,rulecolor=darkgray,
}
\newmintedfile [lfcdocfile]{latex} {
  rangestartstring={\\documentclass},
  rangestopstring={\\end\{document\}},
  frame = topline,
}
\NewDocumentCommand \lfcee { s o m} {
  \begin{figure}
    \IfBooleanT {#1} {
      \begin{adjustwidth}{-8pc}{}
    }
      \centering 
      \IfNoValueTF {#2} {
        \includegraphics{example-#3} 
        \par
      } {
        \clist_map_inline:nn {#2} {
          \includegraphics[page=##1]{example-#3}
          \par
        }
      }
      \caption{\texttt{example-#3}}\label{fig:ee-#3}
    \IfBooleanT {#1} {
      \end{adjustwidth}
    }
  \end{figure}
}
\ExplSyntaxOff
\lfcdocset{%
  bug={\href{https://codeberg.org/cfr/nfssext/issues}{\textsc{bugtracker}}},
  codeberg={\href{https://codeberg.org/cfr/nfssext}{\textsc{codeberg}}},
  github={\href{https://github.com/cfr42/nfssext}{\textsc{github}}},
  ctan={\href{https://ctan.org/}{\textsc{ctan}}},
}
\setcounter{IndexColumns}{2}
\makeatletter
\def\@xobeysp{\leavevmode\penalty100\ }
\makeatother
\begin{document}
  \DocInput{\filename}
\end{document}
%</driver>
% \fi
% \expandafter\title\expandafter{\csname lfc@base\endcsname}
% \author{Clea F. Rees}%^^A\thanks{%
% \AddToHook{shipout/foreground}{%
%   \put (5mm,\dimeval{\baselineskip-\paperheight}) {%
%     \hbox to \dimeval{\paperwidth-10mm} {%
%       \footnotesize
%       Bug tracker:
%       \href{https://codeberg.org/cfr/nfssext/issues}{\url{codeberg.org/cfr/nfssext/issues}}
%       \textbar{} Code:
%       \href{https://codeberg.org/cfr/nfssext}{\url{codeberg.org/cfr/nfssext}}
%       \textbar{} Mirror:
%       \href{https://github.com/cfr42/nfssext}{\url{github.com/cfr42/nfssext}}% 
%       \hfill
%     }%
% }}
% \expandafter\date\expandafter{\csname lfc@semanticver\endcsname\thanks{%
%   \textsc{svn}: \UseName{lfc@rev} \UseName{lfc@date}%
% }}
% \maketitle
% \begin{abstract}
% An opentype font configuration package for Lua\LaTeXe{}.
% The aim is to provide an alternative to \pkg{fontspec} which is both faster and more powerful, by doing as much processing as possible in Lua.
% To avoid loading fonts unnecessarily, the data used is corrected during compilation and the results cached for future use.
%
% \emph{This package is experimental.}
% \end{abstract}
% 
% \section{Requirements}\label{sec:require}
%
% The package requires Lua\LaTeXe.
% It will not work with any other engine or format.
%
% Unicode maths is supported \emph{via} \pkg{lua-unicode-math}.
% It will \textbf{not} work with \pkg{unicode-math}.
%
% \section{Usage}\label{sec:pkg}
%
% \emph{The user interface is currently \textbf{extremely} basic.}
%
% All that is properly supported is the choice of font family for the standard families --- i.e.~roman/serif, sans, typewriter/mono and (Unicode) maths (main, script and calligraphic) --- and configuration of additional fonts, again by family.
% In addition to this, scaling and raw feature selection are supported.
% That is, most things are supported in the sense that they are possible, but the interface is rudimentary in the extreme.
%
% That said, the automated configuration is quite extensive.
% By default, the package tries to configure font families which are as rich as possible, insofar as the fonts support this. 
% This includes
% \begin{itemize}
%   \item multiple widths and shapes, insofar as \textsc{nfss} supports them;
%   \item italic, oblique, upright italic, reverse italic, reverse oblique;
%   \item small-caps, italic small-caps, oblique small-caps\footnote{%
%     This should work whether small-caps are in separate fonts (e.g.~Latin Modern) or implemented by the \texttt{smcp} feature (e.g.~\TeX{}-Gyre Pagella).%
%   };
%   \item optical sizes.
% \end{itemize}
% Of course, this depends on the quality of the data the fonts provide.
% It is not always good or, even, vaguely accurate. 
% If things do not fit, some (currently minimal) effort is made to accommodate them as distinct font families, so they are still available at document level.
%
% At present, this is a bit chaotic and a bit hard to use, as the results are ‘hidden’ from you (in, of course, plain sight).
% Even so, you should typically need to do much less to access the fonts you want than you might otherwise expect. 
%
% The advantage of this is that if a font has several widths, you can easily adjust the one used for bold by simply redefining the relevant default.
% This is not very user friendly yet, but it is not completely terrible.
% 
%
% Simple usage looks like this:
% \iffalse
%<*verb>
% \fi
\begin{minted}{latex}
  \usepackage{lua-font-config}
  \fontconfig{%
    rm = texgyrepagella,
    sf = texgyreheros,
    tt = texgyrecursor,
    math = texgyrescholamath,
  }
\end{minted}
% \iffalse
%</verb>
% \fi
%
% \DescribeMacro{\fontconfig}\marg{key-val list}\par
% Specify font configuration.
% 
% \subsection{Keys}\label{subsec:keys}
% Top-level keys are described here.
% Keys for use in key-value lists are described in \cref{subsec:keys-cfg}.
%
% \DescribeKey{rm}\val{family name}\par
% \DescribeKey{rm}\val{key-val list}\par
% Specify family to use as the main document font, typically a serif or ‘roman’ family.
%
% Available keys are listed below.
%
% \DescribeKey{sf}\val{family name}\par
% \DescribeKey{sf}\val{key-val list}\par
% Specify family to use as the default sans family, typically a sans-serif.
%
% Available keys are listed below.
%
% \DescribeKey{tt}\val{family name}\par
% \DescribeKey{tt}\val{key-val list}\par
% Specify family to use as the default ‘typewriter’ family, typically monowidth.
%
% Available keys are listed below.
%
% \DescribeKey{fam}\val{family name}\par
% \DescribeKey{fam}\val{key-val list}\par
% Specify an additional text family.
% This will create a macro which can be used to switch to the requested family\footnote{%
%   Usually you will want to specify which macro, since otherwise you must figure out the family name the code uses, which may or may not match the one requested.
%   See \cref{subsubsec:keys-text-add}.%
% }.
%
% Available keys are listed below.
%
% \DescribeKey{math}\val{family name}\par
% \DescribeKey{math}\val{key-val list}\par
% Specify the family to use for typesetting Unicode mathematics.
% This sets the fonts used for symbols, script and calligraphic alphabets.
% It does not change the fonts used to typeset operators, since these are taken from text fonts and configured separately.
%
% Available keys are listed below.
%
% This option uses \pkg{lua-unicode-math}.
% \pkg{unicode-math} is \textbf{not} supported.
% If you wish to use \pkg{unicode-math}, do not use this option.
% Instead, load \pkg{unicode-math} and use \cs{setmathfont} as usual.
%
% \DescribeKey{debug}\val{key-val list}\par
% This can be used to enable debugging and/or modify the logging level.
% It is primarily intended for use in debugging the package and unlikely to be of use in production.
% However, it may be useful the use this key if reporting a bug which cannot be reproduced e.g.~which is platform specific or depends on system fonts.
%
% \subsection{Keys for specifying font families}\label{subsec:keys-cfg}
%
% All keys described in \cref{subsec:keys} accept either a simple family name, as shown in the example above, or a braced key-value list.
% For example,
% \iffalse
%<*verb>
% \fi
\begin{minted}{latex}
  \usepackage{lua-font-config}
  \fontconfig{%
    rm = {%
      name = texgyrepagella, 
      fea  = {script=ltn;+tlig;+pnum},
    },
    sf = {%
      name  = texgyreheros,
      scale = 1.2,
      fea   = {script=cyrl;},
    },
    tt = {%
      name  = texgyrecursor,
      fea   = {+zero;},
      %% for completeness: false is anyway the default
      force = false,
    },
  }
\end{minted}
% \iffalse
%</verb>
% \fi
%
% This section describes these ‘inner’ keys.
%
% \subsubsection{Common keys}\label{subsubsec:common}
%
% These keys are accepted by all of \texttt{rm}, \texttt{sf}, \texttt{tt},
% \texttt{fam} and \texttt{math}.
%
% \DescribeKey{name}\val{lookup name}\par
% The ‘name’ to lookup.
% This may, but need not be, the name of a font family.
% Shorter, less specific names will configure more families; longer, more specific names will configure fewer.
%
% For example, \texttt{name = texgyrepagellax,} will configure fewer than \texttt{name = texgyrepagella,} since the latter string matches both families, while the former does not.
% 
% The name is lower-cased prior to lookup. 
% The data used to generate actual font families uses a cleaned up version of the given name or, sometimes, a variation, depending on the data returned from the database.
%
% For example, \texttt{tex gyre PaGellA} yields the same results as \texttt{texgyrepagella}.
%
% Numbers are likewise removed\footnote{%
%   This is problematic for fonts which depend on digits in their names to distinguish them e.g.~Venturis ADF has four distinct ‘titling’ fonts, whose names differ by a single character, which is \texttt{1}, \texttt{2}, \texttt{3} or \texttt{4}. 
%   The algorithm used to sort the fonts into \textsc{nfss} families currently gets confused by this, leading to misleading warnings about ‘apparent duplicate’ fonts. 
%   (Something is indeed awry, but they are not duplicates.
%   Rather what should be four families appears to be only one.)%
% }.
%
%
% \DescribeKey{force}\vals{true,false}\par
% Boolean which determines whether cached data is to be regenerated on the basis of a new search of the font-loader's database.
%
% Note that this doesn't regenerate the loader's database itself. 
% It simply zaps data stored by this module for one or more font families.
%
% \DescribeKey{scale}\val{factor}\par
% Optional factor by which the font should be scaled e.g.~\texttt{20} or \texttt{0.8}.
% Ignored if a family includes distinct optical sizes.
%
% \subsubsection{Text-mode keys}\label{subsubsec:keys-text}
% These keys are accepted in all key-value specifications except for the top-level \texttt{math} key used to configure Unicode maths.
%
% Currently there is only one key in this category.
%
% \DescribeKey{fea}\val{opentype feature spec.}\par
% Optional list of font features \textbf{for text fonts only}. 
% 
% Note that the specification is currently passed to the font loader with minimal processing, so you must use ‘raw’ feature specifications.
%
\iffalse
% The default is \texttt{script=dflt}, \texttt{mode=node}, \texttt{+tlig},
% \texttt{language=dflt}.
\fi
% The default is \texttt{fea=}%
%   \marg{mode=node;scrpt=dflt;language=dflt;+tlig}.
% Unless provided in separate fonts, \texttt{+smcp} is added, if available, for upright, italic and oblique small-caps.
% 
% Features apply to \emph{all} fonts configured as a result of the lookup, so you should not specify features you do not wish applied to all fonts to which the specification applies.
% 
% \subsubsection{Default text family keys}\label{subsubsec:keys-text-def}
% These keys are accepted by \texttt{rm}, \texttt{sf} and \texttt{tt} i.e.~when specifying the default text families for the document.
%
% These keys all do the same thing, so you may use your preferred syntactic sweetener. 
%
% \DescribeKey{math}\vals{true,false}\par
% \DescribeKey{maths}
% Should the current specification also be used for the corresponding text family in maths?
%
% For example, if you are configuring the main document family with \texttt{rm}, should that family also be used for operators, \cs{mathrm} etc.?
%
% The default is equivalent to \texttt{math = true}.
%
% \DescribeKey{nomath}
% \DescribeKey{nomaths}
% Equivalent to \texttt{math = false}.
%
% \subsubsection{Additional text family keys}\label{subsubsec:keys-text-add}
%
% \DescribeKey{command}|=\command|\par
% Use \cs{command} to switch to the font family, rather than creating a command from the family name.
% 
% By default the command to switch to the font family depends on the discovered family name i.e.~on the result of searching the database for the specified family.
% In many cases, this will be the value passed to the \texttt{name} key, but often it will not and sometimes this may not be the command name you want anyway.
% \texttt{command} allows you to override it.
%
% For example, the following would setup \cs{playfair} to switch to Playfair 
% Display, rather than the default choice of \cs{playfairdisplay}.
% \iffalse
%<*verb>
% \fi
\begin{minted}{latex}
  \usepackage{lua-font-config}
  \fontconfig{%
    family = {% setup an additional non-default family
      name = Playfair Display,
      command = \playfair,
    },
  }
\end{minted}
% \iffalse
%</verb>
% \fi
%
% \section{Compatibility}\label{sec:compat}
% 
% \subsection{\pkg{ltx-talk}}\label{subsec:compat-talk}
%
% Load with \cs{RequirePackage} \emph{before} loading the class.
% The package emulates the class settings by default, so the main benefit of loading it is speed.
% If you wish to change the fonts, use \cs{fontconfig} after the class is loaded\footnote{%
%   If this turns out to be something people want to do, I can adjust things to avoid configuring fonts twice.
%   For now, this is just a good way for me to test the code and avoid the pain of watching \pkg{fontspec} load New Computer Modern.%
% }
%
% \section{Examples}\label{sec:eeiau}
%
% \lfcdocfile [label=example-lmr -- \cref{fig:ee-lmr}] {example-lmr}
% \lfcee{lmr}
%
% \lfcdocfile [label=example-ncm-math -- \cref{fig:ee-ncm-math}] {example-ncm-math}
% \lfcee{ncm-math}
%
% \lfcdocfile [label=example-ncm-complete -- \cref{fig:ee-ncm-complete}] 
%   {example-ncm-complete}
% \lfcee{ncm-complete}
%
% \lfcdocfile [label=example-fea -- \cref{fig:ee-fea}] {example-fea}
% \lfcee{fea}
%
% \lfcdocfile [label=example-add -- \cref{fig:ee-add}] {example-add}
% \lfcee{add}
%
% \lfcdocfile [label=example-talk -- \cref{fig:ee-talk},
%   rangestartstring={\\DocumentMetadata}]{example-talk}
% \lfcee*[1,2]{talk}
%
% \section{TO DOs}\label{sec:todo}
%
% These are not in any particular order, though there is some tendency for higher priority items to be earlier.
% \begin{enumerate}
%   \item Conceptual
%     \begin{itemize}
%       \item Abandon the whole thing since packages are not supposed to meddle with fonts?
%     \end{itemize}
%   \item \textsc{nfss}
%     \begin{itemize}
%       \item Support multiple font configurations e.g.~for multiple languages with multiple scripts.
%         \begin{itemize}
%           \item Support for \pkg{babel}?
%           \item[] \pkg{babel} provides e.g. \cs{babelfont}, which uses \cs{fontspec}.
%             Should \pkg{lua-font-config} provide this?
%         \end{itemize}
%      \end{itemize}
%   \item Interface
%     \begin{itemize}
%       \item Provide a proper user interface (more similar to Con\TeX{}t, since we're using the same (\textsc{mkiv}) sorting?
%       \item Information for user.
%       \item Accommodate \texttt{.ttc}. 
%       \begin{itemize}
%         \item The basis is done, but not sure what, if any, interface is needed?
%         \item How to test this??
%       \end{itemize}
%       \item Way to define individual font commands for text and (maybe) maths.
%         \begin{itemize}
%           \item Text is already in the infrastructure, but the defined macro is unpredictable \& non-configurable.
%         \end{itemize}
%     \end{itemize}
%   \item Loader
%     \begin{itemize}
%       \item Test with \texttt{.ttf}. 
%         \begin{itemize}
%           \item What needs testing exactly??
%             Or is this all on the loader?
%         \end{itemize}
%       \item Variable fonts.
%         \begin{itemize}
%           \item How to do or test??
%         \end{itemize}
%       \item Colour. 
%         Do??
%         \begin{itemize}
%           \item What does ‘Do??’ refer to?
%         \end{itemize}
%       \item Cope with (text) symbol fonts?
%         Not sure is that really needed?
%       \item Combo, fallback \& all that.
%     \end{itemize}
%   \item Cache
%     \begin{itemize}
%       \item Cached data should depend on db/fnt versions.
%         \begin{itemize}
%           \item Or is this automatic?
%           \item Or maybe it shouldn't?
%         \end{itemize}
%     \end{itemize}
%   \item Documentation
%     \begin{itemize}
%       \item Not everything implemented in terms of the \textsc{ui} is in the user doc.
%       \item The Lua code has some comments, but these don't always amount to documentation.
%       \item The overall infrastructure isn't really documented, except for a partially accurate \textsc{ascii} database schema included inline.
%       \item Registered Lua functions mapped to \pkg{expl3} names are not documented.
%       \item Use of callbacks, hooks etc.\ is more-or-less undocumented.
%     \end{itemize}
%   \item Code
%     \begin{itemize}
%       \item Should be cleaned up -- I cannot need 2,500 lines to load a font!
%       \item[Unnumbered Gripe] The code is too long, too complex, too clunky and too simplistic.
%          (Yes, of course, it can be both.)
%       \item Loading the ConTeXt file differently?
%       \item Improve formal \LaTeX{} representation (see \pkg{ltluatexbase}.
%       \item Improve performance.
%         \begin{itemize}
%           \item There is some duplication and too many pre-definitions for my taste.
%         \end{itemize}
%       \item Possibly modify database creation to avoid sorting the data twice??
%     \end{itemize}
%   \item Test suite
%     \begin{itemize}
%       \item There are no unit tests (cf.\ \pkg{nfssext-cfr}, where the tests are much more focused).
%         I don't know how to implement this for (non-public) Lua functions.
%     \end{itemize}
% \end{enumerate}
%
% \changes{v0.1}{2026-10-15}{First public release.}
%
% \MaybeStop{%
%   \PrintChanges
%   \PrintIndex
% }
% 
% \section{Implementation}
%
% There is very little here, because almost everything is done in Lua.
%
%<*sty>
%<@@=lfc>
%    \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}[2021-11-15]
\RequirePackage{svn-prov}
\ProvidesPackageSVN[\filebase.sty]{$Id: lua-font-config.dtx 12127 2026-10-15 06:49:18Z cfrees $}[v0.1 \revinfo][\filebase: Font configuration for LuaLaTeX]
% This is needed only because l3doc overwrites \fileversion and \filedate.
% Neither ltxdoc nor doc does this.
% But it seems better to do it this way on the basis of the general precautionary principle.
\DefineFileInfoSVN[lfc]
%    \end{macrocode}
% \iffalse
% ^^A Paid â defnyddio \GetFileInfoSVN*/\GetFileInfoSVN{} yn y fan hon!!
% \fi
%    \begin{macrocode}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% copied verbatim, excepting format from Joseph Wright's' siunitx.sty under LPPL
\@ifundefined{directlua}{%
  \PackageError{lua-font-config}{Package requires LuaLaTeX}
  {To use lua-font-config, you must compile your document with LuaLaTeX.}%
}{}
\@ifundefined{ExplLoaderFileDate}{%
  \RequirePackage{expl3}%
}{}
%% almost verbatim from siunitx.sty
\@ifl@t@r\ExplLoaderFileDate{2022-02-24}{%
}{%
  \PackageError{lua-font-config}{Support package expl3 too old}
  {%
    You need to update your installation of the bundles 'l3kernel' and
    'l3packages'.\MessageBreak
    Loading~lua-font-config~will~abort!%
  }%
  \endinput
}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\ExplSyntaxOn
\prop_gput:NnV \g_msg_module_name_prop {lfc} \lfc@base
%    \end{macrocode}
% %^^A Switch cat codes to protect \verb|~|.
% \let\MakePrivateLetters\OrigMakePrivateLetters
% Messages.
% 
% Note that \verb|\msg_*| are not recognised in the indexing; \cs{msg} appears instead.
% This is a limitation of the \pkg{doc} package, as far as I know.
%    \begin{macrocode}
\msg_new:nnnn {lfc} {needs-luatex} {
  \msg_critical_text:n {lfc} :: ~requires~LuaLaTeX~\msg_line_context:
} { \msg_see_documentation_text:n {lfc} }
%    \end{macrocode}
% %^^A Switch temporarily back to catch the next \pkg{expl3} function.
% \let\MakePrivateLetters\MyMakePrivateLetters
%    \begin{macrocode}
\sys_if_engine_luatex:F { \msg_critical:nn {lfc} {needs-luatex} }
%    \end{macrocode}
% %^^A Switch cat codes to protect \verb|~|.
% \let\MakePrivateLetters\OrigMakePrivateLetters
%    \begin{macrocode}
\msg_new:nnnn {lfc} {math-needs-lum} {
  \msg_error_text:n {lfc} :: ~math~config~requires~lua-unicode-math,~but~
  you've~loaded~unicode-math.~This~cannot~work~\msg_line_context:
} { To~configure~Unicode~maths~fonts~with~this~package,~we~need~to~load~
  lua-unicode-math,~but~unicode-math,~which~is~incompatible~has~already~
  been~loaded,~so~I'm~going~to~ignore~this~part~of~your~settings.~
  \msg_see_documentation_text:n {lfc}
}
\msg_new:nnnn {lfc} {loading} {
  \msg_info_text:n {lfc} :: ~loading~#1~for~maths~support~
  \msg_line_context:
} { \msg_see_documentation_text:n {lfc} }
%    \end{macrocode}
% %^^A Switch back now we're done with message setup.
% \let\MakePrivateLetters\MyMakePrivateLetters
% 
% \begin{variable}{\l_@@_tmpa_tl,\l_@@_tmpa_bool}
%   Custom ephemeral variables.
%    \begin{macrocode}
\tl_new:N \l_@@_tmpa_tl
\bool_new:N \l_@@_tmpa_bool
%    \end{macrocode}
% \end{variable}
% \begin{keyname}{rm,sf,tt}
% Top-level keys for default text families.
%    \begin{macrocode}
\clist_map_inline:nn {rm, sf, tt} {
  \keys_define:nn {lfc} {
    #1 .code:n            = { 
      \tl_clear:N \l_@@_tmpa_tl
      \keys_set_exclude_groups:nnnN {lfc/#1} {config} {##1} \l_@@_tmpa_tl
      \keys_set:nV {lfc/#1} \l_@@_tmpa_tl
      \bool_set_true:N \l_@@_tmpa_bool
    },
    #1 .value_required:n  = true,
    #1 .usage:n           = preamble,
  }
%    \end{macrocode}
% \begin{keyname}{name,fea,force,scale,maths,math,nomaths,nomath}
% Configure keys for default text families.
%    \begin{macrocode}
  \keys_define:nn {lfc/#1} {
    name      .code:n = { \use:c {_@@_set_#1:n} {##1} },
    fea       .code:n = { \keys_set:nn {lfc/fam} {fea      = {##1}} },
    force     .code:n = { \keys_set:nn {lfc/fam} {force    = {##1}} },
    scale     .code:n = { \keys_set:nn {lfc/fam} {scale    = {##1}} },
    maths     .code:n = { \_@@_set_fam_cfg:nn   {maths}{##1} },
    math      .meta:n = { maths = {##1} },
    nomaths   .meta:n = { maths = false },
    nomath    .meta:n = { nomaths },
    unknown   .code:n = {
      \exp_args:NnV \use:c {__@@_set_#1:n} \l_keys_key_str
    },
    name      .value_required:n   = true,
    math      .default:n          = true,
    maths     .default:n          = true,
    nomath    .value_forbidden:n  = true,
    nomaths   .value_forbidden:n  = true,
    unknown   .value_forbidden:n  = true,
    fea       .groups:n           = config,
    force     .groups:n           = config,
    maths     .groups:n           = config,
    math      .groups:n           = config,
    nomath    .groups:n           = config,
    nomaths   .groups:n           = config,
    scale     .groups:n           = config,
  }
}
%    \end{macrocode}
% \end{keyname}
% \end{keyname}
% \begin{keyname}{debug,family,math}
% Top-level keys for additional families, Unicode maths and debugging.
%    \begin{macrocode}
\keys_define:nn {lfc} {
  debug   .code:n           = { 
    \tl_clear:N \l_@@_tmpa_tl
    \keys_set_groups:nnnN
      {lfc/debug} {toggle} {state = true, #1} \l_@@_tmpa_tl
    \keys_set:nV {lfc/debug} \l_@@_tmpa_tl
  },
  debug   .usage:n          = general,
  family  .code:n           = { 
    \tl_clear:N \l_@@_tmpa_tl
    \keys_set_exclude_groups:nnnN {lfc/fam} {config} {#1} \l_@@_tmpa_tl
    \keys_set:nV {lfc/fam} \l_@@_tmpa_tl
    \bool_set_true:N \l_@@_tmpa_bool
  },
  family  .value_required:n = true,
  family  .usage:n          = general,
  math    .code:n           = { 
    \IfPackageLoadedTF {unicode-math} {
      \msg_error:nn {lfc} {math-needs-lum}
    } {
      \msg_info:nnn {lfc} {loading} {lua-unicode-math} 
      \RequirePackage{lua-unicode-math}
      \tl_clear:N \l_@@_tmpa_tl
      \keys_set_exclude_groups:nnnN {lfc/math} {config} {#1} \l_@@_tmpa_tl
      \keys_set:nV {lfc/math} \l_@@_tmpa_tl
      \bool_set_true:N \l_@@_tmpa_bool
    }
  },
  math    .value_required:n = true,
  math    .usage:n          = preamble,
}
%    \end{macrocode}
% \end{keyname}
% \begin{keyname}{name,fea,force,scale}
% Configure keys for families.
%    \begin{macrocode}
\keys_define:nn {lfc/fam} {
  name      .code:n = { \__@@_set_fam_name:n {#1} },
  command   .code:n = { 
    \exp_args:Nne \__@@_set_fam_cfg:nn {csname}{ \cs_to_str:N #1 }
  },
  fea       .code:n = { \__@@_set_fam_cfg:nn {fea}{#1} },
  force     .code:n = { \__@@_set_fam_cfg:nn {force}{#1} },
  scale     .code:n = { \__@@_set_fam_cfg:nn {scale}{#1} },
  unknown   .code:n = {
    \exp_args:NV \__@@_set_fam_name:n \l_keys_key_str 
  },
  name      .value_required:n   = true,
  fea       .value_required:n   = true,
  force     .default:n          = true,
  scale     .value_required:n   = true,
  unknown   .value_forbidden:n  = true,
  name      .usage:n            = general,
  fea       .usage:n            = general,
  force     .usage:n            = general,
  scale     .usage:n            = general,
  unknown   .usage:n            = general,
  fea       .groups:n           = config,
  force     .groups:n           = config,
  scale     .groups:n           = config,
}
%    \end{macrocode}
% \end{keyname}
% \begin{keyname}{name,force,scale}
% Configure keys for Unicode maths.
%    \begin{macrocode}
\IfPackageLoadedF {unicode-math} {
  \keys_define:nn {lfc/math} {
    name      .code:n = { \use:c {_@@_set_math:n} {#1} },
    force     .code:n = { \keys_set:nn {lfc/fam} {force    = {#1}} },
    scale     .code:n = { \keys_set:nn {lfc/fam} {scale    = {#1}} },
    unknown   .code:n = {
      \exp_args:NnV \use:c {_@@_set_math:n} \l_keys_key_str
    },
    name      .value_required:n   = true,
    force     .default:n          = true,
    scale     .value_required:n   = true,
    unknown   .value_forbidden:n  = true,
    name      .usage:n            = preamble,
    force     .usage:n            = preamble,
    scale     .usage:n            = preamble,
    unknown   .usage:n            = preamble,
    force     .groups:n           = config,
    scale     .groups:n           = config,
  }
}
%    \end{macrocode}
% \end{keyname}
% \begin{keyname}{state,categories}
% Configure keys for debugging.
%    \begin{macrocode}
\keys_define:nn {lfc/debug} {
  categories  .code:n             = { \_@@_debug_set_cats_scanner:n {#1} },
  state       .choice:,
  state/false .code:n             = { \_@@_debug_set_false: },
  state/true  .code:n             = { \_@@_debug_set_true: },
  categories  .usage:n            = general,
  state       .usage:n            = general,
  categories  .value_required:n   = true,
  state       .default:n          = true,
  state       .groups:n           = toggle,
}
%    \end{macrocode}
% \end{keyname}
% \begin{macro}{\fontconfig}
%   The main (and currently(?) only) public macro.
%    \begin{macrocode}
\NewDocumentCommand\fontconfig { +m }{
  \bool_set_false:N \l_@@_tmpa_bool
  \keys_set:nn {lfc} {#1}
  \bool_if:NT \l_@@_tmpa_bool {
    \_@@_configure_doc_families:
  }
}
%    \end{macrocode}
% \end{macro}
% \begin{function}{\_@@_set_mathrm:,\_@@_set_mathsf:,\_@@_set_mathtt:}
% TODO: move to hooks if module gets support for switching the families out e.g.~for language changes.
% Currently, the code is too simple-minded for this to arise \dots.
%    \begin{macrocode}
\cs_new_protected_nopar:Npn \_@@_set_mathrm: {
  \SetMathAlphabet \mathrm {normal} {TU} \rmdefault {\mdseries@rm} \shapedefault
  \SetMathAlphabet \mathit {normal} {TU} \rmdefault {\mdseries@rm} \itdefault
  \SetMathAlphabet \mathbf {normal} {TU} \rmdefault {\bfseries@rm} \shapedefault
  \SetMathAlphabet \mathrm {bold}   {TU} \rmdefault {\bfseries@rm} \shapedefault
  \SetMathAlphabet \mathit {bold}   {TU} \rmdefault {\bfseries@rm} \itdefault
  \SetMathAlphabet \mathbf {bold}   {TU} \rmdefault {\bfseries@rm} \shapedefault
  \SetSymbolFont{operators}{normal} {TU} \rmdefault {\mdseries@rm} \shapedefault
  \SetSymbolFont{operators}{bold}   {TU} \rmdefault {\bfseries@rm} \shapedefault
}
\cs_new_protected_nopar:Npn \_@@_set_mathsf: {
  \SetMathAlphabet \mathsf {normal} {TU} \sfdefault {\mdseries@sf} \shapedefault
  \SetMathAlphabet \mathsf {bold}   {TU} \sfdefault {\bfseries@sf} \shapedefault
}
\cs_new_protected_nopar:Npn \_@@_set_mathtt: {
  \SetMathAlphabet \mathtt {normal} {TU} \ttdefault {\mdseries@tt} \shapedefault
  \SetMathAlphabet \mathtt {bold}   {TU} \ttdefault {\bfseries@tt} \shapedefault
}
%    \end{macrocode}
% \end{function}
% \begin{function}{\_@@_declare_lum_symbol_fonts:nn}
% Maths setup function.
%    \begin{macrocode}
\cs_new_protected_nopar:Npn \_@@_declare_lum_symbol_fonts:nn #1#2 {
  \DeclareSymbolFont{lummain}{TU}{#1}{m}{n}
  \SetSymbolFont{lummain}{bold}{TU}{#2}{b}{n}
}
%    \end{macrocode}
% \end{function}
% Compatibility code for \pkg{ltx-talk}.
%
% This should be equivalent to the default setup, modulo any differences between emulating the package and using \cs{setmathfont} for \pkg{lua-unicode-math}.
%    \begin{macrocode}
\hook_gput_code:nnn {class/ltx-talk/before} {.} {
  \hook_gput_code:nnn {package/mathtools/after} {.} {
    \RequirePackage{lua-unicode-math}
    \fontconfig{
      rm      = {newcomputermodernsans},
      sf      = {newcomputermodernsans},
      math    = {newcomputermodernsansmath},
    }
    \tagpdfsetup { math / mathml / luamml / load = true }
  }
}
%    \end{macrocode}
% \begin{function}{%
%   \_@@_set_fam_cfg:nn,
%   \_@@_set_fam_name:n,
%   \_@@_set_mathrm:,
%   \_@@_set_mathsf:,
%   \_@@_set_mathtt:,
%   \_@@_configure_doc_families:,
%   \_@@_debug_set_cats_scanner:n,
%   \_@@_debug_set_false:,
%   \_@@_debug_set_true:%
% }
% The Lua modules do the actual work.
%    \begin{macrocode}
\lua_load_module:n {lua-font-config}
\ExplSyntaxOff
%    \end{macrocode}
% \end{function}
%</sty>
%
% \iffalse
%
%<*ee-lmr>
\documentclass{article}
\usepackage{lua-font-config}
\fontconfig{rm = latinmodernroman}
\begin{document}
This is Latin Modern Roman.
It features \textit{italics} and \textsl{oblique}.
\textsc{Small-caps are implemented as distinct fonts, as are \textsl{oblique small-caps}.}
{\fontshape{ui}\selectfont Upright italics are less commonly used.}

\normalfont\bfseries
This is the bold expanded weight.
It features \textit{italics} and \textsl{oblique}.

\normalfont\fontseries{db}\selectfont
The ‘demi-bold’ is of regular width, with \textsl{oblique}.

\normalfont
Where optical sizes are available, thes provide higher quality output than simple scaling.

\footnotesize
This is footnote-sized Latin Modern Roman.
It features \textit{italics} and \textsl{oblique}.
\textsc{Small-caps are implemented as distinct fonts, as are \textsl{oblique small-caps}.}
{\fontshape{ui}\selectfont Upright italics is less commonly used.}

\normalfont\bfseries
This is the bold expanded weight.
It features \textit{italics} and \textsl{oblique}.

\normalfont\fontseries{db}\selectfont
The ‘demi-bold’ is of regular width, with upright and \textsl{oblique} shapes.

\normalfont
The output should look very much as if ‘lua-font-config’ had not been loaded!
\end{document}
%</ee-lmr>
%
%<*ee-fea>
%% $Id: lua-font-config.dtx 12127 2026-10-15 06:49:18Z cfrees $
\documentclass{article}
\parindent=0pt
\usepackage{lua-font-config}
\fontconfig{%
  rm = {% serif uses oldstyle, proportional figures
    name = TeX Gyre Pagella,
    fea = {+ONUM;+PNUM},
  },
  sf = {% sans uses proportional lining figures
    name = texgyreheros,
    fea = {+pnum;+lnum},
  },
  tt = {% typewriter uses tabular lining figures and no ligatures
    name = texgyrecursor,
    fea = {-TLIG;+tnum;+lnum;-liga},
  },
}
\begin{document}
{%
  \TeX-Gyre Pagella: 0123456789
}

{%
  \sffamily
  \TeX-Gyre Heros: 0123456789
}

{%
  \ttfamily
  \TeX-Gyre Cursor 0123456789
  -- --- outfitted officials affluently affiliate fish finials flagranty, first
  finalising infinite floral affinities of fish-filled fingers
}

% No maths font is configured, so Computer Modern is used.
% But the ‘text’ fonts in maths matches the text by default.
\[
    \sin\quad
    \mathrm{rm}\quad
    \mathsf{sf}\quad
    \mathtt{tt}\quad
    \mathit{it}\quad
    \mathbf{bf}
\]
\mathversion{bold}
\[
    \sin\quad
    \mathrm{rm}\quad
    \mathsf{sf}\quad
    \mathtt{tt}\quad
    \mathit{it}\quad
    \mathbf{bf}
\]
\end{document}
%</ee-fea>
%
%<*ee-ncm-complete>
\documentclass{article}
\usepackage{lua-font-config}
\fontconfig{%
  rm    = New Computer Modern,
  sf    = New Computer Modern Sans,
  tt    = New Computer Modern Mono,
  math  = New Computer Modern Math,
}
\begin{document}
New Computer Modern with default settings.

\sffamily
New Computer Modern Sans with default settings.

\ttfamily
New Computer Modern Mono with default settings.

\normalfont
New Computer Modern Math with text fonts as above:
\[
    \sin\theta^2 + \cos\theta^2 = 1
\]
\[
    \mathscr{ABC abc} \mathcal{ABC abc}
\]
\mathversion{bold}
\[
    \sin\theta^2 + \cos\theta^2 = 1
\]
\[
    \mathscr{ABC abc} \mathcal{ABC abc}
\]
\end{document}
%</ee-ncm-complete>
%
%<*ee-ncm-math>
\documentclass{article}
\usepackage{lua-font-config}
\fontconfig{%
  rm = newcomputermodern,
  sf = newcomputermodernsans,
  tt = newcomputermodernmono,
  math = newcomputermodernmath,
}
\parindent=0pt
\begin{document}
\[
    \sin\theta^2 + \cos\theta^2 = 1
\]
$\mathsf{x} \mathtt{x} \mathbf{x}$

\mathversion{bold}
\[
    \sin\theta^2 + \cos\theta^2 = 1
\]
$\mathsf{x} \mathtt{x} \mathbf{x}$
\end{document}
%</ee-ncm-math>
%
%<*ee-talk>
\DocumentMetadata{tagging=on,pdfstandard=ua-2,pdfversion=2.0,lang=en-GB}
\RequirePackage{lua-font-config}% MUST precede class.
\documentclass{ltx-talk}

\title{Some Title}
\author{A. U. Thor}
\institute{Pantheon, Greece}
\date{Ancient}
\begin{document}
\begin{frame}
  \maketitle
\end{frame}
\begin{frame}
  \frametitle{Frame}
  Some text\footnote{With a footnote.} on a slide.

  \textsc{Small-Caps \textsl{italics \textbf{bold}} \textbf{bold}.}

  Regular, \fontseries{k}\selectfont Book and \bfseries Bold.
  \normalfont
  \begin{equation}
    v = ut + \frac{1}{2}at^2
  \end{equation}
  \begin{equation}
    \sin^2\theta + \cos^2\theta = 1
  \end{equation}
  Script $\mathscr{ABC abc}$ and calligraphic $\mathcal{ABC abc}$.

  Bold maths:
  \mathversion{bold}
  \begin{equation}
    v = ut + \frac{1}{2}at^2
  \end{equation}
  \begin{equation}
    \sin^2\theta + \cos^2\theta = 1
  \end{equation}
  Script $\mathscr{ABC abc}$ and calligraphic $\mathcal{ABC abc}$.
\end{frame}
\end{document}
%</ee-talk>
% 
%<*ee-add>
\documentclass{article}
\usepackage{lua-font-config}
\fontconfig{%
  family  = {
    name    = Lobster Two,
    scale   = 2,
    command = \lobster,
  },
}
\begin{document}
This is some ordinary text in the default \LaTeXe{} font.

{\lobster This is Lobster Two.
  \textit{Italics but no \textsc{small-caps}} \textsc{even in upright}.
  We do have \textbf{bold and \textit{bold italics}}, but there is no, 
  \textsl{oblique, so here we get italics, too.}\par
}

Back to the default.
\end{document}
%</ee-add>
%
% \fi
% 
%\Finale