@khanacademy/perseus-core 3.5.0 → 3.7.0

package/dist/index.js

@@ -2,6 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var perseusCore = require('@khanacademy/perseus-core');
+
 /**
  * Adds the given perseus library version information to the __perseus_debug__
  * object and ensures that the object is attached to `globalThis` (`window` in
@@ -821,7 +823,7 @@ function times(n, iteratee, context) {
 }
 
 // Return a random integer between `min` and `max` (inclusive).
-function random(min, max) {
+function random$1(min, max) {
   if (max == null) {
     max = min;
     min = 0;
@@ -1564,14 +1566,14 @@ function toArray(obj) {
 function sample(obj, n, guard) {
   if (n == null || guard) {
     if (!isArrayLike(obj)) obj = values(obj);
-    return obj[random(obj.length - 1)];
+    return obj[random$1(obj.length - 1)];
   }
   var sample = toArray(obj);
   var length = getLength(sample);
   n = Math.max(Math.min(n, length), 0);
   var last = length - 1;
   for (var index = 0; index < n; index++) {
-    var rand = random(index, last);
+    var rand = random$1(index, last);
     var temp = sample[index];
     sample[index] = sample[rand];
     sample[rand] = temp;
@@ -1580,7 +1582,7 @@ function sample(obj, n, guard) {
 }
 
 // Shuffle a collection.
-function shuffle(obj) {
+function shuffle$1(obj) {
   return sample(obj, Infinity);
 }
 
@@ -1966,7 +1968,7 @@ var allExports = /*#__PURE__*/Object.freeze({
     matcher: matcher,
     matches: matcher,
     times: times,
-    random: random,
+    random: random$1,
     now: now,
     escape: escape,
     unescape: unescape,
@@ -2023,7 +2025,7 @@ var allExports = /*#__PURE__*/Object.freeze({
     where: where,
     max: max,
     min: min,
-    shuffle: shuffle,
+    shuffle: shuffle$1,
     sample: sample,
     sortBy: sortBy,
     groupBy: groupBy,
@@ -3075,7 +3077,7 @@ function parseWidget(parseType, parseOptions) {
     graded: optional(boolean),
     alignment: optional(string),
     options: parseOptions,
-    key: optional(number),
+    key: optional(nullable(number)),
     version: optional(object({
       major: number,
       minor: number
@@ -3155,6 +3157,13 @@ function convert(f) {
   return (rawValue, ctx) => ctx.success(f(rawValue));
 }
 
+const parseLegacyButtonSet = enumeration("basic", "basic+div", "trig", "prealgebra", "logarithms", "basic relations", "advanced relations", "scientific");
+const parseLegacyButtonSets = defaulted(array(parseLegacyButtonSet),
+// NOTE(benchristel): I copied the default buttonSets from
+// expression.tsx. See the parse-perseus-json/README.md for
+// an explanation of why we want to duplicate the default here.
+() => ["basic", "trig", "prealgebra", "logarithms"]);
+
 /**
  * Creates a parser for a widget options type with multiple major versions. Old
  * versions are migrated to the latest version. The parse fails if the input
@@ -3244,11 +3253,6 @@ function removeInvalidAnswerForms(possiblyInvalid) {
   }
   return valid;
 }
-
-// NOTE(benchristel): I copied the default buttonSets from
-// expression.tsx. See the parse-perseus-json/README.md for
-// an explanation of why we want to duplicate the default here.
-const parseButtonSets = defaulted(array(enumeration("basic", "basic+div", "trig", "prealgebra", "logarithms", "basic relations", "advanced relations")), () => ["basic", "trig", "prealgebra", "logarithms"]);
 const version1 = object({
   major: constant(1),
   minor: number
@@ -3259,7 +3263,7 @@ const parseExpressionWidgetV1 = parseWidgetWithVersion(version1, constant("expre
   times: boolean,
   visibleLabel: optional(string),
   ariaLabel: optional(string),
-  buttonSets: parseButtonSets,
+  buttonSets: parseLegacyButtonSets,
   buttonsVisible: optional(enumeration("always", "never", "focused"))
 }));
 const version0 = optional(object({
@@ -3274,7 +3278,7 @@ const parseExpressionWidgetV0 = parseWidgetWithVersion(version0, constant("expre
   form: boolean,
   simplify: boolean,
   value: string,
-  buttonSets: parseButtonSets,
+  buttonSets: parseLegacyButtonSets,
   buttonsVisible: optional(enumeration("always", "never", "focused"))
 }));
 function migrateV0ToV1(widget) {
@@ -3461,14 +3465,15 @@ const imageDimensionToNumber = pipeParsers(union(number).or(string).parser)
 // string parses to either NaN (using parseInt) or 0 (using unary +) and
 // CSS will treat NaN as invalid and default to 0 instead.
 .then(convert(emptyToZero)).then(stringToNumber).parser;
+const dimensionOrUndefined = defaulted(imageDimensionToNumber, () => undefined);
 const parsePerseusImageBackground = object({
   url: optional(nullable(string)),
-  width: optional(imageDimensionToNumber),
-  height: optional(imageDimensionToNumber),
-  top: optional(imageDimensionToNumber),
-  left: optional(imageDimensionToNumber),
-  bottom: optional(imageDimensionToNumber),
-  scale: optional(imageDimensionToNumber)
+  width: dimensionOrUndefined,
+  height: dimensionOrUndefined,
+  top: dimensionOrUndefined,
+  left: dimensionOrUndefined,
+  bottom: dimensionOrUndefined,
+  scale: dimensionOrUndefined
 });
 
 const pairOfNumbers$2 = pair(number, number);
@@ -4209,7 +4214,7 @@ const parseNumericInputWidget = parseWidget(constant("numeric-input"), object({
     // the data, simplify this.
     value: optional(nullable(number)),
     status: string,
-    answerForms: optional(array(parseMathFormat)),
+    answerForms: defaulted(array(parseMathFormat), () => undefined),
     strict: boolean,
     maxError: optional(nullable(number)),
     // TODO(benchristel): simplify should never be a boolean, but we
@@ -4307,7 +4312,7 @@ const parseRadioWidget = parseWidget(constant("radio"), object({
     // There is an import cycle between radio-widget.ts and
     // widgets-map.ts. The anonymous function below ensures that we
     // don't refer to parseWidgetsMap before it's defined.
-    widgets: optional((rawVal, ctx) => parseWidgetsMap(rawVal, ctx))
+    widgets: defaulted((rawVal, ctx) => parseWidgetsMap(rawVal, ctx), () => undefined)
   })),
   hasNoneOfTheAbove: optional(boolean),
   countChoices: optional(boolean),
@@ -4461,13 +4466,17 @@ const parseDeprecatedWidget = parseWidget(
 (_, ctx) => ctx.success("deprecated-standin"),
 // Allow any widget options
 object({}));
-const parseStringToPositiveInt = (rawValue, ctx) => {
-  if (typeof rawValue !== "string" || !/^[1-9][0-9]*$/.test(rawValue)) {
-    return ctx.failure("a string representing a positive integer", rawValue);
+const parseStringToNonNegativeInt = (rawValue, ctx) => {
+  // The article renderer seems to allow the numeric part of a widget ID to
+  // be 0, at least for image widgets. However, if widget IDs in an exercise
+  // contain 0, the exercise renderer will blow up. We allow 0 here for
+  // compatibility with articles.
+  if (typeof rawValue !== "string" || !/^(0|[1-9][0-9]*)$/.test(rawValue)) {
+    return ctx.failure("a string representing a non-negative integer", rawValue);
   }
   return ctx.success(+rawValue);
 };
-const parseWidgetIdComponents = pair(string, parseStringToPositiveInt);
+const parseWidgetIdComponents = pair(string, parseStringToNonNegativeInt);
 
 const parsePerseusRenderer = defaulted(object({
   // TODO(benchristel): content is also defaulted to empty string in
@@ -4478,8 +4487,9 @@ const parsePerseusRenderer = defaulted(object({
   // The anonymous function below ensures that we don't try to access
   // parseWidgetsMap before it's defined.
   widgets: defaulted((rawVal, ctx) => parseWidgetsMap(rawVal, ctx), () => ({})),
-  metadata: optional(array(string)),
-  images: parseImages
+  images: parseImages,
+  // deprecated
+  metadata: any
 }),
 // Default value
 () => ({
@@ -4494,14 +4504,44 @@ const parseHint = object({
   replace: optional(boolean),
   content: string,
   widgets: defaulted(parseWidgetsMap, () => ({})),
-  metadata: optional(array(string)),
-  images: parseImages
+  images: parseImages,
+  // deprecated
+  metadata: any
 });
 
+const parsePerseusAnswerArea = pipeParsers(defaulted(object({}), () => ({}))).then(convert(toAnswerArea)).parser;
+
+// Some answerAreas have extra, bogus fields, like:
+//
+//   "answerArea": {
+//     "type": "multiple",
+//     "options": {},
+//     "version": null,
+//     "static": false,
+//     "graded": false,
+//     "alignment": "",
+//   }
+//
+// This function filters the fields of an answerArea object, keeping only the
+// known ones, and converts `undefined` and `null` values to `false`.
+function toAnswerArea(raw) {
+  return {
+    zTable: !!raw.zTable,
+    calculator: !!raw.calculator,
+    chi2Table: !!raw.chi2Table,
+    financialCalculatorMonthlyPayment: !!raw.financialCalculatorMonthlyPayment,
+    financialCalculatorTotalAmount: !!raw.financialCalculatorTotalAmount,
+    financialCalculatorTimeToPayOff: !!raw.financialCalculatorTimeToPayOff,
+    periodicTable: !!raw.periodicTable,
+    periodicTableWithKey: !!raw.periodicTableWithKey,
+    tTable: !!raw.tTable
+  };
+}
+
 const parsePerseusItem$1 = object({
   question: parsePerseusRenderer,
   hints: defaulted(array(parseHint), () => []),
-  answerArea: pipeParsers(defaulted(object({}), () => ({}))).then(migrateAnswerArea).then(record(enumeration(...ItemExtras), boolean)).parser,
+  answerArea: parsePerseusAnswerArea,
   itemDataVersion: optional(object({
     major: number,
     minor: number
@@ -4510,28 +4550,6 @@ const parsePerseusItem$1 = object({
   answer: any
 });
 
-// Some answerAreas have extra fields, like:
-//
-//   "answerArea": {
-//     "type": "multiple",
-//     "options": {
-//       "content": "",
-//       "images": {},
-//       "widgets": {}
-//     }
-//   }
-//
-// The "type" and "options" fields don't seem to be used anywhere. This
-// migration function removes them.
-function migrateAnswerArea(rawValue, ctx) {
-  const {
-    type: _,
-    options: __,
-    ...rest
-  } = rawValue;
-  return ctx.success(rest);
-}
-
 /**
  * Helper to parse PerseusItem JSON
  * Why not just use JSON.parse? We want:
@@ -4606,7 +4624,7 @@ function throwErrorIfCheatingDetected() {
 
 // This file is processed by a Rollup plugin (replace) to inject the production
 const libName = "@khanacademy/perseus-core";
-const libVersion = "3.5.0";
+const libVersion = "3.7.0";
 addLibraryVersionToPerseusDebug(libName, libVersion);
 
 /**
@@ -4705,6 +4723,24 @@ const mapObject = function (obj, lambda) {
   return result;
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusCategorizerWidgetOptions type
+ */
+
+/**
+ * Given a PerseusCategorizerWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getCategorizerPublicWidgetOptions(options) {
+  return {
+    items: options.items,
+    categories: options.categories,
+    randomizeItems: options.randomizeItems,
+    static: options.static
+  };
+}
+
 const defaultWidgetOptions$v = {
   items: [],
   categories: [],
@@ -4713,9 +4749,14 @@ const defaultWidgetOptions$v = {
 };
 const categorizerWidgetLogic = {
   name: "categorizer",
-  defaultWidgetOptions: defaultWidgetOptions$v
+  defaultWidgetOptions: defaultWidgetOptions$v,
+  getPublicWidgetOptions: getCategorizerPublicWidgetOptions
 };
 
+function getCSProgramPublicWidgetOptions(options) {
+  return options;
+}
+
 const DEFAULT_HEIGHT = 400;
 const defaultWidgetOptions$u = {
   programID: "",
@@ -4731,7 +4772,8 @@ const defaultWidgetOptions$u = {
 const csProgramWidgetLogic = {
   name: "cs-program",
   defaultWidgetOptions: defaultWidgetOptions$u,
-  supportedAlignments: ["block", "full-width"]
+  supportedAlignments: ["block", "full-width"],
+  getPublicWidgetOptions: getCSProgramPublicWidgetOptions
 };
 
 const defaultWidgetOptions$t = {
@@ -4744,6 +4786,27 @@ const definitionWidgetLogic = {
   defaultAlignment: "inline"
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusDropdownWidgetOptions type
+ */
+
+/**
+ * Given a PerseusDropdownWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getDropdownPublicWidgetOptions(options) {
+  return {
+    choices: options.choices.map(choice => ({
+      content: choice.content
+    })),
+    placeholder: options.placeholder,
+    static: options.static,
+    visibleLabel: options.visibleLabel,
+    ariaLabel: options.ariaLabel
+  };
+}
+
 const defaultWidgetOptions$s = {
   placeholder: "",
   choices: [{
@@ -4754,7 +4817,8 @@ const defaultWidgetOptions$s = {
 const dropdownWidgetLogic = {
   name: "definition",
   defaultWidgetOptions: defaultWidgetOptions$s,
-  defaultAlignment: "inline-block"
+  defaultAlignment: "inline-block",
+  getPublicWidgetOptions: getDropdownPublicWidgetOptions
 };
 
 const defaultWidgetOptions$r = {
@@ -4796,12 +4860,33 @@ const defaultWidgetOptions$q = {
   functions: ["f", "g", "h"]
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusExpressionWidgetOptions type
+ */
+
+/**
+ * Given a PerseusExpressionWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getExpressionPublicWidgetOptions(options) {
+  return {
+    buttonSets: options.buttonSets,
+    functions: options.functions,
+    times: options.times,
+    visibleLabel: options.visibleLabel,
+    ariaLabel: options.ariaLabel,
+    buttonsVisible: options.buttonsVisible
+  };
+}
+
 const expressionWidgetLogic = {
   name: "expression",
   version: currentVersion$3,
   widgetOptionsUpgrades: widgetOptionsUpgrades$2,
   defaultWidgetOptions: defaultWidgetOptions$q,
-  defaultAlignment: "inline-block"
+  defaultAlignment: "inline-block",
+  getPublicWidgetOptions: getExpressionPublicWidgetOptions
 };
 
 const defaultWidgetOptions$p = {
@@ -4824,6 +4909,14 @@ const gradedGroupSetWidgetLogic = {
   defaultWidgetOptions: defaultWidgetOptions$o
 };
 
+function getGrapherPublicWidgetOptions(options) {
+  const {
+    correct: _,
+    ...publicOptions
+  } = options;
+  return publicOptions;
+}
+
 const defaultWidgetOptions$n = {
   graph: {
     labels: ["x", "y"],
@@ -4846,22 +4939,24 @@ const defaultWidgetOptions$n = {
 };
 const grapherWidgetLogic = {
   name: "grapher",
-  defaultWidgetOptions: defaultWidgetOptions$n
+  defaultWidgetOptions: defaultWidgetOptions$n,
+  getPublicWidgetOptions: getGrapherPublicWidgetOptions
 };
 
 const defaultWidgetOptions$m = {
   content: "",
   widgets: {},
-  images: {},
-  // `undefined` instead of `null` so that getDefaultProps works for
-  // `the GroupMetadataEditor`
-  metadata: undefined
+  images: {}
 };
 const groupWidgetLogic = {
   name: "group",
   defaultWidgetOptions: defaultWidgetOptions$m
 };
 
+function getIFramePublicWidgetOptions(options) {
+  return options;
+}
+
 const defaultWidgetOptions$l = {
   url: "",
   settings: [{
@@ -4875,7 +4970,8 @@ const defaultWidgetOptions$l = {
 };
 const iframeWidgetLogic = {
   name: "iframe",
-  defaultWidgetOptions: defaultWidgetOptions$l
+  defaultWidgetOptions: defaultWidgetOptions$l,
+  getPublicWidgetOptions: getIFramePublicWidgetOptions
 };
 
 const defaultWidgetOptions$k = {
@@ -4929,6 +5025,14 @@ const interactionWidgetLogic = {
   defaultWidgetOptions: defaultWidgetOptions$i
 };
 
+function getInteractiveGraphPublicWidgetOptions(options) {
+  const {
+    correct: _,
+    ...publicOptions
+  } = options;
+  return publicOptions;
+}
+
 const defaultWidgetOptions$h = {
   labels: ["x", "y"],
   range: [[-10, 10], [-10, 10]],
@@ -4949,9 +5053,29 @@ const defaultWidgetOptions$h = {
 };
 const interactiveGraphWidgetLogic = {
   name: "interactive-graph",
-  defaultWidgetOptions: defaultWidgetOptions$h
+  defaultWidgetOptions: defaultWidgetOptions$h,
+  getPublicWidgetOptions: getInteractiveGraphPublicWidgetOptions
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusLabelImageWidgetOptions type
+ */
+
+function getLabelImagePublicWidgetOptions(options) {
+  return {
+    ...options,
+    markers: options.markers.map(getLabelImageMarkerPublicData)
+  };
+}
+function getLabelImageMarkerPublicData(marker) {
+  const {
+    answers: _,
+    ...publicData
+  } = marker;
+  return publicData;
+}
+
 const defaultWidgetOptions$g = {
   choices: [],
   imageAlt: "",
@@ -4964,9 +5088,68 @@ const defaultWidgetOptions$g = {
 };
 const labelImageWidgetLogic = {
   name: "label-image",
-  defaultWidgetOptions: defaultWidgetOptions$g
+  defaultWidgetOptions: defaultWidgetOptions$g,
+  getPublicWidgetOptions: getLabelImagePublicWidgetOptions
+};
+
+// TODO(LEMS-2841): Should be able to remove once getPublicWidgetOptions is hooked up
+
+// TODO(LEMS-2841): Should be able to remove once getPublicWidgetOptions is hooked up
+const shuffleMatcher = props => {
+  // Use the same random() function to shuffle both columns sequentially
+  const rng = perseusCore.seededRNG(props.problemNum);
+  let left;
+  if (!props.orderMatters) {
+    // If the order doesn't matter, don't shuffle the left column
+    left = props.left;
+  } else {
+    left = perseusCore.shuffle(props.left, rng, /* ensurePermuted */true);
+  }
+  const right = perseusCore.shuffle(props.right, rng, /* ensurePermuted */true);
+  return {
+    left,
+    right
+  };
 };
 
+// TODO(LEMS-2841): Can shorten to shuffleMatcher after above function removed
+function shuffleMatcherWithRandom(data) {
+  // Use the same random() function to shuffle both columns sequentially
+  let left;
+  if (!data.orderMatters) {
+    // If the order doesn't matter, don't shuffle the left column
+    left = data.left;
+  } else {
+    left = perseusCore.shuffle(data.left, Math.random, /* ensurePermuted */true);
+  }
+  const right = perseusCore.shuffle(data.right, Math.random, /* ensurePermuted */true);
+  return {
+    left,
+    right
+  };
+}
+
+/**
+ * For details on the individual options, see the
+ * PerseusMatcherWidgetOptions type
+ */
+
+/**
+ * Given a PerseusMatcherWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getMatcherPublicWidgetOptions(options) {
+  const {
+    left,
+    right
+  } = shuffleMatcherWithRandom(options);
+  return {
+    ...options,
+    left: left,
+    right: right
+  };
+}
+
 const defaultWidgetOptions$f = {
   left: ["$x$", "$y$", "$z$"],
   right: ["$1$", "$2$", "$3$"],
@@ -4976,9 +5159,18 @@ const defaultWidgetOptions$f = {
 };
 const matcherWidgetLogic = {
   name: "matcher",
-  defaultWidgetOptions: defaultWidgetOptions$f
+  defaultWidgetOptions: defaultWidgetOptions$f,
+  getPublicWidgetOptions: getMatcherPublicWidgetOptions
 };
 
+function getMatrixPublicWidgetOptions(options) {
+  const {
+    answers: _,
+    ...publicOptions
+  } = options;
+  return publicOptions;
+}
+
 const defaultWidgetOptions$e = {
   matrixBoardSize: [3, 3],
   answers: [[]],
@@ -4988,7 +5180,8 @@ const defaultWidgetOptions$e = {
 };
 const matrixWidgetLogic = {
   name: "matrix",
-  defaultWidgetOptions: defaultWidgetOptions$e
+  defaultWidgetOptions: defaultWidgetOptions$e,
+  getPublicWidgetOptions: getMatrixPublicWidgetOptions
 };
 
 const currentVersion$2 = {
@@ -5031,6 +5224,15 @@ const measurerWidgetLogic = {
   defaultWidgetOptions: defaultWidgetOptions$d
 };
 
+function getNumberLinePublicWidgetOptions(options) {
+  const {
+    correctX: _,
+    correctRel: __,
+    ...publicOptions
+  } = options;
+  return publicOptions;
+}
+
 const defaultWidgetOptions$c = {
   range: [0, 10],
   labelRange: [null, null],
@@ -5047,9 +5249,27 @@ const defaultWidgetOptions$c = {
 };
 const numberLineWidgetLogic = {
   name: "number-line",
-  defaultWidgetOptions: defaultWidgetOptions$c
+  defaultWidgetOptions: defaultWidgetOptions$c,
+  getPublicWidgetOptions: getNumberLinePublicWidgetOptions
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusNumericInputWidgetOptions type
+ */
+
+/**
+ * Given a PerseusNumericInputWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getNumericInputPublicWidgetOptions(options) {
+  const {
+    answers: _,
+    ...publicWidgetOptions
+  } = options;
+  return publicWidgetOptions;
+}
+
 const defaultWidgetOptions$b = {
   answers: [{
     value: null,
@@ -5068,9 +5288,27 @@ const defaultWidgetOptions$b = {
 const numericInputWidgetLogic = {
   name: "numeric-input",
   defaultWidgetOptions: defaultWidgetOptions$b,
-  defaultAlignment: "inline-block"
+  defaultAlignment: "inline-block",
+  getPublicWidgetOptions: getNumericInputPublicWidgetOptions
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusOrdererWidgetOptions type
+ */
+
+/**
+ * Given a PerseusOrdererWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getOrdererPublicWidgetOptions(options) {
+  return {
+    options: options.options,
+    height: options.height,
+    layout: options.layout
+  };
+}
+
 const defaultWidgetOptions$a = {
   correctOptions: [{
     content: "$x$"
@@ -5083,7 +5321,8 @@ const defaultWidgetOptions$a = {
 };
 const ordererWidgetLogic = {
   name: "orderer",
-  defaultWidgetOptions: defaultWidgetOptions$a
+  defaultWidgetOptions: defaultWidgetOptions$a,
+  getPublicWidgetOptions: getOrdererPublicWidgetOptions
 };
 
 const defaultWidgetOptions$9 = {
@@ -5132,6 +5371,23 @@ const phetSimulationWidgetLogic = {
   defaultWidgetOptions: defaultWidgetOptions$6
 };
 
+/**
+ * For details on the individual options, see the
+ * PerseusPlotterWidgetOptions type
+ */
+
+/**
+ * Given a PerseusPlotterWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getPlotterPublicWidgetOptions(options) {
+  const {
+    correct: _,
+    ...publicOptions
+  } = options;
+  return publicOptions;
+}
+
 const defaultWidgetOptions$5 = {
   scaleY: 1,
   maxY: 10,
@@ -5149,7 +5405,8 @@ const defaultWidgetOptions$5 = {
 };
 const plotterWidgetLogic = {
   name: "plotter",
-  defaultWidgetOptions: defaultWidgetOptions$5
+  defaultWidgetOptions: defaultWidgetOptions$5,
+  getPublicWidgetOptions: getPlotterPublicWidgetOptions
 };
 
 const defaultWidgetOptions$4 = {
@@ -5190,27 +5447,98 @@ const defaultWidgetOptions$3 = {
   deselectEnabled: false
 };
 
-const radioWidgetLogic = {
-  name: "radio",
-  version: currentVersion,
-  widgetOptionsUpgrades: widgetOptionsUpgrades,
-  defaultWidgetOptions: defaultWidgetOptions$3
-};
-
-const defaultWidgetOptions$2 = {
-  correct: ["$x$", "$y$", "$z$"],
-  layout: "horizontal",
-  padding: true
-};
-const sorterWidgetLogic = {
-  name: "sorter",
-  defaultWidgetOptions: defaultWidgetOptions$2
-};
+/**
+ * For details on the individual options, see the
+ * PerseusRadioWidgetOptions type
+ */
 
-const defaultRows = 4;
-const defaultColumns = 1;
+/**
+ * Only the options from each Radio choice that should be exposed to the client.
+ */
 
-// initialize a 2D array
+/**
+ * Given a PerseusRadioChoice object, return a new object with only the public
+ * data that should be included in the Radio public widget options.
+ */
+function getRadioChoicePublicData(choice) {
+  const {
+    content,
+    isNoneOfTheAbove,
+    widgets
+  } = choice;
+  return {
+    content,
+    isNoneOfTheAbove,
+    widgets
+  };
+}
+
+/**
+ * Given a PerseusRadioWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getRadioPublicWidgetOptions(options) {
+  return {
+    ...options,
+    choices: options.choices.map(getRadioChoicePublicData)
+  };
+}
+
+const radioWidgetLogic = {
+  name: "radio",
+  version: currentVersion,
+  widgetOptionsUpgrades: widgetOptionsUpgrades,
+  defaultWidgetOptions: defaultWidgetOptions$3,
+  getPublicWidgetOptions: getRadioPublicWidgetOptions
+};
+
+/**
+ * For details on the individual options, see the
+ * PerseusSorterWidgetOptions type
+ */
+
+/**
+ * Given a PerseusSorterWidgetOptions object, return a new object with only
+ * the public options that should be exposed to the client.
+ */
+function getSorterPublicWidgetOptions(options) {
+  const shuffledCorrect = perseusCore.shuffle(options.correct, Math.random, /* ensurePermuted */true);
+  return {
+    ...options,
+    // Note(Tamara): This does not provide correct answer information any longer.
+    // To maintain compatibility with the original widget options, we are
+    // keeping the key the same. Represents initial state of the cards here.
+    correct: shuffledCorrect,
+    // Note(Tamara): This new key is only added here with "true". There isn't
+    // a place where it is set to false. It indicates that the correct field
+    // has been shuffled and no longer contains correct answer info.
+    isCorrectShuffled: true
+  };
+}
+
+const defaultWidgetOptions$2 = {
+  correct: ["$x$", "$y$", "$z$"],
+  layout: "horizontal",
+  padding: true
+};
+const sorterWidgetLogic = {
+  name: "sorter",
+  defaultWidgetOptions: defaultWidgetOptions$2,
+  getPublicWidgetOptions: getSorterPublicWidgetOptions
+};
+
+function getTablePublicWidgetOptions(options) {
+  const {
+    answers: _,
+    ...publicOptions
+  } = options;
+  return publicOptions;
+}
+
+const defaultRows = 4;
+const defaultColumns = 1;
+
+// initialize a 2D array
 // (defaultRows x defaultColumns) of empty strings
 const answers = new Array(defaultRows).fill(0).map(() => new Array(defaultColumns).fill(""));
 const defaultWidgetOptions$1 = {
@@ -5221,7 +5549,8 @@ const defaultWidgetOptions$1 = {
 };
 const tableWidgetLogic = {
   name: "table",
-  defaultWidgetOptions: defaultWidgetOptions$1
+  defaultWidgetOptions: defaultWidgetOptions$1,
+  getPublicWidgetOptions: getTablePublicWidgetOptions
 };
 
 const defaultWidgetOptions = {
@@ -5249,6 +5578,12 @@ function getCurrentVersion(type) {
     minor: 0
   };
 }
+
+// TODO(LEMS-2870): getPublicWidgetOptionsFunction/PublicWidgetOptionsFunction
+// need better types
+const getPublicWidgetOptionsFunction = name => {
+  return widgets[name]?.getPublicWidgetOptions ?? (i => i);
+};
 function getWidgetOptionsUpgrades(type) {
   const widgetLogic = widgets[type];
   return widgetLogic?.widgetOptionsUpgrades || {};
@@ -5333,6 +5668,7 @@ var coreWidgetRegistry = /*#__PURE__*/Object.freeze({
     __proto__: null,
     isWidgetRegistered: isWidgetRegistered,
     getCurrentVersion: getCurrentVersion,
+    getPublicWidgetOptionsFunction: getPublicWidgetOptionsFunction,
     getWidgetOptionsUpgrades: getWidgetOptionsUpgrades,
     getDefaultWidgetOptions: getDefaultWidgetOptions,
     getSupportedAlignments: getSupportedAlignments,
@@ -5465,240 +5801,77 @@ function getUpgradedWidgetOptions(oldWidgetOptions) {
   });
 }
 
-/**
- * For details on the individual options, see the
- * PerseusOrdererWidgetOptions type
- */
-
-/**
- * Given a PerseusOrdererWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getOrdererPublicWidgetOptions(options) {
-  return {
-    options: options.options,
-    height: options.height,
-    layout: options.layout
-  };
-}
-
-/**
- * For details on the individual options, see the
- * PerseusCategorizerWidgetOptions type
- */
-
-/**
- * Given a PerseusCategorizerWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getCategorizerPublicWidgetOptions(options) {
-  return {
-    items: options.items,
-    categories: options.categories,
-    randomizeItems: options.randomizeItems,
-    static: options.static
-  };
-}
-
-function getCSProgramPublicWidgetOptions(options) {
-  return options;
-}
-
-/**
- * For details on the individual options, see the
- * PerseusExpressionWidgetOptions type
- */
-
-/**
- * Given a PerseusExpressionWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getExpressionPublicWidgetOptions(options) {
-  return {
-    buttonSets: options.buttonSets,
-    functions: options.functions,
-    times: options.times,
-    visibleLabel: options.visibleLabel,
-    ariaLabel: options.ariaLabel,
-    buttonsVisible: options.buttonsVisible
-  };
-}
-
-function getGrapherPublicWidgetOptions(options) {
-  const {
-    correct: _,
-    ...publicOptions
-  } = options;
-  return publicOptions;
-}
-
-function getInteractiveGraphPublicWidgetOptions(options) {
-  const {
-    correct: _,
-    ...publicOptions
-  } = options;
-  return publicOptions;
-}
-
-/**
- * For details on the individual options, see the
- * PerseusLabelImageWidgetOptions type
- */
-
-function getLabelImagePublicWidgetOptions(options) {
-  return {
-    ...options,
-    markers: options.markers.map(getLabelImageMarkerPublicData)
-  };
-}
-function getLabelImageMarkerPublicData(marker) {
-  const {
-    answers: _,
-    ...publicData
-  } = marker;
-  return publicData;
-}
-
-/**
- * For details on the individual options, see the
- * PerseusSorterWidgetOptions type
- */
-
-/**
- * Given a PerseusSorterWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getSorterPublicWidgetOptions(options) {
-  return {
-    // Note(Tamara): This does not provide correct answer information any longer.
-    // To maintain compatibility with the original widget options, we are
-    // keeping the key the same. Represents initial state of the cards here.
-    correct: options.correct.slice().sort(),
-    padding: options.padding,
-    layout: options.layout
-  };
-}
-
-/**
- * For details on the individual options, see the
- * PerseusDropdownWidgetOptions type
- */
-
-/**
- * Given a PerseusDropdownWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getDropdownPublicWidgetOptions(options) {
-  return {
-    choices: options.choices.map(choice => ({
-      content: choice.content
-    })),
-    placeholder: options.placeholder,
-    static: options.static,
-    visibleLabel: options.visibleLabel,
-    ariaLabel: options.ariaLabel
-  };
-}
-
-/**
- * For details on the individual options, see the
- * PerseusNumericInputWidgetOptions type
- */
-
-/**
- * Given a PerseusNumericInputWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getNumericInputPublicWidgetOptions(options) {
-  const {
-    answers: _,
-    ...publicWidgetOptions
-  } = options;
-  return publicWidgetOptions;
-}
-
-function getNumberLinePublicWidgetOptions(options) {
-  const {
-    correctX: _,
-    correctRel: __,
-    ...publicOptions
-  } = options;
-  return publicOptions;
-}
-
-/**
- * For details on the individual options, see the
- * PerseusRadioWidgetOptions type
- */
-
-/**
- * Only the options from each Radio choice that should be exposed to the client.
- */
-
-/**
- * Given a PerseusRadioChoice object, return a new object with only the public
- * data that should be included in the Radio public widget options.
- */
-function getRadioChoicePublicData(choice) {
-  const {
-    content,
-    isNoneOfTheAbove,
-    widgets
-  } = choice;
+function splitPerseusItem(originalItem) {
+  const item = _.clone(originalItem);
+  const originalWidgets = item.widgets ?? {};
+  const upgradedWidgets = getUpgradedWidgetOptions(originalWidgets);
+  const splitWidgets = {};
+  for (const [id, widget] of Object.entries(upgradedWidgets)) {
+    const publicWidgetOptionsFun = getPublicWidgetOptionsFunction(widget.type);
+    splitWidgets[id] = {
+      ...widget,
+      options: publicWidgetOptionsFun(widget.options)
+    };
+  }
   return {
-    content,
-    isNoneOfTheAbove,
-    widgets
+    ...item,
+    widgets: splitWidgets
   };
 }
 
-/**
- * Given a PerseusRadioWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getRadioPublicWidgetOptions(options) {
-  return {
-    ...options,
-    choices: options.choices.map(getRadioChoicePublicData)
+/* Note(tamara): Brought over from the perseus package packages/perseus/src/util.ts file.
+    May be useful to bring other perseus package utilities here. Contains utility functions
+    and types used across multiple widgets for randomization and shuffling. */
+const seededRNG = function (seed) {
+  let randomSeed = seed;
+  return function () {
+    // Robert Jenkins' 32 bit integer hash function.
+    let seed = randomSeed;
+    seed = seed + 0x7ed55d16 + (seed << 12) & 0xffffffff;
+    seed = (seed ^ 0xc761c23c ^ seed >>> 19) & 0xffffffff;
+    seed = seed + 0x165667b1 + (seed << 5) & 0xffffffff;
+    seed = (seed + 0xd3a2646c ^ seed << 9) & 0xffffffff;
+    seed = seed + 0xfd7046c5 + (seed << 3) & 0xffffffff;
+    seed = (seed ^ 0xb55a4f09 ^ seed >>> 16) & 0xffffffff;
+    return (randomSeed = seed & 0xfffffff) / 0x10000000;
   };
-}
-
-function getTablePublicWidgetOptions(options) {
-  const {
-    answers: _,
-    ...publicOptions
-  } = options;
-  return publicOptions;
-}
-
-function getIFramePublicWidgetOptions(options) {
-  return options;
-}
-
-function getMatrixPublicWidgetOptions(options) {
-  const {
-    answers: _,
-    ...publicOptions
-  } = options;
-  return publicOptions;
-}
-
-/**
- * For details on the individual options, see the
- * PerseusPlotterWidgetOptions type
- */
+};
 
-/**
- * Given a PerseusPlotterWidgetOptions object, return a new object with only
- * the public options that should be exposed to the client.
- */
-function getPlotterPublicWidgetOptions(options) {
-  const {
-    correct: _,
-    ...publicOptions
-  } = options;
-  return publicOptions;
+// Shuffle an array using a given random seed or function.
+// If `ensurePermuted` is true, the input and output are guaranteed to be
+// distinct permutations.
+function shuffle(array, randomSeed) {
+  let ensurePermuted = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+  // Always return a copy of the input array
+  const shuffled = _.clone(array);
+
+  // Handle edge cases (input array is empty or uniform)
+  if (!shuffled.length || _.all(shuffled, function (value) {
+    return _.isEqual(value, shuffled[0]);
+  })) {
+    return shuffled;
+  }
+  let random;
+  if (typeof randomSeed === "function") {
+    random = randomSeed;
+  } else {
+    random = seededRNG(randomSeed);
+  }
+  do {
+    // Fischer-Yates shuffle
+    for (let top = shuffled.length; top > 0; top--) {
+      const newEnd = Math.floor(random() * top);
+      const temp = shuffled[newEnd];
+
+      // @ts-expect-error - TS2542 - Index signature in type 'readonly T[]' only permits reading.
+      shuffled[newEnd] = shuffled[top - 1];
+      // @ts-expect-error - TS2542 - Index signature in type 'readonly T[]' only permits reading.
+      shuffled[top - 1] = temp;
+    }
+  } while (ensurePermuted && _.isEqual(array, shuffled));
+  return shuffled;
 }
+const random = seededRNG(new Date().getTime() & 0xffffffff);
 
 exports.CoreWidgetRegistry = coreWidgetRegistry;
 exports.Errors = Errors;
@@ -5726,6 +5899,7 @@ exports.getGrapherPublicWidgetOptions = getGrapherPublicWidgetOptions;
 exports.getIFramePublicWidgetOptions = getIFramePublicWidgetOptions;
 exports.getInteractiveGraphPublicWidgetOptions = getInteractiveGraphPublicWidgetOptions;
 exports.getLabelImagePublicWidgetOptions = getLabelImagePublicWidgetOptions;
+exports.getMatcherPublicWidgetOptions = getMatcherPublicWidgetOptions;
 exports.getMatrixPublicWidgetOptions = getMatrixPublicWidgetOptions;
 exports.getMatrixSize = getMatrixSize;
 exports.getNumberLinePublicWidgetOptions = getNumberLinePublicWidgetOptions;
@@ -5773,7 +5947,12 @@ exports.plotterPlotTypes = plotterPlotTypes;
 exports.pluck = pluck;
 exports.pythonProgramLogic = pythonProgramWidgetLogic;
 exports.radioLogic = radioWidgetLogic;
+exports.random = random;
+exports.seededRNG = seededRNG;
+exports.shuffle = shuffle;
+exports.shuffleMatcher = shuffleMatcher;
 exports.sorterLogic = sorterWidgetLogic;
+exports.splitPerseusItem = splitPerseusItem;
 exports.tableLogic = tableWidgetLogic;
 exports.upgradeWidgetInfoToLatestVersion = upgradeWidgetInfoToLatestVersion;
 exports.videoLogic = videoWidgetLogic;