acro_that 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56f6be44d023bdedaf254cc097d18791f284793d0c79c07847fd462c0643cc91
-  data.tar.gz: b649d290433fac6a6113a74ca47bfde60e31687f6e93b85e30c32053ee416b3a
+  metadata.gz: 40016774a590828e59c4c9ea4331a8d170ccd536d7522cbdb193fefda3f28333
+  data.tar.gz: bade6f113359d96d1f7c1a85efd7033732350c0b19bf40dd412e104da359aa5a
 SHA512:
-  metadata.gz: b27c5ec88a2cfdec49750d9d3316979c90c0815461eb6281b4cf602dc6533c8761c8fba7fb49407256b9ade87f2f3731e8f9d121c4ef089d08be2901107cc295
-  data.tar.gz: f1b41cef40049564af8f081547460d72e787a721f676db4c80cd74eb21844b48364ac3b871e6ad2839505908d9e5be3b8d643c16812bd91ae6d0e858bcfb51eb
+  metadata.gz: 60e6c6afd93cfd8911c0b0a0d4b6b080cb2c8af85a104cf3fd09f8fc7f9ac642999a8d5694c374ad64b71d4aa769f6d8b390cc82829317abd64598aa42e7280f
+  data.tar.gz: 31762cf9f6f285edd78976692e9c5bab7a67cf6298a03c8d4208b02927639be29e0d1f4ca1f14c3f1c170b9f617404e0931dc8bbedd17de79fcee5c80035dd29

data/README.md

@@ -234,6 +234,32 @@ fields.each do |field|
 end
 ```
 
+#### `#list_pages`
+Returns an array of `Page` objects representing all pages in the document. Each `Page` object provides page information and methods to add fields to that specific page.
+
+```ruby
+pages = doc.list_pages
+pages.each do |page|
+  puts "Page #{page.page_number}: #{page.width}x#{page.height}"
+end
+
+# Add fields to specific pages - the page is automatically set!
+first_page = pages[0]
+first_page.add_field("Name", x: 100, y: 700, width: 200, height: 20)
+
+second_page = pages[1]
+second_page.add_field("Email", x: 100, y: 650, width: 200, height: 20)
+```
+
+**Page Object Methods:**
+- `page.page_number` - Returns the page number (1-indexed)
+- `page.width` - Page width in points
+- `page.height` - Page height in points
+- `page.ref` - Page object reference `[obj_num, gen_num]`
+- `page.metadata` - Hash containing page metadata (rotation, boxes, etc.)
+- `page.add_field(name, options)` - Add a field to this page (page number is automatically set)
+- `page.to_h` - Convert to hash for backward compatibility
+
 #### `#add_field(name, options)`
 Adds a new form field to the document. Options include:
 - `value`: Default value for the field (String)

data/lib/acro_that/document.rb

@@ -179,13 +179,14 @@ module AcroThat
           contents_refs: contents_refs
         }
 
-        pages << {
-          page: index + 1, # Page number starting at 1
-          width: width,
-          height: height,
-          ref: ref,
-          metadata: metadata
-        }
+        pages << Page.new(
+          index + 1, # Page number starting at 1
+          width,
+          height,
+          ref,
+          metadata,
+          self # Pass document reference
+        )
       end
 
       pages

data/lib/acro_that/page.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module AcroThat
+  # Represents a page in a PDF document
+  class Page
+    attr_reader :page, :width, :height, :ref, :metadata, :document
+
+    def initialize(page, width, height, ref, metadata, document)
+      @page = page # Page number (1-indexed)
+      @width = width
+      @height = height
+      @ref = ref # [obj_num, gen_num]
+      @metadata = metadata # Hash with :rotate, :media_box, :crop_box, etc.
+      @document = document
+    end
+
+    # Add a field to this page
+    # Options are the same as Document#add_field, but :page is automatically set
+    def add_field(name, options = {})
+      # Automatically set the page number to this page
+      options_with_page = options.merge(page: @page)
+      @document.add_field(name, options_with_page)
+    end
+
+    # Get the page number
+    def page_number
+      @page
+    end
+
+    # Get the page reference [obj_num, gen_num]
+    def page_ref
+      @ref
+    end
+
+    # Check if page has rotation
+    def rotated?
+      !@metadata[:rotate].nil? && @metadata[:rotate] != 0
+    end
+
+    # Get rotation angle (0, 90, 180, 270)
+    def rotation
+      @metadata[:rotate] || 0
+    end
+
+    # Get MediaBox dimensions
+    def media_box
+      @metadata[:media_box]
+    end
+
+    # Get CropBox dimensions
+    def crop_box
+      @metadata[:crop_box]
+    end
+
+    # Get ArtBox dimensions
+    def art_box
+      @metadata[:art_box]
+    end
+
+    # Get BleedBox dimensions
+    def bleed_box
+      @metadata[:bleed_box]
+    end
+
+    # Get TrimBox dimensions
+    def trim_box
+      @metadata[:trim_box]
+    end
+
+    # String representation for debugging
+    def to_s
+      dims = width && height ? " #{width}x#{height}" : ""
+      rot = rotated? ? " (rotated #{rotation}°)" : ""
+      "#<AcroThat::Page page=#{page}#{dims}#{rot} ref=#{ref.inspect}>"
+    end
+
+    alias inspect to_s
+
+    # Convert to hash for backward compatibility
+    def to_h
+      {
+        page: @page,
+        width: @width,
+        height: @height,
+        ref: @ref,
+        metadata: @metadata
+      }
+    end
+  end
+end
+

data/lib/acro_that/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AcroThat
-  VERSION = "0.1.3"
+  VERSION = "0.1.4"
 end

data/lib/acro_that.rb

@@ -12,6 +12,7 @@ require_relative "acro_that/objstm"
 require_relative "acro_that/pdf_writer"
 require_relative "acro_that/incremental_writer"
 require_relative "acro_that/field"
+require_relative "acro_that/page"
 require_relative "acro_that/document"
 
 # Load actions

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: acro_that
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Michael Wynkoop
@@ -116,6 +116,7 @@ files:
 - lib/acro_that/incremental_writer.rb
 - lib/acro_that/object_resolver.rb
 - lib/acro_that/objstm.rb
+- lib/acro_that/page.rb
 - lib/acro_that/pdf_writer.rb
 - lib/acro_that/version.rb
 - publish