@khanacademy/perseus 65.3.7 → 65.4.0

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { FocusPath, Widget, WidgetProps, UniversalWidgetProps } from "../../types";
 import type { NumberLinePromptJSON } from "../../widget-ai-utils/number-line/number-line-ai-utils";
-import type { Relationship, PerseusNumberLineUserInput, PerseusNumberLineWidgetOptions, NumberLinePublicWidgetOptions } from "@khanacademy/perseus-core";
+import type { PerseusNumberLineUserInput, PerseusNumberLineWidgetOptions, NumberLinePublicWidgetOptions } from "@khanacademy/perseus-core";
 import type { PropsFor } from "@khanacademy/wonder-blocks-core";
 /**
  * The type of `this.props` inside the NumberLine widget.
@@ -13,14 +13,14 @@ type Props = WidgetProps<{
     labelStyle: string;
     labelTicks: boolean;
     divisionRange: number[];
-    numDivisions: number;
     snapDivisions: number;
     isTickCtrl: boolean;
     isInequality: boolean;
-    numLinePosition: number;
-    rel: Relationship;
     showTooltips?: boolean;
-}>;
+}, PerseusNumberLineUserInput>;
+type CalculatedProps = Props & {
+    tickStep: number;
+};
 type DefaultProps = {
     range: Props["range"];
     labelStyle: Props["labelStyle"];
@@ -29,10 +29,8 @@ type DefaultProps = {
     labelTicks: Props["labelTicks"];
     isTickCtrl: Props["isTickCtrl"];
     isInequality: Props["isInequality"];
-    numLinePosition: Props["numLinePosition"];
     snapDivisions: Props["snapDivisions"];
     showTooltips: Props["showTooltips"];
-    rel: Props["rel"];
     apiOptions: Props["apiOptions"];
 };
 /**
@@ -47,7 +45,6 @@ declare class NumberLine extends React.Component<Props, State> implements Widget
     context: React.ContextType<typeof PerseusI18nContext>;
     static defaultProps: DefaultProps;
     state: any;
-    change: (...args: ReadonlyArray<unknown>) => any;
     isValid: () => boolean;
     onNumDivisionsChange: (arg1: number, arg2: any) => void;
     _handleTickCtrlFocus: () => void;
@@ -61,23 +58,121 @@ declare class NumberLine extends React.Component<Props, State> implements Widget
     _renderGraphie: () => React.ReactElement;
     snapNumLinePosition: (arg1: any, arg2: number) => number;
     movePosition: (arg1: number) => void;
-    _renderNumberLinePoint: (arg1: any) => React.ReactElement;
+    _renderNumberLinePoint: (arg1: CalculatedProps) => React.ReactElement;
     handleReverse: () => void;
     handleToggleStrict: () => void;
-    _getInequalityEndpoint: (arg1: any) => [number, number];
-    _renderInequality: (arg1: any) => React.ReactElement;
+    _getInequalityEndpoint(props: CalculatedProps): [number, number];
+    _renderInequality(props: CalculatedProps): React.ReactElement | null;
     _setupGraphie: (arg1: any, arg2: any) => void;
+    /**
+     * TODO: remove this when everything is pulling from Renderer state
+     * @deprecated get user input from Renderer state
+     */
     getUserInput(): PerseusNumberLineUserInput;
     getPromptJSON(): NumberLinePromptJSON;
