flow-parser 0.317.0 → 0.319.0

package/oxidized/FlowParserWASM.js.flow

@@ -0,0 +1,119 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ * @format
+ */
+
+type INTENTIONAL_ANY = $FlowFixMe;
+type JSType = 'number' | 'string' | 'array' | 'boolean';
+type CBoolean = ?(number | boolean);
+
+type WASMModuleOverrides = Readonly<{
+  quit(status: number, toThrow: Error): void,
+}>;
+
+// Flow Rust WASM parser exports the same C ABI as Hermes
+export type FlowParserWASM = Readonly<{
+  HEAP8: Int8Array,
+  HEAP16: Int16Array,
+  HEAP32: Int32Array,
+  HEAPU8: Uint8Array,
+  HEAPU16: Uint16Array,
+  HEAPU32: Uint32Array,
+  HEAPF32: Float32Array,
+  HEAPF64: Float64Array,
+
+  _malloc(size: number): number,
+  _free(ptr: number): void,
+
+  ccall(
+    ident: string,
+    returnType: JSType | null,
+    argTypes: ReadonlyArray<JSType>,
+    args: ReadonlyArray<
+      number | string | ReadonlyArray<INTENTIONAL_ANY> | boolean,
+    >,
+    opts?: Readonly<{
+      async?: boolean | void,
+    }>,
+  ): INTENTIONAL_ANY,
+  cwrap: {
+    (
+      'hermesParse',
+      'number',
+      [
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+        'number',
+      ],
+    ): (
+      number,
+      number,
+      number,
+      number,
+      CBoolean,
+      CBoolean,
+      CBoolean,
+      CBoolean,
+      CBoolean,
+      CBoolean,
+      CBoolean,
+      CBoolean,
+      CBoolean,
+      number,
+      CBoolean,
+      CBoolean,
+    ) => number,
+    ('hermesParseResult_free', 'void', ['number']): number => void,
+    ('hermesParseResult_getError', 'string', ['number']): number => string,
+    ('hermesParseResult_getErrorLine', 'number', ['number']): number => number,
+    (
+      'hermesParseResult_getErrorColumn',
+      'number',
+      ['number'],
+    ): number => number,
+    (
+      'hermesParseResult_getProgramBuffer',
+      'number',
+      ['number'],
+    ): number => number,
+    (
+      'hermesParseResult_getPositionBuffer',
+      'number',
+      ['number'],
+    ): number => number,
+    (
+      'hermesParseResult_getPositionBufferSize',
+      'number',
+      ['number'],
+    ): number => number,
+    (
+      'hermesParseResult_getStringBuffer',
+      'number',
+      ['number'],
+    ): number => number,
+  },
+
+  stackAlloc(size: number): number,
+  stackSave(): number,
+  stackRestore(ptr: number): void,
+}>;
+
+declare module.exports: WASMModuleOverrides => FlowParserWASM;

package/oxidized/HermesAST.js.flow

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ * @format
+ */
+
+// flowlint unclear-type:off
+
+export type HermesPosition = {
+  /** >= 1 */
+  +line: number,
+  /** >= 0 */
+  +column: number,
+};
+export type HermesSourceLocation = {
+  start?: HermesPosition,
+  end?: HermesPosition,
+  rangeStart?: number,
+  rangeEnd?: number,
+};
+export type HermesNode = {
+  type: string,
+  [string]: any,
+};
+export type HermesToken = {
+  type:
+    | 'Boolean'
+    | 'Identifier'
+    | 'Keyword'
+    | 'Null'
+    | 'Numeric'
+    | 'BigInt'
+    | 'Punctuator'
+    | 'String'
+    | 'RegularExpression'
+    | 'Template'
+    | 'JSXText',
+  loc: HermesSourceLocation,
+  value: ?string,
+};
+export type HermesComment = {
+  type: 'CommentLine' | 'CommentBlock' | 'InterpreterDirective',
+  loc: HermesSourceLocation,
+  value: ?string,
+};
+export type HermesProgram = {
+  type: 'Program',
+  loc: HermesSourceLocation,
+  body: Array<?HermesNode>,
+  comments: Array<HermesComment>,
+  tokens?: Array<HermesToken>,
+  interpreter?: ?HermesComment,
+};

package/oxidized/HermesParserDecodeUTF8String.js

@@ -0,0 +1,45 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = HermesParserDecodeUTF8String;
+
+function HermesParserDecodeUTF8String(ptrIn, length, heap) {
+  let ptr = ptrIn;
+  const endPtr = ptr + length;
+  let str = '';
+
+  while (ptr < endPtr) {
+    let u0 = heap[ptr++];
+
+    if (!(u0 & 0x80)) {
+      str += String.fromCharCode(u0);
+      continue;
+    }
+
+    const u1 = heap[ptr++] & 0x3f;
+
+    if ((u0 & 0xe0) === 0xc0) {
+      str += String.fromCharCode((u0 & 0x1f) << 6 | u1);
+      continue;
+    }
+
+    const u2 = heap[ptr++] & 0x3f;
+
+    if ((u0 & 0xf0) === 0xe0) {
+      u0 = (u0 & 0x0f) << 12 | u1 << 6 | u2;
+    } else {
+      u0 = (u0 & 0x07) << 18 | u1 << 12 | u2 << 6 | heap[ptr++] & 0x3f;
+    }
+
+    if (u0 < 0x10000) {
+      str += String.fromCharCode(u0);
+    } else {
+      u0 -= 0x10000;
+      str += String.fromCharCode(0xd800 | u0 >> 10, 0xdc00 | u0 & 0x3ff);
+    }
+  }
+
+  return str;
+}

