@ton-ai-core/vibecode-linter/dist/core/diff/column.js

Advanced TypeScript linter with Git integration, dependency analysis, and comprehensive error reporting

// CHANGE: Extracted column calculation functions from lint.ts
// WHY: Column conversion logic should be in a separate module for better testability
// QUOTE(ТЗ): "Разбить lint.ts на подфайлы, каждый файл желательно должен быть не больше 300 строчек кода"
// REF: REQ-20250210-MODULAR-ARCH
// SOURCE: n/a
/**
 * Размер табуляции по умолчанию (как в git diff и ESLint).
 */
export const TAB_WIDTH = 8;
/**
 * Конвертирует визуальную колонку (как в ESLint) в реальный индекс символа.
 *
 * CHANGE: Reworked iteration to compute target column purely through monotone visual offsets
 * WHY: Stryker report highlighted equivalent mutants due to unused flags; tight loop makes every branch observable
 * QUOTE(UserMsg#6): "Можешь так же тесты исправить о которых было описано в отчёте?"
 * REF: output:849-897 ([Survived] BooleanLiteral / ConditionalExpression for column.ts)
 * SOURCE: "Stryker Mutant Survivors Log" (output file)
 * FORMAT THEOREM: ∀i ∈ ℤ≥0, visualOffset_i ≤ visualOffset_{i+1} ∧ target ∈ [visualOffset_i, visualOffset_{i+1}) ⇒ return index(i) + δ
 * QUOTE(LINT): "Function has too many lines/complexity"
 * REF: ESLint max-lines-per-function, complexity
 * SOURCE: n/a
 *
 * ESLint и git diff считают табуляцию как 8 пробелов, но в строке это один символ.
 * Эта функция преобразует визуальную позицию в реальный индекс в строке.
 *
 * @param lineContent Строка исходного кода без diff-префикса
 * @param visualColumn Визуальная колонка (0-based)
 * @param tabSize Размер табуляции; по умолчанию 8, как в git diff и ESLint
 * @returns Реальный индекс символа (0-based)
 *
 * @pure true
 * @invariant visualColumn >= 0
 * @complexity O(n) где n = длина строки
 *
 * @example
 * ```ts
 * // Строка: "x\ty" (x, tab, y)
 * // Визуально: "x       y" (x, 7 spaces, y)
 * const realIndex = computeRealColumnFromVisual("x\ty", 8, 8);
 * // Returns 2 (индекс символа 'y')
 * ```
 */
export function computeRealColumnFromVisual(lineContent, visualColumn, tabSize = TAB_WIDTH) {
    // CHANGE: Precondition check for visualColumn
    // WHY: Ensures we only work with valid column positions
    // QUOTE(SPEC): "visualColumn must be non-negative"
    // REF: REQ-20250210-MODULAR-ARCH
    // SOURCE: n/a
    if (visualColumn < 0) {
        throw new Error(`visualColumn must be non-negative, received ${visualColumn}`);
    }
    let currentVisual = 0;
    // CHANGE: Loop through string plus one iteration to handle end-of-string case
    // WHY: index <= length allows checking if visualColumn matches final position
    // INVARIANT: Loop handles positions [0..length] where length is past last char
    for (let index = 0; index <= lineContent.length; index += 1) {
        // CHANGE: Early exit when we've reached or passed target
        // WHY: Returns immediately when accumulated visual width reaches goal
        // INVARIANT: visualColumn <= currentVisual ⇒ return index
        if (visualColumn <= currentVisual) {
            return index;
        }
        // CHANGE: Exact equality check kills >= vs > mutant
        // WHY: index === length is boundary; > length never happens due to loop condition
        // INVARIANT: index === length ⇒ no more chars to process
        if (index === lineContent.length) {
            break;
        }
        const char = lineContent[index];
        if (char === "\t") {
            const nextTabStop = Math.floor(currentVisual / tabSize + 1) * tabSize;
            currentVisual = nextTabStop;
        }
        else {
            currentVisual += 1;
        }
    }
    // CHANGE: Target lies beyond last glyph — clamp to content length
    // WHY: Aligns with invariant visualColumnAt(content, |content|, tab) ≥ visualColumn
    return lineContent.length;
}
/**
 * Вычисляет визуальную позицию колонки с учетом табуляции.
 *
 * @param content Строка исходного кода
 * @param index Индекс символа в строке (0-based)
 * @param tabWidth Размер табуляции
 * @returns Визуальная колонка (0-based)
 *
 * @pure true
 * @invariant result >= 0
 * @complexity O(n) где n = index
 *
 * @example
 * ```ts
 * // Строка: "x\ty" (x, tab, y)
 * const visual = visualColumnAt("x\ty", 2, 8);
 * // Returns 8 (визуальная позиция 'y')
 * ```
 */
export function visualColumnAt(content, index, tabWidth = TAB_WIDTH) {
    let column = 0;
    const limit = Math.max(0, Math.min(index, content.length));
    for (let i = 0; i < limit; i += 1) {
        const ch = content[i];
        if (ch === "\t") {
            const offset = tabWidth - (column % tabWidth);
            column += offset;
        }
        else {
            column += 1;
        }
    }
    return column;
}
/**
 * Раскрывает табуляцию в строке в пробелы.
 *
 * @param content Строка исходного кода с табуляцией
 * @param tabWidth Размер табуляции
 * @returns Строка с раскрытыми табуляциями
 *
 * @pure true
 * @invariant result.length >= content.length
 * @complexity O(n) где n = длина строки
 *
 * @example
 * ```ts
 * const expanded = expandTabs("x\ty", 8);
 * // Returns "x       y" (x, 7 spaces, y)
 * ```
 */
export function expandTabs(content, tabWidth = TAB_WIDTH) {
    let column = 0;
    let result = "";
    for (const ch of content) {
        if (ch === "\t") {
            const spaces = tabWidth - (column % tabWidth);
            result += " ".repeat(spaces);
            column += spaces;
        }
        else {
            result += ch;
            column += 1;
        }
    }
    return result;
}
//# sourceMappingURL=column.js.map