@astral/ui 4.82.0 → 4.83.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 (455) hide show
  1. package/components/ConfirmDialog/ConfirmDialog.js +3 -1
  2. package/components/ConfirmDialog/constants.d.ts +4 -0
  3. package/components/ConfirmDialog/constants.js +5 -0
  4. package/components/ConfirmDialog/index.d.ts +1 -0
  5. package/components/ConfirmDialog/index.js +1 -0
  6. package/components/ConfirmDialog/public.d.ts +1 -0
  7. package/components/ConfirmDialog/public.js +1 -0
  8. package/components/ConfirmDialog/types.d.ts +1 -1
  9. package/components/NewPopover/NewPopover.d.ts +1 -1
  10. package/components/NewPopover/NewPopover.js +14 -5
  11. package/components/NewPopover/constants.d.ts +7 -0
  12. package/components/NewPopover/constants.js +11 -0
  13. package/components/NewPopover/styles.d.ts +4 -0
  14. package/components/NewPopover/styles.js +100 -4
  15. package/components/NewPopover/types.d.ts +13 -0
  16. package/components/NewPopover/useLogic/useLogic.d.ts +7 -3
  17. package/components/NewPopover/useLogic/useLogic.js +15 -1
  18. package/components/Onboarding/Onboarding.d.ts +35 -0
  19. package/components/Onboarding/Onboarding.js +46 -0
  20. package/components/Onboarding/constants.d.ts +34 -0
  21. package/components/Onboarding/constants.js +34 -0
  22. package/components/Onboarding/core/ActiveStepStore/ActiveStepStore.d.ts +50 -0
  23. package/components/Onboarding/core/ActiveStepStore/ActiveStepStore.js +63 -0
  24. package/components/Onboarding/core/ActiveStepStore/index.d.ts +1 -0
  25. package/components/Onboarding/core/ActiveStepStore/index.js +1 -0
  26. package/components/Onboarding/core/ExitController/ExitController.d.ts +46 -0
  27. package/components/Onboarding/core/ExitController/ExitController.js +56 -0
  28. package/components/Onboarding/core/ExitController/index.d.ts +1 -0
  29. package/components/Onboarding/core/ExitController/index.js +1 -0
  30. package/components/Onboarding/core/OnboardingTour/OnboardingTour.d.ts +101 -0
  31. package/components/Onboarding/core/OnboardingTour/OnboardingTour.js +262 -0
  32. package/components/Onboarding/core/OnboardingTour/index.d.ts +1 -0
  33. package/components/Onboarding/core/OnboardingTour/index.js +1 -0
  34. package/components/Onboarding/core/ProgressStorage/ProgressStorage.d.ts +22 -0
  35. package/components/Onboarding/core/ProgressStorage/ProgressStorage.js +58 -0
  36. package/components/Onboarding/core/ProgressStorage/index.d.ts +1 -0
  37. package/components/Onboarding/core/ProgressStorage/index.js +1 -0
  38. package/components/Onboarding/core/StepNavigator/StepNavigator.d.ts +28 -0
  39. package/components/Onboarding/core/StepNavigator/StepNavigator.js +73 -0
  40. package/components/Onboarding/core/StepNavigator/index.d.ts +1 -0
  41. package/components/Onboarding/core/StepNavigator/index.js +1 -0
  42. package/components/Onboarding/core/StepResolver/StepResolver.d.ts +19 -0
  43. package/components/Onboarding/core/StepResolver/StepResolver.js +49 -0
  44. package/components/Onboarding/core/StepResolver/index.d.ts +1 -0
  45. package/components/Onboarding/core/StepResolver/index.js +1 -0
  46. package/components/Onboarding/core/StepsController/StepsController.d.ts +16 -0
  47. package/components/Onboarding/core/StepsController/StepsController.js +35 -0
  48. package/components/Onboarding/core/StepsController/index.d.ts +1 -0
  49. package/components/Onboarding/core/StepsController/index.js +1 -0
  50. package/components/Onboarding/faker.d.ts +27 -0
  51. package/components/Onboarding/faker.js +79 -0
  52. package/components/Onboarding/index.d.ts +5 -0
  53. package/components/Onboarding/index.js +3 -0
  54. package/components/Onboarding/public.d.ts +5 -0
  55. package/components/Onboarding/public.js +3 -0
  56. package/components/Onboarding/services/LocalStorageSaveStrategy/LocalStorageSaveStrategy.d.ts +20 -0
  57. package/components/Onboarding/services/LocalStorageSaveStrategy/LocalStorageSaveStrategy.js +24 -0
  58. package/components/Onboarding/services/LocalStorageSaveStrategy/index.d.ts +1 -0
  59. package/components/Onboarding/services/LocalStorageSaveStrategy/index.js +1 -0
  60. package/components/Onboarding/types/config.d.ts +18 -0
  61. package/components/Onboarding/types/config.js +1 -0
  62. package/components/Onboarding/types/index.d.ts +4 -0
  63. package/components/Onboarding/types/index.js +4 -0
  64. package/components/Onboarding/types/progress.d.ts +28 -0
  65. package/components/Onboarding/types/progress.js +1 -0
  66. package/components/Onboarding/types/step.d.ts +144 -0
  67. package/components/Onboarding/types/step.js +1 -0
  68. package/components/Onboarding/types/tour.d.ts +168 -0
  69. package/components/Onboarding/types/tour.js +1 -0
  70. package/components/Onboarding/ui/ConfirmExit/ConfirmExit.d.ts +10 -0
  71. package/components/Onboarding/ui/ConfirmExit/ConfirmExit.js +6 -0
  72. package/components/Onboarding/ui/ConfirmExit/index.d.ts +2 -0
  73. package/components/Onboarding/ui/ConfirmExit/index.js +1 -0
  74. package/components/Onboarding/ui/ConfirmExit/styles.d.ts +30 -0
  75. package/components/Onboarding/ui/ConfirmExit/styles.js +11 -0
  76. package/components/Onboarding/ui/OnboardingContainer/OnboardingContainer.d.ts +12 -0
  77. package/components/Onboarding/ui/OnboardingContainer/OnboardingContainer.js +15 -0
  78. package/components/Onboarding/ui/OnboardingContainer/OnboardingErrorBoundary/OnboardingErrorBoundary.d.ts +22 -0
  79. package/components/Onboarding/ui/OnboardingContainer/OnboardingErrorBoundary/OnboardingErrorBoundary.js +20 -0
  80. package/components/Onboarding/ui/OnboardingContainer/OnboardingErrorBoundary/index.d.ts +2 -0
  81. package/components/Onboarding/ui/OnboardingContainer/OnboardingErrorBoundary/index.js +1 -0
  82. package/components/Onboarding/ui/OnboardingContainer/index.d.ts +1 -0
  83. package/components/Onboarding/ui/OnboardingContainer/index.js +1 -0
  84. package/components/Onboarding/ui/OnboardingContainer/useLogic/index.d.ts +1 -0
  85. package/components/Onboarding/ui/OnboardingContainer/useLogic/index.js +1 -0
  86. package/components/Onboarding/ui/OnboardingContainer/useLogic/useLogic.d.ts +10 -0
  87. package/components/Onboarding/ui/OnboardingContainer/useLogic/useLogic.js +14 -0
  88. package/components/Onboarding/ui/Overlay/Overlay.d.ts +29 -0
  89. package/components/Onboarding/ui/Overlay/Overlay.js +24 -0
  90. package/components/Onboarding/ui/Overlay/constants.d.ts +7 -0
  91. package/components/Onboarding/ui/Overlay/constants.js +8 -0
  92. package/components/Onboarding/ui/Overlay/index.d.ts +2 -0
  93. package/components/Onboarding/ui/Overlay/index.js +1 -0
  94. package/components/Onboarding/ui/Overlay/styles.d.ts +22 -0
  95. package/components/Onboarding/ui/Overlay/styles.js +57 -0
  96. package/components/Onboarding/ui/Overlay/useLogic/index.d.ts +1 -0
  97. package/components/Onboarding/ui/Overlay/useLogic/index.js +1 -0
  98. package/components/Onboarding/ui/Overlay/useLogic/useLogic.d.ts +13 -0
  99. package/components/Onboarding/ui/Overlay/useLogic/useLogic.js +10 -0
  100. package/components/Onboarding/ui/StepStrategy/StepStrategy.d.ts +6 -0
  101. package/components/Onboarding/ui/StepStrategy/StepStrategy.js +17 -0
  102. package/components/Onboarding/ui/StepStrategy/index.d.ts +1 -0
  103. package/components/Onboarding/ui/StepStrategy/index.js +1 -0
  104. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/HighlightStep.d.ts +6 -0
  105. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/HighlightStep.js +19 -0
  106. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/index.d.ts +2 -0
  107. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/index.js +1 -0
  108. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/styles.d.ts +25 -0
  109. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/styles.js +56 -0
  110. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/index.d.ts +1 -0
  111. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/index.js +1 -0
  112. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/useLogic.d.ts +12 -0
  113. package/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/useLogic.js +37 -0
  114. package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/StandaloneStep.d.ts +6 -0
  115. package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/StandaloneStep.js +11 -0
  116. package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/index.d.ts +2 -0
  117. package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/index.js +1 -0
  118. package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/styles.d.ts +13 -0
  119. package/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/styles.js +9 -0
  120. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/ProgressDots.d.ts +6 -0
  121. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/ProgressDots.js +15 -0
  122. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/constants.d.ts +4 -0
  123. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/constants.js +5 -0
  124. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/index.d.ts +2 -0
  125. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/index.js +1 -0
  126. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/styles.d.ts +9 -0
  127. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/styles.js +34 -0
  128. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/StepFooter.d.ts +9 -0
  129. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/StepFooter.js +18 -0
  130. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/constants.d.ts +4 -0
  131. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/constants.js +4 -0
  132. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/index.d.ts +2 -0
  133. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/index.js +1 -0
  134. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/styles.d.ts +21 -0
  135. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/styles.js +28 -0
  136. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/index.d.ts +1 -0
  137. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/index.js +1 -0
  138. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/useLogic.d.ts +16 -0
  139. package/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/useLogic.js +22 -0
  140. package/components/Onboarding/ui/StepStrategy/steps/types.d.ts +16 -0
  141. package/components/Onboarding/ui/StepStrategy/steps/types.js +1 -0
  142. package/components/Onboarding/ui/StepStrategy/useLogic/index.d.ts +1 -0
  143. package/components/Onboarding/ui/StepStrategy/useLogic/index.js +1 -0
  144. package/components/Onboarding/ui/StepStrategy/useLogic/useLogic.d.ts +47 -0
  145. package/components/Onboarding/ui/StepStrategy/useLogic/useLogic.js +51 -0
  146. package/components/Onboarding/ui/hooks/useActiveStep/index.d.ts +1 -0
  147. package/components/Onboarding/ui/hooks/useActiveStep/index.js +1 -0
  148. package/components/Onboarding/ui/hooks/useActiveStep/useActiveStep.d.ts +6 -0
  149. package/components/Onboarding/ui/hooks/useActiveStep/useActiveStep.js +7 -0
  150. package/components/Onboarding/ui/hooks/useDelayedActiveStep/index.d.ts +1 -0
  151. package/components/Onboarding/ui/hooks/useDelayedActiveStep/index.js +1 -0
  152. package/components/Onboarding/ui/hooks/useDelayedActiveStep/useDelayedActiveStep.d.ts +15 -0
  153. package/components/Onboarding/ui/hooks/useDelayedActiveStep/useDelayedActiveStep.js +19 -0
  154. package/components/Onboarding/ui/hooks/useFocusTrap/index.d.ts +1 -0
  155. package/components/Onboarding/ui/hooks/useFocusTrap/index.js +1 -0
  156. package/components/Onboarding/ui/hooks/useFocusTrap/useFocusTrap.d.ts +6 -0
  157. package/components/Onboarding/ui/hooks/useFocusTrap/useFocusTrap.js +33 -0
  158. package/components/Onboarding/ui/hooks/useKeyboardNav/index.d.ts +1 -0
  159. package/components/Onboarding/ui/hooks/useKeyboardNav/index.js +1 -0
  160. package/components/Onboarding/ui/hooks/useKeyboardNav/useKeyboardNav.d.ts +11 -0
  161. package/components/Onboarding/ui/hooks/useKeyboardNav/useKeyboardNav.js +62 -0
  162. package/components/Onboarding/ui/hooks/useStepTransition/index.d.ts +1 -0
  163. package/components/Onboarding/ui/hooks/useStepTransition/index.js +1 -0
  164. package/components/Onboarding/ui/hooks/useStepTransition/useStepTransition.d.ts +30 -0
  165. package/components/Onboarding/ui/hooks/useStepTransition/useStepTransition.js +46 -0
  166. package/components/Onboarding/ui/hooks/useTargetAnchor/index.d.ts +1 -0
  167. package/components/Onboarding/ui/hooks/useTargetAnchor/index.js +1 -0
  168. package/components/Onboarding/ui/hooks/useTargetAnchor/useTargetAnchor.d.ts +37 -0
  169. package/components/Onboarding/ui/hooks/useTargetAnchor/useTargetAnchor.js +56 -0
  170. package/components/Onboarding/ui/hooks/useTrackedRect/index.d.ts +1 -0
  171. package/components/Onboarding/ui/hooks/useTrackedRect/index.js +1 -0
  172. package/components/Onboarding/ui/hooks/useTrackedRect/useTrackedRect.d.ts +5 -0
  173. package/components/Onboarding/ui/hooks/useTrackedRect/useTrackedRect.js +43 -0
  174. package/components/Onboarding/ui/hooks/useViewportSize/index.d.ts +1 -0
  175. package/components/Onboarding/ui/hooks/useViewportSize/index.js +1 -0
  176. package/components/Onboarding/ui/hooks/useViewportSize/useViewportSize.d.ts +5 -0
  177. package/components/Onboarding/ui/hooks/useViewportSize/useViewportSize.js +14 -0
  178. package/components/Onboarding/ui/styles.d.ts +5 -0
  179. package/components/Onboarding/ui/styles.js +15 -0
  180. package/components/Onboarding/utils/createVirtualAnchor/createVirtualAnchor.d.ts +12 -0
  181. package/components/Onboarding/utils/createVirtualAnchor/createVirtualAnchor.js +6 -0
  182. package/components/Onboarding/utils/createVirtualAnchor/index.d.ts +1 -0
  183. package/components/Onboarding/utils/createVirtualAnchor/index.js +1 -0
  184. package/components/Onboarding/utils/geometry/index.d.ts +4 -0
  185. package/components/Onboarding/utils/geometry/index.js +4 -0
  186. package/components/Onboarding/utils/geometry/overlayPath/index.d.ts +1 -0
  187. package/components/Onboarding/utils/geometry/overlayPath/index.js +1 -0
  188. package/components/Onboarding/utils/geometry/overlayPath/overlayPath.d.ts +6 -0
  189. package/components/Onboarding/utils/geometry/overlayPath/overlayPath.js +29 -0
  190. package/components/Onboarding/utils/geometry/parseOffset/index.d.ts +1 -0
  191. package/components/Onboarding/utils/geometry/parseOffset/index.js +1 -0
  192. package/components/Onboarding/utils/geometry/parseOffset/parseOffset.d.ts +4 -0
  193. package/components/Onboarding/utils/geometry/parseOffset/parseOffset.js +5 -0
  194. package/components/Onboarding/utils/geometry/rect/index.d.ts +2 -0
  195. package/components/Onboarding/utils/geometry/rect/index.js +1 -0
  196. package/components/Onboarding/utils/geometry/rect/rect.d.ts +34 -0
  197. package/components/Onboarding/utils/geometry/rect/rect.js +60 -0
  198. package/components/Onboarding/utils/geometry/viewport/index.d.ts +2 -0
  199. package/components/Onboarding/utils/geometry/viewport/index.js +1 -0
  200. package/components/Onboarding/utils/geometry/viewport/viewport.d.ts +14 -0
  201. package/components/Onboarding/utils/geometry/viewport/viewport.js +10 -0
  202. package/components/Onboarding/utils/getScrollParents/getScrollParents.d.ts +7 -0
  203. package/components/Onboarding/utils/getScrollParents/getScrollParents.js +24 -0
  204. package/components/Onboarding/utils/getScrollParents/index.d.ts +1 -0
  205. package/components/Onboarding/utils/getScrollParents/index.js +1 -0
  206. package/components/Onboarding/utils/getTargetElement/getTargetElement.d.ts +4 -0
  207. package/components/Onboarding/utils/getTargetElement/getTargetElement.js +9 -0
  208. package/components/Onboarding/utils/getTargetElement/index.d.ts +1 -0
  209. package/components/Onboarding/utils/getTargetElement/index.js +1 -0
  210. package/components/Onboarding/utils/observeRemoval/index.d.ts +1 -0
  211. package/components/Onboarding/utils/observeRemoval/index.js +1 -0
  212. package/components/Onboarding/utils/observeRemoval/observeRemoval.d.ts +4 -0
  213. package/components/Onboarding/utils/observeRemoval/observeRemoval.js +13 -0
  214. package/components/Onboarding/utils/scrollIntoView/index.d.ts +1 -0
  215. package/components/Onboarding/utils/scrollIntoView/index.js +1 -0
  216. package/components/Onboarding/utils/scrollIntoView/scrollIntoView.d.ts +13 -0
  217. package/components/Onboarding/utils/scrollIntoView/scrollIntoView.js +85 -0
  218. package/components/Onboarding/utils/waitForElement/index.d.ts +2 -0
  219. package/components/Onboarding/utils/waitForElement/index.js +1 -0
  220. package/components/Onboarding/utils/waitForElement/waitForElement.d.ts +21 -0
  221. package/components/Onboarding/utils/waitForElement/waitForElement.js +45 -0
  222. package/components/Onboarding/validation/index.d.ts +1 -0
  223. package/components/Onboarding/validation/index.js +1 -0
  224. package/components/Onboarding/validation/validateTourConfig/index.d.ts +1 -0
  225. package/components/Onboarding/validation/validateTourConfig/index.js +1 -0
  226. package/components/Onboarding/validation/validateTourConfig/validateTourConfig.d.ts +12 -0
  227. package/components/Onboarding/validation/validateTourConfig/validateTourConfig.js +52 -0
  228. package/node/components/ConfirmDialog/ConfirmDialog.js +3 -1
  229. package/node/components/ConfirmDialog/constants.d.ts +4 -0
  230. package/node/components/ConfirmDialog/constants.js +8 -0
  231. package/node/components/ConfirmDialog/index.d.ts +1 -0
  232. package/node/components/ConfirmDialog/index.js +3 -0
  233. package/node/components/ConfirmDialog/public.d.ts +1 -0
  234. package/node/components/ConfirmDialog/public.js +3 -0
  235. package/node/components/ConfirmDialog/types.d.ts +1 -1
  236. package/node/components/NewPopover/NewPopover.d.ts +1 -1
  237. package/node/components/NewPopover/NewPopover.js +12 -3
  238. package/node/components/NewPopover/constants.d.ts +7 -0
  239. package/node/components/NewPopover/constants.js +12 -1
  240. package/node/components/NewPopover/styles.d.ts +4 -0
  241. package/node/components/NewPopover/styles.js +101 -5
  242. package/node/components/NewPopover/types.d.ts +13 -0
  243. package/node/components/NewPopover/useLogic/useLogic.d.ts +7 -3
  244. package/node/components/NewPopover/useLogic/useLogic.js +15 -1
  245. package/node/components/Onboarding/Onboarding.d.ts +35 -0
  246. package/node/components/Onboarding/Onboarding.js +51 -0
  247. package/node/components/Onboarding/constants.d.ts +34 -0
  248. package/node/components/Onboarding/constants.js +37 -0
  249. package/node/components/Onboarding/core/ActiveStepStore/ActiveStepStore.d.ts +50 -0
  250. package/node/components/Onboarding/core/ActiveStepStore/ActiveStepStore.js +67 -0
  251. package/node/components/Onboarding/core/ActiveStepStore/index.d.ts +1 -0
  252. package/node/components/Onboarding/core/ActiveStepStore/index.js +17 -0
  253. package/node/components/Onboarding/core/ExitController/ExitController.d.ts +46 -0
  254. package/node/components/Onboarding/core/ExitController/ExitController.js +60 -0
  255. package/node/components/Onboarding/core/ExitController/index.d.ts +1 -0
  256. package/node/components/Onboarding/core/ExitController/index.js +17 -0
  257. package/node/components/Onboarding/core/OnboardingTour/OnboardingTour.d.ts +101 -0
  258. package/node/components/Onboarding/core/OnboardingTour/OnboardingTour.js +266 -0
  259. package/node/components/Onboarding/core/OnboardingTour/index.d.ts +1 -0
  260. package/node/components/Onboarding/core/OnboardingTour/index.js +5 -0
  261. package/node/components/Onboarding/core/ProgressStorage/ProgressStorage.d.ts +22 -0
  262. package/node/components/Onboarding/core/ProgressStorage/ProgressStorage.js +62 -0
  263. package/node/components/Onboarding/core/ProgressStorage/index.d.ts +1 -0
  264. package/node/components/Onboarding/core/ProgressStorage/index.js +17 -0
  265. package/node/components/Onboarding/core/StepNavigator/StepNavigator.d.ts +28 -0
  266. package/node/components/Onboarding/core/StepNavigator/StepNavigator.js +77 -0
  267. package/node/components/Onboarding/core/StepNavigator/index.d.ts +1 -0
  268. package/node/components/Onboarding/core/StepNavigator/index.js +17 -0
  269. package/node/components/Onboarding/core/StepResolver/StepResolver.d.ts +19 -0
  270. package/node/components/Onboarding/core/StepResolver/StepResolver.js +53 -0
  271. package/node/components/Onboarding/core/StepResolver/index.d.ts +1 -0
  272. package/node/components/Onboarding/core/StepResolver/index.js +17 -0
  273. package/node/components/Onboarding/core/StepsController/StepsController.d.ts +16 -0
  274. package/node/components/Onboarding/core/StepsController/StepsController.js +39 -0
  275. package/node/components/Onboarding/core/StepsController/index.d.ts +1 -0
  276. package/node/components/Onboarding/core/StepsController/index.js +17 -0
  277. package/node/components/Onboarding/faker.d.ts +27 -0
  278. package/node/components/Onboarding/faker.js +88 -0
  279. package/node/components/Onboarding/index.d.ts +5 -0
  280. package/node/components/Onboarding/index.js +9 -0
  281. package/node/components/Onboarding/public.d.ts +5 -0
  282. package/node/components/Onboarding/public.js +9 -0
  283. package/node/components/Onboarding/services/LocalStorageSaveStrategy/LocalStorageSaveStrategy.d.ts +20 -0
  284. package/node/components/Onboarding/services/LocalStorageSaveStrategy/LocalStorageSaveStrategy.js +29 -0
  285. package/node/components/Onboarding/services/LocalStorageSaveStrategy/index.d.ts +1 -0
  286. package/node/components/Onboarding/services/LocalStorageSaveStrategy/index.js +17 -0
  287. package/node/components/Onboarding/types/config.d.ts +18 -0
  288. package/node/components/Onboarding/types/config.js +2 -0
  289. package/node/components/Onboarding/types/index.d.ts +4 -0
  290. package/node/components/Onboarding/types/index.js +20 -0
  291. package/node/components/Onboarding/types/progress.d.ts +28 -0
  292. package/node/components/Onboarding/types/progress.js +2 -0
  293. package/node/components/Onboarding/types/step.d.ts +144 -0
  294. package/node/components/Onboarding/types/step.js +2 -0
  295. package/node/components/Onboarding/types/tour.d.ts +168 -0
  296. package/node/components/Onboarding/types/tour.js +2 -0
  297. package/node/components/Onboarding/ui/ConfirmExit/ConfirmExit.d.ts +10 -0
  298. package/node/components/Onboarding/ui/ConfirmExit/ConfirmExit.js +10 -0
  299. package/node/components/Onboarding/ui/ConfirmExit/index.d.ts +2 -0
  300. package/node/components/Onboarding/ui/ConfirmExit/index.js +5 -0
  301. package/node/components/Onboarding/ui/ConfirmExit/styles.d.ts +30 -0
  302. package/node/components/Onboarding/ui/ConfirmExit/styles.js +14 -0
  303. package/node/components/Onboarding/ui/OnboardingContainer/OnboardingContainer.d.ts +12 -0
  304. package/node/components/Onboarding/ui/OnboardingContainer/OnboardingContainer.js +19 -0
  305. package/node/components/Onboarding/ui/OnboardingContainer/OnboardingErrorBoundary/OnboardingErrorBoundary.d.ts +22 -0
  306. package/node/components/Onboarding/ui/OnboardingContainer/OnboardingErrorBoundary/OnboardingErrorBoundary.js +24 -0
  307. package/node/components/Onboarding/ui/OnboardingContainer/OnboardingErrorBoundary/index.d.ts +2 -0
  308. package/node/components/Onboarding/ui/OnboardingContainer/OnboardingErrorBoundary/index.js +5 -0
  309. package/node/components/Onboarding/ui/OnboardingContainer/index.d.ts +1 -0
  310. package/node/components/Onboarding/ui/OnboardingContainer/index.js +5 -0
  311. package/node/components/Onboarding/ui/OnboardingContainer/useLogic/index.d.ts +1 -0
  312. package/node/components/Onboarding/ui/OnboardingContainer/useLogic/index.js +5 -0
  313. package/node/components/Onboarding/ui/OnboardingContainer/useLogic/useLogic.d.ts +10 -0
  314. package/node/components/Onboarding/ui/OnboardingContainer/useLogic/useLogic.js +18 -0
  315. package/node/components/Onboarding/ui/Overlay/Overlay.d.ts +29 -0
  316. package/node/components/Onboarding/ui/Overlay/Overlay.js +28 -0
  317. package/node/components/Onboarding/ui/Overlay/constants.d.ts +7 -0
  318. package/node/components/Onboarding/ui/Overlay/constants.js +11 -0
  319. package/node/components/Onboarding/ui/Overlay/index.d.ts +2 -0
  320. package/node/components/Onboarding/ui/Overlay/index.js +5 -0
  321. package/node/components/Onboarding/ui/Overlay/styles.d.ts +22 -0
  322. package/node/components/Onboarding/ui/Overlay/styles.js +60 -0
  323. package/node/components/Onboarding/ui/Overlay/useLogic/index.d.ts +1 -0
  324. package/node/components/Onboarding/ui/Overlay/useLogic/index.js +5 -0
  325. package/node/components/Onboarding/ui/Overlay/useLogic/useLogic.d.ts +13 -0
  326. package/node/components/Onboarding/ui/Overlay/useLogic/useLogic.js +14 -0
  327. package/node/components/Onboarding/ui/StepStrategy/StepStrategy.d.ts +6 -0
  328. package/node/components/Onboarding/ui/StepStrategy/StepStrategy.js +21 -0
  329. package/node/components/Onboarding/ui/StepStrategy/index.d.ts +1 -0
  330. package/node/components/Onboarding/ui/StepStrategy/index.js +17 -0
  331. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/HighlightStep.d.ts +6 -0
  332. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/HighlightStep.js +23 -0
  333. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/index.d.ts +2 -0
  334. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/index.js +5 -0
  335. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/styles.d.ts +25 -0
  336. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/styles.js +59 -0
  337. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/index.d.ts +1 -0
  338. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/index.js +5 -0
  339. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/useLogic.d.ts +12 -0
  340. package/node/components/Onboarding/ui/StepStrategy/steps/HighlightStep/useLogic/useLogic.js +41 -0
  341. package/node/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/StandaloneStep.d.ts +6 -0
  342. package/node/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/StandaloneStep.js +15 -0
  343. package/node/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/index.d.ts +2 -0
  344. package/node/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/index.js +5 -0
  345. package/node/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/styles.d.ts +13 -0
  346. package/node/components/Onboarding/ui/StepStrategy/steps/StandaloneStep/styles.js +12 -0
  347. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/ProgressDots.d.ts +6 -0
  348. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/ProgressDots.js +19 -0
  349. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/constants.d.ts +4 -0
  350. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/constants.js +8 -0
  351. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/index.d.ts +2 -0
  352. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/index.js +5 -0
  353. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/styles.d.ts +9 -0
  354. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/ProgressDots/styles.js +37 -0
  355. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/StepFooter.d.ts +9 -0
  356. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/StepFooter.js +22 -0
  357. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/constants.d.ts +4 -0
  358. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/constants.js +7 -0
  359. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/index.d.ts +2 -0
  360. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/index.js +5 -0
  361. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/styles.d.ts +21 -0
  362. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/styles.js +31 -0
  363. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/index.d.ts +1 -0
  364. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/index.js +5 -0
  365. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/useLogic.d.ts +16 -0
  366. package/node/components/Onboarding/ui/StepStrategy/steps/StepFooter/useLogic/useLogic.js +26 -0
  367. package/node/components/Onboarding/ui/StepStrategy/steps/types.d.ts +16 -0
  368. package/node/components/Onboarding/ui/StepStrategy/steps/types.js +2 -0
  369. package/node/components/Onboarding/ui/StepStrategy/useLogic/index.d.ts +1 -0
  370. package/node/components/Onboarding/ui/StepStrategy/useLogic/index.js +5 -0
  371. package/node/components/Onboarding/ui/StepStrategy/useLogic/useLogic.d.ts +47 -0
  372. package/node/components/Onboarding/ui/StepStrategy/useLogic/useLogic.js +55 -0
  373. package/node/components/Onboarding/ui/hooks/useActiveStep/index.d.ts +1 -0
  374. package/node/components/Onboarding/ui/hooks/useActiveStep/index.js +5 -0
  375. package/node/components/Onboarding/ui/hooks/useActiveStep/useActiveStep.d.ts +6 -0
  376. package/node/components/Onboarding/ui/hooks/useActiveStep/useActiveStep.js +11 -0
  377. package/node/components/Onboarding/ui/hooks/useDelayedActiveStep/index.d.ts +1 -0
  378. package/node/components/Onboarding/ui/hooks/useDelayedActiveStep/index.js +17 -0
  379. package/node/components/Onboarding/ui/hooks/useDelayedActiveStep/useDelayedActiveStep.d.ts +15 -0
  380. package/node/components/Onboarding/ui/hooks/useDelayedActiveStep/useDelayedActiveStep.js +23 -0
  381. package/node/components/Onboarding/ui/hooks/useFocusTrap/index.d.ts +1 -0
  382. package/node/components/Onboarding/ui/hooks/useFocusTrap/index.js +5 -0
  383. package/node/components/Onboarding/ui/hooks/useFocusTrap/useFocusTrap.d.ts +6 -0
  384. package/node/components/Onboarding/ui/hooks/useFocusTrap/useFocusTrap.js +37 -0
  385. package/node/components/Onboarding/ui/hooks/useKeyboardNav/index.d.ts +1 -0
  386. package/node/components/Onboarding/ui/hooks/useKeyboardNav/index.js +5 -0
  387. package/node/components/Onboarding/ui/hooks/useKeyboardNav/useKeyboardNav.d.ts +11 -0
  388. package/node/components/Onboarding/ui/hooks/useKeyboardNav/useKeyboardNav.js +66 -0
  389. package/node/components/Onboarding/ui/hooks/useStepTransition/index.d.ts +1 -0
  390. package/node/components/Onboarding/ui/hooks/useStepTransition/index.js +5 -0
  391. package/node/components/Onboarding/ui/hooks/useStepTransition/useStepTransition.d.ts +30 -0
  392. package/node/components/Onboarding/ui/hooks/useStepTransition/useStepTransition.js +50 -0
  393. package/node/components/Onboarding/ui/hooks/useTargetAnchor/index.d.ts +1 -0
  394. package/node/components/Onboarding/ui/hooks/useTargetAnchor/index.js +17 -0
  395. package/node/components/Onboarding/ui/hooks/useTargetAnchor/useTargetAnchor.d.ts +37 -0
  396. package/node/components/Onboarding/ui/hooks/useTargetAnchor/useTargetAnchor.js +60 -0
  397. package/node/components/Onboarding/ui/hooks/useTrackedRect/index.d.ts +1 -0
  398. package/node/components/Onboarding/ui/hooks/useTrackedRect/index.js +5 -0
  399. package/node/components/Onboarding/ui/hooks/useTrackedRect/useTrackedRect.d.ts +5 -0
  400. package/node/components/Onboarding/ui/hooks/useTrackedRect/useTrackedRect.js +47 -0
  401. package/node/components/Onboarding/ui/hooks/useViewportSize/index.d.ts +1 -0
  402. package/node/components/Onboarding/ui/hooks/useViewportSize/index.js +5 -0
  403. package/node/components/Onboarding/ui/hooks/useViewportSize/useViewportSize.d.ts +5 -0
  404. package/node/components/Onboarding/ui/hooks/useViewportSize/useViewportSize.js +18 -0
  405. package/node/components/Onboarding/ui/styles.d.ts +5 -0
  406. package/node/components/Onboarding/ui/styles.js +19 -0
  407. package/node/components/Onboarding/utils/createVirtualAnchor/createVirtualAnchor.d.ts +12 -0
  408. package/node/components/Onboarding/utils/createVirtualAnchor/createVirtualAnchor.js +10 -0
  409. package/node/components/Onboarding/utils/createVirtualAnchor/index.d.ts +1 -0
  410. package/node/components/Onboarding/utils/createVirtualAnchor/index.js +17 -0
  411. package/node/components/Onboarding/utils/geometry/index.d.ts +4 -0
  412. package/node/components/Onboarding/utils/geometry/index.js +20 -0
  413. package/node/components/Onboarding/utils/geometry/overlayPath/index.d.ts +1 -0
  414. package/node/components/Onboarding/utils/geometry/overlayPath/index.js +5 -0
  415. package/node/components/Onboarding/utils/geometry/overlayPath/overlayPath.d.ts +6 -0
  416. package/node/components/Onboarding/utils/geometry/overlayPath/overlayPath.js +33 -0
  417. package/node/components/Onboarding/utils/geometry/parseOffset/index.d.ts +1 -0
  418. package/node/components/Onboarding/utils/geometry/parseOffset/index.js +5 -0
  419. package/node/components/Onboarding/utils/geometry/parseOffset/parseOffset.d.ts +4 -0
  420. package/node/components/Onboarding/utils/geometry/parseOffset/parseOffset.js +9 -0
  421. package/node/components/Onboarding/utils/geometry/rect/index.d.ts +2 -0
  422. package/node/components/Onboarding/utils/geometry/rect/index.js +9 -0
  423. package/node/components/Onboarding/utils/geometry/rect/rect.d.ts +34 -0
  424. package/node/components/Onboarding/utils/geometry/rect/rect.js +69 -0
  425. package/node/components/Onboarding/utils/geometry/viewport/index.d.ts +2 -0
  426. package/node/components/Onboarding/utils/geometry/viewport/index.js +5 -0
  427. package/node/components/Onboarding/utils/geometry/viewport/viewport.d.ts +14 -0
  428. package/node/components/Onboarding/utils/geometry/viewport/viewport.js +14 -0
  429. package/node/components/Onboarding/utils/getScrollParents/getScrollParents.d.ts +7 -0
  430. package/node/components/Onboarding/utils/getScrollParents/getScrollParents.js +28 -0
  431. package/node/components/Onboarding/utils/getScrollParents/index.d.ts +1 -0
  432. package/node/components/Onboarding/utils/getScrollParents/index.js +5 -0
  433. package/node/components/Onboarding/utils/getTargetElement/getTargetElement.d.ts +4 -0
  434. package/node/components/Onboarding/utils/getTargetElement/getTargetElement.js +13 -0
  435. package/node/components/Onboarding/utils/getTargetElement/index.d.ts +1 -0
  436. package/node/components/Onboarding/utils/getTargetElement/index.js +5 -0
  437. package/node/components/Onboarding/utils/observeRemoval/index.d.ts +1 -0
  438. package/node/components/Onboarding/utils/observeRemoval/index.js +17 -0
  439. package/node/components/Onboarding/utils/observeRemoval/observeRemoval.d.ts +4 -0
  440. package/node/components/Onboarding/utils/observeRemoval/observeRemoval.js +17 -0
  441. package/node/components/Onboarding/utils/scrollIntoView/index.d.ts +1 -0
  442. package/node/components/Onboarding/utils/scrollIntoView/index.js +5 -0
  443. package/node/components/Onboarding/utils/scrollIntoView/scrollIntoView.d.ts +13 -0
  444. package/node/components/Onboarding/utils/scrollIntoView/scrollIntoView.js +89 -0
  445. package/node/components/Onboarding/utils/waitForElement/index.d.ts +2 -0
  446. package/node/components/Onboarding/utils/waitForElement/index.js +5 -0
  447. package/node/components/Onboarding/utils/waitForElement/waitForElement.d.ts +21 -0
  448. package/node/components/Onboarding/utils/waitForElement/waitForElement.js +49 -0
  449. package/node/components/Onboarding/validation/index.d.ts +1 -0
  450. package/node/components/Onboarding/validation/index.js +6 -0
  451. package/node/components/Onboarding/validation/validateTourConfig/index.d.ts +1 -0
  452. package/node/components/Onboarding/validation/validateTourConfig/index.js +6 -0
  453. package/node/components/Onboarding/validation/validateTourConfig/validateTourConfig.d.ts +12 -0
  454. package/node/components/Onboarding/validation/validateTourConfig/validateTourConfig.js +80 -0
  455. package/package.json +3 -2
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Размеры viewport.
3
+ */
4
+ export type Viewport = {
5
+ width: number;
6
+ height: number;
7
+ };
8
+ /**
9
+ * Текущие размеры viewport.
10
+ *
11
+ * Именно `documentElement.clientWidth/Height`, а не `window.innerWidth/Height`:
12
+ * inner-размеры включают полосы прокрутки окна.
13
+ */
14
+ export declare const getViewport: () => Viewport;
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Текущие размеры viewport.
3
+ *
4
+ * Именно `documentElement.clientWidth/Height`, а не `window.innerWidth/Height`:
5
+ * inner-размеры включают полосы прокрутки окна.
6
+ */
7
+ export const getViewport = () => ({
8
+ width: document.documentElement.clientWidth,
9
+ height: document.documentElement.clientHeight,
10
+ });
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Возвращает цепочку scroll-предков элемента (от ближайшего к корню).
3
+ *
4
+ * Нужна, чтобы прокручивать вложенные контейнеры и слушать их `scroll`
5
+ * для синхронизации hole overlay.
6
+ */
7
+ export declare const getScrollParents: (element: Element | null) => HTMLElement[];
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Является ли элемент scroll-контейнером.
3
+ */
4
+ const isScrollable = (element) => {
5
+ const { overflow, overflowX, overflowY } = getComputedStyle(element);
6
+ return /(auto|scroll|overlay)/.test(`${overflow}${overflowX}${overflowY}`);
7
+ };
8
+ /**
9
+ * Возвращает цепочку scroll-предков элемента (от ближайшего к корню).
10
+ *
11
+ * Нужна, чтобы прокручивать вложенные контейнеры и слушать их `scroll`
12
+ * для синхронизации hole overlay.
13
+ */
14
+ export const getScrollParents = (element) => {
15
+ const parents = [];
16
+ let node = element?.parentElement ?? null;
17
+ while (node && node !== document.body && node !== document.documentElement) {
18
+ if (isScrollable(node)) {
19
+ parents.push(node);
20
+ }
21
+ node = node.parentElement;
22
+ }
23
+ return parents;
24
+ };
@@ -0,0 +1 @@
1
+ export { getScrollParents } from './getScrollParents';
@@ -0,0 +1 @@
1
+ export { getScrollParents } from './getScrollParents';
@@ -0,0 +1,4 @@
1
+ /**
2
+ * Находит элемент highlight-шага по `[data-tour-id="<stepName>"]`.
3
+ */
4
+ export declare const getTargetElement: (stepName: string, root?: ParentNode) => HTMLElement | null;
@@ -0,0 +1,9 @@
1
+ import { TOUR_ID_ATTR } from '../../constants';
2
+ /**
3
+ * Экранирует значение для безопасной подстановки в CSS-селектор атрибута.
4
+ */
5
+ const escapeAttrValue = (value) => value.replace(/["\\]/g, '\\$&');
6
+ /**
7
+ * Находит элемент highlight-шага по `[data-tour-id="<stepName>"]`.
8
+ */
9
+ export const getTargetElement = (stepName, root = document) => root.querySelector(`[${TOUR_ID_ATTR}="${escapeAttrValue(stepName)}"]`);
@@ -0,0 +1 @@
1
+ export { getTargetElement } from './getTargetElement';
@@ -0,0 +1 @@
1
+ export { getTargetElement } from './getTargetElement';
@@ -0,0 +1 @@
1
+ export * from './observeRemoval';
@@ -0,0 +1 @@
1
+ export * from './observeRemoval';
@@ -0,0 +1,4 @@
1
+ /**
2
+ * Следит за удалением элемента из DOM (размонтирование, условный render).
3
+ */
4
+ export declare const observeRemoval: (element: HTMLElement, onRemoved: () => void) => VoidFunction;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Следит за удалением элемента из DOM (размонтирование, условный render).
3
+ */
4
+ export const observeRemoval = (element, onRemoved) => {
5
+ const observer = new MutationObserver(() => {
6
+ if (!element.isConnected) {
7
+ observer.disconnect();
8
+ onRemoved();
9
+ }
10
+ });
11
+ observer.observe(document.body, { childList: true, subtree: true });
12
+ return () => observer.disconnect();
13
+ };
@@ -0,0 +1 @@
1
+ export { scrollIntoView } from './scrollIntoView';
@@ -0,0 +1 @@
1
+ export { scrollIntoView } from './scrollIntoView';
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Доводит элемент highlight-шага до центра viewport и ждёт, пока прокрутка
3
+ * реально доедет.
4
+ *
5
+ * Зачем: цель может быть за пределами экрана или внутри прокрученного
6
+ * контейнера — её надо показать, прежде чем подсвечивать. Нативный
7
+ * `scrollIntoView` сам прокручивает всю цепочку вложенных scroll-контейнеров.
8
+ *
9
+ * Почему ждём: прокрутка плавная (анимированная), позиция элемента меняется
10
+ * кадр за кадром. Дожидаемся её стабилизации, чтобы hole overlay и popover встали
11
+ * по финальной позиции, а не по промежуточной «едущей».
12
+ */
13
+ export declare const scrollIntoView: (element: HTMLElement, behavior?: ScrollBehavior) => Promise<void>;
@@ -0,0 +1,85 @@
1
+ import { SCROLL_BEHAVIOR } from '../../constants';
2
+ import { getViewport } from '../geometry';
3
+ import { getScrollParents } from '../getScrollParents';
4
+ /**
5
+ * Сколько кадров подряд позиция не меняется, чтобы счесть прокрутку стабилизировавшейся.
6
+ */
7
+ const STABLE_FRAMES = 3;
8
+ /**
9
+ * Предохранитель: если позиция так и не стабилизировалась (постоянные
10
+ * layout-сдвиги), делаем resolve по тайм-ауту, чтобы Promise не завис и тур не застрял.
11
+ */
12
+ const SETTLE_TIMEOUT_MS = 1000;
13
+ /**
14
+ * Дожидается окончания плавной прокрутки.
15
+ *
16
+ * У браузера нет надёжного сигнала «плавная прокрутка доехала».
17
+ * Поэтому отслеживаем позицию элемента покадрово и считаем прокрутку
18
+ * законченной, когда `top` перестаёт меняться 3 кадра
19
+ * подряд — либо когда срабатывает предохранитель 1000мс.
20
+ */
21
+ const waitForScrollSettle = (element) => new Promise((resolve) => {
22
+ let raf = 0;
23
+ let stableFrames = 0;
24
+ let prevTop = Number.NaN;
25
+ const timer = setTimeout(() => {
26
+ cancelAnimationFrame(raf);
27
+ resolve();
28
+ }, SETTLE_TIMEOUT_MS);
29
+ const tick = () => {
30
+ const { top } = element.getBoundingClientRect();
31
+ // Позиция не изменилась за кадр — копим «стабильные» кадры; дёрнулась —
32
+ // сбрасываем счётчик и запоминаем новую позицию.
33
+ if (top === prevTop) {
34
+ stableFrames += 1;
35
+ }
36
+ else {
37
+ stableFrames = 0;
38
+ prevTop = top;
39
+ }
40
+ // Достаточно кадров без движения → анимация закончилась.
41
+ if (stableFrames >= STABLE_FRAMES) {
42
+ clearTimeout(timer);
43
+ resolve();
44
+ return;
45
+ }
46
+ raf = requestAnimationFrame(tick);
47
+ };
48
+ raf = requestAnimationFrame(tick);
49
+ });
50
+ /**
51
+ * Элемент целиком видим: помещается и во viewport, и в рамки каждого своего
52
+ * scroll-предка.
53
+ */
54
+ const isFullyVisible = (element) => {
55
+ const rect = element.getBoundingClientRect();
56
+ const { width, height } = getViewport();
57
+ const viewport = new DOMRect(0, 0, width, height);
58
+ const frames = [
59
+ viewport,
60
+ ...getScrollParents(element).map((parent) => parent.getBoundingClientRect()),
61
+ ];
62
+ return frames.every((frame) => rect.top >= frame.top &&
63
+ rect.left >= frame.left &&
64
+ rect.bottom <= frame.bottom &&
65
+ rect.right <= frame.right);
66
+ };
67
+ /**
68
+ * Доводит элемент highlight-шага до центра viewport и ждёт, пока прокрутка
69
+ * реально доедет.
70
+ *
71
+ * Зачем: цель может быть за пределами экрана или внутри прокрученного
72
+ * контейнера — её надо показать, прежде чем подсвечивать. Нативный
73
+ * `scrollIntoView` сам прокручивает всю цепочку вложенных scroll-контейнеров.
74
+ *
75
+ * Почему ждём: прокрутка плавная (анимированная), позиция элемента меняется
76
+ * кадр за кадром. Дожидаемся её стабилизации, чтобы hole overlay и popover встали
77
+ * по финальной позиции, а не по промежуточной «едущей».
78
+ */
79
+ export const scrollIntoView = async (element, behavior = SCROLL_BEHAVIOR) => {
80
+ if (isFullyVisible(element)) {
81
+ return;
82
+ }
83
+ element.scrollIntoView({ behavior, block: 'center', inline: 'center' });
84
+ await waitForScrollSettle(element);
85
+ };
@@ -0,0 +1,2 @@
1
+ export { waitForElement } from './waitForElement';
2
+ export type { WaitForElementOptions } from './waitForElement';
@@ -0,0 +1 @@
1
+ export { waitForElement } from './waitForElement';
@@ -0,0 +1,21 @@
1
+ export type WaitForElementOptions = {
2
+ /**
3
+ * Тайм-аут ожидания, мс. `0` — не ждём: проверяем DOM синхронно и, если
4
+ * элемента нет, сразу делаем reject.
5
+ * @default 0
6
+ */
7
+ timeout?: number;
8
+ /**
9
+ * Корень для поиска и наблюдения за DOM.
10
+ * @default document
11
+ */
12
+ root?: Document | HTMLElement;
13
+ };
14
+ /**
15
+ * Дожидается появления элемента highlight-шага в DOM.
16
+ *
17
+ * Если элемент уже есть — синхронный resolve. При `timeout <= 0` ожидание
18
+ * отключено. Иначе подписывается через MutationObserver и resolve при появлении,
19
+ * либо reject по тайм-ауту.
20
+ */
21
+ export declare const waitForElement: (stepName: string, { timeout, root, }?: WaitForElementOptions) => Promise<HTMLElement>;
@@ -0,0 +1,45 @@
1
+ import { DEFAULT_WAIT_ELEMENT_TIMEOUT_MS, TOUR_ID_ATTR } from '../../constants';
2
+ import { getTargetElement } from '../getTargetElement';
3
+ /**
4
+ * Дожидается появления элемента highlight-шага в DOM.
5
+ *
6
+ * Если элемент уже есть — синхронный resolve. При `timeout <= 0` ожидание
7
+ * отключено. Иначе подписывается через MutationObserver и resolve при появлении,
8
+ * либо reject по тайм-ауту.
9
+ */
10
+ export const waitForElement = (stepName, { timeout = DEFAULT_WAIT_ELEMENT_TIMEOUT_MS, root = document, } = {}) => new Promise((resolve, reject) => {
11
+ const existing = getTargetElement(stepName, root);
12
+ if (existing) {
13
+ resolve(existing);
14
+ return;
15
+ }
16
+ // Ожидание отключено (по умолчанию): элемента в DOM нет — ждать нечего,
17
+ // делаем reject сразу, не подписываясь на мутации.
18
+ if (timeout <= 0) {
19
+ reject(new Error(`Элемент шага "${stepName}" не найден в DOM, а ожидание отключено (waitForTimeout=0). Навесьте data-tour-id через getHighlightProps() либо задайте waitForTimeout, если элемент появляется асинхронно.`));
20
+ return;
21
+ }
22
+ const observeRoot = root instanceof Document ? root.body : root;
23
+ let timer;
24
+ const observer = new MutationObserver(() => {
25
+ const element = getTargetElement(stepName, root);
26
+ if (element) {
27
+ cleanup();
28
+ resolve(element);
29
+ }
30
+ });
31
+ const cleanup = () => {
32
+ observer.disconnect();
33
+ clearTimeout(timer);
34
+ };
35
+ observer.observe(observeRoot, {
36
+ childList: true,
37
+ subtree: true,
38
+ attributes: true,
39
+ attributeFilter: [TOUR_ID_ATTR],
40
+ });
41
+ timer = setTimeout(() => {
42
+ cleanup();
43
+ reject(new Error(`Элемент шага "${stepName}" не найден за ${timeout}мс. Убедитесь, что на нём навешен data-tour-id через getHighlightProps().`));
44
+ }, timeout);
45
+ });
@@ -0,0 +1 @@
1
+ export { validateTourConfig, OnboardingConfigError, } from './validateTourConfig';
@@ -0,0 +1 @@
1
+ export { validateTourConfig, OnboardingConfigError, } from './validateTourConfig';
@@ -0,0 +1 @@
1
+ export { validateTourConfig, OnboardingConfigError, } from './validateTourConfig';
@@ -0,0 +1 @@
1
+ export { validateTourConfig, OnboardingConfigError, } from './validateTourConfig';
@@ -0,0 +1,12 @@
1
+ import { type OnboardingTourConfig, type Step } from '../../types';
2
+ /**
3
+ * Ошибка конфигурации тура
4
+ */
5
+ export declare class OnboardingConfigError extends Error {
6
+ constructor(errors: unknown);
7
+ }
8
+ /**
9
+ * Проверяет конфигурацию тура и бросает ошибку при нарушениях.
10
+ * Вызывается при создании тура (в `createTour`).
11
+ */
12
+ export declare const validateTourConfig: <TSteps extends readonly Step[]>(config: OnboardingTourConfig<TSteps>) => void;
@@ -0,0 +1,52 @@
1
+ import * as v from '@astral/validations';
2
+ /**
3
+ * Имя шага в camelCase.
4
+ * Гарантирует доступ `tour.steps.stepName` и чистый `data-tour-id`.
5
+ */
6
+ const CAMEL_CASE = /^[a-z][a-zA-Z0-9]*$/;
7
+ /**
8
+ * Правило: имена шагов уникальны в рамках тура.
9
+ */
10
+ const uniqueStepName = () => v.createRule((steps, ctx) => {
11
+ const seenNames = new Set();
12
+ for (const { name } of steps) {
13
+ if (seenNames.has(name)) {
14
+ return ctx.createError({
15
+ code: 'DUPLICATE_STEP_NAME',
16
+ message: `Имя шага «${name}» не уникально`,
17
+ });
18
+ }
19
+ seenNames.add(name);
20
+ }
21
+ return undefined;
22
+ });
23
+ /**
24
+ * Схема валидации конфигурации тура.
25
+ */
26
+ const tourConfigSchema = v.object({
27
+ name: v.string(v.min(1)),
28
+ steps: v.array(v.min(1), v.arrayItem(v.object({
29
+ name: v.string(v.min(1), v.pattern(CAMEL_CASE, {
30
+ message: 'Имя шага должно быть в camelCase',
31
+ })),
32
+ })), uniqueStepName()),
33
+ });
34
+ /**
35
+ * Ошибка конфигурации тура
36
+ */
37
+ export class OnboardingConfigError extends Error {
38
+ constructor(errors) {
39
+ super(`Некорректная конфигурация тура:\n${JSON.stringify(errors, null, 2)}`);
40
+ this.name = 'OnboardingConfigError';
41
+ }
42
+ }
43
+ /**
44
+ * Проверяет конфигурацию тура и бросает ошибку при нарушениях.
45
+ * Вызывается при создании тура (в `createTour`).
46
+ */
47
+ export const validateTourConfig = (config) => {
48
+ const errors = tourConfigSchema(config);
49
+ if (errors) {
50
+ throw new OnboardingConfigError(v.toPrettyError(errors));
51
+ }
52
+ };
@@ -7,6 +7,8 @@ const Dialog_1 = require("../Dialog");
7
7
  const DialogActions_1 = require("../DialogActions");
8
8
  const DialogContent_1 = require("../DialogContent");
9
9
  const DialogContentText_1 = require("../DialogContentText");
10
+ const classNames_1 = require("../utils/classNames");
11
+ const constants_1 = require("./constants");
10
12
  const styles_1 = require("./styles");
11
13
  const useLogic_1 = require("./useLogic");
12
14
  const ConfirmDialog = (props) => {
@@ -14,6 +16,6 @@ const ConfirmDialog = (props) => {
14
16
  const { open, title, description, actions, onClose, size = 'sm', ...restProps } = props;
15
17
  const { text: confirmText, ...confirmButtonProps } = actions.confirm;
16
18
  const { text: cancelText, variant, onClick, ...restCancelProps } = actions.cancel || {};
17
- return ((0, jsx_runtime_1.jsxs)(Dialog_1.Dialog, { size: size, title: title, open: open, onClose: onClose, ...restProps, children: [description && ((0, jsx_runtime_1.jsx)(DialogContent_1.DialogContent, { children: typeof description === 'string' ? ((0, jsx_runtime_1.jsx)(DialogContentText_1.DialogContentText, { children: description })) : (description) })), (0, jsx_runtime_1.jsxs)(DialogActions_1.DialogActions, { children: [isShowCancelButton && ((0, jsx_runtime_1.jsx)(styles_1.CancelButton, { ...restCancelProps, ...cancelButtonProps, children: cancelText })), (0, jsx_runtime_1.jsx)(Button_1.Button, { ...confirmButtonProps, children: confirmText })] })] }));
19
+ return ((0, jsx_runtime_1.jsxs)(Dialog_1.Dialog, { size: size, title: title, open: open, onClose: onClose, ...restProps, children: [description && ((0, jsx_runtime_1.jsx)(DialogContent_1.DialogContent, { children: typeof description === 'string' ? ((0, jsx_runtime_1.jsx)(DialogContentText_1.DialogContentText, { children: description })) : (description) })), (0, jsx_runtime_1.jsxs)(DialogActions_1.DialogActions, { children: [isShowCancelButton && ((0, jsx_runtime_1.jsx)(styles_1.CancelButton, { ...restCancelProps, ...cancelButtonProps, className: (0, classNames_1.classNames)(actions.cancel?.className, constants_1.confirmDialogClassnames.cancelButton), children: cancelText })), (0, jsx_runtime_1.jsx)(Button_1.Button, { ...confirmButtonProps, className: (0, classNames_1.classNames)(confirmButtonProps.className, constants_1.confirmDialogClassnames.confirmButton), children: confirmText })] })] }));
18
20
  };
19
21
  exports.ConfirmDialog = ConfirmDialog;
@@ -0,0 +1,4 @@
1
+ export declare const confirmDialogClassnames: {
2
+ confirmButton: string;
3
+ cancelButton: string;
4
+ };
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.confirmDialogClassnames = void 0;
4
+ const createUIKitClassname_1 = require("../utils/createUIKitClassname");
5
+ exports.confirmDialogClassnames = {
6
+ confirmButton: (0, createUIKitClassname_1.createUIKitClassname)('confirm-dialog__confirm-button'),
7
+ cancelButton: (0, createUIKitClassname_1.createUIKitClassname)('confirm-dialog__cancel-button'),
8
+ };
@@ -1,2 +1,3 @@
1
1
  export * from './ConfirmDialog';
2
+ export { confirmDialogClassnames } from './constants';
2
3
  export type { ConfirmDialogProps } from './types';
@@ -14,4 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
+ exports.confirmDialogClassnames = void 0;
17
18
  __exportStar(require("./ConfirmDialog"), exports);
19
+ var constants_1 = require("./constants");
20
+ Object.defineProperty(exports, "confirmDialogClassnames", { enumerable: true, get: function () { return constants_1.confirmDialogClassnames; } });
@@ -1,2 +1,3 @@
1
1
  export * from './ConfirmDialog';
2
+ export { confirmDialogClassnames } from './constants';
2
3
  export type { ConfirmDialogProps } from './types';
@@ -14,4 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
+ exports.confirmDialogClassnames = void 0;
17
18
  __exportStar(require("./ConfirmDialog"), exports);
19
+ var constants_1 = require("./constants");
20
+ Object.defineProperty(exports, "confirmDialogClassnames", { enumerable: true, get: function () { return constants_1.confirmDialogClassnames; } });
@@ -33,4 +33,4 @@ export type ConfirmDialogProps = {
33
33
  text: string;
34
34
  };
35
35
  };
36
- } & Pick<DialogProps, 'aria-labelledby' | 'aria-describedby' | 'disableBackdropClick' | 'disablePortal' | 'disableScrollLock' | 'hideBackdrop' | 'keepMounted' | 'open' | 'size'>;
36
+ } & Pick<DialogProps, 'aria-labelledby' | 'aria-describedby' | 'disableBackdropClick' | 'disablePortal' | 'disableScrollLock' | 'hideBackdrop' | 'keepMounted' | 'open' | 'size' | 'className'>;
@@ -1,2 +1,2 @@
1
1
  import { type NewPopoverProps } from './types';
