pdfrb 0.8.2 → 0.8.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a185f53525e7405f735b08771fbbe14565735cdfa5b187a6469dddbf1033f3a
-  data.tar.gz: cb936214c2c504972a42006397564fbcc1d14a251860aeb39386b9e5c6ca6be2
+  metadata.gz: d6ed6487322f48831706d1efa10d78b12bbb0965d8c46232b8d333130fe63e91
+  data.tar.gz: f3da7f40c6b4f1e53b454d70eaac66a2fd42d3f73c03802dc01a9bdffbdd3915
 SHA512:
-  metadata.gz: 13d503de8af9f42f8ab7077033e23ecd276ada39989a1c1cdc4b8add5d24f029e7e8a576dd87db5315bedad62dc4a072d8681b2b8ccb078469fbbdcaeb7d2463
-  data.tar.gz: 2b6c53c9e94592ea2333974a9ad4201fc76a239ddd7cd7bdbac102a1f92cfbf6a740f79a1dae65514355fba7d5fa3ba4bf97b8f4eac7f2de0833408c825d1105
+  metadata.gz: 922050302dd2668bdf08e8fcfb612a02e99e0b8a90c0ce667f2910398a5cbece4fd656b1d2cf615c4e410d368534f31a0071afac6e80b5b81982f65c7b78b9a3
+  data.tar.gz: f80c263e29e5b17659e7e9eeef9dbedac5865ffbb38d9871e9687bbbe1cc8ad7a1743c0c9dd9dbb18eb9fcb072c0c9032391983df129b04eb9b15f0d148a1abd

data/docs/USAGE.md

@@ -110,6 +110,20 @@ puts "Fonts added: #{report.font_diff[:added]}"
 puts "Equivalent: #{report.equivalent?}"
 ```
 
+## PDF/A Generation
+
+```ruby
+doc = Pdfrb::Document.new
+doc.enable_pdf_a!(part: 2, conformance: "B") # sRGB OutputIntent + pdfaid XMP
+font = doc.fonts.add("/path/to/font.ttf")    # PDF/A requires embedded fonts
+doc.pages.add.canvas.text("Archived", at: [72, 720], font: font, size: 24)
+doc.write("archival.pdf")
+
+# Validate with veraPDF (brew install verapdf):
+result = Pdfrb::Task::VeraPdfCrossCheck.call("archival.pdf", flavour: :a2b)
+puts result.compliant? ? "PASS" : result.failures.map(&:message)
+```
+
 ## Conformance Validation
 
 ```ruby

data/lib/pdfrb/document.rb

@@ -329,7 +329,7 @@ module Pdfrb
 
       max_oid = @xref.entries.keys.max || 0
       size = @trailer_dict && @trailer_dict[:Size]
-      size = size.to_i if size.respond_to?(:to_i)
+      size = size.to_i if size.is_a?(Numeric)
       @next_oid = [max_oid + 1, size.to_i, @next_oid].max
     end
 

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

@@ -168,49 +168,23 @@ module Pdfrb
       # defaults /DefaultGray, /DefaultRGB, /DefaultCMYK.
       class ColorSpaceMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "ColorSpaceMap"
-
-        def [](name)
-          value[name.to_sym] || value[name.to_s]
-        end
-
-        def add(name, color_space)
-          value[name.to_sym] = color_space
-          name.to_sym
-        end
+        include NameMap
 
         def default_gray; self[:DefaultGray]; end
         def default_rgb; self[:DefaultRGB]; end
         def default_cmyk; self[:DefaultCMYK]; end
 
-        def each_color_space(&)
-          return enum_for(:each_color_space) unless block_given?
-
-          value.each(&)
-        end
-
-        def names
-          value.keys
-        end
+        alias each_color_space each_entry
       end
 
       # Colorants dictionary (s8.6.6.5, DeviceN /Colorants). Maps
       # individual colorant names to Separation spaces.
       class ColorantsDict < Pdfrb::Model::Cos::Dictionary
         arlington_object "ColorantsDict"
+        include NameMap
 
