build: package material api docs into npm package (#14508)

Author: devversion

src/BUILD.bazel

@@ -1,9 +1,13 @@
 package(default_visibility = ["//visibility:public"])
 
-load("//:packages.bzl", "CDK_PACKAGES")
+load("//:packages.bzl", "CDK_PACKAGES", "MATERIAL_PACKAGES")
 load("//tools:defaults.bzl", "ts_library")
 load("//tools/dgeni:index.bzl", "dgeni_api_docs")
 
+# List that contains all source files that need to be processed by Dgeni.
+apiSourceFiles = ["//src/cdk/%s:source-files" % name for name in CDK_PACKAGES] + [
+  "//src/lib/%s:source-files" % name for name in MATERIAL_PACKAGES]
+
 exports_files([
   "bazel-tsconfig-build.json",
   "bazel-tsconfig-test.json",
@@ -17,13 +21,14 @@ ts_library(
 
 dgeni_api_docs(
   name = "api-docs",
-  srcs = ["//src/cdk/%s:source-files" % name for name in CDK_PACKAGES] + [
+  srcs = apiSourceFiles + [
     # Add all Angular packages to the sources because some Material exports use
     # Angular exports and these should not cause any warnings when Dgeni uses the
     # type checker to parse our TypeScript sources.
     "@matdeps//@angular"
   ],
   entry_points = {
     "cdk": CDK_PACKAGES,
+    "material": MATERIAL_PACKAGES,
   },
 )

src/lib/autocomplete/BUILD.bazel

@@ -72,3 +72,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":autocomplete.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/badge/BUILD.bazel

@@ -45,3 +45,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":badge.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/bottom-sheet/BUILD.bazel

@@ -64,3 +64,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":bottom-sheet.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/button-toggle/BUILD.bazel

@@ -54,3 +54,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":button-toggle.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/button/BUILD.bazel

@@ -54,3 +54,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":button.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/card/BUILD.bazel

@@ -33,3 +33,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":card.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/checkbox/BUILD.bazel

@@ -60,3 +60,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":checkbox.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/chips/BUILD.bazel

@@ -69,3 +69,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":chips.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/core/BUILD.bazel

@@ -120,3 +120,8 @@ markdown_to_html(
   name = "overview",
   srcs = ["ripple/ripple.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/datepicker/BUILD.bazel

@@ -94,3 +94,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":datepicker.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/dialog/BUILD.bazel

@@ -66,3 +66,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":dialog.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/divider/BUILD.bazel

@@ -46,3 +46,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":divider.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/expansion/BUILD.bazel

@@ -70,3 +70,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":expansion.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/form-field/BUILD.bazel

@@ -89,3 +89,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":form-field.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/grid-list/BUILD.bazel

@@ -48,3 +48,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":grid-list.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/icon/BUILD.bazel

@@ -53,3 +53,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":icon.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/input/BUILD.bazel

@@ -56,3 +56,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":input.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/list/BUILD.bazel

@@ -60,3 +60,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":list.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/menu/BUILD.bazel

@@ -68,3 +68,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":menu.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/paginator/BUILD.bazel

@@ -54,3 +54,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":paginator.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/progress-bar/BUILD.bazel

@@ -54,3 +54,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":progress-bar.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/progress-spinner/BUILD.bazel

@@ -49,3 +49,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":progress-spinner.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/radio/BUILD.bazel

@@ -56,3 +56,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":radio.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/select/BUILD.bazel

@@ -74,3 +74,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":select.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/sidenav/BUILD.bazel

@@ -66,3 +66,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":sidenav.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/slide-toggle/BUILD.bazel

@@ -61,3 +61,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":slide-toggle.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/slider/BUILD.bazel

@@ -62,3 +62,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":slider.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/snack-bar/BUILD.bazel

@@ -67,3 +67,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":snack-bar.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/sort/BUILD.bazel

@@ -55,3 +55,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":sort.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/stepper/BUILD.bazel

@@ -75,3 +75,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":stepper.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/table/BUILD.bazel

@@ -55,3 +55,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":table.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/tabs/BUILD.bazel

@@ -102,3 +102,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":tabs.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/toolbar/BUILD.bazel

@@ -51,6 +51,11 @@ markdown_to_html(
   srcs = [":toolbar.md"],
 )
 
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)
+
 
 
 

src/lib/tooltip/BUILD.bazel

@@ -70,3 +70,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":tooltip.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/lib/tree/BUILD.bazel

@@ -50,3 +50,8 @@ markdown_to_html(
   name = "overview",
   srcs = [":tree.md"],
 )
+
+filegroup(
+  name = "source-files",
+  srcs = glob(["**/*.ts"]),
+)

src/material-examples/BUILD.bazel

@@ -51,7 +51,8 @@ package_docs_content(
     "//src/lib:overviews": "overviews/material",
     "//src/cdk:overviews": "overviews/cdk",
 
-    # TODO(devversion): we need to also package the API html files here
+    # Package the API docs for the Material and CDK package into the docs-content
+    "//src:api-docs": "api-docs",
   }
 )
 

tools/dgeni/bazel-bin.ts

@@ -67,7 +67,9 @@ if (require.main === module) {
       // inherited class members across entry points or packages.
       entryPoints.forEach(entryPointName => {
         const entryPointPath = `${packageName}/${entryPointName}`;
-        const entryPointIndexPath = `${entryPointPath}/index.ts`;
+        // For the entry point path we temporarily want to replace "material" with "lib", as
+        // our package source folder does not align with the entry-point name.
+        const entryPointIndexPath = `${entryPointPath.replace('material', 'lib')}/index.ts`;
 
         tsParser.options.paths![`@angular/${entryPointPath}`] = [entryPointIndexPath];
         readTypeScriptModules.sourceFiles.push(entryPointIndexPath);