pdf_oxide 0.3.77 → 0.3.78

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f8cc1afab9f3954402976845e7bd601c14cd77baa80d2b46cdfc8ccae509331
-  data.tar.gz: c45909905f5756a0eda9f142f555ac734c6f52568b23a4153beb5b0f9c29b69c
+  metadata.gz: 768090956e21394fb25c44004bdc5209a86d88f554ec44f55513a27f174bdac5
+  data.tar.gz: 758285b03559fb9f2592bfbac06072f3084ceb63f3fb211574e034b4c2f2c163
 SHA512:
-  metadata.gz: 506394735f2b4f4a95592aefc8e86235c0c89c82ecc96e4b3972157ff2adfa90142cfb6f952e4b973e986c493372ca89c06ca3ea7de4b9fbbf5f140e6a7dcd6c
-  data.tar.gz: 97f7b07a1744a24f724d1b99e17bb6c06bc3841a29c8fa473bcfba0978bf78dcce7322e6d89b1a0fb04c8602e8a988da50d648f387166b89f4ebb08601a32777
+  metadata.gz: 7e622db16ff5e275624a4e4cbc2866a6ecd1c18726ad0a6dcec5fba95ae3939cdceb34df995f1db1a32814035654516c9426077a142f439d0e8e4ce17760c969
+  data.tar.gz: bbc46aa91b57a375a0557d10fc103bb0abaca13c306bf881d54e63b60448eaca868635e1c3795676afc0ac0e0558d06ef3954a2e39e3c3e5fdc5ed9d9ffc68cf

data/Gemfile

@@ -6,11 +6,11 @@ gemspec
 
 group :development do
   gem 'bundler', '>= 2.0'
-  gem 'rake', '~> 13.0'
-  gem 'rspec', '~> 3.12'
-  gem 'rubocop', '~> 1.86'
-  gem 'rubocop-rspec', '~> 3.9'
+  gem 'rake', '~> 13.4'
+  gem 'rspec', '~> 3.13'
+  gem 'rubocop', '~> 1.90'
+  gem 'rubocop-rspec', '~> 3.10'
   gem 'yard', '~> 0.9'
   gem 'simplecov', '~> 0.22'
-  gem 'simplecov-lcov', '~> 0.8'
+  gem 'simplecov-lcov', '~> 0.9'
 end

data/lib/pdf_oxide/ffi/bindings.rb

@@ -1429,6 +1429,15 @@ module PdfOxide
       attach_function :pdf_oxide_crypto_set_policy, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
       attach_function :pdf_oxide_crypto_use_fips, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
       attach_function :pdf_oxide_element_count, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
+      # void pdf_oxide_element_get_page_rect(const FfiElementList *elements, int32_t index,
+      #                                      float *x, float *y, float *width, float *height,
+      #                                      int32_t *error_code)
+      # Page-space extents of the span: the rect from pdf_oxide_element_get_rect with any
+      # text-matrix rotation resolved into an axis-aligned page-space hull;
+      # identical to pdf_oxide_element_get_rect for upright runs.
+      attach_function :pdf_oxide_element_get_page_rect,
+                      %i[pointer int32 pointer pointer pointer pointer pointer], :void,
+                      blocking: false
       attach_function :pdf_oxide_element_get_rect, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
       attach_function :pdf_oxide_element_get_text, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
       attach_function :pdf_oxide_element_get_type, %i[pointer pointer pointer pointer pointer pointer pointer pointer], :pointer, blocking: false
@@ -1645,6 +1654,13 @@ module PdfOxide
       attach_function :pdf_document_extract_text_auto, %i[pointer int32 pointer], :pointer
       attach_function :pdf_document_extract_page_auto, %i[pointer int32 string pointer], :pointer
 
+      # Structured diagnostics — malloc'd JSON array of warning objects
+      # ("[]" when there are none); free with free_string.  `category` is
+      # an open-ended snake_case token: keep it a string and tolerate
+      # tokens this binding has never seen.  The `take_` variant drains.
+      attach_function :pdf_document_structured_warnings,      %i[pointer pointer], :pointer
+      attach_function :pdf_document_take_structured_warnings, %i[pointer pointer], :pointer
+
       # Models subsystem (#519 provisioning trio).
       attach_function :pdf_oxide_prefetch_models,    %i[string pointer], :pointer
       attach_function :pdf_oxide_model_manifest,     [],                  :pointer
@@ -1742,6 +1758,17 @@ module PdfOxide
                          pointer size_t
                          pointer],
                       :pointer
+
+      # uint8_t *pdf_get_rendered_image_data(
+      #   const FfiRenderedImage *img, int32_t *data_len, int32_t *error_code)
+      # Returns the encoded image bytes (PNG or JPEG per the format the
+      # image was rendered with). Caller-owned; free with free_bytes.
+      # Overrides the auto-generated 8-pointer placeholder declared
+      # earlier in this file — that placeholder signature does not match
+      # the real 3-argument ABI and cannot be called as-is.
+      attach_function :pdf_get_rendered_image_data,
+                      %i[pointer pointer pointer],
+                      :pointer
     end
   end
 end

data/lib/pdf_oxide/pdf_document.rb

@@ -170,6 +170,32 @@ module PdfOxide
       StringMarshaller.from_c_string(ptr) || ''
     end
 
+    # This document's structured diagnostics, as a raw JSON array string
+    # (`"[]"` when there are none). Non-destructive: a later call returns
+    # the same entries plus any raised since.
+    #
+    # Left unparsed on purpose: each entry's `category` is an open-ended
+    # snake_case token and new ones ship in minor releases, so callers
+    # must tolerate tokens they do not know.
+    # @return [String] JSON array.
+    def structured_warnings
+      err = ::FFI::MemoryPointer.new(:int32)
+      ptr = Bindings.pdf_document_structured_warnings(handle, err)
+      raise_for_code(err.read_int32, 'structured_warnings')
+      StringMarshaller.from_c_string(ptr) || ''
+    end
+
+    # As {#structured_warnings}, but drains: the returned entries are
+    # removed, so a batch pipeline can read per document without the sink
+    # growing across the run.
+    # @return [String] JSON array.
+    def take_structured_warnings
+      err = ::FFI::MemoryPointer.new(:int32)
+      ptr = Bindings.pdf_document_take_structured_warnings(handle, err)
+      raise_for_code(err.read_int32, 'take_structured_warnings')
+      StringMarshaller.from_c_string(ptr) || ''
+    end
+
     # Convert one page to Markdown.
     # @param page_index [Integer]
     # @return [String] Markdown.
@@ -438,26 +464,19 @@ module PdfOxide
     end
 
     def read_rendered_image_bytes(img_ptr)
-      # The cdylib renders to a "rendered image" handle.  Different
-      # accessors exist across versions; try the byte-buffer accessor
-      # first, fall back to a sensible default.
-      if Bindings.respond_to?(:pdf_oxide_rendered_image_get_bytes)
-        len_ptr = ::FFI::MemoryPointer.new(:size_t)
-        err = ::FFI::MemoryPointer.new(:int32)
-        buf = Bindings.pdf_oxide_rendered_image_get_bytes(img_ptr, len_ptr, err)
-        raise_for_code(err.read_int32, 'render_bytes')
-        return '' if buf.nil? || buf.null?
-
-        len = len_ptr.read(:size_t)
-        bytes = buf.read_string(len)
-        Bindings.free_bytes(buf) if Bindings.respond_to?(:free_bytes)
-        bytes
-      else
-        # Fall back to an empty BINARY string; render() callers see a
-        # clean error path rather than a segfault when the build is
-        # missing the rendered-image accessor.
-        ''
-      end
+      # The cdylib exposes the rendered-image byte buffer through
+      # pdf_get_rendered_image_data (data_len is *mut i32, not size_t);
+      # the caller owns the returned buffer and must free it via
+      # free_bytes.
+      len_ptr = ::FFI::MemoryPointer.new(:int32)
+      err = ::FFI::MemoryPointer.new(:int32)
+      buf = Bindings.pdf_get_rendered_image_data(img_ptr, len_ptr, err)
+      raise_for_code(err.read_int32, 'render_bytes')
+      return '' if buf.nil? || buf.null?
+
+      bytes = buf.read_string(len_ptr.read_int32)
+      Bindings.free_bytes(buf)
+      bytes
     end
 
     # Map a cdylib error code (`int32_t *err`) to the matching Ruby

data/lib/pdf_oxide/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PdfOxide
-  VERSION = '0.3.77'
+  VERSION = '0.3.78'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdf_oxide
 version: !ruby/object:Gem::Version
-  version: 0.3.77
+  version: 0.3.78
 platform: ruby
 authors:
 - PDF Oxide Contributors
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-28 00:00:00.000000000 Z
+date: 2026-09-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '1.17'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '1.17'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -44,70 +44,70 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '13.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '13.4'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '3.13'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.86'
+        version: '1.90'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.86'
+        version: '1.90'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.9'
+        version: '3.10'
 - !ruby/object:Gem::Dependency
   name: simplecov-lcov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.9'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement