chore: initial clean commit without large binaries
This commit is contained in:
+1
@@ -0,0 +1 @@
|
||||
../../acorn@8.16.0/node_modules/acorn
|
||||
+1
@@ -0,0 +1 @@
|
||||
../../acorn-jsx@5.3.2_acorn@8.16.0/node_modules/acorn-jsx
|
||||
+1
@@ -0,0 +1 @@
|
||||
../../eslint-visitor-keys@5.0.1/node_modules/eslint-visitor-keys
|
||||
+25
@@ -0,0 +1,25 @@
|
||||
BSD 2-Clause License
|
||||
|
||||
Copyright (c) Open JS Foundation
|
||||
All rights reserved.
|
||||
|
||||
Redistribution and use in source and binary forms, with or without
|
||||
modification, are permitted provided that the following conditions are met:
|
||||
|
||||
1. Redistributions of source code must retain the above copyright notice, this
|
||||
list of conditions and the following disclaimer.
|
||||
|
||||
2. Redistributions in binary form must reproduce the above copyright notice,
|
||||
this list of conditions and the following disclaimer in the documentation
|
||||
and/or other materials provided with the distribution.
|
||||
|
||||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
||||
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||||
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
||||
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||||
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
+261
@@ -0,0 +1,261 @@
|
||||
[](https://www.npmjs.com/package/espree)
|
||||
[](https://www.npmjs.com/package/espree)
|
||||
[](https://github.com/js/espree/actions)
|
||||
[](https://www.bountysource.com/trackers/9348450-eslint?utm_source=9348450&utm_medium=shield&utm_campaign=TRACKER_BADGE)
|
||||
|
||||
# Espree
|
||||
|
||||
Espree started out as a fork of [Esprima](http://esprima.org) v1.2.2, the last stable published released of Esprima before work on ECMAScript 6 began. Espree is now built on top of [Acorn](https://github.com/ternjs/acorn), which has a modular architecture that allows extension of core functionality. The goal of Espree is to produce output that is similar to Esprima with a similar API so that it can be used in place of Esprima.
|
||||
|
||||
## Usage
|
||||
|
||||
Install:
|
||||
|
||||
```
|
||||
npm i espree
|
||||
```
|
||||
|
||||
To use in an ESM file:
|
||||
|
||||
```js
|
||||
import * as espree from "espree";
|
||||
|
||||
const ast = espree.parse(code);
|
||||
```
|
||||
|
||||
To use in a Common JS file:
|
||||
|
||||
```js
|
||||
const espree = require("espree");
|
||||
|
||||
const ast = espree.parse(code);
|
||||
```
|
||||
|
||||
## API
|
||||
|
||||
### `parse()`
|
||||
|
||||
`parse` parses the given code and returns a abstract syntax tree (AST). It takes two parameters.
|
||||
|
||||
- `code` [string]() - the code which needs to be parsed.
|
||||
- `options (Optional)` [Object]() - read more about this [here](#options).
|
||||
|
||||
```js
|
||||
import * as espree from "espree";
|
||||
|
||||
const ast = espree.parse(code);
|
||||
```
|
||||
|
||||
**Example :**
|
||||
|
||||
```js
|
||||
const ast = espree.parse('let foo = "bar"', { ecmaVersion: 6 });
|
||||
console.log(ast);
|
||||
```
|
||||
|
||||
<details><summary>Output</summary>
|
||||
<p>
|
||||
|
||||
```
|
||||
Node {
|
||||
type: 'Program',
|
||||
start: 0,
|
||||
end: 15,
|
||||
body: [
|
||||
Node {
|
||||
type: 'VariableDeclaration',
|
||||
start: 0,
|
||||
end: 15,
|
||||
declarations: [Array],
|
||||
kind: 'let'
|
||||
}
|
||||
],
|
||||
sourceType: 'script'
|
||||
}
|
||||
```
|
||||
|
||||
</p>
|
||||
</details>
|
||||
|
||||
### `tokenize()`
|
||||
|
||||
`tokenize` returns the tokens of a given code. It takes two parameters.
|
||||
|
||||
- `code` [string]() - the code which needs to be parsed.
|
||||
- `options (Optional)` [Object]() - read more about this [here](#options).
|
||||
|
||||
Even if `options` is empty or undefined or `options.tokens` is `false`, it assigns it to `true` in order to get the `tokens` array
|
||||
|
||||
**Example :**
|
||||
|
||||
```js
|
||||
import * as espree from "espree";
|
||||
|
||||
const tokens = espree.tokenize('let foo = "bar"', { ecmaVersion: 6 });
|
||||
console.log(tokens);
|
||||
```
|
||||
|
||||
<details><summary>Output</summary>
|
||||
<p>
|
||||
|
||||
```
|
||||
Token { type: 'Keyword', value: 'let', start: 0, end: 3 },
|
||||
Token { type: 'Identifier', value: 'foo', start: 4, end: 7 },
|
||||
Token { type: 'Punctuator', value: '=', start: 8, end: 9 },
|
||||
Token { type: 'String', value: '"bar"', start: 10, end: 15 }
|
||||
```
|
||||
|
||||
</p>
|
||||
</details>
|
||||
|
||||
### `version`
|
||||
|
||||
Returns the current `espree` version
|
||||
|
||||
### `VisitorKeys`
|
||||
|
||||
Returns all visitor keys for traversing the AST from [eslint-visitor-keys](https://github.com/eslint/js/tree/main/packages/eslint-visitor-keys)
|
||||
|
||||
### `latestEcmaVersion`
|
||||
|
||||
Returns the latest ECMAScript supported by `espree`
|
||||
|
||||
### `supportedEcmaVersions`
|
||||
|
||||
Returns an array of all supported ECMAScript versions
|
||||
|
||||
## Options
|
||||
|
||||
```js
|
||||
const options = {
|
||||
// attach range information to each node
|
||||
range: false,
|
||||
|
||||
// attach line/column location information to each node
|
||||
loc: false,
|
||||
|
||||
// create a top-level comments array containing all comments
|
||||
comment: false,
|
||||
|
||||
// create a top-level tokens array containing all tokens
|
||||
tokens: false,
|
||||
|
||||
// Set to 3, 5 (the default), 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16 or 17 to specify the version of ECMAScript syntax you want to use.
|
||||
// You can also set to 2015 (same as 6), 2016 (same as 7), 2017 (same as 8), 2018 (same as 9), 2019 (same as 10), 2020 (same as 11), 2021 (same as 12), 2022 (same as 13), 2023 (same as 14), 2024 (same as 15), 2025 (same as 16) or 2026 (same as 17) to use the year-based naming.
|
||||
// You can also set "latest" to use the most recently supported version.
|
||||
ecmaVersion: 3,
|
||||
|
||||
allowReserved: true, // only allowed when ecmaVersion is 3
|
||||
|
||||
// specify which type of script you're parsing ("script", "module", or "commonjs")
|
||||
sourceType: "script",
|
||||
|
||||
// specify additional language features
|
||||
ecmaFeatures: {
|
||||
// enable JSX parsing
|
||||
jsx: false,
|
||||
|
||||
// enable return in global scope (set to true automatically when sourceType is "commonjs")
|
||||
globalReturn: false,
|
||||
|
||||
// enable implied strict mode (if ecmaVersion >= 5)
|
||||
impliedStrict: false,
|
||||
},
|
||||
};
|
||||
```
|
||||
|
||||
## Esprima Compatibility Going Forward
|
||||
|
||||
The primary goal is to produce the exact same AST structure and tokens as Esprima, and that takes precedence over anything else. (The AST structure being the [ESTree](https://github.com/estree/estree) API with JSX extensions.) Separate from that, Espree may deviate from what Esprima outputs in terms of where and how comments are attached, as well as what additional information is available on AST nodes. That is to say, Espree may add more things to the AST nodes than Esprima does but the overall AST structure produced will be the same.
|
||||
|
||||
Espree may also deviate from Esprima in the interface it exposes.
|
||||
|
||||
## Contributing
|
||||
|
||||
Issues and pull requests will be triaged and responded to as quickly as possible. We operate under the [ESLint Contributor Guidelines](http://eslint.org/docs/developer-guide/contributing), so please be sure to read them before contributing. If you're not sure where to dig in, check out the [issues](https://github.com/eslint/js/issues).
|
||||
|
||||
Espree is licensed under a permissive BSD 2-clause license.
|
||||
|
||||
## Security Policy
|
||||
|
||||
We work hard to ensure that Espree is safe for everyone and that security issues are addressed quickly and responsibly. Read the full [security policy](https://github.com/eslint/.github/blob/master/SECURITY.md).
|
||||
|
||||
## Build Commands
|
||||
|
||||
- `npm test` - run all tests
|
||||
- `npm run lint` - run all linting
|
||||
|
||||
## Differences from Espree 2.x
|
||||
|
||||
- The `tokenize()` method does not use `ecmaFeatures`. Any string will be tokenized completely based on ECMAScript 6 semantics.
|
||||
- Trailing whitespace no longer is counted as part of a node.
|
||||
- `let` and `const` declarations are no longer parsed by default. You must opt-in by using an `ecmaVersion` newer than `5` or setting `sourceType` to `module`.
|
||||
- The `esparse` and `esvalidate` binary scripts have been removed.
|
||||
- There is no `tolerant` option. We will investigate adding this back in the future.
|
||||
|
||||
## Known Incompatibilities
|
||||
|
||||
In an effort to help those wanting to transition from other parsers to Espree, the following is a list of noteworthy incompatibilities with other parsers. These are known differences that we do not intend to change.
|
||||
|
||||
### Esprima 1.2.2
|
||||
|
||||
- Esprima counts trailing whitespace as part of each AST node while Espree does not. In Espree, the end of a node is where the last token occurs.
|
||||
- Espree does not parse `let` and `const` declarations by default.
|
||||
- Error messages returned for parsing errors are different.
|
||||
- There are two addition properties on every node and token: `start` and `end`. These represent the same data as `range` and are used internally by Acorn.
|
||||
|
||||
### Esprima 2.x
|
||||
|
||||
- Esprima 2.x uses a different comment attachment algorithm that results in some comments being added in different places than Espree. The algorithm Espree uses is the same one used in Esprima 1.2.2.
|
||||
|
||||
## Frequently Asked Questions
|
||||
|
||||
### Why another parser
|
||||
|
||||
[ESLint](http://eslint.org) had been relying on Esprima as its parser from the beginning. While that was fine when the JavaScript language was evolving slowly, the pace of development increased dramatically and Esprima had fallen behind. ESLint, like many other tools reliant on Esprima, has been stuck in using new JavaScript language features until Esprima updates, and that caused our users frustration.
|
||||
|
||||
We decided the only way for us to move forward was to create our own parser, bringing us inline with JSHint and JSLint, and allowing us to keep implementing new features as we need them. We chose to fork Esprima instead of starting from scratch in order to move as quickly as possible with a compatible API.
|
||||
|
||||
With Espree 2.0.0, we are no longer a fork of Esprima but rather a translation layer between Acorn and Esprima syntax. This allows us to put work back into a community-supported parser (Acorn) that is continuing to grow and evolve while maintaining an Esprima-compatible parser for those utilities still built on Esprima.
|
||||
|
||||
### Have you tried working with Esprima?
|
||||
|
||||
Yes. Since the start of ESLint, we've regularly filed bugs and feature requests with Esprima and will continue to do so. However, there are some different philosophies around how the projects work that need to be worked through. The initial goal was to have Espree track Esprima and eventually merge the two back together, but we ultimately decided that building on top of Acorn was a better choice due to Acorn's plugin support.
|
||||
|
||||
### Why don't you just use Acorn?
|
||||
|
||||
Acorn is a great JavaScript parser that produces an AST that is compatible with Esprima. Unfortunately, ESLint relies on more than just the AST to do its job. It relies on Esprima's tokens and comment attachment features to get a complete picture of the source code. We investigated switching to Acorn, but the inconsistencies between Esprima and Acorn created too much work for a project like ESLint.
|
||||
|
||||
We are building on top of Acorn, however, so that we can contribute back and help make Acorn even better.
|
||||
|
||||
### What ECMAScript features do you support?
|
||||
|
||||
Espree supports all ECMAScript 2025 features and partially supports ECMAScript 2026 features.
|
||||
|
||||
Because ECMAScript 2026 is still under development, we are implementing features as they are finalized. Currently, Espree supports:
|
||||
|
||||
- [Explicit Resource Management](https://github.com/tc39/proposal-explicit-resource-management)
|
||||
|
||||
See [finished-proposals.md](https://github.com/tc39/proposals/blob/master/finished-proposals.md) to know what features are finalized.
|
||||
|
||||
### How do you determine which experimental features to support?
|
||||
|
||||
In general, we do not support experimental JavaScript features. We may make exceptions from time to time depending on the maturity of the features.
|
||||
|
||||
<!-- NOTE: This section is autogenerated. Do not manually edit.-->
|
||||
<!--sponsorsstart-->
|
||||
|
||||
## Sponsors
|
||||
|
||||
The following companies, organizations, and individuals support ESLint's ongoing maintenance and development. [Become a Sponsor](https://eslint.org/donate)
|
||||
to get your logo on our READMEs and [website](https://eslint.org/sponsors).
|
||||
|
||||
<h3>Platinum Sponsors</h3>
|
||||
<p><a href="https://automattic.com"><img src="https://images.opencollective.com/automattic/d0ef3e1/logo.png" alt="Automattic" height="128"></a></p><h3>Gold Sponsors</h3>
|
||||
<p><a href="https://qlty.sh/"><img src="https://images.opencollective.com/qltysh/33d157d/logo.png" alt="Qlty Software" height="96"></a></p><h3>Silver Sponsors</h3>
|
||||
<p><a href="https://vite.dev/"><img src="https://images.opencollective.com/vite/d472863/logo.png" alt="Vite" height="64"></a> <a href="https://liftoff.io/"><img src="https://images.opencollective.com/liftoff/2d6c3b6/logo.png" alt="Liftoff" height="64"></a> <a href="https://stackblitz.com"><img src="https://avatars.githubusercontent.com/u/28635252" alt="StackBlitz" height="64"></a></p><h3>Bronze Sponsors</h3>
|
||||
<p><a href="https://cybozu.co.jp/"><img src="https://images.opencollective.com/cybozu/933e46d/logo.png" alt="Cybozu" height="32"></a> <a href="https://opensource.sap.com"><img src="https://avatars.githubusercontent.com/u/2531208" alt="SAP" height="32"></a> <a href="https://www.crawljobs.com/"><img src="https://images.opencollective.com/crawljobs-poland/fa43a17/logo.png" alt="CrawlJobs" height="32"></a> <a href="https://depot.dev"><img src="https://images.opencollective.com/depot/39125a1/logo.png" alt="Depot" height="32"></a> <a href="https://www.n-ix.com/"><img src="https://images.opencollective.com/n-ix-ltd/575a7a5/logo.png" alt="N-iX Ltd" height="32"></a> <a href="https://icons8.com/"><img src="https://images.opencollective.com/icons8/7fa1641/logo.png" alt="Icons8" height="32"></a> <a href="https://discord.com"><img src="https://images.opencollective.com/discordapp/f9645d9/logo.png" alt="Discord" height="32"></a> <a href="https://www.gitbook.com"><img src="https://avatars.githubusercontent.com/u/7111340" alt="GitBook" height="32"></a> <a href="https://herocoders.com"><img src="https://avatars.githubusercontent.com/u/37549774" alt="HeroCoders" height="32"></a> <a href="https://www.lambdatest.com"><img src="https://avatars.githubusercontent.com/u/171592363" alt="TestMu AI Open Source Office (Formerly LambdaTest)" height="32"></a></p>
|
||||
<h3>Technology Sponsors</h3>
|
||||
Technology sponsors allow us to use their products and services for free as part of a contribution to the open source ecosystem and our work.
|
||||
<p><a href="https://netlify.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/netlify-icon.svg" alt="Netlify" height="32"></a> <a href="https://algolia.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/algolia-icon.svg" alt="Algolia" height="32"></a> <a href="https://1password.com"><img src="https://raw.githubusercontent.com/eslint/eslint.org/main/src/assets/images/techsponsors/1password-icon.svg" alt="1Password" height="32"></a></p>
|
||||
<!--sponsorsend-->
|
||||
+1284
File diff suppressed because it is too large
Load Diff
+3
@@ -0,0 +1,3 @@
|
||||
import * as espree from "./espree.js";
|
||||
export = espree;
|
||||
//# sourceMappingURL=espree.d.cts.map
|
||||
+1
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"espree.d.cts","sourceRoot":"","sources":["../espree.cts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,SAAS,MAAM,CAAC"}
|
||||
+67
@@ -0,0 +1,67 @@
|
||||
/**
|
||||
* Tokenizes the given code.
|
||||
* @param {string} code The code to tokenize.
|
||||
* @param {Options} [options] Options defining how to tokenize.
|
||||
* @returns {EspreeTokens} An array of tokens.
|
||||
* @throws {EnhancedSyntaxError} If the input code is invalid.
|
||||
* @private
|
||||
*/
|
||||
export function tokenize(code: string, options?: Options): EspreeTokens;
|
||||
/**
|
||||
* Parses the given code.
|
||||
* @param {string} code The code to tokenize.
|
||||
* @param {Options} [options] Options defining how to tokenize.
|
||||
* @returns {acorn.Program} The "Program" AST node.
|
||||
* @throws {EnhancedSyntaxError} If the input code is invalid.
|
||||
*/
|
||||
export function parse(code: string, options?: Options): acorn.Program;
|
||||
/** @type {string} */
|
||||
export const version: string;
|
||||
export const name: "espree";
|
||||
export const Syntax: Record<string, string>;
|
||||
export const latestEcmaVersion: 17;
|
||||
export const supportedEcmaVersions: [3, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17];
|
||||
export { KEYS as VisitorKeys } from "eslint-visitor-keys";
|
||||
export type EcmaVersion = 3 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 2015 | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | 2022 | 2023 | 2024 | 2025 | 2026 | "latest";
|
||||
export type EspreeToken = {
|
||||
type: string;
|
||||
value: any;
|
||||
start?: number;
|
||||
end?: number;
|
||||
loc?: acorn.SourceLocation;
|
||||
range?: [number, number];
|
||||
regex?: {
|
||||
flags: string;
|
||||
pattern: string;
|
||||
};
|
||||
};
|
||||
export type EspreeComment = {
|
||||
type: "Block" | "Hashbang" | "Line";
|
||||
value: string;
|
||||
range?: [number, number];
|
||||
start?: number;
|
||||
end?: number;
|
||||
loc?: {
|
||||
start: acorn.Position | undefined;
|
||||
end: acorn.Position | undefined;
|
||||
};
|
||||
};
|
||||
export type EspreeTokens = {
|
||||
comments?: EspreeComment[];
|
||||
} & EspreeToken[];
|
||||
export type Options = {
|
||||
allowReserved?: boolean;
|
||||
ecmaVersion?: EcmaVersion;
|
||||
sourceType?: "script" | "module" | "commonjs";
|
||||
ecmaFeatures?: {
|
||||
jsx?: boolean;
|
||||
globalReturn?: boolean;
|
||||
impliedStrict?: boolean;
|
||||
};
|
||||
range?: boolean;
|
||||
loc?: boolean;
|
||||
tokens?: boolean;
|
||||
comment?: boolean;
|
||||
};
|
||||
import * as acorn from "acorn";
|
||||
//# sourceMappingURL=espree.d.ts.map
|
||||
+1
@@ -0,0 +1 @@
|
||||
{"version":3,"file":"espree.d.ts","sourceRoot":"","sources":["../espree.js"],"names":[],"mappings":"AAuNA;;;;;;;GAOG;AACH,+BANW,MAAM,YACN,OAAO,GACL,YAAY,CAaxB;AAMD;;;;;;GAMG;AACH,4BALW,MAAM,YACN,OAAO,GACL,KAAK,CAAC,OAAO,CAOzB;AAMD,qBAAqB;AACrB,sBADW,MAAM,CACe;AAChC,mBAAoB,QAAQ,CAAC;AAG7B,4CAoBK;AAEL,mCAAwE;AAExE,uFAAgF;;0BAlNnE,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,CAAC,GAAC,EAAE,GAAC,EAAE,GAAC,EAAE,GAAC,EAAE,GAAC,EAAE,GAAC,EAAE,GAAC,EAAE,GAAC,EAAE,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,IAAI,GAAC,QAAQ;0BAIxG;IACR,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC;IAC3B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC;CAC1C;4BAIS;IACR,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE;QACJ,KAAK,EAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC;QAClC,GAAG,EAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAA;KAChC,CAAA;CACF;2BAIS;IACR,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAA;CAC3B,GAAG,WAAW,EAAE;sBAeP;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,UAAU,CAAC,EAAE,QAAQ,GAAC,QAAQ,GAAC,UAAU,CAAC;IAC1C,YAAY,CAAC,EAAE;QACb,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,aAAa,CAAC,EAAE,OAAO,CAAA;KACxB,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;uBA7EmB,OAAO"}
|
||||
+287
@@ -0,0 +1,287 @@
|
||||
/**
|
||||
* @fileoverview Main Espree file that converts Acorn into Esprima output.
|
||||
*
|
||||
* This file contains code from the following MIT-licensed projects:
|
||||
* 1. Acorn
|
||||
* 2. Babylon
|
||||
* 3. Babel-ESLint
|
||||
*
|
||||
* This file also contains code from Esprima, which is BSD licensed.
|
||||
*
|
||||
* Acorn is Copyright 2012-2015 Acorn Contributors (https://github.com/marijnh/acorn/blob/master/AUTHORS)
|
||||
* Babylon is Copyright 2014-2015 various contributors (https://github.com/babel/babel/blob/master/packages/babylon/AUTHORS)
|
||||
* Babel-ESLint is Copyright 2014-2015 Sebastian McKenzie <sebmck@gmail.com>
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions are met:
|
||||
*
|
||||
* * Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* * Redistributions in binary form must reproduce the above copyright
|
||||
* notice, this list of conditions and the following disclaimer in the
|
||||
* documentation and/or other materials provided with the distribution.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
* ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
|
||||
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
||||
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
||||
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
*
|
||||
* Esprima is Copyright (c) jQuery Foundation, Inc. and Contributors, All Rights Reserved.
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions are met:
|
||||
*
|
||||
* * Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* * Redistributions in binary form must reproduce the above copyright
|
||||
* notice, this list of conditions and the following disclaimer in the
|
||||
* documentation and/or other materials provided with the distribution.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
* ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
|
||||
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
||||
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
||||
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
|
||||
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
||||
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
*/
|
||||
|
||||
import * as acorn from "acorn";
|
||||
import jsx from "acorn-jsx";
|
||||
import espree from "./lib/espree.js";
|
||||
import { KEYS as VisitorKeys } from "eslint-visitor-keys";
|
||||
import {
|
||||
getLatestEcmaVersion,
|
||||
getSupportedEcmaVersions,
|
||||
} from "./lib/options.js";
|
||||
|
||||
/**
|
||||
* @import { EspreeParserCtor, EspreeParserJsxCtor } from "./lib/types.js";
|
||||
*/
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// Types exported from file
|
||||
// ----------------------------------------------------------------------------
|
||||
/**
|
||||
* @typedef {3|5|6|7|8|9|10|11|12|13|14|15|16|17|2015|2016|2017|2018|2019|2020|2021|2022|2023|2024|2025|2026|'latest'} EcmaVersion
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {{
|
||||
* type: string;
|
||||
* value: any;
|
||||
* start?: number;
|
||||
* end?: number;
|
||||
* loc?: acorn.SourceLocation;
|
||||
* range?: [number, number];
|
||||
* regex?: {flags: string, pattern: string};
|
||||
* }} EspreeToken
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {{
|
||||
* type: "Block" | "Hashbang" | "Line",
|
||||
* value: string,
|
||||
* range?: [number, number],
|
||||
* start?: number,
|
||||
* end?: number,
|
||||
* loc?: {
|
||||
* start: acorn.Position | undefined,
|
||||
* end: acorn.Position | undefined
|
||||
* }
|
||||
* }} EspreeComment
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {{
|
||||
* comments?: EspreeComment[]
|
||||
* } & EspreeToken[]} EspreeTokens
|
||||
*/
|
||||
|
||||
/**
|
||||
* `allowReserved` is as in `acorn.Options`
|
||||
*
|
||||
* `ecmaVersion` currently as in `acorn.Options` though optional
|
||||
*
|
||||
* `sourceType` as in `acorn.Options` but also allows `commonjs`
|
||||
*
|
||||
* `ecmaFeatures`, `range`, `loc`, `tokens` are not in `acorn.Options`
|
||||
*
|
||||
* `comment` is not in `acorn.Options` and doesn't err without it, but is used
|
||||
*/
|
||||
/**
|
||||
* @typedef {{
|
||||
* allowReserved?: boolean,
|
||||
* ecmaVersion?: EcmaVersion,
|
||||
* sourceType?: "script"|"module"|"commonjs",
|
||||
* ecmaFeatures?: {
|
||||
* jsx?: boolean,
|
||||
* globalReturn?: boolean,
|
||||
* impliedStrict?: boolean
|
||||
* },
|
||||
* range?: boolean,
|
||||
* loc?: boolean,
|
||||
* tokens?: boolean,
|
||||
* comment?: boolean,
|
||||
* }} Options
|
||||
*/
|
||||
|
||||
// To initialize lazily.
|
||||
const parsers = {
|
||||
/** @type {EspreeParserCtor|null} */
|
||||
_regular: null,
|
||||
|
||||
/** @type {EspreeParserJsxCtor|null} */
|
||||
_jsx: null,
|
||||
|
||||
/**
|
||||
* Returns regular Parser
|
||||
* @returns {EspreeParserCtor} Regular Acorn parser
|
||||
*/
|
||||
get regular() {
|
||||
if (this._regular === null) {
|
||||
const espreeParserFactory = /** @type {unknown} */ (espree());
|
||||
|
||||
this._regular = /** @type {EspreeParserCtor} */ (
|
||||
// Without conversion, types are incompatible, as
|
||||
// acorn's has a protected constructor
|
||||
/** @type {unknown} */
|
||||
(
|
||||
acorn.Parser.extend(
|
||||
/**
|
||||
* @type {(
|
||||
* BaseParser: typeof acorn.Parser
|
||||
* ) => typeof acorn.Parser}
|
||||
*/ (espreeParserFactory),
|
||||
)
|
||||
)
|
||||
);
|
||||
}
|
||||
return this._regular;
|
||||
},
|
||||
|
||||
/**
|
||||
* Returns JSX Parser
|
||||
* @returns {EspreeParserJsxCtor} JSX Acorn parser
|
||||
*/
|
||||
get jsx() {
|
||||
if (this._jsx === null) {
|
||||
const espreeParserFactory = /** @type {unknown} */ (espree());
|
||||
const jsxFactory = jsx();
|
||||
|
||||
this._jsx = /** @type {EspreeParserJsxCtor} */ (
|
||||
// Without conversion, types are incompatible, as
|
||||
// acorn's has a protected constructor
|
||||
/** @type {unknown} */
|
||||
(
|
||||
acorn.Parser.extend(
|
||||
jsxFactory,
|
||||
|
||||
/** @type {(BaseParser: typeof acorn.Parser) => typeof acorn.Parser} */
|
||||
(espreeParserFactory),
|
||||
)
|
||||
)
|
||||
);
|
||||
}
|
||||
return this._jsx;
|
||||
},
|
||||
|
||||
/**
|
||||
* Gets the parser object based on the supplied options.
|
||||
* @param {Options} [options] The parser options.
|
||||
* @returns {EspreeParserJsxCtor|EspreeParserCtor} Regular or JSX Acorn parser
|
||||
*/
|
||||
get(options) {
|
||||
const useJsx = Boolean(
|
||||
options && options.ecmaFeatures && options.ecmaFeatures.jsx,
|
||||
);
|
||||
|
||||
return useJsx ? this.jsx : this.regular;
|
||||
},
|
||||
};
|
||||
|
||||
//------------------------------------------------------------------------------
|
||||
// Tokenizer
|
||||
//------------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Tokenizes the given code.
|
||||
* @param {string} code The code to tokenize.
|
||||
* @param {Options} [options] Options defining how to tokenize.
|
||||
* @returns {EspreeTokens} An array of tokens.
|
||||
* @throws {EnhancedSyntaxError} If the input code is invalid.
|
||||
* @private
|
||||
*/
|
||||
export function tokenize(code, options) {
|
||||
const Parser = parsers.get(options);
|
||||
|
||||
// Ensure to collect tokens.
|
||||
if (!options || options.tokens !== true) {
|
||||
options = Object.assign({}, options, { tokens: true }); // eslint-disable-line no-param-reassign -- stylistic choice
|
||||
}
|
||||
|
||||
return /** @type {EspreeTokens} */ (new Parser(options, code).tokenize());
|
||||
}
|
||||
|
||||
//------------------------------------------------------------------------------
|
||||
// Parser
|
||||
//------------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Parses the given code.
|
||||
* @param {string} code The code to tokenize.
|
||||
* @param {Options} [options] Options defining how to tokenize.
|
||||
* @returns {acorn.Program} The "Program" AST node.
|
||||
* @throws {EnhancedSyntaxError} If the input code is invalid.
|
||||
*/
|
||||
export function parse(code, options) {
|
||||
const Parser = parsers.get(options);
|
||||
|
||||
return new Parser(options, code).parse();
|
||||
}
|
||||
|
||||
//------------------------------------------------------------------------------
|
||||
// Public
|
||||
//------------------------------------------------------------------------------
|
||||
|
||||
/** @type {string} */
|
||||
export const version = "11.2.0"; // x-release-please-version
|
||||
export const name = "espree";
|
||||
|
||||
// Derive node types from VisitorKeys
|
||||
export const Syntax = /* #__PURE__ */ (function () {
|
||||
let key,
|
||||
/** @type {Record<string,string>} */
|
||||
types = {};
|
||||
|
||||
if (typeof Object.create === "function") {
|
||||
types = Object.create(null);
|
||||
}
|
||||
|
||||
for (key in VisitorKeys) {
|
||||
if (Object.hasOwn(VisitorKeys, key)) {
|
||||
types[key] = key;
|
||||
}
|
||||
}
|
||||
|
||||
if (typeof Object.freeze === "function") {
|
||||
Object.freeze(types);
|
||||
}
|
||||
|
||||
return types;
|
||||
})();
|
||||
|
||||
export const latestEcmaVersion = /* #__PURE__ */ getLatestEcmaVersion();
|
||||
|
||||
export const supportedEcmaVersions = /* #__PURE__ */ getSupportedEcmaVersions();
|
||||
|
||||
export { KEYS as VisitorKeys } from "eslint-visitor-keys";
|
||||
+493
@@ -0,0 +1,493 @@
|
||||
/* eslint no-param-reassign: 0 -- stylistic choice */
|
||||
|
||||
import TokenTranslator from "./token-translator.js";
|
||||
import { normalizeOptions } from "./options.js";
|
||||
|
||||
/**
|
||||
* @import {
|
||||
* CommentType,
|
||||
* EspreeParserCtor,
|
||||
* EsprimaNode,
|
||||
* AcornJsxParserCtorEnhanced,
|
||||
* TokTypes
|
||||
* } from "./types.js";
|
||||
* @import {
|
||||
* Options,
|
||||
* EspreeToken as EsprimaToken,
|
||||
* EspreeTokens as EsprimaTokens,
|
||||
* EspreeComment as EsprimaComment
|
||||
* } from "../espree.js";
|
||||
* @import { NormalizedEcmaVersion } from "./options.js";
|
||||
* @import * as acorn from "acorn";
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {{
|
||||
* originalSourceType: "script" | "module" | "commonjs" | undefined
|
||||
* tokens: EsprimaToken[] | null,
|
||||
* comments: EsprimaComment[] | null,
|
||||
* impliedStrict: boolean,
|
||||
* ecmaVersion: NormalizedEcmaVersion,
|
||||
* jsxAttrValueToken: boolean,
|
||||
* lastToken: acorn.Token | null,
|
||||
* templateElements: acorn.TemplateElement[]
|
||||
* }} State
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {{
|
||||
* sourceType?: "script"|"module"|"commonjs";
|
||||
* comments?: EsprimaComment[];
|
||||
* tokens?: EsprimaToken[];
|
||||
* body: acorn.Node[];
|
||||
* } & acorn.Program} EsprimaProgramNode
|
||||
*/
|
||||
|
||||
// ----------------------------------------------------------------------------
|
||||
// Types exported from file
|
||||
// ----------------------------------------------------------------------------
|
||||
/**
|
||||
* @typedef {{
|
||||
* index?: number;
|
||||
* lineNumber?: number;
|
||||
* column?: number;
|
||||
* } & SyntaxError} EnhancedSyntaxError
|
||||
*/
|
||||
|
||||
// We add `jsxAttrValueToken` ourselves.
|
||||
/**
|
||||
* @typedef {{
|
||||
* jsxAttrValueToken?: acorn.TokenType;
|
||||
* } & TokTypes} EnhancedTokTypes
|
||||
*/
|
||||
|
||||
const STATE = Symbol("espree's internal state");
|
||||
const ESPRIMA_FINISH_NODE = Symbol("espree's esprimaFinishNode");
|
||||
|
||||
/**
|
||||
* Converts an Acorn comment to a Esprima comment.
|
||||
* @param {boolean} block True if it's a block comment, false if not.
|
||||
* @param {string} text The text of the comment.
|
||||
* @param {number} start The index at which the comment starts.
|
||||
* @param {number} end The index at which the comment ends.
|
||||
* @param {acorn.Position | undefined} startLoc The location at which the comment starts.
|
||||
* @param {acorn.Position | undefined} endLoc The location at which the comment ends.
|
||||
* @param {string} code The source code being parsed.
|
||||
* @returns {EsprimaComment} The comment object.
|
||||
* @private
|
||||
*/
|
||||
function convertAcornCommentToEsprimaComment(
|
||||
block,
|
||||
text,
|
||||
start,
|
||||
end,
|
||||
startLoc,
|
||||
endLoc,
|
||||
code,
|
||||
) {
|
||||
/** @type {CommentType} */
|
||||
let type;
|
||||
|
||||
if (block) {
|
||||
type = "Block";
|
||||
} else if (code.slice(start, start + 2) === "#!") {
|
||||
type = "Hashbang";
|
||||
} else {
|
||||
type = "Line";
|
||||
}
|
||||
|
||||
/**
|
||||
* @type {{
|
||||
* type: CommentType,
|
||||
* value: string,
|
||||
* start?: number,
|
||||
* end?: number,
|
||||
* range?: [number, number],
|
||||
* loc?: {
|
||||
* start: acorn.Position | undefined,
|
||||
* end: acorn.Position | undefined
|
||||
* }
|
||||
* }}
|
||||
*/
|
||||
const comment = {
|
||||
type,
|
||||
value: text,
|
||||
};
|
||||
|
||||
if (typeof start === "number") {
|
||||
comment.start = start;
|
||||
comment.end = end;
|
||||
comment.range = [start, end];
|
||||
}
|
||||
|
||||
if (typeof startLoc === "object") {
|
||||
comment.loc = {
|
||||
start: startLoc,
|
||||
end: endLoc,
|
||||
};
|
||||
}
|
||||
|
||||
return comment;
|
||||
}
|
||||
|
||||
// eslint-disable-next-line arrow-body-style -- For TS
|
||||
export default () => {
|
||||
/**
|
||||
* Returns the Espree parser.
|
||||
* @param {AcornJsxParserCtorEnhanced} Parser The Acorn parser. The `acorn` property is missing from acorn's
|
||||
* TypeScript but is present statically on the class.
|
||||
* @returns {EspreeParserCtor} The Espree Parser constructor.
|
||||
*/
|
||||
return Parser => {
|
||||
const tokTypes = /** @type {EnhancedTokTypes} */ (
|
||||
Object.assign({}, Parser.acorn.tokTypes)
|
||||
);
|
||||
|
||||
if (Parser.acornJsx) {
|
||||
Object.assign(tokTypes, Parser.acornJsx.tokTypes);
|
||||
}
|
||||
|
||||
return class Espree extends Parser {
|
||||
/**
|
||||
* @param {Options | null | undefined} opts The parser options
|
||||
* @param {string | object} code The code which will be converted to a string.
|
||||
*/
|
||||
constructor(opts, code) {
|
||||
if (typeof opts !== "object" || opts === null) {
|
||||
opts = {};
|
||||
}
|
||||
if (typeof code !== "string" && !(code instanceof String)) {
|
||||
code = String(code);
|
||||
}
|
||||
|
||||
// save original source type in case of commonjs
|
||||
const originalSourceType = opts.sourceType;
|
||||
const options = normalizeOptions(opts);
|
||||
const ecmaFeatures = options.ecmaFeatures || {};
|
||||
const tokenTranslator =
|
||||
options.tokens === true
|
||||
? new TokenTranslator(
|
||||
tokTypes,
|
||||
|
||||
// @ts-expect-error Appears to be a TS bug since the type is indeed string|String
|
||||
code,
|
||||
)
|
||||
: null;
|
||||
|
||||
/**
|
||||
* Data that is unique to Espree and is not represented internally
|
||||
* in Acorn.
|
||||
*
|
||||
* For ES2023 hashbangs, Espree will call `onComment()` during the
|
||||
* constructor, so we must define state before having access to
|
||||
* `this`.
|
||||
* @type {State}
|
||||
*/
|
||||
const state = {
|
||||
originalSourceType:
|
||||
originalSourceType || options.sourceType,
|
||||
tokens: tokenTranslator ? [] : null,
|
||||
comments: options.comment === true ? [] : null,
|
||||
impliedStrict:
|
||||
ecmaFeatures.impliedStrict === true &&
|
||||
options.ecmaVersion >= 5,
|
||||
ecmaVersion: options.ecmaVersion,
|
||||
jsxAttrValueToken: false,
|
||||
lastToken: null,
|
||||
templateElements: [],
|
||||
};
|
||||
|
||||
// Initialize acorn parser.
|
||||
super(
|
||||
{
|
||||
// do not use spread, because we don't want to pass any unknown options to acorn
|
||||
ecmaVersion: options.ecmaVersion,
|
||||
sourceType: options.sourceType,
|
||||
ranges: options.ranges,
|
||||
locations: options.locations,
|
||||
allowReserved: options.allowReserved,
|
||||
|
||||
// Truthy value is true for backward compatibility.
|
||||
allowReturnOutsideFunction:
|
||||
options.allowReturnOutsideFunction,
|
||||
|
||||
// Collect tokens
|
||||
onToken(token) {
|
||||
if (tokenTranslator) {
|
||||
// Use `tokens`, `ecmaVersion`, and `jsxAttrValueToken` in the state.
|
||||
tokenTranslator.onToken(
|
||||
token,
|
||||
|
||||
/**
|
||||
* @type {Omit<State, "tokens"> & {
|
||||
* tokens: EsprimaToken[]
|
||||
* }}
|
||||
*/
|
||||
(state),
|
||||
);
|
||||
}
|
||||
if (token.type !== tokTypes.eof) {
|
||||
state.lastToken = token;
|
||||
}
|
||||
},
|
||||
|
||||
// Collect comments
|
||||
onComment(block, text, start, end, startLoc, endLoc) {
|
||||
if (state.comments) {
|
||||
const comment =
|
||||
convertAcornCommentToEsprimaComment(
|
||||
block,
|
||||
text,
|
||||
start,
|
||||
end,
|
||||
startLoc,
|
||||
endLoc,
|
||||
|
||||
// @ts-expect-error Appears to be a TS bug
|
||||
// since the type is indeed string|String
|
||||
code,
|
||||
);
|
||||
|
||||
state.comments.push(comment);
|
||||
}
|
||||
},
|
||||
},
|
||||
// @ts-expect-error Appears to be a TS bug
|
||||
// since the type is indeed string|String
|
||||
code,
|
||||
);
|
||||
|
||||
/*
|
||||
* We put all of this data into a symbol property as a way to avoid
|
||||
* potential naming conflicts with future versions of Acorn.
|
||||
*/
|
||||
this[STATE] = state;
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns Espree tokens.
|
||||
* @returns {EsprimaTokens} The Esprima-compatible tokens
|
||||
*/
|
||||
tokenize() {
|
||||
do {
|
||||
this.next();
|
||||
} while (this.type !== tokTypes.eof);
|
||||
|
||||
// Consume the final eof token
|
||||
this.next();
|
||||
|
||||
const extra = this[STATE];
|
||||
const tokens = /** @type {EsprimaTokens} */ (extra.tokens);
|
||||
|
||||
if (extra.comments) {
|
||||
tokens.comments = extra.comments;
|
||||
}
|
||||
|
||||
return tokens;
|
||||
}
|
||||
|
||||
/**
|
||||
* Calls parent.
|
||||
* @param {acorn.Node} node The node
|
||||
* @param {string} type The type
|
||||
* @returns {acorn.Node} The altered Node
|
||||
*/
|
||||
finishNode(node, type) {
|
||||
const result = super.finishNode(node, type);
|
||||
|
||||
return this[ESPRIMA_FINISH_NODE](result);
|
||||
}
|
||||
|
||||
/**
|
||||
* Calls parent.
|
||||
* @param {acorn.Node} node The node
|
||||
* @param {string} type The type
|
||||
* @param {number} pos The position
|
||||
* @param {acorn.Position} loc The location
|
||||
* @returns {acorn.Node} The altered Node
|
||||
*/
|
||||
finishNodeAt(node, type, pos, loc) {
|
||||
const result = super.finishNodeAt(node, type, pos, loc);
|
||||
|
||||
return this[ESPRIMA_FINISH_NODE](result);
|
||||
}
|
||||
|
||||
/**
|
||||
* Parses.
|
||||
* @returns {EsprimaProgramNode} The program Node
|
||||
*/
|
||||
parse() {
|
||||
const extra = this[STATE];
|
||||
const prog = super.parse();
|
||||
|
||||
const program = /** @type {EsprimaProgramNode} */ (prog);
|
||||
|
||||
// @ts-expect-error TS bug? We've already converted to `EsprimaProgramNode`
|
||||
program.sourceType = extra.originalSourceType;
|
||||
|
||||
if (extra.comments) {
|
||||
program.comments = extra.comments;
|
||||
}
|
||||
if (extra.tokens) {
|
||||
program.tokens = extra.tokens;
|
||||
}
|
||||
|
||||
/*
|
||||
* https://github.com/eslint/espree/issues/349
|
||||
* Ensure that template elements have correct range information.
|
||||
* This is one location where Acorn produces a different value
|
||||
* for its start and end properties vs. the values present in the
|
||||
* range property. In order to avoid confusion, we set the start
|
||||
* and end properties to the values that are present in range.
|
||||
* This is done here, instead of in finishNode(), because Acorn
|
||||
* uses the values of start and end internally while parsing, making
|
||||
* it dangerous to change those values while parsing is ongoing.
|
||||
* By waiting until the end of parsing, we can safely change these
|
||||
* values without affect any other part of the process.
|
||||
*/
|
||||
this[STATE].templateElements.forEach(templateElement => {
|
||||
const startOffset = -1;
|
||||
const endOffset = templateElement.tail ? 1 : 2;
|
||||
|
||||
templateElement.start += startOffset;
|
||||
templateElement.end += endOffset;
|
||||
|
||||
if (templateElement.range) {
|
||||
templateElement.range[0] += startOffset;
|
||||
templateElement.range[1] += endOffset;
|
||||
}
|
||||
|
||||
if (templateElement.loc) {
|
||||
templateElement.loc.start.column += startOffset;
|
||||
templateElement.loc.end.column += endOffset;
|
||||
}
|
||||
});
|
||||
|
||||
return program;
|
||||
}
|
||||
|
||||
/**
|
||||
* Parses top level.
|
||||
* @param {acorn.Node} node AST Node
|
||||
* @returns {acorn.Node} The changed node
|
||||
*/
|
||||
parseTopLevel(node) {
|
||||
if (this[STATE].impliedStrict) {
|
||||
this.strict = true;
|
||||
}
|
||||
return super.parseTopLevel(node);
|
||||
}
|
||||
|
||||
/**
|
||||
* Overwrites the default raise method to throw Esprima-style errors.
|
||||
* @param {number} pos The position of the error.
|
||||
* @param {string} message The error message.
|
||||
* @throws {EnhancedSyntaxError} A syntax error.
|
||||
* @returns {void}
|
||||
*/
|
||||
raise(pos, message) {
|
||||
const loc = Parser.acorn.getLineInfo(this.input, pos);
|
||||
const err = /** @type {EnhancedSyntaxError} */ (
|
||||
new SyntaxError(message)
|
||||
);
|
||||
|
||||
err.index = pos;
|
||||
err.lineNumber = loc.line;
|
||||
err.column = loc.column + 1; // acorn uses 0-based columns
|
||||
throw err;
|
||||
}
|
||||
|
||||
/**
|
||||
* Overwrites the default raise method to throw Esprima-style errors.
|
||||
* @param {number} pos The position of the error.
|
||||
* @param {string} message The error message.
|
||||
* @throws {SyntaxError} A syntax error.
|
||||
* @returns {void}
|
||||
*/
|
||||
raiseRecoverable(pos, message) {
|
||||
this.raise(pos, message);
|
||||
}
|
||||
|
||||
/**
|
||||
* Overwrites the default unexpected method to throw Esprima-style errors.
|
||||
* @param {number} pos The position of the error.
|
||||
* @throws {SyntaxError} A syntax error.
|
||||
* @returns {void}
|
||||
*/
|
||||
unexpected(pos) {
|
||||
let message = "Unexpected token";
|
||||
|
||||
if (pos !== null && pos !== void 0) {
|
||||
this.pos = pos;
|
||||
|
||||
if (this.options.locations) {
|
||||
while (this.pos < this.lineStart) {
|
||||
this.lineStart =
|
||||
this.input.lastIndexOf(
|
||||
"\n",
|
||||
this.lineStart - 2,
|
||||
) + 1;
|
||||
--this.curLine;
|
||||
}
|
||||
}
|
||||
|
||||
this.nextToken();
|
||||
}
|
||||
|
||||
if (this.end > this.start) {
|
||||
message += ` ${this.input.slice(this.start, this.end)}`;
|
||||
}
|
||||
|
||||
this.raise(this.start, message);
|
||||
}
|
||||
|
||||
/**
|
||||
* Esprima-FB represents JSX strings as tokens called "JSXText", but Acorn-JSX
|
||||
* uses regular tt.string without any distinction between this and regular JS
|
||||
* strings. As such, we intercept an attempt to read a JSX string and set a flag
|
||||
* on extra so that when tokens are converted, the next token will be switched
|
||||
* to JSXText via onToken.
|
||||
* @param {number} quote A character code
|
||||
* @returns {void}
|
||||
*/ // eslint-disable-next-line camelcase -- required by API
|
||||
jsx_readString(quote) {
|
||||
const result = super.jsx_readString(quote);
|
||||
|
||||
if (this.type === tokTypes.string) {
|
||||
this[STATE].jsxAttrValueToken = true;
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* Performs last-minute Esprima-specific compatibility checks and fixes.
|
||||
* @param {acorn.Node} result The node to check.
|
||||
* @returns {EsprimaNode} The finished node.
|
||||
*/
|
||||
[ESPRIMA_FINISH_NODE](result) {
|
||||
// Acorn doesn't count the opening and closing backticks as part of templates
|
||||
// so we have to adjust ranges/locations appropriately.
|
||||
if (result.type === "TemplateElement") {
|
||||
// save template element references to fix start/end later
|
||||
this[STATE].templateElements.push(
|
||||
/** @type {acorn.TemplateElement} */
|
||||
(result),
|
||||
);
|
||||
}
|
||||
|
||||
if (
|
||||
result.type.includes("Function") &&
|
||||
!("generator" in result)
|
||||
) {
|
||||
/**
|
||||
* @type {acorn.FunctionDeclaration|acorn.FunctionExpression|
|
||||
* acorn.ArrowFunctionExpression}
|
||||
*/
|
||||
(result).generator = false;
|
||||
}
|
||||
|
||||
return result;
|
||||
}
|
||||
};
|
||||
};
|
||||
};
|
||||
+176
@@ -0,0 +1,176 @@
|
||||
/**
|
||||
* @fileoverview A collection of methods for processing Espree's options.
|
||||
* @author Kai Cataldo
|
||||
*/
|
||||
|
||||
/**
|
||||
* @import { EcmaVersion, Options } from "../espree.js";
|
||||
*/
|
||||
|
||||
//------------------------------------------------------------------------------
|
||||
// Helpers
|
||||
//------------------------------------------------------------------------------
|
||||
|
||||
const SUPPORTED_VERSIONS = /** @type {const} */ ([
|
||||
3,
|
||||
5,
|
||||
6, // 2015
|
||||
7, // 2016
|
||||
8, // 2017
|
||||
9, // 2018
|
||||
10, // 2019
|
||||
11, // 2020
|
||||
12, // 2021
|
||||
13, // 2022
|
||||
14, // 2023
|
||||
15, // 2024
|
||||
16, // 2025
|
||||
17, // 2026
|
||||
]);
|
||||
|
||||
/**
|
||||
* @typedef {typeof SUPPORTED_VERSIONS[number]} NormalizedEcmaVersion
|
||||
*/
|
||||
|
||||
const LATEST_ECMA_VERSION =
|
||||
/* eslint-disable jsdoc/valid-types -- Bug */
|
||||
/** @type {typeof SUPPORTED_VERSIONS extends readonly [...unknown[], infer L] ? L : never} */ (
|
||||
SUPPORTED_VERSIONS.at(-1)
|
||||
/* eslint-enable jsdoc/valid-types -- Bug */
|
||||
);
|
||||
|
||||
/**
|
||||
* Get the latest ECMAScript version supported by Espree.
|
||||
* @returns {typeof LATEST_ECMA_VERSION} The latest ECMAScript version.
|
||||
*/
|
||||
export function getLatestEcmaVersion() {
|
||||
return LATEST_ECMA_VERSION;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the list of ECMAScript versions supported by Espree.
|
||||
* @returns {[...typeof SUPPORTED_VERSIONS]} An array containing the supported ECMAScript versions.
|
||||
*/
|
||||
export function getSupportedEcmaVersions() {
|
||||
return [...SUPPORTED_VERSIONS];
|
||||
}
|
||||
|
||||
/**
|
||||
* Normalize ECMAScript version from the initial config
|
||||
* @param {EcmaVersion} ecmaVersion ECMAScript version from the initial config
|
||||
* @throws {Error} throws an error if the ecmaVersion is invalid.
|
||||
* @returns {NormalizedEcmaVersion} normalized ECMAScript version
|
||||
*/
|
||||
function normalizeEcmaVersion(ecmaVersion = 5) {
|
||||
let version =
|
||||
ecmaVersion === "latest" ? getLatestEcmaVersion() : ecmaVersion;
|
||||
|
||||
if (typeof version !== "number") {
|
||||
throw new Error(
|
||||
`ecmaVersion must be a number or "latest". Received value of type ${typeof ecmaVersion} instead.`,
|
||||
);
|
||||
}
|
||||
|
||||
// Calculate ECMAScript edition number from official year version starting with
|
||||
// ES2015, which corresponds with ES6 (or a difference of 2009).
|
||||
if (version >= 2015) {
|
||||
version -= 2009;
|
||||
}
|
||||
|
||||
if (
|
||||
!SUPPORTED_VERSIONS.includes(
|
||||
/** @type {NormalizedEcmaVersion} */
|
||||
(version),
|
||||
)
|
||||
) {
|
||||
throw new Error("Invalid ecmaVersion.");
|
||||
}
|
||||
|
||||
return /** @type {NormalizedEcmaVersion} */ (version);
|
||||
}
|
||||
|
||||
/**
|
||||
* Normalize sourceType from the initial config
|
||||
* @param {string} sourceType to normalize
|
||||
* @throws {Error} throw an error if sourceType is invalid
|
||||
* @returns {"script"|"module"|"commonjs"} normalized sourceType
|
||||
*/
|
||||
function normalizeSourceType(sourceType = "script") {
|
||||
if (
|
||||
sourceType === "script" ||
|
||||
sourceType === "module" ||
|
||||
sourceType === "commonjs"
|
||||
) {
|
||||
return sourceType;
|
||||
}
|
||||
|
||||
throw new Error("Invalid sourceType.");
|
||||
}
|
||||
|
||||
/**
|
||||
* @typedef {{
|
||||
* ecmaVersion: NormalizedEcmaVersion,
|
||||
* sourceType: "script"|"module"|"commonjs",
|
||||
* range?: boolean,
|
||||
* loc?: boolean,
|
||||
* allowReserved: boolean | "never",
|
||||
* ecmaFeatures?: {
|
||||
* jsx?: boolean,
|
||||
* globalReturn?: boolean,
|
||||
* impliedStrict?: boolean
|
||||
* },
|
||||
* ranges: boolean,
|
||||
* locations: boolean,
|
||||
* allowReturnOutsideFunction: boolean,
|
||||
* tokens?: boolean,
|
||||
* comment?: boolean
|
||||
* }} NormalizedParserOptions
|
||||
*/
|
||||
|
||||
/**
|
||||
* Normalize parserOptions
|
||||
* @param {Options} options the parser options to normalize
|
||||
* @throws {Error} throw an error if found invalid option.
|
||||
* @returns {NormalizedParserOptions} normalized options
|
||||
*/
|
||||
export function normalizeOptions(options) {
|
||||
const ecmaVersion = normalizeEcmaVersion(options.ecmaVersion);
|
||||
const sourceType = normalizeSourceType(options.sourceType);
|
||||
const ranges = options.range === true;
|
||||
const locations = options.loc === true;
|
||||
|
||||
if (ecmaVersion !== 3 && options.allowReserved) {
|
||||
// a value of `false` is intentionally allowed here, so a shared config can overwrite it when needed
|
||||
throw new Error(
|
||||
"`allowReserved` is only supported when ecmaVersion is 3",
|
||||
);
|
||||
}
|
||||
if (
|
||||
typeof options.allowReserved !== "undefined" &&
|
||||
typeof options.allowReserved !== "boolean"
|
||||
) {
|
||||
throw new Error(
|
||||
"`allowReserved`, when present, must be `true` or `false`",
|
||||
);
|
||||
}
|
||||
const allowReserved =
|
||||
ecmaVersion === 3 ? options.allowReserved || "never" : false;
|
||||
const ecmaFeatures = options.ecmaFeatures || {};
|
||||
const allowReturnOutsideFunction =
|
||||
options.sourceType === "commonjs" || Boolean(ecmaFeatures.globalReturn);
|
||||
|
||||
if (sourceType === "module" && ecmaVersion < 6) {
|
||||
throw new Error(
|
||||
"sourceType 'module' is not supported when ecmaVersion < 2015. Consider adding `{ ecmaVersion: 2015 }` to the parser options.",
|
||||
);
|
||||
}
|
||||
|
||||
return Object.assign({}, options, {
|
||||
ecmaVersion,
|
||||
sourceType,
|
||||
ranges,
|
||||
locations,
|
||||
allowReserved,
|
||||
allowReturnOutsideFunction,
|
||||
});
|
||||
}
|
||||
+306
@@ -0,0 +1,306 @@
|
||||
/**
|
||||
* @fileoverview Translates tokens between Acorn format and Esprima format.
|
||||
* @author Nicholas C. Zakas
|
||||
*/
|
||||
|
||||
/**
|
||||
* @import * as acorn from "acorn";
|
||||
* @import { EnhancedTokTypes } from "./espree.js"
|
||||
* @import { NormalizedEcmaVersion } from "./options.js";
|
||||
* @import { EspreeToken as EsprimaToken } from "../espree.js";
|
||||
*/
|
||||
/**
|
||||
* Based on the `acorn.Token` class, but without a fixed `type` (since we need
|
||||
* it to be a string). Avoiding `type` lets us make one extending interface
|
||||
* more strict and another more lax.
|
||||
*
|
||||
* We could make `value` more strict to `string` even though the original is
|
||||
* `any`.
|
||||
*
|
||||
* `start` and `end` are required in `acorn.Token`
|
||||
*
|
||||
* `loc` and `range` are from `acorn.Token`
|
||||
*
|
||||
* Adds `regex`.
|
||||
*/
|
||||
/**
|
||||
* @typedef {{
|
||||
* jsxAttrValueToken: boolean;
|
||||
* ecmaVersion: NormalizedEcmaVersion;
|
||||
* }} ExtraNoTokens
|
||||
* @typedef {{
|
||||
* tokens: EsprimaToken[]
|
||||
* } & ExtraNoTokens} Extra
|
||||
*/
|
||||
|
||||
//------------------------------------------------------------------------------
|
||||
// Private
|
||||
//------------------------------------------------------------------------------
|
||||
|
||||
// Esprima Token Types
|
||||
const Token = {
|
||||
Boolean: "Boolean",
|
||||
EOF: "<end>",
|
||||
Identifier: "Identifier",
|
||||
PrivateIdentifier: "PrivateIdentifier",
|
||||
Keyword: "Keyword",
|
||||
Null: "Null",
|
||||
Numeric: "Numeric",
|
||||
Punctuator: "Punctuator",
|
||||
String: "String",
|
||||
RegularExpression: "RegularExpression",
|
||||
Template: "Template",
|
||||
JSXIdentifier: "JSXIdentifier",
|
||||
JSXText: "JSXText",
|
||||
};
|
||||
|
||||
/**
|
||||
* Converts part of a template into an Esprima token.
|
||||
* @param {acorn.Token[]} tokens The Acorn tokens representing the template.
|
||||
* @param {string} code The source code.
|
||||
* @returns {EsprimaToken} The Esprima equivalent of the template token.
|
||||
* @private
|
||||
*/
|
||||
function convertTemplatePart(tokens, code) {
|
||||
const firstToken = tokens[0],
|
||||
lastTemplateToken =
|
||||
/** @type {acorn.Token & { loc: acorn.SourceLocation, range: [number, number] }} */ (
|
||||
tokens.at(-1)
|
||||
);
|
||||
|
||||
/** @type {EsprimaToken} */
|
||||
const token = {
|
||||
type: Token.Template,
|
||||
value: code.slice(firstToken.start, lastTemplateToken.end),
|
||||
};
|
||||
|
||||
if (firstToken.loc) {
|
||||
token.loc = {
|
||||
start: firstToken.loc.start,
|
||||
end: lastTemplateToken.loc.end,
|
||||
};
|
||||
}
|
||||
|
||||
if (firstToken.range) {
|
||||
token.start = firstToken.range[0];
|
||||
token.end = lastTemplateToken.range[1];
|
||||
token.range = [token.start, token.end];
|
||||
}
|
||||
|
||||
return token;
|
||||
}
|
||||
|
||||
/* eslint-disable jsdoc/check-types -- The API allows either */
|
||||
/**
|
||||
* Contains logic to translate Acorn tokens into Esprima tokens.
|
||||
*/
|
||||
class TokenTranslator {
|
||||
/**
|
||||
* Contains logic to translate Acorn tokens into Esprima tokens.
|
||||
* @param {EnhancedTokTypes} acornTokTypes The Acorn token types.
|
||||
* @param {string|String} code The source code Acorn is parsing. This is necessary
|
||||
* to correct the "value" property of some tokens.
|
||||
*/
|
||||
constructor(acornTokTypes, code) {
|
||||
/* eslint-enable jsdoc/check-types -- The API allows either */
|
||||
|
||||
// token types
|
||||
this._acornTokTypes = acornTokTypes;
|
||||
|
||||
// token buffer for templates
|
||||
/** @type {acorn.Token[]} */
|
||||
this._tokens = [];
|
||||
|
||||
// track the last curly brace
|
||||
this._curlyBrace = null;
|
||||
|
||||
// the source code
|
||||
this._code = code;
|
||||
}
|
||||
|
||||
/**
|
||||
* Translates a single Esprima token to a single Acorn token. This may be
|
||||
* inaccurate due to how templates are handled differently in Esprima and
|
||||
* Acorn, but should be accurate for all other tokens.
|
||||
* @param {acorn.Token} token The Acorn token to translate.
|
||||
* @param {ExtraNoTokens} extra Espree extra object.
|
||||
* @returns {EsprimaToken} The Esprima version of the token.
|
||||
*/
|
||||
translate(token, extra) {
|
||||
const type = token.type,
|
||||
tt = this._acornTokTypes,
|
||||
// We use an unknown type because `acorn.Token` is a class whose
|
||||
// `type` property we cannot override to our desired `string`;
|
||||
// this also allows us to define a stricter `EsprimaToken` with
|
||||
// a string-only `type` property
|
||||
unknownTokenType = /** @type {unknown} */ (token),
|
||||
newToken = /** @type {EsprimaToken} */ (unknownTokenType);
|
||||
|
||||
if (type === tt.name) {
|
||||
newToken.type = Token.Identifier;
|
||||
|
||||
// TODO: See if this is an Acorn bug
|
||||
if ("value" in token && token.value === "static") {
|
||||
newToken.type = Token.Keyword;
|
||||
}
|
||||
|
||||
if (
|
||||
extra.ecmaVersion > 5 &&
|
||||
"value" in token &&
|
||||
(token.value === "yield" || token.value === "let")
|
||||
) {
|
||||
newToken.type = Token.Keyword;
|
||||
}
|
||||
} else if (type === tt.privateId) {
|
||||
newToken.type = Token.PrivateIdentifier;
|
||||
} else if (
|
||||
type === tt.semi ||
|
||||
type === tt.comma ||
|
||||
type === tt.parenL ||
|
||||
type === tt.parenR ||
|
||||
type === tt.braceL ||
|
||||
type === tt.braceR ||
|
||||
type === tt.dot ||
|
||||
type === tt.bracketL ||
|
||||
type === tt.colon ||
|
||||
type === tt.question ||
|
||||
type === tt.bracketR ||
|
||||
type === tt.ellipsis ||
|
||||
type === tt.arrow ||
|
||||
type === tt.jsxTagStart ||
|
||||
type === tt.incDec ||
|
||||
type === tt.starstar ||
|
||||
type === tt.jsxTagEnd ||
|
||||
type === tt.prefix ||
|
||||
type === tt.questionDot ||
|
||||
("binop" in type && type.binop && !type.keyword) ||
|
||||
("isAssign" in type && type.isAssign)
|
||||
) {
|
||||
newToken.type = Token.Punctuator;
|
||||
newToken.value = this._code.slice(token.start, token.end);
|
||||
} else if (type === tt.jsxName) {
|
||||
newToken.type = Token.JSXIdentifier;
|
||||
} else if (type.label === "jsxText" || type === tt.jsxAttrValueToken) {
|
||||
newToken.type = Token.JSXText;
|
||||
} else if (type.keyword) {
|
||||
if (type.keyword === "true" || type.keyword === "false") {
|
||||
newToken.type = Token.Boolean;
|
||||
} else if (type.keyword === "null") {
|
||||
newToken.type = Token.Null;
|
||||
} else {
|
||||
newToken.type = Token.Keyword;
|
||||
}
|
||||
} else if (type === tt.num) {
|
||||
newToken.type = Token.Numeric;
|
||||
newToken.value = this._code.slice(token.start, token.end);
|
||||
} else if (type === tt.string) {
|
||||
if (extra.jsxAttrValueToken) {
|
||||
extra.jsxAttrValueToken = false;
|
||||
newToken.type = Token.JSXText;
|
||||
} else {
|
||||
newToken.type = Token.String;
|
||||
}
|
||||
|
||||
newToken.value = this._code.slice(token.start, token.end);
|
||||
} else if (type === tt.regexp) {
|
||||
newToken.type = Token.RegularExpression;
|
||||
const value = /** @type {{flags: string, pattern: string}} */ (
|
||||
"value" in token && token.value
|
||||
);
|
||||
|
||||
newToken.regex = {
|
||||
flags: value.flags,
|
||||
pattern: value.pattern,
|
||||
};
|
||||
newToken.value = `/${value.pattern}/${value.flags}`;
|
||||
}
|
||||
|
||||
return newToken;
|
||||
}
|
||||
|
||||
/**
|
||||
* Function to call during Acorn's onToken handler.
|
||||
* @param {acorn.Token} token The Acorn token.
|
||||
* @param {Extra} extra The Espree extra object.
|
||||
* @returns {void}
|
||||
*/
|
||||
onToken(token, extra) {
|
||||
const tt = this._acornTokTypes,
|
||||
tokens = extra.tokens,
|
||||
templateTokens = this._tokens;
|
||||
|
||||
/**
|
||||
* Flushes the buffered template tokens and resets the template
|
||||
* tracking.
|
||||
* @returns {void}
|
||||
* @private
|
||||
*/
|
||||
const translateTemplateTokens = () => {
|
||||
tokens.push(convertTemplatePart(this._tokens, this._code));
|
||||
this._tokens = [];
|
||||
};
|
||||
|
||||
if (token.type === tt.eof) {
|
||||
// might be one last curlyBrace
|
||||
if (this._curlyBrace) {
|
||||
tokens.push(this.translate(this._curlyBrace, extra));
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
if (token.type === tt.backQuote) {
|
||||
// if there's already a curly, it's not part of the template
|
||||
if (this._curlyBrace) {
|
||||
tokens.push(this.translate(this._curlyBrace, extra));
|
||||
this._curlyBrace = null;
|
||||
}
|
||||
|
||||
templateTokens.push(token);
|
||||
|
||||
// it's the end
|
||||
if (templateTokens.length > 1) {
|
||||
translateTemplateTokens();
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
if (token.type === tt.dollarBraceL) {
|
||||
templateTokens.push(token);
|
||||
translateTemplateTokens();
|
||||
return;
|
||||
}
|
||||
if (token.type === tt.braceR) {
|
||||
// if there's already a curly, it's not part of the template
|
||||
if (this._curlyBrace) {
|
||||
tokens.push(this.translate(this._curlyBrace, extra));
|
||||
}
|
||||
|
||||
// store new curly for later
|
||||
this._curlyBrace = token;
|
||||
return;
|
||||
}
|
||||
if (token.type === tt.template || token.type === tt.invalidTemplate) {
|
||||
if (this._curlyBrace) {
|
||||
templateTokens.push(this._curlyBrace);
|
||||
this._curlyBrace = null;
|
||||
}
|
||||
|
||||
templateTokens.push(token);
|
||||
return;
|
||||
}
|
||||
|
||||
if (this._curlyBrace) {
|
||||
tokens.push(this.translate(this._curlyBrace, extra));
|
||||
this._curlyBrace = null;
|
||||
}
|
||||
|
||||
tokens.push(this.translate(token, extra));
|
||||
}
|
||||
}
|
||||
|
||||
//------------------------------------------------------------------------------
|
||||
// Public
|
||||
//------------------------------------------------------------------------------
|
||||
|
||||
export default TokenTranslator;
|
||||
+118
@@ -0,0 +1,118 @@
|
||||
/**
|
||||
* @import * as acorn from "acorn";
|
||||
* @import { Options, EspreeTokens } from "../espree.js";
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {acorn.tokTypes & {
|
||||
* jsxName: acorn.TokenType,
|
||||
* jsxText: acorn.TokenType,
|
||||
* jsxTagEnd: acorn.TokenType,
|
||||
* jsxTagStart: acorn.TokenType
|
||||
* }} TokTypes
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {new (
|
||||
* token: string,
|
||||
* isExpr: boolean,
|
||||
* preserveSpace: boolean,
|
||||
* override?: (parser: any) => void
|
||||
* ) => void} TokContext
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {{
|
||||
* tc_oTag: TokContext,
|
||||
* tc_cTag: TokContext,
|
||||
* tc_expr: TokContext
|
||||
* }} TokContexts
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {{
|
||||
* generator?: boolean
|
||||
* } & acorn.Node} EsprimaNode
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {"Block"|"Hashbang"|"Line"} CommentType
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {{
|
||||
* tokenize: () => EspreeTokens,
|
||||
* parse: () => acorn.Program
|
||||
* }} EspreeParser
|
||||
*/
|
||||
|
||||
/* eslint-disable jsdoc/valid-types -- Waiting on jsdoc plugin update */
|
||||
/**
|
||||
* @typedef {acorn.Parser & {
|
||||
* jsx_readToken(): string;
|
||||
* jsx_readNewLine(normalizeCRLF: boolean): void;
|
||||
* jsx_readString(quote: number): void;
|
||||
* jsx_readEntity(): string;
|
||||
* jsx_readWord(): void;
|
||||
* jsx_parseIdentifier(): acorn.Node;
|
||||
* jsx_parseNamespacedName(): acorn.Node;
|
||||
* jsx_parseElementName(): acorn.Node | string;
|
||||
* jsx_parseAttributeValue(): acorn.Node;
|
||||
* jsx_parseEmptyExpression(): acorn.Node;
|
||||
* jsx_parseExpressionContainer(): acorn.Node;
|
||||
* jsx_parseAttribute(): acorn.Node;
|
||||
* jsx_parseOpeningElementAt(startPos: number, startLoc?: acorn.SourceLocation): acorn.Node;
|
||||
* jsx_parseClosingElementAt(startPos: number, startLoc?: acorn.SourceLocation): acorn.Node;
|
||||
* jsx_parseElementAt(startPos: number, startLoc?: acorn.SourceLocation): acorn.Node;
|
||||
* jsx_parseText(): acorn.Node;
|
||||
* jsx_parseElement(): acorn.Node;
|
||||
* }} AcornJsxParser
|
||||
*/
|
||||
|
||||
/**
|
||||
* We pick (statics) from acorn rather than plain extending to avoid complaint
|
||||
* about base constructors needing the same return type (i.e., we return
|
||||
* `AcornJsxParser` here)
|
||||
* @typedef {Pick<typeof acorn.Parser, keyof typeof acorn.Parser> & {
|
||||
* readonly acornJsx: {
|
||||
* tokTypes: TokTypes;
|
||||
* tokContexts: TokContexts
|
||||
* };
|
||||
* new (options: acorn.Options, input: string, startPos?: number): AcornJsxParser;
|
||||
* }} AcornJsxParserCtor
|
||||
*/
|
||||
/**
|
||||
* @typedef {{
|
||||
* new (opts: Options | null | undefined, code: string | object): EspreeParser
|
||||
* } & Pick<typeof acorn.Parser, keyof typeof acorn.Parser>} EspreeParserCtor
|
||||
*/
|
||||
/**
|
||||
* @typedef {{
|
||||
* new (opts: Options | null | undefined, code: string | object): EspreeParser
|
||||
* } & Pick<AcornJsxParserCtor, keyof AcornJsxParserCtor>} EspreeParserJsxCtor
|
||||
*/
|
||||
|
||||
/**
|
||||
* @typedef {Pick<AcornJsxParserCtor, keyof AcornJsxParserCtor> & {
|
||||
* acorn: {
|
||||
* tokTypes: TokTypes,
|
||||
* getLineInfo: (input: string, pos: number) => {
|
||||
* line: number,
|
||||
* column: number
|
||||
* }
|
||||
* }
|
||||
* new (options: acorn.Options, input: string, startPos?: number): AcornJsxParser & {
|
||||
* next: () => void,
|
||||
* type: acorn.TokenType,
|
||||
* curLine: number,
|
||||
* start: number,
|
||||
* end: number,
|
||||
* finishNode (node: acorn.Node, type: string): acorn.Node,
|
||||
* finishNodeAt (node: acorn.Node, type: string, pos: number, loc: acorn.Position): acorn.Node,
|
||||
* parseTopLevel (node: acorn.Node): acorn.Node,
|
||||
* nextToken (): void
|
||||
* }
|
||||
* }} AcornJsxParserCtorEnhanced
|
||||
*/
|
||||
|
||||
/* eslint-enable jsdoc/valid-types -- Bug in older versions */
|
||||
Generated
Vendored
Executable
+21
@@ -0,0 +1,21 @@
|
||||
#!/bin/sh
|
||||
basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
|
||||
|
||||
case `uname` in
|
||||
*CYGWIN*|*MINGW*|*MSYS*)
|
||||
if command -v cygpath > /dev/null 2>&1; then
|
||||
basedir=`cygpath -w "$basedir"`
|
||||
fi
|
||||
;;
|
||||
esac
|
||||
|
||||
if [ -z "$NODE_PATH" ]; then
|
||||
export NODE_PATH="/home/computer/projects/fitness-app/node_modules/.pnpm/acorn@8.16.0/node_modules/acorn/node_modules:/home/computer/projects/fitness-app/node_modules/.pnpm/acorn@8.16.0/node_modules:/home/computer/projects/fitness-app/node_modules/.pnpm/node_modules"
|
||||
else
|
||||
export NODE_PATH="/home/computer/projects/fitness-app/node_modules/.pnpm/acorn@8.16.0/node_modules/acorn/node_modules:/home/computer/projects/fitness-app/node_modules/.pnpm/acorn@8.16.0/node_modules:/home/computer/projects/fitness-app/node_modules/.pnpm/node_modules:$NODE_PATH"
|
||||
fi
|
||||
if [ -x "$basedir/node" ]; then
|
||||
exec "$basedir/node" "$basedir/../../../../../acorn@8.16.0/node_modules/acorn/bin/acorn" "$@"
|
||||
else
|
||||
exec node "$basedir/../../../../../acorn@8.16.0/node_modules/acorn/bin/acorn" "$@"
|
||||
fi
|
||||
+70
@@ -0,0 +1,70 @@
|
||||
{
|
||||
"name": "espree",
|
||||
"description": "An Esprima-compatible JavaScript parser built on Acorn",
|
||||
"author": "Nicholas C. Zakas <nicholas+npm@nczconsulting.com>",
|
||||
"homepage": "https://github.com/eslint/js/blob/main/packages/espree/README.md",
|
||||
"main": "dist/espree.cjs",
|
||||
"types": "./dist/espree.d.cts",
|
||||
"type": "module",
|
||||
"exports": {
|
||||
".": {
|
||||
"types": {
|
||||
"import": "./dist/espree.d.ts",
|
||||
"require": "./dist/espree.d.cts"
|
||||
},
|
||||
"import": "./espree.js",
|
||||
"require": "./dist/espree.cjs",
|
||||
"default": "./dist/espree.cjs"
|
||||
},
|
||||
"./package.json": "./package.json"
|
||||
},
|
||||
"version": "11.2.0",
|
||||
"files": [
|
||||
"lib",
|
||||
"dist",
|
||||
"espree.js"
|
||||
],
|
||||
"engines": {
|
||||
"node": "^20.19.0 || ^22.13.0 || >=24"
|
||||
},
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/eslint/js.git",
|
||||
"directory": "packages/espree"
|
||||
},
|
||||
"bugs": {
|
||||
"url": "https://github.com/eslint/js/issues"
|
||||
},
|
||||
"funding": "https://opencollective.com/eslint",
|
||||
"license": "BSD-2-Clause",
|
||||
"dependencies": {
|
||||
"acorn": "^8.16.0",
|
||||
"acorn-jsx": "^5.3.2",
|
||||
"eslint-visitor-keys": "^5.0.1"
|
||||
},
|
||||
"devDependencies": {
|
||||
"shelljs": "^0.8.5",
|
||||
"tsd": "^0.33.0"
|
||||
},
|
||||
"keywords": [
|
||||
"ast",
|
||||
"ecmascript",
|
||||
"javascript",
|
||||
"parser",
|
||||
"syntax",
|
||||
"acorn"
|
||||
],
|
||||
"scripts": {
|
||||
"build": "rollup -c rollup.config.js && npm run build:types && node -e \"fs.rmSync('dist/lib', { recursive: true })\"",
|
||||
"build:debug": "npm run build -- -m",
|
||||
"build:docs": "node tools/sync-docs.js",
|
||||
"build:types": "tsc && tsc -p tsconfig-cjs.json",
|
||||
"lint:types": "attw --pack",
|
||||
"pretest": "npm run build",
|
||||
"test": "npm run test:types && npm run test:cjs && npm run test:esm",
|
||||
"test:cjs": "mocha --color --reporter progress --timeout 30000 \"tests/**/*.test.cjs\"",
|
||||
"test:esm": "c8 mocha --color --reporter progress --timeout 30000 \"tests/**/*.test.js\"",
|
||||
"test:types": "tsd --typings dist/espree.d.ts"
|
||||
},
|
||||
"sideEffects": false
|
||||
}
|
||||
Reference in New Issue
Block a user