@zairakai/js-dev-tools 1.1.0 → 1.2.1

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

@@ -41,6 +41,7 @@ include:
 workflow:
   rules:
     - if: $CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/
+    - if: $CI_PIPELINE_SOURCE == "schedule"
     - if: $CI_PIPELINE_SOURCE == "merge_request_event" || $CI_MERGE_REQUEST_ID
     - if: $CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH == "develop"
     - if: $CI_COMMIT_REF_NAME =~ /^feature\// || $CI_COMMIT_REF_NAME =~ /^fix\// || $CI_COMMIT_REF_NAME =~ /^hotfix\//
@@ -240,6 +241,8 @@ js:quality:bats:
 js:quality:outdated:
   <<: *job_node
   stage: quality
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "schedule"
   script:
     - bash "$DEV_TOOLS_SCRIPTS/outdated.sh"
   artifacts:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zairakai/js-dev-tools",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "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/scripts/build.sh

@@ -1,18 +1,18 @@
 #!/usr/bin/env bash
 #
-# TypeScript Build / Transpilation
-# Compiles TypeScript to JavaScript for distribution.
-#
+# Build script for npm packages.
 # Supports (in order of preference):
-#   1. tsup  — fast, esbuild-based bundler (recommended for npm packages)
-#   2. tsc   — official TypeScript compiler
+#   1. Vite  — detected via vite.config.ts / vite.config.js (runs npm run build)
+#   2. tsup  — fast, esbuild-based bundler (recommended for pure TS packages)
+#   3. tsc   — official TypeScript compiler
 #
 # Usage:
 #   bash scripts/build.sh
 #
 # Recommendation:
-#   Use tsup for npm packages:  npm install --save-dev tsup
-#   Use tsc for apps:           npm install --save-dev typescript
+#   Use Vite for Vue component libraries (vite.config.ts present)
+#   Use tsup for pure TypeScript packages: npm install --save-dev tsup
+#   Use tsc for simple transpilation:      npm install --save-dev typescript
 #
 
 set -euo pipefail
@@ -24,9 +24,14 @@ source "${SCRIPT_DIR}/config.sh"
 TSUP_BIN="${BIN_DIR}/tsup"
 TSC_BIN="${BIN_DIR}/tsc"
 
-log_header "TypeScript Build"
+log_header "Build"
+
+if [[ -f "${PROJECT_ROOT}/vite.config.ts" ]] || [[ -f "${PROJECT_ROOT}/vite.config.js" ]]; then
+    log_info "Builder: Vite (vite.config detected — running npm run build)"
+    npm run build
+    log_success "Build complete — output in dist/"
 
-if [[ -f "$TSUP_BIN" ]]; then
+elif [[ -f "$TSUP_BIN" ]]; then
     log_info "Builder: tsup (fast, esbuild-based)"
     if [[ -n "$TSUP_CONFIG" ]]; then
         "$TSUP_BIN" --config "$TSUP_CONFIG"
@@ -50,9 +55,9 @@ elif [[ -f "$TSC_BIN" ]]; then
     log_success "Build complete"
 
 else
-    log_error "No TypeScript builder found in node_modules/.bin/"
+    log_error "No builder found. Expected one of: vite.config.ts, tsup, tsc"
     log_info "Install one of:"
-    log_info "  npm install --save-dev tsup       (recommended for npm packages)"
-    log_info "  npm install --save-dev typescript (for apps or when you need full tsc control)"
+    log_info "  npm install --save-dev tsup       (recommended for pure TS packages)"
+    log_info "  npm install --save-dev typescript (for simple transpilation)"
     exit 1
 fi

package/scripts/setup-project.sh

@@ -633,6 +633,70 @@ do_publish() {
     done
 }
 
+# ============================================================================
+# GitLab CI — Ref Synchronizer
+# Mirrors GitlabCiSynchronizer.php from laravel-dev-tools.
+# Runs on every postinstall (npm install / npm update).
+# Reads the installed version of @zairakai/js-dev-tools and updates the
+# ref: in the project's .gitlab-ci.yml if it is out of sync.
+# ============================================================================
+
+sync_gitlab_ci_ref() {
+    local gitlab_ci="${PROJECT_ROOT}/.gitlab-ci.yml"
+    local gitlab_project="zairakai/npm-packages/js-dev-tools"
+
+    [[ -f "$gitlab_ci" ]] || return 0
+    grep -qF "$gitlab_project" "$gitlab_ci" || return 0
+
+    # Resolve installed version from the package's own package.json
+    local installed_version
+    installed_version="$(node -e "try{const p=require('${DEV_TOOLS_ROOT}/package.json');console.log('v'+(p.version||'').replace(/^v/,''))}catch(e){}" 2>/dev/null || echo "")"
+
+    [[ -n "$installed_version" ]] || return 0
+
+    # Extract the current ref: value inside the js-dev-tools include block
+    local in_block=false found_project=false current_ref=""
+    while IFS= read -r line; do
+        local trimmed="${line#"${line%%[![:space:]]*}"}"  # ltrim
+
+        if [[ "$trimmed" == "include:" ]]; then
+            in_block=true
+            continue
+        fi
+
+        if [[ "$in_block" == true ]]; then
+            # Exit block on non-indented, non-list line
+            if [[ -n "$trimmed" ]] && [[ "$line" != " "* ]] && [[ "$line" != "-"* ]]; then
+                in_block=false
+                found_project=false
+            fi
+
+            if [[ "$found_project" == false ]] && [[ "$trimmed" == *"$gitlab_project"* ]]; then
+                found_project=true
+                continue
+            fi
+
+            if [[ "$found_project" == true ]] && [[ "$trimmed" == ref:* ]]; then
+                current_ref="${trimmed#ref:}"
+                current_ref="${current_ref#"${current_ref%%[![:space:]]*}"}"  # ltrim
+                current_ref="${current_ref//\'/}"
+                current_ref="${current_ref//\"/}"
+                break
+            fi
+        fi
+    done < "$gitlab_ci"
+
+    [[ -n "$current_ref" ]] || return 0
+    [[ "$current_ref" != "$installed_version" ]] || return 0
+
+    # Auto-fix: replace the ref
+    if sed -i "s|ref: ${current_ref}|ref: ${installed_version}|" "$gitlab_ci"; then
+        echo "  dev-tools: .gitlab-ci.yml ref ${current_ref} → ${installed_version}"
+    else
+        echo "  dev-tools: WARNING — could not update .gitlab-ci.yml ref (manual fix needed)" >&2
+    fi
+}
+
 # ============================================================================
 # Makefile Setup
 # ============================================================================
@@ -789,6 +853,9 @@ setup_project() {
             "config/dev-tools/eslint.config.js"
     fi
 
+    # ─── GitLab CI ref sync ───────────────────────────────────────────────────
+    sync_gitlab_ci_ref
+
     # ─── Summary ─────────────────────────────────────────────────────────────
     if [[ "$SILENT_MODE" == "true" ]]; then
         check_optional_deps