eslint-plugin-intlayer 9.7.2 → 9.8.0-canary.0

package/README.md

@@ -184,8 +184,14 @@ Reports user-facing strings that are not declared in a dictionary.
 
 The predicate is `shouldExtract` from `@intlayer/config/extract` — the very same
 heuristic `intlayer extract` uses — so what this rule reports is exactly what the
-extractor would rewrite. Brand names, CSS class strings, technical identifiers
-and code-shaped strings are filtered out.
+extractor would rewrite. CSS class strings, technical identifiers and
+code-shaped strings are filtered out.
+
+Proper nouns and brand names cannot be told apart from labels, so they are
+skipped with the compiler's comment directives, which this rule honors too:
+`// intlayer-ignore-line`, `// intlayer-ignore-next-line` (or
+`{/* intlayer-ignore-next-line */}` / `<!-- intlayer-ignore-next-line -->` above
+an element) and `// intlayer-ignore-file`.
 
 ```jsx
 // ✗

package/dist/cjs/@intlayer/config/dist/esm/extract/ignoreDirectives.cjs

@@ -0,0 +1,60 @@
+// ../@intlayer/config/dist/esm/extract/ignoreDirectives.mjs
+/**
+* A directive only counts when it opens a comment (`//`, `/*`, `{/*` or
+* `<!--`), so the same words inside a translatable string are not mistaken
+* for one.
+*/
+const DIRECTIVE_REGEX = /(?:\/\/|\/\*|<!--)\s*(intlayer-ignore-(?:file|next-line|line))\b/g;
+/** Offsets at which each line of the source starts (index 0 = line 1). */
+const getLineStartOffsets = (source) => {
+	const lineStartOffsets = [0];
+	for (let index = 0; index < source.length; index++) if (source[index] === "\n") lineStartOffsets.push(index + 1);
+	return lineStartOffsets;
+};
+/** Zero-based line index of a character offset, by binary search. */
+const getLineIndex = (lineStartOffsets, offset) => {
+	let low = 0;
+	let high = lineStartOffsets.length - 1;
+	while (low < high) {
+		const middle = Math.ceil((low + high) / 2);
+		if ((lineStartOffsets[middle] ?? 0) <= offset) low = middle;
+		else high = middle - 1;
+	}
+	return low;
+};
+/**
+* Reads the extraction ignore directives of a source file:
+*
+* - `// intlayer-ignore-file` anywhere in the file skips the whole file
+* - `// intlayer-ignore-next-line` skips the strings of the following line
+* - `// intlayer-ignore-line` skips the strings of its own line
+*
+* Works for JS/TS (`//`, `/* *\/`), JSX (`{/* *\/}`) and Vue / Svelte
+* templates (`<!-- -->`).
+*/
+const getExtractionIgnoreDirectives = (source) => {
+	const ignoredLineIndexes = /* @__PURE__ */ new Set();
+	let isFileIgnored = false;
+	let lineStartOffsets;
+	for (const match of source.matchAll(DIRECTIVE_REGEX)) {
+		const directive = match[1];
+		if (directive === "intlayer-ignore-file") {
+			isFileIgnored = true;
+			continue;
+		}
+		lineStartOffsets ??= getLineStartOffsets(source);
+		const lineIndex = getLineIndex(lineStartOffsets, match.index);
+		ignoredLineIndexes.add(directive === "intlayer-ignore-next-line" ? lineIndex + 1 : lineIndex);
+	}
+	const isOffsetIgnored = (offset) => {
+		if (!lineStartOffsets || typeof offset !== "number") return false;
+		return ignoredLineIndexes.has(getLineIndex(lineStartOffsets, offset));
+	};
+	return {
+		isFileIgnored,
+		isOffsetIgnored
+	};
+};
+
+exports.getExtractionIgnoreDirectives = getExtractionIgnoreDirectives;
+//# sourceMappingURL=ignoreDirectives.cjs.map

package/dist/cjs/@intlayer/config/dist/esm/extract/ignoreDirectives.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignoreDirectives.cjs","names":[],"sources":["../../../../../../../../@intlayer/config/dist/esm/extract/ignoreDirectives.mjs"],"sourcesContent":["// src/extract/ignoreDirectives.ts\n/** Comment directive that keeps a whole file out of extraction. */\nconst IGNORE_FILE_DIRECTIVE = \"intlayer-ignore-file\";\n/** Comment directive that keeps the following line out of extraction. */\nconst IGNORE_NEXT_LINE_DIRECTIVE = \"intlayer-ignore-next-line\";\n/** Comment directive that keeps its own line out of extraction. */\nconst IGNORE_LINE_DIRECTIVE = \"intlayer-ignore-line\";\n/**\n* A directive only counts when it opens a comment (`//`, `/*`, `{/*` or\n* `<!--`), so the same words inside a translatable string are not mistaken\n* for one.\n*/\nconst DIRECTIVE_REGEX = /(?:\\/\\/|\\/\\*|<!--)\\s*(intlayer-ignore-(?:file|next-line|line))\\b/g;\n/** Offsets at which each line of the source starts (index 0 = line 1). */\nconst getLineStartOffsets = (source) => {\n\tconst lineStartOffsets = [0];\n\tfor (let index = 0; index < source.length; index++) if (source[index] === \"\\n\") lineStartOffsets.push(index + 1);\n\treturn lineStartOffsets;\n};\n/** Zero-based line index of a character offset, by binary search. */\nconst getLineIndex = (lineStartOffsets, offset) => {\n\tlet low = 0;\n\tlet high = lineStartOffsets.length - 1;\n\twhile (low < high) {\n\t\tconst middle = Math.ceil((low + high) / 2);\n\t\tif ((lineStartOffsets[middle] ?? 0) <= offset) low = middle;\n\t\telse high = middle - 1;\n\t}\n\treturn low;\n};\n/**\n* Reads the extraction ignore directives of a source file:\n*\n* - `// intlayer-ignore-file` anywhere in the file skips the whole file\n* - `// intlayer-ignore-next-line` skips the strings of the following line\n* - `// intlayer-ignore-line` skips the strings of its own line\n*\n* Works for JS/TS (`//`, `/* *\\/`), JSX (`{/* *\\/}`) and Vue / Svelte\n* templates (`<!-- -->`).\n*/\nconst getExtractionIgnoreDirectives = (source) => {\n\tconst ignoredLineIndexes = /* @__PURE__ */ new Set();\n\tlet isFileIgnored = false;\n\tlet lineStartOffsets;\n\tfor (const match of source.matchAll(DIRECTIVE_REGEX)) {\n\t\tconst directive = match[1];\n\t\tif (directive === \"intlayer-ignore-file\") {\n\t\t\tisFileIgnored = true;\n\t\t\tcontinue;\n\t\t}\n\t\tlineStartOffsets ??= getLineStartOffsets(source);\n\t\tconst lineIndex = getLineIndex(lineStartOffsets, match.index);\n\t\tignoredLineIndexes.add(directive === \"intlayer-ignore-next-line\" ? lineIndex + 1 : lineIndex);\n\t}\n\tconst isOffsetIgnored = (offset) => {\n\t\tif (!lineStartOffsets || typeof offset !== \"number\") return false;\n\t\treturn ignoredLineIndexes.has(getLineIndex(lineStartOffsets, offset));\n\t};\n\treturn {\n\t\tisFileIgnored,\n\t\tisOffsetIgnored\n\t};\n};\n\nexport { IGNORE_FILE_DIRECTIVE, IGNORE_LINE_DIRECTIVE, IGNORE_NEXT_LINE_DIRECTIVE, getExtractionIgnoreDirectives };\n//# sourceMappingURL=ignoreDirectives.mjs.map"],"mappings":";;;;;;AAYA,MAAM,kBAAkB;;AAExB,MAAM,uBAAuB,WAAW;CACvC,MAAM,mBAAmB,CAAC,CAAC;CAC3B,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS,IAAI,OAAO,WAAW,MAAM,iBAAiB,KAAK,QAAQ,CAAC;CAC/G,OAAO;AACR;;AAEA,MAAM,gBAAgB,kBAAkB,WAAW;CAClD,IAAI,MAAM;CACV,IAAI,OAAO,iBAAiB,SAAS;CACrC,OAAO,MAAM,MAAM;EAClB,MAAM,SAAS,KAAK,MAAM,MAAM,QAAQ,CAAC;EACzC,KAAK,iBAAiB,WAAW,MAAM,QAAQ,MAAM;OAChD,OAAO,SAAS;CACtB;CACA,OAAO;AACR;;;;;;;;;;;AAWA,MAAM,iCAAiC,WAAW;CACjD,MAAM,qCAAqC,IAAI,IAAI;CACnD,IAAI,gBAAgB;CACpB,IAAI;CACJ,KAAK,MAAM,SAAS,OAAO,SAAS,eAAe,GAAG;EACrD,MAAM,YAAY,MAAM;EACxB,IAAI,cAAc,wBAAwB;GACzC,gBAAgB;GAChB;EACD;EACA,qBAAqB,oBAAoB,MAAM;EAC/C,MAAM,YAAY,aAAa,kBAAkB,MAAM,KAAK;EAC5D,mBAAmB,IAAI,cAAc,8BAA8B,YAAY,IAAI,SAAS;CAC7F;CACA,MAAM,mBAAmB,WAAW;EACnC,IAAI,CAAC,oBAAoB,OAAO,WAAW,UAAU,OAAO;EAC5D,OAAO,mBAAmB,IAAI,aAAa,kBAAkB,MAAM,CAAC;CACrE;CACA,OAAO;EACN;EACA;CACD;AACD"}

package/dist/cjs/@intlayer/config/dist/esm/extract/shouldExtract.cjs

@@ -2,10 +2,12 @@
 /**
 * Checks whether the given text should be extracted as a translatable string.
 *
+* Proper nouns and brand names cannot be told apart from labels here; exclude
+* them with the comment directives read by `getExtractionIgnoreDirectives`.
+*
 * Filters out:
 * - Empty strings
 * - Emails
-* - Single capitalized words (likely brand/proper nouns, e.g. "Intlayer")
 * - Uncapitalized strings of 2 words or fewer (likely technical terms)
 * - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)
 */
