acro_that 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 40016774a590828e59c4c9ea4331a8d170ccd536d7522cbdb193fefda3f28333
-  data.tar.gz: bade6f113359d96d1f7c1a85efd7033732350c0b19bf40dd412e104da359aa5a
+  metadata.gz: ffb2119b2d0c114ad029baeff45ebcc155c660ef16a9a8ed844a9a9759861b67
+  data.tar.gz: 4d1101c45ad53eb66cf9ef16851e182220bce3b5862fe99f2a3e7c0af8d5dd04
 SHA512:
-  metadata.gz: 60e6c6afd93cfd8911c0b0a0d4b6b080cb2c8af85a104cf3fd09f8fc7f9ac642999a8d5694c374ad64b71d4aa769f6d8b390cc82829317abd64598aa42e7280f
-  data.tar.gz: 31762cf9f6f285edd78976692e9c5bab7a67cf6298a03c8d4208b02927639be29e0d1f4ca1f14c3f1c170b9f617404e0931dc8bbedd17de79fcee5c80035dd29
+  metadata.gz: 1ee4b2210fabe9d92f7296fc2d093dd281704e932e6f885b96e28a5ac470a96966180086a6689e9c8dff37bf2d35f21262a2a45f5e73a7070b9a9b1f90d8dabc
+  data.tar.gz: 4a23c547e4d42fad651be35ed769abf42ef308bcf6083ae11c15b7535f972d24b55afdf583a0396c4477819d2e0b7a6ef3169860b2e747206a5f9ed2fb3a5ee6

data/CHANGELOG.md

@@ -5,7 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.3] - 2025-01-XX
+## [0.1.5] - 2025-11-01
+
+### Fixed
+- Fixed signature field image data parsing when adding signature fields. Image data (base64 or data URI) is now properly detected and parsed when creating signature fields, matching the behavior of `update_field`.
+
+### Added
+- Added support for `metadata` option in `add_field` to pass PDF widget properties. This allows setting properties like field flags (`Ff`) for multiline text fields, alignment (`Q`), and other PDF widget options directly when creating fields.
+
+## [0.1.4] - 2025-11-01
 
 ### Fixed
 - Fixed bug where fields added to multi-page PDFs were all placed on the same page. Fields now correctly appear on their specified pages when using the `page` option in `add_field`.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    acro_that (0.1.2)
+    acro_that (0.1.4)
       chunky_png (~> 1.4)
 
 GEM

data/lib/acro_that/actions/add_field.rb

@@ -12,6 +12,7 @@ module AcroThat
         @document = document
         @name = name
         @options = options
+        @metadata = options[:metadata] || {}
       end
 
       def call
@@ -60,6 +61,19 @@ module AcroThat
         # Add widget to the target page's /Annots
         add_widget_to_page(widget_obj_num, page_num)
 
+        # If this is a signature field with image data, add the signature appearance
+        if @field_type == "/Sig" && @field_value && !@field_value.empty?
+          image_data = @field_value
+          # Check if value looks like base64 image data or data URI (same logic as update_field)
+          if image_data.is_a?(String) && (image_data.start_with?("data:image/") || (image_data.length > 50 && image_data.match?(%r{^[A-Za-z0-9+/]*={0,2}$})))
+            field_ref = [@field_obj_num, 0]
+            # Try adding signature appearance - use width and height from options
+            action = Actions::AddSignatureAppearance.new(@document, field_ref, image_data, width: width, height: height)
+            # NOTE: We don't fail if appearance addition fails - field was still created successfully
+            action.call
+          end
+        end
+
         true
       end
 
@@ -69,9 +83,33 @@ module AcroThat
         dict = "<<\n"
         dict += "  /FT #{type}\n"
         dict += "  /T #{DictScan.encode_pdf_string(@name)}\n"
-        dict += "  /Ff 0\n"
+
+        # Apply /Ff from metadata, or use default 0
+        field_flags = @metadata[:Ff] || @metadata["Ff"] || 0
+        dict += "  /Ff #{field_flags}\n"
+
         dict += "  /DA (/Helv 0 Tf 0 g)\n"
