fix(ivy): ngcc - resolve main property paths correctly (#31509)

There are two places in the ngcc processing where it needs to load the
content of a file given by a general path:

* when determining the format of an entry-point.
 To do this ngcc uses the value of the relevant property in package.json.
 But in the case of `main` it must parse the contents of the entry-point
 file to decide whether the format is UMD or CommonJS.

* when parsing the source files for dependencies to determine the order in
which compilation must occur. The relative imports in each file are parsed
and followed recursively, looking for external imports.

Previously, we naively assumed that the path would match the file name exactly.
But actually we must consider the standard module resolution conventions.
E.g. the extension (.js) may be missing, or the path may refer to a directory
containing an index.js file.

This commit fixes both places.

This commit now requires the `DependencyHost` instances to check
the existence of more files than before (at worst all the different possible
post-fixes). This should not create a significant performance reduction for
ngcc. Since the results of the checks will be cached, and similar work is
done inside the TS compiler, so what we lose in doing it here, is saved later
in the processing. The main performance loss would be where there are lots
of files that need to be parsed for dependencies that do not end up being
processed by TS. But compared to the main ngcc processing this dependency
parsing is a small proportion of the work done and so should not impact
much on the overall performance of ngcc.

// FW-1444

PR Close #31509

packages/compiler-cli/ngcc/test/packages/entry_point_spec.ts

@@ -10,7 +10,7 @@ import {AbsoluteFsPath, FileSystem, absoluteFrom, getFileSystem} from '../../../
 import {runInEachFileSystem} from '../../../src/ngtsc/file_system/testing';
 import {loadTestFiles} from '../../../test/helpers';
 import {NgccConfiguration} from '../../src/packages/configuration';
-import {SUPPORTED_FORMAT_PROPERTIES, getEntryPointInfo} from '../../src/packages/entry_point';
+import {EntryPoint, SUPPORTED_FORMAT_PROPERTIES, getEntryPointFormat, getEntryPointInfo} from '../../src/packages/entry_point';
 import {MockLogger} from '../helpers/mock_logger';
 
 runInEachFileSystem(() => {
@@ -340,6 +340,92 @@ runInEachFileSystem(() => {
     });
   });
 
+  describe('getEntryPointFormat', () => {
+    let SOME_PACKAGE: AbsoluteFsPath;
+    let _: typeof absoluteFrom;
+    let fs: FileSystem;
+    let entryPoint: EntryPoint;
+
+    beforeEach(() => {
+      _ = absoluteFrom;
+      SOME_PACKAGE = _('/project/node_modules/some_package');
+      fs = getFileSystem();
+      loadTestFiles([{
+        name: _('/project/node_modules/some_package/valid_entry_point/package.json'),
+        contents: createPackageJson('valid_entry_point')
+      }]);
+      const config = new NgccConfiguration(fs, _('/project'));
+      entryPoint = getEntryPointInfo(
+          fs, config, new MockLogger(), SOME_PACKAGE,
+          _('/project/node_modules/some_package/valid_entry_point')) !;
+    });
+
+    it('should return `esm2015` format for `fesm2015` property',
+       () => { expect(getEntryPointFormat(fs, entryPoint, 'fesm2015')).toBe('esm2015'); });
+
+    it('should return `esm5` format for `fesm5` property',
+       () => { expect(getEntryPointFormat(fs, entryPoint, 'fesm5')).toBe('esm5'); });
+
+    it('should return `esm2015` format for `es2015` property',
+       () => { expect(getEntryPointFormat(fs, entryPoint, 'es2015')).toBe('esm2015'); });
+
+    it('should return `esm2015` format for `esm2015` property',
+       () => { expect(getEntryPointFormat(fs, entryPoint, 'esm2015')).toBe('esm2015'); });
+
+    it('should return `esm5` format for `esm5` property',
+       () => { expect(getEntryPointFormat(fs, entryPoint, 'esm5')).toBe('esm5'); });
+
+    it('should return `esm5` format for `module` property',
+       () => { expect(getEntryPointFormat(fs, entryPoint, 'module')).toBe('esm5'); });
+
+    it('should return `umd` for `main` if the file contains a UMD wrapper function', () => {
+      loadTestFiles([{
+        name: _(
+            '/project/node_modules/some_package/valid_entry_point/bundles/valid_entry_point/index.js'),
+        contents: `
+        (function (global, factory) {
+          typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@angular/core')) :
+          typeof define === 'function' && define.amd ? define('@angular/common', ['exports', '@angular/core'], factory) :
+          (global = global || self, factory((global.ng = global.ng || {}, global.ng.common = {}), global.ng.core));
+        }(this, function (exports, core) { 'use strict'; }));
+      `
+      }]);
+      expect(getEntryPointFormat(fs, entryPoint, 'main')).toBe('umd');
+    });
+
+    it('should return `commonjs` for `main` if the file does not contain a UMD wrapper function', () => {
+      loadTestFiles([{
+        name: _(
+            '/project/node_modules/some_package/valid_entry_point/bundles/valid_entry_point/index.js'),
+        contents: `
+          const core = require('@angular/core);
+          module.exports = {};
+        `
+      }]);
+      expect(getEntryPointFormat(fs, entryPoint, 'main')).toBe('commonjs');
+    });
+
+    it('should resolve the format path with suitable postfixes', () => {
+      loadTestFiles([{
+        name: _(
+            '/project/node_modules/some_package/valid_entry_point/bundles/valid_entry_point/index.js'),
+        contents: `
+        (function (global, factory) {
+          typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('@angular/core')) :
+          typeof define === 'function' && define.amd ? define('@angular/common', ['exports', '@angular/core'], factory) :
+          (global = global || self, factory((global.ng = global.ng || {}, global.ng.common = {}), global.ng.core));
+        }(this, function (exports, core) { 'use strict'; }));
+      `
+      }]);
+
+      entryPoint.packageJson.main = './bundles/valid_entry_point/index';
+      expect(getEntryPointFormat(fs, entryPoint, 'main')).toBe('umd');
+
+      entryPoint.packageJson.main = './bundles/valid_entry_point';
+      expect(getEntryPointFormat(fs, entryPoint, 'main')).toBe('umd');
+    });
+  });
+
   function createPackageJson(
       packageName: string, {excludes}: {excludes?: string[]} = {},
       typingsProp: string = 'typings'): string {
@@ -351,7 +437,7 @@ runInEachFileSystem(() => {
       es2015: `./es2015/${packageName}.js`,
       fesm5: `./fesm5/${packageName}.js`,
       esm5: `./esm5/${packageName}.js`,
-      main: `./bundles/${packageName}.umd.js`,
+      main: `./bundles/${packageName}/index.js`,
       module: './index.js',
     };
     if (excludes) {