@@ -23,7 +25,6 @@ const shouldExtract = (text) => {
 		if (tokens.every((token) => cssClassTokenRegex.test(token)) && tokens.some((token) => token.includes("-"))) return false;
 	}
 	const isCapitalized = /^['"([]*\p{Lu}/u.test(trimmed);
-	if (wordCount === 1 && isCapitalized) return false;
 	if (wordCount === 1) {
 		if (/[a-z]\p{Lu}/u.test(trimmed)) return false;
 		if (trimmed.includes("-") || trimmed.includes("_")) return false;

package/dist/cjs/@intlayer/config/dist/esm/extract/shouldExtract.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"shouldExtract.cjs","names":[],"sources":["../../../../../../../../@intlayer/config/dist/esm/extract/shouldExtract.mjs"],"sourcesContent":["// src/extract/shouldExtract.ts\n/**\n* Checks whether the given text should be extracted as a translatable string.\n*\n* Filters out:\n* - Empty strings\n* - Emails\n* - Single capitalized words (likely brand/proper nouns, e.g. \"Intlayer\")\n* - Uncapitalized strings of 2 words or fewer (likely technical terms)\n* - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)\n*/\nconst shouldExtract = (text) => {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return false;\n\tif (/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(trimmed)) return false;\n\tif (trimmed.startsWith(\"{\") && !trimmed.startsWith(\"{{\") || trimmed.startsWith(\"v-\")) return false;\n\tif (trimmed.includes(\"=>\") || trimmed.includes(\");\") || trimmed.includes(\"(){\") || trimmed.includes(\"==\") || trimmed.includes(\"window.\") || trimmed.startsWith(\"(function\") || trimmed.startsWith(\"function(\")) return false;\n\tif ((trimmed.match(/[^\\p{L}\\p{N}\\s.,!?;:'\"()[\\]{}–—/«»„“\\p{Sc}%&*+#@^_+=<>/~]/gu) || []).length > 5) return false;\n\tconst wordCount = trimmed.split(/\\s+/).length;\n\tconst cssClassTokenRegex = /^!?([a-z][a-z0-9-]*:)*[a-z][a-z0-9]*(-[a-z0-9[\\].,%#/]+)*(\\/[a-z0-9]+)?$/;\n\tif (wordCount > 1) {\n\t\tconst tokens = trimmed.split(/\\s+/);\n\t\tif (tokens.every((token) => cssClassTokenRegex.test(token)) && tokens.some((token) => token.includes(\"-\"))) return false;\n\t}\n\tconst isCapitalized = /^['\"([]*\\p{Lu}/u.test(trimmed);\n\tif (wordCount === 1 && isCapitalized) return false;\n\tif (wordCount === 1) {\n\t\tif (/[a-z]\\p{Lu}/u.test(trimmed)) return false;\n\t\tif (trimmed.includes(\"-\") || trimmed.includes(\"_\")) return false;\n\t}\n\tif (!isCapitalized && wordCount <= 2) return false;\n\treturn true;\n};\n\nexport { shouldExtract };\n//# sourceMappingURL=shouldExtract.mjs.map"],"mappings":";;;;;;;;;;;AAWA,MAAM,iBAAiB,SAAS;CAC/B,MAAM,UAAU,KAAK,KAAK;CAC1B,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,6BAA6B,KAAK,OAAO,GAAG,OAAO;CACvD,IAAI,QAAQ,WAAW,GAAG,KAAK,CAAC,QAAQ,WAAW,IAAI,KAAK,QAAQ,WAAW,IAAI,GAAG,OAAO;CAC7F,IAAI,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,KAAK,KAAK,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,SAAS,KAAK,QAAQ,WAAW,WAAW,KAAK,QAAQ,WAAW,WAAW,GAAG,OAAO;CACvN,KAAK,QAAQ,MAAM,6DAA6D,KAAK,CAAC,EAAC,CAAE,SAAS,GAAG,OAAO;CAC5G,MAAM,YAAY,QAAQ,MAAM,KAAK,CAAC,CAAC;CACvC,MAAM,qBAAqB;CAC3B,IAAI,YAAY,GAAG;EAClB,MAAM,SAAS,QAAQ,MAAM,KAAK;EAClC,IAAI,OAAO,OAAO,UAAU,mBAAmB,KAAK,KAAK,CAAC,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO;CACpH;CACA,MAAM,gBAAgB,kBAAkB,KAAK,OAAO;CACpD,IAAI,cAAc,KAAK,eAAe,OAAO;CAC7C,IAAI,cAAc,GAAG;EACpB,IAAI,eAAe,KAAK,OAAO,GAAG,OAAO;EACzC,IAAI,QAAQ,SAAS,GAAG,KAAK,QAAQ,SAAS,GAAG,GAAG,OAAO;CAC5D;CACA,IAAI,CAAC,iBAAiB,aAAa,GAAG,OAAO;CAC7C,OAAO;AACR"}
+{"version":3,"file":"shouldExtract.cjs","names":[],"sources":["../../../../../../../../@intlayer/config/dist/esm/extract/shouldExtract.mjs"],"sourcesContent":["// src/extract/shouldExtract.ts\n/**\n* Checks whether the given text should be extracted as a translatable string.\n*\n* Proper nouns and brand names cannot be told apart from labels here; exclude\n* them with the comment directives read by `getExtractionIgnoreDirectives`.\n*\n* Filters out:\n* - Empty strings\n* - Emails\n* - Uncapitalized strings of 2 words or fewer (likely technical terms)\n* - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)\n*/\nconst shouldExtract = (text) => {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return false;\n\tif (/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(trimmed)) return false;\n\tif (trimmed.startsWith(\"{\") && !trimmed.startsWith(\"{{\") || trimmed.startsWith(\"v-\")) return false;\n\tif (trimmed.includes(\"=>\") || trimmed.includes(\");\") || trimmed.includes(\"(){\") || trimmed.includes(\"==\") || trimmed.includes(\"window.\") || trimmed.startsWith(\"(function\") || trimmed.startsWith(\"function(\")) return false;\n\tif ((trimmed.match(/[^\\p{L}\\p{N}\\s.,!?;:'\"()[\\]{}–—/«»„“\\p{Sc}%&*+#@^_+=<>/~]/gu) || []).length > 5) return false;\n\tconst wordCount = trimmed.split(/\\s+/).length;\n\tconst cssClassTokenRegex = /^!?([a-z][a-z0-9-]*:)*[a-z][a-z0-9]*(-[a-z0-9[\\].,%#/]+)*(\\/[a-z0-9]+)?$/;\n\tif (wordCount > 1) {\n\t\tconst tokens = trimmed.split(/\\s+/);\n\t\tif (tokens.every((token) => cssClassTokenRegex.test(token)) && tokens.some((token) => token.includes(\"-\"))) return false;\n\t}\n\tconst isCapitalized = /^['\"([]*\\p{Lu}/u.test(trimmed);\n\tif (wordCount === 1) {\n\t\tif (/[a-z]\\p{Lu}/u.test(trimmed)) return false;\n\t\tif (trimmed.includes(\"-\") || trimmed.includes(\"_\")) return false;\n\t}\n\tif (!isCapitalized && wordCount <= 2) return false;\n\treturn true;\n};\n\nexport { shouldExtract };\n//# sourceMappingURL=shouldExtract.mjs.map"],"mappings":";;;;;;;;;;;;;AAaA,MAAM,iBAAiB,SAAS;CAC/B,MAAM,UAAU,KAAK,KAAK;CAC1B,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,6BAA6B,KAAK,OAAO,GAAG,OAAO;CACvD,IAAI,QAAQ,WAAW,GAAG,KAAK,CAAC,QAAQ,WAAW,IAAI,KAAK,QAAQ,WAAW,IAAI,GAAG,OAAO;CAC7F,IAAI,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,KAAK,KAAK,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,SAAS,KAAK,QAAQ,WAAW,WAAW,KAAK,QAAQ,WAAW,WAAW,GAAG,OAAO;CACvN,KAAK,QAAQ,MAAM,6DAA6D,KAAK,CAAC,EAAC,CAAE,SAAS,GAAG,OAAO;CAC5G,MAAM,YAAY,QAAQ,MAAM,KAAK,CAAC,CAAC;CACvC,MAAM,qBAAqB;CAC3B,IAAI,YAAY,GAAG;EAClB,MAAM,SAAS,QAAQ,MAAM,KAAK;EAClC,IAAI,OAAO,OAAO,UAAU,mBAAmB,KAAK,KAAK,CAAC,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO;CACpH;CACA,MAAM,gBAAgB,kBAAkB,KAAK,OAAO;CACpD,IAAI,cAAc,GAAG;EACpB,IAAI,eAAe,KAAK,OAAO,GAAG,OAAO;EACzC,IAAI,QAAQ,SAAS,GAAG,KAAK,QAAQ,SAAS,GAAG,GAAG,OAAO;CAC5D;CACA,IAAI,CAAC,iBAAiB,aAAa,GAAG,OAAO;CAC7C,OAAO;AACR"}

package/dist/cjs/rules/noRawText.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_constants = require("../@intlayer/config/dist/esm/extract/constants.cjs");
+const require_ignoreDirectives = require("../@intlayer/config/dist/esm/extract/ignoreDirectives.cjs");
 const require_shouldExtract = require("../@intlayer/config/dist/esm/extract/shouldExtract.cjs");
 const require_utils_ast = require("../utils/ast.cjs");
 const require_utils_createRule = require("../utils/createRule.cjs");
@@ -28,6 +29,22 @@ const isContentDeclarationFile = (filename) => _intlayer_config_defaultValues.FI
 *
 * @param node - The reported node.
 */
+/** Start offset of an ESLint node (`range[0]`), when it has one. */
+const getNodeStart = (node) => {
+	const range = node?.["range"];
+	return Array.isArray(range) && typeof range[0] === "number" ? range[0] : void 0;
+};
+/**
+* Start offset of the element a text, `{'literal'}` child or attribute
+* belongs to (JSX, Vue and Svelte trees alike).
+*/
+const getEnclosingElementStart = (node) => {
+	let current = node.parent;
+	if (current?.type === "JSXExpressionContainer") current = current.parent;
+	if (current?.type === "JSXAttribute") current = current.parent;
+	if (current?.type === "JSXOpeningElement") current = current.parent;
+	return getNodeStart(current);
+};
 const getEnclosingElementName = (node) => {
 	let current = node;
 	while (current) {
@@ -93,6 +110,20 @@ const noRawText = require_utils_createRule.createRule("no-raw-text", {
 	create: (context) => {
 		const filename = context.filename;
 		if (isContentDeclarationFile(filename)) return {};
+		const sourceText = context.sourceCode.text;
+		const ignoreDirectives = require_ignoreDirectives.getExtractionIgnoreDirectives(sourceText);
+		if (ignoreDirectives.isFileIgnored) return {};
+		/**
+		* Whether an `intlayer-ignore-line` / `intlayer-ignore-next-line`
+		* directive covers the node: on the line where its text starts, or on
+		* the opening tag of its element.
+		*/
+		const isIgnoredNode = (node) => {
+			const astNode = require_utils_ast.toAstNode(node);
+			let textStart = getNodeStart(astNode);
+			if (textStart !== void 0) while (/\s/u.test(sourceText[textStart] ?? "")) textStart++;
+			return ignoreDirectives.isOffsetIgnored(textStart) || ignoreDirectives.isOffsetIgnored(getEnclosingElementStart(astNode));
+		};
 		const [options = {}] = context.options;
 		const attributes = new Set(options.attributes ?? require_constants.ATTRIBUTES_TO_EXTRACT);
 		const ignoredElements = new Set(options.ignoreElements ?? DEFAULT_IGNORED_ELEMENTS);
@@ -115,6 +146,7 @@ const noRawText = require_utils_createRule.createRule("no-raw-text", {
 			if (elementName && ignoredElements.has(elementName)) return;
 			if (attributeName !== null && !attributes.has(attributeName)) return;
 			if (!isReportableText(text)) return;
+			if (isIgnoredNode(node)) return;
 			context.report({
 				node,
 				messageId: attributeName === null ? "rawText" : "rawAttribute",
@@ -131,6 +163,7 @@ const noRawText = require_utils_createRule.createRule("no-raw-text", {
 				if (!isReportableText(text)) return;
 				const elementName = getEnclosingElementName(astNode.parent);
 				if (elementName && ignoredElements.has(elementName)) return;
+				if (isIgnoredNode(node)) return;
 				context.report({
 					node,
 					messageId: "rawText",
@@ -146,6 +179,7 @@ const noRawText = require_utils_createRule.createRule("no-raw-text", {
 				if (text === null || !isReportableText(text)) return;
 				const elementName = getEnclosingElementName(astNode.parent);
 				if (elementName && ignoredElements.has(elementName)) return;
+				if (isIgnoredNode(node)) return;
 				context.report({
 					node,
 					messageId: "rawAttribute",
@@ -162,6 +196,7 @@ const noRawText = require_utils_createRule.createRule("no-raw-text", {
 				if (isStructuralPosition(astNode)) return;
 				const text = astNode["value"];
 				if (!isReportableText(text)) return;
+				if (isIgnoredNode(node)) return;
 				context.report({
 					node,
 					messageId: "rawStringLiteral",

package/dist/cjs/rules/noRawText.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"noRawText.cjs","names":["FILE_EXTENSIONS","getJsxElementName","createRule","ATTRIBUTES_TO_EXTRACT","shouldExtract","createTemplateVisitor","combineVisitors","toAstNode","getJsxAttributeName","getJsxAttributeValueNode","getStaticStringValue"],"sources":["../../../src/rules/noRawText.ts"],"sourcesContent":["import { FILE_EXTENSIONS } from '@intlayer/config/defaultValues';\nimport { ATTRIBUTES_TO_EXTRACT, shouldExtract } from '@intlayer/config/extract';\nimport {\n  type AstNode,\n  type AstNodeWithParent,\n  getJsxAttributeName,\n  getJsxAttributeValueNode,\n  getJsxElementName,\n  getStaticStringValue,\n  toAstNode,\n} from '../utils/ast';\nimport { createRule } from '../utils/createRule';\nimport {\n  combineVisitors,\n  createTemplateVisitor,\n  type TemplateVisitor,\n} from '../utils/templates';\n\n/**\n * Elements whose text is markup, code or metadata rather than user-facing copy.\n * Extracting them would be wrong, so they are skipped by default.\n */\nconst DEFAULT_IGNORED_ELEMENTS = ['code', 'pre', 'script', 'style'];\n\nexport type NoRawTextOptions = {\n  /**\n   * JSX attributes whose string value is user-facing copy.\n   * Defaults to the compiler's own list, so the linter flags exactly what\n   * `intlayer extract` would rewrite.\n   */\n  attributes?: string[];\n  /** JSX elements whose children are never translatable. */\n  ignoreElements?: string[];\n  /** Regular-expression sources for text that should never be reported. */\n  ignorePatterns?: string[];\n  /**\n   * Also report string literals outside JSX (function arguments, object values,\n   * …). Off by default: outside JSX the false-positive rate is much higher, and\n   * the compiler's own extractor is the better first pass.\n   */\n  includeStringLiterals?: boolean;\n};\n\ntype MessageIds = 'rawText' | 'rawAttribute' | 'rawStringLiteral';\n\n/**\n * True for a content declaration file, where raw strings are the whole point.\n *\n * @param filename - Absolute path of the linted file.\n */\nconst isContentDeclarationFile = (filename: string): boolean =>\n  FILE_EXTENSIONS.some((extension) => filename.endsWith(extension));\n\n/**\n * Walk up from a JSX child or attribute to the tag name that encloses it.\n *\n * @param node - The reported node.\n */\nconst getEnclosingElementName = (\n  node: AstNodeWithParent | undefined\n): string | null => {\n  let current = node;\n\n  while (current) {\n    if (current.type === 'JSXElement') {\n      return getJsxElementName(current['openingElement'] as AstNode);\n    }\n\n    if (current.type === 'JSXOpeningElement') {\n      return getJsxElementName(current);\n    }\n\n    current = current.parent;\n  }\n\n  return null;\n};\n\n/**\n * True when the string literal sits in a position that is structural rather\n * than user-facing: module specifiers, property keys, directives, and the\n * arguments of the Intlayer getters themselves.\n *\n * @param node - The Literal node.\n */\nconst isStructuralPosition = (node: AstNodeWithParent): boolean => {\n  const parent = node.parent;\n\n  if (!parent) return true;\n\n  switch (parent.type) {\n    case 'ImportDeclaration':\n    case 'ImportExpression':\n    case 'ExportNamedDeclaration':\n    case 'ExportAllDeclaration':\n    case 'JSXAttribute':\n    case 'TSLiteralType':\n    case 'TSEnumMember':\n    case 'ExpressionStatement':\n      return true;\n\n    case 'Property':\n      // Keys are structural; values are not.\n      return parent['key'] === node && parent['computed'] !== true;\n\n    case 'MemberExpression':\n      return parent['property'] === node;\n\n    default:\n      return false;\n  }\n};\n\nexport const noRawText = createRule<[NoRawTextOptions?], MessageIds>(\n  'no-raw-text',\n  {\n    meta: {\n      type: 'problem',\n      docs: {\n        description:\n          'Report user-facing strings that are not declared in an Intlayer dictionary',\n      },\n      messages: {\n        rawText:\n          'Untranslated text \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n        rawAttribute:\n          'Untranslated `{{attribute}}` value \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n        rawStringLiteral:\n          'Untranslated string \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n      },\n      schema: [\n        {\n          type: 'object',\n          properties: {\n            attributes: { type: 'array', items: { type: 'string' } },\n            ignoreElements: { type: 'array', items: { type: 'string' } },\n            ignorePatterns: { type: 'array', items: { type: 'string' } },\n            includeStringLiterals: { type: 'boolean' },\n          },\n          additionalProperties: false,\n        },\n      ],\n    },\n\n    create: (context) => {\n      const filename = context.filename;\n\n      // Content declaration files hold the translations themselves.\n      if (isContentDeclarationFile(filename)) return {};\n\n      const [options = {}] = context.options;\n      const attributes = new Set<string>(\n        options.attributes ?? ATTRIBUTES_TO_EXTRACT\n      );\n      const ignoredElements = new Set<string>(\n        options.ignoreElements ?? DEFAULT_IGNORED_ELEMENTS\n      );\n      const ignorePatterns = (options.ignorePatterns ?? []).map(\n        (pattern) => new RegExp(pattern, 'u')\n      );\n      const includeStringLiterals = options.includeStringLiterals === true;\n\n      /** True when the text is copy the extractor would pick up. */\n      const isReportableText = (text: string): boolean =>\n        shouldExtract(text) &&\n        !ignorePatterns.some((pattern) => pattern.test(text.trim()));\n\n      /** Collapse whitespace so multi-line JSX text reads well in the report. */\n      const formatText = (text: string): string => {\n        const normalized = text.replace(/\\s+/gu, ' ').trim();\n\n        return normalized.length > 40\n          ? `${normalized.slice(0, 40)}…`\n          : normalized;\n      };\n\n      /**\n       * Handlers for the markup languages that are not JSX — Vue, Svelte and\n       * Angular templates. Reports through the same predicate and options as\n       * the JSX path so a project gets identical results whatever it is written\n       * in.\n       */\n      const templateVisitor = createTemplateVisitor(\n        ({ node, text, attributeName, elementName }) => {\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          if (attributeName !== null && !attributes.has(attributeName)) return;\n\n          if (!isReportableText(text)) return;\n\n          context.report({\n            node: node as never,\n            messageId: attributeName === null ? 'rawText' : 'rawAttribute',\n            data: {\n              text: formatText(text),\n              ...(attributeName === null ? {} : { attribute: attributeName }),\n            },\n          });\n        }\n      );\n\n      const scriptVisitor: TemplateVisitor = {\n        JSXText: (node) => {\n          const astNode = toAstNode(node as never);\n          const text = astNode['value'] as string;\n\n          if (!isReportableText(text)) return;\n\n          const elementName = getEnclosingElementName(astNode.parent);\n\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawText',\n            data: { text: formatText(text) },\n          });\n        },\n\n        JSXAttribute: (node) => {\n          const astNode = toAstNode(node as never);\n          const attributeName = getJsxAttributeName(astNode);\n\n          if (!attributeName || !attributes.has(attributeName)) return;\n\n          const valueNode = getJsxAttributeValueNode(astNode);\n          const text = getStaticStringValue(valueNode);\n\n          if (text === null || !isReportableText(text)) return;\n\n          const elementName = getEnclosingElementName(astNode.parent);\n\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawAttribute',\n            data: { attribute: attributeName, text: formatText(text) },\n          });\n        },\n\n        Literal: (node) => {\n          if (!includeStringLiterals) return;\n\n          const astNode = toAstNode(node as never);\n\n          if (typeof astNode['value'] !== 'string') return;\n\n          if (isStructuralPosition(astNode)) return;\n\n          const text = astNode['value'] as string;\n\n          if (!isReportableText(text)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawStringLiteral',\n            data: { text: formatText(text) },\n          });\n        },\n      };\n\n      return combineVisitors(\n        context.sourceCode.parserServices,\n        scriptVisitor,\n        templateVisitor\n      );\n    },\n  }\n);\n"],"mappings":"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"}
+{"version":3,"file":"noRawText.cjs","names":["FILE_EXTENSIONS","getJsxElementName","createRule","getExtractionIgnoreDirectives","toAstNode","ATTRIBUTES_TO_EXTRACT","shouldExtract","createTemplateVisitor","combineVisitors","getJsxAttributeName","getJsxAttributeValueNode","getStaticStringValue"],"sources":["../../../src/rules/noRawText.ts"],"sourcesContent":["import { FILE_EXTENSIONS } from '@intlayer/config/defaultValues';\nimport {\n  ATTRIBUTES_TO_EXTRACT,\n  getExtractionIgnoreDirectives,\n  shouldExtract,\n} from '@intlayer/config/extract';\nimport {\n  type AstNode,\n  type AstNodeWithParent,\n  getJsxAttributeName,\n  getJsxAttributeValueNode,\n  getJsxElementName,\n  getStaticStringValue,\n  toAstNode,\n} from '../utils/ast';\nimport { createRule } from '../utils/createRule';\nimport {\n  combineVisitors,\n  createTemplateVisitor,\n  type TemplateVisitor,\n} from '../utils/templates';\n\n/**\n * Elements whose text is markup, code or metadata rather than user-facing copy.\n * Extracting them would be wrong, so they are skipped by default.\n */\nconst DEFAULT_IGNORED_ELEMENTS = ['code', 'pre', 'script', 'style'];\n\nexport type NoRawTextOptions = {\n  /**\n   * JSX attributes whose string value is user-facing copy.\n   * Defaults to the compiler's own list, so the linter flags exactly what\n   * `intlayer extract` would rewrite.\n   */\n  attributes?: string[];\n  /** JSX elements whose children are never translatable. */\n  ignoreElements?: string[];\n  /** Regular-expression sources for text that should never be reported. */\n  ignorePatterns?: string[];\n  /**\n   * Also report string literals outside JSX (function arguments, object values,\n   * …). Off by default: outside JSX the false-positive rate is much higher, and\n   * the compiler's own extractor is the better first pass.\n   */\n  includeStringLiterals?: boolean;\n};\n\ntype MessageIds = 'rawText' | 'rawAttribute' | 'rawStringLiteral';\n\n/**\n * True for a content declaration file, where raw strings are the whole point.\n *\n * @param filename - Absolute path of the linted file.\n */\nconst isContentDeclarationFile = (filename: string): boolean =>\n  FILE_EXTENSIONS.some((extension) => filename.endsWith(extension));\n\n/**\n * Walk up from a JSX child or attribute to the tag name that encloses it.\n *\n * @param node - The reported node.\n */\n/** Start offset of an ESLint node (`range[0]`), when it has one. */\nconst getNodeStart = (node: AstNode | undefined): number | undefined => {\n  const range = node?.['range'];\n\n  return Array.isArray(range) && typeof range[0] === 'number'\n    ? range[0]\n    : undefined;\n};\n\n/**\n * Start offset of the element a text, `{'literal'}` child or attribute\n * belongs to (JSX, Vue and Svelte trees alike).\n */\nconst getEnclosingElementStart = (\n  node: AstNodeWithParent\n): number | undefined => {\n  let current = node.parent;\n\n  if (current?.type === 'JSXExpressionContainer') current = current.parent;\n  if (current?.type === 'JSXAttribute') current = current.parent;\n  if (current?.type === 'JSXOpeningElement') current = current.parent;\n\n  return getNodeStart(current);\n};\n\nconst getEnclosingElementName = (\n  node: AstNodeWithParent | undefined\n): string | null => {\n  let current = node;\n\n  while (current) {\n    if (current.type === 'JSXElement') {\n      return getJsxElementName(current['openingElement'] as AstNode);\n    }\n\n    if (current.type === 'JSXOpeningElement') {\n      return getJsxElementName(current);\n    }\n\n    current = current.parent;\n  }\n\n  return null;\n};\n\n/**\n * True when the string literal sits in a position that is structural rather\n * than user-facing: module specifiers, property keys, directives, and the\n * arguments of the Intlayer getters themselves.\n *\n * @param node - The Literal node.\n */\nconst isStructuralPosition = (node: AstNodeWithParent): boolean => {\n  const parent = node.parent;\n\n  if (!parent) return true;\n\n  switch (parent.type) {\n    case 'ImportDeclaration':\n    case 'ImportExpression':\n    case 'ExportNamedDeclaration':\n    case 'ExportAllDeclaration':\n    case 'JSXAttribute':\n    case 'TSLiteralType':\n    case 'TSEnumMember':\n    case 'ExpressionStatement':\n      return true;\n\n    case 'Property':\n      // Keys are structural; values are not.\n      return parent['key'] === node && parent['computed'] !== true;\n\n    case 'MemberExpression':\n      return parent['property'] === node;\n\n    default:\n      return false;\n  }\n};\n\nexport const noRawText = createRule<[NoRawTextOptions?], MessageIds>(\n  'no-raw-text',\n  {\n    meta: {\n      type: 'problem',\n      docs: {\n        description:\n          'Report user-facing strings that are not declared in an Intlayer dictionary',\n      },\n      messages: {\n        rawText:\n          'Untranslated text \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n        rawAttribute:\n          'Untranslated `{{attribute}}` value \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n        rawStringLiteral:\n          'Untranslated string \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n      },\n      schema: [\n        {\n          type: 'object',\n          properties: {\n            attributes: { type: 'array', items: { type: 'string' } },\n            ignoreElements: { type: 'array', items: { type: 'string' } },\n            ignorePatterns: { type: 'array', items: { type: 'string' } },\n            includeStringLiterals: { type: 'boolean' },\n          },\n          additionalProperties: false,\n        },\n      ],\n    },\n\n    create: (context) => {\n      const filename = context.filename;\n\n      // Content declaration files hold the translations themselves.\n      if (isContentDeclarationFile(filename)) return {};\n\n      const sourceText = context.sourceCode.text;\n      const ignoreDirectives = getExtractionIgnoreDirectives(sourceText);\n\n      // Same comment directives as the compiler: what it skips is not reported.\n      if (ignoreDirectives.isFileIgnored) return {};\n\n      /**\n       * Whether an `intlayer-ignore-line` / `intlayer-ignore-next-line`\n       * directive covers the node: on the line where its text starts, or on\n       * the opening tag of its element.\n       */\n      const isIgnoredNode = (node: unknown): boolean => {\n        const astNode = toAstNode(node as never);\n        let textStart = getNodeStart(astNode);\n\n        if (textStart !== undefined) {\n          while (/\\s/u.test(sourceText[textStart] ?? '')) textStart++;\n        }\n\n        return (\n          ignoreDirectives.isOffsetIgnored(textStart) ||\n          ignoreDirectives.isOffsetIgnored(getEnclosingElementStart(astNode))\n        );\n      };\n\n      const [options = {}] = context.options;\n      const attributes = new Set<string>(\n        options.attributes ?? ATTRIBUTES_TO_EXTRACT\n      );\n      const ignoredElements = new Set<string>(\n        options.ignoreElements ?? DEFAULT_IGNORED_ELEMENTS\n      );\n      const ignorePatterns = (options.ignorePatterns ?? []).map(\n        (pattern) => new RegExp(pattern, 'u')\n      );\n      const includeStringLiterals = options.includeStringLiterals === true;\n\n      /** True when the text is copy the extractor would pick up. */\n      const isReportableText = (text: string): boolean =>\n        shouldExtract(text) &&\n        !ignorePatterns.some((pattern) => pattern.test(text.trim()));\n\n      /** Collapse whitespace so multi-line JSX text reads well in the report. */\n      const formatText = (text: string): string => {\n        const normalized = text.replace(/\\s+/gu, ' ').trim();\n\n        return normalized.length > 40\n          ? `${normalized.slice(0, 40)}…`\n          : normalized;\n      };\n\n      /**\n       * Handlers for the markup languages that are not JSX — Vue, Svelte and\n       * Angular templates. Reports through the same predicate and options as\n       * the JSX path so a project gets identical results whatever it is written\n       * in.\n       */\n      const templateVisitor = createTemplateVisitor(\n        ({ node, text, attributeName, elementName }) => {\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          if (attributeName !== null && !attributes.has(attributeName)) return;\n\n          if (!isReportableText(text)) return;\n\n          if (isIgnoredNode(node)) return;\n\n          context.report({\n            node: node as never,\n            messageId: attributeName === null ? 'rawText' : 'rawAttribute',\n            data: {\n              text: formatText(text),\n              ...(attributeName === null ? {} : { attribute: attributeName }),\n            },\n          });\n        }\n      );\n\n      const scriptVisitor: TemplateVisitor = {\n        JSXText: (node) => {\n          const astNode = toAstNode(node as never);\n          const text = astNode['value'] as string;\n\n          if (!isReportableText(text)) return;\n\n          const elementName = getEnclosingElementName(astNode.parent);\n\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          if (isIgnoredNode(node)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawText',\n            data: { text: formatText(text) },\n          });\n        },\n\n        JSXAttribute: (node) => {\n          const astNode = toAstNode(node as never);\n          const attributeName = getJsxAttributeName(astNode);\n\n          if (!attributeName || !attributes.has(attributeName)) return;\n\n          const valueNode = getJsxAttributeValueNode(astNode);\n          const text = getStaticStringValue(valueNode);\n\n          if (text === null || !isReportableText(text)) return;\n\n          const elementName = getEnclosingElementName(astNode.parent);\n\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          if (isIgnoredNode(node)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawAttribute',\n            data: { attribute: attributeName, text: formatText(text) },\n          });\n        },\n\n        Literal: (node) => {\n          if (!includeStringLiterals) return;\n\n          const astNode = toAstNode(node as never);\n\n          if (typeof astNode['value'] !== 'string') return;\n\n          if (isStructuralPosition(astNode)) return;\n\n          const text = astNode['value'] as string;\n\n          if (!isReportableText(text)) return;\n\n          if (isIgnoredNode(node)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawStringLiteral',\n            data: { text: formatText(text) },\n          });\n        },\n      };\n\n      return combineVisitors(\n        context.sourceCode.parserServices,\n        scriptVisitor,\n        templateVisitor\n      );\n    },\n  }\n);\n"],"mappings":"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"}

package/dist/esm/@intlayer/config/dist/esm/extract/ignoreDirectives.mjs

@@ -0,0 +1,60 @@
+// ../@intlayer/config/dist/esm/extract/ignoreDirectives.mjs
+/**
+* A directive only counts when it opens a comment (`//`, `/*`, `{/*` or
+* `<!--`), so the same words inside a translatable string are not mistaken
+* for one.
+*/
+const DIRECTIVE_REGEX = /(?:\/\/|\/\*|<!--)\s*(intlayer-ignore-(?:file|next-line|line))\b/g;
+/** Offsets at which each line of the source starts (index 0 = line 1). */
+const getLineStartOffsets = (source) => {
+	const lineStartOffsets = [0];
+	for (let index = 0; index < source.length; index++) if (source[index] === "\n") lineStartOffsets.push(index + 1);
+	return lineStartOffsets;
+};
+/** Zero-based line index of a character offset, by binary search. */
+const getLineIndex = (lineStartOffsets, offset) => {
+	let low = 0;
+	let high = lineStartOffsets.length - 1;
+	while (low < high) {
+		const middle = Math.ceil((low + high) / 2);
+		if ((lineStartOffsets[middle] ?? 0) <= offset) low = middle;
+		else high = middle - 1;
+	}
+	return low;
+};
+/**
+* Reads the extraction ignore directives of a source file:
+*
+* - `// intlayer-ignore-file` anywhere in the file skips the whole file
+* - `// intlayer-ignore-next-line` skips the strings of the following line
+* - `// intlayer-ignore-line` skips the strings of its own line
+*
+* Works for JS/TS (`//`, `/* *\/`), JSX (`{/* *\/}`) and Vue / Svelte
+* templates (`<!-- -->`).
+*/
+const getExtractionIgnoreDirectives = (source) => {
+	const ignoredLineIndexes = /* @__PURE__ */ new Set();
+	let isFileIgnored = false;
+	let lineStartOffsets;
+	for (const match of source.matchAll(DIRECTIVE_REGEX)) {
+		const directive = match[1];
+		if (directive === "intlayer-ignore-file") {
+			isFileIgnored = true;
+			continue;
+		}
+		lineStartOffsets ??= getLineStartOffsets(source);
+		const lineIndex = getLineIndex(lineStartOffsets, match.index);
+		ignoredLineIndexes.add(directive === "intlayer-ignore-next-line" ? lineIndex + 1 : lineIndex);
+	}
+	const isOffsetIgnored = (offset) => {
+		if (!lineStartOffsets || typeof offset !== "number") return false;
+		return ignoredLineIndexes.has(getLineIndex(lineStartOffsets, offset));
+	};
+	return {
+		isFileIgnored,
+		isOffsetIgnored
+	};
+};
+
+export { getExtractionIgnoreDirectives };
+//# sourceMappingURL=ignoreDirectives.mjs.map

package/dist/esm/@intlayer/config/dist/esm/extract/ignoreDirectives.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignoreDirectives.mjs","names":[],"sources":["../../../../../../../../@intlayer/config/dist/esm/extract/ignoreDirectives.mjs"],"sourcesContent":["// src/extract/ignoreDirectives.ts\n/** Comment directive that keeps a whole file out of extraction. */\nconst IGNORE_FILE_DIRECTIVE = \"intlayer-ignore-file\";\n/** Comment directive that keeps the following line out of extraction. */\nconst IGNORE_NEXT_LINE_DIRECTIVE = \"intlayer-ignore-next-line\";\n/** Comment directive that keeps its own line out of extraction. */\nconst IGNORE_LINE_DIRECTIVE = \"intlayer-ignore-line\";\n/**\n* A directive only counts when it opens a comment (`//`, `/*`, `{/*` or\n* `<!--`), so the same words inside a translatable string are not mistaken\n* for one.\n*/\nconst DIRECTIVE_REGEX = /(?:\\/\\/|\\/\\*|<!--)\\s*(intlayer-ignore-(?:file|next-line|line))\\b/g;\n/** Offsets at which each line of the source starts (index 0 = line 1). */\nconst getLineStartOffsets = (source) => {\n\tconst lineStartOffsets = [0];\n\tfor (let index = 0; index < source.length; index++) if (source[index] === \"\\n\") lineStartOffsets.push(index + 1);\n\treturn lineStartOffsets;\n};\n/** Zero-based line index of a character offset, by binary search. */\nconst getLineIndex = (lineStartOffsets, offset) => {\n\tlet low = 0;\n\tlet high = lineStartOffsets.length - 1;\n\twhile (low < high) {\n\t\tconst middle = Math.ceil((low + high) / 2);\n\t\tif ((lineStartOffsets[middle] ?? 0) <= offset) low = middle;\n\t\telse high = middle - 1;\n\t}\n\treturn low;\n};\n/**\n* Reads the extraction ignore directives of a source file:\n*\n* - `// intlayer-ignore-file` anywhere in the file skips the whole file\n* - `// intlayer-ignore-next-line` skips the strings of the following line\n* - `// intlayer-ignore-line` skips the strings of its own line\n*\n* Works for JS/TS (`//`, `/* *\\/`), JSX (`{/* *\\/}`) and Vue / Svelte\n* templates (`<!-- -->`).\n*/\nconst getExtractionIgnoreDirectives = (source) => {\n\tconst ignoredLineIndexes = /* @__PURE__ */ new Set();\n\tlet isFileIgnored = false;\n\tlet lineStartOffsets;\n\tfor (const match of source.matchAll(DIRECTIVE_REGEX)) {\n\t\tconst directive = match[1];\n\t\tif (directive === \"intlayer-ignore-file\") {\n\t\t\tisFileIgnored = true;\n\t\t\tcontinue;\n\t\t}\n\t\tlineStartOffsets ??= getLineStartOffsets(source);\n\t\tconst lineIndex = getLineIndex(lineStartOffsets, match.index);\n\t\tignoredLineIndexes.add(directive === \"intlayer-ignore-next-line\" ? lineIndex + 1 : lineIndex);\n\t}\n\tconst isOffsetIgnored = (offset) => {\n\t\tif (!lineStartOffsets || typeof offset !== \"number\") return false;\n\t\treturn ignoredLineIndexes.has(getLineIndex(lineStartOffsets, offset));\n\t};\n\treturn {\n\t\tisFileIgnored,\n\t\tisOffsetIgnored\n\t};\n};\n\nexport { IGNORE_FILE_DIRECTIVE, IGNORE_LINE_DIRECTIVE, IGNORE_NEXT_LINE_DIRECTIVE, getExtractionIgnoreDirectives };\n//# sourceMappingURL=ignoreDirectives.mjs.map"],"mappings":";;;;;;AAYA,MAAM,kBAAkB;;AAExB,MAAM,uBAAuB,WAAW;CACvC,MAAM,mBAAmB,CAAC,CAAC;CAC3B,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS,IAAI,OAAO,WAAW,MAAM,iBAAiB,KAAK,QAAQ,CAAC;CAC/G,OAAO;AACR;;AAEA,MAAM,gBAAgB,kBAAkB,WAAW;CAClD,IAAI,MAAM;CACV,IAAI,OAAO,iBAAiB,SAAS;CACrC,OAAO,MAAM,MAAM;EAClB,MAAM,SAAS,KAAK,MAAM,MAAM,QAAQ,CAAC;EACzC,KAAK,iBAAiB,WAAW,MAAM,QAAQ,MAAM;OAChD,OAAO,SAAS;CACtB;CACA,OAAO;AACR;;;;;;;;;;;AAWA,MAAM,iCAAiC,WAAW;CACjD,MAAM,qCAAqC,IAAI,IAAI;CACnD,IAAI,gBAAgB;CACpB,IAAI;CACJ,KAAK,MAAM,SAAS,OAAO,SAAS,eAAe,GAAG;EACrD,MAAM,YAAY,MAAM;EACxB,IAAI,cAAc,wBAAwB;GACzC,gBAAgB;GAChB;EACD;EACA,qBAAqB,oBAAoB,MAAM;EAC/C,MAAM,YAAY,aAAa,kBAAkB,MAAM,KAAK;EAC5D,mBAAmB,IAAI,cAAc,8BAA8B,YAAY,IAAI,SAAS;CAC7F;CACA,MAAM,mBAAmB,WAAW;EACnC,IAAI,CAAC,oBAAoB,OAAO,WAAW,UAAU,OAAO;EAC5D,OAAO,mBAAmB,IAAI,aAAa,kBAAkB,MAAM,CAAC;CACrE;CACA,OAAO;EACN;EACA;CACD;AACD"}

package/dist/esm/@intlayer/config/dist/esm/extract/shouldExtract.mjs

@@ -2,10 +2,12 @@
 /**
 * Checks whether the given text should be extracted as a translatable string.
 *
+* Proper nouns and brand names cannot be told apart from labels here; exclude
+* them with the comment directives read by `getExtractionIgnoreDirectives`.
+*
 * Filters out:
 * - Empty strings
 * - Emails
-* - Single capitalized words (likely brand/proper nouns, e.g. "Intlayer")
 * - Uncapitalized strings of 2 words or fewer (likely technical terms)
 * - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)
 */
@@ -23,7 +25,6 @@ const shouldExtract = (text) => {
 		if (tokens.every((token) => cssClassTokenRegex.test(token)) && tokens.some((token) => token.includes("-"))) return false;
 	}
 	const isCapitalized = /^['"([]*\p{Lu}/u.test(trimmed);
-	if (wordCount === 1 && isCapitalized) return false;
 	if (wordCount === 1) {
 		if (/[a-z]\p{Lu}/u.test(trimmed)) return false;
 		if (trimmed.includes("-") || trimmed.includes("_")) return false;

package/dist/esm/@intlayer/config/dist/esm/extract/shouldExtract.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"shouldExtract.mjs","names":[],"sources":["../../../../../../../../@intlayer/config/dist/esm/extract/shouldExtract.mjs"],"sourcesContent":["// src/extract/shouldExtract.ts\n/**\n* Checks whether the given text should be extracted as a translatable string.\n*\n* Filters out:\n* - Empty strings\n* - Emails\n* - Single capitalized words (likely brand/proper nouns, e.g. \"Intlayer\")\n* - Uncapitalized strings of 2 words or fewer (likely technical terms)\n* - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)\n*/\nconst shouldExtract = (text) => {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return false;\n\tif (/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(trimmed)) return false;\n\tif (trimmed.startsWith(\"{\") && !trimmed.startsWith(\"{{\") || trimmed.startsWith(\"v-\")) return false;\n\tif (trimmed.includes(\"=>\") || trimmed.includes(\");\") || trimmed.includes(\"(){\") || trimmed.includes(\"==\") || trimmed.includes(\"window.\") || trimmed.startsWith(\"(function\") || trimmed.startsWith(\"function(\")) return false;\n\tif ((trimmed.match(/[^\\p{L}\\p{N}\\s.,!?;:'\"()[\\]{}–—/«»„“\\p{Sc}%&*+#@^_+=<>/~]/gu) || []).length > 5) return false;\n\tconst wordCount = trimmed.split(/\\s+/).length;\n\tconst cssClassTokenRegex = /^!?([a-z][a-z0-9-]*:)*[a-z][a-z0-9]*(-[a-z0-9[\\].,%#/]+)*(\\/[a-z0-9]+)?$/;\n\tif (wordCount > 1) {\n\t\tconst tokens = trimmed.split(/\\s+/);\n\t\tif (tokens.every((token) => cssClassTokenRegex.test(token)) && tokens.some((token) => token.includes(\"-\"))) return false;\n\t}\n\tconst isCapitalized = /^['\"([]*\\p{Lu}/u.test(trimmed);\n\tif (wordCount === 1 && isCapitalized) return false;\n\tif (wordCount === 1) {\n\t\tif (/[a-z]\\p{Lu}/u.test(trimmed)) return false;\n\t\tif (trimmed.includes(\"-\") || trimmed.includes(\"_\")) return false;\n\t}\n\tif (!isCapitalized && wordCount <= 2) return false;\n\treturn true;\n};\n\nexport { shouldExtract };\n//# sourceMappingURL=shouldExtract.mjs.map"],"mappings":";;;;;;;;;;;AAWA,MAAM,iBAAiB,SAAS;CAC/B,MAAM,UAAU,KAAK,KAAK;CAC1B,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,6BAA6B,KAAK,OAAO,GAAG,OAAO;CACvD,IAAI,QAAQ,WAAW,GAAG,KAAK,CAAC,QAAQ,WAAW,IAAI,KAAK,QAAQ,WAAW,IAAI,GAAG,OAAO;CAC7F,IAAI,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,KAAK,KAAK,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,SAAS,KAAK,QAAQ,WAAW,WAAW,KAAK,QAAQ,WAAW,WAAW,GAAG,OAAO;CACvN,KAAK,QAAQ,MAAM,6DAA6D,KAAK,CAAC,EAAC,CAAE,SAAS,GAAG,OAAO;CAC5G,MAAM,YAAY,QAAQ,MAAM,KAAK,CAAC,CAAC;CACvC,MAAM,qBAAqB;CAC3B,IAAI,YAAY,GAAG;EAClB,MAAM,SAAS,QAAQ,MAAM,KAAK;EAClC,IAAI,OAAO,OAAO,UAAU,mBAAmB,KAAK,KAAK,CAAC,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO;CACpH;CACA,MAAM,gBAAgB,kBAAkB,KAAK,OAAO;CACpD,IAAI,cAAc,KAAK,eAAe,OAAO;CAC7C,IAAI,cAAc,GAAG;EACpB,IAAI,eAAe,KAAK,OAAO,GAAG,OAAO;EACzC,IAAI,QAAQ,SAAS,GAAG,KAAK,QAAQ,SAAS,GAAG,GAAG,OAAO;CAC5D;CACA,IAAI,CAAC,iBAAiB,aAAa,GAAG,OAAO;CAC7C,OAAO;AACR"}
+{"version":3,"file":"shouldExtract.mjs","names":[],"sources":["../../../../../../../../@intlayer/config/dist/esm/extract/shouldExtract.mjs"],"sourcesContent":["// src/extract/shouldExtract.ts\n/**\n* Checks whether the given text should be extracted as a translatable string.\n*\n* Proper nouns and brand names cannot be told apart from labels here; exclude\n* them with the comment directives read by `getExtractionIgnoreDirectives`.\n*\n* Filters out:\n* - Empty strings\n* - Emails\n* - Uncapitalized strings of 2 words or fewer (likely technical terms)\n* - Dynamic content patterns like Vue bindings (`v-`) or object patterns (`{`)\n*/\nconst shouldExtract = (text) => {\n\tconst trimmed = text.trim();\n\tif (!trimmed) return false;\n\tif (/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(trimmed)) return false;\n\tif (trimmed.startsWith(\"{\") && !trimmed.startsWith(\"{{\") || trimmed.startsWith(\"v-\")) return false;\n\tif (trimmed.includes(\"=>\") || trimmed.includes(\");\") || trimmed.includes(\"(){\") || trimmed.includes(\"==\") || trimmed.includes(\"window.\") || trimmed.startsWith(\"(function\") || trimmed.startsWith(\"function(\")) return false;\n\tif ((trimmed.match(/[^\\p{L}\\p{N}\\s.,!?;:'\"()[\\]{}–—/«»„“\\p{Sc}%&*+#@^_+=<>/~]/gu) || []).length > 5) return false;\n\tconst wordCount = trimmed.split(/\\s+/).length;\n\tconst cssClassTokenRegex = /^!?([a-z][a-z0-9-]*:)*[a-z][a-z0-9]*(-[a-z0-9[\\].,%#/]+)*(\\/[a-z0-9]+)?$/;\n\tif (wordCount > 1) {\n\t\tconst tokens = trimmed.split(/\\s+/);\n\t\tif (tokens.every((token) => cssClassTokenRegex.test(token)) && tokens.some((token) => token.includes(\"-\"))) return false;\n\t}\n\tconst isCapitalized = /^['\"([]*\\p{Lu}/u.test(trimmed);\n\tif (wordCount === 1) {\n\t\tif (/[a-z]\\p{Lu}/u.test(trimmed)) return false;\n\t\tif (trimmed.includes(\"-\") || trimmed.includes(\"_\")) return false;\n\t}\n\tif (!isCapitalized && wordCount <= 2) return false;\n\treturn true;\n};\n\nexport { shouldExtract };\n//# sourceMappingURL=shouldExtract.mjs.map"],"mappings":";;;;;;;;;;;;;AAaA,MAAM,iBAAiB,SAAS;CAC/B,MAAM,UAAU,KAAK,KAAK;CAC1B,IAAI,CAAC,SAAS,OAAO;CACrB,IAAI,6BAA6B,KAAK,OAAO,GAAG,OAAO;CACvD,IAAI,QAAQ,WAAW,GAAG,KAAK,CAAC,QAAQ,WAAW,IAAI,KAAK,QAAQ,WAAW,IAAI,GAAG,OAAO;CAC7F,IAAI,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,KAAK,KAAK,QAAQ,SAAS,IAAI,KAAK,QAAQ,SAAS,SAAS,KAAK,QAAQ,WAAW,WAAW,KAAK,QAAQ,WAAW,WAAW,GAAG,OAAO;CACvN,KAAK,QAAQ,MAAM,6DAA6D,KAAK,CAAC,EAAC,CAAE,SAAS,GAAG,OAAO;CAC5G,MAAM,YAAY,QAAQ,MAAM,KAAK,CAAC,CAAC;CACvC,MAAM,qBAAqB;CAC3B,IAAI,YAAY,GAAG;EAClB,MAAM,SAAS,QAAQ,MAAM,KAAK;EAClC,IAAI,OAAO,OAAO,UAAU,mBAAmB,KAAK,KAAK,CAAC,KAAK,OAAO,MAAM,UAAU,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO;CACpH;CACA,MAAM,gBAAgB,kBAAkB,KAAK,OAAO;CACpD,IAAI,cAAc,GAAG;EACpB,IAAI,eAAe,KAAK,OAAO,GAAG,OAAO;EACzC,IAAI,QAAQ,SAAS,GAAG,KAAK,QAAQ,SAAS,GAAG,GAAG,OAAO;CAC5D;CACA,IAAI,CAAC,iBAAiB,aAAa,GAAG,OAAO;CAC7C,OAAO;AACR"}

package/dist/esm/rules/noRawText.mjs

@@ -1,4 +1,5 @@
 import { ATTRIBUTES_TO_EXTRACT } from "../@intlayer/config/dist/esm/extract/constants.mjs";
+import { getExtractionIgnoreDirectives } from "../@intlayer/config/dist/esm/extract/ignoreDirectives.mjs";
 import { shouldExtract } from "../@intlayer/config/dist/esm/extract/shouldExtract.mjs";
 import { getJsxAttributeName, getJsxAttributeValueNode, getJsxElementName, getStaticStringValue, toAstNode } from "../utils/ast.mjs";
 import { createRule } from "../utils/createRule.mjs";
@@ -27,6 +28,22 @@ const isContentDeclarationFile = (filename) => FILE_EXTENSIONS.some((extension)
 *
 * @param node - The reported node.
 */
+/** Start offset of an ESLint node (`range[0]`), when it has one. */
+const getNodeStart = (node) => {
+	const range = node?.["range"];
+	return Array.isArray(range) && typeof range[0] === "number" ? range[0] : void 0;
+};
+/**
+* Start offset of the element a text, `{'literal'}` child or attribute
+* belongs to (JSX, Vue and Svelte trees alike).
+*/
+const getEnclosingElementStart = (node) => {
+	let current = node.parent;
+	if (current?.type === "JSXExpressionContainer") current = current.parent;
+	if (current?.type === "JSXAttribute") current = current.parent;
+	if (current?.type === "JSXOpeningElement") current = current.parent;
+	return getNodeStart(current);
+};
 const getEnclosingElementName = (node) => {
 	let current = node;
 	while (current) {
@@ -92,6 +109,20 @@ const noRawText = createRule("no-raw-text", {
 	create: (context) => {
 		const filename = context.filename;
 		if (isContentDeclarationFile(filename)) return {};
+		const sourceText = context.sourceCode.text;
+		const ignoreDirectives = getExtractionIgnoreDirectives(sourceText);
+		if (ignoreDirectives.isFileIgnored) return {};
+		/**
+		* Whether an `intlayer-ignore-line` / `intlayer-ignore-next-line`
+		* directive covers the node: on the line where its text starts, or on
+		* the opening tag of its element.
+		*/
+		const isIgnoredNode = (node) => {
+			const astNode = toAstNode(node);
+			let textStart = getNodeStart(astNode);
+			if (textStart !== void 0) while (/\s/u.test(sourceText[textStart] ?? "")) textStart++;
+			return ignoreDirectives.isOffsetIgnored(textStart) || ignoreDirectives.isOffsetIgnored(getEnclosingElementStart(astNode));
+		};
 		const [options = {}] = context.options;
 		const attributes = new Set(options.attributes ?? ATTRIBUTES_TO_EXTRACT);
 		const ignoredElements = new Set(options.ignoreElements ?? DEFAULT_IGNORED_ELEMENTS);
@@ -114,6 +145,7 @@ const noRawText = createRule("no-raw-text", {
 			if (elementName && ignoredElements.has(elementName)) return;
 			if (attributeName !== null && !attributes.has(attributeName)) return;
 			if (!isReportableText(text)) return;
+			if (isIgnoredNode(node)) return;
 			context.report({
 				node,
 				messageId: attributeName === null ? "rawText" : "rawAttribute",
@@ -130,6 +162,7 @@ const noRawText = createRule("no-raw-text", {
 				if (!isReportableText(text)) return;
 				const elementName = getEnclosingElementName(astNode.parent);
 				if (elementName && ignoredElements.has(elementName)) return;
+				if (isIgnoredNode(node)) return;
 				context.report({
 					node,
 					messageId: "rawText",
@@ -145,6 +178,7 @@ const noRawText = createRule("no-raw-text", {
 				if (text === null || !isReportableText(text)) return;
 				const elementName = getEnclosingElementName(astNode.parent);
 				if (elementName && ignoredElements.has(elementName)) return;
+				if (isIgnoredNode(node)) return;
 				context.report({
 					node,
 					messageId: "rawAttribute",
@@ -161,6 +195,7 @@ const noRawText = createRule("no-raw-text", {
 				if (isStructuralPosition(astNode)) return;
 				const text = astNode["value"];
 				if (!isReportableText(text)) return;
+				if (isIgnoredNode(node)) return;
 				context.report({
 					node,
 					messageId: "rawStringLiteral",

package/dist/esm/rules/noRawText.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"noRawText.mjs","names":[],"sources":["../../../src/rules/noRawText.ts"],"sourcesContent":["import { FILE_EXTENSIONS } from '@intlayer/config/defaultValues';\nimport { ATTRIBUTES_TO_EXTRACT, shouldExtract } from '@intlayer/config/extract';\nimport {\n  type AstNode,\n  type AstNodeWithParent,\n  getJsxAttributeName,\n  getJsxAttributeValueNode,\n  getJsxElementName,\n  getStaticStringValue,\n  toAstNode,\n} from '../utils/ast';\nimport { createRule } from '../utils/createRule';\nimport {\n  combineVisitors,\n  createTemplateVisitor,\n  type TemplateVisitor,\n} from '../utils/templates';\n\n/**\n * Elements whose text is markup, code or metadata rather than user-facing copy.\n * Extracting them would be wrong, so they are skipped by default.\n */\nconst DEFAULT_IGNORED_ELEMENTS = ['code', 'pre', 'script', 'style'];\n\nexport type NoRawTextOptions = {\n  /**\n   * JSX attributes whose string value is user-facing copy.\n   * Defaults to the compiler's own list, so the linter flags exactly what\n   * `intlayer extract` would rewrite.\n   */\n  attributes?: string[];\n  /** JSX elements whose children are never translatable. */\n  ignoreElements?: string[];\n  /** Regular-expression sources for text that should never be reported. */\n  ignorePatterns?: string[];\n  /**\n   * Also report string literals outside JSX (function arguments, object values,\n   * …). Off by default: outside JSX the false-positive rate is much higher, and\n   * the compiler's own extractor is the better first pass.\n   */\n  includeStringLiterals?: boolean;\n};\n\ntype MessageIds = 'rawText' | 'rawAttribute' | 'rawStringLiteral';\n\n/**\n * True for a content declaration file, where raw strings are the whole point.\n *\n * @param filename - Absolute path of the linted file.\n */\nconst isContentDeclarationFile = (filename: string): boolean =>\n  FILE_EXTENSIONS.some((extension) => filename.endsWith(extension));\n\n/**\n * Walk up from a JSX child or attribute to the tag name that encloses it.\n *\n * @param node - The reported node.\n */\nconst getEnclosingElementName = (\n  node: AstNodeWithParent | undefined\n): string | null => {\n  let current = node;\n\n  while (current) {\n    if (current.type === 'JSXElement') {\n      return getJsxElementName(current['openingElement'] as AstNode);\n    }\n\n    if (current.type === 'JSXOpeningElement') {\n      return getJsxElementName(current);\n    }\n\n    current = current.parent;\n  }\n\n  return null;\n};\n\n/**\n * True when the string literal sits in a position that is structural rather\n * than user-facing: module specifiers, property keys, directives, and the\n * arguments of the Intlayer getters themselves.\n *\n * @param node - The Literal node.\n */\nconst isStructuralPosition = (node: AstNodeWithParent): boolean => {\n  const parent = node.parent;\n\n  if (!parent) return true;\n\n  switch (parent.type) {\n    case 'ImportDeclaration':\n    case 'ImportExpression':\n    case 'ExportNamedDeclaration':\n    case 'ExportAllDeclaration':\n    case 'JSXAttribute':\n    case 'TSLiteralType':\n    case 'TSEnumMember':\n    case 'ExpressionStatement':\n      return true;\n\n    case 'Property':\n      // Keys are structural; values are not.\n      return parent['key'] === node && parent['computed'] !== true;\n\n    case 'MemberExpression':\n      return parent['property'] === node;\n\n    default:\n      return false;\n  }\n};\n\nexport const noRawText = createRule<[NoRawTextOptions?], MessageIds>(\n  'no-raw-text',\n  {\n    meta: {\n      type: 'problem',\n      docs: {\n        description:\n          'Report user-facing strings that are not declared in an Intlayer dictionary',\n      },\n      messages: {\n        rawText:\n          'Untranslated text \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n        rawAttribute:\n          'Untranslated `{{attribute}}` value \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n        rawStringLiteral:\n          'Untranslated string \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n      },\n      schema: [\n        {\n          type: 'object',\n          properties: {\n            attributes: { type: 'array', items: { type: 'string' } },\n            ignoreElements: { type: 'array', items: { type: 'string' } },\n            ignorePatterns: { type: 'array', items: { type: 'string' } },\n            includeStringLiterals: { type: 'boolean' },\n          },\n          additionalProperties: false,\n        },\n      ],\n    },\n\n    create: (context) => {\n      const filename = context.filename;\n\n      // Content declaration files hold the translations themselves.\n      if (isContentDeclarationFile(filename)) return {};\n\n      const [options = {}] = context.options;\n      const attributes = new Set<string>(\n        options.attributes ?? ATTRIBUTES_TO_EXTRACT\n      );\n      const ignoredElements = new Set<string>(\n        options.ignoreElements ?? DEFAULT_IGNORED_ELEMENTS\n      );\n      const ignorePatterns = (options.ignorePatterns ?? []).map(\n        (pattern) => new RegExp(pattern, 'u')\n      );\n      const includeStringLiterals = options.includeStringLiterals === true;\n\n      /** True when the text is copy the extractor would pick up. */\n      const isReportableText = (text: string): boolean =>\n        shouldExtract(text) &&\n        !ignorePatterns.some((pattern) => pattern.test(text.trim()));\n\n      /** Collapse whitespace so multi-line JSX text reads well in the report. */\n      const formatText = (text: string): string => {\n        const normalized = text.replace(/\\s+/gu, ' ').trim();\n\n        return normalized.length > 40\n          ? `${normalized.slice(0, 40)}…`\n          : normalized;\n      };\n\n      /**\n       * Handlers for the markup languages that are not JSX — Vue, Svelte and\n       * Angular templates. Reports through the same predicate and options as\n       * the JSX path so a project gets identical results whatever it is written\n       * in.\n       */\n      const templateVisitor = createTemplateVisitor(\n        ({ node, text, attributeName, elementName }) => {\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          if (attributeName !== null && !attributes.has(attributeName)) return;\n\n          if (!isReportableText(text)) return;\n\n          context.report({\n            node: node as never,\n            messageId: attributeName === null ? 'rawText' : 'rawAttribute',\n            data: {\n              text: formatText(text),\n              ...(attributeName === null ? {} : { attribute: attributeName }),\n            },\n          });\n        }\n      );\n\n      const scriptVisitor: TemplateVisitor = {\n        JSXText: (node) => {\n          const astNode = toAstNode(node as never);\n          const text = astNode['value'] as string;\n\n          if (!isReportableText(text)) return;\n\n          const elementName = getEnclosingElementName(astNode.parent);\n\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawText',\n            data: { text: formatText(text) },\n          });\n        },\n\n        JSXAttribute: (node) => {\n          const astNode = toAstNode(node as never);\n          const attributeName = getJsxAttributeName(astNode);\n\n          if (!attributeName || !attributes.has(attributeName)) return;\n\n          const valueNode = getJsxAttributeValueNode(astNode);\n          const text = getStaticStringValue(valueNode);\n\n          if (text === null || !isReportableText(text)) return;\n\n          const elementName = getEnclosingElementName(astNode.parent);\n\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawAttribute',\n            data: { attribute: attributeName, text: formatText(text) },\n          });\n        },\n\n        Literal: (node) => {\n          if (!includeStringLiterals) return;\n\n          const astNode = toAstNode(node as never);\n\n          if (typeof astNode['value'] !== 'string') return;\n\n          if (isStructuralPosition(astNode)) return;\n\n          const text = astNode['value'] as string;\n\n          if (!isReportableText(text)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawStringLiteral',\n            data: { text: formatText(text) },\n          });\n        },\n      };\n\n      return combineVisitors(\n        context.sourceCode.parserServices,\n        scriptVisitor,\n        templateVisitor\n      );\n    },\n  }\n);\n"],"mappings":";;;;;;;;;;;;AAsBA,MAAM,2BAA2B;CAAC;CAAQ;CAAO;CAAU;AAAO;;;;;;AA4BlE,MAAM,4BAA4B,aAChC,gBAAgB,MAAM,cAAc,SAAS,SAAS,SAAS,CAAC;;;;;;AAOlE,MAAM,2BACJ,SACkB;CAClB,IAAI,UAAU;CAEd,OAAO,SAAS;EACd,IAAI,QAAQ,SAAS,cACnB,OAAO,kBAAkB,QAAQ,iBAA4B;EAG/D,IAAI,QAAQ,SAAS,qBACnB,OAAO,kBAAkB,OAAO;EAGlC,UAAU,QAAQ;CACpB;CAEA,OAAO;AACT;;;;;;;;AASA,MAAM,wBAAwB,SAAqC;CACjE,MAAM,SAAS,KAAK;CAEpB,IAAI,CAAC,QAAQ,OAAO;CAEpB,QAAQ,OAAO,MAAf;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,uBACH,OAAO;EAET,KAAK,YAEH,OAAO,OAAO,WAAW,QAAQ,OAAO,gBAAgB;EAE1D,KAAK,oBACH,OAAO,OAAO,gBAAgB;EAEhC,SACE,OAAO;CACX;AACF;AAEA,MAAa,YAAY,WACvB,eACA;CACE,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,6EACJ;EACA,UAAU;GACR,SACE;GACF,cACE;GACF,kBACE;EACJ;EACA,QAAQ,CACN;GACE,MAAM;GACN,YAAY;IACV,YAAY;KAAE,MAAM;KAAS,OAAO,EAAE,MAAM,SAAS;IAAE;IACvD,gBAAgB;KAAE,MAAM;KAAS,OAAO,EAAE,MAAM,SAAS;IAAE;IAC3D,gBAAgB;KAAE,MAAM;KAAS,OAAO,EAAE,MAAM,SAAS;IAAE;IAC3D,uBAAuB,EAAE,MAAM,UAAU;GAC3C;GACA,sBAAsB;EACxB,CACF;CACF;CAEA,SAAS,YAAY;EACnB,MAAM,WAAW,QAAQ;EAGzB,IAAI,yBAAyB,QAAQ,GAAG,OAAO,CAAC;EAEhD,MAAM,CAAC,UAAU,CAAC,KAAK,QAAQ;EAC/B,MAAM,aAAa,IAAI,IACrB,QAAQ,cAAc,qBACxB;EACA,MAAM,kBAAkB,IAAI,IAC1B,QAAQ,kBAAkB,wBAC5B;EACA,MAAM,kBAAkB,QAAQ,kBAAkB,CAAC,EAAC,CAAE,KACnD,YAAY,IAAI,OAAO,SAAS,GAAG,CACtC;EACA,MAAM,wBAAwB,QAAQ,0BAA0B;;EAGhE,MAAM,oBAAoB,SACxB,cAAc,IAAI,KAClB,CAAC,eAAe,MAAM,YAAY,QAAQ,KAAK,KAAK,KAAK,CAAC,CAAC;;EAG7D,MAAM,cAAc,SAAyB;GAC3C,MAAM,aAAa,KAAK,QAAQ,SAAS,GAAG,CAAC,CAAC,KAAK;GAEnD,OAAO,WAAW,SAAS,KACvB,GAAG,WAAW,MAAM,GAAG,EAAE,EAAE,KAC3B;EACN;;;;;;;EAQA,MAAM,kBAAkB,uBACrB,EAAE,MAAM,MAAM,eAAe,kBAAkB;GAC9C,IAAI,eAAe,gBAAgB,IAAI,WAAW,GAAG;GAErD,IAAI,kBAAkB,QAAQ,CAAC,WAAW,IAAI,aAAa,GAAG;GAE9D,IAAI,CAAC,iBAAiB,IAAI,GAAG;GAE7B,QAAQ,OAAO;IACP;IACN,WAAW,kBAAkB,OAAO,YAAY;IAChD,MAAM;KACJ,MAAM,WAAW,IAAI;KACrB,GAAI,kBAAkB,OAAO,CAAC,IAAI,EAAE,WAAW,cAAc;IAC/D;GACF,CAAC;EACH,CACF;EA+DA,OAAO,gBACL,QAAQ,WAAW,gBACnB;GA9DA,UAAU,SAAS;IACjB,MAAM,UAAU,UAAU,IAAa;IACvC,MAAM,OAAO,QAAQ;IAErB,IAAI,CAAC,iBAAiB,IAAI,GAAG;IAE7B,MAAM,cAAc,wBAAwB,QAAQ,MAAM;IAE1D,IAAI,eAAe,gBAAgB,IAAI,WAAW,GAAG;IAErD,QAAQ,OAAO;KACP;KACN,WAAW;KACX,MAAM,EAAE,MAAM,WAAW,IAAI,EAAE;IACjC,CAAC;GACH;GAEA,eAAe,SAAS;IACtB,MAAM,UAAU,UAAU,IAAa;IACvC,MAAM,gBAAgB,oBAAoB,OAAO;IAEjD,IAAI,CAAC,iBAAiB,CAAC,WAAW,IAAI,aAAa,GAAG;IAEtD,MAAM,YAAY,yBAAyB,OAAO;IAClD,MAAM,OAAO,qBAAqB,SAAS;IAE3C,IAAI,SAAS,QAAQ,CAAC,iBAAiB,IAAI,GAAG;IAE9C,MAAM,cAAc,wBAAwB,QAAQ,MAAM;IAE1D,IAAI,eAAe,gBAAgB,IAAI,WAAW,GAAG;IAErD,QAAQ,OAAO;KACP;KACN,WAAW;KACX,MAAM;MAAE,WAAW;MAAe,MAAM,WAAW,IAAI;KAAE;IAC3D,CAAC;GACH;GAEA,UAAU,SAAS;IACjB,IAAI,CAAC,uBAAuB;IAE5B,MAAM,UAAU,UAAU,IAAa;IAEvC,IAAI,OAAO,QAAQ,aAAa,UAAU;IAE1C,IAAI,qBAAqB,OAAO,GAAG;IAEnC,MAAM,OAAO,QAAQ;IAErB,IAAI,CAAC,iBAAiB,IAAI,GAAG;IAE7B,QAAQ,OAAO;KACP;KACN,WAAW;KACX,MAAM,EAAE,MAAM,WAAW,IAAI,EAAE;IACjC,CAAC;GACH;EAKY,GACZ,eACF;CACF;AACF,CACF"}
+{"version":3,"file":"noRawText.mjs","names":[],"sources":["../../../src/rules/noRawText.ts"],"sourcesContent":["import { FILE_EXTENSIONS } from '@intlayer/config/defaultValues';\nimport {\n  ATTRIBUTES_TO_EXTRACT,\n  getExtractionIgnoreDirectives,\n  shouldExtract,\n} from '@intlayer/config/extract';\nimport {\n  type AstNode,\n  type AstNodeWithParent,\n  getJsxAttributeName,\n  getJsxAttributeValueNode,\n  getJsxElementName,\n  getStaticStringValue,\n  toAstNode,\n} from '../utils/ast';\nimport { createRule } from '../utils/createRule';\nimport {\n  combineVisitors,\n  createTemplateVisitor,\n  type TemplateVisitor,\n} from '../utils/templates';\n\n/**\n * Elements whose text is markup, code or metadata rather than user-facing copy.\n * Extracting them would be wrong, so they are skipped by default.\n */\nconst DEFAULT_IGNORED_ELEMENTS = ['code', 'pre', 'script', 'style'];\n\nexport type NoRawTextOptions = {\n  /**\n   * JSX attributes whose string value is user-facing copy.\n   * Defaults to the compiler's own list, so the linter flags exactly what\n   * `intlayer extract` would rewrite.\n   */\n  attributes?: string[];\n  /** JSX elements whose children are never translatable. */\n  ignoreElements?: string[];\n  /** Regular-expression sources for text that should never be reported. */\n  ignorePatterns?: string[];\n  /**\n   * Also report string literals outside JSX (function arguments, object values,\n   * …). Off by default: outside JSX the false-positive rate is much higher, and\n   * the compiler's own extractor is the better first pass.\n   */\n  includeStringLiterals?: boolean;\n};\n\ntype MessageIds = 'rawText' | 'rawAttribute' | 'rawStringLiteral';\n\n/**\n * True for a content declaration file, where raw strings are the whole point.\n *\n * @param filename - Absolute path of the linted file.\n */\nconst isContentDeclarationFile = (filename: string): boolean =>\n  FILE_EXTENSIONS.some((extension) => filename.endsWith(extension));\n\n/**\n * Walk up from a JSX child or attribute to the tag name that encloses it.\n *\n * @param node - The reported node.\n */\n/** Start offset of an ESLint node (`range[0]`), when it has one. */\nconst getNodeStart = (node: AstNode | undefined): number | undefined => {\n  const range = node?.['range'];\n\n  return Array.isArray(range) && typeof range[0] === 'number'\n    ? range[0]\n    : undefined;\n};\n\n/**\n * Start offset of the element a text, `{'literal'}` child or attribute\n * belongs to (JSX, Vue and Svelte trees alike).\n */\nconst getEnclosingElementStart = (\n  node: AstNodeWithParent\n): number | undefined => {\n  let current = node.parent;\n\n  if (current?.type === 'JSXExpressionContainer') current = current.parent;\n  if (current?.type === 'JSXAttribute') current = current.parent;\n  if (current?.type === 'JSXOpeningElement') current = current.parent;\n\n  return getNodeStart(current);\n};\n\nconst getEnclosingElementName = (\n  node: AstNodeWithParent | undefined\n): string | null => {\n  let current = node;\n\n  while (current) {\n    if (current.type === 'JSXElement') {\n      return getJsxElementName(current['openingElement'] as AstNode);\n    }\n\n    if (current.type === 'JSXOpeningElement') {\n      return getJsxElementName(current);\n    }\n\n    current = current.parent;\n  }\n\n  return null;\n};\n\n/**\n * True when the string literal sits in a position that is structural rather\n * than user-facing: module specifiers, property keys, directives, and the\n * arguments of the Intlayer getters themselves.\n *\n * @param node - The Literal node.\n */\nconst isStructuralPosition = (node: AstNodeWithParent): boolean => {\n  const parent = node.parent;\n\n  if (!parent) return true;\n\n  switch (parent.type) {\n    case 'ImportDeclaration':\n    case 'ImportExpression':\n    case 'ExportNamedDeclaration':\n    case 'ExportAllDeclaration':\n    case 'JSXAttribute':\n    case 'TSLiteralType':\n    case 'TSEnumMember':\n    case 'ExpressionStatement':\n      return true;\n\n    case 'Property':\n      // Keys are structural; values are not.\n      return parent['key'] === node && parent['computed'] !== true;\n\n    case 'MemberExpression':\n      return parent['property'] === node;\n\n    default:\n      return false;\n  }\n};\n\nexport const noRawText = createRule<[NoRawTextOptions?], MessageIds>(\n  'no-raw-text',\n  {\n    meta: {\n      type: 'problem',\n      docs: {\n        description:\n          'Report user-facing strings that are not declared in an Intlayer dictionary',\n      },\n      messages: {\n        rawText:\n          'Untranslated text \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n        rawAttribute:\n          'Untranslated `{{attribute}}` value \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n        rawStringLiteral:\n          'Untranslated string \"{{text}}\". Move it to a dictionary — `npx intlayer extract` can do it for this file.',\n      },\n      schema: [\n        {\n          type: 'object',\n          properties: {\n            attributes: { type: 'array', items: { type: 'string' } },\n            ignoreElements: { type: 'array', items: { type: 'string' } },\n            ignorePatterns: { type: 'array', items: { type: 'string' } },\n            includeStringLiterals: { type: 'boolean' },\n          },\n          additionalProperties: false,\n        },\n      ],\n    },\n\n    create: (context) => {\n      const filename = context.filename;\n\n      // Content declaration files hold the translations themselves.\n      if (isContentDeclarationFile(filename)) return {};\n\n      const sourceText = context.sourceCode.text;\n      const ignoreDirectives = getExtractionIgnoreDirectives(sourceText);\n\n      // Same comment directives as the compiler: what it skips is not reported.\n      if (ignoreDirectives.isFileIgnored) return {};\n\n      /**\n       * Whether an `intlayer-ignore-line` / `intlayer-ignore-next-line`\n       * directive covers the node: on the line where its text starts, or on\n       * the opening tag of its element.\n       */\n      const isIgnoredNode = (node: unknown): boolean => {\n        const astNode = toAstNode(node as never);\n        let textStart = getNodeStart(astNode);\n\n        if (textStart !== undefined) {\n          while (/\\s/u.test(sourceText[textStart] ?? '')) textStart++;\n        }\n\n        return (\n          ignoreDirectives.isOffsetIgnored(textStart) ||\n          ignoreDirectives.isOffsetIgnored(getEnclosingElementStart(astNode))\n        );\n      };\n\n      const [options = {}] = context.options;\n      const attributes = new Set<string>(\n        options.attributes ?? ATTRIBUTES_TO_EXTRACT\n      );\n      const ignoredElements = new Set<string>(\n        options.ignoreElements ?? DEFAULT_IGNORED_ELEMENTS\n      );\n      const ignorePatterns = (options.ignorePatterns ?? []).map(\n        (pattern) => new RegExp(pattern, 'u')\n      );\n      const includeStringLiterals = options.includeStringLiterals === true;\n\n      /** True when the text is copy the extractor would pick up. */\n      const isReportableText = (text: string): boolean =>\n        shouldExtract(text) &&\n        !ignorePatterns.some((pattern) => pattern.test(text.trim()));\n\n      /** Collapse whitespace so multi-line JSX text reads well in the report. */\n      const formatText = (text: string): string => {\n        const normalized = text.replace(/\\s+/gu, ' ').trim();\n\n        return normalized.length > 40\n          ? `${normalized.slice(0, 40)}…`\n          : normalized;\n      };\n\n      /**\n       * Handlers for the markup languages that are not JSX — Vue, Svelte and\n       * Angular templates. Reports through the same predicate and options as\n       * the JSX path so a project gets identical results whatever it is written\n       * in.\n       */\n      const templateVisitor = createTemplateVisitor(\n        ({ node, text, attributeName, elementName }) => {\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          if (attributeName !== null && !attributes.has(attributeName)) return;\n\n          if (!isReportableText(text)) return;\n\n          if (isIgnoredNode(node)) return;\n\n          context.report({\n            node: node as never,\n            messageId: attributeName === null ? 'rawText' : 'rawAttribute',\n            data: {\n              text: formatText(text),\n              ...(attributeName === null ? {} : { attribute: attributeName }),\n            },\n          });\n        }\n      );\n\n      const scriptVisitor: TemplateVisitor = {\n        JSXText: (node) => {\n          const astNode = toAstNode(node as never);\n          const text = astNode['value'] as string;\n\n          if (!isReportableText(text)) return;\n\n          const elementName = getEnclosingElementName(astNode.parent);\n\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          if (isIgnoredNode(node)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawText',\n            data: { text: formatText(text) },\n          });\n        },\n\n        JSXAttribute: (node) => {\n          const astNode = toAstNode(node as never);\n          const attributeName = getJsxAttributeName(astNode);\n\n          if (!attributeName || !attributes.has(attributeName)) return;\n\n          const valueNode = getJsxAttributeValueNode(astNode);\n          const text = getStaticStringValue(valueNode);\n\n          if (text === null || !isReportableText(text)) return;\n\n          const elementName = getEnclosingElementName(astNode.parent);\n\n          if (elementName && ignoredElements.has(elementName)) return;\n\n          if (isIgnoredNode(node)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawAttribute',\n            data: { attribute: attributeName, text: formatText(text) },\n          });\n        },\n\n        Literal: (node) => {\n          if (!includeStringLiterals) return;\n\n          const astNode = toAstNode(node as never);\n\n          if (typeof astNode['value'] !== 'string') return;\n\n          if (isStructuralPosition(astNode)) return;\n\n          const text = astNode['value'] as string;\n\n          if (!isReportableText(text)) return;\n\n          if (isIgnoredNode(node)) return;\n\n          context.report({\n            node: node as never,\n            messageId: 'rawStringLiteral',\n            data: { text: formatText(text) },\n          });\n        },\n      };\n\n      return combineVisitors(\n        context.sourceCode.parserServices,\n        scriptVisitor,\n        templateVisitor\n      );\n    },\n  }\n);\n"],"mappings":";;;;;;;;;;;;;AA0BA,MAAM,2BAA2B;CAAC;CAAQ;CAAO;CAAU;AAAO;;;;;;AA4BlE,MAAM,4BAA4B,aAChC,gBAAgB,MAAM,cAAc,SAAS,SAAS,SAAS,CAAC;;;;;;;AAQlE,MAAM,gBAAgB,SAAkD;CACtE,MAAM,QAAQ,OAAO;CAErB,OAAO,MAAM,QAAQ,KAAK,KAAK,OAAO,MAAM,OAAO,WAC/C,MAAM,KACN;AACN;;;;;AAMA,MAAM,4BACJ,SACuB;CACvB,IAAI,UAAU,KAAK;CAEnB,IAAI,SAAS,SAAS,0BAA0B,UAAU,QAAQ;CAClE,IAAI,SAAS,SAAS,gBAAgB,UAAU,QAAQ;CACxD,IAAI,SAAS,SAAS,qBAAqB,UAAU,QAAQ;CAE7D,OAAO,aAAa,OAAO;AAC7B;AAEA,MAAM,2BACJ,SACkB;CAClB,IAAI,UAAU;CAEd,OAAO,SAAS;EACd,IAAI,QAAQ,SAAS,cACnB,OAAO,kBAAkB,QAAQ,iBAA4B;EAG/D,IAAI,QAAQ,SAAS,qBACnB,OAAO,kBAAkB,OAAO;EAGlC,UAAU,QAAQ;CACpB;CAEA,OAAO;AACT;;;;;;;;AASA,MAAM,wBAAwB,SAAqC;CACjE,MAAM,SAAS,KAAK;CAEpB,IAAI,CAAC,QAAQ,OAAO;CAEpB,QAAQ,OAAO,MAAf;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,uBACH,OAAO;EAET,KAAK,YAEH,OAAO,OAAO,WAAW,QAAQ,OAAO,gBAAgB;EAE1D,KAAK,oBACH,OAAO,OAAO,gBAAgB;EAEhC,SACE,OAAO;CACX;AACF;AAEA,MAAa,YAAY,WACvB,eACA;CACE,MAAM;EACJ,MAAM;EACN,MAAM,EACJ,aACE,6EACJ;EACA,UAAU;GACR,SACE;GACF,cACE;GACF,kBACE;EACJ;EACA,QAAQ,CACN;GACE,MAAM;GACN,YAAY;IACV,YAAY;KAAE,MAAM;KAAS,OAAO,EAAE,MAAM,SAAS;IAAE;IACvD,gBAAgB;KAAE,MAAM;KAAS,OAAO,EAAE,MAAM,SAAS;IAAE;IAC3D,gBAAgB;KAAE,MAAM;KAAS,OAAO,EAAE,MAAM,SAAS;IAAE;IAC3D,uBAAuB,EAAE,MAAM,UAAU;GAC3C;GACA,sBAAsB;EACxB,CACF;CACF;CAEA,SAAS,YAAY;EACnB,MAAM,WAAW,QAAQ;EAGzB,IAAI,yBAAyB,QAAQ,GAAG,OAAO,CAAC;EAEhD,MAAM,aAAa,QAAQ,WAAW;EACtC,MAAM,mBAAmB,8BAA8B,UAAU;EAGjE,IAAI,iBAAiB,eAAe,OAAO,CAAC;;;;;;EAO5C,MAAM,iBAAiB,SAA2B;GAChD,MAAM,UAAU,UAAU,IAAa;GACvC,IAAI,YAAY,aAAa,OAAO;GAEpC,IAAI,cAAc,QAChB,OAAO,MAAM,KAAK,WAAW,cAAc,EAAE,GAAG;GAGlD,OACE,iBAAiB,gBAAgB,SAAS,KAC1C,iBAAiB,gBAAgB,yBAAyB,OAAO,CAAC;EAEtE;EAEA,MAAM,CAAC,UAAU,CAAC,KAAK,QAAQ;EAC/B,MAAM,aAAa,IAAI,IACrB,QAAQ,cAAc,qBACxB;EACA,MAAM,kBAAkB,IAAI,IAC1B,QAAQ,kBAAkB,wBAC5B;EACA,MAAM,kBAAkB,QAAQ,kBAAkB,CAAC,EAAC,CAAE,KACnD,YAAY,IAAI,OAAO,SAAS,GAAG,CACtC;EACA,MAAM,wBAAwB,QAAQ,0BAA0B;;EAGhE,MAAM,oBAAoB,SACxB,cAAc,IAAI,KAClB,CAAC,eAAe,MAAM,YAAY,QAAQ,KAAK,KAAK,KAAK,CAAC,CAAC;;EAG7D,MAAM,cAAc,SAAyB;GAC3C,MAAM,aAAa,KAAK,QAAQ,SAAS,GAAG,CAAC,CAAC,KAAK;GAEnD,OAAO,WAAW,SAAS,KACvB,GAAG,WAAW,MAAM,GAAG,EAAE,EAAE,KAC3B;EACN;;;;;;;EAQA,MAAM,kBAAkB,uBACrB,EAAE,MAAM,MAAM,eAAe,kBAAkB;GAC9C,IAAI,eAAe,gBAAgB,IAAI,WAAW,GAAG;GAErD,IAAI,kBAAkB,QAAQ,CAAC,WAAW,IAAI,aAAa,GAAG;GAE9D,IAAI,CAAC,iBAAiB,IAAI,GAAG;GAE7B,IAAI,cAAc,IAAI,GAAG;GAEzB,QAAQ,OAAO;IACP;IACN,WAAW,kBAAkB,OAAO,YAAY;IAChD,MAAM;KACJ,MAAM,WAAW,IAAI;KACrB,GAAI,kBAAkB,OAAO,CAAC,IAAI,EAAE,WAAW,cAAc;IAC/D;GACF,CAAC;EACH,CACF;EAqEA,OAAO,gBACL,QAAQ,WAAW,gBACnB;GApEA,UAAU,SAAS;IACjB,MAAM,UAAU,UAAU,IAAa;IACvC,MAAM,OAAO,QAAQ;IAErB,IAAI,CAAC,iBAAiB,IAAI,GAAG;IAE7B,MAAM,cAAc,wBAAwB,QAAQ,MAAM;IAE1D,IAAI,eAAe,gBAAgB,IAAI,WAAW,GAAG;IAErD,IAAI,cAAc,IAAI,GAAG;IAEzB,QAAQ,OAAO;KACP;KACN,WAAW;KACX,MAAM,EAAE,MAAM,WAAW,IAAI,EAAE;IACjC,CAAC;GACH;GAEA,eAAe,SAAS;IACtB,MAAM,UAAU,UAAU,IAAa;IACvC,MAAM,gBAAgB,oBAAoB,OAAO;IAEjD,IAAI,CAAC,iBAAiB,CAAC,WAAW,IAAI,aAAa,GAAG;IAEtD,MAAM,YAAY,yBAAyB,OAAO;IAClD,MAAM,OAAO,qBAAqB,SAAS;IAE3C,IAAI,SAAS,QAAQ,CAAC,iBAAiB,IAAI,GAAG;IAE9C,MAAM,cAAc,wBAAwB,QAAQ,MAAM;IAE1D,IAAI,eAAe,gBAAgB,IAAI,WAAW,GAAG;IAErD,IAAI,cAAc,IAAI,GAAG;IAEzB,QAAQ,OAAO;KACP;KACN,WAAW;KACX,MAAM;MAAE,WAAW;MAAe,MAAM,WAAW,IAAI;KAAE;IAC3D,CAAC;GACH;GAEA,UAAU,SAAS;IACjB,IAAI,CAAC,uBAAuB;IAE5B,MAAM,UAAU,UAAU,IAAa;IAEvC,IAAI,OAAO,QAAQ,aAAa,UAAU;IAE1C,IAAI,qBAAqB,OAAO,GAAG;IAEnC,MAAM,OAAO,QAAQ;IAErB,IAAI,CAAC,iBAAiB,IAAI,GAAG;IAE7B,IAAI,cAAc,IAAI,GAAG;IAEzB,QAAQ,OAAO;KACP;KACN,WAAW;KACX,MAAM,EAAE,MAAM,WAAW,IAAI,EAAE;IACjC,CAAC;GACH;EAKY,GACZ,eACF;CACF;AACF,CACF"}

package/dist/types/rules/noRawText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"noRawText.d.ts","names":["_$___utils_createRule0.IntlayerRule"],"sources":["../../../src/rules/noRawText.ts"],"mappings":";YAwBY;;;;;;EAMV;;EAEA;;EAEA;;;;;;EAMA;;KAGG;qBAsEQ,WAASA,cAAA,oBAAA"}
+{"version":3,"file":"noRawText.d.ts","names":["_$___utils_createRule0.IntlayerRule"],"sources":["../../../src/rules/noRawText.ts"],"mappings":";YA4BY;;;;;;EAMV;;EAEA;;EAEA;;;;;;EAMA;;KAGG;qBA+FQ,WAASA,cAAA,oBAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-intlayer",
-  "version": "9.7.2",
+  "version": "9.8.0-canary.0",
   "private": false,
   "description": "ESLint (and oxlint) plugin for Intlayer. Catches untranslated strings and the dynamic call shapes the Intlayer compiler cannot optimize.",
   "keywords": [
@@ -77,8 +77,8 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/config": "9.7.2",
-    "@intlayer/lsp": "9.7.2",
+    "@intlayer/config": "9.8.0-canary.0",
+    "@intlayer/lsp": "9.8.0-canary.0",
     "fast-glob": "3.3.3"
   },
   "devDependencies": {