leptris 1.9.379.0 → 1.9.379.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 67c48c7a6e45049f3b82b51ab4df2ad9b7560769bcc74508c088c9a41b99ff66
-  data.tar.gz: 6021d287da0756566a9aa4a411172e4bec507794e1003d5d940fe33f6e5497ca
+  metadata.gz: edeb66183ddb13396cc543e13dfb1cff9269e81320012d8381cd9a89444947b1
+  data.tar.gz: 48369d2290dc535b1c32696ec2d6b41f8d4bbe5cff60f7195074b957b6f9d198
 SHA512:
-  metadata.gz: 3580c365274a0758a9eff72697240f319880d83a823e195c18af23d3fc2fd5fed392cafb1d5050dfb9682ac99fef2cf72db87c6cd20d0b0d3653f9c7d8363b64
-  data.tar.gz: 2a9d437f8823b9d94e340f27540fa586dda60c4e8f6e779da3a59b1226eaf76c87bc87e9a2de7ec0d7d07646e5ef6690cf92dff93a23f1b118b1e18e99453938
+  metadata.gz: db7311d0ad04fd30862f5df61e4daac541b2eee6744cf2f635fc1224174b41d52a0932883c6bc4e3ba6bc6387dab17ed70201742dfd0d727df8da575cde6313d
+  data.tar.gz: bdf72ad7a7b8c5e11b1709450ce5f32d75639d6f7d96b3aaa45327a7e258e0d3572e5cb40e1f40538213182099f0d8c341746a38e6da47aef3a6605358f34f2d

data/CHANGELOG.md

