leptris 1.9.174.10 → 1.9.177.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0e347192431e6ed3ff15bed0fca55fb103ba7307a33d889014e72c3ece0dba8
-  data.tar.gz: f7edb28afa62063bbc1f0ab2cfcc349619a8944249f69f41b40e054e016b5b45
+  metadata.gz: 9144461ce7cc58b12f57c1a5c497336f5712568654db476342b32b9d6d35dc93
+  data.tar.gz: a6fe5f35bf5891c3794f8bf5533c115b26b9eb19545d361aeafcb3b9b1935af0
 SHA512:
-  metadata.gz: 660309e07c7ce84a4a68bdca9c46a1970f0af6a1bd2e316acca600de60cf54cbd445cd0814232593dd1752f59965d7df8ede74c14da977005b48cbec4ec276fd
-  data.tar.gz: ffe8c0e4f6fc98f4bda50187b3c740e278aae6c82ec384f1ac6843673276b916910a1ab72a4c740a69e0006992418c83eb92280a619b18fac69c8568f5b7639e
+  metadata.gz: ee1362b97425fd76000f28d3232badcb7dd23d979e992cfd296ca17ee6bddeb716bd93b01830f22fd17103475cbfa4eccbcc918691625982fe4b79ca760de897
+  data.tar.gz: e1079b8c90d48d43e17d7ad3e7ebb55a8cbf87246cd61d0eed9eb2a44fc7c3cc91e5f2c034843ee1914f818d1c686b9596b433f96f2e22795fe02a005a75c21b

data/CHANGELOG.md

@@ -5,6 +5,35 @@ 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.177.0] - 2026-09-16
+
+### Changed — libleptris 1.9.174 → 1.9.177 (lockstep)
+
+- **Node-surface parity (upstream #1094, #212 — the big one)**:
+  entity references (`&name;` stays a first-class
+  `EntityReference` node under the new
+  `ParseOptions.keep_entity_refs` flag — text splits around them,
+  character references still expand, serialization is verbatim;
+  `Document#create_entity_reference`), the XML declaration
+  (`xml_version`/`xml_encoding`/`xml_standalone` readers and
+  writers — `#version` stays the mutation counter), programmatic
+  DOCTYPE (`Document#set_doctype` with PUBLIC/SYSTEM ids,
+  serializing in document position), and document-PI parity
+  (`add_pi` returns the PI node with identity and epilog
+  anchoring; `Document#remove_child` removes PIs/comments). The
+  ext's kind dispatch knows the new node kind.
+- **C14N: redundant namespace redeclarations omitted** (upstream
+  #1096) — spec-pinned.
+- **Document lifecycle** (upstream #1093): pool destroy parks the
+  arenas — the fresh-doc build row's teardown share should drop;
+  clean-host battery pending.
+- XSLT/XPath/HTML perf + conformance run (1.9.175-177).
+
+### Added
+
+- `Leptris::XML::EntityReference`, the ten new FFI faces, the
+  `KEEP_ENTITY_REFS` parse flag.
+
 ## [1.9.174.10] - 2026-09-16
 
 ### Changed

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.174"
+LIBLEPTRIS_VERSION = "1.9.177"
 # 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/ext/leptris/native/native.c

@@ -1212,7 +1212,8 @@ static VALUE nn_address(VALUE self)
  * Init; the per-node Ruby frames (wrap/construct/memo/alive)
  * disappear. */
 static VALUE c_b_element = Qundef, c_b_text, c_b_comment, c_b_cdata,
-             c_b_pi, c_b_node, c_b_result_text, c_b_result_attr,
+             c_b_pi, c_b_entity_ref, c_b_node, c_b_result_text,
+             c_b_result_attr,
              c_b_attr, c_ffi_pointer, c_b_document, c_b_freed;
 static VALUE c_iteration_scope;
 static ID id_ptr_new;
@@ -1229,6 +1230,7 @@ static void resolve_binding_classes(void)
     c_b_comment = rb_path2class("Leptris::XML::Comment");
     c_b_cdata = rb_path2class("Leptris::XML::CDATA");
     c_b_pi = rb_path2class("Leptris::XML::ProcessingInstruction");
+    c_b_entity_ref = rb_path2class("Leptris::XML::EntityReference");
     c_b_node = rb_path2class("Leptris::XML::Node");
     c_b_result_text = rb_path2class("Leptris::XML::ResultText");
     c_b_result_attr = rb_path2class("Leptris::XML::ResultAttr");
@@ -1244,6 +1246,7 @@ static void resolve_binding_classes(void)
     rb_gc_register_mark_object(c_b_comment);
     rb_gc_register_mark_object(c_b_cdata);
     rb_gc_register_mark_object(c_b_pi);
+    rb_gc_register_mark_object(c_b_entity_ref);
     rb_gc_register_mark_object(c_b_node);
     rb_gc_register_mark_object(c_b_result_text);
     rb_gc_register_mark_object(c_b_result_attr);
@@ -1263,6 +1266,7 @@ static VALUE binding_klass_for(int kind)
     case 2: return c_b_comment;
     case 3: return c_b_cdata;
     case 4: return c_b_pi;
+    case 10: return c_b_entity_ref; /* #212 / upstream #1094 */
     default: return c_b_node;
     }
 }

data/lib/leptris/version.rb

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

data/lib/leptris/xml/document.rb

@@ -505,15 +505,82 @@ class Leptris::XML::Document
     Leptris::XML::Node.wrap(ptr, self)
   end
 
-  # Append a document-level processing instruction. Returns self.
+  # Append a document-level processing instruction. Returns the PI
+  # node (epilog anchor — after the root; identity via
+  # leptris_document_append_pi, libleptris 1.9.176 / #212).
   def add_pi(target, data = "")
-    witness = Leptris::XML::FFI.leptris_document_add_pi(
+    witness = Leptris::XML::FFI.leptris_document_append_pi(
       c_ptr, target.to_s, data.to_s)
-    raise Leptris::XML::Error, "leptris_document_add_pi failed" if witness.null?
+    raise Leptris::XML::Error, "leptris_document_append_pi failed" if witness.null?
+    @version += 1
+    Leptris::XML::Node.wrap(witness, self)
+  end
+
+  # Remove a document-level PI or comment from the document
+  # children chain (libleptris 1.9.176 / #212). The node stays
+  # document-owned. Raises when the node is not in the chain.
+  def remove_child(node)
+    Leptris::XML::FFI.check_status(
+      Leptris::XML::FFI.leptris_document_remove_child(c_ptr, node.c_ptr))
     @version += 1
     self
   end
 
+  # Create an &name; entity reference node (libleptris 1.9.176 /
+  # #212): serializes back verbatim once attached.
+  def create_entity_reference(name)
+    ptr = Leptris::XML::FFI.leptris_entity_ref_node_create(
+      c_ptr, name.to_s)
+    raise Leptris::XML::Error, "leptris_entity_ref_node_create failed" if ptr.null?
+    Leptris::XML::Node.wrap_fresh(ptr, self, Leptris::XML::FFI::NODE_ENTITY_REF)
+  end
+
+  # The XML declaration (libleptris 1.9.176 / #212). `#version`
+  # stays the mutation counter — the declaration reads are
+  # xml_-prefixed.
+  def xml_version
+    Leptris::XML::FFI.leptris_document_version(c_ptr)
+  end
+
+  def xml_standalone
+    v = Leptris::XML::FFI.leptris_document_standalone(c_ptr)
+    v < 0 ? nil : (v == 1)
+  end
+
+  def xml_encoding
+    Leptris::XML::FFI.leptris_document_encoding(c_ptr)
+  end
+
+  def xml_version=(value)
+    Leptris::XML::FFI.check_status(
+      Leptris::XML::FFI.leptris_document_set_version(c_ptr, value.to_s))
+    value
+  end
+
+  def xml_encoding=(value)
+    Leptris::XML::FFI.check_status(
+      Leptris::XML::FFI.leptris_document_set_encoding(c_ptr, value.to_s))
+    value
+  end
+
+  def xml_standalone=(value)
+    Leptris::XML::FFI.check_status(
+      Leptris::XML::FFI.leptris_document_set_standalone(c_ptr,
+        value.nil? ? -1 : (value ? 1 : 0)))
+    value
+  end
+
+  # Programmatic DOCTYPE (libleptris 1.9.176 / #212): create and
+  # set the document's DOCTYPE (root name + optional PUBLIC/SYSTEM
+  # ids); serializes in document position. Returns the DocType.
+  def set_doctype(name, public_id: nil, system_id: nil)
+    dt = Leptris::XML::FFI.leptris_document_set_doctype(
+      c_ptr, name.to_s, public_id, system_id)
+    raise Leptris::XML::Error, "leptris_document_set_doctype failed" if dt.null?
+    @version += 1
+    Leptris::XML::DocType.new(dt, 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,

data/lib/leptris/xml/entity_reference.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+# An unexpanded &name; entity reference — a first-class node when
+# parsing with ParseOptions.keep_entity_refs (libleptris 1.9.176,
+# upstream #1094 / leptris-ruby#212), or created via
+# Document#create_entity_reference. Serializes back verbatim as
+# &name;; text runs around it split into their own Text siblings.
+class Leptris::XML::EntityReference < Leptris::XML::Node
+  def name
+    Leptris::XML::FFI.leptris_entity_ref_node_name(c_ptr)
+  end
+  alias_method :node_name, :name
+end

data/lib/leptris/xml/ffi.rb

@@ -337,6 +337,29 @@ attach_function :leptris_parse_string,
       # node_first_child without the intermediate handle).
       attach_function :leptris_document_first_child,
         [:leptris_document], :leptris_node_ref
+      # Node-surface parity (libleptris 1.9.176, upstream #1094,
+      # leptris-ruby#212): entity references, the XML declaration,
+      # programmatic DOCTYPE, and document-PI identity/removal.
+      attach_function :leptris_entity_ref_node_create,
+        [:leptris_document, :string], :leptris_node_ref
+      attach_function :leptris_entity_ref_node_name,
+        [:leptris_node_ref], :string
+      attach_function :leptris_document_version,
+        [:leptris_document], :string
+      attach_function :leptris_document_standalone,
+        [:leptris_document], :int
+      attach_function :leptris_document_set_version,
+        [:leptris_document, :string], :leptris_status
+      attach_function :leptris_document_set_encoding,
+        [:leptris_document, :string], :leptris_status
+      attach_function :leptris_document_set_standalone,
+        [:leptris_document, :int], :leptris_status
+      attach_function :leptris_document_set_doctype,
+        [:leptris_document, :string, :string, :string], :leptris_doctype
+      attach_function :leptris_document_append_pi,
+        [:leptris_document, :string, :string], :leptris_node_ref
+      attach_function :leptris_document_remove_child,
+        [:leptris_document, :leptris_node_ref], :leptris_status
       # Wrap-free subtree visitation (1.9.20, upstream #645a):
       # enter/leave pairs for elements, depth from the walk's root,
       # one C call — no NodeSet/Array churn per level. The document
@@ -1070,11 +1093,15 @@ attach_function :leptris_parse_string,
       NODE_COMMENT = 2
       NODE_CDATA = 3
       NODE_PI = 4
+      NODE_ENTITY_REF = 10
       # Internal XPath-synthetic text node (leptris/types.h): the
       # carrier for sequence/map/array items in result nodesets —
       # readable only through the result handle, so the binding
       # captures the value at materialization (ResultText).
       NODE_SYNTHETIC_TEXT = 8
+      # #1094: &name; references stay unexpanded first-class nodes
+      # when this flag parses (character references still expand).
+      LEPTRIS_PARSE_KEEP_ENTITY_REFS = 4
       NODE_DOCTYPE = 5
       NODE_ATTRIBUTE = 6
 

data/lib/leptris/xml/node.rb

@@ -132,6 +132,8 @@ class Leptris::XML::Node
       Leptris::XML::CDATA.new(c_ptr, document, parent: parent, node_type: node_type)
     when Leptris::XML::FFI::NODE_PI
       Leptris::XML::ProcessingInstruction.new(c_ptr, document, parent: parent, node_type: node_type)
+    when Leptris::XML::FFI::NODE_ENTITY_REF
+      Leptris::XML::EntityReference.new(c_ptr, document, parent: parent, node_type: node_type)
     else
       new(c_ptr, document, parent: parent, node_type: node_type)
     end

data/lib/leptris/xml/parse_options.rb

@@ -17,6 +17,13 @@ class Leptris::XML::ParseOptions
   # defaulted attributes.
   DTDATTR = Leptris::XML::FFI::LEPTRIS_PARSE_DTDATTR
 
+  # Keep &name; entity references unexpanded as first-class
+  # EntityReference nodes (libleptris 1.9.176, upstream #1094 /
+  # leptris-ruby#212): text runs split around them, character
+  # references still expand, and the references serialize back
+  # verbatim.
+  KEEP_ENTITY_REFS = Leptris::XML::FFI::LEPTRIS_PARSE_KEEP_ENTITY_REFS
+
   attr_reader :flags
 
   # Recover (libleptris 1.9.0, #547): a parse failure returns an
@@ -32,6 +39,10 @@ class Leptris::XML::ParseOptions
     @recover = recover ? true : false
   end
 
+  def self.keep_entity_refs
+    new(KEEP_ENTITY_REFS)
+  end
+
   def self.noblanks
     new(NOBLANKS)
   end
@@ -52,6 +63,10 @@ class Leptris::XML::ParseOptions
     @flags & DTDATTR != 0
   end
 
+  def keep_entity_refs?
+    @flags & KEEP_ENTITY_REFS != 0
+  end
+
   def dtdattr=(value)
     if value then @flags |= DTDATTR else @flags &= ~DTDATTR end
   end

data/lib/leptris/xml.rb

@@ -9,6 +9,7 @@ module Leptris
     autoload :Comment, "leptris/xml/comment"
     autoload :CDATA, "leptris/xml/cdata"
     autoload :ProcessingInstruction, "leptris/xml/processing_instruction"
+    autoload :EntityReference, "leptris/xml/entity_reference"
     autoload :Attr, "leptris/xml/attr"
     autoload :Namespace, "leptris/xml/namespace"
     autoload :Document, "leptris/xml/document"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.174.10
+  version: 1.9.177.0
 platform: ruby
 authors:
 - Ribose Inc.
@@ -164,6 +164,7 @@ files:
 - lib/leptris/xml/document.rb
 - lib/leptris/xml/document_fragment.rb
 - lib/leptris/xml/element.rb
+- lib/leptris/xml/entity_reference.rb
 - lib/leptris/xml/evaluation_context.rb
 - lib/leptris/xml/ffi.rb
 - lib/leptris/xml/iteration_scope.rb