package/oxidized/HermesParserDecodeUTF8String.js.flow

@@ -0,0 +1,65 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ * @format
+ */
+
+'use strict';
+
+/**
+ * Decode a UTF-8 encoded string from Hermes with a known length.
+ * Based on Emscripten's UTF8ToString with the following differences:
+ * - Always reads all bytes up to the given length, including null bytes. This
+ *   means that we can decode strings that contain null bytes in the middle.
+ * - Allow UTF-8 encoded code points that are part of a surrogate pair, even though
+ *   this is technically invalid UTF-8 that UTF8ToString would convert to 0xfffd.
+ */
+export default function HermesParserDecodeUTF8String(
+  ptrIn: number,
+  length: number,
+  heap: Uint8Array,
+): string {
+  let ptr = ptrIn;
+  const endPtr = ptr + length;
+  let str = '';
+
+  while (ptr < endPtr) {
+    // ASCII characters fit in single byte code point
+    let u0 = heap[ptr++];
+    if (!(u0 & 0x80)) {
+      str += String.fromCharCode(u0);
+      continue;
+    }
+
+    // Two byte code point
+    const u1 = heap[ptr++] & 0x3f;
+    if ((u0 & 0xe0) === 0xc0) {
+      str += String.fromCharCode(((u0 & 0x1f) << 6) | u1);
+      continue;
+    }
+
+    const u2 = heap[ptr++] & 0x3f;
+    if ((u0 & 0xf0) === 0xe0) {
+      // Three byte code point
+      u0 = ((u0 & 0x0f) << 12) | (u1 << 6) | u2;
+    } else {
+      // Four byte code point
+      u0 = ((u0 & 0x07) << 18) | (u1 << 12) | (u2 << 6) | (heap[ptr++] & 0x3f);
+    }
+
+    if (u0 < 0x10000) {
+      // Code point fits into a single UTF-16 code unit
+      str += String.fromCharCode(u0);
+    } else {
+      // Code point does not fit into single UTF-16 code unit so convert to surrogate pair
+      u0 -= 0x10000;
+      str += String.fromCharCode(0xd800 | (u0 >> 10), 0xdc00 | (u0 & 0x3ff));
+    }
+  }
+
+  return str;
+}

package/oxidized/ParserOptions.js

@@ -0,0 +1,8 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ParserOptionsKeys = void 0;
+const ParserOptionsKeys = new Set(['allowReturnOutsideFunction', 'assertOperator', 'babel', 'flow', 'enableExperimentalComponentSyntax', 'enableExperimentalFlowMatchSyntax', 'enableExperimentalFlowRecordSyntax', 'reactRuntimeTarget', 'sourceFilename', 'sourceType', 'throwOnParseErrors', 'tokens', 'transformOptions']);
+exports.ParserOptionsKeys = ParserOptionsKeys;

package/oxidized/ParserOptions.js.flow

@@ -0,0 +1,55 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict
+ * @noformat
+ */
+
+'use strict';
+
+import type {Expression} from 'flow-estree';
+
+export type ParserOptions = {
+  allowReturnOutsideFunction?: boolean,
+  assertOperator?: boolean,
+  babel?: boolean,
+  flow?: 'all' | 'detect',
+  enableExperimentalComponentSyntax?: boolean,
+  enableExperimentalDecorators?: boolean,
+  enableExperimentalFlowMatchSyntax?: boolean,
+  enableExperimentalFlowRecordSyntax?: boolean,
+  enableEnums?: boolean,
+  enableRecords?: boolean,
+  enableTypes?: boolean,
+  enableTypesPragmaDetection?: boolean,
+  reactRuntimeTarget?: '18' | '19',
+  sourceFilename?: string,
+  sourceType?: 'module' | 'script' | 'unambiguous',
+  throwOnParseErrors?: boolean,
+  tokens?: boolean,
+  transformOptions?: {
+    +TransformEnumSyntax?: {
+      +enable: boolean,
+      +getRuntime?: () => Expression,
+    },
+  },
+};
+
+export const ParserOptionsKeys /*: ReadonlySet<keyof ParserOptions> */ = new Set([
+  'allowReturnOutsideFunction',
+  'assertOperator',
+  'babel',
+  'flow',
+  'enableExperimentalComponentSyntax',
+  'enableExperimentalFlowMatchSyntax',
+  'enableExperimentalFlowRecordSyntax',
+  'reactRuntimeTarget',
+  'sourceFilename',
+  'sourceType',
+  'throwOnParseErrors',
+  'tokens',
+  'transformOptions',
+]);