goldstein 1.0.0 → 1.2.2

package/ChangeLog

@@ -0,0 +1,23 @@
+2022.06.22, v1.2.2
+
+fix:
+- goldstein: cli: add mainFields
+
+
+2022.06.22, v1.2.1
+
+fix:
+- package: repository url
+
+
+2022.06.22, v1.2.0
+
+feature:
+- goldstein: add CLI
+
+
+2022.06.21, v1.1.0
+
+feature:
+- goldstein: add keyword-safe
+

package/README.md

@@ -1,17 +1,45 @@
-# Goldstein
+# Goldstein [![License][LicenseIMGURL]][LicenseURL] [![NPM version][NPMIMGURL]][NPMURL] [![Build Status][BuildStatusIMGURL]][BuildStatusURL] [![Coverage Status][CoverageIMGURL]][CoverageURL]
+
+[NPMURL]: https://npmjs.org/package/goldstein "npm"
+[NPMIMGURL]: https://img.shields.io/npm/v/goldstein.svg?style=flat
+[BuildStatusURL]: https://github.com/coderaiser/goldstein/actions?query=workflow%3A%22Node+CI%22 "Build Status"
+[BuildStatusIMGURL]: https://github.com/coderaiser/goldstein/workflows/Node%20CI/badge.svg
+[LicenseURL]: https://tldrlegal.com/license/mit-license "MIT License"
+[LicenseIMGURL]: https://img.shields.io/badge/license-MIT-317BF9.svg?style=flat
+[CoverageURL]: https://coveralls.io/github/coderaiser/goldstein?branch=master
+[CoverageIMGURL]: https://coveralls.io/repos/coderaiser/goldstein/badge.svg?branch=master&service=github
+
+> *"You haven't a real appreciation of Newspeak, Winston," he said almost sadly. "Even when you write it you're still thinking in Oldspeak. I've read some of those pieces that you write in The Times occasionally. They're good enough, but they're translations. In your heart you'd prefer to stick to Oldspeak, with all its vagueness and its useless shades of meaning. You don't grasp the beauty of the destruction of words. Do you know that Newspeak is the only language in the world whose vocabulary gets smaller every year?"*
+>
+> *(c) “1984”, George Orwell*
 
 JavaScript with no limits.
 
