pdfrb 0.3.0 → 0.6.0

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

@@ -7,6 +7,62 @@ module Pdfrb
       # /Width, /Height, /ColorSpace, /BitsPerComponent, etc.
       class XObjectImage < Pdfrb::Model::Cos::Stream
         arlington_object "XObjectImage"
+
+        def subtype; self[:Subtype]; end
+        def width; self[:Width]; end
+        def height; self[:Height]; end
+        def color_space; self[:ColorSpace]; end
+        def bits_per_component; self[:BitsPerComponent]; end
+        def filter; self[:Filter]; end
+        def decode; self[:Decode]; end
+        def intent; self[:Intent]; end
+        def image_mask?; truthy?(self[:ImageMask]); end
+        def mask; self[:Mask]; end
+        def smask; self[:SMask]; end
+        def smask_in_data; self[:SMaskInData]; end
+        def decode_parms; self[:DecodeParms]; end
+        def interpolate?; truthy?(self[:Interpolate]); end
+        def alternates; self[:Alternates]; end
+        def oc; self[:OC]; end
+        def name; self[:Name]; end
+        def struct_parent; self[:StructParent]; end
+        def associated_files; self[:AF]; end
+
+        def components
+          cs = color_space
+          return 0 unless cs
+
+          case cs.to_sym
+          when :DeviceGray, :CalGray, :Indexed then 1
+          when :DeviceRGB, :CalRGB, :Lab then 3
+          when :DeviceCMYK then 4
+          end
+        rescue StandardError
+          nil
+        end
+
+        def masked?
+          image_mask? || !!mask
+        end
+
+        def has_soft_mask?
+          !!smask || smask_in_data.to_i.positive?
+        end
+
+        def inline_soft_mask?
+          smask_in_data.to_i == 2
+        end
+
+        def indexed?
+          color_space.is_a?(Array) &&
+            color_space.to_ary.first&.to_sym == :Indexed
+        end
+
+        def bytes_per_row
+          return nil unless width && bits_per_component && components
+
+          ((width * components * bits_per_component) + 7) / 8
+        end
       end
     end
   end

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

@@ -8,6 +8,43 @@ module Pdfrb
       class XRefStream < Pdfrb::Model::Cos::Stream
         arlington_object "XRefStream"
         register_type :XRef
+
+        def type; self[:Type]; end
+        def size; self[:Size]; end
+        def prev; self[:Prev]; end
+        def root; self[:Root]; end
+        def encrypt; self[:Encrypt]; end
+        def info; self[:Info]; end
+        def id; self[:ID]; end
+        def w; self[:W]; end
+        def index; self[:Index]; end
+        def filter; self[:Filter]; end
+
+        def encrypted?
+          !!encrypt
+        end
+
+        def incremental?
+          !!prev
+        end
+
+        def field_widths
+          return [0, 0, 0] unless w
+
+          arr = w.is_a?(Pdfrb::Model::PdfArray) ? w.to_a : w
+          return [0, 0, 0] unless arr.is_a?(Array) && arr.size == 3
+
+          arr
+        end
+
+        def subsection_index
+          return [[0, size || 0]] unless index
+
+          arr = index.is_a?(Pdfrb::Model::PdfArray) ? index.to_a : index
+          return [[0, size || 0]] unless arr.is_a?(Array)
+
+          arr.each_slice(2).to_a
+        end
       end
     end
   end

data/lib/pdfrb/model/type.rb

@@ -17,23 +17,35 @@ module Pdfrb
       class << self
         attr_reader :arlington_registry
 
-        # Register a Type subclass under its Arlington TSV name.
         def register_arlington(name, klass)
           @arlington_registry[name] = klass
         end
 
-        # Look up a Type subclass by Arlington TSV name.
         def lookup(name)
           @arlington_registry[name]
         end
+
+        # Force-load all autoloaded type classes so register_type and
+        # register_subtype calls fire. Call this before parsing or
+        # when iterating type_map. Idempotent.
+        def eager_load!
+          return if @eager_loaded
+
+          constants.each do |c|
+            const_get(c)
+          rescue NameError
+            # Skip autoload targets that don't define a class yet.
+          end
+          @eager_loaded = true
+        end
       end
 
