[4/5] support C++20 Modules, support one phase compilation

I split the XXL PR bazelbuild/bazel#19940 into several small patches.
This is the fourth patch of Support C++20 Modules, which supports one phase compilation.

## Changes of build graph
First, files are scanned, resulting in the creation of `.ddi` files. If the compiler being used is Clang, the tool `clang-scan-deps` is employed.

Next, the generated `.ddi` files are aggregated into a `.CXXModules.json` file using the `aggregate-ddi` tool.

Following this, the `.CXXModules.json` file, along with the `.ddi` files, is used to generate `.modmap` files through the `generate-modmap` tool.

Finally, the source files are compiled into object files. If a file is a module interface, a corresponding module file is produced as a byproduct.

The following diagram illustrates the scanning process.
```
              ┌────────┐                  ┌────────┐                  ┌────────┐
              │foo.cppm│                  │bar.cppm│                  │main.cc │
              └────┬───┘                  └────┬───┘                  └────┬───┘
                   │  c++-module-deps-scanning │                           │
                   │                           │                           │
              ┌────▼───┐                  ┌────▼───┐                  ┌────▼───┐
              │foo.ddi │                  │bar.ddi │                  │main.ddi│
              └────┬───┘                  └────┬───┘                  └────┬───┘
                   │                           │                           │
                   └───────────────────────────┼───────────────────────────┘
                                               │aggregate-ddi
                                      ┌────────▼───────────┐
                                      │demo.CXXModules.json│
                                      └────────────────────┘
```

The following diagram illustrates the compile process of `foo.cppm`.
```
                                                    ┌────────────────────┐
                                                    │demo.CXXModules.json│
                                                    └─────┬──────────────┘
                                                          │
                                                          │
                                        ┌───────┐         │          ┌───────────┐
                                     ┌─►│foo.ddi├─────────┤          │ bar.cppm  │
                                     │  └───────┘         │          └─────┬─────┘
                                     │                    │                │
                                     │                    │                │
                                     │                    │                │
            c++-module-deps-scanning │                    │                │
      ┌────────┐                     │  ┌───────┐   ┌─────▼────┐      ┌────▼─────┐
      │foo.cppm├─────────────────────┴─►│foo.d  │   │foo.modmap│      │ bar.pcm  │
      └───┬────┘                        └──┬────┘   └────┬─────┘      └────┬─────┘
          │                                │             │                 │
          │                                │             │                 │
          │◄───────────────────────────────┴─────────────┴─────────────────┘
          │ c++20-module-compile
 ┌────────▼─────────┐
 │ foo.pcm && foo.o │
 └──────────────────┘
```

## Changes of compile

I modified the CppCompileAction to include the relevant context, inputs, and outputs.

Context: Module files and `.CXXModules.json` files
Inputs: Module files, `.modmap` file, and `.modmap.input` file
Outputs: Module files and `.CXXModules.json` files
The primary difference in CppCompileAction is the addition of the `computeUsedCpp20Modules` function.

The restart mechanism is utilized; if the necessary C++20 Modules files are not ready during compilation, the current compilation will exit and wait for an appropriate time to recompile.

Closes #22553.

PiperOrigin-RevId: 826606472
Change-Id: I7548ebfbf71a1faaa5d08317429a1e77e2454b54

Author: PikachuHyA

cc/private/cc_info.bzl

@@ -538,6 +538,55 @@ def create_compilation_context_with_extra_header_tokens(
         _header_info = cc_compilation_context._header_info,
     )
 
