@khanacademy/perseus 35.0.0 → 36.0.0

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

@@ -3,7 +3,7 @@ import { PerseusI18nContext } from "../../components/i18n-context";
 import type { DependenciesContext } from "../../dependencies";
 import type { PerseusExpressionWidgetOptions } from "../../perseus-types";
 import type { PerseusStrings } from "../../strings";
-import type { PerseusScore, WidgetProps } from "../../types";
+import type { FocusPath, PerseusScore, Widget, WidgetProps } from "../../types";
 import type { PerseusExpressionRubric, PerseusExpressionUserInput } from "../../validation.types";
 import type { Keys as Key, KeypadConfiguration } from "@khanacademy/math-input";
 type InputPath = ReadonlyArray<string>;
@@ -44,7 +44,7 @@ type DefaultProps = {
     times: Props["times"];
     value: Props["value"];
 };
-export declare class Expression extends React.Component<Props, ExpressionState> {
+export declare class Expression extends React.Component<Props, ExpressionState> implements Widget {
     static contextType: React.Context<{
         strings: PerseusStrings;
         locale: string;
@@ -72,12 +72,12 @@ export declare class Expression extends React.Component<Props, ExpressionState>
     _handleFocus: () => void;
     _handleBlur: () => void;
     focus: () => boolean;
-    focusInputPath: (inputPath: InputPath) => void;
-    blurInputPath: (inputPath: InputPath) => void;
+    focusInputPath(inputPath: InputPath): void;
+    blurInputPath(inputPath: InputPath): void;
     insert(keyPressed: Key): void;
     getInputPaths: () => ReadonlyArray<ReadonlyArray<any>>;
-    getGrammarTypeForPath: (inputPath: string) => string;
-    setInputValue: (path: string, newValue: string, cb: () => void) => void;
+    getGrammarTypeForPath(inputPath: FocusPath): string;
+    setInputValue(path: FocusPath, newValue: string, cb: () => void): void;
     render(): React.JSX.Element;
 }
 /**
@@ -102,7 +102,7 @@ declare const _default: Readonly<{
         problemNum: number | null | undefined;
         apiOptions: Readonly<Readonly<{
             isArticle?: boolean | undefined;
-            onFocusChange?: ((newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
+            onFocusChange?: ((newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
             GroupMetadataEditor?: React.ComponentType<any> | undefined;
             showAlignmentOptions?: boolean | undefined;
             readOnly?: boolean | undefined;
@@ -147,10 +147,12 @@ declare const _default: Readonly<{
                     "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;
@@ -166,17 +168,17 @@ declare const _default: Readonly<{
             groupAnnotator: (groupNumber: number, widgetId: string) => React.ReactNode;
             isArticle: NonNullable<boolean | undefined>;
             isMobile: NonNullable<boolean | undefined>;
-            onFocusChange: (newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
+            onFocusChange: (newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
             readOnly: NonNullable<boolean | undefined>;
             setDrawingAreaAvailable: (arg1: boolean) => unknown;
             showAlignmentOptions: NonNullable<boolean | undefined>;
         }>;
         keypadElement?: any;
         questionCompleted?: boolean | undefined;
-        onFocus: (blurPath: import("../../types").FocusPath) => void;
-        onBlur: (blurPath: import("../../types").FocusPath) => void;
-        findWidgets: (arg1: import("../../types").FilterCriterion) => readonly any[];
-        reviewModeRubric: PerseusExpressionWidgetOptions;
+        onFocus: (blurPath: FocusPath) => void;
+        onBlur: (blurPath: FocusPath) => void;
+        findWidgets: (criterion: import("../../types").FilterCriterion) => readonly Widget[];
+        reviewModeRubric: PerseusExpressionRubric;
         onChange: import("../../types").ChangeHandler;
         trackInteraction: (extraData?: Empty | undefined) => void;
         isLastUsedWidget: boolean;
@@ -185,7 +187,7 @@ declare const _default: Readonly<{
     } & Partial<import("../../types").PerseusDependenciesV2> & {
         apiOptions: Readonly<Readonly<{
             isArticle?: boolean | undefined;
-            onFocusChange?: ((newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
+            onFocusChange?: ((newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
             GroupMetadataEditor?: React.ComponentType<any> | undefined;
             showAlignmentOptions?: boolean | undefined;
             readOnly?: boolean | undefined;
@@ -230,10 +232,12 @@ declare const _default: Readonly<{
                     "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;
@@ -249,7 +253,7 @@ declare const _default: Readonly<{
             groupAnnotator: (groupNumber: number, widgetId: string) => React.ReactNode;
             isArticle: NonNullable<boolean | undefined>;
             isMobile: NonNullable<boolean | undefined>;
-            onFocusChange: (newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
+            onFocusChange: (newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
             readOnly: NonNullable<boolean | undefined>;
             setDrawingAreaAvailable: (arg1: boolean) => unknown;
             showAlignmentOptions: NonNullable<boolean | undefined>;
@@ -257,20 +261,19 @@ declare const _default: Readonly<{
         buttonSets: import("../../perseus-types").LegacyButtonSets;
         functions: readonly string[];
         linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
-        onBlur: (blurPath: import("../../types").FocusPath) => void;
-        onFocus: (blurPath: import("../../types").FocusPath) => void;
+        onBlur: (blurPath: FocusPath) => void;
+        onFocus: (blurPath: FocusPath) => void;
         times: boolean;
         visibleLabel: string | undefined;
         ariaLabel: string | undefined;
         value: string;
-    }, "ariaLabel" | "trackInteraction" | "static" | "onChange" | "analytics" | "keypadElement" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "alignment" | "buttonsVisible" | "visibleLabel" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
+    }, "ariaLabel" | "static" | "onChange" | "keypadElement" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "trackInteraction" | "analytics" | "alignment" | "buttonsVisible" | "visibleLabel" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
         value?: string | undefined;
-        linterContext?: import("@khanacademy/perseus-linter").LinterContextProps | undefined;
-        onFocus?: ((blurPath: import("../../types").FocusPath) => void) | undefined;
-        onBlur?: ((blurPath: import("../../types").FocusPath) => void) | undefined;
+        onFocus?: ((blurPath: FocusPath) => void) | undefined;
+        onBlur?: ((blurPath: FocusPath) => void) | undefined;
         apiOptions?: Readonly<Readonly<{
             isArticle?: boolean | undefined;
-            onFocusChange?: ((newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
+            onFocusChange?: ((newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
             GroupMetadataEditor?: React.ComponentType<any> | undefined;
             showAlignmentOptions?: boolean | undefined;
             readOnly?: boolean | undefined;
@@ -315,10 +318,12 @@ declare const _default: Readonly<{
                     "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;
@@ -334,11 +339,12 @@ declare const _default: Readonly<{
             groupAnnotator: (groupNumber: number, widgetId: string) => React.ReactNode;
             isArticle: NonNullable<boolean | undefined>;
             isMobile: NonNullable<boolean | undefined>;
-            onFocusChange: (newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
+            onFocusChange: (newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
             readOnly: NonNullable<boolean | undefined>;
             setDrawingAreaAvailable: (arg1: boolean) => unknown;
             showAlignmentOptions: NonNullable<boolean | undefined>;
         }> | undefined;
+        linterContext?: import("@khanacademy/perseus-linter").LinterContextProps | undefined;
         buttonSets?: import("../../perseus-types").LegacyButtonSets | undefined;
         functions?: readonly string[] | undefined;
         times?: boolean | undefined;
@@ -350,7 +356,7 @@ declare const _default: Readonly<{
         problemNum: number | null | undefined;
         apiOptions: Readonly<Readonly<{
             isArticle?: boolean | undefined;
-            onFocusChange?: ((newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
+            onFocusChange?: ((newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
             GroupMetadataEditor?: React.ComponentType<any> | undefined;
             showAlignmentOptions?: boolean | undefined;
             readOnly?: boolean | undefined;
@@ -395,10 +401,12 @@ declare const _default: Readonly<{
                     "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;
@@ -414,17 +422,17 @@ declare const _default: Readonly<{
             groupAnnotator: (groupNumber: number, widgetId: string) => React.ReactNode;
             isArticle: NonNullable<boolean | undefined>;
             isMobile: NonNullable<boolean | undefined>;
-            onFocusChange: (newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
+            onFocusChange: (newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
             readOnly: NonNullable<boolean | undefined>;
             setDrawingAreaAvailable: (arg1: boolean) => unknown;
             showAlignmentOptions: NonNullable<boolean | undefined>;
         }>;
         keypadElement?: any;
         questionCompleted?: boolean | undefined;
-        onFocus: (blurPath: import("../../types").FocusPath) => void;
-        onBlur: (blurPath: import("../../types").FocusPath) => void;
-        findWidgets: (arg1: import("../../types").FilterCriterion) => readonly any[];
-        reviewModeRubric: PerseusExpressionWidgetOptions;
+        onFocus: (blurPath: FocusPath) => void;
+        onBlur: (blurPath: FocusPath) => void;
+        findWidgets: (criterion: import("../../types").FilterCriterion) => readonly Widget[];
+        reviewModeRubric: PerseusExpressionRubric;
         onChange: import("../../types").ChangeHandler;
         trackInteraction: (extraData?: Empty | undefined) => void;
         isLastUsedWidget: boolean;
@@ -433,7 +441,7 @@ declare const _default: Readonly<{
     } & Partial<import("../../types").PerseusDependenciesV2> & {
         apiOptions: Readonly<Readonly<{
             isArticle?: boolean | undefined;
-            onFocusChange?: ((newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
+            onFocusChange?: ((newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
             GroupMetadataEditor?: React.ComponentType<any> | undefined;
             showAlignmentOptions?: boolean | undefined;
             readOnly?: boolean | undefined;
@@ -478,10 +486,12 @@ declare const _default: Readonly<{
                     "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;
@@ -497,7 +507,7 @@ declare const _default: Readonly<{
             groupAnnotator: (groupNumber: number, widgetId: string) => React.ReactNode;
             isArticle: NonNullable<boolean | undefined>;
             isMobile: NonNullable<boolean | undefined>;
-            onFocusChange: (newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
+            onFocusChange: (newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
             readOnly: NonNullable<boolean | undefined>;
             setDrawingAreaAvailable: (arg1: boolean) => unknown;
             showAlignmentOptions: NonNullable<boolean | undefined>;
@@ -505,20 +515,19 @@ declare const _default: Readonly<{
         buttonSets: import("../../perseus-types").LegacyButtonSets;
         functions: readonly string[];
         linterContext: import("@khanacademy/perseus-linter").LinterContextProps;
-        onBlur: (blurPath: import("../../types").FocusPath) => void;
-        onFocus: (blurPath: import("../../types").FocusPath) => void;
+        onBlur: (blurPath: FocusPath) => void;
+        onFocus: (blurPath: FocusPath) => void;
         times: boolean;
         visibleLabel: string | undefined;
         ariaLabel: string | undefined;
         value: string;
-    }, "ariaLabel" | "trackInteraction" | "static" | "onChange" | "analytics" | "keypadElement" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "alignment" | "buttonsVisible" | "visibleLabel" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
+    }, "ariaLabel" | "static" | "onChange" | "keypadElement" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "trackInteraction" | "analytics" | "alignment" | "buttonsVisible" | "visibleLabel" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
         value?: string | undefined;
-        linterContext?: import("@khanacademy/perseus-linter").LinterContextProps | undefined;
-        onFocus?: ((blurPath: import("../../types").FocusPath) => void) | undefined;
-        onBlur?: ((blurPath: import("../../types").FocusPath) => void) | undefined;
+        onFocus?: ((blurPath: FocusPath) => void) | undefined;
+        onBlur?: ((blurPath: FocusPath) => void) | undefined;
         apiOptions?: Readonly<Readonly<{
             isArticle?: boolean | undefined;
-            onFocusChange?: ((newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
+            onFocusChange?: ((newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown) | undefined;
             GroupMetadataEditor?: React.ComponentType<any> | undefined;
             showAlignmentOptions?: boolean | undefined;
             readOnly?: boolean | undefined;
@@ -563,10 +572,12 @@ declare const _default: Readonly<{
                     "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;
@@ -582,11 +593,12 @@ declare const _default: Readonly<{
             groupAnnotator: (groupNumber: number, widgetId: string) => React.ReactNode;
             isArticle: NonNullable<boolean | undefined>;
             isMobile: NonNullable<boolean | undefined>;
-            onFocusChange: (newFocusPath: import("../../types").FocusPath, oldFocusPath: import("../../types").FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
+            onFocusChange: (newFocusPath: FocusPath, oldFocusPath: FocusPath, keypadHeight?: number | undefined, focusedElement?: HTMLElement | undefined) => unknown;
             readOnly: NonNullable<boolean | undefined>;
             setDrawingAreaAvailable: (arg1: boolean) => unknown;
             showAlignmentOptions: NonNullable<boolean | undefined>;
         }> | undefined;
+        linterContext?: import("@khanacademy/perseus-linter").LinterContextProps | undefined;
         buttonSets?: import("../../perseus-types").LegacyButtonSets | undefined;
         functions?: readonly string[] | undefined;
         times?: boolean | undefined;

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { ANSWER_BAR_STATES } from "./graded-group-answer-bar";
 import type { PerseusGradedGroupWidgetOptions } from "../../perseus-types";
-import type { TrackingGradedGroupExtraArguments, WidgetProps } from "../../types";
+import type { TrackingGradedGroupExtraArguments, Widget, WidgetProps } from "../../types";
 import type { PerseusGradedGroupRubric } from "../../validation.types";
 declare const GRADING_STATUSES: {
     readonly ungraded: "ungraded";
@@ -30,7 +30,7 @@ type State = {
     message: string;
     answerBarState: ANSWER_BAR_STATES;
 };
-export declare class GradedGroup extends React.Component<Props, State> {
+export declare class GradedGroup extends React.Component<Props, State> implements Widget {
     static contextType: React.Context<{
         strings: import("../../strings").PerseusStrings;
         locale: string;

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import * as Changeable from "../../mixins/changeable";
 import { GradedGroup } from "../graded-group/graded-group";
 import type { PerseusGradedGroupSetWidgetOptions } from "../../perseus-types";
-import type { FocusPath, WidgetProps } from "../../types";
+import type { FocusPath, Widget, WidgetProps } from "../../types";
 import type { PerseusGradedGroupSetRubric } from "../../validation.types";
 type RenderProps = PerseusGradedGroupSetWidgetOptions;
 type Props = Changeable.ChangeableProps & WidgetProps<RenderProps, PerseusGradedGroupSetRubric> & {
@@ -15,7 +15,7 @@ type DefaultProps = {
 type State = {
     currentGroup: number;
 };
-declare class GradedGroupSet extends React.Component<Props, State> {
+declare class GradedGroupSet extends React.Component<Props, State> implements Widget {
     _childGroup: GradedGroup;
     static defaultProps: DefaultProps;
     state: State;

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

@@ -0,0 +1,4 @@
+import type { PerseusScore } from "../../types";
+import type { PerseusGrapherRubric, PerseusGrapherUserInput } from "../../validation.types";
+declare function grapherValidator(state: PerseusGrapherUserInput, rubric: PerseusGrapherRubric): PerseusScore;
+export default grapherValidator;

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import Graphie from "../../components/graphie";
 import type { Coord } from "../../interactive2/types";
 import type { PerseusGrapherWidgetOptions } from "../../perseus-types";
-import type { PerseusScore, WidgetProps } from "../../types";
+import type { PerseusScore, Widget, WidgetProps } from "../../types";
 import type { GridDimensions } from "../../util";
 import type { PerseusGrapherRubric, PerseusGrapherUserInput } from "../../validation.types";
 import type { PropsFor } from "@khanacademy/wonder-blocks-core";
@@ -19,7 +19,7 @@ type Props = ExternalProps & {
 type DefaultProps = {
     plot: RenderProps["plot"];
 };
-declare class Grapher extends React.Component<Props> {
+declare class Grapher extends React.Component<Props> implements Widget {
     horizHairline: any;
     vertHairline: any;
     static defaultProps: DefaultProps;
@@ -37,7 +37,6 @@ declare class Grapher extends React.Component<Props> {
     hideHairlines: () => void;
     simpleValidate(rubric: PerseusGrapherRubric): PerseusScore;
     getUserInput(): PerseusGrapherUserInput;
-    focus(): void;
     render(): React.ReactNode;
 }
 declare const _default: Readonly<{

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

@@ -1,11 +1,9 @@
 import type { Coord } from "../../interactive2/types";
-import type { PerseusScore } from "../../types";
 export declare const DEFAULT_BACKGROUND_IMAGE: {
     readonly url: null;
 };
 export declare const allTypes: any;
 export declare function functionForType(type: string): any;
-export declare const validate: (state: any, rubric: any) => PerseusScore;
 export declare const getEquationString: (props: any) => string;
 export declare const pointsFromNormalized: (coordsList: ReadonlyArray<Coord>, range: [Coord, Coord], step: [number, number], snapStep: [number, number]) => ReadonlyArray<Coord>;
 export declare const maybePointsFromNormalized: (coordsList: ReadonlyArray<Coord> | null | undefined, range: [Coord, Coord], step: [number, number], snapStep: [number, number]) => ReadonlyArray<Coord> | null | undefined;

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import Renderer from "../../renderer";
 import type { PerseusGroupWidgetOptions } from "../../perseus-types";
-import type { ChangeFn, FocusPath, PerseusScore, WidgetProps } from "../../types";
+import type { ChangeFn, FocusPath, Widget, WidgetProps } from "../../types";
 import type { UserInput } from "../../validation.types";
 type Rubric = PerseusGroupWidgetOptions;
 type RenderProps = PerseusGroupWidgetOptions;
@@ -13,7 +13,7 @@ type DefaultProps = {
     images: Props["images"];
     linterContext: Props["linterContext"];
 };
-declare class Group extends React.Component<Props> {
+declare class Group extends React.Component<Props> implements Widget {
     static contextType: React.Context<{
         strings: import("../../strings").PerseusStrings;
         locale: string;
@@ -26,10 +26,10 @@ declare class Group extends React.Component<Props> {
     getUserInput(): ReadonlyArray<UserInput | null | undefined> | undefined;
     getSerializedState: () => any;
     restoreSerializedState: (arg1: any, arg2: any) => null;
-    simpleValidate(): PerseusScore | null | undefined;
-    getInputPaths: () => ReadonlyArray<FocusPath> | null | undefined;
+    simpleValidate(): import("../../types").PerseusScore;
+    getInputPaths(): readonly FocusPath[];
     setInputValue: (arg1: FocusPath, arg2: string, arg3: () => unknown) => void;
-    focus: () => boolean | null | undefined;
+    focus(): boolean;
     focusInputPath: (arg1: FocusPath) => void;
     blurInputPath: (arg1: FocusPath) => void;
     showRationalesForCurrentlySelectedChoices: () => void;

package/dist/widgets/iframe/iframe-validator.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusScore } from "../../types";
+import type { PerseusIFrameUserInput } from "../../validation.types";
+export declare function iframeValidator(state: PerseusIFrameUserInput): PerseusScore;

package/dist/widgets/iframe/iframe.d.ts

@@ -8,7 +8,7 @@
  */
 import * as React from "react";
 import type { PerseusIFrameWidgetOptions } from "../../perseus-types";
-import type { WidgetProps } from "../../types";
+import type { PerseusScore, WidgetProps, Widget } from "../../types";
 import type { PerseusIFrameRubric, PerseusIFrameUserInput, UserInputStatus } from "../../validation.types";
 type RenderProps = PerseusIFrameWidgetOptions & {
     status: UserInputStatus;
@@ -23,14 +23,15 @@ type DefaultProps = {
     allowFullScreen: Props["allowFullScreen"];
     allowTopNavigation: Props["allowTopNavigation"];
 };
-declare class Iframe extends React.Component<Props> {
+declare class Iframe extends React.Component<Props> implements Widget {
     static defaultProps: DefaultProps;
+    static validate(state: PerseusIFrameUserInput): PerseusScore;
     componentDidMount(): void;
     componentWillUnmount(): void;
     getUserInput(): PerseusIFrameUserInput;
     handleMessageEvent: (arg1: any) => void;
     change: (...args: ReadonlyArray<unknown>) => any;
-    simpleValidate: (arg1: any) => any;
+    simpleValidate(): PerseusScore;
     render(): React.ReactNode;
 }
 declare const _default: Readonly<{

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

@@ -1,8 +1,8 @@
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { PerseusImageWidgetOptions } from "../../perseus-types";
-import type { ChangeFn, WidgetProps } from "../../types";
-import type { PerseusImageRubric, PerseusImageUserInput } from "../../validation.types";
+import type { ChangeFn, WidgetProps, Widget } from "../../types";
+import type { NullUserInput, PerseusImageRubric } from "../../validation.types";
 type RenderProps = PerseusImageWidgetOptions;
 type ExternalProps = WidgetProps<RenderProps, PerseusImageRubric>;
 type Props = ExternalProps & {
@@ -27,7 +27,7 @@ type DefaultProps = {
     caption: Props["caption"];
     linterContext: Props["linterContext"];
 };
-declare class ImageWidget extends React.Component<Props> {
+declare class ImageWidget extends React.Component<Props> implements Widget {
     static contextType: React.Context<{
         strings: import("../../strings").PerseusStrings;
         locale: string;
@@ -36,9 +36,8 @@ declare class ImageWidget extends React.Component<Props> {
     static defaultProps: DefaultProps;
     static validate(): import("../../types").PerseusScore;
     change: ChangeFn;
-    getUserInput(): PerseusImageUserInput;
+    getUserInput(): NullUserInput;
     simpleValidate(): import("../../types").PerseusScore;
-    focus: () => void;
     render(): React.ReactNode;
 }
 declare const _default: Readonly<{

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { PerseusInputNumberWidgetOptions } from "../../perseus-types";
 import type { PerseusStrings } from "../../strings";
-import type { Path, PerseusScore, WidgetProps } from "../../types";
+import type { Path, PerseusScore, Widget, WidgetProps } from "../../types";
 import type { PerseusInputNumberRubric, PerseusInputNumberUserInput } from "../../validation.types";
 type RenderProps = {
     simplify: PerseusInputNumberWidgetOptions["simplify"];
@@ -27,7 +27,7 @@ type DefaultProps = {
     rightAlign: Props["rightAlign"];
     size: Props["size"];
 };
-declare class InputNumber extends React.Component<Props> {
+declare class InputNumber extends React.Component<Props> implements Widget {
     static contextType: React.Context<{
         strings: PerseusStrings;
         locale: string;

package/dist/widgets/interaction/interaction.d.ts

@@ -1,8 +1,8 @@
 import * as React from "react";
 import type { Coord } from "../../interactive2/types";
 import type { PerseusInteractionWidgetOptions } from "../../perseus-types";
-import type { WidgetProps } from "../../types";
-import type { PerseusInteractionRubric, PerseusInteractionUserInput } from "../../validation.types";
+import type { Widget, WidgetProps } from "../../types";
+import type { EmptyUserInput, PerseusInteractionRubric } from "../../validation.types";
 type RenderProps = PerseusInteractionWidgetOptions;
 type Props = WidgetProps<RenderProps, PerseusInteractionRubric>;
 type DefaultProps = {
@@ -13,7 +13,7 @@ type State = {
     variables: any;
     functions: any;
 };
-declare class Interaction extends React.Component<Props, State> {
+declare class Interaction extends React.Component<Props, State> implements Widget {
     static defaultProps: DefaultProps;
     static validate(): import("../../types").PerseusScore;
     state: State;
@@ -24,7 +24,7 @@ declare class Interaction extends React.Component<Props, State> {
     _eval: (arg1: any, arg2: any) => number;
     _extractVars: (arg1: any) => ReadonlyArray<any>;
     change: (arg1: any, arg2: any, arg3: any) => any;
-    getUserInput(): PerseusInteractionUserInput;
+    getUserInput(): EmptyUserInput;
     simpleValidate(): import("../../types").PerseusScore;
     render(): React.ReactNode;
 }

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

@@ -4,7 +4,7 @@ import type { StatefulMafsGraphType } from "./interactive-graphs/stateful-mafs-g
 import type { QuadraticGraphState } from "./interactive-graphs/types";
 import type { Coord } from "../interactive2/types";
 import type { PerseusGraphType, PerseusGraphTypeAngle, PerseusGraphTypePoint, PerseusGraphTypePolygon, PerseusGraphTypeSegment, PerseusInteractiveGraphWidgetOptions } from "../perseus-types";
-import type { ChangeHandler, PerseusScore, WidgetProps } from "../types";
+import type { ChangeHandler, PerseusScore, Widget, WidgetProps } from "../types";
 import type { QuadraticCoefficient, Range, SineCoefficient } from "../util/geometry";
 import type { PerseusInteractiveGraphRubric, PerseusInteractiveGraphUserInput } from "../validation.types";
 type RenderProps = PerseusInteractiveGraphWidgetOptions;
@@ -20,6 +20,8 @@ type DefaultProps = {
     showProtractor: Props["showProtractor"];
     graph: Props["graph"];
 };
+export declare function getSinusoidCoefficients(coords: ReadonlyArray<Coord>): SineCoefficient;
+export declare function getQuadraticCoefficients(coords: ReadonlyArray<Coord>): QuadraticCoefficient;
 declare class LegacyInteractiveGraph extends React.Component<Props, State> {
     static contextType: React.Context<{
         strings: import("../strings").PerseusStrings;
@@ -103,15 +105,13 @@ declare class LegacyInteractiveGraph extends React.Component<Props, State> {
     focus: () => void;
     render(): React.ReactNode;
 }
-declare class InteractiveGraph extends React.Component<Props, State> {
+declare class InteractiveGraph extends React.Component<Props, State> implements Widget {
     legacyGraphRef: React.RefObject<LegacyInteractiveGraph>;
     mafsRef: React.RefObject<StatefulMafsGraphType>;
     static defaultProps: DefaultProps;
     getUserInput(): PerseusInteractiveGraphUserInput;
     simpleValidate(rubric: PerseusInteractiveGraphRubric): PerseusScore;
     render(): React.JSX.Element;
-    static getQuadraticCoefficients(coords: ReadonlyArray<Coord>): QuadraticCoefficient;
-    static getSinusoidCoefficients(coords: ReadonlyArray<Coord>): SineCoefficient;
     /**
      * @param {object} graph Like props.graph or props.correct
      * @param {object} props of an InteractiveGraph instance
@@ -160,7 +160,7 @@ declare class InteractiveGraph extends React.Component<Props, State> {
     static getRayEquationString(props: Props): string;
     static getPolygonEquationString(props: Props): string;
     static getAngleEquationString(props: Props): string;
-    static validate(userInput: PerseusGraphType, rubric: PerseusInteractiveGraphRubric, component: any): PerseusScore;
+    static validate(userInput: PerseusGraphType, rubric: PerseusInteractiveGraphRubric): PerseusScore;
     static getUserInputFromProps(props: Props): PerseusGraphType;
 }
 export declare function shouldUseMafs(mafsFlags: Record<string, boolean> | undefined | boolean, graph: PerseusGraphType): boolean;

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

@@ -1,5 +1,5 @@
 import * as React from "react";
 import type { Interval } from "mafs";
-export declare const shouldShowLabel: (number: number, range: [Interval, Interval]) => boolean;
+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 AxisTicks: () => React.JSX.Element;

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

@@ -1,7 +1,9 @@
 import * as React from "react";
 import type { LockedFigure } from "../../perseus-types";
+import type { APIOptions } from "../../types";
 import type { Interval } from "mafs";
 type Props = {
+    flags?: APIOptions["flags"];
     lockedFigures: ReadonlyArray<LockedFigure>;
     range: [x: Interval, y: Interval];
 };

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

@@ -8,6 +8,7 @@ export type LockedFunctionOptions = {
     directionalAxis?: "x" | "y";
     domain?: Interval;
     labels?: LockedFigureLabelOptions[];
+    ariaLabel?: string;
 };
 type LockedFigureLabelOptions = {
     text: string;
@@ -111,6 +112,7 @@ declare class InteractiveGraphQuestionBuilder {
         color?: LockedFigureColor;
         filled?: boolean;
         labels?: LockedFigureLabelOptions[];
+        ariaLabel?: string;
     }): InteractiveGraphQuestionBuilder;
     addLockedLine(point1: vec.Vector2, point2: vec.Vector2, options?: {
         kind?: "line" | "ray" | "segment";
@@ -120,10 +122,12 @@ declare class InteractiveGraphQuestionBuilder {
         showPoint1?: boolean;
         showPoint2?: boolean;
         labels?: LockedFigureLabelOptions[];
+        ariaLabel?: string;
     }): InteractiveGraphQuestionBuilder;
     addLockedVector(tail: vec.Vector2, tip: vec.Vector2, options?: {
         color?: LockedFigureColor;
         labels?: LockedFigureLabelOptions[];
+        ariaLabel?: string;
     }): InteractiveGraphQuestionBuilder;
     addLockedEllipse(center: vec.Vector2, radius: [x: number, y: number], options?: {
         angle?: number;
@@ -131,12 +135,15 @@ declare class InteractiveGraphQuestionBuilder {
         fillStyle?: LockedFigureFillType;
         strokeStyle?: "solid" | "dashed";
         labels?: LockedFigureLabelOptions[];
+        ariaLabel?: string;
     }): InteractiveGraphQuestionBuilder;
     addLockedPolygon(points: vec.Vector2[], options?: {
         color?: LockedFigureColor;
         showVertices?: boolean;
         fillStyle?: LockedFigureFillType;
         strokeStyle?: "solid" | "dashed";
+        labels?: LockedFigureLabelOptions[];
+        ariaLabel?: string;
     }): InteractiveGraphQuestionBuilder;
     addLockedFunction(equation: string, options?: LockedFunctionOptions): this;
     addLockedLabel(text: string, coord: Coord, options?: {