@khanacademy/perseus-core 37.0.0 → 38.1.0

package/dist/feature-flags.d.ts

@@ -9,7 +9,7 @@
  *    export const PerseusFeatureFlags = [];
  * 4. Also update the testing/feature-flags-util.ts for testing purpose
  */
-declare const PerseusFeatureFlags: readonly ["perseus-renderer-upgrade", "desmos-calculator"];
+declare const PerseusFeatureFlags: readonly ["perseus-renderer-upgrade", "desmos-calculator", "article-extras"];
 export default PerseusFeatureFlags;
 /**
  * Checks if a feature flag is enabled in the given props.

package/dist/index.d.ts

@@ -53,128 +53,68 @@ export { default as blankLogic } from "./widgets/blank";
 /** @hidden */
 export { default as categorizerLogic } from "./widgets/categorizer";
 /** @hidden */
-export type { CategorizerDefaultWidgetOptions } from "./widgets/categorizer";
-/** @hidden */
 export { default as csProgramLogic } from "./widgets/cs-program";
 /** @hidden */
-export type { CSProgramDefaultWidgetOptions } from "./widgets/cs-program";
-/** @hidden */
 export { default as definitionLogic } from "./widgets/definition";
 /** @hidden */
-export type { DefinitionDefaultWidgetOptions } from "./widgets/definition";
-/** @hidden */
 export { default as dropdownLogic } from "./widgets/dropdown";
 /** @hidden */
-export type { DropdownDefaultWidgetOptions } from "./widgets/dropdown";
-/** @hidden */
 export { default as explanationLogic } from "./widgets/explanation";
 /** @hidden */
-export type { ExplanationDefaultWidgetOptions } from "./widgets/explanation";
-/** @hidden */
 export { default as expressionLogic } from "./widgets/expression";
 /** @hidden */
-export type { ExpressionDefaultWidgetOptions } from "./widgets/expression";
-/** @hidden */
 export { default as deriveExtraKeys } from "./widgets/expression/derive-extra-keys";
 /** @hidden */
 export { default as gradedGroupLogic } from "./widgets/graded-group";
 /** @hidden */
 export { default as freeResponseLogic } from "./widgets/free-response";
 /** @hidden */
-export type { FreeResponseDefaultWidgetOptions } from "./widgets/free-response";
-/** @hidden */
-export type { GradedGroupDefaultWidgetOptions } from "./widgets/graded-group";
-/** @hidden */
 export { default as gradedGroupSetLogic } from "./widgets/graded-group-set";
 /** @hidden */
-export type { GradedGroupSetDefaultWidgetOptions } from "./widgets/graded-group-set";
-/** @hidden */
 export { default as grapherLogic } from "./widgets/grapher";
 /** @hidden */
-export type { GrapherDefaultWidgetOptions } from "./widgets/grapher";
-/** @hidden */
 export { default as groupLogic } from "./widgets/group";
 /** @hidden */
-export type { GroupDefaultWidgetOptions } from "./widgets/group";
-/** @hidden */
 export { default as iframeLogic } from "./widgets/iframe";
 /** @hidden */
-export type { IFrameDefaultWidgetOptions } from "./widgets/iframe";
-/** @hidden */
 export { default as imageLogic } from "./widgets/image";
 /** @hidden */
-export type { ImageDefaultWidgetOptions } from "./widgets/image";
-/** @hidden */
 export { default as inputNumberLogic } from "./widgets/input-number";
 /** @hidden */
-export type { InputNumberDefaultWidgetOptions } from "./widgets/input-number";
-/** @hidden */
 export { default as interactionLogic } from "./widgets/interaction";
 /** @hidden */
-export type { InteractionDefaultWidgetOptions } from "./widgets/interaction";
-/** @hidden */
 export { default as interactiveGraphLogic } from "./widgets/interactive-graph";
 /** @hidden */
-export type { InteractiveGraphDefaultWidgetOptions } from "./widgets/interactive-graph";
-/** @hidden */
 export { default as labelImageLogic } from "./widgets/label-image";
 /** @hidden */
-export type { LabelImageDefaultWidgetOptions } from "./widgets/label-image";
-/** @hidden */
 export { default as matcherLogic } from "./widgets/matcher";
 /** @hidden */
