pdf-reader 2.15.0 → 2.16.0

data/rbi/pdf-reader.rbi

@@ -33,21 +33,9 @@ class PDF::Reader
 
   private
 
-  sig { params(obj: T.untyped).returns(T.untyped) }
-  def doc_strings_to_utf8(obj); end
-
-  sig { params(str: ::String).returns(T::Boolean) }
-  def has_utf16_bom?(str); end
-
-  sig { params(obj: ::String).returns(::String) }
-  def pdfdoc_to_utf8(obj); end
-
   sig { returns(T::Hash[::Symbol, T.untyped]) }
   def root; end
 
-  sig { params(obj: ::String).returns(::String) }
-  def utf16_to_utf8(obj); end
-
   class << self
     sig do
       params(
@@ -198,6 +186,9 @@ class PDF::Reader::Buffer
   sig { returns(T::Boolean) }
   def in_content_stream?; end
 
+  sig { params(str: ::String, regexp: ::Regexp).returns(T::Boolean) }
+  def match?(str, regexp); end
+
   sig { void }
   def merge_indirect_reference; end
 
@@ -237,6 +228,7 @@ PDF::Reader::Buffer::ID = T.let(T.unsafe(nil), String)
 PDF::Reader::Buffer::LEFT_PAREN = T.let(T.unsafe(nil), String)
 PDF::Reader::Buffer::LESS_THAN = T.let(T.unsafe(nil), String)
 PDF::Reader::Buffer::LF = T.let(T.unsafe(nil), String)
+PDF::Reader::Buffer::NAME_TERMINATOR_BYTES = T.let(T.unsafe(nil), Array)
 PDF::Reader::Buffer::NULL_BYTE = T.let(T.unsafe(nil), String)
 PDF::Reader::Buffer::STREAM = T.let(T.unsafe(nil), String)
 PDF::Reader::Buffer::TOKEN_DELIMITER = T.let(T.unsafe(nil), Array)
@@ -282,6 +274,8 @@ class PDF::Reader::CMap
 end
 
 PDF::Reader::CMap::CMAP_KEYWORDS = T.let(T.unsafe(nil), Hash)
+PDF::Reader::CMap::EMPTY_CODEPOINTS = T.let(T.unsafe(nil), Array)
+PDF::Reader::CMap::HIGH_SURROGATE_RANGE = T.let(T.unsafe(nil), Range)
 
 class PDF::Reader::CidWidths
   extend ::Forwardable
@@ -328,12 +322,12 @@ class PDF::Reader::Encoding
 
   private
 
+  sig { params(file: ::String).returns(T::Hash[::Integer, ::Integer]) }
+  def build_file_mapping(file); end
+
   sig { params(str: ::String).returns(::String) }
   def convert_to_utf8(str); end
 
-  sig { returns(T::Hash[::Integer, ::Integer]) }
-  def default_mapping; end
-
   sig { params(enc: ::Symbol).returns(T.nilable(::String)) }
   def get_mapping_file(enc); end
 
@@ -349,15 +343,47 @@ class PDF::Reader::Encoding
   sig { params(times: ::Integer).returns(::String) }
   def little_boxes(times); end
 
-  sig { params(file: ::String).void }
-  def load_mapping(file); end
-
   sig { returns(T::Boolean) }
   def utf8_conversion_impossible?; end
+
+  sig { params(codepoint: ::Integer).returns(T::Boolean) }
+  def valid_unicode_scalar?(codepoint); end
 end
 
 PDF::Reader::Encoding::CONTROL_CHARS = T.let(T.unsafe(nil), Array)
+PDF::Reader::Encoding::DEFAULT_MAPPING = T.let(T.unsafe(nil), Hash)
+PDF::Reader::Encoding::FILE_MAPPINGS = T.let(T.unsafe(nil), Hash)
 PDF::Reader::Encoding::UNKNOWN_CHAR = T.let(T.unsafe(nil), Integer)
+
+class PDF::Reader::EncodingUtils
+  sig { params(obj: T.untyped).returns(T.untyped) }
+  def obj_to_utf8(obj); end
+
+  sig { params(str: ::String).returns(::String) }
+  def string_to_utf8(str); end
+
+  private
+
+  sig { params(str: ::String).returns(T::Boolean) }
+  def has_utf16_bom?(str); end
+
+  sig { params(str: ::String).returns(::String) }
+  def pdfdoc_to_utf8(str); end
+
+  sig { params(obj: ::String).returns(::String) }
+  def utf16_to_utf8(obj); end
+
+  class << self
+    sig { params(obj: T.untyped).returns(T.untyped) }
+    def obj_to_utf8(obj); end
+
+    sig { params(str: ::String).returns(::String) }
+    def string_to_utf8(str); end
+  end
+end
+
+PDF::Reader::EncodingUtils::PDFDOC_CODEPOINTS = T.let(T.unsafe(nil), Hash)
+PDF::Reader::EncodingUtils::UTF16_BOM = T.let(T.unsafe(nil), Array)
 class PDF::Reader::EncryptedPDFError < ::PDF::Reader::UnsupportedFeatureError; end
 
 class PDF::Reader::Error
@@ -374,10 +400,10 @@ class PDF::Reader::Error
     sig { params(object: ::Object, name: ::String).void }
     def validate_not_nil(object, name); end
 
-    sig { params(object: ::Object, name: ::String, klass: ::Module).void }
+    sig { params(object: ::Object, name: ::String, klass: T::Module[T.untyped]).void }
     def validate_type(object, name, klass); end
 
-    sig { params(object: ::Object, name: ::String, klass: ::Module).void }
+    sig { params(object: ::Object, name: ::String, klass: T::Module[T.untyped]).void }
     def validate_type_as_malformed(object, name, klass); end
   end
 end
@@ -537,7 +563,9 @@ class PDF::Reader::Font
   sig { params(obj: T::Hash[::Symbol, T.untyped]).returns(::PDF::Reader::Encoding) }
   def build_encoding(obj); end
 
-  sig { returns(T.untyped) }
+  sig do
+    returns(T.any(::PDF::Reader::WidthCalculator::BuiltIn, ::PDF::Reader::WidthCalculator::Composite, ::PDF::Reader::WidthCalculator::TrueType, ::PDF::Reader::WidthCalculator::TypeOneOrThree, ::PDF::Reader::WidthCalculator::TypeZero))
+  end
   def build_width_calculator; end
 
   sig { params(font_name: T.nilable(T.any(::String, ::Symbol))).returns(::PDF::Reader::Encoding) }
@@ -555,8 +583,8 @@ class PDF::Reader::Font
   sig { params(obj: T::Hash[::Symbol, T.untyped]).void }
   def extract_type3_info(obj); end
 
-  sig { params(x: ::Numeric, y: ::Numeric).returns([::Numeric, ::Numeric]) }
-  def font_matrix_transform(x, y); end
+  sig { params(pt: ::PDF::Reader::Point).returns(::PDF::Reader::Point) }
+  def font_matrix_transform(pt); end
 
   sig do
     params(
@@ -573,6 +601,8 @@ class PDF::Reader::Font
   def unpack_string_to_array_of_ints(unpack_me, unpack_arg); end
 end
 
+PDF::Reader::Font::WidthCalculator = T.type_alias { T.any(::PDF::Reader::WidthCalculator::BuiltIn, ::PDF::Reader::WidthCalculator::Composite, ::PDF::Reader::WidthCalculator::TrueType, ::PDF::Reader::WidthCalculator::TypeOneOrThree, ::PDF::Reader::WidthCalculator::TypeZero) }
+
 class PDF::Reader::FontDescriptor
   sig { params(ohash: ::PDF::Reader::ObjectHash, fd_hash: T::Hash[T.untyped, T.untyped]).void }
   def initialize(ohash, fd_hash); end
@@ -820,25 +850,34 @@ class PDF::Reader::ObjectCache
   def has_key?(key); end
   def has_value?(value); end
 
-  sig { returns(T.untyped) }
+  sig { returns(::Integer) }
   def hits; end
 
   def include?(key); end
   def key?(key); end
+
+  sig { returns(T::Array[T.untyped]) }
   def keys; end
+
   def length; end
   def member?(key); end
 
-  sig { returns(T.untyped) }
+  sig { returns(::Integer) }
   def misses; end
 
   def size; end
+
+  sig { returns(::String) }
   def to_s; end
+
+  sig { returns(T::Array[T.untyped]) }
   def values; end
 
   private
 
+  sig { params(obj: T.untyped).returns(T.nilable(T::Boolean)) }
   def cacheable?(obj); end
+
   def update_stats(key); end
 end
 
@@ -847,7 +886,7 @@ PDF::Reader::ObjectCache::CACHEABLE_TYPES = T.let(T.unsafe(nil), Array)
 class PDF::Reader::ObjectHash
   include ::Enumerable
 
-  sig { params(input: T.any(::IO, ::String, ::StringIO, ::Tempfile), opts: T::Hash[::Symbol, T.untyped]).void }
+  sig { params(input: T.untyped, opts: T::Hash[::Symbol, T.untyped]).void }
   def initialize(input, opts = T.unsafe(nil)); end
 
   sig { params(key: T.any(::Integer, ::PDF::Reader::Reference)).returns(T.untyped) }
@@ -950,7 +989,9 @@ class PDF::Reader::ObjectHash
   sig { returns(::Float) }
   def pdf_version; end
 
-  sig { returns(T.untyped) }
+  sig do
+    returns(T.any(::PDF::Reader::AesV2SecurityHandler, ::PDF::Reader::AesV3SecurityHandler, ::PDF::Reader::NullSecurityHandler, ::PDF::Reader::Rc4SecurityHandler, ::PDF::Reader::UnimplementedSecurityHandler))
+  end
   def sec_handler; end
 
   sig { returns(T::Boolean) }
@@ -997,7 +1038,7 @@ class PDF::Reader::ObjectHash
   end
   def deref_internal!(key, seen); end
 
-  sig { params(input: T.any(::IO, ::String, ::StringIO, ::Tempfile)).returns(T.any(::IO, ::StringIO, ::Tempfile)) }
+  sig { params(input: T.untyped).returns(T.untyped) }
   def extract_io_from(input); end
 
   sig do
@@ -1037,6 +1078,8 @@ class PDF::Reader::ObjectHash
   def xref; end
 end
 
+PDF::Reader::ObjectHash::SecurityHandler = T.type_alias { T.any(::PDF::Reader::AesV2SecurityHandler, ::PDF::Reader::AesV3SecurityHandler, ::PDF::Reader::NullSecurityHandler, ::PDF::Reader::Rc4SecurityHandler, ::PDF::Reader::UnimplementedSecurityHandler) }
+
 class PDF::Reader::ObjectStream
   sig { params(stream: ::PDF::Reader::Stream).void }
   def initialize(stream); end
@@ -1232,7 +1275,13 @@ class PDF::Reader::PageState
   def begin_text_object; end
   def clone_state; end
   def concatenate_matrix(a, b, c, d, e, f); end
+
+  sig { params(x: ::Numeric, y: ::Numeric).returns([::Numeric]) }
   def ctm_transform(x, y); end
+
+  sig { params(pt: T.any(::Numeric, ::PDF::Reader::Point), opt_y: ::Numeric).returns(::PDF::Reader::Point) }
+  def ctm_transform_point(pt, opt_y = T.unsafe(nil)); end
+
   def current_font; end
   def end_text_object; end
   def find_color_space(label); end
@@ -1263,8 +1312,13 @@ class PDF::Reader::PageState
   def set_word_spacing(word_spacing); end
   def show_text_with_positioning(params); end
   def stack_depth; end
+
+  sig { params(x: ::Numeric, y: ::Numeric).returns(T::Array[::Numeric]) }
   def trm_transform(x, y); end
 
+  sig { params(pt: T.any(::Numeric, ::PDF::Reader::Point), opt_y: ::Numeric).returns(::PDF::Reader::Point) }
+  def trm_transform_point(pt, opt_y = T.unsafe(nil)); end
+
   private
 
   def build_fonts(raw_fonts); end
@@ -1279,9 +1333,14 @@ PDF::Reader::PageState::DEFAULT_GRAPHICS_STATE = T.let(T.unsafe(nil), Hash)
 class PDF::Reader::PageTextReceiver
   extend ::Forwardable
 
+  def begin_marked_content_with_pl(tag, properties); end
   def begin_text_object(*args, **_arg1, &block); end
   def concatenate_matrix(*args, **_arg1, &block); end
+
+  sig { returns(::String) }
   def content; end
+
+  def end_marked_content; end
   def end_text_object(*args, **_arg1, &block); end
   def font_size(*args, **_arg1, &block); end
   def invoke_xobject(label); end
@@ -1314,9 +1373,15 @@ class PDF::Reader::PageTextReceiver
 
   private
 
-  def apply_rotation(x, y); end
+  sig { params(pt: ::PDF::Reader::Point).returns(::PDF::Reader::Point) }
+  def apply_rotation(pt); end
+
   def group_chars_into_runs(chars); end
+
+  sig { params(string: ::String).void }
   def internal_show_text(string); end
+
+  sig { params(runs: T::Array[::PDF::Reader::TextRun]).returns(T::Array[::PDF::Reader::TextRun]) }
   def merge_runs(runs); end
 end
 
@@ -1325,8 +1390,15 @@ class PDF::Reader::PagesStrategy; end
 PDF::Reader::PagesStrategy::OPERATORS = T.let(T.unsafe(nil), Hash)
 
 class PDF::Reader::Parser
-  sig { params(buffer: ::PDF::Reader::Buffer, objects: T.nilable(::PDF::Reader::ObjectHash)).void }
-  def initialize(buffer, objects = T.unsafe(nil)); end
+  sig do
+    params(
+      buffer: ::PDF::Reader::Buffer,
+      operators: T::Hash[T.any(::PDF::Reader::Token, ::String), ::Symbol],
+      objects: T.nilable(::PDF::Reader::ObjectHash),
+      relaxed_dictionaries: T::Boolean
+    ).void
+  end
+  def initialize(buffer, operators: T.unsafe(nil), objects: T.unsafe(nil), relaxed_dictionaries: T.unsafe(nil)); end
 
   sig do
     params(
@@ -1337,11 +1409,9 @@ class PDF::Reader::Parser
   def object(id, gen); end
 
   sig do
-    params(
-      operators: T::Hash[T.any(::PDF::Reader::Token, ::String), ::Symbol]
-    ).returns(T.nilable(T.any(::Numeric, ::PDF::Reader::Reference, ::PDF::Reader::Token, ::String, ::Symbol, T::Array[T.untyped], T::Hash[T.untyped, T.untyped])))
+    returns(T.nilable(T.any(::Numeric, ::PDF::Reader::Reference, ::PDF::Reader::Token, ::String, ::Symbol, T::Array[T.untyped], T::Hash[T.untyped, T.untyped])))
   end
-  def parse_token(operators = T.unsafe(nil)); end
+  def parse_token; end
 
   private
 
@@ -1354,6 +1424,9 @@ class PDF::Reader::Parser
   sig { returns(::String) }
   def hex_string; end
 
+  sig { params(str: ::String, regexp: ::Regexp).returns(T::Boolean) }
+  def match?(str, regexp); end
+
   sig { returns(::Symbol) }
   def pdf_name; end
 
@@ -1364,6 +1437,7 @@ class PDF::Reader::Parser
   def string; end
 end
 
+PDF::Reader::Parser::INTERNED_TOKENS = T.let(T.unsafe(nil), Hash)
 PDF::Reader::Parser::MAPPING = T.let(T.unsafe(nil), Hash)
 PDF::Reader::Parser::STRATEGIES = T.let(T.unsafe(nil), Hash)
 PDF::Reader::Parser::TOKEN_STRATEGY = T.let(T.unsafe(nil), Proc)
@@ -1382,6 +1456,9 @@ class PDF::Reader::Point
   def y; end
 end
 
+PDF::Reader::Point::ONE_ONE = T.let(T.unsafe(nil), PDF::Reader::Point)
+PDF::Reader::Point::ZERO_ZERO = T.let(T.unsafe(nil), PDF::Reader::Point)
+
 class PDF::Reader::PrintReceiver
   sig { params(methodname: ::Symbol, args: T.untyped).void }
   def method_missing(methodname, *args); end
@@ -1390,6 +1467,16 @@ class PDF::Reader::PrintReceiver
   def respond_to?(meth); end
 end
 
+class PDF::Reader::Rc4
+  sig { params(key: ::String).void }
+  def initialize(key); end
+
+  sig { params(data: ::String).returns(::String) }
+  def decrypt(data); end
+
+  def encrypt(*args, **_arg1, &blk); end
+end
+
 class PDF::Reader::Rc4SecurityHandler
   sig { params(key: ::String).void }
   def initialize(key); end
@@ -1417,6 +1504,9 @@ class PDF::Reader::Rectangle
   sig { params(point: ::PDF::Reader::Point).returns(T::Boolean) }
   def contains?(point); end
 
+  sig { params(x: ::Numeric, y: ::Numeric).returns(T::Boolean) }
+  def contains_xy?(x, y); end
+
   sig { returns(::Numeric) }
   def height; end
 
@@ -1734,6 +1824,9 @@ class PDF::Reader::TransformationMatrix
   end
   def multiply!(a, b, c, d, e, f); end
 
+  sig { params(tx: ::Numeric, ty: ::Numeric).void }
+  def prepend_translation!(tx, ty); end
+
   sig { returns([::Numeric]) }
   def to_a; end
 
@@ -1772,7 +1865,7 @@ class PDF::Reader::TypeCheck
     sig { params(string: T.untyped).returns(::String) }
     def cast_to_string!(string); end
 
-    sig { params(obj: T.untyped).returns(::Symbol) }
+    sig { params(obj: T.untyped).returns(T.nilable(::Symbol)) }
     def cast_to_symbol(obj); end
 
     sig { params(obj: T.untyped).returns(::Symbol) }

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pdf-reader
 version: !ruby/object:Gem::Version
-  version: 2.15.0
+  version: 2.16.0
 platform: ruby
 authors:
 - James Healy
@@ -119,20 +119,6 @@ dependencies:
     - - "!="
       - !ruby/object:Gem::Version
         version: 2.0.0
-- !ruby/object:Gem::Dependency
-  name: ruby-rc4
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: hashery
   requirement: !ruby/object:Gem::Requirement
@@ -240,6 +226,7 @@ files:
 - lib/pdf/reader/cid_widths.rb
 - lib/pdf/reader/cmap.rb
 - lib/pdf/reader/encoding.rb
+- lib/pdf/reader/encoding_utils.rb
 - lib/pdf/reader/encodings/mac_expert.txt
 - lib/pdf/reader/encodings/mac_roman.txt
 - lib/pdf/reader/encodings/pdf_doc.txt
@@ -278,6 +265,7 @@ files:
 - lib/pdf/reader/parser.rb
 - lib/pdf/reader/point.rb
 - lib/pdf/reader/print_receiver.rb
+- lib/pdf/reader/rc4.rb
 - lib/pdf/reader/rc4_security_handler.rb
 - lib/pdf/reader/rectangle.rb
 - lib/pdf/reader/reference.rb
@@ -307,9 +295,9 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/yob/pdf-reader/issues
-  changelog_uri: https://github.com/yob/pdf-reader/blob/v2.15.0/CHANGELOG
-  documentation_uri: https://www.rubydoc.info/gems/pdf-reader/2.15.0
-  source_code_uri: https://github.com/yob/pdf-reader/tree/v2.15.0
+  changelog_uri: https://github.com/yob/pdf-reader/blob/v2.16.0/CHANGELOG
+  documentation_uri: https://www.rubydoc.info/gems/pdf-reader/2.16.0
+  source_code_uri: https://github.com/yob/pdf-reader/tree/v2.16.0
 rdoc_options:
 - "--title"
 - PDF::Reader Documentation