pdfrb 0.7.23 → 0.7.25

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8d9ae8c6a5750a4998d51924dc9d011b6b41565e2435e7dc87f25e913a5bf532
-  data.tar.gz: 7041b81cedd1d7387cc5ba54829da445add3278151d6579f30da6192d0244043
+  metadata.gz: 1eb0494d4b1e603ab1e6fad59bb5daa3d3ad1df02dcd57ed6b2f2445655b72d2
+  data.tar.gz: 3e6aae264376ab5f3027d89500d883bea9fe95a39fadc2bd01cc0f83b4914c45
 SHA512:
-  metadata.gz: 35a3f9fe4ea0933fd2e33b2089799e32477e04824884ccc29f0c78377699d051a584e3facaef01c5a62666568db22f859557c394daff2c96c441574c2a054d75
-  data.tar.gz: 6baf785a854c19b549f6d66807bc9531fdd665164c6a02ab1570650a5faf9a8a5d5c412b7a7d01a9b467b4fb24301f53ac456bc6579d24615be837e786476a00
+  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/collection.rb

@@ -7,6 +7,7 @@ module Pdfrb
       # collection of embedded files with a presentation schema. Lives
       # on Catalog /Collection.
       class Collection < Pdfrb::Model::Cos::Dictionary
+        arlington_object "Collection"
         def schema; self[:Schema]; end
         def default_view; self[:View]; end
         def sort; self[:Sort]; end

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Collection colors (s7.11.5, PDF 1.7 Adobe extension level 3).
+      # UI color scheme for the portfolio view; each value is a 0..1 RGB
+      # or Gray component array.
+      class CollectionColors < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CollectionColors"
+
+        def background; self[:Background]; end
+        def card_background; self[:CardBackground]; end
+        def card_border; self[:CardBorder]; end
+        def primary_text; self[:PrimaryText]; end
+        def secondary_text; self[:SecondaryText]; end
+
+        def gray_background?
+          components(background) == 1
+        end
+
+        def rgb_background?
+          components(background) == 3
+        end
+
+        private
+
+        def components(color)
+          return 0 if color.nil?
+
+          color.is_a?(Pdfrb::Model::PdfArray) ? color.to_a.size : 0
+        end
+      end
+    end
+  end
+end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Collection field (s7.11.5). One column definition.
       class CollectionField < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CollectionField"
         def name; self[:N]; end
         def field_type; self[:Subtype]; end
         def order; self[:O]; end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Collection folder (s7.11.5, PDF 1.7 Adobe extension level 3).
+      # A folder node in the portfolio's folder hierarchy.
+      class CollectionFolder < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CollectionFolder"
+
+        def id; self[:ID]; end
+        def name; self[:Name]; end
+        def parent; self[:Parent]; end
+        def child; self[:Child]; end
+        def next_folder; self[:Next]; end
+        def collection_item; self[:CI]; end
+        def description; self[:Desc]; end
+        def creation_date; self[:CreationDate]; end
+        def modified_date; self[:ModDate]; end
+        def thumbnail; self[:Thumb]; end
+        def free; self[:Free]; end
+
+        def root_folder?
+          parent.nil?
+        end
+
+        def has_children?
+          !child.nil?
+        end
+      end
+    end
+  end
+end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Collection item (s7.11.5). Per-embedded-file values for the
       # schema fields.
       class CollectionItem < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CollectionItem"
         def value_for(field_name)
           self[field_name.to_sym] || self[field_name.to_s]
         end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Collection schema (s7.11.5). Defines the columns/fields shown
       # in the portfolio view.
       class CollectionSchema < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CollectionSchema"
         def fields
           value.keys
         end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Collection sort (s7.11.5). Defines default sort order.
       class CollectionSort < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CollectionSort"
         def field_name; self[:S]; end
         def descending?; truthy?(self[:A]); end
       end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Collection split (s7.11.5, PDF 1.7 Adobe extension level 3).
+      # Where the portfolio view places the split between panels.
+      class CollectionSplit < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CollectionSplit"
+
+        def direction; self[:Direction]; end
+        def position; self[:Position]; end
+
+        def vertical?
+          direction == :V
+        end
+
+        def horizontal?
+          direction == :H
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Collection subitem (s7.11.5, PDF 1.7 Adobe extension level 3).
+      # Assigns one embedded file to a folder via the folder's /P path
+      # and the /D display value.
+      class CollectionSubitem < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CollectionSubitem"
+
+        def display_value; self[:D]; end
+        def parent_folder_path; self[:P]; end
+
+        def numeric_display?
+          display_value.is_a?(Numeric)
+        end
+      end
+    end
+  end
+end

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"
@@ -337,6 +350,10 @@ module Pdfrb
       autoload :CollectionSort, "pdfrb/model/type/collection_sort"
       autoload :CollectionField, "pdfrb/model/type/collection_field"
       autoload :CollectionItem, "pdfrb/model/type/collection_item"
+      autoload :CollectionColors, "pdfrb/model/type/collection_colors"
+      autoload :CollectionFolder, "pdfrb/model/type/collection_folder"
+      autoload :CollectionSplit, "pdfrb/model/type/collection_split"
+      autoload :CollectionSubitem, "pdfrb/model/type/collection_subitem"
 
       # Signature transform parameters (s12.8.2).
       autoload :MDPDict, "pdfrb/model/type/mdp_dict"

data/lib/pdfrb/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.23
+  version: 0.7.25
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-18 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
@@ -1007,12 +1008,17 @@ files:
 - lib/pdfrb/model/type/cid_system_info.rb
 - lib/pdfrb/model/type/circle_annotation.rb
 - lib/pdfrb/model/type/collection.rb
+- lib/pdfrb/model/type/collection_colors.rb
 - lib/pdfrb/model/type/collection_field.rb
+- lib/pdfrb/model/type/collection_folder.rb
 - lib/pdfrb/model/type/collection_item.rb
 - lib/pdfrb/model/type/collection_schema.rb
 - lib/pdfrb/model/type/collection_sort.rb
+- lib/pdfrb/model/type/collection_split.rb
+- 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