tree-swing 1.0.0

package/README.md

@@ -0,0 +1,30 @@
+# Tree Swing
+
+A CLI tool for git branch management. Quickly create feature branches from origin branches with configurable prefixes.
+
+> **Requires [Bun](https://bun.sh/) installed.**
+
+## Install globally
+
+```bash
+# From the project directory
+npm install -g .
+```
+
+Or using `npm link` for development:
+
+```bash
+npm link
+```
+
+Then run from anywhere:
+
+```bash
+tree-swing
+```
+
+## Uninstall
+
+```bash
+npm uninstall -g tree-swing
+```

package/config.txt

@@ -0,0 +1,2 @@
+develop=for-dev
+staging=for-stag

package/core/input/keycodes.ts

@@ -0,0 +1,8 @@
+export enum KeyCode {
+  ESC = 27,
+  BRACKET = 91,
+  UP_ARROW = 65,
+  DOWN_ARROW = 66,
+  ENTER = 13,
+  CTRL_C = 3,
+}

package/core/input/menu.ts

@@ -0,0 +1,112 @@
+import { COLORS } from "../terminal/colors";
+import { hideCursor, showCursor } from "../terminal/cursor";
+import { clearScreen } from "../terminal/screen";
+import { KeyCode } from "./keycodes";
+import { renderColor } from "./text";
+
+interface InitMenuOptions {
+  hideCursor?: boolean;
+}
+
+export const initMenu = (options?: InitMenuOptions) => {
+  const shouldHideCursor = options?.hideCursor ?? true;
+
+  process.stdin.removeAllListeners("data");
+
+  clearScreen();
+  if (shouldHideCursor) {
+    hideCursor();
+  }
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+};
+
+export enum MENU_STATE {
+  MAIN = 1,
+}
+
+export const chooseOption = (
+  selected: number,
+  options: { id: number; label: string; value: string; isGoBack?: boolean }[],
+  props?: { title?: string },
+) => {
+  const title = props?.title ?? "Select an option:";
+
+  process.stdout.write(
+    `${renderColor(title, [COLORS.CYAN, COLORS.BOLD])} ${renderColor(
+      "(use arrow keys, press Enter to confirm)",
+      COLORS.DIM,
+    )}\n\n`,
+  );
+
+  options.forEach((option) => {
+    if (option.isGoBack) {
+      renderIsGoBackOption(option.label, option.id === selected);
+      return;
+    }
+
+    if (option.id === selected) {
+      process.stdout.write(
+        `${renderColor(" ▶ " + option.label, [COLORS.BG_GREEN, COLORS.BLACK, COLORS.BOLD])}\n`,
+      );
+    } else {
+      process.stdout.write(
+        renderColor("   " + option.label, COLORS.DIM) + "\n",
+      );
+    }
+  });
+};
+
+export const handleUpdateOptionsMenu =
+  (
+    selectedOption: number,
+    options: {
+      id: number;
+      label: string;
+      value: string;
+      action: () => Promise<void> | void;
+    }[],
+    title?: string,
+  ) =>
+  async (key: Buffer) => {
+    if (key[2] === KeyCode.DOWN_ARROW) {
+      if (selectedOption < options.length) {
+        selectedOption++;
+      } else {
+        selectedOption = 1;
+      }
+
+      clearScreen();
+      chooseOption(selectedOption, options, { title });
+    } else if (key[2] === KeyCode.UP_ARROW) {
+      if (selectedOption > 1) {
+        selectedOption--;
+      } else {
+        selectedOption = options.length;
+      }
+      clearScreen();
+      chooseOption(selectedOption, options, { title });
+    } else if (key[0] === KeyCode.ENTER) {
+      clearScreen();
+      process.stdin.removeAllListeners("data");
+
+      await options.find((option) => option.id === selectedOption)?.action();
+    } else if (key[0] === KeyCode.CTRL_C) {
+      showCursor();
+      clearScreen();
+      process.exit();
+    }
+  };
+
+const renderIsGoBackOption = (label: string, isSelected: boolean) => {
+  if (isSelected) {
+    process.stdout.write(
+      `${renderColor(" ← " + label, [COLORS.BG_RED, COLORS.BOLD])}${COLORS.RESET}\n`,
+    );
+    return;
+  }
+
+  process.stdout.write(
+    `${renderColor(" ← " + label, COLORS.RED)}${COLORS.RESET}\n`,
+  );
+};

package/core/input/question.ts

@@ -0,0 +1,29 @@
+import { showCursor } from "../terminal/cursor";
+import { createInterface } from "node:readline";
+
+export const makeQuestion = (question: string): Promise<string> => {
+  return new Promise((resolve) => {
+    showCursor();
+    process.stdin.removeAllListeners("data");
+    process.stdin.removeAllListeners("close");
+    process.stdin.removeAllListeners("end");
+
+    if (process.stdin.isPaused()) {
+      process.stdin.resume();
+    }
+
+    process.stdin.setRawMode(false);
+
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: false,
+    });
+
+    rl.question(`${question}\n > `, (answer) => {
+      rl.close();
+      rl.removeAllListeners();
+      resolve(answer);
+    });
+  });
+};

