@aster-cloud/aster-lang-ts 0.0.1

package/dist/src/lsp/navigation/rename.js

@@ -0,0 +1,161 @@
+/**
+ * LSP Rename 处理器
+ * 提供符号重命名功能（包括准备阶段和执行阶段）
+ */
+import { getAllModules, updateDocumentIndex } from '../index.js';
+import { captureWordAt, findTokenPositionsSafe, offsetToPos, ensureUri, uriToFsPath, tokenNameAt } from './shared.js';
+import { promises as fsPromises } from 'node:fs';
+const defaultSettings = { rename: { scope: 'workspace' }, streaming: { referencesChunk: 200, renameChunk: 200, logChunks: false } };
+/**
+ * 注册 Rename 相关处理器（onRenameRequest 和 onPrepareRename）
+ * @param connection LSP 连接对象
+ * @param documents 文档管理器
+ * @param getOrParse 文档解析函数
+ * @param getDocumentSettings 获取文档设置的函数
+ */
+export function registerRenameHandlers(connection, documents, getOrParse, getDocumentSettings) {
+    const _beginProgress = (token, title) => {
+        try {
+            if (!token)
+                return;
+            connection.sendProgress('$/progress', token, { kind: 'begin', title });
+        }
+        catch {
+            // ignore
+        }
+    };
+    const _reportProgress = (token, message) => {
+        try {
+            if (!token)
+                return;
+            connection.sendProgress('$/progress', token, { kind: 'report', message });
+        }
+        catch {
+            // ignore
+        }
+    };
+    const _endProgress = (token) => {
+        try {
+            if (!token)
+                return;
+            connection.sendProgress('$/progress', token, { kind: 'end' });
+        }
+        catch {
+            // ignore
+        }
+    };
+    // onRenameRequest: 重命名符号
+    connection.onRenameRequest(async (params, token) => {
+        const doc = documents.get(params.textDocument.uri);
+        if (!doc)
+            return null;
+        const text = doc.getText();
+        const offset = doc.offsetAt(params.position);
+        const word = captureWordAt(text, offset);
+        if (!word)
+            return null;
+        const changes = {};
+        const settings = await getDocumentSettings(doc.uri).catch(() => defaultSettings);
+        const scope = settings.rename?.scope ?? 'workspace';
+        const openUris = new Set(documents.keys());
+        let processed = 0;
+        const modules = getAllModules();
+        const total = modules.length;
+        try {
+            await updateDocumentIndex(doc.uri, doc.getText());
+        }
+        catch { }
+        _beginProgress(params.workDoneToken, 'Aster rename');
+        const CHUNK = settings.streaming?.renameChunk ?? 200;
+        const BATCH_SIZE = 20; // 批量并发读取文件数
+        let editsInChunk = 0;
+        // 批量异步处理模块
+        for (let i = 0; i < modules.length; i += BATCH_SIZE) {
+            if (token?.isCancellationRequested)
+                break;
+            const batch = modules.slice(i, i + BATCH_SIZE);
+            const batchResults = await Promise.all(batch.map(async (rec) => {
+                if (scope === 'open' && !openUris.has(rec.uri))
+                    return null;
+                try {
+                    const uri = ensureUri(rec.uri);
+                    const fsPath = uriToFsPath(rec.uri) || rec.uri;
+                    const t = await fsPromises.readFile(fsPath, 'utf8');
+                    const positions = findTokenPositionsSafe(t, word);
+                    if (positions.length === 0)
+                        return null;
+                    const edits = positions.map(p => ({
+                        range: { start: offsetToPos(t, p.start), end: offsetToPos(t, p.end) },
+                        newText: params.newName
+                    }));
+                    return { uri, edits };
+                }
+                catch {
+                    return null;
+                }
+            }));
+            // 合并结果
+            for (const result of batchResults) {
+                if (!result)
+                    continue;
+                changes[result.uri] = (changes[result.uri] || []).concat(result.edits);
+                editsInChunk += result.edits.length;
+                if (editsInChunk >= CHUNK) {
+                    _reportProgress(params.workDoneToken, `rename: +${editsInChunk}`);
+                    editsInChunk = 0;
+                }
+            }
+            processed += batch.length;
+            if (processed % 50 === 0 || processed === total) {
+                _reportProgress(params.workDoneToken, `${processed}/${total}`);
+            }
+        }
+        _endProgress(params.workDoneToken);
+        return { changes };
+    });
+    // onPrepareRename: 预先校验是否可重命名并返回精确范围
+    connection.onPrepareRename(params => {
+        const doc = documents.get(params.textDocument.uri);
+        if (!doc)
+            return null;
+        const entry = getOrParse(doc);
+        const { tokens: toks } = entry;
+        const nameAt = tokenNameAt(toks, params.position);
+        if (!nameAt) {
+            // 光标未命中有效标识符，直接拒绝
+            return null;
+        }
+        const text = doc.getText();
+        const offset = doc.offsetAt(params.position);
+        const precisePositions = findTokenPositionsSafe(text, nameAt);
+        const precise = precisePositions.find(pos => offset >= pos.start && offset <= pos.end);
+        if (precise) {
+            return {
+                range: {
+                    start: offsetToPos(text, precise.start),
+                    end: offsetToPos(text, precise.end),
+                },
+                placeholder: text.slice(precise.start, precise.end),
+            };
+        }
+        // 词法精确匹配失败时回退到简单的词边界捕获
+        const fallback = captureWordAt(text, offset);
+        if (!fallback)
+            return null;
+        const isWord = (c) => /[A-Za-z0-9_.]/.test(c);
+        let start = offset;
+        while (start > 0 && isWord(text[start - 1]))
+            start--;
+        let end = offset;
+        while (end < text.length && isWord(text[end]))
+            end++;
+        return {
+            range: {
+                start: offsetToPos(text, start),
+                end: offsetToPos(text, end),
+            },
+            placeholder: text.slice(start, end),
+        };
+    });
+}
+//# sourceMappingURL=rename.js.map

