lara-sdk 1.8.0 → 1.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40c690defef56e7663867a644181be99f0a6cc6576abc9b4d7f79e57193c3853
-  data.tar.gz: 6d847c2b8b5caeaef7a45ec6624906a9b26ba29ff3105ea76e2eab7eb4d84adf
+  metadata.gz: 6441d4e8ad5cc6064ed3367644ed969d3c91e2dc5d5bcf2645680b2389d491b6
+  data.tar.gz: 1bbdb83ca6fb7f330ebb3adf69b8126facb9c1045875f083196580a2915d8b67
 SHA512:
-  metadata.gz: ec70756013dfda0e007d16fcc2c165836b737017c1a8ad198cfe9d4763694c2a251d069ed9a177d3683b636fdae997a40559a1d6743c8c632387cfa5c628e3bf
-  data.tar.gz: e8672051a95c85a847d66560c5ccbbb16dcbaf2b2d1060f5468d4b609b30cb007b8e1c823c96df2f01259b16da4cd50e5c6272823dec68ba0f90ef00669e608e
+  metadata.gz: c8b12451198b5a52a076766e310e4622cab58c1a1ce6173d6f3852291c183835b3111fcded6aee2ce60b0631727066d9b3dd443644ea03d12856f2db01314f07
+  data.tar.gz: b7dd274d9cdf562a91d0fcb496c9ce2f4053d9be3a99bb4fe5bfdb9d09d93d271ef46e82e2f8538b9b4fb24da8489401ef40bf79f6eeb29c1bc68bbbce3add2f

data/lib/lara/client.rb

@@ -92,6 +92,15 @@ module Lara
 
     def request(method, path, body: nil, files: nil, headers: nil, params: nil,
                 raw_response: false, &callback)
+      file_positions = (files || {}).each_with_object({}) do |(name, file), positions|
+        next unless file.respond_to?(:pos) && file.respond_to?(:seek)
+
+        begin
+          positions[name] = file.pos
+        rescue IOError, SystemCallError
+          # Non-seekable uploads can still be sent once.
+        end
+      end
       ensure_valid_token
 
       make_request(method, path, body: body, files: files, headers: headers, params: params,
@@ -100,6 +109,8 @@ module Lara
       raise unless e.status_code == 401
 
       @auth_mutex.synchronize { refresh_or_reauthenticate }
+      # Multipart encoding consumed the files; replay their original bytes.
+      file_positions.each { |name, position| files[name].seek(position) }
       make_request(method, path, body: body, files: files, headers: headers, params: params,
                                  raw_response: raw_response, &callback)
     end

data/lib/lara/images.rb

@@ -46,10 +46,12 @@ module Lara
     # @param glossaries [Array<String>, nil] Glossary IDs to apply.
     # @param style [String, nil] Translation style ("faithful", "fluid", "creative").
     # @param verbose [Boolean] If true, includes match details in the response.
+    # @param include_layout [Boolean] When true, includes complete geometry and styling on every
+    #   paragraph independently of verbose.
     # @param no_trace [Boolean] If true, disables request tracing.
     # @return [Lara::Models::ImageTextResult]
     def translate_text(file_path:, target:, source: nil, adapt_to: nil, glossaries: nil,
-                       style: nil, verbose: false, no_trace: false)
+                       style: nil, verbose: false, no_trace: false, include_layout: false)
       image_upload = Faraday::Multipart::FilePart.new(file_path, mime_type_for(file_path))
 
       body = {
@@ -58,7 +60,8 @@ module Lara
         adapt_to: adapt_to&.to_json,
         glossaries: glossaries&.to_json,
         style: style,
-        verbose: verbose.to_s
+        verbose: verbose.to_s,
+        include_layout: include_layout.to_s
       }.compact
 
       headers = {}
@@ -69,6 +72,27 @@ module Lara
       Lara::Models::ImageTextResult.from_hash(result)
     end
 
+    # Renders supplied translations onto the original image without translating again.
+    # Overlay and inpainting require ImageLayoutParagraph instances. Generative models
+    # accept either ImageParagraph or ImageLayoutParagraph. An omitted model defaults
+    # to generative_fast.
+    # @param paragraphs [Array<Lara::Models::ImageParagraph>] Text and translations to render.
+    # @return [String] Binary image data.
+    def render_translated(file_path:, target:, paragraphs:, source: nil, model: nil, no_trace: false)
+      image_upload = Faraday::Multipart::FilePart.new(file_path, mime_type_for(file_path))
+      body = {
+        source: source,
+        target: target,
+        paragraphs: paragraphs.map(&:to_render_hash).to_json,
+        model: model
+      }.compact
+      headers = {}
+      headers["X-No-Trace"] = "true" if no_trace
+
+      @client.post("/v2/images/render-translated", body: body, files: { image: image_upload },
+                                               headers: headers, raw_response: true)
+    end
+
     private
 
     def mime_type_for(file_path)

data/lib/lara/models/images.rb

@@ -18,6 +18,51 @@ module Lara
       end
     end
 
+    # Four corners, each an [x, y] pair of pixel coordinates.
+    class ImageBBox < Base
+      attr_reader :top_left, :top_right, :bottom_right, :bottom_left
+
+      def initialize(top_left:, top_right:, bottom_right:, bottom_left:)
+        super()
+        @top_left = top_left
+        @top_right = top_right
+        @bottom_right = bottom_right
+        @bottom_left = bottom_left
+      end
+
+      def self.from_hash(hash)
+        new(top_left: hash["top_left"] || hash["topLeft"],
+            top_right: hash["top_right"] || hash["topRight"],
+            bottom_right: hash["bottom_right"] || hash["bottomRight"],
+            bottom_left: hash["bottom_left"] || hash["bottomLeft"])
+      end
+
+      def to_render_hash
+        { top_left: top_left, top_right: top_right, bottom_right: bottom_right, bottom_left: bottom_left }
+      end
+    end
+
+    # Original text direction (ltr, rtl, or ttb) and colors.
+    class ImageTextInfo < Base
+      attr_reader :direction, :text_color, :background_color
+
+      def initialize(direction:, text_color:, background_color:)
+        super()
+        @direction = direction
+        @text_color = text_color
+        @background_color = background_color
+      end
+
+      def self.from_hash(hash)
+        new(direction: hash["direction"], text_color: hash["text_color"] || hash["textColor"],
+            background_color: hash["background_color"] || hash["backgroundColor"])
+      end
+
+      def to_render_hash
+        { direction: direction, text_color: text_color, background_color: background_color }
+      end
+    end
+
     class ImageParagraph < Base
       attr_reader :text, :translation, :adapted_to_matches, :glossaries_matches
 
@@ -28,6 +73,29 @@ module Lara
         @adapted_to_matches = adapted_to_matches
         @glossaries_matches = glossaries_matches
       end
+
+      def to_render_hash
+        { text: text, translation: translation }
+      end
+    end
+
+    class ImageLayoutParagraph < ImageParagraph
+      attr_reader :bbox, :lines_bboxes, :text_info, :alignment
+
+      def initialize(text:, translation:, bbox:, lines_bboxes:, text_info:, alignment:,
+                     adapted_to_matches: nil, glossaries_matches: nil)
+        super(text: text, translation: translation, adapted_to_matches: adapted_to_matches,
+              glossaries_matches: glossaries_matches)
+        @bbox = bbox
+        @lines_bboxes = lines_bboxes
+        @text_info = text_info
+        @alignment = alignment
+      end
+
+      def to_render_hash
+        super.merge(bbox: bbox.to_render_hash, lines_bboxes: lines_bboxes.map(&:to_render_hash),
+                    text_info: text_info.to_render_hash, alignment: alignment)
+      end
     end
 
     class ImageTextResult < Base
@@ -39,8 +107,8 @@ module Lara
         paragraphs = (hash["paragraphs"] || []).map { |p| build_paragraph(p) }
 
         new(
-          source_language: hash["sourceLanguage"],
-          adapted_to: hash["adaptedTo"],
+          source_language: hash["source_language"] || hash["sourceLanguage"],
+          adapted_to: hash["adapted_to"] || hash["adaptedTo"],
           glossaries: hash["glossaries"],
           paragraphs: paragraphs
         )
@@ -50,15 +118,30 @@ module Lara
         private
 
         def build_paragraph(paragraph_hash)
-          adapted_to_matches = convert_matches(paragraph_hash["adaptedToMatches"], NGMemoryMatch)
-          glossaries_matches = convert_matches(paragraph_hash["glossariesMatches"], NGGlossaryMatch)
+          adapted_to_matches = convert_matches(
+            paragraph_hash["adapted_to_matches"] || paragraph_hash["adaptedToMatches"], NGMemoryMatch
+          )
+          glossaries_matches = convert_matches(
+            paragraph_hash["glossaries_matches"] || paragraph_hash["glossariesMatches"], NGGlossaryMatch
+          )
 
-          ImageParagraph.new(
+          attributes = {
             text: paragraph_hash["text"],
             translation: paragraph_hash["translation"],
             adapted_to_matches: adapted_to_matches,
             glossaries_matches: glossaries_matches
-          )
+          }
+          bbox = paragraph_hash["bbox"]
+          lines_bboxes = paragraph_hash["lines_bboxes"] || paragraph_hash["linesBboxes"]
+          text_info = paragraph_hash["text_info"] || paragraph_hash["textInfo"]
+          alignment = paragraph_hash["alignment"]
+          if bbox && lines_bboxes && text_info && alignment
+            ImageLayoutParagraph.new(**attributes, bbox: ImageBBox.from_hash(bbox),
+                                     lines_bboxes: lines_bboxes.map { |box| ImageBBox.from_hash(box) },
+                                     text_info: ImageTextInfo.from_hash(text_info), alignment: alignment)
+          else
+            ImageParagraph.new(**attributes)
+          end
         end
 
         def convert_matches(value, klass)

data/lib/lara/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lara
-  VERSION = "1.8.0"
+  VERSION = "1.9.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lara-sdk
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Translated
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-11 00:00:00.000000000 Z
+date: 2026-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday