@dawitworku/projectcli 0.2.2 → 3.0.0

package/src/preflight.js

@@ -1,5 +1,30 @@
 const { spawn } = require("node:child_process");
 
+function getInstallHint(binary) {
+  const bin = String(binary || "").toLowerCase();
+  if (bin === "git") return "Install Git: https://git-scm.com/downloads";
+  if (bin === "node" || bin === "npm")
+    return "Install Node.js (includes npm): https://nodejs.org/en/download";
+  if (bin === "pnpm") return "Install pnpm: https://pnpm.io/installation";
+  if (bin === "yarn")
+    return "Install Yarn: https://yarnpkg.com/getting-started/install";
+  if (bin === "bun") return "Install Bun: https://bun.sh/docs/installation";
+  if (bin === "cargo" || bin === "rustc")
+    return "Install Rust: https://rustup.rs";
+  if (bin === "go") return "Install Go: https://go.dev/dl/";
+  if (bin === "python" || bin === "python3")
+    return "Install Python: https://www.python.org/downloads/";
+  if (bin === "poetry")
+    return "Install Poetry: https://python-poetry.org/docs/#installation";
+  if (bin === "php") return "Install PHP: https://www.php.net/downloads";
+  if (bin === "dotnet")
+    return "Install .NET SDK: https://dotnet.microsoft.com/download";
+  if (bin === "java" || bin === "javac")
+    return "Install a JDK: https://adoptium.net/";
+  if (bin === "dart") return "Install Dart SDK: https://dart.dev/get-dart";
+  return null;
+}
+
 function checkBinary(binary, args = ["--version"]) {
   return new Promise((resolve) => {
     const child = spawn(binary, args, {
@@ -22,4 +47,5 @@ function checkBinaries(binaries) {
 module.exports = {
   checkBinary,
   checkBinaries,
+  getInstallHint,
 };

package/src/preset.js

@@ -0,0 +1,59 @@
+const chalk = require("chalk");
+
+const { loadConfig, saveConfig, CONFIG_PATH } = require("./config");
+const { listPresets, getPreset } = require("./presets");
+
+function printPresetList(effectiveConfig) {
+  console.log(chalk.bold("\nPresets:"));
+  for (const id of listPresets(effectiveConfig)) {
+    const p = getPreset(id, effectiveConfig);
+    console.log(`- ${p.id}: ${chalk.dim(p.label)}`);
+  }
+  console.log("");
+}
+
+async function runPreset({ prompt, argv, effectiveConfig }) {
+  const args = Array.isArray(argv) ? argv : [];
+  const sub = args[0];
+
+  if (!sub || sub === "list") {
+    printPresetList(effectiveConfig);
+    return;
+  }
+
+  if (sub === "use") {
+    const presetArg = args[1];
+    const preset = getPreset(presetArg, effectiveConfig);
+
+    const config = loadConfig();
+
+    if (!presetArg) {
+      const { picked } = await prompt([
+        {
+          type: "list",
+          name: "picked",
+          message: "Choose a preset:",
+          choices: listPresets(effectiveConfig),
+          default: config.preset || preset.id,
+        },
+      ]);
+      saveConfig({ preset: picked });
+      console.log(chalk.green(`\n✓ Preset set to: ${picked}`));
+      console.log(chalk.dim(`Config: ${CONFIG_PATH}`));
+      return;
+    }
+
+    saveConfig({ preset: preset.id });
+    console.log(chalk.green(`\n✓ Preset set to: ${preset.id}`));
+    console.log(chalk.dim(`Config: ${CONFIG_PATH}`));
+    return;
+  }
+
+  throw new Error(
+    `Unknown preset subcommand: ${sub}. Try: projectcli preset list | projectcli preset use <name>`
+  );
+}
+
+module.exports = {
+  runPreset,
+};

package/src/presets/index.js

@@ -0,0 +1,124 @@
+const PRESETS = {
+  minimal: {
+    id: "minimal",
+    label: "Minimal",
+    defaults: {
+      packageManager: null,
+      js: {
+        formatter: false,
+        linter: false,
+        tests: false,
+      },
+      extras: {
+        ci: false,
+        docker: false,
+        devcontainer: false,
+        license: true,
+      },
+    },
+  },
+
+  startup: {
+    id: "startup",
+    label: "Startup",
+    defaults: {
+      packageManager: "pnpm",
+      js: {
+        formatter: true,
+        linter: true,
+        tests: true,
+      },
+      extras: {
+        ci: true,
+        docker: true,
+        devcontainer: false,
+        license: true,
+      },
+    },
+  },
+
+  strict: {
+    id: "strict",
+    label: "Strict",
+    defaults: {
+      packageManager: "pnpm",
+      js: {
+        formatter: true,
+        linter: true,
+        tests: true,
+      },
+      extras: {
+        ci: true,
+        docker: true,
+        devcontainer: true,
+        license: true,
+      },
+    },
+  },
+
+  enterprise: {
+    id: "enterprise",
+    label: "Enterprise",
+    defaults: {
+      packageManager: "pnpm",
+      js: {
+        formatter: true,
+        linter: true,
+        tests: true,
+      },
+      extras: {
+        ci: true,
+        docker: true,
+        devcontainer: true,
+        license: true,
+      },
+    },
+  },
+};
+
+const { getPluginPresets } = require("../plugins/contributions");
+
+function getAllPresets(effectiveConfig) {
+  const out = { ...PRESETS };
+
+  const pluginPresets = getPluginPresets(effectiveConfig);
+  for (const p of pluginPresets) {
+    if (!p || typeof p.id !== "string") continue;
+    const id = p.id.trim().toLowerCase();
+    if (!id) continue;
+    // Plugin presets can extend the catalog; do not override built-ins.
+    if (out[id]) continue;
+
+    out[id] = {
+      id,
+      label: typeof p.label === "string" ? p.label : id,
+      defaults: p.defaults && typeof p.defaults === "object" ? p.defaults : {},
+      pluginId: p.pluginId,
+    };
+  }
+
+  return out;
+}
+
+function listPresets(effectiveConfig) {
+  return Object.keys(getAllPresets(effectiveConfig));
+}
+
+function getPreset(presetId, effectiveConfig) {
+  const all = getAllPresets(effectiveConfig);
+  if (typeof presetId !== "string") return all.startup || PRESETS.startup;
+  const key = presetId.trim().toLowerCase();
+  return all[key] || all.startup || PRESETS.startup;
+}
+
+function describePreset(presetId, effectiveConfig) {
+  const p = getPreset(presetId, effectiveConfig);
+  return { id: p.id, label: p.label, defaults: p.defaults };
+}
+
+module.exports = {
+  PRESETS,
+  listPresets,
+  getPreset,
+  describePreset,
+};

package/src/registry/index.js

@@ -0,0 +1,91 @@
+// V3 registry wrapper.
+// Combines the legacy built-in registry with plugin-provided generators.
+
+const legacy = require("../registry_legacy");
+const { getPluginRegistryAdditions } = require("../plugins/contributions");
+
+function normalizeLanguageName(name) {
+  return String(name || "").trim();
+}
+
+function normalizeFrameworkName(name) {
+  return String(name || "").trim();
+}
+
+function getPluginRegistryMap(effectiveConfig) {
+  const additions = getPluginRegistryAdditions(effectiveConfig);
+  const out = {};
+
+  for (const add of additions) {
+    const languages = add.languages;
+    if (!languages || typeof languages !== "object") continue;
+
+    for (const langKey of Object.keys(languages)) {
+      const langName = normalizeLanguageName(langKey);
+      if (!langName) continue;
+
+      const frameworks = languages[langKey];
+      if (!frameworks || typeof frameworks !== "object") continue;
+
+      if (!out[langName]) out[langName] = {};
+
+      for (const fwKey of Object.keys(frameworks)) {
+        const fwName = normalizeFrameworkName(fwKey);
+        if (!fwName) continue;
+        const gen = frameworks[fwKey];
+        if (!gen) continue;
+
+        // Do not override existing plugin framework entries.
+        if (!out[langName][fwName]) {
+          out[langName][fwName] = gen;
+        }
+      }
+    }
+  }
+
+  return out;
+}
+
+function getLanguages(effectiveConfig) {
+  const base = legacy.getLanguages();
+  const pluginMap = getPluginRegistryMap(effectiveConfig);
+
+  const extra = Object.keys(pluginMap);
+  const merged = [...base];
+  for (const lang of extra) {
+    if (!merged.includes(lang)) merged.push(lang);
+  }
+
+  return merged;
+}
+
+function getFrameworks(language, effectiveConfig) {
+  const lang = normalizeLanguageName(language);
+  const base = legacy.getFrameworks(lang);
+  const pluginMap = getPluginRegistryMap(effectiveConfig);
+  const pluginFrameworks = pluginMap[lang] ? Object.keys(pluginMap[lang]) : [];
+
+  const merged = [...base];
+  for (const fw of pluginFrameworks) {
+    if (!merged.includes(fw)) merged.push(fw);
+  }
+
+  return merged;
+}
+
+function getGenerator(language, framework, effectiveConfig) {
+  const lang = normalizeLanguageName(language);
+  const fw = normalizeFrameworkName(framework);
+
+  const base = legacy.getGenerator(lang, fw);
+  if (base) return base;
+
+  const pluginMap = getPluginRegistryMap(effectiveConfig);
+  return pluginMap[lang]?.[fw] || null;
+}
+
+module.exports = {
+  getLanguages,
+  getFrameworks,
+  getGenerator,
+};