@khanacademy/perseus 28.2.0 → 29.0.0

package/dist/interactive2/arrowhead.d.ts

@@ -1,6 +1,6 @@
 import WrappedPath from "./wrapped-path";
+import type { Coord } from "./types";
 import type { Graphie } from "../util/graphie";
-import type { Coord } from "@khanacademy/perseus";
 export declare class Arrowhead extends WrappedPath {
     private static scale;
     center: Coord;

package/dist/interactive2/get-clip-point.d.ts

@@ -1,2 +1,2 @@
-import type { Coord } from "@khanacademy/perseus";
+import type { Coord } from "./types";
 export declare const getClipPoint: (graph: any, coord: Coord, angle: number) => any;

package/dist/interactive2/movable-point.d.ts

@@ -1,7 +1,6 @@
 import type { Movable } from "./movable";
-import type { Constraint, ConstraintCallbacks } from "./types";
+import type { Constraint, ConstraintCallbacks, Coord } from "./types";
 import type { Graphie } from "../util/graphie";
-import type { Coord } from "@khanacademy/perseus";
 type State = {
     add: unknown[];
     added: boolean;

package/dist/perseus-api.d.ts

@@ -96,13 +96,13 @@ export declare const ApiOptions: {
                 circle?: boolean | undefined;
                 polygon?: boolean | undefined;
                 linear?: boolean | undefined;
-                point?: boolean | undefined;
                 quadratic?: boolean | undefined;
                 sinusoid?: boolean | undefined;
-                angle?: boolean | undefined;
-                "linear-system"?: boolean | undefined;
+                point?: boolean | undefined;
                 ray?: boolean | undefined;
                 segment?: boolean | undefined;
+                angle?: boolean | undefined;
+                "linear-system"?: boolean | undefined;
             } & {
                 "interactive-graph-locked-features-m2b"?: boolean | undefined;
             } & {

package/dist/perseus-types.d.ts

@@ -75,14 +75,28 @@ export type PerseusWidgetsMap = {
 } & {
     [key in `video ${number}`]: VideoWidget;
 };
+/**
+ * A "PerseusItem" is a classic Perseus item. It is rendered by the
+ * `ServerItemRenderer` and the layout is pre-set.
+ *
+ * To render more complex Perseus items, see the `Item` type in the multi item
+ * area.
+ */
 export type PerseusItem = {
     question: PerseusRenderer;
     hints: ReadonlyArray<Hint>;
     answerArea: PerseusAnswerArea | null | undefined;
-    _multi: any;
     itemDataVersion: Version;
     answer: any;
 };
+/**
+ * A "MultiItem" is an advanced Perseus item. It is rendered by the
+ * `MultiRenderer` and you can control the layout of individual parts of the
+ * item.
+ */
+export type MultiItem = {
+    _multi: any;
+};
 export type PerseusArticle = ReadonlyArray<PerseusRenderer>;
 export type Version = {
     major: number;

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

@@ -105,7 +105,8 @@ export declare class ServerItemRenderer extends React.Component<Props, State> im
     setAssetStatus: (assetKey: string, status: boolean) => void;
     render(): React.ReactNode;
 }
-declare const ref: React.ForwardRefExoticComponent<Omit<Pick<OwnProps & HOCProps, "problemNum" | "keypadElement" | "showSolutions" | "reviewMode" | "item" | "dependencies" | "hintsVisible"> & {
+declare const ref: React.ForwardRefExoticComponent<Omit<Pick<OwnProps & HOCProps, "item" | "problemNum" | "showSolutions" | "reviewMode" | "keypadElement" | "hintsVisible" | "dependencies"> & {
+    linterContext?: PerseusLinter.LinterContextProps | undefined;
     apiOptions?: Readonly<{
         isArticle?: boolean | undefined;
         onInputError?: ((widgetId: any, value: string, message?: string | null | undefined) => unknown) | undefined;
@@ -143,13 +144,13 @@ declare const ref: React.ForwardRefExoticComponent<Omit<Pick<OwnProps & HOCProps
                 circle?: boolean | undefined;
                 polygon?: boolean | undefined;
                 linear?: boolean | undefined;
-                point?: boolean | undefined;
                 quadratic?: boolean | undefined;
                 sinusoid?: boolean | undefined;
-                angle?: boolean | undefined;
-                "linear-system"?: boolean | undefined;
+                point?: boolean | undefined;
                 ray?: boolean | undefined;
                 segment?: boolean | undefined;
+                angle?: boolean | undefined;
+                "linear-system"?: boolean | undefined;
             } & {
                 "interactive-graph-locked-features-m2b"?: boolean | undefined;
             } & {
@@ -162,7 +163,6 @@ declare const ref: React.ForwardRefExoticComponent<Omit<Pick<OwnProps & HOCProps
         } | undefined;
         onWidgetStartProps?: ((widgets: import("./perseus-types").PerseusWidgetsMap) => void) | undefined;
     }> | undefined;
-    linterContext?: PerseusLinter.LinterContextProps | undefined;
     onRendered?: ((isRendered: boolean) => void) | undefined;
 } & {}, "onRendered"> & React.RefAttributes<ServerItemRenderer>>;
 export default ref;

package/dist/util/fix-passage-refs.d.ts

@@ -1,2 +1,3 @@
-declare const FixPassageRefs: (itemData: any) => any;
-export default FixPassageRefs;
+import type { MultiItem, PerseusItem } from "../perseus-types";
+declare const fixPassageRefs: (itemData: PerseusItem | MultiItem) => any;
+export default fixPassageRefs;

package/dist/widgets/expression.d.ts

@@ -142,13 +142,13 @@ declare const _default: Readonly<{
                     circle?: boolean | undefined;
                     polygon?: boolean | undefined;
                     linear?: boolean | undefined;
-                    point?: boolean | undefined;
                     quadratic?: boolean | undefined;
                     sinusoid?: boolean | undefined;
-                    angle?: boolean | undefined;
-                    "linear-system"?: boolean | undefined;
+                    point?: boolean | undefined;
                     ray?: boolean | undefined;
                     segment?: boolean | undefined;
+                    angle?: boolean | undefined;
+                    "linear-system"?: boolean | undefined;
                 } & {
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 } & {
@@ -226,13 +226,13 @@ declare const _default: Readonly<{
                     circle?: boolean | undefined;
                     polygon?: boolean | undefined;
                     linear?: boolean | undefined;
-                    point?: boolean | undefined;
                     quadratic?: boolean | undefined;
                     sinusoid?: boolean | undefined;
-                    angle?: boolean | undefined;
-                    "linear-system"?: boolean | undefined;
+                    point?: boolean | undefined;
                     ray?: boolean | undefined;
                     segment?: boolean | undefined;
+                    angle?: boolean | undefined;
+                    "linear-system"?: boolean | undefined;
                 } & {
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 } & {
@@ -270,11 +270,11 @@ declare const _default: Readonly<{
         visibleLabel: string | undefined;
         ariaLabel: string | undefined;
         value: string;
-    }, "static" | "analytics" | "onChange" | "ariaLabel" | "buttonsVisible" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "trackInteraction" | "keypadElement" | "visibleLabel" | "keypadConfiguration" | "alignment" | "reviewModeRubric" | "isLastUsedWidget"> & {
+    }, "ariaLabel" | "trackInteraction" | "static" | "onChange" | "analytics" | "problemNum" | "questionCompleted" | "keypadElement" | "alignment" | "buttonsVisible" | "containerSizeClass" | "widgetId" | "findWidgets" | "visibleLabel" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
         value?: string | undefined;
-        buttonSets?: import("../perseus-types").LegacyButtonSets | undefined;
         onFocus?: ((blurPath: import("../types").FocusPath) => void) | undefined;
         onBlur?: ((blurPath: import("../types").FocusPath) => void) | undefined;
+        linterContext?: import("@khanacademy/perseus-linter").LinterContextProps | undefined;
         apiOptions?: Readonly<Readonly<{
             isArticle?: boolean | undefined;
             onInputError?: ((widgetId: any, value: string, message?: string | null | undefined) => unknown) | undefined;
@@ -312,13 +312,13 @@ declare const _default: Readonly<{
                     circle?: boolean | undefined;
                     polygon?: boolean | undefined;
                     linear?: boolean | undefined;
-                    point?: boolean | undefined;
                     quadratic?: boolean | undefined;
                     sinusoid?: boolean | undefined;
-                    angle?: boolean | undefined;
-                    "linear-system"?: boolean | undefined;
+                    point?: boolean | undefined;
                     ray?: boolean | undefined;
                     segment?: boolean | undefined;
+                    angle?: boolean | undefined;
+                    "linear-system"?: boolean | undefined;
                 } & {
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 } & {
@@ -347,9 +347,9 @@ declare const _default: Readonly<{
             setDrawingAreaAvailable: (arg1: boolean) => unknown;
             showAlignmentOptions: NonNullable<boolean | undefined>;
         }> | undefined;
+        buttonSets?: import("../perseus-types").LegacyButtonSets | undefined;
         functions?: readonly string[] | undefined;
         times?: boolean | undefined;
-        linterContext?: import("@khanacademy/perseus-linter").LinterContextProps | undefined;
     } & {}, "analytics"> & React.RefAttributes<Expression>>) | undefined;
     widget: React.ForwardRefExoticComponent<Omit<Pick<RenderProps & {
         widgetId: string;
@@ -393,13 +393,13 @@ declare const _default: Readonly<{
                     circle?: boolean | undefined;
                     polygon?: boolean | undefined;
                     linear?: boolean | undefined;
-                    point?: boolean | undefined;
                     quadratic?: boolean | undefined;
                     sinusoid?: boolean | undefined;
-                    angle?: boolean | undefined;
-                    "linear-system"?: boolean | undefined;
+                    point?: boolean | undefined;
                     ray?: boolean | undefined;
                     segment?: boolean | undefined;
+                    angle?: boolean | undefined;
+                    "linear-system"?: boolean | undefined;
                 } & {
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 } & {
@@ -477,13 +477,13 @@ declare const _default: Readonly<{
                     circle?: boolean | undefined;
                     polygon?: boolean | undefined;
                     linear?: boolean | undefined;
-                    point?: boolean | undefined;
                     quadratic?: boolean | undefined;
                     sinusoid?: boolean | undefined;
-                    angle?: boolean | undefined;
-                    "linear-system"?: boolean | undefined;
+                    point?: boolean | undefined;
                     ray?: boolean | undefined;
                     segment?: boolean | undefined;
+                    angle?: boolean | undefined;
+                    "linear-system"?: boolean | undefined;
                 } & {
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 } & {
@@ -521,11 +521,11 @@ declare const _default: Readonly<{
         visibleLabel: string | undefined;
         ariaLabel: string | undefined;
         value: string;
-    }, "static" | "analytics" | "onChange" | "ariaLabel" | "buttonsVisible" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "trackInteraction" | "keypadElement" | "visibleLabel" | "keypadConfiguration" | "alignment" | "reviewModeRubric" | "isLastUsedWidget"> & {
+    }, "ariaLabel" | "trackInteraction" | "static" | "onChange" | "analytics" | "problemNum" | "questionCompleted" | "keypadElement" | "alignment" | "buttonsVisible" | "containerSizeClass" | "widgetId" | "findWidgets" | "visibleLabel" | "keypadConfiguration" | "reviewModeRubric" | "isLastUsedWidget"> & {
         value?: string | undefined;
-        buttonSets?: import("../perseus-types").LegacyButtonSets | undefined;
         onFocus?: ((blurPath: import("../types").FocusPath) => void) | undefined;
         onBlur?: ((blurPath: import("../types").FocusPath) => void) | undefined;
+        linterContext?: import("@khanacademy/perseus-linter").LinterContextProps | undefined;
         apiOptions?: Readonly<Readonly<{
             isArticle?: boolean | undefined;
             onInputError?: ((widgetId: any, value: string, message?: string | null | undefined) => unknown) | undefined;
@@ -563,13 +563,13 @@ declare const _default: Readonly<{
                     circle?: boolean | undefined;
                     polygon?: boolean | undefined;
                     linear?: boolean | undefined;
-                    point?: boolean | undefined;
                     quadratic?: boolean | undefined;
                     sinusoid?: boolean | undefined;
-                    angle?: boolean | undefined;
-                    "linear-system"?: boolean | undefined;
+                    point?: boolean | undefined;
                     ray?: boolean | undefined;
                     segment?: boolean | undefined;
+                    angle?: boolean | undefined;
+                    "linear-system"?: boolean | undefined;
                 } & {
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 } & {
@@ -598,9 +598,9 @@ declare const _default: Readonly<{
             setDrawingAreaAvailable: (arg1: boolean) => unknown;
             showAlignmentOptions: NonNullable<boolean | undefined>;
         }> | undefined;
+        buttonSets?: import("../perseus-types").LegacyButtonSets | undefined;
         functions?: readonly string[] | undefined;
         times?: boolean | undefined;
-        linterContext?: import("@khanacademy/perseus-linter").LinterContextProps | undefined;
     } & {}, "analytics"> & React.RefAttributes<Expression>>;
     accessible?: boolean | ((props: any) => boolean) | undefined;
     hidden?: boolean | undefined;

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

@@ -1,5 +1,5 @@
+import type { Coord } from "../../interactive2/types";
 import type { CollinearTuple, LockedFigureColor, LockedFigureFillType, LockedFunctionType, PerseusRenderer } from "../../perseus-types";
-import type { Coord } from "@khanacademy/perseus";
 import type { vec } from "mafs";
 export type LockedFunctionOptions = Omit<Partial<LockedFunctionType>, "type" | "equation">;
 export declare function interactiveGraphQuestionBuilder(): InteractiveGraphQuestionBuilder;

package/dist/widgets/interactive-graphs/reducer/initialize-graph-state.d.ts

@@ -1,6 +1,6 @@
+import type { Coord } from "../../../interactive2/types";
 import type { PerseusGraphType, PerseusGraphTypeAngle, PerseusGraphTypeCircle, PerseusGraphTypeLinear, PerseusGraphTypeLinearSystem, PerseusGraphTypePoint, PerseusGraphTypePolygon, PerseusGraphTypeQuadratic, PerseusGraphTypeRay, PerseusGraphTypeSegment, PerseusGraphTypeSinusoid } from "../../../perseus-types";
 import type { InteractiveGraphState, PairOfPoints } from "../types";
-import type { Coord } from "@khanacademy/perseus";
 import type { Interval } from "mafs";
 export type InitializeGraphStateParams = {
     range: [x: Interval, y: Interval];

package/dist/widgets/interactive-graphs/reducer/interactive-graph-state.d.ts

@@ -1,5 +1,5 @@
+import type { PerseusGraphType } from "../../../perseus-types";
 import type { CircleGraphState, InteractiveGraphState } from "../types";
-import type { PerseusGraphType } from "@khanacademy/perseus";
 export declare function getGradableGraph(state: InteractiveGraphState, initialGraph: PerseusGraphType): PerseusGraphType;
 /**
  * determine radius of a circle graph

package/dist/widgets/interactive-graphs/stateful-mafs-graph.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import type { InteractiveGraphProps } from "./types";
+import type { PerseusGraphType } from "../../perseus-types";
 import type { Widget } from "../../renderer";
-import type { PerseusGraphType } from "@khanacademy/perseus";
 export type StatefulMafsGraphProps = {
     box: [number, number];
     backgroundImage?: InteractiveGraphProps["backgroundImage"];

package/dist/widgets/interactive-graphs/types.d.ts

@@ -1,7 +1,7 @@
 import type { InteractiveGraphAction } from "./reducer/interactive-graph-action";
+import type { Coord } from "../../interactive2/types";
 import type { PerseusInteractiveGraphWidgetOptions } from "../../perseus-types";
 import type { WidgetProps } from "../../types";
-import type { Coord } from "@khanacademy/perseus";
 import type { Interval, vec } from "mafs";
 export type InteractiveGraphProps = WidgetProps<PerseusInteractiveGraphWidgetOptions, PerseusInteractiveGraphWidgetOptions>;
 export type MafsGraphProps<T extends InteractiveGraphState> = {

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

@@ -134,13 +134,13 @@ declare const _default: Readonly<{
                     circle?: boolean | undefined;
                     polygon?: boolean | undefined;
                     linear?: boolean | undefined;
-                    point?: boolean | undefined;
                     quadratic?: boolean | undefined;
                     sinusoid?: boolean | undefined;
-                    angle?: boolean | undefined;
-                    "linear-system"?: boolean | undefined;
+                    point?: boolean | undefined;
                     ray?: boolean | undefined;
                     segment?: boolean | undefined;
+                    angle?: boolean | undefined;
+                    "linear-system"?: boolean | undefined;
                 } & {
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 } & {
@@ -202,13 +202,13 @@ declare const _default: Readonly<{
                     circle?: boolean | undefined;
                     polygon?: boolean | undefined;
                     linear?: boolean | undefined;
-                    point?: boolean | undefined;
                     quadratic?: boolean | undefined;
                     sinusoid?: boolean | undefined;
-                    angle?: boolean | undefined;
-                    "linear-system"?: boolean | undefined;
+                    point?: boolean | undefined;
                     ray?: boolean | undefined;
                     segment?: boolean | undefined;
+                    angle?: boolean | undefined;
+                    "linear-system"?: boolean | undefined;
                 } & {
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 } & {

package/dist/widgets/measurer.d.ts

@@ -5,10 +5,10 @@ declare const _default: Readonly<{
     widget: any;
     accessible?: boolean | ((props: any) => boolean) | undefined;
     hidden?: boolean | undefined;
-    version?: import("@khanacademy/perseus").Version | undefined;
-    supportedAlignments?: readonly import("@khanacademy/perseus").Alignment[] | undefined;
-    defaultAlignment?: import("@khanacademy/perseus").Alignment | undefined;
-    getDefaultAlignment?: (() => import("@khanacademy/perseus").Alignment) | 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;

package/package.json

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

package/dist/perseus-env.d.ts

@@ -1,3 +0,0 @@
-/**
- * Sets up the basic environment for running Perseus in.
- */