-      # Base semantic types (one file per TSV cluster).
+      # Base semantic types.
       autoload :FileTrailer, "pdfrb/model/type/file_trailer"
       autoload :Catalog, "pdfrb/model/type/catalog"
       autoload :Info, "pdfrb/model/type/info"
       autoload :PageTreeNode, "pdfrb/model/type/page_tree_node"
-      autoload :PageTreeNodeRoot, "pdfrb/model/type/page_tree_node"
+      autoload :PageTreeNodeRoot, "pdfrb/model/type/page_tree_node_root"
       autoload :Page, "pdfrb/model/type/page"
       autoload :Resources, "pdfrb/model/type/resources"
       autoload :Metadata, "pdfrb/model/type/metadata"
@@ -50,17 +62,95 @@ module Pdfrb
       autoload :OptionalContentGroup, "pdfrb/model/type/optional_content_group"
       autoload :OptionalContentMembership, "pdfrb/model/type/optional_content_membership"
       autoload :OptionalContentProperties, "pdfrb/model/type/optional_content_properties"
+
+      # Additional OCG / opt-content subclass dicts (one per file).
+      autoload :OptContentCreatorInfo, "pdfrb/model/type/opt_content_ext"
+      autoload :OptContentExport, "pdfrb/model/type/opt_content_ext"
+      autoload :OptContentPrint, "pdfrb/model/type/opt_content_ext"
+      autoload :OptContentView, "pdfrb/model/type/opt_content_ext"
+      autoload :OptContentLanguage, "pdfrb/model/type/opt_content_ext"
+      autoload :OptContentUsageApplication, "pdfrb/model/type/opt_content_ext"
+      autoload :OptContentPageElement, "pdfrb/model/type/opt_content_page_element"
+
       autoload :FileSpecification, "pdfrb/model/type/file_specification"
+      autoload :FileSpecEF, "pdfrb/model/type/file_spec_ef"
+      autoload :FileSpecRF, "pdfrb/model/type/file_spec_rf"
       autoload :EmbeddedFile, "pdfrb/model/type/embedded_file"
       autoload :AFFileSpecification, "pdfrb/model/type/af_file_specification"
       autoload :AFEmbeddedFile, "pdfrb/model/type/af_embedded_file"
       autoload :StructTreeRoot, "pdfrb/model/type/struct_tree_root"
       autoload :StructElem, "pdfrb/model/type/struct_elem"
 
-      # XObject family.
+      # Additional base types (previously loaded via require in pdfrb.rb;
+      # now autoloaded per project rule).
+      autoload :MarkInformation, "pdfrb/model/type/mark_information"
+      autoload :IconFit, "pdfrb/model/type/icon_fit"
+      autoload :PageLabel, "pdfrb/model/type/page_label"
+      autoload :BorderStyling, "pdfrb/model/type/border_styling"
+      autoload :BorderEffect, "pdfrb/model/type/border_effect"
+      autoload :LineEndingStyling, "pdfrb/model/type/line_ending_styling"
+      autoload :InteriorColor, "pdfrb/model/type/interior_color"
+      autoload :ObjectReference, "pdfrb/model/type/object_reference"
+      autoload :SquareCircle, "pdfrb/model/type/square_circle"
+      autoload :VariableTextField, "pdfrb/model/type/variable_text_field"
+      autoload :DocumentSecurityStore, "pdfrb/model/type/document_security_store"
+      autoload :Measure, "pdfrb/model/type/measure"
+      autoload :OptionalContentConfiguration, "pdfrb/model/type/optional_content_config"
+      autoload :MarkedContentReference, "pdfrb/model/type/marked_content_reference"
+      autoload :AppearanceGenerator, "pdfrb/model/type/appearance_generator"
+      autoload :Field, "pdfrb/model/type/form_field"
+      autoload :TextField, "pdfrb/model/type/text_field"
+      autoload :Button, "pdfrb/model/type/button"
+      autoload :Choice, "pdfrb/model/type/choice"
+      autoload :SignatureField, "pdfrb/model/type/signature_field"
+      autoload :ViewerPreferences, "pdfrb/model/type/viewer_preferences"
+      autoload :FontMultipleMaster, "pdfrb/model/type/font_multiple_master"
+      autoload :CharProcMap, "pdfrb/model/type/font_multiple_master"
+      autoload :FontEncoding, "pdfrb/model/type/font_encoding"
+      autoload :CIDFontDescriptorMetrics, "pdfrb/model/type/cid_font_descriptor_metrics"
+      autoload :FontCIDType0, "pdfrb/model/type/font_cid_type0"
+      autoload :FontCIDType2, "pdfrb/model/type/font_cid_type2"
+      autoload :FontDescriptorCIDType0, "pdfrb/model/type/font_descriptor_cid_type0"
+      autoload :FontDescriptorCIDType2, "pdfrb/model/type/font_descriptor_cid_type2"
+      autoload :ToUnicodeCMapStream, "pdfrb/model/type/to_unicode_cmap_stream"
       autoload :XObjectForm, "pdfrb/model/type/xobject_form"
       autoload :XObjectImage, "pdfrb/model/type/xobject_image"
 
