@khanacademy/perseus 0.0.1 → 0.1.0

package/src/widgets/__testdata__/number-line_testdata.js

@@ -0,0 +1,31 @@
+// @flow
+import type {PerseusRenderer} from "../../perseus-types.js";
+
+export const question1: PerseusRenderer = {
+    content:
+        "$E=2.5$\n\n**Move the dot to $-E$ on the number line.**\n\n\n[[\u2603 number-line 1]]",
+    images: {},
+    widgets: {
+        "number-line 1": {
+            graded: true,
+            version: {major: 0, minor: 0},
+            static: false,
+            type: "number-line",
+            options: {
+                labelRange: [null, null],
+                initialX: null,
+                tickStep: 1,
+                labelStyle: "decimal",
+                labelTicks: true,
+                snapDivisions: 2,
+                range: [-4, 4],
+                static: false,
+                correctRel: "eq",
+                numDivisions: null,
+                divisionRange: [1, 10],
+                correctX: -2.5,
+            },
+            alignment: "default",
+        },
+    },
+};

package/src/widgets/__testdata__/numeric-input_testdata.js

@@ -0,0 +1,266 @@
+// @flow
+import type {PerseusRenderer, NumericInputWidget} from "../../perseus-types.js";
+
+export const question1: PerseusRenderer = {
+    content: "$5008 \\div 4 =$ [[\u2603 numeric-input 1]] ",
+    images: {},
+    widgets: {
+        "numeric-input 1": ({
+            graded: true,
+            version: {
+                major: 0,
+                minor: 0,
+            },
+            static: false,
+            type: "numeric-input",
+            options: {
+                coefficient: false,
+                static: false,
+                answers: [
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        value: 1252,
+                        simplify: "required",
+                        message: "",
+                    },
+                ],
+                labelText: "",
+                size: "normal",
+            },
+            alignment: "default",
+        }: NumericInputWidget),
+    },
+};
+
+export const question2: PerseusRenderer = {
+    content: "$5008 \\div 4 =$ [[\u2603 numeric-input 1]] ",
+    images: {},
+    widgets: {
+        "numeric-input 1": ({
+            graded: true,
+            version: {
+                major: 0,
+                minor: 0,
+            },
+            static: false,
+            type: "numeric-input",
+            options: {
+                coefficient: false,
+                static: false,
+                answers: [
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        value: 1252,
+                        simplify: "required",
+                        message: "",
+                    },
+                ],
+                labelText: "What's the answer?",
+                size: "normal",
+            },
+            alignment: "default",
+        }: NumericInputWidget),
+    },
+};
+
+export const percentageProblem: PerseusRenderer = {
+    content: "$5008 \\div 4 =$ [[\u2603 numeric-input 1]] ",
+    images: {},
+    widgets: {
+        "numeric-input 1": ({
+            graded: true,
+            version: {
+                major: 0,
+                minor: 0,
+            },
+            static: false,
+            type: "numeric-input",
+            options: {
+                coefficient: false,
+                static: false,
+                answers: [
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        // $FlowFixMe[incompatible-cast] I need this to be a percent
+                        value: "33%",
+                        simplify: "required",
+                        message: "",
+                    },
+                ],
+                labelText: "What's the answer?",
+                size: "normal",
+            },
+            alignment: "default",
+        }: NumericInputWidget),
+    },
+};
+
+export const multipleAnswers: PerseusRenderer = {
+    content: "$5008 \\div 4 =$ [[\u2603 numeric-input 1]] ",
+    images: {},
+    widgets: {
+        "numeric-input 1": ({
+            graded: true,
+            version: {
+                major: 0,
+                minor: 0,
+            },
+            static: false,
+            type: "numeric-input",
+            options: {
+                coefficient: false,
+                static: false,
+                answers: [
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        value: 1,
+                        simplify: "required",
+                        message: "",
+                    },
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        value: 2,
+                        simplify: "required",
+                        message: "",
+                    },
+                ],
+                labelText: "What's the answer?",
+                size: "normal",
+            },
+            alignment: "default",
+        }: NumericInputWidget),
+    },
+};
+
+export const multipleAnswersWithDecimals: PerseusRenderer = {
+    content: "$5008 \\div 4 =$ [[\u2603 numeric-input 1]] ",
+    images: {},
+    widgets: {
+        "numeric-input 1": ({
+            graded: true,
+            version: {
+                major: 0,
+                minor: 0,
+            },
+            static: false,
+            type: "numeric-input",
+            options: {
+                coefficient: false,
+                static: false,
+                answers: [
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        value: 12.2,
+                        simplify: "required",
+                        message: "",
+                    },
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        value: 13.4,
+                        simplify: "required",
+                        message: "",
+                    },
+                ],
+                labelText: "What's the answer?",
+                size: "normal",
+            },
+            alignment: "default",
+        }: NumericInputWidget),
+    },
+};
+
+export const duplicatedAnswers: PerseusRenderer = {
+    content: "$5008 \\div 4 =$ [[\u2603 numeric-input 1]] ",
+    images: {},
+    widgets: {
+        "numeric-input 1": ({
+            graded: true,
+            version: {
+                major: 0,
+                minor: 0,
+            },
+            static: false,
+            type: "numeric-input",
+            options: {
+                coefficient: false,
+                static: false,
+                answers: [
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        value: 2.4,
+                        simplify: "optional",
+                        answerForms: ["proper", "mixed", "improper"],
+                        message: "",
+                    },
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        value: 2.4,
+                        simplify: "optional",
+                        answerForms: ["proper", "mixed", "improper"],
+                        message: "",
+                    },
+                ],
+                labelText: "What's the answer?",
+                size: "normal",
+            },
+            alignment: "default",
+        }: NumericInputWidget),
+    },
+};
+
+export const withCoefficient: PerseusRenderer = {
+    content: "$5008 \\div 4 =$ [[\u2603 numeric-input 1]] ",
+    images: {},
+    widgets: {
+        "numeric-input 1": ({
+            graded: true,
+            version: {
+                major: 0,
+                minor: 0,
+            },
+            static: false,
+            type: "numeric-input",
+            options: {
+                coefficient: true,
+                static: false,
+                answers: [
+                    {
+                        status: "correct",
+                        maxError: null,
+                        strict: false,
+                        value: 1,
+                        simplify: "required",
+                        message: "",
+                    },
+                ],
+                labelText: "What's the answer?",
+                size: "normal",
+            },
+            alignment: "default",
+        }: NumericInputWidget),
+    },
+};
+
+export const question1AndAnswer: [PerseusRenderer, string, string] = [
+    question1,
+    "1252",
+    "1/2",
+];

