locai 2.1.2 → 2.1.3

package/dist/core/pipeline/context.d.ts

@@ -0,0 +1,29 @@
+export interface TranslationResult {
+    key: string;
+    translated: string | null;
+    success: boolean;
+    context: Record<string, any>;
+    error?: string;
+    fromCache?: boolean;
+    qualityChecks?: any;
+    meta?: Record<string, any>;
+}
+export interface TranslationContext {
+    key: string;
+    sourceText: string;
+    sourceLang: string;
+    targetLang: string;
+    options: any;
+    meta: Record<string, any>;
+    existingTranslation: any;
+    result: TranslationResult;
+    protectedText?: string;
+    termMap?: Map<string, any>;
+    translatedText?: string;
+    success?: boolean;
+    error?: string;
+    fromCache?: boolean;
+    qualityChecks?: any;
+    [key: string]: any;
+}
+export declare const createTranslationContext: (key: string, sourceText: string, sourceLang: string, targetLang: string, options: any, meta?: Record<string, any>, existingTranslation?: any) => TranslationContext;

package/dist/core/pipeline/steps/CacheReadStep.d.ts

@@ -0,0 +1,25 @@
+import PipelineStep from "../PipelineStep.js";
+import { TranslationContext } from "../context.js";
+export interface CacheStats {
+    hits: number;
+    staleHits: number;
+    misses: number;
+    stored: number;
+    [key: string]: any;
+}
+export interface Cache {
+    has(key: string): boolean;
+    get(key: string): any;
+    set(key: string, value: any, options?: any): void;
+    delete(key: string): void;
+    getRemainingTTL?(key: string): number;
+}
+declare class CacheReadStep extends PipelineStep {
+    private cache;
+    private stats;
+    private options;
+    constructor(cache: Cache, cacheStats: CacheStats, options?: any);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+    _generateCacheKey(text: string, targetLang: string, category?: string): string;
+}
+export default CacheReadStep;

package/dist/core/pipeline/steps/CacheWriteStep.d.ts

@@ -0,0 +1,11 @@
+import PipelineStep from "../PipelineStep.js";
+import { TranslationContext } from "../context.js";
+import { Cache, CacheStats } from "./CacheReadStep.js";
+declare class CacheWriteStep extends PipelineStep {
+    private cache;
+    private stats;
+    private options;
+    constructor(cache: Cache, cacheStats: CacheStats, options?: any);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+}
+export default CacheWriteStep;

package/dist/core/pipeline/steps/ConfidenceCheckStep.d.ts

@@ -0,0 +1,10 @@
+import PipelineStep from "../PipelineStep.js";
+import { TranslationContext } from "../context.js";
+import { ConfidenceSettings } from "./TranslationStep.js";
+declare class ConfidenceCheckStep extends PipelineStep {
+    private confidenceSettings;
+    private debug;
+    constructor(confidenceSettings: Partial<ConfidenceSettings>, debug?: boolean);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+}
+export default ConfidenceCheckStep;

package/dist/core/pipeline/steps/GlossaryPostStep.d.ts

@@ -0,0 +1,9 @@
+import PipelineStep from "../PipelineStep.js";
+import GlossaryManager from "../../../utils/glossary-manager.js";
+import { TranslationContext } from "../context.js";
+declare class GlossaryPostStep extends PipelineStep {
+    private glossaryManager?;
+    constructor(glossaryManager?: GlossaryManager | null);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+}
+export default GlossaryPostStep;

package/dist/core/pipeline/steps/GlossaryPreStep.d.ts

@@ -0,0 +1,9 @@
+import PipelineStep from "../PipelineStep.js";
+import GlossaryManager from "../../../utils/glossary-manager.js";
+import { TranslationContext } from "../context.js";
+declare class GlossaryPreStep extends PipelineStep {
+    private glossaryManager?;
+    constructor(glossaryManager?: GlossaryManager | null);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+}
+export default GlossaryPreStep;

package/dist/core/pipeline/steps/InputValidationStep.d.ts

@@ -0,0 +1,8 @@
+import PipelineStep from "../PipelineStep.js";
+import { TranslationContext } from "../context.js";
+declare class InputValidationStep extends PipelineStep {
+    private maxKeyLength;
+    constructor(maxKeyLength?: number);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+}
+export default InputValidationStep;

package/dist/core/pipeline/steps/QualityCheckStep.d.ts

@@ -0,0 +1,10 @@
+import PipelineStep from "../PipelineStep.js";
+import { TranslationContext } from "../context.js";
+import QualityChecker from "../../../utils/quality/index.js";
+declare class QualityCheckStep extends PipelineStep {
+    private qualityChecker;
+    private debug;
+    constructor(qualityChecker: QualityChecker | any, debug?: boolean);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+}
+export default QualityCheckStep;

package/dist/core/pipeline/steps/ToneCheckStep.d.ts

@@ -0,0 +1,13 @@
+import PipelineStep from "../PipelineStep.js";
+import { TranslationContext } from "../context.js";
+export declare class ToneCheckStep extends PipelineStep {
+    private verifier;
+    private enabled;
+    private debug;
+    constructor(config?: {
+        enabled?: boolean;
+        debug?: boolean;
+    });
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+}
+export default ToneCheckStep;

package/dist/core/pipeline/steps/TranslationStep.d.ts

@@ -0,0 +1,22 @@
+import PipelineStep from "../PipelineStep.js";
+import { AIProvider } from "../../provider-factory.js";
+import { TranslationContext } from "../context.js";
+export interface ConfidenceSettings {
+    enabled: boolean;
+    autoApproveThreshold: number;
+    rejectThreshold: number;
+    reviewThreshold: number;
+    saveReviewQueue: boolean;
+    reviewQueue: any[];
+    autoApprovedCount: number;
+    rejectedCount: number;
+    [key: string]: any;
+}
+declare class TranslationStep extends PipelineStep {
+    private options;
+    private confidenceSettings;
+    constructor(options?: any, confidenceSettings?: Partial<ConfidenceSettings>);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+    _getProvider(): AIProvider;
+}
+export default TranslationStep;

package/dist/core/pipeline/steps/VectorCacheReadStep.d.ts

@@ -0,0 +1,17 @@
+import PipelineStep from "../PipelineStep.js";
+import { TranslationContext } from "../context.js";
+import { VectorStore } from "../../../services/vector-store.js";
+import { EmbeddingProvider } from "../../../services/embedding-provider.js";
+export interface VectorMemoryStats {
+    hits: number;
+    contextUsed: number;
+    misses: number;
+}
+export declare class VectorCacheReadStep extends PipelineStep {
+    private vectorStore;
+    private embeddingProvider;
+    private stats;
+    private options;
+    constructor(vectorStore: VectorStore, embeddingProvider: EmbeddingProvider, stats: VectorMemoryStats, options?: any);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+}

package/dist/core/pipeline/steps/VectorCacheWriteStep.d.ts

@@ -0,0 +1,11 @@
+import PipelineStep from "../PipelineStep.js";
+import { TranslationContext } from "../context.js";
+import { VectorStore } from "../../../services/vector-store.js";
+import { EmbeddingProvider } from "../../../services/embedding-provider.js";
+export declare class VectorCacheWriteStep extends PipelineStep {
+    private vectorStore;
+    private embeddingProvider;
+    private options;
+    constructor(vectorStore: VectorStore, embeddingProvider: EmbeddingProvider, options?: any);
+    execute(context: TranslationContext, next: () => Promise<void>): Promise<void>;
+}

package/dist/core/pipeline/steps/__tests__/ToneCheckStep.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/provider-factory.d.ts

