[Locked Figure Labels] View locked function labels

.changeset/spotty-days-burn.md

@@ -0,0 +1,6 @@
+---
+"@khanacademy/perseus": minor
+"@khanacademy/perseus-editor": minor
+---
+
+[Locked Figure Labels] View locked function labels

packages/perseus-editor/src/__stories__/flags-for-api-options.ts

@@ -20,6 +20,7 @@ export const flags = {
         "locked-line-labels": true,
         "locked-vector-labels": true,
         "locked-ellipse-labels": true,
+        "locked-function-labels": true,
     },
 } satisfies APIOptions["flags"];
 

packages/perseus-editor/src/__stories__/interactive-graph-editor.stories.tsx

@@ -157,6 +157,7 @@ export const MafsWithLockedFiguresCurrent = (): React.ReactElement => {
                         "locked-line-labels": false,
                         "locked-vector-labels": false,
                         "locked-ellipse-labels": false,
+                        "locked-function-labels": false,
                     },
                 },
             }}
@@ -185,6 +186,7 @@ export const MafsWithLockedLabelsFlag = (): React.ReactElement => {
                         "locked-line-labels": false,
                         "locked-vector-labels": false,
                         "locked-ellipse-labels": false,
+                        "locked-function-labels": false,
                     },
                 },
             }}
@@ -205,6 +207,7 @@ export const MafsWithLockedPointLabelsFlag = (): React.ReactElement => {
                         "locked-line-labels": false,
                         "locked-vector-labels": false,
                         "locked-ellipse-labels": false,
+                        "locked-function-labels": false,
                     },
                 },
             }}
@@ -225,6 +228,7 @@ export const MafsWithLockedLineLabelsFlag = (): React.ReactElement => {
                         "locked-line-labels": true,
                         "locked-vector-labels": false,
                         "locked-ellipse-labels": false,
+                        "locked-function-labels": false,
                     },
                 },
             }}
@@ -245,6 +249,7 @@ export const MafsWithLockedVectorLabelsFlag = (): React.ReactElement => {
                         "locked-line-labels": false,
                         "locked-vector-labels": true,
                         "locked-ellipse-labels": false,
+                        "locked-function-labels": false,
                     },
                 },
             }}
@@ -265,6 +270,7 @@ export const MafsWithLockedEllipseLabelsFlag = (): React.ReactElement => {
                         "locked-line-labels": false,
                         "locked-vector-labels": false,
                         "locked-ellipse-labels": true,
+                        "locked-function-labels": false,
                     },
                 },
             }}
@@ -273,6 +279,33 @@ export const MafsWithLockedEllipseLabelsFlag = (): React.ReactElement => {
     );
 };
 
+export const MafsWithLockedFunctionLabelsFlag = (): React.ReactElement => {
+    return (
+        <EditorPageWithStorybookPreview
+            apiOptions={{
+                flags: {
+                    mafs: {
+                        ...flags.mafs,
+                        "interactive-graph-locked-features-labels": true,
+                        "locked-point-labels": false,
+                        "locked-line-labels": false,
+                        "locked-vector-labels": false,
+                        "locked-ellipse-labels": false,
+                        "locked-function-labels": true,
+                    },
+                },
+            }}
+            question={segmentWithLockedFigures}
+        />
+    );
+};
+
+export const MafsWithLockedFigureLabelsAllFlags = (): React.ReactElement => {
+    return (
+        <EditorPageWithStorybookPreview question={segmentWithLockedFigures} />
+    );
+};
+
 export const WithSaveWarnings = (): React.ReactElement => {
     const [previewDevice, setPreviewDevice] =
         React.useState<DeviceType>("phone");

packages/perseus-editor/src/widgets/interactive-graph-editor/locked-figures/util.test.ts

@@ -92,6 +92,7 @@ describe("getDefaultFigureForType", () => {
             strokeStyle: "solid",
             equation: "x^2",
             directionalAxis: "x",
+            labels: [],
         });
     });
 

packages/perseus-editor/src/widgets/interactive-graph-editor/locked-figures/util.ts

