cx 26.3.9 → 26.4.0

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 (591) 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/widgets/form/Test.d.ts +4 -0
  6. package/build/widgets/form/Test.d.ts.map +1 -0
  7. package/build/widgets/form/Test.js +5 -0
  8. package/build/widgets/nav/Menu.d.ts +1 -0
  9. package/build/widgets/nav/Menu.d.ts.map +1 -1
  10. package/build/widgets/nav/Menu.js +3 -0
  11. package/build/widgets/nav/MenuItem.js +1 -1
  12. package/build.js +133 -133
  13. package/dist/charts.css +10 -0
  14. package/dist/manifest.js +904 -904
  15. package/dist/widgets.css +19 -11
  16. package/dist/widgets.js +4 -1
  17. package/package.json +100 -100
  18. package/src/charts/Bar.scss +32 -32
  19. package/src/charts/Bar.ts +114 -114
  20. package/src/charts/BarGraph.tsx +145 -145
  21. package/src/charts/BubbleGraph.scss +35 -35
  22. package/src/charts/BubbleGraph.tsx +165 -165
  23. package/src/charts/Chart.ts +110 -110
  24. package/src/charts/ColorMap.ts +150 -150
  25. package/src/charts/Column.scss +32 -32
  26. package/src/charts/Column.ts +124 -124
  27. package/src/charts/ColumnBarBase.tsx +309 -309
  28. package/src/charts/ColumnBarGraphBase.tsx +229 -229
  29. package/src/charts/ColumnGraph.scss +32 -32
  30. package/src/charts/ColumnGraph.tsx +153 -153
  31. package/src/charts/Grid.ts +5 -5
  32. package/src/charts/Gridlines.scss +27 -27
  33. package/src/charts/Gridlines.tsx +88 -88
  34. package/src/charts/Legend.tsx +314 -314
  35. package/src/charts/LegendEntry.tsx +197 -197
  36. package/src/charts/LineGraph.tsx +455 -455
  37. package/src/charts/Marker.scss +46 -46
  38. package/src/charts/Marker.tsx +538 -538
  39. package/src/charts/MarkerLine.scss +23 -23
  40. package/src/charts/MarkerLine.tsx +233 -233
  41. package/src/charts/MouseTracker.tsx +115 -115
  42. package/src/charts/Pie.ts +8 -8
  43. package/src/charts/PieChart.scss +32 -32
  44. package/src/charts/PieChart.tsx +843 -843
  45. package/src/charts/PieLabel.tsx +124 -124
  46. package/src/charts/PieLabelsContainer.ts +68 -68
  47. package/src/charts/Range.scss +23 -23
  48. package/src/charts/Range.tsx +318 -318
  49. package/src/charts/RangeMarker.scss +17 -17
  50. package/src/charts/RangeMarker.tsx +250 -250
  51. package/src/charts/ScatterGraph.scss +27 -27
  52. package/src/charts/ScatterGraph.tsx +245 -245
  53. package/src/charts/Swimlane.scss +19 -16
  54. package/src/charts/Swimlane.tsx +195 -195
  55. package/src/charts/Swimlanes.scss +19 -16
  56. package/src/charts/Swimlanes.tsx +179 -179
  57. package/src/charts/axis/Axis.scss +24 -24
  58. package/src/charts/axis/Axis.tsx +444 -444
  59. package/src/charts/axis/CategoryAxis.scss +37 -37
  60. package/src/charts/axis/CategoryAxis.tsx +313 -313
  61. package/src/charts/axis/NumericAxis.scss +38 -38
  62. package/src/charts/axis/NumericAxis.tsx +437 -437
  63. package/src/charts/axis/Stack.ts +61 -61
  64. package/src/charts/axis/TimeAxis.scss +37 -37
  65. package/src/charts/axis/TimeAxis.tsx +834 -834
  66. package/src/charts/axis/index.scss +4 -4
  67. package/src/charts/axis/index.ts +3 -3
  68. package/src/charts/axis/variables.scss +5 -5
  69. package/src/charts/helpers/MinMaxFinder.ts +66 -66
  70. package/src/charts/helpers/PointReducer.ts +135 -135
  71. package/src/charts/helpers/index.ts +4 -4
  72. package/src/charts/index.scss +21 -19
  73. package/src/charts/index.ts +34 -34
  74. package/src/charts/palette.scss +77 -77
  75. package/src/charts/palette.variables.scss +23 -23
  76. package/src/charts/shapes.tsx +86 -86
  77. package/src/charts/variables.scss +53 -53
  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 +107 -107
  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 +346 -346
  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 +157 -157
  116. package/src/data/createStructuredSelector.spec.ts +45 -45
  117. package/src/data/createStructuredSelector.ts +62 -62
  118. package/src/data/defaultCompare.ts +14 -14
  119. package/src/data/diff/diffArrays.ts +49 -49
  120. package/src/data/diff/diffs.spec.ts +49 -49
  121. package/src/data/diff/index.ts +1 -1
  122. package/src/data/enableFatArrowExpansion.ts +6 -6
  123. package/src/data/getAccessor.spec.ts +11 -11
  124. package/src/data/getAccessor.ts +74 -74
  125. package/src/data/getSelector.spec.ts +43 -43
  126. package/src/data/getSelector.ts +66 -66
  127. package/src/data/index.ts +30 -30
  128. package/src/data/isSelector.ts +26 -26
  129. package/src/data/ops/append.spec.ts +28 -28
  130. package/src/data/ops/append.ts +5 -5
  131. package/src/data/ops/filter.spec.ts +35 -35
  132. package/src/data/ops/filter.ts +9 -9
  133. package/src/data/ops/findTreeNode.spec.ts +23 -23
  134. package/src/data/ops/findTreeNode.ts +33 -33
  135. package/src/data/ops/findTreePath.ts +28 -28
  136. package/src/data/ops/index.ts +11 -11
  137. package/src/data/ops/insertElement.ts +3 -3
  138. package/src/data/ops/merge.spec.ts +27 -27
  139. package/src/data/ops/merge.ts +13 -13
  140. package/src/data/ops/moveElement.ts +21 -21
  141. package/src/data/ops/removeTreeNodes.spec.ts +37 -37
  142. package/src/data/ops/removeTreeNodes.ts +28 -28
  143. package/src/data/ops/updateArray.spec.ts +69 -69
  144. package/src/data/ops/updateArray.ts +31 -31
  145. package/src/data/ops/updateTree.spec.ts +54 -54
  146. package/src/data/ops/updateTree.ts +49 -49
  147. package/src/data/test-types.ts +7 -7
  148. package/src/hooks/createLocalStorageRef.ts +21 -21
  149. package/src/hooks/index.ts +8 -8
  150. package/src/hooks/invokeCallback.spec.tsx +59 -59
  151. package/src/hooks/invokeCallback.ts +8 -8
  152. package/src/hooks/resolveCallback.spec.tsx +71 -71
  153. package/src/hooks/resolveCallback.ts +16 -16
  154. package/src/hooks/store.spec.tsx +67 -67
  155. package/src/hooks/store.ts +46 -46
  156. package/src/hooks/useEffect.ts +14 -14
  157. package/src/hooks/useInterval.ts +8 -8
  158. package/src/hooks/useState.ts +20 -20
  159. package/src/hooks/useTrigger.spec.tsx +105 -105
  160. package/src/hooks/useTrigger.ts +26 -26
  161. package/src/index.scss +5 -5
  162. package/src/index.ts +7 -7
  163. package/src/jsx-dev-runtime.ts +4 -4
  164. package/src/jsx-runtime.spec.tsx +508 -508
  165. package/src/jsx-runtime.ts +88 -88
  166. package/src/locale/de-de.ts +76 -76
  167. package/src/locale/en-us.ts +75 -75
  168. package/src/locale/es-es.ts +76 -76
  169. package/src/locale/fr-fr.ts +76 -76
  170. package/src/locale/nl-nl.ts +76 -76
  171. package/src/locale/pt-pt.ts +76 -76
  172. package/src/locale/sr-latn-ba.ts +76 -76
  173. package/src/maps.scss +5 -5
  174. package/src/svg/BoundedObject.ts +101 -101
  175. package/src/svg/ClipRect.tsx +29 -29
  176. package/src/svg/Ellipse.tsx +76 -76
  177. package/src/svg/Line.tsx +73 -73
  178. package/src/svg/NonOverlappingRect.ts +26 -26
  179. package/src/svg/NonOverlappingRectGroup.ts +49 -49
  180. package/src/svg/Rectangle.tsx +98 -98
  181. package/src/svg/Svg.scss +28 -28
  182. package/src/svg/Svg.tsx +241 -241
  183. package/src/svg/Text.scss +19 -19
  184. package/src/svg/Text.tsx +190 -190
  185. package/src/svg/TextualBoundedObject.ts +35 -35
  186. package/src/svg/index.scss +10 -10
  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.spec.ts +87 -87
  192. package/src/ui/Container.tsx +220 -220
  193. package/src/ui/ContentResolver.spec.tsx +585 -585
  194. package/src/ui/ContentResolver.ts +132 -132
  195. package/src/ui/Controller.spec.tsx +604 -604
  196. package/src/ui/Controller.ts +207 -207
  197. package/src/ui/Culture.ts +159 -159
  198. package/src/ui/Cx.spec.tsx +210 -210
  199. package/src/ui/Cx.tsx +386 -386
  200. package/src/ui/DataProxy.spec.tsx +337 -337
  201. package/src/ui/DataProxy.ts +55 -55
  202. package/src/ui/DetachedScope.tsx +159 -159
  203. package/src/ui/FocusManager.ts +171 -171
  204. package/src/ui/Format.ts +108 -108
  205. package/src/ui/HoverSync.tsx +221 -221
  206. package/src/ui/Instance.ts +963 -963
  207. package/src/ui/IsolatedScope.spec.tsx +62 -62
  208. package/src/ui/IsolatedScope.ts +52 -52
  209. package/src/ui/Localization.ts +70 -70
  210. package/src/ui/Prop.ts +141 -141
  211. package/src/ui/PureContainer.spec.tsx +232 -232
  212. package/src/ui/PureContainer.tsx +19 -19
  213. package/src/ui/RenderingContext.ts +99 -99
  214. package/src/ui/Repeater.spec.tsx +181 -143
  215. package/src/ui/Repeater.ts +194 -194
  216. package/src/ui/Rescope.spec.tsx +199 -199
  217. package/src/ui/Rescope.ts +50 -50
  218. package/src/ui/ResizeManager.ts +30 -30
  219. package/src/ui/Restate.spec.tsx +422 -422
  220. package/src/ui/Restate.tsx +217 -217
  221. package/src/ui/StaticText.ts +11 -11
  222. package/src/ui/StructuredInstanceDataAccessor.ts +32 -32
  223. package/src/ui/Text.ts +52 -52
  224. package/src/ui/VDOM.ts +1 -1
  225. package/src/ui/Widget.spec.tsx +53 -53
  226. package/src/ui/Widget.tsx +359 -359
  227. package/src/ui/ZIndexManager.ts +11 -11
  228. package/src/ui/adapter/ArrayAdapter.spec.ts +55 -55
  229. package/src/ui/adapter/ArrayAdapter.ts +229 -229
  230. package/src/ui/adapter/DataAdapter.ts +52 -52
  231. package/src/ui/adapter/GroupAdapter.spec.ts +42 -42
  232. package/src/ui/adapter/GroupAdapter.ts +244 -244
  233. package/src/ui/adapter/TreeAdapter.spec.ts +76 -76
  234. package/src/ui/adapter/TreeAdapter.ts +245 -245
  235. package/src/ui/adapter/index.ts +4 -4
  236. package/src/ui/app/History.ts +147 -147
  237. package/src/ui/app/Url.spec.ts +50 -50
  238. package/src/ui/app/Url.ts +102 -102
  239. package/src/ui/app/index.ts +5 -5
  240. package/src/ui/app/startAppLoop.tsx +82 -82
  241. package/src/ui/app/startHotAppLoop.ts +41 -41
  242. package/src/ui/batchUpdates.ts +72 -72
  243. package/src/ui/bind.ts +10 -10
  244. package/src/ui/createFunctionalComponent.spec.tsx +605 -605
  245. package/src/ui/createFunctionalComponent.ts +96 -96
  246. package/src/ui/expr.ts +47 -47
  247. package/src/ui/exprHelpers.spec.ts +412 -412
  248. package/src/ui/exprHelpers.ts +96 -96
  249. package/src/ui/flattenProps.ts +21 -21
  250. package/src/ui/index.scss +2 -2
  251. package/src/ui/index.ts +51 -51
  252. package/src/ui/keyboardShortcuts.ts +50 -50
  253. package/src/ui/layout/Content.ts +30 -30
  254. package/src/ui/layout/ContentPlaceholder.spec.tsx +599 -599
  255. package/src/ui/layout/ContentPlaceholder.ts +133 -133
  256. package/src/ui/layout/FirstVisibleChildLayout.spec.tsx +207 -207
  257. package/src/ui/layout/FirstVisibleChildLayout.ts +60 -60
  258. package/src/ui/layout/LabelsLeftLayout.scss +45 -45
  259. package/src/ui/layout/LabelsLeftLayout.tsx +76 -76
  260. package/src/ui/layout/LabelsTopLayout.scss +73 -63
  261. package/src/ui/layout/LabelsTopLayout.tsx +156 -156
  262. package/src/ui/layout/UseParentLayout.ts +8 -8
  263. package/src/ui/layout/exploreChildren.ts +38 -38
  264. package/src/ui/layout/index.scss +2 -2
  265. package/src/ui/layout/index.ts +10 -10
  266. package/src/ui/layout/variables.scss +2 -2
  267. package/src/ui/selection/KeySelection.ts +153 -153
  268. package/src/ui/selection/PropertySelection.ts +87 -87
  269. package/src/ui/selection/Selection.ts +128 -128
  270. package/src/ui/selection/index.ts +3 -3
  271. package/src/ui/tpl.spec.ts +69 -69
  272. package/src/ui/tpl.ts +17 -17
  273. package/src/ui/variables.scss +1 -1
  274. package/src/util/Component.spec.ts +494 -494
  275. package/src/util/Component.ts +352 -352
  276. package/src/util/Console.ts +13 -13
  277. package/src/util/DOM.ts +88 -88
  278. package/src/util/Debug.ts +71 -71
  279. package/src/util/Format.spec.ts +69 -69
  280. package/src/util/Format.ts +267 -267
  281. package/src/util/GlobalCacheIdentifier.ts +11 -11
  282. package/src/util/KeyCode.ts +21 -21
  283. package/src/util/SubscriberList.ts +86 -86
  284. package/src/util/Timing.ts +58 -58
  285. package/src/util/TraversalStack.spec.ts +53 -53
  286. package/src/util/TraversalStack.ts +47 -47
  287. package/src/util/addEventListenerWithOptions.ts +41 -41
  288. package/src/util/browserSupportsPassiveEventHandlers.ts +20 -20
  289. package/src/util/calculateNaturalElementHeight.ts +22 -22
  290. package/src/util/call-once.scss +6 -6
  291. package/src/util/capitalize.ts +4 -4
  292. package/src/util/coalesce.ts +6 -6
  293. package/src/util/color/hslToRgb.ts +34 -34
  294. package/src/util/color/index.ts +4 -4
  295. package/src/util/color/parseColor.ts +173 -173
  296. package/src/util/color/rgbToHex.ts +14 -14
  297. package/src/util/color/rgbToHsl.ts +35 -35
  298. package/src/util/date/dateDiff.ts +9 -9
  299. package/src/util/date/diff.ts +13 -13
  300. package/src/util/date/encodeDate.ts +8 -8
  301. package/src/util/date/encodeDateWithTimezoneOffset.ts +18 -18
  302. package/src/util/date/index.ts +11 -11
  303. package/src/util/date/lowerBoundCheck.ts +13 -13
  304. package/src/util/date/maxDate.ts +14 -14
  305. package/src/util/date/minDate.ts +14 -14
  306. package/src/util/date/monthStart.ts +8 -8
  307. package/src/util/date/parseDateInvariant.ts +20 -20
  308. package/src/util/date/sameDate.ts +11 -11
  309. package/src/util/date/upperBoundCheck.spec.ts +30 -30
  310. package/src/util/date/upperBoundCheck.ts +13 -13
  311. package/src/util/date/zeroTime.ts +9 -9
  312. package/src/util/debounce.ts +26 -26
  313. package/src/util/dummyCallback.ts +1 -1
  314. package/src/util/escapeSpecialRegexCharacters.ts +8 -8
  315. package/src/util/eventCallbacks.ts +12 -12
  316. package/src/util/expandFatArrows.ts +118 -118
  317. package/src/util/findScrollableParent.ts +15 -15
  318. package/src/util/getActiveElement.ts +4 -4
  319. package/src/util/getParentFrameBoundingClientRect.ts +13 -13
  320. package/src/util/getScrollerBoundingClientRect.ts +12 -12
  321. package/src/util/getSearchQueryPredicate.spec.ts +40 -40
  322. package/src/util/getSearchQueryPredicate.ts +58 -58
  323. package/src/util/getTopLevelBoundingClientRect.ts +7 -7
  324. package/src/util/getVendorPrefix.ts +38 -38
  325. package/src/util/hasKey.ts +18 -18
  326. package/src/util/index.scss +13 -13
  327. package/src/util/index.ts +55 -55
  328. package/src/util/innerTextTrim.ts +10 -10
  329. package/src/util/isArray.ts +3 -3
  330. package/src/util/isDataRecord.ts +5 -5
  331. package/src/util/isDefined.ts +3 -3
  332. package/src/util/isDigit.ts +8 -8
  333. package/src/util/isFunction.ts +3 -3
  334. package/src/util/isNonEmptyArray.ts +3 -3
  335. package/src/util/isNumber.ts +3 -3
  336. package/src/util/isObject.ts +3 -3
  337. package/src/util/isPromise.ts +6 -6
  338. package/src/util/isString.ts +3 -3
  339. package/src/util/isTextInputElement.ts +2 -2
  340. package/src/util/isTouchDevice.ts +7 -7
  341. package/src/util/isTouchEvent.ts +64 -64
  342. package/src/util/isUndefined.ts +3 -3
  343. package/src/util/isValidIdentifierName.spec.ts +33 -33
  344. package/src/util/isValidIdentifierName.ts +5 -5
  345. package/src/util/maps.scss +1 -1
  346. package/src/util/onIdleCallback.ts +10 -10
  347. package/src/util/parseStyle.ts +29 -29
  348. package/src/util/quote.ts +6 -6
  349. package/src/util/reverseSlice.ts +9 -9
  350. package/src/util/routeAppend.spec.ts +19 -19
  351. package/src/util/routeAppend.ts +15 -15
  352. package/src/util/scrollElementIntoView.ts +40 -40
  353. package/src/util/scss/add-rules.scss +40 -40
  354. package/src/util/scss/besm.scss +15 -15
  355. package/src/util/scss/calc.scss +137 -137
  356. package/src/util/scss/call-once.scss +12 -12
  357. package/src/util/scss/clockwise.scss +49 -49
  358. package/src/util/scss/colors.scss +9 -9
  359. package/src/util/scss/deep-get.scss +11 -11
  360. package/src/util/scss/deep-merge.scss +21 -21
  361. package/src/util/scss/defaults.scss +24 -24
  362. package/src/util/scss/divide.scss +3 -3
  363. package/src/util/scss/elements.scss +78 -78
  364. package/src/util/scss/global.scss +15 -15
  365. package/src/util/scss/index.scss +1 -1
  366. package/src/util/scss/maps.scss +2 -2
  367. package/src/util/scss/pad-size.scss +9 -9
  368. package/src/util/scss/padding.scss +6 -6
  369. package/src/util/scss/screen-size.scss +5 -5
  370. package/src/util/scss/variables.scss +6 -6
  371. package/src/util/shallowEquals.ts +43 -43
  372. package/src/util/test/createTestRenderer.tsx +19 -19
  373. package/src/util/throttle.ts +21 -21
  374. package/src/util/validatedDebounce.ts +23 -23
  375. package/src/util/variables.scss +1 -1
  376. package/src/variables.scss +5 -5
  377. package/src/widgets/AccessorBindings.spec.tsx +90 -90
  378. package/src/widgets/Button.scss +143 -143
  379. package/src/widgets/Button.tsx +181 -181
  380. package/src/widgets/Button.variables.scss +21 -21
  381. package/src/widgets/CxCredit.scss +41 -41
  382. package/src/widgets/CxCredit.tsx +46 -46
  383. package/src/widgets/DocumentTitle.ts +95 -95
  384. package/src/widgets/FlexBox.scss +153 -153
  385. package/src/widgets/FlexBox.tsx +168 -168
  386. package/src/widgets/Heading.scss +46 -46
  387. package/src/widgets/Heading.ts +42 -42
  388. package/src/widgets/HighlightedSearchText.scss +27 -27
  389. package/src/widgets/HighlightedSearchText.tsx +54 -54
  390. package/src/widgets/HtmlElement.spec.helpers.tsx +108 -108
  391. package/src/widgets/HtmlElement.spec.tsx +117 -117
  392. package/src/widgets/HtmlElement.tsx +468 -468
  393. package/src/widgets/Icon.scss +28 -28
  394. package/src/widgets/Icon.ts +64 -64
  395. package/src/widgets/List.scss +100 -100
  396. package/src/widgets/List.tsx +792 -792
  397. package/src/widgets/ProgressBar.scss +64 -64
  398. package/src/widgets/ProgressBar.tsx +66 -66
  399. package/src/widgets/ReactElementWrapper.spec.tsx +452 -452
  400. package/src/widgets/ReactElementWrapper.tsx +108 -108
  401. package/src/widgets/Resizer.scss +46 -46
  402. package/src/widgets/Resizer.tsx +200 -200
  403. package/src/widgets/Sandbox.ts +104 -104
  404. package/src/widgets/Section.scss +53 -53
  405. package/src/widgets/Section.tsx +187 -187
  406. package/src/widgets/animations.scss +13 -13
  407. package/src/widgets/autoFocus.ts +9 -9
  408. package/src/widgets/box.scss +47 -47
  409. package/src/widgets/cx.ts +63 -63
  410. package/src/widgets/drag-drop/DragClone.scss +44 -44
  411. package/src/widgets/drag-drop/DragHandle.scss +25 -25
  412. package/src/widgets/drag-drop/DragHandle.tsx +47 -47
  413. package/src/widgets/drag-drop/DragSource.scss +33 -33
  414. package/src/widgets/drag-drop/DragSource.tsx +237 -237
  415. package/src/widgets/drag-drop/DropZone.scss +83 -83
  416. package/src/widgets/drag-drop/DropZone.tsx +353 -353
  417. package/src/widgets/drag-drop/index.scss +4 -4
  418. package/src/widgets/drag-drop/index.ts +4 -4
  419. package/src/widgets/drag-drop/maps.scss +7 -7
  420. package/src/widgets/drag-drop/ops.tsx +422 -422
  421. package/src/widgets/drag-drop/variables.scss +17 -17
  422. package/src/widgets/enableAllInternalDependencies.ts +11 -11
  423. package/src/widgets/form/Calendar.maps.scss +54 -54
  424. package/src/widgets/form/Calendar.scss +237 -237
  425. package/src/widgets/form/Calendar.variables.scss +21 -21
  426. package/src/widgets/form/Checkbox.maps.scss +34 -34
  427. package/src/widgets/form/Checkbox.scss +140 -140
  428. package/src/widgets/form/Checkbox.tsx +340 -340
  429. package/src/widgets/form/Checkbox.variables.scss +8 -8
  430. package/src/widgets/form/ColorField.scss +112 -112
  431. package/src/widgets/form/ColorField.tsx +551 -551
  432. package/src/widgets/form/ColorPicker.maps.scss +21 -21
  433. package/src/widgets/form/ColorPicker.scss +302 -302
  434. package/src/widgets/form/ColorPicker.tsx +606 -606
  435. package/src/widgets/form/ColorPicker.variables.scss +9 -9
  436. package/src/widgets/form/DateField.ts +21 -21
  437. package/src/widgets/form/DateTimeField.scss +111 -111
  438. package/src/widgets/form/DateTimeField.tsx +814 -814
  439. package/src/widgets/form/DateTimePicker.scss +57 -57
  440. package/src/widgets/form/DateTimePicker.tsx +429 -429
  441. package/src/widgets/form/Field.maps.scss +122 -122
  442. package/src/widgets/form/Field.scss +200 -200
  443. package/src/widgets/form/Field.tsx +715 -715
  444. package/src/widgets/form/Field.variables.scss +46 -46
  445. package/src/widgets/form/FieldGroup.ts +10 -10
  446. package/src/widgets/form/FieldIcon.ts +61 -61
  447. package/src/widgets/form/HelpText.scss +27 -27
  448. package/src/widgets/form/HelpText.ts +15 -15
  449. package/src/widgets/form/Label.scss +45 -45
  450. package/src/widgets/form/Label.tsx +117 -117
  451. package/src/widgets/form/LabeledContainer.ts +77 -77
  452. package/src/widgets/form/LookupField.maps.scss +26 -26
  453. package/src/widgets/form/LookupField.spec.tsx +93 -93
  454. package/src/widgets/form/LookupField.tsx +1689 -1689
  455. package/src/widgets/form/MonthField.scss +113 -113
  456. package/src/widgets/form/MonthField.tsx +748 -748
  457. package/src/widgets/form/MonthPicker.maps.scss +50 -50
  458. package/src/widgets/form/MonthPicker.scss +134 -134
  459. package/src/widgets/form/MonthPicker.tsx +1061 -1061
  460. package/src/widgets/form/MonthPicker.variables.scss +24 -24
  461. package/src/widgets/form/NumberField.scss +72 -72
  462. package/src/widgets/form/NumberField.tsx +653 -653
  463. package/src/widgets/form/Radio.maps.scss +36 -36
  464. package/src/widgets/form/Radio.scss +133 -133
  465. package/src/widgets/form/Radio.tsx +249 -249
  466. package/src/widgets/form/Radio.variables.scss +7 -7
  467. package/src/widgets/form/Select.scss +104 -104
  468. package/src/widgets/form/Select.tsx +327 -327
  469. package/src/widgets/form/Slider.scss +130 -130
  470. package/src/widgets/form/Slider.tsx +473 -473
  471. package/src/widgets/form/Switch.scss +152 -152
  472. package/src/widgets/form/Switch.tsx +176 -176
  473. package/src/widgets/form/TextArea.scss +58 -58
  474. package/src/widgets/form/TextArea.tsx +229 -229
  475. package/src/widgets/form/TextField.scss +66 -66
  476. package/src/widgets/form/TextField.tsx +453 -453
  477. package/src/widgets/form/TimeField.ts +10 -10
  478. package/src/widgets/form/TimeList.tsx +105 -105
  479. package/src/widgets/form/UploadButton.scss +57 -57
  480. package/src/widgets/form/UploadButton.tsx +387 -387
  481. package/src/widgets/form/ValidationError.scss +27 -27
  482. package/src/widgets/form/ValidationError.tsx +81 -81
  483. package/src/widgets/form/ValidationGroup.spec.tsx +147 -147
  484. package/src/widgets/form/ValidationGroup.ts +141 -141
  485. package/src/widgets/form/Validator.ts +60 -60
  486. package/src/widgets/form/Wheel.scss +164 -164
  487. package/src/widgets/form/Wheel.tsx +309 -309
  488. package/src/widgets/form/index.scss +22 -22
  489. package/src/widgets/form/index.ts +28 -28
  490. package/src/widgets/form/maps.scss +81 -81
  491. package/src/widgets/form/variables.scss +3 -0
  492. package/src/widgets/grid/Grid.spec.ts +42 -42
  493. package/src/widgets/grid/Grid.tsx +4269 -4269
  494. package/src/widgets/grid/GridCell.ts +143 -143
  495. package/src/widgets/grid/GridCellEditor.tsx +58 -58
  496. package/src/widgets/grid/GridRow.ts +302 -302
  497. package/src/widgets/grid/GridRowLine.ts +49 -49
  498. package/src/widgets/grid/Pagination.scss +124 -124
  499. package/src/widgets/grid/Pagination.tsx +134 -134
  500. package/src/widgets/grid/TreeNode.scss +107 -107
  501. package/src/widgets/grid/TreeNode.tsx +165 -165
  502. package/src/widgets/grid/createGridCellEditor.tsx +18 -18
  503. package/src/widgets/grid/index.scss +3 -3
  504. package/src/widgets/grid/index.ts +16 -16
  505. package/src/widgets/grid/maps.scss +110 -110
  506. package/src/widgets/icons/arrow-down.svg +3 -3
  507. package/src/widgets/icons/arrow-right.svg +2 -2
  508. package/src/widgets/icons/base.svg +104 -104
  509. package/src/widgets/icons/calendar-old.svg +169 -169
  510. package/src/widgets/icons/calendar.svg +187 -187
  511. package/src/widgets/icons/calendar.tsx +22 -22
  512. package/src/widgets/icons/check.tsx +14 -14
  513. package/src/widgets/icons/clear.svg +74 -74
  514. package/src/widgets/icons/clear.tsx +16 -16
  515. package/src/widgets/icons/close.svg +74 -74
  516. package/src/widgets/icons/close.tsx +20 -20
  517. package/src/widgets/icons/cx.tsx +39 -39
  518. package/src/widgets/icons/drop-down.tsx +16 -16
  519. package/src/widgets/icons/dropdown-arrow.svg +61 -61
  520. package/src/widgets/icons/file.svg +4 -4
  521. package/src/widgets/icons/file.tsx +14 -14
  522. package/src/widgets/icons/folder-open.svg +5 -5
  523. package/src/widgets/icons/folder-open.tsx +16 -16
  524. package/src/widgets/icons/folder.svg +58 -58
  525. package/src/widgets/icons/folder.tsx +13 -13
  526. package/src/widgets/icons/forward.svg +67 -67
  527. package/src/widgets/icons/forward.tsx +26 -26
  528. package/src/widgets/icons/index.ts +14 -14
  529. package/src/widgets/icons/loading.svg +4 -4
  530. package/src/widgets/icons/loading.tsx +28 -28
  531. package/src/widgets/icons/menu.tsx +18 -18
  532. package/src/widgets/icons/pixel-picker.tsx +18 -18
  533. package/src/widgets/icons/registry.ts +56 -56
  534. package/src/widgets/icons/search.svg +107 -107
  535. package/src/widgets/icons/search.tsx +14 -14
  536. package/src/widgets/icons/sort-asc.svg +3 -3
  537. package/src/widgets/icons/sort-asc.tsx +15 -15
  538. package/src/widgets/icons/square.tsx +22 -22
  539. package/src/widgets/index.d.ts +55 -55
  540. package/src/widgets/index.scss +16 -16
  541. package/src/widgets/lists.scss +42 -42
  542. package/src/widgets/maps.scss +139 -139
  543. package/src/widgets/nav/Link.scss +33 -33
  544. package/src/widgets/nav/Link.ts +11 -11
  545. package/src/widgets/nav/LinkButton.ts +176 -176
  546. package/src/widgets/nav/Menu.scss +82 -82
  547. package/src/widgets/nav/Menu.tsx +497 -492
  548. package/src/widgets/nav/Menu.variables.scss +13 -13
  549. package/src/widgets/nav/MenuItem.scss +150 -145
  550. package/src/widgets/nav/MenuItem.tsx +525 -525
  551. package/src/widgets/nav/MenuSpacer.ts +18 -18
  552. package/src/widgets/nav/RedirectRoute.ts +49 -49
  553. package/src/widgets/nav/Route.spec.tsx +24 -24
  554. package/src/widgets/nav/Route.ts +142 -142
  555. package/src/widgets/nav/Scroller.scss +157 -157
  556. package/src/widgets/nav/Scroller.tsx +252 -252
  557. package/src/widgets/nav/Submenu.ts +6 -6
  558. package/src/widgets/nav/Tab.maps.scss +78 -78
  559. package/src/widgets/nav/Tab.scss +88 -88
  560. package/src/widgets/nav/Tab.variables.scss +15 -15
  561. package/src/widgets/nav/cover.scss +24 -24
  562. package/src/widgets/nav/index.scss +6 -6
  563. package/src/widgets/nav/index.ts +10 -10
  564. package/src/widgets/nav/maps.scss +32 -32
  565. package/src/widgets/nav/variables.scss +19 -19
  566. package/src/widgets/overlay/ContextMenu.ts +45 -45
  567. package/src/widgets/overlay/Dropdown.scss +217 -217
  568. package/src/widgets/overlay/Dropdown.tsx +937 -937
  569. package/src/widgets/overlay/FlyweightTooltipTracker.ts +91 -91
  570. package/src/widgets/overlay/MsgBox.tsx +155 -155
  571. package/src/widgets/overlay/Overlay.scss +88 -88
  572. package/src/widgets/overlay/Toast.scss +172 -172
  573. package/src/widgets/overlay/Toast.ts +121 -121
  574. package/src/widgets/overlay/Tooltip.scss +108 -108
  575. package/src/widgets/overlay/Tooltip.tsx +460 -460
  576. package/src/widgets/overlay/Window.maps.scss +51 -51
  577. package/src/widgets/overlay/Window.scss +129 -129
  578. package/src/widgets/overlay/Window.variables.scss +21 -21
  579. package/src/widgets/overlay/alerts.ts +46 -46
  580. package/src/widgets/overlay/captureMouse.scss +13 -13
  581. package/src/widgets/overlay/captureMouse.ts +195 -195
  582. package/src/widgets/overlay/createHotPromiseWindowFactory.ts +71 -71
  583. package/src/widgets/overlay/index.d.ts +11 -11
  584. package/src/widgets/overlay/index.scss +6 -6
  585. package/src/widgets/overlay/index.ts +11 -11
  586. package/src/widgets/overlay/maps.scss +44 -44
  587. package/src/widgets/overlay/tooltip-ops.ts +173 -173
  588. package/src/widgets/overlay/variables.scss +53 -53
  589. package/tsconfig.compile.json +4 -4
  590. package/tsconfig.json +35 -35
  591. package/tsconfig.mocha.json +14 -14
