cx 26.1.3 → 26.1.4

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 (569) hide show
  1. package/.mocharc.json +5 -5
  2. package/LICENSE-THIRD-PARTY.md +91 -91
  3. package/LICENSE.md +7 -7
  4. package/README.md +46 -46
  5. package/build/ui/Widget.d.ts +1 -1
  6. package/build/ui/exprHelpers.d.ts +8 -0
  7. package/build/ui/exprHelpers.js +11 -0
  8. package/build/widgets/overlay/Overlay.d.ts +3 -3
  9. package/build.js +133 -133
  10. package/dist/manifest.js +893 -893
  11. package/dist/ui.js +18 -4
  12. package/dist/util.js +0 -4
  13. package/dist/widgets.js +320 -395
  14. package/package.json +100 -100
  15. package/src/charts/Bar.scss +28 -28
  16. package/src/charts/Bar.ts +114 -114
  17. package/src/charts/BarGraph.scss +28 -28
  18. package/src/charts/BarGraph.tsx +145 -145
  19. package/src/charts/BubbleGraph.scss +31 -31
  20. package/src/charts/BubbleGraph.tsx +165 -165
  21. package/src/charts/Chart.ts +108 -108
  22. package/src/charts/ColorMap.ts +150 -150
  23. package/src/charts/Column.scss +28 -28
  24. package/src/charts/Column.ts +124 -124
  25. package/src/charts/ColumnBarBase.tsx +284 -284
  26. package/src/charts/ColumnBarGraphBase.tsx +229 -229
  27. package/src/charts/ColumnGraph.scss +29 -29
  28. package/src/charts/ColumnGraph.tsx +153 -153
  29. package/src/charts/Grid.ts +5 -5
  30. package/src/charts/Gridlines.scss +24 -24
  31. package/src/charts/Gridlines.tsx +88 -88
  32. package/src/charts/Legend.scss +50 -50
  33. package/src/charts/Legend.tsx +270 -270
  34. package/src/charts/LegendEntry.scss +29 -29
  35. package/src/charts/LegendEntry.tsx +197 -197
  36. package/src/charts/LineGraph.scss +24 -24
  37. package/src/charts/LineGraph.tsx +455 -455
  38. package/src/charts/Marker.scss +43 -43
  39. package/src/charts/Marker.tsx +483 -483
  40. package/src/charts/MarkerLine.scss +19 -19
  41. package/src/charts/MarkerLine.tsx +214 -214
  42. package/src/charts/MouseTracker.tsx +112 -112
  43. package/src/charts/Pie.ts +8 -8
  44. package/src/charts/PieChart.scss +28 -28
  45. package/src/charts/PieChart.tsx +717 -717
  46. package/src/charts/PieLabel.tsx +106 -106
  47. package/src/charts/PieLabelsContainer.ts +68 -68
  48. package/src/charts/Range.scss +19 -19
  49. package/src/charts/Range.tsx +318 -318
  50. package/src/charts/RangeMarker.scss +17 -17
  51. package/src/charts/RangeMarker.tsx +233 -233
  52. package/src/charts/ScatterGraph.scss +23 -23
  53. package/src/charts/ScatterGraph.tsx +245 -245
  54. package/src/charts/Swimlane.scss +16 -16
  55. package/src/charts/Swimlane.tsx +195 -195
  56. package/src/charts/Swimlanes.scss +16 -16
  57. package/src/charts/Swimlanes.tsx +179 -179
  58. package/src/charts/axis/Axis.scss +22 -22
  59. package/src/charts/axis/Axis.tsx +444 -444
  60. package/src/charts/axis/CategoryAxis.scss +34 -34
  61. package/src/charts/axis/CategoryAxis.tsx +313 -313
  62. package/src/charts/axis/NumericAxis.scss +34 -34
  63. package/src/charts/axis/NumericAxis.tsx +437 -437
  64. package/src/charts/axis/Stack.ts +61 -61
  65. package/src/charts/axis/TimeAxis.scss +33 -33
  66. package/src/charts/axis/TimeAxis.tsx +718 -718
  67. package/src/charts/axis/index.scss +5 -5
  68. package/src/charts/axis/index.ts +3 -3
  69. package/src/charts/axis/variables.scss +2 -2
  70. package/src/charts/helpers/MinMaxFinder.ts +66 -66
  71. package/src/charts/helpers/PointReducer.ts +135 -135
  72. package/src/charts/helpers/SnapPointFinder.ts +136 -136
  73. package/src/charts/helpers/ValueAtFinder.ts +72 -72
  74. package/src/charts/helpers/index.ts +4 -4
  75. package/src/charts/index.scss +22 -22
  76. package/src/charts/index.ts +34 -34
  77. package/src/charts/palette.scss +97 -97
  78. package/src/charts/shapes.tsx +86 -86
  79. package/src/charts/variables.scss +22 -22
  80. package/src/core.d.ts +182 -182
  81. package/src/data/AggregateFunction.ts +171 -171
  82. package/src/data/ArrayElementView.spec.ts +88 -88
  83. package/src/data/ArrayElementView.ts +91 -91
  84. package/src/data/ArrayRef.ts +34 -34
  85. package/src/data/AugmentedViewBase.ts +88 -88
  86. package/src/data/Binding.spec.ts +69 -69
  87. package/src/data/Binding.ts +104 -104
  88. package/src/data/ExposedRecordView.ts +95 -95
  89. package/src/data/ExposedValueView.ts +89 -89
  90. package/src/data/Expression.spec.ts +229 -229
  91. package/src/data/Expression.ts +233 -233
  92. package/src/data/Grouper.spec.ts +57 -57
  93. package/src/data/Grouper.ts +158 -158
  94. package/src/data/NestedDataView.ts +43 -43
  95. package/src/data/ReadOnlyDataView.ts +39 -39
  96. package/src/data/Ref.spec.ts +79 -79
  97. package/src/data/Ref.ts +104 -104
  98. package/src/data/Selector.ts +10 -10
  99. package/src/data/Store.spec.ts +22 -22
  100. package/src/data/Store.ts +52 -52
  101. package/src/data/StoreProxy.ts +19 -19
  102. package/src/data/StoreRef.spec.ts +24 -24
  103. package/src/data/StoreRef.ts +66 -66
  104. package/src/data/StringTemplate.spec.ts +132 -132
  105. package/src/data/StringTemplate.ts +93 -93
  106. package/src/data/StructuredSelector.spec.ts +113 -113
  107. package/src/data/StructuredSelector.ts +146 -146
  108. package/src/data/SubscribableView.ts +63 -63
  109. package/src/data/View.spec.ts +60 -60
  110. package/src/data/View.ts +289 -289
  111. package/src/data/ZoomIntoPropertyView.spec.ts +64 -64
  112. package/src/data/ZoomIntoPropertyView.ts +45 -45
  113. package/src/data/comparer.spec.ts +60 -60
  114. package/src/data/comparer.ts +78 -78
  115. package/src/data/computable.spec.ts +87 -87
  116. package/src/data/computable.ts +69 -69
  117. package/src/data/createAccessorModelProxy.spec.tsx +145 -145
  118. package/src/data/createAccessorModelProxy.ts +66 -66
  119. package/src/data/createStructuredSelector.spec.ts +45 -45
  120. package/src/data/createStructuredSelector.ts +62 -62
  121. package/src/data/defaultCompare.ts +14 -14
  122. package/src/data/diff/diffArrays.ts +49 -49
  123. package/src/data/diff/diffs.spec.ts +49 -49
  124. package/src/data/diff/index.ts +1 -1
  125. package/src/data/enableFatArrowExpansion.ts +6 -6
  126. package/src/data/getAccessor.spec.ts +11 -11
  127. package/src/data/getAccessor.ts +74 -74
  128. package/src/data/getSelector.spec.ts +43 -43
  129. package/src/data/getSelector.ts +66 -66
  130. package/src/data/index.ts +30 -30
  131. package/src/data/isSelector.ts +26 -26
  132. package/src/data/ops/append.spec.ts +28 -28
  133. package/src/data/ops/append.ts +5 -5
  134. package/src/data/ops/filter.spec.ts +35 -35
  135. package/src/data/ops/filter.ts +9 -9
  136. package/src/data/ops/findTreeNode.spec.ts +23 -23
  137. package/src/data/ops/findTreeNode.ts +14 -14
  138. package/src/data/ops/findTreePath.ts +23 -23
  139. package/src/data/ops/index.ts +11 -11
  140. package/src/data/ops/insertElement.ts +3 -3
  141. package/src/data/ops/merge.spec.ts +27 -27
  142. package/src/data/ops/merge.ts +13 -13
  143. package/src/data/ops/moveElement.ts +21 -21
  144. package/src/data/ops/removeTreeNodes.spec.ts +37 -37
  145. package/src/data/ops/removeTreeNodes.ts +15 -15
  146. package/src/data/ops/updateArray.spec.ts +69 -69
  147. package/src/data/ops/updateArray.ts +31 -31
  148. package/src/data/ops/updateTree.spec.ts +54 -54
  149. package/src/data/ops/updateTree.ts +23 -23
  150. package/src/data/test-types.ts +7 -7
  151. package/src/global.scss +13 -13
  152. package/src/hooks/createLocalStorageRef.ts +21 -21
  153. package/src/hooks/index.ts +8 -8
  154. package/src/hooks/invokeCallback.spec.tsx +59 -59
  155. package/src/hooks/invokeCallback.ts +8 -8
  156. package/src/hooks/resolveCallback.spec.tsx +71 -71
  157. package/src/hooks/resolveCallback.ts +16 -16
  158. package/src/hooks/store.spec.tsx +67 -67
  159. package/src/hooks/store.ts +46 -46
  160. package/src/hooks/useEffect.ts +14 -14
  161. package/src/hooks/useInterval.ts +8 -8
  162. package/src/hooks/useState.ts +20 -20
  163. package/src/hooks/useTrigger.spec.tsx +105 -105
  164. package/src/hooks/useTrigger.ts +26 -26
  165. package/src/index.scss +6 -6
  166. package/src/index.ts +7 -7
  167. package/src/jsx-dev-runtime.ts +4 -4
  168. package/src/jsx-runtime.spec.tsx +431 -431
  169. package/src/jsx-runtime.ts +79 -79
  170. package/src/locale/de-de.ts +76 -76
  171. package/src/locale/en-us.ts +75 -75
  172. package/src/locale/es-es.ts +76 -76
  173. package/src/locale/fr-fr.ts +76 -76
  174. package/src/locale/nl-nl.ts +76 -76
  175. package/src/locale/pt-pt.ts +76 -76
  176. package/src/locale/sr-latn-ba.ts +76 -76
  177. package/src/svg/BoundedObject.ts +101 -101
  178. package/src/svg/ClipRect.tsx +29 -29
  179. package/src/svg/Ellipse.tsx +68 -68
  180. package/src/svg/Line.tsx +58 -58
  181. package/src/svg/NonOverlappingRect.ts +26 -26
  182. package/src/svg/NonOverlappingRectGroup.ts +49 -49
  183. package/src/svg/Rectangle.tsx +90 -90
  184. package/src/svg/Svg.scss +27 -27
  185. package/src/svg/Svg.tsx +241 -241
  186. package/src/svg/Text.tsx +134 -134
  187. package/src/svg/TextualBoundedObject.ts +35 -35
  188. package/src/svg/index.scss +8 -8
  189. package/src/svg/index.ts +17 -17
  190. package/src/svg/util/Rect.ts +105 -105
  191. package/src/ui/CSS.ts +87 -87
  192. package/src/ui/CSSHelper.ts +17 -17
  193. package/src/ui/Container.tsx +216 -216
  194. package/src/ui/ContentResolver.spec.tsx +585 -585
  195. package/src/ui/ContentResolver.ts +132 -132
  196. package/src/ui/Controller.spec.tsx +574 -574
  197. package/src/ui/Controller.ts +202 -202
  198. package/src/ui/Culture.ts +159 -159
  199. package/src/ui/Cx.spec.tsx +210 -210
  200. package/src/ui/Cx.tsx +386 -386
  201. package/src/ui/DataProxy.spec.tsx +337 -337
  202. package/src/ui/DataProxy.ts +55 -55
  203. package/src/ui/DetachedScope.tsx +159 -159
  204. package/src/ui/FocusManager.ts +171 -171
  205. package/src/ui/Format.ts +108 -108
  206. package/src/ui/HoverSync.tsx +189 -189
  207. package/src/ui/Instance.ts +866 -866
  208. package/src/ui/IsolatedScope.spec.tsx +62 -62
  209. package/src/ui/IsolatedScope.ts +50 -50
  210. package/src/ui/Localization.ts +70 -70
  211. package/src/ui/Prop.ts +140 -140
  212. package/src/ui/PureContainer.spec.tsx +232 -232
  213. package/src/ui/PureContainer.tsx +19 -19
  214. package/src/ui/RenderingContext.ts +99 -99
  215. package/src/ui/Repeater.spec.tsx +143 -143
  216. package/src/ui/Repeater.ts +194 -194
  217. package/src/ui/Rescope.spec.tsx +199 -199
  218. package/src/ui/Rescope.ts +49 -49
  219. package/src/ui/ResizeManager.ts +30 -30
  220. package/src/ui/Restate.spec.tsx +422 -422
  221. package/src/ui/Restate.tsx +217 -217
  222. package/src/ui/StaticText.ts +11 -11
  223. package/src/ui/StructuredInstanceDataAccessor.ts +32 -32
  224. package/src/ui/Text.ts +49 -49
  225. package/src/ui/VDOM.ts +1 -1
  226. package/src/ui/Widget.spec.tsx +53 -53
  227. package/src/ui/Widget.tsx +301 -301
  228. package/src/ui/ZIndexManager.ts +11 -11
  229. package/src/ui/adapter/ArrayAdapter.spec.ts +55 -55
  230. package/src/ui/adapter/ArrayAdapter.ts +229 -229
  231. package/src/ui/adapter/DataAdapter.ts +52 -52
  232. package/src/ui/adapter/GroupAdapter.ts +235 -235
  233. package/src/ui/adapter/TreeAdapter.spec.ts +76 -76
  234. package/src/ui/adapter/TreeAdapter.ts +185 -185
  235. package/src/ui/adapter/index.ts +4 -4
  236. package/src/ui/app/History.ts +133 -133
  237. package/src/ui/app/Url.spec.ts +50 -50
  238. package/src/ui/app/Url.ts +102 -102
  239. package/src/ui/app/index.ts +5 -5
  240. package/src/ui/app/startAppLoop.tsx +71 -71
  241. package/src/ui/app/startHotAppLoop.ts +41 -41
  242. package/src/ui/batchUpdates.ts +77 -77
  243. package/src/ui/bind.ts +10 -10
  244. package/src/ui/createFunctionalComponent.spec.tsx +454 -454
  245. package/src/ui/createFunctionalComponent.ts +86 -86
  246. package/src/ui/expr.ts +47 -47
  247. package/src/ui/exprHelpers.spec.ts +412 -379
  248. package/src/ui/exprHelpers.ts +95 -78
  249. package/src/ui/flattenProps.ts +21 -21
  250. package/src/ui/index.scss +2 -2
  251. package/src/ui/index.ts +47 -47
  252. package/src/ui/keyboardShortcuts.ts +40 -40
  253. package/src/ui/layout/Content.ts +30 -30
  254. package/src/ui/layout/ContentPlaceholder.spec.tsx +599 -599
  255. package/src/ui/layout/ContentPlaceholder.ts +133 -133
  256. package/src/ui/layout/FirstVisibleChildLayout.spec.tsx +207 -207
  257. package/src/ui/layout/FirstVisibleChildLayout.ts +60 -60
  258. package/src/ui/layout/LabelsLeftLayout.scss +46 -46
  259. package/src/ui/layout/LabelsLeftLayout.tsx +76 -76
  260. package/src/ui/layout/LabelsTopLayout.scss +64 -64
  261. package/src/ui/layout/LabelsTopLayout.tsx +156 -156
  262. package/src/ui/layout/UseParentLayout.ts +8 -8
  263. package/src/ui/layout/exploreChildren.ts +38 -38
  264. package/src/ui/layout/index.scss +3 -3
  265. package/src/ui/layout/index.ts +10 -10
  266. package/src/ui/layout/variables.scss +2 -2
  267. package/src/ui/selection/KeySelection.ts +153 -153
  268. package/src/ui/selection/PropertySelection.ts +87 -87
  269. package/src/ui/selection/Selection.ts +128 -128
  270. package/src/ui/selection/index.ts +3 -3
  271. package/src/ui/tpl.ts +4 -4
  272. package/src/ui/variables.scss +1 -1
  273. package/src/util/Component.spec.ts +411 -411
  274. package/src/util/Component.ts +301 -301
  275. package/src/util/Console.ts +13 -13
  276. package/src/util/DOM.ts +88 -88
  277. package/src/util/Debug.ts +71 -71
  278. package/src/util/Format.spec.ts +69 -69
  279. package/src/util/Format.ts +267 -267
  280. package/src/util/GlobalCacheIdentifier.ts +11 -11
  281. package/src/util/KeyCode.ts +21 -21
  282. package/src/util/SubscriberList.ts +86 -86
  283. package/src/util/Timing.ts +58 -58
  284. package/src/util/TraversalStack.spec.ts +53 -53
  285. package/src/util/TraversalStack.ts +47 -47
  286. package/src/util/addEventListenerWithOptions.ts +41 -41
  287. package/src/util/browserSupportsPassiveEventHandlers.ts +20 -20
  288. package/src/util/calculateNaturalElementHeight.ts +22 -22
  289. package/src/util/call-once.scss +6 -6
  290. package/src/util/capitalize.ts +4 -4
  291. package/src/util/coalesce.ts +6 -6
  292. package/src/util/color/hslToRgb.ts +34 -34
  293. package/src/util/color/index.ts +4 -4
  294. package/src/util/color/parseColor.ts +173 -173
  295. package/src/util/color/rgbToHex.ts +14 -14
  296. package/src/util/color/rgbToHsl.ts +35 -35
  297. package/src/util/date/dateDiff.ts +9 -9
  298. package/src/util/date/diff.ts +13 -13
  299. package/src/util/date/encodeDate.ts +8 -8
  300. package/src/util/date/encodeDateWithTimezoneOffset.ts +18 -18
  301. package/src/util/date/index.ts +11 -11
  302. package/src/util/date/lowerBoundCheck.ts +13 -13
  303. package/src/util/date/maxDate.ts +14 -14
  304. package/src/util/date/minDate.ts +14 -14
  305. package/src/util/date/monthStart.ts +8 -8
  306. package/src/util/date/parseDateInvariant.ts +20 -20
  307. package/src/util/date/sameDate.ts +11 -11
  308. package/src/util/date/upperBoundCheck.spec.ts +30 -30
  309. package/src/util/date/upperBoundCheck.ts +13 -13
  310. package/src/util/date/zeroTime.ts +9 -9
  311. package/src/util/debounce.ts +26 -26
  312. package/src/util/dummyCallback.ts +1 -1
  313. package/src/util/escapeSpecialRegexCharacters.ts +8 -8
  314. package/src/util/eventCallbacks.ts +12 -12
  315. package/src/util/expandFatArrows.ts +118 -118
  316. package/src/util/findScrollableParent.ts +15 -15
  317. package/src/util/getActiveElement.ts +4 -4
  318. package/src/util/getParentFrameBoundingClientRect.ts +13 -13
  319. package/src/util/getScrollerBoundingClientRect.ts +12 -12
  320. package/src/util/getSearchQueryPredicate.spec.ts +40 -40
  321. package/src/util/getSearchQueryPredicate.ts +58 -58
  322. package/src/util/getTopLevelBoundingClientRect.ts +7 -7
  323. package/src/util/getVendorPrefix.ts +33 -33
  324. package/src/util/hasKey.ts +18 -18
  325. package/src/util/index.scss +10 -10
  326. package/src/util/index.ts +55 -55
  327. package/src/util/innerTextTrim.ts +10 -10
  328. package/src/util/isArray.ts +3 -3
  329. package/src/util/isDataRecord.ts +5 -5
  330. package/src/util/isDefined.ts +3 -3
  331. package/src/util/isDigit.ts +8 -8
  332. package/src/util/isFunction.ts +3 -3
  333. package/src/util/isNonEmptyArray.ts +3 -3
  334. package/src/util/isNumber.ts +3 -3
  335. package/src/util/isObject.ts +3 -3
  336. package/src/util/isPromise.ts +6 -6
  337. package/src/util/isString.ts +3 -3
  338. package/src/util/isTextInputElement.ts +2 -2
  339. package/src/util/isTouchDevice.ts +7 -7
  340. package/src/util/isTouchEvent.ts +64 -64
  341. package/src/util/isUndefined.ts +3 -3
  342. package/src/util/isValidIdentifierName.spec.ts +33 -33
  343. package/src/util/isValidIdentifierName.ts +5 -5
  344. package/src/util/onIdleCallback.ts +10 -10
  345. package/src/util/parseStyle.ts +29 -29
  346. package/src/util/quote.ts +6 -6
  347. package/src/util/reverseSlice.ts +9 -9
  348. package/src/util/routeAppend.spec.ts +19 -19
  349. package/src/util/routeAppend.ts +15 -15
  350. package/src/util/scrollElementIntoView.ts +40 -40
  351. package/src/util/scss/add-rules.scss +40 -40
  352. package/src/util/scss/calc.scss +44 -44
  353. package/src/util/scss/call-once.scss +12 -12
  354. package/src/util/scss/clockwise.scss +49 -49
  355. package/src/util/scss/colors.scss +9 -9
  356. package/src/util/scss/deep-get.scss +11 -11
  357. package/src/util/scss/deep-merge.scss +21 -21
  358. package/src/util/scss/divide.scss +3 -3
  359. package/src/util/scss/include.scss +48 -48
  360. package/src/util/scss/index.scss +9 -9
  361. package/src/util/shallowEquals.ts +43 -43
  362. package/src/util/test/createTestRenderer.tsx +19 -19
  363. package/src/util/throttle.ts +21 -21
  364. package/src/util/validatedDebounce.ts +23 -23
  365. package/src/variables.scss +217 -217
  366. package/src/widgets/AccessorBindings.spec.tsx +90 -90
  367. package/src/widgets/Button.scss +119 -119
  368. package/src/widgets/Button.tsx +189 -189
  369. package/src/widgets/Button.variables.scss +117 -117
  370. package/src/widgets/CxCredit.scss +39 -39
  371. package/src/widgets/CxCredit.tsx +46 -46
  372. package/src/widgets/DocumentTitle.ts +95 -95
  373. package/src/widgets/FlexBox.scss +148 -148
  374. package/src/widgets/FlexBox.tsx +168 -168
  375. package/src/widgets/Heading.scss +40 -40
  376. package/src/widgets/Heading.ts +42 -42
  377. package/src/widgets/HighlightedSearchText.scss +20 -20
  378. package/src/widgets/HighlightedSearchText.tsx +54 -54
  379. package/src/widgets/HtmlElement.spec.helpers.tsx +108 -108
  380. package/src/widgets/HtmlElement.spec.tsx +89 -89
  381. package/src/widgets/HtmlElement.tsx +407 -407
  382. package/src/widgets/Icon.scss +22 -22
  383. package/src/widgets/Icon.ts +64 -64
  384. package/src/widgets/List.scss +93 -93
  385. package/src/widgets/List.tsx +793 -793
  386. package/src/widgets/ProgressBar.scss +50 -50
  387. package/src/widgets/ProgressBar.tsx +66 -66
  388. package/src/widgets/ReactElementWrapper.spec.tsx +452 -452
  389. package/src/widgets/ReactElementWrapper.tsx +108 -108
  390. package/src/widgets/Resizer.scss +43 -43
  391. package/src/widgets/Resizer.tsx +200 -200
  392. package/src/widgets/Sandbox.ts +103 -103
  393. package/src/widgets/Section.scss +55 -55
  394. package/src/widgets/Section.tsx +187 -187
  395. package/src/widgets/animations.scss +10 -10
  396. package/src/widgets/autoFocus.ts +9 -9
  397. package/src/widgets/cx.ts +63 -63
  398. package/src/widgets/drag-drop/DragClone.scss +35 -35
  399. package/src/widgets/drag-drop/DragHandle.scss +18 -18
  400. package/src/widgets/drag-drop/DragHandle.tsx +47 -47
  401. package/src/widgets/drag-drop/DragSource.scss +26 -26
  402. package/src/widgets/drag-drop/DragSource.tsx +237 -237
  403. package/src/widgets/drag-drop/DropZone.scss +76 -76
  404. package/src/widgets/drag-drop/DropZone.tsx +353 -353
  405. package/src/widgets/drag-drop/index.scss +3 -3
  406. package/src/widgets/drag-drop/index.ts +4 -4
  407. package/src/widgets/drag-drop/ops.tsx +422 -422
  408. package/src/widgets/drag-drop/variables.scss +14 -14
  409. package/src/widgets/enableAllInternalDependencies.ts +11 -11
  410. package/src/widgets/form/Calendar.scss +199 -199
  411. package/src/widgets/form/Calendar.tsx +760 -760
  412. package/src/widgets/form/Calendar.variables.scss +63 -63
  413. package/src/widgets/form/Checkbox.scss +129 -129
  414. package/src/widgets/form/Checkbox.tsx +287 -287
  415. package/src/widgets/form/Checkbox.variables.scss +39 -39
  416. package/src/widgets/form/ColorField.scss +98 -98
  417. package/src/widgets/form/ColorField.tsx +497 -497
  418. package/src/widgets/form/ColorPicker.scss +285 -285
  419. package/src/widgets/form/ColorPicker.tsx +544 -544
  420. package/src/widgets/form/ColorPicker.variables.scss +22 -22
  421. package/src/widgets/form/DateField.ts +21 -21
  422. package/src/widgets/form/DateTimeField.scss +92 -92
  423. package/src/widgets/form/DateTimeField.tsx +726 -726
  424. package/src/widgets/form/DateTimePicker.scss +46 -46
  425. package/src/widgets/form/DateTimePicker.tsx +429 -429
  426. package/src/widgets/form/Field.scss +164 -164
  427. package/src/widgets/form/Field.tsx +608 -608
  428. package/src/widgets/form/FieldGroup.ts +10 -10
  429. package/src/widgets/form/FieldIcon.ts +61 -61
  430. package/src/widgets/form/HelpText.scss +24 -24
  431. package/src/widgets/form/HelpText.ts +15 -15
  432. package/src/widgets/form/Label.scss +37 -37
  433. package/src/widgets/form/Label.tsx +117 -117
  434. package/src/widgets/form/LabeledContainer.ts +77 -77
  435. package/src/widgets/form/LookupField.scss +221 -221
  436. package/src/widgets/form/LookupField.spec.tsx +93 -93
  437. package/src/widgets/form/LookupField.tsx +1421 -1421
  438. package/src/widgets/form/MonthField.scss +100 -100
  439. package/src/widgets/form/MonthField.tsx +670 -670
  440. package/src/widgets/form/MonthPicker.scss +125 -125
  441. package/src/widgets/form/MonthPicker.tsx +822 -822
  442. package/src/widgets/form/NumberField.scss +63 -63
  443. package/src/widgets/form/NumberField.tsx +543 -543
  444. package/src/widgets/form/Radio.scss +123 -123
  445. package/src/widgets/form/Radio.tsx +249 -249
  446. package/src/widgets/form/Radio.variables.scss +45 -45
  447. package/src/widgets/form/Select.scss +101 -101
  448. package/src/widgets/form/Select.tsx +327 -327
  449. package/src/widgets/form/Slider.scss +121 -121
  450. package/src/widgets/form/Slider.tsx +473 -473
  451. package/src/widgets/form/Switch.scss +142 -142
  452. package/src/widgets/form/Switch.tsx +176 -176
  453. package/src/widgets/form/TextArea.scss +45 -45
  454. package/src/widgets/form/TextArea.tsx +229 -229
  455. package/src/widgets/form/TextField.scss +57 -57
  456. package/src/widgets/form/TextField.tsx +407 -407
  457. package/src/widgets/form/TimeField.ts +10 -10
  458. package/src/widgets/form/TimeList.tsx +105 -105
  459. package/src/widgets/form/UploadButton.scss +49 -49
  460. package/src/widgets/form/UploadButton.tsx +307 -307
  461. package/src/widgets/form/ValidationError.scss +22 -22
  462. package/src/widgets/form/ValidationError.tsx +72 -72
  463. package/src/widgets/form/ValidationGroup.spec.tsx +147 -147
  464. package/src/widgets/form/ValidationGroup.ts +141 -141
  465. package/src/widgets/form/Validator.ts +60 -60
  466. package/src/widgets/form/Wheel.scss +152 -152
  467. package/src/widgets/form/Wheel.tsx +314 -314
  468. package/src/widgets/form/index.scss +24 -24
  469. package/src/widgets/form/index.ts +28 -28
  470. package/src/widgets/form/variables.scss +355 -355
  471. package/src/widgets/grid/Grid.scss +640 -640
  472. package/src/widgets/grid/Grid.tsx +4243 -4243
  473. package/src/widgets/grid/GridCell.ts +143 -143
  474. package/src/widgets/grid/GridCellEditor.tsx +58 -58
  475. package/src/widgets/grid/GridRow.ts +302 -302
  476. package/src/widgets/grid/GridRowLine.ts +49 -49
  477. package/src/widgets/grid/Pagination.scss +115 -115
  478. package/src/widgets/grid/Pagination.tsx +126 -126
  479. package/src/widgets/grid/TreeNode.scss +90 -90
  480. package/src/widgets/grid/TreeNode.tsx +154 -154
  481. package/src/widgets/grid/createGridCellEditor.tsx +18 -18
  482. package/src/widgets/grid/index.scss +3 -3
  483. package/src/widgets/grid/index.ts +16 -16
  484. package/src/widgets/grid/variables.scss +137 -137
  485. package/src/widgets/icons/arrow-down.svg +3 -3
  486. package/src/widgets/icons/arrow-right.svg +2 -2
  487. package/src/widgets/icons/base.svg +104 -104
  488. package/src/widgets/icons/calendar-old.svg +169 -169
  489. package/src/widgets/icons/calendar.svg +187 -187
  490. package/src/widgets/icons/calendar.tsx +22 -22
  491. package/src/widgets/icons/check.tsx +14 -14
  492. package/src/widgets/icons/clear.svg +74 -74
  493. package/src/widgets/icons/clear.tsx +16 -16
  494. package/src/widgets/icons/close.svg +74 -74
  495. package/src/widgets/icons/close.tsx +20 -20
  496. package/src/widgets/icons/cx.tsx +39 -39
  497. package/src/widgets/icons/drop-down.tsx +16 -16
  498. package/src/widgets/icons/dropdown-arrow.svg +61 -61
  499. package/src/widgets/icons/file.svg +4 -4
  500. package/src/widgets/icons/file.tsx +14 -14
  501. package/src/widgets/icons/folder-open.svg +5 -5
  502. package/src/widgets/icons/folder-open.tsx +16 -16
  503. package/src/widgets/icons/folder.svg +58 -58
  504. package/src/widgets/icons/folder.tsx +14 -14
  505. package/src/widgets/icons/forward.svg +67 -67
  506. package/src/widgets/icons/forward.tsx +23 -23
  507. package/src/widgets/icons/index.ts +14 -14
  508. package/src/widgets/icons/loading.svg +4 -4
  509. package/src/widgets/icons/loading.tsx +25 -25
  510. package/src/widgets/icons/menu.tsx +18 -18
  511. package/src/widgets/icons/pixel-picker.tsx +18 -18
  512. package/src/widgets/icons/registry.ts +56 -56
  513. package/src/widgets/icons/search.svg +107 -107
  514. package/src/widgets/icons/search.tsx +14 -14
  515. package/src/widgets/icons/sort-asc.svg +3 -3
  516. package/src/widgets/icons/sort-asc.tsx +15 -15
  517. package/src/widgets/icons/square.tsx +19 -19
  518. package/src/widgets/index.d.ts +55 -55
  519. package/src/widgets/index.scss +16 -16
  520. package/src/widgets/index.ts +58 -58
  521. package/src/widgets/nav/Link.scss +20 -20
  522. package/src/widgets/nav/Link.ts +11 -11
  523. package/src/widgets/nav/LinkButton.ts +176 -176
  524. package/src/widgets/nav/Menu.scss +76 -76
  525. package/src/widgets/nav/Menu.tsx +489 -489
  526. package/src/widgets/nav/Menu.variables.scss +25 -25
  527. package/src/widgets/nav/MenuItem.scss +130 -130
  528. package/src/widgets/nav/MenuItem.tsx +525 -525
  529. package/src/widgets/nav/MenuSpacer.ts +18 -18
  530. package/src/widgets/nav/RedirectRoute.ts +49 -49
  531. package/src/widgets/nav/Route.spec.tsx +24 -24
  532. package/src/widgets/nav/Route.ts +142 -142
  533. package/src/widgets/nav/Scroller.scss +148 -148
  534. package/src/widgets/nav/Scroller.tsx +252 -252
  535. package/src/widgets/nav/Submenu.ts +6 -6
  536. package/src/widgets/nav/Tab.scss +82 -82
  537. package/src/widgets/nav/Tab.ts +120 -120
  538. package/src/widgets/nav/Tab.variables.scss +84 -84
  539. package/src/widgets/nav/cover.scss +22 -22
  540. package/src/widgets/nav/index.scss +5 -5
  541. package/src/widgets/nav/index.ts +10 -10
  542. package/src/widgets/nav/variables.scss +27 -27
  543. package/src/widgets/overlay/ContextMenu.ts +42 -42
  544. package/src/widgets/overlay/Dropdown.scss +186 -186
  545. package/src/widgets/overlay/Dropdown.tsx +762 -762
  546. package/src/widgets/overlay/FlyweightTooltipTracker.ts +57 -57
  547. package/src/widgets/overlay/MsgBox.tsx +141 -141
  548. package/src/widgets/overlay/Overlay.scss +68 -68
  549. package/src/widgets/overlay/Overlay.tsx +947 -947
  550. package/src/widgets/overlay/Toast.scss +163 -163
  551. package/src/widgets/overlay/Toast.ts +111 -111
  552. package/src/widgets/overlay/Tooltip.scss +177 -177
  553. package/src/widgets/overlay/Tooltip.tsx +393 -393
  554. package/src/widgets/overlay/Window.scss +129 -129
  555. package/src/widgets/overlay/Window.tsx +299 -299
  556. package/src/widgets/overlay/Window.variables.scss +62 -62
  557. package/src/widgets/overlay/alerts.ts +46 -46
  558. package/src/widgets/overlay/captureMouse.scss +13 -13
  559. package/src/widgets/overlay/captureMouse.ts +195 -195
  560. package/src/widgets/overlay/createHotPromiseWindowFactory.ts +71 -71
  561. package/src/widgets/overlay/index.d.ts +11 -11
  562. package/src/widgets/overlay/index.scss +15 -15
  563. package/src/widgets/overlay/index.ts +11 -11
  564. package/src/widgets/overlay/tooltip-ops.ts +173 -173
  565. package/src/widgets/overlay/variables.scss +85 -85
  566. package/src/widgets/variables.scss +146 -146
  567. package/tsconfig.compile.json +4 -4
  568. package/tsconfig.json +34 -34
  569. package/tsconfig.mocha.json +14 -14
