pdfrb 0.7.15 → 0.7.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0117148def4f7bc7280fa9727a6ce26fcafa9cb8f6e31cb32a480cb9548ac99e'
-  data.tar.gz: a7bf629aabbef013625f56e4c719f97a4fa6bc2823c158d4d7f37ea9c6ff8379
+  metadata.gz: 67218c766df1cff2565d5020ad8089414e7892102117fc76a9413f0972c93648
+  data.tar.gz: 8be6840a038f7c132e10b549c3ed3f33180ea5b5b14bcc6804c01f322dac82cf
 SHA512:
-  metadata.gz: f7d17104eaf145c31e843f94e622dd181b965f18aa4e3aba4adb80bedbdb500855984c603ef2ce60fa4abec31d1e4a07841d96397a71452147a6bff19c122b94
-  data.tar.gz: e3513e197dff0e244f97adff17e332ff74b75509054449c32a779e8926bf1fbb91f9965b8a5757f78dbeb54f5e09741260b4139aef31f79cb0caaa25ca878b17
+  metadata.gz: a87239ec989b28f76e4c2f2a31e0efdc0b67a0dfb39030f51cc52b79343c2d5de42d40b7d4f816ef72ff930964b89c53f1aa4757f481eb6337f9283a4e6f5003
+  data.tar.gz: f4748a5236be87af4360070f8ae90f7a34a93ba1f782a347d772573118b6a63e7bb24c167220d4df8d69477c4014bfb90a32b39756dcd383cb90058a6cbb398a

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

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Sound action (ISO 32000-2 §12.6.4.11, PDF 1.2, deprecated
+      # PDF 2.0). Plays a sound object.
+      class ActionSound < Pdfrb::Model::Cos::Dictionary
+        arlington_object "ActionSound"
+
+        # /Type — optional, fixed "Action".
+        def type
+          value[:Type]&.to_sym
+        end
+
+        # /S — required, fixed "Sound".
+        def action_type
+          value[:S]&.to_sym
+        end
+
+        # /Sound — required indirect stream with the sound data.
+        def sound(document = nil)
+          ref = value[:Sound]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /Volume — optional, -1.0 to 1.0 (default 1.0).
+        def volume
+          value[:Volume] || 1.0
+        end
+
+        # /Synchronous — optional, default false.
+        def synchronous?
+          value[:Synchronous] == true
+        end
+
+        # /Repeat — optional, default false.
+        def repeat?
+          value[:Repeat] == true
+        end
+
+        # /Mix — optional, default false. Whether to mix with
+        # existing sounds.
+        def mix?
+          value[:Mix] == true
+        end
+
+        # /Next — optional next action(s).
+        def next_action(document = nil)
+          ref = value[:Next]
+          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/add_action_catalog.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Additional Actions for the Catalog (ISO 32000-2 §12.6.3.17,
+      # PDF 1.4+). Referenced via /AA on the Catalog dict. Each entry
+      # is an indirect ECMAScript action triggered by the named
+      # document event.
+      class AddActionCatalog < Pdfrb::Model::Cos::Dictionary
+        arlington_object "AddActionCatalog"
+
+        # /DC — document close.
+        def document_close(document = nil)
+          resolve_action(:DC, document)
+        end
+
+        # /WS — will save.
+        def will_save(document = nil)
+          resolve_action(:WS, document)
+        end
+
+        # /DS — did save.
+        def did_save(document = nil)
+          resolve_action(:DS, document)
+        end
+
+        # /WP — will print.
+        def will_print(document = nil)
+          resolve_action(:WP, document)
+        end
+
+        # /DP — did print.
+        def did_print(document = nil)
+          resolve_action(:DP, 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/alternate_image.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # AlternateImage (ISO 32000-2 §8.9.5, PDF 1.3+). An alternate
+      # image representation used when the primary image's color
+      # space isn't available (e.g. a DeviceGray fallback for a
+      # DeviceCMYK image on a monochrome printer).
+      class AlternateImage < Pdfrb::Model::Cos::Dictionary
+        arlington_object "AlternateImage"
+
+        # /Image — required indirect reference to the alternate
+        # image XObject.
+        def image(document = nil)
+          ref = value[:Image]
+          return nil unless ref && document
+
+          ref.is_a?(Pdfrb::Model::Reference) ? document.object(ref) : ref
+        end
+
+        # /DefaultForPrinting — optional, default false. When true,
+        # the alternate image is used for printing.
+        def default_for_printing?
+          value[:DefaultForPrinting] == true
+        end
+
+        # /OC — optional optional-content group controlling the
+        # alternate's visibility (PDF 1.5+).
+        def optional_content(document = nil)
+          ref = value[:OC]
+          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/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,29 @@ 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"
+
+      # Additional actions on the Catalog (s12.6.3.17).
+      autoload :AddActionCatalog, "pdfrb/model/type/add_action_catalog"
+
+      # Alternate image (s8.9.5).
+      autoload :AlternateImage, "pdfrb/model/type/alternate_image"
+
+      # Sound action (s12.6.4.11, deprecated 2.0).
+      autoload :ActionSound, "pdfrb/model/type/action_sound"
     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.17"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.15
+  version: 0.7.17
 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
@@ -968,18 +968,22 @@ files:
 - lib/pdfrb/model/type/action_rich_media_execute.rb
 - lib/pdfrb/model/type/action_set_ocg_state.rb
 - lib/pdfrb/model/type/action_set_state.rb
+- lib/pdfrb/model/type/action_sound.rb
 - lib/pdfrb/model/type/action_sound_action.rb
 - lib/pdfrb/model/type/action_submit_form.rb
 - lib/pdfrb/model/type/action_thread.rb
 - 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/af_embedded_file.rb
 - lib/pdfrb/model/type/af_file_specification.rb
+- lib/pdfrb/model/type/alternate_image.rb
 - lib/pdfrb/model/type/annotation.rb
 - lib/pdfrb/model/type/appearance.rb
 - 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 +1137,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 +1159,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 +1170,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