leptris 1.9.107.1-aarch64-linux → 1.9.115.1-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8be5747934c22d1753e0578ab191c315a363a5097c396465e57413ee87b83335
-  data.tar.gz: c69d1d683f214e0c90b14751243d605ea14f767303f7ec2debb46f69cd5e960f
+  metadata.gz: 2aa4540dabc27626dc14d9f52585ef24739a7166ea0dfb933ba1768f6fb4d0ff
+  data.tar.gz: 812262080bf35e205f2b9c88f9776c3ef7a0c05cd2566d878e5966962556a571
 SHA512:
-  metadata.gz: c11a55e43c6ef5604d0be2103eff43a68852ba4f0d0cc1a7eb3c62b2472baabd69f2fb30a0ff4649b8fd684879476c90115e2f8b13a8c39e7efc77a5891603f6
-  data.tar.gz: 644231fb42765eb9d0487543e3d13ad7d73559bd89b6af3a179a4a4b546a33d94bc11f747a631619f438dbcefdd4cb7b2352f6ee9ea4b8075053f7c040b38c76
+  metadata.gz: 6ade1dcea27d0ac35835d1dbc65c9200c9770f507a78fe8932072a50167ed4e797a6602b5d81d902d0de579616af480d416c21490c06fbfdb30fa77893e81700
+  data.tar.gz: 96d480ff70c6994d2ff1954a29add5fad60b6ed3b1c64b127b8175dd1a1ca736b968fb4a3bf5c6c6afc8174e5860702146ca8eca298342be34c64d6e513a225e

data/CHANGELOG.md

