pdfrb 0.7.15 → 0.7.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0117148def4f7bc7280fa9727a6ce26fcafa9cb8f6e31cb32a480cb9548ac99e'
-  data.tar.gz: a7bf629aabbef013625f56e4c719f97a4fa6bc2823c158d4d7f37ea9c6ff8379
+  metadata.gz: c59e3261ad38e5013f1adae6c5a5f48197ddfdc6226acd96e7fe09e6d7d9b3a5
+  data.tar.gz: f39fadf09d0a6b8ad2a401111c12384ac3a2fab66f7bbf8c40dc55cc174f1775
 SHA512:
-  metadata.gz: f7d17104eaf145c31e843f94e622dd181b965f18aa4e3aba4adb80bedbdb500855984c603ef2ce60fa4abec31d1e4a07841d96397a71452147a6bff19c122b94
-  data.tar.gz: e3513e197dff0e244f97adff17e332ff74b75509054449c32a779e8926bf1fbb91f9965b8a5757f78dbeb54f5e09741260b4139aef31f79cb0caaa25ca878b17
+  metadata.gz: 8cc9ef29aa8e9be785306010db555dc7bdac6ddd45c6de13107bb0cf194b5c28091d13b61a321252edc39ec41500b82eb478b338aae88480eae6c51e7861416b
+  data.tar.gz: 14ed721ff08a6a3fc8a6ce8cd3ced4aa09edec502c870d008aef7a9f7374cddcedf8ab4472e3d48773773e4b8530b059ed73fd42ec1ba5988af7ae2cc98cece6

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

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Bead (ISO 32000-2 §12.4.3, PDF 1.1+). A single rectangular
+      # portion of a page that is part of a Thread (article). Beads
+      # form a doubly-linked list via /N (next) and /V (previous).
+      class Bead < Pdfrb::Model::Cos::Dictionary
+        arlington_object "Bead"
+
+        # /Type — optional, fixed "Bead".
+        def type
+          value[:Type]&.to_sym
+        end
+
+        # /T — optional indirect Thread this bead belongs to.
+        def thread(document = nil)
+          ref = value[:T]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /N — required indirect next Bead.
+        def next_bead(document = nil)
+          ref = value[:N]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /V — required indirect previous Bead.
+        def previous_bead(document = nil)
+          ref = value[:V]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /P — required indirect Page the bead sits on.
+        def page(document = nil)
+          ref = value[:P]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /R — required rectangle on the page.
+        def rect
+          value[:R]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Thread (ISO 32000-2 §12.4.2, PDF 1.1+). Represents an
+      # article — a sequence of text blocks that flows across pages
+      # (e.g. a newspaper column that continues on a later page).
+      # Threads are listed in the Catalog's /Threads array.
+      class Thread < Pdfrb::Model::Cos::Dictionary
+        arlington_object "Thread"
+
+        # /Type — optional, fixed "Thread".
+        def type
+          value[:Type]&.to_sym
+        end
+
+        # /F — required indirect reference to the first Bead in
+        # the thread.
+        def first_bead(document = nil)
+          ref = value[:F]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /I — optional DocInfo dict with article metadata.
+        def info(document = nil)
+          ref = value[:I]
+          return nil unless ref && document
+
+          resolved = ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+          return nil unless resolved
+
+          Pdfrb::Model::Type::Info.new(resolved.value) if resolved.value.is_a?(::Hash)
+        end
+
+        # /Metadata — optional indirect stream (PDF 2.0).
+        def metadata(document = nil)
+          ref = value[:Metadata]
+          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/trap_region.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # TrapRegion (Adobe TechNote 5620 §5.34, PDF 1.3, deprecated
+      # PDF 2.0). A trapping (prepress) region on a page. Referenced
+      # from /Annots as /Subtype /Traps or from separation profiles.
+      class TrapRegion < Pdfrb::Model::Cos::Dictionary
+        arlington_object "TrapRegion"
+
+        # /TP — required name: trapping parameters version.
+        def trap_parameters
+          value[:TP]
+        end
+
+        # /TZ — optional array-of-arrays of numbers defining trap
+        # zones.
+        def trap_zones
+          value[:TZ]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # WebCaptureCommand (ISO 32000-1 §14.10.4, PDF 1.3, deprecated
+      # PDF 2.0). Describes a URL retrieval for the Web Capture
+      # (spider) system: what to fetch, how to fetch it, and what
+      # form data to post.
+      class WebCaptureCommand < Pdfrb::Model::Cos::Dictionary
+        arlington_object "WebCaptureCommand"
+
+        # /URL — required ASCII string to retrieve.
+        def url
+          value[:URL]
+        end
+
+        # /L — optional integer, delay before retrieval in seconds
+        # (default 1). Must be >= 1.
+        def delay_seconds
+          value[:L] || 1
+        end
+
+        # /F — optional bitmask of flags.
+        def flags
+          value[:F] || 0
+        end
+
+        # /CT — optional content type of posted data (RFC 2045).
+        def content_type
+          value[:CT] || "application/x-www-form-urlencoded"
+        end
+
+        # /S — optional WebCaptureCommandSettings dict.
+        def settings(document = nil)
+          ref = value[:S]
+          return nil unless ref && document
+
+          resolved = ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+          return nil unless resolved
+
+          Pdfrb::Model::Type::WebCaptureCommandSettings.new(resolved.value)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # WebCaptureCommandSettings (ISO 32000-1 §14.10.4, PDF 1.3,
+      # deprecated PDF 2.0). Browser-like settings (get/post data,
+      # cookies) for a WebCaptureCommand.
+      class WebCaptureCommandSettings < Pdfrb::Model::Cos::Dictionary
+        arlington_object "WebCaptureCommandSettings"
+
+        # /G — optional GET parameters dictionary.
+        def get_params
+          value[:G]
+        end
+
+        # /C — optional cookie parameters dictionary.
+        def cookie_params
+          value[:C]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # WebCaptureImageSet (ISO 32000-1 §14.10.3, PDF 1.3, deprecated
+      # PDF 2.0). A spider content set holding captured images. The
+      # /O array lists image XObjects; /R gives the crawl depth for
+      # each image.
+      class WebCaptureImageSet < Pdfrb::Model::Cos::Stream
+        arlington_object "WebCaptureImageSet"
+
+        # /Type — optional, fixed "SpiderContentSet".
+        def type
+          value[:Type]&.to_sym
+        end
+
+        # /S — required, fixed "SIS" (Spider Image Set).
+        def set_type
+          value[:S]&.to_sym
+        end
+
+        # /ID — required unique identifier.
+        def set_id
+          value[:ID]
+        end
+
+        # /O — required array of indirect references to images.
+        def images(document = nil)
+          refs = value[:O]
+          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
+
+        # /CT — optional content type (RFC 2045).
+        def content_type
+          value[:CT]
+        end
+
+        # /TS — optional date of capture.
+        def timestamp
+          value[:TS]
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # WebCapturePageSet (ISO 32000-1 §14.10.3, PDF 1.3, deprecated
+      # PDF 2.0). A spider content set holding captured pages. The
+      # /O array lists page objects converted from HTML.
+      class WebCapturePageSet < Pdfrb::Model::Cos::Stream
+        arlington_object "WebCapturePageSet"
+
+        # /Type — optional, fixed "SpiderContentSet".
+        def type
+          value[:Type]&.to_sym
+        end
+
+        # /S — required, fixed "SPS" (Spider Page Set).
+        def set_type
+          value[:S]&.to_sym
+        end
+
+        # /ID — required unique identifier.
+        def set_id
+          value[:ID]
+        end
+
+        # /O — required array of indirect references to pages.
+        def pages(document = nil)
+          refs = value[:O]
+          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
+
+        # /CT — optional content type.
+        def content_type
+          value[:CT]
+        end
+
+        # /TS — optional date of capture.
+        def timestamp
+          value[:TS]
+        end
+      end
+
+      # WebCaptureInfo (ISO 32000-1 §14.10.2, PDF 1.3, deprecated
+      # PDF 2.0). Root dictionary for the Web Capture system, listed
+      # in the Catalog's /SpiderInfo key.
+      class WebCaptureInfo < Pdfrb::Model::Cos::Dictionary
+        arlington_object "WebCaptureInfo"
+
+        # /V — required version number (fixed 1).
+        def version
+          value[:V]
+        end
+
+        # /C — optional array of WebCaptureCommands.
+        def commands(document = nil)
+          refs = value[:C]
+          return [] unless refs && document
+
+          arr = refs.is_a?(Pdfrb::Model::PdfArray) ? refs.value : refs
+          arr = [arr] unless arr.is_a?(::Array)
+          arr.filter_map do |r|
+            resolved = r.is_a?(Pdfrb::Model::Reference) ? document.object(r) : r
+            next nil unless resolved && resolved.value.is_a?(::Hash)
+
+            Pdfrb::Model::Type::WebCaptureCommand.new(resolved.value)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pdfrb/model/type.rb

