tyrell-components 1.0.0-TC8 → 1.0.0-rc.21

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 (386) hide show
  1. package/AGENTS.md +122 -0
  2. package/CHANGELOG.md +1531 -0
  3. package/README.md +71 -53
  4. package/css/tyrell-colors-static.css +1 -0
  5. package/css/tyrell-theme.css +1 -0
  6. package/css/tyrell.css +1 -1783
  7. package/dist/tyrell-colors-static.css +1 -0
  8. package/dist/tyrell-theme.css +1 -0
  9. package/dist/tyrell.css +1 -1783
  10. package/dist/tyrell.js +1 -1
  11. package/guides/AGENT_INSTRUCTIONS.md +124 -0
  12. package/guides/AI_GUIDE.md +53 -0
  13. package/guides/CSS_GUIDE.md +1016 -0
  14. package/guides/DATASTAR_TY_GUIDE.md +657 -0
  15. package/guides/ICONS_GUIDE.md +212 -0
  16. package/guides/TY_GUIDE.md +935 -0
  17. package/guides/clj/CLOJURESCRIPT_GUIDE.md +300 -0
  18. package/guides/clj/CODE_SPLITTING.md +279 -0
  19. package/guides/clj/COMPONENT_GUIDE.md +391 -0
  20. package/guides/clj/HELIX_TY_GUIDE.md +428 -0
  21. package/guides/clj/I18N_GUIDE.md +478 -0
  22. package/guides/clj/LAYOUT_GUIDE.md +273 -0
  23. package/guides/clj/QUICKSTART.md +266 -0
  24. package/guides/clj/REAGENT_TY_GUIDE.md +408 -0
  25. package/guides/clj/REPLICANT_TY_GUIDE.md +623 -0
  26. package/guides/clj/ROUTING_GUIDE.md +346 -0
  27. package/guides/clj/UIX_TY_GUIDE.md +319 -0
  28. package/guides/js/HTMX_TY_GUIDE.md +252 -0
  29. package/guides/js/JAVASCRIPT_GUIDE.md +388 -0
  30. package/guides/js/REACT_TY_GUIDE.md +983 -0
  31. package/guides/js/SVELTE_TY_GUIDE.md +682 -0
  32. package/guides/js/TYCOMPONENT_GUIDE.md +962 -0
  33. package/guides/js/VUE_TY_GUIDE.md +738 -0
  34. package/lib/base/ty-component.d.ts +57 -13
  35. package/lib/base/ty-component.js +266 -292
  36. package/lib/components/button.d.ts +42 -18
  37. package/lib/components/button.js +318 -235
  38. package/lib/components/calendar-month.d.ts +30 -47
  39. package/lib/components/calendar-month.js +455 -429
  40. package/lib/components/calendar-navigation.d.ts +41 -49
  41. package/lib/components/calendar-navigation.js +287 -346
  42. package/lib/components/calendar.d.ts +73 -83
  43. package/lib/components/calendar.js +837 -762
  44. package/lib/components/checkbox.d.ts +26 -75
  45. package/lib/components/checkbox.js +298 -391
  46. package/lib/components/copy.d.ts +20 -60
  47. package/lib/components/copy.js +276 -380
  48. package/lib/components/date-picker.d.ts +100 -183
  49. package/lib/components/date-picker.js +1155 -1570
  50. package/lib/components/file-upload.d.ts +122 -0
  51. package/lib/components/file-upload.js +451 -0
  52. package/lib/components/icon.d.ts +3 -24
  53. package/lib/components/icon.js +141 -230
  54. package/lib/components/input.d.ts +93 -108
  55. package/lib/components/input.js +734 -710
  56. package/lib/components/modal.d.ts +39 -29
  57. package/lib/components/modal.js +419 -438
  58. package/lib/components/option.d.ts +20 -35
  59. package/lib/components/option.js +184 -309
  60. package/lib/components/popup.d.ts +2 -17
  61. package/lib/components/popup.js +353 -347
  62. package/lib/components/radio.d.ts +33 -25
  63. package/lib/components/radio.js +433 -422
  64. package/lib/components/resize-observer.d.ts +3 -30
  65. package/lib/components/resize-observer.js +71 -103
  66. package/lib/components/scroll-container.d.ts +21 -14
  67. package/lib/components/scroll-container.js +292 -234
  68. package/lib/components/select.d.ts +446 -0
  69. package/lib/components/select.js +1381 -0
  70. package/lib/components/selected-tags.d.ts +60 -0
  71. package/lib/components/selected-tags.js +225 -0
  72. package/lib/components/sortable.d.ts +175 -0
  73. package/lib/components/sortable.js +1844 -0
  74. package/lib/components/step.d.ts +1 -6
  75. package/lib/components/step.js +62 -68
  76. package/lib/components/switch.d.ts +15 -15
  77. package/lib/components/switch.js +237 -231
  78. package/lib/components/tab.d.ts +50 -7
  79. package/lib/components/tab.js +203 -69
  80. package/lib/components/tabs.d.ts +19 -64
  81. package/lib/components/tabs.js +600 -618
  82. package/lib/components/tag.d.ts +17 -55
  83. package/lib/components/tag.js +235 -308
  84. package/lib/components/textarea.d.ts +58 -89
  85. package/lib/components/textarea.js +523 -573
  86. package/lib/components/tooltip.d.ts +8 -13
  87. package/lib/components/tooltip.js +322 -409
  88. package/lib/components/wizard.d.ts +7 -54
  89. package/lib/components/wizard.js +376 -606
  90. package/lib/icons/fontawesome/brands.d.ts +0 -1
  91. package/lib/icons/fontawesome/brands.js +0 -8
  92. package/lib/icons/fontawesome/regular.d.ts +0 -1
  93. package/lib/icons/fontawesome/regular.js +0 -8
  94. package/lib/icons/fontawesome/solid.d.ts +0 -1
  95. package/lib/icons/fontawesome/solid.js +0 -8
  96. package/lib/icons/heroicons/micro.d.ts +0 -1
  97. package/lib/icons/heroicons/micro.js +392 -400
  98. package/lib/icons/heroicons/mini.d.ts +0 -1
  99. package/lib/icons/heroicons/mini.js +382 -390
  100. package/lib/icons/heroicons/outline.d.ts +0 -1
  101. package/lib/icons/heroicons/outline.js +337 -345
  102. package/lib/icons/heroicons/solid.d.ts +0 -1
  103. package/lib/icons/heroicons/solid.js +407 -415
  104. package/lib/icons/lucide.d.ts +0 -1
  105. package/lib/icons/lucide.js +24479 -26351
  106. package/lib/icons/material/filled.d.ts +0 -1
  107. package/lib/icons/material/filled.js +9653 -9663
  108. package/lib/icons/material/outlined.d.ts +0 -1
  109. package/lib/icons/material/outlined.js +10271 -10281
  110. package/lib/icons/material/round.d.ts +0 -1
  111. package/lib/icons/material/round.js +10495 -10505
  112. package/lib/icons/material/sharp.d.ts +0 -1
  113. package/lib/icons/material/sharp.js +9905 -9915
  114. package/lib/icons/material/two-tone.d.ts +0 -1
  115. package/lib/icons/material/two-tone.js +12792 -12802
  116. package/lib/index.d.ts +15 -4
  117. package/lib/index.js +28 -38
  118. package/lib/styles/button.d.ts +24 -7
  119. package/lib/styles/button.js +298 -417
  120. package/lib/styles/calendar-month.d.ts +7 -6
  121. package/lib/styles/calendar-month.js +157 -179
  122. package/lib/styles/calendar-navigation.d.ts +2 -6
  123. package/lib/styles/calendar-navigation.js +108 -109
  124. package/lib/styles/calendar.d.ts +3 -3
  125. package/lib/styles/calendar.js +87 -23
  126. package/lib/styles/checkbox.d.ts +7 -6
  127. package/lib/styles/checkbox.js +101 -15
  128. package/lib/styles/copy.d.ts +3 -2
  129. package/lib/styles/copy.js +91 -71
  130. package/lib/styles/custom-scrollbar.d.ts +1 -2
  131. package/lib/styles/custom-scrollbar.js +80 -115
  132. package/lib/styles/date-picker.d.ts +4 -6
  133. package/lib/styles/date-picker.js +320 -352
  134. package/lib/styles/field-size.d.ts +6 -0
  135. package/lib/styles/field-size.js +91 -0
  136. package/lib/styles/file-upload.d.ts +1 -0
  137. package/lib/styles/file-upload.js +196 -0
  138. package/lib/styles/icon.d.ts +2 -6
  139. package/lib/styles/icon.js +92 -170
  140. package/lib/styles/input.d.ts +4 -7
  141. package/lib/styles/input.js +148 -643
  142. package/lib/styles/modal.d.ts +1 -2
  143. package/lib/styles/modal.js +127 -108
  144. package/lib/styles/option.d.ts +2 -6
  145. package/lib/styles/option.js +53 -96
  146. package/lib/styles/popup.d.ts +1 -2
  147. package/lib/styles/popup.js +47 -77
  148. package/lib/styles/radio.d.ts +3 -2
  149. package/lib/styles/radio.js +90 -116
  150. package/lib/styles/resize-observer.d.ts +1 -2
  151. package/lib/styles/resize-observer.js +2 -12
  152. package/lib/styles/scroll-container.d.ts +1 -2
  153. package/lib/styles/scroll-container.js +103 -146
  154. package/lib/styles/select-base.d.ts +8 -0
  155. package/lib/styles/select-base.js +747 -0
  156. package/lib/styles/select.d.ts +11 -0
  157. package/lib/styles/select.js +229 -0
  158. package/lib/styles/sortable.d.ts +16 -0
  159. package/lib/styles/sortable.js +85 -0
  160. package/lib/styles/step.d.ts +1 -2
  161. package/lib/styles/step.js +15 -34
  162. package/lib/styles/switch.d.ts +3 -2
  163. package/lib/styles/switch.js +52 -68
  164. package/lib/styles/tab.d.ts +1 -2
  165. package/lib/styles/tab.js +86 -34
  166. package/lib/styles/tabs.d.ts +3 -11
  167. package/lib/styles/tabs.js +204 -162
  168. package/lib/styles/tag.d.ts +2 -6
  169. package/lib/styles/tag.js +170 -359
  170. package/lib/styles/textarea.d.ts +1 -2
  171. package/lib/styles/textarea.js +238 -306
  172. package/lib/styles/tooltip.d.ts +4 -3
  173. package/lib/styles/tooltip.js +3 -131
  174. package/lib/styles/wizard.d.ts +8 -20
  175. package/lib/styles/wizard.js +306 -295
  176. package/lib/types/common.d.ts +9 -8
  177. package/lib/types/common.js +8 -5
  178. package/lib/utils/calendar-utils.d.ts +49 -65
  179. package/lib/utils/calendar-utils.js +158 -343
  180. package/lib/utils/custom-scrollbar.d.ts +6 -20
  181. package/lib/utils/custom-scrollbar.js +273 -317
  182. package/lib/utils/flavor-sheet.d.ts +31 -0
  183. package/lib/utils/flavor-sheet.js +17 -0
  184. package/lib/utils/icon-registry.d.ts +0 -15
  185. package/lib/utils/icon-registry.js +138 -279
  186. package/lib/utils/icons.d.ts +9 -0
  187. package/lib/utils/icons.js +1 -0
  188. package/lib/utils/loader-registry.d.ts +34 -0
  189. package/lib/utils/loader-registry.js +11 -0
  190. package/lib/utils/locale.d.ts +2 -80
  191. package/lib/utils/locale.js +30 -205
  192. package/lib/utils/mobile.d.ts +0 -1
  193. package/lib/utils/mobile.js +1 -18
  194. package/lib/utils/number-format.d.ts +6 -24
  195. package/lib/utils/number-format.js +53 -136
  196. package/lib/utils/positioning.d.ts +72 -22
  197. package/lib/utils/positioning.js +224 -298
  198. package/lib/utils/property-capture.d.ts +5 -27
  199. package/lib/utils/property-capture.js +36 -144
  200. package/lib/utils/property-manager.d.ts +6 -6
  201. package/lib/utils/property-manager.js +127 -196
  202. package/lib/utils/resize-observer.d.ts +0 -1
  203. package/lib/utils/resize-observer.js +23 -59
  204. package/lib/utils/scroll-lock.d.ts +10 -11
  205. package/lib/utils/scroll-lock.js +165 -173
  206. package/lib/utils/styles.d.ts +0 -6
  207. package/lib/utils/styles.js +17 -48
  208. package/lib/utils/upgrade-properties.d.ts +21 -0
  209. package/lib/utils/upgrade-properties.js +47 -0
  210. package/lib/utils/validity.d.ts +122 -0
  211. package/lib/utils/validity.js +289 -0
  212. package/lib/version.d.ts +1 -2
  213. package/lib/version.js +1 -11
  214. package/package.json +66 -18
  215. package/lib/base/ty-component.d.ts.map +0 -1
  216. package/lib/base/ty-component.js.map +0 -1
  217. package/lib/components/button.d.ts.map +0 -1
  218. package/lib/components/button.js.map +0 -1
  219. package/lib/components/calendar-month.d.ts.map +0 -1
  220. package/lib/components/calendar-month.js.map +0 -1
  221. package/lib/components/calendar-navigation.d.ts.map +0 -1
  222. package/lib/components/calendar-navigation.js.map +0 -1
  223. package/lib/components/calendar.d.ts.map +0 -1
  224. package/lib/components/calendar.js.map +0 -1
  225. package/lib/components/checkbox.d.ts.map +0 -1
  226. package/lib/components/checkbox.js.map +0 -1
  227. package/lib/components/copy.d.ts.map +0 -1
  228. package/lib/components/copy.js.map +0 -1
  229. package/lib/components/date-picker.d.ts.map +0 -1
  230. package/lib/components/date-picker.js.map +0 -1
  231. package/lib/components/dropdown.d.ts +0 -402
  232. package/lib/components/dropdown.d.ts.map +0 -1
  233. package/lib/components/dropdown.js +0 -1564
  234. package/lib/components/dropdown.js.map +0 -1
  235. package/lib/components/icon.d.ts.map +0 -1
  236. package/lib/components/icon.js.map +0 -1
  237. package/lib/components/input.d.ts.map +0 -1
  238. package/lib/components/input.js.map +0 -1
  239. package/lib/components/modal.d.ts.map +0 -1
  240. package/lib/components/modal.js.map +0 -1
  241. package/lib/components/multiselect.d.ts +0 -397
  242. package/lib/components/multiselect.d.ts.map +0 -1
  243. package/lib/components/multiselect.js +0 -1580
  244. package/lib/components/multiselect.js.map +0 -1
  245. package/lib/components/option.d.ts.map +0 -1
  246. package/lib/components/option.js.map +0 -1
  247. package/lib/components/popup.d.ts.map +0 -1
  248. package/lib/components/popup.js.map +0 -1
  249. package/lib/components/radio.d.ts.map +0 -1
  250. package/lib/components/radio.js.map +0 -1
  251. package/lib/components/resize-observer.d.ts.map +0 -1
  252. package/lib/components/resize-observer.js.map +0 -1
  253. package/lib/components/scroll-container.d.ts.map +0 -1
  254. package/lib/components/scroll-container.js.map +0 -1
  255. package/lib/components/step.d.ts.map +0 -1
  256. package/lib/components/step.js.map +0 -1
  257. package/lib/components/switch.d.ts.map +0 -1
  258. package/lib/components/switch.js.map +0 -1
  259. package/lib/components/tab.d.ts.map +0 -1
  260. package/lib/components/tab.js.map +0 -1
  261. package/lib/components/tabs.d.ts.map +0 -1
  262. package/lib/components/tabs.js.map +0 -1
  263. package/lib/components/tag.d.ts.map +0 -1
  264. package/lib/components/tag.js.map +0 -1
  265. package/lib/components/textarea.d.ts.map +0 -1
  266. package/lib/components/textarea.js.map +0 -1
  267. package/lib/components/tooltip.d.ts.map +0 -1
  268. package/lib/components/tooltip.js.map +0 -1
  269. package/lib/components/wizard.d.ts.map +0 -1
  270. package/lib/components/wizard.js.map +0 -1
  271. package/lib/icons/fontawesome/brands.d.ts.map +0 -1
  272. package/lib/icons/fontawesome/brands.js.map +0 -1
  273. package/lib/icons/fontawesome/regular.d.ts.map +0 -1
  274. package/lib/icons/fontawesome/regular.js.map +0 -1
  275. package/lib/icons/fontawesome/solid.d.ts.map +0 -1
  276. package/lib/icons/fontawesome/solid.js.map +0 -1
  277. package/lib/icons/heroicons/micro.d.ts.map +0 -1
  278. package/lib/icons/heroicons/micro.js.map +0 -1
  279. package/lib/icons/heroicons/mini.d.ts.map +0 -1
  280. package/lib/icons/heroicons/mini.js.map +0 -1
  281. package/lib/icons/heroicons/outline.d.ts.map +0 -1
  282. package/lib/icons/heroicons/outline.js.map +0 -1
  283. package/lib/icons/heroicons/solid.d.ts.map +0 -1
  284. package/lib/icons/heroicons/solid.js.map +0 -1
  285. package/lib/icons/lucide.d.ts.map +0 -1
  286. package/lib/icons/lucide.js.map +0 -1
  287. package/lib/icons/material/filled.d.ts.map +0 -1
  288. package/lib/icons/material/filled.js.map +0 -1
  289. package/lib/icons/material/outlined.d.ts.map +0 -1
  290. package/lib/icons/material/outlined.js.map +0 -1
  291. package/lib/icons/material/round.d.ts.map +0 -1
  292. package/lib/icons/material/round.js.map +0 -1
  293. package/lib/icons/material/sharp.d.ts.map +0 -1
  294. package/lib/icons/material/sharp.js.map +0 -1
  295. package/lib/icons/material/two-tone.d.ts.map +0 -1
  296. package/lib/icons/material/two-tone.js.map +0 -1
  297. package/lib/index.d.ts.map +0 -1
  298. package/lib/index.js.map +0 -1
  299. package/lib/styles/button.d.ts.map +0 -1
  300. package/lib/styles/button.js.map +0 -1
  301. package/lib/styles/calendar-month.d.ts.map +0 -1
  302. package/lib/styles/calendar-month.js.map +0 -1
  303. package/lib/styles/calendar-navigation.d.ts.map +0 -1
  304. package/lib/styles/calendar-navigation.js.map +0 -1
  305. package/lib/styles/calendar.d.ts.map +0 -1
  306. package/lib/styles/calendar.js.map +0 -1
  307. package/lib/styles/checkbox.d.ts.map +0 -1
  308. package/lib/styles/checkbox.js.map +0 -1
  309. package/lib/styles/copy.d.ts.map +0 -1
  310. package/lib/styles/copy.js.map +0 -1
  311. package/lib/styles/custom-scrollbar.d.ts.map +0 -1
  312. package/lib/styles/custom-scrollbar.js.map +0 -1
  313. package/lib/styles/date-picker.d.ts.map +0 -1
  314. package/lib/styles/date-picker.js.map +0 -1
  315. package/lib/styles/dropdown.d.ts +0 -12
  316. package/lib/styles/dropdown.d.ts.map +0 -1
  317. package/lib/styles/dropdown.js +0 -983
  318. package/lib/styles/dropdown.js.map +0 -1
  319. package/lib/styles/icon.d.ts.map +0 -1
  320. package/lib/styles/icon.js.map +0 -1
  321. package/lib/styles/input.d.ts.map +0 -1
  322. package/lib/styles/input.js.map +0 -1
  323. package/lib/styles/modal.d.ts.map +0 -1
  324. package/lib/styles/modal.js.map +0 -1
  325. package/lib/styles/multiselect.d.ts +0 -6
  326. package/lib/styles/multiselect.d.ts.map +0 -1
  327. package/lib/styles/multiselect.js +0 -774
  328. package/lib/styles/multiselect.js.map +0 -1
  329. package/lib/styles/option.d.ts.map +0 -1
  330. package/lib/styles/option.js.map +0 -1
  331. package/lib/styles/popup.d.ts.map +0 -1
  332. package/lib/styles/popup.js.map +0 -1
  333. package/lib/styles/radio.d.ts.map +0 -1
  334. package/lib/styles/radio.js.map +0 -1
  335. package/lib/styles/resize-observer.d.ts.map +0 -1
  336. package/lib/styles/resize-observer.js.map +0 -1
  337. package/lib/styles/scroll-container.d.ts.map +0 -1
  338. package/lib/styles/scroll-container.js.map +0 -1
  339. package/lib/styles/step.d.ts.map +0 -1
  340. package/lib/styles/step.js.map +0 -1
  341. package/lib/styles/switch.d.ts.map +0 -1
  342. package/lib/styles/switch.js.map +0 -1
  343. package/lib/styles/tab.d.ts.map +0 -1
  344. package/lib/styles/tab.js.map +0 -1
  345. package/lib/styles/tabs.d.ts.map +0 -1
  346. package/lib/styles/tabs.js.map +0 -1
  347. package/lib/styles/tag.d.ts.map +0 -1
  348. package/lib/styles/tag.js.map +0 -1
  349. package/lib/styles/textarea.d.ts.map +0 -1
  350. package/lib/styles/textarea.js.map +0 -1
  351. package/lib/styles/tooltip.d.ts.map +0 -1
  352. package/lib/styles/tooltip.js.map +0 -1
  353. package/lib/styles/wizard.d.ts.map +0 -1
  354. package/lib/styles/wizard.js.map +0 -1
  355. package/lib/types/common.d.ts.map +0 -1
  356. package/lib/types/common.js.map +0 -1
  357. package/lib/utils/calendar-utils.d.ts.map +0 -1
  358. package/lib/utils/calendar-utils.js.map +0 -1
  359. package/lib/utils/custom-scrollbar.d.ts.map +0 -1
  360. package/lib/utils/custom-scrollbar.js.map +0 -1
  361. package/lib/utils/icon-registry.d.ts.map +0 -1
  362. package/lib/utils/icon-registry.js.map +0 -1
  363. package/lib/utils/locale.d.ts.map +0 -1
  364. package/lib/utils/locale.js.map +0 -1
  365. package/lib/utils/mobile.d.ts.map +0 -1
  366. package/lib/utils/mobile.js.map +0 -1
  367. package/lib/utils/number-format.d.ts.map +0 -1
  368. package/lib/utils/number-format.js.map +0 -1
  369. package/lib/utils/parse-boolean.d.ts +0 -39
  370. package/lib/utils/parse-boolean.d.ts.map +0 -1
  371. package/lib/utils/parse-boolean.js +0 -58
  372. package/lib/utils/parse-boolean.js.map +0 -1
  373. package/lib/utils/positioning.d.ts.map +0 -1
  374. package/lib/utils/positioning.js.map +0 -1
  375. package/lib/utils/property-capture.d.ts.map +0 -1
  376. package/lib/utils/property-capture.js.map +0 -1
  377. package/lib/utils/property-manager.d.ts.map +0 -1
  378. package/lib/utils/property-manager.js.map +0 -1
  379. package/lib/utils/resize-observer.d.ts.map +0 -1
  380. package/lib/utils/resize-observer.js.map +0 -1
  381. package/lib/utils/scroll-lock.d.ts.map +0 -1
  382. package/lib/utils/scroll-lock.js.map +0 -1
  383. package/lib/utils/styles.d.ts.map +0 -1
  384. package/lib/utils/styles.js.map +0 -1
  385. package/lib/version.d.ts.map +0 -1
  386. package/lib/version.js.map +0 -1
@@ -1,15 +1,15 @@
1
1
  /**
2
- * CSS-based scroll prevention using position: fixed.
2
+ * Page scroll lock, reference-counted so multiple components can lock at once.
3
3
  *
4
- * Prevents body/page scrolling by temporarily fixing the body position
5
- * while preserving scroll position. Much more reliable than event prevention.
6
- *
7
- * Key benefits:
8
- * - No event manipulation complexity
9
- * - No interference with component keyboard navigation
10
- * - Preserves scroll position perfectly
11
- * - Standard industry technique
12
- * - Multiple component support with proper cleanup
4
+ * Two parts: overflow: hidden on <html> (the document scroller), and a guard
5
+ * for apps that scroll their own container (a full-height layout with an
6
+ * inner overflow: auto div), which <html> overflow doesn't reach. The guard
7
+ * cancels wheel, touchmove and scroll keys that would scroll anything outside
8
+ * the open dialog they come from (every lock holder is a top-layer <dialog>):
9
+ * scrollers inside the dialog keep working until their edge, nothing chains
10
+ * out of it, and events from the page behind scroll nothing. Keys a control
11
+ * uses itself (text fields, selects, Space on buttons, arrows in widgets) are
12
+ * left alone.
13
13
  */
14
14
  declare global {
15
15
  interface Window {
@@ -76,4 +76,3 @@ export declare function getLockState(): Readonly<{
76
76
  scrollY: number;
77
77
  activeLocks: string[];
78
78
  }>;
79
- //# sourceMappingURL=scroll-lock.d.ts.map
@@ -1,197 +1,189 @@
1
- /**
2
- * CSS-based scroll prevention using position: fixed.
3
- *
4
- * Prevents body/page scrolling by temporarily fixing the body position
5
- * while preserving scroll position. Much more reliable than event prevention.
6
- *
7
- * Key benefits:
8
- * - No event manipulation complexity
9
- * - No interference with component keyboard navigation
10
- * - Preserves scroll position perfectly
11
- * - Standard industry technique
12
- * - Multiple component support with proper cleanup
13
- */
14
- // ============================================================================
15
- // Global State Management
16
- // ============================================================================
17
1
  const lockState = {
18
- locked: false,
19
- scrollY: 0,
20
- activeLocks: new Set(),
2
+ locked: false,
3
+ scrollY: 0,
4
+ activeLocks: new Set(),
21
5
  };
22
- // ============================================================================
23
- // DOM Helper Functions
24
- // ============================================================================
25
- /**
26
- * Get the document body element
27
- */
6
+ let savedStyle = { overflow: '', paddingRight: '' };
28
7
  function getBodyEl() {
29
- return document.body;
8
+ return document.body;
30
9
  }
31
- /**
32
- * Get the document element (html)
33
- */
34
10
  function getDocEl() {
35
- return document.documentElement;
11
+ return document.documentElement;
36
12
  }
37
- /**
38
- * Get current vertical scroll position
39
- */
40
13
  function getScrollY() {
41
- return window.scrollY || getDocEl().scrollTop || 0;
14
+ return window.scrollY || getDocEl().scrollTop || 0;
42
15
  }
43
- /**
44
- * Calculate the width of the browser's scrollbar
45
- */
46
16
  function getScrollbarWidth() {
47
- // window.innerWidth - documentElement.clientWidth
48
- return window.innerWidth - getDocEl().clientWidth;
49
- }
50
- // ============================================================================
51
- // Core Lock/Unlock Functions
52
- // ============================================================================
53
- /**
54
- * Lock body scrolling using overflow: hidden on <html>.
55
- *
56
- * Avoids position: fixed on <body> which breaks centered/max-width body layouts
57
- * by snapping the body to the left edge. Using <html> instead leaves body layout
58
- * untouched while still preventing scroll.
59
- */
17
+ return window.innerWidth - getDocEl().clientWidth;
18
+ }
19
+ const KEY_SCROLL = {
20
+ ArrowDown: ['y', 1], ArrowUp: ['y', -1], PageDown: ['y', 1], PageUp: ['y', -1],
21
+ End: ['y', 1], Home: ['y', -1], ' ': ['y', 1], ArrowRight: ['x', 1], ArrowLeft: ['x', -1],
22
+ };
23
+ const TEXT_INPUT = /^(?:text|search|email|url|tel|password|number|date|datetime-local|month|week|time|range|color)$/;
24
+ function keyBelongsTo(el, key) {
25
+ if (el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement)
26
+ return true;
27
+ if (el instanceof HTMLElement && el.isContentEditable)
28
+ return true;
29
+ if (el instanceof HTMLInputElement) {
30
+ if (TEXT_INPUT.test(el.type))
31
+ return true;
32
+ if (el.type === 'radio' && key.startsWith('Arrow'))
33
+ return true;
34
+ }
35
+ if (key === ' ' && el.matches('button, input, summary, a[href], [role]'))
36
+ return true;
37
+ if (key !== ' ' && el.matches('[role]:not([role=dialog]):not([role=document]):not([role=presentation]):not([role=none])'))
38
+ return true;
39
+ return false;
40
+ }
41
+ function canScroll(el, axis, dir) {
42
+ const style = getComputedStyle(el);
43
+ const overflow = axis === 'y' ? style.overflowY : style.overflowX;
44
+ if (!/^(?:auto|scroll|overlay)$/.test(overflow) && !(el instanceof HTMLTextAreaElement))
45
+ return false;
46
+ const pos = axis === 'y' ? el.scrollTop : Math.abs(el.scrollLeft);
47
+ const max = axis === 'y' ? el.scrollHeight - el.clientHeight : el.scrollWidth - el.clientWidth;
48
+ if (max < 1)
49
+ return false;
50
+ return dir > 0 ? pos < max - 1 : pos > 0;
51
+ }
52
+ const HAS_POPOVER = typeof HTMLElement !== 'undefined' && 'popover' in HTMLElement.prototype;
53
+ function isOpenPopover(el) {
54
+ return HAS_POPOVER && el.hasAttribute('popover') && el.matches(':popover-open');
55
+ }
56
+ function scrollsInside(event, axis, dir) {
57
+ if (!dir)
58
+ return true;
59
+ const path = event.composedPath().filter((n) => n instanceof Element);
60
+ const root = path.findIndex((n) => (n instanceof HTMLDialogElement && n.open) || isOpenPopover(n));
61
+ return root >= 0 && path.slice(0, root + 1).some((n) => canScroll(n, axis, dir));
62
+ }
63
+ function guardWheel(e) {
64
+ if (e.ctrlKey)
65
+ return;
66
+ const axis = Math.abs(e.deltaX) > Math.abs(e.deltaY) || e.shiftKey ? 'x' : 'y';
67
+ const delta = axis === 'y' && !e.shiftKey ? e.deltaY : e.deltaX || e.deltaY;
68
+ if (e.cancelable && !scrollsInside(e, axis, Math.sign(delta)))
69
+ e.preventDefault();
70
+ }
71
+ let touchX = 0;
72
+ let touchY = 0;
73
+ function guardTouchStart(e) {
74
+ if (e.touches.length !== 1)
75
+ return;
76
+ touchX = e.touches[0].clientX;
77
+ touchY = e.touches[0].clientY;
78
+ }
79
+ function guardTouchMove(e) {
80
+ if (e.touches.length !== 1 || !e.cancelable)
81
+ return;
82
+ const { clientX, clientY } = e.touches[0];
83
+ const dx = touchX - clientX;
84
+ const dy = touchY - clientY;
85
+ touchX = clientX;
86
+ touchY = clientY;
87
+ const axis = Math.abs(dx) > Math.abs(dy) ? 'x' : 'y';
88
+ if (!scrollsInside(e, axis, Math.sign(axis === 'y' ? dy : dx)))
89
+ e.preventDefault();
90
+ }
91
+ function guardKey(e) {
92
+ const scroll = KEY_SCROLL[e.key];
93
+ if (!scroll || e.defaultPrevented || e.altKey || e.ctrlKey || e.metaKey)
94
+ return;
95
+ const target = e.composedPath()[0];
96
+ if (target instanceof Element && keyBelongsTo(target, e.key))
97
+ return;
98
+ const [axis, dir] = scroll;
99
+ if (!scrollsInside(e, axis, e.key === ' ' && e.shiftKey ? -dir : dir))
100
+ e.preventDefault();
101
+ }
102
+ const WHEEL_OPTS = { capture: true, passive: false };
103
+ function addGuard() {
104
+ window.addEventListener('wheel', guardWheel, WHEEL_OPTS);
105
+ window.addEventListener('touchstart', guardTouchStart, { capture: true, passive: true });
106
+ window.addEventListener('touchmove', guardTouchMove, WHEEL_OPTS);
107
+ window.addEventListener('keydown', guardKey, true);
108
+ }
109
+ function removeGuard() {
110
+ window.removeEventListener('wheel', guardWheel, WHEEL_OPTS);
111
+ window.removeEventListener('touchstart', guardTouchStart, { capture: true });
112
+ window.removeEventListener('touchmove', guardTouchMove, WHEEL_OPTS);
113
+ window.removeEventListener('keydown', guardKey, true);
114
+ }
60
115
  function lockBodyFixed() {
61
- if (lockState.locked)
62
- return;
63
- const scrollbarWidth = getScrollbarWidth();
64
- const docEl = getDocEl();
65
- if (window.tyScrollDebug) {
66
- console.log('🔒 Locking body scroll:', { scrollbarWidth });
67
- }
68
- lockState.scrollY = getScrollY();
69
- lockState.locked = true;
70
- docEl.style.overflow = 'hidden';
71
- // Compensate for scrollbar disappearing to prevent layout shift
72
- if (scrollbarWidth > 0) {
73
- docEl.style.paddingRight = `${scrollbarWidth}px`;
74
- }
75
- docEl.classList.add('ty-scroll-locked');
76
- }
77
- /**
78
- * Unlock body scrolling
79
- */
116
+ if (lockState.locked)
117
+ return;
118
+ const scrollbarWidth = getScrollbarWidth();
119
+ const docEl = getDocEl();
120
+ if (window.tyScrollDebug) {
121
+ console.log('🔒 Locking body scroll:', { scrollbarWidth });
122
+ }
123
+ lockState.scrollY = getScrollY();
124
+ lockState.locked = true;
125
+ savedStyle = { overflow: docEl.style.overflow, paddingRight: docEl.style.paddingRight };
126
+ docEl.style.overflow = 'hidden';
127
+ if (scrollbarWidth > 0) {
128
+ docEl.style.paddingRight = `${scrollbarWidth}px`;
129
+ }
130
+ docEl.classList.add('ty-scroll-locked');
131
+ addGuard();
132
+ }
80
133
  function unlockBodyFixed() {
81
- if (!lockState.locked)
82
- return;
83
- const docEl = getDocEl();
84
- if (window.tyScrollDebug) {
85
- console.log('🔓 Unlocking body scroll');
86
- }
87
- docEl.classList.remove('ty-scroll-locked');
88
- docEl.style.overflow = '';
89
- docEl.style.paddingRight = '';
90
- lockState.locked = false;
91
- }
92
- // ============================================================================
93
- // Public API
94
- // ============================================================================
95
- /**
96
- * Lock scrolling for a specific component.
97
- *
98
- * Multiple components can lock scrolling simultaneously.
99
- * Scroll remains locked until ALL components unlock.
100
- *
101
- * @param componentId - Unique identifier for the component
102
- */
134
+ if (!lockState.locked)
135
+ return;
136
+ const docEl = getDocEl();
137
+ if (window.tyScrollDebug) {
138
+ console.log('🔓 Unlocking body scroll');
139
+ }
140
+ removeGuard();
141
+ docEl.classList.remove('ty-scroll-locked');
142
+ docEl.style.overflow = savedStyle.overflow;
143
+ docEl.style.paddingRight = savedStyle.paddingRight;
144
+ lockState.locked = false;
145
+ }
103
146
  export function lockScroll(componentId) {
104
- if (lockState.activeLocks.has(componentId))
105
- return;
106
- // Add this component to active locks
107
- lockState.activeLocks.add(componentId);
108
- // Lock body if this is the first lock
109
- if (lockState.activeLocks.size === 1) {
110
- lockBodyFixed();
111
- }
112
- }
113
- /**
114
- * Unlock scrolling for a specific component.
115
- *
116
- * Scroll remains locked if other components still have locks active.
117
- *
118
- * @param componentId - Unique identifier for the component
119
- */
147
+ if (lockState.activeLocks.has(componentId))
148
+ return;
149
+ lockState.activeLocks.add(componentId);
150
+ if (lockState.activeLocks.size === 1) {
151
+ lockBodyFixed();
152
+ }
153
+ }
120
154
  export function unlockScroll(componentId) {
121
- if (!lockState.activeLocks.has(componentId))
122
- return;
123
- // Remove this component from active locks
124
- lockState.activeLocks.delete(componentId);
125
- // Unlock body if this was the last lock
126
- if (lockState.activeLocks.size === 0) {
127
- unlockBodyFixed();
128
- }
129
- console.log('Lock status', lockState.activeLocks);
130
- }
131
- /**
132
- * Emergency unlock - removes all scroll locks immediately.
133
- *
134
- * Use this for cleanup or error recovery scenarios.
135
- */
155
+ if (!lockState.activeLocks.has(componentId))
156
+ return;
157
+ lockState.activeLocks.delete(componentId);
158
+ if (lockState.activeLocks.size === 0) {
159
+ unlockBodyFixed();
160
+ }
161
+ }
136
162
  export function forceUnlockAll() {
137
- lockState.activeLocks.clear();
138
- unlockBodyFixed();
139
- }
140
- // ============================================================================
141
- // Debug API
142
- // ============================================================================
143
- /**
144
- * Enable scroll lock debugging - useful for testing and development
145
- */
163
+ lockState.activeLocks.clear();
164
+ unlockBodyFixed();
165
+ }
146
166
  export function enableDebug() {
147
- console.log('🔍 CSS Scroll lock debugging enabled');
148
- window.tyScrollDebug = true;
167
+ console.log('🔍 CSS Scroll lock debugging enabled');
168
+ window.tyScrollDebug = true;
149
169
  }
