pdfrb 0.8.10 → 0.8.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9ccd2f148c786f735078767b672eacf4e8861100894f68b248905074c73e7eb
-  data.tar.gz: eaceeb41569d8fab78bcd46891608f6760d4c2a3d47ef45da896c500e32dd736
+  metadata.gz: ff9335841bf5176c9489855fe26937637022fb139e2b212e6f5b4aba351aca21
+  data.tar.gz: cbeaed5651257801ed201b45af40b510a28cdf65934b7d18b3347c7372ec5cfa
 SHA512:
-  metadata.gz: 909be54b72b05e78ec5bda296a335cfb2b1e78cf2ade15695d45b59e29bb9c73ef95cbfa5f1c4bb4c61a8a191055aaff2dfb3e36e0efb4970b7c0bf71d19cee8
-  data.tar.gz: 609afef48ccdeed968a0f1791dd1b7f5e295ce1169e6ab4c4ace378fdd6bd6f5eab116b67c15b4feb40eab0f590a6a4dc29cb0e30910c393624dd8a61f72d112
+  metadata.gz: 5bd0ad5e3e50563ce7aeb42990fcae8e830fefd8cb10cc5270d6f281b570a620ab5bfa5e8df8c08aaa6fc8252b0e5e395a447e050a853fade8d75dd1fa6f99b1
+  data.tar.gz: c3e35e0a4d2b44e723f171aafcc3a807f399e5b00041e52fb423658654849064047190f35e1d84abba9259f37f4cbfe48b69ab2eff56dfedf577c0f600c977e2

data/lib/pdfrb/document/outline.rb

@@ -2,8 +2,12 @@
 
 module Pdfrb
   class Document
-    # Bookmark/outline facade. Builds the /Outlines tree on the
-    # Catalog so PDF viewers show a navigation panel.
+    # Bookmark/outline facade. Two directions:
+    #   * build — add/build! construct the /Outlines tree on the
+    #     Catalog so PDF viewers show a navigation panel;
+    #   * read — each/to_a walk an existing outline depth-first
+    #     (parents before children), yielding typed
+    #     Model::Type::OutlineItem objects.
     class Outline
       attr_reader :document, :entries
 
@@ -53,6 +57,55 @@ module Pdfrb
         @document.catalog.value[:Outlines] = root_ref
         root
       end
+
+      # Enumerate bookmark items depth-first (preorder: a parent
+      # yields before its children). Returns an Enumerator when
+      # blockless. Malformed chains (loops, dangling refs) are
+      # tolerated: each item is visited once.
+      def each(&)
+        return enum_for(:each) unless block_given?
+
+        root = outline_root
+        walk_outline_chain(root&.value&.[](:First), {}, &)
+        self
+      end
+
+      def to_a
+        each.to_a
+      end
+
+      def empty?
+        root = outline_root
+        root.nil? || root.value[:First].nil?
+      end
+
+      private
+
+      def outline_root
+        ref = document.catalog.value[:Outlines]
+        return nil if ref.nil?
+
+        obj = document.resolve(ref)
+        obj.is_a?(Pdfrb::Model::Object) ? obj : nil
+      end
+
+      # Follow a sibling chain starting at +ref+, recursing into
+      # each item's children (/First) before the next sibling.
+      def walk_outline_chain(ref, seen, &)
+        return if ref.nil?
+
+        item = document.object(ref)
+        return unless item.is_a?(Pdfrb::Model::Object)
+        return if seen.key?(item.oid)
+
+        seen[item.oid] = true
+        typed = document.wrap(item.value,
+                              type: Pdfrb::Model::Type::OutlineItem,
+                              oid: item.oid, gen: item.gen)
+        yield typed
+        walk_outline_chain(typed.value[:First], seen, &)
+        walk_outline_chain(typed.value[:Next], seen, &)
+      end
     end
 
     class OutlineEntry

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

@@ -8,7 +8,10 @@ module Pdfrb
       class OutlineItem < Pdfrb::Model::Cos::Dictionary
         arlington_object "OutlineItem"
 
-        def title; self[:Title]; end
+        def title
+          Pdfrb::Model::Cos::TextString.decode(self[:Title])
+        end
+
         def parent; self[:Parent]; end
         def prev; self[:Prev]; end
         def next; self[:Next]; end

data/lib/pdfrb/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pdfrb
 version: !ruby/object:Gem::Version
-  version: 0.8.10
+  version: 0.8.11
 platform: ruby
 authors:
 - Ribose Inc.