pdfrb 0.7.19 → 0.7.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ceb6a2eec5eb948c98085aaca1c41b6101dd5970201fd9fd93af5d4a749dfe6
-  data.tar.gz: 15b493786db9a355ee20c35a4975ceb81a36118c294a90fc429398f5029086da
+  metadata.gz: 8fede6fc181df1691732c051b8339ee2bded64c7f393691fd9dd5b0f151082e9
+  data.tar.gz: a602406104c68a47a6d5ddca09fedaa12831528c9cb603a9dab0a123f171004f
 SHA512:
-  metadata.gz: a2c9c5c3253f4b0b9546ad908af4dfc5439c57de7d4fc669059144f4f1410255a6aaa9fffa68ee77233796a192e574398c02994f7fa558a760e16d7c79a44869
-  data.tar.gz: b9aa959023df3ec4ed99d65c05b26b4717cf5260a00a0781daa20fda52cb88b7d4e700ca6f94f0987d35f58bdd534a41b3e5a0649a0d7f6d3f0f9a2a7e2d20d5
+  metadata.gz: 7822801383bb40e5d381f4b10801de93b3271304ff2b748ca6a2e1182de9620c5694920c1ddfa4d4bfceb15033fa6b6e069addb76fcdc1721c3ccde104da226d
+  data.tar.gz: 94a2bbcb98addcb843be49ffdce5a75e693f34f7384106c8036f6247b66751c760176a55b55b6e407d24935ff26f1700512da96a827ef2d0e02ca70e8a9e48e2

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Additional Actions on a page object (ISO 32000-2 §12.6.3.16,
+      # PDF 1.2+). /O fires on page open, /C on page close.
+      class AddActionPageObject < Pdfrb::Model::Cos::Dictionary
+        arlington_object "AddActionPageObject"
+
+        # /O — action(s) on page open.
+        def on_open(document = nil)
+          resolve_action(:O, document)
+        end
+
+        # /C — action(s) on page close.
+        def on_close(document = nil)
+          resolve_action(:C, document)
+        end
+
+        private
+
+        def resolve_action(key, document)
+          ref = value[key]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+      end
+    end
+  end
+end

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

@@ -7,20 +7,23 @@ module Pdfrb
       # annotation holds three sub-dicts: /N (normal), /R (rollover),
       # /D (down).
       class Appearance < Pdfrb::Model::Cos::Dictionary
+        arlington_object "Appearance"
         def normal; self[:N]; end
         def rollover; self[:R]; end
         def down; self[:D]; end
 
+        # Presence checks use the raw value (not the Arlington
+        # default) because /D defaults to /N's value per the spec.
         def has_normal?
-          !!normal
+          !value[:N].nil?
         end
 
         def has_rollover?
-          !!rollover
+          !value[:R].nil?
         end
 
         def has_down?
-          !!down
+          !value[:D].nil?
         end
 
         def normal_for_state(state_name)

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

@@ -8,6 +8,7 @@ module Pdfrb
       # colors, normal/rollover/down captions, etc. Often stored under
       # the widget's /MK key.
       class AppearanceCharacteristics < Pdfrb::Model::Cos::Dictionary
+        arlington_object "AppearanceCharacteristics"
         def background_color; self[:BG]; end
         def caption; self[:CA]; end
         def rollover_caption; self[:RC]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # AppearanceTrapNet sub-dictionary (s7.7.3.3, Table 327). Per-
       # appearance-stream trap-net (ink-flattening) parameters.
       class AppearanceTrapNetSubDict < Pdfrb::Model::Cos::Dictionary
+        arlington_object "AppearanceTrapNet"
         def pos_h; self[:PosH]; end
         def pos_l; self[:PosL]; end
         def span_h_min; self[:SpanH]; end

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

@@ -3,13 +3,14 @@
 module Pdfrb
   module Model
     module Type
-      # BorderEffect (s12.5.4.2). Cloudy / inset border effects for
-      # annotations.
-      class BorderEffect < Cos::Dictionary
+      # BorderEffect (ISO 32000-2 §12.5.4.2, PDF 1.5+). Cloudy /
+      # inset border effects for annotations, via the /BE dict.
+      class BorderEffect < Pdfrb::Model::Cos::Dictionary
+        arlington_object "BorderEffect"
         register_type :BorderEffect
 
         def type; self[:Type]; end
-        def style; self[:S]&.to_sym; end
+        def style; (self[:S] || :S).to_sym; end
         def intensity; self[:I] || 0; end
 
         def cloudy?

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # BorderStyle (ISO 32000-2 §12.5.4, PDF 1.2+). The /BS dict on
+      # an annotation, controlling line width, style, and dash
+      # pattern.
+      class BorderStyle < Pdfrb::Model::Cos::Dictionary
+        arlington_object "BorderStyle"
+
+        # /W — optional, border width in points (default 1).
+        def width
+          value[:W] || 1
+        end
+
+        # /S — optional, border style name (default :S).
+        # S = solid, D = dashed, B = beveled, I = inset, U = underline.
+        def style
+          (value[:S] || :S).to_sym
+        end
+
+        # /D — optional, dash pattern array (only when style == :D).
+        def dash
+          value[:D]
+        end
+
+        def solid?; style == :S; end
+        def dashed?; style == :D; end
+        def beveled?; style == :B; end
+        def inset?; style == :I; end
+        def underline?; style == :U; end
+      end
+    end
+  end
+end

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

@@ -7,6 +7,7 @@ module Pdfrb
       # its Character ID system: registry, ordering, supplement.
       # Required for proper glyph interpretation.
       class CIDSystemInfo < Pdfrb::Model::Cos::Dictionary
+        arlington_object "CIDSystemInfo"
         def registry; self[:Registry]; end
         def ordering; self[:Ordering]; end
         def supplement; self[:Supplement]; end

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

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # DPartRoot (ISO 16612-2 PDF/VT §6.3.4). The root of the
+      # Document Part hierarchy, attached to the Catalog via the
+      # /DPartRoot key. Represents the root node of a tree whose
+      # leaves are groups of document parts.
+      class DPartRoot < Pdfrb::Model::Cos::Dictionary
+        arlington_object "DPartRoot"
+
+        # /Type — optional, fixed "DPartRoot".
+        def type
+          value[:Type]&.to_sym
+        end
+
+        # /DPartRootNode — required indirect reference to the
+        # first DPart child.
+        def root_node(document = nil)
+          ref = value[:DPartRootNode]
+          return nil unless ref && document
+
+          resolved = ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+          return nil unless resolved && resolved.value.is_a?(::Hash)
+
+          DPart.new(resolved.value)
+        end
+
+        # /RecordLevel — optional integer >= 0, the nesting depth
+        # at which DParts represent individual records.
+        def record_level
+          value[:RecordLevel]
+        end
+
+        # /NodeNameList — optional array of names identifying the
+        # tree levels (required for PDF/VT-2).
+        def node_name_list
+          value[:NodeNameList]
+        end
+      end
+
+      # DPart (ISO 16612-2 PDF/VT §6.3.5). One node in the Document
+      # Part hierarchy. Either has /DParts (a tree of child DParts)
+      # or /Start + /End pointing to the page range it covers.
+      class DPart < Pdfrb::Model::Cos::Dictionary
+        arlington_object "DPart"
+
+        # /Type — optional, fixed "DPart".
+        def type
+          value[:Type]&.to_sym
+        end
+
+        # /Parent — required indirect ref to the containing DPart
+        # or DPartRoot (may be absent when Metadata is present).
+        def parent(document = nil)
+          ref = value[:Parent]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /DParts — array of arrays of child DParts. Mutually
+        # exclusive with /Start + /End.
+        def child_parts
+          value[:DParts]
+        end
+
+        # /Start — indirect ref to the first Page in this part.
+        def start_page(document = nil)
+          ref = value[:Start]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /End — indirect ref to the last Page in this part.
+        def end_page(document = nil)
+          ref = value[:End]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        def leaf?
+          child_parts.nil?
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # DSS (Document Security Store) per ETSI EN 319 142-1 (PAdES)
+      # §B.5. Attached to the Catalog via the /DSS key. Holds the
+      # long-term validation material: certificates, CRLs, OCSP
+      # responses, and per-signature VRI dictionaries.
+      class Dss < Pdfrb::Model::Cos::Dictionary
+        arlington_object "DSS"
+
+        # /Type — optional, fixed "DSS".
+        def type
+          value[:Type]&.to_sym
+        end
+
+        # /Certs — array of indirect streams, each a DER-encoded
+        # X.509 certificate used by any signature in the document.
+        def certificates(document = nil)
+          resolve_streams(value[:Certs], document)
+        end
+
+        # /OCSPs — array of indirect streams, each a DER-encoded
+        # OCSP response.
+        def ocsp_responses(document = nil)
+          resolve_streams(value[:OCSPs], document)
+        end
+
+        # /CRLs — array of indirect streams, each a DER-encoded
+        # certificate revocation list.
+        def crls(document = nil)
+          resolve_streams(value[:CRLs], document)
+        end
+
+        # /VRI — optional map of SHA-1 hex digest -> VRI dict for
+        # each signature. Returns the raw Hash.
+        def vri_map
+          value[:VRI]
+        end
+
+        # Enumerate each (signature-hash, Vri) pair, resolving the
+        # VRI dicts to typed instances.
+        def each_vri(document = nil)
+          return enum_for(:each_vri, document) unless block_given?
+
+          map = vri_map
+          return unless map
+
+          raw = map.is_a?(Pdfrb::Model::Cos::Dictionary) ? map.value : map
+          raw.each do |sig_hash, ref|
+            resolved = if ref.is_a?(Pdfrb::Model::Reference) && document
+                         document.object(ref)
+                       else
+                         ref
+                       end
+            next unless resolved && resolved.value.is_a?(::Hash)
+
+            yield sig_hash.to_s, Vri.new(resolved.value)
+          end
+        end
+
+        # Look up a VRI by the hex-encoded SHA-1 digest of the
+        # signature's DER bytes.
+        def vri_for(signature_sha1_hex, document = nil)
+          each_vri(document).find { |h, _v| h == signature_sha1_hex }&.last
+        end
+
+        private
+
+        def resolve_streams(refs, document)
+          return [] unless refs && document
+
+          arr = refs.is_a?(Pdfrb::Model::PdfArray) ? refs.value : refs
+          arr = [arr] unless arr.is_a?(::Array)
+          arr.filter_map { |r| r.is_a?(Pdfrb::Model::Reference) ? document.object(r) : r }
+        end
+      end
+    end
+  end
+end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Movie dictionary (s13.4). Deprecated since PDF 2.0 but still
       # appears in legacy PDFs. Use Screen + Rendition actions instead.
       class Movie < Pdfrb::Model::Cos::Dictionary
+        arlington_object "Movie"
         def type; self[:Type]; end
         def file_spec; self[:F]; end
         def aspect; self[:Aspect]; end

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

@@ -7,6 +7,7 @@ module Pdfrb
       # /R = sampling rate, /C = channels, /B = bits/sample, /E =
       # encoding (Raw, Signed, MuLaw, ALaw).
       class Sound < Pdfrb::Model::Cos::Stream
+        arlington_object "SoundObject"
         def type; self[:Type]; end
         def sampling_rate; self[:R]; end
         def channels; self[:C] || 1; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # 3D Activation (s13.6.2). Controls when a 3D stream becomes
       # active and how it's deactivated.
       class ThreeDActivation < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DActivation"
         def activation_mode; self[:A]&.to_sym; end
         def activation_instance; self[:AIS]&.to_sym; end
         def deactivation_mode; self[:D]&.to_sym; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # 3D Animation Style (s13.6.3, Table 312-313). Animation control
       # for a 3D stream.
       class ThreeDAnimationStyle < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DAnimationStyle"
         def type; self[:Type]; end
         def subtype; self[:Subtype]&.to_sym; end
         def play_count; self[:PC] || 0; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Background (s13.6.4). Background fill for a 3D view.
       class ThreeDBackground < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DBackground"
         def type; self[:Type]; end
         def subtype; self[:Subtype]&.to_sym; end
         def color_space; self[:CS]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Cross Section (s13.6.4). Plane cutaway view of a 3D model.
       class ThreeDCrossSection < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DCrossSection"
         def type; self[:Type]; end
         def center; self[:C]; end
         def orientation; self[:O]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Lighting Scheme (s13.6.4, Table 320-321). Lighting preset.
       class ThreeDLightingScheme < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DLightingScheme"
         def type; self[:Type]; end
         def subtype; self[:Subtype]&.to_sym; end
 

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Comment (3DC) measure (s13.6.4). A 3D measurement note.
       class ThreeDMeasure3DC < ThreeDMeasure
+        arlington_object "3DMeasure3DC"
         def text; self[:TRL]; end
         def anchor; self[:A1]; end
         def name; self[:N1]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Angle Distance measure (AD3, s13.6.4).
       class ThreeDMeasureAD3 < ThreeDMeasure
+        arlington_object "3DMeasureAD3"
         def annotation1; self[:A1]; end
         def annotation2; self[:A2]; end
         def angle; self[:A]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Linear Distance measure (LD3, s13.6.4).
       class ThreeDMeasureLD3 < ThreeDMeasure
+        arlington_object "3DMeasureLD3"
         def annotation1; self[:A1]; end
         def annotation2; self[:A2]; end
         def distance; self[:D]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Perpendicular Distance measure (PD3, s13.6.4).
       class ThreeDMeasurePD3 < ThreeDMeasure
+        arlington_object "3DMeasurePD3"
         def annotation1; self[:A1]; end
         def annotation2; self[:A2]; end
         def distance; self[:D]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Radial Distance measure (RD3, s13.6.4).
       class ThreeDMeasureRD3 < ThreeDMeasure
+        arlington_object "3DMeasureRD3"
         def annotation1; self[:A1]; end
         def annotation2; self[:A2]; end
         def distance; self[:D]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Node (s13.6.4). A node in a 3D model's scene graph.
       class ThreeDNode < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DNode"
         def type; self[:Type]; end
         def name; self[:N]; end
         def opacity; self[:O]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # 3D Reference (s13.6.5). Indirect reference to a 3D stream
       # elsewhere in the document.
       class ThreeDReference < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DReference"
         def type; self[:Type]; end
         def target_stream; self[:Target]; end
 

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

@@ -6,6 +6,7 @@ module Pdfrb
       # 3D Render Mode (s13.6.4, Table 318-319). Rendering style for
       # 3D objects (solid, wireframe, transparent, etc.).
       class ThreeDRenderMode < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DRenderMode"
         def type; self[:Type]; end
         def subtype; self[:Subtype]&.to_sym; end
         def auxiliary_color; self[:AC]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Stream (s13.6.3). Carries a U3D or PRC binary 3D model.
       class ThreeDStream < Pdfrb::Model::Cos::Stream
+        arlington_object "3DStream"
         def type; self[:Type]; end
         def subtype; self[:Subtype]&.to_sym; end
         def views; self[:VA]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # 3D Units (s13.6.4). Scaling factor and unit name for 3D measures.
       class ThreeDUnits < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DUnits"
         def type; self[:Type]; end
         def unit_name; self[:U]; end
         def scale_factor; self[:SF]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # 3D View (s13.6.4). A single camera/lighting/material configuration
       # for a 3D stream.
       class ThreeDView < Pdfrb::Model::Cos::Dictionary
+        arlington_object "3DView"
         def type; self[:Type]; end
         def external_name; self[:XN]; end
         def internal_name; self[:IN]; end

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

@@ -4,6 +4,7 @@ module Pdfrb
   module Model
     module Type
       class WidgetAnnotation < Annotation
+        arlington_object "AnnotWidget"
         def field; self[:Parent]; end
         def appearance_stream; self[:AP]; end
         def highlight_mode; self[:H]; end

data/lib/pdfrb/model/type.rb

@@ -394,6 +394,20 @@ module Pdfrb
 
       # Sound action (s12.6.4.11, deprecated 2.0).
       autoload :ActionSound, "pdfrb/model/type/action_sound"
+
+      # Document Security Store (ETSI EN 319 142-1 PAdES).
+      autoload :Dss, "pdfrb/model/type/dss"
+
+      # Document Part hierarchy (ISO 16612-2 PDF/VT).
+      autoload :DPartRoot, "pdfrb/model/type/d_part"
+      autoload :DPart, "pdfrb/model/type/d_part"
+
+      # Additional actions on page objects (s12.6.3.16).
+      autoload :AddActionPageObject, "pdfrb/model/type/add_action_page_object"
+
+      # Border style (s12.5.4). BorderEffect lives in its own file.
+      autoload :BorderStyle, "pdfrb/model/type/border_style"
+      autoload :BorderEffect, "pdfrb/model/type/border_effect"
     end
   end
 end

data/lib/pdfrb/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.19
+  version: 0.7.21
 platform: ruby
 authors:
 - Ribose Inc.
@@ -975,6 +975,7 @@ files:
 - lib/pdfrb/model/type/action_trans.rb
 - lib/pdfrb/model/type/action_uri.rb
 - lib/pdfrb/model/type/add_action_catalog.rb
+- lib/pdfrb/model/type/add_action_page_object.rb
 - lib/pdfrb/model/type/af_embedded_file.rb
 - lib/pdfrb/model/type/af_file_specification.rb
 - lib/pdfrb/model/type/alternate_image.rb
@@ -985,6 +986,7 @@ files:
 - lib/pdfrb/model/type/appearance_trap_net.rb
 - lib/pdfrb/model/type/bead.rb
 - lib/pdfrb/model/type/border_effect.rb
+- lib/pdfrb/model/type/border_style.rb
 - lib/pdfrb/model/type/border_styling.rb
 - lib/pdfrb/model/type/box_color_info.rb
 - lib/pdfrb/model/type/box_style.rb
@@ -1004,11 +1006,13 @@ files:
 - lib/pdfrb/model/type/collection_schema.rb
 - lib/pdfrb/model/type/collection_sort.rb
 - lib/pdfrb/model/type/crypt_filter.rb
+- lib/pdfrb/model/type/d_part.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
 - lib/pdfrb/model/type/doc_mdp_transform_parameters.rb
 - lib/pdfrb/model/type/document_security_store.rb
+- lib/pdfrb/model/type/dss.rb
 - lib/pdfrb/model/type/embedded_file.rb
 - lib/pdfrb/model/type/embedded_file_parameter.rb
 - lib/pdfrb/model/type/encryption_public_key.rb