pdfrb 0.6.0 → 0.7.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f24b6c90eb4e01436139908a7aaa0472ed8a22704e40e934f651c0265763d62
-  data.tar.gz: da4e7fc8a4f9c4cecbbf22ca2ab2288ca8f07c4bc974dc6eac8b2166fb784d94
+  metadata.gz: e852ec0176452037ffd0e715fc4edd866261d20e9de19938e0342741701e7f4a
+  data.tar.gz: 1e36dcfec95c64efa1265c4264a34f290ecd82de3b7acc65dd6d6c315b845e4b
 SHA512:
-  metadata.gz: 550b8e52600d4ebe1cffbce341d0725d750a41ba8585c1b85c827f9c7a4b6fda7e24d6dd6f3c2ed6f5f83e442729e792f3fef05a9d34459118a9720d039bf3bb
-  data.tar.gz: c950a24d0cf3af6734edbe2819d0390c07442fa941e026be4744fb6db0e02beadc4e3d2ac220fbb5d4f52eee67bc3e9d19e03602dabaaefdf65929ecbe1a61d3
+  metadata.gz: '085c4d548c341bb9db63df48b0b5c9efc2eb897c135e36b57f36cd1385c7062a5b08f043113695f2a0b5f30caa4e02d11fa5031cbf870b83827bc4303cddc0f3'
+  data.tar.gz: a5a131520e73cee21be784f947e6bf21c348d708b54d86757a90b6dc3a2de925ca8188b544f7864b53c4930d60c3a101f4281e9517adf4188f2b6d85dc1eeb1b

data/CHANGELOG.md

@@ -2,6 +2,150 @@
 
 All notable changes to the pdfrb gem will be documented in this file.
 
