?HAMA

Edit File Size: 3.78 KB

/home/byroehnu/easepaybiz.easetack.com/node_modules/eslint/lib/languages/js/source-code/token-store/utils.js

Text Base64

/**
 * @fileoverview Define utility functions for token store.
 * @author Toru Nagashima
 */
"use strict";

//------------------------------------------------------------------------------
// Helpers
//------------------------------------------------------------------------------

/**
 * Finds the index of the first token which is after the given location.
 * If it was not found, this returns `tokens.length`.
 * @param {(Token|Comment)[]} tokens It searches the token in this list.
 * @param {number} location The location to search.
 * @returns {number} The found index or `tokens.length`.
 */
function search(tokens, location) {
	for (
		let minIndex = 0, maxIndex = tokens.length - 1;
		minIndex <= maxIndex;

) {
		/*
		 * Calculate the index in the middle between minIndex and maxIndex.
		 * `| 0` is used to round a fractional value down to the nearest integer: this is similar to
		 * using `Math.trunc()` or `Math.floor()`, but performance tests have shown this method to
		 * be faster.
		 */
		const index = ((minIndex + maxIndex) / 2) | 0;
		const token = tokens[index];
		const tokenStartLocation = token.range[0];

if (location <= tokenStartLocation) {
			if (index === minIndex) {
				return index;
			}
			maxIndex = index;
		} else {
			minIndex = index + 1;
		}
	}
	return tokens.length;
}

/**
 * Gets the index of the `startLoc` in `tokens`.
 * `startLoc` can be the value of `node.range[1]`, so this checks about `startLoc - 1` as well.
 * @param {(Token|Comment)[]} tokens The tokens to find an index.
 * @param {Object} indexMap The map from locations to indices.
 * @param {number} startLoc The location to get an index.
 * @returns {number} The index.
 */
function getFirstIndex(tokens, indexMap, startLoc) {
	if (startLoc === -1) {
		return 0;
	}
	if (startLoc in indexMap) {
		return indexMap[startLoc];
	}
	if (startLoc - 1 in indexMap) {
		const index = indexMap[startLoc - 1];
		const token = tokens[index];

// If the mapped index is out of bounds, the returned cursor index will point after the end of the tokens array.
		if (!token) {
			return tokens.length;
		}

/*
		 * For the map of "comment's location -> token's index", it points the next token of a comment.
		 * In that case, +1 is unnecessary.
		 */
		if (token.range[0] >= startLoc) {
			return index;
		}
		return index + 1;
	}

// Program node that doesn't start/end with a token or comment
	if (startLoc === 0) {
		return 0;
	}
	return tokens.length;
}
/**
 * Gets the index of the `endLoc` in `tokens`.
 * The information of end locations are recorded at `endLoc - 1` in `indexMap`, so this checks about `endLoc - 1` as well.
 * @param {(Token|Comment)[]} tokens The tokens to find an index.
 * @param {Object} indexMap The map from locations to indices.
 * @param {number} endLoc The location to get an index.
 * @returns {number} The index.
 */
function getLastIndex(tokens, indexMap, endLoc) {
	if (endLoc === -1) {
		return tokens.length - 1;
	}
	if (endLoc in indexMap) {
		return indexMap[endLoc] - 1;
	}
	if (endLoc - 1 in indexMap) {
		const index = indexMap[endLoc - 1];
		const token = tokens[index];

// If the mapped index is out of bounds, the returned cursor index will point before the end of the tokens array.
		if (!token) {
			return tokens.length - 1;
		}

/*
		 * For the map of "comment's location -> token's index", it points the next token of a comment.
		 * In that case, -1 is necessary.
		 */
		if (token.range[1] > endLoc) {
			return index - 1;
		}
		return index;
	}

// Program node that doesn't start/end with a token or comment
	if (endLoc === 0) {
		return -1;
	}
	return tokens.length - 1;
}

//------------------------------------------------------------------------------
// Exports
//------------------------------------------------------------------------------

module.exports = { search, getFirstIndex, getLastIndex };

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
.htaccess	127 B	lr--r--r--	2026-03-14 01:49:12	Edit Download recursive recursive
backward-token-comment-cursor.js	1.83 KB	lrw-r--r--	2026-03-05 00:20:11	Edit Download recursive recursive
backward-token-cursor.js	1.57 KB	lrw-r--r--	2026-03-05 00:20:12	Edit Download recursive recursive
cursor.js	2.15 KB	lrw-r--r--	2026-03-05 00:20:16	Edit Download recursive recursive
cursors.js	3.63 KB	lrw-r--r--	2026-03-05 00:20:16	Edit Download recursive recursive
decorative-cursor.js	953 B	lrw-r--r--	2026-03-05 00:20:16	Edit Download recursive recursive
filter-cursor.js	1.08 KB	lrw-r--r--	2026-03-05 00:20:18	Edit Download recursive recursive
forward-token-comment-cursor.js	1.87 KB	lrw-r--r--	2026-03-05 00:20:18	Edit Download recursive recursive
forward-token-cursor.js	1.64 KB	lrw-r--r--	2026-03-05 00:20:18	Edit Download recursive recursive
index.js	21.06 KB	lrw-r--r--	2026-03-05 00:20:20	Edit Download recursive recursive
limit-cursor.js	1.00 KB	lrw-r--r--	2026-03-05 00:20:21	Edit Download recursive recursive
padded-token-cursor.js	1.54 KB	lrw-r--r--	2026-03-05 00:20:24	Edit Download recursive recursive
skip-cursor.js	1.04 KB	lrw-r--r--	2026-03-05 00:20:24	Edit Download recursive recursive
utils.js	3.78 KB	lrw-r--r--	2026-03-05 00:20:24	Edit Download recursive recursive

Directory Contents