@khanacademy/perseus-core 0.0.0-PR3084-20251204231904 → 0.0.0-PR3084-20251218010953

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/utils/generators/definition-widget-generator.d.ts

@@ -0,0 +1,3 @@
+import type { DefinitionWidget, PerseusDefinitionWidgetOptions } from "../../data-schema";
+export declare function generateDefinitionOptions(options?: Partial<PerseusDefinitionWidgetOptions>): PerseusDefinitionWidgetOptions;
+export declare function generateDefinitionWidget(definitionWidgetProperties?: Partial<Omit<DefinitionWidget, "type">>): DefinitionWidget;

package/dist/utils/generators/dropdown-widget-generator.d.ts

@@ -0,0 +1,3 @@
+import type { DropdownWidget, PerseusDropdownWidgetOptions } from "../../data-schema";
+export declare function generateDropdownOptions(options?: Partial<PerseusDropdownWidgetOptions>): PerseusDropdownWidgetOptions;
+export declare function generateDropdownWidget(dropdownWidgetProperties?: Partial<Omit<DropdownWidget, "type">>): DropdownWidget;

package/dist/utils/generators/explanation-widget-generator.d.ts

@@ -0,0 +1,3 @@
+import type { ExplanationWidget, PerseusExplanationWidgetOptions } from "../../data-schema";
+export declare function generateExplanationOptions(options?: Partial<PerseusExplanationWidgetOptions>): PerseusExplanationWidgetOptions;
+export declare function generateExplanationWidget(explanationWidgetProperties?: Partial<Omit<ExplanationWidget, "type">>): ExplanationWidget;

package/dist/utils/generators/expression-widget-generator.d.ts

@@ -0,0 +1,4 @@
+import type { PerseusExpressionWidgetOptions, ExpressionWidget, PerseusExpressionAnswerForm } from "../../data-schema";
+export declare function generateExpressionOptions(options?: Partial<PerseusExpressionWidgetOptions>): PerseusExpressionWidgetOptions;
+export declare function generateExpressionAnswerForm(answerFormOptions?: Partial<PerseusExpressionAnswerForm>): PerseusExpressionAnswerForm;
+export declare function generateExpressionWidget(expressionWidgetProperties?: Partial<Omit<ExpressionWidget, "type">>): ExpressionWidget;

package/dist/utils/generators/graded-group-set-widget-generator.d.ts

@@ -0,0 +1,2 @@
+import type { GradedGroupSetWidget } from "../../data-schema";
+export declare function generateGradedGroupSetWidget(gradedGroupSetWidgetProperties?: Partial<Omit<GradedGroupSetWidget, "type">>): GradedGroupSetWidget;

package/dist/utils/generators/graded-group-widget-generator.d.ts

@@ -0,0 +1,3 @@
+import type { GradedGroupWidget, PerseusGradedGroupWidgetOptions } from "../../data-schema";
+export declare function generateGradedGroupOptions(options?: Partial<PerseusGradedGroupWidgetOptions>): PerseusGradedGroupWidgetOptions;
+export declare function generateGradedGroupWidget(gradedGroupWidgetProperties?: Partial<Omit<GradedGroupWidget, "type">>): GradedGroupWidget;

package/dist/utils/generators/group-widget-generator.d.ts

@@ -0,0 +1,3 @@
+import type { GroupWidget, PerseusGroupWidgetOptions } from "../../data-schema";
+export declare function generateGroupOptions(options?: Partial<PerseusGroupWidgetOptions>): PerseusGroupWidgetOptions;
+export declare function generateGroupWidget(groupWidgetProperties?: Partial<Omit<GroupWidget, "type">>): GroupWidget;

package/dist/utils/generators/interactive-graph-widget-generator.d.ts