package/core/input/text.ts

@@ -0,0 +1,8 @@
+import { COLORS } from "../terminal/colors";
+
+export const renderColor = (text: string, colorCode: string | string[]) => {
+  if (Array.isArray(colorCode)) {
+    return `${colorCode.join("")}${text}${COLORS.RESET}`;
+  }
+  return `${colorCode}${text}${COLORS.RESET}`;
+};

package/core/terminal/colors.ts

@@ -0,0 +1,15 @@
+export const COLORS = {
+  RESET: "\x1b[0m",
+  BOLD: "\x1b[1m",
+  DIM: "\x1b[2m",
+  CYAN: "\x1b[36m",
+  GREEN: "\x1b[32m",
+  YELLOW: "\x1b[33m",
+  BLUE: "\x1b[34m",
+  MAGENTA: "\x1b[35m",
+  RED: "\x1b[31m",
+  BG_CYAN: "\x1b[46m",
+  BG_GREEN: "\x1b[42m",
+  BG_RED: "\x1b[41m",
+  BLACK: "\x1b[30m",
+};

package/core/terminal/cursor.ts

@@ -0,0 +1,7 @@
+export const hideCursor = () => {
+  process.stdout.write("\x1B[?25l");
+};
+
+export const showCursor = () => {
+  process.stdout.write("\x1B[?25h");
+};

package/core/terminal/screen.ts

@@ -0,0 +1,9 @@
+export const clearScreen = () => {
+  console.clear();
+};
+
+export const printSeparator = () => {
+  const width = process.stdout.columns - 2 || 80;
+
+  process.stdout.write("\n " + "─".repeat(width) + "\n\n");
+};

package/main.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env bun
+import { MENU_STATE } from "./core/input/menu";
+import { navigateToMenu } from "./navigate";
+
+navigateToMenu(MENU_STATE.MAIN);

package/menus/configManager/index.ts

@@ -0,0 +1,47 @@
+import {
+  chooseOption,
+  handleUpdateOptionsMenu,
+  initMenu,
+} from "../../core/input/menu";
+import { showMenuStart } from "../start";
+import { showCreateConfig } from "../createConfig";
+import { showDeleteConfig } from "../deleteConfig";
+
+const handleGoBack = () => {
+  process.stdin.removeAllListeners("data");
+  showMenuStart();
+};
+
+const MENU_OPTIONS = [
+  {
+    id: 1,
+    label: "Create new config",
+    value: "create",
+    action: showCreateConfig,
+  },
+  {
+    id: 2,
+    label: "Delete config",
+    value: "delete",
+    action: showDeleteConfig,
+  },
+  {
+    id: 3,
+    label: "Go back",
+    value: "back",
+    isGoBack: true,
+    action: handleGoBack,
+  },
+];
+
+const currentOption = 1;
+
+export const showConfigManager = () => {
+  initMenu();
+
+  chooseOption(currentOption, MENU_OPTIONS);
+  process.stdin.on(
+    "data",
+    handleUpdateOptionsMenu(currentOption, MENU_OPTIONS),
+  );
+};

package/menus/createConfig/index.ts

