pdfrb 0.7.24 → 0.7.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7f4bfdd940c5efb31509b47b458c221611bd9fab8e65f45c3c5f0d4a55af63e
-  data.tar.gz: ca8423b413d1c1c22387df07f0cb8deac73549b3be0b944cfbe96600b43a146c
+  metadata.gz: 1eb0494d4b1e603ab1e6fad59bb5daa3d3ad1df02dcd57ed6b2f2445655b72d2
+  data.tar.gz: 3e6aae264376ab5f3027d89500d883bea9fe95a39fadc2bd01cc0f83b4914c45
 SHA512:
-  metadata.gz: e047623b3eb1d875605e7582e56c11c38c963acef221ac017f977e9c875efc291081c2fe7f66d8ed27b1bbe5f76cf75770f8605288c89a98157d90102b2c3f9c
-  data.tar.gz: a072c1ca23b1e030a276f8dc15483ef26d852b5889bd8896d1b6f22efcaab0e2a772c132fa14405a99d301649e4447e9dcf28133279ea592a1f297f115a4caad
+  metadata.gz: 7db4a10fc882da2a6b1eea1a84bff7868ffac59345ba5c7596fec36bb31fd519b8c08594f6c68362ee12802c88e1ebce20ad4fef9cfba162e686d1e393e5f3d4
+  data.tar.gz: 7491b71494824241e04c771bfc4a229d9e4b33ddcdbd4a49b99faa260f8866a6d08eef391f1947b93a207b72312e103d9809e8b2eac45a0a063f3d1e5f8314d1

data/lib/pdfrb/model/cos/arlington_backed.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Cos
+      # Shared Arlington TSV binding for COS container classes.
+      # Cos::Dictionary extends this and merges field definitions via
+      # define_field; Model::PdfArray extends it and keeps the
+      # positional definition for element-type lookup. Either way the
+      # class is registered in Pdfrb::Model::Type.arlington_registry
+      # so field-link resolution can find it.
+      module ArlingtonBacked
+        # Pull the named Arlington TSV. Idempotent. Silently no-ops
+        # when the Arlington layer or the TSV is unavailable, so
+        # hand-coded subclasses still work.
+        def arlington_object(name, version: "latest")
+          return if arlington_loaded_for?(name)
+          return unless arlington_available?
+
+          definition = Pdfrb::Arlington::Loader.object_definition(name, version: version)
+          return unless definition
+
+          arlington_mark_loaded(name)
+          Pdfrb::Model::Type.register_arlington(name, self) if Pdfrb::Model.const_defined?(:Type)
+          apply_arlington_definition(definition)
+        end
+
+        def arlington_loaded_for?(arlington_name)
+          @arlington_loaded_name == arlington_name
+        end
+        private :arlington_loaded_for?
+
+        def arlington_mark_loaded(name)
+          @arlington_loaded_name = name
+        end
+        private :arlington_mark_loaded
+
+        def arlington_available?
+          Pdfrb.const_defined?(:Arlington) &&
+            Pdfrb::Arlington.const_defined?(:Loader)
+        rescue StandardError
+          false
+        end
+        private :arlington_available?
+
+        # Hook: containers override to consume the definition.
+        def apply_arlington_definition(_definition); end
+        private :apply_arlington_definition
+      end
+    end
+  end
+end

data/lib/pdfrb/model/cos/dictionary.rb

@@ -13,6 +13,8 @@ module Pdfrb
       #     via Pdfrb::Arlington::Loader. Calls `define_field` under
       #     the hood with types translated to Ruby classes.
       class Dictionary < Pdfrb::Model::Object
+        extend ArlingtonBacked
+
         # ---- Per-class field registry ----
 
         # Shared type registry (s7.7 /Type symbol -> Dictionary
@@ -69,50 +71,20 @@ module Pdfrb
             own_fields.each { |n, f| yield n, f }
           end
 
-          # Pull field metadata from the named Arlington TSV. Idempotent.
-          # Silently no-ops when the Arlington layer or the TSV is
-          # unavailable, so hand-coded subclasses still work.
-          #
-          # Also registers +self+ in Pdfrb::Model::Type.arlington_registry
-          # under +name+ so field-link resolution can find this class
-          # when other Types reference it.
-          def arlington_object(name, version: "latest")
-            return if arlington_loaded_for?(name)
-            return unless arlington_available?
-
-            definition = Pdfrb::Arlington::Loader.object_definition(name, version: version)
-            return unless definition
-
-            arlington_mark_loaded(name)
-            Pdfrb::Model::Type.register_arlington(name, self) if Pdfrb::Model.const_defined?(:Type)
+          # Merge the TSV's field definitions into the class's field
+          # set (ArlingtonBacked#arlington_object hook).
+          def apply_arlington_definition(definition)
             definition.each_field do |field_def|
               define_field_from_arlington(field_def)
             end
           end
+          private :apply_arlington_definition
 
           def own_fields
             @own_fields ||= {}
           end
           private :own_fields
 
-          def arlington_loaded_for?(arlington_name)
-            @arlington_loaded_name == arlington_name
-          end
-          private :arlington_loaded_for?
-
-          def arlington_mark_loaded(name)
-            @arlington_loaded_name = name
-          end
-          private :arlington_mark_loaded
-
-          def arlington_available?
-            Pdfrb.const_defined?(:Arlington) &&
-              Pdfrb::Arlington.const_defined?(:Loader)
-          rescue StandardError
-            false
-          end
-          private :arlington_available?
-
           # Merge Arlington field metadata with any hand-coded
           # define_field declaration. Hand-coded fields win: if the
           # class already declares this key explicitly (with a type),

data/lib/pdfrb/model/cos.rb

@@ -15,6 +15,7 @@ module Pdfrb
       autoload :StringEncoding, "pdfrb/model/cos/string_encoding"
       autoload :Dictionary, "pdfrb/model/cos/dictionary"
       autoload :Stream, "pdfrb/model/cos/stream"
+      autoload :ArlingtonBacked, "pdfrb/model/cos/arlington_backed"
     end
   end
 end

data/lib/pdfrb/model/pdf_array.rb

@@ -8,6 +8,26 @@ module Pdfrb
     # when nested inside a typed Dictionary (field-driven).
     class PdfArray < Pdfrb::Model::Object
       include Enumerable
+      extend Cos::ArlingtonBacked
+
+      class << self
+        # ArlingtonBacked hook: array TSVs describe positional element
+        # types (keys "0", "1", ...), so keep the definition whole
+        # rather than merging per-field metadata.
+        def apply_arlington_definition(definition)
+          @arlington_definition = definition
+        end
+        private :apply_arlington_definition
+
+        def arlington_definition
+          @arlington_definition
+        end
+
+        # FieldDefinition for the element at +index+, per the TSV.
+        def element_field(index)
+          arlington_definition&.field_for(index.to_s)
+        end
+      end
 
       def initialize(arr = [], oid: 0, gen: 0, document: nil)
         super(Array(arr), oid: oid, gen: gen, document: document)

data/lib/pdfrb/model/type/crypt_filter.rb

@@ -6,6 +6,7 @@ module Pdfrb
       # Crypt Filter (s7.6.5). Per-stream cipher filter spec — names
       # the cipher and authentication event.
       class CryptFilter < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CryptFilter"
         def cipher_method; self[:CFM]&.to_sym; end
         def auth_event; self[:AuthEvent]&.to_sym; end
         def length; self[:Length]; end
@@ -27,6 +28,7 @@ module Pdfrb
       # Crypt Filter Map (s7.6.5, Table 26). Maps per-page crypt filter
       # names to the default CryptFilter used.
       class CryptFilterMap < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CryptFilterMap"
         def filter_for(stream_name)
           value[stream_name.to_sym] || value[stream_name.to_s]
         end
@@ -41,6 +43,7 @@ module Pdfrb
       # Crypt Filter Public Key (s7.6.5, Table 26). Public-key analog
       # of CryptFilter.
       class CryptFilterPublicKey < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CryptFilterPublicKey"
         def cipher_method; self[:CFM]&.to_sym; end
         def auth_event; self[:AuthEvent]&.to_sym; end
         def recipients; self[:Recipients]; end
@@ -49,6 +52,7 @@ module Pdfrb
       # Crypt Filter Public Key Map (s7.6.5, Table 26). Maps per-page
       # public-key crypt filters.
       class CryptFilterPublicKeyMap < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CryptFilterPublicKeyMap"
         def filter_for(stream_name)
           value[stream_name.to_sym] || value[stream_name.to_s]
         end

