From 8a5f6993bdab8a65b674a5f3a5dfa0d7a876b10b Mon Sep 17 00:00:00 2001
From: Gabby Getz <gabby@cesium.com>
Date: Tue, 1 Nov 2022 16:13:09 -0400
Subject: [PATCH] Differentiate workspace APIs in ref docs

---
 Tools/jsdoc/cesium_template/publish.js        | 46 +++++++++++++------
 .../static/styles/jsdoc-default.css           |  9 +++-
 gulpfile.js                                   |  5 +-
 3 files changed, 45 insertions(+), 15 deletions(-)

diff --git a/Tools/jsdoc/cesium_template/publish.js b/Tools/jsdoc/cesium_template/publish.js
index 1cd1c6960ec8..101e1d3bf314 100644
--- a/Tools/jsdoc/cesium_template/publish.js
+++ b/Tools/jsdoc/cesium_template/publish.js
@@ -209,7 +209,7 @@ function attachModuleSymbols(doclets, modules) {
  * @return {string} The HTML for the navigation sidebar.
  */
 function buildNav(members) {
-  var nav = '<ul id="ClassList">',
+  var nav = '<div id="ClassList">',
     seen = {},
     hasClassList = false,
     classNav = "",
@@ -223,22 +223,37 @@ function buildNav(members) {
       return a.longname.toLowerCase().localeCompare(b.longname.toLowerCase());
     });
 
-  if (items.length) {
-    items.forEach(function (m) {
-      if (!hasOwnProp.call(seen, m.longname)) {
-        nav +=
-          '<li data-name="' +
-          m.name +
-          '">' +
-          linkto(m.longname, m.name) +
-          "</li>";
-      }
-      seen[m.longname] = true;
-    });
+  const addItems = (items) => {
+    if (items.length) {
+      items.forEach(function (m) {
+        if (!hasOwnProp.call(seen, m.longname)) {
+          nav +=
+            '<li data-name="' +
+            m.name +
+            '">' +
+            linkto(m.longname, m.name) +
+            "</li>";
+        }
+        seen[m.longname] = true;
+      });
+    }
+  };
 
+  if (process.env.CESIUM_PACKAGES) {
+    process.env.CESIUM_PACKAGES.split(",").forEach((package) => {
+      nav += `<h5>${package}</h5>`;
+      nav += "<ul>";
+      addItems(items.filter((item) => item.meta.package === package));
+      nav += "</ul>";
+    });
+  } else {
+    nav += "<ul>";
+    addItems(items);
     nav += "</ul>";
   }
 
+  nav += "</div>";
+
   return nav;
 }
 
@@ -356,6 +371,11 @@ exports.publish = function (taffyData, opts, tutorials) {
         doclet.meta.sourceUrl = conf["sourceUrl"]
           .replace("{version}", process.env.CESIUM_VERSION)
           .replace("{filename}", docletPath);
+        if (process.env.CESIUM_PACKAGES) {
+          doclet.meta.package = process.env.CESIUM_PACKAGES.split(",").find(
+            (package) => doclet.meta.sourceUrl.indexOf(package) > -1
+          );
+        }
       }
     }
   });
diff --git a/Tools/jsdoc/cesium_template/static/styles/jsdoc-default.css b/Tools/jsdoc/cesium_template/static/styles/jsdoc-default.css
index a993e7e79ff7..37265871bd53 100644
--- a/Tools/jsdoc/cesium_template/static/styles/jsdoc-default.css
+++ b/Tools/jsdoc/cesium_template/static/styles/jsdoc-default.css
@@ -27,7 +27,7 @@ code {
   font-size: 12px;
 }
 
-#ClassList > li {
+#ClassList > ul > li {
   font-family: Consolas, "Liberation Mono", Menlo, "Courier New", Courier,
     Monaco, monospace;
   word-break: break-all;
@@ -299,6 +299,13 @@ div.nav li {
   list-style-type: none;
 }
 
+div.nav h5 {
+  font-family: Consolas, "Liberation Mono", Menlo, "Courier New", Courier,
+    Monaco, monospace;
+  margin-top: 12px;
+  border-bottom: 1px solid #ccc;
+}
+
 nav a {
   color: #5c5954;
 }
diff --git a/gulpfile.js b/gulpfile.js
index 85775890d974..8603dafb7b87 100644
--- a/gulpfile.js
+++ b/gulpfile.js
@@ -415,7 +415,10 @@ export function buildDocs() {
     `npx jsdoc --configure Tools/jsdoc/conf.json --pedantic ${generatePrivateDocumentation}`,
     {
       stdio: "inherit",
-      env: Object.assign({}, process.env, { CESIUM_VERSION: version }),
+      env: Object.assign({}, process.env, {
+        CESIUM_VERSION: version,
+        CESIUM_PACKAGES: packageJson.workspaces,
+      }),
     }
   );