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

package/out-tsc/tests/folding/join-folding.test.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * JOIN 块折叠测试
+ *
+ * 测试 JOIN 块折叠功能：
+ * - 2+ 个连续 JOIN 整体折叠
+ * - 单个 JOIN 不单独折叠
+ * - 各种 JOIN 类型支持
+ * - CTE 内的 JOIN 块折叠
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const test_utils_1 = require("./test-utils");
+const lsp_server_1 = require("../../lsp-server");
+describe('Folding - JOIN Block Folding', () => {
+    let server;
+    beforeEach(() => {
+        server = new lsp_server_1.LSPServer();
+    });
+    describe('多个连续 JOIN', () => {
+        it('should fold multiple JOINs block', () => {
+            const sql = `SELECT
+  u.id,
+  u.name,
+  o.order_id,
+  oi.product_name
+FROM
+  users u
+    INNER JOIN orders o
+      ON u.id = o.user_id
+    LEFT JOIN order_items oi
+      ON o.id = oi.order_id
+    LEFT JOIN products p
+      ON oi.product_id = p.id
+    LEFT JOIN categories c
+      ON p.category_id = c.id
+WHERE
+  u.status = 'active'
+ORDER BY
+  u.id`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('Multiple JOINs folding ranges:');
+            ranges.forEach((r, i) => {
+                const lines = sql.split('\n');
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} (${lines[r.startLine]?.trim().substring(0, 50)})`);
+            });
+            // 应该产生 SELECT 块折叠 + JOIN 块折叠
+            (0, chai_1.expect)(ranges.length, 'Should produce folding ranges').to.be.greaterThan(0);
+            // 验证 JOIN 块折叠 (lines 7-14)
+            const joinRange = ranges.find(r => r.startLine === 7 && r.endLine === 14);
+            (0, chai_1.expect)(joinRange, 'JOIN block should have a folding range (lines 7-14)').to.not.be.undefined;
+        });
+        it('should fold JOINs with ON conditions', () => {
+            const sql = `SELECT
+  *
+FROM
+  t1
+    INNER JOIN t2
+      ON t1.id = t2.id
+      AND t1.status = t2.status
+    LEFT JOIN t3
+      ON t2.id = t3.id
+WHERE
+  t1.active = true`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('JOINs with ON conditions folding ranges:');
+            ranges.forEach((r, i) => {
+                const lines = sql.split('\n');
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} (${lines[r.startLine]?.trim().substring(0, 50)})`);
+            });
+            // 应该产生 JOIN 块折叠
+            (0, chai_1.expect)(ranges.length, 'Should produce folding ranges').to.be.greaterThan(0);
+        });
+        it('should fold JOINs with USING conditions', () => {
+            const sql = `SELECT
+  *
+FROM
+  t1
+    INNER JOIN t2 USING (id, name)
+    LEFT JOIN t3 USING (id)
+WHERE
+  t1.active = true`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('JOINs with USING conditions folding ranges:');
+            ranges.forEach((r, i) => {
+                const lines = sql.split('\n');
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} (${lines[r.startLine]?.trim().substring(0, 50)})`);
+            });
+            // 应该产生 JOIN 块折叠
+            (0, chai_1.expect)(ranges.length, 'Should produce folding ranges').to.be.greaterThan(0);
+        });
+    });
+    describe('单个 JOIN', () => {
+        it('should not fold single JOIN independently', () => {
+            const sql = `SELECT
+  *
+FROM
+  t1
+    INNER JOIN t2 ON t1.id = t2.id
+WHERE
+  t1.status = 'active'`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('Single JOIN folding ranges:');
+            ranges.forEach((r, i) => {
+                const lines = sql.split('\n');
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} (${lines[r.startLine]?.trim().substring(0, 50)})`);
+            });
+            // 单 JOIN 不应该有独立的 JOIN 块折叠
+            // 只应该有 SELECT 块折叠
+            (0, chai_1.expect)(ranges.length, 'Should produce SELECT block folding').to.be.greaterThanOrEqual(1);
+        });
+    });
+    describe('CTE 内的 JOIN 块', () => {
+        it('should fold JOINs block in CTE', () => {
+            const sql = `WITH user_orders AS (
+  SELECT
+    u.id,
+    o.order_id
+  FROM
+    users u
+      INNER JOIN orders o
+        ON u.id = o.user_id
+      LEFT JOIN order_items oi
+        ON o.id = oi.order_id
+      LEFT JOIN products p
+        ON oi.product_id = p.id
+)
+SELECT
+  *
+FROM
+  user_orders`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('CTE JOINs block folding ranges:');
+            ranges.forEach((r, i) => {
+                const lines = sql.split('\n');
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} (${lines[r.startLine]?.trim().substring(0, 50)})`);
+            });
+            // 应该产生 CTE 折叠 + JOIN 块折叠
+            (0, chai_1.expect)(ranges.length, 'Should produce folding ranges').to.be.greaterThan(0);
+            // 验证 JOIN 块折叠 (lines 6-11)
+            const joinRange = ranges.find(r => r.startLine === 6 && r.endLine === 11);
+            (0, chai_1.expect)(joinRange, 'JOIN block in CTE should have a folding range (lines 6-11)').to.not.be.undefined;
+        });
+    });
+    describe('混合 JOIN 类型', () => {
+        it('should fold mixed JOIN types', () => {
+            const sql = `SELECT
+  *
+FROM
+  t1
+    INNER JOIN t2 ON t1.id = t2.id
+    CROSS JOIN t3
+    LEFT SEMI JOIN t4 ON t1.id = t4.id
+WHERE
+  t1.active = true`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('Mixed JOIN types folding ranges:');
+            ranges.forEach((r, i) => {
+                const lines = sql.split('\n');
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} (${lines[r.startLine]?.trim().substring(0, 50)})`);
+            });
+            // 应该产生 JOIN 块折叠
+            (0, chai_1.expect)(ranges.length, 'Should produce folding ranges').to.be.greaterThan(0);
+        });
+    });
+});
+//# sourceMappingURL=join-folding.test.js.map

