spark-sql-language-server 0.0.1-beta.5 → 0.2.0-beta.0

package/out-tsc/formatter/core/strategy-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-interface.js","sourceRoot":"","sources":["../../../src/formatter/core/strategy-interface.ts"],"names":[],"mappings":";;;AAuFA;;GAEG;AACH,MAAsB,sBAAsB;IAG1C,SAAS,CAAC,IAAuB;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,IAAuB,EAAE,OAAyB;QACvD,sBAAsB;IACxB,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,IAA8B,EAAE,MAAwB;QAC9E,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,2BAA2B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;OAEG;IACO,cAAc,CAAC,IAA8B,EAAE,MAAwB;QAC/E,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,8BAA8B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;OAEG;IACO,gBAAgB,CAAC,IAA8B,EAAE,MAAwB,EAAE,MAAe;QAClG,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,8BAA8B,CAAC,IAAI,EAAE,MAAM,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED;;OAEG;IACO,eAAe,CAAC,IAA8B,EAAE,MAAwB,EAAE,MAAe;QACjG,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,2BAA2B,CAAC,IAAI,EAAE,MAAM,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACO,iBAAiB,CACzB,MAAgC,EAChC,UAAyC,EACzC,UAAoC,EACpC,MAAwB;QAExB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,8BAA8B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACnD,MAAM,CAAC,2BAA2B,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,iCAAiC,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YAC1D,MAAM,CAAC,8BAA8B,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,CAAC,8BAA8B,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACvD,MAAM,CAAC,2BAA2B,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CACF;AArED,wDAqEC;AAsBD;;GAEG;AACH,MAAa,uBAAuB;IAApC;QACU,eAAU,GAAyB,EAAE,CAAC;IAahD,CAAC;IAXC,QAAQ,CAAC,QAA4B;QACnC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,WAAW,CAAC,GAAsB;QAChC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,gBAAgB;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;CACF;AAdD,0DAcC"}

package/out-tsc/formatter/core/token-helper.d.ts

@@ -0,0 +1,12 @@
+import { CommonTokenStream, Token } from 'antlr4ts';
+export interface Position {
+    line: number;
+    character: number;
+}
+export declare function getPreviousNonHiddenToken(tokens: CommonTokenStream, tokenIndex: number): Token | undefined;
+export declare function getNextNonHiddenToken(tokens: CommonTokenStream, tokenIndex: number): Token | undefined;
+export declare function findTokenIndexByStartIndex(tokens: CommonTokenStream, startIndex: number): number;
+export declare function getPreviousNonHiddenTokenByStartIndex(tokens: CommonTokenStream, startIndex: number): Token | undefined;
+export declare function getNextNonHiddenTokenByStopIndex(tokens: CommonTokenStream, stopIndex: number): Token | undefined;
+export declare function getTokenEndPosition(token: Token): Position;
+//# sourceMappingURL=token-helper.d.ts.map

package/out-tsc/formatter/core/token-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-helper.d.ts","sourceRoot":"","sources":["../../../src/formatter/core/token-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEpD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAW1G;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAYtG;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAQhG;AAED,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,MAAM,GACjB,KAAK,GAAG,SAAS,CAYnB;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAQhH;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,CAe1D"}