@@ -0,0 +1,94 @@
+import { initMenu } from "../../core/input/menu";
+import { makeQuestion } from "../../core/input/question";
+import { renderColor } from "../../core/input/text";
+import { COLORS } from "../../core/terminal/colors";
+import { ConfigService } from "../../services/configService";
+import { showConfigManager } from "../configManager";
+
+const isValidBranchName = (name: string): boolean => {
+  return /^[a-zA-Z0-9\-_/]+$/.test(name);
+};
+
+const handleCreateConfig = async () => {
+  const originBranch = await makeQuestion(
+    renderColor("Origin branch name (e.g. develop): ", COLORS.CYAN),
+  );
+
+  if (!originBranch.trim()) {
+    process.stdout.write(
+      renderColor("\n⚠️  Origin branch name cannot be empty.\n", COLORS.RED),
+    );
+    setTimeout(() => showConfigManager(), 1000);
+    return;
+  }
+
+  if (!isValidBranchName(originBranch.trim())) {
+    process.stdout.write(
+      renderColor(
+        "\n⚠️  Invalid branch name. Only letters, numbers, - / _ are allowed.\n",
+        COLORS.RED,
+      ),
+    );
+    setTimeout(() => showConfigManager(), 1000);
+    return;
+  }
+
+  process.stdout.write("\n");
+
+  const prefix = await makeQuestion(
+    renderColor("Prefix for new branches (e.g. for-dev): ", COLORS.CYAN),
+  );
+
+  if (!prefix.trim()) {
+    process.stdout.write(
+      renderColor("\n⚠️  Prefix cannot be empty.\n", COLORS.RED),
+    );
+    setTimeout(() => showConfigManager(), 1000);
+    return;
+  }
+
+  if (!isValidBranchName(prefix.trim())) {
+    process.stdout.write(
+      renderColor(
+        "\n⚠️  Invalid prefix. Only letters, numbers, - / _ are allowed.\n",
+        COLORS.RED,
+      ),
+    );
+    setTimeout(() => showConfigManager(), 1000);
+    return;
+  }
+
+  ConfigService.addConfig(originBranch.trim(), prefix.trim());
+
+  process.stdout.write("\n");
+  process.stdout.write(
+    renderColor("✅ Config added successfully!\n", [COLORS.BOLD, COLORS.GREEN]),
+  );
+  process.stdout.write(
+    renderColor(`   ${originBranch} → ${prefix}\n\n`, COLORS.DIM),
+  );
+
+  setTimeout(() => showConfigManager(), 1500);
+};
+
+export const showCreateConfig = () => {
+  initMenu({ hideCursor: false });
+
+  const existingConfigs = ConfigService.getConfig();
+
+  process.stdout.write(
+    renderColor("📋 Current configurations:\n\n", [COLORS.BOLD, COLORS.CYAN]),
+  );
+
+  existingConfigs.forEach((config) => {
+    process.stdout.write(renderColor(`   • ${config.label}`, COLORS.GREEN));
+    process.stdout.write(renderColor(` → ${config.value}\n`, COLORS.DIM));
+  });
+
+  process.stdout.write("\n");
+  process.stdout.write(
+    renderColor(" Create new config\n\n", [COLORS.BOLD, COLORS.YELLOW]),
+  );
+
+  handleCreateConfig();
+};

package/menus/deleteConfig/index.ts

