Revert "docs(python): add JSDoc descriptions to marker evaluator functions"

This reverts commit 0e6a2cd.

Author: ruromero

src/providers/marker_evaluator.js

@@ -3,7 +3,6 @@ import os from 'node:os'
 
 let cachedPythonVersion = undefined
 
-/** @returns {string|null} the major.minor Python version, or null if python3 is unavailable */
 function getPythonVersion() {
 	if (cachedPythonVersion !== undefined) { return cachedPythonVersion }
 	try {
@@ -16,7 +15,7 @@ function getPythonVersion() {
 	return cachedPythonVersion
 }
 
-/** @returns {Record<string, string>} PEP 508 marker variables derived from the current Node.js/OS environment */
+/** @returns {Record<string, string>} */
 export function getEnvironmentMarkers() {
 	let platform = process.platform
 	let systemMap = { win32: 'Windows', linux: 'Linux', darwin: 'Darwin' }
@@ -35,11 +34,6 @@ export function getEnvironmentMarkers() {
 	}
 }
 
-/**
- * @param {string} left
- * @param {string} right
- * @returns {number} negative if left < right, 0 if equal, positive if left > right
- */
 function compareVersions(left, right) {
 	let lParts = left.split('.').map(Number)
 	let rParts = right.split('.').map(Number)
@@ -53,13 +47,6 @@ function compareVersions(left, right) {
 	return 0
 }
 
-/**
- * @param {string} variable - PEP 508 marker variable name (e.g. sys_platform, python_version)
- * @param {string} op - comparison operator (==, !=, >=, <=, >, <, ~=, in, not in)
- * @param {string} value - the literal value to compare against
- * @param {Record<string, string>} env - current environment marker values
- * @returns {boolean}
- */
 function evaluateComparison(variable, op, value, env) {
 	let envVal = env[variable]
 	if (envVal === undefined || envVal === '') {
@@ -95,10 +82,6 @@ function evaluateComparison(variable, op, value, env) {
 	}
 }
 
-/**
- * @param {string} expr - a single marker comparison (e.g. "sys_platform == 'linux'" or "'linux' == sys_platform")
- * @returns {{variable: string, op: string, value: string}|null} parsed atom, or null if not a valid comparison
- */
 function parseAtom(expr) {
 	let m = expr.match(/^\s*([\w.]+)\s*(~=|!=|==|>=|<=|>|<|not\s+in|in)\s*["']([^"']*)["']\s*$/)
 	if (m) { return { variable: m[1], op: m[2].replace(/\s+/g, ' '), value: m[3] } }
@@ -110,22 +93,15 @@ function parseAtom(expr) {
 }
 
 /**
- * Evaluates a PEP 508 environment marker expression against the current platform.
- * @param {string} markerExpr - marker expression (e.g. "sys_platform == 'win32' and python_version >= '3.8'")
- * @returns {boolean} true if the marker matches (or is empty), false otherwise
+ * @param {string} markerExpr
+ * @returns {boolean}
  */
 export function evaluateMarker(markerExpr) {
 	if (!markerExpr || !markerExpr.trim()) { return true }
 	let env = getEnvironmentMarkers()
 	return evaluateExpr(markerExpr.trim(), env)
 }
 
-/**
- * Recursively evaluates a marker expression supporting and/or operators and parenthesized groups.
- * @param {string} expr
- * @param {Record<string, string>} env
- * @returns {boolean}
- */
 function evaluateExpr(expr, env) {
 	let orParts = splitLogical(expr, ' or ')
 	if (orParts.length > 1) {
@@ -148,12 +124,6 @@ function evaluateExpr(expr, env) {
 	return evaluateComparison(atom.variable, atom.op, atom.value, env)
 }
 
-/**
- * Splits a marker expression by a logical separator (and/or) respecting parentheses and quoted strings.
- * @param {string} expr
- * @param {string} sep - separator including spaces (e.g. " and ", " or ")
- * @returns {string[]}
- */
 function splitLogical(expr, sep) {
 	let parts = []
 	let depth = 0