@dvaji/cheerox 0.0.0-stage → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (268) hide show
  1. package/CONTRIBUTING.md +74 -0
  2. package/Cargo.lock +1091 -0
  3. package/Cargo.toml +47 -0
  4. package/LICENSE +21 -0
  5. package/README.md +121 -2
  6. package/RELEASING.md +114 -0
  7. package/THIRD_PARTY_NOTICES.md +7581 -0
  8. package/build.rs +3 -0
  9. package/cheerox.darwin-arm64.node +0 -0
  10. package/cheerox.darwin-x64.node +0 -0
  11. package/cheerox.linux-arm64-gnu.node +0 -0
  12. package/cheerox.linux-arm64-musl.node +0 -0
  13. package/cheerox.linux-x64-gnu.node +0 -0
  14. package/cheerox.linux-x64-musl.node +0 -0
  15. package/cheerox.win32-arm64-msvc.node +0 -0
  16. package/cheerox.win32-x64-msvc.node +0 -0
  17. package/dist/cheerio-compat-BKkfJEAr.mjs +1648 -0
  18. package/dist/cheerio-compat-BKkfJEAr.mjs.map +1 -0
  19. package/dist/cheerio-compat-DRLPzBdX.d.mts +88 -0
  20. package/dist/cheerio-compat-DRsINTwV.d.cts +88 -0
  21. package/dist/cheerio-compat-DRsINTwV.d.ts +88 -0
  22. package/dist/cheerio-compat-DcnYK9OB.cjs +1719 -0
  23. package/dist/cheerio-compat-DcnYK9OB.cjs.map +1 -0
  24. package/dist/cheerio-compat.cjs +18 -0
  25. package/dist/cheerio-compat.d.cts +2 -0
  26. package/dist/cheerio-compat.d.mts +2 -0
  27. package/dist/cheerio-compat.d.ts +2 -0
  28. package/dist/cheerio-compat.mjs +1 -0
  29. package/dist/index.cjs +13 -0
  30. package/dist/index.cjs.map +1 -0
  31. package/dist/index.d.cts +28 -0
  32. package/dist/index.d.mts +6 -0
  33. package/dist/index.d.ts +28 -0
  34. package/dist/index.mjs +53 -0
  35. package/dist/index.mjs.map +1 -0
  36. package/dist/legacy-parse.cjs +5 -0
  37. package/dist/legacy-parse.d.mts +8 -0
  38. package/dist/legacy-parse.d.ts +7 -0
  39. package/dist/legacy-parse.mjs +1 -0
  40. package/dist/modern-B7hyW4cI.d.cts +102 -0
  41. package/dist/modern-B7hyW4cI.d.ts +102 -0
  42. package/dist/modern-CHQGP0Yt.cjs +2858 -0
  43. package/dist/modern-CHQGP0Yt.cjs.map +1 -0
  44. package/dist/modern-CJvSD_y5.d.mts +102 -0
  45. package/dist/modern-CvXcTn82.mjs +2769 -0
  46. package/dist/modern-CvXcTn82.mjs.map +1 -0
  47. package/dist/modern.cjs +19 -0
  48. package/dist/modern.d.cts +3 -0
  49. package/dist/modern.d.mts +3 -0
  50. package/dist/modern.d.ts +3 -0
  51. package/dist/modern.mjs +3 -0
  52. package/dist/nodes-jbWWhssj.cjs +4210 -0
  53. package/dist/nodes-jbWWhssj.cjs.map +1 -0
  54. package/dist/nodes-sYxb5qyZ.mjs +3803 -0
  55. package/dist/nodes-sYxb5qyZ.mjs.map +1 -0
  56. package/dist/slim.cjs +16 -0
  57. package/dist/slim.cjs.map +1 -0
  58. package/dist/slim.d.cts +6 -0
  59. package/dist/slim.d.mts +6 -0
  60. package/dist/slim.d.ts +6 -0
  61. package/dist/slim.mjs +12 -0
  62. package/dist/slim.mjs.map +1 -0
  63. package/dist/types-CA01Zg3r.d.cts +526 -0
  64. package/dist/types-CA01Zg3r.d.mts +526 -0
  65. package/dist/types-CA01Zg3r.d.ts +526 -0
  66. package/dist/utils.cjs +31 -0
  67. package/dist/utils.cjs.map +1 -0
  68. package/dist/utils.d.cts +8 -0
  69. package/dist/utils.d.mts +8 -0
  70. package/dist/utils.d.ts +8 -0
  71. package/dist/utils.mjs +25 -0
  72. package/dist/utils.mjs.map +1 -0
  73. package/native/src/arena.rs +2109 -0
  74. package/native/src/attributes.rs +946 -0
  75. package/native/src/codec.rs +298 -0
  76. package/native/src/diagnostics.rs +1249 -0
  77. package/native/src/document_order.rs +711 -0
  78. package/native/src/extraction.rs +321 -0
  79. package/native/src/gc.rs +175 -0
  80. package/native/src/hook_sink.rs +801 -0
  81. package/native/src/hook_stream.rs +513 -0
  82. package/native/src/id_hash.rs +42 -0
  83. package/native/src/immutable.rs +333 -0
  84. package/native/src/lib.rs +4120 -0
  85. package/native/src/location.rs +392 -0
  86. package/native/src/markup_tokenizer.rs +668 -0
  87. package/native/src/runtime.rs +368 -0
  88. package/native/src/selector.rs +1596 -0
  89. package/native/src/sink.rs +274 -0
  90. package/native/src/snapshot.rs +672 -0
  91. package/native/src/stream.rs +334 -0
  92. package/native/src/tokenizer.rs +581 -0
  93. package/native/src/tracker.rs +232 -0
  94. package/native/vendor/README.md +35 -0
  95. package/native/vendor/html5ever-0.35.0/.cargo_vcs_info.json +6 -0
  96. package/native/vendor/html5ever-0.35.0/Cargo.lock +828 -0
  97. package/native/vendor/html5ever-0.35.0/Cargo.toml +85 -0
  98. package/native/vendor/html5ever-0.35.0/LICENSE-APACHE +201 -0
  99. package/native/vendor/html5ever-0.35.0/LICENSE-MIT +25 -0
  100. package/native/vendor/html5ever-0.35.0/README.md +60 -0
  101. package/native/vendor/html5ever-0.35.0/benches/html5ever.rs +86 -0
  102. package/native/vendor/html5ever-0.35.0/data/bench/lipsum-zh.html +19 -0
  103. package/native/vendor/html5ever-0.35.0/data/bench/lipsum.html +40 -0
  104. package/native/vendor/html5ever-0.35.0/data/bench/medium-fragment.html +24 -0
  105. package/native/vendor/html5ever-0.35.0/data/bench/small-fragment.html +7 -0
  106. package/native/vendor/html5ever-0.35.0/data/bench/strong.html +1 -0
  107. package/native/vendor/html5ever-0.35.0/data/bench/tiny-fragment.html +1 -0
  108. package/native/vendor/html5ever-0.35.0/examples/arena.rs +356 -0
  109. package/native/vendor/html5ever-0.35.0/examples/capi/tokenize.c +74 -0
  110. package/native/vendor/html5ever-0.35.0/examples/noop-tokenize.rs +47 -0
  111. package/native/vendor/html5ever-0.35.0/examples/noop-tree-builder.rs +132 -0
  112. package/native/vendor/html5ever-0.35.0/examples/print-tree-actions.rs +185 -0
  113. package/native/vendor/html5ever-0.35.0/examples/tokenize.rs +111 -0
  114. package/native/vendor/html5ever-0.35.0/src/driver.rs +148 -0
  115. package/native/vendor/html5ever-0.35.0/src/lib.rs +30 -0
  116. package/native/vendor/html5ever-0.35.0/src/macros.rs +34 -0
  117. package/native/vendor/html5ever-0.35.0/src/serialize/mod.rs +255 -0
  118. package/native/vendor/html5ever-0.35.0/src/tokenizer/char_ref/mod.rs +530 -0
  119. package/native/vendor/html5ever-0.35.0/src/tokenizer/interface.rs +99 -0
  120. package/native/vendor/html5ever-0.35.0/src/tokenizer/mod.rs +2628 -0
  121. package/native/vendor/html5ever-0.35.0/src/tokenizer/states.rs +97 -0
  122. package/native/vendor/html5ever-0.35.0/src/tree_builder/data.rs +170 -0
  123. package/native/vendor/html5ever-0.35.0/src/tree_builder/mod.rs +1848 -0
  124. package/native/vendor/html5ever-0.35.0/src/tree_builder/rules.rs +1494 -0
  125. package/native/vendor/html5ever-0.35.0/src/tree_builder/tag_sets.rs +114 -0
  126. package/native/vendor/html5ever-0.35.0/src/tree_builder/types.rs +91 -0
  127. package/native/vendor/html5ever-0.35.0/src/util/str.rs +52 -0
  128. package/native/vendor/html5gum-0.8.4/Cargo.lock +1006 -0
  129. package/native/vendor/html5gum-0.8.4/Cargo.toml +109 -0
  130. package/native/vendor/html5gum-0.8.4/LICENSE +19 -0
  131. package/native/vendor/html5gum-0.8.4/README.md +110 -0
  132. package/native/vendor/html5gum-0.8.4/benches/files/0050.html +2131 -0
  133. package/native/vendor/html5gum-0.8.4/benches/files/6D30.html +1004 -0
  134. package/native/vendor/html5gum-0.8.4/benches/files.rs +32 -0
  135. package/native/vendor/html5gum-0.8.4/benches/patterns.rs +31 -0
  136. package/native/vendor/html5gum-0.8.4/src/arrayvec.rs +29 -0
  137. package/native/vendor/html5gum-0.8.4/src/char_validator.rs +134 -0
  138. package/native/vendor/html5gum-0.8.4/src/emitters/callback.rs +676 -0
  139. package/native/vendor/html5gum-0.8.4/src/emitters/default.rs +207 -0
  140. package/native/vendor/html5gum-0.8.4/src/emitters/emitter.rs +344 -0
  141. package/native/vendor/html5gum-0.8.4/src/emitters/html5ever.rs +306 -0
  142. package/native/vendor/html5gum-0.8.4/src/emitters/mod.rs +25 -0
  143. package/native/vendor/html5gum-0.8.4/src/entities.rs +3342 -0
  144. package/native/vendor/html5gum-0.8.4/src/error.rs +96 -0
  145. package/native/vendor/html5gum-0.8.4/src/htmlstring.rs +130 -0
  146. package/native/vendor/html5gum-0.8.4/src/lib.rs +66 -0
  147. package/native/vendor/html5gum-0.8.4/src/machine.rs +2136 -0
  148. package/native/vendor/html5gum-0.8.4/src/machine_helper.rs +277 -0
  149. package/native/vendor/html5gum-0.8.4/src/read_helper.rs +244 -0
  150. package/native/vendor/html5gum-0.8.4/src/reader.rs +440 -0
  151. package/native/vendor/html5gum-0.8.4/src/span.rs +98 -0
  152. package/native/vendor/html5gum-0.8.4/src/state.rs +16 -0
  153. package/native/vendor/html5gum-0.8.4/src/testutils.rs +71 -0
  154. package/native/vendor/html5gum-0.8.4/src/tokenizer.rs +189 -0
  155. package/native/vendor/html5gum-0.8.4/src/utils.rs +88 -0
  156. package/native/vendor/markup5ever-0.35.0/.cargo_vcs_info.json +6 -0
  157. package/native/vendor/markup5ever-0.35.0/Cargo.toml +45 -0
  158. package/native/vendor/markup5ever-0.35.0/LICENSE-APACHE +201 -0
  159. package/native/vendor/markup5ever-0.35.0/LICENSE-MIT +25 -0
  160. package/native/vendor/markup5ever-0.35.0/interface/mod.rs +422 -0
  161. package/native/vendor/markup5ever-0.35.0/interface/tree_builder.rs +280 -0
  162. package/native/vendor/markup5ever-0.35.0/lib.rs +59 -0
  163. package/native/vendor/markup5ever-0.35.0/serialize.rs +77 -0
  164. package/native/vendor/markup5ever-0.35.0/util/buffer_queue.rs +333 -0
  165. package/native/vendor/markup5ever-0.35.0/util/smallcharset.rs +88 -0
  166. package/native/vendor/scraper-0.24.0/Cargo.toml +52 -0
  167. package/native/vendor/scraper-0.24.0/LICENSE +15 -0
  168. package/native/vendor/scraper-0.24.0/src/element_ref/element.rs +212 -0
  169. package/native/vendor/scraper-0.24.0/src/element_ref/mod.rs +236 -0
  170. package/native/vendor/scraper-0.24.0/src/element_ref/serializable.rs +15 -0
  171. package/native/vendor/scraper-0.24.0/src/error/utils.rs +91 -0
  172. package/native/vendor/scraper-0.24.0/src/error.rs +118 -0
  173. package/native/vendor/scraper-0.24.0/src/html/mod.rs +270 -0
  174. package/native/vendor/scraper-0.24.0/src/html/serializable.rs +27 -0
  175. package/native/vendor/scraper-0.24.0/src/html/tree_sink.rs +285 -0
  176. package/native/vendor/scraper-0.24.0/src/lib.rs +180 -0
  177. package/native/vendor/scraper-0.24.0/src/node/serializable.rs +52 -0
  178. package/native/vendor/scraper-0.24.0/src/node.rs +465 -0
  179. package/native/vendor/scraper-0.24.0/src/selectable.rs +70 -0
  180. package/native/vendor/scraper-0.24.0/src/selector.rs +290 -0
  181. package/package.json +167 -4
  182. package/scripts/check-native.mjs +15 -0
  183. package/scripts/check-release.mjs +234 -0
  184. package/scripts/fix-declarations.mjs +39 -0
  185. package/scripts/generate-notices.mjs +194 -0
  186. package/scripts/notices/README.md +13 -0
  187. package/scripts/notices/cheerio-MIT.txt +21 -0
  188. package/scripts/notices/html5ever-AUTHORS.txt +20 -0
  189. package/scripts/notices/html5ever-COPYRIGHT.txt +8 -0
  190. package/scripts/notices/html5ever-LICENSE-APACHE.txt +201 -0
  191. package/scripts/notices/html5ever-LICENSE-MIT.txt +25 -0
  192. package/scripts/notices/htmlparser2-MIT.txt +18 -0
  193. package/scripts/notices/napi-rs-MIT.txt +43 -0
  194. package/scripts/notices/neon-MIT.txt +19 -0
  195. package/scripts/notices/runtime-01c266bced4a434da005.txt +3 -0
  196. package/scripts/notices/runtime-0a54e647fe54104658b5.txt +14 -0
  197. package/scripts/notices/runtime-0b74dfa0bcee5c420c6b.txt +25 -0
  198. package/scripts/notices/runtime-0d542e0c8804e39aa7f3.txt +177 -0
  199. package/scripts/notices/runtime-0f96a83840e146e43c0e.txt +21 -0
  200. package/scripts/notices/runtime-123a331b5dbf04c30097.txt +25 -0
  201. package/scripts/notices/runtime-172020dbfd5b53a226df.txt +34 -0
  202. package/scripts/notices/runtime-209fbbe0ad52d9235e37.txt +26 -0
  203. package/scripts/notices/runtime-23f18e03dc49df91622f.txt +23 -0
  204. package/scripts/notices/runtime-268872b9816f90fd8e85.txt +220 -0
  205. package/scripts/notices/runtime-35242e7a83f69875e6ed.txt +176 -0
  206. package/scripts/notices/runtime-378f5840b258e2779c39.txt +25 -0
  207. package/scripts/notices/runtime-4108245a1f2df9d4e94d.txt +25 -0
  208. package/scripts/notices/runtime-4455bf75a91154108304.txt +21 -0
  209. package/scripts/notices/runtime-553fffcd9b1cb158bc3e.txt +13 -0
  210. package/scripts/notices/runtime-62c7a1e35f56406896d7.txt +176 -0
  211. package/scripts/notices/runtime-6485b8ed310d3f0340bf.txt +25 -0
  212. package/scripts/notices/runtime-69fef7b0f322a6555415.txt +201 -0
  213. package/scripts/notices/runtime-6df43f6f4b5d4587f3d8.txt +187 -0
  214. package/scripts/notices/runtime-799e9ca9d179295ef372.txt +24 -0
  215. package/scripts/notices/runtime-7b63ecd5f1902af1b637.txt +25 -0
  216. package/scripts/notices/runtime-7bc7d5de2a0b793d4e1a.txt +21 -0
  217. package/scripts/notices/runtime-7e12e5df4bae12cb2158.txt +24 -0
  218. package/scripts/notices/runtime-861399f8c21c042b1105.txt +12 -0
  219. package/scripts/notices/runtime-8ada45cd9f843acf64e4.txt +201 -0
  220. package/scripts/notices/runtime-90eb64f0279b0d9432ac.txt +12 -0
  221. package/scripts/notices/runtime-a60eea817514531668d7.txt +201 -0
  222. package/scripts/notices/runtime-a7c936ff1ed8fa340172.txt +25 -0
  223. package/scripts/notices/runtime-ab6eec6caf0fa5775e41.txt +275 -0
  224. package/scripts/notices/runtime-b1181a40b2a7b25cf66f.txt +19 -0
  225. package/scripts/notices/runtime-b71bd43a069ca0641a9e.txt +25 -0
  226. package/scripts/notices/runtime-c16f8dcf1a368b83be78.txt +201 -0
  227. package/scripts/notices/runtime-c2cfccb812fe482101a8.txt +21 -0
  228. package/scripts/notices/runtime-e99d88d232bf57d70f0f.txt +25 -0
  229. package/scripts/notices/runtime-f32fb3b417a194167cfa.txt +9 -0
  230. package/scripts/notices/runtime-f5062c9a188d81dfe66b.txt +39 -0
  231. package/scripts/notices/runtime-f9070a832833fa7488fd.txt +4 -0
  232. package/scripts/notices/runtime-fab3dd6bdab226f1c086.txt +373 -0
  233. package/scripts/notices/runtime-fba3318d0c600380177e.txt +62 -0
  234. package/scripts/notices/runtime-ff8f68cb076caf8cefe7.txt +25 -0
  235. package/scripts/notices/runtime-ff92bed461f50338dd70.txt +74 -0
  236. package/scripts/notices/runtime.json +1632 -0
  237. package/scripts/notices/sources.json +561 -0
  238. package/scripts/notices/xray-MIT.txt +21 -0
  239. package/src/attribute-object.ts +71 -0
  240. package/src/attributes.ts +308 -0
  241. package/src/cheerio-compat/css.ts +58 -0
  242. package/src/cheerio-compat/render.ts +106 -0
  243. package/src/cheerio-compat/selectors.ts +51 -0
  244. package/src/cheerio-compat/types.ts +52 -0
  245. package/src/cheerio-compat.ts +2055 -0
  246. package/src/codec.ts +96 -0
  247. package/src/dom.ts +87 -0
  248. package/src/extract-plan.ts +97 -0
  249. package/src/extract.ts +322 -0
  250. package/src/hooks.ts +369 -0
  251. package/src/index.ts +48 -0
  252. package/src/io.ts +491 -0
  253. package/src/match.ts +207 -0
  254. package/src/modern.ts +259 -0
  255. package/src/native.ts +149 -0
  256. package/src/nodes.ts +831 -0
  257. package/src/parse.ts +53 -0
  258. package/src/parser-types.ts +157 -0
  259. package/src/router.ts +1129 -0
  260. package/src/selection.ts +682 -0
  261. package/src/slim.ts +12 -0
  262. package/src/snapshot.ts +291 -0
  263. package/src/transport.ts +113 -0
  264. package/src/types.ts +186 -0
  265. package/src/utils.ts +29 -0
  266. package/src/workers.ts +21 -0
  267. package/tsconfig.json +15 -0
  268. package/tsdown.config.mjs +17 -0
@@ -0,0 +1,801 @@
1
+ //! An active user-supplied tree adapter. Rust runs the HTML5 algorithm; the
2
+ //! adapter supplies every construction, mutation and tree-inspection decision.
3
+ use std::borrow::Cow;
4
+ use std::cell::{Cell, Ref, RefCell};
5
+ use std::collections::HashMap;
6
+ use std::rc::Rc;
7
+
8
+ use html5ever::tendril::{StrTendril, TendrilSink};
9
+ use html5ever::tree_builder::{ElementFlags, NodeOrText, QuirksMode, TreeSink};
10
+ use html5ever::{Attribute, LocalName, Namespace, QualName};
11
+ use napi::{Env, Error, JsFunction, JsString, Result, Status};
12
+ use serde_json::{json, Value};
13
+
14
+ use crate::arena::{DomArena, DomNode};
15
+ use crate::NativeDocument;
16
+
17
+ // HTML5 token identities used by the parser, independent of adapter DOM names.
18
+ fn known_html_tag(name: &str) -> bool {
19
+ matches!(
20
+ name,
21
+ "a" | "address"
22
+ | "annotation-xml"
23
+ | "applet"
24
+ | "area"
25
+ | "article"
26
+ | "aside"
27
+ | "b"
28
+ | "base"
29
+ | "basefont"
30
+ | "bgsound"
31
+ | "big"
32
+ | "blockquote"
33
+ | "body"
34
+ | "br"
35
+ | "button"
36
+ | "caption"
37
+ | "center"
38
+ | "code"
39
+ | "col"
40
+ | "colgroup"
41
+ | "dd"
42
+ | "desc"
43
+ | "details"
44
+ | "dialog"
45
+ | "dir"
46
+ | "div"
47
+ | "dl"
48
+ | "dt"
49
+ | "em"
50
+ | "embed"
51
+ | "fieldset"
52
+ | "figcaption"
53
+ | "figure"
54
+ | "font"
55
+ | "footer"
56
+ | "foreignObject"
57
+ | "form"
58
+ | "frame"
59
+ | "frameset"
60
+ | "h1"
61
+ | "h2"
62
+ | "h3"
63
+ | "h4"
64
+ | "h5"
65
+ | "h6"
66
+ | "head"
67
+ | "header"
68
+ | "hgroup"
69
+ | "hr"
70
+ | "html"
71
+ | "i"
72
+ | "img"
73
+ | "image"
74
+ | "input"
75
+ | "iframe"
76
+ | "keygen"
77
+ | "label"
78
+ | "li"
79
+ | "link"
80
+ | "listing"
81
+ | "main"
82
+ | "malignmark"
83
+ | "marquee"
84
+ | "math"
85
+ | "menu"
86
+ | "meta"
87
+ | "mglyph"
88
+ | "mi"
89
+ | "mo"
90
+ | "mn"
91
+ | "ms"
92
+ | "mtext"
93
+ | "nav"
94
+ | "nobr"
95
+ | "noframes"
96
+ | "noembed"
97
+ | "noscript"
98
+ | "object"
99
+ | "ol"
100
+ | "optgroup"
101
+ | "option"
102
+ | "p"
103
+ | "param"
104
+ | "plaintext"
105
+ | "pre"
106
+ | "rb"
107
+ | "rp"
108
+ | "rt"
109
+ | "rtc"
110
+ | "ruby"
111
+ | "s"
112
+ | "script"
113
+ | "search"
114
+ | "section"
115
+ | "select"
116
+ | "source"
117
+ | "small"
118
+ | "span"
119
+ | "strike"
120
+ | "strong"
121
+ | "style"
122
+ | "sub"
123
+ | "summary"
124
+ | "sup"
125
+ | "table"
126
+ | "tbody"
127
+ | "template"
128
+ | "textarea"
129
+ | "tfoot"
130
+ | "td"
131
+ | "th"
132
+ | "thead"
133
+ | "title"
134
+ | "tr"
135
+ | "track"
136
+ | "tt"
137
+ | "u"
138
+ | "ul"
139
+ | "svg"
140
+ | "var"
141
+ | "wbr"
142
+ | "xmp"
143
+ )
144
+ }
145
+
146
+ struct DirectBridge {
147
+ env: Env,
148
+ function: napi::Ref<()>,
149
+ }
150
+ impl DirectBridge {
151
+ fn call(&self, request: &str) -> Result<Value> {
152
+ let function: JsFunction = self.env.get_reference_value(&self.function)?;
153
+ let argument = self.env.create_string(request)?;
154
+ let result = function.call(None, &[argument])?;
155
+ let text: JsString = result.coerce_to_string()?;
156
+ serde_json::from_str(text.into_utf8()?.as_str()?)
157
+ .map_err(|error| Error::new(Status::InvalidArg, error.to_string()))
158
+ }
159
+ }
160
+ impl Drop for DirectBridge {
161
+ fn drop(&mut self) {
162
+ let _ = self.function.unref(self.env);
163
+ }
164
+ }
165
+
166
+ pub(crate) type HookCall = Box<dyn Fn(&str, Value) -> Result<Value>>;
167
+
168
+ enum Transport {
169
+ Direct(DirectBridge),
170
+ Threaded(HookCall),
171
+ }
172
+ impl Transport {
173
+ fn call(&self, method: &str, args: Value) -> Result<Value> {
174
+ let result = match self {
175
+ Self::Direct(bridge) => bridge.call(&json!({"method":method,"args":args}).to_string()),
176
+ Self::Threaded(bridge) => bridge(method, args),
177
+ }?;
178
+ if result.get("__cheeroxHookError").and_then(Value::as_bool) == Some(true) {
179
+ Err(Error::new(
180
+ Status::GenericFailure,
181
+ "User treeAdapter hook failed",
182
+ ))
183
+ } else {
184
+ Ok(result)
185
+ }
186
+ }
187
+ }
188
+
189
+ struct HookSink {
190
+ bridge: Transport,
191
+ names: RefCell<HashMap<u32, QualName>>,
192
+ error: RefCell<Option<Error>>,
193
+ options: Value,
194
+ fragment: bool,
195
+ source: String,
196
+ context: Option<Rc<crate::diagnostics::DiagnosticContext>>,
197
+ diagnostics: RefCell<Vec<Value>>,
198
+ locations: Option<crate::tracker::Locations<u32>>,
199
+ pending_escape: Cell<Option<TextTarget>>,
200
+ }
201
+
202
+ /// Where a text chunk is inserted: appended to `parent`, or before `sibling`.
203
+ #[derive(Clone, Copy, PartialEq, Eq)]
204
+ struct TextTarget {
205
+ parent: u32,
206
+ sibling: Option<u32>,
207
+ }
208
+
209
+ /// Whether the final character is a codec escape whose character has not
210
+ /// arrived yet. Escapes pair with the following character.
211
+ fn ends_with_unpaired_escape(text: &str) -> bool {
212
+ let mut chars = text.chars();
213
+ while let Some(ch) = chars.next() {
214
+ if ch == crate::codec::ESCAPE && chars.next().is_none() {
215
+ return true;
216
+ }
217
+ }
218
+ false
219
+ }
220
+
221
+ impl HookSink {
222
+ fn call(&self, method: &str, args: Value) -> Value {
223
+ if self.error.borrow().is_some() {
224
+ return Value::Null;
225
+ }
226
+ if matches!(
227
+ method,
228
+ "appendChild"
229
+ | "insertBefore"
230
+ | "detachNode"
231
+ | "setDocumentType"
232
+ | "setTemplateContent"
233
+ | "__snapshot"
234
+ ) {
235
+ self.flush_escape();
236
+ }
237
+ let result = self.bridge.call(method, args);
238
+ match result {
239
+ Ok(value) => value,
240
+ Err(error) => {
241
+ *self.error.borrow_mut() = Some(error);
242
+ Value::Null
243
+ }
244
+ }
245
+ }
246
+ fn node(&self, method: &str, args: Value) -> u32 {
247
+ self.call(method, args).as_u64().unwrap_or(0) as u32
248
+ }
249
+ /// The tokenizer may split a codec escape from its character across text
250
+ /// chunks. Adapters decode each chunk separately, so a trailing escape is
251
+ /// held until the next chunk for the same target.
252
+ fn insert_text(&self, target: TextTarget, text: &str) {
253
+ let mut data = String::with_capacity(text.len() + crate::codec::ESCAPE.len_utf8());
254
+ if let Some(pending) = self.pending_escape.take() {
255
+ if pending == target {
256
+ data.push(crate::codec::ESCAPE);
257
+ } else {
258
+ self.send_text(pending, &crate::codec::ESCAPE.to_string());
259
+ }
260
+ }
261
+ data.push_str(text);
262
+ if ends_with_unpaired_escape(&data) {
263
+ data.pop();
264
+ self.pending_escape.set(Some(target));
265
+ }
266
+ if !data.is_empty() {
267
+ self.send_text(target, &data);
268
+ }
269
+ }
270
+ fn send_text(&self, target: TextTarget, data: &str) {
271
+ match target.sibling {
272
+ None => self.call("insertText", json!([target.parent, data])),
273
+ Some(sibling) => self.call("insertTextBefore", json!([target.parent, data, sibling])),
274
+ };
275
+ }
276
+ fn flush_escape(&self) {
277
+ if let Some(pending) = self.pending_escape.take() {
278
+ self.send_text(pending, &crate::codec::ESCAPE.to_string());
279
+ }
280
+ }
281
+ fn attrs(attrs: Vec<Attribute>) -> Value {
282
+ Value::Array(
283
+ attrs
284
+ .into_iter()
285
+ .map(|attr| {
286
+ let mut value =
287
+ json!({"name":attr.name.local.as_ref(),"value":attr.value.as_ref()});
288
+ if !attr.name.ns.as_ref().is_empty() {
289
+ value["prefix"] = Value::String(
290
+ attr.name
291
+ .prefix
292
+ .as_ref()
293
+ .map_or("", |prefix| prefix.as_ref())
294
+ .into(),
295
+ );
296
+ value["namespace"] = Value::String(attr.name.ns.as_ref().into());
297
+ }
298
+ value
299
+ })
300
+ .collect(),
301
+ )
302
+ }
303
+ fn publish_location(&self, id: u32, update: bool) {
304
+ let Some(location) = self
305
+ .locations
306
+ .as_ref()
307
+ .and_then(|locations| locations.get(id))
308
+ else {
309
+ return;
310
+ };
311
+ if update {
312
+ if let Some(fields) = location.as_object() {
313
+ let patch: serde_json::Map<String, Value> =
314
+ ["endLine", "endCol", "endOffset", "endTag"]
315
+ .into_iter()
316
+ .filter_map(|field| {
317
+ fields
318
+ .get(field)
319
+ .map(|value| (field.to_owned(), value.clone()))
320
+ })
321
+ .collect();
322
+ if !patch.is_empty() {
323
+ self.call("updateNodeSourceCodeLocation", json!([id, patch]));
324
+ }
325
+ }
326
+ } else {
327
+ let mut location = location;
328
+ if let Some(fields) = location.as_object_mut() {
329
+ let start_tag = fields.get("startTag").cloned();
330
+ if let Some(start_tag) = start_tag {
331
+ for field in ["endLine", "endCol", "endOffset"] {
332
+ if !fields.contains_key(field) {
333
+ fields.insert(field.to_owned(), start_tag[field].clone());
334
+ }
335
+ }
336
+ }
337
+ }
338
+ self.call("setNodeSourceCodeLocation", json!([id, location]));
339
+ }
340
+ }
341
+ fn mark_text(&self, parent: u32, before: Option<u32>, data: &str) {
342
+ let children = self.children(parent);
343
+ let id = match before {
344
+ Some(before) => children
345
+ .iter()
346
+ .position(|id| *id == before)
347
+ .and_then(|index| index.checked_sub(1))
348
+ .and_then(|index| children.get(index))
349
+ .copied(),
350
+ None => children.last().copied(),
351
+ };
352
+ if let (Some(locations), Some(id)) = (self.locations.as_ref(), id) {
353
+ let existing = self.call("getNodeSourceCodeLocation", json!([id]));
354
+ locations.text(id, data);
355
+ self.publish_location(id, !existing.is_null());
356
+ }
357
+ }
358
+ fn children(&self, id: u32) -> Vec<u32> {
359
+ self.call("getChildNodes", json!([id]))
360
+ .as_array()
361
+ .map(|ids| {
362
+ ids.iter()
363
+ .filter_map(|id| id.as_u64().map(|id| id as u32))
364
+ .collect()
365
+ })
366
+ .unwrap_or_default()
367
+ }
368
+ }
369
+
370
+ impl TreeSink for HookSink {
371
+ type Handle = u32;
372
+ type Output = Result<NativeDocument>;
373
+ type ElemName<'a> = Ref<'a, QualName>;
374
+
375
+ fn finish(self) -> Self::Output {
376
+ if self.fragment {
377
+ // html5ever exposes a synthetic html element for fragments. The
378
+ // adapter sees the same fragment root shape as Cheerio's parser.
379
+ for child in self.children(0) {
380
+ if self.call("isElementNode", json!([child])).as_bool() == Some(true)
381
+ && self.call("getTagName", json!([child])).as_str() == Some("html")
382
+ {
383
+ for node in self.children(child) {
384
+ self.call("detachNode", json!([node]));
385
+ self.call("appendChild", json!([0, node]));
386
+ }
387
+ self.call("detachNode", json!([child]));
388
+ break;
389
+ }
390
+ }
391
+ }
392
+ let snapshot = self.call("__snapshot", json!([]));
393
+ if let Some(error) = self.error.borrow_mut().take() {
394
+ return Err(error);
395
+ }
396
+ let mut records: Vec<DomNode> = serde_json::from_value(snapshot).map_err(|error| {
397
+ Error::new(
398
+ Status::InvalidArg,
399
+ format!("Invalid treeAdapter DOM: {error}"),
400
+ )
401
+ })?;
402
+ let source = if self.source.is_empty() {
403
+ self.context
404
+ .as_ref()
405
+ .map(|context| context.source_between(0, context.source_len()))
406
+ .unwrap_or_default()
407
+ } else {
408
+ self.source.clone()
409
+ };
410
+ if self.options.get("sourceCodeLocationInfo") == Some(&Value::Bool(true))
411
+ && !source.is_empty()
412
+ {
413
+ let mut fallback = records.clone();
414
+ crate::location::annotate(
415
+ &source,
416
+ &mut fallback,
417
+ self.options.get("scriptingEnabled") != Some(&Value::Bool(false)),
418
+ self.options.get("__utf16Codec") == Some(&Value::Bool(true)),
419
+ );
420
+ // Explicit creation/text/close operations published locations live.
421
+ // Only deferred table text or adapter-internal nodes lack them.
422
+ let locations: Vec<_> = records
423
+ .iter()
424
+ .zip(&fallback)
425
+ .filter(|(node, _)| {
426
+ !node.extras.contains_key("sourceCodeLocation") && node.kind != "root"
427
+ })
428
+ .filter_map(|(node, fallback)| {
429
+ fallback
430
+ .extras
431
+ .get("sourceCodeLocation")
432
+ .map(|location| json!({"id":node.id,"location":location}))
433
+ })
434
+ .collect();
435
+ self.call("__locations", json!([locations]));
436
+ let snapshot = self.call("__snapshot", json!([]));
437
+ if let Some(error) = self.error.borrow_mut().take() {
438
+ return Err(error);
439
+ }
440
+ records = serde_json::from_value(snapshot)
441
+ .map_err(|error| Error::new(Status::InvalidArg, error.to_string()))?;
442
+ }
443
+ let options = self.options;
444
+ let document =
445
+ NativeDocument::from_arena(DomArena::from_records(records, options.clone()), options);
446
+ document.set_diagnostic_records(self.diagnostics.into_inner());
447
+ Ok(document)
448
+ }
449
+ fn parse_error(&self, message: Cow<'static, str>) {
450
+ if let Some(error) = self
451
+ .context
452
+ .as_ref()
453
+ .and_then(|context| context.error(&message))
454
+ {
455
+ self.diagnostics.borrow_mut().push(error.clone());
456
+ self.call("__parseError", json!([error]));
457
+ }
458
+ }
459
+ fn get_document(&self) -> u32 {
460
+ 0
461
+ }
462
+ fn elem_name<'a>(&'a self, target: &'a u32) -> Ref<'a, QualName> {
463
+ let namespace = self
464
+ .call("getNamespaceURI", json!([target]))
465
+ .as_str()
466
+ .unwrap_or(crate::HTML_NS)
467
+ .to_owned();
468
+ let original = self.names.borrow().get(target).cloned();
469
+ // parse5 records known HTML token IDs on its open-element stack. A
470
+ // user adapter can rename the resulting DOM element without changing
471
+ // how a later known closing tag addresses that parser stack entry.
472
+ let local = if namespace == crate::HTML_NS
473
+ && original
474
+ .as_ref()
475
+ .is_some_and(|name| known_html_tag(name.local.as_ref()))
476
+ {
477
+ original.unwrap().local.to_string()
478
+ } else {
479
+ self.call("getTagName", json!([target]))
480
+ .as_str()
481
+ .unwrap_or("unknown")
482
+ .to_owned()
483
+ };
484
+ self.names.borrow_mut().insert(
485
+ *target,
486
+ QualName::new(None, Namespace::from(namespace), LocalName::from(local)),
487
+ );
488
+ Ref::map(self.names.borrow(), |names| &names[target])
489
+ }
490
+ fn create_element(&self, name: QualName, attrs: Vec<Attribute>, flags: ElementFlags) -> u32 {
491
+ let id = self.node(
492
+ "createElement",
493
+ json!([name.local.as_ref(), name.ns.as_ref(), Self::attrs(attrs)]),
494
+ );
495
+ if let Some(locations) = self.locations.as_ref() {
496
+ locations.created(id, name.local.as_ref());
497
+ self.publish_location(id, false);
498
+ }
499
+ self.names.borrow_mut().insert(id, name);
500
+ if flags.template {
501
+ let content = self.node("createDocumentFragment", json!([]));
502
+ self.call("setTemplateContent", json!([id, content]));
503
+ }
504
+ id
505
+ }
506
+ fn create_comment(&self, text: StrTendril) -> u32 {
507
+ let id = self.node("createCommentNode", json!([text.as_ref()]));
508
+ if let Some(locations) = self.locations.as_ref() {
509
+ locations.token(id, "comment");
510
+ }
511
+ id
512
+ }
513
+ fn create_pi(&self, target: StrTendril, data: StrTendril) -> u32 {
514
+ self.create_comment(format!("?{target} {data}?").into())
515
+ }
516
+ fn append(&self, parent: &u32, child: NodeOrText<u32>) {
517
+ match child {
518
+ NodeOrText::AppendNode(child) => {
519
+ self.call("appendChild", json!([parent, child]));
520
+ if self
521
+ .context
522
+ .as_ref()
523
+ .is_some_and(|context| context.current_token().kind == "comment")
524
+ {
525
+ self.publish_location(child, false);
526
+ }
527
+ }
528
+ NodeOrText::AppendText(text) => {
529
+ let target = TextTarget {
530
+ parent: *parent,
531
+ sibling: None,
532
+ };
533
+ self.insert_text(target, text.as_ref());
534
+ self.mark_text(*parent, None, text.as_ref());
535
+ }
536
+ }
537
+ }
538
+ fn append_based_on_parent_node(&self, element: &u32, previous: &u32, child: NodeOrText<u32>) {
539
+ if self.call("getParentNode", json!([element])).is_null() {
540
+ self.append(previous, child);
541
+ } else {
542
+ self.append_before_sibling(element, child);
543
+ }
544
+ }
545
+ fn append_doctype_to_document(
546
+ &self,
547
+ name: StrTendril,
548
+ public_id: StrTendril,
549
+ system_id: StrTendril,
550
+ ) {
551
+ self.call(
552
+ "setDocumentType",
553
+ json!([0, name.as_ref(), public_id.as_ref(), system_id.as_ref()]),
554
+ );
555
+ if let Some(locations) = self.locations.as_ref() {
556
+ for id in self.children(0) {
557
+ if self.call("isDocumentTypeNode", json!([id])).as_bool() == Some(true) {
558
+ locations.token(id, "doctype");
559
+ self.publish_location(id, false);
560
+ break;
561
+ }
562
+ }
563
+ }
564
+ }
565
+ fn get_template_contents(&self, target: &u32) -> u32 {
566
+ self.node("getTemplateContent", json!([target]))
567
+ }
568
+ fn same_node(&self, first: &u32, second: &u32) -> bool {
569
+ first == second
570
+ }
571
+ fn pop(&self, node: &u32) {
572
+ if let Some(locations) = self.locations.as_ref() {
573
+ let name = self.call("getTagName", json!([node]));
574
+ locations.closed_as(*node, name.as_str().unwrap_or(""));
575
+ self.publish_location(*node, true);
576
+ }
577
+ }
578
+ fn on_stack_push(&self, node: &u32) {
579
+ self.call("onItemPush", json!([node]));
580
+ }
581
+ fn on_stack_pop(&self, node: &u32, current: Option<&u32>) {
582
+ self.call("onItemPop", json!([node, current]));
583
+ }
584
+ fn set_quirks_mode(&self, mode: QuirksMode) {
585
+ let mode = match mode {
586
+ QuirksMode::Quirks => "quirks",
587
+ QuirksMode::LimitedQuirks => "limited-quirks",
588
+ QuirksMode::NoQuirks => "no-quirks",
589
+ };
590
+ self.call("setDocumentMode", json!([0, mode]));
591
+ }
592
+ fn append_before_sibling(&self, sibling: &u32, new_node: NodeOrText<u32>) {
593
+ let parent = self.node("getParentNode", json!([sibling]));
594
+ match new_node {
595
+ NodeOrText::AppendNode(node) => {
596
+ self.call("detachNode", json!([node]));
597
+ self.call("insertBefore", json!([parent, node, sibling]));
598
+ }
599
+ NodeOrText::AppendText(text) => {
600
+ let target = TextTarget {
601
+ parent,
602
+ sibling: Some(*sibling),
603
+ };
604
+ self.insert_text(target, text.as_ref());
605
+ self.mark_text(parent, Some(*sibling), text.as_ref());
606
+ }
607
+ }
608
+ }
609
+ fn add_attrs_if_missing(&self, target: &u32, attrs: Vec<Attribute>) {
610
+ self.call("adoptAttributes", json!([target, Self::attrs(attrs)]));
611
+ }
612
+ fn remove_from_parent(&self, target: &u32) {
613
+ self.call("detachNode", json!([target]));
614
+ }
615
+ fn reparent_children(&self, node: &u32, new_parent: &u32) {
616
+ for child in self.children(*node) {
617
+ self.call("detachNode", json!([child]));
618
+ self.call("appendChild", json!([new_parent, child]));
619
+ }
620
+ }
621
+ fn is_mathml_annotation_xml_integration_point(&self, handle: &u32) -> bool {
622
+ let namespace = self.call("getNamespaceURI", json!([handle]));
623
+ let name = self.call("getTagName", json!([handle]));
624
+ namespace.as_str() == Some("http://www.w3.org/1998/Math/MathML")
625
+ && name.as_str() == Some("annotation-xml")
626
+ && self
627
+ .call("getAttrList", json!([handle]))
628
+ .as_array()
629
+ .is_some_and(|attrs| {
630
+ attrs.iter().any(|attr| {
631
+ attr["name"] == "encoding"
632
+ && attr["value"].as_str().is_some_and(|value| {
633
+ value.eq_ignore_ascii_case("text/html")
634
+ || value.eq_ignore_ascii_case("application/xhtml+xml")
635
+ })
636
+ })
637
+ })
638
+ }
639
+ }
640
+
641
+ fn parser(
642
+ env: Env,
643
+ is_document: bool,
644
+ options_json: String,
645
+ bridge: JsFunction,
646
+ ) -> Result<html5ever::Parser<HookSink>> {
647
+ let options: Value = serde_json::from_str(&options_json)
648
+ .map_err(|error| Error::new(Status::InvalidArg, error.to_string()))?;
649
+ let bridge = DirectBridge {
650
+ env,
651
+ function: env.create_reference(bridge)?,
652
+ };
653
+ let sink = HookSink {
654
+ bridge: Transport::Direct(bridge),
655
+ names: RefCell::new(HashMap::new()),
656
+ error: RefCell::new(None),
657
+ options: options.clone(),
658
+ fragment: !is_document,
659
+ source: String::new(),
660
+ context: None,
661
+ diagnostics: RefCell::new(Vec::new()),
662
+ locations: None,
663
+ pending_escape: Cell::new(None),
664
+ };
665
+ sink.call(
666
+ if is_document {
667
+ "createDocument"
668
+ } else {
669
+ "createDocumentFragment"
670
+ },
671
+ json!([]),
672
+ );
673
+ let parse_options = html5ever::driver::ParseOpts {
674
+ tokenizer: html5ever::tokenizer::TokenizerOpts {
675
+ discard_bom: false,
676
+ cheerox_codec: options.get("__utf16Codec") == Some(&Value::Bool(true)),
677
+ ..Default::default()
678
+ },
679
+ tree_builder: html5ever::tree_builder::TreeBuilderOpts {
680
+ scripting_enabled: options.get("scriptingEnabled") != Some(&Value::Bool(false)),
681
+ ..Default::default()
682
+ },
683
+ };
684
+ Ok(if is_document {
685
+ html5ever::driver::parse_document(sink, parse_options)
686
+ } else {
687
+ let context = QualName::new(
688
+ None,
689
+ Namespace::from(
690
+ options
691
+ .get("__contextNamespace")
692
+ .and_then(Value::as_str)
693
+ .unwrap_or(crate::HTML_NS),
694
+ ),
695
+ LocalName::from(
696
+ options
697
+ .get("__contextName")
698
+ .and_then(Value::as_str)
699
+ .unwrap_or("template"),
700
+ ),
701
+ );
702
+ html5ever::driver::parse_fragment(sink, parse_options, context, Vec::new(), false)
703
+ })
704
+ }
705
+
706
+ pub(crate) fn parse(
707
+ env: Env,
708
+ source: String,
709
+ is_document: bool,
710
+ options_json: String,
711
+ bridge: JsFunction,
712
+ ) -> Result<NativeDocument> {
713
+ let options: Value = serde_json::from_str(&options_json)
714
+ .map_err(|error| Error::new(Status::InvalidArg, error.to_string()))?;
715
+ if options.get("__collectParseErrors") == Some(&Value::Bool(true))
716
+ || options.get("sourceCodeLocationInfo") == Some(&Value::Bool(true))
717
+ {
718
+ let context = Rc::new(crate::diagnostics::DiagnosticContext::new(&source));
719
+ let bridge = DirectBridge {
720
+ env,
721
+ function: env.create_reference(bridge)?,
722
+ };
723
+ let sink = HookSink {
724
+ bridge: Transport::Direct(bridge),
725
+ names: RefCell::new(HashMap::new()),
726
+ error: RefCell::new(None),
727
+ options: options.clone(),
728
+ fragment: !is_document,
729
+ source: source.clone(),
730
+ context: Some(context.clone()),
731
+ diagnostics: RefCell::new(Vec::new()),
732
+ locations: (options.get("sourceCodeLocationInfo") == Some(&Value::Bool(true)))
733
+ .then(|| crate::tracker::Locations::new(context.clone())),
734
+ pending_escape: Cell::new(None),
735
+ };
736
+ sink.call(
737
+ if is_document {
738
+ "createDocument"
739
+ } else {
740
+ "createDocumentFragment"
741
+ },
742
+ json!([]),
743
+ );
744
+ crate::diagnostics::parse_with_sink(
745
+ &source,
746
+ is_document,
747
+ &options,
748
+ sink,
749
+ context,
750
+ |_, _| {},
751
+ )
752
+ } else {
753
+ let mut parser = parser(env, is_document, options_json, bridge)?;
754
+ parser.tokenizer.sink.sink.source.push_str(&source);
755
+ parser.one(source)
756
+ }
757
+ }
758
+
759
+ /// A blocking reader is driven on a native worker. The supplied transport waits
760
+ /// for a main-thread JS callback response for every actual sink operation.
761
+ pub(crate) fn parse_reader<R: html5gum::Reader>(
762
+ reader: R,
763
+ options: Value,
764
+ is_document: bool,
765
+ context: Rc<crate::diagnostics::DiagnosticContext>,
766
+ call: HookCall,
767
+ ) -> Result<NativeDocument>
768
+ where
769
+ R::Error: std::fmt::Display,
770
+ {
771
+ let sink = HookSink {
772
+ bridge: Transport::Threaded(call),
773
+ names: RefCell::new(HashMap::new()),
774
+ error: RefCell::new(None),
775
+ options: options.clone(),
776
+ fragment: !is_document,
777
+ source: String::new(),
778
+ context: Some(context.clone()),
779
+ diagnostics: RefCell::new(Vec::new()),
780
+ locations: (options.get("sourceCodeLocationInfo") == Some(&Value::Bool(true)))
781
+ .then(|| crate::tracker::Locations::new(context.clone())),
782
+ pending_escape: Cell::new(None),
783
+ };
784
+ sink.call(
785
+ if is_document {
786
+ "createDocument"
787
+ } else {
788
+ "createDocumentFragment"
789
+ },
790
+ json!([]),
791
+ );
792
+ crate::diagnostics::parse_reader_with_sink(
793
+ reader,
794
+ is_document,
795
+ &options,
796
+ sink,
797
+ context,
798
+ |_, _| {},
799
+ )
800
+ .map_err(|error| Error::new(Status::GenericFailure, error.to_string()))?
801
+ }