+      # Function family (s8.9).
+      autoload :Function, "pdfrb/model/type/function"
+      autoload :FunctionExponential, "pdfrb/model/type/function_exponential"
+      autoload :FunctionStitching, "pdfrb/model/type/function_stitching"
+      autoload :FunctionSampled, "pdfrb/model/type/function_sampled"
+      autoload :FunctionPostScript, "pdfrb/model/type/function_postscript"
+
+      # Halftone family (s8.7.4).
+      autoload :Halftone, "pdfrb/model/type/halftone"
+      autoload :HalftoneType1, "pdfrb/model/type/halftone_type1"
+      autoload :HalftoneType5, "pdfrb/model/type/halftone_type5"
+      autoload :HalftoneType6, "pdfrb/model/type/halftone_type6"
+      autoload :HalftoneType10, "pdfrb/model/type/halftone_type10"
+      autoload :HalftoneType16, "pdfrb/model/type/halftone_type16"
+
+      # Media (s13.3-4). Legacy media types retained for round-trip.
+      autoload :Movie, "pdfrb/model/type/movie"
+      autoload :Sound, "pdfrb/model/type/sound"
+
+      # Color space dicts (s8.6).
+      autoload :CalGray, "pdfrb/model/type/cal_gray"
+      autoload :CalRGB, "pdfrb/model/type/cal_rgb"
+      autoload :Lab, "pdfrb/model/type/lab"
+      autoload :Indexed, "pdfrb/model/type/indexed"
+      autoload :Separation, "pdfrb/model/type/separation"
+      autoload :DeviceN, "pdfrb/model/type/device_n"
+      autoload :DeviceNMixingHints, "pdfrb/model/type/device_n_mixing_hints"
+      autoload :DeviceNProcess, "pdfrb/model/type/device_n_process"
+      autoload :ICCBasedColorSpace, "pdfrb/model/type/icc_based_color_space"
+
+      # Pattern family (s8.7).
+      autoload :Pattern, "pdfrb/model/type/pattern"
+      autoload :PatternTiling, "pdfrb/model/type/pattern_tiling"
+      autoload :PatternShading, "pdfrb/model/type/pattern_shading"
+
       # Font family.
       autoload :Font, "pdfrb/model/type/font"
       autoload :FontType1, "pdfrb/model/type/font_type1"
@@ -68,11 +158,201 @@ module Pdfrb
       autoload :FontType0, "pdfrb/model/type/font_type0"
       autoload :FontType3, "pdfrb/model/type/font_type3"
       autoload :CIDFont, "pdfrb/model/type/cid_font"
+      autoload :CIDSystemInfo, "pdfrb/model/type/cid_system_info"
+      autoload :CIDFontDescriptorMetrics, "pdfrb/model/type/cid_font_descriptor_metrics"
+      autoload :FontCIDType0, "pdfrb/model/type/font_cid_type0"
+      autoload :FontCIDType2, "pdfrb/model/type/font_cid_type2"
       autoload :FontDescriptor, "pdfrb/model/type/font_descriptor"
+      autoload :FontDescriptorCIDType0, "pdfrb/model/type/font_descriptor_cid_type0"
+      autoload :FontDescriptorCIDType2, "pdfrb/model/type/font_descriptor_cid_type2"
+      autoload :FontMultipleMaster, "pdfrb/model/type/font_multiple_master"
+      autoload :CharProcMap, "pdfrb/model/type/font_multiple_master"
+      autoload :FontEncoding, "pdfrb/model/type/font_encoding"
+      autoload :ToUnicodeCMapStream, "pdfrb/model/type/to_unicode_cmap_stream"
+      autoload :FontFile, "pdfrb/model/type/font_file"
+      autoload :FontFile2, "pdfrb/model/type/font_file2"
+      autoload :FontFile3, "pdfrb/model/type/font_file3"
 
