@khanacademy/perseus 82.0.1 → 82.2.0

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

@@ -1,11 +1,12 @@
 import * as React from "react";
-import type { Focusable } from "../../types";
+import { getCorrectUserInput, getOneCorrectAnswerFromRubric, getStartUserInput, getUserInputFromSerializedState } from "./utils";
+import type { Widget } from "../../types";
+import type { PerseusNumericInputUserInput, PerseusNumericInputWidgetOptions } from "@khanacademy/perseus-core";
 /**
- * The NumericInputComponent is a child component of the NumericInput class
- * component. It is responsible for rendering the UI elements of the Numeric
- * Input widget.
+ * The NumericInput widget is a numeric input field that supports a variety of
+ * answer forms, including integers, decimals, fractions, and mixed numbers.
  */
-export declare const NumericInputComponent: React.ForwardRefExoticComponent<import("@khanacademy/perseus-core").PerseusNumericInputWidgetOptions & {
+export declare const NumericInput: React.ForwardRefExoticComponent<PerseusNumericInputWidgetOptions & {
     trackInteraction: (extraData?: Empty | undefined) => void;
     widgetId: string;
     widgetIndex: number;
@@ -57,53 +58,75 @@ export declare const NumericInputComponent: React.ForwardRefExoticComponent<impo
     findWidgets: import("../../types").FindWidgetsFunction;
     reviewMode: boolean;
     showSolutions?: import("@khanacademy/perseus-core").ShowSolutions;
-    handleUserInput: (newUserInput: import("@khanacademy/perseus-core").PerseusNumericInputUserInput, cb?: () => void, silent?: boolean) => void;
-    userInput: import("@khanacademy/perseus-core").PerseusNumericInputUserInput;
+    handleUserInput: (newUserInput: PerseusNumericInputUserInput, cb?: () => void, silent?: boolean) => void;
+    userInput: PerseusNumericInputUserInput;
     linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
     containerSizeClass: import("../../util/sizing-utils").SizeClass;
-} & {
-    size: NonNullable<string>;
-    textAlign: NonNullable<"center" | "left" | "right">;
-    apiOptions: NonNullable<Readonly<Readonly<{
-        isArticle?: boolean;
-        onFocusChange?: (newFocusPath: import("../..").FocusPath, oldFocusPath: import("../..").FocusPath, keypadHeight?: number, focusedElement?: HTMLElement) => unknown;
-        showAlignmentOptions?: boolean;
-        readOnly?: boolean;
-        editingDisabled?: boolean;
-        answerableCallback?: (arg1: boolean) => unknown;
-        getAnotherHint?: () => unknown;
-        interactionCallback?: (widgetData: {
-            [widgetId: string]: any;
-        }) => void;
-        imagePlaceholder?: React.ReactNode;
-        widgetPlaceholder?: React.ReactNode;
-        baseElements?: {
-            Link: React.ComponentType<any>;
-        };
-        trackInteraction?: (args: {
-            type: string;
-            id: string;
-            correct?: boolean;
-        } & Partial<import("../../types").TrackingGradedGroupExtraArguments> & Partial<{
-            visible: number;
-        }>) => void;
-        customKeypad?: boolean;
-        isMobile?: boolean;
-        isMobileApp?: boolean;
-        hintProgressColor?: string;
-        flags?: Record<"perseus-renderer-upgrade" | "desmos-calculator", boolean>;
-    }> & {
-        baseElements: NonNullable<import("../..").APIOptions["baseElements"]>;
-        isArticle: NonNullable<import("../..").APIOptions["isArticle"]>;
-        isMobile: NonNullable<import("../..").APIOptions["isMobile"]>;
-        isMobileApp: NonNullable<import("../..").APIOptions["isMobileApp"]>;
-        editingDisabled: NonNullable<import("../..").APIOptions["editingDisabled"]>;
-        onFocusChange: NonNullable<import("../..").APIOptions["onFocusChange"]>;
-        readOnly: NonNullable<import("../..").APIOptions["readOnly"]>;
-        showAlignmentOptions: NonNullable<import("../..").APIOptions["showAlignmentOptions"]>;
-    }>>;
-    coefficient: NonNullable<boolean>;
-    answerForms: ReadonlyArray<import("@khanacademy/perseus-core").PerseusNumericInputAnswerForm>;
-    labelText: string;
-    linterContext: NonNullable<import("@khanacademy/perseus-linter").LinterContextProps>;
-} & React.RefAttributes<Focusable>>;
+} & React.RefAttributes<Widget>>;
+declare const _default: {
+    name: string;
+    displayName: string;
+    widget: React.ForwardRefExoticComponent<PerseusNumericInputWidgetOptions & {
+        trackInteraction: (extraData?: Empty | undefined) => void;
+        widgetId: string;
+        widgetIndex: number;
+        alignment: string | null | undefined;
+        static: boolean | null | undefined;
+        graded?: boolean | null;
+        problemNum: number | null | undefined;
+        apiOptions: Readonly<Readonly<{
+            isArticle?: boolean;
+            onFocusChange?: (newFocusPath: import("../..").FocusPath, oldFocusPath: import("../..").FocusPath, keypadHeight?: number, focusedElement?: HTMLElement) => unknown;
+            showAlignmentOptions?: boolean;
+            readOnly?: boolean;
+            editingDisabled?: boolean;
+            answerableCallback?: (arg1: boolean) => unknown;
+            getAnotherHint?: () => unknown;
+            interactionCallback?: (widgetData: {
+                [widgetId: string]: any;
+            }) => void;
+            imagePlaceholder?: React.ReactNode;
+            widgetPlaceholder?: React.ReactNode;
+            baseElements?: {
+                Link: React.ComponentType<any>;
+            };
+            trackInteraction?: (args: {
+                type: string;
+                id: string;
+                correct?: boolean;
+            } & Partial<import("../../types").TrackingGradedGroupExtraArguments> & Partial<{
+                visible: number;
+            }>) => void;
+            customKeypad?: boolean;
+            isMobile?: boolean;
+            isMobileApp?: boolean;
+            hintProgressColor?: string;
+            flags?: Record<"perseus-renderer-upgrade" | "desmos-calculator", boolean>;
+        }> & {
+            baseElements: NonNullable<import("../..").APIOptions["baseElements"]>;
+            isArticle: NonNullable<import("../..").APIOptions["isArticle"]>;
+            isMobile: NonNullable<import("../..").APIOptions["isMobile"]>;
+            isMobileApp: NonNullable<import("../..").APIOptions["isMobileApp"]>;
+            editingDisabled: NonNullable<import("../..").APIOptions["editingDisabled"]>;
+            onFocusChange: NonNullable<import("../..").APIOptions["onFocusChange"]>;
+            readOnly: NonNullable<import("../..").APIOptions["readOnly"]>;
+            showAlignmentOptions: NonNullable<import("../..").APIOptions["showAlignmentOptions"]>;
+        }>;
+        keypadElement?: any;
+        onFocus: (blurPath: import("../..").FocusPath) => void;
+        onBlur: (blurPath: import("../..").FocusPath) => void;
+        findWidgets: import("../../types").FindWidgetsFunction;
+        reviewMode: boolean;
+        showSolutions?: import("@khanacademy/perseus-core").ShowSolutions;
+        handleUserInput: (newUserInput: PerseusNumericInputUserInput, cb?: () => void, silent?: boolean) => void;
+        userInput: PerseusNumericInputUserInput;
+        linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
+        containerSizeClass: import("../../util/sizing-utils").SizeClass;
+    } & React.RefAttributes<Widget>>;
+    isLintable: true;
+    getCorrectUserInput: typeof getCorrectUserInput;
+    getOneCorrectAnswerFromRubric: typeof getOneCorrectAnswerFromRubric;
+    getStartUserInput: typeof getStartUserInput;
+    getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
+};
+export default _default;

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

