@bull-js/cli 0.0.0-stage → 0.3.0

package/dist/chunk-FHBUQ5I5.js

@@ -0,0 +1,356 @@
+// src/config.ts
+import fs from "fs";
+import path from "path";
+import { loadConfigFromFile } from "vite";
+function defineConfig(config) {
+  return config;
+}
+var CONFIG_FILES = ["bull.config.ts", "bull.config.mts", "bull.config.js", "bull.config.mjs"];
+async function loadBullConfig(root, command, options = {}) {
+  let file;
+  if (options.configFile) {
+    file = path.resolve(options.configFile);
+    if (!fs.existsSync(file)) throw new Error(`The config file ${options.configFile} does not exist.`);
+  } else {
+    file = CONFIG_FILES.map((name) => path.join(root, name)).find((p) => fs.existsSync(p));
+  }
+  if (!file) return { config: {} };
+  try {
+    const loaded = await loadConfigFromFile(
+      { command, mode: options.mode ?? (command === "build" ? "production" : "development") },
+      file,
+      root,
+      "silent",
+      void 0,
+      // "runner" executes the config with Vite's module runner, without bundling it.
+      "runner"
+    );
+    return { config: loaded?.config ?? {}, file };
+  } catch (error) {
+    const message = error.message.split("\n")[0];
+    const hint = /Cannot find (package|module) '@bull-js\//.test(message ?? "") ? "Did you run `npm install`? The config imports from @bull-js/cli." : "Make sure it default-exports `defineConfig({ ... })`.";
+    throw new Error(`Could not load ${path.basename(file)}: ${message}
+    ${hint}`);
+  }
+}
+
+// src/vite/plugin.ts
+import {
+  formatReport,
+  normalizePath,
+  ProjectAnalyzer,
+  serializeResult
+} from "@bull-js/core";
+import pc from "picocolors";
+
+// src/vite/overlay-client.ts
+function overlayMain(hot) {
+  if (!hot || typeof customElements === "undefined") return;
+  const css = `
+    :host { all: initial; }
+    * { box-sizing: border-box; }
+    .backdrop {
+      position: fixed; inset: 0; z-index: 2147483646; overflow-y: auto;
+      background: rgba(9, 9, 14, 0.72); backdrop-filter: blur(6px);
+      font: 14px/1.55 ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
+      color: #e6e6ef; padding: 48px 16px;
+    }
+    .panel { max-width: 920px; margin: 0 auto; }
+    header { display: flex; align-items: center; gap: 12px; margin-bottom: 20px; }
+    .logo { display: block; width: 40px; height: 40px; flex: none; }
+    header h1 { font-size: 18px; margin: 0; font-weight: 650; letter-spacing: -0.01em; }
+    header p { margin: 0; color: #9a9ab0; font-size: 13px; }
+    .spacer { flex: 1; }
+    .close {
+      border: 1px solid #34344a; background: #1b1b27; color: #c8c8da; border-radius: 8px;
+      padding: 6px 12px; cursor: pointer; font: inherit; font-size: 13px;
+    }
+    .close:hover { background: #26263a; }
+    .arch {
+      display: flex; gap: 8px; align-items: center; margin: 0 0 20px; padding: 10px 14px;
+      background: #14141d; border: 1px solid #262636; border-radius: 10px; font-size: 13px; color: #9a9ab0;
+      flex-wrap: wrap;
+    }
+    .layer { padding: 2px 10px; border-radius: 999px; background: #1f2a22; color: #7ee2a8; font-weight: 600; }
+    .arrow { color: #4c8f69; }
+    .card {
+      background: #15151f; border: 1px solid #2a2a3c; border-left: 4px solid var(--tone);
+      border-radius: 12px; padding: 18px 20px; margin-bottom: 16px;
+    }
+    .card.error { --tone: #ff5c7a; }
+    .card.warning { --tone: #ffc04d; }
+    .card-head { display: flex; gap: 12px; align-items: baseline; flex-wrap: wrap; }
+    .title { color: var(--tone); font-weight: 750; font-size: 13px; letter-spacing: 0.04em; }
+    .code { font: 12px ui-monospace, SFMono-Regular, Menlo, monospace; color: #8a8aa3; }
+    .loc {
+      margin-left: auto; font: 12px ui-monospace, SFMono-Regular, Menlo, monospace; color: #a99bff;
+      background: none; border: 0; padding: 0; cursor: pointer; text-decoration: underline dotted;
+    }
+    .message { font-size: 16px; font-weight: 600; margin: 10px 0 12px; color: #fff; }
+    pre {
+      margin: 0 0 14px; padding: 12px 0; background: #0d0d14; border-radius: 8px; overflow-x: auto;
+      font: 12.5px/1.6 ui-monospace, SFMono-Regular, Menlo, monospace;
+    }
+    .fl { display: block; padding: 0 14px; white-space: pre; color: #8d8da6; }
+    .fl.hl { color: #f0f0f8; background: rgba(255, 92, 122, 0.08); }
+    .warning .fl.hl { background: rgba(255, 192, 77, 0.08); }
+    .ln { display: inline-block; min-width: 3ch; margin-right: 14px; color: #55556d; text-align: right; }
+    mark { background: none; color: inherit; text-decoration: underline wavy var(--tone); text-underline-offset: 4px; }
+    .why { color: #b9b9cc; margin: 0 0 12px; }
+    .notes { font: 12.5px ui-monospace, SFMono-Regular, Menlo, monospace; color: #b9b9cc; margin: 0 0 12px; white-space: pre; }
+    .fix-title { font-weight: 700; color: #7ee2a8; font-size: 13px; margin-bottom: 4px; }
+    ol { margin: 0 0 10px; padding-left: 22px; color: #dadaea; }
+    li { margin: 2px 0; }
+    .sub { list-style: none; margin-left: -22px; padding-left: 22px; }
+    code {
+      font: 12.5px ui-monospace, SFMono-Regular, Menlo, monospace; background: #232333;
+      padding: 1px 6px; border-radius: 5px; color: #ffd4e0;
+    }
+    .explain { font-size: 12px; color: #6f6f88; }
+    .fixable { font-size: 12.5px; color: #8fd3ff; margin-bottom: 6px; }
+    .pill {
+      position: fixed; right: 16px; bottom: 16px; z-index: 2147483646; cursor: pointer;
+      display: flex; gap: 8px; align-items: center; border: 1px solid #3a2330;
+      background: #1d1218; color: #ffb3c2; border-radius: 999px; padding: 8px 14px;
+      font: 600 13px ui-sans-serif, system-ui, sans-serif; box-shadow: 0 8px 24px rgba(0,0,0,.35);
+    }
+    .pill.warning { background: #1f1a10; color: #ffd98a; border-color: #3d3220; }
+    .dot { width: 8px; height: 8px; border-radius: 50%; background: currentColor; }
+  `;
+  const bull = `<svg class="logo" viewBox="0 0 64 64" aria-hidden="true">
+    <path d="M19 20C10.5 20 4.5 15 4 5.5c3.5 5.8 9 8.6 17 9.2Z" fill="#ffd9bf"/>
+    <path d="M45 20c8.5 0 14.5-5 15-14.5c-3.5 5.8-9 8.6-17 9.2Z" fill="#ffd9bf"/>
+    <path d="M19.5 21 9 24.5l11.5 4Z" fill="#5a3df0"/><path d="M44.5 21 55 24.5l-11.5 4Z" fill="#e2456f"/>
+    <path d="M18 15h28L32 36Z" fill="#a78bfa"/>
+    <path d="M18 15l14 21v21h-6L20.5 34Z" fill="#6b4dff"/>
+    <path d="M46 15 32 36v21h6l5.5-23Z" fill="#f0507c"/>
+    <path d="m23.5 28.5 4.5 1.5-4 1.8Z" fill="#160f24"/><path d="m40.5 28.5-4.5 1.5 4 1.8Z" fill="#160f24"/>
+    <rect x="23" y="45" width="18" height="12" rx="6" fill="#33224a"/>
+    <ellipse cx="28" cy="50.5" rx="1.6" ry="2.2" fill="#ff7aa2"/><ellipse cx="36" cy="50.5" rx="1.6" ry="2.2" fill="#ff7aa2"/>
+    <path d="M28.5 56.5a3.5 3.5 0 0 0 7 0" fill="none" stroke="#fff4e6" stroke-width="1.8" stroke-linecap="round"/>
+  </svg>`;
+  const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+  const inline = (s) => esc(s).replace(/`([^`]+)`/g, "<code>$1</code>");
+  function frameHtml(frame) {
+    const rows = frame.map((l) => {
+      let text = esc(l.text);
+      if (l.highlight) {
+        const [from, to] = l.highlight;
+        const raw = l.text;
+        text = esc(raw.slice(0, from - 1)) + "<mark>" + esc(raw.slice(from - 1, to - 1) || " ") + "</mark>" + esc(raw.slice(to - 1));
+      }
+      return `<span class="fl${l.highlight ? " hl" : ""}"><span class="ln">${l.line}</span>${text}</span>`;
+    });
+    return `<pre>${rows.join("")}</pre>`;
+  }
+  function cardHtml(d, i) {
+    const loc = d.file ? `${d.file}${d.line ? `:${d.line}:${d.column}` : ""}` : "";
+    const fix = d.fix.map((f) => f.startsWith("  ") ? `<li class="sub">${inline(f.trim())}</li>` : `<li>${inline(f)}</li>`).join("");
+    return `
+      <section class="card ${d.severity}">
+        <div class="card-head">
+          <span class="title">${esc(d.title)}</span>
+          <span class="code">${esc(d.code)}</span>
+          ${loc ? `<button class="loc" data-open="${i}" title="Open in editor">${esc(loc)}</button>` : ""}
+        </div>
+        <div class="message">${inline(d.message)}</div>
+        ${d.frame ? frameHtml(d.frame) : ""}
+        ${d.notes?.length ? `<div class="notes">${esc(d.notes.join("\n"))}</div>` : ""}
+        <p class="why">${inline(d.why)}</p>
+        <div class="fix-title">How to fix</div>
+        <ol>${fix}</ol>
+        ${d.fixable ? `<div class="fixable">\u2726 Auto-fixable: run <code>bull fix</code></div>` : ""}
+        <div class="explain">More info in the terminal: <code>${esc(d.explain)}</code></div>
+      </section>`;
+  }
+  class BullOverlay extends HTMLElement {
+    payload = null;
+    collapsed = false;
+    root;
+    constructor() {
+      super();
+      this.root = this.attachShadow({ mode: "open" });
+      this.root.addEventListener("click", (event) => this.onClick(event));
+      window.addEventListener("keydown", (event) => {
+        if (event.key === "Escape" && this.payload?.mode !== "blocking") this.collapse(true);
+      });
+    }
+    update(payload) {
+      const changed = JSON.stringify(payload.diagnostics) !== JSON.stringify(this.payload?.diagnostics);
+      this.payload = payload;
+      if (changed && payload.errorCount > 0) this.collapsed = false;
+      if (payload.errorCount === 0 && payload.diagnostics.length > 0 && changed) this.collapsed = true;
+      this.render();
+    }
+    collapse(value) {
+      this.collapsed = value;
+      this.render();
+    }
+    onClick(event) {
+      const target = event.target;
+      if (target.closest(".close")) {
+        this.collapse(true);
+        return;
+      }
+      if (target.closest(".pill")) {
+        this.collapse(false);
+        return;
+      }
+      const open = target.closest("[data-open]");
+      if (open && this.payload) {
+        const d = this.payload.diagnostics[Number(open.dataset.open)];
+        if (d?.absoluteFile) {
+          void fetch(
+            `/__open-in-editor?file=${encodeURIComponent(`${d.absoluteFile}:${d.line ?? 1}:${d.column ?? 1}`)}`
+          );
+        }
+      }
+    }
+    render() {
+      const p = this.payload;
+      if (!p || p.diagnostics.length === 0) {
+        this.root.innerHTML = "";
+        return;
+      }
+      const tone = p.errorCount ? "error" : "warning";
+      const summary = [
+        p.errorCount ? `${p.errorCount} ${p.errorCount === 1 ? "error" : "errors"}` : "",
+        p.warningCount ? `${p.warningCount} ${p.warningCount === 1 ? "warning" : "warnings"}` : ""
+      ].filter(Boolean).join(" \xB7 ");
+      if (this.collapsed && p.mode !== "blocking") {
+        this.root.innerHTML = `<style>${css}</style><button class="pill ${tone}"><span class="dot"></span>MVVM \xB7 ${summary}</button>`;
+        return;
+      }
+      this.root.innerHTML = `
+        <style>${css}</style>
+        <div class="backdrop" role="dialog" aria-label="MVVM architecture errors">
+          <div class="panel">
+            <header>
+              ${bull}
+              <div>
+                <h1>The MVVM architecture is broken</h1>
+                <p>${summary}${p.mode === "blocking" ? " \xB7 the app unlocks once you fix it" : " \xB7 Esc to close"}</p>
+              </div>
+              <div class="spacer"></div>
+              ${p.mode === "blocking" ? "" : `<button class="close">Close</button>`}
+            </header>
+            <div class="arch">
+              Allowed direction:
+              <span class="layer">View</span><span class="arrow">\u2500\u2500\u25B6</span>
+              <span class="layer">ViewModel</span><span class="arrow">\u2500\u2500\u25B6</span>
+              <span class="layer">Model</span>
+            </div>
+            ${p.diagnostics.map(cardHtml).join("")}
+          </div>
+        </div>`;
+    }
+  }
+  const TAG = "bull-mvvm-overlay";
+  if (!customElements.get(TAG)) customElements.define(TAG, BullOverlay);
+  let element = document.querySelector(TAG);
+  const ensure = () => {
+    if (!element) {
+      element = document.createElement(TAG);
+      document.documentElement.appendChild(element);
+    }
+    return element;
+  };
+  hot.on("bull:diagnostics", (payload) => ensure().update(payload));
+  hot.send("bull:request");
+}
+var OVERLAY_PUBLIC_PATH = "/@bull-js/overlay.js";
+function overlayModuleCode() {
+  return `(${overlayMain.toString()})(import.meta.hot);
+`;
+}
+
+// src/vite/plugin.ts
+var VIRTUAL_OVERLAY = "\0bull-overlay";
+function bullPlugin(options = {}) {
+  let analyzer = options.analyzer;
+  let isBuild = false;
+  let last;
+  let lastKey = "";
+  const overlayMode = options.overlay ?? "dismissible";
+  const payload = () => {
+    const s = serializeResult(last);
+    return {
+      errorCount: s.errorCount,
+      warningCount: s.warningCount,
+      diagnostics: s.diagnostics,
+      mode: overlayMode || "dismissible"
+    };
+  };
+  function runDev(server, initial = false) {
+    const previous = last;
+    last = analyzer.analyze();
+    const key = JSON.stringify(last.diagnostics);
+    if (key === lastKey && !initial) return;
+    lastKey = key;
+    if (last.diagnostics.length > 0) {
+      console.log(`
+${formatReport(last, { width: Math.min(process.stdout.columns || 88, 100) })}`);
+    } else if (previous && previous.diagnostics.length > 0) {
+      console.log(`
+  ${pc.green("\u2713")} ${pc.bold("MVVM architecture ok")} ${pc.dim("\xB7 every violation was fixed")}
+`);
+    }
+    if (overlayMode) server.ws.send("bull:diagnostics", payload());
+  }
+  return {
+    name: "bull:mvvm",
+    enforce: "pre",
+    configResolved(config) {
+      isBuild = config.command === "build";
+      analyzer ??= new ProjectAnalyzer(options.root ?? config.root, options.config);
+    },
+    buildStart() {
+      if (!isBuild || options.checkOnBuild === false) return;
+      const result = analyzer.analyze();
+      if (result.diagnostics.length) console.log(`
+${formatReport(result)}`);
+      if (result.errorCount > 0) {
+        this.error(`The MVVM architecture has ${result.errorCount} error(s). Fix them to be able to build.`);
+      }
+    },
+    configureServer(server) {
+      const { srcDir, compositionRoot } = analyzer.config;
+      let timer;
+      const schedule = () => {
+        clearTimeout(timer);
+        timer = setTimeout(() => runDev(server), 40);
+      };
+      server.watcher.on("all", (event, file) => {
+        const abs = normalizePath(file);
+        if (!abs.startsWith(`${srcDir}/`) && abs !== srcDir && abs !== compositionRoot) return;
+        if (event === "change" || event === "unlink") analyzer.invalidate(abs);
+        schedule();
+      });
+      if (overlayMode) {
+        server.ws.on("bull:request", (_data, client) => {
+          if (last) client.send("bull:diagnostics", payload());
+        });
+      }
+      runDev(server, true);
+    },
+    resolveId(id) {
+      if (id === OVERLAY_PUBLIC_PATH) return VIRTUAL_OVERLAY;
+    },
+    load(id) {
+      if (id === VIRTUAL_OVERLAY) return overlayModuleCode();
+    },
+    transformIndexHtml: {
+      order: "pre",
+      handler(_html, ctx) {
+        if (!ctx.server || !overlayMode) return;
+        return [{ tag: "script", attrs: { type: "module", src: OVERLAY_PUBLIC_PATH }, injectTo: "head" }];
+      }
+    }
+  };
+}
+
+export {
+  defineConfig,
+  loadBullConfig,
+  bullPlugin
+};

package/dist/chunk-KF3FEGRV.js

@@ -0,0 +1,259 @@
+import {
+  bullPlugin,
+  loadBullConfig
+} from "./chunk-FHBUQ5I5.js";
+
+// src/ui/brand.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import pc from "picocolors";
+function readVersion() {
+  let dir = path.dirname(fileURLToPath(import.meta.url));
+  for (let i = 0; i < 4; i++) {
+    const file = path.join(dir, "package.json");
+    if (fs.existsSync(file)) {
+      const pkg = JSON.parse(fs.readFileSync(file, "utf8"));
+      if (pkg.name === "@bull-js/cli" && pkg.version) return pkg.version;
+    }
+    dir = path.dirname(dir);
+  }
+  return "0.0.0";
+}
+var VERSION = readVersion();
+var TAGLINE = "Stubborn about architecture.";
+var BULL = "\u2649\uFE0E";
+var ART = [
+  "\u2584\u2584             \u2584\u2584",
+  " \u2580\u2588\u2584\u2584       \u2584\u2584\u2588\u2580",
+  "    \u2580\u2588\u2584\u2584\u2584\u2584\u2584\u2584\u2584\u2588\u2580",
+  "     \u2588 o   o \u2588",
+  "      \u2588  \u2584  \u2588",
+  "       \u2580\u2584\u2584\u2584\u2580"
+];
+function bullArt(subtitle) {
+  const side = [
+    "",
+    "",
+    `${pc.bold("bull")} ${pc.dim(`v${VERSION}`)}`,
+    pc.dim(TAGLINE),
+    subtitle ? pc.cyan(subtitle) : "",
+    ""
+  ];
+  return ART.map((line, i) => {
+    const text2 = side[i] ? `${" ".repeat(21 - line.length)}${side[i]}` : "";
+    return `  ${pc.magenta(line)}${text2}`;
+  }).join("\n");
+}
+function banner(command) {
+  console.log(`
+  ${pc.bold(pc.magenta(`${BULL} bull`))} ${pc.dim(`v${VERSION}`)}  ${pc.dim("\xB7")} ${command}
+`);
+}
+
+// src/commands/create.ts
+import { spawnSync } from "child_process";
+import fs3 from "fs";
+import path3 from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import * as p from "@clack/prompts";
+import pc3 from "picocolors";
+
+// src/commands/shared.ts
+import fs2 from "fs";
+import path2 from "path";
+import { formatReport, ProjectAnalyzer } from "@bull-js/core";
+import react from "@vitejs/plugin-react";
+import pc2 from "picocolors";
+import { mergeConfig } from "vite";
+function fail(message, hint) {
+  console.error(`  ${pc2.red("\u2717")} ${message}`);
+  if (hint) console.error(`    ${pc2.dim(hint)}`);
+  process.exitCode = 1;
+}
+async function loadProject(rootArg, command, options = {}) {
+  const root = path2.resolve(rootArg ?? ".");
+  const { config, file } = await loadBullConfig(root, command, options);
+  return { root, config, configFile: file, mode: options.mode, analyzer: new ProjectAnalyzer(root, config) };
+}
+function runAnalysis(project) {
+  const result = project.analyzer.analyze();
+  console.log(formatReport(result, { width: Math.min(process.stdout.columns || 88, 100) }));
+  return result;
+}
+function ensureIndexHtml(root) {
+  if (fs2.existsSync(path2.join(root, "index.html"))) return true;
+  fail(
+    "index.html was not found at the project root.",
+    'Create one with <div id="root"></div> and <script type="module" src="/src/main.tsx"></script>.'
+  );
+  return false;
+}
+function viteConfig(project, extra = {}) {
+  const base = {
+    root: project.root,
+    mode: project.mode,
+    configFile: false,
+    clearScreen: false,
+    // @bull-js/runtime/react imports react-dom/client. If Vite discovers it late, it
+    // optimizes it separately and the app ends up with two copies of React ("Invalid hook call").
+    resolve: { dedupe: ["react", "react-dom"] },
+    optimizeDeps: {
+      include: ["react", "react-dom", "react-dom/client", "react/jsx-runtime", "react/jsx-dev-runtime"]
+    },
+    plugins: [
+      react(),
+      bullPlugin({
+        analyzer: project.analyzer,
+        overlay: project.config.dev?.overlay,
+        checkOnBuild: false
+      })
+    ]
+  };
+  return mergeConfig(mergeConfig(base, extra), project.config.vite ?? {});
+}
+
+// src/commands/create.ts
+var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
+function detectPackageManager(userAgent = process.env.npm_config_user_agent) {
+  const name = userAgent?.split(" ")[0]?.split("/")[0];
+  return PACKAGE_MANAGERS.includes(name) ? name : "npm";
+}
+function runScript(pm, script) {
+  return pm === "npm" ? `npm run ${script}` : `${pm} ${script}`;
+}
+function templatesDir() {
+  let dir = path3.dirname(fileURLToPath2(import.meta.url));
+  for (let i = 0; i < 4; i++) {
+    const candidate = path3.join(dir, "templates");
+    if (fs3.existsSync(candidate)) return candidate;
+    dir = path3.dirname(dir);
+  }
+  throw new Error("Bull templates were not found.");
+}
+function copyTemplate(from, to, vars) {
+  const written = [];
+  fs3.mkdirSync(to, { recursive: true });
+  for (const entry of fs3.readdirSync(from, { withFileTypes: true })) {
+    const name = entry.name === "_gitignore" ? ".gitignore" : entry.name;
+    const src = path3.join(from, entry.name);
+    const dest = path3.join(to, name);
+    if (entry.isDirectory()) {
+      written.push(...copyTemplate(src, dest, vars));
+    } else {
+      const content = fs3.readFileSync(src, "utf8").replace(/\{\{(\w+)\}\}/g, (m, key) => vars[key] ?? m);
+      fs3.writeFileSync(dest, content);
+      written.push(dest);
+    }
+  }
+  return written;
+}
+function scaffoldProject({ name, template = "default" }) {
+  const target = path3.resolve(name);
+  if (fs3.existsSync(target) && fs3.readdirSync(target).length > 0) {
+    throw new Error(`The folder ${pc3.bold(name)} already exists and is not empty.`);
+  }
+  const from = path3.join(templatesDir(), template);
+  if (!fs3.existsSync(from)) throw new Error(`The template "${template}" does not exist.`);
+  const pkgName = path3.basename(target).toLowerCase().replace(/[^a-z0-9-_.]/g, "-");
+  return { target, files: copyTemplate(from, target, { name: pkgName, bullVersion: VERSION }) };
+}
+function run(command, args, cwd, stdio = "ignore") {
+  const result = spawnSync(command, args, { cwd, stdio, shell: process.platform === "win32" });
+  return result.status === 0;
+}
+function initGit(target) {
+  if (!run("git", ["--version"], target)) return false;
+  if (run("git", ["rev-parse", "--is-inside-work-tree"], target)) return false;
+  if (!run("git", ["init", "-q"], target)) return false;
+  run("git", ["add", "-A"], target);
+  run("git", ["commit", "-q", "-m", "Initial commit from bull create"], target);
+  return true;
+}
+async function createCommand(nameArg, options) {
+  console.log(`
+${bullArt("create")}
+`);
+  let name = nameArg;
+  let install = options.install ?? true;
+  let git = options.git ?? true;
+  if (!name) {
+    if (!process.stdin.isTTY || p.isCI()) {
+      fail("Missing the project name.", "Usage: bull create <name> [--no-install] [--no-git] [--pm npm|pnpm|yarn|bun]");
+      return;
+    }
+    const answers = await p.group(
+      {
+        name: () => p.text({
+          message: "Project name",
+          placeholder: "my-app",
+          defaultValue: "my-app",
+          validate: (value) => value && /[<>:"|?*]/.test(value) ? "Use letters, numbers and dashes." : void 0
+        }),
+        install: () => p.confirm({ message: "Install dependencies?", initialValue: install }),
+        git: () => p.confirm({ message: "Initialize a git repository?", initialValue: git })
+      },
+      { onCancel: () => p.cancel("Cancelled.") }
+    );
+    if (p.isCancel(answers.name) || answers.name === void 0) return;
+    name = answers.name;
+    install = answers.install === true;
+    git = answers.git === true;
+  }
+  if (options.pm && !PACKAGE_MANAGERS.includes(options.pm)) {
+    fail(`Unknown package manager "${options.pm}".`, `Use one of: ${PACKAGE_MANAGERS.join(", ")}.`);
+    return;
+  }
+  const pm = options.pm ?? detectPackageManager();
+  let scaffolded;
+  try {
+    scaffolded = scaffoldProject({ name, template: options.template });
+  } catch (error) {
+    fail(error.message);
+    return;
+  }
+  const { target, files } = scaffolded;
+  const rel = (f) => path3.relative(target, f).replace(/\\/g, "/");
+  console.log(`  ${pc3.green("\u2713")} Project created in ${pc3.bold(path3.relative(process.cwd(), target) || ".")}
+`);
+  const tree = files.map(rel).filter((f) => f.startsWith("src/")).sort();
+  for (const f of tree) {
+    const layer = f.split("/")[1];
+    const color = layer === "model" ? pc3.blue : layer === "viewmodel" ? pc3.magenta : layer === "view" ? pc3.green : pc3.dim;
+    console.log(`    ${color(f)}`);
+  }
+  let installed = false;
+  if (install) {
+    console.log(`
+  ${pc3.dim(`Installing dependencies with ${pm}\u2026`)}
+`);
+    installed = run(pm, ["install"], target, "inherit");
+    if (!installed) console.log(`
+  ${pc3.yellow("!")} ${pm} install failed. Run it yourself inside the folder.`);
+  }
+  if (git && initGit(target)) console.log(`
+  ${pc3.green("\u2713")} Initialized a git repository`);
+  const steps = [`cd ${name}`, ...installed ? [] : [`${pm} install`], runScript(pm, "dev")];
+  console.log(`
+  Next steps:
+${steps.map((s) => `    ${pc3.cyan(s)}`).join("\n")}
+
+  House rules: ${pc3.dim("View \u2500\u2500\u25B6 ViewModel \u2500\u2500\u25B6 Model")}. Break them and it will not build.
+  See every rule with ${pc3.cyan("npx bull explain")}.
+`);
+}
+
+export {
+  VERSION,
+  bullArt,
+  banner,
+  fail,
+  loadProject,
+  runAnalysis,
+  ensureIndexHtml,
+  viteConfig,
+  detectPackageManager,
+  runScript,
+  scaffoldProject,
+  createCommand
+};

package/dist/create.d.ts

@@ -0,0 +1,24 @@
+type PackageManager = "npm" | "pnpm" | "yarn" | "bun";
+/** The package manager that launched us (`npm create`, `pnpm create`…), read from `npm_config_user_agent`. */
+declare function detectPackageManager(userAgent?: string | undefined): PackageManager;
+/** `npm run dev` for npm, `pnpm dev` / `yarn dev` / `bun dev` for the rest. */
+declare function runScript(pm: PackageManager, script: string): string;
+interface ScaffoldOptions {
+    /** Folder to create, relative to the current one. */
+    name: string;
+    template?: string;
+}
+/** Copies a template into a new folder. Throws if the folder is not empty or the template does not exist. */
+declare function scaffoldProject({ name, template }: ScaffoldOptions): {
+    target: string;
+    files: string[];
+};
+interface CreateOptions {
+    template?: string;
+    install?: boolean;
+    git?: boolean;
+    pm?: string;
+}
+declare function createCommand(nameArg: string | undefined, options: CreateOptions): Promise<void>;
+
+export { type CreateOptions, type PackageManager, type ScaffoldOptions, createCommand, detectPackageManager, runScript, scaffoldProject };

package/dist/create.js

@@ -0,0 +1,13 @@
+import {
+  createCommand,
+  detectPackageManager,
+  runScript,
+  scaffoldProject
+} from "./chunk-KF3FEGRV.js";
+import "./chunk-FHBUQ5I5.js";
+export {
+  createCommand,
+  detectPackageManager,
+  runScript,
+  scaffoldProject
+};