Befor generating
This commit is contained in:
marys
+192
@@ -0,0 +1,192 @@
|
||||
The Artistic License 2.0
|
||||
========================
|
||||
|
||||
_Copyright © 2000-2006, The Perl Foundation._
|
||||
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
### Preamble
|
||||
|
||||
This license establishes the terms under which a given free software
|
||||
Package may be copied, modified, distributed, and/or redistributed.
|
||||
The intent is that the Copyright Holder maintains some artistic
|
||||
control over the development of that Package while still keeping the
|
||||
Package available as open source and free software.
|
||||
|
||||
You are always permitted to make arrangements wholly outside of this
|
||||
license directly with the Copyright Holder of a given Package. If the
|
||||
terms of this license do not permit the full use that you propose to
|
||||
make of the Package, you should contact the Copyright Holder and seek
|
||||
a different licensing arrangement.
|
||||
|
||||
### Definitions
|
||||
|
||||
“Copyright Holder” means the individual(s) or organization(s)
|
||||
named in the copyright notice for the entire Package.
|
||||
|
||||
“Contributor” means any party that has contributed code or other
|
||||
material to the Package, in accordance with the Copyright Holder's
|
||||
procedures.
|
||||
|
||||
“You” and “your” means any person who would like to copy,
|
||||
distribute, or modify the Package.
|
||||
|
||||
“Package” means the collection of files distributed by the
|
||||
Copyright Holder, and derivatives of that collection and/or of
|
||||
those files. A given Package may consist of either the Standard
|
||||
Version, or a Modified Version.
|
||||
|
||||
“Distribute” means providing a copy of the Package or making it
|
||||
accessible to anyone else, or in the case of a company or
|
||||
organization, to others outside of your company or organization.
|
||||
|
||||
“Distributor Fee” means any fee that you charge for Distributing
|
||||
this Package or providing support for this Package to another
|
||||
party. It does not mean licensing fees.
|
||||
|
||||
“Standard Version” refers to the Package if it has not been
|
||||
modified, or has been modified only in ways explicitly requested
|
||||
by the Copyright Holder.
|
||||
|
||||
“Modified Version” means the Package, if it has been changed, and
|
||||
such changes were not explicitly requested by the Copyright
|
||||
Holder.
|
||||
|
||||
“Original License” means this Artistic License as Distributed with
|
||||
the Standard Version of the Package, in its current version or as
|
||||
it may be modified by The Perl Foundation in the future.
|
||||
|
||||
“Source” form means the source code, documentation source, and
|
||||
configuration files for the Package.
|
||||
|
||||
“Compiled” form means the compiled bytecode, object code, binary,
|
||||
or any other form resulting from mechanical transformation or
|
||||
translation of the Source form.
|
||||
|
||||
### Permission for Use and Modification Without Distribution
|
||||
|
||||
**(1)** You are permitted to use the Standard Version and create and use
|
||||
Modified Versions for any purpose without restriction, provided that
|
||||
you do not Distribute the Modified Version.
|
||||
|
||||
### Permissions for Redistribution of the Standard Version
|
||||
|
||||
**(2)** You may Distribute verbatim copies of the Source form of the
|
||||
Standard Version of this Package in any medium without restriction,
|
||||
either gratis or for a Distributor Fee, provided that you duplicate
|
||||
all of the original copyright notices and associated disclaimers. At
|
||||
your discretion, such verbatim copies may or may not include a
|
||||
Compiled form of the Package.
|
||||
|
||||
**(3)** You may apply any bug fixes, portability changes, and other
|
||||
modifications made available from the Copyright Holder. The resulting
|
||||
Package will still be considered the Standard Version, and as such
|
||||
will be subject to the Original License.
|
||||
|
||||
### Distribution of Modified Versions of the Package as Source
|
||||
|
||||
**(4)** You may Distribute your Modified Version as Source (either gratis
|
||||
or for a Distributor Fee, and with or without a Compiled form of the
|
||||
Modified Version) provided that you clearly document how it differs
|
||||
from the Standard Version, including, but not limited to, documenting
|
||||
any non-standard features, executables, or modules, and provided that
|
||||
you do at least ONE of the following:
|
||||
|
||||
* **(a)** make the Modified Version available to the Copyright Holder
|
||||
of the Standard Version, under the Original License, so that the
|
||||
Copyright Holder may include your modifications in the Standard
|
||||
Version.
|
||||
* **(b)** ensure that installation of your Modified Version does not
|
||||
prevent the user installing or running the Standard Version. In
|
||||
addition, the Modified Version must bear a name that is different
|
||||
from the name of the Standard Version.
|
||||
* **(c)** allow anyone who receives a copy of the Modified Version to
|
||||
make the Source form of the Modified Version available to others
|
||||
under
|
||||
* **(i)** the Original License or
|
||||
* **(ii)** a license that permits the licensee to freely copy,
|
||||
modify and redistribute the Modified Version using the same
|
||||
licensing terms that apply to the copy that the licensee
|
||||
received, and requires that the Source form of the Modified
|
||||
Version, and of any works derived from it, be made freely
|
||||
available in that license fees are prohibited but Distributor
|
||||
Fees are allowed.
|
||||
|
||||
### Distribution of Compiled Forms of the Standard Version
|
||||
### or Modified Versions without the Source
|
||||
|
||||
**(5)** You may Distribute Compiled forms of the Standard Version without
|
||||
the Source, provided that you include complete instructions on how to
|
||||
get the Source of the Standard Version. Such instructions must be
|
||||
valid at the time of your distribution. If these instructions, at any
|
||||
time while you are carrying out such distribution, become invalid, you
|
||||
must provide new instructions on demand or cease further distribution.
|
||||
If you provide valid instructions or cease distribution within thirty
|
||||
days after you become aware that the instructions are invalid, then
|
||||
you do not forfeit any of your rights under this license.
|
||||
|
||||
**(6)** You may Distribute a Modified Version in Compiled form without
|
||||
the Source, provided that you comply with Section 4 with respect to
|
||||
the Source of the Modified Version.
|
||||
|
||||
### Aggregating or Linking the Package
|
||||
|
||||
**(7)** You may aggregate the Package (either the Standard Version or
|
||||
Modified Version) with other packages and Distribute the resulting
|
||||
aggregation provided that you do not charge a licensing fee for the
|
||||
Package. Distributor Fees are permitted, and licensing fees for other
|
||||
components in the aggregation are permitted. The terms of this license
|
||||
apply to the use and Distribution of the Standard or Modified Versions
|
||||
as included in the aggregation.
|
||||
|
||||
**(8)** You are permitted to link Modified and Standard Versions with
|
||||
other works, to embed the Package in a larger work of your own, or to
|
||||
build stand-alone binary or bytecode versions of applications that
|
||||
include the Package, and Distribute the result without restriction,
|
||||
provided the result does not expose a direct interface to the Package.
|
||||
|
||||
### Items That are Not Considered Part of a Modified Version
|
||||
|
||||
**(9)** Works (including, but not limited to, modules and scripts) that
|
||||
merely extend or make use of the Package, do not, by themselves, cause
|
||||
the Package to be a Modified Version. In addition, such works are not
|
||||
considered parts of the Package itself, and are not subject to the
|
||||
terms of this license.
|
||||
|
||||
### General Provisions
|
||||
|
||||
**(10)** Any use, modification, and distribution of the Standard or
|
||||
Modified Versions is governed by this Artistic License. By using,
|
||||
modifying or distributing the Package, you accept this license. Do not
|
||||
use, modify, or distribute the Package, if you do not accept this
|
||||
license.
|
||||
|
||||
**(11)** If your Modified Version has been derived from a Modified
|
||||
Version made by someone other than you, you are nevertheless required
|
||||
to ensure that your Modified Version complies with the requirements of
|
||||
this license.
|
||||
|
||||
**(12)** This license does not grant you the right to use any trademark,
|
||||
service mark, tradename, or logo of the Copyright Holder.
|
||||
|
||||
**(13)** This license includes the non-exclusive, worldwide,
|
||||
free-of-charge patent license to make, have made, use, offer to sell,
|
||||
sell, import and otherwise transfer the Package with respect to any
|
||||
patent claims licensable by the Copyright Holder that are necessarily
|
||||
infringed by the Package. If you institute patent litigation
|
||||
(including a cross-claim or counterclaim) against any party alleging
|
||||
that the Package constitutes direct or contributory patent
|
||||
infringement, then this Artistic License to you shall terminate on the
|
||||
date that such litigation is filed.
|
||||
|
||||
**(14)** **Disclaimer of Warranty:**
|
||||
|
||||
THE PACKAGE IS PROVIDED BY THE COPYRIGHT HOLDER AND CONTRIBUTORS "AS
|
||||
IS' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES. THE IMPLIED
|
||||
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
|
||||
NON-INFRINGEMENT ARE DISCLAIMED TO THE EXTENT PERMITTED BY YOUR LOCAL
|
||||
LAW. UNLESS REQUIRED BY LAW, NO COPYRIGHT HOLDER OR CONTRIBUTOR WILL
|
||||
BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
|
||||
DAMAGES ARISING IN ANY WAY OUT OF THE USE OF THE PACKAGE, EVEN IF
|
||||
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
+154
@@ -0,0 +1,154 @@
|
||||
[](https://github.com/chocolateboy/babel-plugin-source-map-support/actions?query=workflow%3Atest)
|
||||
[](https://www.npmjs.org/package/babel-plugin-source-map-support)
|
||||
|
||||
<!-- TOC -->
|
||||
|
||||
- [NAME](#name)
|
||||
- [INSTALL](#install)
|
||||
- [SYNOPSIS](#synopsis)
|
||||
- [DESCRIPTION](#description)
|
||||
- [DEVELOPMENT](#development)
|
||||
- [NPM Scripts](#npm-scripts)
|
||||
- [COMPATIBILITY](#compatibility)
|
||||
- [SEE ALSO](#see-also)
|
||||
- [VERSION](#version)
|
||||
- [AUTHOR](#author)
|
||||
- [COPYRIGHT AND LICENSE](#copyright-and-license)
|
||||
|
||||
<!-- TOC END -->
|
||||
|
||||
# NAME
|
||||
|
||||
babel-plugin-source-map-support - a Babel plugin which automatically makes stack traces source-map aware
|
||||
|
||||
# INSTALL
|
||||
|
||||
$ npm install source-map-support --save
|
||||
$ npm install babel-plugin-source-map-support --save-dev
|
||||
|
||||
# SYNOPSIS
|
||||
|
||||
`$ cat test.js`
|
||||
|
||||
```javascript
|
||||
import foo from 'foo';
|
||||
import bar from 'bar';
|
||||
|
||||
foo(bar);
|
||||
```
|
||||
|
||||
`$ babel --plugins source-map-support test.js`
|
||||
|
||||
```javascript
|
||||
import 'source-map-support/register';
|
||||
import foo from 'foo';
|
||||
import bar from 'bar';
|
||||
|
||||
foo(bar);
|
||||
```
|
||||
|
||||
# DESCRIPTION
|
||||
|
||||
This is a [Babel](https://babeljs.io/)
|
||||
[plugin](https://babeljs.io/docs/advanced/plugins/) which prepends the
|
||||
following statement to source files:
|
||||
|
||||
```javascript
|
||||
import 'source-map-support/register';
|
||||
```
|
||||
|
||||
In conjunction with the
|
||||
[source-map-support](https://www.npmjs.com/package/source-map-support) module,
|
||||
**which must be installed separately**, this statement hooks into the v8
|
||||
stack-trace API to translate call sites in the transpiled code back to their
|
||||
corresponding locations in the original code.
|
||||
|
||||
Note: this only works in environments which support the v8 stack-trace API
|
||||
(e.g. Node.js and Chrome), though it's harmless in other environments.
|
||||
|
||||
The source-map-support module only needs to be registered in the top-level
|
||||
file(s) of an application, but it no-ops if it has already been loaded, so
|
||||
there's no harm in registering it in every file.
|
||||
|
||||
You probably don't want to use this plugin when compiling code for the web
|
||||
because you probably don't want to bundle source-maps and the
|
||||
source-map-support module in minified code. An easy way to limit the plugin's
|
||||
scope to development/test builds is to use Babel's
|
||||
[`env` option](https://babeljs.io/docs/en/options#env), e.g.:
|
||||
|
||||
```javascript
|
||||
{
|
||||
env: {
|
||||
development: {
|
||||
sourceMaps: 'inline',
|
||||
plugins: ['source-map-support', ...]
|
||||
}
|
||||
},
|
||||
|
||||
presets: [ ... ]
|
||||
}
|
||||
```
|
||||
|
||||
Note that source-maps don't need to be inlined in each file. They can be
|
||||
externalised by using the `{ sourceMaps: true }` option. This adds a link to
|
||||
the bottom of each file which points to its generated source-map, e.g.:
|
||||
|
||||
```javascript
|
||||
{
|
||||
env: {
|
||||
development: {
|
||||
sourceMaps: true,
|
||||
plugins: ['source-map-support', ...]
|
||||
}
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
```javascript
|
||||
// index.js footer:
|
||||
//# sourceMappingURL=index.js.map
|
||||
```
|
||||
|
||||
# DEVELOPMENT
|
||||
|
||||
<details>
|
||||
|
||||
## NPM Scripts
|
||||
|
||||
The following NPM scripts are available:
|
||||
|
||||
- build - compile the plugin and save it to the `dist` directory
|
||||
- build:doc - generate the README's TOC (table of contents)
|
||||
- clean - remove the `dist` directory and other build artifacts
|
||||
- rebuild - clean the build artifacts and recompile the code
|
||||
- test - rebuild the plugin and run the test suite
|
||||
- test:debug - run the `test` script in debug mode, which dumps each transformed test case
|
||||
- test:prod - run the test suite in production mode
|
||||
- test:run - run the test suite
|
||||
|
||||
</details>
|
||||
|
||||
# COMPATIBILITY
|
||||
|
||||
- Babel >= 7
|
||||
- [Maintained Node.js versions](https://github.com/nodejs/Release#readme)
|
||||
|
||||
# SEE ALSO
|
||||
|
||||
- [babel](https://babeljs.io/)
|
||||
- [source-map-support](https://www.npmjs.com/package/source-map-support)
|
||||
|
||||
# VERSION
|
||||
|
||||
2.2.0
|
||||
|
||||
# AUTHOR
|
||||
|
||||
[chocolateboy](mailto:chocolate@cpan.org)
|
||||
|
||||
# COPYRIGHT AND LICENSE
|
||||
|
||||
Copyright © 2015-2022 by chocolateboy.
|
||||
|
||||
This module is free software; you can redistribute it and/or modify it under the
|
||||
terms of the [Artistic License 2.0](https://www.opensource.org/licenses/artistic-license-2.0.php).
|
||||
+15
@@ -0,0 +1,15 @@
|
||||
import { addSideEffect } from '@babel/helper-module-imports';
|
||||
|
||||
const IMPORT = 'source-map-support/register';
|
||||
|
||||
function babelPluginSourceMapSupport () {
|
||||
return {
|
||||
visitor: {
|
||||
Program (path) {
|
||||
addSideEffect(path, IMPORT);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export { babelPluginSourceMapSupport as default };
|
||||
+17
@@ -0,0 +1,17 @@
|
||||
'use strict';
|
||||
|
||||
var helperModuleImports = require('@babel/helper-module-imports');
|
||||
|
||||
const IMPORT = 'source-map-support/register';
|
||||
|
||||
function babelPluginSourceMapSupport () {
|
||||
return {
|
||||
visitor: {
|
||||
Program (path) {
|
||||
helperModuleImports.addSideEffect(path, IMPORT);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
module.exports = babelPluginSourceMapSupport;
|
||||
+50
@@ -0,0 +1,50 @@
|
||||
{
|
||||
"name": "babel-plugin-source-map-support",
|
||||
"version": "2.2.0",
|
||||
"description": "A Babel plugin which automatically makes stack traces source-map aware",
|
||||
"repository": "chocolateboy/babel-plugin-source-map-support",
|
||||
"license": "Artistic-2.0",
|
||||
"main": "dist/index.js",
|
||||
"module": "dist/index.esm.js",
|
||||
"scripts": {
|
||||
"build": "rollup -c --exports default",
|
||||
"build:doc": "toc-md README.md",
|
||||
"clean": "shx rm -rf dist",
|
||||
"prepublishOnly": "run-p build:doc test:prod",
|
||||
"rebuild": "run-s clean build",
|
||||
"test": "run-s rebuild test:run",
|
||||
"test:debug": "cross-env NODE_ENV=development run-s test",
|
||||
"test:prod": "cross-env NODE_ENV=production run-s test",
|
||||
"test:run": "ava --verbose ./test/test.js"
|
||||
},
|
||||
"files": [
|
||||
"dist/index.esm.js",
|
||||
"dist/index.js"
|
||||
],
|
||||
"browserslist": "maintained node versions",
|
||||
"dependencies": {
|
||||
"@babel/helper-module-imports": "^7.16.7"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@babel/core": "^7.18.5",
|
||||
"@rollup/plugin-node-resolve": "^13.3.0",
|
||||
"ava": "^4.3.0",
|
||||
"cross-env": "^7.0.3",
|
||||
"npm-run-all": "^4.1.5",
|
||||
"prettier": "^2.7.1",
|
||||
"rollup": "^2.75.7",
|
||||
"shx": "^0.3.4",
|
||||
"source-map-support": "^0.5.21",
|
||||
"toc-md-alt": "^0.4.6"
|
||||
},
|
||||
"keywords": [
|
||||
"babel-plugin",
|
||||
"source-map",
|
||||
"sourcemap",
|
||||
"source-maps",
|
||||
"sourcemaps",
|
||||
"stack-trace",
|
||||
"stacktrace",
|
||||
"v8"
|
||||
]
|
||||
}
|
||||
Reference in New Issue
Block a user