package/dist/src/lsp/navigation/rename.js.map

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

package/dist/src/lsp/navigation/shared.d.ts

@@ -0,0 +1,175 @@
+/**
+ * LSP Navigation 共享工具函数
+ * 提供文本处理、偏移量转换和 AST 辅助功能
+ */
+import { TextDocument } from 'vscode-languageserver-textdocument';
+import type { Module as AstModule, Declaration as AstDecl, Func as AstFunc, Block as AstBlock, Span } from '../../types.js';
+/**
+ * 捕获指定偏移量处的单词
+ * @param text 文本内容
+ * @param offset 偏移量位置
+ * @returns 捕获的单词，如果不在单词位置则返回 null
+ */
+export declare function captureWordAt(text: string, offset: number): string | null;
+/**
+ * 查找文本中所有单词出现位置
+ * @param text 文本内容
+ * @param word 要查找的单词
+ * @returns 单词位置数组（包含 start 和 end 偏移量）
+ */
+export declare function findWordPositions(text: string, word: string): Array<{
+    start: number;
+    end: number;
+}>;
+/**
+ * 安全查找标记位置（支持回退到正则匹配）
+ * @param text 文本内容
+ * @param word 要查找的标记或单词
+ * @returns 标记位置数组，如果词法分析失败则回退到正则匹配
+ */
+export declare function findTokenPositionsSafe(text: string, word: string): Array<{
+    start: number;
+    end: number;
+}>;
+/**
+ * 构建行起始位置数组
+ * @param text 文本内容
+ * @returns 每行起始偏移量数组
+ */
+export declare function buildLineStarts(text: string): number[];
+/**
+ * 将 AST 坐标（1-based 行列）转换为文本偏移量
+ * @param starts 行起始位置数组
+ * @param line AST 行号（1-based）
+ * @param col AST 列号（1-based）
+ * @returns 文本偏移量
+ */
+export declare function toOffset(starts: readonly number[], line: number, col: number): number;
+/**
+ * 将文本偏移量转换为 LSP Position（0-based 行列）
+ * @param text 文本内容
+ * @param off 偏移量
+ * @returns LSP Position 对象
+ */
+export declare function offsetToPos(text: string, off: number): {
+    line: number;
+    character: number;
+};
+/**
+ * 确保路径为 file:// URI 格式
+ * @param u 文件路径或 URI
+ * @returns file:// URI 字符串
+ */
+export declare function ensureUri(u: string): string;
+/**
+ * URI 转文件系统路径
+ * @param u file:// URI 字符串
+ * @returns 文件系统路径，转换失败返回 null
+ */
+export declare function uriToFsPath(u: string): string | null;
+/**
+ * 将 Span 转换为 Range，如果无 Span 则返回整个文档范围
+ * @param span AST Span 对象（可选）
+ * @param doc 文档对象
+ * @returns LSP Range 对象
+ */
+export declare function spanOrDoc(span: Span | undefined, doc: TextDocument): import('vscode-languageserver/node.js').Range;
+/**
+ * 生成函数详情字符串（参数和返回类型）
+ * @param f 函数 AST 节点
+ * @returns 函数签名字符串，包含参数、返回类型和效果
+ */
+export declare function funcDetail(f: AstFunc): string;
+/**
+ * 判断 LSP Position 是否在 Span 范围内
+ * @param span AST Span 对象（可选）
+ * @param pos LSP Position（0-based 行列）
+ * @returns 是否在范围内
+ */
+export declare function within(span: Span | undefined, pos: {
+    line: number;
+    character: number;
+}): boolean;
+/**
+ * 查找指定位置处的顶层声明
+ * @param m 模块 AST
+ * @param pos LSP Position
+ * @returns 匹配的声明节点，优先返回函数声明
+ */
+export declare function findDeclAt(m: AstModule, pos: {
+    line: number;
+    character: number;
+}): AstDecl | null;
+/**
+ * 获取指定位置处的标记名称
+ * @param tokens 词法标记数组
+ * @param pos LSP Position
+ * @returns 标记名称（标识符或类型标识符），如果未找到则返回 null
+ */
+export declare function tokenNameAt(tokens: readonly any[], pos: {
+    line: number;
+    character: number;
+}): string | null;
+/**
+ * 将 Span 转换为 LSP Location 对象
+ * @param uri 文档 URI
+ * @param sp AST Span 对象
+ * @returns LSP Location 对象
+ */
+export declare function toLocation(uri: string, sp: Span): import('vscode-languageserver/node.js').Location;
+/**
+ * 查找模式匹配绑定的详细信息
+ * @param fn 函数 AST 节点
+ * @param name 绑定名称
+ * @param pos LSP Position
+ * @returns 绑定信息（包含名称和可选的类型），如果未找到则返回 null
+ */
+export declare function findPatternBindingDetail(fn: AstFunc, name: string, pos: {
+    line: number;
+    character: number;
+}): {
+    name: string;
+    ofType?: string | undefined;
+} | null;
+/**
+ * 在函数体中查找局部 let 绑定及其表达式
+ * @param b 块 AST 节点
+ * @param name 绑定名称
+ * @returns let 绑定信息（包含 span 和表达式），如果未找到则返回 null
+ */
+export declare function findLocalLetWithExpr(b: AstBlock | null, name: string): {
+    span: Span;
+    expr: any;
+} | null;
+/**
+ * 收集函数体中所有 let 绑定及其 Span
+ * @param b 块 AST 节点
+ * @returns 绑定名称到 Span 的映射
+ */
+export declare function collectLetsWithSpan(b: AstBlock | null): Map<string, Span>;
+/**
+ * 构建枚举变体名称到 Span 的映射
+ * @param m 模块 AST
+ * @returns 变体名称到 Span 的映射
+ */
+export declare function enumVariantSpanMap(m: AstModule): Map<string, Span>;
+/**
+ * 构建数据字段到 Span 的映射（key: TypeName.field）
+ * @param m 模块 AST
+ * @returns 字段键（TypeName.field）到 Span 的映射
+ */
+export declare function dataFieldSpanMap(m: AstModule): Map<string, Span>;
+/**
+ * 查找指定位置处的构造字段信息
+ * @param m 模块 AST
+ * @param pos LSP Position
+ * @returns 构造字段信息（包含类型名和字段名），如果未找到则返回 null
+ */
+export declare function findConstructFieldAt(m: AstModule, pos: {
+    line: number;
+    character: number;
+}): {
+    typeName: string;
+    field: string;
+} | null;
+//# sourceMappingURL=shared.d.ts.map

package/dist/src/lsp/navigation/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/lsp/navigation/shared.ts"],"names":[],"mappings":"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"}