From fbaf989aa16241479172a184b517e1ca1df0f052 Mon Sep 17 00:00:00 2001
From: Joey Perrott <josephperrott@gmail.com>
Date: Thu, 8 Feb 2024 22:31:48 +0000
Subject: [PATCH] fix(docs-infra): include manually defined api reference docs
 in adev (#54356)

Include the manual defined api reference docs in adev

PR Close #54356
---
 adev/src/assets/BUILD.bazel                        |  3 +++
 packages/BUILD.bazel                               |  2 ++
 tools/manual_api_docs/blocks/BUILD.bazel           | 10 ++++++++++
 tools/manual_api_docs/elements/BUILD.bazel         | 10 ++++++++++
 tools/manual_api_docs/generate_block_api_json.ts   |  9 ++++++++-
 tools/manual_api_docs/generate_element_api_json.ts |  9 ++++++++-
 6 files changed, 41 insertions(+), 2 deletions(-)

diff --git a/adev/src/assets/BUILD.bazel b/adev/src/assets/BUILD.bazel
index eb7246134f5..85d476bb6de 100644
--- a/adev/src/assets/BUILD.bazel
+++ b/adev/src/assets/BUILD.bazel
@@ -65,10 +65,13 @@ copy_to_directory(
         "//packages/upgrade:upgrade_docs",
         "//packages/upgrade/static:upgrade_static_docs",
         "//packages/upgrade/static/testing:upgrade_static_testing_docs",
+        "//tools/manual_api_docs/blocks:blocks_docs",
+        "//tools/manual_api_docs/elements:elements_docs",
     ],
     replace_prefixes = {
         "adev/src/content": "",
         "packages/**/": "api/",
+        "tools/**/": "api/",
     },
 )
 
diff --git a/packages/BUILD.bazel b/packages/BUILD.bazel
index fed621db50a..40ac271a7f7 100644
--- a/packages/BUILD.bazel
+++ b/packages/BUILD.bazel
@@ -98,5 +98,7 @@ generate_api_manifest(
         "//packages/upgrade:upgrade_docs_extraction",
         "//packages/upgrade/static:upgrade_static_docs_extraction",
         "//packages/upgrade/static/testing:upgrade_static_testing_docs_extraction",
+        "//tools/manual_api_docs/blocks",
+        "//tools/manual_api_docs/elements",
     ],
 )
diff --git a/tools/manual_api_docs/blocks/BUILD.bazel b/tools/manual_api_docs/blocks/BUILD.bazel
index c90da190f2a..a4aaf9c1b94 100644
--- a/tools/manual_api_docs/blocks/BUILD.bazel
+++ b/tools/manual_api_docs/blocks/BUILD.bazel
@@ -1,6 +1,16 @@
 load("//tools/manual_api_docs:generate_block_api_json.bzl", "generate_block_api_json")
+load("@npm//@angular/build-tooling/bazel/api-gen/rendering:render_api_to_html.bzl", "render_api_to_html")
+
+package(default_visibility = ["//visibility:public"])
 
 generate_block_api_json(
     name = "blocks",
     srcs = glob(["*.md"]),
 )
+
+render_api_to_html(
+    name = "blocks_docs",
+    srcs = [
+        ":blocks",
+    ],
+)
diff --git a/tools/manual_api_docs/elements/BUILD.bazel b/tools/manual_api_docs/elements/BUILD.bazel
index 75a0a2587cc..643e3430331 100644
--- a/tools/manual_api_docs/elements/BUILD.bazel
+++ b/tools/manual_api_docs/elements/BUILD.bazel
@@ -1,6 +1,16 @@
 load("//tools/manual_api_docs:generate_element_api_json.bzl", "generate_element_api_json")
+load("@npm//@angular/build-tooling/bazel/api-gen/rendering:render_api_to_html.bzl", "render_api_to_html")
+
+package(default_visibility = ["//visibility:public"])
 
 generate_element_api_json(
     name = "elements",
     srcs = glob(["*.md"]),
 )
+
+render_api_to_html(
+    name = "elements_docs",
+    srcs = [
+        ":elements",
+    ],
+)
diff --git a/tools/manual_api_docs/generate_block_api_json.ts b/tools/manual_api_docs/generate_block_api_json.ts
index e1d1e61a391..6595258a8a1 100644
--- a/tools/manual_api_docs/generate_block_api_json.ts
+++ b/tools/manual_api_docs/generate_block_api_json.ts
@@ -27,7 +27,14 @@ function main() {
     };
   });
 
-  writeFileSync(outputFileExecRootRelativePath, JSON.stringify(entries), {encoding: 'utf8'});
+  writeFileSync(
+    outputFileExecRootRelativePath,
+    JSON.stringify({
+      moduleName: '@angular/core',
+      entries,
+    }),
+    {encoding: 'utf8'},
+  );
 }
 
 main();
diff --git a/tools/manual_api_docs/generate_element_api_json.ts b/tools/manual_api_docs/generate_element_api_json.ts
index 21980792db3..2be1e921e11 100644
--- a/tools/manual_api_docs/generate_element_api_json.ts
+++ b/tools/manual_api_docs/generate_element_api_json.ts
@@ -27,7 +27,14 @@ function main() {
     };
   });
 
-  writeFileSync(outputFileExecRootRelativePath, JSON.stringify(entries), {encoding: 'utf8'});
+  writeFileSync(
+    outputFileExecRootRelativePath,
+    JSON.stringify({
+      moduleName: '@angular/core',
+      entries,
+    }),
+    {encoding: 'utf8'},
+  );
 }
 
 main();