cx 26.1.1 → 26.1.2

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