package/src/widgets/__testdata__/orderer_testdata.js

@@ -0,0 +1,58 @@
+// @flow
+import type {PerseusRenderer} from "../../perseus-types.js";
+
+export const question1: PerseusRenderer = {
+    content:
+        "**Without using a calculator, put the numbers in order  from least to greatest.**  \n\n[[\u2603 orderer 1]]",
+    images: {},
+    widgets: {
+        "orderer 1": {
+            version: {major: 0, minor: 0},
+            type: "orderer",
+            graded: true,
+            options: {
+                otherOptions: [],
+                layout: "horizontal",
+                options: [
+                    {content: "$10.9$", images: {}, widgets: {}},
+                    {content: "$11$", images: {}, widgets: {}},
+                    {content: "$\\sqrt{120}$", images: {}, widgets: {}},
+                ],
+                correctOptions: [
+                    {content: "$10.9$", images: {}, widgets: {}},
+                    {content: "$\\sqrt{120}$", images: {}, widgets: {}},
+                    {content: "$11$", images: {}, widgets: {}},
+                ],
+                height: "normal",
+            },
+        },
+    },
+};
+
+export const question2: PerseusRenderer = {
+    content:
+        "**Without using a calculator, put the numbers in order  from least to greatest.**  \n\n[[\u2603 orderer 1]]",
+    images: {},
+    widgets: {
+        "orderer 1": {
+            version: {major: 0, minor: 0},
+            type: "orderer",
+            graded: true,
+            options: {
+                otherOptions: [],
+                layout: "horizontal",
+                options: [
+                    {content: "1", images: {}, widgets: {}},
+                    {content: "3", images: {}, widgets: {}},
+                    {content: "2", images: {}, widgets: {}},
+                ],
+                correctOptions: [
+                    {content: "1", images: {}, widgets: {}},
+                    {content: "2", images: {}, widgets: {}},
+                    {content: "3", images: {}, widgets: {}},
+                ],
+                height: "normal",
+            },
+        },
+    },
+};

package/src/widgets/__testdata__/passage-ref_testdata.js

