hermes-estree 0.36.1 → 0.37.0

package/dist/generated/predicates.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict-local
  * @generated
  */
 
@@ -17,7 +17,7 @@
 
 /* eslint no-undef: 'error', no-unused-vars: ['error', {vars: "local"}], no-redeclare: 'error' */
 
-/* global $NonMaybeType, Partial, $ReadOnly, $ReadOnlyArray, $FlowFixMe */
+/* global NonNullable, Partial, Readonly, ReadonlyArray, $FlowFixMe */
 'use strict';
 /*::
 import type {

package/dist/generated/predicates.js.flow

@@ -16,7 +16,7 @@
 
 // lint directives to let us do some basic validation of generated files
 /* eslint no-undef: 'error', no-unused-vars: ['error', {vars: "local"}], no-redeclare: 'error' */
-/* global $NonMaybeType, Partial, $ReadOnly, $ReadOnlyArray, $FlowFixMe */
+/* global NonNullable, Partial, Readonly, ReadonlyArray, $FlowFixMe */
 
 'use strict';
 

package/dist/index.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/predicates.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict-local
  */
 'use strict';
 /*::

package/dist/selectors.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/selectors.js.flow

@@ -20,7 +20,7 @@ export type ESQueryNodeSelectors = {
   // 'FunctionDeclaration[id="foo"]'(node: FunctionDeclaration) {...}
   // But this sucks as it means someone would then have to manually do an \`if\`
   // check inside the selector body.
-  +[selector: string]: (node: $FlowFixMe) => void,
+  readonly [selector: string]: (node: $FlowFixMe) => void,
 };
 
 export type {ESQueryNodeSelectorsWithoutFallback} from './generated/HermesESTreeSelectorTypes';

package/dist/src/generated/predicates.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict-local
  * @generated
  */
 
@@ -17,7 +17,7 @@
 
 /* eslint no-undef: 'error', no-unused-vars: ['error', {vars: "local"}], no-redeclare: 'error' */
 
-/* global $NonMaybeType, Partial, $ReadOnly, $ReadOnlyArray, $FlowFixMe */
+/* global NonNullable, Partial, Readonly, ReadonlyArray, $FlowFixMe */
 'use strict';
 /*::
 import type {

package/dist/src/index.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/predicates.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict-local
  */
 'use strict';
 /*::

package/dist/src/selectors.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';

package/dist/src/types.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -12,7 +12,7 @@
  *
  * IMPORTANT NOTE
  *
- * This file intentionally uses interfaces and `+` for readonly.
+ * This file intentionally uses interfaces and `readonly` fields.
  *
  * - `$ReadOnly` is an "evaluated" utility type in flow; meaning that flow does
  *    not actually calculate the resulting type until it is used. This creates
@@ -22,7 +22,7 @@
  *    - but in this giant circular-referencing graph that is the AST types, this
  *    causes check times for consumers to be awful.
  *
- *    Thus instead we manually annotate properties with `+` to avoid the `$ReadOnly` type.
+ *    Thus instead we manually annotate properties with `readonly` to avoid the `$ReadOnly` type.
  *
  * - `...Type` spreads do not preserve the readonly-ness of the properties. If
  *   we used object literal types then we would have to `$ReadOnly` all spreads
@@ -34,6 +34,54 @@
  *** Please ensure all properties are marked as readonly! ***
  */
 
+/*
+ * Token and Comment are pseudo-nodes to represent pieces of source code
+ *
+ * NOTE:
+ * They are not included in the `ESNode` union below on purpose because they
+ * are not ever included as part of the standard AST tree.
+ */
+// note: this is only ever present on Program.interpreter, never in the body
+// Flow declares a "Node" type as part of its HTML typedefs.
+// Because this file declares global types - we can't clash with it
+// nodes that can be the direct parent of a statement
+// nodes that can be the parent of a statement that store the statements in an array
+// This is the complete type of a "Property"
+// This same node (unfortunately) covers both object literal properties
+// and object desturcturing properties.
+// Private brand checks (#foo in bar) are a special case
+// other binary expressions do not allow PrivateIdentifier in the left
+// `PropertyDefinition` is the new standard for all class properties
+
+/***********************
+ * Flow specific nodes *
+ ***********************/
+// type T = { [[foo]]: number };
+
+/*****************
+ * Declare nodes *
+ *****************/
+
+/**********************
+ * JSX specific nodes *
+ **********************/
+
+/************************************
+ * Match expressions and statements *
+ ************************************/
+
+/******************
+ * Match patterns *
+ ******************/
+
+/***********
+ * Records *
+ ***********/
+
+/******************************************************
+ * Deprecated spec nodes awaiting migration by Hermes *
+ ******************************************************/
+
 Object.defineProperty(exports, "__esModule", {
   value: true
 });

package/dist/types.js

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  *
- * 
+ *  strict
  * @format
  */
 'use strict';
@@ -12,7 +12,7 @@
  *
  * IMPORTANT NOTE
  *
- * This file intentionally uses interfaces and `+` for readonly.
+ * This file intentionally uses interfaces and `readonly` fields.
  *
  * - `$ReadOnly` is an "evaluated" utility type in flow; meaning that flow does
  *    not actually calculate the resulting type until it is used. This creates
@@ -22,7 +22,7 @@
  *    - but in this giant circular-referencing graph that is the AST types, this
  *    causes check times for consumers to be awful.
  *
- *    Thus instead we manually annotate properties with `+` to avoid the `$ReadOnly` type.
+ *    Thus instead we manually annotate properties with `readonly` to avoid the `$ReadOnly` type.
  *
  * - `...Type` spreads do not preserve the readonly-ness of the properties. If
  *   we used object literal types then we would have to `$ReadOnly` all spreads
@@ -34,6 +34,54 @@
  *** Please ensure all properties are marked as readonly! ***
  */
 
+/*
+ * Token and Comment are pseudo-nodes to represent pieces of source code
+ *
+ * NOTE:
+ * They are not included in the `ESNode` union below on purpose because they
+ * are not ever included as part of the standard AST tree.
+ */
+// note: this is only ever present on Program.interpreter, never in the body
+// Flow declares a "Node" type as part of its HTML typedefs.
+// Because this file declares global types - we can't clash with it
+// nodes that can be the direct parent of a statement
+// nodes that can be the parent of a statement that store the statements in an array
+// This is the complete type of a "Property"
+// This same node (unfortunately) covers both object literal properties
+// and object desturcturing properties.
+// Private brand checks (#foo in bar) are a special case
+// other binary expressions do not allow PrivateIdentifier in the left
+// `PropertyDefinition` is the new standard for all class properties
+
+/***********************
+ * Flow specific nodes *
+ ***********************/
+// type T = { [[foo]]: number };
+
+/*****************
+ * Declare nodes *
+ *****************/
+
+/**********************
+ * JSX specific nodes *
+ **********************/
+
+/************************************
+ * Match expressions and statements *
+ ************************************/
+
+/******************
+ * Match patterns *
+ ******************/
+
+/***********
+ * Records *
+ ***********/
+
+/******************************************************
+ * Deprecated spec nodes awaiting migration by Hermes *
+ ******************************************************/
+
 Object.defineProperty(exports, "__esModule", {
   value: true
 });