@khanacademy/perseus 24.3.0 → 25.1.0

package/dist/logging/log.d.ts

@@ -1,45 +1,5 @@
+import type { ErrorKind } from "@khanacademy/perseus-core";
 import type { Metadata } from "@khanacademy/wonder-stuff-core";
-/**
- * @typedef {Object} Errors utility for referencing the Perseus error taxonomy.
- */
-export declare const Errors: Readonly<{
-    /**
-     * @property {ErrorKind} Unknown The kind of error is not known.
-     */
-    Unknown: "Unknown";
-    /**
-     * @property {ErrorKind} Internal The error is internal to the executing code.
-     */
-    Internal: "Internal";
-    /**
-     * @property {ErrorKind} InvalidInput There was a problem with the provided
-     * input, such as the wrong format or a null value.
-     */
-    InvalidInput: "InvalidInput";
-    /**
-     * @property {ErrorKind} NotAllowed There was a problem due to the state of
-     * the system not matching the requested operation or input. For example,
-     * trying to create a username that is valid, but is already taken by
-     * another user. Use {@link InvalidInput} instead when the input isn't
-     * valid regardless of the state of the system. Use {@link NotFound} when
-     * the failure is due to not being able to find a resource.
-     */
-    NotAllowed: "NotAllowed";
-    /**
-     * @property {ErrorKind} TransientService There was a problem when making a
-     * request to a service.
-     */
-    TransientService: "TransientService";
-    /**
-     * @property {ErrorKind} Service There was a non-transient problem when
-     * making a request to service.
-     */
-    Service: "Service";
-}>;
-/**
- * @type {ErrorKind} The kind of error being reported
- */
-export type ErrorKind = (typeof Errors)[keyof typeof Errors];
 export type LogErrorOptions = {
     cause?: Error | null | undefined;
     loggedMetadata?: Metadata | null | undefined;

package/dist/perseus-api.d.ts

@@ -106,6 +106,8 @@ export declare const ApiOptions: {
             } & {
                 "interactive-graph-locked-features-m2"?: boolean | undefined;
                 "interactive-graph-locked-features-m2b"?: boolean | undefined;
+            } & {
+                "start-coords-ui"?: boolean | undefined;
             }) | undefined;
         } | undefined;
         onWidgetStartProps?: ((widgets: import("./perseus-types").PerseusWidgetsMap) => void) | undefined;

package/dist/perseus-types.d.ts

