@intlayer/lsp 8.11.2 → 8.11.4

package/dist/esm/index.mjs

@@ -1,103 +1,409 @@
 #!/usr/bin/env node
-import { existsSync, readFileSync } from "node:fs";
-import { isAbsolute, join } from "node:path";
+import { escapeRegularExpression, findFieldRangesInFile, offsetToRange } from "./findFieldInFile.mjs";
+import { findKeyAtOffset } from "./findKeyAtOffset.mjs";
+import { findContentFieldAtOffset, findKeyInContentFile } from "./findKeyInContentFile.mjs";
+import { findUsageFieldAtOffset } from "./findUsageFieldAtOffset.mjs";
+import { Location, Position, ProposedFeatures, Range, TextDocumentSyncKind, TextDocuments, createConnection } from "vscode-languageserver/node.js";
+import { existsSync } from "node:fs";
+import { readFile, readdir } from "node:fs/promises";
+import { extname, isAbsolute, join } from "node:path";
 import { pathToFileURL } from "node:url";
-import { getConfiguration } from "@intlayer/config";
+import { getConfiguration } from "@intlayer/config/node";
 import { getUnmergedDictionaries } from "@intlayer/unmerged-dictionaries-entry";
-import { Location, Position, ProposedFeatures, Range, TextDocumentSyncKind, TextDocuments, createConnection } from "vscode-languageserver/node.js";
 import { TextDocument } from "vscode-languageserver-textdocument";
 
 //#region src/index.ts
-/**
-* Intlayer content getters that take a dictionary key as their first argument.
-* They are exported (under the same names) by every `*-intlayer` package, so we
-* only need to match the call name + the string-literal key to support all of:
-*   next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer,
-*   preact-intlayer, solid-intlayer, angular-intlayer, lit-intlayer,
-*   express-intlayer, hono-intlayer, fastify-intlayer, adonis-intlayer, intlayer
-*/
-const INTLAYER_GETTERS = [
-	"useIntlayer",
-	"getIntlayer",
-	"useDictionary",
-	"getDictionary"
-];
-const buildGetterRegex = () => new RegExp(`\\b(${INTLAYER_GETTERS.join("|")})\\b\\s*(?:<[^<>()]*>)?\\s*\\(\\s*(['"\`])([^'"\`]+)\\2`, "g");
 const connection = createConnection(ProposedFeatures.all);
 const documents = new TextDocuments(TextDocument);
+/**
+* Send a log line to the client's Output panel (View → Output → "Intlayer LSP").
+* Uses connection.console.log so it travels over the JSON-RPC channel and never
+* touches stdout (which is reserved for the LSP protocol).
+*/
+const log = (message) => connection.console.log(`[Intlayer LSP] ${message}`);
 let workspaceRoot;
 /**
 * Resolve (and cache) the Intlayer configuration for the current workspace.
 * The LSP process cwd is not the project root, so we must resolve the config
-* from `workspaceRoot` to get the right `system`/`build` paths.
+* from `workspaceRoot` to get the right `system`/`build`/`content` paths.
 */
 let cachedConfig = null;
+/**
+* Cached unmerged dictionaries with a short TTL so that running
+* `intlayer build` during a session picks up without a full re-init.
+*/
+let cachedDictionaries = null;
+let dictionariesCachedAt = 0;
+const DICTIONARY_CACHE_TTL_MS = 5e3;
+let cachedSourceExtensions = null;
+let cachedExcludedDirs = null;
+let cachedFileExclusionRegexes = null;
+/**
+* Cached list of source file paths.
+* Walking the directory tree is the dominant cost on every Go-to-Definition
+* from a content file. We cache the result for 30 s and re-scan only when
+* the client reports a watched-file change or the config is invalidated.
+*/
+let cachedSourceFiles = null;
+let sourceFilesCachedAt = 0;
+const SOURCE_FILES_CACHE_TTL_MS = 3e4;
+const invalidateConfigCaches = () => {
+	cachedConfig = null;
+	cachedDictionaries = null;
+	dictionariesCachedAt = 0;
+	cachedSourceExtensions = null;
+	cachedExcludedDirs = null;
+	cachedFileExclusionRegexes = null;
+	cachedSourceFiles = null;
+	sourceFilesCachedAt = 0;
+};
 const getWorkspaceConfig = () => {
 	if (cachedConfig) return cachedConfig;
-	if (!workspaceRoot) return null;
-	const { system, build } = getConfiguration({ baseDir: workspaceRoot });
-	cachedConfig = {
-		system,
-		build
+	if (!workspaceRoot) {
+		log("getWorkspaceConfig — no workspace root, skipping");
+		return null;
+	}
+	try {
+		log(`getWorkspaceConfig — loading config from: ${workspaceRoot}`);
+		const { system, build, content } = getConfiguration({ baseDir: workspaceRoot });
+		cachedConfig = {
+			system,
+			build,
+			content
+		};
+		log(`getWorkspaceConfig — OK  baseDir=${system.baseDir}  unmergedDictionariesDir=${system.unmergedDictionariesDir}`);
+		return cachedConfig;
+	} catch (error) {
+		log(`getWorkspaceConfig — FAILED: ${error}`);
+		return null;
+	}
+};
+const getUnmergedDictionariesCached = () => {
+	const now = Date.now();
+	if (cachedDictionaries && now - dictionariesCachedAt < DICTIONARY_CACHE_TTL_MS) return cachedDictionaries;
+	const config = getWorkspaceConfig();
+	if (!config) return {};
+	cachedDictionaries = getUnmergedDictionaries(config);
+	dictionariesCachedAt = now;
+	return cachedDictionaries;
+};
+const getSourceExtensions = () => {
+	if (cachedSourceExtensions) return cachedSourceExtensions;
+	const traversePattern = getWorkspaceConfig()?.build.traversePattern ?? [];
+	cachedSourceExtensions = new Set(traversePattern.filter((pattern) => !pattern.startsWith("!")).flatMap((pattern) => {
+		const match = pattern.match(/\.\{([^}]+)\}/);
+		return match?.[1] ? match[1].split(",").map((extension) => `.${extension.trim()}`) : [];
+	}));
+	return cachedSourceExtensions;
+};
+const getExcludedDirs = () => {
+	if (cachedExcludedDirs) return cachedExcludedDirs;
+	const traversePattern = getWorkspaceConfig()?.build.traversePattern ?? [];
+	cachedExcludedDirs = new Set(traversePattern.filter((pattern) => /^!\*\*\/[^*/]+\/\*\*$/.test(pattern)).map((pattern) => pattern.replace(/^!\*\*\//, "").replace(/\/\*\*$/, "")));
+	return cachedExcludedDirs;
+};
+const getFileExclusionRegexes = () => {
+	if (cachedFileExclusionRegexes) return cachedFileExclusionRegexes;
+	cachedFileExclusionRegexes = (getWorkspaceConfig()?.build.traversePattern ?? []).filter((pattern) => pattern.startsWith("!") && !/^!\*\*\/[^*/]+\/\*\*$/.test(pattern)).map((pattern) => {
+		const inner = pattern.replace(/^!(\*\*\/)*/, "");
+		return new RegExp(`${inner.replace(/\./g, "\\.").replace(/\*/g, "[^\\/]*")}$`);
+	});
+	return cachedFileExclusionRegexes;
+};
+const isContentFile = (uri) => {
+	return (getWorkspaceConfig()?.content.fileExtensions ?? []).some((extension) => uri.endsWith(extension));
+};
+/** Read a file as UTF-8, returning null on any error. */
+const tryReadFile = async (filePath) => {
+	try {
+		return await readFile(filePath, "utf-8");
+	} catch {
+		return null;
+	}
+};
+/**
+* Run `callback` over every item with at most `limit` tasks in-flight at once.
+* JS is single-threaded so `results.push` inside callback is race-free.
+*/
+const runConcurrent = async (items, callback, limit = 50) => {
+	if (items.length === 0) return;
+	let index = 0;
+	const worker = async () => {
+		while (index < items.length) await callback(items[index++]);
 	};
-	return cachedConfig;
+	await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+};
+/**
+* Recursively collect all source-file paths under `directory`.
+* Uses async readdir so it does not block the Node.js event loop.
+*/
+const collectSourceFiles = async (directory) => {
+	const results = [];
+	const sourceExtensions = getSourceExtensions();
+	const excludedDirs = getExcludedDirs();
+	const fileExclusionRegexes = getFileExclusionRegexes();
+	const contentExtensions = getWorkspaceConfig()?.content.fileExtensions ?? [];
+	const visit = async (dir) => {
+		let entries;
+		try {
+			entries = await readdir(dir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		await Promise.all(entries.map(async (entry) => {
+			if (entry.isDirectory()) {
+				if (!excludedDirs.has(entry.name)) await visit(join(dir, entry.name));
+			} else if (sourceExtensions.has(extname(entry.name)) && !contentExtensions.some((extension) => entry.name.endsWith(extension)) && !fileExclusionRegexes.some((regularExpression) => regularExpression.test(entry.name))) results.push(join(dir, entry.name));
+		}));
+	};
+	await visit(directory);
+	return results;
+};
+/** Find the `key: "<key>"` line inside a content file so the cursor lands on it. */
+const getKeyRange = async (absolutePath, key) => {
+	try {
+		const lines = (await readFile(absolutePath, "utf-8")).split(/\r?\n/);
+		const keyRegularExpression = new RegExp(`key\\s*:\\s*['"\`]${key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}['"\`]`);
+		for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+			const column = lines[lineIndex]?.search(keyRegularExpression);
+			if (column !== void 0 && column !== -1) return Range.create(Position.create(lineIndex, column), Position.create(lineIndex, lines[lineIndex].length));
+		}
+	} catch {}
+	return Range.create(Position.create(0, 0), Position.create(0, 0));
 };
 /**
 * Return every `.content` file location that declares the given key.
 * A key can be split across several content files (merged dictionaries), so we
 * return one `Location` per source file, pointing at the `key:` declaration.
 */
-const getContentDeclarationLocations = (key) => {
+const getContentDeclarationLocations = async (key) => {
 	const config = getWorkspaceConfig();
 	if (!config) return [];
-	const unmergedDictionaries = getUnmergedDictionaries(config);
+	const unmergedDictionaries = getUnmergedDictionariesCached();
 	const dictionaries = Object.values(unmergedDictionaries).flat().filter((dictionary) => dictionary?.key === key && dictionary.filePath);
 	const locations = [];
-	for (const dictionary of dictionaries) {
+	await runConcurrent(dictionaries, async (dictionary) => {
 		const filePath = dictionary.filePath;
 		const absolutePath = isAbsolute(filePath) ? filePath : join(config.system.baseDir, filePath);
-		if (!existsSync(absolutePath)) continue;
-		locations.push(Location.create(pathToFileURL(absolutePath).href, getKeyRange(absolutePath, key)));
-	}
+		if (!existsSync(absolutePath)) return;
+		locations.push(Location.create(pathToFileURL(absolutePath).href, await getKeyRange(absolutePath, key)));
+	});
 	return locations;
 };
-/** Find the `key: "<key>"` line inside a content file so the cursor lands on it. */
-const getKeyRange = (absolutePath, key) => {
-	try {
-		const lines = readFileSync(absolutePath, "utf-8").split(/\r?\n/);
-		const keyRegex = new RegExp(`key\\s*:\\s*['"\`]${key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}['"\`]`);
-		for (let line = 0; line < lines.length; line++) {
-			const column = lines[line].search(keyRegex);
-			if (column !== -1) return Range.create(Position.create(line, column), Position.create(line, lines[line].length));
+/**
+* Return the cached source-file list, re-scanning only when the cache has
+* expired or been explicitly invalidated (config change, watched-file event).
+*/
+const getSourceFiles = async (directory) => {
+	if (cachedSourceFiles && Date.now() - sourceFilesCachedAt < SOURCE_FILES_CACHE_TTL_MS) return cachedSourceFiles;
+	const startTime = Date.now();
+	cachedSourceFiles = await collectSourceFiles(directory);
+	sourceFilesCachedAt = Date.now();
+	log(`source files scanned: ${cachedSourceFiles.length} file(s) in ${Date.now() - startTime}ms`);
+	return cachedSourceFiles;
+};
+/**
+* Return every source-file location that calls useIntlayer / getIntlayer with
+* the given key.
+*/
+const getKeyUsageLocations = async (key) => {
+	const config = getWorkspaceConfig();
+	if (!config) return [];
+	const usageRegularExpression = new RegExp(`\\b(?:useIntlayer|getIntlayer)\\b\\s*(?:<[^<>()]*>)?\\s*\\(\\s*(['"\`])${escapeRegularExpression(key)}\\1`, "g");
+	const filePaths = await getSourceFiles(config.system.baseDir);
+	const locations = [];
+	const startTime = Date.now();
+	await runConcurrent(filePaths, async (filePath) => {
+		const text = await tryReadFile(filePath);
+		if (!text?.includes(key)) return;
+		for (const match of text.matchAll(usageRegularExpression)) {
+			const matchStart = match.index;
+			const matchEnd = matchStart + match[0].length;
+			locations.push(Location.create(pathToFileURL(filePath).href, offsetToRange(text, matchStart, matchEnd)));
 		}
-	} catch {}
+	});
+	log(`getKeyUsageLocations("${key}") — ${filePaths.length} file(s) searched in ${Date.now() - startTime}ms → ${locations.length} hit(s)`);
+	return locations;
+};
+/**
+* Return every source-file location that accesses the field at `fieldPath` on
+* the result of `useIntlayer(dictionaryKey)` / `getIntlayer(dictionaryKey)`.
+*
+* `fieldPath` is an array of property names from the content root to the
+* target field (e.g. `['searchInput', 'text']` for a nested field).
+* Single-element paths (e.g. `['greet']`) behave like the previous
+* single-`fieldName` API.
+*/
+const getFieldUsageLocations = async (dictionaryKey, fieldPath) => {
+	const config = getWorkspaceConfig();
+	if (!config || fieldPath.length === 0) return [];
+	const leafFieldName = fieldPath[fieldPath.length - 1];
+	const escapedKey = escapeRegularExpression(dictionaryKey);
+	const escapedLeaf = escapeRegularExpression(leafFieldName);
+	const useCallRegularExpression = new RegExp(`\\b(?:useIntlayer|getIntlayer)\\b(?:<[^<>()]*>)?\\s*\\(\\s*['"\`]${escapedKey}['"\`]`);
+	const filePaths = await getSourceFiles(config.system.baseDir);
+	const locations = [];
+	const startTime = Date.now();
+	await runConcurrent(filePaths, async (filePath) => {
+		const text = await tryReadFile(filePath);
+		if (!text) return;
+		if (!text.includes(dictionaryKey)) return;
+		if (fieldPath.some((segment) => !text.includes(segment))) return;
+		if (!useCallRegularExpression.test(text)) return;
+		for (const range of findFieldRangesInFile(text, escapedKey, leafFieldName, escapedLeaf, fieldPath)) locations.push(Location.create(pathToFileURL(filePath).href, range));
+	});
+	log(`getFieldUsageLocations("${dictionaryKey}.${fieldPath.join(".")}") — ${filePaths.length} file(s) searched in ${Date.now() - startTime}ms → ${locations.length} hit(s)`);
+	return locations;
+};
+/**
+* Find the line/column of `fieldName` as a property key inside a content file.
+* Looks for `fieldName:` (the field definition), not just any occurrence.
+* Falls back to the top of the file if the field cannot be located.
+*/
+const getFieldRangeInContentFile = async (absolutePath, fieldName) => {
+	const content = await tryReadFile(absolutePath);
+	if (!content) return Range.create(Position.create(0, 0), Position.create(0, 0));
+	const lines = content.split(/\r?\n/);
+	const fieldRegularExpression = new RegExp(`(?<![.\\w])${escapeRegularExpression(fieldName)}(?![\\w])\\s*:`);
+	for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+		const line = lines[lineIndex];
+		const matchPosition = line.search(fieldRegularExpression);
+		if (matchPosition === -1) continue;
+		const column = line.indexOf(fieldName, matchPosition);
+		if (column === -1) continue;
+		return Range.create(Position.create(lineIndex, column), Position.create(lineIndex, column + fieldName.length));
+	}
 	return Range.create(Position.create(0, 0), Position.create(0, 0));
 };
-connection.onInitialize((params) => {
-	workspaceRoot = params.rootPath || (params.workspaceFolders?.[0]?.uri ? decodeURIComponent(new URL(params.workspaceFolders[0].uri).pathname) : void 0);
-	cachedConfig = null;
+/**
+* Return every content-file location where `fieldName` is defined as a
+* property of the dictionary with the given `dictionaryKey`.
+*/
+const getContentFieldLocations = async (dictionaryKey, fieldName) => {
+	const config = getWorkspaceConfig();
+	if (!config) return [];
+	const unmergedDictionaries = getUnmergedDictionariesCached();
+	const dictionaries = Object.values(unmergedDictionaries).flat().filter((dictionary) => dictionary?.key === dictionaryKey && dictionary.filePath);
+	const locations = [];
+	await runConcurrent(dictionaries, async (dictionary) => {
+		const filePath = dictionary.filePath;
+		const absolutePath = isAbsolute(filePath) ? filePath : join(config.system.baseDir, filePath);
+		if (!existsSync(absolutePath)) return;
+		locations.push(Location.create(pathToFileURL(absolutePath).href, await getFieldRangeInContentFile(absolutePath, fieldName)));
+	});
+	return locations;
+};
+connection.onInitialize((parameters) => {
+	workspaceRoot = parameters.rootPath || (parameters.workspaceFolders?.[0]?.uri ? decodeURIComponent(new URL(parameters.workspaceFolders[0].uri).pathname) : void 0);
+	invalidateConfigCaches();
+	log(`initialized — workspaceRoot: ${workspaceRoot ?? "(none)"}`);
+	if (parameters.workspaceFolders?.length) log(`workspaceFolders: ${parameters.workspaceFolders.map((folder) => folder.name).join(", ")}`);
 	return { capabilities: {
 		textDocumentSync: TextDocumentSyncKind.Incremental,
-		definitionProvider: true
+		definitionProvider: true,
+		referencesProvider: true
 	} };
 });
-connection.onDefinition((params) => {
-	const document = documents.get(params.textDocument.uri);
+connection.onDefinition(async (parameters) => {
+	const uri = parameters.textDocument.uri;
+	const position = parameters.position;
+	const document = documents.get(uri);
+	if (!document) {
+		log(`onDefinition — document not found in cache: ${uri}`);
+		return null;
+	}
+	const text = document.getText();
+	const offset = document.offsetAt(position);
+	log(`onDefinition — ${uri.replace(/^file:\/\//, "").split("/").slice(-2).join("/")} ${position.line}:${position.character}`);
+	if (isContentFile(uri)) {
+		log("onDefinition — detected content file");
+		const key = findKeyInContentFile(text, offset);
+		if (key) {
+			log(`onDefinition — key declaration: "${key}" → searching call sites`);
+			const locations = await getKeyUsageLocations(key);
+			log(`onDefinition — found ${locations.length} call site(s) for key "${key}"`);
+			return locations.length ? locations : null;
+		}
+		const fieldInfo = findContentFieldAtOffset(text, offset);
+		if (fieldInfo) {
+			log(`onDefinition — field: "${fieldInfo.dictionaryKey}.${fieldInfo.fieldPath.join(".")}" → searching usages`);
+			const locations = await getFieldUsageLocations(fieldInfo.dictionaryKey, fieldInfo.fieldPath);
+			log(`onDefinition — found ${locations.length} usage(s) for field path "${fieldInfo.fieldPath.join(".")}"`);
+			return locations.length ? locations : null;
+		}
+		log("onDefinition — cursor not on a key or field declaration, no result");
+		return null;
+	}
+	const key = findKeyAtOffset(text, offset);
+	if (key) {
+		log(`onDefinition — useIntlayer key: "${key}" → searching content declarations`);
+		const locations = await getContentDeclarationLocations(key);
+		log(`onDefinition — found ${locations.length} content declaration(s) for key "${key}"`);
+		return locations.length ? locations : null;
+	}
+	const usageField = findUsageFieldAtOffset(text, offset);
+	if (usageField) {
+		log(`onDefinition — usage field: "${usageField.dictionaryKey}.${usageField.fieldName}" → searching content field`);
+		const locations = await getContentFieldLocations(usageField.dictionaryKey, usageField.fieldName);
+		log(`onDefinition — found ${locations.length} content file(s) with field "${usageField.fieldName}"`);
+		return locations.length ? locations : null;
+	}
+	log("onDefinition — no Intlayer key at cursor, no result");
+	return null;
+});
+/**
+* "Find All References" handler (Shift+F12).
+*
+* From a content file, returns every source-file location that uses the key or
+* field at the cursor — the reverse direction of Go-to-Definition.
+*
+* From a source file, returns all content-file declarations for the key or
+* field at the cursor — complementing what Go-to-Definition already handles.
+*/
+connection.onReferences(async (parameters) => {
+	const uri = parameters.textDocument.uri;
+	const position = parameters.position;
+	const document = documents.get(uri);
 	if (!document) return null;
 	const text = document.getText();
-	const offset = document.offsetAt(params.position);
-	const regex = buildGetterRegex();
-	for (const match of text.matchAll(regex)) {
-		const start = match.index;
-		const end = start + match[0].length;
-		if (offset >= start && offset <= end) {
-			const key = match[3];
-			const locations = getContentDeclarationLocations(key);
+	const offset = document.offsetAt(position);
+	log(`onReferences — ${uri.replace(/^file:\/\//, "").split("/").slice(-2).join("/")} ${position.line}:${position.character}`);
+	if (isContentFile(uri)) {
+		const key = findKeyInContentFile(text, offset);
+		if (key) {
+			const locations = await getKeyUsageLocations(key);
+			log(`onReferences — key "${key}" → ${locations.length} call site(s)`);
 			return locations.length ? locations : null;
 		}
+		const fieldInfo = findContentFieldAtOffset(text, offset);
+		if (fieldInfo) {
+			const locations = await getFieldUsageLocations(fieldInfo.dictionaryKey, fieldInfo.fieldPath);
+			log(`onReferences — field "${fieldInfo.fieldPath.join(".")}" → ${locations.length} usage(s)`);
+			return locations.length ? locations : null;
+		}
+		return null;
+	}
+	const key = findKeyAtOffset(text, offset);
+	if (key) {
+		const locations = await getContentDeclarationLocations(key);
+		log(`onReferences — key "${key}" → ${locations.length} declaration(s)`);
+		return locations.length ? locations : null;
+	}
+	const usageField = findUsageFieldAtOffset(text, offset);
+	if (usageField) {
+		const locations = await getContentFieldLocations(usageField.dictionaryKey, usageField.fieldName);
+		log(`onReferences — field "${usageField.fieldName}" → ${locations.length} content definition(s)`);
+		return locations.length ? locations : null;
 	}
 	return null;
 });
+connection.onDidChangeWatchedFiles(() => {
+	cachedSourceFiles = null;
+	sourceFilesCachedAt = 0;
+	cachedDictionaries = null;
+	dictionariesCachedAt = 0;
+	log("watched files changed — source file list and dictionary cache invalidated");
+});
 documents.listen(connection);
 connection.listen();
 

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { existsSync, readFileSync } from 'node:fs';\nimport { isAbsolute, join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { getConfiguration } from '@intlayer/config';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { getUnmergedDictionaries } from '@intlayer/unmerged-dictionaries-entry';\nimport {\n  createConnection,\n  type InitializeParams,\n  type InitializeResult,\n  Location,\n  Position,\n  ProposedFeatures,\n  Range,\n  TextDocumentSyncKind,\n  TextDocuments,\n} from 'vscode-languageserver/node.js';\nimport { TextDocument } from 'vscode-languageserver-textdocument';\n\n/**\n * Intlayer content getters that take a dictionary key as their first argument.\n * They are exported (under the same names) by every `*-intlayer` package, so we\n * only need to match the call name + the string-literal key to support all of:\n *   next-intlayer, react-intlayer, vue-intlayer, svelte-intlayer,\n *   preact-intlayer, solid-intlayer, angular-intlayer, lit-intlayer,\n *   express-intlayer, hono-intlayer, fastify-intlayer, adonis-intlayer, intlayer\n */\nconst INTLAYER_GETTERS = [\n  'useIntlayer',\n  'getIntlayer',\n  'useDictionary',\n  'getDictionary',\n] as const;\n\n// Matches e.g. `useIntlayer(\"homepage\")`, `getIntlayer<T>('homepage', locale)`\n// Capture group 3 is the dictionary key.\nconst buildGetterRegex = () =>\n  new RegExp(\n    `\\\\b(${INTLAYER_GETTERS.join('|')})\\\\b\\\\s*(?:<[^<>()]*>)?\\\\s*\\\\(\\\\s*(['\"\\`])([^'\"\\`]+)\\\\2`,\n    'g'\n  );\n\n// Create a connection for the server, using Node's IPC as a transport.\n// Also include all preview / proposed LSP features.\nconst connection = createConnection(ProposedFeatures.all);\n\n// Create a simple text document manager.\nconst documents: TextDocuments<TextDocument> = new TextDocuments(TextDocument);\n\nlet workspaceRoot: string | null | undefined;\n\n/**\n * Resolve (and cache) the Intlayer configuration for the current workspace.\n * The LSP process cwd is not the project root, so we must resolve the config\n * from `workspaceRoot` to get the right `system`/`build` paths.\n */\nlet cachedConfig: Pick<IntlayerConfig, 'system' | 'build'> | null = null;\nconst getWorkspaceConfig = () => {\n  if (cachedConfig) return cachedConfig;\n  if (!workspaceRoot) return null;\n\n  const { system, build } = getConfiguration({ baseDir: workspaceRoot });\n  cachedConfig = { system, build };\n  return cachedConfig;\n};\n\n/**\n * Return every `.content` file location that declares the given key.\n * A key can be split across several content files (merged dictionaries), so we\n * return one `Location` per source file, pointing at the `key:` declaration.\n */\nconst getContentDeclarationLocations = (key: string): Location[] => {\n  const config = getWorkspaceConfig();\n  if (!config) return [];\n\n  const unmergedDictionaries = getUnmergedDictionaries(config);\n\n  const dictionaries = Object.values(unmergedDictionaries)\n    .flat()\n    .filter((dictionary) => dictionary?.key === key && dictionary.filePath);\n\n  const locations: Location[] = [];\n\n  for (const dictionary of dictionaries) {\n    const filePath = dictionary.filePath!;\n    const absolutePath = isAbsolute(filePath)\n      ? filePath\n      : join(config.system.baseDir, filePath);\n\n    if (!existsSync(absolutePath)) continue;\n\n    locations.push(\n      Location.create(\n        pathToFileURL(absolutePath).href,\n        getKeyRange(absolutePath, key)\n      )\n    );\n  }\n\n  return locations;\n};\n\n/** Find the `key: \"<key>\"` line inside a content file so the cursor lands on it. */\nconst getKeyRange = (absolutePath: string, key: string): Range => {\n  try {\n    const content = readFileSync(absolutePath, 'utf-8');\n    const lines = content.split(/\\r?\\n/);\n    const keyRegex = new RegExp(\n      `key\\\\s*:\\\\s*['\"\\`]${key.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}['\"\\`]`\n    );\n\n    for (let line = 0; line < lines.length; line++) {\n      const column = lines[line].search(keyRegex);\n      if (column !== -1) {\n        return Range.create(\n          Position.create(line, column),\n          Position.create(line, lines[line].length)\n        );\n      }\n    }\n  } catch {\n    // fall through to the top of the file\n  }\n\n  return Range.create(Position.create(0, 0), Position.create(0, 0));\n};\n\nconnection.onInitialize((params: InitializeParams): InitializeResult => {\n  workspaceRoot =\n    params.rootPath ||\n    (params.workspaceFolders?.[0]?.uri\n      ? decodeURIComponent(new URL(params.workspaceFolders[0].uri).pathname)\n      : undefined);\n  cachedConfig = null;\n\n  return {\n    capabilities: {\n      textDocumentSync: TextDocumentSyncKind.Incremental,\n      // Declare that this server provides \"Go to Definition\" support\n      definitionProvider: true,\n    },\n  };\n});\n\nconnection.onDefinition((params) => {\n  const document = documents.get(params.textDocument.uri);\n  if (!document) return null;\n\n  const text = document.getText();\n  const offset = document.offsetAt(params.position);\n\n  const regex = buildGetterRegex();\n\n  for (const match of text.matchAll(regex)) {\n    const start = match.index;\n    const end = start + match[0].length;\n\n    // Only resolve the call the cursor is actually inside of.\n    if (offset >= start && offset <= end) {\n      const key = match[3];\n      const locations = getContentDeclarationLocations(key);\n      return locations.length ? locations : null;\n    }\n  }\n\n  return null;\n});\n\n// Make the text document manager listen on the connection\n// for open, change and close text document events\ndocuments.listen(connection);\n\n// Listen on the connection\nconnection.listen();\n"],"mappings":";;;;;;;;;;;;;;;;;;AA4BA,MAAM,mBAAmB;CACvB;CACA;CACA;CACA;AACF;AAIA,MAAM,yBACJ,IAAI,OACF,OAAO,iBAAiB,KAAK,GAAG,EAAE,0DAClC,GACF;AAIF,MAAM,aAAa,iBAAiB,iBAAiB,GAAG;AAGxD,MAAM,YAAyC,IAAI,cAAc,YAAY;AAE7E,IAAI;;;;;;AAOJ,IAAI,eAAgE;AACpE,MAAM,2BAA2B;CAC/B,IAAI,cAAc,OAAO;CACzB,IAAI,CAAC,eAAe,OAAO;CAE3B,MAAM,EAAE,QAAQ,UAAU,iBAAiB,EAAE,SAAS,cAAc,CAAC;CACrE,eAAe;EAAE;EAAQ;CAAM;CAC/B,OAAO;AACT;;;;;;AAOA,MAAM,kCAAkC,QAA4B;CAClE,MAAM,SAAS,mBAAmB;CAClC,IAAI,CAAC,QAAQ,OAAO,CAAC;CAErB,MAAM,uBAAuB,wBAAwB,MAAM;CAE3D,MAAM,eAAe,OAAO,OAAO,oBAAoB,EACpD,KAAK,EACL,QAAQ,eAAe,YAAY,QAAQ,OAAO,WAAW,QAAQ;CAExE,MAAM,YAAwB,CAAC;CAE/B,KAAK,MAAM,cAAc,cAAc;EACrC,MAAM,WAAW,WAAW;EAC5B,MAAM,eAAe,WAAW,QAAQ,IACpC,WACA,KAAK,OAAO,OAAO,SAAS,QAAQ;EAExC,IAAI,CAAC,WAAW,YAAY,GAAG;EAE/B,UAAU,KACR,SAAS,OACP,cAAc,YAAY,EAAE,MAC5B,YAAY,cAAc,GAAG,CAC/B,CACF;CACF;CAEA,OAAO;AACT;;AAGA,MAAM,eAAe,cAAsB,QAAuB;CAChE,IAAI;EAEF,MAAM,QADU,aAAa,cAAc,OACvB,EAAE,MAAM,OAAO;EACnC,MAAM,WAAW,IAAI,OACnB,qBAAqB,IAAI,QAAQ,uBAAuB,MAAM,EAAE,OAClE;EAEA,KAAK,IAAI,OAAO,GAAG,OAAO,MAAM,QAAQ,QAAQ;GAC9C,MAAM,SAAS,MAAM,MAAM,OAAO,QAAQ;GAC1C,IAAI,WAAW,IACb,OAAO,MAAM,OACX,SAAS,OAAO,MAAM,MAAM,GAC5B,SAAS,OAAO,MAAM,MAAM,MAAM,MAAM,CAC1C;EAEJ;CACF,QAAQ,CAER;CAEA,OAAO,MAAM,OAAO,SAAS,OAAO,GAAG,CAAC,GAAG,SAAS,OAAO,GAAG,CAAC,CAAC;AAClE;AAEA,WAAW,cAAc,WAA+C;CACtE,gBACE,OAAO,aACN,OAAO,mBAAmB,IAAI,MAC3B,mBAAmB,IAAI,IAAI,OAAO,iBAAiB,GAAG,GAAG,EAAE,QAAQ,IACnE;CACN,eAAe;CAEf,OAAO,EACL,cAAc;EACZ,kBAAkB,qBAAqB;EAEvC,oBAAoB;CACtB,EACF;AACF,CAAC;AAED,WAAW,cAAc,WAAW;CAClC,MAAM,WAAW,UAAU,IAAI,OAAO,aAAa,GAAG;CACtD,IAAI,CAAC,UAAU,OAAO;CAEtB,MAAM,OAAO,SAAS,QAAQ;CAC9B,MAAM,SAAS,SAAS,SAAS,OAAO,QAAQ;CAEhD,MAAM,QAAQ,iBAAiB;CAE/B,KAAK,MAAM,SAAS,KAAK,SAAS,KAAK,GAAG;EACxC,MAAM,QAAQ,MAAM;EACpB,MAAM,MAAM,QAAQ,MAAM,GAAG;EAG7B,IAAI,UAAU,SAAS,UAAU,KAAK;GACpC,MAAM,MAAM,MAAM;GAClB,MAAM,YAAY,+BAA+B,GAAG;GACpD,OAAO,UAAU,SAAS,YAAY;EACxC;CACF;CAEA,OAAO;AACT,CAAC;AAID,UAAU,OAAO,UAAU;AAG3B,WAAW,OAAO"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { type Dirent, existsSync } from 'node:fs';\nimport { readdir, readFile } from 'node:fs/promises';\nimport { extname, isAbsolute, join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { getConfiguration } from '@intlayer/config/node';\nimport type { IntlayerConfig } from '@intlayer/types/config';\nimport { getUnmergedDictionaries } from '@intlayer/unmerged-dictionaries-entry';\nimport {\n  createConnection,\n  type InitializeParams,\n  type InitializeResult,\n  Location,\n  Position,\n  ProposedFeatures,\n  Range,\n  type ReferenceParams,\n  TextDocumentSyncKind,\n  TextDocuments,\n} from 'vscode-languageserver/node.js';\nimport { TextDocument } from 'vscode-languageserver-textdocument';\nimport {\n  escapeRegularExpression,\n  findFieldRangesInFile,\n  offsetToRange,\n} from './findFieldInFile';\nimport { findKeyAtOffset } from './findKeyAtOffset';\nimport {\n  findContentFieldAtOffset,\n  findKeyInContentFile,\n} from './findKeyInContentFile';\nimport { findUsageFieldAtOffset } from './findUsageFieldAtOffset';\n\n// Create a connection for the server, using Node's IPC as a transport.\n// Also include all preview / proposed LSP features.\nconst connection = createConnection(ProposedFeatures.all);\n\n// Create a simple text document manager.\nconst documents: TextDocuments<TextDocument> = new TextDocuments(TextDocument);\n\n/**\n * Send a log line to the client's Output panel (View → Output → \"Intlayer LSP\").\n * Uses connection.console.log so it travels over the JSON-RPC channel and never\n * touches stdout (which is reserved for the LSP protocol).\n */\nconst log = (message: string): void =>\n  connection.console.log(`[Intlayer LSP] ${message}`);\n\nlet workspaceRoot: string | null | undefined;\n\ntype WorkspaceConfig = Pick<IntlayerConfig, 'system' | 'build' | 'content'>;\n\n/**\n * Resolve (and cache) the Intlayer configuration for the current workspace.\n * The LSP process cwd is not the project root, so we must resolve the config\n * from `workspaceRoot` to get the right `system`/`build`/`content` paths.\n */\nlet cachedConfig: WorkspaceConfig | null = null;\n\n/**\n * Cached unmerged dictionaries with a short TTL so that running\n * `intlayer build` during a session picks up without a full re-init.\n */\nlet cachedDictionaries: ReturnType<typeof getUnmergedDictionaries> | null =\n  null;\nlet dictionariesCachedAt = 0;\nconst DICTIONARY_CACHE_TTL_MS = 5_000;\n\n// Pattern-derived lookup structures — computed lazily from the live workspace\n// config so they respect any user customisation of traversePattern /\n// fileExtensions.\nlet cachedSourceExtensions: Set<string> | null = null;\nlet cachedExcludedDirs: Set<string> | null = null;\nlet cachedFileExclusionRegexes: RegExp[] | null = null;\n\n/**\n * Cached list of source file paths.\n * Walking the directory tree is the dominant cost on every Go-to-Definition\n * from a content file. We cache the result for 30 s and re-scan only when\n * the client reports a watched-file change or the config is invalidated.\n */\nlet cachedSourceFiles: string[] | null = null;\nlet sourceFilesCachedAt = 0;\nconst SOURCE_FILES_CACHE_TTL_MS = 30_000;\n\nconst invalidateConfigCaches = () => {\n  cachedConfig = null;\n  cachedDictionaries = null;\n  dictionariesCachedAt = 0;\n  cachedSourceExtensions = null;\n  cachedExcludedDirs = null;\n  cachedFileExclusionRegexes = null;\n  cachedSourceFiles = null;\n  sourceFilesCachedAt = 0;\n};\n\nconst getWorkspaceConfig = (): WorkspaceConfig | null => {\n  if (cachedConfig) return cachedConfig;\n  if (!workspaceRoot) {\n    log('getWorkspaceConfig — no workspace root, skipping');\n    return null;\n  }\n  try {\n    log(`getWorkspaceConfig — loading config from: ${workspaceRoot}`);\n    const { system, build, content } = getConfiguration({\n      baseDir: workspaceRoot,\n    });\n    cachedConfig = { system, build, content };\n    log(\n      `getWorkspaceConfig — OK  baseDir=${system.baseDir}  unmergedDictionariesDir=${system.unmergedDictionariesDir}`\n    );\n    return cachedConfig;\n  } catch (error) {\n    log(`getWorkspaceConfig — FAILED: ${error}`);\n    return null;\n  }\n};\n\nconst getUnmergedDictionariesCached = () => {\n  const now = Date.now();\n  if (\n    cachedDictionaries &&\n    now - dictionariesCachedAt < DICTIONARY_CACHE_TTL_MS\n  ) {\n    return cachedDictionaries;\n  }\n  const config = getWorkspaceConfig();\n  if (!config) return {};\n  cachedDictionaries = getUnmergedDictionaries(config);\n  dictionariesCachedAt = now;\n  return cachedDictionaries;\n};\n\n// ---------------------------------------------------------------------------\n// Pattern helpers — derived lazily from the live config.\n// ---------------------------------------------------------------------------\n\n// Source file extensions from positive traversePattern entries\n// e.g. '**/*.{tsx,ts,js,...}' → Set<'.tsx' | '.ts' | ...>\nconst getSourceExtensions = (): Set<string> => {\n  if (cachedSourceExtensions) return cachedSourceExtensions;\n  const traversePattern = getWorkspaceConfig()?.build.traversePattern ?? [];\n  cachedSourceExtensions = new Set(\n    traversePattern\n      .filter((pattern) => !pattern.startsWith('!'))\n      .flatMap((pattern) => {\n        const match = pattern.match(/\\.\\{([^}]+)\\}/);\n        return match?.[1]\n          ? match[1].split(',').map((extension) => `.${extension.trim()}`)\n          : [];\n      })\n  );\n  return cachedSourceExtensions;\n};\n\n// Excluded directory names from '!**/name/**' negative patterns\nconst getExcludedDirs = (): Set<string> => {\n  if (cachedExcludedDirs) return cachedExcludedDirs;\n  const traversePattern = getWorkspaceConfig()?.build.traversePattern ?? [];\n  cachedExcludedDirs = new Set(\n    traversePattern\n      .filter((pattern) => /^!\\*\\*\\/[^*/]+\\/\\*\\*$/.test(pattern))\n      .map((pattern) => pattern.replace(/^!\\*\\*\\//, '').replace(/\\/\\*\\*$/, ''))\n  );\n  return cachedExcludedDirs;\n};\n\n// File-level exclusion regexes from remaining negative patterns (e.g. '!**/*.test.*')\nconst getFileExclusionRegexes = (): RegExp[] => {\n  if (cachedFileExclusionRegexes) return cachedFileExclusionRegexes;\n  const traversePattern = getWorkspaceConfig()?.build.traversePattern ?? [];\n  cachedFileExclusionRegexes = traversePattern\n    .filter(\n      (pattern) =>\n        pattern.startsWith('!') && !/^!\\*\\*\\/[^*/]+\\/\\*\\*$/.test(pattern)\n    )\n    .map((pattern) => {\n      const inner = pattern.replace(/^!(\\*\\*\\/)*/, '');\n      return new RegExp(\n        `${inner.replace(/\\./g, '\\\\.').replace(/\\*/g, '[^\\\\/]*')}$`\n      );\n    });\n  return cachedFileExclusionRegexes;\n};\n\nconst isContentFile = (uri: string): boolean => {\n  const fileExtensions = getWorkspaceConfig()?.content.fileExtensions ?? [];\n  return fileExtensions.some((extension) => uri.endsWith(extension));\n};\n\n// ---------------------------------------------------------------------------\n// Async I/O helpers\n// ---------------------------------------------------------------------------\n\n/** Read a file as UTF-8, returning null on any error. */\nconst tryReadFile = async (filePath: string): Promise<string | null> => {\n  try {\n    return await readFile(filePath, 'utf-8');\n  } catch {\n    return null;\n  }\n};\n\n/**\n * Run `callback` over every item with at most `limit` tasks in-flight at once.\n * JS is single-threaded so `results.push` inside callback is race-free.\n */\nconst runConcurrent = async <T>(\n  items: T[],\n  callback: (item: T) => Promise<void>,\n  limit = 50\n): Promise<void> => {\n  if (items.length === 0) return;\n  let index = 0;\n  const worker = async () => {\n    while (index < items.length) {\n      await callback(items[index++]!);\n    }\n  };\n  await Promise.all(\n    Array.from({ length: Math.min(limit, items.length) }, worker)\n  );\n};\n\n/**\n * Recursively collect all source-file paths under `directory`.\n * Uses async readdir so it does not block the Node.js event loop.\n */\nconst collectSourceFiles = async (directory: string): Promise<string[]> => {\n  const results: string[] = [];\n  const sourceExtensions = getSourceExtensions();\n  const excludedDirs = getExcludedDirs();\n  const fileExclusionRegexes = getFileExclusionRegexes();\n  const contentExtensions = getWorkspaceConfig()?.content.fileExtensions ?? [];\n\n  const visit = async (dir: string): Promise<void> => {\n    let entries: Dirent[];\n\n    try {\n      entries = await readdir(dir, { withFileTypes: true });\n    } catch {\n      return;\n    }\n\n    // Process entries concurrently within a single directory level.\n    await Promise.all(\n      entries.map(async (entry) => {\n        if (entry.isDirectory()) {\n          if (!excludedDirs.has(entry.name)) {\n            await visit(join(dir, entry.name));\n          }\n        } else if (\n          sourceExtensions.has(extname(entry.name)) &&\n          !contentExtensions.some((extension) =>\n            entry.name.endsWith(extension)\n          ) &&\n          !fileExclusionRegexes.some((regularExpression) =>\n            regularExpression.test(entry.name)\n          )\n        ) {\n          results.push(join(dir, entry.name));\n        }\n      })\n    );\n  };\n\n  await visit(directory);\n  return results;\n};\n\n/** Find the `key: \"<key>\"` line inside a content file so the cursor lands on it. */\nconst getKeyRange = async (\n  absolutePath: string,\n  key: string\n): Promise<Range> => {\n  try {\n    const content = await readFile(absolutePath, 'utf-8');\n    const lines = content.split(/\\r?\\n/);\n    const keyRegularExpression = new RegExp(\n      `key\\\\s*:\\\\s*['\"\\`]${key.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')}['\"\\`]`\n    );\n\n    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {\n      const column = lines[lineIndex]?.search(keyRegularExpression);\n      if (column !== undefined && column !== -1) {\n        return Range.create(\n          Position.create(lineIndex, column),\n          Position.create(lineIndex, lines[lineIndex]!.length)\n        );\n      }\n    }\n  } catch {\n    // fall through to the top of the file\n  }\n\n  return Range.create(Position.create(0, 0), Position.create(0, 0));\n};\n\n/**\n * Return every `.content` file location that declares the given key.\n * A key can be split across several content files (merged dictionaries), so we\n * return one `Location` per source file, pointing at the `key:` declaration.\n */\nconst getContentDeclarationLocations = async (\n  key: string\n): Promise<Location[]> => {\n  const config = getWorkspaceConfig();\n  if (!config) return [];\n\n  const unmergedDictionaries = getUnmergedDictionariesCached();\n  const dictionaries = Object.values(unmergedDictionaries)\n    .flat()\n    .filter((dictionary) => dictionary?.key === key && dictionary.filePath);\n\n  const locations: Location[] = [];\n\n  await runConcurrent(dictionaries, async (dictionary) => {\n    const filePath = dictionary.filePath!;\n    const absolutePath = isAbsolute(filePath)\n      ? filePath\n      : join(config.system.baseDir, filePath);\n\n    if (!existsSync(absolutePath)) return;\n\n    locations.push(\n      Location.create(\n        pathToFileURL(absolutePath).href,\n        await getKeyRange(absolutePath, key)\n      )\n    );\n  });\n\n  return locations;\n};\n\n/**\n * Return the cached source-file list, re-scanning only when the cache has\n * expired or been explicitly invalidated (config change, watched-file event).\n */\nconst getSourceFiles = async (directory: string): Promise<string[]> => {\n  const now = Date.now();\n  if (\n    cachedSourceFiles &&\n    now - sourceFilesCachedAt < SOURCE_FILES_CACHE_TTL_MS\n  ) {\n    return cachedSourceFiles;\n  }\n  const startTime = Date.now();\n  cachedSourceFiles = await collectSourceFiles(directory);\n  sourceFilesCachedAt = Date.now();\n  log(\n    `source files scanned: ${cachedSourceFiles.length} file(s) in ${Date.now() - startTime}ms`\n  );\n  return cachedSourceFiles;\n};\n\n/**\n * Return every source-file location that calls useIntlayer / getIntlayer with\n * the given key.\n */\nconst getKeyUsageLocations = async (key: string): Promise<Location[]> => {\n  const config = getWorkspaceConfig();\n  if (!config) return [];\n\n  const usageRegularExpression = new RegExp(\n    `\\\\b(?:useIntlayer|getIntlayer)\\\\b\\\\s*(?:<[^<>()]*>)?\\\\s*\\\\(\\\\s*(['\"\\`])${escapeRegularExpression(key)}\\\\1`,\n    'g'\n  );\n\n  const filePaths = await getSourceFiles(config.system.baseDir);\n  const locations: Location[] = [];\n  const startTime = Date.now();\n\n  await runConcurrent(filePaths, async (filePath) => {\n    const text = await tryReadFile(filePath);\n    // Quick string check before running the regex — skips the vast majority of files\n    if (!text?.includes(key)) return;\n\n    for (const match of text.matchAll(usageRegularExpression)) {\n      const matchStart = match.index!;\n      const matchEnd = matchStart + match[0].length;\n      locations.push(\n        Location.create(\n          pathToFileURL(filePath).href,\n          offsetToRange(text, matchStart, matchEnd)\n        )\n      );\n    }\n  });\n\n  log(\n    `getKeyUsageLocations(\"${key}\") — ${filePaths.length} file(s) searched in ${Date.now() - startTime}ms → ${locations.length} hit(s)`\n  );\n  return locations;\n};\n\n/**\n * Return every source-file location that accesses the field at `fieldPath` on\n * the result of `useIntlayer(dictionaryKey)` / `getIntlayer(dictionaryKey)`.\n *\n * `fieldPath` is an array of property names from the content root to the\n * target field (e.g. `['searchInput', 'text']` for a nested field).\n * Single-element paths (e.g. `['greet']`) behave like the previous\n * single-`fieldName` API.\n */\nconst getFieldUsageLocations = async (\n  dictionaryKey: string,\n  fieldPath: string[]\n): Promise<Location[]> => {\n  const config = getWorkspaceConfig();\n  if (!config || fieldPath.length === 0) return [];\n\n  const leafFieldName = fieldPath[fieldPath.length - 1]!;\n  const escapedKey = escapeRegularExpression(dictionaryKey);\n  const escapedLeaf = escapeRegularExpression(leafFieldName);\n  const useCallRegularExpression = new RegExp(\n    `\\\\b(?:useIntlayer|getIntlayer)\\\\b(?:<[^<>()]*>)?\\\\s*\\\\(\\\\s*['\"\\`]${escapedKey}['\"\\`]`\n  );\n\n  const filePaths = await getSourceFiles(config.system.baseDir);\n  const locations: Location[] = [];\n  const startTime = Date.now();\n\n  await runConcurrent(filePaths, async (filePath) => {\n    const text = await tryReadFile(filePath);\n    if (!text) return;\n    // Pre-filter: dictionaryKey and every segment of the path must appear in the file\n    if (!text.includes(dictionaryKey)) return;\n    if (fieldPath.some((segment) => !text.includes(segment))) return;\n    if (!useCallRegularExpression.test(text)) return;\n\n    for (const range of findFieldRangesInFile(\n      text,\n      escapedKey,\n      leafFieldName,\n      escapedLeaf,\n      fieldPath\n    )) {\n      locations.push(Location.create(pathToFileURL(filePath).href, range));\n    }\n  });\n\n  log(\n    `getFieldUsageLocations(\"${dictionaryKey}.${fieldPath.join('.')}\") — ${filePaths.length} file(s) searched in ${Date.now() - startTime}ms → ${locations.length} hit(s)`\n  );\n  return locations;\n};\n\n/**\n * Find the line/column of `fieldName` as a property key inside a content file.\n * Looks for `fieldName:` (the field definition), not just any occurrence.\n * Falls back to the top of the file if the field cannot be located.\n */\nconst getFieldRangeInContentFile = async (\n  absolutePath: string,\n  fieldName: string\n): Promise<Range> => {\n  const content = await tryReadFile(absolutePath);\n  if (!content)\n    return Range.create(Position.create(0, 0), Position.create(0, 0));\n\n  const lines = content.split(/\\r?\\n/);\n  // Match `fieldName:` at an object property key position (not a value)\n  const fieldRegularExpression = new RegExp(\n    `(?<![.\\\\w])${escapeRegularExpression(fieldName)}(?![\\\\w])\\\\s*:`\n  );\n\n  for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {\n    const line = lines[lineIndex]!;\n    const matchPosition = line.search(fieldRegularExpression);\n    if (matchPosition === -1) continue;\n    const column = line.indexOf(fieldName, matchPosition);\n    if (column === -1) continue;\n    return Range.create(\n      Position.create(lineIndex, column),\n      Position.create(lineIndex, column + fieldName.length)\n    );\n  }\n\n  return Range.create(Position.create(0, 0), Position.create(0, 0));\n};\n\n/**\n * Return every content-file location where `fieldName` is defined as a\n * property of the dictionary with the given `dictionaryKey`.\n */\nconst getContentFieldLocations = async (\n  dictionaryKey: string,\n  fieldName: string\n): Promise<Location[]> => {\n  const config = getWorkspaceConfig();\n  if (!config) return [];\n\n  const unmergedDictionaries = getUnmergedDictionariesCached();\n  const dictionaries = Object.values(unmergedDictionaries)\n    .flat()\n    .filter(\n      (dictionary) => dictionary?.key === dictionaryKey && dictionary.filePath\n    );\n\n  const locations: Location[] = [];\n\n  await runConcurrent(dictionaries, async (dictionary) => {\n    const filePath = dictionary.filePath!;\n    const absolutePath = isAbsolute(filePath)\n      ? filePath\n      : join(config.system.baseDir, filePath);\n    if (!existsSync(absolutePath)) return;\n\n    locations.push(\n      Location.create(\n        pathToFileURL(absolutePath).href,\n        await getFieldRangeInContentFile(absolutePath, fieldName)\n      )\n    );\n  });\n\n  return locations;\n};\n\nconnection.onInitialize((parameters: InitializeParams): InitializeResult => {\n  workspaceRoot =\n    parameters.rootPath ||\n    (parameters.workspaceFolders?.[0]?.uri\n      ? decodeURIComponent(new URL(parameters.workspaceFolders[0].uri).pathname)\n      : undefined);\n  invalidateConfigCaches();\n\n  log(`initialized — workspaceRoot: ${workspaceRoot ?? '(none)'}`);\n\n  if (parameters.workspaceFolders?.length) {\n    log(\n      `workspaceFolders: ${parameters.workspaceFolders.map((folder) => folder.name).join(', ')}`\n    );\n  }\n\n  return {\n    capabilities: {\n      textDocumentSync: TextDocumentSyncKind.Incremental,\n      definitionProvider: true,\n      referencesProvider: true,\n    },\n  };\n});\n\nconnection.onDefinition(async (parameters) => {\n  const uri = parameters.textDocument.uri;\n  const position = parameters.position;\n  const document = documents.get(uri);\n\n  if (!document) {\n    log(`onDefinition — document not found in cache: ${uri}`);\n    return null;\n  }\n\n  const text = document.getText();\n  const offset = document.offsetAt(position);\n  const shortenedUri = uri\n    .replace(/^file:\\/\\//, '')\n    .split('/')\n    .slice(-2)\n    .join('/');\n\n  log(`onDefinition — ${shortenedUri} ${position.line}:${position.character}`);\n\n  if (isContentFile(uri)) {\n    log('onDefinition — detected content file');\n\n    // Cursor on `key: \"…\"` → navigate to useIntlayer(key) call sites\n    const key = findKeyInContentFile(text, offset);\n    if (key) {\n      log(`onDefinition — key declaration: \"${key}\" → searching call sites`);\n      const locations = await getKeyUsageLocations(key);\n\n      log(\n        `onDefinition — found ${locations.length} call site(s) for key \"${key}\"`\n      );\n      return locations.length ? locations : null;\n    }\n\n    // Cursor on a content field (e.g. `greet` or nested `searchInput.text`)\n    // → navigate to field usage sites in source files\n    const fieldInfo = findContentFieldAtOffset(text, offset);\n    if (fieldInfo) {\n      log(\n        `onDefinition — field: \"${fieldInfo.dictionaryKey}.${fieldInfo.fieldPath.join('.')}\" → searching usages`\n      );\n      const locations = await getFieldUsageLocations(\n        fieldInfo.dictionaryKey,\n        fieldInfo.fieldPath\n      );\n      log(\n        `onDefinition — found ${locations.length} usage(s) for field path \"${fieldInfo.fieldPath.join('.')}\"`\n      );\n      return locations.length ? locations : null;\n    }\n\n    log('onDefinition — cursor not on a key or field declaration, no result');\n    return null;\n  }\n\n  // Cursor on the key string / function name → navigate to content declaration\n  const key = findKeyAtOffset(text, offset);\n  if (key) {\n    log(\n      `onDefinition — useIntlayer key: \"${key}\" → searching content declarations`\n    );\n    const locations = await getContentDeclarationLocations(key);\n    log(\n      `onDefinition — found ${locations.length} content declaration(s) for key \"${key}\"`\n    );\n    return locations.length ? locations : null;\n  }\n\n  // Cursor on a destructured property or member access property from useIntlayer\n  // e.g. const { localeSwitcherLabel } = useIntlayer(\"locale-switcher\")\n  //                ^^^^^^^^^^^^^^^^^^  ← cursor here\n  // e.g. t.localeSwitcherLabel  where  const t = useIntlayer(\"locale-switcher\")\n  const usageField = findUsageFieldAtOffset(text, offset);\n  if (usageField) {\n    log(\n      `onDefinition — usage field: \"${usageField.dictionaryKey}.${usageField.fieldName}\" → searching content field`\n    );\n    const locations = await getContentFieldLocations(\n      usageField.dictionaryKey,\n      usageField.fieldName\n    );\n    log(\n      `onDefinition — found ${locations.length} content file(s) with field \"${usageField.fieldName}\"`\n    );\n    return locations.length ? locations : null;\n  }\n\n  log('onDefinition — no Intlayer key at cursor, no result');\n  return null;\n});\n\n/**\n * \"Find All References\" handler (Shift+F12).\n *\n * From a content file, returns every source-file location that uses the key or\n * field at the cursor — the reverse direction of Go-to-Definition.\n *\n * From a source file, returns all content-file declarations for the key or\n * field at the cursor — complementing what Go-to-Definition already handles.\n */\nconnection.onReferences(async (parameters: ReferenceParams) => {\n  const uri = parameters.textDocument.uri;\n  const position = parameters.position;\n  const document = documents.get(uri);\n\n  if (!document) return null;\n\n  const text = document.getText();\n  const offset = document.offsetAt(position);\n  const shortenedUri = uri\n    .replace(/^file:\\/\\//, '')\n    .split('/')\n    .slice(-2)\n    .join('/');\n\n  log(`onReferences — ${shortenedUri} ${position.line}:${position.character}`);\n\n  if (isContentFile(uri)) {\n    // Cursor on `key: \"…\"` → all useIntlayer(key) call sites\n    const key = findKeyInContentFile(text, offset);\n    if (key) {\n      const locations = await getKeyUsageLocations(key);\n      log(`onReferences — key \"${key}\" → ${locations.length} call site(s)`);\n      return locations.length ? locations : null;\n    }\n\n    // Cursor on a content field → all field usage sites\n    const fieldInfo = findContentFieldAtOffset(text, offset);\n    if (fieldInfo) {\n      const locations = await getFieldUsageLocations(\n        fieldInfo.dictionaryKey,\n        fieldInfo.fieldPath\n      );\n      log(\n        `onReferences — field \"${fieldInfo.fieldPath.join('.')}\" → ${locations.length} usage(s)`\n      );\n      return locations.length ? locations : null;\n    }\n\n    return null;\n  }\n\n  // Source file: key string → content-file declarations\n  const key = findKeyAtOffset(text, offset);\n  if (key) {\n    const locations = await getContentDeclarationLocations(key);\n    log(`onReferences — key \"${key}\" → ${locations.length} declaration(s)`);\n    return locations.length ? locations : null;\n  }\n\n  // Source file: field property → content-file field definitions\n  const usageField = findUsageFieldAtOffset(text, offset);\n  if (usageField) {\n    const locations = await getContentFieldLocations(\n      usageField.dictionaryKey,\n      usageField.fieldName\n    );\n    log(\n      `onReferences — field \"${usageField.fieldName}\" → ${locations.length} content definition(s)`\n    );\n    return locations.length ? locations : null;\n  }\n\n  return null;\n});\n\n// Invalidate the source-file list whenever the client reports a file change.\n// The client registers a watcher for *.content.* files; any creation or\n// deletion means the project layout may have changed.\nconnection.onDidChangeWatchedFiles(() => {\n  cachedSourceFiles = null;\n  sourceFilesCachedAt = 0;\n  cachedDictionaries = null;\n  dictionariesCachedAt = 0;\n  log(\n    'watched files changed — source file list and dictionary cache invalidated'\n  );\n});\n\n// Make the text document manager listen on the connection\n// for open, change and close text document events\ndocuments.listen(connection);\n\n// Listen on the connection\nconnection.listen();\n"],"mappings":"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"}

package/dist/esm/oxcUtils.mjs

@@ -0,0 +1,60 @@
+import { parseSync } from "oxc-parser";
+
+//#region src/oxcUtils.ts
+const INTLAYER_GETTERS = new Set(["useIntlayer", "getIntlayer"]);
+/**
+* Depth-first walk of an Oxc AST.  Visitor is called for every node that has
+* a `type` property;
+*  returning `true` prunes that subtree.
+*/
+const walkAst = (node, visitor) => {
+	if (!node || typeof node !== "object") return;
+	if (Array.isArray(node)) {
+		for (const child of node) walkAst(child, visitor);
+		return;
+	}
+	const oxcNode = node;
+	if (typeof oxcNode["type"] !== "string") return;
+	if (visitor(oxcNode)) return;
+	for (const key of Object.keys(oxcNode)) {
+		if (key === "start" || key === "end" || key === "type") continue;
+		walkAst(oxcNode[key], visitor);
+	}
+};
+/** Extract the string value from the first argument of a call expression. */
+const getFirstStringArg = (callExpressionNode) => {
+	const argumentsList = callExpressionNode["arguments"];
+	if (!argumentsList?.length) return null;
+	const firstArgument = argumentsList[0];
+	if ((firstArgument["type"] === "Literal" || firstArgument["type"] === "StringLiteral") && typeof firstArgument["value"] === "string") return firstArgument["value"];
+	if (firstArgument["type"] === "TemplateLiteral" && firstArgument["expressions"]?.length === 0) {
+		const valueNode = firstArgument["quasis"]?.[0]?.["value"];
+		return valueNode?.["cooked"] ?? valueNode?.["raw"] ?? null;
+	}
+	return null;
+};
+/** Returns true when `node` is a useIntlayer / getIntlayer CallExpression. */
+const isIntlayerCall = (node) => {
+	if (node["type"] !== "CallExpression") return false;
+	const callee = node["callee"];
+	return callee?.["type"] === "Identifier" && INTLAYER_GETTERS.has(callee["name"]);
+};
+/**
+* Parse `text` into an Oxc program AST.
+* Returns null when the parse completely fails (e.g. unsupported syntax).
+* Oxc is generally resilient to partial/in-progress edits and still
+*  returns a
+* usable AST alongside error diagnostics, so this is rare.
+*/
+const parseText = (text) => {
+	try {
+		const { program } = parseSync("file.tsx", text);
+		return program;
+	} catch {
+		return null;
+	}
+};
+
+//#endregion
+export { INTLAYER_GETTERS, getFirstStringArg, isIntlayerCall, parseText, walkAst };
+//# sourceMappingURL=oxcUtils.mjs.map

package/dist/esm/oxcUtils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"oxcUtils.mjs","names":[],"sources":["../../src/oxcUtils.ts"],"sourcesContent":["import { parseSync } from 'oxc-parser';\n\nexport const INTLAYER_GETTERS: Set<string> = new Set([\n  'useIntlayer',\n  'getIntlayer',\n]);\n\nexport type OxcNode = Record<string, unknown>;\n\n/**\n * Depth-first walk of an Oxc AST.  Visitor is called for every node that has\n * a `type` property;\n *  returning `true` prunes that subtree.\n */\nexport const walkAst = (\n  node: unknown,\n  visitor: (node: OxcNode) => boolean | void\n): void => {\n  if (!node || typeof node !== 'object') return;\n\n  if (Array.isArray(node)) {\n    for (const child of node) walkAst(child, visitor);\n\n    return;\n  }\n  const oxcNode = node as OxcNode;\n\n  if (typeof oxcNode['type'] !== 'string') return;\n\n  if (visitor(oxcNode)) return; // pruned\n\n  for (const key of Object.keys(oxcNode)) {\n    if (key === 'start' || key === 'end' || key === 'type') continue;\n    walkAst(oxcNode[key], visitor);\n  }\n};\n\n/** Extract the string value from the first argument of a call expression. */\nexport const getFirstStringArg = (\n  callExpressionNode: OxcNode\n): string | null => {\n  const argumentsList = callExpressionNode['arguments'] as\n    | OxcNode[]\n    | undefined;\n\n  if (!argumentsList?.length) return null;\n  const firstArgument = argumentsList[0]!;\n\n  if (\n    (firstArgument['type'] === 'Literal' ||\n      firstArgument['type'] === 'StringLiteral') &&\n    typeof firstArgument['value'] === 'string'\n  ) {\n    return firstArgument['value'];\n  }\n\n  if (\n    firstArgument['type'] === 'TemplateLiteral' &&\n    (firstArgument['expressions'] as unknown[])?.length === 0\n  ) {\n    const templateElements = firstArgument['quasis'] as OxcNode[] | undefined;\n    const valueNode = templateElements?.[0]?.['value'] as OxcNode | undefined;\n\n    return (\n      (valueNode?.['cooked'] as string) ??\n      (valueNode?.['raw'] as string) ??\n      null\n    );\n  }\n\n  return null;\n};\n\n/** Returns true when `node` is a useIntlayer / getIntlayer CallExpression. */\nexport const isIntlayerCall = (node: OxcNode): boolean => {\n  if (node['type'] !== 'CallExpression') return false;\n  const callee = node['callee'] as OxcNode | undefined;\n\n  return (\n    callee?.['type'] === 'Identifier' &&\n    INTLAYER_GETTERS.has(callee['name'] as string)\n  );\n};\n\n/**\n * Parse `text` into an Oxc program AST.\n * Returns null when the parse completely fails (e.g. unsupported syntax).\n * Oxc is generally resilient to partial/in-progress edits and still\n *  returns a\n * usable AST alongside error diagnostics, so this is rare.\n */\nexport const parseText = (text: string): OxcNode | null => {\n  try {\n    const { program } = parseSync('file.tsx', text);\n\n    return program as unknown as OxcNode;\n  } catch {\n    return null;\n  }\n};\n"],"mappings":";;;AAEA,MAAa,mBAAgC,IAAI,IAAI,CACnD,eACA,aACF,CAAC;;;;;;AASD,MAAa,WACX,MACA,YACS;CACT,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;CAEvC,IAAI,MAAM,QAAQ,IAAI,GAAG;EACvB,KAAK,MAAM,SAAS,MAAM,QAAQ,OAAO,OAAO;EAEhD;CACF;CACA,MAAM,UAAU;CAEhB,IAAI,OAAO,QAAQ,YAAY,UAAU;CAEzC,IAAI,QAAQ,OAAO,GAAG;CAEtB,KAAK,MAAM,OAAO,OAAO,KAAK,OAAO,GAAG;EACtC,IAAI,QAAQ,WAAW,QAAQ,SAAS,QAAQ,QAAQ;EACxD,QAAQ,QAAQ,MAAM,OAAO;CAC/B;AACF;;AAGA,MAAa,qBACX,uBACkB;CAClB,MAAM,gBAAgB,mBAAmB;CAIzC,IAAI,CAAC,eAAe,QAAQ,OAAO;CACnC,MAAM,gBAAgB,cAAc;CAEpC,KACG,cAAc,YAAY,aACzB,cAAc,YAAY,oBAC5B,OAAO,cAAc,aAAa,UAElC,OAAO,cAAc;CAGvB,IACE,cAAc,YAAY,qBACzB,cAAc,gBAA8B,WAAW,GACxD;EAEA,MAAM,YADmB,cAAc,YACF,KAAK;EAE1C,OACG,YAAY,aACZ,YAAY,UACb;CAEJ;CAEA,OAAO;AACT;;AAGA,MAAa,kBAAkB,SAA2B;CACxD,IAAI,KAAK,YAAY,kBAAkB,OAAO;CAC9C,MAAM,SAAS,KAAK;CAEpB,OACE,SAAS,YAAY,gBACrB,iBAAiB,IAAI,OAAO,OAAiB;AAEjD;;;;;;;;AASA,MAAa,aAAa,SAAiC;CACzD,IAAI;EACF,MAAM,EAAE,YAAY,UAAU,YAAY,IAAI;EAE9C,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF"}

package/dist/esm/utils.mjs

@@ -0,0 +1,6 @@
+import { escapeRegularExpression, findFieldRangesInFile, offsetToRange } from "./findFieldInFile.mjs";
+import { findKeyAtOffset } from "./findKeyAtOffset.mjs";
+import { findContentFieldAtOffset, findKeyInContentFile } from "./findKeyInContentFile.mjs";
+import { findUsageFieldAtOffset } from "./findUsageFieldAtOffset.mjs";
+
+export { escapeRegularExpression, findContentFieldAtOffset, findFieldRangesInFile, findKeyAtOffset, findKeyInContentFile, findUsageFieldAtOffset, offsetToRange };