@khanacademy/perseus-core 0.0.0-PR3089-20251204205538 → 0.0.0-PR3091-20251204213510

package/dist/utils/extract-perseus-ai-data.d.ts

@@ -0,0 +1,39 @@
+import type { PerseusItem, PerseusWidgetsMap, PerseusRenderer } from "../data-schema";
+/**
+ * This function extracts the answers from the widgets.
+ *
+ * For each widget type, we first check to make sure the path to the answer exists,
+ * then we extract the answer and add it to the list of answers.
+ *
+ * A list is returned because some widgets, like multi-select radio widgets and groups
+ * can have multiple answers.
+ *
+ * @param {PerseusRenderer["widgets"]} widgets
+ * @returns a list of strings that are the answers to the widgets
+ */
+export declare function getAnswersFromWidgets(widgets: PerseusRenderer["widgets"]): ReadonlyArray<string>;
+/**
+ * Inject a string equivalent of the widgets into the content.
+ *
+ * Content may contain Perseus widgets, that looks like this: '[[☃ Radio 1]]'.
+ * This function replaces those widgets with its equivalent string.
+ *
+ * @param {string} content
+ * @param {PerseusRenderer["widgets"]} widgets
+ * @returns
+ */
+export declare function injectWidgets(content: string, widgets: PerseusRenderer["widgets"], widgetProps?: PerseusWidgetsMap): string;
+/**
+ * Get AI-ready data from a Perseus item for Khanmigo.
+ *
+ * This function extracts the correct answers from widgets and injects
+ * widget content into hints to provide Khanmigo with the context it needs
+ * to help students without requiring React rendering.
+ *
+ * @param {PerseusItem} perseusItem - The Perseus item containing question and hints
+ * @returns Object containing answers and processed hints
+ */
+export declare function getPerseusAIData(perseusItem: PerseusItem): {
+    answers: ReadonlyArray<string>;
+    hints: ReadonlyArray<string>;
+};

package/dist/validation.types.d.ts

@@ -28,7 +28,7 @@
  * } & Perseus<Widget>ValidationData;
  * ```
  */
-import type { GrapherAnswerTypes, PerseusDropdownChoice, PerseusExpressionAnswerForm, PerseusGradedGroupSetWidgetOptions, PerseusGradedGroupWidgetOptions, PerseusGraphType, PerseusGroupWidgetOptions, PerseusMatrixWidgetAnswers, PerseusNumericInputAnswer, PerseusOrdererWidgetOptions, PerseusRadioChoice, PerseusGraphCorrectType, MakeWidgetMap, PerseusFreeResponseWidgetScoringCriterion, PerseusRenderer } from "./data-schema";
+import type { GrapherAnswerTypes, PerseusDropdownChoice, PerseusExpressionAnswerForm, PerseusGradedGroupSetWidgetOptions, PerseusGradedGroupWidgetOptions, PerseusGraphType, PerseusGroupWidgetOptions, PerseusMatrixWidgetAnswers, PerseusNumericInputAnswer, PerseusOrdererWidgetOptions, PerseusRadioChoice, PerseusGraphCorrectType, MakeWidgetMap, PerseusFreeResponseWidgetScoringCriterion } from "./data-schema";
 import type { ErrorCode } from "./error-codes";
 import type { Relationship } from "./types";
 export type WidgetValidatorFunction = (userInput: UserInput | undefined, validationData: ValidationData, locale: string) => ValidationResult;
@@ -72,7 +72,9 @@ export type PerseusExpressionRubric = {
 };
 export type PerseusExpressionUserInput = string;
 export type PerseusGroupRubric = PerseusGroupWidgetOptions;
-export type PerseusGroupValidationData = PerseusRenderer;
+export type PerseusGroupValidationData = {
+    widgets: ValidationDataMap;
+};
 export type PerseusGroupUserInput = UserInputMap;
 export type PerseusGradedGroupRubric = PerseusGradedGroupWidgetOptions;
 export type PerseusGradedGroupSetRubric = PerseusGradedGroupSetWidgetOptions;
@@ -265,6 +267,24 @@ export interface ValidationDataTypes {
     group: PerseusGroupValidationData;
     plotter: PerseusPlotterValidationData;
 }
+/**
+ * A map of validation data, keyed by `widgetId`. This data is used to check if
+ * a question is answerable. This data represents the minimal intersection of
+ * data that's available in the client (widget options) and server (scoring
+ * data) and is represented by a group of types known as "validation data".
+ *
+ * NOTE: The value in this map is intentionally a subset of WidgetOptions<T>.
+ * By using the same shape (minus any unneeded data), we are able to pass a
+ * `PerseusWidgetsMap` or ` into any function that accepts a
+ * `ValidationDataMap` without any mutation of data.
+ */
+export type ValidationDataMap = {
+    [Property in keyof ValidationDataTypes as `${Property} ${number}`]: {
+        type: Property;
+        static?: boolean;
+        options: ValidationDataTypes[Property];
+    };
+};
 /**
  * A union type of all the different widget validation data types that exist.
  */

package/dist/validation.typetest.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -3,7 +3,7 @@
   "description": "Shared Perseus infrastructure",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "0.0.0-PR3089-20251204205538",
+  "version": "0.0.0-PR3091-20251204213510",
   "publishConfig": {
     "access": "public"
   },