Khan · Myranae · Jun 12, 2025 · Jun 12, 2025 · Jun 12, 2025 · Jun 18, 2025
diff --git a/.changeset/fair-geckos-visit.md b/.changeset/fair-geckos-visit.md
@@ -0,0 +1,6 @@
+---
+"@khanacademy/perseus": major
+"@khanacademy/perseus-dev-ui": patch
+---
+
+Rename getUserInputMap to getUserInput
diff --git a/dev/flipbook.tsx b/dev/flipbook.tsx
@@ -321,7 +321,7 @@ function GradableRenderer(props: QuestionRendererProps) {
                             if (rendererRef.current) {
                                 const score = scorePerseusItem(
                                     question,
-                                    rendererRef.current.getUserInputMap(),
+                                    rendererRef.current.getUserInput(),
                                     "en",
                                 );
                                 setScore(score);

diff --git a/packages/perseus/src/__tests__/renderer-api.test.tsx b/packages/perseus/src/__tests__/renderer-api.test.tsx
@@ -50,7 +50,7 @@ describe("Perseus API", function () {
 
             const score = scorePerseusItemTesting(
                 mockWidget1Item.question,
-                renderer.getUserInputMap(),
+                renderer.getUserInput(),
             );
 
             // Assert
@@ -66,7 +66,7 @@ describe("Perseus API", function () {
 
             const score = scorePerseusItemTesting(
                 mockWidget1Item.question,
-                renderer.getUserInputMap(),
+                renderer.getUserInput(),
             );
 
             // Assert
@@ -81,7 +81,7 @@ describe("Perseus API", function () {
 
             let score = scorePerseusItemTesting(
                 mockWidget1Item.question,
-                renderer.getUserInputMap(),
+                renderer.getUserInput(),
             );
 
             expect(score).toHaveBeenAnsweredIncorrectly();
@@ -90,7 +90,7 @@ describe("Perseus API", function () {
 
             score = scorePerseusItemTesting(
                 mockWidget1Item.question,
-                renderer.getUserInputMap(),
+                renderer.getUserInput(),
             );
 
             expect(score).toHaveInvalidInput();
@@ -101,7 +101,7 @@ describe("Perseus API", function () {
                 const {renderer} = renderQuestion(mockWidget1Item.question);
                 act(() =>
                     renderer.setInputValue(["mock-widget 1"], "3", function () {
-                        const guess = renderer.getUserInputMap()[
+                        const guess = renderer.getUserInput()[
                             "mock-widget 1"
                         ] as PerseusMockWidgetUserInput;
                         expect(guess?.currentValue).toBe("3");

diff --git a/packages/perseus/src/__tests__/renderer.test.tsx b/packages/perseus/src/__tests__/renderer.test.tsx
@@ -866,7 +866,7 @@ describe("renderer", () => {
         await userEvent.click(screen.getByRole("combobox"));
         await userEvent.click(screen.getAllByRole("option")[1]);
 
-        expect(renderer.getUserInputMap()).toEqual({
+        expect(renderer.getUserInput()).toEqual({
             "dropdown 1": {
                 value: 1,
             },
@@ -876,7 +876,7 @@ describe("renderer", () => {
         rerender(answerful.question);
 
         // Assert
-        expect(renderer.getUserInputMap()).toEqual({
+        expect(renderer.getUserInput()).toEqual({
             "dropdown 1": {
                 value: 1,
             },
@@ -1649,7 +1649,7 @@ describe("renderer", () => {
         });
     });
 
-    describe("getUserInputMap", () => {
+    describe("getUserInput", () => {
         it("should return user input for all rendered widgets", async () => {
             // Arrange
             const {renderer} = renderQuestion({
@@ -1675,7 +1675,7 @@ describe("renderer", () => {
             await userEvent.click(screen.getAllByRole("option")[1]);
 
             // Act
-            const userInput = renderer.getUserInputMap();
+            const userInput = renderer.getUserInput();
 
             // Assert
             expect(userInput).toMatchInlineSnapshot(`

diff --git a/packages/perseus/src/components/__tests__/sorter.test.tsx b/packages/perseus/src/components/__tests__/sorter.test.tsx
@@ -95,7 +95,7 @@ describe("sorter widget", () => {
             // Act
             const score = scorePerseusItemTesting(
                 answerfulItem.question,
-                renderer.getUserInputMap(),
+                renderer.getUserInput(),
             );
 
             // Assert
@@ -117,7 +117,7 @@ describe("sorter widget", () => {
 
             const score = scorePerseusItemTesting(
                 answerfulItem.question,
-                renderer.getUserInputMap(),
+                renderer.getUserInput(),
             );
 
             // Assert
@@ -134,7 +134,7 @@ describe("sorter widget", () => {
 
             const score = scorePerseusItemTesting(
                 answerfulItem.question,
-                renderer.getUserInputMap(),
+                renderer.getUserInput(),
             );
 
             // Assert

diff --git a/packages/perseus/src/renderer.tsx b/packages/perseus/src/renderer.tsx
@@ -1580,7 +1580,7 @@ class Renderer
         return emptyWidgetsFunctional(
             this.state.widgetInfo,
             this.widgetIds,
-            this.getUserInputMap(),
+            this.getUserInput(),
             this.context.locale,
         );
     }
@@ -1664,7 +1664,7 @@ class Renderer
     /**
      * Returns an object of the widget `.getUserInput()` results
      */
-    getUserInputMap(): UserInputMap {
+    getUserInput(): UserInputMap {
         const userInputMap = {};
         this.widgetIds.forEach((id: string) => {
             const widget = this.getWidgetInstance(id);
@@ -1715,7 +1715,7 @@ class Renderer
         const scores = scoreWidgetsFunctional(
             this.state.widgetInfo,
             this.widgetIds,
-            this.getUserInputMap(),
+            this.getUserInput(),
             this.context.locale,
         );
         const combinedScore = flattenScores(scores);

diff --git a/packages/perseus/src/server-item-renderer.tsx b/packages/perseus/src/server-item-renderer.tsx
@@ -321,7 +321,7 @@ export class ServerItemRenderer
 
         // Call the interactionCallback, if it exists, with the current user input data
         this.props.apiOptions?.interactionCallback?.(
-            this.questionRenderer.getUserInputMap(),
+            this.questionRenderer.getUserInput(),
         );
     };
 
@@ -347,7 +347,7 @@ export class ServerItemRenderer
      * Returns an object of the widget `.getUserInput()` results
      */
     getUserInput(): UserInputMap {
-        return this.questionRenderer.getUserInputMap();
+        return this.questionRenderer.getUserInput();
     }
 
     /**

diff --git a/packages/perseus/src/widgets/categorizer/categorizer.test.ts b/packages/perseus/src/widgets/categorizer/categorizer.test.ts
@@ -67,7 +67,7 @@ describe("categorizer widget", () => {
         // Act
         const score = scorePerseusItem(
             question1,
-            renderer.getUserInputMap(),
+            renderer.getUserInput(),
             "en",
         );
 
@@ -90,7 +90,7 @@ describe("categorizer widget", () => {
         // act
         const score = scorePerseusItem(
             question1,
-            renderer.getUserInputMap(),
+            renderer.getUserInput(),
             "en",
         );
 
@@ -129,7 +129,7 @@ describe("categorizer widget", () => {
 
         const score = scorePerseusItemTesting(
             question1,
-            renderer.getUserInputMap(),
+            renderer.getUserInput(),
         );
 
         // assert
@@ -203,7 +203,7 @@ describe("categorizer widget", () => {
                 })[1],
             );
 
-            const userInput = renderer.getUserInputMap();
+            const userInput = renderer.getUserInput();
             const score = scorePerseusItem(
                 getAnswerfulItem("categorizer", options).question,
                 userInput,

diff --git a/packages/perseus/src/widgets/cs-program/cs-program.test.ts b/packages/perseus/src/widgets/cs-program/cs-program.test.ts
@@ -45,7 +45,7 @@ describe("cs-program widget", () => {
         } as const;
 
         const {renderer} = renderQuestion(question1, apiOptions);
-        const userInput = renderer.getUserInputMap()[
+        const userInput = renderer.getUserInput()[
             "cs-program 1"
         ] as PerseusCSProgramUserInput;
 

diff --git a/packages/perseus/src/widgets/definition/definition.test.ts b/packages/perseus/src/widgets/definition/definition.test.ts
@@ -130,7 +130,7 @@ describe("Definition widget", () => {
         // Act
         const score = scorePerseusItemTesting(
             question,
-            renderer.getUserInputMap(),
+            renderer.getUserInput(),
         );
 
         // Assert

diff --git a/packages/perseus/src/widgets/deprecated-standin/deprecated-standin.test.ts b/packages/perseus/src/widgets/deprecated-standin/deprecated-standin.test.ts
@@ -48,7 +48,7 @@ describe("Deprecated Standin widget", () => {
         // Act
         const score = scorePerseusItemTesting(
             question,
-            renderer.getUserInputMap(),
+            renderer.getUserInput(),
         );
 
         // Assert

diff --git a/packages/perseus/src/widgets/dropdown/dropdown.test.ts b/packages/perseus/src/widgets/dropdown/dropdown.test.ts
@@ -72,7 +72,7 @@ describe("Dropdown widget", () => {
         await userEvent.click(screen.getByText("less than or equal to"));
         const score = scorePerseusItemTesting(
             basicDropdown,
-            renderer.getUserInputMap(),
+            renderer.getUserInput(),
         );
 
         // Assert
@@ -90,7 +90,7 @@ describe("Dropdown widget", () => {
         await userEvent.click(screen.getByText("greater than or equal to"));
         const score = scorePerseusItemTesting(
             basicDropdown,
-            renderer.getUserInputMap(),
+            renderer.getUserInput(),
         );
 
         // Assert
@@ -105,7 +105,7 @@ describe("Dropdown widget", () => {
         // Act
         const score = scorePerseusItemTesting(
             basicDropdown,
-            renderer.getUserInputMap(),
+            renderer.getUserInput(),
         );
 
         // Assert
@@ -214,7 +214,7 @@ describe("Dropdown widget", () => {
                     screen.getByRole("option", {name: "Correct"}),
                 );
 
-                const userInput = renderer.getUserInputMap();
+                const userInput = renderer.getUserInput();
                 const score = scorePerseusItem(
                     getAnswerfulItem().question,
                     userInput,

diff --git a/packages/perseus/src/widgets/expression/expression.test.tsx b/packages/perseus/src/widgets/expression/expression.test.tsx
@@ -59,7 +59,7 @@ const assertCorrect = async (
     );
     const score = scorePerseusItemTesting(
         itemData.question,
-        renderer.getUserInputMap(),
+        renderer.getUserInput(),
     );
     expect(score).toHaveBeenAnsweredCorrectly();
 };
@@ -77,7 +77,7 @@ const assertIncorrect = async (
     );
     const score = scorePerseusItemTesting(
         itemData.question,
-        renderer.getUserInputMap(),
+        renderer.getUserInput(),
     );
     expect(score).toHaveBeenAnsweredIncorrectly();
 };
@@ -98,7 +98,7 @@ const assertInvalid = async (
     act(() => jest.runOnlyPendingTimers());
     const score = scorePerseusItemTesting(
         itemData.question,
-        renderer.getUserInputMap(),
+        renderer.getUserInput(),
     );
     expect(score).toHaveInvalidInput();
 };
@@ -465,7 +465,7 @@ describe("Expression Widget", function () {
             act(() => jest.runOnlyPendingTimers());
             const score = scorePerseusItem(
                 expressionItem2.question,
-                renderer.getUserInputMap(),
+                renderer.getUserInput(),
                 "en",
             );
 
@@ -489,7 +489,7 @@ describe("Expression Widget", function () {
             // act
             const score = scorePerseusItem(
                 expressionItem2.question,
-                renderer.getUserInputMap(),
+                renderer.getUserInput(),
                 "en",
             );
 
@@ -715,7 +715,7 @@ describe("Expression Widget", function () {
                 await userEvent.click(screen.getByRole("button", {name: "i"}));
                 act(() => jest.runOnlyPendingTimers());
 
-                const userInput = renderer.getUserInputMap();
+                const userInput = renderer.getUserInput();
                 const score = scorePerseusItem(
                     getFullItem().question,
                     userInput,

diff --git a/packages/perseus/src/widgets/free-response/free-response.test.tsx b/packages/perseus/src/widgets/free-response/free-response.test.tsx
@@ -124,7 +124,7 @@ describe("free-response widget", () => {
         );
 
         // Act
-        const userInput = renderer.getUserInputMap();
+        const userInput = renderer.getUserInput();
 
         // Assert
         expect(userInput).toMatchObject({