@khanacademy/perseus 41.4.0 → 42.0.0

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 { DefinitionPromptJSON } from "../../widget-ai-utils/definition/prompt-utils";
+import type { DefinitionPromptJSON } from "../../widget-ai-utils/definition/definition-ai-utils";
 type RenderProps = PerseusDefinitionWidgetOptions;
 type DefinitionProps = WidgetProps<RenderProps> & {
     widgets: PerseusRenderer["widgets"];

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

@@ -3,7 +3,7 @@ import scoreDropdown from "./score-dropdown";
 import type { PerseusDropdownWidgetOptions } from "../../perseus-types";
 import type { Widget, WidgetProps } from "../../types";
 import type { PerseusDropdownRubric, PerseusDropdownUserInput } from "../../validation.types";
-import type { DropdownPromptJSON } from "../../widget-ai-utils/dropdown/prompt-utils";
+import type { DropdownPromptJSON } from "../../widget-ai-utils/dropdown/dropdown-ai-utils";
 type Props = WidgetProps<RenderProps, PerseusDropdownRubric> & {
     selected: number;
 };

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 { ExplanationPromptJSON } from "../../widget-ai-utils/explanation/prompt-utils";
+import type { ExplanationPromptJSON } from "../../widget-ai-utils/explanation/explanation-ai-utils";
 type RenderProps = PerseusExplanationWidgetOptions;
 type Props = WidgetProps<RenderProps>;
 type DefaultProps = {

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

@@ -5,7 +5,7 @@ import type { DependenciesContext } from "../../dependencies";
 import type { PerseusExpressionWidgetOptions } from "../../perseus-types";
 import type { FocusPath, Widget, WidgetProps } from "../../types";
 import type { PerseusExpressionRubric, PerseusExpressionUserInput } from "../../validation.types";
-import type { ExpressionPromptJSON } from "../../widget-ai-utils/expression/prompt-utils";
+import type { ExpressionPromptJSON } from "../../widget-ai-utils/expression/expression-ai-utils";
 import type { Keys as Key, KeypadConfiguration } from "@khanacademy/math-input";
 type InputPath = ReadonlyArray<string>;
 type RenderProps = {

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

@@ -5,7 +5,7 @@ import type { ANSWER_BAR_STATES } from "./graded-group-answer-bar";
 import type { PerseusGradedGroupWidgetOptions } from "../../perseus-types";
 import type { FocusPath, TrackingGradedGroupExtraArguments, Widget, WidgetProps } from "../../types";
 import type { PerseusGradedGroupRubric } from "../../validation.types";
-import type { GradedGroupPromptJSON } from "../../widget-ai-utils/graded-group/prompt-utils";
+import type { GradedGroupPromptJSON } from "../../widget-ai-utils/graded-group/graded-group-ai-utils";
 declare const GRADING_STATUSES: {
     readonly ungraded: "ungraded";
     readonly correct: "correct";

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

@@ -4,7 +4,7 @@ import { GradedGroup } from "../graded-group/graded-group";
 import type { PerseusGradedGroupSetWidgetOptions } from "../../perseus-types";
 import type { FocusPath, Widget, WidgetProps } from "../../types";
 import type { PerseusGradedGroupSetRubric } from "../../validation.types";
-import type { GradedGroupSetPromptJSON } from "../../widget-ai-utils/graded-group-set/prompt-utils";
+import type { GradedGroupSetPromptJSON } from "../../widget-ai-utils/graded-group-set/graded-group-set-ai-utils";
 type RenderProps = PerseusGradedGroupSetWidgetOptions;
 type Props = Changeable.ChangeableProps & WidgetProps<RenderProps, PerseusGradedGroupSetRubric> & {
     trackInteraction: () => void;

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

@@ -6,7 +6,7 @@ import type { PerseusGrapherWidgetOptions } from "../../perseus-types";
 import type { Widget, WidgetProps } from "../../types";
 import type { GridDimensions } from "../../util";
 import type { PerseusGrapherRubric, PerseusGrapherUserInput } from "../../validation.types";
-import type { GrapherPromptJSON } from "../../widget-ai-utils/grapher/prompt-utils";
+import type { GrapherPromptJSON } from "../../widget-ai-utils/grapher/grapher-ai-utils";
 import type { PropsFor } from "@khanacademy/wonder-blocks-core";
 type RenderProps = {
     availableTypes: PerseusGrapherWidgetOptions["availableTypes"];

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

@@ -4,7 +4,7 @@ import Renderer from "../../renderer";
 import type { PerseusGroupWidgetOptions } from "../../perseus-types";
 import type { ChangeFn, FocusPath, Widget, WidgetProps } from "../../types";
 import type { PerseusGroupRubric, UserInputArray } from "../../validation.types";
-import type { GroupPromptJSON } from "../../widget-ai-utils/group/prompt-utils";
+import type { GroupPromptJSON } from "../../widget-ai-utils/group/group-ai-utils";
 type RenderProps = PerseusGroupWidgetOptions;
 type Props = WidgetProps<RenderProps, PerseusGroupRubric>;
 type DefaultProps = {

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { PerseusImageWidgetOptions } from "../../perseus-types";
 import type { ChangeFn, WidgetProps, Widget } from "../../types";
-import type { ImagePromptJSON } from "../../widget-ai-utils/image/prompt-utils";
+import type { ImagePromptJSON } from "../../widget-ai-utils/image/image-ai-utils";
 type RenderProps = PerseusImageWidgetOptions;
 type ExternalProps = WidgetProps<RenderProps>;
 type Props = ExternalProps & {

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

@@ -5,7 +5,7 @@ import type { PerseusInputNumberWidgetOptions } from "../../perseus-types";
 import type { PerseusStrings } from "../../strings";
 import type { Path, Widget, WidgetProps } from "../../types";
 import type { PerseusInputNumberRubric, PerseusInputNumberUserInput } from "../../validation.types";
-import type { InputNumberPromptJSON } from "../../widget-ai-utils/input-number/prompt-utils";
+import type { InputNumberPromptJSON } from "../../widget-ai-utils/input-number/input-number-ai-utils";
 type RenderProps = {
     simplify: PerseusInputNumberWidgetOptions["simplify"];
     size: PerseusInputNumberWidgetOptions["size"];

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

@@ -8,7 +8,7 @@ import type { PerseusGraphType, PerseusGraphTypeAngle, PerseusGraphTypePoint, Pe
 import type { ChangeHandler, WidgetProps } from "../types";
 import type { QuadraticCoefficient, Range, SineCoefficient } from "../util/geometry";
 import type { PerseusInteractiveGraphRubric, PerseusInteractiveGraphUserInput } from "../validation.types";
-import type { InteractiveGraphPromptJSON } from "../widget-ai-utils/interactive-graph/prompt-utils";
+import type { InteractiveGraphPromptJSON } from "../widget-ai-utils/interactive-graph/interactive-graph-ai-utils";
 import type { UnsupportedWidgetPromptJSON } from "../widget-ai-utils/unsupported-widget";
 type RenderProps = PerseusInteractiveGraphWidgetOptions;
 type Props = WidgetProps<RenderProps, PerseusInteractiveGraphRubric>;

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

@@ -4,6 +4,15 @@ import type { KeyboardMovementConstraint } from "../use-draggable";
 import type { vec } from "mafs";
 type Props = {
     point: vec.Vector2;
+    /**
+     * Represents where this point stands in the overall point sequence.
+     * This is used to provide screen readers with context about the point.
+     * Example: sequenceNumber={1} ==> "Point 1 at x comma y"
+     *
+     * Note: This number is 1-indexed, and should restart from 1 for each
+     * interactive figure on the graph.
+     */
+    sequenceNumber: number;
     onMove?: (newPoint: vec.Vector2) => unknown;
     onClick?: () => unknown;
     color?: string;

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

@@ -6,6 +6,15 @@ type Params = {
     point: vec.Vector2;
     color?: string | undefined;
     cursor?: CSSCursor | undefined;
+    /**
+     * Represents where this point stands in the overall point sequence.
+     * This is used to provide screen readers with context about the point.
+     * Example: sequenceNumber={1} ==> "Point 1 at x comma y"
+     *
+     * Note: This number is 1-indexed, and should restart from 1 for each
+     * interactive figure on the graph.
+     */
+    sequenceNumber: number;
     constrain?: KeyboardMovementConstraint;
     onMove?: ((newPoint: vec.Vector2) => unknown) | undefined;
     onClick?: (() => unknown) | undefined;

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

@@ -15,7 +15,7 @@ import type { ChangeableProps } from "../../mixins/changeable";
 import type { PerseusLabelImageWidgetOptions } from "../../perseus-types";
 import type { APIOptions, Widget } from "../../types";
 import type { PerseusLabelImageRubric, PerseusLabelImageUserInput } from "../../validation.types";
-import type { LabelImagePromptJSON } from "../../widget-ai-utils/label-image/prompt-utils";
+import type { LabelImagePromptJSON } from "../../widget-ai-utils/label-image/label-image-ai-utils";
 export type PreferredPopoverDirection = "NONE" | "UP" | "DOWN" | "LEFT" | "RIGHT";
 /**
  * Represents a direction vector.

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

@@ -5,7 +5,7 @@ import type { SortableOption } from "../../components/sortable";
 import type { PerseusMatcherWidgetOptions } from "../../perseus-types";
 import type { WidgetProps, Widget } from "../../types";
 import type { PerseusMatcherRubric, PerseusMatcherUserInput } from "../../validation.types";
-import type { MatcherPromptJSON } from "../../widget-ai-utils/matcher/prompt-utils";
+import type { MatcherPromptJSON } from "../../widget-ai-utils/matcher/matcher-ai-utils";
 type RenderProps = PerseusMatcherWidgetOptions;
 type Props = WidgetProps<RenderProps, PerseusMatcherRubric>;
 type DefaultProps = {

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

@@ -4,7 +4,7 @@ import scoreMatrix from "./score-matrix";
 import type { PerseusMatrixWidgetOptions } from "../../perseus-types";
 import type { WidgetProps, Widget, FocusPath } from "../../types";
 import type { PerseusMatrixRubric, PerseusMatrixUserInput } from "../../validation.types";
-import type { MatrixPromptJSON } from "../../widget-ai-utils/matrix/prompt-utils";
+import type { MatrixPromptJSON } from "../../widget-ai-utils/matrix/matrix-ai-utils";
 export declare function getMatrixSize(matrix: ReadonlyArray<ReadonlyArray<number>>): number[];
 type ExternalProps = WidgetProps<PerseusMatrixWidgetOptions, PerseusMatrixRubric>;
 type Props = ExternalProps & {

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

@@ -4,7 +4,7 @@ import scoreNumberLine from "./score-number-line";
 import type { ChangeableProps } from "../../mixins/changeable";
 import type { APIOptions, FocusPath, Widget } from "../../types";
 import type { PerseusNumberLineUserInput } from "../../validation.types";
-import type { NumberLinePromptJSON } from "../../widget-ai-utils/number-line/prompt-utils";
+import type { NumberLinePromptJSON } from "../../widget-ai-utils/number-line/number-line-ai-utils";
 export type Relationship = "lt" | "gt" | "le" | "ge";
 type Props = ChangeableProps & {
     range: [number, number];

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

@@ -74,7 +74,14 @@ declare const _default: {
     defaultAlignment: "inline-block";
     accessible: true;
     widget: typeof NumericInput;
+    version: {
+        major: number;
+        minor: number;
+    };
     transform: (widgetOptions: PerseusNumericInputWidgetOptions) => RenderProps;
+    propUpgrades: {
+        readonly "1": (initialProps: any) => PerseusNumericInputWidgetOptions;
+    };
     isLintable: true;
     scorer: typeof scoreNumericInput;
     getOneCorrectAnswerFromRubric(rubric: PerseusNumericInputRubric): string | null | undefined;

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

@@ -3,7 +3,7 @@ import { scoreOrderer } from "./score-orderer";
 import type { PerseusOrdererWidgetOptions } from "../../perseus-types";
 import type { WidgetProps, Widget } from "../../types";
 import type { PerseusOrdererRubric, PerseusOrdererUserInput } from "../../validation.types";
-import type { OrdererPromptJSON } from "../../widget-ai-utils/orderer/prompt-utils";
+import type { OrdererPromptJSON } from "../../widget-ai-utils/orderer/orderer-ai-utils";
 type Position = {
     left: number;
     top: number;

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

@@ -5,7 +5,7 @@ import type { SerializedHighlightSet } from "../../components/highlighting/types
 import type { ChangeableProps } from "../../mixins/changeable";
 import type { PerseusPassageWidgetOptions, PerseusWidget } from "../../perseus-types";
 import type { WidgetProps, Widget } from "../../types";
-import type { PassagePromptJSON } from "../../widget-ai-utils/passage/prompt-utils";
+import type { PassagePromptJSON } from "../../widget-ai-utils/passage/passage-ai-utils";
 import type { SingleASTNode } from "@khanacademy/simple-markdown";
 export declare class LineHeightMeasurer extends React.Component<Record<any, any>> {
     _line: HTMLDivElement | null | undefined;

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

@@ -2,7 +2,7 @@ import * as React from "react";
 import { PerseusI18nContext } from "../../components/i18n-context";
 import type { PerseusPassageRefWidgetOptions } from "../../perseus-types";
 import type { ChangeFn, Widget, WidgetProps } from "../../types";
-import type { PassageRefPromptJSON } from "../../widget-ai-utils/passage-ref/prompt-utils";
+import type { PassageRefPromptJSON } from "../../widget-ai-utils/passage-ref/passage-ref-ai-utils";
 type RenderProps = {
     passageNumber: PerseusPassageRefWidgetOptions["passageNumber"];
     referenceNumber: PerseusPassageRefWidgetOptions["referenceNumber"];

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

@@ -4,7 +4,7 @@ import type { FocusFunction } from "./base-radio";
 import type { PerseusRadioChoice, PerseusRadioWidgetOptions, ShowSolutions } from "../../perseus-types";
 import type { WidgetProps, ChoiceState, Widget } from "../../types";
 import type { PerseusRadioRubric, PerseusRadioUserInput } from "../../validation.types";
-import type { RadioPromptJSON } from "../../widget-ai-utils/radio/prompt-utils";
+import type { RadioPromptJSON } from "../../widget-ai-utils/radio/radio-ai-utils";
 export type RenderProps = {
     numCorrect: number;
     hasNoneOfTheAbove?: boolean;

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

@@ -4,7 +4,7 @@ import type { SortableOption } from "../../components/sortable";
 import type { PerseusSorterWidgetOptions } from "../../perseus-types";
 import type { Widget, WidgetProps } from "../../types";
 import type { PerseusSorterRubric, PerseusSorterUserInput } from "../../validation.types";
-import type { SorterPromptJSON } from "../../widget-ai-utils/sorter/prompt-utils";
+import type { SorterPromptJSON } from "../../widget-ai-utils/sorter/sorter-ai-utils";
 type RenderProps = PerseusSorterWidgetOptions;
 type Props = WidgetProps<RenderProps, PerseusSorterRubric>;
 type DefaultProps = {

package/package.json

@@ -3,7 +3,7 @@
     "description": "Core Perseus API (includes renderers and widgets)",
     "author": "Khan Academy",
     "license": "MIT",
-    "version": "41.4.0",
+    "version": "42.0.0",
     "publishConfig": {
         "access": "public"
     },

package/dist/prompt-types.d.ts

@@ -1,33 +0,0 @@
-import type { CategorizerPromptJSON } from "./widget-ai-utils/categorizer/prompt-utils";
-import type { DefinitionPromptJSON } from "./widget-ai-utils/definition/prompt-utils";
-import type { DropdownPromptJSON } from "./widget-ai-utils/dropdown/prompt-utils";
-import type { ExplanationPromptJSON } from "./widget-ai-utils/explanation/prompt-utils";
-import type { ExpressionPromptJSON } from "./widget-ai-utils/expression/prompt-utils";
-import type { GradedGroupPromptJSON } from "./widget-ai-utils/graded-group/prompt-utils";
-import type { GradedGroupSetPromptJSON } from "./widget-ai-utils/graded-group-set/prompt-utils";
-import type { GrapherPromptJSON } from "./widget-ai-utils/grapher/prompt-utils";
-import type { GroupPromptJSON } from "./widget-ai-utils/group/prompt-utils";
-import type { ImagePromptJSON } from "./widget-ai-utils/image/prompt-utils";
-import type { InputNumberPromptJSON } from "./widget-ai-utils/input-number/prompt-utils";
-import type { LabelImagePromptJSON } from "./widget-ai-utils/label-image/prompt-utils";
-import type { MatcherPromptJSON } from "./widget-ai-utils/matcher/prompt-utils";
-import type { MatrixPromptJSON } from "./widget-ai-utils/matrix/prompt-utils";
-import type { NumberLinePromptJSON } from "./widget-ai-utils/number-line/prompt-utils";
-import type { NumericInputPromptJSON } from "./widget-ai-utils/numeric-input/prompt-utils";
-import type { OrdererPromptJSON } from "./widget-ai-utils/orderer/prompt-utils";
-import type { PassagePromptJSON } from "./widget-ai-utils/passage/prompt-utils";
-import type { PassageRefPromptJSON } from "./widget-ai-utils/passage-ref/prompt-utils";
-import type { RadioPromptJSON } from "./widget-ai-utils/radio/prompt-utils";
-import type { SorterPromptJSON } from "./widget-ai-utils/sorter/prompt-utils";
-import type { UnsupportedWidgetPromptJSON } from "./widget-ai-utils/unsupported-widget";
-export type UnsupportedWidget = "cs-program" | "iframe" | "interaction" | "interactive-graph-unsupported" | "measurer" | "phet-simulation" | "plotter" | "python-program" | "video";
-export type WidgetPromptJSON = CategorizerPromptJSON | DefinitionPromptJSON | DropdownPromptJSON | ExplanationPromptJSON | ExpressionPromptJSON | GradedGroupPromptJSON | GradedGroupSetPromptJSON | GrapherPromptJSON | GroupPromptJSON | ImagePromptJSON | InputNumberPromptJSON | LabelImagePromptJSON | MatcherPromptJSON | MatrixPromptJSON | NumberLinePromptJSON | NumericInputPromptJSON | OrdererPromptJSON | PassagePromptJSON | PassageRefPromptJSON | RadioPromptJSON | SorterPromptJSON | UnsupportedWidgetPromptJSON;
-export type RendererPromptJSON = {
-    content: string;
-    widgets: {
-        [widgetId: string]: WidgetPromptJSON;
-    };
-};
-export interface GetPromptJSONInterface {
-    getPromptJSON(): RendererPromptJSON;
-}