@khanacademy/perseus 18.0.1 → 19.1.0

package/dist/mixins/changeable.d.ts

@@ -26,5 +26,5 @@ export declare const propTypes: {
 export type ChangeableProps = {
     onChange: (values: {
         [key: string]: any;
-    }, callback?: () => unknown | null | undefined, silent?: boolean) => unknown;
+    }, callback?: (() => unknown) | null | undefined, silent?: boolean) => unknown;
 };

package/dist/perseus-api.d.ts

@@ -93,6 +93,7 @@ export declare const ApiOptions: {
         inModal?: boolean | undefined;
         crossOutEnabled?: boolean | undefined;
         editorChangeDelay?: number | undefined;
+        onWidgetStartProps?: ((widgets: import("./types").PerseusWidgetMap) => import("./types").PerseusWidgetMap) | undefined;
     }> & {
         GroupMetadataEditor: NonNullable<React.ComponentType<any> | undefined>;
         baseElements: {

package/dist/perseus-types.d.ts

@@ -70,7 +70,6 @@ export type SequenceWidget = Widget<'sequence', PerseusSequenceWidgetOptions>;
 export type SimulatorWidget = Widget<'simulator', PerseusSimulatorWidgetOptions>;
 export type SorterWidget = Widget<'sorter', PerseusSorterWidgetOptions>;
 export type TableWidget = Widget<'table', PerseusTableWidgetOptions>;
-export type TransformerWidget = Widget<'transformer', PerseusTransformerWidgetOptions>;
 export type ExampleGraphieWidget = Widget<'example-graphie-widget', PerseusExampleGraphieWidgetOptions>;
 export type ExampleWidget = Widget<'example-widget', PerseusExampleWidgetOptions>;
 export type InputNumberWidget = Widget<'input-number', PerseusInputNumberWidgetOptions>;
@@ -82,7 +81,7 @@ export type SimpleMarkdownTesterWidget = Widget<'simple-markdown-tester', Perseu
 export type UnitInputWidget = Widget<'unit-input', PerseusUnitInputWidgetOptions>;
 export type VideoWidget = Widget<'video', PerseusVideoWidgetOptions>;
 export type AutoCorrectWidget = Widget<'deprecated-standin', PerseusWidgetOptions>;
-export type PerseusWidget = CategorizerWidget | CSProgramWidget | DefinitionWidget | DropdownWidget | ExampleGraphieWidget | ExampleWidget | ExplanationWidget | ExpressionWidget | GradedGroupSetWidget | GradedGroupWidget | GrapherWidget | GroupWidget | IFrameWidget | ImageWidget | InputNumberWidget | InteractionWidget | InteractiveGraphWidget | LabelImageWidget | LightsPuzzleWidget | MatcherWidget | MatrixWidget | MeasurerWidget | MoleculeRendererWidget | NumberLineWidget | NumericInputWidget | OrdererWidget | PassageRefWidget | PassageWidget | PlotterWidget | RadioWidget | ReactionDiagramWidget | RefTargetWidget | SequenceWidget | SimpleMarkdownTesterWidget | SimulatorWidget | SorterWidget | TableWidget | TransformerWidget | UnitInputWidget | VideoWidget | AutoCorrectWidget;
+export type PerseusWidget = CategorizerWidget | CSProgramWidget | DefinitionWidget | DropdownWidget | ExampleGraphieWidget | ExampleWidget | ExplanationWidget | ExpressionWidget | GradedGroupSetWidget | GradedGroupWidget | GrapherWidget | GroupWidget | IFrameWidget | ImageWidget | InputNumberWidget | InteractionWidget | InteractiveGraphWidget | LabelImageWidget | LightsPuzzleWidget | MatcherWidget | MatrixWidget | MeasurerWidget | MoleculeRendererWidget | NumberLineWidget | NumericInputWidget | OrdererWidget | PassageRefWidget | PassageWidget | PlotterWidget | RadioWidget | ReactionDiagramWidget | RefTargetWidget | SequenceWidget | SimpleMarkdownTesterWidget | SimulatorWidget | SorterWidget | TableWidget | UnitInputWidget | VideoWidget | AutoCorrectWidget;
 export type PerseusImageBackground = {
     url: string | null | undefined;
     width?: number;
@@ -468,85 +467,6 @@ export type PerseusTableWidgetOptions = {
     columns: number;
     answers: ReadonlyArray<ReadonlyArray<string>>;
 };
-export type PerseusTransformerWidgetOptions = {
-    correct: {
-        shape: {
-            type: ReadonlyArray<"polygon-5" | "polygon-3" | "polygon-4" | "lineSegment" | "polygon-6" | "angle" | "line" | "circle">;
-            coords: ReadonlyArray<Coord>;
-            options?: ReadonlyArray<{
-                reflex?: boolean;
-            }>;
-        };
-        transformations: ReadonlyArray<PerseusTransformerTransformation>;
-    };
-    drawSolutionShape: boolean;
-    gradeEmpty: boolean;
-    graph: {
-        backgroundImage: {
-            bottom?: number;
-            height?: number;
-            left?: number;
-            scale?: number;
-            url?: string;
-            width?: number;
-        };
-        gridStep?: [number, number];
-        labels?: ["x", "y"];
-        markings: "none" | "graph" | "grid";
-        range: [[number, number], [number, number]];
-        rulerLabel?: string;
-        rulerTicks?: number;
-        showProtractor: boolean;
-        showRuler?: boolean;
-        snapStep?: [number, number];
-        step: [number, number];
-    };
-    graphMode: "dynamic" | "interactive" | "static";
-    listMode: "interactive" | "dynamic" | "static";
-    starting: {
-        shape: {
-            type: ReadonlyArray<"polygon-5" | "polygon-3" | "polygon-4" | "lineSegment" | "polygon-6">;
-            coords: ReadonlyArray<Coord>;
-            options?: ReadonlyArray<Empty>;
-        } | {
-            type: "polygon-3";
-            coords: [Coord, Coord, Coord];
-        } | {
-            type: [
-                "polygon-3" | "lineSegment" | "polygon-4" | "polygon-5" | "polygon-6" | "line" | "circle"
-            ];
-            coords: ReadonlyArray<Coord>;
-            options: [Empty];
-        } | {
-            type: ["polygon-3"];
-            coords: [Coord, Coord, Coord];
-            options?: [Empty];
-        } | {
-            type: ["angle"];
-            coords: [Coord, Coord, Coord];
-            options: [
-                {
-                    reflex: boolean;
-                }
-            ];
-        } | {
-            type: ["line" | "lineSegment"];
-            coords: [Coord, Coord];
-            options?: [Empty];
-        } | {
-            type: "polygon";
-            coords: ReadonlyArray<Coord>;
-        };
-        transformations: ReadonlyArray<PerseusTransformerTransformation>;
-    };
-    tools: {
-        dilation: DilationTool;
-        reflection: ReflectionTool;
-        rotation: RotationTool;
-        translation: TranslationTool;
-    };
-    version: number;
-};
 export type DilationTransformation = {
     type: "dilation";
     center: Coord;
@@ -575,33 +495,6 @@ export type TranslationTransformation = {
     vector: Coord;
     contraints: Empty;
 };
-export type PerseusTransformerTransformation = DilationTransformation | ReflectionTransformation | RotationTransformation | TranslationTransformation;
-type DilationTool = {
-    constraints: PerseusTransformerToolConstraints;
-    coord: Coord;
-    enabled: boolean;
-    required?: boolean;
-};
-type ReflectionTool = {
-    constraints: PerseusTransformerToolConstraints;
-    coords: [Coord, Coord];
-    enabled: boolean;
-    required?: boolean;
-};
-type RotationTool = {
-    constraints: PerseusTransformerToolConstraints;
-    coord: Coord;
-    enabled: boolean;
-    required?: boolean;
-};
-type TranslationTool = {
-    constraints: Empty;
-    enabled: boolean;
-    required?: boolean;
-};
-export type PerseusTransformerToolConstraints = {
-    fixed: boolean;
-};
 export type PerseusInteractionWidgetOptions = {
     graph: PerseusInteractionGraph;
     elements: ReadonlyArray<PerseusInteractionElement>;
@@ -774,5 +667,5 @@ export type PerseusPassageRefTargetWidgetOptions = any;
 export type PerseusReactionDiagramWidgetOptions = any;
 export type PerseusSimpleMarkdownTesterWidgetOptions = any;
 export type PerseusUnitInputWidgetOptions = any;
-export type PerseusWidgetOptions = PerseusCategorizerWidgetOptions | PerseusCSProgramWidgetOptions | PerseusDefinitionWidgetOptions | PerseusDropdownWidgetOptions | PerseusExampleGraphieWidgetOptions | PerseusExampleWidgetOptions | PerseusExplanationWidgetOptions | PerseusExpressionWidgetOptions | PerseusGradedGroupSetWidgetOptions | PerseusGradedGroupWidgetOptions | PerseusIFrameWidgetOptions | PerseusImageWidgetOptions | PerseusInputNumberWidgetOptions | PerseusInteractionWidgetOptions | PerseusInteractiveGraphWidgetOptions | PerseusLabelImageWidgetOptions | PerseusLightsPuzzleWidgetOptions | PerseusMatcherWidgetOptions | PerseusMatrixWidgetOptions | PerseusMeasurerWidgetOptions | PerseusMoleculeRendererWidgetOptions | PerseusNumberLineWidgetOptions | PerseusNumericInputWidgetOptions | PerseusOrdererWidgetOptions | PerseusPassageRefTargetWidgetOptions | PerseusPassageRefWidgetOptions | PerseusPassageWidgetOptions | PerseusPlotterWidgetOptions | PerseusRadioWidgetOptions | PerseusReactionDiagramWidgetOptions | PerseusSequenceWidgetOptions | PerseusSimpleMarkdownTesterWidgetOptions | PerseusSimulatorWidgetOptions | PerseusSorterWidgetOptions | PerseusTableWidgetOptions | PerseusTransformerWidgetOptions | PerseusUnitInputWidgetOptions | PerseusVideoWidgetOptions;
+export type PerseusWidgetOptions = PerseusCategorizerWidgetOptions | PerseusCSProgramWidgetOptions | PerseusDefinitionWidgetOptions | PerseusDropdownWidgetOptions | PerseusExampleGraphieWidgetOptions | PerseusExampleWidgetOptions | PerseusExplanationWidgetOptions | PerseusExpressionWidgetOptions | PerseusGradedGroupSetWidgetOptions | PerseusGradedGroupWidgetOptions | PerseusIFrameWidgetOptions | PerseusImageWidgetOptions | PerseusInputNumberWidgetOptions | PerseusInteractionWidgetOptions | PerseusInteractiveGraphWidgetOptions | PerseusLabelImageWidgetOptions | PerseusLightsPuzzleWidgetOptions | PerseusMatcherWidgetOptions | PerseusMatrixWidgetOptions | PerseusMeasurerWidgetOptions | PerseusMoleculeRendererWidgetOptions | PerseusNumberLineWidgetOptions | PerseusNumericInputWidgetOptions | PerseusOrdererWidgetOptions | PerseusPassageRefTargetWidgetOptions | PerseusPassageRefWidgetOptions | PerseusPassageWidgetOptions | PerseusPlotterWidgetOptions | PerseusRadioWidgetOptions | PerseusReactionDiagramWidgetOptions | PerseusSequenceWidgetOptions | PerseusSimpleMarkdownTesterWidgetOptions | PerseusSimulatorWidgetOptions | PerseusSorterWidgetOptions | PerseusTableWidgetOptions | PerseusUnitInputWidgetOptions | PerseusVideoWidgetOptions;
 export {};

package/dist/renderer.d.ts

@@ -4,7 +4,7 @@ import TranslationLinter from "./translation-linter";
 import WidgetContainer from "./widget-container";
 import type { DependenciesContext } from "./dependencies";
 import type { PerseusRenderer, PerseusWidget, PerseusWidgetOptions } from "./perseus-types";
-import type { APIOptions, APIOptionsWithDefaults, FilterCriterion, FocusPath, PerseusScore, WidgetProps } from "./types";
+import type { APIOptions, APIOptionsWithDefaults, FilterCriterion, FocusPath, PerseusScore, PerseusWidgetMap, WidgetProps } from "./types";
 import type { LinterContextProps } from "@khanacademy/perseus-linter";
 import "./styles/perseus-renderer.less";
 type WidgetState = {
@@ -117,9 +117,7 @@ declare class Renderer extends React.Component<Props, State> {
     _getAllWidgetsInfo: (props: Props) => {
         [key: string]: PerseusWidget;
     };
-    _getAllWidgetsStartProps: (allWidgetInfo: {
-        [key: string]: PerseusWidget;
-    }, props: Props) => any;
+    _getAllWidgetsStartProps: (allWidgetInfo: PerseusWidgetMap, props: Props) => PerseusWidgetMap;
     _getDefaultWidgetInfo: (widgetId: string) => any;
     _getWidgetInfo: (widgetId: string) => PerseusWidget;
     renderWidget: (impliedType: string, id: string, state: WidgetState) => null | React.ReactNode;

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

@@ -136,6 +136,7 @@ declare const ref: React.ForwardRefExoticComponent<Omit<Pick<OwnProps & HOCProps
         inModal?: boolean | undefined;
         crossOutEnabled?: boolean | undefined;
         editorChangeDelay?: number | undefined;
+        onWidgetStartProps?: ((widgets: import("./types").PerseusWidgetMap) => import("./types").PerseusWidgetMap) | undefined;
     }> | undefined;
     onRendered?: ((isRendered: boolean) => void) | undefined;
 } & {}, "onRendered"> & React.RefAttributes<ServerItemRenderer>>;

package/dist/strings.js

@@ -31,7 +31,6 @@ module.exports = [
     i18n._("a multiple of pi, like $12\\ \\text{pi}$ or $2/3\\ \\text{pi}$", {}),
     i18n._("a percent, like $12.34\\%$", {}),
     i18n._("Add highlight", {}),
-    i18n._("Add transformations below:", {}),
     i18n._("an *exact* decimal, like $0.75$", {}),
     i18n._("an *improper* fraction, like $10/7$ or $14/8$", {}),
     i18n._("an integer, like $6$", {}),
@@ -55,12 +54,6 @@ module.exports = [
     i18n._("Correct (selected)", {}),
     i18n._("Correct!", {}),
     i18n._("Current", {}),
-    // I18N: As in the command, "Dilate the polygon"
-    i18n._("Dilate", {}),
-    i18n._("dilation", {}),
-    i18n._("Dilation", {}),
-    i18n.$_("Dilation about %(point)s by %(scale)s", {}),
-    i18n.$_("Dilation of scale %(scale)s about %(point)s", {}),
     i18n._("Drag handles to make graph", {}),
     i18n._("End of reading passage.", {}),
     i18n._("entered in an invalid answer.", {}),
@@ -93,7 +86,6 @@ module.exports = [
     i18n._("Next question", {}),
     i18n._("No", {}),
     i18n._("None of the above", {}),
-    i18n._("Note: For this question, the shape will not move.", {}),
     i18n._("Number of divisions:", {}),
     i18n._("Number of trials:", {}),
     i18n._("Oops!", {}),
@@ -102,19 +94,7 @@ module.exports = [
     i18n._("Please choose the correct number of answers.", {}),
     i18n.$_("Please make sure the number of divisions is in the range %(divRangeString)s.", {}),
     i18n._("Reaction arrow pointing to the right.", {}),
-    // I18N: As in the command, "Reflect the polygon"
-    i18n._("Reflect", {}),
-    i18n._("reflection", {}),
-    i18n._("Reflection", {}),
-    i18n.$_("Reflection over the line from %(point1)s to %(point2)s", {}),
     i18n._("Remove highlight", {}),
-    // I18N: As in the command, "Rotate the polygon"
-    i18n._("Rotate", {}),
-    i18n._("rotation", {}),
-    i18n._("Rotation", {}),
-    // I18N: %(point)s must come before %(degrees)s in this phrase
-    i18n.$_("Rotation about %(point)s by %(degrees)s", {}),
-    i18n.$_("Rotation by %(degrees)s about %(point)s", {}),
     i18n._("Run simulation", {}),
     i18n._("Sample size:", {}),
     i18n._("See video transcript", {}),
@@ -131,16 +111,8 @@ module.exports = [
     i18n._("This controls the proportion or percentage that will be used in your simulation.", {}),
     i18n._("This controls the sample size that will be used in your simulation. For example, if you set this to 100, then for each trial, responses from 100 participants will be simulated.", {}),
     i18n._("This is the number of trials used in the simulation. For example, if set to 50, then the survey will be conducted 50 times.", {}),
-    // I18N: As in the command, "Translate the polygon"
-    i18n._("Translate", {}),
-    i18n._("translation", {}),
-    i18n._("Translation", {}),
-    // I18N: As in the command, "Translation by <3, 1>"
-    i18n.$_("Translation by %(vector)s", {}),
     i18n._("True", {}),
     i18n._("Try again", {}),
-    i18n._("Undo", {}),
-    i18n._("Use the interactive graph to define a correct transformation.", {}),
     i18n._("Value", {}),
     i18n._("We could not understand your answer. Please check your answer for extra text or symbols.", {}),
     i18n._("We couldn't grade your answer.", {}),
@@ -152,5 +124,4 @@ module.exports = [
     i18n._("Your answer is almost correct, but it needs to be simplified.", {}),
     i18n._("Your answer is close, but you may have approximated pi. Enter your answer as a multiple of pi, like <code>12\\ \\text{pi}</code> or <code>2/3\\ \\text{pi}</code>", {}),
     i18n._("Your answer:", {}),
-    i18n._("Your transformation must use a %(type)s.", {}),
 ];

package/dist/types.d.ts

@@ -1,4 +1,3 @@
-import type { SerializedHighlightSet } from "./components/highlighting/types";
 import type { ILogger } from "./logging/log";
 import type { Item } from "./multi-items/item-types";
 import type { PerseusAnswerArea, PerseusRenderer, PerseusWidget } from "./perseus-types";
@@ -65,9 +64,6 @@ export type ChangeHandler = (arg1: {
     choiceStates?: ReadonlyArray<ChoiceState>;
     currentValue?: string;
     selected?: number;
-    tools?: ReadonlyArray<any>;
-    transformations?: ReadonlyArray<any>;
-    highlights?: SerializedHighlightSet;
     plot?: any;
 }, callback?: () => unknown | null | undefined, silent?: boolean) => unknown;
 export type ImageUploader = (file: string, callback: (url: string) => unknown) => unknown;
@@ -107,6 +103,7 @@ export type APIOptions = Readonly<{
     inModal?: boolean;
     crossOutEnabled?: boolean;
     editorChangeDelay?: number;
+    onWidgetStartProps?: (widgets: PerseusWidgetMap) => PerseusWidgetMap;
 }>;
 type TeXProps = {
     children: string;
@@ -246,6 +243,9 @@ export type WidgetExports<T extends React.ComponentType<any> = React.ComponentTy
     };
     widget: T;
 }>;
+export type PerseusWidgetMap = {
+    [key: string]: PerseusWidget;
+};
 export type FilterCriterion = string | ((id: string, widgetInfo: PerseusWidget, widget?: Widget | null | undefined) => boolean);
 export type WidgetProps<RenderProps, Rubric, TrackingExtraArgs = Empty> = RenderProps & {
     widgetId: string;

package/dist/util/geometry.d.ts

@@ -15,6 +15,8 @@ export declare function ccw(a: Coord, b: Coord, c: Coord): number;
 export declare function collinear(a: Coord, b: Coord, c: Coord): boolean;
 export declare function intersects(ab: Line, cd: Line): boolean;
 export declare function vector(a: any, b: any): number[];
+export declare function reverseVector(vector: Coord): Coord;
+export declare function clockwise(points: Coord[]): boolean;
 export declare function magnitude(v: ReadonlyArray<Coord>): number;
 export declare function angleMeasures(coords: ReadonlyArray<Coord>): ReadonlyArray<number>;
 export declare function similar(coords1: ReadonlyArray<Coord>, coords2: ReadonlyArray<Coord>, tolerance: number): boolean;

package/dist/util/graphie.d.ts

@@ -1,4 +1,110 @@
+import type { Interval } from "./interval";
 import type { Coord } from "../interactive2/types";
-export declare function polar(r: number | Coord, th: number): number[];
+export declare function polar(r: number | Coord, th: number): Coord;
+interface RaphaelElement {
+    type: string;
+    attrs: Record<string, any>;
+    node: {
+        style: {
+            shapeRendering: "crispEdges" | "geometricPrecision";
+        };
+    };
+}
+type PositionedShape = {
+    wrapper: HTMLDivElement;
+    visibleShape: RaphaelElement;
+};
+export type StyleParams = {
+    fill?: string;
+    labelDistance?: number;
+    opacity?: number;
+    step?: Coord;
+    stroke?: string;
+    strokeWidth?: number;
+};
+type LabelPosition = "center" | "above" | "below" | "right" | "left" | "above right" | "above left" | "below right" | "below left";
+interface LabelMethod {
+    (point: Coord, text: string, position: LabelPosition): any;
+    (point: Coord, text: string, position: LabelPosition, renderTex: boolean): any;
+    (point: Coord, text: string, position: LabelPosition, style: StyleParams): any;
+    (point: Coord, text: string, position: LabelPosition, renderTex: boolean, style: StyleParams): any;
+}
+export declare class Graphie {
+    #private;
+    el: HTMLElement;
+    raphael?: any;
+    isMobile: boolean;
+    currentStyle: any;
+    range?: [Interval, Interval];
+    scale?: Coord;
+    dimensions?: Coord;
+    xpixels?: number;
+    ypixels?: number;
+    constructor(el: HTMLElement);
+    init(options: {
+        range?: [Interval, Interval];
+        scale?: number | Coord;
+        isMobile?: boolean;
+    }): this;
+    graphInit(options: {
+        range?: [Interval, Interval] | Coord;
+        grid?: boolean;
+        gridRange?: [Interval, Interval] | Coord;
+        scale: Coord | number;
+        axes?: true;
+        axisArrows?: "<->" | "->" | true | "";
+        axisOpacity?: number;
+        axisCenter?: Coord;
+        axisLabels?: [string, string] | false;
+        gridOpacity?: number;
+        gridStep?: Coord | number;
+        ticks?: boolean;
+        tickStep?: Coord | number;
+        tickLen?: Coord | number;
+        tickOpacity?: number;
+        labels?: boolean;
+        labelStep?: number;
+        labelOpacity?: number;
+        labelFormat?: (a: number) => string;
+        yLabelFormat?: (y: number) => string;
+        xLabelFormat?: (x: number) => string;
+        unityLabels?: boolean | [boolean, boolean];
+        isMobile?: boolean;
+    }): void;
+    private drawingTransform;
+    private bounds;
+    style(attrs: any, fn: any): any;
+    grid(xr: Interval, yr: Interval, style?: StyleParams): unknown;
+    arc(center: Coord, radius: Coord, startAngle: number, endAngle: number, sector: boolean, style?: StyleParams): RaphaelElement;
+    circle(center: Coord, radius: number, style?: StyleParams): any;
+    rect(x: any, y: any, width: any, height: any, style?: StyleParams): any;
+    ellipse(center: any, radii: any, style?: StyleParams): any;
+    fixedEllipse(center: number | Coord, radii: number | [number, number], maxScale: number, padding: number, style?: StyleParams): PositionedShape;
+    private unstyledPath;
+    path(points: Coord[], style?: StyleParams): RaphaelElement;
+    fixedPath(points: Coord[], center: Coord | null, createPath: (scaledPoints: Coord[]) => string): PositionedShape;
+    scaledPath(points: Coord[], style?: StyleParams): RaphaelElement;
+    line(start: Coord, end: Coord, style?: StyleParams): RaphaelElement;
+    parabola(a: number, b: number, c: number, style?: StyleParams): RaphaelElement;
+    fixedLine(start: Coord, end: Coord, thickness: number): PositionedShape;
+    sinusoid(a: number, b: number, c: number, d: number, style?: StyleParams): RaphaelElement;
+    label: LabelMethod;
+    plotParametric(fn: (t: number) => Coord, range: Interval, style?: StyleParams): RaphaelElement;
+    plot(fn: (x: number) => number, range: Interval, style?: StyleParams): RaphaelElement;
+    svgPath: (points: (Coord | true)[], alreadyScaled?: boolean) => string;
+    svgParabolaPath: (a: any, b: any, c: any) => string;
+    svgSinusoidPath: (a: number, b: number, c: number, d: number) => string;
+    private withStyle;
+    private postprocessDrawingResult;
+    private addArrowheads;
+    scalePoint: (point: number | Coord) => Coord;
+    scaleVector: (point: number | Coord) => any;
+    unscalePoint: (point: Coord) => any;
+    unscaleVector: (point: Coord) => any;
+    private processAttributes;
+}
+type RangeSpecifier = [Interval, Interval] | Coord | number;
+export declare function normalizeRange(range: RangeSpecifier): [Interval, Interval];
+export declare function normalizeRange(range: RangeSpecifier | undefined): [Interval, Interval] | undefined;
 declare const GraphUtils: any;
 export default GraphUtils;

package/dist/util/math.d.ts

@@ -25,4 +25,6 @@ declare const KhanMath: {
     readonly getNumericFormat: (text: string) => MathFormat | null | undefined;
     readonly toNumericString: (number: number, format?: MathFormat) => string;
 };
+export declare function sum(array: number[]): number;
+export declare function add(a: number, b: number): number;
 export default KhanMath;

package/dist/util/parse-perseus-json.d.ts

@@ -1,10 +1,10 @@
 import type { PerseusItem } from "../perseus-types";
 /**
- * Helper to parse Perseus JSON
+ * Helper to parse PerseusItem JSON
  * Why not just use JSON.parse? We want:
  * - To make sure types are correct
  * - To give us a central place to validate/transform output if needed
- * @param {string} input - the stringified Perseus JSON
+ * @param {string} json - the stringified PerseusItem JSON
  * @returns {PerseusItem} the parsed PerseusItem object
  */
-export default function parsePerseusJSON(input: string): PerseusItem;
+export declare function parsePerseusItem(json: string): PerseusItem;

package/dist/widgets/expression.d.ts

@@ -121,6 +121,7 @@ declare const _default: Readonly<{
             inModal?: boolean | undefined;
             crossOutEnabled?: boolean | undefined;
             editorChangeDelay?: number | undefined;
+            onWidgetStartProps?: ((widgets: import("../types").PerseusWidgetMap) => import("../types").PerseusWidgetMap) | undefined;
         }> & {
             GroupMetadataEditor: NonNullable<React.ComponentType<any> | undefined>;
             baseElements: {
@@ -184,6 +185,7 @@ declare const _default: Readonly<{
             inModal?: boolean | undefined;
             crossOutEnabled?: boolean | undefined;
             editorChangeDelay?: number | undefined;
+            onWidgetStartProps?: ((widgets: import("../types").PerseusWidgetMap) => import("../types").PerseusWidgetMap) | undefined;
         }> & {
             GroupMetadataEditor: NonNullable<React.ComponentType<any> | undefined>;
             baseElements: {
@@ -210,7 +212,7 @@ declare const _default: Readonly<{
         onFocus: (blurPath: import("../types").FocusPath) => void;
         times: boolean;
         value: string;
-    }, "static" | "trackInteraction" | "onChange" | "analytics" | "problemNum" | "questionCompleted" | "keypadElement" | "alignment" | "buttonsVisible" | "containerSizeClass" | "widgetId" | "findWidgets" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
+    }, "trackInteraction" | "onChange" | "static" | "analytics" | "problemNum" | "questionCompleted" | "keypadElement" | "alignment" | "buttonsVisible" | "containerSizeClass" | "widgetId" | "findWidgets" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
         value?: string | undefined;
         onFocus?: ((blurPath: import("../types").FocusPath) => void) | undefined;
         onBlur?: ((blurPath: import("../types").FocusPath) => void) | undefined;
@@ -247,6 +249,7 @@ declare const _default: Readonly<{
             inModal?: boolean | undefined;
             crossOutEnabled?: boolean | undefined;
             editorChangeDelay?: number | undefined;
+            onWidgetStartProps?: ((widgets: import("../types").PerseusWidgetMap) => import("../types").PerseusWidgetMap) | undefined;
         }> & {
             GroupMetadataEditor: NonNullable<React.ComponentType<any> | undefined>;
             baseElements: {
@@ -321,6 +324,7 @@ declare const _default: Readonly<{
             inModal?: boolean | undefined;
             crossOutEnabled?: boolean | undefined;
             editorChangeDelay?: number | undefined;
+            onWidgetStartProps?: ((widgets: import("../types").PerseusWidgetMap) => import("../types").PerseusWidgetMap) | undefined;
         }> & {
             GroupMetadataEditor: NonNullable<React.ComponentType<any> | undefined>;
             baseElements: {
@@ -384,6 +388,7 @@ declare const _default: Readonly<{
             inModal?: boolean | undefined;
             crossOutEnabled?: boolean | undefined;
             editorChangeDelay?: number | undefined;
+            onWidgetStartProps?: ((widgets: import("../types").PerseusWidgetMap) => import("../types").PerseusWidgetMap) | undefined;
         }> & {
             GroupMetadataEditor: NonNullable<React.ComponentType<any> | undefined>;
             baseElements: {
@@ -410,7 +415,7 @@ declare const _default: Readonly<{
         onFocus: (blurPath: import("../types").FocusPath) => void;
         times: boolean;
         value: string;
-    }, "static" | "trackInteraction" | "onChange" | "analytics" | "problemNum" | "questionCompleted" | "keypadElement" | "alignment" | "buttonsVisible" | "containerSizeClass" | "widgetId" | "findWidgets" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
+    }, "trackInteraction" | "onChange" | "static" | "analytics" | "problemNum" | "questionCompleted" | "keypadElement" | "alignment" | "buttonsVisible" | "containerSizeClass" | "widgetId" | "findWidgets" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
         value?: string | undefined;
         onFocus?: ((blurPath: import("../types").FocusPath) => void) | undefined;
         onBlur?: ((blurPath: import("../types").FocusPath) => void) | undefined;
@@ -447,6 +452,7 @@ declare const _default: Readonly<{
             inModal?: boolean | undefined;
             crossOutEnabled?: boolean | undefined;
             editorChangeDelay?: number | undefined;
+            onWidgetStartProps?: ((widgets: import("../types").PerseusWidgetMap) => import("../types").PerseusWidgetMap) | undefined;
         }> & {
             GroupMetadataEditor: NonNullable<React.ComponentType<any> | undefined>;
             baseElements: {

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

@@ -120,6 +120,7 @@ declare const _default: Readonly<{
             inModal?: boolean | undefined;
             crossOutEnabled?: boolean | undefined;
             editorChangeDelay?: number | undefined;
+            onWidgetStartProps?: ((widgets: import("../types").PerseusWidgetMap) => import("../types").PerseusWidgetMap) | undefined;
         }>;
         choices: readonly string[];
         imageAlt: string;
@@ -179,6 +180,7 @@ declare const _default: Readonly<{
             inModal?: boolean | undefined;
             crossOutEnabled?: boolean | undefined;
             editorChangeDelay?: number | undefined;
+            onWidgetStartProps?: ((widgets: import("../types").PerseusWidgetMap) => import("../types").PerseusWidgetMap) | undefined;
         }>;
         choices: readonly string[];
         imageAlt: string;

package/dist/widgets.d.ts

@@ -9,7 +9,7 @@ export declare const registerWidgets: (widgets: ReadonlyArray<WidgetExports>) =>
  * @param name - the widget that you are trying to replace
  * @param replacementName - the name of the widget that takes its place
  *
- * e.g. replaceWidget("transformer", "always-correct") will make it so the
+ * e.g. replaceWidget("transformer", "deprecated-standin") will make it so the
  * transformer widget is replaced by the always correct widget
  */
 export declare const replaceWidget: (name: string, replacementName: string) => void;

package/package.json

@@ -3,7 +3,7 @@
     "description": "Core Perseus API (includes renderers and widgets)",
     "author": "Khan Academy",
     "license": "MIT",
-    "version": "18.0.1",
+    "version": "19.1.0",
     "publishConfig": {
         "access": "public"
     },
@@ -23,8 +23,8 @@
     },
     "dependencies": {
         "@khanacademy/kas": "^0.3.7",
-        "@khanacademy/kmath": "^0.1.8",
-        "@khanacademy/math-input": "^16.5.1",
+        "@khanacademy/kmath": "^0.1.9",
+        "@khanacademy/math-input": "^17.0.0",
         "@khanacademy/perseus-core": "1.4.1",
         "@khanacademy/perseus-linter": "^0.3.10",
         "@khanacademy/pure-markdown": "^0.2.13",
@@ -63,7 +63,6 @@
         "jquery": "^2.1.1",
         "katex": "^0.11.1",
         "lodash.debounce": "^4.0.8",
-        "mathquill": "git+https://git@github.com/Khan/mathquill.git#48410e80d760bbd5105544d4a4ab459a28dc2cbc",
         "perseus-build-settings": "^0.3.0",
         "prop-types": "^15.6.1",
         "react": "16.14.0",