Method mainModule

tools/isobuild/package-api.js:338–382

(path, arch, fileOptions = {})

  }

  mainModule(path, arch, fileOptions = {}) {
    arch = toArchArray(arch);

    const errors = [];

    forAllMatchingArchs(arch, a => {
      const filesForArch = this.files[a];
      const source = {
        relPath: pathRelative(".", path),
        fileOptions: {
          ...fileOptions,
          mainModule: true
        }
      };

      const oldMain = filesForArch.main;
      if (oldMain) {
        // It's not an error to call api.mainModule multiple times, but
        // the last call takes precedence over the earlier calls.
        oldMain.fileOptions.mainModule = false;

        if (! _.has(oldMain.fileOptions, "lazy")) {
          // If the laziness of the old main module was not explicitly
          // specified, then it would have been implicitly eager just
          // because it was the main module. Since we are revoking its
          // status as main module now, we should also explicitly revoke
          // the eagerness that came with that status.
          oldMain.fileOptions.lazy = true;
        }
      }

      if (filesForArch.sources.some(old => source.relPath === old.relPath)) {
        errors.push(`Duplicate api.mainModule: ${path}`);
      }

      filesForArch.main = source;
      filesForArch.sources.push(source);

      this._forbidExportWithLazyMain(a);
    });

    errors.forEach(error => {
      buildmessage.error(error, { useMyCaller: 1 });
    });
  }

  _forbidExportWithLazyMain(arch) {
    const filesForArch = this.files[arch];