specweave 0.22.13 → 0.23.0

package/plugins/specweave/lib/vendor/generators/spec/task-parser.js

@@ -0,0 +1,301 @@
+/**
+ * Task Parser with US-Task Linkage Support
+ *
+ * Parses tasks.md files to extract task metadata including new US linkage fields:
+ * - userStory: US-ID this task implements (e.g., "US-001")
+ * - satisfiesACs: List of AC-IDs this task satisfies (e.g., ["AC-US1-01", "AC-US1-02"])
+ *
+ * Supports hierarchical task structure grouped by User Story.
+ */
+import { readFileSync } from 'fs';
+/**
+ * Parse tasks.md and extract all tasks with US linkage
+ *
+ * @param tasksPath - Path to tasks.md file
+ * @returns Map of User Story ID → Tasks
+ * @throws Error if tasks.md cannot be read or is malformed
+ */
+export function parseTasksWithUSLinks(tasksPath) {
+    try {
+        const content = readFileSync(tasksPath, 'utf-8');
+        const tasks = {};
+        // Split content into lines for line number tracking
+        const lines = content.split('\n');
+        // Regex patterns for task parsing (T-029: Support E suffix for external IDs)
+        const taskHeaderRegex = /^###\s+(T-\d{3}E?):\s*(.+)$/;
+        const userStoryRegex = /^\*\*User Story\*\*:\s*(US-\d{3}E?)/;
+        const satisfiesACsRegex = /^\*\*Satisfies ACs\*\*:\s*(AC-US\d+E?-\d{2}(?:,\s*AC-US\d+E?-\d{2})*)/;
+        const statusRegex = /^\*\*Status\*\*:\s*\[([x ])\]\s*(\w+)/;
+        const priorityRegex = /^\*\*Priority\*\*:\s*(.+)/;
+        const estimatedEffortRegex = /^\*\*Estimated Effort\*\*:\s*(.+)/;
+        const dependenciesRegex = /^\*\*Dependencies\*\*:\s*(.+)/;
+        let currentTask = null;
+        let currentDescription = [];
+        let currentSection = 'none';
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNumber = i + 1;
+            // Check for task header (### T-XXX: Title)
+            const taskHeaderMatch = line.match(taskHeaderRegex);
+            if (taskHeaderMatch) {
+                // Save previous task if exists
+                if (currentTask) {
+                    saveTask(tasks, currentTask, currentDescription);
+                }
+                // Start new task
+                currentTask = {
+                    id: taskHeaderMatch[1],
+                    title: taskHeaderMatch[2],
+                    status: 'pending',
+                    lineNumber
+                };
+                currentDescription = [];
+                currentSection = 'none';
+                continue;
+            }
+            // Skip if no current task
+            if (!currentTask)
+                continue;
+            // Parse task fields
+            const userStoryMatch = line.match(userStoryRegex);
+            if (userStoryMatch) {
+                currentTask.userStory = userStoryMatch[1];
+                continue;
+            }
+            const satisfiesACsMatch = line.match(satisfiesACsRegex);
+            if (satisfiesACsMatch) {
+                // Split comma-separated AC-IDs and trim whitespace
+                currentTask.satisfiesACs = satisfiesACsMatch[1]
+                    .split(',')
+                    .map(ac => ac.trim());
+                continue;
+            }
+            const statusMatch = line.match(statusRegex);
+            if (statusMatch) {
+                const checkbox = statusMatch[1];
+                const statusText = statusMatch[2].toLowerCase();
+                // Map checkbox and status text to TaskStatus
+                if (checkbox === 'x') {
+                    currentTask.status = 'completed';
+                }
+                else if (statusText.includes('progress')) {
+                    currentTask.status = 'in_progress';
+                }
+                else if (statusText.includes('transfer')) {
+                    currentTask.status = 'transferred';
+                }
+                else if (statusText.includes('cancel')) {
+                    currentTask.status = 'canceled';
+                }
+                else {
+                    currentTask.status = 'pending';
+                }
+                continue;
+            }
+            const priorityMatch = line.match(priorityRegex);
+            if (priorityMatch) {
+                currentTask.priority = priorityMatch[1];
+                continue;
+            }
+            const estimatedEffortMatch = line.match(estimatedEffortRegex);
+            if (estimatedEffortMatch) {
+                currentTask.estimatedEffort = estimatedEffortMatch[1];
+                continue;
+            }
+            const dependenciesMatch = line.match(dependenciesRegex);
+            if (dependenciesMatch) {
+                // Parse dependencies (T-001, T-002, etc.)
+                currentTask.dependencies = dependenciesMatch[1]
+                    .split(',')
+                    .map(dep => dep.trim())
+                    .filter(dep => dep.match(/^T-\d{3}$/));
+                continue;
+            }
+            // Track sections for description parsing
+            if (line.startsWith('**Description**:')) {
+                currentSection = 'description';
+                continue;
+            }
+            if (line.startsWith('**Implementation Steps**:')) {
+                currentSection = 'implementation';
+                continue;
+            }
+            if (line.startsWith('**Test Plan**:')) {
+                currentSection = 'test';
+                continue;
+            }
+            if (line.startsWith('**Files Affected**:')) {
+                currentSection = 'files';
+                currentTask.filesAffected = [];
+                continue;
+            }
+            // Collect description lines
+            if (currentSection === 'description' && line.trim() && !line.startsWith('**')) {
+                currentDescription.push(line.trim());
+            }
+            // Collect files affected
+            if (currentSection === 'files' && line.trim().startsWith('- `')) {
+                const filePath = line.trim().replace(/^- `(.+)`/, '$1');
+                if (currentTask.filesAffected) {
+                    currentTask.filesAffected.push(filePath);
+                }
+            }
+        }
+        // Save last task
+        if (currentTask) {
+            saveTask(tasks, currentTask, currentDescription);
+        }
+        return tasks;
+    }
+    catch (error) {
+        throw new Error(`Failed to parse tasks.md at ${tasksPath}: ${error}`);
+    }
+}
+/**
+ * Helper: Save task to tasks map, grouped by User Story
+ */
+function saveTask(tasks, task, description) {
+    // Set description
+    if (description.length > 0) {
+        task.description = description.join(' ');
+    }
+    // Group by User Story (or "unassigned" if no userStory field)
+    const usId = task.userStory || 'unassigned';
+    if (!tasks[usId]) {
+        tasks[usId] = [];
+    }
+    tasks[usId].push(task);
+}
+/**
+ * Validate task US and AC linkage
+ *
+ * @param task - Task to validate
+ * @param validUSIds - List of valid US-IDs from spec.md
+ * @param validACIds - List of valid AC-IDs from spec.md
+ * @returns Array of validation errors (empty if valid)
+ */
+export function validateTaskLinkage(task, validUSIds, validACIds) {
+    const errors = [];
+    // Validate userStory field
+    if (task.userStory) {
+        // Check format (US-XXX)
+        if (!task.userStory.match(/^US-\d{3}$/)) {
+            errors.push({
+                taskId: task.id,
+                field: 'userStory',
+                value: task.userStory,
+                message: `Invalid US-ID format: "${task.userStory}" (expected format: US-001)`,
+                suggestedFix: 'Use format: US-XXX where XXX is a 3-digit number'
+            });
+        }
+        // Check if US exists in spec.md
+        else if (!validUSIds.includes(task.userStory)) {
+            errors.push({
+                taskId: task.id,
+                field: 'userStory',
+                value: task.userStory,
+                message: `User Story ${task.userStory} not found in spec.md`,
+                suggestedFix: `Valid User Stories: ${validUSIds.join(', ')}`
+            });
+        }
+    }
+    // Validate satisfiesACs field
+    if (task.satisfiesACs && task.satisfiesACs.length > 0) {
+        for (const acId of task.satisfiesACs) {
+            // Check format (AC-USXX-YY)
+            if (!acId.match(/^AC-US\d+-\d{2}$/)) {
+                errors.push({
+                    taskId: task.id,
+                    field: 'satisfiesACs',
+                    value: acId,
+                    message: `Invalid AC-ID format: "${acId}" (expected format: AC-US1-01)`,
+                    suggestedFix: 'Use format: AC-USXX-YY where XX is US number, YY is AC number'
+                });
+                continue;
+            }
+            // Check if AC exists in spec.md
+            if (!validACIds.includes(acId)) {
+                errors.push({
+                    taskId: task.id,
+                    field: 'satisfiesACs',
+                    value: acId,
+                    message: `Acceptance Criteria ${acId} not found in spec.md`,
+                    suggestedFix: `Check spec.md for valid AC-IDs in this User Story`
+                });
+                continue;
+            }
+            // Check if AC belongs to correct User Story
+            if (task.userStory) {
+                const acUSNumber = extractUSNumberFromACId(acId);
+                const taskUSNumber = extractUSNumber(task.userStory);
+                if (acUSNumber !== taskUSNumber) {
+                    errors.push({
+                        taskId: task.id,
+                        field: 'satisfiesACs',
+                        value: acId,
+                        message: `AC ${acId} belongs to US-${String(acUSNumber).padStart(3, '0')}, but task is linked to ${task.userStory}`,
+                        suggestedFix: `Either link task to US-${String(acUSNumber).padStart(3, '0')} or use different AC-ID`
+                    });
+                }
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Extract US number from AC-ID (AC-US1-01 → 1)
+ */
+function extractUSNumberFromACId(acId) {
+    const match = acId.match(/^AC-US(\d+)-\d{2}$/);
+    return match ? parseInt(match[1], 10) : -1;
+}
+/**
+ * Extract US number from US-ID (US-001 → 1)
+ */
+function extractUSNumber(usId) {
+    const match = usId.match(/^US-(\d{3})$/);
+    return match ? parseInt(match[1], 10) : -1;
+}
+/**
+ * Get all tasks (flattened, not grouped by US)
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Array of all tasks
+ */
+export function getAllTasks(tasksByUS) {
+    return Object.values(tasksByUS).flat();
+}
+/**
+ * Count tasks by status
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Map of status → count
+ */
+export function countTasksByStatus(tasksByUS) {
+    const counts = {
+        pending: 0,
+        in_progress: 0,
+        completed: 0,
+        transferred: 0,
+        canceled: 0
+    };
+    const allTasks = getAllTasks(tasksByUS);
+    allTasks.forEach(task => {
+        counts[task.status]++;
+    });
+    return counts;
+}
+/**
+ * Calculate completion percentage
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Completion percentage (0-100)
+ */
+export function calculateCompletionPercentage(tasksByUS) {
+    const allTasks = getAllTasks(tasksByUS);
+    if (allTasks.length === 0)
+        return 0;
+    const completedTasks = allTasks.filter(t => t.status === 'completed').length;
+    return Math.round((completedTasks / allTasks.length) * 100);
+}
+//# sourceMappingURL=task-parser.js.map

package/plugins/specweave/lib/vendor/generators/spec/task-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-parser.js","sourceRoot":"","sources":["../../../../src/generators/spec/task-parser.ts"],"names":[],"mappings":"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"}

package/plugins/specweave/lib/vendor/utils/logger.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Logger Interface
+ *
+ * Abstraction for logging to enable silent testing and flexible log output.
+ * Prevents test output pollution from expected error conditions.
+ */
+/**
+ * Logger interface for dependency injection
+ */
+export interface Logger {
+    /**
+     * Log informational message
+     */
+    log(message: string): void;
+    /**
+     * Log error message with optional error object
+     */
+    error(message: string, error?: any): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string): void;
+    /**
+     * Log debug message
+     */
+    debug(message: string): void;
+}
+/**
+ * Console logger (default production logger)
+ *
+ * Logs to console.log/error/warn
+ */
+export declare const consoleLogger: Logger;
+/**
+ * Silent logger (for testing)
+ *
+ * Suppresses all log output - use in tests to prevent pollution
+ * from expected error conditions.
+ */
+export declare const silentLogger: Logger;
+/**
+ * Create a custom logger that filters based on log level
+ *
+ * @param minLevel - Minimum level to log (debug=0, log=1, warn=2, error=3)
+ * @returns Logger instance
+ */
+export declare function createFilteredLogger(minLevel?: 'debug' | 'log' | 'warn' | 'error'): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/plugins/specweave/lib/vendor/utils/logger.js

@@ -0,0 +1,53 @@
+/**
+ * Logger Interface
+ *
+ * Abstraction for logging to enable silent testing and flexible log output.
+ * Prevents test output pollution from expected error conditions.
+ */
+/**
+ * Console logger (default production logger)
+ *
+ * Logs to console.log/error/warn
+ */
+export const consoleLogger = {
+    log: (message) => console.log(message),
+    error: (message, error) => {
+        if (error) {
+            console.error(message, error);
+        }
+        else {
+            console.error(message);
+        }
+    },
+    warn: (message) => console.warn(message),
+    debug: (message) => console.log(message)
+};
+/**
+ * Silent logger (for testing)
+ *
+ * Suppresses all log output - use in tests to prevent pollution
+ * from expected error conditions.
+ */
+export const silentLogger = {
+    log: () => { },
+    error: () => { },
+    warn: () => { },
+    debug: () => { }
+};
+/**
+ * Create a custom logger that filters based on log level
+ *
+ * @param minLevel - Minimum level to log (debug=0, log=1, warn=2, error=3)
+ * @returns Logger instance
+ */
+export function createFilteredLogger(minLevel = 'log') {
+    const levels = { debug: 0, log: 1, warn: 2, error: 3 };
+    const threshold = levels[minLevel];
+    return {
+        log: (msg) => levels.log >= threshold && console.log(msg),
+        error: (msg, err) => levels.error >= threshold && (err ? console.error(msg, err) : console.error(msg)),
+        warn: (msg) => levels.warn >= threshold && console.warn(msg),
+        debug: (msg) => levels.debug >= threshold && console.log(msg)
+    };
+}
+//# sourceMappingURL=logger.js.map

package/plugins/specweave/lib/vendor/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,GAAG,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IAC9C,KAAK,EAAE,CAAC,OAAe,EAAE,KAAW,EAAE,EAAE;QACtC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;IAChD,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;CACjD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;IACb,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAA+C,KAAK;IACvF,MAAM,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACvD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEnC,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,IAAI,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QACzD,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,SAAS,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtG,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;QAC5D,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;KAC9D,CAAC;AACJ,CAAC"}

package/plugins/specweave/lib/vendor/utils/translation.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Translation Utilities
+ *
+ * LLM-native translation system for SpecWeave multilingual support.
+ * Provides zero-cost language detection and cost-efficient translation
+ * using Claude Haiku via current LLM session.
+ *
+ * Strategy:
+ * - Language Detection: Simple heuristic (no API calls, <1ms)
+ * - Translation: Claude Haiku via current session (~$0.0025 per file)
+ * - Preservation: Markdown, code blocks, technical terms stay intact
+ *
+ * @see .specweave/increments/0006-llm-native-i18n/reports/DESIGN-POST-GENERATION-TRANSLATION.md
+ */
+/**
+ * Supported languages for translation
+ */
+export type SupportedLanguage = 'en' | 'ru' | 'es' | 'zh' | 'de' | 'fr' | 'ja' | 'ko' | 'pt' | 'ar' | 'he' | 'unknown';
+/**
+ * Language detection result
+ */
+export interface LanguageDetectionResult {
+    language: SupportedLanguage;
+    confidence: number;
+    nonAsciiRatio: number;
+    detectionMethod: 'heuristic' | 'explicit';
+}
+/**
+ * Preserved content structure for code blocks
+ */
+export interface PreservedContent {
+    preserved: string;
+    blocks: string[];
+    inlineCode: string[];
+    links: string[];
+}
+/**
+ * Translation result with metadata
+ */
+export interface TranslationResult {
+    translated: string;
+    sourceLanguage: SupportedLanguage;
+    targetLanguage: SupportedLanguage;
+    estimatedTokens: number;
+    estimatedCost: number;
+    preservedBlocks: number;
+}
+/**
+ * Detects the language of the given content using simple heuristics
+ *
+ * @param content - The text content to analyze
+ * @returns Language detection result with confidence score
+ *
+ * @example
+ * ```typescript
+ * const result = detectLanguage('Это тестовый документ');
+ * console.log(result.language); // 'ru'
+ * console.log(result.confidence); // 0.95
+ * ```
+ */
+export declare function detectLanguage(content: string): LanguageDetectionResult;
+/**
+ * Detects specific language from content
+ *
+ * @param content - The text content to analyze
+ * @returns Detected language code or 'unknown'
+ *
+ * @example
+ * ```typescript
+ * detectSpecificLanguage('Это текст'); // 'ru'
+ * detectSpecificLanguage('这是文本'); // 'zh'
+ * ```
+ */
+export declare function detectSpecificLanguage(content: string): SupportedLanguage;
+/**
+ * Preserves code blocks, inline code, and links before translation
+ *
+ * @param content - Markdown content to preserve
+ * @returns Preserved content with placeholders
+ *
+ * @example
+ * ```typescript
+ * const content = 'Text\n```js\ncode\n```\nMore text';
+ * const preserved = preserveCodeBlocks(content);
+ * // preserved.blocks = ['```js\ncode\n```']
+ * // preserved.preserved = 'Text\n__CODE_BLOCK_0__\nMore text'
+ * ```
+ */
+export declare function preserveCodeBlocks(content: string): PreservedContent;
+/**
+ * Restores preserved code blocks, inline code, and links after translation
+ *
+ * @param translated - Translated text with placeholders
+ * @param preserved - Preserved content structure
+ * @returns Restored text with original code blocks and links
+ *
+ * @example
+ * ```typescript
+ * const translated = 'Текст\n__CODE_BLOCK_0__\nБольше текста';
+ * const preserved = { blocks: ['```js\ncode\n```'], inlineCode: [], links: [] };
+ * const restored = restoreCodeBlocks(translated, preserved);
+ * // Result: 'Текст\n```js\ncode\n```\nБольше текста'
+ * ```
+ */
+export declare function restoreCodeBlocks(translated: string, preserved: Pick<PreservedContent, 'blocks' | 'inlineCode' | 'links'>): string;
+/**
+ * Estimates the number of tokens in a text
+ * Rule of thumb: ~4 characters per token for English, ~2-3 for other languages
+ *
+ * @param text - Text to estimate
+ * @param language - Language code for estimation
+ * @returns Estimated token count
+ */
+export declare function estimateTokens(text: string, language?: SupportedLanguage): number;
+/**
+ * Estimates translation cost using Claude Haiku pricing
+ * Haiku pricing (as of 2025): $0.25 per 1M input tokens, $1.25 per 1M output tokens
+ *
+ * @param inputTokens - Input token count
+ * @param outputTokens - Output token count (defaults to input for balanced estimate)
+ * @returns Estimated cost in USD
+ */
+export declare function estimateTranslationCost(inputTokens: number, outputTokens?: number): number;
+/**
+ * Generates translation prompt for LLM
+ *
+ * @param content - Content to translate
+ * @param sourceLanguage - Source language code
+ * @param targetLanguage - Target language code (default: 'en')
+ * @returns Translation prompt for LLM
+ */
+export declare function generateTranslationPrompt(content: string, sourceLanguage: SupportedLanguage, targetLanguage?: SupportedLanguage): string;
+/**
+ * Translates content to English using LLM (Claude Haiku)
+ * This function generates the prompt but delegates actual LLM invocation
+ * to the caller (via Task tool, skill, or direct API)
+ *
+ * @param content - Content to translate
+ * @param sourceLanguage - Source language code
+ * @returns Translation prompt and metadata (caller must invoke LLM)
+ *
+ * @example
+ * ```typescript
+ * const content = 'Это тестовый документ';
+ * const result = prepareTranslation(content, 'ru');
+ * // Caller then invokes LLM with result.prompt
+ * ```
+ */
+export declare function prepareTranslation(content: string, sourceLanguage: SupportedLanguage, targetLanguage?: SupportedLanguage): {
+    prompt: string;
+    preserved: PreservedContent;
+    estimatedTokens: number;
+    estimatedCost: number;
+};
+/**
+ * Post-processes translated content
+ * Restores code blocks, validates markdown, cleans up extra whitespace
+ *
+ * @param translated - Translated text from LLM
+ * @param preserved - Preserved content structure
+ * @returns Cleaned and restored translated content
+ */
+export declare function postProcessTranslation(translated: string, preserved: PreservedContent): string;
+/**
+ * Validates that translated content preserves markdown structure
+ * Returns warnings if structure doesn't match
+ *
+ * @param original - Original content
+ * @param translated - Translated content
+ * @returns Array of validation warnings (empty if valid)
+ */
+export declare function validateTranslation(original: string, translated: string): string[];
+/**
+ * Gets human-readable language name
+ *
+ * @param code - Language code
+ * @returns Human-readable name
+ */
+export declare function getLanguageName(code: SupportedLanguage): string;
+/**
+ * Formats cost for display
+ *
+ * @param cost - Cost in USD
+ * @returns Formatted string (e.g., "$0.0025" or "<$0.001")
+ */
+export declare function formatCost(cost: number): string;
+//# sourceMappingURL=translation.d.ts.map