lingodotdev 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 181b9ff8557660e02e6de8604fddd35d36d42686f0bb97c3fcc499ad0f9fdf07
-  data.tar.gz: d4f509c82cc4d151cdf42d8cf85f2185d1ae37128f364849c177f3b25a001945
+  metadata.gz: 28c83f0fada39ed4eec6b9d0b67917fac54a45fc6d8d11b50389f282f49a322c
+  data.tar.gz: bdca77419544b1253dd3aecc752f07a92c3acab361f8693d7069f3d74d247160
 SHA512:
-  metadata.gz: aed41259a2967a85e829bfeb2175bb705547fc28a7c5ea60c624df21cd09178e65dac28c6cebdffecb8a1bdfcac5431c81d936b003391a4bf305b4be27594ca0
-  data.tar.gz: feddedd0259ff5feb889dac5f83db5f03f942d03fcce641f4cf0c79d81cd70df7325f7a14e286001ffd7905ef49d98f8a76a379083895ebb589ad57a576375da
+  metadata.gz: 458753b774866b16fd4d960ba5e52bcff42b8c322ea3bab294943590ba0a04a09206182fbffcbf9c0fdd51269c542214a689da47893c9519efc7ee8961b2b730
+  data.tar.gz: e002510b545296b9b358713113e86d8f1a6aa08d233c2770b04e89730ad291fa6a77e85f2167cf32d3e3c574da048b6d48a3f08264287f1ce42657ed45a5c728

data/README.md