@@ -90,6 +90,7 @@ export function getDefaultFigureForType(type: LockedFigureType): LockedFigure {
                 strokeStyle: "solid",
                 equation: "x^2",
                 directionalAxis: "x",
+                labels: [],
             };
         case "label":
             return {

packages/perseus/src/perseus-types.ts

@@ -780,6 +780,7 @@ export type LockedFunctionType = {
     equation: string; // This is the user-defined equation (as it was typed)
     directionalAxis: "x" | "y";
     domain?: Interval;
+    labels: LockedLabelType[];
 };
 
 // Not associated with a specific figure

packages/perseus/src/types.ts

@@ -175,6 +175,11 @@ export const InteractiveGraphLockedFeaturesFlags = [
      * updated Interactive Graph widget.
      */
     "locked-ellipse-labels",
+    /**
+     * Enables/disables the labels associated with locked functions in the
+     * updated Interactive Graph widget.
+     */
+    "locked-function-labels",
 ] as const;
 
 /**

packages/perseus/src/widgets/interactive-graphs/graph-locked-labels-layer.tsx

@@ -30,7 +30,10 @@ export default function GraphLockedLabelsLayer(props: Props) {
                 figure.type === "vector") ||
             // Ellipse flag + ellipse type
             (flags?.["mafs"]?.["locked-ellipse-labels"] &&
-                figure.type === "ellipse")
+                figure.type === "ellipse") ||
+            // Function flag + function type
+            (flags?.["mafs"]?.["locked-function-labels"] &&
+                figure.type === "function")
         ) {
             return (
                 <React.Fragment key={i}>

packages/perseus/src/widgets/interactive-graphs/interactive-graph-question-builder.test.ts

@@ -1199,17 +1199,19 @@ describe("InteractiveGraphQuestionBuilder", () => {
                 color: "grayH",
                 strokeStyle: "solid",
                 directionalAxis: "x",
+                labels: [],
             },
         ]);
     });
 
-    it("adds a locked function with options", () => {
+    it("adds a locked function with options and minimal label", () => {
         const question: PerseusRenderer = interactiveGraphQuestionBuilder()
             .addLockedFunction("x^2", {
                 color: "green",
                 strokeStyle: "dashed",
                 directionalAxis: "y",
                 domain: [-5, 5],
+                labels: [{text: "a label"}],
             })
             .build();
         const graph = question.widgets["interactive-graph 1"];
@@ -1222,6 +1224,43 @@ describe("InteractiveGraphQuestionBuilder", () => {
                 strokeStyle: "dashed",
                 directionalAxis: "y",
                 domain: [-5, 5],
+                labels: [
+                    {
+                        type: "label",
+                        text: "a label",
+                        coord: [0, 0],
+                        color: "green",
+                        size: "medium",
+                    },
+                ],
+            },
+        ]);
+    });
+
+    it("adds a locked function with a specific label", () => {
+        const question: PerseusRenderer = interactiveGraphQuestionBuilder()
+            .addLockedFunction("x^2", {
+                labels: [{text: "a label", coord: [9, 9], size: "small"}],
+            })
+            .build();
+        const graph = question.widgets["interactive-graph 1"];
+
+        expect(graph.options.lockedFigures).toEqual([
+            {
+                type: "function",
+                equation: "x^2",
+                color: "grayH",
+                strokeStyle: "solid",
+                directionalAxis: "x",
+                labels: [
+                    {
+                        type: "label",
+                        text: "a label",
+                        coord: [9, 9],
+                        color: "grayH",
+                        size: "small",
+                    },
+                ],
             },
         ]);
     });

packages/perseus/src/widgets/interactive-graphs/interactive-graph-question-builder.ts

@@ -24,6 +24,7 @@ export type LockedFunctionOptions = {
     strokeStyle?: LockedLineStyle;
     directionalAxis?: "x" | "y";
     domain?: Interval;
+    labels?: LockedFigureLabelOptions[];
 };
 
 type LockedFigureLabelOptions = {
@@ -437,6 +438,17 @@ class InteractiveGraphQuestionBuilder {
             strokeStyle: "solid",
             directionalAxis: "x",
             ...options,
+            labels:
+                options?.labels?.map(
+                    (label) =>
+                        ({
+                            type: "label",
+                            coord: label.coord ?? [0, 0],
+                            text: label.text,
+                            color: options?.color ?? "grayH",
+                            size: label.size ?? "medium",
+                        }) satisfies LockedLabelType,
+                ) ?? [],
         };
 
         this.addLockedFigure(lockedFunction);

packages/perseus/src/widgets/interactive-graphs/interactive-graph.test.tsx

@@ -23,6 +23,7 @@ import {
     circleQuestion,
     circleQuestionWithDefaultCorrect,
     graphWithLabeledEllipse,
+    graphWithLabeledFunction,
     graphWithLabeledLine,
     graphWithLabeledPoint,
     graphWithLabeledVector,
@@ -1098,6 +1099,34 @@ describe("locked layer", () => {
         });
     });
 
+    it("should render a locked label within a locked function", async () => {
+        // Arrange
+        const {container} = renderQuestion(graphWithLabeledFunction, {
+            flags: {
+                mafs: {
+                    segment: true,
+                    "interactive-graph-locked-features-labels": true,
+                    "locked-function-labels": true,
+                },
+            },
+        });
+
+        // Act
+        // eslint-disable-next-line testing-library/no-container, testing-library/no-node-access
+        const labels = container.querySelectorAll(".locked-label");
+        const label = labels[0];
+
+        // Assert
+        expect(labels).toHaveLength(1);
+        expect(label).toHaveTextContent("E");
+        expect(label).toHaveStyle({
+            color: lockedFigureColors["grayH"],
+            fontSize: "16px",
+            left: "200px",
+            top: "200px",
+        });
+    });
+
     it("should have an aria-label and description if they are provided", async () => {
         // Arrange
         const {container} = renderQuestion(interactiveGraphWithAriaLabel, {

packages/perseus/src/widgets/interactive-graphs/interactive-graph.testdata.ts

@@ -856,6 +856,7 @@ export const segmentWithLockedFigures: PerseusRenderer =
         )
         .addLockedFunction("sin(x)", {
             color: "red",
+            labels: [{text: "E"}],
         })
         .addLockedLabel("\\sqrt{\\frac{1}{2}}", [6, -5])
         .build();
@@ -989,3 +990,10 @@ export const graphWithLabeledEllipse: PerseusRenderer =
             labels: [{text: "D"}],
         })
         .build();
+
+export const graphWithLabeledFunction: PerseusRenderer =
+    interactiveGraphQuestionBuilder()
+        .addLockedFunction("sin(x)", {
+            labels: [{text: "E"}],
+        })
+        .build();