-      # Annotation + Action families (with subtype dispatch).
+      # Annotation family.
       autoload :Annotation, "pdfrb/model/type/annotation"
+      autoload :MarkupAnnotation, "pdfrb/model/type/markup_annotation"
+      autoload :WidgetAnnotation, "pdfrb/model/type/widget_annotation"
+      autoload :LinkAnnotation, "pdfrb/model/type/link_annotation"
+      autoload :TextAnnotation, "pdfrb/model/type/text_annotation"
+      autoload :FreeTextAnnotation, "pdfrb/model/type/free_text_annotation"
+      autoload :StampAnnotation, "pdfrb/model/type/stamp_annotation"
+      autoload :SquareAnnotation, "pdfrb/model/type/square_annotation"
+      autoload :CircleAnnotation, "pdfrb/model/type/circle_annotation"
+      autoload :LineAnnotation, "pdfrb/model/type/line_annotation"
+      autoload :PolygonAnnotation, "pdfrb/model/type/polygon_annotation"
+      autoload :PolylineAnnotation, "pdfrb/model/type/polyline_annotation"
+      autoload :InkAnnotation, "pdfrb/model/type/ink_annotation"
+      autoload :TextMarkupAnnotation, "pdfrb/model/type/text_markup_annotation"
+      autoload :HighlightAnnotation, "pdfrb/model/type/highlight_annotation"
+      autoload :UnderlineAnnotation, "pdfrb/model/type/underline_annotation"
+      autoload :SquigglyAnnotation, "pdfrb/model/type/squiggly_annotation"
+      autoload :StrikeOutAnnotation, "pdfrb/model/type/strikeout_annotation"
+      autoload :PopupAnnotation, "pdfrb/model/type/popup_annotation"
+      autoload :FileAttachmentAnnotation, "pdfrb/model/type/file_attachment_annotation"
+      autoload :CaretAnnotation, "pdfrb/model/type/caret_annotation"
+      autoload :RedactAnnotation, "pdfrb/model/type/redact_annotation"
+      autoload :WatermarkAnnotation, "pdfrb/model/type/watermark_annotation"
+      autoload :PrinterMarkAnnotation, "pdfrb/model/type/printer_mark_annotation"
+      autoload :PrinterMarkSubDict, "pdfrb/model/type/transition"
+      autoload :ScreenAnnotation, "pdfrb/model/type/screen_annotation"
+      autoload :SoundAnnotation, "pdfrb/model/type/sound_annotation"
+
+      # Rich Media annotation family (s13.6).
+      autoload :RichMediaAnnotation, "pdfrb/model/type/rich_media_annotation"
+      autoload :RichMediaActivation, "pdfrb/model/type/rich_media_activation"
+      autoload :RichMediaDeactivation, "pdfrb/model/type/rich_media_deactivation"
+      autoload :RichMediaConfiguration, "pdfrb/model/type/rich_media_configuration"
+      autoload :RichMediaInstance, "pdfrb/model/type/rich_media_instance"
+      autoload :RichMediaCommand, "pdfrb/model/type/rich_media_command"
+      autoload :RichMediaContent, "pdfrb/model/type/rich_media_content"
+      autoload :RichMediaCuePoint, "pdfrb/model/type/rich_media_cue_point"
+      autoload :RichMediaAnimation, "pdfrb/model/type/rich_media_animation"
+      autoload :RichMediaWindow, "pdfrb/model/type/rich_media_window"
+      autoload :RichMediaSettings, "pdfrb/model/type/rich_media_settings"
+      autoload :RichMediaPresentation, "pdfrb/model/type/rich_media_presentation"
+
+      # 3D family (s13.6).
+      autoload :ThreeDStream, "pdfrb/model/type/three_d_stream"
+      autoload :ThreeDView, "pdfrb/model/type/three_d_view"
+      autoload :ThreeDAnimationStyle, "pdfrb/model/type/three_d_animation_style"
+      autoload :ThreeDBackground, "pdfrb/model/type/three_d_background"
+      autoload :ThreeDLightingScheme, "pdfrb/model/type/three_d_lighting_scheme"
+      autoload :ThreeDRenderMode, "pdfrb/model/type/three_d_render_mode"
+      autoload :ThreeDCrossSection, "pdfrb/model/type/three_d_cross_section"
+      autoload :ThreeDNode, "pdfrb/model/type/three_d_node"
+      autoload :ThreeDUnits, "pdfrb/model/type/three_d_units"
+      autoload :ThreeDReference, "pdfrb/model/type/three_d_reference"
+      autoload :ThreeDActivation, "pdfrb/model/type/three_d_activation"
+
+      # 3D Measure family (s13.6.4).
+      autoload :ThreeDMeasure, "pdfrb/model/type/three_d_measure"
+      autoload :ThreeDMeasure3DC, "pdfrb/model/type/three_d_measure_3dc"
+      autoload :ThreeDMeasurePD3, "pdfrb/model/type/three_d_measure_pd3"
+      autoload :ThreeDMeasureLD3, "pdfrb/model/type/three_d_measure_ld3"
+      autoload :ThreeDMeasureRD3, "pdfrb/model/type/three_d_measure_rd3"
+      autoload :ThreeDMeasureAD3, "pdfrb/model/type/three_d_measure_ad3"
+
+      # Transition + 3D markup + geolocation.
+      autoload :Transition, "pdfrb/model/type/transition"
+      autoload :ExData3DMarkup, "pdfrb/model/type/transition"
+      autoload :ExDataMarkupGeo, "pdfrb/model/type/transition"
+
+      # Appearance generators (one per file).
+      autoload :GenericAppearance, "pdfrb/model/type/generic_appearance"
+      autoload :WidgetAppearance, "pdfrb/model/type/widget_appearance"
+      autoload :TextAppearance, "pdfrb/model/type/text_appearance"
+      autoload :LinkAppearance, "pdfrb/model/type/link_appearance"
+
+      # Action family (s12.6.4).
       autoload :Action, "pdfrb/model/type/action"
