Repository files navigation

magic-string with the capability of committing changes.

One of the great features of MagicString is that it always relates to the original string positions. However, in some cases, you want to make changes on top of the previously changed string. Usually, you will need to create a newMagicString instance and apply the changes again, which then will end up with multiple sourcemaps that you also need to combine manually. This package makes it magically work on a single instance and generate a single auto-combined sourcemap.

This package extendsMagicString class by adding two methods.commit() and.rollback(). Under the hood, it also proxies all the operations methods.

Commit all the changes made so far to MagicString.s.original will become the current transformed result. And the positions will now be based on the new string. Under the hood, it creates a newMagicString instance and swaps all the methods to the new instance.

Rollback to the state before the last commit. It throws an error if there is no previous commit.

Supercharge the originalgenerateMap method. Where there are multiple commits, it will generate a combined sourcemap using@jridgewell/remapping.

importMagicStringStackfrom'magic-string-stack'consts=newMagicStringStack('problems = 99')s.replace('problems','issues').prepend('var ')s.toString()// 'var issues = 99's.original// 'problems = 99' (original string)s.commit()// this will commit the changess.original// 'var issues = 99' (applied with previous changes)s.replace('issues','problems')s.toString()// 'var problems = 99's.generateMap()// generate sourcemap, if multiple commits happened, it will generate a combined sourcemap

MIT License © 2023-PRESENTAnthony Fu