package/out-tsc/formatter/core/token-helper.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPreviousNonHiddenToken = getPreviousNonHiddenToken;
+exports.getNextNonHiddenToken = getNextNonHiddenToken;
+exports.findTokenIndexByStartIndex = findTokenIndexByStartIndex;
+exports.getPreviousNonHiddenTokenByStartIndex = getPreviousNonHiddenTokenByStartIndex;
+exports.getNextNonHiddenTokenByStopIndex = getNextNonHiddenTokenByStopIndex;
+exports.getTokenEndPosition = getTokenEndPosition;
+function getPreviousNonHiddenToken(tokens, tokenIndex) {
+    if (tokenIndex < 0) {
+        return undefined;
+    }
+    for (let i = tokenIndex - 1; i >= 0; i--) {
+        const token = tokens.get(i);
+        if (token.channel === 0) {
+            return token;
+        }
+    }
+    return undefined;
+}
+function getNextNonHiddenToken(tokens, tokenIndex) {
+    if (tokenIndex < 0) {
+        return undefined;
+    }
+    const size = tokens.size;
+    for (let i = tokenIndex + 1; i < size; i++) {
+        const token = tokens.get(i);
+        if (token.channel === 0) {
+            return token;
+        }
+    }
+    return undefined;
+}
+function findTokenIndexByStartIndex(tokens, startIndex) {
+    const allTokens = tokens.getTokens();
+    for (let i = 0; i < allTokens.length; i++) {
+        if (allTokens[i].startIndex === startIndex) {
+            return i;
+        }
+    }
+    return -1;
+}
+function getPreviousNonHiddenTokenByStartIndex(tokens, startIndex) {
+    const allTokens = tokens.getTokens();
+    let prevToken;
+    for (const token of allTokens) {
+        if (token.startIndex >= startIndex) {
+            break;
+        }
+        if (token.channel === 0) {
+            prevToken = token;
+        }
+    }
+    return prevToken;
+}
+function getNextNonHiddenTokenByStopIndex(tokens, stopIndex) {
+    const allTokens = tokens.getTokens();
+    for (const token of allTokens) {
+        if (token.startIndex > stopIndex && token.channel === 0) {
+            return token;
+        }
+    }
+    return undefined;
+}
+function getTokenEndPosition(token) {
+    const text = token.text || '';
+    const lines = text.split('\n');
+    if (lines.length === 1) {
+        return {
+            line: token.line - 1,
+            character: token.charPositionInLine + text.length
+        };
+    }
+    return {
+        line: token.line - 1 + lines.length - 1,
+        character: lines[lines.length - 1].length
+    };
+}
+//# sourceMappingURL=token-helper.js.map

package/out-tsc/formatter/core/token-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-helper.js","sourceRoot":"","sources":["../../../src/formatter/core/token-helper.ts"],"names":[],"mappings":"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"}