150
- /**
151
- * Disable scroll lock debugging
152
- */
153
170
  export function disableDebug() {
154
- console.log('🔍 CSS Scroll lock debugging disabled');
155
- window.tyScrollDebug = false;
156
- }
157
- // ============================================================================
158
- // State Inspection
159
- // ============================================================================
160
- /**
161
- * Get the set of currently active component locks.
162
- *
163
- * @returns Set of component IDs that currently have scroll locked
164
- */
171
+ console.log('🔍 CSS Scroll lock debugging disabled');
172
+ window.tyScrollDebug = false;
173
+ }
165
174
  export function getActiveLocks() {
166
- return new Set(lockState.activeLocks);
175
+ return new Set(lockState.activeLocks);
167
176
  }
168
- /**
169
- * Check if scrolling is currently locked.
170
- *
171
- * @returns true if any component has scroll locked
172
- */
173
177
  export function isLocked() {
174
- return lockState.locked;
175
- }
176
- /**
177
- * Check if scrolling is locked by a specific component.
178
- *
179
- * @param componentId - Component identifier to check
180
- * @returns true if this specific component has scroll locked
181
- */
178
+ return lockState.locked;
179
+ }
182
180
  export function isLockedBy(componentId) {
183
- return lockState.activeLocks.has(componentId);
181
+ return lockState.activeLocks.has(componentId);
184
182
  }
