@khanacademy/perseus 67.2.0 → 68.0.1

package/dist/mixins/widget-prop-denylist.d.ts

@@ -11,7 +11,7 @@
  */
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare const denylist: string[];
 export declare function excludeDenylistKeys(obj: Record<any, any>): {};

package/dist/renderer.d.ts

@@ -5,8 +5,8 @@ import TranslationLinter from "./translation-linter";
 import WidgetContainer from "./widget-container";
 import type { DependenciesContext } from "./dependencies";
 import type { PerseusStrings } from "./strings";
-import type { APIOptions, APIOptionsWithDefaults, FilterCriterion, FocusPath, SerializedState, Widget, WidgetProps } from "./types";
-import type { HandleUserInputCallback, InitializeUserInputCallback, RestoreUserInputFromSerializedStateCallback } from "./user-input-manager";
+import type { APIOptions, APIOptionsWithDefaults, FilterCriterion, FocusPath, Widget, WidgetProps } from "./types";
+import type { HandleUserInputCallback, InitializeUserInputCallback } from "./user-input-manager";
 import type { GetPromptJSONInterface, RendererPromptJSON } from "./widget-ai-utils/prompt-types";
 import type { KeypadAPI } from "@khanacademy/math-input";
 import type { PerseusRenderer, PerseusWidget, PerseusWidgetOptions, PerseusWidgetsMap, ShowSolutions, PerseusScore, UserInputMap, UserInputArray } from "@khanacademy/perseus-core";