package/out-tsc/formatter/core/unicode-utils.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Unicode 字符串工具函数
+ *
+ * 解决 ANTLR4ts 的 startIndex/stopIndex (基于 code point) 与
+ * JavaScript String.substring() (基于 UTF-16 code unit) 之间的不匹配问题。
+ *
+ * 问题: emoji 等 surrogate pair 字符在 JavaScript 中占 2 个 UTF-16 code units,
+ * 但 ANTLR 只按 1 个 code point 计算位置,导致索引偏移。
+ */
+/**
+ * Surrogate pair 映射信息
+ */
+export interface SurrogatePairMapping {
+    /** 原始 surrogate pair 字符 */
+    original: string;
+    /** 占位符 */
+    placeholder: string;
+}
+/**
+ * 将 code point 索引转换为 UTF-16 code unit 索引
+ *
+ * @param text - 原始字符串
+ * @param codePointIndex - 基于 code point 的索引
+ * @returns 基于 UTF-16 code unit 的索引
+ */
+export declare function codePointToUtf16Index(text: string, codePointIndex: number): number;
+/**
+ * 将 UTF-16 code unit 索引转换为 code point 索引
+ *
+ * @param text - 原始字符串
+ * @param utf16Index - 基于 UTF-16 code unit 的索引
+ * @returns 基于 code point 的索引
+ */
+export declare function utf16ToCodePointIndex(text: string, utf16Index: number): number;
+/**
+ * 安全地从字符串中提取子串,使用 code point 索引
+ *
+ * @param text - 原始字符串
+ * @param startCp - 起始 code point 索引
+ * @param endCp - 结束 code point 索引 (不包含)
+ * @returns 子串
+ */
+export declare function substringByCodePoints(text: string, startCp: number, endCp?: number): string;
+/**
+ * 获取字符串的 code point 长度
+ *
+ * @param text - 字符串
+ * @returns code point 数量
+ */
+export declare function codePointLength(text: string): number;
+/**
+ * 检查字符串是否包含 surrogate pair 字符
+ *
+ * @param text - 字符串
+ * @returns 是否包含 surrogate pair
+ */
+export declare function hasSurrogatePairs(text: string): boolean;
+/**
+ * 计算字符串中 surrogate pair 字符的数量
+ *
+ * @param text - 字符串
+ * @returns surrogate pair 字符数量
+ */
+export declare function countSurrogatePairs(text: string): number;
+/**
+ * 修正 ANTLR token 的 startIndex/stopIndex 偏移
+ *
+ * 当原始 SQL 包含 surrogate pair 字符时,ANTLR 计算的 startIndex/stopIndex
+ * 会基于 code point,而实际字符串索引基于 UTF-16 code unit。
+ * 此函数返回修正后的 UTF-16 索引。
+ *
+ * @param originalSql - 原始 SQL 字符串
+ * @param antlrIndex - ANTLR 计算的索引 (code point based)
+ * @returns 修正后的 UTF-16 索引
+ */
+export declare function fixAntlrIndex(originalSql: string, antlrIndex: number): number;
+/**
+ * 安全地提取 token 文本,处理 surrogate pair 偏移
+ *
+ * @param originalSql - 原始 SQL 字符串
+ * @param startIndex - token 的 startIndex (code point based)
+ * @param stopIndex - token 的 stopIndex (code point based)
+ * @returns 提取的 token 文本
+ */
+export declare function extractTokenText(originalSql: string, startIndex: number, stopIndex: number): string;
+/**
+ * 将 surrogate pair 字符替换为占位符,以便 ANTLR 正确处理
+ *
+ * 关键: 占位符必须与原始 surrogate pair 字符具有相同的 UTF-16 长度 (2),
+ * 否则格式化后还原时会产生位置偏移,导致空格清理失败。
+ *
+ * @param text - 原始文本
+ * @returns 包含替换后文本和映射信息的对象
+ */
+export declare function replaceSurrogatePairs(text: string): {
+    text: string;
+    mappings: SurrogatePairMapping[];
+};
+/**
+ * 将占位符还原为原始 surrogate pair 字符
+ *
+ * @param text - 包含占位符的文本
+ * @param mappings - 占位符映射信息
+ * @returns 还原后的文本
+ */
+export declare function restoreSurrogatePairs(text: string, mappings: SurrogatePairMapping[]): string;
+//# sourceMappingURL=unicode-utils.d.ts.map

package/out-tsc/formatter/core/unicode-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode-utils.d.ts","sourceRoot":"","sources":["../../../src/formatter/core/unicode-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU;IACV,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAalF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAa9E;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKnG;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAA;CAAE,CA4BtG;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAM5F"}

