#svgo.mbt

$ svgo testdata/sketch-icon.svg --stats
<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><title>icon/action/close</title><g fill="red" transform="translate(2 2)"><path stroke="red" stroke-linecap="round" stroke-width="2" d="M4 4l12 12M16 4 4 16"/><path d="M0 0h20v20H0z"/></g></svg>
testdata/sketch-icon.svg: 836 -> 276 bytes (-67%), 3 pass(es), plugins: removeXMLProcInst, removeComments, ...

#Why

• Safe by construction and by test. Plugins only remove what a renderer cannot observe; ids that are referenced anywhere survive; inherited defaults are only dropped when no ancestor overrides them. Every fixture is rasterized before and after with resvg and compared pixel by pixel.
• Fast. In one Node process the wasm build is 1.7 to 4.4 times faster than svgo-js on the same files (2.9× at the median); on a small icon the native CLI finishes end to end in about 10 ms, the Node build in about 50 ms, the svgo CLI in about 160 ms (scripts/cli-bench.sh). Numbers below.
• Plugins are values. { name, description, run }. The preset is an array in svgo's order; the CLI, the playground and the tests run any subset in any order.

#Install and use

npm i @rivus/svgo

import { optimize } from "@rivus/svgo";
const r = await optimize(svg, { precision: 3 });
r.data; r.originalSize; r.size; r.passes; r.applied;

npx @rivus/svgo input.svg -o out.svg
cat input.svg | npx @rivus/svgo > out.svg       # stdin, or pass "-" as the input
npx @rivus/svgo icons -r -o dist                # a directory, recursively
# installed (npm i -g @rivus/svgo) the command is `svgo-mbt`

moon build --target native --release          # -> $(scripts/bin-path.sh), under _build/native/release/
svgo-mbt input.svg                            # optimized SVG on stdout
svgo-mbt input.svg -o out.svg --stats         # write a file, print size statistics
svgo-mbt input.svg -p 2 --pretty              # 2 decimal places, indented output
svgo-mbt input.svg --json                     # {data, originalSize, size, passes, applied}
svgo-mbt input.svg --plugins convertPathData,sortAttrs
svgo-mbt input.svg --param cleanupIds.preserve=logo,icon --param cleanupIds.minify=false
svgo-mbt input.svg --disable convertShapeToPath --enable moveGroupAttrsToElems
svgo-mbt --list                               # available plugins

moon add PerfectPan/svgo

///|
test "optimize" {
  let result = @svgo.optimize(
    (
      #|<svg xmlns="http://www.w3.org/2000/svg" width="10px" height="10px">
      #|  <!-- Generator: Sketch -->
      #|  <g fill="#FF0000" stroke="none">
      #|    <rect x="0" y="0" width="10.000" height="10.000"/>
      #|  </g>
      #|</svg>
    ),
  )
  inspect(
    result.data,
    content=(
      #|<svg xmlns="http://www.w3.org/2000/svg" width="10" height="10"><path fill="red" d="M0 0h10v10H0z"/></svg>
    ),
  )
}

///|
test "config" {
  let config = { ..@svgo.Config::default(), precision: 1, pretty: true, }
  let r = @svgo.optimize(
    "<svg xmlns=\"http://www.w3.org/2000/svg\"><path d=\"M0.123 0.456 L 10 10\"/></svg>",
    config~,
  )
  inspect(
    r.data,
    content=(
      #|<svg xmlns="http://www.w3.org/2000/svg">
      #|  <path d="M.1.5 10 10"/>
      #|</svg>
      #|
    ),
  )
}

#Plugins

#Performance

#Verifying correctness

scripts/verify.sh            # check, fmt, .mbti drift, fixtures, tests on js / native
scripts/verify.sh --full     # + wasm build, sizes vs svgo-js, resvg pixel diff, speed (needs pnpm install)
scripts/regress.sh <ref-dir> # byte-for-byte output comparison against a reference build

#Compatibility with svgo, measured

#Repository layout

svgo/                 the MoonBit module: xml/ path/ plugins/ (+ fixtures) svgo.mbt wasm/ benchmark/ testdata/
packages/svgo-mbt/    npm package: JS loader + svgo.wasm + the CLI bin
packages/compare/     svgo-js comparison, resvg render diff, same-process speed, site numbers
app/website/          the website: a MoonBit (Rabbita) app that imports svgo/, Tailwind v4, Remotion hero
app/cli/              the CLI: a MoonBit executable that imports svgo/, C file I/O on native
scripts/              build-wasm, build-cli, verify, bench, regress, gen-fixtures

#License

#Plugin parameters