leptris 1.9.201.2 → 1.9.201.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aad9938e69332952ad6bf3f10a58475f017f781fd8603dbec3c6591bb4c29b17
-  data.tar.gz: e56f8feb3a9dd9ba2e97772a1e1a10bbe0687f5fe7d60f6432ec898acc2dde9e
+  metadata.gz: 0215d7037c33fbb784e4b8a76b07ccfd9bf7cc12930650a5072a084e3e5e8edf
+  data.tar.gz: 97156b49dc4c4b5ba49971c57f7d7ca010ecdb387e5280acf15f477c14a32fe8
 SHA512:
-  metadata.gz: a7771a13bbac1883902471c33a48979e63de5d64dff476d5b7a7c033f844feea831066e3ab079741a618a1e7c152c847b8bc0daa2e3dfa16e41af7193e9c03ea
-  data.tar.gz: 7a4e5a3557e59049de395a5d04c6c6034144a5aa253adff0b75efaaff5acd6fc6451fcf14d1378e454fbfe5faef13adec518dd581892802f328fd2ab823902b4
+  metadata.gz: 6e0dbbed68718437cd57698f082eae5c894a4ce46977ab3f25b330441c5c31ef083a2c19e53261ba5e2a022a0ac4d541a7e8f6708fbaf0805694e10ae227623a
+  data.tar.gz: 2afbd08c4d3985faa3d6a40252676551c3aa6af1cce4b185389da42a11e44a54519a33e25cd7b027c54c778ee624aad36e3acc13d1be835e10d7a139465d72fc

data/CHANGELOG.md

@@ -5,6 +5,30 @@ 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.201.3] - 2026-09-19
+
+### Added — the HTML facade (Nokogiri-shaped entry points)
+
+- **`Leptris::HTML` / `Leptris::HTML4` / `Leptris::HTML5`** —
+  top-level parse entry points over the one DOM. The engine has a
+  single DOM with multiple parser front-ends (an HTML document IS
+  a `Leptris::XML::Document`; every node/query/serializer face
+  applies), but that left HTML discoverable only as
+  `Leptris::XML.parse_html` — porters scanning for an `HTML`
+  module (the `Nokogiri::HTML5.parse` reflex) concluded the
+  binding had no HTML support. The facade fixes the shape:
+  `Leptris::HTML(html)` = the html4/Nokogiri-parity lane,
+  `Leptris::HTML5.parse` = the WHATWG engine, `HTML4.parse` =
+  the explicit parity lane. Pure delegates — no parallel class
+  hierarchy; identity and the whole XML surface carry over.
+- Spec battery `spec/xml/html_facade_spec.rb`; `spec_helper` now
+  requires the public entry (`leptris`) rather than reaching into
+  `leptris/xml` — the suite exercises the gem's real bootstrap.
+- Surfaced while pinning: **mutations on HTML-parsed documents
+  are lost on serialization** (both lanes, FFI and native —
+  engine-side). Filed as leptris/leptris#1220 with the
+  two-line repro; the facade spec pins the working half.
+
 ## [1.9.201.1] - 2026-09-19
 
 ### Changed — source-distribution doctrine

data/lib/leptris/html.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+# The HTML facade (issue: "no HTML support in Ruby" — a discoverability
+# gap, not a capability one). The engine has ONE DOM with multiple
+# parser front-ends, so an HTML document IS a Leptris::XML::Document
+# and every node/serializer/query face applies unchanged. What was
+# missing was the shape porters scan for: a top-level HTML module
+# mirroring the Nokogiri entry points.
+#
+#   Leptris::HTML(html)          # the html4 lane (Nokogiri::HTML parity)
+#   Leptris::HTML5.parse(html)   # the WHATWG engine (html5lib zero reds)
+#   Leptris::HTML4.parse(html)   # explicit html4 lane
+#
+# These are pure delegates — no parallel class hierarchy, no second
+# wrapper cache; identity and the whole XML surface carry over.
+module Leptris
+  module HTML
+    module_function
+
+    # Nokogiri::HTML shape: the default lane is html4 (byte-parity
+    # with libxml2/Nokogiri::HTML), matching XML.parse_html's default.
+    def parse(html)
+      Leptris::XML.parse_html(html, mode: :html4)
+    end
+  end
+
+  module HTML4
+    module_function
+
+    def parse(html)
+      Leptris::XML.parse_html(html, mode: :html4)
+    end
+  end
+
+  module HTML5
+    module_function
+
+    # The conformant WHATWG engine: full implied-head set, foster
+    # parenting, adoption agency, template, RCDATA/rawtext (see
+    # spec/xml/html_whatwg_full_spec.rb).
+    def parse(html)
+      Leptris::XML.parse_html(html, mode: :whatwg)
+    end
+  end
+end

data/lib/leptris/version.rb

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