package/out-tsc/formatter/core/unicode-utils.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * Unicode 字符串工具函数
+ *
+ * 解决 ANTLR4ts 的 startIndex/stopIndex (基于 code point) 与
+ * JavaScript String.substring() (基于 UTF-16 code unit) 之间的不匹配问题。
+ *
+ * 问题: emoji 等 surrogate pair 字符在 JavaScript 中占 2 个 UTF-16 code units,
+ * 但 ANTLR 只按 1 个 code point 计算位置,导致索引偏移。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codePointToUtf16Index = codePointToUtf16Index;
+exports.utf16ToCodePointIndex = utf16ToCodePointIndex;
+exports.substringByCodePoints = substringByCodePoints;
+exports.codePointLength = codePointLength;
+exports.hasSurrogatePairs = hasSurrogatePairs;
+exports.countSurrogatePairs = countSurrogatePairs;
+exports.fixAntlrIndex = fixAntlrIndex;
+exports.extractTokenText = extractTokenText;
+exports.replaceSurrogatePairs = replaceSurrogatePairs;
+exports.restoreSurrogatePairs = restoreSurrogatePairs;
+/**
+ * 将 code point 索引转换为 UTF-16 code unit 索引
+ *
+ * @param text - 原始字符串
+ * @param codePointIndex - 基于 code point 的索引
+ * @returns 基于 UTF-16 code unit 的索引
+ */
+function codePointToUtf16Index(text, codePointIndex) {
+    if (codePointIndex <= 0)
+        return 0;
+    let utf16Index = 0;
+    let cpIndex = 0;
+    for (const cp of text) {
+        if (cpIndex >= codePointIndex)
+            break;
+        utf16Index += cp.length; // surrogate pair 的 length 为 2
+        cpIndex++;
+    }
+    return utf16Index;
+}
+/**
+ * 将 UTF-16 code unit 索引转换为 code point 索引
+ *
+ * @param text - 原始字符串
+ * @param utf16Index - 基于 UTF-16 code unit 的索引
+ * @returns 基于 code point 的索引
+ */
+function utf16ToCodePointIndex(text, utf16Index) {
+    if (utf16Index <= 0)
+        return 0;
+    let cpIndex = 0;
+    let currentUtf16Index = 0;
+    for (const cp of text) {
+        if (currentUtf16Index >= utf16Index)
+            break;
+        currentUtf16Index += cp.length;
+        cpIndex++;
+    }
+    return cpIndex;
+}
+/**
+ * 安全地从字符串中提取子串,使用 code point 索引
+ *
+ * @param text - 原始字符串
+ * @param startCp - 起始 code point 索引
+ * @param endCp - 结束 code point 索引 (不包含)
+ * @returns 子串
+ */
+function substringByCodePoints(text, startCp, endCp) {
+    const codePoints = [...text];
+    const start = Math.max(0, startCp);
+    const end = endCp !== undefined ? Math.min(codePoints.length, endCp) : codePoints.length;
+    return codePoints.slice(start, end).join('');
+}
+/**
+ * 获取字符串的 code point 长度
+ *
+ * @param text - 字符串
+ * @returns code point 数量
+ */
+function codePointLength(text) {
+    return [...text].length;
+}
+/**
+ * 检查字符串是否包含 surrogate pair 字符
+ *
+ * @param text - 字符串
+ * @returns 是否包含 surrogate pair
+ */
+function hasSurrogatePairs(text) {
+    return text.length !== codePointLength(text);
+}
+/**
+ * 计算字符串中 surrogate pair 字符的数量
+ *
+ * @param text - 字符串
+ * @returns surrogate pair 字符数量
+ */
+function countSurrogatePairs(text) {
+    return text.length - codePointLength(text);
+}
+/**
+ * 修正 ANTLR token 的 startIndex/stopIndex 偏移
+ *
+ * 当原始 SQL 包含 surrogate pair 字符时,ANTLR 计算的 startIndex/stopIndex
+ * 会基于 code point,而实际字符串索引基于 UTF-16 code unit。
+ * 此函数返回修正后的 UTF-16 索引。
+ *
+ * @param originalSql - 原始 SQL 字符串
+ * @param antlrIndex - ANTLR 计算的索引 (code point based)
+ * @returns 修正后的 UTF-16 索引
+ */
+function fixAntlrIndex(originalSql, antlrIndex) {
+    return codePointToUtf16Index(originalSql, antlrIndex);
+}
+/**
+ * 安全地提取 token 文本,处理 surrogate pair 偏移
+ *
+ * @param originalSql - 原始 SQL 字符串
+ * @param startIndex - token 的 startIndex (code point based)
+ * @param stopIndex - token 的 stopIndex (code point based)
+ * @returns 提取的 token 文本
+ */
+function extractTokenText(originalSql, startIndex, stopIndex) {
+    const startUtf16 = fixAntlrIndex(originalSql, startIndex);
+    // stopIndex 是 inclusive,所以要 +1
+    const endUtf16 = fixAntlrIndex(originalSql, stopIndex + 1);
+    return originalSql.substring(startUtf16, endUtf16);
+}
+/**
+ * 将 surrogate pair 字符替换为占位符,以便 ANTLR 正确处理
+ *
+ * 关键: 占位符必须与原始 surrogate pair 字符具有相同的 UTF-16 长度 (2),
+ * 否则格式化后还原时会产生位置偏移,导致空格清理失败。
+ *
+ * @param text - 原始文本
+ * @returns 包含替换后文本和映射信息的对象
+ */
+function replaceSurrogatePairs(text) {
+    const mappings = [];
+    let placeholderIndex = 0;
+    const result = [...text]
+        .map(cp => {
+        if (cp.length > 1) {
+            // surrogate pair 字符长度为 2, 占位符也必须长度为 2
+            // 使用 Private Use Area (PUA) 中的字符, 不会与正常 SQL 冲突
+            const placeholder = String.fromCodePoint(0xf0000 + placeholderIndex);
+            // 验证占位符长度
+            if (placeholder.length !== 2) {
+                // 如果 PUA 字符不是 surrogate pair, 用另一个 PUA 字符填充
+                const p = String.fromCodePoint(0xf0000 + placeholderIndex);
+                const p2 = String.fromCodePoint(0xf0100 + placeholderIndex);
+                mappings.push({ original: cp, placeholder: p + p2 });
+                placeholderIndex++;
+                return p + p2;
+            }
+            mappings.push({ original: cp, placeholder });
+            placeholderIndex++;
+            return placeholder;
+        }
+        return cp;
+    })
+        .join('');
+    return { text: result, mappings };
+}
+/**
+ * 将占位符还原为原始 surrogate pair 字符
+ *
+ * @param text - 包含占位符的文本
+ * @param mappings - 占位符映射信息
+ * @returns 还原后的文本
+ */
+function restoreSurrogatePairs(text, mappings) {
+    let result = text;
+    for (const mapping of mappings) {
+        result = result.split(mapping.placeholder).join(mapping.original);
+    }
+    return result;
+}
+//# sourceMappingURL=unicode-utils.js.map