@@ -24,7 +24,6 @@ type Props = Partial<React.ContextType<typeof DependenciesContext>> & {
     userInput?: UserInputMap;
     handleUserInput?: HandleUserInputCallback;
     initializeUserInput?: InitializeUserInputCallback;
-    restoreUserInputFromSerializedState?: RestoreUserInputFromSerializedStateCallback;
     apiOptions?: APIOptions;
     alwaysUpdate?: boolean;
     findExternalWidgets: any;
@@ -43,10 +42,6 @@ type Props = Partial<React.ContextType<typeof DependenciesContext>> & {
      */
     showSolutions?: ShowSolutions;
     content: PerseusRenderer["content"];
-    /**
-     * @deprecated - do not use in new code.
-     */
-    serializedState?: any;
     /**
      * If linterContext.highlightLint is true, then content will be passed to
      * the linter and any warnings will be highlighted in the rendered output.
@@ -69,7 +64,7 @@ type State = {
     jiptContent: any;
     lastUsedWidgetId: string | null | undefined;
 };
-type DefaultProps = Required<Pick<Props, "alwaysUpdate" | "content" | "findExternalWidgets" | "highlightedWidgets" | "images" | "linterContext" | "onInteractWithWidget" | "onRender" | "questionCompleted" | "showSolutions" | "reviewMode" | "serializedState" | "widgets">>;
+type DefaultProps = Required<Pick<Props, "alwaysUpdate" | "content" | "findExternalWidgets" | "highlightedWidgets" | "images" | "linterContext" | "onInteractWithWidget" | "onRender" | "questionCompleted" | "showSolutions" | "reviewMode" | "widgets">>;
 /**
  * We want to be able to reset the question state when we go
  * from one question to another question. However it's kind of tricky:
@@ -114,13 +109,11 @@ declare class Renderer extends React.Component<Props, State> implements GetPromp
     _getDefaultWidgetInfo: (widgetId: string) => any;
     _getWidgetInfo: (widgetId: string) => PerseusWidget;
     renderWidget: (impliedType: string, id: string, state: WidgetState) => null | React.ReactNode;
+    _getWidgetIndexById(id: string): number;
     getWidgetProps(widgetId: string): WidgetProps<any, any, PerseusWidgetOptions>;
     /**
      * Serializes the questions state so it can be recovered.
      *
-     * The return value of this function can be sent to the
-     * `restoreSerializedState` method to restore this state.
-     *
      * If an instance of widgetProps is passed in, it generates the serialized
      * state from that instead of the current widget props.
      */
@@ -130,10 +123,6 @@ declare class Renderer extends React.Component<Props, State> implements GetPromp
     getSerializedState: (widgetProps?: any) => {
         [id: string]: any;
     };
-    /**
-     * @deprecated - do not use in new code.
-     */
-    restoreSerializedState: (serializedState: SerializedState, callback?: () => void) => void;
     /**
      * Allows inter-widget communication.
      *
@@ -196,7 +185,7 @@ declare class Renderer extends React.Component<Props, State> implements GetPromp
      * Serializes widget state. Seems to be used only by editors though.
      *
      * @deprecated and likely a very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     serialize: () => Record<any, any>;
     /**

package/dist/server-item-renderer.d.ts

@@ -53,7 +53,7 @@ type State = {
 };
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 type SerializedState = {
     question: any;
@@ -117,10 +117,6 @@ export declare class ServerItemRenderer extends React.Component<Props, State> im
      * @deprecated - do not use in new code.
      */
     getSerializedState(): SerializedState;
-    /**
-     * @deprecated - do not use in new code.
-     */
-    restoreSerializedState(state: SerializedState, callback?: () => void): void;
     setAssetStatus: (assetKey: string, status: boolean) => void;
     render(): React.ReactNode;
 }

package/dist/types.d.ts

@@ -14,15 +14,14 @@ export type Dimensions = {
 };
 export type DeviceType = "phone" | "tablet" | "desktop";
 /**
- * This is the type returned by a widget's `getSerializedState` function (and
- * provided to the same widget's `restoreSerializedState` function). However,
+ * This is the type returned by a widget's `getSerializedState` function. However,
  * note that in most cases the widgets do _not_ implement these functions.
  * In that case, the `Renderer` just returns the widget's render props as the
  * serialized state.
  */
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 export type SerializedState = Record<string, any>;
 /**
@@ -47,19 +46,13 @@ export interface Widget {
     } | boolean;
     getDOMNodeForPath?: (path: FocusPath) => Element | Text | null;
     /**
-     * Returns widget state that can be passed back to `restoreSerializedState`
-     * to put the widget back into exactly the same state. If the widget does
-     * not implement this function, the renderer simply returns all of the
-     * widget's props.
+     * If the widget does not implement this function,
+     * the renderer simply returns all of the widget's props.
      */
     /**
      * @deprecated - do not use in new code.
      */
     getSerializedState?: () => SerializedState;
-    /**
-     * @deprecated - do not use in new code.
-     */
-    restoreSerializedState?: (props: any, callback: () => void) => any;
     blurInputPath?: (path: FocusPath) => void;
     focusInputPath?: (path: FocusPath) => void;
     getInputPaths?: () => ReadonlyArray<FocusPath>;
@@ -395,6 +388,7 @@ export type UniversalWidgetProps<ReviewModeRubric = Empty, TUserInput = Empty, T
     reviewModeRubric?: ReviewModeRubric | null | undefined;
     trackInteraction: (extraData?: TrackingExtraArgs) => void;
     widgetId: string;
+    widgetIndex: number;
     alignment: string | null | undefined;
     static: boolean | null | undefined;
     problemNum: number | null | undefined;

package/dist/user-input-manager.d.ts

@@ -1,19 +1,15 @@
 import type { PerseusWidgetsMap, UserInputMap } from "@khanacademy/perseus-core";
 export type InitializeUserInputCallback = (widgetOptions: PerseusWidgetsMap, problemNum: number) => void;
-export type RestoreUserInputFromSerializedStateCallback = (serializedState: unknown, widgetOptions: PerseusWidgetsMap) => void;
 export type HandleUserInputCallback = (widgetId: string, userInput: UserInputMap[keyof UserInputMap], widgetsEmpty: boolean) => void;
 type FunctionChildParams = {
     userInput: UserInputMap;
     handleUserInput: HandleUserInputCallback;
     initializeUserInput: InitializeUserInputCallback;
-    /**
-     * @deprecated - do not use in new code.
-     */
-    restoreUserInputFromSerializedState: RestoreUserInputFromSerializedStateCallback;
 };
 type Props = {
     widgets: PerseusWidgetsMap;
     problemNum: number;
+    initialUserInput?: UserInputMap;
     handleUserInput?: (userInput: UserInputMap, widgetsEmpty: boolean) => void;
     children: (payload: FunctionChildParams) => JSX.Element | null;
 };

package/dist/util/extract-widget-ids.d.ts

@@ -0,0 +1,8 @@
+import type { PerseusRenderer } from "@khanacademy/perseus-core";
+/**
+ * Extracts widget IDs from a PerseusRenderer in the order they appear in the content.
+ * Handles deduplication by only including the first occurrence of each widget ID.
+ */
+export declare function extractWidgetIds(perseusRenderer: PerseusRenderer, options?: {
+    inline?: boolean;
+}): ReadonlyArray<string>;

package/dist/widgets/categorizer/categorizer.d.ts

@@ -20,7 +20,7 @@ export declare class Categorizer extends React.Component<Props, State> implement
     state: State;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): any;
     getPromptJSON(): CategorizerPromptJSON;
