Brunobkr/llama.cpp_AlgMor24_github

1[![npm version](https://img.shields.io/npm/v/eslint-scope.svg)](https://www.npmjs.com/package/eslint-scope)2[![Downloads](https://img.shields.io/npm/dm/eslint-scope.svg)](https://www.npmjs.com/package/eslint-scope)3[![Build Status](https://github.com/eslint/js/workflows/CI/badge.svg)](https://github.com/eslint/js/actions)4 5# ESLint Scope6 7ESLint Scope is the [ECMAScript](http://www.ecma-international.org/publications/standards/Ecma-262.htm) scope analyzer used in ESLint. It is a fork of [escope](http://github.com/estools/escope).8 9## Install10 11```12npm i eslint-scope --save13```14 15## 📖 Usage16 17To use in an ESM file:18 19```js20import * as eslintScope from 'eslint-scope';21```22 23To use in a CommonJS file:24 25```js26const eslintScope = require('eslint-scope');27```28 29In order to analyze scope, you'll need to have an [ESTree](https://github.com/estree/estree) compliant AST structure to run it on. The primary method is `eslintScope.analyze()`, which takes two arguments:30 311. `ast` - the ESTree-compliant AST structure to analyze.322. `options` (optional) - Options to adjust how the scope is analyzed, including:33  * `ignoreEval` (default: `false`) - Set to `true` to ignore all `eval()` calls (which would normally create scopes).34  * `nodejsScope` (default: `false`) - Set to `true` to create a top-level function scope needed for CommonJS evaluation.35  * `impliedStrict` (default: `false`) - Set to `true` to evaluate the code in strict mode even outside of modules and without `"use strict"`.36  * `ecmaVersion` (default: `5`) - The version of ECMAScript to use to evaluate the code.37  * `sourceType` (default: `"script"`) - The type of JavaScript file to evaluate. Change to `"module"` for ECMAScript module code.38  * `childVisitorKeys` (default: `null`) - An object with visitor key information (like [`eslint-visitor-keys`](https://github.com/eslint/js/tree/main/packages/eslint-visitor-keys)). Without this, `eslint-scope` finds child nodes to visit algorithmically. Providing this option is a performance enhancement.39  * `fallback` (default: `"iteration"`) - The strategy to use when `childVisitorKeys` is not specified. May be a function.40  * `jsx` (default: `false`) - Enables the tracking of JSX components as variable references.41 42Example:43 44```js45import * as eslintScope from 'eslint-scope';46import * as espree from 'espree';47import estraverse from 'estraverse';48 49const options = {50    ecmaVersion: 2022,51    sourceType: "module"52};53 54const ast = espree.parse(code, { range: true, ...options });55const scopeManager = eslintScope.analyze(ast, options);56 57const currentScope = scopeManager.acquire(ast);   // global scope58 59estraverse.traverse(ast, {60    enter (node, parent) {61        // do stuff62 63        if (/Function/.test(node.type)) {64            currentScope = scopeManager.acquire(node);  // get current function scope65        }66    },67    leave(node, parent) {68        if (/Function/.test(node.type)) {69            currentScope = currentScope.upper;  // set to parent scope70        }71 72        // do stuff73    }74});75```76 77## API78 79The following section describes the API for this package. You can also read [the docs](https://eslint.org/docs/latest/extend/scope-manager-interface).80 81### ScopeManager82 83The `ScopeManager` class is at the core of eslint-scope and is returned when you call `eslintScope.analyze()`. It manages all scopes in a given AST.84 85#### Properties86 87- `scopes` - An array of all scopes.88- `globalScope` - Reference to the global scope.89 90#### Methods91 92- **`acquire(node, inner)`**93  Acquires the appropriate scope for a given node.94  - `node` - The AST node to acquire the scope from.95  - `inner` - Optional boolean. When `true`, returns the innermost scope, otherwise returns the outermost scope. Default is `false`.96  - Returns: The acquired scope or `null` if no scope is found.97 98- **`acquireAll(node)`**99  Acquires all scopes for a given node.100  - `node` - The AST node to acquire scopes from.101  - Returns: An array of scopes or `undefined` if none are found.102 103- **`release(node, inner)`**104  Returns the upper scope for a given node.105  - `node` - The AST node to release.106  - `inner` - Optional boolean. When `true`, returns the innermost upper scope, otherwise returns the outermost upper scope. Default is `false`.107  - Returns: The upper scope or `null` if no upper scope exists.108 109- **`getDeclaredVariables(node)`**110  Get variables that are declared by the node.111  - `node` - The AST node to get declarations from.112  - Returns: An array of variable objects declared by the node. If the node doesn't declare any variables, it returns an empty array.113 114- **`isGlobalReturn()`**115  Determines if the global return statement should be allowed.116  - Returns: `true` if the global return is enabled.117 118- **`isModule()`**119  Checks if the code should be handled as an ECMAScript module.120  - Returns: `true` if the sourceType is "module".121 122- **`isImpliedStrict()`**123  Checks if implied strict mode is enabled.124  - Returns: `true` if implied strict mode is enabled.125 126- **`isStrictModeSupported()`**127  Checks if strict mode is supported based on ECMAScript version.128  - Returns: `true` if the ECMAScript version supports strict mode.129 130### Scope Objects131 132Scopes returned by the ScopeManager methods have the following properties:133 134- `type` - The type of scope (e.g., "function", "block", "global").135- `variables` - Array of variables declared in this scope.136- `set` - A Map of variable names to Variable objects for variables declared in this scope.137- `references` - Array of references in this scope.138- `through` - Array of references in this scope and its child scopes that aren't resolved in this scope or its child scopes.139- `variableScope` - Reference to the closest variable scope.140- `upper` - Reference to the parent scope.141- `childScopes` - Array of child scopes.142- `block` - The AST node that created this scope.143 144### GlobalScope145 146The `GlobalScope` class is a specialized scope representing the global execution context. It extends the base `Scope` class with additional functionality for handling implicitly defined global variables.147 148#### Properties149 150- **`implicit`** - Tracks implicitly defined global variables (those used without declaration).151  - `set` - A Map of variable names to Variable objects for implicitly defined globals.152  - `variables` - Array of implicit global Variable objects.153  - `left` - Array of References that need to be linked to the variable they refer to.154 155### Variable Objects156 157Each variable object has the following properties:158 159- `name` - The variable name.160- `identifiers` - Array of identifier nodes declaring this variable.161- `references` - Array of references to this variable.162- `defs` - Array of definition objects for this variable.163- `scope` - The scope object where this variable is defined.164 165## Contributing166 167Issues 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).168 169## Security Policy170 171We work hard to ensure that ESLint Scope 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).172 173## Build Commands174 175* `npm test` - run all linting and tests176* `npm run lint` - run all linting177 178## License179 180ESLint Scope is licensed under a permissive BSD 2-clause license.181 182<!-- NOTE: This section is autogenerated. Do not manually edit.-->183<!--sponsorsstart-->184## Sponsors185 186The following companies, organizations, and individuals support ESLint's ongoing maintenance and development. [Become a Sponsor](https://eslint.org/donate)187to get your logo on our READMEs and [website](https://eslint.org/sponsors).188 189<h3>Diamond Sponsors</h3>190<p><a href="https://www.ag-grid.com/"><img src="https://images.opencollective.com/ag-grid/bec0580/logo.png" alt="AG Grid" height="128"></a></p><h3>Platinum Sponsors</h3>191<p><a href="https://automattic.com"><img src="https://images.opencollective.com/automattic/d0ef3e1/logo.png" alt="Automattic" height="128"></a> <a href="https://www.airbnb.com/"><img src="https://images.opencollective.com/airbnb/d327d66/logo.png" alt="Airbnb" height="128"></a></p><h3>Gold Sponsors</h3>192<p><a href="https://qlty.sh/"><img src="https://images.opencollective.com/qltysh/33d157d/logo.png" alt="Qlty Software" height="96"></a> <a href="https://trunk.io/"><img src="https://images.opencollective.com/trunkio/fb92d60/avatar.png" alt="trunk.io" height="96"></a> <a href="https://shopify.engineering/"><img src="https://avatars.githubusercontent.com/u/8085" alt="Shopify" height="96"></a></p><h3>Silver Sponsors</h3>193<p><a href="https://vite.dev/"><img src="https://images.opencollective.com/vite/e6d15e1/logo.png" alt="Vite" height="64"></a> <a href="https://liftoff.io/"><img src="https://images.opencollective.com/liftoff/5c4fa84/logo.png" alt="Liftoff" height="64"></a> <a href="https://americanexpress.io"><img src="https://avatars.githubusercontent.com/u/3853301" alt="American Express" 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>194<p><a href="https://sentry.io"><img src="https://github.com/getsentry.png" alt="Sentry" height="32"></a> <a href="https://syntax.fm"><img src="https://github.com/syntaxfm.png" alt="Syntax" height="32"></a> <a href="https://cybozu.co.jp/"><img src="https://images.opencollective.com/cybozu/933e46d/logo.png" alt="Cybozu" height="32"></a> <a href="https://www.crosswordsolver.org/anagram-solver/"><img src="https://images.opencollective.com/anagram-solver/2666271/logo.png" alt="Anagram Solver" 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://nolebase.ayaka.io"><img src="https://avatars.githubusercontent.com/u/11081491" alt="Neko" height="32"></a> <a href="https://nx.dev"><img src="https://avatars.githubusercontent.com/u/23692104" alt="Nx" height="32"></a> <a href="https://opensource.mercedes-benz.com/"><img src="https://avatars.githubusercontent.com/u/34240465" alt="Mercedes-Benz Group" 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="LambdaTest" height="32"></a></p>195<h3>Technology Sponsors</h3>196Technology sponsors allow us to use their products and services for free as part of a contribution to the open source ecosystem and our work.197<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>198<!--sponsorsend-->199