-        def [](name)
-          value[name.to_sym] || value[name.to_s]
-        end
-
-        def each_colorant(&)
-          return enum_for(:each_colorant) unless block_given?
-
-          value.each(&)
-        end
-
-        def colorant_names
-          value.keys
-        end
+        alias each_colorant each_entry
+        alias colorant_names names
       end
 
       # Box style dictionary (s7.11.4, BoxColorInfo entries). Guides

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

@@ -29,9 +29,9 @@ module Pdfrb
       # 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
+        include NameMap
+
+        alias filter_for []
 
         def each_filter(&)
           return enum_for(:each_filter) unless block_given?
@@ -53,9 +53,9 @@ module Pdfrb
       # 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
+        include NameMap
+
+        alias filter_for []
       end
     end
   end

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

@@ -111,25 +111,9 @@ module Pdfrb
       # map living on the (page or) catalog.
       class DestsMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "DestsMap"
+        include NameMap
 
-        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
+        alias each_destination each_entry
       end
     end
   end

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

@@ -39,19 +39,10 @@ module Pdfrb
       # Tiling pattern's Resources.
       class CharProcMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "CharProcMap"
-        def entries
-          value.each
-        end
-
-        def each_procedure(&block)
-          return enum_for(:each_procedure) unless block
+        include NameMap
 
-          value.each(&block)
-        end
-
-        def procedure_for(char_name)
-          value[char_name.to_sym] || value[char_name.to_s]
-        end
+        alias each_procedure each_entry
+        alias procedure_for []
 
         def has_glyph?(char_name)
           !!procedure_for(char_name)

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

@@ -208,14 +208,9 @@ module Pdfrb
       # colorant name -> ink solidity percentage.
       class Solidities < Pdfrb::Model::Cos::Dictionary
         arlington_object "Solidities"
+        include NameMap
 
-        def [](colorant)
-          value[colorant.to_sym] || value[colorant.to_s]
-        end
-
-        def colorant_names
-          value.keys
-        end
+        alias colorant_names names
       end
 
       # Source information (s14.10.2, /SourceInfo): provenance for

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Pdfrb
+  module Model
+    module Type
+      # Shared behaviour for name-keyed maps (Resources
+      # sub-dictionaries, role/class maps, VRI entries): lookup
+      # accepts Symbol or String, +add+ normalises the key to a
+      # Symbol, +names+ lists the keys.
+      module NameMap
+        def [](name)
+          key = name.to_sym
+          value.key?(key) ? value[key] : value[name.to_s]
+        end
+
+        def add(name, entry)
+          value[name.to_sym] = entry
+          name.to_sym
+        end
+
+        def names
+          value.keys
+        end
+
+        def each_entry(&)
+          return enum_for(:each_entry) unless block_given?
+
+          value.each(&)
+        end
+      end
+    end
+  end
+end

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

@@ -16,25 +16,9 @@ module Pdfrb
       # to patterns.
       class PatternMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "PatternMap"
+        include NameMap
 
-        def [](name)
-          value[name.to_sym] || value[name.to_s]
-        end
-
-        def add(name, pattern)
-          value[name.to_sym] = pattern
-          name.to_sym
-        end
-
-        def each_pattern(&)
-          return enum_for(:each_pattern) unless block_given?
-
-          value.each(&)
-        end
-
-        def names
-          value.keys
-        end
+        alias each_pattern each_entry
       end
     end
   end

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

@@ -116,25 +116,9 @@ module Pdfrb
       # to shadings.
       class ShadingMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "ShadingMap"
+        include NameMap
 
-        def [](name)
-          value[name.to_sym] || value[name.to_s]
-        end
-
-        def add(name, shading)
-          value[name.to_sym] = shading
-          name.to_sym
-        end
-
-        def each_shading(&)
-          return enum_for(:each_shading) unless block_given?
-
-          value.each(&)
-        end
-
-        def names
-          value.keys
-        end
+        alias each_shading each_entry
       end
     end
   end

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

@@ -24,14 +24,9 @@ module Pdfrb
       # keyed by DN component (CN, O, C, ...).
       class SubjectDN < Pdfrb::Model::Cos::Dictionary
         arlington_object "SubjectDN"
+        include NameMap
 
-        def [](component)
-          value[component.to_sym] || value[component.to_s]
-        end
-
-        def components
-          value.keys
-        end
+        alias components names
       end
 
       # Document timestamp signature (s12.8.1, /DocTimeStamp): an