@@ -0,0 +1,41 @@
+// @flow
+
+import type {PerseusRenderer} from "../../perseus-types.js";
+
+export const question1: PerseusRenderer = {
+    content:
+        "[[☃ passage 1]]\n\nWe can see the word “promotes” is used in [[☃ passage-ref 1]]\n\n",
+    images: {},
+    widgets: {
+        "passage 1": {
+            alignment: "default",
+            graded: true,
+            options: {
+                footnotes: "",
+                passageText:
+                    "Our electronic devices are keeping us awake—not just because we spend time using them when we should be sleeping, but also because they emit a blue light that keeps our brains awake. One study showed that people who used screens that emitted blue light were unable to produce sufficient melatonin, a hormone that {{promotes}} sleep. In order to enjoy a more restful night, experts recommend shutting off screens at least two hours before bed. ",
+                passageTitle: "",
+                showLineNumbers: true,
+                static: false,
+            },
+            static: false,
+            type: "passage",
+            version: {
+                major: 0,
+                minor: 0,
+            },
+        },
+        "passage-ref 1": {
+            options: {
+                passageNumber: 1,
+                referenceNumber: 1,
+                summaryText: "",
+            },
+            type: "passage-ref",
+            version: {
+                major: 0,
+                minor: 1,
+            },
+        },
+    },
+};

package/src/widgets/__testdata__/passage_testdata.js

@@ -0,0 +1,71 @@
+// @flow
+import type {PerseusRenderer} from "../../perseus-types.js";
+
+export const question1: PerseusRenderer = {
+    content: "[[☃ passage 1]]\n\n",
+    images: {},
+    widgets: {
+        "passage 1": {
+            alignment: "default",
+            graded: true,
+            options: {
+                footnotes: "",
+                passageText:
+                    "Sociologists study folktales because they provide a means of understanding the distinctive values of a culture. However, the folktales in almost all cultures are adaptations of the same ancient narratives to the local milieu.\n",
+                passageTitle: "",
+                showLineNumbers: false,
+                static: false,
+            },
+            static: false,
+            type: "passage",
+            version: {
+                major: 0,
+                minor: 0,
+            },
+        },
+    },
+};
+
+export const question2: PerseusRenderer = {
+    content:
+        '>Select text to highlight it. *(Laptop/desktop only)*\n\n>**Passage 1 is adapted from *"Ancient DNA Tells Story of Giant Eagle Evolution,"* © 2005 by Public Library of Science. Passage 2 is adapted from Tim Heupink, et al. *"Dodos and Spotted Green Pigeons are Descendants of an Island Hopping Bird,"* © 2014 by BioMed Central. **\n\n[[☃ passage 1]]\n\n[[☃ passage 2]]',
+    images: {},
+    widgets: {
+        "passage 1": {
+            alignment: "default",
+            graded: true,
+            options: {
+                footnotes: "An example footnote",
+                passageText:
+                    "{{For reasons that are not entirely clear, when animals make their way to isolated islands [[1]], they tend to evolve relatively quickly toward an outsized or pint-sized version of their mainland counterpart.}} \n\n{{Perhaps the most famous example of an island giant—and, sadly, of species extinction—is the dodo, once found on the Indian Ocean island of Mauritius.}} {{When the dodo's ancestor (thought to be a migratory pigeon) settled on this island with abundant food, no competition from terrestrial mammals, and no predators, it could survive without flying, and thus was freed from the energetic and size constraints of flight.}} {{New Zealand also had avian giants, now extinct, including the flightless moa, an ostrich-like bird, and Haast's eagle (_Harpagornis moorei_), which had a wingspan up to 3 meters.}} {{Though Haast's eagle could fly—and presumably used its wings to {{launch}} brutal attacks on the hapless moa—its body mass (10–14 kilograms) pushed the limits for self-propelled flight.}}\n\n{{As extreme evolutionary examples, these island birds can offer insights into the forces and events shaping evolutionary change.}} In a new study, Michael Bunce et al. compared ancient mitochondrial DNA extracted from Haast's eagle bones with DNA sequences of 16 living eagle species to better characterize the evolutionary history of the extinct giant raptor. {{Their results suggest the extinct raptor underwent a rapid evolutionary transformation that belies its kinship to some of the world's smallest eagle species.}}\n\nThe authors characterized the rates of sequence evolution within mitochondrial DNA to establish the evolutionary relationships between the different eagle species. Their analysis places Haast's eagle in the same evolutionary lineage as a group of small eagle species in the genus _Hieraaetus_. Surprisingly, the genetic distance separating the giant eagle and its more diminutive _Hieraaetus_ cousins from their last {{common}} ancestor is relatively small.\n",
+                passageTitle: "Passage 1",
+                showLineNumbers: true,
+                static: false,
+            },
+            static: false,
+            type: "passage",
+            version: {
+                major: 0,
+                minor: 0,
+            },
+        },
+        "passage 2": {
+            alignment: "default",
+            graded: true,
+            options: {
+                footnotes: "",
+                passageText:
+                    "The mysterious spotted green pigeon (_Caloenas maculata_) was a relative of the dodo, according to scientists who have examined its genetic make-up [1]. The authors say their results, published in the open access journal BMC Evolutionary Biology, support a theory that both birds are descended from “island hopping” ancestors.\n\nThe scientists took DNA from two feathers of the spotted green pigeon. Because of its age, the DNA was highly fragmented, so they focused in on three DNA “mini barcodes” – small sections of DNA which are unique for most bird species. They looked at these sections of the pigeon's DNA, and compared it to other species.\n\nThis showed that the spotted green pigeon is indeed a separate species, showing a unique DNA barcode compared to other pigeons. The pigeon is genetically most closely related to the Nicobar pigeon and the dodo and Rodrigues solitaire, both extinct birds from islands near Madagascar. The spotted green pigeon shows signs of a semi-terrestrial island lifestyle and the ability to fly. The closely related Nicobar pigeon shows similar habits and has a preference for travelling between small islands.\n\nThe scientists say this lifestyle, together with the relationship of both pigeons to the dodo and Rodrigues solitaire, supports an evolutionary theory that the ancestors of these birds were “island hoppers,” moving between islands around India and Southeast Asia. The birds that settled on particular islands then evolved into the individual species. The dodo's ancestor managed to hop as far as the island of Mauritius near Madagascar where it then lost the ability to fly.\n\nDr. Tim Heupink, Griffith University Australia says: {{“This study improves our ability to identify novel species from historic remains, and also those that are not novel after all. Ultimately this will help us to measure and understand the extinction of local populations and entire species.”}}\n",
+                passageTitle: "Passage 2",
+                showLineNumbers: true,
+                static: false,
+            },
+            static: false,
+            type: "passage",
+            version: {
+                major: 0,
+                minor: 0,
+            },
+        },
+    },
+};