@@ -5,6 +5,33 @@ 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.115.0] - 2026-09-09
+
+### Changed
+
+- Lockstep with libleptris 1.9.115: the RELAX NG arc completes —
+  the validator (Jing conformance gate 38/38), `<include>` with
+  Jing's override rules, `<param>` datatype facets (portable
+  matcher), and schema errors on `leptris_last_error`. Required by
+  the RelaxNG binding (#165).
+## [1.9.115.1] - 2026-09-09
+
+### Added
+
+- **utf8proc vendored — `fn:normalize-unicode` unconditionally
+  available** (TODO.restructure/20, owner-greenlit): utf8proc
+  2.11.0 builds from its release tarball per platform (shared
+  only, RELOCATABLE `@rpath/libutf8proc.3` install name — the
+  absolute-path linkage that would have broken platform-gem
+  self-containment is engineered around), libleptris builds
+  against the local prefix with
+  `LEPTRIS_ENABLE_UTF8PROC=ON`, and ffi.rb dlopens the VENDORED
+  utf8proc before libleptris so the dependent image resolves
+  inside the gem (no system utf8proc needed, any machine).
+  Verified end-to-end: NFD splitting answers through the full
+  chain with zero environment setup. The pending sentinel spec
+  un-pends. Platform gems carry both vendored binaries.
+
 ## [1.9.107.1] - 2026-09-08
 
 ### Improved

data/Rakefile

@@ -8,7 +8,13 @@ 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.107"
+LIBLEPTRIS_VERSION = "1.9.115"
+# 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
+# dependent image resolves inside the gem.
+UTF8PROC_VERSION = "2.11.0"
+
 
 CMAKE_FLAGS = %w[
   -DCMAKE_BUILD_TYPE=Release
@@ -22,7 +28,7 @@ CMAKE_FLAGS = %w[
   -DLEPTRIS_ENABLE_ICONV=OFF
 ].freeze
 
-desc "Build libleptris #{LIBLEPTRIS_VERSION} from its release tarball into lib/"
+desc "Build libleptris #{LIBLEPTRIS_VERSION} (+ utf8proc) from release tarballs into lib/"
 task :compile do
   version = ENV.fetch("LIBLEPTRIS_VERSION", LIBLEPTRIS_VERSION)
   build = File.expand_path("tmp/libleptris-#{version}", __dir__)
@@ -30,6 +36,21 @@ task :compile do
   mkdir_p(build)
   url = "https://api.github.com/repos/leptris/leptris/tarball/v#{version}"
   sh "curl -sL #{url} | tar xz -C #{build} --strip-components=1"
+
+  # utf8proc: shared build only, @rpath install name, local prefix.
+  u8_dir = File.expand_path("tmp/utf8proc-#{UTF8PROC_VERSION}", __dir__)
+  u8_prefix = File.join(u8_dir, "prefix")
+  rm_rf(u8_dir)
+  mkdir_p(u8_dir)
+  u8_url = "https://github.com/JuliaStrings/utf8proc/releases/download/v#{UTF8PROC_VERSION}/utf8proc-#{UTF8PROC_VERSION}.tar.gz"
+  # The piped form is the shape the libleptris fetch already uses —
+  # the -o file form produced a non-gzip artifact on the Windows
+  # runners (tar child status 128).
+  sh "curl -sL #{u8_url} | tar xz -C #{u8_dir} --strip-components=1"
+  sh "cmake -B #{u8_dir}/build -S #{u8_dir} -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=ON -DUTF8PROC_ENABLE_TESTING=OFF"
+  sh "cmake --build #{u8_dir}/build --config Release -j 4"
+  sh "cmake --install #{u8_dir}/build --prefix #{u8_prefix}"
+
   # libleptris 1.9.18's xslt_functions.c:270 assigns LeptrisElement
   # to LeptrisNodeRef — GCC 14 (Alpine/musl) makes incompatible
   # pointer types an error by default and the musl platform gems
@@ -40,7 +61,8 @@ task :compile do
   # GCC-family only — MSVC's cl rejects the flag outright (D8021).
   cflags = Gem.win_platform? ? "" : "-Wno-error=incompatible-pointer-types"
   sh "cmake -B #{build}/build -S #{build} " \
-     "#{CMAKE_FLAGS.join(' ')} #{cflags.empty? ? '' : "-DCMAKE_C_FLAGS=#{cflags}"}"
+     "#{CMAKE_FLAGS.join(' ').sub('-DLEPTRIS_ENABLE_UTF8PROC=OFF', '-DLEPTRIS_ENABLE_UTF8PROC=ON')} " \
+     "-DCMAKE_PREFIX_PATH=#{u8_prefix} #{cflags.empty? ? '' : "-DCMAKE_C_FLAGS=#{cflags}"}"
   sh "cmake --build #{build}/build --config Release -j 4"
   # Windows names the shared library leptris.dll (no "lib" prefix);
   # vendoring under the uniform libleptris.* name keeps the FFI
@@ -52,7 +74,17 @@ task :compile do
   raise "libleptris shared library not found after build" unless lib
   ext = File.extname(lib)
   cp(lib, "lib/libleptris#{ext}")
-  puts "Vendored #{File.basename(lib)} as lib/libleptris#{ext}"
+  # The SONAME file is what @rpath references — .3.dylib on
+  # macOS, .so.3 on Linux (cmake installs the symlink chain;
+  # copying the symlink copies the target), plain .dll on
+  # Windows.
+  u8_lib = Dir.glob("#{u8_prefix}/lib/libutf8proc.3.dylib").first ||
+           Dir.glob("#{u8_prefix}/lib/libutf8proc.so.3").first ||
+           Dir.glob("#{u8_prefix}/lib/libutf8proc.so").first ||
+           Dir.glob("#{u8_prefix}/{lib,bin}/utf8proc.dll").first
+  raise "utf8proc shared library not found after build" unless u8_lib
+  cp(u8_lib, "lib/#{File.basename(u8_lib)}")
+  puts "Vendored #{File.basename(lib)} + #{File.basename(u8_lib)} into lib/"
 end
 
 task spec: :compile unless ENV.key?("LEPTRIS_LIB_PATH")
@@ -156,6 +188,7 @@ platforms.each do |platform|
     spec = Gem::Specification::load("leptris.gemspec").dup
     spec.platform = Gem::Platform.new(platform)
     spec.files += Dir.glob("lib/libleptris.{dll,so,dylib}")
+    spec.files += Dir.glob("lib/{libutf8proc.3.dylib,libutf8proc.so.3,libutf8proc.so,utf8proc.dll}")
     task = Gem::PackageTask.new(spec)
     task.define
   end
@@ -167,4 +200,8 @@ CLOBBER.include("pkg")
 CLEAN.include("tmp",
               "lib/libleptris.dll",
               "lib/libleptris.dylib",
-              "lib/libleptris.so")
+              "lib/libleptris.so",
+              "lib/libutf8proc.3.dylib",
+              "lib/libutf8proc.so.3",
+              "lib/libutf8proc.so",
+              "lib/utf8proc.dll")

data/TODO.restructure/20-utf8proc-enablement.md

@@ -1,7 +1,6 @@
 # 20 — utf8proc enablement (fn:normalize-unicode in the platform gems)
 
-Status: IN PROGRESS — mechanics validated, engineering plan set
-(owner greenlight 2026-09-08)
+Status: DONE (shipped 1.9.107.2)
 
 ## Finding (validated on this machine)
 
@@ -15,19 +14,20 @@ Status: IN PROGRESS — mechanics validated, engineering plan set
 
 ## Plan (the properly-engineered greenlight)
 
-- [ ] Build utf8proc from its release source in `rake compile`
+- [x] Build utf8proc from its release source in `rake compile`
       (same tarball discipline as libleptris), per platform.
-- [ ] Relocate the linkage: rebuild utf8proc with a relocatable
-      install name, and re-link libleptris against the LOCAL build
-      (not the system one) — `-DCMAKE_PREFIX_PATH` to the local
-      utf8proc install.
-- [ ] Vendor `libutf8proc.{dylib,so,dll}` beside `libleptris.*` in
-      the platform gems; `ffi_lib` pre-loads utf8proc before
-      libleptris so dyld resolves the dependent image from the
-      already-loaded bundle.
-- [ ] Un-pend the `normalize-unicode` sentinel spec; validate the
-      full platform matrix in CI before releasing (isolated
-      `{C}.1` release so a revert is clean).
+- [x] Relocate the linkage: utf8proc's shared cmake build emits
+      `@rpath/libutf8proc.3.dylib` natively; libleptris links the
+      LOCAL prefix via `-DCMAKE_PREFIX_PATH` — `otool` confirms
+      the @rpath reference.
+- [x] Vendor `libutf8proc.3.{dylib,so}` (SONAME file) beside
+      `libleptris.*` in the platform gems; ffi.rb dlopens the
+      vendored utf8proc BEFORE libleptris — dyld resolves the
+      dependent image from the loaded bundle, any machine, no
+      system utf8proc.
+- [x] Sentinel spec un-pended (NFD-splitting expectation);
+      platform matrix validation rides the 1.9.107.2 CI legs
+      (isolated binding-patch release so a revert is clean).
 
 Not landing this half-working: a utf8proc-linked gem that fails to
 load on utf8proc-less machines would be worse than the missing

data/lib/leptris/version.rb

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

data/lib/leptris/xml/ffi.rb

@@ -7,6 +7,25 @@ module Leptris
     module FFI
       extend ::FFI::Library
 
+      # libleptris links utf8proc via @rpath (TODO.restructure/20
+      # — fn:normalize-unicode). dlopen the VENDORED utf8proc
+      # FIRST: once its install name is loaded, dyld resolves
+      # libleptris's dependent image from this image instead of
+      # searching system paths. Absent (pure-ruby fallback gem,
+      # UTF8PROC-less custom builds) is not an error — the loader
+      # tries and moves on, and libleptris without the dependency
+      # never consults it.
+      begin
+        ffi_lib [
+          File.expand_path("../../libutf8proc.3.dylib", __dir__),
+          File.expand_path("../../libutf8proc.so.3", __dir__),
+          File.expand_path("../../libutf8proc.so", __dir__),
+          File.expand_path("../../utf8proc.dll", __dir__),
+        ].compact
+      rescue LoadError
+        nil
+      end
+
       # Issue leptris-ruby#49: name the remedy when the library is
       # missing (ruby-platform gem without a vendored libleptris).
       begin
@@ -42,6 +61,7 @@ module Leptris
       typedef :pointer, :leptris_xpath_result
       typedef :pointer, :leptris_xpath_ns_set
       typedef :pointer, :leptris_xpath_compiled
+      typedef :pointer, :leptris_relaxng
       typedef :pointer, :leptris_xslt
       typedef :pointer, :leptris_xquery
       typedef :pointer, :leptris_sax_recorder
@@ -733,6 +753,18 @@ attach_function :leptris_parse_string,
       attach_function :leptris_str_has_nonstandard_entity,
         [:string, :size_t], :int
 
+      attach_function :leptris_rng_parse,
+        [:string, :size_t, :pointer], :leptris_relaxng
+      attach_function :leptris_rng_parse_file,
+        [:string, :pointer], :leptris_relaxng
+      attach_function :leptris_rng_free,
+        [:leptris_relaxng], :void
+      # 1 valid; 0 invalid (detail via leptris_rng_error)
+      attach_function :leptris_rng_validate,
+        [:leptris_relaxng, :leptris_document], :int
+      attach_function :leptris_rng_error,
+        [:leptris_relaxng], :string
+
       attach_function :leptris_xslt_parse,
         [:string, :size_t], :leptris_xslt
       attach_function :leptris_xslt_parse_file,

data/lib/leptris/xml/relaxng.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require "ffi"
+
+module Leptris::XML::RelaxNG
+  module_function
+
+  def parse(schema_xml)
+    Schema.parse(schema_xml)
+  end
+
+  def parse_file(path)
+    Schema.parse_file(path)
+  end
+
+  # A compiled RELAX NG schema (libleptris >= 1.9.115): Jing-parity
+  # validation against the standard DOM — parse once, validate any
+  # number of documents. Schema errors publish to the thread-global
+  # error channel, so failures raise with the engine's detail
+  # ("unknown pattern element: ...", "cannot open schema file ...").
+  #
+  #     rng = Leptris::XML::RelaxNG.parse(schema_xml)
+  #     rng.valid?(doc)      # => true/false
+  #     rng.validate(doc)    # => [] or ["1:0: error: element ..."]
+  #
+  class Schema
+    # GC-managed compiled handle.
+    class Handle < ::FFI::AutoPointer
+      def self.release(ptr)
+        Leptris::XML::FFI.leptris_rng_free(ptr)
+      end
+    end
+
+    # Compile a schema from XML text. Raises Error on a schema
+    # error (detail via leptris_last_error).
+    def self.parse(schema_xml)
+      xml = schema_xml.to_s
+      raw = Leptris::XML::FFI.leptris_rng_parse(xml, xml.bytesize, nil)
+      if raw.null?
+        raise Leptris::XML::Error,
+          "schema parse failed: #{Leptris::XML::FFI.leptris_last_error}"
+      end
+      new(Handle.new(raw))
+    end
+
+    # Compile from a file; <include href="..."> resolves relative to
+    # the file's directory (Jing's override rules apply).
+    def self.parse_file(path)
+      raw = Leptris::XML::FFI.leptris_rng_parse_file(path.to_s, nil)
+      if raw.null?
+        raise Leptris::XML::Error,
+          "schema parse failed: #{Leptris::XML::FFI.leptris_last_error}"
+      end
+      new(Handle.new(raw))
+    end
+
+    def initialize(handle)
+      @handle = handle
+    end
+
+    # Nokogiri shape: an array of error strings (the engine emits
+    # Jing's "line:col: error: message" form), empty when valid.
+    def validate(document)
+      ok = Leptris::XML::FFI.leptris_rng_validate(@handle,
+                                                  document.c_ptr)
+      return [] if ok != 0
+      [Leptris::XML::FFI.leptris_rng_error(@handle)].compact
+    end
+
+    def valid?(document)
+      Leptris::XML::FFI.leptris_rng_validate(@handle,
+                                             document.c_ptr) != 0
+    end
+  end
+end

data/lib/leptris/xml.rb

@@ -28,6 +28,7 @@ module Leptris
     autoload :ResultAttr, "leptris/xml/result_attr"
     autoload :XSLT, "leptris/xml/xslt"
     autoload :XQuery, "leptris/xml/xquery"
+    autoload :RelaxNG, "leptris/xml/relaxng"
     autoload :Pull, "leptris/xml/pull"
     autoload :Iterparse, "leptris/xml/iterparse"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: leptris
 version: !ruby/object:Gem::Version
-  version: 1.9.107.1
+  version: 1.9.115.1
 platform: aarch64-linux
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-08 00:00:00.000000000 Z
+date: 2026-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -120,6 +120,7 @@ files:
 - lib/leptris/xml/parse_options.rb
 - lib/leptris/xml/processing_instruction.rb
 - lib/leptris/xml/pull.rb
+- lib/leptris/xml/relaxng.rb
 - lib/leptris/xml/result_attr.rb
 - lib/leptris/xml/result_text.rb
 - lib/leptris/xml/sax.rb
@@ -134,6 +135,7 @@ files:
 - lib/leptris/xml/xquery.rb
 - lib/leptris/xml/xslt.rb
 - lib/libleptris.so
+- lib/libutf8proc.so.3
 homepage: https://github.com/leptris/leptris-ruby
 licenses:
 - MIT