@khanacademy/perseus 62.0.0 → 63.0.0

package/dist/widgets/radio/utils/general-utils.d.ts

@@ -0,0 +1,35 @@
+import { type ShowSolutions } from "@khanacademy/perseus-core";
+import type { ChoiceState } from "../../../types";
+import type { RadioChoiceWithMetadata } from "../radio.new";
+interface GetChoiceStatesProps {
+    choices: ReadonlyArray<RadioChoiceWithMetadata>;
+    isStatic?: boolean | null;
+    showSolutions?: ShowSolutions;
+    choiceStates?: ReadonlyArray<ChoiceState>;
+    values?: ReadonlyArray<boolean>;
+}
+/**
+ * Determine the updated choice states for the Radio widget, based on the
+ * widget's static / showSolutions states, choiceStates, and values.
+ *
+ * @param choices - The choices for the Radio widget.
+ * @param isStatic - Whether the widget is static.
+ * @param showSolutions - Whether the widget is in showSolutions mode.
+ * @param choiceStates - The choice states for the widget. (The user's current selection states.)
+ * @param values - The values for the widget. (Deprecated: The user's current selection states for old content.)
+ * @returns The updated choice states for the widget.
+ */
+export declare const getChoiceStates: ({ choices, isStatic, showSolutions, choiceStates, values, }: GetChoiceStatesProps) => ReadonlyArray<ChoiceState>;
+/**
+ * Parse the nested widgets in the content of a Radio widget.
+ * Currently this only supports passage-ref widgets, but can
+ * be extended to support other nested widgets in the future.
+ *
+ * @param content - The content of the Radio widget.
+ * @returns The parsed content and the extracted widgets.
+ */
+export declare const parseNestedWidgets: (content: string) => {
+    parsedContent: string;
+    extractedWidgets: Record<string, any>;
+};
+export {};

package/dist/widgets/radio/utils/string-utils.d.ts

@@ -0,0 +1,72 @@
+import type { PerseusStrings } from "../../../strings";
+/**
+ * Given a choice's position in the radio widget, return the corresponding
+ * "choice letter". (For example, `getChoiceLetter(0)` is "A",
+ * `getChoiceLetter(1)` is "B", etc.)
+ *
+ * All locales use English letters for the choice letters.
+ *
+ * @param pos - The position of the choice in the radio widget.
+ * @param strings - The strings for the Radio widget.
+ * @returns The choice letter for the given position.
+ */
+export declare const getChoiceLetter: (pos: number, strings: PerseusStrings) => string;
+interface GetOptionStatusTextProps {
+    checked: boolean;
+    correct: boolean;
+    crossedOut: boolean;
+    strings: PerseusStrings;
+}
+/**
+ * Get the correct (translated) string for an option status (correct, incorrect, selected, etc.)
+ *
+ * @param checked - Whether the option is checked.
+ * @param correct - Whether the option is correct.
+ * @param crossedOut - Whether the option is crossed out.
+ * @param strings - The strings for the Radio widget.
+ * @returns The appropriate string for the option status.
+ */
+export declare const getOptionStatusText: ({ checked, correct, crossedOut, strings, }: GetOptionStatusTextProps) => string;
+interface GetInstructionsTextProps {
+    multipleSelect: boolean;
+    countChoices: boolean | null | undefined;
+    numCorrect: number;
+    strings: PerseusStrings;
+}
+/**
+ * Get the (translated) instructions string for a Radio widget.
+ *
+ * This is the text that appears above the widget that explains
+ * how many choices the user should select.
+ *
+ * @param multipleSelect - Whether the widget is a multiple-select widget.
+ * @param countChoices - Whether the widget counts choices.
+ * @param numCorrect - The number of correct choices.
+ * @param strings - The strings for the Radio widget.
+ * @returns The instructions string for the widget.
+ */
+export declare const getInstructionsText: ({ multipleSelect, countChoices, numCorrect, strings, }: GetInstructionsTextProps) => string;
+interface GetA11yTextProps {
+    letter: string;
+    checked: boolean;
+    correct: boolean;
+    crossedOut: boolean;
+    showCorrectness: boolean;
+    strings: PerseusStrings;
+}
+/**
+ * Get the (translated) a11y string for a Radio widget.
+ *
+ * This string is provided to screen readers to help the user
+ * understand the current state of a Radio option.
+ *
+ * @param letter - The letter for the choice.
+ * @param checked - Whether the choice is checked.
+ * @param correct - Whether the choice is correct.
+ * @param crossedOut - Whether the choice is crossed out.
+ * @param showCorrectness - Whether the correctness is shown.
+ * @param strings - The strings for the Radio widget.
+ * @returns The a11y string for the Radio option.
+ */
+export declare const getA11yText: ({ letter, checked, correct, crossedOut, showCorrectness, strings, }: GetA11yTextProps) => string;
+export {};