+## [Unreleased]
+
+### Added — Parity batches 4-9
+
+* **TODO 103 Hyphenation** — Knuth-Liang `Pdfrb::Layout::Hyphenation`
+  with curated English patterns in `data/pdfrb/layout/hyphenation_en.txt`.
+* **TODO 116 PDF/X-6** — `Pdfrb::Conformance::PdfX#X6` ISO 15930-11
+  profile.
+* **TODO 117 PDF/VT** — `Pdfrb::Conformance::PdfVT` (VT-1, VT-2)
+  ISO 16612-2 profiles.
+* **TODO 118 Multi-revision traversal** — `Document#each_revision`
+  walks the `/Prev` chain yielding `(revision_index, xref, trailer)`.
+* **TODO 119 Table cell spans** — `TableBox.cell(box, colspan:,
+  rowspan:)`, hash-form cells, span-aware layout.
+* **TODO 120 Multi-page table** — `MultiPageTableBox` splits a table
+  across pages with header-row repeat.
+* **TODO 122 Bidi** — `Pdfrb::Layout::Bidi` paragraph-level UAX #9
+  reordering; `TextLayouter` reorders Hebrew/Arabic for visual order.
+* **TODO 128 Linearization-aware reader** —
+  `Source::LinearizationReader.detect(io)` parses the first indirect
+  object's dict for `/Linearized`.
+* **TODO 129 Type3 font loader** — `Pdfrb::FontLoader::Type3` with
+  glyph procedures + encoding.
+* **TODO 131 Inline images (write)** — `Canvas#inline_image(dict:,
+  data:)` plus `Operator::{BeginInlineImage, EndInlineImage}`.
+* **TODO 133 Custom canvas primitives** — `polyline`, `polygon`,
+  `arc`, `circle`, `ellipse`, `rounded_rectangle`, `dash=`.
+* **TODO 135 PDF thumbnail generation** — `Pdfrb::Task::Thumbnail`
+  builds `/Thumb` image XObjects on every page.
+* **TODO 136 PDF/A preflight deep** — `PREFLIGHT_DEEP` rule set on
+  PdfA (JavaScript, PostScript XObjects, encryption, embedded-file
+  bans for A-1/A-2/A-4).
+* **TODO 137 PDF/UA tagging deep** — list/LI/LBody, Table/TR,
+  TH/Scope structural checks.
+* **TODO 138 Tagged PDF validation** —
+  `Pdfrb::Conformance::TaggedPdf` baseline structural rule set.
+* **TODO 140 PDF 2.0 AF validation** —
+  `Pdfrb::Conformance::Pdf2AF` App Note 002 validator.
+* **TODO 104 Default ICC profile** — `Color::DefaultProfile` emits a
+  usable sRGB v4 ICC profile with desc/wtpt/rXYZ/gXYZ/bXYZ/rTRC/
+  gTRC/bTRC tags and a real MD5 Profile ID.
+* **TODO 139 ICC profile validation** —
+  `Pdfrb::Color::ICCValidator` checks signature, version, device
+  class, color space per ICC.1:2022 §7.
+* **TODO 108 Image downsampling** —
+  `Pdfrb::Image::Downsampler` + `Task::Optimize#downsample_images!`
+  for FlateDecode 8-bpc non-palette images.
+* **TODO 130 Color-key masking** — `ImageLoader::PNG` parses tRNS and
+  emits `/Mask` color-key array.
+* **TODO 131 Inline images (read)** — `Content::Parser` recognises
+  the BI/ID/EI sequence and yields an `InlineImage` invocation.
+* **TODO 132 Page-piece dict** —
+  `Pdfrb::Model::Type::PagePieceInfo` per s14.5.
+* **TODO 134 Tagged PDF alt-text API** — `Document::Structure`
+  facade for `/Alt`, `/ActualText`, `/Lang`.
+* **Layout** — cluster-aware default `TextShaper`, real AFM-based
+  `FontFallback`, `PolygonFrame` with proper inscribed-rectangle
+  scan, `MultiCellTextLayout`, `JustificationKashidas`.
+* **Encryption** — `StandardSecurityHandler.for_v5` write-side
+  AES-256 R6 handler (file key + `/U`/`/O`/`/UE`/`/OE`/`/Perms`),
+  `V5Writer` PKCS#5 algorithms, `PublicKeySecurityHandler` with
+  real CMS EnvelopedData construction via `OpenSSL::PKCS7`.
+* **Signatures** — `Pdfrb::Conformance::Pades` (B-B, B-T, B-LT,
+  B-LTA profiles), `Pdfrb::Conformance::Ltv` long-term validation,
+  `Pdfrb::Conformance::PdfA4Deep`, `PdfUA2Deep`,
+  `DigitalSignature::TimestampClient` (RFC 3161 TSA over HTTPS).
+* **Images** — `ImageLoader::TIFF` decodes uncompressed RGB/gray;
+  `ImageLoader::GIF` does full GIF-spec LZW decode with palette.
+* **Source** — extended `Pdfrb::Source::Recovery` with
+  trailer-reference recovery, hybrid-xref detection,
+  object-stream rebuild.
+* **Tasks** — `Pdfrb::Task::RegenerateAppearances` walks widget
+  annotations and rebuilds `/AP /N` via `Appearance::Generator`.
+
+### Fixed
+
+* Stream deduplication in `Task::Optimize` (was a stub).
+* `Writer#write_xref_stream` now emits a free entry for every gap
+  in the oid space (was misaligning the reader).
+* `Document::Form#flatten!` now stamps field appearances into page
+  content via `/Do` (was a stub).
+* Issue #63: PostScript name extraction for `/BaseFont`.
+* Issue #64: `Resources#empty?` handles Hash, Array, Cos::Dictionary,
+  PdfArray.
+
+### Changed
+
+* Release workflow switched to emf2svg-ruby pattern: direct OIDC
+  trusted publishing via `rubygems/configure-rubygems-credentials@main`
+  + plain `gem push`. Bump job commits version.rb and tags `vX.Y.Z`.
+* Removed all `instance_variable_set/get`, `send` to private
+  methods, `respond_to?` for type checks.
+
+## [0.7.0] — 2026-08-08
+
+### Added — Release infrastructure
+
+* `.github/workflows/rake.yml` — Metanorma CI generic-rake workflow
+  for tests on every push, PR, tag, and dispatch.
+* `.github/workflows/release.yml` — Metanorma CI rubygems-release
+  workflow driven by `workflow_dispatch` with `next_version` input
+  or `repository_dispatch` of type `do-release`.
+* `RELEASE.md` — documents the publish flow and required secrets.
+
+### Added — Image subsystem
+
+* `Pdfrb::Image::Audit` — read-only metadata extractor (ImageInfo
+  struct per image XObject) with `each_image`, `all`, `oversized`
+  helpers.
+* `Pdfrb::Image::Downsampler` — pure-Ruby nearest-neighbour for
+  FlateDecode-encoded 8-bpc non-palette images. PNG predictor
+  round-trip on both decode and encode. JPEG/JP2K skipped (no
+  native deps).
+* `Pdfrb::Task::Optimize#downsample_images!(factor:)` — applies the
+  downsampler across every image XObject in the document.
+
+### Added — Layout bidi
+
+* `Pdfrb::Layout::Bidi` — paragraph-level UAX #9 bidi reordering
+  (P2-P3 paragraph level, BD1 type classification, I1/I2 implicit
+  levels, L2 reverse by level, L4 paired-bracket mirroring).
+* `Pdfrb::Layout::TextLayouter#layout` calls `Bidi.reorder` before
+  line breaking, so Hebrew and Arabic render in visual order.
+
+### Fixed
+
+* Issue #63: `Document::Fonts#add` now extracts the PostScript name
+  (name table nameID 6) and uses it in `/BaseFont` (e.g.
+  `ABCDEF+MinionPro-Regular` instead of `ABCDEF+EmbeddedFont3132`).
+* Issue #64: `Model::Type::Resources#empty?` handles Hash, Array,
+  Cos::Dictionary, and PdfArray values via a single
+  `empty_collection?` helper.
+
+### Changed
+
+* `Pdfrb::Task::Optimize.dedup_streams!` now actually rewrites
+  references to duplicate streams (was a stub).
+* `Pdfrb::Writer#write_xref_stream` emits a free entry for every
+  gap in the oid space, so dedup'd oids don't misalign the reader's
+  per-oid index.
+* `Pdfrb::Document::Form#flatten!` stamps each field's `/AP /N`
+  appearance stream into the page content via the `/Do` operator
+  (was a stubbed no-op).
+
 ## [0.3.0] — 2026-08-02
 
 ### Added — Semantic PDF diff