@@ -417,24 +417,29 @@ export type PerseusGraphTypeAngle = {
     snapDegrees?: number;
     match?: "congruent";
     coords?: [Coord, Coord, Coord];
+    startCoords?: [Coord, Coord, Coord];
 };
 export type PerseusGraphTypeCircle = {
     type: "circle";
     center?: Coord;
     radius?: number;
+    startCoords?: Coord;
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeLinear = {
     type: "linear";
     coords?: CollinearTuple;
+    startCoords?: CollinearTuple;
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeLinearSystem = {
     type: "linear-system";
     coords?: CollinearTuple[];
+    startCoords?: CollinearTuple[];
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypePoint = {
     type: "point";
     numPoints?: number | "unlimited";
     coords?: ReadonlyArray<Coord>;
+    startCoords?: ReadonlyArray<Coord>;
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypePolygon = {
     type: "polygon";
@@ -444,23 +449,28 @@ export type PerseusGraphTypePolygon = {
     snapTo?: "grid" | "angles" | "sides";
     match?: "similar" | "congruent" | "approx";
     coords?: ReadonlyArray<Coord>;
+    startCoords?: ReadonlyArray<Coord>;
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeQuadratic = {
     type: "quadratic";
     coords?: [Coord, Coord, Coord];
+    startCoords?: [Coord, Coord, Coord];
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeSegment = {
     type: "segment";
     numSegments?: number;
     coords?: CollinearTuple[];
+    startCoords?: CollinearTuple[];
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeSinusoid = {
     type: "sinusoid";
     coords?: ReadonlyArray<Coord>;
+    startCoords?: ReadonlyArray<Coord>;
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeRay = {
     type: "ray";
     coords?: CollinearTuple;
+    startCoords?: CollinearTuple;
 } & PerseusGraphTypeCommon;
 export type PerseusLabelImageWidgetOptions = {
     choices: ReadonlyArray<string>;

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

@@ -105,7 +105,7 @@ 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, "item" | "problemNum" | "keypadElement" | "showSolutions" | "reviewMode" | "dependencies" | "hintsVisible"> & {
+declare const ref: React.ForwardRefExoticComponent<Omit<Pick<OwnProps & HOCProps, "problemNum" | "keypadElement" | "showSolutions" | "reviewMode" | "item" | "dependencies" | "hintsVisible"> & {
     apiOptions?: Readonly<{
         isArticle?: boolean | undefined;
         onInputError?: ((widgetId: any, value: string, message?: string | null | undefined) => unknown) | undefined;
@@ -153,6 +153,8 @@ declare const ref: React.ForwardRefExoticComponent<Omit<Pick<OwnProps & HOCProps
             } & {
                 "interactive-graph-locked-features-m2"?: boolean | undefined;
                 "interactive-graph-locked-features-m2b"?: boolean | undefined;
+            } & {
+                "start-coords-ui"?: boolean | undefined;
             }) | undefined;
         } | undefined;
         onWidgetStartProps?: ((widgets: import("./perseus-types").PerseusWidgetsMap) => void) | undefined;

package/dist/types.d.ts

@@ -79,6 +79,7 @@ type TrackInteractionArgs = {
 } & Partial<TrackingGradedGroupExtraArguments> & Partial<TrackingSequenceExtraArguments>;
 export declare const MafsGraphTypeFlags: readonly ["angle", "segment", "linear", "linear-system", "ray", "polygon", "circle", "quadratic", "sinusoid", "point"];
 export declare const InteractiveGraphLockedFeaturesFlags: readonly ["interactive-graph-locked-features-m2", "interactive-graph-locked-features-m2b"];
+export declare const InteractiveGraphEditorFlags: readonly ["start-coords-ui"];
 /**
  * APIOptions provides different ways to customize the behaviour of Perseus.
  *
@@ -206,6 +207,8 @@ export type APIOptions = Readonly<{
             [Key in (typeof MafsGraphTypeFlags)[number]]?: boolean;
         } & {
             [Key in (typeof InteractiveGraphLockedFeaturesFlags)[number]]?: boolean;
+        } & {
+            [Key in (typeof InteractiveGraphEditorFlags)[number]]?: boolean;
         });
     };
     /**

package/dist/widgets/expression.d.ts

@@ -147,6 +147,8 @@ declare const _default: Readonly<{
                 } & {
                     "interactive-graph-locked-features-m2"?: boolean | undefined;
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
+                } & {
+                    "start-coords-ui"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -226,6 +228,8 @@ declare const _default: Readonly<{
                 } & {
                     "interactive-graph-locked-features-m2"?: boolean | undefined;
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
+                } & {
+                    "start-coords-ui"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -254,9 +258,9 @@ declare const _default: Readonly<{
         times: boolean;
         value: string;
     }, "onChange" | "analytics" | "buttonsVisible" | "static" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "trackInteraction" | "keypadElement" | "keypadConfiguration" | "alignment" | "reviewModeRubric" | "isLastUsedWidget"> & {
+        value?: string | undefined;
         onFocus?: ((blurPath: import("../types").FocusPath) => void) | undefined;
         onBlur?: ((blurPath: import("../types").FocusPath) => void) | undefined;
-        value?: string | undefined;
         buttonSets?: import("../perseus-types").LegacyButtonSets | undefined;
         apiOptions?: Readonly<Readonly<{
             isArticle?: boolean | undefined;
@@ -305,6 +309,8 @@ declare const _default: Readonly<{
                 } & {
                     "interactive-graph-locked-features-m2"?: boolean | undefined;
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
+                } & {
+                    "start-coords-ui"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -381,6 +387,8 @@ declare const _default: Readonly<{
                 } & {
                     "interactive-graph-locked-features-m2"?: boolean | undefined;
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
+                } & {
+                    "start-coords-ui"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -460,6 +468,8 @@ declare const _default: Readonly<{
                 } & {
                     "interactive-graph-locked-features-m2"?: boolean | undefined;
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
+                } & {
+                    "start-coords-ui"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -488,9 +498,9 @@ declare const _default: Readonly<{
         times: boolean;
         value: string;
     }, "onChange" | "analytics" | "buttonsVisible" | "static" | "containerSizeClass" | "widgetId" | "problemNum" | "questionCompleted" | "findWidgets" | "trackInteraction" | "keypadElement" | "keypadConfiguration" | "alignment" | "reviewModeRubric" | "isLastUsedWidget"> & {
+        value?: string | undefined;
         onFocus?: ((blurPath: import("../types").FocusPath) => void) | undefined;
         onBlur?: ((blurPath: import("../types").FocusPath) => void) | undefined;
-        value?: string | undefined;
         buttonSets?: import("../perseus-types").LegacyButtonSets | undefined;
         apiOptions?: Readonly<Readonly<{
             isArticle?: boolean | undefined;
@@ -539,6 +549,8 @@ declare const _default: Readonly<{
                 } & {
                     "interactive-graph-locked-features-m2"?: boolean | undefined;
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
+                } & {
+                    "start-coords-ui"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../perseus-types").PerseusWidgetsMap) => void) | undefined;

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

@@ -1,6 +1,4 @@
-import type { CollinearTuple } from "../../../perseus-types";
 import type { Interval, vec } from "mafs";
-export declare function calculateAngleInDegrees([x, y]: vec.Vector2): number;
 /**
  * Given a ray and a rectangular box, find the point where the ray intersects
  * the edge of the box. Assumes the `initialPoint` is inside the box.
@@ -9,4 +7,3 @@ export declare function calculateAngleInDegrees([x, y]: vec.Vector2): number;
  * @param box - The box with which to intersect the ray, in the form [[xMin, xMax], [yMin, yMax]]
  */
 export declare const getIntersectionOfRayWithBox: (initialPoint: vec.Vector2, throughPoint: vec.Vector2, box: [x: Interval, y: Interval]) => [number, number];
-export declare const getLines: (points: readonly vec.Vector2[]) => CollinearTuple[];

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

@@ -1 +1 @@
-export { StatefulMafsGraph } from "./mafs-graph";
+export { StatefulMafsGraph } from "./stateful-mafs-graph";

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

@@ -1,27 +1,8 @@
 import * as React from "react";
 import { type InteractiveGraphAction } from "./reducer/interactive-graph-action";
 import type { InteractiveGraphState, InteractiveGraphProps } from "./types";
-import type { PerseusGraphType } from "../../perseus-types";
-import type { Widget } from "../../renderer";
 import "mafs/core.css";
 import "./mafs-styles.css";
-export type StatefulMafsGraphProps = {
-    box: [number, number];
-    backgroundImage?: InteractiveGraphProps["backgroundImage"];
-    graph: PerseusGraphType;
-    lockedFigures?: InteractiveGraphProps["lockedFigures"];
-    range: InteractiveGraphProps["range"];
-    snapStep: InteractiveGraphProps["snapStep"];
-    step: InteractiveGraphProps["step"];
-    gridStep: InteractiveGraphProps["gridStep"];
-    containerSizeClass: InteractiveGraphProps["containerSizeClass"];
-    markings: InteractiveGraphProps["markings"];
-    onChange: InteractiveGraphProps["onChange"];
-    showTooltips: Required<InteractiveGraphProps["showTooltips"]>;
-    showProtractor: boolean;
-    labels: InteractiveGraphProps["labels"];
-};
-export declare const StatefulMafsGraph: React.ForwardRefExoticComponent<StatefulMafsGraphProps & React.RefAttributes<Partial<Widget>>>;
 export type MafsGraphProps = {
     box: [number, number];
     backgroundImage?: InteractiveGraphProps["backgroundImage"];

package/dist/widgets/interactive-graphs/math/angles.d.ts

@@ -1,3 +1,5 @@
 import type { vec } from "mafs";
+export declare function convertDegreesToRadians(degrees: number): number;
+export declare function calculateAngleInDegrees([x, y]: vec.Vector2): number;
 export declare function polar(r: number | vec.Vector2, th: number): vec.Vector2;
 export declare const findAngle: (point1: vec.Vector2, point2: vec.Vector2, vertex?: vec.Vector2) => number;

package/dist/widgets/interactive-graphs/math/geometry.d.ts

@@ -0,0 +1,3 @@
+import type { vec } from "mafs";
+export type Segment = [vec.Vector2, vec.Vector2];
+export declare const segmentsIntersect: ([[a, b], [c, d]]: Segment, [[p, q], [r, s]]: Segment) => boolean;

package/dist/widgets/interactive-graphs/math/index.d.ts

@@ -3,4 +3,6 @@ export { snap } from "./snap";
 export { inset, clampToBox } from "./box";
 export { X, Y } from "./coordinates";
 export { MIN, MAX, size } from "./interval";
-export { findAngle, polar } from "./angles";
+export { lerp } from "./interpolation";
+export { segmentsIntersect } from "./geometry";
+export { calculateAngleInDegrees, convertDegreesToRadians, findAngle, polar, } from "./angles";

package/dist/widgets/interactive-graphs/math/interpolation.d.ts

@@ -0,0 +1 @@
+export declare function lerp(a: number, b: number, fraction: number): number;

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

@@ -1,5 +1,5 @@
-import type { PerseusGraphType } from "../../../perseus-types";
-import type { InteractiveGraphState } from "../types";
+import type { PerseusGraphType, PerseusGraphTypeLinear, PerseusGraphTypeRay } from "../../../perseus-types";
+import type { InteractiveGraphState, PairOfPoints } from "../types";
 import type { Interval } from "mafs";
 export type InitializeGraphStateParams = {
     range: [x: Interval, y: Interval];
@@ -8,3 +8,4 @@ export type InitializeGraphStateParams = {
     graph: PerseusGraphType;
 };
 export declare function initializeGraphState(params: InitializeGraphStateParams): InteractiveGraphState;
+export declare function getLineCoords(graph: PerseusGraphTypeRay | PerseusGraphTypeLinear, range: [x: Interval, y: Interval], step: [x: number, y: number]): PairOfPoints;

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

@@ -0,0 +1,21 @@
+import * as React from "react";
+import type { InteractiveGraphProps } from "./types";
+import type { Widget } from "../../renderer";
+import type { PerseusGraphType } from "@khanacademy/perseus";
+export type StatefulMafsGraphProps = {
+    box: [number, number];
+    backgroundImage?: InteractiveGraphProps["backgroundImage"];
+    graph: PerseusGraphType;
+    lockedFigures?: InteractiveGraphProps["lockedFigures"];
+    range: InteractiveGraphProps["range"];
+    snapStep: InteractiveGraphProps["snapStep"];
+    step: InteractiveGraphProps["step"];
+    gridStep: InteractiveGraphProps["gridStep"];
+    containerSizeClass: InteractiveGraphProps["containerSizeClass"];
+    markings: InteractiveGraphProps["markings"];
+    onChange: InteractiveGraphProps["onChange"];
+    showTooltips: Required<InteractiveGraphProps["showTooltips"]>;
+    showProtractor: boolean;
+    labels: InteractiveGraphProps["labels"];
+};
+export declare const StatefulMafsGraph: React.ForwardRefExoticComponent<StatefulMafsGraphProps & React.RefAttributes<Partial<Widget>>>;

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

@@ -141,6 +141,8 @@ declare const _default: Readonly<{
                 } & {
                     "interactive-graph-locked-features-m2"?: boolean | undefined;
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
+                } & {
+                    "start-coords-ui"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("..").PerseusWidgetsMap) => void) | undefined;
@@ -204,6 +206,8 @@ declare const _default: Readonly<{
                 } & {
                     "interactive-graph-locked-features-m2"?: boolean | undefined;
                     "interactive-graph-locked-features-m2b"?: boolean | undefined;
+                } & {
+                    "start-coords-ui"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("..").PerseusWidgetsMap) => void) | undefined;

package/package.json

@@ -3,7 +3,7 @@
     "description": "Core Perseus API (includes renderers and widgets)",
     "author": "Khan Academy",
     "license": "MIT",
-    "version": "24.3.0",
+    "version": "25.1.0",
     "publishConfig": {
         "access": "public"
     },
@@ -39,13 +39,13 @@
         "test": "bash -c 'yarn --silent --cwd \"../..\" test ${@:0} $($([[ ${@: -1} = -* ]] || [[ ${@: -1} = bash ]]) && echo $PWD)'"
     },
     "dependencies": {
-        "@khanacademy/kas": "^0.3.9",
-        "@khanacademy/kmath": "^0.1.12",
-        "@khanacademy/math-input": "^19.2.0",
-        "@khanacademy/perseus-core": "1.4.2",
-        "@khanacademy/perseus-linter": "^0.4.0",
-        "@khanacademy/pure-markdown": "^0.3.5",
-        "@khanacademy/simple-markdown": "^0.12.0",
+        "@khanacademy/kas": "^0.3.10",
+        "@khanacademy/kmath": "^0.1.13",
+        "@khanacademy/math-input": "^19.2.1",
+        "@khanacademy/perseus-core": "1.5.0",
+        "@khanacademy/perseus-linter": "^1.0.0",
+        "@khanacademy/pure-markdown": "^0.3.6",
+        "@khanacademy/simple-markdown": "^0.12.1",
         "@use-gesture/react": "^10.2.27",
         "mafs": "0.18.7"
     },

package/dist/perseus-error.d.ts

@@ -1,11 +0,0 @@
-import type { ErrorKind } from "./logging/log";
-import type { Metadata } from "@khanacademy/wonder-stuff-core";
-type Options = {
-    metadata?: Metadata | null | undefined;
-};
-export declare class PerseusError extends Error {
-    kind: ErrorKind;
-    metadata: Metadata | null | undefined;
-    constructor(message: string, kind: ErrorKind, options?: Options);
-}
-export {};