@@ -0,0 +1,41 @@
+import { ProviderConfig, TranslateOptions } from "../providers/base-provider.js";
+export interface AIProvider {
+    translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+    analyze?(prompt: string, options?: ProviderConfig): Promise<string>;
+    chat?(messages: any[], options?: ProviderConfig): Promise<string>;
+}
+/**
+ * Factory for creating and managing AI providers.
+ * Handles provider instantiation, configuration, and fallback chains.
+ */
+declare class ProviderFactory {
+    /**
+     * Get provider instance with intelligent fallback support.
+     * @param {string} providerName - Name of the primary provider.
+     * @param {boolean} [useFallback=true] - Whether to use fallback chain on failure.
+     * @param {Object} [config=null] - Optional configuration overrides.
+     * @returns {AIProvider} - Provider instance or wrapped FallbackProvider.
+     * @throws {Error} If provider is not found or configured.
+     */
+    static getProvider(providerName: string, useFallback?: boolean, config?: {
+        fallbackOrder?: string[];
+    } | null): AIProvider;
+    /**
+     * Get list of available (configured) providers.
+     * @returns {string[]} - Array of provider names with valid API keys.
+     */
+    static getAvailableProviders(): string[];
+    /**
+     * Validate that at least one provider is configured.
+     * @returns {string[]} - Array of available providers.
+     * @throws {Error} If no providers are configured.
+     */
+    static validateProviders(): string[];
+    /**
+     * Check if a specific provider is configured.
+     * @param {string} providerName - Name of the provider.
+     * @returns {boolean} - True if provider has an API key configured.
+     */
+    static isProviderConfigured(providerName: string): boolean;
+}
+export default ProviderFactory;

package/dist/providers/base-provider.d.ts

