babel.d.ts 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. /**
  2. * @license
  3. * Copyright Google LLC All Rights Reserved.
  4. *
  5. * Use of this source code is governed by an MIT-style license that can be
  6. * found in the LICENSE file at https://angular.io/license
  7. */
  8. import { BabelFile, types as t } from '@babel/core';
  9. /**
  10. * Augment some Babel types to add symbols that we rely on, but are not included in the Babel typings.
  11. */
  12. declare module '@babel/traverse' {
  13. interface Hub {
  14. file: BabelFile;
  15. }
  16. }
  17. declare module '@babel/core' {
  18. interface BabelFile {
  19. buildCodeFrameError(node: t.Node, message: string): Error;
  20. }
  21. }
  22. // The following modules are declared to work around a limitation in tsc_wrapped's `strict_deps`
  23. // check. Since Babel uses scoped packages, the corresponding lookup for declaration files in the
  24. // `node_modules/@types/` directory follows a special strategy: the `@types` package has to be
  25. // named `{scope}__{package}`, e.g. `@types/babel__generator`. When `tsc` performs module
  26. // resolution for the `@babel/generator` module specifier, it will first try the `paths` mappings
  27. // but resolution through path mappings does _not_ apply this special naming convention rule for
  28. // `@types` packages, `tsc` only applies that rule in its `@types` resolution step. Consequently,
  29. // the path mapping into Bazel's private `node_modules` directory fails to resolve, causing `tsc`
  30. // to find the nearest `node_modules` directory in an ancestor directory of the origin source
  31. // file. This finds the `node_modules` directory in the workspace, _not_ Bazel's private copy of
  32. // `node_modules` and therefore the `@types` end up being resolved from a `node_modules` tree
  33. // that is not governed by Bazel, and therefore not expected by the `strict_deps` rule.
  34. // Declaring the modules here allows `strict_deps` to always find a declaration of the modules
  35. // in an input file to the compilation, therefore accepting the module import.
  36. declare module '@babel/generator' {}
  37. declare module '@babel/template' {}
  38. declare module '@babel/parser' {}