pdfrb 0.7.17 → 0.7.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67218c766df1cff2565d5020ad8089414e7892102117fc76a9413f0972c93648
-  data.tar.gz: 8be6840a038f7c132e10b549c3ed3f33180ea5b5b14bcc6804c01f322dac82cf
+  metadata.gz: 4ceb6a2eec5eb948c98085aaca1c41b6101dd5970201fd9fd93af5d4a749dfe6
+  data.tar.gz: 15b493786db9a355ee20c35a4975ceb81a36118c294a90fc429398f5029086da
 SHA512:
-  metadata.gz: a87239ec989b28f76e4c2f2a31e0efdc0b67a0dfb39030f51cc52b79343c2d5de42d40b7d4f816ef72ff930964b89c53f1aa4757f481eb6337f9283a4e6f5003
-  data.tar.gz: f4748a5236be87af4360070f8ae90f7a34a93ba1f782a347d772573118b6a63e7bb24c167220d4df8d69477c4014bfb90a32b39756dcd383cb90058a6cbb398a
+  metadata.gz: a2c9c5c3253f4b0b9546ad908af4dfc5439c57de7d4fc669059144f4f1410255a6aaa9fffa68ee77233796a192e574398c02994f7fa558a760e16d7c79a44869
+  data.tar.gz: b9aa959023df3ec4ed99d65c05b26b4717cf5260a00a0781daa20fda52cb88b7d4e700ca6f94f0987d35f58bdd534a41b3e5a0649a0d7f6d3f0f9a2a7e2d20d5

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

@@ -95,8 +95,8 @@ module Pdfrb
           end
           private :own_fields
 
-          def arlington_loaded_for?(_name)
-            @arlington_loaded_name == name
+          def arlington_loaded_for?(arlington_name)
+            @arlington_loaded_name == arlington_name
           end
           private :arlington_loaded_for?
 
@@ -113,11 +113,23 @@ module Pdfrb
           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),
+          # we rebuild the Field preserving the hand-coded
+          # type/default/required and only attach the Arlington def
+          # for reference.
           def define_field_from_arlington(field_def)
             types = arlington_types_to_ruby(field_def)
             return if types.empty?
 
             key = arlington_key_to_symbol(field_def.key)
