docs(labs): produce stardoc API for labs

Fixes #2195

WORKSPACE

@@ -99,6 +99,17 @@ load("@build_bazel_rules_typescript//:package.bzl", "rules_typescript_dev_depend
 
 rules_typescript_dev_dependencies()
 
+# Install labs dependencies
+load("//packages/labs:package.bzl", "npm_bazel_labs_dependencies")
+
+npm_bazel_labs_dependencies()
+
+load("@rules_proto//proto:repositories.bzl", "rules_proto_dependencies", "rules_proto_toolchains")
+
+rules_proto_dependencies()
+
+rules_proto_toolchains()
+
 load("@bazel_gazelle//:deps.bzl", "gazelle_dependencies")
 load("@io_bazel_rules_go//go:deps.bzl", "go_register_toolchains", "go_rules_dependencies")
 
@@ -286,14 +297,3 @@ load("@build_bazel_integration_testing//tools:repositories.bzl", "bazel_binaries
 
 # Depend on the Bazel binaries
 bazel_binaries(versions = SUPPORTED_BAZEL_VERSIONS)
-
-# Install labs dependencies
-load("//packages/labs:package.bzl", "npm_bazel_labs_dependencies")
-
-npm_bazel_labs_dependencies()
-
-load("@rules_proto//proto:repositories.bzl", "rules_proto_dependencies", "rules_proto_toolchains")
-
-rules_proto_dependencies()
-
-rules_proto_toolchains()

docs/BUILD.bazel

@@ -76,6 +76,7 @@ rules_nodejs_docs(
         "Cypress": "//packages/cypress:README.md",
         "Jasmine": "//packages/jasmine:README.md",
         "Karma": "//packages/karma:README.md",
+        "Labs": "//packages/labs:README.md",
         "Protractor": "//packages/protractor:README.md",
         "Rollup": "//packages/rollup:README.md",
         "Terser": "//packages/terser:README.md",

docs/Built-ins.md

@@ -986,7 +986,7 @@ check if yarn is being run by the <code>npm_install</code> repository rule.
 
 <pre>
 npm_install(<a href="#npm_install-name">name</a>, <a href="#npm_install-args">args</a>, <a href="#npm_install-data">data</a>, <a href="#npm_install-environment">environment</a>, <a href="#npm_install-included_files">included_files</a>, <a href="#npm_install-manual_build_file_contents">manual_build_file_contents</a>, <a href="#npm_install-package_json">package_json</a>,
-            <a href="#npm_install-package_lock_json">package_lock_json</a>, <a href="#npm_install-quiet">quiet</a>, <a href="#npm_install-symlink_node_modules">symlink_node_modules</a>, <a href="#npm_install-timeout">timeout</a>)
+            <a href="#npm_install-package_lock_json">package_lock_json</a>, <a href="#npm_install-quiet">quiet</a>, <a href="#npm_install-strict_visibility">strict_visibility</a>, <a href="#npm_install-symlink_node_modules">symlink_node_modules</a>, <a href="#npm_install-timeout">timeout</a>)
 </pre>
 
 **ATTRIBUTES**
@@ -1131,6 +1131,23 @@ fine grained npm dependencies.
         <td>
             True
         </td>
+      </tr>
+            <tr id="npm_install-strict_visibility">
+        <td>strict_visibility</td>
+        <td>
+                            Turn on stricter visibility for generated BUILD.bazel files
+
+When enabled, only dependencies within the given <code>package.json</code> file are given public visibility.
+All transitive dependencies are given limited visibility, enforcing that all direct dependencies are
+listed in the <code>package.json</code> file.
+
+Currently the default is set <code>False</code>, but will likely be flipped <code>True</code> in rules_nodejs 3.0.0
+                                </td>
+        <td>Boolean</td>
+        <td>optional</td>
+        <td>
+            False
+        </td>
       </tr>
             <tr id="npm_install-symlink_node_modules">
         <td>symlink_node_modules</td>
@@ -1476,7 +1493,8 @@ check if yarn is being run by the <code>yarn_install</code> repository rule.
 
 <pre>
 yarn_install(<a href="#yarn_install-name">name</a>, <a href="#yarn_install-args">args</a>, <a href="#yarn_install-data">data</a>, <a href="#yarn_install-environment">environment</a>, <a href="#yarn_install-included_files">included_files</a>, <a href="#yarn_install-manual_build_file_contents">manual_build_file_contents</a>,
-             <a href="#yarn_install-package_json">package_json</a>, <a href="#yarn_install-quiet">quiet</a>, <a href="#yarn_install-symlink_node_modules">symlink_node_modules</a>, <a href="#yarn_install-timeout">timeout</a>, <a href="#yarn_install-use_global_yarn_cache">use_global_yarn_cache</a>, <a href="#yarn_install-yarn_lock">yarn_lock</a>)
+             <a href="#yarn_install-package_json">package_json</a>, <a href="#yarn_install-quiet">quiet</a>, <a href="#yarn_install-strict_visibility">strict_visibility</a>, <a href="#yarn_install-symlink_node_modules">symlink_node_modules</a>, <a href="#yarn_install-timeout">timeout</a>,
+             <a href="#yarn_install-use_global_yarn_cache">use_global_yarn_cache</a>, <a href="#yarn_install-yarn_lock">yarn_lock</a>)
 </pre>
 
 **ATTRIBUTES**
@@ -1611,6 +1629,23 @@ fine grained npm dependencies.
         <td>
             True
         </td>
+      </tr>
+            <tr id="yarn_install-strict_visibility">
+        <td>strict_visibility</td>
+        <td>
+                            Turn on stricter visibility for generated BUILD.bazel files
+
+When enabled, only dependencies within the given <code>package.json</code> file are given public visibility.
+All transitive dependencies are given limited visibility, enforcing that all direct dependencies are
+listed in the <code>package.json</code> file.
+
+Currently the default is set <code>False</code>, but will likely be flipped <code>True</code> in rules_nodejs 3.0.0
+                                </td>
+        <td>Boolean</td>
+        <td>optional</td>
+        <td>
+            False
+        </td>
       </tr>
             <tr id="yarn_install-symlink_node_modules">
         <td>symlink_node_modules</td>

docs/Karma.md

@@ -86,6 +86,10 @@ environment must specify CHROME_BIN so that the rule will know which Chrome bina
 Other <code>browsers</code> and <code>customLaunchers</code> may be set using the a base Karma configuration
 specified in the <code>config_file</code> attribute.
 
+By default we open a headless Chrome. To use a real Chrome browser window, you can pass
+<code>--define DISPLAY=true</code> to Bazel, along with <code>configuration_env_vars = ["DISPLAY"]</code> on
+<code>karma_web_test</code>.
+
 
 <pre>
 karma_web_test(<a href="#karma_web_test-srcs">srcs</a>, <a href="#karma_web_test-deps">deps</a>, <a href="#karma_web_test-data">data</a>, <a href="#karma_web_test-configuration_env_vars">configuration_env_vars</a>, <a href="#karma_web_test-bootstrap">bootstrap</a>, <a href="#karma_web_test-runtime_deps">runtime_deps</a>, <a href="#karma_web_test-static_files">static_files</a>,