@@ -1,5 +1,5 @@
 import type { PerseusStrings } from "../../strings";
-import type { PerseusNumericInputAnswerForm, PerseusNumericInputWidgetOptions } from "@khanacademy/perseus-core";
+import type { PerseusNumericInputAnswerForm, PerseusNumericInputRubric, PerseusNumericInputUserInput, PerseusNumericInputWidgetOptions } from "@khanacademy/perseus-core";
 /**
  * Generates the specific set of examples for the current question.
  * This string is shown as examples to the user in a tooltip.
@@ -21,3 +21,16 @@ export declare const unionAnswerForms: (answerFormsList: ReadonlyArray<ReadonlyA
  * so that we can generate the examples for the widget.
  */
 export declare function normalizeCorrectAnswerForms(answers: PerseusNumericInputWidgetOptions["answers"]): ReadonlyArray<PerseusNumericInputAnswerForm>;
+export declare function getStartUserInput(): PerseusNumericInputUserInput;
+/**
+ * @deprecated and likely a very broken API
+ * [LEMS-3185] do not trust serializedState
+ */
+export declare function getUserInputFromSerializedState(serializedState: any): PerseusNumericInputUserInput;
+export declare function findPrecision(value: number): number;
+export declare function findCommonFractions(value: number): {
+    num: number;
+    denom: number;
+} | undefined;
+export declare function getCorrectUserInput(options: PerseusNumericInputWidgetOptions): PerseusNumericInputUserInput;
+export declare function getOneCorrectAnswerFromRubric(rubric: PerseusNumericInputRubric): string | null | undefined;

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