-        dict += "  /V #{DictScan.encode_pdf_string(value)}\n" if value && !value.empty?
+
+        # For signature fields with image data, don't set /V (appearance stream will be added separately)
+        # For other fields or non-image signature values, set /V normally
+        should_set_value = if type == "/Sig" && value && !value.empty?
+                             # Check if value looks like image data
+                             !(value.is_a?(String) && (value.start_with?("data:image/") || (value.length > 50 && value.match?(%r{^[A-Za-z0-9+/]*={0,2}$}))))
+                           else
+                             true
+                           end
+
+        dict += "  /V #{DictScan.encode_pdf_string(value)}\n" if should_set_value && value && !value.empty?
+
+        # Apply other metadata entries (excluding Ff which we handled above)
+        @metadata.each do |key, val|
+          next if [:Ff, "Ff"].include?(key) # Already handled above
+
+          pdf_key = format_pdf_key(key)
+          pdf_value = format_pdf_value(val)
+          dict += "  #{pdf_key} #{pdf_value}\n"
+        end
+
         dict += ">>"
         dict
       end
@@ -87,7 +125,29 @@ module AcroThat
         widget += "  /Rect #{rect_array}\n"
         widget += "  /F 4\n"
         widget += "  /DA (/Helv 0 Tf 0 g)\n"
-        widget += "  /V #{DictScan.encode_pdf_string(value)}\n" if value && !value.empty?
+
+        # For signature fields with image data, don't set /V (appearance stream will be added separately)
+        # For other fields or non-image signature values, set /V normally
+        should_set_value = if type == "/Sig" && value && !value.empty?
+                             # Check if value looks like image data
+                             !(value.is_a?(String) && (value.start_with?("data:image/") || (value.length > 50 && value.match?(%r{^[A-Za-z0-9+/]*={0,2}$}))))
+                           else
+                             true
+                           end
+
+        widget += "  /V #{DictScan.encode_pdf_string(value)}\n" if should_set_value && value && !value.empty?
+
+        # Apply metadata entries that are valid for widgets
+        # Common widget properties: /Q (alignment), /Ff (field flags), /BS (border style), etc.
+        @metadata.each do |key, val|
+          pdf_key = format_pdf_key(key)
+          pdf_value = format_pdf_value(val)
+          # Only add if not already present (we've added /F above, /V above if value exists)
+          next if ["/F", "/V"].include?(pdf_key)
+
+          widget += "  #{pdf_key} #{pdf_value}\n"
+        end
+
         widget += ">>"
         widget
       end
@@ -220,6 +280,42 @@ module AcroThat
         apply_patch(target_page_ref, new_body, page_body) if new_body && new_body != page_body
         true
       end
+
+      # Format a metadata key as a PDF dictionary key (ensure it starts with /)
+      def format_pdf_key(key)
+        key_str = key.to_s
+        key_str.start_with?("/") ? key_str : "/#{key_str}"
+      end
+
+      # Format a metadata value appropriately for PDF
+      def format_pdf_value(value)
+        case value
+        when Integer, Float
+          value.to_s
+        when String
+          # If it looks like a PDF string (starts with parenthesis or angle bracket), use as-is
+          if value.start_with?("(") || value.start_with?("<") || value.start_with?("/")
+            value
+          else
+            # Otherwise encode as a PDF string
+            DictScan.encode_pdf_string(value)
+          end
+        when Array
+          # Array format: [item1 item2 item3]
+          items = value.map { |v| format_pdf_value(v) }.join(" ")
+          "[#{items}]"
+        when Hash
+          # Dictionary format: << /Key1 value1 /Key2 value2 >>
+          dict = value.map do |k, v|
+            pdf_key = format_pdf_key(k)
+            pdf_val = format_pdf_value(v)
+            "  #{pdf_key} #{pdf_val}"
+          end.join("\n")
+          "<<\n#{dict}\n>>"
+        else
+          value.to_s
+        end
+      end
     end
   end
 end

data/lib/acro_that/document.rb

@@ -203,7 +203,7 @@ module AcroThat
         next unless body
 
         is_widget = DictScan.is_widget?(body)
-        
+
         # Collect widget information if this is a widget
         if is_widget
           # Extract position from widget

data/lib/acro_that/page.rb

@@ -88,4 +88,3 @@ module AcroThat
     end
   end
 end
-

data/lib/acro_that/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AcroThat
-  VERSION = "0.1.4"
+  VERSION = "0.1.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: acro_that
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Michael Wynkoop