jsrepo 1.5.0 → 1.6.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/index.ts
 import fs12 from "node:fs";
 import { fileURLToPath } from "node:url";
-import { program as program7 } from "commander";
+import { program as program8 } from "commander";
 import path12 from "pathe";
 
 // src/commands/add.ts
@@ -913,7 +913,7 @@ var categorySchema = v2.object({
 });
 var TEST_SUFFIXES = [".test.ts", "_test.ts", ".test.js", "_test.js"];
 var isTestFile = (file) => TEST_SUFFIXES.find((suffix) => file.endsWith(suffix)) !== void 0;
-var buildBlocksDirectory = (blocksPath, { cwd, excludeDeps }) => {
+var buildBlocksDirectory = (blocksPath, { cwd, excludeDeps, includeBlocks, includeCategories, errorOnWarn }) => {
   let paths;
   try {
     paths = fs3.readdirSync(blocksPath);
@@ -925,6 +925,8 @@ var buildBlocksDirectory = (blocksPath, { cwd, excludeDeps }) => {
     const categoryDir = path3.join(blocksPath, categoryPath);
     if (fs3.statSync(categoryDir).isFile()) continue;
     const categoryName = path3.basename(categoryPath);
+    if (includeCategories.length > 0 && includeCategories.find((val) => val.trim() === categoryName.trim()) === void 0)
+      continue;
     const category = {
       name: categoryName,
       blocks: []
@@ -934,16 +936,29 @@ var buildBlocksDirectory = (blocksPath, { cwd, excludeDeps }) => {
       const blockDir = path3.join(categoryDir, file);
       if (fs3.statSync(blockDir).isFile()) {
         if (isTestFile(file)) continue;
+        const name2 = path3.parse(path3.basename(file)).name;
+        if (includeBlocks.length > 0 && includeBlocks.find((val) => val.trim() === name2.trim()) === void 0)
+          continue;
         const lang = languages.find((resolver) => resolver.matches(file));
         if (!lang) {
-          console.warn(
-            `${WARN} Skipped \`${color3.bold(blockDir)}\` \`${color3.bold(
-              path3.parse(file).ext
-            )}\` files are not currently supported!`
-          );
+          const error = "files are not currently supported!";
+          if (errorOnWarn) {
+            program.error(
+              color3.red(
+                `Couldn't add \`${color3.bold(blockDir)}\` \`*${color3.bold(
+                  path3.parse(file).ext
+                )}\` ${error}`
+              )
+            );
+          } else {
+            console.warn(
+              `${VERTICAL_LINE}  ${WARN} Skipped \`${color3.bold(blockDir)}\` \`*${color3.bold(
+                path3.parse(file).ext
+              )}\` ${error}`
+            );
+          }
           continue;
         }
-        const name2 = path3.parse(path3.basename(file)).name;
         const testsPath = files.find(
           (f) => TEST_SUFFIXES.find((suffix) => f === `${name2}${suffix}`)
         );
@@ -975,6 +990,8 @@ var buildBlocksDirectory = (blocksPath, { cwd, excludeDeps }) => {
         category.blocks.push(block);
       } else {
         const blockName = file;
+        if (includeBlocks.length > 0 && includeBlocks.find((val) => val.trim() === blockName.trim()) === void 0)
+          continue;
         const blockFiles = fs3.readdirSync(blockDir);
         const hasTests = blockFiles.findIndex((f) => isTestFile(f)) !== -1;
         const localDepsSet = /* @__PURE__ */ new Set();
@@ -983,18 +1000,38 @@ var buildBlocksDirectory = (blocksPath, { cwd, excludeDeps }) => {
         for (const f of blockFiles) {
           if (isTestFile(f)) continue;
           if (fs3.statSync(path3.join(blockDir, f)).isDirectory()) {
-            console.warn(
-              `${VERTICAL_LINE}  ${WARN} Skipped \`${color3.bold(path3.join(blockDir, f))}\` subdirectories are not currently supported!`
-            );
+            const error = "subdirectories are not currently supported!";
+            if (errorOnWarn) {
+              program.error(
+                color3.red(
+                  `Couldn't add \`${color3.bold(path3.join(blockDir, f))}\` ${error}`
+                )
+              );
+            } else {
+              console.warn(
+                `${VERTICAL_LINE}  ${WARN} Skipped \`${color3.bold(path3.join(blockDir, f))}\` ${error}`
+              );
+            }
             continue;
           }
           const lang = languages.find((resolver) => resolver.matches(f));
           if (!lang) {
-            console.warn(
-              `${VERTICAL_LINE}  ${WARN} Skipped \`${color3.bold(path3.join(blockDir, f))}\` \`*${color3.bold(
-                path3.parse(f).ext
-              )}\` files are not currently supported!`
-            );
+            const error = "files are not currently supported!";
+            if (errorOnWarn) {
+              program.error(
+                color3.red(
+                  `Couldn't add \`${color3.bold(path3.join(blockDir, f))}\` \`*${color3.bold(
+                    path3.parse(f).ext
+                  )}\` ${error}`
+                )
+              );
+            } else {
+              console.warn(
+                `${VERTICAL_LINE}  ${WARN} Skipped \`${path3.join(blockDir, f)}\` \`*${color3.bold(
+                  path3.parse(f).ext
+                )}\` ${error}`
+              );
+            }
             continue;
           }
           const { local, dependencies, devDependencies } = lang.resolveDependencies({
@@ -1631,17 +1668,28 @@ ${content}`;
 import fs7 from "node:fs";
 import { outro as outro2, spinner as spinner3 } from "@clack/prompts";
 import color8 from "chalk";
-import { Command as Command2 } from "commander";
+import { Command as Command2, program as program3 } from "commander";
 import path7 from "pathe";
 import * as v6 from "valibot";
 var schema3 = v6.object({
   dirs: v6.array(v6.string()),
+  includeBlocks: v6.array(v6.string()),
+  includeCategories: v6.array(v6.string()),
   excludeDeps: v6.array(v6.string()),
   output: v6.boolean(),
+  errorOnWarn: v6.boolean(),
   verbose: v6.boolean(),
   cwd: v6.string()
 });
-var build = new Command2("build").description(`Builds the provided --dirs in the project root into a \`${OUTPUT_FILE}\` file.`).option("--dirs [dirs...]", "The directories containing the blocks.", ["./blocks"]).option("--exclude-deps [deps...]", "Dependencies that should not be added.", []).option("--no-output", `Do not output a \`${OUTPUT_FILE}\` file.`).option("--verbose", "Include debug logs.", false).option("--cwd <path>", "The current working directory.", process.cwd()).action(async (opts) => {
+var build = new Command2("build").description(`Builds the provided --dirs in the project root into a \`${OUTPUT_FILE}\` file.`).option("--dirs [dirs...]", "The directories containing the blocks.", ["./blocks"]).option("--include-blocks [blockNames...]", "Include only the blocks with these names.", []).option(
+  "--include-categories [categoryNames...]",
+  "Include only the categories with these names.",
+  []
+).option("--exclude-deps [deps...]", "Dependencies that should not be added.", []).option("--no-output", `Do not output a \`${OUTPUT_FILE}\` file.`).option(
+  "--error-on-warn",
+  "If there is a warning throw an error and do not allow build to complete.",
+  false
+).option("--verbose", "Include debug logs.", false).option("--cwd <path>", "The current working directory.", process.cwd()).action(async (opts) => {
   const options = v6.parse(schema3, opts);
   _intro(context.package.version);
   await _build(options);
@@ -1655,25 +1703,81 @@ var _build = async (options) => {
     const dirPath = path7.join(options.cwd, dir);
     loading.start(`Building ${color8.cyan(dirPath)}`);
     if (options.output && fs7.existsSync(outFile)) fs7.rmSync(outFile);
-    categories.push(
-      ...buildBlocksDirectory(dirPath, { cwd: options.cwd, excludeDeps: options.excludeDeps })
-    );
+    const builtCategories = buildBlocksDirectory(dirPath, { ...options });
+    for (const category of builtCategories) {
+      if (categories.find((cat) => cat.name === category.name) !== void 0) {
+        const error = "a category with the same name already exists!";
+        if (options.errorOnWarn) {
+          program3.error(
+            color8.red(
+              `\`${color8.bold(`${dir}/${category.name}`)}\` could not be added because ${error}`
+            )
+          );
+        } else {
+          console.warn(
+            `${VERTICAL_LINE}  ${WARN} Skipped adding \`${color8.cyan(`${dir}/${category.name}`)}\` because ${error}`
+          );
+        }
+        continue;
+      }
+      categories.push(category);
+    }
     loading.stop(`Built ${color8.cyan(dirPath)}`);
   }
-  const categoriesMap = /* @__PURE__ */ new Map();
+  loading.start("Checking manifest");
+  const warnings = [];
   for (const category of categories) {
-    const cat = categoriesMap.get(category.name);
-    if (!cat) {
-      categoriesMap.set(category.name, category);
-      continue;
+    for (const block of category.blocks) {
+      for (const dep of block.localDependencies) {
+        const [depCategoryName, depBlockName] = dep.split("/");
+        const depCategory = categories.find(
+          (cat) => cat.name.trim() === depCategoryName.trim()
+        );
+        const invalidDependencyError = () => {
+          const error = `depends on ${color8.bold(dep)} which doesn't exist!`;
+          if (options.errorOnWarn) {
+            warnings.push(
+              color8.red(`${color8.bold(`${category.name}/${block.name}`)} ${error}`)
+            );
+          } else {
+            warnings.push(
+              `${VERTICAL_LINE}  ${WARN} ${color8.bold(`${category.name}/${block.name}`)} ${error}`
+            );
+          }
+        };
+        if (!depCategory) {
+          invalidDependencyError();
+          continue;
+        }
+        if (depCategory.blocks.find((b) => b.name === depBlockName) === void 0) {
+          invalidDependencyError();
+        }
+      }
+      for (const dep of [...block.dependencies, ...block.devDependencies]) {
+        if (!dep.includes("@")) {
+          const error = `You haven't installed ${color8.bold(dep)} as a dependency so your users could get any version of it when they install your block!`;
+          if (options.errorOnWarn) {
+            warnings.push(color8.red(error));
+          } else {
+            warnings.push(`${VERTICAL_LINE}  ${WARN} ${error}`);
+          }
+        }
+      }
+    }
+  }
+  loading.stop("Completed checking manifest.");
+  if (warnings.length > 0) {
+    for (const warning of warnings) {
+      console.log(warning);
+    }
+    if (options.errorOnWarn) {
+      program3.error("Had warnings while checking manifest.");
     }
-    cat.blocks = [...cat.blocks, ...category.blocks];
-    categoriesMap.set(cat.name, cat);
   }
   if (options.output) {
+    loading.start(`Writing output to \`${color8.cyan(outFile)}\``);
     fs7.writeFileSync(outFile, JSON.stringify(categories, null, "	"));
-  } else {
-    loading.stop("Built successfully!");
+    loading.stop(`Wrote output to \`${color8.cyan(outFile)}\``);
   }
 };
 
@@ -1681,7 +1785,7 @@ var _build = async (options) => {
 import fs8 from "node:fs";
 import { cancel as cancel2, confirm as confirm2, isCancel as isCancel2, outro as outro3, spinner as spinner4 } from "@clack/prompts";
 import color10 from "chalk";
-import { Command as Command3, program as program3 } from "commander";
+import { Command as Command3, program as program4 } from "commander";
 import { diffLines } from "diff";
 import path8 from "pathe";
 import * as v7 from "valibot";
@@ -1901,7 +2005,7 @@ var _diff = async (options) => {
   const loading = spinner4();
   const config = getConfig(options.cwd).match(
     (val) => val,
-    (err) => program3.error(color10.red(err))
+    (err) => program4.error(color10.red(err))
   );
   let repoPaths = config.repos;
   if (options.repo) repoPaths = [options.repo];
@@ -1920,7 +2024,7 @@ var _diff = async (options) => {
     (val) => val,
     ({ repo, message }) => {
       loading.stop(`Failed fetching blocks from ${color10.cyan(repo)}`);
-      program3.error(color10.red(message));
+      program4.error(color10.red(message));
     }
   );
   loading.stop(`Retrieved blocks from ${color10.cyan(repoPaths.join(", "))}`);
@@ -1946,7 +2050,7 @@ var _diff = async (options) => {
         const rawUrl = await providerInfo.provider.resolveRaw(providerInfo, sourcePath);
         const response = await fetch(rawUrl);
         if (!response.ok) {
-          program3.error(color10.red(`There was an error trying to get ${fullSpecifier}`));
+          program4.error(color10.red(`There was an error trying to get ${fullSpecifier}`));
         }
         let remoteContent = await response.text();
         const directory = path8.join(options.cwd, config.path, block.category);
@@ -1999,7 +2103,7 @@ ${prefix?.() ?? ""}
       break;
     }
     if (!found) {
-      program3.error(
+      program4.error(
         color10.red(`Invalid block! ${color10.bold(blockSpecifier)} does not exist!`)
       );
     }
@@ -2010,7 +2114,7 @@ ${prefix?.() ?? ""}
 import fs9 from "node:fs";
 import { cancel as cancel3, confirm as confirm3, isCancel as isCancel3, outro as outro4, select, spinner as spinner5, text } from "@clack/prompts";
 import color11 from "chalk";
-import { Command as Command4, program as program4 } from "commander";
+import { Command as Command4, program as program5 } from "commander";
 import { detect as detect2, resolveCommand as resolveCommand3 } from "package-manager-detector";
 import path9 from "pathe";
 import * as v8 from "valibot";
@@ -2032,7 +2136,7 @@ var init = new Command4("init").description("Initializes your project with a con
   const options = v8.parse(schema5, opts);
   _intro(context.package.version);
   if (options.registry !== void 0 && options.project !== void 0) {
-    program4.error(
+    program5.error(
       color11.red(
         `You cannot provide both ${color11.bold("--project")} and ${color11.bold("--registry")} at the same time.`
       )
@@ -2139,7 +2243,7 @@ var _initRegistry = async (options) => {
   }
   const packagePath = path9.join(options.cwd, "package.json");
   if (!fs9.existsSync(packagePath)) {
-    program4.error(color11.red(`Couldn't find your ${color11.bold("package.json")}!`));
+    program5.error(color11.red(`Couldn't find your ${color11.bold("package.json")}!`));
   }
   const pkg = JSON.parse(fs9.readFileSync(packagePath).toString());
   const scriptAlreadyExists = pkg.scripts !== void 0 && pkg.scripts[options.script] !== void 0;
@@ -2188,7 +2292,7 @@ var _initRegistry = async (options) => {
     buildScript += "jsrepo build ";
   } else {
     const command = resolveCommand3(pm, "execute", ["jsrepo", "build"]);
-    if (!command) program4.error(color11.red(`Error resolving execute command for ${pm}`));
+    if (!command) program5.error(color11.red(`Error resolving execute command for ${pm}`));
     buildScript += `${command.command} ${command.args.join(" ")} `;
   }
   if (options.path !== "./build") {
@@ -2202,7 +2306,7 @@ var _initRegistry = async (options) => {
   try {
     fs9.writeFileSync(packagePath, JSON.stringify(pkg, null, "	"));
   } catch (err) {
-    program4.error(color11.red(`Error writing to \`${color11.bold(packagePath)}\`. Error: ${err}`));
+    program5.error(color11.red(`Error writing to \`${color11.bold(packagePath)}\`. Error: ${err}`));
   }
   loading.stop(`Added \`${color11.cyan(options.script)}\` to scripts in package.json`);
   let installed = alreadyInstalled;
@@ -2231,7 +2335,7 @@ var _initRegistry = async (options) => {
         () => loading.stop(`Installed ${JSREPO}.`),
         (err) => {
           loading.stop(`Failed to install ${JSREPO}.`);
-          program4.error(err);
+          program5.error(err);
         }
       );
       installed = true;
@@ -2258,7 +2362,7 @@ var _initRegistry = async (options) => {
 import fs10 from "node:fs";
 import { cancel as cancel4, confirm as confirm4, isCancel as isCancel4, outro as outro5, spinner as spinner6 } from "@clack/prompts";
 import color12 from "chalk";
-import { Argument, Command as Command5, program as program5 } from "commander";
+import { Argument, Command as Command5, program as program6 } from "commander";
 import { execa as execa2 } from "execa";
 import { resolveCommand as resolveCommand4 } from "package-manager-detector/commands";
 import { detect as detect3 } from "package-manager-detector/detect";
@@ -2287,7 +2391,7 @@ var _test = async (blockNames, options) => {
   verbose(`Attempting to test ${JSON.stringify(blockNames)}`);
   const config = getConfig(options.cwd).match(
     (val) => val,
-    (err) => program5.error(color12.red(err))
+    (err) => program6.error(color12.red(err))
   );
   const loading = spinner6();
   const blocksMap = /* @__PURE__ */ new Map();
@@ -2308,14 +2412,14 @@ var _test = async (blockNames, options) => {
   for (const repo of repoPaths) {
     const providerInfo = (await getProviderInfo(repo)).match(
       (info) => info,
-      (err) => program5.error(color12.red(err))
+      (err) => program6.error(color12.red(err))
     );
     const manifestUrl = await providerInfo.provider.resolveRaw(providerInfo, OUTPUT_FILE);
     verbose(`Got info for provider ${color12.cyan(providerInfo.name)}`);
     const response = await fetch(manifestUrl);
     if (!response.ok) {
       if (!options.verbose) loading.stop(`Error fetching ${color12.cyan(manifestUrl.href)}`);
-      program5.error(
+      program6.error(
         color12.red(
           `There was an error fetching the \`${OUTPUT_FILE}\` from the repository ${color12.cyan(
             repo
@@ -2355,7 +2459,7 @@ var _test = async (blockNames, options) => {
   }
   if (testingBlocks.length === 0) {
     cleanUp();
-    program5.error(color12.red("There were no blocks found in your project!"));
+    program6.error(color12.red("There were no blocks found in your project!"));
   }
   const testingBlocksMapped = [];
   for (const blockSpecifier of testingBlocks) {
@@ -2381,7 +2485,7 @@ var _test = async (blockNames, options) => {
         }
         const providerInfo = (await getProviderInfo(repo)).match(
           (val) => val,
-          (err) => program5.error(color12.red(err))
+          (err) => program6.error(color12.red(err))
         );
         const manifestUrl = await providerInfo.provider.resolveRaw(
           providerInfo,
@@ -2389,7 +2493,7 @@ var _test = async (blockNames, options) => {
         );
         const categories = (await getManifest(manifestUrl)).match(
           (val) => val,
-          (err) => program5.error(color12.red(err))
+          (err) => program6.error(color12.red(err))
         );
         for (const category of categories) {
           for (const block2 of category.blocks) {
@@ -2406,7 +2510,7 @@ var _test = async (blockNames, options) => {
       block = blocksMap.get(blockSpecifier);
     }
     if (!block) {
-      program5.error(
+      program6.error(
         color12.red(`Invalid block! ${color12.bold(blockSpecifier)} does not exist!`)
       );
     }
@@ -2426,7 +2530,7 @@ var _test = async (blockNames, options) => {
       const response = await fetch(rawUrl);
       if (!response.ok) {
         loading.stop(color12.red(`Error fetching ${color12.bold(rawUrl.href)}`));
-        program5.error(color12.red(`There was an error trying to get ${specifier}`));
+        program6.error(color12.red(`There was an error trying to get ${specifier}`));
       }
       return await response.text();
     };
@@ -2477,11 +2581,11 @@ var _test = async (blockNames, options) => {
   verbose("Beginning testing");
   const pm = await detect3({ cwd: options.cwd });
   if (pm == null) {
-    program5.error(color12.red("Could not detect package manager"));
+    program6.error(color12.red("Could not detect package manager"));
   }
   const resolved = resolveCommand4(pm.agent, "execute", ["vitest", "run", tempTestDirectory]);
   if (resolved == null) {
-    program5.error(color12.red(`Could not resolve add command for '${pm.agent}'.`));
+    program6.error(color12.red(`Could not resolve add command for '${pm.agent}'.`));
   }
   const { command, args } = resolved;
   const testCommand = `${command} ${args.join(" ")}`;
@@ -2506,7 +2610,7 @@ var _test = async (blockNames, options) => {
     } else {
       cleanUp();
     }
-    program5.error(color12.red(`Tests failed! Error ${err}`));
+    program6.error(color12.red(`Tests failed! Error ${err}`));
   }
 };
 
@@ -2514,7 +2618,7 @@ var _test = async (blockNames, options) => {
 import fs11 from "node:fs";
 import { cancel as cancel5, confirm as confirm5, isCancel as isCancel5, multiselect as multiselect2, outro as outro6, spinner as spinner7 } from "@clack/prompts";
 import color13 from "chalk";
-import { Command as Command6, program as program6 } from "commander";
+import { Command as Command6, program as program7 } from "commander";
 import { diffLines as diffLines2 } from "diff";
 import { resolveCommand as resolveCommand5 } from "package-manager-detector/commands";
 import { detect as detect4 } from "package-manager-detector/detect";
@@ -2552,13 +2656,13 @@ var _update = async (blockNames, options) => {
   const loading = spinner7();
   const config = getConfig(options.cwd).match(
     (val) => val,
-    (err) => program6.error(color13.red(err))
+    (err) => program7.error(color13.red(err))
   );
   let repoPaths = config.repos;
   if (options.repo) repoPaths = [options.repo];
   for (const blockSpecifier of blockNames) {
     if (blockSpecifier.startsWith("github")) {
-      program6.error(
+      program7.error(
         color13.red(
           `Invalid value provided for block names \`${color13.bold(blockSpecifier)}\`. Block names are expected to be provided in the format of \`${color13.bold("<category>/<name>")}\``
         )
@@ -2581,7 +2685,7 @@ var _update = async (blockNames, options) => {
     (val) => val,
     ({ repo, message }) => {
       loading.stop(`Failed fetching blocks from ${color13.cyan(repo)}`);
-      program6.error(color13.red(message));
+      program7.error(color13.red(message));
     }
   );
   if (!options.verbose) loading.stop(`Retrieved blocks from ${color13.cyan(repoPaths.join(", "))}`);
@@ -2611,7 +2715,7 @@ var _update = async (blockNames, options) => {
   verbose(`Preparing to update ${color13.cyan(updatingBlockNames.join(", "))}`);
   const updatingBlocks = (await resolveTree(updatingBlockNames, blocksMap, repoPaths)).match(
     (val) => val,
-    program6.error
+    program7.error
   );
   const pm = (await detect4({ cwd: options.cwd }))?.agent ?? "npm";
   const tasks = [];
@@ -2629,7 +2733,7 @@ var _update = async (blockNames, options) => {
       const response = await fetch(rawUrl);
       if (!response.ok) {
         loading.stop(color13.red(`Error fetching ${color13.bold(rawUrl.href)}`));
-        program6.error(color13.red(`There was an error trying to get ${fullSpecifier}`));
+        program7.error(color13.red(`There was an error trying to get ${fullSpecifier}`));
       }
       return await response.text();
     };
@@ -2772,7 +2876,7 @@ ${prefix?.() ?? ""}
           },
           (err) => {
             if (!options.verbose) loading.stop("Failed to install dependencies");
-            program6.error(err);
+            program7.error(err);
           }
         );
       }
@@ -2791,7 +2895,7 @@ ${prefix?.() ?? ""}
           },
           (err) => {
             if (!options.verbose) loading.stop("Failed to install dev dependencies");
-            program6.error(err);
+            program7.error(err);
           }
         );
       }
@@ -2838,8 +2942,8 @@ var context = {
   },
   resolveRelativeToRoot
 };
-program7.name(name).description(description).version(version).addCommand(add).addCommand(init).addCommand(test).addCommand(build).addCommand(update).addCommand(diff);
-program7.parse();
+program8.name(name).description(description).version(version).addCommand(add).addCommand(init).addCommand(test).addCommand(build).addCommand(update).addCommand(diff);
+program8.parse();
 export {
   context
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jsrepo",
   "description": "A CLI to add shared code from remote repositories.",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ieedan/jsrepo"

package/src/commands/build.ts

@@ -1,18 +1,22 @@
 import fs from 'node:fs';
 import { outro, spinner } from '@clack/prompts';
 import color from 'chalk';
-import { Command } from 'commander';
+import { Command, program } from 'commander';
 import path from 'pathe';
 import * as v from 'valibot';
 import { context } from '..';
+import * as ascii from '../utils/ascii';
 import { type Category, buildBlocksDirectory } from '../utils/build';
 import { OUTPUT_FILE } from '../utils/context';
 import { intro } from '../utils/prompts';
 
 const schema = v.object({
 	dirs: v.array(v.string()),
+	includeBlocks: v.array(v.string()),
+	includeCategories: v.array(v.string()),
 	excludeDeps: v.array(v.string()),
 	output: v.boolean(),
+	errorOnWarn: v.boolean(),
 	verbose: v.boolean(),
 	cwd: v.string(),
 });
@@ -22,8 +26,19 @@ type Options = v.InferInput<typeof schema>;
 const build = new Command('build')
 	.description(`Builds the provided --dirs in the project root into a \`${OUTPUT_FILE}\` file.`)
 	.option('--dirs [dirs...]', 'The directories containing the blocks.', ['./blocks'])
+	.option('--include-blocks [blockNames...]', 'Include only the blocks with these names.', [])
+	.option(
+		'--include-categories [categoryNames...]',
+		'Include only the categories with these names.',
+		[]
+	)
 	.option('--exclude-deps [deps...]', 'Dependencies that should not be added.', [])
 	.option('--no-output', `Do not output a \`${OUTPUT_FILE}\` file.`)
+	.option(
+		'--error-on-warn',
+		'If there is a warning throw an error and do not allow build to complete.',
+		false
+	)
 	.option('--verbose', 'Include debug logs.', false)
 	.option('--cwd <path>', 'The current working directory.', process.cwd())
 	.action(async (opts) => {
@@ -50,33 +65,102 @@ const _build = async (options: Options) => {
 
 		if (options.output && fs.existsSync(outFile)) fs.rmSync(outFile);
 
-		categories.push(
-			...buildBlocksDirectory(dirPath, { cwd: options.cwd, excludeDeps: options.excludeDeps })
-		);
+		const builtCategories = buildBlocksDirectory(dirPath, { ...options });
+
+		for (const category of builtCategories) {
+			if (categories.find((cat) => cat.name === category.name) !== undefined) {
+				const error = 'a category with the same name already exists!';
+
+				if (options.errorOnWarn) {
+					program.error(
+						color.red(
+							`\`${color.bold(`${dir}/${category.name}`)}\` could not be added because ${error}`
+						)
+					);
+				} else {
+					console.warn(
+						`${ascii.VERTICAL_LINE}  ${ascii.WARN} Skipped adding \`${color.cyan(`${dir}/${category.name}`)}\` because ${error}`
+					);
+				}
+				continue;
+			}
+
+			categories.push(category);
+		}
 
 		loading.stop(`Built ${color.cyan(dirPath)}`);
 	}
 
-	const categoriesMap = new Map<string, Category>();
+	loading.start('Checking manifest');
 
-	for (const category of categories) {
-		const cat = categoriesMap.get(category.name);
+	const warnings: string[] = [];
 
-		if (!cat) {
-			categoriesMap.set(category.name, category);
-			continue;
+	for (const category of categories) {
+		for (const block of category.blocks) {
+			// lookup local deps
+			for (const dep of block.localDependencies) {
+				const [depCategoryName, depBlockName] = dep.split('/');
+
+				const depCategory = categories.find(
+					(cat) => cat.name.trim() === depCategoryName.trim()
+				);
+
+				const invalidDependencyError = () => {
+					const error = `depends on ${color.bold(dep)} which doesn't exist!`;
+
+					if (options.errorOnWarn) {
+						warnings.push(
+							color.red(`${color.bold(`${category.name}/${block.name}`)} ${error}`)
+						);
+					} else {
+						warnings.push(
+							`${ascii.VERTICAL_LINE}  ${ascii.WARN} ${color.bold(`${category.name}/${block.name}`)} ${error}`
+						);
+					}
+				};
+
+				if (!depCategory) {
+					invalidDependencyError();
+					continue;
+				}
+
+				if (depCategory.blocks.find((b) => b.name === depBlockName) === undefined) {
+					invalidDependencyError();
+				}
+			}
+
+			for (const dep of [...block.dependencies, ...block.devDependencies]) {
+				if (!dep.includes('@')) {
+					const error = `You haven't installed ${color.bold(dep)} as a dependency so your users could get any version of it when they install your block!`;
+
+					if (options.errorOnWarn) {
+						warnings.push(color.red(error));
+					} else {
+						warnings.push(`${ascii.VERTICAL_LINE}  ${ascii.WARN} ${error}`);
+					}
+				}
+			}
 		}
+	}
 
-		// we aren't going to merge blocks hopefully people are smart enough not to overlap names
-		cat.blocks = [...cat.blocks, ...category.blocks];
+	loading.stop('Completed checking manifest.');
 
-		categoriesMap.set(cat.name, cat);
+	if (warnings.length > 0) {
+		for (const warning of warnings) {
+			console.log(warning);
+		}
+
+		if (options.errorOnWarn) {
+			program.error('Had warnings while checking manifest.');
+		}
 	}
 
 	if (options.output) {
+		loading.start(`Writing output to \`${color.cyan(outFile)}\``);
+
 		fs.writeFileSync(outFile, JSON.stringify(categories, null, '\t'));
-	} else {
-		loading.stop('Built successfully!');
+
+		loading.stop(`Wrote output to \`${color.cyan(outFile)}\``);
 	}
 };
 

package/src/utils/build.ts

@@ -36,6 +36,9 @@ const isTestFile = (file: string): boolean =>
 type Options = {
 	cwd: string;
 	excludeDeps: string[];
+	includeBlocks: string[];
+	includeCategories: string[];
+	errorOnWarn: boolean;
 };
 
 /** Using the provided path to the blocks folder builds the blocks into categories and also resolves dependencies
@@ -43,7 +46,10 @@ type Options = {
  * @param blocksPath
  * @returns
  */
-const buildBlocksDirectory = (blocksPath: string, { cwd, excludeDeps }: Options): Category[] => {
+const buildBlocksDirectory = (
+	blocksPath: string,
+	{ cwd, excludeDeps, includeBlocks, includeCategories, errorOnWarn }: Options
+): Category[] => {
 	let paths: string[];
 
 	try {
@@ -61,6 +67,13 @@ const buildBlocksDirectory = (blocksPath: string, { cwd, excludeDeps }: Options)
 
 		const categoryName = path.basename(categoryPath);
 
+		// if includeCategories enabled and block is not part of includeCategories skip adding it
+		if (
+			includeCategories.length > 0 &&
+			includeCategories.find((val) => val.trim() === categoryName.trim()) === undefined
+		)
+			continue;
+
 		const category: Category = {
 			name: categoryName,
 			blocks: [],
@@ -74,19 +87,39 @@ const buildBlocksDirectory = (blocksPath: string, { cwd, excludeDeps }: Options)
 			if (fs.statSync(blockDir).isFile()) {
 				if (isTestFile(file)) continue;
 
+				const name = path.parse(path.basename(file)).name;
+
+				// if includeBlocks enabled and block is not part of includeBlocks skip adding it
+				if (
+					includeBlocks.length > 0 &&
+					includeBlocks.find((val) => val.trim() === name.trim()) === undefined
+				)
+					continue;
+
 				const lang = languages.find((resolver) => resolver.matches(file));
 
 				if (!lang) {
-					console.warn(
-						`${ascii.WARN} Skipped \`${color.bold(blockDir)}\` \`${color.bold(
-							path.parse(file).ext
-						)}\` files are not currently supported!`
-					);
+					const error = 'files are not currently supported!';
+
+					if (errorOnWarn) {
+						program.error(
+							color.red(
+								`Couldn't add \`${color.bold(blockDir)}\` \`*${color.bold(
+									path.parse(file).ext
+								)}\` ${error}`
+							)
+						);
+					} else {
+						console.warn(
+							`${ascii.VERTICAL_LINE}  ${ascii.WARN} Skipped \`${color.bold(blockDir)}\` \`*${color.bold(
+								path.parse(file).ext
+							)}\` ${error}`
+						);
+					}
+
 					continue;
 				}
 
-				const name = path.parse(path.basename(file)).name;
-
 				// tries to find a test file with the same name as the file
 				const testsPath = files.find((f) =>
 					TEST_SUFFIXES.find((suffix) => f === `${name}${suffix}`)
@@ -126,6 +159,13 @@ const buildBlocksDirectory = (blocksPath: string, { cwd, excludeDeps }: Options)
 			} else {
 				const blockName = file;
 
+				// if includeBlocks enabled and block is not part of includeBlocks skip adding it
+				if (
+					includeBlocks.length > 0 &&
+					includeBlocks.find((val) => val.trim() === blockName.trim()) === undefined
+				)
+					continue;
+
 				const blockFiles = fs.readdirSync(blockDir);
 
 				const hasTests = blockFiles.findIndex((f) => isTestFile(f)) !== -1;
@@ -139,20 +179,42 @@ const buildBlocksDirectory = (blocksPath: string, { cwd, excludeDeps }: Options)
 					if (isTestFile(f)) continue;
 
 					if (fs.statSync(path.join(blockDir, f)).isDirectory()) {
-						console.warn(
-							`${ascii.VERTICAL_LINE}  ${ascii.WARN} Skipped \`${color.bold(path.join(blockDir, f))}\` subdirectories are not currently supported!`
-						);
+						const error = 'subdirectories are not currently supported!';
+
+						if (errorOnWarn) {
+							program.error(
+								color.red(
+									`Couldn't add \`${color.bold(path.join(blockDir, f))}\` ${error}`
+								)
+							);
+						} else {
+							console.warn(
+								`${ascii.VERTICAL_LINE}  ${ascii.WARN} Skipped \`${color.bold(path.join(blockDir, f))}\` ${error}`
+							);
+						}
 						continue;
 					}
 
 					const lang = languages.find((resolver) => resolver.matches(f));
 
 					if (!lang) {
-						console.warn(
-							`${ascii.VERTICAL_LINE}  ${ascii.WARN} Skipped \`${color.bold(path.join(blockDir, f))}\` \`*${color.bold(
-								path.parse(f).ext
-							)}\` files are not currently supported!`
-						);
+						const error = 'files are not currently supported!';
+
+						if (errorOnWarn) {
+							program.error(
+								color.red(
+									`Couldn't add \`${color.bold(path.join(blockDir, f))}\` \`*${color.bold(
+										path.parse(f).ext
+									)}\` ${error}`
+								)
+							);
+						} else {
+							console.warn(
+								`${ascii.VERTICAL_LINE}  ${ascii.WARN} Skipped \`${path.join(blockDir, f)}\` \`*${color.bold(
+									path.parse(f).ext
+								)}\` ${error}`
+							);
+						}
 						continue;
 					}