data/RELEASE.md

@@ -1,48 +1,67 @@
 # Releasing pdfrb
 
-Releases are driven by git tags. The release workflow is at
-`.github/workflows/release.yml` and runs on tag push (or manual dispatch
-for an existing tag).
+Releases are driven by the Metanorma CI reusable workflow at
+`.github/workflows/release.yml`. It supports two triggers:
 
-## Publish flow
+1. **`workflow_dispatch`** with a `next_version` input — manual run
+   from the Actions UI. Accepted values: `x.y.z`, `major`, `minor`,
+   `patch`, `pre|rc|etc`, or `skip` (release the current gemspec
+   version as-is).
+2. **`repository_dispatch`** with event type `do-release` — for
+   automation triggers from other repos.
 
-1. Ensure `lib/pdfrb/version.rb` has the target version.
-2. Merge the version-bump change via a PR (never commit directly to main).
-3. When the PR lands, tag the merged commit:
+Both call
+[`metanorma/ci/.github/workflows/rubygems-release.yml@main`](https://github.com/metanorma/ci/blob/main/.github/workflows/rubygems-release.yml),
+which handles version bumping, tag creation, gem build, RubyGems
+publish, and GitHub release creation.
 
-   ```sh
-   git tag v$(ruby -Ilib -e 'require "pdfrb/version"; print Pdfrb::VERSION')
-   git push origin v<VERSION>
-   ```
+## Authentication
 
-4. The `Release` workflow fires automatically:
-   - Verifies tag ↔ `lib/pdfrb/version.rb` match.
-   - Builds the gem (`bundle exec rake build`).
-   - Publishes to RubyGems via OIDC trusted publishing (no stored API key).
-   - Creates a GitHub release with auto-generated notes.
+The reusable workflow uses the `CLARICLE_CI_RUBYGEMS_API_KEY` secret
+for RubyGems authentication. Ensure this secret is set in repo
+Settings → Secrets and Variables → Actions.
 
-## Trusted publishing (OIDC)
+The `GITHUB_TOKEN` is passed as `pat_token` for the version-bump
+commit/tag/push steps.
 
-The workflow uses `rubygems/configure-rubygems-credentials` with OIDC.
-To enable, on RubyGems:
+## Triggering a release
 
-1. Open the `pdfrb` gem settings.
-2. Add the GitHub workflow as a trusted publisher:
-   - Repository: `claricle/pdfrb`
-   - Workflow filename: `release.yml`
-   - Environment: (leave blank)
+### From the Actions UI
 
-Until that is configured, the `Publish to RubyGems` step will fail.
+1. Go to Actions → `release` workflow.
+2. Click "Run workflow".
+3. Enter the next version (e.g., `0.8.0`, `patch`, `minor`, `major`).
+4. Click "Run workflow".
 
-## Manual dispatch
+### From the API / CI
 
-The workflow accepts a `tag` input. Run it from the Actions UI on a
-previously-pushed tag if the auto-trigger missed (e.g., the workflow
-file was added after the tag was pushed).
+```sh
+gh workflow run release.yml \
+  -f next_version=0.8.0
+```
+
+Or via `repository_dispatch` from another repo:
+
+```sh
+gh api /repos/claricle/pdfrb/dispatches \
+  -f event_type=do-release \
+  -f 'client_payload[next_version]=0.8.0'
+```
+
+## CI (test) workflow
+
+`.github/workflows/rake.yml` runs the standard Metanorma CI
+generic-rake workflow on every push to `main`/`master`, every tag
+push, every pull request, and via manual `workflow_dispatch`.
+
+`.github/workflows/ci.yml` (the original hand-rolled CI) is also
+present as a fallback.
 
 ## Pre-release checklist
 
-- `bundle exec rake` is green.
-- `lib/pdfrb/version.rb` matches the intended tag.
-- `CHANGELOG.md` has an entry for the new version.
-- No uncommitted changes on `main`.
+* `bundle exec rake` is green locally.
+* `lib/pdfrb/version.rb` matches the intended release (the release
+  workflow handles this automatically when given `next_version`).
+* `CHANGELOG.md` has an entry for the new version.
+* No uncommitted changes on `main`.
+* `CLARICLE_CI_RUBYGEMS_API_KEY` secret is set in repo settings.