specweave 0.17.0 → 0.17.1

package/dist/src/utils/spec-splitter.js

@@ -0,0 +1,332 @@
+/**
+ * Spec Splitter - Split Monolithic Specs into Project-Specific Files
+ *
+ * Takes a comprehensive spec file covering multiple projects and intelligently
+ * splits it into project-specific spec files (FE/, BE/, MOBILE/, etc.)
+ *
+ * @module spec-splitter
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { splitSpecByProject, DEFAULT_PROJECT_RULES } from './project-mapper.js';
+/**
+ * Normalize metadata fields (prefers camelCase over snake_case)
+ *
+ * @param metadata Raw metadata with potential snake_case fields
+ * @returns Normalized metadata with camelCase fields
+ */
+export function normalizeMetadata(metadata) {
+    return {
+        ...metadata,
+        specId: metadata.specId || metadata.spec_id,
+        lastUpdated: metadata.lastUpdated || metadata.last_updated,
+        estimatedEffort: metadata.estimatedEffort || metadata.estimated_effort,
+        targetRelease: metadata.targetRelease || metadata.target_release,
+        jiraSync: metadata.jiraSync !== undefined ? metadata.jiraSync : metadata.jira_sync,
+        jiraProjects: metadata.jiraProjects || metadata.jira_projects
+    };
+}
+/**
+ * Parse spec file into structured format
+ *
+ * @param specPath Path to spec.md file
+ * @returns Parsed spec structure
+ */
+export async function parseSpecFile(specPath) {
+    const content = await fs.readFile(specPath, 'utf-8');
+    // Extract frontmatter
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!frontmatterMatch) {
+        throw new Error('No frontmatter found in spec file');
+    }
+    const rawMetadata = parseFrontmatter(frontmatterMatch[1]);
+    const metadata = normalizeMetadata(rawMetadata);
+    // Extract sections
+    const sections = extractSections(content);
+    // Parse user stories
+    const userStories = parseUserStories(sections.userStories || '');
+    return {
+        metadata,
+        executiveSummary: sections.executiveSummary || '',
+        problemStatement: sections.problemStatement || '',
+        userStories,
+        functionalRequirements: sections.functionalRequirements || '',
+        nonFunctionalRequirements: sections.nonFunctionalRequirements || '',
+        successMetrics: sections.successMetrics || '',
+        technicalArchitecture: sections.technicalArchitecture || '',
+        testStrategy: sections.testStrategy || '',
+        riskAnalysis: sections.riskAnalysis || '',
+        futureRoadmap: sections.futureRoadmap || '',
+        appendices: sections.appendices || ''
+    };
+}
+/**
+ * Parse YAML frontmatter into metadata object
+ */
+function parseFrontmatter(frontmatter) {
+    const lines = frontmatter.split('\n');
+    const metadata = {};
+    let currentKey = null;
+    let currentArray = [];
+    for (const line of lines) {
+        // Check for array items (starts with -)
+        if (currentKey && line.trim().startsWith('-')) {
+            const value = line.trim().slice(1).trim();
+            currentArray.push(value);
+            continue;
+        }
+        // If we were collecting an array, save it
+        if (currentKey && currentArray.length > 0) {
+            metadata[currentKey] = currentArray;
+            currentArray = [];
+            currentKey = null;
+        }
+        // Parse key: value line
+        const match = line.match(/^(\w+):\s*(.*)$/);
+        if (match) {
+            const key = match[1];
+            const value = match[2].trim();
+            // Handle arrays (JSON format like ["a", "b"])
+            if (value.startsWith('[')) {
+                metadata[key] = JSON.parse(value);
+            }
+            // Handle empty array (key: with nothing after)
+            else if (!value || value === '') {
+                currentKey = key;
+                currentArray = [];
+            }
+            // Handle boolean
+            else if (value === 'true' || value === 'false') {
+                metadata[key] = value === 'true';
+            }
+            // Handle string
+            else {
+                metadata[key] = value.replace(/^["']|["']$/g, '');
+            }
+        }
+    }
+    // Save any remaining array
+    if (currentKey && currentArray.length > 0) {
+        metadata[currentKey] = currentArray;
+    }
+    return metadata;
+}
+/**
+ * Extract sections from spec markdown
+ */
+function extractSections(content) {
+    const sections = {};
+    // Remove frontmatter
+    const withoutFrontmatter = content.replace(/^---\n[\s\S]*?\n---\n/, '');
+    // Split by h2 headers (##)
+    const parts = withoutFrontmatter.split(/^## /m);
+    for (const part of parts) {
+        if (!part.trim())
+            continue;
+        const lines = part.split('\n');
+        const sectionName = lines[0].trim();
+        const sectionContent = lines.slice(1).join('\n').trim();
+        // Normalize section names
+        const normalizedName = sectionName
+            .replace(/[^a-zA-Z0-9\s]/g, '')
+            .replace(/\s+/g, '')
+            .replace(/^(.)/, (m) => m.toLowerCase());
+        sections[normalizedName] = sectionContent;
+    }
+    return sections;
+}
+/**
+ * Parse user stories from spec section
+ */
+function parseUserStories(userStoriesSection) {
+    const stories = [];
+    // Split by h3 headers (###)
+    const storyParts = userStoriesSection.split(/^### /m);
+    for (const part of storyParts) {
+        if (!part.trim())
+            continue;
+        const lines = part.split('\n');
+        const titleLine = lines[0].trim();
+        // Extract US-XXX: Title
+        const match = titleLine.match(/^(US-\d+):\s*(.+?)(?:\s*\(Priority|$)/);
+        if (!match)
+            continue;
+        const id = match[1];
+        const title = match[2].trim();
+        // Extract description (As a... I want... So that...)
+        const descriptionMatch = part.match(/\*\*As a\*\*\s+(.+?)\n\*\*I want\*\*\s+(.+?)\n\*\*So that\*\*\s+(.+?)(?:\n|$)/s);
+        const description = descriptionMatch
+            ? `As a ${descriptionMatch[1].trim()} I want ${descriptionMatch[2].trim()} So that ${descriptionMatch[3].trim()}`
+            : '';
+        // Extract acceptance criteria
+        const acceptanceCriteria = [];
+        const acMatches = part.matchAll(/\*\*AC-[A-Z0-9-]+\*\*:\s*(.+?)(?:\n-|\n\*\*|$)/gs);
+        for (const acMatch of acMatches) {
+            acceptanceCriteria.push(acMatch[1].trim());
+        }
+        // Extract technical context (if present)
+        const technicalContextMatch = part.match(/#### Technical Context\n\n([\s\S]+?)(?:\n####|\n---|\n###|$)/);
+        const technicalContext = technicalContextMatch ? technicalContextMatch[1].trim() : undefined;
+        stories.push({
+            id,
+            title,
+            description,
+            acceptanceCriteria,
+            technicalContext
+        });
+    }
+    return stories;
+}
+/**
+ * Split spec into project-specific files
+ *
+ * @param specPath Path to monolithic spec.md
+ * @param outputDir Directory to write project-specific specs (e.g., .specweave/docs/internal/specs/)
+ * @param projectRules Custom project mapping rules (optional)
+ * @returns Map of projectId → output file path
+ */
+export async function splitSpecIntoProjects(specPath, outputDir, projectRules = DEFAULT_PROJECT_RULES) {
+    // Parse spec
+    const parsedSpec = await parseSpecFile(specPath);
+    // Split user stories by project
+    const projectStories = splitSpecByProject(parsedSpec.userStories, projectRules);
+    // Create output map
+    const outputMap = new Map();
+    // Generate project-specific specs
+    for (const [projectId, stories] of projectStories.entries()) {
+        const projectDir = path.join(outputDir, projectId);
+        await fs.ensureDir(projectDir);
+        const specId = (parsedSpec.metadata.specId || '0001').replace(/^SPEC-/, '');
+        const outputPath = path.join(projectDir, `spec-${specId.toLowerCase()}-${projectId.toLowerCase()}.md`);
+        const projectSpec = generateProjectSpec(parsedSpec, projectId, stories);
+        await fs.writeFile(outputPath, projectSpec, 'utf-8');
+        outputMap.set(projectId, outputPath);
+    }
+    return outputMap;
+}
+/**
+ * Generate project-specific spec file
+ */
+function generateProjectSpec(parsedSpec, projectId, userStories) {
+    const lines = [];
+    // Frontmatter
+    lines.push('---');
+    lines.push(`spec_id: ${parsedSpec.metadata.specId}`);
+    lines.push(`project: ${projectId}`);
+    lines.push(`title: "${parsedSpec.metadata.title} - ${projectId}"`);
+    lines.push(`version: ${parsedSpec.metadata.version}`);
+    lines.push(`status: ${parsedSpec.metadata.status}`);
+    lines.push(`created: ${parsedSpec.metadata.created}`);
+    lines.push(`last_updated: ${parsedSpec.metadata.lastUpdated}`);
+    lines.push(`authors:`);
+    for (const author of parsedSpec.metadata.authors) {
+        lines.push(`  - ${author}`);
+    }
+    lines.push(`priority: ${parsedSpec.metadata.priority}`);
+    lines.push(`estimated_effort: ${parsedSpec.metadata.estimatedEffort}`);
+    lines.push(`target_release: ${parsedSpec.metadata.targetRelease}`);
+    if (parsedSpec.metadata.jiraSync) {
+        lines.push(`jira_sync: true`);
+        lines.push(`jira_project: ${projectId}`);
+    }
+    lines.push('---');
+    lines.push('');
+    // Title
+    lines.push(`# SPEC-${parsedSpec.metadata.specId}: ${parsedSpec.metadata.title} - ${projectId}`);
+    lines.push('');
+    // Executive Summary (project-specific)
+    lines.push('## Executive Summary');
+    lines.push('');
+    lines.push(`**Project**: ${projectId}`);
+    lines.push(`**Scope**: ${userStories.length} user stories for ${projectId} component`);
+    lines.push('');
+    lines.push(parsedSpec.executiveSummary);
+    lines.push('');
+    // User Stories (filtered for this project)
+    lines.push('## User Stories');
+    lines.push('');
+    for (const story of userStories) {
+        lines.push(`### ${story.id}: ${story.title}`);
+        lines.push('');
+        lines.push(story.description);
+        lines.push('');
+        if (story.acceptanceCriteria.length > 0) {
+            lines.push('#### Acceptance Criteria');
+            lines.push('');
+            for (const ac of story.acceptanceCriteria) {
+                lines.push(`**${ac}**`);
+                lines.push('');
+            }
+        }
+        if (story.technicalContext) {
+            lines.push('#### Technical Context');
+            lines.push('');
+            lines.push(story.technicalContext);
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push('');
+    }
+    // Shared sections (include full content from original spec)
+    if (parsedSpec.functionalRequirements) {
+        lines.push('## Functional Requirements (Shared)');
+        lines.push('');
+        lines.push('*See main spec for complete functional requirements*');
+        lines.push('');
+    }
+    if (parsedSpec.nonFunctionalRequirements) {
+        lines.push('## Non-Functional Requirements (Shared)');
+        lines.push('');
+        lines.push('*See main spec for complete non-functional requirements*');
+        lines.push('');
+    }
+    if (parsedSpec.technicalArchitecture) {
+        lines.push('## Technical Architecture');
+        lines.push('');
+        lines.push(parsedSpec.technicalArchitecture);
+        lines.push('');
+    }
+    // Footer
+    lines.push('---');
+    lines.push('');
+    lines.push('**Document End**');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Create multi-project folder structure
+ *
+ * @param specsDir Base specs directory (.specweave/docs/internal/specs/)
+ * @param projectIds Array of project IDs (e.g., ['FE', 'BE', 'MOBILE'])
+ */
+export async function createMultiProjectFolderStructure(specsDir, projectIds) {
+    await fs.ensureDir(specsDir);
+    for (const projectId of projectIds) {
+        const projectDir = path.join(specsDir, projectId);
+        await fs.ensureDir(projectDir);
+        // Create README.md for project
+        const readme = `# ${projectId} Specifications
+
+This folder contains specifications for the **${projectId}** project.
+
+## Organization
+
+- \`spec-NNNN-*.md\` - Project-specific specifications (living docs)
+- Each spec is permanently archived here after increment completion
+- Specs are auto-generated from increment specs and split by project
+
+## External Sync
+
+${projectId} specs sync to:
+- **JIRA**: Project ${projectId} (Epics)
+- **GitHub**: Issues tagged with \`${projectId}\` label
+
+## Maintenance
+
+- Specs are auto-updated via living docs sync hooks
+- Manual edits should be made in increment specs, not here
+`;
+        await fs.writeFile(path.join(projectDir, 'README.md'), readme, 'utf-8');
+    }
+}
+//# sourceMappingURL=spec-splitter.js.map

package/dist/src/utils/spec-splitter.js.map

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

package/dist/src/utils/string-utils.d.ts

@@ -0,0 +1,40 @@
+/**
+ * String Utilities
+ *
+ * Utilities for string manipulation and formatting
+ */
+/**
+ * Convert a string to kebab-case (lowercase with hyphens)
+ *
+ * Examples:
+ * - "Platform Engineering Team" → "platform-engineering-team"
+ * - "FRONTEND" → "frontend"
+ * - "League Scheduler Team" → "league-scheduler-team"
+ *
+ * @param str - Input string to slugify
+ * @returns Kebab-case string suitable for folder names
+ */
+export declare function slugify(str: string): string;
+/**
+ * Parse comma-separated values and trim whitespace
+ *
+ * Examples:
+ * - "Team A, Team B, Team C" → ["Team A", "Team B", "Team C"]
+ * - "FRONTEND,BACKEND,QA" → ["FRONTEND", "BACKEND", "QA"]
+ *
+ * @param input - Comma-separated string
+ * @returns Array of trimmed strings (empty strings removed)
+ */
+export declare function parseCommaSeparated(input: string): string[];
+/**
+ * Convert kebab-case to Title Case
+ *
+ * Examples:
+ * - "platform-engineering-team" → "Platform Engineering Team"
+ * - "frontend" → "Frontend"
+ *
+ * @param str - Kebab-case string
+ * @returns Title Case string
+ */
+export declare function unslugify(str: string): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/src/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAK3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C"}

package/dist/src/utils/string-utils.js

@@ -0,0 +1,58 @@
+/**
+ * String Utilities
+ *
+ * Utilities for string manipulation and formatting
+ */
+/**
+ * Convert a string to kebab-case (lowercase with hyphens)
+ *
+ * Examples:
+ * - "Platform Engineering Team" → "platform-engineering-team"
+ * - "FRONTEND" → "frontend"
+ * - "League Scheduler Team" → "league-scheduler-team"
+ *
+ * @param str - Input string to slugify
+ * @returns Kebab-case string suitable for folder names
+ */
+export function slugify(str) {
+    return str
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '') // Remove non-word chars except spaces and hyphens
+        .replace(/[\s_]+/g, '-') // Replace spaces and underscores with hyphens
+        .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen
+        .replace(/^-+|-+$/g, ''); // Remove leading/trailing hyphens
+}
+/**
+ * Parse comma-separated values and trim whitespace
+ *
+ * Examples:
+ * - "Team A, Team B, Team C" → ["Team A", "Team B", "Team C"]
+ * - "FRONTEND,BACKEND,QA" → ["FRONTEND", "BACKEND", "QA"]
+ *
+ * @param input - Comma-separated string
+ * @returns Array of trimmed strings (empty strings removed)
+ */
+export function parseCommaSeparated(input) {
+    return input
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+/**
+ * Convert kebab-case to Title Case
+ *
+ * Examples:
+ * - "platform-engineering-team" → "Platform Engineering Team"
+ * - "frontend" → "Frontend"
+ *
+ * @param str - Kebab-case string
+ * @returns Title Case string
+ */
+export function unslugify(str) {
+    return str
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(' ');
+}
+//# sourceMappingURL=string-utils.js.map

package/dist/src/utils/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,GAAG;SACP,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAE,kDAAkD;SAC5E,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAG,8CAA8C;SACxE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAO,8CAA8C;SACxE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAE,kCAAkC;AACjE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SACzE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/src/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

package/dist/src/utils/translation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translation.d.ts","sourceRoot":"","sources":["../../../src/utils/translation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,WAAW,GAAG,UAAU,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,iBAAiB,CAAC;IAClC,cAAc,EAAE,iBAAiB,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AA4CD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAmCvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAgCzE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CA6BpE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC,GACnE,MAAM,CAqBR;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,iBAAwB,GAAG,MAAM,CAGvF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAUR;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,iBAAiB,EACjC,cAAc,GAAE,iBAAwB,GACvC,MAAM,CAiDR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,iBAAiB,EACjC,cAAc,GAAE,iBAAwB,GACvC;IACD,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,CAkBA;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,gBAAgB,GAC1B,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CA0CV;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAiB/D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C"}