@khanacademy/perseus-core 18.3.0 → 18.5.0

package/dist/parse-perseus-json/general-purpose-parsers/array.d.ts

@@ -1,2 +1,7 @@
 import type { Parser } from "../parser-types";
 export declare function array<T>(elementParser: Parser<T>): Parser<T[]>;
+/**
+ * Like the standard `array` parser, but passes the array index to a parser factory function.
+ * This allows element parsers to generate index-based default values.
+ */
+export declare function arrayWithIndex<T>(elementParserFactory: (index: number) => Parser<T>): Parser<T[]>;

package/dist/parse-perseus-json/perseus-parsers/categorizer-user-input.d.ts

@@ -1,3 +1,3 @@
 export declare const parseCategorizerUserInput: import("../parser-types").Parser<import("../general-purpose-parsers/object-types").OptionalizeProperties<{
-    values: number[];
+    values: (number | null | undefined)[];
 }>>;

package/dist/parse-perseus-json/perseus-parsers/radio-widget.d.ts

@@ -6,6 +6,7 @@ declare const parseRadioWidgetV3: import("../parser-types").Parser<import("../..
         rationale: string | undefined;
         correct: boolean | undefined;
         isNoneOfTheAbove: boolean | undefined;
+        id: string;
     }>[];
     hasNoneOfTheAbove: boolean | undefined;
     countChoices: boolean | undefined;
@@ -75,6 +76,7 @@ export declare const parseRadioWidget: import("../parser-types").Parser<import("
         rationale: string | undefined;
         correct: boolean | undefined;
         isNoneOfTheAbove: boolean | undefined;
+        id: string;
     }>[];
     hasNoneOfTheAbove: boolean | undefined;
     countChoices: boolean | undefined;

package/dist/parse-perseus-json/perseus-parsers/radio-widget.mockData.d.ts

@@ -150,30 +150,40 @@ export declare const v3Widget: {
     graded: boolean;
     options: {
         choices: ({
+            id: string;
             content: string;
             correct: boolean;
             rationale: string;
             isNoneOfTheAbove: boolean;
+            widgets?: undefined;
         } | {
+            id: string;
             content: string;
             correct: boolean;
             rationale: string;
+            widgets: undefined;
             isNoneOfTheAbove?: undefined;
         } | {
+            id: string;
             content: string;
             correct: boolean;
             isNoneOfTheAbove: boolean;
             rationale?: undefined;
+            widgets?: undefined;
         } | {
+            id: string;
             content: string;
             rationale: string;
             isNoneOfTheAbove: boolean;
             correct?: undefined;
+            widgets?: undefined;
         } | {
+            id: string;
             content: string;
             correct?: undefined;
             rationale?: undefined;
             isNoneOfTheAbove?: undefined;
+            widgets?: undefined;
         })[];
         numCorrect: number;
         hasNoneOfTheAbove: boolean;

package/dist/utils/random-util.d.ts

@@ -13,3 +13,10 @@ export declare function shuffle<T>(array: ReadonlyArray<T>, randomSeed: number |
 export declare function constrainedShuffle<T>(array: readonly T[], random: RNG, isValidShuffle: (shuffled: readonly T[]) => boolean): T[];
 export declare function randomIntInRange(min: number, max: number, random: RNG): number;
 export declare const random: RNG;
+/**
+ * Randomizes an array using the sort-by-random-key method
+ *
+ * @param inputArray - The array of elements to randomize
+ * @returns A new array containing the same elements in randomized order
+ */
+export declare function randomizeArrayElements<T>(inputArray: ReadonlyArray<T>): T[];

package/dist/validation.types.d.ts

@@ -30,8 +30,8 @@
  */
 import type { GrapherAnswerTypes, PerseusDropdownChoice, PerseusExpressionAnswerForm, PerseusGradedGroupSetWidgetOptions, PerseusGradedGroupWidgetOptions, PerseusGraphType, PerseusGroupWidgetOptions, PerseusMatrixWidgetAnswers, PerseusNumericInputAnswer, PerseusOrdererWidgetOptions, PerseusRadioChoice, PerseusGraphCorrectType, MakeWidgetMap, PerseusFreeResponseWidgetScoringCriterion } from "./data-schema";
 import type { Relationship } from "./types";
-export type WidgetValidatorFunction = (userInput: UserInput, validationData: ValidationData, locale: string) => ValidationResult;
-export type WidgetScorerFunction = (userInput: UserInput, rubric: Rubric, locale?: string) => PerseusScore;
+export type WidgetValidatorFunction = (userInput: UserInput | undefined, validationData: ValidationData, locale: string) => ValidationResult;
+export type WidgetScorerFunction = (userInput: UserInput | undefined, rubric: Rubric, locale?: string) => PerseusScore;
 export type PerseusScore = {
     type: "invalid";
     message?: string | null | undefined;
@@ -50,7 +50,7 @@ export type PerseusCategorizerRubric = {
     values: number[];
 } & PerseusCategorizerValidationData;
 export type PerseusCategorizerUserInput = {
-    values: PerseusCategorizerRubric["values"];
+    values: Array<number | null | undefined>;
 };
 export type PerseusCategorizerValidationData = {
     items: string[];

package/dist/widgets/radio/derive-num-correct.d.ts

@@ -1,2 +1,5 @@
-import type { PerseusRadioWidgetOptions } from "../../data-schema";
-export declare function deriveNumCorrect(choices: PerseusRadioWidgetOptions["choices"]): number;
+interface Choice {
+    correct?: boolean;
+}
+export declare function deriveNumCorrect(choices: Choice[]): number;
+export {};

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

@@ -1,7 +1,7 @@
 import type { PerseusRadioChoice, PerseusRadioWidgetOptions } from "../../data-schema";
 /**
  * For details on the individual options, see the
- * PerseusRadioWidgetOptions type
+ * PerseusRadioWidgetOptions type.
  */
 export type RadioPublicWidgetOptions = {
     choices: ReadonlyArray<RadioChoicePublicData>;
@@ -15,7 +15,7 @@ export type RadioPublicWidgetOptions = {
 /**
  * Only the options from each Radio choice that should be exposed to the client.
  */
-type RadioChoicePublicData = Pick<PerseusRadioChoice, "content" | "isNoneOfTheAbove">;
+type RadioChoicePublicData = Pick<PerseusRadioChoice, "id" | "content" | "isNoneOfTheAbove">;
 /**
  * Shared functionality to determine if numCorrect is used, because:
  *

package/package.json

@@ -3,7 +3,7 @@
   "description": "Shared Perseus infrastructure",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "18.3.0",
+  "version": "18.5.0",
   "publishConfig": {
     "access": "public"
   },
@@ -18,6 +18,20 @@
   "module": "dist/es/index.js",
   "main": "dist/index.js",
   "source": "src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/es/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "source": "./src/index.ts"
+    },
+    "./item-splitting": {
+      "import": "./dist/es/index.item-splitting.js",
+      "require": "./dist/index.item-splitting.js",
+      "types": "./dist/index.item-splitting.d.ts",
+      "source": "./src/index.item-splitting.ts"
+    }
+  },
   "files": [
     "dist"
   ],