-export type { MatcherDefaultWidgetOptions } from "./widgets/matcher";
-/** @hidden */
 export { default as matrixLogic } from "./widgets/matrix";
 /** @hidden */
-export type { MatrixDefaultWidgetOptions } from "./widgets/matrix";
-/** @hidden */
 export { default as measurerLogic } from "./widgets/measurer";
 /** @hidden */
-export type { MeasurerDefaultWidgetOptions } from "./widgets/measurer";
-/** @hidden */
 export { default as numberLineLogic } from "./widgets/number-line";
 /** @hidden */
-export type { NumberLineDefaultWidgetOptions } from "./widgets/number-line";
-/** @hidden */
 export { default as numericInputLogic } from "./widgets/numeric-input";
 /** @hidden */
-export type { NumericInputDefaultWidgetOptions } from "./widgets/numeric-input";
-/** @hidden */
 export { default as ordererLogic } from "./widgets/orderer";
 /** @hidden */
-export type { OrdererDefaultWidgetOptions } from "./widgets/orderer";
-/** @hidden */
 export { default as phetSimulationLogic } from "./widgets/phet-simulation";
 /** @hidden */
-export type { PhetSimulationDefaultWidgetOptions } from "./widgets/phet-simulation";
-/** @hidden */
 export { default as plotterLogic } from "./widgets/plotter";
 /** @hidden */
-export type { PlotterDefaultWidgetOptions } from "./widgets/plotter";
-/** @hidden */
 export { default as pythonProgramLogic } from "./widgets/python-program";
 /** @hidden */
-export type { PythonProgramDefaultWidgetOptions } from "./widgets/python-program";
-/** @hidden */
 export { default as radioLogic } from "./widgets/radio";
 /** @hidden */
-export type { RadioDefaultWidgetOptions } from "./widgets/radio";
-/** @hidden */
 export { usesNumCorrect } from "./widgets/radio/radio-util";
 /** @hidden */
 export { default as sorterLogic } from "./widgets/sorter";
 /** @hidden */
-export type { SorterDefaultWidgetOptions } from "./widgets/sorter";
-/** @hidden */
 export { default as tableLogic } from "./widgets/table";
 /** @hidden */
-export type { TableDefaultWidgetOptions } from "./widgets/table";
-/** @hidden */
 export { default as videoLogic } from "./widgets/video";
 /** @hidden */
-export type { VideoDefaultWidgetOptions } from "./widgets/video";
-/** @hidden */
 export { convertGrapherOptionsToInteractiveGraph, convertGrapherUserInputToInteractiveGraph, convertInteractiveGraphUserInputToGrapher, } from "./widgets/grapher/to-interactive-graph";
 /** @hidden */
 export { applyDefaultsToWidgets, applyDefaultsToWidget, } from "./widgets/apply-defaults";
@@ -191,7 +131,7 @@ export type * from "./widgets/logic-export.types";
 /** @hidden */
 export * as CoreWidgetRegistry from "./widgets/core-widget-registry";
 /** @hidden */
-export { getOrdererPublicWidgetOptions } from "./widgets/orderer/orderer-util";
+export { getOrdererPublicWidgetOptions, mergeCards, toCard, } from "./widgets/orderer/orderer-util";
 /** @hidden */
 export type { OrdererPublicWidgetOptions } from "./widgets/orderer/orderer-util";
 /** @hidden */
@@ -213,6 +153,8 @@ export type { GrapherPublicWidgetOptions } from "./widgets/grapher/grapher-util"
 /** @hidden */
 export { getGroupPublicWidgetOptions } from "./widgets/group/group-util";
 /** @hidden */
+export type { GroupPublicWidgetOptions } from "./widgets/group/group-util";
+/** @hidden */
 export { getInteractiveGraphPublicWidgetOptions, type InteractiveGraphPublicWidgetOptions, } from "./widgets/interactive-graph/interactive-graph-util";
 /** @hidden */
 export { getLabelImagePublicWidgetOptions } from "./widgets/label-image/label-image-util";
