pdfrb 0.6.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f24b6c90eb4e01436139908a7aaa0472ed8a22704e40e934f651c0265763d62
-  data.tar.gz: da4e7fc8a4f9c4cecbbf22ca2ab2288ca8f07c4bc974dc6eac8b2166fb784d94
+  metadata.gz: 14c300c425848b557b210be218c07de40adbb5188e0c36c15d7d72336395d7c9
+  data.tar.gz: 672e663a9efe0991f97aceda226a1fa909ef804d8dd2a94e1cb7f2df4d1cd1c8
 SHA512:
-  metadata.gz: 550b8e52600d4ebe1cffbce341d0725d750a41ba8585c1b85c827f9c7a4b6fda7e24d6dd6f3c2ed6f5f83e442729e792f3fef05a9d34459118a9720d039bf3bb
-  data.tar.gz: c950a24d0cf3af6734edbe2819d0390c07442fa941e026be4744fb6db0e02beadc4e3d2ac220fbb5d4f52eee67bc3e9d19e03602dabaaefdf65929ecbe1a61d3
+  metadata.gz: 18c8b3c2c2a15a4fd6dff6f8d58c4403e2e23067f9ad8c655e4a8fe5d43678d748f8d0378eddfc92c9d98f118b710887c0bf95374756088f4885461373d1e30c
+  data.tar.gz: cfcbe27e32085ad4a9e753645a8e56571630c230f69aae6f289c7d618bc23bba98b49830be6e01a5317de922f78faba5ec3b1d106436dd75cf600872ab5e75e1

data/CHANGELOG.md

@@ -2,6 +2,57 @@
 
 All notable changes to the pdfrb gem will be documented in this file.
 
+## [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,61 @@
 # 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`, or `pre|rc|etc` to bump to a prerelease.
+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>
-   ```
+## Required secrets
 
-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.
+* `CLARICLE_CI_RUBYGEMS_API_KEY` — RubyGems API key with `push`
+  permission on the `pdfrb` gem. Set in repo Settings → Secrets and
+  Variables → Actions.
+* `GITHUB_TOKEN` — automatic; used for creating the GitHub release.
 
-## Trusted publishing (OIDC)
+## Triggering a release
 
-The workflow uses `rubygems/configure-rubygems-credentials` with OIDC.
-To enable, on RubyGems:
+### From the Actions UI
 
-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)
+1. Go to Actions → `release` workflow.
+2. Click "Run workflow".
+3. Enter the next version (e.g., `0.7.0`, `patch`, `minor`, `major`).
+4. Click "Run workflow".
 
-Until that is configured, the `Publish to RubyGems` step will fail.
+### From the API / CI
 
-## Manual dispatch
+```sh
+gh workflow run release.yml \
+  -f next_version=0.7.0
+```
 
-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).
+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.7.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`. It
+fires the test matrix across supported Ruby versions.
 
 ## 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`.