cx 26.3.9 → 26.4.0

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