fix: parser typings for plugins (#15094)

babel · Nov 3, 2022 · b5a6931 · b5a6931
1 parent 1081fdc
commit b5a6931
Show file tree

Hide file tree

Showing 5 changed files with 284 additions and 113 deletions.
diff --git a/Gulpfile.mjs b/Gulpfile.mjs
@@ -527,29 +527,37 @@ function buildRollup(packages, buildStandalone) {
 }
 
 function buildRollupDts(packages) {
-  const sourcemap = process.env.NODE_ENV === "production";
-  return Promise.all(
-    packages.map(async packageName => {
-      const input = `${mapToDts(packageName)}/src/index.d.ts`;
-      const output = `${packageName}/lib/index.d.ts`;
-      log(`Bundling '${chalk.cyan(output)}' with rollup ...`);
+  async function build(input, output, banner) {
+    log(`Bundling '${chalk.cyan(output)}' with rollup ...`);
 
-      const bundle = await rollup({
-        input,
-        plugins: [rollupDts()],
-        onwarn(warning, warn) {
-          if (warning.code !== "CIRCULAR_DEPENDENCY") warn(warning);
-        },
-      });
+    const bundle = await rollup({
+      input,
+      plugins: [rollupDts()],
+    });
 
-      await bundle.write({
-        file: output,
-        format: "es",
-        sourcemap: sourcemap,
-        exports: "named",
-      });
-    })
+    await bundle.write({
+      file: output,
+      format: "es",
+      banner,
+    });
+  }
+
+  const tasks = packages.map(async packageName => {
+    const input = `${mapToDts(packageName)}/src/index.d.ts`;
+    const output = `${packageName}/lib/index.d.ts`;
+
+    await build(input, output);
+  });
+
+  tasks.push(
+    build(
+      "packages/babel-parser/typings/babel-parser.source.d.ts",
+      "packages/babel-parser/typings/babel-parser.d.ts",
+      "// This file is auto-generated! Do not modify it directly.\n/* eslint-disable import/no-extraneous-dependencies, @typescript-eslint/consistent-type-imports, prettier/prettier */"
+    )
   );
+
+  return Promise.all(tasks);
 }
 
 function copyDts(packages) {

diff --git a/package.json b/package.json
@@ -66,7 +66,7 @@
     "mergeiterator": "^1.4.4",
     "prettier": "^2.7.1",
     "rollup": "^2.78.0",
-    "rollup-plugin-dts": "^4.2.2",
+    "rollup-plugin-dts": "^5.0.0",
     "rollup-plugin-polyfill-node": "^0.10.2",
     "rollup-plugin-terser": "^7.0.2",
     "semver": "^6.3.0",

diff --git a/packages/babel-parser/typings/babel-parser.d.ts b/packages/babel-parser/typings/babel-parser.d.ts
@@ -1,3 +1,85 @@
+// This file is auto-generated! Do not modify it directly.
+/* eslint-disable import/no-extraneous-dependencies, @typescript-eslint/consistent-type-imports, prettier/prettier */
+import * as _babel_types from '@babel/types';
+
+type Plugin =
+  | "asyncDoExpressions"
+  | "asyncGenerators"
+  | "bigInt"
+  | "classPrivateMethods"
+  | "classPrivateProperties"
+  | "classProperties"
+  | "classStaticBlock" // Enabled by default
+  | "decimal"
+  | "decorators-legacy"
+  | "decoratorAutoAccessors"
+  | "destructuringPrivate"
+  | "doExpressions"
+  | "dynamicImport"
+  | "explicitResourceManagement"
+  | "exportDefaultFrom"
+  | "exportNamespaceFrom" // deprecated
+  | "flow"
+  | "flowComments"
+  | "functionBind"
+  | "functionSent"
+  | "importMeta"
+  | "jsx"
+  | "logicalAssignment"
+  | "importAssertions"
+  | "importReflection"
+  | "moduleBlocks"
+  | "moduleStringNames"
+  | "nullishCoalescingOperator"
+  | "numericSeparator"
+  | "objectRestSpread"
+  | "optionalCatchBinding"
+  | "optionalChaining"
+  | "partialApplication"
+  | "placeholders"
+  | "privateIn" // Enabled by default
+  | "regexpUnicodeSets"
+  | "throwExpressions"
+  | "topLevelAwait"
+  | "v8intrinsic"
+  | ParserPluginWithOptions[0];
+
+type ParserPluginWithOptions =
+  | ["decorators", DecoratorsPluginOptions]
+  | ["estree", { classFeatures?: boolean }]
+  // @deprecated
+  | ["moduleAttributes", { version: "may-2020" }]
+  | ["pipelineOperator", PipelineOperatorPluginOptions]
+  | ["recordAndTuple", RecordAndTuplePluginOptions]
+  | ["flow", FlowPluginOptions]
+  | ["typescript", TypeScriptPluginOptions];
+
+type PluginConfig = Plugin | ParserPluginWithOptions;
+
+interface DecoratorsPluginOptions {
+  decoratorsBeforeExport?: boolean;
+  allowCallParenthesized?: boolean;
+}
+
+interface PipelineOperatorPluginOptions {
+  proposal: "minimal" | "fsharp" | "hack" | "smart";
+  topicToken?: "%" | "#" | "@@" | "^^" | "^";
+}
+
+interface RecordAndTuplePluginOptions {
+  syntaxType: "bar" | "hash";
+}
+
+interface FlowPluginOptions {
+  all?: boolean;
+  enums?: boolean;
+}
+
+interface TypeScriptPluginOptions {
+  dts?: boolean;
+  disallowAmbiguousJSXLike?: boolean;
+}
+
 // Type definitions for @babel/parser
 // Project: https://github.com/babel/babel/tree/main/packages/babel-parser
 // Definitions by: Troy Gerwien <https://github.com/yortus>
@@ -8,20 +90,20 @@
 /**
  * Parse the provided code as an entire ECMAScript program.
  */
-export function parse(
+declare function parse(
   input: string,
   options?: ParserOptions
-): ParseResult<import("@babel/types").File>;
+): ParseResult<_babel_types.File>;
 
 /**
  * Parse the provided code as a single expression.
  */
-export function parseExpression(
+declare function parseExpression(
   input: string,
   options?: ParserOptions
-): ParseResult<import("@babel/types").Expression>;
+): ParseResult<_babel_types.Expression>;
 
-export interface ParserOptions {
+interface ParserOptions {
   /**
    * By default, import and export declarations can only appear at a program's top level.
    * Setting this option to true allows them anywhere where a statement is allowed.
@@ -125,91 +207,21 @@ export interface ParserOptions {
   createParenthesizedExpressions?: boolean;
 }
 
-export type ParserPlugin =
-  | "asyncDoExpressions"
-  | "asyncGenerators"
-  | "bigInt"
-  | "classPrivateMethods"
-  | "classPrivateProperties"
-  | "classProperties"
-  | "classStaticBlock" // Enabled by default
-  | "decimal"
-  | "decorators"
-  | "decorators-legacy"
-  | "decoratorAutoAccessors"
-  | "destructuringPrivate"
-  | "doExpressions"
-  | "dynamicImport"
-  | "estree"
-  | "exportDefaultFrom"
-  | "exportNamespaceFrom" // deprecated
-  | "flow"
-  | "flowComments"
-  | "functionBind"
-  | "functionSent"
-  | "importMeta"
-  | "jsx"
-  | "logicalAssignment"
-  | "importAssertions"
-  | "moduleBlocks"
-  | "moduleStringNames"
-  | "nullishCoalescingOperator"
-  | "numericSeparator"
-  | "objectRestSpread"
-  | "optionalCatchBinding"
-  | "optionalChaining"
-  | "partialApplication"
-  | "pipelineOperator"
-  | "placeholders"
-  | "privateIn" // Enabled by default
-  | "recordAndTuple"
-  | "regexpUnicodeSets"
-  | "throwExpressions"
-  | "topLevelAwait"
-  | "typescript"
-  | "v8intrinsic"
-  | ParserPluginWithOptions;
-
-export type ParserPluginWithOptions =
-  | ["decorators", DecoratorsPluginOptions]
-  | ["pipelineOperator", PipelineOperatorPluginOptions]
-  | ["recordAndTuple", RecordAndTuplePluginOptions]
-  | ["flow", FlowPluginOptions]
-  | ["typescript", TypeScriptPluginOptions];
-
-export interface DecoratorsPluginOptions {
-  decoratorsBeforeExport?: boolean;
-}
-
-export interface PipelineOperatorPluginOptions {
-  proposal: "minimal" | "fsharp" | "hack" | "smart";
-  topicToken?: "%" | "#" | "@@" | "^^" | "^";
-}
+type ParserPlugin = PluginConfig;
 
-export interface RecordAndTuplePluginOptions {
-  syntaxType?: "bar" | "hash";
-}
 
-export interface FlowPluginOptions {
-  all?: boolean;
-  enums?: boolean;
-}
-
-export interface TypeScriptPluginOptions {
-  dts?: boolean;
-  disallowAmbiguousJSXLike?: boolean;
-}
-
-export const tokTypes: {
+declare const tokTypes: {
   // todo(flow->ts) real token type
   [name: string]: any;
 };
 
-export interface ParseError {
+interface ParseError {
   code: string;
   reasonCode: string;
 }
 
 type ParseResult<Result> = Result & {
   errors: ParseError[];
 };
+
+export { DecoratorsPluginOptions, FlowPluginOptions, ParseError, ParserOptions, ParserPlugin, ParserPluginWithOptions, PipelineOperatorPluginOptions, RecordAndTuplePluginOptions, TypeScriptPluginOptions, parse, parseExpression, tokTypes };