@@ -0,0 +1,21 @@
+import type { InteractiveGraphWidget, LockedEllipseType, LockedFunctionType, LockedLabelType, LockedLineType, LockedPointType, LockedPolygonType, LockedVectorType, PerseusGraphTypeAngle, PerseusGraphTypeCircle, PerseusGraphTypeLinear, PerseusGraphTypeLinearSystem, PerseusGraphTypeNone, PerseusGraphTypePoint, PerseusGraphTypePolygon, PerseusGraphTypeQuadratic, PerseusGraphTypeRay, PerseusGraphTypeSegment, PerseusGraphTypeSinusoid, PerseusInteractiveGraphWidgetOptions } from "../../data-schema";
+export declare function generateInteractiveGraphWidget(interactiveGraphWidgetProperties?: Partial<Omit<InteractiveGraphWidget, "type">>): InteractiveGraphWidget;
+export declare function generateInteractiveGraphOptions(options?: Partial<PerseusInteractiveGraphWidgetOptions>): PerseusInteractiveGraphWidgetOptions;
+export declare function generateIGAngleGraph(options?: Partial<PerseusGraphTypeAngle>): PerseusGraphTypeAngle;
+export declare function generateIGCircleGraph(options?: Partial<PerseusGraphTypeCircle>): PerseusGraphTypeCircle;
+export declare function generateIGLinearGraph(options?: Partial<PerseusGraphTypeLinear>): PerseusGraphTypeLinear;
+export declare function generateIGLinearSystemGraph(options?: Partial<PerseusGraphTypeLinearSystem>): PerseusGraphTypeLinearSystem;
+export declare function generateIGNoneGraph(): PerseusGraphTypeNone;
+export declare function generateIGPointGraph(options?: Partial<Omit<PerseusGraphTypePoint, "type">>): PerseusGraphTypePoint;
+export declare function generateIGPolygonGraph(options?: Partial<Omit<PerseusGraphTypePolygon, "type">>): PerseusGraphTypePolygon;
+export declare function generateIGQuadraticGraph(options?: Partial<Omit<PerseusGraphTypeQuadratic, "type">>): PerseusGraphTypeQuadratic;
+export declare function generateIGRayGraph(options?: Partial<Omit<PerseusGraphTypeRay, "type">>): PerseusGraphTypeRay;
+export declare function generateIGSegmentGraph(options?: Partial<Omit<PerseusGraphTypeSegment, "type">>): PerseusGraphTypeSegment;
+export declare function generateIGSinusoidGraph(options?: Partial<Omit<PerseusGraphTypeSinusoid, "type">>): PerseusGraphTypeSinusoid;
+export declare function generateIGLockedPoint(options?: Partial<Omit<LockedPointType, "type">>): LockedPointType;
+export declare function generateIGLockedLine(options?: Partial<Omit<LockedLineType, "type">>): LockedLineType;
+export declare function generateIGLockedVector(options?: Partial<Omit<LockedVectorType, "type">>): LockedVectorType;
+export declare function generateIGLockedEllipse(options?: Partial<Omit<LockedEllipseType, "type">>): LockedEllipseType;
+export declare function generateIGLockedPolygon(options?: Partial<Omit<LockedPolygonType, "type">>): LockedPolygonType;
+export declare function generateIGLockedFunction(options?: Partial<Omit<LockedFunctionType, "type">>): LockedFunctionType;
+export declare function generateIGLockedLabel(options?: Partial<Omit<LockedLabelType, "type">>): LockedLabelType;

package/dist/utils/generators/label-image-widget-generator.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusLabelImageWidgetOptions, LabelImageWidget } from "../../data-schema";
+export declare function generateLabelImageOptions(options?: Partial<PerseusLabelImageWidgetOptions>): PerseusLabelImageWidgetOptions;
+export declare function generateLabelImageWidget(labelImageWidgetProperties?: Partial<Omit<LabelImageWidget, "type">>): LabelImageWidget;

package/dist/utils/generators/numeric-input-widget-generator.d.ts

@@ -0,0 +1,4 @@
+import type { PerseusNumericInputWidgetOptions, NumericInputWidget, PerseusNumericInputAnswer } from "../../data-schema";
+export declare function generateNumericInputOptions(options?: Partial<PerseusNumericInputWidgetOptions>): PerseusNumericInputWidgetOptions;
+export declare function generateNumericInputAnswer(answerOptions?: Partial<PerseusNumericInputAnswer>): PerseusNumericInputAnswer;
+export declare function generateNumericInputWidget(numericInputWidgetProperties?: Partial<Omit<NumericInputWidget, "type">>): NumericInputWidget;

package/dist/utils/generators/radio-widget-generator.d.ts

@@ -0,0 +1,16 @@
+import type { PerseusItem, PerseusRadioChoice, PerseusRadioWidgetOptions, RadioWidget } from "../../data-schema";
+export declare function generateRadioOptions(options?: Partial<PerseusRadioWidgetOptions>): PerseusRadioWidgetOptions;
+export declare function generateRadioWidget(radioWidgetProperties?: Partial<Omit<RadioWidget, "type">>): RadioWidget;
+export declare function generateRadioChoice(text: string, options?: Partial<PerseusRadioChoice>): PerseusRadioChoice;
+/**
+ * A simple question (PerseusRenderer) with a single radio widget,
+ * in which the `content` is only "[[☃ radio 1]]" and the widget has
+ * no properties other than the options.
+ */
+export declare function generateSimpleRadioQuestion(options?: Partial<PerseusRadioWidgetOptions>): import("../..").PerseusRenderer;
+/**
+ * A simple item (PerseusItem) with a single radio widget,
+ * in which the `content` is only "[[☃ radio 1]]" and the widget has
+ * no properties other than the options.
+ */
+export declare function generateSimpleRadioItem(options?: Partial<PerseusRadioWidgetOptions>): PerseusItem;

