@llm-translate/cli 1.0.0-next.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. package/.dockerignore +51 -0
  2. package/.env.example +33 -0
  3. package/.github/workflows/docs-pages.yml +57 -0
  4. package/.github/workflows/release.yml +49 -0
  5. package/.translaterc.json +44 -0
  6. package/CLAUDE.md +243 -0
  7. package/Dockerfile +55 -0
  8. package/README.md +371 -0
  9. package/RFC.md +1595 -0
  10. package/dist/cli/index.d.ts +2 -0
  11. package/dist/cli/index.js +4494 -0
  12. package/dist/cli/index.js.map +1 -0
  13. package/dist/index.d.ts +1152 -0
  14. package/dist/index.js +3841 -0
  15. package/dist/index.js.map +1 -0
  16. package/docker-compose.yml +56 -0
  17. package/docs/.vitepress/config.ts +161 -0
  18. package/docs/api/agent.md +262 -0
  19. package/docs/api/engine.md +274 -0
  20. package/docs/api/index.md +171 -0
  21. package/docs/api/providers.md +304 -0
  22. package/docs/changelog.md +64 -0
  23. package/docs/cli/dir.md +243 -0
  24. package/docs/cli/file.md +213 -0
  25. package/docs/cli/glossary.md +273 -0
  26. package/docs/cli/index.md +129 -0
  27. package/docs/cli/init.md +158 -0
  28. package/docs/cli/serve.md +211 -0
  29. package/docs/glossary.json +235 -0
  30. package/docs/guide/chunking.md +272 -0
  31. package/docs/guide/configuration.md +139 -0
  32. package/docs/guide/cost-optimization.md +237 -0
  33. package/docs/guide/docker.md +371 -0
  34. package/docs/guide/getting-started.md +150 -0
  35. package/docs/guide/glossary.md +241 -0
  36. package/docs/guide/index.md +86 -0
  37. package/docs/guide/ollama.md +515 -0
  38. package/docs/guide/prompt-caching.md +221 -0
  39. package/docs/guide/providers.md +232 -0
  40. package/docs/guide/quality-control.md +206 -0
  41. package/docs/guide/vitepress-integration.md +265 -0
  42. package/docs/index.md +63 -0
  43. package/docs/ja/api/agent.md +262 -0
  44. package/docs/ja/api/engine.md +274 -0
  45. package/docs/ja/api/index.md +171 -0
  46. package/docs/ja/api/providers.md +304 -0
  47. package/docs/ja/changelog.md +64 -0
  48. package/docs/ja/cli/dir.md +243 -0
  49. package/docs/ja/cli/file.md +213 -0
  50. package/docs/ja/cli/glossary.md +273 -0
  51. package/docs/ja/cli/index.md +111 -0
  52. package/docs/ja/cli/init.md +158 -0
  53. package/docs/ja/guide/chunking.md +271 -0
  54. package/docs/ja/guide/configuration.md +139 -0
  55. package/docs/ja/guide/cost-optimization.md +30 -0
  56. package/docs/ja/guide/getting-started.md +150 -0
  57. package/docs/ja/guide/glossary.md +214 -0
  58. package/docs/ja/guide/index.md +32 -0
  59. package/docs/ja/guide/ollama.md +410 -0
  60. package/docs/ja/guide/prompt-caching.md +221 -0
  61. package/docs/ja/guide/providers.md +232 -0
  62. package/docs/ja/guide/quality-control.md +137 -0
  63. package/docs/ja/guide/vitepress-integration.md +265 -0
  64. package/docs/ja/index.md +58 -0
  65. package/docs/ko/api/agent.md +262 -0
  66. package/docs/ko/api/engine.md +274 -0
  67. package/docs/ko/api/index.md +171 -0
  68. package/docs/ko/api/providers.md +304 -0
  69. package/docs/ko/changelog.md +64 -0
  70. package/docs/ko/cli/dir.md +243 -0
  71. package/docs/ko/cli/file.md +213 -0
  72. package/docs/ko/cli/glossary.md +273 -0
  73. package/docs/ko/cli/index.md +111 -0
  74. package/docs/ko/cli/init.md +158 -0
  75. package/docs/ko/guide/chunking.md +271 -0
  76. package/docs/ko/guide/configuration.md +139 -0
  77. package/docs/ko/guide/cost-optimization.md +30 -0
  78. package/docs/ko/guide/getting-started.md +150 -0
  79. package/docs/ko/guide/glossary.md +214 -0
  80. package/docs/ko/guide/index.md +32 -0
  81. package/docs/ko/guide/ollama.md +410 -0
  82. package/docs/ko/guide/prompt-caching.md +221 -0
  83. package/docs/ko/guide/providers.md +232 -0
  84. package/docs/ko/guide/quality-control.md +137 -0
  85. package/docs/ko/guide/vitepress-integration.md +265 -0
  86. package/docs/ko/index.md +58 -0
  87. package/docs/zh/api/agent.md +262 -0
  88. package/docs/zh/api/engine.md +274 -0
  89. package/docs/zh/api/index.md +171 -0
  90. package/docs/zh/api/providers.md +304 -0
  91. package/docs/zh/changelog.md +64 -0
  92. package/docs/zh/cli/dir.md +243 -0
  93. package/docs/zh/cli/file.md +213 -0
  94. package/docs/zh/cli/glossary.md +273 -0
  95. package/docs/zh/cli/index.md +111 -0
  96. package/docs/zh/cli/init.md +158 -0
  97. package/docs/zh/guide/chunking.md +271 -0
  98. package/docs/zh/guide/configuration.md +139 -0
  99. package/docs/zh/guide/cost-optimization.md +30 -0
  100. package/docs/zh/guide/getting-started.md +150 -0
  101. package/docs/zh/guide/glossary.md +214 -0
  102. package/docs/zh/guide/index.md +32 -0
  103. package/docs/zh/guide/ollama.md +410 -0
  104. package/docs/zh/guide/prompt-caching.md +221 -0
  105. package/docs/zh/guide/providers.md +232 -0
  106. package/docs/zh/guide/quality-control.md +137 -0
  107. package/docs/zh/guide/vitepress-integration.md +265 -0
  108. package/docs/zh/index.md +58 -0
  109. package/package.json +91 -0
  110. package/release.config.mjs +15 -0
  111. package/schemas/glossary.schema.json +110 -0
  112. package/src/cli/commands/dir.ts +469 -0
  113. package/src/cli/commands/file.ts +291 -0
  114. package/src/cli/commands/glossary.ts +221 -0
  115. package/src/cli/commands/init.ts +68 -0
  116. package/src/cli/commands/serve.ts +60 -0
  117. package/src/cli/index.ts +64 -0
  118. package/src/cli/options.ts +59 -0
  119. package/src/core/agent.ts +1119 -0
  120. package/src/core/chunker.ts +391 -0
  121. package/src/core/engine.ts +634 -0
  122. package/src/errors.ts +188 -0
  123. package/src/index.ts +147 -0
  124. package/src/integrations/vitepress.ts +549 -0
  125. package/src/parsers/markdown.ts +383 -0
  126. package/src/providers/claude.ts +259 -0
  127. package/src/providers/interface.ts +109 -0
  128. package/src/providers/ollama.ts +379 -0
  129. package/src/providers/openai.ts +308 -0
  130. package/src/providers/registry.ts +153 -0
  131. package/src/server/index.ts +152 -0
  132. package/src/server/middleware/auth.ts +93 -0
  133. package/src/server/middleware/logger.ts +90 -0
  134. package/src/server/routes/health.ts +84 -0
  135. package/src/server/routes/translate.ts +210 -0
  136. package/src/server/types.ts +138 -0
  137. package/src/services/cache.ts +899 -0
  138. package/src/services/config.ts +217 -0
  139. package/src/services/glossary.ts +247 -0
  140. package/src/types/analysis.ts +164 -0
  141. package/src/types/index.ts +265 -0
  142. package/src/types/modes.ts +121 -0
  143. package/src/types/mqm.ts +157 -0
  144. package/src/utils/logger.ts +141 -0
  145. package/src/utils/tokens.ts +116 -0
  146. package/tests/fixtures/glossaries/ml-glossary.json +53 -0
  147. package/tests/fixtures/input/lynq-installation.ko.md +350 -0
  148. package/tests/fixtures/input/lynq-installation.md +350 -0
  149. package/tests/fixtures/input/simple.ko.md +27 -0
  150. package/tests/fixtures/input/simple.md +27 -0
  151. package/tests/unit/chunker.test.ts +229 -0
  152. package/tests/unit/glossary.test.ts +146 -0
  153. package/tests/unit/markdown.test.ts +205 -0
  154. package/tests/unit/tokens.test.ts +81 -0
  155. package/tsconfig.json +28 -0
  156. package/tsup.config.ts +34 -0
  157. package/vitest.config.ts +16 -0
