@khanacademy/perseus 35.1.1 → 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;
@@ -168,16 +168,16 @@ 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[];
+        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;
@@ -187,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;
@@ -253,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>;
@@ -261,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;
@@ -340,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;
@@ -356,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;
@@ -422,16 +422,16 @@ 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[];
+        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;
@@ -441,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;
@@ -507,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>;
@@ -515,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;
@@ -594,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.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/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.d.ts

@@ -8,7 +8,7 @@
  */
 import * as React from "react";
 import type { PerseusIFrameWidgetOptions } from "../../perseus-types";
-import type { PerseusScore, WidgetProps } from "../../types";
+import type { PerseusScore, WidgetProps, Widget } from "../../types";
 import type { PerseusIFrameRubric, PerseusIFrameUserInput, UserInputStatus } from "../../validation.types";
 type RenderProps = PerseusIFrameWidgetOptions & {
     status: UserInputStatus;
@@ -23,7 +23,7 @@ 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;

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;
@@ -105,7 +105,7 @@ 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;

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

@@ -11,7 +11,7 @@ import Marker from "./marker";
 import type { InteractiveMarkerType } from "./types";
 import type { DependencyProps } from "../../dependencies";
 import type { ChangeableProps } from "../../mixins/changeable";
-import type { APIOptions, PerseusScore } from "../../types";
+import type { APIOptions, PerseusScore, Widget } from "../../types";
 import type { PerseusLabelImageRubric, PerseusLabelImageUserInput } from "../../validation.types";
 export type PreferredPopoverDirection = "NONE" | "UP" | "DOWN" | "LEFT" | "RIGHT";
 /**
@@ -50,7 +50,7 @@ type LabelImageState = {
     markersInteracted: boolean;
     hideAnswers: boolean;
 };
-export declare class LabelImage extends React.Component<LabelImageProps, LabelImageState> {
+export declare class LabelImage extends React.Component<LabelImageProps, LabelImageState> implements Widget {
     static contextType: React.Context<{
         strings: import("../../strings").PerseusStrings;
         locale: string;

package/dist/widgets/matcher/matcher.d.ts

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { SortableOption } from "../../components/sortable";
 import type { PerseusMatcherWidgetOptions } from "../../perseus-types";
-import type { PerseusScore, WidgetProps } from "../../types";
+import type { PerseusScore, WidgetProps, Widget } from "../../types";
 import type { PerseusMatcherRubric, PerseusMatcherUserInput } from "../../validation.types";
 type RenderProps = PerseusMatcherWidgetOptions;
 type Props = WidgetProps<RenderProps, PerseusMatcherRubric>;
@@ -21,7 +21,7 @@ type State = {
     rightHeight: number;
     texRendererLoaded: boolean;
 };
-export declare class Matcher extends React.Component<Props, State> {
+export declare class Matcher extends React.Component<Props, State> implements Widget {
     static contextType: React.Context<{
         strings: import("../../strings").PerseusStrings;
         locale: string;

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { PerseusMatrixWidgetOptions } from "../../perseus-types";
 import type { PerseusStrings } from "../../strings";
-import type { WidgetProps, PerseusScore } from "../../types";
+import type { WidgetProps, PerseusScore, Widget, FocusPath } from "../../types";
 import type { PerseusMatrixRubric, PerseusMatrixUserInput } from "../../validation.types";
 export declare function getMatrixSize(matrix: ReadonlyArray<ReadonlyArray<number>>): number[];
 type ExternalProps = WidgetProps<PerseusMatrixWidgetOptions, PerseusMatrixRubric>;
@@ -25,7 +25,7 @@ type DefaultProps = {
 type State = {
     enterTheMatrix: number;
 };
-declare class Matrix extends React.Component<Props, State> {
+declare class Matrix extends React.Component<Props, State> implements Widget {
     static contextType: React.Context<{
         strings: PerseusStrings;
         locale: string;
@@ -43,7 +43,7 @@ declare class Matrix extends React.Component<Props, State> {
     focus: () => boolean;
     focusInputPath: (arg1: any) => void;
     blurInputPath: (arg1: any) => void;
-    getDOMNodeForPath: (arg1: any) => Element | Text | null | undefined;
+    getDOMNodeForPath(path: FocusPath): Element | Text | null;
     setInputValue: (arg1: any, arg2: any, arg3: any) => void;
     handleKeyDown: (arg1: any, arg2: any, arg3: any) => void;
     onValueChange: (arg1: any, arg2: any, arg3: any, arg4: any) => void;

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

@@ -1,8 +1,53 @@
+import * as React from "react";
+import noopValidator from "../__shared__/noop-validator";
+import type { APIOptions, Widget } from "../../types";
+type Props = {
+    apiOptions: APIOptions;
+    box: [number, number];
+    image: {
+        url?: string;
+        top?: number;
+        left?: number;
+    };
+    showProtractor: boolean;
+    protractorX: number;
+    protractorY: number;
+    showRuler: boolean;
+    rulerLabel: string;
+    rulerTicks: number;
+    rulerPixels: number;
+    rulerLength: number;
+};
+type DefaultProps = {
+    box: Props["box"];
+    image: Props["image"];
+    showProtractor: Props["showProtractor"];
+    protractorX: Props["protractorX"];
+    protractorY: Props["protractorY"];
+    showRuler: Props["showRuler"];
+    rulerLabel: Props["rulerLabel"];
+    rulerTicks: Props["rulerTicks"];
+    rulerPixels: Props["rulerPixels"];
+    rulerLength: Props["rulerLength"];
+};
+declare class Measurer extends React.Component<Props> implements Widget {
+    static validate: typeof noopValidator;
+    static defaultProps: DefaultProps;
+    state: {};
+    ruler: any;
+    protractor: any;
+    componentDidMount(): void;
+    componentDidUpdate(prevProps: any): void;
+    setupGraphie(): void;
+    getUserInput(): {};
+    simpleValidate(): import("../../types").PerseusScore;
+    render(): React.JSX.Element;
+}
 declare const _default: Readonly<{
     name: string;
     displayName: string;
-    getWidget?: (() => any) | undefined;
-    widget: any;
+    getWidget?: (() => typeof Measurer) | undefined;
+    widget: typeof Measurer;
     accessible?: boolean | ((props: any) => boolean) | undefined;
     hidden?: boolean | undefined;
     version?: import("../../types").Version | undefined;

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

@@ -1,6 +1,7 @@
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { PerseusMoleculeRendererWidgetOptions } from "../../perseus-types";
+import type { Widget } from "../../types";
 import type { PerseusMoleculeUserInput } from "../../validation.types";
 type MoleculeState = {
     parsedSmiles: any;
@@ -30,7 +31,7 @@ export declare class Molecule extends React.Component<Props, MoleculeState> {
 type DefaultProps = {
     rotationAngle: Props["rotationAngle"];
 };
-declare class MoleculeWidget extends React.Component<Props> {
+declare class MoleculeWidget extends React.Component<Props> implements Widget {
     static defaultProps: DefaultProps;
     simpleValidate(): import("../../types").PerseusScore;
     getUserInput(): PerseusMoleculeUserInput;

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

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { ChangeableProps } from "../../mixins/changeable";
-import type { APIOptions, PerseusScore } from "../../types";
+import type { APIOptions, PerseusScore, FocusPath, Widget } from "../../types";
 import type { PerseusNumberLineRubric, PerseusNumberLineUserInput } from "../../validation.types";
 export type Relationship = "lt" | "gt" | "le" | "ge";
 type Props = ChangeableProps & {
@@ -42,7 +42,7 @@ type DefaultProps = {
 type State = {
     numDivisionsEmpty: boolean;
 };
-declare class NumberLine extends React.Component<Props, State> {
+declare class NumberLine extends React.Component<Props, State> implements Widget {
     static contextType: React.Context<{
         strings: import("../../strings").PerseusStrings;
         locale: string;
@@ -56,12 +56,12 @@ declare class NumberLine extends React.Component<Props, State> {
     onNumDivisionsChange: (arg1: number, arg2: any) => void;
     _handleTickCtrlFocus: () => void;
     _handleTickCtrlBlur: () => void;
-    focus: () => boolean | null | undefined;
+    focus(): boolean;
     focusInputPath: (arg1: any) => void;
     blurInputPath: (arg1: any) => void;
     getInputPaths: () => ReadonlyArray<ReadonlyArray<string>>;
-    getDOMNodeForPath: (arg1: any) => Element | Text | null | undefined;
-    getGrammarTypeForPath: (arg1: any) => string | null | undefined;
+    getDOMNodeForPath(inputPath: FocusPath): Element | Text | null;
+    getGrammarTypeForPath(inputPath: FocusPath): "number" | undefined;
     setInputValue: (arg1: any, arg2: any, arg3: any) => void;
     _renderGraphie: () => React.ReactElement;
     snapNumLinePosition: (arg1: any, arg2: number) => number;

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

@@ -4,7 +4,7 @@ import InputWithExamples from "../../components/input-with-examples";
 import SimpleKeypadInput from "../../components/simple-keypad-input";
 import type { PerseusNumericInputWidgetOptions, PerseusNumericInputAnswerForm } from "../../perseus-types";
 import type { PerseusStrings } from "../../strings";
-import type { FocusPath, PerseusScore, WidgetProps } from "../../types";
+import type { FocusPath, PerseusScore, Widget, WidgetProps } from "../../types";
 import type { PerseusNumericInputRubric, PerseusNumericInputUserInput } from "../../validation.types";
 type ExternalProps = WidgetProps<PerseusNumericInputWidgetOptions, PerseusNumericInputRubric>;
 type Props = ExternalProps & {
@@ -30,7 +30,7 @@ type DefaultProps = {
 type State = {
     previousValues: ReadonlyArray<string>;
 };
-export declare class NumericInput extends React.Component<Props, State> {
+export declare class NumericInput extends React.Component<Props, State> implements Widget {
     static contextType: React.Context<{
         strings: PerseusStrings;
         locale: string;

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

@@ -0,0 +1,3 @@
+import type { PerseusScore } from "../../types";
+import type { PerseusOrdererRubric, PerseusOrdererUserInput } from "../../validation.types";
+export declare function ordererValidator(userInput: PerseusOrdererUserInput, rubric: PerseusOrdererRubric): PerseusScore;