acro_that 0.1.7 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e5f98c3666d2a74883becbcb49e9c18fd4fc04a64f0e0dfd883b4c48056d64b8
-  data.tar.gz: 13545403d27dcbbccc1474e88a8d97d45336c5afd292362692e8c50e2ef6c15a
+  metadata.gz: c25e9ad58be5a660ea6abb5a56896fef953d67578425b01a9de86f1cc1ae8a1d
+  data.tar.gz: 45133e292e45343903ee53b44f709149bea0353d9aa7e2a2a9f3c6fa676da1dd
 SHA512:
-  metadata.gz: 55313e86d76491aae1ff68c78651d631ac0cfc8cf7feccd462f4ba3fbe37c3ba4c1f181102c9e849b0af837a817dd02681a97c468792a58e0fc8b93e9e486fb5
-  data.tar.gz: 52d751681abc5e46db4e66721eaa8871cf2a7251d418b819a72fb6485f66263c8679cb7eb32bba74d478a8983fd1a194f92d3b490702546485d0b985b71c4b54
+  metadata.gz: 7762f8c137e7b29c6cdbc15c8ce3fd9387b96dfc4a22a64ee171fc0c9c8d7f67951b42fb491cb283e160aced6a37d0e6eaa30599fa63d0876a77a9be8506d493
+  data.tar.gz: 7a92be45bc9810a3e085c67fe0ee7b0a245925179ec345bbf0f3cb56cc4b2195bc6faca01f27a64c86646c7ef5c91dd1c6f732140905a6d208c4e8c476ff0458

data/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.8] - 2025-11-04
+
+### Fixed
+- Fixed PDF parsing error when PDFs are wrapped in multipart form data. PDFs uploaded via web forms (with boundary markers like `------WebKitFormBoundary...`) are now automatically extracted before processing, ensuring correct offset calculations for xref tables and streams.
+
 ## [0.1.5] - 2025-11-01
 
 ### Fixed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    acro_that (0.1.6)
+    acro_that (0.1.8)
       chunky_png (~> 1.4)
 
 GEM

data/README.md

@@ -175,6 +175,84 @@ doc.write("form_with_signature.pdf")
 
 **Note**: PNG image processing requires the `chunky_png` gem, which is included as a dependency. JPEG images can be processed without any additional dependencies.
 
+#### Radio Buttons
+
+Radio buttons allow users to select a single option from a group of mutually exclusive choices. Radio buttons in AcroThat are created using the `:radio` type and require a `group_id` to group related buttons together.
+
+```ruby
+doc = AcroThat::Document.new("form.pdf")
+
+# Create a radio button group with multiple options
+# All buttons in the same group must share the same group_id
+
+# First radio button in the group (creates the parent field)
+doc.add_field("Option1", 
+  type: :radio,
+  group_id: "my_radio_group",
+  value: "option1",  # Export value for this button
+  x: 100,
+  y: 500,
+  width: 20,
+  height: 20,
+  page: 1,
+  selected: true  # This button will be selected by default
+)
+
+# Second radio button in the same group
+doc.add_field("Option2", 
+  type: :radio,
+  group_id: "my_radio_group",  # Same group_id as above
+  value: "option2",
+  x: 100,
+  y: 470,
+  width: 20,
+  height: 20,
+  page: 1
+)
+
+# Third radio button in the same group
+doc.add_field("Option3", 
+  type: :radio,
+  group_id: "my_radio_group",  # Same group_id
+  value: "option3",
+  x: 100,
+  y: 440,
+  width: 20,
+  height: 20,
+  page: 1
+)
+
+# Write the PDF with radio buttons
+doc.write("form_with_radio.pdf")
+```
+
+**Key Points:**
+- **`group_id`**: Required. All radio buttons that should be mutually exclusive must share the same `group_id`. This can be any string or identifier.
+- **`type: :radio`**: Required. Specifies that this is a radio button field.
+- **`value`**: The export value for this specific button. This is what gets returned when the button is selected. If not provided, a unique value will be generated automatically.
+- **`selected`**: Optional boolean (`true` or `false`, or string `"true"`). If set to `true`, this button will be selected by default. Only one button in a group should have `selected: true`. If not specified, the button defaults to unselected.
+- **Positioning**: Each radio button needs its own `x`, `y`, `width`, `height`, and `page` values to position it on the form.
+
+**Example with multiple groups:**
+
+```ruby
+doc = AcroThat::Document.new("form.pdf")
+
+# First radio button group (e.g., "Gender")
+doc.add_field("Male", type: :radio, group_id: "gender", value: "male", x: 100, y: 500, width: 20, height: 20, page: 1, selected: true)
+doc.add_field("Female", type: :radio, group_id: "gender", value: "female", x: 100, y: 470, width: 20, height: 20, page: 1)
+doc.add_field("Other", type: :radio, group_id: "gender", value: "other", x: 100, y: 440, width: 20, height: 20, page: 1)
+
+# Second radio button group (e.g., "Age Range")
+doc.add_field("18-25", type: :radio, group_id: "age", value: "18-25", x: 200, y: 500, width: 20, height: 20, page: 1)
+doc.add_field("26-35", type: :radio, group_id: "age", value: "26-35", x: 200, y: 470, width: 20, height: 20, page: 1, selected: true)
+doc.add_field("36+", type: :radio, group_id: "age", value: "36+", x: 200, y: 440, width: 20, height: 20, page: 1)
+
+doc.write("form_with_multiple_groups.pdf")
+```
+
+**Note:** Radio buttons are automatically configured with the correct PDF flags to enable mutual exclusivity within a group. When a user selects one radio button, all others in the same group are automatically deselected.
+
 #### Flattening PDFs
 
 ```ruby
@@ -269,8 +347,10 @@ Adds a new form field to the document. Options include:
 - `height`: Field height (Integer, default: 20)
 - `page`: Page number to add the field to (Integer, default: 1)
 - `type`: Field type (Symbol or String, default: `"/Tx"`). Options:
-  - Symbol keys: `:text`, `:button`, `:choice`, `:signature`
+  - Symbol keys: `:text`, `:button`, `:choice`, `:signature`, `:radio`
   - PDF type strings: `"/Tx"`, `"/Btn"`, `"/Ch"`, `"/Sig"`
+- `group_id`: Required for radio buttons. String or identifier to group radio buttons together. All radio buttons in the same group must share the same `group_id`.
+- `selected`: Optional for radio buttons. Boolean (`true` or `false`, or string `"true"`). If set to `true`, this radio button will be selected by default.
 
 Returns a `Field` object if successful.
 
@@ -280,6 +360,9 @@ field = doc.add_field("NewField", value: "Value", x: 100, y: 500, width: 200, he
 
 # Using PDF type strings
 field = doc.add_field("ButtonField", type: "/Btn", x: 100, y: 500, width: 20, height: 20, page: 1)
+
+# Radio button example
+field = doc.add_field("Option1", type: :radio, group_id: "my_group", value: "option1", x: 100, y: 500, width: 20, height: 20, page: 1, selected: true)
 ```
 
 #### `#update_field(name, new_value, new_name: nil)`
@@ -351,8 +434,8 @@ doc.clear!(remove_pattern: /^text-/)
 # Keep only specific fields
 doc.clear!(keep_fields: ["Name", "Email"])
 
-# Use block to filter fields
-doc.clear! { |name| !name.match?(/^[a-f0-9-]{30,}/) }
+# Use block to filter fields (return true to remove)
+doc.clear! { |field| field.name.match?(/^[a-f0-9-]{30,}/) }
 ```
 
 **Note:** This completely rewrites the PDF (like `flatten`), so it's more efficient than using `remove_field` multiple times. See [Clearing Fields Documentation](docs/cleaning_fields.md) for detailed information.

data/docs/clear_fields.md

@@ -75,11 +75,11 @@ doc.clear!(remove_fields: ["OldField1", "OldField2", "GeneratedField3"])
 ### Complex Selection with Block
 
 ```ruby
-# Remove all fields except those matching certain criteria
-doc.clear! do |field_name|
-  # Keep fields that don't look generated
-  !field_name.start_with?("text-") && 
-  !field_name.match?(/^[a-f0-9]{20,}/)
+# Remove fields matching certain criteria
+doc.clear! do |field|
+  # Remove fields that look generated
+  field.name.start_with?("text-") || 
+  field.name.match?(/^[a-f0-9]{20,}/)
 end
 ```
 
@@ -179,11 +179,11 @@ require 'acro_that'
 doc = AcroThat::Document.new("messy_form.pdf")
 
 # Remove all generated/UUID-like fields
-doc.clear! { |name| 
-  # Keep only fields that look intentional
-  !name.match?(/^[a-f0-9-]{30,}/) &&  # Not UUID-like
-  !name.start_with?("temp_") &&       # Not temporary
-  !name.empty?                         # Not empty
+doc.clear! { |field| 
+  # Remove fields that look generated or temporary
+  field.name.match?(/^[a-f0-9-]{30,}/) ||  # UUID-like
+  field.name.start_with?("temp_") ||       # Temporary
+  field.name.empty?                         # Empty name
 }
 
 # Add new fields