@@ -371,6 +371,20 @@ module Pdfrb
 
       # User property (s14.7.5).
       autoload :UserProperty, "pdfrb/model/type/user_property"
+
+      # Threads/articles (s12.4).
+      autoload :Thread, "pdfrb/model/type/thread"
+      autoload :Bead, "pdfrb/model/type/bead"
+
+      # Web Capture / spider (s14.10, PDF 1.3, deprecated 2.0).
+      autoload :WebCaptureInfo, "pdfrb/model/type/web_capture_page_set"
+      autoload :WebCaptureCommand, "pdfrb/model/type/web_capture_command"
+      autoload :WebCaptureCommandSettings, "pdfrb/model/type/web_capture_command_settings"
+      autoload :WebCaptureImageSet, "pdfrb/model/type/web_capture_image_set"
+      autoload :WebCapturePageSet, "pdfrb/model/type/web_capture_page_set"
+
+      # Trapping (Adobe TechNote 5620).
+      autoload :TrapRegion, "pdfrb/model/type/trap_region"
     end
   end
 end

data/lib/pdfrb/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.15
+  version: 0.7.16
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-14 00:00:00.000000000 Z
+date: 2026-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -980,6 +980,7 @@ files:
 - lib/pdfrb/model/type/appearance_characteristics.rb
 - lib/pdfrb/model/type/appearance_generator.rb
 - 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_styling.rb
 - lib/pdfrb/model/type/box_color_info.rb
@@ -1133,6 +1134,7 @@ files:
 - lib/pdfrb/model/type/text_appearance.rb
 - lib/pdfrb/model/type/text_field.rb
 - lib/pdfrb/model/type/text_markup_annotation.rb
+- lib/pdfrb/model/type/thread.rb
 - lib/pdfrb/model/type/three_d_activation.rb
 - lib/pdfrb/model/type/three_d_animation_style.rb
 - lib/pdfrb/model/type/three_d_background.rb
@@ -1154,6 +1156,7 @@ files:
 - lib/pdfrb/model/type/timespan.rb
 - lib/pdfrb/model/type/to_unicode_cmap_stream.rb
 - lib/pdfrb/model/type/transition.rb
+- lib/pdfrb/model/type/trap_region.rb
 - lib/pdfrb/model/type/underline_annotation.rb
 - lib/pdfrb/model/type/ur_transform_parameters.rb
 - lib/pdfrb/model/type/uri_dict.rb
@@ -1164,6 +1167,10 @@ files:
 - lib/pdfrb/model/type/viewport.rb
 - lib/pdfrb/model/type/vri.rb
 - lib/pdfrb/model/type/watermark_annotation.rb
+- lib/pdfrb/model/type/web_capture_command.rb
+- lib/pdfrb/model/type/web_capture_command_settings.rb
+- lib/pdfrb/model/type/web_capture_image_set.rb
+- lib/pdfrb/model/type/web_capture_page_set.rb
 - lib/pdfrb/model/type/widget_annotation.rb
 - lib/pdfrb/model/type/widget_appearance.rb
 - lib/pdfrb/model/type/xobject_form.rb