cx 26.4.0 → 26.4.2

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 (598) 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/charts/shapes.d.ts.map +1 -1
  6. package/build/charts/shapes.js +14 -7
  7. package/build/util/innerTextTrim.js +1 -1
  8. package/build/widgets/overlay/ContextMenu.d.ts.map +1 -1
  9. package/build/widgets/overlay/ContextMenu.js +1 -0
  10. package/build/widgets/overlay/Dropdown.d.ts +11 -3
  11. package/build/widgets/overlay/Dropdown.d.ts.map +1 -1
  12. package/build/widgets/overlay/Dropdown.js +52 -25
  13. package/build/widgets/overlay/Overlay.d.ts.map +1 -1
  14. package/build/widgets/overlay/Overlay.js +1 -1
  15. package/build.js +133 -133
  16. package/dist/charts.js +80 -45
  17. package/dist/manifest.js +806 -806
  18. package/dist/util.js +1 -1
  19. package/dist/widgets.css +13 -12
  20. package/dist/widgets.js +215 -85
  21. package/package.json +101 -100
  22. package/src/charts/Bar.scss +32 -32
  23. package/src/charts/Bar.ts +114 -114
  24. package/src/charts/BarGraph.tsx +145 -145
  25. package/src/charts/BubbleGraph.scss +35 -35
  26. package/src/charts/BubbleGraph.tsx +165 -165
  27. package/src/charts/Chart.ts +110 -110
  28. package/src/charts/ColorMap.ts +150 -150
  29. package/src/charts/Column.scss +32 -32
  30. package/src/charts/Column.ts +124 -124
  31. package/src/charts/ColumnBarBase.tsx +309 -309
  32. package/src/charts/ColumnBarGraphBase.tsx +229 -229
  33. package/src/charts/ColumnGraph.scss +32 -32
  34. package/src/charts/ColumnGraph.tsx +153 -153
  35. package/src/charts/Grid.ts +5 -5
  36. package/src/charts/Gridlines.scss +27 -27
  37. package/src/charts/Gridlines.tsx +88 -88
  38. package/src/charts/Legend.tsx +314 -314
  39. package/src/charts/LegendEntry.tsx +197 -197
  40. package/src/charts/LineGraph.tsx +455 -455
  41. package/src/charts/Marker.scss +46 -46
  42. package/src/charts/Marker.tsx +538 -538
  43. package/src/charts/MarkerLine.scss +23 -23
  44. package/src/charts/MarkerLine.tsx +233 -233
  45. package/src/charts/MouseTracker.tsx +115 -115
  46. package/src/charts/Pie.ts +8 -8
  47. package/src/charts/PieChart.scss +32 -32
  48. package/src/charts/PieChart.tsx +843 -843
  49. package/src/charts/PieLabel.tsx +124 -124
  50. package/src/charts/PieLabelsContainer.ts +68 -68
  51. package/src/charts/Range.scss +23 -23
  52. package/src/charts/Range.tsx +318 -318
  53. package/src/charts/RangeMarker.scss +17 -17
  54. package/src/charts/RangeMarker.tsx +250 -250
  55. package/src/charts/ScatterGraph.scss +27 -27
  56. package/src/charts/ScatterGraph.tsx +245 -245
  57. package/src/charts/Swimlane.scss +19 -19
  58. package/src/charts/Swimlane.tsx +195 -195
  59. package/src/charts/Swimlanes.scss +19 -19
  60. package/src/charts/Swimlanes.tsx +179 -179
  61. package/src/charts/axis/Axis.scss +24 -24
  62. package/src/charts/axis/Axis.tsx +444 -444
  63. package/src/charts/axis/CategoryAxis.scss +37 -37
  64. package/src/charts/axis/CategoryAxis.tsx +313 -313
  65. package/src/charts/axis/NumericAxis.scss +38 -38
  66. package/src/charts/axis/NumericAxis.tsx +437 -437
  67. package/src/charts/axis/Stack.ts +61 -61
  68. package/src/charts/axis/TimeAxis.scss +37 -37
  69. package/src/charts/axis/TimeAxis.tsx +834 -834
  70. package/src/charts/axis/index.scss +4 -4
  71. package/src/charts/axis/index.ts +3 -3
  72. package/src/charts/axis/variables.scss +5 -5
  73. package/src/charts/helpers/MinMaxFinder.ts +66 -66
  74. package/src/charts/helpers/PointReducer.ts +135 -135
  75. package/src/charts/helpers/index.ts +4 -4
  76. package/src/charts/index.scss +21 -21
  77. package/src/charts/index.ts +34 -34
  78. package/src/charts/palette.scss +77 -77
  79. package/src/charts/palette.variables.scss +23 -23
  80. package/src/charts/shapes.tsx +93 -86
  81. package/src/charts/variables.scss +53 -53
  82. package/src/core.d.ts +182 -182
  83. package/src/data/AggregateFunction.ts +171 -171
  84. package/src/data/ArrayElementView.spec.ts +88 -88
  85. package/src/data/ArrayElementView.ts +91 -91
  86. package/src/data/ArrayRef.ts +34 -34
  87. package/src/data/AugmentedViewBase.ts +88 -88
  88. package/src/data/Binding.spec.ts +69 -69
  89. package/src/data/Binding.ts +107 -107
  90. package/src/data/ExposedRecordView.ts +95 -95
  91. package/src/data/ExposedValueView.ts +89 -89
  92. package/src/data/Expression.spec.ts +229 -229
  93. package/src/data/Expression.ts +233 -233
  94. package/src/data/Grouper.spec.ts +57 -57
  95. package/src/data/Grouper.ts +158 -158
  96. package/src/data/NestedDataView.ts +43 -43
  97. package/src/data/ReadOnlyDataView.ts +39 -39
  98. package/src/data/Ref.spec.ts +79 -79
  99. package/src/data/Ref.ts +104 -104
  100. package/src/data/Selector.ts +10 -10
  101. package/src/data/Store.spec.ts +22 -22
  102. package/src/data/Store.ts +52 -52
  103. package/src/data/StoreProxy.ts +19 -19
  104. package/src/data/StoreRef.spec.ts +24 -24
  105. package/src/data/StoreRef.ts +66 -66
  106. package/src/data/StringTemplate.spec.ts +132 -132
  107. package/src/data/StringTemplate.ts +93 -93
  108. package/src/data/StructuredSelector.spec.ts +113 -113
  109. package/src/data/StructuredSelector.ts +146 -146
  110. package/src/data/SubscribableView.ts +63 -63
  111. package/src/data/View.spec.ts +60 -60
  112. package/src/data/View.ts +346 -346
  113. package/src/data/ZoomIntoPropertyView.spec.ts +64 -64
  114. package/src/data/ZoomIntoPropertyView.ts +45 -45
  115. package/src/data/comparer.spec.ts +60 -60
  116. package/src/data/comparer.ts +78 -78
  117. package/src/data/computable.spec.ts +87 -87
  118. package/src/data/computable.ts +69 -69
  119. package/src/data/createAccessorModelProxy.spec.tsx +157 -157
  120. package/src/data/createStructuredSelector.spec.ts +45 -45
  121. package/src/data/createStructuredSelector.ts +62 -62
  122. package/src/data/defaultCompare.ts +14 -14
  123. package/src/data/diff/diffArrays.ts +49 -49
  124. package/src/data/diff/diffs.spec.ts +49 -49
  125. package/src/data/diff/index.ts +1 -1
  126. package/src/data/enableFatArrowExpansion.ts +6 -6
  127. package/src/data/getAccessor.spec.ts +11 -11
  128. package/src/data/getAccessor.ts +74 -74
  129. package/src/data/getSelector.spec.ts +43 -43
  130. package/src/data/getSelector.ts +66 -66
  131. package/src/data/index.ts +30 -30
  132. package/src/data/isSelector.ts +26 -26
  133. package/src/data/ops/append.spec.ts +28 -28
  134. package/src/data/ops/append.ts +5 -5
  135. package/src/data/ops/filter.spec.ts +35 -35
  136. package/src/data/ops/filter.ts +9 -9
  137. package/src/data/ops/findTreeNode.spec.ts +23 -23
  138. package/src/data/ops/findTreeNode.ts +33 -33
  139. package/src/data/ops/findTreePath.ts +28 -28
  140. package/src/data/ops/index.ts +11 -11
  141. package/src/data/ops/insertElement.ts +3 -3
  142. package/src/data/ops/merge.spec.ts +27 -27
  143. package/src/data/ops/merge.ts +13 -13
  144. package/src/data/ops/moveElement.ts +21 -21
  145. package/src/data/ops/removeTreeNodes.spec.ts +37 -37
  146. package/src/data/ops/removeTreeNodes.ts +28 -28
  147. package/src/data/ops/updateArray.spec.ts +69 -69
  148. package/src/data/ops/updateArray.ts +31 -31
  149. package/src/data/ops/updateTree.spec.ts +54 -54
  150. package/src/data/ops/updateTree.ts +49 -49
  151. package/src/data/test-types.ts +7 -7
  152. package/src/hooks/createLocalStorageRef.ts +21 -21
  153. package/src/hooks/index.ts +8 -8
  154. package/src/hooks/invokeCallback.spec.tsx +59 -59
  155. package/src/hooks/invokeCallback.ts +8 -8
  156. package/src/hooks/resolveCallback.spec.tsx +71 -71
  157. package/src/hooks/resolveCallback.ts +16 -16
  158. package/src/hooks/store.spec.tsx +67 -67
  159. package/src/hooks/store.ts +46 -46
  160. package/src/hooks/useEffect.ts +14 -14
  161. package/src/hooks/useInterval.ts +8 -8
  162. package/src/hooks/useState.ts +20 -20
  163. package/src/hooks/useTrigger.spec.tsx +105 -105
  164. package/src/hooks/useTrigger.ts +26 -26
  165. package/src/index.scss +5 -5
  166. package/src/index.ts +7 -7
  167. package/src/jsx-dev-runtime.ts +4 -4
  168. package/src/jsx-runtime.spec.tsx +508 -508
  169. package/src/jsx-runtime.ts +88 -88
  170. package/src/locale/de-de.ts +76 -76
  171. package/src/locale/en-us.ts +75 -75
  172. package/src/locale/es-es.ts +76 -76
  173. package/src/locale/fr-fr.ts +76 -76
  174. package/src/locale/nl-nl.ts +76 -76
  175. package/src/locale/pt-pt.ts +76 -76
  176. package/src/locale/sr-latn-ba.ts +76 -76
  177. package/src/maps.scss +5 -5
  178. package/src/svg/BoundedObject.ts +101 -101
  179. package/src/svg/ClipRect.tsx +29 -29
  180. package/src/svg/Ellipse.tsx +76 -76
  181. package/src/svg/Line.tsx +73 -73
  182. package/src/svg/NonOverlappingRect.ts +26 -26
  183. package/src/svg/NonOverlappingRectGroup.ts +49 -49
  184. package/src/svg/Rectangle.tsx +98 -98
  185. package/src/svg/Svg.scss +28 -28
  186. package/src/svg/Svg.tsx +241 -241
  187. package/src/svg/Text.scss +19 -19
  188. package/src/svg/Text.tsx +190 -190
  189. package/src/svg/TextualBoundedObject.ts +35 -35
  190. package/src/svg/index.scss +10 -10
  191. package/src/svg/index.ts +17 -17
  192. package/src/svg/util/Rect.ts +105 -105
  193. package/src/ui/CSS.ts +87 -87
  194. package/src/ui/CSSHelper.ts +17 -17
  195. package/src/ui/Container.spec.ts +87 -87
  196. package/src/ui/Container.tsx +220 -220
  197. package/src/ui/ContentResolver.spec.tsx +585 -585
  198. package/src/ui/ContentResolver.ts +132 -132
  199. package/src/ui/Controller.spec.tsx +604 -604
  200. package/src/ui/Controller.ts +207 -207
  201. package/src/ui/Culture.ts +159 -159
  202. package/src/ui/Cx.spec.tsx +210 -210
  203. package/src/ui/Cx.tsx +386 -386
  204. package/src/ui/DataProxy.spec.tsx +337 -337
  205. package/src/ui/DataProxy.ts +55 -55
  206. package/src/ui/DetachedScope.tsx +159 -159
  207. package/src/ui/FocusManager.ts +171 -171
  208. package/src/ui/Format.ts +108 -108
  209. package/src/ui/HoverSync.tsx +221 -221
  210. package/src/ui/Instance.ts +963 -963
  211. package/src/ui/IsolatedScope.spec.tsx +62 -62
  212. package/src/ui/IsolatedScope.ts +52 -52
  213. package/src/ui/Localization.ts +70 -70
  214. package/src/ui/Prop.ts +141 -141
  215. package/src/ui/PureContainer.spec.tsx +232 -232
  216. package/src/ui/PureContainer.tsx +19 -19
  217. package/src/ui/RenderingContext.ts +99 -99
  218. package/src/ui/Repeater.ts +194 -194
  219. package/src/ui/Rescope.spec.tsx +199 -199
  220. package/src/ui/Rescope.ts +50 -50
  221. package/src/ui/ResizeManager.ts +30 -30
  222. package/src/ui/Restate.spec.tsx +422 -422
  223. package/src/ui/Restate.tsx +217 -217
  224. package/src/ui/StaticText.ts +11 -11
  225. package/src/ui/StructuredInstanceDataAccessor.ts +32 -32
  226. package/src/ui/Text.ts +52 -52
  227. package/src/ui/VDOM.ts +1 -1
  228. package/src/ui/Widget.spec.tsx +53 -53
  229. package/src/ui/Widget.tsx +359 -359
  230. package/src/ui/ZIndexManager.ts +11 -11
  231. package/src/ui/adapter/ArrayAdapter.spec.ts +55 -55
  232. package/src/ui/adapter/ArrayAdapter.ts +229 -229
  233. package/src/ui/adapter/DataAdapter.ts +52 -52
  234. package/src/ui/adapter/GroupAdapter.spec.ts +42 -42
  235. package/src/ui/adapter/GroupAdapter.ts +244 -244
  236. package/src/ui/adapter/TreeAdapter.spec.ts +76 -76
  237. package/src/ui/adapter/TreeAdapter.ts +245 -245
  238. package/src/ui/adapter/index.ts +4 -4
  239. package/src/ui/app/History.ts +147 -147
  240. package/src/ui/app/Url.spec.ts +50 -50
  241. package/src/ui/app/Url.ts +102 -102
  242. package/src/ui/app/index.ts +5 -5
  243. package/src/ui/app/startAppLoop.tsx +82 -82
  244. package/src/ui/app/startHotAppLoop.ts +41 -41
  245. package/src/ui/batchUpdates.ts +72 -72
  246. package/src/ui/bind.ts +10 -10
  247. package/src/ui/createFunctionalComponent.spec.tsx +605 -605
  248. package/src/ui/createFunctionalComponent.ts +96 -96
  249. package/src/ui/expr.ts +47 -47
  250. package/src/ui/exprHelpers.spec.ts +412 -412
  251. package/src/ui/exprHelpers.ts +96 -96
  252. package/src/ui/flattenProps.ts +21 -21
  253. package/src/ui/index.scss +2 -2
  254. package/src/ui/index.ts +51 -51
  255. package/src/ui/keyboardShortcuts.ts +50 -50
  256. package/src/ui/layout/Content.ts +30 -30
  257. package/src/ui/layout/ContentPlaceholder.spec.tsx +599 -599
  258. package/src/ui/layout/ContentPlaceholder.ts +133 -133
  259. package/src/ui/layout/FirstVisibleChildLayout.spec.tsx +207 -207
  260. package/src/ui/layout/FirstVisibleChildLayout.ts +60 -60
  261. package/src/ui/layout/LabelsLeftLayout.scss +45 -45
  262. package/src/ui/layout/LabelsLeftLayout.tsx +76 -76
  263. package/src/ui/layout/LabelsTopLayout.scss +73 -73
  264. package/src/ui/layout/LabelsTopLayout.tsx +156 -156
  265. package/src/ui/layout/UseParentLayout.ts +8 -8
  266. package/src/ui/layout/exploreChildren.ts +38 -38
  267. package/src/ui/layout/index.scss +2 -2
  268. package/src/ui/layout/index.ts +10 -10
  269. package/src/ui/layout/variables.scss +2 -2
  270. package/src/ui/selection/KeySelection.ts +153 -153
  271. package/src/ui/selection/PropertySelection.ts +87 -87
  272. package/src/ui/selection/Selection.ts +128 -128
  273. package/src/ui/selection/index.ts +3 -3
  274. package/src/ui/tpl.spec.ts +69 -69
  275. package/src/ui/tpl.ts +17 -17
  276. package/src/ui/variables.scss +1 -1
  277. package/src/util/Component.spec.ts +494 -494
  278. package/src/util/Component.ts +352 -352
  279. package/src/util/Console.ts +13 -13
  280. package/src/util/DOM.ts +88 -88
  281. package/src/util/Debug.ts +71 -71
  282. package/src/util/Format.spec.ts +69 -69
  283. package/src/util/Format.ts +267 -267
  284. package/src/util/GlobalCacheIdentifier.ts +11 -11
  285. package/src/util/KeyCode.ts +21 -21
  286. package/src/util/SubscriberList.ts +86 -86
  287. package/src/util/Timing.ts +58 -58
  288. package/src/util/TraversalStack.spec.ts +53 -53
  289. package/src/util/TraversalStack.ts +47 -47
  290. package/src/util/addEventListenerWithOptions.ts +41 -41
  291. package/src/util/browserSupportsPassiveEventHandlers.ts +20 -20
  292. package/src/util/calculateNaturalElementHeight.ts +22 -22
  293. package/src/util/call-once.scss +6 -6
  294. package/src/util/capitalize.ts +4 -4
  295. package/src/util/coalesce.ts +6 -6
  296. package/src/util/color/hslToRgb.ts +34 -34
  297. package/src/util/color/index.ts +4 -4
  298. package/src/util/color/parseColor.ts +173 -173
  299. package/src/util/color/rgbToHex.ts +14 -14
  300. package/src/util/color/rgbToHsl.ts +35 -35
  301. package/src/util/date/dateDiff.ts +9 -9
  302. package/src/util/date/diff.ts +13 -13
  303. package/src/util/date/encodeDate.ts +8 -8
  304. package/src/util/date/encodeDateWithTimezoneOffset.ts +18 -18
  305. package/src/util/date/index.ts +11 -11
  306. package/src/util/date/lowerBoundCheck.ts +13 -13
  307. package/src/util/date/maxDate.ts +14 -14
  308. package/src/util/date/minDate.ts +14 -14
  309. package/src/util/date/monthStart.ts +8 -8
  310. package/src/util/date/parseDateInvariant.ts +20 -20
  311. package/src/util/date/sameDate.ts +11 -11
  312. package/src/util/date/upperBoundCheck.spec.ts +30 -30
  313. package/src/util/date/upperBoundCheck.ts +13 -13
  314. package/src/util/date/zeroTime.ts +9 -9
  315. package/src/util/debounce.ts +26 -26
  316. package/src/util/dummyCallback.ts +1 -1
  317. package/src/util/escapeSpecialRegexCharacters.ts +8 -8
  318. package/src/util/eventCallbacks.ts +12 -12
  319. package/src/util/expandFatArrows.ts +118 -118
  320. package/src/util/findScrollableParent.ts +15 -15
  321. package/src/util/getActiveElement.ts +4 -4
  322. package/src/util/getParentFrameBoundingClientRect.ts +13 -13
  323. package/src/util/getScrollerBoundingClientRect.ts +12 -12
  324. package/src/util/getSearchQueryPredicate.spec.ts +40 -40
  325. package/src/util/getSearchQueryPredicate.ts +58 -58
  326. package/src/util/getTopLevelBoundingClientRect.ts +7 -7
  327. package/src/util/getVendorPrefix.ts +38 -38
  328. package/src/util/hasKey.ts +18 -18
  329. package/src/util/index.scss +13 -13
  330. package/src/util/index.ts +55 -55
  331. package/src/util/innerTextTrim.ts +10 -10
  332. package/src/util/isArray.ts +3 -3
  333. package/src/util/isDataRecord.ts +5 -5
  334. package/src/util/isDefined.ts +3 -3
  335. package/src/util/isDigit.ts +8 -8
  336. package/src/util/isFunction.ts +3 -3
  337. package/src/util/isNonEmptyArray.ts +3 -3
  338. package/src/util/isNumber.ts +3 -3
  339. package/src/util/isObject.ts +3 -3
  340. package/src/util/isPromise.ts +6 -6
  341. package/src/util/isString.ts +3 -3
  342. package/src/util/isTextInputElement.ts +2 -2
  343. package/src/util/isTouchDevice.ts +7 -7
  344. package/src/util/isTouchEvent.ts +64 -64
  345. package/src/util/isUndefined.ts +3 -3
  346. package/src/util/isValidIdentifierName.spec.ts +33 -33
  347. package/src/util/isValidIdentifierName.ts +5 -5
  348. package/src/util/maps.scss +1 -1
  349. package/src/util/onIdleCallback.ts +10 -10
  350. package/src/util/parseStyle.ts +29 -29
  351. package/src/util/quote.ts +6 -6
  352. package/src/util/reverseSlice.ts +9 -9
  353. package/src/util/routeAppend.spec.ts +19 -19
  354. package/src/util/routeAppend.ts +15 -15
  355. package/src/util/scrollElementIntoView.ts +40 -40
  356. package/src/util/scss/add-rules.scss +40 -40
  357. package/src/util/scss/besm.scss +15 -15
  358. package/src/util/scss/calc.scss +137 -137
  359. package/src/util/scss/call-once.scss +12 -12
  360. package/src/util/scss/clockwise.scss +49 -49
  361. package/src/util/scss/colors.scss +9 -9
  362. package/src/util/scss/deep-get.scss +11 -11
  363. package/src/util/scss/deep-merge.scss +21 -21
  364. package/src/util/scss/defaults.scss +24 -24
  365. package/src/util/scss/divide.scss +3 -3
  366. package/src/util/scss/elements.scss +78 -78
  367. package/src/util/scss/global.scss +15 -15
  368. package/src/util/scss/index.scss +1 -1
  369. package/src/util/scss/maps.scss +2 -2
  370. package/src/util/scss/pad-size.scss +9 -9
  371. package/src/util/scss/padding.scss +6 -6
  372. package/src/util/scss/screen-size.scss +5 -5
  373. package/src/util/scss/variables.scss +6 -6
  374. package/src/util/shallowEquals.ts +43 -43
  375. package/src/util/test/createTestRenderer.tsx +19 -19
  376. package/src/util/throttle.ts +21 -21
  377. package/src/util/validatedDebounce.ts +23 -23
  378. package/src/util/variables.scss +1 -1
  379. package/src/variables.scss +5 -5
  380. package/src/widgets/AccessorBindings.spec.tsx +90 -90
  381. package/src/widgets/Button.scss +143 -143
  382. package/src/widgets/Button.tsx +181 -181
  383. package/src/widgets/Button.variables.scss +21 -21
  384. package/src/widgets/CxCredit.scss +41 -41
  385. package/src/widgets/CxCredit.tsx +46 -46
  386. package/src/widgets/DocumentTitle.ts +95 -95
  387. package/src/widgets/FlexBox.scss +153 -153
  388. package/src/widgets/FlexBox.tsx +168 -168
  389. package/src/widgets/Heading.scss +46 -46
  390. package/src/widgets/Heading.ts +42 -42
  391. package/src/widgets/HighlightedSearchText.scss +27 -27
  392. package/src/widgets/HighlightedSearchText.tsx +54 -54
  393. package/src/widgets/HtmlElement.spec.helpers.tsx +108 -108
  394. package/src/widgets/HtmlElement.spec.tsx +117 -117
  395. package/src/widgets/HtmlElement.tsx +468 -468
  396. package/src/widgets/Icon.scss +28 -28
  397. package/src/widgets/Icon.ts +64 -64
  398. package/src/widgets/List.scss +100 -100
  399. package/src/widgets/List.tsx +792 -792
  400. package/src/widgets/ProgressBar.scss +64 -64
  401. package/src/widgets/ProgressBar.tsx +66 -66
  402. package/src/widgets/ReactElementWrapper.spec.tsx +452 -452
  403. package/src/widgets/ReactElementWrapper.tsx +108 -108
  404. package/src/widgets/Resizer.scss +46 -46
  405. package/src/widgets/Resizer.tsx +200 -200
  406. package/src/widgets/Sandbox.ts +104 -104
  407. package/src/widgets/Section.scss +53 -53
  408. package/src/widgets/Section.tsx +187 -187
  409. package/src/widgets/animations.scss +13 -13
  410. package/src/widgets/autoFocus.ts +9 -9
  411. package/src/widgets/box.scss +47 -47
  412. package/src/widgets/cx.ts +63 -63
  413. package/src/widgets/drag-drop/DragClone.scss +44 -44
  414. package/src/widgets/drag-drop/DragHandle.scss +25 -25
  415. package/src/widgets/drag-drop/DragHandle.tsx +47 -47
  416. package/src/widgets/drag-drop/DragSource.scss +33 -33
  417. package/src/widgets/drag-drop/DragSource.tsx +237 -237
  418. package/src/widgets/drag-drop/DropZone.scss +83 -83
  419. package/src/widgets/drag-drop/DropZone.tsx +353 -353
  420. package/src/widgets/drag-drop/index.scss +4 -4
  421. package/src/widgets/drag-drop/index.ts +4 -4
  422. package/src/widgets/drag-drop/maps.scss +7 -7
  423. package/src/widgets/drag-drop/ops.tsx +422 -422
  424. package/src/widgets/drag-drop/variables.scss +17 -17
  425. package/src/widgets/enableAllInternalDependencies.ts +11 -11
  426. package/src/widgets/form/Calendar.maps.scss +54 -54
  427. package/src/widgets/form/Calendar.scss +237 -237
  428. package/src/widgets/form/Calendar.variables.scss +21 -21
  429. package/src/widgets/form/Checkbox.maps.scss +34 -34
  430. package/src/widgets/form/Checkbox.scss +140 -140
  431. package/src/widgets/form/Checkbox.tsx +340 -340
  432. package/src/widgets/form/Checkbox.variables.scss +8 -8
  433. package/src/widgets/form/ColorField.scss +112 -112
  434. package/src/widgets/form/ColorField.tsx +551 -551
  435. package/src/widgets/form/ColorPicker.maps.scss +21 -21
  436. package/src/widgets/form/ColorPicker.scss +302 -302
  437. package/src/widgets/form/ColorPicker.tsx +606 -606
  438. package/src/widgets/form/ColorPicker.variables.scss +9 -9
  439. package/src/widgets/form/DateField.ts +21 -21
  440. package/src/widgets/form/DateTimeField.scss +111 -111
  441. package/src/widgets/form/DateTimeField.tsx +814 -814
  442. package/src/widgets/form/DateTimePicker.scss +57 -57
  443. package/src/widgets/form/DateTimePicker.tsx +429 -429
  444. package/src/widgets/form/Field.maps.scss +122 -122
  445. package/src/widgets/form/Field.scss +200 -200
  446. package/src/widgets/form/Field.tsx +715 -715
  447. package/src/widgets/form/Field.variables.scss +46 -46
  448. package/src/widgets/form/FieldGroup.ts +10 -10
  449. package/src/widgets/form/FieldIcon.ts +61 -61
  450. package/src/widgets/form/HelpText.scss +27 -27
  451. package/src/widgets/form/HelpText.ts +15 -15
  452. package/src/widgets/form/Label.scss +45 -45
  453. package/src/widgets/form/Label.tsx +117 -117
  454. package/src/widgets/form/LabeledContainer.ts +77 -77
  455. package/src/widgets/form/LookupField.maps.scss +26 -26
  456. package/src/widgets/form/LookupField.spec.tsx +93 -93
  457. package/src/widgets/form/LookupField.tsx +1689 -1689
  458. package/src/widgets/form/MonthField.scss +113 -113
  459. package/src/widgets/form/MonthField.tsx +748 -748
  460. package/src/widgets/form/MonthPicker.maps.scss +50 -50
  461. package/src/widgets/form/MonthPicker.scss +134 -134
  462. package/src/widgets/form/MonthPicker.tsx +1061 -1061
  463. package/src/widgets/form/MonthPicker.variables.scss +24 -24
  464. package/src/widgets/form/NumberField.scss +72 -72
  465. package/src/widgets/form/NumberField.tsx +653 -653
  466. package/src/widgets/form/Radio.maps.scss +36 -36
  467. package/src/widgets/form/Radio.scss +133 -133
  468. package/src/widgets/form/Radio.tsx +249 -249
  469. package/src/widgets/form/Radio.variables.scss +7 -7
  470. package/src/widgets/form/Select.scss +104 -104
  471. package/src/widgets/form/Select.tsx +327 -327
  472. package/src/widgets/form/Slider.scss +130 -130
  473. package/src/widgets/form/Slider.tsx +473 -473
  474. package/src/widgets/form/Switch.scss +152 -152
  475. package/src/widgets/form/Switch.tsx +176 -176
  476. package/src/widgets/form/TextArea.scss +58 -58
  477. package/src/widgets/form/TextArea.tsx +229 -229
  478. package/src/widgets/form/TextField.scss +66 -66
  479. package/src/widgets/form/TextField.tsx +453 -453
  480. package/src/widgets/form/TimeField.ts +10 -10
  481. package/src/widgets/form/TimeList.tsx +105 -105
  482. package/src/widgets/form/UploadButton.scss +57 -57
  483. package/src/widgets/form/UploadButton.tsx +387 -387
  484. package/src/widgets/form/ValidationError.scss +27 -27
  485. package/src/widgets/form/ValidationError.tsx +81 -81
  486. package/src/widgets/form/ValidationGroup.spec.tsx +147 -147
  487. package/src/widgets/form/ValidationGroup.ts +141 -141
  488. package/src/widgets/form/Validator.ts +60 -60
  489. package/src/widgets/form/Wheel.scss +164 -164
  490. package/src/widgets/form/Wheel.tsx +309 -309
  491. package/src/widgets/form/index.scss +22 -22
  492. package/src/widgets/form/index.ts +28 -28
  493. package/src/widgets/form/maps.scss +81 -81
  494. package/src/widgets/form/variables.scss +114 -114
  495. package/src/widgets/grid/Grid.spec.ts +42 -42
  496. package/src/widgets/grid/Grid.tsx +4269 -4269
  497. package/src/widgets/grid/GridCell.ts +143 -143
  498. package/src/widgets/grid/GridCellEditor.tsx +58 -58
  499. package/src/widgets/grid/GridRow.ts +302 -302
  500. package/src/widgets/grid/GridRowLine.ts +49 -49
  501. package/src/widgets/grid/Pagination.scss +124 -124
  502. package/src/widgets/grid/Pagination.tsx +134 -134
  503. package/src/widgets/grid/TreeNode.scss +107 -107
  504. package/src/widgets/grid/TreeNode.tsx +165 -165
  505. package/src/widgets/grid/createGridCellEditor.tsx +18 -18
  506. package/src/widgets/grid/index.scss +3 -3
  507. package/src/widgets/grid/index.ts +16 -16
  508. package/src/widgets/grid/maps.scss +110 -110
  509. package/src/widgets/icons/arrow-down.svg +3 -3
  510. package/src/widgets/icons/arrow-right.svg +2 -2
  511. package/src/widgets/icons/base.svg +104 -104
  512. package/src/widgets/icons/calendar-old.svg +169 -169
  513. package/src/widgets/icons/calendar.svg +187 -187
  514. package/src/widgets/icons/calendar.tsx +22 -22
  515. package/src/widgets/icons/check.tsx +14 -14
  516. package/src/widgets/icons/clear.svg +74 -74
  517. package/src/widgets/icons/clear.tsx +16 -16
  518. package/src/widgets/icons/close.svg +74 -74
  519. package/src/widgets/icons/close.tsx +20 -20
  520. package/src/widgets/icons/cx.tsx +39 -39
  521. package/src/widgets/icons/drop-down.tsx +16 -16
  522. package/src/widgets/icons/dropdown-arrow.svg +61 -61
  523. package/src/widgets/icons/file.svg +4 -4
  524. package/src/widgets/icons/file.tsx +14 -14
  525. package/src/widgets/icons/folder-open.svg +5 -5
  526. package/src/widgets/icons/folder-open.tsx +16 -16
  527. package/src/widgets/icons/folder.svg +58 -58
  528. package/src/widgets/icons/folder.tsx +13 -13
  529. package/src/widgets/icons/forward.svg +67 -67
  530. package/src/widgets/icons/forward.tsx +26 -26
  531. package/src/widgets/icons/index.ts +14 -14
  532. package/src/widgets/icons/loading.svg +4 -4
  533. package/src/widgets/icons/loading.tsx +28 -28
  534. package/src/widgets/icons/menu.tsx +18 -18
  535. package/src/widgets/icons/pixel-picker.tsx +18 -18
  536. package/src/widgets/icons/registry.ts +56 -56
  537. package/src/widgets/icons/search.svg +107 -107
  538. package/src/widgets/icons/search.tsx +14 -14
  539. package/src/widgets/icons/sort-asc.svg +3 -3
  540. package/src/widgets/icons/sort-asc.tsx +15 -15
  541. package/src/widgets/icons/square.tsx +22 -22
  542. package/src/widgets/index.d.ts +55 -55
  543. package/src/widgets/index.scss +16 -16
  544. package/src/widgets/lists.scss +42 -42
  545. package/src/widgets/maps.scss +139 -139
  546. package/src/widgets/nav/Link.scss +33 -33
  547. package/src/widgets/nav/Link.ts +11 -11
  548. package/src/widgets/nav/LinkButton.ts +176 -176
  549. package/src/widgets/nav/Menu.scss +82 -82
  550. package/src/widgets/nav/Menu.tsx +497 -497
  551. package/src/widgets/nav/Menu.variables.scss +13 -13
  552. package/src/widgets/nav/MenuItem.tsx +525 -525
  553. package/src/widgets/nav/MenuSpacer.ts +18 -18
  554. package/src/widgets/nav/RedirectRoute.ts +49 -49
  555. package/src/widgets/nav/Route.spec.tsx +24 -24
  556. package/src/widgets/nav/Route.ts +142 -142
  557. package/src/widgets/nav/Scroller.scss +157 -157
  558. package/src/widgets/nav/Scroller.tsx +252 -252
  559. package/src/widgets/nav/Submenu.ts +6 -6
  560. package/src/widgets/nav/Tab.maps.scss +78 -78
  561. package/src/widgets/nav/Tab.scss +88 -88
  562. package/src/widgets/nav/Tab.variables.scss +15 -15
  563. package/src/widgets/nav/cover.scss +24 -24
  564. package/src/widgets/nav/index.scss +6 -6
  565. package/src/widgets/nav/index.ts +10 -10
  566. package/src/widgets/nav/maps.scss +32 -32
  567. package/src/widgets/nav/variables.scss +19 -19
  568. package/src/widgets/overlay/ContextMenu.ts +46 -45
  569. package/src/widgets/overlay/Dropdown.scss +218 -217
  570. package/src/widgets/overlay/Dropdown.tsx +980 -937
  571. package/src/widgets/overlay/FlyweightTooltipTracker.ts +91 -91
  572. package/src/widgets/overlay/MsgBox.tsx +155 -155
  573. package/src/widgets/overlay/Overlay.scss +88 -88
  574. package/src/widgets/overlay/Overlay.tsx +1 -0
  575. package/src/widgets/overlay/Toast.scss +172 -172
  576. package/src/widgets/overlay/Toast.ts +121 -121
  577. package/src/widgets/overlay/Tooltip.scss +108 -108
  578. package/src/widgets/overlay/Tooltip.tsx +460 -460
  579. package/src/widgets/overlay/Window.maps.scss +51 -51
  580. package/src/widgets/overlay/Window.scss +129 -129
  581. package/src/widgets/overlay/Window.tsx +320 -320
  582. package/src/widgets/overlay/Window.variables.scss +21 -21
  583. package/src/widgets/overlay/alerts.ts +46 -46
  584. package/src/widgets/overlay/captureMouse.scss +13 -13
  585. package/src/widgets/overlay/captureMouse.ts +195 -195
  586. package/src/widgets/overlay/createHotPromiseWindowFactory.ts +71 -71
  587. package/src/widgets/overlay/index.d.ts +11 -11
  588. package/src/widgets/overlay/index.scss +6 -6
  589. package/src/widgets/overlay/index.ts +11 -11
  590. package/src/widgets/overlay/maps.scss +44 -44
  591. package/src/widgets/overlay/tooltip-ops.ts +173 -173
  592. package/src/widgets/overlay/variables.scss +53 -53
  593. package/tsconfig.compile.json +4 -4
  594. package/tsconfig.json +35 -35
  595. package/tsconfig.mocha.json +14 -14
  596. package/build/widgets/form/Test.d.ts +0 -4
  597. package/build/widgets/form/Test.d.ts.map +0 -1
  598. package/build/widgets/form/Test.js +0 -5