2
- export declare const NewPopover: ({ children, onClose, isOpen, title, className, style, placement, anchorEl, disablePortal, disableAutoFocus, }: NewPopoverProps) => import("react/jsx-runtime").JSX.Element;
2
+ export declare const NewPopover: ({ children, onClose, isOpen, title, className, style, placement, anchorEl, disablePortal, disableAutoFocus, hasArrow, }: NewPopoverProps) => import("react/jsx-runtime").JSX.Element;
@@ -13,15 +13,24 @@ const animatedWrapperCva = (0, cva_1.cva)(constants_1.popoverClassnames.animated
13
13
  isOpen: {
14
14
  true: constants_1.popoverClassnames.animatedWrapperOpen,
15
15
  },
16
+ hasArrow: {
17
+ true: constants_1.popoverClassnames.animatedWrapperHasArrow,
18
+ },
16
19
  },
17
20
  });
18
- const NewPopover = ({ children, onClose, isOpen, title, className, style, placement = 'bottom', anchorEl, disablePortal, disableAutoFocus, }) => {
19
- const { isMobile, isOpened, shouldRender, handleAnimationEnd, handleClose, setContainerRef, } = (0, useLogic_1.useLogic)({ isOpen, anchorEl, onClose, disableAutoFocus });
21
+ const NewPopover = ({ children, onClose, isOpen, title, className, style, placement = 'bottom', anchorEl, disablePortal, disableAutoFocus, hasArrow, }) => {
22
+ const { isMobile, isOpened, shouldRender, handleAnimationEnd, handleClose, setContainerRef, setArrowElement, mergedModifiers, } = (0, useLogic_1.useLogic)({
23
+ isOpen,
24
+ anchorEl,
25
+ onClose,
26
+ disableAutoFocus,
27
+ hasArrow,
28
+ });
20
29
  if (isMobile) {
21
30
  return ((0, jsx_runtime_1.jsx)(BottomDrawer_1.BottomDrawer, { title: title, onClose: handleClose, open: isOpened, className: className, style: style, ModalProps: {
22
31
  disableAutoFocus,
23
32
  }, children: children }));
24
33
  }
25
- return ((0, jsx_runtime_1.jsx)(styles_1.StyledMuiPopper, { className: constants_1.popoverClassnames.root, open: shouldRender, placement: placement, anchorEl: anchorEl, disablePortal: disablePortal, children: (0, jsx_runtime_1.jsx)(styles_1.AnimatedWrapper, { className: (0, classNames_1.classNames)(className, animatedWrapperCva({ isOpen: isOpened })), style: style, onAnimationEnd: handleAnimationEnd, children: (0, jsx_runtime_1.jsx)(styles_1.InnerContainer, { ref: setContainerRef, tabIndex: -1, className: constants_1.popoverClassnames.innerContainer, children: children }) }) }));
34
+ return ((0, jsx_runtime_1.jsx)(styles_1.StyledMuiPopper, { className: (0, classNames_1.classNames)(constants_1.popoverClassnames.root, className), style: style, open: shouldRender, placement: placement, anchorEl: anchorEl, disablePortal: disablePortal, modifiers: mergedModifiers, children: (0, jsx_runtime_1.jsxs)(styles_1.AnimatedWrapper, { className: animatedWrapperCva({ isOpen: isOpened, hasArrow }), onAnimationEnd: handleAnimationEnd, children: [hasArrow && ((0, jsx_runtime_1.jsx)(styles_1.PopoverArrow, { ref: setArrowElement, className: constants_1.popoverClassnames.arrow })), (0, jsx_runtime_1.jsx)(styles_1.InnerContainer, { ref: setContainerRef, tabIndex: -1, className: constants_1.popoverClassnames.innerContainer, children: children })] }) }));
26
35
  };
27
36
  exports.NewPopover = NewPopover;
@@ -1,6 +1,13 @@
1
+ import { type NewPopoverModifier } from './types';
1
2
  export declare const popoverClassnames: {
2
3
  root: string;
3
4
  innerContainer: string;
4
5
  animatedWrapper: string;
5
6
  animatedWrapperOpen: string;
7
+ animatedWrapperHasArrow: string;
8
+ arrow: string;
6
9
  };
10
+ /**
11
+ * Базовые модификаторы Popper.js. У MUI Popper (popper.js)
12
+ */
13
+ export declare const DEFAULT_MODIFIERS: NewPopoverModifier[];
@@ -1,10 +1,21 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.popoverClassnames = void 0;
3
+ exports.DEFAULT_MODIFIERS = exports.popoverClassnames = void 0;
4
4
  const createUIKitClassname_1 = require("../utils/createUIKitClassname");
5
5
  exports.popoverClassnames = {
6
6
  root: (0, createUIKitClassname_1.createUIKitClassname)('popover'),
7
7
  innerContainer: (0, createUIKitClassname_1.createUIKitClassname)('popover__inner-container'),
8
8
  animatedWrapper: (0, createUIKitClassname_1.createUIKitClassname)('popover__animated-wrapper'),
9
9
  animatedWrapperOpen: (0, createUIKitClassname_1.createUIKitClassname)('popover__animated-wrapper_is-open'),
10
+ animatedWrapperHasArrow: (0, createUIKitClassname_1.createUIKitClassname)('popover__animated-wrapper_has-arrow'),
11
+ arrow: (0, createUIKitClassname_1.createUIKitClassname)('popover__arrow'),
10
12
  };
13
+ /**
14
+ * Базовые модификаторы Popper.js. У MUI Popper (popper.js)
15
+ */
16
+ exports.DEFAULT_MODIFIERS = [
17
+ {
18
+ name: 'preventOverflow',
19
+ options: { altAxis: true, tether: false, padding: 8 },
20
+ },
21
+ ];
@@ -2,6 +2,10 @@
2
2
  export declare const StyledMuiPopper: import("@emotion/styled/dist/declarations/src/types").StyledComponent<import("@mui/material/Popper").PopperProps & import("react").RefAttributes<HTMLDivElement> & {
3
3
  theme?: import("@emotion/react").Theme | undefined;
4
4
  }, {}, {}>;
5
+ export declare const PopoverArrow: import("@emotion/styled/dist/declarations/src/types").StyledComponent<{
6
+ theme?: import("@emotion/react").Theme | undefined;
7
+ as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;
8
+ }, import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, {}>;
5
9
  export declare const AnimatedWrapper: import("@emotion/styled/dist/declarations/src/types").StyledComponent<{
6
10
  theme?: import("@emotion/react").Theme | undefined;
7
11
  as?: import("react").ElementType<any, keyof import("react").JSX.IntrinsicElements> | undefined;