@pyreon/lint 0.11.4 → 0.11.6

package/lib/index.js

@@ -1524,6 +1524,39 @@ const noBareSignalInJsx = {
 	}
 };
 
+//#endregion
+//#region src/rules/reactivity/no-context-destructure.ts
+/**
+* Detects destructuring the return value of useContext().
+*
+* `const { mode } = useContext(ctx)` loses reactivity when the context
+* provides getter properties. The value is captured once at setup time.
+*
+* Correct: `const ctx = useContext(Ctx)` then read `ctx.mode` lazily.
+*/
+const noContextDestructure = {
+	meta: {
+		id: "pyreon/no-context-destructure",
+		category: "reactivity",
+		description: "Disallow destructuring useContext() — it breaks reactivity when context provides getters.",
+		severity: "warn",
+		fixable: false
+	},
+	create(context) {
+		return { VariableDeclarator(node) {
+			const id = node.id;
+			const init = node.init;
+			if (!id || !init) return;
+			if (id.type !== "ObjectPattern") return;
+			if (init.type !== "CallExpression" || init.callee?.type !== "Identifier" || init.callee.name !== "useContext") return;
+			context.report({
+				message: "Destructuring useContext() captures values once — reactive getters lose reactivity. Keep the object reference: `const ctx = useContext(Ctx)` and access `ctx.mode` lazily.",
+				span: getSpan(id)
+			});
+		} };
+	}
+};
+
 //#endregion
 //#region src/rules/reactivity/no-effect-assignment.ts
 function isUpdateCall(node) {
@@ -2395,6 +2428,7 @@ const preferCx = {
 //#region src/rules/index.ts
 const allRules = [
 	noBareSignalInJsx,
+	noContextDestructure,
 	noSignalInLoop,
 	noNestedEffect,
 	noPeekInTracked,
@@ -2525,8 +2559,9 @@ var LineIndex = class {
 };
 
 //#endregion
-//#region src/runner.ts
-const JS_EXTENSIONS$2 = new Set([
+//#region src/utils/index.ts
+/** Supported JS/TS file extensions for linting. */
+const JS_EXTENSIONS = new Set([
 	".ts",
 	".tsx",
 	".js",
@@ -2534,6 +2569,14 @@ const JS_EXTENSIONS$2 = new Set([
 	".mts",
 	".mjs"
 ]);
+/** Check if a file path has a supported JS/TS extension. */
+function hasJsExtension(filePath) {
+	const ext = filePath.slice(filePath.lastIndexOf("."));
+	return JS_EXTENSIONS.has(ext);
+}
+
+//#endregion
+//#region src/runner.ts
 function getExtension(filePath) {
 	const lastDot = filePath.lastIndexOf(".");
 	return lastDot === -1 ? "" : filePath.slice(lastDot);
@@ -2591,7 +2634,7 @@ function mergeCallbacks(allCallbacks) {
 */
 function lintFile(filePath, sourceText, rules, config, cache) {
 	const ext = getExtension(filePath);
-	if (!JS_EXTENSIONS$2.has(ext)) return {
+	if (!JS_EXTENSIONS.has(ext)) return {
 		filePath,
 		diagnostics: []
 	};
@@ -2658,21 +2701,9 @@ function applyFixes(sourceText, diagnostics) {
 
 //#endregion
 //#region src/lint.ts
-const JS_EXTENSIONS$1 = new Set([
-	".ts",
-	".tsx",
-	".js",
-	".jsx",
-	".mts",
-	".mjs"
-]);
 function isHiddenOrVendor(entry) {
 	return entry.startsWith(".") || entry === "node_modules" || entry === "lib" || entry === "dist";
 }
-function hasJsExtension$1(filePath) {
-	const ext = filePath.slice(filePath.lastIndexOf("."));
-	return JS_EXTENSIONS$1.has(ext);
-}
 function matchesPatterns(filePath, include, exclude) {
 	if (exclude) {
 		for (const pattern of exclude) if (filePath.includes(pattern)) return false;
@@ -2705,7 +2736,7 @@ function processEntry(full, files, isIgnored, include, exclude) {
 		return;
 	}
 	if (stat.isDirectory()) walkDirectory(full, files, isIgnored, include, exclude);
-	else if (stat.isFile() && hasJsExtension$1(full) && matchesPatterns(full, include, exclude)) files.push(full);
+	else if (stat.isFile() && hasJsExtension(full) && matchesPatterns(full, include, exclude)) files.push(full);
 }
 function collectFiles(dir, isIgnored, include, exclude) {
 	const files = [];
@@ -2867,19 +2898,179 @@ function formatCompact(result) {
 }
 
 //#endregion
-//#region src/watcher.ts
-const JS_EXTENSIONS = new Set([
-	".ts",
-	".tsx",
-	".js",
-	".jsx",
-	".mts",
-	".mjs"
-]);
-function hasJsExtension(filePath) {
-	const ext = filePath.slice(filePath.lastIndexOf("."));
-	return JS_EXTENSIONS.has(ext);
+//#region src/lsp/index.ts
+/**
+* Minimal LSP server for @pyreon/lint.
+*
+* Provides real-time Pyreon-specific diagnostics in editors that support
+* the Language Server Protocol (VS Code, Neovim, etc.).
+*
+* Usage: pyreon-lint --lsp
+*
+* The server communicates via JSON-RPC over stdin/stdout following the
+* LSP specification (https://microsoft.github.io/language-server-protocol/).
+*
+* Supported capabilities:
+* - textDocument/didOpen — lint on open
+* - textDocument/didSave — lint on save
+* - textDocument/didChange — lint on change (debounced)
+*
+* @module
+*/
+const cache = new AstCache();
+const config = getPreset("recommended");
+function toLspDiagnostics(diagnostics) {
+	return diagnostics.map((d) => ({
+		range: {
+			start: {
+				line: d.loc.line - 1,
+				character: d.loc.column - 1
+			},
+			end: {
+				line: d.loc.line - 1,
+				character: d.loc.column - 1 + (d.span.end - d.span.start)
+			}
+		},
+		severity: d.severity === "error" ? 1 : d.severity === "warn" ? 2 : 3,
+		source: "pyreon-lint",
+		message: d.message,
+		code: d.ruleId
+	}));
+}
+function lintDocument(uri, text) {
+	try {
+		return toLspDiagnostics(lintFile(uri.replace("file://", ""), text, allRules, config, cache).diagnostics);
+	} catch {
+		return [];
+	}
+}
+const DEBOUNCE_MS = 150;
+const debounceTimers = /* @__PURE__ */ new Map();
+function debounceLint(uri, text) {
+	const existing = debounceTimers.get(uri);
+	if (existing) clearTimeout(existing);
+	debounceTimers.set(uri, setTimeout(() => {
+		debounceTimers.delete(uri);
+		sendNotification("textDocument/publishDiagnostics", {
+			uri,
+			diagnostics: lintDocument(uri, text)
+		});
+	}, DEBOUNCE_MS));
+}
+const openDocuments = /* @__PURE__ */ new Map();
+function handleMessage(msg) {
+	if (msg.method === "initialize") return {
+		jsonrpc: "2.0",
+		id: msg.id,
+		result: {
+			capabilities: {
+				textDocumentSync: 1,
+				diagnosticProvider: {
+					interFileDependencies: false,
+					workspaceDiagnostics: false
+				}
+			},
+			serverInfo: {
+				name: "pyreon-lint",
+				version: "0.11.5"
+			}
+		}
+	};
+	if (msg.method === "initialized") return null;
+	if (msg.method === "textDocument/didOpen") {
+		const { uri, text } = msg.params.textDocument;
+		openDocuments.set(uri, text);
+		sendNotification("textDocument/publishDiagnostics", {
+			uri,
+			diagnostics: lintDocument(uri, text)
+		});
+		return null;
+	}
+	if (msg.method === "textDocument/didChange") {
+		const uri = msg.params.textDocument.uri;
+		const text = msg.params.contentChanges[0]?.text;
+		if (text != null) {
+			openDocuments.set(uri, text);
+			debounceLint(uri, text);
+		}
+		return null;
+	}
+	if (msg.method === "textDocument/didSave") {
+		const uri = msg.params.textDocument.uri;
+		const text = openDocuments.get(uri);
+		if (text) sendNotification("textDocument/publishDiagnostics", {
+			uri,
+			diagnostics: lintDocument(uri, text)
+		});
+		return null;
+	}
+	if (msg.method === "textDocument/didClose") {
+		const uri = msg.params.textDocument.uri;
+		openDocuments.delete(uri);
+		sendNotification("textDocument/publishDiagnostics", {
+			uri,
+			diagnostics: []
+		});
+		return null;
+	}
+	if (msg.method === "shutdown") return {
+		jsonrpc: "2.0",
+		id: msg.id,
+		result: null
+	};
+	if (msg.method === "exit") process.exit(0);
+	if (msg.id != null) return {
+		jsonrpc: "2.0",
+		id: msg.id,
+		result: null
+	};
+	return null;
+}
+function sendMessage(msg) {
+	const body = JSON.stringify(msg);
+	const header = `Content-Length: ${Buffer.byteLength(body)}\r\n\r\n`;
+	process.stdout.write(header + body);
 }
+function sendNotification(method, params) {
+	sendMessage({
+		jsonrpc: "2.0",
+		method,
+		params
+	});
+}
+/**
+* Start the LSP server. Reads JSON-RPC messages from stdin,
+* processes them, and writes responses to stdout.
+*/
+function startLspServer() {
+	let buffer = "";
+	process.stdin.setEncoding("utf-8");
+	process.stdin.on("data", (chunk) => {
+		buffer += chunk;
+		while (true) {
+			const headerEnd = buffer.indexOf("\r\n\r\n");
+			if (headerEnd === -1) break;
+			const match = buffer.slice(0, headerEnd).match(/Content-Length:\s*(\d+)/i);
+			if (!match) {
+				buffer = buffer.slice(headerEnd + 4);
+				continue;
+			}
+			const contentLength = Number.parseInt(match[1], 10);
+			const bodyStart = headerEnd + 4;
+			if (buffer.length < bodyStart + contentLength) break;
+			const body = buffer.slice(bodyStart, bodyStart + contentLength);
+			buffer = buffer.slice(bodyStart + contentLength);
+			try {
+				const response = handleMessage(JSON.parse(body));
+				if (response) sendMessage(response);
+			} catch {}
+		}
+	});
+	process.stderr.write("[pyreon-lint] LSP server started\n");
+}
+
+//#endregion
+//#region src/watcher.ts
 function formatOutput(result, format) {
 	if (format === "json") return formatJSON(result);
 	if (format === "compact") return formatCompact(result);
@@ -2951,5 +3142,5 @@ function relintFile(filePath, config, cache, format) {
 }
 
 //#endregion
-export { AstCache, LineIndex, allRules, applyFixes, createIgnoreFilter, extractImportInfo, formatCompact, formatJSON, formatText, getLocalName, getPreset, importsName, isPyreonImport, isPyreonPackage, lint, lintFile, listRules, loadConfig, loadConfigFromPath, watchAndLint };
+export { AstCache, LineIndex, allRules, applyFixes, createIgnoreFilter, extractImportInfo, formatCompact, formatJSON, formatText, getLocalName, getPreset, importsName, isPyreonImport, isPyreonPackage, lint, lintFile, listRules, loadConfig, loadConfigFromPath, startLspServer, watchAndLint };
 //# sourceMappingURL=index.js.map