feat(core): better configuration options for target inference (#787)

Author: AgentEnder

.github/workflows/release.yml

@@ -44,6 +44,7 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NPM_CONFIG_PROVENANCE: 'true'
           VERBOSE_LOGGING: 'true'
 
   post-release-smoke-tests:

apps/docs-site/docusaurus.config.js

@@ -101,6 +101,7 @@ module.exports = {
           // Please change this to your repo.
           editUrl: 'https://github.com/nx-dotnet/nx-dotnet/edit/master/docs/',
           path: '../../docs',
+          sidebarItemsGenerator: sidebarItemsSorter,
         },
         blog: {
           showReadingTime: true,
@@ -114,4 +115,50 @@ module.exports = {
       },
     ],
   ],
+  // plugins: [
+  //   [
+  //     '@docusaurus/plugin-content-docs',
+  //     {
+
+  //       path: '../../docs',
+  //     },
+  //   ],
+  // ],
 };
+
+async function sidebarItemsSorter({
+  defaultSidebarItemsGenerator,
+  docs,
+  ...args
+}) {
+  function sortCategoriesFirst(items, docsMap) {
+    const categories = [];
+    const docs = [];
+
+    for (const item of items) {
+      if (item.type === 'category') {
+        categories.push(item);
+      } else {
+        docs.push(item);
+      }
+    }
+
+    const index = docs.findIndex((item) => item.id === 'index');
+    if (index !== -1) {
+      const [doc] = docs.splice(index, 1);
+      categories.unshift(doc);
+    }
+    const sorted = [...categories, ...docs];
+
+    for (const item of sorted) {
+      if (item.items) {
+        item.items = sortCategoriesFirst(item.items, docsMap);
+      }
+    }
+
+    return sorted;
+  }
+  const docsMap = new Map(docs.map((doc) => [doc.id, doc]));
+  const sidebarItems = await defaultSidebarItemsGenerator({ docs, ...args });
+  return sortCategoriesFirst(sidebarItems, docsMap);
+}

apps/docs-site/project.json

@@ -10,12 +10,6 @@
         "outputPath": "dist/apps/docs-site"
       }
     },
-    "prebuild": {
-      "executor": "nx:run-commands",
-      "options": {
-        "commands": ["echo"]
-      }
-    },
     "serve": {
       "executor": "@nx-plus/docusaurus:dev-server",
       "options": {