package/out-tsc/formatter/core/unicode-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode-utils.js","sourceRoot":"","sources":["../../../src/formatter/core/unicode-utils.ts"],"names":[],"mappings":"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"}

package/out-tsc/formatter/core/whitespace-writer.d.ts

@@ -0,0 +1,20 @@
+import { CommonTokenStream } from 'antlr4ts';
+import { ParserRuleContext } from 'antlr4ts/ParserRuleContext';
+import { TerminalNode } from 'antlr4ts/tree/TerminalNode';
+import { TextEdit } from 'vscode-languageserver-textdocument';
+export interface WhitespaceWriterConfig {
+    tokens: CommonTokenStream;
+    newlineIndent: string;
+    indent: string;
+    newlineRegex: RegExp;
+    addEdit: (edit: TextEdit) => void;
+}
+export declare class WhitespaceWriter {
+    private readonly config;
+    constructor(config: WhitespaceWriterConfig);
+    updateAfterPreviousTokenByContext(ctx: ParserRuleContext, newText: string): void;
+    updateAfterPreviousTokenByNode(node: TerminalNode, newText: string): void;
+    updateBeforeNextTokenByNode(node: TerminalNode, newText: string): void;
+    updateBeforeNextTokenByContext(ctx: ParserRuleContext, newText: string): void;
+}
+//# sourceMappingURL=whitespace-writer.d.ts.map

package/out-tsc/formatter/core/whitespace-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whitespace-writer.d.ts","sourceRoot":"","sources":["../../../src/formatter/core/whitespace-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAW9D,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;CACnC;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,sBAAsB;IAE3D,iCAAiC,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAkChF,8BAA8B,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAiCzE,2BAA2B,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IA6BtE,8BAA8B,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAiC9E"}