package/dist/utils/get-default-figure-for-type.d.ts

@@ -0,0 +1,9 @@
+import { type LockedEllipseType, type LockedFigure, type LockedFigureType, type LockedFunctionType, type LockedLabelType, type LockedLineType, type LockedPointType, type LockedPolygonType, type LockedVectorType } from "../data-schema";
+export declare function getDefaultFigureForType(type: "point"): LockedPointType;
+export declare function getDefaultFigureForType(type: "line"): LockedLineType;
+export declare function getDefaultFigureForType(type: "vector"): LockedVectorType;
+export declare function getDefaultFigureForType(type: "ellipse"): LockedEllipseType;
+export declare function getDefaultFigureForType(type: "polygon"): LockedPolygonType;
+export declare function getDefaultFigureForType(type: "function"): LockedFunctionType;
+export declare function getDefaultFigureForType(type: "label"): LockedLabelType;
+export declare function getDefaultFigureForType(type: LockedFigureType): LockedFigure;

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 } from "./data-schema";
+import type { GrapherAnswerTypes, PerseusDropdownChoice, PerseusExpressionAnswerForm, PerseusGradedGroupSetWidgetOptions, PerseusGradedGroupWidgetOptions, PerseusGraphType, PerseusGroupWidgetOptions, PerseusMatrixWidgetAnswers, PerseusNumericInputAnswer, PerseusOrdererWidgetOptions, PerseusRadioChoice, PerseusGraphCorrectType, MakeWidgetMap, PerseusFreeResponseWidgetScoringCriterion, PerseusRenderer } 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,9 +72,7 @@ export type PerseusExpressionRubric = {
 };
 export type PerseusExpressionUserInput = string;
 export type PerseusGroupRubric = PerseusGroupWidgetOptions;
-export type PerseusGroupValidationData = {
-    widgets: ValidationDataMap;
-};
+export type PerseusGroupValidationData = PerseusRenderer;
 export type PerseusGroupUserInput = UserInputMap;
 export type PerseusGradedGroupRubric = PerseusGradedGroupWidgetOptions;
 export type PerseusGradedGroupSetRubric = PerseusGradedGroupSetWidgetOptions;
@@ -267,24 +265,6 @@ 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/widgets/interactive-graph/index.d.ts

@@ -1,5 +1,5 @@
 import type { PerseusInteractiveGraphWidgetOptions } from "../../data-schema";
 import type { WidgetLogic } from "../logic-export.types";
-export type InteractiveGraphDefaultWidgetOptions = Pick<PerseusInteractiveGraphWidgetOptions, "labels" | "labelLocation" | "range" | "step" | "backgroundImage" | "markings" | "showTooltips" | "showProtractor" | "graph" | "correct">;
+export type InteractiveGraphDefaultWidgetOptions = Pick<PerseusInteractiveGraphWidgetOptions, "labels" | "labelLocation" | "lockedFigures" | "range" | "step" | "backgroundImage" | "markings" | "showAxisArrows" | "showTooltips" | "showProtractor" | "graph" | "correct">;
 declare const interactiveGraphWidgetLogic: WidgetLogic;
 export default interactiveGraphWidgetLogic;

package/dist/widgets/label-image/label-image-util.d.ts

@@ -1,4 +1,4 @@
-import type { PerseusLabelImageMarker, PerseusLabelImageWidgetOptions } from "../../data-schema";
+import type { PerseusLabelImageMarker, PerseusLabelImageWidgetOptions, PerseusWidgetOptions } from "../../data-schema";
 /**
  * For details on the individual options, see the
  * PerseusLabelImageWidgetOptions type
@@ -16,3 +16,4 @@ export type LabelImagePublicWidgetOptions = {
 };
 export type LabelImageMarkerPublicData = Pick<PerseusLabelImageMarker, "x" | "y" | "label">;
 export default function getLabelImagePublicWidgetOptions(options: PerseusLabelImageWidgetOptions): LabelImagePublicWidgetOptions;
+export declare function isLabelImageAccessible(options: PerseusWidgetOptions): boolean;

package/package.json

@@ -3,7 +3,7 @@
   "description": "Shared Perseus infrastructure",
   "author": "Khan Academy",
   "license": "MIT",
-  "version": "0.0.0-PR3084-20251204231904",
+  "version": "0.0.0-PR3084-20251218010953",
   "publishConfig": {
     "access": "public"
   },

package/dist/validation.typetest.d.ts

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