@@ -48,6 +48,8 @@ export declare class PhetSimulation extends React.Component<Props, State> implem
      * the lack of support for the Fullscreen API.
      */
     toggleFullScreen: () => void;
+    requestIframeFullscreen: () => void;
+    renderCornerButton(url: URL, isMobileApp: boolean | undefined): React.ReactNode;
     render(): React.ReactNode;
 }
 declare const _default: {

package/package.json

@@ -3,7 +3,7 @@
   "description": "Core Perseus API (includes renderers and widgets)",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "82.0.1",
+  "version": "82.2.0",
   "publishConfig": {
     "access": "public"
   },
@@ -42,13 +42,13 @@
     "mafs": "0.19.0",
     "tiny-invariant": "1.3.1",
     "uuid": "^10.0.0",
-    "@khanacademy/keypad-context": "3.2.76",
-    "@khanacademy/kmath": "2.4.35",
-    "@khanacademy/math-input": "26.6.5",
-    "@khanacademy/perseus-linter": "5.1.16",
-    "@khanacademy/kas": "2.2.3",
-    "@khanacademy/perseus-core": "33.0.0",
-    "@khanacademy/perseus-score": "8.12.8",
+    "@khanacademy/kas": "2.2.4",
+    "@khanacademy/keypad-context": "3.2.78",
+    "@khanacademy/kmath": "2.4.37",
+    "@khanacademy/math-input": "26.6.7",
+    "@khanacademy/perseus-core": "34.0.0",
+    "@khanacademy/perseus-linter": "5.1.18",
+    "@khanacademy/perseus-score": "8.12.10",
     "@khanacademy/perseus-utils": "2.1.5",
     "@khanacademy/pure-markdown": "2.3.1",
     "@khanacademy/simple-markdown": "3.0.0"
@@ -59,7 +59,7 @@
     "@khanacademy/wonder-blocks-button": "11.7.6",
     "@khanacademy/wonder-blocks-clickable": "8.2.8",
     "@khanacademy/wonder-blocks-core": "12.4.4",
-    "@khanacademy/wonder-blocks-data": "15.0.2",
+    "@khanacademy/wonder-blocks-data": "15.0.3",
     "@khanacademy/wonder-blocks-dropdown": "10.11.7",
     "@khanacademy/wonder-blocks-form": "7.6.9",
     "@khanacademy/wonder-blocks-icon": "5.3.22",
@@ -96,7 +96,7 @@
     "@khanacademy/wonder-blocks-button": "^11.7.6",
     "@khanacademy/wonder-blocks-clickable": "^8.2.8",
     "@khanacademy/wonder-blocks-core": "^12.4.4",
-    "@khanacademy/wonder-blocks-data": "^15.0.2",
+    "@khanacademy/wonder-blocks-data": "^15.0.3",
     "@khanacademy/wonder-blocks-dropdown": "^10.11.7",
     "@khanacademy/wonder-blocks-form": "^7.6.9",
     "@khanacademy/wonder-blocks-icon": "^5.3.22",
@@ -127,7 +127,7 @@
   },
   "keywords": [],
   "khan": {
-    "catalogHash": "ad217163f04bf0b2"
+    "catalogHash": "3f4a3330f0a56ab9"
   },
   "scripts": {}
 }

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