@@ -0,0 +1,66 @@
+export interface ProviderConfig {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    [key: string]: any;
+}
+export interface TranslateOptions {
+    detectedContext?: {
+        category?: string;
+        [key: string]: any;
+    };
+    lengthControl?: {
+        mode?: string;
+        [key: string]: any;
+    };
+    apiConfig?: Record<string, any>;
+    retryOptions?: {
+        maxRetries?: number;
+        initialDelay?: number;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+export interface ConfidenceResult {
+    score: number;
+    metrics?: any;
+    [key: string]: any;
+}
+export interface TranslationResult {
+    translation: string;
+    confidence: ConfidenceResult;
+    rawResponse: any;
+}
+declare class BaseProvider {
+    name: string;
+    config: ProviderConfig;
+    defaultModel?: string;
+    defaultTemperature: number;
+    defaultMaxTokens: number;
+    commonHeaders: Record<string, string>;
+    constructor(name: string, config?: ProviderConfig);
+    translate(text: string, sourceLang: string, targetLang: string, _options?: TranslateOptions): Promise<string>;
+    analyze(prompt: string, options?: any): Promise<string>;
+    chat(messages: any[], options?: any): Promise<string>;
+    getApiKey(): string | undefined;
+    getEndpoint(): string;
+    validateRequest(text: string, sourceLang: string, targetLang: string): void;
+    validateResponse(response: any, providerName: string): boolean;
+    handleApiError(error: any, providerName: string): never;
+    generatePrompt(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): string;
+    getConfig(options?: ProviderConfig): {
+        model: string | undefined;
+        temperature: number;
+        maxTokens: number;
+        max_tokens: number;
+        apiKey: string;
+        endpoint: string;
+    };
+    extractTranslation(response: any, providerName: string): string;
+    /**
+     * Extract translation with confidence score
+     */
+    extractTranslationWithConfidence(response: any, providerName: string, sourceText: string, sourceLang: string, targetLang: string, category?: string): TranslationResult;
+    sanitizeTranslation(translation: string): string;
+}
+export default BaseProvider;

package/dist/providers/dashscope.d.ts

@@ -0,0 +1,24 @@
+import BaseProvider, { ProviderConfig, TranslateOptions } from "./base-provider.js";
+/**
+ * Provider implementation for Alibaba DashScope (Qwen) models.
+ */
+declare class DashScopeProvider extends BaseProvider {
+    private client;
+    private generationClient;
+    /**
+     * Create a new DashScopeProvider instance.
+     * @param {ProviderConfig} config - Provider configuration.
+     */
+    constructor(config?: ProviderConfig);
+    getApiKey(): string | undefined;
+    getEndpoint(): string;
+    getGenerationEndpoint(): string;
+    /**
+     * Translate text using DashScope.
+     */
+    translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+    analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+}
+declare function translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+declare function analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+export { translate, analyze, DashScopeProvider };

package/dist/providers/deepseek.d.ts

@@ -0,0 +1,22 @@
+import BaseProvider, { ProviderConfig, TranslateOptions } from "./base-provider.js";
+/**
+ * Provider implementation for DeepSeek API.
+ */
+declare class DeepSeekProvider extends BaseProvider {
+    private client;
+    /**
+     * Create a new DeepSeekProvider instance.
+     * @param {ProviderConfig} config - Provider configuration.
+     */
+    constructor(config?: ProviderConfig);
+    getApiKey(): string | undefined;
+    getEndpoint(): string;
+    /**
+     * Translate text using DeepSeek.
+     */
+    translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+    analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+}
+declare function translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+declare function analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+export { translate, analyze, DeepSeekProvider };

package/dist/providers/gemini.d.ts

@@ -0,0 +1,22 @@
+import BaseProvider, { ProviderConfig, TranslateOptions } from "./base-provider.js";
+/**
+ * Provider implementation for Google Gemini models.
+ */
+declare class GeminiProvider extends BaseProvider {
+    private client;
+    /**
+     * Create a new GeminiProvider instance.
+     * @param {ProviderConfig} config - Provider configuration.
+     */
+    constructor(config?: ProviderConfig);
+    getApiKey(): string | undefined;
+    getEndpoint(model?: string): string;
+    /**
+     * Translate text using Gemini.
+     */
+    translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+    analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+}
+declare function translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+declare function analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+export { translate, analyze, GeminiProvider };

package/dist/providers/openai.d.ts

@@ -0,0 +1,28 @@
+import BaseProvider, { ProviderConfig, TranslateOptions } from "./base-provider.js";
+/**
+ * Provider implementation for OpenAI (GPT) models.
+ */
+declare class OpenAIProvider extends BaseProvider {
+    private client;
+    /**
+     * Create a new OpenAIProvider instance.
+     * @param {ProviderConfig} config - Provider configuration.
+     */
+    constructor(config?: ProviderConfig);
+    getApiKey(): string | undefined;
+    getEndpoint(): string;
+    /**
+     * Translate text using OpenAI.
+     */
+    translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+    analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+    chat(messages: any[], options?: ProviderConfig): Promise<string>;
+    embed(text: string, options?: ProviderConfig): Promise<number[]>;
+    embedBatch(texts: string[], options?: ProviderConfig): Promise<number[][]>;
+}
+declare function translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+declare function analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+declare function chat(messages: any[], options?: ProviderConfig): Promise<string>;
+declare function embed(text: string, options?: ProviderConfig): Promise<number[]>;
+declare function embedBatch(texts: string[], options?: ProviderConfig): Promise<number[][]>;
+export { translate, analyze, chat, embed, embedBatch, OpenAIProvider };

package/dist/providers/xai.d.ts

@@ -0,0 +1,22 @@
+import BaseProvider, { ProviderConfig, TranslateOptions } from "./base-provider.js";
+/**
+ * Provider implementation for X.AI (Grok) models.
+ */
+declare class XAIProvider extends BaseProvider {
+    private client;
+    /**
+     * Create a new XAIProvider instance.
+     * @param {ProviderConfig} config - Provider configuration.
+     */
+    constructor(config?: ProviderConfig);
+    getApiKey(): string | undefined;
+    getEndpoint(): string;
+    /**
+     * Translate text using X.AI.
+     */
+    translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+    analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+}
+declare function translate(text: string, sourceLang: string, targetLang: string, options?: TranslateOptions): Promise<string>;
+declare function analyze(prompt: string, options?: ProviderConfig): Promise<string>;
+export { translate, analyze, XAIProvider };

package/dist/services/embedding-provider.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Interface for embedding providers
+ */
+export interface IEmbeddingProvider {
+    getEmbedding(text: string): Promise<number[]>;
+    getEmbeddings(texts: string[]): Promise<number[][]>;
+}
+/**
+ * Service to generate embeddings for text
+ */
+export declare class EmbeddingProvider implements IEmbeddingProvider {
+    private provider;
+    private model;
+    constructor(config?: {
+        provider?: string;
+        model?: string;
+    });
+    /**
+     * Get embedding for a single text
+     */
+    getEmbedding(text: string): Promise<number[]>;
+    /**
+     * Get embeddings for multiple texts (batch)
+     */
+    getEmbeddings(texts: string[]): Promise<number[][]>;
+}

package/dist/services/translation-service.d.ts

@@ -0,0 +1,138 @@
+import Orchestrator from "../core/orchestrator.js";
+import { OrchestratorOptions } from "../core/orchestrator.js";
+import StateManager from "../utils/state-manager.js";
+export interface TranslationOptions extends OrchestratorOptions {
+    source: string;
+    targets?: string[];
+    localesDir?: string;
+    debug?: boolean;
+    forceUpdate?: boolean;
+    syncOptions?: {
+        enabled?: boolean;
+        removeDeletedKeys?: boolean;
+    };
+    concurrencyLimit?: number;
+    saveReviewQueue?: boolean;
+    minConfidence?: number;
+    fileExtensions?: string[];
+}
+export interface GlobalStats {
+    total: number;
+    success: number;
+    failed: number;
+    skipped: number;
+    languages: Record<string, any>;
+    byCategory: Record<string, number>;
+    details: Record<string, {
+        totalConfidence: number;
+        samples: number;
+    }>;
+    error?: {
+        message: string;
+        time: string;
+        stack?: string;
+    };
+    orchestrators: any[];
+    endTime?: string;
+    totalDuration?: number;
+    totalTime: number;
+    startTime: string;
+}
+interface LanguageProcessResult {
+    status: any;
+    savedMessage?: string;
+    error?: string;
+}
+/**
+ * Service for handling file translation operations.
+ * Orchestrates the translation process including state management,
+ * verification, and statistics collection.
+ */
+declare class TranslationService {
+    /**
+     * Check if text only contains placeholders and whitespace.
+     * @param {string} text - Text to check.
+     * @returns {boolean} - True if text only contains placeholders.
+     */
+    isPlaceholderOnlyText(text: string): boolean;
+    /**
+     * Main translator function to process source file and create translations.
+     * @param {string} file - Path to source file.
+     * @param {TranslationOptions} options - Translation options.
+     * @returns {Promise<GlobalStats>} - Global statistics object.
+     * @throws {Error} If validation fails or translation process errors.
+     */
+    translateFile(file: string, options: TranslationOptions): Promise<GlobalStats>;
+    /**
+     * Validate input parameters for translation process.
+     * @param {string} file - Path to source file.
+     * @param {TranslationOptions} options - Translation options.
+     * @returns {Promise<string>} - Resolved absolute path to source file.
+     * @throws {Error} If inputs are invalid.
+     */
+    validateTranslationInputs(file: string, options: TranslationOptions): Promise<string>;
+    /**
+     * Initialize translation state and sync analysis.
+     * @param {string} resolvedFile - Path to resolved source file.
+     * @param {Record<string, any>} flattenedSource - Flattened source content.
+     * @param {TranslationOptions} options - Translation options.
+     * @returns {Promise<Object>} - Initialized state components.
+     */
+    initializeTranslationState(resolvedFile: string, flattenedSource: Record<string, any>, options: TranslationOptions): Promise<{
+        stateManager: StateManager;
+        projectRoot: string;
+        currentState: Record<string, string>;
+        comparison: import("../utils/state-manager.js").StateComparison;
+    }>;
+    /**
+     * Process all target languages with concurrency.
+     * @param {string} resolvedFile - Path to source file.
+     * @param {Record<string, any>} flattenedSource - Flattened source content.
+     * @param {TranslationOptions} options - Translation options.
+     * @param {GlobalStats} globalStats - Global statistics object to update.
+     * @param {any} comparison - State comparison result.
+     */
+    processAllLanguages(resolvedFile: string, flattenedSource: Record<string, any>, options: TranslationOptions, globalStats: GlobalStats, comparison: any): Promise<void>;
+    /**
+     * Process a single language translation.
+     * @param {string} targetLang - Target language code.
+     * @param {string} sourceFile - Path to source file.
+     * @param {Record<string, any>} flattenedSource - Flattened source content.
+     * @param {Orchestrator} orchestrator - Orchestrator instance.
+     * @param {TranslationOptions} options - Translation options.
+     * @param {GlobalStats} globalStats - Global statistics object.
+     * @param {any} comparison - State comparison result.
+     * @returns {Promise<LanguageProcessResult>} - Status and messages for this language.
+     */
+    processLanguage(targetLang: string, sourceFile: string, flattenedSource: Record<string, any>, orchestrator: Orchestrator, options: TranslationOptions, globalStats: GlobalStats, comparison: any): Promise<LanguageProcessResult>;
+    /**
+     * Finalize translation process and save state.
+     * @param {StateManager} stateManager - State manager instance.
+     * @param {string} projectRoot - Project root directory.
+     * @param {any} currentState - Current state object.
+     * @param {GlobalStats} globalStats - Global statistics object.
+     * @param {number} startTime - Process start timestamp.
+     * @param {TranslationOptions} options - Translation options.
+     */
+    finalizeTranslation(stateManager: StateManager, projectRoot: string, currentState: any, globalStats: GlobalStats, startTime: number, options: TranslationOptions): Promise<void>;
+    /**
+     * Remove deleted keys from all target language files.
+     * @param {string} sourceFile - Path to source file.
+     * @param {string[]} deletedKeys - Array of keys to delete.
+     * @param {TranslationOptions} options - Translation options.
+     */
+    removeDeletedKeysFromTargets(sourceFile: string, deletedKeys: string[], options: TranslationOptions): Promise<void>;
+    /**
+     * Validate and fix existing translations that have length issues.
+     * @param {string} file - Path to source file.
+     * @param {TranslationOptions} options - Translation options.
+     * @throws {Error} If validation process fails.
+     */
+    validateAndFixExistingTranslations(file: string, options: TranslationOptions): Promise<void>;
+    /**
+     * Find locale files
+     */
+    findLocaleFiles(localesDir: string, sourceLang: string): Promise<string[]>;
+}
+declare const _default: TranslationService;
+export default _default;

package/dist/services/vector-store.d.ts

@@ -0,0 +1,26 @@
+export interface VectorStoreConfig {
+    enabled: boolean;
+    vectorDbPath: string;
+    similarityThreshold?: number;
+    exactMatchThreshold?: number;
+}
+export interface SearchResult {
+    item: {
+        text: string;
+        translation: string;
+        sourceLang: string;
+        targetLang: string;
+        metadata?: any;
+    };
+    score: number;
+}
+export declare class VectorStore {
+    private index;
+    private config;
+    private initialized;
+    private readonly DIMENSION;
+    constructor(config: VectorStoreConfig);
+    initialize(): Promise<void>;
+    addItem(text: string, translation: string, sourceLang: string, targetLang: string, embedding: number[], metadata?: any): Promise<void>;
+    search(embedding: number[], targetLang: string, limit?: number): Promise<SearchResult[]>;
+}