+    /**
+     * @deprecated and likely very broken API
+     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     */
+    getSerializedState(): {
+        numDivisions: number;
+        numLinePosition: number;
+        rel: string;
+        range: number[];
+        labelRange: Array<number | null>;
+        labelStyle: string;
+        labelTicks: boolean;
+        divisionRange: number[];
+        snapDivisions: number;
+        isTickCtrl: boolean;
+        isInequality: boolean;
+        showTooltips?: boolean;
+        reviewModeRubric?: Empty | null | undefined;
+        trackInteraction: (extraData?: Empty | undefined) => void;
+        widgetId: string;
+        alignment: string | null | undefined;
+        static: boolean | null | undefined;
+        problemNum: number | null | undefined;
+        apiOptions: Readonly<Readonly<{
+            isArticle?: boolean;
+            onFocusChange?: (newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number, focusedElement?: HTMLElement) => unknown;
+            GroupMetadataEditor?: React.ComponentType<any>;
+            showAlignmentOptions?: boolean;
+            readOnly?: boolean;
+            answerableCallback?: (arg1: boolean) => unknown;
+            getAnotherHint?: () => unknown;
+            interactionCallback?: (widgetData: {
+                [widgetId: string]: any;
+            }) => void;
+            groupAnnotator?: (groupNumber: number, widgetId: string) => React.ReactNode;
+            imagePlaceholder?: React.ReactNode;
+            widgetPlaceholder?: React.ReactNode;
+            baseElements?: {
+                Link: React.ComponentType<any>;
+            };
+            imagePreloader?: (dimensions: import("../../types").Dimensions) => React.ReactNode;
+            trackInteraction?: (args: {
+                type: string;
+                id: string;
+                correct?: boolean;
+            } & Partial<import("../../types").TrackingGradedGroupExtraArguments> & Partial<{
+                visible: number;
+            }>) => void;
+            customKeypad?: boolean;
+            nativeKeypadProxy?: (blur: () => void) => import("@khanacademy/math-input").KeypadAPI;
+            isMobile?: boolean;
+            isMobileApp?: boolean;
+            setDrawingAreaAvailable?: (arg1: boolean) => unknown;
+            hintProgressColor?: string;
+            canScrollPage?: boolean;
+            editorChangeDelay?: number;
+            flags?: Record<"new-radio-widget", boolean>;
+            onWidgetStartProps?: (widgets: import("@khanacademy/perseus-core").PerseusWidgetsMap) => void;
+        }> & {
+            baseElements: NonNullable<import("../..").APIOptions["baseElements"]>;
+            canScrollPage: NonNullable<import("../..").APIOptions["canScrollPage"]>;
+            editorChangeDelay: NonNullable<import("../..").APIOptions["editorChangeDelay"]>;
+            groupAnnotator: NonNullable<import("../..").APIOptions["groupAnnotator"]>;
+            isArticle: NonNullable<import("../..").APIOptions["isArticle"]>;
+            isMobile: NonNullable<import("../..").APIOptions["isMobile"]>;
+            isMobileApp: NonNullable<import("../..").APIOptions["isMobileApp"]>;
+            onFocusChange: NonNullable<import("../..").APIOptions["onFocusChange"]>;
+            readOnly: NonNullable<import("../..").APIOptions["readOnly"]>;
+            setDrawingAreaAvailable: NonNullable<import("../..").APIOptions["setDrawingAreaAvailable"]>;
+            showAlignmentOptions: NonNullable<import("../..").APIOptions["showAlignmentOptions"]>;
+        }>;
+        keypadElement?: any;
+        questionCompleted?: boolean;
+        onFocus: (blurPath: FocusPath) => void;
+        onBlur: (blurPath: FocusPath) => void;
+        findWidgets: (criterion: import("../../types").FilterCriterion) => ReadonlyArray<Widget>;
+        reviewMode: boolean;
+        showSolutions?: import("@khanacademy/perseus-core").ShowSolutions;
+        onChange: import("../..").ChangeHandler;
+        handleUserInput: (newUserInput: PerseusNumberLineUserInput, cb?: () => void, silent?: boolean) => void;
+        isLastUsedWidget: boolean;
+        linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
+        containerSizeClass: import("../../util/sizing-utils").SizeClass;
+    };
     render(): React.ReactNode;
 }
-declare function numberLineTransform(editorProps: NumberLinePublicWidgetOptions): RenderProps;
+declare function transform(editorProps: NumberLinePublicWidgetOptions): RenderProps;
 declare function staticTransform(editorProps: PerseusNumberLineWidgetOptions): RenderProps;
+/**
+ * @deprecated and likely a very broken API
+ * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ */
+declare function getUserInputFromSerializedState(serializedState: any): PerseusNumberLineUserInput;
+declare function getCorrectUserInput(options: PerseusNumberLineWidgetOptions): PerseusNumberLineUserInput;
+declare function getStartUserInput(options: NumberLinePublicWidgetOptions): PerseusNumberLineUserInput;
 declare const _default: {
     name: string;
     displayName: string;
     widget: typeof NumberLine;
-    transform: typeof numberLineTransform;
+    transform: typeof transform;
     staticTransform: typeof staticTransform;
+    getCorrectUserInput: typeof getCorrectUserInput;
+    getStartUserInput: typeof getStartUserInput;
+    getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
 };
 export default _default;

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import type { FocusPath, Focusable, Widget, WidgetProps } from "../../types";
 import type { NumericInputPromptJSON } from "../../widget-ai-utils/numeric-input/prompt-utils";
 import type { PerseusNumericInputWidgetOptions, PerseusNumericInputAnswerForm, PerseusNumericInputRubric, PerseusNumericInputUserInput } from "@khanacademy/perseus-core";
-type ExternalProps = WidgetProps<PerseusNumericInputWidgetOptions>;
+type ExternalProps = WidgetProps<PerseusNumericInputWidgetOptions, PerseusNumericInputUserInput>;
 export type NumericInputProps = ExternalProps & {
     size: NonNullable<ExternalProps["size"]>;
     rightAlign: NonNullable<ExternalProps["rightAlign"]>;
@@ -11,9 +11,8 @@ export type NumericInputProps = ExternalProps & {
     answerForms: ReadonlyArray<PerseusNumericInputAnswerForm>;
     labelText: string;
     linterContext: NonNullable<ExternalProps["linterContext"]>;
-    currentValue: string;
 };
-type DefaultProps = Pick<NumericInputProps, "currentValue" | "size" | "rightAlign" | "apiOptions" | "coefficient" | "answerForms" | "labelText" | "linterContext">;
+type DefaultProps = Pick<NumericInputProps, "size" | "rightAlign" | "apiOptions" | "coefficient" | "answerForms" | "labelText" | "linterContext" | "userInput">;
 type RenderProps = {
     answerForms: ReadonlyArray<PerseusNumericInputAnswerForm>;
     labelText?: string;
@@ -33,17 +32,22 @@ type RenderProps = {
 export declare class NumericInput extends React.Component<NumericInputProps> implements Widget {
     inputRef: React.RefObject<Focusable>;
     static defaultProps: DefaultProps;
-    static getUserInputFromProps(props: NumericInputProps): PerseusNumericInputUserInput;
     focus: () => boolean;
     focusInputPath: () => void;
     blurInputPath: () => void;
     getInputPaths: () => ReadonlyArray<ReadonlyArray<string>>;
     /**
      * Sets the value of the input at the given path.
+     *
+     * TODO: remove this when everything is pulling from Renderer state
+     * @deprecated set user input in Renderer state
      */
     setInputValue: (path: FocusPath, newValue: string, cb?: () => unknown | null | undefined) => void;
     /**
      * Returns the value the user has currently input for this widget.
+     *
+     * TODO: remove this when everything is pulling from Renderer state
+     * @deprecated get user input from Renderer state
      */
     getUserInput(): PerseusNumericInputUserInput;
     /**
@@ -51,8 +55,92 @@ export declare class NumericInput extends React.Component<NumericInputProps> imp
      * This is used by the AI to determine the prompt for the widget.
      */
     getPromptJSON(): NumericInputPromptJSON;
+    /**
+     * @deprecated and likely very broken API
+     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     */
+    getSerializedState(): {
+        currentValue: string;
+        answers: import("@khanacademy/perseus-core").PerseusNumericInputAnswer[];
+        labelText: string;
+        size: string;
+        coefficient: boolean;
+        rightAlign: boolean;
+        static: boolean;
+        reviewModeRubric?: Empty | null | undefined;
+        trackInteraction: (extraData?: Empty | undefined) => void;
+        widgetId: string;
+        alignment: string | null | undefined;
+        problemNum: number | null | undefined;
+        apiOptions: Readonly<Readonly<{
+            isArticle?: boolean;
+            onFocusChange?: (newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number, focusedElement?: HTMLElement) => unknown;
+            GroupMetadataEditor?: React.ComponentType<any>;
+            showAlignmentOptions?: boolean;
+            readOnly?: boolean;
+            answerableCallback?: (arg1: boolean) => unknown;
+            getAnotherHint?: () => unknown;
+            interactionCallback?: (widgetData: {
+                [widgetId: string]: any;
+            }) => void;
+            groupAnnotator?: (groupNumber: number, widgetId: string) => React.ReactNode;
+            imagePlaceholder?: React.ReactNode;
+            widgetPlaceholder?: React.ReactNode;
+            baseElements?: {
+                Link: React.ComponentType<any>;
+            };
+            imagePreloader?: (dimensions: import("../../types").Dimensions) => React.ReactNode;
+            trackInteraction?: (args: {
+                type: string;
+                id: string;
+                correct?: boolean;
+            } & Partial<import("../../types").TrackingGradedGroupExtraArguments> & Partial<{
+                visible: number;
+            }>) => void;
+            customKeypad?: boolean;
+            nativeKeypadProxy?: (blur: () => void) => import("@khanacademy/math-input").KeypadAPI;
+            isMobile?: boolean;
+            isMobileApp?: boolean;
+            setDrawingAreaAvailable?: (arg1: boolean) => unknown;
+            hintProgressColor?: string;
+            canScrollPage?: boolean;
+            editorChangeDelay?: number;
+            flags?: Record<"new-radio-widget", boolean>;
+            onWidgetStartProps?: (widgets: import("@khanacademy/perseus-core").PerseusWidgetsMap) => void;
+        }> & {
+            baseElements: NonNullable<import("../..").APIOptions["baseElements"]>;
+            canScrollPage: NonNullable<import("../..").APIOptions["canScrollPage"]>;
+            editorChangeDelay: NonNullable<import("../..").APIOptions["editorChangeDelay"]>;
+            groupAnnotator: NonNullable<import("../..").APIOptions["groupAnnotator"]>;
+            isArticle: NonNullable<import("../..").APIOptions["isArticle"]>;
+            isMobile: NonNullable<import("../..").APIOptions["isMobile"]>;
+            isMobileApp: NonNullable<import("../..").APIOptions["isMobileApp"]>;
+            onFocusChange: NonNullable<import("../..").APIOptions["onFocusChange"]>;
+            readOnly: NonNullable<import("../..").APIOptions["readOnly"]>;
+            setDrawingAreaAvailable: NonNullable<import("../..").APIOptions["setDrawingAreaAvailable"]>;
+            showAlignmentOptions: NonNullable<import("../..").APIOptions["showAlignmentOptions"]>;
+        }>;
+        keypadElement?: any;
+        questionCompleted?: boolean;
+        onFocus: (blurPath: FocusPath) => void;
+        onBlur: (blurPath: FocusPath) => void;
+        findWidgets: (criterion: import("../../types").FilterCriterion) => ReadonlyArray<Widget>;
+        reviewMode: boolean;
+        showSolutions?: import("@khanacademy/perseus-core").ShowSolutions;
+        onChange: import("../..").ChangeHandler;
+        handleUserInput: (newUserInput: PerseusNumericInputUserInput, cb?: () => void, silent?: boolean) => void;
+        isLastUsedWidget: boolean;
+        linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
+        containerSizeClass: import("../../util/sizing-utils").SizeClass;
+        answerForms: ReadonlyArray<PerseusNumericInputAnswerForm>;
+    };
     render(): React.ReactNode;
 }
+/**
+ * @deprecated and likely a very broken API
+ * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ */
+declare function getUserInputFromSerializedState(serializedState: any): PerseusNumericInputUserInput;
 declare const _default: {
     name: string;
     displayName: string;
@@ -60,5 +148,6 @@ declare const _default: {
     transform: (widgetOptions: PerseusNumericInputWidgetOptions) => RenderProps;
     isLintable: true;
     getOneCorrectAnswerFromRubric(rubric: PerseusNumericInputRubric): string | null | undefined;
+    getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
 };
 export default _default;

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

@@ -5,7 +5,7 @@ import type { Focusable } from "../../types";
  * component. It is responsible for rendering the UI elements of the Numeric
  * Input widget.
  */
-export declare const NumericInputComponent: React.ForwardRefExoticComponent<import("@khanacademy/perseus-core").PerseusNumericInputWidgetOptions & import("../../types").UniversalWidgetProps<Empty, Empty> & {
+export declare const NumericInputComponent: React.ForwardRefExoticComponent<import("@khanacademy/perseus-core").PerseusNumericInputWidgetOptions & import("../../types").UniversalWidgetProps<Empty, import("@khanacademy/perseus-core").PerseusNumericInputUserInput, Empty> & {
     size: NonNullable<string>;
     rightAlign: NonNullable<boolean | undefined>;
     apiOptions: NonNullable<Readonly<Readonly<{
@@ -60,5 +60,4 @@ export declare const NumericInputComponent: React.ForwardRefExoticComponent<impo
     answerForms: ReadonlyArray<import("@khanacademy/perseus-core").PerseusNumericInputAnswerForm>;
     labelText: string;
     linterContext: NonNullable<import("@khanacademy/perseus-linter").LinterContextProps>;
-    currentValue: string;
 } & React.RefAttributes<Focusable>>;

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

@@ -7,13 +7,10 @@ type Position = {
     left: number;
     top: number;
 };
-type RenderProps = OrdererPublicWidgetOptions & {
-    current: any;
-};
-type OrdererProps = WidgetProps<RenderProps>;
-type OrdererDefaultProps = Pick<OrdererProps, "current" | "options" | "height" | "layout" | "linterContext">;
+type RenderProps = OrdererPublicWidgetOptions;
+type OrdererProps = WidgetProps<RenderProps, PerseusOrdererUserInput>;
+type OrdererDefaultProps = Pick<OrdererProps, "options" | "height" | "layout" | "linterContext" | "userInput">;
 type OrdererState = {
-    current: ReadonlyArray<any>;
     dragging: boolean;
     placeholderIndex: number | null | undefined;
     dragKey: string | null | undefined;
@@ -30,22 +27,32 @@ type OrdererState = {
 declare class Orderer extends React.Component<OrdererProps, OrdererState> implements Widget {
     static defaultProps: OrdererDefaultProps;
     state: OrdererState;
-    UNSAFE_componentWillReceiveProps(nextProps: OrdererProps): void;
     onClick: (arg1: string, arg2: number, arg3: any, arg4: Element) => void;
     onRelease: (arg1: any) => void;
     onMouseMove: (arg1: any) => void;
     findCorrectIndex: (arg1: any, arg2: any) => any;
     isCardInBank: (arg1: any) => boolean;
-    setListValues: (arg1: ReadonlyArray<string>) => void;
+    setListValues: (values: string[]) => void;
     getUserInput(): PerseusOrdererUserInput;
     getPromptJSON(): OrdererPromptJSON;
+    /**
+     * @deprecated and likely very broken API
+     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     */
+    getSerializedState(): any;
     render(): React.ReactNode;
 }
+/**
+ * @deprecated and likely a very broken API
+ * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ */
+declare function getUserInputFromSerializedState(serializedState: any): PerseusOrdererUserInput;
 declare const _default: {
     name: string;
     displayName: string;
     hidden: true;
     widget: typeof Orderer;
     isLintable: true;
+    getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
 };
 export default _default;

package/dist/widgets/passage-ref/passage-ref.d.ts

@@ -1,7 +1,7 @@
 import { type PerseusPassageRefWidgetOptions } from "@khanacademy/perseus-core";
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
-import type { ChangeFn, Widget, WidgetProps } from "../../types";
+import type { Widget, WidgetProps } from "../../types";
 import type { PassageRefPromptJSON } from "../../widget-ai-utils/passage-ref/passage-ref-ai-utils";
 type RenderProps = {
     passageNumber: PerseusPassageRefWidgetOptions["passageNumber"];
@@ -31,7 +31,6 @@ declare class PassageRef extends React.Component<Props, State> implements Widget
     shouldComponentUpdate(nextProps: Props, nextState: State): boolean;
     componentDidUpdate(): void;
     componentWillUnmount(): void;
-    change: ChangeFn;
     getPromptJSON(): PassageRefPromptJSON;
     _deferredUpdateRange: () => void;
     _updateRange: () => void;

package/dist/widgets/passage-ref-target/passage-ref-target.d.ts

@@ -1,10 +1,9 @@
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
-import * as Changeable from "../../mixins/changeable";
 import type { APIOptions, Widget } from "../../types";
 import type { PerseusPassageRefTargetWidgetOptions } from "@khanacademy/perseus-core";
 import type { LinterContextProps } from "@khanacademy/perseus-linter";
-type Props = Changeable.ChangeableProps & {
+type Props = {
     apiOptions: APIOptions;
     content: PerseusPassageRefTargetWidgetOptions["content"];
     linterContext: LinterContextProps;
@@ -18,7 +17,6 @@ declare class PassageRefTarget extends React.Component<Props> implements Widget
     context: React.ContextType<typeof PerseusI18nContext>;
     static defaultProps: DefaultProps;
     isWidget: true;
-    change: (arg1: any, arg2: any, arg3: any) => any;
     render(): React.ReactNode;
 }
 declare const _default: {

package/dist/widgets/phet-simulation/phet-simulation.d.ts

@@ -7,8 +7,7 @@ import { PerseusI18nContext } from "../../components/i18n-context";
 import type { WidgetProps, Widget } from "../../types";
 import type { UnsupportedWidgetPromptJSON } from "../../widget-ai-utils/unsupported-widget";
 import type { PerseusPhetSimulationWidgetOptions } from "@khanacademy/perseus-core";
-type RenderProps = PerseusPhetSimulationWidgetOptions;
-type Props = WidgetProps<RenderProps>;
+type Props = WidgetProps<PerseusPhetSimulationWidgetOptions>;
 type State = {
     banner: {
         message: string;

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

@@ -4,8 +4,7 @@ import type { Widget, WidgetProps } from "../../types";
 import type { UnsupportedWidgetPromptJSON } from "../../widget-ai-utils/unsupported-widget";
 import type { PerseusPlotterWidgetOptions, PerseusPlotterUserInput } from "@khanacademy/perseus-core";
 import type { PlotterPublicWidgetOptions } from "@khanacademy/perseus-core/src/widgets/plotter/plotter-util";
-type RenderProps = PlotterPublicWidgetOptions;
-type Props = WidgetProps<RenderProps> & {
+type Props = WidgetProps<PlotterPublicWidgetOptions, PerseusPlotterUserInput> & {
     labelInterval: NonNullable<PerseusPlotterWidgetOptions["labelInterval"]>;
     picSize: NonNullable<PerseusPlotterWidgetOptions["picSize"]>;
 };
@@ -23,7 +22,6 @@ type DefaultProps = {
     labelInterval: Props["labelInterval"];
 };
 type State = {
-    values: number[];
     categoryHeights: Record<string, number>;
 };
 export declare class Plotter extends React.Component<Props, State> implements Widget {
@@ -44,7 +42,7 @@ export declare class Plotter extends React.Component<Props, State> implements Wi
     DOT_PLOT_POINT_SIZE: () => number;
     DOT_PLOT_POINT_PADDING: () => number;
     DOT_TICK_POINT_SIZE: () => number;
-    setupGraphie: (arg1: any) => void;
+    setupGraphie(prevValues: number[]): void;
     showHairlines: (arg1: any) => void;
     hideHairlines: () => void;
     labelCategory: (arg1: any, arg2: any) => Promise<any>;
@@ -64,17 +62,118 @@ export declare class Plotter extends React.Component<Props, State> implements Wi
     setupPic: (arg1: any, arg2: any) => any;
     setupTiledPlot: (arg1: any, arg2: any, arg3: any, arg4: any) => any;
     setPicHeight: (arg1: number, arg2: number) => void;
-    changeAndTrack: (arg1: any) => void;
-    drawPicHeights: (arg1: any, arg2: any) => void;
+    changeAndTrack: (userInput: PerseusPlotterUserInput) => void;
+    /**
+     * Plotter uses Graphie and Graphie is inaccessible,
+     * this helps us populate user input in tests
+     * (not great, but not a lot of options)
+     *
+     * @internal
+     */
+    _testInsertUserInput(userInput: PerseusPlotterUserInput): void;
+    drawPicHeights(values: number[], prevValues: number[]): void;
     getUserInput(): PerseusPlotterUserInput;
     getPromptJSON(): UnsupportedWidgetPromptJSON;
+    /**
+     * @deprecated and likely very broken API
+     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     */
+    getSerializedState(): {
+        values: PerseusPlotterUserInput;
+        type: import("@khanacademy/perseus-core").PlotType;
+        labels: string[];
+        categories: string[];
+        maxY: number;
+        scaleY: number;
+        labelInterval: number;
+        snapsPerLine: number;
+        starting: number[];
+        picUrl?: string | null;
+        picSize: number;
+        picBoxHeight?: number | null;
+        plotDimensions: number[];
+        reviewModeRubric?: Empty | null | undefined;
+        trackInteraction: (extraData?: Empty | undefined) => void;
+        widgetId: string;
+        alignment: string | null | undefined;
+        static: boolean | null | undefined;
+        problemNum: number | null | undefined;
+        apiOptions: Readonly<Readonly<{
+            isArticle?: boolean;
+            onFocusChange?: (newFocusPath: import("../..").FocusPath, oldFocusPath: import("../..").FocusPath, keypadHeight?: number, focusedElement?: HTMLElement) => unknown;
+            GroupMetadataEditor?: React.ComponentType<any>;
+            showAlignmentOptions?: boolean;
+            readOnly?: boolean;
+            answerableCallback?: (arg1: boolean) => unknown;
+            getAnotherHint?: () => unknown;
+            interactionCallback?: (widgetData: {
+                [widgetId: string]: any;
+            }) => void;
+            groupAnnotator?: (groupNumber: number, widgetId: string) => React.ReactNode;
+            imagePlaceholder?: React.ReactNode;
+            widgetPlaceholder?: React.ReactNode;
+            baseElements?: {
+                Link: React.ComponentType<any>;
+            };
+            imagePreloader?: (dimensions: import("../../types").Dimensions) => React.ReactNode;
+            trackInteraction?: (args: {
+                type: string;
+                id: string;
+                correct?: boolean;
+            } & Partial<import("../../types").TrackingGradedGroupExtraArguments> & Partial<{
+                visible: number;
+            }>) => void;
+            customKeypad?: boolean;
+            nativeKeypadProxy?: (blur: () => void) => import("@khanacademy/math-input").KeypadAPI;
+            isMobile?: boolean;
+            isMobileApp?: boolean;
+            setDrawingAreaAvailable?: (arg1: boolean) => unknown;
+            hintProgressColor?: string;
+            canScrollPage?: boolean;
+            editorChangeDelay?: number;
+            flags?: Record<"new-radio-widget", boolean>;
+            onWidgetStartProps?: (widgets: import("@khanacademy/perseus-core").PerseusWidgetsMap) => void;
+        }> & {
+            baseElements: NonNullable<import("../..").APIOptions["baseElements"]>;
+            canScrollPage: NonNullable<import("../..").APIOptions["canScrollPage"]>;
+            editorChangeDelay: NonNullable<import("../..").APIOptions["editorChangeDelay"]>;
+            groupAnnotator: NonNullable<import("../..").APIOptions["groupAnnotator"]>;
+            isArticle: NonNullable<import("../..").APIOptions["isArticle"]>;
+            isMobile: NonNullable<import("../..").APIOptions["isMobile"]>;
+            isMobileApp: NonNullable<import("../..").APIOptions["isMobileApp"]>;
+            onFocusChange: NonNullable<import("../..").APIOptions["onFocusChange"]>;
+            readOnly: NonNullable<import("../..").APIOptions["readOnly"]>;
+            setDrawingAreaAvailable: NonNullable<import("../..").APIOptions["setDrawingAreaAvailable"]>;
+            showAlignmentOptions: NonNullable<import("../..").APIOptions["showAlignmentOptions"]>;
+        }>;
+        keypadElement?: any;
+        questionCompleted?: boolean;
+        onFocus: (blurPath: import("../..").FocusPath) => void;
+        onBlur: (blurPath: import("../..").FocusPath) => void;
+        findWidgets: (criterion: import("../../types").FilterCriterion) => ReadonlyArray<Widget>;
+        reviewMode: boolean;
+        showSolutions?: import("@khanacademy/perseus-core").ShowSolutions;
+        onChange: import("../..").ChangeHandler;
+        handleUserInput: (newUserInput: PerseusPlotterUserInput, cb?: () => void, silent?: boolean) => void;
+        isLastUsedWidget: boolean;
+        linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
+        containerSizeClass: import("../../util/sizing-utils").SizeClass;
+    };
     render(): React.ReactNode;
 }
+declare function getStartUserInput(options: PlotterPublicWidgetOptions): PerseusPlotterUserInput;
+/**
+ * @deprecated and likely a very broken API
+ * [LEMS-3185] do not trust serializedState/restoreSerializedState
+ */
+declare function getUserInputFromSerializedState(serializedState: any): PerseusPlotterUserInput;
 declare const _default: {
     name: string;
     displayName: string;
     hidden: true;
     widget: typeof Plotter;
     staticTransform: <T>(value: T) => T;
+    getStartUserInput: typeof getStartUserInput;
+    getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
 };
 export default _default;

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

@@ -16,7 +16,7 @@ export type RenderProps = {
     choiceStates?: ChoiceState[];
     values?: boolean[];
 };
-type Props = WidgetProps<RenderProps, PerseusRadioRubric>;
+type Props = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>;
 type DefaultProps = Required<Pick<Props, "choices" | "multipleSelect" | "countChoices" | "deselectEnabled" | "linterContext" | "showSolutions">>;
 export type RadioChoiceWithMetadata = PerseusRadioChoice & {
     originalIndex: number;

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

@@ -13,7 +13,7 @@ export type RenderProps = {
     choiceStates?: ReadonlyArray<ChoiceState>;
     values?: ReadonlyArray<boolean>;
 };
-type Props = WidgetProps<RenderProps, PerseusRadioRubric>;
+type Props = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>;
 type DefaultProps = Required<Pick<Props, "choices" | "multipleSelect" | "countChoices" | "deselectEnabled" | "linterContext" | "showSolutions">>;
 export interface RadioChoiceWithMetadata extends PerseusRadioChoice {
     originalIndex: number;

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

@@ -10,5 +10,9 @@ declare const _default: {
     staticTransform: (widgetOptions: PerseusRadioWidgetOptions, strings: PerseusStrings, problemNum?: number | null) => RenderProps;
     version: import("@khanacademy/perseus-core").Version | undefined;
     isLintable: true;
+    /**
+     * @deprecated - do not use in new code.
+     */
+    getUserInputFromSerializedState: typeof import("./radio-component").default.getUserInputFromProps;
 };
 export default _default;

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

@@ -2,8 +2,8 @@ import * as React from "react";
 import RadioOld from "./radio-component";
 import type { RenderProps } from "./radio-component";
 import type { WidgetProps } from "../../types";
-import type { PerseusRadioRubric } from "@khanacademy/perseus-core";
-type Props = WidgetProps<RenderProps, PerseusRadioRubric>;
+import type { PerseusRadioRubric, PerseusRadioUserInput } from "@khanacademy/perseus-core";
+type Props = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>;
 /**
  * This is a wrapper around the old radio widget that allows us to
  * conditionally render the new radio widget when the feature flag is on.

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

@@ -1,6 +1,6 @@
 import * as React from "react";
 import type { WidgetProps, ChoiceState } from "../../types";
-import type { PerseusRadioChoice, ShowSolutions, PerseusRadioRubric } from "@khanacademy/perseus-core";
+import type { PerseusRadioChoice, ShowSolutions, PerseusRadioRubric, PerseusRadioUserInput } from "@khanacademy/perseus-core";
 export interface RadioChoiceWithMetadata extends PerseusRadioChoice {
     originalIndex: number;
     correct?: boolean;
@@ -17,7 +17,7 @@ export interface RenderProps {
     choiceStates?: ReadonlyArray<ChoiceState>;
     values?: ReadonlyArray<boolean>;
 }
-type RadioComponentProps = WidgetProps<RenderProps, PerseusRadioRubric>;
+type RadioComponentProps = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>;
 /**
  * This component is a duplicate of the Radio component in radio.tsx
  * for the Radio Revitalization Project. (LEMS-2933)