@zairakai/js-dev-tools 1.2.3 → 1.3.0

package/.gitlab/ci/pipeline-js-package.yml

@@ -29,7 +29,7 @@
 #   variables:
 #     CACHE_KEY: "dev-tools-v1"
 #     NPM_PACKAGE_NAME: "@zairakai/js-dev-tools"
-#     DEV_TOOLS_SCRIPTS: "scripts"
+#     JS_DEV_TOOLS_SCRIPTS: "scripts"
 # ================================
 
 include:
@@ -71,7 +71,7 @@ variables:
   # Paths to dev-tools scripts.
   # Consumer projects do NOT need to override these.
   # dev-tools itself overrides them in its own .gitlab-ci.yml.
-  DEV_TOOLS_SCRIPTS: "node_modules/@zairakai/js-dev-tools/scripts"
+  JS_DEV_TOOLS_SCRIPTS: "node_modules/@zairakai/js-dev-tools/scripts"
 
   # ── NODE ──────────────────────────────────────────────────────────────────
   NODE_VERSION: "22"
@@ -163,7 +163,7 @@ js:validate:markdownlint:
   stage: validate
   image: ${NODE_IMAGE}
   script:
-    - bash "$DEV_TOOLS_SCRIPTS/markdownlint.sh"
+    - bash "$JS_DEV_TOOLS_SCRIPTS/markdownlint.sh"
 
 js:validate:shellcheck:
   <<: *base_job
@@ -174,7 +174,7 @@ js:validate:shellcheck:
   script:
     - |
       if [[ -d scripts/ ]]; then
-        bash "$DEV_TOOLS_SCRIPTS/validate-shellcheck.sh"
+        bash "$JS_DEV_TOOLS_SCRIPTS/validate-shellcheck.sh"
       else
         echo "No scripts/ directory found — skipping ShellCheck"
       fi
@@ -186,7 +186,7 @@ js:quality:lint:
   <<: *job_node
   stage: quality
   script:
-    - bash "$DEV_TOOLS_SCRIPTS/eslint.sh"
+    - bash "$JS_DEV_TOOLS_SCRIPTS/eslint.sh"
   artifacts:
     reports:
       junit: build/reports/eslint.xml
@@ -199,13 +199,13 @@ js:quality:format:
   <<: *job_node
   stage: quality
   script:
-    - bash "$DEV_TOOLS_SCRIPTS/prettier.sh"
+    - bash "$JS_DEV_TOOLS_SCRIPTS/prettier.sh"
 
 js:quality:stylelint:
   <<: *job_node
   stage: quality
   script:
-    - bash "$DEV_TOOLS_SCRIPTS/stylelint.sh"
+    - bash "$JS_DEV_TOOLS_SCRIPTS/stylelint.sh"
 
 js:quality:typecheck:
   <<: *job_node
@@ -213,7 +213,7 @@ js:quality:typecheck:
   script:
     - |
       if [ -f tsconfig.json ] && [ -f node_modules/.bin/tsc ]; then
-        bash "$DEV_TOOLS_SCRIPTS/typecheck.sh"
+        bash "$JS_DEV_TOOLS_SCRIPTS/typecheck.sh"
       else
         echo "TypeScript not configured — skipping (add tsconfig.json + typescript to devDependencies)"
       fi
@@ -222,7 +222,7 @@ js:quality:knip:
   <<: *job_node
   stage: quality
   script:
-    - bash "$DEV_TOOLS_SCRIPTS/knip.sh"
+    - bash "$JS_DEV_TOOLS_SCRIPTS/knip.sh"
 
 js:quality:bats:
   <<: [*base_job, *cache_node]
@@ -244,7 +244,7 @@ js:quality:outdated:
   rules:
     - if: $CI_PIPELINE_SOURCE == "schedule"
   script:
-    - bash "$DEV_TOOLS_SCRIPTS/outdated.sh"
+    - bash "$JS_DEV_TOOLS_SCRIPTS/outdated.sh"
   artifacts:
     paths:
       - build/reports/npm-outdated.json
@@ -259,7 +259,7 @@ js:test:
   stage: test
   image: ${NODE_TEST_IMAGE}
   script:
-    - CI=true bash "$DEV_TOOLS_SCRIPTS/test.sh"
+    - CI=true bash "$JS_DEV_TOOLS_SCRIPTS/test.sh"
   coverage: '/All files[^|]*\|[^|]*\s+([\d\.]+)/'
   artifacts:
     reports:
@@ -281,7 +281,7 @@ js:build:
   script:
     - |
       if { [ -f node_modules/.bin/tsup ] || [ -f node_modules/.bin/tsc ]; } && [ -f tsconfig.json ]; then
-        bash "$DEV_TOOLS_SCRIPTS/build.sh"
+        bash "$JS_DEV_TOOLS_SCRIPTS/build.sh"
       else
         echo "No TypeScript builder configured — skipping (install tsup or typescript)"
       fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zairakai/js-dev-tools",
