@atcute/lex-cli 2.6.0 → 2.6.1

package/dist/lsp-client.js

@@ -0,0 +1,194 @@
+import { spawn } from 'node:child_process';
+import * as url from 'node:url';
+import { getUtf8Length } from '@atcute/uint8array';
+// #endregion
+// #region text edits
+const applyTextEdits = (code, edits) => {
+    if (edits.length === 0) {
+        return code;
+    }
+    // build line start offsets
+    const lineStarts = [0];
+    for (let i = 0; i < code.length; i++) {
+        if (code[i] === '\n') {
+            lineStarts.push(i + 1);
+        }
+    }
+    const positionToOffset = (pos) => {
+        return (lineStarts[pos.line] ?? code.length) + pos.character;
+    };
+    // sort edits in reverse document order so earlier positions stay valid
+    const sorted = edits.toSorted((a, b) => {
+        const lineDiff = b.range.start.line - a.range.start.line;
+        if (lineDiff !== 0) {
+            return lineDiff;
+        }
+        return b.range.start.character - a.range.start.character;
+    });
+    let result = code;
+    for (const edit of sorted) {
+        const start = positionToOffset(edit.range.start);
+        const end = positionToOffset(edit.range.end);
+        result = result.slice(0, start) + edit.newText + result.slice(end);
+    }
+    return result;
+};
+// #endregion
+const inferLanguageId = (filepath) => {
+    if (filepath.endsWith('.ts') || filepath.endsWith('.tsx')) {
+        return 'typescript';
+    }
+    if (filepath.endsWith('.json')) {
+        return 'json';
+    }
+    if (filepath.endsWith('.md') || filepath.endsWith('.markdown')) {
+        return 'markdown';
+    }
+    return 'typescript';
+};
+/**
+ * creates an LSP client that communicates with a formatter over stdio
+ * @param command shell command to spawn the LSP server
+ * @param root project root for LSP rootUri
+ * @returns an initialized LSP client ready for formatting
+ */
+export const createLspClient = async (command, root) => {
+    const child = spawn('sh', ['-c', command], {
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    // prevent EPIPE crash when child exits mid-write; actual errors
+    // are handled by the close/error handlers below
+    child.stdin.on('error', () => { });
+    // #region JSON-RPC framing
+    const pending = new Map();
+    let nextId = 1;
+    let exited = false;
+    const sendMessage = (message) => {
+        if (exited) {
+            return;
+        }
+        const json = JSON.stringify(message);
+        const byteLength = getUtf8Length(json);
+        child.stdin.write(`Content-Length: ${byteLength}\r\n\r\n${json}`);
+    };
+    const sendRequest = (method, params) => {
+        if (exited) {
+            return Promise.reject(new Error(`LSP server has already exited`));
+        }
+        const id = nextId++;
+        const deferred = Promise.withResolvers();
+        pending.set(id, deferred);
+        sendMessage({ jsonrpc: '2.0', id, method, params });
+        return deferred.promise;
+    };
+    const sendNotification = (method, params) => {
+        sendMessage({ jsonrpc: '2.0', method, params });
+    };
+    // incremental message parser
+    const HEADER_SEPARATOR = Buffer.from('\r\n\r\n');
+    let buffer = Buffer.alloc(0);
+    let contentLength = -1;
+    const processBuffer = () => {
+        while (true) {
+            if (contentLength === -1) {
+                const separatorIndex = buffer.indexOf(HEADER_SEPARATOR);
+                if (separatorIndex === -1) {
+                    break;
+                }
+                const header = buffer.toString('utf8', 0, separatorIndex);
+                const match = header.match(/Content-Length:\s*(\d+)/i);
+                buffer = buffer.subarray(separatorIndex + 4);
+                if (!match) {
+                    continue;
+                }
+                contentLength = parseInt(match[1], 10);
+            }
+            if (buffer.length < contentLength) {
+                break;
+            }
+            const body = buffer.toString('utf8', 0, contentLength);
+            buffer = buffer.subarray(contentLength);
+            contentLength = -1;
+            let message;
+            try {
+                message = JSON.parse(body);
+            }
+            catch {
+                continue;
+            }
+            // dispatch responses to pending requests, ignore everything else
+            if (message.id != null) {
+                const entry = pending.get(message.id);
+                if (entry) {
+                    pending.delete(message.id);
+                    if (message.error) {
+                        entry.reject(new Error(`LSP error ${message.error.code}: ${message.error.message}`));
+                    }
+                    else {
+                        entry.resolve(message.result);
+                    }
+                }
+            }
+        }
+    };
+    child.stdout.on('data', (chunk) => {
+        buffer = buffer.length > 0 ? Buffer.concat([buffer, chunk]) : chunk;
+        processBuffer();
+    });
+    const rejectPending = (error) => {
+        for (const [, entry] of pending) {
+            entry.reject(error);
+        }
+        pending.clear();
+    };
+    child.on('error', (err) => {
+        exited = true;
+        rejectPending(err);
+    });
+    child.on('close', (exitCode) => {
+        exited = true;
+        rejectPending(new Error(`LSP server exited unexpectedly with code ${exitCode}`));
+    });
+    // #endregion
+    // #region initialize handshake
+    const rootUri = url.pathToFileURL(root).href;
+    await sendRequest('initialize', {
+        processId: process.pid,
+        clientInfo: { name: 'lex-cli' },
+        rootUri,
+        capabilities: {},
+    });
+    sendNotification('initialized');
+    // #endregion
+    return {
+        async formatDocument(code, filepath) {
+            const uri = url.pathToFileURL(filepath).href;
+            const languageId = inferLanguageId(filepath);
+            sendNotification('textDocument/didOpen', {
+                textDocument: { uri, languageId, version: 1, text: code },
+            });
+            const edits = (await sendRequest('textDocument/formatting', {
+                textDocument: { uri },
+                options: { tabSize: 2, insertSpaces: false },
+            }));
+            sendNotification('textDocument/didClose', {
+                textDocument: { uri },
+            });
+            if (!edits || edits.length === 0) {
+                return code;
+            }
+            return applyTextEdits(code, edits);
+        },
+        async dispose() {
+            if (!exited) {
+                await sendRequest('shutdown', null);
+                sendNotification('exit');
+            }
+            if (!exited) {
+                child.kill();
+                await new Promise((resolve) => child.on('close', resolve));
+            }
+        },
+    };
+};
+//# sourceMappingURL=lsp-client.js.map

package/dist/lsp-client.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atcute/lex-cli",
-  "version": "2.6.0",
+  "version": "2.6.1",
   "description": "cli tool to generate type definitions for atcute",
   "license": "0BSD",
   "repository": {
@@ -31,13 +31,14 @@
     "prettier": "^3.8.1",
     "@atcute/identity": "^1.1.4",
     "@atcute/identity-resolver": "^1.2.2",
+    "@atcute/lexicons": "^1.2.10",
     "@atcute/lexicon-doc": "^2.1.2",
-    "@atcute/lexicon-resolver": "^0.1.6",
-    "@atcute/lexicons": "^1.2.9"
+    "@atcute/lexicon-resolver": "^0.1.6"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",
-    "tschema": "^3.2.0"
+    "tschema": "^3.2.0",
+    "@atcute/uint8array": "^1.1.1"
   },
   "scripts": {
     "build": "pnpm run generate:schema && tsgo",

package/src/commands/export.ts

@@ -73,23 +73,27 @@ export const runExport = async (args: ExportCommand): Promise<void> => {
 	const outdir = path.resolve(config.root, exportConfig.outdir);
 	const formatter = await createFormatter(config.formatter, config.root);
 
-	// load lexicons from files
-	const loaded = await loadLexicons(files, config.root);
+	try {
+		// load lexicons from files
+		const loaded = await loadLexicons(files, config.root);
 
-	if (loaded.length === 0) {
-		console.warn(pc.yellow(`warning: no lexicons found to export`));
-		return;
-	}
+		if (loaded.length === 0) {
+			console.warn(pc.yellow(`warning: no lexicons found to export`));
+			return;
+		}
 
-	// clean output directory if requested
-	if (exportConfig.clean) {
-		await fs.rm(outdir, { recursive: true, force: true });
-	}
+		// clean output directory if requested
+		if (exportConfig.clean) {
+			await fs.rm(outdir, { recursive: true, force: true });
+		}
 
-	await fs.mkdir(outdir, { recursive: true });
+		await fs.mkdir(outdir, { recursive: true });
 
-	// write each lexicon as JSON
-	await Promise.all(loaded.map(({ nsid, doc }) => writeLexicon(outdir, nsid, doc, formatter)));
+		// write each lexicon as JSON
+		await Promise.all(loaded.map(({ nsid, doc }) => writeLexicon(outdir, nsid, doc, formatter)));
 
-	console.log(pc.green(`exported ${loaded.length} lexicon(s) to ${outdir}`));
+		console.log(pc.green(`exported ${loaded.length} lexicon(s) to ${outdir}`));
+	} finally {
+		await formatter.dispose();
+	}
 };

package/src/commands/generate.ts

@@ -150,25 +150,30 @@ export const runGenerate = async (args: GenerateCommand): Promise<void> => {
 
 	const outdir = path.join(config.root, config.outdir);
 	const formatter = await createFormatter(config.formatter, config.root);
-	const pending: Promise<void>[] = [];
-
-	for (const file of generateLexiconApi({
-		documents: documents,
-		mappings: allMappings,
-		modules: {
-			importSuffix: config.modules?.importSuffix ?? '.js',
-		},
-	})) {
-		const filename = path.join(outdir, file.filename);
-
-		pending.push(
-			(async () => {
-				const formatted = await formatter.format(file.code, filename);
-				await fs.mkdir(path.dirname(filename), { recursive: true });
-				await fs.writeFile(filename, formatted);
-			})(),
-		);
-	}
 
-	await Promise.all(pending);
+	try {
+		const pending: Promise<void>[] = [];
+
+		for (const file of generateLexiconApi({
+			documents: documents,
+			mappings: allMappings,
+			modules: {
+				importSuffix: config.modules?.importSuffix ?? '.js',
+			},
+		})) {
+			const filename = path.join(outdir, file.filename);
+
+			pending.push(
+				(async () => {
+					const formatted = await formatter.format(file.code, filename);
+					await fs.mkdir(path.dirname(filename), { recursive: true });
+					await fs.writeFile(filename, formatted);
+				})(),
+			);
+		}
+
+		await Promise.all(pending);
+	} finally {
+		await formatter.dispose();
+	}
 };

package/src/commands/pull.ts

@@ -187,40 +187,44 @@ export const runPull = async (args: PullCommand): Promise<void> => {
 	const outdir = path.resolve(config.root, pullConfig.outdir);
 	const formatter = await createFormatter(config.formatter, config.root);
 
-	const seen = new Map<string, SourceLocation>();
-	const collected: PulledLexicon[] = [];
-	const sourceRevisions: SourceRevision[] = [];
+	try {
+		const seen = new Map<string, SourceLocation>();
+		const collected: PulledLexicon[] = [];
+		const sourceRevisions: SourceRevision[] = [];
 
-	for (const source of pullConfig.sources) {
-		const result = await pullSource(source);
+		for (const source of pullConfig.sources) {
+			const result = await pullSource(source);
 
-		sourceRevisions.push({ source, rev: result.rev });
+			sourceRevisions.push({ source, rev: result.rev });
 
-		for (const [nsid, entry] of result.pulled) {
-			const existing = seen.get(nsid);
+			for (const [nsid, entry] of result.pulled) {
+				const existing = seen.get(nsid);
 
-			if (existing) {
-				console.error(pc.bold(pc.red(`duplicate lexicon "${nsid}"`)));
-				console.error(`- found ${entry.location.relativePath} from ${entry.location.sourceDescription}`);
-				console.error(`  at ${entry.location.absolutePath}`);
-				console.error(`- already found ${existing.relativePath} from ${existing.sourceDescription}`);
-				console.error(`  at ${existing.absolutePath}`);
-				process.exit(1);
-			}
+				if (existing) {
+					console.error(pc.bold(pc.red(`duplicate lexicon "${nsid}"`)));
+					console.error(`- found ${entry.location.relativePath} from ${entry.location.sourceDescription}`);
+					console.error(`  at ${entry.location.absolutePath}`);
+					console.error(`- already found ${existing.relativePath} from ${existing.sourceDescription}`);
+					console.error(`  at ${existing.absolutePath}`);
+					process.exit(1);
+				}
 
-			seen.set(nsid, entry.location);
-			collected.push(entry);
+				seen.set(nsid, entry.location);
+				collected.push(entry);
+			}
 		}
-	}
 
-	if (pullConfig.clean) {
-		await fs.rm(outdir, { recursive: true, force: true });
-	}
+		if (pullConfig.clean) {
+			await fs.rm(outdir, { recursive: true, force: true });
+		}
 
-	await fs.mkdir(outdir, { recursive: true });
+		await fs.mkdir(outdir, { recursive: true });
 
-	await Promise.all([
-		...collected.map((entry) => writeLexicon(outdir, entry.nsid, entry.doc, formatter)),
-		writeSourceReadme(outdir, sourceRevisions, formatter),
-	]);
+		await Promise.all([
+			...collected.map((entry) => writeLexicon(outdir, entry.nsid, entry.doc, formatter)),
+			writeSourceReadme(outdir, sourceRevisions, formatter),
+		]);
+	} finally {
+		await formatter.dispose();
+	}
 };

package/src/config.ts

@@ -1,5 +1,4 @@
 import * as fs from 'node:fs/promises';
-import { availableParallelism } from 'node:os';
 import * as path from 'node:path';
 import * as url from 'node:url';
 
@@ -72,7 +71,11 @@ const formatterConfigSchema = v.union(
 		concurrency: v
 			.number()
 			.assert((value) => Number.isInteger(value) && value > 0, `must be a positive integer`)
-			.optional(() => availableParallelism()),
+			.optional(() => 1),
+	}),
+	v.object({
+		type: v.literal('lsp'),
+		command: v.string().assert((value) => value.length > 0, `must not be empty`),
 	}),
 );
 

package/src/formatter.ts

@@ -1,7 +1,7 @@
 import { spawn } from 'node:child_process';
-import { availableParallelism } from 'node:os';
 
 import type { FormatterConfig } from './config.ts';
+import { createLspClient } from './lsp-client.ts';
 
 /** formats source code */
 export interface Formatter {
@@ -12,6 +12,8 @@ export interface Formatter {
 	 * @returns formatted code
 	 */
 	format(code: string, filepath: string): Promise<string>;
+	/** releases any resources held by the formatter */
+	dispose(): Promise<void>;
 }
 
 const inferPrettierParser = (filepath: string): string => {
@@ -74,72 +76,82 @@ class Semaphore {
  * @returns a formatter instance
  */
 export const createFormatter = async (config: FormatterConfig, root: string): Promise<Formatter> => {
-	let inner: Formatter;
-	let concurrency: number;
-
-	if (config.type === 'prettier') {
-		const prettier = await import('prettier');
-		const prettierConfig = await prettier.resolveConfig(root, { editorconfig: true });
-
-		// prettier is in-process and CPU-bound, so concurrency only helps
-		// avoid buffering all files in memory at once
-		concurrency = availableParallelism();
-		inner = {
-			async format(code, filepath) {
-				return prettier.format(code, { ...prettierConfig, parser: inferPrettierParser(filepath) });
-			},
-		};
-	} else {
-		// the template uses {filepath} as a placeholder, which is passed as a
-		// positional argument to sh to avoid shell injection via filenames
-		const shellCmd = config.command.replaceAll('{filepath}', '"$1"');
-
-		concurrency = config.concurrency;
-		inner = {
-			format(code, filepath) {
-				return new Promise<string>((resolve, reject) => {
-					const child = spawn('sh', ['-c', shellCmd, 'sh', filepath], {
-						stdio: ['pipe', 'pipe', 'pipe'],
-					});
-
-					const stdoutChunks: Buffer[] = [];
-					const stderrChunks: Buffer[] = [];
-
-					child.stdout.on('data', (chunk: Buffer) => {
-						stdoutChunks.push(chunk);
-					});
-
-					child.stderr.on('data', (chunk: Buffer) => {
-						stderrChunks.push(chunk);
-					});
-
-					child.on('error', reject);
-
-					child.on('close', (exitCode: number | null) => {
-						if (exitCode !== 0) {
-							const stderr = Buffer.concat(stderrChunks).toString();
-							reject(new Error(`formatter exited with code ${exitCode}:\n${stderr}`));
-						} else {
-							resolve(Buffer.concat(stdoutChunks).toString());
-						}
-					});
-
-					child.stdin.end(code);
-				});
-			},
-		};
+	switch (config.type) {
+		case 'prettier': {
+			const prettier = await import('prettier');
+			const prettierConfig = await prettier.resolveConfig(root, { editorconfig: true });
+
+			return {
+				async format(code, filepath) {
+					return prettier.format(code, { ...prettierConfig, parser: inferPrettierParser(filepath) });
+				},
+				async dispose() {},
+			};
+		}
+		case 'command': {
+			// the template uses {filepath} as a placeholder, which is passed as a
+			// positional argument to sh to avoid shell injection via filenames
+			const shellCmd = config.command.replaceAll('{filepath}', '"$1"');
+			const semaphore = new Semaphore(config.concurrency);
+
+			return {
+				async format(code, filepath) {
+					const lock = await semaphore.acquire();
+
+					try {
+						return await new Promise<string>((resolve, reject) => {
+							const child = spawn('sh', ['-c', shellCmd, 'sh', filepath], {
+								stdio: ['pipe', 'pipe', 'pipe'],
+							});
+
+							const stdoutChunks: Buffer[] = [];
+							const stderrChunks: Buffer[] = [];
+
+							child.stdout.on('data', (chunk: Buffer) => {
+								stdoutChunks.push(chunk);
+							});
+
+							child.stderr.on('data', (chunk: Buffer) => {
+								stderrChunks.push(chunk);
+							});
+
+							child.on('error', reject);
+
+							child.on('close', (exitCode: number | null) => {
+								if (exitCode !== 0) {
+									const stderr = Buffer.concat(stderrChunks).toString();
+									reject(new Error(`formatter exited with code ${exitCode}:\n${stderr}`));
+								} else {
+									resolve(Buffer.concat(stdoutChunks).toString());
+								}
+							});
+
+							child.stdin.end(code);
+						});
+					} finally {
+						lock.release();
+					}
+				},
+				async dispose() {},
+			};
+		}
+		case 'lsp': {
+			const client = await createLspClient(config.command, root);
+			const semaphore = new Semaphore(1);
+
+			return {
+				async format(code, filepath) {
+					const lock = await semaphore.acquire();
+					try {
+						return await client.formatDocument(code, filepath);
+					} finally {
+						lock.release();
+					}
+				},
+				async dispose() {
+					await client.dispose();
+				},
+			};
+		}
 	}
-
-	const semaphore = new Semaphore(concurrency);
-
-	return {
-		async format(code, filepath) {
-			const lock = await semaphore.acquire();
-			try {
-				return await inner.format(code, filepath);
-			} finally {
-				lock.release();
-			}
-		},
-	};
 };