@@ -0,0 +1,64 @@
1
+ import { Command } from 'commander';
2
+ import { fileCommand } from './commands/file.js';
3
+ import { dirCommand } from './commands/dir.js';
4
+ import { initCommand } from './commands/init.js';
5
+ import { glossaryCommand } from './commands/glossary.js';
6
+ import { serveCommand } from './commands/serve.js';
7
+
8
+ const program = new Command();
9
+
10
+ program
11
+ .name('llm-translate')
12
+ .description(
13
+ 'CLI-based document translation tool powered by LLMs with glossary enforcement'
14
+ )
15
+ .version('0.1.0')
16
+ .enablePositionalOptions()
17
+ .passThroughOptions();
18
+
19
+ // ============================================================================
20
+ // Global Options (for stdin/stdout mode)
21
+ // ============================================================================
22
+
23
+ program
24
+ .option('-s, --source-lang <lang>', 'Source language code')
25
+ .option('-t, --target-lang <lang>', 'Target language code')
26
+ .option(
27
+ '-c, --config <path>',
28
+ 'Path to config file (default: .translaterc.json)'
29
+ )
30
+ .option('-v, --verbose', 'Enable verbose logging')
31
+ .option('-q, --quiet', 'Suppress non-error output');
32
+
33
+ // ============================================================================
34
+ // Commands
35
+ // ============================================================================
36
+
37
+ program.addCommand(fileCommand);
38
+ program.addCommand(dirCommand);
39
+ program.addCommand(initCommand);
40
+ program.addCommand(glossaryCommand);
41
+ program.addCommand(serveCommand);
42
+
43
+ // ============================================================================
44
+ // Stdin/Stdout Mode (default when no command specified)
45
+ // ============================================================================
46
+
47
+ program.action(async (options) => {
48
+ // Handle stdin/stdout translation when piped
49
+ if (!process.stdin.isTTY) {
50
+ const { handleStdinTranslation } = await import('./commands/file.js');
51
+ await handleStdinTranslation(options);
52
+ } else {
53
+ program.help();
54
+ }
55
+ });
56
+
57
+ // ============================================================================
58
+ // Parse and Execute
59
+ // ============================================================================
60
+
61
+ program.parseAsync(process.argv).catch((error: unknown) => {
62
+ console.error('Error:', error instanceof Error ? error.message : error);
63
+ process.exit(1);
64
+ });
@@ -0,0 +1,59 @@
1
+ import type { ProviderName, DocumentFormat } from '../types/index.js';
2
+
3
+ // ============================================================================
4
+ // CLI Option Types
5
+ // ============================================================================
6
+
7
+ export interface GlobalOptions {
8
+ sourceLang: string;
9
+ targetLang: string;
10
+ config?: string;
11
+ verbose?: boolean;
12
+ quiet?: boolean;
13
+ }
14
+
15
+ export interface TranslationOptions extends GlobalOptions {
16
+ glossary?: string;
17
+ provider?: ProviderName;
18
+ model?: string;
19
+ quality?: string; // Commander returns strings, parsed to number in handler
20
+ maxIterations?: string; // Commander returns strings, parsed to number in handler
21
+ }
22
+
23
+ export interface OutputOptions {
24
+ output?: string;
25
+ format?: DocumentFormat;
26
+ dryRun?: boolean;
27
+ json?: boolean;
28
+ }
29
+
30
+ export interface AdvancedOptions {
31
+ chunkSize?: string; // Commander returns strings, parsed to number in handler
32
+ parallel?: number;
33
+ cache?: boolean; // Commander's --no-cache sets this to false
34
+ context?: string;
35
+ strictQuality?: boolean;
36
+ strictGlossary?: boolean;
37
+ }
38
+
39
+ export interface FileCommandOptions
40
+ extends TranslationOptions,
41
+ OutputOptions,
42
+ AdvancedOptions {}
43
+
44
+ export interface DirCommandOptions
45
+ extends TranslationOptions,
46
+ OutputOptions,
47
+ AdvancedOptions {}
48
+
49
+ // ============================================================================
50
+ // Default Values
51
+ // ============================================================================
52
+
53
+ export const defaults = {
54
+ quality: 85,
55
+ maxIterations: 4,
56
+ chunkSize: 1024,
57
+ parallel: 3,
58
+ provider: 'claude' as ProviderName,
59
+ } as const;