cx 26.1.3 → 26.1.5

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 (568) 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/exprHelpers.d.ts +12 -0
  6. package/build/ui/exprHelpers.js +17 -0
  7. package/build/ui/tpl.d.ts +5 -3
  8. package/build/ui/tpl.js +11 -4
  9. package/build.js +133 -133
  10. package/dist/manifest.js +782 -779
  11. package/dist/ui.js +26 -4
  12. package/package.json +100 -100
  13. package/src/charts/Bar.scss +28 -28
  14. package/src/charts/Bar.ts +114 -114
  15. package/src/charts/BarGraph.scss +28 -28
  16. package/src/charts/BarGraph.tsx +145 -145
  17. package/src/charts/BubbleGraph.scss +31 -31
  18. package/src/charts/BubbleGraph.tsx +165 -165
  19. package/src/charts/Chart.ts +108 -108
  20. package/src/charts/ColorMap.ts +150 -150
  21. package/src/charts/Column.scss +28 -28
  22. package/src/charts/Column.ts +124 -124
  23. package/src/charts/ColumnBarBase.tsx +284 -284
  24. package/src/charts/ColumnBarGraphBase.tsx +229 -229
  25. package/src/charts/ColumnGraph.scss +29 -29
  26. package/src/charts/ColumnGraph.tsx +153 -153
  27. package/src/charts/Grid.ts +5 -5
  28. package/src/charts/Gridlines.scss +24 -24
  29. package/src/charts/Gridlines.tsx +88 -88
  30. package/src/charts/Legend.scss +50 -50
  31. package/src/charts/Legend.tsx +270 -270
  32. package/src/charts/LegendEntry.scss +29 -29
  33. package/src/charts/LegendEntry.tsx +197 -197
  34. package/src/charts/LineGraph.scss +24 -24
  35. package/src/charts/LineGraph.tsx +455 -455
  36. package/src/charts/Marker.scss +43 -43
  37. package/src/charts/Marker.tsx +483 -483
  38. package/src/charts/MarkerLine.scss +19 -19
  39. package/src/charts/MarkerLine.tsx +214 -214
  40. package/src/charts/MouseTracker.tsx +112 -112
  41. package/src/charts/Pie.ts +8 -8
  42. package/src/charts/PieChart.scss +28 -28
  43. package/src/charts/PieChart.tsx +717 -717
  44. package/src/charts/PieLabel.tsx +106 -106
  45. package/src/charts/PieLabelsContainer.ts +68 -68
  46. package/src/charts/Range.scss +19 -19
  47. package/src/charts/Range.tsx +318 -318
  48. package/src/charts/RangeMarker.scss +17 -17
  49. package/src/charts/RangeMarker.tsx +233 -233
  50. package/src/charts/ScatterGraph.scss +23 -23
  51. package/src/charts/ScatterGraph.tsx +245 -245
  52. package/src/charts/Swimlane.scss +16 -16
  53. package/src/charts/Swimlane.tsx +195 -195
  54. package/src/charts/Swimlanes.scss +16 -16
  55. package/src/charts/Swimlanes.tsx +179 -179
  56. package/src/charts/axis/Axis.scss +22 -22
  57. package/src/charts/axis/Axis.tsx +444 -444
  58. package/src/charts/axis/CategoryAxis.scss +34 -34
  59. package/src/charts/axis/CategoryAxis.tsx +313 -313
  60. package/src/charts/axis/NumericAxis.scss +34 -34
  61. package/src/charts/axis/NumericAxis.tsx +437 -437
  62. package/src/charts/axis/Stack.ts +61 -61
  63. package/src/charts/axis/TimeAxis.scss +33 -33
  64. package/src/charts/axis/TimeAxis.tsx +718 -718
  65. package/src/charts/axis/index.scss +5 -5
  66. package/src/charts/axis/index.ts +3 -3
  67. package/src/charts/axis/variables.scss +2 -2
  68. package/src/charts/helpers/MinMaxFinder.ts +66 -66
  69. package/src/charts/helpers/PointReducer.ts +135 -135
  70. package/src/charts/helpers/SnapPointFinder.ts +136 -136
  71. package/src/charts/helpers/ValueAtFinder.ts +72 -72
  72. package/src/charts/helpers/index.ts +4 -4
  73. package/src/charts/index.scss +22 -22
  74. package/src/charts/index.ts +34 -34
  75. package/src/charts/palette.scss +97 -97
  76. package/src/charts/shapes.tsx +86 -86
  77. package/src/charts/variables.scss +22 -22
  78. package/src/core.d.ts +182 -182
  79. package/src/data/AggregateFunction.ts +171 -171
  80. package/src/data/ArrayElementView.spec.ts +88 -88
  81. package/src/data/ArrayElementView.ts +91 -91
  82. package/src/data/ArrayRef.ts +34 -34
  83. package/src/data/AugmentedViewBase.ts +88 -88
  84. package/src/data/Binding.spec.ts +69 -69
  85. package/src/data/Binding.ts +104 -104
  86. package/src/data/ExposedRecordView.ts +95 -95
  87. package/src/data/ExposedValueView.ts +89 -89
  88. package/src/data/Expression.spec.ts +229 -229
  89. package/src/data/Expression.ts +233 -233
  90. package/src/data/Grouper.spec.ts +57 -57
  91. package/src/data/Grouper.ts +158 -158
  92. package/src/data/NestedDataView.ts +43 -43
  93. package/src/data/ReadOnlyDataView.ts +39 -39
  94. package/src/data/Ref.spec.ts +79 -79
  95. package/src/data/Ref.ts +104 -104
  96. package/src/data/Selector.ts +10 -10
  97. package/src/data/Store.spec.ts +22 -22
  98. package/src/data/Store.ts +52 -52
  99. package/src/data/StoreProxy.ts +19 -19
  100. package/src/data/StoreRef.spec.ts +24 -24
  101. package/src/data/StoreRef.ts +66 -66
  102. package/src/data/StringTemplate.spec.ts +132 -132
  103. package/src/data/StringTemplate.ts +93 -93
  104. package/src/data/StructuredSelector.spec.ts +113 -113
  105. package/src/data/StructuredSelector.ts +146 -146
  106. package/src/data/SubscribableView.ts +63 -63
  107. package/src/data/View.spec.ts +60 -60
  108. package/src/data/View.ts +289 -289
  109. package/src/data/ZoomIntoPropertyView.spec.ts +64 -64
  110. package/src/data/ZoomIntoPropertyView.ts +45 -45
  111. package/src/data/comparer.spec.ts +60 -60
  112. package/src/data/comparer.ts +78 -78
  113. package/src/data/computable.spec.ts +87 -87
  114. package/src/data/computable.ts +69 -69
  115. package/src/data/createAccessorModelProxy.spec.tsx +145 -145
  116. package/src/data/createAccessorModelProxy.ts +66 -66
  117. package/src/data/createStructuredSelector.spec.ts +45 -45
  118. package/src/data/createStructuredSelector.ts +62 -62
  119. package/src/data/defaultCompare.ts +14 -14
  120. package/src/data/diff/diffArrays.ts +49 -49
  121. package/src/data/diff/diffs.spec.ts +49 -49
  122. package/src/data/diff/index.ts +1 -1
  123. package/src/data/enableFatArrowExpansion.ts +6 -6
  124. package/src/data/getAccessor.spec.ts +11 -11
  125. package/src/data/getAccessor.ts +74 -74
  126. package/src/data/getSelector.spec.ts +43 -43
  127. package/src/data/getSelector.ts +66 -66
  128. package/src/data/index.ts +30 -30
  129. package/src/data/isSelector.ts +26 -26
  130. package/src/data/ops/append.spec.ts +28 -28
  131. package/src/data/ops/append.ts +5 -5
  132. package/src/data/ops/filter.spec.ts +35 -35
  133. package/src/data/ops/filter.ts +9 -9
  134. package/src/data/ops/findTreeNode.spec.ts +23 -23
  135. package/src/data/ops/findTreeNode.ts +14 -14
  136. package/src/data/ops/findTreePath.ts +23 -23
  137. package/src/data/ops/index.ts +11 -11
  138. package/src/data/ops/insertElement.ts +3 -3
  139. package/src/data/ops/merge.spec.ts +27 -27
  140. package/src/data/ops/merge.ts +13 -13
  141. package/src/data/ops/moveElement.ts +21 -21
  142. package/src/data/ops/removeTreeNodes.spec.ts +37 -37
  143. package/src/data/ops/removeTreeNodes.ts +15 -15
  144. package/src/data/ops/updateArray.spec.ts +69 -69
  145. package/src/data/ops/updateArray.ts +31 -31
  146. package/src/data/ops/updateTree.spec.ts +54 -54
  147. package/src/data/ops/updateTree.ts +23 -23
  148. package/src/data/test-types.ts +7 -7
  149. package/src/global.scss +13 -13
  150. package/src/hooks/createLocalStorageRef.ts +21 -21
  151. package/src/hooks/index.ts +8 -8
  152. package/src/hooks/invokeCallback.spec.tsx +59 -59
  153. package/src/hooks/invokeCallback.ts +8 -8
  154. package/src/hooks/resolveCallback.spec.tsx +71 -71
  155. package/src/hooks/resolveCallback.ts +16 -16
  156. package/src/hooks/store.spec.tsx +67 -67
  157. package/src/hooks/store.ts +46 -46
  158. package/src/hooks/useEffect.ts +14 -14
  159. package/src/hooks/useInterval.ts +8 -8
  160. package/src/hooks/useState.ts +20 -20
  161. package/src/hooks/useTrigger.spec.tsx +105 -105
  162. package/src/hooks/useTrigger.ts +26 -26
  163. package/src/index.scss +6 -6
  164. package/src/index.ts +7 -7
  165. package/src/jsx-dev-runtime.ts +4 -4
  166. package/src/jsx-runtime.spec.tsx +431 -431
  167. package/src/jsx-runtime.ts +79 -79
  168. package/src/locale/de-de.ts +76 -76
  169. package/src/locale/en-us.ts +75 -75
  170. package/src/locale/es-es.ts +76 -76
  171. package/src/locale/fr-fr.ts +76 -76
  172. package/src/locale/nl-nl.ts +76 -76
  173. package/src/locale/pt-pt.ts +76 -76
  174. package/src/locale/sr-latn-ba.ts +76 -76
  175. package/src/svg/BoundedObject.ts +101 -101
  176. package/src/svg/ClipRect.tsx +29 -29
  177. package/src/svg/Ellipse.tsx +68 -68
  178. package/src/svg/Line.tsx +58 -58
  179. package/src/svg/NonOverlappingRect.ts +26 -26
  180. package/src/svg/NonOverlappingRectGroup.ts +49 -49
  181. package/src/svg/Rectangle.tsx +90 -90
  182. package/src/svg/Svg.scss +27 -27
  183. package/src/svg/Svg.tsx +241 -241
  184. package/src/svg/Text.tsx +134 -134
  185. package/src/svg/TextualBoundedObject.ts +35 -35
  186. package/src/svg/index.scss +8 -8
  187. package/src/svg/index.ts +17 -17
  188. package/src/svg/util/Rect.ts +105 -105
  189. package/src/ui/CSS.ts +87 -87
  190. package/src/ui/CSSHelper.ts +17 -17
  191. package/src/ui/Container.tsx +216 -216
  192. package/src/ui/ContentResolver.spec.tsx +585 -585
  193. package/src/ui/ContentResolver.ts +132 -132
  194. package/src/ui/Controller.spec.tsx +574 -574
  195. package/src/ui/Controller.ts +202 -202
  196. package/src/ui/Culture.ts +159 -159
  197. package/src/ui/Cx.spec.tsx +210 -210
  198. package/src/ui/Cx.tsx +386 -386
  199. package/src/ui/DataProxy.spec.tsx +337 -337
  200. package/src/ui/DataProxy.ts +55 -55
  201. package/src/ui/DetachedScope.tsx +159 -159
  202. package/src/ui/FocusManager.ts +171 -171
  203. package/src/ui/Format.ts +108 -108
  204. package/src/ui/HoverSync.tsx +189 -189
  205. package/src/ui/Instance.ts +866 -866
  206. package/src/ui/IsolatedScope.spec.tsx +62 -62
  207. package/src/ui/IsolatedScope.ts +50 -50
  208. package/src/ui/Localization.ts +70 -70
  209. package/src/ui/Prop.ts +140 -140
  210. package/src/ui/PureContainer.spec.tsx +232 -232
  211. package/src/ui/PureContainer.tsx +19 -19
  212. package/src/ui/RenderingContext.ts +99 -99
  213. package/src/ui/Repeater.spec.tsx +143 -143
  214. package/src/ui/Repeater.ts +194 -194
  215. package/src/ui/Rescope.spec.tsx +199 -199
  216. package/src/ui/Rescope.ts +49 -49
  217. package/src/ui/ResizeManager.ts +30 -30
  218. package/src/ui/Restate.spec.tsx +422 -422
  219. package/src/ui/Restate.tsx +217 -217
  220. package/src/ui/StaticText.ts +11 -11
  221. package/src/ui/StructuredInstanceDataAccessor.ts +32 -32
  222. package/src/ui/Text.ts +49 -49
  223. package/src/ui/VDOM.ts +1 -1
  224. package/src/ui/Widget.spec.tsx +53 -53
  225. package/src/ui/Widget.tsx +301 -301
  226. package/src/ui/ZIndexManager.ts +11 -11
  227. package/src/ui/adapter/ArrayAdapter.spec.ts +55 -55
  228. package/src/ui/adapter/ArrayAdapter.ts +229 -229
  229. package/src/ui/adapter/DataAdapter.ts +52 -52
  230. package/src/ui/adapter/GroupAdapter.ts +235 -235
  231. package/src/ui/adapter/TreeAdapter.spec.ts +76 -76
  232. package/src/ui/adapter/TreeAdapter.ts +185 -185
  233. package/src/ui/adapter/index.ts +4 -4
  234. package/src/ui/app/History.ts +133 -133
  235. package/src/ui/app/Url.spec.ts +50 -50
  236. package/src/ui/app/Url.ts +102 -102
  237. package/src/ui/app/index.ts +5 -5
  238. package/src/ui/app/startAppLoop.tsx +71 -71
  239. package/src/ui/app/startHotAppLoop.ts +41 -41
  240. package/src/ui/batchUpdates.ts +77 -77
  241. package/src/ui/bind.ts +10 -10
  242. package/src/ui/createFunctionalComponent.spec.tsx +454 -454
  243. package/src/ui/createFunctionalComponent.ts +86 -86
  244. package/src/ui/expr.ts +47 -47
  245. package/src/ui/exprHelpers.spec.ts +412 -379
  246. package/src/ui/exprHelpers.ts +18 -0
  247. package/src/ui/flattenProps.ts +21 -21
  248. package/src/ui/index.scss +2 -2
  249. package/src/ui/index.ts +47 -47
  250. package/src/ui/keyboardShortcuts.ts +40 -40
  251. package/src/ui/layout/Content.ts +30 -30
  252. package/src/ui/layout/ContentPlaceholder.spec.tsx +599 -599
  253. package/src/ui/layout/ContentPlaceholder.ts +133 -133
  254. package/src/ui/layout/FirstVisibleChildLayout.spec.tsx +207 -207
  255. package/src/ui/layout/FirstVisibleChildLayout.ts +60 -60
  256. package/src/ui/layout/LabelsLeftLayout.scss +46 -46
  257. package/src/ui/layout/LabelsLeftLayout.tsx +76 -76
  258. package/src/ui/layout/LabelsTopLayout.scss +64 -64
  259. package/src/ui/layout/LabelsTopLayout.tsx +156 -156
  260. package/src/ui/layout/UseParentLayout.ts +8 -8
  261. package/src/ui/layout/exploreChildren.ts +38 -38
  262. package/src/ui/layout/index.scss +3 -3
  263. package/src/ui/layout/index.ts +10 -10
  264. package/src/ui/layout/variables.scss +2 -2
  265. package/src/ui/selection/KeySelection.ts +153 -153
  266. package/src/ui/selection/PropertySelection.ts +87 -87
  267. package/src/ui/selection/Selection.ts +128 -128
  268. package/src/ui/selection/index.ts +3 -3
  269. package/src/ui/tpl.spec.ts +69 -0
  270. package/src/ui/tpl.ts +17 -4
  271. package/src/ui/variables.scss +1 -1
  272. package/src/util/Component.spec.ts +411 -411
  273. package/src/util/Component.ts +301 -301
  274. package/src/util/Console.ts +13 -13
  275. package/src/util/DOM.ts +88 -88
  276. package/src/util/Debug.ts +71 -71
  277. package/src/util/Format.spec.ts +69 -69
  278. package/src/util/Format.ts +267 -267
  279. package/src/util/GlobalCacheIdentifier.ts +11 -11
  280. package/src/util/KeyCode.ts +21 -21
  281. package/src/util/SubscriberList.ts +86 -86
  282. package/src/util/Timing.ts +58 -58
  283. package/src/util/TraversalStack.spec.ts +53 -53
  284. package/src/util/TraversalStack.ts +47 -47
  285. package/src/util/addEventListenerWithOptions.ts +41 -41
  286. package/src/util/browserSupportsPassiveEventHandlers.ts +20 -20
  287. package/src/util/calculateNaturalElementHeight.ts +22 -22
  288. package/src/util/call-once.scss +6 -6
  289. package/src/util/capitalize.ts +4 -4
  290. package/src/util/coalesce.ts +6 -6
  291. package/src/util/color/hslToRgb.ts +34 -34
  292. package/src/util/color/index.ts +4 -4
  293. package/src/util/color/parseColor.ts +173 -173
  294. package/src/util/color/rgbToHex.ts +14 -14
  295. package/src/util/color/rgbToHsl.ts +35 -35
  296. package/src/util/date/dateDiff.ts +9 -9
  297. package/src/util/date/diff.ts +13 -13
  298. package/src/util/date/encodeDate.ts +8 -8
  299. package/src/util/date/encodeDateWithTimezoneOffset.ts +18 -18
  300. package/src/util/date/index.ts +11 -11
  301. package/src/util/date/lowerBoundCheck.ts +13 -13
  302. package/src/util/date/maxDate.ts +14 -14
  303. package/src/util/date/minDate.ts +14 -14
  304. package/src/util/date/monthStart.ts +8 -8
  305. package/src/util/date/parseDateInvariant.ts +20 -20
  306. package/src/util/date/sameDate.ts +11 -11
  307. package/src/util/date/upperBoundCheck.spec.ts +30 -30
  308. package/src/util/date/upperBoundCheck.ts +13 -13
  309. package/src/util/date/zeroTime.ts +9 -9
  310. package/src/util/debounce.ts +26 -26
  311. package/src/util/dummyCallback.ts +1 -1
  312. package/src/util/escapeSpecialRegexCharacters.ts +8 -8
  313. package/src/util/eventCallbacks.ts +12 -12
  314. package/src/util/expandFatArrows.ts +118 -118
  315. package/src/util/findScrollableParent.ts +15 -15
  316. package/src/util/getActiveElement.ts +4 -4
  317. package/src/util/getParentFrameBoundingClientRect.ts +13 -13
  318. package/src/util/getScrollerBoundingClientRect.ts +12 -12
  319. package/src/util/getSearchQueryPredicate.spec.ts +40 -40
  320. package/src/util/getSearchQueryPredicate.ts +58 -58
  321. package/src/util/getTopLevelBoundingClientRect.ts +7 -7
  322. package/src/util/getVendorPrefix.ts +33 -33
  323. package/src/util/hasKey.ts +18 -18
  324. package/src/util/index.scss +10 -10
  325. package/src/util/index.ts +55 -55
  326. package/src/util/innerTextTrim.ts +10 -10
  327. package/src/util/isArray.ts +3 -3
  328. package/src/util/isDataRecord.ts +5 -5
  329. package/src/util/isDefined.ts +3 -3
  330. package/src/util/isDigit.ts +8 -8
  331. package/src/util/isFunction.ts +3 -3
  332. package/src/util/isNonEmptyArray.ts +3 -3
  333. package/src/util/isNumber.ts +3 -3
  334. package/src/util/isObject.ts +3 -3
  335. package/src/util/isPromise.ts +6 -6
  336. package/src/util/isString.ts +3 -3
  337. package/src/util/isTextInputElement.ts +2 -2
  338. package/src/util/isTouchDevice.ts +7 -7
  339. package/src/util/isTouchEvent.ts +64 -64
  340. package/src/util/isUndefined.ts +3 -3
  341. package/src/util/isValidIdentifierName.spec.ts +33 -33
  342. package/src/util/isValidIdentifierName.ts +5 -5
  343. package/src/util/onIdleCallback.ts +10 -10
  344. package/src/util/parseStyle.ts +29 -29
  345. package/src/util/quote.ts +6 -6
  346. package/src/util/reverseSlice.ts +9 -9
  347. package/src/util/routeAppend.spec.ts +19 -19
  348. package/src/util/routeAppend.ts +15 -15
  349. package/src/util/scrollElementIntoView.ts +40 -40
  350. package/src/util/scss/add-rules.scss +40 -40
  351. package/src/util/scss/calc.scss +44 -44
  352. package/src/util/scss/call-once.scss +12 -12
  353. package/src/util/scss/clockwise.scss +49 -49
  354. package/src/util/scss/colors.scss +9 -9
  355. package/src/util/scss/deep-get.scss +11 -11
  356. package/src/util/scss/deep-merge.scss +21 -21
  357. package/src/util/scss/divide.scss +3 -3
  358. package/src/util/scss/include.scss +48 -48
  359. package/src/util/scss/index.scss +9 -9
  360. package/src/util/shallowEquals.ts +43 -43
  361. package/src/util/test/createTestRenderer.tsx +19 -19
  362. package/src/util/throttle.ts +21 -21
  363. package/src/util/validatedDebounce.ts +23 -23
  364. package/src/variables.scss +217 -217
  365. package/src/widgets/AccessorBindings.spec.tsx +90 -90
  366. package/src/widgets/Button.scss +119 -119
  367. package/src/widgets/Button.tsx +189 -189
  368. package/src/widgets/Button.variables.scss +117 -117
  369. package/src/widgets/CxCredit.scss +39 -39
  370. package/src/widgets/CxCredit.tsx +46 -46
  371. package/src/widgets/DocumentTitle.ts +95 -95
  372. package/src/widgets/FlexBox.scss +148 -148
  373. package/src/widgets/FlexBox.tsx +168 -168
  374. package/src/widgets/Heading.scss +40 -40
  375. package/src/widgets/Heading.ts +42 -42
  376. package/src/widgets/HighlightedSearchText.scss +20 -20
  377. package/src/widgets/HighlightedSearchText.tsx +54 -54
  378. package/src/widgets/HtmlElement.spec.helpers.tsx +108 -108
  379. package/src/widgets/HtmlElement.spec.tsx +89 -89
  380. package/src/widgets/HtmlElement.tsx +407 -407
  381. package/src/widgets/Icon.scss +22 -22
  382. package/src/widgets/Icon.ts +64 -64
  383. package/src/widgets/List.scss +93 -93
  384. package/src/widgets/List.tsx +793 -793
  385. package/src/widgets/ProgressBar.scss +50 -50
  386. package/src/widgets/ProgressBar.tsx +66 -66
  387. package/src/widgets/ReactElementWrapper.spec.tsx +452 -452
  388. package/src/widgets/ReactElementWrapper.tsx +108 -108
  389. package/src/widgets/Resizer.scss +43 -43
  390. package/src/widgets/Resizer.tsx +200 -200
  391. package/src/widgets/Sandbox.ts +103 -103
  392. package/src/widgets/Section.scss +55 -55
  393. package/src/widgets/Section.tsx +187 -187
  394. package/src/widgets/animations.scss +10 -10
  395. package/src/widgets/autoFocus.ts +9 -9
  396. package/src/widgets/cx.ts +63 -63
  397. package/src/widgets/drag-drop/DragClone.scss +35 -35
  398. package/src/widgets/drag-drop/DragHandle.scss +18 -18
  399. package/src/widgets/drag-drop/DragHandle.tsx +47 -47
  400. package/src/widgets/drag-drop/DragSource.scss +26 -26
  401. package/src/widgets/drag-drop/DragSource.tsx +237 -237
  402. package/src/widgets/drag-drop/DropZone.scss +76 -76
  403. package/src/widgets/drag-drop/DropZone.tsx +353 -353
  404. package/src/widgets/drag-drop/index.scss +3 -3
  405. package/src/widgets/drag-drop/index.ts +4 -4
  406. package/src/widgets/drag-drop/ops.tsx +422 -422
  407. package/src/widgets/drag-drop/variables.scss +14 -14
  408. package/src/widgets/enableAllInternalDependencies.ts +11 -11
  409. package/src/widgets/form/Calendar.scss +199 -199
  410. package/src/widgets/form/Calendar.tsx +760 -760
  411. package/src/widgets/form/Calendar.variables.scss +63 -63
  412. package/src/widgets/form/Checkbox.scss +129 -129
  413. package/src/widgets/form/Checkbox.tsx +287 -287
  414. package/src/widgets/form/Checkbox.variables.scss +39 -39
  415. package/src/widgets/form/ColorField.scss +98 -98
  416. package/src/widgets/form/ColorField.tsx +497 -497
  417. package/src/widgets/form/ColorPicker.scss +285 -285
  418. package/src/widgets/form/ColorPicker.tsx +544 -544
  419. package/src/widgets/form/ColorPicker.variables.scss +22 -22
  420. package/src/widgets/form/DateField.ts +21 -21
  421. package/src/widgets/form/DateTimeField.scss +92 -92
  422. package/src/widgets/form/DateTimeField.tsx +726 -726
  423. package/src/widgets/form/DateTimePicker.scss +46 -46
  424. package/src/widgets/form/DateTimePicker.tsx +429 -429
  425. package/src/widgets/form/Field.scss +164 -164
  426. package/src/widgets/form/Field.tsx +608 -608
  427. package/src/widgets/form/FieldGroup.ts +10 -10
  428. package/src/widgets/form/FieldIcon.ts +61 -61
  429. package/src/widgets/form/HelpText.scss +24 -24
  430. package/src/widgets/form/HelpText.ts +15 -15
  431. package/src/widgets/form/Label.scss +37 -37
  432. package/src/widgets/form/Label.tsx +117 -117
  433. package/src/widgets/form/LabeledContainer.ts +77 -77
  434. package/src/widgets/form/LookupField.scss +221 -221
  435. package/src/widgets/form/LookupField.spec.tsx +93 -93
  436. package/src/widgets/form/LookupField.tsx +1421 -1421
  437. package/src/widgets/form/MonthField.scss +100 -100
  438. package/src/widgets/form/MonthField.tsx +670 -670
  439. package/src/widgets/form/MonthPicker.scss +125 -125
  440. package/src/widgets/form/MonthPicker.tsx +822 -822
  441. package/src/widgets/form/NumberField.scss +63 -63
  442. package/src/widgets/form/NumberField.tsx +543 -543
  443. package/src/widgets/form/Radio.scss +123 -123
  444. package/src/widgets/form/Radio.tsx +249 -249
  445. package/src/widgets/form/Radio.variables.scss +45 -45
  446. package/src/widgets/form/Select.scss +101 -101
  447. package/src/widgets/form/Select.tsx +327 -327
  448. package/src/widgets/form/Slider.scss +121 -121
  449. package/src/widgets/form/Slider.tsx +473 -473
  450. package/src/widgets/form/Switch.scss +142 -142
  451. package/src/widgets/form/Switch.tsx +176 -176
  452. package/src/widgets/form/TextArea.scss +45 -45
  453. package/src/widgets/form/TextArea.tsx +229 -229
  454. package/src/widgets/form/TextField.scss +57 -57
  455. package/src/widgets/form/TextField.tsx +407 -407
  456. package/src/widgets/form/TimeField.ts +10 -10
  457. package/src/widgets/form/TimeList.tsx +105 -105
  458. package/src/widgets/form/UploadButton.scss +49 -49
  459. package/src/widgets/form/UploadButton.tsx +307 -307
  460. package/src/widgets/form/ValidationError.scss +22 -22
  461. package/src/widgets/form/ValidationError.tsx +72 -72
  462. package/src/widgets/form/ValidationGroup.spec.tsx +147 -147
  463. package/src/widgets/form/ValidationGroup.ts +141 -141
  464. package/src/widgets/form/Validator.ts +60 -60
  465. package/src/widgets/form/Wheel.scss +152 -152
  466. package/src/widgets/form/Wheel.tsx +314 -314
  467. package/src/widgets/form/index.scss +24 -24
  468. package/src/widgets/form/index.ts +28 -28
  469. package/src/widgets/form/variables.scss +355 -355
  470. package/src/widgets/grid/Grid.scss +640 -640
  471. package/src/widgets/grid/Grid.tsx +4243 -4243
  472. package/src/widgets/grid/GridCell.ts +143 -143
  473. package/src/widgets/grid/GridCellEditor.tsx +58 -58
  474. package/src/widgets/grid/GridRow.ts +302 -302
  475. package/src/widgets/grid/GridRowLine.ts +49 -49
  476. package/src/widgets/grid/Pagination.scss +115 -115
  477. package/src/widgets/grid/Pagination.tsx +126 -126
  478. package/src/widgets/grid/TreeNode.scss +90 -90
  479. package/src/widgets/grid/TreeNode.tsx +154 -154
  480. package/src/widgets/grid/createGridCellEditor.tsx +18 -18
  481. package/src/widgets/grid/index.scss +3 -3
  482. package/src/widgets/grid/index.ts +16 -16
  483. package/src/widgets/grid/variables.scss +137 -137
  484. package/src/widgets/icons/arrow-down.svg +3 -3
  485. package/src/widgets/icons/arrow-right.svg +2 -2
  486. package/src/widgets/icons/base.svg +104 -104
  487. package/src/widgets/icons/calendar-old.svg +169 -169
  488. package/src/widgets/icons/calendar.svg +187 -187
  489. package/src/widgets/icons/calendar.tsx +22 -22
  490. package/src/widgets/icons/check.tsx +14 -14
  491. package/src/widgets/icons/clear.svg +74 -74
  492. package/src/widgets/icons/clear.tsx +16 -16
  493. package/src/widgets/icons/close.svg +74 -74
  494. package/src/widgets/icons/close.tsx +20 -20
  495. package/src/widgets/icons/cx.tsx +39 -39
  496. package/src/widgets/icons/drop-down.tsx +16 -16
  497. package/src/widgets/icons/dropdown-arrow.svg +61 -61
  498. package/src/widgets/icons/file.svg +4 -4
  499. package/src/widgets/icons/file.tsx +14 -14
  500. package/src/widgets/icons/folder-open.svg +5 -5
  501. package/src/widgets/icons/folder-open.tsx +16 -16
  502. package/src/widgets/icons/folder.svg +58 -58
  503. package/src/widgets/icons/folder.tsx +14 -14
  504. package/src/widgets/icons/forward.svg +67 -67
  505. package/src/widgets/icons/forward.tsx +23 -23
  506. package/src/widgets/icons/index.ts +14 -14
  507. package/src/widgets/icons/loading.svg +4 -4
  508. package/src/widgets/icons/loading.tsx +25 -25
  509. package/src/widgets/icons/menu.tsx +18 -18
  510. package/src/widgets/icons/pixel-picker.tsx +18 -18
  511. package/src/widgets/icons/registry.ts +56 -56
  512. package/src/widgets/icons/search.svg +107 -107
  513. package/src/widgets/icons/search.tsx +14 -14
  514. package/src/widgets/icons/sort-asc.svg +3 -3
  515. package/src/widgets/icons/sort-asc.tsx +15 -15
  516. package/src/widgets/icons/square.tsx +19 -19
  517. package/src/widgets/index.d.ts +55 -55
  518. package/src/widgets/index.scss +16 -16
  519. package/src/widgets/index.ts +58 -58
  520. package/src/widgets/nav/Link.scss +20 -20
  521. package/src/widgets/nav/Link.ts +11 -11
  522. package/src/widgets/nav/LinkButton.ts +176 -176
  523. package/src/widgets/nav/Menu.scss +76 -76
  524. package/src/widgets/nav/Menu.tsx +489 -489
  525. package/src/widgets/nav/Menu.variables.scss +25 -25
  526. package/src/widgets/nav/MenuItem.scss +130 -130
  527. package/src/widgets/nav/MenuItem.tsx +525 -525
  528. package/src/widgets/nav/MenuSpacer.ts +18 -18
  529. package/src/widgets/nav/RedirectRoute.ts +49 -49
  530. package/src/widgets/nav/Route.spec.tsx +24 -24
  531. package/src/widgets/nav/Route.ts +142 -142
  532. package/src/widgets/nav/Scroller.scss +148 -148
  533. package/src/widgets/nav/Scroller.tsx +252 -252
  534. package/src/widgets/nav/Submenu.ts +6 -6
  535. package/src/widgets/nav/Tab.scss +82 -82
  536. package/src/widgets/nav/Tab.ts +120 -120
  537. package/src/widgets/nav/Tab.variables.scss +84 -84
  538. package/src/widgets/nav/cover.scss +22 -22
  539. package/src/widgets/nav/index.scss +5 -5
  540. package/src/widgets/nav/index.ts +10 -10
  541. package/src/widgets/nav/variables.scss +27 -27
  542. package/src/widgets/overlay/ContextMenu.ts +42 -42
  543. package/src/widgets/overlay/Dropdown.scss +186 -186
  544. package/src/widgets/overlay/Dropdown.tsx +762 -762
  545. package/src/widgets/overlay/FlyweightTooltipTracker.ts +57 -57
  546. package/src/widgets/overlay/MsgBox.tsx +141 -141
  547. package/src/widgets/overlay/Overlay.scss +68 -68
  548. package/src/widgets/overlay/Overlay.tsx +947 -947
  549. package/src/widgets/overlay/Toast.scss +163 -163
  550. package/src/widgets/overlay/Toast.ts +111 -111
  551. package/src/widgets/overlay/Tooltip.scss +177 -177
  552. package/src/widgets/overlay/Tooltip.tsx +393 -393
  553. package/src/widgets/overlay/Window.scss +129 -129
  554. package/src/widgets/overlay/Window.tsx +299 -299
  555. package/src/widgets/overlay/Window.variables.scss +62 -62
  556. package/src/widgets/overlay/alerts.ts +46 -46
  557. package/src/widgets/overlay/captureMouse.scss +13 -13
  558. package/src/widgets/overlay/captureMouse.ts +195 -195
  559. package/src/widgets/overlay/createHotPromiseWindowFactory.ts +71 -71
  560. package/src/widgets/overlay/index.d.ts +11 -11
  561. package/src/widgets/overlay/index.scss +15 -15
  562. package/src/widgets/overlay/index.ts +11 -11
  563. package/src/widgets/overlay/tooltip-ops.ts +173 -173
  564. package/src/widgets/overlay/variables.scss +85 -85
  565. package/src/widgets/variables.scss +146 -146
  566. package/tsconfig.compile.json +4 -4
  567. package/tsconfig.json +34 -34
  568. 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
+ }