package/src/widgets/__testdata__/radio_testdata.js

@@ -0,0 +1,210 @@
+// @flow
+import type {
+    PerseusRenderer,
+    RadioWidget,
+    PassageWidget,
+} from "../../perseus-types.js";
+
+export const question: PerseusRenderer = {
+    content:
+        "Which of the following values of $x$ satisfies the equation $\\sqrt{64}=x$ ?\n\n[[\u2603 radio 1]]\n\n",
+    images: {},
+    widgets: {
+        "radio 1": ({
+            graded: true,
+            version: {
+                major: 1,
+                minor: 0,
+            },
+            static: false,
+            type: "radio",
+            options: {
+                displayCount: null,
+                onePerLine: false,
+                choices: [
+                    {
+                        content: "$-8$ and $8$",
+                        correct: false,
+                        clue: "The square root operation ($\\sqrt{\\phantom{x}}$) calculates *only* the positive square root when performed on a number, so $x$ is equal to *only* $8$.",
+                    },
+                    {
+                        content: "$-8$",
+                        correct: false,
+                        clue: "While $(-8)^2=64$, the square root operation ($\\sqrt{\\phantom{x}}$) calculates *only* the positive square root when performed on a number.",
+                    },
+                    {
+                        content: "$8$",
+                        correct: true,
+                        isNoneOfTheAbove: false,
+                        clue: "$8$ is the positive square root of $64$.",
+                    },
+                    {
+                        content: "No value of $x$ satisfies the equation.",
+                        correct: false,
+                        isNoneOfTheAbove: false,
+                        clue: "$8$ satisfies the equation.",
+                    },
+                ],
+                countChoices: false,
+                hasNoneOfTheAbove: false,
+                multipleSelect: false,
+                randomize: false,
+                deselectEnabled: false,
+            },
+            alignment: "default",
+        }: RadioWidget),
+    },
+};
+
+export const questionAndAnswer: [
+    PerseusRenderer,
+    number,
+    $ReadOnlyArray<number>,
+] = [question, 2, [0, 1, 3]];
+
+export const passageWidget: PassageWidget = {
+    alignment: "default",
+    graded: true,
+    options: {
+        footnotes: "",
+        passageText: "Line 1 {{Reference 1 \n\nis here.}}\n\n{{Another ref}}",
+        passageTitle: "",
+        showLineNumbers: true,
+        static: false,
+    },
+    static: false,
+    type: "passage",
+    version: {major: 0, minor: 0},
+};
+
+export const questionWithPassage: PerseusRenderer = {
+    content:
+        "Read the following passage:\n\n[[\u2603 passage 1]]\n\nWhich of the following values of $x$ satisfies the equation $\\sqrt{64}=x$ ?\n\n[[\u2603 radio 1]]\n\n",
+    images: {},
+    widgets: {
+        "radio 1": ({
+            graded: true,
+            version: {
+                major: 1,
+                minor: 0,
+            },
+            static: false,
+            type: "radio",
+            options: {
+                displayCount: null,
+                choices: [
+                    {
+                        content: "$-8$ and $8$",
+                        correct: false,
+                        clue: "The square root operation ($\\sqrt{\\phantom{x}}$) calculates *only* the positive square root when performed on a number, so $x$ is equal to *only* $8$.",
+                    },
+                    {
+                        content: "$-8$",
+                        correct: false,
+                        clue: "While $(-8)^2=64$, the square root operation ($\\sqrt{\\phantom{x}}$) calculates *only* the positive square root when performed on a number.",
+                    },
+                    {
+                        content: "$8$ {{passage-ref 1 1}}\n\n",
+                        correct: true,
+                        isNoneOfTheAbove: false,
+                        clue: "$8$ is the positive square root of $64$.",
+                    },
+                    {
+                        content: "No value of $x$ satisfies the equation.",
+                        correct: false,
+                        isNoneOfTheAbove: false,
+                        clue: "$8$ satisfies the equation.",
+                    },
+                ],
+                countChoices: false,
+                hasNoneOfTheAbove: false,
+                multipleSelect: false,
+                randomize: false,
+                deselectEnabled: false,
+            },
+            alignment: "default",
+        }: RadioWidget),
+        "passage 1": ({
+            alignment: "default",
+            graded: true,
+            options: {
+                footnotes: "",
+                passageText:
+                    "Here's a passage about the positive square root. It contains a {{reference to something}}.",
+                passageTitle: "",
+                showLineNumbers: true,
+                static: false,
+            },
+            static: false,
+            type: "passage",
+            version: {major: 0, minor: 0},
+        }: PassageWidget),
+    },
+};
+
+export const multiChoiceQuestion: PerseusRenderer = {
+    content:
+        "**Select all input values for which $g(x)=2$.**\n\n[[\u2603 radio 1]]\n\n ![](web+graphie://ka-perseus-graphie.s3.amazonaws.com/4613e0d9c906b3053fb5523eed83d4f779fdf6bb)",
+    images: {
+        "web+graphie://ka-perseus-graphie.s3.amazonaws.com/4613e0d9c906b3053fb5523eed83d4f779fdf6bb":
+            {
+                width: 428,
+                height: 428,
+            },
+    },
+    widgets: {
+        "radio 1": ({
+            graded: true,
+            version: {
+                major: 1,
+                minor: 0,
+            },
+            static: false,
+            type: "radio",
+            options: {
+                onePerLine: true,
+                displayCount: null,
+                choices: [
+                    {
+                        content: "$x=-6$",
+                        correct: false,
+                    },
+                    {
+                        content: "$x=4$",
+                        correct: false,
+                    },
+                    {
+                        content: "$x=7$",
+                        isNoneOfTheAbove: false,
+                        correct: false,
+                    },
+                    {
+                        content: "There is no such input value.",
+                        isNoneOfTheAbove: true,
+                        correct: true,
+                    },
+                ],
+                hasNoneOfTheAbove: true,
+                multipleSelect: true,
+                randomize: false,
+                deselectEnabled: false,
+            },
+            alignment: "default",
+        }: RadioWidget),
+    },
+};
+
+export const multiChoiceQuestionAndAnswer: [
+    PerseusRenderer,
+    $ReadOnlyArray<number>,
+    $ReadOnlyArray<$ReadOnlyArray<number>>,
+    $ReadOnlyArray<$ReadOnlyArray<number>>,
+] = [
+    multiChoiceQuestion,
+    [3],
+    [[0], [1], [2], [0, 1], [0, 2], [0, 1, 2], [1, 2]],
+    [
+        [0, 3],
+        [0, 1, 2, 3],
+    ],
+];