flow-parser 0.319.0 → 0.321.0

package/README.md

@@ -1,6 +1,6 @@
 # The flow-parser package
 
-This package contains the Flow parser in its compiled-to-JavaScript form.
+This package contains the Flow parser in its JavaScript package form.
 
 # What is Flow
 
@@ -8,42 +8,30 @@ See [flow.org](https://flow.org/). The code for the Flow parser [lives on GitHub
 
 # What is the Flow Parser
 
-The Flow Parser is a JavaScript parser written in OCaml. It produces an AST that conforms to the [ESTree spec](https://github.com/estree/estree) and that mostly matches what [esprima](http://esprima.org/) produces. The Flow Parser can be compiled to native code or can be compiled to JavaScript using [js_of_ocaml](http://ocsigen.org/js_of_ocaml/). This npm package contains the Flow parser compiled to JavaScript.
+The Flow Parser is a JavaScript parser for Flow syntax. It produces an AST that conforms to the [ESTree spec](https://github.com/estree/estree). This npm package contains the Flow Rust parser compiled to WASM with JavaScript bindings.
 
 # Usage
 
-You can use the Flow parser in your browser or in node. To use in node you can just do
+You can use the Flow parser in node:
 
 ```JavaScript
-require('flow-parser').parse('1+1', {});
-```
-
-To use in the browser, you can add
-
-```HTML
-<script src="flow_parser.js"></script>
-```
-
-which will make the `flow` object available to use like so:
-
-```JavaScript
-flow.parse('1+1', {});
+const {parse} = require('flow-parser');
+parse('1+1', {});
 ```
 
 ## Options
 
-The second argument to `flow.parse` is the options object. Currently supported options:
+The second argument to `parse` is the options object. Common options:
 
 ### Basic options
-* `types` (boolean, default `true`) - enable parsing of Flow types
-* `use_strict` (boolean, default `false`) - treat the file as strict, without needing a "use strict" directive
-* `comments` (boolean, default `true`) - attach comments to AST nodes (`leadingComments` and `trailingComments`)
-* `all_comments` (boolean, default `true`) - include a list of all comments from the whole program
+* `flow` (`'detect'` or `'all'`, default `'detect'`) - parse Flow syntax only with an `@flow` pragma, or always parse Flow syntax
+* `sourceType` (`'module'`, `'script'`, or `'unambiguous'`) - parse the file as a module, script, or infer it from the contents
 * `tokens` (boolean, default `false`) - include a list of all parsed tokens in a top-level `tokens` property
+* `babel` (boolean, default `false`) - return a Babel-shaped AST
 
 ### Language features
-* `enums` (boolean, default `false`) - enable parsing of [enums](https://flow.org/en/docs/enums/)
-* `match` (boolean, default `false`) - enable parsing of [match expressions and match statements](https://flow.org/en/docs/match/)
-* `components` (boolean, default `false`) - enable parsing of [component syntax](https://flow.org/en/docs/react/component-syntax/)
-* `assert_operator` (boolean, default `false`) - enable parsing of the assert operator
-* `esproposal_decorators` (boolean, default `false`) - enable parsing of decorators
+* `enableEnums` (boolean, default `true`) - enable parsing of [enums](https://flow.org/en/docs/enums/)
+* `enableExperimentalFlowMatchSyntax` (boolean, default `true`) - enable parsing of [match expressions and match statements](https://flow.org/en/docs/match/)
+* `enableExperimentalComponentSyntax` (boolean, default `true`) - enable parsing of [component syntax](https://flow.org/en/docs/react/component-syntax/)
+* `assertOperator` (boolean, default `false`) - enable parsing of the assert operator
+* `enableExperimentalDecorators` (boolean, default `true`) - enable parsing of decorators

package/{oxidized → dist}/FlowParserNodeDeserializers.js

@@ -816,14 +816,16 @@ module.exports = [function () {
   return {
     type: 'DeclareVariable',
     loc: this.addEmptyLoc(),
-    id: this.deserializeNode(),
-    kind: this.deserializeString()
+    declarations: this.deserializeNodeList(),
+    kind: this.deserializeString(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {
     type: 'DeclareFunction',
     loc: this.addEmptyLoc(),
     id: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean(),
     predicate: this.deserializeNode()
   };
 }, function () {
@@ -835,7 +837,8 @@ module.exports = [function () {
     extends: this.deserializeNodeList(),
     implements: this.deserializeNodeList(),
     mixins: this.deserializeNodeList(),
-    body: this.deserializeNode()
+    body: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {
@@ -845,13 +848,15 @@ module.exports = [function () {
     params: this.deserializeNodeList(),
     rest: this.deserializeNode(),
     rendersType: this.deserializeNode(),
-    typeParameters: this.deserializeNode()
+    typeParameters: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {
     type: 'DeclareHook',
     loc: this.addEmptyLoc(),
-    id: this.deserializeNode()
+    id: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {
@@ -873,20 +878,25 @@ module.exports = [function () {
     default: this.deserializeBoolean(),
     declaration: this.deserializeNode(),
     specifiers: this.deserializeNodeList(),
-    source: this.deserializeNode()
+    source: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {
     type: 'DeclareExportAllDeclaration',
     loc: this.addEmptyLoc(),
-    source: this.deserializeNode()
+    source: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {
     type: 'DeclareNamespace',
     loc: this.addEmptyLoc(),
+    global: this.deserializeBoolean(),
     id: this.deserializeNode(),
-    body: this.deserializeNode()
+    body: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean(),
+    keyword: this.deserializeString()
   };
 }, function () {
   return {
@@ -895,7 +905,8 @@ module.exports = [function () {
     id: this.deserializeNode(),
     typeParameters: this.deserializeNode(),
     body: this.deserializeNode(),
-    extends: this.deserializeNodeList()
+    extends: this.deserializeNodeList(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {
@@ -903,14 +914,16 @@ module.exports = [function () {
     loc: this.addEmptyLoc(),
     id: this.deserializeNode(),
     typeParameters: this.deserializeNode(),
-    right: this.deserializeNode()
+    right: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {
     type: 'DeclareEnum',
     loc: this.addEmptyLoc(),
     id: this.deserializeNode(),
-    body: this.deserializeNode()
+    body: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {
@@ -1698,7 +1711,8 @@ module.exports = [function () {
     impltype: this.deserializeNode(),
     lowerBound: this.deserializeNode(),
     upperBound: this.deserializeNode(),
-    supertype: this.deserializeNode()
+    supertype: this.deserializeNode(),
+    implicitDeclare: this.deserializeBoolean()
   };
 }, function () {
   return {