@@ -0,0 +1,72 @@
+import {
+  chooseOption,
+  handleUpdateOptionsMenu,
+  initMenu,
+} from "../../core/input/menu";
+import { renderColor } from "../../core/input/text";
+import { COLORS } from "../../core/terminal/colors";
+import { clearScreen } from "../../core/terminal/screen";
+import { ConfigService } from "../../services/configService";
+import { showConfigManager } from "../configManager";
+
+export const showDeleteConfig = () => {
+  initMenu();
+
+  const existingConfigs = ConfigService.getConfig();
+
+  if (existingConfigs.length === 0) {
+    process.stdout.write(
+      renderColor("⚠️  No configurations to delete.\n", COLORS.YELLOW),
+    );
+    setTimeout(() => showConfigManager(), 1500);
+    return;
+  }
+
+  const menuOptions = [
+    ...existingConfigs.map((config) => ({
+      id: config.id,
+      label: `${config.label} → ${config.value}`,
+      value: config.label,
+      action: handleDelete(config.label),
+    })),
+    {
+      id: existingConfigs.length + 1,
+      label: "Go back",
+      value: "back",
+      isGoBack: true,
+      action: () => {
+        process.stdin.removeAllListeners("data");
+        showConfigManager();
+      },
+    },
+  ];
+
+  const currentOption = 1;
+
+  const title = renderColor("🗑️  Delete config", [COLORS.BOLD, COLORS.RED]);
+
+  chooseOption(currentOption, menuOptions, { title });
+  process.stdin.on(
+    "data",
+    handleUpdateOptionsMenu(currentOption, menuOptions, title),
+  );
+};
+
+const handleDelete = (originBranch: string) => () => {
+  process.stdin.removeAllListeners("data");
+  clearScreen();
+
+  ConfigService.deleteConfig(originBranch);
+
+  process.stdout.write(
+    renderColor("✅ Config deleted successfully!\n", [
+      COLORS.BOLD,
+      COLORS.GREEN,
+    ]),
+  );
+  process.stdout.write(
+    renderColor(`   Removed: ${originBranch}\n\n`, COLORS.DIM),
+  );
+
+  setTimeout(() => showConfigManager(), 1500);
+};

package/menus/start/index.ts

@@ -0,0 +1,134 @@
+import {
+  chooseOption,
+  handleUpdateOptionsMenu,
+  initMenu,
+} from "../../core/input/menu";
+import { $ } from "bun";
+import { showCursor } from "../../core/terminal/cursor";
+import { renderColor } from "../../core/input/text";
+import { COLORS } from "../../core/terminal/colors";
+import { ConfigService } from "../../services/configService";
+import { showConfigManager } from "../configManager";
+
+const currentOption = 1;
+
+export const showMenuStart = () => {
+  initMenu();
+
+  const menuOptions = ConfigService.getConfig();
+  const otherOption = {
+    id: menuOptions.length + 1,
+    label: "other",
+    value: "other",
+    isGoBack: true,
+  };
+
+  const options = [
+    ...menuOptions.map((option) => ({
+      ...option,
+      action: handleCreateNewBranch(option.value, option.label),
+    })),
+    { ...otherOption, action: handleOther },
+  ];
+
+  chooseOption(currentOption, [...menuOptions, otherOption]);
+  process.stdin.on("data", handleUpdateOptionsMenu(currentOption, options));
+};
+
+const handleOther = () => {
+  process.stdin.removeAllListeners("data");
+  showConfigManager();
+};
+
+const handleCreateNewBranch = (prefix: string, branch: string) => async () => {
+  const currentBranch = (
+    await $`git rev-parse --abbrev-ref HEAD`.text()
+  ).trim();
+
+  if (currentBranch.includes(prefix)) {
+    process.stdout.write(renderColor(`⚠️  The current branch:`, COLORS.YELLOW));
+    process.stdout.write(
+      renderColor(` ${currentBranch}\n`, [COLORS.BOLD, COLORS.MAGENTA]),
+    );
+    process.stdout.write(
+      renderColor(`Already includes the prefix`, COLORS.YELLOW),
+    );
+    process.stdout.write(
+      renderColor(` ${prefix}\n\n`, [COLORS.BOLD, COLORS.MAGENTA]),
+    );
+    process.stdout.write(
+      renderColor(
+        `❌ Please switch to a branch that doesn't include the prefix "${prefix}" before running this tool.\n`,
+        COLORS.RED,
+      ),
+    );
+
+    showCursor();
+    process.exit(0);
+  }
+
+  process.stdout.write(
+    renderColor("⏳ Fetching and preparing...\n", COLORS.CYAN),
+  );
+
+  try {
+    await $`git fetch origin "${branch}:${branch}" --force`.quiet();
+  } catch {
+    process.stdout.write(
+      renderColor(
+        `⚠️  Failed to fetch branch "${branch}". Please check if it exists on the remote.\n`,
+        COLORS.RED,
+      ),
+    );
+    showCursor();
+    process.exit(0);
+  }
+
+  const newBranch = `${prefix}/${currentBranch}`;
+  process.stdout.write(renderColor(`📌 New branch: \n`, COLORS.GREEN));
+  process.stdout.write(renderColor(`   ${newBranch}\n\n`, COLORS.DIM));
+
+  process.stdout.write(
+    renderColor("🗑️  Cleaning up old branch...\n", COLORS.GREEN),
+  );
+  try {
+    await $`git branch -D "${newBranch}"`.quiet();
+    process.stdout.write(
+      renderColor(`✅ Old branch "${newBranch}" deleted.\n\n`, COLORS.DIM),
+    );
+  } catch {
+    process.stdout.write(
+      renderColor(`⚠️ No existing branch to delete.\n\n`, COLORS.DIM),
+    );
+  }
+
+  process.stdout.write(
+    renderColor("🔀 Switching to new branch...\n", COLORS.GREEN),
+  );
+  await $`git switch -c "${newBranch}"`.quiet();
+  process.stdout.write(
+    renderColor(`✅ Switched to new branch "${newBranch}".\n\n`, COLORS.DIM),
+  );
+
+  process.stdout.write(
+    renderColor(`🔗 Merging origin/${branch}...\n`, COLORS.GREEN),
+  );
+  try {
+    await $`git merge "origin/${branch}"`.quiet();
+    process.stdout.write(
+      renderColor("✅ Success!\n", [COLORS.BOLD, COLORS.GREEN]),
+    );
+  } catch {
+    process.stdout.write(
+      renderColor(
+        `⚠️  Merge conflicts detected. Please resolve them manually.\n`,
+        COLORS.RED,
+      ),
+    );
+    showCursor();
+    process.exit(0);
+  }
+
+  showCursor();
+  process.exit(0);
+};