@@ -88,14 +83,9 @@ module Pdfrb
       # validation data for one signature.
       class VRIMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "VRIMap"
+        include NameMap
 
-        def [](signature_hash)
-          value[signature_hash.to_sym] || value[signature_hash.to_s]
-        end
-
-        def signature_hashes
-          value.keys
-        end
+        alias signature_hashes names
       end
 
       # Associated-file embedded-file parameters (PDF 2.0 App Note
@@ -165,14 +155,9 @@ module Pdfrb
       # developer names to their DevExtensions entries.
       class Extensions < Pdfrb::Model::Cos::Dictionary
         arlington_object "Extensions"
+        include NameMap
 
-        def [](developer)
-          value[developer.to_sym] || value[developer.to_s]
-        end
-
-        def developers
-          value.keys
-        end
+        alias developers names
       end
 
       # GTS Procedural Steps group (prepress): identifies a

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

@@ -38,19 +38,7 @@ module Pdfrb
       # ExtGState dictionaries.
       class GraphicsStateParameterMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "GraphicsStateParameterMap"
-
-        def [](name)
-          value[name.to_sym] || value[name.to_s]
-        end
-
-        def add(name, parameters)
-          value[name.to_sym] = parameters
-          name.to_sym
-        end
-
-        def names
-          value.keys
-        end
+        include NameMap
       end
 
       # Transparency group /Group dictionary (s11.2.4.5): isolation

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

@@ -45,24 +45,16 @@ module Pdfrb
       # names mapped to standard structure types.
       class RoleMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "RoleMap"
+        include NameMap
 
-        def [](custom_name)
-          value[custom_name.to_sym] || value[custom_name.to_s]
-        end
-
-        def custom_names
-          value.keys
-        end
+        alias custom_names names
       end
 
       # Namespaced role map (s14.7.3, /RoleMapNS): per-namespace role
       # maps keyed by namespace URI.
       class RoleMapNS < Pdfrb::Model::Cos::Dictionary
         arlington_object "RoleMapNS"
-
-        def [](namespace)
-          value[namespace.to_sym] || value[namespace.to_s]
-        end
+        include NameMap
       end
 
       # Style dictionary (s14.9.2, /Styles entries): number-of-style
@@ -77,14 +69,9 @@ module Pdfrb
       # attribute-owner dictionaries shared by structure elements.
       class ClassMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "ClassMap"
+        include NameMap
 
-        def [](class_name)
-          value[class_name.to_sym] || value[class_name.to_s]
-        end
-
-        def class_names
-          value.keys
-        end
+        alias class_names names
       end
 
       # Reference structure element kid (s14.8.2.4, /Reference):

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

@@ -89,19 +89,7 @@ module Pdfrb
       # Resources /XObject dictionary (s7.8.3): name -> XObject.
       class XObjectMap < Pdfrb::Model::Cos::Dictionary
         arlington_object "XObjectMap"
-
-        def [](name)
-          value[name.to_sym] || value[name.to_s]
-        end
-
-        def add(name, xobject)
-          value[name.to_sym] = xobject
-          name.to_sym
-        end
-
-        def names
-          value.keys
-        end
+        include NameMap
       end
     end
   end

data/lib/pdfrb/model/type.rb

@@ -40,6 +40,8 @@ module Pdfrb
         end
       end
 
+      autoload :NameMap, "pdfrb/model/type/name_map"
+
       # Base semantic types.
       autoload :FileTrailer, "pdfrb/model/type/file_trailer"
       autoload :Catalog, "pdfrb/model/type/catalog"

data/lib/pdfrb/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.8.2
+  version: 0.8.4
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-28 00:00:00.000000000 Z
+date: 2026-08-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: benchmark
@@ -1143,6 +1143,7 @@ files:
 - lib/pdfrb/model/type/misc_helpers.rb
 - lib/pdfrb/model/type/movie.rb
 - lib/pdfrb/model/type/movie_annotation.rb
+- lib/pdfrb/model/type/name_map.rb
 - lib/pdfrb/model/type/names.rb
 - lib/pdfrb/model/type/namespace.rb
 - lib/pdfrb/model/type/object_reference.rb