@selenium/atoms 4.51.0 → 4.52.0

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 (331) hide show
  1. package/dist/index.d.ts +40 -0
  2. package/dist/index.d.ts.map +1 -1
  3. package/dist/index.js +40 -0
  4. package/dist/index.js.map +1 -1
  5. package/dist/typescript/active-element.d.ts +2 -0
  6. package/dist/typescript/active-element.d.ts.map +1 -0
  7. package/dist/typescript/active-element.js +19 -0
  8. package/dist/typescript/active-element.js.map +1 -0
  9. package/dist/typescript/clear-local-storage.d.ts +3 -0
  10. package/dist/typescript/clear-local-storage.d.ts.map +1 -0
  11. package/dist/typescript/clear-local-storage.js +25 -0
  12. package/dist/typescript/clear-local-storage.js.map +1 -0
  13. package/dist/typescript/clear-session-storage.d.ts +3 -0
  14. package/dist/typescript/clear-session-storage.d.ts.map +1 -0
  15. package/dist/typescript/clear-session-storage.js +25 -0
  16. package/dist/typescript/clear-session-storage.js.map +1 -0
  17. package/dist/typescript/clear.d.ts +3 -0
  18. package/dist/typescript/clear.d.ts.map +1 -0
  19. package/dist/typescript/clear.js +67 -0
  20. package/dist/typescript/clear.js.map +1 -0
  21. package/dist/typescript/click.d.ts +4 -0
  22. package/dist/typescript/click.d.ts.map +1 -0
  23. package/dist/typescript/click.js +52 -0
  24. package/dist/typescript/click.js.map +1 -0
  25. package/dist/typescript/core/attribute.d.ts +3 -0
  26. package/dist/typescript/core/attribute.d.ts.map +1 -0
  27. package/dist/typescript/core/attribute.js +60 -0
  28. package/dist/typescript/core/attribute.js.map +1 -0
  29. package/dist/typescript/core/color.d.ts +2 -0
  30. package/dist/typescript/core/color.d.ts.map +1 -0
  31. package/dist/typescript/core/color.js +248 -0
  32. package/dist/typescript/core/color.js.map +1 -0
  33. package/dist/typescript/core/editable.d.ts +5 -0
  34. package/dist/typescript/core/editable.d.ts.map +1 -0
  35. package/dist/typescript/core/editable.js +55 -0
  36. package/dist/typescript/core/editable.js.map +1 -0
  37. package/dist/typescript/core/element.d.ts +6 -0
  38. package/dist/typescript/core/element.d.ts.map +1 -0
  39. package/dist/typescript/core/element.js +97 -0
  40. package/dist/typescript/core/element.js.map +1 -0
  41. package/dist/typescript/core/enabled.d.ts +2 -0
  42. package/dist/typescript/core/enabled.d.ts.map +1 -0
  43. package/dist/typescript/core/enabled.js +69 -0
  44. package/dist/typescript/core/enabled.js.map +1 -0
  45. package/dist/typescript/core/error.d.ts +13 -0
  46. package/dist/typescript/core/error.d.ts.map +1 -0
  47. package/dist/typescript/core/error.js +40 -0
  48. package/dist/typescript/core/error.js.map +1 -0
  49. package/dist/typescript/core/events.d.ts +91 -0
  50. package/dist/typescript/core/events.d.ts.map +1 -0
  51. package/dist/typescript/core/events.js +131 -0
  52. package/dist/typescript/core/events.js.map +1 -0
  53. package/dist/typescript/core/focus.d.ts +4 -0
  54. package/dist/typescript/core/focus.d.ts.map +1 -0
  55. package/dist/typescript/core/focus.js +88 -0
  56. package/dist/typescript/core/focus.js.map +1 -0
  57. package/dist/typescript/core/focusable.d.ts +2 -0
  58. package/dist/typescript/core/focusable.d.ts.map +1 -0
  59. package/dist/typescript/core/focusable.js +36 -0
  60. package/dist/typescript/core/focusable.js.map +1 -0
  61. package/dist/typescript/core/form.d.ts +2 -0
  62. package/dist/typescript/core/form.d.ts.map +1 -0
  63. package/dist/typescript/core/form.js +76 -0
  64. package/dist/typescript/core/form.js.map +1 -0
  65. package/dist/typescript/core/frame.d.ts +8 -0
  66. package/dist/typescript/core/frame.d.ts.map +1 -0
  67. package/dist/typescript/core/frame.js +95 -0
  68. package/dist/typescript/core/frame.js.map +1 -0
  69. package/dist/typescript/core/geometry.d.ts +28 -0
  70. package/dist/typescript/core/geometry.d.ts.map +1 -0
  71. package/dist/typescript/core/geometry.js +134 -0
  72. package/dist/typescript/core/geometry.js.map +1 -0
  73. package/dist/typescript/core/inject.d.ts +21 -0
  74. package/dist/typescript/core/inject.d.ts.map +1 -0
  75. package/dist/typescript/core/inject.js +282 -0
  76. package/dist/typescript/core/inject.js.map +1 -0
  77. package/dist/typescript/core/interactable.d.ts +2 -0
  78. package/dist/typescript/core/interactable.d.ts.map +1 -0
  79. package/dist/typescript/core/interactable.js +27 -0
  80. package/dist/typescript/core/interactable.js.map +1 -0
  81. package/dist/typescript/core/keyboard.d.ts +15 -0
  82. package/dist/typescript/core/keyboard.d.ts.map +1 -0
  83. package/dist/typescript/core/keyboard.js +356 -0
  84. package/dist/typescript/core/keyboard.js.map +1 -0
  85. package/dist/typescript/core/keys.d.ts +65 -0
  86. package/dist/typescript/core/keys.d.ts.map +1 -0
  87. package/dist/typescript/core/keys.js +125 -0
  88. package/dist/typescript/core/keys.js.map +1 -0
  89. package/dist/typescript/core/locators.d.ts +6 -0
  90. package/dist/typescript/core/locators.d.ts.map +1 -0
  91. package/dist/typescript/core/locators.js +610 -0
  92. package/dist/typescript/core/locators.js.map +1 -0
  93. package/dist/typescript/core/mouse.d.ts +17 -0
  94. package/dist/typescript/core/mouse.d.ts.map +1 -0
  95. package/dist/typescript/core/mouse.js +186 -0
  96. package/dist/typescript/core/mouse.js.map +1 -0
  97. package/dist/typescript/core/overflow.d.ts +5 -0
  98. package/dist/typescript/core/overflow.d.ts.map +1 -0
  99. package/dist/typescript/core/overflow.js +133 -0
  100. package/dist/typescript/core/overflow.js.map +1 -0
  101. package/dist/typescript/core/scroll.d.ts +3 -0
  102. package/dist/typescript/core/scroll.d.ts.map +1 -0
  103. package/dist/typescript/core/scroll.js +77 -0
  104. package/dist/typescript/core/scroll.js.map +1 -0
  105. package/dist/typescript/core/shown.d.ts +3 -0
  106. package/dist/typescript/core/shown.d.ts.map +1 -0
  107. package/dist/typescript/core/shown.js +190 -0
  108. package/dist/typescript/core/shown.js.map +1 -0
  109. package/dist/typescript/core/storage.d.ts +14 -0
  110. package/dist/typescript/core/storage.d.ts.map +1 -0
  111. package/dist/typescript/core/storage.js +98 -0
  112. package/dist/typescript/core/storage.js.map +1 -0
  113. package/dist/typescript/core/style.d.ts +2 -0
  114. package/dist/typescript/core/style.d.ts.map +1 -0
  115. package/dist/typescript/core/style.js +32 -0
  116. package/dist/typescript/core/style.js.map +1 -0
  117. package/dist/typescript/core/useragent.d.ts +3 -0
  118. package/dist/typescript/core/useragent.d.ts.map +1 -0
  119. package/dist/typescript/core/useragent.js +31 -0
  120. package/dist/typescript/core/useragent.js.map +1 -0
  121. package/dist/typescript/default-content.d.ts +2 -0
  122. package/dist/typescript/default-content.d.ts.map +1 -0
  123. package/dist/typescript/default-content.js +20 -0
  124. package/dist/typescript/default-content.js.map +1 -0
  125. package/dist/typescript/execute-async-script.d.ts +2 -0
  126. package/dist/typescript/execute-async-script.d.ts.map +1 -0
  127. package/dist/typescript/execute-async-script.js +20 -0
  128. package/dist/typescript/execute-async-script.js.map +1 -0
  129. package/dist/typescript/execute-script.d.ts +2 -0
  130. package/dist/typescript/execute-script.d.ts.map +1 -0
  131. package/dist/typescript/execute-script.js +20 -0
  132. package/dist/typescript/execute-script.js.map +1 -0
  133. package/dist/typescript/find-element-fragment.d.ts +8 -0
  134. package/dist/typescript/find-element-fragment.d.ts.map +1 -0
  135. package/dist/typescript/find-element-fragment.js +39 -0
  136. package/dist/typescript/find-element-fragment.js.map +1 -0
  137. package/dist/typescript/find-element.d.ts +2 -0
  138. package/dist/typescript/find-element.d.ts.map +1 -0
  139. package/dist/typescript/find-element.js +18 -0
  140. package/dist/typescript/find-element.js.map +1 -0
  141. package/dist/typescript/find-elements.d.ts +1 -2
  142. package/dist/typescript/find-elements.d.ts.map +1 -1
  143. package/dist/typescript/find-elements.js +1 -289
  144. package/dist/typescript/find-elements.js.map +1 -1
  145. package/dist/typescript/frame-by-id-or-name.d.ts +2 -0
  146. package/dist/typescript/frame-by-id-or-name.d.ts.map +1 -0
  147. package/dist/typescript/frame-by-id-or-name.js +22 -0
  148. package/dist/typescript/frame-by-id-or-name.js.map +1 -0
  149. package/dist/typescript/frame-by-index.d.ts +2 -0
  150. package/dist/typescript/frame-by-index.d.ts.map +1 -0
  151. package/dist/typescript/frame-by-index.js +19 -0
  152. package/dist/typescript/frame-by-index.js.map +1 -0
  153. package/dist/typescript/get-attribute-value.d.ts +2 -0
  154. package/dist/typescript/get-attribute-value.d.ts.map +1 -0
  155. package/dist/typescript/get-attribute-value.js +22 -0
  156. package/dist/typescript/get-attribute-value.js.map +1 -0
  157. package/dist/typescript/get-effective-style.d.ts +3 -0
  158. package/dist/typescript/get-effective-style.d.ts.map +1 -0
  159. package/dist/typescript/get-effective-style.js +84 -0
  160. package/dist/typescript/get-effective-style.js.map +1 -0
  161. package/dist/typescript/get-element-from-cache.d.ts +2 -0
  162. package/dist/typescript/get-element-from-cache.d.ts.map +1 -0
  163. package/dist/typescript/get-element-from-cache.js +20 -0
  164. package/dist/typescript/get-element-from-cache.js.map +1 -0
  165. package/dist/typescript/get-frame-window.d.ts +2 -0
  166. package/dist/typescript/get-frame-window.d.ts.map +1 -0
  167. package/dist/typescript/get-frame-window.js +22 -0
  168. package/dist/typescript/get-frame-window.js.map +1 -0
  169. package/dist/typescript/get-local-storage-item.d.ts +3 -0
  170. package/dist/typescript/get-local-storage-item.d.ts.map +1 -0
  171. package/dist/typescript/get-local-storage-item.js +25 -0
  172. package/dist/typescript/get-local-storage-item.js.map +1 -0
  173. package/dist/typescript/get-local-storage-key.d.ts +3 -0
  174. package/dist/typescript/get-local-storage-key.d.ts.map +1 -0
  175. package/dist/typescript/get-local-storage-key.js +26 -0
  176. package/dist/typescript/get-local-storage-key.js.map +1 -0
  177. package/dist/typescript/get-local-storage-keys.d.ts +3 -0
  178. package/dist/typescript/get-local-storage-keys.d.ts.map +1 -0
  179. package/dist/typescript/get-local-storage-keys.js +25 -0
  180. package/dist/typescript/get-local-storage-keys.js.map +1 -0
  181. package/dist/typescript/get-local-storage-size.d.ts +3 -0
  182. package/dist/typescript/get-local-storage-size.d.ts.map +1 -0
  183. package/dist/typescript/get-local-storage-size.js +25 -0
  184. package/dist/typescript/get-local-storage-size.js.map +1 -0
  185. package/dist/typescript/get-location.d.ts +9 -0
  186. package/dist/typescript/get-location.d.ts.map +1 -0
  187. package/dist/typescript/get-location.js +49 -0
  188. package/dist/typescript/get-location.js.map +1 -0
  189. package/dist/typescript/get-session-storage-item.d.ts +3 -0
  190. package/dist/typescript/get-session-storage-item.d.ts.map +1 -0
  191. package/dist/typescript/get-session-storage-item.js +25 -0
  192. package/dist/typescript/get-session-storage-item.js.map +1 -0
  193. package/dist/typescript/get-session-storage-key.d.ts +3 -0
  194. package/dist/typescript/get-session-storage-key.d.ts.map +1 -0
  195. package/dist/typescript/get-session-storage-key.js +26 -0
  196. package/dist/typescript/get-session-storage-key.js.map +1 -0
  197. package/dist/typescript/get-session-storage-keys.d.ts +3 -0
  198. package/dist/typescript/get-session-storage-keys.d.ts.map +1 -0
  199. package/dist/typescript/get-session-storage-keys.js +25 -0
  200. package/dist/typescript/get-session-storage-keys.js.map +1 -0
  201. package/dist/typescript/get-session-storage-size.d.ts +3 -0
  202. package/dist/typescript/get-session-storage-size.d.ts.map +1 -0
  203. package/dist/typescript/get-session-storage-size.js +25 -0
  204. package/dist/typescript/get-session-storage-size.js.map +1 -0
  205. package/dist/typescript/get-size.d.ts +7 -0
  206. package/dist/typescript/get-size.d.ts.map +1 -0
  207. package/dist/typescript/get-size.js +36 -0
  208. package/dist/typescript/get-size.js.map +1 -0
  209. package/dist/typescript/get-text.d.ts +3 -0
  210. package/dist/typescript/get-text.d.ts.map +1 -0
  211. package/dist/typescript/get-text.js +294 -0
  212. package/dist/typescript/get-text.js.map +1 -0
  213. package/dist/typescript/get-top-left-coordinates.d.ts +4 -0
  214. package/dist/typescript/get-top-left-coordinates.d.ts.map +1 -0
  215. package/dist/typescript/get-top-left-coordinates.js +36 -0
  216. package/dist/typescript/get-top-left-coordinates.js.map +1 -0
  217. package/dist/typescript/is-displayed.d.ts +1 -2
  218. package/dist/typescript/is-displayed.d.ts.map +1 -1
  219. package/dist/typescript/is-displayed.js +3 -396
  220. package/dist/typescript/is-displayed.js.map +1 -1
  221. package/dist/typescript/is-editable.d.ts +2 -0
  222. package/dist/typescript/is-editable.d.ts.map +1 -0
  223. package/dist/typescript/is-editable.js +18 -0
  224. package/dist/typescript/is-editable.js.map +1 -0
  225. package/dist/typescript/is-enabled.d.ts +2 -0
  226. package/dist/typescript/is-enabled.d.ts.map +1 -0
  227. package/dist/typescript/is-enabled.js +18 -0
  228. package/dist/typescript/is-enabled.js.map +1 -0
  229. package/dist/typescript/is-focusable.d.ts +2 -0
  230. package/dist/typescript/is-focusable.d.ts.map +1 -0
  231. package/dist/typescript/is-focusable.js +20 -0
  232. package/dist/typescript/is-focusable.js.map +1 -0
  233. package/dist/typescript/is-interactable.d.ts +2 -0
  234. package/dist/typescript/is-interactable.d.ts.map +1 -0
  235. package/dist/typescript/is-interactable.js +19 -0
  236. package/dist/typescript/is-interactable.js.map +1 -0
  237. package/dist/typescript/is-selected.d.ts +3 -0
  238. package/dist/typescript/is-selected.d.ts.map +1 -0
  239. package/dist/typescript/is-selected.js +29 -0
  240. package/dist/typescript/is-selected.js.map +1 -0
  241. package/dist/typescript/remove-local-storage-item.d.ts +3 -0
  242. package/dist/typescript/remove-local-storage-item.d.ts.map +1 -0
  243. package/dist/typescript/remove-local-storage-item.js +25 -0
  244. package/dist/typescript/remove-local-storage-item.js.map +1 -0
  245. package/dist/typescript/remove-session-storage-item.d.ts +3 -0
  246. package/dist/typescript/remove-session-storage-item.d.ts.map +1 -0
  247. package/dist/typescript/remove-session-storage-item.js +25 -0
  248. package/dist/typescript/remove-session-storage-item.js.map +1 -0
  249. package/dist/typescript/set-local-storage-item.d.ts +3 -0
  250. package/dist/typescript/set-local-storage-item.d.ts.map +1 -0
  251. package/dist/typescript/set-local-storage-item.js +26 -0
  252. package/dist/typescript/set-local-storage-item.js.map +1 -0
  253. package/dist/typescript/set-session-storage-item.d.ts +3 -0
  254. package/dist/typescript/set-session-storage-item.d.ts.map +1 -0
  255. package/dist/typescript/set-session-storage-item.js +26 -0
  256. package/dist/typescript/set-session-storage-item.js.map +1 -0
  257. package/dist/typescript/submit.d.ts +3 -0
  258. package/dist/typescript/submit.d.ts.map +1 -0
  259. package/dist/typescript/submit.js +50 -0
  260. package/dist/typescript/submit.js.map +1 -0
  261. package/dist/typescript/type.d.ts +3 -0
  262. package/dist/typescript/type.d.ts.map +1 -0
  263. package/dist/typescript/type.js +201 -0
  264. package/dist/typescript/type.js.map +1 -0
  265. package/index.ts +40 -0
  266. package/package.json +292 -5
  267. package/typescript/active-element.ts +19 -0
  268. package/typescript/clear-local-storage.ts +27 -0
  269. package/typescript/clear-session-storage.ts +27 -0
  270. package/typescript/clear.ts +73 -0
  271. package/typescript/click.ts +55 -0
  272. package/typescript/core/attribute.ts +68 -0
  273. package/typescript/core/color.ts +257 -0
  274. package/typescript/core/editable.ts +63 -0
  275. package/typescript/core/element.ts +110 -0
  276. package/typescript/core/enabled.ts +76 -0
  277. package/typescript/core/error.ts +41 -0
  278. package/typescript/core/events.ts +268 -0
  279. package/typescript/core/focus.ts +92 -0
  280. package/typescript/core/focusable.ts +38 -0
  281. package/typescript/core/form.ts +81 -0
  282. package/typescript/core/frame.ts +105 -0
  283. package/typescript/core/geometry.ts +183 -0
  284. package/typescript/core/inject.ts +336 -0
  285. package/typescript/core/interactable.ts +30 -0
  286. package/typescript/core/keyboard.ts +369 -0
  287. package/typescript/core/keys.ts +204 -0
  288. package/typescript/core/locators.ts +704 -0
  289. package/typescript/core/mouse.ts +211 -0
  290. package/typescript/core/overflow.ts +172 -0
  291. package/typescript/core/scroll.ts +92 -0
  292. package/typescript/core/shown.ts +233 -0
  293. package/typescript/core/storage.ts +111 -0
  294. package/typescript/core/style.ts +32 -0
  295. package/typescript/core/useragent.ts +33 -0
  296. package/typescript/default-content.ts +20 -0
  297. package/typescript/execute-async-script.ts +20 -0
  298. package/typescript/execute-script.ts +20 -0
  299. package/typescript/find-element-fragment.ts +45 -0
  300. package/typescript/find-element.ts +18 -0
  301. package/typescript/find-elements.ts +1 -326
  302. package/typescript/frame-by-id-or-name.ts +22 -0
  303. package/typescript/frame-by-index.ts +19 -0
  304. package/typescript/get-attribute-value.ts +22 -0
  305. package/typescript/get-effective-style.ts +93 -0
  306. package/typescript/get-element-from-cache.ts +20 -0
  307. package/typescript/get-frame-window.ts +22 -0
  308. package/typescript/get-local-storage-item.ts +27 -0
  309. package/typescript/get-local-storage-key.ts +28 -0
  310. package/typescript/get-local-storage-keys.ts +27 -0
  311. package/typescript/get-local-storage-size.ts +27 -0
  312. package/typescript/get-location.ts +63 -0
  313. package/typescript/get-session-storage-item.ts +27 -0
  314. package/typescript/get-session-storage-key.ts +28 -0
  315. package/typescript/get-session-storage-keys.ts +27 -0
  316. package/typescript/get-session-storage-size.ts +27 -0
  317. package/typescript/get-size.ts +43 -0
  318. package/typescript/get-text.ts +353 -0
  319. package/typescript/get-top-left-coordinates.ts +38 -0
  320. package/typescript/is-displayed.ts +3 -498
  321. package/typescript/is-editable.ts +18 -0
  322. package/typescript/is-enabled.ts +18 -0
  323. package/typescript/is-focusable.ts +20 -0
  324. package/typescript/is-interactable.ts +19 -0
  325. package/typescript/is-selected.ts +31 -0
  326. package/typescript/remove-local-storage-item.ts +27 -0
  327. package/typescript/remove-session-storage-item.ts +27 -0
  328. package/typescript/set-local-storage-item.ts +28 -0
  329. package/typescript/set-session-storage-item.ts +28 -0
  330. package/typescript/submit.ts +53 -0
  331. package/typescript/type.ts +210 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mouse.d.ts","sourceRoot":"","sources":["../../../typescript/core/mouse.ts"],"names":[],"mappings":"AAqDA,qBAAa,KAAK;IAChB,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,oBAAoB,CAAQ;IAIpC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAiB/D,WAAW,IAAI,IAAI;IAsBnB,aAAa,IAAI,IAAI;IAqBrB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,IAAI;CAiBb"}
@@ -0,0 +1,186 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+ import { UNKNOWN_ERROR, botError } from './error.js';
18
+ import { EventType, fire } from './events.js';
19
+ import { focusOnElement, getActiveElementFrom } from './focus.js';
20
+ import { getClientRect } from './geometry.js';
21
+ import { isInteractable } from './interactable.js';
22
+ // A virtual mouse that produces what a real one does with its primary button,
23
+ // in the order Chrome produces for a real click (recorded 2026-10-13):
24
+ //
25
+ // move: pointerout, pointerleave*, pointerover, pointerenter*,
26
+ // mouseout, mouseleave*, mouseover, mouseenter*,
27
+ // pointermove, mousemove
28
+ // press: pointerdown, mousedown, then focus
29
+ // release: pointerup, mouseup, click
30
+ //
31
+ // The click itself runs the target's activation behaviour natively -- links
32
+ // navigate, checkboxes toggle with input and change, labels forward to their
33
+ // control, submit buttons submit -- so none of that is simulated here.
34
+ //
35
+ // Replaces bot.Mouse for the click atom. Differences, all toward real input:
36
+ // - Pointer events and mouseenter/mouseleave are fired; bot.Mouse fired
37
+ // neither. Enter and leave go to every ancestor up to the common one.
38
+ // - A cancelled pointerdown suppresses mousedown and mouseup (and so the
39
+ // focus change) but not the click, as Pointer Events specifies.
40
+ // - Releasing over a different element clicks the nearest common ancestor,
41
+ // as UI Events specifies; bot.Mouse clicked nothing.
42
+ // - Focus and the mousedown-handler-moved-focus check apply in every engine;
43
+ // bot.Mouse only checked in Firefox.
44
+ // - Links are not followed by hand. Firefox already follows a dispatched
45
+ // click, so bot.Mouse navigated there twice.
46
+ // - Only the primary button; nothing reaches double, middle or right clicks.
47
+ // What a pointer event reports in `button` when no button changed: move, over,
48
+ // out, enter and leave. The compatibility mouse events report 0 instead, as
49
+ // Chrome and Firefox do for real input.
50
+ const NO_BUTTON = -1;
51
+ export class Mouse {
52
+ constructor() {
53
+ this.element = null;
54
+ this.clientX = 0;
55
+ this.clientY = 0;
56
+ this.pressedOn = null;
57
+ this.pointerdownCancelled = false;
58
+ }
59
+ // Moves the pointer to `offset` within the element's client rect, or to its
60
+ // centre.
61
+ move(element, offset) {
62
+ // An element interactable when the move starts gets the whole sequence,
63
+ // even if a handler hides it partway through.
64
+ const interactable = isInteractable(element);
65
+ const rect = getClientRect(element);
66
+ this.clientX = rect.left + (offset ? offset.x : rect.width / 2);
67
+ this.clientY = rect.top + (offset ? offset.y : rect.height / 2);
68
+ const from = this.element;
69
+ if (element !== from) {
70
+ this.transition(from, element, interactable);
71
+ this.element = element;
72
+ }
73
+ this.fire(element, EventType.POINTERMOVE, { button: NO_BUTTON, detail: 0 }, interactable);
74
+ this.fire(element, EventType.MOUSEMOVE, { detail: 0 }, interactable);
75
+ }
76
+ pressButton() {
77
+ if (this.pressedOn) {
78
+ throw botError(UNKNOWN_ERROR, 'Cannot press more than one button or an already pressed button.');
79
+ }
80
+ const element = this.current();
81
+ this.pressedOn = element;
82
+ const interactable = isInteractable(element);
83
+ this.pointerdownCancelled = !this.fire(element, EventType.POINTERDOWN, { buttons: 1, detail: 0 }, interactable);
84
+ if (this.pointerdownCancelled || !interactable) {
85
+ return;
86
+ }
87
+ // Focus is mousedown's default action: cancelling mousedown keeps focus
88
+ // where it was, and so does a handler that moved focus itself.
89
+ const focusedBefore = getActiveElementFrom(element);
90
+ if (this.fire(element, EventType.MOUSEDOWN, { buttons: 1, detail: 1 }, interactable)) {
91
+ if (getActiveElementFrom(element) === focusedBefore) {
92
+ focusOnElement(element);
93
+ }
94
+ }
95
+ }
96
+ releaseButton() {
97
+ const pressedOn = this.pressedOn;
98
+ if (!pressedOn) {
99
+ throw botError(UNKNOWN_ERROR, 'Cannot release a button when no button is pressed.');
100
+ }
101
+ this.pressedOn = null;
102
+ const element = this.current();
103
+ // A mouseup that completes a click is followed by the click even if the
104
+ // mouseup handler made the element non-interactable.
105
+ const interactable = isInteractable(element);
106
+ this.fire(element, EventType.POINTERUP, { buttons: 0, detail: 0 }, interactable);
107
+ if (!this.pointerdownCancelled) {
108
+ this.fire(element, EventType.MOUSEUP, { buttons: 0, detail: 1 }, interactable);
109
+ }
110
+ const clickTarget = commonAncestor(pressedOn, element);
111
+ if (clickTarget) {
112
+ this.fire(clickTarget, EventType.CLICK, { buttons: 0, detail: 1 }, interactable);
113
+ }
114
+ }
115
+ current() {
116
+ if (!this.element) {
117
+ throw botError(UNKNOWN_ERROR, 'The mouse has not been moved to an element.');
118
+ }
119
+ return this.element;
120
+ }
121
+ // out/leave from the old element and over/enter into the new, pointer events
122
+ // first. Enter and leave go to each element whose subtree the pointer
123
+ // entered or left: every ancestor below the common one. The first move
124
+ // treats the pointer as already over the document, so it enters from the
125
+ // body rather than from outside the window.
126
+ transition(from, to, interactable) {
127
+ var _a;
128
+ const fromWindowOpen = from && !((_a = from.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.closed);
129
+ const source = fromWindowOpen ? from : null;
130
+ const common = source ? commonAncestor(source, to) : to.ownerDocument.body;
131
+ const left = source ? chain(source, common) : [];
132
+ const entered = chain(to, common).reverse();
133
+ const pairs = [
134
+ [EventType.POINTEROUT, EventType.POINTERLEAVE, EventType.POINTEROVER, EventType.POINTERENTER, NO_BUTTON],
135
+ [EventType.MOUSEOUT, EventType.MOUSELEAVE, EventType.MOUSEOVER, EventType.MOUSEENTER, 0],
136
+ ];
137
+ for (const [out, leave, over, enter, button] of pairs) {
138
+ if (source) {
139
+ this.fire(source, out, { relatedTarget: to, button }, true);
140
+ for (const element of left) {
141
+ this.fire(element, leave, { relatedTarget: to, button }, true);
142
+ }
143
+ }
144
+ this.fire(to, over, { relatedTarget: source, button }, interactable);
145
+ for (const element of entered) {
146
+ this.fire(element, enter, { relatedTarget: source, button }, interactable);
147
+ }
148
+ }
149
+ }
150
+ // Events go only to an element that was interactable at the start of the
151
+ // step; `interactable` carries that decision.
152
+ fire(target, type, args, interactable) {
153
+ if (!interactable) {
154
+ return false;
155
+ }
156
+ return fire(target, type, Object.assign({ clientX: this.clientX, clientY: this.clientY, button: 0, buttons: this.pressedOn ? 1 : 0 }, args));
157
+ }
158
+ }
159
+ // The element and its ancestors up to, but not including, `stop`.
160
+ function chain(element, stop) {
161
+ const result = [];
162
+ for (let node = element; node && node !== stop; node = parentInComposedTree(node)) {
163
+ result.push(node);
164
+ }
165
+ return result;
166
+ }
167
+ function parentInComposedTree(element) {
168
+ if (element.parentElement) {
169
+ return element.parentElement;
170
+ }
171
+ const root = element.parentNode;
172
+ return root instanceof ShadowRoot ? root.host : null;
173
+ }
174
+ function commonAncestor(a, b) {
175
+ const ancestors = new Set();
176
+ for (let node = a; node; node = parentInComposedTree(node)) {
177
+ ancestors.add(node);
178
+ }
179
+ for (let node = b; node; node = parentInComposedTree(node)) {
180
+ if (ancestors.has(node)) {
181
+ return node;
182
+ }
183
+ }
184
+ return null;
185
+ }
186
+ //# sourceMappingURL=mouse.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mouse.js","sourceRoot":"","sources":["../../../typescript/core/mouse.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import { RectReader, Region } from './geometry.js';
2
+ export type OverflowState = 'none' | 'hidden' | 'scroll';
3
+ export type StyleReader = (elem: Element, propertyName: string) => string | null;
4
+ export declare function getOverflowState(elem: Element, optRegion?: Region, getStyle?: StyleReader, getRect?: RectReader): OverflowState;
5
+ //# sourceMappingURL=overflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"overflow.d.ts","sourceRoot":"","sources":["../../../typescript/core/overflow.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAoB,UAAU,EAAE,MAAM,EAAkC,MAAM,eAAe,CAAA;AAGpG,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAKzD,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;AAajF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,GAAE,WAA+B,EACzC,OAAO,GAAE,UAA0B,GAClC,aAAa,CA+Hf"}
@@ -0,0 +1,133 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+ import { getParentElement } from './element.js';
18
+ import { getClientRect, getClientRegion } from './geometry.js';
19
+ import { getEffectiveStyle } from './style.js';
20
+ // Whether the element -- or the given sub-region of it -- is clipped by an
21
+ // ancestor, and if so whether scrolling could bring it into view.
22
+ //
23
+ // optRegion applies only to the element asked about. The recursive calls that
24
+ // walk up the ancestors deliberately pass no region, matching
25
+ // bot.dom.getOverflowState.
26
+ export function getOverflowState(elem, optRegion, getStyle = getEffectiveStyle, getRect = getClientRect) {
27
+ var region = getClientRegion(elem, optRegion, getRect);
28
+ var ownerDoc = elem.ownerDocument;
29
+ var htmlElem = ownerDoc.documentElement;
30
+ var bodyElem = ownerDoc.body;
31
+ var htmlOverflowStyle = getStyle(htmlElem, 'overflow') || 'visible';
32
+ var treatAsFixedPosition = false;
33
+ function canBeOverflowed(container, position) {
34
+ if (container === htmlElem) {
35
+ return true;
36
+ }
37
+ var display = getStyle(container, 'display') || '';
38
+ if (display.indexOf('inline') === 0 || display === 'contents') {
39
+ return false;
40
+ }
41
+ if (position === 'absolute' && getStyle(container, 'position') === 'static') {
42
+ return false;
43
+ }
44
+ return true;
45
+ }
46
+ function getOverflowParent(current) {
47
+ var position = getStyle(current, 'position');
48
+ if (position === 'fixed') {
49
+ treatAsFixedPosition = true;
50
+ return current === htmlElem ? null : htmlElem;
51
+ }
52
+ var parent = getParentElement(current);
53
+ while (parent && !canBeOverflowed(parent, position)) {
54
+ parent = getParentElement(parent);
55
+ }
56
+ return parent;
57
+ }
58
+ function getOverflowStyles(current) {
59
+ var overflowElem = current;
60
+ if (htmlOverflowStyle === 'visible') {
61
+ if (current === htmlElem && bodyElem) {
62
+ overflowElem = bodyElem;
63
+ }
64
+ else if (current === bodyElem) {
65
+ return { x: 'visible', y: 'visible' };
66
+ }
67
+ }
68
+ var overflow = {
69
+ x: getStyle(overflowElem, 'overflow-x') || 'visible',
70
+ y: getStyle(overflowElem, 'overflow-y') || 'visible',
71
+ };
72
+ if (current === htmlElem) {
73
+ overflow.x = overflow.x === 'visible' ? 'auto' : overflow.x;
74
+ overflow.y = overflow.y === 'visible' ? 'auto' : overflow.y;
75
+ }
76
+ return overflow;
77
+ }
78
+ function getScroll(current) {
79
+ if (current === htmlElem) {
80
+ return {
81
+ x: ownerDoc.defaultView ? ownerDoc.defaultView.pageXOffset : 0,
82
+ y: ownerDoc.defaultView ? ownerDoc.defaultView.pageYOffset : 0,
83
+ };
84
+ }
85
+ return { x: current.scrollLeft, y: current.scrollTop };
86
+ }
87
+ function overflowStateOf(container) {
88
+ return getOverflowState(container, undefined, getStyle, getRect);
89
+ }
90
+ for (var container = getOverflowParent(elem); container; container = getOverflowParent(container)) {
91
+ var containerOverflow = getOverflowStyles(container);
92
+ if (containerOverflow.x === 'visible' && containerOverflow.y === 'visible') {
93
+ continue;
94
+ }
95
+ var containerRect = getRect(container);
96
+ if (containerRect.width === 0 || containerRect.height === 0) {
97
+ return 'hidden';
98
+ }
99
+ var underflowsX = region.right < containerRect.left;
100
+ var underflowsY = region.bottom < containerRect.top;
101
+ if ((underflowsX && containerOverflow.x === 'hidden') || (underflowsY && containerOverflow.y === 'hidden')) {
102
+ return 'hidden';
103
+ }
104
+ if ((underflowsX && containerOverflow.x !== 'visible') || (underflowsY && containerOverflow.y !== 'visible')) {
105
+ var containerScroll = getScroll(container);
106
+ var unscrollableX = region.right < containerRect.left - containerScroll.x;
107
+ var unscrollableY = region.bottom < containerRect.top - containerScroll.y;
108
+ if ((unscrollableX && containerOverflow.x !== 'visible') || (unscrollableY && containerOverflow.y !== 'visible')) {
109
+ return 'hidden';
110
+ }
111
+ return overflowStateOf(container) === 'hidden' ? 'hidden' : 'scroll';
112
+ }
113
+ var overflowsX = region.left >= containerRect.left + containerRect.width;
114
+ var overflowsY = region.top >= containerRect.top + containerRect.height;
115
+ if ((overflowsX && containerOverflow.x === 'hidden') || (overflowsY && containerOverflow.y === 'hidden')) {
116
+ return 'hidden';
117
+ }
118
+ if ((overflowsX && containerOverflow.x !== 'visible') || (overflowsY && containerOverflow.y !== 'visible')) {
119
+ if (treatAsFixedPosition) {
120
+ var docScroll = getScroll(container);
121
+ // region.right against scrollHeight is not a transcription slip: the
122
+ // Closure original compares the horizontal edge to the vertical
123
+ // dimension here (dom.js:800) and the ports have always matched it.
124
+ if (region.left >= htmlElem.scrollWidth - docScroll.x || region.right >= htmlElem.scrollHeight - docScroll.y) {
125
+ return 'hidden';
126
+ }
127
+ }
128
+ return overflowStateOf(container) === 'hidden' ? 'hidden' : 'scroll';
129
+ }
130
+ }
131
+ return 'none';
132
+ }
133
+ //# sourceMappingURL=overflow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"overflow.js","sourceRoot":"","sources":["../../../typescript/core/overflow.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { Region } from './geometry.js';
2
+ export declare function scrollIntoView(element: Element, optRegion?: Region): boolean;
3
+ //# sourceMappingURL=scroll.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../../typescript/core/scroll.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAQ,MAAM,EAAkC,MAAM,eAAe,CAAA;AA+B5E,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAwB5E"}
@@ -0,0 +1,77 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+ import { getParentElement } from './element.js';
18
+ import { getClientRect, getClientRegion } from './geometry.js';
19
+ import { getOverflowState } from './overflow.js';
20
+ import { getEffectiveStyle } from './style.js';
21
+ // goog.style.getBorderBox: the computed border widths, which are what separate
22
+ // a container's client rect from its content box.
23
+ function getBorderBox(element) {
24
+ const width = (side) => parseFloat(getEffectiveStyle(element, 'border-' + side + '-width') || '0') || 0;
25
+ return {
26
+ top: width('top'),
27
+ right: width('right'),
28
+ bottom: width('bottom'),
29
+ left: width('left'),
30
+ };
31
+ }
32
+ // Scrolls the element, or the given sub-region of it, into view and reports
33
+ // whether it ended up visible.
34
+ //
35
+ // This is bot.action.scrollIntoView. It lives in core/ rather than with the
36
+ // interaction atoms because it reaches only geometry and overflow -- never
37
+ // events, keyboard, mouse or device. In Closure it was trapped in action.js's
38
+ // module graph and dragged all of that in with it; per-file imports are what
39
+ // let it come out on its own.
40
+ export function scrollIntoView(element, optRegion) {
41
+ // Already in view, or clipped beyond rescuing: either way, no scrolling.
42
+ const overflow = getOverflowState(element, optRegion);
43
+ if (overflow !== 'scroll') {
44
+ return overflow === 'none';
45
+ }
46
+ // Elements under an SVG element may have no scrollIntoView, so only call it
47
+ // where it exists.
48
+ if (typeof element.scrollIntoView === 'function') {
49
+ ;
50
+ element.scrollIntoView();
51
+ if (getOverflowState(element, optRegion) === 'none') {
52
+ return true;
53
+ }
54
+ }
55
+ // Either there was no scrollIntoView, or it did not bring the requested
56
+ // coordinate into view, so scroll each ancestor by hand.
57
+ const region = getClientRegion(element, optRegion);
58
+ for (let container = getParentElement(element); container; container = getParentElement(container)) {
59
+ scrollRegionIntoContainerView(region, container);
60
+ }
61
+ return getOverflowState(element, optRegion) === 'none';
62
+ }
63
+ // Based largely on goog.style.scrollIntoContainerView.
64
+ function scrollRegionIntoContainerView(region, container) {
65
+ const containerRect = getClientRect(container);
66
+ const containerBorder = getBorderBox(container);
67
+ // Position of the region relative to the container's content box.
68
+ const relX = region.left - containerRect.left - containerBorder.left;
69
+ const relY = region.top - containerRect.top - containerBorder.top;
70
+ // How far the region can move inside the container. clientWidth/Height
71
+ // rather than the rect, so the scrollbar is accounted for.
72
+ const spaceX = container.clientWidth + region.left - region.right;
73
+ const spaceY = container.clientHeight + region.top - region.bottom;
74
+ container.scrollLeft += Math.min(relX, Math.max(relX - spaceX, 0));
75
+ container.scrollTop += Math.min(relY, Math.max(relY - spaceY, 0));
76
+ }
77
+ //# sourceMappingURL=scroll.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scroll.js","sourceRoot":"","sources":["../../../typescript/core/scroll.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ declare function isShownElement(elem: Element, optIgnoreOpacity?: boolean): boolean;
2
+ export default isShownElement;
3
+ //# sourceMappingURL=shown.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shown.d.ts","sourceRoot":"","sources":["../../../typescript/core/shown.ts"],"names":[],"mappings":"AA2BA,iBAAS,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,OAAO,GAAG,OAAO,CA2M1E;AAED,eAAe,cAAc,CAAC"}
@@ -0,0 +1,190 @@
1
+ // Licensed to the Software Freedom Conservancy (SFC) under one
2
+ // or more contributor license agreements. See the NOTICE file
3
+ // distributed with this work for additional information
4
+ // regarding copyright ownership. The SFC licenses this file
5
+ // to you under the Apache License, Version 2.0 (the
6
+ // "License"); you may not use this file except in compliance
7
+ // with the License. You may obtain a copy of the License at
8
+ //
9
+ // http://www.apache.org/licenses/LICENSE-2.0
10
+ //
11
+ // Unless required by applicable law or agreed to in writing,
12
+ // software distributed under the License is distributed on an
13
+ // "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
14
+ // KIND, either express or implied. See the License for the
15
+ // specific language governing permissions and limitations
16
+ // under the License.
17
+ import { getParentElement, getParentNodeInComposedDom, isElement } from './element.js';
18
+ import { getClientRect as readClientRect, getClientRegion as readClientRegion, maybeFindImageMap as findImageMap, } from './geometry.js';
19
+ import { getOverflowState as readOverflowState } from './overflow.js';
20
+ function isShownElement(elem, optIgnoreOpacity) {
21
+ // Per-call memoisation caches. Scoped here so they live only for the
22
+ // duration of this synchronous call — no stale-data risk, no GC pressure
23
+ // between invocations. The helpers that read them stay in this scope for
24
+ // the same reason; only the cache-free primitives moved to core/.
25
+ var computedStyleCache = new Map();
26
+ var clientRectCache = new Map();
27
+ var displayedCache = new Map();
28
+ function getEffectiveStyle(elem, propertyName) {
29
+ var computed = computedStyleCache.get(elem);
30
+ if (computed === undefined) {
31
+ var win = elem.ownerDocument.defaultView;
32
+ computed = win ? (win.getComputedStyle(elem) || null) : null;
33
+ computedStyleCache.set(elem, computed);
34
+ }
35
+ if (!computed) {
36
+ return null;
37
+ }
38
+ var value = computed.getPropertyValue(propertyName);
39
+ return value || null;
40
+ }
41
+ function getOpacity(elem) {
42
+ var opacityStyle = getEffectiveStyle(elem, 'opacity');
43
+ var opacity = opacityStyle ? Number(opacityStyle) : 1;
44
+ var parent = getParentElement(elem);
45
+ return parent ? opacity * getOpacity(parent) : opacity;
46
+ }
47
+ // Memoising delegates over the shared geometry primitives. One isDisplayed
48
+ // call reads the same element's rect many times over, so the cache is what
49
+ // keeps that from forcing a reflow each time; the uncached primitives live
50
+ // in core/geometry.ts for every other caller.
51
+ function getClientRect(elem) {
52
+ var cachedRect = clientRectCache.get(elem);
53
+ if (cachedRect) {
54
+ return cachedRect;
55
+ }
56
+ var rect = readClientRect(elem, getClientRect);
57
+ clientRectCache.set(elem, rect);
58
+ return rect;
59
+ }
60
+ function maybeFindImageMap(elem) {
61
+ return findImageMap(elem, getClientRect);
62
+ }
63
+ function getClientRegion(elem) {
64
+ return readClientRegion(elem, undefined, getClientRect);
65
+ }
66
+ // The memoised readers are threaded through so the overflow walk shares this
67
+ // call's caches; isDisplayed asks about the whole element, never a region.
68
+ function getOverflowState(elem) {
69
+ return readOverflowState(elem, undefined, getEffectiveStyle, getClientRect);
70
+ }
71
+ function isShownInternal(elem, ignoreOpacity, displayedFn) {
72
+ if (!isElement(elem)) {
73
+ throw new Error('Argument to isShown must be of type Element');
74
+ }
75
+ if (isElement(elem, 'BODY')) {
76
+ return true;
77
+ }
78
+ if (isElement(elem, 'OPTION') || isElement(elem, 'OPTGROUP')) {
79
+ var select = elem.closest('select');
80
+ return !!select && isShownInternal(select, true, displayedFn);
81
+ }
82
+ var imageMap = maybeFindImageMap(elem);
83
+ if (imageMap) {
84
+ return !!imageMap.image && imageMap.rect.width > 0 && imageMap.rect.height > 0 &&
85
+ isShownInternal(imageMap.image, ignoreOpacity, displayedFn);
86
+ }
87
+ if (isElement(elem, 'INPUT') && elem.type.toLowerCase() === 'hidden') {
88
+ return false;
89
+ }
90
+ if (isElement(elem, 'NOSCRIPT')) {
91
+ return false;
92
+ }
93
+ var visibility = getEffectiveStyle(elem, 'visibility');
94
+ if (visibility === 'collapse' || visibility === 'hidden') {
95
+ return false;
96
+ }
97
+ if (!displayedFn(elem)) {
98
+ return false;
99
+ }
100
+ if (!ignoreOpacity && getOpacity(elem) === 0) {
101
+ return false;
102
+ }
103
+ function positiveSize(element) {
104
+ var rect = getClientRect(element);
105
+ if (rect.height > 0 && rect.width > 0) {
106
+ return true;
107
+ }
108
+ if (isElement(element, 'PATH') && (rect.height > 0 || rect.width > 0)) {
109
+ var strokeWidth = getEffectiveStyle(element, 'stroke-width');
110
+ return !!strokeWidth && parseInt(strokeWidth, 10) > 0;
111
+ }
112
+ var elementVisibility = getEffectiveStyle(element, 'visibility');
113
+ if (elementVisibility === 'collapse' || elementVisibility === 'hidden') {
114
+ return false;
115
+ }
116
+ if (!displayedFn(element)) {
117
+ return false;
118
+ }
119
+ if (getEffectiveStyle(element, 'overflow') === 'hidden') {
120
+ return false;
121
+ }
122
+ for (var index = 0; index < element.childNodes.length; index += 1) {
123
+ var child = element.childNodes[index];
124
+ if (child.nodeType === Node.TEXT_NODE) {
125
+ var text = child.nodeValue || '';
126
+ if (/^[\s]*$/.test(text) && /[\n\r\t]/.test(text)) {
127
+ continue;
128
+ }
129
+ return true;
130
+ }
131
+ if (isElement(child) && positiveSize(child)) {
132
+ return true;
133
+ }
134
+ }
135
+ return false;
136
+ }
137
+ if (!positiveSize(elem)) {
138
+ return false;
139
+ }
140
+ function hiddenByOverflow(element) {
141
+ if (getOverflowState(element) !== 'hidden') {
142
+ return false;
143
+ }
144
+ for (var index = 0; index < element.childNodes.length; index += 1) {
145
+ var child = element.childNodes[index];
146
+ if (isElement(child) && !hiddenByOverflow(child) && positiveSize(child)) {
147
+ return false;
148
+ }
149
+ }
150
+ return true;
151
+ }
152
+ return !hiddenByOverflow(elem);
153
+ }
154
+ function displayed(node) {
155
+ var cached = displayedCache.get(node);
156
+ if (cached !== undefined) {
157
+ return cached;
158
+ }
159
+ if (isElement(node)) {
160
+ var display = getEffectiveStyle(node, 'display');
161
+ var contentVisibility = getEffectiveStyle(node, 'content-visibility');
162
+ if (display === 'none' || contentVisibility === 'hidden') {
163
+ displayedCache.set(node, false);
164
+ return false;
165
+ }
166
+ }
167
+ var parent = getParentNodeInComposedDom(node);
168
+ if (typeof ShadowRoot === 'function' && parent instanceof ShadowRoot) {
169
+ if (parent.host.shadowRoot && parent.host.shadowRoot !== parent) {
170
+ displayedCache.set(node, false);
171
+ return false;
172
+ }
173
+ parent = parent.host;
174
+ }
175
+ if (parent && (parent.nodeType === Node.DOCUMENT_NODE || parent.nodeType === Node.DOCUMENT_FRAGMENT_NODE)) {
176
+ displayedCache.set(node, true);
177
+ return true;
178
+ }
179
+ if (isElement(parent, 'DETAILS') && !parent.open && !isElement(node, 'SUMMARY')) {
180
+ displayedCache.set(node, false);
181
+ return false;
182
+ }
183
+ var result = !!parent && displayed(parent);
184
+ displayedCache.set(node, result);
185
+ return result;
186
+ }
187
+ return isShownInternal(elem, !!optIgnoreOpacity, displayed);
188
+ }
189
+ export default isShownElement;
190
+ //# sourceMappingURL=shown.js.map