@castlenine/vite-remove-attribute 1.0.1 → 2.0.0

package/dist/index.cjs

@@ -0,0 +1,540 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let node_path = require("node:path");
+//#region src/sourcemap.ts
+var BASE64_CHARACTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+var WORD_CHARACTER_REGEX = /\w/;
+/**
+* Encodes a single integer value as a base64 VLQ (Variable Length Quantity) string.
+*
+* @remarks
+* Base64 VLQ is the encoding format used for numbers in source map `mappings` fields.
+* This function encodes both positive and negative integers using bitwise operations,
+* setting the least significant bit for sign and using continuation bits for multi-digit numbers.
+*
+* @param value - The integer to encode. Can be positive, negative, or zero.
+*
+* @returns The VLQ Base64-encoded string representation.
+*
+* @see [Source Map V3 Spec](https://sourcemaps.info/spec.html)
+*/
+function encodeVlq(value) {
+	let vlq = value < 0 ? -value << 1 | 1 : value << 1;
+	let output = "";
+	do {
+		let digit = vlq & 31;
+		vlq >>>= 5;
+		if (vlq > 0) digit |= 32;
+		output += BASE64_CHARACTERS.charAt(digit);
+	} while (vlq > 0);
+	return output;
+}
+/**
+* Builds the `mappings` string one generated line at a time, encoding every segment as deltas from the previous one
+*/
+var MappingsWriter = class {
+	lines = [];
+	segments = [];
+	lastGeneratedColumn = 0;
+	lastOriginalLine = 0;
+	lastOriginalColumn = 0;
+	lastMappedColumn = -1;
+	addSegment(generatedColumn, originalLine, originalColumn) {
+		if (generatedColumn === this.lastMappedColumn) return;
+		this.segments.push(encodeVlq(generatedColumn - this.lastGeneratedColumn) + encodeVlq(0) + encodeVlq(originalLine - this.lastOriginalLine) + encodeVlq(originalColumn - this.lastOriginalColumn));
+		this.lastGeneratedColumn = generatedColumn;
+		this.lastOriginalLine = originalLine;
+		this.lastOriginalColumn = originalColumn;
+		this.lastMappedColumn = generatedColumn;
+	}
+	endLine() {
+		this.lines.push(this.segments.join(","));
+		this.segments = [];
+		this.lastGeneratedColumn = 0;
+		this.lastMappedColumn = -1;
+	}
+	toString() {
+		this.endLine();
+		return this.lines.join(";");
+	}
+};
+/**
+* Generates a source map for a given `source` string with the specified ranges removed.
+*
+* Emits a segment at the start of each generated line, at each position where the original text was cut, and at
+* every word boundary in between, allowing consumers to resolve any token to its original line and column.
+*
+* @param source - The original source code string.
+* @param ranges - Sorted, non-overlapping `[start, end)` character ranges to be removed.
+* @param file - The original file name or path. Used as the single source entry in the resulting source map.
+*
+* @returns The generated SourceMap object with correct mappings after range removal.
+*/
+function generateRemovalSourceMap(source, ranges, file) {
+	const WRITER = new MappingsWriter();
+	let generatedColumn = 0;
+	let originalLine = 0;
+	let originalColumn = 0;
+	let previousCharacter = "";
+	let cursor = 0;
+	/**
+	* Advances the original position from `from` to `to`, updating `originalLine` and `originalColumn`
+	* to correctly reflect skipping a removed range.
+	*
+	* @param from - Start index in the original source.
+	* @param to - End index in the original source.
+	*/
+	const ADVANCE_ORIGINAL = (from, to) => {
+		for (let index = from; index < to; index++) if (source.charAt(index) === "\n") {
+			originalLine++;
+			originalColumn = 0;
+		} else originalColumn++;
+	};
+	/**
+	* Emits source map segments for the kept region from `from` to `to`.
+	*
+	* @remarks
+	* A segment is written at every new line and at every word boundary change (as determined by
+	* `WORD_CHARACTER_REGEX`), so tools consuming the source map can resolve the original location of any token in
+	* the generated content. The `generatedColumn`, `originalLine` and `originalColumn` counters are advanced as the
+	* region is traversed, and `needsSegment` forces a segment right after a cut.
+	*
+	* @param from - Start index of the kept region.
+	* @param to - End index of the kept region.
+	*/
+	const WRITE_KEPT = (from, to) => {
+		let needsSegment = from < to;
+		for (let index = from; index < to; index++) {
+			const CHARACTER = source.charAt(index);
+			if (CHARACTER === "\n") {
+				WRITER.endLine();
+				generatedColumn = 0;
+				originalLine++;
+				originalColumn = 0;
+				needsSegment = true;
+			} else {
+				if (needsSegment || WORD_CHARACTER_REGEX.test(CHARACTER) !== WORD_CHARACTER_REGEX.test(previousCharacter)) {
+					WRITER.addSegment(generatedColumn, originalLine, originalColumn);
+					needsSegment = false;
+				}
+				generatedColumn++;
+				originalColumn++;
+			}
+			previousCharacter = CHARACTER;
+		}
+	};
+	for (const [START, END] of ranges) {
+		WRITE_KEPT(cursor, START);
+		ADVANCE_ORIGINAL(START, END);
+		cursor = END;
+	}
+	WRITE_KEPT(cursor, source.length);
+	return {
+		version: 3,
+		sources: [file],
+		sourcesContent: [source],
+		names: [],
+		mappings: WRITER.toString()
+	};
+}
+//#endregion
+//#region src/utilities.ts
+var DEFAULT_IGNORE_PATHS = [
+	"node_modules",
+	".git",
+	".idea",
+	".vscode",
+	".DS_Store",
+	"Thumbs.db",
+	".env",
+	".env.*",
+	"logs",
+	"*.log",
+	"public",
+	"build",
+	".svelte-kit",
+	"dist",
+	".nuxt",
+	".next",
+	".remix",
+	"e2e",
+	"angular.json",
+	"browserslist",
+	".cache"
+];
+var REGEX_SPECIAL_CHARACTERS_REGEX = /[.*+?^${}()|[\]\\]/g;
+var LEADING_RELATIVE_PREFIX_REGEX = /^(?:\.\/|\/)+/;
+var TRAILING_SLASHES_REGEX = /\/+$/;
+var LEADING_PARENT_SEGMENTS_REGEX = /^(?:\.\.\/)+/;
+var LEADING_DOTS_REGEX = /^\.+/;
+var TOKEN_REGEX_CACHE = /* @__PURE__ */ new Map();
+var EXTENSION_REGEX_CACHE = /* @__PURE__ */ new Map();
+function escapeRegExp(value) {
+	return value.replace(REGEX_SPECIAL_CHARACTERS_REGEX, "\\$&");
+}
+function getOptions(options) {
+	return {
+		extensions: Array.isArray(options.extensions) ? options.extensions : [],
+		attributes: Array.isArray(options.attributes) ? options.attributes : [],
+		ignoreFolders: Array.isArray(options.ignoreFolders) ? options.ignoreFolders : [],
+		ignoreFiles: Array.isArray(options.ignoreFiles) ? options.ignoreFiles : [],
+		ignoreDefaults: options.ignoreDefaults !== false
+	};
+}
+/**
+* Normalizes a user-supplied ignore token by trimming whitespace,
+* removing leading './' or '/', and stripping trailing '/' characters.
+*
+* @param path - The ignore token to normalize.
+*
+* @returns The normalized ignore token.
+*/
+function cleanIgnoredPath(path) {
+	return path.trim().replace(LEADING_RELATIVE_PREFIX_REGEX, "").replace(TRAILING_SLASHES_REGEX, "");
+}
+/**
+* Normalizes and de-duplicates ignore tokens by:
+* - Trimming whitespace from each path
+* - Removing leading './' or '/', and trailing '/' characters
+* - Dropping empty and root-only entries (such as `''`, `.`, `/`, and `./`)
+* - Removing duplicate entries in the result
+*
+* @param paths - An array of ignore path tokens to be cleaned and de-duplicated.
+*
+* @returns A new array containing unique, cleaned ignore tokens, with all empty or root-only entries omitted.
+*/
+function cleanIgnoredPaths(paths) {
+	const CLEANED = paths.filter((path) => typeof path === "string").map(cleanIgnoredPath).filter((path) => path !== "" && path !== ".");
+	return [...new Set(CLEANED)];
+}
+/**
+* Returns the combined and cleaned list of ignored paths based on the provided {@link ResolvedOptions}.
+*
+* @remarks
+* - Merges `ignoreFolders` and `ignoreFiles` into a single list.
+* - Cleans each entry using {@link cleanIgnoredPaths}.
+* - If `ignoreDefaults` is not explicitly set to `false`, the list also includes {@link DEFAULT_IGNORE_PATHS}.
+* - The resulting list is de-duplicated.
+*
+* @param options - The resolved options containing `ignoreFolders`, `ignoreFiles` and the `ignoreDefaults` flag.
+*
+* @returns An array of unique, cleaned ignore path tokens, including the built-in defaults unless
+*   {@link ResolvedOptions.ignoreDefaults} is `false`.
+*/
+function getIgnoredPaths(options) {
+	const CONFIGURED = cleanIgnoredPaths([...options.ignoreFolders, ...options.ignoreFiles]);
+	return options.ignoreDefaults ? [.../* @__PURE__ */ new Set([...CONFIGURED, ...DEFAULT_IGNORE_PATHS])] : CONFIGURED;
+}
+/**
+* Removes the `?query` suffix that Vite appends to module IDs.
+*
+* For example, given `/src/App.svelte?svelte&type=style&lang.css`, this function will return `/src/App.svelte`.
+*
+* @param id - The module ID which may include a `?query` suffix.
+*
+* @returns The module ID without any `?query` part.
+*/
+function stripQuery(id) {
+	const QUERY_INDEX = id.indexOf("?");
+	return QUERY_INDEX === -1 ? id : id.slice(0, QUERY_INDEX);
+}
+/**
+* Returns the path of a module ID relative to the Vite root directory, using POSIX separators.
+*
+* @param id - The module ID to be converted to a relative path.
+* @param root - The root directory to which the path will be made relative.
+*
+* @returns The relative path from the root to the module ID, using '/' as the separator.
+*/
+function toRelativePath(id, root) {
+	return (0, node_path.relative)(root, stripQuery(id)).split(node_path.sep).join("/");
+}
+/**
+* Returns a cached or newly-created regular expression to match a path segment token,
+* supporting `*` wildcards matching within a segment (but not across path separators).
+*
+* The regular expression is built so that `*` matches any sequence of characters except '/'.
+* The regex is cached for subsequent calls with the same token.
+*
+* @param token - The ignore token, possibly containing `*` wildcards.
+*
+* @returns The regular expression corresponding to the token, matching segment boundaries.
+*/
+function getTokenRegex(token) {
+	const CACHED = TOKEN_REGEX_CACHE.get(token);
+	if (CACHED) return CACHED;
+	const PATTERN = token.split("*").map(escapeRegExp).join("[^/]*");
+	const REGEX = new RegExp(`(?:^|/)${PATTERN}(?:/|$)`);
+	TOKEN_REGEX_CACHE.set(token, REGEX);
+	return REGEX;
+}
+/**
+* Checks if the given relative path matches any of the provided ignore tokens,
+* comparing on path-segment boundaries. Ignores leading parent directory segments.
+*
+* @remarks
+* This function ignores absolute IDs to avoid false positives from folder names that coincidentally
+* contain ignore tokens. For example, in environments like Cloudflare where a repo may be cloned
+* to a directory such as `/opt/buildhome/repo`, a token like `build` should not match simply
+* because it's part of the parent path. Only the path relative to the Vite root is considered.
+*
+* Leading `../` segments are stripped from the path so that modules resolved outside the root
+* (e.g. `../../.pnpm/x/node_modules/y/index.js`) still have the opportunity to match ignore tokens
+* like `node_modules` against their segments.
+*
+* @param relativePath - The path of the module relative to the Vite root.
+* @param tokens - The list of ignore tokens, possibly including `*` wildcards.
+*
+* @returns `true` if the relative path matches any ignore token; otherwise, `false`.
+*/
+function hasIgnorePath(relativePath, tokens) {
+	const PATH = relativePath.replace(LEADING_PARENT_SEGMENTS_REGEX, "");
+	return tokens.some((token) => getTokenRegex(token).test(PATH));
+}
+/**
+* Returns a regular expression that matches any of the provided file extensions at the end of a string.
+*
+* The extensions are matched case-insensitively and can be provided with or without leading dots.
+* The resulting regex is cached for subsequent calls with the same set of extensions.
+*
+* @param extensions - An array of file extension strings (with or without leading dots).
+*
+* @returns A RegExp instance matching any of the specified extensions as a file suffix.
+*/
+function getExtensionRegex(extensions) {
+	const KEY = extensions.join("|");
+	const CACHED = EXTENSION_REGEX_CACHE.get(KEY);
+	if (CACHED) return CACHED;
+	const PATTERN = extensions.map((extension) => escapeRegExp(extension.replace(LEADING_DOTS_REGEX, ""))).join("|");
+	const REGEX = new RegExp(`\\.(?:${PATTERN})$`, "i");
+	EXTENSION_REGEX_CACHE.set(KEY, REGEX);
+	return REGEX;
+}
+/**
+* Determines whether the provided module id (with query suffix stripped) ends with one of the specified extensions.
+*
+* @param id - The module identifier, possibly including a query suffix (e.g., `file.js?raw`).
+* @param extensions - An array of file extension strings (with or without leading dots).
+*
+* @returns `true` if the module id (excluding the query suffix) ends with one of the provided extensions;
+*   otherwise, `false`.
+*/
+function hasExtension(id, extensions) {
+	if (extensions.length === 0) return false;
+	return getExtensionRegex(extensions).test(stripQuery(id));
+}
+/**
+* Character-by-character scanner for an `={…}` expression: tracks nested braces, quoted strings, template literals
+* and their `${…}` placeholders, and reports when the opening brace is closed
+*/
+var ExpressionScanner = class {
+	frames = [{
+		kind: "expression",
+		depth: 1
+	}];
+	stringQuote = "";
+	isEscaped = false;
+	step(character, next) {
+		if (this.isEscaped) {
+			this.isEscaped = false;
+			return "continue";
+		}
+		if (character === "\\") {
+			this.isEscaped = true;
+			return "continue";
+		}
+		if (this.stringQuote !== "") {
+			if (character === this.stringQuote) this.stringQuote = "";
+			return "continue";
+		}
+		const FRAME = this.frames.at(-1);
+		if (!FRAME) return "continue";
+		return FRAME.kind === "template" ? this.stepTemplate(character, next) : this.stepExpression(FRAME, character);
+	}
+	stepTemplate(character, next) {
+		if (character === "`") this.frames.pop();
+		else if (character === "$" && next === "{") {
+			this.frames.push({
+				kind: "expression",
+				depth: 1
+			});
+			return "skip-next";
+		}
+		return "continue";
+	}
+	stepExpression(frame, character) {
+		if (character === "'" || character === "\"") this.stringQuote = character;
+		else if (character === "`") this.frames.push({ kind: "template" });
+		else if (character === "{") frame.depth++;
+		else if (character === "}") return this.closeBrace(frame);
+		return "continue";
+	}
+	closeBrace(frame) {
+		frame.depth--;
+		if (frame.depth > 0) return "continue";
+		if (this.frames.length === 1) return "closed";
+		this.frames.pop();
+		return "continue";
+	}
+};
+/**
+* Finds the closing brace for an `={…}` attribute value in a string of markup. Returns the index of the closing
+* brace, or `-1` if the braces are unbalanced or not found.
+*
+* @remarks
+* A regular expression cannot do this: the expression may hold a template literal whose `${…}` placeholders nest
+* further braces, and a brace inside a string is text rather than structure. The scanner tracks both.
+*
+* @param input - The input string containing the markup or code.
+* @param openingBraceIndex - The index of the opening `{` character to start scanning from.
+*
+* @returns The index of the corresponding closing `}` brace, or `-1` if unmatched.
+*
+* @example
+* ```ts
+* findExpressionEnd('foo={a + {b: `1${two}`}}', 4); // returns the index of the matching }
+* ```
+*/
+function findExpressionEnd(input, openingBraceIndex) {
+	const SCANNER = new ExpressionScanner();
+	for (let index = openingBraceIndex + 1; index < input.length; index++) {
+		const STEP = SCANNER.step(input.charAt(index), input.charAt(index + 1));
+		if (STEP === "closed") return index;
+		if (STEP === "skip-next") index++;
+	}
+	return -1;
+}
+/**
+* Finds all ranges (start and end indices) for a specific attribute in the given markup input.
+*
+* Handles quoted values, expression values (i.e., `={...}`), and bare attributes, including optional
+* `:` or `v-bind:` prefixes. The detection accounts for whitespace before the attribute, as well as attributes
+* written on their own line. If an attribute value is an expression (`={...}`), this function uses
+* {@link findExpressionEnd} to locate the closing brace, and gracefully skips unbalanced or invalid expressions.
+*
+* @remarks
+* The returned ranges are suitable for text replacements: all whitespace before the attribute is included
+* so that removing the attribute does not leave a dangling blank line or extra spaces.
+*
+* @param input - The input markup string to search for the attribute within.
+* @param attribute - The name of the attribute to locate (e.g., `"data-testid"`).
+*
+* @returns An array of `[start, end)` ranges (as type `Range`) for each found occurrence of the attribute.
+*/
+function findAttributeRangesFor(input, attribute) {
+	const NAME = escapeRegExp(attribute);
+	const PATTERN = new RegExp(`\\s+(?::|v-bind:)?${NAME}(?:\\s*=\\s*(?:(['"\`])(?:(?!\\1)[\\s\\S])*\\1|(\\{))|(?=[\\s/>]))`, "gi");
+	const RANGES = [];
+	let match = PATTERN.exec(input);
+	while (match !== null) {
+		const MATCH_END = match.index + match[0].length;
+		let attributeEnd = MATCH_END;
+		if (match[2] !== void 0) {
+			const CLOSING_BRACE_INDEX = findExpressionEnd(input, MATCH_END - 1);
+			if (CLOSING_BRACE_INDEX === -1) {
+				match = PATTERN.exec(input);
+				continue;
+			}
+			attributeEnd = CLOSING_BRACE_INDEX + 1;
+		}
+		RANGES.push([match.index, attributeEnd]);
+		PATTERN.lastIndex = attributeEnd;
+		match = PATTERN.exec(input);
+	}
+	return RANGES;
+}
+/**
+* Returns the merged ranges of every occurrence of the given attributes (in quoted, `={expression}`,
+* or bare form, with optional `:` or `v-bind:` prefix) within the markup string. The resulting
+* ranges are sorted by start index, and any touching or overlapping ranges are merged.
+*
+* All attributes are located in the same original input, so the returned ranges can be used
+* for sourcemap-aware or batch editing operations.
+*
+* @param input - The markup string to search for the attributes.
+* @param attributes - An array of attribute names to search for (e.g., `['data-testid', 'data-id']`).
+*
+* @returns An array of `Range` tuples, each representing [start, end) of a matched attribute occurrence,
+*          with adjacent and overlapping ranges merged.
+*/
+function findAttributeRanges(input, attributes) {
+	const RANGES = attributes.flatMap((attribute) => findAttributeRangesFor(input, attribute)).sort((a, b) => a[0] - b[0] || a[1] - b[1]);
+	const MERGED = [];
+	for (const [START, END] of RANGES) {
+		const LAST = MERGED.at(-1);
+		if (LAST && START <= LAST[1]) LAST[1] = Math.max(LAST[1], END);
+		else MERGED.push([START, END]);
+	}
+	return MERGED;
+}
+/**
+* Returns a copy of the input string with the specified ranges removed.
+*
+* The provided ranges must be sorted by start index and non-overlapping.
+* Each range is specified as a tuple [start, end), with `start` inclusive and `end` exclusive.
+* The function concatenates the segments of the input string outside of these ranges.
+*
+* @param input - The original string from which to remove segments.
+* @param ranges - An array of `[start, end)` index ranges (sorted, non-overlapping) to cut out from the input.
+*
+* @returns The resulting string after all specified ranges have been removed from the input.
+*/
+function removeRanges(input, ranges) {
+	if (ranges.length === 0) return input;
+	const SEGMENTS = [];
+	let lastEnd = 0;
+	for (const [START, END] of ranges) {
+		SEGMENTS.push(input.slice(lastEnd, START));
+		lastEnd = END;
+	}
+	SEGMENTS.push(input.slice(lastEnd));
+	return SEGMENTS.join("");
+}
+//#endregion
+//#region src/index.ts
+/**
+* Vite plugin to remove specified attributes from markup files.
+*
+* This plugin scans files with configured extensions and removes
+* attributes as defined in the option list. It also produces
+* accurate source maps to ensure the original line and column numbers
+* are preserved for consumers of the Vite build chain.
+*
+* Files can be ignored based on path token matching. Ignore patterns
+* are resolved relative to the Vite root.
+*
+* @param options - Plugin configuration including which attributes
+*   and file extensions to target, and optional ignore paths.
+*
+* @returns A Vite plugin object that removes attributes during
+*   transformation steps.
+*/
+function removeAttributesPlugin(options) {
+	const OPTIONS = getOptions(options);
+	const IGNORED_PATHS = getIgnoredPaths(OPTIONS);
+	let root = process.cwd();
+	return {
+		name: "remove-attributes",
+		enforce: "pre",
+		configResolved(config) {
+			root = config.root;
+		},
+		transform(code, id) {
+			if (id.startsWith("\0") || !hasExtension(id, OPTIONS.extensions) || hasIgnorePath(toRelativePath(id, root), IGNORED_PATHS)) return null;
+			const RANGES = findAttributeRanges(code, OPTIONS.attributes);
+			if (RANGES.length === 0) return null;
+			return {
+				code: removeRanges(code, RANGES),
+				map: generateRemovalSourceMap(code, RANGES, stripQuery(id))
+			};
+		}
+	};
+}
+//#endregion
+exports.default = removeAttributesPlugin;
+module.exports = exports.default;
+module.exports.default = module.exports;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/sourcemap.ts","../src/utilities.ts","../src/index.ts"],"sourcesContent":["import type { Range } from './utilities';\n\n/**\n * Source map v3 object, as accepted by Vite's `transform` hook (`map`)\n */\ninterface SourceMap {\n\tversion: 3;\n\tsources: string[];\n\tsourcesContent: string[];\n\tnames: string[];\n\tmappings: string;\n}\n\nconst BASE64_CHARACTERS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';\nconst WORD_CHARACTER_REGEX = /\\w/;\n\n/**\n * Encodes a single integer value as a base64 VLQ (Variable Length Quantity) string.\n *\n * @remarks\n * Base64 VLQ is the encoding format used for numbers in source map `mappings` fields.\n * This function encodes both positive and negative integers using bitwise operations,\n * setting the least significant bit for sign and using continuation bits for multi-digit numbers.\n *\n * @param value - The integer to encode. Can be positive, negative, or zero.\n *\n * @returns The VLQ Base64-encoded string representation.\n *\n * @see [Source Map V3 Spec](https://sourcemaps.info/spec.html)\n */\nfunction encodeVlq(value: number): string {\n\tlet vlq = value < 0 ? (-value << 1) | 1 : value << 1;\n\tlet output = '';\n\n\tdo {\n\t\tlet digit = vlq & 31;\n\n\t\tvlq >>>= 5;\n\n\t\tif (vlq > 0) {\n\t\t\tdigit |= 32;\n\t\t}\n\n\t\toutput += BASE64_CHARACTERS.charAt(digit);\n\t} while (vlq > 0);\n\n\treturn output;\n}\n\n/**\n * Builds the `mappings` string one generated line at a time, encoding every segment as deltas from the previous one\n */\nclass MappingsWriter {\n\tprivate readonly lines: string[] = [];\n\tprivate segments: string[] = [];\n\tprivate lastGeneratedColumn = 0;\n\tprivate lastOriginalLine = 0;\n\tprivate lastOriginalColumn = 0;\n\tprivate lastMappedColumn = -1;\n\n\taddSegment(generatedColumn: number, originalLine: number, originalColumn: number): void {\n\t\t// Two candidates for the same generated column always describe the same original position\n\t\tif (generatedColumn === this.lastMappedColumn) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis.segments.push(\n\t\t\tencodeVlq(generatedColumn - this.lastGeneratedColumn) +\n\t\t\t\tencodeVlq(0) +\n\t\t\t\tencodeVlq(originalLine - this.lastOriginalLine) +\n\t\t\t\tencodeVlq(originalColumn - this.lastOriginalColumn),\n\t\t);\n\t\tthis.lastGeneratedColumn = generatedColumn;\n\t\tthis.lastOriginalLine = originalLine;\n\t\tthis.lastOriginalColumn = originalColumn;\n\t\tthis.lastMappedColumn = generatedColumn;\n\t}\n\n\tendLine(): void {\n\t\tthis.lines.push(this.segments.join(','));\n\t\tthis.segments = [];\n\t\tthis.lastGeneratedColumn = 0;\n\t\tthis.lastMappedColumn = -1;\n\t}\n\n\ttoString(): string {\n\t\tthis.endLine();\n\n\t\treturn this.lines.join(';');\n\t}\n}\n\n/**\n * Generates a source map for a given `source` string with the specified ranges removed.\n *\n * Emits a segment at the start of each generated line, at each position where the original text was cut, and at\n * every word boundary in between, allowing consumers to resolve any token to its original line and column.\n *\n * @param source - The original source code string.\n * @param ranges - Sorted, non-overlapping `[start, end)` character ranges to be removed.\n * @param file - The original file name or path. Used as the single source entry in the resulting source map.\n *\n * @returns The generated SourceMap object with correct mappings after range removal.\n */\nfunction generateRemovalSourceMap(source: string, ranges: Range[], file: string): SourceMap {\n\tconst WRITER = new MappingsWriter();\n\n\tlet generatedColumn = 0;\n\tlet originalLine = 0;\n\tlet originalColumn = 0;\n\tlet previousCharacter = '';\n\tlet cursor = 0;\n\n\t/**\n\t * Advances the original position from `from` to `to`, updating `originalLine` and `originalColumn`\n\t * to correctly reflect skipping a removed range.\n\t *\n\t * @param from - Start index in the original source.\n\t * @param to - End index in the original source.\n\t */\n\tconst ADVANCE_ORIGINAL = (from: number, to: number): void => {\n\t\tfor (let index = from; index < to; index++) {\n\t\t\tif (source.charAt(index) === '\\n') {\n\t\t\t\toriginalLine++;\n\t\t\t\toriginalColumn = 0;\n\t\t\t} else {\n\t\t\t\toriginalColumn++;\n\t\t\t}\n\t\t}\n\t};\n\n\t/**\n\t * Emits source map segments for the kept region from `from` to `to`.\n\t *\n\t * @remarks\n\t * A segment is written at every new line and at every word boundary change (as determined by\n\t * `WORD_CHARACTER_REGEX`), so tools consuming the source map can resolve the original location of any token in\n\t * the generated content. The `generatedColumn`, `originalLine` and `originalColumn` counters are advanced as the\n\t * region is traversed, and `needsSegment` forces a segment right after a cut.\n\t *\n\t * @param from - Start index of the kept region.\n\t * @param to - End index of the kept region.\n\t */\n\tconst WRITE_KEPT = (from: number, to: number): void => {\n\t\tlet needsSegment = from < to;\n\n\t\tfor (let index = from; index < to; index++) {\n\t\t\tconst CHARACTER = source.charAt(index);\n\n\t\t\tif (CHARACTER === '\\n') {\n\t\t\t\tWRITER.endLine();\n\t\t\t\tgeneratedColumn = 0;\n\t\t\t\toriginalLine++;\n\t\t\t\toriginalColumn = 0;\n\t\t\t\tneedsSegment = true;\n\t\t\t} else {\n\t\t\t\tif (needsSegment || WORD_CHARACTER_REGEX.test(CHARACTER) !== WORD_CHARACTER_REGEX.test(previousCharacter)) {\n\t\t\t\t\tWRITER.addSegment(generatedColumn, originalLine, originalColumn);\n\t\t\t\t\tneedsSegment = false;\n\t\t\t\t}\n\n\t\t\t\tgeneratedColumn++;\n\t\t\t\toriginalColumn++;\n\t\t\t}\n\n\t\t\tpreviousCharacter = CHARACTER;\n\t\t}\n\t};\n\n\t// Emit the kept text before each removed range, then advance the original position through the removed\n\t// content; whatever follows the last range is emitted afterwards\n\tfor (const [START, END] of ranges) {\n\t\tWRITE_KEPT(cursor, START);\n\t\tADVANCE_ORIGINAL(START, END);\n\t\tcursor = END;\n\t}\n\n\tWRITE_KEPT(cursor, source.length);\n\n\treturn {\n\t\tversion: 3,\n\t\tsources: [file],\n\t\tsourcesContent: [source],\n\t\tnames: [],\n\t\tmappings: WRITER.toString(),\n\t};\n}\n\nexport type { SourceMap };\nexport { encodeVlq, generateRemovalSourceMap };\n","import type { Options, ResolvedOptions } from './types';\n\nimport { relative, sep } from 'node:path';\n\nconst DEFAULT_IGNORE_PATHS: string[] = [\n\t// Node modules\n\t'node_modules',\n\n\t// Git\n\t'.git',\n\n\t// IDE configurations\n\t'.idea', // JetBrains IDEs (e.g., WebStorm)\n\t'.vscode', // Visual Studio Code\n\n\t// OS generated files\n\t'.DS_Store', // macOS\n\t'Thumbs.db', // Windows\n\n\t// Environment variables\n\t'.env',\n\t'.env.*', // .env.development, .env.production, etc.\n\n\t// Logs\n\t'logs',\n\t'*.log',\n\n\t// Svelte\n\t'public', // Svelte.js public folder\n\t'build', // Svelte.js build folder\n\n\t// SvelteKit\n\t'.svelte-kit', // SvelteKit generates this folder\n\n\t// Dist\n\t'dist', // Distribution folder\n\n\t// Vue.js\n\t'.nuxt', // Nuxt.js generates this folder\n\n\t// React.js\n\t'.next', // Next.js generates this folder\n\n\t// Remix.js\n\t'.remix', // Remix.js cache\n\n\t// Angular\n\t'e2e', // End-to-end tests in Angular\n\t'angular.json', // Angular CLI configuration\n\t'browserslist', // Browser compatibility list for Angular\n\n\t'.cache', // Cache files for various tools\n];\n\nconst REGEX_SPECIAL_CHARACTERS_REGEX = /[.*+?^${}()|[\\]\\\\]/g;\nconst LEADING_RELATIVE_PREFIX_REGEX = /^(?:\\.\\/|\\/)+/;\nconst TRAILING_SLASHES_REGEX = /\\/+$/;\nconst LEADING_PARENT_SEGMENTS_REGEX = /^(?:\\.\\.\\/)+/;\nconst LEADING_DOTS_REGEX = /^\\.+/;\n\nconst TOKEN_REGEX_CACHE = new Map<string, RegExp>();\nconst EXTENSION_REGEX_CACHE = new Map<string, RegExp>();\n\nfunction escapeRegExp(value: string): string {\n\treturn value.replace(REGEX_SPECIAL_CHARACTERS_REGEX, '\\\\$&');\n}\n\nfunction getOptions(options: Options): ResolvedOptions {\n\treturn {\n\t\textensions: Array.isArray(options.extensions) ? options.extensions : [],\n\t\tattributes: Array.isArray(options.attributes) ? options.attributes : [],\n\t\tignoreFolders: Array.isArray(options.ignoreFolders) ? options.ignoreFolders : [],\n\t\tignoreFiles: Array.isArray(options.ignoreFiles) ? options.ignoreFiles : [],\n\t\tignoreDefaults: options.ignoreDefaults !== false,\n\t};\n}\n\n/**\n * Normalizes a user-supplied ignore token by trimming whitespace,\n * removing leading './' or '/', and stripping trailing '/' characters.\n *\n * @param path - The ignore token to normalize.\n *\n * @returns The normalized ignore token.\n */\nfunction cleanIgnoredPath(path: string): string {\n\treturn path.trim().replace(LEADING_RELATIVE_PREFIX_REGEX, '').replace(TRAILING_SLASHES_REGEX, '');\n}\n\n/**\n * Normalizes and de-duplicates ignore tokens by:\n * - Trimming whitespace from each path\n * - Removing leading './' or '/', and trailing '/' characters\n * - Dropping empty and root-only entries (such as `''`, `.`, `/`, and `./`)\n * - Removing duplicate entries in the result\n *\n * @param paths - An array of ignore path tokens to be cleaned and de-duplicated.\n *\n * @returns A new array containing unique, cleaned ignore tokens, with all empty or root-only entries omitted.\n */\nfunction cleanIgnoredPaths(paths: string[]): string[] {\n\tconst CLEANED = paths\n\t\t.filter((path): path is string => typeof path === 'string')\n\t\t.map(cleanIgnoredPath)\n\t\t.filter((path) => path !== '' && path !== '.');\n\n\treturn [...new Set(CLEANED)];\n}\n\n/**\n * Returns the combined and cleaned list of ignored paths based on the provided {@link ResolvedOptions}.\n *\n * @remarks\n * - Merges `ignoreFolders` and `ignoreFiles` into a single list.\n * - Cleans each entry using {@link cleanIgnoredPaths}.\n * - If `ignoreDefaults` is not explicitly set to `false`, the list also includes {@link DEFAULT_IGNORE_PATHS}.\n * - The resulting list is de-duplicated.\n *\n * @param options - The resolved options containing `ignoreFolders`, `ignoreFiles` and the `ignoreDefaults` flag.\n *\n * @returns An array of unique, cleaned ignore path tokens, including the built-in defaults unless\n *   {@link ResolvedOptions.ignoreDefaults} is `false`.\n */\nfunction getIgnoredPaths(options: ResolvedOptions): string[] {\n\tconst CONFIGURED = cleanIgnoredPaths([...options.ignoreFolders, ...options.ignoreFiles]);\n\n\treturn options.ignoreDefaults ? [...new Set([...CONFIGURED, ...DEFAULT_IGNORE_PATHS])] : CONFIGURED;\n}\n\n/**\n * Removes the `?query` suffix that Vite appends to module IDs.\n *\n * For example, given `/src/App.svelte?svelte&type=style&lang.css`, this function will return `/src/App.svelte`.\n *\n * @param id - The module ID which may include a `?query` suffix.\n *\n * @returns The module ID without any `?query` part.\n */\nfunction stripQuery(id: string): string {\n\tconst QUERY_INDEX = id.indexOf('?');\n\n\treturn QUERY_INDEX === -1 ? id : id.slice(0, QUERY_INDEX);\n}\n\n/**\n * Returns the path of a module ID relative to the Vite root directory, using POSIX separators.\n *\n * @param id - The module ID to be converted to a relative path.\n * @param root - The root directory to which the path will be made relative.\n *\n * @returns The relative path from the root to the module ID, using '/' as the separator.\n */\nfunction toRelativePath(id: string, root: string): string {\n\treturn relative(root, stripQuery(id)).split(sep).join('/');\n}\n\n/**\n * Returns a cached or newly-created regular expression to match a path segment token,\n * supporting `*` wildcards matching within a segment (but not across path separators).\n *\n * The regular expression is built so that `*` matches any sequence of characters except '/'.\n * The regex is cached for subsequent calls with the same token.\n *\n * @param token - The ignore token, possibly containing `*` wildcards.\n *\n * @returns The regular expression corresponding to the token, matching segment boundaries.\n */\nfunction getTokenRegex(token: string): RegExp {\n\tconst CACHED = TOKEN_REGEX_CACHE.get(token);\n\n\tif (CACHED) {\n\t\treturn CACHED;\n\t}\n\n\t// `*` matches within a single segment; everything else is literal\n\tconst PATTERN = token.split('*').map(escapeRegExp).join('[^/]*');\n\t// eslint-disable-next-line security/detect-non-literal-regexp -- the token is regex-escaped above\n\tconst REGEX = new RegExp(`(?:^|/)${PATTERN}(?:/|$)`);\n\n\tTOKEN_REGEX_CACHE.set(token, REGEX);\n\n\treturn REGEX;\n}\n\n/**\n * Checks if the given relative path matches any of the provided ignore tokens,\n * comparing on path-segment boundaries. Ignores leading parent directory segments.\n *\n * @remarks\n * This function ignores absolute IDs to avoid false positives from folder names that coincidentally\n * contain ignore tokens. For example, in environments like Cloudflare where a repo may be cloned\n * to a directory such as `/opt/buildhome/repo`, a token like `build` should not match simply\n * because it's part of the parent path. Only the path relative to the Vite root is considered.\n *\n * Leading `../` segments are stripped from the path so that modules resolved outside the root\n * (e.g. `../../.pnpm/x/node_modules/y/index.js`) still have the opportunity to match ignore tokens\n * like `node_modules` against their segments.\n *\n * @param relativePath - The path of the module relative to the Vite root.\n * @param tokens - The list of ignore tokens, possibly including `*` wildcards.\n *\n * @returns `true` if the relative path matches any ignore token; otherwise, `false`.\n */\nfunction hasIgnorePath(relativePath: string, tokens: string[]): boolean {\n\tconst PATH = relativePath.replace(LEADING_PARENT_SEGMENTS_REGEX, '');\n\n\treturn tokens.some((token) => getTokenRegex(token).test(PATH));\n}\n\n/**\n * Returns a regular expression that matches any of the provided file extensions at the end of a string.\n *\n * The extensions are matched case-insensitively and can be provided with or without leading dots.\n * The resulting regex is cached for subsequent calls with the same set of extensions.\n *\n * @param extensions - An array of file extension strings (with or without leading dots).\n *\n * @returns A RegExp instance matching any of the specified extensions as a file suffix.\n */\nfunction getExtensionRegex(extensions: string[]): RegExp {\n\tconst KEY = extensions.join('|');\n\tconst CACHED = EXTENSION_REGEX_CACHE.get(KEY);\n\n\tif (CACHED) {\n\t\treturn CACHED;\n\t}\n\n\tconst PATTERN = extensions.map((extension) => escapeRegExp(extension.replace(LEADING_DOTS_REGEX, ''))).join('|');\n\t// eslint-disable-next-line security/detect-non-literal-regexp -- the extensions are regex-escaped above\n\tconst REGEX = new RegExp(`\\\\.(?:${PATTERN})$`, 'i');\n\n\tEXTENSION_REGEX_CACHE.set(KEY, REGEX);\n\n\treturn REGEX;\n}\n\n/**\n * Determines whether the provided module id (with query suffix stripped) ends with one of the specified extensions.\n *\n * @param id - The module identifier, possibly including a query suffix (e.g., `file.js?raw`).\n * @param extensions - An array of file extension strings (with or without leading dots).\n *\n * @returns `true` if the module id (excluding the query suffix) ends with one of the provided extensions;\n *   otherwise, `false`.\n */\nfunction hasExtension(id: string, extensions: string[]): boolean {\n\tif (extensions.length === 0) {\n\t\treturn false;\n\t}\n\n\treturn getExtensionRegex(extensions).test(stripQuery(id));\n}\n\ninterface ExpressionFrame {\n\tkind: 'expression';\n\tdepth: number;\n}\n\ninterface TemplateFrame {\n\tkind: 'template';\n}\n\ntype Frame = ExpressionFrame | TemplateFrame;\n\ntype ScanStep = 'closed' | 'continue' | 'skip-next';\n\n/**\n * Character-by-character scanner for an `={…}` expression: tracks nested braces, quoted strings, template literals\n * and their `${…}` placeholders, and reports when the opening brace is closed\n */\nclass ExpressionScanner {\n\tprivate readonly frames: Frame[] = [{ kind: 'expression', depth: 1 }];\n\tprivate stringQuote = '';\n\tprivate isEscaped = false;\n\n\tstep(character: string, next: string): ScanStep {\n\t\tif (this.isEscaped) {\n\t\t\tthis.isEscaped = false;\n\n\t\t\treturn 'continue';\n\t\t}\n\n\t\tif (character === '\\\\') {\n\t\t\tthis.isEscaped = true;\n\n\t\t\treturn 'continue';\n\t\t}\n\n\t\tif (this.stringQuote !== '') {\n\t\t\tif (character === this.stringQuote) {\n\t\t\t\tthis.stringQuote = '';\n\t\t\t}\n\n\t\t\treturn 'continue';\n\t\t}\n\n\t\tconst FRAME = this.frames.at(-1);\n\n\t\tif (!FRAME) {\n\t\t\treturn 'continue';\n\t\t}\n\n\t\treturn FRAME.kind === 'template' ? this.stepTemplate(character, next) : this.stepExpression(FRAME, character);\n\t}\n\n\tprivate stepTemplate(character: string, next: string): ScanStep {\n\t\tif (character === '`') {\n\t\t\tthis.frames.pop();\n\t\t} else if (character === '$' && next === '{') {\n\t\t\tthis.frames.push({ kind: 'expression', depth: 1 });\n\n\t\t\treturn 'skip-next';\n\t\t}\n\n\t\treturn 'continue';\n\t}\n\n\tprivate stepExpression(frame: ExpressionFrame, character: string): ScanStep {\n\t\tif (character === \"'\" || character === '\"') {\n\t\t\tthis.stringQuote = character;\n\t\t} else if (character === '`') {\n\t\t\tthis.frames.push({ kind: 'template' });\n\t\t} else if (character === '{') {\n\t\t\tframe.depth++;\n\t\t} else if (character === '}') {\n\t\t\treturn this.closeBrace(frame);\n\t\t}\n\n\t\treturn 'continue';\n\t}\n\n\tprivate closeBrace(frame: ExpressionFrame): ScanStep {\n\t\tframe.depth--;\n\n\t\tif (frame.depth > 0) {\n\t\t\treturn 'continue';\n\t\t}\n\n\t\tif (this.frames.length === 1) {\n\t\t\treturn 'closed';\n\t\t}\n\n\t\tthis.frames.pop();\n\n\t\treturn 'continue';\n\t}\n}\n\n/**\n * Finds the closing brace for an `={…}` attribute value in a string of markup. Returns the index of the closing\n * brace, or `-1` if the braces are unbalanced or not found.\n *\n * @remarks\n * A regular expression cannot do this: the expression may hold a template literal whose `${…}` placeholders nest\n * further braces, and a brace inside a string is text rather than structure. The scanner tracks both.\n *\n * @param input - The input string containing the markup or code.\n * @param openingBraceIndex - The index of the opening `{` character to start scanning from.\n *\n * @returns The index of the corresponding closing `}` brace, or `-1` if unmatched.\n *\n * @example\n * ```ts\n * findExpressionEnd('foo={a + {b: `1${two}`}}', 4); // returns the index of the matching }\n * ```\n */\nfunction findExpressionEnd(input: string, openingBraceIndex: number): number {\n\tconst SCANNER = new ExpressionScanner();\n\n\tfor (let index = openingBraceIndex + 1; index < input.length; index++) {\n\t\tconst STEP = SCANNER.step(input.charAt(index), input.charAt(index + 1));\n\n\t\tif (STEP === 'closed') {\n\t\t\treturn index;\n\t\t}\n\n\t\tif (STEP === 'skip-next') {\n\t\t\tindex++;\n\t\t}\n\t}\n\n\treturn -1;\n}\n\n/**\n * Half-open `[start, end)` range of characters in the original input\n */\ntype Range = readonly [start: number, end: number];\n\n/**\n * Finds all ranges (start and end indices) for a specific attribute in the given markup input.\n *\n * Handles quoted values, expression values (i.e., `={...}`), and bare attributes, including optional\n * `:` or `v-bind:` prefixes. The detection accounts for whitespace before the attribute, as well as attributes\n * written on their own line. If an attribute value is an expression (`={...}`), this function uses\n * {@link findExpressionEnd} to locate the closing brace, and gracefully skips unbalanced or invalid expressions.\n *\n * @remarks\n * The returned ranges are suitable for text replacements: all whitespace before the attribute is included\n * so that removing the attribute does not leave a dangling blank line or extra spaces.\n *\n * @param input - The input markup string to search for the attribute within.\n * @param attribute - The name of the attribute to locate (e.g., `\"data-testid\"`).\n *\n * @returns An array of `[start, end)` ranges (as type `Range`) for each found occurrence of the attribute.\n */\nfunction findAttributeRangesFor(input: string, attribute: string): Range[] {\n\tconst NAME = escapeRegExp(attribute);\n\t// The leading `\\s+` swallows all whitespace before the attribute, so an attribute on its own line leaves no\n\t// blank line behind. Three forms follow: quoted value (group 1 = quote), expression value (group 2 = opening\n\t// brace, measured by `findExpressionEnd`), or bare attribute followed by whitespace, `/` or `>`\n\t// eslint-disable-next-line security/detect-non-literal-regexp -- the attribute name is regex-escaped above\n\tconst PATTERN = new RegExp(\n\t\t`\\\\s+(?::|v-bind:)?${NAME}(?:\\\\s*=\\\\s*(?:(['\"\\`])(?:(?!\\\\1)[\\\\s\\\\S])*\\\\1|(\\\\{))|(?=[\\\\s/>]))`,\n\t\t'gi',\n\t);\n\tconst RANGES: Range[] = [];\n\n\tlet match = PATTERN.exec(input);\n\n\twhile (match !== null) {\n\t\tconst MATCH_END = match.index + match[0].length;\n\n\t\tlet attributeEnd = MATCH_END;\n\n\t\tif (match[2] !== undefined) {\n\t\t\tconst CLOSING_BRACE_INDEX = findExpressionEnd(input, MATCH_END - 1);\n\n\t\t\t// An unbalanced expression means the source does not parse as written: leave it alone rather than\n\t\t\t// cutting the file at an arbitrary point\n\t\t\tif (CLOSING_BRACE_INDEX === -1) {\n\t\t\t\tmatch = PATTERN.exec(input);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tattributeEnd = CLOSING_BRACE_INDEX + 1;\n\t\t}\n\n\t\tRANGES.push([match.index, attributeEnd]);\n\t\tPATTERN.lastIndex = attributeEnd;\n\t\tmatch = PATTERN.exec(input);\n\t}\n\n\treturn RANGES;\n}\n\n/**\n * Returns the merged ranges of every occurrence of the given attributes (in quoted, `={expression}`,\n * or bare form, with optional `:` or `v-bind:` prefix) within the markup string. The resulting\n * ranges are sorted by start index, and any touching or overlapping ranges are merged.\n *\n * All attributes are located in the same original input, so the returned ranges can be used\n * for sourcemap-aware or batch editing operations.\n *\n * @param input - The markup string to search for the attributes.\n * @param attributes - An array of attribute names to search for (e.g., `['data-testid', 'data-id']`).\n *\n * @returns An array of `Range` tuples, each representing [start, end) of a matched attribute occurrence,\n *          with adjacent and overlapping ranges merged.\n */\nfunction findAttributeRanges(input: string, attributes: string[]): Range[] {\n\tconst RANGES = attributes\n\t\t.flatMap((attribute) => findAttributeRangesFor(input, attribute))\n\t\t.sort((a, b) => a[0] - b[0] || a[1] - b[1]);\n\tconst MERGED: [number, number][] = [];\n\n\tfor (const [START, END] of RANGES) {\n\t\tconst LAST = MERGED.at(-1);\n\n\t\tif (LAST && START <= LAST[1]) {\n\t\t\tLAST[1] = Math.max(LAST[1], END);\n\t\t} else {\n\t\t\tMERGED.push([START, END]);\n\t\t}\n\t}\n\n\treturn MERGED;\n}\n\n/**\n * Returns a copy of the input string with the specified ranges removed.\n *\n * The provided ranges must be sorted by start index and non-overlapping.\n * Each range is specified as a tuple [start, end), with `start` inclusive and `end` exclusive.\n * The function concatenates the segments of the input string outside of these ranges.\n *\n * @param input - The original string from which to remove segments.\n * @param ranges - An array of `[start, end)` index ranges (sorted, non-overlapping) to cut out from the input.\n *\n * @returns The resulting string after all specified ranges have been removed from the input.\n */\nfunction removeRanges(input: string, ranges: Range[]): string {\n\tif (ranges.length === 0) {\n\t\treturn input;\n\t}\n\n\tconst SEGMENTS: string[] = [];\n\n\tlet lastEnd = 0;\n\n\tfor (const [START, END] of ranges) {\n\t\tSEGMENTS.push(input.slice(lastEnd, START));\n\t\tlastEnd = END;\n\t}\n\n\tSEGMENTS.push(input.slice(lastEnd));\n\n\treturn SEGMENTS.join('');\n}\n\n/**\n * Removes all occurrences of the specified attributes from the provided markup string.\n *\n * This function finds every instance of the given attribute names within the input markup (using\n * {@link findAttributeRanges}), then removes them, returning the markup with those attributes omitted.\n *\n * @param input - The original markup string from which attributes should be removed.\n * @param attributes - An array of attribute names to remove from the markup.\n *\n * @returns A new string representing the markup with the specified attributes removed.\n *\n * @see findAttributeRanges\n */\nfunction removeAttributes(input: string, attributes: string[]): string {\n\treturn removeRanges(input, findAttributeRanges(input, attributes));\n}\n\nexport type { Range };\nexport {\n\tcleanIgnoredPath,\n\tcleanIgnoredPaths,\n\tDEFAULT_IGNORE_PATHS,\n\tescapeRegExp,\n\tfindAttributeRanges,\n\tfindExpressionEnd,\n\tgetIgnoredPaths,\n\tgetOptions,\n\thasExtension,\n\thasIgnorePath,\n\tremoveAttributes,\n\tremoveRanges,\n\tstripQuery,\n\ttoRelativePath,\n};\n","import type { Plugin } from 'vite';\nimport type { Options } from './types';\n\nimport { generateRemovalSourceMap } from './sourcemap';\nimport {\n\tfindAttributeRanges,\n\tgetIgnoredPaths,\n\tgetOptions,\n\thasExtension,\n\thasIgnorePath,\n\tremoveRanges,\n\tstripQuery,\n\ttoRelativePath,\n} from './utilities';\n\nexport type { Options } from './types';\n\n/**\n * Vite plugin to remove specified attributes from markup files.\n *\n * This plugin scans files with configured extensions and removes\n * attributes as defined in the option list. It also produces\n * accurate source maps to ensure the original line and column numbers\n * are preserved for consumers of the Vite build chain.\n *\n * Files can be ignored based on path token matching. Ignore patterns\n * are resolved relative to the Vite root.\n *\n * @param options - Plugin configuration including which attributes\n *   and file extensions to target, and optional ignore paths.\n *\n * @returns A Vite plugin object that removes attributes during\n *   transformation steps.\n */\nfunction removeAttributesPlugin(options: Options): Plugin {\n\tconst OPTIONS = getOptions(options);\n\tconst IGNORED_PATHS = getIgnoredPaths(OPTIONS);\n\n\t// Ignore tokens are matched against paths relative to the Vite root, not to the process working directory\n\tlet root = process.cwd();\n\n\treturn {\n\t\tname: 'remove-attributes',\n\t\tenforce: 'pre',\n\t\tconfigResolved(config) {\n\t\t\troot = config.root;\n\t\t},\n\t\ttransform(code, id) {\n\t\t\t// Virtual modules (`\\0…`) never carry markup\n\t\t\tif (\n\t\t\t\tid.startsWith('\\0') ||\n\t\t\t\t!hasExtension(id, OPTIONS.extensions) ||\n\t\t\t\thasIgnorePath(toRelativePath(id, root), IGNORED_PATHS)\n\t\t\t) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\tconst RANGES = findAttributeRanges(code, OPTIONS.attributes);\n\n\t\t\tif (RANGES.length === 0) {\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\t// A removal shifts every later column (and every later line when the attribute sat on its own line), so the\n\t\t\t// map keeps the consumer's sourcemaps pointing at the original positions\n\t\t\treturn { code: removeRanges(code, RANGES), map: generateRemovalSourceMap(code, RANGES, stripQuery(id)) };\n\t\t},\n\t};\n}\n\nexport default removeAttributesPlugin;\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,7 @@
+import type { Plugin } from 'vite';
+import type { Options as PluginOptions } from './types.cjs';
+declare function removeAttributesPlugin(options: PluginOptions): Plugin;
+declare namespace removeAttributesPlugin {
+	export type Options = PluginOptions;
+}
+export = removeAttributesPlugin;

package/dist/index.d.ts

@@ -1,4 +1,22 @@
-import type { Plugin } from 'vite';
-import type { Options } from './types';
-export default function removeAttributesPlugin(options: Options): Plugin;
-//# sourceMappingURL=index.d.ts.map
+import { Plugin } from 'vite';
+import { Options } from './types.js';
+export type { Options } from './types.js';
+/**
+ * Vite plugin to remove specified attributes from markup files.
+ *
+ * This plugin scans files with configured extensions and removes
+ * attributes as defined in the option list. It also produces
+ * accurate source maps to ensure the original line and column numbers
+ * are preserved for consumers of the Vite build chain.
+ *
+ * Files can be ignored based on path token matching. Ignore patterns
+ * are resolved relative to the Vite root.
+ *
+ * @param options - Plugin configuration including which attributes
+ *   and file extensions to target, and optional ignore paths.
+ *
+ * @returns A Vite plugin object that removes attributes during
+ *   transformation steps.
+ */
+declare function removeAttributesPlugin(options: Options): Plugin;
+export default removeAttributesPlugin;