+            existing = own_fields[key]
+            if existing
+              own_fields[key] = merged_field(existing, field_def)
+              return
+            end
+
             define_field(
               key,
               type: types.length == 1 ? types.first : types,
@@ -129,6 +141,20 @@ module Pdfrb
           end
           private :define_field_from_arlington
 
+          def merged_field(existing, field_def)
+            Fields::Field.new(
+              existing.pdf_name,
+              type: existing.type,
+              required: existing.required,
+              default: existing.default,
+              indirect: existing.indirect,
+              allowed_values: existing.allowed_values,
+              version: arlington_version(field_def),
+              arlington: field_def
+            )
+          end
+          private :merged_field
+
           def arlington_types_to_ruby(field_def)
             field_def.types.map { |t| arlington_one_type_to_ruby(t) }.flatten.compact.uniq
           end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # GoTo3DView action (s12.6.4.12, PDF 1.6+). Navigate within a 3D stream.
       class ActionGoTo3DView < Action
+        arlington_object "ActionGoTo3DView"
         register_subtype :GoTo3DView
 
         def target_view; self[:TA]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # GoToDp action (s12.6.4.2, PDF 2.0). Destination pointer variant
       # of GoTo that supports /DP (destination page) over a /D array.
       class ActionGoToDp < Action
+        arlington_object "ActionGoToDp"
         register_subtype :GoToDp
 
         def destination_page; self[:DP]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Remote GoTo action (s12.6.4.3). Navigate to a destination in
       # another PDF file.
       class ActionGoToR < Action
+        arlington_object "ActionGoToR"
         register_subtype :GoToR
 
         def file_spec; self[:F]; end

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

@@ -5,12 +5,14 @@ module Pdfrb
     module Type
       # GoTo action (s12.6.4.2). Navigate to a destination.
       class ActionGoTo < Action
+        arlington_object "ActionGoTo"
         register_subtype :GoTo
 
         def destination; self[:D]; end
 
         def page_index_destination?
-          destination.is_a?(Array) && destination.first.is_a?(Integer)
+          d = destination_array
+          !d.nil? && d.first.is_a?(Integer)
         end
 
         def named_destination?
@@ -20,13 +22,23 @@ module Pdfrb
         def target_page_number
           return nil unless page_index_destination?
 
-          destination.first
+          destination_array.first
         end
 
         def display_option
           return nil unless page_index_destination?
 
-          destination[1..]
+          destination_array[1..]
+        end
+
+        private
+
+        def destination_array
+          d = destination
+          return d.to_a if d.is_a?(Pdfrb::Model::PdfArray)
+          return d if d.is_a?(::Array)
+
+          nil
         end
       end
     end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Hide action (s12.6.4.10). Show/hide annotations.
       class ActionHide < Action
+        arlington_object "ActionHide"
         register_subtype :Hide
 
         def targets; self[:T]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Import-data action (s12.7.6.4). Imports form data from an FDF/XFDF file.
       class ActionImportData < Action
+        arlington_object "ActionImportData"
         register_subtype :ImportData
 
         def file_spec; self[:F]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # JavaScript action (s12.6.4.16). Execute JavaScript code.
       class ActionJavaScript < Action
+        arlington_object "ActionECMAScript"
         register_subtype :JavaScript
 
         def script; self[:JS]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Launch action (s12.6.4.5). Launch an external application.
       class ActionLaunch < Action
+        arlington_object "ActionLaunch"
         register_subtype :Launch
 
         def file_spec; self[:F]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Movie action (s12.6.4.8). Deprecated in PDF 2.0 but still
       # appears in legacy PDFs. Plays/stops a Movie annotation.
       class ActionMovie < Action
+        arlington_object "ActionMovie"
         register_subtype :Movie
 
         def annotation; self[:Annotation]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Named action (s12.6.4.19). Pre-defined action by name (NextPage,
       # PrevPage, FirstPage, LastPage, Print, etc.).
       class ActionNamed < Action
+        arlington_object "ActionNamed"
         register_subtype :Named
 
         def action_name; self[:N]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # NOP action (PDF 1.2 deprecated). No-op placeholder.
       class ActionNOP < Action
+        arlington_object "ActionNOP"
         register_subtype :NOP
       end
     end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Rendition action (s12.6.4.12). Controls multimedia rendition
       # on screen annotations.
       class ActionRendition < Action
+        arlington_object "ActionRendition"
         register_subtype :Rendition
 
         def rendition; self[:R]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Reset-form action (s12.7.6.3). Resets form fields to defaults.
       class ActionResetForm < Action
+        arlington_object "ActionResetForm"
         register_subtype :ResetForm
 
         def fields; self[:Fields]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Set OCG State action (s12.6.4.13). Toggle visibility of
       # optional-content groups.
       class ActionSetOCGState < Action
+        arlington_object "ActionSetOCGState"
         register_subtype :SetOCGState
 
         def state; self[:State]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Set-state action (deprecated in PDF 1.2, replaced by SetOCGState).
       class ActionSetState < Action
+        arlington_object "ActionSetState"
         register_subtype :SetState
 
         def state; self[:State]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Submit-form action (s12.7.6.2). Submits form values to a URL.
       class ActionSubmitForm < Action
+        arlington_object "ActionSubmitForm"
         register_subtype :SubmitForm
 
         def url; self[:F]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Transition action (s12.4.3). Specifies page transition for slide-show.
       class ActionTrans < Action
+        arlington_object "ActionTransition"
         register_subtype :Trans
 
         def transition; self[:Trans]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # URI action (s12.6.4.7). Opens a URL in the browser.
       class ActionURI < Action
+        arlington_object "ActionURI"
         register_subtype :URI
 
         def uri; self[:URI]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Caret annotation (s12.5.6.11). Text-insertion indicator.
       class CaretAnnotation < MarkupAnnotation
+        arlington_object "AnnotCaret"
         def rd; self[:RD]; end
         def sy; self[:Sy]; end
 

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Circle / ellipse annotation (s12.5.6.8).
       class CircleAnnotation < MarkupAnnotation
+        arlington_object "AnnotCircle"
         def border_effect; self[:BE]; end
         def interior_color; self[:IC]; end
         def border_style; self[:BS]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # File-attachment annotation (s12.5.6.15). Embedded file displayed
       # as a paper-clip icon.
       class FileAttachmentAnnotation < MarkupAnnotation
+        arlington_object "AnnotFileAttachment"
         def embedded_file; self[:FS]; end
         def name; self[:Name]; end
 

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Free-text annotation (s12.5.6.6). Text shown directly on the page.
       class FreeTextAnnotation < MarkupAnnotation
+        arlington_object "AnnotFreeText"
         def default_appearance; self[:DA]; end
         def q; self[:Q]; end
         def rc; self[:RC]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Highlight annotation. /Subtype /Highlight.
       class HighlightAnnotation < TextMarkupAnnotation
+        arlington_object "AnnotHighlight"
       end
     end
   end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Ink annotation (s12.5.6.13). Freehand scribble path(s).
       class InkAnnotation < MarkupAnnotation
+        arlington_object "AnnotInk"
         def ink_list; self[:InkList]; end
         def interior_color; self[:IC]; end
         def border_style; self[:BS]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Line annotation (s12.5.6.7). Line between two coordinate pairs.
       class LineAnnotation < MarkupAnnotation
+        arlington_object "AnnotLine"
         def line; self[:L]; end
         def le; self[:LE]; end
         def line_endings; le; end
@@ -20,15 +21,17 @@ module Pdfrb
         def it; self[:IT]; end
 
         def start_point
-          return nil unless line.is_a?(Array) && line.size >= 2
+          l = line_array
+          return nil unless l && l.size >= 2
 
-          line[0..1]
+          l[0..1]
         end
 
         def end_point
-          return nil unless line.is_a?(Array) && line.size >= 4
+          l = line_array
+          return nil unless l && l.size >= 4
 
-          line[2..3]
+          l[2..3]
         end
 
         def has_caption?
@@ -38,6 +41,16 @@ module Pdfrb
         def has_measure?
           !!measure
         end
+
+        private
+
+        def line_array
+          l = line
+          return l.to_a if l.is_a?(Pdfrb::Model::PdfArray)
+          return l if l.is_a?(::Array)
+
+          nil
+        end
       end
     end
   end

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

@@ -4,6 +4,7 @@ module Pdfrb
   module Model
     module Type
       class LinkAnnotation < Annotation
+        arlington_object "AnnotLink"
         def action; self[:A]; end
         def destination; self[:Dest]; end
         def highlight_mode; self[:H]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Polygon annotation (s12.5.6.9). Closed polygon shape.
       class PolygonAnnotation < MarkupAnnotation
+        arlington_object "AnnotPolygon"
         def vertices; self[:Vertices]; end
         def line_endings; self[:LE]; end
         def interior_color; self[:IC]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Polyline annotation (s12.5.6.9). Open polyline (not closed).
       class PolylineAnnotation < MarkupAnnotation
+        arlington_object "AnnotPolyLine"
         def vertices; self[:Vertices]; end
         def line_endings; self[:LE]; end
         def interior_color; self[:IC]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Popup annotation (s12.5.6.14). Displays text/markup in a pop-up window.
       class PopupAnnotation < Annotation
+        arlington_object "AnnotPopup"
         def parent; self[:Parent]; end
         def open?; !!value[:Open]; end
 

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Printer-mark annotation (s12.5.6.17). Marks page for trimming,
       # registration, etc.
       class PrinterMarkAnnotation < Annotation
+        arlington_object "AnnotPrinterMark"
         def mark_subtype; self[:MN]; end
       end
     end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Redaction annotation (s12.5.6.16). Marks content for removal.
       class RedactAnnotation < MarkupAnnotation
+        arlington_object "AnnotRedact"
         def overlay_text; self[:OverlayText]; end
         def repeat_overlay?; truthy?(self[:Repeat]); end
         def quadding; self[:Q]; end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Rich Media annotation (s12.5.6.20, PDF 1.7 ExtensionLevel 3 +
       # PDF 2.0). Hosts interactive rich media content (Flash, video).
       class RichMediaAnnotation < Annotation
+        arlington_object "AnnotRichMedia"
         def rich_media_settings; self[:RichMediaSettings]; end
         def rich_media_content; self[:RichMediaContent]; end
 

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Screen annotation (s12.5.6.18). Holds media played via Action
       # triggers. /Subtype /Screen.
       class ScreenAnnotation < Annotation
+        arlington_object "AnnotScreen"
         def attachment_point; self[:AP]; end
         def media_type; self[:T]; end
         def actions; self[:AA]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Sound annotation (s12.5.6.18). Sound clip embedded in the page.
       class SoundAnnotation < MarkupAnnotation
+        arlington_object "AnnotSound"
         def sound; self[:Sound]; end
         def name; self[:Name]; end
 

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Square / rectangle annotation (s12.5.6.8).
       class SquareAnnotation < MarkupAnnotation
+        arlington_object "AnnotSquare"
         def border_effect; self[:BE]; end
         def interior_color; self[:IC]; end
         def border_style; self[:BS]; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Squiggly annotation. /Subtype /Squiggly.
       class SquigglyAnnotation < TextMarkupAnnotation
+        arlington_object "AnnotSquiggly"
       end
     end
   end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Rubber-stamp annotation (s12.5.6.14).
       class StampAnnotation < MarkupAnnotation
+        arlington_object "AnnotStamp"
         def name; self[:Name]; end
         def interior_color; self[:IC]; end
         def rotation; self[:Rotate] || 0; end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # StrikeOut annotation. /Subtype /StrikeOut.
       class StrikeOutAnnotation < TextMarkupAnnotation
+        arlington_object "AnnotStrikeOut"
       end
     end
   end

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Sticky note annotation (s12.5.6.10).
       class TextAnnotation < MarkupAnnotation
+        arlington_object "AnnotText"
         def state; self[:State]; end
         def state_model; self[:StateModel]; end
 

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

@@ -5,6 +5,7 @@ module Pdfrb
     module Type
       # Underline annotation. /Subtype /Underline.
       class UnderlineAnnotation < TextMarkupAnnotation
+        arlington_object "AnnotUnderline"
       end
     end
   end

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

@@ -6,6 +6,7 @@ module Pdfrb
       # Watermark annotation (s12.5.6.23). PDF 2.0. Non-printing,
       # non-interactive visual watermark behind/over page content.
       class WatermarkAnnotation < Annotation
+        arlington_object "AnnotWatermark"
         def fixed_print?; !!value[:FixedPrint]; end
       end
     end

data/lib/pdfrb/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.7.17
+  version: 0.7.19
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-16 00:00:00.000000000 Z
+date: 2026-08-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor