Repository navigation
Changes
- Plotly figures.
\interactiveruntime[runtime=plotly@1, alt={...}]{charts/fig.json}shows a figure saved with Python'sfig.write_json(), with Plotly's hover. It takes the paper's style in light and dark mode: backdrop, ink, font, palette, colour scales, hover labels and tables. Colours Plotly Express copied from its default template follow the paper too. Anything you set yourself wins, andtemplate=figurekeeps the figure's own template. Leave outposter=and Maleficium renders the poster. - Reader styles reach the widgets. The
--m-*theme tokens a\maleficiumreaderstylestylesheet sets on.m-readerand.m-reader[data-theme=dark]now reach every widget and rendered poster, not only the page. Set--m-cat-1to--m-cat-8to recolour every chart that uses the paper's palette. A value the theme does not allow is left out with an export warning. - One macro for every runtime widget.
\interactivemodel,\interactivechart,\interactivetableand\interactivevideoare gone. Write\interactiveruntime[runtime=model@1, ...]{models/mesh.glb}(orchart@1,table@1,video@1) with the same options as before. A paper that still uses the old macros stops compiling until it is changed.\interactivefor your own HTML is unchanged. - Table and video options work from LaTeX. A table (
runtime=table@1) takessort=,filter=,columns=,format=andmaxrows=, and a video (runtime=video@1) takesloop=andmuted=. The runtimes read them, but the package refused them, so no paper could set them. Separate the items of a list with;. A key the widget's runtime does not declare fails the compile and names the widget type. - Exported papers load widgets as you reach them. Each interactive figure shows its poster until you scroll near it, and only then starts its widget, so a paper opens faster and a widget you never scroll to never runs. A folder bundle does not even download it. A widget also waits while its tab is in the background, and one held back for approval never starts. Once started, a widget stays live.
- Video posters from a moment of the video. A video takes
at=, a time in seconds: with it,poster=is optional, and Maleficium renders the frame at that time as the poster when you compile. The live video starts at the same frame. The frame is rendered in a separate process that is stopped when it overruns its time limit, so a video that never finishes seeking cannot hang the editor. A frame that comes back blank is refused rather than used, and the widget keeps its placeholder. Tested on Linux; on macOS and Windows it is untested.
Fixes
- The Linux
.debinstalls on Ubuntu 26.04. It depended onlibicu74,libpng16-16t64andlibxml2, which do not exist under those names on Ubuntu 26.04 (or on Debian 12), soaptrefused it there. The engine now carries ICU, libxml2, libxslt, graphite2, FreeType, fontconfig and libpng inside itself, and the package depends only on GTK 3, WebKitGTK 4.1 andlibstdc++6. Checked in CI with a dry-run install on Ubuntu 24.04 and 26.04. The oldest base is unchanged (glibc 2.39, Ubuntu 24.04), and the engine grows from about 80 to 118 MB. - The macOS app needs nothing installed first. The bundled engine linked ICU, FreeType, libpng and graphite2 from Homebrew, so on a Mac without Homebrew every compile failed with
Library not loaded: libicuuc.78.dylib. The engine now carries those libraries inside itself and links only what macOS ships. Checked in CI with Homebrew and the developer tools hidden; not yet on a Mac that never had them.
For contributors
-
Paper bundles are format 2. Built-in widgets bind through their
runtime.jsonthe way custom runtimes do: options arrive typed and defaulted, PDF-only ones likepdfrowsstay out, and the manifest'sruntimeslists every runtime a live widget runs, each flaggedbuiltinor not. The newpaper-bundle-2schema leaves the widget type open, and the reader mounts whateverruntimeslists instead of keeping its own list of kinds. The Article tab logs where each figure settled (article.widget). -
Built-in runtimes have manifests. Model, video, table and chart each declare a
runtime.jsonbeside their source, read from one registry in the app; a test fails when any list of widget kinds drifts from it. A custom runtime'sruntime.jsonthat useskit,paramsorextendsis refused as reserved for a later contract. -
Widget behaviour follows the manifests. Which source a widget needs, which role may be
remote=, how its poster is made (rendered, cropped from the PDF, or given by the document) and which poster options it takes now come from its runtime'sruntime.json, not from code per kind. The generated TypeScriptWidgetTypeis a plain string for now. Poster errors name the runtime and why:table@1 posters are cropped from the PDF, nothing to render. -
The package smoke test checks that a release needs nothing installed first. CI runners have Homebrew, vcpkg, MSYS and the Visual C++ runtime, so a package that quietly depended on any of them passed.
e2e/package-smoke.pynow lists every binary's libraries on each OS and fails on any outside the system's own or the package's (macOSotool -Lover the whole.app, Windows PE imports over every.exeand.dll, Linux ELFDT_NEEDEDagainst the C library and the.deb's Depends, or against the AppImage's contents plus the host libraries AppImages assume), with one report format. macOS runs its compile and launch probes with Homebrew and the developer tools moved aside; Windows runs them with onlySystem32onPATH. The Windows Visual C++ denylist is now an allowlist of the 17 system DLLs the binaries import. -
CI shares its npm and engine steps.
.github/actions/npmand.github/actions/enginereplace the copies in the build, e2e and fixture jobs, and the macOS Homebrew packages are listed inscripts/macos-brew.txtbesidelinux-deps.txtandvcpkg-ports.txt. The macOS engine builds graphite2 1.3.14 statically from a checksum-pinned release, because Homebrew ships only a dynamic one. -
Pre-commit. Whitespace hooks (trailing whitespace, end of file, line endings, UTF-8 BOM) run, pre-commit and the release scripts run through
uv, and the large-file check skips binary media and HTML..gitattributesmarks vendored and generated files so they stay out of the language statistics.