@@ -318,6 +260,10 @@ export { generateRadioOptions, generateRadioChoice, generateSimpleRadioQuestion,
 export { generateVideoWidget } from "./utils/generators/video-widget-generator";
 /** @hidden */
 export { generateSorterWidget, generateSorterOptions, } from "./utils/generators/sorter-widget-generator";
+/** @hidden */
+export { generateTableOptions } from "./utils/generators/table-widget-generator";
+/** @hidden */
+export { generateGrapherWidgetOptions } from "./utils/generators/grapher-widget-generator";
 export { getAnswersFromWidgets, injectWidgets, } from "./utils/extract-perseus-ai-data";
 /** @hidden */
 export { getPerseusAIData } from "./utils/extract-perseus-ai-data";

package/dist/index.item-splitting.js

@@ -104,7 +104,9 @@ const stringOrNumberOrNullOrUndefined=union(string).or(number).or(constant(null)
 
 const parseFreeResponseWidget=parseWidget(constant("free-response"),object({allowUnlimitedCharacters:boolean,characterLimit:number,placeholder:string,question:string,scoringCriteria:array(object({text:string}))}));
 
-const falseToNull=pipeParsers(constant(false)).then(convert(()=>null)).parser;const parseGradedGroupWidgetOptions=object({title:defaulted(string,()=>""),hint:union(falseToNull).or(constant(null)).or(constant(undefined)).or((rawVal,ctx)=>parsePerseusRenderer(rawVal,ctx)).parser,content:string,widgets:(rawVal,ctx)=>parseWidgetsMap(rawVal,ctx),images:record(string,object({width:number,height:number}))});const parseGradedGroupWidget=parseWidget(constant("graded-group"),parseGradedGroupWidgetOptions);
+const booleanOrFalse=defaulted(boolean,()=>false);const calculatorVariantOrUndefined=pipeParsers(defaulted(nullable(enumeration("scientific","graphing","four_function")),()=>null)).then(convert(v=>v??undefined)).parser;const baseParser=defaulted(object({calculator:booleanOrFalse,calculatorVariant:calculatorVariantOrUndefined,financialCalculatorMonthlyPayment:booleanOrFalse,financialCalculatorTotalAmount:booleanOrFalse,financialCalculatorTimeToPayOff:booleanOrFalse,periodicTable:booleanOrFalse,periodicTableWithKey:booleanOrFalse}),()=>({calculator:false,calculatorVariant:undefined,financialCalculatorMonthlyPayment:false,financialCalculatorTotalAmount:false,financialCalculatorTimeToPayOff:false,periodicTable:false,periodicTableWithKey:false}));const parsePerseusAnswerArea=pipeParsers(baseParser).then(convert(parsed=>{const{calculatorVariant:parsedCalcVariant,...rest}=parsed;const calculatorVariant=parsed.calculator&&parsedCalcVariant===undefined?"scientific":parsedCalcVariant;return calculatorVariant!==undefined?{...rest,calculatorVariant}:rest})).parser;
+
+const falseToNull=pipeParsers(constant(false)).then(convert(()=>null)).parser;const parseGradedGroupWidgetOptions=object({title:defaulted(string,()=>""),hint:union(falseToNull).or(constant(null)).or(constant(undefined)).or((rawVal,ctx)=>parsePerseusRenderer(rawVal,ctx)).parser,content:string,widgets:(rawVal,ctx)=>parseWidgetsMap(rawVal,ctx),images:record(string,object({width:number,height:number})),answerArea:optional(parsePerseusAnswerArea)});const parseGradedGroupWidget=parseWidget(constant("graded-group"),parseGradedGroupWidgetOptions);
 
 const parseGradedGroupSetWidget=parseWidget(constant("graded-group-set"),object({gradedGroups:array(parseGradedGroupWidgetOptions)}));
 
@@ -168,8 +170,6 @@ union(parsePerseusRenderer).or(array(parsePerseusRenderer)).parser;
 
 const parseHint=object({replace:defaulted(optional(boolean),()=>undefined),placeholder:defaulted(optional(boolean),()=>undefined),content:string,widgets:defaulted(parseWidgetsMap,()=>({})),images:parseImages,metadata:any});
 
-const booleanOrFalse=defaulted(boolean,()=>false);const calculatorVariantOrUndefined=pipeParsers(defaulted(nullable(enumeration("scientific","graphing","four_function")),()=>null)).then(convert(v=>v??undefined)).parser;const baseParser=defaulted(object({calculator:booleanOrFalse,calculatorVariant:calculatorVariantOrUndefined,financialCalculatorMonthlyPayment:booleanOrFalse,financialCalculatorTotalAmount:booleanOrFalse,financialCalculatorTimeToPayOff:booleanOrFalse,periodicTable:booleanOrFalse,periodicTableWithKey:booleanOrFalse}),()=>({calculator:false,calculatorVariant:undefined,financialCalculatorMonthlyPayment:false,financialCalculatorTotalAmount:false,financialCalculatorTimeToPayOff:false,periodicTable:false,periodicTableWithKey:false}));const parsePerseusAnswerArea=pipeParsers(baseParser).then(convert(parsed=>{const{calculatorVariant:parsedCalcVariant,...rest}=parsed;const calculatorVariant=parsed.calculator&&parsedCalcVariant===undefined?"scientific":parsedCalcVariant;return calculatorVariant!==undefined?{...rest,calculatorVariant}:rest})).parser;
-
 const parsePerseusItem=object({question:parsePerseusRenderer,hints:defaulted(array(parseHint),()=>[]),answerArea:parsePerseusAnswerArea});
 
 const coord=pair(number,number);const coordPair=pair(coord,coord);const parseAbsoluteValueBranch=object({type:constant("absolute_value"),coords:nullable(coordPair)});const parseExponentialBranch=object({type:constant("exponential"),asymptote:coordPair,coords:nullable(coordPair)});const parseLinearBranch=object({type:constant("linear"),coords:nullable(coordPair)});const parseLogarithmBranch=object({type:constant("logarithm"),asymptote:coordPair,coords:nullable(coordPair)});const parseQuadraticBranch=object({type:constant("quadratic"),coords:nullable(coordPair)});const parseSinusoidBranch=object({type:constant("sinusoid"),coords:nullable(coordPair)});const parseTangentBranch=object({type:constant("tangent"),coords:nullable(coordPair)});discriminatedUnionOn("type").withBranch("absolute_value",parseAbsoluteValueBranch).withBranch("exponential",parseExponentialBranch).withBranch("linear",parseLinearBranch).withBranch("logarithm",parseLogarithmBranch).withBranch("quadratic",parseQuadraticBranch).withBranch("sinusoid",parseSinusoidBranch).withBranch("tangent",parseTangentBranch).parser;
@@ -188,6 +188,10 @@ class Registry{throwIfUnregistered(){if(!this.anythingRegistered){throw new Erro
 
 const seededRNG=function(seed){let randomSeed=seed;return 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}};seededRNG(new Date().getTime()&0xffffffff);
 
+function toCard(content){return {content,widgets:{},images:{}}}function getCategoryScore(content){if(/\d/.test(content)){return 0}if(/^\$?[a-zA-Z]+\$?$/.test(content)){return 2}return 1}function mergeCards(correctOptions,otherOptions){const allCards=[...correctOptions,...otherOptions];return [...new Set(allCards.map(card=>card.content))].filter(content=>content!=="").sort().sort((a,b)=>getCategoryScore(a)-getCategoryScore(b)).map(toCard)}
+
+const defaultCorrectOptions=[toCard("$x$")];const defaultOtherOptions=[toCard("$y$")];({options:mergeCards(defaultCorrectOptions,defaultOtherOptions)});
+
 const defaultRows=4;const defaultColumns=1;new Array(defaultRows).fill(0).map(()=>new Array(defaultColumns).fill(""));
 
 const widgets=new Registry("Core widget registry");function getCurrentVersion(type){const widgetLogic=widgets.get(type);return widgetLogic?.version||{major:0,minor:0}}const getPublicWidgetOptionsFunction=type=>{return widgets.get(type)?.getPublicWidgetOptions??(i=>i)};function getDefaultWidgetOptions(type){const widgetLogic=widgets.get(type);return widgetLogic?.defaultWidgetOptions||{}}const getSupportedAlignments=type=>{const widgetLogic=widgets.get(type);if(!widgetLogic?.supportedAlignments?.[0]){return ["default"]}return widgetLogic?.supportedAlignments};