locai 2.6.1 → 2.7.0

package/dist/utils/logger.js

@@ -54,14 +54,13 @@ class Logger {
             this.initialized = true;
         }
         catch (error) {
-            console.warn(`Logger initialization warning: ${error.message}`);
+            console.warn(`Logger initialization warning: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
     /**
      * Parse size string (e.g., "10MB") to bytes.
      * @param sizeStr - Size string to parse.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     parseSize(sizeStr) {
         if (typeof sizeStr === "number")
             return sizeStr;
@@ -92,7 +91,7 @@ class Logger {
                 }
             }
             catch (error) {
-                console.warn(`Log rotation failed for ${logPath}: ${error.message}`);
+                console.warn(`Log rotation failed for ${logPath}: ${error instanceof Error ? error.message : String(error)}`);
                 this.currentLogSizes[level] = 0;
             }
         }
@@ -118,7 +117,7 @@ class Logger {
             }
         }
         catch (error) {
-            console.warn(`Log rotation failed for ${logPath}: ${error.message}`);
+            console.warn(`Log rotation failed for ${logPath}: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
     /**
@@ -150,7 +149,7 @@ class Logger {
             }
         }
         catch (error) {
-            console.warn(`Cleanup old logs failed: ${error.message}`);
+            console.warn(`Cleanup old logs failed: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
     /**
@@ -159,7 +158,6 @@ class Logger {
      * @param message - Log message.
      * @param data - Additional data to log.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     formatMessage(level, message, data = null) {
         const timestamp = this.config.includeTimestamps ? new Date().toISOString() : null;
         switch (this.config.outputFormat) {
@@ -187,7 +185,6 @@ class Logger {
      * @param message - Log message.
      * @param data - Additional data to log.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async writeToFile(level, message, data = null) {
         if (!this.config.saveErrorLogs)
             return;
@@ -208,7 +205,7 @@ class Logger {
             }
         }
         catch (error) {
-            console.warn(`Failed to write to log file: ${error.message}`);
+            console.warn(`Failed to write to log file: ${error instanceof Error ? error.message : String(error)}`);
         }
     }
     /**
@@ -227,7 +224,6 @@ class Logger {
      * @param message - Error message.
      * @param data - Additional data.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async error(message, data = null) {
         console.error(`ERROR: ${message}`);
         if (data && this.config.verbose) {
@@ -240,7 +236,6 @@ class Logger {
      * @param message - Warning message.
      * @param data - Additional data.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async warn(message, data = null) {
         console.warn(`WARNING: ${message}`);
         if (data && this.config.verbose) {
@@ -253,7 +248,6 @@ class Logger {
      * @param message - Info message.
      * @param data - Additional data.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async info(message, data = null) {
         if (this.config.diagnosticsLevel !== "minimal" || this.config.verbose) {
             console.log(`INFO: ${message}`);
@@ -268,7 +262,6 @@ class Logger {
      * @param message - Debug message.
      * @param data - Additional data.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async debug(message, data = null) {
         if (this.config.verbose || this.config.diagnosticsLevel === "detailed") {
             console.log(`DEBUG: ${message}`);
@@ -284,7 +277,6 @@ class Logger {
      * @param message - Log message.
      * @param data - Additional data.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async diagnostics(level, message, data = null) {
         const levels = {
             minimal: 1,
@@ -313,7 +305,7 @@ class Logger {
                 };
             }
             catch (error) {
-                console.warn(`Failed to get stats for ${logPath}: ${error.message}`);
+                console.warn(`Failed to get stats for ${logPath}: ${error instanceof Error ? error.message : String(error)}`);
                 stats[level] = {
                     size: 0,
                     sizeFormatted: "0 B",
@@ -346,7 +338,7 @@ class Logger {
                 await fsPromises.unlink(logPath);
             }
             catch (error) {
-                console.warn(`Failed to clear log ${logPath}: ${error.message}`);
+                console.warn(`Failed to clear log ${logPath}: ${error instanceof Error ? error.message : String(error)}`);
             }
         }
         this.currentLogSizes = {};

package/dist/utils/object-transformer.d.ts

@@ -1,9 +1,24 @@
 /**
  * Utility class for object manipulation.
  */
-export interface TransformedObject {
-    [key: string]: any;
+/**
+ * A value in a locale file: a primitive leaf, an array, or a nested object.
+ */
+export type TranslationValue = string | number | boolean | null | TranslationValue[] | TranslationObject;
+/**
+ * A (possibly nested) locale object, e.g. `{ "home": { "title": "Hello" } }`.
+ */
+export interface TranslationObject {
+    [key: string]: TranslationValue;
 }
+/**
+ * A leaf of a flattened locale object. Arrays are kept whole, they are not flattened.
+ */
+export type FlatTranslationValue = Exclude<TranslationValue, TranslationObject>;
+/**
+ * A locale object flattened to dot-notation keys, e.g. `{ "home.title": "Hello" }`.
+ */
+export type FlatTranslations = Record<string, FlatTranslationValue>;
 declare class ObjectTransformer {
     /**
      * Flatten a nested object into a single-level object with dot notation keys.
@@ -12,13 +27,13 @@ declare class ObjectTransformer {
      * @param maxDepth - Maximum recursion depth.
      * @returns Flattened object.
      */
-    static flatten(obj: TransformedObject, prefix?: string, maxDepth?: number): Record<string, string | number | boolean | null>;
+    static flatten(obj: TranslationObject, prefix?: string, maxDepth?: number): FlatTranslations;
     /**
      * Unflatten an object with dot notation keys into a nested object.
      * @param obj - The flattened object.
      * @returns Nested object.
      */
-    static unflatten(obj: Record<string, any>): TransformedObject;
+    static unflatten(obj: Record<string, TranslationValue>): TranslationObject;
     /**
      * Create a deep copy of an object.
      * @param obj - The object to clone.
@@ -33,6 +48,6 @@ declare class ObjectTransformer {
      * @param overwriteArrays - Whether to overwrite arrays or merge them.
      * @returns Merged object.
      */
-    static mergeObjects(target: TransformedObject, source: TransformedObject, overwriteArrays?: boolean): TransformedObject;
+    static mergeObjects(target: TranslationObject, source: TranslationObject, overwriteArrays?: boolean): TranslationObject;
 }
 export default ObjectTransformer;

package/dist/utils/object-transformer.js

@@ -1,6 +1,10 @@
 /**
  * Utility class for object manipulation.
  */
+const isPlainObject = (value) => value !== null &&
+    typeof value === "object" &&
+    !Array.isArray(value) &&
+    value.constructor === Object;
 class ObjectTransformer {
     /**
      * Flatten a nested object into a single-level object with dot notation keys.
@@ -11,10 +15,8 @@ class ObjectTransformer {
      */
     static flatten(obj, prefix = "", maxDepth = 20) {
         if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             return prefix ? { [prefix]: obj } : {};
         }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const result = {};
         const stack = [{ obj, prefix, depth: 0 }];
         while (stack.length > 0) {
@@ -32,10 +34,7 @@ class ObjectTransformer {
                 const key = keys[i];
                 const value = currentObj[key];
                 const newKey = currentPrefix ? `${currentPrefix}.${key}` : key;
-                if (value !== null &&
-                    typeof value === "object" &&
-                    !Array.isArray(value) &&
-                    value.constructor === Object) {
+                if (isPlainObject(value)) {
                     stack.push({ obj: value, prefix: newKey, depth: depth + 1 });
                 }
                 else {
@@ -50,7 +49,6 @@ class ObjectTransformer {
      * @param obj - The flattened object.
      * @returns Nested object.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     static unflatten(obj) {
         if (!obj || typeof obj !== "object") {
             return {};
@@ -79,12 +77,12 @@ class ObjectTransformer {
             const lastIndex = partsLength - 1;
             for (let i = 0; i < lastIndex; i++) {
                 const part = keyParts[i];
-                if (current[part] == null ||
-                    typeof current[part] !== "object" ||
-                    Array.isArray(current[part])) {
-                    current[part] = {};
+                let next = current[part];
+                if (next == null || typeof next !== "object" || Array.isArray(next)) {
+                    next = {};
+                    current[part] = next;
                 }
-                current = current[part];
+                current = next;
             }
             current[keyParts[lastIndex]] = value;
         }
@@ -96,44 +94,33 @@ class ObjectTransformer {
      * @param seen - Internal set to track circular references.
      * @returns Deep copy of the object.
      */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     static deepClone(obj, seen = new WeakSet()) {
         if (obj === null || typeof obj !== "object") {
             return obj;
         }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (seen.has(obj)) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            // Circular reference: break the cycle with an empty object
             return {};
         }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         seen.add(obj);
         if (Array.isArray(obj)) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const result = obj.map((item) => this.deepClone(item, seen));
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             seen.delete(obj);
             return result;
         }
         if (obj instanceof Date) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             seen.delete(obj);
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             return new Date(obj.getTime());
         }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (obj.constructor !== Object) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             seen.delete(obj);
             return obj;
         }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const source = obj;
         const result = {};
-        for (const key of Object.keys(obj)) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            result[key] = this.deepClone(obj[key], seen);
+        for (const key of Object.keys(source)) {
+            result[key] = this.deepClone(source[key], seen);
         }
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         seen.delete(obj);
         return result;
     }
@@ -165,7 +152,12 @@ class ObjectTransformer {
             else if (sourceValue &&
                 typeof sourceValue === "object" &&
                 sourceValue.constructor === Object) {
-                result[key] = this.mergeObjects(targetValue || {}, sourceValue, overwriteArrays);
+                // Merge into an existing object; anything else at this key (primitive, array,
+                // missing) is replaced by a copy of the source object.
+                result[key] =
+                    targetValue !== undefined && isPlainObject(targetValue)
+                        ? this.mergeObjects(targetValue, sourceValue, overwriteArrays)
+                        : this.deepClone(sourceValue);
             }
             else {
                 result[key] = sourceValue;

package/dist/utils/progress-tracker.js

@@ -3,7 +3,6 @@
  */
 class ProgressTracker {
     logToConsole;
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     logFrequency;
     _isUpdating;
     _pendingUpdates;
@@ -15,7 +14,6 @@ class ProgressTracker {
     success;
     failed;
     startTime;
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     endTime;
     lastUpdateTime;
     recentOperationTimes;
@@ -216,7 +214,8 @@ class ProgressTracker {
                 etaText = ` | ETA: ${Math.floor(eta / 3600)}h ${Math.floor((eta % 3600) / 60)}m`;
             }
         }
-        const spinner = final ? "[OK]" : this._spinnerFrames[this._spinnerIndex];
+        const finalLabel = this.failed > 0 ? "[ERR]" : "[OK]";
+        const spinner = final ? finalLabel : this._spinnerFrames[this._spinnerIndex];
         const text = `${spinner} ${langInfo}${bar} ${percent.toFixed(1)}% | ${this.completed}/${this.total} items | OK ${this.success} | ERR ${this.failed}${etaText}`;
         process.stderr.write("\r\x1b[K" + text);
         if (final) {

package/dist/utils/prompt-templates.d.ts

@@ -1,37 +1,77 @@
 /**
  * Prompt template utilities for translation and analysis
  */
+import type { CodeContext } from "../types/context.js";
+import type { FlatTranslationValue } from "./object-transformer.js";
+import type { LengthControlOptions } from "./quality/length-checker.js";
 export interface PromptOptions {
     mode?: "smart" | "strict" | "flexible" | "exact" | "relaxed";
-    lengthControl?: any;
+    lengthControl?: LengthControlOptions;
     targetLang?: string;
     detectedContext?: {
         category?: string;
         confidence?: number;
         prompt?: string;
-        existingTranslation?: string;
+        /** Current value in the target file; only a string triggers a revision request */
+        existingTranslation?: FlatTranslationValue;
         similarTranslation?: {
             source: string;
             target: string;
             similarity: number;
         };
+        /** Where the key is used in the project's source code (deep context) */
+        code?: CodeContext;
     };
     styleGuide?: {
         formality?: string;
         toneOfVoice?: string;
     };
-    categories?: Record<string, any>;
+    categories?: Record<string, unknown>;
     allowNewCategories?: boolean;
     model?: string;
     temperature?: number;
     maxTokens?: number;
 }
+export interface ChatMessage {
+    role: "system" | "user";
+    content: string;
+}
+/** OpenAI-compatible chat payload (OpenAI, DeepSeek, xAI, DashScope translation) */
+export interface ChatPrompt {
+    messages: ChatMessage[];
+}
+/** Anthropic Messages API payload: system prompt is a top-level field */
+export interface AnthropicPrompt {
+    system: string;
+    messages: ChatMessage[];
+}
+/** Gemini generateContent payload */
+export interface GeminiPrompt {
+    contents: {
+        parts: {
+            text: string;
+        }[];
+    }[];
+}
+/** DashScope native analysis payload */
+export interface DashScopeAnalysisPrompt {
+    model: string;
+    input: {
+        messages: ChatMessage[];
+    };
+    parameters: {
+        temperature: number;
+        max_tokens: number;
+    };
+}
+export type TranslationPromptPayload = ChatPrompt | AnthropicPrompt | GeminiPrompt;
+export type AnalysisPromptPayload = TranslationPromptPayload | DashScopeAnalysisPrompt;
 /**
  * Get translation prompt
  */
-declare const getPrompt: (provider: string, sourceLang: string, targetLang: string, text: string, options?: PromptOptions) => any;
+declare const getPrompt: (provider: string, sourceLang: string, targetLang: string, text: string, options?: PromptOptions) => TranslationPromptPayload;
 /**
  * Get analysis prompt
  */
-declare const getAnalysisPrompt: (provider: string, text: string, options?: PromptOptions) => any;
+declare const getAnalysisPrompt: (provider: string, text: string, options?: PromptOptions) => AnalysisPromptPayload;
 export { getPrompt, getAnalysisPrompt };

package/dist/utils/prompt-templates.js

@@ -52,11 +52,63 @@ const getLengthInstructions = (options) => {
             return templateFn();
         }
         catch (error) {
-            console.warn(`Error generating length template for mode ${mode}:`, error.message);
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`Error generating length template for mode ${mode}:`, message);
         }
     }
     return "TRANSLATION LENGTH: Keep translation concise and natural.";
 };
+/** What the prompt carries of a key's source-code usage (deep context). */
+const CODE_CONTEXT_LIMITS = {
+    /** Characters of the file path, of each comment and of the code snippet */
+    textLength: 200,
+    /** Characters of the component name and of each prop value */
+    nameLength: 100,
+    comments: 3,
+    props: 10,
+};
+/** `text` on one line, cut to `max` characters. */
+const clip = (text, max) => {
+    const line = text.replace(/\s+/g, " ").trim();
+    return line.length > max ? `${line.substring(0, max)}...` : line;
+};
+/**
+ * Where the key is used in the project's source code: file, component, comments, JSX props and
+ * a code snippet, cut to CODE_CONTEXT_LIMITS. Empty when the key was not found in the code.
+ */
+const getCodeContextInstructions = (code) => {
+    if (!code)
+        return "";
+    const { textLength, nameLength } = CODE_CONTEXT_LIMITS;
+    const lines = [`- File: ${clip(code.filePath, textLength)}:${code.line}`];
+    if (code.component) {
+        lines.push(`- Component: ${clip(code.component, nameLength)}`);
+    }
+    const comments = (code.comments ?? [])
+        .map((comment) => clip(comment, textLength))
+        .filter((comment) => comment.length > 0)
+        .slice(0, CODE_CONTEXT_LIMITS.comments);
+    if (comments.length > 0) {
+        lines.push(`- Comments: ${comments.map((comment) => `"${comment}"`).join("; ")}`);
+    }
+    const props = Object.entries(code.props ?? {})
+        .slice(0, CODE_CONTEXT_LIMITS.props)
+        .map(([name, value]) => 
+    // Expression values keep their braces: onClick={onDelete}
+    value.startsWith("{")
+        ? `${name}=${clip(value, nameLength)}`
+        : `${name}="${clip(value, nameLength)}"`);
+    if (props.length > 0) {
+        lines.push(`- JSX props: ${props.join(" ")}`);
+    }
+    if (code.usageSnippet) {
+        lines.push(`- Code: ${clip(code.usageSnippet, textLength)}`);
+    }
+    return `
+SOURCE CODE CONTEXT (where this text is used in the app; use it only to understand the text, do not translate it or include it in your answer):
+${lines.join("\n")}
+`;
+};
 /**
  * Base translation prompt template
  */
@@ -113,13 +165,14 @@ Please maintain consistency with this style and vocabulary where appropriate.`;
     }
     const formality = options.styleGuide?.formality || "neutral";
     const toneOfVoice = options.styleGuide?.toneOfVoice || "professional";
+    const codeContextInstructions = getCodeContextInstructions(options.detectedContext?.code);
     return `
 Translation Task: ${sourceLang} → ${targetLang}
 ${additionalInstructions}
 
 Category: ${safeContext.category}
 Context Instructions: ${safeContext.prompt}
-
+${codeContextInstructions}
 LENGTH CONTROL:
 ${lengthInstructions}
 
@@ -164,7 +217,8 @@ const baseAnalysisPromptTemplate = (text, options = {}) => {
             }
         }
         catch (error) {
-            console.warn("Error processing categories:", error.message);
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn("Error processing categories:", message);
         }
     }
     const maxTextLength = 1500;
@@ -401,7 +455,8 @@ const getPrompt = (provider, sourceLang, targetLang, text, options = {}) => {
         return promptGenerator(sourceLang, targetLang, text, options);
     }
     catch (error) {
-        console.error(`Error generating prompt for provider ${provider}:`, error.message);
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Error generating prompt for provider ${provider}:`, message);
         return translationPrompts.default(sourceLang, targetLang, text, options);
     }
 };
@@ -426,7 +481,8 @@ const getAnalysisPrompt = (provider, text, options = {}) => {
         return promptGenerator(text, options);
     }
     catch (error) {
-        console.error(`Error generating analysis prompt for provider ${provider}:`, error.message);
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Error generating analysis prompt for provider ${provider}:`, message);
         return analysisPrompts.default(text, options);
     }
 };

package/dist/utils/quality/base-checker.d.ts

@@ -2,45 +2,66 @@
  * Base Quality Checker.
  * Common infrastructure for all quality checkers.
  */
-export interface CheckerOptions {
+import type { ContextConfig } from "../../core/context-processor.js";
+import type { CodeBlockFixResult, CodeBlockIssue } from "./code-block-checker.js";
+import type { HtmlTagFixResult, HtmlTagIssue } from "./html-tag-checker.js";
+import type { LengthCheckOptions, LengthControlOptions, LengthIssue } from "./length-checker.js";
+import type { MarkdownFixResult, MarkdownIssue } from "./markdown-checker.js";
+import type { PlaceholderFixResult, PlaceholderIssue } from "./placeholder-checker.js";
+import type { PunctuationFixResult, PunctuationIssue } from "./punctuation-checker.js";
+import type { QuoteFixResult, QuoteIssue } from "./quote-balance-checker.js";
+import type { SpecialCharFixResult, SpecialCharIssue } from "./special-characters-checker.js";
+import type { StyleFixResult, StyleGuideConfig, StyleIssue } from "./style-guide-checker.js";
+/** Toggles for the individual quality checks (the `qualityChecks.rules` config section) */
+export interface QualityRules {
     placeholderConsistency?: boolean;
     htmlTagsConsistency?: boolean;
     punctuationCheck?: boolean;
+    quoteBalanceCheck?: boolean;
     lengthValidation?: boolean;
     sanitizeOutput?: boolean;
-    rules?: Record<string, any>;
-    styleGuide?: {
-        formality?: string;
-        toneOfVoice?: string;
-    };
-    context?: Record<string, any>;
-    [key: string]: any;
+    markdownPreservation?: boolean;
+    codeBlockPreservation?: boolean;
+    specialCharacters?: boolean;
+}
+export interface CheckerOptions extends QualityRules {
+    /** Master switch for quality checks (the `qualityChecks.enabled` config value) */
+    enabled?: boolean;
+    styleGuide?: StyleGuideConfig;
+    context?: Partial<ContextConfig>;
+    lengthControl?: LengthControlOptions;
 }
+/** Generic issue record built by {@link BaseChecker.createIssue} */
 export interface Issue {
     type: string;
     message: string;
     timestamp: string;
-    [key: string]: any;
+    [key: string]: unknown;
 }
+/** Generic fix record built by {@link BaseChecker.createFix} */
 export interface Fix {
     type: string;
     message: string;
     timestamp: string;
-    [key: string]: any;
+    [key: string]: unknown;
 }
+/** Any issue reported by one of the quality checkers */
+export type QualityIssue = PlaceholderIssue | HtmlTagIssue | PunctuationIssue | QuoteIssue | LengthIssue | StyleIssue | MarkdownIssue | CodeBlockIssue | SpecialCharIssue;
+/** Any fix applied by one of the quality checkers */
+export type QualityFix = PlaceholderFixResult["appliedFixes"][number] | HtmlTagFixResult["appliedFixes"][number] | PunctuationFixResult["appliedFixes"][number] | QuoteFixResult["appliedFixes"][number] | StyleFixResult["appliedFixes"][number] | MarkdownFixResult["appliedFixes"][number] | CodeBlockFixResult["appliedFixes"][number] | SpecialCharFixResult["appliedFixes"][number];
 export interface ValidationResult {
     isValid: boolean;
-    issues: Issue[];
+    issues: QualityIssue[];
     source?: string;
     translated?: string;
-    context?: Record<string, any>;
+    context?: Partial<ContextConfig>;
 }
 export interface FixResult {
     originalText: string;
     fixedText: string;
     isModified: boolean;
-    issues: Issue[];
-    fixes: Fix[];
+    issues: QualityIssue[];
+    fixes: QualityFix[];
     metadata?: {
         sourceLength: number;
         originalLength: number;
@@ -49,7 +70,8 @@ export interface FixResult {
     };
 }
 declare class BaseChecker {
-    protected rules: Record<string, boolean | any>;
+    /** Effective options: rule defaults overridden by the constructor options */
+    readonly rules: CheckerOptions;
     protected styleGuide: {
         formality: string;
         toneOfVoice: string;
@@ -62,15 +84,15 @@ declare class BaseChecker {
     /**
      * Create an issue object.
      */
-    createIssue(type: string, message: string, details?: Record<string, any>): Issue;
+    createIssue(type: string, message: string, details?: Record<string, unknown>): Issue;
     /**
      * Create a fix object.
      */
-    createFix(type: string, message: string, details?: Record<string, any>): Fix;
+    createFix(type: string, message: string, details?: Record<string, unknown>): Fix;
     /**
      * Validate translation.
      */
-    validate(_sourceText: string, _translatedText: string, _options?: any): ValidationResult;
+    validate(_sourceText: string, _translatedText: string, _options?: LengthCheckOptions): ValidationResult;
     /**
      * Validate and fix translation.
      */

package/dist/utils/quality/base-checker.js

@@ -3,6 +3,7 @@
  * Common infrastructure for all quality checkers.
  */
 class BaseChecker {
+    /** Effective options: rule defaults overridden by the constructor options */
     rules;
     styleGuide;
     /**
@@ -48,7 +49,6 @@ class BaseChecker {
     /**
      * Validate translation.
      */
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     validate(_sourceText, _translatedText, _options) {
         const issues = [];
         return {
@@ -59,7 +59,6 @@ class BaseChecker {
     /**
      * Validate and fix translation.
      */
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     validateAndFix(sourceText, translatedText) {
         return {
             originalText: translatedText,