@@ -1,127 +0,0 @@
-import * as React from "react";
-import type { Focusable, Widget, WidgetProps } from "../../types";
-import type { NumericInputPromptJSON } from "../../widget-ai-utils/numeric-input/prompt-utils";
-import type { PerseusNumericInputAnswerForm, PerseusNumericInputRubric, PerseusNumericInputUserInput, PerseusNumericInputWidgetOptions } from "@khanacademy/perseus-core";
-type ExternalProps = WidgetProps<PerseusNumericInputWidgetOptions, PerseusNumericInputUserInput>;
-export type NumericInputProps = ExternalProps & {
-    size: NonNullable<ExternalProps["size"]>;
-    textAlign: NonNullable<ExternalProps["textAlign"]>;
-    apiOptions: NonNullable<ExternalProps["apiOptions"]>;
-    coefficient: NonNullable<ExternalProps["coefficient"]>;
-    answerForms: ReadonlyArray<PerseusNumericInputAnswerForm>;
-    labelText: string;
-    linterContext: NonNullable<ExternalProps["linterContext"]>;
-};
-type DefaultProps = Pick<NumericInputProps, "size" | "apiOptions" | "coefficient" | "answerForms" | "labelText" | "linterContext" | "userInput">;
-/**
- * The NumericInput widget is a numeric input field that supports a variety of
- * answer forms, including integers, decimals, fractions, and mixed numbers.
- *
- * [Jan 2025] We're currenly migrating from class-based components to functional
- * components. While we cannot fully migrate this component yet, we can start
- * by using the functional component for the rendering the UI of the widget.
- */
-export declare class NumericInput extends React.Component<NumericInputProps> implements Widget {
-    inputRef: React.RefObject<Focusable>;
-    static defaultProps: DefaultProps;
-    focus: () => boolean;
-    blur: () => void;
-    focusInputPath: () => void;
-    blurInputPath: () => void;
-    getInputPaths: () => ReadonlyArray<ReadonlyArray<string>>;
-    /**
-     * Returns the JSON representation of the prompt for this widget.
-     * 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
-     */
-    getSerializedState(): {
-        currentValue: string;
-        labelText: string;
-        size: string;
-        coefficient: boolean;
-        textAlign: "left" | "right" | "center";
-        trackInteraction: (extraData?: Empty | undefined) => void;
-        widgetId: string;
-        widgetIndex: number;
-        alignment: string | null | undefined;
-        static: boolean | null | undefined;
-        graded?: boolean | null;
-        problemNum: number | null | undefined;
-        apiOptions: Readonly<Readonly<{
-            isArticle?: boolean;
-            onFocusChange?: (newFocusPath: import("../..").FocusPath, oldFocusPath: import("../..").FocusPath, keypadHeight?: number, focusedElement?: HTMLElement) => unknown;
-            showAlignmentOptions?: boolean;
-            readOnly?: boolean;
-            editingDisabled?: boolean;
-            answerableCallback?: (arg1: boolean) => unknown;
-            getAnotherHint?: () => unknown;
-            interactionCallback?: (widgetData: {
-                [widgetId: string]: any;
-            }) => void;
-            imagePlaceholder?: React.ReactNode;
-            widgetPlaceholder?: React.ReactNode;
-            baseElements?: {
-                Link: React.ComponentType<any>;
-            };
-            trackInteraction?: (args: {
-                type: string;
-                id: string;
-                correct?: boolean;
-            } & Partial<import("../../types").TrackingGradedGroupExtraArguments> & Partial<{
-                visible: number;
-            }>) => void;
-            customKeypad?: boolean;
-            isMobile?: boolean;
-            isMobileApp?: boolean;
-            hintProgressColor?: string;
-            flags?: Record<"perseus-renderer-upgrade" | "desmos-calculator", boolean>;
-        }> & {
-            baseElements: NonNullable<import("../..").APIOptions["baseElements"]>;
-            isArticle: NonNullable<import("../..").APIOptions["isArticle"]>;
-            isMobile: NonNullable<import("../..").APIOptions["isMobile"]>;
-            isMobileApp: NonNullable<import("../..").APIOptions["isMobileApp"]>;
-            editingDisabled: NonNullable<import("../..").APIOptions["editingDisabled"]>;
-            onFocusChange: NonNullable<import("../..").APIOptions["onFocusChange"]>;
-            readOnly: NonNullable<import("../..").APIOptions["readOnly"]>;
-            showAlignmentOptions: NonNullable<import("../..").APIOptions["showAlignmentOptions"]>;
-        }>;
-        keypadElement?: any;
-        onFocus: (blurPath: import("../..").FocusPath) => void;
-        onBlur: (blurPath: import("../..").FocusPath) => void;
-        findWidgets: import("../../types").FindWidgetsFunction;
-        reviewMode: boolean;
-        showSolutions?: import("@khanacademy/perseus-core").ShowSolutions;
-        handleUserInput: (newUserInput: PerseusNumericInputUserInput, cb?: () => void, silent?: boolean) => void;
-        linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
-        containerSizeClass: import("../../util/sizing-utils").SizeClass;
-        answerForms: ReadonlyArray<PerseusNumericInputAnswerForm>;
-    };
-    render(): React.ReactNode;
-}
-declare function getStartUserInput(): PerseusNumericInputUserInput;
-/**
- * @deprecated and likely a very broken API
- * [LEMS-3185] do not trust serializedState
- */
-declare function getUserInputFromSerializedState(serializedState: any): PerseusNumericInputUserInput;
-export declare function findPrecision(value: number): number;
-export declare function findCommonFractions(value: number): {
-    num: number;
-    denom: number;
-} | undefined;
-declare function getCorrectUserInput(options: PerseusNumericInputWidgetOptions): PerseusNumericInputUserInput;
-declare const _default: {
-    name: string;
-    displayName: string;
-    widget: typeof NumericInput;
-    isLintable: true;
-    getCorrectUserInput: typeof getCorrectUserInput;
-    getOneCorrectAnswerFromRubric(rubric: PerseusNumericInputRubric): string | null | undefined;
-    getStartUserInput: typeof getStartUserInput;
-    getUserInputFromSerializedState: typeof getUserInputFromSerializedState;
-};
-export default _default;