package/out-tsc/formatter/core/whitespace-writer.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhitespaceWriter = void 0;
+const index_1 = require("./index");
+class WhitespaceWriter {
+    constructor(config) {
+        this.config = config;
+    }
+    updateAfterPreviousTokenByContext(ctx, newText) {
+        const firstToken = ctx._start;
+        const previousToken = firstToken.tokenIndex >= 0
+            ? (0, index_1.getPreviousNonHiddenToken)(this.config.tokens, firstToken.tokenIndex)
+            : (0, index_1.getPreviousNonHiddenTokenByStartIndex)(this.config.tokens, firstToken.startIndex);
+        if (!previousToken) {
+            return;
+        }
+        if (!this.config.newlineRegex.test(newText) && previousToken.channel === 2) {
+            newText = this.config.newlineIndent;
+        }
+        const finalText = (0, index_1.buildTextWithPreservedComments)(this.config.tokens, previousToken.stopIndex + 1, firstToken.startIndex, newText, this.config.newlineIndent, this.config.indent, this.config.newlineRegex);
+        this.config.addEdit({
+            range: {
+                start: (0, index_1.getTokenEndPosition)(previousToken),
+                end: { line: ctx.start.line - 1, character: ctx.start.charPositionInLine }
+            },
+            newText: finalText
+        });
+    }
+    updateAfterPreviousTokenByNode(node, newText) {
+        const previousToken = node.symbol.tokenIndex >= 0
+            ? (0, index_1.getPreviousNonHiddenToken)(this.config.tokens, node.symbol.tokenIndex)
+            : (0, index_1.getPreviousNonHiddenTokenByStartIndex)(this.config.tokens, node.symbol.startIndex);
+        if (!previousToken) {
+            return;
+        }
+        if (!this.config.newlineRegex.test(newText) && previousToken.channel === 2) {
+            newText = this.config.newlineIndent;
+        }
+        const finalText = (0, index_1.buildTextWithPreservedComments)(this.config.tokens, previousToken.stopIndex + 1, node.symbol.startIndex, newText, this.config.newlineIndent, this.config.indent, this.config.newlineRegex);
+        this.config.addEdit({
+            range: {
+                start: (0, index_1.getTokenEndPosition)(previousToken),
+                end: { line: node.symbol.line - 1, character: node.symbol.charPositionInLine }
+            },
+            newText: finalText
+        });
+    }
+    updateBeforeNextTokenByNode(node, newText) {
+        const nextToken = node.symbol.tokenIndex >= 0
+            ? (0, index_1.getNextNonHiddenToken)(this.config.tokens, node.symbol.tokenIndex)
+            : (0, index_1.getNextNonHiddenTokenByStopIndex)(this.config.tokens, node.symbol.stopIndex);
+        if (!nextToken) {
+            return;
+        }
+        const finalText = (0, index_1.buildTextWithPreservedComments)(this.config.tokens, node.symbol.stopIndex + 1, nextToken.startIndex, newText, this.config.newlineIndent, this.config.indent, this.config.newlineRegex);
+        this.config.addEdit({
+            range: {
+                start: { line: node.symbol.line - 1, character: node.symbol.charPositionInLine + (node.text?.length || 0) },
+                end: { line: nextToken.line - 1, character: nextToken.charPositionInLine }
+            },
+            newText: finalText
+        });
+    }
+    updateBeforeNextTokenByContext(ctx, newText) {
+        const lastToken = ctx._stop;
+        if (!lastToken) {
+            return;
+        }
+        const nextToken = lastToken.tokenIndex >= 0
+            ? (0, index_1.getNextNonHiddenToken)(this.config.tokens, lastToken.tokenIndex)
+            : (0, index_1.getNextNonHiddenTokenByStopIndex)(this.config.tokens, lastToken.stopIndex);
+        if (!nextToken) {
+            return;
+        }
+        const finalText = (0, index_1.buildTextWithPreservedComments)(this.config.tokens, lastToken.stopIndex + 1, nextToken.startIndex, newText, this.config.newlineIndent, this.config.indent, this.config.newlineRegex);
+        this.config.addEdit({
+            range: {
+                start: (0, index_1.getTokenEndPosition)(lastToken),
+                end: { line: nextToken.line - 1, character: nextToken.charPositionInLine }
+            },
+            newText: finalText
+        });
+    }
+}
+exports.WhitespaceWriter = WhitespaceWriter;
+//# sourceMappingURL=whitespace-writer.js.map

