cx 26.4.0 → 26.4.1

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