@khanacademy/perseus 36.1.2 → 37.0.0

package/dist/renderer-util.d.ts

@@ -0,0 +1,8 @@
+import type { PerseusWidgetsMap } from "./perseus-types";
+import type { PerseusStrings } from "./strings";
+import type { PerseusScore } from "./types";
+import type { UserInputMap } from "./validation.types";
+export declare function emptyWidgetsFunctional(widgets: PerseusWidgetsMap, widgetIds: Array<string>, userInputMap: UserInputMap, strings: PerseusStrings, locale: string): ReadonlyArray<string>;
+export declare function scoreWidgetsFunctional(widgets: PerseusWidgetsMap, widgetIds: Array<string>, userInputMap: UserInputMap, strings: PerseusStrings, locale: string): {
+    [widgetId: string]: PerseusScore;
+};

package/dist/renderer.d.ts

@@ -1,4 +1,5 @@
 import * as React from "react";
+import { PerseusI18nContext } from "./components/i18n-context";
 import InteractionTracker from "./interaction-tracker";
 import TranslationLinter from "./translation-linter";
 import WidgetContainer from "./widget-container";
@@ -6,7 +7,7 @@ import type { DependenciesContext } from "./dependencies";
 import type { PerseusRenderer, PerseusWidget, PerseusWidgetOptions, PerseusWidgetsMap, ShowSolutions } from "./perseus-types";
 import type { PerseusStrings } from "./strings";
 import type { APIOptions, APIOptionsWithDefaults, FilterCriterion, FocusPath, PerseusScore, SerializedState, Widget, WidgetProps } from "./types";
-import type { UserInput } from "./validation.types";
+import type { UserInputArray, UserInputMap } from "./validation.types";
 import type { KeypadAPI } from "@khanacademy/math-input";
 import type { LinterContextProps } from "@khanacademy/perseus-linter";
 import "./styles/perseus-renderer.less";
