Create a function to get the public options for a Matrix widget (#2207)

Issue: https://khanacademy.atlassian.net/browse/LEMS-2762

## Test plan:

`yarn test`

Author: benchristel

Reviewers: Myranae, handeyeco, jeremywiebe

Required Reviewers:

Approved By: Myranae

Checks: ✅ Publish npm snapshot (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), ✅ Check for .changeset entries for all changed files (ubuntu-latest, 20.x), ✅ Publish Storybook to Chromatic (ubuntu-latest, 20.x)

Pull Request URL: #2207

.changeset/lazy-shirts-fix.md

@@ -0,0 +1,6 @@
+---
+"@khanacademy/perseus": minor
+"@khanacademy/perseus-core": minor
+---
+
+Create a function to get the public options for a Matrix widget

packages/perseus-core/src/index.ts

@@ -136,3 +136,4 @@ export {default as getNumberLinePublicWidgetOptions} from "./widgets/number-line
 export {default as getRadioPublicWidgetOptions} from "./widgets/radio/radio-util";
 export {default as getTablePublicWidgetOptions} from "./widgets/table/table-util";
 export {default as getIFramePublicWidgetOptions} from "./widgets/iframe/iframe-util";
+export {default as getMatrixPublicWidgetOptions} from "./widgets/matrix/matrix-util";

packages/perseus-core/src/widgets/matrix/matrix-util.test.ts

@@ -0,0 +1,27 @@
+import getMatrixPublicWidgetOptions from "./matrix-util";
+
+import type {PerseusMatrixWidgetOptions} from "../../data-schema";
+
+describe("getMatrixPublicWidgetOptions", () => {
+    it("removes the `answers` field", () => {
+        const options: PerseusMatrixWidgetOptions = {
+            answers: [
+                [1, 2],
+                [3, 4],
+            ],
+            cursorPosition: [0, 0],
+            matrixBoardSize: [2, 2],
+            prefix: "the prefix",
+            suffix: "the suffix",
+        };
+
+        const publicOptions = getMatrixPublicWidgetOptions(options);
+
+        expect(publicOptions).toEqual({
+            cursorPosition: [0, 0],
+            matrixBoardSize: [2, 2],
+            prefix: "the prefix",
+            suffix: "the suffix",
+        });
+    });
+});

packages/perseus-core/src/widgets/matrix/matrix-util.ts

@@ -0,0 +1,13 @@
+import type {PerseusMatrixWidgetOptions} from "@khanacademy/perseus-core";
+
+type MatrixPublicWidgetOptions = Pick<
+    PerseusMatrixWidgetOptions,
+    "prefix" | "suffix" | "cursorPosition" | "matrixBoardSize" | "static"
+>;
+
+export default function getMatrixPublicWidgetOptions(
+    options: PerseusMatrixWidgetOptions,
+): MatrixPublicWidgetOptions {
+    const {answers: _, ...publicOptions} = options;
+    return publicOptions;
+}

packages/perseus/src/types.ts

@@ -34,6 +34,7 @@ import type {
     getRadioPublicWidgetOptions,
     getTablePublicWidgetOptions,
     getIFramePublicWidgetOptions,
+    getMatrixPublicWidgetOptions,
 } from "@khanacademy/perseus-core";
 import type {LinterContextProps} from "@khanacademy/perseus-linter";
 import type {
@@ -504,7 +505,8 @@ export type PublicWidgetOptionsFunction =
     | typeof getCSProgramPublicWidgetOptions
     | typeof getNumberLinePublicWidgetOptions
     | typeof getTablePublicWidgetOptions
-    | typeof getGrapherPublicWidgetOptions;
+    | typeof getGrapherPublicWidgetOptions
+    | typeof getMatrixPublicWidgetOptions;
 
 export type WidgetExports<
     T extends React.ComponentType<any> & Widget = React.ComponentType<any>,

packages/perseus/src/widgets/matrix/matrix.tsx

@@ -1,4 +1,5 @@
 import {
+    getMatrixPublicWidgetOptions,
     getMatrixSize,
     type PerseusMatrixWidgetAnswers,
     type PerseusMatrixWidgetOptions,
@@ -572,4 +573,5 @@ export default {
     transform: propTransform,
     staticTransform: staticTransform,
     isLintable: true,
+    getPublicWidgetOptions: getMatrixPublicWidgetOptions,
 } satisfies WidgetExports<typeof Matrix>;