leptris 1.9.156.0 → 1.9.156.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cd58b08303252f035517604c63e63c1db6583e84fb622c03026ea259fbbd0baa
-  data.tar.gz: 9ebde3d10256cb54d4b091257d7cc08236c10448e8b2427251c855360bd2a1e4
+  metadata.gz: c649879fc6a03c38e8c36df987c079271d62583992ae6836f23f53dae102a82e
+  data.tar.gz: 91c1a0d1f5101f73841bfee5ca6fd4ad07bbe36a9b6035c7542d3c43bac14b7e
 SHA512:
-  metadata.gz: ff02784b8881a170661ecfb091bc38a1c0d61cff7034b01aecef96a2773da963c2482d09d289978fc0d7c18e7a481417f82dd3d026afc0cfa41c79ef8eb2f0fd
-  data.tar.gz: c5f9ef06098af10c1b0b63b6e878b58142f814f5f111dd697080d02591839cef3cd95ff4c6168493c498ac05c3f885a3eb85341e9819b8a2bdb15e1a4e5f5212
+  metadata.gz: 12b2aaa87ab88a85f9c2023a976869a30ae53bb6671d8bf47d0097e87870a5b8eb3fe0b728d564ae6312b46f2343b2a3db5720cdd6b4ce27a86c1ddb9826547e
+  data.tar.gz: 5435202bd16c7175dfb1a36d49bf3027ed562729f7f99a1a98b393aa9daf85f0a338e019f953864ad07ee13be3457f15b2e7b6e730e67db9d8adf2c4b2f76703

data/CHANGELOG.md

@@ -5,6 +5,66 @@ 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.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/lib/leptris/version.rb

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

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

@@ -457,6 +457,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.156.2
 platform: ruby
 authors:
 - Ribose Inc.