cx 26.1.1 → 26.1.3

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