leptris 1.9.14-aarch64-linux → 1.9.16-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c96f59841d0606a790ec372576cdb05f50bbc39c43cdf1188e7a4535068a7a8f
-  data.tar.gz: e3396a5ec39b5638f20a2254da0796f6330ca689f62e2fcad939850a42662f64
+  metadata.gz: f6960184588bed5ebd9fa8fbf64fe97bb8476b433ba43b5176568f20b9dd561b
+  data.tar.gz: 739e787fbd3c921bcb2ac4cdf776b3f85bc7ec2fe870b8f94f9366cd3aacc710
 SHA512:
-  metadata.gz: a6cc9bb4c0ba7b0c39ced816d8435370947d6e051df16d1d03a899c5fbbdd1a7ba1e0c7e0a05f7879874a4b20c5db7b2f7b639138eb0137bbb1276e1288b7b59
-  data.tar.gz: 12846d96eec9f9a3d681bdb1bd9a2e29807a21575adc209851bdb4b3067f8c5999732faa9a4bdfad0af1ac6e55cdac6f52c832d886623f137c8b0aa867bc5ba2
+  metadata.gz: 2588d661f45aec8859681b381fffd2fb05b4600f2888c826ad86a1c43f8ad86d7a8fc95b8ce4d5ae803772275066e4f43e67f09bf0592d5648d732383081168e
+  data.tar.gz: d01eb46bdd19bbdfdf26c6fb278111291f8713439d088f205f7985ba46f31696c344c864f8d95229d4e389c7bc857bdfaae25721cf49d8475c71936c2344b8e1

data/CHANGELOG.md

@@ -5,6 +5,37 @@ 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.16] - 2026-08-27
+
+### Changed
+
+- **at_xpath / at_css take the single-node path**: a new
+  `wrap_xpath_first_result` seam answers nodeset results via
+  get_node(0) + wrap + free — no NodeSet container, no AutoPointer,
+  one fewer FFI than xpath().first; scalar results keep full-wrapper
+  semantics. Measured on the canonical scraper loop: at_xpath 0.018 s
+  -> 0.005 s (3.6x — the per-iteration container churn was GC
+  pressure the old path paid twice), at_css ~24%. Equivalence with
+  xpath().first is spec-pinned across nodeset/empty/scalar shapes.
+  Also drops a vestigial `.send(:from_result)` on a public factory.
+
+## [1.9.15] - 2026-08-27
+
+### Changed
+
+- **`Element#[]` serves bare names from the versioned attributes
+  hash on every document kind** (writable included): materializes
+  on demand, invalidates through the mutation gate. Qualified names
+  (with a colon) still route to the engine — they resolve through
+  in-scope declarations where the written prefix never matters,
+  which a written-name-keyed hash cannot answer. Writable
+  attribute loops reach readonly parity: 0.196 s -> 0.101 s (2x);
+  the readonly special-case branch is deleted. The qualified/bare
+  split is spec-pinned (cross-prefix match, undeclared-prefix nil).
+- **`first_element_child` memoizes** with version invalidation
+  (structural mutations bump): 0.058 s -> 0.015 s (4x) on the
+  repeat loop.
+
 ## [1.9.14] - 2026-08-27
 
 ### Changed

data/lib/leptris/version.rb

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

data/lib/leptris/xml/element.rb

@@ -35,16 +35,20 @@ class Leptris::XML::Element < Leptris::XML::Node
   end
 
   def [](key)
-    # Readonly: the attributes hash cannot go stale (ADR 0003) and
-    # materializes on demand — repeated reads become hash lookups,
-    # with no dispatch and no lifetime guard (a hash read cannot
-    # use-after-free).
-    if readonly_document?
-      cached = attributes[key.to_s]
+    # BARE names serve from the versioned attributes hash (written
+    # name == the only legal key for a no-namespace attribute);
+    # materializes on demand, invalidates through the mutation gate
+    # (ADR 0003's 1.9.14 extension); a hash read cannot
+    # use-after-free. QUALIFIED names (with a colon) go to the
+    # engine: they resolve through in-scope declarations, where the
+    # written prefix never matters — the hash cannot answer them.
+    name = key.to_s
+    if @document && !name.include?(":")
+      cached = attributes[name]
       return cached.nil? ? nil : cached.value
     end
     ensure_alive!
