sourav-das/stem-separator

1# @jridgewell/sourcemap-codec2 3Encode/decode the `mappings` property of a [sourcemap](https://docs.google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k/edit).4 5 6## Why?7 8Sourcemaps are difficult to generate and manipulate, because the `mappings` property – the part that actually links the generated code back to the original source – is encoded using an obscure method called [Variable-length quantity](https://en.wikipedia.org/wiki/Variable-length_quantity). On top of that, each segment in the mapping contains offsets rather than absolute indices, which means that you can't look at a segment in isolation – you have to understand the whole sourcemap.9 10This package makes the process slightly easier.11 12 13## Installation14 15```bash16npm install @jridgewell/sourcemap-codec17```18 19 20## Usage21 22```js23import { encode, decode } from '@jridgewell/sourcemap-codec';24 25var decoded = decode( ';EAEEA,EAAE,EAAC,CAAE;ECQY,UACC' );26 27assert.deepEqual( decoded, [28	// the first line (of the generated code) has no mappings,29	// as shown by the starting semi-colon (which separates lines)30	[],31 32	// the second line contains four (comma-separated) segments33	[34		// segments are encoded as you'd expect:35		// [ generatedCodeColumn, sourceIndex, sourceCodeLine, sourceCodeColumn, nameIndex ]36 37		// i.e. the first segment begins at column 2, and maps back to the second column38		// of the second line (both zero-based) of the 0th source, and uses the 0th39		// name in the `map.names` array40		[ 2, 0, 2, 2, 0 ],41 42		// the remaining segments are 4-length rather than 5-length,43		// because they don't map a name44		[ 4, 0, 2, 4 ],45		[ 6, 0, 2, 5 ],46		[ 7, 0, 2, 7 ]47	],48 49	// the final line contains two segments50	[51		[ 2, 1, 10, 19 ],52		[ 12, 1, 11, 20 ]53	]54]);55 56var encoded = encode( decoded );57assert.equal( encoded, ';EAEEA,EAAE,EAAC,CAAE;ECQY,UACC' );58```59 60## Benchmarks61 62```63node v20.10.064 65amp.js.map - 45120 segments66 67Decode Memory Usage:68local code                             5815135 bytes69@jridgewell/sourcemap-codec 1.4.15     5868160 bytes70sourcemap-codec                        5492584 bytes71source-map-0.6.1                      13569984 bytes72source-map-0.8.0                       6390584 bytes73chrome dev tools                       8011136 bytes74Smallest memory usage is sourcemap-codec75 76Decode speed:77decode: local code x 492 ops/sec ±1.22% (90 runs sampled)78decode: @jridgewell/sourcemap-codec 1.4.15 x 499 ops/sec ±1.16% (89 runs sampled)79decode: sourcemap-codec x 376 ops/sec ±1.66% (89 runs sampled)80decode: source-map-0.6.1 x 34.99 ops/sec ±0.94% (48 runs sampled)81decode: source-map-0.8.0 x 351 ops/sec ±0.07% (95 runs sampled)82chrome dev tools x 165 ops/sec ±0.91% (86 runs sampled)83Fastest is decode: @jridgewell/sourcemap-codec 1.4.1584 85Encode Memory Usage:86local code                              444248 bytes87@jridgewell/sourcemap-codec 1.4.15      623024 bytes88sourcemap-codec                        8696280 bytes89source-map-0.6.1                       8745176 bytes90source-map-0.8.0                       8736624 bytes91Smallest memory usage is local code92 93Encode speed:94encode: local code x 796 ops/sec ±0.11% (97 runs sampled)95encode: @jridgewell/sourcemap-codec 1.4.15 x 795 ops/sec ±0.25% (98 runs sampled)96encode: sourcemap-codec x 231 ops/sec ±0.83% (86 runs sampled)97encode: source-map-0.6.1 x 166 ops/sec ±0.57% (86 runs sampled)98encode: source-map-0.8.0 x 203 ops/sec ±0.45% (88 runs sampled)99Fastest is encode: local code,encode: @jridgewell/sourcemap-codec 1.4.15100 101 102***103 104 105babel.min.js.map - 347793 segments106 107Decode Memory Usage:108local code                            35424960 bytes109@jridgewell/sourcemap-codec 1.4.15    35424696 bytes110sourcemap-codec                       36033464 bytes111source-map-0.6.1                      62253704 bytes112source-map-0.8.0                      43843920 bytes113chrome dev tools                      45111400 bytes114Smallest memory usage is @jridgewell/sourcemap-codec 1.4.15115 116Decode speed:117decode: local code x 38.18 ops/sec ±5.44% (52 runs sampled)118decode: @jridgewell/sourcemap-codec 1.4.15 x 38.36 ops/sec ±5.02% (52 runs sampled)119decode: sourcemap-codec x 34.05 ops/sec ±4.45% (47 runs sampled)120decode: source-map-0.6.1 x 4.31 ops/sec ±2.76% (15 runs sampled)121decode: source-map-0.8.0 x 55.60 ops/sec ±0.13% (73 runs sampled)122chrome dev tools x 16.94 ops/sec ±3.78% (46 runs sampled)123Fastest is decode: source-map-0.8.0124 125Encode Memory Usage:126local code                             2606016 bytes127@jridgewell/sourcemap-codec 1.4.15     2626440 bytes128sourcemap-codec                       21152576 bytes129source-map-0.6.1                      25023928 bytes130source-map-0.8.0                      25256448 bytes131Smallest memory usage is local code132 133Encode speed:134encode: local code x 127 ops/sec ±0.18% (83 runs sampled)135encode: @jridgewell/sourcemap-codec 1.4.15 x 128 ops/sec ±0.26% (83 runs sampled)136encode: sourcemap-codec x 29.31 ops/sec ±2.55% (53 runs sampled)137encode: source-map-0.6.1 x 18.85 ops/sec ±3.19% (36 runs sampled)138encode: source-map-0.8.0 x 19.34 ops/sec ±1.97% (36 runs sampled)139Fastest is encode: @jridgewell/sourcemap-codec 1.4.15140 141 142***143 144 145preact.js.map - 1992 segments146 147Decode Memory Usage:148local code                              261696 bytes149@jridgewell/sourcemap-codec 1.4.15      244296 bytes150sourcemap-codec                         302816 bytes151source-map-0.6.1                        939176 bytes152source-map-0.8.0                           336 bytes153chrome dev tools                        587368 bytes154Smallest memory usage is source-map-0.8.0155 156Decode speed:157decode: local code x 17,782 ops/sec ±0.32% (97 runs sampled)158decode: @jridgewell/sourcemap-codec 1.4.15 x 17,863 ops/sec ±0.40% (100 runs sampled)159decode: sourcemap-codec x 12,453 ops/sec ±0.27% (101 runs sampled)160decode: source-map-0.6.1 x 1,288 ops/sec ±1.05% (96 runs sampled)161decode: source-map-0.8.0 x 9,289 ops/sec ±0.27% (101 runs sampled)162chrome dev tools x 4,769 ops/sec ±0.18% (100 runs sampled)163Fastest is decode: @jridgewell/sourcemap-codec 1.4.15164 165Encode Memory Usage:166local code                              262944 bytes167@jridgewell/sourcemap-codec 1.4.15       25544 bytes168sourcemap-codec                         323048 bytes169source-map-0.6.1                        507808 bytes170source-map-0.8.0                        507480 bytes171Smallest memory usage is @jridgewell/sourcemap-codec 1.4.15172 173Encode speed:174encode: local code x 24,207 ops/sec ±0.79% (95 runs sampled)175encode: @jridgewell/sourcemap-codec 1.4.15 x 24,288 ops/sec ±0.48% (96 runs sampled)176encode: sourcemap-codec x 6,761 ops/sec ±0.21% (100 runs sampled)177encode: source-map-0.6.1 x 5,374 ops/sec ±0.17% (99 runs sampled)178encode: source-map-0.8.0 x 5,633 ops/sec ±0.32% (99 runs sampled)179Fastest is encode: @jridgewell/sourcemap-codec 1.4.15,encode: local code180 181 182***183 184 185react.js.map - 5726 segments186 187Decode Memory Usage:188local code                              678816 bytes189@jridgewell/sourcemap-codec 1.4.15      678816 bytes190sourcemap-codec                         816400 bytes191source-map-0.6.1                       2288864 bytes192source-map-0.8.0                        721360 bytes193chrome dev tools                       1012512 bytes194Smallest memory usage is local code195 196Decode speed:197decode: local code x 6,178 ops/sec ±0.19% (98 runs sampled)198decode: @jridgewell/sourcemap-codec 1.4.15 x 6,261 ops/sec ±0.22% (100 runs sampled)199decode: sourcemap-codec x 4,472 ops/sec ±0.90% (99 runs sampled)200decode: source-map-0.6.1 x 449 ops/sec ±0.31% (95 runs sampled)201decode: source-map-0.8.0 x 3,219 ops/sec ±0.13% (100 runs sampled)202chrome dev tools x 1,743 ops/sec ±0.20% (99 runs sampled)203Fastest is decode: @jridgewell/sourcemap-codec 1.4.15204 205Encode Memory Usage:206local code                              140960 bytes207@jridgewell/sourcemap-codec 1.4.15      159808 bytes208sourcemap-codec                         969304 bytes209source-map-0.6.1                        930520 bytes210source-map-0.8.0                        930248 bytes211Smallest memory usage is local code212 213Encode speed:214encode: local code x 8,013 ops/sec ±0.19% (100 runs sampled)215encode: @jridgewell/sourcemap-codec 1.4.15 x 7,989 ops/sec ±0.20% (101 runs sampled)216encode: sourcemap-codec x 2,472 ops/sec ±0.21% (99 runs sampled)217encode: source-map-0.6.1 x 2,200 ops/sec ±0.17% (99 runs sampled)218encode: source-map-0.8.0 x 2,220 ops/sec ±0.37% (99 runs sampled)219Fastest is encode: local code220 221 222***223 224 225vscode.map - 2141001 segments226 227Decode Memory Usage:228local code                           198955264 bytes229@jridgewell/sourcemap-codec 1.4.15   199175352 bytes230sourcemap-codec                      199102688 bytes231source-map-0.6.1                     386323432 bytes232source-map-0.8.0                     244116432 bytes233chrome dev tools                     293734280 bytes234Smallest memory usage is local code235 236Decode speed:237decode: local code x 3.90 ops/sec ±22.21% (15 runs sampled)238decode: @jridgewell/sourcemap-codec 1.4.15 x 3.95 ops/sec ±23.53% (15 runs sampled)239decode: sourcemap-codec x 3.82 ops/sec ±17.94% (14 runs sampled)240decode: source-map-0.6.1 x 0.61 ops/sec ±7.81% (6 runs sampled)241decode: source-map-0.8.0 x 9.54 ops/sec ±0.28% (28 runs sampled)242chrome dev tools x 2.18 ops/sec ±10.58% (10 runs sampled)243Fastest is decode: source-map-0.8.0244 245Encode Memory Usage:246local code                            13509880 bytes247@jridgewell/sourcemap-codec 1.4.15    13537648 bytes248sourcemap-codec                       32540104 bytes249source-map-0.6.1                     127531040 bytes250source-map-0.8.0                     127535312 bytes251Smallest memory usage is local code252 253Encode speed:254encode: local code x 20.10 ops/sec ±0.19% (38 runs sampled)255encode: @jridgewell/sourcemap-codec 1.4.15 x 20.26 ops/sec ±0.32% (38 runs sampled)256encode: sourcemap-codec x 5.44 ops/sec ±1.64% (18 runs sampled)257encode: source-map-0.6.1 x 2.30 ops/sec ±4.79% (10 runs sampled)258encode: source-map-0.8.0 x 2.46 ops/sec ±6.53% (10 runs sampled)259Fastest is encode: @jridgewell/sourcemap-codec 1.4.15260```261 262# License263 264MIT265