@sheetxl/utils-react 0.7.22 → 0.7.23-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (290) hide show
  1. package/browser/cjs/C7jPCqFJNiWyD2pr.cjs +1 -0
  2. package/browser/cjs/CyWMySHsu-RvsIGs.cjs +1 -0
  3. package/browser/cjs/DZSvmqU8nRas1uz6.cjs +1 -0
  4. package/browser/cjs/index.cjs +5 -7
  5. package/browser/esm/BlY25fmBdmHNyBqo.mjs +139 -0
  6. package/browser/esm/CQUN3sZz7IrPMYIa.mjs +2171 -0
  7. package/browser/esm/DpI3aVOBON4B0xID.mjs +390 -0
  8. package/browser/esm/index.mjs +6128 -1806
  9. package/licenses/dependencies.txt +246 -39
  10. package/node/esm/B8EaqTMia4qMXy5z.mjs +139 -0
  11. package/node/esm/D9Xo9E4JB3ReeH-J.mjs +2171 -0
  12. package/node/esm/index.mjs +5141 -1774
  13. package/package.json +8 -5
  14. package/types/index.d.ts +2 -2043
  15. package/types/src/animation/AnimationModeContext.d.ts +10 -0
  16. package/types/src/animation/AnimationModeContext.d.ts.map +1 -0
  17. package/types/src/animation/index.d.ts +3 -0
  18. package/types/src/animation/index.d.ts.map +1 -0
  19. package/types/src/animation/useAnimatedMeasure.d.ts +39 -0
  20. package/types/src/animation/useAnimatedMeasure.d.ts.map +1 -0
  21. package/types/src/command/ActivationTracker.d.ts +53 -0
  22. package/types/src/command/ActivationTracker.d.ts.map +1 -0
  23. package/types/src/command/CommandAnchorProvider.d.ts +64 -0
  24. package/types/src/command/CommandAnchorProvider.d.ts.map +1 -0
  25. package/types/src/command/CommandButtonEntryLabel.d.ts +25 -0
  26. package/types/src/command/CommandButtonEntryLabel.d.ts.map +1 -0
  27. package/types/src/command/CommandButtonRegistry.d.ts +159 -0
  28. package/types/src/command/CommandButtonRegistry.d.ts.map +1 -0
  29. package/types/src/command/CommandButtonRegistryContext.d.ts +35 -0
  30. package/types/src/command/CommandButtonRegistryContext.d.ts.map +1 -0
  31. package/types/src/command/CommandCatalog.d.ts +155 -0
  32. package/types/src/command/CommandCatalog.d.ts.map +1 -0
  33. package/types/src/command/CommandCatalogResource.d.ts +7 -0
  34. package/types/src/command/CommandCatalogResource.d.ts.map +1 -0
  35. package/types/src/command/CommandCatalogService.d.ts +61 -0
  36. package/types/src/command/CommandCatalogService.d.ts.map +1 -0
  37. package/types/src/command/CommandChainContext.d.ts +32 -0
  38. package/types/src/command/CommandChainContext.d.ts.map +1 -0
  39. package/types/src/command/CommandFallbackContext.d.ts +30 -0
  40. package/types/src/command/CommandFallbackContext.d.ts.map +1 -0
  41. package/types/src/command/CommandFocusContext.d.ts +21 -0
  42. package/types/src/command/CommandFocusContext.d.ts.map +1 -0
  43. package/types/src/command/CommandRegistry.d.ts +164 -0
  44. package/types/src/command/CommandRegistry.d.ts.map +1 -0
  45. package/types/src/command/CommandRegistryContext.d.ts +16 -0
  46. package/types/src/command/CommandRegistryContext.d.ts.map +1 -0
  47. package/types/src/command/CommandResolver.d.ts +162 -0
  48. package/types/src/command/CommandResolver.d.ts.map +1 -0
  49. package/types/src/command/CommandScope.d.ts +343 -0
  50. package/types/src/command/CommandScope.d.ts.map +1 -0
  51. package/types/src/command/CommandScopeContext.d.ts +205 -0
  52. package/types/src/command/CommandScopeContext.d.ts.map +1 -0
  53. package/types/src/command/FocusActivation.d.ts +140 -0
  54. package/types/src/command/FocusActivation.d.ts.map +1 -0
  55. package/types/src/command/ICommand.d.ts +31 -0
  56. package/types/src/command/ICommand.d.ts.map +1 -0
  57. package/types/src/command/ICommandDefinition.d.ts +82 -0
  58. package/types/src/command/ICommandDefinition.d.ts.map +1 -0
  59. package/types/src/command/KeyBindingDispatcher.d.ts +150 -0
  60. package/types/src/command/KeyBindingDispatcher.d.ts.map +1 -0
  61. package/types/src/command/LayerActivation.d.ts +45 -0
  62. package/types/src/command/LayerActivation.d.ts.map +1 -0
  63. package/types/src/command/Types.d.ts +80 -0
  64. package/types/src/command/Types.d.ts.map +1 -0
  65. package/types/src/command/createResolvedCommand.d.ts +91 -0
  66. package/types/src/command/createResolvedCommand.d.ts.map +1 -0
  67. package/types/src/command/index.d.ts +26 -0
  68. package/types/src/command/index.d.ts.map +1 -0
  69. package/types/src/command/reduceDefinitions.d.ts +33 -0
  70. package/types/src/command/reduceDefinitions.d.ts.map +1 -0
  71. package/types/src/command/useCommands.d.ts +22 -0
  72. package/types/src/command/useCommands.d.ts.map +1 -0
  73. package/types/src/command/useContributeCommands.d.ts +18 -0
  74. package/types/src/command/useContributeCommands.d.ts.map +1 -0
  75. package/types/src/components/FocusKeyNavigation.d.ts +22 -0
  76. package/types/src/components/FocusKeyNavigation.d.ts.map +1 -0
  77. package/types/src/components/ITooltip.d.ts +38 -0
  78. package/types/src/components/ITooltip.d.ts.map +1 -0
  79. package/types/src/components/RoundedTab.d.ts +26 -0
  80. package/types/src/components/RoundedTab.d.ts.map +1 -0
  81. package/types/src/components/index.d.ts +4 -0
  82. package/types/src/components/index.d.ts.map +1 -0
  83. package/types/src/error/ErrorPanel.d.ts +14 -0
  84. package/types/src/error/ErrorPanel.d.ts.map +1 -0
  85. package/types/src/error/ReactErrorBoundary.d.ts +7 -0
  86. package/types/src/error/ReactErrorBoundary.d.ts.map +1 -0
  87. package/types/src/error/UncaughtErrorBoundary.d.ts +5 -0
  88. package/types/src/error/UncaughtErrorBoundary.d.ts.map +1 -0
  89. package/types/src/error/index.d.ts +4 -0
  90. package/types/src/error/index.d.ts.map +1 -0
  91. package/types/src/float/FloatPanel.d.ts +57 -0
  92. package/types/src/float/FloatPanel.d.ts.map +1 -0
  93. package/types/src/float/FloatPopper.d.ts +85 -0
  94. package/types/src/float/FloatPopper.d.ts.map +1 -0
  95. package/types/src/float/FloatPopup.d.ts +19 -0
  96. package/types/src/float/FloatPopup.d.ts.map +1 -0
  97. package/types/src/float/FloatProvider.d.ts +60 -0
  98. package/types/src/float/FloatProvider.d.ts.map +1 -0
  99. package/types/src/float/FloatStackContext.d.ts +25 -0
  100. package/types/src/float/FloatStackContext.d.ts.map +1 -0
  101. package/types/src/float/FloatTooltip.d.ts +22 -0
  102. package/types/src/float/FloatTooltip.d.ts.map +1 -0
  103. package/types/src/float/FloatUtils.d.ts +55 -0
  104. package/types/src/float/FloatUtils.d.ts.map +1 -0
  105. package/types/src/float/_FloatUtils.d.ts +51 -0
  106. package/types/src/float/_FloatUtils.d.ts.map +1 -0
  107. package/types/src/float/index.d.ts +9 -0
  108. package/types/src/float/index.d.ts.map +1 -0
  109. package/types/src/float/useFloatStack.d.ts +92 -0
  110. package/types/src/float/useFloatStack.d.ts.map +1 -0
  111. package/types/src/hooks/LanguageState.d.ts +15 -0
  112. package/types/src/hooks/LanguageState.d.ts.map +1 -0
  113. package/types/src/hooks/index.d.ts +19 -0
  114. package/types/src/hooks/index.d.ts.map +1 -0
  115. package/types/src/hooks/useBoundSyncExternalStore.d.ts +23 -0
  116. package/types/src/hooks/useBoundSyncExternalStore.d.ts.map +1 -0
  117. package/types/src/hooks/useCallbackRef.d.ts +11 -0
  118. package/types/src/hooks/useCallbackRef.d.ts.map +1 -0
  119. package/types/src/hooks/useDevicePixelRatio.d.ts +37 -0
  120. package/types/src/hooks/useDevicePixelRatio.d.ts.map +1 -0
  121. package/types/src/hooks/useEditMode.d.ts +66 -0
  122. package/types/src/hooks/useEditMode.d.ts.map +1 -0
  123. package/types/src/hooks/useGlobalClipboard.d.ts +7 -0
  124. package/types/src/hooks/useGlobalClipboard.d.ts.map +1 -0
  125. package/types/src/hooks/useId.d.ts +9 -0
  126. package/types/src/hooks/useId.d.ts.map +1 -0
  127. package/types/src/hooks/useImperativeElement.d.ts +3 -0
  128. package/types/src/hooks/useImperativeElement.d.ts.map +1 -0
  129. package/types/src/hooks/useLanguage.d.ts +13 -0
  130. package/types/src/hooks/useLanguage.d.ts.map +1 -0
  131. package/types/src/hooks/useMouseDownAndHoldListener.d.ts +13 -0
  132. package/types/src/hooks/useMouseDownAndHoldListener.d.ts.map +1 -0
  133. package/types/src/hooks/useNotifier.d.ts +330 -0
  134. package/types/src/hooks/useNotifier.d.ts.map +1 -0
  135. package/types/src/hooks/useOnClickOrFocusAway.d.ts +8 -0
  136. package/types/src/hooks/useOnClickOrFocusAway.d.ts.map +1 -0
  137. package/types/src/hooks/useOptionalBoundSyncExternalStore.d.ts +20 -0
  138. package/types/src/hooks/useOptionalBoundSyncExternalStore.d.ts.map +1 -0
  139. package/types/src/hooks/useOptionalSyncExternalStore.d.ts +18 -0
  140. package/types/src/hooks/useOptionalSyncExternalStore.d.ts.map +1 -0
  141. package/types/src/hooks/useSynchronizedPointerHandler.d.ts +54 -0
  142. package/types/src/hooks/useSynchronizedPointerHandler.d.ts.map +1 -0
  143. package/types/src/hooks/useTextareaCaretRect.d.ts +85 -0
  144. package/types/src/hooks/useTextareaCaretRect.d.ts.map +1 -0
  145. package/types/src/hooks/useTraceUpdate.d.ts +2 -0
  146. package/types/src/hooks/useTraceUpdate.d.ts.map +1 -0
  147. package/types/src/hooks/useTranslator.d.ts +32 -0
  148. package/types/src/hooks/useTranslator.d.ts.map +1 -0
  149. package/types/src/icons/DynamicIcon.d.ts +17 -0
  150. package/types/src/icons/DynamicIcon.d.ts.map +1 -0
  151. package/types/src/icons/DynamicIconService.d.ts +39 -0
  152. package/types/src/icons/DynamicIconService.d.ts.map +1 -0
  153. package/types/src/icons/ErrorIcon.d.ts +6 -0
  154. package/types/src/icons/ErrorIcon.d.ts.map +1 -0
  155. package/types/src/icons/Types.d.ts +81 -0
  156. package/types/src/icons/Types.d.ts.map +1 -0
  157. package/types/src/icons/WalkingIcon.d.ts +27 -0
  158. package/types/src/icons/WalkingIcon.d.ts.map +1 -0
  159. package/types/src/icons/_Utils.d.ts +3 -0
  160. package/types/src/icons/_Utils.d.ts.map +1 -0
  161. package/types/src/icons/index.d.ts +5 -0
  162. package/types/src/icons/index.d.ts.map +1 -0
  163. package/types/src/icons/packs/Base.d.ts +4 -0
  164. package/types/src/icons/packs/Base.d.ts.map +1 -0
  165. package/types/src/icons/packs/Conditional.d.ts +4 -0
  166. package/types/src/icons/packs/Conditional.d.ts.map +1 -0
  167. package/types/src/index.d.ts +18 -0
  168. package/types/src/index.d.ts.map +1 -0
  169. package/types/src/loading/LoadingPanel.d.ts +31 -0
  170. package/types/src/loading/LoadingPanel.d.ts.map +1 -0
  171. package/types/src/loading/index.d.ts +2 -0
  172. package/types/src/loading/index.d.ts.map +1 -0
  173. package/types/src/persistence/InMemoryStore.d.ts +12 -0
  174. package/types/src/persistence/InMemoryStore.d.ts.map +1 -0
  175. package/types/src/persistence/LocalStorageStore.d.ts +15 -0
  176. package/types/src/persistence/LocalStorageStore.d.ts.map +1 -0
  177. package/types/src/persistence/PersistenceStateProvider.d.ts +3 -0
  178. package/types/src/persistence/PersistenceStateProvider.d.ts.map +1 -0
  179. package/types/src/persistence/Types.d.ts +95 -0
  180. package/types/src/persistence/Types.d.ts.map +1 -0
  181. package/types/src/persistence/_Context.d.ts +9 -0
  182. package/types/src/persistence/_Context.d.ts.map +1 -0
  183. package/types/src/persistence/index.d.ts +6 -0
  184. package/types/src/persistence/index.d.ts.map +1 -0
  185. package/types/src/persistence/usePersistenceState.d.ts +33 -0
  186. package/types/src/persistence/usePersistenceState.d.ts.map +1 -0
  187. package/types/src/react-resizable/Resizable.d.ts +30 -0
  188. package/types/src/react-resizable/Resizable.d.ts.map +1 -0
  189. package/types/src/react-resizable/ResizableBox.d.ts +18 -0
  190. package/types/src/react-resizable/ResizableBox.d.ts.map +1 -0
  191. package/types/src/react-resizable/index.d.ts +11 -0
  192. package/types/src/react-resizable/index.d.ts.map +1 -0
  193. package/types/src/react-resizable/propTypes.d.ts +56 -0
  194. package/types/src/react-resizable/propTypes.d.ts.map +1 -0
  195. package/types/src/react-resizable/utils.d.ts +3 -0
  196. package/types/src/react-resizable/utils.d.ts.map +1 -0
  197. package/types/src/scroll/AxisViewport.d.ts +73 -0
  198. package/types/src/scroll/AxisViewport.d.ts.map +1 -0
  199. package/types/src/scroll/IScrollPane.d.ts +63 -0
  200. package/types/src/scroll/IScrollPane.d.ts.map +1 -0
  201. package/types/src/scroll/IScrollbar.d.ts +94 -0
  202. package/types/src/scroll/IScrollbar.d.ts.map +1 -0
  203. package/types/src/scroll/NativeScrollbar.d.ts +7 -0
  204. package/types/src/scroll/NativeScrollbar.d.ts.map +1 -0
  205. package/types/src/scroll/ScrollButton.d.ts +29 -0
  206. package/types/src/scroll/ScrollButton.d.ts.map +1 -0
  207. package/types/src/scroll/ScrollPane.d.ts +4 -0
  208. package/types/src/scroll/ScrollPane.d.ts.map +1 -0
  209. package/types/src/scroll/Scrollbar.d.ts +4 -0
  210. package/types/src/scroll/Scrollbar.d.ts.map +1 -0
  211. package/types/src/scroll/TouchThumbContext.d.ts +93 -0
  212. package/types/src/scroll/TouchThumbContext.d.ts.map +1 -0
  213. package/types/src/scroll/TouchThumbHandle.d.ts +64 -0
  214. package/types/src/scroll/TouchThumbHandle.d.ts.map +1 -0
  215. package/types/src/scroll/TrackDrag.d.ts +107 -0
  216. package/types/src/scroll/TrackDrag.d.ts.map +1 -0
  217. package/types/src/scroll/Utils.d.ts +8 -0
  218. package/types/src/scroll/Utils.d.ts.map +1 -0
  219. package/types/src/scroll/Viewport.d.ts +285 -0
  220. package/types/src/scroll/Viewport.d.ts.map +1 -0
  221. package/types/src/scroll/VirtualScrollbar.d.ts +49 -0
  222. package/types/src/scroll/VirtualScrollbar.d.ts.map +1 -0
  223. package/types/src/scroll/index.d.ts +14 -0
  224. package/types/src/scroll/index.d.ts.map +1 -0
  225. package/types/src/scroll/scrollbarTheming.d.ts +27 -0
  226. package/types/src/scroll/scrollbarTheming.d.ts.map +1 -0
  227. package/types/src/scroll/useWheelScroll.d.ts +27 -0
  228. package/types/src/scroll/useWheelScroll.d.ts.map +1 -0
  229. package/types/src/scroller/Scroller.d.ts +260 -0
  230. package/types/src/scroller/Scroller.d.ts.map +1 -0
  231. package/types/src/scroller/animate.d.ts +30 -0
  232. package/types/src/scroller/animate.d.ts.map +1 -0
  233. package/types/src/scroller/index.d.ts +2 -0
  234. package/types/src/scroller/index.d.ts.map +1 -0
  235. package/types/src/singletonHook/components/SingleItemContainer.d.ts +6 -0
  236. package/types/src/singletonHook/components/SingleItemContainer.d.ts.map +1 -0
  237. package/types/src/singletonHook/components/SingletonHooksContainer.d.ts +7 -0
  238. package/types/src/singletonHook/components/SingletonHooksContainer.d.ts.map +1 -0
  239. package/types/src/singletonHook/index.d.ts +11 -0
  240. package/types/src/singletonHook/index.d.ts.map +1 -0
  241. package/types/src/singletonHook/singletonHook.d.ts +6 -0
  242. package/types/src/singletonHook/singletonHook.d.ts.map +1 -0
  243. package/types/src/singletonHook/utils/env.d.ts +4 -0
  244. package/types/src/singletonHook/utils/env.d.ts.map +1 -0
  245. package/types/src/singletonHook/utils/env.native.d.ts +1 -0
  246. package/types/src/singletonHook/utils/env.native.d.ts.map +1 -0
  247. package/types/src/singletonHook/utils/warning.d.ts +2 -0
  248. package/types/src/singletonHook/utils/warning.d.ts.map +1 -0
  249. package/types/src/splitPane/SplitPane.d.ts +91 -0
  250. package/types/src/splitPane/SplitPane.d.ts.map +1 -0
  251. package/types/src/splitPane/SplitPaneResizer.d.ts +11 -0
  252. package/types/src/splitPane/SplitPaneResizer.d.ts.map +1 -0
  253. package/types/src/splitPane/index.d.ts +3 -0
  254. package/types/src/splitPane/index.d.ts.map +1 -0
  255. package/types/src/theme/TokenTheme.d.ts +196 -0
  256. package/types/src/theme/TokenTheme.d.ts.map +1 -0
  257. package/types/src/theme/TokenThemeProvider.d.ts +97 -0
  258. package/types/src/theme/TokenThemeProvider.d.ts.map +1 -0
  259. package/types/src/theme/buildThemeCSS.d.ts +54 -0
  260. package/types/src/theme/buildThemeCSS.d.ts.map +1 -0
  261. package/types/src/theme/createThemeVars.d.ts +15 -0
  262. package/types/src/theme/createThemeVars.d.ts.map +1 -0
  263. package/types/src/theme/defaultTheme.d.ts +15 -0
  264. package/types/src/theme/defaultTheme.d.ts.map +1 -0
  265. package/types/src/theme/index.d.ts +9 -0
  266. package/types/src/theme/index.d.ts.map +1 -0
  267. package/types/src/theme/resolveTokens.d.ts +21 -0
  268. package/types/src/theme/resolveTokens.d.ts.map +1 -0
  269. package/types/src/theme/themeAttrs.d.ts +32 -0
  270. package/types/src/theme/themeAttrs.d.ts.map +1 -0
  271. package/types/src/theme/useResolvedThemeMode.d.ts +17 -0
  272. package/types/src/theme/useResolvedThemeMode.d.ts.map +1 -0
  273. package/types/src/types/Types.d.ts +71 -0
  274. package/types/src/types/Types.d.ts.map +1 -0
  275. package/types/src/types/index.d.ts +2 -0
  276. package/types/src/types/index.d.ts.map +1 -0
  277. package/types/src/utils/FullScreenPortal.d.ts +6 -0
  278. package/types/src/utils/FullScreenPortal.d.ts.map +1 -0
  279. package/types/src/utils/PinchZoom.d.ts +3 -0
  280. package/types/src/utils/PinchZoom.d.ts.map +1 -0
  281. package/types/src/utils/ReactUtils.d.ts +134 -0
  282. package/types/src/utils/ReactUtils.d.ts.map +1 -0
  283. package/types/src/utils/index.d.ts +4 -0
  284. package/types/src/utils/index.d.ts.map +1 -0
  285. package/types/src/utils/useFullScreen.d.ts +47 -0
  286. package/types/src/utils/useFullScreen.d.ts.map +1 -0
  287. package/browser/cjs/O75UN37bxYdOt58p.cjs +0 -6
  288. package/browser/esm/r7vPXPCC6zFI-B4m.mjs +0 -12
  289. package/node/assets/style.css +0 -1
  290. package/node/esm/CJ8rg6a2gULy0991.mjs +0 -12
