Create helper to build public widget options for expression (#2139)

## Summary:
Adds a function that takes expression's full widget options and filters out answer data. It also adds this function to the widget's widget export and adds a test confirming the function does what is expected.

Issue: LEMS-2758

## Test plan:
- Confirm all checks pass
- Confirm expression still works as expected

Author: Myranae

Reviewers: Myranae, benchristel, handeyeco, jeremywiebe

Required Reviewers:

Approved By: handeyeco, jeremywiebe

Checks: ✅ Publish npm snapshot (ubuntu-latest, 20.x), ✅ Check for .changeset entries for all changed files (ubuntu-latest, 20.x), ✅ Lint, Typecheck, Format, and Test (ubuntu-latest, 20.x), ✅ Cypress (ubuntu-latest, 20.x), ✅ Check builds for changes in size (ubuntu-latest, 20.x), ✅ Publish Storybook to Chromatic (ubuntu-latest, 20.x)

Pull Request URL: #2139

Author: Myranae

.changeset/smooth-houses-burn.md

@@ -0,0 +1,5 @@
+---
+"@khanacademy/perseus": minor
+---
+
+Implement a widget export function to filter out rubric data from widget options for the Expression widget

.changeset/ten-insects-cheat.md

@@ -0,0 +1,5 @@
+---
+"@khanacademy/perseus-core": patch
+---
+
+Move util files out of widget folder in perseus package to utils folder in perseus-core

packages/perseus-core/src/index.ts

@@ -38,3 +38,5 @@ export type {ExpressionDefaultWidgetOptions} from "./widgets/expression";
 export type * from "./widgets/logic-export.types";
 
 export {default as getOrdererPublicWidgetOptions} from "./utils/orderer-util";
+
+export {default as getExpressionPublicWidgetOptions} from "./utils/expression-util";

packages/perseus-core/src/utils/expression-util.test.ts

@@ -0,0 +1,38 @@
+import getExpressionPublicWidgetOptions from "./expression-util";
+
+import type {PerseusExpressionWidgetOptions} from "@khanacademy/perseus-core";
+
+describe("getExpressionPublicWidgetOptions", () => {
+    it("should return the correct public options without any answer data", () => {
+        // Arrange
+        const options: PerseusExpressionWidgetOptions = {
+            answerForms: [
+                {
+                    considered: "correct",
+                    form: false,
+                    simplify: false,
+                    value: "123-x",
+                },
+            ],
+            buttonSets: ["basic"],
+            functions: ["f", "g", "h"],
+            times: false,
+            visibleLabel: "the visible label",
+            ariaLabel: "the aria label",
+            buttonsVisible: "always",
+        };
+
+        // Act
+        const publicWidgetOptions = getExpressionPublicWidgetOptions(options);
+
+        // Assert
+        expect(publicWidgetOptions).toEqual({
+            times: false,
+            buttonSets: ["basic"],
+            functions: ["f", "g", "h"],
+            buttonsVisible: "always",
+            visibleLabel: "the visible label",
+            ariaLabel: "the aria label",
+        });
+    });
+});

packages/perseus-core/src/utils/expression-util.ts

@@ -0,0 +1,33 @@
+import type {PerseusExpressionWidgetOptions} from "@khanacademy/perseus-core";
+
+/**
+ * For details on the individual options, see the
+ * PerseusExpressionWidgetOptions type
+ */
+type ExpressionPublicWidgetOptions = {
+    buttonSets: PerseusExpressionWidgetOptions["buttonSets"];
+    functions: PerseusExpressionWidgetOptions["functions"];
+    times: PerseusExpressionWidgetOptions["times"];
+    visibleLabel?: PerseusExpressionWidgetOptions["visibleLabel"];
+    ariaLabel?: PerseusExpressionWidgetOptions["ariaLabel"];
+    buttonsVisible?: PerseusExpressionWidgetOptions["buttonsVisible"];
+};
+
+/**
+ * Given a PerseusExpressionWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getExpressionPublicWidgetOptions(
+    options: PerseusExpressionWidgetOptions,
+): ExpressionPublicWidgetOptions {
+    return {
+        buttonSets: options.buttonSets,
+        functions: options.functions,
+        times: options.times,
+        visibleLabel: options.visibleLabel,
+        ariaLabel: options.ariaLabel,
+        buttonsVisible: options.buttonsVisible,
+    };
+}
+
+export default getExpressionPublicWidgetOptions;

packages/perseus/src/types.ts

@@ -14,6 +14,7 @@ import type {
     Version,
     WidgetOptionsUpgradeMap,
     getOrdererPublicWidgetOptions,
+    getExpressionPublicWidgetOptions,
 } from "@khanacademy/perseus-core";
 import type {LinterContextProps} from "@khanacademy/perseus-linter";
 import type {
@@ -541,7 +542,8 @@ export type WidgetScorerFunction = (
  */
 export type PublicWidgetOptionsFunction =
     | typeof getCategorizerPublicWidgetOptions
-    | typeof getOrdererPublicWidgetOptions;
+    | typeof getOrdererPublicWidgetOptions
+    | typeof getExpressionPublicWidgetOptions;
 
 export type WidgetExports<
     T extends React.ComponentType<any> & Widget = React.ComponentType<any>,

packages/perseus/src/widgets/expression/expression.tsx

@@ -4,6 +4,7 @@ import {
     getDecimalSeparator,
     expressionLogic,
     type PerseusExpressionWidgetOptions,
+    getExpressionPublicWidgetOptions,
 } from "@khanacademy/perseus-core";
 import {linterContextDefault} from "@khanacademy/perseus-linter";
 import {scoreExpression, validateExpression} from "@khanacademy/perseus-score";
@@ -542,6 +543,7 @@ export default {
     // TODO(LEMS-2656): remove TS suppression
     // @ts-expect-error: Type 'UserInput' is not assignable to type 'PerseusExpressionUserInput'.
     validator: validateExpression,
+    getPublicWidgetOptions: getExpressionPublicWidgetOptions,
 
     // TODO(LEMS-2656): remove TS suppression
     // @ts-expect-error: Type 'ScoringData' is not assignable to type 'PerseusExpressionScoringData'.