package/out-tsc/formatter/core/whitespace-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whitespace-writer.js","sourceRoot":"","sources":["../../../src/formatter/core/whitespace-writer.ts"],"names":[],"mappings":"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"}

package/out-tsc/formatter/formatter-adapter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Formatter Adapter
+ *
+ * Provides a unified interface for formatting, allowing switching between
+ * the legacy SpaceReplacerFormatVisitor and the new StrategyBasedFormatter.
+ *
+ * Supports statement-by-statement formatting with error isolation:
+ * - Each statement is formatted independently
+ * - Failed statements are preserved as-is
+ * - Other statements continue to be formatted normally
+ */
+import { CommonTokenStream } from 'antlr4ts';
+import { TextEdit } from 'vscode-languageserver-textdocument';
+import { ProgramContext } from '../lib/SparkSQLParser';
+import { SparkSQLFormattingOptions, FormattingError } from '../typings';
+export type FormatterType = 'legacy' | 'strategy';
+/**
+ * Configuration for formatter selection
+ */
+export interface FormatterConfig {
+    /**
+     * Which formatter to use
+     * - 'legacy': Use the original SpaceReplacerFormatVisitor (default for stability)
+     * - 'strategy': Use the new StrategyBasedFormatter (for testing new architecture)
+     */
+    type: FormatterType;
+}
+/**
+ * Default formatter configuration
+ */
+export declare const DEFAULT_FORMATTER_CONFIG: FormatterConfig;
+/**
+ * Format SQL with statement-by-statement error isolation
+ * Each statement is formatted independently; failed statements are preserved as-is
+ */
+export declare function formatSQLFromText(sql: string, options: SparkSQLFormattingOptions, config?: FormatterConfig): {
+    edits: TextEdit[];
+    errors: FormattingError[];
+};
+/**
+ * Format SQL using the configured formatter
+ */
+export declare function formatSQL(tree: ProgramContext, tokens: CommonTokenStream, options: SparkSQLFormattingOptions, config?: FormatterConfig): {
+    edits: TextEdit[];
+    errors: FormattingError[];
+};
+/**
+ * Create a formatter instance based on configuration
+ */
+export declare function createFormatter(tokens: CommonTokenStream, options: SparkSQLFormattingOptions, config?: FormatterConfig): {
+    format: (tree: ProgramContext) => {
+        edits: TextEdit[];
+        errors: FormattingError[];
+    };
+};
+//# sourceMappingURL=formatter-adapter.d.ts.map

package/out-tsc/formatter/formatter-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter-adapter.d.ts","sourceRoot":"","sources":["../../src/formatter/formatter-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAe,iBAAiB,EAAS,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAM9D,OAAO,EAAkB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGxE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAEtC,CAAC;AA2hBF;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,yBAAyB,EAClC,MAAM,GAAE,eAA0C,GACjD;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CA8ElD;AAkDD;;GAEG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,yBAAyB,EAClC,MAAM,GAAE,eAA0C,GACjD;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAQlD;AAuCD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,yBAAyB,EAClC,MAAM,GAAE,eAA0C,GACjD;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAAC,MAAM,EAAE,eAAe,EAAE,CAAA;KAAE,CAAA;CAAE,CA2BxF"}