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,718 +1,718 @@
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 "../../ui/Format";
7
- import { isNumber } from "../../util/isNumber";
8
- import { zeroTime } from "../../util/date/zeroTime";
9
- import { Console } from "../../util/Console";
10
- import { parseDateInvariant } from "../../util";
11
- import { RenderingContext } from "../../ui/RenderingContext";
12
- import { NumberProp, StringProp } from "../../ui/Prop";
13
-
14
- export interface TimeAxisConfig extends AxisConfig {
15
- /** Minimum value. */
16
- min?: NumberProp;
17
-
18
- /** Maximum value. */
19
- max?: NumberProp;
20
-
21
- /** Base CSS class to be applied to the element. Defaults to `timeaxis`. */
22
- baseClass?: string;
23
-
24
- /** 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. */
25
- snapToTicks?: 0 | 1 | 2 | false;
26
-
27
- tickDivisions?: Record<string, number[][]>;
28
- minTickUnit?: string;
29
-
30
- /** Set to true to apply precise label distances from minLabelDistanceFormatOverride based on the resolved label format. */
31
- useLabelDistanceFormatOverrides?: boolean;
32
-
33
- /** Mapping of formats to label distances, i.e. { "datetime;YYYYMM": 80 } */
34
- minLabelDistanceFormatOverride?: Record<string, number>;
35
- minLabelDistanceFormatOverrideDefaults?: Record<string, number>;
36
-
37
- /** Axis labels format string override. */
38
- format?: StringProp;
39
-
40
- /** Custom date decoder function. */
41
- decode?: (date: string) => string;
42
-
43
- /** Size of a zone reserved for labels for both lower and upper end of the axis. */
44
- deadZone?: number;
45
-
46
- /** Size of a zone reserved for labels near the lower end of the axis. */
47
- lowerDeadZone?: number;
48
-
49
- /** Size of a zone reserved for labels near the upper (higher) end of the axis. */
50
- upperDeadZone?: number;
51
- }
52
-
53
- Format.registerFactory("yearOrMonth", (format: string) => {
54
- let year = Format.parse("datetime;yyyy");
55
- let month = Format.parse("datetime;MMM");
56
- return function (date: any): string {
57
- let d = parseDateInvariant(date);
58
- if (d.getMonth() == 0) return year(d);
59
- else return month(d);
60
- };
61
- });
62
-
63
- Format.registerFactory("monthOrDay", (format: string) => {
64
- let month = Format.parse("datetime;MMM");
65
- let day = Format.parse("datetime;dd");
66
- return function (date: any): string {
67
- let d = parseDateInvariant(date);
68
- if (d.getDate() == 1) return month(d);
69
- else return day(d);
70
- };
71
- });
72
-
73
- export class TimeAxis extends Axis {
74
- declare deadZone: number;
75
- declare lowerDeadZone: number;
76
- declare upperDeadZone: number;
77
- declare snapToTicks: number | false;
78
- declare tickDivisions: Record<string, number[][]>;
79
- declare minTickUnit: string;
80
- declare useLabelDistanceFormatOverrides: boolean;
81
- declare minLabelDistanceFormatOverride: Record<string, number>;
82
- declare minLabelDistanceFormatOverrideDefaults: Record<string, number>;
83
- declare format: string;
84
- declare decode: TimeAxisConfig["decode"];
85
-
86
- constructor(config: TimeAxisConfig) {
87
- super(config);
88
- }
89
-
90
- init(): void {
91
- if (this.labelAnchor == "auto") this.labelAnchor = this.vertical ? (this.secondary ? "start" : "end") : "start";
92
-
93
- if (this.labelDx == "auto") this.labelDx = this.vertical ? 0 : "5px";
94
-
95
- if (this.deadZone) {
96
- this.lowerDeadZone = this.deadZone;
97
- this.upperDeadZone = this.deadZone;
98
- }
99
-
100
- this.minLabelDistanceFormatOverride = {
101
- ...this.minLabelDistanceFormatOverrideDefaults,
102
- ...this.minLabelDistanceFormatOverride,
103
- };
104
-
105
- super.init();
106
- }
107
-
108
- declareData(...args: any[]): void {
109
- super.declareData(
110
- {
111
- anchors: undefined,
112
- min: undefined,
113
- max: undefined,
114
- inverted: undefined,
115
- lowerDeadZone: undefined,
116
- upperDeadZone: undefined,
117
- },
118
- ...args,
119
- );
120
- }
121
-
122
- initInstance(context: RenderingContext, instance: AxisInstance): void {
123
- instance.calculator = new TimeScale();
124
- }
125
-
126
- explore(context: RenderingContext, instance: AxisInstance): void {
127
- super.explore(context, instance);
128
- let { min, max, normalized, inverted, lowerDeadZone, upperDeadZone } = instance.data;
129
- instance.calculator.reset(
130
- min,
131
- max,
132
- this.snapToTicks,
133
- this.tickDivisions,
134
- Math.max(1, this.minTickDistance),
135
- Math.max(1, this.minLabelDistance),
136
- normalized,
137
- inverted,
138
- this.minTickUnit,
139
- lowerDeadZone,
140
- upperDeadZone,
141
- this.decode,
142
- this.useLabelDistanceFormatOverrides ? this.minLabelDistanceFormatOverride : {},
143
- this.format,
144
- );
145
- }
146
-
147
- render(context: RenderingContext, instance: AxisInstance, key: string): React.ReactNode {
148
- let { data, cached, calculator } = instance;
149
-
150
- cached.axis = calculator.hash();
151
-
152
- if (!data.bounds.valid()) return null;
153
-
154
- let format = calculator.resolvedFormat;
155
- let minLabelDistance = calculator.resolvedMinLabelDistance;
156
- let formatter = Format.parse(format);
157
-
158
- return (
159
- <g key={key} className={data.classNames} style={data.style}>
160
- {this.renderTicksAndLabels(context, instance, formatter, minLabelDistance)}
161
- </g>
162
- );
163
- }
164
- }
165
-
166
- Axis.alias("time", TimeAxis);
167
-
168
- TimeAxis.prototype.baseClass = "timeaxis";
169
- TimeAxis.prototype.tickDivisions = {
170
- second: [[1, 5, 15, 30]],
171
- minute: [[1, 5, 15, 30]],
172
- hour: [
173
- [1, 2, 4, 8],
174
- [1, 3, 6, 12],
175
- ],
176
- day: [[1]],
177
- week: [[1]],
178
- month: [[1, 3, 6]],
179
- year: [
180
- [1, 2, 10],
181
- [1, 5, 10],
182
- [5, 10, 50],
183
- [10, 50, 100],
184
- ],
185
- };
186
-
187
- const TimeFormats = {
188
- fullDateAndTime: "datetime;yyyy MMM dd HH mm ss n",
189
- shortMonthDate: "datetime;yyyy MMM dd",
190
- };
191
-
192
- TimeAxis.prototype.snapToTicks = 0;
193
- TimeAxis.prototype.tickSize = 15;
194
- TimeAxis.prototype.minLabelDistance = 60;
195
- TimeAxis.prototype.minTickDistance = 60;
196
- TimeAxis.prototype.minTickUnit = "second";
197
- TimeAxis.prototype.useLabelDistanceFormatOverrides = false;
198
- TimeAxis.prototype.minLabelDistanceFormatOverrideDefaults = {
199
- [TimeFormats.fullDateAndTime]: 150,
200
- [TimeFormats.shortMonthDate]: 90,
201
- };
202
-
203
- function monthNumber(date: Date): number {
204
- return date.getFullYear() * 12 + date.getMonth() + (date.getDate() - 1) / 31;
205
- }
206
-
207
- function yearNumber(date: Date): number {
208
- return monthNumber(date) / 12;
209
- }
210
-
211
- const milliSeconds: Record<string, number> = {
212
- second: 1000,
213
- minute: 60 * 1000,
214
- hour: 3600 * 1000,
215
- day: 3600 * 24 * 1000,
216
- week: 3600 * 24 * 7 * 1000,
217
- month: 3600 * 24 * 30 * 1000,
218
- year: 3600 * 24 * 365 * 1000,
219
- };
220
-
221
- interface TickSize {
222
- size: number;
223
- measure: string;
224
- noLabels?: boolean;
225
- }
226
-
227
- interface TimeScaleRange {
228
- factor: number;
229
- min: number;
230
- max: number;
231
- minPadding: number;
232
- maxPadding: number;
233
- }
234
-
235
- class TimeScale {
236
- dateCache: Record<string, number>;
237
- min: number | null;
238
- max: number | null;
239
- snapToTicks: number | false;
240
- tickDivisions: Record<string, number[][]>;
241
- minLabelDistance: number;
242
- minTickDistance: number;
243
- tickSizes: TickSize[];
244
- normalized: boolean;
245
- minTickUnit: string;
246
- inverted: boolean;
247
- lowerDeadZone: number;
248
- upperDeadZone: number;
249
- minValue?: number;
250
- maxValue?: number;
251
- minValuePadded?: number;
252
- maxValuePadded?: number;
253
- stacks: Record<string, Stack>;
254
- decode?: (date: string) => string;
255
- minLabelDistanceFormatOverride: Record<string, number>;
256
- format: string;
257
- origin: number;
258
- scale: TimeScaleRange;
259
- a: number;
260
- b: number;
261
- tickMeasure: string;
262
- resolvedFormat: string | null;
263
- resolvedMinLabelDistance: number;
264
- shouldUpdate: boolean;
265
-
266
- reset(
267
- min: any,
268
- max: any,
269
- snapToTicks: number | false,
270
- tickDivisions: Record<string, number[][]>,
271
- minTickDistance: number,
272
- minLabelDistance: number,
273
- normalized: boolean,
274
- inverted: boolean,
275
- minTickUnit: string,
276
- lowerDeadZone: number,
277
- upperDeadZone: number,
278
- decode: ((date: string) => string) | undefined,
279
- minLabelDistanceFormatOverride: Record<string, number>,
280
- format: string,
281
- ): void {
282
- this.dateCache = {};
283
- this.min = min != null ? this.decodeValue(min) : null;
284
- this.max = max != null ? this.decodeValue(max) : null;
285
- this.snapToTicks = snapToTicks;
286
- this.tickDivisions = tickDivisions;
287
- this.minLabelDistance = minLabelDistance;
288
- this.minTickDistance = minTickDistance;
289
- this.tickSizes = [];
290
- this.normalized = normalized;
291
- this.minTickUnit = minTickUnit;
292
- this.inverted = inverted;
293
- this.lowerDeadZone = lowerDeadZone || 0;
294
- this.upperDeadZone = upperDeadZone || 0;
295
- this.minValue = undefined;
296
- this.maxValue = undefined;
297
- this.minValuePadded = undefined;
298
- this.maxValuePadded = undefined;
299
- this.stacks = {};
300
- this.decode = decode;
301
- this.minLabelDistanceFormatOverride = minLabelDistanceFormatOverride;
302
- this.format = format;
303
- }
304
-
305
- decodeValue(date: any): number {
306
- if (date instanceof Date) return date.getTime();
307
-
308
- switch (typeof date) {
309
- case "string":
310
- let v = this.dateCache[date];
311
- if (!v) {
312
- if (this.decode) date = this.decode(date);
313
- v = this.dateCache[date] = parseDateInvariant(date).getTime();
314
- }
315
- return v;
316
-
317
- case "number":
318
- return parseDateInvariant(date).getTime();
319
- }
320
- return 0;
321
- }
322
-
323
- encodeValue(v: number): string {
324
- return new Date(v).toISOString();
325
- }
326
-
327
- getFormat(unit: string, scale: TimeScaleRange): string {
328
- switch (unit) {
329
- case "year":
330
- return "datetime;yyyy";
331
-
332
- case "month":
333
- if (new Date(scale.min).getFullYear() != new Date(scale.max).getFullYear()) return "yearOrMonth";
334
- return "datetime;yyyy MMM";
335
-
336
- case "week":
337
- return "datetime;MMMdd";
338
-
339
- case "day":
340
- if (
341
- new Date(scale.min).getFullYear() != new Date(scale.max).getFullYear() ||
342
- new Date(scale.min).getMonth() != new Date(scale.max).getMonth()
343
- )
344
- return "monthOrDay";
345
-
346
- return TimeFormats.shortMonthDate;
347
-
348
- case "hour":
349
- return "datetime;HH mm n";
350
-
351
- case "minute":
352
- return "datetime;HH mm n";
353
-
354
- case "second":
355
- return "datetime;mm ss";
356
-
357
- default:
358
- return TimeFormats.fullDateAndTime;
359
- }
360
- }
361
-
362
- map(v: any, offset: number = 0): number {
363
- return this.origin + (this.decodeValue(v) + offset - this.scale.min + this.scale.minPadding) * this.scale.factor;
364
- }
365
-
366
- constrainValue(v: number): number {
367
- return Math.max(this.scale.min, Math.min(this.scale.max, v));
368
- }
369
-
370
- trackValue(v: number, offset: number = 0, constrain: boolean = false): number {
371
- let value = (v - this.origin) / this.scale.factor - offset + this.scale.min - this.scale.minPadding;
372
- if (constrain) value = this.constrainValue(value);
373
- return value;
374
- }
375
-
376
- hash(): Record<string, any> {
377
- let r: any = {
378
- origin: this.origin,
379
- factor: this.scale.factor,
380
- min: this.scale.min,
381
- max: this.scale.max,
382
- minPadding: this.scale.minPadding,
383
- maxPadding: this.scale.maxPadding,
384
- };
385
- r.stacks = Object.keys(this.stacks)
386
- .map((s) => this.stacks[s].info?.join(","))
387
- .join(":");
388
- return r;
389
- }
390
-
391
- isSame(x: any): boolean {
392
- let hash = this.hash();
393
- let same = x && !Object.keys(hash).some((k) => x[k] !== hash[k]);
394
- this.shouldUpdate = !same;
395
- return same;
396
- }
397
-
398
- measure(a: number, b: number): void {
399
- this.a = a;
400
- this.b = b;
401
-
402
- for (let s in this.stacks) {
403
- let info = this.stacks[s].measure(this.normalized);
404
- let [min, max] = info;
405
- if (this.minValue == null || min < this.minValue) this.minValue = min;
406
- if (this.max == null || max > this.maxValue!) this.maxValue = max;
407
- this.stacks[s].info = info;
408
- }
409
-
410
- if (this.min == null) {
411
- if (this.minValue != null) this.min = this.minValue;
412
- else this.min = 0;
413
- }
414
-
415
- if (this.max == null) {
416
- if (this.maxValue != null) this.max = this.maxValue;
417
- else this.max = this.normalized ? 1 : 100;
418
- }
419
-
420
- this.origin = this.inverted ? this.b : this.a;
421
-
422
- this.calculateTicks();
423
- if (this.scale == null) {
424
- this.scale = this.getScale();
425
- }
426
- }
427
-
428
- getTimezoneOffset(date: Date): number {
429
- return date.getTimezoneOffset() * 60 * 1000;
430
- }
431
-
432
- getScale(tickSize?: number | null, measure?: string, minRange: number = 1000): TimeScaleRange {
433
- let { min, max, upperDeadZone, lowerDeadZone } = this;
434
-
435
- let smin: number = min!;
436
- let smax: number = max!;
437
-
438
- if (tickSize) {
439
- let minDate = new Date(min!);
440
- let maxDate = new Date(max!);
441
-
442
- switch (measure) {
443
- case "second":
444
- case "minute":
445
- case "hour":
446
- case "day":
447
- default:
448
- let minOffset = this.getTimezoneOffset(minDate);
449
- let maxOffset = this.getTimezoneOffset(maxDate);
450
- let mondayOffset = 4 * milliSeconds.day; //new Date(0).getDay() => 4
451
- smin = Math.floor((smin - minOffset - mondayOffset) / tickSize) * tickSize + minOffset + mondayOffset;
452
- smax = Math.ceil((smax - maxOffset - mondayOffset) / tickSize) * tickSize + maxOffset + mondayOffset;
453
- break;
454
-
455
- case "month":
456
- tickSize /= milliSeconds.month;
457
- let minMonth = monthNumber(minDate);
458
- let maxMonth = monthNumber(maxDate);
459
- minMonth = Math.floor(minMonth / tickSize) * tickSize;
460
- maxMonth = Math.ceil(maxMonth / tickSize) * tickSize;
461
- smin = new Date(Math.floor(minMonth / 12), minMonth % 12, 1).getTime();
462
- smax = new Date(Math.floor(maxMonth / 12), maxMonth % 12, 1).getTime();
463
- break;
464
-
465
- case "year":
466
- tickSize /= milliSeconds.year;
467
- let minYear = yearNumber(minDate);
468
- let maxYear = yearNumber(maxDate);
469
- minYear = Math.floor(minYear / tickSize) * tickSize;
470
- maxYear = Math.ceil(maxYear / tickSize) * tickSize;
471
- smin = new Date(minYear, 0, 1).getTime();
472
- smax = new Date(maxYear, 0, 1).getTime();
473
- break;
474
- }
475
- } else {
476
- if (this.minValue == min) smin = this.minValuePadded!;
477
- if (this.maxValue == max) smax = this.maxValuePadded!;
478
- }
479
-
480
- if (smax - smin < minRange) {
481
- let delta = (minRange - (smax - smin)) / 2;
482
- smin -= delta;
483
- smax += delta;
484
- }
485
-
486
- //padding should be activated only if using min/max obtained from the data
487
- let minPadding = this.minValue === min ? Math.max(0, smin - this.minValuePadded!) : 0;
488
- let maxPadding = this.maxValue === max ? Math.max(0, this.maxValuePadded! - smax) : 0;
489
-
490
- let factor = smin < smax ? Math.abs(this.b - this.a) / (smax - smin + minPadding + maxPadding) : 0;
491
- if (factor > 0 && (upperDeadZone > 0 || lowerDeadZone > 0)) {
492
- smin -= lowerDeadZone / factor;
493
- smax += upperDeadZone / factor;
494
- minPadding = this.minValuePadded != null ? Math.max(0, smin - this.minValuePadded) : 0;
495
- maxPadding = this.maxValuePadded != null ? Math.max(0, this.maxValuePadded - smax) : 0;
496
- factor = smin < smax ? Math.abs(this.b - this.a) / (smax - smin + minPadding + maxPadding) : 0;
497
- }
498
-
499
- let sign = this.b > this.a ? 1 : -1;
500
-
501
- return {
502
- factor: sign * (this.inverted ? -factor : factor),
503
- min: smin,
504
- max: smax,
505
- minPadding,
506
- maxPadding,
507
- };
508
- }
509
-
510
- acknowledge(value: any, width: number = 0, offset: number = 0): void {
511
- value = this.decodeValue(value);
512
- if (this.minValue == null || value + offset - width / 2 < this.minValuePadded!) {
513
- this.minValue = value;
514
- this.minValuePadded = value + offset - width / 2;
515
- }
516
- if (this.maxValue == null || value + offset + width / 2 > this.maxValuePadded!) {
517
- this.maxValue = value;
518
- this.maxValuePadded = value + offset + width / 2;
519
- }
520
- }
521
-
522
- getStack(name: string): Stack {
523
- let s = this.stacks[name];
524
- if (!s) s = this.stacks[name] = new Stack();
525
- return s;
526
- }
527
-
528
- stacknowledge(name: string, ordinal: string, value: number | null): void {
529
- return this.getStack(name).acknowledge(ordinal, value);
530
- }
531
-
532
- stack(name: string, ordinal: string, value: number | null): number | null {
533
- let v = this.getStack(name).stack(ordinal, value);
534
- return v != null ? this.map(v) : null;
535
- }
536
-
537
- findTickSize(minPxDist: number): TickSize | undefined {
538
- return this.tickSizes.find(({ size, noLabels }) => !noLabels && size * Math.abs(this.scale.factor) >= minPxDist);
539
- }
540
-
541
- getTickSizes(): TickSize[] {
542
- return this.tickSizes;
543
- }
544
-
545
- calculateTicks(): void {
546
- let minReached = false;
547
-
548
- let minRange = 1000;
549
-
550
- for (let unit in milliSeconds) {
551
- if (!minReached) {
552
- if (unit == this.minTickUnit) minReached = true;
553
- else continue;
554
- }
555
-
556
- let unitSize = milliSeconds[unit];
557
- let divisions = this.tickDivisions[unit];
558
-
559
- if (this.tickSizes.length > 0) {
560
- //add ticks from higher levels
561
- this.tickSizes.push(...divisions[0].map((s) => ({ size: s * unitSize, measure: unit })));
562
- break;
563
- }
564
-
565
- let bestLabelDistance = Infinity;
566
- let bestMinLabelDistance = this.minLabelDistance;
567
- let bestTicks: number[] = [];
568
- let bestScale: TimeScaleRange | null = null;
569
- let bestFormat: string | null = null;
570
-
571
- this.tickMeasure = unit;
572
-
573
- for (let i = 0; i < divisions.length; i++) {
574
- let divs = divisions[i];
575
- for (let d = 0; d < divs.length; d++) {
576
- //if (useSnapToTicks && d < Math.min(divs.length - 1, this.snapToTicks)) continue;
577
- let tickSize = divs[d] * unitSize;
578
- let scale = this.getScale(null, unit, tickSize);
579
- let format = this.format ?? this.getFormat(unit, scale);
580
- let minLabelDistance = this.minLabelDistanceFormatOverride[format] ?? this.minLabelDistance;
581
- let labelDistance = tickSize * Math.abs(scale.factor);
582
- if (labelDistance >= minLabelDistance && labelDistance < bestLabelDistance) {
583
- bestScale = scale;
584
- bestTicks = divs.map((s) => s * unitSize);
585
- bestLabelDistance = labelDistance;
586
- bestFormat = format;
587
- bestMinLabelDistance = minLabelDistance;
588
- minRange = tickSize;
589
- }
590
- }
591
- }
592
-
593
- this.scale = bestScale!;
594
- this.tickSizes = bestTicks
595
- .filter((ts) => ts * Math.abs(bestScale!.factor) >= this.minTickDistance)
596
- .map((size) => ({ size, measure: this.tickMeasure }));
597
- this.resolvedFormat = bestFormat;
598
- this.resolvedMinLabelDistance = bestMinLabelDistance;
599
- }
600
-
601
- let lowerTickUnit: string | null = null;
602
- switch (this.tickMeasure) {
603
- case "year":
604
- lowerTickUnit = "month";
605
- break;
606
- case "month":
607
- lowerTickUnit = "day";
608
- break;
609
- case "week":
610
- lowerTickUnit = "day";
611
- break;
612
- case "day":
613
- lowerTickUnit = "hour";
614
- break;
615
- case "hour":
616
- lowerTickUnit = "minute";
617
- break;
618
- case "minute":
619
- lowerTickUnit = "second";
620
- break;
621
- }
622
-
623
- if (lowerTickUnit && this.minTickUnit && milliSeconds[lowerTickUnit] < milliSeconds[this.minTickUnit])
624
- lowerTickUnit = this.minTickUnit == this.tickMeasure ? null : this.minTickUnit;
625
-
626
- if (lowerTickUnit != null && this.scale) {
627
- let bestMinorTickSize = Infinity;
628
- let divisions = this.tickDivisions[lowerTickUnit];
629
- let unitSize = milliSeconds[lowerTickUnit];
630
- for (let i = 0; i < divisions.length; i++) {
631
- let divs = divisions[i];
632
- for (let d = 0; d < divs.length; d++) {
633
- let tickSize = divs[d] * unitSize;
634
- if (tickSize * Math.abs(this.scale.factor) >= this.minTickDistance && tickSize < bestMinorTickSize) {
635
- bestMinorTickSize = tickSize;
636
- }
637
- }
638
- }
639
- if (bestMinorTickSize != Infinity) {
640
- this.tickSizes.unshift({ size: bestMinorTickSize, measure: lowerTickUnit, noLabels: true });
641
- if (this.tickSizes.length > 1) {
642
- let labelStep = this.tickSizes[1].size;
643
- let lowerScale = this.getScale(null, lowerTickUnit, minRange);
644
- if (lowerScale.max - lowerScale.min >= labelStep) this.scale = lowerScale;
645
- }
646
- }
647
- }
648
-
649
- if (isNumber(this.snapToTicks) && this.snapToTicks >= 0 && this.tickSizes.length > 0) {
650
- let tickSize = this.tickSizes[Math.min(this.tickSizes.length - 1, this.snapToTicks)];
651
- this.scale = this.getScale(tickSize.size, tickSize.measure, minRange);
652
- }
653
- }
654
-
655
- getTicks(tickSizes: TickSize[]): (number | Date)[][] {
656
- return tickSizes.map(({ size, measure }) => {
657
- let result: (number | Date)[] = [],
658
- start: number,
659
- end: number,
660
- minDate: Date,
661
- maxDate: Date;
662
- if (measure == "year") {
663
- size /= milliSeconds.year;
664
- minDate = new Date(this.scale.min - this.scale.minPadding);
665
- maxDate = new Date(this.scale.max + this.scale.maxPadding);
666
- start = Math.ceil(yearNumber(minDate) / size) * size;
667
- end = Math.floor(yearNumber(maxDate) / size) * size;
668
- for (let i = start; i <= end; i += size) result.push(new Date(i, 0, 1).getTime());
669
- } else if (measure == "month") {
670
- size /= milliSeconds.month;
671
- minDate = new Date(this.scale.min - this.scale.minPadding);
672
- maxDate = new Date(this.scale.max + this.scale.maxPadding);
673
- start = Math.ceil(monthNumber(minDate) / size) * size;
674
- end = Math.floor(monthNumber(maxDate) / size) * size;
675
- for (let i = start; i <= end; i += size) result.push(new Date(Math.floor(i / 12), i % 12, 1).getTime());
676
- } else if (measure == "day" || measure == "week") {
677
- let multiplier = measure == "week" ? 7 : 1;
678
- size /= milliSeconds.day;
679
- minDate = new Date(this.scale.min - this.scale.minPadding);
680
- maxDate = new Date(this.scale.max + this.scale.maxPadding);
681
- let date = zeroTime(minDate);
682
- while (date.getTime() < minDate.getTime()) date.setDate(date.getDate() + 1);
683
- if (measure == "week") {
684
- //start on monday
685
- while (date.getDay() != 1) {
686
- date.setDate(date.getDate() + 1);
687
- }
688
- }
689
- while (date.getTime() <= maxDate.getTime()) {
690
- result.push(date);
691
- date = new Date(date);
692
- date.setDate(date.getDate() + multiplier);
693
- }
694
- } else {
695
- let minOffset = this.getTimezoneOffset(new Date(this.scale.min - this.scale.minPadding));
696
- let mondayOffset = 4 * milliSeconds.day;
697
- let date =
698
- Math.ceil((this.scale.min - this.scale.minPadding - minOffset - mondayOffset) / size) * size +
699
- minOffset +
700
- mondayOffset;
701
- while (date <= this.scale.max + this.scale.maxPadding) {
702
- result.push(date);
703
- date += size;
704
- }
705
- }
706
- return result;
707
- });
708
- }
709
-
710
- mapGridlines(): number[] {
711
- if (this.tickSizes.length == 0) return [];
712
- return this.getTicks([this.tickSizes[0]])[0].map((x) => this.map(x));
713
- }
714
-
715
- book(): void {
716
- Console.warn("TimeAxis does not support the autoSize flag for column and bar graphs.");
717
- }
718
- }
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 "../../ui/Format";
7
+ import { isNumber } from "../../util/isNumber";
8
+ import { zeroTime } from "../../util/date/zeroTime";
9
+ import { Console } from "../../util/Console";
10
+ import { parseDateInvariant } from "../../util";
11
+ import { RenderingContext } from "../../ui/RenderingContext";
12
+ import { NumberProp, StringProp } from "../../ui/Prop";
13
+
14
+ export interface TimeAxisConfig extends AxisConfig {
15
+ /** Minimum value. */
16
+ min?: NumberProp;
17
+
18
+ /** Maximum value. */
19
+ max?: NumberProp;
20
+
21
+ /** Base CSS class to be applied to the element. Defaults to `timeaxis`. */
22
+ baseClass?: string;
23
+
24
+ /** 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. */
25
+ snapToTicks?: 0 | 1 | 2 | false;
26
+
27
+ tickDivisions?: Record<string, number[][]>;
28
+ minTickUnit?: string;
29
+
30
+ /** Set to true to apply precise label distances from minLabelDistanceFormatOverride based on the resolved label format. */
31
+ useLabelDistanceFormatOverrides?: boolean;
32
+
33
+ /** Mapping of formats to label distances, i.e. { "datetime;YYYYMM": 80 } */
34
+ minLabelDistanceFormatOverride?: Record<string, number>;
35
+ minLabelDistanceFormatOverrideDefaults?: Record<string, number>;
36
+
37
+ /** Axis labels format string override. */
38
+ format?: StringProp;
39
+
40
+ /** Custom date decoder function. */
41
+ decode?: (date: string) => string;
42
+
43
+ /** Size of a zone reserved for labels for both lower and upper end of the axis. */
44
+ deadZone?: number;
45
+
46
+ /** Size of a zone reserved for labels near the lower end of the axis. */
47
+ lowerDeadZone?: number;
48
+
49
+ /** Size of a zone reserved for labels near the upper (higher) end of the axis. */
50
+ upperDeadZone?: number;
51
+ }
52
+
53
+ Format.registerFactory("yearOrMonth", (format: string) => {
54
+ let year = Format.parse("datetime;yyyy");
55
+ let month = Format.parse("datetime;MMM");
56
+ return function (date: any): string {
57
+ let d = parseDateInvariant(date);
58
+ if (d.getMonth() == 0) return year(d);
59
+ else return month(d);
60
+ };
61
+ });
62
+
63
+ Format.registerFactory("monthOrDay", (format: string) => {
64
+ let month = Format.parse("datetime;MMM");
65
+ let day = Format.parse("datetime;dd");
66
+ return function (date: any): string {
67
+ let d = parseDateInvariant(date);
68
+ if (d.getDate() == 1) return month(d);
69
+ else return day(d);
70
+ };
71
+ });
72
+
73
+ export class TimeAxis extends Axis {
74
+ declare deadZone: number;
75
+ declare lowerDeadZone: number;
76
+ declare upperDeadZone: number;
77
+ declare snapToTicks: number | false;
78
+ declare tickDivisions: Record<string, number[][]>;
79
+ declare minTickUnit: string;
80
+ declare useLabelDistanceFormatOverrides: boolean;
81
+ declare minLabelDistanceFormatOverride: Record<string, number>;
82
+ declare minLabelDistanceFormatOverrideDefaults: Record<string, number>;
83
+ declare format: string;
84
+ declare decode: TimeAxisConfig["decode"];
85
+
86
+ constructor(config: TimeAxisConfig) {
87
+ super(config);
88
+ }
89
+
90
+ init(): void {
91
+ if (this.labelAnchor == "auto") this.labelAnchor = this.vertical ? (this.secondary ? "start" : "end") : "start";
92
+
93
+ if (this.labelDx == "auto") this.labelDx = this.vertical ? 0 : "5px";
94
+
95
+ if (this.deadZone) {
96
+ this.lowerDeadZone = this.deadZone;
97
+ this.upperDeadZone = this.deadZone;
98
+ }
99
+
100
+ this.minLabelDistanceFormatOverride = {
101
+ ...this.minLabelDistanceFormatOverrideDefaults,
102
+ ...this.minLabelDistanceFormatOverride,
103
+ };
104
+
105
+ super.init();
106
+ }
107
+
108
+ declareData(...args: any[]): void {
109
+ super.declareData(
110
+ {
111
+ anchors: undefined,
112
+ min: undefined,
113
+ max: undefined,
114
+ inverted: undefined,
115
+ lowerDeadZone: undefined,
116
+ upperDeadZone: undefined,
117
+ },
118
+ ...args,
119
+ );
120
+ }
121
+
122
+ initInstance(context: RenderingContext, instance: AxisInstance): void {
123
+ instance.calculator = new TimeScale();
124
+ }
125
+
126
+ explore(context: RenderingContext, instance: AxisInstance): void {
127
+ super.explore(context, instance);
128
+ let { min, max, normalized, inverted, lowerDeadZone, upperDeadZone } = instance.data;
129
+ instance.calculator.reset(
130
+ min,
131
+ max,
132
+ this.snapToTicks,
133
+ this.tickDivisions,
134
+ Math.max(1, this.minTickDistance),
135
+ Math.max(1, this.minLabelDistance),
136
+ normalized,
137
+ inverted,
138
+ this.minTickUnit,
139
+ lowerDeadZone,
140
+ upperDeadZone,
141
+ this.decode,
142
+ this.useLabelDistanceFormatOverrides ? this.minLabelDistanceFormatOverride : {},
143
+ this.format,
144
+ );
145
+ }
146
+
147
+ render(context: RenderingContext, instance: AxisInstance, key: string): React.ReactNode {
148
+ let { data, cached, calculator } = instance;
149
+
150
+ cached.axis = calculator.hash();
151
+
152
+ if (!data.bounds.valid()) return null;
153
+
154
+ let format = calculator.resolvedFormat;
155
+ let minLabelDistance = calculator.resolvedMinLabelDistance;
156
+ let formatter = Format.parse(format);
157
+
158
+ return (
159
+ <g key={key} className={data.classNames} style={data.style}>
160
+ {this.renderTicksAndLabels(context, instance, formatter, minLabelDistance)}
161
+ </g>
162
+ );
163
+ }
164
+ }
165
+
166
+ Axis.alias("time", TimeAxis);
167
+
168
+ TimeAxis.prototype.baseClass = "timeaxis";
169
+ TimeAxis.prototype.tickDivisions = {
170
+ second: [[1, 5, 15, 30]],
171
+ minute: [[1, 5, 15, 30]],
172
+ hour: [
173
+ [1, 2, 4, 8],
174
+ [1, 3, 6, 12],
175
+ ],
176
+ day: [[1]],
177
+ week: [[1]],
178
+ month: [[1, 3, 6]],
179
+ year: [
180
+ [1, 2, 10],
181
+ [1, 5, 10],
182
+ [5, 10, 50],
183
+ [10, 50, 100],
184
+ ],
185
+ };
186
+
187
+ const TimeFormats = {
188
+ fullDateAndTime: "datetime;yyyy MMM dd HH mm ss n",
189
+ shortMonthDate: "datetime;yyyy MMM dd",
190
+ };
191
+
192
+ TimeAxis.prototype.snapToTicks = 0;
193
+ TimeAxis.prototype.tickSize = 15;
194
+ TimeAxis.prototype.minLabelDistance = 60;
195
+ TimeAxis.prototype.minTickDistance = 60;
196
+ TimeAxis.prototype.minTickUnit = "second";
197
+ TimeAxis.prototype.useLabelDistanceFormatOverrides = false;
198
+ TimeAxis.prototype.minLabelDistanceFormatOverrideDefaults = {
199
+ [TimeFormats.fullDateAndTime]: 150,
200
+ [TimeFormats.shortMonthDate]: 90,
201
+ };
202
+
203
+ function monthNumber(date: Date): number {
204
+ return date.getFullYear() * 12 + date.getMonth() + (date.getDate() - 1) / 31;
205
+ }
206
+
207
+ function yearNumber(date: Date): number {
208
+ return monthNumber(date) / 12;
209
+ }
210
+
211
+ const milliSeconds: Record<string, number> = {
212
+ second: 1000,
213
+ minute: 60 * 1000,
214
+ hour: 3600 * 1000,
215
+ day: 3600 * 24 * 1000,
216
+ week: 3600 * 24 * 7 * 1000,
217
+ month: 3600 * 24 * 30 * 1000,
218
+ year: 3600 * 24 * 365 * 1000,
219
+ };
220
+
221
+ interface TickSize {
222
+ size: number;
223
+ measure: string;
224
+ noLabels?: boolean;
225
+ }
226
+
227
+ interface TimeScaleRange {
228
+ factor: number;
229
+ min: number;
230
+ max: number;
231
+ minPadding: number;
232
+ maxPadding: number;
233
+ }
234
+
235
+ class TimeScale {
236
+ dateCache: Record<string, number>;
237
+ min: number | null;
238
+ max: number | null;
239
+ snapToTicks: number | false;
240
+ tickDivisions: Record<string, number[][]>;
241
+ minLabelDistance: number;
242
+ minTickDistance: number;
243
+ tickSizes: TickSize[];
244
+ normalized: boolean;
245
+ minTickUnit: string;
246
+ inverted: boolean;
247
+ lowerDeadZone: number;
248
+ upperDeadZone: number;
249
+ minValue?: number;
250
+ maxValue?: number;
251
+ minValuePadded?: number;
252
+ maxValuePadded?: number;
253
+ stacks: Record<string, Stack>;
254
+ decode?: (date: string) => string;
255
+ minLabelDistanceFormatOverride: Record<string, number>;
256
+ format: string;
257
+ origin: number;
258
+ scale: TimeScaleRange;
259
+ a: number;
260
+ b: number;
261
+ tickMeasure: string;
262
+ resolvedFormat: string | null;
263
+ resolvedMinLabelDistance: number;
264
+ shouldUpdate: boolean;
265
+
266
+ reset(
267
+ min: any,
268
+ max: any,
269
+ snapToTicks: number | false,
270
+ tickDivisions: Record<string, number[][]>,
271
+ minTickDistance: number,
272
+ minLabelDistance: number,
273
+ normalized: boolean,
274
+ inverted: boolean,
275
+ minTickUnit: string,
276
+ lowerDeadZone: number,
277
+ upperDeadZone: number,
278
+ decode: ((date: string) => string) | undefined,
279
+ minLabelDistanceFormatOverride: Record<string, number>,
280
+ format: string,
281
+ ): void {
282
+ this.dateCache = {};
283
+ this.min = min != null ? this.decodeValue(min) : null;
284
+ this.max = max != null ? this.decodeValue(max) : null;
285
+ this.snapToTicks = snapToTicks;
286
+ this.tickDivisions = tickDivisions;
287
+ this.minLabelDistance = minLabelDistance;
288
+ this.minTickDistance = minTickDistance;
289
+ this.tickSizes = [];
290
+ this.normalized = normalized;
291
+ this.minTickUnit = minTickUnit;
292
+ this.inverted = inverted;
293
+ this.lowerDeadZone = lowerDeadZone || 0;
294
+ this.upperDeadZone = upperDeadZone || 0;
295
+ this.minValue = undefined;
296
+ this.maxValue = undefined;
297
+ this.minValuePadded = undefined;
298
+ this.maxValuePadded = undefined;
299
+ this.stacks = {};
300
+ this.decode = decode;
301
+ this.minLabelDistanceFormatOverride = minLabelDistanceFormatOverride;
302
+ this.format = format;
303
+ }
304
+
305
+ decodeValue(date: any): number {
306
+ if (date instanceof Date) return date.getTime();
307
+
308
+ switch (typeof date) {
309
+ case "string":
310
+ let v = this.dateCache[date];
311
+ if (!v) {
312
+ if (this.decode) date = this.decode(date);
313
+ v = this.dateCache[date] = parseDateInvariant(date).getTime();
314
+ }
315
+ return v;
316
+
317
+ case "number":
318
+ return parseDateInvariant(date).getTime();
319
+ }
320
+ return 0;
321
+ }
322
+
323
+ encodeValue(v: number): string {
324
+ return new Date(v).toISOString();
325
+ }
326
+
327
+ getFormat(unit: string, scale: TimeScaleRange): string {
328
+ switch (unit) {
329
+ case "year":
330
+ return "datetime;yyyy";
331
+
332
+ case "month":
333
+ if (new Date(scale.min).getFullYear() != new Date(scale.max).getFullYear()) return "yearOrMonth";
334
+ return "datetime;yyyy MMM";
335
+
336
+ case "week":
337
+ return "datetime;MMMdd";
338
+
339
+ case "day":
340
+ if (
341
+ new Date(scale.min).getFullYear() != new Date(scale.max).getFullYear() ||
342
+ new Date(scale.min).getMonth() != new Date(scale.max).getMonth()
343
+ )
344
+ return "monthOrDay";
345
+
346
+ return TimeFormats.shortMonthDate;
347
+
348
+ case "hour":
349
+ return "datetime;HH mm n";
350
+
351
+ case "minute":
352
+ return "datetime;HH mm n";
353
+
354
+ case "second":
355
+ return "datetime;mm ss";
356
+
357
+ default:
358
+ return TimeFormats.fullDateAndTime;
359
+ }
360
+ }
361
+
362
+ map(v: any, offset: number = 0): number {
363
+ return this.origin + (this.decodeValue(v) + offset - this.scale.min + this.scale.minPadding) * this.scale.factor;
364
+ }
365
+
366
+ constrainValue(v: number): number {
367
+ return Math.max(this.scale.min, Math.min(this.scale.max, v));
368
+ }
369
+
370
+ trackValue(v: number, offset: number = 0, constrain: boolean = false): number {
371
+ let value = (v - this.origin) / this.scale.factor - offset + this.scale.min - this.scale.minPadding;
372
+ if (constrain) value = this.constrainValue(value);
373
+ return value;
374
+ }
375
+
376
+ hash(): Record<string, any> {
377
+ let r: any = {
378
+ origin: this.origin,
379
+ factor: this.scale.factor,
380
+ min: this.scale.min,
381
+ max: this.scale.max,
382
+ minPadding: this.scale.minPadding,
383
+ maxPadding: this.scale.maxPadding,
384
+ };
385
+ r.stacks = Object.keys(this.stacks)
386
+ .map((s) => this.stacks[s].info?.join(","))
387
+ .join(":");
388
+ return r;
389
+ }
390
+
391
+ isSame(x: any): boolean {
392
+ let hash = this.hash();
393
+ let same = x && !Object.keys(hash).some((k) => x[k] !== hash[k]);
394
+ this.shouldUpdate = !same;
395
+ return same;
396
+ }
397
+
398
+ measure(a: number, b: number): void {
399
+ this.a = a;
400
+ this.b = b;
401
+
402
+ for (let s in this.stacks) {
403
+ let info = this.stacks[s].measure(this.normalized);
404
+ let [min, max] = info;
405
+ if (this.minValue == null || min < this.minValue) this.minValue = min;
406
+ if (this.max == null || max > this.maxValue!) this.maxValue = max;
407
+ this.stacks[s].info = info;
408
+ }
409
+
410
+ if (this.min == null) {
411
+ if (this.minValue != null) this.min = this.minValue;
412
+ else this.min = 0;
413
+ }
414
+
415
+ if (this.max == null) {
416
+ if (this.maxValue != null) this.max = this.maxValue;
417
+ else this.max = this.normalized ? 1 : 100;
418
+ }
419
+
420
+ this.origin = this.inverted ? this.b : this.a;
421
+
422
+ this.calculateTicks();
423
+ if (this.scale == null) {
424
+ this.scale = this.getScale();
425
+ }
426
+ }
427
+
428
+ getTimezoneOffset(date: Date): number {
429
+ return date.getTimezoneOffset() * 60 * 1000;
430
+ }
431
+
432
+ getScale(tickSize?: number | null, measure?: string, minRange: number = 1000): TimeScaleRange {
433
+ let { min, max, upperDeadZone, lowerDeadZone } = this;
434
+
435
+ let smin: number = min!;
436
+ let smax: number = max!;
437
+
438
+ if (tickSize) {
439
+ let minDate = new Date(min!);
440
+ let maxDate = new Date(max!);
441
+
442
+ switch (measure) {
443
+ case "second":
444
+ case "minute":
445
+ case "hour":
446
+ case "day":
447
+ default:
448
+ let minOffset = this.getTimezoneOffset(minDate);
449
+ let maxOffset = this.getTimezoneOffset(maxDate);
450
+ let mondayOffset = 4 * milliSeconds.day; //new Date(0).getDay() => 4
451
+ smin = Math.floor((smin - minOffset - mondayOffset) / tickSize) * tickSize + minOffset + mondayOffset;
452
+ smax = Math.ceil((smax - maxOffset - mondayOffset) / tickSize) * tickSize + maxOffset + mondayOffset;
453
+ break;
454
+
455
+ case "month":
456
+ tickSize /= milliSeconds.month;
457
+ let minMonth = monthNumber(minDate);
458
+ let maxMonth = monthNumber(maxDate);
459
+ minMonth = Math.floor(minMonth / tickSize) * tickSize;
460
+ maxMonth = Math.ceil(maxMonth / tickSize) * tickSize;
461
+ smin = new Date(Math.floor(minMonth / 12), minMonth % 12, 1).getTime();
462
+ smax = new Date(Math.floor(maxMonth / 12), maxMonth % 12, 1).getTime();
463
+ break;
464
+
465
+ case "year":
466
+ tickSize /= milliSeconds.year;
467
+ let minYear = yearNumber(minDate);
468
+ let maxYear = yearNumber(maxDate);
469
+ minYear = Math.floor(minYear / tickSize) * tickSize;
470
+ maxYear = Math.ceil(maxYear / tickSize) * tickSize;
471
+ smin = new Date(minYear, 0, 1).getTime();
472
+ smax = new Date(maxYear, 0, 1).getTime();
473
+ break;
474
+ }
475
+ } else {
476
+ if (this.minValue == min) smin = this.minValuePadded!;
477
+ if (this.maxValue == max) smax = this.maxValuePadded!;
478
+ }
479
+
480
+ if (smax - smin < minRange) {
481
+ let delta = (minRange - (smax - smin)) / 2;
482
+ smin -= delta;
483
+ smax += delta;
484
+ }
485
+
486
+ //padding should be activated only if using min/max obtained from the data
487
+ let minPadding = this.minValue === min ? Math.max(0, smin - this.minValuePadded!) : 0;
488
+ let maxPadding = this.maxValue === max ? Math.max(0, this.maxValuePadded! - smax) : 0;
489
+
490
+ let factor = smin < smax ? Math.abs(this.b - this.a) / (smax - smin + minPadding + maxPadding) : 0;
491
+ if (factor > 0 && (upperDeadZone > 0 || lowerDeadZone > 0)) {
492
+ smin -= lowerDeadZone / factor;
493
+ smax += upperDeadZone / factor;
494
+ minPadding = this.minValuePadded != null ? Math.max(0, smin - this.minValuePadded) : 0;
495
+ maxPadding = this.maxValuePadded != null ? Math.max(0, this.maxValuePadded - smax) : 0;
496
+ factor = smin < smax ? Math.abs(this.b - this.a) / (smax - smin + minPadding + maxPadding) : 0;
497
+ }
498
+
499
+ let sign = this.b > this.a ? 1 : -1;
500
+
501
+ return {
502
+ factor: sign * (this.inverted ? -factor : factor),
503
+ min: smin,
504
+ max: smax,
505
+ minPadding,
506
+ maxPadding,
507
+ };
508
+ }
509
+
510
+ acknowledge(value: any, width: number = 0, offset: number = 0): void {
511
+ value = this.decodeValue(value);
512
+ if (this.minValue == null || value + offset - width / 2 < this.minValuePadded!) {
513
+ this.minValue = value;
514
+ this.minValuePadded = value + offset - width / 2;
515
+ }
516
+ if (this.maxValue == null || value + offset + width / 2 > this.maxValuePadded!) {
517
+ this.maxValue = value;
518
+ this.maxValuePadded = value + offset + width / 2;
519
+ }
520
+ }
521
+
522
+ getStack(name: string): Stack {
523
+ let s = this.stacks[name];
524
+ if (!s) s = this.stacks[name] = new Stack();
525
+ return s;
526
+ }
527
+
528
+ stacknowledge(name: string, ordinal: string, value: number | null): void {
529
+ return this.getStack(name).acknowledge(ordinal, value);
530
+ }
531
+
532
+ stack(name: string, ordinal: string, value: number | null): number | null {
533
+ let v = this.getStack(name).stack(ordinal, value);
534
+ return v != null ? this.map(v) : null;
535
+ }
536
+
537
+ findTickSize(minPxDist: number): TickSize | undefined {
538
+ return this.tickSizes.find(({ size, noLabels }) => !noLabels && size * Math.abs(this.scale.factor) >= minPxDist);
539
+ }
540
+
541
+ getTickSizes(): TickSize[] {
542
+ return this.tickSizes;
543
+ }
544
+
545
+ calculateTicks(): void {
546
+ let minReached = false;
547
+
548
+ let minRange = 1000;
549
+
550
+ for (let unit in milliSeconds) {
551
+ if (!minReached) {
552
+ if (unit == this.minTickUnit) minReached = true;
553
+ else continue;
554
+ }
555
+
556
+ let unitSize = milliSeconds[unit];
557
+ let divisions = this.tickDivisions[unit];
558
+
559
+ if (this.tickSizes.length > 0) {
560
+ //add ticks from higher levels
561
+ this.tickSizes.push(...divisions[0].map((s) => ({ size: s * unitSize, measure: unit })));
562
+ break;
563
+ }
564
+
565
+ let bestLabelDistance = Infinity;
566
+ let bestMinLabelDistance = this.minLabelDistance;
567
+ let bestTicks: number[] = [];
568
+ let bestScale: TimeScaleRange | null = null;
569
+ let bestFormat: string | null = null;
570
+
571
+ this.tickMeasure = unit;
572
+
573
+ for (let i = 0; i < divisions.length; i++) {
574
+ let divs = divisions[i];
575
+ for (let d = 0; d < divs.length; d++) {
576
+ //if (useSnapToTicks && d < Math.min(divs.length - 1, this.snapToTicks)) continue;
577
+ let tickSize = divs[d] * unitSize;
578
+ let scale = this.getScale(null, unit, tickSize);
579
+ let format = this.format ?? this.getFormat(unit, scale);
580
+ let minLabelDistance = this.minLabelDistanceFormatOverride[format] ?? this.minLabelDistance;
581
+ let labelDistance = tickSize * Math.abs(scale.factor);
582
+ if (labelDistance >= minLabelDistance && labelDistance < bestLabelDistance) {
583
+ bestScale = scale;
584
+ bestTicks = divs.map((s) => s * unitSize);
585
+ bestLabelDistance = labelDistance;
586
+ bestFormat = format;
587
+ bestMinLabelDistance = minLabelDistance;
588
+ minRange = tickSize;
589
+ }
590
+ }
591
+ }
592
+
593
+ this.scale = bestScale!;
594
+ this.tickSizes = bestTicks
595
+ .filter((ts) => ts * Math.abs(bestScale!.factor) >= this.minTickDistance)
596
+ .map((size) => ({ size, measure: this.tickMeasure }));
597
+ this.resolvedFormat = bestFormat;
598
+ this.resolvedMinLabelDistance = bestMinLabelDistance;
599
+ }
600
+
601
+ let lowerTickUnit: string | null = null;
602
+ switch (this.tickMeasure) {
603
+ case "year":
604
+ lowerTickUnit = "month";
605
+ break;
606
+ case "month":
607
+ lowerTickUnit = "day";
608
+ break;
609
+ case "week":
610
+ lowerTickUnit = "day";
611
+ break;
612
+ case "day":
613
+ lowerTickUnit = "hour";
614
+ break;
615
+ case "hour":
616
+ lowerTickUnit = "minute";
617
+ break;
618
+ case "minute":
619
+ lowerTickUnit = "second";
620
+ break;
621
+ }
622
+
623
+ if (lowerTickUnit && this.minTickUnit && milliSeconds[lowerTickUnit] < milliSeconds[this.minTickUnit])
624
+ lowerTickUnit = this.minTickUnit == this.tickMeasure ? null : this.minTickUnit;
625
+
626
+ if (lowerTickUnit != null && this.scale) {
627
+ let bestMinorTickSize = Infinity;
628
+ let divisions = this.tickDivisions[lowerTickUnit];
629
+ let unitSize = milliSeconds[lowerTickUnit];
630
+ for (let i = 0; i < divisions.length; i++) {
631
+ let divs = divisions[i];
632
+ for (let d = 0; d < divs.length; d++) {
633
+ let tickSize = divs[d] * unitSize;
634
+ if (tickSize * Math.abs(this.scale.factor) >= this.minTickDistance && tickSize < bestMinorTickSize) {
635
+ bestMinorTickSize = tickSize;
636
+ }
637
+ }
638
+ }
639
+ if (bestMinorTickSize != Infinity) {
640
+ this.tickSizes.unshift({ size: bestMinorTickSize, measure: lowerTickUnit, noLabels: true });
641
+ if (this.tickSizes.length > 1) {
642
+ let labelStep = this.tickSizes[1].size;
643
+ let lowerScale = this.getScale(null, lowerTickUnit, minRange);
644
+ if (lowerScale.max - lowerScale.min >= labelStep) this.scale = lowerScale;
645
+ }
646
+ }
647
+ }
648
+
649
+ if (isNumber(this.snapToTicks) && this.snapToTicks >= 0 && this.tickSizes.length > 0) {
650
+ let tickSize = this.tickSizes[Math.min(this.tickSizes.length - 1, this.snapToTicks)];
651
+ this.scale = this.getScale(tickSize.size, tickSize.measure, minRange);
652
+ }
653
+ }
654
+
655
+ getTicks(tickSizes: TickSize[]): (number | Date)[][] {
656
+ return tickSizes.map(({ size, measure }) => {
657
+ let result: (number | Date)[] = [],
658
+ start: number,
659
+ end: number,
660
+ minDate: Date,
661
+ maxDate: Date;
662
+ if (measure == "year") {
663
+ size /= milliSeconds.year;
664
+ minDate = new Date(this.scale.min - this.scale.minPadding);
665
+ maxDate = new Date(this.scale.max + this.scale.maxPadding);
666
+ start = Math.ceil(yearNumber(minDate) / size) * size;
667
+ end = Math.floor(yearNumber(maxDate) / size) * size;
668
+ for (let i = start; i <= end; i += size) result.push(new Date(i, 0, 1).getTime());
669
+ } else if (measure == "month") {
670
+ size /= milliSeconds.month;
671
+ minDate = new Date(this.scale.min - this.scale.minPadding);
672
+ maxDate = new Date(this.scale.max + this.scale.maxPadding);
673
+ start = Math.ceil(monthNumber(minDate) / size) * size;
674
+ end = Math.floor(monthNumber(maxDate) / size) * size;
675
+ for (let i = start; i <= end; i += size) result.push(new Date(Math.floor(i / 12), i % 12, 1).getTime());
676
+ } else if (measure == "day" || measure == "week") {
677
+ let multiplier = measure == "week" ? 7 : 1;
678
+ size /= milliSeconds.day;
679
+ minDate = new Date(this.scale.min - this.scale.minPadding);
680
+ maxDate = new Date(this.scale.max + this.scale.maxPadding);
681
+ let date = zeroTime(minDate);
682
+ while (date.getTime() < minDate.getTime()) date.setDate(date.getDate() + 1);
683
+ if (measure == "week") {
684
+ //start on monday
685
+ while (date.getDay() != 1) {
686
+ date.setDate(date.getDate() + 1);
687
+ }
688
+ }
689
+ while (date.getTime() <= maxDate.getTime()) {
690
+ result.push(date);
691
+ date = new Date(date);
692
+ date.setDate(date.getDate() + multiplier);
693
+ }
694
+ } else {
695
+ let minOffset = this.getTimezoneOffset(new Date(this.scale.min - this.scale.minPadding));
696
+ let mondayOffset = 4 * milliSeconds.day;
697
+ let date =
698
+ Math.ceil((this.scale.min - this.scale.minPadding - minOffset - mondayOffset) / size) * size +
699
+ minOffset +
700
+ mondayOffset;
701
+ while (date <= this.scale.max + this.scale.maxPadding) {
702
+ result.push(date);
703
+ date += size;
704
+ }
705
+ }
706
+ return result;
707
+ });
708
+ }
709
+
710
+ mapGridlines(): number[] {
711
+ if (this.tickSizes.length == 0) return [];
712
+ return this.getTicks([this.tickSizes[0]])[0].map((x) => this.map(x));
713
+ }
714
+
715
+ book(): void {
716
+ Console.warn("TimeAxis does not support the autoSize flag for column and bar graphs.");
717
+ }
718
+ }