cx 26.3.10 → 26.4.0

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