@@ -34,7 +34,7 @@ type RenderProps = {
 };
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusCategorizerUserInput;
 /**

package/dist/widgets/cs-program/cs-program.d.ts

@@ -22,7 +22,7 @@ declare class CSProgram extends React.Component<Props> implements Widget {
 }
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusCSProgramUserInput;
 declare function getStartUserInput(): PerseusCSProgramUserInput;

package/dist/widgets/dropdown/dropdown.d.ts

@@ -20,22 +20,14 @@ declare class Dropdown extends React.Component<Props> implements Widget {
     getPromptJSON(): DropdownPromptJSON;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): any;
-    /**
-     * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
-     */
-    restoreSerializedState(state: any): {
-        state: any;
-        choices: any;
-    };
     render(): React.ReactNode;
 }
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusDropdownUserInput;
 declare function getStartUserInput(): PerseusDropdownUserInput;

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

@@ -49,7 +49,7 @@ export declare class Expression extends React.Component<Props> implements Widget
     getKeypadConfiguration(): KeypadConfiguration;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): {
         value: string;
@@ -64,6 +64,7 @@ export declare class Expression extends React.Component<Props> implements Widget
         reviewModeRubric?: Empty | null | undefined;
         trackInteraction: (extraData?: Empty | undefined) => void;
         widgetId: string;
+        widgetIndex: number;
         alignment: string | null | undefined;
         static: boolean | null | undefined;
         problemNum: number | null | undefined;
@@ -137,7 +138,7 @@ export declare class Expression extends React.Component<Props> implements Widget
 }
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusExpressionUserInput;
 declare function getStartUserInput(): PerseusExpressionUserInput;
