@khanacademy/perseus-core 4.0.0 → 5.0.0

package/dist/keypad.d.ts

@@ -0,0 +1,12 @@
+export declare const KeypadKeys: readonly ["PLUS", "MINUS", "NEGATIVE", "TIMES", "DIVIDE", "DECIMAL", "PERIOD", "PERCENT", "CDOT", "EQUAL", "NEQ", "GT", "LT", "GEQ", "LEQ", "FRAC_INCLUSIVE", "FRAC_EXCLUSIVE", "FRAC", "EXP", "EXP_2", "EXP_3", "SQRT", "CUBE_ROOT", "RADICAL", "LEFT_PAREN", "RIGHT_PAREN", "LN", "LOG", "LOG_N", "SIN", "COS", "TAN", "PI", "THETA", "UP", "RIGHT", "DOWN", "LEFT", "BACKSPACE", "DISMISS", "JUMP_OUT_PARENTHESES", "JUMP_OUT_EXPONENT", "JUMP_OUT_BASE", "JUMP_INTO_NUMERATOR", "JUMP_OUT_NUMERATOR", "JUMP_OUT_DENOMINATOR", "NUM_0", "NUM_1", "NUM_2", "NUM_3", "NUM_4", "NUM_5", "NUM_6", "NUM_7", "NUM_8", "NUM_9", "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z"];
+export type KeypadKey = (typeof KeypadKeys)[number];
+export type KeypadType = "FRACTION" | "EXPRESSION";
+export type KeypadConfiguration = {
+    keypadType: KeypadType;
+    extraKeys?: ReadonlyArray<KeypadKey>;
+    times?: boolean;
+    scientific?: boolean;
+};
+export interface KeypadContextRendererInterface {
+    blur(): void;
+}

package/dist/types.d.ts

@@ -1,6 +1,3 @@
-export interface KeypadContextRendererInterface {
-    blur(): void;
-}
 type State = any;
 export interface RendererInterface {
     getSerializedState(): State;

package/dist/widgets/expression/derive-extra-keys.d.ts

@@ -0,0 +1,8 @@
+import { type KeypadConfiguration } from "../../keypad";
+import type { PerseusExpressionWidgetOptions } from "../../data-schema";
+/**
+ * Scrape the answer forms for any variables or contants (like Pi)
+ * that need to be included as keys on the keypad.
+ */
+declare function deriveExtraKeys(widgetOptions: PerseusExpressionWidgetOptions): KeypadConfiguration["extraKeys"];
+export default deriveExtraKeys;

package/dist/widgets/expression/expression-upgrade.d.ts

@@ -4,6 +4,7 @@ export declare const currentVersion: {
     minor: number;
 };
 export declare const widgetOptionsUpgrades: {
+    readonly "2": (v1options: any) => PerseusExpressionWidgetOptions;
     readonly "1": (v0options: any) => PerseusExpressionWidgetOptions;
 };
 export type ExpressionDefaultWidgetOptions = Pick<PerseusExpressionWidgetOptions, "answerForms" | "times" | "buttonSets" | "functions">;

package/dist/widgets/expression/expression-util.d.ts

@@ -3,13 +3,14 @@ import type { PerseusExpressionWidgetOptions } from "@khanacademy/perseus-core";
  * For details on the individual options, see the
  * PerseusExpressionWidgetOptions type
  */
-type ExpressionPublicWidgetOptions = {
+export type ExpressionPublicWidgetOptions = {
     buttonSets: PerseusExpressionWidgetOptions["buttonSets"];
     functions: PerseusExpressionWidgetOptions["functions"];
     times: PerseusExpressionWidgetOptions["times"];
     visibleLabel?: PerseusExpressionWidgetOptions["visibleLabel"];
     ariaLabel?: PerseusExpressionWidgetOptions["ariaLabel"];
     buttonsVisible?: PerseusExpressionWidgetOptions["buttonsVisible"];
+    extraKeys?: PerseusExpressionWidgetOptions["extraKeys"];
 };
 /**
  * Given a PerseusExpressionWidgetOptions object, return a new object with only

package/dist/widgets/radio/radio-upgrade.d.ts

@@ -3,7 +3,9 @@ export declare const currentVersion: {
     major: number;
     minor: number;
 };
+export declare function deriveNumCorrect(options: PerseusRadioWidgetOptions): number;
 export declare const widgetOptionsUpgrades: {
+    readonly "2": (v1props: any) => PerseusRadioWidgetOptions;
     readonly "1": (v0props: any) => PerseusRadioWidgetOptions;
 };
 export type RadioDefaultWidgetOptions = Pick<PerseusRadioWidgetOptions, "choices" | "displayCount" | "randomize" | "hasNoneOfTheAbove" | "multipleSelect" | "countChoices" | "deselectEnabled">;

package/dist/widgets/radio/radio-util.d.ts

@@ -7,6 +7,7 @@ type RadioPublicWidgetOptions = {
     choices: ReadonlyArray<RadioChoicePublicData>;
     hasNoneOfTheAbove?: PerseusRadioWidgetOptions["hasNoneOfTheAbove"];
     countChoices?: PerseusRadioWidgetOptions["countChoices"];
+    numCorrect?: PerseusRadioWidgetOptions["numCorrect"];
     randomize?: PerseusRadioWidgetOptions["randomize"];
     multipleSelect?: PerseusRadioWidgetOptions["multipleSelect"];
     deselectEnabled?: PerseusRadioWidgetOptions["deselectEnabled"];
@@ -18,6 +19,15 @@ type RadioPublicWidgetOptions = {
  * Only the options from each Radio choice that should be exposed to the client.
  */
 type RadioChoicePublicData = Pick<PerseusRadioChoice, "content" | "isNoneOfTheAbove" | "widgets">;
+/**
+ * Shared functionality to determine if numCorrect is used, because:
+ *
+ * 1. numCorrect is conditionally used for rendering pre-scoring
+ * 2. numCorrect also exposes information about answers
+ *
+ * So only include/use numCorrect when we know it's useful.
+ */
+export declare function usesNumCorrect(multipleSelect: PerseusRadioWidgetOptions["multipleSelect"], countChoices: PerseusRadioWidgetOptions["countChoices"], numCorrect: PerseusRadioWidgetOptions["numCorrect"]): number | false | undefined;
 /**
  * Given a PerseusRadioWidgetOptions object, return a new object with only
  * the public options that should be exposed to the client.

package/package.json

@@ -3,7 +3,7 @@
   "description": "Shared Perseus infrastructure",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -21,7 +21,9 @@
   "files": [
     "dist"
   ],
-  "dependencies": {},
+  "dependencies": {
+    "@khanacademy/kas": "0.5.0"
+  },
   "devDependencies": {
     "@khanacademy/wonder-stuff-core": "1.5.4",
     "underscore": "^1.4.4"