@@ -1,3 +1,25 @@
+## [1.9.379.2] - 2026-10-21
+
+### Added — native layer
+
+- **Unshadowed `set_text_native` alias (the add_child_native
+  pattern, leptris/leptris-ruby#525)**: `content=` on the TypedData
+  self, one C frame per text write; consumers gate by respond_to?
+  and fall back on older exts.
+
+## [1.9.379.1] - 2026-10-21
+
+### Added — native layer
+
+- **The element mint pre-writes the consumer contract in C
+  (leptris/leptris-ruby#523)**: `NativeNode.create_element` takes
+  optional `(context, adapter)` and writes `@native` (the identity
+  contract: the node itself), `@context` and `@adapter` before
+  returning, so moxml's builder hot path skips its Ruby prime pass
+  per created element. The binding-agnostic consumer gates itself
+  by an arity probe; the two-argument call is unchanged for
+  existing callers.
+
 ## [1.9.379.0] - 2026-10-21
 
 ### Fixed — engine sync (libleptris 1.9.379)

data/ext/leptris/native/native.c

@@ -205,6 +205,7 @@ static VALUE c_leptris_error;
 static VALUE c_b_document, c_b_freed, c_ffi_pointer;
 static ID id_ptr_new, id_freed_new, id_alive;
 static ID id_iv_c_address, id_iv_document, id_iv_parent;
+static ID id_iv_mx_context, id_iv_mx_adapter, id_iv_mx_native;
 static ID id_iv_structure_memoizable, id_iv_native_fast;
 static ID id_iv_pub_document, id_iv_addr_reads_fast, id_iv_node_type;
 static void check_status_c(int st);
@@ -1411,11 +1412,18 @@ static VALUE nf_insert_binding_child(VALUE self, VALUE document,
 
 /* Builder factories (#149): create in C, wrap as NativeNode — no
  * FFI::Pointer, no Ruby wrap_fresh path. */
-static VALUE nn_create_element(VALUE klass, VALUE document, VALUE name)
+static VALUE nn_create_element(int argc, VALUE *argv, VALUE klass)
 {
+    VALUE document, name, mx_context, mx_adapter;
     void *ptr;
-    VALUE mk = doc_klass_for_kind(document, 0);
+    VALUE mk, node;
     (void)klass;
+    /* Optional (context, adapter): when the consumer passes its
+     * contract state, the mint pre-writes the ivars in C and the
+     * consumer's Ruby prime pass disappears from the build path. */
+    rb_scan_args(argc, argv, "22", &document, &name,
+                 &mx_context, &mx_adapter);
+    mk = doc_klass_for_kind(document, 0);
     ptr = f_elem_create(doc_ptr_of(document), StringValueCStr(name));
     if (!ptr)
         rb_raise(c_runtime_error, "leptris_element_create failed");
@@ -1423,8 +1431,18 @@ static VALUE nn_create_element(VALUE klass, VALUE document, VALUE name)
      * the unattached create factories are the build path (moxml's
      * create_element per record); plain NativeNode here forced the
      * consumer into wrapper-mode bridging for the whole document. */
-    if (!NIL_P(mk))
-        return mint_consumer_node(mk, document, ptr);
+    if (!NIL_P(mk)) {
+        node = mint_consumer_node(mk, document, ptr);
+        if (!NIL_P(mx_context)) {
+            /* The identity contract (#508): @native is the node
+             * itself — exactly what the consumer's prime pass wrote.
+             * Writing it here lets that pass disappear. */
+            rb_ivar_set(node, id_iv_mx_native, node);
+            rb_ivar_set(node, id_iv_mx_context, mx_context);
+            rb_ivar_set(node, id_iv_mx_adapter, mx_adapter);
+        }
+        return node;
+    }
     return wrap_new(document, ptr);
 }
 
@@ -3525,6 +3543,9 @@ LEPTRIS_INIT_EXPORT void Init_native(void)
     id_iv_binding_cache = rb_intern("@wrapper_cache");
     id_iv_c_address = rb_intern("@c_address");
     id_iv_document = rb_intern("@document");
+    id_iv_mx_context = rb_intern("@context");
+    id_iv_mx_native = rb_intern("@native");
+    id_iv_mx_adapter = rb_intern("@adapter");
     id_iv_parent = rb_intern("@parent");
     id_iv_structure_memoizable = rb_intern("@structure_memoizable");
     id_iv_native_fast = rb_intern("@native_fast");
@@ -3552,7 +3573,7 @@ LEPTRIS_INIT_EXPORT void Init_native(void)
     rb_define_singleton_method(c_native_node, "from", nn_from, 2);
     rb_define_singleton_method(c_native_node, "install_child_klasses",
                                nn_install_child_klasses, 1);
-    rb_define_singleton_method(c_native_node, "create_element", nn_create_element, 2);
+    rb_define_singleton_method(c_native_node, "create_element", nn_create_element, -1);
     rb_define_singleton_method(c_native_node, "create_text", nn_create_text, 2);
     rb_define_singleton_method(c_native_node, "set_root", nn_set_root, 2);
     rb_define_method(c_native_node, "create_child", nn_create_child, 1);
@@ -3578,6 +3599,11 @@ LEPTRIS_INIT_EXPORT void Init_native(void)
     rb_define_alias(c_native_node, "name_read", "name");
     rb_define_method(c_native_node, "children", nn_children, 0);
     rb_define_alias(c_native_node, "children_read", "children");
+    /* Unshadowed write face (the add_child_native pattern): the
+     * registered Identity klasses shadow content= with the
+     * facade; consumers plain-dispatch here for the one-frame
+     * text write. */
+    rb_define_alias(c_native_node, "set_text_native", "content=");
     rb_define_method(c_native_node, "element_children", nn_element_children, 0);
     rb_define_method(c_native_node, "next_sibling", nn_next_sibling, 0);
     rb_define_method(c_native_node, "parent", nn_parent, 0);

data/lib/leptris/version.rb

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

data/lib/leptris/xml/native_layer.rb

@@ -111,8 +111,17 @@ class Leptris::XML::Document
 
   # Builder factories that return NativeNodes (#149): one C call
   # and a TypedData wrap — no FFI::Pointer, no wrap_fresh path.
-  def native_create_element(name)
-    Leptris::XML::NativeNode.create_element(self, name.to_s)
+  # (context, adapter) pre-writes the consumer's contract ivars in
+  # C — the mint returns a node that already answers them, and the
+  # consumer's Ruby prime pass disappears from the build path.
+  # Older compiled exts take two args; pass through only when given.
+  def native_create_element(name, mx_context = nil, mx_adapter = nil)
+    if mx_context.nil?
+      Leptris::XML::NativeNode.create_element(self, name.to_s)
+    else
+      Leptris::XML::NativeNode.create_element(self, name.to_s,
+                                              mx_context, mx_adapter)
+    end
   end
 
   def native_create_text(content)

metadata

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