185
- /**
186
- * Get the complete lock state for debugging.
187
- *
188
- * @returns Current state including scroll position and active locks
189
- */
190
183
  export function getLockState() {
191
- return {
192
- locked: lockState.locked,
193
- scrollY: lockState.scrollY,
194
- activeLocks: Array.from(lockState.activeLocks),
195
- };
184
+ return {
185
+ locked: lockState.locked,
186
+ scrollY: lockState.scrollY,
187
+ activeLocks: Array.from(lockState.activeLocks),
188
+ };
196
189
  }
197
- //# sourceMappingURL=scroll-lock.js.map
@@ -19,9 +19,3 @@ export declare function ensureStyles(shadowRoot: ShadowRoot, styleContent: Style
19
19
  * @returns Space-separated class string
20
20
  */
21
21
  export declare function buildClassList(...classes: (string | false | null | undefined)[]): string;
22
- /**
23
- * Clear the style cache
24
- * Useful for testing or hot-reloading
25
- */
26
- export declare function clearStyleCache(): void;
27
- //# sourceMappingURL=styles.d.ts.map
@@ -1,53 +1,22 @@
1
- /**
2
- * CSS Utilities for Ty Components
3
- * Handles dynamic CSS loading into Shadow DOM
4
- */
5
- /** Cache of loaded CSSStyleSheet objects */
6
1
  const styleCache = new Map();
7
- /**
8
- * Ensure CSS is loaded into a shadow root
9
- * Uses CSSStyleSheet API for efficient style sharing
10
- *
11
- * @param shadowRoot - The shadow root to attach styles to
12
- * @param styleContent - Style content with CSS text and optional ID
13
- */
14
2
  export function ensureStyles(shadowRoot, styleContent) {
15
- const { css, id } = styleContent;
16
- // Check cache first
17
- let sheet;
18
- if (id && styleCache.has(id)) {
19
- sheet = styleCache.get(id);
20
- }
21
- else {
22
- // Create new stylesheet
23
- sheet = new CSSStyleSheet();
24
- sheet.replaceSync(css);
25
- // Cache it if ID provided
26
- if (id) {
27
- styleCache.set(id, sheet);
28
- }
29
- }
30
- // Append only if not already adopted
31
- const existing = shadowRoot.adoptedStyleSheets || [];
32
- if (!existing.includes(sheet)) {
33
- shadowRoot.adoptedStyleSheets = [...existing, sheet];
34
- }
3
+ const { css, id } = styleContent;
4
+ let sheet;
5
+ if (id && styleCache.has(id)) {
6
+ sheet = styleCache.get(id);
35
7
  }
36
- /**
37
- * Build CSS class list from properties
38
- * Filters out falsy values
39
- *
40
- * @param classes - Array of class names or falsy values
41
- * @returns Space-separated class string
42
- */
43
- export function buildClassList(...classes) {
44
- return classes.filter(Boolean).join(' ');
8
+ else {
9
+ sheet = new CSSStyleSheet();
10
+ sheet.replaceSync(css);
11
+ if (id) {
12
+ styleCache.set(id, sheet);
13
+ }
14
+ }
15
+ const existing = shadowRoot.adoptedStyleSheets || [];
16
+ if (!existing.includes(sheet)) {
17
+ shadowRoot.adoptedStyleSheets = [...existing, sheet];
45
18
  }
46
- /**
47
- * Clear the style cache
48
- * Useful for testing or hot-reloading
49
- */
50
- export function clearStyleCache() {
51
- styleCache.clear();
52
19
  }
53
- //# sourceMappingURL=styles.js.map
20
+ export function buildClassList(...classes) {
21
+ return classes.filter(Boolean).join(' ');
22
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * For a component whose attributeChangedCallback assigns through its own
3
+ * accessors: call it in the constructor. While an element upgrades, the
4
+ * attribute callbacks run before connectedCallback and would overwrite the
5
+ * early values (an own property takes the assignment); taken off here, they
6
+ * reach the setters in upgradeProperties() instead, after the attributes.
7
+ */
8
+ export declare function liftProperties(el: HTMLElement): void;
9
+ /**
10
+ * Properties set before the element upgraded (a framework rendering it
11
+ * before its definition loaded, a lazily defined element) are own data
12
+ * properties that shadow the class accessors, so later assignments would
13
+ * never reach a setter. Standard "upgrade property" pattern: read the own
14
+ * value, delete it, assign it again through the accessor. Covers every
15
+ * settable accessor on the prototype chain (value, checked, open, error,
16
+ * minLength, …). TyComponent does this itself; a component extending
17
+ * HTMLElement directly calls it at the start of connectedCallback.
18
+ * A value its setter rejects is reported, not thrown: connectedCallback
19
+ * goes on, as it would for an attribute with a bad value.
20
+ */
21
+ export declare function upgradeProperties(el: HTMLElement): void;
@@ -0,0 +1,47 @@
1
+ const accessorCache = new WeakMap();
2
+ function settableAccessors(ctor) {
3
+ let names = accessorCache.get(ctor);
4
+ if (!names) {
5
+ const set = new Set();
6
+ for (let proto = ctor.prototype; proto && proto !== HTMLElement.prototype; proto = Object.getPrototypeOf(proto)) {
7
+ for (const [name, d] of Object.entries(Object.getOwnPropertyDescriptors(proto))) {
8
+ if (d.set)
9
+ set.add(name);
10
+ }
11
+ }
12
+ names = [...set];
13
+ accessorCache.set(ctor, names);
14
+ }
15
+ return names;
16
+ }
17
+ const lifted = new WeakMap();
18
+ function takeOwn(el) {
19
+ const taken = [];
20
+ for (const name of settableAccessors(el.constructor)) {
21
+ if (!Object.prototype.hasOwnProperty.call(el, name))
22
+ continue;
23
+ taken.push([name, el[name]]);
24
+ delete el[name];
25
+ }
26
+ return taken;
27
+ }
28
+ export function liftProperties(el) {
29
+ const taken = takeOwn(el);
30
+ if (taken.length)
31
+ lifted.set(el, taken);
32
+ }
33
+ export function upgradeProperties(el) {
34
+ const early = [...(lifted.get(el) ?? []), ...takeOwn(el)];
35
+ lifted.delete(el);
36
+ for (const [name, value] of early) {
37
+ if (value === undefined)
38
+ continue;
39
+ try {
40
+ ;
41
+ el[name] = value;
42
+ }
43
+ catch (e) {
44
+ reportError(e);
45
+ }
46
+ }
47
+ }
@@ -0,0 +1,122 @@
1
+ /**
2
+ * Constraint validation for form-associated ty components.
3
+ *
4
+ * Components report their own state (e.g. valueMissing) through set(); users
5
+ * add a custom error through setCustomValidity(). Both are kept separately and
6
+ * merged into ElementInternals, so a component re-validating on the next
7
+ * keystroke doesn't wipe the user's custom error (same as native inputs).
8
+ *
9
+ * reportValidity() uses the component's own `error` display when it has one
10
+ * (ty-input, ty-textarea, ty-radio-group, ty-file-upload) instead of the
11
+ * browser's bubble, and clears that message again once the field is valid.
12
+ * Whenever the browser fires `invalid` on such a field — a submit attempt,
13
+ * form.reportValidity(), or checkValidity() on the field or its form — the
14
+ * message goes into that error line (no bubble), so a plain <form> needs no
15
+ * JS. For a check that shows nothing, read `field.validity.valid` or
16
+ * `form.matches(':invalid')`. A submit (a submitter click, Enter in a
17
+ * single-line field, form.requestSubmit()) and form.reportValidity() also
18
+ * move focus to the first failing field — the first in form order, like a
19
+ * native form, also when a later field shows a bubble. checkValidity() never
20
+ * does. For the script-run calls, a form holding a Ty field with an error
21
+ * line gets own requestSubmit / reportValidity wrappers (the prototype and
22
+ * other forms are left alone); they come off when the last such field leaves.
23
+ * An `error` the author set is never overwritten or removed;
24
+ * form.reset() clears every message the controller wrote.
25
+ */
26
+ /**
27
+ * Run `fn` as a submit attempt: `invalid` events during it move focus to the
28
+ * first failing field. ty-button runs its form.requestSubmit() in this.
29
+ */
30
+ export declare function asSubmitAttempt<T>(fn: () => T): T;
31
+ export declare class ValidityController {
32
+ private host;
33
+ private internals;
34
+ private own;
35
+ private custom;
36
+ /** The message this controller last wrote into `error`. */
37
+ private written;
38
+ /** The anchor last handed to setValidity(). */
39
+ private anchor?;
40
+ /**
41
+ * Anchors a validation bubble was shown on, the last two. WebKit keeps a
42
+ * pointer to that anchor without keeping it alive: once a re-render drops
43
+ * it (ty-calendar rebuilds its grid) and it is garbage-collected, the next
44
+ * submit crashes the page. Held until two later bubbles replaced it.
45
+ */
46
+ private shown;
47
+ /** The form whose requestSubmit / reportValidity this field keeps wrapped. */
48
+ private form;
49
+ constructor(host: HTMLElement, internals: ElementInternals);
50
+ /**
51
+ * The host connected, disconnected or changed form: keep its form's
52
+ * requestSubmit / reportValidity wrapped while it (or another Ty field with
53
+ * an error line) is in it. Only such a field needs it: a native control or
54
+ * a bubble field is focused by the browser itself.
55
+ */
56
+ track(): void;
57
+ /**
58
+ * Show the current message, if any, in the error display (on blur after an
59
+ * edit). During a pointer interaction it waits until after the click.
60
+ */
61
+ reveal(): void;
62
+ /**
63
+ * `error` still holds what this controller wrote (a reportValidity(), a
64
+ * submit, a blur reveal), so it's ours to update and clear. Once the author
65
+ * sets their own message, it's theirs.
66
+ */
67
+ private get errorFromReport();
68
+ private writeError;
69
+ /** Into `error`, unless the author's own message is there. */
70
+ private showError;
71
+ /**
72
+ * form.reset(): drop the message this controller showed and any blur
73
+ * reveal still waiting, so the field looks untouched again. An `error` the
74
+ * author set stays.
75
+ */
76
+ reset(): void;
77
+ /** The component's own validity (replaces the previous one). */
78
+ set(flags: ValidityStateFlags, message?: string, anchor?: HTMLElement): void;
79
+ setCustom(message: string): void;
80
+ report(): boolean;
81
+ private sync;
82
+ }
83
+ type ProbeTag = 'input' | 'textarea' | 'select';
84
+ /**
85
+ * The browser's own (localized) message for a rule: a detached native control
86
+ * gets the same attributes and value and reports what it would say. `true`
87
+ * sets a boolean attribute; '', false and null leave the attribute off. One
88
+ * probe per tag, never in the document, stripped of every attribute before
89
+ * each use. Works for required and min/max; length rules only report after a
90
+ * user edit, so a probe can't word them (see lengthValidity()).
91
+ */
92
+ export declare function nativeMessage(tag: ProbeTag, attrs: Record<string, string | boolean | null | undefined>, value?: string): string;
93
+ /**
94
+ * nativeMessage() plus the probe's own flags, for rules whose attribute the
95
+ * browser parses (min/max: ' 5 ' or '0x10' is no rule at all), so the flag
96
+ * and its message can't disagree. Read `validity` right away: the probe is
97
+ * reused by the next call.
98
+ */
99
+ export declare function nativeValidity(tag: ProbeTag, attrs: Record<string, string | boolean | null | undefined>, value?: string): {
100
+ validity: ValidityState;
101
+ message: string;
102
+ };
103
+ /** Non-negative integer limit from an attribute string, or null when unset/invalid. */
104
+ export declare function toLimit(v: unknown): number | null;
105
+ /**
106
+ * minlength / maxlength for a text field (ty-input, ty-textarea): the failing
107
+ * flags with their messages. `control` is the inner native control carrying
108
+ * `minlength`; it only flags (and words, localized) a value the user typed,
109
+ * so its message is used then. Otherwise Ty's wording, and the author's
110
+ * too-short / too-long message always wins. Placeholders: {minlength}
111
+ * {maxlength} {length}.
112
+ */
113
+ export declare function lengthValidity(value: string, rules: {
114
+ minlength: unknown;
115
+ maxlength: unknown;
116
+ tooShortMessage: string;
117
+ tooLongMessage: string;
118
+ }, control?: HTMLInputElement | HTMLTextAreaElement | null): {
119
+ tooShort?: string;
120
+ tooLong?: string;
121
+ };
122
+ export {};