data/lib/pdfrb/model/type/destination.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Explicit destination array [page, display_type, *params]
+      # (s12.3.2.2). Element 0 is a page reference (or integer page
+      # number); element 1 names the display mode.
+      class Destination < Pdfrb::Model::PdfArray
+        def page_ref; self[0]; end
+        def display_type; self[1]; end
+
+        # True when element 0 is an integer page number (GoTo D form).
+        def page_number?
+          page_ref.is_a?(Integer)
+        end
+
+        def page_number
+          page_ref if page_number?
+        end
+
+        def xyz?; display_type == :XYZ; end
+        def fit?; display_type == :Fit; end
+        def fit_h?; display_type == :FitH; end
+        def fit_v?; display_type == :FitV; end
+        def fit_r?; display_type == :FitR; end
+        def fit_b?; display_type == :FitB; end
+        def fit_bh?; display_type == :FitBH; end
+        def fit_bv?; display_type == :FitBV; end
+      end
+
+      # [page, :XYZ, left, top, zoom] — window positioned at a point
+      # (s12.3.2.2, Table 151).
+      class DestinationXYZ < Destination
+        arlington_object "DestXYZArray"
+
+        def left; self[2]; end
+        def top; self[3]; end
+        def zoom; self[4]; end
+
+        def retains_position?
+          left.nil? && top.nil?
+        end
+      end
+
+      # [page, :Fit] — whole page fits the window (s12.3.2.2).
+      class DestinationFit < Destination
+        arlington_object "Dest0Array"
+      end
+
+      # [page, :FitH, top] — page width fits the window (s12.3.2.2).
+      class DestinationFitH < Destination
+        arlington_object "Dest1Array"
+
+        def top; self[2]; end
+      end
+
+      # [page, :FitR, left, bottom, right, top] — rectangle fits the
+      # window (s12.3.2.2).
+      class DestinationFitR < Destination
+        arlington_object "Dest4Array"
+
+        def left; self[2]; end
+        def bottom; self[3]; end
+        def right; self[4]; end
+        def top; self[5]; end
+      end
+
+      # Structure-destination variants (s7.9.4, PDF 1.3+ tagging).
+      # Element 0 may be a structure element reference (string) instead
+      # of a page — used by GoToE /D chains with structure content.
+      class DestinationXYZStruct < DestinationXYZ
+        arlington_object "DestXYZStructArray"
+
+        def struct_ref?; page_ref.is_a?(String); end
+      end
+
+      class DestinationFitStruct < DestinationFit
+        arlington_object "Dest0StructArray"
+
+        def struct_ref?; page_ref.is_a?(String); end
+      end
+
+      class DestinationFitHStruct < DestinationFitH
+        arlington_object "Dest1StructArray"
+
+        def struct_ref?; page_ref.is_a?(String); end
+      end
+
+      class DestinationFitRStruct < DestinationFitR
+        arlington_object "Dest4StructArray"
+
+        def struct_ref?; page_ref.is_a?(String); end
+      end
+
+      # Destination dictionary (s12.3.2.3). Wraps a destination in
+      # target-dictionary chains (GoToE /D). /SD is the structure
+      # destination form.
+      class DestinationDict < Pdfrb::Model::Cos::Dictionary
+        arlington_object "DestDict"
+
+        def d; self[:D]; end
+        def sd; self[:SD]; end
+
+        def structure_destination?
+          !sd.nil?
+        end
+      end
+
+      # /Dests dictionary (s7.7.4, deprecated 2.0). Name → destination
+      # map living on the (page or) catalog.
+      class DestsMap < Pdfrb::Model::Cos::Dictionary
+        arlington_object "DestsMap"
+
+        def [](name)
+          value[name.to_sym] || value[name.to_s]
+        end
+
+        def add(name, destination)
+          value[name.to_sym] = destination
+          name.to_sym
+        end
+
+        def each_destination(&)
+          return enum_for(:each_destination) unless block_given?
+
+          value.each(&)
+        end
+
+        def names
+          value.keys
+        end
+      end
+    end
+  end
+end

data/lib/pdfrb/model/type.rb

@@ -311,6 +311,19 @@ module Pdfrb
       autoload :OutputIntentsContainer, "pdfrb/model/type/misc_helpers"
       autoload :CMapStream, "pdfrb/model/type/misc_helpers"
 
+      # Explicit destination arrays + maps (s12.3.2).
+      autoload :Destination, "pdfrb/model/type/destination"
+      autoload :DestinationXYZ, "pdfrb/model/type/destination"
+      autoload :DestinationFit, "pdfrb/model/type/destination"
+      autoload :DestinationFitH, "pdfrb/model/type/destination"
+      autoload :DestinationFitR, "pdfrb/model/type/destination"
+      autoload :DestinationXYZStruct, "pdfrb/model/type/destination"
+      autoload :DestinationFitStruct, "pdfrb/model/type/destination"
+      autoload :DestinationFitHStruct, "pdfrb/model/type/destination"
+      autoload :DestinationFitRStruct, "pdfrb/model/type/destination"
+      autoload :DestinationDict, "pdfrb/model/type/destination"
+      autoload :DestsMap, "pdfrb/model/type/destination"
+
       # Crypt filter (s7.6.5).
       autoload :CryptFilter, "pdfrb/model/type/crypt_filter"
       autoload :CryptFilterMap, "pdfrb/model/type/crypt_filter"

data/lib/pdfrb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pdfrb
-  VERSION = "0.7.24"
+  VERSION = "0.7.25"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.24
+  version: 0.7.25
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-19 00:00:00.000000000 Z
+date: 2026-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -941,6 +941,7 @@ files:
 - lib/pdfrb/linearization/writer.rb
 - lib/pdfrb/model.rb
 - lib/pdfrb/model/cos.rb
+- lib/pdfrb/model/cos/arlington_backed.rb
 - lib/pdfrb/model/cos/dictionary.rb
 - lib/pdfrb/model/cos/fields.rb
 - lib/pdfrb/model/cos/name_encoding.rb
@@ -1017,6 +1018,7 @@ files:
 - lib/pdfrb/model/type/collection_subitem.rb
 - lib/pdfrb/model/type/crypt_filter.rb
 - lib/pdfrb/model/type/d_part.rb
+- lib/pdfrb/model/type/destination.rb
 - lib/pdfrb/model/type/device_n.rb
 - lib/pdfrb/model/type/device_n_mixing_hints.rb
 - lib/pdfrb/model/type/device_n_process.rb