@khanacademy/perseus 66.3.0 → 66.5.0

package/dist/widget-ai-utils/matrix/matrix-ai-utils.d.ts

@@ -7,7 +7,7 @@ export type MatrixPromptJSON = {
         width: number;
     };
     userInput: {
-        answerRows: ReadonlyArray<ReadonlyArray<number>>;
+        answerRows: ReadonlyArray<ReadonlyArray<string>>;
     };
 };
 export declare const getPromptJSON: (renderProps: React.ComponentProps<typeof matrix.widget>) => MatrixPromptJSON;

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { Widget, WidgetProps } from "../../types";
 import type { CategorizerPromptJSON } from "../../widget-ai-utils/categorizer/categorizer-ai-utils";
-import type { PerseusCategorizerWidgetOptions, PerseusCategorizerUserInput, CategorizerPublicWidgetOptions } from "@khanacademy/perseus-core";
+import type { PerseusCategorizerWidgetOptions, PerseusCategorizerUserInput } from "@khanacademy/perseus-core";
 type Props = WidgetProps<RenderProps, PerseusCategorizerUserInput>;
 type DefaultProps = {
     items: Props["items"];
@@ -39,19 +39,15 @@ type RenderProps = {
 declare function getUserInputFromSerializedState(serializedState: any): PerseusCategorizerUserInput;
 /**
  * you need this along with _getAllWidgetsStartProps
- * to generate userInput for static widgets since staticTransform
- * used to populate correct input and now can't
+ * to generate userInput for static widgets
  */
 declare function getCorrectUserInput(options: PerseusCategorizerWidgetOptions): PerseusCategorizerUserInput;
 declare function getStartUserInput(): PerseusCategorizerUserInput;
-declare function transform(widgetOptions: CategorizerPublicWidgetOptions): RenderProps;
 declare const _default: {
     name: string;
     displayName: string;
     hidden: true;
     widget: typeof Categorizer;
-    transform: typeof transform;
-    staticTransform: typeof transform;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
     getCorrectUserInput: typeof getCorrectUserInput;
     getStartUserInput: typeof getStartUserInput;

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

@@ -2,14 +2,8 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { Widget, WidgetProps } from "../../types";
 import type { DropdownPromptJSON } from "../../widget-ai-utils/dropdown/dropdown-ai-utils";
-import type { DropdownPublicWidgetOptions, PerseusDropdownWidgetOptions, PerseusDropdownUserInput } from "@khanacademy/perseus-core";
-type RenderProps = {
-    placeholder: PerseusDropdownWidgetOptions["placeholder"];
-    visibleLabel: PerseusDropdownWidgetOptions["visibleLabel"];
-    ariaLabel: PerseusDropdownWidgetOptions["ariaLabel"];
-    choices: ReadonlyArray<string>;
-};
-type Props = WidgetProps<RenderProps, PerseusDropdownUserInput>;
+import type { PerseusDropdownWidgetOptions, PerseusDropdownUserInput } from "@khanacademy/perseus-core";
+type Props = WidgetProps<PerseusDropdownWidgetOptions, PerseusDropdownUserInput>;
 type DefaultProps = {
     choices: Props["choices"];
     placeholder: Props["placeholder"];
@@ -29,9 +23,16 @@ declare class Dropdown extends React.Component<Props> implements Widget {
      * [LEMS-3185] do not trust serializedState/restoreSerializedState
      */
     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;
 }
-declare function transform(widgetOptions: DropdownPublicWidgetOptions): RenderProps;
 /**
  * @deprecated and likely a very broken API
  * [LEMS-3185] do not trust serializedState/restoreSerializedState
@@ -42,7 +43,6 @@ declare const _default: {
     name: string;
     displayName: string;
     widget: typeof Dropdown;
-    transform: typeof transform;
     getStartUserInput: typeof getStartUserInput;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
 };

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

@@ -3,18 +3,9 @@ import { PerseusI18nContext } from "../../components/i18n-context";
 import type { DependenciesContext } from "../../dependencies";
 import type { WidgetProps, Widget } from "../../types";
 import type { ExpressionPromptJSON } from "../../widget-ai-utils/expression/expression-ai-utils";
-import type { PerseusExpressionWidgetOptions, ExpressionPublicWidgetOptions, KeypadConfiguration, KeypadKey, PerseusExpressionRubric, PerseusExpressionUserInput } from "@khanacademy/perseus-core";
+import type { PerseusExpressionWidgetOptions, KeypadConfiguration, KeypadKey, PerseusExpressionRubric, PerseusExpressionUserInput } from "@khanacademy/perseus-core";
 type InputPath = ReadonlyArray<string>;
-type RenderProps = {
-    buttonSets: PerseusExpressionWidgetOptions["buttonSets"];
-    buttonsVisible?: PerseusExpressionWidgetOptions["buttonsVisible"];
-    functions: PerseusExpressionWidgetOptions["functions"];
-    times: PerseusExpressionWidgetOptions["times"];
-    visibleLabel: PerseusExpressionWidgetOptions["visibleLabel"];
-    ariaLabel: PerseusExpressionWidgetOptions["ariaLabel"];
-    keypadConfiguration: KeypadConfiguration;
-};
-type ExternalProps = WidgetProps<RenderProps, PerseusExpressionUserInput>;
+type ExternalProps = WidgetProps<PerseusExpressionWidgetOptions, PerseusExpressionUserInput>;
 type Props = ExternalProps & Partial<React.ContextType<typeof DependenciesContext>> & {
     apiOptions: NonNullable<ExternalProps["apiOptions"]>;
     buttonSets: NonNullable<ExternalProps["buttonSets"]>;
@@ -55,19 +46,21 @@ export declare class Expression extends React.Component<Props> implements Widget
     blurInputPath(inputPath: InputPath): void;
     insert(keyPressed: KeypadKey): void;
     getInputPaths: () => ReadonlyArray<ReadonlyArray<any>>;
+    getKeypadConfiguration(): KeypadConfiguration;
     /**
      * @deprecated and likely very broken API
      * [LEMS-3185] do not trust serializedState/restoreSerializedState
      */
     getSerializedState(): {
         value: string;
-        buttonSets: PerseusExpressionWidgetOptions["buttonSets"];
-        buttonsVisible?: PerseusExpressionWidgetOptions["buttonsVisible"];
-        functions: PerseusExpressionWidgetOptions["functions"];
-        times: PerseusExpressionWidgetOptions["times"];
-        visibleLabel: PerseusExpressionWidgetOptions["visibleLabel"];
-        ariaLabel: PerseusExpressionWidgetOptions["ariaLabel"];
         keypadConfiguration: KeypadConfiguration;
+        buttonSets: import("@khanacademy/perseus-core").LegacyButtonSets;
+        functions: string[];
+        times: boolean;
+        extraKeys?: KeypadKey[];
+        visibleLabel: string;
+        ariaLabel: string;
+        buttonsVisible?: "always" | "never" | "focused";
         reviewModeRubric?: Empty | null | undefined;
         trackInteraction: (extraData?: Empty | undefined) => void;
         widgetId: string;
@@ -149,10 +142,11 @@ export declare class Expression extends React.Component<Props> implements Widget
  */
 declare function getUserInputFromSerializedState(serializedState: any): PerseusExpressionUserInput;
 declare function getStartUserInput(): PerseusExpressionUserInput;
+declare function getOneCorrectAnswerFromRubric(rubric: PerseusExpressionRubric): string | null | undefined;
 declare const _default: {
     name: string;
     displayName: string;
-    widget: React.ForwardRefExoticComponent<Omit<Pick<RenderProps & import("../../types").UniversalWidgetProps<Empty, string, Empty> & Partial<import("../..").PerseusDependenciesV2> & {
+    widget: React.ForwardRefExoticComponent<Omit<Pick<PerseusExpressionWidgetOptions & import("../../types").UniversalWidgetProps<Empty, string, Empty> & Partial<import("../..").PerseusDependenciesV2> & {
         apiOptions: NonNullable<ExternalProps["apiOptions"]>;
         buttonSets: NonNullable<ExternalProps["buttonSets"]>;
         functions: NonNullable<ExternalProps["functions"]>;
@@ -162,7 +156,7 @@ declare const _default: {
         times: NonNullable<ExternalProps["times"]>;
         visibleLabel: PerseusExpressionWidgetOptions["visibleLabel"];
         ariaLabel: PerseusExpressionWidgetOptions["ariaLabel"];
-    }, "static" | "onChange" | "ariaLabel" | "buttonsVisible" | "trackInteraction" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "keypadElement" | "isLastUsedWidget" | "handleUserInput" | "showSolutions" | "reviewMode" | "reviewModeRubric" | keyof import("../..").PerseusDependenciesV2 | "alignment" | "visibleLabel" | "keypadConfiguration"> & {
+    }, "static" | "onChange" | "ariaLabel" | "extraKeys" | "buttonsVisible" | "trackInteraction" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "keypadElement" | "isLastUsedWidget" | "handleUserInput" | "showSolutions" | "reviewMode" | "reviewModeRubric" | 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;
@@ -219,10 +213,9 @@ declare const _default: {
         functions?: string[] | undefined;
         times?: boolean | undefined;
     } & {}, keyof import("../..").PerseusDependenciesV2> & React.RefAttributes<Expression>>;
-    transform: (widgetOptions: PerseusExpressionWidgetOptions | ExpressionPublicWidgetOptions) => RenderProps;
     version: import("@khanacademy/perseus-core").Version | undefined;
     isLintable: true;
-    getOneCorrectAnswerFromRubric(rubric: PerseusExpressionRubric): string | null | undefined;
+    getOneCorrectAnswerFromRubric: typeof getOneCorrectAnswerFromRubric;
     getStartUserInput: typeof getStartUserInput;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
 };

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

@@ -11,8 +11,7 @@ declare const GRADING_STATUSES: {
     readonly incorrect: "incorrect";
     readonly invalid: "invalid";
 };
-type RenderProps = PerseusGradedGroupWidgetOptions;
-type Props = WidgetProps<RenderProps, Empty, TrackingGradedGroupExtraArguments> & {
+type Props = WidgetProps<PerseusGradedGroupWidgetOptions, Empty, TrackingGradedGroupExtraArguments> & {
     inGradedGroupSet?: boolean;
     onNextQuestion?: () => unknown;
 };

package/dist/widgets/graded-group-set/graded-group-set.d.ts

@@ -3,8 +3,7 @@ import { GradedGroup } from "../graded-group/graded-group";
 import type { FocusPath, Widget, WidgetProps } from "../../types";
 import type { GradedGroupSetPromptJSON } from "../../widget-ai-utils/graded-group-set/graded-group-set-ai-utils";
 import type { PerseusGradedGroupSetWidgetOptions } from "@khanacademy/perseus-core";
-type RenderProps = PerseusGradedGroupSetWidgetOptions;
-type Props = WidgetProps<RenderProps> & {
+type Props = WidgetProps<PerseusGradedGroupSetWidgetOptions> & {
     trackInteraction: () => void;
 };
 type DefaultProps = {

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

@@ -6,8 +6,7 @@ import type { GridDimensions } from "../../util";
 import type { GrapherPromptJSON } from "../../widget-ai-utils/grapher/grapher-ai-utils";
 import type { PerseusGrapherWidgetOptions, PerseusGrapherUserInput, GrapherPublicWidgetOptions } from "@khanacademy/perseus-core";
 import type { PropsFor } from "@khanacademy/wonder-blocks-core";
-type RenderProps = Pick<GrapherPublicWidgetOptions, "availableTypes" | "graph">;
-type Props = WidgetProps<RenderProps, PerseusGrapherUserInput>;
+type Props = WidgetProps<PerseusGrapherWidgetOptions, PerseusGrapherUserInput>;
 declare class Grapher extends React.Component<Props> implements Widget {
     horizHairline: any;
     vertHairline: any;
@@ -28,6 +27,7 @@ declare class Grapher extends React.Component<Props> implements Widget {
      */
     getSerializedState(): {
         plot: import("@khanacademy/perseus-core").GrapherAnswerTypes;
+        availableTypes: Array<"absolute_value" | "exponential" | "linear" | "logarithm" | "quadratic" | "sinusoid" | "tangent">;
         graph: {
             backgroundImage: {
                 bottom?: number;
@@ -52,7 +52,6 @@ declare class Grapher extends React.Component<Props> implements Widget {
             step: [number, number];
             valid?: boolean | string;
         };
-        availableTypes: Array<"absolute_value" | "exponential" | "linear" | "logarithm" | "quadratic" | "sinusoid" | "tangent">;
         reviewModeRubric?: Empty | null | undefined;
         trackInteraction: (extraData?: Empty | undefined) => void;
         widgetId: string;
@@ -122,35 +121,6 @@ declare class Grapher extends React.Component<Props> implements Widget {
     };
     render(): React.ReactNode;
 }
-declare function transform(options: GrapherPublicWidgetOptions): RenderProps;
-declare function staticTransform(options: PerseusGrapherWidgetOptions): {
-    availableTypes: ("linear" | "quadratic" | "sinusoid" | "tangent" | "exponential" | "logarithm" | "absolute_value")[];
-    plot: import("@khanacademy/perseus-core").GrapherAnswerTypes;
-    graph: {
-        backgroundImage: {
-            bottom?: number;
-            height?: number;
-            left?: number;
-            scale?: number;
-            url?: string | null | undefined;
-            width?: number;
-        };
-        box?: [number, number];
-        editableSettings?: Array<"graph" | "snap" | "image" | "measure">;
-        gridStep?: [number, number];
-        labels: [string, string];
-        markings: import("@khanacademy/perseus-core").MarkingsType;
-        range: import("@khanacademy/perseus-core").GraphRange;
-        rulerLabel: "";
-        rulerTicks: number;
-        showProtractor?: boolean;
-        showRuler?: boolean;
-        showTooltips?: boolean;
-        snapStep?: [number, number];
-        step: [number, number];
-        valid?: boolean | string;
-    };
-};
 /**
  * @deprecated and likely a very broken API
  * [LEMS-3185] do not trust serializedState/restoreSerializedState
@@ -163,8 +133,6 @@ declare const _default: {
     displayName: string;
     hidden: true;
     widget: typeof Grapher;
-    transform: typeof transform;
-    staticTransform: typeof staticTransform;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
     getStartUserInput: typeof getStartUserInput;
     getCorrectUserInput: typeof getCorrectUserInput;

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

@@ -12,8 +12,7 @@ import Renderer from "../../renderer";
 import type { ChangeFn, FocusPath, Widget, WidgetProps } from "../../types";
 import type { GroupPromptJSON } from "../../widget-ai-utils/group/group-ai-utils";
 import type { PerseusGroupUserInput, PerseusGroupWidgetOptions, PerseusRenderer } from "@khanacademy/perseus-core";
-type RenderProps = PerseusGroupWidgetOptions;
-type Props = WidgetProps<RenderProps, PerseusGroupUserInput>;
+type Props = WidgetProps<PerseusGroupWidgetOptions, PerseusGroupUserInput>;
 type DefaultProps = {
     content: Props["content"];
     widgets: Props["widgets"];

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

@@ -3,8 +3,7 @@ import { PerseusI18nContext } from "../../components/i18n-context";
 import type { WidgetProps, Widget } from "../../types";
 import type { ImagePromptJSON } from "../../widget-ai-utils/image/image-ai-utils";
 import type { PerseusImageWidgetOptions } from "@khanacademy/perseus-core";
-type RenderProps = PerseusImageWidgetOptions;
-type ExternalProps = WidgetProps<RenderProps>;
+type ExternalProps = WidgetProps<PerseusImageWidgetOptions>;
 type Props = ExternalProps & {
     alignment: NonNullable<ExternalProps["alignment"]>;
     title: NonNullable<ExternalProps["title"]>;

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

@@ -3,8 +3,7 @@ import { PerseusI18nContext } from "../../components/i18n-context";
 import type { Path, Widget, WidgetProps } from "../../types";
 import type { InputNumberPromptJSON } from "../../widget-ai-utils/input-number/input-number-ai-utils";
 import type { PerseusInputNumberWidgetOptions, PerseusInputNumberUserInput } from "@khanacademy/perseus-core";
-type RenderProps = Pick<PerseusInputNumberWidgetOptions, "simplify" | "size" | "answerType" | "rightAlign">;
-type ExternalProps = WidgetProps<RenderProps, PerseusInputNumberUserInput>;
+type ExternalProps = WidgetProps<PerseusInputNumberWidgetOptions, PerseusInputNumberUserInput>;
 type Props = ExternalProps & {
     apiOptions: NonNullable<ExternalProps["apiOptions"]>;
     linterContext: NonNullable<ExternalProps["linterContext"]>;
@@ -34,7 +33,6 @@ declare class InputNumber extends React.Component<Props> implements Widget {
     getSerializedState(): any;
     render(): React.ReactNode;
 }
-declare function transform(widgetOptions: PerseusInputNumberWidgetOptions): RenderProps;
 declare function getOneCorrectAnswerFromRubric(rubric: any): string | undefined;
 /**
  * @deprecated and likely a very broken API
@@ -48,7 +46,6 @@ declare const _default: {
     hidden: true;
     widget: typeof InputNumber;
     isLintable: true;
-    transform: typeof transform;
     getOneCorrectAnswerFromRubric: typeof getOneCorrectAnswerFromRubric;
     getStartUserInput: typeof getStartUserInput;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;

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

@@ -28,6 +28,7 @@ declare class InteractiveGraphQuestionBuilder {
     private markings;
     private xRange;
     private yRange;
+    private showAxisArrows;
     private snapStep;
     private tickStep;
     private showProtractor;
@@ -55,6 +56,12 @@ declare class InteractiveGraphQuestionBuilder {
     withMarkings(markings: MarkingsType): InteractiveGraphQuestionBuilder;
     withXRange(min: number, max: number): InteractiveGraphQuestionBuilder;
     withYRange(min: number, max: number): InteractiveGraphQuestionBuilder;
+    withShowAxisArrows({ xMin, xMax, yMin, yMax, }: {
+        xMin?: boolean;
+        xMax?: boolean;
+        yMin?: boolean;
+        yMax?: boolean;
+    }): InteractiveGraphQuestionBuilder;
     withSnapStep(x: number, y: number): InteractiveGraphQuestionBuilder;
     withTickStep(x: number, y: number): InteractiveGraphQuestionBuilder;
     withProtractor(): InteractiveGraphQuestionBuilder;

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

@@ -6,7 +6,7 @@ import type { WidgetProps } from "../../types";
 import type { InteractiveGraphPromptJSON } from "../../widget-ai-utils/interactive-graph/interactive-graph-ai-utils";
 import type { UnsupportedWidgetPromptJSON } from "../../widget-ai-utils/unsupported-widget";
 import type { QuadraticCoefficient, SineCoefficient, Range } from "@khanacademy/kmath";
-import type { PerseusGraphType, PerseusGraphTypeAngle, PerseusGraphTypePoint, PerseusGraphTypeSegment, PerseusInteractiveGraphWidgetOptions, GraphRange, InteractiveGraphPublicWidgetOptions, LockedFigure, PerseusImageBackground, MarkingsType, PerseusInteractiveGraphUserInput, AxisLabelLocation } from "@khanacademy/perseus-core";
+import type { PerseusGraphType, PerseusGraphTypeAngle, PerseusGraphTypePoint, PerseusGraphTypeSegment, PerseusInteractiveGraphWidgetOptions, GraphRange, InteractiveGraphPublicWidgetOptions, LockedFigure, PerseusImageBackground, MarkingsType, PerseusInteractiveGraphUserInput, AxisLabelLocation, ShowAxisArrows } from "@khanacademy/perseus-core";
 type RenderProps = {
     /**
      * Where the little black axis lines & labels (ticks) should render.
@@ -84,6 +84,10 @@ type RenderProps = {
      * NOTE(kevinb): perseus_data.go defines this as Array<Array<number>>
      */
     range: GraphRange;
+    /**
+     * Whether to show the arrows on the axis.
+     */
+    showAxisArrows: ShowAxisArrows;
     /**
      * The type of graph
      */
@@ -112,6 +116,7 @@ type DefaultProps = {
     labels: string[];
     labelLocation: Props["labelLocation"];
     range: Props["range"];
+    showAxisArrows: Props["showAxisArrows"];
     step: Props["step"];
     backgroundImage: Props["backgroundImage"];
     markings: Props["markings"];
@@ -143,6 +148,7 @@ declare class InteractiveGraph extends React.Component<Props, State> {
         rulerLabel?: string;
         rulerTicks?: number;
         range: GraphRange;
+        showAxisArrows: ShowAxisArrows;
         correct?: PerseusGraphType;
         lockedFigures: LockedFigure[];
         fullGraphAriaLabel?: string;
@@ -275,7 +281,6 @@ declare const _default: {
     name: string;
     displayName: string;
     widget: typeof InteractiveGraph;
-    staticTransform: <T>(value: T) => T;
     getStartUserInput: typeof getStartUserInput;
     getCorrectUserInput: typeof getCorrectUserInput;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;

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

@@ -15,6 +15,7 @@ export type MafsGraphProps = {
     showProtractor: boolean;
     labels: ReadonlyArray<string>;
     labelLocation?: InteractiveGraphProps["labelLocation"];
+    showAxisArrows: InteractiveGraphProps["showAxisArrows"];
     fullGraphAriaLabel?: InteractiveGraphProps["fullGraphAriaLabel"];
     fullGraphAriaDescription?: InteractiveGraphProps["fullGraphAriaDescription"];
     state: InteractiveGraphState;

package/dist/widgets/interactive-graphs/reducer/use-graph-config.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import type { AxisLabelLocation, MarkingsType } from "@khanacademy/perseus-core";
+import type { AxisLabelLocation, ShowAxisArrows, MarkingsType } from "@khanacademy/perseus-core";
 import type { Interval, vec } from "mafs";
 export type GraphConfig = {
     range: [Interval, Interval];
@@ -15,6 +15,7 @@ export type GraphConfig = {
     labelLocation?: AxisLabelLocation;
     disableKeyboardInteraction?: boolean;
     interactiveColor?: string;
+    showAxisArrows: ShowAxisArrows;
 };
 export declare const GraphConfigContext: React.Context<GraphConfig>;
 export default function useGraphConfig(): GraphConfig;

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

@@ -25,6 +25,7 @@ export type StatefulMafsGraphProps = {
     fullGraphAriaDescription?: InteractiveGraphProps["fullGraphAriaDescription"];
     readOnly: boolean;
     static: InteractiveGraphProps["static"];
+    showAxisArrows: InteractiveGraphProps["showAxisArrows"];
 };
 export type StatefulMafsGraphType = {
     getUserInput: () => PerseusInteractiveGraphUserInput;

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

@@ -3,8 +3,7 @@ import { PerseusI18nContext } from "../../components/i18n-context";
 import type { FocusPath, Widget, WidgetProps } from "../../types";
 import type { MatrixPromptJSON } from "../../widget-ai-utils/matrix/matrix-ai-utils";
 import type { MatrixPublicWidgetOptions, PerseusMatrixUserInput, PerseusMatrixWidgetOptions } from "@khanacademy/perseus-core";
-type RenderProps = Pick<PerseusMatrixWidgetOptions, "matrixBoardSize" | "prefix" | "suffix">;
-type Props = WidgetProps<RenderProps, PerseusMatrixUserInput> & {
+type Props = WidgetProps<MatrixPublicWidgetOptions, PerseusMatrixUserInput> & {
     cursorPosition: ReadonlyArray<number>;
     onChange: (nextProps: {
         cursorPosition?: ReadonlyArray<number>;
@@ -46,13 +45,6 @@ declare class Matrix extends React.Component<Props, State> implements Widget {
     getSerializedState(): any;
     render(): React.ReactNode;
 }
-/**
- * TODO: I don't really think we need this. The default for a transform
- * is an identity function and all this is doing is taking a selection from
- * widget options; it's probably fine to pass all widget options down.
- * @deprecated [LEMS-3199]
- */
-declare function transform(widgetOptions: MatrixPublicWidgetOptions): RenderProps;
 declare function getStartUserInput(): PerseusMatrixUserInput;
 declare function getCorrectUserInput(options: PerseusMatrixWidgetOptions): PerseusMatrixUserInput;
 /**
@@ -65,8 +57,6 @@ declare const _default: {
     displayName: string;
     hidden: true;
     widget: typeof Matrix;
-    transform: typeof transform;
-    staticTransform: typeof transform;
     isLintable: true;
     getStartUserInput: typeof getStartUserInput;
     getCorrectUserInput: typeof getCorrectUserInput;

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

@@ -13,14 +13,6 @@ export type NumericInputProps = ExternalProps & {
     linterContext: NonNullable<ExternalProps["linterContext"]>;
 };
 type DefaultProps = Pick<NumericInputProps, "size" | "rightAlign" | "apiOptions" | "coefficient" | "answerForms" | "labelText" | "linterContext" | "userInput">;
-type RenderProps = {
-    answerForms: ReadonlyArray<PerseusNumericInputAnswerForm>;
-    labelText?: string;
-    size: string;
-    coefficient: boolean;
-    rightAlign?: boolean;
-    static: boolean;
-};
 /**
  * The NumericInput widget is a numeric input field that supports a variety of
  * answer forms, including integers, decimals, fractions, and mixed numbers.
@@ -47,7 +39,6 @@ export declare class NumericInput extends React.Component<NumericInputProps> imp
      */
     getSerializedState(): {
         currentValue: string;
-        answers: import("@khanacademy/perseus-core").PerseusNumericInputAnswer[];
         labelText: string;
         size: string;
         coefficient: boolean;
@@ -132,7 +123,6 @@ declare const _default: {
     name: string;
     displayName: string;
     widget: typeof NumericInput;
-    transform: (widgetOptions: PerseusNumericInputWidgetOptions) => RenderProps;
     isLintable: true;
     getOneCorrectAnswerFromRubric(rubric: PerseusNumericInputRubric): string | null | undefined;
     getStartUserInput: typeof getStartUserInput;

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

@@ -1,5 +1,5 @@
 import type { PerseusStrings } from "../../strings";
-import type { PerseusNumericInputAnswerForm } from "@khanacademy/perseus-core";
+import type { PerseusNumericInputAnswerForm, PerseusNumericInputWidgetOptions } from "@khanacademy/perseus-core";
 /**
  * The full list of available strings for the numeric input widget,
  * based on whether the Content Creator has specified that the answer must be simplified.
@@ -23,3 +23,8 @@ export declare const shouldShowExamples: (answerForms: readonly PerseusNumericIn
  * `formExamples` forms from above.
  */
 export declare const unionAnswerForms: (answerFormsList: ReadonlyArray<ReadonlyArray<PerseusNumericInputAnswerForm>>) => ReadonlyArray<PerseusNumericInputAnswerForm>;
+/**
+ * Filter out the correct answers and map them to the answer forms
+ * so that we can generate the examples for the widget.
+ */
+export declare function normalizeCorrectAnswerForms(answers: PerseusNumericInputWidgetOptions["answers"]): ReadonlyArray<PerseusNumericInputAnswerForm>;

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

@@ -12,14 +12,8 @@ export declare class LineHeightMeasurer extends React.Component<Record<any, any>
     measureLineHeight(): number;
     render(): React.ReactNode;
 }
-type RenderProps = {
-    passageTitle: PerseusPassageWidgetOptions["passageTitle"];
-    passageText: PerseusPassageWidgetOptions["passageText"];
-    footnotes: PerseusPassageWidgetOptions["footnotes"];
-    showLineNumbers: PerseusPassageWidgetOptions["showLineNumbers"];
-};
 type FindWidgetsCallback = (id: string, widgetInfo: PerseusWidget) => boolean;
-type PassageProps = ChangeableProps & WidgetProps<RenderProps> & {
+type PassageProps = ChangeableProps & WidgetProps<PerseusPassageWidgetOptions> & {
     findWidgets: (arg1: FindWidgetsCallback) => ReadonlyArray<Passage>;
     highlights: SerializedHighlightSet;
 };
@@ -103,7 +97,6 @@ declare const _default: {
     displayName: string;
     hidden: true;
     widget: typeof Passage;
-    transform: (editorProps: any) => RenderProps;
     isLintable: true;
 };
 export default _default;

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

@@ -41,11 +41,6 @@ declare const _default: {
     displayName: string;
     hidden: true;
     widget: typeof PassageRef;
-    transform: (widgetOptions: PerseusPassageRefWidgetOptions) => {
-        passageNumber: number;
-        referenceNumber: number;
-        summaryText: string | undefined;
-    };
     version: import("@khanacademy/perseus-core").Version | undefined;
 };
 export default _default;

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

@@ -24,7 +24,6 @@ declare const _default: {
     displayName: string;
     widget: typeof PassageRefTarget;
     hidden: true;
-    transform: (editorProps: any) => any;
     isLintable: true;
 };
 export default _default;

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

@@ -172,7 +172,6 @@ declare const _default: {
     hidden: true;
     widget: typeof Plotter;
     getCorrectUserInput: typeof getCorrectUserInput;
-    staticTransform: <T>(value: T) => T;
     getStartUserInput: typeof getStartUserInput;
     getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
 };

package/dist/widgets/radio/choice-indicator.new.d.ts

@@ -1,11 +1,17 @@
-import * as React from "react";
-export type IndicatorProps = {
+import React from "react";
+export interface IndicatorContent {
+    visible: string;
+    screenReader: string;
+    labelledBy?: string;
+    describedBy?: string;
+}
+export interface IndicatorProps {
     buttonRef: React.Ref<HTMLButtonElement>;
     checked: boolean;
-    content: string;
+    content: IndicatorContent;
     shape: "circle" | "square";
     showCorrectness?: "correct" | "wrong";
     updateChecked: (isChecked: boolean) => void;
-};
+}
 declare const Indicator: (props: IndicatorProps) => React.JSX.Element;
 export default Indicator;

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

@@ -1,8 +1,9 @@
 import React from "react";
+import type { IndicatorContent } from "./choice-indicator.new";
 export interface IndicatorProps {
     checked: boolean;
     children: React.ReactNode | React.ReactNode[];
-    indicatorContent: string;
+    indicatorContent: IndicatorContent;
     isMultiSelect: boolean;
     showCorrectness?: "correct" | "wrong";
     updateChecked: (isChecked: boolean) => void;

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

@@ -1,4 +1,4 @@
-import * as React from "react";
+import React from "react";
 import type { ChoiceType } from "./multiple-choice-widget.new";
 /**
  * Props for the MultipleChoiceComponent
@@ -20,6 +20,18 @@ export interface MultipleChoiceComponentProps {
  *
  * Supports both radio button (single select) and checkbox (multiple select) modes.
  *
+ * NOTE: This widget does not implement standard radio button or checkbox elements.
+ *       The key difference is that the single-select (aka radio button) should
+ *           allow the user to deselect a choice, whereas regular radio buttons
+ *           can only be deselected by selecting another choice.
+ *       Another difference is that keyboard navigation with single-select is
+ *           done with the tab key, whereas regular radio buttons use the arrow keys,
+ *           and the radio buttons are automatically selected when navigating to them.
+ *       Since interactions with the single-select version of this widget don't
+ *           follow the standard radio button behavior, we decided to use toggle
+ *           button semantics for both versions of the widget,
+ *           and implement additional ARIA attributes where needed.
+ *
  * Created as part of the Radio Revitalization Project (LEMS-2933).
  */
 declare const MultipleChoiceComponent: ({ choices, countChoices, multipleSelect, numCorrect, onChoiceChange, reviewMode, }: MultipleChoiceComponentProps) => React.ReactElement;

package/dist/widgets/video/video.d.ts

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