@@ -210,13 +210,12 @@ result = engine.localize_text(
 
 ### Reference context
 
-Provide additional context to improve translation accuracy:
+Provide existing translations as reference to improve translation accuracy. The `reference` hash maps locale codes to key-value content objects:
 
 ```ruby
 reference = {
-  context: 'greeting',
-  tone: 'formal',
-  domain: 'business'
+  'es' => { 'greeting' => 'Hola', 'farewell' => 'Adiós' },
+  'fr' => { 'greeting' => 'Bonjour', 'farewell' => 'Au revoir' }
 }
 
 result = engine.localize_text(
@@ -314,7 +313,7 @@ Localizes a string to the target locale.
   - `text` (String): Text to localize
   - `target_locale` (String): Target locale code (e.g., 'es', 'fr', 'ja')
   - `source_locale` (String): Source locale code (e.g., 'en')
-  - `reference` (Hash, optional): Additional context for translation
+  - `reference` (Hash, optional): Existing translations keyed by locale code, e.g. `{ 'es' => { 'key' => 'valor' } }`
   - `on_progress` (Proc, optional): Progress callback
   - `concurrent` (Boolean): Enable concurrent processing
   - `&block`: Alternative progress callback
@@ -342,7 +341,7 @@ Localizes an HTML document while preserving structure and formatting. Handles bo
   - `html` (String): HTML document string to localize
   - `target_locale` (String): Target locale code (e.g., 'es', 'fr', 'ja')
   - `source_locale` (String): Source locale code (e.g., 'en')
-  - `reference` (Hash, optional): Additional context for translation
+  - `reference` (Hash, optional): Existing translations keyed by locale code, e.g. `{ 'es' => { 'key' => 'valor' } }`
   - `on_progress` (Proc, optional): Progress callback
   - `concurrent` (Boolean): Enable concurrent processing
   - `&block`: Alternative progress callback

data/lib/lingodotdev/version.rb

@@ -3,6 +3,6 @@
 # Ruby SDK for Lingo.dev localization and translation API.
 module LingoDotDev
   # Current version of the LingoDotDev SDK.
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end
 

data/lib/lingodotdev.rb

@@ -190,7 +190,7 @@ module LingoDotDev
     # @param target_locale [String] the target locale code (e.g., 'es', 'fr', 'ja')
     # @param source_locale [String] the source locale code (e.g., 'en')
     # @param fast [Boolean, nil] enable fast mode for quicker results (optional)
-    # @param reference [Hash, nil] additional context for translation (optional)
+    # @param reference [Hash, nil] existing translations keyed by locale code, e.g. { 'es' => { 'key' => 'valor' } } (optional)
     # @param on_progress [Proc, nil] callback for progress updates (optional)
     # @param concurrent [Boolean] enable concurrent processing (default: false)
     #
@@ -237,7 +237,7 @@ module LingoDotDev
     # @param target_locale [String] the target locale code (e.g., 'es', 'fr', 'ja')
     # @param source_locale [String] the source locale code (e.g., 'en')
     # @param fast [Boolean, nil] enable fast mode for quicker results (optional)
-    # @param reference [Hash, nil] additional context for translation (optional)
+    # @param reference [Hash, nil] existing translations keyed by locale code, e.g. { 'es' => { 'key' => 'valor' } } (optional)
     # @param on_progress [Proc, nil] callback for progress updates (optional)
     # @param concurrent [Boolean] enable concurrent processing (default: false)
     #
@@ -283,7 +283,7 @@ module LingoDotDev
     # @param target_locale [String] the target locale code (e.g., 'es', 'fr', 'ja')
     # @param source_locale [String] the source locale code (e.g., 'en')
     # @param fast [Boolean, nil] enable fast mode for quicker results (optional)
-    # @param reference [Hash, nil] additional context for translation (optional)
+    # @param reference [Hash, nil] existing translations keyed by locale code, e.g. { 'es' => { 'key' => 'valor' } } (optional)
     # @param on_progress [Proc, nil] callback for progress updates (optional)
     # @param concurrent [Boolean] enable concurrent processing (default: false)
     #
@@ -341,7 +341,7 @@ module LingoDotDev
     # @param target_locale [String] the target locale code (e.g., 'es', 'fr', 'ja')
     # @param source_locale [String] the source locale code (e.g., 'en')
     # @param fast [Boolean, nil] enable fast mode for quicker results (optional)
-    # @param reference [Hash, nil] additional context for translation (optional)
+    # @param reference [Hash, nil] existing translations keyed by locale code, e.g. { 'es' => { 'key' => 'valor' } } (optional)
     # @param on_progress [Proc, nil] callback for progress updates (optional)
     # @param concurrent [Boolean] enable concurrent processing (default: false)
     #
@@ -514,7 +514,7 @@ module LingoDotDev
     # @param target_locales [Array<String>] array of target locale codes
     # @param source_locale [String] the source locale code (e.g., 'en')
     # @param fast [Boolean, nil] enable fast mode for quicker results (optional)
-    # @param reference [Hash, nil] additional context for translation (optional)
+    # @param reference [Hash, nil] existing translations keyed by locale code, e.g. { 'es' => { 'key' => 'valor' } } (optional)
     # @param concurrent [Boolean] enable concurrent processing (default: false)
     #
     # @return [Array<String>] array of localized strings in the same order as target_locales
@@ -565,7 +565,7 @@ module LingoDotDev
     # @param target_locale [String] the target locale code (e.g., 'es', 'fr', 'ja')
     # @param source_locale [String] the source locale code (e.g., 'en')
     # @param fast [Boolean, nil] enable fast mode for quicker results (optional)
-    # @param reference [Hash, nil] additional context for translation (optional)
+    # @param reference [Hash, nil] existing translations keyed by locale code, e.g. { 'es' => { 'key' => 'valor' } } (optional)
     # @param concurrent [Boolean] enable concurrent processing (default: false)
     #
     # @return [Array<Hash>] array of localized Hash objects in the same order as input

data/spec/lingo_dot_dev/engine_spec.rb

@@ -69,7 +69,7 @@ RSpec.describe LingoDotDev::Engine do
 
     it 'localizes text with reference context' do
       engine = described_class.new(api_key: api_key, engine_id: engine_id)
-      reference = { context: 'greeting' }
+      reference = { 'es' => { 'text' => 'Hola' } }
       result = engine.localize_text(
         'Hello',
         target_locale: target_locale,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lingodotdev
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - David Turnbull