package/navigate/index.ts

@@ -0,0 +1,14 @@
+import { MENU_STATE } from "../core/input/menu";
+import { hideCursor } from "../core/terminal/cursor";
+import { setMenuState } from "../state";
+
+const menuLoaders = {
+  [MENU_STATE.MAIN]: () =>
+    import("../menus/start").then((mod) => mod.showMenuStart()),
+} as const;
+
+export const navigateToMenu = (menu: MENU_STATE) => {
+  setMenuState(menu);
+  hideCursor();
+  menuLoaders[menu]();
+};

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "tree-swing",
+  "version": "1.0.0",
+  "description": "Git branch management CLI tool",
+  "module": "main.ts",
+  "type": "module",
+  "bin": {
+    "tree-swing": "./main.ts"
+  },
+  "files": [
+    "main.ts",
+    "core/**",
+    "menus/**",
+    "navigate/**",
+    "state/**",
+    "services/**",
+    "config.txt"
+  ],
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {}
+}

package/services/configService.ts

@@ -0,0 +1,38 @@
+import { appendFileSync, readFileSync, writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+
+const CONFIG_FILE = join(dirname(import.meta.dir), "config.txt");
+
+interface Config {
+  label: string;
+  value: string;
+  id: number;
+}
+
+export const ConfigService = {
+  getConfig: () => {
+    const fileContent = readFileSync(CONFIG_FILE, "utf-8")
+      .split("\n")
+      .filter((line) => line.trim() !== "");
+
+    const config = fileContent.map((line, idx) => {
+      const [originBranch, prefix] = line.split("=").map((part) => part.trim());
+      return { label: originBranch, value: prefix, id: idx + 1 };
+    });
+
+    return config as Config[];
+  },
+  addConfig: (originBranch: string, prefix: string) => {
+    const newConfigLine = `${originBranch}=${prefix}\n`;
+    appendFileSync(CONFIG_FILE, newConfigLine);
+  },
+  deleteConfig: (originBranch: string) => {
+    const fileContent = readFileSync(CONFIG_FILE, "utf-8")
+      .split("\n")
+      .filter(
+        (line) => line.trim() !== "" && !line.startsWith(originBranch + "="),
+      );
+
+    writeFileSync(CONFIG_FILE, fileContent.join("\n") + "\n");
+  },
+};

package/state/index.ts

@@ -0,0 +1,9 @@
+import { MENU_STATE } from "../core/input/menu";
+
+let currentMenu: MENU_STATE = MENU_STATE.MAIN;
+
+export const getMenuState = () => currentMenu;
+
+export const setMenuState = (menu: MENU_STATE) => {
+  currentMenu = menu;
+};