leptris 1.9.290.0 → 1.9.302.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6838f7a55c89398226cfac7d4b10daaff8714a145c3837241e620b5498e04a83
-  data.tar.gz: d468f7c6ed71c26264ea82989e277d15385e0d0d1d467def593e74002ac64fd9
+  metadata.gz: c5007593d092ff504ec69d5682d450e15a65d6992f28a0684231be1fc4590e97
+  data.tar.gz: 8a4f49ee8964cd3d2f1ea2f758b82d282b6cd8e904a6a8609a54f9e71cc59b8b
 SHA512:
-  metadata.gz: da53446281f453422977498301f5581f81c428f0af970ba66ee88bc733de8580e0a6c031023a1a0aab8388a238919d0200a5c97ed29a1e389034a99e5dfc27df
-  data.tar.gz: 3517c14069987df979ea335882af3f9ed1375f78e9fc3b9efe3767072a4fa5cdc22f30e2d849917f13292a55768ec637029c40b051717a15b8ce03c66aaf58fa
+  metadata.gz: 99fafe4f1c4d8dd2538dbc38621c2eab52fbc287e9f83e86787e0dd43212cfbf4c3b39dbceaa513d97cf4db9e3ef4bcc8cb4c19defe5e297ec7b8d5c2591275a
+  data.tar.gz: b565409f1d6477dff43cf4c743d648bb77654be7d70403031ea1f16302abd628491f0c1b6c89d2cd90934371481223047c30e26cc63d84cc61be0a9b2ce90c09

data/CHANGELOG.md

