@dialexjs/language-server 0.7.2 → 0.9.2

package/dist/features.mjs

@@ -1,361 +1,2 @@
-import fs from "node:fs";
-import { TODO_PREFIX, copyLeaf, dictionaryLocation, getLeafSource, hasPath, listLocales, locationOf, parseDictionaryText, renderDictionaryFile, scanFiles, scanReferences, setString } from "@dialexjs/cli/api";
-import path from "node:path";
-//#region src/features/model.ts
-function buildModel(root, defaultLocale, result) {
-	return {
-		root,
-		defaultLocale,
-		dictionaries: new Map(result.dictionaries.map((d) => [d.name, d]))
-	};
-}
-/** The model whose root contains `file`, preferring the deepest (nested projects). */
-function modelForFile(models, file) {
-	let best;
-	for (const model of models) {
-		const rel = path.relative(model.root, file);
-		if (rel.startsWith("..") || path.isAbsolute(rel)) continue;
-		if (!best || model.root.length > best.root.length) best = model;
-	}
-	return best;
-}
-/** Locales with the default locale first. */
-function orderedLocales(model, dictionary) {
-	return [...dictionary.locales.filter((l) => l === model.defaultLocale), ...dictionary.locales.filter((l) => l !== model.defaultLocale)];
-}
-//#endregion
-//#region src/features/bindings.ts
-/**
-* `const s = useDictionary("showcase")`, `const home = await getDictionary("home", locale)`,
-* `let t: Home = injectDictionary<Home>("home")`: a variable that holds a dictionary.
-*/
-const DECLARATION = /\b(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*(?::[^=\n]+)?=\s*(?:await\s+)?(?:[A-Za-z_$][\w$]*\.)*(?:getDictionary|useDictionary|injectDictionary)\s*(?:<[^()]*?>)?\(\s*(["'`])([^"'`$\n]+)\2/g;
-/**
-* Finds the variables in a file that hold a dictionary, so `s.nav.features` can be resolved to
-* `showcase.nav.features`. It is a text match: a variable that is reassigned or shadowed in another
-* scope may resolve to the wrong dictionary, which only affects editor hints.
-*/
-function findBindings(text) {
-	const bindings = /* @__PURE__ */ new Map();
-	for (const match of text.matchAll(DECLARATION)) bindings.set(match[1], match[3]);
-	return bindings;
-}
-//#endregion
-//#region src/features/references.ts
-/** `getDictionary("home").nav.about` -> the `.nav.about` member chain after the call. */
-const MEMBER_CHAIN = /(?:getDictionary|useDictionary)\(\s*(["'`])([^"'`$\n]+)\1[^()\n]*\)((?:\??\.[A-Za-z_$][\w$]*)+)/dg;
-const escapeRegExp = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-/**
-* The Dialex reference under the cursor on one line of code: a dictionary name, a `t("a.b.c")`
-* path, a member of `getDictionary("a")` such as `.title`, or, with `bindings`, a member of a
-* variable that holds a dictionary (`s.nav.features` after `const s = useDictionary("showcase")`).
-* Offsets are into `lineText`.
-*/
-function findReferenceAt(lineText, character, bindings) {
-	const direct = scanReferences(lineText).find((r) => character >= r.start && character <= r.end);
-	if (direct) return direct;
-	for (const match of lineText.matchAll(MEMBER_CHAIN)) {
-		const dictionary = match[2];
-		const [chainStart] = match.indices[3];
-		const members = /\??\.([A-Za-z_$][\w$]*)/g;
-		const keys = [];
-		for (const member of match[3].matchAll(members)) {
-			const start = chainStart + member.index + member[0].length - member[1].length;
-			const end = start + member[1].length;
-			keys.push(member[1]);
-			if (character >= start && character <= end) return {
-				kind: "path",
-				value: [dictionary, ...keys].join("."),
-				start,
-				end
-			};
-		}
-	}
-	for (const [name, dictionary] of bindings ?? []) {
-		const chain = new RegExp(`(?<![\\w$.])${escapeRegExp(name)}(?![\\w$])((?:\\??\\.[A-Za-z_$][\\w$]*)*)`, "dg");
-		for (const match of lineText.matchAll(chain)) {
-			const nameStart = match.index;
-			const nameEnd = nameStart + name.length;
-			if (character >= nameStart && character <= nameEnd) return {
-				kind: "dictionary",
-				value: dictionary,
-				start: nameStart,
-				end: nameEnd
-			};
-			const [chainStart] = match.indices[1];
-			const keys = [];
-			for (const member of match[1].matchAll(/\??\.([A-Za-z_$][\w$]*)/g)) {
-				const start = chainStart + member.index + member[0].length - member[1].length;
-				const end = start + member[1].length;
-				keys.push(member[1]);
-				if (character >= start && character <= end) return {
-					kind: "path",
-					value: [dictionary, ...keys].join("."),
-					start,
-					end
-				};
-			}
-		}
-	}
-}
-function resolveReference(model, ref) {
-	if (ref.kind === "dictionary") {
-		const dictionary = model.dictionaries.get(ref.value);
-		return dictionary ? {
-			dictionary,
-			keyPath: []
-		} : void 0;
-	}
-	const [name, ...keyPath] = ref.value.split(".");
-	const dictionary = model.dictionaries.get(name);
-	return dictionary ? {
-		dictionary,
-		keyPath
-	} : void 0;
-}
-/** Whether `keyPath` is a leaf, a group of leaves, or nothing in this dictionary. */
-function classifyPath(dictionary, keyPath) {
-	const joined = keyPath.join(".");
-	if (dictionary.paths.includes(joined)) return "leaf";
-	return dictionary.paths.some((p) => p.startsWith(`${joined}.`)) ? "group" : "missing";
-}
-//#endregion
-//#region src/features/hover.ts
-/** Escapes Markdown so translation text cannot change the hover's formatting. */
-function escapeMarkdown(text) {
-	return text.replace(/[\\`*_{}[\]()#+!|<>~]/g, "\\$&").replace(/\r?\n/g, "<br>").slice(0, 400);
-}
-function cell(dictionary, locale, keyPath) {
-	const leaf = dictionary.leaves.get(locale)?.get(keyPath.join("."));
-	if (!leaf) return "_missing_";
-	if (leaf.kind === "string") return escapeMarkdown(leaf.value ?? "");
-	if (leaf.kind === "function") {
-		const source = dictionary.df ? getLeafSource(dictionary.df, locale, keyPath) : void 0;
-		return source ? `\`${source.replace(/`/g, "'").replace(/\s+/g, " ").slice(0, 160)}\`` : "_function_";
-	}
-	return "_value_";
-}
-/**
-* Markdown for a hover over a Dialex reference: every locale's text for a key, or a summary of a
-* dictionary. Returns `undefined` for unknown references (diagnostics already flag those).
-*/
-function buildHover(model, ref) {
-	const resolved = resolveReference(model, ref);
-	if (!resolved) return void 0;
-	const { dictionary, keyPath } = resolved;
-	const file = path.basename(dictionary.file);
-	if (keyPath.length === 0) return [
-		`**${dictionary.name}** · ${file}`,
-		"",
-		`${dictionary.paths.length} key${dictionary.paths.length === 1 ? "" : "s"} · locales: ${dictionary.locales.join(", ")}`
-	].join("\n");
-	const kind = classifyPath(dictionary, keyPath);
-	const title = `**${dictionary.name}.${keyPath.join(".")}** · ${file}`;
-	if (kind === "missing") return void 0;
-	if (kind === "group") {
-		const prefix = `${keyPath.join(".")}.`;
-		const children = new Set(dictionary.paths.filter((p) => p.startsWith(prefix)).map((p) => p.slice(prefix.length).split(".")[0]));
-		return `${title}\n\n${children.size} key${children.size === 1 ? "" : "s"}: ${[...children].map((c) => `\`${c}\``).join(", ")}`;
-	}
-	return [
-		title,
-		"",
-		"| Locale | Text |",
-		"| --- | --- |",
-		...orderedLocales(model, dictionary).map((locale) => `| ${locale} | ${cell(dictionary, locale, keyPath)} |`)
-	].join("\n");
-}
-//#endregion
-//#region src/features/definition.ts
-const START = {
-	start: {
-		line: 0,
-		column: 0
-	},
-	end: {
-		line: 0,
-		column: 0
-	}
-};
-/**
-* Where a reference is defined: the key in the default locale if it has one, otherwise in the
-* first locale that does. A dictionary reference points at the dictionary object.
-*/
-function definitionFor(model, ref) {
-	const resolved = resolveReference(model, ref);
-	if (!resolved) return void 0;
-	const { dictionary, keyPath } = resolved;
-	const { df } = dictionary;
-	if (!df) return {
-		file: dictionary.file,
-		range: START
-	};
-	if (keyPath.length === 0) return {
-		file: dictionary.file,
-		range: dictionaryLocation(df) ?? START
-	};
-	for (const locale of orderedLocales(model, dictionary)) {
-		const range = locationOf(df, locale, keyPath);
-		if (range) return {
-			file: dictionary.file,
-			range
-		};
-	}
-}
-//#endregion
-//#region src/features/completion.ts
-const CALL = /(?<![\w$.])(t|getDictionary|useDictionary|DialexDictionary)\(\s*(["'`])([^"'`\n]*)$/;
-/**
-* Whether the cursor is inside the string argument of a Dialex call, and what is being typed.
-* `textBeforeCursor` is the line up to the cursor. `length` is how many characters before the
-* cursor a completion replaces.
-*/
-function completionContextAt(textBeforeCursor, bindings) {
-	const match = CALL.exec(textBeforeCursor);
-	if (!match) return bindings ? memberContextAt(textBeforeCursor, bindings) : void 0;
-	const [, call, , value] = match;
-	if (call === "t" && value.includes(".")) {
-		const segments = value.split(".");
-		const typed = segments.pop();
-		const [dictionary, ...parent] = segments;
-		return {
-			kind: "path",
-			dictionary,
-			parent,
-			typed,
-			length: typed.length
-		};
-	}
-	return {
-		kind: "dictionary",
-		call,
-		typed: value,
-		length: value.length
-	};
-}
-/** `s.nav.fe|` where `s` holds a dictionary: the keys under `nav` that start with `fe`. */
-function memberContextAt(textBeforeCursor, bindings) {
-	for (const [name, dictionary] of bindings) {
-		const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-		const match = new RegExp(`(?<![\\w$.])${escaped}((?:\\??\\.[A-Za-z_$][\\w$]*)*)\\??\\.([A-Za-z_$][\\w$]*)?$`).exec(textBeforeCursor);
-		if (!match) continue;
-		const parent = [...match[1].matchAll(/\??\.([A-Za-z_$][\w$]*)/g)].map((m) => m[1]);
-		const typed = match[2] ?? "";
-		return {
-			kind: "path",
-			dictionary,
-			parent,
-			typed,
-			length: typed.length
-		};
-	}
-}
-const preview = (text) => text === void 0 ? void 0 : text.length > 60 ? `${text.slice(0, 57)}...` : text;
-function dictionaryEntries(model, context) {
-	return [...model.dictionaries.values()].filter((d) => d.name.startsWith(context.typed)).map((d) => {
-		const continues = context.call === "t";
-		return {
-			label: d.name,
-			kind: "dictionary",
-			detail: `${d.paths.length} keys · ${d.locales.join(", ")}`,
-			insertText: continues ? `${d.name}.` : d.name,
-			retrigger: continues
-		};
-	});
-}
-function pathEntries(model, dictionary, context) {
-	const prefix = context.parent.length > 0 ? `${context.parent.join(".")}.` : "";
-	const children = /* @__PURE__ */ new Map();
-	for (const keyPath of dictionary.paths) {
-		if (!keyPath.startsWith(prefix)) continue;
-		const rest = keyPath.slice(prefix.length).split(".");
-		const name = rest[0];
-		if (!name.startsWith(context.typed)) continue;
-		const entry = children.get(name) ?? { leaf: true };
-		if (rest.length > 1) entry.leaf = false;
-		children.set(name, entry);
-	}
-	return [...children].map(([name, { leaf }]) => {
-		const full = `${prefix}${name}`;
-		const holder = [model.defaultLocale, ...dictionary.locales].find((l) => dictionary.leaves.get(l)?.has(full));
-		const text = holder ? dictionary.leaves.get(holder).get(full) : void 0;
-		return {
-			label: name,
-			kind: leaf ? "leaf" : "group",
-			detail: leaf ? preview(text?.kind === "string" ? text.value : text ? `(${text.kind})` : void 0) ?? "" : "keys…",
-			insertText: leaf ? name : `${name}.`,
-			retrigger: !leaf
-		};
-	});
-}
-/** Suggestions for the string being typed, filtered by what is already there. */
-function completionEntries(model, context) {
-	if (context.kind === "dictionary") return dictionaryEntries(model, context);
-	const dictionary = model.dictionaries.get(context.dictionary);
-	return dictionary ? pathEntries(model, dictionary, context) : [];
-}
-//#endregion
-//#region src/features/quickfix.ts
-/**
-* New text for a dictionary file with `missing` keys added to their locales, copied from the
-* source locale (strings get the `[TODO] ` marker, like `dialex check --fix`). Returns
-* `undefined` if nothing could be added.
-*/
-function addMissingKeys(file, text, missing) {
-	const df = parseDictionaryText(file, text);
-	if (!df) return void 0;
-	let changed = false;
-	for (const { locale, path, sourceLocale } of missing) {
-		if (!sourceLocale) continue;
-		if (copyLeaf(df, sourceLocale, locale, path, (value) => `${TODO_PREFIX}${value}`)) changed = true;
-	}
-	return changed ? renderDictionaryFile(df) : void 0;
-}
-/**
-* New text for a dictionary file with a key that code refers to but the dictionary lacks, added
-* to every locale as a `[TODO]` placeholder named after the key.
-*/
-function addUnknownKey(file, text, keyPath) {
-	const df = parseDictionaryText(file, text);
-	if (!df) return void 0;
-	const placeholder = `${TODO_PREFIX}${keyPath[keyPath.length - 1]}`;
-	let changed = false;
-	for (const locale of listLocales(df)) if (!hasPath(df, locale, keyPath) && setString(df, locale, keyPath, placeholder) !== "skipped") changed = true;
-	return changed ? renderDictionaryFile(df) : void 0;
-}
-//#endregion
-//#region src/features/projects.ts
-const IGNORE = ["**/.git/**", "**/.nuxt/**"];
-/** The nearest folder at or above `dir` (but inside `folder`) that has a package.json. */
-function packageRoot(folder, dir) {
-	for (let current = dir; current.startsWith(folder); current = path.dirname(current)) {
-		if (fs.existsSync(path.join(current, "package.json"))) return current;
-		if (current === folder) break;
-	}
-	return folder;
-}
-/**
-* Finds the Dialex projects inside a workspace folder.
-*
-* - Every directory with a `dialex.config.*` or `i18n.config.*` is a project.
-* - A `*.content.ts` file that no such project contains belongs to the nearest folder with a
-*   `package.json` (or the workspace folder), which then uses the default settings. This covers
-*   monorepos where only some packages have a config file.
-* - A project excludes the projects nested inside it, so one dictionary is never reported twice.
-*/
-function discoverProjects(folder) {
-	const configs = scanFiles(folder, ["**/dialex.config.*", "**/i18n.config.*"], { ignore: IGNORE });
-	const configured = [...new Set(configs.map((f) => path.dirname(f)))];
-	const roots = new Set(configured);
-	const dictionaries = scanFiles(folder, "**/*.content.ts", { ignore: IGNORE });
-	for (const file of dictionaries) if (!configured.some((root) => file.startsWith(root + path.sep))) roots.add(packageRoot(folder, path.dirname(file)));
-	const all = [...roots].sort((a, b) => a.length - b.length);
-	return all.map((root) => ({
-		root,
-		ignore: all.filter((other) => other !== root && other.startsWith(root + path.sep)).map((other) => `${path.relative(root, other).split(path.sep).join("/")}/**`)
-	}));
-}
-//#endregion
+import { a as completionEntries, c as escapeMarkdown, d as resolveReference, f as findBindings, h as orderedLocales, i as completionContextAt, l as classifyPath, m as modelForFile, n as addMissingKeys, o as definitionFor, p as buildModel, r as addUnknownKey, s as buildHover, t as discoverProjects, u as findReferenceAt } from "./features-Bpcwl0Es.mjs";
 export { addMissingKeys, addUnknownKey, buildHover, buildModel, classifyPath, completionContextAt, completionEntries, definitionFor, discoverProjects, escapeMarkdown, findBindings, findReferenceAt, modelForFile, orderedLocales, resolveReference };
-
-//# sourceMappingURL=features.mjs.map

package/dist/index.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { createServer } from "./server.mjs";
-import { ProposedFeatures, createConnection } from "vscode-languageserver/node.js";
 //#region src/index.ts
 console.log = (...args) => console.error(...args);
+const { createConnection, ProposedFeatures } = await import("vscode-languageserver/node.js");
+const { createServer } = await import("./server.mjs");
 const connection = createConnection(ProposedFeatures.all);
 createServer(connection);
 connection.listen();

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { createConnection, ProposedFeatures } from \"vscode-languageserver/node.js\";\n\nimport { createServer } from \"./server.js\";\n\n// stdout carries the protocol; anything that logs there would corrupt it.\nconsole.log = (...args: unknown[]) => console.error(...args);\n\n// `--stdio` (what editors pass), `--node-ipc` and `--socket=<port>` are handled by the library.\nconst connection = createConnection(ProposedFeatures.all);\ncreateServer(connection);\nconnection.listen();\n"],"mappings":";;;;AAMA,QAAQ,OAAO,GAAG,SAAoB,QAAQ,MAAM,GAAG,IAAI;AAG3D,MAAM,aAAa,iBAAiB,iBAAiB,GAAG;AACxD,aAAa,UAAU;AACvB,WAAW,OAAO"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\n// stdout carries the protocol; anything that logs there would corrupt it. This runs before the\n// server modules are loaded, hence the dynamic imports.\nconsole.log = (...args: unknown[]) => console.error(...args);\n\nconst { createConnection, ProposedFeatures } = await import(\"vscode-languageserver/node.js\");\nconst { createServer } = await import(\"./server.js\");\n\n// `--stdio` (what editors pass), `--node-ipc` and `--socket=<port>` are handled by the library.\nconst connection = createConnection(ProposedFeatures.all);\ncreateServer(connection);\nconnection.listen();\n\n// Makes this file a module, which top-level await needs.\nexport {};\n"],"mappings":";;AAIA,QAAQ,OAAO,GAAG,SAAoB,QAAQ,MAAM,GAAG,IAAI;AAE3D,MAAM,EAAE,kBAAkB,qBAAqB,MAAM,OAAO;AAC5D,MAAM,EAAE,iBAAiB,MAAM,OAAO;AAGtC,MAAM,aAAa,iBAAiB,iBAAiB,GAAG;AACxD,aAAa,UAAU;AACvB,WAAW,OAAO"}

package/dist/server.d.mts

@@ -1,9 +1,14 @@
 import { Connection } from "vscode-languageserver/node.js";
-//#region src/server.d.ts
+//#region src/server/settings.d.ts
 /** What the client can configure under the `dialex` section. */
-export interface Settings {
+interface Settings {
   /** Turn diagnostics, hover and the other features off. */
   enable: boolean;
+  /**
+   * Publish problems. Turn off when the ESLint or oxlint plugin reports them, to avoid showing
+   * each twice; hover, completion and quick fixes keep working.
+   */
+  diagnostics: boolean;
   /** Fade out keys and dictionaries that no source file seems to use. */
   unusedKeys: boolean;
   /**
@@ -14,6 +19,8 @@ export interface Settings {
   /** Path to the Dialex config file, relative to each project root. */
   configPath?: string;
 }
+//#endregion
+//#region src/server.d.ts
 export interface DialexServer {
   /** Re-analyze every project now and publish diagnostics. */
   refresh(): Promise<void>;
@@ -28,4 +35,5 @@ export interface DialexServer {
  */
 export declare function createServer(connection: Connection): DialexServer;
 //#endregion
+export type { Settings };
 //# sourceMappingURL=server.d.mts.map

package/dist/server.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.mts","names":[],"sources":["../src/server.ts"],"mappings":";;;iBAqDiB;;EAEf;;EAEA;;;;;EAKA;;EAEA;;iBAkBe;;EAEf,WAAW;;EAEX,cAAc;;EAEd,WAAW;;;;;;wBA0EG,aAAa,YAAY,aAAa"}
+{"version":3,"file":"server.d.mts","names":[],"sources":["../src/server/settings.ts","../src/server.ts"],"mappings":";;;UACiB;;EAEf;;;;;EAKA;;EAEA;;;;;EAKA;;EAEA;;;;iBCgCe;;EAEf,WAAW;;EAEX,cAAc;;EAEd,WAAW;;;;;;wBAOG,aAAa,YAAY,aAAa"}