@@ -61,9 +62,7 @@ type Props = Partial<React.ContextType<typeof DependenciesContext>> & {
 };
 type State = {
     translationLintErrors: ReadonlyArray<string>;
-    widgetInfo: Readonly<{
-        [id: string]: PerseusWidget | null | undefined;
-    }>;
+    widgetInfo: Readonly<PerseusWidgetsMap>;
     widgetProps: Readonly<{
         [id: string]: any | null | undefined;
     }>;
@@ -72,6 +71,11 @@ type State = {
 };
 type DefaultProps = Required<Pick<Props, "alwaysUpdate" | "content" | "findExternalWidgets" | "highlightedWidgets" | "images" | "linterContext" | "onInteractWithWidget" | "onRender" | "onSerializedStateUpdated" | "questionCompleted" | "showSolutions" | "reviewMode" | "serializedState" | "widgets">>;
 declare class Renderer extends React.Component<Props, State> {
+    static contextType: React.Context<{
+        strings: PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
     _currentFocus: FocusPath | null | undefined;
     _foundTextNodes: boolean;
     _interactionTrackers: {
@@ -189,42 +193,37 @@ declare class Renderer extends React.Component<Props, State> {
     blurPath: (path: FocusPath) => void;
     blur: () => void;
     serialize: () => Record<any, any>;
-    emptyWidgets: () => any;
+    emptyWidgets(): ReadonlyArray<string>;
     _setWidgetProps: SetWidgetPropsFn;
     setInputValue: (path: FocusPath, newValue: string, focus?: () => unknown) => void;
     /**
      * Returns an array of the widget `.getUserInput()` results
+     *
+     * TODO: can we remove this?
+     * @deprecated use getUserInputMap
+     */
+    getUserInput(): UserInputArray;
+    /**
+     * Returns an object of the widget `.getUserInput()` results
      */
-    getUserInput: () => ReadonlyArray<UserInput | null | undefined>;
+    getUserInputMap(): UserInputMap;
     /**
      * Returns an array of all widget IDs in the order they occur in
      * the content.
      */
     getWidgetIds: () => ReadonlyArray<string>;
-    /**
-     * Returns the result of `.getUserInput()` for each widget, in
-     * a map from widgetId to userInput.
-     * NOTE(jeremy): This function is hauntingly similar to `getUserInput` with
-     * the major difference being that this function returns a map of
-     * `widgetID` => UserInput and `getUserInput` simply returns an array. It
-     * would be trivial to map between the results of each of these functions,
-     * so we should aim to remove one of these functions.
-     */
-    getUserInputForWidgets: () => {
-        [widgetId: string]: UserInput | null | undefined;
-    };
     /**
      * Returns an object mapping from widget ID to perseus-style score.
      * The keys of this object are the values of the array returned
      * from `getWidgetIds`.
      */
-    scoreWidgets: () => {
+    scoreWidgets(): {
         [widgetId: string]: PerseusScore;
     };
     /**
      * Grades the content.
      */
-    score: () => PerseusScore;
+    score(): PerseusScore;
     guessAndScore: () => [any, PerseusScore];
     examples: () => ReadonlyArray<string> | null | undefined;
     handletranslationLintErrors: (lintErrors: ReadonlyArray<string>) => void;

package/dist/server-item-renderer.d.ts

@@ -118,7 +118,9 @@ declare const ref: React.ForwardRefExoticComponent<Omit<Pick<SharedRendererProps
             id: string;
             correct?: boolean | undefined;
         } & Partial<import("./types").TrackingGradedGroupExtraArguments> & Partial<import("./types").TrackingSequenceExtraArguments>) => void) | undefined;
-        customKeypad?: boolean | undefined;
+        customKeypad?: boolean | undefined; /**
+         * Get a representation of the current state of the item.
+         */
         nativeKeypadProxy?: ((blur: () => void) => KeypadAPI) | undefined;
         isMobile?: boolean | undefined;
         setDrawingAreaAvailable?: ((arg1: boolean) => unknown) | undefined;

package/dist/types.d.ts

@@ -3,7 +3,7 @@ import type { Item } from "./multi-items/item-types";
 import type { Hint, PerseusAnswerArea, PerseusGraphType, PerseusWidget, PerseusWidgetsMap } from "./perseus-types";
 import type { PerseusStrings } from "./strings";
 import type { SizeClass } from "./util/sizing-utils";
-import type { UserInput } from "./validation.types";
+import type { Rubric, UserInput, UserInputArray, UserInputMap } from "./validation.types";
 import type { KeypadAPI } from "@khanacademy/math-input";
 import type { AnalyticsEventHandlerFn } from "@khanacademy/perseus-core";
 import type { LinterContextProps } from "@khanacademy/perseus-linter";
@@ -33,6 +33,12 @@ export type SerializedState = Record<string, any>;
  * scoring, state serialization/deserialization, and focus management.
  */
 export interface Widget {
+    /**
+     * don't use isWidget; it's just a dummy property to help TypeScript's weak
+     * typing to recognize non-interactive widgets as Widgets
+     * @deprecated
+     */
+    isWidget?: true;
     focus?: () => {
         id: string;
         path: FocusPath;
@@ -46,8 +52,8 @@ export interface Widget {
     focusInputPath?: (path: FocusPath) => void;
     getInputPaths?: () => ReadonlyArray<FocusPath>;
     setInputValue?: (path: FocusPath, newValue: string, focus?: () => unknown) => void;
-    getUserInput?: () => UserInput | null | undefined;
-    simpleValidate?: (options?: any, onOutputError?: (widgetId: any, value: string, message?: string | null | undefined) => unknown | null | undefined) => PerseusScore;
+    getUserInputMap?: () => UserInputMap | undefined;
+    getUserInput?: () => UserInputArray | UserInput | undefined;
     showRationalesForCurrentlySelectedChoices?: (options?: any) => void;
     examples?: () => ReadonlyArray<string>;
 }
@@ -352,6 +358,7 @@ export type TrackingSequenceExtraArguments = {
 export type Alignment = "default" | "block" | "inline-block" | "inline" | "float-left" | "float-right" | "full-width";
 type WidgetOptions = any;
 export type WidgetTransform = (arg1: WidgetOptions, strings: PerseusStrings, problemNumber?: number) => any;
+export type WidgetValidatorFunction = (userInput: UserInput, rubric: Rubric, string?: PerseusStrings, locale?: string) => PerseusScore;
 export type WidgetExports<T extends React.ComponentType<any> & Widget = React.ComponentType<any>> = Readonly<{
     name: string;
     displayName: string;
@@ -379,6 +386,7 @@ export type WidgetExports<T extends React.ComponentType<any> & Widget = React.Co
     /** transforms the widget options to the props used to render the widget for
     static renders  */
     staticTransform?: WidgetTransform;
+    validator?: WidgetValidatorFunction;
     /**
     A map of major version numbers (as a string, eg "1") to a function that
     migrates from the _previous_ major version.

package/dist/util.d.ts

@@ -47,6 +47,9 @@ declare function shuffle<T>(array: ReadonlyArray<T>, randomSeed: number | RNG, e
  * if one is wrong, the total score is wrong, etc.
  */
 declare function combineScores(scoreA: PerseusScore, scoreB: PerseusScore): PerseusScore;
+declare function flattenScores(widgetScoreMap: {
+    [widgetId: string]: PerseusScore;
+}): PerseusScore;
 export declare function isCorrect(score: PerseusScore): boolean;
 declare function keScoreFromPerseusScore(score: PerseusScore, guess: any, state: any): KEScore;
 /**
@@ -203,6 +206,7 @@ declare const Util: {
     readonly shuffle: typeof shuffle;
     readonly split: (str: string, r: RegExp) => ReadonlyArray<string>;
     readonly combineScores: typeof combineScores;
+    readonly flattenScores: typeof flattenScores;
     readonly keScoreFromPerseusScore: typeof keScoreFromPerseusScore;
     readonly firstNumericalParse: typeof firstNumericalParse;
     readonly stringArrayOfSize: typeof stringArrayOfSize;

package/dist/validation.types.d.ts

@@ -1,10 +1,8 @@
 import type { Coord } from "./interactive2/types";
-import type { PerseusDefinitionWidgetOptions, PerseusDropdownWidgetOptions, PerseusExplanationWidgetOptions, PerseusExpressionAnswerForm, PerseusGradedGroupSetWidgetOptions, PerseusGradedGroupWidgetOptions, PerseusGrapherWidgetOptions, PerseusGraphType, PerseusIFrameWidgetOptions, PerseusImageWidgetOptions, PerseusInputNumberWidgetOptions, PerseusInteractionWidgetOptions, PerseusLabelImageWidgetOptions, PerseusMatcherWidgetOptions, PerseusMatrixWidgetOptions, PerseusNumberLineWidgetOptions, PerseusNumericInputWidgetOptions, PerseusOrdererWidgetOptions, PerseusPassageRefWidgetOptions, PerseusPassageWidgetOptions, PerseusPlotterWidgetOptions, PerseusRadioWidgetOptions, PerseusSorterWidgetOptions, PerseusTableWidgetOptions, PerseusVideoWidgetOptions } from "./perseus-types";
+import type { PerseusDefinitionWidgetOptions, PerseusDropdownChoice, PerseusExplanationWidgetOptions, PerseusExpressionAnswerForm, PerseusGradedGroupSetWidgetOptions, PerseusGradedGroupWidgetOptions, PerseusGrapherWidgetOptions, PerseusGraphType, PerseusGroupWidgetOptions, PerseusIFrameWidgetOptions, PerseusImageWidgetOptions, PerseusInputNumberWidgetOptions, PerseusInteractionWidgetOptions, PerseusLabelImageWidgetOptions, PerseusMatcherWidgetOptions, PerseusMatrixWidgetOptions, PerseusNumberLineWidgetOptions, PerseusNumericInputWidgetOptions, PerseusOrdererWidgetOptions, PerseusPassageRefWidgetOptions, PerseusPassageWidgetOptions, PerseusPlotterWidgetOptions, PerseusRadioWidgetOptions, PerseusSorterWidgetOptions, PerseusTableWidgetOptions, PerseusVideoWidgetOptions } from "./perseus-types";
 import type { InteractiveMarkerType } from "./widgets/label-image/types";
 import type { Relationship } from "./widgets/number-line/number-line";
 export type UserInputStatus = "correct" | "incorrect" | "incomplete";
-export type EmptyUserInput = Empty;
-export type NullUserInput = null;
 export type PerseusCategorizerRubric = {
     values: ReadonlyArray<number>;
 };
@@ -17,7 +15,9 @@ export type PerseusCSProgramUserInput = {
     message: string | null;
 };
 export type PerseusDefinitionRubric = PerseusDefinitionWidgetOptions;
-export type PerseusDropdownRubric = PerseusDropdownWidgetOptions;
+export type PerseusDropdownRubric = {
+    choices: ReadonlyArray<PerseusDropdownChoice>;
+};
 export type PerseusDropdownUserInput = {
     value: number;
 };
@@ -27,6 +27,7 @@ export type PerseusExpressionRubric = {
     functions: ReadonlyArray<string>;
 };
 export type PerseusExpressionUserInput = string;
+export type PerseusGroupRubric = PerseusGroupWidgetOptions;
 export type PerseusGradedGroupRubric = PerseusGradedGroupWidgetOptions;
 export type PerseusGradedGroupSetRubric = PerseusGradedGroupSetWidgetOptions;
 export type PerseusGrapherRubric = PerseusGrapherWidgetOptions;
@@ -68,7 +69,6 @@ export type PerseusMatrixRubric = PerseusMatrixWidgetOptions;
 export type PerseusMatrixUserInput = {
     answers: ReadonlyArray<ReadonlyArray<number>>;
 };
-export type PerseusMoleculeUserInput = ReadonlyArray<ReadonlyArray<string>>;
 export type PerseusNumberLineRubric = PerseusNumberLineWidgetOptions & {
     isInequality: boolean;
 };
@@ -107,4 +107,12 @@ export type PerseusSorterUserInput = {
 export type PerseusTableRubric = PerseusTableWidgetOptions;
 export type PerseusTableUserInput = ReadonlyArray<ReadonlyArray<string>>;
 export type PerseusVideoRubric = PerseusVideoWidgetOptions;
-export type UserInput = PerseusCategorizerUserInput | PerseusCSProgramUserInput | PerseusDropdownUserInput | PerseusExpressionUserInput | PerseusGrapherUserInput | PerseusIFrameUserInput | PerseusInputNumberUserInput | PerseusInteractiveGraphUserInput | PerseusLabelImageUserInput | PerseusMatcherUserInput | PerseusMatrixUserInput | PerseusMoleculeUserInput | PerseusNumberLineUserInput | PerseusNumericInputUserInput | PerseusOrdererUserInput | PerseusPlotterUserInput | PerseusRadioUserInput | PerseusSorterUserInput | PerseusTableUserInput | EmptyUserInput;
+export type Rubric = PerseusCategorizerRubric | PerseusCSProgramRubric | PerseusDefinitionRubric | PerseusDropdownRubric | PerseusExplanationRubric | PerseusExpressionRubric | PerseusGroupRubric | PerseusGradedGroupRubric | PerseusGradedGroupSetRubric | PerseusGrapherRubric | PerseusIFrameRubric | PerseusImageRubric | PerseusInputNumberRubric | PerseusInteractionRubric | PerseusInteractiveGraphRubric | PerseusLabelImageRubric | PerseusMatcherRubric | PerseusMatrixRubric | PerseusNumberLineRubric | PerseusNumericInputRubric | PerseusOrdererRubric | PerseusPassageRubric | PerseusPassageRefRubric | PerseusPlotterRubric | PerseusRadioRubric | PerseusSorterRubric | PerseusTableRubric | PerseusVideoRubric;
+export type UserInput = PerseusCategorizerUserInput | PerseusCSProgramUserInput | PerseusDropdownUserInput | PerseusExpressionUserInput | PerseusGrapherUserInput | PerseusIFrameUserInput | PerseusInputNumberUserInput | PerseusInteractiveGraphUserInput | PerseusLabelImageUserInput | PerseusMatcherUserInput | PerseusMatrixUserInput | PerseusNumberLineUserInput | PerseusNumericInputUserInput | PerseusOrdererUserInput | PerseusPlotterUserInput | PerseusRadioUserInput | PerseusSorterUserInput | PerseusTableUserInput;
+export type UserInputMap = {
+    [widgetId: string]: UserInput | UserInputMap;
+};
+/**
+ * deprecated prefer using UserInputMap
+ */
+export type UserInputArray = ReadonlyArray<UserInputArray | UserInput | null | undefined>;

package/dist/widgets/categorizer/categorizer.d.ts

@@ -1,8 +1,7 @@
 import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { PerseusCategorizerWidgetOptions } from "../../perseus-types";
-import type { PerseusStrings } from "../../strings";
-import type { PerseusScore, Widget, WidgetProps } from "../../types";
+import type { Widget, WidgetProps } from "../../types";
 import type { PerseusCategorizerRubric, PerseusCategorizerUserInput } from "../../validation.types";
 type Props = WidgetProps<RenderProps, PerseusCategorizerRubric> & {
     values: ReadonlyArray<string>;
@@ -18,18 +17,16 @@ type State = {
 };
 export declare class Categorizer extends React.Component<Props, State> implements Widget {
     static contextType: React.Context<{
-        strings: PerseusStrings;
+        strings: import("../../strings").PerseusStrings;
         locale: string;
     }>;
     context: React.ContextType<typeof PerseusI18nContext>;
     static defaultProps: DefaultProps;
     state: State;
-    static validate(userInput: PerseusCategorizerUserInput, rubric: PerseusCategorizerRubric, strings: PerseusStrings): PerseusScore;
     static getUserInputFromProps(props: Props): PerseusCategorizerUserInput;
     change: (...args: ReadonlyArray<unknown>) => any;
     getUserInput(): PerseusCategorizerUserInput;
     onChange(itemNum: any, catNum: any): void;
-    simpleValidate(rubric: PerseusCategorizerRubric): PerseusScore;
     render(): React.ReactNode;
 }
 type RenderProps = {
@@ -54,6 +51,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

package/dist/widgets/cs-program/cs-program.d.ts

@@ -3,7 +3,7 @@
  */
 import * as React from "react";
 import type { PerseusCSProgramWidgetOptions } from "../../perseus-types";
-import type { PerseusScore, Widget, WidgetProps } from "../../types";
+import type { Widget, WidgetProps } from "../../types";
 import type { PerseusCSProgramRubric, PerseusCSProgramUserInput } from "../../validation.types";
 type RenderProps = PerseusCSProgramWidgetOptions & PerseusCSProgramUserInput;
 type Props = WidgetProps<RenderProps, PerseusCSProgramRubric>;
@@ -15,13 +15,11 @@ type DefaultProps = {
 };
 declare class CSProgram extends React.Component<Props> implements Widget {
     static defaultProps: DefaultProps;
-    static validate(state: PerseusCSProgramUserInput): PerseusScore;
     componentDidMount(): void;
     componentWillUnmount(): void;
     handleMessageEvent: (arg1: any) => void;
     change: (...args: ReadonlyArray<unknown>) => any;
     getUserInput(): PerseusCSProgramUserInput;
-    simpleValidate(): PerseusScore;
     render(): React.ReactNode;
 }
 declare const _default: Readonly<{
@@ -40,6 +38,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

package/dist/widgets/definition/definition.d.ts

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { PerseusRenderer, PerseusDefinitionWidgetOptions } from "../../perseus-types";
 import type { Widget, WidgetProps } from "../../types";
-import type { EmptyUserInput, PerseusDefinitionRubric } from "../../validation.types";
+import type { PerseusDefinitionRubric } from "../../validation.types";
 type RenderProps = PerseusDefinitionWidgetOptions;
 type DefinitionProps = WidgetProps<RenderProps, PerseusDefinitionRubric> & {
     widgets: PerseusRenderer["widgets"];
@@ -18,9 +18,7 @@ declare class Definition extends React.Component<DefinitionProps> implements Wid
     }>;
     context: React.ContextType<typeof PerseusI18nContext>;
     static defaultProps: DefaultProps;
-    static validate(): import("../../types").PerseusScore;
-    getUserInput(): EmptyUserInput;
-    simpleValidate(): import("../../types").PerseusScore;
+    isWidget: true;
     render(): React.ReactNode;
 }
 declare const _default: Readonly<{
@@ -39,6 +37,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

package/dist/widgets/deprecated-standin/deprecated-standin.d.ts

@@ -0,0 +1,35 @@
+import React from "react";
+import { PerseusI18nContext } from "../../components/i18n-context";
+import type { Widget } from "../../types";
+type Props = any;
+declare class DeprecatedStandin extends React.Component<Props> implements Widget {
+    static contextType: React.Context<{
+        strings: import("../../strings").PerseusStrings;
+        locale: string;
+    }>;
+    context: React.ContextType<typeof PerseusI18nContext>;
+    isWidget: true;
+    render(): React.JSX.Element;
+}
+declare const _default: Readonly<{
+    name: string;
+    displayName: string;
+    getWidget?: (() => typeof DeprecatedStandin) | undefined;
+    widget: typeof DeprecatedStandin;
+    accessible?: boolean | ((props: any) => boolean) | undefined;
+    hidden?: boolean | undefined;
+    version?: import("../../types").Version | undefined;
+    supportedAlignments?: readonly import("../../types").Alignment[] | undefined;
+    defaultAlignment?: import("../../types").Alignment | undefined;
+    getDefaultAlignment?: (() => import("../../types").Alignment) | undefined;
+    isLintable?: boolean | undefined;
+    tracking?: import("../../types").Tracking | undefined;
+    traverseChildWidgets?: any;
+    transform?: import("../../types").WidgetTransform | undefined;
+    staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
+    propUpgrades?: {
+        [key: string]: (arg1: any) => any;
+    } | undefined;
+}>;
+export default _default;

package/dist/widgets/deprecated-standin/index.d.ts

@@ -1,37 +1 @@
-import React from "react";
-import { PerseusI18nContext } from "../../components/i18n-context";
-import type { PerseusScore, Widget } from "../../types";
-import type { EmptyUserInput } from "../../validation.types";
-type Props = any;
-declare class DeprecatedStandin extends React.Component<Props> implements Widget {
-    static contextType: React.Context<{
-        strings: import("../../strings").PerseusStrings;
-        locale: string;
-    }>;
-    context: React.ContextType<typeof PerseusI18nContext>;
-    static validate(): PerseusScore;
-    getUserInput(): EmptyUserInput;
-    simpleValidate(): PerseusScore;
-    render(): React.JSX.Element;
-}
-declare const _default: Readonly<{
-    name: string;
-    displayName: string;
-    getWidget?: (() => typeof DeprecatedStandin) | undefined;
-    widget: typeof DeprecatedStandin;
-    accessible?: boolean | ((props: any) => boolean) | undefined;
-    hidden?: boolean | undefined;
-    version?: import("../../types").Version | undefined;
-    supportedAlignments?: readonly import("../../types").Alignment[] | undefined;
-    defaultAlignment?: import("../../types").Alignment | undefined;
-    getDefaultAlignment?: (() => import("../../types").Alignment) | undefined;
-    isLintable?: boolean | undefined;
-    tracking?: import("../../types").Tracking | undefined;
-    traverseChildWidgets?: any;
-    transform?: import("../../types").WidgetTransform | undefined;
-    staticTransform?: import("../../types").WidgetTransform | undefined;
-    propUpgrades?: {
-        [key: string]: (arg1: any) => any;
-    } | undefined;
-}>;
-export default _default;
+export { default } from "./deprecated-standin";

package/dist/widgets/dropdown/dropdown.d.ts

@@ -1,5 +1,5 @@
 import * as React from "react";
-import type { PerseusScore, Widget, WidgetProps } from "../../types";
+import type { Widget, WidgetProps } from "../../types";
 import type { PerseusDropdownRubric, PerseusDropdownUserInput } from "../../validation.types";
 type Props = WidgetProps<RenderProps, PerseusDropdownRubric> & {
     selected: number;
@@ -12,12 +12,10 @@ type DefaultProps = {
 };
 declare class Dropdown extends React.Component<Props> implements Widget {
     static defaultProps: DefaultProps;
-    static validate(userInput: PerseusDropdownUserInput, rubric: PerseusDropdownRubric): PerseusScore;
     focus: () => boolean;
     _handleChangeEvent: (arg1: React.ChangeEvent<HTMLInputElement>) => void;
     _handleChange: (arg1: number) => void;
     getUserInput(): PerseusDropdownUserInput;
-    simpleValidate(rubric: PerseusDropdownRubric): PerseusScore;
     render(): React.ReactNode;
 }
 type RenderProps = {
@@ -40,6 +38,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

package/dist/widgets/explanation/explanation.d.ts

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { PerseusExplanationWidgetOptions } from "../../perseus-types";
 import type { Widget, WidgetProps } from "../../types";
-import type { EmptyUserInput, PerseusExplanationRubric } from "../../validation.types";
+import type { PerseusExplanationRubric } from "../../validation.types";
 type RenderProps = PerseusExplanationWidgetOptions;
 type Props = WidgetProps<RenderProps, PerseusExplanationRubric>;
 type DefaultProps = {
@@ -21,16 +21,14 @@ declare class Explanation extends React.Component<Props, State> implements Widge
         locale: string;
     }>;
     context: React.ContextType<typeof PerseusI18nContext>;
+    static defaultProps: DefaultProps;
+    isWidget: true;
     state: State;
     _mounted: boolean;
-    static defaultProps: DefaultProps;
-    static validate(): import("../../types").PerseusScore;
     componentDidMount(): void;
     componentWillUnmount(): void;
     change: (arg1: any, arg2: any, arg3: any) => any;
     _onClick: () => void;
-    getUserInput(): EmptyUserInput;
-    simpleValidate(): import("../../types").PerseusScore;
     render(): React.ReactNode;
 }
 declare const _default: Readonly<{
@@ -49,6 +47,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

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

@@ -2,8 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { DependenciesContext } from "../../dependencies";
 import type { PerseusExpressionWidgetOptions } from "../../perseus-types";
-import type { PerseusStrings } from "../../strings";
-import type { FocusPath, PerseusScore, Widget, WidgetProps } from "../../types";
+import type { FocusPath, 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>;
@@ -46,13 +45,12 @@ type DefaultProps = {
 };
 export declare class Expression extends React.Component<Props, ExpressionState> implements Widget {
     static contextType: React.Context<{
-        strings: PerseusStrings;
+        strings: import("../../strings").PerseusStrings;
         locale: string;
     }>;
     context: React.ContextType<typeof PerseusI18nContext>;
     _textareaId: string;
     _isMounted: boolean;
-    static validate(userInput: PerseusExpressionUserInput, rubric: PerseusExpressionRubric, strings: PerseusStrings, locale: string): PerseusScore;
     static getUserInputFromProps(props: Props): PerseusExpressionUserInput;
     static getOneCorrectAnswerFromRubric(rubric: PerseusExpressionRubric): string | null | undefined;
     static defaultProps: DefaultProps;
@@ -62,9 +60,6 @@ export declare class Expression extends React.Component<Props, ExpressionState>
     componentDidUpdate: (prevProps: Props) => void;
     componentWillUnmount: () => void;
     _handleMouseDown: () => void;
-    simpleValidate: (rubric: PerseusExpressionRubric & {
-        scoring?: boolean;
-    }) => PerseusScore;
     getUserInput(): PerseusExpressionUserInput;
     change: (...args: any) => any | undefined;
     parse: (value: string, props: Props) => any;
@@ -91,7 +86,7 @@ export declare class Expression extends React.Component<Props, ExpressionState>
  *       to be included as keys on the keypad. These are scraped from the answer
  *       forms.
  */
-declare const keypadConfigurationForProps: (widgetOptions: PerseusExpressionWidgetOptions) => KeypadConfiguration;
+export declare const keypadConfigurationForProps: (widgetOptions: PerseusExpressionWidgetOptions) => KeypadConfiguration;
 declare const _default: Readonly<{
     name: string;
     displayName: string;
@@ -614,6 +609,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

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

@@ -65,6 +65,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

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

@@ -45,6 +45,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

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, Widget, WidgetProps } from "../../types";
+import type { Widget, WidgetProps } from "../../types";
 import type { GridDimensions } from "../../util";
 import type { PerseusGrapherRubric, PerseusGrapherUserInput } from "../../validation.types";
 import type { PropsFor } from "@khanacademy/wonder-blocks-core";
@@ -23,7 +23,6 @@ declare class Grapher extends React.Component<Props> implements Widget {
     horizHairline: any;
     vertHairline: any;
     static defaultProps: DefaultProps;
-    static validate(state: PerseusGrapherUserInput, rubric: PerseusGrapherRubric): PerseusScore;
     static getUserInputFromProps(props: Props): PerseusGrapherUserInput;
     handlePlotChanges: (arg1: any) => any;
     handleActiveTypeChange: (arg1: any) => any;
@@ -35,7 +34,6 @@ declare class Grapher extends React.Component<Props> implements Widget {
     _setupGraphie: (arg1: any, arg2: any) => void;
     showHairlines: (arg1: Coord) => void;
     hideHairlines: () => void;
-    simpleValidate(rubric: PerseusGrapherRubric): PerseusScore;
     getUserInput(): PerseusGrapherUserInput;
     render(): React.ReactNode;
 }
@@ -55,6 +53,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

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

@@ -3,10 +3,9 @@ import { PerseusI18nContext } from "../../components/i18n-context";
 import Renderer from "../../renderer";
 import type { PerseusGroupWidgetOptions } from "../../perseus-types";
 import type { ChangeFn, FocusPath, Widget, WidgetProps } from "../../types";
-import type { UserInput } from "../../validation.types";
-type Rubric = PerseusGroupWidgetOptions;
+import type { PerseusGroupRubric, UserInputArray } from "../../validation.types";
 type RenderProps = PerseusGroupWidgetOptions;
-type Props = WidgetProps<RenderProps, Rubric>;
+type Props = WidgetProps<RenderProps, PerseusGroupRubric>;
 type DefaultProps = {
     content: Props["content"];
     widgets: Props["widgets"];
@@ -23,10 +22,13 @@ declare class Group extends React.Component<Props> implements Widget {
     static defaultProps: DefaultProps;
     componentDidMount(): void;
     change: ChangeFn;
-    getUserInput(): ReadonlyArray<UserInput | null | undefined> | undefined;
+    getUserInputMap(): import("../../validation.types").UserInputMap | undefined;
+    /**
+     * @deprecated getUserInputMap should be used for Groups
+     */
+    getUserInput(): UserInputArray | undefined;
     getSerializedState: () => any;
     restoreSerializedState: (arg1: any, arg2: any) => null;
-    simpleValidate(): import("../../types").PerseusScore;
     getInputPaths(): readonly FocusPath[];
     setInputValue: (arg1: FocusPath, arg2: string, arg3: () => unknown) => void;
     focus(): boolean;
@@ -51,6 +53,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;

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, Widget } from "../../types";
+import type { WidgetProps, Widget } from "../../types";
 import type { PerseusIFrameRubric, PerseusIFrameUserInput, UserInputStatus } from "../../validation.types";
 type RenderProps = PerseusIFrameWidgetOptions & {
     status: UserInputStatus;
@@ -25,13 +25,11 @@ type DefaultProps = {
 };
 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(): PerseusScore;
     render(): React.ReactNode;
 }
 declare const _default: Readonly<{
@@ -50,6 +48,7 @@ declare const _default: Readonly<{
     traverseChildWidgets?: any;
     transform?: import("../../types").WidgetTransform | undefined;
     staticTransform?: import("../../types").WidgetTransform | undefined;
+    validator?: import("../../types").WidgetValidatorFunction | undefined;
     propUpgrades?: {
         [key: string]: (arg1: any) => any;
     } | undefined;