@khanacademy/perseus 65.4.0 → 65.5.0

package/dist/widgets/interactive-graphs/backgrounds/axis-labels.d.ts

@@ -1,15 +1,5 @@
-import { vec } from "mafs";
 import React from "react";
 import type { I18nContextType } from "../../../components/i18n-context";
-import type { GraphConfig } from "../reducer/use-graph-config";
-import type { GraphDimensions } from "../types";
-export declare const fontSize = 14;
 export default function AxisLabels({ i18n }: {
     i18n: I18nContextType;
 }): React.JSX.Element;
-export declare const getLabelTransform: (labelLocation: GraphConfig["labelLocation"]) => {
-    xLabelTransform: string;
-    yLabelTransform: string;
-};
-export declare const clampLabelPosition: (labelPosition: vec.Vector2, graphInfo: GraphDimensions) => vec.Vector2;
-export declare const getLabelPosition: (graphInfo: GraphDimensions, labelLocation: GraphConfig["labelLocation"]) => vec.Vector2[];

package/dist/widgets/interactive-graphs/backgrounds/axis-ticks.d.ts

@@ -1,7 +1,2 @@
 import * as React from "react";
-import type { Interval } from "mafs";
-export declare const shouldShowLabel: (currentTick: number, range: [Interval, Interval], tickStep: number) => boolean;
-export declare function generateTickLocations(tickStep: number, min: number, max: number): number[];
-export declare const countSignificantDecimals: (number: number) => number;
-export declare function divideByAndShowPi(value: number): string;
 export declare const AxisTicks: () => React.JSX.Element;

package/dist/widgets/interactive-graphs/backgrounds/utils.d.ts

@@ -0,0 +1,20 @@
+import { vec } from "mafs";
+import type { GraphConfig } from "../reducer/use-graph-config";
+import type { GraphDimensions } from "../types";
+import type { Interval } from "mafs";
+export declare const fontSize = 14;
+export declare const clampLabelPosition: (labelPosition: vec.Vector2, graphInfo: GraphDimensions) => vec.Vector2;
+export declare const getLabelTransform: (labelLocation: GraphConfig["labelLocation"]) => {
+    xLabelTransform: string;
+    yLabelTransform: string;
+};
+/**
+ * Calculate the maximum number of digits needed to display tick labels on the y-axis.
+ * This accounts for both the integer part of the range values and decimal places in the tick step.
+ */
+export declare const calculateMaxDigitsInRange: (range: [number, number], tickStep: number) => number;
+export declare const getLabelPosition: (graphInfo: GraphDimensions, labelLocation: GraphConfig["labelLocation"], tickStep: GraphConfig["tickStep"]) => vec.Vector2[];
+export declare const shouldShowLabel: (currentTick: number, range: [Interval, Interval], tickStep: number) => boolean;
+export declare function generateTickLocations(tickStep: number, min: number, max: number): number[];
+export declare const countSignificantDecimals: (number: number) => number;
+export declare function divideByAndShowPi(value: number): string;

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

@@ -1,7 +1,6 @@
 import * as React from "react";
 import type { InteractiveGraphAction } from "./reducer/interactive-graph-action";
 import type { InteractiveGraphState, InteractiveGraphProps } from "./types";
