@khanacademy/perseus 43.0.1 → 44.0.0

package/dist/widgets/interactive-graphs/graphs/components/use-control-point.d.ts

@@ -1,11 +1,17 @@
 import * as React from "react";
 import type { CSSCursor } from "./css-cursor";
+import type { AriaLive } from "../../types";
 import type { KeyboardMovementConstraint } from "../use-draggable";
 import type { vec } from "mafs";
 type Params = {
     point: vec.Vector2;
+    ariaDescribedBy?: string;
+    ariaLabel?: string;
+    ariaLive?: AriaLive;
     color?: string | undefined;
+    constrain?: KeyboardMovementConstraint;
     cursor?: CSSCursor | undefined;
+    forwardedRef?: React.ForwardedRef<SVGGElement | null> | undefined;
     /**
      * Represents where this point stands in the overall point sequence.
      * This is used to provide screen readers with context about the point.
@@ -14,13 +20,11 @@ type Params = {
      * Note: This number is 1-indexed, and should restart from 1 for each
      * interactive figure on the graph.
      */
-    sequenceNumber: number;
-    constrain?: KeyboardMovementConstraint;
+    sequenceNumber?: number;
     onMove?: ((newPoint: vec.Vector2) => unknown) | undefined;
     onClick?: (() => unknown) | undefined;
     onFocus?: ((event: React.FocusEvent) => unknown) | undefined;
     onBlur?: ((event: React.FocusEvent) => unknown) | undefined;
-    forwardedRef?: React.ForwardedRef<SVGGElement | null> | undefined;
 };
 type Return = {
     focusableHandle: React.ReactNode;

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

@@ -2,5 +2,5 @@ import type { QuadraticGraphState, Dispatch, InteractiveGraphElementSuite } from
 export declare function renderQuadraticGraph(state: QuadraticGraphState, dispatch: Dispatch): InteractiveGraphElementSuite;
 type QuadraticCoefficient = [number, number, number];
 export type QuadraticCoords = QuadraticGraphState["coords"];
-export declare const getQuadraticCoefficients: (coords: [import("../../..").Coord, import("../../..").Coord, import("../../..").Coord]) => QuadraticCoefficient | undefined;
+export declare const getQuadraticCoefficients: (coords: QuadraticCoords) => QuadraticCoefficient | undefined;
 export {};

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

@@ -90,3 +90,4 @@ export type GraphDimensions = {
     width: number;
     height: number;
 };
+export type AriaLive = "off" | "assertive" | "polite" | undefined;

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

@@ -1,4 +1,3 @@
-/// <reference path="../../../types/aphrodite.d.ts" />
 import { type CSSProperties } from "aphrodite";
 import * as React from "react";
 export declare const AnswerPill: (props: {

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

@@ -88,72 +88,12 @@ export declare class LabelImage extends React.Component<LabelImageProps, LabelIm
 declare const _default: {
     name: string;
     displayName: string;
-    widget: React.ForwardRefExoticComponent<Omit<ChangeableProps & Partial<import("../../types").PerseusDependenciesV2> & Omit<PerseusLabelImageWidgetOptions, "markers"> & {
-        apiOptions: Readonly<{
-            isArticle?: boolean | undefined;
-            onFocusChange?: ((newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
-            GroupMetadataEditor?: React.ComponentType<any> | undefined;
-            showAlignmentOptions?: boolean | undefined;
-            readOnly?: boolean | undefined;
-            answerableCallback?: ((arg1: boolean) => unknown) | undefined;
-            getAnotherHint?: (() => unknown) | undefined;
-            interactionCallback?: ((widgetData: {
-                [widgetId: string]: any;
-            }) => void) | undefined;
-            groupAnnotator?: ((groupNumber: number, widgetId: string) => React.ReactNode) | undefined;
-            imagePlaceholder?: React.ReactNode;
-            widgetPlaceholder?: React.ReactNode;
-            baseElements?: {
-                Link: React.ComponentType<any>;
-            } | undefined;
-            imagePreloader?: ((dimensions: import("../../types").Dimensions) => React.ReactNode) | undefined;
-            trackInteraction?: ((args: {
-                type: string;
-                id: string;
-                correct?: boolean | undefined;
-            } & Partial<import("../../types").TrackingGradedGroupExtraArguments> & Partial<{
-                visible: number;
-            }>) => void) | undefined;
-            customKeypad?: boolean | undefined;
-            nativeKeypadProxy?: ((blur: () => void) => import("@khanacademy/math-input").KeypadAPI) | undefined;
-            isMobile?: boolean | undefined;
-            setDrawingAreaAvailable?: ((arg1: boolean) => unknown) | undefined;
-            hintProgressColor?: string | undefined;
-            canScrollPage?: boolean | undefined;
-            crossOutEnabled?: boolean | undefined;
-            editorChangeDelay?: number | undefined;
-            flags?: {
-                mafs?: false | ({
-                    none?: boolean | undefined;
-                    linear?: boolean | undefined;
-                    circle?: boolean | undefined;
-                    polygon?: boolean | undefined;
-                    point?: boolean | undefined;
-                    quadratic?: boolean | undefined;
-                    sinusoid?: boolean | undefined;
-                    angle?: boolean | undefined;
-                    "linear-system"?: boolean | undefined;
-                    ray?: boolean | undefined;
-                    segment?: boolean | undefined;
-                    "unlimited-polygon"?: boolean | undefined;
-                    "unlimited-point"?: boolean | undefined;
-                } & {
-                    "interactive-graph-locked-features-labels"?: boolean | undefined;
-                    "locked-figures-aria"?: boolean | undefined;
-                    "locked-point-labels"?: boolean | undefined;
-                    "locked-line-labels"?: boolean | undefined;
-                    "locked-vector-labels"?: boolean | undefined;
-                    "locked-ellipse-labels"?: boolean | undefined;
-                    "locked-polygon-labels"?: boolean | undefined;
-                    "locked-function-labels"?: boolean | undefined;
-                }) | undefined;
-            } | undefined;
-            onWidgetStartProps?: ((widgets: import("../../perseus-types").PerseusWidgetsMap) => void) | undefined;
-        }>;
-        markers: readonly InteractiveMarkerType[];
+    widget: React.ForwardRefExoticComponent<Omit<ChangeableProps & Partial<import("../..").PerseusDependenciesV2> & Omit<PerseusLabelImageWidgetOptions, "markers"> & {
+        apiOptions: APIOptions;
+        markers: ReadonlyArray<InteractiveMarkerType>;
         questionCompleted: boolean;
-        preferredPopoverDirection?: PreferredPopoverDirection | undefined;
-    }, keyof import("../../types").PerseusDependenciesV2> & React.RefAttributes<LabelImage>>;
+        preferredPopoverDirection?: PreferredPopoverDirection;
+    }, keyof import("../..").PerseusDependenciesV2> & React.RefAttributes<LabelImage>>;
     accessible: true;
     isLintable: true;
     scorer: typeof scoreLabelImage;

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

@@ -3,7 +3,6 @@
  *
  * The target for labeling question image with answers.
  */
-/// <reference path="../../../types/aphrodite.d.ts" />
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { InteractiveMarkerType } from "./types";

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

@@ -1,12 +1,19 @@
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import scoreMatrix from "./score-matrix";
-import type { PerseusMatrixWidgetOptions } from "../../perseus-types";
+import type { PerseusMatrixWidgetAnswers } from "../../perseus-types";
 import type { WidgetProps, Widget, FocusPath } from "../../types";
 import type { PerseusMatrixRubric, PerseusMatrixUserInput } from "../../validation.types";
 import type { MatrixPromptJSON } from "../../widget-ai-utils/matrix/matrix-ai-utils";
 export declare function getMatrixSize(matrix: ReadonlyArray<ReadonlyArray<number>>): number[];
-type ExternalProps = WidgetProps<PerseusMatrixWidgetOptions, PerseusMatrixRubric>;
+type ExternalProps = WidgetProps<{
+    prefix: string;
+    suffix: string;
+    answers: PerseusMatrixWidgetAnswers;
+    cursorPosition: ReadonlyArray<number>;
+    matrixBoardSize: ReadonlyArray<number>;
+    static?: boolean | undefined;
+}, PerseusMatrixRubric>;
 type Props = ExternalProps & {
     onChange: (arg1: {
         cursorPosition?: ReadonlyArray<number>;
@@ -17,9 +24,9 @@ type Props = ExternalProps & {
 type DefaultProps = {
     matrixBoardSize: Props["matrixBoardSize"];
     answers: Props["answers"];
-    prefix: Props["prefix"];
-    suffix: Props["suffix"];
-    cursorPosition: Props["cursorPosition"];
+    prefix: string;
+    suffix: string;
+    cursorPosition: ReadonlyArray<number>;
     apiOptions: Props["apiOptions"];
     linterContext: Props["linterContext"];
 };

package/dist/widgets/measurer/measurer.d.ts

@@ -40,8 +40,8 @@ declare const _default: {
         minor: number;
     };
     propUpgrades: {
-        readonly "1": (v0props: any) => any;
+        readonly "1": (v0props: any) => PerseusMeasurerWidgetOptions;
     };
-    scorer: () => import("../../types").PerseusScore;
+    scorer: () => import("../..").PerseusScore;
 };
 export default _default;

package/dist/widgets/molecule/molecule.d.ts

@@ -19,6 +19,6 @@ declare const _default: {
     displayName: string;
     hidden: true;
     widget: typeof MoleculeWidget;
-    scorer: () => import("../../types").PerseusScore;
+    scorer: () => import("../..").PerseusScore;
 };
 export default _default;

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

@@ -0,0 +1,12 @@
+import type { PerseusScore } from "../../types";
+import type { PerseusOrdererUserInput } from "../../validation.types";
+/**
+ * Checks user input from the orderer widget to see if the user has started
+ * ordering the options, making the widget scorable.
+ * @param userInput
+ * @see `scoreOrderer` for more details.
+ */
+declare function validateOrderer(userInput: PerseusOrdererUserInput): Extract<PerseusScore, {
+    type: "invalid";
+}> | null;
+export default validateOrderer;

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

@@ -13,8 +13,8 @@ export type ParseState = State & {
 };
 declare function getInitialParseState(): ParseState;
 declare const _default: {
-    parse: (arg1: string, arg2?: ParseState | null | undefined) => SingleASTNode[];
-    output: (arg1: SingleASTNode[]) => React.ReactElement<any, string | React.JSXElementConstructor<any>>;
+    parse: (arg1: string, arg2?: ParseState | null | undefined) => Array<SingleASTNode>;
+    output: (arg1: Array<SingleASTNode>) => React.ReactElement;
     START_REF_PREFIX: string;
     END_REF_PREFIX: string;
     getInitialParseState: typeof getInitialParseState;

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

@@ -108,6 +108,6 @@ declare const _default: {
     widget: typeof Passage;
     transform: (editorProps: any) => RenderProps;
     isLintable: true;
-    scorer: () => import("../../types").PerseusScore;
+    scorer: () => import("../..").PerseusScore;
 };
 export default _default;

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

@@ -51,6 +51,6 @@ declare const _default: {
         major: number;
         minor: number;
     };
-    scorer: () => import("../../types").PerseusScore;
+    scorer: () => import("../..").PerseusScore;
 };
 export default _default;

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

@@ -36,6 +36,6 @@ declare const _default: {
         minor: number;
     };
     isLintable: true;
-    scorer: () => import("../../types").PerseusScore;
+    scorer: () => import("../..").PerseusScore;
 };
 export default _default;

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

@@ -3,10 +3,10 @@ import { PerseusI18nContext } from "../../components/i18n-context";
 import scorePlotter from "./score-plotter";
 import type { PerseusPlotterWidgetOptions } from "../../perseus-types";
 import type { Widget, WidgetProps } from "../../types";
-import type { PerseusPlotterRubric, PerseusPlotterUserInput } from "../../validation.types";
+import type { PerseusPlotterScoringData, PerseusPlotterUserInput } from "../../validation.types";
 import type { UnsupportedWidgetPromptJSON } from "../../widget-ai-utils/unsupported-widget";
 type RenderProps = PerseusPlotterWidgetOptions;
-type Props = WidgetProps<RenderProps, PerseusPlotterRubric> & {
+type Props = WidgetProps<RenderProps, PerseusPlotterScoringData> & {
     labelInterval: NonNullable<PerseusPlotterWidgetOptions["labelInterval"]>;
     picSize: NonNullable<PerseusPlotterWidgetOptions["picSize"]>;
 };

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

@@ -1,4 +1,4 @@
 import type { PerseusScore } from "../../types";
-import type { PerseusPlotterRubric, PerseusPlotterUserInput } from "../../validation.types";
-declare function scorePlotter(userInput: PerseusPlotterUserInput, rubric: PerseusPlotterRubric): PerseusScore;
+import type { PerseusPlotterScoringData, PerseusPlotterUserInput } from "../../validation.types";
+declare function scorePlotter(userInput: PerseusPlotterUserInput, scoringData: PerseusPlotterScoringData): PerseusScore;
 export default scorePlotter;

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

@@ -0,0 +1,12 @@
+import type { PerseusScore } from "../../types";
+import type { PerseusPlotterUserInput, PerseusPlotterValidationData } from "../../validation.types";
+/**
+ * Checks user input to confirm it is not the same as the starting values for the graph.
+ * This means the user has modified the graph, and the question can be scored.
+ *
+ * @see 'scorePlotter' for more details on scoring.
+ */
+declare function validatePlotter(userInput: PerseusPlotterUserInput, validationData: PerseusPlotterValidationData): Extract<PerseusScore, {
+    type: "invalid";
+}> | null;
+export default validatePlotter;

package/dist/widgets/radio/choice-icon/shared-styles.d.ts

@@ -1,4 +1,3 @@
-/// <reference path="../../../../types/aphrodite.d.ts" />
 import type { StyleDeclaration } from "aphrodite";
 declare const CHOICE_ICON_SIZE = 24;
 declare const styles: StyleDeclaration;

package/dist/widgets/radio/choice-none-above.d.ts

@@ -1,6 +1,6 @@
 import * as React from "react";
 import type { ChoiceProps } from "./choice";
 declare const _default: React.ForwardRefExoticComponent<ChoiceProps & {
-    showContent?: boolean | undefined;
+    showContent?: boolean;
 } & React.RefAttributes<HTMLButtonElement>>;
 export default _default;

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

@@ -8,14 +8,14 @@ declare const _default: {
     displayName: string;
     accessible: true;
     widget: typeof Radio;
-    transform: (widgetOptions: PerseusRadioWidgetOptions, strings: PerseusStrings, problemNum?: number | null | undefined) => RenderProps;
-    staticTransform: (widgetOptions: PerseusRadioWidgetOptions, strings: PerseusStrings, problemNum?: number | null | undefined) => RenderProps;
+    transform: (widgetOptions: PerseusRadioWidgetOptions, strings: PerseusStrings, problemNum?: number | null) => RenderProps;
+    staticTransform: (widgetOptions: PerseusRadioWidgetOptions, strings: PerseusStrings, problemNum?: number | null) => RenderProps;
     version: {
         major: number;
         minor: number;
     };
     propUpgrades: {
-        readonly "1": (v0props: any) => any;
+        readonly "1": (v0props: any) => PerseusRadioWidgetOptions;
     };
     isLintable: true;
     scorer: typeof scoreRadio;

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

@@ -0,0 +1,14 @@
+import type { PerseusScore } from "../../types";
+import type { PerseusRadioUserInput } from "../../validation.types";
+/**
+ * Checks if the user has selected at least one option. Additional validation
+ * is done in scoreRadio to check if the number of selected options is correct
+ * and if the user has selected both a correct option and the "none of the above"
+ * option.
+ * @param userInput
+ * @see `scoreRadio` for the additional validation logic and the scoring logic.
+ */
+declare function validateRadio(userInput: PerseusRadioUserInput): Extract<PerseusScore, {
+    type: "invalid";
+}> | null;
+export default validateRadio;

package/dist/widgets/sorter/validate-sorter.d.ts

@@ -0,0 +1,13 @@
+import type { PerseusScore } from "../../types";
+import type { PerseusSorterUserInput } from "../../validation.types";
+/**
+ * Checks user input for the sorter widget to ensure that the user has made
+ * changes before attempting to score the widget.
+ * @param userInput
+ * @see 'scoreSorter' in 'packages/perseus/src/widgets/sorter/score-sorter.ts'
+ * for more details on how the sorter widget is scored.
+ */
+declare function validateSorter(userInput: PerseusSorterUserInput): Extract<PerseusScore, {
+    type: "invalid";
+}> | null;
+export default validateSorter;

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

@@ -30,6 +30,6 @@ declare const _default: {
     defaultAlignment: "block";
     supportedAlignments: ("block" | "full-width" | "float-left" | "float-right")[];
     widget: typeof Video;
-    scorer: () => import("../../types").PerseusScore;
+    scorer: () => import("../..").PerseusScore;
 };
 export default _default;

package/package.json

@@ -3,7 +3,7 @@
     "description": "Core Perseus API (includes renderers and widgets)",
     "author": "Khan Academy",
     "license": "MIT",
-    "version": "43.0.1",
+    "version": "44.0.0",
     "publishConfig": {
         "access": "public"
     },
@@ -40,14 +40,14 @@
         "test": "bash -c 'yarn --silent --cwd \"../..\" test ${@:0} $($([[ ${@: -1} = -* ]] || [[ ${@: -1} = bash ]]) && echo $PWD)'"
     },
     "dependencies": {
-        "@khanacademy/kas": "^0.4.1",
+        "@khanacademy/kas": "^0.4.2",
         "@khanacademy/keypad-context": "^1.0.4",
         "@khanacademy/kmath": "^0.1.16",
-        "@khanacademy/math-input": "^21.1.5",
+        "@khanacademy/math-input": "^21.1.6",
         "@khanacademy/perseus-core": "1.5.3",
         "@khanacademy/perseus-linter": "^1.2.4",
-        "@khanacademy/pure-markdown": "^0.3.12",
-        "@khanacademy/simple-markdown": "^0.13.5",
+        "@khanacademy/pure-markdown": "^0.3.13",
+        "@khanacademy/simple-markdown": "^0.13.6",
         "@types/classnames": "2.2.0",
         "@use-gesture/react": "^10.2.27",
         "mafs": "0.19.0",

package/dist/util/parse-perseus-json/general-purpose-parsers/compose-parsers.d.ts

@@ -1,2 +0,0 @@
-import type { ParsedValue, PartialParser, Parser } from "../parser-types";
-export declare function composeParsers<A extends Parser<any>, B extends PartialParser<ParsedValue<A>, any>>(parserA: A, parserB: B): Parser<ParsedValue<B>>;