@@ -1,453 +1,453 @@
1
- /** @jsxImportSource react */
2
-
3
- import { Instance } from "../../ui/Instance";
4
- import { BooleanProp, NumberProp, Prop, StringProp } from "../../ui/Prop";
5
- import { Widget, getContent } from "../../ui/Widget";
6
- import { Field, FieldConfig, getFieldTooltip } from "./Field";
7
-
8
- export interface TextFieldConfig extends FieldConfig {
9
- /** Textual value of the input field. */
10
- value?: Prop<any>;
11
-
12
- /** Default text displayed when the field is empty. */
13
- placeholder?: StringProp;
14
-
15
- /** Defaults to `false`. Used to make the field read-only. */
16
- readOnly?: BooleanProp;
17
-
18
- /** Defaults to `false`. Used to make the field required. */
19
- required?: BooleanProp;
20
-
21
- /** Minimal length of the input text. */
22
- minLength?: NumberProp;
23
-
24
- /** Maximal length of the input text. */
25
- maxLength?: NumberProp;
26
-
27
- /** Regular expression used to validate the user's input. */
28
- validationRegExp?: Prop<RegExp>;
29
-
30
- /** Error message displayed upon validation failure. */
31
- validationErrorText?: StringProp;
32
-
33
- /** Error message displayed when input text is too short. */
34
- minLengthValidationErrorText?: StringProp;
35
-
36
- /** Error message displayed when input text is too long. */
37
- maxLengthValidationErrorText?: StringProp;
38
-
39
- /** Event triggering value updates. Possible values are `input` (default), `enter`, or `blur`. Multiple values can be separated by space. */
40
- reactOn?: StringProp;
41
-
42
- /** Input type. Defaults to `text`. Other common value is `password`. */
43
- inputType?: StringProp;
44
-
45
- /** Base CSS class to be applied to the field. Defaults to `textfield`. */
46
- baseClass?: string;
47
-
48
- /** Keyboard shortcut used to focus the field. */
49
- keyboardShortcut?: StringProp;
50
-
51
- /** Set to `true` to remove leading and trailing whitespace. Default is `false`. */
52
- trim?: BooleanProp;
53
-
54
- /** Set to `true` to hide the clear button. Default value is `false`. */
55
- hideClear?: BooleanProp;
56
-
57
- /** Set to `false` to hide the clear button. Default value is `true`. */
58
- showClear?: BooleanProp;
59
-
60
- /** Set to `true` to display the clear button even if `required` is set. Default is `false`. */
61
- alwaysShowClear?: BooleanProp;
62
-
63
- /** Name or configuration of the icon to be put on the left side of the input. */
64
- icon?: string | FieldIconConfig;
65
-
66
- /** Additional attributes to be passed to the input element. */
67
- inputAttrs?: Prop<any>;
68
-
69
- /** If `trackFocus` is set, this value will be set when the field receives or loses focus. */
70
- focused?: BooleanProp;
71
-
72
- /** Callback invoked when the field receives focus. */
73
- onFocus?: string | ((e: FocusEvent, instance: Instance) => void);
74
-
75
- /** Callback invoked when the field loses focus. */
76
- onBlur?: string | ((e: FocusEvent, instance: Instance) => void);
77
-
78
- /** Handler triggered on key down events. Return `false` to prevent default behavior. */
79
- onKeyDown?:
80
- | string
81
- | ((e: React.KeyboardEvent, instance: Instance) => boolean | void);
82
-
83
- /** Custom validation function. Can return a Promise for async validation. */
84
- onValidate?:
85
- | string
86
- | ((
87
- value: string,
88
- instance: Instance,
89
- validationParams: any,
90
- ) => string | undefined | false | Promise<string | undefined | false>);
91
- }
92
-
93
- // Legacy alias for backward compatibility
94
- export interface TextFieldProps extends TextFieldConfig {}
95
-
96
- import { StringTemplate } from "../../data/StringTemplate";
97
- import { Localization } from "../../ui/Localization";
98
- import { VDOM } from "../../ui/VDOM";
99
- import { preventDefault, stopPropagation } from "../../util/eventCallbacks";
100
- import { getActiveElement } from "../../util/getActiveElement";
101
- import { isString } from "../../util/isString";
102
- import { KeyCode } from "../../util/KeyCode";
103
- import { autoFocus } from "../autoFocus";
104
- import ClearIcon from "../icons/clear";
105
- import {
106
- tooltipMouseLeave,
107
- tooltipMouseMove,
108
- tooltipParentDidMount,
109
- tooltipParentWillReceiveProps,
110
- tooltipParentWillUnmount,
111
- } from "../overlay/tooltip-ops";
112
- import { FieldIconConfig } from "./FieldIcon";
113
-
114
- export class TextField<
115
- Config extends TextFieldConfig = TextFieldConfig,
116
- > extends Field<Config> {
117
- declare public hideClear?: boolean;
118
- declare public showClear?: boolean;
119
- declare public alwaysShowClear?: boolean;
120
- declare public validationRegExp?: RegExp;
121
- declare public validationErrorText?: string;
122
- declare public minLengthValidationErrorText: string;
123
- declare public maxLengthValidationErrorText: string;
124
- declare public reactOn: string;
125
- declare public inputType?: string;
126
- declare public keyboardShortcut?: string;
127
- declare public trim?: boolean;
128
-
129
- public init(): void {
130
- if (typeof this.hideClear !== "undefined") this.showClear = !this.hideClear;
131
-
132
- if (this.alwaysShowClear) this.showClear = true;
133
-
134
- super.init();
135
- }
136
-
137
- public declareData(...args: any[]): void {
138
- super.declareData(
139
- {
140
- value: this.emptyValue,
141
- disabled: undefined,
142
- readOnly: undefined,
143
- enabled: undefined,
144
- placeholder: undefined,
145
- required: undefined,
146
- minLength: undefined,
147
- maxLength: undefined,
148
- trim: undefined,
149
- inputType: undefined,
150
- },
151
- ...args,
152
- );
153
- }
154
-
155
- public renderInput(context: any, instance: any, key?: any): any {
156
- return (
157
- <Input
158
- key={key}
159
- instance={instance}
160
- data={instance.data}
161
- label={
162
- this.labelPlacement &&
163
- getContent(this.renderLabel(context, instance, "label"))
164
- }
165
- help={
166
- this.helpPlacement &&
167
- getContent(this.renderHelp(context, instance, "help"))
168
- }
169
- icon={this.renderIcon(context, instance, "icon")}
170
- />
171
- );
172
- }
173
-
174
- public validate(context: any, instance: any): void {
175
- super.validate(context, instance);
176
-
177
- let { data } = instance;
178
-
179
- if (!data.error && data.value) {
180
- if (this.validationRegExp) this.validationRegExp.lastIndex = 0;
181
- if (this.validationRegExp && !this.validationRegExp.test(data.value))
182
- data.error = this.validationErrorText;
183
- else if (
184
- typeof data.value === "string" &&
185
- data.minLength != null &&
186
- data.value.length < data.minLength
187
- )
188
- data.error = StringTemplate.format(
189
- this.minLengthValidationErrorText,
190
- data.minLength,
191
- data.value.length,
192
- );
193
- else if (
194
- typeof data.value === "string" &&
195
- data.maxLength != null &&
196
- data.value.length > data.maxLength
197
- )
198
- data.error = StringTemplate.format(
199
- this.maxLengthValidationErrorText,
200
- data.maxLength,
201
- data.value.length,
202
- );
203
- }
204
- }
205
- }
206
-
207
- TextField.prototype.baseClass = "textfield";
208
- TextField.prototype.reactOn = "change input blur enter";
209
- TextField.prototype.inputType = "text";
210
- TextField.prototype.validationErrorText = "The entered value is not valid.";
211
- TextField.prototype.minLengthValidationErrorText =
212
- "Enter {[{0}-{1}]} more character(s).";
213
- TextField.prototype.maxLengthValidationErrorText =
214
- "Use {0} characters or fewer.";
215
- TextField.prototype.suppressErrorsUntilVisited = true;
216
- TextField.prototype.icon = null;
217
- TextField.prototype.showClear = false;
218
- TextField.prototype.alwaysShowClear = false;
219
- TextField.prototype.keyboardShortcut = "false";
220
- TextField.prototype.trim = false;
221
-
222
- Localization.registerPrototype("cx/widgets/TextField", TextField);
223
-
224
- class Input extends VDOM.Component<any, any> {
225
- public input?: HTMLInputElement;
226
-
227
- constructor(props: any) {
228
- super(props);
229
- this.state = {
230
- focus: false,
231
- };
232
- }
233
-
234
- render(): any {
235
- let { instance, data, label, help, icon: iconVDOM } = this.props;
236
- let { widget, state } = instance;
237
- let { CSS, baseClass, suppressErrorsUntilVisited } = widget;
238
-
239
- let icon = iconVDOM && (
240
- <div
241
- className={CSS.element(baseClass, "left-icon")}
242
- onMouseDown={preventDefault}
243
- onClick={(e: any) => this.onChange((e.target as any).value, "enter")}
244
- >
245
- {iconVDOM}
246
- </div>
247
- );
248
-
249
- let insideButton;
250
- if (
251
- widget.showClear &&
252
- !data.empty &&
253
- !data.readOnly &&
254
- !data.disabled &&
255
- (widget.alwaysShowClear || !data.required)
256
- ) {
257
- insideButton = (
258
- <div
259
- className={CSS.element(baseClass, "clear")}
260
- onMouseDown={(e: any) => e.preventDefault()}
261
- onClick={(e: any) => this.onClearClick(e)}
262
- >
263
- <ClearIcon className={CSS.element(baseClass, "icon")} />
264
- </div>
265
- );
266
- }
267
-
268
- let empty = this.input ? !this.trimmed(this.input.value) : data.empty;
269
-
270
- return (
271
- <div
272
- className={CSS.expand(
273
- data.classNames,
274
- CSS.state({
275
- visited: state.visited,
276
- focus: this.state.focus,
277
- icon: !!icon,
278
- clear: insideButton != null,
279
- empty: empty && !data.placeholder,
280
- error:
281
- data.error &&
282
- (state.visited || !suppressErrorsUntilVisited || !empty),
283
- }),
284
- )}
285
- style={data.style}
286
- onMouseDown={stopPropagation}
287
- onTouchStart={stopPropagation}
288
- >
289
- <input
290
- ref={(el: HTMLInputElement | null) => {
291
- this.input = el || undefined;
292
- }}
293
- className={CSS.expand(
294
- CSS.element(baseClass, "input"),
295
- data.inputClass,
296
- )}
297
- defaultValue={data.value}
298
- id={data.id}
299
- style={data.inputStyle}
300
- type={data.inputType}
301
- disabled={data.disabled}
302
- readOnly={data.readOnly}
303
- tabIndex={data.tabIndex}
304
- placeholder={data.placeholder}
305
- {...data.inputAttrs}
306
- onMouseMove={this.onMouseMove.bind(this)}
307
- onMouseLeave={this.onMouseLeave.bind(this)}
308
- onInput={(e: any) => this.onChange(e.target.value, "input")}
309
- onChange={(e: any) =>
310
- this.onChange((e.target as any).value, "change")
311
- }
312
- onKeyDown={this.onKeyDown.bind(this)}
313
- onFocus={this.onFocus.bind(this)}
314
- onBlur={this.onBlur.bind(this)}
315
- onClick={stopPropagation}
316
- />
317
- {insideButton}
318
- {icon}
319
- {label}
320
- {help}
321
- </div>
322
- );
323
- }
324
-
325
- onFocus(): void {
326
- let { instance, data } = this.props;
327
- let { widget } = instance;
328
- if (widget.trackFocus) {
329
- this.setState({
330
- focus: true,
331
- });
332
- instance.set("focused", true);
333
- }
334
- if (data.error && data.value) instance.setState({ visited: true });
335
- }
336
-
337
- onBlur(e: any): void {
338
- this.onChange((e.target as any).value, "blur");
339
- if (this.state.focus) {
340
- this.setState({
341
- focus: false,
342
- });
343
- this.props.instance.set("focused", false);
344
- }
345
- }
346
-
347
- onClearClick(_e: any): void {
348
- if (this.input) this.input.value = ""; // prevent onChange call with old text value on blur or component unmount
349
- this.props.instance.set("value", this.props.instance.widget.emptyValue, {
350
- immediate: true,
351
- });
352
- }
353
-
354
- onMouseMove(e: any): void {
355
- const tooltip = getFieldTooltip(this.props.instance);
356
- tooltipMouseMove(e, tooltip[0], tooltip[1], tooltip[2]);
357
- }
358
-
359
- onMouseLeave(e: any): void {
360
- const tooltip = getFieldTooltip(this.props.instance);
361
- tooltipMouseLeave(e, tooltip[0], tooltip[1], tooltip[2]);
362
- }
363
-
364
- componentDidMount(): void {
365
- const tooltip = getFieldTooltip(this.props.instance);
366
- tooltipParentDidMount(this.input!, tooltip[0], tooltip[1], tooltip[2]);
367
- autoFocus(this.input, this);
368
- }
369
-
370
- componentDidUpdate(): void {
371
- autoFocus(this.input, this);
372
- }
373
-
374
- componentWillUnmount(): void {
375
- if (
376
- this.input == getActiveElement() &&
377
- this.input &&
378
- this.input.value != this.props.data.value
379
- )
380
- this.onChange(this.input.value, "blur");
381
- tooltipParentWillUnmount(this.props.instance);
382
- }
383
-
384
- onKeyDown(e: any): void {
385
- let { instance } = this.props;
386
- if (instance.widget.handleKeyDown(e, instance) === false) return;
387
-
388
- switch (e.keyCode) {
389
- case KeyCode.enter:
390
- this.onChange(e.target.value, "enter");
391
- break;
392
-
393
- case KeyCode.left:
394
- case KeyCode.right:
395
- e.stopPropagation();
396
- break;
397
- }
398
- }
399
-
400
- UNSAFE_componentWillReceiveProps(props: any): void {
401
- let { data } = props;
402
- // The second check is required for debouncing, sometimes the value in the store lags after the input
403
- // and update may be caused by some other property, i.e. visited
404
- if (
405
- this.input &&
406
- data.value != this.input.value &&
407
- data.value != this.props.data.value
408
- )
409
- this.input.value = data.value || "";
410
- const tooltip = getFieldTooltip(props.instance);
411
- tooltipParentWillReceiveProps(
412
- this.input!,
413
- tooltip[0],
414
- tooltip[1],
415
- tooltip[2],
416
- );
417
- }
418
-
419
- onChange(textValue: any, change: string): void {
420
- let { instance, data } = this.props;
421
-
422
- let immediate = change == "blur" || change == "enter";
423
-
424
- if (immediate) {
425
- instance.setState({ visited: true });
426
- }
427
-
428
- let { widget } = instance;
429
-
430
- if (widget.reactOn.indexOf(change) != -1) {
431
- let text = this.trimmed(textValue);
432
- if (data.maxLength != null && text.length > data.maxLength) {
433
- text = text.substring(0, data.maxLength);
434
- if (this.input) this.input.value = text;
435
- }
436
-
437
- let value = text || widget.emptyValue;
438
- if (!instance.set("value", value, { immediate })) {
439
- if (this.input && text != this.input.value && immediate)
440
- this.input.value = text;
441
- } else {
442
- if (value) instance.setState({ visited: true });
443
- }
444
- }
445
- }
446
-
447
- trimmed(value: any): any {
448
- if (this.props.data.trim && isString(value)) return value.trim();
449
- return value;
450
- }
451
- }
452
-
453
- Widget.alias("textfield", TextField);
1
+ /** @jsxImportSource react */
2
+
3
+ import { Instance } from "../../ui/Instance";
4
+ import { BooleanProp, NumberProp, Prop, StringProp } from "../../ui/Prop";
5
+ import { Widget, getContent } from "../../ui/Widget";
6
+ import { Field, FieldConfig, getFieldTooltip } from "./Field";
7
+
8
+ export interface TextFieldConfig extends FieldConfig {
9
+ /** Textual value of the input field. */
10
+ value?: Prop<any>;
11
+
12
+ /** Default text displayed when the field is empty. */
13
+ placeholder?: StringProp;
14
+
15
+ /** Defaults to `false`. Used to make the field read-only. */
16
+ readOnly?: BooleanProp;
17
+
18
+ /** Defaults to `false`. Used to make the field required. */
19
+ required?: BooleanProp;
20
+
21
+ /** Minimal length of the input text. */
22
+ minLength?: NumberProp;
23
+
24
+ /** Maximal length of the input text. */
25
+ maxLength?: NumberProp;
26
+
27
+ /** Regular expression used to validate the user's input. */
28
+ validationRegExp?: Prop<RegExp>;
29
+
30
+ /** Error message displayed upon validation failure. */
31
+ validationErrorText?: StringProp;
32
+
33
+ /** Error message displayed when input text is too short. */
34
+ minLengthValidationErrorText?: StringProp;
35
+
36
+ /** Error message displayed when input text is too long. */
37
+ maxLengthValidationErrorText?: StringProp;
38
+
39
+ /** Event triggering value updates. Possible values are `input` (default), `enter`, or `blur`. Multiple values can be separated by space. */
40
+ reactOn?: StringProp;
41
+
42
+ /** Input type. Defaults to `text`. Other common value is `password`. */
43
+ inputType?: StringProp;
44
+
45
+ /** Base CSS class to be applied to the field. Defaults to `textfield`. */
46
+ baseClass?: string;
47
+
48
+ /** Keyboard shortcut used to focus the field. */
49
+ keyboardShortcut?: StringProp;
50
+
51
+ /** Set to `true` to remove leading and trailing whitespace. Default is `false`. */
52
+ trim?: BooleanProp;
53
+
54
+ /** Set to `true` to hide the clear button. Default value is `false`. */
55
+ hideClear?: BooleanProp;
56
+
57
+ /** Set to `false` to hide the clear button. Default value is `true`. */
58
+ showClear?: BooleanProp;
59
+
60
+ /** Set to `true` to display the clear button even if `required` is set. Default is `false`. */
61
+ alwaysShowClear?: BooleanProp;
62
+
63
+ /** Name or configuration of the icon to be put on the left side of the input. */
64
+ icon?: string | FieldIconConfig;
65
+
66
+ /** Additional attributes to be passed to the input element. */
67
+ inputAttrs?: Prop<any>;
68
+
69
+ /** If `trackFocus` is set, this value will be set when the field receives or loses focus. */
70
+ focused?: BooleanProp;
71
+
72
+ /** Callback invoked when the field receives focus. */
73
+ onFocus?: string | ((e: FocusEvent, instance: Instance) => void);
74
+
75
+ /** Callback invoked when the field loses focus. */
76
+ onBlur?: string | ((e: FocusEvent, instance: Instance) => void);
77
+
78
+ /** Handler triggered on key down events. Return `false` to prevent default behavior. */
79
+ onKeyDown?:
80
+ | string
81
+ | ((e: React.KeyboardEvent, instance: Instance) => boolean | void);
82
+
83
+ /** Custom validation function. Can return a Promise for async validation. */
84
+ onValidate?:
85
+ | string
86
+ | ((
87
+ value: string,
88
+ instance: Instance,
89
+ validationParams: any,
90
+ ) => string | undefined | false | Promise<string | undefined | false>);
91
+ }
92
+
93
+ // Legacy alias for backward compatibility
94
+ export interface TextFieldProps extends TextFieldConfig {}
95
+
96
+ import { StringTemplate } from "../../data/StringTemplate";
97
+ import { Localization } from "../../ui/Localization";
98
+ import { VDOM } from "../../ui/VDOM";
99
+ import { preventDefault, stopPropagation } from "../../util/eventCallbacks";
100
+ import { getActiveElement } from "../../util/getActiveElement";
101
+ import { isString } from "../../util/isString";
102
+ import { KeyCode } from "../../util/KeyCode";
103
+ import { autoFocus } from "../autoFocus";
104
+ import ClearIcon from "../icons/clear";
105
+ import {
106
+ tooltipMouseLeave,
107
+ tooltipMouseMove,
108
+ tooltipParentDidMount,
109
+ tooltipParentWillReceiveProps,
110
+ tooltipParentWillUnmount,
111
+ } from "../overlay/tooltip-ops";
112
+ import { FieldIconConfig } from "./FieldIcon";
113
+
114
+ export class TextField<
115
+ Config extends TextFieldConfig = TextFieldConfig,
116
+ > extends Field<Config> {
117
+ declare public hideClear?: boolean;
118
+ declare public showClear?: boolean;
119
+ declare public alwaysShowClear?: boolean;
120
+ declare public validationRegExp?: RegExp;
121
+ declare public validationErrorText?: string;
122
+ declare public minLengthValidationErrorText: string;
123
+ declare public maxLengthValidationErrorText: string;
124
+ declare public reactOn: string;
125
+ declare public inputType?: string;
126
+ declare public keyboardShortcut?: string;
127
+ declare public trim?: boolean;
128
+
129
+ public init(): void {
130
+ if (typeof this.hideClear !== "undefined") this.showClear = !this.hideClear;
131
+
132
+ if (this.alwaysShowClear) this.showClear = true;
133
+
134
+ super.init();
135
+ }
136
+
137
+ public declareData(...args: any[]): void {
138
+ super.declareData(
139
+ {
140
+ value: this.emptyValue,
141
+ disabled: undefined,
142
+ readOnly: undefined,
143
+ enabled: undefined,
144
+ placeholder: undefined,
145
+ required: undefined,
146
+ minLength: undefined,
147
+ maxLength: undefined,
148
+ trim: undefined,
149
+ inputType: undefined,
150
+ },
151
+ ...args,
152
+ );
153
+ }
154
+
155
+ public renderInput(context: any, instance: any, key?: any): any {
156
+ return (
157
+ <Input
158
+ key={key}
159
+ instance={instance}
160
+ data={instance.data}
161
+ label={
162
+ this.labelPlacement &&
163
+ getContent(this.renderLabel(context, instance, "label"))
164
+ }
165
+ help={
166
+ this.helpPlacement &&
167
+ getContent(this.renderHelp(context, instance, "help"))
168
+ }
169
+ icon={this.renderIcon(context, instance, "icon")}
170
+ />
171
+ );
172
+ }
173
+
174
+ public validate(context: any, instance: any): void {
175
+ super.validate(context, instance);
176
+
177
+ let { data } = instance;
178
+
179
+ if (!data.error && data.value) {
180
+ if (this.validationRegExp) this.validationRegExp.lastIndex = 0;
181
+ if (this.validationRegExp && !this.validationRegExp.test(data.value))
182
+ data.error = this.validationErrorText;
183
+ else if (
184
+ typeof data.value === "string" &&
185
+ data.minLength != null &&
186
+ data.value.length < data.minLength
187
+ )
188
+ data.error = StringTemplate.format(
189
+ this.minLengthValidationErrorText,
190
+ data.minLength,
191
+ data.value.length,
192
+ );
193
+ else if (
194
+ typeof data.value === "string" &&
195
+ data.maxLength != null &&
196
+ data.value.length > data.maxLength
197
+ )
198
+ data.error = StringTemplate.format(
199
+ this.maxLengthValidationErrorText,
200
+ data.maxLength,
201
+ data.value.length,
202
+ );
203
+ }
204
+ }
205
+ }
206
+
207
+ TextField.prototype.baseClass = "textfield";
208
+ TextField.prototype.reactOn = "change input blur enter";
209
+ TextField.prototype.inputType = "text";
210
+ TextField.prototype.validationErrorText = "The entered value is not valid.";
211
+ TextField.prototype.minLengthValidationErrorText =
212
+ "Enter {[{0}-{1}]} more character(s).";
213
+ TextField.prototype.maxLengthValidationErrorText =
214
+ "Use {0} characters or fewer.";
215
+ TextField.prototype.suppressErrorsUntilVisited = true;
216
+ TextField.prototype.icon = null;
217
+ TextField.prototype.showClear = false;
218
+ TextField.prototype.alwaysShowClear = false;
219
+ TextField.prototype.keyboardShortcut = "false";
220
+ TextField.prototype.trim = false;
221
+
222
+ Localization.registerPrototype("cx/widgets/TextField", TextField);
223
+
224
+ class Input extends VDOM.Component<any, any> {
225
+ public input?: HTMLInputElement;
226
+
227
+ constructor(props: any) {
228
+ super(props);
229
+ this.state = {
230
+ focus: false,
231
+ };
232
+ }
233
+
234
+ render(): any {
235
+ let { instance, data, label, help, icon: iconVDOM } = this.props;
236
+ let { widget, state } = instance;
237
+ let { CSS, baseClass, suppressErrorsUntilVisited } = widget;
238
+
239
+ let icon = iconVDOM && (
240
+ <div
241
+ className={CSS.element(baseClass, "left-icon")}
242
+ onMouseDown={preventDefault}
243
+ onClick={(e: any) => this.onChange((e.target as any).value, "enter")}
244
+ >
245
+ {iconVDOM}
246
+ </div>
247
+ );
248
+
249
+ let insideButton;
250
+ if (
251
+ widget.showClear &&
252
+ !data.empty &&
253
+ !data.readOnly &&
254
+ !data.disabled &&
255
+ (widget.alwaysShowClear || !data.required)
256
+ ) {
257
+ insideButton = (
258
+ <div
259
+ className={CSS.element(baseClass, "clear")}
260
+ onMouseDown={(e: any) => e.preventDefault()}
261
+ onClick={(e: any) => this.onClearClick(e)}
262
+ >
263
+ <ClearIcon className={CSS.element(baseClass, "icon")} />
264
+ </div>
265
+ );
266
+ }
267
+
268
+ let empty = this.input ? !this.trimmed(this.input.value) : data.empty;
269
+
270
+ return (
271
+ <div
272
+ className={CSS.expand(
273
+ data.classNames,
274
+ CSS.state({
275
+ visited: state.visited,
276
+ focus: this.state.focus,
277
+ icon: !!icon,
278
+ clear: insideButton != null,
279
+ empty: empty && !data.placeholder,
280
+ error:
281
+ data.error &&
282
+ (state.visited || !suppressErrorsUntilVisited || !empty),
283
+ }),
284
+ )}
285
+ style={data.style}
286
+ onMouseDown={stopPropagation}
287
+ onTouchStart={stopPropagation}
288
+ >
289
+ <input
290
+ ref={(el: HTMLInputElement | null) => {
291
+ this.input = el || undefined;
292
+ }}
293
+ className={CSS.expand(
294
+ CSS.element(baseClass, "input"),
295
+ data.inputClass,
296
+ )}
297
+ defaultValue={data.value}
298
+ id={data.id}
299
+ style={data.inputStyle}
300
+ type={data.inputType}
301
+ disabled={data.disabled}
302
+ readOnly={data.readOnly}
303
+ tabIndex={data.tabIndex}
304
+ placeholder={data.placeholder}
305
+ {...data.inputAttrs}
306
+ onMouseMove={this.onMouseMove.bind(this)}
307
+ onMouseLeave={this.onMouseLeave.bind(this)}
308
+ onInput={(e: any) => this.onChange(e.target.value, "input")}
309
+ onChange={(e: any) =>
310
+ this.onChange((e.target as any).value, "change")
311
+ }
312
+ onKeyDown={this.onKeyDown.bind(this)}
313
+ onFocus={this.onFocus.bind(this)}
314
+ onBlur={this.onBlur.bind(this)}
315
+ onClick={stopPropagation}
316
+ />
317
+ {insideButton}
318
+ {icon}
319
+ {label}
320
+ {help}
321
+ </div>
322
+ );
323
+ }
324
+
325
+ onFocus(): void {
326
+ let { instance, data } = this.props;
327
+ let { widget } = instance;
328
+ if (widget.trackFocus) {
329
+ this.setState({
330
+ focus: true,
331
+ });
332
+ instance.set("focused", true);
333
+ }
334
+ if (data.error && data.value) instance.setState({ visited: true });
335
+ }
336
+
337
+ onBlur(e: any): void {
338
+ this.onChange((e.target as any).value, "blur");
339
+ if (this.state.focus) {
340
+ this.setState({
341
+ focus: false,
342
+ });
343
+ this.props.instance.set("focused", false);
344
+ }
345
+ }
346
+
347
+ onClearClick(_e: any): void {
348
+ if (this.input) this.input.value = ""; // prevent onChange call with old text value on blur or component unmount
349
+ this.props.instance.set("value", this.props.instance.widget.emptyValue, {
350
+ immediate: true,
351
+ });
352
+ }
353
+
354
+ onMouseMove(e: any): void {
355
+ const tooltip = getFieldTooltip(this.props.instance);
356
+ tooltipMouseMove(e, tooltip[0], tooltip[1], tooltip[2]);
357
+ }
358
+
359
+ onMouseLeave(e: any): void {
360
+ const tooltip = getFieldTooltip(this.props.instance);
361
+ tooltipMouseLeave(e, tooltip[0], tooltip[1], tooltip[2]);
362
+ }
363
+
364
+ componentDidMount(): void {
365
+ const tooltip = getFieldTooltip(this.props.instance);
366
+ tooltipParentDidMount(this.input!, tooltip[0], tooltip[1], tooltip[2]);
367
+ autoFocus(this.input, this);
368
+ }
369
+
370
+ componentDidUpdate(): void {
371
+ autoFocus(this.input, this);
372
+ }
373
+
374
+ componentWillUnmount(): void {
375
+ if (
376
+ this.input == getActiveElement() &&
377
+ this.input &&
378
+ this.input.value != this.props.data.value
379
+ )
380
+ this.onChange(this.input.value, "blur");
381
+ tooltipParentWillUnmount(this.props.instance);
382
+ }
383
+
384
+ onKeyDown(e: any): void {
385
+ let { instance } = this.props;
386
+ if (instance.widget.handleKeyDown(e, instance) === false) return;
387
+
388
+ switch (e.keyCode) {
389
+ case KeyCode.enter:
390
+ this.onChange(e.target.value, "enter");
391
+ break;
392
+
393
+ case KeyCode.left:
394
+ case KeyCode.right:
395
+ e.stopPropagation();
396
+ break;
397
+ }
398
+ }
399
+
400
+ UNSAFE_componentWillReceiveProps(props: any): void {
401
+ let { data } = props;
402
+ // The second check is required for debouncing, sometimes the value in the store lags after the input
403
+ // and update may be caused by some other property, i.e. visited
404
+ if (
405
+ this.input &&
406
+ data.value != this.input.value &&
407
+ data.value != this.props.data.value
408
+ )
409
+ this.input.value = data.value || "";
410
+ const tooltip = getFieldTooltip(props.instance);
411
+ tooltipParentWillReceiveProps(
412
+ this.input!,
413
+ tooltip[0],
414
+ tooltip[1],
415
+ tooltip[2],
416
+ );
417
+ }
418
+
419
+ onChange(textValue: any, change: string): void {
420
+ let { instance, data } = this.props;
421
+
422
+ let immediate = change == "blur" || change == "enter";
423
+
424
+ if (immediate) {
425
+ instance.setState({ visited: true });
426
+ }
427
+
428
+ let { widget } = instance;
429
+
430
+ if (widget.reactOn.indexOf(change) != -1) {
431
+ let text = this.trimmed(textValue);
432
+ if (data.maxLength != null && text.length > data.maxLength) {
433
+ text = text.substring(0, data.maxLength);
434
+ if (this.input) this.input.value = text;
435
+ }
436
+
437
+ let value = text || widget.emptyValue;
438
+ if (!instance.set("value", value, { immediate })) {
439
+ if (this.input && text != this.input.value && immediate)
440
+ this.input.value = text;
441
+ } else {
442
+ if (value) instance.setState({ visited: true });
443
+ }
444
+ }
445
+ }
446
+
447
+ trimmed(value: any): any {
448
+ if (this.props.data.trim && isString(value)) return value.trim();
449
+ return value;
450
+ }
451
+ }
452
+
453
+ Widget.alias("textfield", TextField);