@khanacademy/perseus 0.0.0-PR418-20230323233458

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 (449) hide show
  1. package/.babelrc.js +8 -0
  2. package/.eslintrc.js +11 -0
  3. package/CHANGELOG.md +367 -0
  4. package/README.md +5 -0
  5. package/dist/es/index.css +4071 -0
  6. package/dist/es/index.js +51108 -0
  7. package/dist/es/index.js.map +1 -0
  8. package/dist/index.css +4071 -0
  9. package/dist/index.d.ts +2 -0
  10. package/dist/index.js +51027 -0
  11. package/dist/index.js.flow +2 -0
  12. package/dist/index.js.map +1 -0
  13. package/dist/strings.js +150 -0
  14. package/package.json +95 -0
  15. package/src/__stories__/hints-renderer.stories.jsx +60 -0
  16. package/src/__stories__/item-renderer.stories.jsx +27 -0
  17. package/src/__stories__/server-item-renderer.stories.jsx +27 -0
  18. package/src/__testdata__/graphie_testdata.js +53 -0
  19. package/src/__testdata__/item-renderer_testdata.js +161 -0
  20. package/src/__testdata__/renderer_testdata.js +123 -0
  21. package/src/__tests__/__snapshots__/item-renderer_test.jsx.snap +232 -0
  22. package/src/__tests__/__snapshots__/perseus-markdown_test.jsx.snap +507 -0
  23. package/src/__tests__/__snapshots__/renderer_test.jsx.snap +585 -0
  24. package/src/__tests__/__snapshots__/server-item-renderer_test.jsx.snap +305 -0
  25. package/src/__tests__/a11y_test.jsx +304 -0
  26. package/src/__tests__/item-renderer_test.jsx +892 -0
  27. package/src/__tests__/jipt-paragraphs_test.js +34 -0
  28. package/src/__tests__/mock-asset-loading-widget.jsx +57 -0
  29. package/src/__tests__/mock-widget.jsx +35 -0
  30. package/src/__tests__/perseus-markdown_test.jsx +747 -0
  31. package/src/__tests__/renderability_test.jsx +481 -0
  32. package/src/__tests__/renderer-api_test.jsx +309 -0
  33. package/src/__tests__/renderer_test.jsx +1792 -0
  34. package/src/__tests__/server-item-renderer_test.jsx +516 -0
  35. package/src/__tests__/test-items/image-item.js +25 -0
  36. package/src/__tests__/test-items/input-number-1-item.js +27 -0
  37. package/src/__tests__/test-items/input-number-2-item.js +39 -0
  38. package/src/__tests__/test-items/table-item.js +30 -0
  39. package/src/__tests__/tex-wrangler_test.js +83 -0
  40. package/src/__tests__/util_test.js +41 -0
  41. package/src/a11y.js +46 -0
  42. package/src/all-widgets.js +9 -0
  43. package/src/article-renderer.jsx +214 -0
  44. package/src/asset-context.js +30 -0
  45. package/src/basic-widgets.js +13 -0
  46. package/src/components/__stories__/button-group.stories.jsx +61 -0
  47. package/src/components/__stories__/fixed-to-responsive.stories.jsx +132 -0
  48. package/src/components/__stories__/graph.stories.jsx +27 -0
  49. package/src/components/__stories__/graphie.stories.jsx +32 -0
  50. package/src/components/__stories__/hud.stories.jsx +36 -0
  51. package/src/components/__stories__/icon.stories.jsx +56 -0
  52. package/src/components/__stories__/image-loader.stories.jsx +60 -0
  53. package/src/components/__stories__/info-tip.stories.jsx +33 -0
  54. package/src/components/__stories__/inline-icon.stories.jsx +39 -0
  55. package/src/components/__stories__/input-with-examples.stories.jsx +52 -0
  56. package/src/components/__stories__/lint.stories.jsx +40 -0
  57. package/src/components/__stories__/math-input.stories.jsx +29 -0
  58. package/src/components/__stories__/math-output.stories.jsx +24 -0
  59. package/src/components/__stories__/multi-button-group.stories.jsx +69 -0
  60. package/src/components/__stories__/number-input.stories.jsx +42 -0
  61. package/src/components/__stories__/prop-check-box.stories.jsx +62 -0
  62. package/src/components/__stories__/range-input.stories.jsx +28 -0
  63. package/src/components/__stories__/simple-keypad-input.stories.jsx +28 -0
  64. package/src/components/__stories__/sortable.stories.jsx +73 -0
  65. package/src/components/__stories__/stub-tag-editor.stories.jsx +44 -0
  66. package/src/components/__stories__/svg-image.stories.jsx +71 -0
  67. package/src/components/__stories__/tex.stories.jsx +24 -0
  68. package/src/components/__stories__/text-buttons.stories.jsx +51 -0
  69. package/src/components/__stories__/text-input.stories.jsx +34 -0
  70. package/src/components/__stories__/text-list-editor.stories.jsx +33 -0
  71. package/src/components/__stories__/zoomable-tex.stories.jsx +39 -0
  72. package/src/components/__stories__/zoomable.stories.jsx +40 -0
  73. package/src/components/__testdata__/sorter_testdata.js +20 -0
  74. package/src/components/__tests__/__snapshots__/sortable_test.jsx.snap +79 -0
  75. package/src/components/__tests__/__snapshots__/sorter_test.jsx.snap +297 -0
  76. package/src/components/__tests__/number-input_test.jsx +112 -0
  77. package/src/components/__tests__/sortable_test.jsx +234 -0
  78. package/src/components/__tests__/sorter_test.jsx +111 -0
  79. package/src/components/__tests__/zoomable_test.jsx +388 -0
  80. package/src/components/button-group.jsx +131 -0
  81. package/src/components/constants.js +15 -0
  82. package/src/components/fixed-to-responsive.jsx +165 -0
  83. package/src/components/graph.jsx +413 -0
  84. package/src/components/graphie-classes.jsx +148 -0
  85. package/src/components/graphie-movables.jsx +342 -0
  86. package/src/components/graphie.jsx +353 -0
  87. package/src/components/highlighting/highlightable-content.jsx +245 -0
  88. package/src/components/highlighting/highlights.js +208 -0
  89. package/src/components/highlighting/ranges.js +299 -0
  90. package/src/components/highlighting/types.js +73 -0
  91. package/src/components/highlighting/ui/highlight-renderer.jsx +179 -0
  92. package/src/components/highlighting/ui/highlight-set-renderer.jsx +190 -0
  93. package/src/components/highlighting/ui/highlight-tooltip.jsx +143 -0
  94. package/src/components/highlighting/ui/highlighting-ui.jsx +163 -0
  95. package/src/components/highlighting/ui/selection-tracker.jsx +184 -0
  96. package/src/components/highlighting/ui/types.js +21 -0
  97. package/src/components/highlighting/ui/util.js +166 -0
  98. package/src/components/highlighting/word-indexer.jsx +155 -0
  99. package/src/components/hud.jsx +179 -0
  100. package/src/components/icon.jsx +149 -0
  101. package/src/components/image-loader.jsx +175 -0
  102. package/src/components/info-tip/info-tip.jsx +146 -0
  103. package/src/components/info-tip.jsx +38 -0
  104. package/src/components/inline-icon.jsx +81 -0
  105. package/src/components/input-with-examples.jsx +248 -0
  106. package/src/components/lint.jsx +455 -0
  107. package/src/components/math-input.jsx +293 -0
  108. package/src/components/math-output.jsx +128 -0
  109. package/src/components/multi-button-group.jsx +137 -0
  110. package/src/components/number-input.jsx +253 -0
  111. package/src/components/prop-check-box.jsx +80 -0
  112. package/src/components/range-input.jsx +61 -0
  113. package/src/components/simple-keypad-input.jsx +88 -0
  114. package/src/components/sortable.jsx +872 -0
  115. package/src/components/stub-tag-editor.jsx +54 -0
  116. package/src/components/svg-image.jsx +765 -0
  117. package/src/components/tex-buttons.jsx +320 -0
  118. package/src/components/tex.jsx +70 -0
  119. package/src/components/text-input.jsx +133 -0
  120. package/src/components/text-list-editor.jsx +157 -0
  121. package/src/components/tooltip.jsx +392 -0
  122. package/src/components/visibility-observer/__stories__/visibility-observer.stories.jsx +140 -0
  123. package/src/components/visibility-observer/get-scroll-parent.js +45 -0
  124. package/src/components/visibility-observer/visibility-observer.js +109 -0
  125. package/src/components/visibility-observer/visibility-observer.jsx +123 -0
  126. package/src/components/zoomable-tex.jsx +70 -0
  127. package/src/components/zoomable.jsx +294 -0
  128. package/src/components.js +17 -0
  129. package/src/definition-context.js +59 -0
  130. package/src/dependencies.js +22 -0
  131. package/src/error-boundary.jsx +48 -0
  132. package/src/extra-widgets.js +75 -0
  133. package/src/hint-renderer.jsx +155 -0
  134. package/src/hints-renderer.jsx +367 -0
  135. package/src/icon-paths.js +120 -0
  136. package/src/index.js +159 -0
  137. package/src/init.js +49 -0
  138. package/src/interaction-tracker.js +60 -0
  139. package/src/interactive2/__tests__/movable-mock.js +48 -0
  140. package/src/interactive2/__tests__/movable-point_test.js +146 -0
  141. package/src/interactive2/interactive-util.js +152 -0
  142. package/src/interactive2/movable-helper-methods.js +160 -0
  143. package/src/interactive2/movable-line-options.js +392 -0
  144. package/src/interactive2/movable-line.js +322 -0
  145. package/src/interactive2/movable-point-options.js +190 -0
  146. package/src/interactive2/movable-point.jsx +597 -0
  147. package/src/interactive2/movable-polygon-options.js +351 -0
  148. package/src/interactive2/movable-polygon.js +368 -0
  149. package/src/interactive2/movable.js +273 -0
  150. package/src/interactive2/objective_.js +79 -0
  151. package/src/interactive2/types.js +3 -0
  152. package/src/interactive2/wrapped-defaults.js +86 -0
  153. package/src/interactive2/wrapped-ellipse.js +86 -0
  154. package/src/interactive2/wrapped-line.js +109 -0
  155. package/src/interactive2/wrapped-path.js +47 -0
  156. package/src/interactive2.js +91 -0
  157. package/src/item-renderer.jsx +514 -0
  158. package/src/item-version.js +12 -0
  159. package/src/jipt-paragraphs.js +52 -0
  160. package/src/jquery.mobile.vmouse.js +546 -0
  161. package/src/keypad-context.js +33 -0
  162. package/src/loading-context.js +20 -0
  163. package/src/logging/log.js +107 -0
  164. package/src/logging/log_test.js +41 -0
  165. package/src/mixins/__tests__/widget-prop-denylist_test.js +23 -0
  166. package/src/mixins/changeable.jsx +115 -0
  167. package/src/mixins/editor-jsonify.jsx +13 -0
  168. package/src/mixins/provide-keypad.jsx +131 -0
  169. package/src/mixins/widget-jsonify-deprecated.jsx +23 -0
  170. package/src/mixins/widget-prop-denylist.js +49 -0
  171. package/src/multi-items/__stories__/multi-renderer.stories.js +88 -0
  172. package/src/multi-items/__testdata__/multi-renderer_testdata.js +174 -0
  173. package/src/multi-items/__tests__/__snapshots__/multi-renderer_test.js.snap +1220 -0
  174. package/src/multi-items/__tests__/items_test.js +245 -0
  175. package/src/multi-items/__tests__/multi-renderer_test.js +903 -0
  176. package/src/multi-items/__tests__/prop-type-builders_test.js +134 -0
  177. package/src/multi-items/__tests__/shapes_test.js +44 -0
  178. package/src/multi-items/__tests__/trees_test.js +316 -0
  179. package/src/multi-items/item-types.js +55 -0
  180. package/src/multi-items/items.js +176 -0
  181. package/src/multi-items/multi-renderer.jsx +543 -0
  182. package/src/multi-items/prop-type-builders.js +105 -0
  183. package/src/multi-items/shape-types.js +47 -0
  184. package/src/multi-items/shapes.js +53 -0
  185. package/src/multi-items/tree-types.js +42 -0
  186. package/src/multi-items/trees.js +345 -0
  187. package/src/multi-items.js +76 -0
  188. package/src/perseus-api.jsx +221 -0
  189. package/src/perseus-env.js +26 -0
  190. package/src/perseus-error.js +19 -0
  191. package/src/perseus-markdown.jsx +408 -0
  192. package/src/perseus-types.js +1475 -0
  193. package/src/question-paragraph.jsx +30 -0
  194. package/src/renderability.jsx +108 -0
  195. package/src/renderer.jsx +1937 -0
  196. package/src/server-item-renderer.jsx +467 -0
  197. package/src/sigfigs.jsx +492 -0
  198. package/src/styles/articles.less +747 -0
  199. package/src/styles/constants.js +96 -0
  200. package/src/styles/global-constants.js +344 -0
  201. package/src/styles/global-styles.js +307 -0
  202. package/src/styles/khan-exercise.css +1280 -0
  203. package/src/styles/media-queries.js +48 -0
  204. package/src/styles/perseus-renderer.less +742 -0
  205. package/src/styles/shared.js +132 -0
  206. package/src/styles/util.less +47 -0
  207. package/src/styles/variables.boostrap.less +301 -0
  208. package/src/styles/variables.less +55 -0
  209. package/src/styles/variables.shared.less +346 -0
  210. package/src/styles/widgets/categorizer.less +39 -0
  211. package/src/styles/widgets/dropdown.less +3 -0
  212. package/src/styles/widgets/expression.less +145 -0
  213. package/src/styles/widgets/graded-group.less +36 -0
  214. package/src/styles/widgets/grapher.less +11 -0
  215. package/src/styles/widgets/group.less +19 -0
  216. package/src/styles/widgets/image.less +29 -0
  217. package/src/styles/widgets/interactive-graph.less +61 -0
  218. package/src/styles/widgets/label-image.less +41 -0
  219. package/src/styles/widgets/matcher.less +8 -0
  220. package/src/styles/widgets/matrix.less +122 -0
  221. package/src/styles/widgets/measurer.less +20 -0
  222. package/src/styles/widgets/orderer.less +97 -0
  223. package/src/styles/widgets/passage.less +160 -0
  224. package/src/styles/widgets/plotter.less +29 -0
  225. package/src/styles/widgets/radio.less +56 -0
  226. package/src/styles/widgets/reaction-diagram.less +35 -0
  227. package/src/styles/widgets/sequence.less +5 -0
  228. package/src/styles/widgets/sortable.less +113 -0
  229. package/src/styles/widgets/table.less +56 -0
  230. package/src/styles/widgets/transformer.less +28 -0
  231. package/src/styles/widgets/unit.less +14 -0
  232. package/src/tex-wrangler.js +176 -0
  233. package/src/translation-linter.js +125 -0
  234. package/src/traversal.jsx +141 -0
  235. package/src/types.js +500 -0
  236. package/src/util/a11y.js +24 -0
  237. package/src/util/answer-types.js +861 -0
  238. package/src/util/answer-types_test.js +115 -0
  239. package/src/util/colors.js +94 -0
  240. package/src/util/fix-passage-refs.jsx +122 -0
  241. package/src/util/graph-utils.js +16 -0
  242. package/src/util/graphie.js +1586 -0
  243. package/src/util/interactive.js +4078 -0
  244. package/src/util/katex-preprocess.js +16 -0
  245. package/src/util/math.js +289 -0
  246. package/src/util/mobile-native-utils.js +14 -0
  247. package/src/util/mobile-native-utils_test.js +24 -0
  248. package/src/util/react-render.js +27 -0
  249. package/src/util/register-all-widgets-for-testing.js +12 -0
  250. package/src/util/scroll-utils.js +162 -0
  251. package/src/util/sizing-utils.js +46 -0
  252. package/src/util/tex.js +203 -0
  253. package/src/util/url-utils.js +36 -0
  254. package/src/util.js +984 -0
  255. package/src/version.js +11 -0
  256. package/src/widget-container.jsx +179 -0
  257. package/src/widgets/__stories__/categorizer.stories.jsx +15 -0
  258. package/src/widgets/__stories__/cs-program.stories.jsx +15 -0
  259. package/src/widgets/__stories__/definition.stories.jsx +108 -0
  260. package/src/widgets/__stories__/dropdown.stories.jsx +15 -0
  261. package/src/widgets/__stories__/explanation.stories.jsx +19 -0
  262. package/src/widgets/__stories__/expression.stories.jsx +26 -0
  263. package/src/widgets/__stories__/graded-group-set.stories.jsx +32 -0
  264. package/src/widgets/__stories__/graded-group.stories.jsx +32 -0
  265. package/src/widgets/__stories__/grapher.stories.jsx +47 -0
  266. package/src/widgets/__stories__/group.stories.jsx +15 -0
  267. package/src/widgets/__stories__/iframe.stories.jsx +15 -0
  268. package/src/widgets/__stories__/image.stories.jsx +62 -0
  269. package/src/widgets/__stories__/input-number.stories.jsx +102 -0
  270. package/src/widgets/__stories__/interaction.stories.jsx +15 -0
  271. package/src/widgets/__stories__/interactive-graph.stories.jsx +61 -0
  272. package/src/widgets/__stories__/matcher.stories.jsx +15 -0
  273. package/src/widgets/__stories__/matrix.stories.jsx +15 -0
  274. package/src/widgets/__stories__/number-line.stories.jsx +15 -0
  275. package/src/widgets/__stories__/numeric-input.stories.jsx +106 -0
  276. package/src/widgets/__stories__/on-screen-keypad.stories.jsx +118 -0
  277. package/src/widgets/__stories__/orderer.stories.jsx +15 -0
  278. package/src/widgets/__stories__/passage-ref.stories.jsx +23 -0
  279. package/src/widgets/__stories__/passage.stories.jsx +27 -0
  280. package/src/widgets/__stories__/radio.stories.jsx +90 -0
  281. package/src/widgets/__stories__/sorter.stories.jsx +15 -0
  282. package/src/widgets/__stories__/transformer.stories.jsx +15 -0
  283. package/src/widgets/__stories__/unit.stories.jsx +45 -0
  284. package/src/widgets/__stories__/video-transcript-link.stories.jsx +24 -0
  285. package/src/widgets/__stories__/video.stories.jsx +15 -0
  286. package/src/widgets/__testdata__/base-radio_testdata.js +22 -0
  287. package/src/widgets/__testdata__/categorizer_testdata.js +50 -0
  288. package/src/widgets/__testdata__/cs-program_testdata.js +28 -0
  289. package/src/widgets/__testdata__/dropdown_testdata.js +34 -0
  290. package/src/widgets/__testdata__/explanation_testdata.js +56 -0
  291. package/src/widgets/__testdata__/expression_testdata.js +95 -0
  292. package/src/widgets/__testdata__/graded-group-set_testdata.js +358 -0
  293. package/src/widgets/__testdata__/graded-group_testdata.js +79 -0
  294. package/src/widgets/__testdata__/grapher_testdata.js +376 -0
  295. package/src/widgets/__testdata__/group_testdata.js +156 -0
  296. package/src/widgets/__testdata__/iframe_testdata.js +36 -0
  297. package/src/widgets/__testdata__/image_testdata.js +38 -0
  298. package/src/widgets/__testdata__/input-number_testdata.js +73 -0
  299. package/src/widgets/__testdata__/interaction_testdata.js +264 -0
  300. package/src/widgets/__testdata__/interactive-graph_testdata.js +646 -0
  301. package/src/widgets/__testdata__/matcher_testdata.js +34 -0
  302. package/src/widgets/__testdata__/matrix_testdata.js +29 -0
  303. package/src/widgets/__testdata__/number-line_testdata.js +31 -0
  304. package/src/widgets/__testdata__/numeric-input_testdata.js +266 -0
  305. package/src/widgets/__testdata__/orderer_testdata.js +58 -0
  306. package/src/widgets/__testdata__/passage-ref_testdata.js +103 -0
  307. package/src/widgets/__testdata__/passage_testdata.js +96 -0
  308. package/src/widgets/__testdata__/radio_testdata.js +262 -0
  309. package/src/widgets/__testdata__/sorter_testdata.js +20 -0
  310. package/src/widgets/__testdata__/transformer_testdata.js +109 -0
  311. package/src/widgets/__testdata__/video_testdata.js +22 -0
  312. package/src/widgets/__tests__/__snapshots__/categorizer_test.jsx.snap +996 -0
  313. package/src/widgets/__tests__/__snapshots__/cs-program_test.jsx.snap +75 -0
  314. package/src/widgets/__tests__/__snapshots__/definition_test.js.snap +105 -0
  315. package/src/widgets/__tests__/__snapshots__/dropdown_test.jsx.snap +157 -0
  316. package/src/widgets/__tests__/__snapshots__/explanation_test.js.snap +473 -0
  317. package/src/widgets/__tests__/__snapshots__/expression_test.jsx.snap +38 -0
  318. package/src/widgets/__tests__/__snapshots__/graded-group-set-jipt_test.jsx.snap +757 -0
  319. package/src/widgets/__tests__/__snapshots__/graded-group-set_test.jsx.snap +320 -0
  320. package/src/widgets/__tests__/__snapshots__/graded-group_test.jsx.snap +865 -0
  321. package/src/widgets/__tests__/__snapshots__/grapher_test.jsx.snap +2897 -0
  322. package/src/widgets/__tests__/__snapshots__/group_test.jsx.snap +1274 -0
  323. package/src/widgets/__tests__/__snapshots__/iframe_test.jsx.snap +69 -0
  324. package/src/widgets/__tests__/__snapshots__/image_test.jsx.snap +404 -0
  325. package/src/widgets/__tests__/__snapshots__/input-number_test.jsx.snap +978 -0
  326. package/src/widgets/__tests__/__snapshots__/interaction_test.jsx.snap +311 -0
  327. package/src/widgets/__tests__/__snapshots__/interactive-graph_test.jsx.snap +3017 -0
  328. package/src/widgets/__tests__/__snapshots__/matcher_test.jsx.snap +1039 -0
  329. package/src/widgets/__tests__/__snapshots__/matrix_test.jsx.snap +522 -0
  330. package/src/widgets/__tests__/__snapshots__/number-line_test.jsx.snap +888 -0
  331. package/src/widgets/__tests__/__snapshots__/numeric-input_test.jsx.snap +488 -0
  332. package/src/widgets/__tests__/__snapshots__/orderer_test.jsx.snap +275 -0
  333. package/src/widgets/__tests__/__snapshots__/passage-ref_test.jsx.snap +446 -0
  334. package/src/widgets/__tests__/__snapshots__/passage_test.jsx.snap +1988 -0
  335. package/src/widgets/__tests__/__snapshots__/radio_test.jsx.snap +4505 -0
  336. package/src/widgets/__tests__/__snapshots__/video_test.jsx.snap +161 -0
  337. package/src/widgets/__tests__/categorizer_test.jsx +205 -0
  338. package/src/widgets/__tests__/cs-program_test.jsx +45 -0
  339. package/src/widgets/__tests__/definition_test.js +137 -0
  340. package/src/widgets/__tests__/dropdown_test.jsx +106 -0
  341. package/src/widgets/__tests__/explanation_test.js +199 -0
  342. package/src/widgets/__tests__/expression_test.jsx +439 -0
  343. package/src/widgets/__tests__/graded-group-set-jipt_test.jsx +32 -0
  344. package/src/widgets/__tests__/graded-group-set_test.jsx +290 -0
  345. package/src/widgets/__tests__/graded-group_test.jsx +233 -0
  346. package/src/widgets/__tests__/grapher.cypress.jsx +546 -0
  347. package/src/widgets/__tests__/grapher_test.jsx +35 -0
  348. package/src/widgets/__tests__/group_test.jsx +512 -0
  349. package/src/widgets/__tests__/iframe_test.jsx +47 -0
  350. package/src/widgets/__tests__/image_test.jsx +65 -0
  351. package/src/widgets/__tests__/input-number_test.jsx +360 -0
  352. package/src/widgets/__tests__/interaction_test.jsx +33 -0
  353. package/src/widgets/__tests__/interactive-graph.cypress.jsx +777 -0
  354. package/src/widgets/__tests__/interactive-graph_test.jsx +105 -0
  355. package/src/widgets/__tests__/matcher_test.jsx +157 -0
  356. package/src/widgets/__tests__/matrix_test.jsx +84 -0
  357. package/src/widgets/__tests__/number-line_test.jsx +81 -0
  358. package/src/widgets/__tests__/numeric-input_test.jsx +514 -0
  359. package/src/widgets/__tests__/orderer_test.jsx +75 -0
  360. package/src/widgets/__tests__/passage-ref_test.jsx +166 -0
  361. package/src/widgets/__tests__/passage_test.jsx +212 -0
  362. package/src/widgets/__tests__/radio/base-radio_test.jsx +443 -0
  363. package/src/widgets/__tests__/radio/choice-icon_test.jsx +91 -0
  364. package/src/widgets/__tests__/radio/choice_test.jsx +311 -0
  365. package/src/widgets/__tests__/radio/focus-ring_test.jsx +23 -0
  366. package/src/widgets/__tests__/radio/option-status_test.jsx +65 -0
  367. package/src/widgets/__tests__/radio_test.jsx +810 -0
  368. package/src/widgets/__tests__/renderQuestion.jsx +66 -0
  369. package/src/widgets/__tests__/unit_test.jsx +144 -0
  370. package/src/widgets/__tests__/video_test.jsx +55 -0
  371. package/src/widgets/categorizer.jsx +343 -0
  372. package/src/widgets/cs-program.jsx +227 -0
  373. package/src/widgets/definition.jsx +121 -0
  374. package/src/widgets/dropdown.jsx +141 -0
  375. package/src/widgets/explanation.jsx +315 -0
  376. package/src/widgets/expression.jsx +652 -0
  377. package/src/widgets/graded-group-answer-bar.jsx +152 -0
  378. package/src/widgets/graded-group-set.jsx +296 -0
  379. package/src/widgets/graded-group.jsx +453 -0
  380. package/src/widgets/grapher/util.jsx +806 -0
  381. package/src/widgets/grapher.jsx +663 -0
  382. package/src/widgets/group.jsx +195 -0
  383. package/src/widgets/iframe.jsx +198 -0
  384. package/src/widgets/image.jsx +310 -0
  385. package/src/widgets/input-number.jsx +515 -0
  386. package/src/widgets/interaction/arrow-picker.jsx +39 -0
  387. package/src/widgets/interaction/color-picker.jsx +69 -0
  388. package/src/widgets/interaction/dash-picker.jsx +46 -0
  389. package/src/widgets/interaction/element-container.jsx +97 -0
  390. package/src/widgets/interaction.jsx +742 -0
  391. package/src/widgets/interactive-graph.jsx +2820 -0
  392. package/src/widgets/label-image/__stories__/answer-choices.stories.jsx +93 -0
  393. package/src/widgets/label-image/__stories__/marker.stories.jsx +172 -0
  394. package/src/widgets/label-image/answer-choices.jsx +311 -0
  395. package/src/widgets/label-image/marker.jsx +365 -0
  396. package/src/widgets/label-image/types.js +33 -0
  397. package/src/widgets/label-image.jsx +841 -0
  398. package/src/widgets/label-image_test.js +840 -0
  399. package/src/widgets/lights-puzzle.jsx +356 -0
  400. package/src/widgets/matcher.jsx +274 -0
  401. package/src/widgets/matrix.jsx +632 -0
  402. package/src/widgets/measurer.jsx +215 -0
  403. package/src/widgets/molecule/__tests__/layout_test.jsx +159 -0
  404. package/src/widgets/molecule/__tests__/parser_test.jsx +142 -0
  405. package/src/widgets/molecule/molecule-drawing.jsx +175 -0
  406. package/src/widgets/molecule/molecule-layout.jsx +367 -0
  407. package/src/widgets/molecule/smiles-parser.jsx +300 -0
  408. package/src/widgets/molecule.jsx +172 -0
  409. package/src/widgets/number-line.jsx +858 -0
  410. package/src/widgets/numeric-input.jsx +553 -0
  411. package/src/widgets/orderer.jsx +756 -0
  412. package/src/widgets/passage/__tests__/passage-markdown_test.jsx +373 -0
  413. package/src/widgets/passage/passage-markdown.jsx +472 -0
  414. package/src/widgets/passage-ref-target.jsx +73 -0
  415. package/src/widgets/passage-ref.jsx +214 -0
  416. package/src/widgets/passage.jsx +576 -0
  417. package/src/widgets/plotter.jsx +1198 -0
  418. package/src/widgets/radio/__stories__/base-radio.stories.jsx +189 -0
  419. package/src/widgets/radio/__stories__/choice-icon.stories.jsx +166 -0
  420. package/src/widgets/radio/__stories__/choice-none-above.stories.jsx +41 -0
  421. package/src/widgets/radio/__stories__/choice.stories.jsx +138 -0
  422. package/src/widgets/radio/__stories__/focus-ring.stories.jsx +44 -0
  423. package/src/widgets/radio/__stories__/option-status.stories.jsx +104 -0
  424. package/src/widgets/radio/base-radio.jsx +494 -0
  425. package/src/widgets/radio/choice-a11y-text.js +62 -0
  426. package/src/widgets/radio/choice-icon/choice-icon.jsx +214 -0
  427. package/src/widgets/radio/choice-icon/cross-out-line.jsx +52 -0
  428. package/src/widgets/radio/choice-icon/shared-styles.js +16 -0
  429. package/src/widgets/radio/choice-none-above.jsx +63 -0
  430. package/src/widgets/radio/choice.jsx +382 -0
  431. package/src/widgets/radio/choice.jsx.fixture.js +46 -0
  432. package/src/widgets/radio/focus-ring.jsx +58 -0
  433. package/src/widgets/radio/option-status.jsx +98 -0
  434. package/src/widgets/radio/util.js +32 -0
  435. package/src/widgets/radio/util_test.js +19 -0
  436. package/src/widgets/radio/widget.jsx +515 -0
  437. package/src/widgets/radio.jsx +155 -0
  438. package/src/widgets/reaction-diagram.jsx +137 -0
  439. package/src/widgets/sequence.jsx +143 -0
  440. package/src/widgets/simulator.jsx +806 -0
  441. package/src/widgets/sorter.jsx +149 -0
  442. package/src/widgets/table.jsx +397 -0
  443. package/src/widgets/transformer.jsx +2876 -0
  444. package/src/widgets/unit.jsx +372 -0
  445. package/src/widgets/video-transcript-link.jsx +84 -0
  446. package/src/widgets/video-transcript-link_test.js +211 -0
  447. package/src/widgets/video.jsx +126 -0
  448. package/src/widgets.js +431 -0
  449. package/src/zoom.js +539 -0
package/src/util.js ADDED
@@ -0,0 +1,984 @@
1
+ /* eslint-disable @babel/no-invalid-this, getter-return, one-var */
2
+ // @flow
3
+ import _ from "underscore";
4
+
5
+ import {Errors} from "./logging/log.js";
6
+ import {PerseusError} from "./perseus-error.js";
7
+ import KhanAnswerTypes from "./util/answer-types.js";
8
+
9
+ import type {Widget, PerseusScore, KEScore} from "./types.js";
10
+
11
+ type WordPosition = {|
12
+ start: number,
13
+ end: number,
14
+ |};
15
+
16
+ type WordAndPosition = {|
17
+ string: string,
18
+ pos: WordPosition,
19
+ |};
20
+
21
+ type RNG = () => number;
22
+
23
+ export type ParsedValue = {|
24
+ value: number,
25
+ exact: boolean,
26
+ |};
27
+
28
+ // TODO: dedupe this with Coord in interactive2/types.js
29
+ type Coordinates = [number, number];
30
+
31
+ export type GridDimensions = {|
32
+ scale: number,
33
+ tickStep: number,
34
+ unityLabel: boolean,
35
+ |};
36
+
37
+ type QueryParams = {
38
+ [param: string]: string,
39
+ ...
40
+ };
41
+
42
+ type Position = {|
43
+ top: number,
44
+ left: number,
45
+ |};
46
+
47
+ type TouchHandlers = {|
48
+ pointerDown: boolean,
49
+ currentTouchIdentifier: ?string,
50
+ |};
51
+
52
+ let supportsPassive = false;
53
+
54
+ const svgLabelsRegex = /^web\+graphie:/;
55
+ // For offline exercises in the mobile app, we download the graphie data
56
+ // (svgs and localized data files) and serve them from the local file
57
+ // system (with file://). We replace urls that start with `web+graphie`
58
+ // in the perseus json with this `file+graphie` prefix to indicate that
59
+ // they should have the `file://` protocol instead of `https://`.
60
+ const svgLocalLabelsRegex = /^file\+graphie:/;
61
+
62
+ const nestedMap = function <T, M>(
63
+ children: T | $ReadOnlyArray<T>,
64
+ func: (T) => M,
65
+ context: mixed,
66
+ ): M | $ReadOnlyArray<M> {
67
+ if (Array.isArray(children)) {
68
+ return _.map(children, function (child) {
69
+ return nestedMap(child, func);
70
+ });
71
+ }
72
+ return func.call(context, children);
73
+ };
74
+
75
+ /**
76
+ * Used to compare equality of two input paths, which are represented as
77
+ * arrays of strings.
78
+ */
79
+ function inputPathsEqual(
80
+ a: ?$ReadOnlyArray<string>,
81
+ b: ?$ReadOnlyArray<string>,
82
+ ): boolean {
83
+ if (a == null || b == null) {
84
+ return (a == null) === (b == null);
85
+ }
86
+
87
+ return (
88
+ a.length === b.length &&
89
+ a.every((item, index) => {
90
+ return b[index] === item;
91
+ })
92
+ );
93
+ }
94
+
95
+ const rWidgetRule: RegExp = /^\[\[\u2603 (([a-z-]+) ([0-9]+))\]\]/;
96
+ const rTypeFromWidgetId: RegExp = /^([a-z-]+) ([0-9]+)$/;
97
+
98
+ const rWidgetParts: RegExp = new RegExp(rWidgetRule.source + "$");
99
+ const snowman = "\u2603";
100
+ const noScore: PerseusScore = {
101
+ type: "points",
102
+ earned: 0,
103
+ total: 0,
104
+ message: null,
105
+ };
106
+
107
+ const seededRNG: (seed: number) => RNG = function (seed: number): RNG {
108
+ let randomSeed = seed;
109
+
110
+ return function () {
111
+ // Robert Jenkins' 32 bit integer hash function.
112
+ let seed = randomSeed;
113
+ seed = (seed + 0x7ed55d16 + (seed << 12)) & 0xffffffff;
114
+ seed = (seed ^ 0xc761c23c ^ (seed >>> 19)) & 0xffffffff;
115
+ seed = (seed + 0x165667b1 + (seed << 5)) & 0xffffffff;
116
+ seed = ((seed + 0xd3a2646c) ^ (seed << 9)) & 0xffffffff;
117
+ seed = (seed + 0xfd7046c5 + (seed << 3)) & 0xffffffff;
118
+ seed = (seed ^ 0xb55a4f09 ^ (seed >>> 16)) & 0xffffffff;
119
+ return (randomSeed = seed & 0xfffffff) / 0x10000000;
120
+ };
121
+ };
122
+
123
+ // Shuffle an array using a given random seed or function.
124
+ // If `ensurePermuted` is true, the input and ouput are guaranteed to be
125
+ // distinct permutations.
126
+ function shuffle<T>(
127
+ array: $ReadOnlyArray<T>,
128
+ randomSeed: number | RNG,
129
+ ensurePermuted: boolean = false,
130
+ ): $ReadOnlyArray<T> {
131
+ // Always return a copy of the input array
132
+ const shuffled = _.clone(array);
133
+
134
+ // Handle edge cases (input array is empty or uniform)
135
+ if (
136
+ !shuffled.length ||
137
+ _.all(shuffled, function (value) {
138
+ return _.isEqual(value, shuffled[0]);
139
+ })
140
+ ) {
141
+ return shuffled;
142
+ }
143
+
144
+ let random;
145
+ if (typeof randomSeed === "function") {
146
+ random = randomSeed;
147
+ } else {
148
+ random = seededRNG(randomSeed);
149
+ }
150
+
151
+ do {
152
+ // Fischer-Yates shuffle
153
+ for (let top = shuffled.length; top > 0; top--) {
154
+ const newEnd = Math.floor(random() * top),
155
+ temp = shuffled[newEnd];
156
+
157
+ shuffled[newEnd] = shuffled[top - 1];
158
+ shuffled[top - 1] = temp;
159
+ }
160
+ } while (ensurePermuted && _.isEqual(array, shuffled));
161
+
162
+ return shuffled;
163
+ }
164
+
165
+ /**
166
+ * TODO(somewhatabstract, FEI-3463):
167
+ * Drop this custom split thing.
168
+ */
169
+ // In IE8, split doesn't work right. Implement it ourselves.
170
+ const split: (str: string, r: RegExp) => $ReadOnlyArray<string> = "x".split(
171
+ /(.)/g,
172
+ ).length
173
+ ? function (str, r) {
174
+ return str.split(r);
175
+ }
176
+ : function (str, r) {
177
+ // Based on Steven Levithan's MIT-licensed split, available at
178
+ // http://blog.stevenlevithan.com/archives/cross-browser-split
179
+ const output = [];
180
+ let lastIndex = (r.lastIndex = 0);
181
+ let match;
182
+
183
+ while ((match = r.exec(str))) {
184
+ const m = match;
185
+ output.push(str.slice(lastIndex, m.index));
186
+ output.push(...m.slice(1));
187
+ lastIndex = m.index + m[0].length;
188
+ }
189
+
190
+ output.push(str.slice(lastIndex));
191
+ return output;
192
+ };
193
+
194
+ /**
195
+ * Combine two score objects.
196
+ *
197
+ * Given two score objects for two different widgets, combine them so that
198
+ * if one is wrong, the total score is wrong, etc.
199
+ */
200
+ function combineScores(
201
+ scoreA: PerseusScore,
202
+ scoreB: PerseusScore,
203
+ ): PerseusScore {
204
+ let message;
205
+
206
+ if (scoreA.type === "points" && scoreB.type === "points") {
207
+ if (
208
+ scoreA.message &&
209
+ scoreB.message &&
210
+ scoreA.message !== scoreB.message
211
+ ) {
212
+ // TODO(alpert): Figure out how to combine messages usefully
213
+ message = null;
214
+ } else {
215
+ message = scoreA.message || scoreB.message;
216
+ }
217
+
218
+ return {
219
+ type: "points",
220
+ earned: scoreA.earned + scoreB.earned,
221
+ total: scoreA.total + scoreB.total,
222
+ message: message,
223
+ };
224
+ }
225
+ if (scoreA.type === "points" && scoreB.type === "invalid") {
226
+ return scoreB;
227
+ }
228
+ if (scoreA.type === "invalid" && scoreB.type === "points") {
229
+ return scoreA;
230
+ }
231
+ if (scoreA.type === "invalid" && scoreB.type === "invalid") {
232
+ if (
233
+ scoreA.message &&
234
+ scoreB.message &&
235
+ scoreA.message !== scoreB.message
236
+ ) {
237
+ // TODO(alpert): Figure out how to combine messages usefully
238
+ message = null;
239
+ } else {
240
+ message = scoreA.message || scoreB.message;
241
+ }
242
+
243
+ return {
244
+ type: "invalid",
245
+ message: message,
246
+ };
247
+ }
248
+
249
+ /**
250
+ * The above checks cover all combinations of score type, so if we get here
251
+ * then something is amiss with our inputs.
252
+ */
253
+ throw new PerseusError(
254
+ "PerseusScore with unknown type encountered",
255
+ Errors.InvalidInput,
256
+ {
257
+ metadata: {
258
+ scoreA: JSON.stringify(scoreA),
259
+ scoreB: JSON.stringify(scoreB),
260
+ },
261
+ },
262
+ );
263
+ }
264
+
265
+ function keScoreFromPerseusScore(
266
+ score: PerseusScore,
267
+ guess: $FlowFixMe,
268
+ state: $FlowFixMe,
269
+ ): KEScore {
270
+ if (score.type === "points") {
271
+ return {
272
+ empty: false,
273
+ correct: score.earned >= score.total,
274
+ message: score.message,
275
+ guess: guess,
276
+ state: state,
277
+ };
278
+ }
279
+ if (score.type === "invalid") {
280
+ return {
281
+ empty: true,
282
+ correct: false,
283
+ message: score.message,
284
+ suppressAlmostThere: score.suppressAlmostThere,
285
+ guess: guess,
286
+ state: state,
287
+ };
288
+ }
289
+ throw new PerseusError(
290
+ "Invalid score type: " + score.type,
291
+ Errors.InvalidInput,
292
+ {
293
+ metadata: {
294
+ score: JSON.stringify(score),
295
+ guess: JSON.stringify(guess),
296
+ state: JSON.stringify(state),
297
+ },
298
+ },
299
+ );
300
+ }
301
+
302
+ /**
303
+ * Return the first valid interpretation of 'text' as a number, in the form
304
+ * {value: 2.3, exact: true}.
305
+ */
306
+ function firstNumericalParse(text: string): ?ParsedValue {
307
+ // TODO(alpert): This is sort of hacky...
308
+ let first;
309
+ const val = KhanAnswerTypes.predicate.createValidatorFunctional(
310
+ function (ans) {
311
+ first = ans;
312
+ return true; /* break */
313
+ },
314
+ {
315
+ simplify: "optional",
316
+ inexact: true,
317
+ forms: "integer, proper, improper, pi, log, mixed, decimal",
318
+ },
319
+ );
320
+
321
+ val(text);
322
+ return first;
323
+ }
324
+
325
+ function stringArrayOfSize(size: number): $ReadOnlyArray<string> {
326
+ return _(size).times(function () {
327
+ return "";
328
+ });
329
+ }
330
+
331
+ /**
332
+ * For a graph's x or y dimension, given the tick step,
333
+ * the ranges extent (e.g. [-10, 10]), the pixel dimension constraint,
334
+ * and the grid step, return a bunch of configurations for that dimension.
335
+ *
336
+ * Example:
337
+ * gridDimensionConfig(10, [-50, 50], 400, 5)
338
+ *
339
+ * Returns: {
340
+ * scale: 4,
341
+ * snap: 2.5,
342
+ * tickStep: 2,
343
+ * unityLabel: true
344
+ * };
345
+ */
346
+ function gridDimensionConfig(
347
+ absTickStep: number,
348
+ extent: Coordinates,
349
+ dimensionConstraint: number,
350
+ gridStep: number,
351
+ ): GridDimensions {
352
+ const scale = scaleFromExtent(extent, dimensionConstraint);
353
+ const stepPx = absTickStep * scale;
354
+ const unityLabel = stepPx > 30;
355
+ return {
356
+ scale: scale,
357
+ tickStep: absTickStep / gridStep,
358
+ unityLabel: unityLabel,
359
+ };
360
+ }
361
+ /**
362
+ * Given the range, step, and boxSize, calculate the reasonable gridStep.
363
+ * Used for when one was not given explicitly.
364
+ *
365
+ * Example:
366
+ * getGridStep([[-10, 10], [-10, 10]], [1, 1], 340)
367
+ *
368
+ * Returns: [1, 1]
369
+ *
370
+ * TODO(somewhatabstract, FEI-3464): Consolidate query string parsing functions.
371
+ */
372
+ function getGridStep(
373
+ range: [Coordinates, Coordinates],
374
+ step: Coordinates,
375
+ boxSize: number,
376
+ ): Coordinates {
377
+ return _(2).times(function (i) {
378
+ const scale = scaleFromExtent(range[i], boxSize);
379
+ const gridStep = gridStepFromTickStep(step[i], scale);
380
+ return gridStep;
381
+ });
382
+ }
383
+
384
+ function snapStepFromGridStep(gridStep: [number, number]): [number, number] {
385
+ return [gridStep[0] / 2, gridStep[1] / 2];
386
+ }
387
+
388
+ /**
389
+ * Given the tickStep and the graph's scale, find a
390
+ * grid step.
391
+ * Example:
392
+ * gridStepFromTickStep(200, 0.2) // returns 100
393
+ */
394
+ function gridStepFromTickStep(tickStep: number, scale: number): ?number {
395
+ const tickWidth = tickStep * scale;
396
+ const x = tickStep;
397
+ const y = Math.pow(10, Math.floor(Math.log(x) / Math.LN10));
398
+ const leadingDigit = Math.floor(x / y);
399
+ if (tickWidth < 25) {
400
+ return tickStep;
401
+ }
402
+ if (tickWidth < 50) {
403
+ if (leadingDigit === 5) {
404
+ return tickStep;
405
+ }
406
+ return tickStep / 2;
407
+ }
408
+ if (leadingDigit === 1) {
409
+ return tickStep / 2;
410
+ }
411
+ if (leadingDigit === 2) {
412
+ return tickStep / 4;
413
+ }
414
+ if (leadingDigit === 5) {
415
+ return tickStep / 5;
416
+ }
417
+ }
418
+
419
+ /**
420
+ * Given the range and a dimension, come up with the appropriate
421
+ * scale.
422
+ * Example:
423
+ * scaleFromExtent([-25, 25], 500) // returns 10
424
+ */
425
+ function scaleFromExtent(
426
+ extent: Coordinates,
427
+ dimensionConstraint: number,
428
+ ): number {
429
+ const span = extent[1] - extent[0];
430
+ const scale = dimensionConstraint / span;
431
+ return scale;
432
+ }
433
+
434
+ /**
435
+ * Return a reasonable tick step given extent and dimension.
436
+ * (extent is [begin, end] of the domain.)
437
+ * Example:
438
+ * tickStepFromExtent([-10, 10], 300) // returns 2
439
+ */
440
+ function tickStepFromExtent(
441
+ extent: Coordinates,
442
+ dimensionConstraint: number,
443
+ ): number {
444
+ const span = extent[1] - extent[0];
445
+
446
+ let tickFactor;
447
+ // If single number digits
448
+ if (15 < span && span <= 20) {
449
+ tickFactor = 23;
450
+
451
+ // triple digit or decimal
452
+ } else if (span > 100 || span < 5) {
453
+ tickFactor = 10;
454
+
455
+ // double digit
456
+ } else {
457
+ tickFactor = 16;
458
+ }
459
+ const constraintFactor = dimensionConstraint / 500;
460
+ const desiredNumTicks = tickFactor * constraintFactor;
461
+ return tickStepFromNumTicks(span, desiredNumTicks);
462
+ }
463
+
464
+ /**
465
+ * Find a good tick step for the desired number of ticks in the range
466
+ * Modified from d3.scale.linear: d3_scale_linearTickRange.
467
+ * Thanks, mbostock!
468
+ * Example:
469
+ * tickStepFromNumTicks(50, 6) // returns 10
470
+ */
471
+ function tickStepFromNumTicks(span: number, numTicks: number): number {
472
+ let step = Math.pow(10, Math.floor(Math.log(span / numTicks) / Math.LN10));
473
+ const err = (numTicks / span) * step;
474
+
475
+ // Filter ticks to get closer to the desired count.
476
+ if (err <= 0.15) {
477
+ step *= 10;
478
+ } else if (err <= 0.35) {
479
+ step *= 5;
480
+ } else if (err <= 0.75) {
481
+ step *= 2;
482
+ }
483
+
484
+ // Round start and stop values to step interval.
485
+ return step;
486
+ }
487
+
488
+ type Range = [number, number]; // [min, max]
489
+
490
+ const constrainTickStep = (step: number, range: Range): number => {
491
+ const span = range[1] - range[0];
492
+ const numTicks = span / step;
493
+ if (numTicks <= 10) {
494
+ // Will displays fine on mobile
495
+ return step;
496
+ }
497
+ if (numTicks <= 20) {
498
+ // Will be crowded on mobile, so hide every other tick
499
+ return step * 2;
500
+ }
501
+ // Fallback in case we somehow have more than 20 ticks
502
+ // Note: This shouldn't happen due to GraphSettings.validStep
503
+ return tickStepFromNumTicks(span, 10);
504
+ };
505
+
506
+ /**
507
+ * Constrain tick steps intended for desktop size graphs
508
+ * to something more suitable for mobile size graphs.
509
+ * Specifically, we aim for 10 or fewer ticks per graph axis.
510
+ */
511
+ function constrainedTickStepsFromTickSteps(
512
+ tickSteps: Coordinates,
513
+ ranges: [Range, Range],
514
+ ): Coordinates {
515
+ return [
516
+ constrainTickStep(tickSteps[0], ranges[0]),
517
+ constrainTickStep(tickSteps[1], ranges[1]),
518
+ ];
519
+ }
520
+
521
+ /**
522
+ * Transparently update deprecated props so that the code to deal
523
+ * with them only lives in one place: (Widget).deprecatedProps
524
+ *
525
+ * For example, if a boolean `foo` was deprecated in favor of a
526
+ * number 'bar':
527
+ * deprecatedProps: {
528
+ * foo: function(props) {
529
+ * return {bar: props.foo ? 1 : 0};
530
+ * }
531
+ * }
532
+ */
533
+ const DeprecationMixin: $FlowFixMe = {
534
+ // This lifecycle stage is only called before first render
535
+ // TODO(jangmi, CP-3288): Remove usage of `UNSAFE_componentWillMount`
536
+ UNSAFE_componentWillMount: function () {
537
+ const newProps = {};
538
+
539
+ _.each(
540
+ this.deprecatedProps,
541
+ function (func, prop) {
542
+ if (_.has(this.props, prop)) {
543
+ _.extend(newProps, func(this.props));
544
+ }
545
+ },
546
+ this,
547
+ );
548
+
549
+ if (!_.isEmpty(newProps)) {
550
+ // Set new props directly so that widget renders correctly
551
+ // when it first mounts, even though these will be overwritten
552
+ // almost immediately afterwards...
553
+ _.extend(this.props, newProps);
554
+
555
+ // ...when we propagate the new props upwards and they come
556
+ // back down again.
557
+ // TODO(jeff, CP-3128): Use Wonder Blocks Timing API
558
+ // eslint-disable-next-line no-restricted-syntax
559
+ setTimeout(this.props.onChange, 0, newProps);
560
+ }
561
+ },
562
+ };
563
+
564
+ /**
565
+ * Approximate equality on numbers and primitives.
566
+ */
567
+ function eq<T>(x: T, y: T): boolean {
568
+ if (typeof x === "number" && typeof y === "number") {
569
+ return Math.abs(x - y) < 1e-9;
570
+ }
571
+ return x === y;
572
+ }
573
+
574
+ /**
575
+ * Deep approximate equality on primitives, numbers, arrays, and objects.
576
+ * Recursive.
577
+ */
578
+ function deepEq<T>(x: T, y: T): boolean {
579
+ if (Array.isArray(x) && Array.isArray(y)) {
580
+ if (x.length !== y.length) {
581
+ return false;
582
+ }
583
+ for (let i = 0; i < x.length; i++) {
584
+ if (!deepEq(x[i], y[i])) {
585
+ return false;
586
+ }
587
+ }
588
+ return true;
589
+ }
590
+ if (Array.isArray(x) || Array.isArray(y)) {
591
+ return false;
592
+ }
593
+ if (typeof x === "function" && typeof y === "function") {
594
+ return eq(x, y);
595
+ }
596
+ if (typeof x === "function" || typeof y === "function") {
597
+ return false;
598
+ }
599
+ if (typeof x === "object" && typeof y === "object" && !!x && !!y) {
600
+ return (
601
+ x === y ||
602
+ (_.all(x, function (v, k) {
603
+ return deepEq(y[k], v);
604
+ }) &&
605
+ _.all(y, function (v, k) {
606
+ return deepEq(x[k], v);
607
+ }))
608
+ );
609
+ }
610
+ if ((typeof x === "object" && !!x) || (typeof y === "object" && !!y)) {
611
+ return false;
612
+ }
613
+ return eq(x, y);
614
+ }
615
+
616
+ /**
617
+ * Query String Parser
618
+ *
619
+ * Original from:
620
+ * http://stackoverflow.com/questions/901115/get-querystring-values-in-javascript/2880929#2880929
621
+ */
622
+ function parseQueryString(query: string): QueryParams {
623
+ // TODO(jangmi, CP-3340): Use withLocation to access SSR safe location.
624
+ // eslint-disable-next-line no-restricted-syntax
625
+ query = query || window.location.search.substring(1);
626
+ const urlParams = {};
627
+ // Regex for replacing addition symbol with a space
628
+ const a = /\+/g;
629
+ const r = /([^&=]+)=?([^&]*)/g;
630
+ const d = function (s) {
631
+ return decodeURIComponent(s.replace(a, " "));
632
+ };
633
+
634
+ let e;
635
+ while ((e = r.exec(query))) {
636
+ const m = e;
637
+ urlParams[d(m[1])] = d(m[2]);
638
+ }
639
+
640
+ return urlParams;
641
+ }
642
+
643
+ /**
644
+ * Query string adder
645
+ * Works for URLs without #.
646
+ * Original from:
647
+ * http://stackoverflow.com/questions/5999118/add-or-update-query-string-parameter
648
+ */
649
+ function updateQueryString(uri: string, key: string, value: string): string {
650
+ value = encodeURIComponent(value);
651
+ const re = new RegExp("([?&])" + key + "=.*?(&|$)", "i");
652
+ const separator = uri.indexOf("?") !== -1 ? "&" : "?";
653
+ if (uri.match(re)) {
654
+ return uri.replace(re, "$1" + key + "=" + value + "$2");
655
+ }
656
+ return uri + separator + key + "=" + value;
657
+ }
658
+
659
+ /**
660
+ * A more strict encodeURIComponent that escapes `()'!`s
661
+ * Especially useful for creating URLs that are embeddable in markdown
662
+ *
663
+ * Adapted from
664
+ * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent
665
+ * This function and the above original available under the
666
+ * CC-BY-SA 2.5 license.
667
+ */
668
+ function strongEncodeURIComponent(str: string): string {
669
+ return (
670
+ encodeURIComponent(str)
671
+ // Note that although RFC3986 reserves "!", RFC5987 does not,
672
+ // so we do not need to escape it
673
+ .replace(/['()!]/g, window.escape) // i.e., %27 %28 %29
674
+ .replace(/\*/g, "%2A")
675
+ );
676
+ }
677
+
678
+ /**
679
+ * TODO(somewhatabstract, JIRA-XXXX):
680
+ * This does not appear to be used within webapp. Could be dead code.
681
+ * Need to check with mobile.
682
+ */
683
+ // There are certain widgets where we don't want to provide the "answered"
684
+ // highlight indicator.
685
+ // The issue with just using the `graded` flag on questions is that showing
686
+ // that a certain widget is ungraded can sometimes reveal the answer to a
687
+ // question ("is this transformation possible? if so, do it")
688
+ // This is kind of a hack to get around this.
689
+ function widgetShouldHighlight(widget: Widget): boolean {
690
+ if (!widget) {
691
+ return false;
692
+ }
693
+ switch (widget.type) {
694
+ /**
695
+ * Highlight bar denylist
696
+ */
697
+ case "measurer":
698
+ case "protractor":
699
+ return true;
700
+
701
+ default:
702
+ return false;
703
+ }
704
+ }
705
+
706
+ /**
707
+ * If a widget says that it is empty once it is graded.
708
+ * Trying to encapsulate references to the score format.
709
+ */
710
+ function scoreIsEmpty(score: PerseusScore): boolean {
711
+ // HACK(benkomalo): ugh. this isn't great; the Perseus score objects
712
+ // overload the type "invalid" for what should probably be three
713
+ // distinct cases:
714
+ // - truly empty or not fully filled out
715
+ // - invalid or malformed inputs
716
+ // - "almost correct" like inputs where the widget wants to give
717
+ // feedback (e.g. a fraction needs to be reduced, or `pi` should
718
+ // be used instead of 3.14)
719
+ //
720
+ // Unfortunately the coercion happens all over the place, as these
721
+ // Perseus style score objects are created *everywhere* (basically
722
+ // in every widget), so it's hard to change now. We assume that
723
+ // anything with a "message" is not truly empty, and one of the
724
+ // latter two cases for now.
725
+ return (
726
+ score.type === "invalid" &&
727
+ (!score.message || score.message.length === 0)
728
+ );
729
+ }
730
+
731
+ /*
732
+ * The touchHandlers are used to track the current state of the touch
733
+ * event, such as whether or not the user is currently pressed down (either
734
+ * through touch or mouse) on the screen.
735
+ */
736
+ const touchHandlers: TouchHandlers = {
737
+ pointerDown: false,
738
+ currentTouchIdentifier: null,
739
+ };
740
+
741
+ function resetTouchHandlers() {
742
+ Object.assign(touchHandlers, {
743
+ pointerDown: false,
744
+ currentTouchIdentifier: null,
745
+ });
746
+ }
747
+
748
+ /**
749
+ * Extracts the location of a touch or mouse event, allowing you to pass
750
+ * in a "mouseup", "mousedown", or "mousemove" event and receive the
751
+ * correct coordinates. Shouldn't be used with "vmouse" events.
752
+ */
753
+ function extractPointerLocation(event: $FlowFixMe): ?Position {
754
+ let touchOrEvent;
755
+
756
+ if (touchHandlers.pointerDown) {
757
+ // Look for the touch matching the one we're tracking; ignore others
758
+ if (touchHandlers.currentTouchIdentifier != null) {
759
+ const len = event.changedTouches ? event.changedTouches.length : 0;
760
+ for (let i = 0; i < len; i++) {
761
+ if (
762
+ event.changedTouches[i].identifier ===
763
+ touchHandlers.currentTouchIdentifier
764
+ ) {
765
+ touchOrEvent = event.changedTouches[i];
766
+ }
767
+ }
768
+ } else {
769
+ touchOrEvent = event;
770
+ }
771
+
772
+ const isEndish =
773
+ event.type === "touchend" || event.type === "touchcancel";
774
+ if (touchOrEvent && isEndish) {
775
+ touchHandlers.pointerDown = false;
776
+ touchHandlers.currentTouchIdentifier = null;
777
+ }
778
+ } else {
779
+ // touchstart or mousedown
780
+ touchHandlers.pointerDown = true;
781
+ if (event.changedTouches) {
782
+ touchOrEvent = event.changedTouches[0];
783
+ touchHandlers.currentTouchIdentifier = touchOrEvent.identifier;
784
+ } else {
785
+ touchOrEvent = event;
786
+ }
787
+ }
788
+
789
+ if (touchOrEvent) {
790
+ return {
791
+ left: touchOrEvent.pageX,
792
+ top: touchOrEvent.pageY,
793
+ };
794
+ }
795
+ }
796
+
797
+ // Older browsers don't support passive events and so we need to feature-
798
+ // detect them and do event subscription differently for them.
799
+ // See: orderer.jsx
800
+ const supportsPassiveEvents: () => boolean = () => {
801
+ // Test via a getter in the options object to see if the passive
802
+ // property is accessed
803
+ try {
804
+ const opts = Object.defineProperty({}, "passive", {
805
+ get: function () {
806
+ supportsPassive = true;
807
+ },
808
+ });
809
+ window.addEventListener("testPassive", null, opts);
810
+ window.removeEventListener("testPassive", null, opts);
811
+ } catch (e) {
812
+ // Intentionally left empty!
813
+ }
814
+
815
+ return supportsPassive;
816
+ };
817
+
818
+ /**
819
+ * Pass this function as the touchstart for an element to
820
+ * avoid sending the touch to the mobile scratchpad
821
+ */
822
+ function captureScratchpadTouchStart(e: TouchEvent) {
823
+ e.stopPropagation();
824
+ }
825
+
826
+ function getImageSize(url: string, callback: (number, number) => void): void {
827
+ const img = new Image();
828
+ img.onload = function () {
829
+ // IE 11 seems to have problems calculating the heights of svgs
830
+ // if they're not in the DOM. To solve this, we add the element to
831
+ // the dom, wait for a rerender, and use `.clientWidth` and
832
+ // `.clientHeight`. I think we could also solve the problem by
833
+ // adding the image to the document before setting the src, but then
834
+ // the experience would be worse for other browsers.
835
+ // TODO(scottgrant): This is correctly calculating the width of SVG
836
+ // images in browsers, but incorrectly saving the width of what may
837
+ // be a smaller viewport when using the editor, and reusing that
838
+ // width in a full-screen article.
839
+ if (img.width === 0 && img.height === 0) {
840
+ document.body?.appendChild(img);
841
+ // TODO(scottgrant): Remove this use of _.defer.
842
+ _.defer(function () {
843
+ callback(img.clientWidth, img.clientHeight);
844
+ document.body?.removeChild(img);
845
+ });
846
+ } else {
847
+ callback(img.width, img.height);
848
+ }
849
+ };
850
+
851
+ img.src = getRealImageUrl(url);
852
+ }
853
+
854
+ // Sometimes other components want to download the actual image e.g. to
855
+ // determine its size. Here, we transform an .svg-labels url into the
856
+ // correct image url, and leave normal image urls alone
857
+ function getRealImageUrl(url: string): string {
858
+ if (isLabeledSVG(url)) {
859
+ return getSvgUrl(url);
860
+ }
861
+ return url;
862
+ }
863
+
864
+ function isLabeledSVG(url: string): boolean {
865
+ return svgLabelsRegex.test(url) || svgLocalLabelsRegex.test(url);
866
+ }
867
+
868
+ // For each svg+labels, there are two urls we need to download from. This gets
869
+ // the base url without the suffix, and `getSvgUrl` and `getDataUrl` apply
870
+ // appropriate suffixes to get the image and other data
871
+ function getBaseUrl(url: string): string {
872
+ return url
873
+ .replace(svgLabelsRegex, "https:")
874
+ .replace(svgLocalLabelsRegex, "file:");
875
+ }
876
+
877
+ function getSvgUrl(url: string): string {
878
+ return getBaseUrl(url) + ".svg";
879
+ }
880
+
881
+ function getDataUrl(url: string): string {
882
+ return getBaseUrl(url) + "-data.json";
883
+ }
884
+
885
+ /**
886
+ * Gets the word right before where the textarea cursor is
887
+ *
888
+ * @param {Element} textarea - The textarea DOM element
889
+ * @return {JSON} - An object with the word and its starting and ending positions in the textarea
890
+ */
891
+ function getWordBeforeCursor(textarea: HTMLTextAreaElement): WordAndPosition {
892
+ const text = textarea.value;
893
+
894
+ const endPos = textarea.selectionStart - 1;
895
+ const startPos =
896
+ Math.max(
897
+ text.lastIndexOf("\n", endPos),
898
+ text.lastIndexOf(" ", endPos),
899
+ ) + 1;
900
+
901
+ return {
902
+ string: text.substring(startPos, endPos + 1),
903
+ pos: {
904
+ start: startPos,
905
+ end: endPos,
906
+ },
907
+ };
908
+ }
909
+
910
+ /**
911
+ * Moves the textarea cursor at the specified position
912
+ *
913
+ * @param {Element} textarea - The textarea DOM element
914
+ * @param {int} pos - The position where the cursor will be moved
915
+ */
916
+ function moveCursor(textarea: HTMLTextAreaElement, pos: number): void {
917
+ textarea.selectionStart = pos;
918
+ textarea.selectionEnd = pos;
919
+ }
920
+
921
+ const textarea = {
922
+ getWordBeforeCursor,
923
+ moveCursor,
924
+ };
925
+
926
+ /**
927
+ * Many of our labels are automatically converted into math mode without
928
+ * the dollar signs. Unfortunately, this makes them untranslatable! This
929
+ * helper function removes the math mode symbols from a string if we want
930
+ * to translate it but don't need the extra dollar signs.
931
+ */
932
+ const unescapeMathMode: (label: string) => string = (label) =>
933
+ label.startsWith("$") && label.endsWith("$") ? label.slice(1, -1) : label;
934
+
935
+ const random: RNG = seededRNG(new Date().getTime() & 0xffffffff);
936
+
937
+ const Util = {
938
+ inputPathsEqual,
939
+ nestedMap,
940
+ rWidgetRule,
941
+ rTypeFromWidgetId,
942
+ rWidgetParts,
943
+ snowman,
944
+ noScore,
945
+ seededRNG,
946
+ shuffle,
947
+ split,
948
+ combineScores,
949
+ keScoreFromPerseusScore,
950
+ firstNumericalParse,
951
+ stringArrayOfSize,
952
+ gridDimensionConfig,
953
+ getGridStep,
954
+ snapStepFromGridStep,
955
+ scaleFromExtent,
956
+ tickStepFromExtent,
957
+ gridStepFromTickStep,
958
+ tickStepFromNumTicks,
959
+ constrainedTickStepsFromTickSteps,
960
+ DeprecationMixin,
961
+ eq,
962
+ deepEq,
963
+ parseQueryString,
964
+ updateQueryString,
965
+ strongEncodeURIComponent,
966
+ widgetShouldHighlight,
967
+ scoreIsEmpty,
968
+ touchHandlers,
969
+ resetTouchHandlers,
970
+ extractPointerLocation,
971
+ supportsPassiveEvents,
972
+ captureScratchpadTouchStart,
973
+ getImageSize,
974
+ getRealImageUrl,
975
+ isLabeledSVG,
976
+ getBaseUrl,
977
+ getSvgUrl,
978
+ getDataUrl,
979
+ textarea,
980
+ unescapeMathMode,
981
+ random,
982
+ };
983
+
984
+ export default Util;