+      autoload :ActionGoTo, "pdfrb/model/type/action_goto"
+      autoload :ActionGoToR, "pdfrb/model/type/action_go_to_r"
+      autoload :ActionURI, "pdfrb/model/type/action_uri"
+      autoload :ActionJavaScript, "pdfrb/model/type/action_java_script"
+      autoload :ActionLaunch, "pdfrb/model/type/action_launch"
+      autoload :ActionSetOCGState, "pdfrb/model/type/action_set_ocg_state"
+      autoload :ActionHide, "pdfrb/model/type/action_hide"
+      autoload :ActionSubmitForm, "pdfrb/model/type/action_submit_form"
+      autoload :ActionResetForm, "pdfrb/model/type/action_reset_form"
+      autoload :ActionImportData, "pdfrb/model/type/action_import_data"
+      autoload :ActionTrans, "pdfrb/model/type/action_trans"
+      autoload :ActionNamed, "pdfrb/model/type/action_named"
+      autoload :ActionRendition, "pdfrb/model/type/action_rendition"
+      autoload :ActionMovie, "pdfrb/model/type/action_movie"
+      autoload :ActionSoundAction, "pdfrb/model/type/action_sound_action"
+      autoload :ActionSetState, "pdfrb/model/type/action_set_state"
+      autoload :ActionThread, "pdfrb/model/type/action_thread"
+      autoload :ActionGoTo3DView, "pdfrb/model/type/action_go_to_3d_view"
+      autoload :ActionGoToDp, "pdfrb/model/type/action_go_to_dp"
+      autoload :ActionRichMediaExecute, "pdfrb/model/type/action_rich_media_execute"
+      autoload :ActionNOP, "pdfrb/model/type/action_nop"
+
+      # Signature family (s12.8).
+      autoload :Signature, "pdfrb/model/type/signature"
+      autoload :SigFieldLock, "pdfrb/model/type/sig_field_lock"
+      autoload :SigFieldSeedValue, "pdfrb/model/type/sig_field_seed_value"
+      autoload :DocMDPTransformParameters, "pdfrb/model/type/doc_mdp_transform_parameters"
+
+      # Appearance + Media (s12.5.5, s13.3).
+      autoload :Appearance, "pdfrb/model/type/appearance"
+      autoload :AppearanceCharacteristics, "pdfrb/model/type/appearance_characteristics"
+      autoload :AppearanceTrapNet, "pdfrb/model/type/appearance_trap_net"
+      autoload :AppearanceTrapNetSubDict, "pdfrb/model/type/appearance_trap_net"
+      autoload :AppearanceSubDict, "pdfrb/model/type/appearance_trap_net"
+      autoload :MediaClip, "pdfrb/model/type/media_clip"
+      autoload :Rendition, "pdfrb/model/type/rendition"
+      autoload :ExDataProjection, "pdfrb/model/type/appearance_trap_net"
+      autoload :AnnotationProjectionDict, "pdfrb/model/type/appearance_trap_net"
+
+      # Media offset / player / screen types.
+      autoload :MediaOffsetTime, "pdfrb/model/type/media_offset"
+      autoload :MediaOffsetFrame, "pdfrb/model/type/media_offset"
+      autoload :MediaOffsetMarker, "pdfrb/model/type/media_offset"
+      autoload :MediaPlayerInfo, "pdfrb/model/type/media_offset"
+      autoload :MediaPlayers, "pdfrb/model/type/media_offset"
+      autoload :MediaScreenParameters, "pdfrb/model/type/media_offset"
+      autoload :MediaCriteria, "pdfrb/model/type/media_offset"
+      autoload :SoftwareIdentifier, "pdfrb/model/type/software_identifier"
+
+      # Misc small helpers (one per file).
+      autoload :BorderArray, "pdfrb/model/type/misc_helpers"
+      autoload :LabRangeArray, "pdfrb/model/type/misc_helpers"
+      autoload :DestOutputProfileRef, "pdfrb/model/type/misc_helpers"
+      autoload :OutputIntentsContainer, "pdfrb/model/type/misc_helpers"
+      autoload :CMapStream, "pdfrb/model/type/misc_helpers"
+
+      # Crypt filter (s7.6.5).
+      autoload :CryptFilter, "pdfrb/model/type/crypt_filter"
+      autoload :CryptFilterMap, "pdfrb/model/type/crypt_filter"
+      autoload :CryptFilterPublicKey, "pdfrb/model/type/crypt_filter"
+      autoload :CryptFilterPublicKeyMap, "pdfrb/model/type/crypt_filter"
+
+      # Signature build data.
+      autoload :SignatureBuildPropDict, "pdfrb/model/type/appearance_trap_net"
+      autoload :SignatureBuildDataDict, "pdfrb/model/type/signature_build"
+      autoload :SignatureBuildDataAppDict, "pdfrb/model/type/signature_build"
+      autoload :SignatureBuildDataSigQDict, "pdfrb/model/type/signature_build"
+      autoload :SignatureReferenceDocMDP, "pdfrb/model/type/signature_build"
+      autoload :SignatureReferenceIdentity, "pdfrb/model/type/signature_build"
+      autoload :SignatureReferenceUR, "pdfrb/model/type/signature_build"
+      autoload :SignatureReferenceFieldMDP, "pdfrb/model/type/signature_build"
+
+      # Page box color info (s7.7.3.3).
+      autoload :BoxColorInfo, "pdfrb/model/type/box_color_info"
+      autoload :BoxStyle, "pdfrb/model/type/box_style"
+
+      # Collection / Portfolio (s7.11.5).
+      autoload :Collection, "pdfrb/model/type/collection"
+      autoload :CollectionSchema, "pdfrb/model/type/collection_schema"
+      autoload :CollectionSort, "pdfrb/model/type/collection_sort"
+      autoload :CollectionField, "pdfrb/model/type/collection_field"
+      autoload :CollectionItem, "pdfrb/model/type/collection_item"
+
+      # Signature transform parameters (s12.8.2).
+      autoload :MDPDict, "pdfrb/model/type/mdp_dict"
+      autoload :FieldMDPTransformParameters, "pdfrb/model/type/field_mdp_transform_parameters"
+      autoload :URTransformParameters, "pdfrb/model/type/ur_transform_parameters"
+
+      # Embedded file params + misc globals.
+      autoload :EmbeddedFileParameter, "pdfrb/model/type/embedded_file_parameter"
+      autoload :JBIG2Globals, "pdfrb/model/type/jbig2_globals"
+      autoload :URLAlias, "pdfrb/model/type/url_alias"
+      autoload :URIDict, "pdfrb/model/type/uri_dict"
+
+      autoload :Field, "pdfrb/model/type/form_field"
+      autoload :TextField, "pdfrb/model/type/text_field"
+      autoload :Button, "pdfrb/model/type/button"
+      autoload :Choice, "pdfrb/model/type/choice"
+      autoload :SignatureField, "pdfrb/model/type/signature_field"
+
+      # Structure types (s14.7).
+      autoload :StructureAttributes, "pdfrb/model/type/structure_attributes"
+      autoload :StructureElementKid, "pdfrb/model/type/structure_element_kid"
     end
   end
 end

