@khanacademy/perseus-editor 35.2.1 → 35.3.0

package/dist/item-editor.d.ts

@@ -1,12 +1,10 @@
 import * as React from "react";
+import { A11yContext } from "./components/a11y-context";
 import Editor from "./editor";
 import ItemExtrasEditor from "./item-extras-editor";
-import type { PreviewContent } from "./preview/message-types";
+import type { A11yReport } from "./preview/use-preview-controller";
 import type { APIOptions, ImageUploader, ChangeHandler, DeviceType } from "@khanacademy/perseus";
 import type { PerseusAnswerArea, PerseusRenderer, PerseusItem } from "@khanacademy/perseus-core";
-type QuestionPreviewData = Extract<PreviewContent, {
-    type: "question";
-}>;
 type Props = {
     /** Additional templates that the host application would like to display
      * within the Perseus Editor.
@@ -32,6 +30,8 @@ type Props = {
     problemNum?: number;
 };
 declare class ItemEditor extends React.Component<Props> {
+    static contextType: React.Context<import("./components/a11y-context").A11yContextValue | null>;
+    context: React.ContextType<typeof A11yContext>;
     static defaultProps: {
         answerArea: Record<any, any>;
         onChange: () => void;
@@ -39,15 +39,19 @@ declare class ItemEditor extends React.Component<Props> {
     };
     questionEditor: React.RefObject<Editor>;
     itemExtrasEditor: React.RefObject<ItemExtrasEditor>;
+    derivePreviewContent: (inputs: import("./util/derive-question-preview-content").DerivePreviewContentInputs) => {
+        type: "question";
+        data: import("./preview/message-types").QuestionPreviewData;
+    } | null;
     updateProps: (newProps: Partial<PerseusItem>) => void;
     handleEditorChange: ChangeHandler;
     handleItemExtrasChange: (newProps: Partial<PerseusAnswerArea>) => void;
     getSaveWarnings: () => any;
+    handleA11yReport: (report: A11yReport | null) => void;
     serialize(): {
         answerArea: PerseusAnswerArea;
         question: PerseusRenderer;
     };
-    _derivePreviewContent(): QuestionPreviewData | null;
     render(): React.ReactNode;
 }
 export default ItemEditor;

package/dist/item-extras-editor.d.ts

@@ -10,6 +10,7 @@ declare class ItemExtrasEditor extends React.Component<Props> {
     static defaultProps: PerseusAnswerArea;
     shouldShowCalculatorVariants(): boolean;
     shouldShowFinancialCalculatorOptions(): boolean;
+    handleVariantChange: (newVariant: string) => void;
     serialize(): PerseusAnswerArea;
     render(): React.ReactNode;
 }

package/dist/preview/a11y/map-axe-results.d.ts

@@ -0,0 +1,13 @@
+import type { A11yIssue, IssueImpact } from "../../components/issues-panel";
+import type axe from "axe-core";
+export declare const assistanceNeededMessage = "Developer assistance needed - Please send this exercise and warning info to the LEMS team for review.";
+/**
+ * Maps a scan's axe results (one category at a time) to both an issues list
+ * and an `instanceId → elements` map, in a single pass.
+ */
+export declare const mapAxeResults: (results: axe.Result[], type: "Warning" | "Alert") => {
+    issues: A11yIssue[];
+    elementMap: Map<string, Element[]>;
+};
+export declare const getIssueMessage: (nodes: axe.NodeResult[]) => string;
+export declare const convertAxeImpactToIssueImpact: (impact?: axe.ImpactValue) => IssueImpact;

package/dist/preview/a11y/overlays.d.ts

@@ -0,0 +1,22 @@
+import * as React from "react";
+type Props = {
+    targets: ReadonlyArray<Element>;
+    container: HTMLElement | null;
+};
+type Rect = Pick<DOMRect, "top" | "left" | "width" | "height">;
+/**
+ * Computes an overlay rect placed over a target, relative to its container.
+ */
+export declare function getOverlayRect(targetRect: Rect, containerRect: Pick<DOMRect, "top" | "left">): Rect;
+/**
+ * Renders outline overlays over the given target elements.
+ *
+ * Requirements on `container`:
+ * - Must be `position: relative` (or otherwise positioned) — overlays are
+ *   `position: absolute` and measured against its box.
+ * - Must be the actual DOM ancestor that scrolls `targets` (not just any
+ *   positioned ancestor) — that's what lets the overlays scroll natively
+ *   with the content, with no scroll listener needed.
+ */
+export declare function A11yOverlays({ targets, container }: Props): React.JSX.Element | null;
+export {};

package/dist/preview/message-types.d.ts

@@ -3,6 +3,7 @@
  * the preview iframe.
  */
 import type { SerializableApiOptions } from "./sanitize-api-options";
+import type { A11yIssue } from "../components/issues-panel";
 import type { Hint, PerseusItem, PerseusRenderer } from "@khanacademy/perseus-core";
 /**
  * The subset of `LinterContextProps` that's meaningful to send across the
@@ -20,9 +21,21 @@ export declare const PREVIEW_MESSAGE_SOURCE: "perseus-preview";
 /**
  * Base type for all preview messages
  */
-interface PreviewMessageBase {
+export interface PreviewMessageBase {
     source: typeof PREVIEW_MESSAGE_SOURCE;
 }
+/**
+ * Base type for messages tied to a specific version of the preview content.
+ *
+ * `contentVersion` is a monotonic counter owned by the parent controller,
+ * stamped onto every content update and echoed back on the scan report and
+ * highlight commands it produces. It lets both sides discard results computed
+ * against content that has since been superseded by a newer edit — see the
+ * gating in `use-preview-controller.ts` / `use-preview-presenter.ts`.
+ */
+interface PreviewMessageVersioned extends PreviewMessageBase {
+    contentVersion: number;
+}
 /**
  * Data for the read-only question preview shown while editing an exercise.
  *
@@ -101,14 +114,54 @@ export type PreviewContent = {
 /**
  * Message from parent sending content data to iframe
  */
-interface PreviewDataMessage extends PreviewMessageBase {
+interface PreviewDataMessage extends PreviewMessageVersioned {
     type: "content-data";
     content: PreviewContent;
 }
+/**
+ * Reply from parent to the iframe's `iframe-ready` handshake, carrying the
+ * full current preview state in one message. Sent once per `iframe-ready`
+ * (including a genuine reload, which re-announces readiness) — this way a
+ * freshly (re)loaded iframe never has to rely on messages sent before it was
+ * listening.
+ */
+interface PreviewIframeInitMessage extends PreviewMessageVersioned {
+    type: "iframe-init";
+    content: PreviewContent | null;
+    a11yScanningEnabled: boolean;
+}
+export declare function createPreviewIframeInitMessage(content: PreviewContent | null, a11yScanningEnabled: boolean, contentVersion: number): PreviewIframeInitMessage;
+/**
+ * Command from parent telling the iframe to enable or disable axe-core
+ * accessibility scanning. When enabled, the iframe runs scans and reports back;
+ * when disabled, it neither imports nor runs axe-core.
+ */
+interface PreviewSetA11yScanningEnabledMessage extends PreviewMessageBase {
+    type: "set-a11y-scanning-enabled";
+    enabled: boolean;
+}
+export declare function createPreviewSetA11yScanningEnabledMessage(enabled: boolean): PreviewSetA11yScanningEnabledMessage;
+/**
+ * Command from parent telling the iframe to highlight the elements for the
+ * given instanceIds (the "Show Me" overlays drawn inside the iframe).
+ */
+interface PreviewHighlightIssuesMessage extends PreviewMessageVersioned {
+    type: "highlight-issues";
+    instanceIds: string[];
+}
+export declare function createPreviewHighlightIssuesMessage(instanceIds: string[], contentVersion: number): PreviewHighlightIssuesMessage;
+/**
+ * Command from parent telling the iframe to remove any "Show Me" highlight
+ * overlays it is currently drawing.
+ */
+interface PreviewClearHighlightsMessage extends PreviewMessageBase {
+    type: "clear-highlights";
+}
+export declare function createPreviewClearHighlightsMessage(): PreviewClearHighlightsMessage;
 /**
  * Union of all messages sent from parent to iframe
  */
-export type ParentToIframeMessage = PreviewDataMessage;
+export type ParentToIframeMessage = PreviewDataMessage | PreviewIframeInitMessage | PreviewSetA11yScanningEnabledMessage | PreviewHighlightIssuesMessage | PreviewClearHighlightsMessage;
 /**
  * Message from iframe to parent telling it the iframe is ready
  */
@@ -122,9 +175,27 @@ interface PreviewHeightUpdateMessage extends PreviewMessageBase {
     type: "height-update";
     height: number;
 }
+/**
+ * Message from iframe reporting axe-core accessibility scan results back to the
+ * parent.
+ */
+interface PreviewA11yReportMessage extends PreviewMessageVersioned {
+    type: "a11y-report";
+    /** Violations are issues that are confirmed by the a11y scanner. **/
+    violations: A11yIssue[];
+    /**
+     * NeedsReview are issues that the scanner cannot definitively say is a
+     * violation or not. Requires manual review.
+     */
+    needsReview: A11yIssue[];
+}
 /**
  * Union of all messages sent from iframe to parent
  */
-export type IframeToParentMessage = PreviewIframeReadyMessage | PreviewHeightUpdateMessage;
+export type IframeToParentMessage = PreviewIframeReadyMessage | PreviewHeightUpdateMessage | PreviewA11yReportMessage;
 export declare function createPreviewIframeReadyMessage(): PreviewIframeReadyMessage;
+/**
+ * @public just to appease knip until the next PR.
+ */
+export declare function createPreviewA11yReportMessage(violations: A11yIssue[], needsReview: A11yIssue[], contentVersion: number): PreviewA11yReportMessage;
 export {};

package/dist/preview/use-preview-controller.d.ts

@@ -1,5 +1,10 @@
 import * as React from "react";
 import type { PreviewContent } from "./message-types";
+import type { A11yIssue } from "../components/issues-panel";
+export type A11yReport = {
+    violations: A11yIssue[];
+    needsReview: A11yIssue[];
+};
 type UsePreviewControllerResult = {
     /**
      * Send preview content data to the iframe
@@ -9,6 +14,22 @@ type UsePreviewControllerResult = {
      * Current height of the iframe content (null if not yet reported)
      */
     height: number | null;
+    /**
+     * Enable or disable axe-core accessibility scanning in the iframe
+     */
+    setA11yScanningEnabled: (enabled: boolean) => void;
+    /**
+     * Highlight the elements for the given instanceIds in the iframe
+     */
+    highlightIssues: (instanceIds: string[]) => void;
+    /**
+     * Clear any highlighted elements currently shown in the iframe
+     */
+    clearHighlights: () => void;
+    /**
+     * The latest accessibility report received from the iframe (null if none)
+     */
+    a11yReport: A11yReport | null;
 };
 /**
  * Hook for parent/editor to send data to preview iframe and receive updates.

package/dist/preview/use-preview-presenter.d.ts

@@ -1,4 +1,12 @@
+import * as React from "react";
 import type { PreviewContent } from "./message-types";
+type UsePreviewPresenterOptions = {
+    /**
+     * Ref to the element containing the rendered preview content. Used as
+     * the root for axe-core accessibility scans.
+     */
+    contentContainerRef?: React.RefObject<HTMLElement | null>;
+};
 type UsePreviewPresenterResult = {
     /**
      * The preview content received from the parent, or null if not yet loaded
@@ -16,6 +24,16 @@ type UsePreviewPresenterResult = {
      * Function to report the current height of the iframe content to the parent
      */
     reportHeight: (height: number) => void;
+    /**
+     * Whether axe-core accessibility scanning is enabled
+     */
+    a11yScanningEnabled: boolean;
+    /**
+     * Elements to draw "Show Me" highlight overlays over, resolved from the
+     * latest scan's element map via the instanceIds in a highlight-issues
+     * message.
+     */
+    highlightTargets: Element[];
 };
 /**
  * Hook for preview iframe to receive data from parent and send updates back.
@@ -46,5 +64,5 @@ type UsePreviewPresenterResult = {
  * }
  * ```
  */
-export declare function usePreviewPresenter(): UsePreviewPresenterResult;
+export declare function usePreviewPresenter(options?: UsePreviewPresenterOptions): UsePreviewPresenterResult;
 export {};

package/dist/preview-with-iframe.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
 import type { PreviewContent } from "./preview/message-types";
+import type { A11yReport } from "./preview/use-preview-controller";
 type Props = {
     /**
      * The URL that the iframe should load
@@ -19,6 +20,20 @@ type Props = {
      * been provided yet and the iframe should render an empty placeholder.
      */
     content: PreviewContent | null;
+    /**
+     * Whether the iframe should run axe-core accessibility scans.
+     */
+    a11yScanningEnabled?: boolean;
+    /**
+     * instanceIds of the issues to draw "Show Me" highlight overlays over in
+     * the iframe. Empty clears any highlights.
+     */
+    highlightInstanceIds?: string[];
+    /**
+     * Called whenever the iframe reports a new accessibility scan result (or
+     * `null` if scanning is disabled).
+     */
+    onA11yReport?: (report: A11yReport | null) => void;
 };
 /**
  * Displays content in an iframe, isolating it from the parent page and

package/dist/util/derive-device-api-options.d.ts

@@ -0,0 +1,14 @@
+import type { APIOptions, APIOptionsWithDefaults } from "@khanacademy/perseus";
+export type DeviceApiOptionsInputs = {
+    apiOptions: APIOptions | undefined;
+    touch: boolean;
+};
+/**
+ * Returns a memoized deriver for the preview's device-adjusted apiOptions.
+ * It returns the same object reference across calls while neither `apiOptions`
+ * (by reference) nor `touch` (by value) changes, so EditorPage's per-render
+ * rebuild doesn't hand a fresh object to <ItemEditor>'s content memo — which
+ * would defeat it and, with axe-core scanning on, loop scan -> report ->
+ * re-render -> resend. (This is the class-component stand-in for `useMemo`.)
+ */
+export declare function createDeviceApiOptionsDeriver(): (inputs: DeviceApiOptionsInputs) => APIOptionsWithDefaults;

package/dist/util/derive-question-preview-content.d.ts

@@ -0,0 +1,23 @@
+import type { PreviewContent } from "../preview/message-types";
+import type { APIOptions, DeviceType } from "@khanacademy/perseus";
+import type { PerseusRenderer } from "@khanacademy/perseus-core";
+type QuestionPreview = Extract<PreviewContent, {
+    type: "question";
+}>;
+export type DerivePreviewContentInputs = {
+    question: PerseusRenderer | undefined;
+    apiOptions: APIOptions | undefined;
+    deviceType: DeviceType;
+    highlightLint: boolean;
+    problemNum: number | undefined;
+    legacyPerseusLint: ReadonlyArray<string>;
+};
+/**
+ * Returns a `derivePreviewContent` function that returns the same object
+ * reference across calls when none of its inputs have actually changed.
+ * `legacyPerseusLint` is rebuilt as a fresh array by the underlying editor on
+ * every call, so it's compared by value rather than by reference — otherwise
+ * every call would look "changed" and defeat the memoization.
+ */
+export declare function createPreviewContentDeriver(): (inputs: DerivePreviewContentInputs) => QuestionPreview | null;
+export {};

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

@@ -1,8 +1,8 @@
 import * as React from "react";
-import type { Changeable } from "@khanacademy/perseus";
 type Props = {
     value?: string;
-} & Changeable.ChangeableProps;
+    onChange: (value: string) => void;
+};
 declare class ArrowPicker extends React.Component<Props> {
     static defaultProps: {
         value: string;

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

@@ -1,9 +1,9 @@
 import * as React from "react";
-import type { Changeable } from "@khanacademy/perseus";
 type Props = {
     lightColors?: boolean;
     value?: string;
-} & Changeable.ChangeableProps;
+    onChange: (value: string) => void;
+};
 declare class ColorPicker extends React.Component<Props> {
     static defaultProps: {
         lightColors: boolean;

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

@@ -1,8 +1,8 @@
 import * as React from "react";
-import type { Changeable } from "@khanacademy/perseus";
 type Props = {
     value?: string;
-} & Changeable.ChangeableProps;
+    onChange: (value: string) => void;
+};
 declare class DashPicker extends React.Component<Props> {
     static defaultProps: {
         value: string;

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

@@ -2,9 +2,9 @@ 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;
+    onDelete?: (() => void) | null;
+    onDown?: (() => void) | null;
+    onUp?: (() => void) | null;
     title: string | React.ReactElement<any>;
 };
 type State = {

package/dist/widgets/interaction-editor/function-editor.d.ts

@@ -19,7 +19,6 @@ type DefaultProps = {
 declare class FunctionEditor extends React.Component<Props> {
     static defaultProps: DefaultProps;
     change: (arg1: any, arg2?: any, arg3?: any) => any;
-    serialize: () => any;
     render(): React.ReactNode;
 }
 export default FunctionEditor;

package/dist/widgets/interaction-editor/label-editor.d.ts

@@ -15,7 +15,6 @@ type DefaultProps = {
 declare class LabelEditor extends React.Component<Props> {
     static defaultProps: DefaultProps;
     change: (arg1: any, arg2?: any, arg3?: any) => any;
-    serialize: () => any;
     render(): React.ReactNode;
 }
 export default LabelEditor;

package/dist/widgets/interaction-editor/line-editor.d.ts

@@ -23,7 +23,6 @@ type DefaultProps = {
 declare class LineEditor extends React.Component<Props> {
     static defaultProps: DefaultProps;
     change: (arg1: any, arg2?: any, arg3?: any) => any;
-    serialize: () => any;
     render(): React.ReactNode;
 }
 export default LineEditor;

package/dist/widgets/interaction-editor/movable-line-editor.d.ts

@@ -24,7 +24,6 @@ type DefaultProps = {
 declare class MovableLineEditor extends React.Component<Props> {
     static defaultProps: DefaultProps;
     change: ChangeFn;
-    serialize: () => any;
     render(): React.ReactNode;
 }
 export default MovableLineEditor;

package/dist/widgets/interaction-editor/movable-point-editor.d.ts

@@ -19,7 +19,6 @@ type DefaultProps = {
 declare class MovablePointEditor extends React.Component<Props> {
     static defaultProps: DefaultProps;
     change: ChangeFn;
-    serialize: () => any;
     render(): React.ReactNode;
 }
 export default MovablePointEditor;

package/dist/widgets/interaction-editor/parametric-editor.d.ts

@@ -21,7 +21,6 @@ type DefaultProps = {
 declare class ParametricEditor extends React.Component<Props> {
     static defaultProps: DefaultProps;
     change: (arg1: any, arg2?: any, arg3?: any) => any;
-    serialize: () => any;
     render(): React.ReactNode;
 }
 export default ParametricEditor;

package/dist/widgets/interaction-editor/point-editor.d.ts

@@ -13,7 +13,6 @@ type DefaultProps = {
 declare class PointEditor extends React.Component<Props> {
     static defaultProps: DefaultProps;
     change: (arg1: any, arg2?: any, arg3?: any) => any;
-    serialize: () => any;
     render(): React.ReactNode;
 }
 export default PointEditor;

package/dist/widgets/interaction-editor/rectangle-editor.d.ts

@@ -17,7 +17,6 @@ type DefaultProps = {
 declare class RectangleEditor extends React.Component<Props> {
     static defaultProps: DefaultProps;
     change: (arg1: any, arg2?: any, arg3?: any) => any;
-    serialize: () => any;
     render(): React.ReactNode;
 }
 export default RectangleEditor;

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

@@ -13,20 +13,20 @@ declare const InteractiveGraph: {
             step: [number, number];
             gridStep?: [x: number, y: number];
             snapStep?: [x: number, y: number];
-            backgroundImage?: PerseusImageBackground;
-            markings: MarkingsType;
+            backgroundImage: import("@khanacademy/perseus-core").PerseusImageBackground;
+            markings: import("@khanacademy/perseus-core").MarkingsType;
             labels: string[];
-            labelLocation: AxisLabelLocation;
+            labelLocation: import("@khanacademy/perseus-core").AxisLabelLocation;
+            showAxisArrows: import("@khanacademy/perseus-core").ShowAxisArrows;
+            showAxisTicks: import("@khanacademy/perseus-core").ShowAxisTicks;
             showProtractor: boolean;
             showRuler?: boolean;
-            showTooltips?: boolean;
+            showTooltips: boolean;
             rulerLabel?: string;
             rulerTicks?: number;
             range: import("@khanacademy/perseus-core").GraphRange;
-            showAxisArrows: ShowAxisArrows;
-            showAxisTicks: ShowAxisTicks;
-            correct?: PerseusGraphType;
-            lockedFigures: LockedFigure[];
+            correct: PerseusGraphType;
+            lockedFigures: import("@khanacademy/perseus-core").LockedFigure[];
             fullGraphAriaLabel?: string;
             fullGraphAriaDescription?: string;
             trackInteraction: (extraData?: Empty | undefined) => void;
@@ -309,25 +309,25 @@ declare const InteractiveGraph: {
             containerSizeClass: import("../../../../perseus/src/util/sizing-utils").SizeClass;
         };
         render(): React.JSX.Element;
-        setState<K extends string | number | symbol>(state: any, callback?: (() => void) | undefined): void;
+        setState<K extends never>(state: {} | ((prevState: Readonly<{}>, props: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>) => {} | Pick<{}, K> | null) | Pick<{}, K> | null, callback?: (() => void) | undefined): void;
         forceUpdate(callback?: (() => void) | undefined): void;
         readonly props: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>;
-        state: Readonly<any>;
+        state: Readonly<{}>;
         refs: {
             [key: string]: React.ReactInstance;
         };
         componentDidMount?(): void;
-        shouldComponentUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<any>, nextContext: any): boolean;
+        shouldComponentUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<{}>, nextContext: any): boolean;
         componentWillUnmount?(): void;
         componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
-        getSnapshotBeforeUpdate?(prevProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, prevState: Readonly<any>): any;
-        componentDidUpdate?(prevProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, prevState: Readonly<any>, snapshot?: any): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, prevState: Readonly<{}>): any;
+        componentDidUpdate?(prevProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, prevState: Readonly<{}>, snapshot?: any): void;
         componentWillMount?(): void;
         UNSAFE_componentWillMount?(): void;
         componentWillReceiveProps?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextContext: any): void;
         UNSAFE_componentWillReceiveProps?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextContext: any): void;
-        componentWillUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<any>, nextContext: any): void;
-        UNSAFE_componentWillUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<any>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<{}>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<{}>, nextContext: any): void;
     };
     new (props: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props, context: any): {
         context: React.ContextType<typeof import("@khanacademy/perseus").PerseusI18nContext>;
@@ -339,20 +339,20 @@ declare const InteractiveGraph: {
             step: [number, number];
             gridStep?: [x: number, y: number];
             snapStep?: [x: number, y: number];
-            backgroundImage?: PerseusImageBackground;
-            markings: MarkingsType;
+            backgroundImage: import("@khanacademy/perseus-core").PerseusImageBackground;
+            markings: import("@khanacademy/perseus-core").MarkingsType;
             labels: string[];
-            labelLocation: AxisLabelLocation;
+            labelLocation: import("@khanacademy/perseus-core").AxisLabelLocation;
+            showAxisArrows: import("@khanacademy/perseus-core").ShowAxisArrows;
+            showAxisTicks: import("@khanacademy/perseus-core").ShowAxisTicks;
             showProtractor: boolean;
             showRuler?: boolean;
-            showTooltips?: boolean;
+            showTooltips: boolean;
             rulerLabel?: string;
             rulerTicks?: number;
             range: import("@khanacademy/perseus-core").GraphRange;
-            showAxisArrows: ShowAxisArrows;
-            showAxisTicks: ShowAxisTicks;
-            correct?: PerseusGraphType;
-            lockedFigures: LockedFigure[];
+            correct: PerseusGraphType;
+            lockedFigures: import("@khanacademy/perseus-core").LockedFigure[];
             fullGraphAriaLabel?: string;
             fullGraphAriaDescription?: string;
             trackInteraction: (extraData?: Empty | undefined) => void;
@@ -635,40 +635,27 @@ declare const InteractiveGraph: {
             containerSizeClass: import("../../../../perseus/src/util/sizing-utils").SizeClass;
         };
         render(): React.JSX.Element;
-        setState<K extends string | number | symbol>(state: any, callback?: (() => void) | undefined): void;
+        setState<K extends never>(state: {} | ((prevState: Readonly<{}>, props: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>) => {} | Pick<{}, K> | null) | Pick<{}, K> | null, callback?: (() => void) | undefined): void;
         forceUpdate(callback?: (() => void) | undefined): void;
         readonly props: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>;
-        state: Readonly<any>;
+        state: Readonly<{}>;
         refs: {
             [key: string]: React.ReactInstance;
         };
         componentDidMount?(): void;
-        shouldComponentUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<any>, nextContext: any): boolean;
+        shouldComponentUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<{}>, nextContext: any): boolean;
         componentWillUnmount?(): void;
         componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
-        getSnapshotBeforeUpdate?(prevProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, prevState: Readonly<any>): any;
-        componentDidUpdate?(prevProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, prevState: Readonly<any>, snapshot?: any): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, prevState: Readonly<{}>): any;
+        componentDidUpdate?(prevProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, prevState: Readonly<{}>, snapshot?: any): void;
         componentWillMount?(): void;
         UNSAFE_componentWillMount?(): void;
         componentWillReceiveProps?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextContext: any): void;
         UNSAFE_componentWillReceiveProps?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextContext: any): void;
-        componentWillUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<any>, nextContext: any): void;
-        UNSAFE_componentWillUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<any>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<{}>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props>, nextState: Readonly<{}>, nextContext: any): void;
     };
     contextType: React.Context<import("../../../../perseus/src/components/i18n-context").I18nContextType>;
-    defaultProps: {
-        labels: string[];
-        labelLocation: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["labelLocation"];
-        range: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["range"];
-        showAxisArrows: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["showAxisArrows"];
-        showAxisTicks: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["showAxisTicks"];
-        step: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["step"];
-        backgroundImage: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["backgroundImage"];
-        markings: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["markings"];
-        showTooltips: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["showTooltips"];
-        showProtractor: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["showProtractor"];
-        userInput: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props["userInput"];
-    };
     getEquationString(props: import("../../../../perseus/src/widgets/interactive-graphs/interactive-graph").Props): string;
 };
 type InteractiveGraphProps = PropsFor<typeof InteractiveGraph>;

package/dist/widgets/interactive-graph-editor/locked-figures/locked-label-settings.d.ts

@@ -1,3 +1,10 @@
+/**
+ * LockedLabelSettings is a component that allows the user to edit the
+ * settings of specifically a locked label on the graph within the
+ * Interactive Graph widget.
+ *
+ * Used in the interactive graph editor's locked figures section.
+ */
 import { type LockedLabelType } from "@khanacademy/perseus-core";
 import * as React from "react";
 import type { LockedFigureSettingsMovementType } from "./locked-figure-settings-actions";