@@ -155,7 +156,7 @@ declare const _default: {
         times: NonNullable<ExternalProps["times"]>;
         visibleLabel: PerseusExpressionWidgetOptions["visibleLabel"];
         ariaLabel: PerseusExpressionWidgetOptions["ariaLabel"];
-    }, "static" | "onChange" | "ariaLabel" | "extraKeys" | "buttonsVisible" | "trackInteraction" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "keypadElement" | "isLastUsedWidget" | "handleUserInput" | "showSolutions" | "reviewMode" | "reviewModeRubric" | keyof import("../..").PerseusDependenciesV2 | "alignment" | "visibleLabel" | "answerForms"> & {
+    }, "static" | "onChange" | "ariaLabel" | "extraKeys" | "buttonsVisible" | "trackInteraction" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "keypadElement" | "isLastUsedWidget" | "handleUserInput" | "showSolutions" | "reviewMode" | "reviewModeRubric" | "widgetIndex" | keyof import("../..").PerseusDependenciesV2 | "alignment" | "visibleLabel" | "answerForms"> & {
         buttonSets?: import("@khanacademy/perseus-core").LegacyButtonSets | undefined;
         onFocus?: ((blurPath: import("../..").FocusPath) => void) | undefined;
         onBlur?: ((blurPath: import("../..").FocusPath) => void) | undefined;

package/dist/widgets/grapher/grapher.d.ts

@@ -23,7 +23,7 @@ declare class Grapher extends React.Component<Props> implements Widget {
     getPromptJSON(): GrapherPromptJSON;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): {
         plot: import("@khanacademy/perseus-core").GrapherAnswerTypes;
@@ -55,6 +55,7 @@ declare class Grapher extends React.Component<Props> implements Widget {
         reviewModeRubric?: Empty | null | undefined;
         trackInteraction: (extraData?: Empty | undefined) => void;
         widgetId: string;
+        widgetIndex: number;
         alignment: string | null | undefined;
         static: boolean | null | undefined;
         problemNum: number | null | undefined;
@@ -122,7 +123,7 @@ declare class Grapher extends React.Component<Props> implements Widget {
 }
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusGrapherUserInput;
 declare function getStartUserInput(options: GrapherPublicWidgetOptions): PerseusGrapherUserInput;

package/dist/widgets/group/group.d.ts

@@ -31,10 +31,6 @@ declare class Group extends React.Component<Props> implements Widget {
      * @deprecated - do not use in new code.
      */
     getSerializedState: () => any;
-    /**
-     * @deprecated - do not use in new code.
-     */
-    restoreSerializedState: (arg1: any, arg2: any) => null;
     getInputPaths(): readonly FocusPath[];
     focus(): boolean;
     focusInputPath: (arg1: FocusPath) => void;

package/dist/widgets/iframe/iframe.d.ts

@@ -30,7 +30,7 @@ declare class Iframe extends React.Component<Props> implements Widget {
 }
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusIFrameUserInput;
 declare function getStartUserInput(): PerseusIFrameUserInput;

package/dist/widgets/image/image-description-and-caption.d.ts

@@ -0,0 +1,12 @@
+import * as React from "react";
+import type { APIOptions } from "../../types";
+import type { PerseusImageBackground } from "@khanacademy/perseus-core";
+import type { LinterContextProps } from "@khanacademy/perseus-linter";
+interface Props {
+    caption: string;
+    backgroundImage: PerseusImageBackground;
+    apiOptions: APIOptions;
+    linterContext: LinterContextProps;
+}
+export declare const ImageDescriptionAndCaption: ({ caption, backgroundImage, apiOptions, linterContext, }: Props) => React.JSX.Element;
+export {};

package/dist/widgets/input-number/input-number.d.ts

@@ -28,7 +28,7 @@ declare class InputNumber extends React.Component<Props> implements Widget {
     examples(): ReadonlyArray<string>;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): any;
     render(): React.ReactNode;
@@ -36,7 +36,7 @@ declare class InputNumber extends React.Component<Props> implements Widget {
 declare function getOneCorrectAnswerFromRubric(rubric: any): string | undefined;
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusInputNumberUserInput;
 declare function getStartUserInput(): PerseusInputNumberUserInput;

package/dist/widgets/interactive-graphs/interactive-graph.d.ts

@@ -131,7 +131,7 @@ declare class InteractiveGraph extends React.Component<Props, State> {
     getPromptJSON(): InteractiveGraphPromptJSON | UnsupportedWidgetPromptJSON;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): {
         graph: PerseusGraphType;
@@ -156,6 +156,7 @@ declare class InteractiveGraph extends React.Component<Props, State> {
         reviewModeRubric?: Empty | null | undefined;
         trackInteraction: (extraData?: Empty | undefined) => void;
         widgetId: string;
+        widgetIndex: number;
         alignment: string | null | undefined;
         static: boolean | null | undefined;
         problemNum: number | null | undefined;
@@ -271,7 +272,7 @@ declare class InteractiveGraph extends React.Component<Props, State> {
 }
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusInteractiveGraphUserInput;
 declare function getStartUserInput(options: InteractiveGraphPublicWidgetOptions): PerseusGraphType;

package/dist/widgets/label-image/label-image.d.ts

@@ -94,7 +94,7 @@ export declare class LabelImage extends React.Component<Props, LabelImageState>
     renderInstructions(): React.ReactNode;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): any;
     render(): React.ReactNode;
@@ -102,7 +102,7 @@ export declare class LabelImage extends React.Component<Props, LabelImageState>
 declare function getStartUserInput(options: LabelImagePublicWidgetOptions): PerseusLabelImageUserInput;
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusLabelImageUserInput;
 declare const _default: {

package/dist/widgets/matcher/matcher.d.ts

@@ -37,7 +37,7 @@ export declare class Matcher extends React.Component<Props, State> implements Wi
 declare function getStartUserInput(options: MatcherPublicWidgetOptions, problemNum: number): PerseusMatcherUserInput;
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusMatcherUserInput;
 declare const _default: {

package/dist/widgets/matrix/matrix.d.ts

@@ -40,7 +40,7 @@ declare class Matrix extends React.Component<Props, State> implements Widget {
     getPromptJSON(): MatrixPromptJSON;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): any;
     render(): React.ReactNode;
@@ -49,7 +49,7 @@ declare function getStartUserInput(): PerseusMatrixUserInput;
 declare function getCorrectUserInput(options: PerseusMatrixWidgetOptions): PerseusMatrixUserInput;
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusMatrixUserInput;
 declare const _default: {

package/dist/widgets/mock-widgets/mock-widget.d.ts

@@ -31,7 +31,7 @@ declare class MockWidgetComponent extends React.Component<Props> implements Widg
     handleChange: (newValue: string, cb?: () => unknown | null | undefined) => void;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): {
         currentValue: string;
@@ -40,6 +40,7 @@ declare class MockWidgetComponent extends React.Component<Props> implements Widg
         reviewModeRubric?: Empty | null | undefined;
         trackInteraction: (extraData?: Empty | undefined) => void;
         widgetId: string;
+        widgetIndex: number;
         alignment: string | null | undefined;
         problemNum: number | null | undefined;
         apiOptions: Readonly<Readonly<{
@@ -106,7 +107,7 @@ declare class MockWidgetComponent extends React.Component<Props> implements Widg
 }
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusMockWidgetUserInput;
 declare function getStartUserInput(options: PerseusMockWidgetUserInput): {

package/dist/widgets/number-line/number-line.d.ts

@@ -73,7 +73,7 @@ declare class NumberLine extends React.Component<Props, State> implements Widget
     getPromptJSON(): NumberLinePromptJSON;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): {
         alignment: string | null | undefined;
@@ -95,7 +95,7 @@ declare class NumberLine extends React.Component<Props, State> implements Widget
 }
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusNumberLineUserInput;
 declare function getCorrectUserInput(options: PerseusNumberLineWidgetOptions): PerseusNumberLineUserInput;

package/dist/widgets/numeric-input/numeric-input.class.d.ts

@@ -35,7 +35,7 @@ export declare class NumericInput extends React.Component<NumericInputProps> imp
     getPromptJSON(): NumericInputPromptJSON;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): {
         currentValue: string;
@@ -47,6 +47,7 @@ export declare class NumericInput extends React.Component<NumericInputProps> imp
         reviewModeRubric?: Empty | null | undefined;
         trackInteraction: (extraData?: Empty | undefined) => void;
         widgetId: string;
+        widgetIndex: number;
         alignment: string | null | undefined;
         problemNum: number | null | undefined;
         apiOptions: Readonly<Readonly<{
@@ -115,7 +116,7 @@ export declare class NumericInput extends React.Component<NumericInputProps> imp
 declare function getStartUserInput(): PerseusNumericInputUserInput;
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusNumericInputUserInput;
 declare const _default: {

package/dist/widgets/orderer/orderer.d.ts

@@ -35,14 +35,14 @@ declare class Orderer extends React.Component<OrdererProps, OrdererState> implem
     getPromptJSON(): OrdererPromptJSON;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): any;
     render(): React.ReactNode;
 }
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusOrdererUserInput;
 declare function getStartUserInput(): PerseusOrdererUserInput;

package/dist/widgets/plotter/plotter.d.ts

@@ -74,7 +74,7 @@ export declare class Plotter extends React.Component<Props, State> implements Wi
     getPromptJSON(): UnsupportedWidgetPromptJSON;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): {
         values: PerseusPlotterUserInput;
@@ -93,6 +93,7 @@ export declare class Plotter extends React.Component<Props, State> implements Wi
         reviewModeRubric?: Empty | null | undefined;
         trackInteraction: (extraData?: Empty | undefined) => void;
         widgetId: string;
+        widgetIndex: number;
         alignment: string | null | undefined;
         static: boolean | null | undefined;
         problemNum: number | null | undefined;
@@ -162,7 +163,7 @@ declare function getStartUserInput(options: PlotterPublicWidgetOptions): Perseus
 declare function getCorrectUserInput(options: PerseusPlotterWidgetOptions): PerseusPlotterUserInput;
 /**
  * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ * [LEMS-3185] do not trust serializedState
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusPlotterUserInput;
 declare const _default: {

package/dist/widgets/radio/multiple-choice-widget.new.d.ts

@@ -1,5 +1,4 @@
 import * as React from "react";
-import type { PerseusStrings } from "../../strings";
 import type { ChoiceState, Widget } from "../../types";
 import type { PerseusRadioChoice, PerseusRadioRubric, PerseusRadioUserInput } from "@khanacademy/perseus-core";
 /**
@@ -26,10 +25,7 @@ export type RenderProps = {
     countChoices?: boolean;
     deselectEnabled?: boolean;
     choices: ReadonlyArray<RadioChoiceWithMetadata>;
-    selectedChoices: ReadonlyArray<PerseusRadioChoice["correct"]>;
     choiceStates?: ReadonlyArray<ChoiceState>;
-    values?: ReadonlyArray<boolean>;
-    strings?: PerseusStrings;
     editMode?: boolean;
     labelWrap?: boolean;
 };

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

@@ -3,18 +3,16 @@ import { PerseusI18nContext } from "../../components/i18n-context";
 import type { FocusFunction } from "./base-radio";
 import type { WidgetProps, ChoiceState, Widget } from "../../types";
 import type { RadioPromptJSON } from "../../widget-ai-utils/radio/radio-ai-utils";
-import type { PerseusRadioChoice, ShowSolutions, PerseusRadioRubric, PerseusRadioUserInput } from "@khanacademy/perseus-core";
-export type RenderProps = {
+import type { PerseusRadioChoice, ShowSolutions, PerseusRadioRubric, PerseusRadioUserInput, PerseusRadioWidgetOptions } from "@khanacademy/perseus-core";
+export type RenderProps = PerseusRadioWidgetOptions & {
     numCorrect: number;
     hasNoneOfTheAbove?: boolean;
     multipleSelect?: boolean;
     countChoices?: boolean;
     deselectEnabled?: boolean;
     choices: RadioChoiceWithMetadata[];
-    selectedChoices: PerseusRadioChoice["correct"][];
     showSolutions?: ShowSolutions;
     choiceStates?: ChoiceState[];
-    values?: boolean[];
 };
 export type Props = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>;
 type DefaultProps = Required<Pick<Props, "choices" | "multipleSelect" | "countChoices" | "deselectEnabled" | "linterContext" | "showSolutions">>;

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

@@ -1,6 +1,4 @@
 import Radio from "./radio.ff";
-import type { RenderProps } from "./radio-component";
-import type { PerseusStrings } from "../../strings";
 import type { PerseusRadioUserInput, PerseusRadioWidgetOptions } from "@khanacademy/perseus-core";
 declare function getStartUserInput(): PerseusRadioUserInput;
 declare function getCorrectUserInput(options: PerseusRadioWidgetOptions): PerseusRadioUserInput;
@@ -8,8 +6,6 @@ declare const _default: {
     name: string;
     displayName: string;
     widget: typeof Radio;
-    transform: (widgetOptions: PerseusRadioWidgetOptions, strings: PerseusStrings) => RenderProps;
-    staticTransform: (widgetOptions: PerseusRadioWidgetOptions, strings: PerseusStrings) => RenderProps;
     getStartUserInput: typeof getStartUserInput;
     getCorrectUserInput: typeof getCorrectUserInput;
     version: import("@khanacademy/perseus-core").Version | undefined;

package/dist/widgets/radio/radio.ff.d.ts

@@ -3,6 +3,7 @@ import * as React from "react";
 import RadioOld from "./radio-component";
 import type { RenderProps } from "./radio-component";
 import type { ChoiceState, WidgetProps } from "../../types";
+import type { RadioPromptJSON } from "../../widget-ai-utils/radio/radio-ai-utils";
 type Props = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>;
 type ChoiceStateWithoutSelected = Omit<ChoiceState, "selected">;
 type State = {
@@ -25,22 +26,21 @@ declare class Radio extends RadioOld {
     UNSAFE_componentWillUpdate(nextProps: Props): void;
     /**
      * @deprecated and likely very broken API
-     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     * [LEMS-3185] do not trust serializedState
      */
     getSerializedState(): {
-        numCorrect: number;
+        choices: import("@khanacademy/perseus-core").PerseusRadioChoice[] & import("./radio-component").RadioChoiceWithMetadata[];
         hasNoneOfTheAbove?: boolean;
-        multipleSelect?: boolean;
         countChoices?: boolean;
+        numCorrect: number;
+        multipleSelect?: boolean;
         deselectEnabled?: boolean;
-        choices: import("./radio-component").RadioChoiceWithMetadata[];
-        selectedChoices: import("@khanacademy/perseus-core").PerseusRadioChoice["correct"][];
         showSolutions?: import("@khanacademy/perseus-core").ShowSolutions;
         choiceStates?: ChoiceState[];
-        values?: boolean[];
         reviewModeRubric?: PerseusRadioRubric | null | undefined;
         trackInteraction: (extraData?: Empty | undefined) => void;
         widgetId: string;
+        widgetIndex: number;
         alignment: string | null | undefined;
         static: boolean | null | undefined;
         problemNum: number | null | undefined;
@@ -103,6 +103,7 @@ declare class Radio extends RadioOld {
         linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
         containerSizeClass: import("../../util/sizing-utils").SizeClass;
     };
+    getPromptJSON(): RadioPromptJSON;
     _handleChange(arg: {
         choiceStates?: ChoiceState[];
     }): void;