cx 26.4.0 → 26.4.1

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