Remove blueprints renamed or deleted upstream, without wiping the whole tree first

Author: Yndira-E

nuxt/lib/blueprints-sync.mjs

@@ -177,17 +177,43 @@ function copyTree (srcDir, destDir, sourceRoot, inputRelDir) {
     }
 }
 
+// Removes only the entries under destDir that no longer exist in the source - never
+// submit.njk (this repo's own "Submit Your Own" page, not something blueprint-library
+// provides) and never an entry copyTree is about to repopulate anyway. Deliberately
+// narrower than docs-sync.mjs's full wipe: copyTree already overwrites every file in
+// place on each sync (11ty sees a cheap "changed" event), so wiping unaffected blueprints
+// too would turn that into a delete+recreate of the entire tree on every sync - noisy for
+// 11ty's watcher and briefly 404s a page mid-rebuild for no reason.
+function clearOrphans (destDir, currentNames) {
+    if (!existsSync(destDir)) return
+    for (const entry of readdirSync(destDir, { withFileTypes: true })) {
+        if (entry.name === 'submit.njk' || currentNames.has(entry.name)) continue
+        rmSync(join(destDir, entry.name), { recursive: true, force: true })
+    }
+}
+
+function directoryNames (dir) {
+    return readdirSync(dir, { withFileTypes: true })
+        .filter(entry => entry.isDirectory() && !entry.name.startsWith('.'))
+}
+
 /**
- * Populate src/blueprints from `dir` (one folder per blueprint) and return the manifest
- * describing what was published.
+ * Populate src/blueprints from `dir` (one category folder per top-level entry, one
+ * blueprint per folder below that) and return the manifest describing what was published.
+ * Pruned one level at a time - at the category level and again inside each still-current
+ * category - since that's the actual unit that gets renamed or removed upstream, without
+ * having to fully tree-diff every nested asset to catch it.
  */
 function writeBlueprints ({ dir, websiteRoot, kind, ref }) {
     const destRoot = join(websiteRoot, 'src', 'blueprints')
-
-    for (const entry of readdirSync(dir, { withFileTypes: true })) {
-        if (!entry.isDirectory() || entry.name.startsWith('.')) continue
-        const srcDir = join(dir, entry.name)
-        copyTree(srcDir, join(destRoot, basename(srcDir)), dir, join('blueprints', basename(srcDir)))
+    const categories = directoryNames(dir)
+    clearOrphans(destRoot, new Set(categories.map(entry => entry.name)))
+
+    for (const category of categories) {
+        const categorySrcDir = join(dir, category.name)
+        const categoryDestDir = join(destRoot, basename(categorySrcDir))
+        clearOrphans(categoryDestDir, new Set(directoryNames(categorySrcDir).map(entry => entry.name)))
+        copyTree(categorySrcDir, categoryDestDir, dir, join('blueprints', basename(categorySrcDir)))
     }
 
     return {