+def create_cc_compilation_context_with_cpp20_modules(
+        *,
+        cc_compilation_context,
+        cpp_module_files,
+        pic_cpp_module_files,
+        cpp_modules_info_file,
+        pic_cpp_modules_info_file):
+    """
+    Creates a CcCompilationContextInfo provider with C++20 Modules
+
+    Args:
+        cc_compilation_context: The CcCompilationContextInfo provider to copy.
+        cpp_module_files: C++20 Module files.
+        pic_cpp_module_files: PIC C++20 Module files.
+        cpp_modules_info_file: C++20 Modules info file.
+        pic_cpp_modules_info_file: PIC C++20 Modules info file.
+
+    Returns:
+        A CcCompilationContextInfo provider with the same data as the given one, but with the
+        C++20 Modules info.
+    """
+    return CcCompilationContextInfo(
+        defines = cc_compilation_context.defines,
+        local_defines = cc_compilation_context.local_defines,
+        headers = cc_compilation_context.headers,
+        direct_headers = cc_compilation_context.direct_headers,
+        direct_public_headers = cc_compilation_context.direct_public_headers,
+        direct_private_headers = cc_compilation_context.direct_private_headers,
+        direct_textual_headers = cc_compilation_context.direct_textual_headers,
+        includes = cc_compilation_context.includes,
+        quote_includes = cc_compilation_context.quote_includes,
+        system_includes = cc_compilation_context.system_includes,
+        framework_includes = cc_compilation_context.framework_includes,
+        external_includes = cc_compilation_context.external_includes,
+        validation_artifacts = cc_compilation_context.validation_artifacts,
+        _virtual_to_original_headers = cc_compilation_context._virtual_to_original_headers,
+        _module_map = cc_compilation_context._module_map,
+        _exporting_module_maps = cc_compilation_context._exporting_module_maps,
+        _non_code_inputs = cc_compilation_context._non_code_inputs,
+        _transitive_modules = cc_compilation_context._transitive_modules,
+        _transitive_pic_modules = cc_compilation_context._transitive_pic_modules,
+        _direct_module_maps = cc_compilation_context._direct_module_maps,
+        _header_info = cc_compilation_context._header_info,
+        _module_files = depset(cpp_module_files, transitive = [cc_compilation_context._module_files]),
+        _pic_module_files = depset(pic_cpp_module_files, transitive = [cc_compilation_context._pic_module_files]),
+        _module_info_files = depset(cpp_modules_info_file, transitive = [cc_compilation_context._module_info_files]),
+        _pic_module_info_files = depset(pic_cpp_modules_info_file, transitive = [cc_compilation_context._pic_module_info_files]),
+    )
+
 def merge_cc_infos(*, direct_cc_infos = [], cc_infos = []):
     """
     Merges multiple `CcInfo`s into one.

cc/private/compile/cc_compilation_outputs.bzl

@@ -37,6 +37,10 @@ CcCompilationOutputsInfo = provider(
         "temps": '(() -> depset[File]) All artifacts that are created if "--save_temps" is true.',
         "_header_tokens": "(list[File]) All token .h.processed files created when preprocessing or parsing headers.",
         "_module_files": "(list[File]) All .pcm files built by the target.",
+        "cpp_module_files": "(list[File]) All .pcm files built by the target's C++20 Modules interface.",
+        "pic_cpp_module_files": "(list[File]) All .pic.pcm files built by the target's C++20 Modules interface.",
+        "cpp_modules_info_file": "(File) .CXXModules.json file created by the target.",
+        "pic_cpp_modules_info_file": "(File) .CXXModules.json file created by the target.",
     },
 )
 
@@ -51,7 +55,11 @@ def create_compilation_outputs_internal(
         pic_gcno_files = [],
         temps = [],
         header_tokens = [],
-        module_files = []):
+        module_files = [],
+        cpp_module_files = [],
+        pic_cpp_module_files = [],
+        cpp_modules_info_file = None,
+        pic_cpp_modules_info_file = None):
     """Creates a CcCompilationOutputsInfo provider.
 
     Args:
@@ -65,6 +73,10 @@ def create_compilation_outputs_internal(
         temps: A depset of temporary files.
         header_tokens: A list of header tokens.
         module_files: A list of module files.
+        cpp_module_files: A list of C++ module files.
+        pic_cpp_module_files: A list of PIC C++ module files.
+        cpp_modules_info_file: A C++ modules info file.
+        pic_cpp_modules_info_file: A PIC C++ modules info file.
 
     Returns:
         A CcCompilationOutputsInfo provider.
@@ -82,6 +94,10 @@ def create_compilation_outputs_internal(
         _pic_gcno_files = _cc_internal.freeze(pic_gcno_files),
         _dwo_files = _cc_internal.freeze(dwo_files),
         _pic_dwo_files = _cc_internal.freeze(pic_dwo_files),
+        cpp_module_files = _cc_internal.freeze(cpp_module_files),
+        pic_cpp_module_files = _cc_internal.freeze(pic_cpp_module_files),
+        cpp_modules_info_file = cpp_modules_info_file,
+        pic_cpp_modules_info_file = pic_cpp_modules_info_file,
     )
 
 EMPTY_COMPILATION_OUTPUTS = create_compilation_outputs_internal()