goldstein 4.5.0 → 4.6.0

package/ChangeLog

@@ -1,3 +1,8 @@
+2023.10.03, v4.6.0
+
+feature:
+- 04ca141 goldstein: export print, convert
+
 2023.10.03, v4.5.0
 
 feature:

package/README.md

@@ -143,7 +143,7 @@ function hello() {
 
 You can declare variables with [`@putout/operator-declare`](https://github.com/coderaiser/putout/tree/master/packages/operator-declare).
 
-### `parse(source)`
+### `parse(source, {type, keywords})`
 
 When you need to get **JavaScript** Babel AST use `parse`:
 
@@ -163,6 +163,46 @@ parse(`
 // returns Babel AST
 ```
 
+You can parse to **ESTree**:
+```
+const options = {
+    type: 'estree',
+};
+
+parse(`
+    fn hello() {
+        guard text !== "world" else {
+            return ""
+        }
+        
+        return "Hello " + text
+`, options);
+```
+
+### `print(ast)`
+
+You can make any modifications to **Goldstein AST** and then `print` back to **Goldstein**:
+
+```
+import {parse, print} from 'goldstein';
+
+const ast = parse(`const t = try f('hello')`);
+const source = print(ast);
+```
+
+### `convert(source)`
+
+You can even convert **JavaScript** to **Goldstein** with:
+
+```
+import {convert} from 'goldstein';
+
+const ast = convert(`const t = tryCatch(f, 'hello');`;
+
+// returns
+`const t = try f('hello')`)
+```
+
 ## Keywords
 
 **Goldstein** is absolutely compatible with JavaScript, and it has extensions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "goldstein",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "type": "module",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "JavaScript with no limits",

package/packages/goldstein/index.js

@@ -7,6 +7,7 @@ import {parse} from './parser.js';
 
 export * from './parser.js';
 export {print} from '../printer/index.js';
+export {convert} from '../convert/index.js';
 export const compile = (source, options = {}) => {
     const ast = parse(source, options);
     

package/packages/goldstein/parser.js

@@ -1,5 +1,4 @@
 import estreeToBabel from 'estree-to-babel';
-
 import {extendParser} from '../parser/index.js';
 import keywordFn from '../keyword-fn/index.js';
 import keywordGuard from '../keyword-guard/index.js';