leptris 1.9.51 → 1.9.52

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aab0b795d90effa39a4670c8359fc2808267a48e7d93c7c1c314c3dfebb415f0
-  data.tar.gz: 52bc50c5d171632e1a45b787d22bb9a94763d1f1df885e8c8197867cb4fc6673
+  metadata.gz: ce439698a32a7737054564af4f25866e9d49b87a86f30dee916e6d04f53e8249
+  data.tar.gz: 947ef61ce70fd53664851fe073d7504b1a2c28a59591e2b7c04ea482bcbed605
 SHA512:
-  metadata.gz: 0efb45ab3367594bc1781d5d88a9a9db7f2d14af84b73b844cc9a8f08ad81eed03f6bd70a14d04d21240f8fdd592dc4a725c706f5277c10536ab0189333db6eb
-  data.tar.gz: 33150488d60668fe10d62c6f00ab4129abb37816d5a940238b97283113f7cf04c4158a2b8d41e6fd8c73610242484a96bd92f35540033c7407d76cefdf1bd9d8
+  metadata.gz: c56ca957ac03806e595f8702cf4936b5303bf51761196d9b3bc9fb2aa84fb1023becb48520e59e8ec09defc5e482e8db929ecab787fc8925754ac182eaa7a2b2
+  data.tar.gz: 04b5685bb317af87788e52425b8b8f66b2e9b77f1d5488f65354b6631285695be22a746b6536024f4b5172d63765b6ea196d4a2de74f627e86cccf6f92365967

data/CHANGELOG.md

