corp_pdf 1.0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fe571644d98559aebc1201878125a75eb96d1cda4a01f59d7c62a2783de9006c
+  data.tar.gz: ead3b549dbffce573981c5ecce1b4a08401a6eb23d407ed50c086388c551bd36
+SHA512:
+  metadata.gz: a37bc26b4125c885fb121d170212ab75d4f85ce2f0366c53feb93a233128cfdd1ec1d01091ac77ba027bd6ed2daa0d960060a8e5d5a8353ff0d5422cdda5def3
+  data.tar.gz: d8cbba8496866a6a2e2326ec69a8206a2100d4693dc0d5d233cec930767da4d23bcc56e61ab51fc162ec2bc56be5033e398ae06f5c2e24910f182c476f183091

data/.gitignore

@@ -0,0 +1,13 @@
+.byebug_history
+.rspec_status
+
+*.pdf
+*.png
+*.jpg
+*.gem
+
+research/
+pdf_test_script.rb
+.cursor/
+
+.DS_Store

data/.rubocop.yml

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require:
+  - rubocop-rspec
+
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.1
+  Exclude:
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - '*.gemspec'
+
+# Disable problematic cops
+Capybara/RSpec/PredicateMatcher:
+  Enabled: false
+
+RSpec/FilePath:
+  Enabled: false
+
+RSpec/SpecFilePathFormat:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+
+Layout/LineLength:
+  Max: 120
+
+Metrics/AbcSize:
+  Max: 20
+
+Metrics/MethodLength:
+  Max: 20
+
+Metrics/ClassLength:
+  Max: 150
+
+Metrics/ModuleLength:
+  Max: 150
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+    - 'Rakefile'
+
+Style/ClassAndModuleChildren:
+  Enabled: false
+
+Style/GuardClause:
+  Enabled: false
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/RedundantReturn:
+  Enabled: false
+
+Style/RescueStandardError:
+  Enabled: false
+
+Style/SafeNavigation:
+  Enabled: false
+
+Style/TrivialAccessors:
+  Enabled: false
+
+RSpec/ExampleLength:
+  Max: 10
+
+RSpec/MultipleExpectations:
+  Max: 5

data/CHANGELOG.md

@@ -0,0 +1,122 @@
+# Changelog
+
+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).
+
+## [1.0.5] - 2025-11-12
+
+### Changed
+- Renamed gem from `acro_that` to `corp_pdf`
+- Renamed module from `AcroThat` to `CorpPdf`
+- Updated all internal references, documentation, and examples
+
+## [1.0.4] - 2025-11-12
+
+### Fixed
+- Fixed `Encoding::CompatibilityError` when processing field values with special characters (e.g., "María", "José"). Special characters are now automatically transliterated to ASCII equivalents (e.g., "María" → "Maria") before encoding to PDF format, ensuring compatibility with PDF string encoding requirements.
+
+### Added
+- Added I18n gem as a runtime dependency for transliteration support
+- Added `DictScan.transliterate_to_ascii` method to convert special characters to ASCII equivalents
+- Automatic transliteration for text field values and radio button field export values
+
+## [1.0.3] - 2025-11-07
+
+### Fixed
+- Fixed `/DA` (default appearance) metadata handling for text fields. When `/DA` is provided in metadata, it is now properly applied to both field dictionaries and widget annotations for text fields.
+
+## [1.0.2] - 2025-11-06
+
+### Fixed
+- Fixed xref table generation to properly handle missing object numbers. The xref table now correctly marks missing objects as free entries, ensuring PDF compatibility with viewers that strictly validate xref tables.
+
+### Changed
+- Updated `.gitignore` to exclude image files (`.png`, `.jpg`) from version control
+
+## [1.0.1] - 2025-11-05
+
+### Fixed
+- Fixed checkbox field appearance state handling
+- Improved radio button field value handling and appearance updates
+- Enhanced `update_field` to better handle checkbox and radio button state changes
+- Fixed field type detection for button fields in `add_field`
+
+### Changed
+- Refactored checkbox and radio button field creation logic for better consistency
+
+## [1.0.0] - 2025-11-05
+
+### Added
+- Added radio button field support with `group_id` option for creating mutually exclusive radio button groups
+- Refactored field types into separate classes (`Text`, `Checkbox`, `Radio`, `Signature`) for better code organization and maintainability
+- Added `Fields::Base` module with shared functionality for all field types
+- Improved field creation and update logic with better separation of concerns
+
+### Changed
+- Major refactoring of field type handling - field types are now implemented as separate classes rather than inline conditionals
+- Improved code organization and maintainability
+
+## [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.7] - 2025-11-03
+
+### Changed
+- Memory optimization improvements for document processing and field operations
+
+## [0.1.6] - 2025-11-01
+
+### Added
+- Added new utility methods to `DictScan` for improved PDF dictionary parsing and manipulation
+- Enhanced `add_field` action with improved field creation logic
+- Enhanced `update_field` action with better field value update handling
+
+### Changed
+- Major refactoring of `add_field` and `update_field` actions for improved code organization
+- Refactored `Document` class to reduce code duplication
+- Improved field handling and metadata processing
+
+## [0.1.5] - 2025-11-01
+
+### Fixed
+- Fixed signature field image data parsing when adding signature fields. Image data (base64 or data URI) is now properly detected and parsed when creating signature fields, matching the behavior of `update_field`.
+- Fixed multiline text field handling
+
+### Added
+- Added support for `metadata` option in `add_field` to pass PDF widget properties. This allows setting properties like field flags (`Ff`) for multiline text fields, alignment (`Q`), and other PDF widget options directly when creating fields.
+
+## [0.1.4] - 2025-11-01
+
+### Fixed
+- Fixed bug where fields added to multi-page PDFs were all placed on the same page. Fields now correctly appear on their specified pages when using the `page` option in `add_field`.
+
+### Changed
+- Refactored page-finding logic to eliminate code duplication across `Document` and `AddField` classes
+- Unified page discovery through `Document#find_all_pages` and `Document#find_page_by_number` methods
+- Updated all page detection patterns to use centralized `DictScan.is_page?` utility method
+
+### Added
+- `DictScan.is_page?` utility method for consistent page object detection across the codebase
+- `Document#find_all_pages` private method for unified page discovery in document order
+- `Document#find_page_by_number` private method for finding pages by page number
+- Exposed `find_page_by_number` through `Base` module for use in action classes
+
+## [0.1.3] - 2025-11-01
+
+### Changed
+- Version bump release
+
+## [0.1.1] - 2025-10-31
+
+### Added
+- Initial release of CorpPdf
+- Pure Ruby PDF AcroForm editing library
+- Support for parsing, listing, adding, removing, and modifying form fields
+- Signature field image appearance support (JPEG and PNG)
+- PDF flattening functionality
+- StringIO support for in-memory PDF processing
+

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,90 @@
+PATH
+  remote: .
+  specs:
+    corp_pdf (1.0.5)
+      chunky_png (~> 1.4)
+      i18n (~> 1.14)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.3)
+    chunky_png (1.4.0)
+    coderay (1.1.3)
+    concurrent-ruby (1.3.5)
+    diff-lcs (1.6.2)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    json (2.15.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    method_source (1.1.0)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.6.0)
+    pry (0.15.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    regexp_parser (2.11.3)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.6)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    rubocop (1.81.6)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.47.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    rubocop-capybara (2.22.1)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    rubocop-factory_bot (2.27.1)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    rubocop-rspec (2.31.0)
+      rubocop (~> 1.40)
+      rubocop-capybara (~> 2.17)
+      rubocop-factory_bot (~> 2.22)
+      rubocop-rspec_rails (~> 2.28)
+    rubocop-rspec_rails (2.29.1)
+      rubocop (~> 1.61)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+
+PLATFORMS
+  arm64-darwin-22
+  ruby
+
+DEPENDENCIES
+  corp_pdf!
+  pry (~> 0.14)
+  rspec (~> 3.0)
+  rubocop (~> 1.50)
+  rubocop-rspec (~> 2.20)
+
+BUNDLED WITH
+   2.5.21