SVGO plugin execution order and optimization variance after version upgrades

Ensuring Consistent SVG Optimization Across Versions

To validate that a plugin sequence remains idempotent across version upgrades, you must implement a regression test suite that compares the checksums or structural diffs of a representative set of SVG files processed by both the legacy and updated versions of SVGO. Because SVGO executes plugins in the strict order defined in the configuration array, any variance in output is typically the result of a change in the internal logic of a specific plugin or a shift in the default plugin sequence.

Strategy for Validating Idempotency

Idempotency in this context means that applying the same optimization pipeline to an already optimized file produces no further changes. To verify this across upgrades:

• Baseline Comparison: Process a set of complex SVGs using the current version and save the output. Process the same files with the new version. Use a tool like diff or a visual regression tool to identify exactly which attributes or paths changed.
• Single-Pass Verification: Disable the --multipass flag during validation. Multipass can hide ordering issues by eventually reaching a stable state, whereas a single-pass execution reveals if a plugin is firing too early to act on the output of a preceding one.
• Checksum Validation: For CI/CD pipelines, generate SHA-256 hashes of the output files. A mismatch after a version bump indicates a change in the optimization result.

Preventing Supersession by Default Plugins

To ensure critical optimization passes are not overridden or superseded by new defaults introduced in later releases, you must move from a preset-based configuration to an explicit plugin list. Using plugins: 'preset-default' or plugins: true makes your output dependent on the SVGO maintainers' internal list, which evolves between versions.

Structure your configuration to explicitly define the sequence:

// svgo.config.js
module.exports = {
  plugins: [
    { name: 'preset-default', params: { overrides: { disable: ['removeViewBox'] } } },
    'cleanupIds',
    'convertPathData',
    // Add custom or critical plugins here to ensure they run AFTER the defaults
  ],
};

Likely Explanations for Variance

While the configuration order is the primary driver, variance often stems from these factors:

• Plugin Logic Updates: A plugin may change how it handles nested structures or duplicate IDs between versions, altering the final XML.
• Dependency Chains: Some plugins require the output of another (e.g., a plugin that cleans up attributes may need to run after a plugin that transforms coordinates).

Diagnostic Detail Needed: Are you currently using the preset-default configuration, or a fully manual list of plugins? This determines whether the variance is caused by a change in SVGO's internal defaults or a breaking change in a specific plugin's logic.