@@ -0,0 +1,134 @@
1
+ export declare const focusableNodeNames: Set<string>;
2
+ export declare const EmptyCssProperties: React.CSSProperties;
3
+ /**
4
+ * Whether `el` is a DOM text-editable — a text `<input>`, a `<textarea>`, or a `contenteditable`. That
5
+ * is: "does the browser's native caret/clipboard apply here", which is the question both the
6
+ * **input-clipboard injector** (whose commands act on this element) and keystroke diagnostics ask. One
7
+ * definition, low in the stack, so the two can't drift.
8
+ */
9
+ export declare function isEditable(el: Element | null | undefined): boolean;
10
+ /**
11
+ * Replace `[start, end)` of a text field with `text` **as a user edit** — the browser records it on the
12
+ * element's own undo stack, and a native `input` event fires so a controlled React input picks it up.
13
+ *
14
+ * Any programmatic edit that goes around this (assigning `.value`, or pushing new text through React's
15
+ * controlled `value`) is invisible to the browser's undo history — and worse, assigning `.value`
16
+ * *clears* it. So a feature that rewrites the field's text on the user's behalf (paste-insert, the
17
+ * formula editor's F9) has to go through here, or the very next `ctrl+Z` does nothing (or something
18
+ * older and more surprising). This is the same undo stack the input-clipboard injector's `undo`/`redo`
19
+ * drive, which is what makes them one coherent history rather than two.
20
+ *
21
+ * `execCommand` is deprecated but is still the only API that writes to that history; `setRangeText` is
22
+ * the fallback for anywhere it isn't honored (it edits correctly, it just isn't undoable).
23
+ *
24
+ * @returns `false` if the element could not be edited at all.
25
+ */
26
+ export declare function replaceRangeText(el: HTMLInputElement | HTMLTextAreaElement, start: number, end: number, text: string): boolean;
27
+ /**
28
+ * Re-export detectIt.
29
+ *
30
+ * @returns The `detect-it` library.
31
+ */
32
+ export declare function detectIt(): {
33
+ supportsPassiveEvents: boolean;
34
+ supportsPointerEvents: boolean;
35
+ supportsTouchEvents: boolean;
36
+ deviceType: 'mouseOnly' | 'touchOnly' | 'hybrid';
37
+ primaryInput: 'mouse' | 'touch';
38
+ };
39
+ /**
40
+ * The current device pixel ratio (always `>= 1`). Safe to call outside the DOM.
41
+ */
42
+ export declare function getDevicePixelRatio(): number;
43
+ /**
44
+ * Round a CSS stroke width to a whole number of device pixels (minimum 1 device
45
+ * pixel), returned in CSS pixels.
46
+ *
47
+ * A fractional device-pixel width (e.g. a 1px CSS stroke at a 1.5 dpr) cannot
48
+ * render crisply - the browser anti-aliases it, and the result drifts as the dpr
49
+ * changes. Rounding to whole device pixels keeps the stroke crisp at any dpr.
50
+ */
51
+ export declare function snapDeviceWidth(cssWidth: number, dpr?: number): number;
52
+ /**
53
+ * Snap a CSS coordinate to a whole device-pixel boundary.
54
+ *
55
+ * Use for line endpoints and the edges of filled rectangles, so two shapes that
56
+ * share an edge resolve to the same device pixel (no seam, no overlap).
57
+ */
58
+ export declare function snapDeviceEdge(cssPoint: number, dpr?: number): number;
59
+ /**
60
+ * Snap the CENTER of a stroke so it renders crisply for the given width.
61
+ *
62
+ * A stroke is crisp when both of its edges land on device-pixel boundaries. That
63
+ * requires an odd device-pixel width to be centered on a half device pixel, and
64
+ * an even width on a whole device pixel. Two layers that snap the same boundary
65
+ * coordinate with the same width resolve to the same device pixels, so they line
66
+ * up with each other (and stay aligned and crisp across device pixel ratios).
67
+ *
68
+ * This is the device-aware replacement for the former (no-op) `boundPixel`.
69
+ *
70
+ * @param cssCenter The desired stroke center, in CSS pixels.
71
+ * @param cssWidth The stroke width, in CSS pixels (used only for odd/even parity).
72
+ */
73
+ export declare function snapLineCenter(cssCenter: number, cssWidth?: number, dpr?: number): number;
74
+ /**
75
+ * Which side of a divider an edge belongs to. `leading` = left/top, `trailing` =
76
+ * right/bottom. Determines outward growth for even-width strokes (see {@link edgeCenter}).
77
+ */
78
+ export type EdgeKind = 'leading' | 'trailing';
79
+ /**
80
+ * The CSS-pixel shift a stroke takes so it grows OUTWARD from its cell.
81
+ *
82
+ * Odd device widths are already centered (one device px each side of the divider) and
83
+ * never shift. Even device widths snap to a whole device pixel, where the centered
84
+ * result lands the extra pixel *before* the divider; a `trailing` edge then shifts +1
85
+ * device px so it sits *after* it (leading stays before). This is the only case that
86
+ * needs a tie-break.
87
+ */
88
+ export declare function edgeTrailingShift(edge: EdgeKind, deviceWidth: number, dpr?: number): number;
89
+ /**
90
+ * The snapped CSS center a stroke of `deviceWidth` device px sits at for a boundary at
91
+ * `boundaryCss`, accounting for crisp parity ({@link snapLineCenter}) and edge-aware
92
+ * outward growth ({@link edgeTrailingShift}).
93
+ *
94
+ * This is the single placement rule shared by gridlines, cell borders, and range
95
+ * overlays - anything that calls it lands on the same device pixels and lines up.
96
+ */
97
+ export declare function edgeCenter(boundaryCss: number, edge: EdgeKind, deviceWidth: number, dpr?: number): number;
98
+ export declare const toPrettyKeyCode: (key: string) => string;
99
+ /**
100
+ * Creates a React synthetic event from a native DOM event.
101
+ *
102
+ * @remarks
103
+ * This helper creates a synthetic event wrapper that mimics React's SyntheticEvent behavior,
104
+ * including proper type inference for specific event types (PointerEvent, MouseEvent, etc.).
105
+ *
106
+ * @template T - The element type (extends Element)
107
+ * @template E - The native event type (extends Event)
108
+ *
109
+ * @param event - The native DOM event to wrap
110
+ * @param currentTarget - Optional override for currentTarget (useful for portals/delegated events)
111
+ *
112
+ * @returns A React synthetic event with all standard properties and methods
113
+ *
114
+ * @example
115
+ * ```typescript
116
+ * // Basic usage
117
+ * const syntheticEvent = createSyntheticEvent<HTMLDivElement, PointerEvent>(nativePointerEvent);
118
+ *
119
+ * // With custom currentTarget (for portals)
120
+ * const syntheticEvent = createSyntheticEvent<HTMLDivElement, PointerEvent>(
121
+ * nativePointerEvent,
122
+ * portalElement
123
+ * );
124
+ * ```
125
+ */
126
+ export declare const createSyntheticEvent: <T extends Element, E extends Event, R extends React.SyntheticEvent<T, E>>(event: E, currentTarget?: EventTarget & T) => R;
127
+ /**
128
+ * Finds the React 18/19 root element by walking up the DOM tree.
129
+ * React 18+ attaches event listeners to the root element passed to createRoot().
130
+ *
131
+ * @param element - Any element within the React tree
132
+ * @returns The React root element, or document.body as fallback
133
+ */
134
+ //# sourceMappingURL=ReactUtils.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReactUtils.d.ts","sourceRoot":"","sources":["../../../../src/utils/ReactUtils.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,kBAAkB,aAA2C,CAAC;AAE3E,eAAO,MAAM,kBAAkB,EAAC,KAAK,CAAC,aAAkB,CAAC;AAOzD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAMlE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,gBAAgB,GAAG,mBAAmB,EAC1C,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAeT;AAGD;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI;IAC1B,qBAAqB,EAAE,OAAO,CAAA;IAC9B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IACjD,YAAY,EAAE,OAAO,GAAG,OAAO,CAAA;CAChC,CAEA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAA8B,GAAG,MAAM,CAE7F;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAA8B,GAAG,MAAM,CAE5F;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,EAAE,GAAG,GAAE,MAA8B,GAAG,MAAM,CAInH;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAA8B,GAAG,MAAM,CAElH;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAA8B,GAAG,MAAM,CAEhI;AAED,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,WAI1C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAC3G,OAAO,CAAC,EACR,gBAAgB,WAAW,GAAG,CAAC,KAC9B,CA0CF,CAAC;AAEF;;;;;;GAMG"}
@@ -0,0 +1,4 @@
1
+ export * as ReactUtils from './ReactUtils';
2
+ export * from './useFullScreen';
3
+ export * from './FullScreenPortal';
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,cAAc,CAAC;AAE3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}
@@ -0,0 +1,47 @@
1
+ import { RefObject } from 'react';
2
+ /**
3
+ * React hook for controlling the Fullscreen API.
4
+ *
5
+ * Correctly handles restricted contexts such as iframes where
6
+ * `document.fullscreenEnabled` may be `true` but the Permissions Policy
7
+ * actually blocks the API. Detection is performed in order:
8
+ *
9
+ * 1. `document.permissionsPolicy?.allowsFeature('fullscreen')` (modern)
10
+ * 2. `document.featurePolicy?.allowsFeature('fullscreen')` (older Chrome)
11
+ * 3. `document.fullscreenEnabled` (fallback)
12
+ *
13
+ * If `requestFullscreen` throws a `TypeError` at runtime, `isFullscreenAvailable`
14
+ * is reactively set to `false` so the UI can hide or disable the button.
15
+ */
16
+ interface UseFullscreenProps {
17
+ /** The element to make fullscreen. Defaults to `document.documentElement`. */
18
+ target?: RefObject<Element | null>;
19
+ /** Called whenever the fullscreen state changes. */
20
+ onChange?: (event: Event) => void;
21
+ /** Called when a fullscreen error occurs. */
22
+ onError?: (event: Event) => void;
23
+ /** Options forwarded to `requestFullscreen`. */
24
+ requestFullScreenOptions?: FullscreenOptions;
25
+ }
26
+ /**
27
+ * Controls the browser Fullscreen API for a target element.
28
+ *
29
+ * @param props - See {@link UseFullscreenProps}.
30
+ * @returns
31
+ * - `isFullscreenAvailable` — `true` when the current context permits fullscreen.
32
+ * - `isFullscreenEnabled` — `true` when an element is currently fullscreen.
33
+ * - `fullscreenElement` — The element that is currently fullscreen, or `null`.
34
+ * - `enableFullscreen` — Requests fullscreen on the target element.
35
+ * - `disableFullscreen` — Exits fullscreen.
36
+ * - `toggleFullscreen` — Toggles between fullscreen and normal.
37
+ */
38
+ export declare function useFullscreen(props?: UseFullscreenProps): {
39
+ isFullscreenAvailable: boolean;
40
+ fullscreenElement: Element | null;
41
+ isFullscreenEnabled: boolean;
42
+ enableFullscreen: () => Promise<void>;
43
+ disableFullscreen: () => Promise<void>;
44
+ toggleFullscreen: () => Promise<void>;
45
+ };
46
+ export {};
47
+ //# sourceMappingURL=useFullScreen.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useFullScreen.d.ts","sourceRoot":"","sources":["../../../../src/utils/useFullScreen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzE;;;;;;;;;;;;;GAaG;AAEH,UAAU,kBAAkB;IAC1B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACnC,oDAAoD;IACpD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAClC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,gDAAgD;IAChD,wBAAwB,CAAC,EAAE,iBAAiB,CAAC;CAC9C;AAeD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,kBAAuB;;;;;;;EAuE3D"}