-import type { vec } from "mafs";
 import "mafs/core.css";
 import "./mafs-styles.css";
 export type MafsGraphProps = {
@@ -24,7 +23,3 @@ export type MafsGraphProps = {
     static: boolean | null | undefined;
 };
 export declare const MafsGraph: (props: MafsGraphProps) => React.JSX.Element;
-export declare const calculateNestedSVGCoords: (range: vec.Vector2[], width: number, height: number) => {
-    viewboxX: number;
-    viewboxY: number;
-};

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

@@ -34,3 +34,7 @@ export declare const mathOnlyParser: import("@khanacademy/simple-markdown").Pars
  */
 export declare function replaceOutsideTeX(mathString: string): string;
 export declare function getBaseMafsGraphPropsForTests(): MafsGraphProps;
+export declare const calculateNestedSVGCoords: (range: vec.Vector2[], width: number, height: number) => {
+    viewboxX: number;
+    viewboxY: number;
+};

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

@@ -16,7 +16,7 @@ export type RenderProps = {
     choiceStates?: ChoiceState[];
     values?: boolean[];
 };
-type Props = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>;
+export type Props = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>;
 type DefaultProps = Required<Pick<Props, "choices" | "multipleSelect" | "countChoices" | "deselectEnabled" | "linterContext" | "showSolutions">>;
 export type RadioChoiceWithMetadata = PerseusRadioChoice & {
     originalIndex: number;
@@ -27,13 +27,16 @@ declare class Radio extends React.Component<Props> implements Widget {
     context: React.ContextType<typeof PerseusI18nContext>;
     focusFunction: FocusFunction;
     static defaultProps: DefaultProps;
-    static getUserInputFromProps(props: Props, unshuffle?: boolean): PerseusRadioUserInput;
     _renderRenderer: (content?: string) => React.ReactElement;
     focus(choiceIndex?: number | null): boolean;
     registerFocusFunction(fun: FocusFunction): void;
     updateChoices: (newValueLists: Readonly<{
         checked: ReadonlyArray<boolean>;
     }>) => void;
+    /**
+     * TODO: remove this when everything is pulling from Renderer state
+     * @deprecated get user input from Renderer state
+     */
     getUserInput(): PerseusRadioUserInput;
     getPromptJSON(): RadioPromptJSON;
     render(): React.ReactNode;

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

@@ -29,7 +29,10 @@ export interface RadioChoiceWithMetadata extends PerseusRadioChoice {
  */
 declare class Radio extends React.Component<Props> implements Widget {
     static defaultProps: DefaultProps;
-    static getUserInputFromProps(props: Props, unshuffle?: boolean): PerseusRadioUserInput;
+    /**
+     * TODO: remove this when everything is pulling from Renderer state
+     * @deprecated get user input from Renderer state
+     */
     getUserInput(): PerseusRadioUserInput;
     getPromptJSON(): RadioPromptJSON;
     render(): React.ReactNode;

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

@@ -1,18 +1,21 @@
 import Radio from "./radio.ff";
+import { getUserInputFromSerializedState } from "./util";
 import type { RenderProps } from "./radio-component";
 import type { PerseusStrings } from "../../strings";
-import type { PerseusRadioWidgetOptions } from "@khanacademy/perseus-core";
+import type { PerseusRadioUserInput, PerseusRadioWidgetOptions, RadioPublicWidgetOptions } from "@khanacademy/perseus-core";
+declare function getStartUserInput(options: RadioPublicWidgetOptions): PerseusRadioUserInput;
 declare const _default: {
     name: string;
     displayName: string;
     widget: typeof Radio;
     transform: (widgetOptions: PerseusRadioWidgetOptions, strings: PerseusStrings, problemNum?: number | null) => RenderProps;
     staticTransform: (widgetOptions: PerseusRadioWidgetOptions, strings: PerseusStrings, problemNum?: number | null) => RenderProps;
+    getStartUserInput: typeof getStartUserInput;
     version: import("@khanacademy/perseus-core").Version | undefined;
     isLintable: true;
     /**
      * @deprecated - do not use in new code.
      */
-    getUserInputFromSerializedState: typeof import("./radio-component").default.getUserInputFromProps;
+    getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
 };
 export default _default;

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

@@ -1,9 +1,13 @@
+import { type PerseusRadioRubric, type PerseusRadioUserInput } from "@khanacademy/perseus-core";
 import * as React from "react";
 import RadioOld from "./radio-component";
 import type { RenderProps } from "./radio-component";
-import type { WidgetProps } from "../../types";
-import type { PerseusRadioRubric, PerseusRadioUserInput } from "@khanacademy/perseus-core";
+import type { ChoiceState, WidgetProps } from "../../types";
 type Props = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>;
+type ChoiceStateWithoutSelected = Omit<ChoiceState, "selected">;
+type State = {
+    choiceStates: ChoiceStateWithoutSelected[];
+};
 /**
  * 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.
@@ -16,7 +20,93 @@ type Props = WidgetProps<RenderProps, PerseusRadioUserInput, PerseusRadioRubric>
 declare class Radio extends RadioOld {
     ffIsOn: boolean;
     radioRef: React.RefObject<RadioOld>;
+    state: State;
     constructor(props: Props);
+    /**
+     * @deprecated and likely very broken API
+     * [LEMS-3185] do not trust serializedState/restoreSerializedState
+     */
+    getSerializedState(): {
+        numCorrect: number;
+        hasNoneOfTheAbove?: boolean;
+        multipleSelect?: boolean;
+        countChoices?: 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;
+        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<import("../../types").Widget>;
+        reviewMode: boolean;
+        onChange: import("../..").ChangeHandler;
+        handleUserInput: (newUserInput: PerseusRadioUserInput, cb?: () => void, silent?: boolean) => void;
+        isLastUsedWidget: boolean;
+        linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
+        containerSizeClass: import("../../util/sizing-utils").SizeClass;
+    };
+    _handleChange(arg: {
+        choiceStates?: ChoiceState[];
+    }): void;
+    _mergePropsAndState(): Props;
     focus(choiceIndex?: number | null): boolean;
     render(): React.ReactNode;
 }

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

@@ -1,7 +1,10 @@
+import type { Props } from "./radio-component";
 import type { PerseusStrings } from "../../strings";
+import type { PerseusRadioUserInput } from "@khanacademy/perseus-core";
 /**
  * Given a choice's position in the radio widget, return the corresponding
  * "choice letter". (For example, in English, `getChoiceLetter(0)` is "A",
  * `getChoiceLetter(1)` is "B", etc.)
  */
 export declare function getChoiceLetter(pos: number, strings: PerseusStrings): string;
+export declare function getUserInputFromSerializedState(props: Props, unshuffle?: boolean): PerseusRadioUserInput;

package/package.json

@@ -3,7 +3,7 @@
   "description": "Core Perseus API (includes renderers and widgets)",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "65.4.0",
+  "version": "65.5.0",
   "publishConfig": {
     "access": "public"
   },
@@ -42,37 +42,37 @@
     "tiny-invariant": "1.3.1",
     "uuid": "^10.0.0",
     "@khanacademy/kas": "2.0.9",
-    "@khanacademy/keypad-context": "3.0.23",
-    "@khanacademy/kmath": "2.0.23",
-    "@khanacademy/math-input": "26.0.12",
-    "@khanacademy/perseus-core": "16.1.1",
-    "@khanacademy/perseus-linter": "4.0.10",
-    "@khanacademy/perseus-score": "7.1.10",
+    "@khanacademy/keypad-context": "3.0.24",
+    "@khanacademy/kmath": "2.0.24",
+    "@khanacademy/math-input": "26.0.13",
+    "@khanacademy/perseus-core": "17.0.0",
+    "@khanacademy/perseus-linter": "4.0.11",
+    "@khanacademy/perseus-score": "7.1.11",
     "@khanacademy/perseus-utils": "2.0.5",
-    "@khanacademy/pure-markdown": "2.0.9",
-    "@khanacademy/simple-markdown": "2.0.9"
+    "@khanacademy/pure-markdown": "2.0.10",
+    "@khanacademy/simple-markdown": "2.0.10"
   },
   "devDependencies": {
-    "@khanacademy/wonder-blocks-banner": "4.2.0",
-    "@khanacademy/wonder-blocks-button": "10.2.4",
-    "@khanacademy/wonder-blocks-clickable": "7.1.9",
+    "@khanacademy/wonder-blocks-banner": "4.2.4",
+    "@khanacademy/wonder-blocks-button": "10.2.8",
+    "@khanacademy/wonder-blocks-clickable": "7.1.12",
     "@khanacademy/wonder-blocks-core": "12.3.0",
     "@khanacademy/wonder-blocks-data": "14.1.4",
-    "@khanacademy/wonder-blocks-dropdown": "10.1.10",
-    "@khanacademy/wonder-blocks-form": "7.1.22",
-    "@khanacademy/wonder-blocks-icon-button": "10.3.3",
-    "@khanacademy/wonder-blocks-icon": "5.2.3",
-    "@khanacademy/wonder-blocks-labeled-field": "3.0.17",
-    "@khanacademy/wonder-blocks-layout": "3.1.20",
-    "@khanacademy/wonder-blocks-link": "9.1.9",
-    "@khanacademy/wonder-blocks-pill": "3.1.22",
-    "@khanacademy/wonder-blocks-popover": "6.1.11",
-    "@khanacademy/wonder-blocks-progress-spinner": "3.1.20",
-    "@khanacademy/wonder-blocks-switch": "3.3.2",
-    "@khanacademy/wonder-blocks-tokens": "11.1.0",
-    "@khanacademy/wonder-blocks-tooltip": "4.1.25",
-    "@khanacademy/wonder-blocks-typography": "4.2.4",
-    "@khanacademy/wonder-stuff-core": "1.5.4",
+    "@khanacademy/wonder-blocks-dropdown": "10.2.2",
+    "@khanacademy/wonder-blocks-form": "7.1.26",
+    "@khanacademy/wonder-blocks-icon-button": "10.3.7",
+    "@khanacademy/wonder-blocks-icon": "5.2.6",
+    "@khanacademy/wonder-blocks-labeled-field": "3.0.21",
+    "@khanacademy/wonder-blocks-layout": "3.1.23",
+    "@khanacademy/wonder-blocks-link": "9.1.12",
+    "@khanacademy/wonder-blocks-pill": "3.1.27",
+    "@khanacademy/wonder-blocks-popover": "6.1.15",
+    "@khanacademy/wonder-blocks-progress-spinner": "3.1.23",
+    "@khanacademy/wonder-blocks-switch": "3.3.5",
+    "@khanacademy/wonder-blocks-tokens": "11.2.1",
+    "@khanacademy/wonder-blocks-tooltip": "4.1.29",
+    "@khanacademy/wonder-blocks-typography": "4.2.8",
+    "@khanacademy/wonder-stuff-core": "1.5.5",
     "@phosphor-icons/core": "2.0.2",
     "@popperjs/core": "2.10.2",
     "aphrodite": "1.2.5",
@@ -90,26 +90,26 @@
     "raphael": "1.5.4"
   },
   "peerDependencies": {
-    "@khanacademy/wonder-blocks-banner": "^4.2.0",
-    "@khanacademy/wonder-blocks-button": "^10.2.4",
-    "@khanacademy/wonder-blocks-clickable": "^7.1.9",
+    "@khanacademy/wonder-blocks-banner": "^4.2.4",
+    "@khanacademy/wonder-blocks-button": "^10.2.8",
+    "@khanacademy/wonder-blocks-clickable": "^7.1.12",
     "@khanacademy/wonder-blocks-core": "^12.3.0",
     "@khanacademy/wonder-blocks-data": "^14.1.4",
-    "@khanacademy/wonder-blocks-dropdown": "^10.1.10",
-    "@khanacademy/wonder-blocks-form": "^7.1.22",
-    "@khanacademy/wonder-blocks-icon": "^5.2.3",
-    "@khanacademy/wonder-blocks-icon-button": "^10.3.3",
-    "@khanacademy/wonder-blocks-labeled-field": "^3.0.17",
-    "@khanacademy/wonder-blocks-layout": "^3.1.20",
-    "@khanacademy/wonder-blocks-link": "^9.1.9",
-    "@khanacademy/wonder-blocks-pill": "^3.1.22",
-    "@khanacademy/wonder-blocks-popover": "^6.1.11",
-    "@khanacademy/wonder-blocks-progress-spinner": "^3.1.20",
-    "@khanacademy/wonder-blocks-switch": "^3.3.2",
-    "@khanacademy/wonder-blocks-tokens": "^11.1.0",
-    "@khanacademy/wonder-blocks-tooltip": "^4.1.25",
-    "@khanacademy/wonder-blocks-typography": "^4.2.4",
-    "@khanacademy/wonder-stuff-core": "^1.5.4",
+    "@khanacademy/wonder-blocks-dropdown": "^10.2.2",
+    "@khanacademy/wonder-blocks-form": "^7.1.26",
+    "@khanacademy/wonder-blocks-icon": "^5.2.6",
+    "@khanacademy/wonder-blocks-icon-button": "^10.3.7",
+    "@khanacademy/wonder-blocks-labeled-field": "^3.0.21",
+    "@khanacademy/wonder-blocks-layout": "^3.1.23",
+    "@khanacademy/wonder-blocks-link": "^9.1.12",
+    "@khanacademy/wonder-blocks-pill": "^3.1.27",
+    "@khanacademy/wonder-blocks-popover": "^6.1.15",
+    "@khanacademy/wonder-blocks-progress-spinner": "^3.1.23",
+    "@khanacademy/wonder-blocks-switch": "^3.3.5",
+    "@khanacademy/wonder-blocks-tokens": "^11.2.1",
+    "@khanacademy/wonder-blocks-tooltip": "^4.1.29",
+    "@khanacademy/wonder-blocks-typography": "^4.2.8",
+    "@khanacademy/wonder-stuff-core": "^1.5.5",
     "@phosphor-icons/core": "^2.0.2",
     "@popperjs/core": "^2.10.2",
     "aphrodite": "^1.2.5",