-    Leptris::XML::FFI.leptris_element_attribute(@c_ptr, key.to_s)
+    Leptris::XML::FFI.leptris_element_attribute(@c_ptr, name)
   end
   alias_method :attr, :[]
   alias_method :get_attribute, :[]

data/lib/leptris/xml/node.rb

@@ -179,14 +179,23 @@ class Leptris::XML::Node
   alias_method :previous, :previous_sibling
 
   def first_element_child
+    return @first_element_child if memo_hit?(@first_element_child_version)
     ensure_alive!
     ptr = Leptris::XML::FFI.leptris_node_first_child(@c_ptr)
+    result = nil
     until ptr.nil? || ptr.null?
       node = Leptris::XML::Node.wrap(ptr, @document, parent: as_element_or_self)
-      return node if node.element?
+      if node.element?
+        result = node
+        break
+      end
       ptr = Leptris::XML::FFI.leptris_node_next_sibling(ptr)
     end
-    nil
+    if @document
+      @first_element_child = result
+      @first_element_child_version = @document.version
+    end
+    result
   end
 
   def last_element_child

data/lib/leptris/xml/searchable.rb

@@ -24,8 +24,24 @@ module Leptris::XML::Searchable
   end
 
   def at_xpath(*paths)
-    result = xpath(*paths)
-    result.is_a?(Leptris::XML::NodeSet) ? result.first : result
+    handler, ns, _vars = parse_search_args(paths)
+    raise ArgumentError, "custom XPath handlers not supported" if handler
+    expr = paths.join(" | ")
+
+    doc_ptr = is_a?(Leptris::XML::Document) ? c_ptr : document.c_ptr
+    context_ptr = is_a?(Leptris::XML::Document) ? nil : c_ptr
+
+    result_ptr =
+      if 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)
+      end
+    if result_ptr.null?
+      raise Leptris::XML::XPathError,
+        Leptris::XML::FFI.leptris_last_error.to_s
+    end
+    Leptris::XML::Searchable.wrap_xpath_first_result(document, result_ptr)
   end
 
   def search(*args)
@@ -53,8 +69,13 @@ module Leptris::XML::Searchable
   end
 
   def at_css(*args)
-    result = css(*args)
-    result.is_a?(Leptris::XML::NodeSet) ? result.first : result
+    handler, ns, _ = parse_search_args(args)
+    raise ArgumentError, "namespace bindings not supported in css" if ns && !ns.empty?
+    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) }
+      .join(" | ")
+    at_xpath(expr)
   end
 
   protected
@@ -86,6 +107,22 @@ module Leptris::XML::Searchable
     %r{\A(\./|/|\.\.|\.)}.match?(str)
   end
 
+  # Single-node seam beside wrap_xpath_result: a nodeset answers
+  # via result_get_node(0) + wrap + free — no NodeSet container, no
+  # AutoPointer, one fewer FFI than xpath().first; scalars keep the
+  # full-wrapper semantics.
+  def self.wrap_xpath_first_result(document, result_ptr)
+    type = Leptris::XML::FFI.leptris_xpath_result_type(result_ptr)
+    if type == Leptris::XML::FFI::XPATH_NODESET
+      ptr = Leptris::XML::FFI.leptris_xpath_result_get_node(result_ptr, 0)
+      node = ptr.null? ? nil : Leptris::XML::Node.wrap(ptr, document)
+      Leptris::XML::FFI.leptris_xpath_result_free(result_ptr)
+      node
+    else
+      wrap_xpath_result(document, result_ptr)
+    end
+  end
+
   # Shared by Searchable#xpath and Leptris::XML::XPath (compiled
   # expressions): wraps a raw XPathResult pointer into the
   # Ruby-typed result and frees the C handle.
@@ -93,7 +130,7 @@ module Leptris::XML::Searchable
     type = Leptris::XML::FFI.leptris_xpath_result_type(result_ptr)
     case type
     when Leptris::XML::FFI::XPATH_NODESET
-      Leptris::XML::NodeSet.send(:from_result, document, result_ptr)
+      Leptris::XML::NodeSet.from_result(document, result_ptr)
     when Leptris::XML::FFI::XPATH_BOOLEAN
       v = Leptris::XML::FFI.leptris_xpath_result_boolean(result_ptr) != 0
       Leptris::XML::FFI.leptris_xpath_result_free(result_ptr)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.14
+  version: 1.9.16
 platform: aarch64-linux
 authors:
 - Ribose Inc.