carve-hexapdf 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45c5c94de95a03c35c6a7ea92a22aff7fec66c96ff2a5dc44cb36a43034426d8
-  data.tar.gz: 0e3560d71885dd7476d999ab910a2ea0ba9b111c7dccb678979c238e26e9d63c
+  metadata.gz: 20e7254d5697ad9d0e7b04769f516ce56b892d09c5407fe6b6cbd3e1ed8eed7e
+  data.tar.gz: 24af38395418395895e2eb639d8f6dd1e8ce3827135e532338fd670df2b8befb
 SHA512:
-  metadata.gz: 45f2c67a07e0036a07d862bb7cd42641bfae6a8123b668ab6b910bd67dd54a78d49f4dbe0e83a8f8f25e432207391c0b9377e13d9abf1c2f56eee95b5cf151b8
-  data.tar.gz: b18adba4f2de1b2d2678baa7adb7ac15ce5d8d581b7ca561e186e3c2b33c0bf387b2ba58b6a336669cf33642772cbdd1cbadb06142567a5a827e53f0908f02f6
+  metadata.gz: 813e1c949beb5f2047b406fa06bc1580da7e5e163d6f67b95e15ca17d06fbc037585b8435f49e60c14cfba117f74d17d5184deeb5be7f6b023071759fd2b48eb
+  data.tar.gz: 7616495f87f40f73f2edbb423fea6c7d43b9443f930cb8372542225c682383913455879045f5ed7e5fc25bf0317e4a7976f77b8c39afe9ba4e9422c937f7703d

data/CHANGELOG.md

@@ -5,6 +5,42 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [0.1.3] - 2026-10-08
+
+### Fixed
+
+- **A referenced footnote's body no longer vanishes from the page.**
+  `register_footnote` matched a reference to its definition through
+  `footnote_ref[:id]`; the engine renamed that field to `label`, so no
+  definition resolved and the note text never reached the endnote section. The
+  marker still numbered itself, so a page kept `[2]` and silently lost what it
+  pointed at. Both spellings are accepted now.
+  markup-carve/carve-hexapdf#47
+- **Cross-references reach the page.** The inline dispatcher had an arm for
+  `cross_ref` while the engine publishes `heading_ref`, so every `</#id>`
+  contributed nothing at all: `See </#Plan>.` drew `See .`. A resolved
+  reference is drawn as a link over the target heading's text, an unresolved
+  one back in its `</#id>` source spelling, which is how the HTML target
+  renders it. markup-carve/carve-hexapdf#48
+- **The example PDFs match the engine the gemspec supports.** They had been
+  generated by carve-lang 0.1.0, the version the floor excludes, and
+  `examples/generate.rb` would silently use a `carve-rb` checkout that merely
+  happened to sit beside this one. The sibling is opt-in through
+  `CARVE_RB_PATH` now, the same variable the `Gemfile` reads.
+  markup-carve/carve-hexapdf#49
+
+### Changed
+
+- Requires carve-rb v0.1.7 (carve-lang 0.1.7), up from an unreleased revision
+  32 commits and two releases behind it. A document containing a single `|`
+  followed by an attribute block used to abort the native extension with a
+  fatal `byte range starts at 1 but ends at 0`, killing the process rather than
+  raising, so a batch render died on five bytes of valid input; it now renders
+  as paragraph text. Cross-references, glossary terms and numbered captions
+  also compare case exactly on this engine.
+
 ## [0.1.2] - 2026-09-19
 
 ### Fixed

data/lib/carve/hexapdf/renderer.rb

@@ -564,7 +564,23 @@ module Carve
           out << run("[#{number}]", ctx.merge(super: true)) if number
         when "citation_group" then out << run(node[:raw].to_s, ctx)
         when "abbreviation"   then out << run(node[:abbr].to_s, ctx)
-        when "cross_ref"      then out << run(node[:target].to_s, ctx)
+        # `heading_ref` is what `</#id>` publishes; `cross_ref` was its name
+        # before the rename and is still accepted, like the footnote arm above.
+        # Reading only `cross_ref` dropped every cross-reference from the page
+        # with no marker left behind: `See </#Plan>.` drew "See .".
+        #
+        # A resolved reference carries `href` and a `target` that is the target
+        # heading's TEXT, so it draws as a link over that text. An unresolved
+        # one carries no `href` and a `target` that is the selector as authored,
+        # which the HTML target renders as literal source - so it is drawn back
+        # in its source spelling rather than as a bare word that reads like
+        # prose.
+        when "heading_ref", "cross_ref"
+          if node[:href].to_s.empty?
+            out << run("</##{node[:target]}>", ctx)
+          else
+            out << run(node[:target].to_s, ctx.merge(link: node[:href].to_s))
+          end
         when "caption_number" then (out << run(node[:number].to_s, ctx) if node[:number])
         when "insert" then emit_children(node, ctx.merge(underline: true), out)
         when "delete" then emit_children(node, ctx.merge(strike: true), out)
@@ -767,7 +783,12 @@ module Carve
           return @footnotes.last[:number]
         end
 
-        id = node[:id]
+        # `label` since carve-rb 0.1.4; `id` is the pre-rename spelling and is
+        # still accepted, the same way the node-type arms above accept both
+        # vocabularies. Reading only `id` silently dropped the body: the marker
+        # still numbered itself from `node[:number]`, so the page kept `[2]`
+        # and lost "2. Referenced note body." entirely.
+        id = node[:label] || node[:id]
         if id && @footnote_defs.key?(id)
           return @footnote_numbers[id] ||= begin
             @footnotes << { number: @footnotes.size + 1, blocks: @footnote_defs[id] }

data/lib/carve/hexapdf/version.rb

@@ -2,6 +2,6 @@
 
 module Carve
   module Hexapdf
-    VERSION = "0.1.2"
+    VERSION = "0.1.3"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: carve-hexapdf
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - markup-carve
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-20 00:00:00.000000000 Z
+date: 2026-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: carve-lang