Support Node.js/RequireJS/TypeScript

.gitignore

@@ -1,2 +1,3 @@
 
 *.komodoproject
+node_modules/

README.md

@@ -1,11 +1,81 @@
 JS-Interpreter
 ==============
 
-A sandboxed JavaScript interpreter in JavaScript.  Execute arbitrary JavaScript
-code line by line in isolation and safety.
+A sandboxed JavaScript interpreter written in TypeScript, packed with `Webpack` or `tsc` for use with Node.js or within a browser (either loaded [statically](https://junkato.jp/JS-Interpreter/) or [dynamically](https://junkato.jp/JS-Interpreter/?required)). Execute arbitrary JavaScript code line by line in isolation and safety.
+
+This interpreter is a TypeScript port of [the original JavaScript version](https://github.com/NeilFraser/JS-Interpreter).
+
+There are several library files that serve different use cases. See below for more concrete instructions.
+
+- `dist/interpreter.js` ... packed with `tsc` (`npm run build`) and can be loaded from Node.js or a browser with RequireJS. `acorn` needs to be loaded separately.
+- `dist/interpreter.d.ts` ... TypeScript type definition
+- `dist/acorn_interpreter.js` ... packed with `Webpack` (`npm run build-with-acorn`) as a library and  can be loaded with a `<script>` tag from a browser. `acorn` is bundled.
+- `dist/interpreter.global.js` ... packed with `Webpack` (`npm run build-global`) as a library and can be loaded with a `<script>` tag from a browser. `acorn` needs to be loaded separately.
 
 Live demo:
-https://neil.fraser.name/software/JS-Interpreter/
+[https://junkato.jp/JS-Interpreter](https://junkato.jp/JS-Interpreter)
+
+More demos:
+[https://junkato.jp/JS-Interpreter/demos](https://junkato.jp/JS-Interpreter/demos)
 
 Documentation:
-https://neil.fraser.name/software/JS-Interpreter/docs.html
+This `README` file ... or the original documentation at 
+[https://neil.fraser.name/software/JS-Interpreter/docs.html](https://neil.fraser.name/software/JS-Interpreter/docs.html)
+
+## Node.js Basic Usage
+
+`npm install` to install the latest code.
+
+```sh
+npm install acorn https://github.com/arcatdmz/JS-Interpreter --save
+npm install @types/acorn --save-dev
+```
+
+Write typed code with perfect auto completion!
+
+```typescript
+import acorn = require('acorn');
+import Interpreter = require('JS-Interpreter');
+Interpreter.acorn = acorn;
+
+// Test the interpreter.
+var interpreter = new Interpreter("var a = 1, b = 2; a + b;");
+interpreter.run();
+console.log('1 + 2 = ' + interpreter.value);
+// shows '1 + 2 = 3' in the console
+```
+
+## Browser Basic Usage
+
+Load `dist/acorn_interpreter.js` statically and use the globally-declared `Interpreter` class.
+
+```html
+<script src="https://cdn.rawgit.com/arcatdmz/JS-Interpreter/39cbd828/dist/acorn_interpreter.js"></script>
+<script>
+var interpreter = new Interpreter("var a = 1, b = 2; a + b;");
+interpreter.run();
+alert('1 + 2 = ' + interpreter.value);
+// shows an alert '1 + 2 = 3'
+</script>
+```
+
+## Dynamic loading with RequireJS
+
+Load `dist/acorn.js` and `dist/interpreter.js` dynamically with [RequireJS](//requirejs.org) and use the `Interpreter` class.
+No global scope pollution!
+
+```html
+<script src="https://cdn.rawgit.com/arcatdmz/JS-Interpreter/39cbd828/lib/require.js"></script>
+<script>
+requirejs(['https://cdn.rawgit.com/arcatdmz/JS-Interpreter/39cbd828/lib/acorn.js', 'https://cdn.rawgit.com/arcatdmz/JS-Interpreter/39cbd828/dist/interpreter.js'], function (acorn, Interpreter) {
+  Interpreter.acorn = acorn; // Manually pass acorn runtime to the Interpreter
+  var interpreter = new Interpreter("var a = 1, b = 2; a + b;");
+  interpreter.run();
+  alert('1 + 2 = ' + interpreter.value);
+  // shows an alert '1 + 2 = 3'
+});
+</script>
+```
+
+--------------
+(c) 2013-2017 Google Inc. and [Jun Kato](https://junkato.jp)

demos/async.html

@@ -4,8 +4,8 @@
   <meta charset="utf-8">
   <title>JS-Interpreter Async Demo</title>
   <link href="style.css" rel="stylesheet" type="text/css">
-  <script src="../acorn.js"></script>
-  <script src="../interpreter.js"></script>
+  <script src="../lib/acorn.js"></script>
+  <script src="../dist/interpreter.global.js"></script>
   <script>
     var myInterpreter;
     function initAlert(interpreter, scope) {

demos/browser/index.html

@@ -0,0 +1,14 @@
+<!DOCTYPE html><html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>JS-Interpreter TypeScript demo page</title>
+    <link rev="made" href="mailto:i@junkato.jp" />
+    <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Droid+Sans" />
+    <link href="//junkato.jp/css/bootstrap.min.css" rel="stylesheet">
+    <link href="//junkato.jp/css/main.css" rel="stylesheet">
+  </head>
+  <body>
+    <script>var require = { paths: { "acorn": "../../lib/acorn" } };</script>
+    <script src="../../lib/require.js" data-main="index.js"></script>
+  </body>
+</html>

demos/browser/index.js

@@ -0,0 +1,9 @@
+define(["require", "exports", "acorn", "../../dist/interpreter"], function (require, exports, acorn, Interpreter) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    Interpreter.acorn = acorn;
+    // Test the interpreter.
+    var interpreter = new Interpreter("var a = 1, b = 2; a + b;");
+    interpreter.run();
+    alert('1 + 2 = ' + interpreter.value); // shows an alert '1 + 2 = 3'
+});

demos/browser/index.ts

@@ -0,0 +1,9 @@
+
+import acorn = require('acorn');
+import Interpreter = require('../../dist/interpreter');
+Interpreter.acorn = acorn;
+
+// Test the interpreter.
+var interpreter = new Interpreter("var a = 1, b = 2; a + b;");
+interpreter.run();
+alert('1 + 2 = ' + interpreter.value); // shows an alert '1 + 2 = 3'

demos/json.html

@@ -4,8 +4,8 @@
   <meta charset="utf-8">
   <title>JS-Interpreter JSON Demo</title>
   <link href="style.css" rel="stylesheet" type="text/css">
-  <script src="../acorn.js"></script>
-  <script src="../interpreter.js"></script>
+  <script src="../lib/acorn.js"></script>
+  <script src="../dist/interpreter.js"></script>
   <script>
     var myInterpreter;
     function initAlert(interpreter, scope) {

demos/nodejs/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var acorn = require("acorn");
+var Interpreter = require("JS-Interpreter");
+Interpreter.acorn = acorn;
+// Test the interpreter.
+var interpreter = new Interpreter("var a = 1, b = 2; a + b;");
+interpreter.run();
+console.log('1 + 2 = ' + interpreter.value); // shows '1 + 2 = 3' in the console

demos/nodejs/index.ts

@@ -0,0 +1,9 @@
+
+import acorn = require('acorn');
+import Interpreter = require('JS-Interpreter');
+Interpreter.acorn = acorn;
+
+// Test the interpreter.
+var interpreter = new Interpreter("var a = 1, b = 2; a + b;");
+interpreter.run();
+console.log('1 + 2 = ' + interpreter.value); // shows '1 + 2 = 3' in the console

demos/nodejs/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "js-interpreter-demo-nodejs",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc index.ts --typeRoots ./node_modules/@types"
+  },
+  "author": "Jun Kato <i@junkato.jp> (https://junkato.jp)",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/acorn": "^4.0.2",
+    "@types/node": "^8.0.20"
+  },
+  "dependencies": {
+    "acorn": "^0.4.2",
+    "JS-Interpreter": "git+https://github.com/arcatdmz/JS-Interpreter.git"
+  }
+}

demos/serialize.html

@@ -4,8 +4,8 @@
   <meta charset="utf-8">
   <title>JS-Interpreter Serialization Demo</title>
   <link href="style.css" rel="stylesheet" type="text/css">
-  <script src="../acorn.js"></script>
-  <script src="../interpreter.js"></script>
+  <script src="../lib/acorn.js"></script>
+  <script src="../dist/interpreter.global.js"></script>
   <script src="serialize.js"></script>
   <script>
     var myInterpreter;

demos/thread.html

@@ -4,8 +4,8 @@
   <meta charset="utf-8">
   <title>JS-Interpreter Thread Demo</title>
   <link href="style.css" rel="stylesheet" type="text/css">
-  <script src="../acorn.js"></script>
-  <script src="../interpreter.js"></script>
+  <script src="../lib/acorn.js"></script>
+  <script src="../dist/interpreter.js"></script>
   <script>
     function initAlert(interpreter, scope) {
       var wrapper = function(text) {