-  "version": "1.2.3",
+  "version": "1.3.0",
   "description": "The unified and centralized development toolkit for JavaScript/TypeScript projects - ESLint, Prettier, Stylelint, Knip, Vitest, Git Hooks, and GitLab CI pipeline templates",
   "keywords": [
     "dev-tools",

package/tools/make/core.mk

@@ -52,5 +52,8 @@ include $(NPM_DIRECTORY_TOOLS_MAKE_DIR)test.mk
 # 10. BATS shell script testing
 include $(NPM_DIRECTORY_TOOLS_MAKE_DIR)bats.mk
 
-# 11. Utilities (git, npm)
+# 11. Utilities (npm, maintenance)
 include $(NPM_DIRECTORY_TOOLS_MAKE_DIR)utils.mk
+
+# 12. Shared utilities (git, hooks, doctor)
+include $(NPM_DIRECTORY_TOOLS_MAKE_DIR)utils-shared.mk

package/tools/make/utils-shared.mk

@@ -0,0 +1,24 @@
+# Shared Utility Targets
+# Targets duplicated across PHP and JS toolchains
+
+## —— 🧰 Utils ——
+.PHONY: doctor
+doctor: ## Run environment diagnostics
+	@bash $(NPM_DIRECTORY_TOOLS_SCRIPTS_DIR)/doctor.sh
+
+## —— 🌿 Git ——
+.PHONY: install-hooks
+install-hooks: ## Install git hooks into .git/hooks
+	@bash $(NPM_DIRECTORY_TOOLS_SCRIPTS_DIR)/install-hooks.sh
+
+.PHONY: git-update
+git-update: ## Fast-forward all local branches that track a remote
+	@bash $(NPM_DIRECTORY_TOOLS_PACKAGE_ROOT)/tools/scripts/git-update.sh
+
+.PHONY: git-cleanup
+git-cleanup: ## Remove local branches whose remote tracking branch no longer exists
+	@bash $(NPM_DIRECTORY_TOOLS_PACKAGE_ROOT)/tools/scripts/git-cleanup.sh
+
+.PHONY: git-rebase
+git-rebase: ## Rebase the current branch to the selected one
+	@bash $(NPM_DIRECTORY_TOOLS_TOOLS_SCRIPTS_DIR)/git-rebase.sh

package/tools/make/utils.mk

@@ -23,22 +23,6 @@ package-validate: ## Validate package.json and lockfile sync
 	@$(NPM_DIRECTORY_TOOLS_PROJECT_ROOT)/node_modules/.bin/sort-package-json --check package.json
 
 ## —— 🧰 Utils ——
-.PHONY: doctor
-doctor: ## Run environment diagnostics
-	@bash $(NPM_DIRECTORY_TOOLS_SCRIPTS_DIR)/doctor.sh
-
 .PHONY: outdated
 outdated: ## Check for outdated npm dependencies
 	@bash $(NPM_DIRECTORY_TOOLS_SCRIPTS_DIR)/outdated.sh
-
-.PHONY: install-hooks
-install-hooks: ## Install git hooks into .git/hooks
-	@bash $(NPM_DIRECTORY_TOOLS_SCRIPTS_DIR)/install-hooks.sh
-
-.PHONY: git-update
-git-update: ## Fast-forward all local branches that track a remote
-	@bash $(NPM_DIRECTORY_TOOLS_PACKAGE_ROOT)/tools/scripts/git-update.sh
-
-.PHONY: git-cleanup
-git-cleanup: ## Remove local branches whose remote tracking branch no longer exists
-	@bash $(NPM_DIRECTORY_TOOLS_PACKAGE_ROOT)/tools/scripts/git-cleanup.sh

package/tools/scripts/git-rebase.sh

@@ -0,0 +1,107 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo ""
+echo "==== Interactive Rebase ===="
+echo ""
+
+# Ensure on branch
+current_branch=$(git symbolic-ref --short HEAD 2>/dev/null || true)
+
+if [ -z "$current_branch" ]; then
+  echo "Detached HEAD. Abort."
+  exit 1
+fi
+
+# Check clean working tree
+if ! git diff-index --quiet HEAD --; then
+  echo "Working tree dirty. Commit or stash first."
+  exit 1
+fi
+
+echo "Current branch : $current_branch"
+echo ""
+
+# Fetch latest remotes
+git fetch --all --prune
+
+# Build branch list
+mapfile -t local_branches < <(git for-each-ref --format='%(refname:short)' refs/heads/)
+mapfile -t remote_branches < <(git for-each-ref --format='%(refname:short)' refs/remotes/origin/)
+
+echo "Select branch to rebase onto:"
+echo ""
+
+index=1
+
+# Display local branches
+echo "---- Local branches ----"
+for branch in "${local_branches[@]}"; do
+  echo "[$index] $branch"
+  ((index++))
+done
+
+# Display remote branches
+echo ""
+echo "---- Remote branches (origin) ----"
+for branch in "${remote_branches[@]}"; do
+  echo "[$index] $branch"
+  ((index++))
+done
+
+echo ""
+
+# Read user choice
+read -rp "Enter number: " choice
+
+# Validate input
+if ! [[ "$choice" =~ ^[0-9]+$ ]]; then
+  echo "Invalid input."
+  exit 1
+fi
+
+# Resolve selected branch
+total_local=${#local_branches[@]}
+
+if (( choice <= total_local )); then
+  target_branch="${local_branches[$((choice-1))]}"
+else
+  target_branch="${remote_branches[$((choice-total_local-1))]}"
+fi
+
+# Prevent rebasing onto itself
+if [ "$target_branch" = "$current_branch" ]; then
+  echo "Cannot rebase onto the same branch."
+  exit 1
+fi
+
+echo ""
+echo "Rebasing '$current_branch' onto '$target_branch'..."
+echo ""
+
+# Rebase
+if git rebase "$target_branch"; then
+  echo ""
+  echo "==== Rebase OK ===="
+  echo ""
+
+  read -rp "Force push now? [y/N] " -n 1
+  echo ""
+
+  if [[ $REPLY =~ ^[Yy]$ ]]; then
+    git push --force-with-lease
+    echo "Push completed."
+  else
+    echo "Push skipped."
+  fi
+
+else
+  echo ""
+  echo "==== Conflict ===="
+  echo "Resolve conflicts, then:"
+  echo "  git rebase --continue"
+  echo ""
+  echo "Or abort:"
+  echo "  git rebase --abort"
+  exit 1
+fi