data/lib/pdfrb/serializer.rb

@@ -19,8 +19,8 @@ module Pdfrb
     end
 
     class << self
-      def serialize(value, encrypter: nil, **opts)
-        new(encrypter: encrypter, **opts).serialize(value)
+      def serialize(value, encrypter: nil, **)
+        new(encrypter: encrypter, **).serialize(value)
       end
     end
 

data/lib/pdfrb/source/tokenizer.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "set"
-
 module Pdfrb
   module Source
     # Byte-level PDF lexer (s7.2). State machine that emits Token

data/lib/pdfrb/task/benchmark.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require "benchmark"
+require "stringio"
+
+module Pdfrb
+  module Task
+    # Performance benchmarks for parsing, serialization, and round-trip.
+    # Uses the corpus generator to produce test PDFs of various sizes,
+    # then measures throughput.
+    #
+    # Usage:
+    #   Pdfrb::Task::Benchmark.run
+    #   Pdfrb::Task::Benchmark.run(repetitions: 100)
+    class Benchmark
+      Result = Struct.new(:name, :repetitions, :total_seconds,
+                          :ops_per_second, :bytes_per_op, keyword_init: true)
+
+      class << self
+        def run(repetitions: 50)
+          corpus = GenerateCorpus.all
+          results = []
+
+          corpus.each do |name, pdf_bytes|
+            next if pdf_bytes.empty?
+
+            r = bench_parse(name, pdf_bytes, repetitions)
+            results << r
+            puts format_result(r)
+          end
+
+          bench_round_trip(results, repetitions)
+          results
+        end
+
+        def bench_parse(name, pdf_bytes, repetitions)
+          io = StringIO.new(pdf_bytes)
+          elapsed = ::Benchmark.realtime do
+            repetitions.times do
+              io.rewind
+              Pdfrb::Document.new(io: StringIO.new(pdf_bytes))
+            end
+          end
+
+          Result.new(
+            name: "parse:#{name}",
+            repetitions: repetitions,
+            total_seconds: elapsed,
+            ops_per_second: repetitions / elapsed,
+            bytes_per_op: pdf_bytes.bytesize
+          )
+        end
+
+        def bench_serialize(name, pdf_bytes, repetitions)
+          doc = Pdfrb::Document.new(io: StringIO.new(pdf_bytes))
+          elapsed = ::Benchmark.realtime do
+            repetitions.times do
+              StringIO.new.tap { |io| doc.write(io: io) }
+            end
+          end
+
+          Result.new(
+            name: "serialize:#{name}",
+            repetitions: repetitions,
+            total_seconds: elapsed,
+            ops_per_second: repetitions / elapsed,
+            bytes_per_op: pdf_bytes.bytesize
+          )
+        end
+
+        def bench_round_trip(_results, _repetitions)
+          nil
+        end
+
+        def format_result(result)
+          format("%-25s  %6.1f ops/s  %7.1f KB/op  %6.3fs total",
+                 result.name, result.ops_per_second,
+                 result.bytes_per_op / 1024.0, result.total_seconds)
+        end
+      end
+    end
+  end
+end

data/lib/pdfrb/task/extract_text.rb

@@ -161,7 +161,7 @@ module Pdfrb
         def parse_tounicode(ref)
           return nil unless ref
 
-          doc = @font_dict.respond_to?(:document) ? @font_dict.document : nil
+          doc = @font_dict.is_a?(Pdfrb::Model::Cos::Dictionary) ? @font_dict.document : nil
           stream = if ref.is_a?(Pdfrb::Model::Reference) && doc
                      doc.object(ref)
                    else