inup 1.5.5 → 1.6.0

package/dist/ui/state/filter-manager.js

@@ -3,15 +3,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.FilterManager = void 0;
 const vulnerability_1 = require("../presenters/vulnerability");
 class FilterManager {
-    constructor() {
+    state;
+    constructor(initial) {
         this.state = {
             filterMode: false,
             filterQuery: '',
-            showDependencies: true,
-            showDevDependencies: true,
-            showPeerDependencies: true,
-            showOptionalDependencies: true,
-            showOnlyVulnerable: false,
+            showDependencies: initial?.showDependencies ?? true,
+            showDevDependencies: initial?.showDevDependencies ?? true,
+            showPeerDependencies: initial?.showPeerDependencies ?? true,
+            showOptionalDependencies: initial?.showOptionalDependencies ?? true,
+            showOnlyVulnerable: initial?.showOnlyVulnerable ?? false,
+        };
+    }
+    /** Snapshot of the persistable filter toggles (no transient search state). */
+    getPersistableState() {
+        return {
+            showDependencies: this.state.showDependencies,
+            showDevDependencies: this.state.showDevDependencies,
+            showPeerDependencies: this.state.showPeerDependencies,
+            showOptionalDependencies: this.state.showOptionalDependencies,
+            showOnlyVulnerable: this.state.showOnlyVulnerable,
         };
     }
     getState() {

package/dist/ui/state/modal-manager.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ModalManager = void 0;
 class ModalManager {
+    state;
     constructor() {
         this.state = {
             showInfoModal: false,
@@ -12,6 +13,8 @@ class ModalManager {
             infoModalTab: 'info',
             showDebugModal: false,
             debugModalScrollOffset: 0,
+            showHelpModal: false,
+            helpModalScrollOffset: 0,
         };
     }
     getInfoModalTab() {
@@ -31,6 +34,38 @@ class ModalManager {
         this.state.showDebugModal = !this.state.showDebugModal;
         this.state.debugModalScrollOffset = 0;
     }
+    isHelpModalOpen() {
+        return this.state.showHelpModal;
+    }
+    toggleHelpModal() {
+        this.state.showHelpModal = !this.state.showHelpModal;
+        this.state.helpModalScrollOffset = 0;
+    }
+    closeHelpModal() {
+        this.state.showHelpModal = false;
+        this.state.helpModalScrollOffset = 0;
+    }
+    scrollHelpModalUp() {
+        if (this.state.helpModalScrollOffset > 0) {
+            this.state.helpModalScrollOffset--;
+            return true;
+        }
+        return false;
+    }
+    scrollHelpModalDown(maxOffset) {
+        if (this.state.helpModalScrollOffset < maxOffset) {
+            this.state.helpModalScrollOffset++;
+            return true;
+        }
+        return false;
+    }
+    clampHelpModalScrollOffset(maxOffset) {
+        const next = Math.max(0, Math.min(this.state.helpModalScrollOffset, maxOffset));
+        if (next === this.state.helpModalScrollOffset)
+            return false;
+        this.state.helpModalScrollOffset = next;
+        return true;
+    }
     closeDebugModal() {
         this.state.showDebugModal = false;
         this.state.debugModalScrollOffset = 0;

package/dist/ui/state/navigation-manager.js

@@ -2,9 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NavigationManager = void 0;
 class NavigationManager {
+    state;
+    renderableItems = [];
+    maxVisibleItems;
     constructor(initialRow = 0, maxVisibleItems = 19) {
-        this.renderableItems = [];
-        this.headerLines = 5; // title (with label) + empty + 1 instruction line + status + empty
         this.state = {
             currentRow: initialRow,
             previousRow: -1,
@@ -65,8 +66,6 @@ class NavigationManager {
                 return currentPackageIndex >= totalPackages - 1 ? 0 : currentPackageIndex + 1;
             }
         }
-        // Find current visual index
-        const currentVisualIndex = this.packageIndexToVisualIndex(currentPackageIndex);
         // Get all package items with their visual indices
         const packageItems = [];
         for (let i = 0; i < this.renderableItems.length; i++) {
@@ -105,6 +104,36 @@ class NavigationManager {
         this.state.currentRow = this.findNextPackageIndex(this.state.currentRow, 'down', totalItems);
         this.ensureVisible(this.state.currentRow, totalItems);
     }
+    navigateTop(totalItems) {
+        if (totalItems === 0)
+            return;
+        this.state.previousRow = this.state.currentRow;
+        this.state.currentRow = this.firstPackageIndex();
+        this.ensureVisible(this.state.currentRow, totalItems);
+    }
+    navigateBottom(totalItems) {
+        if (totalItems === 0)
+            return;
+        this.state.previousRow = this.state.currentRow;
+        this.state.currentRow = this.lastPackageIndex(totalItems);
+        this.ensureVisible(this.state.currentRow, totalItems);
+    }
+    firstPackageIndex() {
+        if (this.renderableItems.length === 0)
+            return 0;
+        const first = this.renderableItems.find((item) => item.type === 'package');
+        return first ? first.originalIndex : 0;
+    }
+    lastPackageIndex(totalPackages) {
+        if (this.renderableItems.length === 0)
+            return totalPackages - 1;
+        for (let i = this.renderableItems.length - 1; i >= 0; i--) {
+            const item = this.renderableItems[i];
+            if (item.type === 'package')
+                return item.originalIndex;
+        }
+        return totalPackages - 1;
+    }
     ensureVisible(packageIndex, totalPackages) {
         // Convert package index to visual index for scrolling
         const visualIndex = this.packageIndexToVisualIndex(packageIndex);

package/dist/ui/state/state-manager.js

@@ -6,12 +6,19 @@ const modal_manager_1 = require("./modal-manager");
 const filter_manager_1 = require("./filter-manager");
 const theme_manager_1 = require("./theme-manager");
 class StateManager {
-    constructor(initialRow = 0, terminalHeight = 24) {
-        this.headerLines = 5; // title (with label) + empty + 1 instruction line + status + empty
+    navigationManager;
+    modalManager;
+    filterManager;
+    themeManager;
+    displayState;
+    renderState;
+    notice = null;
+    headerLines = 5; // title (with label) + empty + 1 instruction line + status + empty
+    constructor(initialRow = 0, terminalHeight = 24, persistedFilters) {
         const maxVisibleItems = Math.max(5, terminalHeight - this.headerLines - 2);
         this.navigationManager = new navigation_manager_1.NavigationManager(initialRow, maxVisibleItems);
         this.modalManager = new modal_manager_1.ModalManager();
-        this.filterManager = new filter_manager_1.FilterManager();
+        this.filterManager = new filter_manager_1.FilterManager(persistedFilters);
         this.themeManager = new theme_manager_1.ThemeManager();
         this.displayState = {
             maxVisibleItems,
@@ -46,12 +53,26 @@ class StateManager {
             infoModalTab: modalState.infoModalTab,
             showDebugModal: modalState.showDebugModal,
             debugModalScrollOffset: modalState.debugModalScrollOffset,
+            showHelpModal: modalState.showHelpModal,
+            helpModalScrollOffset: modalState.helpModalScrollOffset,
             filterMode: filterState.filterMode,
             filterQuery: filterState.filterQuery,
             showThemeModal: themeState.showThemeModal,
             currentTheme: themeState.currentTheme,
+            notice: this.notice,
         };
     }
+    // Transient status hint shown once (e.g. "nothing selected"); cleared by the
+    // dispatcher on the next action so it never lingers.
+    setNotice(message) {
+        this.notice = message;
+    }
+    clearNotice() {
+        this.notice = null;
+    }
+    getNotice() {
+        return this.notice;
+    }
     setRenderableItems(items) {
         this.renderState.renderableItems = items;
         this.navigationManager.setRenderableItems(items);
@@ -63,6 +84,12 @@ class StateManager {
     navigateDown(totalItems) {
         this.navigationManager.navigateDown(totalItems);
     }
+    navigateTop(totalItems) {
+        this.navigationManager.navigateTop(totalItems);
+    }
+    navigateBottom(totalItems) {
+        this.navigationManager.navigateBottom(totalItems);
+    }
     packageIndexToVisualIndex(packageIndex) {
         return this.navigationManager.packageIndexToVisualIndex(packageIndex);
     }
@@ -152,6 +179,24 @@ class StateManager {
             }
         });
     }
+    // Toggle the current row: clear it if selected, otherwise pick the best
+    // available update (latest preferred, then range).
+    toggleSelection(states) {
+        if (states.length === 0)
+            return;
+        const currentState = states[this.navigationManager.getCurrentRow()];
+        if (!currentState || currentState.loadState !== 'ready')
+            return;
+        if (currentState.selectedOption !== 'none') {
+            currentState.selectedOption = 'none';
+        }
+        else if (currentState.hasMajorUpdate) {
+            currentState.selectedOption = 'latest';
+        }
+        else if (currentState.hasRangeUpdate) {
+            currentState.selectedOption = 'range';
+        }
+    }
     // Modal delegation
     toggleInfoModal() {
         const currentRow = this.navigationManager.getCurrentRow();
@@ -206,6 +251,23 @@ class StateManager {
     closeDebugModal() {
         this.modalManager.closeDebugModal();
     }
+    toggleHelpModal() {
+        this.modalManager.toggleHelpModal();
+        this.renderState.forceFullRender = true;
+    }
+    closeHelpModal() {
+        this.modalManager.closeHelpModal();
+        this.renderState.forceFullRender = true;
+    }
+    scrollHelpModalUp() {
+        return this.modalManager.scrollHelpModalUp();
+    }
+    scrollHelpModalDown(maxOffset) {
+        return this.modalManager.scrollHelpModalDown(maxOffset);
+    }
+    clampHelpModalScrollOffset(maxOffset) {
+        return this.modalManager.clampHelpModalScrollOffset(maxOffset);
+    }
     scrollDebugModalUp() {
         return this.modalManager.scrollDebugModalUp();
     }
@@ -264,6 +326,9 @@ class StateManager {
     getActiveFilterLabel() {
         return this.filterManager.getActiveFilterLabel();
     }
+    getFilterSnapshot() {
+        return this.filterManager.getPersistableState();
+    }
     // Display and render state management
     updateTerminalHeight(newHeight) {
         const newMaxVisibleItems = Math.max(5, newHeight - this.headerLines - 2);

package/dist/ui/state/theme-manager.js

@@ -8,6 +8,7 @@ const config_1 = require("../../utils/config");
 // Global theme state for renderers to access
 let globalCurrentTheme = themes_1.defaultTheme;
 class ThemeManager {
+    state;
     constructor() {
         // Load saved theme from config, fallback to default
         const savedTheme = config_1.configManager.getTheme();

package/dist/ui/themes-colors.js

@@ -11,6 +11,7 @@ exports.getTerminalResetCode = getTerminalResetCode;
 exports.coloredInupLogo = coloredInupLogo;
 const chalk_1 = __importDefault(require("chalk"));
 const theme_manager_1 = require("./state/theme-manager");
+const config_1 = require("../config");
 // Centralized theme color definitions - single source of truth
 const themeColorDefinitions = {
     default: {
@@ -181,22 +182,33 @@ function hexToRgb(hex) {
         : { r: 0, g: 0, b: 0 };
 }
 /**
- * Get ANSI escape code to set terminal background color
+ * Get ANSI escape code to set terminal background color.
+ *
+ * Returns an empty string when color output is disabled (`--no-color`/`NO_COLOR`
+ * set `chalk.level` to 0), so the TUI inherits the user's own terminal
+ * background instead of painting over it. This escape is raw (not produced by
+ * chalk), so it must be gated explicitly.
  */
 function getTerminalBgColorCode() {
+    if (chalk_1.default.level === 0) {
+        return '';
+    }
     const hex = getThemeBgColor();
     const rgb = hexToRgb(hex);
     return `\x1b[48;2;${rgb.r};${rgb.g};${rgb.b}m`;
 }
 /**
- * Get ANSI escape code to reset terminal colors
+ * Get ANSI escape code to reset terminal colors. Empty when color is disabled,
+ * so a `--no-color` run emits no escape sequences at all.
  */
 function getTerminalResetCode() {
-    return '\x1b[0m';
+    return chalk_1.default.level === 0 ? '' : '\x1b[0m';
 }
 const BRAND_COLORS = [chalk_1.default.red, chalk_1.default.yellow, chalk_1.default.blue, chalk_1.default.magenta];
 function coloredInupLogo() {
-    return BRAND_COLORS.map((color, i) => color.bold('inup'[i])).join('');
+    return Array.from(config_1.PACKAGE_NAME)
+        .map((ch, i) => BRAND_COLORS[i % BRAND_COLORS.length].bold(ch))
+        .join('');
 }
 exports.themeColors = {
     primary: () => getThemeColor('primary'),

package/dist/ui/themes.js

@@ -5,26 +5,18 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.themeNames = exports.defaultTheme = exports.themes = void 0;
 const chalk_1 = __importDefault(require("chalk"));
-const themesMetadata = {
-    default: 'Default',
-    catppuccin: 'Catppuccin',
-    dracula: 'Dracula',
-    vsc: 'VS Code',
-    monokai: 'Monokai',
-    tokyonight: 'Tokyo Night',
-    onedark: 'One Dark',
-    gruvbox: 'Gruvbox',
-    solarized: 'Solarized',
-    github: 'GitHub',
+exports.themes = {
+    default: { name: 'Default', colors: chalk_1.default },
+    catppuccin: { name: 'Catppuccin', colors: chalk_1.default },
+    dracula: { name: 'Dracula', colors: chalk_1.default },
+    vsc: { name: 'VS Code', colors: chalk_1.default },
+    monokai: { name: 'Monokai', colors: chalk_1.default },
+    tokyonight: { name: 'Tokyo Night', colors: chalk_1.default },
+    onedark: { name: 'One Dark', colors: chalk_1.default },
+    gruvbox: { name: 'Gruvbox', colors: chalk_1.default },
+    solarized: { name: 'Solarized', colors: chalk_1.default },
+    github: { name: 'GitHub', colors: chalk_1.default },
 };
-// Theme definitions
-exports.themes = Object.entries(themesMetadata).reduce((acc, [key, name]) => {
-    acc[key] = {
-        name,
-        colors: chalk_1.default,
-    };
-    return acc;
-}, {});
 exports.defaultTheme = 'default';
 exports.themeNames = Object.keys(exports.themes);
 //# sourceMappingURL=themes.js.map

package/dist/ui/utils/cursor.js

@@ -1,9 +1,8 @@
 "use strict";
-/**
- * Cursor and terminal utility functions
- */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ConsoleUtils = exports.CursorUtils = void 0;
+exports.ConsoleUtils = exports.CursorUtils = exports.RAW_SHOW_CURSOR = exports.RAW_EXIT_ALT_SCREEN = void 0;
+exports.RAW_EXIT_ALT_SCREEN = '\x1b[?1049l';
+exports.RAW_SHOW_CURSOR = '\x1b[?25h';
 exports.CursorUtils = {
     /**
      * Switch to the terminal alternate screen buffer.
@@ -68,16 +67,22 @@ exports.ConsoleUtils = {
      */
     LINE_WIDTH: 80,
     /**
-     * Show a progress message on the current line (overwrites previous content)
+     * Show a progress message on the current line (overwrites previous content).
+     * Written to stderr so stdout stays clean for --json / piped output, and only
+     * when stderr is a TTY — the \r animation is just noise in a redirected log.
      */
     showProgress(message) {
-        process.stdout.write(`\r${' '.repeat(exports.ConsoleUtils.LINE_WIDTH)}\r${message}`);
+        if (!process.stderr.isTTY)
+            return;
+        process.stderr.write(`\r${' '.repeat(exports.ConsoleUtils.LINE_WIDTH)}\r${message}`);
     },
     /**
      * Clear the current progress line
      */
     clearProgress() {
-        process.stdout.write('\r' + ' '.repeat(exports.ConsoleUtils.LINE_WIDTH) + '\r');
+        if (!process.stderr.isTTY)
+            return;
+        process.stderr.write('\r' + ' '.repeat(exports.ConsoleUtils.LINE_WIDTH) + '\r');
     },
 };
 //# sourceMappingURL=cursor.js.map

package/dist/ui/utils/index.js

@@ -1,11 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.wrapPlainText = exports.truncatePlainText = exports.stripAnsi = exports.getVisualLength = exports.TerminalInput = exports.ConsoleUtils = exports.CursorUtils = exports.VersionUtils = void 0;
+exports.wrapPlainText = exports.truncatePlainText = exports.stripAnsi = exports.getVisualLength = exports.TerminalInput = exports.RAW_SHOW_CURSOR = exports.RAW_EXIT_ALT_SCREEN = exports.ConsoleUtils = exports.CursorUtils = exports.formatVersionDiff = exports.truncateMiddle = exports.applyVersionPrefix = exports.VersionUtils = void 0;
 var version_1 = require("./version");
 Object.defineProperty(exports, "VersionUtils", { enumerable: true, get: function () { return version_1.VersionUtils; } });
+Object.defineProperty(exports, "applyVersionPrefix", { enumerable: true, get: function () { return version_1.applyVersionPrefix; } });
+Object.defineProperty(exports, "truncateMiddle", { enumerable: true, get: function () { return version_1.truncateMiddle; } });
+Object.defineProperty(exports, "formatVersionDiff", { enumerable: true, get: function () { return version_1.formatVersionDiff; } });
 var cursor_1 = require("./cursor");
 Object.defineProperty(exports, "CursorUtils", { enumerable: true, get: function () { return cursor_1.CursorUtils; } });
 Object.defineProperty(exports, "ConsoleUtils", { enumerable: true, get: function () { return cursor_1.ConsoleUtils; } });
+Object.defineProperty(exports, "RAW_EXIT_ALT_SCREEN", { enumerable: true, get: function () { return cursor_1.RAW_EXIT_ALT_SCREEN; } });
+Object.defineProperty(exports, "RAW_SHOW_CURSOR", { enumerable: true, get: function () { return cursor_1.RAW_SHOW_CURSOR; } });
 var terminal_input_1 = require("./terminal-input");
 Object.defineProperty(exports, "TerminalInput", { enumerable: true, get: function () { return terminal_input_1.TerminalInput; } });
 var text_1 = require("./text");

package/dist/ui/utils/text.js

@@ -4,9 +4,10 @@ exports.stripAnsi = stripAnsi;
 exports.getVisualLength = getVisualLength;
 exports.truncatePlainText = truncatePlainText;
 exports.wrapPlainText = wrapPlainText;
-const version_1 = require("./version");
+const ANSI_PATTERN = /\[[0-9;?]*[ -/]*[@-~]/g;
+const OSC8_PATTERN = /]8;;.*?(?:|\\)|]8;;(?:|\\)/g;
 function stripAnsi(text) {
-    return version_1.VersionUtils.stripAnsi(text);
+    return text.replace(OSC8_PATTERN, '').replace(ANSI_PATTERN, '');
 }
 function getVisualLength(text) {
     const cleaned = stripAnsi(text);

package/dist/ui/utils/version.js

@@ -3,100 +3,74 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.VersionUtils = void 0;
+exports.VersionUtils = exports.getVisualLength = exports.stripAnsi = void 0;
+exports.applyVersionPrefix = applyVersionPrefix;
+exports.truncateMiddle = truncateMiddle;
+exports.formatVersionDiff = formatVersionDiff;
 const chalk_1 = __importDefault(require("chalk"));
-/**
- * ANSI escape code pattern for stripping terminal colors
- */
-const ANSI_PATTERN = /\u001b\[[0-9;?]*[ -/]*[@-~]/g;
-const OSC8_PATTERN = /\u001b]8;;.*?(?:\u0007|\u001b\\)|\u001b]8;;(?:\u0007|\u001b\\)/g;
-class VersionUtils {
-    static applyVersionPrefix(originalSpecifier, targetVersion) {
-        // Extract prefix from original specifier (^ or ~)
-        const prefixMatch = originalSpecifier.match(/^([^\d]+)/);
-        const prefix = prefixMatch ? prefixMatch[1] : '';
-        // Return target version with same prefix
-        return prefix + targetVersion;
-    }
-    /**
-     * Strip ANSI escape codes from a string
-     */
-    static stripAnsi(str) {
-        return str.replace(OSC8_PATTERN, '').replace(ANSI_PATTERN, '');
+const text_1 = require("./text");
+Object.defineProperty(exports, "stripAnsi", { enumerable: true, get: function () { return text_1.stripAnsi; } });
+Object.defineProperty(exports, "getVisualLength", { enumerable: true, get: function () { return text_1.getVisualLength; } });
+function applyVersionPrefix(originalSpecifier, targetVersion) {
+    const prefixMatch = originalSpecifier.match(/^([^\d]+)/);
+    const prefix = prefixMatch ? prefixMatch[1] : '';
+    return prefix + targetVersion;
+}
+function truncateMiddle(str, maxLength) {
+    const visualLength = (0, text_1.getVisualLength)(str);
+    if (visualLength <= maxLength) {
+        return str;
     }
-    /**
-     * Get the visual length of a string (excluding ANSI codes)
-     */
-    static getVisualLength(str) {
-        return VersionUtils.stripAnsi(str).length;
+    const ellipsis = '…';
+    const availableLength = maxLength - 1;
+    const startLength = Math.ceil(availableLength / 2);
+    const endLength = Math.floor(availableLength / 2);
+    const rawText = (0, text_1.stripAnsi)(str);
+    const start = rawText.substring(0, startLength);
+    const end = rawText.substring(rawText.length - endLength);
+    return start + ellipsis + end;
+}
+function formatVersionDiff(current, target, colorFn) {
+    if (current === target) {
+        return chalk_1.default.white(target);
     }
-    /**
-     * Truncate text with ellipsis in the middle if it exceeds maxLength
-     * Preserves ANSI color codes and applies them to the ellipsis
-     * @param str The text to truncate (may contain ANSI codes)
-     * @param maxLength The maximum visual length
-     * @returns Truncated text with middle ellipsis if needed
-     */
-    static truncateMiddle(str, maxLength) {
-        const visualLength = this.getVisualLength(str);
-        if (visualLength <= maxLength) {
-            return str;
+    const currentParts = current.split('.').map((part) => parseInt(part) || 0);
+    const targetParts = target.split('.').map((part) => parseInt(part) || 0);
+    let firstDiffSegment = -1;
+    const maxLength = Math.max(currentParts.length, targetParts.length);
+    for (let i = 0; i < maxLength; i++) {
+        const currentPart = currentParts[i] || 0;
+        const targetPart = targetParts[i] || 0;
+        if (currentPart !== targetPart) {
+            firstDiffSegment = i;
+            break;
         }
-        // Need to truncate with ellipsis in the middle
-        const ellipsis = '…';
-        const availableLength = maxLength - 1; // Reserve 1 char for ellipsis
-        const startLength = Math.ceil(availableLength / 2);
-        const endLength = Math.floor(availableLength / 2);
-        // Extract raw text without ANSI codes to calculate positions
-        const rawText = VersionUtils.stripAnsi(str);
-        const start = rawText.substring(0, startLength);
-        const end = rawText.substring(rawText.length - endLength);
-        return start + ellipsis + end;
     }
-    static formatVersionDiff(current, target, colorFn) {
-        if (current === target) {
-            return chalk_1.default.white(target);
-        }
-        // Parse semantic versions into parts
-        const currentParts = current.split('.').map((part) => parseInt(part) || 0);
-        const targetParts = target.split('.').map((part) => parseInt(part) || 0);
-        // Find the first differing version segment (major, minor, or patch)
-        let firstDiffSegment = -1;
-        const maxLength = Math.max(currentParts.length, targetParts.length);
-        for (let i = 0; i < maxLength; i++) {
-            const currentPart = currentParts[i] || 0;
-            const targetPart = targetParts[i] || 0;
-            if (currentPart !== targetPart) {
-                firstDiffSegment = i;
-                break;
-            }
+    if (firstDiffSegment === -1) {
+        return chalk_1.default.white(target);
+    }
+    const result = [];
+    for (let i = 0; i < maxLength; i++) {
+        const targetPart = targetParts[i] || 0;
+        const partStr = targetPart.toString();
+        if (i < firstDiffSegment) {
+            result.push(partStr);
         }
-        if (firstDiffSegment === -1) {
-            // Versions are identical (shouldn't happen due to guard above, but just in case)
-            return chalk_1.default.white(target);
+        else {
+            result.push(colorFn(partStr));
         }
-        // Build the result with proper coloring
-        const result = [];
-        for (let i = 0; i < maxLength; i++) {
-            const targetPart = targetParts[i] || 0;
-            const partStr = targetPart.toString();
-            if (i < firstDiffSegment) {
-                // Unchanged segment - keep white
-                result.push(partStr);
-            }
-            else {
-                // Changed segment or later - apply color
-                result.push(colorFn(partStr));
-            }
-            // Add dot separator if not the last part
-            if (i < maxLength - 1) {
-                // Color the dot the same as the following part
-                const nextPartColor = i + 1 < firstDiffSegment ? chalk_1.default.white : colorFn;
-                result.push(nextPartColor('.'));
-            }
+        if (i < maxLength - 1) {
+            const nextPartColor = i + 1 < firstDiffSegment ? chalk_1.default.white : colorFn;
+            result.push(nextPartColor('.'));
         }
-        return result.join('');
     }
+    return result.join('');
 }
-exports.VersionUtils = VersionUtils;
+exports.VersionUtils = {
+    applyVersionPrefix,
+    truncateMiddle,
+    formatVersionDiff,
+    stripAnsi: text_1.stripAnsi,
+    getVisualLength: text_1.getVisualLength,
+};
 //# sourceMappingURL=version.js.map

package/dist/utils/color.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldDisableColor = shouldDisableColor;
+exports.applyColorSetting = applyColorSetting;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Decide whether colored output should be disabled.
+ *
+ * Precedence (highest first):
+ *   1. An explicit `--no-color` flag (`colorFlag === false`) always wins.
+ *   2. `FORCE_COLOR` keeps colors on.
+ *   3. `NO_COLOR` (any non-empty value) disables them — the de-facto standard.
+ *
+ * chalk v5 already honors the env vars on its own, but the explicit flag does
+ * not flow through automatically, so we resolve the final intent here.
+ */
+function shouldDisableColor(colorFlag, env = process.env) {
+    if (colorFlag === false) {
+        return true;
+    }
+    if (env.FORCE_COLOR) {
+        return false;
+    }
+    return Boolean(env.NO_COLOR);
+}
+/**
+ * Apply the resolved color intent to chalk's global level. Call once at startup
+ * before anything renders.
+ */
+function applyColorSetting(colorFlag, env = process.env) {
+    if (shouldDisableColor(colorFlag, env)) {
+        chalk_1.default.level = 0;
+    }
+}
+//# sourceMappingURL=color.js.map