@lofcz/tikz 0.0.0-stage → 0.1.0

package/runtime/dist/bundles/tex-plain/files/tex/plain/etex/etexdefs.lib

@@ -0,0 +1,85 @@
+%% e-TeXlib V2.0;8  24-MAR-1998 16:30:14 /PT
+
+% This is "etexdefs.def", the library file which
+% defines symbolic names for e-TeX's constants.
+
+\module {grouptypes}
+\def \grouptypes #1{\csname gr@up: #1\endcsname}
+\def \etexgroupdef #1 
+    {\expandafter \expandafter \expandafter \chardef \grouptypes {#1}}
+\etexgroupdef bottomlevel = 0 %%% {code for the outside world}
+\etexgroupdef simple = 1 %%% {code for local structure only}
+\etexgroupdef hbox = 2 %%% {code for `\.{\\hbox}\grp'}
+\etexgroupdef adjustedhbox = 3 %%% {code for `\.{\\hbox}\grp' in vertical mode}
+\etexgroupdef vbox = 4 %%% {code for `\.{\\vbox}\grp'}
+\etexgroupdef vtop = 5 %%% {code for `\.{\\vtop}\grp'}
+\etexgroupdef align = 6 %%% {code for `\.{\\halign}\grp', `\.{\\valign}\grp'}
+\etexgroupdef noalign = 7 %%% {code for `\.{\\noalign}\grp'}
+\etexgroupdef output = 8 %%% {code for output routine}
+\etexgroupdef math = 9 %%% {code for, e.g, `\.{\char'136}\grp'}
+\etexgroupdef disc = 10 %%% {code for `\.{\\discretionary}\grp\grp\grp'}
+\etexgroupdef insert = 11 %%% {code for `\.{\\insert}\grp', `\.{\\vadjust}\grp'}
+\etexgroupdef vcenter = 12 %%% {code for `\.{\\vcenter}\grp'}
+\etexgroupdef mathchoice = 13 %%% {code for `\.{\\mathchoice}\grp\grp\grp\grp'}
+\etexgroupdef semisimple = 14 %%% {code for `\.{\\begingroup...\\endgroup}'}
+\etexgroupdef mathshift = 15 %%% {code for `\.{\$...\$}'}
+\etexgroupdef mathleft = 16 %%% {code for `\.{\\left...\\right}'}
+\endmodule
+
+\module {interactionmodes}
+\def \interactionmodes #1{\csname m@de: #1\endcsname}
+\def \etexmodedef #1 
+    {\expandafter \expandafter \expandafter \chardef \interactionmodes {#1}}
+\etexmodedef batch = 0 %%% {omits all stops and omits terminal output}
+\etexmodedef nonstop = 1 %%% {omits all stops}
+\etexmodedef scroll = 2 %%% {omits error stops}
+\etexmodedef errorstop = 3 %%% {stops at every opportunity to interact}
+\endmodule
+
+\module {nodetypes}
+\def \nodetypes #1{\csname n@de: #1\endcsname}
+\def \etexnodedef #1 
+    {\expandafter \expandafter \expandafter \chardef \nodetypes {#1}}
+\etexnodedef char = 0 %%% {|type| of character nodes}
+\etexnodedef hlist = 1 %%% {|type| of hlist nodes}
+\etexnodedef vlist = 2 %%% {|type| of vlist nodes}
+\etexnodedef rule = 3 %%% {|type| of rule nodes}
+\etexnodedef ins = 4 %%% {|type| of insertion nodes}
+\etexnodedef mark = 5 %%% {|type| of a mark node}
+\etexnodedef adjust = 6 %%% {|type| of an adjust node}
+\etexnodedef ligature = 7 %%% {|type| of a ligature node}
+\etexnodedef disc = 8 %%% {|type| of a discretionary node}
+\etexnodedef whatsit = 9 %%% {|type| of special extension nodes}
+\etexnodedef math = 10 %%% {|type| of a math node}
+\etexnodedef glue = 11 %%% {|type| of  that points to a glue specification}
+\etexnodedef kern = 12 %%% {|type| of a kern node}
+\etexnodedef penalty = 13 %%% {|type| of a penalty node}
+\etexnodedef unset = 14 %%% {|type| for an unset node}
+\etexnodedef maths = 15 %%% {|type| of nodes that occur only in maths mode}
+\endmodule
+
+\module {iftypes}
+\def \conditionaltypes #1{\csname @f: #1\endcsname}
+\def \etexifdef #1 
+    {\expandafter \expandafter \expandafter \chardef \conditionaltypes {#1}}
+\etexifdef charif = 1
+\etexifdef catif = 2
+\etexifdef numif = 3
+\etexifdef dimif = 4
+\etexifdef oddif = 5
+\etexifdef vmodeif = 6
+\etexifdef hmodeif = 7
+\etexifdef mmodeif = 8
+\etexifdef innerif = 9
+\etexifdef voidif = 10
+\etexifdef hboxif = 11
+\etexifdef vboxif = 12
+\etexifdef xif = 13
+\etexifdef eofif = 14
+\etexifdef trueif = 15
+\etexifdef falseif = 16
+\etexifdef caseif = 17
+\etexifdef definedif = 18
+\etexifdef csnameif = 19
+\etexifdef fontcharif = 20
+\endmodule

package/runtime/dist/bundles/tex-plain/manifest.json

@@ -0,0 +1 @@
+{"name":"tex-plain","version":"2025.1","texlive":"2025","files":{"tex/generic/atbegshi/atbegshi.sty":{"size":24708,"sha":"a73003b4bb2dc8a8"},"tex/generic/babel/hyphen.cfg":{"size":6445,"sha":"f646844e8fab61d1"},"tex/generic/babel/luababel.def":{"size":75294,"sha":"7d720228e51dc87c"},"tex/generic/bigintcalc/bigintcalc.sty":{"size":40635,"sha":"050f2ad3a3671a1f"},"tex/generic/bitset/bitset.sty":{"size":33961,"sha":"af5c7196c69dc9d2"},"tex/generic/chemfig/chemfig-lewis.tex":{"size":5803,"sha":"d907dab915078c7d"},"tex/generic/chemfig/chemfig.sty":{"size":388,"sha":"0c19604354900a8e"},"tex/generic/chemfig/chemfig.tex":{"size":125167,"sha":"18caf07da06abe7c"},"tex/generic/circuitikz/ctikzstyle-example.tex":{"size":280,"sha":"59f577f0360decc9"},"tex/generic/circuitikz/ctikzstyle-legacy.tex":{"size":3150,"sha":"b1b4fd1866df6d18"},"tex/generic/circuitikz/ctikzstyle-romano.tex":{"size":2240,"sha":"69878376ef7ec6ff"},"tex/generic/circuitikz/pgfcirc.defines.tex":{"size":47046,"sha":"ec30235b60a9f072"},"tex/generic/circuitikz/pgfcircbipoles.tex":{"size":319927,"sha":"2c526e5ac600455a"},"tex/generic/circuitikz/pgfcirccurrent.tex":{"size":9538,"sha":"b4067c61c07792dd"},"tex/generic/circuitikz/pgfcircflow.tex":{"size":9804,"sha":"959e6f05fcda8db2"},"tex/generic/circuitikz/pgfcirclabel.tex":{"size":15442,"sha":"ebf9761a4dbdc156"},"tex/generic/circuitikz/pgfcircmonopoles.tex":{"size":62349,"sha":"7531190c1ad26ad4"},"tex/generic/circuitikz/pgfcircmultipoles.tex":{"size":140232,"sha":"3760ab93dcda29df"},"tex/generic/circuitikz/pgfcircpath.tex":{"size":17175,"sha":"7a83c9af92d8dd1a"},"tex/generic/circuitikz/pgfcircquadpoles.tex":{"size":105987,"sha":"875371bdf94a1a42"},"tex/generic/circuitikz/pgfcircshapes.tex":{"size":33716,"sha":"4a72bd0ea8075199"},"tex/generic/circuitikz/pgfcirctripoles.tex":{"size":400264,"sha":"53cdb3a70e6a821f"},"tex/generic/circuitikz/pgfcircutils.tex":{"size":14587,"sha":"ed68f13d561e9d63"},"tex/generic/circuitikz/pgfcircvoltage.tex":{"size":36286,"sha":"821ac7ac0489c1dd"},"tex/generic/etex/etex.src":{"size":33286,"sha":"7af74a3fde135872"},"tex/generic/etexcmds/etexcmds.sty":{"size":7734,"sha":"a7db2834e02bd11b"},"tex/generic/gettitlestring/gettitlestring.sty":{"size":8371,"sha":"26ab10fd43fd5a90"},"tex/generic/hyphen/dumyhyph.tex":{"size":419,"sha":"99d210320228a242"},"tex/generic/hyphen/grahyph5.tex":{"size":36706,"sha":"eeb7329e7dd94b87"},"tex/generic/hyphen/grmhyph5.tex":{"size":5902,"sha":"becdf19387bc265d"},"tex/generic/hyphen/grphyph5.tex":{"size":13326,"sha":"1bfe51dcff12f444"},"tex/generic/hyphen/hyphen.tex":{"size":27860,"sha":"2c18acdc04c1a066"},"tex/generic/hyphen/hypht1.tex":{"size":9081,"sha":"6a96e10de9b34ad9"},"tex/generic/hyphen/ibyhyph.tex":{"size":28651,"sha":"b12db81b0c101b38"},"tex/generic/hyphen/zerohyph.tex":{"size":402,"sha":"80b6e5b7ff3bcd2f"},"tex/generic/iftex/ifetex.sty":{"size":529,"sha":"6a522456643896e4"},"tex/generic/iftex/ifluatex.sty":{"size":492,"sha":"1f1dd9c7cc37bfc5"},"tex/generic/iftex/ifpdf.sty":{"size":480,"sha":"92b2cd262dc42d52"},"tex/generic/iftex/iftex.sty":{"size":7984,"sha":"0dc0cefe2131f823"},"tex/generic/iftex/ifvtex.sty":{"size":1057,"sha":"1138730b9ad7d9f6"},"tex/generic/iftex/ifxetex.sty":{"size":488,"sha":"b4729967ca572a3f"},"tex/generic/infwarerr/infwarerr.sty":{"size":8356,"sha":"8c3e23b8bb7d940f"},"tex/generic/intcalc/intcalc.sty":{"size":31769,"sha":"1343ba1b10b245bf"},"tex/generic/kvdefinekeys/kvdefinekeys.sty":{"size":5412,"sha":"c42f0c2628dc5fbd"},"tex/generic/ltxcmds/ltxcmds.sty":{"size":17865,"sha":"8fea89995d37ba4c"},"tex/generic/luatex85/luatex85.sty":{"size":5870,"sha":"6d2a0ec7974247ec"},"tex/generic/mp-tikz-wasm/tikzlibrarysvg.attributes.code.tex":{"size":6164,"sha":"a4e73b1206f18bee"},"tex/generic/pdfescape/pdfescape.sty":{"size":19007,"sha":"b3f0e56366c11b85"},"tex/generic/pdftex/glyphtounicode.tex":{"size":216747,"sha":"395e568c1f4db5e8"},"tex/generic/pdftex/pdfcolor.tex":{"size":5687,"sha":"84b30448637fd29e"},"tex/generic/pdftexcmds/pdftexcmds.lua":{"size":9447,"sha":"872a8889c423ec55"},"tex/generic/pdftexcmds/pdftexcmds.sty":{"size":20089,"sha":"2df7e0bd148c99d8"},"tex/generic/simplekv/simplekv.sty":{"size":161,"sha":"3fc1096a8c34760b"},"tex/generic/simplekv/simplekv.tex":{"size":12655,"sha":"d4d089826306a58a"},"tex/generic/stringenc/se-ascii-print.def":{"size":3257,"sha":"77c07ed6267049f3"},"tex/generic/stringenc/se-ascii.def":{"size":2870,"sha":"0c8d40cb65411fee"},"tex/generic/stringenc/se-clean7bit.def":{"size":3765,"sha":"aa70dd7e8990b2cb"},"tex/generic/stringenc/se-cp1250.def":{"size":10277,"sha":"d2068e5fa58864c9"},"tex/generic/stringenc/se-cp1251.def":{"size":10128,"sha":"63704757c1c8d231"},"tex/generic/stringenc/se-cp1252.def":{"size":4858,"sha":"e21b611d03bf8e1f"},"tex/generic/stringenc/se-cp1257.def":{"size":9657,"sha":"4ec2651c335029d2"},"tex/generic/stringenc/se-cp437.def":{"size":10585,"sha":"05e91523dc818207"},"tex/generic/stringenc/se-cp850.def":{"size":10434,"sha":"b15d916580e45d29"},"tex/generic/stringenc/se-cp852.def":{"size":10733,"sha":"3dcbfa0c3487f170"},"tex/generic/stringenc/se-cp855.def":{"size":10349,"sha":"3b185da948e95ed6"},"tex/generic/stringenc/se-cp858.def":{"size":10415,"sha":"1e40d8d74672e14a"},"tex/generic/stringenc/se-cp865.def":{"size":10605,"sha":"24af379d5e7ad707"},"tex/generic/stringenc/se-cp866.def":{"size":10531,"sha":"a45de2d50e0d2733"},"tex/generic/stringenc/se-dec-mcs.def":{"size":7864,"sha":"91dc69b841166064"},"tex/generic/stringenc/se-iso-8859-1.def":{"size":3357,"sha":"74c79c0b12b0d39b"},"tex/generic/stringenc/se-iso-8859-10.def":{"size":9508,"sha":"9bfcbfdd02bf6695"},"tex/generic/stringenc/se-iso-8859-11.def":{"size":8046,"sha":"5158a22308bb0043"},"tex/generic/stringenc/se-iso-8859-13.def":{"size":9190,"sha":"787d127c7ad98a00"},"tex/generic/stringenc/se-iso-8859-14.def":{"size":9571,"sha":"7e25fdaaa78e3120"},"tex/generic/stringenc/se-iso-8859-15.def":{"size":9131,"sha":"266c8fb3f31653cb"},"tex/generic/stringenc/se-iso-8859-16.def":{"size":9476,"sha":"29a72ed727e910c2"},"tex/generic/stringenc/se-iso-8859-2.def":{"size":9224,"sha":"2a7c60979e263e0b"},"tex/generic/stringenc/se-iso-8859-3.def":{"size":8734,"sha":"9a6bdf7bce6b185c"},"tex/generic/stringenc/se-iso-8859-4.def":{"size":9196,"sha":"b0737bf21ae2dc40"},"tex/generic/stringenc/se-iso-8859-5.def":{"size":8835,"sha":"ff7ccc62228088ee"},"tex/generic/stringenc/se-iso-8859-6.def":{"size":5528,"sha":"f9fba42471db4619"},"tex/generic/stringenc/se-iso-8859-7.def":{"size":8589,"sha":"4efcfb39cd3fb844"},"tex/generic/stringenc/se-iso-8859-8.def":{"size":5956,"sha":"455433c65e5975f7"},"tex/generic/stringenc/se-iso-8859-9.def":{"size":8976,"sha":"4c3080873d39ce9c"},"tex/generic/stringenc/se-koi8-r.def":{"size":10600,"sha":"62b74a3118529b10"},"tex/generic/stringenc/se-mac-centeuro.def":{"size":11598,"sha":"9e648981230327d5"},"tex/generic/stringenc/se-mac-cyrillic.def":{"size":10942,"sha":"f77f04a3250c56a6"},"tex/generic/stringenc/se-mac-roman.def":{"size":10575,"sha":"a00115bfe651fc0a"},"tex/generic/stringenc/se-nextstep.def":{"size":10464,"sha":"799ca9c1eef76dd1"},"tex/generic/stringenc/se-pdfdoc.def":{"size":5108,"sha":"f168cc1772edb0e2"},"tex/generic/stringenc/se-utf16le.def":{"size":2764,"sha":"20213ef0fd25b6f9"},"tex/generic/stringenc/se-utf32be.def":{"size":4522,"sha":"aed4597f5fce2d1d"},"tex/generic/stringenc/se-utf32le.def":{"size":4718,"sha":"a00be3fae9ee794c"},"tex/generic/stringenc/se-utf8.def":{"size":11635,"sha":"aeecc3b65c8002f2"},"tex/generic/stringenc/stringenc.sty":{"size":21514,"sha":"b134a7bba648a698"},"tex/generic/tex-ini-files/dviluatex.ini":{"size":82,"sha":"cc7cb46692f7a54b"},"tex/generic/tex-ini-files/luatex.ini":{"size":289,"sha":"bc47cd163289fecb"},"tex/generic/tex-ini-files/luatexconfig.tex":{"size":2036,"sha":"e455906a91a8a040"},"tex/generic/tex-ini-files/luatexiniconfig.tex":{"size":606,"sha":"b3e97563b977e36e"},"tex/generic/tex-ini-files/pdftexconfig.tex":{"size":549,"sha":"87102cd6fa7307af"},"tex/generic/tex-ini-files/pdfxmltex.ini":{"size":243,"sha":"0286c93d313d8034"},"tex/generic/tex-ini-files/xetex.ini":{"size":3428,"sha":"6aa9a56c7947f655"},"tex/generic/tex-ini-files/xmltex.ini":{"size":160,"sha":"e7bb21eb0a3457d9"},"tex/generic/uniquecounter/uniquecounter.sty":{"size":7008,"sha":"9d11c81501953d68"},"tex/generic/xkeyval/keyval.tex":{"size":2725,"sha":"7a8dbfe90926a910"},"tex/generic/xkeyval/pst-xkey.tex":{"size":2369,"sha":"4549723f49707c14"},"tex/generic/xkeyval/xkeyval.tex":{"size":19231,"sha":"29c2b60c6973c374"},"tex/generic/xkeyval/xkvtxhdr.tex":{"size":2856,"sha":"cc6150c71e73d1dd"},"tex/generic/xkeyval/xkvutils.tex":{"size":7677,"sha":"5e82c31b1b4492c8"},"tex/plain/base/fontchart.tex":{"size":3201,"sha":"c92c60b5aa85a634"},"tex/plain/base/gkpmac.tex":{"size":36500,"sha":"52787766e84cf3df"},"tex/plain/base/letterformat.tex":{"size":2892,"sha":"def29743d02d0f43"},"tex/plain/base/list-latin.tex":{"size":2292,"sha":"fa7f1928a6846739"},"tex/plain/base/list.tex":{"size":1581,"sha":"6ce822dc31d6934d"},"tex/plain/base/llist-latin.tex":{"size":2894,"sha":"a73985923307aaa0"},"tex/plain/base/llist.tex":{"size":2177,"sha":"b9184319aa034b63"},"tex/plain/base/mptmac.tex":{"size":3267,"sha":"a15782301c853be7"},"tex/plain/base/picmac.tex":{"size":8240,"sha":"111703092e524997"},"tex/plain/base/plain.tex":{"size":44615,"sha":"7c1223b880fa5135"},"tex/plain/base/wlist.tex":{"size":1698,"sha":"dd0f2a0d9743af6e"},"tex/plain/config/etex.ini":{"size":69,"sha":"a6e65150abae7552"},"tex/plain/config/tex.ini":{"size":66,"sha":"c1ccea43dc1c3d07"},"tex/plain/etex/etex.src":{"size":31690,"sha":"00b9b0017fc2347a"},"tex/plain/etex/etexdefs.lib":{"size":3591,"sha":"0c6a325ce1810cff"},"web2c/etex.fmt":{"size":127343,"sha":"b276d57b2fbf5575"},"web2c/plain.fmt":{"size":113546,"sha":"8bdb51b8e06b0f42"}},"eager":[]}

package/runtime/dist/bundles/tikz-snapshot/manifest.json

@@ -0,0 +1 @@
+{"name":"tikz-snapshot","version":"2025.1","texlive":"2025","files":{"web2c/tikz.fmt":{"size":5819794,"sha":"68f750bb1d12ec43"}},"eager":[]}

package/runtime/dist/bundles-config.d.ts

@@ -0,0 +1,3 @@
+import type { BundleName, BundleSpec } from './types.js';
+export declare const DEFAULT_BUNDLES: BundleName[];
+export declare function resolveBundleSpecs(bundles: (BundleName | BundleSpec)[], base: string): BundleSpec[];

package/runtime/dist/bundles-config.js

@@ -0,0 +1,16 @@
+// `opentype` and `otf-fonts` are deliberately absent, and it is not only about size.
+// LaTeX under LuaTeX probes for luaotfload at start-up, so merely making it findable
+// is enough to make every lualatex run load and initialise it: measured here, a
+// document with no fontspec in it went from 214 ms to 396 ms and from 6.6 MB fetched
+// to 11.9 MB. Graph drawing, which is what most LuaTeX documents here want, would pay
+// that for nothing. So OpenType is opt-in, one bundle for the machinery with the
+// Latin Modern text family, and one for the maths font (unicode-math):
+//   MetaPost.create({ bundles: [...DEFAULT_BUNDLES, 'opentype'] })
+//   MetaPost.create({ bundles: [...DEFAULT_BUNDLES, 'opentype', 'otf-fonts'] })
+export const DEFAULT_BUNDLES = ['core', 'cm-tfm', 'cm-type1', 'lm-fonts', 'ps-fonts', 'tex-plain', 'latex-core', 'latex-extra', 'tikz-snapshot', 'luatex'];
+export function resolveBundleSpecs(bundles, base) {
+    if (!base.endsWith('/'))
+        base += '/';
+    return bundles.map((b) => (typeof b === 'string' ? { name: b, manifestUrl: `${base}${b}/manifest.json` } : b));
+}
+//# sourceMappingURL=bundles-config.js.map

package/runtime/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/runtime/dist/cli.js

@@ -0,0 +1,372 @@
+#!/usr/bin/env node
+/**
+ * mpost-wasm — a drop-in for `mpost` for the common flag set (docs/08 §5).
+ *
+ *   mpost-wasm [OPTION]... [MPNAME[.mp]] [COMMANDS]
+ *   mpost-wasm --dvitomp DVINAME[.dvi] [MPXNAME[.mpx]]
+ *   mpost-wasm --prerender [--figures=DIR | --base=DIR] [--force] [--dry-run] PAGE.html...
+ */
+import { MetaPost, LOG_LEVELS, DEFAULT_BUNDLES } from './index.js';
+import { prerender } from './prerender.js';
+const HELP = `Usage: mpost-wasm [OPTION]... [MPNAME[.mp]] [COMMANDS]
+       mpost-wasm --latex [OPTION]... DOC.tex
+       mpost-wasm --prerender [--figures=DIR | --base=DIR] [--force] [--dry-run] PAGE.html...
+  Run MetaPost (WebAssembly build) on MPNAME, writing output files to the
+  current directory like mpost does; or, with --latex, typeset a complete
+  LaTeX/TikZ (or plain TeX, with --plain) document with tex.wasm and convert
+  every page to DOC-<page>.svg with dvisvgm.wasm.
+
+  -interaction=MODE     batchmode|nonstopmode|scrollmode (default nonstopmode)
+  -numbersystem=SYSTEM  scaled|double|decimal (binary/interval are not built)
+  -jobname=STRING       output name (default: basename of MPNAME)
+  -tex=PROGRAM          tex|etex|latex|auto (default auto)
+  -s INTERNAL=VALUE     set an internal, e.g. -s prologues=3 -s outputformat="svg"
+  -halt-on-error        stop at the first error
+  -file-line-error      (accepted; diagnostics always carry file:line)
+  -recorder             write a .fls file listing every file opened
+  -T, -troff            accepted; troff mode is unsupported and warns
+  --format=eps|svg|json output format (default eps; or set outputformat)
+  --texmf=DIR           use a texmf directory (flattened layout) instead of bundles
+  --bundles=DIR         directory containing the bundles (default: next to this package)
+  --stdout              print the first figure to stdout instead of writing files
+  --latex               DOC.tex -> DOC-1.svg, DOC-2.svg ... (LaTeX); --plain for plain TeX
+  --engine=NAME         latex | lualatex | luatex | plain | tex | auto (default auto: lualatex when
+                        the document uses graphdrawing or \directlua)
+  --fonts=paths|woff2   how text is emitted in --latex mode (default paths)
+  --pdf                 with --latex: write DOC.pdf (pdfTeX's or LuaTeX's own PDF output)
+                        instead of SVG pages; with --stdout, the PDF goes to stdout
+  --opentype            load the OpenType bundles so \\usepackage{fontspec} works under
+                        --engine=lualatex; off by default because LaTeX initialises
+                        luaotfload on every LuaTeX run once it can find it
+  --prerender           typeset the <script type="text/tikz|metapost">, <tikz-diagram> and
+                        <metapost-diagram> elements of each PAGE and save each as figure-HASH.svg in
+                        the directory the page's auto.js loader names in data-figures (default
+                        figures/, next to the page); the tags then load the files instead of running
+                        the engines. Files that exist are kept: the name is the content.
+  --figures=DIR         save every page's figures in DIR instead
+  --base=DIR            resolve each page's data-figures against DIR instead of the page's own
+                        directory (for a rendered copy of a page saved elsewhere)
+  --force               re-render figures whose file exists
+  --dry-run             list what would be rendered, render nothing
+  -v, -vv, -vvv         more on stderr: timings; the engines' output as it runs; every file
+  -q, --quiet           nothing on stderr (not even TeX errors)
+  --log-level=LEVEL     silent|error|warn|info|debug|trace (default warn)
+  -help, -version
+`;
+function parseArgs(argv) {
+    const o = {
+        interaction: 'nonstop',
+        numbersystem: 'scaled',
+        jobname: '', tex: 'auto', internals: {},
+        halt: false, recorder: false, troff: false, format: '', texmf: '', bundles: '', opentype: false,
+        stdout: false, file: '', commands: '', help: false, version: false, dvitomp: false,
+        latex: false, plain: false, pdf: false, engine: 'auto', fonts: 'paths',
+        verbose: 0, quiet: false, logLevel: '',
+        prerender: false, figures: '', base: '', force: false, dryRun: false, args: [],
+    };
+    const rest = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = () => argv[++i];
+        const kv = (a.startsWith('--') ? a.slice(2) : a.slice(1));
+        const [k, v] = kv.includes('=') ? [kv.slice(0, kv.indexOf('=')), kv.slice(kv.indexOf('=') + 1)] : [kv, undefined];
+        if (!a.startsWith('-') || a === '-') {
+            rest.push(a);
+            continue;
+        }
+        switch (k) {
+            case 'interaction':
+                o.interaction = (v ?? next()).replace('mode', '');
+                break;
+            case 'numbersystem':
+                o.numbersystem = (v ?? next());
+                break;
+            case 'jobname':
+                o.jobname = v ?? next();
+                break;
+            case 'tex': {
+                const t = v ?? next();
+                o.tex = t === 'tex' ? 'plain' : t;
+                break;
+            }
+            case 's': {
+                const s = v ?? next();
+                const eq = s.indexOf('=');
+                const name = s.slice(0, eq);
+                let val = s.slice(eq + 1);
+                if (/^".*"$/.test(val))
+                    val = val.slice(1, -1);
+                else if (!isNaN(Number(val)))
+                    val = Number(val);
+                o.internals[name] = val;
+                break;
+            }
+            case 'halt-on-error':
+                o.halt = true;
+                break;
+            case 'file-line-error':
+            case 'file-line-error-style': break;
+            case 'no-file-line-error': break;
+            case 'recorder':
+                o.recorder = true;
+                break;
+            case 'T':
+            case 'troff':
+                o.troff = true;
+                break;
+            case 'format':
+                o.format = (v ?? next());
+                break;
+            case 'texmf':
+                o.texmf = v ?? next();
+                break;
+            case 'bundles':
+                o.bundles = v ?? next();
+                break;
+            case 'opentype':
+                o.opentype = true;
+                break;
+            case 'stdout':
+                o.stdout = true;
+                break;
+            case 'pdf':
+                o.pdf = true;
+                break;
+            case 'help':
+                o.help = true;
+                break;
+            case 'version':
+                o.version = true;
+                break;
+            case 'dvitomp':
+                o.dvitomp = true;
+                break;
+            case 'latex':
+                o.latex = true;
+                break;
+            case 'plain':
+                o.plain = true;
+                o.latex = true;
+                o.engine = 'plain';
+                break;
+            case 'engine':
+                o.engine = (v ?? next());
+                o.latex = true;
+                break;
+            case 'fonts':
+                o.fonts = (v ?? next());
+                break;
+            case 'prerender':
+                o.prerender = true;
+                break;
+            case 'figures':
+                o.figures = v ?? next();
+                break;
+            case 'base':
+                o.base = v ?? next();
+                break;
+            case 'force':
+                o.force = true;
+                break;
+            case 'dry-run':
+                o.dryRun = true;
+                break;
+            case 'v':
+            case 'verbose':
+                o.verbose++;
+                break;
+            case 'vv':
+                o.verbose += 2;
+                break;
+            case 'vvv':
+                o.verbose += 3;
+                break;
+            case 'q':
+            case 'quiet':
+                o.quiet = true;
+                break;
+            case 'log-level':
+                o.logLevel = (v ?? next());
+                break;
+            case 'ini':
+            case 'mem':
+            case 'progname':
+            case 'kpathsea-debug':
+            case 'restricted':
+            case 'debug':
+            case 'translate-file':
+            case '8bit':
+                console.error(`mpost-wasm: warning: option -${k} is accepted and ignored`);
+                if (v === undefined && ['mem', 'progname', 'kpathsea-debug', 'translate-file'].includes(k))
+                    next();
+                break;
+            default:
+                console.error(`mpost-wasm: unknown option ${a}`);
+                process.exit(1);
+        }
+    }
+    o.args = [...rest];
+    if (rest.length) {
+        const first = rest[0];
+        if (first.startsWith('&')) {
+            rest.shift();
+        }
+    }
+    if (rest.length) {
+        o.file = rest.shift();
+    }
+    o.commands = rest.join(' ');
+    return o;
+}
+async function main() {
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    const o = parseArgs(process.argv.slice(2));
+    if (o.help) {
+        process.stdout.write(HELP);
+        return;
+    }
+    const logLevel = o.logLevel || (o.quiet ? 'silent' : o.verbose >= 3 ? 'trace' : o.verbose === 2 ? 'debug' : o.verbose === 1 ? 'info' : 'warn');
+    if (!LOG_LEVELS.includes(logLevel)) {
+        console.error(`mpost-wasm: unknown log level ${logLevel} (${LOG_LEVELS.join(', ')})`);
+        process.exit(1);
+    }
+    // Everything the level admits goes to stderr, so stdout stays the transcript (and, with --stdout, the figure).
+    // MetaPost's own errors and warnings are left out: the transcript on stdout carries them, as with mpost.
+    const logger = (r) => {
+        if (!o.prerender && r.source === 'metapost' && (r.level === 'error' || r.level === 'warn'))
+            return;
+        const raw = (r.level === 'debug' || r.level === 'trace') && r.source !== 'host';
+        process.stderr.write(raw ? `${r.source}: ${r.message}\n` : `mpost-wasm: ${r.source === 'host' ? '' : r.source + ': '}${r.message}\n`);
+    };
+    if (o.prerender) {
+        // the browser's defaults (deterministic, seed 42), so the files are the bytes the tags would produce
+        const pages = o.args.filter((a) => !a.startsWith('&'));
+        if (!pages.length) {
+            console.error('mpost-wasm: --prerender needs one or more .html pages');
+            process.exit(1);
+        }
+        for (const p of pages)
+            if (!fs.existsSync(p)) {
+                console.error(`mpost-wasm: cannot open ${p}`);
+                process.exit(1);
+            }
+        // each page's own data-bundles decide its engine's bundles, as in the browser; --opentype adds to them
+        const r = await prerender(pages, {
+            createOptions: { texmfDir: o.texmf || undefined, bundleBaseUrl: o.bundles ? 'file://' + path.resolve(o.bundles) + '/' : undefined, logLevel, logger },
+            addBundles: o.opentype ? ['opentype', 'otf-fonts'] : undefined,
+            figuresDir: o.figures ? path.resolve(o.figures) : undefined, baseDir: o.base ? path.resolve(o.base) : undefined,
+            force: o.force, dryRun: o.dryRun, report: (l) => process.stdout.write(l + '\n'),
+        });
+        const pending = r.entries.filter((e) => e.status === 'pending').length;
+        process.stdout.write(`mpost-wasm: ${r.rendered} rendered, ${r.existing} already saved, ${r.failed} failed${o.dryRun ? `, ${pending} to render` : ''}\n`);
+        process.exit(r.failed ? 1 : 0);
+    }
+    const mp = await MetaPost.create({
+        numberSystem: o.numbersystem, tex: o.tex, interaction: o.interaction, haltOnError: o.halt,
+        texmfDir: o.texmf || undefined, bundleBaseUrl: o.bundles ? 'file://' + path.resolve(o.bundles) + '/' : undefined,
+        bundles: o.opentype ? [...DEFAULT_BUNDLES, 'opentype', 'otf-fonts'] : undefined,
+        deterministic: false, logLevel, logger,
+    });
+    if (o.version) {
+        console.log(`MetaPost ${mp.version.metapost} (mp-tikz-wasm) with ${mp.version.tex}`);
+        mp.dispose();
+        return;
+    }
+    if (o.troff)
+        console.error('mpost-wasm: warning: troff mode is not supported; continuing in TeX mode');
+    if (o.latex) {
+        if (!o.file) {
+            console.error('mpost-wasm: --latex needs a .tex file');
+            process.exit(1);
+        }
+        const f = fs.existsSync(o.file) ? o.file : fs.existsSync(o.file + '.tex') ? o.file + '.tex' : null;
+        if (!f) {
+            console.error(`mpost-wasm: cannot open ${o.file}`);
+            process.exit(1);
+        }
+        const job = o.jobname || path.basename(f).replace(/\.tex$/, '');
+        const sib = {};
+        // sibling inputs; PNG and JPEG too, which pdfTeX and LuaTeX include in PDF output
+        for (const e of fs.readdirSync(path.dirname(f)))
+            if (e !== path.basename(f) && /\.(tex|sty|cls|def|clo|fd|eps|dat|csv|txt|bib|png|jpe?g)$/i.test(e))
+                sib[e] = fs.readFileSync(path.join(path.dirname(f), e));
+        const r = await mp.latex(fs.readFileSync(f, 'utf8'), { engine: o.engine, jobName: job, files: sib, fonts: o.fonts, output: o.pdf ? 'pdf' : 'svg' });
+        // with --pdf --stdout, stdout is the PDF alone: the transcript goes to stderr instead
+        (o.pdf && o.stdout ? process.stderr : process.stdout).write(r.log.endsWith('\n') ? r.log : r.log + '\n');
+        if (o.pdf) {
+            if (r.pdf) {
+                if (o.stdout)
+                    process.stdout.write(r.pdf);
+                else
+                    fs.writeFileSync(`${job}.pdf`, r.pdf);
+            }
+        }
+        else if (o.stdout) {
+            if (r.pages[0])
+                process.stdout.write(r.pages[0]);
+        }
+        else
+            r.pages.forEach((svg, i) => fs.writeFileSync(`${job}-${i + 1}.svg`, svg));
+        fs.writeFileSync(`${job}.log`, r.texLog);
+        mp.dispose();
+        process.exit(r.status === 'error' || r.status === 'fatal' ? 1 : 0);
+    }
+    let source;
+    let jobname = o.jobname;
+    let files = {};
+    if (o.file) {
+        const f = fs.existsSync(o.file) ? o.file : fs.existsSync(o.file + '.mp') ? o.file + '.mp' : null;
+        if (!f) {
+            console.error(`mpost-wasm: cannot open ${o.file}`);
+            process.exit(1);
+        }
+        source = fs.readFileSync(f, 'utf8');
+        if (!jobname)
+            jobname = path.basename(f).replace(/\.mp$/, '');
+        // make sibling .mp files inputtable
+        for (const e of fs.readdirSync(path.dirname(f)))
+            if (/\.(mp|tex|dat|txt)$/.test(e) && e !== path.basename(f))
+                files[e] = fs.readFileSync(path.join(path.dirname(f), e));
+        if (o.commands)
+            source += '\n' + o.commands;
+    }
+    else if (o.commands) {
+        source = o.commands;
+        if (!jobname)
+            jobname = 'mpout';
+    }
+    else {
+        source = fs.readFileSync(0, 'utf8');
+        if (!jobname)
+            jobname = 'mpout';
+    }
+    const internals = { ...o.internals };
+    let format = o.format || 'eps';
+    if (!o.format && typeof internals.outputformat === 'string')
+        format = internals.outputformat === 'svg' ? 'svg' : 'eps';
+    const prologues = typeof internals.prologues === 'number' ? internals.prologues : format === 'svg' ? 3 : 0;
+    const r = await mp.run(source, { jobName: jobname, files, internals, format, prologues, svg: { precision: false, idPrefix: false } });
+    process.stdout.write(r.log.endsWith('\n') ? r.log : r.log + '\n'); // MetaPost's terminal transcript, like mpost
+    // like mpost: the default outputtemplate is %j.%c whatever the format; %o expands to the format's extension
+    const ext = format === 'svg' ? 'svg' : format === 'json' ? 'json' : 'eps';
+    const template = typeof internals.outputtemplate === 'string' ? internals.outputtemplate : `%j.%c`;
+    for (const fig of r.figures) {
+        const name = template.replace('%j', jobname).replace('%c', String(fig.charcode)).replace('%o', ext);
+        const body = format === 'svg' ? fig.svg : format === 'json' ? JSON.stringify(fig.json) : fig.eps;
+        if (o.stdout) {
+            process.stdout.write(body);
+            break;
+        }
+        fs.writeFileSync(name, body);
+    }
+    for (const [name, data] of Object.entries(r.artifacts))
+        if (name !== `${jobname}.log` || true)
+            fs.writeFileSync(name, data);
+    if (o.recorder)
+        fs.writeFileSync(`${jobname}.fls`, r.diagnostics.map(() => '').join(''));
+    mp.dispose();
+    process.exit(r.history >= 2 ? 1 : 0);
+}
+main().catch((e) => { console.error(e?.stack ?? String(e)); process.exit(2); });
+//# sourceMappingURL=cli.js.map

package/runtime/dist/core.d.ts

@@ -0,0 +1,124 @@
+/**
+ * core.ts — the orchestrator (docs/01 §3). Runs in a Worker (browser) or on
+ * the main thread (Node). Owns one mplib.wasm instance for its lifetime and
+ * creates one tex.wasm instance per TeX invocation.
+ */
+import { type MplibModule, type MplibFactory } from './mplib.js';
+import { type TexFactory } from './texengine.js';
+import { type DvisvgmFactory } from './dvisvgm.js';
+import type { Ghostscript } from './ghostscript.js';
+import { BundleSet } from './vfs/bundle.js';
+import { Logger } from './logger.js';
+import type { MetaPostOptions, RunOptions, RunResult, Diagnostic, ProgressEvent, LatexRunOptions, LatexResult, BibtexOptions, MakeindexOptions, ToolResult } from './types.js';
+/** The local references (href="#id") in an SVG that name no element in it. */
+export declare function danglingRefs(svg: string): string[];
+/** Where MetaPost looks for each file type (docs/06 §2). */
+export declare const SEARCH_PATHS: Record<number, string[]>;
+export interface CoreEnv {
+    mplibFactory: MplibFactory;
+    texFactory?: TexFactory;
+    /** luatex.wasm, same module interface as tex.wasm; needed for engine 'lualatex' / 'luatex' */
+    luatexFactory?: TexFactory;
+    dvisvgmFactory?: DvisvgmFactory;
+    /** the Ghostscript module for dvisvgm's PostScript (ghostscript.ts), when enabled; null if it cannot be loaded */
+    ghostscript?: () => Promise<Ghostscript | null>;
+    /** bibtex.wasm and makeindex.wasm, loaded on first use; undefined if this build has none */
+    tools?: (name: 'bibtex' | 'makeindex') => Promise<TexFactory | undefined>;
+    /** bundles merged into /texmf (browser, or Node without texmfDir) */
+    bundles?: BundleSet;
+    /** Node: real directory mounted at /texmf with NODEFS */
+    texmfDir?: string;
+    options: MetaPostOptions;
+    onProgress?: (e: ProgressEvent) => void;
+    onLog?: (line: string) => void;
+    /** where every part of a run reports (docs/08 §4); silent if absent */
+    logger?: Logger;
+}
+export declare class MetaPostCore {
+    private env;
+    M: MplibModule;
+    private cache;
+    private bridge?;
+    readonly version: {
+        metapost: string;
+        tex: string;
+        build: string;
+    };
+    private userFiles;
+    /**
+     * luaotfload's font cache (TEXMF_VAR), carried from one LuaTeX run to the
+     * next. Parsing an OpenType face costs about a second, and every TeX run
+     * gets a fresh filesystem, so without this each render pays that again.
+     */
+    private texmfVar;
+    private get logger();
+    constructor(env: CoreEnv);
+    init(): Promise<void>;
+    private progress;
+    /** The errors and warnings of a finished run, one record each; a MetaPost help paragraph is indented under its error. */
+    private report;
+    private formatId;
+    private installTexmf;
+    /** Restore the font cache this instance has accumulated (LuaTeX runs only). */
+    private installTexmfVar;
+    /**
+     * Start the font cache from the prebuilt name database, if the tree has one
+     * (the `opentype` bundle, or a mounted texmfDir built by make-fontdb). Its
+     * paths are the /texmf ones every instance sees; luaotfload checks only the
+     * index version, and rescans by itself when a lookup misses.
+     */
+    private seedFontDb;
+    /** Keep whatever luaotfload wrote, so the next run starts warm. */
+    private collectTexmfVar;
+    private copyUserFiles;
+    /** Last-chance file resolution when the C search failed: consult bundles, then the user hook. */
+    private findFile;
+    private findFileImpl;
+    private chain;
+    private misses;
+    private stats;
+    private engine;
+    private texDiagnostics;
+    private makeText;
+    private runScript;
+    addFiles(files: Record<string, string | Uint8Array>): void;
+    /**
+     * Take files off this instance that addFiles (or a run's `files`) put there, named as they were
+     * given; with no names, all of them. They otherwise stay for the instance's lifetime, so a host
+     * typesetting one document after another would hand the first one's .aux to the next.
+     */
+    removeFiles(names?: string[]): void;
+    clearCache(): void;
+    run(source: string, ro?: RunOptions): Promise<RunResult>;
+    private lastTexLog;
+    private recentOutput;
+    /**
+     * Typeset a complete LaTeX (or plain TeX) document with tex.wasm and convert
+     * every page to SVG with dvisvgm.wasm — the TikZ/PGF pipeline. Text becomes
+     * glyph outlines unless fonts: 'woff2' is requested.
+     */
+    latex(source: string, lo?: LatexRunOptions): Promise<LatexResult>;
+    /**
+     * BibTeX (bibtex.wasm) on the .aux a latex() run wrote: doc.bbl and doc.blg come back in
+     * artifacts, for the next latex() run. Like latex(), a fresh module each time.
+     */
+    bibtex(bo?: BibtexOptions): Promise<ToolResult>;
+    /** makeindex (makeindex.wasm) on the .idx a latex() run wrote: doc.ind and doc.ilg come back in artifacts. */
+    makeindex(mo?: MakeindexOptions): Promise<ToolResult>;
+    /** One run of a TeX Live utility: what it wrote in /work comes back, its transcript as diagnostics. */
+    private runTool;
+    private hasSnapshot;
+    private typeset;
+    private runMetaPost;
+    /**
+     * Scan the job and every `input`-ed file reachable from it (lexically),
+     * splicing each input file's blocks in at the line of the `input` statement
+     * so the verbatimtex chain seen by the pre-scan matches the run's order.
+     */
+    private scanAll;
+    private resolveInput;
+}
+/** Errors (`! ...` + `l.N`) and package warnings from a TeX transcript, attributed to the document. */
+export declare function parseTexLogDocument(log: string, file: string): Diagnostic[];
+/** Does a LaTeX source need LuaTeX? (TikZ graphdrawing, \directlua, luacode.) Used by engine 'auto'. */
+export declare function needsLuaTeX(source: string): boolean;