leptris 1.9.156.0 → 1.9.160.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd58b08303252f035517604c63e63c1db6583e84fb622c03026ea259fbbd0baa
-  data.tar.gz: 9ebde3d10256cb54d4b091257d7cc08236c10448e8b2427251c855360bd2a1e4
+  metadata.gz: 2644772a66a1e58e517fe5b5e2b2fb417ac1592863f3de375d1659ecebfeaec6
+  data.tar.gz: ee478cc9f2387ff6527a680c37817d1c650bfe50c0e9c891768784db396cc29c
 SHA512:
-  metadata.gz: ff02784b8881a170661ecfb091bc38a1c0d61cff7034b01aecef96a2773da963c2482d09d289978fc0d7c18e7a481417f82dd3d026afc0cfa41c79ef8eb2f0fd
-  data.tar.gz: c5f9ef06098af10c1b0b63b6e878b58142f814f5f111dd697080d02591839cef3cd95ff4c6168493c498ac05c3f885a3eb85341e9819b8a2bdb15e1a4e5f5212
+  metadata.gz: 7e6dfa835f5704689bf7fa50bfac557bf4637b556b9f84f6ae437cf020bafe09cb42c866692d159da8f11ed0a8bad9439d13639f4c6380159d9d0c2a75600d42
+  data.tar.gz: 33558c5c76bbc5130b52e4d4d2258f4918e9c101e18494772d29a55ad758ab089b98753d9ca6cea9cd0ca7ae09107d952c701d6dcdcbdb7557a0c3b13ea7e067

data/CHANGELOG.md

@@ -5,6 +5,85 @@ 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.160.0] - 2026-09-14
+
+### Changed
+
+- **Lockstep with libleptris 1.9.160** (1.9.156 → 1.9.160; audit
+  290 → 291): the lane-18 engine performance arc — one TLS read
+  per document resolution (under nearly every API call; 1.9.158),
+  inline tree-edge encoding and register promotion in the parse
+  loop, inline int32 edge codecs, document-free back to
+  O(this document) (1.9.159), split_qname colon gate, shared edge
+  tables for parent reads, name carve, one-strlen attribute find
+  (1.9.160).
+- **`Document#add_comment(content)`** (libleptris 1.9.160, #1032):
+  the document-level comment writer (epilog append, the #add_pi
+  twin) — parsed document-level comments round-tripped since
+  1.9.3; this closes the creation gap.
+- Fixed a duplicate `leptris_element_create_child` attachment
+  left by the stacked 1.9.156 lockstep commits (audit silently
+  deduplicated; now clean at 291/291).
+\n## [1.9.156.2] - 2026-09-13
+
+### Added
+
+- **#183: XPath version selection** (mirroring leptris-py#105):
+  `xpath`/`at_xpath` take a trailing `version:` selector —
+  `doc.xpath("count(//b)", version: "1.0")` evaluates through the
+  strict 1.0 engine lane (3.x syntax raises), `"3.1"` the full
+  grammar; `XPath.compile(expr, version:)` pins compiled
+  expressions the same way. Carried positionally — a declared
+  keyword is impossible without breaking the namespace-binding
+  hash channel (Ruby converts a trailing String-keyed hash into
+  keywords the moment one exists), so a `:version` key whose
+  VALUE is a version selector ("1.0"/"3.1"/:xpath10/:xpath31)
+  selects the channel; dotted-number values raise at the boundary
+  with the valid values; any other value stays a prefix binding
+  (a prefix literally named "version" keeps working). `version:`
+  combined with namespace bindings raises (the versioned engine
+  entry takes no ns set yet), as does `version:` on css. The nil
+  default keeps the existing eval path verbatim.
+\n## [1.9.156.1] - 2026-09-13
+
+### Added
+
+- **`Element#create_child(name)`** — the fused create+append
+  (libleptris 1.9.153 `leptris_element_create_child`, audit 290)
+  landed on main seconds after the 1.9.156.0 platform gems were
+  built and published, so that release ships without the binding
+  face. This patch release carries it: one C call, tree semantics
+  identical to `create_element` + `add_child`, the builder-shape
+  single call.
+
+## [1.9.156.0] - 2026-09-13
+
+### Security/correctness
+
+- **Lockstep with libleptris 1.9.156 (1.9.152 → 1.9.156)** — carries
+  the **#1038 heap-corruption fix** (engine regression window:
+  libleptris 1.9.151–1.9.155; root-doc map entries outlived their
+  document and wrote through freed pools — roaming crashes in
+  downstream binding suites at ~5% of runs). The two gem versions
+  that embedded the affected engine, **1.9.152.0 and 1.9.152.1,
+  are YANKED**; upgrade to 1.9.156.0.
+
+### Added
+
+- **`Element#create_child(name)`** (libleptris 1.9.153): the fused
+  create+append — one document resolution, one C call, tree
+  semantics identical to `create_element` + `add_child`; the
+  builder-shape single call.
+
+### Changed
+
+- Engine: WHATWG template-mode gaps closed (1.9.154/1.9.155):
+  frame/frameset drops inside templates, in-column-group token
+  gating, `</template>` inside `<select>`, foreign-content
+  template end-tag matching — html5lib corpus 1197 → 1206;
+  Nokogiri parity floor held. Audit 289 → 290
+  (leptris_element_create_child).
+
 ## [1.9.152.1] - 2026-09-13
 
 ### Fixed

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.156"
+LIBLEPTRIS_VERSION = "1.9.160"
 # Vendored alongside libleptris for fn:normalize-unicode (TODO
 # .restructure/20): built per platform with a RELOCATABLE @rpath
 # install name, loaded by ffi.rb before libleptris so the