@@ -1,3 +1,101 @@
+## [1.9.302.0] - 2026-10-05
+
+### Engine sync (libleptris 1.9.293-1.9.302)
+
+Ten upstream releases ride in this pin — internal fixes and
+performance with NO binding-surface changes (zero header deltas
+292..302; the audit gate confirms 363/362 unchanged). Highlights:
+
+- **XQuery correctness**: a false() bound anywhere read as truthy;
+  fn:not uses the effective boolean value; fn:abs(()) is empty;
+  string lt/gt are codepoint comparisons; fn:avg edge shapes;
+  aggregates atomize array arguments; `instance of xs:integer`
+  demands integrality; xs:byte/unsignedByte/unsignedInt
+  constructors; fn:sum#2's zero argument.
+- **Collation**: UCA over the vendored DUCET table (slices 1-4) —
+  fn:normalize-unicode F&O conformance, collation-aware string
+  functions, 71+1078 QT3 cases adopted, implicit weights and
+  alternate=blanked.
+- **Performance**: per-thread recycle of mutation blocks (DOM
+  create/build/free).
+- **Rust bindings**: first tokenless crates.io release (leptris
+  v1.4.1) from CI.
+
+## [1.9.292.0] - 2026-10-03
+
+### Fixed
+
+- **Document#root= adopts foreign roots (leptris-ruby#371)**:
+  vendored 1.9.292 (engine #1495) — a foreign element is no longer
+  rejected with EINVAL; the subtree is deep-copied into this
+  document's pool (all node kinds, attributes, namespace
+  declarations), the source document loses the element, and the
+  detached original stays resolvable until the source frees. The
+  binding routes cross-document installs through the new
+  leptris_document_set_root_ex and wraps the INSTALLED handle — a
+  fresh pointer, not the source. Same-document installs keep the
+  native fast path. The old "rejects foreign" construction spec now
+  pins adoption.
+
+## [1.9.291.0] - 2026-10-03
+### Fixed
+
+- **Removed nodes leave clean orphans (leptris-ruby#370)**:
+  vendored 1.9.291 — `remove_child` / `remove_all_children` clear
+  the removed nodes' own sibling links, so a later re-append never
+  splices the stale sibling run into the new parent (nodes were
+  reachable from two parents, up to self-containing cycles).
+- **`prefix:*` is namespace-scoped (leptris-ruby#368)**: three
+  fused compiler sites lowered `//m:*` to the any-element opcode;
+  prefixed wildcards now resolve through the caller's bindings.
+
+### Added
+
+- **Descriptor row-layout skew gate (engine #1490 follow-up)**:
+  the five new struct-size accessors are attached and the
+  descriptor face verifies the engine's compiled row sizes against
+  the binding's FFI structs before every plan build — version
+  skew fails loudly instead of misparsing rows.
+
+## [1.9.290.0] - 2026-10-02
+
+### Fixed
+
+- **Params values evaluate as XPath expressions (engine 1.9.288,
+  #1481 semantics correction)**: the #360 face shipped briefly on
+  raw-string binding — under libleptris 1.9.288+ the value strings
+  evaluate as XPath EXPRESSIONS, the libxslt `params` convention
+  callers know from nokogiri (whose quote_params exists to add the
+  quotes): `"4 * 3"` binds 12, `"'S'"` binds the string `"S"`,
+  `string(/r/@v)` reads the source, a malformed expression fails
+  the transform. The face docs and specs updated to the corrected
+  contract; callers passing pre-quoted values (nokogiri-style)
+  are already correct.
+
+### Added — engine sync (1.9.290)
+
+- Namespace forms for attribute plan rows: `ns_form` / `ns_uri`
+  on the descriptor AttrPlan (#1486/#1487) — the binding packs the
+  fields (zero = the historical wire-name lookup); exposing
+  ns-exact rows from plan trees lands with the first consumer.
+
+### Performance — engine sync (1.9.288-1.9.289)
+
+- Vendored libleptris 1.9.288-1.9.289: the #1481 params semantics
+  correction, plus the 289 HTML-path performance work (slice 6 of
+  #1218): open-id integer compares for the scope/table-context
+  stack walks and id-LUT membership for the foster/formatting
+  checks — cumulative ~+15% on the table-rows fixture; the
+  3.4-7x deficit at 1.9.203 is now a 1.3-1.55x lead over
+  htmlReadMemory.
+- **Descriptor AttrPlan ABI adoption (#1486)**: the attribute-row
+  plan struct gains trailing ns-form fields (additive to the
+  frozen v1 ABI — the #1115 pattern). The binding packs the full
+  layout (FFI zero-fill keeps unset = the historical wire-name
+  lookup); riding 1.9.288+ without the extension reads past the
+  allocation and segfaults the descriptor face. Namespace-form
+  attribute rows are engine-ready; the binding face follows.
+
 ## [1.9.287.0] - 2026-10-02
 
 ### Added

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.290"
+LIBLEPTRIS_VERSION = "1.9.302"
 # 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.290.0"
+  VERSION = "1.9.302.0"
 end

data/lib/leptris/xml/descriptor.rb

@@ -96,6 +96,25 @@ class Leptris::XML::Descriptor
   # Ruby-side spec memory is transient (the engine deep-copies).
   def self.build(tree)
     abi = Leptris::XML::FFI.leptris_plan_abi_version
+    # Row-layout skew gate (1.9.291, engine #1490 follow-up): the
+    # engine reports its compiled row sizes; a mismatch means the
+    # binding's FFI structs and the vendored engine disagree —
+    # fail loudly instead of misparsing rows.
+    {
+      Leptris::XML::FFI.leptris_plan_spec_struct_size => Leptris::XML::FFI::PlanSpec,
+      Leptris::XML::FFI.leptris_plan_element_row_size => Leptris::XML::FFI::ElementPlan,
+      Leptris::XML::FFI.leptris_plan_child_row_size => Leptris::XML::FFI::ChildPlan,
+      Leptris::XML::FFI.leptris_plan_attr_row_size => Leptris::XML::FFI::AttrPlan,
+      Leptris::XML::FFI.leptris_plan_predicate_row_size =>
+        Leptris::XML::FFI::AttrPredicate
+    }.each do |engine_size, struct|
+      next if engine_size == struct.size
+
+      raise Leptris::XML::Error,
+        "descriptor row-layout skew: engine #{engine_size}B vs " \
+        "binding #{struct.size}B for #{struct.name} — the vendored " \
+        "engine and the binding structs disagree"
+    end
     if abi != Leptris::XML::FFI::PLAN_ABI_VERSION
       raise Leptris::XML::Error,
         "descriptor ABI v#{abi} != binding v#{Leptris::XML::FFI::PLAN_ABI_VERSION}"

data/lib/leptris/xml/document.rb

@@ -384,7 +384,20 @@ class Leptris::XML::Document
     # TODO.perf/33: gates + bump + engine set_root in one C
     # dispatch (the FFI call plus the c_ptr materialization fed
     # ~5% of a fresh-doc build).
-    if defined?(Leptris::XML::NATIVE_FAST)
+    # Cross-document adoption (1.9.292, #371): the engine DEEP-COPIES
+    # the foreign subtree into this document's pool and reports the
+    # installed element — a fresh handle distinct from the source
+    # pointer. Same-document installs keep the native fast path.
+    cross = element.document && !element.document.equal?(self)
+    installed_ptr = nil
+    if cross
+      out = ::FFI::MemoryPointer.new(:pointer)
+      Leptris::XML::FFI.check_status(
+        Leptris::XML::FFI.leptris_document_set_root_ex(
+          c_ptr, element.c_ptr, out))
+      installed_ptr = out.read_pointer
+      @version += 1
+    elsif defined?(Leptris::XML::NATIVE_FAST)
       Leptris::XML::Native.set_binding_root(self, element.c_address)
     else
       Leptris::XML::FFI.check_status(
@@ -394,7 +407,7 @@ class Leptris::XML::Document
     # Seed the root memo through wrap: a cross-document element
     # must enter THIS document's identity cache with @document
     # pointing here, not ride its source-document wrapper.
-    @root = Leptris::XML::Node.wrap(element.c_ptr, self)
+    @root = Leptris::XML::Node.wrap(installed_ptr || element.c_ptr, self)
     @root_version = @version
     Leptris::XML::Node.invalidate_cross_document!(element, self)
     element

data/lib/leptris/xml/ffi.rb

@@ -300,9 +300,10 @@ module Leptris
                :predicate_count, :uint16,
                :pad_pred, :uint16,
                :predicates, :pointer,
-               # libleptris 1.9.289 (#1486): attribute-level namespace
-               # form — ns rows match by (URI, local), wire_name is the
-               # LOCAL name; NONE keeps wire-name-exact matching.
+               # libleptris 1.9.289 (#1486): attribute-level ns
+               # form (additive trailing to the frozen v1 ABI —
+               # the #1115 child-row pattern). FFI zero-fills, so
+               # unset = the historical wire-name lookup.
                :ns_form, :uint8,
                :pad_ns, :uint8,
                :ns_uri, :pointer
@@ -372,6 +373,15 @@ module Leptris
       attach_function :leptris_node_byte_offset,
         [:leptris_node_ref], :size_t
 
+      # Struct-size accessors (1.9.291, engine #1490 follow-up):
+      # the engine's compiled row layouts — the descriptor face
+      # verifies them against the FFI structs it packs and fails
+      # loudly on version skew instead of misparsing rows.
+      attach_function :leptris_plan_spec_struct_size, [], :size_t
+      attach_function :leptris_plan_element_row_size, [], :size_t
+      attach_function :leptris_plan_child_row_size, [], :size_t
+      attach_function :leptris_plan_attr_row_size, [], :size_t
+      attach_function :leptris_plan_predicate_row_size, [], :size_t
       attach_function :leptris_plan_abi_version, [], :uint32
       attach_function :leptris_plan_build,
         [:pointer, :pointer], :leptris_plan
@@ -484,6 +494,12 @@ attach_function :leptris_parse_string,
         [], :leptris_document
       attach_function :leptris_document_set_root,
         [:leptris_document, :leptris_element], :leptris_status
+      # 1.9.292 (#371): foreign roots are ADOPTED — deep-copied into
+      # this document's pool; out_installed reports the fresh
+      # handle (wrap THAT, not the source pointer). Legacy
+      # set_root adopts too but cannot report the installed node.
+      attach_function :leptris_document_set_root_ex,
+        [:leptris_document, :leptris_element, :pointer], :leptris_status
       attach_function :leptris_document_root,
         [:leptris_document], :leptris_element
       # The document node — navigation head over the whole tree

data/lib/leptris/xml/xslt.rb

@@ -69,11 +69,13 @@ module Leptris::XML::XSLT
     # Apply to +document+ (not modified) and return the result tree
     # as an owning Document — query it with xpath/css like any other.
     #
-    # params (#360): top-level xsl:param overrides as a Hash of
-    # name => value. Values bind as XPath STRINGS verbatim — the
-    # caller owns numeric/boolean quoting (libxslt conventions:
-    # pass '7' for a number, matching nokogiri's quote_params).
-    # Absent names keep the param's select/@default.
+    # params (#360, engine 1.9.288 semantics): top-level xsl:param
+    # overrides as a Hash of name => value. Values evaluate as
+    # XPath EXPRESSIONS — the libxslt `params` convention callers
+    # know from nokogiri (whose quote_params exists to add the
+    # quotes): "7 * 6" binds 42, "'7'" binds the string "7",
+    # "string(/r/@v)" reads the source. A malformed expression
+    # fails the transform. Absent names keep select/@default.
     def apply_to(document, params: nil)
       raw, buffer, = with_param_pairs(params) do |pairs, count|
         if pairs

data/vendor-src/README.md

@@ -1,7 +1,7 @@
 Sources vendored in this gem (recompile rights; the ruby
 variant builds them at install via extconf.rb):
 
-- libleptris v1.9.290
+- libleptris v1.9.302
 - utf8proc v2.11.0
 
 Rebuild by hand: