@gringow/gringow 0.1.3 → 0.1.4

package/README.md

@@ -1,6 +1,18 @@
 # @gringow/gringow
 
-Core library for Gringow to translate strings and template strings using different LLM providers.
+[![npm version](https://img.shields.io/npm/v/@gringow/gringow)](https://www.npmjs.com/package/@gringow/gringow)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+AI-powered translation library for template strings using multiple LLM providers (Hugging Face, Anthropic, Gemini). Gringow provides smart caching, deterministic content hashing, and seamless integration for modern JavaScript/TypeScript projects.
+
+## Features
+
+- 🌍 **Multi-language translation** using LLM providers
+- 🏷️ **Tagged template literal** syntax for inline translations
+- 💾 **Smart caching** with content-based hashing
+- 🔌 **Three LLM providers**: Hugging Face (local), Anthropic, Gemini
+- 🚀 **Zero configuration** - works out of the box with Hugging Face
+- 📦 **Optimized builds** via Vite/Next.js plugins
 
 ## Installation
 
@@ -12,45 +24,90 @@ pnpm add @gringow/gringow
 yarn add @gringow/gringow
 ```
 
-## Usage
+## Quick Start
 
 ```typescript
-import Gringow, { rebuild } from '@gringow/gringow'
+import Gringow from '@gringow/gringow'
 
 // Simple string translation
 const { cacheId, translation } = await Gringow`Hello world`
-console.log(cacheId) // deterministic cache ID created from the flattened string
-console.log(translation.translation) // { "pt-BR": "Olá mundo", "fr-CA": "Bonjour le monde" }
+console.log(translation.translation)
+// => { "pt-BR": "Olá mundo", "fr-CA": "Bonjour le monde" }
 
-// Template string translation (values are flattened before hashing)
+// Template string with dynamic values
 const name = 'John'
-const { translation: hiJohn } = await Gringow`Hello ${name}`
-console.log(hiJohn.translation) // { "pt-BR": "Olá John", "fr-CA": "Bonjour John" }
+const { translation: result } = await Gringow`Welcome, ${name}!`
+console.log(result.translation)
+// => { "pt-BR": "Bem-vindo, John!", "fr-CA": "Bienvenue, John!" }
+```
+
+## Usage Examples
 
-// Re-run an existing cache entry against the configured LLM
+### Basic Translation
+
+```typescript
+import Gringow from '@gringow/gringow'
+
+// Translate a static string
+const { translation } = await Gringow`Hello world`
+console.log(translation.translation['pt-BR']) // "Olá mundo"
+```
+
+### Dynamic Content
+
+```typescript
+// Template literals are flattened before hashing - dynamic values preserved
+const user = { name: 'Alice', role: 'admin' }
+const { translation } = await Gringow`User ${user.name} has ${user.role} privileges`
+
+console.log(translation.translation['pt-BR'])
+// => "Usuário Alice tem privilégios de admin"
+```
+
+### Cache Management
+
+```typescript
+import Gringow, { rebuild, checkCache } from '@gringow/gringow'
+
+const { cacheId } = await Gringow`Hello world`
+
+// Check if translation exists in cache
+const cached = await checkCache(cacheId)
+console.log(cached) // GringowCacheItem or undefined
+
+// Force re-translation by rebuilding cache entry
 const refreshed = await rebuild(cacheId)
 console.log(refreshed.translation.translation)
 ```
 
-Gringow always returns a `{ cacheId, translation }` object. The `translation` payload can include optional
-`prepend`/`append` strings when you use custom prompts.
+### Browser Usage
+
+For client-side interpolation without Node.js dependencies:
+
+```typescript
+import { interpolateTemplate } from '@gringow/gringow/browser'
+
+const template = 'Hello {name}, you have {count} messages'
+const result = interpolateTemplate(template, { name: 'Alice', count: 5 })
+console.log(result) // "Hello Alice, you have 5 messages"
+```
 
 ## Configuration
 
-Gringow loads configuration via `cosmiconfig` using the `gringow` namespace. You can place any of the supported
-formats in your project root (e.g. `gringow.config.js`, `gringow.config.mjs`, `gringow.config.json`). Missing fields
-are merged with the defaults below and validated with Zod.
+Gringow uses [cosmiconfig](https://github.com/cosmiconfig/cosmiconfig) to load configuration from your project root. Supported formats: `gringow.config.js`, `gringow.config.mjs`, `gringow.config.json`, or a `gringow` field in `package.json`.
+
+### Default Configuration
 
 ```js
 // gringow.config.js
 export default {
   debug: false,
-  log: { level: 'debug' },
+  log: { level: 'info' },
   cache: {
     dir: './gringow',
     file: 'gringow.json',
     prefix: 'grw',
-    write: true, // set to false to skip writing to disk
+    write: true,
   },
   keys: {
     anthropicApiKey: process.env.ANTHROPIC_API_KEY,
@@ -63,35 +120,171 @@ export default {
     model: 'Xenova/nllb-200-distilled-600M',
     temperature: 1.0,
     sleep: 0,
-    // Prompt shaping (all optional)
-    prePrompt: undefined,
-    postPrompt: undefined,
-    prePromptAppend: undefined,
-    postPromptPrepend: undefined,
-    prePromptReplace: undefined,
-    postPromptReplace: undefined,
   },
-  // Files scanned by the Vite/Next.js plugins when building caches
   globby: './src/**/*.{js,jsx,ts,tsx}',
 }
 ```
 
-> For `anthropic` or `gemini`, the corresponding API key **must** be present or config validation will fail.
+### Example: Using Gemini
+
+```js
+// gringow.config.js
+export default {
+  keys: {
+    geminiApiKey: process.env.GEMINI_API_KEY,
+  },
+  llm: {
+    choice: 'gemini',
+    model: 'gemini-2.0-flash',
+    prePromptAppend: 'Please respond in a friendly tone.',
+  },
+  languages: ['es-ES', 'de-DE', 'ja-JP'],
+}
+```
+
+### Example: Using Anthropic
+
+```js
+// gringow.config.js
+export default {
+  keys: {
+    anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+  },
+  llm: {
+    choice: 'anthropic',
+    model: 'claude-3-5-sonnet-20241022',
+    temperature: 0.7,
+  },
+}
+```
+
+### Prompt Customization
+
+Fine-tune LLM behavior with prompt options:
+
+```js
+export default {
+  llm: {
+    choice: 'huggingface',
+    prePrompt: 'Translate the following text:', // Default prompt prefix
+    postPrompt: 'Ensure translations are natural.', // Additional context
+    prePromptAppend: 'Use formal language.', // Appended to pre-prompt
+    postPromptPrepend: 'Maintain original formatting.', // Prepended to post-prompt
+    prePromptReplace: 'Custom instruction here', // Replaces entire pre-prompt
+  },
+}
+```
 
 ## LLM Providers
 
-- **Hugging Face** (default): Runs local models, no API key required.
-- **Anthropic**: Requires `keys.anthropicApiKey`.
-- **Gemini**: Requires `keys.geminiApiKey`.
+### Hugging Face (Default)
 
-## API surface
+Runs local models via `@huggingface/transformers`. **No API key required.**
+
+```js
+// gringow.config.js
+export default {
+  llm: {
+    choice: 'huggingface',
+    model: 'Xenova/nllb-200-distilled-600M', // Multilingual translation model
+  },
+}
+```
 
-- `default export Gringow(strings, ...values)` — translate a string or tagged template. Returns a `Promise<GringowResponse>`.
-- `rebuild(cacheId)` — re-asks the configured LLM for a cached entry and writes it back when `cache.write` is true.
-- Cache helpers: `checkCache`, `getCache`, `getOrCreateCache`, `writeCacheToDisk`, `deleteCacheItem`, `clearCache`.
-- Utilities: `createCacheId`, `flatTemplateString`, `interpolateTemplate` (browser build), `awaitedConfig`, `isLocalConfigFound`, `getConfigSource`.
+**Pros**: Free, private, offline-capable  
+**Cons**: Slower first run (model download), higher memory usage
 
-```ts
+### Anthropic
+
+Uses Claude models via Anthropic API. **Requires API key.**
+
+```js
+// gringow.config.js
+export default {
+  keys: {
+    anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+  },
+  llm: {
+    choice: 'anthropic',
+    model: 'claude-3-5-sonnet-20241022',
+  },
+}
+```
+
+**Pros**: High-quality translations, fast  
+**Cons**: API costs, requires internet
+
+### Gemini
+
+Uses Google's Gemini models. **Requires API key.**
+
+```js
+// gringow.config.js
+export default {
+  keys: {
+    geminiApiKey: process.env.GEMINI_API_KEY,
+  },
+  llm: {
+    choice: 'gemini',
+    model: 'gemini-2.0-flash',
+  },
+}
+```
+
+**Pros**: Fast, cost-effective  
+**Cons**: API costs, requires internet
+
+## API Reference
+
+### Core Functions
+
+#### `Gringow(strings, ...values): Promise<GringowResponse>`
+
+Main translation function. Accepts tagged template literals or plain strings.
+
+```typescript
+const result = await Gringow`Hello ${name}`
+```
+
+**Returns**: `Promise<GringowResponse>` with `{ cacheId, translation }`
+
+#### `rebuild(cacheId: string): Promise<GringowResponse>`
+
+Re-translates a cached entry using the current LLM configuration.
+
+```typescript
+const refreshed = await rebuild('grw_abc123')
+```
+
+### Cache Helpers
+
+```typescript
+import {
+  checkCache,      // Check if cacheId exists
+  getCache,        // Get entire cache object
+  getOrCreateCache,// Get cache or create empty one
+  writeCacheToDisk,// Manually write cache entry
+  deleteCacheItem, // Remove cache entry
+  clearCache,      // Clear all cache entries
+} from '@gringow/gringow'
+```
+
+### Utilities
+
+```typescript
+import {
+  createCacheId,         // Generate cache ID from string
+  flatTemplateString,    // Flatten template literal to string
+  interpolateTemplate,   // Browser-safe interpolation (from /browser export)
+  awaitedConfig,         // Access resolved configuration
+  isLocalConfigFound,    // Check if local config exists
+  getConfigSource,       // Get config file path
+} from '@gringow/gringow'
+```
+
+### Type Definitions
+
+```typescript
 type GringowTranslation = Record<string, string>
 
 type GringowCacheItem = {
@@ -108,22 +301,65 @@ type GringowResponse = {
 }
 ```
 
+## How It Works
+
+1. **Input Processing**: Template strings are flattened to plain text (preserving dynamic values)
+2. **Cache ID Generation**: Content-based hash created using `createCacheId()`
+3. **Cache Lookup**: Check `./gringow/gringow.json` for existing translation
+4. **LLM Query**: If not cached, request translation from configured provider
+5. **Response Parsing**: Parse provider response to `GringowCacheItem` format
+6. **Cache Storage**: Write to disk when `cache.write` is `true`
+
+**Example cache structure:**
+
+```json
+{
+  "grw_a1b2c3": {
+    "original": "Hello world",
+    "translation": {
+      "pt-BR": "Olá mundo",
+      "fr-CA": "Bonjour le monde"
+    }
+  }
+}
+```
+
 ## Development
 
 ```bash
+# Install dependencies
 pnpm install
-pnpm run build   # builds the package
-pnpm run test    # vitest suite
+
+# Build the package
+pnpm run build
+
+# Run tests
+pnpm run test
+
+# Watch mode
+pnpm run test:watch
 ```
 
+## Integrations
+
+Gringow has official integrations for modern web frameworks:
+
+- **[@gringow/cli](https://www.npmjs.com/package/@gringow/gringow-cli)** - Command-line interface for cache management and translations
+- **[@gringow/gringow-vite](https://www.npmjs.com/package/@gringow/gringow-vite)** - Vite plugin for build-time translation extraction
+- **[@gringow/gringow-react](https://www.npmjs.com/package/@gringow/gringow-react)** - React hooks and components
+- **[@gringow/gringow-shadow](https://www.npmjs.com/package/@gringow/gringow-shadow)** - Web Component layer (vanilla JS)
+- **[@gringow/gringow-nextjs](https://www.npmjs.com/package/@gringow/gringow-nextjs)** - Next.js plugin (experimental)
+
+## Related Resources
+
+- [Documentation](https://gringow.dev)
+- [GitHub Repository](https://github.com/rntgspr/gringow)
+- [Examples](https://github.com/rntgspr/gringow/tree/main/example-gringow-vite)
+
 ## License
 
-MIT
+MIT © [Renato Gaspar](https://github.com/rntgspr)
 
-## Related Packages (npm)
+---
 
-- [@gringow/gringow-cli](https://www.npmjs.com/package/@gringow/gringow-cli) - Command-line interface
-- [@gringow/gringow-shadow](https://www.npmjs.com/package/@gringow/gringow-shadow) - Web Component layer powering the React bindings
-- [@gringow/gringow-react](https://www.npmjs.com/package/@gringow/gringow-react) - React bindings
-- [@gringow/gringow-vite](https://www.npmjs.com/package/@gringow/gringow-vite) - Vite plugin
-- [@gringow/gringow-nextjs](https://www.npmjs.com/package/@gringow/gringow-nextjs) - Experimental Next.js plugin
+**Questions or Issues?** Open an issue on [GitHub](https://github.com/rntgspr/gringow/issues)

package/dist/config.d.mts

@@ -40,6 +40,7 @@ declare const awaitedConfig: Promise<{
         write?: boolean | undefined;
     };
     sourceLanguage: string;
+    defaultLanguage: string;
     languages: string[];
     llm: {
         choice: "gemini" | "anthropic" | "huggingface";

package/dist/config.mjs

@@ -18,6 +18,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -45,6 +46,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/config.test.mjs

@@ -18135,6 +18135,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -18162,6 +18163,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/constants/default-config.mjs

@@ -12,6 +12,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",

package/dist/data/check-cache.mjs

@@ -21,6 +21,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -48,6 +49,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/data/clear-cache.mjs

@@ -21,6 +21,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -48,6 +49,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/data/create-cache-dir.mjs

@@ -225,6 +225,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -252,6 +253,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/data/delete-cache-item.mjs

@@ -21,6 +21,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -48,6 +49,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/data/get-cache.mjs

@@ -21,6 +21,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -48,6 +49,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/data/get-or-create-cache.mjs

@@ -21,6 +21,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -48,6 +49,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/data/save-cache.mjs

@@ -21,6 +21,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -48,6 +49,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/data/write-cache-to-disk.mjs

@@ -21,6 +21,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -48,6 +49,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/gringow.mjs

@@ -24,6 +24,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -51,6 +52,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/index.mjs

@@ -24,6 +24,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -51,6 +52,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/io/anthropic/ask.mjs

@@ -19,6 +19,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -46,6 +47,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/io/anthropic/index.mjs

@@ -19,6 +19,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -46,6 +47,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/io/ask-llm.mjs

@@ -22,6 +22,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -49,6 +50,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/io/gemini/ask.mjs

@@ -19,6 +19,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -46,6 +47,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/io/gemini/index.mjs

@@ -19,6 +19,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -46,6 +47,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/io/huggingface/ask.mjs

@@ -20,6 +20,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -47,6 +48,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/io/huggingface/index.mjs

@@ -20,6 +20,7 @@ var defaultConfig = {
   },
   keys: {},
   sourceLanguage: "en-US",
+  defaultLanguage: "pt-BR",
   languages: ["pt-BR", "fr-CA"],
   llm: {
     choice: "huggingface",
@@ -47,6 +48,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/dist/schemas/config.shcema.d.mts

@@ -38,6 +38,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         geminiApiKey?: string | undefined;
     }>;
     sourceLanguage: z.ZodString;
+    defaultLanguage: z.ZodString;
     languages: z.ZodArray<z.ZodString, "many">;
     llm: z.ZodObject<{
         choice: z.ZodEnum<["gemini", "anthropic", "huggingface"]>;
@@ -89,6 +90,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         write?: boolean | undefined;
     };
     sourceLanguage: string;
+    defaultLanguage: string;
     languages: string[];
     llm: {
         choice: "gemini" | "anthropic" | "huggingface";
@@ -119,6 +121,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         write?: boolean | undefined;
     };
     sourceLanguage: string;
+    defaultLanguage: string;
     languages: string[];
     llm: {
         choice: "gemini" | "anthropic" | "huggingface";
@@ -149,6 +152,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         write?: boolean | undefined;
     };
     sourceLanguage: string;
+    defaultLanguage: string;
     languages: string[];
     llm: {
         choice: "gemini" | "anthropic" | "huggingface";
@@ -179,6 +183,7 @@ declare const configSchema: z.ZodEffects<z.ZodObject<{
         write?: boolean | undefined;
     };
     sourceLanguage: string;
+    defaultLanguage: string;
     languages: string[];
     llm: {
         choice: "gemini" | "anthropic" | "huggingface";

package/dist/schemas/config.shcema.mjs

@@ -19,6 +19,7 @@ var configSchema = z.object({
     geminiApiKey: z.string().optional()
   }),
   sourceLanguage: languageSchema,
+  defaultLanguage: languageSchema,
   languages: z.array(languageSchema),
   llm: z.object({
     choice: llmOptionsSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gringow/gringow",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",