@@ -5,6 +5,48 @@ All notable changes to Leptris will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.9.52] - 2026-09-02
+
+### Changed
+
+- **Lockstep with libleptris 1.9.43** (1.9.37 → 1.9.43; no new C
+  surface — the audit holds at 255/255 attached == exported):
+  - 1.9.37: tunnel parameters (§11.7) — `xsl:with-param
+    tunnel="yes"` persists for the whole subtree, including the
+    built-in unmatched-node path. This work also fixed the
+    `shallow-skip`/`text-only-copy` subtree drop (leptris/leptris#705).
+  - 1.9.38: regex trio atomizes node arguments (#691); single-item
+    atomic `xsl:sequence` serializes (#685 remainder); #705 verified
+    against a live Saxon-HE 12.7 oracle — all four reported shapes
+    pinned, with the correction that the no-template case emits
+    EMPTY for both dispositions (the report's `312` expectation
+    contradicted Saxon).
+  - 1.9.39: `leptris_element_copy` keeps COMMENT and PI children
+    (leptris/leptris#696) — pinned with a C-level spec.
+  - 1.9.40: fn: date slice (#691-E) — `xs:date`/`xs:dateTime`/
+    `xs:time`/`xs:duration` constructors and component extractors.
+  - 1.9.41: `switch` rejected like Saxon (XPST0003 pattern-only);
+    the #692 brace guard now runs the compiler first — map
+    constructors and `try/catch` raise cleanly in XPath expression
+    context instead of returning empty silently.
+  - 1.9.42: `xsl:where-populated`, `xsl:on-non-empty`,
+    `xsl:next-match` (#690/#685).
+  - 1.9.43: `xsl:fork`, `xsl:number @start-at`, composite keys
+    (#690/#685).
+  - Nine new specs cover the above through the generic
+    `XSLT.parse/apply_to` face; the two pending #705 disposition
+    specs are un-pending with the Saxon-verified expectations.
+
+### Fixed
+
+- **`dup` keeps the serialization round-trip** (leptris/leptris#721,
+  filed this round): with #696 fixed upstream, the C copy now
+  keeps comment/PI children — but it drops namespace prefixes and
+  declarations outright (`leptris_element_namespace` resolves NULL
+  after a copy), while the round-trip preserves them byte-for-byte.
+  The dup sites' comments now carry the #721 rationale; the revert
+  to the C fast path waits on #721.
+
 ## [1.9.51] - 2026-09-01
 
 ### Changed

data/README.adoc

@@ -9,7 +9,9 @@ A Nokogiri-compatible Ruby binding for
 https://github.com/leptris/leptris[libleptris], a pure-C99 XML 1.0 parser
 with full https://www.w3.org/TR/1999/REC-xpath-19991116/[XPath 1.0],
 XML Namespaces 1.0, SAX, and C14N (1.0 / 1.1 / Exclusive), plus
-XSLT 1.0–3.0 transforms (the XPath 3.1 core rides inside them).
+XSLT 1.0–3.0 transforms (the XPath 3.1 core rides inside them) and a
+growing XPath 2/3.1 expression subset available standalone from
+`#xpath` itself.
 
 The C DOM is the single source of truth — Ruby objects are thin FFI
 handles over the C pointers, so every Ruby method maps to one FFI call.
@@ -225,6 +227,30 @@ XPath result type follows XPath 1.0 semantics:
 `count(...)` → `Float`, `boolean(...)` → `true`/`false`,
 `string(...)` → `String`, otherwise a `Leptris::XML::NodeSet`.
 
+Beyond XPath 1.0, the engine accepts a growing XPath 2/3.1
+expression subset standalone — no stylesheet required:
+
+[source,ruby]
+----
+doc.xpath("let $n := count(//book) return $n + 1")   # => 3.0
+doc.xpath("for $b in //book return count($b/*)")     # sequence
+doc.xpath("if (count(//book) = 2) then 'two' else '?'")
+doc.xpath("count(1 to 4)")                           # => 4.0
+doc.xpath("//book => count()")                       # 3.1 arrow
+doc.xpath("//title ! string(.)")                     # 3.1 simple map
+doc.xpath("'v' || count(//book)")                    # 3.1 concat
+----
+
+Two caveats: `for … return` sequences come back as opaque result
+nodes — consume them through an aggregate (`count(...)`,
+`string-join(...)`) until the engine materializes readable sequence
+items; and XQuery-only syntax (`order by`, `try/catch`, map
+constructors) raises `XPathError` rather than evaluating silently
+wrong. The remaining grammar gaps — value comparators (`eq`),
+quantifiers, sequence types (`instance of`), `intersect`/`except`,
+string templates — and XQuery itself are
+https://github.com/leptris/leptris/issues/683[tracked upstream].
+
 === Supported CSS selectors
 
 Minimal subset (translated to XPath via `Leptris::XML::CssToXPath`):
@@ -339,11 +365,20 @@ result = style.apply_to(doc)                       # => Document
 style.serialize(doc)                               # => String
 ----
 
-The engine dispatches on the stylesheet's declared version; the 3.0
-instruction set (grouping, `xsl:accumulator`, `xsl:analyze-string`,
-the XPath 3.1 core) is available inside transforms. Standalone
-XPath 2.0/3.1 evaluation entries and XQuery are
-https://github.com/leptris/leptris/issues/683[tracked upstream].
+The engine dispatches on the stylesheet's declared version. XSLT
+1.0 is complete; the 3.0 instruction set has grown through
+libleptris 1.9.36 — grouping, `xsl:accumulator`,
+`xsl:analyze-string`, `xsl:mode/@on-no-match` dispositions,
+`xsl:sequence`, `xsl:perform-sort`, and `fn:format-integer` — with
+the XPath 3.1 core expressions available inside transforms (see
+the subset list under <<Searching: XPath and CSS>>; value
+comparators and sequence types are still out,
+https://github.com/leptris/leptris/issues/683[tracked upstream]).
+Known engine bug: the `shallow-skip` and `text-only-copy`
+dispositions drop unmatched subtrees in the built-in initial
+descent (https://github.com/leptris/leptris/issues/705[#705]) —
+the other four dispositions are spec-correct. XQuery has no
+entry point yet.
 `Document#save(path, **opts)` :: serialize to a file.
 `Document#canonicalize(version, inclusive_ns, with_comments:, exclusive:, mode:)` (alias `#c14n`) :: canonical XML.
 `Element#canonicalize(...)` :: subtree canonicalization.
@@ -510,7 +545,8 @@ Notable differences:
   past Document disposal will see the error; silence-replace-UAF patterns
   from Nokogiri do not apply.
 * No `Nokogiri::HTML` or `Nokogiri::CSS` parser. Leptris is XML-only.
-* No XSLT, no RelaxNG / DTD validation, no schema caching.
+* No XQuery, no RelaxNG / DTD validation, no schema caching
+  (XSLT 1.0–3.0 is supported — see above).
 * No built-in JRuby / TruffleRuby support — only CRuby via `ffi`.
 
 == Performance

data/Rakefile

@@ -8,7 +8,7 @@ RSpec::Core::RakeTask.new(:spec)
 # Pin for `rake compile` and the platform-gem builds. Keep in lockstep
 # with .github/workflows/build.yml (which calls `rake compile`) and the
 # CHANGELOG when libleptris releases.
-LIBLEPTRIS_VERSION = "1.9.36"
+LIBLEPTRIS_VERSION = "1.9.43"
 
 CMAKE_FLAGS = %w[
   -DCMAKE_BUILD_TYPE=Release

data/lib/leptris/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Leptris
-  VERSION = "1.9.51"
+  VERSION = "1.9.52"
 end

data/lib/leptris/xml/element.rb

@@ -252,10 +252,11 @@ class Leptris::XML::Element < Leptris::XML::Node
   end
 
   # Deep copy in a NEW document, via serialization round-trip:
-  # leptris_element_copy silently drops COMMENT and PI children
-  # (leptris/leptris#696, leptris-ruby#115) — the serializer
-  # preserves every child kind, prefixed names, and namespace
-  # declarations, and re-parsing rebuilds them all.
+  # leptris_element_copy drops namespace prefixes and declarations
+  # outright (leptris/leptris#721; its comment/PI child drop was
+  # #696, fixed upstream in 1.9.39) — the serializer preserves
+  # every child kind, prefixed names, and namespace declarations,
+  # and re-parsing rebuilds them all.
   def dup
     ensure_alive!
     Leptris::XML::Document.parse(to_xml).root

data/lib/leptris/xml/node.rb

@@ -370,10 +370,11 @@ class Leptris::XML::Node
   end
 
   # Deep copy in a NEW document. Rounds through serialization
-  # rather than leptris_element_copy: the C copy silently drops
-  # COMMENT and PI children (leptris/leptris#696, leptris-ruby#115)
-  # — the serializer preserves every child kind, prefixed names,
-  # and namespace declarations, and re-parsing rebuilds them all.
+  # rather than leptris_element_copy: the C copy drops namespace
+  # prefixes and declarations outright (leptris/leptris#721; the
+  # comment/PI child drop was #696, fixed upstream in 1.9.39) —
+  # the serializer preserves every child kind, prefixed names, and
+  # namespace declarations, and re-parsing rebuilds them all.
   def dup
     ensure_alive!
     elem_ptr = Leptris::XML::FFI.leptris_node_as_element(@c_ptr)

data/lib/leptris/xml/serialization.rb

@@ -98,11 +98,10 @@ module Leptris::XML::Serialization
   # Element-face indent unit (leptris-ruby#109 residual 2): no
   # element-level ext-serialize entry exists yet, so the unit path
   # rounds the subtree through serialization into a fresh document
-  # (leptris_element_copy drops COMMENT/PI children —
-  # leptris/leptris#696, leptris-ruby#115) and serializes that
-  # document without a declaration — identical output to the
-  # element serializer for the standard layout, with the unit and
-  # every child kind intact.
+  # (leptris_element_copy drops namespaces — leptris/leptris#721)
+  # and serializes that document without a declaration — identical
+  # output to the element serializer for the standard layout, with
+  # the unit and every child kind intact.
   def self.to_xml_element_unit(element, unit, indent: 0)
     document = Leptris::XML::Document.parse(element.to_xml)
     begin

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.51
+  version: 1.9.52
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-01 00:00:00.000000000 Z
+date: 2026-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi