@akanjs/devkit 0.0.137 → 0.0.139

package/cjs/src/aiEditor.js

@@ -33,11 +33,11 @@ __export(aiEditor_exports, {
 module.exports = __toCommonJS(aiEditor_exports);
 var import_common = require("@akanjs/common");
 var import_prompts = require("@inquirer/prompts");
-var import_ora = __toESM(require("ora"));
 var import_messages = require("@langchain/core/messages");
 var import_openai = require("@langchain/openai");
 var import_chalk = __toESM(require("chalk"));
 var import_auth = require("./auth");
+var import_spinner = require("./spinner");
 const MAX_ASK_TRY = 300;
 const supportedLlmModels = ["deepseek-chat", "deepseek-reasoner"];
 class AiSession {
@@ -45,8 +45,11 @@ class AiSession {
   static async init({ temperature = 0.7, useExisting = true } = {}) {
     if (useExisting) {
       const llmConfig2 = this.getLlmConfig();
-      if (llmConfig2)
-        return this.#setChatModel(llmConfig2.model, llmConfig2.apiKey);
+      if (llmConfig2) {
+        this.#setChatModel(llmConfig2.model, llmConfig2.apiKey);
+        import_common.Logger.rawLog(import_chalk.default.dim(`\u{1F916}akan editor uses existing LLM config (${llmConfig2.model})`));
+        return this;
+      }
     }
     const llmConfig = await this.#requestLlmConfig();
     const { model, apiKey } = llmConfig;
@@ -78,6 +81,7 @@ class AiSession {
     return { model, apiKey };
   }
   static async #validateApiKey(modelName, apiKey) {
+    const spinner = new import_spinner.Spinner("Validating LLM API key...", { prefix: `\u{1F916}akan-editor` }).start();
     const chat = new import_openai.ChatOpenAI({
       modelName,
       temperature: 0,
@@ -85,9 +89,10 @@ class AiSession {
     });
     try {
       await chat.invoke("Hi, and just say 'ok'");
+      spinner.succeed("LLM API key is valid");
       return true;
     } catch (error) {
-      import_common.Logger.rawLog(
+      spinner.fail(
         import_chalk.default.red(
           `LLM API key is invalid. Please check your API key and try again. You can set it again by running "akan set-llm" or reset by running "akan reset-llm"`
         )
@@ -108,14 +113,16 @@ class AiSession {
       await AiSession.init();
     if (!AiSession.#chat)
       throw new Error("Failed to initialize the AI session");
-    const loader = (0, import_ora.default)(`${AiSession.#chat.model} is thinking...`).start();
+    const loader = new import_spinner.Spinner(`${AiSession.#chat.model} is thinking...`, {
+      prefix: `\u{1F916}akan-editor`
+    }).start();
     try {
       const humanMessage = new import_messages.HumanMessage(question);
       this.messageHistory.push(humanMessage);
       const stream = await AiSession.#chat.stream(this.messageHistory);
       let fullResponse = "", tokenIdx = 0;
       for await (const chunk of stream) {
-        if (loader.isSpinning)
+        if (loader.isSpinning())
           loader.succeed(`${AiSession.#chat.model} responded`);
         const content = chunk.content;
         if (typeof content === "string") {

package/cjs/src/commandDecorators/command.js

@@ -184,6 +184,7 @@ const runCommands = async (...commands) => {
             `${sysType} in this workspace ${sysType}s/<${sysType}Name>`
           );
         }
+        programCommand = programCommand.option(`-v, --verbose [boolean]`, `verbose output`);
         programCommand.action(async (...args) => {
           const cmdArgs = args.slice(0, args.length - 2);
           const opt = args[args.length - 2];
@@ -196,6 +197,8 @@ const runCommands = async (...commands) => {
               commandArgs[argMeta.idx] = await getArgumentValue(argMeta, cmdArgs[argMeta.idx], workspace);
             if (commandArgs[argMeta.idx] instanceof import_executors.AppExecutor)
               process.env.NEXT_PUBLIC_APP_NAME = commandArgs[argMeta.idx].name;
+            if (opt.verbose)
+              import_executors.Executor.setVerbose(true);
           }
           const cmd = new command();
           try {

package/cjs/src/executors.js

@@ -32,7 +32,8 @@ __export(executors_exports, {
   LibExecutor: () => LibExecutor,
   PkgExecutor: () => PkgExecutor,
   SysExecutor: () => SysExecutor,
-  WorkspaceExecutor: () => WorkspaceExecutor
+  WorkspaceExecutor: () => WorkspaceExecutor,
+  execEmoji: () => execEmoji
 });
 module.exports = __toCommonJS(executors_exports);
 var import_common = require("@akanjs/common");
@@ -44,10 +45,25 @@ var import_fs = __toESM(require("fs"));
 var import_promises = __toESM(require("fs/promises"));
 var import_path = __toESM(require("path"));
 var import_dependencyScanner = require("./dependencyScanner");
+var import_spinner = require("./spinner");
+const execEmoji = {
+  workspace: "\u{1F3E0}",
+  app: "\u{1F680}",
+  lib: "\u{1F527}",
+  pkg: "\u{1F4E6}",
+  dist: "\u{1F4BF}",
+  default: "\u2708\uFE0F"
+  // for sys executor
+};
 class Executor {
+  static verbose = false;
+  static setVerbose(verbose) {
+    Executor.verbose = verbose;
+  }
   name;
   logger;
   cwdPath;
+  emoji = execEmoji.default;
   constructor(name, cwdPath) {
     this.name = name;
     this.logger = new import_common.Logger(name);
@@ -73,7 +89,11 @@ class Executor {
     });
   }
   spawn(command, args = [], options = {}) {
-    const proc = (0, import_child_process.spawn)(command, args, { cwd: this.cwdPath, stdio: "inherit", ...options });
+    const proc = (0, import_child_process.spawn)(command, args, {
+      cwd: this.cwdPath,
+      stdio: Executor.verbose ? "inherit" : "ignore",
+      ...options
+    });
     proc.stdout?.on("data", (data) => {
       import_common.Logger.raw(import_chalk.default.dim(data.toString()));
     });
@@ -92,7 +112,7 @@ class Executor {
   fork(modulePath, args = [], options = {}) {
     const proc = (0, import_child_process.fork)(modulePath, args, {
       cwd: this.cwdPath,
-      stdio: ["ignore", "inherit", "inherit", "ipc"],
+      stdio: Executor.verbose ? ["ignore", "inherit", "inherit", "ipc"] : ["ignore", "ignore", "ignore", "ipc"],
       ...options
     });
     proc.stdout?.on("data", (data) => {
@@ -174,6 +194,9 @@ class Executor {
     this.logger.verbose(msg);
     return this;
   }
+  spinning(msg, { prefix = `${this.emoji}${this.name}`, indent = 0, enableSpin = !Executor.verbose } = {}) {
+    return new import_spinner.Spinner(msg, { prefix, indent, enableSpin }).start();
+  }
   getTsConfig(pathname = "tsconfig.json") {
     const tsconfig = this.readJson(pathname);
     if (tsconfig.extends) {
@@ -260,8 +283,9 @@ class Executor {
 class WorkspaceExecutor extends Executor {
   workspaceRoot;
   repoName;
+  emoji = execEmoji.workspace;
   constructor({ workspaceRoot, repoName }) {
-    super(`${repoName} Executor`, workspaceRoot);
+    super("workspace", workspaceRoot);
     this.workspaceRoot = workspaceRoot;
     this.repoName = repoName;
   }
@@ -416,11 +440,13 @@ class SysExecutor extends Executor {
   workspace;
   name;
   type;
+  emoji;
   constructor({ workspace = WorkspaceExecutor.fromRoot(), name, type }) {
-    super(`${name} Sys Executor`, `${workspace.workspaceRoot}/${type}s/${name}`);
+    super(name, `${workspace.workspaceRoot}/${type}s/${name}`);
     this.workspace = workspace;
     this.name = name;
     this.type = type;
+    this.emoji = execEmoji[type];
   }
   async getConfig(command) {
     return this.type === "app" ? await (0, import_config.getAppConfig)(this.cwdPath, { ...this.workspace.getBaseDevEnv(), type: "app", name: this.name, command }) : await (0, import_config.getLibConfig)(this.cwdPath, { ...this.workspace.getBaseDevEnv(), type: "lib", name: this.name, command });
@@ -641,15 +667,19 @@ class SysExecutor extends Executor {
 }
 class AppExecutor extends SysExecutor {
   dist;
+  emoji = execEmoji.app;
   constructor({ workspace, name }) {
     super({ workspace, name, type: "app" });
-    this.dist = new Executor(`${name} Dist App Executor`, `${this.workspace.workspaceRoot}/dist/apps/${name}`);
+    this.dist = new Executor(`dist/${name}`, `${this.workspace.workspaceRoot}/dist/apps/${name}`);
   }
   static from(executor, name) {
     if (executor instanceof WorkspaceExecutor)
       return new AppExecutor({ workspace: executor, name });
     return new AppExecutor({ workspace: executor.workspace, name });
   }
+  getEnv() {
+    return this.workspace.getBaseDevEnv().env;
+  }
   async getConfig(command) {
     return await (0, import_config.getAppConfig)(this.cwdPath, {
       ...this.workspace.getBaseDevEnv(),
@@ -677,9 +707,10 @@ class LibExecutor extends SysExecutor {
   workspaceRoot;
   repoName;
   dist;
+  emoji = execEmoji.lib;
   constructor({ workspace, name }) {
     super({ workspace, name, type: "lib" });
-    this.dist = new Executor(`${name} Dist Lib Executor`, `${this.workspace.workspaceRoot}/dist/libs/${name}`);
+    this.dist = new Executor(`dist/${name}`, `${this.workspace.workspaceRoot}/dist/libs/${name}`);
   }
   static from(executor, name) {
     if (executor instanceof WorkspaceExecutor)
@@ -699,11 +730,12 @@ class PkgExecutor extends Executor {
   workspace;
   name;
   dist;
+  emoji = execEmoji.pkg;
   constructor({ workspace = WorkspaceExecutor.fromRoot(), name }) {
-    super(`${name} Pkg Executor`, `${workspace.workspaceRoot}/pkgs/${name}`);
+    super(name, `${workspace.workspaceRoot}/pkgs/${name}`);
     this.workspace = workspace;
     this.name = name;
-    this.dist = new Executor(`${name} Dist Pkg Executor`, `${this.workspace.workspaceRoot}/dist/pkgs/${name}`);
+    this.dist = new Executor(`dist/${name}`, `${this.workspace.workspaceRoot}/dist/pkgs/${name}`);
   }
   static from(executor, name) {
     if (executor instanceof WorkspaceExecutor)
@@ -740,5 +772,6 @@ class PkgExecutor extends Executor {
   LibExecutor,
   PkgExecutor,
   SysExecutor,
-  WorkspaceExecutor
+  WorkspaceExecutor,
+  execEmoji
 });

package/cjs/src/index.js

@@ -31,6 +31,7 @@ __reExport(src_exports, require("./extractDeps"), module.exports);
 __reExport(src_exports, require("./commandDecorators"), module.exports);
 __reExport(src_exports, require("./aiEditor"), module.exports);
 __reExport(src_exports, require("./builder"), module.exports);
+__reExport(src_exports, require("./spinner"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./createTunnel"),
@@ -49,5 +50,6 @@ __reExport(src_exports, require("./builder"), module.exports);
   ...require("./extractDeps"),
   ...require("./commandDecorators"),
   ...require("./aiEditor"),
-  ...require("./builder")
+  ...require("./builder"),
+  ...require("./spinner")
 });

package/cjs/src/spinner.js

@@ -0,0 +1,93 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var spinner_exports = {};
+__export(spinner_exports, {
+  Spinner: () => Spinner
+});
+module.exports = __toCommonJS(spinner_exports);
+var import_ora = __toESM(require("ora"));
+class Spinner {
+  static padding = 12;
+  spinner;
+  stopWatch;
+  startAt;
+  prefix;
+  message;
+  enableSpin;
+  constructor(message, { prefix = "", indent = 0, enableSpin = true } = {}) {
+    Spinner.padding = Math.max(Spinner.padding, prefix.length);
+    this.prefix = prefix;
+    this.message = message;
+    this.spinner = (0, import_ora.default)(message);
+    this.spinner.prefixText = prefix.padStart(Spinner.padding, " ");
+    this.spinner.indent = indent;
+    this.enableSpin = enableSpin;
+  }
+  start() {
+    this.startAt = /* @__PURE__ */ new Date();
+    if (this.enableSpin) {
+      this.spinner.start();
+      this.stopWatch = setInterval(() => {
+        this.spinner.prefixText = this.prefix.padStart(Spinner.padding, " ");
+        this.spinner.text = `${this.message} (${this.#getElapsedTimeStr()})`;
+      }, 1e3);
+    } else
+      this.spinner.info();
+    return this;
+  }
+  succeed(message) {
+    this.spinner.succeed(`${message} (${this.#getElapsedTimeStr()})`);
+    this.#reset();
+  }
+  fail(message) {
+    this.spinner.fail(`${message} (${this.#getElapsedTimeStr()})`);
+    this.#reset();
+  }
+  isSpinning() {
+    return this.spinner.isSpinning;
+  }
+  #reset() {
+    if (this.stopWatch)
+      clearInterval(this.stopWatch);
+    this.stopWatch = null;
+  }
+  #getElapsedTimeStr() {
+    const ms = (/* @__PURE__ */ new Date()).getTime() - this.startAt.getTime();
+    if (ms < 1e3)
+      return `${ms}ms`;
+    const s = Math.floor(ms / 1e3);
+    if (s < 60)
+      return `${s}s`;
+    const m = Math.floor(s / 60);
+    return `${m}m ${s % 60}s`;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Spinner
+});

package/esm/src/aiEditor.js

@@ -1,10 +1,10 @@
 import { Logger } from "@akanjs/common";
 import { input, select } from "@inquirer/prompts";
-import ora from "ora";
 import { AIMessage, HumanMessage } from "@langchain/core/messages";
 import { ChatOpenAI } from "@langchain/openai";
 import chalk from "chalk";
 import { getAkanGlobalConfig, setAkanGlobalConfig } from "./auth";
+import { Spinner } from "./spinner";
 const MAX_ASK_TRY = 300;
 const supportedLlmModels = ["deepseek-chat", "deepseek-reasoner"];
 class AiSession {
@@ -12,8 +12,11 @@ class AiSession {
   static async init({ temperature = 0.7, useExisting = true } = {}) {
     if (useExisting) {
       const llmConfig2 = this.getLlmConfig();
-      if (llmConfig2)
-        return this.#setChatModel(llmConfig2.model, llmConfig2.apiKey);
+      if (llmConfig2) {
+        this.#setChatModel(llmConfig2.model, llmConfig2.apiKey);
+        Logger.rawLog(chalk.dim(`\u{1F916}akan editor uses existing LLM config (${llmConfig2.model})`));
+        return this;
+      }
     }
     const llmConfig = await this.#requestLlmConfig();
     const { model, apiKey } = llmConfig;
@@ -45,6 +48,7 @@ class AiSession {
     return { model, apiKey };
   }
   static async #validateApiKey(modelName, apiKey) {
+    const spinner = new Spinner("Validating LLM API key...", { prefix: `\u{1F916}akan-editor` }).start();
     const chat = new ChatOpenAI({
       modelName,
       temperature: 0,
@@ -52,9 +56,10 @@ class AiSession {
     });
     try {
       await chat.invoke("Hi, and just say 'ok'");
+      spinner.succeed("LLM API key is valid");
       return true;
     } catch (error) {
-      Logger.rawLog(
+      spinner.fail(
         chalk.red(
           `LLM API key is invalid. Please check your API key and try again. You can set it again by running "akan set-llm" or reset by running "akan reset-llm"`
         )
@@ -75,14 +80,16 @@ class AiSession {
       await AiSession.init();
     if (!AiSession.#chat)
       throw new Error("Failed to initialize the AI session");
-    const loader = ora(`${AiSession.#chat.model} is thinking...`).start();
+    const loader = new Spinner(`${AiSession.#chat.model} is thinking...`, {
+      prefix: `\u{1F916}akan-editor`
+    }).start();
     try {
       const humanMessage = new HumanMessage(question);
       this.messageHistory.push(humanMessage);
       const stream = await AiSession.#chat.stream(this.messageHistory);
       let fullResponse = "", tokenIdx = 0;
       for await (const chunk of stream) {
-        if (loader.isSpinning)
+        if (loader.isSpinning())
           loader.succeed(`${AiSession.#chat.model} responded`);
         const content = chunk.content;
         if (typeof content === "string") {

package/esm/src/commandDecorators/command.js

@@ -3,7 +3,7 @@ import { confirm, input, select } from "@inquirer/prompts";
 import chalk from "chalk";
 import { program } from "commander";
 import fs from "fs";
-import { AppExecutor, LibExecutor, PkgExecutor, WorkspaceExecutor } from "../executors";
+import { AppExecutor, Executor, LibExecutor, PkgExecutor, WorkspaceExecutor } from "../executors";
 import { getArgMetas } from "./argMeta";
 import { getTargetMetas } from "./targetMeta";
 const camelToKebabCase = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
@@ -152,6 +152,7 @@ const runCommands = async (...commands) => {
             `${sysType} in this workspace ${sysType}s/<${sysType}Name>`
           );
         }
+        programCommand = programCommand.option(`-v, --verbose [boolean]`, `verbose output`);
         programCommand.action(async (...args) => {
           const cmdArgs = args.slice(0, args.length - 2);
           const opt = args[args.length - 2];
@@ -164,6 +165,8 @@ const runCommands = async (...commands) => {
               commandArgs[argMeta.idx] = await getArgumentValue(argMeta, cmdArgs[argMeta.idx], workspace);
             if (commandArgs[argMeta.idx] instanceof AppExecutor)
               process.env.NEXT_PUBLIC_APP_NAME = commandArgs[argMeta.idx].name;
+            if (opt.verbose)
+              Executor.setVerbose(true);
           }
           const cmd = new command();
           try {

package/esm/src/executors.js

@@ -11,10 +11,25 @@ import fs from "fs";
 import fsPromise from "fs/promises";
 import path from "path";
 import { TypeScriptDependencyScanner } from "./dependencyScanner";
+import { Spinner } from "./spinner";
+const execEmoji = {
+  workspace: "\u{1F3E0}",
+  app: "\u{1F680}",
+  lib: "\u{1F527}",
+  pkg: "\u{1F4E6}",
+  dist: "\u{1F4BF}",
+  default: "\u2708\uFE0F"
+  // for sys executor
+};
 class Executor {
+  static verbose = false;
+  static setVerbose(verbose) {
+    Executor.verbose = verbose;
+  }
   name;
   logger;
   cwdPath;
+  emoji = execEmoji.default;
   constructor(name, cwdPath) {
     this.name = name;
     this.logger = new Logger(name);
@@ -40,7 +55,11 @@ class Executor {
     });
   }
   spawn(command, args = [], options = {}) {
-    const proc = spawn(command, args, { cwd: this.cwdPath, stdio: "inherit", ...options });
+    const proc = spawn(command, args, {
+      cwd: this.cwdPath,
+      stdio: Executor.verbose ? "inherit" : "ignore",
+      ...options
+    });
     proc.stdout?.on("data", (data) => {
       Logger.raw(chalk.dim(data.toString()));
     });
@@ -59,7 +78,7 @@ class Executor {
   fork(modulePath, args = [], options = {}) {
     const proc = fork(modulePath, args, {
       cwd: this.cwdPath,
-      stdio: ["ignore", "inherit", "inherit", "ipc"],
+      stdio: Executor.verbose ? ["ignore", "inherit", "inherit", "ipc"] : ["ignore", "ignore", "ignore", "ipc"],
       ...options
     });
     proc.stdout?.on("data", (data) => {
@@ -141,6 +160,9 @@ class Executor {
     this.logger.verbose(msg);
     return this;
   }
+  spinning(msg, { prefix = `${this.emoji}${this.name}`, indent = 0, enableSpin = !Executor.verbose } = {}) {
+    return new Spinner(msg, { prefix, indent, enableSpin }).start();
+  }
   getTsConfig(pathname = "tsconfig.json") {
     const tsconfig = this.readJson(pathname);
     if (tsconfig.extends) {
@@ -227,8 +249,9 @@ class Executor {
 class WorkspaceExecutor extends Executor {
   workspaceRoot;
   repoName;
+  emoji = execEmoji.workspace;
   constructor({ workspaceRoot, repoName }) {
-    super(`${repoName} Executor`, workspaceRoot);
+    super("workspace", workspaceRoot);
     this.workspaceRoot = workspaceRoot;
     this.repoName = repoName;
   }
@@ -383,11 +406,13 @@ class SysExecutor extends Executor {
   workspace;
   name;
   type;
+  emoji;
   constructor({ workspace = WorkspaceExecutor.fromRoot(), name, type }) {
-    super(`${name} Sys Executor`, `${workspace.workspaceRoot}/${type}s/${name}`);
+    super(name, `${workspace.workspaceRoot}/${type}s/${name}`);
     this.workspace = workspace;
     this.name = name;
     this.type = type;
+    this.emoji = execEmoji[type];
   }
   async getConfig(command) {
     return this.type === "app" ? await getAppConfig(this.cwdPath, { ...this.workspace.getBaseDevEnv(), type: "app", name: this.name, command }) : await getLibConfig(this.cwdPath, { ...this.workspace.getBaseDevEnv(), type: "lib", name: this.name, command });
@@ -608,15 +633,19 @@ class SysExecutor extends Executor {
 }
 class AppExecutor extends SysExecutor {
   dist;
+  emoji = execEmoji.app;
   constructor({ workspace, name }) {
     super({ workspace, name, type: "app" });
-    this.dist = new Executor(`${name} Dist App Executor`, `${this.workspace.workspaceRoot}/dist/apps/${name}`);
+    this.dist = new Executor(`dist/${name}`, `${this.workspace.workspaceRoot}/dist/apps/${name}`);
   }
   static from(executor, name) {
     if (executor instanceof WorkspaceExecutor)
       return new AppExecutor({ workspace: executor, name });
     return new AppExecutor({ workspace: executor.workspace, name });
   }
+  getEnv() {
+    return this.workspace.getBaseDevEnv().env;
+  }
   async getConfig(command) {
     return await getAppConfig(this.cwdPath, {
       ...this.workspace.getBaseDevEnv(),
@@ -644,9 +673,10 @@ class LibExecutor extends SysExecutor {
   workspaceRoot;
   repoName;
   dist;
+  emoji = execEmoji.lib;
   constructor({ workspace, name }) {
     super({ workspace, name, type: "lib" });
-    this.dist = new Executor(`${name} Dist Lib Executor`, `${this.workspace.workspaceRoot}/dist/libs/${name}`);
+    this.dist = new Executor(`dist/${name}`, `${this.workspace.workspaceRoot}/dist/libs/${name}`);
   }
   static from(executor, name) {
     if (executor instanceof WorkspaceExecutor)
@@ -666,11 +696,12 @@ class PkgExecutor extends Executor {
   workspace;
   name;
   dist;
+  emoji = execEmoji.pkg;
   constructor({ workspace = WorkspaceExecutor.fromRoot(), name }) {
-    super(`${name} Pkg Executor`, `${workspace.workspaceRoot}/pkgs/${name}`);
+    super(name, `${workspace.workspaceRoot}/pkgs/${name}`);
     this.workspace = workspace;
     this.name = name;
-    this.dist = new Executor(`${name} Dist Pkg Executor`, `${this.workspace.workspaceRoot}/dist/pkgs/${name}`);
+    this.dist = new Executor(`dist/${name}`, `${this.workspace.workspaceRoot}/dist/pkgs/${name}`);
   }
   static from(executor, name) {
     if (executor instanceof WorkspaceExecutor)
@@ -706,5 +737,6 @@ export {
   LibExecutor,
   PkgExecutor,
   SysExecutor,
-  WorkspaceExecutor
+  WorkspaceExecutor,
+  execEmoji
 };

package/esm/src/index.js

@@ -15,3 +15,4 @@ export * from "./extractDeps";
 export * from "./commandDecorators";
 export * from "./aiEditor";
 export * from "./builder";
+export * from "./spinner";

package/esm/src/spinner.js

@@ -0,0 +1,60 @@
+import ora from "ora";
+class Spinner {
+  static padding = 12;
+  spinner;
+  stopWatch;
+  startAt;
+  prefix;
+  message;
+  enableSpin;
+  constructor(message, { prefix = "", indent = 0, enableSpin = true } = {}) {
+    Spinner.padding = Math.max(Spinner.padding, prefix.length);
+    this.prefix = prefix;
+    this.message = message;
+    this.spinner = ora(message);
+    this.spinner.prefixText = prefix.padStart(Spinner.padding, " ");
+    this.spinner.indent = indent;
+    this.enableSpin = enableSpin;
+  }
+  start() {
+    this.startAt = /* @__PURE__ */ new Date();
+    if (this.enableSpin) {
+      this.spinner.start();
+      this.stopWatch = setInterval(() => {
+        this.spinner.prefixText = this.prefix.padStart(Spinner.padding, " ");
+        this.spinner.text = `${this.message} (${this.#getElapsedTimeStr()})`;
+      }, 1e3);
+    } else
+      this.spinner.info();
+    return this;
+  }
+  succeed(message) {
+    this.spinner.succeed(`${message} (${this.#getElapsedTimeStr()})`);
+    this.#reset();
+  }
+  fail(message) {
+    this.spinner.fail(`${message} (${this.#getElapsedTimeStr()})`);
+    this.#reset();
+  }
+  isSpinning() {
+    return this.spinner.isSpinning;
+  }
+  #reset() {
+    if (this.stopWatch)
+      clearInterval(this.stopWatch);
+    this.stopWatch = null;
+  }
+  #getElapsedTimeStr() {
+    const ms = (/* @__PURE__ */ new Date()).getTime() - this.startAt.getTime();
+    if (ms < 1e3)
+      return `${ms}ms`;
+    const s = Math.floor(ms / 1e3);
+    if (s < 60)
+      return `${s}s`;
+    const m = Math.floor(s / 60);
+    return `${m}m ${s % 60}s`;
+  }
+}
+export {
+  Spinner
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/devkit",
-  "version": "0.0.137",
+  "version": "0.0.139",
   "sourceType": "module",
   "publishConfig": {
     "access": "public"

package/src/executors.d.ts

@@ -1,12 +1,24 @@
 import { Logger } from "@akanjs/common";
 import { type AppConfigResult, AppScanResult, type LibConfigResult, LibScanResult, PkgScanResult, WorkspaceScanResult } from "@akanjs/config";
 import { type ExecOptions, type ForkOptions, type SpawnOptions } from "child_process";
+import { Spinner } from "./spinner";
 import type { PackageJson, TsConfigJson } from "./types";
+export declare const execEmoji: {
+    workspace: string;
+    app: string;
+    lib: string;
+    pkg: string;
+    dist: string;
+    default: string;
+};
 export declare class Executor {
     #private;
+    static verbose: boolean;
+    static setVerbose(verbose: boolean): void;
     name: string;
     logger: Logger;
     cwdPath: string;
+    emoji: string;
     constructor(name: string, cwdPath: string);
     exec(command: string, options?: ExecOptions): Promise<unknown>;
     spawn(command: string, args?: string[], options?: SpawnOptions): Promise<{
@@ -29,6 +41,11 @@ export declare class Executor {
     cp(srcPath: string, destPath: string): Promise<void>;
     log(msg: string): this;
     verbose(msg: string): this;
+    spinning(msg: string, { prefix, indent, enableSpin }?: {
+        prefix?: string | undefined;
+        indent?: number | undefined;
+        enableSpin?: boolean | undefined;
+    }): Spinner;
     getTsConfig(pathname?: string): TsConfigJson;
     applyTemplate({ basePath, template, scanResult, dict, overwrite, }: {
         basePath: string;
@@ -48,6 +65,7 @@ export declare class WorkspaceExecutor extends Executor {
     #private;
     workspaceRoot: string;
     repoName: string;
+    emoji: string;
     constructor({ workspaceRoot, repoName }: ExecutorOptions);
     static fromRoot(): WorkspaceExecutor;
     getBaseDevEnv(): {
@@ -86,6 +104,7 @@ export declare class SysExecutor extends Executor {
     workspace: WorkspaceExecutor;
     name: string;
     type: "app" | "lib";
+    emoji: string;
     constructor({ workspace, name, type }: SysExecutorOptions);
     getConfig(command?: string): Promise<LibConfigResult>;
     getModules(): Promise<string[]>;
@@ -133,8 +152,10 @@ interface AppExecutorOptions {
 }
 export declare class AppExecutor extends SysExecutor {
     dist: Executor;
+    emoji: string;
     constructor({ workspace, name }: AppExecutorOptions);
     static from(executor: SysExecutor | WorkspaceExecutor, name: string): AppExecutor;
+    getEnv(): "testing" | "local" | "debug" | "develop" | "main";
     getConfig(command?: string): Promise<AppConfigResult>;
     syncAssets(libDeps: string[]): Promise<void>;
 }
@@ -146,6 +167,7 @@ export declare class LibExecutor extends SysExecutor {
     workspaceRoot: string;
     repoName: string;
     dist: Executor;
+    emoji: string;
     constructor({ workspace, name }: LibExecutorOptions);
     static from(executor: SysExecutor | WorkspaceExecutor, name: string): LibExecutor;
     getConfig(command?: string): Promise<LibConfigResult>;
@@ -158,6 +180,7 @@ export declare class PkgExecutor extends Executor {
     workspace: WorkspaceExecutor;
     name: string;
     dist: Executor;
+    emoji: string;
     constructor({ workspace, name }: PkgExecutorOptions);
     static from(executor: SysExecutor | WorkspaceExecutor, name: string): PkgExecutor;
     scan({ packageJson, tsconfig, }?: {

package/src/index.d.ts

@@ -15,3 +15,4 @@ export * from "./extractDeps";
 export * from "./commandDecorators";
 export * from "./aiEditor";
 export * from "./builder";
+export * from "./spinner";

package/src/spinner.d.ts

@@ -0,0 +1,20 @@
+import ora from "ora";
+export declare class Spinner {
+    #private;
+    static padding: number;
+    spinner: ora.Ora;
+    stopWatch: NodeJS.Timeout | null;
+    startAt: Date;
+    prefix: string;
+    message: string;
+    enableSpin: boolean;
+    constructor(message: string, { prefix, indent, enableSpin }?: {
+        prefix?: string | undefined;
+        indent?: number | undefined;
+        enableSpin?: boolean | undefined;
+    });
+    start(): this;
+    succeed(message: string): void;
+    fail(message: string): void;
+    isSpinning(): boolean;
+}