@@ -1,814 +1,814 @@
1
- /** @jsxImportSource react */
2
- import { StringTemplate } from "../../data/StringTemplate";
3
- import { Culture } from "../../ui/Culture";
4
- import { Cx } from "../../ui/Cx";
5
- import type { DropdownInstance, Instance } from "../../ui/Instance";
6
- import { FieldInstance } from "./Field";
7
- import { Localization } from "../../ui/Localization";
8
- import type { RenderingContext } from "../../ui/RenderingContext";
9
- import { VDOM, Widget, getContent } from "../../ui/Widget";
10
- import { getActiveElement, parseDateInvariant } from "../../util";
11
- import { dateDiff } from "../../util/date/dateDiff";
12
- import { zeroTime } from "../../util/date/zeroTime";
13
- import { stopPropagation } from "../../util/eventCallbacks";
14
- import { Format } from "../../util/Format";
15
- import { isTouchDevice } from "../../util/isTouchDevice";
16
- import { isTouchEvent } from "../../util/isTouchEvent";
17
- import { KeyCode } from "../../util/KeyCode";
18
- import { autoFocus } from "../autoFocus";
19
- import ClearIcon from "../icons/clear";
20
- import DropdownIcon from "../icons/drop-down";
21
- import { Dropdown, DropdownConfig } from "../overlay/Dropdown";
22
- import {
23
- tooltipMouseLeave,
24
- tooltipMouseMove,
25
- tooltipParentDidMount,
26
- tooltipParentWillReceiveProps,
27
- tooltipParentWillUnmount,
28
- } from "../overlay/tooltip-ops";
29
- import { Calendar } from "./Calendar";
30
- import { DateTimePicker } from "./DateTimePicker";
31
- import { Field, FieldConfig, getFieldTooltip } from "./Field";
32
- import { TimeList } from "./TimeList";
33
- import { BooleanProp, Config, Prop, StringProp } from "../../ui/Prop";
34
-
35
- export interface DateTimeFieldConfig extends FieldConfig {
36
- /** Selected date. This should be a Date object or a valid date string consumable by Date.parse function. */
37
- value?: Prop<string | Date>;
38
-
39
- /** Defaults to false. Used to make the field read-only. */
40
- readOnly?: BooleanProp;
41
-
42
- /** The opposite of `disabled`. */
43
- enabled?: BooleanProp;
44
-
45
- /** Default text displayed when the field is empty. */
46
- placeholder?: StringProp;
47
-
48
- /** Minimum date value. This should be a Date object or a valid date string consumable by Date.parse function. */
49
- minValue?: Prop<string | Date>;
50
-
51
- /** Set to `true` to disallow the `minValue`. Default value is `false`. */
52
- minExclusive?: BooleanProp;
53
-
54
- /** Maximum date value. This should be a Date object or a valid date string consumable by Date.parse function. */
55
- maxValue?: Prop<string | Date>;
56
-
57
- /** Set to `true` to disallow the `maxValue`. Default value is `false`. */
58
- maxExclusive?: BooleanProp;
59
-
60
- /** Date format used to display the selected date. */
61
- format?: StringProp;
62
-
63
- /** Base CSS class to be applied to the field. Defaults to `datefield`. */
64
- baseClass?: string;
65
-
66
- /** Maximum value error text. */
67
- maxValueErrorText?: string;
68
-
69
- /** Maximum exclusive value error text. */
70
- maxExclusiveErrorText?: string;
71
-
72
- /** Minimum value error text. */
73
- minValueErrorText?: string;
74
-
75
- /** Minimum exclusive value error text. */
76
- minExclusiveErrorText?: string;
77
-
78
- /** Error message used to indicate wrong user input. */
79
- inputErrorText?: string;
80
-
81
- /** Name or configuration of the icon to be put on the left side of the input. */
82
- icon?: StringProp | Config;
83
-
84
- /** Set to false to hide the clear button. Default value is true. */
85
- showClear?: boolean;
86
-
87
- /** Set to `true` to display the clear button even if `required` is set. Default is `false`. */
88
- alwaysShowClear?: boolean;
89
-
90
- /** Set to true to hide the clear button. Default value is false. */
91
- hideClear?: boolean;
92
-
93
- /** Determines which segment of date/time is used. Default value is `datetime`. */
94
- segment?: "date" | "time" | "datetime";
95
-
96
- /** Set to `true` to indicate that only one segment of the selected date is affected. */
97
- partial?: boolean;
98
-
99
- /** The function that will be used to convert Date objects before writing data to the store. */
100
- encoding?: (date: Date) => any;
101
-
102
- /** Defines which days of week should be displayed as disabled. */
103
- disabledDaysOfWeek?: number[];
104
-
105
- /** Set to true to focus the input field instead of the picker first. */
106
- focusInputFirst?: boolean;
107
-
108
- /** Set to true to enable seconds segment in the picker. */
109
- showSeconds?: boolean;
110
-
111
- /** Additional configuration to be passed to the dropdown. */
112
- dropdownOptions?: Partial<DropdownConfig>;
113
-
114
- /** Type of picker to show. Can be `calendar`, `time`, `list`, or `auto`. Default is `auto`. */
115
- picker?: "calendar" | "time" | "list" | "auto";
116
-
117
- /** Time step in minutes for the time picker. */
118
- step?: number;
119
-
120
- /** Custom validation function. */
121
- onValidate?:
122
- | string
123
- | ((
124
- value: string | Date,
125
- instance: Instance,
126
- validationParams: Record<string, unknown>,
127
- ) => unknown);
128
- }
129
-
130
- export class DateTimeField extends Field<DateTimeFieldConfig> {
131
- declare public showClear?: boolean;
132
- declare public alwaysShowClear?: boolean;
133
- declare public hideClear?: boolean;
134
- declare public format?: string;
135
- declare public segment?: string;
136
- declare public maxValueErrorText?: string;
137
- declare public maxExclusiveErrorText?: string;
138
- declare public minValueErrorText?: string;
139
- declare public minExclusiveErrorText?: string;
140
- declare public inputErrorText?: string;
141
- declare public disabledDaysOfWeekErrorText?: string;
142
- declare public value?: unknown;
143
- declare public minValue?: unknown;
144
- declare public maxValue?: unknown;
145
- declare public minExclusive?: boolean;
146
- declare public maxExclusive?: boolean;
147
- declare public picker?: string;
148
- declare public partial?: boolean;
149
- declare public encoding?: (date: Date) => string;
150
- declare public disabledDaysOfWeek?: number[] | null;
151
- declare public reactOn?: string;
152
- declare public focusInputFirst?: boolean;
153
- declare public dropdownOptions?: Partial<DropdownConfig>;
154
- declare public onParseInput?:
155
- | string
156
- | ((date: unknown, instance: Instance) => Date | undefined);
157
- declare public showSeconds?: boolean;
158
- declare public step?: number;
159
-
160
- constructor(config?: DateTimeFieldConfig) {
161
- super(config);
162
- }
163
-
164
- declareData(...args: Record<string, unknown>[]): void {
165
- super.declareData(
166
- {
167
- value: this.emptyValue,
168
- disabled: undefined,
169
- readOnly: undefined,
170
- enabled: undefined,
171
- placeholder: undefined,
172
- required: undefined,
173
- minValue: undefined,
174
- minExclusive: undefined,
175
- maxValue: undefined,
176
- maxExclusive: undefined,
177
- format: undefined,
178
- icon: undefined,
179
- autoOpen: undefined,
180
- },
181
- ...args,
182
- );
183
- }
184
-
185
- init(): void {
186
- if (typeof this.hideClear !== "undefined") this.showClear = !this.hideClear;
187
-
188
- if (this.alwaysShowClear) this.showClear = true;
189
-
190
- if (!this.format) {
191
- switch (this.segment) {
192
- case "datetime":
193
- this.format = "datetime;YYYYMMddhhmm";
194
- break;
195
-
196
- case "time":
197
- this.format = "time;hhmm";
198
- break;
199
-
200
- case "date":
201
- this.format = "date;yyyyMMMdd";
202
- break;
203
- }
204
- }
205
- super.init();
206
- }
207
-
208
- prepareData(
209
- context: RenderingContext,
210
- instance: FieldInstance<DateTimeField>,
211
- ): void {
212
- let { data } = instance;
213
- let dropdownInstance = instance as DropdownInstance;
214
-
215
- if (data.value) {
216
- let date = parseDateInvariant(data.value);
217
- // let date = new Date(data.value);
218
-
219
- if (isNaN(date.getTime())) data.formatted = String(data.value);
220
- else {
221
- // handle utc edge cases
222
- if (this.segment == "date") date = zeroTime(date);
223
- data.formatted = Format.value(date, data.format);
224
- }
225
- data.date = date;
226
- } else data.formatted = "";
227
-
228
- if (data.refDate) data.refDate = zeroTime(parseDateInvariant(data.refDate));
229
-
230
- if (data.maxValue) data.maxValue = parseDateInvariant(data.maxValue);
231
-
232
- if (data.minValue) data.minValue = parseDateInvariant(data.minValue);
233
-
234
- if (this.segment == "date") {
235
- if (data.minValue) data.minValue = zeroTime(data.minValue);
236
-
237
- if (data.maxValue) data.maxValue = zeroTime(data.maxValue);
238
- }
239
-
240
- dropdownInstance.lastDropdown = context.lastDropdown;
241
-
242
- super.prepareData(context, instance);
243
- }
244
-
245
- validate(
246
- context: RenderingContext,
247
- instance: FieldInstance<DateTimeField>,
248
- ): void {
249
- super.validate(context, instance);
250
- let { data, widget } = instance;
251
- let dateTimeWidget = widget as DateTimeField;
252
-
253
- if (!data.error && data.date) {
254
- if (isNaN(data.date)) data.error = this.inputErrorText;
255
- else {
256
- let d;
257
- if (data.maxValue) {
258
- d = dateDiff(data.date, data.maxValue);
259
- if (d > 0)
260
- data.error = StringTemplate.format(
261
- this.maxValueErrorText!,
262
- data.maxValue,
263
- );
264
- else if (d == 0 && data.maxExclusive)
265
- data.error = StringTemplate.format(
266
- this.maxExclusiveErrorText!,
267
- data.maxValue,
268
- );
269
- }
270
- if (data.minValue) {
271
- d = dateDiff(data.date, data.minValue);
272
- if (d < 0)
273
- data.error = StringTemplate.format(
274
- this.minValueErrorText!,
275
- data.minValue,
276
- );
277
- else if (d == 0 && data.minExclusive)
278
- data.error = StringTemplate.format(
279
- this.minExclusiveErrorText!,
280
- data.minValue,
281
- );
282
- }
283
- if (dateTimeWidget.disabledDaysOfWeek) {
284
- if (dateTimeWidget.disabledDaysOfWeek.includes(data.date.getDay()))
285
- data.error = this.disabledDaysOfWeekErrorText;
286
- }
287
- }
288
- }
289
- }
290
-
291
- renderInput(
292
- context: RenderingContext,
293
- instance: FieldInstance<DateTimeField>,
294
- key: string,
295
- ): React.ReactNode {
296
- return (
297
- <DateTimeInput
298
- key={key}
299
- instance={instance}
300
- data={instance.data}
301
- picker={{
302
- value: this.value,
303
- minValue: this.minValue,
304
- maxValue: this.maxValue,
305
- minExclusive: this.minExclusive,
306
- maxExclusive: this.maxExclusive,
307
- maxValueErrorText: this.maxValueErrorText,
308
- maxExclusiveErrorText: this.maxExclusiveErrorText,
309
- minValueErrorText: this.minValueErrorText,
310
- minExclusiveErrorText: this.minExclusiveErrorText,
311
- }}
312
- label={
313
- this.labelPlacement &&
314
- getContent(this.renderLabel(context, instance, "label"))
315
- }
316
- help={
317
- this.helpPlacement &&
318
- getContent(this.renderHelp(context, instance, "help"))
319
- }
320
- icon={getContent(this.renderIcon(context, instance, "icon"))}
321
- />
322
- );
323
- }
324
-
325
- formatValue(context: RenderingContext, { data }: Instance): React.ReactNode {
326
- return data.value ? data.formatted : null;
327
- }
328
-
329
- parseDate(date: unknown, instance: Instance): Date | null {
330
- if (!date) return null;
331
- if (date instanceof Date) return date;
332
- if (this.onParseInput) {
333
- let result = instance.invoke("onParseInput", date, instance);
334
- if (result !== undefined) return result;
335
- }
336
- date = Culture.getDateTimeCulture().parse(date, {
337
- useCurrentDateForDefaults: true,
338
- }) as Date;
339
- return date as Date | null;
340
- }
341
- }
342
-
343
- DateTimeField.prototype.baseClass = "datetimefield";
344
- DateTimeField.prototype.maxValueErrorText = "Select {0:d} or before.";
345
- DateTimeField.prototype.maxExclusiveErrorText = "Select a date before {0:d}.";
346
- DateTimeField.prototype.minValueErrorText = "Select {0:d} or later.";
347
- DateTimeField.prototype.minExclusiveErrorText = "Select a date after {0:d}.";
348
- DateTimeField.prototype.inputErrorText = "Invalid date entered.";
349
- DateTimeField.prototype.disabledDaysOfWeekErrorText =
350
- "Selected day of week is not allowed.";
351
-
352
- DateTimeField.prototype.suppressErrorsUntilVisited = true;
353
- DateTimeField.prototype.icon = "calendar";
354
- DateTimeField.prototype.showClear = true;
355
- DateTimeField.prototype.alwaysShowClear = false;
356
- DateTimeField.prototype.reactOn = "enter blur";
357
- DateTimeField.prototype.segment = "datetime";
358
- DateTimeField.prototype.picker = "auto";
359
- DateTimeField.prototype.disabledDaysOfWeek = null;
360
- DateTimeField.prototype.focusInputFirst = false;
361
-
362
- Widget.alias("datetimefield", DateTimeField);
363
- Localization.registerPrototype("cx/widgets/DateTimeField", DateTimeField);
364
-
365
- interface DateTimeInputProps {
366
- instance: FieldInstance<DateTimeField>;
367
- data: Record<string, unknown>;
368
- picker: Record<string, unknown>;
369
- label?: React.ReactNode;
370
- help?: React.ReactNode;
371
- icon?: React.ReactNode;
372
- }
373
-
374
- interface DateTimeInputState {
375
- dropdownOpen: boolean;
376
- focus: boolean;
377
- dropdownOpenTime?: number;
378
- }
379
-
380
- class DateTimeInput extends VDOM.Component<
381
- DateTimeInputProps,
382
- DateTimeInputState
383
- > {
384
- input!: HTMLInputElement;
385
- dropdown?: Widget;
386
- scrollableParents?: Element[];
387
- openDropdownOnFocus: boolean = false;
388
- updateDropdownPosition: () => void;
389
- scrolling?: boolean;
390
-
391
- constructor(props: DateTimeInputProps) {
392
- super(props);
393
- (props.instance as any).component = this;
394
- this.state = {
395
- dropdownOpen: false,
396
- focus: false,
397
- };
398
- this.updateDropdownPosition = () => {};
399
- }
400
-
401
- getDropdown(): Widget {
402
- if (this.dropdown) return this.dropdown;
403
-
404
- let { widget, lastDropdown } = this.props.instance as DropdownInstance;
405
- let dateTimeWidget = widget as DateTimeField;
406
-
407
- let pickerConfig;
408
-
409
- switch (dateTimeWidget.picker) {
410
- case "calendar":
411
- pickerConfig = {
412
- type: Calendar,
413
- partial: dateTimeWidget.partial,
414
- encoding: dateTimeWidget.encoding,
415
- disabledDaysOfWeek: dateTimeWidget.disabledDaysOfWeek,
416
- focusable: !dateTimeWidget.focusInputFirst,
417
- };
418
- break;
419
-
420
- case "list":
421
- pickerConfig = {
422
- type: TimeList,
423
- style: "height: 300px",
424
- encoding: dateTimeWidget.encoding,
425
- step: dateTimeWidget.step,
426
- format: dateTimeWidget.format,
427
- scrollSelectionIntoView: true,
428
- };
429
- break;
430
-
431
- default:
432
- pickerConfig = {
433
- type: DateTimePicker,
434
- segment: dateTimeWidget.segment,
435
- encoding: dateTimeWidget.encoding,
436
- showSeconds: dateTimeWidget.showSeconds,
437
- };
438
- break;
439
- }
440
-
441
- let dropdown = {
442
- scrollTracking: true,
443
- inline: !isTouchDevice() || !!lastDropdown,
444
- matchWidth: false,
445
- placementOrder: "down down-right down-left up up-right up-left",
446
- touchFriendly: true,
447
- firstChildDefinesHeight: true,
448
- firstChildDefinesWidth: true,
449
- ...dateTimeWidget.dropdownOptions,
450
- type: Dropdown,
451
- relatedElement: this.input,
452
- onFocusOut: (e: unknown) => {
453
- this.closeDropdown(e);
454
- },
455
- onMouseDown: stopPropagation,
456
- items: {
457
- mod: "dropdown",
458
- ...pickerConfig,
459
- ...this.props.picker,
460
- autoFocus: !dateTimeWidget.focusInputFirst,
461
- tabIndex: dateTimeWidget.focusInputFirst ? -1 : 0,
462
- onKeyDown: (e: React.KeyboardEvent) => this.onKeyDown(e),
463
- onSelect: (e: React.MouseEvent, calendar: any, date: Date) => {
464
- e.stopPropagation();
465
- e.preventDefault();
466
- let touch = isTouchEvent();
467
- this.closeDropdown(e, () => {
468
- if (date) {
469
- // If a blur event occurs before we re-render the input,
470
- // the old input value is parsed and written to the store.
471
- // We want to prevent that by eagerly updating the input value.
472
- // This can happen if the date field is within a menu.
473
- let newFormattedValue = Format.value(
474
- date,
475
- this.props.data.format as string,
476
- );
477
- this.input.value = newFormattedValue;
478
- }
479
- if (!touch) this.input.focus();
480
- });
481
- },
482
- },
483
- };
484
-
485
- return (this.dropdown = Widget.create(dropdown));
486
- }
487
-
488
- render(): React.ReactNode {
489
- let { instance, label, help, icon: iconVDOM } = this.props;
490
- let { data, widget, state } = instance;
491
- let {
492
- CSS,
493
- baseClass,
494
- suppressErrorsUntilVisited,
495
- showClear,
496
- alwaysShowClear,
497
- } = widget;
498
-
499
- let insideButton, icon;
500
-
501
- if (!data.readOnly && !data.disabled) {
502
- if (
503
- showClear &&
504
- (((alwaysShowClear || !data.required) && !data.empty) ||
505
- instance.state?.inputError)
506
- )
507
- insideButton = (
508
- <div
509
- className={CSS.element(baseClass, "clear")}
510
- onMouseDown={(e) => {
511
- e.preventDefault();
512
- e.stopPropagation();
513
- }}
514
- onClick={(e) => this.onClearClick(e)}
515
- >
516
- <ClearIcon className={CSS.element(baseClass, "icon")} />
517
- </div>
518
- );
519
- else
520
- insideButton = (
521
- <div className={CSS.element(baseClass, "right-icon")}>
522
- <DropdownIcon className={CSS.element(baseClass, "icon")} />
523
- </div>
524
- );
525
- }
526
-
527
- if (iconVDOM) {
528
- icon = (
529
- <div className={CSS.element(baseClass, "left-icon")}>{iconVDOM}</div>
530
- );
531
- }
532
-
533
- let dropdown: React.ReactNode | undefined;
534
- if (this.state.dropdownOpen)
535
- dropdown = (
536
- <Cx
537
- widget={this.getDropdown()}
538
- parentInstance={instance}
539
- options={{ name: "datefield-dropdown" }}
540
- subscribe
541
- />
542
- );
543
-
544
- let empty = this.input ? !this.input.value : data.empty;
545
-
546
- return (
547
- <div
548
- className={CSS.expand(
549
- data.classNames,
550
- CSS.state({
551
- visited: state?.visited,
552
- focus: this.state.focus || this.state.dropdownOpen,
553
- icon: !!icon,
554
- empty: empty && !data.placeholder,
555
- error:
556
- data.error &&
557
- (state?.visited || !suppressErrorsUntilVisited || !empty),
558
- }),
559
- )}
560
- style={data.style as React.CSSProperties}
561
- onMouseDown={this.onMouseDown.bind(this)}
562
- onTouchStart={stopPropagation}
563
- >
564
- <input
565
- id={data.id as string}
566
- ref={(el) => {
567
- this.input = el!;
568
- }}
569
- type="text"
570
- className={CSS.expand(
571
- CSS.element(baseClass, "input"),
572
- data.inputClass,
573
- )}
574
- style={data.inputStyle as React.CSSProperties}
575
- defaultValue={data.formatted as string}
576
- disabled={data.disabled as boolean}
577
- readOnly={data.readOnly as boolean}
578
- tabIndex={data.tabIndex as number}
579
- placeholder={data.placeholder as string}
580
- {...(data.inputAttrs as Record<string, any>)}
581
- onInput={(e) =>
582
- this.onChange((e.target as HTMLInputElement).value, "input")
583
- }
584
- onChange={(e) => this.onChange(e.target.value, "change")}
585
- onKeyDown={(e) => this.onKeyDown(e)}
586
- onBlur={(e) => {
587
- this.onBlur(e);
588
- }}
589
- onFocus={(e) => {
590
- this.onFocus(e);
591
- }}
592
- onMouseMove={(e) =>
593
- tooltipMouseMove(e, ...getFieldTooltip(this.props.instance))
594
- }
595
- onMouseLeave={(e) =>
596
- tooltipMouseLeave(e, ...getFieldTooltip(this.props.instance))
597
- }
598
- />
599
- {icon}
600
- {insideButton}
601
- {dropdown}
602
- {label}
603
- {help}
604
- </div>
605
- );
606
- }
607
-
608
- onMouseDown(e: React.MouseEvent): void {
609
- e.stopPropagation();
610
- let { widget } = this.props.instance;
611
-
612
- if (this.state.dropdownOpen) {
613
- this.closeDropdown(e);
614
- } else {
615
- this.openDropdownOnFocus = true;
616
- }
617
-
618
- //icon click
619
- if (e.target !== this.input) {
620
- e.preventDefault();
621
-
622
- //the field should not focus only in case when dropdown will open and autofocus
623
- if (widget.focusInputFirst || this.state.dropdownOpen) this.input.focus();
624
-
625
- if (this.state.dropdownOpen) this.closeDropdown(e);
626
- else this.openDropdown();
627
- }
628
- }
629
-
630
- onFocus(e: React.FocusEvent): void {
631
- let { instance } = this.props;
632
- let { widget } = instance;
633
-
634
- if (widget.trackFocus) {
635
- this.setState({
636
- focus: true,
637
- });
638
- }
639
- if (this.openDropdownOnFocus || widget.focusInputFirst) this.openDropdown();
640
- }
641
-
642
- onKeyDown(e: React.KeyboardEvent): void {
643
- let { instance } = this.props;
644
- if (instance.widget.handleKeyDown(e, instance) === false) return;
645
-
646
- switch (e.keyCode) {
647
- case KeyCode.enter:
648
- this.onChange((e.target as HTMLInputElement).value, "enter");
649
- break;
650
-
651
- case KeyCode.esc:
652
- if (this.state.dropdownOpen) {
653
- e.stopPropagation();
654
- this.closeDropdown(e, () => {
655
- this.input.focus();
656
- });
657
- }
658
- break;
659
-
660
- case KeyCode.left:
661
- case KeyCode.right:
662
- e.stopPropagation();
663
- break;
664
-
665
- case KeyCode.down:
666
- this.openDropdown();
667
- e.stopPropagation();
668
- e.preventDefault();
669
- break;
670
- }
671
- }
672
-
673
- onBlur(e: React.FocusEvent<HTMLInputElement>): void {
674
- let { widget } = this.props.instance;
675
- let dateTimeWidget = widget as DateTimeField;
676
-
677
- if (!this.state.dropdownOpen)
678
- this.props.instance.setState({ visited: true });
679
- else if (dateTimeWidget.focusInputFirst) this.closeDropdown(e);
680
- if (this.state.focus)
681
- this.setState({
682
- focus: false,
683
- });
684
- this.onChange(e.target.value, "blur");
685
- }
686
-
687
- closeDropdown(e: unknown, callback?: () => void): void {
688
- if (this.state.dropdownOpen) {
689
- if (this.scrollableParents)
690
- this.scrollableParents.forEach((el) => {
691
- el.removeEventListener("scroll", this.updateDropdownPosition);
692
- });
693
-
694
- this.setState({ dropdownOpen: false }, callback);
695
- this.props.instance.setState({ visited: true });
696
- } else if (callback) callback();
697
- }
698
-
699
- openDropdown(): void {
700
- let { data } = this.props.instance;
701
- this.openDropdownOnFocus = false;
702
-
703
- if (!this.state.dropdownOpen && !(data.disabled || data.readOnly)) {
704
- this.setState({
705
- dropdownOpen: true,
706
- dropdownOpenTime: Date.now(),
707
- });
708
- }
709
- }
710
-
711
- onClearClick(e: React.MouseEvent): void {
712
- this.setValue(null);
713
- e.stopPropagation();
714
- e.preventDefault();
715
- }
716
-
717
- UNSAFE_componentWillReceiveProps(props: DateTimeInputProps): void {
718
- let { data, state } = props.instance;
719
- if (
720
- data.formatted !== this.input.value &&
721
- (data.formatted !== this.props.data.formatted || !state?.inputError)
722
- ) {
723
- this.input.value = data.formatted || "";
724
- props.instance.setState({
725
- inputError: false,
726
- });
727
- }
728
-
729
- tooltipParentWillReceiveProps(
730
- this.input,
731
- ...getFieldTooltip(this.props.instance),
732
- );
733
- }
734
-
735
- componentDidMount(): void {
736
- tooltipParentDidMount(this.input, ...getFieldTooltip(this.props.instance));
737
- autoFocus(this.input, this);
738
- if (this.props.data.autoOpen) this.openDropdown();
739
- }
740
-
741
- componentDidUpdate(): void {
742
- autoFocus(this.input, this);
743
- }
744
-
745
- componentWillUnmount(): void {
746
- if (
747
- this.input == getActiveElement() &&
748
- this.input.value != this.props.data.formatted
749
- ) {
750
- this.onChange(this.input.value, "blur");
751
- }
752
- tooltipParentWillUnmount(this.props.instance);
753
- }
754
-
755
- onChange(inputValue: string, eventType: string): void {
756
- let { instance, data } = this.props;
757
- let { widget } = instance;
758
- let dateTimeWidget = widget as DateTimeField;
759
-
760
- if (data.disabled || data.readOnly) return;
761
-
762
- if (dateTimeWidget.reactOn!.indexOf(eventType) === -1) return;
763
-
764
- if (eventType == "enter") instance.setState({ visited: true });
765
-
766
- this.setValue(inputValue, data.value);
767
- }
768
-
769
- setValue(text: string | null, baseValue?: unknown): void {
770
- let { instance, data } = this.props;
771
- let { widget } = instance;
772
- let dateTimeWidget = widget as DateTimeField;
773
-
774
- let date = dateTimeWidget.parseDate(text, instance);
775
-
776
- instance.setState({
777
- inputError: isNaN(date as any) && dateTimeWidget.inputErrorText,
778
- });
779
-
780
- if (!isNaN(date as any)) {
781
- let mixed = parseDateInvariant(baseValue as string);
782
- if (date && baseValue && !isNaN(mixed as any) && dateTimeWidget.partial) {
783
- switch (dateTimeWidget.segment) {
784
- case "date":
785
- mixed.setFullYear(date!.getFullYear());
786
- mixed.setMonth(date!.getMonth());
787
- mixed.setDate(date!.getDate());
788
- break;
789
-
790
- case "time":
791
- mixed.setHours(date!.getHours());
792
- mixed.setMinutes(date!.getMinutes());
793
- mixed.setSeconds(date!.getSeconds());
794
- break;
795
-
796
- default:
797
- mixed = date;
798
- break;
799
- }
800
-
801
- date = mixed;
802
- }
803
-
804
- let encode = dateTimeWidget.encoding || Culture.getDefaultDateEncoding();
805
-
806
- let value = date ? encode!(date!) : dateTimeWidget.emptyValue;
807
-
808
- if (!instance.set("value", value))
809
- this.input.value = value
810
- ? Format.value(date!, data.format as string)
811
- : "";
812
- }
813
- }
814
- }
1
+ /** @jsxImportSource react */
2
+ import { StringTemplate } from "../../data/StringTemplate";
3
+ import { Culture } from "../../ui/Culture";
4
+ import { Cx } from "../../ui/Cx";
5
+ import type { DropdownInstance, Instance } from "../../ui/Instance";
6
+ import { FieldInstance } from "./Field";
7
+ import { Localization } from "../../ui/Localization";
8
+ import type { RenderingContext } from "../../ui/RenderingContext";
9
+ import { VDOM, Widget, getContent } from "../../ui/Widget";
10
+ import { getActiveElement, parseDateInvariant } from "../../util";
11
+ import { dateDiff } from "../../util/date/dateDiff";
12
+ import { zeroTime } from "../../util/date/zeroTime";
13
+ import { stopPropagation } from "../../util/eventCallbacks";
14
+ import { Format } from "../../util/Format";
15
+ import { isTouchDevice } from "../../util/isTouchDevice";
16
+ import { isTouchEvent } from "../../util/isTouchEvent";
17
+ import { KeyCode } from "../../util/KeyCode";
18
+ import { autoFocus } from "../autoFocus";
19
+ import ClearIcon from "../icons/clear";
20
+ import DropdownIcon from "../icons/drop-down";
21
+ import { Dropdown, DropdownConfig } from "../overlay/Dropdown";
22
+ import {
23
+ tooltipMouseLeave,
24
+ tooltipMouseMove,
25
+ tooltipParentDidMount,
26
+ tooltipParentWillReceiveProps,
27
+ tooltipParentWillUnmount,
28
+ } from "../overlay/tooltip-ops";
29
+ import { Calendar } from "./Calendar";
30
+ import { DateTimePicker } from "./DateTimePicker";
31
+ import { Field, FieldConfig, getFieldTooltip } from "./Field";
32
+ import { TimeList } from "./TimeList";
33
+ import { BooleanProp, Config, Prop, StringProp } from "../../ui/Prop";
34
+
35
+ export interface DateTimeFieldConfig extends FieldConfig {
36
+ /** Selected date. This should be a Date object or a valid date string consumable by Date.parse function. */
37
+ value?: Prop<string | Date>;
38
+
39
+ /** Defaults to false. Used to make the field read-only. */
40
+ readOnly?: BooleanProp;
41
+
42
+ /** The opposite of `disabled`. */
43
+ enabled?: BooleanProp;
44
+
45
+ /** Default text displayed when the field is empty. */
46
+ placeholder?: StringProp;
47
+
48
+ /** Minimum date value. This should be a Date object or a valid date string consumable by Date.parse function. */
49
+ minValue?: Prop<string | Date>;
50
+
51
+ /** Set to `true` to disallow the `minValue`. Default value is `false`. */
52
+ minExclusive?: BooleanProp;
53
+
54
+ /** Maximum date value. This should be a Date object or a valid date string consumable by Date.parse function. */
55
+ maxValue?: Prop<string | Date>;
56
+
57
+ /** Set to `true` to disallow the `maxValue`. Default value is `false`. */
58
+ maxExclusive?: BooleanProp;
59
+
60
+ /** Date format used to display the selected date. */
61
+ format?: StringProp;
62
+
63
+ /** Base CSS class to be applied to the field. Defaults to `datefield`. */
64
+ baseClass?: string;
65
+
66
+ /** Maximum value error text. */
67
+ maxValueErrorText?: string;
68
+
69
+ /** Maximum exclusive value error text. */
70
+ maxExclusiveErrorText?: string;
71
+
72
+ /** Minimum value error text. */
73
+ minValueErrorText?: string;
74
+
75
+ /** Minimum exclusive value error text. */
76
+ minExclusiveErrorText?: string;
77
+
78
+ /** Error message used to indicate wrong user input. */
79
+ inputErrorText?: string;
80
+
81
+ /** Name or configuration of the icon to be put on the left side of the input. */
82
+ icon?: StringProp | Config;
83
+
84
+ /** Set to false to hide the clear button. Default value is true. */
85
+ showClear?: boolean;
86
+
87
+ /** Set to `true` to display the clear button even if `required` is set. Default is `false`. */
88
+ alwaysShowClear?: boolean;
89
+
90
+ /** Set to true to hide the clear button. Default value is false. */
91
+ hideClear?: boolean;
92
+
93
+ /** Determines which segment of date/time is used. Default value is `datetime`. */
94
+ segment?: "date" | "time" | "datetime";
95
+
96
+ /** Set to `true` to indicate that only one segment of the selected date is affected. */
97
+ partial?: boolean;
98
+
99
+ /** The function that will be used to convert Date objects before writing data to the store. */
100
+ encoding?: (date: Date) => any;
101
+
102
+ /** Defines which days of week should be displayed as disabled. */
103
+ disabledDaysOfWeek?: number[];
104
+
105
+ /** Set to true to focus the input field instead of the picker first. */
106
+ focusInputFirst?: boolean;
107
+
108
+ /** Set to true to enable seconds segment in the picker. */
109
+ showSeconds?: boolean;
110
+
111
+ /** Additional configuration to be passed to the dropdown. */
112
+ dropdownOptions?: Partial<DropdownConfig>;
113
+
114
+ /** Type of picker to show. Can be `calendar`, `time`, `list`, or `auto`. Default is `auto`. */
115
+ picker?: "calendar" | "time" | "list" | "auto";
116
+
117
+ /** Time step in minutes for the time picker. */
118
+ step?: number;
119
+
120
+ /** Custom validation function. */
121
+ onValidate?:
122
+ | string
123
+ | ((
124
+ value: string | Date,
125
+ instance: Instance,
126
+ validationParams: Record<string, unknown>,
127
+ ) => unknown);
128
+ }
129
+
130
+ export class DateTimeField extends Field<DateTimeFieldConfig> {
131
+ declare public showClear?: boolean;
132
+ declare public alwaysShowClear?: boolean;
133
+ declare public hideClear?: boolean;
134
+ declare public format?: string;
135
+ declare public segment?: string;
136
+ declare public maxValueErrorText?: string;
137
+ declare public maxExclusiveErrorText?: string;
138
+ declare public minValueErrorText?: string;
139
+ declare public minExclusiveErrorText?: string;
140
+ declare public inputErrorText?: string;
141
+ declare public disabledDaysOfWeekErrorText?: string;
142
+ declare public value?: unknown;
143
+ declare public minValue?: unknown;
144
+ declare public maxValue?: unknown;
145
+ declare public minExclusive?: boolean;
146
+ declare public maxExclusive?: boolean;
147
+ declare public picker?: string;
148
+ declare public partial?: boolean;
149
+ declare public encoding?: (date: Date) => string;
150
+ declare public disabledDaysOfWeek?: number[] | null;
151
+ declare public reactOn?: string;
152
+ declare public focusInputFirst?: boolean;
153
+ declare public dropdownOptions?: Partial<DropdownConfig>;
154
+ declare public onParseInput?:
155
+ | string
156
+ | ((date: unknown, instance: Instance) => Date | undefined);
157
+ declare public showSeconds?: boolean;
158
+ declare public step?: number;
159
+
160
+ constructor(config?: DateTimeFieldConfig) {
161
+ super(config);
162
+ }
163
+
164
+ declareData(...args: Record<string, unknown>[]): void {
165
+ super.declareData(
166
+ {
167
+ value: this.emptyValue,
168
+ disabled: undefined,
169
+ readOnly: undefined,
170
+ enabled: undefined,
171
+ placeholder: undefined,
172
+ required: undefined,
173
+ minValue: undefined,
174
+ minExclusive: undefined,
175
+ maxValue: undefined,
176
+ maxExclusive: undefined,
177
+ format: undefined,
178
+ icon: undefined,
179
+ autoOpen: undefined,
180
+ },
181
+ ...args,
182
+ );
183
+ }
184
+
185
+ init(): void {
186
+ if (typeof this.hideClear !== "undefined") this.showClear = !this.hideClear;
187
+
188
+ if (this.alwaysShowClear) this.showClear = true;
189
+
190
+ if (!this.format) {
191
+ switch (this.segment) {
192
+ case "datetime":
193
+ this.format = "datetime;YYYYMMddhhmm";
194
+ break;
195
+
196
+ case "time":
197
+ this.format = "time;hhmm";
198
+ break;
199
+
200
+ case "date":
201
+ this.format = "date;yyyyMMMdd";
202
+ break;
203
+ }
204
+ }
205
+ super.init();
206
+ }
207
+
208
+ prepareData(
209
+ context: RenderingContext,
210
+ instance: FieldInstance<DateTimeField>,
211
+ ): void {
212
+ let { data } = instance;
213
+ let dropdownInstance = instance as DropdownInstance;
214
+
215
+ if (data.value) {
216
+ let date = parseDateInvariant(data.value);
217
+ // let date = new Date(data.value);
218
+
219
+ if (isNaN(date.getTime())) data.formatted = String(data.value);
220
+ else {
221
+ // handle utc edge cases
222
+ if (this.segment == "date") date = zeroTime(date);
223
+ data.formatted = Format.value(date, data.format);
224
+ }
225
+ data.date = date;
226
+ } else data.formatted = "";
227
+
228
+ if (data.refDate) data.refDate = zeroTime(parseDateInvariant(data.refDate));
229
+
230
+ if (data.maxValue) data.maxValue = parseDateInvariant(data.maxValue);
231
+
232
+ if (data.minValue) data.minValue = parseDateInvariant(data.minValue);
233
+
234
+ if (this.segment == "date") {
235
+ if (data.minValue) data.minValue = zeroTime(data.minValue);
236
+
237
+ if (data.maxValue) data.maxValue = zeroTime(data.maxValue);
238
+ }
239
+
240
+ dropdownInstance.lastDropdown = context.lastDropdown;
241
+
242
+ super.prepareData(context, instance);
243
+ }
244
+
245
+ validate(
246
+ context: RenderingContext,
247
+ instance: FieldInstance<DateTimeField>,
248
+ ): void {
249
+ super.validate(context, instance);
250
+ let { data, widget } = instance;
251
+ let dateTimeWidget = widget as DateTimeField;
252
+
253
+ if (!data.error && data.date) {
254
+ if (isNaN(data.date)) data.error = this.inputErrorText;
255
+ else {
256
+ let d;
257
+ if (data.maxValue) {
258
+ d = dateDiff(data.date, data.maxValue);
259
+ if (d > 0)
260
+ data.error = StringTemplate.format(
261
+ this.maxValueErrorText!,
262
+ data.maxValue,
263
+ );
264
+ else if (d == 0 && data.maxExclusive)
265
+ data.error = StringTemplate.format(
266
+ this.maxExclusiveErrorText!,
267
+ data.maxValue,
268
+ );
269
+ }
270
+ if (data.minValue) {
271
+ d = dateDiff(data.date, data.minValue);
272
+ if (d < 0)
273
+ data.error = StringTemplate.format(
274
+ this.minValueErrorText!,
275
+ data.minValue,
276
+ );
277
+ else if (d == 0 && data.minExclusive)
278
+ data.error = StringTemplate.format(
279
+ this.minExclusiveErrorText!,
280
+ data.minValue,
281
+ );
282
+ }
283
+ if (dateTimeWidget.disabledDaysOfWeek) {
284
+ if (dateTimeWidget.disabledDaysOfWeek.includes(data.date.getDay()))
285
+ data.error = this.disabledDaysOfWeekErrorText;
286
+ }
287
+ }
288
+ }
289
+ }
290
+
291
+ renderInput(
292
+ context: RenderingContext,
293
+ instance: FieldInstance<DateTimeField>,
294
+ key: string,
295
+ ): React.ReactNode {
296
+ return (
297
+ <DateTimeInput
298
+ key={key}
299
+ instance={instance}
300
+ data={instance.data}
301
+ picker={{
302
+ value: this.value,
303
+ minValue: this.minValue,
304
+ maxValue: this.maxValue,
305
+ minExclusive: this.minExclusive,
306
+ maxExclusive: this.maxExclusive,
307
+ maxValueErrorText: this.maxValueErrorText,
308
+ maxExclusiveErrorText: this.maxExclusiveErrorText,
309
+ minValueErrorText: this.minValueErrorText,
310
+ minExclusiveErrorText: this.minExclusiveErrorText,
311
+ }}
312
+ label={
313
+ this.labelPlacement &&
314
+ getContent(this.renderLabel(context, instance, "label"))
315
+ }
316
+ help={
317
+ this.helpPlacement &&
318
+ getContent(this.renderHelp(context, instance, "help"))
319
+ }
320
+ icon={getContent(this.renderIcon(context, instance, "icon"))}
321
+ />
322
+ );
323
+ }
324
+
325
+ formatValue(context: RenderingContext, { data }: Instance): React.ReactNode {
326
+ return data.value ? data.formatted : null;
327
+ }
328
+
329
+ parseDate(date: unknown, instance: Instance): Date | null {
330
+ if (!date) return null;
331
+ if (date instanceof Date) return date;
332
+ if (this.onParseInput) {
333
+ let result = instance.invoke("onParseInput", date, instance);
334
+ if (result !== undefined) return result;
335
+ }
336
+ date = Culture.getDateTimeCulture().parse(date, {
337
+ useCurrentDateForDefaults: true,
338
+ }) as Date;
339
+ return date as Date | null;
340
+ }
341
+ }
342
+
343
+ DateTimeField.prototype.baseClass = "datetimefield";
344
+ DateTimeField.prototype.maxValueErrorText = "Select {0:d} or before.";
345
+ DateTimeField.prototype.maxExclusiveErrorText = "Select a date before {0:d}.";
346
+ DateTimeField.prototype.minValueErrorText = "Select {0:d} or later.";
347
+ DateTimeField.prototype.minExclusiveErrorText = "Select a date after {0:d}.";
348
+ DateTimeField.prototype.inputErrorText = "Invalid date entered.";
349
+ DateTimeField.prototype.disabledDaysOfWeekErrorText =
350
+ "Selected day of week is not allowed.";
351
+
352
+ DateTimeField.prototype.suppressErrorsUntilVisited = true;
353
+ DateTimeField.prototype.icon = "calendar";
354
+ DateTimeField.prototype.showClear = true;
355
+ DateTimeField.prototype.alwaysShowClear = false;
356
+ DateTimeField.prototype.reactOn = "enter blur";
357
+ DateTimeField.prototype.segment = "datetime";
358
+ DateTimeField.prototype.picker = "auto";
359
+ DateTimeField.prototype.disabledDaysOfWeek = null;
360
+ DateTimeField.prototype.focusInputFirst = false;
361
+
362
+ Widget.alias("datetimefield", DateTimeField);
363
+ Localization.registerPrototype("cx/widgets/DateTimeField", DateTimeField);
364
+
365
+ interface DateTimeInputProps {
366
+ instance: FieldInstance<DateTimeField>;
367
+ data: Record<string, unknown>;
368
+ picker: Record<string, unknown>;
369
+ label?: React.ReactNode;
370
+ help?: React.ReactNode;
371
+ icon?: React.ReactNode;
372
+ }
373
+
374
+ interface DateTimeInputState {
375
+ dropdownOpen: boolean;
376
+ focus: boolean;
377
+ dropdownOpenTime?: number;
378
+ }
379
+
380
+ class DateTimeInput extends VDOM.Component<
381
+ DateTimeInputProps,
382
+ DateTimeInputState
383
+ > {
384
+ input!: HTMLInputElement;
385
+ dropdown?: Widget;
386
+ scrollableParents?: Element[];
387
+ openDropdownOnFocus: boolean = false;
388
+ updateDropdownPosition: () => void;
389
+ scrolling?: boolean;
390
+
391
+ constructor(props: DateTimeInputProps) {
392
+ super(props);
393
+ (props.instance as any).component = this;
394
+ this.state = {
395
+ dropdownOpen: false,
396
+ focus: false,
397
+ };
398
+ this.updateDropdownPosition = () => {};
399
+ }
400
+
401
+ getDropdown(): Widget {
402
+ if (this.dropdown) return this.dropdown;
403
+
404
+ let { widget, lastDropdown } = this.props.instance as DropdownInstance;
405
+ let dateTimeWidget = widget as DateTimeField;
406
+
407
+ let pickerConfig;
408
+
409
+ switch (dateTimeWidget.picker) {
410
+ case "calendar":
411
+ pickerConfig = {
412
+ type: Calendar,
413
+ partial: dateTimeWidget.partial,
414
+ encoding: dateTimeWidget.encoding,
415
+ disabledDaysOfWeek: dateTimeWidget.disabledDaysOfWeek,
416
+ focusable: !dateTimeWidget.focusInputFirst,
417
+ };
418
+ break;
419
+
420
+ case "list":
421
+ pickerConfig = {
422
+ type: TimeList,
423
+ style: "height: 300px",
424
+ encoding: dateTimeWidget.encoding,
425
+ step: dateTimeWidget.step,
426
+ format: dateTimeWidget.format,
427
+ scrollSelectionIntoView: true,
428
+ };
429
+ break;
430
+
431
+ default:
432
+ pickerConfig = {
433
+ type: DateTimePicker,
434
+ segment: dateTimeWidget.segment,
435
+ encoding: dateTimeWidget.encoding,
436
+ showSeconds: dateTimeWidget.showSeconds,
437
+ };
438
+ break;
439
+ }
440
+
441
+ let dropdown = {
442
+ scrollTracking: true,
443
+ inline: !isTouchDevice() || !!lastDropdown,
444
+ matchWidth: false,
445
+ placementOrder: "down down-right down-left up up-right up-left",
446
+ touchFriendly: true,
447
+ firstChildDefinesHeight: true,
448
+ firstChildDefinesWidth: true,
449
+ ...dateTimeWidget.dropdownOptions,
450
+ type: Dropdown,
451
+ relatedElement: this.input,
452
+ onFocusOut: (e: unknown) => {
453
+ this.closeDropdown(e);
454
+ },
455
+ onMouseDown: stopPropagation,
456
+ items: {
457
+ mod: "dropdown",
458
+ ...pickerConfig,
459
+ ...this.props.picker,
460
+ autoFocus: !dateTimeWidget.focusInputFirst,
461
+ tabIndex: dateTimeWidget.focusInputFirst ? -1 : 0,
462
+ onKeyDown: (e: React.KeyboardEvent) => this.onKeyDown(e),
463
+ onSelect: (e: React.MouseEvent, calendar: any, date: Date) => {
464
+ e.stopPropagation();
465
+ e.preventDefault();
466
+ let touch = isTouchEvent();
467
+ this.closeDropdown(e, () => {
468
+ if (date) {
469
+ // If a blur event occurs before we re-render the input,
470
+ // the old input value is parsed and written to the store.
471
+ // We want to prevent that by eagerly updating the input value.
472
+ // This can happen if the date field is within a menu.
473
+ let newFormattedValue = Format.value(
474
+ date,
475
+ this.props.data.format as string,
476
+ );
477
+ this.input.value = newFormattedValue;
478
+ }
479
+ if (!touch) this.input.focus();
480
+ });
481
+ },
482
+ },
483
+ };
484
+
485
+ return (this.dropdown = Widget.create(dropdown));
486
+ }
487
+
488
+ render(): React.ReactNode {
489
+ let { instance, label, help, icon: iconVDOM } = this.props;
490
+ let { data, widget, state } = instance;
491
+ let {
492
+ CSS,
493
+ baseClass,
494
+ suppressErrorsUntilVisited,
495
+ showClear,
496
+ alwaysShowClear,
497
+ } = widget;
498
+
499
+ let insideButton, icon;
500
+
501
+ if (!data.readOnly && !data.disabled) {
502
+ if (
503
+ showClear &&
504
+ (((alwaysShowClear || !data.required) && !data.empty) ||
505
+ instance.state?.inputError)
506
+ )
507
+ insideButton = (
508
+ <div
509
+ className={CSS.element(baseClass, "clear")}
510
+ onMouseDown={(e) => {
511
+ e.preventDefault();
512
+ e.stopPropagation();
513
+ }}
514
+ onClick={(e) => this.onClearClick(e)}
515
+ >
516
+ <ClearIcon className={CSS.element(baseClass, "icon")} />
517
+ </div>
518
+ );
519
+ else
520
+ insideButton = (
521
+ <div className={CSS.element(baseClass, "right-icon")}>
522
+ <DropdownIcon className={CSS.element(baseClass, "icon")} />
523
+ </div>
524
+ );
525
+ }
526
+
527
+ if (iconVDOM) {
528
+ icon = (
529
+ <div className={CSS.element(baseClass, "left-icon")}>{iconVDOM}</div>
530
+ );
531
+ }
532
+
533
+ let dropdown: React.ReactNode | undefined;
534
+ if (this.state.dropdownOpen)
535
+ dropdown = (
536
+ <Cx
537
+ widget={this.getDropdown()}
538
+ parentInstance={instance}
539
+ options={{ name: "datefield-dropdown" }}
540
+ subscribe
541
+ />
542
+ );
543
+
544
+ let empty = this.input ? !this.input.value : data.empty;
545
+
546
+ return (
547
+ <div
548
+ className={CSS.expand(
549
+ data.classNames,
550
+ CSS.state({
551
+ visited: state?.visited,
552
+ focus: this.state.focus || this.state.dropdownOpen,
553
+ icon: !!icon,
554
+ empty: empty && !data.placeholder,
555
+ error:
556
+ data.error &&
557
+ (state?.visited || !suppressErrorsUntilVisited || !empty),
558
+ }),
559
+ )}
560
+ style={data.style as React.CSSProperties}
561
+ onMouseDown={this.onMouseDown.bind(this)}
562
+ onTouchStart={stopPropagation}
563
+ >
564
+ <input
565
+ id={data.id as string}
566
+ ref={(el) => {
567
+ this.input = el!;
568
+ }}
569
+ type="text"
570
+ className={CSS.expand(
571
+ CSS.element(baseClass, "input"),
572
+ data.inputClass,
573
+ )}
574
+ style={data.inputStyle as React.CSSProperties}
575
+ defaultValue={data.formatted as string}
576
+ disabled={data.disabled as boolean}
577
+ readOnly={data.readOnly as boolean}
578
+ tabIndex={data.tabIndex as number}
579
+ placeholder={data.placeholder as string}
580
+ {...(data.inputAttrs as Record<string, any>)}
581
+ onInput={(e) =>
582
+ this.onChange((e.target as HTMLInputElement).value, "input")
583
+ }
584
+ onChange={(e) => this.onChange(e.target.value, "change")}
585
+ onKeyDown={(e) => this.onKeyDown(e)}
586
+ onBlur={(e) => {
587
+ this.onBlur(e);
588
+ }}
589
+ onFocus={(e) => {
590
+ this.onFocus(e);
591
+ }}
592
+ onMouseMove={(e) =>
593
+ tooltipMouseMove(e, ...getFieldTooltip(this.props.instance))
594
+ }
595
+ onMouseLeave={(e) =>
596
+ tooltipMouseLeave(e, ...getFieldTooltip(this.props.instance))
597
+ }
598
+ />
599
+ {icon}
600
+ {insideButton}
601
+ {dropdown}
602
+ {label}
603
+ {help}
604
+ </div>
605
+ );
606
+ }
607
+
608
+ onMouseDown(e: React.MouseEvent): void {
609
+ e.stopPropagation();
610
+ let { widget } = this.props.instance;
611
+
612
+ if (this.state.dropdownOpen) {
613
+ this.closeDropdown(e);
614
+ } else {
615
+ this.openDropdownOnFocus = true;
616
+ }
617
+
618
+ //icon click
619
+ if (e.target !== this.input) {
620
+ e.preventDefault();
621
+
622
+ //the field should not focus only in case when dropdown will open and autofocus
623
+ if (widget.focusInputFirst || this.state.dropdownOpen) this.input.focus();
624
+
625
+ if (this.state.dropdownOpen) this.closeDropdown(e);
626
+ else this.openDropdown();
627
+ }
628
+ }
629
+
630
+ onFocus(e: React.FocusEvent): void {
631
+ let { instance } = this.props;
632
+ let { widget } = instance;
633
+
634
+ if (widget.trackFocus) {
635
+ this.setState({
636
+ focus: true,
637
+ });
638
+ }
639
+ if (this.openDropdownOnFocus || widget.focusInputFirst) this.openDropdown();
640
+ }
641
+
642
+ onKeyDown(e: React.KeyboardEvent): void {
643
+ let { instance } = this.props;
644
+ if (instance.widget.handleKeyDown(e, instance) === false) return;
645
+
646
+ switch (e.keyCode) {
647
+ case KeyCode.enter:
648
+ this.onChange((e.target as HTMLInputElement).value, "enter");
649
+ break;
650
+
651
+ case KeyCode.esc:
652
+ if (this.state.dropdownOpen) {
653
+ e.stopPropagation();
654
+ this.closeDropdown(e, () => {
655
+ this.input.focus();
656
+ });
657
+ }
658
+ break;
659
+
660
+ case KeyCode.left:
661
+ case KeyCode.right:
662
+ e.stopPropagation();
663
+ break;
664
+
665
+ case KeyCode.down:
666
+ this.openDropdown();
667
+ e.stopPropagation();
668
+ e.preventDefault();
669
+ break;
670
+ }
671
+ }
672
+
673
+ onBlur(e: React.FocusEvent<HTMLInputElement>): void {
674
+ let { widget } = this.props.instance;
675
+ let dateTimeWidget = widget as DateTimeField;
676
+
677
+ if (!this.state.dropdownOpen)
678
+ this.props.instance.setState({ visited: true });
679
+ else if (dateTimeWidget.focusInputFirst) this.closeDropdown(e);
680
+ if (this.state.focus)
681
+ this.setState({
682
+ focus: false,
683
+ });
684
+ this.onChange(e.target.value, "blur");
685
+ }
686
+
687
+ closeDropdown(e: unknown, callback?: () => void): void {
688
+ if (this.state.dropdownOpen) {
689
+ if (this.scrollableParents)
690
+ this.scrollableParents.forEach((el) => {
691
+ el.removeEventListener("scroll", this.updateDropdownPosition);
692
+ });
693
+
694
+ this.setState({ dropdownOpen: false }, callback);
695
+ this.props.instance.setState({ visited: true });
696
+ } else if (callback) callback();
697
+ }
698
+
699
+ openDropdown(): void {
700
+ let { data } = this.props.instance;
701
+ this.openDropdownOnFocus = false;
702
+
703
+ if (!this.state.dropdownOpen && !(data.disabled || data.readOnly)) {
704
+ this.setState({
705
+ dropdownOpen: true,
706
+ dropdownOpenTime: Date.now(),
707
+ });
708
+ }
709
+ }
710
+
711
+ onClearClick(e: React.MouseEvent): void {
712
+ this.setValue(null);
713
+ e.stopPropagation();
714
+ e.preventDefault();
715
+ }
716
+
717
+ UNSAFE_componentWillReceiveProps(props: DateTimeInputProps): void {
718
+ let { data, state } = props.instance;
719
+ if (
720
+ data.formatted !== this.input.value &&
721
+ (data.formatted !== this.props.data.formatted || !state?.inputError)
722
+ ) {
723
+ this.input.value = data.formatted || "";
724
+ props.instance.setState({
725
+ inputError: false,
726
+ });
727
+ }
728
+
729
+ tooltipParentWillReceiveProps(
730
+ this.input,
731
+ ...getFieldTooltip(this.props.instance),
732
+ );
733
+ }
734
+
735
+ componentDidMount(): void {
736
+ tooltipParentDidMount(this.input, ...getFieldTooltip(this.props.instance));
737
+ autoFocus(this.input, this);
738
+ if (this.props.data.autoOpen) this.openDropdown();
739
+ }
740
+
741
+ componentDidUpdate(): void {
742
+ autoFocus(this.input, this);
743
+ }
744
+
745
+ componentWillUnmount(): void {
746
+ if (
747
+ this.input == getActiveElement() &&
748
+ this.input.value != this.props.data.formatted
749
+ ) {
750
+ this.onChange(this.input.value, "blur");
751
+ }
752
+ tooltipParentWillUnmount(this.props.instance);
753
+ }
754
+
755
+ onChange(inputValue: string, eventType: string): void {
756
+ let { instance, data } = this.props;
757
+ let { widget } = instance;
758
+ let dateTimeWidget = widget as DateTimeField;
759
+
760
+ if (data.disabled || data.readOnly) return;
761
+
762
+ if (dateTimeWidget.reactOn!.indexOf(eventType) === -1) return;
763
+
764
+ if (eventType == "enter") instance.setState({ visited: true });
765
+
766
+ this.setValue(inputValue, data.value);
767
+ }
768
+
769
+ setValue(text: string | null, baseValue?: unknown): void {
770
+ let { instance, data } = this.props;
771
+ let { widget } = instance;
772
+ let dateTimeWidget = widget as DateTimeField;
773
+
774
+ let date = dateTimeWidget.parseDate(text, instance);
775
+
776
+ instance.setState({
777
+ inputError: isNaN(date as any) && dateTimeWidget.inputErrorText,
778
+ });
779
+
780
+ if (!isNaN(date as any)) {
781
+ let mixed = parseDateInvariant(baseValue as string);
782
+ if (date && baseValue && !isNaN(mixed as any) && dateTimeWidget.partial) {
783
+ switch (dateTimeWidget.segment) {
784
+ case "date":
785
+ mixed.setFullYear(date!.getFullYear());
786
+ mixed.setMonth(date!.getMonth());
787
+ mixed.setDate(date!.getDate());
788
+ break;
789
+
790
+ case "time":
791
+ mixed.setHours(date!.getHours());
792
+ mixed.setMinutes(date!.getMinutes());
793
+ mixed.setSeconds(date!.getSeconds());
794
+ break;
795
+
796
+ default:
797
+ mixed = date;
798
+ break;
799
+ }
800
+
801
+ date = mixed;
802
+ }
803
+
804
+ let encode = dateTimeWidget.encoding || Culture.getDefaultDateEncoding();
805
+
806
+ let value = date ? encode!(date!) : dateTimeWidget.emptyValue;
807
+
808
+ if (!instance.set("value", value))
809
+ this.input.value = value
810
+ ? Format.value(date!, data.format as string)
811
+ : "";
812
+ }
813
+ }
814
+ }