sval 0.6.9 → 0.6.10

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git pull:*)",
+      "Bash(npm run:*)",
+      "Bash(npm publish:*)",
+      "Bash(npm whoami:*)"
+    ]
+  }
+}

package/README.md

@@ -1,11 +1,11 @@
 # Sval · [![npm](https://img.shields.io/npm/v/sval.svg?style=flat-square)](https://www.npmjs.com/package/sval) [![coveralls](https://img.shields.io/coveralls/github/Siubaak/sval.svg?style=flat-square)](https://coveralls.io/github/Siubaak/sval) [![gh-actions](https://img.shields.io/github/actions/workflow/status/Siubaak/sval/coverage.yml?style=flat-square)](https://github.com/Siubaak/sval/actions/workflows/coverage.yml) [![prs-welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://makeapullrequest.com)
 
-A JavaScript interpreter writen in JavaScript, based on parser [Acorn](https://github.com/acornjs/acorn).
+A JavaScript interpreter written in JavaScript, based on the [Acorn](https://github.com/acornjs/acorn) parser.
 
-- **Running on ES5, supporting ES latest features**
-- **Both invasived and sandbox modes available**
+- **Runs on ES5, supporting the latest ES features**
+- **Both invasive and sandbox modes are available**
 
-It's useful to evaluate the code of higher ECMAScript editions, or for the environment with disabled `eval`, `setTimeout` and `new Function`.
+It is useful for evaluating code targeting higher ECMAScript editions, or for environments where `eval`, `setTimeout`, and `new Function` are disabled.
 
 [Try Sval on the playground.](https://jsbin.com/kehahiqono/edit?js,console)
 
@@ -21,7 +21,7 @@ npm install sval
 
 ### Browser
 
-Simply source from [unpkg](https://unpkg.com/sval). Or, download from [releases](https://github.com/Siubaak/sval/releases), get minimized file `dist/min/sval.min.js`, and source at your html page. You can access a global variable **Sval** directly.
+Simply include it from [unpkg](https://unpkg.com/sval). Alternatively, download from [releases](https://github.com/Siubaak/sval/releases), get the minified file `dist/min/sval.min.js`, and include it in your HTML page. The global variable **Sval** will then be accessible directly.
 
 ```html
 <script type="text/javascript" src="https://unpkg.com/sval"></script>
@@ -32,7 +32,7 @@ Simply source from [unpkg](https://unpkg.com/sval). Or, download from [releases]
 ```js
 import Sval from 'sval'
 
-// Create a interpreter
+// Create an interpreter
 const interpreter = new Sval({
   // ECMA Version of the code
   // 3 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15
@@ -54,42 +54,42 @@ interpreter.run(`
 
 ## Usage
 
-Sval constructor has three options: **ecmaVer**, **sourceType** and **sandBox**.
+The Sval constructor accepts three options: **ecmaVer**, **sourceType**, and **sandBox**.
 
-- **ecmaVer** is the ECMAScript edition of the code. Currently, 3, 5, 6(2015), 7(2016), 8(2017), 9(2018), 10(2019), 11(2020), 12(2021), 13(2022), 14(2023), 15(2024) and "latest" are supported, and the default edition is "latest".
+- **ecmaVer** specifies the ECMAScript edition of the code. Currently, 3, 5, 6(2015), 7(2016), 8(2017), 9(2018), 10(2019), 11(2020), 12(2021), 13(2022), 14(2023), 15(2024), and "latest" are supported, and the default value is "latest".
 
-- **sourceType** is ethier "script" or "module", which is to declare how Sval handle the code. The "script" means the code will be treated as a normal script, while the "module" means the code will be treated as an ES module with global strict mode and parsing of import and export declarations. The default type is "script".
+- **sourceType** is either "script" or "module", which declares how Sval handles the code. A value of "script" means the code will be treated as a normal script, while "module" means the code will be treated as an ES module with global strict mode and support for import and export declarations. The default type is "script".
 
-- **sandBox** is true for sandbox mode or false for invasived mode. Sandbox mode will run code in an isolated sandbox and won't pollute your global scope. Invasived mode allows you run code in the same global scope of your current environment. The default setting is true.
+- **sandBox** is true for sandbox mode or false for invasive mode. Sandbox mode runs the code in an isolated environment and will not pollute your global scope. Invasive mode allows you to run code in the same global scope as your current environment. The default setting is true.
 
-Sval instance has two main methods: **parse** and **run**.
+A Sval instance has two main methods: **parse** and **run**.
 
-- **parse** is to parse the code with internal [Acorn](https://github.com/acornjs/acorn) or custom parser, to get the corresponding AST, like `parse(code: string)` or `parse(code: string, parser: (code: string, options: SvalOptions) => estree.Node`.
+- **parse** parses the code with the internal [Acorn](https://github.com/acornjs/acorn) or a custom parser to get the corresponding AST, as in `parse(code: string)` or `parse(code: string, parser: (code: string, options: SvalOptions) => estree.Node)`.
 
-- **run** is to evaluate the code inputed, expecting a string as argument like `run(code: string)`, or an AST followed ESTree Spec as argument like `run(ast: estree.Node)`.
+- **run** evaluates the provided code, accepting either a string like `run(code: string)` or an AST conforming to the ESTree spec like `run(ast: estree.Node)`.
 
-Besides, Sval instance also has one method, **import**, and one object, **exports**, for modularization.
+In addition, a Sval instance has one method, **import**, and one object, **exports**, for modularization.
 
-- **import** is to import modules into your Sval instance scope. This method has different behaviors for different `sourceType`.
+- **import** is used to import modules into the Sval instance scope. This method behaves differently depending on the `sourceType`.
 
-  For "script", this method expecting a name and a module as arguments like `import(name: string, mod: any)`, or an object which contains the modules as argument like `import({ [name: string]: any })`. The modules will be automatically declared as global variables in Sval instance scope. This method is more likely to be used in sandbox mode.
+  For "script", this method expects a name and a module as arguments like `import(name: string, mod: any)`, or an object containing the modules like `import({ [name: string]: any })`. The modules will be automatically declared as global variables in the Sval instance scope. This method is most commonly used in sandbox mode.
 
-  For "module", this method expecting a path and a module declaration as arguments like `import(path: string, mod: Module)`, or an object which contains the module declarations as argument like `import({ [path: string]: Module })`. The `Module` is either an ES module exported object like `{ default?: any, [name: string]: any }` or a function returning an ES module exported object like `() => ({ default?: any, [name: string]: any })`. The `Module` can also be a promise or a function returning a promise if importing a module by dynamic import. The modules will not be automatically declared as global variables in Sval instance scope, and the code should use import declarations to import the module.
+  For "module", this method expects a path and a module declaration as arguments like `import(path: string, mod: Module)`, or an object containing the module declarations like `import({ [path: string]: Module })`. The `Module` is either an ES module export object like `{ default?: any, [name: string]: any }` or a function returning one like `() => ({ default?: any, [name: string]: any })`. The `Module` can also be a promise or a function returning a promise for use with dynamic imports. The modules will not be automatically declared as global variables in the Sval instance scope, and the code should use import declarations to import them.
 
-- **exports** is to get what you exported from runs, merged if several runs have exports. Also, this object has different behaviors for different `sourceType`.
+- **exports** holds what was exported from runs, merged across multiple runs if applicable. This object also behaves differently depending on the `sourceType`.
 
-  For "script", this object will be automatically declared as global variables in Sval instance scope, and the code can just simple mount properties on it for export.
+  For "script", this object is automatically declared as a global variable in the Sval instance scope, and the code can simply mount properties on it to export values.
 
-  For "module", this object will not be automatically declared as global variables in Sval instance scope, and the code needs to use export declarations for export.
+  For "module", this object is not automatically declared as a global variable in the Sval instance scope, and the code must use export declarations to export values.
 
-Here are examples for **import** and **exports** below:
+Here are examples for **import** and **exports**:
 
 Example for "script":
 
 ```js
 import Sval from 'sval'
 
-// Create a interpreter for script
+// Create an interpreter for script
 const scriptInterpreter = new Sval({ sourceType: 'script' })
 
 // Add global modules in interpreter
@@ -110,7 +110,7 @@ Example for "module":
 ```js
 import Sval from 'sval'
 
-// Create a interpreter for module
+// Create an interpreter for module
 const moduleInterpreter = new Sval({ sourceType: 'module' })
 
 // Add ES modules in interpreter
@@ -141,7 +141,7 @@ console.log(moduleInterpreter.exports.mod) // Get 'AllKindsOfStuffs'
 
 ## Related
 
-- [sval-rhino-gs](https://github.com/Patrick-ring-motive/sval-rhino-gs) 
+- [sval-rhino-gs](https://github.com/Patrick-ring-motive/sval-rhino-gs)
 
 ## License
 

package/dist/src/share/const.d.ts

@@ -21,3 +21,4 @@ export declare const DEADZONE: string;
 export declare const OPTCHAIN: string;
 export declare const IMPORT: string;
 export declare const EXPORTS: string;
+export declare const STRICT: string;