@anaemia/cli 0.3.0 → 0.3.2

package/dist/commands/create.js

@@ -3,9 +3,12 @@ import path from "path";
 import fs from "fs";
 import pc from "picocolors";
 import { generateSharedComponent, scaffoldFeature, scaffoldHook, scaffoldPage } from "../scaffold.js";
-import { execSync } from "node:child_process";
 import prompts from "prompts";
 import { transform } from "sucrase";
+import { fileURLToPath } from "node:url";
+import { fetchTemplate } from "../utils/fetch-template.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 export function register(cli) {
     cli
         .command("create [target]", "initialize an application or generate domain features (e.g., feature:name)")
@@ -100,25 +103,8 @@ export function register(cli) {
             });
         }
         else {
-            logger.warn("local templates missing. fetching remote registry packages over the network...");
-            const userAgent = process.env.npm_config_user_agent || "";
-            let packageManager = "npm";
-            if (userAgent.includes("pnpm"))
-                packageManager = "pnpm";
-            else if (userAgent.includes("yarn"))
-                packageManager = "yarn";
-            try {
-                if (packageManager === "pnpm") {
-                    execSync(`pnpm dlx degit colourlabs/anaemia/templates/base-app "${targetPath}"`, { stdio: "ignore" });
-                }
-                else {
-                    execSync(`npx degit colourlabs/anaemia/templates/base-app "${targetPath}"`, { stdio: "ignore" });
-                }
-            }
-            catch (err) {
-                logger.error("could not source template workspace assets locally or from network registry nodes. " + err);
-                process.exit(1);
-            }
+            logger.info("fetching template from remote registry...");
+            await fetchTemplate(targetPath);
         }
         const removeGitKeepFiles = (dir) => {
             const files = fs.readdirSync(dir);
@@ -200,4 +186,3 @@ export function register(cli) {
         console.log(`  ${pc.cyan("pnpm dev")}        ${pc.dim("# launches hot reload server")}\n`);
     });
 }
-;

package/dist/commands/typecheck.js

@@ -7,4 +7,3 @@ export function register(cli) {
             process.exit(result.status ?? 1);
     });
 }
-;

package/dist/utils/fetch-template.js

