@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
@@ -0,0 +1,195 @@
1
+ // @flow
2
+ import {linterContextDefault} from "@khanacademy/perseus-linter";
3
+ import classNames from "classnames";
4
+ import * as React from "react";
5
+
6
+ import * as Changeable from "../mixins/changeable.jsx";
7
+ import {ApiOptions} from "../perseus-api.jsx";
8
+ import Renderer from "../renderer.jsx";
9
+
10
+ import type {PerseusGroupWidgetOptions} from "../perseus-types.js";
11
+ import type {Widget} from "../renderer.jsx";
12
+ import type {
13
+ APIOptions,
14
+ ChangeFn,
15
+ FocusPath,
16
+ PerseusScore,
17
+ WidgetExports,
18
+ WidgetProps,
19
+ } from "../types.js";
20
+
21
+ type Rubric = PerseusGroupWidgetOptions;
22
+ type RenderProps = PerseusGroupWidgetOptions; // exports has no 'transform'
23
+ type Props = WidgetProps<RenderProps, Rubric>;
24
+ type DefaultProps = {|
25
+ content: Props["content"],
26
+ widgets: Props["widgets"],
27
+ images: Props["images"],
28
+ linterContext: Props["linterContext"],
29
+ |};
30
+
31
+ class Group extends React.Component<Props> {
32
+ rendererRef: ?Renderer;
33
+
34
+ static defaultProps: DefaultProps = {
35
+ content: "",
36
+ widgets: {},
37
+ images: {},
38
+ linterContext: linterContextDefault,
39
+ };
40
+
41
+ componentDidMount() {
42
+ // TODO(marcia): See comment in render method about our cyclical
43
+ // numbering scheme. We force another render so that we can annotate
44
+ // the group with the correct number.
45
+ this.forceUpdate();
46
+ }
47
+
48
+ change: ChangeFn = (...args) => {
49
+ return Changeable.change.apply(this, args);
50
+ };
51
+
52
+ getUserInput: () => $FlowFixMe = () => {
53
+ return this.rendererRef?.getUserInput();
54
+ };
55
+
56
+ getSerializedState: () => $FlowFixMe = () => {
57
+ return this.rendererRef?.getSerializedState();
58
+ };
59
+
60
+ restoreSerializedState: ($FlowFixMe, $FlowFixMe) => null = (
61
+ state,
62
+ callback,
63
+ ) => {
64
+ this.rendererRef?.restoreSerializedState(state, callback);
65
+ // Tell our renderer that we have no props to change
66
+ // (all our changes were in state):
67
+ return null;
68
+ };
69
+
70
+ simpleValidate: (Rubric) => ?PerseusScore = (rubric) => {
71
+ return this.rendererRef?.score();
72
+ };
73
+
74
+ // Mobile API:
75
+ getInputPaths: () => ?$ReadOnlyArray<FocusPath> = () => {
76
+ return this.rendererRef?.getInputPaths();
77
+ };
78
+
79
+ setInputValue: (FocusPath, string, () => mixed) => void = (
80
+ path,
81
+ newValue,
82
+ callback,
83
+ ) => {
84
+ return this.rendererRef?.setInputValue(path, newValue, callback);
85
+ };
86
+
87
+ focus: () => ?boolean = () => {
88
+ return this.rendererRef?.focus();
89
+ };
90
+
91
+ focusInputPath: (FocusPath) => void = (path) => {
92
+ this.rendererRef?.focusPath(path);
93
+ };
94
+
95
+ blurInputPath: (FocusPath) => void = (path) => {
96
+ this.rendererRef?.blurPath(path);
97
+ };
98
+
99
+ showRationalesForCurrentlySelectedChoices: () => void = () => {
100
+ this.rendererRef?.showRationalesForCurrentlySelectedChoices();
101
+ };
102
+
103
+ render(): React.Node {
104
+ const apiOptions: APIOptions = {
105
+ ...ApiOptions.defaults,
106
+ ...this.props.apiOptions,
107
+ // Api Rewriting to support correct onFocus/onBlur
108
+ // events for the mobile API
109
+ onFocusChange: (newFocus, oldFocus) => {
110
+ if (oldFocus) {
111
+ this.props.onBlur(oldFocus);
112
+ }
113
+ if (newFocus) {
114
+ this.props.onFocus(newFocus);
115
+ }
116
+ },
117
+ };
118
+
119
+ // Allow a problem number annotation to be added.
120
+ // This is cyclical and should probably be reconsidered. In order to
121
+ // render the annotation ("Question 3 of 10"), we call findWidgets to
122
+ // figure out our index in the list of all fellow group widgets. On
123
+ // first render, though, we don't exist yet in this list, and so we
124
+ // give ourselves number -1. To combat this, we forceUpdate in
125
+ // componentDidMount so that we can number ourselves properly. But,
126
+ // really we should have a more unidirectional flow. TODO(marcia): fix.
127
+ const groupWidgets: $ReadOnlyArray<Widget> =
128
+ this.props.findWidgets("group");
129
+ const number: number = groupWidgets.indexOf(this);
130
+ const problemNumComponent = this.props.apiOptions.groupAnnotator(
131
+ number,
132
+ this.props.widgetId,
133
+ );
134
+
135
+ // This is a little strange because the id of the widget that actually
136
+ // changed is going to be lost in favor of the group widget's id. The
137
+ // widgets prop also wasn't actually changed, and this only serves to
138
+ // alert our renderer (our parent) of the fact that some interaction
139
+ // has occurred.
140
+ const onInteractWithWidget = (id) => {
141
+ if (this.rendererRef) {
142
+ this.change("widgets", this.rendererRef.props.widgets);
143
+ }
144
+ };
145
+
146
+ const score = this.rendererRef?.score();
147
+ const isValid = score && score.type !== "invalid";
148
+ const isInvalid = score && score.type === "invalid";
149
+
150
+ // TODO(mdr): Widgets inside this Renderer are not discoverable through
151
+ // the parent Renderer's `findWidgets` function.
152
+ return (
153
+ <div
154
+ className={classNames({
155
+ "perseus-group": true,
156
+ "perseus-group-valid-answer": isValid,
157
+ "perseus-group-invalid-answer": isInvalid,
158
+ })}
159
+ >
160
+ {problemNumComponent}
161
+ <Renderer
162
+ content={this.props.content}
163
+ widgets={this.props.widgets}
164
+ images={this.props.images}
165
+ ref={(ref) => (this.rendererRef = ref)}
166
+ apiOptions={apiOptions}
167
+ findExternalWidgets={this.props.findWidgets}
168
+ reviewMode={!!this.props.reviewModeRubric}
169
+ onInteractWithWidget={onInteractWithWidget}
170
+ linterContext={this.props.linterContext}
171
+ />
172
+ {/* $FlowFixMe[prop-missing] */}
173
+ {this.props.icon && (
174
+ <div className="group-icon">{this.props.icon}</div>
175
+ )}
176
+ </div>
177
+ );
178
+ }
179
+ }
180
+
181
+ const traverseChildWidgets = function (
182
+ props: $FlowFixMe,
183
+ traverseRenderer: $FlowFixMe,
184
+ ): $FlowFixMe {
185
+ return {...props, ...traverseRenderer(props)};
186
+ };
187
+
188
+ export default ({
189
+ name: "group",
190
+ displayName: "Group (SAT only)",
191
+ widget: Group,
192
+ traverseChildWidgets: traverseChildWidgets,
193
+ hidden: false,
194
+ isLintable: true,
195
+ }: WidgetExports<typeof Group>);
@@ -0,0 +1,198 @@
1
+ /* eslint-disable react/forbid-prop-types, react/sort-comp */
2
+ // @flow
3
+ /**
4
+ * This is an iframe widget. It is used for rendering an iframe that
5
+ * then communicates its state via window.postMessage
6
+ * This is useful for embedding arbitrary visualizations/simulations with
7
+ * completed conditions, such as the mazes and games in Algorithms.
8
+ * It's particularly well suited for embedding our ProcessingJS programs,
9
+ * but could also be used for embedding viz's hosted elsewhere.
10
+ */
11
+
12
+ import $ from "jquery";
13
+ import PropTypes from "prop-types";
14
+ import * as React from "react";
15
+ import _ from "underscore";
16
+
17
+ import {getDependencies} from "../dependencies.js";
18
+ import * as Changeable from "../mixins/changeable.jsx";
19
+ import WidgetJsonifyDeprecated from "../mixins/widget-jsonify-deprecated.jsx";
20
+ import Util from "../util.js";
21
+
22
+ import type {WidgetExports} from "../types.js";
23
+
24
+ const {updateQueryString} = Util;
25
+
26
+ /* This renders the iframe and handles validation via window.postMessage */
27
+ class Iframe extends React.Component<$FlowFixMe> {
28
+ static propTypes = {
29
+ ...Changeable.propTypes,
30
+ width: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
31
+ height: PropTypes.oneOfType([PropTypes.string, PropTypes.number]),
32
+ url: PropTypes.string,
33
+ settings: PropTypes.array,
34
+ status: PropTypes.oneOf(["incomplete", "incorrect", "correct"]),
35
+ message: PropTypes.string,
36
+ allowFullScreen: PropTypes.bool,
37
+ allowTopNavigation: PropTypes.bool,
38
+ };
39
+
40
+ static defaultProps: $FlowFixMe = {
41
+ status: "incomplete",
42
+ // optional message
43
+ message: null,
44
+ allowFullScreen: false,
45
+ allowTopNavigation: false,
46
+ };
47
+
48
+ getUserInput: () => $FlowFixMe = () => {
49
+ return WidgetJsonifyDeprecated.getUserInput.call(this);
50
+ };
51
+
52
+ handleMessageEvent: ($FlowFixMe) => void = (e) => {
53
+ // We receive data from the iframe that contains {passed: true/false}
54
+ // and use that to set the status
55
+ // It could also contain an optional message
56
+ let data = {};
57
+ try {
58
+ data = JSON.parse(e.originalEvent.data);
59
+ } catch (err) {
60
+ return;
61
+ }
62
+
63
+ if (_.isUndefined(data.testsPassed)) {
64
+ return;
65
+ }
66
+
67
+ const status = data.testsPassed ? "correct" : "incorrect";
68
+ this.change({
69
+ status: status,
70
+ message: data.message,
71
+ });
72
+ };
73
+
74
+ componentDidMount() {
75
+ $(window).on("message", this.handleMessageEvent);
76
+ }
77
+
78
+ componentWillUnmount() {
79
+ $(window).off("message", this.handleMessageEvent);
80
+ }
81
+
82
+ render(): React.Node {
83
+ const style = {
84
+ width: String(this.props.width),
85
+ height: String(this.props.height),
86
+ };
87
+
88
+ const {InitialRequestUrl} = getDependencies();
89
+
90
+ // Add "px" to unitless numbers
91
+ Object.entries(style).forEach(([key, value]) => {
92
+ // $FlowFixMe[incompatible-use]
93
+ if (!value.endsWith("%") && !value.endsWith("px")) {
94
+ // $FlowFixMe[unclear-addition]
95
+ style[key] = value + "px";
96
+ }
97
+ });
98
+
99
+ let url = this.props.url;
100
+
101
+ // If the URL doesnt start with http, it must be a program ID
102
+ if (url && url.length && url.indexOf("http") !== 0) {
103
+ url =
104
+ "https://www.khanacademy.org/computer-programming/program/" +
105
+ url +
106
+ "/embedded?buttons=no&embed=yes&editor=no&author=no";
107
+ url = updateQueryString(url, "width", this.props.width);
108
+ url = updateQueryString(url, "height", this.props.height);
109
+ // Origin is used by output.js in deciding to send messages
110
+ url = updateQueryString(url, "origin", InitialRequestUrl.origin);
111
+ }
112
+
113
+ // Turn array of [{name: "", value: ""}] into object
114
+ if (this.props.settings) {
115
+ const settings = {};
116
+ _.each(this.props.settings, function (setting) {
117
+ if (setting.name && setting.value) {
118
+ settings[setting.name] = setting.value;
119
+ }
120
+ });
121
+ // This becomes available to programs as Program.settings()
122
+ url = updateQueryString(url, "settings", JSON.stringify(settings));
123
+ }
124
+
125
+ let sandboxProperties = "allow-same-origin allow-scripts";
126
+ // TODO(scottgrant): This line is an intentional hack to retain the
127
+ // allow-top-navigation sandbox property. Once our LearnStorm articles
128
+ // have this value checked and published, this line should be removed
129
+ // and replaced with the conditional check below that is commented out.
130
+ // We don't want to break LearnStorm badges, so this will be a two-part
131
+ // deploy.
132
+ sandboxProperties += " allow-top-navigation";
133
+ // if (this.props.allowTopNavigation === true) {
134
+ // sandboxProperties += " allow-top-navigation";
135
+ // }
136
+
137
+ // We sandbox the iframe so that we allowlist only the functionality
138
+ // that we need. This makes it a bit safer in case some content
139
+ // creator "went wild".
140
+ // http://www.html5rocks.com/en/tutorials/security/sandboxed-iframes/
141
+ return (
142
+ <iframe
143
+ sandbox={sandboxProperties}
144
+ style={style}
145
+ src={url}
146
+ allowFullScreen={this.props.allowFullScreen}
147
+ />
148
+ );
149
+ }
150
+
151
+ change: (...args: $ReadOnlyArray<mixed>) => $FlowFixMe = (...args) => {
152
+ // $FlowFixMe[incompatible-call]
153
+ return Changeable.change.apply(this, args);
154
+ };
155
+
156
+ simpleValidate: ($FlowFixMe) => $FlowFixMe = (rubric) => {
157
+ // $FlowFixMe[prop-missing]
158
+ return Iframe.validate(this.getUserInput(), rubric);
159
+ };
160
+ }
161
+
162
+ /**
163
+ * This is the widget's grading function
164
+ */
165
+ _.extend(Iframe, {
166
+ validate: function (state, rubric) {
167
+ // The iframe can tell us whether it's correct or incorrect,
168
+ // and pass an optional message
169
+ if (state.status === "correct") {
170
+ return {
171
+ type: "points",
172
+ earned: 1,
173
+ total: 1,
174
+ message: state.message || null,
175
+ };
176
+ }
177
+ if (state.status === "incorrect") {
178
+ return {
179
+ type: "points",
180
+ earned: 0,
181
+ total: 1,
182
+ message: state.message || null,
183
+ };
184
+ }
185
+ return {
186
+ type: "invalid",
187
+ message: "Keep going, you're not there yet!",
188
+ };
189
+ },
190
+ });
191
+
192
+ export default ({
193
+ name: "iframe",
194
+ displayName: "Iframe",
195
+ widget: Iframe,
196
+ // Let's not expose it to all content creators yet
197
+ hidden: true,
198
+ }: WidgetExports<typeof Iframe>);
@@ -0,0 +1,310 @@
1
+ /* eslint-disable react/prop-types */
2
+ /* eslint-disable react/sort-comp */
3
+ // @flow
4
+ import {linterContextDefault} from "@khanacademy/perseus-linter";
5
+ import {StyleSheet, css} from "aphrodite";
6
+ import classNames from "classnames";
7
+ import * as React from "react";
8
+ import _ from "underscore";
9
+
10
+ import SvgImage from "../components/svg-image.jsx";
11
+ import * as Changeable from "../mixins/changeable.jsx";
12
+ import Renderer from "../renderer.jsx";
13
+ import {baseUnitPx} from "../styles/constants.js";
14
+ import mediaQueries from "../styles/media-queries.js";
15
+
16
+ import type {PerseusImageWidgetOptions} from "../perseus-types.js";
17
+ import type {
18
+ ChangeFn,
19
+ PerseusScore,
20
+ WidgetExports,
21
+ WidgetProps,
22
+ } from "../types.js";
23
+
24
+ const defaultBoxSize = 400;
25
+ const defaultRange = [0, 10];
26
+ const defaultBackgroundImage = {
27
+ url: null,
28
+ width: 0,
29
+ height: 0,
30
+ };
31
+
32
+ const editorAlignments = ["block", "full-width"];
33
+
34
+ const DEFAULT_ALIGNMENT = "block";
35
+
36
+ type RenderProps = PerseusImageWidgetOptions; // there is no transform as part of exports
37
+ type Rubric = PerseusImageWidgetOptions;
38
+ type UserInput = null;
39
+
40
+ type ExternalProps = WidgetProps<RenderProps, Rubric>;
41
+
42
+ type Props = {|
43
+ ...ExternalProps,
44
+ alignment: $NonMaybeType<ExternalProps["alignment"]>,
45
+ title: $NonMaybeType<ExternalProps["title"]>,
46
+ range: $NonMaybeType<ExternalProps["range"]>,
47
+ box: $NonMaybeType<ExternalProps["box"]>,
48
+ backgroundImage: $NonMaybeType<ExternalProps["backgroundImage"]>,
49
+ labels: $NonMaybeType<ExternalProps["labels"]>,
50
+ alt: $NonMaybeType<ExternalProps["alt"]>,
51
+ caption: $NonMaybeType<ExternalProps["caption"]>,
52
+ linterContext: $NonMaybeType<ExternalProps["linterContext"]>,
53
+ |};
54
+
55
+ type DefaultProps = {|
56
+ alignment: Props["alignment"],
57
+ title: Props["title"],
58
+ range: Props["range"],
59
+ box: Props["box"],
60
+ backgroundImage: Props["backgroundImage"],
61
+ labels: Props["labels"],
62
+ alt: Props["alt"],
63
+ caption: Props["caption"],
64
+ linterContext: Props["linterContext"],
65
+ |};
66
+
67
+ class ImageWidget extends React.Component<Props> {
68
+ static defaultProps: DefaultProps = {
69
+ alignment: DEFAULT_ALIGNMENT,
70
+ title: "",
71
+ range: [defaultRange, defaultRange],
72
+ box: [defaultBoxSize, defaultBoxSize],
73
+ backgroundImage: defaultBackgroundImage,
74
+ labels: [],
75
+ alt: "",
76
+ caption: "",
77
+ linterContext: linterContextDefault,
78
+ };
79
+
80
+ change: ChangeFn = (...args) => {
81
+ return Changeable.change.apply(this, args);
82
+ };
83
+
84
+ getUserInput: () => UserInput = () => {
85
+ return null;
86
+ };
87
+
88
+ simpleValidate: (Rubric) => PerseusScore = (rubric) => {
89
+ return ImageWidget.validate(this.getUserInput(), rubric);
90
+ };
91
+
92
+ focus: () => void = () => {}; // no-op
93
+
94
+ render(): React.Node {
95
+ let image;
96
+ let alt;
97
+ const {apiOptions} = this.props;
98
+
99
+ const backgroundImage = this.props.backgroundImage;
100
+
101
+ if (backgroundImage.url) {
102
+ image = (
103
+ <SvgImage
104
+ src={backgroundImage.url}
105
+ alt={
106
+ /* alt text is formatted in a sr-only
107
+ div next to the image in addition to
108
+ the alt attribute.
109
+ If there is no alt text at all,
110
+ we don't put an alt attribute on
111
+ the image, so that screen readers
112
+ know there's something they can't
113
+ read there :(.
114
+ NOTE: React <=0.13 (maybe later)
115
+ has a bug where it won't ever
116
+ remove an attribute, so if this
117
+ alt node is ever defined it's
118
+ not removed. This is sort of
119
+ dangerous, but we usually re-key
120
+ new renderers so that they're
121
+ rendered from scratch anyways,
122
+ so this shouldn't be a problem
123
+ in practice right now, although
124
+ it will exhibit weird behaviour
125
+ while editing. */
126
+ this.props.alt
127
+ }
128
+ overrideAriaHidden={true}
129
+ width={backgroundImage.width}
130
+ height={backgroundImage.height}
131
+ preloader={apiOptions.imagePreloader}
132
+ extraGraphie={{
133
+ box: this.props.box,
134
+ range: this.props.range,
135
+ labels: this.props.labels,
136
+ }}
137
+ trackInteraction={this.props.trackInteraction}
138
+ zoomToFullSizeOnMobile={apiOptions.isMobile}
139
+ constrainHeight={apiOptions.isMobile}
140
+ allowFullBleed={apiOptions.isMobile}
141
+ />
142
+ );
143
+ }
144
+
145
+ if (this.props.alt) {
146
+ alt = (
147
+ <span className="perseus-sr-only">
148
+ <Renderer
149
+ content={this.props.alt}
150
+ apiOptions={apiOptions}
151
+ linterContext={this.props.linterContext}
152
+ />
153
+ </span>
154
+ );
155
+ }
156
+
157
+ // For mobile we combine an image's title and caption.
158
+ if (apiOptions.isMobile) {
159
+ let titleAndCaption;
160
+
161
+ if (this.props.title || this.props.caption) {
162
+ let title = this.props.title;
163
+
164
+ // Bold the title, and make it the first sentence of the
165
+ // caption.
166
+ if (title) {
167
+ // We add a period to separate the title from the caption
168
+ // (if it exists), unless the title already ends with a
169
+ // punctuation symbol (whitespace ignored). Copied from
170
+ // webapp: https://github.com/Khan/webapp/blob/6e930637edb65696d0749ea0f7558214aee32b4e/javascript/tutorial-shared-package/components/content-description.jsx#L80
171
+ // TODO(charlie): Internationalize this check, and the
172
+ // delimiter that is being inserted.
173
+ if (this.props.caption && !/[.?!"']\s*$/.test(title)) {
174
+ title += ".";
175
+ }
176
+
177
+ title = `**${title}** `;
178
+ }
179
+
180
+ const className = classNames({
181
+ "perseus-image-caption": true,
182
+ "has-title": !!title,
183
+ });
184
+
185
+ // Caption is left-aligned within a container that's centered
186
+ // below the image, with these width constraints:
187
+ //
188
+ // 1. Size caption to width of the image on-screen.
189
+ // 2. ... but constrain its width to a range based on the
190
+ // device to optimize readability - e.g. [320px, 450px] for
191
+ // phones.
192
+ // 3. ... unless the image is floated, in which case we don't
193
+ // want the caption to overflow the image size.
194
+ //
195
+ // TODO(david): If caption is only 1 line long, center-align
196
+ // the text.
197
+ const alignment = this.props.alignment;
198
+ const isImageFullWidth =
199
+ alignment === "block" || alignment === "full-width";
200
+
201
+ // This minWidth takes precedence over minWidth applied via
202
+ // Aphrodite.
203
+ const minWidth = isImageFullWidth ? null : "0 !important";
204
+
205
+ titleAndCaption = (
206
+ <div className={className}>
207
+ <div
208
+ className={css(styles.caption)}
209
+ style={{
210
+ minWidth: minWidth,
211
+ }}
212
+ >
213
+ <Renderer
214
+ content={title + this.props.caption}
215
+ apiOptions={apiOptions}
216
+ linterContext={this.props.linterContext}
217
+ />
218
+ </div>
219
+ </div>
220
+ );
221
+ }
222
+
223
+ return (
224
+ <div className="perseus-image-widget">
225
+ {image}
226
+ {alt}
227
+ {titleAndCaption}
228
+ </div>
229
+ );
230
+ }
231
+ let title;
232
+ let caption;
233
+
234
+ if (this.props.title) {
235
+ title = (
236
+ <div className="perseus-image-title">
237
+ <Renderer
238
+ content={this.props.title}
239
+ apiOptions={apiOptions}
240
+ linterContext={this.props.linterContext}
241
+ />
242
+ </div>
243
+ );
244
+ }
245
+
246
+ if (this.props.caption) {
247
+ caption = (
248
+ <div className="perseus-image-caption">
249
+ <Renderer
250
+ content={this.props.caption}
251
+ apiOptions={apiOptions}
252
+ linterContext={this.props.linterContext}
253
+ />
254
+ </div>
255
+ );
256
+ }
257
+
258
+ return (
259
+ <div className="perseus-image-widget">
260
+ {title}
261
+ {image}
262
+ {alt}
263
+ {caption}
264
+ </div>
265
+ );
266
+ }
267
+
268
+ static validate(userInput: UserInput, rubric: Rubric): PerseusScore {
269
+ return {
270
+ type: "points",
271
+ earned: 0,
272
+ total: 0,
273
+ message: null,
274
+ };
275
+ }
276
+ }
277
+
278
+ const styles = StyleSheet.create({
279
+ caption: {
280
+ display: "inline-block",
281
+ marginTop: baseUnitPx,
282
+ maxWidth: 640,
283
+
284
+ [mediaQueries.lgOrSmaller]: {
285
+ // TODO(david): This maxWidth is not being used because
286
+ // it's overriden by the 512px max-width we have on
287
+ // paragraphs.
288
+ maxWidth: 540,
289
+ },
290
+
291
+ [mediaQueries.smOrSmaller]: {
292
+ maxWidth: 450,
293
+ },
294
+ },
295
+ });
296
+
297
+ export default ({
298
+ name: "image",
299
+ // This widget's accessibility depends on its contents: if the image has
300
+ // has a background but no alt text, it is not accessible
301
+ accessible: (widgetOptions: PerseusImageWidgetOptions): boolean => {
302
+ const bgImage = widgetOptions.backgroundImage;
303
+ return !(bgImage && bgImage.url && !widgetOptions.alt);
304
+ },
305
+ defaultAlignment: DEFAULT_ALIGNMENT,
306
+ supportedAlignments: editorAlignments,
307
+ displayName: "Image",
308
+ widget: ImageWidget,
309
+ isLintable: true,
310
+ }: WidgetExports<typeof ImageWidget>);