@@ -1,437 +1,437 @@
1
- /** @jsxImportSource react */
2
-
3
- import { Axis, AxisConfig, AxisInstance } from "./Axis";
4
- import { VDOM } from "../../ui/Widget";
5
- import { Stack } from "./Stack";
6
- import { Format } from "../../util/Format";
7
- import { isNumber } from "../../util/isNumber";
8
- import { RenderingContext } from "../../ui/RenderingContext";
9
- import { NumberProp, BooleanProp, StringProp } from "../../ui/Prop";
10
- import { Console } from "../../util/Console";
11
-
12
- export interface NumericAxisConfig extends AxisConfig {
13
- /** Minimum value. */
14
- min?: NumberProp;
15
-
16
- /** Maximum value. */
17
- max?: NumberProp;
18
-
19
- /** Set to `true` to normalize the input range. */
20
- normalized?: BooleanProp;
21
-
22
- /** Number used to divide values before rendering axis labels. Default value is `1`. */
23
- labelDivisor?: NumberProp;
24
-
25
- /** Base CSS class to be applied to the element. Defaults to `numericaxis`. */
26
- baseClass?: string;
27
-
28
- tickDivisions?: Array<number[]>;
29
-
30
- /** A number ranged between `0-2`. `0` means that the range is aligned with the lowest ticks. Default value is `1`, which means that the range is aligned with medium ticks. Use value `2` to align with major ticks. */
31
- snapToTicks?: 0 | 1 | 2;
32
-
33
- /** Value format. Default is `n`. */
34
- format?: StringProp;
35
-
36
- /** Size of a zone reserved for labels for both lower and upper end of the axis. */
37
- deadZone?: NumberProp;
38
-
39
- /** Size of a zone reserved for labels near the upper (higher) end of the axis. */
40
- upperDeadZone?: NumberProp;
41
-
42
- /** Size of a zone reserved for labels near the lower end of the axis. */
43
- lowerDeadZone?: NumberProp;
44
-
45
- /** Specifies minimum value increment between labels. Useful when formatting is not flexible enough, i.e. set to 1 for integer axes to avoid duplicate labels. */
46
- minLabelTickSize?: number;
47
-
48
- minTickStep?: number;
49
- }
50
-
51
- export class NumericAxis extends Axis {
52
- declare deadZone: number;
53
- declare lowerDeadZone: number;
54
- declare upperDeadZone: number;
55
- declare snapToTicks: number;
56
- declare tickDivisions: number[][];
57
- declare minLabelTickSize: number;
58
- declare minTickStep: number;
59
- declare format: string;
60
- declare labelDivisor: number;
61
- declare normalized: boolean;
62
-
63
- constructor(config: NumericAxisConfig) {
64
- super(config);
65
- }
66
-
67
- init(): void {
68
- if (this.deadZone) {
69
- this.lowerDeadZone = this.deadZone;
70
- this.upperDeadZone = this.deadZone;
71
- }
72
- super.init();
73
- }
74
-
75
- declareData(...args: any[]): void {
76
- super.declareData(
77
- {
78
- min: undefined,
79
- max: undefined,
80
- normalized: undefined,
81
- inverted: undefined,
82
- labelDivisor: undefined,
83
- format: undefined,
84
- lowerDeadZone: undefined,
85
- upperDeadZone: undefined,
86
- },
87
- ...args,
88
- );
89
- }
90
-
91
- initInstance(context: RenderingContext, instance: AxisInstance): void {
92
- instance.calculator = new NumericScale();
93
- }
94
-
95
- explore(context: RenderingContext, instance: AxisInstance): void {
96
- super.explore(context, instance);
97
- let { min, max, normalized, inverted, lowerDeadZone, upperDeadZone } = instance.data;
98
- instance.calculator.reset(
99
- min,
100
- max,
101
- this.snapToTicks,
102
- this.tickDivisions,
103
- this.minTickDistance,
104
- this.minTickStep,
105
- this.minLabelDistance,
106
- this.minLabelTickSize,
107
- normalized,
108
- inverted,
109
- lowerDeadZone,
110
- upperDeadZone,
111
- );
112
- }
113
-
114
- render(context: RenderingContext, instance: AxisInstance, key: string): React.ReactNode {
115
- let { data } = instance;
116
-
117
- if (!data.bounds.valid()) return null;
118
-
119
- let baseFormatter = Format.parse(data.format);
120
- let formatter = data.labelDivisor != 1 ? (v: number) => baseFormatter(v / data.labelDivisor) : baseFormatter;
121
-
122
- return (
123
- <g key={key} className={data.classNames} style={data.style}>
124
- {this.renderTicksAndLabels(context, instance, formatter, this.minLabelDistance)}
125
- </g>
126
- );
127
- }
128
-
129
- static XY() {
130
- return {
131
- x: { type: NumericAxis },
132
- y: { type: NumericAxis, vertical: true },
133
- };
134
- }
135
- }
136
-
137
- NumericAxis.prototype.baseClass = "numericaxis";
138
- NumericAxis.prototype.tickDivisions = [
139
- [1, 2, 10, 20, 100],
140
- [1, 5, 10, 20, 100],
141
- ];
142
-
143
- NumericAxis.prototype.snapToTicks = 1;
144
- NumericAxis.prototype.normalized = false;
145
- NumericAxis.prototype.format = "n";
146
- NumericAxis.prototype.labelDivisor = 1;
147
- NumericAxis.prototype.minLabelTickSize = 0;
148
- NumericAxis.prototype.minTickStep = 0;
149
-
150
- Axis.alias("numeric", NumericAxis);
151
-
152
- class NumericScale {
153
- min: number;
154
- max: number;
155
- snapToTicks: number;
156
- tickDivisions: number[][];
157
- minLabelDistance: number;
158
- minLabelTickSize: number;
159
- minTickDistance: number;
160
- minTickStep: number;
161
- tickSizes: number[];
162
- normalized: boolean;
163
- inverted: boolean;
164
- minValue?: number;
165
- maxValue?: number;
166
- minValuePadded: number;
167
- maxValuePadded: number;
168
- stacks: Record<string, Stack>;
169
- lowerDeadZone: number;
170
- upperDeadZone: number;
171
- origin: number;
172
- scale: { factor: number; min: number; max: number; minPadding: number; maxPadding: number };
173
- a: number;
174
- b: number;
175
- shouldUpdate: boolean;
176
-
177
- reset(
178
- min: number,
179
- max: number,
180
- snapToTicks: number,
181
- tickDivisions: number[][],
182
- minTickDistance: number,
183
- minTickStep: number,
184
- minLabelDistance: number,
185
- minLabelTickSize: number,
186
- normalized: boolean,
187
- inverted: boolean,
188
- lowerDeadZone: number,
189
- upperDeadZone: number,
190
- ): void {
191
- this.min = min;
192
- this.max = max;
193
- this.snapToTicks = snapToTicks;
194
- this.tickDivisions = tickDivisions;
195
- this.minLabelDistance = minLabelDistance;
196
- this.minLabelTickSize = minLabelTickSize;
197
- this.minTickDistance = minTickDistance;
198
- this.minTickStep = minTickStep;
199
- this.tickSizes = [];
200
- this.normalized = normalized;
201
- this.inverted = inverted;
202
- delete this.minValue;
203
- delete this.maxValue;
204
- this.stacks = {};
205
- this.lowerDeadZone = lowerDeadZone || 0;
206
- this.upperDeadZone = upperDeadZone || 0;
207
- }
208
-
209
- map(v: number, offset: number = 0): number {
210
- return this.origin + (v + offset - this.scale.min + this.scale.minPadding) * this.scale.factor;
211
- }
212
-
213
- decodeValue(n: number): number {
214
- return n;
215
- }
216
-
217
- encodeValue(v: number): number {
218
- return v;
219
- }
220
-
221
- constrainValue(v: number): number {
222
- return Math.max(this.scale.min, Math.min(this.scale.max, v));
223
- }
224
-
225
- trackValue(v: number, offset: number = 0, constrain: boolean = false): number {
226
- let value = (v - this.origin) / this.scale.factor - offset + this.scale.min - this.scale.minPadding;
227
- if (constrain) value = this.constrainValue(v);
228
- return value;
229
- }
230
-
231
- hash(): any {
232
- let r: any = {
233
- origin: this.origin,
234
- factor: this.scale.factor,
235
- min: this.scale.min,
236
- max: this.scale.max,
237
- minPadding: this.scale.minPadding,
238
- maxPadding: this.scale.maxPadding,
239
- };
240
- r.stacks = Object.keys(this.stacks)
241
- .map((s) => this.stacks[s].info?.join(","))
242
- .join(":");
243
- return r;
244
- }
245
-
246
- isSame(x: any): boolean {
247
- let hash = this.hash();
248
- let same = x && !Object.keys(hash).some((k) => x[k] !== hash[k]);
249
- this.shouldUpdate = !same;
250
- return same;
251
- }
252
-
253
- measure(a: number, b: number): void {
254
- this.a = a;
255
- this.b = b;
256
-
257
- if (this.minValue != null && this.min == null) this.min = this.minValue;
258
- if (this.maxValue != null && this.max == null) this.max = this.maxValue;
259
-
260
- for (let s in this.stacks) {
261
- let info = this.stacks[s].measure(this.normalized);
262
- let [min, max] = info;
263
- if (this.min == null || min < this.min) this.min = min;
264
- if (this.max == null || max > this.max) this.max = max;
265
- this.stacks[s].info = info;
266
- }
267
-
268
- if (this.min == null) this.min = 0;
269
- if (this.max == null) this.max = this.normalized ? 1 : 100;
270
-
271
- if (this.min == this.max) {
272
- if (this.min == 0) {
273
- this.min = -1;
274
- this.max = 1;
275
- } else {
276
- let delta = Math.abs(this.min) * 0.1;
277
- this.min -= delta;
278
- this.max += delta;
279
- }
280
- }
281
-
282
- this.origin = this.inverted ? this.b : this.a;
283
-
284
- this.scale = this.getScale();
285
-
286
- this.calculateTicks();
287
- }
288
-
289
- getScale(tickSizes?: number[]): { factor: number; min: number; max: number; minPadding: number; maxPadding: number } {
290
- let { min, max } = this;
291
- let smin = min;
292
- let smax = max;
293
-
294
- let tickSize;
295
- if (tickSizes && isNumber(this.snapToTicks) && tickSizes.length > 0) {
296
- tickSize = tickSizes[Math.min(tickSizes.length - 1, this.snapToTicks)];
297
- smin = Math.floor(smin / tickSize) * tickSize;
298
- smax = Math.ceil(smax / tickSize) * tickSize;
299
- } else {
300
- if (this.minValue === min) smin = this.minValuePadded;
301
- if (this.maxValue === max) smax = this.maxValuePadded;
302
- }
303
-
304
- let minPadding = this.minValue === min ? Math.max(0, smin - this.minValuePadded) : 0;
305
- let maxPadding = this.maxValue === max ? Math.max(0, this.maxValuePadded - smax) : 0;
306
-
307
- let sign = this.b > this.a ? 1 : -1;
308
-
309
- let factor =
310
- smin < smax
311
- ? (Math.abs(this.b - this.a) - this.lowerDeadZone - this.upperDeadZone) /
312
- (smax - smin + minPadding + maxPadding)
313
- : 0;
314
-
315
- if (factor < 0) factor = 0;
316
-
317
- if (factor > 0 && (this.lowerDeadZone > 0 || this.upperDeadZone > 0)) {
318
- while (factor * (min - smin) < this.lowerDeadZone) smin -= this.lowerDeadZone / factor;
319
-
320
- while (factor * (smax - max) < this.upperDeadZone) smax += this.upperDeadZone / factor;
321
-
322
- if (tickSize! > 0 && isNumber(this.snapToTicks)) {
323
- smin = Math.floor(smin / tickSize!) * tickSize!;
324
- smax = Math.ceil(smax / tickSize!) * tickSize!;
325
- minPadding = this.minValue === min ? Math.max(0, smin - this.minValuePadded) : 0;
326
- maxPadding = this.maxValue === max ? Math.max(0, this.maxValuePadded - smax) : 0;
327
- }
328
-
329
- factor = smin < smax ? Math.abs(this.b - this.a) / (smax - smin + minPadding + maxPadding) : 0;
330
- }
331
-
332
- return {
333
- factor: sign * (this.inverted ? -factor : factor),
334
- min: smin,
335
- max: smax,
336
- minPadding,
337
- maxPadding,
338
- };
339
- }
340
-
341
- acknowledge(value: number, width: number = 0, offset: number = 0): void {
342
- if (value == null) return;
343
-
344
- if (this.minValue == null || value < this.minValue) {
345
- this.minValue = value;
346
- this.minValuePadded = value + offset - width / 2;
347
- }
348
- if (this.maxValue == null || value > this.maxValue) {
349
- this.maxValue = value;
350
- this.maxValuePadded = value + offset + width / 2;
351
- }
352
- }
353
-
354
- getStack(name: string): Stack {
355
- let s = this.stacks[name];
356
- if (!s) s = this.stacks[name] = new Stack();
357
- return s;
358
- }
359
-
360
- stacknowledge(name: string, ordinal: any, value: any): any {
361
- return this.getStack(name).acknowledge(ordinal, value);
362
- }
363
-
364
- stack(name: string, ordinal: any, value: any): number | null {
365
- let v = this.getStack(name).stack(ordinal, value);
366
- return v != null ? this.map(v) : null;
367
- }
368
-
369
- findTickSize(minPxDist: number): number | undefined {
370
- return this.tickSizes.find((a) => a >= this.minLabelTickSize && a * Math.abs(this.scale.factor) >= minPxDist);
371
- }
372
-
373
- getTickSizes(): number[] {
374
- return this.tickSizes;
375
- }
376
-
377
- calculateTicks(): void {
378
- let dist = this.minLabelDistance / Math.abs(this.scale.factor);
379
- let unit = Math.pow(10, Math.floor(Math.log10(dist)));
380
-
381
- let bestLabelDistance = Infinity;
382
- let bestTicks: number[] = [];
383
- let bestScale = this.scale;
384
-
385
- for (let i = 0; i < this.tickDivisions.length; i++) {
386
- let divs = this.tickDivisions[i];
387
- let tickSizes = divs.filter((ts) => ts >= this.minTickStep).map((ts) => ts * unit);
388
- let scale = this.getScale(tickSizes);
389
- tickSizes.forEach((size, level) => {
390
- let labelDistance = size * Math.abs(scale.factor);
391
- if (labelDistance >= this.minLabelDistance && labelDistance < bestLabelDistance) {
392
- bestScale = scale;
393
- bestTicks = tickSizes;
394
- bestLabelDistance = labelDistance;
395
- }
396
- });
397
- }
398
- this.scale = bestScale;
399
- this.tickSizes = bestTicks.filter(
400
- (ts) => ts >= this.minTickStep && ts * Math.abs(bestScale.factor) >= this.minTickDistance,
401
- );
402
- if (this.tickSizes.length > 0) {
403
- let max = this.tickSizes[this.tickSizes.length - 1];
404
- this.tickSizes.push(2 * max);
405
- this.tickSizes.push(5 * max);
406
- this.tickSizes.push(10 * max);
407
- let min = this.tickSizes[0];
408
- let minDist = min * Math.abs(bestScale.factor);
409
- if (min / 10 >= this.minTickStep && minDist / 10 >= this.minTickDistance) this.tickSizes.splice(0, 0, min / 10);
410
- else if (min / 5 >= this.minTickStep && minDist / 5 >= this.minTickDistance) this.tickSizes.splice(0, 0, min / 5);
411
- else if (min / 2 >= this.minTickStep && minDist / 2 >= this.minTickDistance) this.tickSizes.splice(0, 0, min / 2);
412
- }
413
- }
414
-
415
- getTicks(tickSizes: number[]): number[][] {
416
- return tickSizes.map((size) => {
417
- let start = Math.ceil((this.scale.min - this.scale.minPadding) / size);
418
- let end = Math.floor((this.scale.max + this.scale.maxPadding) / size);
419
- let result: number[] = [];
420
- for (let i = start; i <= end; i++) result.push(i * size + 0);
421
- return result;
422
- });
423
- }
424
-
425
- mapGridlines(): number[] {
426
- let size = this.tickSizes[0];
427
- let start = Math.ceil((this.scale.min - this.scale.minPadding) / size);
428
- let end = Math.floor((this.scale.max + this.scale.maxPadding) / size);
429
- let result: number[] = [];
430
- for (let i = start; i <= end; i++) result.push(this.map(i * size));
431
- return result;
432
- }
433
-
434
- book(): void {
435
- Console.warn("NumericAxis does not support the autoSize flag for column and bar graphs.");
436
- }
437
- }
1
+ /** @jsxImportSource react */
2
+
3
+ import { Axis, AxisConfig, AxisInstance } from "./Axis";
4
+ import { VDOM } from "../../ui/Widget";
5
+ import { Stack } from "./Stack";
6
+ import { Format } from "../../util/Format";
7
+ import { isNumber } from "../../util/isNumber";
8
+ import { RenderingContext } from "../../ui/RenderingContext";
9
+ import { NumberProp, BooleanProp, StringProp } from "../../ui/Prop";
10
+ import { Console } from "../../util/Console";
11
+
12
+ export interface NumericAxisConfig extends AxisConfig {
13
+ /** Minimum value. */
14
+ min?: NumberProp;
15
+
16
+ /** Maximum value. */
17
+ max?: NumberProp;
18
+
19
+ /** Set to `true` to normalize the input range. */
20
+ normalized?: BooleanProp;
21
+
22
+ /** Number used to divide values before rendering axis labels. Default value is `1`. */
23
+ labelDivisor?: NumberProp;
24
+
25
+ /** Base CSS class to be applied to the element. Defaults to `numericaxis`. */
26
+ baseClass?: string;
27
+
28
+ tickDivisions?: Array<number[]>;
29
+
30
+ /** A number ranged between `0-2`. `0` means that the range is aligned with the lowest ticks. Default value is `1`, which means that the range is aligned with medium ticks. Use value `2` to align with major ticks. */
31
+ snapToTicks?: 0 | 1 | 2;
32
+
33
+ /** Value format. Default is `n`. */
34
+ format?: StringProp;
35
+
36
+ /** Size of a zone reserved for labels for both lower and upper end of the axis. */
37
+ deadZone?: NumberProp;
38
+
39
+ /** Size of a zone reserved for labels near the upper (higher) end of the axis. */
40
+ upperDeadZone?: NumberProp;
41
+
42
+ /** Size of a zone reserved for labels near the lower end of the axis. */
43
+ lowerDeadZone?: NumberProp;
44
+
45
+ /** Specifies minimum value increment between labels. Useful when formatting is not flexible enough, i.e. set to 1 for integer axes to avoid duplicate labels. */
46
+ minLabelTickSize?: number;
47
+
48
+ minTickStep?: number;
49
+ }
50
+
51
+ export class NumericAxis extends Axis {
52
+ declare deadZone: number;
53
+ declare lowerDeadZone: number;
54
+ declare upperDeadZone: number;
55
+ declare snapToTicks: number;
56
+ declare tickDivisions: number[][];
57
+ declare minLabelTickSize: number;
58
+ declare minTickStep: number;
59
+ declare format: string;
60
+ declare labelDivisor: number;
61
+ declare normalized: boolean;
62
+
63
+ constructor(config: NumericAxisConfig) {
64
+ super(config);
65
+ }
66
+
67
+ init(): void {
68
+ if (this.deadZone) {
69
+ this.lowerDeadZone = this.deadZone;
70
+ this.upperDeadZone = this.deadZone;
71
+ }
72
+ super.init();
73
+ }
74
+
75
+ declareData(...args: any[]): void {
76
+ super.declareData(
77
+ {
78
+ min: undefined,
79
+ max: undefined,
80
+ normalized: undefined,
81
+ inverted: undefined,
82
+ labelDivisor: undefined,
83
+ format: undefined,
84
+ lowerDeadZone: undefined,
85
+ upperDeadZone: undefined,
86
+ },
87
+ ...args,
88
+ );
89
+ }
90
+
91
+ initInstance(context: RenderingContext, instance: AxisInstance): void {
92
+ instance.calculator = new NumericScale();
93
+ }
94
+
95
+ explore(context: RenderingContext, instance: AxisInstance): void {
96
+ super.explore(context, instance);
97
+ let { min, max, normalized, inverted, lowerDeadZone, upperDeadZone } = instance.data;
98
+ instance.calculator.reset(
99
+ min,
100
+ max,
101
+ this.snapToTicks,
102
+ this.tickDivisions,
103
+ this.minTickDistance,
104
+ this.minTickStep,
105
+ this.minLabelDistance,
106
+ this.minLabelTickSize,
107
+ normalized,
108
+ inverted,
109
+ lowerDeadZone,
110
+ upperDeadZone,
111
+ );
112
+ }
113
+
114
+ render(context: RenderingContext, instance: AxisInstance, key: string): React.ReactNode {
115
+ let { data } = instance;
116
+
117
+ if (!data.bounds.valid()) return null;
118
+
119
+ let baseFormatter = Format.parse(data.format);
120
+ let formatter = data.labelDivisor != 1 ? (v: number) => baseFormatter(v / data.labelDivisor) : baseFormatter;
121
+
122
+ return (
123
+ <g key={key} className={data.classNames} style={data.style}>
124
+ {this.renderTicksAndLabels(context, instance, formatter, this.minLabelDistance)}
125
+ </g>
126
+ );
127
+ }
128
+
129
+ static XY() {
130
+ return {
131
+ x: { type: NumericAxis },
132
+ y: { type: NumericAxis, vertical: true },
133
+ };
134
+ }
135
+ }
136
+
137
+ NumericAxis.prototype.baseClass = "numericaxis";
138
+ NumericAxis.prototype.tickDivisions = [
139
+ [1, 2, 10, 20, 100],
140
+ [1, 5, 10, 20, 100],
141
+ ];
142
+
143
+ NumericAxis.prototype.snapToTicks = 1;
144
+ NumericAxis.prototype.normalized = false;
145
+ NumericAxis.prototype.format = "n";
146
+ NumericAxis.prototype.labelDivisor = 1;
147
+ NumericAxis.prototype.minLabelTickSize = 0;
148
+ NumericAxis.prototype.minTickStep = 0;
149
+
150
+ Axis.alias("numeric", NumericAxis);
151
+
152
+ class NumericScale {
153
+ min: number;
154
+ max: number;
155
+ snapToTicks: number;
156
+ tickDivisions: number[][];
157
+ minLabelDistance: number;
158
+ minLabelTickSize: number;
159
+ minTickDistance: number;
160
+ minTickStep: number;
161
+ tickSizes: number[];
162
+ normalized: boolean;
163
+ inverted: boolean;
164
+ minValue?: number;
165
+ maxValue?: number;
166
+ minValuePadded: number;
167
+ maxValuePadded: number;
168
+ stacks: Record<string, Stack>;
169
+ lowerDeadZone: number;
170
+ upperDeadZone: number;
171
+ origin: number;
172
+ scale: { factor: number; min: number; max: number; minPadding: number; maxPadding: number };
173
+ a: number;
174
+ b: number;
175
+ shouldUpdate: boolean;
176
+
177
+ reset(
178
+ min: number,
179
+ max: number,
180
+ snapToTicks: number,
181
+ tickDivisions: number[][],
182
+ minTickDistance: number,
183
+ minTickStep: number,
184
+ minLabelDistance: number,
185
+ minLabelTickSize: number,
186
+ normalized: boolean,
187
+ inverted: boolean,
188
+ lowerDeadZone: number,
189
+ upperDeadZone: number,
190
+ ): void {
191
+ this.min = min;
192
+ this.max = max;
193
+ this.snapToTicks = snapToTicks;
194
+ this.tickDivisions = tickDivisions;
195
+ this.minLabelDistance = minLabelDistance;
196
+ this.minLabelTickSize = minLabelTickSize;
197
+ this.minTickDistance = minTickDistance;
198
+ this.minTickStep = minTickStep;
199
+ this.tickSizes = [];
200
+ this.normalized = normalized;
201
+ this.inverted = inverted;
202
+ delete this.minValue;
203
+ delete this.maxValue;
204
+ this.stacks = {};
205
+ this.lowerDeadZone = lowerDeadZone || 0;
206
+ this.upperDeadZone = upperDeadZone || 0;
207
+ }
208
+
209
+ map(v: number, offset: number = 0): number {
210
+ return this.origin + (v + offset - this.scale.min + this.scale.minPadding) * this.scale.factor;
211
+ }
212
+
213
+ decodeValue(n: number): number {
214
+ return n;
215
+ }
216
+
217
+ encodeValue(v: number): number {
218
+ return v;
219
+ }
220
+
221
+ constrainValue(v: number): number {
222
+ return Math.max(this.scale.min, Math.min(this.scale.max, v));
223
+ }
224
+
225
+ trackValue(v: number, offset: number = 0, constrain: boolean = false): number {
226
+ let value = (v - this.origin) / this.scale.factor - offset + this.scale.min - this.scale.minPadding;
227
+ if (constrain) value = this.constrainValue(v);
228
+ return value;
229
+ }
230
+
231
+ hash(): any {
232
+ let r: any = {
233
+ origin: this.origin,
234
+ factor: this.scale.factor,
235
+ min: this.scale.min,
236
+ max: this.scale.max,
237
+ minPadding: this.scale.minPadding,
238
+ maxPadding: this.scale.maxPadding,
239
+ };
240
+ r.stacks = Object.keys(this.stacks)
241
+ .map((s) => this.stacks[s].info?.join(","))
242
+ .join(":");
243
+ return r;
244
+ }
245
+
246
+ isSame(x: any): boolean {
247
+ let hash = this.hash();
248
+ let same = x && !Object.keys(hash).some((k) => x[k] !== hash[k]);
249
+ this.shouldUpdate = !same;
250
+ return same;
251
+ }
252
+
253
+ measure(a: number, b: number): void {
254
+ this.a = a;
255
+ this.b = b;
256
+
257
+ if (this.minValue != null && this.min == null) this.min = this.minValue;
258
+ if (this.maxValue != null && this.max == null) this.max = this.maxValue;
259
+
260
+ for (let s in this.stacks) {
261
+ let info = this.stacks[s].measure(this.normalized);
262
+ let [min, max] = info;
263
+ if (this.min == null || min < this.min) this.min = min;
264
+ if (this.max == null || max > this.max) this.max = max;
265
+ this.stacks[s].info = info;
266
+ }
267
+
268
+ if (this.min == null) this.min = 0;
269
+ if (this.max == null) this.max = this.normalized ? 1 : 100;
270
+
271
+ if (this.min == this.max) {
272
+ if (this.min == 0) {
273
+ this.min = -1;
274
+ this.max = 1;
275
+ } else {
276
+ let delta = Math.abs(this.min) * 0.1;
277
+ this.min -= delta;
278
+ this.max += delta;
279
+ }
280
+ }
281
+
282
+ this.origin = this.inverted ? this.b : this.a;
283
+
284
+ this.scale = this.getScale();
285
+
286
+ this.calculateTicks();
287
+ }
288
+
289
+ getScale(tickSizes?: number[]): { factor: number; min: number; max: number; minPadding: number; maxPadding: number } {
290
+ let { min, max } = this;
291
+ let smin = min;
292
+ let smax = max;
293
+
294
+ let tickSize;
295
+ if (tickSizes && isNumber(this.snapToTicks) && tickSizes.length > 0) {
296
+ tickSize = tickSizes[Math.min(tickSizes.length - 1, this.snapToTicks)];
297
+ smin = Math.floor(smin / tickSize) * tickSize;
298
+ smax = Math.ceil(smax / tickSize) * tickSize;
299
+ } else {
300
+ if (this.minValue === min) smin = this.minValuePadded;
301
+ if (this.maxValue === max) smax = this.maxValuePadded;
302
+ }
303
+
304
+ let minPadding = this.minValue === min ? Math.max(0, smin - this.minValuePadded) : 0;
305
+ let maxPadding = this.maxValue === max ? Math.max(0, this.maxValuePadded - smax) : 0;
306
+
307
+ let sign = this.b > this.a ? 1 : -1;
308
+
309
+ let factor =
310
+ smin < smax
311
+ ? (Math.abs(this.b - this.a) - this.lowerDeadZone - this.upperDeadZone) /
312
+ (smax - smin + minPadding + maxPadding)
313
+ : 0;
314
+
315
+ if (factor < 0) factor = 0;
316
+
317
+ if (factor > 0 && (this.lowerDeadZone > 0 || this.upperDeadZone > 0)) {
318
+ while (factor * (min - smin) < this.lowerDeadZone) smin -= this.lowerDeadZone / factor;
319
+
320
+ while (factor * (smax - max) < this.upperDeadZone) smax += this.upperDeadZone / factor;
321
+
322
+ if (tickSize! > 0 && isNumber(this.snapToTicks)) {
323
+ smin = Math.floor(smin / tickSize!) * tickSize!;
324
+ smax = Math.ceil(smax / tickSize!) * tickSize!;
325
+ minPadding = this.minValue === min ? Math.max(0, smin - this.minValuePadded) : 0;
326
+ maxPadding = this.maxValue === max ? Math.max(0, this.maxValuePadded - smax) : 0;
327
+ }
328
+
329
+ factor = smin < smax ? Math.abs(this.b - this.a) / (smax - smin + minPadding + maxPadding) : 0;
330
+ }
331
+
332
+ return {
333
+ factor: sign * (this.inverted ? -factor : factor),
334
+ min: smin,
335
+ max: smax,
336
+ minPadding,
337
+ maxPadding,
338
+ };
339
+ }
340
+
341
+ acknowledge(value: number, width: number = 0, offset: number = 0): void {
342
+ if (value == null) return;
343
+
344
+ if (this.minValue == null || value < this.minValue) {
345
+ this.minValue = value;
346
+ this.minValuePadded = value + offset - width / 2;
347
+ }
348
+ if (this.maxValue == null || value > this.maxValue) {
349
+ this.maxValue = value;
350
+ this.maxValuePadded = value + offset + width / 2;
351
+ }
352
+ }
353
+
354
+ getStack(name: string): Stack {
355
+ let s = this.stacks[name];
356
+ if (!s) s = this.stacks[name] = new Stack();
357
+ return s;
358
+ }
359
+
360
+ stacknowledge(name: string, ordinal: any, value: any): any {
361
+ return this.getStack(name).acknowledge(ordinal, value);
362
+ }
363
+
364
+ stack(name: string, ordinal: any, value: any): number | null {
365
+ let v = this.getStack(name).stack(ordinal, value);
366
+ return v != null ? this.map(v) : null;
367
+ }
368
+
369
+ findTickSize(minPxDist: number): number | undefined {
370
+ return this.tickSizes.find((a) => a >= this.minLabelTickSize && a * Math.abs(this.scale.factor) >= minPxDist);
371
+ }
372
+
373
+ getTickSizes(): number[] {
374
+ return this.tickSizes;
375
+ }
376
+
377
+ calculateTicks(): void {
378
+ let dist = this.minLabelDistance / Math.abs(this.scale.factor);
379
+ let unit = Math.pow(10, Math.floor(Math.log10(dist)));
380
+
381
+ let bestLabelDistance = Infinity;
382
+ let bestTicks: number[] = [];
383
+ let bestScale = this.scale;
384
+
385
+ for (let i = 0; i < this.tickDivisions.length; i++) {
386
+ let divs = this.tickDivisions[i];
387
+ let tickSizes = divs.filter((ts) => ts >= this.minTickStep).map((ts) => ts * unit);
388
+ let scale = this.getScale(tickSizes);
389
+ tickSizes.forEach((size, level) => {
390
+ let labelDistance = size * Math.abs(scale.factor);
391
+ if (labelDistance >= this.minLabelDistance && labelDistance < bestLabelDistance) {
392
+ bestScale = scale;
393
+ bestTicks = tickSizes;
394
+ bestLabelDistance = labelDistance;
395
+ }
396
+ });
397
+ }
398
+ this.scale = bestScale;
399
+ this.tickSizes = bestTicks.filter(
400
+ (ts) => ts >= this.minTickStep && ts * Math.abs(bestScale.factor) >= this.minTickDistance,
401
+ );
402
+ if (this.tickSizes.length > 0) {
403
+ let max = this.tickSizes[this.tickSizes.length - 1];
404
+ this.tickSizes.push(2 * max);
405
+ this.tickSizes.push(5 * max);
406
+ this.tickSizes.push(10 * max);
407
+ let min = this.tickSizes[0];
408
+ let minDist = min * Math.abs(bestScale.factor);
409
+ if (min / 10 >= this.minTickStep && minDist / 10 >= this.minTickDistance) this.tickSizes.splice(0, 0, min / 10);
410
+ else if (min / 5 >= this.minTickStep && minDist / 5 >= this.minTickDistance) this.tickSizes.splice(0, 0, min / 5);
411
+ else if (min / 2 >= this.minTickStep && minDist / 2 >= this.minTickDistance) this.tickSizes.splice(0, 0, min / 2);
412
+ }
413
+ }
414
+
415
+ getTicks(tickSizes: number[]): number[][] {
416
+ return tickSizes.map((size) => {
417
+ let start = Math.ceil((this.scale.min - this.scale.minPadding) / size);
418
+ let end = Math.floor((this.scale.max + this.scale.maxPadding) / size);
419
+ let result: number[] = [];
420
+ for (let i = start; i <= end; i++) result.push(i * size + 0);
421
+ return result;
422
+ });
423
+ }
424
+
425
+ mapGridlines(): number[] {
426
+ let size = this.tickSizes[0];
427
+ let start = Math.ceil((this.scale.min - this.scale.minPadding) / size);
428
+ let end = Math.floor((this.scale.max + this.scale.maxPadding) / size);
429
+ let result: number[] = [];
430
+ for (let i = start; i <= end; i++) result.push(this.map(i * size));
431
+ return result;
432
+ }
433
+
434
+ book(): void {
435
+ Console.warn("NumericAxis does not support the autoSize flag for column and bar graphs.");
436
+ }
437
+ }