@khanacademy/perseus-core 0.0.0-PR3089-20251204205743 → 0.0.0-PR3089-20251210151846

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/free-response-widget-generator.d.ts

@@ -0,0 +1,3 @@
+import type { PerseusFreeResponseWidgetOptions, FreeResponseWidget } from "../../data-schema";
+export declare function generateFreeResponseOptions(options?: Partial<PerseusFreeResponseWidgetOptions>): PerseusFreeResponseWidgetOptions;
+export declare function generateFreeResponseWidget(freeResponseWidgetProperties?: Partial<Omit<FreeResponseWidget, "type">>): FreeResponseWidget;

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/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/package.json

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