data/lib/leptris/version.rb

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

data/lib/leptris/xml/document.rb

@@ -416,6 +416,19 @@ class Leptris::XML::Document
     self
   end
 
+  # Append a document-level comment (epilog position, after the
+  # root element) — the add_pi twin (libleptris 1.9.160, #1032;
+  # parsed document-level comments round-tripped since 1.9.3/#578,
+  # this is the writer). Returns self.
+  def add_comment(content)
+    witness = Leptris::XML::FFI.leptris_document_add_comment(
+      @c_ptr, content.to_s)
+    raise Leptris::XML::Error,
+      "leptris_document_add_comment failed" if witness.null?
+    @version += 1
+    self
+  end
+
   # Marks the document read-only: tree mutations raise
   # Leptris::XML::ReadOnlyError, and read paths memoize aggressively
   # (names, content, children, attributes) since they can never go

data/lib/leptris/xml/element.rb

@@ -331,6 +331,19 @@ class Leptris::XML::Element < Leptris::XML::Node
   end
   alias_method :clone, :dup
 
+  # Fused create+append (libleptris 1.9.153): builds a child
+  # element of +name+ in this element's document and attaches it
+  # in ONE C call — the builder-shape single call
+  # (leptris_element_create_child). Tree semantics identical to
+  # document.create_element(name) + add_child.
+  def create_child(name)
+    ensure_writable!
+    ptr = Leptris::XML::FFI.leptris_element_create_child(@c_ptr, name.to_s)
+    raise Leptris::XML::Error,
+      "leptris_element_create_child failed for #{name.inspect}" if ptr.null?
+    Leptris::XML::Node.wrap_fresh(ptr, @document, Leptris::XML::FFI::NODE_ELEMENT)
+  end
+
   def add_child(node_or_markup)
     ensure_writable!
     case node_or_markup

data/lib/leptris/xml/ffi.rb

@@ -220,6 +220,10 @@ attach_function :leptris_parse_string,
         [:leptris_document, :string, :size_t], :leptris_node_ref
       attach_function :leptris_document_add_pi,
         [:leptris_document, :string, :string], :pointer
+      # Document-level comment writer (libleptris 1.9.160, #1032):
+      # epilog append, the add_pi shape.
+      attach_function :leptris_document_add_comment,
+        [:leptris_document, :string], :leptris_node_ref
       # Document-level comments (libleptris 1.9.3, #578): parsed
       # <!-- ... --> outside the root, prolog then epilog, in
       # document order. Read-only surface (no add_comment yet).
@@ -435,8 +439,6 @@ attach_function :leptris_parse_string,
 
       attach_function :leptris_element_create,
         [:leptris_document, :string], :leptris_element
-      attach_function :leptris_element_create_child,
-        [:leptris_element, :string], :leptris_element
       attach_function :leptris_element_set_name,
         [:leptris_element, :string], :leptris_status
       attach_function :leptris_element_set_text,
@@ -457,6 +459,10 @@ attach_function :leptris_parse_string,
         [:leptris_element, :string], :leptris_status
       attach_function :leptris_element_append_child,
         [:leptris_element, :leptris_element], :leptris_status
+      # Fused create+append (libleptris 1.9.153): one document
+      # resolution, identical tree semantics to the two-call pair.
+      attach_function :leptris_element_create_child,
+        [:leptris_element, :string], :leptris_element
       attach_function :leptris_element_prepend_child,
         [:leptris_element, :leptris_element], :leptris_status
       attach_function :leptris_element_insert_before,

data/lib/leptris/xml/searchable.rb

@@ -1,8 +1,12 @@
 # frozen_string_literal: true
 
 module Leptris::XML::Searchable
+  # Values that make a :version key the version channel (#183,
+  # mirroring leptris-py#105); anything else is a namespace prefix.
+  VERSION_SELECTORS = ["1.0", "3.1", :xpath10, :xpath31].freeze
+
   def xpath(*paths)
-    handler, ns, _vars = parse_search_args(paths)
+    handler, ns, version = parse_search_args(paths)
     raise ArgumentError, "custom XPath handlers not supported" if handler
     expr = paths.join(" | ")
 
@@ -10,7 +14,16 @@ module Leptris::XML::Searchable
     context_ptr = is_a?(Leptris::XML::Document) ? nil : c_ptr
 
     result_ptr =
-      if ns && !ns.empty?
+      if version
+        if ns && !ns.empty?
+          raise ArgumentError,
+            "version: cannot be combined with namespace bindings " \
+            "(the versioned engine entry takes no ns set yet)"
+        end
+        Leptris::XML::FFI.leptris_xpath_eval_versioned(
+          doc_ptr, context_ptr, expr,
+          Leptris::XML::Searchable.xpath_version_code(version), nil)
+      elsif ns && !ns.empty?
         xpath_eval_with_namespaces(doc_ptr, context_ptr, expr, ns)
       else
         Leptris::XML::FFI.leptris_xpath_eval(doc_ptr, context_ptr, expr)
@@ -24,7 +37,7 @@ module Leptris::XML::Searchable
   end
 
   def at_xpath(*paths)
-    handler, ns, _vars = parse_search_args(paths)
+    handler, ns, version = parse_search_args(paths)
     raise ArgumentError, "custom XPath handlers not supported" if handler
     expr = paths.join(" | ")
 
@@ -32,7 +45,16 @@ module Leptris::XML::Searchable
     context_ptr = is_a?(Leptris::XML::Document) ? nil : c_ptr
 
     result_ptr =
-      if ns && !ns.empty?
+      if version
+        if ns && !ns.empty?
+          raise ArgumentError,
+            "version: cannot be combined with namespace bindings " \
+            "(the versioned engine entry takes no ns set yet)"
+        end
+        Leptris::XML::FFI.leptris_xpath_eval_versioned(
+          doc_ptr, context_ptr, expr,
+          Leptris::XML::Searchable.xpath_version_code(version), nil)
+      elsif ns && !ns.empty?
         xpath_eval_with_namespaces(doc_ptr, context_ptr, expr, ns)
       else
         Leptris::XML::FFI.leptris_xpath_eval(doc_ptr, context_ptr, expr)
@@ -64,8 +86,9 @@ module Leptris::XML::Searchable
   alias_method :%, :at
 
   def css(*args)
-    handler, ns, _ = parse_search_args(args)
+    handler, ns, version = parse_search_args(args)
     raise ArgumentError, "namespace bindings not supported in css" if ns && !ns.empty?
+    raise ArgumentError, "version: is XPath-only" if version
     raise ArgumentError, "custom CSS handlers not supported" if handler
     # Nokogiri semantics: css is receiver-relative — absolute "//"
     # from a Document, descendant ".//" from elements and fragments.
@@ -76,8 +99,9 @@ module Leptris::XML::Searchable
   end
 
   def at_css(*args)
-    handler, ns, _ = parse_search_args(args)
+    handler, ns, version = parse_search_args(args)
     raise ArgumentError, "namespace bindings not supported in css" if ns && !ns.empty?
+    raise ArgumentError, "version: is XPath-only" if version
     raise ArgumentError, "custom CSS handlers not supported" if handler
     prefix = is_a?(Leptris::XML::Document) ? "//" : ".//"
     expr = args.map { |r| Leptris::XML::CssToXPath.convert(r, prefix: prefix) }
@@ -131,6 +155,15 @@ module Leptris::XML::Searchable
     end
   end
 
+  # Trailing-argument contract (#183): a String-keyed hash is the
+  # namespace-binding channel — as is a Symbol-keyed hash (the
+  # legacy prefix vocabulary, {x: "urn:x"}); a :version key whose
+  # VALUE is a version selector is the version-selection channel
+  # (xpath("//b", version: "1.0"), mirroring leptris-py#105). A
+  # DECLARED keyword cannot carry this: the moment #xpath declares
+  # one, Ruby converts the trailing namespace hash into keywords
+  # (unknown keyword: "p") — so both channels stay positional and
+  # dispatch on key/value here.
   def parse_search_args(args)
     handler = args.find { |a| !a.is_a?(String) && !a.is_a?(Hash) && !a.is_a?(Symbol) }
     args = args - [handler] if handler
@@ -143,7 +176,27 @@ module Leptris::XML::Searchable
     unless vars.nil? || vars.empty?
       raise ArgumentError, "XPath variable bindings are not supported"
     end
-    [handler, ns, vars]
+    # Value-based disambiguation is load-bearing: Symbol keys are
+    # also the namespace vocabulary, and bare keywords FUSE into a
+    # preceding String-keyed hash at the call site ({"p" => uri,
+    # version: "1.0"} arrives as ONE hash). A :version key with any
+    # other value stays a prefix binding.
+    version = nil
+    if ns.is_a?(Hash)
+      v = ns[:version]
+      if VERSION_SELECTORS.include?(v)
+        version = ns.delete(:version)
+        ns = nil if ns.empty?
+      elsif v.is_a?(String) && v.match?(/\A\d+\.\d+\z/)
+        # A dotted-number :version value is version INTENT — raise
+        # with the valid values rather than silently binding a
+        # prefix literally. Genuine prefix bindings carry URIs.
+        raise ArgumentError,
+          "unknown XPath version #{v.inspect} " \
+          "(valid: \"1.0\"/:xpath10, \"3.1\"/:xpath31)"
+      end
+    end
+    [handler, ns, version]
   end
 
   def looks_like_xpath?(str)

data/lib/leptris/xml/xpath.rb

@@ -18,28 +18,44 @@ class Leptris::XML::XPath
 
   attr_reader :expression
 
-  def self.compile(expression)
+  # +version+ (#183, mirroring leptris-py#105): nil compiles the
+  # full-grammar expression (the default); :xpath10 / "1.0" pins
+  # the strict XPath 1.0 surface. Validated at the boundary.
+  def self.compile(expression, version: nil)
     raw = Leptris::XML::FFI.leptris_xpath_compile(expression.to_s)
     if raw.null?
       raise Leptris::XML::XPathError,
         "invalid expression: #{Leptris::XML::FFI.leptris_last_error}"
     end
-    new(expression.to_s, CompiledHandle.new(raw))
+    version_code =
+      Leptris::XML::Searchable.xpath_version_code(version) if version
+    new(expression.to_s, CompiledHandle.new(raw), version_code)
   end
 
-  def initialize(expression, handle)
+  def initialize(expression, handle, version_code = nil)
     @expression = expression
     @handle = handle
+    @version_code = version_code
   end
 
   # Evaluates against +doc_or_element+. An optional trailing hash of
   # namespace bindings ("prefix" => uri) routes the evaluation through
   # the namespace-bound path, matching Searchable#xpath semantics.
+  # A compiled version pin routes through the engine's versioned
+  # entry instead of the compiled handle — there is no compiled
+  # versioned lane yet (engine gap), so the strict-1.0 surface is
+  # enforced per evaluation over the stored expression.
   def eval(doc_or_element, ns = nil)
     context = Leptris::XML::EvaluationContext.of(doc_or_element)
     document = context.document
     result_ptr =
-      if ns && !ns.empty?
+      if @version_code
+        raise ArgumentError,
+          "version: cannot be combined with namespace bindings "           "(the versioned engine entry takes no ns set yet)" if ns && !ns.empty?
+        Leptris::XML::FFI.leptris_xpath_eval_versioned(
+          document.c_ptr, context.context_node_ptr,
+          @expression, @version_code, nil)
+      elsif ns && !ns.empty?
         Leptris::XML::FFI.with_ns_set(ns) do |set|
           Leptris::XML::FFI.leptris_xpath_compiled_eval_ns(
             @handle, document.c_ptr, context.context_node_ptr, set)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.156.0
+  version: 1.9.160.0
 platform: ruby
 authors:
 - Ribose Inc.