initial commit
This commit is contained in:
227
node_modules/@rollup/plugin-replace/README.md
generated
vendored
Normal file
227
node_modules/@rollup/plugin-replace/README.md
generated
vendored
Normal file
@@ -0,0 +1,227 @@
|
||||
[npm]: https://img.shields.io/npm/v/@rollup/plugin-replace
|
||||
[npm-url]: https://www.npmjs.com/package/@rollup/plugin-replace
|
||||
[size]: https://packagephobia.now.sh/badge?p=@rollup/plugin-replace
|
||||
[size-url]: https://packagephobia.now.sh/result?p=@rollup/plugin-replace
|
||||
|
||||
[![npm][npm]][npm-url]
|
||||
[![size][size]][size-url]
|
||||
[](https://liberamanifesto.com)
|
||||
|
||||
# @rollup/plugin-replace
|
||||
|
||||
🍣 A Rollup plugin which replaces targeted strings in files while bundling.
|
||||
|
||||
## Requirements
|
||||
|
||||
This plugin requires an [LTS](https://github.com/nodejs/Release) Node version (v14.0.0+) and Rollup v1.20.0+.
|
||||
|
||||
## Install
|
||||
|
||||
Using npm:
|
||||
|
||||
```console
|
||||
npm install @rollup/plugin-replace --save-dev
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
Create a `rollup.config.js` [configuration file](https://www.rollupjs.org/guide/en/#configuration-files) and import the plugin:
|
||||
|
||||
```js
|
||||
import replace from '@rollup/plugin-replace';
|
||||
|
||||
export default {
|
||||
input: 'src/index.js',
|
||||
output: {
|
||||
dir: 'output',
|
||||
format: 'cjs'
|
||||
},
|
||||
plugins: [
|
||||
replace({
|
||||
'process.env.NODE_ENV': JSON.stringify('production'),
|
||||
__buildDate__: () => JSON.stringify(new Date()),
|
||||
__buildVersion: 15
|
||||
})
|
||||
]
|
||||
};
|
||||
```
|
||||
|
||||
Then call `rollup` either via the [CLI](https://www.rollupjs.org/guide/en/#command-line-reference) or the [API](https://www.rollupjs.org/guide/en/#javascript-api).
|
||||
|
||||
The configuration above will replace every instance of `process.env.NODE_ENV` with `"production"` and `__buildDate__` with the result of the given function in any file included in the build.
|
||||
|
||||
_Note: Values must be either primitives (e.g. string, number) or `function` that returns a string. For complex values, use `JSON.stringify`. To replace a target with a value that will be evaluated as a string, set the value to a quoted string (e.g. `"test"`) or use `JSON.stringify` to preprocess the target string safely._
|
||||
|
||||
Typically, `@rollup/plugin-replace` should be placed in `plugins` _before_ other plugins so that they may apply optimizations, such as dead code removal.
|
||||
|
||||
## Options
|
||||
|
||||
In addition to the properties and values specified for replacement, users may also specify the options below.
|
||||
|
||||
### `delimiters`
|
||||
|
||||
Type: `Array[String, String]`<br>
|
||||
Default: `['\\b', '\\b(?!\\.)']`
|
||||
|
||||
Specifies the boundaries around which strings will be replaced. By default, delimiters are [word boundaries](https://www.regular-expressions.info/wordboundaries.html) and also prevent replacements of instances with nested access. See [Word Boundaries](#word-boundaries) below for more information.
|
||||
For example, if you pass `typeof window` in `values` to-be-replaced, then you could expect the following scenarios:
|
||||
|
||||
- `typeof window` **will** be replaced
|
||||
- `typeof window.document` **will not** be replaced due to `(?!\.)` boundary
|
||||
- `typeof windowSmth` **will not** be replaced due to a `\b` boundary
|
||||
|
||||
Delimiters will be used to build a `Regexp`. To match special characters (any of `.*+?^${}()|[]\`), be sure to [escape](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping) them.
|
||||
|
||||
### `objectGuards`
|
||||
|
||||
Type: `Boolean`<br>
|
||||
Default: `false`
|
||||
|
||||
When replacing dot-separated object properties like `process.env.NODE_ENV`, will also replace `typeof process` object guard
|
||||
checks against the objects with the string `"object"`.
|
||||
|
||||
For example:
|
||||
|
||||
```js
|
||||
replace({
|
||||
values: {
|
||||
'process.env.NODE_ENV': '"production"'
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
```js
|
||||
// Input
|
||||
if (typeof process !== 'undefined' && process.env.NODE_ENV === 'production') {
|
||||
console.log('production');
|
||||
}
|
||||
// Without `objectGuards`
|
||||
if (typeof process !== 'undefined' && 'production' === 'production') {
|
||||
console.log('production');
|
||||
}
|
||||
// With `objectGuards`
|
||||
if ('object' !== 'undefined' && 'production' === 'production') {
|
||||
console.log('production');
|
||||
}
|
||||
```
|
||||
|
||||
### `preventAssignment`
|
||||
|
||||
Type: `Boolean`<br>
|
||||
Default: `false`
|
||||
|
||||
Prevents replacing strings where they are followed by a single equals sign. For example, where the plugin is called as follows:
|
||||
|
||||
```js
|
||||
replace({
|
||||
values: {
|
||||
'process.env.DEBUG': 'false'
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
Observe the following code:
|
||||
|
||||
```js
|
||||
// Input
|
||||
process.env.DEBUG = false;
|
||||
if (process.env.DEBUG == true) {
|
||||
//
|
||||
}
|
||||
// Without `preventAssignment`
|
||||
false = false; // this throws an error because false cannot be assigned to
|
||||
if (false == true) {
|
||||
//
|
||||
}
|
||||
// With `preventAssignment`
|
||||
process.env.DEBUG = false;
|
||||
if (false == true) {
|
||||
//
|
||||
}
|
||||
```
|
||||
|
||||
### `exclude`
|
||||
|
||||
Type: `String` | `Array[...String]`<br>
|
||||
Default: `null`
|
||||
|
||||
A [picomatch pattern](https://github.com/micromatch/picomatch), or array of patterns, which specifies the files in the build the plugin should _ignore_. By default no files are ignored.
|
||||
|
||||
### `include`
|
||||
|
||||
Type: `String` | `Array[...String]`<br>
|
||||
Default: `null`
|
||||
|
||||
A [picomatch pattern](https://github.com/micromatch/picomatch), or array of patterns, which specifies the files in the build the plugin should operate on. By default all files are targeted.
|
||||
|
||||
### `values`
|
||||
|
||||
Type: `{ [key: String]: Replacement }`, where `Replacement` is either a string or a `function` that returns a string.
|
||||
Default: `{}`
|
||||
|
||||
To avoid mixing replacement strings with the other options, you can specify replacements in the `values` option. For example, the following signature:
|
||||
|
||||
```js
|
||||
replace({
|
||||
include: ['src/**/*.js'],
|
||||
changed: 'replaced'
|
||||
});
|
||||
```
|
||||
|
||||
Can be replaced with:
|
||||
|
||||
```js
|
||||
replace({
|
||||
include: ['src/**/*.js'],
|
||||
values: {
|
||||
changed: 'replaced'
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
## Word Boundaries
|
||||
|
||||
By default, values will only match if they are surrounded by _word boundaries_.
|
||||
|
||||
Consider the following options and build file:
|
||||
|
||||
```js
|
||||
module.exports = {
|
||||
...
|
||||
plugins: [replace({ changed: 'replaced' })]
|
||||
};
|
||||
```
|
||||
|
||||
```js
|
||||
// file.js
|
||||
console.log('changed');
|
||||
console.log('unchanged');
|
||||
```
|
||||
|
||||
The result would be:
|
||||
|
||||
```js
|
||||
// file.js
|
||||
console.log('replaced');
|
||||
console.log('unchanged');
|
||||
```
|
||||
|
||||
To ignore word boundaries and replace every instance of the string, wherever it may be, specify empty strings as delimiters:
|
||||
|
||||
```js
|
||||
export default {
|
||||
...
|
||||
plugins: [
|
||||
replace({
|
||||
changed: 'replaced',
|
||||
delimiters: ['', '']
|
||||
})
|
||||
]
|
||||
};
|
||||
```
|
||||
|
||||
## Meta
|
||||
|
||||
[CONTRIBUTING](/.github/CONTRIBUTING.md)
|
||||
|
||||
[LICENSE (MIT)](/LICENSE)
|
||||
153
node_modules/@rollup/plugin-replace/dist/cjs/index.js
generated
vendored
Normal file
153
node_modules/@rollup/plugin-replace/dist/cjs/index.js
generated
vendored
Normal file
@@ -0,0 +1,153 @@
|
||||
'use strict';
|
||||
|
||||
Object.defineProperty(exports, '__esModule', { value: true });
|
||||
|
||||
var MagicString = require('magic-string');
|
||||
var pluginutils = require('@rollup/pluginutils');
|
||||
|
||||
function escape(str) {
|
||||
return str.replace(/[-[\]/{}()*+?.\\^$|]/g, '\\$&');
|
||||
}
|
||||
|
||||
function ensureFunction(functionOrValue) {
|
||||
if (typeof functionOrValue === 'function') { return functionOrValue; }
|
||||
return function () { return functionOrValue; };
|
||||
}
|
||||
|
||||
function longest(a, b) {
|
||||
return b.length - a.length;
|
||||
}
|
||||
|
||||
function getReplacements(options) {
|
||||
if (options.values) {
|
||||
return Object.assign({}, options.values);
|
||||
}
|
||||
var values = Object.assign({}, options);
|
||||
delete values.delimiters;
|
||||
delete values.include;
|
||||
delete values.exclude;
|
||||
delete values.sourcemap;
|
||||
delete values.sourceMap;
|
||||
delete values.objectGuards;
|
||||
return values;
|
||||
}
|
||||
|
||||
function mapToFunctions(object) {
|
||||
return Object.keys(object).reduce(function (fns, key) {
|
||||
var functions = Object.assign({}, fns);
|
||||
functions[key] = ensureFunction(object[key]);
|
||||
return functions;
|
||||
}, {});
|
||||
}
|
||||
|
||||
var objKeyRegEx =
|
||||
/^([_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*)(\.([_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*))+$/;
|
||||
function expandTypeofReplacements(replacements) {
|
||||
Object.keys(replacements).forEach(function (key) {
|
||||
var objMatch = key.match(objKeyRegEx);
|
||||
if (!objMatch) { return; }
|
||||
var dotIndex = objMatch[1].length;
|
||||
var lastIndex = 0;
|
||||
do {
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + " ===")] = '"object" ===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + " !==")] = '"object" !==';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + "===")] = '"object"===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + "!==")] = '"object"!==';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + " ==")] = '"object" ===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + " !=")] = '"object" !==';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + "==")] = '"object"===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + "!=")] = '"object"!==';
|
||||
lastIndex = dotIndex + 1;
|
||||
dotIndex = key.indexOf('.', lastIndex);
|
||||
} while (dotIndex !== -1);
|
||||
});
|
||||
}
|
||||
|
||||
function replace(options) {
|
||||
if ( options === void 0 ) options = {};
|
||||
|
||||
var filter = pluginutils.createFilter(options.include, options.exclude);
|
||||
var delimiters = options.delimiters; if ( delimiters === void 0 ) delimiters = ['\\b', '\\b(?!\\.)'];
|
||||
var preventAssignment = options.preventAssignment;
|
||||
var objectGuards = options.objectGuards;
|
||||
var replacements = getReplacements(options);
|
||||
if (objectGuards) { expandTypeofReplacements(replacements); }
|
||||
var functionValues = mapToFunctions(replacements);
|
||||
var keys = Object.keys(functionValues).sort(longest).map(escape);
|
||||
var lookahead = preventAssignment ? '(?!\\s*=[^=])' : '';
|
||||
var pattern = new RegExp(
|
||||
((delimiters[0]) + "(" + (keys.join('|')) + ")" + (delimiters[1]) + lookahead),
|
||||
'g'
|
||||
);
|
||||
|
||||
return {
|
||||
name: 'replace',
|
||||
|
||||
buildStart: function buildStart() {
|
||||
if (![true, false].includes(preventAssignment)) {
|
||||
this.warn({
|
||||
message:
|
||||
"@rollup/plugin-replace: 'preventAssignment' currently defaults to false. It is recommended to set this option to `true`, as the next major version will default this option to `true`."
|
||||
});
|
||||
}
|
||||
},
|
||||
|
||||
renderChunk: function renderChunk(code, chunk) {
|
||||
var id = chunk.fileName;
|
||||
if (!keys.length) { return null; }
|
||||
if (!filter(id)) { return null; }
|
||||
return executeReplacement(code, id);
|
||||
},
|
||||
|
||||
transform: function transform(code, id) {
|
||||
if (!keys.length) { return null; }
|
||||
if (!filter(id)) { return null; }
|
||||
return executeReplacement(code, id);
|
||||
}
|
||||
};
|
||||
|
||||
function executeReplacement(code, id) {
|
||||
var magicString = new MagicString(code);
|
||||
if (!codeHasReplacements(code, id, magicString)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
var result = { code: magicString.toString() };
|
||||
if (isSourceMapEnabled()) {
|
||||
result.map = magicString.generateMap({ hires: true });
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
function codeHasReplacements(code, id, magicString) {
|
||||
var result = false;
|
||||
var match;
|
||||
|
||||
// eslint-disable-next-line no-cond-assign
|
||||
while ((match = pattern.exec(code))) {
|
||||
result = true;
|
||||
|
||||
var start = match.index;
|
||||
var end = start + match[0].length;
|
||||
var replacement = String(functionValues[match[1]](id));
|
||||
magicString.overwrite(start, end, replacement);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
function isSourceMapEnabled() {
|
||||
return options.sourceMap !== false && options.sourcemap !== false;
|
||||
}
|
||||
}
|
||||
|
||||
exports.default = replace;
|
||||
module.exports = Object.assign(exports.default, exports);
|
||||
//# sourceMappingURL=index.js.map
|
||||
148
node_modules/@rollup/plugin-replace/dist/es/index.js
generated
vendored
Normal file
148
node_modules/@rollup/plugin-replace/dist/es/index.js
generated
vendored
Normal file
@@ -0,0 +1,148 @@
|
||||
import MagicString from 'magic-string';
|
||||
import { createFilter } from '@rollup/pluginutils';
|
||||
|
||||
function escape(str) {
|
||||
return str.replace(/[-[\]/{}()*+?.\\^$|]/g, '\\$&');
|
||||
}
|
||||
|
||||
function ensureFunction(functionOrValue) {
|
||||
if (typeof functionOrValue === 'function') { return functionOrValue; }
|
||||
return function () { return functionOrValue; };
|
||||
}
|
||||
|
||||
function longest(a, b) {
|
||||
return b.length - a.length;
|
||||
}
|
||||
|
||||
function getReplacements(options) {
|
||||
if (options.values) {
|
||||
return Object.assign({}, options.values);
|
||||
}
|
||||
var values = Object.assign({}, options);
|
||||
delete values.delimiters;
|
||||
delete values.include;
|
||||
delete values.exclude;
|
||||
delete values.sourcemap;
|
||||
delete values.sourceMap;
|
||||
delete values.objectGuards;
|
||||
return values;
|
||||
}
|
||||
|
||||
function mapToFunctions(object) {
|
||||
return Object.keys(object).reduce(function (fns, key) {
|
||||
var functions = Object.assign({}, fns);
|
||||
functions[key] = ensureFunction(object[key]);
|
||||
return functions;
|
||||
}, {});
|
||||
}
|
||||
|
||||
var objKeyRegEx =
|
||||
/^([_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*)(\.([_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*))+$/;
|
||||
function expandTypeofReplacements(replacements) {
|
||||
Object.keys(replacements).forEach(function (key) {
|
||||
var objMatch = key.match(objKeyRegEx);
|
||||
if (!objMatch) { return; }
|
||||
var dotIndex = objMatch[1].length;
|
||||
var lastIndex = 0;
|
||||
do {
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + " ===")] = '"object" ===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + " !==")] = '"object" !==';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + "===")] = '"object"===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + "!==")] = '"object"!==';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + " ==")] = '"object" ===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + " !=")] = '"object" !==';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + "==")] = '"object"===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[("typeof " + (key.slice(lastIndex, dotIndex)) + "!=")] = '"object"!==';
|
||||
lastIndex = dotIndex + 1;
|
||||
dotIndex = key.indexOf('.', lastIndex);
|
||||
} while (dotIndex !== -1);
|
||||
});
|
||||
}
|
||||
|
||||
function replace(options) {
|
||||
if ( options === void 0 ) options = {};
|
||||
|
||||
var filter = createFilter(options.include, options.exclude);
|
||||
var delimiters = options.delimiters; if ( delimiters === void 0 ) delimiters = ['\\b', '\\b(?!\\.)'];
|
||||
var preventAssignment = options.preventAssignment;
|
||||
var objectGuards = options.objectGuards;
|
||||
var replacements = getReplacements(options);
|
||||
if (objectGuards) { expandTypeofReplacements(replacements); }
|
||||
var functionValues = mapToFunctions(replacements);
|
||||
var keys = Object.keys(functionValues).sort(longest).map(escape);
|
||||
var lookahead = preventAssignment ? '(?!\\s*=[^=])' : '';
|
||||
var pattern = new RegExp(
|
||||
((delimiters[0]) + "(" + (keys.join('|')) + ")" + (delimiters[1]) + lookahead),
|
||||
'g'
|
||||
);
|
||||
|
||||
return {
|
||||
name: 'replace',
|
||||
|
||||
buildStart: function buildStart() {
|
||||
if (![true, false].includes(preventAssignment)) {
|
||||
this.warn({
|
||||
message:
|
||||
"@rollup/plugin-replace: 'preventAssignment' currently defaults to false. It is recommended to set this option to `true`, as the next major version will default this option to `true`."
|
||||
});
|
||||
}
|
||||
},
|
||||
|
||||
renderChunk: function renderChunk(code, chunk) {
|
||||
var id = chunk.fileName;
|
||||
if (!keys.length) { return null; }
|
||||
if (!filter(id)) { return null; }
|
||||
return executeReplacement(code, id);
|
||||
},
|
||||
|
||||
transform: function transform(code, id) {
|
||||
if (!keys.length) { return null; }
|
||||
if (!filter(id)) { return null; }
|
||||
return executeReplacement(code, id);
|
||||
}
|
||||
};
|
||||
|
||||
function executeReplacement(code, id) {
|
||||
var magicString = new MagicString(code);
|
||||
if (!codeHasReplacements(code, id, magicString)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
var result = { code: magicString.toString() };
|
||||
if (isSourceMapEnabled()) {
|
||||
result.map = magicString.generateMap({ hires: true });
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
function codeHasReplacements(code, id, magicString) {
|
||||
var result = false;
|
||||
var match;
|
||||
|
||||
// eslint-disable-next-line no-cond-assign
|
||||
while ((match = pattern.exec(code))) {
|
||||
result = true;
|
||||
|
||||
var start = match.index;
|
||||
var end = start + match[0].length;
|
||||
var replacement = String(functionValues[match[1]](id));
|
||||
magicString.overwrite(start, end, replacement);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
function isSourceMapEnabled() {
|
||||
return options.sourceMap !== false && options.sourcemap !== false;
|
||||
}
|
||||
}
|
||||
|
||||
export { replace as default };
|
||||
//# sourceMappingURL=index.js.map
|
||||
1
node_modules/@rollup/plugin-replace/dist/es/package.json
generated
vendored
Normal file
1
node_modules/@rollup/plugin-replace/dist/es/package.json
generated
vendored
Normal file
@@ -0,0 +1 @@
|
||||
{"type":"module"}
|
||||
7
node_modules/@rollup/plugin-replace/node_modules/magic-string/LICENSE
generated
vendored
Normal file
7
node_modules/@rollup/plugin-replace/node_modules/magic-string/LICENSE
generated
vendored
Normal file
@@ -0,0 +1,7 @@
|
||||
Copyright 2018 Rich Harris
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||
289
node_modules/@rollup/plugin-replace/node_modules/magic-string/README.md
generated
vendored
Normal file
289
node_modules/@rollup/plugin-replace/node_modules/magic-string/README.md
generated
vendored
Normal file
@@ -0,0 +1,289 @@
|
||||
# magic-string
|
||||
|
||||
<a href="https://travis-ci.org/Rich-Harris/magic-string">
|
||||
<img src="http://img.shields.io/travis/Rich-Harris/magic-string.svg"
|
||||
alt="build status">
|
||||
</a>
|
||||
<a href="https://npmjs.org/package/magic-string">
|
||||
<img src="https://img.shields.io/npm/v/magic-string.svg"
|
||||
alt="npm version">
|
||||
</a>
|
||||
<a href="https://github.com/Rich-Harris/magic-string/blob/master/LICENSE.md">
|
||||
<img src="https://img.shields.io/npm/l/magic-string.svg"
|
||||
alt="license">
|
||||
</a>
|
||||
|
||||
Suppose you have some source code. You want to make some light modifications to it - replacing a few characters here and there, wrapping it with a header and footer, etc - and ideally you'd like to generate a [source map](https://docs.google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k/) at the end of it. You've thought about using something like [recast](https://github.com/benjamn/recast) (which allows you to generate an AST from some JavaScript, manipulate it, and reprint it with a sourcemap without losing your comments and formatting), but it seems like overkill for your needs (or maybe the source code isn't JavaScript).
|
||||
|
||||
Your requirements are, frankly, rather niche. But they're requirements that I also have, and for which I made magic-string. It's a small, fast utility for manipulating strings and generating sourcemaps.
|
||||
|
||||
## Installation
|
||||
|
||||
magic-string works in both node.js and browser environments. For node, install with npm:
|
||||
|
||||
```bash
|
||||
npm i magic-string
|
||||
```
|
||||
|
||||
To use in browser, grab the [magic-string.umd.js](https://unpkg.com/magic-string/dist/magic-string.umd.js) file and add it to your page:
|
||||
|
||||
```html
|
||||
<script src='magic-string.umd.js'></script>
|
||||
```
|
||||
|
||||
(It also works with various module systems, if you prefer that sort of thing - it has a dependency on [vlq](https://github.com/Rich-Harris/vlq).)
|
||||
|
||||
## Usage
|
||||
|
||||
These examples assume you're in node.js, or something similar:
|
||||
|
||||
```js
|
||||
import MagicString from 'magic-string';
|
||||
import fs from 'fs'
|
||||
|
||||
const s = new MagicString('problems = 99');
|
||||
|
||||
s.update(0, 8, 'answer');
|
||||
s.toString(); // 'answer = 99'
|
||||
|
||||
s.update(11, 13, '42'); // character indices always refer to the original string
|
||||
s.toString(); // 'answer = 42'
|
||||
|
||||
s.prepend('var ').append(';'); // most methods are chainable
|
||||
s.toString(); // 'var answer = 42;'
|
||||
|
||||
const map = s.generateMap({
|
||||
source: 'source.js',
|
||||
file: 'converted.js.map',
|
||||
includeContent: true
|
||||
}); // generates a v3 sourcemap
|
||||
|
||||
fs.writeFileSync('converted.js', s.toString());
|
||||
fs.writeFileSync('converted.js.map', map.toString());
|
||||
```
|
||||
|
||||
You can pass an options argument:
|
||||
|
||||
```js
|
||||
const s = new MagicString(someCode, {
|
||||
// both these options will be used if you later
|
||||
// call `bundle.addSource( s )` - see below
|
||||
filename: 'foo.js',
|
||||
indentExclusionRanges: [/*...*/]
|
||||
});
|
||||
```
|
||||
|
||||
## Methods
|
||||
|
||||
### s.addSourcemapLocation( index )
|
||||
|
||||
Adds the specified character index (with respect to the original string) to sourcemap mappings, if `hires` is `false` (see below).
|
||||
|
||||
### s.append( content )
|
||||
|
||||
Appends the specified content to the end of the string. Returns `this`.
|
||||
|
||||
### s.appendLeft( index, content )
|
||||
|
||||
Appends the specified `content` at the `index` in the original string. If a range *ending* with `index` is subsequently moved, the insert will be moved with it. Returns `this`. See also `s.prependLeft(...)`.
|
||||
|
||||
### s.appendRight( index, content )
|
||||
|
||||
Appends the specified `content` at the `index` in the original string. If a range *starting* with `index` is subsequently moved, the insert will be moved with it. Returns `this`. See also `s.prependRight(...)`.
|
||||
|
||||
### s.clone()
|
||||
|
||||
Does what you'd expect.
|
||||
|
||||
### s.generateDecodedMap( options )
|
||||
|
||||
Generates a sourcemap object with raw mappings in array form, rather than encoded as a string. See `generateMap` documentation below for options details. Useful if you need to manipulate the sourcemap further, but most of the time you will use `generateMap` instead.
|
||||
|
||||
### s.generateMap( options )
|
||||
|
||||
Generates a [version 3 sourcemap](https://docs.google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k/edit). All options are, well, optional:
|
||||
|
||||
* `file` - the filename where you plan to write the sourcemap
|
||||
* `source` - the filename of the file containing the original source
|
||||
* `includeContent` - whether to include the original content in the map's `sourcesContent` array
|
||||
* `hires` - whether the mapping should be high-resolution. Hi-res mappings map every single character, meaning (for example) your devtools will always be able to pinpoint the exact location of function calls and so on. With lo-res mappings, devtools may only be able to identify the correct line - but they're quicker to generate and less bulky. If sourcemap locations have been specified with `s.addSourceMapLocation()`, they will be used here.
|
||||
|
||||
The returned sourcemap has two (non-enumerable) methods attached for convenience:
|
||||
|
||||
* `toString` - returns the equivalent of `JSON.stringify(map)`
|
||||
* `toUrl` - returns a DataURI containing the sourcemap. Useful for doing this sort of thing:
|
||||
|
||||
```js
|
||||
code += '\n//# sourceMappingURL=' + map.toUrl();
|
||||
```
|
||||
|
||||
### s.hasChanged()
|
||||
|
||||
Indicates if the string has been changed.
|
||||
|
||||
### s.indent( prefix[, options] )
|
||||
|
||||
Prefixes each line of the string with `prefix`. If `prefix` is not supplied, the indentation will be guessed from the original content, falling back to a single tab character. Returns `this`.
|
||||
|
||||
The `options` argument can have an `exclude` property, which is an array of `[start, end]` character ranges. These ranges will be excluded from the indentation - useful for (e.g.) multiline strings.
|
||||
|
||||
### s.insertLeft( index, content )
|
||||
|
||||
**DEPRECATED** since 0.17 – use `s.appendLeft(...)` instead
|
||||
|
||||
### s.insertRight( index, content )
|
||||
|
||||
**DEPRECATED** since 0.17 – use `s.prependRight(...)` instead
|
||||
|
||||
### s.isEmpty()
|
||||
|
||||
Returns true if the resulting source is empty (disregarding white space).
|
||||
|
||||
### s.locate( index )
|
||||
|
||||
**DEPRECATED** since 0.10 – see [#30](https://github.com/Rich-Harris/magic-string/pull/30)
|
||||
|
||||
### s.locateOrigin( index )
|
||||
|
||||
**DEPRECATED** since 0.10 – see [#30](https://github.com/Rich-Harris/magic-string/pull/30)
|
||||
|
||||
### s.move( start, end, index )
|
||||
|
||||
Moves the characters from `start` and `end` to `index`. Returns `this`.
|
||||
|
||||
### s.overwrite( start, end, content[, options] )
|
||||
|
||||
Replaces the characters from `start` to `end` with `content`, along with the appended/prepended content in that range. The same restrictions as `s.remove()` apply. Returns `this`.
|
||||
|
||||
The fourth argument is optional. It can have a `storeName` property — if `true`, the original name will be stored for later inclusion in a sourcemap's `names` array — and a `contentOnly` property which determines whether only the content is overwritten, or anything that was appended/prepended to the range as well.
|
||||
|
||||
It may be preferred to use `s.update(...)` instead if you wish to avoid overwriting the appended/prepended content.
|
||||
|
||||
### s.prepend( content )
|
||||
|
||||
Prepends the string with the specified content. Returns `this`.
|
||||
|
||||
### s.prependLeft ( index, content )
|
||||
|
||||
Same as `s.appendLeft(...)`, except that the inserted content will go *before* any previous appends or prepends at `index`
|
||||
|
||||
### s.prependRight ( index, content )
|
||||
|
||||
Same as `s.appendRight(...)`, except that the inserted content will go *before* any previous appends or prepends at `index`
|
||||
|
||||
### s.replace( regexpOrString, substitution )
|
||||
|
||||
String replacement with RegExp or string. When using a RegExp, replacer function is also supported. Returns `this`.
|
||||
|
||||
```ts
|
||||
import MagicString from 'magic-string'
|
||||
|
||||
const s = new MagicString(source)
|
||||
|
||||
s.replace('foo', 'bar')
|
||||
s.replace(/foo/g, 'bar')
|
||||
s.replace(/(\w)(\d+)/g, (_, $1, $2) => $1.toUpperCase() + $2)
|
||||
```
|
||||
|
||||
The differences from [`String.replace`]((https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace)):
|
||||
- It will always match against the **original string**
|
||||
- It mutates the magic string state (use `.clone()` to be immutable)
|
||||
|
||||
### s.replaceAll( regexpOrString, substitution )
|
||||
|
||||
Same as `s.replace`, but replace all matched strings instead of just one.
|
||||
If `substitution` is a regex, then it must have the global (`g`) flag set, or a `TypeError` is thrown. Matches the behavior of the bultin [`String.property.replaceAll`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replaceAll).
|
||||
|
||||
### s.remove( start, end )
|
||||
|
||||
Removes the characters from `start` to `end` (of the original string, **not** the generated string). Removing the same content twice, or making removals that partially overlap, will cause an error. Returns `this`.
|
||||
|
||||
### s.slice( start, end )
|
||||
|
||||
Returns the content of the generated string that corresponds to the slice between `start` and `end` of the original string. Throws error if the indices are for characters that were already removed.
|
||||
|
||||
### s.snip( start, end )
|
||||
|
||||
Returns a clone of `s`, with all content before the `start` and `end` characters of the original string removed.
|
||||
|
||||
### s.toString()
|
||||
|
||||
Returns the generated string.
|
||||
|
||||
### s.trim([ charType ])
|
||||
|
||||
Trims content matching `charType` (defaults to `\s`, i.e. whitespace) from the start and end. Returns `this`.
|
||||
|
||||
### s.trimStart([ charType ])
|
||||
|
||||
Trims content matching `charType` (defaults to `\s`, i.e. whitespace) from the start. Returns `this`.
|
||||
|
||||
### s.trimEnd([ charType ])
|
||||
|
||||
Trims content matching `charType` (defaults to `\s`, i.e. whitespace) from the end. Returns `this`.
|
||||
|
||||
### s.trimLines()
|
||||
|
||||
Removes empty lines from the start and end. Returns `this`.
|
||||
|
||||
### s.update( start, end, content[, options] )
|
||||
|
||||
Replaces the characters from `start` to `end` with `content`. The same restrictions as `s.remove()` apply. Returns `this`.
|
||||
|
||||
The fourth argument is optional. It can have a `storeName` property — if `true`, the original name will be stored for later inclusion in a sourcemap's `names` array — and an `overwrite` property which defaults to `false` and determines whether anything that was appended/prepended to the range will be overwritten along with the original content.
|
||||
|
||||
`s.update(start, end, content)` is equivalent to `s.overwrite(start, end, content, { contentOnly: true })`.
|
||||
|
||||
## Bundling
|
||||
|
||||
To concatenate several sources, use `MagicString.Bundle`:
|
||||
|
||||
```js
|
||||
const bundle = new MagicString.Bundle();
|
||||
|
||||
bundle.addSource({
|
||||
filename: 'foo.js',
|
||||
content: new MagicString('var answer = 42;')
|
||||
});
|
||||
|
||||
bundle.addSource({
|
||||
filename: 'bar.js',
|
||||
content: new MagicString('console.log( answer )')
|
||||
});
|
||||
|
||||
// Advanced: a source can include an `indentExclusionRanges` property
|
||||
// alongside `filename` and `content`. This will be passed to `s.indent()`
|
||||
// - see documentation above
|
||||
|
||||
bundle.indent() // optionally, pass an indent string, otherwise it will be guessed
|
||||
.prepend('(function () {\n')
|
||||
.append('}());');
|
||||
|
||||
bundle.toString();
|
||||
// (function () {
|
||||
// var answer = 42;
|
||||
// console.log( answer );
|
||||
// }());
|
||||
|
||||
// options are as per `s.generateMap()` above
|
||||
const map = bundle.generateMap({
|
||||
file: 'bundle.js',
|
||||
includeContent: true,
|
||||
hires: true
|
||||
});
|
||||
```
|
||||
|
||||
As an alternative syntax, if you a) don't have `filename` or `indentExclusionRanges` options, or b) passed those in when you used `new MagicString(...)`, you can simply pass the `MagicString` instance itself:
|
||||
|
||||
```js
|
||||
const bundle = new MagicString.Bundle();
|
||||
const source = new MagicString(someCode, {
|
||||
filename: 'foo.js'
|
||||
});
|
||||
|
||||
bundle.addSource(source);
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
||||
1431
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.cjs.js
generated
vendored
Normal file
1431
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.cjs.js
generated
vendored
Normal file
File diff suppressed because it is too large
Load Diff
1
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.cjs.js.map
generated
vendored
Normal file
1
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.cjs.js.map
generated
vendored
Normal file
File diff suppressed because one or more lines are too long
1425
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.es.mjs
generated
vendored
Normal file
1425
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.es.mjs
generated
vendored
Normal file
File diff suppressed because it is too large
Load Diff
1
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.es.mjs.map
generated
vendored
Normal file
1
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.es.mjs.map
generated
vendored
Normal file
File diff suppressed because one or more lines are too long
1523
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.umd.js
generated
vendored
Normal file
1523
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.umd.js
generated
vendored
Normal file
File diff suppressed because it is too large
Load Diff
1
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.umd.js.map
generated
vendored
Normal file
1
node_modules/@rollup/plugin-replace/node_modules/magic-string/dist/magic-string.umd.js.map
generated
vendored
Normal file
File diff suppressed because one or more lines are too long
250
node_modules/@rollup/plugin-replace/node_modules/magic-string/index.d.ts
generated
vendored
Normal file
250
node_modules/@rollup/plugin-replace/node_modules/magic-string/index.d.ts
generated
vendored
Normal file
@@ -0,0 +1,250 @@
|
||||
export interface BundleOptions {
|
||||
intro?: string;
|
||||
separator?: string;
|
||||
}
|
||||
|
||||
export interface SourceMapOptions {
|
||||
/**
|
||||
* Whether the mapping should be high-resolution.
|
||||
* Hi-res mappings map every single character, meaning (for example) your devtools will always
|
||||
* be able to pinpoint the exact location of function calls and so on.
|
||||
* With lo-res mappings, devtools may only be able to identify the correct
|
||||
* line - but they're quicker to generate and less bulky.
|
||||
* If sourcemap locations have been specified with s.addSourceMapLocation(), they will be used here.
|
||||
*/
|
||||
hires?: boolean;
|
||||
/**
|
||||
* The filename where you plan to write the sourcemap.
|
||||
*/
|
||||
file?: string;
|
||||
/**
|
||||
* The filename of the file containing the original source.
|
||||
*/
|
||||
source?: string;
|
||||
/**
|
||||
* Whether to include the original content in the map's sourcesContent array.
|
||||
*/
|
||||
includeContent?: boolean;
|
||||
}
|
||||
|
||||
export type SourceMapSegment =
|
||||
| [number]
|
||||
| [number, number, number, number]
|
||||
| [number, number, number, number, number];
|
||||
|
||||
export interface DecodedSourceMap {
|
||||
file: string;
|
||||
sources: string[];
|
||||
sourcesContent: string[];
|
||||
names: string[];
|
||||
mappings: SourceMapSegment[][];
|
||||
}
|
||||
|
||||
export class SourceMap {
|
||||
constructor(properties: DecodedSourceMap);
|
||||
|
||||
version: number;
|
||||
file: string;
|
||||
sources: string[];
|
||||
sourcesContent: string[];
|
||||
names: string[];
|
||||
mappings: string;
|
||||
|
||||
/**
|
||||
* Returns the equivalent of `JSON.stringify(map)`
|
||||
*/
|
||||
toString(): string;
|
||||
/**
|
||||
* Returns a DataURI containing the sourcemap. Useful for doing this sort of thing:
|
||||
* `generateMap(options?: SourceMapOptions): SourceMap;`
|
||||
*/
|
||||
toUrl(): string;
|
||||
}
|
||||
|
||||
export class Bundle {
|
||||
constructor(options?: BundleOptions);
|
||||
addSource(source: MagicString | { filename?: string, content: MagicString }): Bundle;
|
||||
append(str: string, options?: BundleOptions): Bundle;
|
||||
clone(): Bundle;
|
||||
generateMap(options?: SourceMapOptions): SourceMap;
|
||||
generateDecodedMap(options?: SourceMapOptions): DecodedSourceMap;
|
||||
getIndentString(): string;
|
||||
indent(indentStr?: string): Bundle;
|
||||
indentExclusionRanges: ExclusionRange | Array<ExclusionRange>;
|
||||
prepend(str: string): Bundle;
|
||||
toString(): string;
|
||||
trimLines(): Bundle;
|
||||
trim(charType?: string): Bundle;
|
||||
trimStart(charType?: string): Bundle;
|
||||
trimEnd(charType?: string): Bundle;
|
||||
isEmpty(): boolean;
|
||||
length(): number;
|
||||
}
|
||||
|
||||
export type ExclusionRange = [ number, number ];
|
||||
|
||||
export interface MagicStringOptions {
|
||||
filename?: string,
|
||||
indentExclusionRanges?: ExclusionRange | Array<ExclusionRange>;
|
||||
}
|
||||
|
||||
export interface IndentOptions {
|
||||
exclude?: ExclusionRange | Array<ExclusionRange>;
|
||||
indentStart?: boolean;
|
||||
}
|
||||
|
||||
export interface OverwriteOptions {
|
||||
storeName?: boolean;
|
||||
contentOnly?: boolean;
|
||||
}
|
||||
|
||||
export interface UpdateOptions {
|
||||
storeName?: boolean;
|
||||
overwrite?: boolean;
|
||||
}
|
||||
|
||||
export default class MagicString {
|
||||
constructor(str: string, options?: MagicStringOptions);
|
||||
/**
|
||||
* Adds the specified character index (with respect to the original string) to sourcemap mappings, if `hires` is false.
|
||||
*/
|
||||
addSourcemapLocation(char: number): void;
|
||||
/**
|
||||
* Appends the specified content to the end of the string.
|
||||
*/
|
||||
append(content: string): MagicString;
|
||||
/**
|
||||
* Appends the specified content at the index in the original string.
|
||||
* If a range *ending* with index is subsequently moved, the insert will be moved with it.
|
||||
* See also `s.prependLeft(...)`.
|
||||
*/
|
||||
appendLeft(index: number, content: string): MagicString;
|
||||
/**
|
||||
* Appends the specified content at the index in the original string.
|
||||
* If a range *starting* with index is subsequently moved, the insert will be moved with it.
|
||||
* See also `s.prependRight(...)`.
|
||||
*/
|
||||
appendRight(index: number, content: string): MagicString;
|
||||
/**
|
||||
* Does what you'd expect.
|
||||
*/
|
||||
clone(): MagicString;
|
||||
/**
|
||||
* Generates a version 3 sourcemap.
|
||||
*/
|
||||
generateMap(options?: SourceMapOptions): SourceMap;
|
||||
/**
|
||||
* Generates a sourcemap object with raw mappings in array form, rather than encoded as a string.
|
||||
* Useful if you need to manipulate the sourcemap further, but most of the time you will use `generateMap` instead.
|
||||
*/
|
||||
generateDecodedMap(options?: SourceMapOptions): DecodedSourceMap;
|
||||
getIndentString(): string;
|
||||
|
||||
/**
|
||||
* Prefixes each line of the string with prefix.
|
||||
* If prefix is not supplied, the indentation will be guessed from the original content, falling back to a single tab character.
|
||||
*/
|
||||
indent(options?: IndentOptions): MagicString;
|
||||
/**
|
||||
* Prefixes each line of the string with prefix.
|
||||
* If prefix is not supplied, the indentation will be guessed from the original content, falling back to a single tab character.
|
||||
*
|
||||
* The options argument can have an exclude property, which is an array of [start, end] character ranges.
|
||||
* These ranges will be excluded from the indentation - useful for (e.g.) multiline strings.
|
||||
*/
|
||||
indent(indentStr?: string, options?: IndentOptions): MagicString;
|
||||
indentExclusionRanges: ExclusionRange | Array<ExclusionRange>;
|
||||
|
||||
/**
|
||||
* Moves the characters from `start and `end` to `index`.
|
||||
*/
|
||||
move(start: number, end: number, index: number): MagicString;
|
||||
/**
|
||||
* Replaces the characters from `start` to `end` with `content`, along with the appended/prepended content in
|
||||
* that range. The same restrictions as `s.remove()` apply.
|
||||
*
|
||||
* The fourth argument is optional. It can have a storeName property — if true, the original name will be stored
|
||||
* for later inclusion in a sourcemap's names array — and a contentOnly property which determines whether only
|
||||
* the content is overwritten, or anything that was appended/prepended to the range as well.
|
||||
*
|
||||
* It may be preferred to use `s.update(...)` instead if you wish to avoid overwriting the appended/prepended content.
|
||||
*/
|
||||
overwrite(start: number, end: number, content: string, options?: boolean | OverwriteOptions): MagicString;
|
||||
/**
|
||||
* Replaces the characters from `start` to `end` with `content`. The same restrictions as `s.remove()` apply.
|
||||
*
|
||||
* The fourth argument is optional. It can have a storeName property — if true, the original name will be stored
|
||||
* for later inclusion in a sourcemap's names array — and an overwrite property which determines whether only
|
||||
* the content is overwritten, or anything that was appended/prepended to the range as well.
|
||||
*/
|
||||
update(start: number, end: number, content: string, options?: boolean | UpdateOptions): MagicString;
|
||||
/**
|
||||
* Prepends the string with the specified content.
|
||||
*/
|
||||
prepend(content: string): MagicString;
|
||||
/**
|
||||
* Same as `s.appendLeft(...)`, except that the inserted content will go *before* any previous appends or prepends at index
|
||||
*/
|
||||
prependLeft(index: number, content: string): MagicString;
|
||||
/**
|
||||
* Same as `s.appendRight(...)`, except that the inserted content will go *before* any previous appends or prepends at `index`
|
||||
*/
|
||||
prependRight(index: number, content: string): MagicString;
|
||||
/**
|
||||
* Removes the characters from `start` to `end` (of the original string, **not** the generated string).
|
||||
* Removing the same content twice, or making removals that partially overlap, will cause an error.
|
||||
*/
|
||||
remove(start: number, end: number): MagicString;
|
||||
/**
|
||||
* Returns the content of the generated string that corresponds to the slice between `start` and `end` of the original string.
|
||||
* Throws error if the indices are for characters that were already removed.
|
||||
*/
|
||||
slice(start: number, end: number): string;
|
||||
/**
|
||||
* Returns a clone of `s`, with all content before the `start` and `end` characters of the original string removed.
|
||||
*/
|
||||
snip(start: number, end: number): MagicString;
|
||||
/**
|
||||
* Trims content matching `charType` (defaults to `\s`, i.e. whitespace) from the start and end.
|
||||
*/
|
||||
trim(charType?: string): MagicString;
|
||||
/**
|
||||
* Trims content matching `charType` (defaults to `\s`, i.e. whitespace) from the start.
|
||||
*/
|
||||
trimStart(charType?: string): MagicString;
|
||||
/**
|
||||
* Trims content matching `charType` (defaults to `\s`, i.e. whitespace) from the end.
|
||||
*/
|
||||
trimEnd(charType?: string): MagicString;
|
||||
/**
|
||||
* Removes empty lines from the start and end.
|
||||
*/
|
||||
trimLines(): MagicString;
|
||||
/**
|
||||
* String replacement with RegExp or string.
|
||||
*/
|
||||
replace(regex: RegExp | string, replacement: string | ((substring: string, ...args: any[]) => string)): MagicString;
|
||||
/**
|
||||
* Same as `s.replace`, but replace all matched strings instead of just one.
|
||||
*/
|
||||
replaceAll(regex: RegExp | string, replacement: string | ((substring: string, ...args: any[]) => string)): MagicString;
|
||||
|
||||
lastChar(): string;
|
||||
lastLine(): string;
|
||||
/**
|
||||
* Returns true if the resulting source is empty (disregarding white space).
|
||||
*/
|
||||
isEmpty(): boolean;
|
||||
length(): number;
|
||||
|
||||
/**
|
||||
* Indicates if the string has been changed.
|
||||
*/
|
||||
hasChanged(): boolean;
|
||||
|
||||
original: string;
|
||||
/**
|
||||
* Returns the generated string.
|
||||
*/
|
||||
toString(): string;
|
||||
}
|
||||
64
node_modules/@rollup/plugin-replace/node_modules/magic-string/package.json
generated
vendored
Normal file
64
node_modules/@rollup/plugin-replace/node_modules/magic-string/package.json
generated
vendored
Normal file
@@ -0,0 +1,64 @@
|
||||
{
|
||||
"name": "magic-string",
|
||||
"version": "0.27.0",
|
||||
"description": "Modify strings, generate sourcemaps",
|
||||
"keywords": [
|
||||
"string",
|
||||
"string manipulation",
|
||||
"sourcemap",
|
||||
"templating",
|
||||
"transpilation"
|
||||
],
|
||||
"repository": "https://github.com/rich-harris/magic-string",
|
||||
"license": "MIT",
|
||||
"author": "Rich Harris",
|
||||
"main": "./dist/magic-string.cjs.js",
|
||||
"module": "./dist/magic-string.es.mjs",
|
||||
"jsnext:main": "./dist/magic-string.es.mjs",
|
||||
"types": "./index.d.ts",
|
||||
"exports": {
|
||||
"./package.json": "./package.json",
|
||||
".": {
|
||||
"import": "./dist/magic-string.es.mjs",
|
||||
"require": "./dist/magic-string.cjs.js",
|
||||
"types": "./index.d.ts"
|
||||
}
|
||||
},
|
||||
"files": [
|
||||
"dist/*",
|
||||
"index.d.ts",
|
||||
"README.md"
|
||||
],
|
||||
"scripts": {
|
||||
"build": "rollup -c",
|
||||
"changelog": "conventional-changelog -p angular -i CHANGELOG.md -s",
|
||||
"format": "prettier --single-quote --print-width 100 --use-tabs --write src/*.js src/**/*.js",
|
||||
"lint": "eslint src test",
|
||||
"prepare": "npm run build",
|
||||
"prepublishOnly": "rm -rf dist && npm test",
|
||||
"release": "bumpp -x \"npm run changelog\" --all --commit --tag --push && npm publish",
|
||||
"pretest": "npm run lint && npm run build",
|
||||
"test": "mocha",
|
||||
"bench": "npm run build && node benchmark/index.mjs",
|
||||
"watch": "rollup -cw"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@rollup/plugin-node-resolve": "^14.1.0",
|
||||
"@rollup/plugin-replace": "^4.0.0",
|
||||
"benchmark": "^2.1.4",
|
||||
"bumpp": "^8.2.1",
|
||||
"conventional-changelog-cli": "^2.2.2",
|
||||
"eslint": "^8.23.1",
|
||||
"mocha": "^10.0.0",
|
||||
"prettier": "^2.7.1",
|
||||
"rollup": "^2.79.1",
|
||||
"source-map-js": "^1.0.2",
|
||||
"source-map-support": "^0.5.21"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=12"
|
||||
},
|
||||
"dependencies": {
|
||||
"@jridgewell/sourcemap-codec": "^1.4.13"
|
||||
}
|
||||
}
|
||||
85
node_modules/@rollup/plugin-replace/package.json
generated
vendored
Normal file
85
node_modules/@rollup/plugin-replace/package.json
generated
vendored
Normal file
@@ -0,0 +1,85 @@
|
||||
{
|
||||
"name": "@rollup/plugin-replace",
|
||||
"version": "5.0.2",
|
||||
"publishConfig": {
|
||||
"access": "public"
|
||||
},
|
||||
"description": "Replace strings in files while bundling",
|
||||
"license": "MIT",
|
||||
"repository": {
|
||||
"url": "rollup/plugins",
|
||||
"directory": "packages/replace"
|
||||
},
|
||||
"author": "Rich Harris <richard.a.harris@gmail.com>",
|
||||
"homepage": "https://github.com/rollup/plugins/tree/master/packages/replace#readme",
|
||||
"bugs": "https://github.com/rollup/plugins/issues",
|
||||
"main": "dist/cjs/index.js",
|
||||
"module": "dist/es/index.js",
|
||||
"exports": {
|
||||
"types": "./types/index.d.ts",
|
||||
"import": "./dist/es/index.js",
|
||||
"default": "./dist/cjs/index.js"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=14.0.0"
|
||||
},
|
||||
"scripts": {
|
||||
"build": "rollup -c",
|
||||
"ci:coverage": "nyc pnpm test && nyc report --reporter=text-lcov > coverage.lcov",
|
||||
"ci:lint": "pnpm build && pnpm lint",
|
||||
"ci:lint:commits": "commitlint --from=${CIRCLE_BRANCH} --to=${CIRCLE_SHA1}",
|
||||
"ci:test": "pnpm test -- --verbose && pnpm test:ts",
|
||||
"prebuild": "del-cli dist",
|
||||
"prepare": "if [ ! -d 'dist' ]; then pnpm build; fi",
|
||||
"prerelease": "pnpm build",
|
||||
"pretest": "pnpm build",
|
||||
"release": "pnpm --workspace-root plugin:release --pkg $npm_package_name",
|
||||
"test": "ava",
|
||||
"test:ts": "tsc types/index.d.ts test/types.ts --noEmit"
|
||||
},
|
||||
"files": [
|
||||
"dist",
|
||||
"!dist/**/*.map",
|
||||
"src",
|
||||
"types",
|
||||
"README.md"
|
||||
],
|
||||
"keywords": [
|
||||
"rollup",
|
||||
"plugin",
|
||||
"replace",
|
||||
"es2015",
|
||||
"npm",
|
||||
"modules"
|
||||
],
|
||||
"peerDependencies": {
|
||||
"rollup": "^1.20.0||^2.0.0||^3.0.0"
|
||||
},
|
||||
"peerDependenciesMeta": {
|
||||
"rollup": {
|
||||
"optional": true
|
||||
}
|
||||
},
|
||||
"dependencies": {
|
||||
"@rollup/pluginutils": "^5.0.1",
|
||||
"magic-string": "^0.27.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@rollup/plugin-buble": "^1.0.0",
|
||||
"del-cli": "^5.0.0",
|
||||
"locate-character": "^2.0.5",
|
||||
"rollup": "^3.2.3",
|
||||
"source-map": "^0.7.4",
|
||||
"typescript": "^4.8.3"
|
||||
},
|
||||
"types": "./types/index.d.ts",
|
||||
"ava": {
|
||||
"workerThreads": false,
|
||||
"files": [
|
||||
"!**/fixtures/**",
|
||||
"!**/helpers/**",
|
||||
"!**/recipes/**",
|
||||
"!**/types.ts"
|
||||
]
|
||||
}
|
||||
}
|
||||
141
node_modules/@rollup/plugin-replace/src/index.js
generated
vendored
Executable file
141
node_modules/@rollup/plugin-replace/src/index.js
generated
vendored
Executable file
@@ -0,0 +1,141 @@
|
||||
import MagicString from 'magic-string';
|
||||
import { createFilter } from '@rollup/pluginutils';
|
||||
|
||||
function escape(str) {
|
||||
return str.replace(/[-[\]/{}()*+?.\\^$|]/g, '\\$&');
|
||||
}
|
||||
|
||||
function ensureFunction(functionOrValue) {
|
||||
if (typeof functionOrValue === 'function') return functionOrValue;
|
||||
return () => functionOrValue;
|
||||
}
|
||||
|
||||
function longest(a, b) {
|
||||
return b.length - a.length;
|
||||
}
|
||||
|
||||
function getReplacements(options) {
|
||||
if (options.values) {
|
||||
return Object.assign({}, options.values);
|
||||
}
|
||||
const values = Object.assign({}, options);
|
||||
delete values.delimiters;
|
||||
delete values.include;
|
||||
delete values.exclude;
|
||||
delete values.sourcemap;
|
||||
delete values.sourceMap;
|
||||
delete values.objectGuards;
|
||||
return values;
|
||||
}
|
||||
|
||||
function mapToFunctions(object) {
|
||||
return Object.keys(object).reduce((fns, key) => {
|
||||
const functions = Object.assign({}, fns);
|
||||
functions[key] = ensureFunction(object[key]);
|
||||
return functions;
|
||||
}, {});
|
||||
}
|
||||
|
||||
const objKeyRegEx =
|
||||
/^([_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*)(\.([_$a-zA-Z\xA0-\uFFFF][_$a-zA-Z0-9\xA0-\uFFFF]*))+$/;
|
||||
function expandTypeofReplacements(replacements) {
|
||||
Object.keys(replacements).forEach((key) => {
|
||||
const objMatch = key.match(objKeyRegEx);
|
||||
if (!objMatch) return;
|
||||
let dotIndex = objMatch[1].length;
|
||||
let lastIndex = 0;
|
||||
do {
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[`typeof ${key.slice(lastIndex, dotIndex)} ===`] = '"object" ===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[`typeof ${key.slice(lastIndex, dotIndex)} !==`] = '"object" !==';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[`typeof ${key.slice(lastIndex, dotIndex)}===`] = '"object"===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[`typeof ${key.slice(lastIndex, dotIndex)}!==`] = '"object"!==';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[`typeof ${key.slice(lastIndex, dotIndex)} ==`] = '"object" ===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[`typeof ${key.slice(lastIndex, dotIndex)} !=`] = '"object" !==';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[`typeof ${key.slice(lastIndex, dotIndex)}==`] = '"object"===';
|
||||
// eslint-disable-next-line no-param-reassign
|
||||
replacements[`typeof ${key.slice(lastIndex, dotIndex)}!=`] = '"object"!==';
|
||||
lastIndex = dotIndex + 1;
|
||||
dotIndex = key.indexOf('.', lastIndex);
|
||||
} while (dotIndex !== -1);
|
||||
});
|
||||
}
|
||||
|
||||
export default function replace(options = {}) {
|
||||
const filter = createFilter(options.include, options.exclude);
|
||||
const { delimiters = ['\\b', '\\b(?!\\.)'], preventAssignment, objectGuards } = options;
|
||||
const replacements = getReplacements(options);
|
||||
if (objectGuards) expandTypeofReplacements(replacements);
|
||||
const functionValues = mapToFunctions(replacements);
|
||||
const keys = Object.keys(functionValues).sort(longest).map(escape);
|
||||
const lookahead = preventAssignment ? '(?!\\s*=[^=])' : '';
|
||||
const pattern = new RegExp(
|
||||
`${delimiters[0]}(${keys.join('|')})${delimiters[1]}${lookahead}`,
|
||||
'g'
|
||||
);
|
||||
|
||||
return {
|
||||
name: 'replace',
|
||||
|
||||
buildStart() {
|
||||
if (![true, false].includes(preventAssignment)) {
|
||||
this.warn({
|
||||
message:
|
||||
"@rollup/plugin-replace: 'preventAssignment' currently defaults to false. It is recommended to set this option to `true`, as the next major version will default this option to `true`."
|
||||
});
|
||||
}
|
||||
},
|
||||
|
||||
renderChunk(code, chunk) {
|
||||
const id = chunk.fileName;
|
||||
if (!keys.length) return null;
|
||||
if (!filter(id)) return null;
|
||||
return executeReplacement(code, id);
|
||||
},
|
||||
|
||||
transform(code, id) {
|
||||
if (!keys.length) return null;
|
||||
if (!filter(id)) return null;
|
||||
return executeReplacement(code, id);
|
||||
}
|
||||
};
|
||||
|
||||
function executeReplacement(code, id) {
|
||||
const magicString = new MagicString(code);
|
||||
if (!codeHasReplacements(code, id, magicString)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const result = { code: magicString.toString() };
|
||||
if (isSourceMapEnabled()) {
|
||||
result.map = magicString.generateMap({ hires: true });
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
function codeHasReplacements(code, id, magicString) {
|
||||
let result = false;
|
||||
let match;
|
||||
|
||||
// eslint-disable-next-line no-cond-assign
|
||||
while ((match = pattern.exec(code))) {
|
||||
result = true;
|
||||
|
||||
const start = match.index;
|
||||
const end = start + match[0].length;
|
||||
const replacement = String(functionValues[match[1]](id));
|
||||
magicString.overwrite(start, end, replacement);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
function isSourceMapEnabled() {
|
||||
return options.sourceMap !== false && options.sourcemap !== false;
|
||||
}
|
||||
}
|
||||
50
node_modules/@rollup/plugin-replace/types/index.d.ts
generated
vendored
Executable file
50
node_modules/@rollup/plugin-replace/types/index.d.ts
generated
vendored
Executable file
@@ -0,0 +1,50 @@
|
||||
import type { FilterPattern } from '@rollup/pluginutils';
|
||||
import type { Plugin } from 'rollup';
|
||||
|
||||
type Replacement = string | ((id: string) => string);
|
||||
|
||||
export interface RollupReplaceOptions {
|
||||
/**
|
||||
* All other options are treated as `string: replacement` replacers,
|
||||
* or `string: (id) => replacement` functions.
|
||||
*/
|
||||
[str: string]:
|
||||
| Replacement
|
||||
| RollupReplaceOptions['include']
|
||||
| RollupReplaceOptions['values']
|
||||
| RollupReplaceOptions['preventAssignment'];
|
||||
|
||||
/**
|
||||
* A picomatch pattern, or array of patterns, of files that should be
|
||||
* processed by this plugin (if omitted, all files are included by default)
|
||||
*/
|
||||
include?: FilterPattern;
|
||||
/**
|
||||
* Files that should be excluded, if `include` is otherwise too permissive.
|
||||
*/
|
||||
exclude?: FilterPattern;
|
||||
/**
|
||||
* If false, skips source map generation. This will improve performance.
|
||||
* @default true
|
||||
*/
|
||||
sourceMap?: boolean;
|
||||
/**
|
||||
* To replace every occurrence of `<@foo@>` instead of every occurrence
|
||||
* of `foo`, supply delimiters
|
||||
*/
|
||||
delimiters?: [string, string];
|
||||
/**
|
||||
* Prevents replacing strings where they are followed by a single equals
|
||||
* sign.
|
||||
*/
|
||||
preventAssignment?: boolean;
|
||||
/**
|
||||
* You can separate values to replace from other options.
|
||||
*/
|
||||
values?: { [str: string]: Replacement };
|
||||
}
|
||||
|
||||
/**
|
||||
* Replace strings in files while bundling them.
|
||||
*/
|
||||
export default function replace(options?: RollupReplaceOptions): Plugin;
|
||||
Reference in New Issue
Block a user