-Language ruled by the users, create an issue with ideas of a new language construction and what is look like in JavaScript, and most likely we implement it :).
-
-> *"You haven't a real appreciation of Newspeak, Winston,' he said almost sadly. 'Even when you write it you're still thinking in Oldspeak. I've read some of those pieces that you write in The Times occasionally. They're good enough, but they're translations. In your heart you'd prefer to stick to Oldspeak, with all its vagueness and its useless shades of meaning. You don't grasp the beauty of the destruction of words. Do you know that Newspeak is the only language in the world whose vocabulary gets smaller every year?"*
-> 
-> *(c) “1984”, George Orwell*
+Language ruled by the users, [create an issue](https://github.com/coderaiser/goldstein/issues/new/choose) with ideas of a new language construction and what is look like in JavaScript, and most likely we implement it :).
 
 ## Install
 
 ```
-npm i goldstein
+npm i goldstein -g
+```
+
+## CLI
+
+```
+$ cat > 1.gs
+export fn hello() {
+    return 'world';
+}
+
+$ gs 1.gs
+$ cat 1.js
+// ~1.js
+function hello() {
+  return "world";
+}
+export {
+  hello
+};
 ```
 
 ## API
@@ -24,7 +52,7 @@ compile(`
         guard (text !== "world") else {
             return ""
         }
-
+        
         return "Hello " + text
     }
 `);
@@ -34,10 +62,10 @@ function hello() {
     if (!(text !== 'world')) {
         return '';
     }
-
+    
     return 'Hello ' + text;
 }
-`
+`;
 ```
 
 ## Keywords
@@ -84,11 +112,40 @@ function hello() {
     if (!(text !== 'world')) {
         return '';
     }
-
+    
     return 'Hello ' + text;
 }
 ```
 
+### `safe`
+
+Applies [`tryCatch`](https://github.com/coderaiser/try-catch):
+
+```gs
+safe hello(1, 2, 3);
+```
+
+Is the same as:
+
+```js
+import tryCatch from 'try-catch';
+tryCatch(1, 2, 3);
+```
+
+## How to contribute?
+
+Clone the registry, create a new keyword with a prefix `keyword-`, then create directory `fixture` and put there two files with extensions `.js` and `.gs`. Half way done 🥳!
+
+Then goes test and implementation in `index.js` and `index.spec.js` accordingly. Use scripts:
+
+- `npm test`
+- `UPDATE=1 npm test` - update `fixtures`;
+- `AST=1 npm test` - log `AST`;
+- `npm run coverage`;
+- `npm run fix:lint`;
+
+Update docs and make PR, that's it!
+
 ## License
 
-MIT
+MIT

package/bin/gs.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import esbuild from 'esbuild';
+import {
+    readFileSync,
+    writeFileSync,
+    unlinkSync,
+} from 'fs';
+import {compile} from '../packages/goldstein/index.js';
+
+const [arg] = process.argv.slice(2);
+
+if (!arg) {
+    console.log('gs <filename>');
+    process.exit();
+}
+
+const source = readFileSync(arg, 'utf8');
+const compiled = compile(source);
+const compiledName = `~${arg.replace(/\.gs$/, '.js')}`;
+
+writeFileSync(compiledName, compiled);
+
+const outfile = compiledName.replace('~', '');
+
+esbuild.buildSync({
+    entryPoints: [compiledName],
+    bundle: true,
+    write: true,
+    outfile,
+    mainFields: ['main'],
+});
+
+unlinkSync(compiledName);

package/package.json

@@ -1,14 +1,18 @@
 {
   "name": "goldstein",
-  "version": "1.0.0",
+  "version": "1.2.2",
   "type": "module",
+  "commitType": "colon",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "JavaScript with no limits",
   "main": "./packages/goldstein/index.js",
+  "bin": {
+    "gs": "bin/gs.js"
+  },
   "exports": "./packages/goldstein/index.js",
   "repository": {
     "type": "git",
-    "url": "git://github.com/coderaiser/mock-import.git"
+    "url": "git://github.com/coderaiser/goldstein.git"
   },
   "keywords": [
     "JavaScript",
@@ -23,6 +27,7 @@
   },
   "dependencies": {
     "acorn": "^8.7.1",
+    "esbuild": "^0.14.47",
     "putout": "^26.17.0"
   },
   "license": "MIT",
@@ -37,6 +42,7 @@
     "eslint-plugin-putout": "^15.1.1",
     "madrun": "^9.0.0",
     "mock-require": "^3.0.3",
+    "montag": "^1.2.1",
     "nodemon": "^2.0.2",
     "runsome": "^1.0.0",
     "supertape": "^7.0.0",

package/packages/goldstein/index.js

@@ -1,15 +1,26 @@
-import {print} from 'putout';
+import putout, {
+    print,
+} from 'putout';
+import {extendParser} from '../parser/index.js';
 import keywordFn from '../keyword-fn/index.js';
 import keywordGuard from '../keyword-guard/index.js';
-import {extendParser} from '../parser/index.js';
+import keywordSafe from '../keyword-safe/index.js';
 
 export const compile = (source) => {
     const {parse} = extendParser([
         keywordFn,
         keywordGuard,
+        keywordSafe,
     ]);
     
     const ast = parse(source);
     
-    return print(ast);
+    const jsCode = print(ast);
+    const {code} = putout(jsCode, {
+        plugins: [
+            'try-catch',
+        ],
+    });
+    
+    return code;
 };

package/packages/keyword-fn/index.js

@@ -21,6 +21,13 @@ export default function fn(Parser) {
             
             return super.parseStatement(context, topLevel, exports);
         }
+        shouldParseExportStatement() {
+            if (this.type === Parser.acorn.keywordTypes.fn) {
+                return true;
+            }
+            
+            return super.shouldParseExportStatement();
+        }
     };
 }
 

package/packages/keyword-safe/index.js

@@ -0,0 +1,51 @@
+import {
+    addKeyword,
+    TokenType,
+} from '../operator/index.js';
+
+// why not 'try'?
+// because acorn internals should be copied, and added tests.
+// there is no such thing as this.previous(), only this.next() 🤷‍
+
+export default function newSpeak(Parser) {
+    const {keywordTypes} = Parser.acorn;
+    keywordTypes.safe = new TokenType('safe', {
+        keyword: 'safe',
+    });
+    
+    return class extends Parser {
+        parse() {
+            this.keywords = addKeyword('safe', this.keywords);
+            
+            return super.parse();
+        }
+        parseStatement(context, topLevel, exports) {
+            if (this.type === keywordTypes.safe)
+                return this.parseSafe();
+            
+            return super.parseStatement(context, topLevel, exports);
+        }
+        
+        parseSafe() {
+            this.next();
+            
+            const node = super.startNode();
+            const callExpression = this.parseExpression();
+            
+            node.expression = {
+                type: 'CallExpression',
+                callee: {
+                    type: 'Identifier',
+                    name: 'tryCatch',
+                },
+                arguments: [
+                    callExpression.callee,
+                    ...callExpression.arguments,
+                ],
+            };
+            
+            return super.finishNode(node, 'ExpressionStatement');
+        }
+    };
+}
+

package/packages/parser/index.js

@@ -14,4 +14,5 @@ export const extendParser = (keywords) => {
 
 const createParse = (parser) => (a) => parser.parse(a, {
     ecmaVersion: 'latest',
+    sourceType: 'module',
 });