feat(image): make math packages configurable. Closes #1295

lua/snacks/image/doc.lua

@@ -40,7 +40,8 @@ M.transforms = {
     if not content:find("^\\begin") then
       content = ("\\[%s\\]"):format(content)
     end
-    local packages = { "xcolor", "amsmath", "amssymb" }
+    local packages = { "xcolor" }
+    vim.list_extend(packages, Snacks.image.config.convert.math.packages)
     for _, line in ipairs(vim.api.nvim_buf_get_lines(ctx.buf, 0, -1, false)) do
       if line:find("\\usepackage") then
         for _, p in ipairs(vim.split(line:match("{(.-)}") or "", ",%s*")) do

lua/snacks/image/init.lua

@@ -103,6 +103,11 @@ local defaults = {
   ---@class snacks.image.convert.Config
   convert = {
     notify = true, -- show a notification on error
+    math = {
+      -- for latex documents, the doc packages are included automatically,
+      -- but you can add more packages here. Useful for markdown documents.
+      packages = { "amsmath", "amssymb", "amsfonts", "amscd", "mathtools", "physics", "siunitx", "mhchem" },
+    },
     ---@type snacks.image.args
     mermaid = function()
       local theme = vim.o.background == "light" and "neutral" or "dark"

tests/image/test.tex

@@ -2,6 +2,7 @@
 \usepackage{graphicx}  % For images
 \usepackage{amsmath}  % For math symbols
 \usepackage{amssymb}  % For extra math symbols
+\usepackage{multirow}  % For extra math symbols
 
 \begin{document}
 
@@ -20,8 +21,17 @@ Inline image:
 
 \newpage
 
+
 \section{Math Tests}
 
+
+$
+  cases(
+  E_x = E_0 e^(j omega t - y z),
+  H_y = gamma / (j omega mu_0) E_x = eta^e E_0 e^(j omega - y z) = H_0 e^(j omega t - y z)
+ )
+$
+
 Inline math: \(E=mc^2$ and $\int_0^1 x^2 \,dx\)
 
 Inline math: $E=mc^2$ and $\int_0^1 x^2 \,dx$

tests/image/test.typ

@@ -11,7 +11,7 @@
 #set text(size: 12pt, fill: rgb("#FF0000"))
 $ 5 + 5 = 10 $
 
-$ E = m c^2 $
+$ E = g c^2 $
 
 $ A = pi r^2 $
 
@@ -21,7 +21,8 @@ $ cal(A) :=
 
     { x in RR | x "is natural" } $
 #let x = 5
-$ #x < 17 $
+
+$ x < 17 $
 
 $ (3x + y) / 7 &= 9 && "given" \
   3x + y &= 63 & "multiply by 7" \