package/out-tsc/tests/folding/join-folding.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-folding.test.js","sourceRoot":"","sources":["../../../src/tests/folding/join-folding.test.ts"],"names":[],"mappings":"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"}

package/out-tsc/tests/folding/kind-classification.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * FoldingRangeKind 分类测试
+ *
+ * 测试折叠范围的语义分类：
+ * - CTE 使用 kind=Imports
+ * - 注释使用 kind=Comment
+ * - #region 使用 kind=Region
+ * - SQL 结构使用默认 kind=undefined
+ */
+export {};
+//# sourceMappingURL=kind-classification.test.d.ts.map

package/out-tsc/tests/folding/kind-classification.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-classification.test.d.ts","sourceRoot":"","sources":["../../../src/tests/folding/kind-classification.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/out-tsc/tests/folding/kind-classification.test.js

@@ -0,0 +1,270 @@
+"use strict";
+/**
+ * FoldingRangeKind 分类测试
+ *
+ * 测试折叠范围的语义分类：
+ * - CTE 使用 kind=Imports
+ * - 注释使用 kind=Comment
+ * - #region 使用 kind=Region
+ * - SQL 结构使用默认 kind=undefined
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const lsp = __importStar(require("vscode-languageserver"));
+const test_utils_1 = require("./test-utils");
+const lsp_server_1 = require("../../lsp-server");
+describe('Folding - FoldingRangeKind Classification', () => {
+    let server;
+    beforeEach(() => {
+        server = new lsp_server_1.LSPServer();
+    });
+    describe('CTE 折叠 (kind=Imports)', () => {
+        it('should fold CTE with kind=Imports', () => {
+            const sql = `WITH active_users AS (
+  SELECT
+    user_id,
+    name,
+    email
+  FROM
+    users
+  WHERE
+    status = 'active'
+)
+SELECT
+  *
+FROM
+  active_users`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('CTE kind=Imports folding ranges:');
+            ranges.forEach((r, i) => {
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} kind=${r.kind || 'undefined'}`);
+            });
+            // 验证 CTE 折叠存在且 kind=Imports
+            const cteRange = ranges.find(r => r.kind === lsp.FoldingRangeKind.Imports);
+            (0, chai_1.expect)(cteRange, 'CTE should have kind=Imports').to.not.be.undefined;
+        });
+        it('should fold multiple CTEs with kind=Imports', () => {
+            const sql = `WITH active_users AS (
+  SELECT
+    user_id,
+    name
+  FROM
+    users
+  WHERE
+    status = 'active'
+),
+user_orders AS (
+  SELECT
+    user_id,
+    order_id
+  FROM
+    orders
+  WHERE
+    order_date >= '2024-01-01'
+)
+SELECT
+  au.user_id,
+  au.name,
+  COUNT(uo.order_id) AS order_count
+FROM
+  active_users au
+    LEFT JOIN user_orders uo
+      ON au.user_id = uo.user_id
+GROUP BY
+  au.user_id,
+  au.name`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('Multiple CTEs kind=Imports folding ranges:');
+            ranges.forEach((r, i) => {
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} kind=${r.kind || 'undefined'}`);
+            });
+            // 验证有多个 CTE 折叠且 kind=Imports
+            const importsRanges = ranges.filter(r => r.kind === lsp.FoldingRangeKind.Imports);
+            (0, chai_1.expect)(importsRanges.length, 'Should have multiple CTE ranges with kind=Imports').to.be.greaterThanOrEqual(2);
+        });
+    });
+    describe('注释折叠 (kind=Comment)', () => {
+        it('should fold block comment with kind=Comment', () => {
+            const sql = `/*
+ * User Analytics Query
+ * This query calculates user engagement metrics
+ * based on order history.
+ */
+SELECT
+  user_id,
+  name
+FROM
+  users`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('Block comment kind=Comment folding ranges:');
+            ranges.forEach((r, i) => {
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} kind=${r.kind || 'undefined'}`);
+            });
+            // 验证注释折叠存在且 kind=Comment
+            const commentRange = ranges.find(r => r.kind === lsp.FoldingRangeKind.Comment);
+            (0, chai_1.expect)(commentRange, 'Block comment should have kind=Comment').to.not.be.undefined;
+        });
+        it('should fold consecutive -- comments with kind=Comment', () => {
+            const sql = `--
+-- User Analytics Query
+-- This query calculates user engagement
+-- metrics based on order history.
+--
+SELECT
+  user_id,
+  name
+FROM
+  users`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('Consecutive -- comments kind=Comment folding ranges:');
+            ranges.forEach((r, i) => {
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} kind=${r.kind || 'undefined'}`);
+            });
+            // 验证连续 -- 注释折叠存在且 kind=Comment
+            const commentRange = ranges.find(r => r.kind === lsp.FoldingRangeKind.Comment && r.startLine === 0);
+            (0, chai_1.expect)(commentRange, 'Consecutive -- comments should have kind=Comment').to.not.be.undefined;
+        });
+    });
+    describe('#region 折叠 (kind=Region)', () => {
+        it('should fold region with kind=Region', () => {
+            const sql = `-- #region User Analytics
+SELECT
+  user_id,
+  name
+FROM
+  users
+WHERE
+  status = 'active'
+-- #endregion`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('#region kind=Region folding ranges:');
+            ranges.forEach((r, i) => {
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} kind=${r.kind || 'undefined'}`);
+            });
+            // 验证 region 折叠存在且 kind=Region
+            const regionRange = ranges.find(r => r.kind === lsp.FoldingRangeKind.Region);
+            (0, chai_1.expect)(regionRange, '#region should have kind=Region').to.not.be.undefined;
+        });
+    });
+    describe('SQL 结构折叠 (kind=undefined)', () => {
+        it('should fold SELECT with kind=undefined', () => {
+            const sql = `SELECT
+  user_id,
+  name,
+  email
+FROM
+  users
+WHERE
+  status = 'active'`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('SELECT kind=undefined folding ranges:');
+            ranges.forEach((r, i) => {
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} kind=${r.kind || 'undefined'}`);
+            });
+            // SELECT 块折叠应该使用默认 kind
+            const selectRange = ranges.find(r => r.startLine === 0 && r.endLine === 7);
+            (0, chai_1.expect)(selectRange, 'SELECT block should exist').to.not.be.undefined;
+            if (selectRange) {
+                (0, chai_1.expect)(selectRange.kind, 'SELECT should have kind=undefined').to.be.undefined;
+            }
+        });
+        it('should fold JOIN block with kind=undefined', () => {
+            const sql = `SELECT
+  *
+FROM
+  t1
+    INNER JOIN t2
+      ON t1.id = t2.id
+    LEFT JOIN t3
+      ON t2.id = t3.id
+WHERE
+  t1.active = true`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('JOIN block kind=undefined folding ranges:');
+            ranges.forEach((r, i) => {
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} kind=${r.kind || 'undefined'}`);
+            });
+            // JOIN 块折叠应该使用默认 kind
+            const joinRange = ranges.find(r => r.startLine === 4 && r.endLine === 7);
+            (0, chai_1.expect)(joinRange, 'JOIN block should exist').to.not.be.undefined;
+            if (joinRange) {
+                (0, chai_1.expect)(joinRange.kind, 'JOIN should have kind=undefined').to.be.undefined;
+            }
+        });
+        it('should fold CASE WHEN with kind=undefined', () => {
+            const sql = `SELECT
+  user_id,
+  name,
+  CASE
+    WHEN total_orders > 100 THEN 'VIP'
+    WHEN total_orders > 50 THEN 'Gold'
+    ELSE 'Regular'
+  END AS tier
+FROM
+  users`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('CASE WHEN kind=undefined folding ranges:');
+            ranges.forEach((r, i) => {
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} kind=${r.kind || 'undefined'}`);
+            });
+            // CASE WHEN 折叠应该使用默认 kind
+            const caseRange = ranges.find(r => r.startLine === 3 && r.endLine === 7);
+            (0, chai_1.expect)(caseRange, 'CASE WHEN should exist').to.not.be.undefined;
+            if (caseRange) {
+                (0, chai_1.expect)(caseRange.kind, 'CASE WHEN should have kind=undefined').to.be.undefined;
+            }
+        });
+        it('should fold VALUES with kind=undefined', () => {
+            const sql = `INSERT INTO users (id, name, email)
+  VALUES
+    (1, 'Alice', 'alice@example.com'),
+    (2, 'Bob', 'bob@example.com'),
+    (3, 'Charlie', 'charlie@example.com')`;
+            const ranges = (0, test_utils_1.getFoldingRanges)(server, sql);
+            console.log('VALUES kind=undefined folding ranges:');
+            ranges.forEach((r, i) => {
+                console.log(`  ${i}: lines ${r.startLine}-${r.endLine} kind=${r.kind || 'undefined'}`);
+            });
+            // VALUES 块折叠应该使用默认 kind
+            const valuesRange = ranges.find(r => r.startLine === 1 && r.endLine === 4);
+            (0, chai_1.expect)(valuesRange, 'VALUES block should exist').to.not.be.undefined;
+            if (valuesRange) {
+                (0, chai_1.expect)(valuesRange.kind, 'VALUES should have kind=undefined').to.be.undefined;
+            }
+        });
+    });
+});
+//# sourceMappingURL=kind-classification.test.js.map

package/out-tsc/tests/folding/kind-classification.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-classification.test.js","sourceRoot":"","sources":["../../../src/tests/folding/kind-classification.test.ts"],"names":[],"mappings":"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"}

package/out-tsc/tests/folding/level1-statement.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Level 1: 语句级折叠测试
+ *
+ * 测试整个完整语句的折叠,适合多语句脚本场景
+ * 包括: CREATE TABLE, CREATE VIEW, INSERT, WITH, ALTER, DROP 等
+ */
+export {};
+//# sourceMappingURL=level1-statement.test.d.ts.map

package/out-tsc/tests/folding/level1-statement.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level1-statement.test.d.ts","sourceRoot":"","sources":["../../../src/tests/folding/level1-statement.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}