@@ -0,0 +1,30 @@
+import * as tar from "tar";
+import logger from "./logger.js";
+const TAR_URL = "https://codeload.github.com/colourlabs/anaemia/tar.gz/main";
+export async function fetchTemplate(targetPath) {
+    logger.info("downloading template...");
+    const res = await fetch(TAR_URL);
+    if (!res.ok)
+        throw new Error(`failed to download template: ${res.statusText}`);
+    await new Promise((resolve, reject) => {
+        const extract = tar.extract({
+            cwd: targetPath,
+            strip: 2,
+            filter: (p) => p.startsWith("anaemia-main/templates/base-app"),
+        });
+        extract.on("finish", resolve);
+        extract.on("error", reject);
+        const reader = res.body.getReader();
+        const pump = async () => {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    extract.end();
+                    break;
+                }
+                extract.write(value);
+            }
+        };
+        pump().catch(reject);
+    });
+}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@anaemia/cli",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "bin": {
     "anaemia": "./dist/index.js"
   },
   "dependencies": {
-    "@anaemia/bundler": "^0.3.0",
-    "@anaemia/core": "^0.3.0",
+    "@anaemia/bundler": "^0.3.2",
+    "@anaemia/core": "^0.3.2",
     "@rspack/core": "^2.0.5",
     "@rspack/dev-server": "2.0.1",
     "cac": "^7.0.0",
@@ -16,6 +16,7 @@
     "picocolors": "^1.1.1",
     "prompts": "^2.4.2",
     "sucrase": "^3.35.1",
+    "tar": "^7.5.15",
     "ws": "^8.21.0"
   },
   "devDependencies": {

package/src/commands/create.ts

@@ -4,226 +4,215 @@ import path from "path";
 import fs from "fs";
 import pc from "picocolors";
 import { generateSharedComponent, scaffoldFeature, scaffoldHook, scaffoldPage } from "../scaffold.js";
-import { execSync } from "node:child_process";
 import prompts from "prompts";
 import { transform } from "sucrase";
+import { fileURLToPath } from "node:url";
+import { fetchTemplate } from "../utils/fetch-template.js";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 
 export function register(cli: CAC) {
   cli
-  .command("create [target]", "initialize an application or generate domain features (e.g., feature:name)")
-  .alias("init")
-  .action(async (target) => {
-    const appRoot = process.cwd();
+    .command("create [target]", "initialize an application or generate domain features (e.g., feature:name)")
+    .alias("init")
+    .action(async (target) => {
+      const appRoot = process.cwd();
 
-    if (target && target.includes(":")) {
-      const [type, name] = target.split(":");
+      if (target && target.includes(":")) {
+        const [type, name] = target.split(":");
 
-      if (!name) {
-        logger.error(`missing name modifier. Use layout template like: ${pc.cyan(`create ${type}:your-name`)}`);
-        process.exit(1);
-      }
+        if (!name) {
+          logger.error(`missing name modifier. Use layout template like: ${pc.cyan(`create ${type}:your-name`)}`);
+          process.exit(1);
+        }
 
-      if (!fs.existsSync(path.join(appRoot, "package.json"))) {
-        logger.error("no package.json detected. code generation commands must run inside an Anaemia project root.");
-        process.exit(1);
-      }
+        if (!fs.existsSync(path.join(appRoot, "package.json"))) {
+          logger.error("no package.json detected. code generation commands must run inside an Anaemia project root.");
+          process.exit(1);
+        }
 
-      const normalizedName = name.trim();
+        const normalizedName = name.trim();
 
-      if (type === "feature") {
-        scaffoldFeature(normalizedName, appRoot);
-        return;
-      }
+        if (type === "feature") {
+          scaffoldFeature(normalizedName, appRoot);
+          return;
+        }
 
-      if (type === "component") {
-        generateSharedComponent(appRoot, normalizedName, { logger, pc });
-        return;
-      }
+        if (type === "component") {
+          generateSharedComponent(appRoot, normalizedName, { logger, pc });
+          return;
+        }
+
+        if (type === "page") {
+          scaffoldPage(normalizedName, appRoot);
+          return;
+        }
+
+        if (type === "hook") {
+          scaffoldHook(normalizedName, appRoot);
+          return;
+        }
 
-      if (type === "page") {
-        scaffoldPage(normalizedName, appRoot);
-        return;
+        logger.error(`unknown layout generator type "${type}". Supported variants: "feature:", "component:", "page:", "hook:"`);
+        process.exit(1);
       }
 
-      if (type === "hook") {
-        scaffoldHook(normalizedName, appRoot);
-        return;
+      logger.compiler("launching Anaemia project initialization wizard...");
+
+      const response = await prompts([
+        {
+          type: target ? null : "text",
+          name: "projectName",
+          message: "Project name:",
+          initial: "anaemia-app",
+        },
+        {
+          type: "select",
+          name: "variant",
+          message: "Select a variant:",
+          choices: [
+            { title: pc.blue("TypeScript (Recommended)"), value: "ts" },
+            { title: pc.yellow("JavaScript"), value: "js" },
+          ],
+          initial: 0,
+        },
+      ]);
+
+      if (!response.variant && response.variant !== 0) {
+        logger.warn("project creation aborted.");
+        process.exit(0);
       }
 
-      logger.error(`unknown layout generator type "${type}". Supported variants: "feature:", "component:", "page:", "hook:"`);
-      process.exit(1);
-    }
-
-    logger.compiler("launching Anaemia project initialization wizard...");
-
-    const response = await prompts([
-      {
-        type: target ? null : "text",
-        name: "projectName",
-        message: "Project name:",
-        initial: "anaemia-app",
-      },
-      {
-        type: "select",
-        name: "variant",
-        message: "Select a variant:",
-        choices: [
-          { title: pc.blue("TypeScript (Recommended)"), value: "ts" },
-          { title: pc.yellow("JavaScript"), value: "js" },
-        ],
-        initial: 0,
-      },
-    ]);
-
-    if (!response.variant && response.variant !== 0) {
-      logger.warn("project creation aborted.");
-      process.exit(0);
-    }
-
-    const targetDir = target || response.projectName;
-    const targetPath = path.resolve(appRoot, targetDir);
-
-    if (fs.existsSync(targetPath)) {
-      const files = fs.readdirSync(targetPath);
-      if (files.length > 0) {
-        const { overwrite } = await prompts({
-          type: "confirm",
-          name: "overwrite",
-          message: `target directory "${targetDir}" is not empty. remove existing files and continue?`,
-          initial: false,
-        });
+      const targetDir = target || response.projectName;
+      const targetPath = path.resolve(appRoot, targetDir);
+
+      if (fs.existsSync(targetPath)) {
+        const files = fs.readdirSync(targetPath);
+        if (files.length > 0) {
+          const { overwrite } = await prompts({
+            type: "confirm",
+            name: "overwrite",
+            message: `target directory "${targetDir}" is not empty. remove existing files and continue?`,
+            initial: false,
+          });
+
+          if (!overwrite) {
+            logger.error("aborted to protect existing project directory.");
+            process.exit(1);
+          }
 
-        if (!overwrite) {
-          logger.error("aborted to protect existing project directory.");
-          process.exit(1);
+          logger.warn(`purging existing files inside ${targetDir}...`);
+          fs.rmSync(targetPath, { recursive: true, force: true });
+          fs.mkdirSync(targetPath, { recursive: true });
         }
-
-        logger.warn(`purging existing files inside ${targetDir}...`);
-        fs.rmSync(targetPath, { recursive: true, force: true });
+      } else {
         fs.mkdirSync(targetPath, { recursive: true });
       }
-    } else {
-      fs.mkdirSync(targetPath, { recursive: true });
-    }
-
-    let templatePath = path.resolve(__dirname, "../templates/template-base");
-    if (!fs.existsSync(templatePath)) {
-      templatePath = path.resolve(__dirname, "../templates/base-app");
-    }
-
-    if (fs.existsSync(templatePath)) {
-      logger.info("unpacking localized scaffolding architecture layout structures...");
-      fs.cpSync(templatePath, targetPath, {
-        recursive: true,
-        filter: (src) => !["node_modules", "dist", ".anaemia", ".rspack"].includes(path.basename(src)),
-      });
-    } else {
-      logger.warn("local templates missing. fetching remote registry packages over the network...");
-      const userAgent = process.env.npm_config_user_agent || "";
-      let packageManager = "npm";
-      if (userAgent.includes("pnpm")) packageManager = "pnpm";
-      else if (userAgent.includes("yarn")) packageManager = "yarn";
-
-      try {
-        if (packageManager === "pnpm") {
-          execSync(`pnpm dlx degit colourlabs/anaemia/templates/base-app "${targetPath}"`, { stdio: "ignore" });
-        } else {
-          execSync(`npx degit colourlabs/anaemia/templates/base-app "${targetPath}"`, { stdio: "ignore" });
-        }
-      } catch (err) {
-        logger.error("could not source template workspace assets locally or from network registry nodes. " + err);
-        process.exit(1);
-      }
-    }
-
-    const removeGitKeepFiles = (dir: string) => {
-      const files = fs.readdirSync(dir);
-      for (const file of files) {
-        const fullPath = path.join(dir, file);
-        if (fs.statSync(fullPath).isDirectory()) {
-          removeGitKeepFiles(fullPath);
-        } else if (file === ".gitkeep") {
-          fs.unlinkSync(fullPath);
-        }
+
+      let templatePath = path.resolve(__dirname, "../templates/template-base");
+      if (!fs.existsSync(templatePath)) {
+        templatePath = path.resolve(__dirname, "../templates/base-app");
       }
-    };
-    removeGitKeepFiles(targetPath);
 
-    if (response.variant === "js") {
-      logger.info("converting workspace assets to vanilla JavaScript...");
+      if (fs.existsSync(templatePath)) {
+        logger.info("unpacking localized scaffolding architecture layout structures...");
+        fs.cpSync(templatePath, targetPath, {
+          recursive: true,
+          filter: (src) => !["node_modules", "dist", ".anaemia", ".rspack"].includes(path.basename(src)),
+        });
+      } else {
+        logger.info("fetching template from remote registry...");
+        await fetchTemplate(targetPath);
+      }
 
-      const convertTypeScriptToJs = (dir: string) => {
+      const removeGitKeepFiles = (dir: string) => {
         const files = fs.readdirSync(dir);
-
         for (const file of files) {
           const fullPath = path.join(dir, file);
-          const stat = fs.statSync(fullPath);
-
-          if (stat.isDirectory()) {
-            convertTypeScriptToJs(fullPath);
-          } else if (file.endsWith(".ts") || file.endsWith(".tsx")) {
-            const isTsx = file.endsWith(".tsx");
-            const code = fs.readFileSync(fullPath, "utf8");
-
-            try {
-              const compiled = transform(code, {
-                transforms: isTsx ? ["typescript", "jsx"] : ["typescript"],
-                jsxRuntime: "preserve",
-                production: true,
-              });
-
-              const newExt = isTsx ? ".jsx" : ".js";
-              const newPath = fullPath.replace(/\.tsx?$/, newExt);
-
-              fs.writeFileSync(newPath, compiled.code, "utf8");
-              fs.unlinkSync(fullPath);
-            } catch {
-              logger.warn(`failed to strip types from ${file}, skipping...`);
-            }
+          if (fs.statSync(fullPath).isDirectory()) {
+            removeGitKeepFiles(fullPath);
+          } else if (file === ".gitkeep") {
+            fs.unlinkSync(fullPath);
           }
         }
       };
+      removeGitKeepFiles(targetPath);
+
+      if (response.variant === "js") {
+        logger.info("converting workspace assets to vanilla JavaScript...");
+
+        const convertTypeScriptToJs = (dir: string) => {
+          const files = fs.readdirSync(dir);
+
+          for (const file of files) {
+            const fullPath = path.join(dir, file);
+            const stat = fs.statSync(fullPath);
+
+            if (stat.isDirectory()) {
+              convertTypeScriptToJs(fullPath);
+            } else if (file.endsWith(".ts") || file.endsWith(".tsx")) {
+              const isTsx = file.endsWith(".tsx");
+              const code = fs.readFileSync(fullPath, "utf8");
+
+              try {
+                const compiled = transform(code, {
+                  transforms: isTsx ? ["typescript", "jsx"] : ["typescript"],
+                  jsxRuntime: "preserve",
+                  production: true,
+                });
+
+                const newExt = isTsx ? ".jsx" : ".js";
+                const newPath = fullPath.replace(/\.tsx?$/, newExt);
+
+                fs.writeFileSync(newPath, compiled.code, "utf8");
+                fs.unlinkSync(fullPath);
+              } catch {
+                logger.warn(`failed to strip types from ${file}, skipping...`);
+              }
+            }
+          }
+        };
 
-      convertTypeScriptToJs(targetPath);
+        convertTypeScriptToJs(targetPath);
 
-      const tsconfigPath = path.join(targetPath, "tsconfig.json");
-      if (fs.existsSync(tsconfigPath)) {
-        fs.unlinkSync(tsconfigPath);
+        const tsconfigPath = path.join(targetPath, "tsconfig.json");
+        if (fs.existsSync(tsconfigPath)) {
+          fs.unlinkSync(tsconfigPath);
+        }
       }
-    }
-
-    const pkgJsonPath = path.join(targetPath, "package.json");
-    if (fs.existsSync(pkgJsonPath)) {
-      try {
-        const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
-        pkg.name = path.basename(targetPath);
-
-        if (response.variant === "js") {
-          if (pkg.devDependencies) {
-            delete pkg.devDependencies["typescript"];
-            delete pkg.devDependencies["@types/node"];
-            delete pkg.devDependencies["@typescript-eslint/eslint-plugin"];
-            delete pkg.devDependencies["@typescript-eslint/parser"];
-          }
-          if (pkg.scripts && pkg.scripts.typecheck) {
-            delete pkg.scripts.typecheck;
+
+      const pkgJsonPath = path.join(targetPath, "package.json");
+      if (fs.existsSync(pkgJsonPath)) {
+        try {
+          const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
+          pkg.name = path.basename(targetPath);
+
+          if (response.variant === "js") {
+            if (pkg.devDependencies) {
+              delete pkg.devDependencies["typescript"];
+              delete pkg.devDependencies["@types/node"];
+              delete pkg.devDependencies["@typescript-eslint/eslint-plugin"];
+              delete pkg.devDependencies["@typescript-eslint/parser"];
+            }
+            if (pkg.scripts && pkg.scripts.typecheck) {
+              delete pkg.scripts.typecheck;
+            }
           }
-        }
 
-        fs.writeFileSync(pkgJsonPath, JSON.stringify(pkg, null, 2), "utf8");
-      } catch (err) {
-        logger.error("failed rewriting package.json manifest structures:", err);
+          fs.writeFileSync(pkgJsonPath, JSON.stringify(pkg, null, 2), "utf8");
+        } catch (err) {
+          logger.error("failed rewriting package.json manifest structures:", err);
+        }
       }
-    }
 
-    logger.success(`\n🎉 project successfully scaffolded into ${pc.magenta(targetDir)}!`);
-    console.log(pc.dim("\nfollow these steps to begin execution:\n"));
+      logger.success(`\n🎉 project successfully scaffolded into ${pc.magenta(targetDir)}!`);
+      console.log(pc.dim("\nfollow these steps to begin execution:\n"));
 
-    if (targetDir !== ".") {
-      console.log(`  cd ${pc.cyan(targetDir)}`);
-    }
-    console.log(`  ${pc.cyan("pnpm install")}    ${pc.dim("# or npm i / yarn install")}`);
-    console.log(`  ${pc.cyan("pnpm dev")}        ${pc.dim("# launches hot reload server")}\n`);
-  });
-
-};
+      if (targetDir !== ".") {
+        console.log(`  cd ${pc.cyan(targetDir)}`);
+      }
+      console.log(`  ${pc.cyan("pnpm install")}    ${pc.dim("# or npm i / yarn install")}`);
+      console.log(`  ${pc.cyan("pnpm dev")}        ${pc.dim("# launches hot reload server")}\n`);
+    });
+}

package/src/commands/dev.ts

@@ -58,19 +58,15 @@ export function register(cli: CAC) {
       }
 
       setTimeout(() => {
-        serverProcess = spawn(
-          "node",
-          ["--enable-source-maps", path.resolve(appRoot, "./dist/server/index.js")],
-          {
-            stdio: "inherit",
-            env: {
-              ...process.env,
-              NODE_ENV: "development",
-              PORT: String(targetPort),
-              RSPACK_DEV_PORT: String(targetPort + 1),
-            },
-          }
-        );
+        serverProcess = spawn("node", ["--enable-source-maps", path.resolve(appRoot, "./dist/server/index.js")], {
+          stdio: "inherit",
+          env: {
+            ...process.env,
+            NODE_ENV: "development",
+            PORT: String(targetPort),
+            RSPACK_DEV_PORT: String(targetPort + 1),
+          },
+        });
       }, 200);
     };
 

package/src/commands/typecheck.ts

@@ -7,4 +7,4 @@ export function register(cli: CAC) {
     const result = spawn.sync("tsc", ["--noEmit"], { stdio: "inherit", cwd: appRoot });
     if (result.status !== 0) process.exit(result.status ?? 1);
   });
-};
+}

package/src/types/rspack-dev-server.d.ts

@@ -12,4 +12,4 @@ declare module "@rspack/dev-server" {
   }
 
   export default RspackDevServer;
-}
+}

package/src/utils/fetch-template.ts

@@ -0,0 +1,37 @@
+import * as tar from "tar";
+import logger from "./logger.js";
+
+const TAR_URL = "https://codeload.github.com/colourlabs/anaemia/tar.gz/main";
+
+export async function fetchTemplate(targetPath: string): Promise<void> {
+  logger.info("downloading template...");
+
+  const res = await fetch(TAR_URL);
+  if (!res.ok) throw new Error(`failed to download template: ${res.statusText}`);
+
+  await new Promise<void>((resolve, reject) => {
+    const extract = tar.extract({
+      cwd: targetPath,
+      strip: 2,
+      filter: (p: string) => p.startsWith("anaemia-main/templates/base-app"),
+    });
+
+    extract.on("finish", resolve);
+    extract.on("error", reject);
+
+    const reader = res.body!.getReader();
+
+    const pump = async () => {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+          extract.end();
+          break;
+        }
+        extract.write(value);
+      }
+    };
+
+    pump().catch(reject);
+  });
+}