@khanacademy/perseus 32.0.1 → 33.1.0

package/dist/perseus-api.d.ts

@@ -105,14 +105,7 @@ export declare const ApiOptions: {
                 "linear-system"?: boolean | undefined;
                 "unlimited-point"?: boolean | undefined;
             } & {
-                "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 "interactive-graph-locked-features-labels"?: boolean | undefined;
-            } & {
-                "start-coords-ui-phase-1"?: boolean | undefined;
-                "start-coords-ui-phase-2"?: boolean | undefined;
-                "start-coords-ui-point"?: boolean | undefined;
-                "start-coords-ui-polygon"?: boolean | undefined;
-                "start-coords-ui-angle"?: boolean | undefined;
             }) | undefined;
         } | undefined;
         onWidgetStartProps?: ((widgets: import("./perseus-types").PerseusWidgetsMap) => void) | undefined;

package/dist/perseus-types.d.ts

@@ -379,6 +379,8 @@ export type PerseusInteractiveGraphWidgetOptions = {
     graph: PerseusGraphType;
     correct: PerseusGraphType;
     lockedFigures?: ReadonlyArray<LockedFigure>;
+    fullGraphAriaLabel?: string;
+    fullGraphAriaDescription?: string;
 };
 declare const lockedFigureColorNames: readonly ["blue", "green", "grayH", "purple", "pink", "orange", "red"];
 export type LockedFigureColor = (typeof lockedFigureColorNames)[number];
@@ -450,7 +452,7 @@ export type PerseusGraphTypeAngle = {
     angleOffsetDeg?: number;
     snapDegrees?: number;
     match?: "congruent";
-    coords?: [Coord, Coord, Coord];
+    coords?: [Coord, Coord, Coord] | null;
     startCoords?: [Coord, Coord, Coord];
 };
 export type PerseusGraphTypeCircle = {
@@ -464,18 +466,18 @@ export type PerseusGraphTypeCircle = {
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeLinear = {
     type: "linear";
-    coords?: CollinearTuple;
+    coords?: CollinearTuple | null;
     startCoords?: CollinearTuple;
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeLinearSystem = {
     type: "linear-system";
-    coords?: CollinearTuple[];
+    coords?: CollinearTuple[] | null;
     startCoords?: CollinearTuple[];
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypePoint = {
     type: "point";
     numPoints?: number | "unlimited";
-    coords?: ReadonlyArray<Coord>;
+    coords?: ReadonlyArray<Coord> | null;
     startCoords?: ReadonlyArray<Coord>;
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypePolygon = {
@@ -485,28 +487,28 @@ export type PerseusGraphTypePolygon = {
     showSides?: boolean;
     snapTo?: "grid" | "angles" | "sides";
     match?: "similar" | "congruent" | "approx";
-    coords?: ReadonlyArray<Coord>;
+    coords?: ReadonlyArray<Coord> | null;
     startCoords?: ReadonlyArray<Coord>;
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeQuadratic = {
     type: "quadratic";
-    coords?: [Coord, Coord, Coord];
+    coords?: [Coord, Coord, Coord] | null;
     startCoords?: [Coord, Coord, Coord];
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeSegment = {
     type: "segment";
     numSegments?: number;
-    coords?: CollinearTuple[];
+    coords?: CollinearTuple[] | null;
     startCoords?: CollinearTuple[];
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeSinusoid = {
     type: "sinusoid";
-    coords?: ReadonlyArray<Coord>;
+    coords?: ReadonlyArray<Coord> | null;
     startCoords?: ReadonlyArray<Coord>;
 } & PerseusGraphTypeCommon;
 export type PerseusGraphTypeRay = {
     type: "ray";
-    coords?: CollinearTuple;
+    coords?: CollinearTuple | null;
     startCoords?: CollinearTuple;
 } & PerseusGraphTypeCommon;
 export type PerseusLabelImageWidgetOptions = {

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

@@ -150,14 +150,7 @@ declare const ref: React.ForwardRefExoticComponent<Omit<Pick<SharedRendererProps
                 "linear-system"?: boolean | undefined;
                 "unlimited-point"?: boolean | undefined;
             } & {
-                "interactive-graph-locked-features-m2b"?: boolean | undefined;
                 "interactive-graph-locked-features-labels"?: boolean | undefined;
-            } & {
-                "start-coords-ui-phase-1"?: boolean | undefined;
-                "start-coords-ui-phase-2"?: boolean | undefined;
-                "start-coords-ui-point"?: boolean | undefined;
-                "start-coords-ui-polygon"?: boolean | undefined;
-                "start-coords-ui-angle"?: boolean | undefined;
             }) | undefined;
         } | undefined;
         onWidgetStartProps?: ((widgets: import("./perseus-types").PerseusWidgetsMap) => void) | undefined;

package/dist/types.d.ts

@@ -75,8 +75,7 @@ type TrackInteractionArgs = {
     correct?: boolean;
 } & Partial<TrackingGradedGroupExtraArguments> & Partial<TrackingSequenceExtraArguments>;
 export declare const MafsGraphTypeFlags: readonly ["angle", "segment", "linear", "linear-system", "ray", "polygon", "circle", "quadratic", "sinusoid", "point", "unlimited-point"];
-export declare const InteractiveGraphLockedFeaturesFlags: readonly ["interactive-graph-locked-features-m2b", "interactive-graph-locked-features-labels"];
-export declare const InteractiveGraphEditorFlags: readonly ["start-coords-ui-phase-1", "start-coords-ui-phase-2", "start-coords-ui-point", "start-coords-ui-polygon", "start-coords-ui-angle"];
+export declare const InteractiveGraphLockedFeaturesFlags: readonly ["interactive-graph-locked-features-labels"];
 /**
  * APIOptions provides different ways to customize the behaviour of Perseus.
  *
@@ -208,8 +207,6 @@ 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/expression.d.ts

@@ -151,14 +151,7 @@ declare const _default: Readonly<{
                     "linear-system"?: boolean | undefined;
                     "unlimited-point"?: boolean | undefined;
                 } & {
-                    "interactive-graph-locked-features-m2b"?: boolean | undefined;
                     "interactive-graph-locked-features-labels"?: boolean | undefined;
-                } & {
-                    "start-coords-ui-phase-1"?: boolean | undefined;
-                    "start-coords-ui-phase-2"?: boolean | undefined;
-                    "start-coords-ui-point"?: boolean | undefined;
-                    "start-coords-ui-polygon"?: boolean | undefined;
-                    "start-coords-ui-angle"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -237,14 +230,7 @@ declare const _default: Readonly<{
                     "linear-system"?: boolean | undefined;
                     "unlimited-point"?: boolean | undefined;
                 } & {
-                    "interactive-graph-locked-features-m2b"?: boolean | undefined;
                     "interactive-graph-locked-features-labels"?: boolean | undefined;
-                } & {
-                    "start-coords-ui-phase-1"?: boolean | undefined;
-                    "start-coords-ui-phase-2"?: boolean | undefined;
-                    "start-coords-ui-point"?: boolean | undefined;
-                    "start-coords-ui-polygon"?: boolean | undefined;
-                    "start-coords-ui-angle"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -323,14 +309,7 @@ declare const _default: Readonly<{
                     "linear-system"?: boolean | undefined;
                     "unlimited-point"?: boolean | undefined;
                 } & {
-                    "interactive-graph-locked-features-m2b"?: boolean | undefined;
                     "interactive-graph-locked-features-labels"?: boolean | undefined;
-                } & {
-                    "start-coords-ui-phase-1"?: boolean | undefined;
-                    "start-coords-ui-phase-2"?: boolean | undefined;
-                    "start-coords-ui-point"?: boolean | undefined;
-                    "start-coords-ui-polygon"?: boolean | undefined;
-                    "start-coords-ui-angle"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -408,14 +387,7 @@ declare const _default: Readonly<{
                     "linear-system"?: boolean | undefined;
                     "unlimited-point"?: boolean | undefined;
                 } & {
-                    "interactive-graph-locked-features-m2b"?: boolean | undefined;
                     "interactive-graph-locked-features-labels"?: boolean | undefined;
-                } & {
-                    "start-coords-ui-phase-1"?: boolean | undefined;
-                    "start-coords-ui-phase-2"?: boolean | undefined;
-                    "start-coords-ui-point"?: boolean | undefined;
-                    "start-coords-ui-polygon"?: boolean | undefined;
-                    "start-coords-ui-angle"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -494,14 +466,7 @@ declare const _default: Readonly<{
                     "linear-system"?: boolean | undefined;
                     "unlimited-point"?: boolean | undefined;
                 } & {
-                    "interactive-graph-locked-features-m2b"?: boolean | undefined;
                     "interactive-graph-locked-features-labels"?: boolean | undefined;
-                } & {
-                    "start-coords-ui-phase-1"?: boolean | undefined;
-                    "start-coords-ui-phase-2"?: boolean | undefined;
-                    "start-coords-ui-point"?: boolean | undefined;
-                    "start-coords-ui-polygon"?: boolean | undefined;
-                    "start-coords-ui-angle"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../../perseus-types").PerseusWidgetsMap) => void) | undefined;
@@ -580,14 +545,7 @@ declare const _default: Readonly<{
                     "linear-system"?: boolean | undefined;
                     "unlimited-point"?: boolean | undefined;
                 } & {
-                    "interactive-graph-locked-features-m2b"?: boolean | undefined;
                     "interactive-graph-locked-features-labels"?: boolean | undefined;
-                } & {
-                    "start-coords-ui-phase-1"?: boolean | undefined;
-                    "start-coords-ui-phase-2"?: boolean | undefined;
-                    "start-coords-ui-point"?: boolean | undefined;
-                    "start-coords-ui-polygon"?: boolean | undefined;
-                    "start-coords-ui-angle"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../../perseus-types").PerseusWidgetsMap) => void) | undefined;

package/dist/widgets/interactive-graphs/backgrounds/axis-ticks.d.ts

@@ -1,3 +1,5 @@
 import * as React from "react";
+import type { Interval } from "mafs";
+export declare const shouldShowLabel: (number: number, range: [Interval, Interval]) => boolean;
 export declare function generateTickLocations(tickStep: number, min: number, max: number): number[];
 export declare const AxisTicks: () => React.JSX.Element;

package/dist/widgets/interactive-graphs/backgrounds/grid.d.ts

@@ -3,20 +3,12 @@ import type { GraphRange } from "../../../perseus-types";
 import type { SizeClass } from "../../../util/sizing-utils";
 import type { vec } from "mafs";
 interface GridProps {
-    tickStep: vec.Vector2;
     gridStep: vec.Vector2;
     range: GraphRange;
     containerSizeClass: SizeClass;
     markings: "graph" | "grid" | "none";
+    width: number;
+    height: number;
 }
-/**
- * lineLabelText get the text that should
- * be displayed for a specific tick place
- *
- * @param {number} n the tick number
- * @param {number} tickStep how frequently a label should appear
- * @param {vec.Vector2} range the min/max range on the axis
- */
-export declare const lineLabelText: (n: number, tickStep: number, range: vec.Vector2) => string;
 export declare const Grid: (props: GridProps) => React.JSX.Element | null;
 export {};

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

@@ -5,6 +5,8 @@ export type LockedFunctionOptions = Omit<Partial<LockedFunctionType>, "type" | "
 export declare function interactiveGraphQuestionBuilder(): InteractiveGraphQuestionBuilder;
 declare class InteractiveGraphQuestionBuilder {
     private content;
+    private fullGraphAriaLabel?;
+    private fullGraphAriaDescription?;
     private backgroundImage?;
     private gridStep;
     private labels;
@@ -20,6 +22,8 @@ declare class InteractiveGraphQuestionBuilder {
     private staticMode;
     build(): PerseusRenderer;
     withContent(content: string): InteractiveGraphQuestionBuilder;
+    withFullGraphAriaLabel(label: string): InteractiveGraphQuestionBuilder;
+    withFullGraphAriaDescription(description: string): InteractiveGraphQuestionBuilder;
     withStaticMode(staticMode: boolean): InteractiveGraphQuestionBuilder;
     withBackgroundImage(url: string, height: number, width: number, options?: {
         scale?: number;

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

@@ -1,6 +1,7 @@
 import * as React from "react";
 import { type InteractiveGraphAction } from "./reducer/interactive-graph-action";
 import type { InteractiveGraphState, InteractiveGraphProps } from "./types";
+import type { vec } from "mafs";
 import "mafs/core.css";
 import "./mafs-styles.css";
 export type MafsGraphProps = {
@@ -15,9 +16,15 @@ export type MafsGraphProps = {
     showTooltips: Required<InteractiveGraphProps["showTooltips"]>;
     showProtractor: boolean;
     labels: InteractiveGraphProps["labels"];
+    fullGraphAriaLabel?: InteractiveGraphProps["fullGraphAriaLabel"];
+    fullGraphAriaDescription?: InteractiveGraphProps["fullGraphAriaDescription"];
     state: InteractiveGraphState;
     dispatch: React.Dispatch<InteractiveGraphAction>;
     readOnly: boolean;
     static: boolean | null | undefined;
 };
 export declare const MafsGraph: (props: MafsGraphProps) => React.JSX.Element;
+export declare const calculateNestedSVGCoords: (range: vec.Vector2[], width: number, height: number) => {
+    viewboxX: number;
+    viewboxY: number;
+};

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

@@ -19,6 +19,8 @@ export type StatefulMafsGraphProps = {
     showTooltips: Required<InteractiveGraphProps["showTooltips"]>;
     showProtractor: boolean;
     labels: InteractiveGraphProps["labels"];
+    fullGraphAriaLabel?: InteractiveGraphProps["fullGraphAriaLabel"];
+    fullGraphAriaDescription?: InteractiveGraphProps["fullGraphAriaDescription"];
     readOnly: boolean;
     static: InteractiveGraphProps["static"];
 };

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

@@ -143,14 +143,7 @@ declare const _default: Readonly<{
                     "linear-system"?: boolean | undefined;
                     "unlimited-point"?: boolean | undefined;
                 } & {
-                    "interactive-graph-locked-features-m2b"?: boolean | undefined;
                     "interactive-graph-locked-features-labels"?: boolean | undefined;
-                } & {
-                    "start-coords-ui-phase-1"?: boolean | undefined;
-                    "start-coords-ui-phase-2"?: boolean | undefined;
-                    "start-coords-ui-point"?: boolean | undefined;
-                    "start-coords-ui-polygon"?: boolean | undefined;
-                    "start-coords-ui-angle"?: boolean | undefined;
                 }) | undefined;
             } | undefined;
             onWidgetStartProps?: ((widgets: import("../..").PerseusWidgetsMap) => void) | undefined;
@@ -213,14 +206,7 @@ declare const _default: Readonly<{
                     "linear-system"?: boolean | undefined;
                     "unlimited-point"?: boolean | undefined;
                 } & {
-                    "interactive-graph-locked-features-m2b"?: boolean | undefined;
                     "interactive-graph-locked-features-labels"?: boolean | undefined;
-                } & {
-                    "start-coords-ui-phase-1"?: boolean | undefined;
-                    "start-coords-ui-phase-2"?: boolean | undefined;
-                    "start-coords-ui-point"?: boolean | undefined;
-                    "start-coords-ui-polygon"?: boolean | undefined;
-                    "start-coords-ui-angle"?: 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": "32.0.1",
+    "version": "33.1.0",
     "publishConfig": {
         "access": "public"
     },

package/dist/widgets/interaction/arrow-picker.d.ts

@@ -1,12 +0,0 @@
-import * as React from "react";
-import type { ChangeableProps } from "../../mixins/changeable";
-type Props = {
-    value?: string;
-} & ChangeableProps;
-declare class ArrowPicker extends React.Component<Props> {
-    static defaultProps: {
-        value: string;
-    };
-    render(): React.ReactNode;
-}
-export default ArrowPicker;

package/dist/widgets/interaction/color-picker.d.ts

@@ -1,14 +0,0 @@
-import * as React from "react";
-import type { ChangeableProps } from "../../mixins/changeable";
-type Props = {
-    lightColors?: boolean;
-    value?: string;
-} & ChangeableProps;
-declare class ColorPicker extends React.Component<Props> {
-    static defaultProps: {
-        lightColors: boolean;
-        value: any;
-    };
-    render(): React.ReactNode;
-}
-export default ColorPicker;

package/dist/widgets/interaction/dash-picker.d.ts

@@ -1,12 +0,0 @@
-import * as React from "react";
-import type { ChangeableProps } from "../../mixins/changeable";
-type Props = {
-    value?: string;
-} & ChangeableProps;
-declare class DashPicker extends React.Component<Props> {
-    static defaultProps: {
-        value: string;
-    };
-    render(): React.ReactNode;
-}
-export default DashPicker;

package/dist/widgets/interaction/element-container.d.ts

@@ -1,22 +0,0 @@
-import * as React from "react";
-type Props = {
-    children: React.ReactElement<any> | ReadonlyArray<React.ReactElement<any>>;
-    initiallyVisible: boolean;
-    onDelete?: () => void | null | undefined;
-    onDown?: () => void | null | undefined;
-    onUp?: () => void | null | undefined;
-    title: string | React.ReactElement<any>;
-};
-type State = {
-    show: boolean;
-};
-declare class ElementContainer extends React.Component<Props, State> {
-    static defaultProps: {
-        initiallyVisible: boolean;
-        title: string;
-    };
-    constructor(props: Props);
-    toggle: (e: React.SyntheticEvent) => void;
-    render(): React.ReactNode;
-}
-export default ElementContainer;

package/dist/widgets/interactive-graphs/backgrounds/axis-tick-labels.d.ts

@@ -1,13 +0,0 @@
-import * as React from "react";
-type ShowTickLabelProps = {
-    gridStep: number;
-    tickStep: number;
-    label: number;
-    graphEdge: number;
-    position: number;
-    axisOutOfBounds: boolean;
-};
-export declare const AxisTickLabels: () => React.JSX.Element;
-export declare const showTickLabel: ({ gridStep, tickStep, label, graphEdge, position, axisOutOfBounds, }: ShowTickLabelProps) => boolean;
-export declare function generateTickLocations(tickStep: number, min: number, max: number): number[];
-export {};