package/package.json

@@ -3,7 +3,7 @@
   "description": "Core Perseus API (includes renderers and widgets)",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "62.0.0",
+  "version": "63.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -42,12 +42,12 @@
     "tiny-invariant": "^1.3.1",
     "uuid": "^10.0.0",
     "@khanacademy/kas": "2.0.4",
-    "@khanacademy/keypad-context": "3.0.9",
-    "@khanacademy/kmath": "2.0.9",
-    "@khanacademy/math-input": "25.1.4",
-    "@khanacademy/perseus-core": "11.0.0",
-    "@khanacademy/perseus-linter": "3.0.9",
-    "@khanacademy/perseus-score": "6.0.0",
+    "@khanacademy/keypad-context": "3.0.10",
+    "@khanacademy/kmath": "2.0.10",
+    "@khanacademy/math-input": "25.1.5",
+    "@khanacademy/perseus-core": "12.0.0",
+    "@khanacademy/perseus-linter": "3.0.10",
+    "@khanacademy/perseus-score": "7.0.0",
     "@khanacademy/perseus-utils": "2.0.3",
     "@khanacademy/pure-markdown": "2.0.4",
     "@khanacademy/simple-markdown": "2.0.4"
@@ -62,6 +62,7 @@
     "@khanacademy/wonder-blocks-form": "7.1.10",
     "@khanacademy/wonder-blocks-icon-button": "9.0.4",
     "@khanacademy/wonder-blocks-icon": "5.1.3",
+    "@khanacademy/wonder-blocks-labeled-field": "3.0.6",
     "@khanacademy/wonder-blocks-layout": "3.1.9",
     "@khanacademy/wonder-blocks-link": "9.0.3",
     "@khanacademy/wonder-blocks-pill": "3.1.10",
@@ -98,6 +99,7 @@
     "@khanacademy/wonder-blocks-form": "7.1.10",
     "@khanacademy/wonder-blocks-icon": "5.1.3",
     "@khanacademy/wonder-blocks-icon-button": "9.0.4",
+    "@khanacademy/wonder-blocks-labeled-field": "3.0.6",
     "@khanacademy/wonder-blocks-layout": "3.1.9",
     "@khanacademy/wonder-blocks-link": "9.0.3",
     "@khanacademy/wonder-blocks-pill": "3.1.10",

package/dist/widgets/radio/choice-a11y-text.new.d.ts

@@ -1,14 +0,0 @@
-import type { PerseusStrings } from "../../strings";
-/**
- * This function is used to generate the a11y text for the radio widget.
- * It is used in the radio-component.tsx file to generate the a11y text for the radio widget.
- *
- * This function is a duplicate of the getA11yText function in choice-a11y-text.ts
- * for the Radio Revitalization Project. (LEMS-2933)
- *
- * This function will eventually replace choice-a11y-text.ts when the feature flag is no longer needed.
- *
- * TODO(LEMS-2994): Clean up this file.
- */
-declare function getA11yText(letter: string, checked: boolean, correct: boolean, crossedOut: boolean, showCorrectness: boolean, strings: PerseusStrings): string;
-export default getA11yText;